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.
36 lines
1.3 KiB
Go
36 lines
1.3 KiB
Go
// Copyright (C) 2019-2025, Lux Industries Inc. All rights reserved.
|
|
// See the file LICENSE for licensing terms.
|
|
|
|
/*
|
|
Package consensus provides node-side consensus integration for the Lux node.
|
|
|
|
The canonical consensus protocol implementation lives in the
|
|
github.com/luxfi/consensus module. This package only contains the node-side
|
|
glue (Acceptor callbacks, Quasar wiring) needed to wire the consensus engine
|
|
into the node's chain manager and indexer.
|
|
|
|
# Components
|
|
|
|
Acceptor: Callback interface invoked before blocks are committed as
|
|
accepted. Multiple acceptors can be registered per chain via AcceptorGroup.
|
|
This is the node-side hook that adapts consensus acceptance to chain-ID-keyed
|
|
runtime contexts (indexer, warp, IPC).
|
|
|
|
Quasar: Node-side wiring around github.com/luxfi/consensus/protocol/quasar.
|
|
The quasar subpackage adapts P-Chain validator state, BLS signers, and the
|
|
Corona threshold coordinator into the canonical consensus engine.
|
|
|
|
# Quasar Integration
|
|
|
|
The Quasar engine achieves hybrid finality by running two signature paths
|
|
in parallel:
|
|
|
|
- BLS Path: Fast aggregate signatures from 2/3+ validators
|
|
- Corona Path: Post-quantum threshold signatures (t-of-n)
|
|
|
|
Blocks achieve quantum finality only when both paths complete successfully.
|
|
|
|
See github.com/luxfi/consensus for the canonical protocol implementation.
|
|
*/
|
|
package consensus
|