Files
proxmox/docs/04-configuration/TOKEN_LISTS_E2E_VERIFICATION.md
defiQUG b3a8fe4496
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
chore: sync all changes to Gitea
- Config, docs, scripts, and backup manifests
- Submodule refs unchanged (m = modified content in submodules)

Made-with: Cursor
2026-03-02 11:37:34 -08:00

2.7 KiB

Token Lists E2E Verification Report

Date: 2026-02-28
Status: Verification complete


1. Token List Validation

List Status Tokens Notes
dbis-138.tokenlist.json Valid 6 All IPFS logos, EIP-55 checksummed
cronos.tokenlist.json Valid 10 All IPFS logos, ISO-4217 W tokens
all-mainnet.tokenlist.json Valid 9 All 9 tokens have logoURI (IPFS)
DUAL_CHAIN_TOKEN_LIST Valid 22 Chains 138, 1, 25, 651940

2. Cross-File Consistency

Check Result
Chain 138 addresses (dbis-138 vs DUAL_CHAIN) Consistent
Cronos addresses (cronos vs DUAL_CHAIN) Consistent
DUAL_CHAIN synced to backend/config, docs, metamask Done

3. IPFS Manifest

  • addressToUrl: 14 of 22 DUAL_CHAIN addresses covered
  • Missing: Chain 1 (USDT, USDC, DAI, ETH-USD, WETH) and Chain 651940 USDC, Cronos WETH9/LINK — these use external logo URLs in token lists (TrustWallet, ethereum.org)
  • Our tokens (138, 25): All covered

4. Explorer API (/api/config/token-list)

Check Result
Public URL Returns 400 (Blockscout error)
Cause Nginx config not yet applied on VMID 5000
Fix Run on Proxmox host:
1. fix-nginx-conflicts-vmid5000.sh (inside VMID 5000)
2. deploy-explorer-config-to-vmid5000.sh (from repo root, with pct or EXEC_MODE=ssh)

5. Deploy Script

Check Result
Config source path Correct
pct mode Requires Proxmox host
ssh mode EXEC_MODE=ssh EXPLORER_IP=192.168.11.140 ./explorer-monorepo/scripts/deploy-explorer-config-to-vmid5000.sh

6. Nginx Location Order

location = /api/config/token-list   # Exact match (highest priority)
location = /api/config/networks
location /api/v1/                   # Token-aggregation
location /api/                      # Blockscout (fallback)

Correct — /api/config/* takes precedence over /api/


7. Frontend tokenIcons.ts

  • Chain 138: 6 addresses
  • Cronos WETH9, LINK, ISO-4217 W tokens: 9 addresses

8. E2E Checklist (Operator)

To achieve full E2E:

  1. SSH to Proxmox host (or VMID 5000)
  2. Run fix-nginx-conflicts-vmid5000.sh inside VMID 5000
  3. Run deploy-explorer-config-to-vmid5000.sh from repo root (pct or ssh)
  4. Verify: curl -s https://explorer.d-bis.org/api/config/token-list | jq '.tokens | length' → 22
  5. Verify: curl -s https://explorer.d-bis.org/api/config/networks | jq '.chains | length' → 4

9. Completed Improvements

  • all-mainnet: logoURI added for HYDX, HYBX, CHT, AUDA
  • tokenIcons.ts: Cronos WETH9, LINK added to TOKEN_ICON_BY_ADDRESS