ChangeLog

# CKPool Changelog

## EloPool Fork - Production Features & Improvements

This fork transforms CKPool into a production-ready Bitcoin Cash solo mining pool with significant enhancements for modern ASIC mining operations.

## Production Achievements
- **66 mainnet blocks** successfully mined on Bitcoin Cash network
- Battle-tested with major mining services (NiceHash, MiningRigRentals)
- Production deployment handling industrial ASIC miners

## Major Features

### Bitcoin Cash Support
- ✨ Full CashAddr support for BCH addresses (mainnet/testnet/regtest)
- ✨ Multi-node ZMQ support for faster block detection
- 🐛 Fixed BCH-specific getblocktemplate compatibility (removed segwit)
- 🔧 Automatic network detection (mainnet/testnet/regtest)

### Mining Enhancements
- ✨ **Multi-difficulty support** with password and pattern matching
- ✨ **NiceHash compatibility** with automatic difficulty adjustment
- ✨ **User-agent based difficulty** detection for rental services
- ✨ **Pool operator fee** with dual-output coinbase splitting
- ✨ **Dynamic per-user coinbase messages** via btcsig
- ⚡ Optimized share validation logic

### Installation & Configuration
- ✨ Interactive installation script with mainnet/testnet configs
- ✨ Unified build system with cross-platform support
- 🔧 Auto-detection of BCH nodes from config
- 📚 Comprehensive API documentation for ckpmsg

### Bug Fixes & Improvements
- 🐛 Fixed critical share validation logic
- 🐛 Corrected CashAddr 5-bit to 8-bit conversion
- 🐛 Fixed NiceHash difficulty application with pattern matching
- 🐛 Resolved format specifier warnings
- 🐛 Fixed ZMQ subscription string length issues
- ⚡ Performance optimizations for share acceptance

### Lean Blocks Feature (Experimental)
- ✨ Dual submit for maximum block discovery
- 📚 Comprehensive documentation for lean blocks mode
- 🔧 Test and production configs included

### Documentation
- 📚 Complete rewrite of README with production features
- 📚 Added CKPool API guide
- 📚 Ubuntu deployment guides
- 📚 Regtest testing documentation
- ⚠️ Critical issue tracking and resolution

### Code Quality
- 🧹 Repository cleanup - removed unused files
- ♻️ Modernized installer scripts
- 🧹 Removed deprecated donation addresses
- 🔧 Updated .gitignore for build artifacts

## Recent Updates (Latest First)

### v1.1.0 (2025-10-08) - Production Deployment Suite
**Enterprise-Grade Multi-Node Failover**
- ⚡ **Instant failover** - Single failure triggers failover (~100ms vs 4+ seconds)
- ⚡ **Sync-aware failover** - Stays on backup while primary node is syncing
- ⚡ **Automatic recovery** - Intelligently fails back to primary when ready
- 🐛 Fixed synchronous failover preventing retry of failed servers
- 🐛 Added forward declaration for reconnect_generator to fix build errors
- 📚 Comprehensive multi-node redundancy documentation with real production logs

**Production Deployment Tools**
- ✨ Added `post-install.sh` - Systemd service installer with firewall configuration
- ✨ Added `monitor.sh` - Matrix-style colorized log viewer with real-time monitoring
- ✨ Added `clean-old-blocks.sh` - Automatic cleanup of old block directories
- 🔧 Auto-detection of stratum ports from config files
- 🔧 UFW firewall integration with automatic port configuration
- 🔧 Systemd service with production-grade resource limits
- 🔧 Automatic cron job setup for maintenance tasks

**Systemd Service Enhancements**
- 🔧 Updated to production-tested configuration
- 🔧 Added network-online.target for better network reliability
- 🔧 ExecReload with HUP signal for graceful reloads
- 🔧 Higher resource limits (2.1M NOFILE, 32K NPROC, unlimited MEMLOCK)
- 🔧 Proper timeout values (60s start, 30s stop)
- 🔧 KillMode=mixed and KillSignal=SIGTERM for clean shutdown
- 📚 Documentation field pointing to GitHub repository

**Installation & Dependencies**
- 🐛 Added dependency checking to install-ckpool.sh
- 🔧 Auto-detection of OS (Ubuntu/Debian)
- 🔧 Automatic dependency installation prompts
- 📚 Updated installation and service management documentation

### 2025 - Production Optimizations
- 📚 Emphasized 66 mainnet blocks in production achievements
- 📚 Moved comparison table to top of README
- 🧹 Removed unused cashaddr.cpp files
- ⚡ Only reject shares below pool mindiff
- 🐛 Removed false CashAddr warnings

### 2024 - Core Development
- Complete Bitcoin Cash compatibility implementation
- Multi-difficulty system for rental services
- Interactive installation system
- Pool fee implementation
- CashAddr address format support

## Legacy CKPool Base

Built upon the solid foundation of CKPool by Con Kolivas, maintaining core stability while adding modern features required for production Bitcoin Cash mining operations.

For detailed commit history, see: https://github.com/skaisser/ckpool

---
*Note: This changelog represents significant changes since forking from the original CKPool project. For the complete commit history, use `git log`.*