Struct EnvelopeSession 

pub struct EnvelopeSession { /* private fields */ }

Session-local envelope state. Holds the envelope key (HKDF-derived from the TransportKey), the per-session IV, the last-seen counter, and a message budget. Consumed via &mut self so nonce reuse within a session is structurally prevented.

Implementations

impl EnvelopeSession

pub async fn new( transport_key: &TransportKey, session_id: String, iv: [u8; 12], ) -> Result<Self, EnvelopeError>

Derive a fresh envelope session from a TransportKey.

Args:

• transport_key: the session’s transport key from crate::sas::derive_transport_key.
• session_id: the pairing session id (part of every AAD).
• iv: per-session 96-bit IV. Produce via OsRng at session start; transmit out-of-band to the peer.

Usage:

let session = EnvelopeSession::new(&transport_key, session_id, iv).await?;
let env = session.seal("/v1/pairing/sessions/x/response", pt).await?;

pub async fn seal( &mut self, path: &str, plaintext: &[u8], ) -> Result<Envelope<Sealed>, EnvelopeError>

Seal plaintext, binding to path and the next monotonic counter.

pub async fn open( &mut self, path: &str, env: Envelope<Sealed>, ) -> Result<Envelope<Open>, EnvelopeError>

Open a Envelope<Sealed>. Enforces strict-monotonic counter over the session.

Trait Implementations

impl Drop for EnvelopeSession

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.