Skip to content

Latest commit

ย 

History

History

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

README.md

QNet - Experimental Quantum-Resistant Blockchain

License: MIT Rust Performance

QNet is an experimental blockchain platform focused on quantum-resistant cryptography, microblock architecture, and high-performance consensus mechanisms. This open-source research project explores next-generation distributed systems.

โš ๏ธ CRITICAL RISK DISCLAIMERS - READ BEFORE PARTICIPATING

๐Ÿšจ EXPERIMENTAL RESEARCH PROJECT - PARTICIPATE AT YOUR OWN RISK ๐Ÿšจ

FINANCIAL RISK WARNINGS

  • TOTAL LOSS RISK: You may lose ALL tokens, funds, or value associated with participation
  • NO INVESTMENT ADVICE: This project does NOT constitute investment advice or financial recommendations
  • NO RETURNS PROMISED: NO returns, profits, rewards, or positive outcomes are promised or guaranteed
  • EXPERIMENTAL TOKENS: All tokens are experimental research instruments with NO inherent value
  • REGULATORY RISK: Regulatory changes may impact or prohibit participation at any time
  • NETWORK FAILURE RISK: The entire network may cease operation, fail, or be compromised without notice

TECHNICAL RISK WARNINGS

  • ALPHA SOFTWARE: All software is in experimental/alpha stage and may contain critical bugs or security vulnerabilities
  • DATA LOSS: Wallets, keys, or data may be lost due to software bugs, network failures, or attacks
  • NETWORK INSTABILITY: The network may experience downtime, forks, rollbacks, or complete failure
  • SECURITY VULNERABILITIES: Despite our best efforts, the system may be hacked, exploited, or compromised
  • NO SUPPORT GUARANTEE: Limited or no technical support available for issues or problems

LEGAL AND REGULATORY WARNINGS

  • NO LEGAL ENTITY: Project operates without formal legal structure or corporate backing
  • REGULATORY UNCERTAINTY: Blockchain regulations vary by jurisdiction and may change unpredictably
  • COMPLIANCE RESPONSIBILITY: Participants are solely responsible for compliance with local laws
  • NO LEGAL RECOURSE: Limited or no legal recourse available for disputes, losses, or damages

DEVELOPMENT RISKS

  • AI-ASSISTED DEVELOPMENT: This project uses AI assistance which may introduce unforeseen bugs or vulnerabilities
  • EXPERIMENTAL FEATURES: Many features are experimental and may not work as intended
  • BREAKING CHANGES: Updates may introduce breaking changes requiring complete network resets
  • ABANDONMENT RISK: Development may be discontinued at any time without notice

BY PARTICIPATING YOU ACKNOWLEDGE:

  1. You have read, understood, and accept ALL risks outlined above
  2. You participate entirely at your own risk and responsibility
  3. You can afford to lose any and all value associated with participation
  4. You are responsible for compliance with all applicable laws in your jurisdiction
  5. You understand this is experimental research software, NOT a commercial product
  6. You understand that anything can happen including total network failure, hacks, or data loss
  7. You acknowledge that we (developers and AI) are doing our maximum effort to prevent issues but cannot guarantee anything

โš ๏ธ IF YOU DO NOT ACCEPT THESE RISKS, DO NOT PARTICIPATE IN THIS PROJECT โš ๏ธ


๐Ÿš€ Quick Start

Three-Layer Architecture

1. $1DEV Fun Token (Solana)

Purpose: Fun memecoin for experimental network testing via pump.fun mechanism
Requirement: Variable $1DEV tokens burned based on node type

# Dynamic pricing based on network burn progress (exponential decay curve)
Light Node:  1,500-300 $1DEV burned (decreases as total network burn % increases)
Full Node:   1,500-300 $1DEV burned (decreases as total network burn % increases)  
Super Node:  1,500-300 $1DEV burned (decreases as total network burn % increases)

# Price reduction mechanism:
# 0% burned: 1,500 $1DEV per node
# 50% burned: ~750 $1DEV per node  
# 80-90% burned: 300 $1DEV per node (minimum Phase 1 price)
# At 90% burned or 5 years: Transition to Phase 2 (QNC activation)

2. QNet Blockchain (Native)

