brk_cli

Command-line interface for running a Bitcoin Research Kit instance.

Preview

• https://bitview.space - web interface
• https://bitview.space/api - API docs

Requirements

• Bitcoin Core running with RPC enabled
• Access to blk*.dat files
• ~400 GB disk space
• 12+ GB RAM

Install

rustup update
RUSTFLAGS="-C target-cpu=native" cargo install --locked brk_cli"

Portable build (without native CPU optimizations):

cargo install --locked brk_cli

Run

brk

Indexes the blockchain, computes datasets, starts the server on localhost:3110, and waits for new blocks.

Note: When more than 10,000 blocks behind, indexing completes before the server starts to free up memory from fragmentation that occurs during large syncs. The web interface at localhost:3110 won't be available until sync finishes.

Options

brk -h       # Show all options
brk -V       # Show version

Command-line options override ~/.brk/config.toml for that run only. Edit the file directly to persist settings:

brkdir = "/path/to/data"
bitcoindir = "/path/to/.bitcoin"

All fields are optional. See brk -h for the full list.

Environment Variables

LOG=debug brk    # Enable debug logging (keeps noise filters)
RUST_LOG=... brk # Full control over log filtering (overrides all defaults)

Files

~/.brk/
├── config.toml   Configuration
└── log           Logs

<brkdir>/         Indexed data (default: ~/.brk)