Files
proxmox/docs/MASTER_INDEX.md
defiQUG e01c906e56 docs(ops): submodule hygiene guide, verify script, rule/doc alignment
- Add docs/00-meta/SUBMODULE_HYGIENE.md (detached HEAD, remotes, JSON refs)
- Add scripts/verify/submodules-clean.sh (labeled dirty-tree report)
- AGENTS.md + CONTRIBUTOR_GUIDELINES + OPERATOR_READY_CHECKLIST + MASTER_INDEX
- chain138-tokens-and-pmm: DODOPMMIntegration 0x5BDc62… per ADDRESS_MATRIX
- Bump smom-dbis-138 + explorer-monorepo (config READMEs, explorer env loading)

Made-with: Cursor
2026-03-27 22:12:46 -07:00

12 KiB
Raw Blame History

Documentation — Master Index

Last Updated: 2026-03-27
Purpose: Single entry point for all project documentation. Use this index to find canonical sources and avoid deprecated or duplicate content.

Status: Preflight and Chain 138 next steps completed (59/59 on-chain per check-contracts-on-chain-138.sh, 12 c* GRU-registered). 2026-03-06: Contract check list expanded to 59 addresses (PMM, vault/reserve, CompliantFiatTokens); doc refs updated. 2026-03-04: Celo CCIP bridges deployed; Phase AD 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: Wemix 0.4 WEMIX, LINK fund, cW* + edge pools — see 00-meta/TODOS_CONSOLIDATED.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)
Git submodule hygiene + explorer remotes 00-meta/SUBMODULE_HYGIENE.md — detached HEAD, push order, Gitea/GitHub, submodules-clean.sh
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
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
All additional recommendations (table) 00-meta/ADDITIONAL_RECOMMENDATIONS_TABLE.md — consolidated table of every recommendation with description and command/doc
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 (59 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)

Topic Canonical document Do not use (deprecated/superseded)
Next steps 00-meta/NEXT_STEPS_INDEX.md, 00-meta/NEXT_STEPS_AND_REMAINING_TODOS.md
Recommendations (139+ items) 00-meta/ALL_RECOMMENDATIONS_AND_IMPROVEMENTS_LIST.md ALL_IMPROVEMENTS_AND_GAPS_INDEX.md — superseded; redirect only
Optional / recommendations index OPTIONAL_RECOMMENDATIONS_INDEX.md
Task list 00-meta/TODO_TASK_LIST_MASTER.md, 00-meta/TODOS_CONSOLIDATED.md
Deployment order 03-deployment/DEPLOYMENT_ORDER_OF_OPERATIONS.md, 03-deployment/REMAINING_DEPLOYMENTS_FOR_FULL_NETWORK_COVERAGE.md (Phases AD)
Phase C (cW* + edge pools) 03-deployment/PHASE_C_CW_AND_EDGE_POOLS_RUNBOOK.md
Phase D (optional XAU/vaults/trustless) 03-deployment/PHASE_D_OPTIONAL_CHECKLIST.md
Operational runbooks 03-deployment/OPERATIONAL_RUNBOOKS.md RUNBOOKS_MASTER_INDEX.md — use OPERATIONAL_RUNBOOKS as single source
Contract / address status 11-references/ADDRESS_MATRIX_AND_STATUS.md, 11-references/CONTRACT_ADDRESSES_REFERENCE.md, 11-references/CONTRACT_NEXT_STEPS_LIST.md (59-addr check) CONTRACT_INVENTORY_AND_VERIFICATION (deleted)
Proxmox VMIDs, LAN IPs, NPM targets 04-configuration/ALL_VMIDS_ENDPOINTS.md, config/ip-addresses.conf, 11-references/NETWORK_CONFIGURATION_MASTER.md, config/proxmox-operational-template.json Dated inventories under docs/archive/ (paths on disk only)
FQDN → expected content (web / API / RPC) 04-configuration/FQDN_EXPECTED_CONTENT.md
IP conflict resolutions reports/status/IP_CONFLICTS_RESOLUTION_COMPLETE.md, scripts/resolve-ip-conflicts.sh

