mirror of
https://github.com/luxfi/node.git
synced 2026-10-30 15:24:05 +00:00
zeekay
7cf87b230b
The module already called itself github.com/luxfi/node while containing no node in Go: cmd/luxd was twenty-one lines that printed the size of a few types, and the Go column of the matrix measured a VM plugin. A repo that fetches the thing it claims to be has not replaced it, so the Go sources move in — 1515 files, the daemon and everything under it — and the build reaches outside this module for nothing. Rust and C++ sit beside it unchanged and are still measured against it by the differential. That is the point of one repo: the reference implementation and the two ports are the same checkout, so parity is a thing you can run rather than a thing you assert. Verified: builds, and the closure carries no lux-private — checked at build time rather than believed. The daemon starts twelve chains on a local network (P X C Q Z A B G K M F, plus D through its plugin) and reports healthy.
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.