Struct ethers::providers::Provider

pub struct Provider<P> { /* private fields */ }

An abstract provider for interacting with the Ethereum JSON RPC API. Must be instantiated with a data transport which implements the JsonRpcClient trait (e.g. HTTP, Websockets etc.)

Example

use ethers_providers::{Middleware, Provider, Http};
use std::convert::TryFrom;

let provider = Provider::<Http>::try_from(
    "https://eth.llamarpc.com"
).expect("could not instantiate HTTP Provider");

let block = provider.get_block(100u64).await?;
println!("Got block: {}", serde_json::to_string(&block)?);

Implementations

impl<P> Provider<P>where P: JsonRpcClient,

pub fn new(provider: P) -> Provider<P>

Instantiate a new provider with a backend.

pub async fn node_client( &self ) -> impl Future<Output = Result<NodeClient, ProviderError>>

Returns the type of node we’re connected to, while also caching the value for use in other node-specific API calls, such as the get_block_receipts call.

pub fn with_sender(self, address: impl Into<H160>) -> Provider<P>

Set the default sender on the provider

pub async fn request<T, R>( &self, method: &str, params: T ) -> impl Future<Output = Result<R, ProviderError>>where T: Debug + Serialize + Send + Sync, R: Serialize + DeserializeOwned + Debug + Send,

Make an RPC request via the internal connection, and return the result.

pub fn call_raw<'a>(&'a self, tx: &'a TypedTransaction) -> CallBuilder<'a, P>

Analogous to Middleware::call, but returns a CallBuilder that can either be .awaitd or used to override the parameters sent to eth_call.

See the call_raw::spoof for functions to construct state override parameters.

Note: this method does not send a transaction from your account

Example

let geth = Geth::new().spawn();
let provider = Provider::<Http>::try_from(geth.endpoint()).unwrap();

let adr1: Address = "0x6fC21092DA55B392b045eD78F4732bff3C580e2c".parse()?;
let adr2: Address = "0x295a70b2de5e3953354a6a8344e616ed314d7251".parse()?;
let pay_amt = parse_ether(1u64)?;

// Not enough ether to pay for the transaction
let tx = TransactionRequest::pay(adr2, pay_amt).from(adr1).into();

// override the sender's balance for the call
let mut state = spoof::balance(adr1, pay_amt * 2);
provider.call_raw(&tx).state(&state).await?;

impl<P> Provider<P>where P: JsonRpcClient,

pub fn ens<T>(self, ens: T) -> Provider<P>where T: Into<H160>,

Sets the ENS Address (default: mainnet)

pub fn set_interval<T>(&mut self, interval: T) -> &mut Provider<P>where T: Into<Duration>,

Sets the default polling interval for event filters and pending transactions (default: 7 seconds)

pub fn interval<T>(self, interval: T) -> Provider<P>where T: Into<Duration>,

Sets the default polling interval for event filters and pending transactions (default: 7 seconds)

pub fn get_interval(&self) -> Duration

Gets the polling interval which the provider currently uses for event filters and pending transactions (default: 7 seconds)

impl Provider<Ipc>

pub async fn connect_ipc( path: impl AsRef<Path> ) -> impl Future<Output = Result<Provider<Ipc>, ProviderError>>

Connects to the Unix socket at the provided path.

impl Provider<Provider>

pub fn url(&self) -> &Url

The Url to which requests are made

pub fn url_mut(&mut self) -> &mut Url

Mutable access to the Url to which requests are made

impl<Read, Write> Provider<RwClient<Read, Write>>where Read: JsonRpcClient + 'static, <Read as JsonRpcClient>::Error: Sync + Send + 'static, Write: JsonRpcClient + 'static, <Write as JsonRpcClient>::Error: Sync + Send + 'static,

pub fn rw(r: Read, w: Write) -> Provider<RwClient<Read, Write>>

Creates a new Provider with a RwClient

impl<T> Provider<QuorumProvider<T>>where T: JsonRpcClientWrapper,

