Struct ethers_providers::Http

pub struct Http { /* private fields */ }

A low-level JSON-RPC Client over HTTP.

Example

use ethers_core::types::U64;
use ethers_providers::{JsonRpcClient, Http};
use std::str::FromStr;

let provider = Http::from_str("http://localhost:8545")?;
let block_number: U64 = provider.request("eth_blockNumber", ()).await?;

Implementations

impl Provider

pub fn new(url: impl Into<Url>) -> Self

Initializes a new HTTP Client

Example

use ethers_providers::Http;
use url::Url;

let url = Url::parse("http://localhost:8545").unwrap();
let provider = Http::new(url);

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

pub fn new_with_auth(
    url: impl Into<Url>,
    auth: Authorization
) -> Result<Self, HttpClientError>

Initializes a new HTTP Client with authentication

Example

use ethers_providers::{Authorization, Http};
use url::Url;

let url = Url::parse("http://localhost:8545").unwrap();
let provider = Http::new_with_auth(url, Authorization::basic("admin", "good_password"));

pub fn new_with_client(url: impl Into<Url>, client: Client) -> Self

Allows to customize the provider by providing your own http client

Example

use ethers_providers::Http;
use url::Url;

let url = Url::parse("http://localhost:8545").unwrap();
let client = reqwest::Client::builder().build().unwrap();
let provider = Http::new_with_client(url, client);

Trait Implementations

impl Clone for Provider

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Provider

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

Formats the value using the given formatter.

impl FromStr for Provider

type Err = ParseError

The associated error which can be returned from parsing.

fn from_str(src: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl JsonRpcClient for Provider

fn request<'life0, 'life1, 'async_trait, T, R>(
    &'life0 self,
    method: &'life1 str,
    params: T
) -> Pin<Box<dyn Future<Output = Result<R, ClientError>> + Send + 'async_trait>>where
    T: 'async_trait + Serialize + Send + Sync,
    R: 'async_trait + DeserializeOwned,
    'life0: 'async_trait,
    'life1: 'async_trait,
    Self: 'async_trait,

Sends a POST request with the provided method and the params serialized as JSON over HTTP

type Error = ClientError

A JSON-RPC Error