Skip to main content

Repository Map

All Quantus Network source code lives in the Quantus-Network GitHub organization. This page catalogs every repository, organized by function.

Each repo links to GitHub and DeepWiki (AI-generated documentation for deeper code exploration).

Core Protocol

The two main repositories containing the blockchain node and ZK proof system.

RepositoryLanguageDescription
chain · DeepWikiRustMain blockchain node. Substrate-based with QPoW consensus, all pallets (wormhole, reversible transfers, multisig, governance, treasury), and mining infrastructure.
qp-zk-circuits · DeepWikiRustZero-knowledge proof circuits built on Plonky2. Contains the wormhole circuit (prover, verifier, aggregator), voting circuit, and shared ZK gadgets.

Cryptographic Libraries

Purpose-built or forked cryptographic implementations.

RepositoryLanguageDescription
qp-rusty-crystals · DeepWikiRustML-DSA-87 (Dilithium) implementation. Pure-Rust, no-std, constant-time. Includes HD-Lattice wallet derivation. Audited by Neodyme.
qp-poseidon · DeepWikiRustPoseidon2 hash function. Used for block headers, storage hashing, QPoW mining, and ZK circuits.
qp-poseidon-constants · DeepWikiRustPrecomputed Poseidon2 constants for the Goldilocks field.
qp-plonky2 · DeepWikiRustQuantus fork of Polygon Zero's Plonky2 proof system. STARK-based, no trusted setup.
qp-human-checkphrase · DeepWikiPythonHuman-readable BIP-39 address checksums ("check-phrases").

Post-Quantum Networking

Forked networking libraries with classical crypto replaced by PQC primitives.

RepositoryLanguageDescription
qp-libp2p-identity · DeepWikiRustPQ fork of rust-libp2p-identity. Dilithium-based peer identity.
qp-libp2p-noise · DeepWikiRustPQ fork of rust-libp2p-noise. ML-KEM-768 + ML-DSA-87 for P2P channel encryption.
sc-network-pqc · DeepWikiRustPQ fork of Substrate's sc-network.

Client Applications

User-facing software for interacting with the network.

RepositoryLanguageDescription
quantus-cli · DeepWikiRustCommand-line client for Quantus Network.
quantus-apps · DeepWikiDartMobile and desktop wallet application (Flutter).
quantus-miner · DeepWikiRustExternal mining software (CPU/GPU).
miner-tauri-gui · DeepWikiRustDesktop mining GUI built with Tauri.
quantus_ur · DeepWikiRustUR QR code implementation for hardware wallet communication.

Infrastructure

Operations, monitoring, and data indexing.

RepositoryLanguageDescription
explorer · DeepWikiTypeScriptCustom block explorer built on Subsquid.
monitoring · DeepWikiShellNetwork monitoring scripts and configurations.
chain-telemetry · DeepWikiRustTelemetry service for chain metrics.
n8n-workflows · DeepWiki--n8n automation workflows.

NEAR Integration

Cross-chain bridge infrastructure using NEAR's chain abstraction.

RepositoryLanguageDescription
near-mpc · DeepWikiRustMPC node for secure multi-party threshold signature generation. Under audit by Hashcloak.
nearcore · DeepWikiRustFork of NEAR Protocol reference client.

SDK and API Clients

Libraries for building on Quantus.

RepositoryLanguageDescription
quantus-api-client · DeepWikiRustSubstrate API client over WebSockets.
polkadart · DeepWikiDartFork of Polkadart -- Dart/Flutter SDK for Polkadot-compatible chains.
polkadot-js-api · DeepWikiTypeScriptFork of Polkadot JS API.

State and Storage

ZK-compatible state management.

RepositoryLanguageDescription
zk-trie · DeepWikiRustZK-friendly Substrate Patricia Merkle Trie. Uses Poseidon hashing for ZK-compatible state proofs.
zk-state-machine · DeepWikiRustFork of Substrate sp-state-machine adapted for zk-trie.

Data Indexing

Forked indexing frameworks for the block explorer.

RepositoryLanguageDescription
squid-sdk · DeepWikiTypeScriptFork of Subsquid SDK. Powers the explorer.
subql · DeepWikiTypeScriptFork of SubQuery indexing framework.

Content and Public-Facing

Websites, documentation, and research.

RepositoryLanguageDescription
website · DeepWikiMDXquantus.com main website.
whitepaper · DeepWiki--White paper versioning.
qsafe.af · DeepWikiTypeScriptqsafe.af -- quantum safety awareness site.
report-card · DeepWikiAstroQuantum Security Report Card -- rates other chains' quantum readiness.
privacy-score · DeepWikiTypeScriptPrivacy scoring tool for blockchain protocols.

Governance and Standards

RepositoryLanguageDescription
improvement-proposals · DeepWiki--Quantus Improvement Proposals (QIPs).
slips · DeepWikiMarkdownFork of SatoshiLabs Improvement Proposals.

Hardware Integration

RepositoryLanguageDescription
keystone3-firmware · DeepWikiCFork of Keystone hardware wallet firmware with PQ support.

Internal Tools

RepositoryLanguageDescription
task-master · DeepWikiRustTask management system built on reversible transactions.
task-master-admin · DeepWikiTypeScriptAdmin panel for task-master.
rusx · DeepWikiRustRust SDK for the X / Twitter API v2.
hash-comparison · DeepWikiRustBenchmarks comparing hash function performance.
logs · DeepWiki--Operational logs.

Release Management Test Repos

Used for testing CI/CD and release workflows. Not production code.

chain-rm | chain-ru-test | chain-update2512 | quantus-miner-rm | qp-poseidon-rm | poseidon-resonance-rm | plonky2-rm | plonky2-rm2 | quantus-cli-rm