diff --git a/reports/status/2026-04-25_EXPLORER_PRICING_RELEASE_NOTES.md b/reports/status/2026-04-25_EXPLORER_PRICING_RELEASE_NOTES.md index 3333d83d..91318d98 100644 --- a/reports/status/2026-04-25_EXPLORER_PRICING_RELEASE_NOTES.md +++ b/reports/status/2026-04-25_EXPLORER_PRICING_RELEASE_NOTES.md @@ -7,6 +7,13 @@ Release scope: Chain 138 explorer pricing, historical valuation, token-aggregati This release adds live market pricing across the Chain 138 explorer, introduces transfer-time historical valuation support, restores compatibility for legacy transaction links, hardens pricing/indexer operations, and exposes Snap-ready pricing methods for wallet integrations. +## Rollout Tracking + +- Execution checklist: + - [2026-04-26_EXPLORER_PRICING_EXECUTION_CHECKLIST.md](/home/intlc/projects/proxmox/reports/status/2026-04-26_EXPLORER_PRICING_EXECUTION_CHECKLIST.md) +- Commit plan: + - [2026-04-25_EXPLORER_PRICING_COMMIT_PLAN.md](/home/intlc/projects/proxmox/reports/status/2026-04-25_EXPLORER_PRICING_COMMIT_PLAN.md) + ## User-Facing Changes ### Explorer @@ -99,3 +106,4 @@ This release adds live market pricing across the Chain 138 explorer, introduces - Current-market pricing is used on address and token detail pages - Transfer-time pricing is used through the historical pricing context path when a valid locked source exists - If no acceptable historical source exists, the API now explicitly returns fallback pricing with `locked: false` +- Use the execution checklist above for merge, post-merge verification, optional follow-up, and cleanup tracking diff --git a/reports/status/2026-04-26_EXPLORER_PRICING_EXECUTION_CHECKLIST.md b/reports/status/2026-04-26_EXPLORER_PRICING_EXECUTION_CHECKLIST.md new file mode 100644 index 00000000..9d336fa7 --- /dev/null +++ b/reports/status/2026-04-26_EXPLORER_PRICING_EXECUTION_CHECKLIST.md @@ -0,0 +1,162 @@ +# Explorer Pricing Rollout Execution Checklist + +Date: `2026-04-26` +Owner scope: `explorer-monorepo`, `smom-dbis-138`, `metamask-integration`, `proxmox` + +Related docs: + +- [2026-04-25_EXPLORER_PRICING_RELEASE_NOTES.md](/home/intlc/projects/proxmox/reports/status/2026-04-25_EXPLORER_PRICING_RELEASE_NOTES.md) +- [2026-04-25_EXPLORER_PRICING_COMMIT_PLAN.md](/home/intlc/projects/proxmox/reports/status/2026-04-25_EXPLORER_PRICING_COMMIT_PLAN.md) + +## Status Key + +- `[x]` Done +- `[ ]` Pending +- `[~]` Optional + +## Done + +- [x] Create and populate all four Gitea PRs + - `explorer-monorepo` PR #15 + - https://gitea.d-bis.org/d-bis/explorer-monorepo/pulls/15 + - `smom-dbis-138` PR #3 + - https://gitea.d-bis.org/d-bis/smom-dbis-138/pulls/3 + - `metamask-integration` PR #1 + - https://gitea.d-bis.org/d-bis/metamask-integration/pulls/1 + - `proxmox` PR #14 + - https://gitea.d-bis.org/d-bis/proxmox/pulls/14 + +- [x] Push all review branches to canonical Gitea remotes + - `feature/explorer-live-pricing-historical-valuation` + - `feature/token-aggregation-historical-pricing` + - `feature/chain138-snap-pricing-context` + - `chore/explorer-pricing-rollout-coordination` + +- [x] Verify production routing and pricing behavior + - Legacy tx URL returns `308` + ```bash + curl -I -sS 'https://explorer.d-bis.org/tx/0xd61be3f32beb7c18782a41cf38c1d7a2f4ac7585ec656d62b7bc58b4d0ac4ebe' + ``` + - Canonical transaction URL returns `200` + ```bash + curl -I -sS 'https://explorer.d-bis.org/transactions/0xd61be3f32beb7c18782a41cf38c1d7a2f4ac7585ec656d62b7bc58b4d0ac4ebe' + ``` + - Historical pricing context returns current + locked historical data + ```bash + curl -fsS 'https://explorer.d-bis.org/token-aggregation/api/v1/tokens/0xc02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/pricing-context?chainId=138×tamp=2026-04-26T01:33:02.000Z' + ``` + - CT `5000` services are active + ```bash + ssh root@192.168.11.12 "pct exec 5000 -- bash -lc 'systemctl is-active token-aggregation; systemctl is-active solacescanscout-frontend'" + ``` + +## Pending + +- [ ] Review `explorer-monorepo` PR #15 + - Compare: + - https://gitea.d-bis.org/d-bis/explorer-monorepo/compare/master...feature/explorer-live-pricing-historical-valuation + +- [ ] Review `smom-dbis-138` PR #3 + - Compare: + - https://gitea.d-bis.org/d-bis/smom-dbis-138/compare/main...feature/token-aggregation-historical-pricing + +- [ ] Review `metamask-integration` PR #1 + - Compare: + - https://gitea.d-bis.org/d-bis/metamask-integration/compare/main...feature/chain138-snap-pricing-context + +- [ ] Review `proxmox` PR #14 + - Compare: + - https://gitea.d-bis.org/d-bis/proxmox/compare/master...chore/explorer-pricing-rollout-coordination + +- [ ] Merge all four PRs after review + - Web UI: + - open each PR and click `Merge` + - API example: + ```bash + curl -u 'USER:TOKEN' \ + -H 'Content-Type: application/json' \ + -X POST \ + 'https://gitea.d-bis.org/api/v1/repos/d-bis/explorer-monorepo/pulls/15/merge' \ + -d '{"Do":"merge","force_merge":false}' + ``` + - Repeat with: + - `smom-dbis-138` PR `3` + - `metamask-integration` PR `1` + - `proxmox` PR `14` + +- [ ] Fetch merged refs locally after PR merges + ```bash + git -C /home/intlc/projects/proxmox/explorer-monorepo fetch origin + git -C /home/intlc/projects/proxmox/smom-dbis-138 fetch gitea + git -C /home/intlc/projects/proxmox/metamask-integration fetch gitea + git -C /home/intlc/projects/proxmox fetch gitea + ``` + +- [ ] Verify merged SHAs match intended rollout state + ```bash + git -C /home/intlc/projects/proxmox/explorer-monorepo rev-parse origin/master + git -C /home/intlc/projects/proxmox/smom-dbis-138 rev-parse gitea/main + git -C /home/intlc/projects/proxmox/metamask-integration rev-parse gitea/main + git -C /home/intlc/projects/proxmox rev-parse gitea/master + ``` + +- [ ] Re-run post-merge production verification + ```bash + curl -I -sS 'https://explorer.d-bis.org/tx/0xd61be3f32beb7c18782a41cf38c1d7a2f4ac7585ec656d62b7bc58b4d0ac4ebe' + curl -I -sS 'https://explorer.d-bis.org/transactions/0xd61be3f32beb7c18782a41cf38c1d7a2f4ac7585ec656d62b7bc58b4d0ac4ebe' + curl -fsS 'https://explorer.d-bis.org/token-aggregation/api/v1/tokens/0xc02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/pricing-context?chainId=138×tamp=2026-04-26T01:33:02.000Z' + curl -fsS 'https://explorer.d-bis.org/token-aggregation/api/v1/tokens/0x93E66202A11B1772E55407B32B44e5Cd8eda7f22/pricing-context?chainId=138×tamp=2026-04-26T01:33:02.000Z' + ssh root@192.168.11.12 "pct exec 5000 -- bash -lc 'systemctl is-active token-aggregation; systemctl is-active solacescanscout-frontend'" + ``` + +- [ ] Refresh parent submodule PR if any nested repo PR is amended before merge + ```bash + git -C /home/intlc/projects/proxmox checkout chore/explorer-pricing-rollout-coordination + git -C /home/intlc/projects/proxmox submodule update --remote explorer-monorepo smom-dbis-138 metamask-integration + git -C /home/intlc/projects/proxmox add explorer-monorepo smom-dbis-138 metamask-integration + git -C /home/intlc/projects/proxmox commit -m "chore(release): refresh nested repo revisions" + git -C /home/intlc/projects/proxmox push gitea HEAD:chore/explorer-pricing-rollout-coordination + ``` + +## Optional + +- [~] Add PR cross-links as comments + ```bash + curl -u 'USER:TOKEN' \ + -H 'Content-Type: application/json' \ + -X POST \ + 'https://gitea.d-bis.org/api/v1/repos/d-bis/explorer-monorepo/issues/15/comments' \ + -d '{"body":"Companion PRs: d-bis/smom-dbis-138#3, d-bis/metamask-integration#1, d-bis/proxmox#14"}' + ``` + +- [~] Apply labels, assignees, milestones, or rollout tracking metadata in Gitea UI + +- [~] Tag releases after merges + ```bash + git -C /home/intlc/projects/proxmox/explorer-monorepo tag explorer-pricing-rollout-2026-04-26 + git -C /home/intlc/projects/proxmox/explorer-monorepo push origin explorer-pricing-rollout-2026-04-26 + ``` + - Repeat similarly for other repos if desired. + +- [~] Update release docs with final merged PRs and SHAs + - [2026-04-25_EXPLORER_PRICING_COMMIT_PLAN.md](/home/intlc/projects/proxmox/reports/status/2026-04-25_EXPLORER_PRICING_COMMIT_PLAN.md) + - [2026-04-25_EXPLORER_PRICING_RELEASE_NOTES.md](/home/intlc/projects/proxmox/reports/status/2026-04-25_EXPLORER_PRICING_RELEASE_NOTES.md) + +- [~] Backfill deeper OHLCV history to reduce `locked: false` fallback cases + +- [~] Add broader automated smoke coverage + ```bash + cd /home/intlc/projects/proxmox/explorer-monorepo/frontend && npm run test:unit + cd /home/intlc/projects/proxmox/smom-dbis-138/services/token-aggregation && npm test + ``` + +- [~] Normalize local remotes in `metamask-integration` so `origin` also points to Gitea + ```bash + git -C /home/intlc/projects/proxmox/metamask-integration remote set-url origin https://gitea.d-bis.org/d-bis/metamask-integration.git + ``` + +- [~] Clean unrelated dirty workspace items after this release train + ```bash + git -C /home/intlc/projects/proxmox status --short + git -C /home/intlc/projects/proxmox/smom-dbis-138 status --short + ```