validators

Aug 18, 2025

Changes in this version

type Validator

+ ID func() string

Jul 20, 2025

Changes in this version

+ var ErrMissingValidators = errors.New("missing validators")

+ var ErrZeroWeight = errors.New("weight must be non-zero")

+ type GetCurrentValidatorOutput struct

+ IsActive bool

+ IsL1Validator bool

+ MinNonce uint64

+ NodeID ids.NodeID

+ PublicKey *bls.PublicKey

+ StartTime uint64

+ ValidationID ids.ID

+ Weight uint64

type Manager

+ AddStaker func(subnetID ids.ID, nodeID ids.NodeID, pk *bls.PublicKey, txID ids.ID, ...) error

+ AddWeight func(subnetID ids.ID, nodeID ids.NodeID, weight uint64) error

+ GetMap func(subnetID ids.ID) map[ids.NodeID]*GetValidatorOutput

+ GetValidatorIDs func(subnetID ids.ID) []ids.NodeID

+ NumSubnets func() int

+ NumValidators func(subnetID ids.ID) int

+ RegisterCallbackListener func(listener ManagerCallbackListener)

+ RegisterSetCallbackListener func(subnetID ids.ID, listener SetCallbackListener)

+ RemoveWeight func(subnetID ids.ID, nodeID ids.NodeID, weight uint64) error

+ Sample func(subnetID ids.ID, size int) ([]ids.NodeID, error)

+ SubsetWeight func(subnetID ids.ID, validatorIDs set.Set[ids.NodeID]) (uint64, error)

+ type ManagerCallbackListener interface

+ OnValidatorAdded func(subnetID ids.ID, nodeID ids.NodeID, pk *bls.PublicKey, txID ids.ID, ...)

+ OnValidatorRemoved func(subnetID ids.ID, nodeID ids.NodeID, weight uint64)

+ OnValidatorWeightChanged func(subnetID ids.ID, nodeID ids.NodeID, oldWeight, newWeight uint64)

+ type SetCallbackListener interface

+ OnValidatorAdded func(nodeID ids.NodeID, pk *bls.PublicKey, txID ids.ID, weight uint64)

+ OnValidatorRemoved func(nodeID ids.NodeID, weight uint64)

+ OnValidatorWeightChanged func(nodeID ids.NodeID, oldWeight, newWeight uint64)

+ func NewLogger(log logging.Logger, subnetID ids.ID, nodeIDs ...ids.NodeID) SetCallbackListener

type State

+ func NewLockedState(lock sync.Locker, s State) State

+ func NewNoValidatorsState(state State) State

+ func Trace(s State, name string, tracer trace.Tracer) State

+ GetCurrentValidatorSet func(ctx context.Context, subnetID ids.ID) (map[ids.ID]*GetCurrentValidatorOutput, uint64, error)

Jul 30, 2025

Changes in this version

+ var ErrInvalidWeight = errors.New("invalid weight")

+ var ErrValidatorNotFound = errors.New("validator not found")

+ var PrimaryNetworkID = constants.PrimaryNetworkID

+ type Connector interface

+ Connected func(ctx context.Context, nodeID ids.NodeID, nodeVersion *version.Application) error

+ Disconnected func(ctx context.Context, nodeID ids.NodeID) error

+ type GetValidatorOutput struct

+ NodeID ids.NodeID

+ PublicKey []byte

+ Weight uint64

+ type Manager interface

+ Add func(subnetID ids.ID, validators Set) error

+ Contains func(subnetID ids.ID) bool

+ Count func() int

+ Get func(subnetID ids.ID) (Set, bool)

+ GetByWeight func(subnetID ids.ID, minWeight uint64) (Set, bool)

+ GetValidator func(subnetID ids.ID, nodeID ids.NodeID) (*Validator, error)

+ GetWeight func(subnetID ids.ID, nodeID ids.NodeID) uint64

+ RecalculateStakes func(subnetID ids.ID) error

+ Remove func(subnetID ids.ID) error

+ TotalWeight func(subnetID ids.ID) (uint64, error)

+ func NewManager() Manager

+ type Set interface

+ Add func(nodeID ids.NodeID, pk []byte, weight uint64) error

+ AddWeight func(nodeID ids.NodeID, weight uint64) error

+ Contains func(nodeID ids.NodeID) bool

+ Get func(nodeID ids.NodeID) (*Validator, bool)

+ Len func() int

+ List func() []*Validator

+ Remove func(nodeID ids.NodeID) error

+ RemoveWeight func(nodeID ids.NodeID, weight uint64) error

+ Sample func(seed uint64) (ids.NodeID, error)

+ String func() string

+ Weight func() uint64

+ func NewSet() Set

+ type State interface

+ GetCurrentHeight func(ctx context.Context) (uint64, error)

+ GetMinimumHeight func(ctx context.Context) (uint64, error)

+ GetSubnetID func(ctx context.Context, chainID ids.ID) (ids.ID, error)

+ GetValidatorSet func(ctx context.Context, height uint64, subnetID ids.ID) (map[ids.NodeID]*GetValidatorOutput, error)

+ type TestState struct

+ GetCurrentHeightF func(ctx context.Context) (uint64, error)

+ GetValidatorSetF func(ctx context.Context, height uint64, subnetID ids.ID) (map[ids.NodeID]*GetValidatorOutput, error)

+ func (ts *TestState) GetCurrentHeight(ctx context.Context) (uint64, error)

+ func (ts *TestState) GetValidatorSet(ctx context.Context, height uint64, subnetID ids.ID) (map[ids.NodeID]*GetValidatorOutput, error)

+ type Validator struct

+ NodeID ids.NodeID

+ PublicKey []byte

+ TxID ids.ID

+ Weight uint64