d-bis/proxmox
4
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
Files
3f76bc950779f8c1a4403abddb952cdbce5fa420
proxmox/docs/00-meta/PROJECT_AND_SUBMODULES_REVIEW.md
defiQUG 3f76bc9507
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
Details
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

9.7 KiB
Raw Blame History

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

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 §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

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, MASTER_INDEX.md, NEXT_STEPS_INDEX.md, root README.md, PROJECT_STRUCTURE.md.

Reference in New Issue View Git Blame Copy Permalink