Skip to content

πŸš€ Q Coin Testnet v0.0.3 - VPS & Deployment Stability Release

Pre-release
Pre-release

Choose a tag to compare

@fourtytwo42 fourtytwo42 released this 30 Jun 01:10
· 51 commits to main since this release

MAJOR 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-geth was 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 0 still attempting quantum mining
  • Problem: QMPoW constructor defaulted to threads=1 causing "python not found" errors
  • Solution: Changed default from threads=1 to threads=-1 for 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.api and --ws.api in 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/fstab for 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 -- -y

Windows

# Extract quantum-geth-0-0-3.zip
.\start-geth.ps1 testnet          # Start testnet node
.\start-geth.ps1 testnet -mining  # Start with mining enabled

Linux

# 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! πŸš€