zerodev-aa 0.0.1-alpha.1

ERC-4337 smart account SDK for Rust — prebuilt native libraries, zero setup
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
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114

use std::ffi::CStr;
use thiserror::Error;

use crate::ffi;

pub type Result<T> = core::result::Result<T, AaError>;

#[derive(Debug, Clone, PartialEq, Eq, Error)]
#[non_exhaustive]
pub enum AaError {
    #[error("null output pointer (code 1)")]
    NullOutPtr,
    #[error("invalid URL (code 2)")]
    InvalidUrl,
    #[error("out of memory (code 3)")]
    OutOfMemory,
    #[error("invalid private key (code 4)")]
    InvalidPrivateKey,
    #[error("invalid kernel version (code 5)")]
    InvalidKernelVersion,
    #[error("null context (code 6)")]
    NullContext,
    #[error("null account (code 7)")]
    NullAccount,
    #[error("null userop (code 8)")]
    NullUserOp,
    #[error("get address failed: {0}")]
    GetAddressFailed(String),
    #[error("build userop failed: {0}")]
    BuildUserOpFailed(String),
    #[error("hash userop failed: {0}")]
    HashUserOpFailed(String),
    #[error("sign userop failed: {0}")]
    SignUserOpFailed(String),
    #[error("send userop failed: {0}")]
    SendUserOpFailed(String),
    #[error("estimate gas failed: {0}")]
    EstimateGasFailed(String),
    #[error("paymaster failed: {0}")]
    PaymasterFailed(String),
    #[error("no calls provided (code 16)")]
    NoCalls,
    #[error("invalid hex (code 17)")]
    InvalidHex,
    #[error("apply JSON failed: {0}")]
    ApplyJsonFailed(String),
    #[error("serialize failed: {0}")]
    SerializeFailed(String),
    #[error("no gas middleware set (code 20)")]
    NoGasMiddleware,
    #[error("no paymaster middleware set (code 21)")]
    NoPaymasterMiddleware,
    #[error("receipt polling timed out: {0}")]
    ReceiptTimeout(String),
    #[error("receipt polling failed: {0}")]
    ReceiptFailed(String),
    #[error("invalid signer (code 24)")]
    InvalidSigner,
    #[error("unknown error (code {0}): {1}")]
    Unknown(i32, String),
}

/// Read the thread-local error message from the C library.
fn last_error_message() -> String {
    unsafe {
        let ptr = ffi::aa_get_last_error();
        if ptr.is_null() {
            return String::new();
        }
        CStr::from_ptr(ptr).to_string_lossy().into_owned()
    }
}

/// Convert a non-OK aa_status code into an AaError, pulling the detail string
/// from aa_get_last_error() for codes that typically carry one.
pub(crate) fn from_status(code: ffi::aa_status) -> AaError {
    let msg = last_error_message();
    match code {
        1 => AaError::NullOutPtr,
        2 => AaError::InvalidUrl,
        3 => AaError::OutOfMemory,
        4 => AaError::InvalidPrivateKey,
        5 => AaError::InvalidKernelVersion,
        6 => AaError::NullContext,
        7 => AaError::NullAccount,
        8 => AaError::NullUserOp,
        9 => AaError::GetAddressFailed(msg),
        10 => AaError::BuildUserOpFailed(msg),
        11 => AaError::HashUserOpFailed(msg),
        12 => AaError::SignUserOpFailed(msg),
        13 => AaError::SendUserOpFailed(msg),
        14 => AaError::EstimateGasFailed(msg),
        15 => AaError::PaymasterFailed(msg),
        16 => AaError::NoCalls,
        17 => AaError::InvalidHex,
        18 => AaError::ApplyJsonFailed(msg),
        19 => AaError::SerializeFailed(msg),
        20 => AaError::NoGasMiddleware,
        21 => AaError::NoPaymasterMiddleware,
        22 => AaError::ReceiptTimeout(msg),
        23 => AaError::ReceiptFailed(msg),
        24 => AaError::InvalidSigner,
        other => AaError::Unknown(other, msg),
    }
}

/// Check an aa_status code, returning Ok(()) or an appropriate error.
pub(crate) fn check(code: ffi::aa_status) -> Result<()> {
    if code == ffi::AA_OK {
        Ok(())
    } else {
        Err(from_status(code))
    }
}