From 70a6d66e4dd8ae252b82f58a539f2290f4375f00 Mon Sep 17 00:00:00 2001 From: defiQUG Date: Fri, 27 Mar 2026 15:40:45 -0700 Subject: [PATCH] docs(stage2): mark R21 / Sankofa cutover done across 00-meta checklists MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - REMAINING_TASKS_BREAKDOWN_MISSING_INFO §2 + step 4 - REMAINING_WORK_BREAKDOWN_AND_ANSWERS Sankofa Q&A + one-line summary - REMAINING_COMPONENTS R21; operator-only + improvements + checklists Made-with: Cursor --- .../ALL_RECOMMENDATIONS_AND_IMPROVEMENTS_LIST.md | 6 +++--- docs/00-meta/ALL_RECOMMENDATIONS_OPERATOR_ONLY.md | 4 ++-- .../OPERATOR_AND_EXTERNAL_COMPLETION_CHECKLIST.md | 4 ++-- docs/00-meta/RECOMMENDATIONS_OPERATOR_CHECKLIST.md | 2 +- ...REMAINING_COMPONENTS_TASKS_AND_RECOMMENDATIONS.md | 2 +- .../REMAINING_TASKS_BREAKDOWN_MISSING_INFO.md | 11 +++++------ docs/00-meta/REMAINING_WORK_BREAKDOWN_AND_ANSWERS.md | 12 ++++++------ 7 files changed, 20 insertions(+), 21 deletions(-) diff --git a/docs/00-meta/ALL_RECOMMENDATIONS_AND_IMPROVEMENTS_LIST.md b/docs/00-meta/ALL_RECOMMENDATIONS_AND_IMPROVEMENTS_LIST.md index 679d286..903633f 100644 --- a/docs/00-meta/ALL_RECOMMENDATIONS_AND_IMPROVEMENTS_LIST.md +++ b/docs/00-meta/ALL_RECOMMENDATIONS_AND_IMPROVEMENTS_LIST.md @@ -270,7 +270,7 @@ | R18 | Ensure Blockscout (VMID 5000) is up and /api reachable | Health checks | | R19 | Run forge test before deploying; integration tests where available | Pre-deploy | | R20 | NatSpec on public contract functions | Code quality | -| R21 | When The Order deployed: NPMplus proxy host; document in RPC_ENDPOINTS_MASTER | Sankofa/The Order go-live | +| R21 | **Done 2026-03:** NPMplus Order via 10210; documented in RPC_ENDPOINTS_MASTER, ALL_VMIDS | Complete | | R22 | Document or configure blocks #2–#6 in NETWORK_ARCHITECTURE | When decided | | R23 | Scripts: progress indicators; --dry-run; config validation | Script updates | | R24 | Keep config/token-mapping.json as single source of truth for 138↔Mainnet | Adding tokens | @@ -299,8 +299,8 @@ | Item | Recommendation | |------|----------------| -| the-order.sankofa.nexus | When The Order portal deployed: add NPMplus proxy host; document in RPC_ENDPOINTS_MASTER, ALL_VMIDS_ENDPOINTS | -| Sankofa cutover plan | Replace <TARGET_IP>, <TARGET_PORT>, TBDs with actual IPs/ports when deployed | +| the-order.sankofa.nexus | **Live:** NPM → `192.168.11.39:80` (10210 → portal :3000) | +| Sankofa cutover plan | **Updated** v1.1 (2026-03-27); legacy API snippets may still use <TARGET_*> | | sankofa.nexus / phoenix routing | Ensure NPMplus proxy targets 192.168.11.51:3000 and 192.168.11.50:4000 per master docs; only explorer.d-bis.org → 192.168.11.140 | | Public blocks #2–#6 | Document in NETWORK_ARCHITECTURE / NETWORK_CONFIGURATION_MASTER when assigned or mark reserved | diff --git a/docs/00-meta/ALL_RECOMMENDATIONS_OPERATOR_ONLY.md b/docs/00-meta/ALL_RECOMMENDATIONS_OPERATOR_ONLY.md index b1aad39..e668336 100644 --- a/docs/00-meta/ALL_RECOMMENDATIONS_OPERATOR_ONLY.md +++ b/docs/00-meta/ALL_RECOMMENDATIONS_OPERATOR_ONLY.md @@ -96,9 +96,9 @@ | # | Action | When | |---|--------|------| -| R21 | The Order / Sankofa NPMplus proxy host | When The Order portal deployed: add proxy; document in RPC_ENDPOINTS_MASTER, ALL_VMIDS_ENDPOINTS | +| R21 | The Order / Sankofa NPMplus | **Done 2026-03** — Order → 10210 `.39:80`; see ALL_VMIDS, RPC_ENDPOINTS_MASTER | | R22 | Document or configure blocks #2–#6 in NETWORK_ARCHITECTURE | When decided | -| Sankofa cutover | Replace <TARGET_IP>, <TARGET_PORT>, TBDs in SANKOFA_CUTOVER_PLAN | When deployed | +| Sankofa cutover | **Done** — SANKOFA_CUTOVER_PLAN v1.1; fleet script `update-npmplus-proxy-hosts-api.sh` | | 75–81 | VLAN enablement, observability stack, CCIP fleet, sovereign tenants, missing containers | Per NEXT_STEPS_MASTER and deployment phases | --- diff --git a/docs/00-meta/OPERATOR_AND_EXTERNAL_COMPLETION_CHECKLIST.md b/docs/00-meta/OPERATOR_AND_EXTERNAL_COMPLETION_CHECKLIST.md index bd4236f..6506539 100644 --- a/docs/00-meta/OPERATOR_AND_EXTERNAL_COMPLETION_CHECKLIST.md +++ b/docs/00-meta/OPERATOR_AND_EXTERNAL_COMPLETION_CHECKLIST.md @@ -39,8 +39,8 @@ Use this checklist when you have operator or LAN access to complete the remainin | # | Action | Notes | |---|--------|-------| -| R21 | The Order / Sankofa NPMplus proxy host | When The Order portal deployed: add proxy in NPMplus; document in RPC_ENDPOINTS_MASTER, ALL_VMIDS_ENDPOINTS | -| Sankofa cutover | Replace <TARGET_IP>, <TARGET_PORT>, TBDs in SANKOFA_CUTOVER_PLAN with actual values | +| R21 | The Order / Sankofa NPMplus | **Done 2026-03** — see ALL_VMIDS, RPC_ENDPOINTS_MASTER, `update-npmplus-proxy-hosts-api.sh` | +| Sankofa cutover | **Done** — SANKOFA_CUTOVER_PLAN v1.1 | | Blocks #2–#6 | Document in NETWORK_ARCHITECTURE / NETWORK_CONFIGURATION_MASTER when assigned or mark reserved | | 75–81 | VLAN enablement, observability stack, CCIP fleet, sovereign tenants, missing containers | Per NEXT_STEPS_MASTER and deployment phases | diff --git a/docs/00-meta/RECOMMENDATIONS_OPERATOR_CHECKLIST.md b/docs/00-meta/RECOMMENDATIONS_OPERATOR_CHECKLIST.md index 804030d..063206c 100644 --- a/docs/00-meta/RECOMMENDATIONS_OPERATOR_CHECKLIST.md +++ b/docs/00-meta/RECOMMENDATIONS_OPERATOR_CHECKLIST.md @@ -65,7 +65,7 @@ | # | Action | When | |---|--------|------| -| R21 | When The Order is deployed: NPMplus proxy host; document in RPC_ENDPOINTS_MASTER and ALL_VMIDS_ENDPOINTS; replace SANKOFA_CUTOVER_PLAN TBDs | Sankofa/The Order go-live | +| R21 | **Done 2026-03:** NPMplus + ALL_VMIDS + RPC_ENDPOINTS_MASTER + SANKOFA_CUTOVER_PLAN v1.1 | Complete | | R22 | Document or configure blocks #2–#6 in NETWORK_ARCHITECTURE and NETWORK_CONFIGURATION_MASTER (or mark reserved); see NETWORK_PLACEHOLDERS_DECISION | When decided | ## Quick wins (R23) diff --git a/docs/00-meta/REMAINING_COMPONENTS_TASKS_AND_RECOMMENDATIONS.md b/docs/00-meta/REMAINING_COMPONENTS_TASKS_AND_RECOMMENDATIONS.md index ec874a2..35bc0f6 100644 --- a/docs/00-meta/REMAINING_COMPONENTS_TASKS_AND_RECOMMENDATIONS.md +++ b/docs/00-meta/REMAINING_COMPONENTS_TASKS_AND_RECOMMENDATIONS.md @@ -166,7 +166,7 @@ See **Part 2** and [GAPS_AND_RECOMMENDATIONS_CONSOLIDATED](../GAPS_AND_RECOMMEND | # | Recommendation | Action | |---|----------------|--------| -| R21 | **Sankofa / The Order** | When The Order portal is deployed, add NPMplus proxy host and document in RPC_ENDPOINTS_MASTER and ALL_VMIDS_ENDPOINTS; replace SANKOFA_CUTOVER_PLAN TBDs with actual IPs/ports. | +| R21 | **Sankofa / The Order** | **Done 2026-03:** NPMplus + docs (ALL_VMIDS, RPC_ENDPOINTS_MASTER, SANKOFA_CUTOVER_PLAN v1.1). HAProxy: `provision-order-haproxy-10210.sh`. | | R22 | **Network placeholders** | Document or configure blocks #2–#6 in NETWORK_ARCHITECTURE and NETWORK_CONFIGURATION_MASTER when assigned. | ### 2.9 Quick wins (code) diff --git a/docs/00-meta/REMAINING_TASKS_BREAKDOWN_MISSING_INFO.md b/docs/00-meta/REMAINING_TASKS_BREAKDOWN_MISSING_INFO.md index d472760..15649be 100644 --- a/docs/00-meta/REMAINING_TASKS_BREAKDOWN_MISSING_INFO.md +++ b/docs/00-meta/REMAINING_TASKS_BREAKDOWN_MISSING_INFO.md @@ -108,13 +108,12 @@ --- -## 2. Sankofa cutover (missing TBDs) +## 2. Sankofa cutover (**documented — 2026-03**) | | Detail | |---|--------| -| **Needed** | For each Sankofa domain: target VMID, target IP, target port, service type. | -| **Missing** | **the-order.sankofa.nexus:** VMID, IP, port, service type still **TBD** in [SANKOFA_CUTOVER_PLAN.md](../04-configuration/SANKOFA_CUTOVER_PLAN.md). Other four domains have values (e.g. 7801/192.168.11.51/3000 for sankofa.nexus). | -| **Where to get** | Deploy The Order portal; assign VMID and IP; document in SANKOFA_CUTOVER_PLAN.md table; then run cutover steps (replace proxy backends in NPMplus). | +| **Status** | Live backends in [SANKOFA_CUTOVER_PLAN.md](../04-configuration/SANKOFA_CUTOVER_PLAN.md) v1.1, [ALL_VMIDS_ENDPOINTS.md](../04-configuration/ALL_VMIDS_ENDPOINTS.md), [RPC_ENDPOINTS_MASTER.md](../04-configuration/RPC_ENDPOINTS_MASTER.md). The Order: NPM → **10210** `192.168.11.39:80` → portal **192.168.11.51:3000**. | +| **Ongoing** | If IPs/VMIDs change, run `scripts/nginx-proxy-manager/update-npmplus-proxy-hosts-api.sh` and update the master docs. | --- @@ -227,8 +226,8 @@ - Run `address-all-remaining-502s.sh --run-besu-fix --e2e` from LAN. - Run Blockscout verification script. -4. **Fill TBDs** - - Sankofa: set the-order.sankofa.nexus target (VMID, IP, port) in SANKOFA_CUTOVER_PLAN.md. +4. **Sankofa / Order** + - **Done:** targets documented; refresh NPM with `update-npmplus-proxy-hosts-api.sh` after infra changes. - CCIP: collect per-chain addresses (CCIP directory) and fund deployer wallets for Gnosis/Celo/Wemix. 5. **dbis_core** diff --git a/docs/00-meta/REMAINING_WORK_BREAKDOWN_AND_ANSWERS.md b/docs/00-meta/REMAINING_WORK_BREAKDOWN_AND_ANSWERS.md index 5092440..46b6213 100644 --- a/docs/00-meta/REMAINING_WORK_BREAKDOWN_AND_ANSWERS.md +++ b/docs/00-meta/REMAINING_WORK_BREAKDOWN_AND_ANSWERS.md @@ -78,11 +78,11 @@ | Question | Answer | |----------|--------| -| **What is it?** | Sankofa and The Order services deployed; DNS and NPMplus point to real IPs/ports; replace TBDs in docs. | -| **Prerequisites** | Sankofa and The Order deployed; IPs and ports known (e.g. sankofa 192.168.11.51:3000 VMID 7801, phoenix 192.168.11.50:4000 VMID 7800 — already in docs). | -| **Who** | Ops when services are live. | -| **Steps to complete** | 1. Deploy Sankofa/The Order per your deployment process. 2. In [SANKOFA_CUTOVER_PLAN](../04-configuration/SANKOFA_CUTOVER_PLAN.md): replace ``, ``, table TBDs with actual IPs/ports. 3. In NPMplus: ensure proxy hosts for sankofa.nexus and phoenix.sankofa.nexus point to 192.168.11.51:3000 and 192.168.11.50:4000 (not .140). 4. When The Order portal is deployed: add NPMplus proxy for the-order.sankofa.nexus; document in [RPC_ENDPOINTS_MASTER](../04-configuration/RPC_ENDPOINTS_MASTER.md) and [ALL_VMIDS_ENDPOINTS](../04-configuration/ALL_VMIDS_ENDPOINTS.md). | -| **Where to update when done** | [PLACEHOLDERS](PLACEHOLDERS_AND_COMPLETION_MASTER_LIST.md) §2; [GAPS](../GAPS_AND_RECOMMENDATIONS_CONSOLIDATED.md) §2.1–2.2; [REMAINING](REMAINING_COMPONENTS_TASKS_AND_RECOMMENDATIONS.md) R21. | +| **What is it?** | Sankofa zone on production backends; NPMplus and master docs aligned (incl. The Order via **10210** HAProxy). | +| **Prerequisites** | LAN + `NPM_PASSWORD` for fleet updater; portal 7801 and Phoenix 7800 healthy. | +| **Who** | Ops for NPM refresh after any VM/IP change. | +| **Steps to complete** | **Done 2026-03:** See [SANKOFA_CUTOVER_PLAN](../04-configuration/SANKOFA_CUTOVER_PLAN.md) v1.1. Maintain with `scripts/nginx-proxy-manager/update-npmplus-proxy-hosts-api.sh`. Bypass Order HAProxy if needed: `THE_ORDER_UPSTREAM_IP=192.168.11.51 THE_ORDER_UPSTREAM_PORT=3000`. | +| **Where to update when done** | [PLACEHOLDERS](PLACEHOLDERS_AND_COMPLETION_MASTER_LIST.md) §2; [GAPS](../GAPS_AND_RECOMMENDATIONS_CONSOLIDATED.md) §2.1–2.2; R21 marked **done** in [REMAINING_COMPONENTS](REMAINING_COMPONENTS_TASKS_AND_RECOMMENDATIONS.md). | --- @@ -295,7 +295,7 @@ | Trust official | Open PR to trustwallet/wallet-core with registry entry (coinId 10000138, chainId 138); run codegen/tests. | | CoinGecko/CMC | Submit chain + tokens via CoinGecko (and CMC) process; use COINGECKO_SUBMISSION_GUIDE and token docs. | | Consensys | Use CONSENSYS_OUTREACH_PACKAGE; contact Consensys for Swaps/Bridge support for 138. | -| Sankofa cutover | When deployed: replace TBDs in SANKOFA_CUTOVER_PLAN; set NPMplus proxies to .51/.50; add the-order when live. | +| Sankofa cutover | **Done:** v1.1 cutover plan + NPM; Order via .39:80 (10210). Re-run updater after changes. | | Blockscout verify | From LAN: `source smom-dbis-138/.env; ./scripts/verify/run-contract-verification-with-proxy.sh`. | | Multicall vs Oracle | Check explorer for 0x99b35...; document which contract it is in CONTRACT_ADDRESSES_REFERENCE. | | AlltraAdapter fee | After deploy: call `setBridgeFee(fee_wei)`; set ALLTRA_BRIDGE_FEE in .env; document in PLACEHOLDERS_AND_TBD. |