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.

Features

✅ 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

Quick Start

# 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

Hardware Multipliers

Hardware	Multiplier	Expected Reward/Epoch
PowerPC G4	2.5x	~2.5x share
PowerPC G5	2.0x	~2.0x share
PowerPC G3	1.8x	~1.8x share
IBM POWER8	1.5x	~1.5x share
Vintage x86	1.4x	~1.4x share
Apple Silicon	1.2x	~1.2x share
Modern	1.0x	1.0x share

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

Example Output

Network Summary Mode

$ 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%)

Single Miner Watch Mode

$ 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

Node Health Check

$ 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

About RustChain

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

API Endpoints Used

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

Contributing

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

Ideas for contributions:

• Grafana dashboard export
• Discord/Telegram notifications
• Historical reward tracking
• Multi-node monitoring
• Export to CSV/JSON

License

MIT License - Free to use, modify, and distribute

---

Created by Sophia Elya | BoTTube | @RustchainPOA

Future Enhancements

• Multi-miner dashboard
• Export to Prometheus/Grafana
• Email/SMS alerts
• Web UI interface

Preflight Checks (2 minutes)

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"

Quick Troubleshooting

• 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

---