724ba7a935
- E2E_ENDPOINTS_LIST, MASTER_INDEX, TODOS, NEXT_STEPS_*, OPERATOR_READY_CHECKLIST: public DealFlow 5/5, Wave 0 (41 hosts), submodules gate vs the-order, Studio/NPM token notes. - OPERATIONAL_RUNBOOKS: HTTPS for POST /api/tokens; 2026-05-11 Wave 0 verification. - RUNBOOKS_MASTER_INDEX: last-updated. ALL_VMIDS_ENDPOINTS: local WIP remains uncommitted; DealFlow public-edge note is in working copy only until inventory refresh is finalized. Co-authored-by: Cursor <cursoragent@cursor.com>
40 KiB
40 KiB
Documentation — Master Index
Last Updated: 2026-05-11 Purpose: Single entry point for all project documentation. Use this index to find canonical sources and avoid deprecated or duplicate content.
Status: Latest (2026-05-11): run-completable-tasks-from-anywhere.sh OK — reports/status/run-completable-tasks-latest.json. bash scripts/verify/submodules-clean.sh may fail until submodule the-order working tree is clean (commit or discard local edits). DealFlow public: DNS record dealflow, NPMplus proxy dealflow.d-bis.org → https://192.168.11.94:443, TLS + backend CORS_ORIGIN; verify-dealflow-public-e2e.sh default URL 5/5 — see E2E_ENDPOINTS_LIST.md. NPM Wave 0: run-wave0-from-lan.sh refreshed 41 proxy hosts (0 failed). Studio: keep fusionai-creator-api (VMID 7805) running; umbrella E2E snapshot 2026-05-10 still lists studio.sankofa.nexus warn — re-run public profile after fixes. Repo: DealFlow DNS + NPM updater scripts committed/pushed on master (Gitea). Prior live check (2026-04-29 ~10:50 UTC): Core RPC 138 OK, 61/61 on-chain, run-all-validation.sh --skip-genesis OK, E2E --profile=all 49 domains / 0 failed — logs/next-steps-complete-20260429T062049Z.log, snapshot reports/status/live-network-check-latest.json. CCIP: Chain 138 WETH9/WETH10 bridges +10 LINK each; sample sendCrossChain 0.0001 WETH Chain 138→Mainnet succeeded (destination bridge msg 0xcbf278baaa…). Destination-chain LINK/gas top-ups remain capital-gated; 12 c* GRU-registered; token-aggregation public report API live. On-chain verification: DODOPMMIntegration canonical cUSDT/cUSDC — EXPLORER_TOKEN_LIST_CROSSCHECK. Remaining: B.1/B.2 gas, destination-chain LINK, external listings, Phase C/D optional — 00-meta/TODOS_CONSOLIDATED.md, 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 |
| Master reference — token / stablecoin launch compendium (“Bible from Nathan”) | 00-meta/BIBLE_FROM_NATHAN_TOKEN_LAUNCH_RESOURCE_COMPENDIUM.md — institutional launch reference: regulation, counsel, custody, banking, tooling, audits, bridges, oracles, aggregators (CG/CMC/DEX Screener/DefiLlama), listings, and reusable checklists; complements Chain 138–specific canonicals in this index |
Master reference — MetaMask Money/mUSD ↔ GRU, provider cross-links, DefiLlama DODO dfio_meta_main TVL |
00-meta/METAMASK_GRU_DEFILLAMA_CHAIN138_MASTER_REFERENCE.md — full replay: matrix narrative steps, reciprocal doc edits, DefiLlama-Adapters fork/test/PR workflow, #19198 tracking, config/defillama-chain138-touchpoints.json fields, and post-merge maintenance checklist |
| 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 |
| External repos and PRs (Chain 138) | 00-meta/REPOSITORIES_AND_PRS_CHAIN138.md — Ledger, Trust Wallet, Chainlist, Consensys/MetaMask outreach, DefiLlama-Adapters #19198 (DODO dfio_meta_main), on-ramps; pairs with METAMASK_GRU_DEFILLAMA_CHAIN138_MASTER_REFERENCE.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; token-aggregation/Engine X open components: ../reports/status/token-aggregation-engine-x-open-components-20260509.md |
| DBIS Engine X automated liquidity advisor | 03-deployment/DBIS_ENGINE_X_AUTOMATED_LIQUIDITY_ADVISOR.md — API-feed, calculator, XAUt collateral, public-indexed liquidity, MEV defense, and endpoint reporting control surface; command: pnpm engine-x:automation-advisor; policy: ../config/engine-x/automation-policy.json; latest report: ../reports/status/engine-x-automated-liquidity-advisor-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, 04-configuration/etherscan/CWUSDC_ETHERSCAN_VALUE_EXECUTION_PLAN.md, and 04-configuration/etherscan/CWUSDC_ETHERSCAN_BRIDGE_CROSSCHAIN_LAYER_MAP.md — focused Mainnet cWUSDC Value path, bridge/cross-chain evidence boundaries, and generated dossier at reports/status/cwusdc-etherscan-value-dossier-latest.md |
| MetaMask / wallet price-provider submissions | 04-configuration/metamask/METAMASK_ASSET_PRICE_PROVIDER_SUBMISSION_MATRIX.md (incl. MetaMask Money / mUSD ↔ GRU hub and cW* transport narrative), 00-meta/METAMASK_GRU_DEFILLAMA_CHAIN138_MASTER_REFERENCE.md (replay + maintenance), 04-configuration/GRU_PROVIDER_POSITIONING_PACKET.md, 04-configuration/CWUSDC_PROVIDER_SUBMISSION_PACKET.md, and 04-configuration/metamask/METAMASK_EIP747_CONTRACT_METADATA_REFERENCE_PACKET.md — canonical matrix, GRU/Chain 138 provider narrative, cWUSDC cross-provider packet, and source-summary packet for repo-controlled metadata, MetaMask EIP-747, Etherscan, CoinGecko, CMC, Chainlist, wallet registries, and provider acceptance tracking |
| DefiLlama metrics ↔ Chain 138 (TVL + optional) | 04-configuration/defillama/CHAIN138_DEFILLAMA_ECOSYSTEM_MAP.md, 11-references/DEFILLAMA_DFIO_META_MAIN_DODO_ADAPTER_TVL.md, 00-meta/METAMASK_GRU_DEFILLAMA_CHAIN138_MASTER_REFERENCE.md — maps docs.llama.fi metrics to repos, e-money framing vs methodology, DODO dfio_meta_main TVL (open upstream DefiLlama/DefiLlama-Adapters#19198), and full operator replay; touchpoints JSON config/defillama-chain138-touchpoints.json; Gitea mirror helper scripts/deployment/mirror-github-fork-to-gitea.sh |
| 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