{
  "markdown": "# Quantum Shield\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Rust](https://img.shields.io/badge/rust-1.75%2B-orange.svg)](https://www.rust-lang.org/)\n[![Solidity](https://img.shields.io/badge/solidity-0.8.24-blue.svg)](https://soliditylang.org/)\n[![Next.js](https://img.shields.io/badge/Next.js-15-black.svg)](https://nextjs.org/)\n\n> Post-quantum asset protection protocol for Ethereum using NIST-standardized cryptography\n\n## What is Quantum Shield?\n\nQuantum Shield protects smart contract assets against quantum computing threats using **NIST FIPS 204 (ML-DSA/Dilithium)** and **FIPS 205 (SLH-DSA/SPHINCS+)** dual post-quantum signatures, combined with a decentralized Prover Pool, VRF-based selection, and time-locked custody.\n\n### Key Features\n\n- **Dual PQC Signatures** — ML-DSA-65 + SLH-DSA for defense-in-depth\n- **Prover Pool** — Decentralized verification with stake-weighted selection via VRF\n- **Time-Locked Custody** — 24h normal unlock, 7-day emergency path with bond\n- **Observer Network** — Independent challenge system with quadratic slashing\n- **On-Chain Governance** — veQS token voting, security council, insurance fund\n- **11 Sub-Applications** — Consumer, Prover, Observer, Explorer, Enterprise, Governance, Admin\n\n## Architecture\n\n```\n┌─────────────────────────────────────────────────────────────────┐\n│  Frontend (Next.js 15)         11 apps, 136 routes, ja/en i18n │\n├─────────────────────────────────────────────────────────────────┤\n│  Backend API (Rust/Axum)       REST API, SIWE auth, Auto-Claim │\n├──────────────────┬──────────────────────────────────────────────┤\n│  L1: Sepolia     │  L3: Arbitrum Sepolia                       │\n│  • Vault         │  • CoreLayer    • Governor                  │\n│  • ProverRegistry│  • veQS         • RewardRouter              │\n│  • SPHINCS+ Vfy  │  • QSToken      • InsuranceFund             │\n└──────────────────┴──────────────────────────────────────────────┘\n```\n\n### 9 Core Sequences\n\n| # | Flow | Path |\n|---|------|------|\n| 1 | Consumer Lock | Frontend → API → DB → L1 Vault |\n| 2 | Normal Unlock | 24h timelock → Prover verification → L1 claim |\n| 3 | Emergency Unlock | Bond deposit → 7-day lock → Emergency path |\n| 4 | Prover Registration | Stake → VRF selection → Proof generation |\n| 5 | Observer Challenge | Monitor → Challenge → VRF arbitration |\n| 6 | Slashing | Quadratic penalty → L1 ProverRegistry |\n| 7 | Governance | veQS voting → Proposal execution on L3 |\n| 8 | Emergency Pause | Security council → L1 pause |\n| 9 | Token Hub | Stake QS → veQS → Rewards |\n\n## Tech Stack\n\n| Layer | Technology |\n|-------|------------|\n| Frontend | Next.js 15, TypeScript, Tailwind CSS, Wagmi, RainbowKit |\n| Backend | Rust, Axum, PostgreSQL, Redis, RabbitMQ |\n| Contracts | Solidity 0.8.24 (Foundry), deployed to Sepolia + Arbitrum Sepolia |\n| Cryptography | NIST FIPS 204 (ML-DSA-65), FIPS 205 (SLH-DSA), SHA3-256 |\n| SDK | WASM (Rust → wasm-pack), npm-publishable |\n| Testing | Playwright (E2E), Vitest, cargo test, Foundry forge test |\n\n## Deployed Contracts\n\n### L1: Ethereum Sepolia\n\n| Contract | Address |\n|----------|---------|\n| Vault | `0x07012aeF87C6E423c32F2f8eaF81762f63337260` |\n| ProverRegistry | `0x08e1fc1A0d614bc132B48950760c7A291cCB8946` |\n| SPHINCS+ Verifier | `0xD090b5A627d9bd6D96a8b5f6F504ebCa79980103` |\n\n### L3: Arbitrum Sepolia (12 contracts)\n\n| Contract | Address |\n|----------|---------|\n| CoreLayer | `0xb04F4DFe093dC80420117EDC8300f5EB6F6EDBf0` |\n| veQS | `0xE72dFa97C9E452dC0b8E6aa026c910D21B20fCAE` |\n| Governor | `0xe93b8129DC3dBD48E5d78C5A4C156DD1BFa8D65B` |\n| QSToken | `0xBD66beBE19E664dF143da54808d746192e4f2ee2` |\n\nAll L3 contracts verified on [Sourcify](https://sourcify.dev/).\n\n## Quick Start\n\n### Prerequisites\n\n- Docker & Docker Compose\n- Rust 1.75+ with cargo\n- Node.js 20+ with pnpm\n- Foundry (forge, anvil)\n\n### Development Setup\n\n```bash\n# 1. Start infrastructure\ndocker compose up -d postgres redis rabbitmq l3-node minio minio-init\n\n# 2. Run database migrations\ncd src/api/api\nDATABASE_URL=\"postgresql://quantum:quantum_dev@localhost:5432/quantum_shield\" sqlx migrate run\n\n# 3. Start backend API (port 8080)\ncargo run --bin api-server\n\n# 4. Start frontend (port 3000)\ncd src/frontend/web\npnpm install\npnpm dev\n```\n\n### Verify\n\n```bash\ncurl http://localhost:8080/v1/health\n# {\"status\":\"healthy\"}\n```\n\n## Project Structure\n\n```\nquantum-shield/\n├── src/\n│   ├── api/api/              # Rust/Axum backend\n│   │   ├── src/routes/       # API route handlers\n│   │   ├── src/services/     # Business logic\n│   │   ├── migrations/       # PostgreSQL migrations (17 files)\n│   │   └── config/           # YAML configuration\n│   ├── frontend/web/         # Next.js 15 frontend\n│   │   ├── src/app/          # App Router pages (11 apps)\n│   │   ├── src/components/   # 300+ React components\n│   │   ├── src/hooks/        # React Query hooks per app\n│   │   └── locales/          # ja/en translations\n│   ├── l1/contracts/         # L1 Solidity contracts (Foundry)\n│   ├── l3/                   # L3 governance contracts\n│   └── frontend/sdk/wasm/    # WASM SDK (Dilithium + SPHINCS+)\n├── docs/\n│   ├── core/SEQUENCES.md     # 9 core sequence specifications\n│   ├── ACTUAL_STATE.md       # Current implementation state\n│   └── pitch/                # Pitch deck, grant applications\n├── docker-compose.yml        # Development infrastructure\n└── .github/workflows/        # CI/CD pipelines\n```\n\n## Testing\n\n```bash\n# Backend\ncd src/api/api && cargo test\n\n# Frontend E2E\ncd src/frontend/web && npx playwright test\n\n# Smart Contracts\ncd src/l1/contracts && forge test\n```\n\n**Test Coverage**: 137 E2E tests passing, 107 integration tests, 0 failures.\n\n## Security\n\n- **Cryptography**: NIST FIPS 204 ML-DSA-65 + FIPS 205 SLH-DSA (post-quantum)\n- **Hashing**: SHA3-256 (no keccak256 in application layer)\n- **Authentication**: SIWE (Sign-In with Ethereum) + JWT\n- **Time Locks**: 24h normal, 7-day emergency with bond collateral\n- **Slashing**: Quadratic penalty for malicious provers\n\n### Audit Status\n\n- [x] Internal code review\n- [ ] External audit (planned)\n\n## License\n\nThis project is licensed under the MIT License. See [LICENSE](LICENSE) for details.\n\n---\n\n**Built for a post-quantum future.**\n",
  "bytes": 6244,
  "sha": "1d1cfa38d80b6661b92f48148b1d87e9d01ac863fcf2347a0a9bedd323552c72",
  "repo_slug": "kota1026/quantum-shield",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_kota1026_smartguard_mcp_0ef28d40/readme"
}