d-bis/proxmox
4
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
4eead3e53fecdb2b7e629bb9f56b22ff92c61d2e
proxmox/docs/04-configuration/metamask/METAMASK_COMPLETE_TASK_LIST.md
defiQUG bea1903ac9
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
Details
Sync all local changes: docs, config, scripts, submodule refs, verification evidence 
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-21 15:46:06 -08:00

14 KiB
Raw Blame History

MetaMask Integration - Complete Task List

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

Date: 2026-01-26
Status: Comprehensive task list based on MetaMask documentation review and gaps analysis
Network: ChainID 138 (SMOM-DBIS-138)

📊 Current Status Overview

  • Phase A (Foundations): ✅ 100% Complete (25/25 tasks)
  • Phase B (Deployment): ⚠️ ~30% Complete (3/10 tasks)
  • Phase C (Integration): ⚠️ ~10% Complete (1/10 tasks)
  • Overall: ⚠️ ~65% Complete

🔴 CRITICAL PRIORITY TASKS (Must Complete Immediately)

1. Fix cUSDT/cUSDC Decimals Display Issue ✅

Status: ✅ COMPLETED
Priority: 🔴 Critical
Impact: High - Users cannot see correct token balances

Completed Actions:

  • ✅ Updated all MetaMask token list files with cUSDT and cUSDC (6 decimals)
  • ✅ Created fix guide: docs/04-configuration/metamask/FIX_CUSDT_CUSDC_DECIMALS.md
  • ✅ Verified on-chain decimals are correct (both return 6)

User Action Required:

  • Remove and re-add tokens in MetaMask with decimals set to 6
  • Or import updated token list

2. Deploy Production RPC Endpoints

Status: ⚠️ NOT DEPLOYED
Priority: 🔴 Critical
Impact: High - MetaMask cannot connect to ChainID 138

Tasks:

  • Deploy primary RPC endpoint at https://rpc.d-bis.org
  • Deploy secondary RPC endpoint at https://rpc2.d-bis.org
  • Configure HTTPS with valid SSL certificates
  • Enable CORS headers for MetaMask
  • Configure rate limiting
  • Set up monitoring and alerts
  • Test RPC endpoints from MetaMask
  • Document RPC endpoint URLs

Current Status:

  • Internal RPC: http://192.168.11.211:8545 (working)
  • Public RPC: https://rpc-core.d-bis.org (needs verification)

3. Deploy Blockscout Explorer

Status: ⚠️ NOT DEPLOYED
Priority: 🔴 Critical
Impact: High - Users cannot verify transactions or view token metadata

Tasks:

  • Deploy Blockscout at https://explorer.d-bis.org
  • Configure CORS headers for MetaMask Portfolio
  • Enable token metadata API
  • Configure logo serving at /images/tokens/
  • Verify transaction history display
  • Verify contract verification
  • Verify token transfer display
  • Test Blockscout API endpoints
  • Document Blockscout URL

Files Needed:

  • Blockscout deployment configuration
  • CORS configuration for Portfolio compatibility

4. Submit Ethereum-Lists PR

Status: ⚠️ NOT SUBMITTED
Priority: 🔴 Critical
Impact: High - ChainID 138 not available on Chainlist

Tasks:

  • Review metamask/ethereum-lists-chain.json
  • Verify all network metadata is correct
  • Create PR to ethereum-lists/chains repository
  • Follow PR template and guidelines
  • Respond to review comments
  • Get PR merged
  • Verify Chainlist displays ChainID 138 correctly

Files:

  • smom-dbis-138/metamask/ethereum-lists-chain.json
  • PR template (if exists)

5. Submit Token List to Aggregators

Status: ⚠️ NOT SUBMITTED
Priority: 🔴 Critical
Impact: High - Tokens not auto-detected in MetaMask Portfolio

