Struct Client 

pub struct Client { /* private fields */ }

Implementations

impl Client

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

Errors

pub fn new_with_timeout(base_url: &str, timeout: u64) -> Result<Self, Error>

👎Deprecated: To be marked private in a future major release. Please use new_with_headers instead.

Create a new client with a timeout in seconds

Errors

pub fn new_with_headers( base_url: &str, additional_headers: HeaderMap, ) -> Result<Self, Error>

Create a new client with additional headers

Errors

pub fn base_url(&self) -> &str

pub fn client(&self) -> &HttpClient

pub async fn friendbot_url(&self) -> Result<String, Error>

Errors

pub async fn verify_network_passphrase( &self, expected: Option<&str>, ) -> Result<String, Error>

Errors

pub async fn get_network(&self) -> Result<GetNetworkResponse, Error>

Errors

pub async fn get_health(&self) -> Result<GetHealthResponse, Error>

Errors

pub async fn get_latest_ledger(&self) -> Result<GetLatestLedgerResponse, Error>

Errors

pub async fn get_ledgers( &self, start: LedgerStart, limit: Option<usize>, format: Option<String>, ) -> Result<GetLedgersResponse, Error>

Errors

pub async fn get_account(&self, address: &str) -> Result<AccountEntry, Error>

Errors

pub async fn get_fee_stats(&self) -> Result<GetFeeStatsResponse, Error>

Get network fee stats

Errors

pub async fn get_version_info(&self) -> Result<GetVersionInfoResponse, Error>

Errors

pub async fn send_transaction( &self, tx: &TransactionEnvelope, ) -> Result<Hash, Error>

Send a transaction to the network and get back the hash of the transaction.

Errors

pub async fn send_transaction_polling( &self, tx: &TransactionEnvelope, ) -> Result<GetTransactionResponse, Error>

Errors

pub async fn simulate_transaction_envelope( &self, tx: &TransactionEnvelope, auth_mode: Option<AuthMode>, ) -> Result<SimulateTransactionResponse, Error>

Errors

pub async fn next_simulate_transaction_envelope( &self, tx: &TransactionEnvelope, auth_mode: Option<AuthMode>, resource_config: Option<ResourceConfig>, ) -> Result<SimulateTransactionResponse, Error>

Internal function, not to be used.

Errors

pub async fn get_transaction( &self, tx_id: &Hash, ) -> Result<GetTransactionResponse, Error>

Errors

pub async fn get_transactions( &self, request: GetTransactionsRequest, ) -> Result<GetTransactionsResponse, Error>

Errors

pub async fn get_transaction_polling( &self, tx_id: &Hash, timeout_s: Option<Duration>, ) -> Result<GetTransactionResponse, Error>

Poll the transaction status. Can provide a timeout in seconds, otherwise uses the default timeout.

It uses exponential backoff with a base of 1 second and a maximum of 30 seconds.

Errors

• Error::TransactionSubmissionTimeout if the transaction status is not found within the timeout
• Error::TransactionSubmissionFailed if the transaction status is “FAILED”
• Error::UnexpectedTransactionStatus if the transaction status is not one of “SUCCESS”, “FAILED”, or NOT_FOUND
• json_rpsee Errors

pub async fn get_ledger_entries( &self, keys: &[LedgerKey], ) -> Result<GetLedgerEntriesResponse, Error>

Errors

pub async fn get_full_ledger_entries( &self, ledger_keys: &[LedgerKey], ) -> Result<FullLedgerEntries, Error>

Errors

pub async fn get_events( &self, start: EventStart, event_type: Option<EventType>, contract_ids: &[String], topics: &[String], limit: Option<usize>, ) -> Result<GetEventsResponse, Error>

Errors

pub async fn get_contract_data( &self, contract_id: &[u8; 32], ) -> Result<ContractDataEntry, Error>

Errors

pub async fn get_remote_wasm( &self, contract_id: &[u8; 32], ) -> Result<Vec<u8>, Error>

👎Deprecated: To be removed in future versions, use get_ledger_entries()

Errors

pub async fn get_remote_wasm_from_hash( &self, hash: Hash, ) -> Result<Vec<u8>, Error>

👎Deprecated: To be removed in future versions, use get_ledger_entries()

Errors

pub async fn get_contract_instance( &self, contract_id: &[u8; 32], ) -> Result<ScContractInstance, Error>

Get the contract instance from the network. Could be normal contract or native Stellar Asset Contract (SAC)

Errors

• Could fail to find contract or have a network error

Trait Implementations

impl Clone for Client

fn clone(&self) -> Client

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Client

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

Formats the value using the given formatter.