Struct TronClient 

pub struct TronClient { /* private fields */ }

Tron blockchain client.

Uses TronGrid REST API for data retrieval.

Implementations

impl TronClient

pub fn new(config: &ChainsConfig) -> Result<Self>

Creates a new Tron client with the given configuration.

Arguments

• config - Chain configuration containing API endpoint and keys

Returns

Returns a configured TronClient instance.

Examples

use scope::chains::TronClient;
use scope::config::ChainsConfig;

let config = ChainsConfig::default();
let client = TronClient::new(&config).unwrap();

pub fn with_api_url(api_url: &str) -> Self

Creates a client with a custom API URL.

Arguments

• api_url - The TronGrid API endpoint URL

pub fn chain_name(&self) -> &str

Returns the chain name.

pub fn native_token_symbol(&self) -> &str

Returns the native token symbol.

pub async fn get_balance(&self, address: &str) -> Result<Balance>

Fetches the TRX balance for an address.

Arguments

• address - The Tron address (T-address format)

Returns

Returns a Balance struct with the balance in multiple formats.

Errors

Returns ScopeError::InvalidAddress if the address format is invalid. Returns ScopeError::Request if the API request fails.

pub async fn get_trc20_balances( &self, address: &str, ) -> Result<Vec<Trc20TokenBalance>>

Fetches TRC-20 token balances for an address.

Uses the TronGrid /v1/accounts/{address} endpoint which includes TRC-20 balances in the account data.

pub async fn get_token_info(&self, contract_address: &str) -> Result<Token>

Fetches TRC-20 token info from Tronscan API.

Returns symbol, name, decimals, and other metadata for a TRC-20 contract.

pub async fn get_token_holders( &self, contract_address: &str, limit: u32, ) -> Result<Vec<TokenHolder>>

Fetches top TRC-20 token holders from Tronscan API.

Returns holders sorted by balance (largest first).

pub async fn get_token_holder_count( &self, contract_address: &str, ) -> Result<u64>

Fetches total holder count for a TRC-20 token.

pub async fn enrich_balance_usd(&self, balance: &mut Balance)

Enriches a balance with a USD value using DexScreener price lookup.

Note: Tron native token price lookup via DexScreener is not yet supported. This is a placeholder that uses CoinGecko-style simple price API as fallback.

pub async fn get_transaction(&self, hash: &str) -> Result<Transaction>

Fetches transaction details by hash.

Arguments

• hash - The transaction hash

Returns

Returns Transaction details.

pub async fn get_transactions( &self, address: &str, limit: u32, ) -> Result<Vec<Transaction>>

Fetches recent transactions for an address.

Arguments

• address - The address to query
• limit - Maximum number of transactions

Returns

Returns a vector of Transaction objects.

pub async fn get_block_number(&self) -> Result<u64>

Fetches the current block number.

Trait Implementations

impl ChainClient for TronClient

fn chain_name(&self) -> &str

Returns the name of the blockchain network.

fn native_token_symbol(&self) -> &str

Returns the native token symbol (e.g., “ETH”, “MATIC”).

fn get_balance<'life0, 'life1, 'async_trait>( &'life0 self, address: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Balance>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Fetches the native token balance for an address.

fn enrich_balance_usd<'life0, 'life1, 'async_trait>( &'life0 self, balance: &'life1 mut Balance, ) -> Pin<Box<dyn Future<Output = ()> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Enriches a balance with USD valuation via DexScreener.

fn get_transaction<'life0, 'life1, 'async_trait>( &'life0 self, hash: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Transaction>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Fetches transaction details by hash.

fn get_transactions<'life0, 'life1, 'async_trait>( &'life0 self, address: &'life1 str, limit: u32, ) -> Pin<Box<dyn Future<Output = Result<Vec<Transaction>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Fetches recent transactions for an address.

fn get_block_number<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<u64>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Fetches the current block number.

fn get_token_balances<'life0, 'life1, 'async_trait>( &'life0 self, address: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Vec<TokenBalance>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Fetches token balances for an address.

fn get_token_info<'life0, 'life1, 'async_trait>( &'life0 self, address: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Token>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Fetches token information for a contract address.

fn get_token_holders<'life0, 'life1, 'async_trait>( &'life0 self, address: &'life1 str, limit: u32, ) -> Pin<Box<dyn Future<Output = Result<Vec<TokenHolder>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Fetches top token holders for a contract address.

fn get_token_holder_count<'life0, 'life1, 'async_trait>( &'life0 self, address: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<u64>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Fetches total token holder count for a contract address.

fn get_code<'life0, 'life1, 'async_trait>( &'life0 self, _address: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Fetches bytecode at address (EVM: eth_getCode). Returns “0x” for EOA, non-empty hex for contracts. Default: not supported.

impl Clone for TronClient

fn clone(&self) -> TronClient

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TronClient

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

Formats the value using the given formatter.

impl Default for TronClient

fn default() -> Self

Returns the “default value” for a type.