// 01

Zero Consensus Changes

Ghost is a Bitcoin-compatible node distribution that enhances Bitcoin's infrastructure without modifying consensus rules. Every Ghost node validates blocks exactly as Bitcoin Core does.

All Ghost features operate at the policy layer — meaning they affect how nodes communicate, store data, and build blocks, but never change what makes a block valid.

⚡ Key Principle
Ghost enhances Bitcoin without changing Bitcoin. No soft forks, no hard forks, no new tokens. Just better infrastructure.
// 02

System Architecture

Ghost consists of four tightly integrated modules that work together to provide a complete node environment.

⚙️
Ghost Core
Bitcoin Core fork with BUDS classification, pruning, and Ghost Mode
🖥️
Ghost Node
Operator runtime, dashboard, health monitoring, share tracking
⛏️
Ghost Pool
Decentralized mining pool with BFT consensus and Stratum support
💸
Ghost Pay
L2 payment system with 10-second microblocks, Silent Payments, ZK Proof TXs. Fast and private.
// 02.1

Why Run a Full Stack Ghost Node?

Running the complete Ghost stack unlocks benefits unavailable with traditional Bitcoin nodes.

Nodes earn up to 15 shares based on verified capabilities — including archive storage, L2 payments, public mining, policy enforcement, and elder status.
See the full breakdown →
// 03

BUDS Classification

BUDS (Bitcoin Unified Data Standard) is a classification system that categorizes transaction data into tiers based on their purpose and importance.

Ghost uses BUDS for pruning decisions, mempool filtering, and template shaping — all without affecting consensus validity.

T0
Consensus-Critical
Inputs, outputs, signatures — always retained
T1
Economic/System
Fee data, lock times — always retained
T2
Metadata/Application
OP_RETURN, inscriptions — retained by default
T3
Unknown/Obfuscated
Unclassified data — pruned by default
📊 Default Policy
Pure Keep: T0, T1, T2. Operators can create their own mempool, block, and pruning policy profiles based on their needs.
// 04

Three-Window Pruning

Ghost introduces a structured pruning model with three distinct windows, ensuring both storage efficiency and consensus safety.

VW (576 blocks)
OW (Configurable)
AW (Archive)
Validator Window: Full retention, no pruning allowed (~4 days)
Operator Window: BUDS-based pruning allowed (7-30 days)
Archive Window: Infinite retention (+5 shares)

VW (576 blocks, ~4 days): Always stored in full. Fixed and non-configurable. Ensures reorg safety and consensus re-validation. Never pruned.

OW (Configurable, 7-30 days): The only window where BUDS-based pruning occurs. Default: keep T0, T1, T2; prune T3. Operators can customize.

AW (Archive Mode): Full chain history with zero pruning. Required for Ghost Pay channel reconstruction. Earns +5 shares reward.

// 05

Ghost Mode

Ghost Mode is a privacy-preserving operational mode that makes your node invisible to the network while still participating in mining and block submission.

🌐 Normal Mode
  • Transaction relay enabled
  • Mempool advertised to peers
  • INV messages broadcast
  • Full peer connections
  • Template building visible
  • Gossip propagation active
👻 Ghost Mode
  • No transaction relay
  • Private local-only mempool
  • No INV messages sent
  • Blocks-only peer connections
  • Templates built privately
  • Minimal inbound peers
🔒 Privacy Guarantee
Ghost Mode status is never broadcast to the network. Only you and your local pool process know your mode. Block submission always remains enabled for solo mining and winning block propagation.
// 06

Block Found Flow

When a block is found, Ghost's BFT consensus ensures all nodes agree on the payout distribution.

1

Block Found

A miner on a Ghost node finds a valid block. The block is immediately broadcast to the Bitcoin network. The node receives 100% TX fees via coinbase.

2

Share Ledger Frozen

All Ghost nodes freeze their share ledger for this round. No more shares accepted for the completed round.

3

Payout Proposals

Each node calculates and broadcasts their payout proposal based on the deterministic formula.

4

BFT Consensus

Nodes vote on proposals. 67% agreement required. If not reached, median calculation used as fallback.

5

Payout Transaction

The finding node creates and broadcasts the payout transaction. All nodes verify before relaying.

// 07

Elder Node System

The first 101 nodes to register become Elder nodes. Elders receive +1 share permanently, incentivizing early network participation.

Rules:

  • Elder status is assigned to the first 101 registered nodes
  • If offline for ≥7 continuous days, Elder status is permanently revoked
  • Elder slots are never refilled once revoked
  • Elder status cannot be transferred or purchased
// 08

Custom Policies

Ghost gives operators full control over mempool acceptance, block template construction, and pruning behaviour.

Mempool Profiles
Standard, Strict, Clean, Structured, App-Friendly, Ghost (private). Control which transactions your node accepts.
Block Templates
Standard, Max-Fee, Clean Block, Strict, Structured, App-Friendly, Ghost Block. Shape what goes into your blocks.
Pruning Profiles
Default (keep T0-T2), Strict (T0-T1 only), Clean (drop T2+T3), or Archive (keep everything forever).
// 09

Node UX

Ghost Node provides a professional operator experience with multiple interfaces.

🖥️ Web Dashboard
14-page local dashboard accessible via SSH tunnel or Tailscale VPN. Real-time mining stats, BUDS visualisation, share tracking, reward history, and configuration.
Local-only • JWT auth • WebSocket real-time updates
⌨️ TUI CLI Wallet
Terminal-based wallet interface for Ghost Pay. Create Ghost Keys, manage Ghost Locks, send private transactions, and interact with Wraith Protocol.
SSH accessible • Keyboard-driven • Air-gapped compatible
// 10

Mining Options

Ghost supports multiple mining configurations to fit any operator's needs.

Public Mining (+3 shares)
Accept external miners via Stratum V1/V2. Auto-geo endpoints route miners to your node. Earn +3 shares for public mining.
Private Mining (Ghost Mode)
Run your own miners privately. Templates never exposed. Maximum privacy for solo operators with their own hashrate.
Hybrid Mode
Toggle between public and Ghost Mode as needed. Switch instantly via dashboard or CLI without restarts.
// 11

Ghost Pay Protocol

Ghost Pay is a Bitcoin-native L2 payment system designed for speed and privacy.

Core Features
  • 10-second microblock confirmations
  • Silent Payments (BIP-352) integration
  • Zero-Knowledge proof transactions
  • No channel liquidity requirements
  • Offline receive capability
  • BFT consensus for L2 state
Payment Primitives
Ghost Keys
Stealth address derivation for unlinkable receive addresses
Ghost Locks
UTXO-based payment locks, no channel state required
Jump Locks
Multi-hop payments through intermediary nodes
// 12

Wraith Protocol

Wraith Protocol provides the privacy layer for Ghost Pay, enabling unlinkable transactions.

🔀
Split-Merge
Break amount links via split and merge operations
✍️
Blind Signatures
Sign without seeing content for unlinkability
🔐
ZK Proofs
Groth16 zero-knowledge proofs (3 circuits, depth 20)
L1 Reconciliation
Anchor L2 state to Bitcoin via BUDS-tagged commits
🌊 Entry Points
Enter Wraith Protocol from any Ghost node. Split funds, route through the privacy pool, merge at destination. All anchored to Bitcoin L1.

Dive Deeper

Read the full specifications on GitHub.

View on GitHub Economics →