Tasks:

  • Submit token list to CoinGecko
  • Submit token list to Uniswap
  • Submit token list to 1inch
  • Submit token list to other aggregators
  • Verify tokens appear in MetaMask Portfolio
  • Verify token logos display correctly
  • Document submission process

Token List File:

  • token-lists/lists/dbis-138.tokenlist.json

🟡 HIGH PRIORITY TASKS (Should Complete Soon)

6. Configure Cloudflare DNS

Status: ⚠️ NOT COMPLETED
Priority: 🟡 High
Impact: Medium - Domain d-bis.org not fully configured

Tasks:

  • Configure DNS records for d-bis.org
  • Set up A/AAAA records for RPC endpoints
  • Set up CNAME for explorer
  • Configure DNS propagation
  • Verify DNS resolution
  • Document DNS configuration

7. Configure SSL Certificates

Status: ⚠️ NOT CONFIGURED
Priority: 🟡 High
Impact: Medium - HTTPS endpoints not accessible

Tasks:

  • Configure SSL certificates via Cloudflare
  • Enable HTTPS for RPC endpoints
  • Enable HTTPS for explorer
  • Verify SSL certificate validity
  • Set up certificate auto-renewal
  • Test HTTPS endpoints
  • Document SSL configuration

8. Deploy Azure Application Gateway

Status: ⚠️ NOT DEPLOYED
Priority: 🟡 High
Impact: Medium - RPC endpoints not accessible via Application Gateway

Tasks:

  • Deploy Azure Application Gateway
  • Configure CORS headers
  • Set up routing rules
  • Configure SSL termination
  • Set up health checks
  • Test Application Gateway
  • Document Application Gateway configuration

9. Apply Blockscout CORS Configuration

Status: ⚠️ NOT APPLIED
Priority: 🟡 High
Impact: Medium - MetaMask Portfolio cannot access Blockscout API

Tasks:

  • Apply CORS configuration to Blockscout
  • Configure allowed origins for MetaMask
  • Test CORS headers
  • Verify Portfolio API access
  • Document CORS configuration

Files:

  • Blockscout CORS configuration (if exists)

10. Host Token Logos

Status: ⚠️ NOT HOSTED
Priority: 🟡 High
Impact: Medium - Token logos not displayed in MetaMask

Tasks:

  • Create/obtain token logos for all tokens
  • Host logos at https://explorer.d-bis.org/images/tokens/
  • Provide multiple sizes (32x32, 128x128, 256x256)
  • Update token list with logo URLs
  • Verify logos display in MetaMask
  • Document logo hosting

Tokens Needing Logos:

  • cUSDT (can use USDT logo)
  • cUSDC (can use USDC logo)
  • WETH9 (can use WETH logo)
  • WETH10 (can use WETH logo)
  • LINK (already has logo)
  • ETH/USD Oracle (needs custom logo)

11. Public Token List Hosting

Status: ⚠️ NOT DEPLOYED
Priority: 🟡 High
Impact: Medium - Token list not accessible for automatic discovery

Tasks:

  • Host token list on public URL (GitHub Pages, IPFS, or CDN)
  • Use HTTPS
  • Set proper CORS headers
  • Set up version control
  • Test token list URL
  • Submit URL to MetaMask token list registry
  • Document hosting setup

Options:

  1. GitHub Pages (free, easy)
  2. IPFS (decentralized, permanent)
  3. Custom domain (professional)
  4. CDN (fast, scalable)

🟢 MEDIUM PRIORITY TASKS (Nice to Have)

12. Test MetaMask Portfolio Integration

Status: ⚠️ NOT TESTED
Priority: 🟢 Medium
Impact: Low - Portfolio compatibility not verified

Tasks:

  • Test Portfolio read-only features
  • Verify token balances display correctly
  • Verify transaction history
  • Verify token logos
  • Test Portfolio API endpoints
  • Document Portfolio compatibility
  • Create Portfolio integration guide

13. Create Advanced dApp Examples

