2.1 The Four-Layer Stack

OmniPact 的整体架构遵循 “Separation of Concerns” 原则。我们将协议栈自下而上划分为：结算层、核心协议层、数据隐私层、接口层。

下图展示了这一垂直架构的数据流向与逻辑控制关系：

graph TD
    subgraph L4["L4: Interface Layer (接口层)"]
        SDK[Client SDK / UI]
        API[Relayer API]
        Graph[The Graph Indexer]
    end

    subgraph L3["L3: Data & Privacy Layer (数据与隐私层)"]
        Oracle[Chainlink Oracles]
        IPFS[IPFS Storage]
        TEE[TEE / ZK-Circuits]
    end

    subgraph L2["L2: Core Protocol Layer (核心协议层)"]
        OES[OES Engine (FSM)]
        DAN[DAN Arbitration]
        Reputation[SBT Logic]
    end

    subgraph L1["L1: Settlement Layer (结算层)"]
        EVM[EVM Adapters (ETH/Arb...)]
        SVM[SVM Adapters (Solana)]
        Bridge[Cross-Chain Bridge]
    end

    L4 -->|Query/Tx| L2
    L4 -->|Read Data| L3
    L2 -->|State Update| L1
    L2 -->|Request Proof| L3
    L3 -->|Callback| L2

2.1 The Four-Layer Stack (四层协议栈)

L1: Settlement Layer (结算层)

—— 多链适配器与最终性锚定 (Multi-chain Adapters & Finality Anchoring)

L1 是协议的物理基础，负责资产的托管、转移以及交易状态的最终确认。OmniPact 不构建自己的公链，而是作为一组智能合约部署在现有的高性能区块链之上。

  • 多链适配器 (Multi-chain Adapters):

    为了实现“链不可知论”，我们在底层设计了 ISettlementAdapter 抽象接口。该接口抹平了底层虚拟机的差异：

    • EVM Adapter: 适配 Ethereum, Arbitrum, BSC, Optimism 等基于 Solidity/Vyper 的链。

    • SVM Adapter: 适配 Solana (Rust) 等并行执行环境。

    • WASM Adapter: 适配 Polkadot, Cosmos 等 WASM 环境。

  • 资产保管 (Asset Custody):

    L1 并不处理复杂的业务逻辑，只负责最“愚蠢”但最关键的任务：原子化转账 (Atomic Transfer)。资金被锁定在去中心化的 Vault Contracts 中，只有接收到 L2 传来的有效指令（附带正确的密码学签名或状态根）时，才会执行 transfer() 操作。

  • 跨链消息总线 (Cross-Chain Bus):

    利用 LayerZero 或 CCIP，L1 负责处理跨链消息的发件 (Emit) 和 收件 (Receive)，确保在 Chain A 上锁定的资金可以在 Chain B 上被安全地触发释放。

L2: Core Protocol Layer (核心协议层)

—— 业务逻辑与状态管理 (Business Logic & State Management)

L2 是 OmniPact 的“大脑”，包含了协议的核心智能合约逻辑。所有关于担保流程、仲裁投票、信誉计算的规则都驻留于此。

  • OES Engine (Omni Escrow System):

    这是一个确定性有限状态机 (FSM)。它维护着全局的担保合约注册表 (Registry) 和每个订单的状态（$S_{locked}$, $S_{delivered}$, etc.）。它定义了资金流转的规则，但不直接持有资金（资金由 L1 持有）。

  • DAN Contracts (Decentralized Arbitration Network):

    负责治理与司法逻辑。

    • Sortition Module: 执行 VRF 抽签算法，选拔仲裁员。

    • Voting Module: 处理 Commit-Reveal 投票过程，计算博弈论均衡结果。

    • Incentive Module: 自动分配仲裁费和执行罚没 (Slashing)。

  • Logic Upgradeability (逻辑可升级性):

    采用 OpenZeppelin UUPS (Universal Upgradeable Proxy Standard) 代理模式。这允许我们在不迁移用户资金（L1）和数据（L3）的情况下，通过 DAO 投票修复 L2 的逻辑漏洞或优化算法。

L3: Data & Privacy Layer (数据与隐私层)

—— 链下计算与可验证存储 (Off-Chain Compute & Verifiable Storage)

由于区块链本身的存储昂贵且公开，OmniPact 引入了 L3 来处理大数据量、隐私敏感或需要连接现实世界的数据交互。

  • Decentralized Storage (IPFS/Arweave):

    • 用途: 存储非结构化的大型数据，如合同 PDF、设计稿原件、仲裁证据图片。

    • 机制: 仅将文件的 CID (Content Identifier) 哈希值存储在 L2 链上。这保证了数据的不可篡改性，同时降低了 Gas 成本。

  • Oracles (预言机网络):

    • 用途: 获取“链下真相”。

    • 集成: 集成 Chainlink Functions 和 Automation。例如，自动读取 FedEx API 的物流状态，或监听 IoT 设备的经纬度信号，作为 L2 状态机流转的触发器。

  • Privacy Compute (TEE & ZK):

    • TEE (Trusted Execution Environment): 利用 Intel SGX 硬件飞地处理极其敏感的数据（如私钥分片、未加密的商业机密）。

    • ZK-Circuits (零知识电路): 用于 zk-KYC 和 zk-Reputation。在不暴露用户原始数据（如护照号）的前提下，向 L2 生成一个数学证明 ，证明用户符合合规要求。

L4: Interface Layer (接口层)

—— 开发者体验与访问网关 (Developer Experience & Access Gateway)

L4 是用户和外部应用程序与协议交互的门户。它将底层复杂的合约逻辑抽象为易于使用的 API 和 SDK。

  • OmniPact SDK (TypeScript/Python/Go):

    为开发者封装好的代码库。开发者无需直接编写 Solidity 调用，只需调用 omnipact.createEscrow({...}) 即可集成担保功能。SDK 内置了 IPFS 上传、数据加密和钱包签名逻辑。

  • The Graph Subgraphs (索引层):

    由于直接从区块链节点查询历史数据效率极低，我们部署了 GraphQL Subgraphs。

    • 功能: 索引所有的 OES 事件（如 EscrowCreated, DisputeRaised）。

    • 用途: 前端 DApp 可以毫秒级获取“某用户的所有历史订单”或“当前处于争议中的案件列表”。

  • Relayer API (中继服务):

    为支持 “无 Gas 交易 (Gasless Tx)” 和 “账户抽象 (Account Abstraction)”，L4 提供中继服务。用户只需对消息签名（EIP-712），中继器负责上链并代付 Gas（费用从担保金额中扣除），极大地降低了 Web2 用户的准入门槛。

通过四层架构的有机组合，OmniPact 实现了结算的安全性（L1）、逻辑的严密性（L2）、数据的扩展性（L3）以及使用的便捷性（L4）的完美统一。

PreviousSystem Architecture & TopologyNext2.2 Contract Map