Files
zeekayandHanzo Dev 37e2940ead mesh is the peer layer, network is the validator set
Two packages were named for the same word and meant different things. network/
dialed peers, exchanged keys, throttled and tracked them; nets/ tracked which
chains share a validator set and when they have all bootstrapped. One letter
apart, and neither name said which was which.

The peer layer is mesh — the word this estate already uses for it, in
lux-rs/node's own mesh.rs. That frees network for the thing that is actually a
network: a set of chains sharing a validator set. A network holds chains; a
chain belongs to one network.

github.com/luxfi/p2p stays what it is, the gossip library the VMs use. Three
concerns, three names, none of them borrowed from another.

Co-authored-by: Hanzo Dev <[email protected]>
2026-09-07 21:17:09 -07:00

60 lines
1.9 KiB
Go

// Copyright (C) 2019-2025, Lux Industries Inc. All rights reserved.
// See the file LICENSE for licensing terms.
package network
import (
"time"
"github.com/luxfi/consensus/config"
)
// POAConfig provides Proof of Authority configuration for chains
type POAConfig struct {
// Enabled indicates if POA mode is active
Enabled bool `json:"enabled" yaml:"enabled"`
// SingleNodeMode allows a single node to produce and finalize blocks
SingleNodeMode bool `json:"singleNodeMode" yaml:"singleNodeMode"`
// MinBlockTime is the minimum time between blocks in POA mode
MinBlockTime time.Duration `json:"minBlockTime" yaml:"minBlockTime"`
// AuthorizedNodes are the nodes authorized to produce blocks
AuthorizedNodes []string `json:"authorizedNodes" yaml:"authorizedNodes"`
}
// DefaultPOAParameters returns sampling parameters optimized for POA mode
func DefaultPOAParameters() config.Parameters {
return config.Parameters{
K: 1, // Only query 1 node (ourselves)
AlphaPreference: 1, // Change preference with 1 vote
AlphaConfidence: 1, // Increase confidence with 1 vote
Beta: 1, // Only need 1 successful query for finalization
ConcurrentPolls: 1, // Only 1 concurrent poll needed
OptimalProcessing: 1, // Only 1 block in processing at a time for single-node mode
MaxOutstandingItems: 256,
MaxItemProcessingTime: 30 * time.Second,
}
}
// ApplyPOAConfig modifies the net config for POA mode
func (c *Config) ApplyPOAConfig(poa POAConfig) {
if !poa.Enabled {
return
}
// Override consensus parameters for POA
c.ConsensusParameters = DefaultPOAParameters()
// Set minimum block delay for POA
if poa.MinBlockTime > 0 {
c.ProposerMinBlockDelay = poa.MinBlockTime
} else {
c.ProposerMinBlockDelay = 1 * time.Second // Default 1 second blocks
}
// In POA mode, we don't need to store many historical blocks
c.ProposerNumHistoricalBlocks = 100
}