Token modal

The token modal is the main asset picker used in Swap (and related token-pick flows).

Core Behavior

• Search by symbol/name/address
• Select network from right panel
• Pick from favorites + full list
• Supports direct token address lookups

Wallet-Aware Behavior

When an EVM wallet is connected on the selected chain:

• Tokens held by the connected wallet are moved to the top of the list
• Each row shows balance on the right
• Each row shows USD value on the right (under balance)

If no wallet is connected (or selected chain is non-EVM), token rows still work but holdings column uses fallback values.

Row Anatomy

Left side:

• token icon + chain badge
• symbol
• token contract short address
• token name

Right side:

• token balance
• estimated USD value

Search Details

• Search is debounced
• Local token cache is used for faster repeat queries
• Address-style query can trigger exact token fetch fallback

Pagination and Scrolling

Large token lists use incremental rendering while you scroll to keep UI responsive.

Why Holdings First?

Because scrolling through 200 assets to find the 2 you actually own is a tax on human dignity.