Skip to main content

Supported blockchains

The App Kit SDK supports the following capabilities and wallet adapters for each supported blockchain.
Swap is available on mainnet only, with the exception of Arc testnet.

Blockchain identifiers

For most blockchains, the identifier is the blockchain name with any spaces replaced by underscores (for example, Arc Testnet → Arc_Testnet). Identifiers are case-sensitive and match the per-capability enums (BridgeChain, SwapChain, UnifiedBalanceChain, EarnChain) exported from @circle-fin/app-kit:
Some blockchains have identifier deviations:

Discover supported blockchains programmatically

The App Kit SDK provides a way to fetch supported blockchain data in code. This is useful for building a blockchain picker, validating user input against supported blockchains, or looking up metadata like explorer URLs and testnet flags. Each method returns ChainDefinition[] with fields like name, isTestnet, explorerUrl, and protocol config. See getSupportedChains for the method signature and BaseChainDefinition for the full field list.
Pass an optional operationType to narrow by capability:
The top-level App Kit SDK accepts only operationType. Bridge filters are available on the standalone Bridge Kit. Unified Balance forwarder filters are available on the namespaced API:

Supported tokens

You can specify either a contract address or an alias for any supported token.
Each capability supports different tokens:
  • Send: Any token. Use token aliases for common tokens or the token’s contract address for other tokens.
  • Bridge: USDC, EURC, WETH, cirBTC, and third-party assets registered with CCTPx.
  • Swap:
    • Any tokens with enough liquidity to trade with major stablecoins such as USDC, EURC, USDT, USDe, DAI, and PYUSD.
    • Native tokens on blockchains where Swap is supported.
    • On Arc, USDC, EURC, and cirBTC.
  • Unified Balance: USDC only.
  • Onramp: USDC and EURC.
  • Earn: USDC and EURC.

Token aliases

App Kits works with any supported token when you supply the contract address. For convenience, you can also pass any of these case-insensitive aliases instead. The App Kit SDK resolves each alias to the token’s address on the target blockchain.
  • USDC
  • EURC
  • cirBTC
  • USDT
  • USDe
  • DAI
  • PYUSD
  • WETH
  • WBTC
  • WSOL
  • WAVAX
  • WPOL
  • POL
  • PLUME
  • MON
  • NATIVE: Uses the blockchain’s native token.