docs(coingecko): normalize 5 submission docs to canonical attachment + verified API endpoints

- COINGECKO_API_NO_PUSH_LIQUIDITY.md, COINGECKO_SUBMISSION_{CUSDT,CUSDC,GUIDE,PACKAGE}.md: normalize to 'DeFi Oracle Meta Mainnet' canonical naming, point to COINGECKO_CHAIN138_SUBMISSION_ATTACHMENT.md as the authoritative package, and list the 7 verified public /api/ endpoints (live-verified 2026-04-19). - reports/status/cw-public-prices-latest.json: machine-readable cW* price snapshot (DODO PMM midPrice per chain). - docs/04-configuration/verification-evidence/e2e-verification-20260419_162326/all_e2e_results.json: E2E evidence backing the canonical attachment (44 domains, 44 DNS pass, 28 HTTPS pass, all RPC/WS/Blockscout checks pass on 2026-04-19). Companion to: COINGECKO_CHAIN138_SUBMISSION_ATTACHMENT.md (pending) and CMC_COINGECKO_SUBMISSION_RUNBOOK.md refresh (pending). Co-Authored-By: Nakamoto, S <defi@defi-oracle.io>
2026-04-19 23:51:35 +00:00
parent 4fab998e51
commit c111a69873
7 changed files with 3299 additions and 733 deletions
--- a/docs/04-configuration/coingecko/COINGECKO_API_NO_PUSH_LIQUIDITY.md
+++ b/docs/04-configuration/coingecko/COINGECKO_API_NO_PUSH_LIQUIDITY.md
@@ -7,7 +7,7 @@

 ## Summary

-**CoinGecko does not provide an API to push or submit liquidity pool data.** Their API is **read-only**: you query price and pool data that they have already indexed. You cannot “push” cUSDT/cUSDC pool information to CoinGecko via API.
+**CoinGecko does not provide an API to push or submit liquidity pool data.** Their API is **read-only**: you query price and pool data that they have already indexed. You cannot "push" cUSDT/cUSDC pool information to CoinGecko via API.

 ---

@@ -15,15 +15,15 @@

 | Source | How it works |
 |--------|-------------------------------|
