Bitcoin Core with Proof of Capacity neXt generation (PoCX) consensus integration.
Status: Testnet Phase Organization: Proof of Capacity Consortium License: MIT
📘 Complete Technical Documentation - 8-chapter browseable guide covering all aspects of the system
📄 Whitepaper - Academic overview, design rationale, and architecture
Quick Links:
git clone --recursive https://github.com/PoC-Consortium/bitcoin-pocx.git
cd bitcoin-pocx/bitcoincmake -B build -DENABLE_POCX=ON
cmake --build build -j$(nproc)# Node only
./build/bin/bitcoind
# With mining server enabled
./build/bin/bitcoind -miningserver
# Qt wallet
./build/bin/bitcoin-qt -server -miningserverBuild Requirements: Standard Bitcoin Core dependencies (see Bitcoin Core docs)
bitcoin-pocx/ # Main integration repository
├── bitcoin/ # Bitcoin Core v30.0 + PoCX (submodule)
│ └── src/pocx/ # PoCX implementation
├── pocx/ # PoCX core framework (submodule, read-only)
├── docs/ # Complete technical documentation
│ ├── index.md # Documentation hub
│ ├── whitepaper.md # Academic whitepaper
│ └── [1-8]-*.md # 8-chapter guide
└── README.md # This file
- bitcoin/ → PoC-Consortium/bitcoin - Bitcoin Core v30.0 with PoCX integration
- pocx/ → PoC-Consortium/pocx - PoCX core framework (read-only reference)
Bitcoin-PoCX integrates Proof of Capacity consensus into Bitcoin Core as a complete replacement for Proof of Work. Mining power derives from pre-generated plot files stored on disk rather than computational hashing, reducing energy consumption by several orders of magnitude.
Key Features:
- Energy-efficient Proof of Capacity consensus
- 120-second block time (2 minutes)
- 10 BTC initial subsidy, halving every 1,050,000 blocks (~4 years)
- ~21 million BTC total supply
- Native C++ implementation in
/src/pocx/ - Feature-flagged integration (
#ifdef ENABLE_POCX) - Time Bending algorithm for reduced block time variance
- Forging assignment system (OP_RETURN-based delegation)
- Dynamic compression scaling
Network Status:
- Mainnet: Not yet launched
- Testnet: Available for testing
- Regtest: Fully functional for development
Bitcoin-PoCX uses external mining tools that connect via RPC:
- Generate plot files using
pocx_plotter(reference implementation) - Run Bitcoin-PoCX node with
-miningserverflag - Connect miner using
pocx_miner(reference implementation)
See Chapter 3: Consensus and Mining and Chapter 7: RPC Reference for complete details.
# Clone with submodules
git clone --recursive https://github.com/PoC-Consortium/bitcoin-pocx.git
# Build Bitcoin Core with PoCX
cd bitcoin-pocx/bitcoin
cmake -B build -DENABLE_POCX=ON
cmake --build build -j$(nproc)
# Run tests
./build/src/test/test_bitcoinBuild Windows installer from Linux:
# Install dependencies (Ubuntu/Debian)
sudo apt install g++-mingw-w64-x86-64-posix nsis
# Build depends
cd bitcoin-pocx/bitcoin/depends
make HOST=x86_64-w64-mingw32 -j$(nproc)
# Configure and build
cd ..
cmake -B build-win --toolchain depends/x86_64-w64-mingw32/toolchain.cmake
cmake --build build-win -j$(nproc)
# Create installer
cmake --build build-win --target deploy -j$(nproc)
# Output: build-win/bitcoin-pocx-win64-setup.exe- CLAUDE.md - Development guidelines
- Documentation - Complete technical reference
- Bitcoin Core docs - Upstream Bitcoin Core documentation
Bitcoin Core Base: v30.0 PoCX Framework: github.com/PoC-Consortium/pocx Integration Repository: github.com/PoC-Consortium/bitcoin-pocx
Attribution:
- Plot format based on POC2 (Burstcoin) with security enhancements
- Miner based on scavenger
- Plotter based on engraver
Full attribution in Chapter 2: Plot Format.
Bitcoin-PoCX inherits Bitcoin Core's MIT license. See COPYING for details.
- Documentation: docs/index.md
- Issues: GitHub Issues
- Technical Questions: See comprehensive documentation chapters
Get Started: 📘 Read the Documentation →