pub struct TraceApi<Provider, Eth> { /* private fields */ }
Expand description
trace
API implementation.
This type provides the functionality for handling trace
related requests.
Implementations§
source§impl<Provider, Eth> TraceApi<Provider, Eth>where
Provider: BlockReader + StateProviderFactory + EvmEnvProvider + ChainSpecProvider<ChainSpec = ChainSpec> + 'static,
Eth: TraceExt + 'static,
impl<Provider, Eth> TraceApi<Provider, Eth>where
Provider: BlockReader + StateProviderFactory + EvmEnvProvider + ChainSpecProvider<ChainSpec = ChainSpec> + 'static,
Eth: TraceExt + 'static,
sourcepub async fn trace_call(
&self,
trace_request: TraceCallRequest,
) -> Result<TraceResults, Eth::Error>
pub async fn trace_call( &self, trace_request: TraceCallRequest, ) -> Result<TraceResults, Eth::Error>
Executes the given call and returns a number of possible traces for it.
sourcepub async fn trace_raw_transaction(
&self,
tx: Bytes,
trace_types: HashSet<TraceType>,
block_id: Option<BlockId>,
) -> Result<TraceResults, Eth::Error>
pub async fn trace_raw_transaction( &self, tx: Bytes, trace_types: HashSet<TraceType>, block_id: Option<BlockId>, ) -> Result<TraceResults, Eth::Error>
Traces a call to eth_sendRawTransaction
without making the call, returning the traces.
sourcepub async fn trace_call_many(
&self,
calls: Vec<(TransactionRequest, HashSet<TraceType>)>,
block_id: Option<BlockId>,
) -> Result<Vec<TraceResults>, Eth::Error>
pub async fn trace_call_many( &self, calls: Vec<(TransactionRequest, HashSet<TraceType>)>, block_id: Option<BlockId>, ) -> Result<Vec<TraceResults>, Eth::Error>
Performs multiple call traces on top of the same block. i.e. transaction n will be executed on top of a pending block with all n-1 transactions applied (traced) first.
Note: Allows tracing dependent transactions, hence all transactions are traced in sequence
sourcepub async fn replay_transaction(
&self,
hash: B256,
trace_types: HashSet<TraceType>,
) -> Result<TraceResults, Eth::Error>
pub async fn replay_transaction( &self, hash: B256, trace_types: HashSet<TraceType>, ) -> Result<TraceResults, Eth::Error>
Replays a transaction, returning the traces.
sourcepub async fn trace_get(
&self,
hash: B256,
indices: Vec<usize>,
) -> Result<Option<LocalizedTransactionTrace>, Eth::Error>
pub async fn trace_get( &self, hash: B256, indices: Vec<usize>, ) -> Result<Option<LocalizedTransactionTrace>, Eth::Error>
Returns transaction trace objects at the given index
Note: For compatibility reasons this only supports 1 single index, since this method is supposed to return a single trace. See also: https://github.com/ledgerwatch/erigon/blob/862faf054b8a0fa15962a9c73839b619886101eb/turbo/jsonrpc/trace_filtering.go#L114-L133
This returns None
if indices
is empty
sourcepub async fn trace_get_index(
&self,
hash: B256,
index: usize,
) -> Result<Option<LocalizedTransactionTrace>, Eth::Error>
pub async fn trace_get_index( &self, hash: B256, index: usize, ) -> Result<Option<LocalizedTransactionTrace>, Eth::Error>
Returns transaction trace object at the given index.
Returns None
if the trace object at that index does not exist
sourcepub async fn trace_filter(
&self,
filter: TraceFilter,
) -> Result<Vec<LocalizedTransactionTrace>, Eth::Error>
pub async fn trace_filter( &self, filter: TraceFilter, ) -> Result<Vec<LocalizedTransactionTrace>, Eth::Error>
Returns all transaction traces that match the given filter.
This is similar to Self::trace_block
but only returns traces for transactions that match
the filter.
sourcepub async fn trace_transaction(
&self,
hash: B256,
) -> Result<Option<Vec<LocalizedTransactionTrace>>, Eth::Error>
pub async fn trace_transaction( &self, hash: B256, ) -> Result<Option<Vec<LocalizedTransactionTrace>>, Eth::Error>
Returns all traces for the given transaction hash
sourcepub async fn trace_block(
&self,
block_id: BlockId,
) -> Result<Option<Vec<LocalizedTransactionTrace>>, Eth::Error>
pub async fn trace_block( &self, block_id: BlockId, ) -> Result<Option<Vec<LocalizedTransactionTrace>>, Eth::Error>
Returns traces created at given block.
sourcepub async fn replay_block_transactions(
&self,
block_id: BlockId,
trace_types: HashSet<TraceType>,
) -> Result<Option<Vec<TraceResultsWithTransactionHash>>, Eth::Error>
pub async fn replay_block_transactions( &self, block_id: BlockId, trace_types: HashSet<TraceType>, ) -> Result<Option<Vec<TraceResultsWithTransactionHash>>, Eth::Error>
Replays all transactions in a block
sourcepub async fn trace_transaction_opcode_gas(
&self,
tx_hash: B256,
) -> Result<Option<TransactionOpcodeGas>, Eth::Error>
pub async fn trace_transaction_opcode_gas( &self, tx_hash: B256, ) -> Result<Option<TransactionOpcodeGas>, Eth::Error>
Returns all opcodes with their count and combined gas usage for the given transaction in no particular order.
sourcepub async fn trace_block_opcode_gas(
&self,
block_id: BlockId,
) -> Result<Option<BlockOpcodeGas>, Eth::Error>
pub async fn trace_block_opcode_gas( &self, block_id: BlockId, ) -> Result<Option<BlockOpcodeGas>, Eth::Error>
Returns the opcodes of all transactions in the given block.
This is the same as Self::trace_transaction_opcode_gas
but for all transactions in a
block.
Trait Implementations§
source§impl<Provider, Eth> TraceApiServer for TraceApi<Provider, Eth>where
Provider: BlockReader + StateProviderFactory + EvmEnvProvider + ChainSpecProvider<ChainSpec = ChainSpec> + 'static,
Eth: TraceExt + 'static,
impl<Provider, Eth> TraceApiServer for TraceApi<Provider, Eth>where
Provider: BlockReader + StateProviderFactory + EvmEnvProvider + ChainSpecProvider<ChainSpec = ChainSpec> + 'static,
Eth: TraceExt + 'static,
source§fn trace_call<'life0, 'async_trait>(
&'life0 self,
call: TransactionRequest,
trace_types: HashSet<TraceType>,
block_id: Option<BlockId>,
state_overrides: Option<StateOverride>,
block_overrides: Option<Box<BlockOverrides>>,
) -> Pin<Box<dyn Future<Output = RpcResult<TraceResults>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
fn trace_call<'life0, 'async_trait>(
&'life0 self,
call: TransactionRequest,
trace_types: HashSet<TraceType>,
block_id: Option<BlockId>,
state_overrides: Option<StateOverride>,
block_overrides: Option<Box<BlockOverrides>>,
) -> Pin<Box<dyn Future<Output = RpcResult<TraceResults>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
Executes the given call and returns a number of possible traces for it.
Handler for trace_call
source§fn trace_call_many<'life0, 'async_trait>(
&'life0 self,
calls: Vec<(TransactionRequest, HashSet<TraceType>)>,
block_id: Option<BlockId>,
) -> Pin<Box<dyn Future<Output = RpcResult<Vec<TraceResults>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
fn trace_call_many<'life0, 'async_trait>(
&'life0 self,
calls: Vec<(TransactionRequest, HashSet<TraceType>)>,
block_id: Option<BlockId>,
) -> Pin<Box<dyn Future<Output = RpcResult<Vec<TraceResults>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
Handler for trace_callMany
source§fn trace_raw_transaction<'life0, 'async_trait>(
&'life0 self,
data: Bytes,
trace_types: HashSet<TraceType>,
block_id: Option<BlockId>,
) -> Pin<Box<dyn Future<Output = RpcResult<TraceResults>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
fn trace_raw_transaction<'life0, 'async_trait>(
&'life0 self,
data: Bytes,
trace_types: HashSet<TraceType>,
block_id: Option<BlockId>,
) -> Pin<Box<dyn Future<Output = RpcResult<TraceResults>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
Handler for trace_rawTransaction
source§fn replay_block_transactions<'life0, 'async_trait>(
&'life0 self,
block_id: BlockId,
trace_types: HashSet<TraceType>,
) -> Pin<Box<dyn Future<Output = RpcResult<Option<Vec<TraceResultsWithTransactionHash>>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
fn replay_block_transactions<'life0, 'async_trait>(
&'life0 self,
block_id: BlockId,
trace_types: HashSet<TraceType>,
) -> Pin<Box<dyn Future<Output = RpcResult<Option<Vec<TraceResultsWithTransactionHash>>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
Handler for trace_replayBlockTransactions
source§fn replay_transaction<'life0, 'async_trait>(
&'life0 self,
transaction: B256,
trace_types: HashSet<TraceType>,
) -> Pin<Box<dyn Future<Output = RpcResult<TraceResults>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
fn replay_transaction<'life0, 'async_trait>(
&'life0 self,
transaction: B256,
trace_types: HashSet<TraceType>,
) -> Pin<Box<dyn Future<Output = RpcResult<TraceResults>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
Handler for trace_replayTransaction
source§fn trace_block<'life0, 'async_trait>(
&'life0 self,
block_id: BlockId,
) -> Pin<Box<dyn Future<Output = RpcResult<Option<Vec<LocalizedTransactionTrace>>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
fn trace_block<'life0, 'async_trait>(
&'life0 self,
block_id: BlockId,
) -> Pin<Box<dyn Future<Output = RpcResult<Option<Vec<LocalizedTransactionTrace>>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
Handler for trace_block
source§fn trace_filter<'life0, 'async_trait>(
&'life0 self,
filter: TraceFilter,
) -> Pin<Box<dyn Future<Output = RpcResult<Vec<LocalizedTransactionTrace>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
fn trace_filter<'life0, 'async_trait>(
&'life0 self,
filter: TraceFilter,
) -> Pin<Box<dyn Future<Output = RpcResult<Vec<LocalizedTransactionTrace>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
Handler for trace_filter
This is similar to eth_getLogs
but for traces.
§Limitations
This currently requires block filter fields, since reth does not have address indices yet.
source§fn trace_get<'life0, 'async_trait>(
&'life0 self,
hash: B256,
indices: Vec<Index>,
) -> Pin<Box<dyn Future<Output = RpcResult<Option<LocalizedTransactionTrace>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
fn trace_get<'life0, 'async_trait>(
&'life0 self,
hash: B256,
indices: Vec<Index>,
) -> Pin<Box<dyn Future<Output = RpcResult<Option<LocalizedTransactionTrace>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
Returns transaction trace at given index.
Handler for trace_get
source§fn trace_transaction<'life0, 'async_trait>(
&'life0 self,
hash: B256,
) -> Pin<Box<dyn Future<Output = RpcResult<Option<Vec<LocalizedTransactionTrace>>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
fn trace_transaction<'life0, 'async_trait>(
&'life0 self,
hash: B256,
) -> Pin<Box<dyn Future<Output = RpcResult<Option<Vec<LocalizedTransactionTrace>>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
Handler for trace_transaction
source§fn trace_transaction_opcode_gas<'life0, 'async_trait>(
&'life0 self,
tx_hash: B256,
) -> Pin<Box<dyn Future<Output = RpcResult<Option<TransactionOpcodeGas>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
fn trace_transaction_opcode_gas<'life0, 'async_trait>(
&'life0 self,
tx_hash: B256,
) -> Pin<Box<dyn Future<Output = RpcResult<Option<TransactionOpcodeGas>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
Handler for trace_transactionOpcodeGas
Auto Trait Implementations§
impl<Provider, Eth> Freeze for TraceApi<Provider, Eth>
impl<Provider, Eth> !RefUnwindSafe for TraceApi<Provider, Eth>
impl<Provider, Eth> Send for TraceApi<Provider, Eth>
impl<Provider, Eth> Sync for TraceApi<Provider, Eth>
impl<Provider, Eth> Unpin for TraceApi<Provider, Eth>
impl<Provider, Eth> !UnwindSafe for TraceApi<Provider, Eth>
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
§impl<T> Conv for T
impl<T> Conv for T
§impl<T> FmtForward for T
impl<T> FmtForward for T
§fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
self
to use its Binary
implementation when Debug
-formatted.§fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
self
to use its Display
implementation when
Debug
-formatted.§fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
self
to use its LowerExp
implementation when
Debug
-formatted.§fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
self
to use its LowerHex
implementation when
Debug
-formatted.§fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
self
to use its Octal
implementation when Debug
-formatted.§fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
self
to use its Pointer
implementation when
Debug
-formatted.§fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
self
to use its UpperExp
implementation when
Debug
-formatted.§fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
self
to use its UpperHex
implementation when
Debug
-formatted.§fn fmt_list(self) -> FmtList<Self>where
&'a Self: for<'a> IntoIterator,
fn fmt_list(self) -> FmtList<Self>where
&'a Self: for<'a> IntoIterator,
§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
source§impl<T> Instrument for T
impl<T> Instrument for T
source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
source§impl<T> IntoEither for T
impl<T> IntoEither for T
source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moresource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read more§impl<T> Pipe for Twhere
T: ?Sized,
impl<T> Pipe for Twhere
T: ?Sized,
§fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
§fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
self
and passes that borrow into the pipe function. Read more§fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
self
and passes that borrow into the pipe function. Read more§fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
§fn pipe_borrow_mut<'a, B, R>(
&'a mut self,
func: impl FnOnce(&'a mut B) -> R,
) -> R
fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R, ) -> R
§fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
self
, then passes self.as_ref()
into the pipe function.§fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
self
, then passes self.as_mut()
into the pipe
function.§fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
self
, then passes self.deref()
into the pipe function.§impl<T> Pointable for T
impl<T> Pointable for T
§impl<T> Tap for T
impl<T> Tap for T
§fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
Borrow<B>
of a value. Read more§fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
BorrowMut<B>
of a value. Read more§fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
AsRef<R>
view of a value. Read more§fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
AsMut<R>
view of a value. Read more§fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
Deref::Target
of a value. Read more§fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
Deref::Target
of a value. Read more§fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
.tap()
only in debug builds, and is erased in release builds.§fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
.tap_mut()
only in debug builds, and is erased in release
builds.§fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
.tap_borrow()
only in debug builds, and is erased in release
builds.§fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
.tap_borrow_mut()
only in debug builds, and is erased in release
builds.§fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
.tap_ref()
only in debug builds, and is erased in release
builds.§fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
.tap_ref_mut()
only in debug builds, and is erased in release
builds.§fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
.tap_deref()
only in debug builds, and is erased in release
builds.§impl<T> TryConv for T
impl<T> TryConv for T
§impl<T> WithSubscriber for T
impl<T> WithSubscriber for T
§fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>where
S: Into<Dispatch>,
fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>where
S: Into<Dispatch>,
§fn with_current_subscriber(self) -> WithDispatch<Self>
fn with_current_subscriber(self) -> WithDispatch<Self>
source§impl<T> WithSubscriber for T
impl<T> WithSubscriber for T
source§fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>where
S: Into<Dispatch>,
fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>where
S: Into<Dispatch>,
source§fn with_current_subscriber(self) -> WithDispatch<Self>
fn with_current_subscriber(self) -> WithDispatch<Self>
impl<T> ErasedDestructor for Twhere
T: 'static,
impl<T> MaybeDebug for Twhere
T: Debug,
impl<T> MaybeSend for Twhere
T: Send,
impl<T> MaybeSendSync for T
Layout§
Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...)
attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.
Size: 8 bytes