proxmox/docs/PLACEHOLDERS_AND_TBD.md

# Placeholders and TBD Items

**Last Updated:** 2026-01-31  
**Document Version:** 1.0  
**Status:** Active Documentation

---

Documented placeholders and TBD items in the codebase. Resolve or update when real values/APIs are available. **Not implemented (full scope):** [NOT_IMPLEMENTED_FULL_SCOPE](00-meta/NOT_IMPLEMENTED_FULL_SCOPE.md).

## AlltraAdapter — Bridge Fee

- **Location:** `smom-dbis-138/contracts/bridge/adapters/evm/AlltraAdapter.sol`
- **Status:** FIXED. `estimateFee()` now returns configurable `bridgeFee` (default 0.001 ALL). Use `setBridgeFee(uint256)` to update after deployment when ALL Mainnet fee structure is known. **Action:** After deploy, call `setBridgeFee(uint256)` with the agreed fee (confirm from network docs or ops). **When set:** Document the final value in this section (e.g. "Final fee: X wei as of YYYY-MM-DD").

## Smart Accounts Kit

- **Location:** `smom-dbis-138/script/smart-accounts/DeploySmartAccountsKit.s.sol`
- **Status:** UPDATED. Script reads `ENTRY_POINT`, `SMART_ACCOUNT_FACTORY`, `PAYMASTER` from env. Set these when contracts are deployed; otherwise deploy manually and add to .env.

## Quote Service — Fabric ChainId

- **Location:** `smom-dbis-138/orchestration/bridge/quote-service.ts`
- **Status:** FIXED. Uses `FABRIC_CHAIN_ID` env var when set; falls back to 999 for routing until Fabric is integrated. When Fabric is live, set `FABRIC_CHAIN_ID` in env to the real chain ID; remove or document default 999 in code.

## EnhancedSwapRouter / DODO

- **Location:** EnhancedSwapRouter and DODOPMMProvider in smom-dbis-138 / dbis_core.
- **Status:** When Uniswap V3 / Balancer pools exist on chain, set quoter/poolId (or call existing setters); remove or document “return 0” fallback. When DODO is integrated, implement oracle-driven `optimizePoolParameters` or document the flow in code.

## EnhancedSwapRouter / DODOPMMProvider

- **Location:** `smom-dbis-138/contracts/bridge/trustless/EnhancedSwapRouter.sol`, `smom-dbis-138/contracts/liquidity/providers/DODOPMMProvider.sol`
- **Status:** UPDATED. (1) EnhancedSwapRouter: `setUniswapQuoter(address)` added; `uniswapQuoter` used in _getUniswapV3Quote when set. Balancer: `getPoolTokens` + spot price in _getBalancerQuote when poolId configured. 1inch: clear revert message. (2) DODOPMMProvider: _createOptimalPool delegates to DODOPMMIntegration.createPool; optimizePoolParameters documented (oracle-driven). **Post-deploy config:** See [CONTRACT_DEPLOYMENT_RUNBOOK](03-deployment/CONTRACT_DEPLOYMENT_RUNBOOK.md) § EnhancedSwapRouter & DODOPMMProvider (setUniswapQuoter, setBalancerPoolId, setDodoPoolAddress, registerPool). DODOPMMIntegration now includes `createCUSDTCUSDCPool` and cUSDT↔cUSDC swaps per [VAULT_SYSTEM_MASTER_TECHNICAL_PLAN](VAULT_SYSTEM_MASTER_TECHNICAL_PLAN.md) §4.

## CMC / CoinGecko Chain Support

- **Location:** Token Aggregation adapters (`coingecko-adapter.ts`, `cmc-adapter.ts`)
- **Current:** ChainId 138 and 651940 are not supported by CoinGecko/CMC; adapters return null for those chains.
- **Action:** Report API still returns our token/pool data; external price/volume for our chains will be empty until platforms add support or another source is used.
- **Submission runbook:** [CMC_COINGECKO_SUBMISSION_RUNBOOK](04-configuration/coingecko/CMC_COINGECKO_SUBMISSION_RUNBOOK.md) — prerequisites, export from report API, step-by-step for Chain 138 and 651940, and where to update when done.

