Node Monitor

A suite of Python tools that enables real-time blockchain monitoring with ZMQ, enhanced block detection, extended block statistics, mining pool identification from coinbase transactions, OP_RETURN data extraction and analysis. All metrics visible and accessible via web interface. Get a complete picture of your node's activity and the wider Bitcoin network.

Features

Blockchain Monitoring

• Real-time blockchain monitoring with ZMQ notifications (instant) or polling fallback
• Enhanced block detection - catches blocks immediately as they're found
• Block statistics with CSV logging and automatic rotation
• Mining pool identification from coinbase transactions
• OP_RETURN data extraction and analysis

Pool Mining

• Pool mining with cpuminer-opt
• DATUM template support for advanced mining
• Real-time monitoring of hash rates and shares

Bitcoin Graph Visualization

• Interactive price charts with USD/EUR currency switching
• Purchase tracking with customizable data points
• Bitcoin halving events visualization
• Linear/Logarithmic scale options

Price Data Management

• Centralized price service with caching
• Multi-API fallbacks (CoinGecko → Yahoo Finance)
• Thread-safe concurrent access for all monitors
• Configurable rate limiting to prevent API abuse

Tor Network Integration

• Dual network support - accepts both clearnet and Tor connections
• Automatic Tor management - starts Tor service when needed

Architecture

• Python services: Long-running monitors connect to bitcoind over RPC and ZMQ, normalize events, and persist or stream metrics.
• Web front end: A browser UI surfaces block stats, pool info, OP_RETURN analysis, price charts, and Tor-aware connectivity in one place.
• Node-centric: Designed around a local or trusted Bitcoin Core (or compatible) node as the source of truth for chain data.

Tech Stack

• Python: Core daemons, parsers, and glue between ZMQ/RPC and the web layer.
• ZMQ: Push-style block and tx notifications from Bitcoin Core for low-latency updates.
• Bitcoin Node: Bitcoin Core (or compatible) RPC/ZMQ as the data plane.
• RPC: Query blocks, transactions, and mempool details where ZMQ alone is not enough.
• Real-time: Live dashboards and charts fed by streaming chain and mempool events.