> For the complete documentation index, see [llms.txt](https://docs.kumbaya.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kumbaya.xyz/developers/resources/token-list.md).

# Default Token List

Kumbaya publishes a curated token list at [**`@kumbaya_xyz/default-token-list`**](https://www.npmjs.com/package/@kumbaya_xyz/default-token-list) (also at [github.com/Kumbaya-xyz/default-token-list](https://github.com/Kumbaya-xyz/default-token-list)).

## What it is

A standard [Uniswap-format token list](https://tokenlists.org/) - JSON describing every curated token across MegaETH mainnet and testnet, with addresses, decimals, symbol, name, logo URI, and chain ID.

## Use it when

* Building a token picker that shouldn't show everything ever deployed
* Validating that a token symbol matches a known address
* Bootstrapping a wallet with sensible defaults

## Install

```bash
npm install @kumbaya_xyz/default-token-list
```

```ts
import tokenList from '@kumbaya_xyz/default-token-list'
const megaethTokens = tokenList.tokens.filter(t => t.chainId === 4326)
```

## Adding a token

Open a PR against the [default-token-list repo](https://github.com/Kumbaya-xyz/default-token-list) with the token entry and follow the contribution guidelines in its README.