3f76bc9507
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
- 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
155 lines
9.7 KiB
Markdown
155 lines
9.7 KiB
Markdown
# Project and Submodules — Full Review
|
||
|
||
**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:** `0x79cdbaFBaA0FdF9F55D26F360F54cddE5c743F7D` (on-chain verified 2026-03-04).
|
||
- **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).
|