⛏️ BlockBit

Bitcoin Mining Node with Integrated Stratum V1/V2 Pool

Run your own Bitcoin mining pool from a single application

Features • Screenshots • Quick Start • Documentation • Contributing

---

🎯 What is BlockBit?

BlockBit is a powerful Bitcoin Core v30.2 fork with a built-in Stratum V1/V2 mining pool server. It combines full node functionality with solo mining capabilities, allowing you to run your own professional mining pool without additional software.

🚀 One Application. Complete Mining Solution.

┌─────────────────────────────────────────────────────────┐
│  BlockBit = Bitcoin Full Node + Mining Pool Server     │
├─────────────────────────────────────────────────────────┤
│  ✅ Full Blockchain Validation                          │
│  ✅ Integrated Stratum V1/V2 Pool                       │
│  ✅ Professional Mining Dashboard                       │
│  ✅ 5,000+ Concurrent Workers                           │
│  ✅ Solo Mining with Personalized Coinbase             │
└─────────────────────────────────────────────────────────┘

---

✨ Features

⛏️ Mining Pool Dual Protocol Support Stratum V1 (JSON-RPC) Stratum V2 (Binary + Noise Encryption) Solo Mining Mode Personalized coinbase per worker Direct payouts to miner addresses Variable Difficulty (Vardiff) Automatic difficulty adjustment Optimized share submission rates 44+ Configuration Options Fine-grained pool control Network-aware defaults	🖥️ Professional GUI Real-Time Dashboard Live hashrate & statistics Network difficulty tracking Block discovery alerts Worker Management 13-column detailed table Protocol badges (V1/V2) Per-worker charts Security Checklist Visual security indicators Best practice compliance Time-Series Monitoring 800-sample history (~26 min)
🔒 Security & Privacy Stratum V2 Encryption Noise NX protocol AEAD ChaCha20Poly1305 Forward secrecy TLS Support BIP324-style encryption for V1 Encrypted mining traffic Tor Integration Hidden service support Anonymous mining Privacy Features Log redaction IP anonymization Per-IP connection limits	⚡ High Performance Scalable Architecture Epoll-based networking Multi-threaded design Lock-free statistics High Concurrency 5,000+ simultaneous workers 100+ PH/s capable Efficient Validation Duplicate share detection Fast share processing Low Latency <10ms job distribution Optimized network stack

---

📸 Screenshots

🎨 Click to view GUI screenshots

Splash Screen

Modern splash screen with animated hash visualization

---

Setup Wizard

Step 1: Welcome

Step 2: Configuration

Step 3: Start Mining

Easy 3-step setup wizard guides you through pool configuration

---

Main Dashboard

Mining Control Center

Real-Time Performance Graphs

Service indicators • Live statistics • Performance monitoring • Activity logs

---

Worker & Network Monitoring

Detailed Worker Management

Bitcoin Network Statistics

13-column worker table • Protocol badges • Per-worker charts • Network monitoring

---

Advanced Configuration

Server Settings

Difficulty Settings

Connection Settings

Comprehensive configuration • 44+ options • GUI-based pool management

---

🚀 Quick Start

Option 1: GUI (Recommended for Beginners)

# Clone the repository
git clone https://github.com/BlockBitOfficial/BlockBit.git
cd BlockBit

# Install dependencies (Ubuntu/Debian)
sudo apt install build-essential cmake libboost-all-dev libssl-dev \
    libevent-dev libsqlite3-dev qt6-base-dev

# Build BlockBit
cmake -B build -DBUILD_GUI=ON
cmake --build build -j$(nproc)

# Launch GUI
./build/src/qt/blockbit-qt

→ Navigate to the Mining tab and click "Start Pool"

---

Option 2: Command Line (Advanced Users)

# Build daemon
cmake -B build -DBUILD_DAEMON=ON
cmake --build build -j$(nproc)

# Start pool with Stratum V1
./build/src/blockbitd -stratum -stratumbind=0.0.0.0:3333

# Or with both V1 and V2
./build/src/blockbitd -stratum -stratumbind=0.0.0.0:3333 \
                       -stratumv2 -stratumv2bind=0.0.0.0:3336

# Check pool status
./build/src/blockbit-cli getpoolinfo

---

Connect Your Miners

Stratum V1:

URL: stratum+tcp://your-server-ip:3333
Username: your-bitcoin-address
Password: workername

Stratum V2:

URL: stratum2+tcp://your-server-ip:3336

Example with cgminer:

cgminer --url stratum+tcp://192.168.1.100:3333 \
        --user bc1qyourbitcoinaddresshere \
        --pass worker1

---

📚 Documentation

📖 Comprehensive Guides

🔧 Pool Setup Complete configuration reference • 44+ Options • Security Guide • Performance Tuning • Troubleshooting

🖥️ GUI Manual Interface usage guide • Dashboard Tour • Worker Management • Settings Reference • Monitoring Tips

🔐 Stratum V2 V2 technical reference • Noise Protocol • Key Management • Message Types • Security Model

Additional Documentation:

• 📄 Contributing Guidelines
• 🔒 Security Policy
• 🏗️ Build Instructions
• 💻 Developer Notes

---

🏗️ Architecture

