Repository navigation
π Q Coin Testnet v0.0.3 - VPS & Deployment Stability Release
Pre-releaseMAJOR UPDATE: This release focuses on critical VPS deployment fixes, enhanced network connectivity, and improved bootstrap reliability. Perfect for production-grade quantum blockchain deployments.
π οΈ Critical VPS Fixes
Bootstrap Swap Management Fix
- CRITICAL: Fixed bootstrap script destroying existing swap memory instead of expanding it
- Problem: Script would destroy 3GB existing swap and create only 512MB new swap, making memory situation worse
- Solution: Added 10MB threshold check and proper swap expansion logic
- Impact: VPS deployments no longer suffer memory degradation during bootstrap
SystemD Service Startup Fix
- Fixed: Bootstrap systemd service killing itself during startup
- Root Cause:
pkill -f start-gethwas matching the startup script itself - Solution: More specific process targeting (
pkill -f geth.bin,pkill -x geth) - Result: VPS services now start reliably without self-termination
VPS Mining Thread Bug Fix
- Fixed: Nodes with
--miner.threads 0still attempting quantum mining - Problem: QMPoW constructor defaulted to
threads=1causing "python not found" errors - Solution: Changed default from
threads=1tothreads=-1for proper CPU mining disable - Impact: VPS nodes properly disable mining when configured
π Network & API Improvements
Enhanced Debug API Availability
- Fixed: External services getting "debug_traceCall does not exist" errors
- Solution: Added 'debug' module to
--http.apiand--ws.apiin all start scripts - Result: Full debugging capabilities now available for external tools and services
Improved Testnet Connectivity
- Added: Two new testnet bootnodes for better network connectivity
- Benefit: Faster peer discovery and more reliable network connections
- Impact: Reduced sync times and improved network stability
π§ Build & Memory Management
Automatic Swap Creation
- Enhanced: Build scripts now automatically create swap space when memory insufficient
- Features:
- Detects memory shortage during build process
- Auto-creates appropriate swap size (needed memory + 512MB buffer)
- Preserves existing temp space usage with
QGETH_BUILD_TEMP - Adds swap to
/etc/fstabfor persistence
- Result: VPS builds succeed on systems with <4GB total memory
Docker Deployment Option
- NEW: Added Docker option to bootstrap script for containerized deployments
- Usage: Universal deployment across any environment supporting Docker
- Benefit: Simplified deployment for users preferring containerization
π¦ Downloads
Windows (Ready to Run)
quantum-geth-0-0-3.zip - Q Coin blockchain node with VPS fixes
quantum-miner-0-0-3.zip - Compatible quantum miner
Linux/VPS (Source + Enhanced Scripts)
Q-Coin-0-0-3.rar - Complete source with production-grade deployment fixes
π Quick Start
VPS Deployment (Recommended)
# Enhanced bootstrap with all v0.0.3 fixes
curl -sSL https://raw.githubusercontent.com/fourtytwo42/Qgeth3/main/bootstrap-qgeth.sh | sudo bash
# Non-interactive mode for automation
curl -sSL https://raw.githubusercontent.com/fourtytwo42/Qgeth3/main/bootstrap-qgeth.sh | sudo bash -s -- -yWindows
# Extract quantum-geth-0-0-3.zip
.\start-geth.ps1 testnet # Start testnet node
.\start-geth.ps1 testnet -mining # Start with mining enabledLinux
# Extract Q-Coin-0-0-3.rar and build
./scripts/linux/start-geth.sh testnet
./scripts/linux/start-geth.sh testnet --miningπ§ Technical Improvements
- Memory Management: Intelligent swap handling prevents memory degradation
- Process Management: Robust systemd service lifecycle without self-termination
- API Exposure: Complete debug API availability for external integration
- Network Resilience: Enhanced bootnode connectivity for faster sync
- Build Reliability: Automatic memory shortage detection and swap creation
- Deployment Options: Docker support for containerized environments
π Network Information
- Testnet Chain ID: 73235
- RPC Endpoint: http://localhost:8545 (or your VPS IP)
- WebSocket: ws://localhost:8546
- P2P Port: 30303
- Consensus: QMPoW (Quantum Micro-Puzzle Proof of Work)
π Upgrade Instructions
From v0.0.2:
# VPS users - systemd service will auto-restart with fixes
sudo systemctl restart qgeth.service
# Manual deployments - stop, update, restart
./scripts/linux/stop-geth.sh
# Download v0.0.3 and rebuild
./scripts/linux/start-geth.sh testnetπ― Production Readiness
This release significantly improves production deployment reliability:
β
VPS Stability: Critical bootstrap and service startup fixes
β
Memory Safety: Intelligent swap management prevents memory issues
β
Network Reliability: Enhanced connectivity with additional bootnodes
β
API Completeness: Full debug API exposure for external tools
β
Build Robustness: Automatic memory shortage handling
β
Deployment Flexibility: Docker option for containerized environments
π‘ What's Next
- Enhanced quantum mining optimizations
- Advanced network monitoring and metrics
- Extended API functionality for DeFi integration
- Cross-chain bridge development preparation
π Q Coin v0.0.3 represents a major leap in deployment reliability and production readiness. Perfect for serious quantum blockchain infrastructure deployment!
Join the quantum revolution with enterprise-grade stability! π