Struct FrameCodec 

pub struct FrameCodec { /* private fields */ }

Encodes and decodes WSCALL binary frames.

The symmetric ciphers are constructed once when a key is configured and shared via Arc across every clone of the codec. This avoids redoing the key schedule (which for AES-256-GCM is especially expensive) on every frame.

Implementations

impl FrameCodec

pub fn plaintext() -> Self

Builds a codec configured for plaintext transport.

pub fn with_chacha20_key(self, key: [u8; 32]) -> Self

Configures a ChaCha20-Poly1305 key.

The cipher is constructed eagerly so that subsequent frame encoding never pays for the key schedule again.

pub fn with_aes256_key(self, key: [u8; 32]) -> Self

Configures an AES256-GCM key.

The cipher is constructed eagerly so that subsequent frame encoding never pays for the AES key expansion again.

pub fn encode(&self, packet: &PacketEnvelope) -> Result<Vec<u8>, ProtocolError>

Encodes an envelope into a binary WSCALL frame.

pub fn decode(&self, frame: &[u8]) -> Result<PacketEnvelope, ProtocolError>

Decodes a binary WSCALL frame back into an envelope.

Trait Implementations

impl Clone for FrameCodec

fn clone(&self) -> FrameCodec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FrameCodec

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

Formats the value using the given formatter.

impl Default for FrameCodec

fn default() -> FrameCodec

Returns the “default value” for a type.