Lib.rs

Terminal block explorer for Blocknet, a privacy-focused cryptocurrency.

Built with ratatui. Connects to a running Blocknet daemon via its REST API.

Views

Dashboard (1)

Chain stats, wallet balance, mempool sparklines with history, and mining controls with a plasma visualizer that reacts to hashrate. Shockwave animation on block discovery.

Grid (2)

Top-down block field showing the last 500 blocks. Each block is color-coded by transaction count (white = empty, green = busy). Selected block is pulled out and rendered as a spinning 3D wireframe cube whose rotation speed reflects how fast it was mined relative to the 5-minute target. Row gutter shows block heights for orientation.

Keybindings

Requirements

• A running Blocknet node with the API enabled (default port 8332)
• API cookie file at <blocknet-dir>/data/api.cookie (created by the daemon on startup)

Note: The daemon must be running before you launch bntui — it creates the cookie file on startup.

Install

Homebrew (macOS)

brew install obselate/tap/bntui

AUR (Arch Linux)

yay -S bntui

Chocolatey (Windows)

choco install bntui

Cargo (any platform)

cargo install bntui

From release binaries

Download the latest binary for your platform from Releases.

chmod +x bntui
./bntui /path/to/blocknet

From source

Requires Rust 1.85+.

git clone https://github.com/obselate/bntui.git
cd bntui
cargo build --release
./target/release/bntui /path/to/blocknet

Usage

If the Blocknet daemon is running, bntui will automatically find the data directory — no arguments needed:

# auto-detect (checks cwd, then platform default)
bntui

bntui searches for data/api.cookie in the following order:

1. Explicit argument or BLOCKNET_DIR env var
2. Current directory — useful when running from the blocknet project directory
3. Platform default:
   • macOS: ~/Library/Application Support/Blocknet
   • Linux: ~/.blocknet
   • Windows: %APPDATA%\Blocknet

$ bntui --help
Terminal block explorer for Blocknet privacy blockchain

Usage: bntui [OPTIONS] [BLOCKNET_DIR]

Arguments:
  [BLOCKNET_DIR]  Path to blocknet directory [auto-detected if omitted]

Options:
      --host <HOST>      API host to connect to [default: localhost]
      --port <PORT>      API port to connect to [default: 8332]
      --cookie <COOKIE>  Path to API cookie file (default: {blocknet_dir}/data/api.cookie)
  -h, --help             Print help
  -V, --version          Print version

# Or pass the directory explicitly
bntui /path/to/blocknet

# Or set the environment variable
export BLOCKNET_DIR=/path/to/blocknet
bntui

# Connect to a remote daemon
bntui --host 192.168.1.100 --port 8332 --cookie /path/to/api.cookie

Docker

If running Blocknet in Docker, make sure the data directory is bind-mounted:

volumes:
  - ./data:/data

Then point bntui at the directory containing the data/ folder.

API Endpoints Used

All endpoints require Bearer token authentication via the cookie file.

License

MIT