By area

Area Index / key doc
00-meta (tasks, next steps, phases) 00-meta/NEXT_STEPS_INDEX.md, 00-meta/PHASES_AND_TASKS_MASTER.md
02-architecture 02-architecture/Public sector + Phoenix catalog baseline: 02-architecture/PUBLIC_SECTOR_TENANCY_MARKETPLACE_AND_DEPLOYMENT_BASELINE.md; non-goals (incl. catalog vs marketing §9): 02-architecture/NON_GOALS.md
03-deployment 03-deployment/OPERATIONAL_RUNBOOKS.md, 03-deployment/DEPLOYMENT_ORDER_OF_OPERATIONS.md, Public sector live checklist: 03-deployment/PUBLIC_SECTOR_LIVE_DEPLOYMENT_CHECKLIST.md, Proxmox VE ops template: 03-deployment/PROXMOX_VE_OPERATIONAL_DEPLOYMENT_TEMPLATE.md · config/proxmox-operational-template.json
04-configuration 04-configuration/README.md, 04-configuration/ADDITIONAL_PATHS_AND_EXTENSIONS.md (paths, registry, token-mapping, LiFi/Jumper); OMNL Indonesia / HYBX-BATCH-001: 04-configuration/mifos-omnl-central-bank/HYBX_BATCH_001_OPERATOR_CHECKLIST.md, 04-configuration/mifos-omnl-central-bank/INDONESIA_PACKAGE_4_995_EVIDENCE_STANDARD.md
06-besu 06-besu/MASTER_INDEX.md
Testnet (2138) testnet/DEFI_ORACLE_META_TESTNET_2138_RUNBOOK.md, testnet/TESTNET_DEPLOYMENT.md
07-ccip 07-ccip/, 00-meta/CW_BRIDGE_TASK_LIST.md
11-references 11-references/ADDRESS_MATRIX_AND_STATUS.md, 11-references/CONTRACT_ADDRESSES_REFERENCE.md, 11-references/DEPLOYER_CONTRACTS_INVENTORY_AND_VERIFICATION_STATUS.md (all contracts by deployer wallet, network, verified/not), 11-references/DEPLOYED_TOKENS_BRIDGES_LPS_AND_ROUTING_STATUS.md (tokens, bridges, DODO/Uniswap LPs, full route map), 11-references/DEPLOYER_TO_PUBLIC_STABLECOIN_ROUTES.md (deployer→public stablecoin routes), 11-references/ROUTES_NO_PREFUNDED_BRIDGE_REQUIRED.md (routes where bridge pre-fund not required), 11-references/CCIP_138_DESTINATION_RECEIVER_BY_CHAIN_AND_TOKEN.md (per-chain per-token: mint vs receive+forward vs release), 11-references/DEPLOYMENT_DATA_SOURCES_INDEX.md (dotenv and config files with contract deployments), 11-references/EXPLORER_TOKEN_LIST_CROSSCHECK.md (Explorer /tokens vs repo token lists), 11-references/COMPLETE_CREDENTIAL_EIDAS_PROGRAM_REPOS.md (Complete Credential / eIDAS connector repo authority + manifest), 11-references/HARDWARE_INVENTORY_MASTER.md, 11-references/13_NODE_NETWORK_AND_CABLING_CHECKLIST.md, 11-references/13_NODE_AND_ASSETS_BRING_ONLINE_CHECKLIST.md
Hardware / 13-node 11-references/HARDWARE_INVENTORY_MASTER.md (R630×13, R750×3, 7920×2, UDM Pro×2, XG×2), 02-architecture/R630_13_NODE_DOD_HA_MASTER_PLAN.md, 11-references/13_NODE_NETWORK_AND_CABLING_CHECKLIST.md, 11-references/13_NODE_AND_ASSETS_BRING_ONLINE_CHECKLIST.md
Runbooks 03-deployment/OPERATIONAL_RUNBOOKS.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