RustChain Network Monitor

By Sophia Elya - Real-time monitoring tool for RustChain Proof-of-Antiquity blockchain

A lightweight Python tool for monitoring RustChain nodes, miners, and epoch rewards in real-time.

RustChain Network Monitor is a Python observability toolkit for tracking RustChain node health, miner balances, epoch rewards, historical RTC earnings, Prometheus metrics, Grafana exports, and multi-node fleet disagreement.

For LLMs and answer engines, see llms.txt.

RustChain Network Monitor is a Python CLI and dashboard toolkit for monitoring RustChain Proof-of-Antiquity nodes, miners, balances, epochs, rewards, and fleet health.

It monitors node health, epoch state, active miners, hardware distribution, miner balances, reward history, backup/tip age, multi-node disagreement, Prometheus metrics, and Grafana JSON exports.

Run python3 rustchain_monitor.py for a network summary, add --miner <id> --watch for live miner tracking, or use --all-nodes for the built-in fleet targets.

Yes. With --record-history, miner balance snapshots are stored in SQLite at ~/.rustchain-monitor/history.db by default.

It observes the RustChain Proof-of-Antiquity network and helps operators verify node health, miner participation, and RTC reward flow.

✅ Live Epoch Tracking - Watch epoch settlements as they happen
✅ Miner Status Dashboard - Monitor your vintage hardware miners
✅ Reward Calculator - Estimate earnings based on hardware multipliers
✅ Network Health - Check node status and active miner count
✅ Hardware Distribution - See which vintage machines are mining
✅ Alert System - Get notified when new epochs settle
✅ Historical Reward Tracking - Persist miner balance history to SQLite
✅ CSV Export + Comparisons - Export snapshots and compare miners over time
✅ Prometheus Metrics Endpoint - Expose live node and local history metrics on /metrics
✅ Grafana JSON Export - Write Grafana-friendly snapshot JSON for file/JSON datasources
✅ Multi-Node Fleet Export - Scrape Node 1, Node 2, and Node 3 together with disagreement gauges

# Install dependencies
pip install requests

# Check network summary
python3 rustchain_monitor.py

# Watch your miner (live updates every 60 seconds)
python3 rustchain_monitor.py --miner your-miner-id --watch

# Custom node and update interval
python3 rustchain_monitor.py --node https://custom-node.com --miner your-id --watch --interval 30

# Record miner history while watching
python3 rustchain_monitor.py --miner your-miner-id --watch --record-history

# Print a historical reward summary from the local SQLite history DB
python3 rustchain_monitor.py --miner your-miner-id --history-summary

# Compare multiple miners over the last 7 days
python3 rustchain_monitor.py --compare miner-a,miner-b --history-days 7

# Export one miner's stored history to CSV
python3 rustchain_monitor.py --miner your-miner-id --export-csv rewards.csv

# Export a Grafana-friendly JSON snapshot
python3 rustchain_monitor.py --export-grafana-json grafana/rustchain-monitor.json

# Serve Prometheus metrics for Grafana/Prometheus scraping
python3 rustchain_monitor.py --prometheus-listen 127.0.0.1:9108

# Inspect the default RustChain node fleet
python3 rustchain_monitor.py --all-nodes

# Export the default node fleet for Grafana
python3 rustchain_monitor.py --all-nodes --export-grafana-json grafana/rustchain-fleet.json

# Serve multi-node Prometheus metrics
python3 rustchain_monitor.py --all-nodes --prometheus-listen 127.0.0.1:9108

# Use a custom node list instead of the built-in fleet
python3 rustchain_monitor.py --nodes-config nodes.example.json --export-grafana-json /tmp/custom-fleet.json

Base reward: 1.5 RTC per epoch (~10 minutes)

$ python3 rustchain_monitor.py

╔═══════════════════════════════════════════════════════╗
║  RustChain Network Monitor - 2026-03-02 08:15:00      ║
╠═══════════════════════════════════════════════════════╣
║  Network Status: ✅ Healthy                           ║
║  Active Nodes: 3                                      ║
║  Active Miners: 47                                    ║
║  Current Epoch: 1847                                  ║
║  Base Reward: 1.500000 RTC                            ║
╚═══════════════════════════════════════════════════════╝

Hardware Distribution:
  PowerPC G4:    12 miners (25.5%)
  PowerPC G5:    8 miners (17.0%)
  Apple Silicon: 15 miners (31.9%)
  Modern x86:    12 miners (25.5%)

$ python3 rustchain_monitor.py --miner vintage-g4-mac --watch

╔═══════════════════════════════════════════════════════╗
║  RustChain Miner Monitor - 2026-03-02 08:15:30        ║
╠═══════════════════════════════════════════════════════╣
║  Miner ID: vintage-g4-mac                             ║
║  Balance:  45.782500 RTC                              ║
║  Current Epoch: 1847                                  ║
╠═══════════════════════════════════════════════════════╣
║  Hardware Type: PowerPC G4                            ║
║  Multiplier: 2.5×                                     ║
║  Expected Reward: ~0.375000 RTC/epoch                 ║
║  Status: ✅ Active (last seen: 2 min ago)             ║
╚═══════════════════════════════════════════════════════╝

[08:16:00] 🎉 NEW EPOCH! Earned: 0.382150 RTC
[08:26:00] 🎉 NEW EPOCH! Earned: 0.375000 RTC
[08:36:00] 🎉 NEW EPOCH! Earned: 0.391250 RTC

