alcmy 0.1.1

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

//! Transaction Simulation API implementation

use super::types::*;
use crate::client::Client;
use crate::error::Result;

/// Simulation API for transaction simulation
pub struct SimulationApi<'a> {
    client: &'a Client,
}

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

    /// Simulate a transaction and return asset changes
    ///
    /// Shows what tokens/NFTs would be transferred, approved, etc.
    pub async fn simulate_asset_changes(
        &self,
        tx: &SimulationTransaction,
    ) -> Result<SimulateAssetChangesResponse> {
        self.client
            .rpc("alchemy_simulateAssetChanges", vec![tx])
            .await
    }

    /// Simulate a bundle of transactions and return asset changes
    ///
    /// Transactions are executed sequentially.
    pub async fn simulate_asset_changes_bundle(
        &self,
        txs: &[SimulationTransaction],
    ) -> Result<Vec<SimulateAssetChangesResponse>> {
        self.client
            .rpc("alchemy_simulateAssetChangesBundle", vec![txs])
            .await
    }

    /// Simulate execution with decoded traces and logs
    ///
    /// Returns detailed call traces with decoded function calls and events.
    pub async fn simulate_execution(
        &self,
        tx: &SimulationTransaction,
        format: ExecutionFormat,
        block_tag: &str,
    ) -> Result<SimulateExecutionResponse> {
        let params = serde_json::json!({
            "format": format,
            "transaction": tx,
            "blockTag": block_tag
        });
        self.client
            .rpc("alchemy_simulateExecution", vec![params])
            .await
    }

    /// Simulate execution with nested call format
    pub async fn simulate_execution_nested(
        &self,
        tx: &SimulationTransaction,
    ) -> Result<SimulateExecutionResponse> {
        self.simulate_execution(tx, ExecutionFormat::Nested, "latest")
            .await
    }

    /// Simulate execution with flat call format
    pub async fn simulate_execution_flat(
        &self,
        tx: &SimulationTransaction,
    ) -> Result<SimulateExecutionResponse> {
        self.simulate_execution(tx, ExecutionFormat::Flat, "latest")
            .await
    }

    /// Simulate a bundle with decoded execution traces
    pub async fn simulate_execution_bundle(
        &self,
        txs: &[SimulationTransaction],
    ) -> Result<Vec<SimulateExecutionResponse>> {
        self.client
            .rpc("alchemy_simulateExecutionBundle", vec![txs])
            .await
    }
}