Enum ShardError 

pub enum ShardError {
    EncodeFailed(String),
    DecodeFailed(String),
    ShardCodecFailed {
        index: u16,
        source: Error,
    },
    ShardHashMismatch {
        index: u16,
    },
    IndexOutOfRange {
        index: u16,
        total: u32,
    },
    DuplicateIndex {
        index: u16,
    },
    ManifestShardCountMismatch {
        actual: usize,
        expected: usize,
    },
    PackHashMismatch,
    InsufficientShards {
        provided: usize,
        minimum: u16,
    },
    InvalidManifestPrologue(&'static str),
    ManifestUnexpectedEof,
    ManifestTrailingBytes,
    ManifestZeroShardCount {
        minimum: u16,
        extra: u16,
    },
    ManifestTooLarge {
        actual: usize,
        max: usize,
    },
}

Errors produced by encode_pack_to_shards / decode_pack_from_shards.

Variants

EncodeFailed(String)

The Reed-Solomon encoder rejected the input. Typically means the pack is larger than u32::MAX bytes (commonware’s limit).

DecodeFailed(String)

The Reed-Solomon decoder rejected the supplied shards. Usually triggered by too few shards, duplicate indices, or a Merkle proof that no longer matches the commitment.

ShardCodecFailed

The codec layer could not parse a shard’s bytes. Means the shard envelope is malformed — distinct from a BLAKE3 mismatch.

Fields

index: u16

source: Error

ShardHashMismatch

A shard’s BLAKE3 hash does not match the manifest entry for its index. The shard is corrupt or maliciously substituted.

Fields

index: u16

IndexOutOfRange

Manifest claims an index outside 0..total_shards.

Fields

index: u16

total: u32

DuplicateIndex

Duplicate shard index supplied to the decoder.

Fields

index: u16

ManifestShardCountMismatch

Manifest carries the wrong number of shard_hashes for the declared config.

Fields

actual: usize

expected: usize

PackHashMismatch

Reconstruction produced bytes whose BLAKE3 does not match manifest.pack_hash. Cryptographically the manifest was forged.

InsufficientShards

Caller passed fewer than config.minimum_shards shards.

Fields

provided: usize

minimum: u16

InvalidManifestPrologue(&'static str)

The manifest wire bytes are shorter than the v0 prologue, do not begin with MANIFEST_MAGIC, or carry an unrecognised MANIFEST_VERSION.

ManifestUnexpectedEof

The manifest wire bytes are truncated — a length-prefixed field claims more bytes than remain in the buffer.

ManifestTrailingBytes

The manifest carries trailing bytes after the last expected field. Most likely a producer / consumer version mismatch.

ManifestZeroShardCount

The manifest declares a (minimum_shards, extra_shards) pair whose components are zero — illegal at the SPEC level.

Fields

minimum: u16

extra: u16

ManifestTooLarge

The manifest exceeds MANIFEST_MAX_BYTES.

Fields

actual: usize

max: usize

Trait Implementations

impl Debug for ShardError

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

Formats the value using the given formatter.

impl Display for ShardError

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

Formats the value using the given formatter.

impl Error for ShardError

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.