Files
proxmox/docs/11-references/diagrams/global-arbitrage-engine.dot
defiQUG e4c9dda0fd
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
chore: update submodule references and documentation
- Marked submodules ai-mcp-pmm-controller, explorer-monorepo, and smom-dbis-138 as dirty to reflect recent changes.
- Updated documentation to clarify operator script usage, including dotenv loading and task execution instructions.
- Enhanced the README and various index files to provide clearer navigation and task completion guidance.

Made-with: Cursor
2026-03-04 02:03:08 -08:00

222 lines
6.6 KiB
Plaintext

digraph GlobalArbitrageEngine {
rankdir=LR;
compound=true;
labelloc="t";
fontsize=18;
fontname="Inter";
node [shape=box, style="rounded", fontsize=11, fontname="Inter"];
edge [fontsize=10, fontname="Inter"];
// =========================
// ANCHOR / NUMERAIRE LAYER
// =========================
subgraph cluster_anchor {
label="Anchor / Numeraire";
style="rounded";
XAU_ORACLE [label="XAU Oracle\n(ETH/XAU pricing)"];
ORACLE_AGG [label="OracleAggregator"];
ORACLE_PROXY [label="OracleProxy"];
PRICE_KEEPER [label="PriceFeedKeeper"];
MULTICALL [label="Multicall"];
LEDGER [label="Ledger\n(XAU-denominated accounting)"];
VAULT_FACTORY [label="VaultFactory"];
XAU_ORACLE -> ORACLE_AGG;
ORACLE_PROXY -> ORACLE_AGG;
PRICE_KEEPER -> ORACLE_AGG;
MULTICALL -> ORACLE_AGG;
ORACLE_AGG -> LEDGER;
VAULT_FACTORY -> LEDGER;
}
// =========================
// HUB: CHAIN 138
// =========================
subgraph cluster_hub {
label="Hub: Chain 138 (Liquidity + Settlement)";
style="rounded";
C138 [shape=oval, label="Chain 138\n(DBIS / DeFi Oracle)"];
// Tokens
CUSDT [label="cUSDT"];
CUSDC [label="cUSDC"];
WETH [label="WETH / WETH10\n(Bridge Rail)"];
// Liquidity
DODO_INT [label="DODOPMMIntegration"];
DODO_PROV [label="DODOPMMProvider"];
POOL_CUSDT_CUSDC [label="DODO PMM Pool\ncUSDT/cUSDC"];
POOL_CUSDT_USDT [label="DODO PMM Pool\ncUSDT/USDT (official addr)"];
POOL_CUSDC_USDC [label="DODO PMM Pool\ncUSDC/USDC (official addr)"];
// Reserve / Vault / Settlement
RESERVE_SYS [label="ReserveSystem"];
RESERVE_INT [label="ReserveTokenIntegration"];
BRIDGE_VAULT [label="BridgeVault"];
LIQUIDATION [label="Liquidation"];
// Registry / Compliance
TOKEN_FACTORY [label="TokenFactory"];
TOKEN_IMPL [label="TokenImplementation"];
TOKEN_REG [label="TokenRegistry"];
COMPLIANCE_REG [label="ComplianceRegistry"];
POLICY_MGR [label="PolicyManager"];
DEBT_REG [label="DebtRegistry"];
FEE_COL [label="FeeCollector"];
// Governance / Deterministic
GOV_CTRL [label="GovernanceController"];
UAR [label="UniversalAssetRegistry\n(proxy + deterministic)"];
CREATE2 [label="CREATE2Factory"];
// Channel / Mirror / Settlement
MIRROR_REG [label="MirrorRegistry"];
MIRROR_MGR [label="MirrorManager"];
TX_MIRROR [label="TransactionMirror"];
ADDR_MAP [label="AddressMapper"];
PAYMENT_CH [label="PaymentChannelManager"];
STATE_CH [label="GenericStateChannelManager"];
MERCH_SETTLE [label="MerchantSettlementRegistry"];
WITHDRAW_ESC [label="WithdrawalEscrow"];
LOCKBOX [label="Lockbox138"];
// Internal edges
TOKEN_FACTORY -> TOKEN_IMPL;
TOKEN_FACTORY -> TOKEN_REG;
TOKEN_REG -> COMPLIANCE_REG;
POLICY_MGR -> COMPLIANCE_REG;
DEBT_REG -> LEDGER;
LIQUIDATION -> LEDGER;
FEE_COL -> BRIDGE_VAULT;
DODO_PROV -> DODO_INT;
DODO_INT -> POOL_CUSDT_CUSDC;
DODO_INT -> POOL_CUSDT_USDT;
DODO_INT -> POOL_CUSDC_USDC;
CUSDT -> DODO_INT [label="swap"];
CUSDC -> DODO_INT [label="swap"];
RESERVE_SYS -> RESERVE_INT;
RESERVE_INT -> CUSDT;
RESERVE_INT -> CUSDC;
MIRROR_MGR -> MIRROR_REG;
TX_MIRROR -> MIRROR_MGR;
ADDR_MAP -> MIRROR_MGR;
PAYMENT_CH -> MERCH_SETTLE;
STATE_CH -> MERCH_SETTLE;
WITHDRAW_ESC -> MERCH_SETTLE;
LOCKBOX -> WITHDRAW_ESC;
GOV_CTRL -> UAR;
GOV_CTRL -> CREATE2;
// Tie hub to anchor
LEDGER -> C138 [style=dashed, label="valuation"];
}
// =========================
// BRIDGE LAYER
// =========================
subgraph cluster_bridge {
label="Bridge Layer";
style="rounded";
BRIDGE_ORCH [label="BridgeOrchestrator"];
UCCIP [label="UniversalCCIPBridge"];
CCIP_ROUTER [label="CCIP Router"];
CCIP_SENDER [label="CCIP Sender"];
CCIP_RECEIVER [label="CCIP Receiver"];
CCIP_WETH9 [label="CCIPWETH9Bridge"];
CCIP_WETH10 [label="CCIPWETH10Bridge"];
ALLTRA_ADAPTER [label="AlltraAdapter\n(138 ↔ 651940)"];
BRIDGE_ORCH -> UCCIP;
UCCIP -> CCIP_ROUTER;
CCIP_SENDER -> CCIP_ROUTER;
CCIP_RECEIVER -> CCIP_ROUTER;
CCIP_WETH9 -> CCIP_ROUTER;
CCIP_WETH10 -> CCIP_ROUTER;
BRIDGE_VAULT -> CCIP_WETH9;
BRIDGE_VAULT -> CCIP_WETH10;
BRIDGE_ORCH -> ALLTRA_ADAPTER;
}
// =========================
// EDGE CHAINS (13 total)
// =========================
subgraph cluster_edges {
label="Edge Chains (Liquidity Surfaces)";
style="rounded";
ETH [shape=oval, label="Ethereum\n(chain 1)"];
BSC [shape=oval, label="BSC\n(chain 56)"];
POL [shape=oval, label="Polygon\n(chain 137)"];
OPT [shape=oval, label="Optimism\n(chain 10)"];
ARB [shape=oval, label="Arbitrum\n(chain 42161)"];
AVAX [shape=oval, label="Avalanche\n(chain 43114)"];
BASE [shape=oval, label="Base\n(chain 8453)"];
GNO [shape=oval, label="Gnosis\n(chain 100)"];
CRO [shape=oval, label="Cronos\n(chain 25)"];
CELO [shape=oval, label="Celo\n(chain 42220)"];
WEMIX [shape=oval, label="Wemix\n(chain 1111)"];
ALLTRA [shape=oval, label="ALL Mainnet\n(chain 651940)"];
// Conceptual edge pools
EDGE_POOL_1 [label="Edge Pools\n(cW*/USDC, cW*/USDT)\n(design; deploy per chain)"];
ETH -> EDGE_POOL_1 [style=dashed];
BSC -> EDGE_POOL_1 [style=dashed];
POL -> EDGE_POOL_1 [style=dashed];
OPT -> EDGE_POOL_1 [style=dashed];
ARB -> EDGE_POOL_1 [style=dashed];
AVAX -> EDGE_POOL_1 [style=dashed];
BASE -> EDGE_POOL_1 [style=dashed];
GNO -> EDGE_POOL_1 [style=dashed];
CRO -> EDGE_POOL_1 [style=dashed];
CELO -> EDGE_POOL_1 [style=dashed];
WEMIX -> EDGE_POOL_1 [style=dashed];
}
// =========================
// CROSS-CHAIN CONNECTIONS
// =========================
// Hub <-> bridge orchestrator
C138 -> BRIDGE_ORCH [lhead=cluster_bridge, label="route orchestration"];
WETH -> CCIP_WETH9 [lhead=cluster_bridge, label="bridge rail"];
WETH -> CCIP_WETH10 [lhead=cluster_bridge, label="bridge rail"];
// CCIP connectivity to edges (conceptual)
CCIP_ROUTER -> ETH [label="CCIP"];
CCIP_ROUTER -> BSC [label="CCIP"];
CCIP_ROUTER -> POL [label="CCIP"];
CCIP_ROUTER -> OPT [label="CCIP"];
CCIP_ROUTER -> ARB [label="CCIP"];
CCIP_ROUTER -> AVAX [label="CCIP"];
CCIP_ROUTER -> CRO [label="CCIP"];
CCIP_ROUTER -> BASE [style=dashed, label="CCIP/Config"];
CCIP_ROUTER -> GNO [style=dashed, label="CCIP/Config"];
CCIP_ROUTER -> CELO [style=dashed, label="CCIP/Config"];
CCIP_ROUTER -> WEMIX [style=dashed, label="CCIP/Config"];
// Alltra adapter connectivity
ALLTRA_ADAPTER -> ALLTRA [label="AlltraAdapter"];
// Anchor link
LEDGER -> XAU_ORACLE [style=dashed, label="XAU ref"];
}