Struct SimpleCoder

#[non_exhaustive]
pub struct SimpleCoder;

Simple coder that only uses the last 31 bytes of each blob. This is the default coder for the SidecarBuilder.

Note

Because this coder sacrifices around 3% of total sidecar space, we do not recommend its use in production. It is provided for convenience and non-prod environments.

Behavior

This coder encodes data as follows:

• The first byte of every 32-byte word is empty.
• Data is pre-pended with a 64-bit big-endian length prefix, which is right padded with zeros to form a complete word.
• The rest of the data is packed into the remaining 31 bytes of each word.
• If the data is not a multiple of 31 bytes, the last word is right-padded with zeros.

This means that the following regions cannot be used to store data, and are considered “wasted”:

• The first byte of every 32-byte word.
• The right padding on the header word containing the data length.
• Any right padding on the last word for each piece of data.

Trait Implementations

impl Clone for SimpleCoder

fn clone(&self) -> SimpleCoder

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for SimpleCoder

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

Formats the value using the given formatter.

impl Default for SimpleCoder

fn default() -> SimpleCoder

Returns the “default value” for a type.

impl SidecarCoder for SimpleCoder

fn finish(self, _builder: &mut PartialSidecar)

No-op

fn required_fe(&self, data: &[u8]) -> usize

Calculate the number of field elements required to store the given data.

fn code(&mut self, builder: &mut PartialSidecar, data: &[u8])

Code a slice of data into the builder.

fn decode_all(&mut self, blobs: &[Blob]) -> Option<Vec<Vec<u8>>>

Decode all slices of data from the blobs.

impl Copy for SimpleCoder