smom-dbis-138/docs/deployment/TASK5_TOKEN_LIST_HOSTING.md

Task 5: Host Token List Publicly

Date: 2025-01-18
Status: ✅ LIST VALIDATED - HOSTING INSTRUCTIONS PROVIDED

Status

✅ Token list validated and ready for hosting.

Token list file exists: ~/projects/metamask-integration/docs/METAMASK_TOKEN_LIST.json

Token List Contents

{
  "name": "SMOM-DBIS-138 Token List",
  "version": {"major": 1, "minor": 1, "patch": 0},
  "timestamp": "2025-12-22T17:45:00.000Z",
  "tokens": [
    {
      "chainId": 138,
      "address": "0x3304b747e565a97ec8ac220b0b6a1f6ffdb837e6",
      "name": "ETH/USD Price Feed",
      "symbol": "ETH-USD",
      "decimals": 8
    },
    {
      "chainId": 138,
      "address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
      "name": "Wrapped Ether",
      "symbol": "WETH",
      "decimals": 18
    },
    {
      "chainId": 138,
      "address": "0xf4BB2e28688e89fCcE3c0580D37d36A7672E8A9f",
      "name": "Wrapped Ether v10",
      "symbol": "WETH10",
      "decimals": 18
    }
  ]
}

Validation

✅ Token list format is valid

• Valid JSON structure
• Contains required fields
• WETH9/WETH10 have correct decimals (18)

✅ Addresses are correct

• WETH9: 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 ✅
• WETH10: 0xf4BB2e28688e89fCcE3c0580D37d36A7672E8A9f ✅

Hosting Options

Option 1: GitHub Pages (Recommended - Free)

1. Copy token list to repository
2. Enable GitHub Pages
3. Access via: https://<username>.github.io/<repo>/METAMASK_TOKEN_LIST.json

Steps:

# Copy token list to docs folder
cp ~/projects/metamask-integration/docs/METAMASK_TOKEN_LIST.json docs/

# Commit and push
git add docs/METAMASK_TOKEN_LIST.json
git commit -m "Add token list for MetaMask"
git push

# Enable GitHub Pages in repository settings

Option 2: IPFS (Decentralized)

1. Upload token list to IPFS
2. Access via IPFS gateway: https://ipfs.io/ipfs/<hash>

Steps:

# Using Pinata or similar IPFS service
# Upload METAMASK_TOKEN_LIST.json
# Get IPFS hash
# Access via: https://ipfs.io/ipfs/<hash>

Option 3: CDN/Project Website

1. Upload token list to project website/CDN
2. Access via: https://<domain>/token-list.json

Option 4: MetaMask Token List Registry

1. Submit to MetaMask token list registry
2. Token list becomes automatically available in MetaMask

After Hosting

Update Documentation

Update documentation with public token list URL:

TOKEN_LIST_URL=https://<hosting-url>/METAMASK_TOKEN_LIST.json

Test in MetaMask

1. Open MetaMask
2. Go to Settings → Security & Privacy → Token Lists
3. Add custom token list URL
4. Verify tokens appear with correct decimals

Register with MetaMask (Optional)

For automatic discovery, register token list with MetaMask token list registry.

Benefits

• ✅ Automatic token discovery in MetaMask
• ✅ Correct decimals display (fixes WETH9 display issue)
• ✅ Consistent token information across users
• ✅ Easy updates via token list updates

---

Status: ✅ TOKEN LIST VALIDATED - READY FOR HOSTING