docs(release): cross-link pricing rollout checklist and notes

2026-04-26 00:03:48 -07:00
parent 240fec0c8e
commit 207f088b39
2 changed files with 170 additions and 0 deletions
--- 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
--- a/reports/status/2026-04-26_EXPLORER_PRICING_EXECUTION_CHECKLIST.md
+++ 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&timestamp=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&timestamp=2026-04-26T01:33:02.000Z'
+  curl -fsS 'https://explorer.d-bis.org/token-aggregation/api/v1/tokens/0x93E66202A11B1772E55407B32B44e5Cd8eda7f22/pricing-context?chainId=138&timestamp=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
+  ```