Status: ⚠️ BASIC ONLY
Priority: 🟢 Medium
Impact: Low - Developers need more examples

Tasks:

  • Create React/Next.js example
  • Create Vue.js example
  • Create complete dApp template
  • Add TypeScript examples
  • Add error handling examples
  • Add transaction examples
  • Document examples

Current Examples:

  • ✅ wallet-connect.html - Basic wallet connection
  • ✅ metamask-price-feed.html - Price feed example

14. Bridge Integration

Status: ⚠️ NOT IMPLEMENTED
Priority: 🟢 Medium
Impact: Low - Users cannot bridge to ChainID 138

Tasks:

  • Research bridge providers
  • Partner with bridge provider (or implement)
  • Integrate bridge API
  • Test bridge functionality
  • Document bridge integration
  • Create bridge user guide

Options:

  • Partner with existing bridge (LayerZero, Wormhole, etc.)
  • Implement custom bridge
  • Use third-party bridge aggregator

15. DEX Integration

Status: ⚠️ NOT IMPLEMENTED
Priority: 🟢 Medium
Impact: Low - Users cannot swap tokens on ChainID 138

Tasks:

  • Research DEX providers
  • Partner with DEX provider (or implement)
  • Integrate DEX API
  • Test swap functionality
  • Document DEX integration
  • Create swap user guide

Options:

  • Partner with existing DEX (Uniswap, 1inch, etc.)
  • Implement custom DEX
  • Use DEX aggregator

16. On-Ramp Integration

Status: ⚠️ NOT IMPLEMENTED
Priority: 🟢 Medium
Impact: Low - Users cannot buy tokens with fiat

Tasks:

  • Research on-ramp providers
  • Partner with on-ramp provider (MoonPay, Ramp, etc.)
  • Integrate on-ramp API
  • Test buy/sell functionality
  • Document on-ramp integration
  • Create on-ramp user guide

Providers:

  • MoonPay
  • Ramp
  • Transak
  • Wyre

17. Consensys Outreach

Status: ⚠️ NOT INITIATED
Priority: 🟢 Medium
Impact: Low - Native MetaMask features not available

Tasks:

  • Prepare outreach materials
  • Contact Consensys Business Development
  • Request Swaps integration
  • Request Bridge integration
  • Request on-ramp integration
  • Follow up on requests
  • Document outreach process

Files:

  • smom-dbis-138/docs/operations/integrations/METAMASK_BD.md - Business development guide

18. SDK Documentation

Status: ⚠️ PARTIAL
Priority: 🟢 Medium
Impact: Low - Developers need better SDK docs

Tasks:

  • Create comprehensive SDK API reference
  • Add code examples for all functions
  • Create migration guide
  • Add troubleshooting section
  • Create video tutorials
  • Publish SDK to npm (if applicable)

Current SDK:

  • ✅ smom-dbis-138/metamask-sdk/ - TypeScript SDK package
  • ✅ Basic README exists

19. User Testing

Status: ⚠️ NOT CONDUCTED
Priority: 🟢 Medium
Impact: Low - User experience not validated

Tasks:

  • Create user testing plan
  • Recruit test users
  • Conduct user testing sessions
  • Collect feedback
  • Analyze results
  • Implement improvements
  • Document findings

20. Community Support

Status: ⚠️ NOT ESTABLISHED
Priority: 🟢 Medium
Impact: Low - Users need support channels

Tasks:

  • Create Discord/Telegram support channel
  • Create GitHub Discussions
  • Create FAQ document
  • Create troubleshooting guide
  • Train support team
  • Document support process

✅ COMPLETED TASKS (Reference)

