Struct SenderState 

pub struct SenderState { /* private fields */ }

Per-peer sender-side MMP state.

Records cumulative and interval counters for every frame transmitted to this peer. Produces SenderReport snapshots on demand.

Implementations

impl SenderState

pub fn new() -> Self

pub fn new_with_cold_start(cold_start_ms: u64) -> Self

Create with a custom cold-start interval (ms).

Used by session-layer MMP which needs a longer initial interval since reports consume bandwidth on every transit link.

pub fn record_sent(&mut self, counter: u64, timestamp: u32, bytes: usize)

Record a frame sent to this peer.

Called on the TX path for every encrypted link message. counter is the AEAD nonce/counter, timestamp is the inner header session-relative timestamp (ms), bytes is the wire payload size.

pub fn build_report(&mut self, now: Instant) -> Option<SenderReport>

Build a SenderReport from current state and reset the interval.

Returns None if no frames have been sent since the last report.

pub fn should_send_report(&self, now: Instant) -> bool

Check if it’s time to send a report.

When consecutive send failures have occurred, the effective interval is multiplied by an exponential backoff factor (2^failures, capped at 32×).

pub fn record_send_failure(&mut self) -> u32

Record a send failure. Returns the new consecutive failure count.

pub fn record_send_success(&mut self) -> u32

Record a successful send. Returns the previous failure count (for summary logging).

pub fn send_failure_backoff_multiplier(&self) -> f64

Get the backoff multiplier based on consecutive failures.

Returns 1.0 for no failures, 2.0 for 1 failure, 4.0 for 2, … capped at 32.0 (5 failures).

pub fn update_report_interval_from_srtt(&mut self, srtt_us: i64)

Update the report interval based on SRTT (link-layer defaults).

Sender reports at 2× SRTT clamped to [floor, MAX]. During cold-start (first COLD_START_SAMPLES updates), the floor is the cold-start interval (200ms) for fast SRTT convergence. After that, it rises to MIN_REPORT_INTERVAL_MS (1000ms) for steady-state efficiency.

pub fn update_report_interval_with_bounds( &mut self, srtt_us: i64, min_ms: u64, max_ms: u64, )

Update the report interval based on SRTT with custom bounds.

Used by session-layer MMP which needs higher clamp values since each report consumes bandwidth on every transit link.

pub fn cumulative_packets_sent(&self) -> u64

pub fn cumulative_bytes_sent(&self) -> u64

pub fn report_interval(&self) -> Duration

pub fn consecutive_send_failures(&self) -> u32

Trait Implementations

impl Default for SenderState

fn default() -> Self

Returns the “default value” for a type.