docs(coingecko): normalize 5 submission docs to canonical attachment + verified API endpoints (companion PR, partial) #10

Open
nsatoshi wants to merge 2 commits from devin/coingecko-normalization-companion-20260419 into master
Owner

Summary

Companion PR to the locally-normalized CoinGecko submission work. Stages the 7 files that could be confirmed verbatim from this session:

5 normalized CoinGecko docs (docs/04-configuration/coingecko/):

  • COINGECKO_API_NO_PUSH_LIQUIDITY.md — explains CoinGecko API is read-only; GeckoTerminal indexes supported chains on-chain; Chain 138 requires submitting a pull URL.
  • COINGECKO_SUBMISSION_CUSDT.md — cUSDT (0x93E66202…, 6 decimals) on DeFi Oracle Meta Mainnet; points at canonical attachment + 3 verified API endpoints.
  • COINGECKO_SUBMISSION_CUSDC.md — cUSDC (0xf22258f5…, 6 decimals) on DeFi Oracle Meta Mainnet; same structure as cUSDT.
  • COINGECKO_SUBMISSION_GUIDE.md — canonical process reference with 7 verified public JSON endpoints.
  • COINGECKO_SUBMISSION_PACKAGE.md — thin wrapper around canonical attachment; explicitly warns not to cite coingecko/exports/*.json until regenerated.

2 machine-readable artifacts / E2E evidence:

  • reports/status/cw-public-prices-latest.json (2,095 lines) — per-chain cW* prices derived from DODO PMM pool midPrices.
  • docs/04-configuration/verification-evidence/e2e-verification-20260419_162326/all_e2e_results.json (44 entries) — full E2E results backing the canonical attachment: 44/44 DNS pass, 28 HTTPS pass, all RPC/WS/Blockscout checks pass; one warn on sankofa.nexus (502).

What this PR normalizes:

  • Chain name standardized to DeFi Oracle Meta Mainnet (capital F) to match live services.
  • All submission docs now point to COINGECKO_CHAIN138_SUBMISSION_ATTACHMENT.md as the single authoritative package rather than duplicating content.
  • All docs list the 7 verified public JSON endpoints (live-verified 200 OK on 2026-04-19) as the preferred machine-readable references instead of the docs/04-configuration/coingecko/exports/*.json placeholder payloads.

Files NOT yet included (pending user handoff)

Four files from the original 11-file set could not be staged verbatim in this session because the updated content was not shared inline:

  • docs/04-configuration/coingecko/COINGECKO_CHAIN138_SUBMISSION_ATTACHMENT.md — the version with the full credibility certifications matrix + native/bridged asset tables + Fastest Remaining Wins.
  • docs/04-configuration/coingecko/CMC_COINGECKO_SUBMISSION_RUNBOOK.md — refreshed version with credibility-matrix section.
  • reports/status/cw-mesh-deployment-matrix-latest.json — 11-chain per-chain deployment status.
  • docs/04-configuration/verification-evidence/e2e-verification-20260419_162326/verification_report.md — human-readable E2E routing summary.

Ship these in a follow-up commit to this same branch once the content is shared.

Review & Testing Checklist for Human

  • Confirm the 5 normalized CoinGecko docs match the intended canonical wording (particularly the DeFi Oracle Meta Mainnet casing, the 7 verified endpoint list, and the "do not use exports/*.json" note).
  • Verify reports/status/cw-public-prices-latest.json is the intended snapshot (generated from promod-uniswap-v2-live-pair-discovery-latest.json + deployment-status.json).
  • Confirm all_e2e_results.json 44 entries match the evidence run at 2026-04-19T16:23:26-07:00 from 76.53.10.36.
  • Decide whether to merge this partial PR first and file a follow-up with the 4 missing files, or hold this branch and land all 11 at once.

Notes

  • Does not modify any on-chain state, secrets, or deployment config; documentation and evidence artifacts only.
  • Does not overlap with the 8 earlier staged PRs (#2–#8, #1–#2 on smom-dbis-138), nor with #9 (devin/explorer-verification-checklist-20260419).
  • COINGECKO_CHAIN138_SUBMISSION_ATTACHMENT.md is currently only in PR #7 (older draft). When the refreshed version lands on this branch, PR #7 will need a rebase.
  • Opened as draft so the 4 missing files can be appended as a second commit before human review.
## Summary Companion PR to the locally-normalized CoinGecko submission work. Stages the 7 files that could be confirmed verbatim from this session: **5 normalized CoinGecko docs** (`docs/04-configuration/coingecko/`): - `COINGECKO_API_NO_PUSH_LIQUIDITY.md` — explains CoinGecko API is read-only; GeckoTerminal indexes supported chains on-chain; Chain 138 requires submitting a pull URL. - `COINGECKO_SUBMISSION_CUSDT.md` — cUSDT (`0x93E66202…`, 6 decimals) on `DeFi Oracle Meta Mainnet`; points at canonical attachment + 3 verified API endpoints. - `COINGECKO_SUBMISSION_CUSDC.md` — cUSDC (`0xf22258f5…`, 6 decimals) on `DeFi Oracle Meta Mainnet`; same structure as cUSDT. - `COINGECKO_SUBMISSION_GUIDE.md` — canonical process reference with 7 verified public JSON endpoints. - `COINGECKO_SUBMISSION_PACKAGE.md` — thin wrapper around canonical attachment; explicitly warns not to cite `coingecko/exports/*.json` until regenerated. **2 machine-readable artifacts / E2E evidence**: - `reports/status/cw-public-prices-latest.json` (2,095 lines) — per-chain cW* prices derived from DODO PMM pool midPrices. - `docs/04-configuration/verification-evidence/e2e-verification-20260419_162326/all_e2e_results.json` (44 entries) — full E2E results backing the canonical attachment: 44/44 DNS pass, 28 HTTPS pass, all RPC/WS/Blockscout checks pass; one warn on `sankofa.nexus` (502). **What this PR normalizes**: - Chain name standardized to `DeFi Oracle Meta Mainnet` (capital F) to match live services. - All submission docs now point to `COINGECKO_CHAIN138_SUBMISSION_ATTACHMENT.md` as the single authoritative package rather than duplicating content. - All docs list the **7 verified public JSON endpoints** (live-verified 200 OK on 2026-04-19) as the preferred machine-readable references instead of the `docs/04-configuration/coingecko/exports/*.json` placeholder payloads. ## Files NOT yet included (pending user handoff) Four files from the original 11-file set could not be staged verbatim in this session because the updated content was not shared inline: - `docs/04-configuration/coingecko/COINGECKO_CHAIN138_SUBMISSION_ATTACHMENT.md` — the version with the full **credibility certifications matrix** + native/bridged asset tables + Fastest Remaining Wins. - `docs/04-configuration/coingecko/CMC_COINGECKO_SUBMISSION_RUNBOOK.md` — refreshed version with credibility-matrix section. - `reports/status/cw-mesh-deployment-matrix-latest.json` — 11-chain per-chain deployment status. - `docs/04-configuration/verification-evidence/e2e-verification-20260419_162326/verification_report.md` — human-readable E2E routing summary. Ship these in a follow-up commit to this same branch once the content is shared. ## Review & Testing Checklist for Human - [ ] Confirm the 5 normalized CoinGecko docs match the intended canonical wording (particularly the `DeFi Oracle Meta Mainnet` casing, the 7 verified endpoint list, and the "do not use exports/*.json" note). - [ ] Verify `reports/status/cw-public-prices-latest.json` is the intended snapshot (generated from `promod-uniswap-v2-live-pair-discovery-latest.json` + `deployment-status.json`). - [ ] Confirm `all_e2e_results.json` 44 entries match the evidence run at `2026-04-19T16:23:26-07:00` from `76.53.10.36`. - [ ] Decide whether to merge this partial PR first and file a follow-up with the 4 missing files, or hold this branch and land all 11 at once. ### Notes - Does not modify any on-chain state, secrets, or deployment config; documentation and evidence artifacts only. - Does not overlap with the 8 earlier staged PRs (#2–#8, #1–#2 on smom-dbis-138), nor with #9 (`devin/explorer-verification-checklist-20260419`). - `COINGECKO_CHAIN138_SUBMISSION_ATTACHMENT.md` is currently only in PR #7 (older draft). When the refreshed version lands on this branch, PR #7 will need a rebase. - Opened as **draft** so the 4 missing files can be appended as a second commit before human review.
nsatoshi added 1 commit 2026-04-19 23:52:42 +00:00
docs(coingecko): normalize 5 submission docs to canonical attachment + verified API endpoints
Some checks failed
AI Code Review / claude-review (pull_request) Failing after 33s
c111a69873
- 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>

Claude encountered an error —— View job


I'll analyze this and get back to you.

**Claude encountered an error** —— [View job](http://127.0.0.1:3000/d-bis/proxmox/actions/runs/130) --- I'll analyze this and get back to you.
nsatoshi added 1 commit 2026-04-20 00:40:50 +00:00
docs(coingecko): add 4 remaining normalized files to companion PR
Some checks failed
AI Code Review / claude-review (pull_request) Failing after 34s
288c0f2a06
- COINGECKO_CHAIN138_SUBMISSION_ATTACHMENT.md: canonical submission
  package (143 lines) with 'DeFi Oracle Meta Mainnet' naming and the
  credibility-certifications matrix (starts at line 85).
- CMC_COINGECKO_SUBMISSION_RUNBOOK.md: refreshed runbook (126 lines)
  with repo/operator vs third-party credibility-matrix section.
- reports/status/cw-mesh-deployment-matrix-latest.json: 11-chain
  deployment matrix artifact (178 lines) referenced from the package.
- docs/04-configuration/verification-evidence/e2e-verification-20260419_162326/verification_report.md:
  human-readable E2E summary (445 lines) matching all_e2e_results.json.

Co-Authored-By: Nakamoto, S <defi@defi-oracle.io>

Claude encountered an error —— View job


I'll analyze this and get back to you.

**Claude encountered an error** —— [View job](http://127.0.0.1:3000/d-bis/proxmox/actions/runs/131) --- I'll analyze this and get back to you.
Author
Owner

Attached the 4 remaining files for PR #10: COINGECKO_CHAIN138_SUBMISSION_ATTACHMENT.md with the credibility-certifications matrix, the refreshed CMC_COINGECKO_SUBMISSION_RUNBOOK.md with the repo-vs-third-party credibility matrix, reports/status/cw-mesh-deployment-matrix-latest.json, and the human-readable E2E summary verification_report.md.

Line counts verified: ATTACHMENT 143, RUNBOOK 126, cw-mesh 178 (valid JSON), verification_report 445. Commit 288c0f2a on the same branch. All 11/11 files now staged; flipped from draft to ready-for-review.

Attached the 4 remaining files for PR #10: `COINGECKO_CHAIN138_SUBMISSION_ATTACHMENT.md` with the credibility-certifications matrix, the refreshed `CMC_COINGECKO_SUBMISSION_RUNBOOK.md` with the repo-vs-third-party credibility matrix, `reports/status/cw-mesh-deployment-matrix-latest.json`, and the human-readable E2E summary `verification_report.md`. Line counts verified: ATTACHMENT 143, RUNBOOK 126, cw-mesh 178 (valid JSON), verification_report 445. Commit `288c0f2a` on the same branch. All 11/11 files now staged; flipped from draft to ready-for-review.
Some checks failed
AI Code Review / claude-review (pull_request) Failing after 34s
This pull request has changes conflicting with the target branch.
  • docs/04-configuration/coingecko/CMC_COINGECKO_SUBMISSION_RUNBOOK.md
  • docs/04-configuration/coingecko/COINGECKO_SUBMISSION_GUIDE.md
  • docs/04-configuration/verification-evidence/e2e-verification-20260419_162326/all_e2e_results.json
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin devin/coingecko-normalization-companion-20260419:devin/coingecko-normalization-companion-20260419
git checkout devin/coingecko-normalization-companion-20260419
Sign in to join this conversation.
No Reviewers
No Label
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: d-bis/proxmox#10