Struct thor_devkit::network::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_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.