proxmox/token-lists/ALL_MAINNET_TOKEN_EXTRACTION_GUIDE.md

# ALL Mainnet Token Extraction Guide

**Date**: 2026-01-26  
**Network**: ALL Mainnet (ChainID 651940)  
**Explorer**: https://alltra.global/tokens  
**Status**: Ready for token data extraction

---

## Overview

This guide helps extract token information from the ALL Mainnet explorer (https://alltra.global/tokens) to create a complete token list for submission.

---

## 🔍 Token Information to Extract

For each token listed on https://alltra.global/tokens, collect:

### Required Information

1. **Token Name** (e.g., "Tether USD", "USD Coin")
2. **Token Symbol** (e.g., "USDT", "USDC", "AUSDT")
3. **Contract Address** (0x-prefixed, 40 hex characters)
4. **Decimals** (typically 6 for stablecoins, 18 for most tokens)
5. **Chain ID** (651940 for ALL Mainnet)

### Optional but Recommended

6. **Logo URL** (if available)
7. **Token Type** (ERC-20, stablecoin, wrapped, etc.)
8. **Explorer Link** (https://alltra.global/address/{address})
9. **Total Supply** (if visible)
10. **Contract Verification Status**

---

## 📋 Token List Template

### For AUSDT (if found on ALL Mainnet)

```json
{
  "chainId": 651940,
  "address": "0x...", // Replace with actual address from explorer
  "name": "Tether USD", // Or actual name from explorer
  "symbol": "AUSDT", // Or "USDT" if that's the symbol
  "decimals": 6, // Verify from explorer or contract
  "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xdAC17F958D2ee523a2206206994597C13D831ec7/logo.png",
  "tags": ["stablecoin", "defi"]
}
```

### For USDC (if found on ALL Mainnet)

```json
{
  "chainId": 651940,
  "address": "0x...", // Replace with actual address from explorer
  "name": "USD Coin",
  "symbol": "USDC",
  "decimals": 6,
  "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
  "tags": ["stablecoin", "defi"]
}
```

---

## 🔧 Verification Steps

### Step 1: Visit Explorer
1. Go to https://alltra.global/tokens
2. Browse or search for tokens
3. Look for:
   - USDT / AUSDT
   - USDC
   - Other ERC-20 tokens

### Step 2: Extract Token Data

For each token found:

1. **Click on token** to view details
2. **Copy contract address** (ensure it's checksummed)
3. **Note token name and symbol**
4. **Check decimals** (view contract or token details page)
5. **Verify contract** (check if verified on explorer)

### Step 3: Verify On-Chain (Optional)

If you have RPC access:

```bash
# Set RPC URL
RPC_URL="https://mainnet-rpc.alltra.global"

# Verify token details
cast call <TOKEN_ADDRESS> "symbol()(string)" --rpc-url $RPC_URL
cast call <TOKEN_ADDRESS> "name()(string)" --rpc-url $RPC_URL
cast call <TOKEN_ADDRESS> "decimals()(uint8)" --rpc-url $RPC_URL
```

### Step 4: Validate Address Checksum

```bash
# Use ethers.js or cast to checksum address
cast --to-checksum-address <TOKEN_ADDRESS>
```

---

## 📝 Creating Token List File

Once you have token data, create:

**File**: `token-lists/lists/all-mainnet.tokenlist.json`

**Structure**:
```json
{
  "name": "ALL Mainnet Token List",
  "version": {
    "major": 1,
    "minor": 0,
    "patch": 0
  },
  "timestamp": "2026-01-26T00:00:00.000Z",
  "logoURI": "https://raw.githubusercontent.com/ethereum/ethereum.org/main/static/images/eth-diamond-black.png",
  "keywords": [
    "all",
    "alltra",
    "mainnet",
    "stablecoin"
  ],
  "tokens": [
    // Add tokens here
  ],
  "tags": {
    "stablecoin": {
      "name": "Stablecoin",
      "description": "Stable value tokens pegged to fiat currencies"
    },
    "defi": {
      "name": "DeFi",
      "description": "Decentralized Finance tokens"
    }
  }
}
```

---

## 🎯 Expected Tokens on ALL Mainnet

Based on common patterns, look for:

1. **AUSDT** or **USDT** - Tether USD (if deployed)
2. **USDC** - USD Coin (if deployed)
3. **Wrapped ALL** - Wrapped native token (if exists)
4. **Other ERC-20 tokens** - Any other tokens listed

---

## ✅ Validation Checklist

After creating the token list:

- [ ] All addresses are EIP-55 checksummed
- [ ] All chain IDs are 651940
- [ ] All decimals are correct
- [ ] All symbols match on-chain values
- [ ] All names match on-chain values
- [ ] Logo URLs are accessible (if provided)
- [ ] Tags are appropriate
- [ ] JSON structure is valid

---

## 🧪 Validate Token List

```bash
# Validate the token list
cd /home/intlc/projects/proxmox
node token-lists/scripts/validate-token-list.js token-lists/lists/all-mainnet.tokenlist.json --chain-id=651940
```

---

## 📚 Next Steps

1. **Extract token data** from https://alltra.global/tokens
2. **Create token list file** using the template above
3. **Validate** using the validation script
4. **Verify on-chain** (if RPC access available)
5. **Submit** to token list registries

---

## 🔗 Resources

- **ALL Mainnet Explorer**: https://alltra.global
- **Token List Page**: https://alltra.global/tokens
- **RPC Endpoint**: https://mainnet-rpc.alltra.global
- **Chain ID**: 651940
- **ChainList**: https://chainlist.org/chain/651940

---

**Note**: This guide assumes tokens are listed on the explorer. If the explorer doesn't show tokens or requires authentication, you may need to:
- Query the RPC directly for token contracts
- Check contract deployment transactions
- Contact ALL Mainnet documentation/support

---

**Last Updated**: 2026-01-26