pub fn quorum(inner: QuorumProvider<T>) -> Provider<QuorumProvider<T>>

Provider that uses a quorum

impl Provider<MockProvider>

pub fn mocked() -> (Provider<MockProvider>, MockProvider)

Returns a Provider instantiated with an internal “mock” transport.

Example

use ethers_core::types::U64;
use ethers_providers::{Middleware, Provider};
// Instantiate the provider
let (provider, mock) = Provider::mocked();
// Push the mock response
mock.push(U64::from(12))?;
// Make the call
let blk = provider.get_block_number().await.unwrap();
// The response matches
assert_eq!(blk.as_u64(), 12);
// and the request as well!
mock.assert_request("eth_blockNumber", ()).unwrap();

impl Provider<RetryClient<Provider>>

pub fn new_client( src: &str, max_retry: u32, initial_backoff: u64 ) -> Result<Provider<RetryClient<Provider>>, ParseError>

Create a new RetryClient by connecting to the provided URL. Errors if src is not a valid URL

impl Provider<Ws>

pub async fn connect( url: impl IntoClientRequest + Unpin ) -> impl Future<Output = Result<Provider<Ws>, ProviderError>>

Direct connection to a websocket endpoint

pub async fn connect_with_auth( url: impl IntoClientRequest + Unpin, auth: Authorization ) -> impl Future<Output = Result<Provider<Ws>, ProviderError>>

Connect to a WS RPC provider with authentication details

Trait Implementations

impl<P> AsRef<P> for Provider<P>

fn as_ref(&self) -> &P

Converts this type into a shared reference of the (usually inferred) input type.

impl<P> Clone for Provider<P>where P: Clone,

fn clone(&self) -> Provider<P>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<P> Debug for Provider<P>where P: Debug,

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<P> Middleware for Provider<P>where P: JsonRpcClient,

fn sign_transaction<'life0, 'life1, 'async_trait>( &'life0 self, _tx: &'life1 TypedTransaction, _from: H160 ) -> Pin<Box<dyn Future<Output = Result<Signature, <Provider<P> as Middleware>::Error>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, 'life1: 'async_trait, Provider<P>: 'async_trait,

Sign a transaction via RPC call

