Documentation Index
Fetch the complete documentation index at: https://mintlify.com/satsigner/satsigner/llms.txt
Use this file to discover all available pages before exploring further.
Design philosophy
SatSigner is built on a foundation of core principles that guide every design and implementation decision.Bitcoin on-chain first
Sat denomination supremacy
Complete UTXO control
Privacy first
Visual-native UI
Bitcoin-native terminology
Security focused
Open source
User sovereignty
Educational
Bitcoin on-chain first
SatSigner treats Bitcoin’s base layer as the safe layer of last resort. While we support Lightning Network and eCash for everyday transactions, the focus is always on:Full UTXO sovereignty
Every satoshi you own exists as a UTXO on the Bitcoin blockchain. SatSigner gives you complete visibility:What is a UTXO?
What is a UTXO?
Why UTXO control matters
Why UTXO control matters
- Privacy: Choose which coins to spend to avoid linking transactions
- Fee optimization: Select specific UTXOs to minimize transaction size and fees
- Coin history: Avoid spending UTXOs with undesirable provenance
- Strategic consolidation: Merge small UTXOs when fees are low
- Advanced features: Enable CoinJoin, payjoin, and other privacy techniques
Visual UTXO management
SatSigner presents your UTXOs as interactive bubble charts:- Size represents value (larger bubbles = more sats)
- Visual clustering shows UTXO relationships
- Color coding indicates age and status
- Interactive selection for spending
- Intuitive for both beginners and experts
Sat denomination supremacy
SatSigner uses satoshis (sats) as the primary unit of account:Why sats, not BTC?
- Psychological benefits
- Technical accuracy
- Future-proof
- No decimal points for most transactions
- Whole numbers are easier to understand
- Better for everyday spending amounts
- Matches how fiat currencies work
Privacy first
SatSigner is designed for users who value financial privacy:No surveillance
Zero telemetry:- No analytics libraries
- No crash reporting (unless you opt-in)
- No usage statistics
- No IP address logging
- No transaction tracking
- No address clustering
Privacy-enhancing features
STONEWALL coin selection
STONEWALL coin selection
- Uses 4+ inputs instead of minimum needed
- Creates 2+ change outputs with varying amounts
- Avoids round numbers that reveal intent
- Mixes script types when possible
- Calculates privacy score (0-100)
Tor support
Tor support
- Hide your IP address from network observers
- Prevent linking your identity to Bitcoin addresses
- Protect against network-level surveillance
- Connect to .onion backend services
Manual coin selection
Manual coin selection
- Avoid spending linked UTXOs together
- Isolate different identity buckets
- Prevent address reuse detection
- Maintain transaction history separation
BIP329 labels
BIP329 labels
- Label transactions, addresses, and UTXOs locally
- Export/import labels in standard format
- Sync labels via encrypted Nostr messages
- Never share labels with third parties
Encrypted storage
All sensitive data is encrypted at rest:- Mnemonic seed phrases
- Private keys and extended keys
- Output descriptors
- PIN hash (double SHA256)
- Account configurations
- Transaction labels
Visual-native UI
SatSigner makes complex Bitcoin operations understandable through visualization:Interactive visualizations
UTXO bubble charts
Sankey diagrams
Balance evolution
Fee rate history
Network statistics
Transaction analysis
Why visualization matters
- Reduces cognitive load: Charts are faster to process than tables
- Reveals patterns: Visual clustering shows UTXO relationships
- Enhances learning: See how Bitcoin actually works
- Improves decisions: Better fee and coin selection choices
- Increases confidence: Understand exactly what you’re doing
Bitcoin-native terminology
SatSigner uses Bitcoin’s true technical language:We say…
| Instead of… | We say… | Why? |
|---|---|---|
| ”Balance" | "UTXO set” | Bitcoin doesn’t have balances, it has UTXOs |
| ”Coins" | "UTXOs” or “sats” | Technical accuracy and education |
| ”Account" | "Wallet” or “Signer” | Bitcoin has wallets and keys, not accounts |
| ”Address balance" | "Address UTXO total” | Addresses don’t have balances, they have UTXOs |
| ”Send Bitcoin" | "Create transaction” or “Spend UTXOs” | Describes what actually happens |
| ”Pending" | "In mempool” or “Unconfirmed” | Bitcoin’s actual state |
| ”Confirmed" | "N confirmations” | Precise confirmation count matters |
Educational approach
Security focused
Security is not an afterthought - it’s fundamental to SatSigner’s architecture:Layered security approach
PIN protection
Encrypted storage
Seed dropping
Duress PIN
Multi-signature support
Advanced users can deploy multi-signature security:- No single point of failure
- Distributed key custody
- Protection against key theft
- Organizational custody models
- Inheritance planning
User sovereignty
SatSigner gives you complete control:Your keys, your Bitcoin
SatSigner is a self-custody wallet:- You control the private keys
- You choose the backend (your node or trusted server)
- You decide when to upgrade
- You can export everything (keys, descriptors, labels)
- You can verify the source code
No central authority
- No account creation required
- No email or phone number needed
- No identity verification
- No terms of service to accept
- No ability for developers to access your funds
Data ownership
Your data stays under your control:- Labels stored locally or synced via Nostr (your keys)
- Transaction history from your chosen backend
- No cloud backup without your explicit action
- Export all data in standard formats
- Delete everything permanently if desired
Open source ethos
SatSigner embraces open source principles:Fully auditable
Open source dependencies only
All dependencies are open source:- No closed-source libraries for critical functions
- Auditable supply chain from dependency to production
- Community security reviews can cover entire stack
- No proprietary lock-in or vendor control
Contributing
We welcome contributions:Report bugs
Submit PRs
Review code
Join discussion
Who contributes to SatSigner?
SatSigner is built by and for the Bitcoin community:Why contribute?
Build powerful Bitcoin tools
Build powerful Bitcoin tools
Enhance Bitcoin UX
Enhance Bitcoin UX
Unlock coin insights
Unlock coin insights
Advance Bitcoin understanding
Advance Bitcoin understanding
Test market demand
Test market demand
Propagate open-source ethos
Propagate open-source ethos
Build Bitcoin ecosystem
Build Bitcoin ecosystem
Participate in Bitcoin history
Participate in Bitcoin history
Design inspiration
SatSigner builds upon brilliant open-source projects:- Sparrow
- FullyNoded
- BitFeed
- Mempool.space
- Zeus
- Excellent UTXO visualization
- Comprehensive PSBT support
- Clean, intuitive interface
- Advanced features without complexity
Comparison with other wallets
What makes SatSigner unique?
| Feature | SatSigner | Typical mobile wallet | Hardware wallet |
|---|---|---|---|
| UTXO visualization | ✅ Interactive bubbles | ❌ Hidden | ❌ Not applicable |
| Manual coin selection | ✅ Every transaction | ⚠️ Rarely supported | ⚠️ Limited |
| Privacy algorithms | ✅ STONEWALL built-in | ❌ Basic only | ❌ Not applicable |
| Multi-signature | ✅ Full PSBT workflow | ⚠️ Limited | ✅ Good support |
| Visualization | ✅ Extensive | ⚠️ Basic charts | ❌ None |
| Lightning Network | ✅ LND integration | ⚠️ Varies | ❌ Rarely |
| eCash support | ✅ Cashu | ❌ Rare | ❌ No |
| Nostr sync | ✅ Decentralized | ❌ Cloud or none | ❌ No |
| Open source | ✅ MIT licensed | ⚠️ Varies | ⚠️ Varies |
| Self custody | ✅ Always | ⚠️ Varies | ✅ Always |
| Mobile native | ✅ iOS & Android | ✅ Usually | ❌ External device |
Who should choose SatSigner?
SatSigner is ideal for:✅ You should use SatSigner if…
- You want complete control over UTXO selection
- You value privacy and avoid surveillance
- You understand (or want to learn) Bitcoin’s technical details
- You need multi-signature capabilities on mobile
- You prefer visual tools for understanding data
- You want mobile-first functionality without compromises
- You demand open source and auditable code
- You manage significant Bitcoin holdings on mobile
- You need Lightning Network integration
- You want to learn Bitcoin through hands-on experience
⚠️ Consider alternatives if…
- You want the simplest possible user experience (try simpler wallets first)
- You prefer custodial solutions with account recovery
- You only need basic send/receive functionality
- You’re uncomfortable with technical concepts
- You prefer desktop or hardware wallet workflows
The path forward
SatSigner is under active development:Today: Core functionality
Near term: Enhanced privacy
Medium term: Layer 2 expansion
Get started
Ready to take control of your Bitcoin?Install SatSigner
Quick start guide
Feature overview
Contribute
“Not your keys, not your coins. With SatSigner, you hold the keys and control every satoshi.”