Struct ValidatorSet 

pub struct ValidatorSet {
    pub epoch: u64,
    pub epoch_start: Timestamp,
    /* private fields */
}

A set of validators for an epoch

Fields

epoch: u64

Current epoch number

epoch_start: Timestamp

Epoch start timestamp

Implementations

impl ValidatorSet

pub fn new(epoch: u64, validators: Vec<ValidatorInfo>) -> Result<Self>

Creates a new validator set for the given epoch

pub fn get(&self, index: usize) -> Option<&ValidatorInfo>

Returns the validator at the given index

pub fn get_by_address(&self, address: &Address) -> Option<&ValidatorInfo>

Returns the validator with the given address

pub fn index_of(&self, address: &Address) -> Option<usize>

Returns the position of a validator in self.validators matching the given address, or None if not present.

This is the canonical “validator index” used for bitmap-based BLS signer encoding in crate::voter::QuorumCertificate::signer_bitmap. The index is stable for the lifetime of the validator set (i.e. the duration of one epoch); a new epoch may renumber.

pub fn active_validators(&self) -> &[ValidatorInfo]

Returns the validators slice in canonical order (insertion / epoch order). The position of each entry in this slice is the bit index used by crate::voter::QuorumCertificate::signer_bitmap when verifying the BLS aggregate.

pub fn len(&self) -> usize

Returns the number of validators

pub fn is_empty(&self) -> bool

Returns whether the validator set is empty

pub fn iter(&self) -> Iter<'_, ValidatorInfo>

Returns an iterator over the validators

pub fn total_stake(&self) -> u128

Returns the total stake

pub fn total_voting_power(&self) -> u128

Returns the total voting power (sum of active validators’ stake)

pub fn is_validator(&self, address: &Address) -> bool

Returns whether the given address is a validator

pub fn select_leader_round_robin(&self, view: u64) -> Result<&ValidatorInfo>

Selects the leader for the given view via deterministic round-robin.

This is the simplest possible proposer election: view % N. It is retained as a fallback / test path; production deployments should use ReputationProposer via ProposerElection which incorporates observed-behaviour reputation and a stake-weighted draw.

pub fn quorum_threshold(&self) -> usize

Calculates the quorum threshold (2f+1)

pub fn tee_attested_validators(&self) -> Vec<&ValidatorInfo>

Returns the validators with valid TEE attestation

pub fn tee_attestation_rate(&self) -> f64

Returns the percentage of validators with TEE attestation

Trait Implementations

impl Clone for ValidatorSet

fn clone(&self) -> ValidatorSet

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ValidatorSet

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ValidatorSet

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ValidatorSet

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.