Files
proxmox/docs/04-configuration/metamask/PHASES_1-4_COMPLETE.md
defiQUG fbda1b4beb
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
docs: Ledger Live integration, contract deploy learnings, NEXT_STEPS updates
- ADD_CHAIN138_TO_LEDGER_LIVE: Ledger form done; public code review repo bis-innovations/LedgerLive; init/push commands
- CONTRACT_DEPLOYMENT_RUNBOOK: Chain 138 gas price 1 gwei, 36-addr check, TransactionMirror workaround
- CONTRACT_*: AddressMapper, MirrorManager deployed 2026-02-12; 36-address on-chain check
- NEXT_STEPS_FOR_YOU: Ledger done; steps completable now (no LAN); run-completable-tasks-from-anywhere
- MASTER_INDEX, OPERATOR_OPTIONAL, SMART_CONTRACTS_INVENTORY_SIMPLE: updates
- LEDGER_BLOCKCHAIN_INTEGRATION_COMPLETE: bis-innovations/LedgerLive reference

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-12 15:46:57 -08:00

3.1 KiB

All Four Phases Complete — explorer.d-bis.org Integration

Last Updated: 2026-01-31
Document Version: 1.0
Status: Active Documentation


Date: 2026-01-30
Target: VMID 5000 (192.168.11.140) — https://explorer.d-bis.org
Status: All phases complete


Summary

Phase Status Result
1. Backend API Complete Config API deployed (port 8081); /api/config/networks and /api/config/token-list working
2. Frontend Complete Wallet page deployed at /wallet; Add to MetaMask functional
3. Verification Complete Integration test: Passed: 5, Failed: 0
4. Optional Documented Token-aggregation, Snap, CoinGecko, Consensys documented for future deployment

What was deployed

Backend (VMID 5000)

  1. Config API service (explorer-config-api.service)

    • Binary: /usr/local/bin/explorer-config-api
    • Port: 8081
    • Routes: /api/config/networks, /api/config/token-list
    • Embedded JSON: DUAL_CHAIN_NETWORKS.json, DUAL_CHAIN_TOKEN_LIST.tokenlist.json
  2. Nginx configuration (/etc/nginx/sites-enabled/blockscout)

    • /api/config/ → proxy to localhost:8081
    • /wallet → serve static /var/www/html/wallet.html
    • /api/ → proxy to Blockscout (port 4000)

Frontend (VMID 5000)

  1. Wallet page (/var/www/html/wallet.html)
    • Standalone HTML with inline JS/CSS
    • Add Chain 138, Ethereum Mainnet, ALL Mainnet to MetaMask
    • Token list URL display and copy

Live endpoints

Endpoint URL Status
Wallet page https://explorer.d-bis.org/wallet Working
Networks config https://explorer.d-bis.org/api/config/networks Working (3 chains)
Token list https://explorer.d-bis.org/api/config/token-list Working (11 tokens)
Explorer root https://explorer.d-bis.org/ Working (Blockscout)

Verification results

cd metamask-integration
EXPLORER_API_URL=https://explorer.d-bis.org ./scripts/integration-test-all.sh

Output:

  • Provider integration test: 4 passed, 0 failed
  • Config JSONs validation: 2 passed
  • Explorer API checks: 2 passed (networks + token-list)
  • Total: Passed: 5, Failed: 0

How to use (end users)

  1. Visit https://explorer.d-bis.org/wallet
  2. Click "Add Chain 138" (or Ethereum Mainnet / ALL Mainnet)
  3. Approve in MetaMask
  4. Copy token list URL: https://explorer.d-bis.org/api/config/token-list
  5. In MetaMask: Settings → Token lists → Add custom token list → paste URL
  6. Tokens (WETH, cUSDT, cUSDC, etc.) appear automatically

Optional next steps

  • Token-aggregation service: Deploy for market data API (prices, volume, OHLCV)
  • Chain 138 Snap: Publish for in-wallet swap quotes and bridge routes
  • CoinGecko: Submit Chain 138 for native USD prices in MetaMask
  • Consensys: Request native Swaps/Bridge support

See: ALL_NEXT_STEPS.md items 12-19.


Last updated: 2026-01-30
Deployed by: Automated deployment script (metamask-integration/scripts/deploy-to-explorer.sh)