Struct LivenessTracker 

pub struct LivenessTracker { /* private fields */ }

Tracks validator liveness within an epoch by counting missed commit-QC signatures.

Deterministic: All nodes derive liveness data from committed QC signer bitfields stored on-chain, so the same set of offline validators is reported deterministically at epoch boundaries.

Implementations

impl LivenessTracker

pub fn new() -> Self

Create a new tracker. Default offline threshold: missed > 50% of commits.

pub fn record_commit(&mut self, validator_set: &ValidatorSet, signers: &[bool])

Record a committed block’s QC signer bitfield.

signers is the commit-QC’s signer bitfield (index-aligned with the validator set). Validators whose bit is false are counted as having missed this commit.

pub fn offline_validators(&self) -> Vec<(ValidatorId, u64, u64)>

Return validators whose miss rate exceeds the offline threshold.

Returns (ValidatorId, missed_count, total_commits) for each offline validator, suitable for the application to apply downtime slashing.

pub fn reset(&mut self)

Reset the tracker for a new epoch.

pub fn stats(&self, id: ValidatorId) -> (u64, u64)

Get liveness stats for a specific validator.

pub fn total_commits(&self) -> u64

Current number of tracked commits.

Trait Implementations

impl Default for LivenessTracker

fn default() -> Self

Returns the “default value” for a type.