Bitcoin Wallet Sovereignty Health Checker
Inspiration
Bitcoin wallets accumulate technical debt over time: fragmented UTXOs, dust outputs, and unpredictable fee exposure. These issues are often invisible until a user tries to spend during high fees. Most wallets do not surface this risk clearly, and many tools rely on third-party explorers without explaining the trust trade-offs. I wanted a simple, explicit way to evaluate wallet “health” from a sovereignty perspective using node-first data.
What it does
The Bitcoin Wallet Sovereignty Health Checker generates a single JSON report for a Bitcoin address that includes: UTXO count and fragmentation analysis Dust detection and penalties Estimated sweep cost at current fee rates Consolidation guidance (consolidate now vs wait) A one-line sovereignty summary for fast inspection
The tool supports: Node-only mode (Bitcoin Core RPC) Explorer fallback mode (for fast inspection) Optional Tor routing for outbound requests CLI and HTTP server modes, including a /report endpoint
How I built it
Language: Go Bitcoin Core integration: JSON-RPC (listunspent, estimatesmartfee) Explorer fallback: Blockstream testnet/mainnet API
Architecture: Deterministic UTXO scoring logic Stateless analysis based on address + network Unified report object returned via CLI or HTTP Output: Strict JSON for easy scripting and integration The /report endpoint combines on-chain analysis, consolidation planning, optional Lightning readiness, and a concise summary string in a single response.
To be implemented next
Optional Lightning node readiness check (LND getinfo) LND REST API (/v1/getinfo) using macaroons
Log in or sign up for Devpost to join the conversation.