Configuration

All SmartAccountKit initialization options.

SmartAccountConfig

Pass a config object to the SmartAccountKit constructor:

import { SmartAccountKit, IndexedDBStorage } from 'smart-account-kit';

const kit = new SmartAccountKit({
  rpcUrl: 'https://soroban-testnet.stellar.org',
  networkPassphrase: 'Test SDF Network ; September 2015',
  accountWasmHash: 'YOUR_WASM_HASH',
  webauthnVerifierAddress: 'YOUR_VERIFIER_ADDRESS',
});

Options

rpcUrl · string · required

Stellar RPC endpoint URL. Use https://soroban-testnet.stellar.org for testnet or https://mainnet.stellar.validationcloud.io/v1/<key> for mainnet.

networkPassphrase · string · required

Network passphrase. Use the Networks enum from @stellar/stellar-sdk:

• Testnet: 'Test SDF Network ; September 2015'
• Mainnet: 'Public Global Stellar Network ; September 2015'

accountWasmHash · string · required

WASM hash of the uploaded smart account contract. Used to deploy new wallet instances. The testnet default is in demo/.env.example.

webauthnVerifierAddress · string · required

Contract address of the deployed WebAuthn verifier. This is the on-chain verifier used to validate passkey signatures.

storage · StorageAdapter

Credential storage backend. Defaults to IndexedDBStorage if not provided.

import { IndexedDBStorage, LocalStorageAdapter, MemoryStorage } from 'smart-account-kit';

storage: new IndexedDBStorage()     // Recommended for web
storage: new LocalStorageAdapter()  // Simple fallback
storage: new MemoryStorage()        // Testing only

timeoutInSeconds · number · default: "30"

Transaction timeout in seconds. Transactions that are not included in a ledger within this window will expire.

rpId · string

WebAuthn Relying Party ID. Defaults to the current hostname (window.location.hostname). Override this if your domain differs from the RP ID registered during passkey creation.

rpName · string

WebAuthn Relying Party display name. Shown to the user during passkey creation.

relayerUrl · string

URL of a relayer proxy for fee-sponsored transactions. When set, the SDK routes all submissions through the relayer instead of the RPC endpoint.

relayerUrl: 'https://my-relayer.example.com'

See the Fee Sponsoring guide for details.

indexerUrl · string

Override the default indexer URL. The SDK auto-selects a default indexer based on networkPassphrase. Only set this if you’re running a custom indexer.

Environment Variables (Demo / Vite)

If you’re using Vite, the recommended pattern is to read from environment variables:

const kit = new SmartAccountKit({
  rpcUrl: import.meta.env.VITE_RPC_URL,
  networkPassphrase: import.meta.env.VITE_NETWORK_PASSPHRASE,
  accountWasmHash: import.meta.env.VITE_ACCOUNT_WASM_HASH,
  webauthnVerifierAddress: import.meta.env.VITE_WEBAUTHN_VERIFIER_ADDRESS,
  relayerUrl: import.meta.env.VITE_RELAYER_URL,
});

.env

VITE_RPC_URL=https://soroban-testnet.stellar.org
VITE_NETWORK_PASSPHRASE=Test SDF Network ; September 2015
VITE_ACCOUNT_WASM_HASH=<wasm_hash>
VITE_WEBAUTHN_VERIFIER_ADDRESS=<verifier_contract_id>
VITE_RELAYER_URL=https://my-relayer.example.com

Testnet Defaults

The demo .env.example ships with pre-deployed testnet contract addresses so you can get started without deploying your own contracts.

Variable	Description
VITE_ACCOUNT_WASM_HASH	Smart account WASM hash (testnet)
VITE_WEBAUTHN_VERIFIER_ADDRESS	WebAuthn verifier contract (testnet)
VITE_ED25519_VERIFIER_ADDRESS	Ed25519 verifier contract (testnet)
VITE_THRESHOLD_POLICY_ADDRESS	Threshold multisig policy (testnet)
VITE_SPENDING_LIMIT_POLICY_ADDRESS	Spending limit policy (testnet)
VITE_NATIVE_TOKEN_CONTRACT	Native XLM SAC contract (testnet)