# Welcome to QuantumWing

## Overview

**QuantumWing** is a production-ready quantum-safe blockchain featuring true three-layer architecture (Execution/Beacon/Validator), EVM-compatible addresses, and post-quantum cryptography throughout.

{% hint style="success" %}
Core is quantum‑safe today (Dilithium + Kyber). Transparent ZK is our path for private transactions, constant‑time verification and trust‑minimized cross‑chain.
{% endhint %}

### 🔒 Cross‑Chain Protection (At a Glance)

* **Quantum‑safe custody**: 7-of-10 Dilithium Mode 3 committee, automatic timelocks (40s testnet production)
* **ZK‑STARK proofs**: Operational - validates 7 PQC attestations with single proof (9900 bytes)
* **Automated bridge**: PENDING → ATTESTED → PROVEN → READY → REDEEMED (fully automatic)
* **QWETH token**: Production contract deployed - Sepolia ETH → QuantumWing QWETH
* Status: **FULLY OPERATIONAL** ✅ - End-to-end bridge working with automatic redemption

### 🧪 Transparent ZK Roadmap (TL;DR)

* Private transactions (shielded\_pool): Merkle + nullifiers + ZK proof
* Aggregation/PCD: per‑epoch proof = constant‑time on‑chain verification + fast sync
* Cross‑chain verify: ZK light clients for remote headers and event inclusion
* Hardening: determinism, DOS limits, fee model, audits (PQ‑friendly parameters)
* Details → [ZK Production Plan](https://quantumwing.gitbook.io/quantumwing/roadmap/zk-production)

### 🔗 Quick Links

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>🔧 Quantum-Safe Bridge</strong></td><td>PRODUCTION READY - ZK-STARK proofs, timelock automation, QWETH minting operational</td><td><a href="../advanced-features/bridge">bridge</a></td></tr><tr><td><strong>Cross‑Chain Roadmap</strong></td><td>Ethereum, Bitcoin, Solana integration roadmap</td><td><a href="../roadmap/cross-chain-assets">cross-chain-assets</a></td></tr><tr><td><strong>ZK Production Plan</strong></td><td>Transparent, PQ‑friendly ZK with aggregation/PCD</td><td><a href="../roadmap/zk-production">zk-production</a></td></tr><tr><td><strong>Encrypted P2P (Kyber)</strong></td><td>Post‑quantum E2E messaging over libp2p</td><td><a href="../cryptography/kyber">kyber</a></td></tr></tbody></table>

### 🎯 Key Features

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>🔐 Quantum-Safe</strong></td><td>Dilithium Mode 3 signatures (NIST-approved post-quantum)</td><td></td></tr><tr><td><strong>🏗️ Three-Layer Architecture</strong></td><td>Ethereum 2.0-style separation: Execution/Beacon/Validator</td><td></td></tr><tr><td><strong>🎲 Proof of Randomness</strong></td><td>VRF + RANDAO consensus with verifiable randomness</td><td></td></tr><tr><td><strong>🤖 QWVM Smart Contracts</strong></td><td>WebAssembly contracts with quantum-safe host functions</td><td></td></tr><tr><td><strong>📍 EVM-Compatible</strong></td><td>0x addresses derived from quantum-safe Dilithium keys</td><td></td></tr><tr><td><strong>🌐 Production P2P</strong></td><td>libp2p, GossipSub, DHT, and mDNS peer discovery</td><td></td></tr></tbody></table>

### ⚡ Quick Stats

| Metric                   | Value                         |
| ------------------------ | ----------------------------- |
| **Production Readiness** | 92/100 ✅                      |
| **Block Time**           | 12 seconds                    |
| **Finality**             | \~12.8 minutes                |
| **Max Throughput**       | 2000+ TPS                     |
| **Signature Size**       | 3293 bytes (Dilithium Mode 3) |
| **Security Level**       | 192-bit (NIST Level 3)        |
| **Bridge Status**        | Fully Operational 🌉          |

## Getting Started

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>🚀 Quick Start</strong></td><td>Get QuantumWing running in 5 minutes</td><td><a href="../getting-started/quick-start">quick-start</a></td></tr><tr><td><strong>📦 Installation</strong></td><td>Build from source and setup validators</td><td><a href="../getting-started/installation">installation</a></td></tr><tr><td><strong>🏗️ Architecture</strong></td><td>Understand the three-layer design</td><td><a href="../architecture/overview">overview</a></td></tr></tbody></table>

## Core Components

### Architecture

Learn about QuantumWing's unique three-layer architecture and how it achieves quantum safety while maintaining high performance.

{% content-ref url="../architecture/overview" %}
[overview](https://quantumwing.gitbook.io/quantumwing/architecture/overview)
{% endcontent-ref %}

### Consensus

Understand Proof of Randomness (PoR) consensus mechanism with VRF validator selection and RANDAO commit-reveal.

{% content-ref url="../consensus/proof-of-randomness" %}
[proof-of-randomness](https://quantumwing.gitbook.io/quantumwing/consensus/proof-of-randomness)
{% endcontent-ref %}

### Cryptography

Deep dive into post-quantum cryptography: Dilithium Mode 3 signatures and SHA3-256 hashing.

{% content-ref url="../cryptography/quantum-safe-crypto" %}
[quantum-safe-crypto](https://quantumwing.gitbook.io/quantumwing/cryptography/quantum-safe-crypto)
{% endcontent-ref %}

## Advanced Features

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>🤖 QWVM</strong></td><td>WebAssembly smart contracts</td><td><a href="../smart-contracts/qwvm">qwvm</a></td></tr><tr><td><strong>🔐 ZK-STARK Proofs</strong></td><td>Production-ready - Validates 7 PQC attestations (9900-byte proofs)</td><td><a href="../advanced-features/zk-proofs">zk-proofs</a></td></tr><tr><td><strong>📊 Monitoring</strong></td><td>Prometheus + Grafana dashboards</td><td><a href="../operations/monitoring">monitoring</a></td></tr><tr><td><strong>💰 Economics</strong></td><td>Slashing, rewards, validator incentives</td><td><a href="https://github.com/dolfrin/QuantumWing/blob/master/docs/economics/overview.md">https://github.com/dolfrin/QuantumWing/blob/master/docs/economics/overview.md</a></td></tr></tbody></table>

## API & Development

{% content-ref url="../api-reference/json-rpc-api" %}
[json-rpc-api](https://quantumwing.gitbook.io/quantumwing/api-reference/json-rpc-api)
{% endcontent-ref %}

{% content-ref url="<https://github.com/dolfrin/QuantumWing/blob/master/docs/api-reference/rest-api.md>" %}
<https://github.com/dolfrin/QuantumWing/blob/master/docs/api-reference/rest-api.md>
{% endcontent-ref %}

{% content-ref url="<https://github.com/dolfrin/QuantumWing/blob/master/docs/development/building-from-source.md>" %}
<https://github.com/dolfrin/QuantumWing/blob/master/docs/development/building-from-source.md>
{% endcontent-ref %}

## Community & Support

* 🌐 **Website**: [quantumwing.io](https://quantumwing.io)
* 💬 **Discord**: [Join our community](https://discord.gg/WJu7tsS8W4)
* 🐦 **Twitter**: [@QuantumWingIO](https://x.com/quantumwingio)
* 📧 **Email**: <dolfrin@gmail.com>
* 🐛 **GitHub Issues**: [Report bugs](https://github.com/quantumwing/protocol/issues)

## License

QuantumWing is open-source software licensed under the **Apache License 2.0**.

***

**Version**: 1.0.0 | **Last Updated**: November 19, 2025 | **Status**: Production Ready (92/100)