Struct HttpProvider

pub struct HttpProvider { /* private fields */ }

A low-level JSON-RPC Client over HTTP.

Example

use neo3::neo_clients::{HttpProvider, RpcClient, APITrait};
use neo3::neo_config::NeoConstants;
use primitive_types::H256;

let provider = HttpProvider::new(NeoConstants::SEED_1)?;
let client = RpcClient::new(provider);
let block = client.get_block(H256::zero(), false).await?;

Implementations

impl HttpProvider

pub fn new<T: TryInto<Url>>(url: T) -> Result<Self, T::Error>

Initializes a new HTTP Client

Example

use neo3::neo_clients::HttpProvider;
use url::Url;

// Using a string
let provider = HttpProvider::new("http://localhost:8545")?;

// Using a &str
let provider = HttpProvider::new("http://localhost:8545")?;

// Using a Url
let url = Url::parse("http://localhost:8545").unwrap();
let provider = HttpProvider::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 neo3::neo_clients::{HttpProvider, Authorization};
use url::Url;

let url = Url::parse("http://localhost:8545").unwrap();
let provider = HttpProvider::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 neo3::neo_clients::HttpProvider;
use url::Url;

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

Trait Implementations

impl Clone for HttpProvider

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HttpProvider

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

Formats the value using the given formatter.

impl Default for HttpProvider

fn default() -> Self

Default HTTP Provider from SEED_1

impl JsonRpcProvider for HttpProvider

type Error = ClientError

A JSON-RPC Error

fn fetch<'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, Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Sends a request with the provided JSON-RPC and parameters serialized as JSON