zeekay
56d6c32ef1
This repository owns the former luxfi/pulsar v0.1.x Ring-LWE code line. v0.2.0 is the first post-split Corona release. The Module-LWE sibling library moved to luxfi/pulsar and starts at v1.0.0. The 'Pulsar' brand name retained in the Quasar consensus protocol refers to the Module-LWE library; this repository's brand is Corona — the luminous ring around the central Pulsar/Quasar light.
Corona
Lux is not merely adding post-quantum signatures to a chain; it defines a hybrid finality architecture for DAG-native consensus, with protocol-agnostic threshold lifecycle, post-quantum threshold sealing, and cross-chain propagation of Horizon finality.
See LP-105 §Claims and evidence for the canonical claims/evidence table and the ten architectural commitments — single source of truth.
Corona is the Lux Ring-LWE post-quantum threshold signature library for Quasar consensus, derived from daryakaviani/corona (academic 2-round threshold signature from R-LWE) with the protocol additions needed to operate on a leaderless open public chain.
The Module-LWE sibling library — byte-equal to FIPS 204 single-party ML-DSA per the Class N1 manifesto — lives at luxfi/pulsar.
Version note
This repository owns the former luxfi/pulsar v0.1.x Ring-LWE code line.
Following the 2026 Pulsar / Corona split:
- Ring-LWE code (this repository) retains
v0.1.0,v0.1.1,v0.1.2,v0.1.5as historical R-LWE releases under their new home, and continues withv0.2.0onward as the post-split Corona line. - Module-LWE code moved to
luxfi/pulsarand starts atv1.0.0to signal the identity break.
Use:
go get github.com/luxfi/[email protected] # Ring-LWE (this repo, post-split)
go get github.com/luxfi/[email protected] # Module-LWE (sibling repo)
Why "Corona"
A corona is the luminous ring of light surrounding a star — visible only when the brighter central body (the Pulsar / Quasar) is partially occluded. Brand-paired with Pulsar (Module-LWE) and Quasar (the consensus that consumes both): the same family of threshold-finality light, observed at a different layer.
Relationship to upstream Corona
The upstream repo at daryakaviani/corona is an academic proof-of-concept ("not ready for production use" per its README). Corona is the production track:
| Layer | Upstream Corona | Corona |
|---|---|---|
| 2-round threshold sign | ✅ same byte-equal protocol | ✅ inherited |
| Trusted-dealer Gen | ✅ for fixed federation | ✅ retained for bridge MPC |
| Proactive resharing for epoch validator rotation | ❌ not specified | 🚧 corona/reshare/ (this fork) |
| Pedersen DKG over R_q with proper hiding | ❌ not specified | 🚧 corona/dkg2/ (this fork) |
| Per-validator triple-sign integration with Quasar | ❌ N/A | 🚧 corona/consensus/ integration |
Layout
sign/— 2-round threshold signing (byte-equal with upstream)primitives/— Shamir, hashes, MACs, PRFs (byte-equal with upstream)utils/— NTT, Montgomery, ring helpers (byte-equal with upstream)networking/— TCP peer-to-peer (byte-equal with upstream)dkg/— original Lux DKG (Feldman VSS without noise; broken for public broadcast — see RED-DKG-REVIEW). Retained for reference.dkg2/— proper Pedersen DKG over R_q (Pulsar addition; this fork)reshare/— proactive secret resharing for epoch rotation (Pulsar addition; this fork)cmd/— KAT oracle generators
Status
WIP. The 2-round Sign+Verify path is byte-equal-validated against the academic Corona spec via 16 SHA-256 KATs. The Pulsar-specific additions (resharing + Pedersen DKG) are under design and implementation.