Trait TailCodec 

pub trait TailCodec: Sized {
    const MAX_ENCODED_LEN: usize;

    // Required methods
    fn encode(&self, out: &mut [u8]) -> Result<usize, ProgramError>;
    fn decode(input: &[u8]) -> Result<(Self, usize), ProgramError>;
}

Canonical serializer for dynamic-tail payloads.

Implementations encode into a caller-provided buffer and decode from a caller-provided slice, returning the byte count consumed in both directions. Byte counts drive the length-prefix handling inside #[hopper::state]’s generated tail accessors. the encoding must be deterministic and bidirectional.

Required Associated Constants

const MAX_ENCODED_LEN: usize

Upper bound on the encoded size. Used by generated helpers to verify the account has enough room before invoking encode. Implementors should pick the smallest valid bound. Hopper uses this to pre-size reallocs.

Required Methods

fn encode(&self, out: &mut [u8]) -> Result<usize, ProgramError>

Serialize self into out. Returns the number of bytes written (always <= MAX_ENCODED_LEN). Fails with AccountDataTooSmall when out.len() < encoded_len.

fn decode(input: &[u8]) -> Result<(Self, usize), ProgramError>

Deserialize from input. Returns (value, bytes_consumed). Fails with InvalidAccountData on malformed encoding.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementations on Foreign Types

impl TailCodec for bool

const MAX_ENCODED_LEN: usize = 1

fn encode(&self, out: &mut [u8]) -> Result<usize, ProgramError>

fn decode(input: &[u8]) -> Result<(Self, usize), ProgramError>

impl TailCodec for i16

const MAX_ENCODED_LEN: usize = 2

fn encode(&self, out: &mut [u8]) -> Result<usize, ProgramError>

fn decode(input: &[u8]) -> Result<(Self, usize), ProgramError>

impl TailCodec for i32

const MAX_ENCODED_LEN: usize = 4

fn encode(&self, out: &mut [u8]) -> Result<usize, ProgramError>

fn decode(input: &[u8]) -> Result<(Self, usize), ProgramError>

impl TailCodec for i64

const MAX_ENCODED_LEN: usize = 8

fn encode(&self, out: &mut [u8]) -> Result<usize, ProgramError>

fn decode(input: &[u8]) -> Result<(Self, usize), ProgramError>

impl TailCodec for i128

const MAX_ENCODED_LEN: usize = 16

fn encode(&self, out: &mut [u8]) -> Result<usize, ProgramError>

fn decode(input: &[u8]) -> Result<(Self, usize), ProgramError>

impl TailCodec for u8

const MAX_ENCODED_LEN: usize = 1

fn encode(&self, out: &mut [u8]) -> Result<usize, ProgramError>

fn decode(input: &[u8]) -> Result<(Self, usize), ProgramError>

impl TailCodec for u16

const MAX_ENCODED_LEN: usize = 2

fn encode(&self, out: &mut [u8]) -> Result<usize, ProgramError>

fn decode(input: &[u8]) -> Result<(Self, usize), ProgramError>

impl TailCodec for u32

const MAX_ENCODED_LEN: usize = 4

fn encode(&self, out: &mut [u8]) -> Result<usize, ProgramError>

fn decode(input: &[u8]) -> Result<(Self, usize), ProgramError>

impl TailCodec for u64

const MAX_ENCODED_LEN: usize = 8

fn encode(&self, out: &mut [u8]) -> Result<usize, ProgramError>

fn decode(input: &[u8]) -> Result<(Self, usize), ProgramError>

impl TailCodec for u128

const MAX_ENCODED_LEN: usize = 16

fn encode(&self, out: &mut [u8]) -> Result<usize, ProgramError>

fn decode(input: &[u8]) -> Result<(Self, usize), ProgramError>

impl<T: TailCodec> TailCodec for Option<T>

const MAX_ENCODED_LEN: usize

fn encode(&self, out: &mut [u8]) -> Result<usize, ProgramError>

fn decode(input: &[u8]) -> Result<(Self, usize), ProgramError>

impl<const N: usize> TailCodec for [u8; N]

const MAX_ENCODED_LEN: usize = N

fn encode(&self, out: &mut [u8]) -> Result<usize, ProgramError>

fn decode(input: &[u8]) -> Result<(Self, usize), ProgramError>

Implementors