2.2 Contract Map

本节深入剖析智能合约层面的交互拓扑结构。为了展示团队在合约架构设计上的专业性（Gas 优化、可升级性、安全性），OmniPact采用了 “Hub-and-Spoke（中心辐射型）” 与 “Singleton Vault（单例金库）” 模式进行描述。这符合目前最先进的 DeFi 协议（如 Uniswap V4, Balancer V2）的设计趋势。

2.2 Contract Map & Interaction Topology

OmniPact 的核心协议由一组紧密耦合但职责明确的智能合约组成。我们采用了 Hub-and-Spoke（中心辐射） 架构，其中 Registry 作为核心路由器，Vault 集中管理资产，而 Factory 负责动态扩展业务逻辑。

2.2.1 交互架构图 (Interaction Diagram)

下图展示了各核心合约组件之间的调用关系与权限控制流：

代码段

2.2.2 组件详解 (Component Breakdown)

A. OmniRegistry (The Source of Truth)

角色：系统的“大脑”与“DNS 服务器”。

  • 功能：

    • 地址解析：维护所有有效组件（Factory, Vault, DAN）的最新地址映射。

    • 白名单管理：存储经过 DAO 审计的合法 Implementation（交易模版）地址。

    • 参数控制：全局费率（Protocol Fee）、最低质押门槛等系统参数的存储地。

  • 交互：所有 OES 实例在执行关键逻辑前，必须调用 Registry.getConfig() 验证参数，确保系统状态的一致性。

B. OmniFactory (The Scaler)

角色：标准化的“印钞机”。

  • 技术实现：

    • 采用 EIP-1167 (Minimal Proxy Standard) 标准。

    • Factory 不重复部署完整的字节码，而是部署极其轻量级的 Clones (代理合约)，指向预先部署好的 Implementation 逻辑合约。

  • 优势：将部署一个新的担保合约的 Gas 成本降低 90% 以上（仅需约 45k Gas），使高频小额交易成为经济上可行的方案。

C. OmniVault (The Strongbox)

角色：Singleton 资产管理器。

  • 设计哲学：

    • OmniPact 不为每个订单单独创建一个存钱合约（这会导致资产极度碎片化且 Gas 昂贵）。

    • 相反，我们维护一个全局的 OmniVault 合约，所有用户的资金都汇集于此。

  • 内部账本 (Internal Accounting)：

    • Vault 内部维护 mapping(bytes32 escrowId => uint256 balance) 账本。

    • Flash Loan Defense：支持 ERC-3156 闪电贷标准，利用闲置资金为协议赚取被动收益（这部分收益回购 $PACT），但通过 ReentrancyGuard 严防重入攻击。

  • 权限控制：只有状态为 Active 且在 Registry 注册过的 OES 实例，才有权调用 Vault 的 transfer 函数。

D. Governance (The Controller)

角色：去中心化的管理员。

  • TimelockController：

    • 所有对 Registry 和 Vault 的管理操作（如升级合约、提取手续费）都必须经过一个 TimeLock (时间锁) 合约。

    • 延迟生效：提案通过后，需等待 48 小时才能执行。这给了社区在这个窗口期内检查代码或撤资的权利，防止“Governance Attack”。

2.2.3 关键生命周期交互 (Critical Interaction Lifecycle)

为了更清晰地说明合约间如何协作，以下是一笔标准交易的调用堆栈追踪：

  1. 初始化 (Setup):

    • 用户调用 OmniFactory.createEscrow(TemplateID, Params)。

    • Factory 使用 Clones.clone() 部署一个新的 OES 实例，并为其分配唯一的 EscrowID。

    • Factory 调用 OmniRegistry.register(EscrowID) 备案。

  2. 资金锁定 (Locking):

    • 用户对 OmniVault 进行 ERC-20 approve()。

    • 用户调用 OES 实例的 deposit()。

    • OES 实例回调 OmniVault.depositFrom(User, Amount)。

    • OmniVault 将资产从用户划转至自身，并在内部账本记账：balances[EscrowID] += Amount。

  3. 结算释放 (Settlement):

    • 条件满足（如买家确认收货），OES 实例状态变更为 Finalized。

    • OES 实例调用 OmniVault.withdrawTo(Seller, Amount)。

    • OmniVault 验证调用者是合法的 OES 实例，且账本余额充足。

    • OmniVault 执行底层的 ERC-20 transfer，将资金打入卖家钱包。

这种架构设计（Singleton Vault + Proxy Factory）代表了目前以太坊开发的最高工业标准，能够向读者传递出项目方在资金安全和Gas 优化上的极致追求。

Previous2.1 The Four-Layer StackNextOES: The Omni Escrow System