propamm 1.0.0

Rust SDK for the PropAMM Router contract: typed calls, eth_call overrides, and ABI codec over JSON-RPC
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

use ethrex_common::H256;
use thiserror::Error;

use crate::client::TransactionReceipt;

#[derive(Debug, Error)]
pub enum Error {
    /// JSON-RPC client failure (transport, node errors, tx building/sending).
    #[error("rpc client error: {0}")]
    Client(#[from] ethrex_rpc::clients::EthClientError),

    /// An `eth_call` reverted. `data` carries the raw revert payload when the
    /// node provided one (the router bindings decode it into named errors).
    #[error("call reverted: {message}")]
    Revert {
        message: String,
        data: Option<Vec<u8>>,
    },

    /// A mined transaction reverted on-chain. Carries the receipt so callers
    /// can inspect status, gas, and logs without another RPC round-trip.
    #[error("transaction {hash:#x} reverted")]
    TransactionReverted {
        hash: H256,
        receipt: Box<TransactionReceipt>,
    },

    /// A mined, successful transaction emitted no expected event (e.g. a swap
    /// with no `Swapped` log — usually the wrong router address or ABI drift).
    #[error("transaction {hash:#x} emitted no {event} event")]
    MissingEvent { hash: H256, event: &'static str },

    /// ABI encoding/decoding failure.
    #[error("abi error: {0}")]
    Abi(String),

    /// Failure while fetching or parsing pAMM state overrides.
    #[error("overrides error: {0}")]
    Overrides(String),

    /// An operation did not complete within its deadline.
    #[error("timeout: {0}")]
    Timeout(String),

    /// Invalid caller-supplied input (addresses, fee bounds, keys, URLs, ...).
    #[error("invalid input: {0}")]
    InvalidInput(String),
}

pub type Result<T> = std::result::Result<T, Error>;