Struct Session 

pub struct Session { /* private fields */ }

A fully managed PO session over any transport.

Handles the handshake, encryption, and frame IO.

Implementations

impl Session

pub fn new(identity: Identity) -> Self

Create a new session with the given identity.

pub fn state(&self) -> SessionState

Get the current session state.

pub fn node_id(&self) -> &NodeId

Get our own node ID.

pub fn peer_node_id(&self) -> Option<&NodeId>

Get the peer’s node ID (available after handshake).

pub async fn handshake_initiator( &mut self, transport: &mut dyn AsyncFrameTransport, ) -> Result<(), HandshakeError>

Perform the handshake as the initiator (client).

pub async fn handshake_responder( &mut self, transport: &mut dyn AsyncFrameTransport, ) -> Result<(), HandshakeError>

Perform the handshake as the responder (server).

pub async fn send( &mut self, transport: &mut dyn AsyncFrameTransport, channel: u32, data: &[u8], ) -> Result<(), SessionError>

Send encrypted application data.

pub async fn recv( &mut self, transport: &mut dyn AsyncFrameTransport, ) -> Result<Option<(u32, Vec<u8>)>, SessionError>

Receive the next message. Returns (channel_id, decrypted_data).

Automatically handles control frames (Ping/Pong/Close).

pub async fn close( &mut self, transport: &mut dyn AsyncFrameTransport, ) -> Result<(), SessionError>

Send a graceful close frame.