proxmox/docs/00-meta/NOT_IMPLEMENTED_FULL_SCOPE.md

Not Implemented — Full Scope Reference

Purpose: Single entry point for "what is not implemented and what is the full scope."
Related: VAULT_SYSTEM_MASTER_TECHNICAL_PLAN, Phases 2–6; design plan (Cursor plan: not_implemented_full_scope_design).

---

1. CMC / CoinGecko submission

Design summary: No code change. Process: prepare payload from report API or existing package → submit via CoinGecko/CMC forms or partner API when available. Single canonical runbook ties prerequisites, step-by-step for Chain 138 then 651940, CMC in parallel, and "where to update when done."

Deliverable	Path / description
Runbook	CMC_COINGECKO_SUBMISSION_RUNBOOK — prerequisites, export from report API, CoinGecko/CMC submission, when-done updates
Cross-references	REQUIRED_FIXES_UPDATES_GAPS §9, PLACEHOLDERS_AND_TBD CMC/CoinGecko → link to runbook

Dependencies: None. Can be done anytime.

---

2. Private XAU-anchored pools (Phase 2) and Stabilizer + executePrivateSwap (Phase 3)

Design summary:

• Phase 2: N pools (cUSDT↔XAU, cUSDC↔XAU, cEURT↔XAU); "private" = only Stabilizer/whitelisted keeper may execute swaps; liquidity provision optionally restricted. Option A: PrivatePoolRegistry records which pool IDs are private and restricts executePrivateSwap to those pools.
• Phase 3: Stabilizer contract implements Appendix A of VAULT_SYSTEM_MASTER_TECHNICAL_PLAN: checkDeviation(), executePrivateSwap() with block delay, per-block cap, slippage, gas check; routes via PrivatePoolRegistry / DODOPMMIntegration.
• Phase 6: Flash containment in same Stabilizer: TWAP source, sustained N-block deviation, per-block volume cap, recovery <3 blocks.

Phase	Deliverable	Path / description
2	PrivatePoolRegistry.sol	smom-dbis-138/contracts/ — register (tokenA, tokenB, poolAddress), getPrivatePool(tokenIn, tokenOut), optional LP role
2	Deploy script + runbook	Script: create XAU-anchored pools via DODOPMMIntegration.createPool, register in PrivatePoolRegistry. Runbook: "Private stabilization pools (Phase 2)" with XAU_ADDRESS_138, cEURT_ADDRESS_138
3	Stabilizer.sol	checkDeviation (peg manager + sustained N-block), executePrivateSwap (block delay, cap, slippage, gas), routing to PrivatePoolRegistry; STABILIZER_KEEPER_ROLE, ADMIN
3	Tests	Unit tests: checkDeviation below/above threshold, sustained vs single-block; executePrivateSwap reverts (delay, cap, slippage)
3	Runbook	"Stabilizer deployment and configuration" — thresholdBps, minBlocksBetweenExecution, maxStabilizationVolumePerBlock, maxSlippageBps, maxGasPriceForStabilizer; grant STABILIZER_KEEPER_ROLE
6	Flash containment	In Stabilizer: TWAP source, sustainedDeviationBlocks, per-block cap; document "flash drain recovery <3 blocks" in runbook

Dependencies: Phase 2 before Phase 3 (Stabilizer needs private pools). Phase 6 extends Phase 3 (same contract).

---

3. Cross-chain arbitrage (Phase 4)

Design summary: Off-chain bot recommended: poll price on Chain 138 and 651940 (report API or RPC + DEX), if |Price138 − Price651940| > ArbitrageThreshold then execute (bridge + swap via AlltraAdapter/AlltraCustomBridge). Optional on-chain: contract emitting CrossChainDeviation for bot to listen. Bridge buffer: BridgeReserve ≥ PeakBridgeOutflow × Latency (runbook + optional alert).

Deliverable	Path / description
Design doc	CROSS_CHAIN_ARBITRAGE_DESIGN — architecture, data flow, env (RPC_URL_138, RPC_URL_651940, AlltraAdapter, ArbitrageThreshold), failure modes, bridge buffer formula
Bot skeleton (optional)	TypeScript/Node in smom-dbis-138/services/ or dbis_core — config, loop: fetch prices → deviation → if over threshold call AlltraAdapter + swap on destination
Runbook section	"Cross-chain parity and bridge buffer" in OPERATIONS_RUNBOOK: BridgeReserve ≥ PeakBridgeOutflow × Latency; measure peak outflow and latency; alert when reserve below