Phase A - Foundations (All Complete)

  1. ✅ Network Metadata - Created network-metadata.json and ethereum-lists-chain.json
  2. ✅ Token List - Created official token list with schema validation
  3. ✅ MetaMask SDK - Created complete SDK package
  4. ✅ Documentation - Created comprehensive guides
  5. ✅ Examples - Created React and Vanilla JS examples
  6. ✅ Tests - Created unit tests and E2E tests
  7. ✅ CORS Configuration - Updated Blockscout and Application Gateway
  8. ✅ Domain Migration - Updated all files to use d-bis.org domain
  9. ✅ Ethereum-Lists PR - Created PR template and submission guide
  10. ✅ Token List Submissions - Created tracking document
  11. ✅ Phishing Detection - Created check guide
  12. ✅ RPC SLO - Created service level objectives documentation
  13. ✅ Blockscout API - Created API documentation
  14. ✅ Portfolio Compatibility - Created compatibility documentation
  15. ✅ Bridge/Swap Docs - Created documentation with workarounds
  16. ✅ Business Development - Created Consensys outreach guide
  17. ✅ SDK Integration - Integrated MetaMask SDK into main SDK
  18. ✅ Environment Configuration - Created .env.example
  19. ✅ Circular Dependencies - Fixed import circular dependencies
  20. ✅ README Updates - Updated README with MetaMask integration section
  21. ✅ GitHub Actions - Created workflow for token list validation
  22. ✅ E2E Testing - Tested all MetaMask integration functions
  23. ✅ Production Config - Updated production-config.yaml
  24. ✅ Blockscout CORS - Updated Blockscout deployment
  25. ✅ Application Gateway CORS - Updated Application Gateway
  26. ✅ cUSDT/cUSDC Decimals Fix - Updated token lists with correct decimals

📋 Task Summary by Priority

🔴 Critical (5 tasks)

  1. ✅ Fix cUSDT/cUSDC Decimals Display Issue
  2. ⏳ Deploy Production RPC Endpoints
  3. ⏳ Deploy Blockscout Explorer
  4. ⏳ Submit Ethereum-Lists PR
  5. ⏳ Submit Token List to Aggregators

🟡 High Priority (6 tasks)

  1. ⏳ Configure Cloudflare DNS
  2. ⏳ Configure SSL Certificates
  3. ⏳ Deploy Azure Application Gateway
  4. ⏳ Apply Blockscout CORS Configuration
  5. ⏳ Host Token Logos
  6. ⏳ Public Token List Hosting

🟢 Medium Priority (9 tasks)

  1. ⏳ Test MetaMask Portfolio Integration
  2. ⏳ Create Advanced dApp Examples
  3. ⏳ Bridge Integration
  4. ⏳ DEX Integration
  5. ⏳ On-Ramp Integration
  6. ⏳ Consensys Outreach
  7. ⏳ SDK Documentation
  8. ⏳ User Testing
  9. ⏳ Community Support

🎯 Recommended Execution Order

Week 1 (Critical)

  1. ✅ Fix cUSDT/cUSDC decimals (DONE)
  2. Deploy Production RPC Endpoints
  3. Deploy Blockscout Explorer
  4. Configure Cloudflare DNS
  5. Configure SSL Certificates

Week 2-4 (High Priority)

  1. Submit Ethereum-Lists PR
  2. Submit Token List to Aggregators
  3. Deploy Azure Application Gateway
  4. Apply Blockscout CORS Configuration
  5. Host Token Logos
  6. Public Token List Hosting

Month 2-3 (Medium Priority)

  1. Test MetaMask Portfolio Integration
  2. Create Advanced dApp Examples
  3. Bridge Integration (research/partner)
  4. DEX Integration (research/partner)
  5. Consensys Outreach
  6. SDK Documentation
  7. User Testing
  8. Community Support

📊 Progress Tracking

Category Total Completed In Progress Not Started
Critical 5 1 0 4
High Priority 6 0 0 6
Medium Priority 9 0 0 9
Total 20 1 0 19

Completion: 5% (1/20 tasks)

🔗 Related Documentation

Last Updated: 2026-01-26

Reference in New Issue View Git Blame Copy Permalink