Trait Compact

pub trait Compact: Sized {
    // Required methods
    fn to_compact<B>(&self, buf: &mut B) -> usize
       where B: BufMut + AsMut<[u8]>;
    fn from_compact(buf: &[u8], len: usize) -> (Self, &[u8]);

    // Provided methods
    fn specialized_to_compact<B>(&self, buf: &mut B) -> usize
       where B: BufMut + AsMut<[u8]> { ... }
    fn specialized_from_compact(buf: &[u8], len: usize) -> (Self, &[u8]) { ... }
}

Trait that implements the Compact codec.

When deriving the trait for custom structs, be aware of certain limitations/recommendations:

• Works best with structs that only have native types (eg. u64, B256, U256).
• Fixed array types (B256, Address, Bloom) are not compacted.
• Max size of T in Option<T> or Vec<T> shouldn’t exceed 0xffff.
• Any Bytes field should be placed last.
• Any other type which is not known to the derive module should be placed last in they contain a Bytes field.

The last two points make it easier to decode the data without saving the length on the StructFlags. It will fail compilation if it’s not respected. If they’re alias to known types, add their definitions to get_bit_size() or known_types in generator.rs.

Regarding the specialized_to/from_compact methods: Mainly used as a workaround for not being able to specialize an impl over certain types like Vec<T>/Option<T> where T is a fixed size array like Vec<B256>.

Caution

Due to the bitfields, every type change on the rust type (e.g. U256 to u64) is a breaking change and will lead to a new, incompatible Compact implementation. Implementers must take special care when changing or rearranging fields.

Required Methods

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

Takes a buffer which can be written to. Ideally, it returns the length written to.

fn from_compact(buf: &[u8], len: usize) -> (Self, &[u8])

Takes a buffer which can be read from. Returns the object and buf with its internal cursor advanced (eg..advance(len)).

len can either be the buf remaining length, or the length of the compacted type.

It will panic, if len is smaller than buf.len().

Provided Methods

fn specialized_to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

“Optional”: If there’s no good reason to use it, don’t.

fn specialized_from_compact(buf: &[u8], len: usize) -> (Self, &[u8])

“Optional”: If there’s no good reason to use it, don’t.

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 Compact for bool

