alcmy 0.1.6

Unofficial Rust client for the Alchemy API
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
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89

//! Bundler API implementation (ERC-4337)

use super::types::{
    BundlerStateOverride, GasEstimation, UserOperation, UserOperationByHash, UserOperationReceipt,
};
use crate::client::Client;
use crate::error::Result;

/// Bundler API for ERC-4337 Account Abstraction
pub struct BundlerApi<'a> {
    client: &'a Client,
}

impl<'a> BundlerApi<'a> {
    pub(crate) fn new(client: &'a Client) -> Self {
        Self { client }
    }

    /// Get supported entry points
    pub async fn supported_entry_points(&self) -> Result<Vec<String>> {
        self.client.rpc("eth_supportedEntryPoints", ()).await
    }

    /// Send a `UserOperation`
    ///
    /// Returns the `UserOperation` hash.
    pub async fn send_user_operation(
        &self,
        user_op: &UserOperation,
        entry_point: &str,
    ) -> Result<String> {
        self.client
            .rpc("eth_sendUserOperation", (user_op, entry_point))
            .await
    }

    /// Estimate gas for a `UserOperation`
    pub async fn estimate_user_operation_gas(
        &self,
        user_op: &UserOperation,
        entry_point: &str,
    ) -> Result<GasEstimation> {
        self.client
            .rpc("eth_estimateUserOperationGas", (user_op, entry_point))
            .await
    }

    /// Estimate gas with state overrides
    pub async fn estimate_user_operation_gas_with_overrides(
        &self,
        user_op: &UserOperation,
        entry_point: &str,
        state_overrides: &std::collections::HashMap<String, BundlerStateOverride>,
    ) -> Result<GasEstimation> {
        self.client
            .rpc(
                "eth_estimateUserOperationGas",
                (user_op, entry_point, state_overrides),
            )
            .await
    }

    /// Get `UserOperation` by hash
    pub async fn get_user_operation_by_hash(
        &self,
        user_op_hash: &str,
    ) -> Result<Option<UserOperationByHash>> {
        self.client
            .rpc("eth_getUserOperationByHash", vec![user_op_hash])
            .await
    }

    /// Get `UserOperation` receipt
    pub async fn get_user_operation_receipt(
        &self,
        user_op_hash: &str,
    ) -> Result<Option<UserOperationReceipt>> {
        self.client
            .rpc("eth_getUserOperationReceipt", vec![user_op_hash])
            .await
    }

    /// Get recommended max priority fee per gas
    ///
    /// Alchemy-specific method for better fee estimation.
    pub async fn max_priority_fee_per_gas(&self) -> Result<String> {
        self.client.rpc("rundler_maxPriorityFeePerGas", ()).await
    }
}