> For the complete documentation index, see [llms.txt](https://quantumwing.gitbook.io/quantumwing/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://quantumwing.gitbook.io/quantumwing/welcome/readme.md).

# 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](/quantumwing/roadmap/zk-production.md)

### 🔗 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="/pages/hcu5aUWzuljHFqpKRIhQ">/pages/hcu5aUWzuljHFqpKRIhQ</a></td></tr><tr><td><strong>Cross‑Chain Roadmap</strong></td><td>Ethereum, Bitcoin, Solana integration roadmap</td><td><a href="/pages/fS6Wop5Xk5vqk815NS2c">/pages/fS6Wop5Xk5vqk815NS2c</a></td></tr><tr><td><strong>ZK Production Plan</strong></td><td>Transparent, PQ‑friendly ZK with aggregation/PCD</td><td><a href="/pages/du46M1ACgkFcaWPwN37O">/pages/du46M1ACgkFcaWPwN37O</a></td></tr><tr><td><strong>Encrypted P2P (Kyber)</strong></td><td>Post‑quantum E2E messaging over libp2p</td><td><a href="/pages/PxIz714GHGCVwcrJRCxf">/pages/PxIz714GHGCVwcrJRCxf</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="/pages/nbgcG4ghloJO9CLV56Us">/pages/nbgcG4ghloJO9CLV56Us</a></td></tr><tr><td><strong>📦 Installation</strong></td><td>Build from source and setup validators</td><td><a href="/pages/7P1DWKsCnexUueGqV0fQ">/pages/7P1DWKsCnexUueGqV0fQ</a></td></tr><tr><td><strong>🏗️ Architecture</strong></td><td>Understand the three-layer design</td><td><a href="/pages/lbe9fJ5PcNQ9RljzLXkZ">/pages/lbe9fJ5PcNQ9RljzLXkZ</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="/pages/lbe9fJ5PcNQ9RljzLXkZ" %}
[Overview](/quantumwing/architecture/overview.md)
{% endcontent-ref %}

### Consensus

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

{% content-ref url="/pages/LGCDzerkssgvFDk4dmZa" %}
[Proof of Randomness](/quantumwing/consensus/proof-of-randomness.md)
{% endcontent-ref %}

### Cryptography

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

{% content-ref url="/pages/dYxRLHnc0RdcW8p7SxYW" %}
[Quantum-Safe Crypto](/quantumwing/cryptography/quantum-safe-crypto.md)
{% 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="/pages/UTI93XVVlCZ6mzNLuNtP">/pages/UTI93XVVlCZ6mzNLuNtP</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="/pages/VQKuIyOn3DF9ZaXI681I">/pages/VQKuIyOn3DF9ZaXI681I</a></td></tr><tr><td><strong>📊 Monitoring</strong></td><td>Prometheus + Grafana dashboards</td><td><a href="/pages/CbKayKKGYxM47YPxz61d">/pages/CbKayKKGYxM47YPxz61d</a></td></tr><tr><td><strong>💰 Economics</strong></td><td>Slashing, rewards, validator incentives</td><td><a href="/pages/N4sJze6hEgszNmK92KFh">/pages/N4sJze6hEgszNmK92KFh</a></td></tr></tbody></table>

## API & Development

{% content-ref url="/pages/E3Q5ymv0VL6ngkCfCtJc" %}
[JSON-RPC API](/quantumwing/api-reference/json-rpc-api.md)
{% endcontent-ref %}

{% content-ref url="/pages/9Nik013DBcSTJj5cLSO1" %}
[REST API - Execution](/quantumwing/api-reference/rest-execution.md)
{% endcontent-ref %}

{% content-ref url="/pages/5jQr6x7bCeIqqrLnRxod" %}
[REST API - Beacon](/quantumwing/api-reference/rest-beacon.md)
{% endcontent-ref %}

{% content-ref url="/pages/4s7FnodZOz8sLgRG2jk6" %}
[Building from Source](/quantumwing/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**: June 2026 | **Status**: Pre-launch (35/50 line items shipped)

**📰 What's new**: see [What's New (April 2026)](/quantumwing/welcome/whats-new.md) for the 30-commit delta — EIP-1559, fork choice, real MPT state, RFC 9381 ECVRF, deterministic WASM gas metering, bridge dispute resolution, light client, mobile wallet, WalletConnect, EIP-712, ERC-4337, full DeFi primitive stack (oracle, DEX, stablecoin, governance), production ops bundle, slashing dashboard, DNS discovery, and more. Native token rebranded **ETH placeholder → QWING**.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://quantumwing.gitbook.io/quantumwing/welcome/readme.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.