┌─────────────────────────────────────────────────────────────┐
│                     BlockBit Architecture                   │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  ┌─────────────────────────────────────────────────────┐   │
│  │         Bitcoin Core v30.2 Foundation             │   │
│  │  • Blockchain Validation  • Wallet                │   │
│  │  • P2P Network            • RPC Interface         │   │
│  └─────────────────────────────────────────────────────┘   │
│                          ▲                                  │
│                          │                                  │
│  ┌─────────────────────────────────────────────────────┐   │
│  │          Integrated Mining Pool Layer             │   │
│  │                                                     │   │
│  │  ┌─────────────────┐    ┌──────────────────┐      │   │
│  │  │  Stratum V1     │    │  Stratum V2      │      │   │
│  │  │  Port 3333      │    │  Port 3336       │      │   │
│  │  │  JSON-RPC       │    │  Binary+Noise    │      │   │
│  │  └─────────────────┘    └──────────────────┘      │   │
│  │                                                     │   │
│  │  • Variable Difficulty   • Share Validation        │   │
│  │  • Worker Management     • Block Submission        │   │
│  │  • Statistics Tracking   • Security Features       │   │
│  │                                                     │   │
│  │  (~6,000 lines of C++ code)                        │   │
│  └─────────────────────────────────────────────────────┘   │
│                          ▲                                  │
│                          │                                  │
│  ┌─────────────────────────────────────────────────────┐   │
│  │            Qt6 Mining GUI Layer                   │   │
│  │                                                     │   │
│  │  • Real-Time Dashboard    • Worker Management      │   │
│  │  • Performance Graphs     • Security Checklist     │   │
│  │  • Settings Editor        • Activity Logs          │   │
│  │                                                     │   │
│  │  (~3,800 lines of C++ code)                        │   │
│  └─────────────────────────────────────────────────────┘   │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Code Statistics:

• Total: ~410,000 lines (including Bitcoin Core base)
• Mining Pool: ~6,000 lines (src/stratum/)
• Mining GUI: ~3,800 lines (src/qt/mining*.cpp)
• Documentation: ~2,000 lines (4 comprehensive guides)

---

🔧 Configuration Examples

Solo Mining Pool (Default)

blockbitd -stratum \
  -stratumbind=0.0.0.0:3333 \
  -stratumsig="/BlockBit/" \
  -stratumstartdiff=65536

Each worker mines to their own Bitcoin address specified in the username field.

Pool with Fee

blockbitd -stratum \
  -stratumbind=0.0.0.0:3333 \
  -stratumfee=2.0 \
  -stratumfeeaddress=bc1qyour_fee_address_here

Coinbase splits: 98% to miner, 2% to fee address.

Maximum Security Configuration

blockbitd -stratum \
  -stratumbind=0.0.0.0:3333 \
  -stratumv2 \
  -stratumv2bind=0.0.0.0:3336 \
  -stratumtls \
  -stratumtlsbind=0.0.0.0:3334 \
  -stratumredactlogs \
  -stratumtor \
  -stratumtorbind=127.0.0.1:3335 \
  -stratummaxconnectionsperip=5 \
  -stratumauthtimeout=30

Enables all security features: V2, TLS, Tor, log redaction, connection limits.

High-Performance Pool (>10 TH/s)

blockbitd -stratum \
  -stratumbind=0.0.0.0:3333 \
  -stratumstartdiff=131072 \
  -stratumtargetshares=4 \
  -stratumretargetinterval=5 \
  -stratuminterval=15 \
  -stratummaxrecvbuffer=131072 \
  -stratummaxworkers=1000

Optimized for large pools with high hashrate.

---

📊 Key Configuration Options

Option	Description	Default
-stratum	Enable Stratum pool server	Disabled
-stratumbind	Bind address for Stratum V1	0.0.0.0:3333
-stratumstartdiff	Starting difficulty	65536 (mainnet)
-stratumv2	Enable Stratum V2 server	Disabled
-stratumv2bind	Bind address for Stratum V2	0.0.0.0:3336
-stratumfee	Pool fee percentage	0.0%
-stratummaxworkers	Maximum workers (0=unlimited)	0
-stratumredactlogs	Anonymize IPs in logs	Disabled

See all 44+ options →

---

🛡️ Security Best Practices

✅ Recommended Enable Stratum V2 for encryption Use TLS if V2 not supported Enable log redaction Set per-IP connection limits Configure authentication timeout Use firewall rules Run Tor for anonymity Regular backups

❌ Avoid Exposing RPC publicly Using default ports without firewall Skipping security updates Ignoring worker anomalies Disabling connection limits Running as root Weak RPC passwords Missing pool key backups

Read full security guide →

---

📈 Performance Stats

Metric	Capability
Concurrent Workers	5,000+
Pool Hashrate	100+ PH/s
Job Distribution	<10ms latency
Share Validation	50,000+ shares/sec
Bandwidth (V2)	70% less than V1
CPU Usage	Minimal (efficient design)

---

🤝 Contributing

We welcome contributions! BlockBit is open source and community-driven.

Ways to Contribute

🐛 Report Bugs • 💡 Suggest Features • 📝 Improve Docs • 💻 Submit Code • 🧪 Test Features

Read Contributing Guide →

---

📜 License

BlockBit is released under the MIT License. See COPYING for details.

Based on Bitcoin Core v30.2

Original Bitcoin Core copyright © 2009-2024 The Bitcoin Core developers

---

🌟 Community & Support

Get Help

📖 Documentation • 💬 Discussions • 🐛 Issue Tracker

Stay Updated

⭐ Star this repo to stay updated with new releases!

---

🚀 Ready to Start Mining?

Download the latest release and launch your own Bitcoin mining pool today!

---

⛏️ BlockBit - Mine Bitcoin Your Way

Professional mining pool software for everyone

Built with ❤️ by the BlockBit Team

GitHub • Documentation • Releases