A correctness-first CLI tool for analyzing Bitcoin Core mempool data, with a focus on transparency, reproducibility, and conservative assumptions.
The tool connects to a local Bitcoin Core node (regtest or mainnet), retrieves live mempool data via RPC, and summarizes transaction counts and fee-rate distribution in sat/vB.
-
Correctness over prediction
The analyzer reports observed mempool state only. -
Separation of concerns
analyzer/→ pure analysis logicrpc/→ Bitcoin Core RPC wrappercli/→ thin command-line interface
-
Safe defaults
If RPC is not configured, the tool runs in dry mode without errors. -
Reproducibility
Regtest is used for controlled experiments and deterministic behavior.
-
High-level mempool summary:
- transaction count
- total virtual size
- total fees
-
Fee-rate distribution:
- computes sat/vB from live mempool entries
- aggregates transactions into fee buckets
- reports top fee levels currently present
python -m cli.main --summary