Enum Error 

#[non_exhaustive]
pub enum Error {
    TreeFull {
        capacity: usize,
        attempted_index: usize,
    },
    InvalidProof,
    UnknownRoot,
    InvalidLength {
        expected: usize,
        actual: usize,
    },
    ParseError(String),
    FieldOverflow,
    InvalidTreeConfig(String),
    LeafIndexOutOfBounds {
        index: u32,
        tree_size: u32,
    },
}

All errors that can occur in stealth-lib operations.

This enum is #[non_exhaustive] to allow adding new variants in future minor versions without breaking semver compatibility.

Example

use stealth_lib::Error;

fn example() -> Result<(), Error> {
    Err(Error::TreeFull {
        capacity: 1048576,
        attempted_index: 1048576,
    })
}

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.

TreeFull

Merkle tree has reached maximum capacity.

This occurs when attempting to insert a leaf into a full tree. The tree capacity is 2^levels.

Fields

capacity: usize

Maximum number of leaves the tree can hold.

attempted_index: usize

The index that was attempted.

InvalidProof

Invalid Merkle proof.

The proof does not verify against the expected root.

UnknownRoot

Root not found in history.

The provided root hash is not in the tree’s root history buffer.

InvalidLength

Input data has invalid length.

Expected a specific number of bytes but received a different amount.

Fields

expected: usize

Expected length in bytes.

actual: usize

Actual length received.

ParseError(String)

Parsing failed.

Failed to parse input data (e.g., from string representation).

FieldOverflow

Arithmetic overflow in field operations.

An arithmetic operation would overflow the field modulus.

InvalidTreeConfig(String)

Invalid tree configuration.

The tree parameters are invalid (e.g., zero levels).

LeafIndexOutOfBounds

Leaf index out of bounds.

The requested leaf index does not exist in the tree.

Fields

index: u32

The requested index.

tree_size: u32

The current number of leaves in the tree.

Trait Implementations

impl From<SolanaError> for Error

fn from(err: SolanaError) -> Self

Converts to this type from the input type.

impl Clone for Error

fn clone(&self) -> Error

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

Available on crate feature std only.

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 PartialEq for Error

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Error

impl StructuralPartialEq for Error