mirror of
https://github.com/luxfi/node.git
synced 2026-07-27 03:06:23 +00:00
zeekay
2a08357dcb
Supersede the stale Quasar-wrapper notes with the actual consensus/quasar verify gate: dormant-by-default safety contract, files/tests, and the owner-gated remaining-work map (producer+encoder export, gossip ingest, per-epoch validator provider, config wiring, grace-window runbook) + mainnet activation order.
Consensus Package (Node-Side Integration)
This package provides node-side glue around the canonical consensus engine
in github.com/luxfi/consensus. It does
NOT implement the consensus protocol — it only wires the engine into the
node's chain manager, indexer, and IPC layers.
Overview
The consensus package contains:
- Acceptor: Callback mechanism invoked when consensus accepts a block / vertex. Adapts chain-ID-keyed runtime contexts to the node's indexer and warp IPC.
- Quasar: Node-side wiring around
consensus/protocol/quasar(BLS + Corona hybrid finality). Adapts P-Chain validator state, BLS signing keys, and the Corona threshold coordinator.
Package Structure
consensus/
acceptor.go # Acceptor interface + chain-ID-keyed AcceptorGroup
quasar/ # Node-side wrapper around luxfi/consensus/protocol/quasar
zap/ # ZAP agentic-consensus / DID bridge (self-contained)
Acceptor
The Acceptor interface is called before containers are committed as
accepted:
type Acceptor interface {
Accept(rt *runtime.Runtime, containerID ids.ID, container []byte) error
}
Multiple acceptors can be registered per chain via AcceptorGroup.
Quasar Integration
The quasar/ subpackage wraps github.com/luxfi/consensus/protocol/quasar
and provides node-specific wiring:
- P-Chain provider — feeds live validator state from PlatformVM's validator manager into the engine.
- Quantum fallback signer — adapts the node's BLS signing key.
- Corona coordinator stub — placeholder until real threshold key material is loaded.
The actual hybrid finality protocol (BLS + Corona + ML-DSA threshold
signing) lives in luxfi/consensus. See that repository for protocol
details, parameter tuning, and benchmarks.