A post-quantum secure, sharded blockchain with multi-VM support.

QSN will become open source after mainnet launch.

Currently, this documentation describes how to USE the network. Detailed implementation documentation and full source code will be publicly available after mainnet is live and stable.

After open source release:

• Full source code on GitHub
• Detailed technical specifications
• Implementation guides
• Contribution guidelines

QSN is a production-grade blockchain implementing:

• Hybrid Post-Quantum Cryptography - Ed25519 + Dilithium3 (NIST Level 3)
• Multi-VM Architecture - EVM, TVM, and QVM support
• Dynamic Sharding - Automatic shard split/merge based on load
• BFT Consensus - Tendermint-style with Proof of Stake
• Cross-Shard Transactions - Atomic 2PC protocol with Merkle proofs

┌─────────────────────────────────────────────────────────────┐
│                      Masterchain (-1)                        │
│              Coordinates all workchains                      │
└─────────────────────────────────────────────────────────────┘
        │                    │                    │
        ▼                    ▼                    ▼
┌───────────────┐  ┌───────────────┐  ┌───────────────┐
│  Workchain 0  │  │  Workchain 1  │  │  Workchain 2  │
│     (EVM)     │  │     (TVM)     │  │     (QVM)     │
└───────────────┘  └───────────────┘  └───────────────┘
        │                    │                    │
   ┌────┴────┐          ┌────┴────┐          ┌────┴────┐
   │ Shards  │          │ Shards  │          │ Shards  │
   └─────────┘          └─────────┘          └─────────┘

• Signatures: Dilithium3 (NIST standard) for all validator operations
• Key Encapsulation: Kyber1024 for secure key exchange
• Hash Functions: BLAKE3 for block hashing, Keccak256 for Merkle trees

• Type: Byzantine Fault Tolerant (BFT) with Proof of Stake
• Finality: 2/3+ validator threshold
• Block Time: 3 seconds
• Slashing: Stake confiscation for double-voting

• QVM: Native quantum-resistant VM with DeFi opcodes
• EVM: Full Ethereum compatibility
• TVM: TON Virtual Machine support

• Dynamic Split/Merge: Based on TPS and state size
• Cross-Shard: Atomic transactions with 2PC protocol
• Scalability: Linear scaling with shard count

# Initialize blockchain
./qsn init --network pyuniq --validators 3

# Start node
./qsn node --network pyuniq --validator ./keys/validator_0.json

# Check status
./qsn status --network pyuniq

# Create new wallet
./qsn wallet create --name "my-wallet"

# Check balance
./qsn balance <address> --network pyuniq

# Request testnet tokens
./qsn faucet <address> --network pyuniq

# Compile contract
./qsn compile qubit ./contracts/token.q -o token.qbin

# Deploy
./qsn deploy --bytecode token.qbin --from <address> --network pyuniq

• Testnet RPC: http://localhost:9545
• Testnet WebSocket: ws://localhost:9546
• QVM Server: http://localhost:7777

• eth_* - Full Ethereum JSON-RPC compatibility
• qsn_* - QSN-specific methods (validators, staking, tokens)
• qvm_* - QVM execution and DeFi operations
• tvm_* - TON VM compatibility layer

• Architecture - System design overview
• Consensus - BFT + Proof of Stake
• Sharding Design - Sharding system
• Cryptography - Post-quantum cryptography

• VM Overview - EVM, TVM, QVM details
• QVM Documentation - Quantum VM reference

• Staking - Staking and delegation
• Bridges - Cross-chain bridges
• MEV Protection - MEV mitigation
• Mempool - Transaction pool
• Account Abstraction - Smart wallets

• P2P Network - Peer-to-peer networking
• Sync Protocol - Block synchronization
• State Management - State and storage

• Execution Engine - Transaction processing
• Validation - Transaction validation

• CLI Reference - Command-line interface
• RPC Methods - Complete API reference
• Wallet System - Wallet management
• Genesis Config - Network initialization

• Getting Started - Quick start guide
• Faucet API - Request test tokens
• Node Setup - Run your own node

• Explorer Demo - Block explorer
• Wallet Demo - Wallet application

Proprietary - Will be released under MIT License after mainnet launch.

• Testnet Explorer: Coming soon
• Documentation: This repository