fn watch_pending_transactions<'life0, 'async_trait>( &'life0 self ) -> Pin<Box<dyn Future<Output = Result<FilterWatcher<'life0, P, H256>, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Provider<P>: 'async_trait,

Streams pending transactions

fn mining<'life0, 'async_trait>( &'life0 self ) -> Pin<Box<dyn Future<Output = Result<bool, <Provider<P> as Middleware>::Error>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Provider<P>: 'async_trait,

Returns an indication if this node is currently mining.

type Error = ProviderError

Error type returned by most operations

type Provider = P

The JSON-RPC client type at the bottom of the stack

type Inner = Provider<P>

The next-lower middleware in the middleware stack

fn inner(&self) -> &<Provider<P> as Middleware>::Inner

Get a reference to the next-lower middleware in the middleware stack

fn provider(&self) -> &Provider<<Provider<P> as Middleware>::Provider>

The HTTP or Websocket provider.

fn convert_err(p: ProviderError) -> <Provider<P> as Middleware>::Error

Convert a provider error into the associated error type by successively converting it to every intermediate middleware error

fn default_sender(&self) -> Option<H160>

Return the default sender (if any). This will typically be the connected node’s first address, or the address of a Signer in a lower middleware stack

fn client_version<'life0, 'async_trait>( &'life0 self ) -> Pin<Box<dyn Future<Output = Result<String, <Provider<P> as Middleware>::Error>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Provider<P>: 'async_trait,

Returns the current client version using the web3_clientVersion RPC.

fn fill_transaction<'life0, 'life1, 'async_trait>( &'life0 self, tx: &'life1 mut TypedTransaction, block: Option<BlockId> ) -> Pin<Box<dyn Future<Output = Result<(), <Provider<P> as Middleware>::Error>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, 'life1: 'async_trait, Provider<P>: 'async_trait,

Fill necessary details of a transaction for dispatch

fn get_block_number<'life0, 'async_trait>( &'life0 self ) -> Pin<Box<dyn Future<Output = Result<U64, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Provider<P>: 'async_trait,

Get the block number

fn get_block<'life0, 'async_trait, T>( &'life0 self, block_hash_or_number: T ) -> Pin<Box<dyn Future<Output = Result<Option<Block<H256>>, <Provider<P> as Middleware>::Error>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, T: 'async_trait + Into<BlockId> + Send + Sync, Provider<P>: 'async_trait,

Gets the block at block_hash_or_number (transaction hashes only)

fn get_block_with_txs<'life0, 'async_trait, T>( &'life0 self, block_hash_or_number: T ) -> Pin<Box<dyn Future<Output = Result<Option<Block<Transaction>>, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, T: 'async_trait + Into<BlockId> + Send + Sync, Provider<P>: 'async_trait,

Gets the block at block_hash_or_number (full transactions included)

fn get_uncle_count<'life0, 'async_trait, T>( &'life0 self, block_hash_or_number: T ) -> Pin<Box<dyn Future<Output = Result<U256, <Provider<P> as Middleware>::Error>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, T: 'async_trait + Into<BlockId> + Send + Sync, Provider<P>: 'async_trait,

Gets the block uncle count at block_hash_or_number

fn get_uncle<'life0, 'async_trait, T>( &'life0 self, block_hash_or_number: T, idx: U64 ) -> Pin<Box<dyn Future<Output = Result<Option<Block<H256>>, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, T: 'async_trait + Into<BlockId> + Send + Sync, Provider<P>: 'async_trait,

Gets the block uncle at block_hash_or_number and idx

fn get_transaction<'life0, 'async_trait, T>( &'life0 self, transaction_hash: T ) -> Pin<Box<dyn Future<Output = Result<Option<Transaction>, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, T: 'async_trait + Send + Sync + Into<H256>, Provider<P>: 'async_trait,

Gets the transaction with transaction_hash

fn get_transaction_receipt<'life0, 'async_trait, T>( &'life0 self, transaction_hash: T ) -> Pin<Box<dyn Future<Output = Result<Option<TransactionReceipt>, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, T: 'async_trait + Send + Sync + Into<H256>, Provider<P>: 'async_trait,

Gets the transaction receipt with transaction_hash

fn get_block_receipts<'life0, 'async_trait, T>( &'life0 self, block: T ) -> Pin<Box<dyn Future<Output = Result<Vec<TransactionReceipt, Global>, <Provider<P> as Middleware>::Error>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, T: 'async_trait + Into<BlockNumber> + Send + Sync, Provider<P>: 'async_trait,

Returns all receipts for a block.

fn parity_block_receipts<'life0, 'async_trait, T>( &'life0 self, block: T ) -> Pin<Box<dyn Future<Output = Result<Vec<TransactionReceipt, Global>, <Provider<P> as Middleware>::Error>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, T: 'async_trait + Into<BlockNumber> + Send + Sync, Provider<P>: 'async_trait,

Returns all receipts for that block. Must be done on a parity node.

fn get_gas_price<'life0, 'async_trait>( &'life0 self ) -> Pin<Box<dyn Future<Output = Result<U256, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Provider<P>: 'async_trait,

Gets the current gas price as estimated by the node

fn estimate_eip1559_fees<'life0, 'async_trait>( &'life0 self, estimator: Option<fn(_: U256, _: Vec<Vec<U256, Global>, Global>) -> (U256, U256)> ) -> Pin<Box<dyn Future<Output = Result<(U256, U256), <Provider<P> as Middleware>::Error>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Provider<P>: 'async_trait,

Gets a heuristic recommendation of max fee per gas and max priority fee per gas for EIP-1559 compatible transactions.

fn get_accounts<'life0, 'async_trait>( &'life0 self ) -> Pin<Box<dyn Future<Output = Result<Vec<H160, Global>, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Provider<P>: 'async_trait,

Gets the accounts on the node

fn get_transaction_count<'life0, 'async_trait, T>( &'life0 self, from: T, block: Option<BlockId> ) -> Pin<Box<dyn Future<Output = Result<U256, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, T: 'async_trait + Into<NameOrAddress> + Send + Sync, Provider<P>: 'async_trait,

Returns the nonce of the address

fn get_balance<'life0, 'async_trait, T>( &'life0 self, from: T, block: Option<BlockId> ) -> Pin<Box<dyn Future<Output = Result<U256, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, T: 'async_trait + Into<NameOrAddress> + Send + Sync, Provider<P>: 'async_trait,

Returns the account’s balance

fn get_chainid<'life0, 'async_trait>( &'life0 self ) -> Pin<Box<dyn Future<Output = Result<U256, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Provider<P>: 'async_trait,

Returns the currently configured chain id, a value used in replay-protected transaction signing as introduced by EIP-155.

fn syncing<'life0, 'async_trait>( &'life0 self ) -> Pin<Box<dyn Future<Output = Result<SyncingStatus, <Provider<P> as Middleware>::Error>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Provider<P>: 'async_trait,

Return current client syncing status. If IsFalse sync is over.

fn get_net_version<'life0, 'async_trait>( &'life0 self ) -> Pin<Box<dyn Future<Output = Result<String, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Provider<P>: 'async_trait,

Returns the network version.

fn call<'life0, 'life1, 'async_trait>( &'life0 self, tx: &'life1 TypedTransaction, block: Option<BlockId> ) -> Pin<Box<dyn Future<Output = Result<Bytes, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, 'life1: 'async_trait, Provider<P>: 'async_trait,

Sends the read-only (constant) transaction to a single Ethereum node and return the result (as bytes) of executing it. This is free, since it does not change any state on the blockchain.

fn estimate_gas<'life0, 'life1, 'async_trait>( &'life0 self, tx: &'life1 TypedTransaction, block: Option<BlockId> ) -> Pin<Box<dyn Future<Output = Result<U256, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, 'life1: 'async_trait, Provider<P>: 'async_trait,

Sends a transaction to a single Ethereum node and return the estimated amount of gas required (as a U256) to send it This is free, but only an estimate. Providing too little gas will result in a transaction being rejected (while still consuming all provided gas).

fn create_access_list<'life0, 'life1, 'async_trait>( &'life0 self, tx: &'life1 TypedTransaction, block: Option<BlockId> ) -> Pin<Box<dyn Future<Output = Result<AccessListWithGasUsed, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, 'life1: 'async_trait, Provider<P>: 'async_trait,

Querty the node for an EIP-2930 Access List.

fn send_transaction<'life0, 'async_trait, T>( &'life0 self, tx: T, block: Option<BlockId> ) -> Pin<Box<dyn Future<Output = Result<PendingTransaction<'life0, P>, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, T: 'async_trait + Into<TypedTransaction> + Send + Sync, Provider<P>: 'async_trait,

Sends the transaction to the entire Ethereum network and returns the transaction’s hash. This will consume gas from the account that signed the transaction. This call will fail if no signer is available, and the RPC node does not have an unlocked accounts

fn send_raw_transaction<'a, 'async_trait>( &'a self, tx: Bytes ) -> Pin<Box<dyn Future<Output = Result<PendingTransaction<'a, P>, ProviderError>> + Send + 'async_trait, Global>>where 'a: 'async_trait, Provider<P>: 'async_trait,

Send the raw RLP encoded transaction to the entire Ethereum network and returns the transaction’s hash This will consume gas from the account that signed the transaction.

fn is_signer<'life0, 'async_trait>( &'life0 self ) -> Pin<Box<dyn Future<Output = bool> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Provider<P>: 'async_trait,

This returns true if either the middleware stack contains a SignerMiddleware, or the JSON-RPC provider has an unlocked key that can sign using the eth_sign call. If none of the above conditions are met, then the middleware stack is not capable of signing data.

fn sign<'life0, 'life1, 'async_trait, T>( &'life0 self, data: T, from: &'life1 H160 ) -> Pin<Box<dyn Future<Output = Result<Signature, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, 'life1: 'async_trait, T: 'async_trait + Into<Bytes> + Send + Sync, Provider<P>: 'async_trait,

Signs data using a specific account. This account needs to be unlocked, or the middleware stack must contain a SignerMiddleware

fn get_logs<'life0, 'life1, 'async_trait>( &'life0 self, filter: &'life1 Filter ) -> Pin<Box<dyn Future<Output = Result<Vec<Log, Global>, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, 'life1: 'async_trait, Provider<P>: 'async_trait,

Returns an array (possibly empty) of logs that match the filter

fn get_logs_paginated<'a>( &'a self, filter: &Filter, page_size: u64 ) -> LogQuery<'a, P>

Returns a stream of logs are loaded in pages of given page size

fn watch<'a, 'life0, 'async_trait>( &'a self, filter: &'life0 Filter ) -> Pin<Box<dyn Future<Output = Result<FilterWatcher<'a, P, Log>, ProviderError>> + Send + 'async_trait, Global>>where 'a: 'async_trait, 'life0: 'async_trait, Provider<P>: 'async_trait,

Streams event logs matching the filter.

fn watch_blocks<'life0, 'async_trait>( &'life0 self ) -> Pin<Box<dyn Future<Output = Result<FilterWatcher<'life0, P, H256>, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Provider<P>: 'async_trait,

Streams new block hashes

fn get_storage_at<'life0, 'async_trait, T>( &'life0 self, from: T, location: H256, block: Option<BlockId> ) -> Pin<Box<dyn Future<Output = Result<H256, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, T: 'async_trait + Into<NameOrAddress> + Send + Sync, Provider<P>: 'async_trait,

Get the storage of an address for a particular slot location

fn get_code<'life0, 'async_trait, T>( &'life0 self, at: T, block: Option<BlockId> ) -> Pin<Box<dyn Future<Output = Result<Bytes, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, T: 'async_trait + Into<NameOrAddress> + Send + Sync, Provider<P>: 'async_trait,

Returns the deployed code at a given address

fn get_proof<'life0, 'async_trait, T>( &'life0 self, from: T, locations: Vec<H256, Global>, block: Option<BlockId> ) -> Pin<Box<dyn Future<Output = Result<EIP1186ProofResponse, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, T: 'async_trait + Into<NameOrAddress> + Send + Sync, Provider<P>: 'async_trait,

Returns the EIP-1186 proof response https://github.com/ethereum/EIPs/issues/1186

fn import_raw_key<'life0, 'async_trait>( &'life0 self, private_key: Bytes, passphrase: String ) -> Pin<Box<dyn Future<Output = Result<H160, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Provider<P>: 'async_trait,

Sends the given key to the node to be encrypted with the provided passphrase and stored.

fn unlock_account<'life0, 'async_trait, T>( &'life0 self, account: T, passphrase: String, duration: Option<u64> ) -> Pin<Box<dyn Future<Output = Result<bool, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, T: 'async_trait + Into<H160> + Send + Sync, Provider<P>: 'async_trait,

Prompts the node to decrypt the given account from its keystore.

fn add_peer<'life0, 'async_trait>( &'life0 self, enode_url: String ) -> Pin<Box<dyn Future<Output = Result<bool, <Provider<P> as Middleware>::Error>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Provider<P>: 'async_trait,

Requests adding the given peer, returning a boolean representing whether or not the peer was accepted for tracking.

fn add_trusted_peer<'life0, 'async_trait>( &'life0 self, enode_url: String ) -> Pin<Box<dyn Future<Output = Result<bool, <Provider<P> as Middleware>::Error>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Provider<P>: 'async_trait,

Requests adding the given peer as a trusted peer, which the node will always connect to even when its peer slots are full.

fn node_info<'life0, 'async_trait>( &'life0 self ) -> Pin<Box<dyn Future<Output = Result<NodeInfo, <Provider<P> as Middleware>::Error>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Provider<P>: 'async_trait,

Returns general information about the node as well as information about the running p2p protocols (e.g. eth, snap).

fn peers<'life0, 'async_trait>( &'life0 self ) -> Pin<Box<dyn Future<Output = Result<Vec<PeerInfo, Global>, <Provider<P> as Middleware>::Error>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Provider<P>: 'async_trait,

Returns the list of peers currently connected to the node.

fn remove_peer<'life0, 'async_trait>( &'life0 self, enode_url: String ) -> Pin<Box<dyn Future<Output = Result<bool, <Provider<P> as Middleware>::Error>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Provider<P>: 'async_trait,

Requests to remove the given peer, returning true if the enode was successfully parsed and the peer was removed.

fn remove_trusted_peer<'life0, 'async_trait>( &'life0 self, enode_url: String ) -> Pin<Box<dyn Future<Output = Result<bool, <Provider<P> as Middleware>::Error>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Provider<P>: 'async_trait,

Requests to remove the given peer, returning a boolean representing whether or not the enode url passed was validated. A return value of true does not necessarily mean that the peer was disconnected.

fn start_mining<'life0, 'async_trait>( &'life0 self, threads: Option<usize> ) -> Pin<Box<dyn Future<Output = Result<(), <Provider<P> as Middleware>::Error>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Provider<P>: 'async_trait,

Starts the miner with the given number of threads. If threads is nil, the number of workers started is equal to the number of logical CPUs that are usable by this process. If mining is already running, this method adjust the number of threads allowed to use and updates the minimum price required by the transaction pool.

fn stop_mining<'life0, 'async_trait>( &'life0 self ) -> Pin<Box<dyn Future<Output = Result<(), <Provider<P> as Middleware>::Error>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Provider<P>: 'async_trait,

Stop terminates the miner, both at the consensus engine level as well as at the block creation level.

fn resolve_name<'life0, 'life1, 'async_trait>( &'life0 self, ens_name: &'life1 str ) -> Pin<Box<dyn Future<Output = Result<H160, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, 'life1: 'async_trait, Provider<P>: 'async_trait,

Returns the address that the ens_name resolves to (or None if not configured).

fn lookup_address<'life0, 'async_trait>( &'life0 self, address: H160 ) -> Pin<Box<dyn Future<Output = Result<String, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Provider<P>: 'async_trait,

Returns the ENS name the address resolves to (or None if not configured).

fn resolve_avatar<'life0, 'life1, 'async_trait>( &'life0 self, ens_name: &'life1 str ) -> Pin<Box<dyn Future<Output = Result<Url, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, 'life1: 'async_trait, Provider<P>: 'async_trait,

Returns the avatar HTTP link of the avatar that the ens_name resolves to (or None if not configured)

fn resolve_nft<'life0, 'async_trait>( &'life0 self, token: ERCNFT ) -> Pin<Box<dyn Future<Output = Result<Url, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Provider<P>: 'async_trait,

Returns the URL (not necesserily HTTP) of the image behind a token.

fn resolve_field<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, ens_name: &'life1 str, field: &'life2 str ) -> Pin<Box<dyn Future<Output = Result<String, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, Provider<P>: 'async_trait,

Fetch a field for the ens_name (no None if not configured).

fn txpool_content<'life0, 'async_trait>( &'life0 self ) -> Pin<Box<dyn Future<Output = Result<TxpoolContent, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Provider<P>: 'async_trait,

Returns the details of all transactions currently pending for inclusion in the next block(s), as well as the ones that are being scheduled for future execution only. Ref: Here

fn txpool_inspect<'life0, 'async_trait>( &'life0 self ) -> Pin<Box<dyn Future<Output = Result<TxpoolInspect, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Provider<P>: 'async_trait,

Returns a summary of all the transactions currently pending for inclusion in the next block(s), as well as the ones that are being scheduled for future execution only. Ref: Here

fn txpool_status<'life0, 'async_trait>( &'life0 self ) -> Pin<Box<dyn Future<Output = Result<TxpoolStatus, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Provider<P>: 'async_trait,

Returns the number of transactions currently pending for inclusion in the next block(s), as well as the ones that are being scheduled for future execution only. Ref: Here

fn debug_trace_transaction<'life0, 'async_trait>( &'life0 self, tx_hash: H256, trace_options: GethDebugTracingOptions ) -> Pin<Box<dyn Future<Output = Result<GethTrace, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Provider<P>: 'async_trait,

After replaying any previous transactions in the same block, Replays a transaction, returning the traces configured with passed options

fn debug_trace_call<'life0, 'async_trait, T>( &'life0 self, req: T, block: Option<BlockId>, trace_options: GethDebugTracingCallOptions ) -> Pin<Box<dyn Future<Output = Result<GethTrace, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, T: 'async_trait + Into<TypedTransaction> + Send + Sync, Provider<P>: 'async_trait,

Executes the given call and returns a number of possible traces for it

fn trace_call<'life0, 'async_trait, T>( &'life0 self, req: T, trace_type: Vec<TraceType, Global>, block: Option<BlockNumber> ) -> Pin<Box<dyn Future<Output = Result<BlockTrace, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, T: 'async_trait + Into<TypedTransaction> + Send + Sync, Provider<P>: 'async_trait,

Executes the given call and returns a number of possible traces for it

fn trace_call_many<'life0, 'async_trait, T>( &'life0 self, req: Vec<(T, Vec<TraceType, Global>), Global>, block: Option<BlockNumber> ) -> Pin<Box<dyn Future<Output = Result<Vec<BlockTrace, Global>, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, T: 'async_trait + Into<TypedTransaction> + Send + Sync, Provider<P>: 'async_trait,

Executes given calls and returns a number of possible traces for each call

fn trace_raw_transaction<'life0, 'async_trait>( &'life0 self, data: Bytes, trace_type: Vec<TraceType, Global> ) -> Pin<Box<dyn Future<Output = Result<BlockTrace, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Provider<P>: 'async_trait,

Traces a call to eth_sendRawTransaction without making the call, returning the traces

fn trace_replay_transaction<'life0, 'async_trait>( &'life0 self, hash: H256, trace_type: Vec<TraceType, Global> ) -> Pin<Box<dyn Future<Output = Result<BlockTrace, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Provider<P>: 'async_trait,

Replays a transaction, returning the traces

fn trace_replay_block_transactions<'life0, 'async_trait>( &'life0 self, block: BlockNumber, trace_type: Vec<TraceType, Global> ) -> Pin<Box<dyn Future<Output = Result<Vec<BlockTrace, Global>, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Provider<P>: 'async_trait,

Replays all transactions in a block returning the requested traces for each transaction

fn trace_block<'life0, 'async_trait>( &'life0 self, block: BlockNumber ) -> Pin<Box<dyn Future<Output = Result<Vec<Trace, Global>, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Provider<P>: 'async_trait,

Returns traces created at given block

fn trace_filter<'life0, 'async_trait>( &'life0 self, filter: TraceFilter ) -> Pin<Box<dyn Future<Output = Result<Vec<Trace, Global>, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Provider<P>: 'async_trait,

Return traces matching the given filter

fn trace_get<'life0, 'async_trait, T>( &'life0 self, hash: H256, index: Vec<T, Global> ) -> Pin<Box<dyn Future<Output = Result<Trace, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, T: 'async_trait + Into<U64> + Send + Sync, Provider<P>: 'async_trait,

Returns trace at the given position

fn trace_transaction<'life0, 'async_trait>( &'life0 self, hash: H256 ) -> Pin<Box<dyn Future<Output = Result<Vec<Trace, Global>, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Provider<P>: 'async_trait,

Returns all traces of a given transaction

fn subscribe_blocks<'life0, 'async_trait>( &'life0 self ) -> Pin<Box<dyn Future<Output = Result<SubscriptionStream<'life0, P, Block<H256>>, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, P: PubsubClient, Provider<P>: 'async_trait,

Subscribe to a stream of incoming blocks.

fn subscribe_pending_txs<'life0, 'async_trait>( &'life0 self ) -> Pin<Box<dyn Future<Output = Result<SubscriptionStream<'life0, P, H256>, ProviderError>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, P: PubsubClient, Provider<P>: 'async_trait,

Subscribe to a stream of pending transactions.

fn subscribe_logs<'a, 'life0, 'async_trait>( &'a self, filter: &'life0 Filter ) -> Pin<Box<dyn Future<Output = Result<SubscriptionStream<'a, P, Log>, ProviderError>> + Send + 'async_trait, Global>>where 'a: 'async_trait, 'life0: 'async_trait, P: PubsubClient, Provider<P>: 'async_trait,

Subscribe to a stream of event logs matchin the provided Filter.

fn fee_history<'life0, 'life1, 'async_trait, T>( &'life0 self, block_count: T, last_block: BlockNumber, reward_percentiles: &'life1 [f64] ) -> Pin<Box<dyn Future<Output = Result<FeeHistory, <Provider<P> as Middleware>::Error>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, 'life1: 'async_trait, T: 'async_trait + Into<U256> + Send + Sync, Provider<P>: 'async_trait,

Query the node for a FeeHistory object. This objct contains information about the EIP-1559 base fee in past blocks, as well as gas utilization within those blocks.

fn send_escalating<'a, 'life0, 'async_trait>( &'a self, tx: &'life0 TypedTransaction, escalations: usize, policy: Box<dyn Fn(U256, usize) -> U256 + Send + Sync + 'static, Global> ) -> Pin<Box<dyn Future<Output = Result<EscalatingPending<'a, Self::Provider>, Self::Error>> + Send + 'async_trait, Global>>where 'a: 'async_trait, 'life0: 'async_trait, Self: 'async_trait,

Send a transaction with a simple escalation policy.

impl ProviderExt for Provider<Provider>

type Error = ParseError

The error type that can occur when creating a provider

fn try_connect<'life0, 'async_trait>( url: &'life0 str ) -> Pin<Box<dyn Future<Output = Result<Provider<Provider>, <Provider<Provider> as ProviderExt>::Error>> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Provider<Provider>: Sized + 'async_trait,

Try to create a new Provider

fn set_chain(&mut self, chain: impl Into<Chain>) -> &mut Provider<Provider>

Customized Provider settings for chain

fn connect<'life0, 'async_trait>( url: &'life0 str ) -> Pin<Box<dyn Future<Output = Self> + Send + 'async_trait, Global>>where 'life0: 'async_trait, Self: Sized + Send + 'async_trait,

Creates a new instance connected to the given url, exit on error

fn for_chain(self, chain: impl Into<Chain>) -> Selfwhere Self: Sized,

Customize Provider settings for chain.

impl<'a> TryFrom<&'a String> for Provider<Provider>

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from( src: &'a String ) -> Result<Provider<Provider>, <Provider<Provider> as TryFrom<&'a String>>::Error>

Performs the conversion.

impl TryFrom<&str> for Provider<Provider>

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from( src: &str ) -> Result<Provider<Provider>, <Provider<Provider> as TryFrom<&str>>::Error>

Performs the conversion.

impl TryFrom<String> for Provider<Provider>

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from( src: String ) -> Result<Provider<Provider>, <Provider<Provider> as TryFrom<String>>::Error>

Performs the conversion.