Files

defiQUG 21c839b9b5 docs(stage1): GAPS + placeholders master — The Order / cutover live

- GAPS §2.1: replace TBD table with 2026-03 live routing + cutover v1.1 note
- PLACEHOLDERS: Sankofa cutover row matches SANKOFA_CUTOVER_PLAN v1.1

Made-with: Cursor

2026-03-27 15:38:40 -07:00

5.1 KiB

Raw Blame History

Gaps, Placeholders, and Recommendations — Consolidated

Last Updated: 2026-03-27
Purpose: Single reference for all identified gaps, placeholders, and actionable recommendations across the repository.

Updates (2026-03-27): Sankofa / The Order NPM routing documented as live (NPM → 10210 192.168.11.39:80 → portal :3000). See ALL_VMIDS_ENDPOINTS.md, SANKOFA_CUTOVER_PLAN.md v1.1. Section 2.1 below updated accordingly.

Updates (2026-03-02): All in-repo actionable gaps from REQUIRED_FIXES (§§1–6), DETAILED_GAPS, and VERIFICATION_GAPS addressed or documented. See 00-meta/GAPS_STATUS.md. Fixes: verify-all-systems Explorer/Wallet timeout 25s; nginx order documented; runbook .env production note added.

Updates (2026-02-05): API keys in token-aggregation and root .env.example replaced with placeholders. docs/TODO.md and smom-dbis-138/docs/TODO.md created; smom-dbis-138 status-report links to ../tasks/TODO.md fixed. RPC_ENDPOINTS_MASTER Sankofa section updated (sankofa.nexus → 7801/.51:3000, phoenix → 7800/.50:4000; the-order TBD). dbis_core nostro-vostro emergency hotline and example URLs set to "To be configured".

1. Security and secrets

1.1 API keys and secrets in `.env.example` (high)

Location	Issue	Recommendation
`smom-dbis-138/services/token-aggregation/.env.example`	Done. Uses placeholders `your-coingecko-api-key`, `your-coinmarketcap-api-key`.	Rotate keys if they were ever committed or shared.
`.env.example` (root)	Done. Uses placeholder `your-coingecko-api-key`.	—

1.2 Other secret placeholders

Root .env.example: Documents PRIVATE_KEY, JWT_SECRET, NPM_PASSWORD, Cloudflare, AWS, etc. with your-* placeholders — good. Ensure no real values are committed.
OMNIS/backend, dbis_core, the-order: Use your-* or empty; keep examples placeholder-only and document in MASTER_SECRETS_INVENTORY.md or API_KEYS_REQUIRED.md.

2. Configuration and DNS placeholders

2.1 Sankofa / The Order (routing — done 2026-03)

Item	Location	Status / recommendation
`the-order.sankofa.nexus` (+ `www`)	ALL_VMIDS_ENDPOINTS.md, RPC_ENDPOINTS_MASTER.md	Live: NPM → `192.168.11.39:80` (VMID 10210 HAProxy) → `192.168.11.51:3000`. Provision: `scripts/deployment/provision-order-haproxy-10210.sh`.
Sankofa cutover plan	SANKOFA_CUTOVER_PLAN.md	Updated v1.1 (2026-03-27): live backend tables + historical procedure. Replace any remaining `<TARGET_*>` in copy-paste API examples if you reuse them for new hosts.

2.2 sankofa.nexus / phoenix.sankofa.nexus routing (authoritative)

Master docs (source of truth): ALL_VMIDS_ENDPOINTS.md, RPC_ENDPOINTS_MASTER.md, DNS_NPMPLUS_VM_COMPREHENSIVE_ARCHITECTURE.md. Correct targets: sankofa.nexus / www.sankofa.nexus → 192.168.11.51:3000 (VMID 7801); phoenix.sankofa.nexus / www.phoenix.sankofa.nexus → 192.168.11.50:4000 (VMID 7800). Only explorer.d-bis.org should point to 192.168.11.140 (Blockscout). If NPMplus proxy hosts for Sankofa/Phoenix still point to .140, update them to the correct IP:port per the master docs.

2.3 Network / architecture placeholders

Item	Location	Recommendation
Public blocks #2–#6	NETWORK_ARCHITECTURE.md	"Placeholders - To Be Configured". Document when blocks are assigned or mark as reserved.
Blocks #2–#6	NETWORK_CONFIGURATION_MASTER.md	"To be configured". Same as above.

2.4 Token mapping (138↔Mainnet) — Done 2026-02-13

Item	Location	Status
Token mapping source of truth	config/token-mapping.json	Done. Single source of truth; relay and CI use it. When adding a token, update this file and optionally CHAIN138_TOKEN_ADDRESSES. See TOKEN_MAPPING_AND_MAINNET_ADDRESSES.

5.1 KiB Raw Blame History Unescape Escape