Dependencies: AlltraAdapter/AlltraCustomBridge deployed; report API or price source on both chains.

---

4. Full on-chain flash containment (Phase 6)

Design summary: Implement inside Stabilizer (Phase 3 contract): (1) TWAP from DODO pool or external oracle; (2) sustained deviation via circular buffer (last N blocks all > thresholdBps); (3) per-block volume cap; (4) document "flash drain recovery <3 blocks" and optional cooldown after large deviation.

Deliverable	Path / description
Implementation	Same as Phase 3 Stabilizer + extension: TWAP source, sustained-deviation buffer, per-block cap in Stabilizer (when implemented)
Runbook / Master Plan	OPERATIONS_RUNBOOK, VAULT_SYSTEM_MASTER_TECHNICAL_PLAN §8/§16 — recovery target, Flash Loan Containment Checklist

Dependencies: Phase 3 Stabilizer implemented first.

---

5. GAPS and other projects (Sankofa, the-order, dbis_core, network placeholders)

Design summary: Per-area checklists and specs; no new code in this plan except docs. Replace TBDs with real IPs/ports when deployed; document SDK/legal/vendor options and "when to implement" for Redis/Prometheus/PagerDuty; reserve or assign network blocks #2–#6.

Area	Deliverables
Sankofa / The Order	Checklist: replace <TARGET_IP>/<TARGET_PORT>; update ALL_VMIDS_ENDPOINTS, RPC_ENDPOINTS_MASTER; NPMplus proxy for the-order.sankofa.nexus; "where to update when done" (PLACEHOLDERS_AND_TBD, REMAINING_COMPONENTS). See SANKOFA_THE_ORDER_CHECKLIST or SANKOFA_CUTOVER_PLAN.
OMNIS — Sankofa Phoenix SDK	Integration spec: required SDK interface (getAuthUrl, validateToken, getUserInfo), env vars, fallback. See OMNIS_SANKOFA_PHOENIX_SDK_INTEGRATION_SPEC. Dependency note in PLACEHOLDERS_AND_TBD / PLACEHOLDERS_AND_COMPLETION_MASTER_LIST: "Blocked on Sankofa Phoenix SDK availability."
the-order — legal-documents	Vendor/implementation matrix (court-efiling, e-signature, document-security): Option, Prerequisites, Steps, "Where to update when done." See LEGAL_DOCUMENTS_IMPLEMENTATION. Update GAPS_AND_RECOMMENDATIONS_CONSOLIDATED, PLACEHOLDERS_AND_COMPLETION_MASTER_LIST when done.
dbis_core	Runbook or comment "When to implement": Prometheus when monitoring stack is up; Redis when caching needed. See DBIS_CORE_WHEN_TO_IMPLEMENT. No new code; doc/checklist only.
Network placeholders	Blocks #2–#6: decision "Reserved" or assign; doc update in NETWORK_ARCHITECTURE / NETWORK_CONFIGURATION_MASTER. See NETWORK_PLACEHOLDERS_DECISION; "where to update when done" in REMAINING_COMPONENTS.

Dependencies: None for documentation; implementation depends on each project’s timeline.

---

6. Dependency and execution order

• No dependencies (can do in parallel): CMC/CoinGecko runbook; NOT_IMPLEMENTED_FULL_SCOPE (this doc); GAPS per-area checklists; Cross-chain arbitrage design + optional bot.
• Phase 2 → Phase 3: PrivatePoolRegistry + private pool deploy/runbook before Stabilizer.
• Phase 3 → Phase 6: Stabilizer implementation before flash containment extension.

---

7. Summary table

Item	Primary deliverable	Type
CMC/CoinGecko	CMC_COINGECKO_SUBMISSION_RUNBOOK.md	Doc (process)
Private XAU pools	PrivatePoolRegistry.sol + deploy/runbook	Contract + doc
Stabilizer + executePrivateSwap	Stabilizer.sol + tests + runbook	Contract + tests + doc
Flash containment	Stabilizer extension + runbook	Contract + doc
Cross-chain arbitrage	CROSS_CHAIN_ARBITRAGE_DESIGN.md + optional bot	Doc + optional code
GAPS / other	NOT_IMPLEMENTED_FULL_SCOPE.md (this doc) + per-area checklists/specs	Doc

All deliverables are scoped so implementation can proceed without ambiguity.