# Sovran

## Docs

- [Location Stamps](https://mintlify.wiki/sovranBitcoin/sovran/advanced/location-stamps.md): Attach GPS coordinates to transactions for record-keeping
- [P2PK Locking](https://mintlify.wiki/sovranBitcoin/sovran/advanced/p2pk-locking.md): Lock ecash tokens to specific public keys for enhanced security
- [Pending Ecash Sweeper](https://mintlify.wiki/sovranBitcoin/sovran/advanced/pending-ecash-sweeper.md): Reclaim unclaimed sent ecash tokens back to your wallet
- [Swap Routing](https://mintlify.wiki/sovranBitcoin/sovran/advanced/swap-routing.md): Intelligent routing for multi-mint swaps with middleman support
- [Transaction Filters](https://mintlify.wiki/sovranBitcoin/sovran/advanced/transaction-filters.md): Filter transactions by currency, type, direction, status, and month
- [Transaction Timelines](https://mintlify.wiki/sovranBitcoin/sovran/advanced/transaction-timelines.md): Live timeline showing transaction progress from creation to completion
- [Wallet Health](https://mintlify.wiki/sovranBitcoin/sovran/advanced/wallet-health.md): Monitor and maintain optimal balance distribution across mints
- [Cashu Integration](https://mintlify.wiki/sovranBitcoin/sovran/architecture/cashu-integration.md): Coco-Cashu manager, proofs, quotes, and mint operations
- [Nostr Integration](https://mintlify.wiki/sovranBitcoin/sovran/architecture/nostr-integration.md): NDK, gift-wrapped DMs, social graph, and payment requests
- [Architecture Overview](https://mintlify.wiki/sovranBitcoin/sovran/architecture/overview.md): High-level architecture of the Sovran Bitcoin wallet
- [Routing](https://mintlify.wiki/sovranBitcoin/sovran/architecture/routing.md): Expo Router file-based routing architecture
- [State Management](https://mintlify.wiki/sovranBitcoin/sovran/architecture/state-management.md): Zustand stores, Redux migration, and profile-scoped state
- [Know Your Mint](https://mintlify.wiki/sovranBitcoin/sovran/cashu/know-your-mint.md): Mint auditing, community ratings, and trust verification in Sovran
- [Mint Management](https://mintlify.wiki/sovranBitcoin/sovran/cashu/mint-management.md): Add, remove, and manage Cashu mints in Sovran
- [Mint Swapping](https://mintlify.wiki/sovranBitcoin/sovran/cashu/mint-swapping.md): Move ecash between mints via Lightning routing in Sovran
- [Cashu Protocol & Ecash](https://mintlify.wiki/sovranBitcoin/sovran/cashu/overview.md): Understanding ecash and the Cashu protocol in Sovran
- [Payment Requests (NUT-18)](https://mintlify.wiki/sovranBitcoin/sovran/cashu/payment-requests.md): Request and fulfill Cashu payments with optional constraints using NUT-18
- [Wallet Rebalancing](https://mintlify.wiki/sovranBitcoin/sovran/cashu/wallet-rebalancing.md): Automatically distribute ecash across multiple mints based on target allocations
- [Code Quality](https://mintlify.wiki/sovranBitcoin/sovran/contributing/code-quality.md): Code quality requirements - linting, type checking, formatting, dead code detection, and testing
- [Git Workflow](https://mintlify.wiki/sovranBitcoin/sovran/contributing/git-workflow.md): Git workflow and commit conventions for Sovran - branching, commits, PRs, and issues
- [Contributing Guidelines](https://mintlify.wiki/sovranBitcoin/sovran/contributing/guidelines.md): How to contribute to Sovran - code standards, architecture, and workflow
- [Multi-Currency Display](https://mintlify.wiki/sovranBitcoin/sovran/customization/multi-currency.md): Display your Bitcoin balance in USD, EUR, GBP, or sats with real-time exchange rates
- [Settings](https://mintlify.wiki/sovranBitcoin/sovran/customization/settings.md): Complete overview of Sovran's app settings and configuration options
- [Themes](https://mintlify.wiki/sovranBitcoin/sovran/customization/themes.md): Customize your Sovran wallet with 37 beautiful themes including color palettes and background wallpapers
- [Getting Started](https://mintlify.wiki/sovranBitcoin/sovran/development/getting-started.md): Set up your development environment for Sovran
- [Project Structure](https://mintlify.wiki/sovranBitcoin/sovran/development/project-structure.md): Understand the organization of the Sovran codebase
- [Scripts Reference](https://mintlify.wiki/sovranBitcoin/sovran/development/scripts.md): Complete guide to development, build, and testing scripts
- [Tech Stack](https://mintlify.wiki/sovranBitcoin/sovran/development/tech-stack.md): Technologies and frameworks powering Sovran
- [Ecash Token Functionality](https://mintlify.wiki/sovranBitcoin/sovran/features/ecash-tokens.md): Cashu ecash token operations including send, receive, validation, and token state management
- [Lightning Network Payments](https://mintlify.wiki/sovranBitcoin/sovran/features/lightning-payments.md): Send and receive Lightning payments with LNURL support, invoice parsing, and automatic melt operations
- [Multi-Account Support](https://mintlify.wiki/sovranBitcoin/sovran/features/multi-account.md): Swipeable account pager with multiple currency units and visual account indicators
- [NFC Tap Payments](https://mintlify.wiki/sovranBitcoin/sovran/features/nfc-payments.md): Contactless ecash payments using NFC for point-of-sale terminals and peer-to-peer transfers
- [QR Code Scanner](https://mintlify.wiki/sovranBitcoin/sovran/features/qr-scanner.md): Camera-based QR scanner with torch, clipboard paste, gallery import, and UR code support
- [Wallet Functionality](https://mintlify.wiki/sovranBitcoin/sovran/features/wallet.md): Multi-account wallet with real-time balance display, fiat conversion, and ecash token management
- [Installation](https://mintlify.wiki/sovranBitcoin/sovran/installation.md): Download and install Sovran on iOS and Android devices
- [BTCMap Integration](https://mintlify.wiki/sovranBitcoin/sovran/integrations/btcmap.md): Discover Bitcoin-accepting merchants worldwide with intelligent clustering and map visualization.
- [Deep Linking](https://mintlify.wiki/sovranBitcoin/sovran/integrations/deep-linking.md): Handle cashu:// and sovran:// URL schemes for seamless ecash token imports.
- [Routstr AI Chat](https://mintlify.wiki/sovranBitcoin/sovran/integrations/routstr-ai.md): Built-in AI chat with multiple models from OpenAI, Anthropic, Google, and more. Pay per message with sats.
- [Introduction to Sovran](https://mintlify.wiki/sovranBitcoin/sovran/introduction.md): A mobile Bitcoin wallet with Cashu ecash, Lightning payments, Nostr messaging, and NFC support
- [Nostr-based Contact System](https://mintlify.wiki/sovranBitcoin/sovran/nostr/contacts.md): Contact lists from direct messages, follows, and mint operators
- [Encrypted Direct Messages (NIP-17)](https://mintlify.wiki/sovranBitcoin/sovran/nostr/direct-messages.md): Implement private peer-to-peer messaging with gift-wrapped encryption
- [Nostr Identity & Key Management](https://mintlify.wiki/sovranBitcoin/sovran/nostr/identity.md): NIP-06 key derivation, secure storage, and multi-account support
- [Lightning Address Username Claiming](https://mintlify.wiki/sovranBitcoin/sovran/nostr/lightning-address.md): Claim human-readable Lightning addresses with NIP-98 authentication
- [Nostr Integration Overview](https://mintlify.wiki/sovranBitcoin/sovran/nostr/overview.md): Learn how Sovran uses Nostr for identity, messaging, and social features
- [User Profiles & Reputation](https://mintlify.wiki/sovranBitcoin/sovran/nostr/user-profiles.md): Rich profile metadata with followers, reputation scores, and social proof
- [BIP Standards](https://mintlify.wiki/sovranBitcoin/sovran/protocols/bip-standards.md): BIP-39 and BIP-32 implementation for hierarchical deterministic wallets in Sovran
- [Cashu NUTs](https://mintlify.wiki/sovranBitcoin/sovran/protocols/cashu-nuts.md): Supported Cashu Notation, Usage, and Terminology (NUT) specifications in Sovran
- [Lightning Network (BOLT11)](https://mintlify.wiki/sovranBitcoin/sovran/protocols/lightning-bolts.md): BOLT11 invoice support for Lightning Network payments in Sovran
- [Nostr NIPs](https://mintlify.wiki/sovranBitcoin/sovran/protocols/nostr-nips.md): Supported Nostr Implementation Possibilities (NIPs) in Sovran for decentralized identity and messaging
- [Quick Start Guide](https://mintlify.wiki/sovranBitcoin/sovran/quickstart.md): Get started with Sovran in minutes — download, setup, and make your first payment
- [Key Derivation](https://mintlify.wiki/sovranBitcoin/sovran/security/key-derivation.md): Technical details of BIP-39 mnemonic, BIP-32 HD keys, NIP-06 Nostr keys, and NUT-13 Cashu derivation
- [Security & Privacy Overview](https://mintlify.wiki/sovranBitcoin/sovran/security/overview.md): Comprehensive security architecture and privacy-first design principles in Sovran
- [Passcode Lock](https://mintlify.wiki/sovranBitcoin/sovran/security/passcode-lock.md): Protect Sovran with a 4-digit PIN code that gates app access
- [Privacy Features](https://mintlify.wiki/sovranBitcoin/sovran/security/privacy-features.md): Privacy-first architecture in Sovran - local storage, no data collection, and privacy-preserving technologies
- [Wallet Recovery](https://mintlify.wiki/sovranBitcoin/sovran/security/wallet-recovery.md): Restore your Sovran wallet from your BIP-39 seed phrase