Performance: 424,411 TPS achieved (verified June 2025) โšก
Architecture: Microblock + Macroblock hybrid

Microblocks: 1 second intervals
Macroblocks: 90 second intervals (90 microblocks)

3. QNC Native Token (Post-Transition)

Mechanism: QNC payment to Pool #3 (no burning, redistributed to all active nodes)
Transition: At 90% $1DEV burned OR 5 years from first block creation

# Phase 2: Dynamic QNC pricing based on network size
Light Node:  2,500-15,000 QNC (base: 5,000 QNC)
Full Node:   3,750-22,500 QNC (base: 7,500 QNC)  
Super Node:  5,000-30,000 QNC (base: 10,000 QNC)

# Network size multipliers:
# 0-100K nodes: 0.5x (early network discount)
# 100K-300K nodes: 1.0x (standard pricing)  
# 300K-1M nodes: 2.0x (high demand)
# 1M+ nodes: 3.0x (mature network premium)

# ALL activation fees โ†’ Pool #3 โ†’ Equal distribution to ALL active nodes

๐Ÿ”ง Installation & Setup

Prerequisites

# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Install dependencies
sudo apt update && sudo apt install -y build-essential pkg-config libssl-dev

Build QNet Node

git clone https://github.com/qnet-project/qnet
cd qnet
cargo build --release

Start Node

# Production node with microblocks
./target/release/qnet-node \
    --type full \
    --region europe \
    --producer \
    --data-dir ./node_data \
    --p2p-port 30303 \
    --rpc-port 8545

# Monitor performance
curl http://localhost:8545/api/v1/metrics

๐Ÿ—๏ธ Technical Architecture

Microblock System

โ”Œโ”€ ฮผBlock(1s) โ”€ ฮผBlock(1s) โ”€ ฮผBlock(1s) โ”€ ... โ”€ ฮผBlock(1s) โ”€โ”
โ”‚                                                           โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ MacroBlock(90s) โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

Features:

  • Sub-second finality for small transactions
  • Adaptive batch processing up to 50k transactions
  • Regional P2P clustering for optimal routing
  • Post-quantum cryptography (Dilithium + Kyber)

Node Types & Capabilities

Type Access Cost Capabilities Storage Performance
Light 1,500-300 $1DEV Basic validation, mobile-optimized ~100MB (headers only) 8,859 TPS mobile
Full 1,500-300 $1DEV Complete validation, 30-day history ~500GB (pruned) 424,411 TPS blockchain
Super 1,500-300 $1DEV Priority validation, full archive ~2TB (no pruning) 424,411 TPS blockchain

Note (v2.19.10): Sharding is for parallel TX processing, NOT storage partitioning. All nodes receive all blocks; storage differs by tier.

Performance Metrics

  • โœ… 424,411 TPS achieved (verified June 2025) โšก
  • โœ… 8,859 TPS mobile crypto performance (88x faster than Bitcoin) ๐Ÿ“ฑ
  • โœ… 100% integration test success rate (50/50 cross-shard, 100/100 intra-shard)
  • โœ… Sub-second block creation latency (0.04ms cross-shard, 0.10ms intra-shard)
  • โœ… Post-quantum cryptography (3.76ms key generation, 0.12ms verification)
  • โœ… Regional clustering for global scalability

๐Ÿ” Quantum-Resistant Security

Post-Quantum Algorithms

// Signature scheme
Dilithium3 (NIST standard)

// Key encapsulation  
Kyber1024 (high security)

// Hash function
SHA3-256 (quantum-resistant)

Security Features

  • Quantum-safe signatures for all transactions
  • Hybrid cryptography during transition period
  • Hardware security module integration ready
  • Key rotation mechanisms implemented

๐Ÿ“ฑ Mobile Architecture & Performance

Mobile-First Design

QNet is optimized for mobile devices with exceptional performance:

Mobile Layer Performance:
- Transaction Processing: 8,859 TPS (88x faster than Bitcoin)
- Battery Usage: <0.01% per transaction
- Memory Footprint: <50MB
- Launch Time: <2 seconds
- Network Efficiency: 99.8% uptime

Mobile vs Traditional Blockchain Comparison

