About BTCX Observatory

BTCX Observatory is a read-only analytics dashboard for the Bitcoin-PoCX chain. It runs alongside a bitcoind node and turns the chain's raw state into charts, tables, and search-friendly pages — without ever opening a write path back to the node.

Three independent tiers

• Chain analytics. Block-header timeseries: difficulty, block time, transaction count, size. Reorg events are tracked, not silenced — /admin/reorgs exposes the full audit log.
• UTXO analytics. Periodic snapshots of the chain's unspent-output set feed the richlist, wealth-distribution Lorenz curve, theoretical-vs-realised supply chart, and per-address history pages.
• Network analytics. Two complementary peer-discovery paths — a passive RPC snapshot from the local node and an active recursive crawler — populate the country / ASN bar charts and the gossip graph at /network.

Each tier writes to its own SQL backend and is independently restartable. A crawler hiccup never blocks chain indexing.

What this isn't

The Observatory does not mine, does not broadcast transactions, does not hold keys, does not proxy bitcoind RPC. It reads. The single non-read path is the optional /admin config editor, gated behind an operator-set token.

Configuration and operations

Settings live in config.yaml next to the binary. Most fields hot-reload within ~30 seconds; cold fields (listener address, RPC URL, DB URL) log a RESTART REQUIRED notice and apply on the next start. The example file in the repository documents every knob.

License

Proprietary. © 2026–present PoC Consortium. All rights reserved.