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**:
```bash
# 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**:
```markdown
### 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:
   ```markdown
   ## 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:

```bash
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