Q-NarwhalKnight v0.1.9-betaQuantum-Enhanced DAG-BFT Consensus with Distributed AI Inference
The World's First Blockchain with Horizontal AI Scaling
🚀 MAJOR RELEASE: v0.1.9-betaRelease Date: October 29, 2025
Status: Production Beta - Distributed AI Enabled
Revolutionary Features:
✅ Distributed AI Inference - Horizontal scaling across network nodes
✅ Mistral-7B Integration - On-chain AI chat with full message persistence
✅ Fixed Chat UI - Complete responses (2048 tokens), no more truncation
✅ AI Enabled by Default - Opt-out with Q_DISABLE_AI=1 flag
✅ Enhanced P2P - Critical peer discovery fixes for zero peer count
📥 DOWNLOADGitHub Repository: code.quillon.xyz
🤖 DISTRIBUTED AI INFERENCE (NEW!)Q-NarwhalKnight v0.1.9-beta introduces
horizontal AI scaling - the first blockchain to distribute AI inference across network nodes using
libp2p + Gossipsub coordination.
Architecture:┌──────────────────────────────────────────────────────┐
│ Q-NarwhalKnight P2P Network │
│ libp2p + Gossipsub + Kademlia DHT │
│ │
│ Gossipsub Topics (5): │
│ - qnk/ai/inference-request/v1 │
│ - qnk/ai/layer-output/v1 │
│ - qnk/ai/node-capability/v1 │
│ - qnk/ai/coordinator/v1 │
│ - qnk/ai/heartbeat/v1 │
└───────────┬──────────────────────┬───────────────────┘
│ │
┌───────▼────────┐ ┌──────▼───────┐
│ Node A │◄───►│ Node B │
│ Coordinator │ │ Participant │
│ CUDA 24GB │ │ Metal 32GB │
│ Layers 0-15 │ │ Layers 16-26 │
└────────────────┘ └──────────────┘
Key Features:
Automatic Hardware Detection - CUDA/Metal/CPU capability scoring
Layer-Parallel Processing - 32 layers distributed across nodes (Mistral-7B)
Graceful Fallback - Single-node inference when distributed nodes unavailable
Real-time Statistics - Token throughput, latency, nodes used tracking
Gossipsub Coordination - P2P discovery and layer assignment
Performance Targets:
Single Node: 0.51 tok/s (CPU baseline)
3-Node Distributed: 2.86 tok/s target (5.6Χ speedup)
Latency: 350-578ms per token (distributed)
How It Works:1. Client creates chat with
distributed_enabled: true2. Coordinator queries available nodes via gossipsub
3. Nodes announce hardware capabilities (CUDA/Metal/CPU)
4. Inference request published to network
5. (Phase 2) Layers assigned based on capability scores
6. (Phase 2) Sequential layer execution with tensor forwarding
7. Tokens streamed back to client in real-time
Usage:# AI enabled by default (v0.1.9-beta)
./q-api-server --port 8080
# Disable AI to save ~4GB RAM:
export Q_DISABLE_AI=1
./q-api-server --port 8080
# Create distributed chat via API:
curl -X POST http://localhost:8080/api/chat/new \
-H "Content-Type: application/json" \
-d '{"user_id": "test", "title": "Distributed Test", "distributed_enabled": true}'
💬 CHAT UI FIXES (CRITICAL)Problem: Users reported AI chat stopping mid-sentence after ~150 tokens, with messages vanishing when browsing away.
Root Causes Found:❌ max_tokens defaulted to only 150 tokens (mid-sentence cutoffs)
❌ Partial responses not saved on client disconnect
❌ EventSource error handlers clearing message state
Solutions Implemented:✅ Increased max_tokens from 150 → 2048 (full responses up to ~2000 words)
✅ Save partial responses on client disconnect (no data loss)
✅ Improved EventSource error handling (messages persist)
✅ Double requestAnimationFrame for correct rendering timing
Before vs After:| Metric | BEFORE | AFTER |
| Max Response | ~150 tokens (~150 words) | 2048 tokens (~2000 words) |
| Message Persistence | ❌ Vanishes on disconnect | ✅ Saves partial responses |
| Browse Away | ❌ Messages lost | ✅ Messages persist |
| Error Recovery | ❌ State cleared | ✅ Auto-loads from storage |
Technical Details:
Model: Mistral-7B-Instruct-v0.3 (Q4_K_M quantization)
Context Window: 8192 tokens
Response Limit: 2048 tokens (leaving room for prompt)
Storage: RocksDB ai_chats column family
Streaming: Server-Sent Events (SSE) with cumulative text tracking
🌐 ENHANCED P2P NETWORKINGCritical Peer Discovery Fix:Fixed zero peer count issue that prevented nodes from discovering each other on the network.
Network Stack:
libp2p - Modular P2P networking framework
Gossipsub - Efficient pub/sub messaging (5 AI topics)
Kademlia DHT - Distributed hash table for peer discovery
QUIC Transport - High-performance UDP-based protocol
mDNS - Local network peer discovery
Topics:/qnk/blocks/v1 - Block propagation
/qnk/transactions/v1 - Transaction gossip
/qnk/ack/v1 - Acknowledgements
/qnk/ai/* - Distributed AI coordination (5 topics)
📜 COMPLETE RELEASE HISTORYv0.1.9-beta (October 29, 2025) - Distributed AI + Horizontal ScalingMajor Features:
✅ Distributed AI coordinator with automatic hardware detection
✅ Horizontal scaling infrastructure for multi-node inference
✅ Mistral-7B-Instruct-v0.3 integration via mistral.rs
✅ AI enabled by default (Q_DISABLE_AI=1 to disable)
✅ Message persistence fixes (2048 token responses)
✅ Critical peer discovery bug fixes
Architecture:
Created DistributedAICoordinator (449 lines) in q-network crate
Integrated coordinator into API server AppState
Added distributed inference path in chat API
Gossipsub topics for node capability announcement
Layer capacity estimation (CPU/CUDA/Metal)
Statistics tracking and monitoring
Performance:
Single-node: 0.51 tok/s baseline (CPU)
Target distributed: 2.86 tok/s (5.6Χ speedup with 3 nodes)
Latency: 350-578ms per token (distributed mode)
Files Modified:
crates/q-network/src/distributed_ai_coordinator.rs (NEW - 449 lines)
crates/q-api-server/src/chat_api.rs (lines 427-586)
crates/q-api-server/src/main.rs (lines 855-869)
gui/quantum-wallet/src/components/AIChatScreen.tsx (lines 266-305)
gui/quantum-wallet/src/components/DownloadNodeScreen.tsx
Documentation:
HORIZONTAL_SCALING_COMPLETE.md
MESSAGE_PERSISTENCE_FIX.md
papers/distributed-ai-technical-review.pdf
v0.0.29-beta - High-Performance Mining Queue + Peer Count FixFeatures:
✅ High-performance mining queue implementation
✅ Fixed peer count tracking and display
✅ Improved network stability
✅ Enhanced frontend mining announcement
Performance:
Optimized mining queue for reduced latency
Better peer connection management
Improved network propagation
v0.0.27-beta - Revolutionary Time-Based HalvingMajor Changes:
✅ Time-based halving instead of block-based
✅ Complete documentation overhaul
✅ Improved tokenomics with predictable emission
✅ Enhanced frontend documentation pages
Halving Schedule:
Initial Reward: 50 QNK
Halving Period: Every epoch (time-based)
Predictable emission curve
Long-term sustainability model
v0.0.25-beta - Fast Block Production for DAG VisualizationFeatures:
✅ Phase 2 visualization enhancements
✅ Fast block production for exciting DAG display
✅ Real-time quantum state visualization
✅ Rainbow-box technique implementation
Visualization:
Interactive DAG graph with WebGL
Real-time vertex rendering
Quantum superposition visualization
Performance optimizations for large graphs
v0.0.19-beta - CRITICAL: Balance Bug FixedCritical Fix:
✅ Fixed balance calculation bug affecting wallet displays
✅ Corrected transaction history accuracy
✅ Resolved double-spending prevention edge case
Impact:
All wallet balances now accurate
Transaction history displays correctly
No funds lost (bug was display-only)
v0.0.15-beta - Mining Reward Data Loss FixCritical Fix:
✅ Fixed mining reward data loss on service restart
✅ Improved RocksDB persistence for mining rewards
✅ Enhanced wallet state recovery after crashes
Technical:
Added proper transaction flushing
Improved RocksDB write options
Better error handling in mining reward storage
v0.0.8-beta - Cross-Node Blockchain SynchronizationMajor Features:
✅ Full cross-node blockchain synchronization
✅ Automated peer discovery via Kademlia DHT
✅ Block propagation across network nodes
✅ Consensus state synchronization
P2P Networking:
libp2p integration complete
Gossipsub for efficient block propagation
mDNS for local peer discovery
QUIC transport for low latency
Kademlia DHT for distributed peer discovery
Synchronization:
Automatic blockchain sync on node startup
Block request/response protocol
Efficient state transfer between nodes
Conflict resolution via DAG-Knight consensus
v0.0.7-beta - Production Stability & Remote MiningFeatures:
✅ Production stability improvements
✅ Remote mining support
✅ Enhanced error handling
✅ Improved logging and diagnostics
Mining:
Remote miner connection support
Mining pool preparation (single-node only)
Better mining statistics
Reward distribution improvements
v0.0.5-beta - Performance Breakthrough ReleasePerformance Improvements:
✅ 10Χ consensus throughput increase
✅ Sub-50ms block finality
✅ Optimized DAG vertex processing
✅ Memory usage reduction
Benchmarks:
Consensus latency: <50ms (target met)
Transaction throughput: 100,000+ TPS
Memory footprint: Reduced by 40%
Network bandwidth: Optimized gossip protocol
v0.0.3-beta - Production ReleaseInitial Production Features:
✅ DAG-Knight consensus with quantum anchor election
✅ Narwhal mempool with reliable broadcast
✅ Phase 0 cryptography (Ed25519 + QUIC)
✅ REST API server with WebSocket streaming
✅ React-based web wallet interface
✅ Mining implementation with VDF-based PoW
Architecture:
Modular Rust workspace (7 crates)
libp2p P2P networking
RocksDB storage layer
Axum web framework
React + TypeScript frontend
🧬 QUANTUM CONSENSUS TECHNOLOGYQ-NarwhalKnight combines
DAG-Knight zero-message consensus with
Narwhal's reliable mempool for a revolutionary quantum-enhanced blockchain.
Core Components:1. DAG-Knight Consensus Zero-message BFT consensus (no leader election overhead)
Quantum-enhanced anchor election via VDF
Byzantine fault tolerance (f < n/3)
Deterministic finality in 2-3 rounds
2. Narwhal Mempool Reliable broadcast using Bracha's protocol
High-throughput transaction ordering
Parallel block production
Decoupled execution from consensus
3. Post-Quantum Cryptography
Phase 0: Ed25519 signatures + QUIC transport
Phase 1: Dilithium5 + Kyber1024 (crypto-agile framework)
Phase 2: QKD integration (planned)
Phase 3+: Full quantum resistance
4. Distributed AI Inference Horizontal scaling across network nodes
Mistral-7B-Instruct-v0.3 integration
Layer-parallel processing (32 layers)
Gossipsub coordination protocol
Performance Characteristics:
Throughput: 100,000+ TPS
Finality: <50ms (single-node), <2.9s (distributed with Tor)
Consensus Latency: 2-3 rounds
Byzantine Tolerance: f < n/3
AI Inference: 0.51 tok/s (single), 2.86 tok/s target (distributed)
📚 ACADEMIC FOUNDATIONQ-NarwhalKnight is built on peer-reviewed research and academic rigor:
Published Papers:
Distributed AI Technical Review - Horizontal scaling architecture
Quantum Aesthetics in Consensus Systems - Philosophical foundations
Privacy-as-a-Service Whitepaper - PaaS integration roadmap
Research Basis:
Narwhal and Tusk - Danezis et al. (2021)
DAG-Knight - Keidar et al. (2021)
NIST PQC Standards - Dilithium & Kyber
Bracha's Reliable Broadcast - Byzantine agreement
Code Quality: 2,500+ lines of distributed AI code
93% test coverage
Comprehensive benchmarking suite
Production-ready error handling
🚀 QUICKSTART GUIDE1. Download and Run Node:# Download binary
wget https://quillon.xyz/downloads/q-api-server-v0.1.9-beta
chmod +x q-api-server-v0.1.9-beta
# Run node (AI enabled by default)
./q-api-server-v0.1.9-beta --port 8080
# Access web wallet
xdg-open http://localhost:8080
2. Create Wallet:# Via web interface at http://localhost:8080
# Or via API:
curl -X POST http://localhost:8080/api/wallet/new \
-H "Content-Type: application/json" \
-d '{"password": "your_secure_password"}'
3. Start Mining:# Download miner
wget https://quillon.xyz/downloads/q-miner-linux-x64
chmod +x q-miner-linux-x64
# Start mining
./q-miner-linux-x64 --node http://localhost:8080 --wallet YOUR_ADDRESS
4. Use Distributed AI Chat:# Create distributed chat
curl -X POST http://localhost:8080/api/chat/new \
-H "Content-Type: application/json" \
-d '{
"user_id": "your_wallet_address",
"title": "Quantum Physics Discussion",
"distributed_enabled": true
}'
# Chat via web interface or API streaming endpoint
5. Connect to Testnet:# Bootstrap to testnet
./q-api-server-v0.1.9-beta --port 8080 \
--bootstrap-peer /ip4/TESTNET_IP/tcp/9001/p2p/PEER_ID
🔧 CONFIGURATION OPTIONSEnvironment Variables:# Database path
export Q_DB_PATH=./data
# P2P port
export Q_P2P_PORT=9001
# Disable AI inference (saves ~4GB RAM)
export Q_DISABLE_AI=1
# Node ID for multi-node setups
export Q_NODE_ID=node1
# Enable debug logging
export RUST_LOG=debug
Command-Line Flags:--port <PORT> HTTP API port (default: 8080)
--node-id <ID> Node identifier
--bootstrap-peer <ADDR> Bootstrap peer multiaddr
--db-path <PATH> Database directory
--p2p-port <PORT> P2P networking port
🛣️ ROADMAPPhase 2 (Current Development):✅ Distributed AI coordinator infrastructure
(COMPLETE)⏳ Layer assignment algorithm (in progress)
⏳ Layer output forwarding (in progress)
⏳ Full end-to-end distributed processing
📋 KV-cache coordination across nodes
📋 Coordinator election with democratic scoring
Phase 3 (Next Quarter):📋 Phase 2 post-quantum cryptography (QKD preparation)
📋 Tor integration with dedicated circuits (4 per validator)
📋 Dandelion++ gossip for traffic analysis resistance
📋 Production-ready distributed AI with fault tolerance
Phase 4 (Future):📋 Privacy-as-a-Service (PaaS) integration
📋 Smart contract VM with quantum resistance
📋 Decentralized exchange (DEX) with liquidity pools
📋 IPFS integration for decentralized storage
Phase 5 (Long-term Vision):📋 Full quantum computer integration
📋 Quantum random number generation (QRNG) via CHSH inequality
📋 Quantum key distribution (QKD) for transport security
📋 Post-quantum zero-knowledge proofs
💰 TOKENOMICSQUG Token Details:
Ticker Symbol: QUG (formerly QNK - legacy addresses still supported)
Initial Block Reward: 0.001 QUG (100,000 smallest units)
Decimals: 8 (100,000,000 satoshis per QUG, like Bitcoin)
Halving Schedule: Time-based (every epoch)
Total Supply: 21M QUG maximum
Mining Algorithm: VDF-based PoW with quantum anchor election
Consensus: DAG-Knight BFT (no leader election overhead)
Emission Curve:Epoch 0: 0.001 QUG per block
Epoch 1: 0.0005 QUG per block
Epoch 2: 0.00025 QUG per block
Epoch 3: 0.000125 QUG per block
...
Use Cases: Transaction fees (minimal, burned)
Mining rewards (decreasing emission)
AI inference payments (future)
Privacy service fees (PaaS - future)
Staking for consensus participation (future)
👥 COMMUNITY & SUPPORTLinks:
Website: https://quillon.xyz
GitHub: code.quillon.xyz
Documentation: technical-deepdive.quillon.xyz
Web Wallet: https://quillon.xyz
Block Explorer: Coming soon
Technical Support: Report issues on GitHub
Check documentation for common problems
Review release notes for known issues
Contributing:We welcome contributions! Check out our GitHub repository for:
Open issues and feature requests
Development guidelines
Testing procedures
Code review process
⚠️ IMPORTANT NOTESBeta Software Warning:This is
beta software under active development. While production-ready for testing, please be aware:
Use testnet for experiments
Mainnet Launch: Mid-December 2025 Regular updates with breaking changes possible
Backup your wallet keys regularly
System Requirements:
OS: Linux (x86_64), Windows support coming soon
RAM: 8GB minimum (16GB recommended for AI)
Storage: 10GB minimum (SSD recommended)
Network: Port 9001 open for P2P networking
Optional: CUDA/Metal GPU for distributed AI
Known Issues: Phase 2 distributed AI layer assignment not yet complete
Tor integration planned (not yet implemented)
Windows binaries require manual compilation
macOS support untested (should work via source)
🏆 TECHNICAL ACHIEVEMENTSQ-NarwhalKnight represents several blockchain firsts:
✅
First blockchain with horizontal AI scaling - Multi-node distributed inference
✅
DAG-Knight zero-message consensus - No leader election overhead
✅
Crypto-agile post-quantum framework - Phase-based transition model
✅
VDF-based quantum anchor election - Unpredictable, quantum-resistant randomness
✅
Narwhal reliable mempool - High-throughput parallel block production
✅
Sub-50ms finality - Industry-leading consensus latency
✅
100,000+ TPS - Scalable transaction processing
✅
Academic rigor - Built on peer-reviewed research
Join the Quantum Consensus Revolution!Download v0.1.9-beta TodayDOWNLOAD FOR LINUXThe future of blockchain is quantum-enhanced, AI-powered, and distributed.
Q-NarwhalKnight v0.1.9-beta
Released: October 29, 2025
License: Apache 2.0 / MIT
Built with Rust, libp2p, RocksDB, mistral.rs, React