# How to Add Token List to MetaMask

**Date**: $(date)  
**Token List URL**: `https://tokens.d-bis.org/config/token-list.json`  
**Network**: ChainID 138 (SMOM-DBIS-138)

---

## 📋 Step-by-Step Instructions

### Step 1: Open MetaMask Settings

1. **Open MetaMask** in your browser
2. Click the **three dots (⋮)** or **account icon** (top right)
3. Select **Settings** from the dropdown menu

**Alternative Path**:
- Click your **account icon** → **Settings**

---

### Step 2: Navigate to Token Lists

1. In the Settings menu, look for **Security & Privacy** (left sidebar)
2. Click **Security & Privacy**
3. Scroll down to find **Token Lists** section

**Note**: The exact location may vary slightly by MetaMask version, but it's always under **Settings → Security & Privacy → Token Lists**

---

### Step 3: Add Custom Token List

1. In the **Token Lists** section, you'll see:
   - Default token lists (already enabled)
   - **"Add custom token list"** button or link

2. Click **"Add custom token list"** or **"Add a token list"**

3. A dialog box will appear asking for:
   - **Token list URL** or **Token list address**

---

### Step 4: Enter Token List URL

1. In the input field, paste or type:
   ```
   https://tokens.d-bis.org/config/token-list.json
   ```

2. Click **Add** or **Save**

---

### Step 5: Verify Token List Added

After adding, you should see:

1. **Token list appears** in your list of active token lists
2. **Status**: Shows as active/enabled
3. **Tokens**: All 3 tokens from the list are now available:
   - ETH/USD Price Feed
   - WETH9 (Wrapped Ether)
   - WETH10 (Wrapped Ether v10)

---

## ✅ Verification

### Check if Tokens Are Available

1. **Go to Assets** tab in MetaMask
2. Click **"Import tokens"** or **"Add token"**
3. You should see the tokens from your list available to import

**Or**:

1. When viewing your wallet, tokens from the list should appear automatically if you have a balance

---

## 📱 Visual Guide (Text-Based)

```
MetaMask Window
├── Account Icon (top right)
│   └── Settings
│       └── Security & Privacy
│           └── Token Lists
│               └── Add custom token list
│                   └── Enter URL: https://tokens.d-bis.org/config/token-list.json
│                       └── Click Add
```

---

## 🔍 Alternative: Direct URL Method

Some MetaMask versions allow direct URL access:

1. **Copy the URL**: `https://tokens.d-bis.org/config/token-list.json`
2. **Open MetaMask**
3. **Paste URL** in the address bar (if supported)
4. MetaMask will prompt to add the token list

---

## 📋 What Happens After Adding

### Automatic Token Discovery

Once the token list is added:

1. **Tokens become available** for import in MetaMask
2. **Token metadata** is automatically loaded:
   - Token names
   - Symbols
   - Decimals
   - Logos (if configured)
   - Contract addresses

3. **No manual entry needed** for:
   - Token addresses
   - Decimals
   - Symbols

### Importing Tokens

To actually see tokens in your wallet:

1. Go to **Assets** tab
2. Click **"Import tokens"**
3. Search for or select:
   - **WETH** (WETH9)
   - **WETH10**
   - **ETH-USD** (Price Feed)
4. Click **Import**

---

## ⚠️ Troubleshooting

### Token List Not Adding

**Problem**: URL doesn't work or shows error

**Solutions**:
1. **Verify URL is correct**:
   ```
   https://tokens.d-bis.org/config/token-list.json
   ```

2. **Check network connection**

3. **Verify MetaMask is updated** to latest version

4. **Try manual import** if automatic doesn't work:
   - Go to Assets → Import tokens
   - Enter token address manually
   - Enter decimals: 18 (for WETH9/WETH10) or 8 (for ETH-USD)

### Tokens Not Appearing

**Problem**: Token list added but tokens don't show

**Solutions**:
1. **Refresh MetaMask** (close and reopen)
2. **Check you're on ChainID 138**:
   - MetaMask → Network dropdown
   - Select "SMOM-DBIS-138" or ChainID 138
3. **Manually import tokens** (see above)

### Network Not Added

**Problem**: Can't add token list because network isn't configured

**Solution**: Add ChainID 138 network first:
1. MetaMask → Add Network
2. Enter network details (see [Quick Start Guide](/docs/01-getting-started/METAMASK_QUICK_START_GUIDE.md))
3. Then add token list

---

## 📚 Related Documentation

- [MetaMask Quick Start Guide](/docs/01-getting-started/METAMASK_QUICK_START_GUIDE.md) - Add ChainID 138 network
- [Token List Verification](./METAMASK_CUSTOM_DOMAIN_VERIFICATION.md) - Verify token list is working
- [Troubleshooting Guide](/docs/09-troubleshooting/METAMASK_TROUBLESHOOTING_GUIDE.md) - Common issues and solutions

---

## 🎯 Quick Reference

**Token List URL**:
```
https://tokens.d-bis.org/config/token-list.json
```

**Path in MetaMask**:
```
Settings → Security & Privacy → Token Lists → Add custom token list
```

**Tokens Included**:
- WETH9 (Wrapped Ether)
- WETH10 (Wrapped Ether v10)
- ETH/USD Price Feed

---

**Last Updated**: $(date)

