d-bis/proxmox
4
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
master
proxmox/docs/04-configuration/ORACLE_AND_COINGECKO_COMPLETE.md
defiQUG fbda1b4beb
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
Details
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

8.2 KiB
Raw Permalink Blame History

Oracle and CoinGecko Setup - Complete Implementation

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

Date: 2026-01-27
Status: ✅ All Recommendations Completed

📋 Summary

This document summarizes the completion of all three recommendations for improving USD peg display and oracle functionality for cUSDT and cUSDC in MetaMask.

✅ Recommendation 1: Check Oracle Publisher Service Status

Completed Tasks

  1. Created Status Check Script
    • Location: smom-dbis-138/scripts/check-oracle-publisher-status.sh
    • Purpose: Comprehensive status check for Oracle Publisher service (VMID 3500)
    • Features:
      • Checks if container exists
      • Verifies service status
      • Validates configuration
      • Reviews recent logs
      • Checks oracle contract price data

Usage

cd /home/intlc/projects/proxmox/smom-dbis-138
./scripts/check-oracle-publisher-status.sh

Current Status

  • Container: VMID 3500 needs to be created/configured
  • Service: Status can be checked with the script
  • Oracle Contract: Returns zero (needs price update)

Next Steps

  1. Create/configure Oracle Publisher container (VMID 3500)
  2. Configure environment variables
  3. Start the service
  4. Monitor with status check script

✅ Recommendation 2: Create Script to Update Oracle with Current Prices

Completed Tasks

  1. Oracle Update Script
    • Location: smom-dbis-138/scripts/update-oracle-price.sh
    • Purpose: Manually update ETH/USD oracle with current prices
    • Features:
      • Fetches ETH price from CoinGecko (with Binance fallback)
      • Converts to 8 decimals format
      • Checks current oracle price
      • Only updates if price difference > 1% (saves gas)
      • Verifies update after transaction

Usage

cd /home/intlc/projects/proxmox/smom-dbis-138

# Using .env file (recommended)
./scripts/update-oracle-price.sh

# Or with explicit parameters
./scripts/update-oracle-price.sh [rpc-url] [oracle-address] [private-key]

Script Features

  • ✅ Auto-loads .env file
  • ✅ Falls back to RPC_URL_138 if RPC_URL not set
  • ✅ Fetches from CoinGecko API
  • ✅ Falls back to Binance if CoinGecko fails
  • ✅ Smart update logic (only updates if >1% change)
  • ✅ Transaction verification
  • ✅ Error handling

Oracle Contract

  • Address: 0x3304b747e565a97ec8ac220b0b6a1f6ffdb837e6
  • Type: ETH/USD Price Feed
  • Decimals: 8
  • Update Method: updateAnswer(int256) or transmit(int256)

✅ Recommendation 3: Prepare CoinGecko Listing Submissions

Completed Tasks

  1. cUSDT Submission Document

    • Location: docs/04-configuration/coingecko/COINGECKO_SUBMISSION_CUSDT.md
    • Contents:
      • Complete token information
      • Contract details
      • Network information
      • Submission checklist
      • Logo requirements
      • Submission process

  2. cUSDC Submission Document

    • Location: docs/04-configuration/coingecko/COINGECKO_SUBMISSION_CUSDC.md
    • Contents:
      • Complete token information
      • Contract details
      • Network information
      • Submission checklist
      • Logo requirements
      • Submission process

  3. Submission Guide

    • Location: docs/04-configuration/coingecko/COINGECKO_SUBMISSION_GUIDE.md
    • Contents:
      • Step-by-step submission instructions
      • Prerequisites checklist
      • Timeline expectations
      • Common questions and answers
      • Post-listing verification steps

Token Information Summary

cUSDT (Compliant Tether USD)

cUSDC (Compliant USD Coin)

Submission Status

  • ✅ Token information prepared
  • ✅ Submission documents created
  • ✅ Submission guide created
  • ⏳ Logo preparation (pending)
  • ⏳ Actual submission to CoinGecko (pending)

📁 File Structure