Blockchain Mobile TPS Battery Impact Memory Usage
Bitcoin ~100 TPS High (mining) N/A
Ethereum ~200 TPS High (mining) N/A
Solana Limited Medium High
QNet Mobile 8,859 TPS <0.01% <50MB

Mobile Architecture Benefits

  • No Mining: Simple ping responses every 4 hours
  • Quantum-Resistant: Post-quantum cryptography on mobile
  • Battery Optimized: Minimal power consumption
  • Hardware Security: Device keystore integration
  • Offline Capable: Transaction preparation without network

๐ŸŒ Network Access & Node Activation

Phase 1: $1DEV Access (Current)

// Burn $1DEV tokens on Solana for network access
const burnAmount = calculateBurnAmount(nodeType, totalBurnedPercent);
// All node types: 1500-300 $1DEV (decreases as network burn progress increases)
await burnTokensOnSolana(burnAmount, nodeType);

Phase 2: QNC Native (Future)

// Simple QNC spending to Pool 3 (no burning)
let required_balance = match node_type {
    NodeType::Light => 5_000,
    NodeType::Full => 7_500,
    NodeType::Super => 10_000,
};

Transition Triggers:

  • 90% of $1DEV supply burned
  • OR 5 years from first block creation

๐Ÿ“Š Development Status

โœ… Completed Features

  • Core blockchain implementation (Rust)
  • Microblock architecture with 1s/90s timing
  • P2P network with regional clustering
  • Post-quantum cryptography integration
  • RPC API and monitoring tools
  • Performance testing completed (424,411 TPS achieved)

๐Ÿ”„ Active Development

  • Solana bridge for $1DEV burn verification
  • Node activation automation
  • Cross-shard transaction processing
  • Web explorer and wallet interfaces

๐Ÿ“‹ Research Pipeline

  • Smart contract virtual machine
  • Cross-chain bridge protocols
  • Mobile SDK development
  • Academic research collaboration

๐Ÿ› ๏ธ Developer Resources

API Examples

# Node status
curl http://localhost:8545/api/v1/status

# Network metrics
curl http://localhost:8545/api/v1/metrics

# Block information
curl http://localhost:8545/api/v1/blocks/latest

# Transaction pool
curl http://localhost:8545/api/v1/mempool

Configuration

# qnet.toml
[network]
microblock_interval = 1    # seconds
macroblock_interval = 90   # seconds
target_tps = 100000

[node]
type = "full"
region = "europe"
enable_producer = true

[consensus]
commit_timeout = 30
reveal_timeout = 30
enable_adaptive_timing = true

๐Ÿ”ฌ Research Contributions

Academic Value

  • Novel microblock architecture research
  • Post-quantum blockchain implementation study
  • Adaptive consensus timing algorithm development
  • Regional P2P clustering performance analysis

Open Source Impact

  • MIT License for maximum accessibility
  • Modular architecture for component reuse
  • Comprehensive documentation and examples
  • Research paper collaboration opportunities

โš ๏ธ Risk Disclosures

Experimental Technology

  • Cutting-edge cryptography implementations may have unknown vulnerabilities
  • Novel consensus mechanisms are under active testing and may fail
  • Network effects depend on research participation and may not materialize
  • Beta software with potential critical bugs that could cause total loss

Technical Limitations

  • Smart contracts not yet implemented and may never be completed
  • Cross-chain bridges are highly experimental and may fail or be exploited
  • Post-quantum algorithms are still evolving and may become obsolete
  • Network upgrades may require complete resyncing or data loss

Regulatory Considerations

  • Research and experimental use focus only - not a commercial product
  • No investment advice, promises, or guarantees of any kind
  • Open source development model with no corporate backing
  • Compliance varies by jurisdiction and participants are solely responsible

Development Risks

  • AI-assisted development may introduce unforeseen bugs or security issues
  • Human oversight cannot catch all potential problems
  • Experimental features may not work as intended or may be abandoned
  • Project may be discontinued at any time without notice

๐Ÿ“ˆ Performance Benchmarks

Latest Test Results

