Struct RatchetSession 

pub struct RatchetSession { /* private fields */ }

Ratcheting session for forward secrecy.

Each encrypt/decrypt advances the key chain, destroying previous keys automatically.

Chain keys are securely zeroized from memory when dropped.

Implementations

impl RatchetSession

pub fn new(root_key: &[u8; 32], is_initiator: bool) -> Self

Create a new ratchet session from shared root key.

Arguments

• root_key - Shared secret from key exchange
• is_initiator - True if this party initiated the session

pub fn encrypt(&mut self, plaintext: &[u8]) -> Result<Vec<u8>>

Encrypt a message with forward secrecy.

Advances the send chain - previous keys are destroyed.

pub fn decrypt(&mut self, ciphertext: &[u8]) -> Result<Vec<u8>>

Decrypt a message with forward secrecy.

Advances the receive chain only AFTER successful MAC and counter verification. A forged packet will not desynchronize the session.

pub fn send_counter(&self) -> u64

Get send counter (for diagnostics).

pub fn recv_counter(&self) -> u64

Get receive counter (for diagnostics).

Trait Implementations

impl Drop for RatchetSession

fn drop(&mut self)

Executes the destructor for this type.

impl Zeroize for RatchetSession

fn zeroize(&mut self)

Zero out this object from memory using Rust intrinsics which ensure the zeroization operation is not “optimized away” by the compiler.