Struct TokenBalance 

pub struct TokenBalance {
    pub amount: U256,
    pub amount_usd: Option<Quantity>,
    pub token: Token,
}

Represents the balance of a specific ERC-20 token held in a wallet.

This struct tracks the raw token amount along with optional USD valuation and the token metadata.

Fields

amount: U256

The raw token amount as a 256-bit unsigned integer.

amount_usd: Option<Quantity>

The optional USD equivalent value of the token balance.

token: Token

The token metadata including chain, address, name, symbol, and decimals.

Implementations

impl TokenBalance

pub const fn new(amount: U256, token: Token) -> Self

Creates a new TokenBalance instance.

pub fn as_quantity(&self) -> Result<Quantity>

Converts the raw token amount to a human-readable Quantity.

Errors

Returns an error if the U256 amount cannot be converted to a Quantity.

pub fn set_amount_usd(&mut self, amount_usd: Quantity)

Sets the USD equivalent value for this token balance.

Trait Implementations

impl Debug for TokenBalance

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

Formats the value using the given formatter.

impl Display for TokenBalance

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

Formats the value using the given formatter.