munin-bitcoin/docs/build-notes.md

Munin Bitcoin Build Notes

Current version

0.1.0

Completed

Milestone 1 — Working StartOS service

• StartOS package builds successfully
• Docker container starts correctly
• Service installs on physical StartOS server
• Web interface is served by nginx
• UTF-8 support verified
• Repository cleaned and structured

Milestone 2 — Fulcrum connectivity and live service status

• Fulcrum is configured as a StartOS dependency
• Munin receives the Fulcrum endpoint from StartOS
• Munin performs a real Electrum server.version connectivity check
• Status API reports Fulcrum configuration and connection state
• Verified status API response with fulcrum.connected: true
• Web interface displays Fulcrum (Electrum server)
• Web interface displays the Fulcrum connection status and endpoint
• Web interface displays wallet, label, transaction, and last-scan status
• Status can be refreshed from the web interface
• TypeScript check passes
• JavaScript bundle builds successfully
• Docker image builds successfully
• S9PK package builds successfully
• S9PK package was sideloaded and installed on the physical StartOS server
• Munin starts successfully after installation

Current architecture

• StartOS package
• Alpine Linux container
• nginx serving the web interface
• Node.js status API
• Static dashboard in web/index.html
• Fulcrum provided as a StartOS dependency
• Electrum protocol connectivity check from Munin to Fulcrum

Current status

Munin Bitcoin is running as a StartOS service and can verify connectivity to the configured Fulcrum Electrum server.

Bitcoin Core RPC is not currently used by Munin.

Wallet configuration, label storage, transaction scanning, and notification functionality are not yet implemented.

Next steps

• Add persistent storage
• Add wallet configuration
• Add BIP-329 support
• Add wallet/address scanning
• Add transaction monitoring
• Display live wallet and transaction data in the web interface
• Add transaction notifications with label reminders