Test: Verified Performance Assessment
Date: June 2025
Blockchain Performance: 424,411 TPS achieved (maximum burst)
Mobile Performance: 8,859 TPS (88x faster than Bitcoin)
Single Thread: 282,337 TPS
Multi-Process: 334,218 TPS
Cross-shard: 50/50 success (100%), 0.04ms latency
Intra-shard: 100/100 success (100%), 0.10ms latency
Post-quantum: 3.76ms key gen, 0.12ms verification
Memory usage: Optimized for production deployment
Mobile battery: <0.01% usage per transaction

Comparison Metrics

  • Bitcoin: ~7 TPS
  • Ethereum: ~15 TPS
  • Solana: ~65k TPS (theoretical)
  • QNet Blockchain: 424,411 TPS (achieved) โšก
  • QNet Mobile: 8,859 TPS (88x faster than Bitcoin) ๐Ÿ“ฑ

๐Ÿค Community & Contribution

Getting Involved

  1. Researchers: Contribute to architecture and analysis
  2. Developers: Build tools and applications
  3. Node Operators: Participate in network consensus
  4. Community: Test, document, and provide feedback

Development Workflow

# Fork repository
git clone https://github.com/your-username/qnet

# Create feature branch
git checkout -b feature/your-improvement

# Run tests
cargo test

# Submit pull request

Support Channels

  • GitHub Issues: Bug reports and feature requests
  • Documentation: Comprehensive guides and API docs
  • Research Papers: Academic collaboration
  • Developer Tools: SDKs and testing frameworks

๐Ÿ“‹ Roadmap

โœ… H1 2025: Foundation & Integration (COMPLETED)

  • Core blockchain with microblocks (Q1)
  • Post-quantum cryptography (Q1)
  • Regional P2P architecture (Q1)
  • Solana bridge completion (Q2)
  • Node activation automation (Q2)
  • Web explorer launch (Q2)
  • Multi-language wallet (11 languages: English, Spanish, French, German, Italian, Portuguese, Turkish, Korean, Japanese, Chinese, Hindi)
  • 424,411 TPS performance achievement
  • Enterprise security audit

๐Ÿš€ Q3 2025: Smart Contract Platform (CURRENT)

  • WebAssembly VM deployment (July)
  • Smart contract development tools (August)
  • DeFi protocol suite launch (September)
  • Cross-chain bridge protocols
  • Developer ecosystem expansion

๐ŸŒ Q4 2025: Global Scale

  • Governance implementation
  • Mobile native applications
  • Enterprise partnerships
  • 1M+ node network target
  • Academic research publications

๐Ÿ”ฎ 2026: Mainstream Adoption

  • Layer 2 scaling solutions
  • Quantum computing integration
  • Global regulatory compliance
  • Enterprise blockchain services

๐Ÿ“„ Documentation

Resource Description
Technical Guide Complete technical documentation
API Reference RPC and REST API documentation
Architecture System design and implementation
Performance Benchmarks and optimization
Security Security analysis and audits

๐Ÿ“œ License

This project is licensed under the MIT License - see the LICENSE file for details.

๐Ÿ”— Links


โš ๏ธ FINAL DISCLAIMER

QNet is an EXPERIMENTAL blockchain research project developed by independent researchers with AI assistance. This project:

  • IS NOT a commercial product, investment opportunity, or financial service
  • IS NOT backed by any corporation, foundation, or legal entity
  • PROVIDES NO guarantees, warranties, or promises of any kind
  • MAY FAIL completely without notice or compensation
  • INVOLVES SIGNIFICANT technical, financial, and regulatory risks
  • USES AI ASSISTANCE which may introduce unforeseen bugs or vulnerabilities
  • IS EXPERIMENTAL software that may contain critical security flaws

WE (HUMAN DEVELOPERS AND AI) ARE DOING OUR MAXIMUM EFFORT TO:

  • Prevent bugs, vulnerabilities, and network failures
  • Implement robust security measures and testing
  • Provide comprehensive documentation and warnings
  • Consider all possible failure scenarios and edge cases
  • Build a reliable and secure experimental platform

HOWEVER, WE CANNOT GUARANTEE ANYTHING. PARTICIPATION IS ENTIRELY AT YOUR OWN RISK.

DO NOT PARTICIPATE WITH FUNDS YOU CANNOT AFFORD TO LOSE.

This is experimental research software for educational purposes only. Not financial advice.