Struct AleoHttpClient 

pub struct AleoHttpClient {
    pub base_url: String,
    /* private fields */
}

HTTP client with browser-like headers for Aleo network interaction.

Fields

base_url: String

Base URL for REST endpoints (e.g. https://api.explorer.provable.com/v2/testnet)

Implementations

impl AleoHttpClient

pub fn new(base_url: &str) -> Result<Self>

Create a new client pointing at an Aleo node (default RPC endpoint).

pub fn new_with_rpc(base_url: &str, rpc_url: &str) -> Result<Self>

Create a client with a custom RPC URL (useful for testing with wiremock).

pub async fn fetch_program( &self, program_id: &str, ) -> Result<Program<TestnetV0>>

Fetch a program from the network (REST GET).

pub async fn fetch_state_root( &self, ) -> Result<(<TestnetV0 as Network>::StateRoot, u32)>

Fetch latest state root + block height (REST GET).

pub async fn broadcast_transaction(&self, tx_json: String) -> Result<String>

Broadcast a JSON-serialized transaction (REST POST).

pub async fn fetch_transaction(&self, tx_id: &str) -> Result<String>

Fetch a transaction by its ID from the explorer API. Returns the raw JSON response as a String.

pub async fn wait_for_confirmation(&self, tx_id: &str) -> Result<()>

Poll for confirmation (up to 30 attempts, 5s apart).

pub async fn fetch_mapping_value_rest( &self, program_id: &str, mapping_name: &str, key: &str, ) -> Result<Option<u64>>

Query a mapping value via REST API (GET /program/{id}/mapping/{name}/{key}).

Returns None if the key does not exist (404).

pub async fn fetch_mapping_value( &self, program_id: &str, mapping_name: &str, key: &str, ) -> Result<Option<String>>

Query a mapping value via JSON-RPC getMappingValue.

Returns None if the key does not exist in the mapping.

pub async fn fetch_block_height(&self) -> Result<u32>

Fetch the current block height (REST GET).

pub async fn fetch_state_root_only( &self, ) -> Result<<TestnetV0 as Network>::StateRoot>

Fetch latest state root only (REST GET).

pub async fn fetch_records(&self, view_key: &str) -> Result<String>

Fetch unspent records by view key via JSON-RPC.

pub async fn fetch_all_records( &self, start: u32, end: u32, page: u32, per_page: u32, ) -> Result<Value>

Fetch all records within a block range via JSON-RPC records/all.

Returns raw record ciphertexts that must be decrypted with a view key.

pub async fn find_private_credits_records( &self, view_key: &str, ) -> Result<Vec<(String, u64)>>

Find unspent credits.aleo record ciphertexts owned by the given view key. Scans recent blocks via records/all, decrypts each record, and returns those containing credits.aleo with the owner matching the view key’s address.

Trait Implementations

impl Clone for AleoHttpClient

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AleoHttpClient

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

Formats the value using the given formatter.