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
This commit is contained in:
defiQUG
217
token-lists/ALL_MAINNET_TOKEN_EXTRACTION_GUIDE.md
Normal file
217
token-lists/ALL_MAINNET_TOKEN_EXTRACTION_GUIDE.md
Normal file
@@ -0,0 +1,217 @@
|
||||
# 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
|
||||
Reference in New Issue
Block a user