Struct Encoder 

pub struct Encoder<C = Identity, E = Identity> { /* private fields */ }

Synchronous, statically dispatched frame encoder with reusable codec storage.

The caller owns the frame index and must never encrypt different payloads with the same key/index. Use a fresh key for each immutable object. This type performs no I/O, scheduling, implicit indexing, or retries.

Implementations

impl<C: CompressionCodec, E: EncryptionCodec> Encoder<C, E>

pub fn new(framing: Framing, compression: C, encryption: E) -> Result<Self>

Create an encoder. Codec types determine the metadata profile.

pub fn config(&self) -> Config

Settings to use when constructing the object’s metadata.

pub fn encode_frame( &mut self, index: u64, buffer: &mut Vec<u8>, ) -> Result<FrameSizes>

Replace raw bytes with stored bytes, returning lengths to append to metadata. Empty/oversized frames and out-of-policy indices are refused. On any error the buffer is cleared, but its allocation is retained.

This does not append metadata: the caller does that after successful I/O. The metadata builder enforces that a short fixed frame is the last frame.