## WETH Bridges — Mainnet Receiver

- **Location:** `smom-dbis-138/script/deploy/bridge/DeployWETHBridges.s.sol`
- **Current:** `addDestination` is only called when `MAINNET_WETH9_BRIDGE_ADDRESS` and `MAINNET_WETH10_BRIDGE_ADDRESS` are set in env.
- **Action:** Set these env vars to the deployed WETH9/WETH10 bridge addresses on mainnet when configuring cross-chain destinations.

## Tezos Relay / Mint (multi-chain-execution)

- **Location:** `multi-chain-execution` (Chain138→Tezos USDtz route planning, `adapter-tezos.ts`)
- **Current:** TezosChainAdapter supports read operations and transaction injection via TzKT/RPC. There is no dedicated "TezosRelayService" for native Tezos mint/transfer; route planning and execution use the adapter.
- **Action:** When native Tezos mint/transfer relay is implemented, add a service and document here. Until then, treat as documented mock path via adapter.

## dbis_core — Prometheus / Redis / PagerDuty / AS4

- **Location:** `dbis_core` (arbitrage metrics, cache, alert.service, as4-metrics, IRU monitoring)
- **Current:** TODOs in code: Prometheus integration when monitoring stack is deployed; Redis client optional (caching disabled if not set); PagerDuty alert channel stub (log only); AS4 Redis health in metrics. Docs and config exist: `DEPLOYMENT_PLAN.md`, `monitoring/prometheus-as4.yml`, `as4-alerts.yml`, AS4 setup guides.
- **Action:** Implement Redis client, Prometheus push/scrape, and PagerDuty API when ops stack is deployed. See `docs/settlement/as4/` and `COMPLETE_TASK_LIST.md` for Redis/Prometheus tasks.

## OMNIS — Sankofa Phoenix SDK

- **Location:** `OMNIS/` (Sankofa/Phoenix migration; see `docs/migration/MIGRATION_TO_SANKOFA_PHOENIX.md`, `SANKOFA_PHOENIX_MIGRATION_STATUS.md`)
- **Current:** Migration from Azure to Sankofa/Phoenix documented. Sankofa Phoenix SDK (or equivalent) integration is a dependency for full feature parity.
- **Action:** Integrate Sankofa Phoenix SDK when available, or document dependency and timeline in OMNIS docs/implementation roadmap.

## Token mapping (138↔Mainnet)

- **Location:** [config/token-mapping.json](../config/token-mapping.json), [07-ccip/TOKEN_MAPPING_AND_MAINNET_ADDRESSES.md](07-ccip/TOKEN_MAPPING_AND_MAINNET_ADDRESSES.md)
- **Status:** DONE. Single source of truth in config/token-mapping.json; relay service and CI use it; runbook for adding LINK support. When adding a new token, update token-mapping.json and optionally [CHAIN138_TOKEN_ADDRESSES](11-references/CHAIN138_TOKEN_ADDRESSES.md).

## the-order — Legal Documents (court e-filing, e-signature, document-security)

- **Location:** `the-order/services/legal-documents/src/services/` — `court-efiling.ts`, `e-signature.ts`, `document-security.ts`
- **Current:** Placeholder implementations with TODOs: court e-filing (integrate with actual system), e-signature (DocuSign/Adobe Sign or similar), document-security (fetch PDF, watermark/redact, re-upload).
- **Action:** Implement or document vendor/roadmap. See [GAPS_AND_RECOMMENDATIONS_CONSOLIDATED.md](GAPS_AND_RECOMMENDATIONS_CONSOLIDATED.md) and [PLACEHOLDER_IMPLEMENTATIONS.md](11-references/PLACEHOLDER_IMPLEMENTATIONS.md).