Reproducible Bitcoin protocol laboratory

Construct, attack, and verify transactions against Bitcoin Core.

BitScope is local-first, regtest-focused, educational, and evidence-driven. Reviewed scenarios record Bitcoin Core outcomes, expected failures, lifecycle events, cleanup, and deterministic proof bundles.

BitScope learner Home screen

Screenshots

Real local-node workflows, not a hosted explorer.

These screens show BitScope interacting with a local regtest node and pairing each UI result with command-line and JSON-RPC context. BitScope is not a mainnet wallet, custody service, production treasury coordinator, security audit, or replacement for Bitcoin Core.

Architecture

Hosted docs, local execution.

The public site is intentionally static. The real BitScope app runs locally because the backend talks to the user's Bitcoin Core RPC endpoint and keeps credentials server-side.

Frontend

Next.js pages for dashboards, Verified Scenarios, Reviewer Mode, curriculum, policy comparison, and labs.

Backend

FastAPI executes closed reviewed workflows and emits typed, redacted, hash-covered evidence.

Bitcoin Core

The user's own node remains the source of truth. No hosted blockchain APIs are used.

Run locally

Start with regtest.

git clone https://github.com/comwanga/BitScope
cd BitScope
.\scripts\compose.ps1 up --build

Open http://localhost:3000/capstone-demo for the canonical Reviewer Mode walkthrough, or use the shorter Demo Mode for basic wallet and transaction onboarding.