dd02f4b59b
All checks were successful
Deploy to Phoenix / validate (push) Successful in 1m11s
Deploy to Phoenix / deploy (push) Successful in 43s
Deploy to Phoenix / deploy-atomic-swap-dapp (push) Successful in 1m32s
phoenix-deploy Deployed to cloudflare-sync
Deploy to Phoenix / cloudflare (push) Successful in 38s
34 KiB
34 KiB
Documentation — Master Index
Last Updated: 2026-05-07 Purpose: Single entry point for all project documentation. Use this index to find canonical sources and avoid deprecated or duplicate content.
Status: Live check 2026-04-29 (~10:50 UTC): Core RPC 138 OK, 61/61 on-chain, run-all-validation.sh --skip-genesis OK, E2E routing --profile=all 49 domains / 0 failed, operator+Blockscout batch OK — log logs/next-steps-complete-20260429T062049Z.log, snapshot reports/status/live-network-check-latest.json. CCIP: Chain 138 WETH9/WETH10 bridges were topped up with +10 LINK each; a real sendCrossChain 0.0001 WETH proof completed Chain 138 -> Ethereum Mainnet and the destination bridge processed message 0xcbf278baaa0da8a65c2a9ce87be7a3680b8b04596a7ee933f2494399b34a13e7. Destination-chain LINK/gas top-ups remain capital-gated. Preflight and Chain 138 next steps completed (61/61); 12 c* GRU-registered. Token-aggregation: public report API is live and publication exports are regenerated. 2026-03-06: Contract check list expanded (PMM, vault/reserve, CompliantFiatTokens). 2026-03-04: Celo CCIP bridges deployed; Phase A–D tracked in 03-deployment/REMAINING_DEPLOYMENTS_FOR_FULL_NETWORK_COVERAGE.md. Phase C: PHASE_C_CW_AND_EDGE_POOLS_RUNBOOK.md; Phase D: PHASE_D_OPTIONAL_CHECKLIST.md. On-chain verification: DODOPMMIntegration canonical cUSDT/cUSDC — EXPLORER_TOKEN_LIST_CROSSCHECK §8. Remaining: B.1/B.2 gas (CRO/WEMIX plus low BSC/Optimism/Arbitrum/Base gas), destination-chain LINK, external listings, Phase C/D optional — see 00-meta/TODOS_CONSOLIDATED.md and 00-meta/NEXT_STEPS_INDEX.md.
Continue and complete (operator/LAN): (1) ./scripts/run-completable-tasks-from-anywhere.sh then (2) ./scripts/run-all-operator-tasks-from-lan.sh (use --skip-backup if NPM_PASSWORD not set; add --deploy or --create-vms as needed). Operator scripts load dotenv from repo .env and smom-dbis-138/.env automatically.
Start here
| Purpose | Document |
|---|---|
| Agent / IDE instructions | AGENTS.md (repo root) |
| Canonical ecosystem root plan | 02-architecture/DBIS_ECOSYSTEM_TECHNICAL_MASTER_PLAN.md — umbrella technical master plan for the full live and planned ecosystem; subordinate roots: Chain 138 infra/runtime, RTGS execution, and URA control-plane trackers |
| Government treasury, EMI, wallet, virtual account master plan | 02-architecture/GOVERNMENT_TREASURY_EMI_WALLET_MASTER_PLAN.md — regulated fiat/e-money vs Chain 138 authorization; EMIs, VAs, Tatum-style patterns; RTGS/URA/Rail alignment and phased gates |
| Git submodule hygiene + explorer remotes | 00-meta/SUBMODULE_HYGIENE.md — detached HEAD, push order, Gitea/GitHub, submodules-clean.sh |
| Atomic swap dApp submodule | 03-deployment/ATOMIC_SWAP_DAPP_SUBMODULE.md — dedicated swap + bridge dApp repo, manifest sync, and bootstrap-remote note |
| What to do next | 00-meta/NEXT_STEPS_INDEX.md — ordered actions, by audience, execution plan |
| Your personal checklist | 00-meta/NEXT_STEPS_FOR_YOU.md |
| Operator runbook (LAN/creds) | 00-meta/NEXT_STEPS_OPERATOR.md |
| Operator copy-paste commands | 00-meta/OPERATOR_READY_CHECKLIST.md — exact commands for Blockscout, NPMplus, CCIP, 502 fix, backup, deploy |
| 2026-04-24 operator handoff | 00-meta/OPERATOR_HANDOFF_2026_04_24.md — Besu hardening, duplicate RPC retirement, Gitea TLS repair, and remote reconciliation |
| Chain 138 txpool incident recovery | bash scripts/fix-all-validators-and-txpool.sh → bash scripts/maintenance/apply-chain138-strict-future-tx-pool.sh → bash scripts/clear-all-transaction-pools.sh → bash scripts/monitoring/monitor-blockchain-health.sh |
| Gitea TLS expiry check | bash scripts/verify/check-gitea-certificate-expiry.sh — warns before gitea.d-bis.org cert expiry blocks HTTPS pushes |
| Gitea TLS expiry cron | bash scripts/maintenance/schedule-gitea-cert-check-cron.sh --install — installs a daily warning check with WARN_DAYS=30 |
| Gitea repo ↔ VM CI/CD matrix | 04-configuration/GITEA_REPO_VM_CD_CI_MATRIX.md — per-repo workflows, Phoenix deploy targets, templates under config/gitea-workflow-templates/ |
| Gitea CD operator checklist | 00-meta/GITEA_CD_OPERATOR_CHECKLIST.md — secrets, Phoenix host sync, report-gitea-cd-parity.sh |
| TsunamiSwap DEX plan | 00-meta/AAVE_CHAIN138_AND_MARIONETTE_TSUNAMISWAP_PLAN.md — canonical TsunamiSwap VM 5010 plan, current DEX link, and publish checklist |
| Required / optional / recommended (full plan) | 00-meta/COMPLETE_REQUIRED_OPTIONAL_RECOMMENDED_INDEX.md |
| Single task list | 00-meta/TODOS_CONSOLIDATED.md |
| Execution: multiple routes + liquidity (all + optional, suggested order) | 00-meta/EXECUTION_CHECKLIST_MULTIPLE_ROUTES_AND_LIQUIDITY.md |
| Chain 138 PMM 5% peg-safe funding | 03-deployment/CHAIN138_PMM_5PCT_PEG_SAFE_FUNDING_RUNBOOK.md — canonical 0x5BDc... PMM surface, $250M / 5% funding formula, deployer shortfall calculator |
| Source to CEX execution plan | 03-deployment/SOURCE_TO_CEX_EXECUTION_PLAN.md — operator bridge, normalization, and exchange-handoff plan |
| Source to CEX production readiness | 03-deployment/SOURCE_TO_CEX_PRODUCTION_READINESS.md — repo-native readiness gate for immediate production |
| Immediate live production task list: source to CEX | 03-deployment/IMMEDIATE_LIVE_PRODUCTION_TASK_LIST_SOURCE_TO_CEX.md — task list with remaining live blockers called out |
| ALL Mainnet protocol completion | 03-deployment/ALL_MAINNET_PROTOCOL_COMPLETION_RUNBOOK.md — required inventory pools, funding/canary gates, auto-rebalancing path, and protocol enablement order for DODO, Uniswap, Balancer, Curve, Sushi, 1inch, and Aave |
| DBIS Engine X recipient proof package | 03-deployment/DBIS_ENGINE_X_RECIPIENT_PROOF_RUNBOOK.md — executed 2026-05-07 5B-each cWUSDC recipient proof path, virtual-batch vault, ISO 20022-style evidence, audit envelope, and on-chain hash-anchor flow; final report: ../reports/status/dbis-engine-x-final-recipient-proof-execution-20260507.md; public LP compliance gap/route plan: ../reports/status/mainnet-cwusdc-cross-protocol-public-lp-proof-plan-20260507.md; indexed-liquidity upgrade plan: ../reports/status/mainnet-engine-x-indexed-liquidity-upgrade-plan-20260507.md; public indexed readiness: ../reports/status/engine-x-public-indexed-readiness-latest.md |
| External dependency blockers | 03-deployment/EXTERNAL_DEPENDENCY_BLOCKERS.md — explicit list of items that cannot be closed by repo-only changes, with readiness checks and env knobs |
| Crypto.com OTC before vs after matrix | 03-deployment/CRYPTO_COM_OTC_BEFORE_AFTER_OPERATOR_MATRIX.md — strict operator comparison of the current ecosystem versus the state after a real Crypto.com OTC sink is connected |
| Provider-facing source to CEX package | 03-deployment/PROVIDER_FACING_PACKAGE_SOURCE_TO_CEX.md — strict provider-facing package covering expectations, flow presentation, questions, and a first 30-day ramp plan |
| Mr. Promod Uniswap V2 liquidity program | 03-deployment/PROMOD_UNISWAP_V2_LIQUIDITY_PROGRAM.md — wrapped-depth-first Uniswap V2 rollout for cW* and cWAUSDT on bridged public networks |
| Mr. Promod Uniswap V2 promotion gates | 03-deployment/PROMOD_UNISWAP_V2_PROMOTION_GATES.md — exact per-chain env vars and registry records required before any live Uniswap V2 pool can be promoted |
| Mr. Promod Uniswap V2 live pair discovery | 03-deployment/PROMOD_UNISWAP_V2_LIVE_PAIR_DISCOVERY.md — env-ready chain scan for live cW Uniswap V2-compatible pairs and the path to record them |
| cW* mesh deployment matrix (CI) | scripts/verify/build-cw-mesh-deployment-matrix.sh — read-only merge of PMM deploy graph + Uni V2 discovery; JSON artifact reports/status/cw-mesh-deployment-matrix-latest.json; step 3 of scripts/verify/run-all-validation.sh when reports/extraction/promod-uniswap-v2-live-pair-discovery-latest.json exists |
| Non-EVM public network health + lane status | 11-references/NON_EVM_NETWORK_HEALTH_AND_LANE_STATUS.md — separates public Solana/Tron/XRPL endpoint reachability from Chain 138 explorer/source closure; scripts: scripts/verify/check-non-evm-network-health.sh, scripts/verify/build-non-evm-lane-status.py; outputs: reports/status/non-evm-network-health-latest.json, reports/status/non-evm-lane-status-latest.md |
| Machine-readable wrapper summaries | 00-meta/REPO_LOCAL_RECOMMENDATIONS_STATUS.md — canonical no-LAN, E2E, Chain 138, and LAN operator wrappers now support --json-out summaries under reports/status/ for per-step timing/status capture |
| cW* USD pricing (Ethereum Mainnet) | 03-deployment/CW_TOKEN_USD_PRICING_RUNBOOK.md — accounting vs PMM vs reserve-implied; script scripts/deployment/price-cw-token-mainnet.sh; multi-chain mid table 03-deployment/CW_PUBLIC_NETWORK_PRICES.md |
Etherscan “Value” $0 (Mainnet cW*) |
04-configuration/coingecko/ETHERSCAN_USD_VALUE_MAINNET_TOKENS.md — why; CoinGecko/CMC listing path (not a contract fix) |
| Mr. Promod Uniswap V2 first deployment target matrix | 03-deployment/PROMOD_UNISWAP_V2_FIRST_DEPLOYMENT_TARGET_MATRIX.md — exact first pair per chain, why it goes first, required tokens, and post-deploy commands |
| Mr. Promod Uniswap V2 phase order | 03-deployment/PROMOD_UNISWAP_V2_PHASE_ORDER.md — strict rollout order: phase 1 core rail, phase 2 full cW* wrapped mesh, phase 3 settlement rails |
| Mr. Promod Uniswap V2 phase 2 operator sequence | 03-deployment/PROMOD_UNISWAP_V2_PHASE2_OPERATOR_SEQUENCE.md — exact chain-by-chain phase-2 cW* wrapped-mesh rollout with per-pair probe, create, and deploy blocks |
| Mr. Promod Uniswap V2 phase 2 wave 2 operator sequence | 03-deployment/PROMOD_UNISWAP_V2_PHASE2_WAVE2_OPERATOR_SEQUENCE.md — exact chain-by-chain rollout for the remaining wrapped-mesh assets after wave 1 |
| Mr. Promod Uniswap V2 phase 2 wave 2 operator paste pack | 03-deployment/PROMOD_UNISWAP_V2_PHASE2_WAVE2_OPERATOR_PASTE_PACK.md — flat paste-ready operator pack for every remaining wrapped-mesh pair in wave 2 |
| Mr. Promod Uniswap V2 phase 2 wave 2 shell paste pack | 03-deployment/PROMOD_UNISWAP_V2_PHASE2_WAVE2_SHELL_PASTE_PACK.sh — pure shell-only sequence for every remaining wrapped-mesh pair in wave 2 |
| Mr. Promod Uniswap V2 phase 2 operator paste pack | 03-deployment/PROMOD_UNISWAP_V2_PHASE2_OPERATOR_PASTE_PACK.md — flat paste-ready operator pack for every phase-2 wrapped-mesh pair in execution order |
| Mr. Promod Uniswap V2 phase 2 shell paste pack | 03-deployment/PROMOD_UNISWAP_V2_PHASE2_SHELL_PASTE_PACK.sh — pure shell-only sequence for phase-2 wrapped-mesh pair creation and seeding |
| Mr. Promod Uniswap V2 phase 2 wave 1 completion status | 03-deployment/PROMOD_UNISWAP_V2_PHASE2_WAVE1_COMPLETION_STATUS.md — live reserve-backed completion report for the six wave-1 wrapped pairs on all target networks, plus current explorer-publication blockers |
| Mr. Promod GRU v2 full mesh gap report | 03-deployment/PROMOD_GRU_V2_FULL_MESH_GAP_REPORT.md — strict per-network gap report for the remaining cW mesh across DODO PMM, Uniswap V2, Balancer, Curve, and other venue surfaces |
| Chain 138 -> Wemix 1111 bridge completion checklist | 03-deployment/CHAIN_138_TO_WEMIX_1111_BRIDGE_COMPLETION_CHECKLIST.md — exact operator checklist for funding the deployed WEMIX WETH bridges with LINK, proving the lane, and promoting 1111 out of non-live state |
| WEMIX bridge verification status | 03-deployment/WEMIX_BRIDGE_VERIFICATION_STATUS.md — current explorer-publication state for the deployed WEMIX bridges and the repo-native verification command |
| Mr. Promod Uniswap V2 phase 1 execution checklist | 03-deployment/PROMOD_UNISWAP_V2_PHASE1_EXECUTION_CHECKLIST.md — exact chain-by-chain operator checklist for the first full cWUSDT/cWUSDC rollout |
| Mr. Promod Uniswap V2 phase 1 funding readiness | 03-deployment/PROMOD_UNISWAP_V2_PHASE1_FUNDING_READINESS.md — live deployer-wallet balances and max equal-sided seed size for each cWUSDT/cWUSDC target chain |
| Mr. Promod Uniswap V2 phase 1 funding bundle | 03-deployment/PROMOD_UNISWAP_V2_PHASE1_FUNDING_BUNDLE.md — per-chain missing-token/gas bundle and exact post-funding deploy block for phase 1 |
| Mr. Promod Uniswap V2 phase 1 funding actions | 03-deployment/PROMOD_UNISWAP_V2_PHASE1_FUNDING_ACTIONS.md — strict per-chain mint-before-seed or seed-now action plan, with bridge-possible notes tied to the cW bridge runbooks |
| Mr. Promod Uniswap V2 phase 1 bridge-from-138 matrix | 03-deployment/PROMOD_UNISWAP_V2_PHASE1_BRIDGE_FROM_138_MATRIX.md — strict destination shortfall matrix showing how much cUSDT/cUSDC Chain 138 inventory could source for the remaining phase-1 rollout |
| Mr. Promod Uniswap V2 phase 1 bridge 3x matrix | 03-deployment/PROMOD_UNISWAP_V2_PHASE1_BRIDGE_3X_MATRIX.md — strict 3x bridge sizing plan from Chain 138 for the remaining phase-1 destination shortfalls |
| Mr. Promod Uniswap V2 phase 1 bridge 3x operator packet | 03-deployment/PROMOD_UNISWAP_V2_PHASE1_BRIDGE_3X_OPERATOR_PACKET.md — strict operator packet with 3x bridge amounts, destination cW addresses, bridge env, and post-funding deploy block per chain |
| Mr. Promod Uniswap V2 phase 1 bridge-or-mint runbook | 03-deployment/PROMOD_UNISWAP_V2_PHASE1_BRIDGE_OR_MINT_RUNBOOK.md — strict runbook that ties the 3x operator packet to bridge preflight, exact mint fallback blocks, and post-funding deploy blocks |
| Mr. Promod Uniswap V2 phase 1 remaining 8 operator paste pack | 03-deployment/PROMOD_UNISWAP_V2_PHASE1_REMAINING_8_OPERATOR_PASTE_PACK.md — one flat paste-ready pack for the remaining eight phase-1 chains after 1 and 137 |
| Mr. Promod Uniswap V2 phase 1 remaining 8 shell paste pack | 03-deployment/PROMOD_UNISWAP_V2_PHASE1_REMAINING_8_SHELL_PASTE_PACK.sh — pure shell-only paste pack for the remaining eight phase-1 chains with no markdown headings |
| All additional recommendations (table) | 00-meta/ADDITIONAL_RECOMMENDATIONS_TABLE.md — consolidated table of every recommendation with description and command/doc |
| Repo-local recommendations status | 00-meta/REPO_LOCAL_RECOMMENDATIONS_STATUS.md — tracks what has been advanced in this workspace without mixing in LAN-only or external-only work |
| Dotenv & markdown audit (gaps + recommendations) | 00-meta/DOTENV_AND_MARKDOWN_AUDIT_GAPS_AND_RECOMMENDATIONS.md — required env/markdown info, run results, gaps, recommendations |
| Next steps (concise) | 00-meta/NEXT_STEPS_LIST.md — bridge/swap/Phase C status, quick commands |
| Still not done (operator/external) | 00-meta/STILL_NOT_DONE_EXECUTION_CHECKLIST.md |
| Remaining tasks (one page) | 00-meta/REMAINING_TASKS.md |
| Contract next steps (Chain 138) | 11-references/CONTRACT_NEXT_STEPS_LIST.md — on-chain check (61 addr), Blockscout, env |
| Task check report (verify before completing) | 00-meta/TASK_CHECK_REPORT.md |
| Gaps status (all gap sources + fixes) | 00-meta/GAPS_STATUS.md |
Master lists (canonical)
By area
Current decision docs
| Topic | Document |
|---|---|
| Government treasury, EMI, digital wallet, virtual account (regulated settlement) | 02-architecture/GOVERNMENT_TREASURY_EMI_WALLET_MASTER_PLAN.md |
| Vault shard custody policy decision | 04-configuration/VAULT_SHARD_CUSTODY_POLICY.md |
| Multi-chain rotation rollout order | runbooks/MULTI_CHAIN_ROTATION_ROLLOUT_ORDER_MEMO.md |
Deprecated / superseded (do not use as primary source)
| Document | Use instead |
|---|---|
| ALL_IMPROVEMENTS_AND_GAPS_INDEX.md | 00-meta/ALL_RECOMMENDATIONS_AND_IMPROVEMENTS_LIST.md |
| CONTRACT_INVENTORY_AND_VERIFICATION, SMART_CONTRACTS_INVENTORY | 11-references/ADDRESS_MATRIX_AND_STATUS.md |
| Dated one-off reviews (e.g. DOCUMENTATION_REVIEW_20260216) | Superseded — use 00-meta/DOCUMENTATION_CONSOLIDATION_PLAN.md and 00-meta/ARCHIVE_CANDIDATES.md (inventory only; do not link into docs/archive/ from runbooks) |
Consolidation and maintenance
- Archive inventory (paths on disk; do not link into
docs/archive/from runbooks): 00-meta/ARCHIVE_CANDIDATES.md - Consolidation plan: 00-meta/DOCUMENTATION_CONSOLIDATION_PLAN.md
- Task list review (deprecated/duplicates resolved): 00-meta/TASK_LIST_REVIEW_2026_03_01.md