Security & Key Management
How Morsel stores your keys locally, how encryption works, and best practices for keeping your wallet safe.
Morsel is a non-custodial wallet. That means your private keys are generated on your device, stored on your device, and never transmitted anywhere. This guide explains exactly how that works.
How Your Keys Are Stored
When you create or import a wallet, Morsel derives your private keys from your seed phrase and encrypts them using a key derived from your PIN or biometrics. The encrypted keystore is saved in your device's secure local storage.
- Your seed phrase is encrypted before being stored — it is never saved in plain text
- The encryption key is derived from your PIN using PBKDF2 with a random salt
- On mobile, biometric authentication unlocks a key stored in the device's secure enclave
- Morsel servers never receive your seed phrase, private key, or encryption key
Your Seed Phrase
Your seed phrase (also called a recovery phrase or mnemonic) is a sequence of 12 or 24 words that encodes your master private key. Anyone with these words can access all of your funds on any wallet.
- Write it down on paper — not in a notes app, email, or screenshot
- Store it in a physically secure location — a safe, a lockbox, or split between two locations
- Never type it into any website, app, or chat — no legitimate service will ever ask for it
- Never photograph it or store it in cloud storage
Biometric Authentication
On mobile, Morsel can use Face ID or fingerprint to unlock your wallet and approve transactions. This is handled entirely by your device's secure enclave — Morsel never sees your biometric data.
Under the hood, your biometric check unlocks a device-bound key stored in the secure enclave. That key is then used to decrypt your keystore. The biometric template itself never leaves the chip.
What Morsel Cannot See
Because everything is local and encrypted, there is a strict list of things Morsel cannot access:
- Your seed phrase or private keys
- Your wallet balance or transaction history
- Which dApps you connect to
- Your IP address or device identifier
- Any signing activity
Morsel has no analytics SDK, no backend that receives wallet data, and no telemetry of any kind. The extension's Content Security Policy blocks all outbound requests except to the RPC endpoints you configure.
Best Practices
- Use a unique PIN that you do not use elsewhere
- Enable biometrics for daily convenience, but also remember your PIN
- Use a hardware wallet (Ledger) for large holdings — Morsel supports Ledger via the standard Solana app
- Regularly check connected dApps in Settings → Connected Sites and revoke any you no longer use
- Keep Morsel updated — security patches are released regularly
Revoking dApp Access
Connecting a dApp gives it read access to your public key. It does not give it the ability to move funds — every transaction still requires your approval. To revoke a connection:
- Open Morsel and go to Settings
- Tap Connected Sites
- Find the dApp and tap Disconnect
- The dApp will no longer be able to request your public key without re-connecting