Struct PixTurnEvents 

pub struct PixTurnEvents {
    pub requested: u32,
    pub committed: u32,
    pub funded: u32,
    pub recovered: u32,
    pub failed: u32,
    pub useful_shares: u64,
    pub surplus_shares: u64,
    pub deposit_confirmed_uhopr: u64,
    pub phase_durations: Vec<(PixCyclePhase, u64)>,
    pub finalized: Vec<PixCycleSummary>,
}

Cycle lifecycle transitions latched by the supervisor since the last publish.

The supervisor is a pure state machine and cannot emit a metric, so it latches the edge and the worker drains it — the same arrangement as take_fill_stall.

Fields

requested: u32

Indices allocated into an SsaRequest.

committed: u32

Commitments verified.

funded: u32

Deposits confirmed.

recovered: u32

Cycles fully reconstructed.

failed: u32

Cycles retired without recovering.

useful_shares: u64

Newly accepted shares that advanced reconstruction.

surplus_shares: u64

Newly accepted shares that did not — the negotiated surplus, and duplicates.

deposit_confirmed_uhopr: u64

Deposit value confirmed this turn, in µHOPR. Recovered value is read off finalized instead, so the two follow the scope rules of the cycle counters they mirror.

phase_durations: Vec<(PixCyclePhase, u64)>

Phases that ended this turn, and how long each lasted in milliseconds.

Milliseconds rather than an f64 of seconds so this struct keeps its Eq; the conversion happens at the instrument.

finalized: Vec<PixCycleSummary>

Cycles that reached a terminal state and have a coverage summary to observe.

A Vec rather than a running total because each entry becomes one observation in three histograms, and a histogram cannot be fed a sum. Bounded by the cycles one supervisor turn can finalize, which is at most a batch.

Implementations

impl PixTurnEvents

pub fn is_empty(&self) -> bool

True when nothing happened, so the publish can skip the counters entirely.

fn counts(&self) -> [(PixCycleEvent, u32); 5]

The non-zero counts, in label order.

fn shares(&self) -> [(PixShareKind, u64); 2]

The share deltas, in label order.

Trait Implementations

impl Clone for PixTurnEvents

fn clone(&self) -> PixTurnEvents

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PixTurnEvents

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

Formats the value using the given formatter.

impl Default for PixTurnEvents

fn default() -> PixTurnEvents

Returns the “default value” for a type.

impl Eq for PixTurnEvents

impl PartialEq for PixTurnEvents

fn eq(&self, other: &PixTurnEvents) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for PixTurnEvents