Token Lists and Whitelists

THORChain restricts support for tokens on EVM and TRON chains to explicitly whitelisted contracts. This protects users from malicious or incompatible tokens.

Purpose of Token Whitelists

Prevent unsupported tokens from being deposited, swapped, or added to pools
Avoid edge-case ERC-20 behavior (e.g., tokens with transfer fees, blacklists, or non-standard returns)
Provide transparency to integrators and wallets

Whitelist Enforcement

Applies to EVM chains (ETH, AVAX, BSC, BASE, POL), TRON (TRC-20 tokens), and Solana (coming soon)
If a token is not on the list, it will be rejected at the Router contract level
Tokens must be listed to be eligible for THORChain pools, swaps, and LP adds

Whitelist Sources

Each chain has its own maintained JSON whitelist:

Chain	Whitelist URL
Ethereum (ETH)	`eth_mainnet_latest.json`
Avalanche (AVAX)	`avax_mainnet_latest.json`
Binance Smart Chain (BSC)	`bsc_mainnet_latest.json`
Base (BASE)	`base_mainnet_latest.json`
Polygon (POL)	`pol_mainnet_latest.json`
TRON (TRC-20)	`tron_mainnet_latest.json`

Note: Some tokens like $USDT or $USDC exist across multiple chains and may require separate listing per chain.

How to Request New Tokens

To add a token:

Fork the appropriate repository (e.g., THORNode)
Locate the relevant token list (e.g., common/tokenlist/ethtokens/eth_mainnet_latest.json)
Add the token with required metadata (name, symbol, address, decimals)
Submit a merge request for review

See example MR: thornode!2085

Token List Location

All token whitelists are stored in the THORNode repository under:

common/tokenlist/
├── ethtokens/
├── avaxtokens/
├── bsctokens/
├── basetokens/
├── poltokens/
└── trontokens/