nexus-sdk-balances-metadata-utils

name	nexus-sdk-balances-metadata-utils
description	Fetch balances, supported chains/tokens, intent history, and use Nexus SDK formatter utilities. Use when building token/chain selectors, showing balances, or formatting UI values.

Balances, Metadata, and Utilities

Fetch bridge balances

• Call sdk.getBalancesForBridge() to list assets usable in bridge flows.
• Typical fields on each asset:
  • symbol, decimals, balance, balanceInFiat, breakdown[]
• Use for:
  • token selectors
  • max amount validation
  • per-chain balance breakdown

Fetch swap balances

• Call sdk.getBalancesForSwap(onlyNativesAndStables?) to list assets usable in swap flows.
• Use for:
  • swap token selectors
  • swap input validation
  • source selection for exact-in swaps

Fetch supported chains/tokens

• Call sdk.utils.getSupportedChains(env?) for supported chains + tokens.
• Call sdk.utils.getSwapSupportedChainsAndTokens() for swap-supported chains/tokens.
• Call sdk.getSwapSupportedChains() for chains where swaps are supported.

Fetch intent history

• Call sdk.getMyIntents(page = 1) to retrieve RequestForFunds[].
• Use history to show status updates or allow retries.

Use constants for UI

• Use SUPPORTED_CHAINS for chain IDs.
• Use CHAIN_METADATA for names, logos, explorers, native currency.
• Use TOKEN_CONTRACT_ADDRESSES for token addresses by chain.
• Use NEXUS_EVENTS for event name constants.

Use formatter utilities

• Call sdk.utils.formatTokenBalance(value, { symbol, decimals }).
• Call sdk.utils.formatTokenBalanceParts(...).
• Call sdk.utils.formatUnits(value, decimals).
• Call sdk.utils.parseUnits(value, decimals).
• Call sdk.utils.truncateAddress(address, start?, end?).
• Call sdk.utils.isValidAddress(address).
• Call sdk.utils.getCoinbaseRates() for optional fiat rates.
• Call sdk.convertTokenReadableAmountToBigInt(value, tokenSymbol, chainId) when decimals vary by chain.