bridge/interfaces/ExternalChainBalance.md

Balance for a single token on an external chain (Ethereum or Solana)

Represents either a native token (ETH/SOL) or a token contract (ERC-20/SPL).

Example

// Native ETH balance
const ethBalance: ExternalChainBalance = {
  symbol: 'ETH',
  quantity: '1.500000000000000000',
  decimals: 18,
  contractAddress: null,
  isNative: true,
};

// ERC-20 GALA balance
const galaBalance: ExternalChainBalance = {
  symbol: 'GALA',
  quantity: '1000.00000000',
  decimals: 8,
  contractAddress: '0x15D4c048F83bd7e37d49eA4C83a07267Ec4203dA',
  isNative: false,
};

Properties

Property	Type	Description
contractAddress	string | null	Contract address (ERC-20) or mint address (SPL), null for native tokens
decimals	number	Token decimals
isNative	boolean	Whether this is the native token (ETH/SOL)
quantity	string	Balance as decimal string (e.g., "123.45678901")
symbol	string	Token symbol (e.g., "GALA", "GWETH", "ETH", "SOL")