Enum ssz::DecodeError

pub enum DecodeError {
    InvalidByteLength {
        len: usize,
        expected: usize,
    },
    InvalidLengthPrefix {
        len: usize,
        expected: usize,
    },
    OutOfBoundsByte {
        i: usize,
    },
    OffsetIntoFixedPortion(usize),
    OffsetSkipsVariableBytes(usize),
    OffsetsAreDecreasing(usize),
    OffsetOutOfBounds(usize),
    InvalidListFixedBytesLen(usize),
    ZeroLengthItem,
    BytesInvalid(String),
}

Returned when SSZ decoding fails.

Variants

InvalidByteLength

The bytes supplied were too short to be decoded into the specified type.

Fields of InvalidByteLength

len: usizeexpected: usize

InvalidLengthPrefix

The given bytes were too short to be read as a length prefix.

Fields of InvalidLengthPrefix

len: usizeexpected: usize

OutOfBoundsByte

A length offset pointed to a byte that was out-of-bounds (OOB).

A bytes may be OOB for the following reasons:

• It is >= bytes.len().
• When decoding variable length items, the 1st offset points “backwards” into the fixed length items (i.e., length[0] < BYTES_PER_LENGTH_OFFSET).
• When decoding variable-length items, the n’th offset was less than the n-1’th offset.

Fields of OutOfBoundsByte

i: usize

OffsetIntoFixedPortion

An offset points “backwards” into the fixed-bytes portion of the message, essentially double-decoding bytes that will also be decoded as fixed-length.

https://notes.ethereum.org/ruKvDXl6QOW3gnqVYb8ezA?view#1-Offset-into-fixed-portion

Tuple Fields of OffsetIntoFixedPortion

0: usize

OffsetSkipsVariableBytes

The first offset does not point to the byte that follows the fixed byte portion, essentially skipping a variable-length byte.

https://notes.ethereum.org/ruKvDXl6QOW3gnqVYb8ezA?view#2-Skip-first-variable-byte

Tuple Fields of OffsetSkipsVariableBytes

0: usize

OffsetsAreDecreasing

An offset points to bytes prior to the previous offset. Depending on how you look at it, this either double-decodes bytes or makes the first offset a negative-length.

https://notes.ethereum.org/ruKvDXl6QOW3gnqVYb8ezA?view#3-Offsets-are-decreasing

Tuple Fields of OffsetsAreDecreasing

0: usize

OffsetOutOfBounds

An offset references byte indices that do not exist in the source bytes.

https://notes.ethereum.org/ruKvDXl6QOW3gnqVYb8ezA?view#4-Offsets-are-out-of-bounds

Tuple Fields of OffsetOutOfBounds

0: usize

InvalidListFixedBytesLen

A variable-length list does not have a fixed portion that is cleanly divisible by BYTES_PER_LENGTH_OFFSET.

Tuple Fields of InvalidListFixedBytesLen

0: usize

ZeroLengthItem

Some item has a ssz_fixed_len of zero. This is illegal.

BytesInvalid

The given bytes were invalid for some application-level reason.

Tuple Fields of BytesInvalid

0: String

Trait Implementations

impl Clone for DecodeError

fn clone(&self) -> DecodeError

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for DecodeError

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

Formats the value using the given formatter.

impl PartialEq<DecodeError> for DecodeError

fn eq(&self, other: &DecodeError) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &DecodeError) -> bool

This method tests for !=.

impl StructuralPartialEq for DecodeError