mirror of https://github.com/luxfi/consensus.git synced 2026-09-24 00:26:58 +00:00

Files

T

zeekayandHanzo Dev 578de7ef2b pop: freeze the over-long key, so the width is refused from both sides

The corpus froze a 47-byte key and both a 95- and a 97-byte proof, but no
49-byte key — so the one width a port could get wrong was the one the standard
did not carry. The clause is a width equality, not a lower bound: a decoder that
guarded only the short side reads the first 48 bytes of a longer buffer and
checks a proof against a PREFIX of what the registrant published. That is a
second spelling of an already-seated key, and two spellings of one key is two
seats and two votes on one signature.

The case is generated by the oracle and self-checked against pop.Verify, like
every other row, and lands as an ENCODING refusal before any pairing.

Go already held it as a unit assertion and Rust held its own; Rust's is dropped
here, because a case the frozen corpus carries for all three does not also want
a private restatement that has to be kept in step.

Co-authored-by: Hanzo Dev <[email protected]>

2026-09-02 02:22:56 -07:00

benches

rust: the eligibility rule at registration, on the identity the proof binds

2026-09-01 11:08:02 -07:00

src

vote: derive the tally's quorum from the set, and drop a replay before the pairing

2026-09-02 00:22:32 -07:00

tests

pop: freeze the over-long key, so the width is refused from both sides

2026-09-02 02:22:56 -07:00

Cargo.toml

vote: carry the vote plane here, and hold it to the certificate's floors

2026-09-01 23:29:07 -07:00

LICENSE

pkg/rust: publish lux-consensus v1.22.0 to crates.io

2026-05-13 00:18:34 -07:00

README.md

rust: the eligibility rule at registration, on the identity the proof binds

2026-09-01 11:08:02 -07:00

README.md

lux-consensus

Pure-Rust SDK for the Lux Quasar consensus stack — Wave threshold voting, FPC (Fast Probabilistic Consensus), Photon validator sampling, Focus confidence accumulation, and post-quantum hybrid finality via BLS12-381 + Pulsar (Module-LWE threshold, FIPS 204 byte-equal).

Features

Flag	What it pulls in
default	CPU-only, no extra deps beyond `blst` and `hex`
`simd`	`blake3` (SIMD hashing) + `rayon` (data-parallel vote tally)
`mlx`	Apple Silicon GPU acceleration via `mlx-sys` (implies `simd`)
`cuda`	NVIDIA GPU acceleration (implies `simd`) — work in progress
`gpu`	`mlx` + `cuda` — auto-select per platform

Usage

use lux_consensus::*;

let config = QuasarConfig::mainnet();
let mut engine = QuasarEngine::new(config);
engine.start().unwrap();

let block = Block::new(
    ID::from([1u8; 32]),
    ID::from([0u8; 32]),
    1,
    b"Hello, Lux!".to_vec(),
);
engine.add(block.clone()).unwrap();

// A validator is named by its 20-byte NodeID — never the 32-byte block id.
for i in 0..20 {
    engine.add_validator(NodeID::from([i; 20]), 1).unwrap();
}

for i in 0..20 {
    let vote = Vote::new(block.id.clone(), VoteType::Preference, NodeID::from([i; 20]));
    engine.record_vote(vote).unwrap();
}

assert!(engine.is_accepted(&block.id));
engine.stop().unwrap();

Architecture

Wave — adaptive-threshold voting driven by FPC outputs
FPC — PRF-derived per-round thresholds for fast probabilistic consensus
Photon — luminance-tracked validator sampling
Focus — β consecutive rounds of confidence before commit
Quasar — a two-thirds-by-stake certificate: the distinct signed accepts themselves, each checked against its own signer's key

License

Lux Ecosystem License 1.2 — see the LICENSE file.