-| **Supported chains (Ethereum, BSC, Polygon, etc.)** | **GeckoTerminal** (CoinGecko’s indexer) automatically indexes DEX pools **on-chain**. Pools that exist on supported networks and DEXes (Uniswap, etc.) are discovered and updated from the blockchain — no API push. |
-| **Custom / unsupported chains (e.g. Chain 138)** | Not indexed automatically. You must **submit the chain/token** via CoinGecko’s listing form and, when they support it, **provide an API URL** (e.g. `GET /api/v1/report/coingecko?chainId=138`) so they can **pull** data from your Token Aggregation Service. |
+| **Supported chains (Ethereum, BSC, Polygon, etc.)** | **GeckoTerminal** (CoinGecko's indexer) automatically indexes DEX pools **on-chain**. Pools that exist on supported networks and DEXes (Uniswap, etc.) are discovered and updated from the blockchain — no API push. |
+| **Custom / unsupported chains (e.g. Chain 138)** | Not indexed automatically. You must **submit the chain/token** via CoinGecko's listing form and, when they support it, **provide an API URL** (e.g. `GET /api/v1/report/coingecko?chainId=138`) so they can **pull** data from your Token Aggregation Service. |

 So:

- **Chains CoinGecko “typically reviews” (Ethereum, BSC, Polygon, Base, etc.):**  
+- **Chains CoinGecko "typically reviews" (Ethereum, BSC, Polygon, Base, etc.):**  
  Pool data is **pulled from chain** by GeckoTerminal. You do not push it via API. You only need tokens listed (if not already) and liquidity on DEXes they already index.
 - **Chain 138 (and other unsupported chains):**  
-  You **submit** the chain/tokens and give CoinGecko your **report API URL**; they then **pull** from your API. Still no “push” — they fetch from the URL you provide.
+  You **submit** the chain/tokens and give CoinGecko your **report API URL**; they then **pull** from your API. Still no "push" — they fetch from the URL you provide.

 ---

@@ -35,9 +35,9 @@ So:
 2. **Create liquidity pools** on DEXes that GeckoTerminal indexes (e.g. Uniswap, SushiSwap, etc.) on that chain.
 3. CoinGecko/GeckoTerminal will **automatically** pick up those pools from on-chain data. No API push.

-### For Chain 138 (Defi Oracle Meta Mainnet)
+### For Chain 138 (DeFi Oracle Meta Mainnet)

-1. **Submit** the chain and tokens via CoinGecko’s listing process.
+1. **Submit** the chain and tokens via CoinGecko's listing process.
 2. **Provide your report API URL** (e.g. `https://<your-api>/api/v1/report/coingecko?chainId=138`) so CoinGecko can **pull** token and liquidity data from your Token Aggregation Service.
 3. Ensure `GET /api/v1/report/coingecko?chainId=138` is public and returns the format described in [CMC_COINGECKO_REPORTING.md](../../../smom-dbis-138/services/token-aggregation/docs/CMC_COINGECKO_REPORTING.md).

--- a/docs/04-configuration/coingecko/COINGECKO_SUBMISSION_CUSDC.md
+++ b/docs/04-configuration/coingecko/COINGECKO_SUBMISSION_CUSDC.md
@@ -1,200 +1,35 @@
-# CoinGecko Listing Submission - cUSDC (Compliant USD Coin)
+# CoinGecko Listing Submission - cUSDC

-**Last Updated:** 2026-01-31  
-**Document Version:** 1.0  
-**Status:** Active Documentation
+**Last Updated:** 2026-04-19  
+**Status:** Canonical token-specific reference

---
-
-**Date:** 2026-01-27  
-**Token:** cUSDC (Compliant USD Coin)  
-**ChainID:** 138 (DBIS Chain / Defi Oracle Meta Mainnet)
-
---
-
-## 📋 Token Information
-
-### Basic Details
+## Token Information

 | Field | Value |
 |-------|-------|
 | **Token Name** | Compliant USD Coin |
-| **Token Symbol** | cUSDC |
+| **Token Symbol** | `cUSDC` |
 | **Contract Address** | `0xf22258f57794CC8E06237084b353Ab30fFfa640b` |
-| **Chain ID** | 138 |
-| **Chain Name** | DBIS Chain (Defi Oracle Meta Mainnet) |
-| **Decimals** | 6 |
-| **Token Type** | ERC-20 Stablecoin |
-| **Peg** | USD (1:1) |
+| **Chain ID** | `138` |
+| **Chain Name** | `DeFi Oracle Meta Mainnet` |
+| **Decimals** | `6` |
+| **Explorer Link** | `https://explorer.d-bis.org/address/0xf22258f57794CC8E06237084b353Ab30fFfa640b` |

-### Token Description
+## Public References

-**cUSDC** (Compliant USD Coin) is a regulatory-compliant ERC-20 stablecoin pegged to the US Dollar (USD) at a 1:1 ratio. It is designed to provide the stability of traditional fiat currency while maintaining full compliance with legal and regulatory requirements.
+- **Website:** `https://d-bis.org/`
+- **Documentation:** `https://info.defi-oracle.io/`
+- **Explorer:** `https://explorer.d-bis.org/`
+- **Chainlist:** `https://chainlist.org/chain/138`
+- **Canonical attachment:** [COINGECKO_CHAIN138_SUBMISSION_ATTACHMENT.md](/home/intlc/projects/proxmox/docs/04-configuration/coingecko/COINGECKO_CHAIN138_SUBMISSION_ATTACHMENT.md)

-**Key Features:**
- ✅ Regulatory compliant (includes Travel Rules exemption and regulatory compliance features)
- ✅ 1:1 USD peg
- ✅ ERC-20 standard
- ✅ 6 decimals (matching USDC standard)
- ✅ Pausable and Ownable for security
+## Verified JSON References

---
+- **CoinGecko-style chain report:** `https://explorer.d-bis.org/api/v1/report/coingecko?chainId=138`
+- **Explorer wallet token list:** `https://explorer.d-bis.org/api/config/token-list`
+- **Canonical token list:** `https://explorer.d-bis.org/api/v1/report/token-list?chainId=138`

-## 🔗 Blockchain Information
+## Notes

-### Network Details
-
-| Property | Value |
-|----------|-------|
-| **Network Name** | DBIS Chain |
-| **Chain ID** | 138 |
-| **RPC Endpoint** | `https://rpc-http-pub.d-bis.org` |
-| **Block Explorer** | `https://explorer.d-bis.org` |
-| **Native Currency** | ETH |
-| **Block Time** | ~2 seconds |
-
-### Contract Verification
-
- **Explorer Link:** https://explorer.d-bis.org/address/0xf22258f57794CC8E06237084b353Ab30fFfa640b
- **Contract Verified:** ✅ Yes
- **Source Code:** Available on explorer
-
---
-
-## 📊 Market Data
-
-### Current Supply
-
- **Total Supply:** Check on-chain via explorer
- **Circulating Supply:** Check on-chain via explorer
- **Max Supply:** No maximum (mintable by owner)
-
-### Trading Information
-
-**Note:** As a new token on a custom chain, trading volume and liquidity data may be limited initially.
-
- **DEX Listings:** TBD (can be added to DEXs)
- **Liquidity Pools:** TBD
- **Trading Pairs:** TBD
-
---
-
-## 🏗️ Technical Details
-
-### Contract Architecture
-
- **Base Contract:** OpenZeppelin ERC20
- **Additional Features:**
-  - Pausable (can pause transfers)
-  - Ownable (owner can manage contract)
-  - LegallyCompliantBase (regulatory compliance features)
-
-### Security
-
- **Audited:** TBD
- **Open Source:** ✅ Yes
- **Verified on Explorer:** ✅ Yes
-
---
-
-## 📝 Submission Checklist
-
-### Required Information
-
- [x] Token name and symbol
- [x] Contract address
- [x] Chain ID and network name
- [x] Decimals
- [x] Token type
- [x] Block explorer link
- [x] Token description
- [ ] Logo (512x512 PNG)
- [ ] Official website
- [ ] Social media links
- [ ] Trading volume data (if available)
- [ ] Liquidity information (if available)
-
-### Optional Information
-
- [ ] Tokenomics documentation
- [ ] Whitepaper or technical documentation
- [ ] Audit reports
- [ ] Team information
- [ ] Roadmap
-
---
-
-## 🎨 Logo Requirements
-
-**Logo Specifications:**
- **Format:** PNG
- **Size:** 512x512 pixels
- **Background:** Transparent preferred
- **File Name:** `ist-logo.png`
-
-**Note:** Can use USDC logo as reference, but should be distinct for cUSDC.
-
---
-
-## 🌐 Links and Resources
-
-### Official Links
-
- **Block Explorer:** https://explorer.d-bis.org/address/0xf22258f57794CC8E06237084b353Ab30fFfa640b
- **Network Info:** https://explorer.d-bis.org
- **RPC Endpoint:** https://rpc-http-pub.d-bis.org
-
-### Documentation
-
- **Token Contract:** `smom-dbis-138/contracts/tokens/CompliantUSDC.sol`
- **Token List:** `docs/04-configuration/metamask/METAMASK_TOKEN_LIST.json`
-
---
-
-## 📧 Submission Process
-
-### Step 1: Prepare Materials
-
-1. ✅ Token information (this document)
-2. ⏳ Logo (512x512 PNG)
-3. ⏳ Official website (if available)
-4. ⏳ Social media links (if available)
-
-### Step 2: Submit to CoinGecko
-
-1. Go to: https://www.coingecko.com/en/coins/new
-2. Fill out the submission form with information from this document
-3. Upload logo
-4. Provide all required links
-5. Submit for review
-
-### Step 3: Follow-up
-
- CoinGecko typically reviews submissions within 1-2 weeks
- May request additional information
- Respond promptly to any inquiries
-
---
-
-## ✅ Post-Listing Benefits
-
-Once listed on CoinGecko:
-
-1. **MetaMask Integration:** MetaMask will automatically display USD values for cUSDC
-2. **Price Discovery:** Users can track cUSDC price on CoinGecko
-3. **Market Visibility:** Increased exposure to crypto community
-4. **Portfolio Tracking:** Users can track cUSDC in portfolio apps
-
---
-
-## 📚 Additional Notes
-
- **Peg Maintenance:** cUSDC is designed to maintain 1:1 USD peg
- **Compliance:** Token includes regulatory compliance features
- **Minting:** Only contract owner can mint new tokens
- **Pausing:** Owner can pause transfers if needed for security
-
---
-
-**Last Updated:** 2026-01-27  
-**Status:** Ready for submission (pending logo and website)
+- Use the chain attachment above as the authoritative shared package for network identity, logo links, native assets, bridged wrapped assets, and machine-readable references.
+- Do not cite `docs/04-configuration/coingecko/exports/` from public submission material until those files are regenerated from the live token-aggregation API.
--- a/docs/04-configuration/coingecko/COINGECKO_SUBMISSION_CUSDT.md
+++ b/docs/04-configuration/coingecko/COINGECKO_SUBMISSION_CUSDT.md
@@ -1,80 +1,35 @@
-# CoinGecko Listing Submission - cUSDT (Compliant Tether USD)
+# CoinGecko Listing Submission - cUSDT

-**Last Updated:** 2026-01-31  
-**Document Version:** 1.0  
-**Status:** Active Documentation
+**Last Updated:** 2026-04-19  
+**Status:** Canonical token-specific reference

---
-
-**Date:** 2026-01-27  
-**Token:** cUSDT (Compliant Tether USD)  
-**ChainID:** 138 (DBIS Chain / Defi Oracle Meta Mainnet)
-
---
-
-## 📋 Token Information
-
-### Basic Details
+## Token Information

 | Field | Value |
 |-------|-------|
 | **Token Name** | Compliant Tether USD |
-| **Token Symbol** | cUSDT |
+| **Token Symbol** | `cUSDT` |
 | **Contract Address** | `0x93E66202A11B1772E55407B32B44e5Cd8eda7f22` |
-| **Chain ID** | 138 |
-| **Chain Name** | DBIS Chain (Defi Oracle Meta Mainnet) |
-| **Decimals** | 6 |
-| **Token Type** | ERC-20 Stablecoin |
-| **Peg** | USD (1:1) |
+| **Chain ID** | `138` |
+| **Chain Name** | `DeFi Oracle Meta Mainnet` |
+| **Decimals** | `6` |
+| **Explorer Link** | `https://explorer.d-bis.org/address/0x93E66202A11B1772E55407B32B44e5Cd8eda7f22` |

-### Token Description
+## Public References

-**cUSDT** (Compliant Tether USD) is a regulatory-compliant ERC-20 stablecoin pegged to the US Dollar (USD) at a 1:1 ratio. It is designed to provide the stability of traditional fiat currency while maintaining full compliance with legal and regulatory requirements.
+- **Website:** `https://d-bis.org/`
+- **Documentation:** `https://info.defi-oracle.io/`
+- **Explorer:** `https://explorer.d-bis.org/`
+- **Chainlist:** `https://chainlist.org/chain/138`
+- **Canonical attachment:** [COINGECKO_CHAIN138_SUBMISSION_ATTACHMENT.md](/home/intlc/projects/proxmox/docs/04-configuration/coingecko/COINGECKO_CHAIN138_SUBMISSION_ATTACHMENT.md)

-**Key Features:**
- ✅ Regulatory compliant (includes Travel Rules exemption and regulatory compliance features)
- ✅ 1:1 USD peg
- ✅ ERC-20 standard
- ✅ 6 decimals (matching USDT standard)
- ✅ Pausable and Ownable for security
+## Verified JSON References

---
+- **CoinGecko-style chain report:** `https://explorer.d-bis.org/api/v1/report/coingecko?chainId=138`
+- **Explorer wallet token list:** `https://explorer.d-bis.org/api/config/token-list`
+- **Canonical token list:** `https://explorer.d-bis.org/api/v1/report/token-list?chainId=138`

-## 🔗 Blockchain Information
+## Notes

-### Network Details
-
-| Property | Value |
-|----------|-------|
-| **Network Name** | DBIS Chain |
-| **Chain ID** | 138 |
-| **RPC Endpoint** | `https://rpc-http-pub.d-bis.org` |
-| **Block Explorer** | `https://explorer.d-bis.org` |
-| **Native Currency** | ETH |
-| **Block Time** | ~2 seconds |
-
-### Contract Verification
-
- **Explorer Link:** https://explorer.d-bis.org/address/0x93E66202A11B1772E55407B32B44e5Cd8eda7f22
- **Contract Verified:** ✅ Yes
- **Source Code:** Available on explorer
-
---
-
-## 📝 Submission Checklist
-
- [x] Token name and symbol
- [x] Contract address
- [x] Chain ID and network name
- [x] Decimals
- [x] Token type
- [x] Block explorer link
- [x] Token description
- [ ] Logo (512x512 PNG)
- [ ] Official website
- [ ] Social media links
-
---
-
-**Last Updated:** 2026-01-27  
-**Status:** Ready for submission (pending logo and website)
+- Use the chain attachment above as the authoritative shared package for network identity, logo links, native assets, bridged wrapped assets, and machine-readable references.
+- Do not cite `docs/04-configuration/coingecko/exports/` from public submission material until those files are regenerated from the live token-aggregation API.
--- a/docs/04-configuration/coingecko/COINGECKO_SUBMISSION_GUIDE.md
+++ b/docs/04-configuration/coingecko/COINGECKO_SUBMISSION_GUIDE.md
@@ -1,254 +1,37 @@
 # CoinGecko Listing Submission Guide

-**Last Updated:** 2026-01-31  
-**Document Version:** 1.0  
-**Status:** Active Documentation
+**Last Updated:** 2026-04-19  
+**Status:** Canonical process reference

---
+Use this guide together with [COINGECKO_CHAIN138_SUBMISSION_ATTACHMENT.md](/home/intlc/projects/proxmox/docs/04-configuration/coingecko/COINGECKO_CHAIN138_SUBMISSION_ATTACHMENT.md).

-**Date:** 2026-01-27  
-**Purpose:** Complete guide for submitting cUSDT and cUSDC to CoinGecko
+## Canonical Network Identity

---
+- **Chain name:** `DeFi Oracle Meta Mainnet`
+- **Chain ID:** `138`
+- **Website:** `https://d-bis.org/`
+- **Documentation:** `https://info.defi-oracle.io/`
+- **Explorer:** `https://explorer.d-bis.org/`
+- **Chainlist:** `https://chainlist.org/chain/138`

-## 📋 Overview
+## Token-Specific References

-This guide provides step-by-step instructions for submitting cUSDT and cUSDC tokens to CoinGecko for listing. Once listed, MetaMask will automatically display USD values for these tokens.
+- [COINGECKO_SUBMISSION_CUSDT.md](/home/intlc/projects/proxmox/docs/04-configuration/coingecko/COINGECKO_SUBMISSION_CUSDT.md)
+- [COINGECKO_SUBMISSION_CUSDC.md](/home/intlc/projects/proxmox/docs/04-configuration/coingecko/COINGECKO_SUBMISSION_CUSDC.md)

---
+## Verified Public JSON Endpoints

-## 🎯 Why Submit to CoinGecko?
+- **CoinGecko-style chain report:** `https://explorer.d-bis.org/api/v1/report/coingecko?chainId=138`
+- **CMC-style chain report:** `https://explorer.d-bis.org/api/v1/report/cmc?chainId=138`
+- **Cross-chain report:** `https://explorer.d-bis.org/api/v1/report/cross-chain?chainId=138`
+- **Canonical token list:** `https://explorer.d-bis.org/api/v1/report/token-list?chainId=138`
+- **Public `cW*` registry:** `https://explorer.d-bis.org/api/v1/report/cw-registry`
+- **Explorer wallet token list:** `https://explorer.d-bis.org/api/config/token-list`
+- **Explorer wallet networks config:** `https://explorer.d-bis.org/api/config/networks`

-### Benefits
+## Submission Guidance

-1. **MetaMask Integration**
-   - MetaMask automatically queries CoinGecko for USD prices
-   - No need for custom oracle integration in MetaMask
-   - Users see USD values automatically
-
-2. **Price Discovery**
-   - Users can track token prices on CoinGecko
-   - Historical price data
-   - Market cap and volume tracking
-
-3. **Market Visibility**
-   - Increased exposure to crypto community
-   - Portfolio tracking apps support
-   - Exchange listings may require CoinGecko listing
-
---
-
-## 📝 Prerequisites
-
-### Required Materials
-
- [x] Token contract addresses
- [x] Token information (name, symbol, decimals)
- [x] Block explorer links
- [ ] Token logos (512x512 PNG)
- [ ] Official website (optional but recommended)
- [ ] Social media links (optional but recommended)
-
-### Token Information
-
-**cUSDT:**
- Address: `0x93E66202A11B1772E55407B32B44e5Cd8eda7f22`
- See: `COINGECKO_SUBMISSION_CUSDT.md`
-
-**cUSDC:**
- Address: `0xf22258f57794CC8E06237084b353Ab30fFfa640b`
- See: `COINGECKO_SUBMISSION_CUSDC.md`
-
---
-
-## 🚀 Submission Steps
-
-### Step 1: Prepare Logos
-
-**Requirements:**
- Format: PNG
- Size: 512×512 pixels
- Background: Transparent preferred
- Quality: High resolution
-
-**Quick prepare (script):**
-```bash
-# From repo root. Requires ImageMagick (convert) or Pillow for 512×512 resize.
-# Install: apt install imagemagick  OR  pip install Pillow
-./docs/04-configuration/coingecko/scripts/prepare-token-logos-512x512.sh
-# Output: docs/04-configuration/coingecko/logos/*-512x512.png
-```
-
-**Where to get logos:**
- Use USDT/USDC logos as reference
- Create distinct versions for cUSDT/cUSDC
- Ensure they meet size requirements
-
-### Step 2: Create CoinGecko Account
-
-1. Go to: https://www.coingecko.com
-2. Click "Sign Up" or "Login"
-3. Create account (free)
-4. Verify email if required
-
-### Step 3: Submit Token
-
-1. **Navigate to submission page:**
-   - Go to: https://www.coingecko.com/en/coins/new
-   - Or: https://www.coingecko.com/en/request/new
-
-2. **Fill out the form:**
-
-   **Basic Information:**
-   - Token Name: "Compliant Tether USD" (for cUSDT) or "Compliant USD Coin" (for cUSDC)
-   - Symbol: "cUSDT" or "cUSDC"
-   - Contract Address: `0x93E66202A11B1772E55407B32B44e5Cd8eda7f22` (cUSDT) or `0xf22258f57794CC8E06237084b353Ab30fFfa640b` (cUSDC)
-   - Chain: Select "Custom Chain" or "Other"
-   - Chain ID: 138
-   - Decimals: 6
-
-   **Network Information:**
-   - Network Name: "DBIS Chain" or "Defi Oracle Meta Mainnet"
-   - RPC URL: `https://rpc-http-pub.d-bis.org`
-   - Block Explorer: `https://explorer.d-bis.org`
-
-   **Additional Information:**
-   - Description: Use description from submission documents
-   - Logo: Upload 512x512 PNG
-   - Website: (if available)
-   - Twitter: (if available)
-   - Telegram: (if available)
-   - Discord: (if available)
-
-3. **Submit for review**
-
-### Step 4: Follow-up
-
- CoinGecko typically reviews within 1-2 weeks
- Check email for any requests for additional information
- Respond promptly to inquiries
- May need to provide:
-  - Trading volume data
-  - Liquidity information
-  - Additional documentation
-
---
-
-## 📊 Submission Checklist
-
-### For Each Token (cUSDT and cUSDC)
-
- [ ] Logo prepared (512x512 PNG)
- [ ] CoinGecko account created
- [ ] Submission form filled out
- [ ] All required fields completed
- [ ] Submission sent
- [ ] Confirmation email received
- [ ] Follow-up completed (if requested)
-
---
-
-## ⏱️ Timeline
-
-### Expected Timeline
-
-1. **Submission:** Immediate
-2. **Initial Review:** 1-3 business days
-3. **Additional Info Request:** 3-5 business days (if needed)
-4. **Approval:** 1-2 weeks from submission
-5. **Listing:** Within 24 hours of approval
-
-### Total Time: 1-2 weeks
-
---
-
-## 🔍 After Listing
-
-### Verification Steps
-
-1. **Check CoinGecko:**
-   - Search for "cUSDT" or "cUSDC"
-   - Verify information is correct
-   - Check price is displaying
-
-2. **Test MetaMask:**
-   - Add token to MetaMask
-   - Verify USD value displays
-   - Check price updates
-
-3. **Monitor:**
-   - Check price accuracy
-   - Monitor for any issues
-   - Update if needed
-
---
-
-## 📚 Resources
-
-### Submission Documents
-
- **cUSDT:** `COINGECKO_SUBMISSION_CUSDT.md`
- **cUSDC:** `COINGECKO_SUBMISSION_CUSDC.md`
-
-### CoinGecko Links
-
- **Submission Form:** https://www.coingecko.com/en/coins/new
- **Help Center:** https://www.coingecko.com/en/help
- **API Documentation:** https://www.coingecko.com/en/api
-
-### Related Documentation
-
- **GRU M1 Master Plan:** `../../gru-m1/GRU_M1_MASTER_IMPLEMENTATION_PLAN.md` — End-to-end listing framework, dry-runs, CMC/CG preparation
- **Oracle Setup:** `../metamask/ORACLE_PRICE_FEED_SETUP.md`
- **Token Lists:** `../metamask/METAMASK_TOKEN_LIST.json`
- **Token Addresses:** `../../11-references/CHAIN138_TOKEN_ADDRESSES.md`
-
---
-
-## ❓ Common Questions
-
-### Q: What if CoinGecko doesn't support ChainID 138?
-
-**A:** CoinGecko supports custom chains. You may need to:
- Select "Custom Chain" or "Other" in the form
- Provide RPC URL and block explorer
- May need to contact CoinGecko support for custom chain support
-
-### Q: Do I need trading volume to be listed?
-
-**A:** Not necessarily, but it helps. CoinGecko may list tokens with:
- Active development
- Community interest
- Technical merit
- Even without significant trading volume initially
-
-### Q: Can I submit both tokens at once?
-
-**A:** Yes, but submit them separately:
- One submission for cUSDT
- One submission for cUSDC
- Each needs its own form submission
-
-### Q: What if my submission is rejected?
-
-**A:** CoinGecko will provide reasons. Common reasons:
- Missing information
- Insufficient documentation
- Chain not supported (may need to request support)
- Contact CoinGecko support for clarification
-
---
-
-## ✅ Success Criteria
-
-Your submission is successful when:
-
-1. ✅ Token appears on CoinGecko
-2. ✅ Price data is available
-3. ✅ MetaMask shows USD values automatically
-4. ✅ Information is accurate
-
---
-
-**Last Updated:** 2026-01-27  
-**Status:** Ready for submission
+- Use the chain attachment as the authoritative package for naming, links, logo, native assets, bridged wrapped assets, and verification sources.
+- Use the token-specific `cUSDT` and `cUSDC` docs only for single-token form entries.
+- If a machine-readable file is requested, prefer the verified public JSON endpoints above or the latest generated artifacts linked from the chain attachment.
+- Do not use `docs/04-configuration/coingecko/exports/*.json` until regenerated from live API output.
--- a/docs/04-configuration/coingecko/COINGECKO_SUBMISSION_PACKAGE.md
+++ b/docs/04-configuration/coingecko/COINGECKO_SUBMISSION_PACKAGE.md
@@ -1,243 +1,45 @@
 # CoinGecko Submission Package — Chain 138

-**Last Updated:** 2026-01-31  
-**Document Version:** 1.0  
-**Status:** Active Documentation
+**Last Updated:** 2026-04-19  
+**Status:** Canonical reference wrapper

---
+This document is now a thin wrapper around the current canonical submission attachment for Chain 138.

-**Date:** 2026-01-30  
-**Purpose:** Submit Chain 138 (DeFi Oracle Meta Mainnet) to CoinGecko for native USD prices in MetaMask  
-**Status:** Ready for submission
+Use [COINGECKO_CHAIN138_SUBMISSION_ATTACHMENT.md](/home/intlc/projects/proxmox/docs/04-configuration/coingecko/COINGECKO_CHAIN138_SUBMISSION_ATTACHMENT.md) as the source of truth for:

---
+- official chain naming
+- official website, explorer, docs, Chainlist, and logo links
+- current native `c*` asset inventory
+- current public `cW*` bridged wrapped asset inventory
+- verified repo sources and machine-readable JSON references

-## Why Submit to CoinGecko?
+## Canonical Public Network Identity

-**Benefits:**
- Native USD prices in MetaMask for Chain 138 tokens
- Better visibility and discoverability
- Integration with DeFi aggregators and wallets
- Historical price data and charts
+- **Chain name:** `DeFi Oracle Meta Mainnet`
+- **Website:** `https://d-bis.org/`
+- **Documentation:** `https://info.defi-oracle.io/`
+- **Explorer:** `https://explorer.d-bis.org/`
+- **Chainlist:** `https://chainlist.org/chain/138`

---
+## Verified Public JSON Endpoints

-## Submission Information
+These endpoints were live-verified on 2026-04-19 and should be preferred over older exported stubs in this directory.

-### Chain Details
+- **CoinGecko-style report:** `https://explorer.d-bis.org/api/v1/report/coingecko?chainId=138`
+- **CMC-style report:** `https://explorer.d-bis.org/api/v1/report/cmc?chainId=138`
+- **Cross-chain report:** `https://explorer.d-bis.org/api/v1/report/cross-chain?chainId=138`
+- **Canonical token list:** `https://explorer.d-bis.org/api/v1/report/token-list?chainId=138`
+- **Public `cW*` registry:** `https://explorer.d-bis.org/api/v1/report/cw-registry`
+- **Explorer wallet token list:** `https://explorer.d-bis.org/api/config/token-list`
+- **Explorer wallet networks config:** `https://explorer.d-bis.org/api/config/networks`

-| Field | Value |
-|-------|-------|
-| **Chain Name** | DeFi Oracle Meta Mainnet |
-| **Chain ID** | 138 (0x8a) |
-| **Symbol** | ETH |
-| **RPC URLs** | https://rpc-http-pub.d-bis.org<br>https://rpc.d-bis.org<br>https://rpc2.d-bis.org |
-| **Explorer** | https://explorer.d-bis.org |
-| **Website** | https://d-bis.org |
-| **Block Time** | 2 seconds |
-| **Consensus** | QBFT (Quorum Byzantine Fault Tolerance) |
-| **Type** | EVM-compatible (Besu) |
+## Local Machine-Readable References

-### Network Information
+- [cw-mesh-deployment-matrix-latest.json](/home/intlc/projects/proxmox/reports/status/cw-mesh-deployment-matrix-latest.json)
+- [cw-public-prices-latest.json](/home/intlc/projects/proxmox/reports/status/cw-public-prices-latest.json)
+- [promod-uniswap-v2-phase2-wave1-completion-status-latest.json](/home/intlc/projects/proxmox/reports/extraction/promod-uniswap-v2-phase2-wave1-completion-status-latest.json)
+- [strict-operator-public-liquidity-table-latest.json](/home/intlc/projects/proxmox/reports/extraction/strict-operator-public-liquidity-table-latest.json)

-```json
-{
-  "chainId": "0x8a",
-  "chainName": "DeFi Oracle Meta Mainnet",
-  "nativeCurrency": {
-    "name": "Ether",
-    "symbol": "ETH",
-    "decimals": 18
-  },
-  "rpcUrls": [
-    "https://rpc-http-pub.d-bis.org",
-    "https://rpc.d-bis.org",
-    "https://rpc2.d-bis.org"
-  ],
-  "blockExplorerUrls": ["https://explorer.d-bis.org"]
-}
-```
+## Do Not Use

---
-
-## Tokens to Submit
-
-### Priority Tokens (Submit First)
-
-| Symbol | Name | Address | Type |
-|--------|------|---------|------|
-| **WETH** | Wrapped Ether | `0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2` | Wrapped native |
-| **WETH10** | Wrapped Ether v10 | `0xf4BB2e28688e89fCcE3c0580D37d36A7672E8A9f` | Wrapped native |
-| **cUSDT** | Compliant Tether USD | `0x93E66202A11B1772E55407B32B44e5Cd8eda7f22` | Stablecoin |
-| **cUSDC** | Compliant USD Coin | `0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238` | Stablecoin |
-| **cEURC** | Compliant Euro Coin | `0x08210F9170F89Ab7658F0B5E3fF39b0E03C594D4` | Stablecoin |
-
-### Additional Tokens
-
-| Symbol | Name | Address | Type |
-|--------|------|---------|------|
-| **cGBPC** | Compliant British Pound Coin | `0x4e65fE4DbA92790696d040ac24Aa414708F5c0AB` | Stablecoin |
-| **cAUDC** | Compliant Australian Dollar Coin | `0x9F3B8679c73C2Fef8b59B4f3444d4e156fb70AA5` | Stablecoin |
-| **cJPYC** | Compliant Japanese Yen Coin | `0x431D5dfF03120AFA4bDf332c61A6e1766eF37BDB` | Stablecoin |
-| **cCHFC** | Compliant Swiss Franc Coin | `0x2416092f143378750bb29b79eD961ab195CcEea5` | Stablecoin |
-| **cCADC** | Compliant Canadian Dollar Coin | `0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359` | Stablecoin |
-
---
-
-## Submission Process
-
-### 1. Create CoinGecko Account
-
- Visit: https://www.coingecko.com/
- Sign up for free account
- Verify email
-
-### 2. Submit Chain
-
- Go to: https://www.coingecko.com/en/request
- Select "Add New Blockchain"
- Fill form with chain details above
- Provide:
-  - Chain name, ID, symbol
-  - RPC endpoints
-  - Explorer URL
-  - Website
-  - Description
-  - Logo (if available)
-
-### 3. Submit Tokens
-
-For each token:
- Go to: https://www.coingecko.com/en/request
- Select "Add New Cryptocurrency"
- Provide:
-  - Token name, symbol, decimals
-  - Contract address
-  - Chain: DeFi Oracle Meta Mainnet (138)
-  - Description
-  - Logo (if available)
-  - Website/docs (if available)
-
-### 4. Verification
-
-CoinGecko will verify:
- Chain is live and accessible
- RPC endpoints work
- Explorer shows transactions
- Token contracts are deployed and verified
-
-**Timeline:** Usually 1-2 weeks for review
-
---
-
-## Supporting Materials
-
-### Chain Verification
-
-```bash
-# Verify RPC is accessible
-curl -X POST https://rpc-http-pub.d-bis.org \
-  -H "Content-Type: application/json" \
-  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
-
-# Verify explorer
-curl https://explorer.d-bis.org/api/v2/stats
-```
-
-### Token Verification
-
-```bash
-# Verify token contract (example: WETH)
-curl "https://explorer.d-bis.org/api/v2/tokens/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
-```
-
-### Token List
-
-Full token list available at:
- **API:** https://explorer.d-bis.org/api/config/token-list
- **File:** `docs/04-configuration/metamask/DUAL_CHAIN_TOKEN_LIST.tokenlist.json`
-
---
-
-## Submission Template
-
-### Chain Submission
-
-```
-Chain Name: DeFi Oracle Meta Mainnet
-Chain ID: 138
-Symbol: ETH
-Type: EVM-compatible (Hyperledger Besu)
-Consensus: QBFT
-Block Time: 2 seconds
-
-RPC Endpoints:
- https://rpc-http-pub.d-bis.org
- https://rpc.d-bis.org
- https://rpc2.d-bis.org
-
-Explorer: https://explorer.d-bis.org
-Website: https://d-bis.org
-
-Description:
-DeFi Oracle Meta Mainnet (Chain 138) is an enterprise-grade, EVM-compatible blockchain built on Hyperledger Besu with QBFT consensus. It features native oracle integration, cross-chain bridges (CCIP), and compliant stablecoins for institutional DeFi applications.
-
-Key Features:
- 2-second block time
- Native ETH/USD oracle integration
- CCIP bridge to Ethereum Mainnet
- Compliant stablecoins (cUSDT, cUSDC, cEURC, etc.)
- Enterprise-grade security and performance
-```
-
-### Token Submission Template (Example: cUSDT)
-
-```
-Token Name: Compliant Tether USD
-Symbol: cUSDT
-Decimals: 6
-Contract Address: 0x93E66202A11B1772E55407B32B44e5Cd8eda7f22
-Chain: DeFi Oracle Meta Mainnet (138)
-
-Description:
-Compliant Tether USD (cUSDT) is a regulated stablecoin pegged to USD, designed for institutional use on Chain 138. It features compliance controls, KYC/AML integration, and cross-chain bridge support.
-
-Explorer: https://explorer.d-bis.org/address/0x93E66202A11B1772E55407B32B44e5Cd8eda7f22
-```
-
---
-
-## Post-Submission
-
-### After Approval
-
-1. **Verify listings:**
-   - Check Chain 138 appears on CoinGecko
-   - Verify tokens show USD prices
-
-2. **Update MetaMask:**
-   - USD prices should appear automatically
-   - No code changes needed
-
-3. **Monitor:**
-   - Check price accuracy
-   - Report any issues to CoinGecko support
-
---
-
-## Alternative: Manual Price Feed
-
-If CoinGecko submission takes too long, use token-aggregation API:
-
-```javascript
-// Get token price from our API
-const response = await fetch('https://explorer.d-bis.org/api/market/tokens?chainId=138');
-const tokens = await response.json();
-// tokens will include prices from CoinGecko/CMC/DexScreener
-```
-
---
-
-**Last updated:** 2026-01-30  
-**Status:** Ready for submission  
-**Submission URL:** https://www.coingecko.com/en/request
+Do not use files under [exports](/home/intlc/projects/proxmox/docs/04-configuration/coingecko/exports) as authoritative submission payloads right now. They currently contain placeholder Blockscout-style error JSON rather than current token-aggregation report data.
--- a/docs/04-configuration/verification-evidence/e2e-verification-20260419_162326/all_e2e_results.json
+++ b/docs/04-configuration/verification-evidence/e2e-verification-20260419_162326/all_e2e_results.json
--- a/reports/status/cw-public-prices-latest.json
+++ b/reports/status/cw-public-prices-latest.json