lux/corona
2
0
Fork 0
mirror of https://github.com/luxfi/corona.git synced 2026-09-24 00:25:54 +00:00
Code Issues Packages Projects Releases Wiki Activity

corona: README — Ring-LWE identity; v0.1.x history inherited from luxfi/pulsar

Browse Source 
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.
This commit is contained in:
zeekay
2026-05-11 19:37:10 -07:00
parent 8c010dd8ef
commit 56d6c32ef1
1 changed files with 34 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+34 -9
View File
@@ -1,26 +1,51 @@
# Pulsar
# 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](https://github.com/luxfi/lps/blob/main/LP-105-lux-stack-lexicon.md#claims-and-evidence) for the canonical claims/evidence table and the ten architectural commitments — single source of truth.
**Pulsar** is the Lux-evolved post-quantum threshold signature stack for **Quasar consensus**, derived from [daryakaviani/corona](https://github.com/daryakaviani/corona) (academic 2-round threshold signature from LWE) with the protocol additions needed to operate on a **leaderless open public chain**.
**Corona** is the Lux **Ring-LWE** post-quantum threshold signature library
for **Quasar consensus**, derived from [daryakaviani/corona](https://github.com/daryakaviani/corona) (academic 2-round threshold signature from R-LWE) with the protocol additions needed to operate on a **leaderless open public chain**.
## Why "Pulsar"
The Module-LWE sibling library — byte-equal to FIPS 204 single-party ML-DSA per the Class N1 manifesto — lives at [`luxfi/pulsar`](https://github.com/luxfi/pulsar).
`Lux` (Latin) → light. `Pulsar` → SI unit of luminous flux. Each validator emits a "pulsar" of signature toward consensus; aggregated, they form the chain's overall light. Brand-paired with Quasar (the consensus that consumes them).
## 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.5` as historical R-LWE releases under their new home, and continues
with `v0.2.0` onward as the post-split Corona line.
- **Module-LWE** code moved to [`luxfi/pulsar`](https://github.com/luxfi/pulsar)
and starts at `v1.0.0` to signal the identity break.
Use:
```sh
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). Pulsar is the production track:
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 | Pulsar |
| 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 | 🚧 **pulsar/reshare/** (this fork) |
| **Pedersen DKG over R_q** with proper hiding | ❌ not specified | 🚧 **pulsar/dkg2/** (this fork) |
| Per-validator triple-sign integration with Quasar | ❌ N/A | 🚧 **pulsar/consensus/** integration |
| **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