PeerSessionManager

Struct PeerSessionManager 

Source
pub struct PeerSessionManager { /* private fields */ }
Expand description

Manager for all per-peer E2EE sessions

Implementations§

Source§

impl PeerSessionManager

Source

pub fn new(our_node_id: NodeId) -> Self

Create a new session manager with a generated identity key

Source

pub fn with_identity_key( our_node_id: NodeId, identity_key: PeerIdentityKey, ) -> Self

Create with a specific identity key

Source

pub fn with_max_sessions(self, max: usize) -> Self

Configure maximum sessions

Source

pub fn with_session_timeout(self, timeout_ms: u64) -> Self

Configure session timeout

Source

pub fn our_public_key(&self) -> [u8; 32]

Get our public key bytes (for sharing with peers)

Source

pub fn our_node_id(&self) -> NodeId

Get our node ID

Source

pub fn initiate_session( &mut self, peer_node_id: NodeId, now_ms: u64, ) -> KeyExchangeMessage

Initiate an E2EE session with a peer

Returns a key exchange message to send to the peer.

Source

pub fn handle_key_exchange( &mut self, msg: &KeyExchangeMessage, now_ms: u64, ) -> Option<(KeyExchangeMessage, bool)>

Handle incoming key exchange message from peer

Returns:

  • Some((response, established)) if we should respond (response is our key exchange message)
  • None if the message is invalid or session limit reached
Source

pub fn has_session(&self, peer_node_id: NodeId) -> bool

Check if we have an established session with a peer

Source

pub fn session_state(&self, peer_node_id: NodeId) -> Option<SessionState>

Get session state for a peer

Source

pub fn encrypt_for_peer( &mut self, peer_node_id: NodeId, plaintext: &[u8], now_ms: u64, ) -> Result<PeerEncryptedMessage, EncryptionError>

Encrypt a message for a specific peer

Returns the encrypted message, or an error if no established session exists.

Source

pub fn decrypt_from_peer( &mut self, msg: &PeerEncryptedMessage, now_ms: u64, ) -> Result<Vec<u8>, EncryptionError>

Decrypt a message from a peer

Returns the plaintext, or an error if decryption fails.

Source

pub fn close_session(&mut self, peer_node_id: NodeId)

Close a session with a peer

Source

pub fn remove_session(&mut self, peer_node_id: NodeId) -> Option<PeerSession>

Remove a session entirely

Source

pub fn cleanup_expired(&mut self, now_ms: u64) -> Vec<NodeId>

Cleanup expired sessions

Source

pub fn session_count(&self) -> usize

Get number of active sessions

Source

pub fn established_count(&self) -> usize

Get number of established sessions

Trait Implementations§

Source§

impl Debug for PeerSessionManager

Source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.