🌐 Blockchaininfo

A Real-Time Bitcoin Network Observatory — Built in Rust

---

Overview

Blockchaininfo is a high-performance, real-time terminal dashboard that reveals the true heartbeat of the Bitcoin network. Built in Rust for safety and speed, it connects directly to your Bitcoin Knots/Core RPC and delivers:

• live blockchain metrics
• mempool analytics
• network decentralization health
• consensus security / fork monitoring
• transaction lookup
• and more

All packaged in a clean, color-coded TUI.

This is a tool built for those who care about decentralization, sovereignty, and the integrity of Bitcoin’s proof-of-work network.

---

Why Blockchaininfo Exists

Bitcoin is decentralized — but only if the network stays diverse and transparent.

Blockchaininfo monitors:

• which versions are running
• how healthy mempool activity is
• how distributed the hash rate is
• whether forks appear
• how nodes behave across the network

It offers a real-time lens into the state of Bitcoin’s decentralization — something no block explorer or web UI can deliver with this immediacy, clarity, and local privacy.

---

Key Features

⚡ Real-Time Insights

Every section updates independently using asynchronous tasks and global caches — ensuring smooth, flicker-free updates.

🧠 Decentralization Monitoring

Track node version diversity and client distribution to identify centralizing trends.

🔥 Consensus Security

Live fork monitoring displays active chain vs stale forks — with an automatic warning popup when a fork grows long.

🧩 Mempool Distribution

Custom mempool sampling logic (backed by semaphore concurrency + atomic dust filters) surfaces real-world fee pressure and distribution patterns.

🎛️ Interactive Toggles

Switch views instantly:

• Hashrate Distribution
• Dust-Free mempool view
• Version vs Client distribution
• Transaction lookup
• Help panel

🦀 Rust-Powered Reliability

• Memory-safe
• Panic-free
• Concurrency tuned
• 60+ day uptime proven

---

File Structure

.
├── benches/
├── cargo.toml
├── miners.json
└── src/
    ├── config.rs
    ├── display/
    ├── models/
    ├── rpc/
    ├── runapp.rs
    ├── utils.rs
    └── main.rs

Each folder has a clear role:

• display/ → TUI rendering
• rpc/ → Bitcoin RPC operations
• models/ → local data structures (no external Bitcoin crates)
• runapp.rs → async orchestration & global cache system

---

Configuration

The app supports multiple configuration paths, from zero-setup to hardened security.

1. Automatic Failsafe Mode (Zero Setup)

If no config exists, Blockchaininfo prompts for RPC credentials and auto-creates:

./target/release/config.toml

2. config.toml File

Preferred for custom setups.

[bitcoin_rpc]
username = "your_username"
password = "your_password"
address = "http://127.0.0.1:8332"

3. Environment Variables

export RPC_USER="user"
export RPC_PASSWORD="password"
export RPC_ADDRESS="http://127.0.0.1:8332"

4. macOS Keychain Support

Secure password retrieval:

security add-generic-password -a bitcoin -s rpc-password -w "your_password"

Priority Order

1. CLI flag (--config)
2. Env var (BLOCKCHAININFO_CONFIG)
3. Default path
4. Env variables (RPC_*)
5. macOS Keychain

---

Installation

git clone https://github.com/TH3BAT/Blockchaininfo.git
cd Blockchaininfo
cargo build --release

---

Usage

./target/release/blockchaininfo

Requires a running Bitcoin Knots/Core node with RPC enabled.

---

Demo Video

A full demonstration video (BlockChainInfoLiveDemo.mov) is available in the Releases section.

Shows:

• Hash Phase flip
• Mempool distribution
• Node version/client charts
• Fork monitoring
• All toggles in action

---

Error Handling

Blockchaininfo is built to survive:

• RPC timeouts
• invalid responses
• json parsing failures
• node restarts
• mempool storms

Errors are logged, not fatal.

---

Contributions

PRs welcome! Fork → branch → PR.

---

License

MIT — do whatever your sovereign soul wants.