> ## Documentation Index
> Fetch the complete documentation index at: https://flake-32766f49.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.