Wallets
The SDK provides simple methods to create, import, and manage wallets. All wallet operations are handled through SDK methods.Get or Create Wallet
The SDK automatically creates a wallet if the user doesn’t have one:Create Cloud HD Wallet
Create a new cloud-hosted HD wallet (default for new users):Create Self-Custody HD Wallet
Create a wallet where the user provides their own mnemonic:Import HD Wallet
Import an existing HD wallet by mnemonic:Import Private Key Wallet
Import a wallet from a private key:Import External Wallet
Connect an external wallet via WalletConnect:Import Observer Wallet
Add watch-only addresses:List Wallets
Get all wallets for the authenticated user:Get Wallet
Get a specific wallet by ID:Get Default Wallet
Get the user’s default wallet:Set Default Wallet
Set a wallet as the default:Get Wallet Addresses
Get all addresses for a wallet across all chains:Derive Address for Chain
Derive a new address for a specific chain:Wallet Events
Listen for wallet events:Error Handling
Wallet Types Reference
| Type | Key Storage | Use Case |
|---|---|---|
cloud-hd | TEE-protected | Default for new users |
self-hd | User-managed | Power users with their own mnemonic |
hd | TEE-protected | Import existing HD wallet |
private-key | TEE-protected | Import single private key |
external | External wallet | WalletConnect integration |
observer | N/A | Watch-only addresses |