Help & Documentation
Everything you need to know about your Predictive Mining Node tool — concisely summarised.
Predictive Mining Node is a tool for Bitcoin mining pool operators that analyses the mempool in real time and generates predictive block templates for the next three blocks (+1, +2, +3). These templates are fed to your OCEAN pool directly via the DATUM gateway.
When a block is found (tip change), there is normally a 1–5 second gap between the new block height and a ready, optimised template. During this time your pool mines an empty block or a stale template. This tool reduces that time to under 50 ms.
Frequently asked questions
Do I need GPUs?
No. Predictive mining is a pure mempool-analysis workload — runs on any modern server with enough RAM (16 GB+).
Why are blocks +2 and +3 often empty?
The mempool must be large enough to fill three full blocks (about 12 MB vsize). At low network load the mempool often only suffices for block +1. That is not a bug but the current Bitcoin market situation.
How high should the hit-rate +1 be?
85 to 95 percent is realistic with a well-loaded mempool (over 10 MB vsize). Values below 70 percent indicate mempool sync issues or missing Bitcoin Core ZMQ events.
Does the tool work with pools other than OCEAN?
Currently DATUM Gateway is used as the backend (for OCEAN). Other pools with a block-template API can be integrated on request.
Can I run the tool 24/7?
Yes, that is what it is made for. Setup as a systemd service (see INSTALL.md) ensures auto-start after reboot and auto-restart on crash.
How do I update the tool?
git pull origin main in the repo directory, then cd frontend && yarn build and sudo systemctl restart predictive-mining-{backend,frontend}.
Where do I find logs in case of problems?
sudo journalctl -u predictive-mining-backend -n 200 --no-pager — shows the last 200 lines of backend log with timestamp.
Troubleshooting
Backend doesn't load / 502 Bad Gateway: Backend service is down. Check with
sudo systemctl status predictive-mining-backend.DATUM Monitor shows Not verified: DATUM config path in backend/.env missing or DATUM_ADMIN_PASSWORD wrong.
Hashrate Race shows 0 H/s: DATUM gateway not reachable. Test:
curl -u admin:PASS --digest http://localhost:7152/clientsMempool Radar stays empty: Bitcoin Core not fully synced or ZMQ events not active. Check bitcoin.conf:
zmqpubrawtx=tcp://127.0.0.1:28332
zmqpubhashblock=tcp://127.0.0.1:28333Performance Analytics shows Loading: Hard refresh in the browser (Ctrl+Shift+R). If still: check backend logs.
Support & Contact
For technical support, feature requests or licence questions please contact the developer directly:
Version: Predictive Mining Node v2.0 · Sales Edition