Enum DecodeError 

#[non_exhaustive]
pub enum DecodeError {
    ChunkNotFound {
        meta: Meta,
    },
    ParentNotFound {
        node: TreeNode,
        meta: Meta,
    },
    LeafNotFound {
        num: ChunkNum,
        meta: Meta,
    },
    ParentHashMismatch {
        node: TreeNode,
        meta: Meta,
    },
    LeafHashMismatch {
        num: ChunkNum,
        meta: Meta,
    },
    Read {
        source: Error,
        meta: Meta,
    },
    Write {
        source: Error,
        meta: Meta,
    },
}

Decode error that you can get once you have sent the request and are decoding the response, e.g. from AtBlobContent::next.

This is similar to [bao_tree::io::DecodeError], but takes into account that we are reading from a RecvStream, so read errors will be propagated as DecodeError::Read, containing a io::Error.

When the provider finds that it does not have a chunk that we requested, or that the chunk is invalid, it will stop sending data without producing an error. This is indicated by either the DecodeError::ParentNotFound or DecodeError::LeafNotFound variant, which can be used to detect that data is missing but the connection as well that the provider is otherwise healthy.

The DecodeError::ParentHashMismatch and DecodeError::LeafHashMismatch variants indicate that the provider has sent us invalid data. A well-behaved provider should never do this, so this is an indication that the provider is not behaving correctly.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

ChunkNotFound

A chunk was not found or invalid, so the provider stopped sending data

Fields

meta: Meta

Captured call-site metadata

ParentNotFound

A parent was not found or invalid, so the provider stopped sending data

Fields

node: TreeNode

meta: Meta

Captured call-site metadata

LeafNotFound

A parent was not found or invalid, so the provider stopped sending data

Fields

num: ChunkNum

meta: Meta

Captured call-site metadata

ParentHashMismatch

The hash of a parent did not match the expected hash

Fields

node: TreeNode

meta: Meta

Captured call-site metadata

LeafHashMismatch

The hash of a leaf did not match the expected hash

Fields

num: ChunkNum

meta: Meta

Captured call-site metadata

Read

Error when reading from the stream

Fields

source: Error

meta: Meta

Captured call-site metadata

Write

A generic io error

Fields

source: Error

meta: Meta

Captured call-site metadata

Trait Implementations

impl Debug for DecodeError

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

Formats the value using the given formatter.

impl Display for DecodeError

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

Formats the value using the given formatter.

impl Error for DecodeError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<AtBlobHeaderNextError> for DecodeError

fn from(cause: AtBlobHeaderNextError) -> Self

Converts to this type from the input type.

impl From<DecodeError> for AnyError

fn from(value: DecodeError) -> AnyError

Converts to this type from the input type.

impl From<DecodeError> for DecodeError

fn from(value: DecodeError) -> Self

Converts to this type from the input type.

impl From<DecodeError> for Error

fn from(cause: DecodeError) -> Self

Converts to this type from the input type.

impl From<DecodeError> for GetError

fn from(source: DecodeError) -> Self

Converts to this type from the input type.

impl StackError for DecodeError

fn as_std(&self) -> &(dyn Error + Send + Sync + 'static)

Returns this error as a std error reference.

fn into_std(self: Box<Self>) -> Box<dyn Error + Send + Sync>

Returns this error as a std error.

fn as_dyn(&self) -> &dyn StackError

Returns this error as a dyn StackError.

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

Returns the next source in the chain, if any.

fn meta(&self) -> Option<&Meta>

Returns metadata captured at creation time, if available.

fn source(&self) -> Option<ErrorRef<'_>>

Returns the next source in the chain, if any.

fn is_transparent(&self) -> bool

Returns whether this error is transparent and should be skipped in reports.

fn as_ref(&self) -> ErrorRef<'_>

Returns this error as an [ErrorRef].

fn stack(&self) -> Chain<'_>

Returns an iterator over this error followed by its sources.

fn sources(&self) -> Chain<'_>

Returns an iterator over sources of this error (skipping self).

fn report(&self) -> Report<'_>

Returns a [Report] to output the error with configurable formatting.