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 retrieveRequestForFunds[]. - Use history to show status updates or allow retries.
Use constants for UI
- Use
SUPPORTED_CHAINSfor chain IDs. - Use
CHAIN_METADATAfor names, logos, explorers, native currency. - Use
TOKEN_CONTRACT_ADDRESSESfor token addresses by chain. - Use
NEXUS_EVENTSfor 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.