proxmox/docs/04-configuration/TOKEN_LIST_PR_REVIEW.md

Token List PR Review — How Each Repo Handles Token Lists

Cloned repos: /home/intlc/projects/token-lists, chains, wallet-core, DefiLlama-Adapters
Last Updated: 2026-02-28

---

1. Uniswap token-lists (/home/intlc/projects/token-lists)

What it is

• Schema + TypeScript package, not a registry of token lists
• Defines the Uniswap token list JSON schema (src/tokenlist.schema.json)
• Schema ID: https://uniswap.org/tokenlist.schema.json
• Used by tokenlists.org, Uniswap Interface, MetaMask, etc.

Token list format (from example.tokenlist.json)

{
  "name": "My Token List",
  "logoURI": "ipfs://...",
  "keywords": ["audited", "verified"],
  "tags": { "stablecoin": { "name": "Stablecoin", "description": "..." } },
  "timestamp": "2020-06-12T00:00:00+00:00",
  "tokens": [
    {
      "chainId": 1,
      "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "symbol": "USDC",
      "name": "USD Coin",
      "decimals": 6,
      "logoURI": "ipfs://..."
    }
  ],
  "version": { "major": 1, "minor": 0, "patch": 0 }
}

Cross-chain (from example-crosschain.tokenlist.json)

• Same structure; tokens can have extensions.bridgeInfo mapping chainId → bridged address
• Each chain gets its own token entry with chainId

PR process

• This repo does NOT host token lists — it only provides the schema
• To add a list: host it (GitHub Raw, IPFS, ENS) and submit to tokenlists.org via https://github.com/Uniswap/tokenlists-org/issues (template: "add list request")
• Or use your own URL (e.g. explorer.d-bis.org/api/v1/report/token-list)

Chain 138 action

• Ensure proxmox/token-lists/lists/dbis-138.tokenlist.json validates against schema
• Host at GitHub Raw or explorer API
• Submit URL to tokenlists.org

---

2. Chainlist / ethereum-lists/chains (/home/intlc/projects/chains)

What it is

• Chain metadata (RPC, explorers, native currency) — not token lists
• Used by chainlist.org, wallets, MESC, etc.
• File: _data/chains/eip155-{chainId}.json

Chain format (from eip155-1.json)

{
  "name": "Ethereum Mainnet",
  "chain": "ETH",
  "icon": "ethereum",
  "rpc": ["https://mainnet.infura.io/...", "..."],
  "features": [{"name": "EIP155"}, {"name": "EIP1559"}],
  "faucets": [],
  "nativeCurrency": { "name": "Ether", "symbol": "ETH", "decimals": 18 },
  "infoURL": "https://ethereum.org",
  "shortName": "eth",
  "chainId": 1,
  "networkId": 1,
  "slip44": 60,
  "explorers": [{ "name": "etherscan", "url": "https://etherscan.io", "standard": "EIP3091" }]
}

PR process

1. Add _data/chains/eip155-138.json
2. If using icon, add _data/icons/defioraclemeta.json (IPFS URL for logo)
3. Run ./gradlew run and npx prettier --write _data/*/*.json
4. Open PR to https://github.com/ethereum-lists/chains

Chain 138 status

• Not present (no eip155-138.json in chains repo)
• PR-ready: proxmox/docs/04-configuration/pr-ready/eip155-138.json

---

3. Trust Wallet wallet-core (/home/intlc/projects/wallet-core)

What it is

• Coin/chain registry for Trust Wallet app
• registry.json — flat array of coins/chains
• EVM chains have: id, name, coinId, symbol, blockchain, chainId, explorer, info.rpc

EVM chain format (from registry.json)

{
  "id": "ethereum",
  "name": "Ethereum",
  "coinId": 60,
  "symbol": "ETH",
  "decimals": 18,
  "blockchain": "Ethereum",
  "derivation": [{ "path": "m/44'/60'/0'/0/0" }],
  "curve": "secp256k1",
  "publicKeyType": "secp256k1Extended",
  "chainId": "1",
  "addressHasher": "keccak256",
  "explorer": {
    "url": "https://etherscan.io",
    "txPath": "/tx/",
    "accountPath": "/address/",
    "sampleTx": "...",
    "sampleAccount": "..."
  },
  "info": {
    "url": "https://ethereum.org",
    "source": "https://github.com/ethereum/go-ethereum",
    "rpc": "https://mainnet.infura.io",
    "documentation": "..."
  }
}

PR process

1. Add entry to registry.json (EVM: blockchain: "Ethereum", chainId, explorer, info.rpc)
2. Run codegen: cd codegen-v2 && cargo run -- new-evmchain 138 (or per their CLI)
3. Extend derivation tests
4. Open PR to https://github.com/trustwallet/wallet-core

Chain 138 status

• Not present
• PR-ready: proxmox/docs/04-configuration/pr-ready/trust-wallet-registry-chain138.json

---

4. DefiLlama-Adapters (/home/intlc/projects/DefiLlama-Adapters)

What it is

• Protocol TVL adapters — not token lists
• Each project (e.g. dodo, 1inch) has index.js that exports tvl(api) per chain
• DefiLlama uses chain keys: ethereum, bsc, polygon, arbitrum, avax, optimism, base, etc.

Adapter format (from dodo/index.js)

const config = {
  ethereum: { dvmFactory: '0x...', fromBlock: 10613640, ... },
  arbitrum: { dvmFactory: '0x...', fromBlock: 226578, ... },
  // Add new chain: chain138: { ... }
};

Object.keys(config).forEach(chain => {
  module.exports[chain] = {
    tvl: async (api) => {
      // Fetch balances, return { 'ethereum:0xToken': balance }
    }
  };
});

PR process

1. Add adapter under projects/{protocol-name}/
2. Export tvl (and optionally staking, borrowed) per chain
3. Chain 138 would need DefiLlama to add chain138 as a supported chain key first (see docs.llama.fi)
4. Open PR to https://github.com/DefiLlama/DefiLlama-Adapters

Chain 138 action

• DefiLlama may not have chain138 as a chain key yet
• Check helper/chains.js or similar for supported chains
• If adding DODO/other protocol on Chain 138, add config entry + tvl logic

---

Summary: PR Targets by Repo

Repo	Content	Chain 138 PR
token-lists	Schema only; lists hosted elsewhere	N/A — use tokenlists.org issue to add list URL
chains	Chain metadata (eip155-138.json)	Add _data/chains/eip155-138.json
wallet-core	Coin/chain registry	Add entry to registry.json + codegen
DefiLlama-Adapters	Protocol TVL adapters	Add adapter for DODO/etc. on Chain 138 (if chain supported)

---

References

• PUBLICATION_LOCATIONS_MASTER
• pr-ready/eip155-138.json
• pr-ready/trust-wallet-registry-chain138.json
• ADD_CHAIN138_TO_TRUST_WALLET