pub struct Client { /* private fields */ }
Expand description
A client connect to a node and maintains a cache of the last CACHE_SIZE
blocks.
Implementations§
Source§impl Client
impl Client
Sourcepub async fn new(
api: OnlineClient<SrcChainConfig>,
rpc_client: ReconnectingRpcClient,
rpc: LegacyRpcMethods<SrcChainConfig>,
block_provider: SubxtBlockInfoProvider,
receipt_provider: ReceiptProvider,
) -> Result<Self, ClientError>
pub async fn new( api: OnlineClient<SrcChainConfig>, rpc_client: ReconnectingRpcClient, rpc: LegacyRpcMethods<SrcChainConfig>, block_provider: SubxtBlockInfoProvider, receipt_provider: ReceiptProvider, ) -> Result<Self, ClientError>
Create a new client instance.
Sourcepub async fn subscribe_and_cache_new_blocks(
&self,
subscription_type: SubscriptionType,
) -> Result<(), ClientError>
pub async fn subscribe_and_cache_new_blocks( &self, subscription_type: SubscriptionType, ) -> Result<(), ClientError>
Start the block subscription, and populate the block cache.
Sourcepub async fn subscribe_and_cache_blocks(
&self,
index_last_n_blocks: SubstrateBlockNumber,
) -> Result<(), ClientError>
pub async fn subscribe_and_cache_blocks( &self, index_last_n_blocks: SubstrateBlockNumber, ) -> Result<(), ClientError>
Cache old blocks up to the given block number.
Sourcepub async fn block_hash_for_tag(
&self,
at: BlockNumberOrTagOrHash,
) -> Result<SubstrateBlockHash, ClientError>
pub async fn block_hash_for_tag( &self, at: BlockNumberOrTagOrHash, ) -> Result<SubstrateBlockHash, ClientError>
Get the block hash for the given block number or tag.
Sourcepub fn storage_api(&self, block_hash: H256) -> StorageApi
pub fn storage_api(&self, block_hash: H256) -> StorageApi
Get the storage API for the given block.
Sourcepub fn runtime_api(&self, block_hash: H256) -> RuntimeApi
pub fn runtime_api(&self, block_hash: H256) -> RuntimeApi
Get the runtime API for the given block.
Sourcepub async fn latest_finalized_block(&self) -> Arc<SubstrateBlock>
pub async fn latest_finalized_block(&self) -> Arc<SubstrateBlock>
Get the latest finalized block.
Sourcepub async fn latest_block(&self) -> Arc<SubstrateBlock>
pub async fn latest_block(&self) -> Arc<SubstrateBlock>
Get the latest best block.
Sourcepub async fn submit(
&self,
call: DefaultPayload<EthTransact>,
) -> Result<H256, ClientError>
pub async fn submit( &self, call: DefaultPayload<EthTransact>, ) -> Result<H256, ClientError>
Expose the transaction API.
Sourcepub async fn receipt(&self, tx_hash: &H256) -> Option<ReceiptInfo>
pub async fn receipt(&self, tx_hash: &H256) -> Option<ReceiptInfo>
Get an EVM transaction receipt by hash.
pub async fn sync_state( &self, ) -> Result<SyncState<SubstrateBlockNumber>, ClientError>
Sourcepub async fn syncing(&self) -> Result<SyncingStatus, ClientError>
pub async fn syncing(&self) -> Result<SyncingStatus, ClientError>
Get the syncing status of the chain.
Sourcepub async fn receipt_by_hash_and_index(
&self,
block_hash: &H256,
transaction_index: usize,
) -> Option<ReceiptInfo>
pub async fn receipt_by_hash_and_index( &self, block_hash: &H256, transaction_index: usize, ) -> Option<ReceiptInfo>
Get an EVM transaction receipt by hash.
pub async fn signed_tx_by_hash( &self, tx_hash: &H256, ) -> Option<TransactionSigned>
Sourcepub async fn receipts_count_per_block(
&self,
block_hash: &SubstrateBlockHash,
) -> Option<usize>
pub async fn receipts_count_per_block( &self, block_hash: &SubstrateBlockHash, ) -> Option<usize>
Get receipts count per block.
Sourcepub async fn system_health(&self) -> Result<SystemHealth, ClientError>
pub async fn system_health(&self) -> Result<SystemHealth, ClientError>
Get the system health.
Sourcepub async fn block_number(&self) -> Result<SubstrateBlockNumber, ClientError>
pub async fn block_number(&self) -> Result<SubstrateBlockNumber, ClientError>
Get the block number of the latest block.
Sourcepub async fn get_block_hash(
&self,
block_number: SubstrateBlockNumber,
) -> Result<Option<SubstrateBlockHash>, ClientError>
pub async fn get_block_hash( &self, block_number: SubstrateBlockNumber, ) -> Result<Option<SubstrateBlockHash>, ClientError>
Get a block hash for the given block number.
Sourcepub async fn block_by_number_or_tag(
&self,
block: &BlockNumberOrTag,
) -> Result<Option<Arc<SubstrateBlock>>, ClientError>
pub async fn block_by_number_or_tag( &self, block: &BlockNumberOrTag, ) -> Result<Option<Arc<SubstrateBlock>>, ClientError>
Get a block for the specified hash or number.
Sourcepub async fn block_by_hash(
&self,
hash: &SubstrateBlockHash,
) -> Result<Option<Arc<SubstrateBlock>>, ClientError>
pub async fn block_by_hash( &self, hash: &SubstrateBlockHash, ) -> Result<Option<Arc<SubstrateBlock>>, ClientError>
Get a block by hash
Sourcepub async fn block_by_number(
&self,
block_number: SubstrateBlockNumber,
) -> Result<Option<Arc<SubstrateBlock>>, ClientError>
pub async fn block_by_number( &self, block_number: SubstrateBlockNumber, ) -> Result<Option<Arc<SubstrateBlock>>, ClientError>
Get a block by number
Sourcepub async fn trace_block_by_number(
&self,
at: BlockNumberOrTag,
config: TracerType,
) -> Result<Vec<TransactionTrace>, ClientError>
pub async fn trace_block_by_number( &self, at: BlockNumberOrTag, config: TracerType, ) -> Result<Vec<TransactionTrace>, ClientError>
Get the transaction traces for the given block.
Sourcepub async fn trace_transaction(
&self,
transaction_hash: H256,
config: TracerType,
) -> Result<Trace, ClientError>
pub async fn trace_transaction( &self, transaction_hash: H256, config: TracerType, ) -> Result<Trace, ClientError>
Get the transaction traces for the given transaction.
Sourcepub async fn trace_call(
&self,
transaction: GenericTransaction,
block: BlockNumberOrTag,
config: TracerType,
) -> Result<Trace, ClientError>
pub async fn trace_call( &self, transaction: GenericTransaction, block: BlockNumberOrTag, config: TracerType, ) -> Result<Trace, ClientError>
Get the transaction traces for the given block.
Sourcepub async fn evm_block(
&self,
block: Arc<SubstrateBlock>,
hydrated_transactions: bool,
) -> Block
pub async fn evm_block( &self, block: Arc<SubstrateBlock>, hydrated_transactions: bool, ) -> Block
Get the EVM block for the given Substrate block.
Sourcepub async fn evm_block_from_receipts(
&self,
block: &SubstrateBlock,
receipts: &[ReceiptInfo],
signed_txs: Vec<TransactionSigned>,
hydrated_transactions: bool,
) -> Block
pub async fn evm_block_from_receipts( &self, block: &SubstrateBlock, receipts: &[ReceiptInfo], signed_txs: Vec<TransactionSigned>, hydrated_transactions: bool, ) -> Block
Get the EVM block for the given block and receipts.
Sourcepub fn max_block_weight(&self) -> Weight
pub fn max_block_weight(&self) -> Weight
Get the Max Block Weight.
Sourcepub async fn logs(
&self,
filter: Option<Filter>,
) -> Result<Vec<Log>, ClientError>
pub async fn logs( &self, filter: Option<Filter>, ) -> Result<Vec<Log>, ClientError>
Get the logs matching the given filter.
pub async fn fee_history( &self, block_count: u32, latest_block: BlockNumberOrTag, reward_percentiles: Option<Vec<f64>>, ) -> Result<FeeHistoryResult, ClientError>
Trait Implementations§
Auto Trait Implementations§
impl Freeze for Client
impl !RefUnwindSafe for Client
impl Send for Client
impl Sync for Client
impl Unpin for Client
impl !UnwindSafe for Client
Blanket Implementations§
§impl<T> AnySync for T
impl<T> AnySync for T
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> CheckedConversion for T
impl<T> CheckedConversion for 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<Src, Dest> IntoTuple<Dest> for Srcwhere
Dest: FromTuple<Src>,
impl<Src, Dest> IntoTuple<Dest> for Srcwhere
Dest: FromTuple<Src>,
fn into_tuple(self) -> Dest
Source§impl<T, Outer> IsWrappedBy<Outer> for T
impl<T, Outer> IsWrappedBy<Outer> for T
§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
Source§impl<T> SaturatedConversion for T
impl<T> SaturatedConversion for T
Source§fn saturated_from<T>(t: T) -> Selfwhere
Self: UniqueSaturatedFrom<T>,
fn saturated_from<T>(t: T) -> Selfwhere
Self: UniqueSaturatedFrom<T>,
Source§fn saturated_into<T>(self) -> Twhere
Self: UniqueSaturatedInto<T>,
fn saturated_into<T>(self) -> Twhere
Self: UniqueSaturatedInto<T>,
T
. Read more§impl<SS, SP> SupersetOf<SS> for SPwhere
SS: SubsetOf<SP>,
impl<SS, SP> SupersetOf<SS> for SPwhere
SS: SubsetOf<SP>,
§fn to_subset(&self) -> Option<SS>
fn to_subset(&self) -> Option<SS>
self
from the equivalent element of its
superset. Read more§fn is_in_subset(&self) -> bool
fn is_in_subset(&self) -> bool
self
is actually part of its subset T
(and can be converted to it).§fn to_subset_unchecked(&self) -> SS
fn to_subset_unchecked(&self) -> SS
self.to_subset
but without any property checks. Always succeeds.§fn from_subset(element: &SS) -> SP
fn from_subset(element: &SS) -> SP
self
to the equivalent element of its superset.§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
Source§impl<T, U> TryIntoKey<U> for Twhere
U: TryFromKey<T>,
impl<T, U> TryIntoKey<U> for Twhere
U: TryFromKey<T>,
type Error = <U as TryFromKey<T>>::Error
fn try_into_key(self) -> Result<U, <U as TryFromKey<T>>::Error>
Source§impl<S, T> UncheckedInto<T> for Swhere
T: UncheckedFrom<S>,
impl<S, T> UncheckedInto<T> for Swhere
T: UncheckedFrom<S>,
Source§fn unchecked_into(self) -> T
fn unchecked_into(self) -> T
unchecked_from
.Source§impl<T, S> UniqueSaturatedInto<T> for S
impl<T, S> UniqueSaturatedInto<T> for S
Source§fn unique_saturated_into(self) -> T
fn unique_saturated_into(self) -> T
T
.