ensip25 0.4.0

Rust implementation of ENSIP-25: verify the link between ENS names and ERC-8004 AI agent registries.
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
57
58
59
60
61
62
63
64
65
66

//! Typed error definitions for the ENSIP-25 SDK.

/// The primary error type for all ENSIP-25 SDK operations.
#[derive(Debug, thiserror::Error)]
pub enum Ensip25Error {
    /// The input bytes are too short to contain a valid ERC-7930 header.
    #[error("erc7930: buffer too short (need at least 6 bytes, got {len})")]
    BufferTooShort {
        /// Actual byte length provided.
        len: usize,
    },

    /// The ERC-7930 version field is unsupported.
    #[error("erc7930: unsupported version {version:#06x}")]
    UnsupportedVersion {
        /// The version value found in the header.
        version: u16,
    },

    /// The declared lengths inside an ERC-7930 address exceed the buffer.
    #[error("erc7930: truncated payload (expected {expected} bytes, have {available})")]
    TruncatedPayload {
        /// Number of bytes the header says should follow.
        expected: usize,
        /// Number of bytes actually remaining.
        available: usize,
    },

    /// Both `ChainReferenceLength` and `AddressLength` are zero, which is
    /// invalid per ERC-7930.
    #[error("erc7930: both chain reference and address are empty")]
    EmptyAddress,

    /// A hex string could not be decoded.
    #[error("hex decode error: {0}")]
    Hex(#[from] alloy_primitives::hex::FromHexError),

    /// A field exceeds the 255-byte limit imposed by ERC-7930.
    #[error("erc7930: {field} length {len} exceeds 255")]
    FieldTooLong {
        /// Name of the field that is too long.
        field: &'static str,
        /// Actual length.
        len: usize,
    },

    /// An `agentId` contains forbidden characters (`[` or `]`).
    #[error("agent id must not contain '[' or ']': {agent_id:?}")]
    InvalidAgentId {
        /// The offending agent ID string.
        agent_id: String,
    },

    /// An ENS text-record lookup failed.
    #[cfg(feature = "provider")]
    #[error("ens error: {0}")]
    Ens(#[from] alloy_ens::EnsError),

    /// An ERC-8004 SDK error.
    #[cfg(feature = "erc8004")]
    #[error("erc8004 error: {0}")]
    Erc8004(#[from] erc8004::Error),
}

/// A convenience type alias used throughout the SDK.
pub type Result<T> = core::result::Result<T, Ensip25Error>;