Documentation | Bitcoin Ghost

Quick Start

Get Started Guide GitHub Repository API Reference Full Specification

Core Infrastructure

Bitcoin Core fork with policy control, BUDS classification, and Ghost Mode privacy.

BUDS Pruning Ghost Mode Templates

Decentralized mining where every node is its own pool. Stratum V1/V2, BFT share consensus.

Stratum V1/V2 Share Consensus Payouts TDP

L2 instant payments with 10-second confirmations. ZK proofs, Wraith mixing, Silent Payments.

ZK Proofs Wraith Silent Payments Unshield

First 101 nodes earn permanent +1 share. Revocation after 7 days offline.

Selection Revocation MPC Ceremony

Applications

All Applications

8 production apps: dashboards, wallets, and payment terminals across web, desktop, terminal, and mobile.

Dashboards Wallets GhostTap Ghost Qt

Web dashboard for node monitoring: mining, rewards, mesh, swarm, and settings.

Next.js Monitoring Rewards Settings

Light Wallet CLI

Minimal command-line wallet connecting via GSP. Fast, private, lightweight.

CLI GSP Protocol Silent Payments

Terminal interface with Ghost Locks, Jump Locks, and L2 payments.

Ratatui Ghost Locks L2 Send Reconcile

Economics & Consensus

Economics Deep-Dive

Share formulas, payout math, treasury mechanics, 5-year decay timeline to ossification.

Share Math Payout Formulas Treasury Decay Ossification

Consensus & Protocol

BFT voting, ZMQ mesh networking, share ledger, checkpoint pipeline with crash recovery.

BFT ZMQ Mesh Checkpoints Nullifier WAL

Protocol Specifications

Transaction classification T0-T3 tiers

BIP-352 Silent Payment addresses

Timelocked P2TR outputs

Risk-tiered automatic key rotation

Wraith Protocol

Two-phase CoinJoin mixing

Transaction relay timing privacy

Selective archive stripping

Dead code detection engine

Groth16 zero-knowledge proofs

Multi-party computation setup

L1 settlement batches

Decentralized pool coordination

Node Capabilities

5-4-3-2-1 verified share system

Encrypted payment metadata

Visual identity avatars

Three-window retention model

Ghost Pay Protocol

L2 instant payment specification

Ghost Pay vs Lightning vs Liquid vs Ark

Operations & Reference

HTTP API for Pool, Pay, GSP

Bitcoin Ghost RPC reference

Deployment Runbook

Production deployment guide

Troubleshooting

Diagnostics and common issues

Key generation and HSM setup

Recovery Runbook

Disaster recovery procedures

Getting Started

Quick start for all roles

Ghost-specific terminology

Ghost Core Integration

Bitcoin Core v30.1 fork guide

What You'll Be Running

Ghost Node Dashboard — Overview

Block Height

215,847

Hashrate

2.4 PH/s

Miners

12

Mesh Peers

97

Shares — 13 / 15

Archive

5

Ghost Pay

4

Mining

3

Reaper

0

Elder

1

Privacy

Ghost ModeON

WraithACTIVE

ShroudACTIVE

HazeOFF

TorOFF

ghost-wallet-tui — 0.4.0

Ghost Light Wallet v0.4.0

Connected to gs1p...7xkm via GSP

GHOST ID

gs1p4qhz...m8f7xkm

BALANCE

0.04521000 BTC

Pending: 0.00150000 BTC (1 incoming)

LOCKS

Active: 3 | Value: 0.02800000 | Next Jump: 2h 14m

ACTIONS

Select >