Q-Lightclient

KO | EN

gitlite — search

#javascript #android #machine-learning #react #nodejs #swift #docker #php #golang #ios #reactjs #python

★ 61 Open GitHub ↗

Post quantum light client for Quantova. Header sync and hash based proof verification, embedded by wallets and QCore.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Q-Lightclient

The embedded light client for Quantova. It follows the chain by verifying block headers and checking proofs against them, so a wallet or the SDK can trust chain data without running a full node and without ever reaching for classical cryptography.

Quantova is a sovereign post quantum Layer 1, built from scratch, sharing no code, no wire, and no trust assumption with any other chain. The light client inherits that posture end to end. It follows only Quantova headers, checks only Quantova proofs, and holds only Quantova identifiers. Nothing classical secures any part of it. Foreign chains are read only by the oracle, in its own repository, never here.

## What it is for

A light client is the smallest amount of code that can decide, on its own, whether a piece of chain data is real. It does not replay every transaction. It follows the chain of block headers, checks that each header carries a valid consensus attestation, and then verifies short proofs that a given account, transaction, or state value belongs under a header it already trusts.

In the Quantova stack this client is the verification core embedded by the wallet, by the QCore SDK, and by the validator application. It lets each of them read the chain and act on the result without trusting a gateway to tell the truth.

What it verifies, all with post quantum primitives only.

- Header attestations. Consensus signs with the module lattice scheme and nothing else, so a header whose attestation is any other scheme is refused. This matches the consensus rule frozen in the conformance vectors.
- Inclusion and state proofs. Membership under a header is checked with SHA-3 Merkle proofs, the same hashing the chain commits with.
- Certificate proofs. Batch and tally certificates arrive as hash based STARK proofs from the prover, which rest on hashing alone with no pairing and no elliptic curve operation. The light client carries the verifier side of that certificate.
- Identifiers. Addresses and object identifiers are the Quantova Q1 and family formats, so a value in any foreign encoding does not parse.

## Cryptography

Only NIST standardized post quantum schemes exist here. ML-DSA-65 from FIPS 204 and SLH-DSA from FIPS 205 for signatures, ML-KEM from FIPS 203 for key establishment, and SHA-3 and SHAKE from FIPS 202 for hashing. There is no elliptic curve anywhere and no classical escape hatch. The cryptography is a from scratch reference implementation validated against the NIST vectors. It has not been through an independent security audit, and the chain is at testnet.

## Governance and license

Governed by the crypto policy, POLICY-crypto, in the Quantova-Specs repository, which outranks every other rule here. Commits are authored by the owner only. Dual licensed under Apache 2.0 and MIT.

Q-Lightclient

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README