Struct Committee 

pub struct Committee { /* private fields */ }

Committee is the set of authorities that participate in the consensus protocol for this epoch. Its configuration is stored and computed on chain.

Implementations

impl Committee

pub fn new(epoch: Epoch, authorities: Vec<Authority>) -> Self

pub fn new_v3( epoch: Epoch, authorities: Vec<Authority>, malicious_stake: Stake, crash_stake: Stake, ) -> Self

Constructs a committee with thresholds derived from a hybrid fault budget (malicious_stake = f, crash_stake = c).

Nominally, the total stake is nominal_total_stake = 5f + 3c + 1; and the thresholds evaluate to:

• validity_threshold = f + 1
• certification_threshold = 2f + c + 1
• quorum_threshold = 4f + 2c + 1

But the actual total stakes specified by the authorities may differ from the nominal total stake computed above. We will scale f and c from the nominal value to the largest possible values where intersection properties still hold. Then the thresholds are computed with scaled f and c.

pub fn epoch(&self) -> Epoch

pub fn total_stake(&self) -> Stake

pub fn quorum_threshold(&self) -> Stake

pub fn certification_threshold(&self) -> Stake

pub fn validity_threshold(&self) -> Stake

pub fn stake(&self, authority_index: AuthorityIndex) -> Stake

pub fn authority(&self, authority_index: AuthorityIndex) -> &Authority

pub fn authorities(&self) -> impl Iterator<Item = (AuthorityIndex, &Authority)>

pub fn authorities_slice(&self) -> &[Authority]

Returns the authorities as a slice, preserving their order (and hence their AuthorityIndex values). Useful for rebuilding a Committee with different threshold parameters while keeping the same authority set.

pub fn reached_quorum(&self, stake: Stake) -> bool

Returns true if the provided stake has reached quorum (2f+1).

pub fn reached_validity(&self, stake: Stake) -> bool

Returns true if the provided stake has reached validity (f+1).

pub fn to_authority_index(&self, index: usize) -> Option<AuthorityIndex>

Converts an index to an AuthorityIndex, if valid. Returns None if index is out of bound.

pub fn is_valid_index(&self, index: AuthorityIndex) -> bool

Returns true if the provided index is valid.

pub fn size(&self) -> usize

Returns number of authorities in the committee.

Trait Implementations

impl Clone for Committee

fn clone(&self) -> Committee

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Committee

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Committee

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Committee

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

where __S: Serializer,

Serialize this value into the given Serde serializer.