Struct ThorNode

pub struct ThorNode {
    pub base_url: Url,
    pub chain_tag: u8,
}

A simple HTTP REST client for a VeChain node.

Fields

base_url: Url

API base url

chain_tag: u8

Chain tag used for this network.

Implementations

impl ThorNode

pub const MAINNET_CHAIN_TAG: u8 = 74u8

Chain tag for mainnet

pub const MAINNET_BASE_URL: &'static str = "https://mainnet.vecha.in/"

REST API URL for mainnet (one possible)

pub const TESTNET_CHAIN_TAG: u8 = 39u8

Chain tag for testnet

pub const TESTNET_BASE_URL: &'static str = "https://testnet.vecha.in/"

REST API URL for testnet (one possible)

pub fn mainnet() -> Self

Mainnet parameters

pub fn testnet() -> Self

Testnet parameters

pub async fn fetch_transaction( &self, transaction_id: U256, ) -> AResult<Option<(Transaction, Option<TransactionMeta>)>>

Retrieve a Transaction from node by its ID.

Returns None for nonexistent transactions.

Meta can be None if a transaction was broadcasted, but not yet included into a block.

This method exists for interoperability with Transaction from other parts of library. You can get more info from node with ThorNode::fetch_extended_transaction.

pub async fn fetch_extended_transaction( &self, transaction_id: U256, ) -> AResult<Option<(ExtendedTransaction, Option<TransactionMeta>)>>

Retrieve a Transaction from node by its ID.

Returns None for nonexistent transactions.

Meta can be None if a transaction was broadcasted, but not yet included into a block.

This method returns more data than ThorNode::fetch_transaction, but is not interoperable with Transaction.

pub async fn fetch_transaction_receipt( &self, transaction_id: U256, ) -> AResult<Option<(Receipt, ReceiptMeta)>>

Retrieve a transaction receipt from node given a transaction ID.

Returns None for nonexistent or not mined transactions.

pub async fn fetch_block( &self, block_ref: BlockReference, ) -> AResult<Option<(BlockInfo, Vec<U256>)>>

Retrieve a block from node by given identifier.

Returns None for nonexistent blocks.

pub async fn fetch_best_block(&self) -> AResult<(BlockInfo, Vec<U256>)>

Retrieve a best block from node.

pub async fn fetch_block_expanded( &self, block_ref: BlockReference, ) -> AResult<Option<(BlockInfo, Vec<BlockTransaction>)>>

Retrieve a block from node by given identifier together with extended transaction details.

Returns None for nonexistent blocks.

pub async fn broadcast_transaction( &self, transaction: &Transaction, ) -> AResult<U256>

Broadcast a new Transaction to the node.

pub async fn fetch_account(&self, address: Address) -> AResult<AccountInfo>

Retrieve account details.

pub async fn fetch_account_code( &self, address: Address, ) -> AResult<Option<Bytes>>

Retrieve account code.

Returns None for non-contract accounts.

pub async fn fetch_account_storage( &self, address: Address, key: U256, ) -> AResult<U256>

Retrieve account storage at key.

Returns None for non-contract accounts or for missing storage keys.

pub async fn simulate_execution( &self, request: SimulateCallRequest, ) -> AResult<Vec<SimulateCallResponse>>

Simulate a transaction execution.

This is an equivalent of eth_call and can be used to call pure and view functions without broadcasting a transaction. See [eth_call] for a better interface

pub async fn eth_call_advanced( &self, request: EthCallRequest, block_ref: BlockReference, ) -> AResult<Vec<SimulateCallResponse>>

Call a pure or view function as defined by clause.data, possibly providing additional options.

pub async fn eth_call( &self, clause: Clause, block_ref: BlockReference, ) -> AResult<Bytes>

Call a pure or view function as defined by clause.data.

Returns byte representation of the returned data, error on revert or when unexpected payload is returned

Trait Implementations

impl Clone for ThorNode

fn clone(&self) -> ThorNode

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ThorNode

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

Formats the value using the given formatter.