proxmox/token-lists/REMAINING_NEXT_STEPS.md

Remaining Next Steps - Complete Checklist

Date: 2026-01-26
Status: All token lists created and validated
Remaining: Hosting, submission, and distribution

---

✅ Completed (Do Not Repeat)

• Created all 3 token list files
• Validated all token lists
• Discovered ALL Mainnet tokens (9 tokens including AUSDT)
• Updated ChainID 138 with cUSDT and cUSDC
• Created extraction and discovery scripts
• Created comprehensive documentation

---

📋 Remaining Next Steps

Phase 1: Hosting Token Lists (Required)

1.1 Host on GitHub (Recommended)

For Each Token List:

• Commit token lists to repository

  cd /home/intlc/projects/proxmox
  git add token-lists/lists/*.json
  git commit -m "Add token lists for Ethereum Mainnet, ChainID 138, and ALL Mainnet"
  git push
  

• Enable GitHub Pages (if using Pages)

  • Go to repository Settings → Pages
  • Select branch (main/master)
  • Select folder: /token-lists/lists/ or / (root)
  • Save

• Verify GitHub Raw URLs are accessible

  • Test: https://raw.githubusercontent.com/{user}/{repo}/main/token-lists/lists/dbis-138.tokenlist.json
  • Test: https://raw.githubusercontent.com/{user}/{repo}/main/token-lists/lists/ethereum-mainnet.tokenlist.json
  • Test: https://raw.githubusercontent.com/{user}/{repo}/main/token-lists/lists/all-mainnet.tokenlist.json

• Verify CORS headers (if using custom domain)

  • Ensure Access-Control-Allow-Origin: * header is set
  • Test with: curl -I <token-list-url>

1.2 Alternative Hosting Options

• IPFS Hosting (Optional - Decentralized)

  • Upload token lists to IPFS (Pinata, Infura, etc.)
  • Pin files to keep them available
  • Document IPFS hashes

• Custom Domain Hosting (Optional)

  • Configure tokens.d-bis.org or similar domain
  • Setup nginx/Apache with CORS headers
  • Mirror GitHub releases

---

Phase 2: Signing Token Lists (Recommended for Security)

2.1 Generate minisign Keypair (If Not Done)

• Generate keypair

  cd token-lists
  ./scripts/sign-list.sh --generate-key
  

• Store private key securely

  • Add to GitHub Secrets (for CI/CD)
  • Store securely for manual signing

• Commit public key

  git add minisign.pub
  git commit -m "Add minisign public key for token list verification"
  git push
  

2.2 Sign All Token Lists

• Sign ChainID 138 token list

  cd token-lists
  ./scripts/sign-list.sh sign lists/dbis-138.tokenlist.json
  

• Sign Ethereum Mainnet token list

  ./scripts/sign-list.sh sign lists/ethereum-mainnet.tokenlist.json
  

• Sign ALL Mainnet token list

  ./scripts/sign-list.sh sign lists/all-mainnet.tokenlist.json
  

• Commit signatures

  git add lists/*.sig
  git commit -m "Add minisign signatures for token lists"
  git push
  

---

Phase 3: Create GitHub Releases

3.1 Release ChainID 138 Token List

• Update version (if needed)

  cd token-lists
  ./scripts/release.sh patch  # or minor/major
  

• Create git tag

  git tag -a v1.2.0 -m "Release v1.2.0: Added cUSDT and cUSDC"
  git push --tags
  

• Verify GitHub Actions release workflow (if configured)

  • Check .github/workflows/release.yml exists
  • Verify workflow runs on tag push
  • Check release artifacts created

3.2 Release Ethereum Mainnet Token List

• Create initial release

  git tag -a ethereum-mainnet-v1.0.0 -m "Release Ethereum Mainnet token list v1.0.0"
  git push --tags
  

3.3 Release ALL Mainnet Token List

• Create initial release

  git tag -a all-mainnet-v1.0.0 -m "Release ALL Mainnet token list v1.0.0"
  git push --tags
  

---

Phase 4: Submit to Token List Registries

4.1 Uniswap Token Lists Registry

For Each Token List:

• Fork Uniswap token-lists repository

  • Repository: https://github.com/Uniswap/token-lists
  • Fork to your GitHub account

• Clone your fork

  git clone https://github.com/YOUR_USERNAME/token-lists.git
  cd token-lists
  

• Add token list to repository

  • Follow their directory structure
  • Copy token list file to appropriate location
  • Ensure file naming follows their conventions

• Create Pull Request

  git checkout -b add-{network}-token-list
  git add <token-list-file>
  git commit -m "Add {Network Name} token list"
  git push origin add-{network}-token-list
  

  • Then create PR on GitHub
  • Include description of tokens
  • Reference token list URL

Specific PRs Needed:

• PR for ChainID 138 token list
• PR for Ethereum Mainnet token list (if not already in registry)
• PR for ALL Mainnet token list

4.2 MetaMask Token Lists

• Add token list URLs to MetaMask (Manual)

  • MetaMask → Settings → Security & Privacy → Token Lists
  • Add each token list URL
  • Test token discovery

• Submit to MetaMask's default registry (If they have one)

  • Check MetaMask documentation for submission process
  • Follow their guidelines

4.3 Chainlist Integration

• Update ChainID 138 chain configuration

  • File: token-lists/chainlists/chain-138.json
  • Add tokenLists field with token list URL
  • Submit PR to Chainlist repository

• Create ALL Mainnet chain configuration (If not exists)

  • Create chainlists/chain-651940.json
  • Include token list URL reference
  • Submit to Chainlist

• Update Ethereum Mainnet chain config (If applicable)

  • Add token list reference if submitting custom list

---

Phase 5: Update Configuration Files

5.1 Update chains.ts (ALL Mainnet)

• Update USDC address in alltra-lifi-settlement/src/config/chains.ts

  • Current: usdcAddress: '' (empty)
  • Update to: usdcAddress: '0xa95EeD79f84E6A0151eaEb9d441F9Ffd50e8e881' (USDC on ALL Mainnet)

• Update AUSDT address (if needed)

  • Document AUSDT address: 0x015B1897Ed5279930bC2Be46F661894d219292A6

5.2 Update Documentation

• Update CHAIN138_TOKEN_ADDRESSES.md

  • Ensure all tokens are documented
  • Add explorer links

• Create ALL_MAINNET_TOKEN_ADDRESSES.md

  • Document all 9 tokens found
  • Include addresses, decimals, explorer links

---

Phase 6: Logo Management (Optional but Recommended)

6.1 Host Token Logos

• Create logos directory

  mkdir -p token-lists/logos
  

• Download/verify logo URLs

  • Check all logo URLs are accessible
  • Download logos for local hosting (optional)
  • Update logoURI fields if needed

• Add missing logos

  • HYDX, HYBX, CHT, AUDA may need logos
  • Create or source appropriate logos
  • Host logos publicly
  • Update token list with logo URLs

---

Phase 7: CI/CD Enhancements (Optional)

7.1 GitHub Actions Workflows

• Verify PR validation workflow

  • Check .github/workflows/validate-pr.yml exists
  • Test workflow on PR
  • Ensure it validates all token lists

• Verify release workflow

  • Check .github/workflows/release.yml exists
  • Test workflow on tag push
  • Verify artifacts created

• Add workflow for ALL Mainnet (if needed)

  • Create workflow to validate ALL Mainnet token list
  • Add chain ID 651940 validation

7.2 Automated Updates

• Setup automated token discovery (Optional)
  • Create scheduled job to scan for new tokens
  • Auto-update token lists (with manual review)
  • Notify on new token discoveries

---

Phase 8: Testing and Verification

8.1 Integration Testing

• Test MetaMask integration

  • Add token list URL to MetaMask
  • Verify tokens appear correctly
  • Test token metadata display

• Test Uniswap integration (If applicable)

  • Verify token list works in Uniswap interface
  • Test token selection and display

• Test dApp integration

  • Use token list in sample dApp
  • Verify token metadata loading
  • Test token selection

8.2 On-Chain Verification

• Verify ChainID 138 tokens on-chain

  node token-lists/scripts/verify-on-chain.js token-lists/lists/dbis-138.tokenlist.json --required
  

  (Requires RPC access)

• Verify ALL Mainnet tokens on-chain (If RPC accessible)

  • Create verification script for ALL Mainnet
  • Verify all 9 tokens exist and match metadata

---

Phase 9: Documentation Updates

9.1 Update Main README

• Update token-lists/README.md
  • Add ALL Mainnet token list to summary
  • Update token counts
  • Add ALL Mainnet discovery information

9.2 Create Submission Status Document

• Create submission tracking document
  • Track PR status for each registry
  • Document submission dates
  • Track approval status

---

Phase 10: Public Announcement (Optional)

10.1 Community Announcements

• Announce on social media (If applicable)
  • Twitter/X post about token lists
  • Discord announcement
  • Community forum post

10.2 Documentation Updates

• Update project documentation
  • Add token list URLs to main README
  • Update integration guides
  • Add to project website (if applicable)

---

📊 Priority Order

High Priority (Required for Submission)

1. Host token lists publicly (GitHub Raw or Pages)
2. Submit to Uniswap Token Lists registry
3. Update chains.ts with ALL Mainnet USDC address

Medium Priority (Recommended)

4. Sign token lists (minisign)
5. Create GitHub releases
6. Submit to MetaMask token lists
7. Update Chainlist with token list references

Low Priority (Optional Enhancements)

8. Logo management
9. CI/CD enhancements
10. Automated token discovery

---

🎯 Quick Start Commands

Host on GitHub

cd /home/intlc/projects/proxmox
git add token-lists/lists/*.json
git commit -m "Add complete token lists for all networks"
git push

Sign Token Lists

cd token-lists
./scripts/sign-list.sh sign lists/dbis-138.tokenlist.json
./scripts/sign-list.sh sign lists/ethereum-mainnet.tokenlist.json
./scripts/sign-list.sh sign lists/all-mainnet.tokenlist.json
git add lists/*.sig
git commit -m "Add signatures for token lists"
git push

Create Releases

cd token-lists
git tag -a v1.2.0 -m "Release ChainID 138 token list v1.2.0"
git tag -a ethereum-mainnet-v1.0.0 -m "Release Ethereum Mainnet token list"
git tag -a all-mainnet-v1.0.0 -m "Release ALL Mainnet token list"
git push --tags

---

📝 Notes

• GitHub Raw URLs work immediately after push (no Pages setup needed)
• Signing is optional but recommended for security
• Submissions can be done in parallel for all registries
• Testing should be done before public announcement

---

✅ Completion Checklist Summary

Token Lists: ✅ Complete (3 files, 16 tokens)
Validation: ✅ Complete (all validated)
Documentation: ✅ Complete (18 docs)
Scripts: ✅ Complete (4 scripts)

Remaining:

• Hosting (GitHub/IPFS/Custom domain)
• Signing (minisign)
• Releases (GitHub tags)
• Registry submissions (Uniswap, MetaMask, Chainlist)
• Configuration updates (chains.ts)
• Integration testing

---

Last Updated: 2026-01-26