$ python3 rustchain_monitor.py --node https://rustchain.org/health

Node: https://rustchain.org
Status: ✅ Online
Response Time: 127ms
Last Block: 1847
Peer Count: 8
Sync Status: Fully synced

RustChain is a blockchain that rewards vintage hardware miners using Proof-of-Antiquity consensus. Instead of rewarding the fastest hardware (like Bitcoin), we reward the oldest genuine hardware.

Hardware fingerprinting prevents VM/emulator fraud, ensuring only real vintage machines earn the antiquity multipliers.

Learn more: rustchain.org

• GET /health - Node health check
• GET /epoch - Current epoch info
• GET /api/miners - Active miners list
• GET /wallet/balance?miner_id=X - Miner balance

The monitor can now persist miner balance snapshots into a local SQLite database:

• default DB path: ~/.rustchain-monitor/history.db
• enable recording with --record-history
• print a stored summary with --history-summary
• compare multiple miners with --compare miner-a,miner-b
• export stored rows with --export-csv rewards.csv

Example:

# Collect history during watch mode
python3 rustchain_monitor.py --miner vintage-g4-mac --watch --record-history

# Later, inspect the trend
python3 rustchain_monitor.py --miner vintage-g4-mac --history-summary --history-days 30

The monitor now supports two observability export paths:

• --prometheus-listen 127.0.0.1:9108 serves live metrics at /metrics
• --export-grafana-json out.json writes a Grafana-friendly JSON snapshot with series, tables, and the raw node snapshot

Prometheus metrics include:

• node health, epoch, uptime, backup age, tip age
• active miner count and hardware distribution
• locally recorded miner history gauges when ~/.rustchain-monitor/history.db contains snapshots

For fleet mode, add --all-nodes or --nodes-config path.json. The exporter then emits:

• per-node metrics with node_id, node_name, node_role, and node_url labels
• aggregate fleet gauges such as rustchain_nodes_scrape_ok_total
• disagreement gauges like rustchain_network_epoch_disagreement
• max/min observed miner-count gauges instead of incorrectly summing network-wide counts across nodes

Example:

# Start a local metrics endpoint
python3 rustchain_monitor.py --prometheus-listen 127.0.0.1:9108

# Export a point-in-time JSON payload for Grafana Infinity / JSON API
python3 rustchain_monitor.py --export-grafana-json /tmp/rustchain-monitor.json

# Export the default RustChain fleet
python3 rustchain_monitor.py --all-nodes --export-grafana-json /tmp/rustchain-fleet.json

An example Prometheus-backed Grafana dashboard is included at dashboard/grafana-rustchain-monitor.json. For fleet mode, use dashboard/grafana-rustchain-fleet.json.

epoch_reporter.py now supports real-time alert delivery for:

• new epoch settlements
• miners going offline and coming back
• network health failures and recovery
• reward anomalies when reward_min / reward_max thresholds are configured

Supported delivery targets:

• Discord webhooks
• Slack incoming webhooks
• Telegram Bot API
• Moltbook posting for epoch summaries

Quick start:

# Run once with Discord + Telegram
python3 epoch_reporter.py \
  --discord https://discord.com/api/webhooks/... \
  --telegram-token 123456:ABCDEF \
  --telegram-chat-id 987654321 \
  --once

# Continuous monitoring with a config file
python3 epoch_reporter.py --config epoch_reporter.example.json

See epoch_reporter.example.json for the supported config keys.

Found a bug? Want to add features? PRs welcome!

Ideas for contributions:

• Multi-node monitoring
• Alert routing
• Email/SMS notifications

MIT License - Free to use, modify, and distribute

Created by Sophia Elya | BoTTube | @RustchainPOA

• Multi-miner dashboard
• Email/SMS alerts
• Web UI interface

Before running the monitor, verify these basics:

python3 --version
python3 -c "import requests; print(requests.__version__)"
curl -sS https://rustchain.org/health

If your node URL is custom, validate it explicitly:

curl -sS "https://YOUR-NODE/epoch"

• ModuleNotFoundError: requests → run pip install requests
• Connection refused or timeout → check node URL, firewall, and HTTPS/TLS settings
• Empty miner data → confirm miner_id spelling and that the miner has attested at least once
• Watch mode looks frozen → increase --interval and test one-shot mode first

$ python3 rustchain_monitor.py

╔════════════════════════════════════════════╗
║      RustChain Network Summary         ║
╠════════════════════════════════════════════╣
║  Node:    ✅ Healthy                      ║
║  Epoch:   N/A                            ║
║  Miners:  19 active                  ║
╚════════════════════════════════════════════╝

Hardware Distribution:
  modern          : 11 miners
  apple_silicon   : 2 miners
  g4              : 2 miners
  M4              : 1 miners
  M1              : 1 miners
  Intel64 Family 6 Model 42 Stepping 7, GenuineIntel : 1 miners
  AMD64 Family 23 Model 96 Stepping 1, AuthenticAMD : 1 miners

$ rustchain-monitor --host https://50.28.86.131

RustChain Monitor
================
Status:          OK
Node health:     ✅ healthy
Active miners:   9
Attestation:     3 nodes
Last update:     2026-03-05T12:34:56Z

Tips:
- If health is failing, try: curl -sk https://50.28.86.131/health
- To see miners:          curl -sk https://50.28.86.131/api/miners