[feature] Support ERC20 Token Balance Display in Account Modal

[ollisami]

What problem does this new feature solve?

After updating to the latest version (1.8.15) of @reown/appkit, the ability to display ERC20 token balances (instead of native currency) in the account modal no longer works. Previously, this could be configured using the tokens parameter in createAppKit().

Use Case

Our platform operates primarily with USDC on Arbitrum network. Users deposit, withdraw, and interact with the platform using USDC, not ETH. Having the account modal display ETH balance is confusing for our users, as they never interact with ETH directly on our platform.

Previous Behavior

In earlier versions (1.8.13), we could configure the modal to display USDC balance using:

export const modal = createAppKit({
  adapters: [adapter],
  projectId,
  networks: [arbitrum],
  defaultNetwork: arbitrum,
  metadata: metadata,
  tokens: {
    "eip155:42161": {
      address: "0xaf88d065e77c8cc2239327c5edb3a432268e5831" // USDC on Arbitrum
    }
  }
});

This configuration would display the USDC balance in the account modal instead of ETH.

Current Behavior (After Update)

After updating to the latest version of AppKit:

The tokens parameter is still accepted in the configuration. However, it no longer affects the balance displayed in the account modal. The modal always shows ETH (native currency) balance. When connecting the wallet, the modal shows a loading spinner and eventually displays ETH balance only.

Describe the solution you'd like

Expected Behavior

The account modal should display the balance of the configured ERC20 token (USDC) as the primary balance, similar to how it worked in previous versions.

Environment

Package: @reown/[email protected] Adapter: @reown/[email protected] Network: Arbitrum (Chain ID: 42161) Token: USDC (0xaf88d065e77c8cc2239327c5edb3a432268e5831) Framework: Next.js 15

Additional Context

For DApps that operate exclusively or primarily with stablecoins (USDC, USDT, DAI, etc.) rather than native currencies, it would be valuable to have the option to:

1. Display ERC20 token balance as the primary balance in the account modal
2. Optionally show native currency balance as secondary information
3. Support the tokens parameter functionality that existed in previous versions

This feature would significantly improve UX for stablecoin-focused platforms, especially on L2s where users may hold minimal native currency for gas (or none at all with account abstraction).

[linear[bot]]

APKT-4341

[PaulRBerg]

This would be an incredibly useful feature!

Something like Uniswap's balance viewer would be sick: