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.

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 § EnhancedSwapRouter & DODOPMMProvider (setUniswapQuoter, setBalancerPoolId, setDodoPoolAddress, registerPool). DODOPMMIntegration now includes createCUSDTCUSDCPool and cUSDT↔cUSDC swaps per VAULT_SYSTEM_MASTER_TECHNICAL_PLAN §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 — 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, 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.

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 and PLACEHOLDER_IMPLEMENTATIONS.md.