Self-Custody Model
Your mnemonic seed phrase is the master key to all your swap operations. Satora Swaps never has access to your private keys - all cryptographic operations happen locally.
Key principles:
- Your keys, your coins - Private keys never leave your device
- Deterministic derivation - All swap parameters derived from your seed
- Recoverable - Restore pending swaps anytime with your mnemonic
- Automatic storage - The SDK stores your mnemonic securely via the configured storage provider
Generate New Mnemonic
Generate a new 12-word BIP39 mnemonic using the Signer class:
Import Existing Mnemonic
To restore from an existing mnemonic, pass it to the client builder:
Get Xpub
Retrieve the user ID xpub from the initialized client. Note: This is an identifier, not a wallet.
Key Derivation
The SDK uses BIP32/BIP39 standards for deterministic key derivation. Each swap gets unique cryptographic parameters derived from your mnemonic:
- Preimage - Random secret for HTLC
- Preimage Hash - SHA256 hash used as hash lock
- Own Public Key - For VHTLC scripts
- User ID - Derived identifier for swap recovery
All derivation happens locally - your mnemonic never leaves your device.
Critical: Your mnemonic is the only way to recover pending swaps. If you lose it, you cannot recover funds locked in HTLCs.