fn to_compact<B>(&self, _: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

bool vars go directly to the StructFlags and are not written to the buffer.

fn from_compact(buf: &[u8], len: usize) -> (Self, &[u8])

bool expects the real value to come in len, and does not advance the cursor.

impl Compact for u8

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

fn from_compact(buf: &[u8], len: usize) -> (Self, &[u8])

impl Compact for u64

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

fn from_compact(buf: &[u8], len: usize) -> (Self, &[u8])

impl Compact for u128

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

fn from_compact(buf: &[u8], len: usize) -> (Self, &[u8])

impl Compact for String

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

fn from_compact(buf: &[u8], len: usize) -> (Self, &[u8])

impl Compact for AccessList

Available on crate feature test-utils only.

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

fn from_compact(buf: &[u8], _: usize) -> (Self, &[u8])

impl Compact for AccessListItem

Available on crate feature test-utils only.

Implement Compact for AccessListItem and AccessList.

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

fn from_compact(buf: &[u8], _: usize) -> (Self, &[u8])

impl Compact for Address

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

fn from_compact(buf: &[u8], len: usize) -> (Self, &[u8])

impl Compact for Authorization

Available on crate feature test-utils only.

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

fn from_compact(buf: &[u8], len: usize) -> (Self, &[u8])

impl Compact for Bloom

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

fn from_compact(buf: &[u8], len: usize) -> (Self, &[u8])

impl Compact for BranchNodeCompact

Available on crate feature test-utils only.

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

fn from_compact(buf: &[u8], _len: usize) -> (Self, &[u8])

impl Compact for Bytes

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

fn from_compact(buf: &[u8], len: usize) -> (Self, &[u8])

impl Compact for GenesisAccount

Available on crate feature test-utils only.

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

fn from_compact(buf: &[u8], len: usize) -> (Self, &[u8])

impl Compact for HashBuilderValue

Available on crate feature test-utils only.

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

fn from_compact(buf: &[u8], _: usize) -> (Self, &[u8])

impl Compact for Header

Available on crate feature test-utils only.

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

fn from_compact(buf: &[u8], len: usize) -> (Self, &[u8])

impl Compact for Log

Available on crate feature test-utils only.

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

fn from_compact(buf: &[u8], _: usize) -> (Self, &[u8])

impl Compact for LogData

Available on crate feature test-utils only.

Implement Compact for LogData and Log.

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

fn from_compact(buf: &[u8], _: usize) -> (Self, &[u8])

impl Compact for PrimitiveSignature

Available on crate feature test-utils only.

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

fn from_compact(buf: &[u8], identifier: usize) -> (Self, &[u8])

impl Compact for SignedAuthorization

Available on crate feature test-utils only.

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

fn from_compact(buf: &[u8], len: usize) -> (Self, &[u8])

impl Compact for TrieMask

Available on crate feature test-utils only.

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

fn from_compact(buf: &[u8], _len: usize) -> (Self, &[u8])

impl Compact for TxDeposit

Available on crate features test-utils and optimism only.

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

fn from_compact(buf: &[u8], len: usize) -> (Self, &[u8])

impl Compact for TxEip1559

Available on crate feature test-utils only.

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

fn from_compact(buf: &[u8], len: usize) -> (Self, &[u8])

impl Compact for TxEip2930

Available on crate feature test-utils only.

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

fn from_compact(buf: &[u8], len: usize) -> (Self, &[u8])

impl Compact for TxEip4844

Available on crate feature test-utils only.

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

fn from_compact(buf: &[u8], len: usize) -> (Self, &[u8])

impl Compact for TxEip7702

Available on crate feature test-utils only.

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

fn from_compact(buf: &[u8], len: usize) -> (Self, &[u8])

impl Compact for TxKind

Available on crate feature test-utils only.

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

fn from_compact(buf: &[u8], identifier: usize) -> (Self, &[u8])

impl Compact for TxLegacy

Available on crate feature test-utils only.

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

fn from_compact(buf: &[u8], len: usize) -> (Self, &[u8])

impl Compact for U256

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

fn from_compact(buf: &[u8], len: usize) -> (Self, &[u8])

impl Compact for Withdrawal

Available on crate feature test-utils only.

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

fn from_compact(buf: &[u8], len: usize) -> (Self, &[u8])

impl Compact for Withdrawals

Available on crate feature test-utils only.

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

fn from_compact(buf: &[u8], _: usize) -> (Self, &[u8])

impl<T> Compact for &[T]

where T: Compact,

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

Returns 0 since we won’t include it in the StructFlags.

fn specialized_to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

To be used by fixed sized types like &[B256].

fn from_compact(_: &[u8], _: usize) -> (Self, &[u8])

fn specialized_from_compact(_: &[u8], _: usize) -> (Self, &[u8])

impl<T> Compact for Option<T>

where T: Compact,

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

Returns 0 for None and 1 for Some(_).

fn specialized_to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

To be used by fixed sized types like Option<B256>.

fn specialized_from_compact(buf: &[u8], len: usize) -> (Self, &[u8])

To be used by fixed sized types like Option<B256>.

fn from_compact(buf: &[u8], len: usize) -> (Self, &[u8])

impl<T> Compact for Vec<T>

where T: Compact,

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

Returns 0 since we won’t include it in the StructFlags.

fn specialized_to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

To be used by fixed sized types like Vec<B256>.

fn specialized_from_compact(buf: &[u8], len: usize) -> (Self, &[u8])

To be used by fixed sized types like Vec<B256>.

fn from_compact(buf: &[u8], _: usize) -> (Self, &[u8])

impl<T: Compact> Compact for &T

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

fn from_compact(_: &[u8], _: usize) -> (Self, &[u8])

impl<const N: usize> Compact for FixedBytes<N>

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

fn from_compact(buf: &[u8], len: usize) -> (Self, &[u8])

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

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

fn from_compact(buf: &[u8], len: usize) -> (Self, &[u8])

Implementors

impl Compact for reth_codecs::alloy::authorization_list::Authorization

Available on crate feature test-utils only.

impl Compact for reth_codecs::alloy::genesis_account::GenesisAccount

Available on crate feature test-utils only.

impl Compact for reth_codecs::alloy::header::Header

Available on crate feature test-utils only.

impl Compact for HeaderExt

Available on crate feature test-utils only.

impl Compact for reth_codecs::alloy::transaction::eip1559::TxEip1559

Available on crate feature test-utils only.

impl Compact for reth_codecs::alloy::transaction::eip2930::TxEip2930

Available on crate feature test-utils only.

impl Compact for reth_codecs::alloy::transaction::eip4844::TxEip4844

Available on crate feature test-utils only.

impl Compact for reth_codecs::alloy::transaction::eip7702::TxEip7702

Available on crate feature test-utils only.

impl Compact for reth_codecs::alloy::transaction::legacy::TxLegacy

Available on crate feature test-utils only.

impl Compact for reth_codecs::alloy::transaction::optimism::TxDeposit

Available on crate features test-utils and optimism only.

impl Compact for reth_codecs::alloy::withdrawal::Withdrawal

Available on crate feature test-utils only.

impl Compact for CompactPlaceholder