alcmy 0.1.4

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
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104

//! Debug API implementation

use super::types::{BlockTrace, CallFrame, TraceCallObject, TraceCallOptions, TracerOptions};
use crate::client::Client;
use crate::error::Result;

/// Debug API for transaction and block tracing
pub struct DebugApi<'a> {
    client: &'a Client,
}

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

    /// Trace a transaction by hash
    ///
    /// Returns detailed execution trace of the transaction.
    pub async fn trace_transaction(&self, tx_hash: &str) -> Result<CallFrame> {
        self.trace_transaction_with_options(tx_hash, TracerOptions::call_tracer())
            .await
    }

    /// Trace a transaction with custom options
    pub async fn trace_transaction_with_options(
        &self,
        tx_hash: &str,
        options: TracerOptions,
    ) -> Result<CallFrame> {
        self.client
            .rpc("debug_traceTransaction", (tx_hash, options))
            .await
    }

    /// Trace a call without executing it on-chain
    ///
    /// Executes a call in the context of a specific block.
    pub async fn trace_call(&self, call: &TraceCallObject, block: &str) -> Result<CallFrame> {
        self.trace_call_with_options(call, block, TraceCallOptions::default())
            .await
    }

    /// Trace a call with custom options
    pub async fn trace_call_with_options(
        &self,
        call: &TraceCallObject,
        block: &str,
        options: TraceCallOptions,
    ) -> Result<CallFrame> {
        self.client
            .rpc("debug_traceCall", (call, block, options))
            .await
    }

    /// Trace all transactions in a block by hash
    pub async fn trace_block_by_hash(&self, block_hash: &str) -> Result<Vec<BlockTrace>> {
        self.trace_block_by_hash_with_options(block_hash, TracerOptions::call_tracer())
            .await
    }

    /// Trace all transactions in a block by hash with options
    pub async fn trace_block_by_hash_with_options(
        &self,
        block_hash: &str,
        options: TracerOptions,
    ) -> Result<Vec<BlockTrace>> {
        self.client
            .rpc("debug_traceBlockByHash", (block_hash, options))
            .await
    }

    /// Trace all transactions in a block by number
    pub async fn trace_block_by_number(&self, block_number: &str) -> Result<Vec<BlockTrace>> {
        self.trace_block_by_number_with_options(block_number, TracerOptions::call_tracer())
            .await
    }

    /// Trace all transactions in a block by number with options
    pub async fn trace_block_by_number_with_options(
        &self,
        block_number: &str,
        options: TracerOptions,
    ) -> Result<Vec<BlockTrace>> {
        self.client
            .rpc("debug_traceBlockByNumber", (block_number, options))
            .await
    }

    /// Get RLP-encoded block
    pub async fn get_raw_block(&self, block: &str) -> Result<String> {
        self.client.rpc("debug_getRawBlock", vec![block]).await
    }

    /// Get RLP-encoded block header
    pub async fn get_raw_header(&self, block: &str) -> Result<String> {
        self.client.rpc("debug_getRawHeader", vec![block]).await
    }

    /// Get EIP-2718 binary-encoded receipts
    pub async fn get_raw_receipts(&self, block: &str) -> Result<Vec<String>> {
        self.client.rpc("debug_getRawReceipts", vec![block]).await
    }
}