Skip to content

deadhop documentation ​

deadhop creates on-chain bitcoin invoices, watches the chain and reports payments, like a BTCPay-style server does for simple invoicing. It never listens on a port. Customers and operators reach it only through Nostr relays, using ContextVM (MCP over Nostr), so an attacker has no IP address, HTTP endpoint or login form to aim at.

What you get ​

  • A fresh address per invoice, derived from a watch-only BIP-84 account key. The service cannot spend.
  • Payment detection and confirmation tracking against your own Electrum server.
  • A static Svelte dashboard for checkout and for operators. Sign in with a Nostr key; there are no accounts.
  • Strictly typed tools over end-to-end encrypted Nostr messages: five for invoicing, twelve for operators (health, statistics, settings, keys, control, backups).

Components ​

PartTechnologyRole
Service (server/)Rust, one binary (about 8 MB), SQLiteIssues invoices, polls the chain, answers requests
Dashboard (dashboard/)Svelte 5 static pageCheckout for customers, overview for operators
Chain backendFulcrum or electrsReports transactions for each invoice address
TransportAny Nostr relaysCarries encrypted requests and responses
 customer / operator           relays                 your machine
 ┌──────────────────┐  wss  ┌────────────┐  wss  ┌──────────────────────────┐
 │ Svelte dashboard ├──────►│ Nostr      │◄──────┤ deadhop (Rust)            │
 │  Nostr identity  │       │ relay(s)   │       │  outbound only           │
 │  NIP-44 + NIP-13 │       │ ciphertext │       │  watch-only xpub, SQLite │
 └──────────────────┘       └────────────┘       └────────────┬─────────────┘
                                                              │ Electrum protocol
                                                      ┌───────▼────────┐
                                                      │ Fulcrum/electrs│
                                                      └────────────────┘

Where to go next ​

deadhop 0.1.0 · Every page is also available as Markdown: replace .html with .md.