explorer-monorepo/docs/TOKEN_LIST_SUBMISSION_LINKS.md

Token List Submission Links

Current Token List Status

Token List URL: ✅ Already Hosted

• https://raw.githubusercontent.com/Defi-Oracle-Meta-Blockchain/metamask-integration/main/config/token-list.json

Contains: WETH9, WETH10, ETH/USD Oracle (3 tokens)

---

Where to Submit Token Lists

1. Uniswap Token Lists Registry (Primary)

Repository: https://github.com/Uniswap/token-lists

Purpose: Official registry for token lists used by Uniswap, MetaMask, and other DeFi apps

Submission Process:

1. Fork the repository: https://github.com/Uniswap/token-lists
2. Add your token list to the repository
3. Create a Pull Request

Links:

• Repository: https://github.com/Uniswap/token-lists
• Documentation: https://github.com/Uniswap/token-lists#readme
• Schema: https://uniswap.org/tokenlist.schema.json
• Token Lists Website: https://tokenlists.org/ (if available)

Steps:

# 1. Fork: https://github.com/Uniswap/token-lists
# 2. Clone your fork
git clone https://github.com/YOUR_USERNAME/token-lists.git
cd token-lists

# 3. Add your token list
# Copy dbis-138.tokenlist.json to the repository
# Follow their directory structure

# 4. Create PR
git checkout -b add-dbis-chain-138-token-list
git add .
git commit -m "Add DBIS Chain 138 token list"
git push origin add-dbis-chain-138-token-list
# Then create PR on GitHub

---

2. Token Lists Aggregators

Token Lists.org (if available)

• Website: https://tokenlists.org/
• Purpose: Aggregator and discovery platform for token lists

CoinGecko Token Lists

• Website: https://www.coingecko.com/
• Purpose: May accept token list submissions for their API

---

3. Chainlist.org (Mention in PR Description)

Note: Token lists are NOT part of the chain schema, but you can mention the token list URL in your Chainlist PR description.

Current PR: https://github.com/defiQUG/chains/pull/1

Add to PR Description:

### Token List
A token list for ChainID 138 is available at:
- **URL**: https://raw.githubusercontent.com/Defi-Oracle-Meta-Blockchain/metamask-integration/main/config/token-list.json
- **Tokens**: WETH9, WETH10, ETH/USD Oracle
- **Format**: Uniswap Token Lists Specification

Users can add this token list in MetaMask Settings → Security & Privacy → Token Lists.

---

4. MetaMask Community Resources

MetaMask Documentation:

• Token Lists Guide: https://docs.metamask.io/wallet/reference/token-lists/
• Community Forums: https://community.metamask.io/

Note: MetaMask doesn't have a formal submission process, but users can add token lists manually.

---

5. Individual Token Submissions (Alternative)

ethereum-lists/tokens Repository:

• Repository: https://github.com/ethereum-lists/tokens
• Purpose: Individual token definitions (not token lists)
• Format: One JSON file per token

If you want to submit individual tokens:

1. Fork: https://github.com/ethereum-lists/tokens
2. Create files: tokens/ethereum/138/<address>.json for each token
3. Create PR

Tokens to submit:

• tokens/ethereum/138/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2.json (WETH9)
• tokens/ethereum/138/0xf4BB2e28688e89fCcE3c0580D37d36A7672E8A9f.json (WETH10)
• tokens/ethereum/138/0x3304b747E565a97ec8AC220b0B6A1f6ffDB837e6.json (ETH/USD Oracle)

---

Recommended Submission Order

Priority 1: Uniswap Token Lists (Most Important)

Why:

• Official registry
• Used by Uniswap, MetaMask, and many DeFi apps
• Most discoverable

Link: https://github.com/Uniswap/token-lists

Action: Create PR to add your token list

---

Priority 2: Mention in Chainlist PR

Why:

• Increases discoverability
• Users can find token list when adding network

Link: https://github.com/defiQUG/chains/pull/1

Action: Update PR description to include token list URL

---

Priority 3: Individual Token Submissions (Optional)

Why:

• Some tools prefer individual token files
• Better for token-specific searches

Link: https://github.com/ethereum-lists/tokens

Action: Submit individual token JSON files

---

Quick Submission Guide

For Uniswap Token Lists:

1. Go to: https://github.com/Uniswap/token-lists
2. Fork the repository
3. Add your token list:
   • File: src/tokens/dbis-138.tokenlist.json (or follow their structure)
   • Content: Your token list JSON
4. Create PR with description:

   ## Add DBIS Chain 138 Token List
   
   This token list includes:
   - WETH9 (Wrapped Ether)
   - WETH10 (Wrapped Ether v10)
   - ETH/USD Price Feed Oracle
   
   Token List URL: https://raw.githubusercontent.com/Defi-Oracle-Meta-Blockchain/metamask-integration/main/config/token-list.json
   

---

Current Token List Information

Name: DBIS Chain 138 Token List
Version: 1.1.0
Chain ID: 138
Tokens: 3 (WETH9, WETH10, ETH/USD Oracle)
Hosted URL: https://raw.githubusercontent.com/Defi-Oracle-Meta-Blockchain/metamask-integration/main/config/token-list.json
Format: Uniswap Token Lists Specification
Schema: https://uniswap.org/tokenlist.schema.json

---

Validation

Before submitting, validate your token list:

cd /home/intlc/projects/proxmox
node token-lists/scripts/validate-token-list.js token-lists/lists/dbis-138.tokenlist.json

---

Last Updated: 2025-12-24 Status: Token list ready for submission