# Project and Submodules — Full Review

> 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`.

**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.
- **DODOPMMIntegration:** `0x5BDc62f1ae7D630c37A8B363a1d49845356Ee72d` (current canonical corrected stack).
- **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).