Struct DapiClient 

pub struct DapiClient {
    pub ca_certificate: Option<Certificate>,
    /* private fields */
}

Access point to DAPI.

Fields

ca_certificate: Option<Certificate>

Certificate Authority certificate to use for verifying the server’s certificate.

Implementations

impl DapiClient

pub fn new(address_list: AddressList, settings: RequestSettings) -> Self

Initialize new DapiClient and optionally override default settings.

pub fn with_ca_certificate(self, ca_cert: Certificate) -> Self

Set CA certificate to use when verifying the server’s certificate.

Arguments

• pem_ca_cert - CA certificate in PEM format.

Returns

DapiClient with CA certificate set.

pub fn address_list(&self) -> &AddressList

Return the DapiClient address list.

pub fn get_live_addresses(&self) -> Vec<Address>

Get all non-banned addresses from the address list.

Returns a vector of addresses that are not currently banned or whose ban period has expired. This is useful for diagnostics, monitoring, or when you need to know which DAPI nodes are currently available for making requests.

Examples

use rs_dapi_client::{DapiClient, AddressList, RequestSettings};

let address_list = "http://127.0.0.1:3000,http://127.0.0.1:3001".parse().unwrap();
let client = DapiClient::new(address_list, RequestSettings::default());

// Get all currently available (non-banned) addresses
let live_addresses = client.get_live_addresses();
println!("Available DAPI nodes: {}", live_addresses.len());

impl DapiClient

pub const DUMP_FILE_PREFIX: &'static str = "msg"

Prefix of dump files.

pub fn dump_dir(self, dump_dir: Option<PathBuf>) -> Self

Define directory where dumps of all traffic will be saved.

Each request and response pair will be saved to a JSON file in dump_dir. Data is saved as DumpData structure. Any errors are logged on warn level and ignored.

Dump file name is generated by DumpData::filename().

Useful for debugging and mocking. See also MockDapiClient::load().

Trait Implementations

impl Clone for DapiClient

fn clone(&self) -> DapiClient

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl DapiRequestExecutor for DapiClient

fn execute<'life0, 'async_trait, R>( &'life0 self, request: R, settings: RequestSettings, ) -> Pin<Box<dyn Future<Output = ExecutionResult<R::Response, DapiClientError>> + Send + 'async_trait>>

where R: TransportRequest + Mockable + 'async_trait, R::Response: Mockable, TransportError: Mockable, Self: 'async_trait, 'life0: 'async_trait,

Execute the DapiRequest.

impl Debug for DapiClient

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

Formats the value using the given formatter.