ubt 0.3.0

Unified Binary Tree implementation based on EIP-7864
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

//! Error types for the UBT crate.

use alloy_primitives::B256;
use thiserror::Error;

use crate::Stem;

/// Errors that can occur during UBT operations.
#[derive(Debug, Error)]
pub enum UbtError {
    /// Key not found in tree
    #[error("key not found: {0}")]
    KeyNotFound(B256),

    /// Invalid stem length
    #[error("invalid stem length: expected 31 bytes, got {0}")]
    InvalidStemLength(usize),

    /// Invalid key length
    #[error("invalid key length: expected 32 bytes, got {0}")]
    InvalidKeyLength(usize),

    /// Tree depth exceeded maximum allowed depth.
    #[error("tree depth exceeded maximum allowed depth (depth={depth})")]
    TreeDepthExceeded { depth: usize },

    /// Stem collision during insertion (should not happen with proper key derivation)
    #[error("stem collision at {0:?}")]
    StemCollision(Stem),

    /// Invalid proof
    #[error("invalid proof: {0}")]
    InvalidProof(String),

    /// Code too large
    #[error("code size {0} exceeds maximum allowed size")]
    CodeTooLarge(usize),

    /// Invalid code chunk
    #[error("invalid code chunk at index {0}")]
    InvalidCodeChunk(usize),

    /// Account not found
    #[error("account not found: {0}")]
    AccountNotFound(alloy_primitives::Address),

    /// Storage slot not found
    #[error("storage slot {slot} not found for account {account}")]
    StorageNotFound {
        account: alloy_primitives::Address,
        slot: alloy_primitives::U256,
    },
}

/// Result type alias for UBT operations.
pub type Result<T> = std::result::Result<T, UbtError>;