proxmox/
├── smom-dbis-138/
│   └── scripts/
│       ├── check-oracle-publisher-status.sh  ✅ NEW
│       └── update-oracle-price.sh            ✅ IMPROVED
│
└── docs/
    └── 04-configuration/
        ├── coingecko/
        │   ├── COINGECKO_SUBMISSION_CUSDT.md     ✅ NEW
        │   ├── COINGECKO_SUBMISSION_CUSDC.md    ✅ NEW
        │   └── COINGECKO_SUBMISSION_GUIDE.md     ✅ NEW
        │
        └── ORACLE_AND_COINGECKO_COMPLETE.md     ✅ NEW (this file)

🚀 Quick Start Guide

1. Check Oracle Publisher Status

cd /home/intlc/projects/proxmox/smom-dbis-138
./scripts/check-oracle-publisher-status.sh

2. Update Oracle Price (Manual)

cd /home/intlc/projects/proxmox/smom-dbis-138
./scripts/update-oracle-price.sh

3. Submit to CoinGecko

  1. Review submission documents:

    • docs/04-configuration/coingecko/COINGECKO_SUBMISSION_CUSDT.md
    • docs/04-configuration/coingecko/COINGECKO_SUBMISSION_CUSDC.md

  2. Follow submission guide:

    • docs/04-configuration/coingecko/COINGECKO_SUBMISSION_GUIDE.md

  3. Submit at: https://www.coingecko.com/en/coins/new

📊 Current Status Summary

Oracle Publisher Service

  • ✅ Status check script created
  • ⏳ Service needs to be configured/started (VMID 3500)
  • ⏳ Oracle contract needs price update

Oracle Update Script

  • ✅ Script created and improved
  • ✅ Auto-loads .env configuration
  • ✅ Smart update logic (saves gas)
  • ✅ Ready to use

CoinGecko Submissions

  • ✅ Complete submission documents prepared
  • ✅ Submission guide created
  • ⏳ Logos need to be prepared
  • ⏳ Actual submission pending

🎯 Next Actions

Immediate (Can Do Now)

  1. Update Oracle Price:

    cd /home/intlc/projects/proxmox/smom-dbis-138
./scripts/update-oracle-price.sh

  2. Check Service Status:

    ./scripts/check-oracle-publisher-status.sh

Short-term (1-2 weeks)

  1. Prepare Logos:

    • Create 512x512 PNG logos for cUSDT and cUSDC
    • Use USDT/USDC logos as reference
    • Ensure distinct branding

  2. Submit to CoinGecko:

    • Follow submission guide
    • Submit both tokens
    • Monitor for approval

  3. Configure Oracle Publisher:

    • Set up VMID 3500 container
    • Configure environment variables
    • Start service for automatic updates

Long-term (After CoinGecko Listing)

  1. Verify MetaMask Integration:

    • Add tokens to MetaMask
    • Verify USD values display automatically
    • Test price updates

  2. Monitor and Maintain:

    • Monitor oracle price updates
    • Ensure service stays running
    • Update documentation as needed

📚 Related Documentation

Oracle Setup

  • Oracle Price Feed Setup: docs/04-configuration/metamask/ORACLE_PRICE_FEED_SETUP.md
  • WETH Oracle Quick Reference: docs/04-configuration/metamask/WETH_ORACLE_QUICK_REFERENCE.md

Token Information

  • Token Addresses: docs/11-references/CHAIN138_TOKEN_ADDRESSES.md
  • Token Lists: docs/04-configuration/metamask/METAMASK_TOKEN_LIST.json

CoinGecko

  • cUSDT Submission: docs/04-configuration/coingecko/COINGECKO_SUBMISSION_CUSDT.md
  • cUSDC Submission: docs/04-configuration/coingecko/COINGECKO_SUBMISSION_CUSDC.md
  • Submission Guide: docs/04-configuration/coingecko/COINGECKO_SUBMISSION_GUIDE.md

✅ Completion Checklist

  • Recommendation 1: Check Oracle Publisher service status

    • Created status check script
    • Script tests all components
    • Provides actionable feedback

  • Recommendation 2: Create script to update oracle

    • Created/improved update script
    • Auto-loads .env configuration
    • Smart update logic
    • Error handling and verification

  • Recommendation 3: Prepare CoinGecko submissions

    • Created cUSDT submission document
    • Created cUSDC submission document
    • Created submission guide
    • All required information included

Last Updated: 2026-01-27
Status: ✅ All Recommendations Completed

Reference in New Issue View Git Blame Copy Permalink