95 lines
2.7 KiB
Markdown
95 lines
2.7 KiB
Markdown
|
# 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
|