Struct ConnectionState 

pub struct ConnectionState {

    pub session_id: SessionId,
    pub phase: ConnectionPhase,
    pub remote_endpoint: SocketAddr,
    pub last_received: Instant,
    pub epoch: u32,
    pub send_nonce: u64,
    pub recv_nonce_window: NonceWindow,
    pub rtt: RttEstimator,
    pub timestamps: TimestampTracker,
    pub pacer: FramePacer,
    pub retransmit: RetransmitController,
    pub migration: MigrationState,
    pub local_state_version: u64,
    pub remote_state_version: u64,
    pub acked_state_version: u64,
}

Available on crate feature transport only.

Full connection state as specified in 2-TRANSPORT.md.

Fields

session_id: SessionId

Session identifier from handshake.

phase: ConnectionPhase

Current connection phase.

remote_endpoint: SocketAddr

Remote peer address (may change during migration).

last_received: Instant

When we last received an authenticated frame.

epoch: u32

Current epoch (increments on rekey).

send_nonce: u64

Outbound nonce counter (monotonically increasing).

recv_nonce_window: NonceWindow

Inbound anti-replay window.

rtt: RttEstimator

RTT estimation.

timestamps: TimestampTracker

Timestamp tracking for RTT measurement.

pacer: FramePacer

Frame pacing.

retransmit: RetransmitController

Retransmission control.

migration: MigrationState

Migration state.

local_state_version: u64

Highest state version we’ve sent.

remote_state_version: u64

Highest state version we’ve acknowledged from peer.

acked_state_version: u64

Highest state version the peer has acknowledged from us.

Implementations

impl ConnectionState

pub fn new(session_id: SessionId, remote_endpoint: SocketAddr) -> Self

Create a new connection state for an established session.

pub fn handshaking(remote_endpoint: SocketAddr) -> Self

Create a connection state in handshaking phase.

pub fn next_send_nonce(&mut self) -> u64

Get the next nonce for sending and increment the counter.

pub fn check_recv_nonce(&mut self, nonce: u64) -> bool

Check if a received nonce is valid (not replayed).

pub fn on_authenticated_frame(&mut self, from: SocketAddr)

Update state after receiving an authenticated frame.

pub fn is_alive(&self) -> bool

Check if the connection is still alive.

pub fn is_failed(&self) -> bool

Check if the connection has failed.

pub fn has_unacked_data(&self) -> bool

Check if there’s unacknowledged data.

pub fn on_ack(&mut self, acked_version: u64)

Update the acked state version.

pub fn close(&mut self)

Transition to closed state.

pub fn mark_closed(&mut self)

Mark as fully closed.

pub fn mark_failed(&mut self)

Mark as failed.

pub fn complete_handshake(&mut self, session_id: SessionId)

Complete handshake and transition to established.

pub fn on_rekey(&mut self)

Increment epoch (on rekey).

Trait Implementations

impl Debug for ConnectionState

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

Formats the value using the given formatter.