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.