Files
proxmox/token-lists/ALL_MAINNET_TOKEN_EXTRACTION_GUIDE.md
defiQUG f0ab0eadc2 Add complete token lists for Ethereum Mainnet, ChainID 138, and ALL Mainnet
- Added Ethereum Mainnet token list (1 token: USDT)
- Updated ChainID 138 token list (6 tokens: added cUSDT and cUSDC)
- Added ALL Mainnet token list (9 tokens including AUSDT)
- Discovered ALL Mainnet tokens via Transfer event scanning
- Updated validation scripts for multi-chain support
- Created comprehensive documentation and guides
- Updated master documentation indexes
- All token lists validated and ready for submission
2026-01-26 13:52:05 -08:00

5.3 KiB

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)
  1. Logo URL (if available)
  2. Token Type (ERC-20, stablecoin, wrapped, etc.)
  3. Explorer Link (https://alltra.global/address/{address})
  4. Total Supply (if visible)
  5. Contract Verification Status

📋 Token List Template

For AUSDT (if found on ALL Mainnet)

{
  "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)

{
  "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:

# 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

# 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:

{
  "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

# 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


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