Struct Session 

pub struct Session { /* private fields */ }

Handshake + rekey state machine for Foctet Core.

Implementations

impl Session

pub fn new_initiator(thresholds: RekeyThresholds) -> (Self, ControlMessage)

Creates an initiator session and returns the initial ClientHello.

pub fn new_initiator_with_auth( thresholds: RekeyThresholds, auth: SessionAuthConfig, ) -> (Self, ControlMessage)

Creates an initiator session with explicit authentication configuration.

pub fn new_responder(thresholds: RekeyThresholds) -> Self

Creates a responder session waiting for a peer ClientHello.

pub fn new_responder_with_auth( thresholds: RekeyThresholds, auth: SessionAuthConfig, ) -> Self

Creates a responder session with explicit authentication configuration.

pub fn state(&self) -> SessionState

Returns current session state.

pub fn role(&self) -> HandshakeRole

Returns configured handshake role.

pub fn peer_authenticated(&self) -> bool

Returns whether the peer presented and passed handshake authentication.

pub fn outbound_direction(&self) -> Direction

Returns outbound traffic direction for this role.

pub fn inbound_direction(&self) -> Direction

Returns inbound traffic direction for this role.

pub fn handle_control( &mut self, msg: &ControlMessage, ) -> Result<Option<ControlMessage>, CoreError>

Applies an incoming control message and optionally returns a response.

pub fn active_keys(&self) -> Option<TrafficKeys>

Returns the currently active traffic keys, if session is active.

pub fn active_and_previous_keys(&self) -> Option<Vec<TrafficKeys>>

Returns active key followed by retained previous keys.

pub fn key_ring(&self) -> Result<Vec<TrafficKeys>, CoreError>

Returns current key ring as transport-ready list.

pub fn on_outbound_payload( &mut self, plaintext_len: usize, ) -> Result<Option<ControlMessage>, CoreError>

Records outbound payload usage and emits rekey control when needed.

pub fn force_rekey(&mut self) -> Result<ControlMessage, CoreError>

Forces immediate rekey and returns the Rekey control message.

Trait Implementations

impl Clone for Session

fn clone(&self) -> Session

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Session

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

Formats the value using the given formatter.

impl Drop for Session

fn drop(&mut self)

Executes the destructor for this type.