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

```json
{
  "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**:
```bash
# 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**:
```bash
# 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:

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