docs: update master documentation and push to Gitea (2026-03-06)
- MASTER_INDEX: Last Updated 2026-03-06; status 59/59 contracts; add NEXT_STEPS_LIST, CONTRACT_NEXT_STEPS_LIST
- docs/README, NEXT_STEPS_INDEX, 06-besu/MASTER_INDEX: Last Updated 2026-03-06
- Contract check script: 59 addresses (PMM, vault/reserve, CompliantFiatTokens); canonical CCIP/router
- New docs: EXECUTION_CHECKLIST, NEXT_STEPS_LIST, DOTENV_AUDIT, ADDITIONAL_PATHS, deployer gas runbook, WEMIX_ACQUISITION_TABLED, etc.
- Config: deployer-gas-routes, cro-wemix-swap-routes, routing-registry, token-mapping
- Scripts: check-contracts-on-chain-138, check-pmm-pool-balances-chain138, deployer-gas-auto-route, acquire-cro-and-wemix-gas
- Operator rule: operator-lan-access-check.mdc
Made-with: Cursor
2026-03-06 19:11:25 -08:00
# Project and Submodules — Full Review
2026-03-27 18:47:08 -07:00
> Historical note (2026-03-26): this review includes superseded PMM-address references from earlier validation passes. The current canonical Chain 138 PMM stack is `DODOPMMIntegration=0x5BDc62f1ae7D630c37A8B363a1d49845356Ee72d` and `DODOPMMProvider=0x5CAe6Ce155b7f08D3a956F5Dc82fC9945f29B381`.
docs: update master documentation and push to Gitea (2026-03-06)
- MASTER_INDEX: Last Updated 2026-03-06; status 59/59 contracts; add NEXT_STEPS_LIST, CONTRACT_NEXT_STEPS_LIST
- docs/README, NEXT_STEPS_INDEX, 06-besu/MASTER_INDEX: Last Updated 2026-03-06
- Contract check script: 59 addresses (PMM, vault/reserve, CompliantFiatTokens); canonical CCIP/router
- New docs: EXECUTION_CHECKLIST, NEXT_STEPS_LIST, DOTENV_AUDIT, ADDITIONAL_PATHS, deployer gas runbook, WEMIX_ACQUISITION_TABLED, etc.
- Config: deployer-gas-routes, cro-wemix-swap-routes, routing-registry, token-mapping
- Scripts: check-contracts-on-chain-138, check-pmm-pool-balances-chain138, deployer-gas-auto-route, acquire-cro-and-wemix-gas
- Operator rule: operator-lan-access-check.mdc
Made-with: Cursor
2026-03-06 19:11:25 -08:00
**Last Updated:** 2026-03-05
**Purpose:** Single-document review of the **proxmox ** workspace and all submodules (content, roles, and relationships).
---
## 1. Root Project Summary
**Repository:** proxmox (Gitea: `d-bis/proxmox` )
**Type:** Monorepo (pnpm workspaces) + 16 git submodules
**Scope:** Proxmox/infrastructure automation, Chain 138 blockchain network and services, multi-chain DeFi (CCIP, PMM, bridges), business systems (DBIS, OMNIS, The Order), and supporting tooling.
### Root Capabilities
| Area | Description |
|------|--------------|
| **Proxmox / MCP ** | MCP server for Proxmox (mcp-proxmox), ProxmoxVE helper scripts + Next.js frontend |
| **Operator automation ** | `scripts/` (381+ scripts): verify-all, list, fix-all, configure; deployment, bridge, CCIP, monitoring, NPMplus, OMNL, validation |
| **Documentation ** | `docs/` with MASTER_INDEX, 00-meta (next steps, TODOs), 02– 12 (architecture, deployment, config, Besu, CCIP, references) |
| **Config ** | `config/` : contract addresses, routing registry, token mapping, besu-node-lists, address-registry |
| **Chain 138 ** | Canonical RPC: `http://192.168.11.211:8545` ; deployer `0x4A666F96fC8764181194447A7dFdb7d471b301C8` ; DODO PMM, cUSDT/cUSDC, Explorer at explorer.d-bis.org |
### Key Entry Points
- **Docs:** [docs/MASTER_INDEX.md ](../MASTER_INDEX.md )
- **Next steps:** [docs/00-meta/NEXT_STEPS_INDEX.md ](NEXT_STEPS_INDEX.md )
- **Operator commands:** [docs/00-meta/OPERATOR_READY_CHECKLIST.md ](OPERATOR_READY_CHECKLIST.md )
- **Submodule map:** [docs/11-references/SUBMODULE_RELATIONSHIP_MAP.md ](../11-references/SUBMODULE_RELATIONSHIP_MAP.md )
- **Deployment phases:** [docs/03-deployment/REMAINING_DEPLOYMENTS_FOR_FULL_NETWORK_COVERAGE.md ](../03-deployment/REMAINING_DEPLOYMENTS_FOR_FULL_NETWORK_COVERAGE.md ) (Phases A– D)
---
## 2. Submodules (16 Root-Level)
### 2.1 Core Infrastructure
| Submodule | Path | Repo | Purpose |
|-----------|------|------|---------|
| **mcp-proxmox ** | `mcp-proxmox/` | gilby125/mcp-proxmox | Node.js MCP server for Proxmox: 55+ tools, token auth, basic vs elevated permissions, VM/container/storage/snapshot/backup management |
| **ProxmoxVE ** | `ProxmoxVE/` | community-scripts/ProxmoxVE (Gitea: d-bis/ProxmoxVE) | Community Proxmox VE helper scripts + Next.js frontend; legacy of tteck |
### 2.2 Blockchain & Chain 138
| Submodule | Path | Repo | Purpose |
|-----------|------|------|---------|
| **smom-dbis-138 ** | `smom-dbis-138/` | Order-of-Hospitallers/smom-dbis-138 | Production Besu QBFT network (ChainID 138): validators, RPC, CCIP, WETH9/10, DODO PMM, relay, token-aggregation, watchtower, real-robinhood, metamask, runbooks |
| **explorer-monorepo ** | `explorer-monorepo/` | Order-of-Hospitallers/chain-138-explorer | Blockscout-style explorer: tiered API (public RPC gateway → indexed → analytics → operator), backend libs, SPA at explorer.d-bis.org (VMID 5000) |
| **metamask-integration ** | `metamask-integration/` | Defi-Oracle-Meta-Blockchain/metamask-integration | Chain 138 MetaMask: network config, token lists, price feed, chain138-snap, Smart Accounts Kit, examples |
| **fireblocks-integration ** | `fireblocks-integration/` | Gitea d-bis/fireblocks-integration | Fireblocks Web3 for Chain 138: RPC/WS endpoints, docs, env examples |
| **alltra-lifi-settlement ** | `alltra-lifi-settlement/` | bis-innovations/LiFi_Pay_Alltra_Integration_Submodule | Li.Fi Pay + Alltra: payments on public chains, vaults, settlement on 138 (CompliantUSDC), merchant withdrawals via CCIP; ALL Mainnet 651940 |
| **cross-chain-pmm-lps ** | `cross-chain-pmm-lps/` | Gitea d-bis/cross-chain-pmm-lps | cW* M1 PMM mesh: token map, pool topology, peg bands, bot logic, simulation, deployment-status, routing controls |
| **ai-mcp-pmm-controller ** | `ai-mcp-pmm-controller/` | Gitea d-bis/ai-mcp-pmm-controller | MCP hub for DODO PMM (VMID 5701): read-only pool state, risk scoring, policy-gated simulation; allowlist, execution gates (ALLOW_WRITE + EXECUTION_ARMED) |
| **OMNIS ** | `OMNIS/` | Defi-Oracle-Tooling/OMNIS | Family office platform: entities, filings, treasury, projects, compliance; React 19 + Express + PostgreSQL |
### 2.3 Business & Sovereign
| Submodule | Path | Repo | Purpose |
|-----------|------|------|---------|
| **dbis_core ** | `dbis_core/` | Order-of-Hospitallers/dbis_core | DBIS core banking: Neural Consensus Engine, Global Quantum Ledger, sovereign layer (33 SCBs), ledger, payments, FX, CBDC, compliance, settlement |
| **the-order ** | `the-order/` | Order-of-Hospitallers/the-order-monorepo | Sovereign cloud: digital identity (eIDAS/DID), verifiable credentials (Entra VerifiedID), legal DMS, VDRs, payments, e-Residency; TypeScript monorepo |
| **miracles_in_motion ** | `miracles_in_motion/` | Order-of-Hospitallers/miracles_in_motion | 501(c)3 nonprofit platform: portals, AI matching, i18n, PWA, Azure Static Web Apps + Functions |
| **metaverseDubai ** | `metaverseDubai/` | Order-of-Hospitallers/metaverseDubai | UE 5.4 Dubai metaverse slice: photogrammetry, MetaHuman NPCs, weather/day-night, 8K cinematics |
### 2.4 Documentation & Tooling
| Submodule | Path | Repo | Purpose |
|-----------|------|------|---------|
| **gru-docs ** | `gru-docs/` | Defi-Oracle-Tooling/GRU-Official-Docs-Monetary-Policies | GRU monetary policy docs: M00/M0/M1, Diamond contracts, parity, Li99, governance, DBIS integration |
### 2.5 ARROMIS
| Submodule | Path | Repo | Purpose |
|-----------|------|------|---------|
| **arromis-monorepo ** | `arromis-monorepo/` | ARROMIS/arromis-monorepo | ARROMIS org monorepo; contains 5 nested submodules: documentation, coordination-hub, sovereign-body-registry, deployment-orchestrator, integration-templates |
| **omada-api ** | `omada-api/` | ARROMIS/omada-api | Omada API client; workspace package, may be tracked as submodule |
### 2.6 PR / Chain Data
| Submodule | Path | Repo | Purpose |
|-----------|------|------|---------|
| **pr-workspace/app-ethereum ** | `pr-workspace/app-ethereum/` | defiQUG/app-ethereum | Ethereum app (e.g. chainlist/Trust PRs) |
| **pr-workspace/chains ** | `pr-workspace/chains/` | defiQUG/chains | Chain list data for PR submissions |
---
## 3. Non-Submodule Components (Root or Sibling)
- **scripts/** — Root automation: deployment, bridge, CCIP, verify, monitoring, omnl, dbis, health, validation, etc.; unified frameworks (verify-all, list, fix-all, configure). Uses `scripts/lib/load-project-env.sh` for dotenv.
- **config/** — smart-contracts-master, contract-addresses.conf, routing-registry.json, token-mapping, address-registry, besu-node-lists.
- **docs/** — All project documentation; 00-meta through 12-quick-reference, archive.
- **phoenix-deploy-api** — Deploy API (referenced in README).
- **x402-api** — HTTP 402 payment API.
- **forge-verification-proxy** — Contract verification proxy (e.g. Blockscout).
- **rpc-translator-138** — RPC translation for Chain 138.
- **mcp-omada**, **mcp-site-manager ** , **mcp-unifi ** — MCP servers (Omada, site manager, UniFi).
- **unifi-api** — UniFi API client.
- **omnl-fineract** — OMNL/Fineract integration.
- **token-lists/** — Explorer tagging, publication packs, submissions.
- **reports/** — Status, inventories, analyses, deployer funding/bridge reports.
- **backups/** — NPMplus backups (e.g. npmplus/).
- **smom-dbis-138-proxmox** — Referenced in README for deployment; git submodule is `smom-dbis-138` (same codebase).
---
## 4. Dependency Overview
- **explorer-monorepo**, **metamask-integration ** , **fireblocks-integration ** depend on Chain 138 (smom-dbis-138 RPC/config).
- **the-order** optionally depends on **dbis_core ** .
- **cross-chain-pmm-lps** and **ai-mcp-pmm-controller ** reference parent token/config (e.g. token-mapping, allowlist).
- **arromis-monorepo** nests 5 submodules; **omada-api ** is a workspace package possibly used by root or other packages.
---
## 5. Operator and Execution Context
- **LAN/Proxmox:** Hosts 192.168.11.10 (ML110), .11, .12; Chain 138 RPC 192.168.11.211:8545; NPMplus 192.168.11.167:81 or .166:81.
- **Dotenv:** Root `.env` and `smom-dbis-138/.env` loaded by `scripts/lib/load-project-env.sh` ; no need to `source .env` before operator scripts.
- **Flows:** (1) `./scripts/run-completable-tasks-from-anywhere.sh` then (2) `./scripts/run-all-operator-tasks-from-lan.sh` (optional `--deploy` , `--create-vms` , `--skip-backup` ).
---
## 6. Deployment Phases (High Level)
| Phase | Focus | Status (2026-03-04) |
|-------|--------|----------------------|
| A | Mint cUSDT/cUSDC (138) + add PMM liquidity | A.1– A.2 done |
| B | CCIP bridges (Celo, Wemix, Gnosis, etc.) + LINK funding | Celo + Gnosis done; Wemix blocked (0.4 WEMIX); LINK funding partial |
| C | cW* + edge pools | Runbook: PHASE_C_CW_AND_EDGE_POOLS_RUNBOOK.md |
| D | Optional XAU/vaults/trustless | Checklist: PHASE_D_OPTIONAL_CHECKLIST.md |
---
## 7. Canonical References (Token / Contracts)
- **Canonical tokens (138):** cUSDT, cUSDC per [docs/11-references/EXPLORER_TOKEN_LIST_CROSSCHECK.md ](../11-references/EXPLORER_TOKEN_LIST_CROSSCHECK.md ) §5 and §8.
2026-03-27 18:47:08 -07:00
- **DODOPMMIntegration:** `0x5BDc62f1ae7D630c37A8B363a1d49845356Ee72d` (current canonical corrected stack).
docs: update master documentation and push to Gitea (2026-03-06)
- MASTER_INDEX: Last Updated 2026-03-06; status 59/59 contracts; add NEXT_STEPS_LIST, CONTRACT_NEXT_STEPS_LIST
- docs/README, NEXT_STEPS_INDEX, 06-besu/MASTER_INDEX: Last Updated 2026-03-06
- Contract check script: 59 addresses (PMM, vault/reserve, CompliantFiatTokens); canonical CCIP/router
- New docs: EXECUTION_CHECKLIST, NEXT_STEPS_LIST, DOTENV_AUDIT, ADDITIONAL_PATHS, deployer gas runbook, WEMIX_ACQUISITION_TABLED, etc.
- Config: deployer-gas-routes, cro-wemix-swap-routes, routing-registry, token-mapping
- Scripts: check-contracts-on-chain-138, check-pmm-pool-balances-chain138, deployer-gas-auto-route, acquire-cro-and-wemix-gas
- Operator rule: operator-lan-access-check.mdc
Made-with: Cursor
2026-03-06 19:11:25 -08:00
- **PMM pools:** cUSDT/cUSDC, cUSDT/USDT, cUSDC/USDC addresses in CONTRACT_ADDRESSES_REFERENCE and ADDRESS_MATRIX_AND_STATUS.
- **Contract source of truth:** `config/smart-contracts-master.json` ; overrides via `.env` .
---
## 8. Submodule Update Commands
```bash
git submodule update --init --recursive
git submodule update --remote
# Nested (arromis-monorepo):
cd arromis-monorepo && git submodule update --init --recursive && cd ..
```
---
**Related:** [SUBMODULE_RELATIONSHIP_MAP.md ](../11-references/SUBMODULE_RELATIONSHIP_MAP.md ), [MASTER_INDEX.md ](../MASTER_INDEX.md ), [NEXT_STEPS_INDEX.md ](NEXT_STEPS_INDEX.md ), root [README.md ](../../README.md ), [PROJECT_STRUCTURE.md ](../../PROJECT_STRUCTURE.md ).