dgb-wallet/packages/electrum

@dgb-wallet/electrum

Minimal DigiByte Electrum protocol client. TCP+TLS JSON-RPC to public Electrum-DGB servers for balance, UTXO listing, transaction broadcast, and chain tip. No API keys, no signup.

Positioned as a Convenience-mode backend in the wallet's privacy design (RESEARCH.md §10.6) — an Electrum server sees which addresses you query. For Maximum Privacy the wallet uses @dgb-wallet/p2p (BIP157/158 SPV) instead. Electrum still beats a single hosted Blockbook because you can distribute queries across many community-run servers with connection-per-server privacy.

API

• connectAny(servers, opts) — try servers in order, return the first that connects and handshakes
• getBalance(client, address) — { confirmed, unconfirmed } in satoshis
• getBalances(client, addresses) — parallelized bulk lookup over one connection
• listUnspent(client, address) — array of { txid, vout, value, height }
• broadcast(client, rawTxHex) — returns txid or throws with server error
• getChainTip(client) — { height, headerHex }

Handles both current DGB address format (S...) and legacy Bitcoin-compatible P2SH (3...) via scripthashOf, so recovery scans that scan both variants (per RESEARCH.md §10.7a) work transparently.

Demo — real mainnet recovery scan

cd "D:\Dev\SilentCode\Digibyte"
npm install                             # first time only
npm run build -w @dgb-wallet/core
npm run demo -w @dgb-wallet/electrum

Connects to a public Electrum-DGB server, derives the public all-abandon BIP39 test seed's addresses at every path (BIP44, both BIP49 variants, BIP84, BIP86), and queries live balance for each. Fetches UTXOs for any address that has funds.

Run with your own seed (do NOT paste a seed protecting real funds anywhere but the wallet itself):

npm run demo -w @dgb-wallet/electrum -- "your twelve word seed phrase here"

Public servers

src/servers.ts lists community-run peers. All unaffiliated with this project — availability varies. Update from the DigiByte community forums or github.com/spesmilo/electrum-doc when peers change.

Layout

src/
  servers.ts    — known public DGB Electrum peers
  client.ts     — JSON-RPC over TCP+TLS, multi-server failover
  scripthash.ts — address → Electrum scripthash (handles both DGB P2SH variants)
  methods.ts    — typed wrappers for common methods
  index.ts      — re-exports

scripts/
  scan-seed-demo.ts — recover any seed, scan real mainnet, print balances & UTXOs