# Developer Platform

Welcome to your team’s developer platform

## Welcome

#### Welcome to the OmniPact Protocol

Welcome to the authoritative guide to the OmniPact protocol — this is where the cross-chain architecture and decentralized trust mechanism converge.

Please use this as a map to explore in depth how OmniPact reshapes the spirit of contract and the trust connector of Web3 through code, defines the collaboration rules of the next-generation Internet, and unleashes unprecedented potential for value creation.

> We compile the contractual spirit of the real world into the irreversible universal language of Web3.

### Let's start exploring.

<table data-view="cards"><thead><tr><th></th><th data-type="content-ref"></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td><strong>Visit the official website</strong></td><td><a href="https://www.omnipact.io/">https://www.omnipact.io/</a></td><td><a href="/spaces/lQbOblKT1FvR9cf7VfK7">/spaces/lQbOblKT1FvR9cf7VfK7</a></td><td><a href="/files/ynTx9K9pRfrv36J69xHE">/files/ynTx9K9pRfrv36J69xHE</a></td></tr><tr><td><strong>Follow our X</strong></td><td><a href="https://x.com/OmniPactDAO">https://x.com/OmniPactDAO</a></td><td><a href="/spaces/lQbOblKT1FvR9cf7VfK7">/spaces/lQbOblKT1FvR9cf7VfK7</a></td><td><a href="/files/IanqVHTh5CExhIDSJ7n2">/files/IanqVHTh5CExhIDSJ7n2</a></td></tr><tr><td><strong>Join Telegram</strong></td><td><a href="https://t.me/addlist/yww-_328oDtmODY9">https://t.me/addlist/yww-_328oDtmODY9</a></td><td><a href="/spaces/XYYK5banRfMlmFlXrGj3">/spaces/XYYK5banRfMlmFlXrGj3</a></td><td><a href="/files/eS6kowFOiITJnJP01uNG">/files/eS6kowFOiITJnJP01uNG</a></td></tr><tr><td><strong>Follow Facebook</strong></td><td><a href="https://www.facebook.com/omnipact">https://www.facebook.com/omnipact</a></td><td></td><td><a href="/files/MuZY1ZBtvpYuxTs4QH0Y">/files/MuZY1ZBtvpYuxTs4QH0Y</a></td></tr><tr><td><strong>Follow YouTube</strong></td><td><a href="https://youtube.com/@omnipact">https://youtube.com/@omnipact</a></td><td></td><td><a href="/files/hWSRqcuUpQrB2T6hOWWJ">/files/hWSRqcuUpQrB2T6hOWWJ</a></td></tr><tr><td><strong>Join Discord</strong></td><td><a href="https://discord.gg/Y8dEetB6">https://discord.gg/Y8dEetB6</a></td><td></td><td><a href="/files/ha1wkLu03T1SLgAbrDko">/files/ha1wkLu03T1SLgAbrDko</a></td></tr></tbody></table>

<h3 align="center">A trading market serving over 1 billion users worldwide</h3>

<p align="center">Chains carry all things, and information connects the world</p>

<p align="center">Building a trustless value exchange network based on mathematical proofs, cryptographic consensus, and game theory incentives.</p>

{% columns %}
{% column %}

#### OmniPact is rewriting the rules.

Setting up your first trading contract should be the easiest part of getting started. With OmniPact's clear interface and quick, automated contract creation, you can complete the setup and start trading in minutes, not hours.

No guessing, no complicated operations—quickly complete your first successful trade.

<a href="https://omnipact.io/" class="button primary" data-icon="rocket-launch">Get started</a> <a href="https://docs.omnipact.io/beginners-guide/quick-guide" class="button secondary" data-icon="book-open-reader">Reading Guide</a>
{% endcolumn %}

{% column %}
{% code title="index.js" overflow="wrap" %}

```javascript
// 🚀 Initiate your first trust transaction
import { OmniTrust } from "@omnitrust/sdk";

// Initialize the connection - no API key required, just your wallet
const ot = await OmniTrust.init({
  network: "ethereum",  // or "polygon", "arbitrum"
  environment: "mainnet" // "testnet" Used for testing
});
// Create an NFT secured transaction

```

{% endcode %}
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}

<figure><img src="/files/ksu79dsIb09oDSwrs9VX" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

#### Visit GitHub to view open source

If you are a developer or technical personnel, you can check our security status through GitHub.

<a href="https://github.com/OmniPactDAO" class="button primary" data-icon="github">GitHub</a>&#x20;
{% endcolumn %}
{% endcolumns %}


# Interaction Guide

PC version

## Official Operation Guide for OmniPact Dapp

{% hint style="info" %}
**Please run it on the BEP20 chain and prepare a small amount of BNB as GAS.**
{% endhint %}

### **I. Wallet Connection**

**1.Access the platform**

* Enter the OmniPact Dapp invitation code in a computer browser or mobile wallet.
* Click the "Connect Wallet" button in the upper right corner of the page to start connecting the wallet

<figure><img src="/files/iCkb7FmzInhE4WbqjKgK" alt=""><figcaption></figcaption></figure>

#### **2.Select Wallet**

* Select the wallet type you want to connect to from the pop-up window (supports various mainstream wallets).
* Take OKX Wallet as an example: click "Connect" and confirm the connection in the wallet pop-up window.
* If you have not yet installed a wallet, you may select the corresponding wallet and complete the download and installation by following the instructions.

<figure><img src="/files/spvolh5wq5MCUfPZH4Jj" alt=""><figcaption></figcaption></figure>

#### **3.Confirm Authorization**

* Follow the wallet prompts and click "Confirm" to confirm the connection authorization.
* Waiting for confirmation of the wallet connection status

<figure><img src="/files/ZtmXn53ldTgNRPVx4GrB" alt=""><figcaption></figcaption></figure>

#### 4.Complete the binding

* After the wallet connection is successful, click "Confirm" again.
* Finally, click "Accept & Bind" to complete the binding of the wallet address to the account.

<figure><img src="/files/SznO0zkV81h0oqCssLZp" alt=""><figcaption></figcaption></figure>

### II. Obtain Test Tokens

#### 5.Enter the homepage

* Click the "HOME" button in the bottom navigation bar to enter the main page of the platform.

<figure><img src="/files/Zng8PoQsBQi1Ag1YUVRV" alt=""><figcaption></figcaption></figure>

#### 6.Claim test token

* Click the "Claim Test Token" button to start claiming test tokens.

<figure><img src="/files/Cd0XcpJWI6JjFiPz5mtH" alt=""><figcaption></figcaption></figure>

#### 7.Select the water collection plan

* On the reward collection page, select the first option.
* Click "Claim" to initiate a claim request

<figure><img src="/files/EV17hQl6Vn1aX03ONMZg" alt=""><figcaption></figcaption></figure>

#### 8.Confirm Transaction

* Click "Confirm" to confirm the collection operation
* Waiting for on-chain confirmation

<figure><img src="/files/lArxbkm9Ms2LnZq4SQif" alt=""><figcaption></figcaption></figure>

#### 9.Successfully received

* The page prompts that the test token has been successfully claimed, and you can start using it now.

<figure><img src="/files/Xmap2dtnp2KwWRWorhS6" alt=""><figcaption></figcaption></figure>

### III. Establishment of the Agreement

#### 10.Enter the creation page

* Click the "Create" button in the bottom navigation bar to enter the agreement creation page.

<figure><img src="/files/KSXvh9hpKdx4xRLa6K9t" alt=""><figcaption></figcaption></figure>

#### 11.Select the creation type

* Click the first option "Create Agreement" to enter the configuration page.
* The second option "Join Contract" is generally used for the recipient to confirm the agreement (when your address has been added by the other party upon creating the agreement, you will automatically see the agreement on the order page).

<figure><img src="/files/CGKyY0mvAJKAdnhWMj19" alt=""><figcaption></figcaption></figure>

#### 12.Set Roles and Types

* Select "I am Seller"
* Select "Airdrop Interaction" in the interaction type.

<figure><img src="/files/bA2WVUWwsGb5fBVDPYZu" alt=""><figcaption></figcaption></figure>

#### 13.Fill in the agreement information

* Enter the wallet address of the counterparty you are interacting with.
* Fill in the detailed description (can be filled in freely, for testing purposes)

<figure><img src="/files/0igkIikC1kANtzZ4TN0q" alt=""><figcaption></figcaption></figure>

#### 14.Set Amount

* Make sure there are enough test coins in your account (if not enough, you can return to the faucet page to claim them).
* Select "tPact-USD" as the settlement token
* Enter any amount (test tokens have no real value and can be claimed at any time)

<figure><img src="/files/sT8F06CfGmowyV5SE45V" alt=""><figcaption></figcaption></figure>

#### 15.Create a protocol

* Click "Create Protocol Order" to create the protocol.
* Pay the Gas fee required to create the contract
* Waiting for on-chain confirmation

<figure><img src="/files/m6kklfrubY7LJa7feFOD" alt=""><figcaption></figcaption></figure>

### IV. Completion of Transaction

#### 16.Locked Margin

* After the agreement is created, click "Lock Deposit (10 tPact-USD)"
* Confirm the locked margin amount

<figure><img src="/files/DkAqqinA6mE9BPIDOFWY" alt=""><figcaption></figcaption></figure>

#### 17.Confirm Lock

* Click Confirm to complete the lock

<figure><img src="/files/D2n0ghoZUSm6gITuGA5O" alt=""><figcaption></figcaption></figure>

#### 18.Pending confirmation

* The system is waiting for the other party to confirm the transaction.
* The system will automatically proceed to the next step after the status is updated.

<figure><img src="/files/Nb28t6MEAZUatuO1atqe" alt=""><figcaption></figcaption></figure>

#### 19.Transaction Completed

* The transaction was successfully completed.
* Automatically receive airdrop rewards

<figure><img src="/files/Mqiujc0lOWFkUVf1Ck58" alt=""><figcaption></figcaption></figure>

### V. Task Center and Rewards

#### 20.Enter the Task Center

* Tap "Me" in the bottom navigation bar to enter the personal center.
* Select "Task Center" to view available tasks.

<figure><img src="/files/eKJzurp9oqKwlG9ZpG2Y" alt=""><figcaption></figcaption></figure>

#### 21.Complete tasks to get rewards

* Follow the official X (Twitter) account
* Join the official Discord community
* You will receive the corresponding rewards upon successful binding.

<figure><img src="/files/37TtxIt7gmRTb3DVRAvn" alt=""><figcaption></figcaption></figure>

### VI. Important Function Instructions

#### Twitter binding

* Binding a Twitter account is simple and convenient.
* It will serve as an important KYC authentication credential in the future.

<figure><img src="/files/hKqpSV3BiZL4QOaqWTa7" alt=""><figcaption></figcaption></figure>

#### Data View

* You can view the airdrop details in the Ps Center.
* You can view your personal invitation records and reward status.

<figure><img src="/files/OiBsi0nNJaf3QuOmBhfm" alt=""><figcaption></figcaption></figure>

#### Order Management

* All pending agreements can be viewed on the order page.
* When others create an agreement and fill in your address, the relevant orders will be automatically displayed on this page.
* All agreements you have created will also be managed uniformly here.

<figure><img src="/files/bGuiyWzsgskUV1mpaphc" alt=""><figcaption></figcaption></figure>

***

{% hint style="info" %}
**Kindly Reminder**：During your participation in the OmniPact interactive test, it is recommended that you create a new wallet to avoid unnecessary misunderstandings caused by personal unauthorized authorization. All OmniPact contracts have undergone security audits and are open source. All test tokens are for functional testing purposes only and do not have any actual value. If you have any questions, please contact us via the official community.
{% endhint %}

{% hint style="success" %}
PS obtained through airdrop is equivalent to PACT. The exchange of PS for PACT will be officially announced.
{% endhint %}


# OmniPact Dapp Mobile Operation Guide

Mobile terminal (smartphone)

{% hint style="info" %}
**Please run it on the BEP20 chain and prepare a small amount of BNB as GAS.**
{% endhint %}

* In the mobile wallet, enter the official address of the OmniPact Dapp
* Click the "Connect Wallet" button in the upper right corner of the page to start connecting your wallet.

<figure><img src="/files/znC7rQ6m1whImR8zP0XE" alt="" width="145"><figcaption></figcaption></figure>

***

* Select the wallet type you want to connect to from the pop-up window (supports various mainstream wallets).
* Take OKX Wallet as an example: click "Connect" and confirm the connection in the wallet pop-up window.
* If you have not yet installed a wallet, you may select the corresponding wallet and complete the download and installation by following the instructions.
* Follow the wallet prompts and click "Confirm" to confirm the connection authorization.
* Waiting for the confirmation of the wallet connection status

<figure><img src="/files/6EjygYavEyDIraxMFG3m" alt="" width="144"><figcaption></figcaption></figure>

***

* Click the "HOME" button in the bottom navigation bar to enter the main page of the platform.
* Click the "Claim Test Token" button to start claiming test tokens.

<figure><img src="/files/i3vFYQ6yRRdwNrFYodj2" alt="" width="146"><figcaption></figcaption></figure>

***

* On the reward collection page, select the first option.
* Click "Claim" to initiate a claim request

<figure><img src="/files/nfGlpxxF3VYy2Tm6hSFM" alt="" width="144"><figcaption></figcaption></figure>

***

* Click "Confirm" to confirm the collection operation
* Waiting for on-chain confirmation
* The page indicates that the test token has been successfully claimed, and you can start using it now.
* Copy the test token contract and add it to your wallet.

<figure><img src="/files/vBn7sDd4Mg9gvUX6rpfj" alt="" width="145"><figcaption></figcaption></figure>

***

* Click on "Create" in the bottom navigation bar to enter the agreement creation page.
* Click the first option "Create Protocol" to enter the configuration page.
* The second option "Join Contract" is generally used for the recipient to confirm the agreement (when the other party has added your address while creating the agreement, you will automatically see the agreement on the order page).

<figure><img src="/files/eme62R3zwdFbPCoi83yn" alt="" width="144"><figcaption></figcaption></figure>

***

1. Select "I am Seller" (Seller) (If you have reached an agreement with the other party, you may also select Buyer; this option must match the actual situation.)
2. Select "Airdrop Interaction" in the interaction type.
3. Enter the wallet address of the counterparty you are interacting with

<figure><img src="/files/BzdzdA3TPhiLn6XDSZ69" alt="" width="142"><figcaption></figcaption></figure>

***

4.5. Fill in the detailed description (can be filled in freely, for testing purposes)

Make sure there are enough test coins in your account (if not, you can return to the faucet page to claim them).

6. Select "tPact-USD" as the settlement token

<figure><img src="/files/cLahlrGx1itTT0yki1MA" alt="" width="142"><figcaption></figcaption></figure>

***

7. Enter any amount (Test tokens have no real value and can be claimed at any time)

* ·Click "Create Protocol Order" to create the protocol
* Pay the Gas fee required to create the contract
* Waiting for on-chain confirmation

<figure><img src="/files/kJDdIObeQmoeneHpZF2b" alt="" width="144"><figcaption></figcaption></figure>

***

* After the agreement is created, click "Appove BEP20"
* Confirm the locked margin amount

<figure><img src="/files/XRkauEZapEtROatr1wiA" alt="" width="144"><figcaption></figcaption></figure>

***

* The system is waiting for the other party to confirm the transaction.
* It will automatically proceed to the next step after the status is updated.

<figure><img src="/files/8wojlghKilnQ7bk2QaGA" alt="" width="143"><figcaption></figcaption></figure>

***

### (Buyer's perspective)

<div align="left"><figure><img src="/files/593l7MkjX7utP0CRgfxf" alt="" width="155"><figcaption></figcaption></figure> <figure><img src="/files/AVQYoyNqUHdUrijKbfIJ" alt="" width="157"><figcaption></figcaption></figure> <figure><img src="/files/1pZCeFAIK9peTBnfGzXd" alt="" width="156"><figcaption></figcaption></figure></div>

***

* The transaction has been successfully completed.
* Automatically receive airdrop rewards

<figure><img src="/files/UKiH79jNArzNSERgl9Ng" alt="" width="142"><figcaption></figcaption></figure>

***

* Click the "Me" in the bottom navigation bar to enter the personal center.
* Select "Task Center" to view available tasks.

<figure><img src="/files/T8ry10P4BsQN9PXeJg8Y" alt="" width="145"><figcaption></figcaption></figure>

***

* Follow the official X (Twitter) account
* Join the official Discord community
* You will receive the corresponding rewards upon successful binding.

<figure><img src="/files/GnbVl0ZE95LBctlPH6y2" alt="" width="143"><figcaption></figcaption></figure>

***

* Binding a Twitter account is simple and convenient.
* It will serve as an important KYC authentication credential in the future.

<figure><img src="/files/I1DhYUP7NdwVQShw57sC" alt="" width="156"><figcaption></figcaption></figure>

***

* Check the airdrop details in "PS"
* You can view your personal invitation records and rewards in the "Community" section.

<figure><img src="/files/Ejca44Sn3Kf6eROjYoC4" alt="" width="144"><figcaption></figcaption></figure>

***

* All pending agreements can be viewed on the order page.
* When others create an agreement and fill in your address, the relevant orders will be automatically displayed on this page.
* All agreements you have created will also be managed uniformly here.

<figure><img src="/files/ttupuhuC4h46zlx0bfoP" alt="" width="144"><figcaption></figcaption></figure>

***

{% hint style="warning" %}
**Kindly Reminder**：During your participation in the OmniPact interactive test, it is recommended that you create a new wallet to avoid unnecessary misunderstandings caused by personal unauthorized authorization. All OmniPact contracts have undergone security audits and are open source. All test tokens are for functional testing purposes only and do not have any actual value. If you have any questions, please contact us via the official community.
{% endhint %}

{% hint style="success" %}
PS obtained through airdrop is equivalent to PACT. The exchange of PS for PACT will be officially announced.
{% endhint %}


# Quick Guide

<figure><img src="/files/IanqVHTh5CExhIDSJ7n2" alt=""><figcaption></figcaption></figure>

* User Guides (User Guides):
* How to connect a wallet?
* How to create the first secured transaction? (Step-by-step graphic tutorial)
* How to perform obligations as a buyer/seller?
* How to initiate a dispute and provide evidence?
* Fees Structure (Rate Structure):
* Agreement service fee (e.g., 0.5%).
* Arbitration fee standards.
* Explanation of Gas Fees.

Supported Chains: List the supported public chains (ETH, BNB, Arb...)


# Create a wallet

Before you start using OmniPact, you first need to create a wallet that supports Binance Smart Chain (BSC). Wallets are available on both computers and mobile phones. Please choose the wallet application that best suits you.

{% hint style="danger" %}
**When you're setting up a wallet, be sure to:**

* ✅ **Download and install only the latest version from an official source.**
* ✅ **Follow the setup guide carefully.**
* ✅ **Safely back up your recovery phrases.**
* ❌ **NEVER share your recovery phrases with anyone, under any circumstances.**
* ❌ **NEVER input your recovery phrase to a website or app, other than your wallet app.**
  {% endhint %}

### Smartphone/Mobile or Desktop wallet?

Mobile device wallets and desktop-based wallets have different strengths and weaknesses. Consider which fits your needs better to help decide which type of wallet to use.

|                                   | Mobile | Desktop |
| --------------------------------- | :----: | :-----: |
| Use anywhere                      |    ✅   |    ➖    |
| Easy to use                       |    ✅   |    ➖    |
| More secure                       |    ➖   |    ✅    |
| Accessibility friendly            |    ➖   |    ✅    |
| Damage/loss/theft resistant       |    ➖   |    ✅    |
| Power/connection outage resistant |    ✅   |    ➖    |

#### **Smartphone/Mobile wallets** <a href="#smartphone-mobile-wallets" id="smartphone-mobile-wallets"></a>

Smartphone/Mobile wallets allow you to access your crypto almost anywhere. Wallets are available on both Android and iOS devices.

#### Which mobile wallet should I choose?

This comparison table gives an overview of the most popular mobile wallets used with PancakeSwap.

|                                                                   | MetaMask | Coinbase Wallet | SafePal | Trust Wallet | Token Pocket |
| ----------------------------------------------------------------- | -------- | --------------- | ------- | ------------ | ------------ |
| BNB Smart Chain support                                           | ⚠️       | ✅               | ✅       | ✅            | ✅            |
| Built-in DApp browser                                             | ➖        | ✅               | ✅       | ✅            | ✅            |
| Hardware wallet compatible                                        | ✅        | ✅               | <p>✅    |              |              |
| <br>(Only SafePal)</p>                                            | ➖        | ➖               |         |              |              |
| Open source (auditability)                                        | ✅        | ✅               | ➖       | ✅            | ✅            |
| <p>Interact with BscScan Directly</p><p>(for advanced users!)</p> | ✅        | ➖               | ➖       | ➖            | ➖            |

⚠️ Requires some setup

You can find more detailed information about each wallet, as well as download links and installation guides (please be careful to distinguish genuine from fake when downloading).


# Get BEP20 Tokens

The native tokens of BNB Smart Chain (BSC) are **BEP20**.

To do most things on BSC, you will need to pay gas, which comes in the form of BEP20 BNB.

You will also need the BEP20 version of any token you want to trade, stake etc. on BSC.

You can go a few ways about converting your tokens to BEP20, but here are the ones we recommend:

| 💰 Binance                                                                                                                    | 🔒 SafePal                                                                                                          | 💰 OKX                                                                                                              |
| ----------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| **Binance.com**                                                                                                               | **SafePal**                                                                                                         | **OKX.com**                                                                                                         |
| You can withdraw tokens as BEP20 via your Binance account (if you have one). Bear in mind you need an account to do so.       | You don't need an account, or to register etc. Execute cross-chain swaps directly from your wallet.                 | You can withdraw tokens as BEP20 via your OKX account (if you have one). Bear in mind you need an account to do so. |
| 📖 [Here's a quick guide they made to help you out.](https://www.binance.com/en/support/faq/85a1c394ac1d489fb0bfac0ef2fceafd) | 📖 [Here's a quick guide they made to help you out.](https://docs.safepal.io/safepal-app/cross-chain-swap-tutorial) | 📖 [Here's a quick guide they made to help you out.](https://okx.com/)                                              |

<br>


# About OmniPact

### The Genesis

#### The evolution of trust begins with code

For thousands of years, the cornerstone of commercial civilization has been "trust".

From the barter system in the tribal era, to gold and contracts in the Age of Discovery, and then to banks and legal intermediaries in modern finance. In order to reach transactions, humans have to pay a high cost of trust—intermediary fees, time, privacy, and even freedom.

But what if trust no longer requires an intermediary?

In 2008, Bitcoin proved to the world that "currency" can be decentralized;

In 2015, Ethereum proved to the world that "contracts" can be automated;

In 2026, OmniPact proved to the world that business itself can be trustless.

We were born amid the financial boom of Web3.0, yet our gaze is fixed on a broader frontier—the exchange of value in the real world. We believe that blockchain should not be merely an isolated financial island; instead, it ought to become a digital continent connecting all things in the physical world.

OmniPact came into being. We are not a traditional company; we are a protocol built on mathematics, game theory, and code.

***

### Our Mission

Building the TCP/IP for Boundless Commerce

OmniPact has only one mission:

Eliminate transaction frictions, enabling any two strangers (or machines) worldwide to safely complete value exchange without needing to know each other or having third-party guarantees.

We are committed to solving the "last mile" problem in the blockchain field - the commercial oracle problem. Through our original OES state machine and DAN arbitration network, we connect cold code with the complex real world.

* We are a bridge connecting on-chain capital and off-chain assets.
* We are a court that replaces judges' subjective rulings with game theory.
* We are the shield, protecting every transaction from fraud and default.

***

### Our Philosophy

#### Believe in codes, respect humanity

The design philosophy of OmniPact is rooted in three core principles:

#### <sub>1.Neutrality is Justice</sub>

The protocol takes no stance. Whether you are selling a used car, a code service, or cross-border bulk commodities. As long as it conforms to mathematical logic, OmniPact will provide you with guarantees. Just as the TCP/IP protocol transmits information, we transmit trust.

#### 2.Code is Law, Consensus is Truth&#x20;

We firmly believe in the certainty of mathematics. 99% of transactions should be automatically executed by smart contracts, which is extremely efficient; for the 1% of complex disputes, we believe that decentralized social consensus (Schelling Point) is closer to objective truth than a centralized dictator.

**3. Sovereignty First**&#x20;

At OmniPact, your reputation does not belong to Web2; it belongs only to you. Your transaction data is stored encrypted, and your identity is protected by zero-knowledge proofs. We return control of data to users.

***

### The Builders

#### Decentralized geeks from around the world

OmniPact was initially initiated by a group of cryptographers, economists, and senior engineers at \[Location/Hackathon Name]. Today, it has evolved into a global DAO (Decentralized Autonomous Organization).

We don't have a CEO; we only have contributors.

We have no headquarters; the network is our territory.

We are inheritors of the Bitcoin spirit and pioneers in laying the foundation for Web3 business infrastructure. We build trust in code and seek the future in consensus.

***

### Join the Revolution

The wheel of history is shifting from "institution-based trust" to "code-based trust."

OmniPact is not just a protocol; it is a ticket to the new business civilization.

Let’s Escrow Everything.

Let us guarantee everything.

***

> OmniPact Protocol — *In Code We Trust.*


# Mission & Vision

### 🌏 OmniPact Mission and Vision

> Trust is the new Code. &#x20;

***

### 1. Our Vision

—— What kind of world do we want to make?

> Building the "Decentralized Trust Infrastructure (The Trust Layer)" for the Web3 global value network.

We envision such a future:

In the digital world, trust is no longer a scarce, expensive interpersonal relationship that relies on centralized giants; instead, it has become a public infrastructure that can be accessed and used at any time, just like water and electricity.

In this future, any two individuals who do not know each other—whether it is a buyer in New York or a developer in Nairobi—can exchange value safely, freely, and with confidence without any intermediaries (such as banks, lawyers, or platforms).

OmniPact is committed to becoming the ultimate bridge connecting "on-chain code" and "off-chain reality", enabling global business collaboration to break free from dependence on humans and enter a new civilizational stage of "contracts guaranteed by code".

***

### 2. Our Mission

—— How do we realize this vision?

> Compile the spirit of contracts in the real world into a universal language that is immutable on the blockchain.

To achieve this mission, OmniPact is committed to doing three things well:

1. Eliminate Friction: Through the intelligent guarantee contract (OES), eliminate the "counterparty risk" in OTC, service outsourcing and physical transactions, and reduce the collaboration cost between strangers to nearly zero.
2. Redefine Justice: Through the Decentralized Arbitration Network (DAN), return the right to resolve disputes from inefficient traditional courts to the community, and achieve more efficient and transparent fairness using game theory and collective wisdom.
3. Empower Sovereignty: Through the reputation identity system (Omni-ID), everyone's honest performance records are assetized, making reputation the most universal passport in the Web3 world.

***

### 3. Core Values

—— The DNA that guides our decisions

* 🔒 Code First, Human Justice

  We believe in the certainty of smart contracts, but we also acknowledge the complexity of the real world. We use code to lock assets and human wisdom (arbitration) to resolve disputes. This is the perfect balance between technology and humanity.
* 🌍 Permissionless & Censorship-Resistant

  OmniPact is a neutral protocol. We do not judge the content of transactions, nor do we restrict the parties involved in transactions. As long as it conforms to mathematical logic, anyone can freely use the protocol to build business relationships.
* 🤝 Radical Transparency

  From capital flows to arbitration votes, from code audits to governance proposals, everything is publicly traceable on the chain. Only ultimate transparency can foster ultimate trust.
* 💎 Long-termism

  We do not pursue short-term TVL bubbles; instead, we focus on building commercial infrastructure that can operate for 100 years. We protect every penny of our users as we protect our own eyes.

***

### 4. Strategic Goals

—— Our milestones towards the vision

* Phase 1: Foundation

  Establish the safest on-chain escrow standards and become the preferred trust tool for the Crypto Native community (OTC, code delivery, account transactions).
* Phase 2: Expansion

  Build a thriving arbitrator ecosystem, expand business to the Web2 freelance market and e-commerce sector, and become a commercial gateway connecting fiat currencies and cryptocurrencies.
* Phase 3: Ubiquity

  Achieve the comprehensive on-chain implementation of RWA, and deeply integrate with the Internet of Things (IoT) and international trade law. Let OmniPact become the underlying settlement and arbitration protocol for the on-chain circulation of global GDP.

***

#### 💡 Message from the OmniPact Team

> "In the first decade of Web3, we successfully achieved the decentralization of currency (Bitcoin) and the decentralization of finance (DeFi)."
>
> Over the next decade, our goal is to achieve the decentralization of business.
>
> OmniPact is not intended to overthrow the old world, but to install an operating system with its own 'court' and 'bank' for the new world. We invite you to join us in rewriting the source code of trust."

***


# White paper

Web3 is insufficient with only the asset layer (L1) and the application layer (L3). What we are lacking is a "trust layer" capable of handling complex business logic.

💡 Introducing OmniPact —— The Trust Layer of Web3.

We are not building a simple DApp; we are laying the foundation for the Web3 business empire. 👇 In the latest whitepaper, we elaborate on how OmniPact defines trust:

✅ Smart Escrow: Automating the fulfillment of every transaction\
✅ Arbitration Net: A decentralized dispute resolution mechanism\
✅ Reputation ID: Visualization of on-chain reputation

📄 Read the Vision:&#x20;

{% file src="/files/MWGxiMXFvEazdIT3yIkV" %}


# Token economic model

## OmniPact Protocol ($PACT) Tokenomics Framework v1.0

***

The Economic Engine for Decentralized Commerce

* Version: 1.0 (Final Draft)
* Date: January 2025

***

### Executive Summary

$PACT is the native utility token of the OmniPact protocol, aiming to capture the value of global decentralized commerce (DeCom). Its economic model design follows the "Value Accrual" principle and builds a moat through the following three layers of logic:

1. Work Token (means of production): Only by staking $PACT can one run an arbitration node and earn cash flows from Tokens such as ETH/BNB/USDC.
2. Deflationary (deflationary spiral): Protocol revenue is automatically used to repurchase and burn $PACT, directly converting network growth into token scarcity.
3. Governance Alignment (long-term binding): Adopt the veToken model, bind voting rights with the lock-up period, and eliminate short-term speculative governance.

***

### Utility & Value Capture

$PACT is not just a "governance token"; it is the fuel and license for the entire OmniPact economy.

#### Staking for Jurors

* Mechanism: To become a validation node (arbitrator) of the DAN network, one must stake at least 10,000 $PACT($$S\_{min}$$)。
* Value Logic:
  * As the protocol's TVL grows, the demand for arbitration increases. $$\rightarrow$$ Arbitration fees have increased.
  * High returns attract more nodes to join $$\rightarrow$$ It is necessary to purchase $PACT for staking from the market.
  * Conclusion: Business growth directly leads to the locking of $PACT, reducing the circulating supply.
* Slashing: Malicious arbitration will result in the confiscation and destruction of the staked funds.

#### Buyback & Burn

To achieve the long-term growth of $PACT's value, OmniPact has introduced a deflationary model called "The Black Hole". We commit to using a large portion of the economic value captured by the protocol to repurchase and permanently destroy $PACT until the total supply is reduced to 12% of the initial total supply (i.e., 120 million tokens). This mechanism ensures that every collateralized transaction occurring on the OmniPact network, on a micro level, increases the scarcity of $PACT.

* Revenue stream: The protocol charges 0.5% - 1% of each guaranteed transaction amount as Protocol Fee.
* Value logic: Introduce continuous purchasing pressure. Even if there are no new users entering the market, as long as existing users are trading, the currency price will have deflationary support.

**1. Buyback & Burn Engine**

—— Convert protocol revenue into token purchases

The service fees charged by the OmniPact protocol (usually 0.5%-1% of the transaction amount) are mainly deposited in the treasury in the form of mainstream assets (such as USDT, USDC, ETH). We will enable smart contracts to automatically execute repurchases:

* Income distribution: 20% - 40% of the protocol revenue (the quarterly ratio is determined by DAO voting) will be allocated to the "burn pool".

Automated execution:\
· Smart contracts publicly execute market buy operations on decentralized exchanges (DEX, such as Uniswap/PancakeSwap) on a regular basis (e.g., weekly).\
· The purchased $PACT tokens do not enter any wallet, but are directly sent to the Null Address (Null Address / 0x00...dead) in an atomic transaction.

·On-chain audit: Every Tx Hash repurchased and destroyed is published on the official website and can be verified by anyone, eliminating the "fake destruction" problem common in centralized exchanges.

·The remaining fund income is injected into OmniVault as an insurance fund.

**2. Native Utility Burn**

—— Payment means destruction

For scenarios where $PACT is directly used to pay for protocol service fees or value-added service fees, we will implement a 100% full destruction strategy.

* Service fee destruction: When users use $PACT to pay the guarantee fee in order to enjoy a rate discount, this $PACT will be directly destroyed and will no longer enter the national treasury for circulation.
* Destruction of ecological tickets:
* Advertising fees for merchants' bidding rankings.
* Advanced call fees for third-party APIs.
* Registration fee for IoT devices.
* All the above fees are paid in $PACT and directly destroyed.

**3. Slashing Burn**

—— The cost of the wrongdoer becomes the bonus of the holder

In the DAN arbitration network, to maintain fairness, we convert the assets of wrongdoers into fuel for the entire network's deflation.

* Arbitrator Misconduct: When an arbitrator is proven to have accepted bribes or voted maliciously, their staked $PACT will be confiscated (Slash). 50% of it will be injected into the insurance fund, and the other 50% will be directly destroyed.
* False appeal: If a buyer is determined to have maliciously initiated a false dispute to extort the seller, their pledged arbitration deposit will be confiscated and destroyed.

**4. Dust Cleanup**

To optimize the size of the ledger and reduce invalid UTXO/account states, the protocol allows users to convert tiny amounts of "dust" $PACT in their wallets that are insufficient to cover Gas fees into protocol Credits with one click, and these dust tokens will be collectively collected and destroyed.

#### vePACT Governance&#x20;

* Mechanism: Users can obtain vePACT (non-transferable) by locking $PACT.
* Rights:
  1. Governance rights: Determine rate parameters and whitelists.
  2. Boost: vePACT holders receive a return bonus when engaging in "transaction mining" or "arbitration".

***

### Emission Schedule&#x20;

We have designed the token release as a "Disinflationary" model to prevent early hyperinflation.

* Year 1: Radical release period. The focus is on subsidizing early users (Trade-to-Earn) and market making. The expected circulation volume will reach 16%.
* Year 2-3: Halving period. Ecological rewards are halved, with the focus shifting to organic growth. The circulation volume reaches 55%.
* Year 4-5: Wake period. Linear low-speed release, at this time, the intensity of repurchase and destruction should have exceeded the inflation rate, achieving "Net Deflation".

***

### Token Flow Diagram

1. User pays handling fees (USDC/ETH, etc.).
2. Smart Contract distribution fee:
   * $$\rightarrow$$ Jurors: Obtain work income.
   * $$\rightarrow$$ Treasury: Automatically execute the Buyback of $PACT.
3. $PACT be destroyed (Supply $$\downarrow$$)。
4. Jurors Need to purchase more $PACT for staking to increase the order-taking weight(Demand $$\uparrow$$)。
5. Holders Lock $PACT as vePACT to increase the yield rate (Lock $$\uparrow$$)。

***

### Strategic Advantages for Investors

* No "Ponzi" Yield: Returns come from real commercial cash flows (RWA/e-commerce/services), not money printing.
* Low Initial Float: TGE Only \~6.9% is in circulation, with extremely low selling pressure, making it easy for market capitalization management.
* Long-Term Alignment: Both the team and early investors have a 1-year cliff, which eliminates the risk of "dumping immediately after going online" and demonstrates their determination for long-term development.
* Regulatory Safety: Adopting "buyback and destruction" rather than "direct dividend distribution" to reduce the legal risk of being deemed a security (Security).

***

{% hint style="info" %}
Adjustments made according to development.
{% endhint %}


# Token

### · Token Profile&#x20;

| **Parameter**              | **Value**      | **Note**                                                   |
| -------------------------- | -------------- | ---------------------------------------------------------- |
| Token Name                 | OmniPact Token |                                                            |
| Ticker                     | $PACT          |                                                            |
| Max Supply                 | 1,000,000,000  | 1 billion coins (fixed upper limit, never to be increased) |
| Initial Circulating Supply | \~69,000,000   | Approximately 6.9% (Initial circulation of TGE)            |
| Initial Market Cap Target  |                | Valuation calculation based on TGE                         |
| Burn Mechanism             | Yes            | Dynamic repurchase and destruction                         |
| Decimals                   | 18             |                                                            |

### · Allocation & Vesting

|                                  **Category**                                  | **Allocation (%)** | **Amount ($PACT)** |                                                                         **Vesting Schedule** (Lock-up and Release Clauses)                                                                         |
| :----------------------------------------------------------------------------: | :----------------: | :----------------: | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
|                              Community & Ecosystem                             |       50.00%       |     500,000,000    |                                                                                         <p>TGE 0% unlocked.                                                                                        |
|          <br>Used for "transaction mining" and "arbitration rewards".          |                    |                    |                                                                                                                                                                                                    |
| <br>Released linearly on a monthly basis with a period of 60 months (5 years). |                    |                    |                                                                                                                                                                                                    |
|   <br>Note: Unproduced tokens are not included in the circulating supply.</p>  |                    |                    |                                                                                                                                                                                                    |
|                                 Early Investors                                |       15.00%       |     150,000,000    |                                                                                         <p>12-month cliff.                                                                                         |
|                   <br>Subsequent 24-month linear release.</p>                  |                    |                    |                                                                                                                                                                                                    |
|                                Core Contributors                               |       10.00%       |     100,000,000    |                                                                                         <p>12-month cliff.                                                                                         |
|                   <br>Subsequent 24-month linear release.</p>                  |                    |                    |                                                                                                                                                                                                    |
|                                  DAO Treasury                                  |       10.00%       |     100,000,000    | <p>TGE unlocks 2% (for initial market maker MM).</p><p>The remaining portion is unlocked by DAO governance voting and can be used for strategic mergers and acquisitions or black swan events.</p> |
|                               Interactive airdrop                              |         8%         |     80,000,000     |          30% of TGE is unlocked, and the remaining amount will be linearly released over 18 months. It is a reward for users who participated in the early mainnet interaction activities.         |
|                                   Public Sale                                  |        5.00%       |     50,000,000     |                                                         50% of TGE is unlocked, and the remaining will be linearly released over 6 months.                                                         |
|                               Advisors & Partners                              |        2.00%       |     20,000,000     |                                                                                          <p>6-month cliff.                                                                                         |
|                 <br>Subsequently, 24-month linear vesting.</p>                 |                    |                    |                                                                                                                                                                                                    |


# Detailed Explanation of the Core Mechanism Architecture

The design philosophy of the OmniPact protocol is based on "Deterministic Execution" and "Game Theoretic Equilibrium". This chapter will analyze, from the micro-level of mathematical models and algorithm implementation, how the protocol constructs a censorship-resistant, collusion-proof, and Turing-complete decentralized trust network.

### 1 .The OES Engine

OES (Omni Escrow System) is the core of the protocol, designed with a Finite State Machine (FSM) architecture to ensure the atomicity and irreversibility of the on-chain state transition of each transaction.

#### 1.1 Deterministic State Automaton

The transaction lifecycle is abstracted as a mathematical set $S = \\{S\_{init}, S\_{lock}, S\_{del}, S\_{disp}, S\_{fin}, S\_{void}\\}$。State transition function $\delta: S \times E \rightarrow S$Defines the unique legal path, where $E$ is the set of triggering events.

State Transition Topology and Constraint Logic:

1. $$ $S\_{init} \rightarrow S\_{lock}$ $$ (Atomic Locking):
   * Constraints: $$ $\sum\_{i=1}^{n} Asset\_i \ge Amount\_{req}$ $$。The state changes atomically only when sufficient funds are deposited into the Vault contract. At this point, the ownership of the funds is taken over by the smart contract, and any unilateral withdraw call from either party will be `revert`。
2. $$ $S\_{lock} \rightarrow S\_{del}$ $$ (Proof of Delivery):
   * The seller submits hash evidence $$ $H(E)$ $$(such as IPFS CID or logistics API signature).In this state, the buyer's funds remain locked, but the seller obtains an on-chain certificate of "fulfilled" and opens the inspection window.（Inspection Window, $$ $T\_{insp}$ $$）。
3. $$ $S\_{del} \rightarrow S\_{fin}$ $$ (Settlement):
   * Trigger condition: called by the buyer `confirm()` or triggered by the time oracle$$ $t\_{now} > t\_{lock} + T\_{insp}$ $$ and there is no dispute.
   * Execution logic: Contract triggering `Call` Operation, execution of funds $$ $Asset \rightarrow Seller$ $$ transfer.
4. $$ $S\_{any} \rightarrow S\_{disp}$ $$ (Dispute Injection):
   * This is the "abnormal interrupt vector" of the protocol. Once triggered, the FSM is suspended, control is transferred to the DAN governance contract, and funds enter a "frozen state" waiting for input signals from the arbitration layer.

#### 1.2 Timelocks with Liveness Guarantees

To prevent "Deadlock" attacks (i.e., the permanent locking of funds due to the loss of one party's private key)，OES introduces dual-layer temporal guardrails (Dual-Layer Temporal Guardrails)：

* T\_{delivery}(Delivery timeout threshold):

  If t\_{now} > T\_{delivery}and the state remains S\_{lock},Mathematical logic determines that the seller is in default (Default)。The buyer obtains ForceWithdraw Permission.
* T\_{approval} (Approval silence threshold):

  If t\_{now} > T\_{delivery} + T\_{insp}and the status is S\_{del}, mathematical logic determines that the buyer is satisfied by default.Keepers Network invocable ForceRelease，Earn Gas compensation and complete the payment to the seller.

***

### 2.DAN: Decentralized Arbitration Network

DAN is a crowdsourced oracle network based on Schelling Point game theory, designed to resolve "non-deterministic disputes," which we define as an "objectified consensus system of subjective truth."

#### 2.1 Cryptographic Sortition & Sybil Resistance

To ensure the independence of the jury, we have abandoned simple pseudo-randomness and adopted Verifiable Random Functions (VRF) for weighted lottery drawing.

Probability selection formula:

For any node $i$, the probability $P(i)$ that it is selected as an arbitrator is defined as:

$$
P(i) = \frac{\sqrt{S\_i} \cdot R\_i}{\sum\_{j=1}^{N} (\sqrt{S\_j} \cdot R\_j)}
$$

* $$ $S\_i$ $$: The number of $PACT tokens staked by the node (using square root smoothing to prevent monopoly by whales).
* $$ $R\_i$ $$: The Omni-Score reputation coefficient of the node (normalized).
* Sybil Resistance：due to $$ $\sqrt{A+B} < \sqrt{A} + \sqrt{B}$ $$，Splitting an account will lead to a decrease in the total selection probability, thereby mathematically suppressing the sybil attack.

#### 2.2 Schelling Point Game and Commit-Reveal Voting Mechanism

DAN is built on the Nash equilibrium: in a non-cooperative game, if you cannot communicate with other arbitrators, the best strategy is to choose "the option you think most people will choose" (i.e., the truth).

Two-Phase Protocol:

1. Commit Phase :

   Arbitrator J\_i locally generates voting intention V and introduces high-entropy random salt Salt. Submit the hash value to the chain:

$$
H\_i = \text{Keccak256}(V\_i \parallel Salt\_i \parallel \text{Address}\_i)
$$

* Security purpose: Hide the voting content to prevent "bandwagon voting" or "lazy arbitration".

1. Reveal Phase :

   The arbitrator publicly discloses V\_i and Salt\_i. The smart contract verifies whether H\_i matches.
2. Incentive Mechanism :

$$
Reward\_i = \begin{cases} B\_{base} + \frac{S\_{slashed}}{N\_{maj}} & \text{if } V\_i = V\_{majority} \ -S\_{stake} \cdot \alpha & \text{if } V\_i \neq V\_{majority} \end{cases}
$$

Reward\_i = \begin{cases} B\_{base} + \frac{S\_{slashed}}{N\_{maj}} & \text{if } V\_i = V\_{majority} \\\ -S\_{stake} \cdot \alpha & \text{if } V\_i \neq V\_{majority} \end{cases}

* If an arbitrator votes for the minority, a certain proportion of their pledged assets $$ $\alpha$ $$ It will be confiscated and distributed to the majority arbitrators. This constitutes a strong economic constraint, forcing the nodes to tend to be honest.

#### 2.3  Recursive Appeal & Supreme Court

To correct statistical biases, the system supports recursive appeals. In each round of appeal, the number of arbitrators grows exponentially. ($$ $2k+1$ $$)，The pledge cost has doubled.

Supreme Court Trigger:

When the cost of appeal $C\_{appeal} > \text{DisputeAmount} \times 50\\%$ Or when global security parameters are triggered, the Final Adjudication Senate elected by the DAO will intervene.The Final Adjudication Senate no longer relies on randomness, but conducts open voting based on real-name reputation (Proof of Identity). Its rulings have eventual consistency (Eventual Consistency) and directly rewrite the Ledger state.

***

### 3.Omni-ID： (Reputation Vector Model)

Omni-ID is not just an NFT; it is a dynamic reputation container built based on the ERC-5192 (Minimal Soulbound NFTs) standard. The Reputation Score is not accumulated linearly; instead, it is a complex function based on time decay and multi-dimensional vectors.

#### 3.1 Reputation Algorithm

User's current reputation $$ $R(t)$ $$ Determined by the following models:

$$
R(t) = \tanh\left(\frac{V\_{tx}}{K}\right) \cdot (1 - e^{-\lambda T\_{age}}) \cdot C\_{history} - P\_{malicious}
$$

* $$ $\tanh(\cdot)$ $$: Hyperbolic tangent function, ensuring that the score has an upper limit (such as 1000 points) and that it changes along with the transaction amount $$ $V\_{tx}$ $$ Increase, diminishing marginal returns.
* $$ $(1 - e^{-\lambda T\_{age}})$ $$: Time maturity factor. Even if a new account has a huge transaction volume, its credit score will be limited by the account's duration (to prevent "flash" fraud).
* $$ $C\_{history}$ $$: Fulfillment coefficient (number of successful transactions / total number of transactions).
* $$ $P\_{malicious}$ $$: Penalty term. Once a fraudulent act occurs (losing an arbitration), this term will expand exponentially, instantly destroying credibility, realizing that "building credibility is like hiking up a mountain, while destroying credibility is like falling from a height."

#### 3.2 Permissioned Access Control

The underlying layer of the smart contract is based on $$ $R(t)$ $$ Implement Access Control List (ACL):

* Tier 1 (Newbie): Only for small transactions, with high fees and full collateral required.
* Tier 3 (Veteran): Unlock unsecured lending, qualification to act as an arbitrator, and API high-frequency call permissions.

***

### 4.Privacy & ZK-Compliance

OmniPact adopts a hybrid architecture of "on-chain verification and off-chain computing", which defends users' privacy sovereignty while complying with GDPR and AML regulations.

#### 4.1 Zero-Knowledge Proofs

We have integrated zk-SNARKs (Zero-Knowledge Succinct Non-Interactive Argument of Knowledge) technology.

* Circuit Logic :

  The prover $P$ proves to the verifier $V$ (smart contract) that:

  "I know the private key of a legitimate KYC credential $C$, and this credential has not expired, and the identity is not in the OFAC sanctions list hash tree $T$."
* Output:

  Only Proof $\pi$ and Nullifier (to prevent double usage) are stored on the chain, without storing any PII (Personally Identifiable Information). This achieves compliance at the mathematical level.

#### 4.2 ECIES Hybrid Encryption and TEE Enclave

For sensitive business data (such as original RWA contracts, API Keys):

1. Transport layer: Uses ECIES (Elliptic Curve Integrated Encryption Scheme). The sender derives a temporary shared key using the receiver's ETH public key to achieve end-to-end encryption.
2. Computation Layer: For data that requires "burn after reading" or "privacy-preserving computation", a Trusted Execution Environment (TEE) built using Intel SGX / AMD SEV is utilized. Data is decrypted and processed within the CPU hardware isolation area. Due to memory encryption, even the Node Operator cannot peek into the content of the data.


# Recruiting talents

#### Become an Omni master

<figure><img src="/files/MuZY1ZBtvpYuxTs4QH0Y" alt=""><figcaption></figcaption></figure>

**Join OmniPact and build the future with us**\
We are looking for developers who are passionate and have an extreme pursuit of code quality. Whether you excel in core development, testing, documentation, or community management, as long as you firmly believe in the power of open-source collaboration and technological inclusiveness, you are welcome to join the OmniPact team to build the next-generation service governance framework together.

Check existing positions for more information. Can't find a suitable position for you? Please check back later. We will have more job vacancies in the future.


# Senior Front-end Engineer

General Information

* Salary range: Competitive, negotiable.
* Position: Full-time
* Location: Remote
* Time zone preference: Any

### Your responsibilities

* Design, plan and estimate complex front-end products/upgrades.
* Conceive and develop functions that contribute to the development of OmniPact.
* Collaborate enthusiastically with small teams to plan projects at the task level.
* Collaborate with cross-functional partners in all aspects of product development.
* Identify and advocate for team-wide areas for improvement and best practices.

### Skills and Qualifications

* Proficient in TypeScript, React.js and Node.js.
* More than 5 years of professional experience in building responsive/adaptive web applications.
* Possesses strong capabilities in writing concise, easy-to-maintain, and well-structured code.
* Familiar with JavaScript testing frameworks.
* Proficient in modern front-end build processes and tools.
* Has experience in architecting and delivering scalable front-end solutions.
* Have practical experience in Web3 and front-end development of decentralized applications, including familiarity with modern Web3 libraries (such as viem, wagmi).
* Get in touch with GraphQL.

### Key Features

* **Strong curiosity:** Eager to gain an in-depth understanding of new tools and technologies.
* **Self-motivation:** Capable of conducting research independently and transforming research results into practical solutions.
* **Strong learning ability:** able to quickly adapt to constantly changing needs and environments.
* **Innovative thinking:** Proactively seeking ways to improve products and work processes.

### It would be even better to have it.

* Understanding of Solidity.
* Familiar with DEX protocols.

### How to apply

Please send your resume to <omni@omnipact.io>


# Senior Backend Engineer

### General Information

* Salary range: Competitive, negotiable in person.
* Position: Full-time
* Location: Remote
* Time zone preference: Any

### Role Overview

We are looking for an experienced backend engineer who is passionate about cryptocurrency, decentralized finance (DeFi), decentralized commerce, and RWA, and has an in-depth understanding of microservices architecture. You will work closely with a diverse team of engineers to design, develop, and maintain the backend services that support our cryptocurrency platform.

### Your responsibilities

* Design, develop, and maintain scalable backend services and microservices.
* Collaborate with cross-functional teams to integrate DeFi protocols and other blockchain solutions.
* Implement secure, efficient, and reliable APIs to support our encryption services.
* Develop and deploy infrastructure in a cloud environment to ensure scalability and performance.
* Analyze and optimize system performance and stability.
* Stay updated on the latest developments in blockchain, DeFi, and backend technologies.

### Skills and Qualifications

* More than 5 years of backend development experience.
* Proficient in modern backend programming languages such as TypeScript.
* (Required), Rust (the icing on the cake).
* Have experience in using smart contracts and applications based on Ethereum/Solana.
* Have work experience in microservices and distributed systems.
* Gain a deep understanding of the concepts of blockchain, cryptocurrencies, and decentralized finance (DeFi).
* Have practical experience in building APIs and integrating with third-party services.
* Have experience in using cloud platforms (such as AWS, DigitalOcean).
* Strong problem-solving skills and attention to detail.
* Excellent communication skills and teamwork spirit.

### It would be even better to have it.

* Familiar with container orchestration technologies such as Kubernetes.
* Familiar with PostgreSQL, Redis, or similar database technologies.
* Have experience working in a startup or a fast-paced environment.
* Familiar with indexing solutions such as TheGraph or Subsquid.

### Why join us?

* Engaged in cutting-edge technology research in the exciting fields of blockchain and decentralized finance (DeFi).
* Join our passionate, knowledgeable, and mutually supportive team.
* The rapidly developing cryptocurrency sector holds opportunities for growth and development

### How to apply

Please send your resume to <omni@omnipact.io>


# Business Development Manager

### General Information

* Salary range: Competitive, negotiable.
* Position: Full-time
* Location: Remote
* Time zone preference: Any

### Your responsibilities

* Coordinate with partners to ensure the healthy operation of OmniPact.
* Review and conduct due diligence on projects applying to collaborate with OmniPact.
* Contact the project team to explore potential cooperation opportunities.
* Perform operational matters related to the OmniPact product.
* Implement best practices between the business development team and the broader team.
* Stay informed about the latest developments in the cryptocurrency sector and explore new business areas.

### Skills and Qualifications

* More than 2 years of work experience in business development and/or corporate finance.
* Have a solid understanding of the cryptocurrency field, especially DeFi.
* Able to fluently use English in listening, speaking, reading and writing.
* Strong expressive ability, able to communicate effectively with the project team.
* Proactively follow the latest trends in the blockchain/cryptocurrency field.
* When analyzing a project, great attention must be paid to details.
* Able to work independently and innovate.
* Able to withstand a high-pressure and fast-paced working environment.

### It would be even better to have it.

* Proficient in a second language.
* Possess a bachelor's degree in finance, accounting, or other related fields.
* Have experience in smart contracts and Solidity.

### How to apply

Please send your resume to <omni@omnipact.io>


# Brand and Logo

Guides and downloadable resources, such as the OmniPact logo SVG file.

<figure><img src="/files/vK0VOMSrSUmkXJTgQxpM" alt=""><figcaption></figcaption></figure>

### Introduction

The download for the OmniPact logo is at the bottom of this page, but please be sure to read these guidelines first.

The following OmniPact "brand assets" are all copyrighted materials, and you may only use them in accordance with the policies detailed below:

* The logos, word marks, and icons of OmniPact and PACT.
* The name of OmniPact.
* Other visual materials produced by OmniPact include but are not limited to illustrations and 3D models.

### What can you do?

You may use OmniPact's brand assets in the following situations:

* 👌 refers to our products and services
* 👌 Link to our official website or products, for example, "Trade our tokens on OmniPact"
* 👌 Officially announce the establishment of a partnership, but only if you obtain the formal approval of a qualified member of the OmniPact team.

For information on other uses of our brand assets, please contact <omni@omnipact.io>

### What can't you do?

Although we firmly believe in and adhere to the open-source spirit, protecting the OmniPact brand is crucial for the safety of our users, so that users can distinguish between genuine products/endorsements and fake ones.

Here are some examples of prohibited uses of our brand assets:

* **⛔️Do not use our brand assets in your product names, logos, NFTs, etc.**
  * For example, it is not allowed to create applications named "OmniPact Engine" or "Pact Child".
  * Do not use the OmniPact logo in whole or in part as part of your product logo, marketing materials, website, or other content.
  * Logos that are highly similar to the OmniPact icon are also prohibited.
* **⛔️ Do not use our brand assets to create digital or physical products for sale, including but not limited to:**
  * Commodity ("Peripheral Product")
  * NFT
  * Other products
* **⛔️Do not create derivative names that imply official recognition**

  For example, do not create a social media group named "Full-Featured Contract" – it sounds too formal. "Full-Featured Contract Fans Group" might be acceptable.
* **⛔️ Do not alter or modify our brand assets in any way**

  Please use the logos and other materials exactly in the provided format. Do not change the colors, recombine, abbreviate, or modify these materials in any way.

Use your common sense and creativity. If you want to create something related to the OmniPact ecosystem, then create your own work.

Feel free to create a unique brand that clearly belongs to you - if your product is strong enough, you don't need to rely on repackaging the OmniPact brand.

### OmniPact Logo Download

<figure><img src="/files/zJlCdZ16mmqMEgwvqlF4" alt=""><figcaption></figcaption></figure>

After reading all the above content, please download the OmniPact and Pact logos below.

{% file src="/files/4WFojDEIUYLe5561n28W" %}

<p align="center">Download the official OmniPact and Pact logos.</p>

{% hint style="success" %}
By downloading this file, you confirm that you will only use it within the scope permitted by the terms detailed on this page.
{% endhint %}


# Terms of Service

### OmniPact Terms of Service

Last updated: February 28, 2025. These Terms of Service (hereinafter referred to as the "Agreement") explain the terms and conditions for your access to and use of <https://omnipact.io> and any of its subdomains. You must read this Agreement carefully as it governs your use of the website. Accessing or using this website means that you have read, understood, and agreed to be fully bound by this Agreement. If you do not agree, you are not entitled to access or use this website and should not use it. Note: This Agreement contains important information, including a binding arbitration clause and a class action waiver clause, both of which affect your rights in dispute resolution. You may access this website only if you fully agree to these terms, and you should only access this website under such circumstances.

Welcome to OmniPact (hereinafter referred to as "this Platform", "we", or "OmniPact"). These Terms of Service (hereinafter referred to as "this Agreement") constitute a legally binding contract between you ("User" or "you") and the entity that develops and operates OmniPact, governing your access to and use of <https://omnipact.io>, its subdomains, related APIs, and mobile applications (collectively referred to as "this Website" or "this Interface").

Important Notice: This Agreement contains mandatory arbitration clauses and class action waiver clauses, which will affect your rights to resolve disputes with us. By accessing or using this website, you confirm that you have read, understood, and agree to be bound by all terms of this Agreement. If you do not agree to any part of this Agreement, please immediately cease using this website.

***

#### Description of the Nature of Services and Agreements

**Distributed Guarantee Agreement (Trust Infrastructure)**

This website provides services for accessing OmniTrust through a graphical user interface (UI). OmniTrust is a decentralized smart contract system deployed on multiple public blockchains (including but not limited to Ethereum, BNB Chain, Solana, Aptos, etc.). Its core functions include:

* Smart Escrow: Allows buyers and sellers to lock assets in a smart contract without trusting a third-party intermediary until the transaction conditions are met.
* Decentralized Arbitration (Arbitration Network): When a dispute arises in a transaction, evidence is adjudicated through a decentralized network of arbitrators.
* Reputation Identity: A reputation scoring system generated based on on-chain transaction behaviors.

**Unmanaged nature**

Both this website and the OmniPact protocol are of a non-custodial nature.

* Control of funds: We do not hold, keep in custody, or control any of your digital assets. Assets are only locked and released by smart contracts in accordance with preset code logic (such as mutual confirmation, arbitration award results).
* Private Key Responsibility: You have complete and sole control over the private key and mnemonic phrase of your blockchain wallet. We shall not be liable for any loss of assets resulting from the loss, theft, or leakage of your private key.

**The difference between interface and protocol**

This website is just one of many interfaces for accessing the OmniPact smart contract protocol. We do not control public blockchain networks, nor do we guarantee the confirmation time of transactions on the blockchain.

***

#### Initial Token Offering

You declare that when participating in our initial token offering, you are not from any of the following countries or regions:

Belarus, Cuba, the Crimean region, the Democratic Republic of the Congo, Iran, Iraq, New Zealand, the Democratic People's Republic of Korea, South Sudan, Sudan, Syria, the United States and its territories (American Samoa, Guam, Puerto Rico, the Northern Mariana Islands, and the U.S. Virgin Islands), Zimbabwe.

**Not registered with the U.S. Securities and Exchange Commission or any other institution**

We are not registered with the U.S. Securities and Exchange Commission as a national securities exchange or in any other capacity. You understand and acknowledge that we do not act as a trading broker on your behalf. We also do not assist in executing or settling your transactions, which are conducted entirely on public distributed blockchains such as Ethereum.

**Non-solicitation statement; no investment advice provided**

You agree and understand that: (a) all transactions you submit through this website are deemed non-solicited transactions, which means these transactions are initiated entirely by you; (b) you have not received any investment advice from us regarding any transaction (including transactions you conduct through our intelligent routing API); and (c) we will not conduct suitability reviews on any transactions you submit.

We may provide token information from third-party data partners on this website through features such as rarity scores, token browsers, or token lists. The provision of information materials does not constitute a solicitation for you to trade these tokens; we will not attempt to induce you to make any purchases based on the information provided. All such information available on this website is for reference only and should not be construed as investment advice or a recommendation that specific tokens are safe or sound investments. You should not take or refrain from taking any action based on any information contained on this website. We provide token information solely for your convenience, do not constitute any investment advice, and do not express opinions on the merits of any transaction or opportunity. You are solely responsible for determining whether any investment, investment strategy, or related transaction is suitable for you based on your own investment objectives, financial situation, and risk tolerance.

#### Qualifications and Compliance

**Qualification Requirements**

By accessing or using this service, you represent and warrant that:

* You are at least 18 years old or have reached the legal age of adulthood in your jurisdiction.
* You have full capacity for civil conduct to sign this agreement on your own behalf or on behalf of the entity you represent.

**Restricted regions and sanctions**

You declare that you are not located in any of the following regions and are not the subject of any of the following sanctions lists:

* Restricted countries/regions: including but not limited to Cuba, Iran, North Korea, Syria, the Crimean region, the Donetsk and Luhansk regions, or other jurisdictions subject to comprehensive economic sanctions imposed by the United States, the European Union, and the United Nations.
* Sanctions List: The List of Specially Designated Nationals (SDN) of the Office of Foreign Assets Control (OFAC) of the U.S. Department of the Treasury, or other similar lists of prohibited transacting parties.

#### Rules for Secured Transactions and Fund Release

**Trading process**

You acknowledge and agree that guaranteed transactions conducted through OmniPact shall follow the following procedures:

1. Fund Lock: The buyer (both parties) deposits the funds into the smart contract escrow.
2. Performance: The seller (both parties) delivers goods or services.
3. Release/Dispute: The buyer (both parties) confirms the release of funds, or initiates arbitration within the dispute period.

**The irreversibility of fund release**

You clearly understand and agree that once a smart contract executes a fund release operation in accordance with the protocol logic (for example: the buyer (both parties) clicks to confirm, automatic confirmation upon timeout, or an arbitrator makes a ruling), this operation is irreversible on the blockchain. OmniPact cannot recover assets for you after the funds are released.

**Dispute Resolution and Arbitration Mechanism**

* Decentralized arbitration: When both parties to a transaction cannot resolve the dispute on their own, either party can apply to access the OmniPact arbitration network.
* Binding force of the award: You agree to accept the award made by the arbitrator (or arbitral tribunal) based on the evidence you submit. The smart contract will automatically transfer funds in accordance with the arbitration result.
* Disclaimer: Arbitrators are independent third parties (community members or professional institutions) and are not employees or agents of OmniPact. We shall not be liable for the fairness, accuracy of the arbitrators' rulings or any losses resulting therefrom.

#### Prohibited activities

**When using this website and the agreement, you must not engage in the following behaviors:**

1. Fraudulent transactions: fictitious transactions, money laundering, and illegal fund transfers using guarantee contracts.
2. Submitting false evidence: During the dispute arbitration process, submitting forged chat records, logistics information, or other misleading evidence.
3. Collusion/conspiracy: Buyers and sellers collude, or users collude with arbitrators, with the intention of defrauding the agreement funds or manipulating credit scores.
4. Malicious attacks: Attacking website infrastructure, exploiting smart contract vulnerabilities, launching DDoS attacks, or implanting viruses.
5. Illegal goods/services: Using OmniPact to guarantee transactions of illegal contraband (such as drugs, weapons, stolen items, child pornography, etc.).
6. Infringement of intellectual property rights: Publishing content that infringes the copyright or trademark rights of others.

#### Fees and Payments

**Agreement service fee**

Using the OmniPact protocol may incur service fees (Protocol Fees), which are usually automatically deducted from the escrow funds when the transaction is settled. The fee schedule will be clearly displayed on the transaction creation page.

**arbitration fee**

If a dispute arbitration is initiated, the losing party may be required to bear the arbitration fees (remuneration paid to the arbitrators). For specific rules, please refer to the *OmniPact Arbitration Rules*.

**Gas**&#x20;

Blockchain transactions require consuming network Gas fees. Whether the transaction is successful or not, the Gas fees shall be borne by you and are non-refundable.

#### Intellectual property

**Platform rights**

OmniPact owns all intellectual property rights to this website and its content (UI design, Logo, text, code, trademarks). The smart contract code of the OmniPact protocol may be open-sourced under specific open-source licenses (such as MIT or GPL), and the specific details shall be subject to the declaration in the code repository.

**User Content License**

The content (texts, images, files) you upload when participating in arbitration or describing transactions grants us a global, non-exclusive license to use, reproduce, and display such content to the extent necessary for providing services (for example, presenting evidence to arbitrators).

{% hint style="info" %}
Please read this section carefully as it concerns your significant rights and interests.
{% endhint %}

**Provided "as is"**

This website and the agreement are provided on an "as is" and "as available" basis, without any express or implied warranties. We do not guarantee that the service will not be interrupted, be error-free, or be absolutely secure.

**Smart contract risks**

You understand that blockchain technology and smart contracts have inherent risks, including but not limited to: code vulnerabilities, hacking attacks, blockchain network congestion or forks. For financial losses caused by defects in the OmniPact smart contract code, the OmniPact development team shall be liable to the maximum extent permitted by law.

**Counterparty risk**

OmniPact only provides guarantee tools (trusted transaction tools) and does not verify the real identity or performance capability of the counterparty. You shall bear the losses caused by the counterparty's breach of contract, fraud, or delivery of goods/services that do not conform to the agreement.

**Does not provide legal or investment advice**

Any information, token price, or credit score displayed on this platform is for reference only and does not constitute investment advice or legal advice. You should consult professionals on your own.

You expressly agree to assume all risks associated with your access to and use of this website. You further expressly waive and release us from any and all liabilities, claims, actions, or damages arising out of or in any way related to your use of this website. If you are a resident of California, you waive the rights and protections provided by Section 1542 of the California Civil Code, which states: "A general release does not extend to claims that the creditor or releasing party does not know or suspect to exist in his or her favor at the time of executing the release and that, if known by him or her, would have materially affected his or her settlement with the debtor or released party."

#### Disclaimer

This website is provided on an "as is" and "as is" basis. To the fullest extent permitted by law, we make no representations and warranties of any kind, express, implied or statutory, including but not limited to warranties of marketability and fitness for a particular purpose. You acknowledge and agree that your use of this website is at your own risk. We do not warrant your access to this website on an ongoing, uninterrupted, timely or secure basis; do not warrant the accuracy, reliability, completeness or timeliness of the information contained in this website; nor do we warrant that this website is free from errors, defects, viruses or other harmful elements. No advice, information or statement provided by us shall be taken as any warranty of this website. We do not endorse, warrant, or accept responsibility for any third-party advertisements, offers, or statements posted on this website.

Likewise, this Agreement is provided "as is" and you use it at your own risk and without warranty of any kind. Although we contributed to the initial code of this Agreement, we do not provide, own or control this Agreement. This Agreement is run autonomously by smart contracts deployed on various blockchains without any human intervention. Upgrades and modifications to the Agreement are generally managed by PACT Token Holders in a community-driven manner. No developer or entity involved in the creation of this Agreement shall be liable for any claims or damages arising out of your use, inability to use, or your interaction with other users, including any direct, indirect, incidental, special, punitive or consequential damages, or loss of profits, cryptocurrencies, tokens or any other item of value. We do not endorse, warrant, or accept responsibility for any third-party advertisements, offers, or statements posted on this website.

#### Limitation of Liability

Under no circumstances shall we or any of our officers, directors, employees, contractors, agents, affiliates, or subsidiaries be liable to you for any indirect, punitive, incidental, special, consequential, or exemplary damages, including (but not limited to) loss of profits, loss of goodwill, loss of use, loss of data, or loss of other intangible assets arising out of or in connection with access to or use of this interface. We shall also not be liable for any damages, losses, or injuries resulting from hacking, tampering, or other unauthorized access to or use of this interface. We shall not be liable for this interface or the information contained therein, including but not limited to: (A) errors, omissions, or inaccuracies in the content; (B) any personal injury or property damage of any nature resulting from access to or use of this interface; (C) unauthorized access to or use of any secure server or database under our control, or the use of any information or data stored therein; (D) interruption or cessation of functionality related to this interface; (E) vulnerabilities, viruses, Trojans, or other similar programs that may be transmitted through this interface; (F) errors or omissions resulting from the use of any content provided through the interface, or losses or damages caused thereby; and (G) any defamatory, offensive, or illegal acts of any third party.

#### Dispute Resolution

We will make every effort to resolve any potential disputes through informal and good-faith negotiations. In the event of a potential dispute, you must contact us by sending an email to <Omni@omnipact.io> so that we can attempt to resolve the issue without resorting to formal dispute resolution procedures. If we fail to reach an informal resolution within sixty days of receiving your email, both you and we agree to resolve the potential dispute in accordance with the following process.

Any claims or disputes arising out of or in connection with this website, this agreement, or any other acts or omissions for which you believe we should be liable, including (but not limited to) any claims or disputes regarding arbitrability ("Disputes"), shall be finally and exclusively resolved by arbitration in accordance with the arbitration rules of the Hong Kong International Arbitration Centre. You understand that you must resolve all disputes through binding arbitration. The arbitration shall be conducted in confidence, with a single arbitrator appointed in accordance with the arbitration rules of the Centre. Unless both you and we agree to conduct the arbitration elsewhere, the arbitration shall take place in Hong Kong. Unless otherwise agreed by us, the arbitrator shall not consolidate your claims with those of any other party. Any award made by the arbitrator may be enforced in any court of competent jurisdiction.

{% hint style="info" %}
Class action and jury trial immunity
{% endhint %}

You must bring any and all disputes against us in your individual capacity and not as a plaintiff or member of any so-called class action, consolidated action, private attorney general action, or other representative action. This provision applies to class arbitration. Both you and we agree to waive the right to a jury trial.

#### Applicable Law

You agree that this Agreement and any disputes between you and us shall be governed by the laws of Hong Kong, without regard to the principles of conflict of laws. You further agree that this website shall be deemed to be located entirely in Hong Kong, and although this website may be accessible in other jurisdictions, such accessibility does not constitute general or specific personal jurisdiction for any court outside Hong Kong. Any arbitration conducted under this Agreement shall be subject to the arbitration rules of the Arbitration Center. You agree that if the binding arbitration clause of this Agreement is found to be unenforceable, the courts of Hong Kong shall be the appropriate jurisdiction for any appeal of an arbitration award or any litigation.

***

* Complete Agreement: This agreement constitutes the complete agreement between the two parties regarding this subject matter and supersedes any prior oral or written agreements.
* Severability: If any clause of this Agreement is deemed invalid or unenforceable, it shall not affect the validity of the other clauses.
* Right to Modify: We reserve the right to modify this Agreement at any time. The modified Agreement shall take effect immediately upon being published on the website. Your continued use of this service shall be deemed as your acceptance of the modifications.

***

OmniPact Protocol Team Contact: <omni@omnipact.io>


# Governance


# Initiate a proposal


# Ministry of Finance report


# Bug Bounty

The OmniPact Vulnerability Bounty Program primarily targets our smart contracts, websites, and applications, with a main focus on preventing user fund losses, whether through directly stealing locked funds, or through social engineering attacks such as redirecting users or forcing them to sign transactions.

> <omni@omnipact.io>

### Smart contracts and blockchain

| Level    | ​                          |
| -------- | -------------------------- |
| critical | Up to 1 million US dollars |
| tall     | Up to $20,000              |
| medium   | Up to $2,000               |

All vulnerability reports must include a proof of concept demonstrating how to exploit the vulnerability to be eligible for a reward. This can be the smart contract itself or a transaction.Websites and applications

| Level    | ​               |
| -------- | --------------- |
| critical | 7500 US dollars |
| tall     | 4000 US dollars |
| medium   | 1500 dollars    |

\*XSS reports are limited to those that affect users, prompting them to sign transactions or redirect.All payments are made by the **OmniPact** team,And it is pegged to the U.S. dollar value set here, and can be paid in **PACT** or **USDT**.


# GitHub

Learn more about documenting APIs in GitBook. Want to gain a deeper understanding of OmniPact's technical implementation? The complete source code of the project is hosted on GitHub. You can browse the code, submit Issues to feedback problems, or even directly submit Pull Requests to improve it. We welcome contributions from every developer!

<a href="https://github.com/OmniPactDAO" class="button secondary" data-icon="github">Visit GitHub</a>


# OmniPact Technology White Paper

Welcome to read the *OmniPact Technical Whitepaper*.

In the long river of human civilization, "contract" has always been the cornerstone of trust. From the cuneiform characters on clay tablets to today's legal provisions, we have never stopped exploring how to lock in commitments more precisely and securely. However, the rise of the digital world has made static paper and rigid code unable to carry the dynamic reality.

Today, we invite you to witness the ultimate form of the contract — OmniPact.

We believe that future contracts should not be obscure and difficult-to-understand code, but intelligent protocols that can comprehend human intentions. OmniPact is more than just another smart contract platform on the blockchain; what we are building is a universal bridge connecting natural language and machine-executable logic.

In this white paper, you will see how we use artificial intelligence to interpret ambiguous intentions, how we perceive the real dynamics of the world through a decentralized oracle network, and how we employ encryption technology to guarantee the ultimate fulfillment of every commitment.

Whether you are a developer, an investor, or simply an explorer curious about the future trust mechanisms, you are all welcome to join this journey. Together, let us entrust trust to code and understanding to humanity.

Welcome to the era where everything can be contracted and everything can be automated.

**—— OmniPact Co-founding Team**


# Executive Summary

In the first decade of blockchain technology, through Bitcoin and Ethereum, the issues of "decentralized storage of value" and "trustless exchange of tokens (DeFi)" have been successfully addressed. However, when we attempt to expand the application boundaries of blockchain to real-world business activities—from freelance services and over-the-counter (OTC) bulk transactions to the circulation of real-world assets (RWA)—we encounter the so-called "last-mile trust gap."

The proposal of OmniPact (OmniTrust Protocol) aims to fill this significant vacuum. We have built a Turing-complete commercial guarantee and arbitration infrastructure. By combining deterministic smart contracts with a game theory-driven Decentralized Arbitration Network (DAN), we have realized the on-chain mapping of complex transaction states in the real world and the final consistent adjudication. OmniPact is not just a payment protocol; it is a universal trust layer in the Web3 economy that connects the "code world" and "physical reality."


# 1.1 The "Oracle Problem" in Commercial Transactions

In the fields of computer science and blockchain, smart contracts are regarded as "vending machines": input the correct tokens, and output the determined goods. This works well in purely digital native environments (such as ERC-20 swaps on Uniswap), because both inputs and outputs are on the chain, and the state is objective.

However, once transactions involve off-chain entities or non-standardized services, we encounter the well-known "The Commercial Oracle Problem".

#### 1.1.1 Definition & The Semantic Gap

We formally define the "commercial oracle problem" as follows:

A Turing-complete blockchain network cannot verify the authenticity and quality of external physical world events without introducing centralized trust assumptions.

This is not just a matter of data acquisition, but a deeper semantic gap (Semantic Gap):

* The on-chain world (On-chain) understands that:`uint256 amount`, `address recipient`, `bool isPaid`. These are binary and objective.
* Off-chain commerce includes:Is the service quality up to standard?、Is the design drawing original?Is the goods damaged?These are diverse and subjective.

Smart contracts cannot execute the following logic:

$$
f(x) = \begin{cases} \text{Release Funds} & \text{if Service is "Good"} \ \text{Refund} & \text{if Service is "Bad"} \end{cases}
$$

Because the EVM (Ethereum Virtual Machine) cannot compute the boolean values of "Good" or "Bad".

#### 1.1.2 Systemic Failures of Current Solutions

Before the emergence of OmniPact, the market attempted to solve this problem through the following methods, but all of them had fatal flaws:

**A. Multi-sig Wallets**

* Mechanism: The buyer, the seller, and a third-party arbitrator hold private keys, and the payment is released upon 2/3 signatures.
* Defect: Introduced the "specific trusted entity risk".
  * Collusion Risk: Arbitrators may be bribed to collude with one party to steal funds.
  * Single Point of Failure (SPOF): If the arbitrator's private key is lost or the arbitrator is out of contact, it will lead to a permanent deadlock of funds.
  * Non-scalability: It is difficult to find trustworthy third parties for massive amounts of tiny transactions on a global scale.

**B. Centralized Data Feeds**

* Mechanism: Rely on a single API (such as the FedEx interface) to confirm the logistics status.
* Defect: Source Sybil Attack.
  * API data may be tampered with by hackers.
  * The logistics status in the real world may be falsified (such as "brushing orders with empty packages"), and simply putting data on the chain cannot verify "whether there is goods in the package".

**C. Simple Tokenization**

* Mechanism: Directly issue real estate as NFT.
* Defect: Decoupling Risk.
  * Owning an on-chain NFT is not equivalent to owning the legal ownership of an offline real estate property. If the original owner sells the house to someone else in reality, the on-chain NFT becomes a worthless air coin. It lacks "Enforceability" at the legal level.

#### 1.1.3 OmniPact's Solution Path: Objectification of Subjective Truth (Subjective Truth Objectification)

OmniPact recognizes that the verification of commercial transactions is inherently a matter of social consensus, not merely a problem of code calculation.

To solve this problem, we did not attempt to make smart contracts "understand" reality; instead, we constructed a mechanism to transform subjective real-world states into objective game theory equilibria:

1. Deterministic Layer (L1 Determinism): Utilizes OES (Omni Escrow System) to handle the locking and release of funds, ensuring basic atomicity and eliminating the risk of "taking the money and running away".
2. Probabilistic Layer (L2 Probabilistic Truth): Utilizes DAN (Decentralized Arbitration Network) to handle state verification. Through the Schelling Point mechanism, it incentivizes mutually unfamiliar arbitrators to converge on the same "truth" in non-cooperative games.

OmniPact is not eliminating risks, but managing and pricing them. We transform the uncertainties in commercial transactions (the oracle problem) into a computable, programmable, and hedgeable on-chain protocol risk, thereby laying the theoretical and technical foundation for large-scale commercial applications of Web3.


# 1.2 OmniPact Solution: FSM + Game Theory

This section will elaborate on how OmniPact addresses this challenge through a Hybrid Architecture. We integrate deterministic computer science (state machines) with probabilistic crypto-economics (game theory) to construct a decentralized trust system that is mathematically rigorous and economically robust.

***

To enable complex business collaboration in a trustless blockchain environment, OmniPact proposes a Dual-Layer Consensus Architecture. This architecture decouples the transaction execution process into two orthogonal dimensions: the certainty of fund flow and the social consensus in dispute adjudication.

#### 1.2.1 The Deterministic Layer: OES-FSM

At the bottom layer of the protocol, OES (Omni Escrow System) is designed as a strict deterministic finite state machine (DFSM).

Unlike the flexibility of general-purpose programming languages, OES contracts enforce transactions to follow a predefined, linear lifecycle. This design eliminates the arbitrariness of human operations and ensures the Atomicity and Immutability of fund states.

#### mathematical model

We define each guaranteed transaction $T$ as a 5-tuple automaton:

$$
M = (Q, \Sigma, \delta, q\_0, F)
$$

Among them:

* $$ $Q$ $$ is a finite set of states $$ ${Initial, Locked, Delivered, Disputed, Finalized, Void}$ $$
* $$ $\Sigma$ $$ is a collection of input events (such as `Deposit`, `SubmitProof`, `RaiseDispute`）。
* $$ $\delta: Q \times \Sigma \rightarrow Q$ $$ is a state transition function, which strictly specifies the legal flow paths. For example, the system does not have a transition from $$ $Locked$ $$ Jump directly to $$ $Finalized$ $$ path must pass through $$ $Delivered$ $$ or the input of an external arbitration signal.
* $$ $q\_0$ $$ It is the initial state.
* $$ $F$ $$ is the set of termination states (funds have been settled).

#### Institutional advantages

* Deadlock Prevention: Through built-in Timelocks and timeout rollback logic, FSM ensures that funds will never be permanently stuck in the contract regardless of any accidents (such as the loss of one party's private key).
* Formal Verification Friendly: Due to the limited and closed state space, OES logic can be easily verified through formal methods, thereby eliminating logical vulnerabilities and reentrancy attack risks at the mathematical level.

***

#### 1.2.2 The Probabilistic Layer: DAN & Game Theory

When the FSM enters `Disputed`In a (dispute) state, pure code logic can no longer handle it, the system then suspends, and control is transferred to DAN (Decentralized Arbitration Network).

DAN is not seeking "absolute truth" (which is philosophically difficult to define), but rather a Schelling Point through mechanism design——that is, a Focal Equilibrium in non-cooperative games that people tend to choose when they cannot communicate.

**Schelling Point Consensus**

OmniPact Hypothesis: In a network composed of diverse, anonymous, and economically rational arbitrators, the "truth" in the eyes of the majority is the consensus.

To encourage arbitrators to vote honestly, we have introduced a reward and punishment matrix based on the Nash Equilibrium:

1. Voting Consistency (Coherence): Arbitrators cannot communicate with each other (to prevent collusion). The system rewards arbitrators whose votes are consistent with the majority (Majority) and punishes those whose votes are inconsistent with the majority.
2. Expected Value Analysis (EV Analysis):

   For a rational arbitrator J, if he attempts to lie (by voting for the false party), he must bet that "the majority of other arbitrators will also decide to lie." However, without collusion, this is a high-risk strategy.

   Conversely, voting for the obvious truth (for example: seeing an obviously fake delivery screenshot) is the safest strategy for all rational participants. Therefore, "truth" becomes the only Schelling point.

#### Economic incentive formula

The arbitrator's profit function $R$ can be expressed as:

$$
R\_i = \begin{cases} \beta \cdot F\_{arb} + \frac{\sum S\_{lost}}{N\_{win}} & \text{if } V\_i = V\_{consensus} \ -S\_{stake} & \text{if } V\_i \neq V\_{consensus} \end{cases}
$$

Among them, $S\_{stake}$ is the $PACT token staked by arbitrators. This means that malicious behavior not only yields no benefits but also faces the risk of principal confiscation (Slashing). This asymmetric risk-return ratio constructs a strong cryptoeconomic security barrier for the protocol (Cryptoeconomic Security).

***

#### 1.2.3 Architecture Overview: A Closed Loop from Code to Consensus

The innovation of OmniPact lies in successfully bridging these two worlds:

1. Under normal circumstances: Transactions mainly run on the OES-FSM layer. This is an efficient and low-cost automated layer that handles 99% of normal transactions. Code is Law.
2. Under abnormal circumstances: once a dispute arises, the game theory layer intervenes. This is a social layer with high security and high judgment. At this time, social consensus is law (Consensus is Law).

Through this hybrid design of "FSM for Efficiency, Game Theory for Truth" (Finite State Machine ensures efficiency, Game Theory ensures truthfulness), OmniPact has successfully transformed any non-standardized business interaction into credible on-chain settlement, completely solving the "commercial oracle problem".


# 1.3 Design Philosophy: Modularity, Security, Agnosticism

The architectural design of OmniPact is not intended to solve payment problems in a single scenario, but to build a universal and evolvable infrastructure for value exchange. To adapt to the exponential growth of complexity in the future Web3 ecosystem, we have established three core design principles: Modularity, Security, and Agnosticism.

#### 1.3.1 Modularity: Composable Legos

Traditional intermediary platforms are often based on a monolithic architecture, making them difficult to scale. OmniPact adopts an unbundling design strategy, splitting the protocol into three independent logical layers, allowing developers to build customized transaction processes like assembling Lego blocks.

* Logic Decoupling: We completely separate "fund custody (Vault)" from "business trigger logic (Controller)". The core of OES is only responsible for the underlying asset locking and transfer, while complex business logic (such as milestone release, multi-party account splitting, and scheduled unlocking) is encapsulated in independent Periphery Contracts.
* Pluggable Design (Pluggable Architecture):
  * The protocol supports dynamically generating specific transaction templates through the Factory Pattern.
  * Developers can write custom "Hooks" contracts. For example, an NFT marketplace can develop a "royalty automatic deduction Hook", which can be seamlessly integrated into the standard OmniPact escrow process without modifying the core protocol code.
* Benefits: This high degree of modularity not only reduces the risk of single-point upgrades but also endows the protocol with Antifragility — the more prosperous the ecosystem, the richer the available template component library.

#### 1.3.2 Security: Defense in Depth

As the underlying protocol that carries user assets, security is the lifeline of OmniPact. We have abandoned single-dimensional security defenses and built a multi-layered protection network based on the "Defense in Depth" concept.

* Code layer: formal verification(Formal Verification)：

  We not only rely on audits but also introduce formal verification at the mathematical level. By converting the core state machine logic into mathematical proofs, we mathematically eliminate common vulnerabilities such as overflow, reentrancy (Reentrancy), and deadlocks before deployment.
* Economic layer: Asymmetric Cost of Corruption：

  Security is not only about having bug-free code, but also about having a flawless economic model. In the design of the DAN arbitration network, we ensure that the cost of attack(Cost of Corruption) >> Profit from Corruption。Through the staking slashing mechanism, if an attacker wants to profit by controlling the arbitration result, they must pay a capital cost far exceeding the potential gain.
* Governing Body: (Timelocks & Multisig)：

  Any modifications to core protocol parameters (such as fees, arbitrator thresholds) must go through DAO governance voting and are subject to a 48-hour Timelock restriction. This gives the community sufficient time to respond (such as withdrawing funds) before malicious proposals take effect.

#### 1.3.3 Agnosticism: Universal Neutrality

OmniPact is committed to becoming the "TCP/IP protocol" of Web3 — a pipeline for efficiently transmitting value, without caring about what is being transmitted. This "agnosticism" is reflected in three dimensions:

* Asset Agnostic：

  The protocol does not distinguish between the types of underlying assets. Whether it is a native ERC-20 token, NFT (ERC-721/1155), or RWA synthetic token representing real-world assets, OES treats them all as standard asset objects and handles them equally.
* Chain Agnosticism：

  OmniPact is not dependent on a single blockchain. By integrating interoperability standards such as LayerZero and CCIP (Chainlink Cross-Chain Interoperability Protocol), OES can seamlessly synchronize states across Ethereum mainnet, L2 (Arbitrum/Optimism), and even non-EVM chains (such as Solana). Users can lock funds on Polygon and trigger arbitration on Ethereum.
* Judgment Agnostic：

  The agreement itself has no moral stance. It does not presuppose what is "right" or "wrong." It provides only a fair framework for procedural justice. The outcome of the ruling depends entirely on the evidence and the game-theoretic consensus of the DAN network. This neutrality ensures that the agreement can be adapted to business needs in different jurisdictions and cultural contexts around the world.

> The design philosophy of OmniPact is not just about building a product, but about defining a set of standards. Modularity endows us with flexibility, security grants us the right to exist, and agnosticism gives us infinite boundaries. These three together form the cornerstone of OmniPact as a global decentralized trust infrastructure.


# System Architecture & Topology

To demonstrate the robustness and scalability of the OmniPact system architecture, this section describes it using the Layered Architecture Pattern. We decouple the complex protocol logic into four functionally independent layers, with each layer interacting with the upper and lower layers through standardized interfaces. This design not only ensures the modularity of the system but also reserves interfaces for future cross-chain deployment and privacy upgrades.


# 2.1 The Four-Layer Stack

The overall architecture of OmniPact follows the "Separation of Concerns" principle. We divide the protocol stack from bottom to top into: the settlement layer, the core protocol layer, the data privacy layer, and the interface layer.\
The following diagram shows the data flow and logical control relationships of this vertical architecture:

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

    subgraph L3["L3: Data & Privacy Layer (Data and Privacy Layer)"]
        Oracle[Chainlink Oracles]
        IPFS[IPFS Storage]
        TEE[TEE / ZK-Circuits]
    end

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

    subgraph L1["L1: Settlement Layer (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&#x20;

—— -- Multi-chain Adapters & Finality Anchoring

L1 is the physical foundation of the protocol, responsible for asset custody, transfer, and final confirmation of transaction status. OmniPact does not build its own public chain; instead, it is deployed as a set of smart contracts on existing high-performance blockchains.

* Multi-chain Adapters:\
  To achieve "chain agnosticism", we have designed the ISettlementAdapter abstract interface at the underlying layer. This interface eliminates the differences between underlying virtual machines:
  * EVM Adapter: Compatible with Ethereum, Arbitrum, BSC, Optimism and other chains based on Solidity/Vyper.
  * SVM Adapter: Adapt to parallel execution environments such as Solana (Rust).
  * WASM Adapter: Adapt to WASM environments such as Polkadot and Cosmos.
* Asset Custody:

  L1 does not handle complex business logic and is only responsible for the most "foolish" yet critical task: Atomic Transfer. Funds are locked in decentralized Vault Contracts, and the transfer() operation is only executed upon receiving valid instructions from L2 (accompanied by correct cryptographic signatures or state roots).
* Cross-Chain Bus:

  Using LayerZero or CCIP, L1 is responsible for handling the emission and reception of cross-chain messages, ensuring that funds locked on Chain A can be safely triggered for release on Chain B.

***

#### L2: Core Protocol Layer

—— -- Business Logic & State Management

L2 is the "brain" of OmniPact, containing the core smart contract logic of the protocol. All rules regarding the guarantee process, arbitration voting, and reputation calculation reside here.

* OES Engine (Omni Escrow System):

  This is a deterministic finite state machine (FSM). It maintains a global guarantee contract registry (Registry) and the state of each order.（$S\_{locked}$, $S\_{delivered}$, etc.）It defines the rules for fund flow but does not directly hold funds (funds are held by L1).
* DAN Contracts (Decentralized Arbitration Network):

  Responsible for governance and judicial logic.

  * Sortition Module: Execute the VRF lottery algorithm to select arbitrators.
  * Voting Module: Process the Commit-Reveal voting process and calculate the game theory equilibrium results.
  * Incentive Module: Automatically allocate arbitration fees and implement slashing.
* Logic Upgradeability :

  The OpenZeppelin UUPS (Universal Upgradeable Proxy Standard) proxy pattern is adopted. This allows us to fix logical vulnerabilities or optimize algorithms in L2 through DAO voting without migrating user funds (L1) and data (L3).

***

#### L3: Data & Privacy Layer

—— -- Off-Chain Compute & Verifiable Storage

Due to the high cost and public nature of blockchain storage itself, OmniPact has introduced L3 to handle data interactions involving large amounts of data, privacy-sensitive information, or those that need to connect to the real world.

* Decentralized Storage (IPFS/Arweave):
  * Purpose: Store large unstructured data, such as contract PDFs, original design drafts, and arbitration evidence images.\
    ◦\
    Mechanism: Only store the CID (Content Identifier) hash value of the file on the L2 chain. This ensures the immutability of the data while reducing Gas costs.
* Oracles (Oracle Network):
  * Purpose: Obtain "off-chain truth".
  * Integration: Integrate Chainlink Functions and Automation. For example, automatically read the logistics status from the FedEx API, or monitor the longitude and latitude signals of IoT devices, which can serve as triggers for the flow of L2 state machines.
* Privacy Compute (TEE & ZK):
  * TEE (Trusted Execution Environment): Use Intel SGX hardware enclaves to process extremely sensitive data (such as private key shards, unencrypted trade secrets).
  * ZK-Circuits : Used for zk-KYC and zk-Reputation. Without exposing the user's original data (such as passport number), generate a mathematical proof for L2 $$ $\pi$ $$, proving that the user meets compliance requirements.

***

#### L4: Interface Layer&#x20;

—— -- Developer Experience & Access Gateway

L4 is a portal for users and external applications to interact with protocols. It abstracts the underlying complex contract logic into easy-to-use APIs and SDKs.

* OmniPact SDK (TypeScript/Python/Go):

  A code library encapsulated for developers. Developers do not need to directly write Solidity calls; they only need to call omnipact.createEscrow({...}) to integrate the escrow function. The SDK has built-in IPFS upload, data encryption, and wallet signature logic.
* The Graph Subgraphs (Index Layer):\
  Since querying historical data directly from blockchain nodes is extremely inefficient, we have deployed GraphQL Subgraphs.Function: Index all OES events (such as `EscrowCreated`, `DisputeRaised`）。
  * Purpose: Front-end DApps can obtain "all historical orders of a certain user" or "the list of cases currently in dispute" in milliseconds.
* Relayer API (Relay Service):

  To support "Gasless Transactions (Gasless Tx)" and "Account Abstraction", L4 provides relay services. Users only need to sign the message (EIP-712), and the relayer is responsible for on-chain processing and paying Gas fees on their behalf (the fees are deducted from the collateral amount), which greatly lowers the entry barrier for Web2 users.

***

Through the organic combination of a four-layer architecture, OmniPact achieves the perfect integration of settlement security (L1), logical rigor (L2), data scalability (L3), and ease of use (L4).


# 2.2 Contract Map

This section conducts an in-depth analysis of the interaction topology at the smart contract level. To demonstrate the team's professionalism in contract architecture design (Gas optimization, upgradability, security), OmniPact adopts the "Hub-and-Spoke" and "Singleton Vault" models for description. This aligns with the design trends of the most advanced DeFi protocols currently (such as Uniswap V4, Balancer V2).

***

### 2.2 Contract Map & Interaction Topology

The core protocol of OmniPact consists of a set of tightly coupled smart contracts with clear responsibilities. We have adopted a Hub-and-Spoke architecture, where Registry serves as the core router, Vault centrally manages assets, and Factory is responsible for dynamically expanding business logic.

#### 2.2.1 Interaction Diagram

The following diagram shows the calling relationships and permission control flows between various core contract components:

<figure><img src="/files/LrPC2d9za5y3kwvuZog8" alt=""><figcaption></figcaption></figure>

Code segment

```
graph TD
    User[End User / Client]
    DAO[Governance DAO]

    subgraph "Core Protocol (L2)"
        Factory[OmniFactory (EIP-1167)]
        Registry[OmniRegistry (The Hub)]
        Vault[OmniVault (Singleton Asset Manager)]
        
        subgraph "Escrow Instances (Clones)"
            OES_A[OES Instance A (OTC)]
            OES_B[OES Instance B (Gig)]
        end
    end

    subgraph "External"
        Token[ERC-20 / NFT Assets]
        DAN[DAN Controller]
    end

    %% Flow: Governance
    DAO -->|1. Configure Parameters| Registry
    DAO -->|2. Whitelist Strategy| Factory

    %% Flow: Creation
    User -->|3. createEscrow()| Factory
    Factory -->|4. Deploy Clone| OES_A
    Factory -->|5. Record ID| Registry

    %% Flow: Asset Lock
    User -->|6. Approve & Deposit| Vault
    Vault -.->|7. Accounting Mapping| OES_A

    %% Flow: Execution
    OES_A -->|8. Request Settlement| Vault
    Vault -->|9. Transfer Funds| User
    
    %% Logic Link
    OES_A -.->|Read Config| Registry
    OES_A -.->|Trigger Dispute| DAN
```

#### 2.2.2 Component Breakdown

**A. OmniRegistry (The Source of Truth)**

Role: The "brain" and "DNS server" of the system.

* Function:
  * Address resolution: Maintain the latest address mappings of all valid components (Factory, Vault, DAN).
  * Whitelist management: Store legal items that have been audited by DAO `Implementation`(Transaction Template) address.
  * Parameter control: Global rate（Protocol Fee）and the storage location for system parameters such as the minimum pledge threshold.
* Interaction: All OES instances must call before executing critical logic. `Registry.getConfig()` Validate parameters to ensure the consistency of the system state.

**B. OmniFactory (The Scaler)**

Role: A standardized "money-printing machine".

* Technical implementation:
  * Adopt the EIP-1167 (Minimal Proxy Standard) standard.
  * Instead of repeatedly deploying the complete bytecode, the Factory deploys extremely lightweight Clones (proxy contracts) that point to the pre-deployed `Implementation` Logical contract.
* Advantage: Reduce the Gas cost of deploying a new guarantee contract by more than 90% (only about 45k Gas), making high-frequency small-value transactions economically feasible.

**C. OmniVault (The Strongbox)**

Role: Singleton Asset Manager.

* Design Philosophy:
  * OmniPact does not create a separate deposit contract for each order (this would lead to extreme asset fragmentation and high Gas costs).
  * On the contrary, we maintain a global `OmniVault` Contract, where all users' funds are pooled.
* Internal Accounting Book (Internal Accounting)：
  * Vault internal maintenance `mapping(bytes32 escrowId => uint256 balance)`Account book.
  * Flash Loan Defense：Supports the ERC-3156 flash loan standard, uses idle funds to earn passive income for the protocol (this part of the income is used to repurchase $PACT), but through `ReentrancyGuard` Strictly prevent reentrancy attacks.
* Permission control: only the status is `Active` and only OES instances that have been registered in the Registry are authorized to call Vault's`transfer` Function.

**D. Governance (The Controller)**

Role: Decentralized administrator.

* TimelockController：
  * All management operations on the Registry and Vault (such as upgrading contracts and withdrawing fees) must go through a TimeLock contract.
  * Delayed effect: After a proposal is passed, it takes 48 hours to be executed. This gives the community the right to check the code or withdraw funds during this window period to prevent "Governance Attack".

#### 2.2.3 Critical Interaction Lifecycle

To more clearly illustrate how contracts collaborate with each other, the following is a call stack trace of a standard transaction:

1. Setup:
   * User call `OmniFactory.createEscrow(TemplateID, Params)`。
   * Factory usage `Clones.clone()` Deploy a new OES instance and assign a unique one to it. `EscrowID`。
   * Factory call `OmniRegistry.register(EscrowID)` Filing for record.
2. Locking:
   * Users' views on `OmniVault` perform ERC-20 `approve()`。
   * The user invokes the OES instance. `deposit()`。
   * OES instance callback `OmniVault.depositFrom(User, Amount)`。
   * `OmniVault` Transfer assets from the user to oneself and record the transaction in the internal ledger:`balances[EscrowID] += Amount`。
3. Settlement:
   * When the conditions are met (such as the buyer confirming receipt of the goods), the status of the OES instance changes to`Finalized`。
   * OES `OmniVault.withdrawTo(Seller, Amount)`。
   * `OmniVault` Verify that the caller is a legitimate OES instance and that the account balance is sufficient.
   * `OmniVault` Execute the underlying ERC-20 transfer to send the funds to the seller's wallet.

***

This architectural design (Singleton Vault + Proxy Factory) represents the highest current industrial standard in Ethereum development, and can convey to readers the project team's ultimate pursuit of fund security and Gas optimization.


# OES: The Omni Escrow System

OES is the execution kernel of the OmniPact protocol. It abandons the uncertainty brought by Turing-complete languages and instead adopts the architecture of Deterministic Finite State Machine (DFSM). This design principle ensures that the life cycle of each secured transaction is predictable, verifiable, and non-rollbackable.


# 3.1 Deterministic Finite State Machine (DFSM)

In OES, we not only regard state machines as a code pattern, but also as a kind of mathematical constraint. We have defined a five-tuple automaton.$$ $M$ $$ Let's formally describe the guarantee process:

$$
M = (Q, \Sigma, \delta, q\_0, F)
$$

#### 3.1.1 Mathematical Definition of States

* $Q$(Finite state set): All possible legal states in the protocol.

$$
Q = {S\_{init}, S\_{lock}, S\_{del}, S\_{disp}, S\_{fin}, S\_{void}}
$$

* $$ $S\_{init}$ $$ (Initialized):The contract is instantiated, parameters have been configured, waiting for funding.
* $$ $S\_{lock}$ $$ (Locked): The buyer's funds have been deposited into the Vault, and the guarantee has taken effect.
* $$ $S\_{del}$ $$ (Delivered): The seller submitted the on-chain performance certificate (Proof of Delivery).
* $$ $S\_{disp}$ $$ (Disputed): A dispute is triggered, the contract is suspended, and control is transferred to DAN.
* $$ $S\_{fin}$ $$ (Finalized): Normal case closure, with funds flowing to the seller.
* $$ $S\_{void}$ $$ (Voided): If the transaction is cancelled or an arbitration ruling decides on a refund, the funds will be returned to the buyer.
* $$ $q\_0$ $$ (Initial state): $$ $S\_{init}$ $$
* $$ $F$ $$ (Set of terminating states): $$ ${S\_{fin}, S\_{void}}$ $$。Once entering this set, the state becomes immutable.(Immutable)。

#### 3.1.2 Transition Function $$ $\delta$ $$

transfer function $$ $\delta: Q \times \Sigma \rightarrow Q$ $$ Defines the legal state transition paths. Any attempt to transition that is not defined in this function will be handled by the smart contract's `require()`Statement interception and rollback (Revert)。

#### The core transfer logic is as follows:

1.Locking Transition:

$$
\delta(S\_{init}, \text{Deposit}) \rightarrow S\_{lock}
$$

Constraints: msg.value >= amount or token.transferFrom Success.

2.Delivery Transition.

$$
\delta(S\_{lock}, \text{SubmitProof}) \rightarrow S\_{del}
$$

Constraints: Only the seller can call, and block.timestamp < deliveryDeadline。

3.Settlement Transition:

$$
\delta(S\_{del}, \text{Confirm}) \rightarrow S\_{fin}
$$

Constraints: Buyer's signature confirmation or block.timestamp > inspectionPeriod (Automatic acceptance)。

4.Dispute Interrupt:

$$
\delta({S\_{del}, S\_{lock}}, \text{RaiseDispute}) \rightarrow S\_{disp}
$$

Constraints: within the inspectionPeriod, and neither party has confirmed.

#### 3.1.3 Atomic Swap Implementation

OES leverages the atomic nature of blockchain to implement Conditional Asset Swap. Unlike traditional Hash Time-Locked Contracts (HTLC), which rely solely on hash preimages, OES expands the triggering conditions.

Solidity Style Pseudocode:

Solidity

```
function releaseFunds(uint256 escrowId) external nonReentrant {
    // 1. Load State
    Escrow storage e = escrows[escrowId];
    
    // 2. Validate State (Check Logic)
    // Must be in the "delivered" state and no disputes have occurred.
    require(e.state == State.DELIVERED, "Invalid state");
    
    // 3. Validate Triggers (Condition Logic)
    bool isManuallyConfirmed = msg.sender == e.buyer;
    bool isAutoRelease = block.timestamp > e.timelock + e.inspectionPeriod;
    require(isManuallyConfirmed || isAutoRelease, "Not releasable yet");

    // 4. State Update (Effects)
    // Modify the state before transferring funds to prevent reentrancy attacks(Checks-Effects-Interactions Pattern)
    e.state = State.FINALIZED;
    
    // 5. Execution (Interaction)
    // Call the Vault singleton for fund transfer
    IVault(vaultAddress).transferAssets(e.asset, e.seller, e.amount);
    
    emit FundsReleased(escrowId, e.seller, e.amount);
}
```

Security Properties:

* Idempotency: because the state was modified in step 4 to `FINALIZED`, even if the attacker calls the function again, it will still be in step 2 `require` fail. This ensures that the funds can only be released once.
* Delivery-versus-Payment (DvP): The only prerequisite for the release of funds is that the state machine has successfully transitioned to $$ $S\_{del}$ $$(meaning that the seller has submitted evidence). Mathematically, it is guaranteed that the buyer cannot withdraw funds unless the seller has submitted the action (except for refund upon timeout).


# 3.2 The Vault Standard: OmniVault

OmniVault is the "central bank" of the protocol. It adopts a Singleton architecture to centrally manage all liquidity within the protocol. To maximize capital efficiency and ensure the rigor of accounting standards, OmniVault strictly adheres to the ERC-4626 Tokenized Vault Standard.

#### 3.2.1 ERC-4626 Implementation for Yield-Bearing Escrow

In traditional guarantee agreements, funds remain idle during the Lock Period, resulting in significant opportunity costs. OmniVault converts idle funds into interest-bearing assets through modular Strategy Adapters.

1\. Architecture Logic

OmniVault implements the IERC4626 interface. When a user deposits assets (such as USDC) into the collateral contract, the Vault will perform the following atomic operations:

* Deposit: User deposits $$ $Asset$ $$。
* Mint: Vault Mint internal tokens according to the current exchange rate $$ $Share$ $$（份额）。
* Invest: Vault will $$ $Asset$ $$ Inject into low-risk DeFi protocols that have passed DAO whitelist certification (such as Aave V3 Lending Pool or Lido Staking).

2\. Share Calculation

To handle the balance changes caused by interest accrual, Vault only tracks shares internally. The asset exchange rate is determined by the following formula:

$$
ExchangeRate = \frac{TotalAssets\_{underlying} + AccumulatedYield}{TotalShares\_{minted}}
$$

* When the guarantee ends (Finalization), the seller receives not only the original principal but also can choose to be configured to receive principal + returns, or the agreement will use the return portion as Protocol Revenue to repurchase $PACT tokens.
* Risk isolation: Each asset (such as USDC, ETH) corresponds to an independent Vault instance to prevent the spread of bad debts from a single asset.

3\. Strategy Safety

To prevent risks from external DeFi protocols, OmniVault has implemented strict "Conservative LTV" (Conservative Loan-to-Value) and "Emergency Exit" mechanisms. Once a peg deviation in an external protocol is detected, the Keeper will trigger emergencyWithdraw(), withdrawing the funds to the local Vault for freezing.

***

#### 3.2.2 Asset Segregation Logic

Although all funds are physically stored in the same Vault contract address, logically, the funds for each secured transaction are absolutely isolated. This design of "physical centralization and logical isolation" greatly reduces Gas consumption.

1\. Virtual ledger (Virtual Accounting Ledger)

VaultIt internally maintains a multi-dimensional mapping table as the sole source of truth(Source of Truth)：

Solidity

```
// Mapping: EscrowID => (TokenAddress => Amount)
mapping(bytes32 => mapping(address => uint256)) private _escrowBalances;

// Mapping: EscrowID => StrategyAddress
mapping(bytes32 => address) private _activeStrategies;
```

2\. Access Control List(Access Control List - ACL)

OmniVault Not just anyone can call it. It implements a strict whitelist mechanism:

* OnlyOES: Only when `OmniRegistry`registered in and the status is `Active` OES instance of（Proxy Contract）Only has the right to call `transfer` or `withdraw` Function.
* Scope Restriction: OES instance A can only operate `_escrowBalances[ID_A]` funds. It strictly prohibits accessing or embezzling the balance of OES Instance B. This eliminates the risk of cross-order fund embezzlement at the code level.

3\.  Flash Loans & Liquidity Buffer

Due to Vault's deep capital pool, OmniVault natively supports the ERC-3156 Flash Loan standard.

* Idle uninvested funds can be lent to arbitrageurs.
* The handling fee generated by flash loans (such as 0.09%) is directly injected into`AccumulatedYield`so that all users engaged in secured transactions can passively share in this profit.
* Safety lock: The flash loan logic is being `ReentrancyGuard` Wrap, and strictly verify `callback` the integrity of the remaining balance afterwards, ensuring zero risk to the principal.

***

> OmniPact is not just a payment or transaction tool, but a financial infrastructure with DeFi composability and capital efficiency.


# 3.3 Conditional Triggers

In the OES architecture, the state transition function $$ $\delta(S, \sigma) \rightarrow S'$ $$ input signal $$ $\sigma$ $$ It is not limited to simple deposits and withdrawals of funds. We have built a modular trigger stack that supports complex conditional logic based on time, data, and cryptographic credentials.

#### 3.3.1 Time-based Triggers&#x20;

Time is the only objective and trustless variable on the blockchain. OES utilizes Ethereum's`block.timestamp` As an immutable clock source, it implements two types of core logics: Relative Timelocks and Absolute Time Windows.

1\. Liveness Guarantees

To prevent fund deadlocks caused by one party losing contact, the agreement enforces timeout-based mandatory state transitions:

* Seller Timeout:

$$
Condition: S\_{state} = Locked \land t\_{now} > T\_{deposit} + \Delta t\_{delivery}
$$

```
If the seller within $\Delta t_{delivery}$ The buyer shall obtain (it) if the performance certificate is not submitted within the period. reclai m() Permissions, trigger atomic refund.
```

* Auto-Finalization:

$$
Condition: S\_{state} = Delivered \land t\_{now} > T\_{delivery} + \Delta t\_{inspection}
$$

If the buyer has not initiated a dispute by the end of the cooling-off period $\Deltat\_{inspection}$, the system will assume "tacit satisfaction" and allow Keepers to trigger the release of funds.

2.Vesting Logic

For service or compensation guarantees, OES supports the streaming payment logic:

$$
Available(t) = Amount\_{total} \times \frac{t\_{now} - t\_{start}}{t\_{end} - t\_{start}}
$$

This allows funds to be unlocked linearly according to block time instead of being delivered all at once, reducing the prepayment risk for buyers.

***

#### 3.3.2 Oracle-based Triggers

This is a key component of OmniPact's implementation of "real-world perception". We have deeply integrated Chainlink Functions and Automation to convert Web2 API data into on-chain verifiable boolean values.

1\. Request-Response Pattern

OES does not directly initiate HTTP requests; instead, it executes them through a decentralized oracle network (DON) proxy:

1. Request: OES contract emits an event `OracleRequest(url, query, script)`。
2. Consensus: Chainlink DON nodes independently execute JavaScript code (such as querying FedEx API for logistics status or FlightAware for flight delay data) and perform aggregated consensus on the results.
3. Callback:  `bool isDelivered = true`）and its signature written back to OES `fulfillRequest()` Interface.

2.Verification & Aggregation

To prevent a single API source from misbehaving, OES supports a multi-source aggregation strategy:

$$
Trigger = (\text{API}\_A \land \text{API}\_B) \lor (\text{API}\_C)
$$

Status changes will only be triggered when cross-validation by multiple independent data sources (such as DHL + UPS + local postal services) is successful.

$$
\delta(S\_{lock}) \rightarrow S\_{del}
$$

***

#### 3.3.3 Signature-based Triggers&#x20;

For scenarios requiring human subjective confirmation, OES adopts a multi-signature logic based on EIP-712 (Typed Structured Data Hashing and Signing). This not only optimizes Gas costs (off-chain signing, on-chain verification) but also ensures that users clearly know what they are signing.

1\. Intent Verification

All manual operations (such as confirmDelivery, cancelOrder) all require the submission of an ECDSA signature that conforms to the following structure:

Solidity

```
struct ReleaseIntent {
    bytes32 escrowId;
    uint256 amount;
    string action; // "RELEASE" or "REFUND"
    uint256 nonce;
    uint256 deadline;
}
```

Contract passed `ecrecover` Recover the signer's address and connect with `Registry` Compare with the participants (Buyer/Seller/Arbiter) in it.

2\. 2-of-3 Escrow Multisig

In some lightweight modes (without invoking the DAN network), OES can be configured in the classic 2/3 multi-signature mode:

* Key A: buyer
* Key B: seller
* Key C: A mutually trusted intermediary (or DAN agent) jointly designated by both parties
* Trigger logic: Fund release requires $$ $\text{Sign}\_A + \text{Sign}*B$ $$(Happy cooperation) or $$ $\text{Sign}*{A/B} + \text{Sign}\_C$ $$(Dispute mediation).

This mechanism allows both parties to conduct multiple negotiations without consuming on-chain Gas, and only broadcast a transaction to the chain when a final consensus is reached, which greatly reduces the collaboration cost.

***

> The flexibility of OmniPact in handling complex business logic: ensuring liveness through time, connecting to reality through oracles, and anchoring human intentions through signatures.


# 3.4 Cross-Chain Interoperability

This section explains how OmniPact breaks the siloed effect of blockchains and realizes the vision of "Chain Agnostic". We provide a detailed comparison of two mainstream cross-chain asset processing models and demonstrate how to build a universal cross-chain guarantee network using CCIP and LayerZero.

To achieve the vision of "Omni" (all-capable / cross-chain), OmniPact must go beyond the limitations of a single chain. We have built an X-Escrow (Cross-Chain Escrow) protocol layer that allows users to lock funds on Chain A while triggering performance and settlement on Chain B.

#### 3.4.1 Generalized Messaging Architecture&#x20;

OmniPact does not build its own network of verification nodes. Instead, it adopts the "Transport Layer Abstraction" model and integrates the industry's most mature interoperability standards - Chainlink CCIP (Cross-Chain Interoperability Protocol) and LayerZero.

Messaging Topology:

* Source Chain : Send instructions such as`LockFunds`
* Transport Layer : Responsible for relaying and verifying cross-chain messages.
* Destination Chain : Receive instructions and execute state changes such as `CreateEscrow`

Security Stack:

We have adopted Multi-Network Validation. For high-value transactions, the protocol mandates that both the Active Risk Management (ARM) network verification from CCIP and the confirmation from LayerZero Oracle must be obtained simultaneously before executing the Mint or Unlock operations on the target chain. This redundant design eliminates the systemic risk of a single bridging protocol being hacked.

***

#### 3.4.2 X-Escrow Asset Transfer Mechanisms

For different types of assets and liquidity needs, OmniPact has implemented two completely different asset processing mechanisms in X-Escrow.

**A. Lock-and-Unlock**

Suitable for native asset bridging (such as transferring USDT from the ETH mainnet to Arbitrum).

* Process:
  1. Source (Chain A): Buyer call `OES.lock(),`The funds were transferred to Chain A's Liquidity Pool Contract and frozen.
  2. Message: The protocol generates a Proof that proves "1000 USDT has been locked on Chain A".
  3. Destination (Chain B): Once Chain B's OES receives the Proof and verifies it, it unlocks an equivalent amount of USDT from Chain B's Liquidity Pool (if liquidity is sufficient) and transfers it to a brand new Escrow instance, or generates a Virtual Balance for accounting purposes.
* Advantages: It maintains the canonical nature of the asset without issuing new tokens.
* Disadvantage: Depends on the liquidity depth of the target chain.

**B. Burn-and-Mint**&#x20;

Applicable to OmniPact native token ($PACT) or assets that support the OFT/CCTP standard (such as USDC).

* process:
  1. Source (Chain A): The buyer's funds are immediately burned on Chain A.（Send to`0x00...`address）.
  2. Message: Cross-chain message carrying `Burn` certificate.
  3. Destination (Chain B): Chain B contracts directly mint an equivalent amount of assets to an Escrow escrow address.
* Circle CCTP Integration: For USDC transactions, we have deeply integrated Circle's cross-chain transfer protocol (CCTP) to achieve native Burn-and-Mint, eliminating the risk of decoupling from bridged assets (Wrapped Tokens).
* Advantages: It completely solves the problem of liquidity fragmentation and theoretically supports unlimited cross-chain transfers.
* Disadvantage: It only applies to specific tokens that support the standard.

#### 3.4.3 State Synchronization&#x20;

The core challenge of X-Escrow lies not in asset transfer, but in cross-chain state machine synchronization (FSM Synchronization).

Scenario: Chain A makes payment, Chain B fulfills the payment.

1. Init: The buyer locked funds in Chain A (Optimism).
2. Sync: state $$ $S\_{lock}$ $$ The Shadow Contract was synchronized to Chain B (Polygon).
3. Action: The seller submitted proof of performance on Chain B via Polygon's low-gas environment, and the status changed to $$ $S\_{del}$ $$。
4. Callback: Chain B sends a cross-chain callback message to Chain A.
5. Settlement: Chain A receives the "fulfilled" signal and updates its status to $$ $S\_{fin}$ $$，And release the funds to the seller's wallet in Chain A.

This "Control on Cheap Chain, Assets on Secure Chain" model is OmniPact's biggest architectural advantage over traditional single-chain guarantee protocols.

***

> This section demonstrates how OmniPact, through its sophisticated technical architecture, provides users with an extremely simple "seamless cross-chain" experience, establishing its position as a general-purpose Web3 infrastructure.


# DAN: Decentralized Arbitration Network

DAN is the "social consensus layer" of the OmniPact protocol. Instead of relying on a single trusted entity, it utilizes cryptoeconomic incentives to transform the dispute resolution process into a collaborative game.


# 4.1 Game Theoretic Consensus

DAN's core operating mechanism is based on the SchellingCoin concept proposed by Vitalik Buterin. Through mechanism design, we make "honest voting" the only strong Nash equilibrium in this game.

#### 4.1.1 The Schelling Point Mechanism

Definition:

In game theory, the Schelling point refers to the "default" or "natural" solution that participants tend to choose in the absence of communication.

Applications in DAN:

In a binary arbitration case (e.g., buyer wins vs. seller wins), arbitrators $J\_1, J\_2, ..., J\_n$ must vote without being able to communicate with each other (due to the Commit-Reveal mechanism).

* Incentive objective: The system does not reward the "correct" answer (because there is no God-like correct answer in a decentralized network), but rather the answer that is "coherent" (in line with the majority).
* The Shared Signal: The arbitrator hopes to select the option that the majority would choose. In this game, the only shared signal is the Truth.
  * The truth is obvious (e.g., look at the shipping photos).
  * Lying requires complex collaboration (e.g., which is the lie? Should we choose A or B?). Without channels of communication, coordinating a specific lie is virtually impossible.
  * Therefore, "truth" becomes the Schelling point in the game. A rational arbitrator, in order to maximize their gains, will expect others to choose the truth, and thus choose the truth themselves.

#### 4.1.2 Nash Equilibrium Analysis in Juror Voting

To prove the security of the system, we construct a formalized payoff matrix model.

1\. Model Setup

Suppose we have a simple choice between two options:

* Options $$ $A$ $$: the truth(Honest outcome)
* Options $$ $B$ $$: lie (Dishonest outcome)
* Arbitrators $$ $N = {1, 2, ..., k}$ $$
* Each arbitrator $$ $i$ $$ The number of staked tokens is $$ $S$ $$。
* Voting rewards are$$ $R$ $$,Inconsistency penalty is $$ $\alpha \cdot S$ $$（in $$ $0 < \alpha \le 1$ $$）。

2\. Payoff Matrix

Consider arbitrator Alice's strategy, assuming she believes that a majority of the other arbitrators will vote in favor of one party:

| **Alice's Vote (vi​)** | **Majority's Vote (Vmaj​)** | **Alice's Payoff (Pi​)**            | **Result** |
| ---------------------- | --------------------------- | ----------------------------------- | ---------- |
| A (Truth)              | A (Truth)                   | $$ $+ R$ $$+R$$ $+ R$ $$$$ $+ R$ $$ | Profit     |
| A (Truth)              | B (Lie)                     | -As$$ $- \alpha S$ $$               | Loss       |
| B (Lie)                | A (Truth)                   | -As$$ $- \alpha S$ $$               | Loss       |
| B (Lie)                | B (Lie)                     | $$ $+ R$ $$+R$$ $+ R$ $$            | Profit     |

3\. Equilibrium Analysis

This game has two pure strategy Nash equilibria:

1. Honest Equilibrium: Everyone bets on A. If Alice unilaterally deviates and bets on B, she will lose. Therefore, she will not deviate.
2. Conspiratorial Equilibrium: Everyone bets on B. If Alice unilaterally deviates from betting on A, she will lose$$ $\alpha S$ $$.Therefore, theoretically this is also an equilibrium.

4\. Why Honesty Prevails?

Although two equilibria exist, DAN breaks the tie through the following mechanism, causing the system to converge to an honest equilibrium:

* Coordination Cost: Achieving a "collusive equilibrium" requires enormous coordination costs. All attackers must act simultaneously, targeting the same case, and be certain that everyone else has received instructions to send the signal to B. Under DAN's anonymity and random selection mechanism, such communication is impossible.
* Simple Honest Agents: We assume that there is at least a small percentage (e.g., 5%) of “altruists” or “lazy people” in the network who will vote for the truth anyway.
  * If Alice knows that 5% of people are definitely going to vote for A, then the risk of voting for B will increase.
  * This will trigger a chain reaction: for safety's sake, even rational fence-sitters will side with A.
* P+epsilon attack resistance: Even if the attacker attempts to bribe (promising a reward of $$ $R + \epsilon$ $$ to those who vote for B).Due to the transparency of Ethereum smart contracts, the community can initiate a User-Activated Soft Fork (UASF) or trigger a final jury mechanism to directly confiscate the attacker's bribe funds.

5\. Conclusion

Mathematical derivation shows that as long as the basic assumption that "honest arbitrators hold a majority of tokens" is met, and the attacker's coordination cost is greater than 0, {All Vote Truth} is the unique and stable Schelling point in this game.

$$
P(\text{Honest Outcome}) \to 1 \quad \text{as} \quad N\_{jurors} \to \infty
$$

(When the number of arbitrators is large enough, the probability of outputting an honest result approaches 1.)

***

> By introducing Nash equilibrium and payoff matrix, a solid theoretical foundation is provided for the arbitration mechanism of OmniPact, proving that the system maintains justice not only by relying on "good people" but also by relying on "rational self-interested individuals".


# 4.2 Cryptographic Sortition

This section details how the DAN network elects specific arbitrators fairly, randomly, and unpredictably from thousands of nodes. We introduce VRF (Verifiable Random Function) and Weighted Stake Sampling algorithms to ensure that the election process is both attack-resistant and representative.

***

### 4.2 Cryptographic Sortition&#x20;

To prevent attackers from predicting the identity of arbitrators and launching bribery or DDoS attacks, the selection of arbitrators must be unpredictable and verifiable. OmniPact employs a cryptographic lottery mechanism, similar to Algorand's random election logic, but with weighted optimizations for the arbitration scenario.

#### 4.2.1 Juror Selection using VRF&#x20;

Traditional on-chain random numbers (such as `block.difficulty` 或 `block.timestamp`）It is highly susceptible to manipulation by miners/validators. OmniPact integrates Chainlink VRF (Verifiable Random Function) as its sole source of entropy.

Randomness Generation Workflow:

1.Seed Generation:

When the dispute state $S\_{disp}$ is triggered, the DAN contract sends a request to the VRF oracle, along with the current blockHash and disputeID as seed inputs.

2.Off-Chain Computation:

A VRF node uses its private key to generate a random number $R$ and a proof $\pi$.

$$
R = \text{VRF\_Prove}(Sk, Seed)
$$

3.On-Chain Verification:

The VRF node sends a callback of $(R, \pi)$ to the DAN contract. The contract uses the public key to verify the validity of $\pi$.

$$
\text{Verify}(Pk, R, \pi, Seed) == \text{true}
$$

4.Entropy Application:

The validated random number $R$ is used as input to the lottery algorithm.

#### 4.2.2 Weighted Probability Algorithms

Unlike the equal probability selection in lotteries, the election weight of arbitrators $$ $W$ $$ Its value is jointly determined by its stake and reputation. We designed a non-linear weighting function to balance "capital discourse power" and "expert discourse power" while resisting Sybil attacks.

1\. Weight Function

For any candidate arbitrator $$ $i$ $$,The weight of its selection$$ $W\_i$ $$ Defined as:

$$
W\_i = \underbrace{(S\_i)^{\alpha}}*{\text{Stake Component}} \times \underbrace{(1 + \frac{R\_i}{R*{max}})}\_{\text{Reputation Multiplier}}
$$

* $$ $S\_i$ $$: The amount of $PACT tokens currently staked by the node.
* $$ $\alpha$ $$: The equity smoothing factor is usually taken as$$ $0.5 \le \alpha < 1$ $$。
  * Design intent: By employing sub-linear growth (such as square root), whales cannot monopolize arbitration power simply by accumulating funds, thus protecting the network's degree of decentralization.
* $$ $R\_i$ $$: The node's Omni-Score reputation score.
* $$ $R\_{max}$ $$: Credit score cap (e.g., 1000).
  * Design intent: High-reputation nodes have a higher probability of being selected (up to 2 times the weight), which incentivizes nodes to maintain a good judgment record in the long term.

2\. Selection Algorithm: Sum Tree Sampling

In order to $$ $O(\log N)$ $$ We perform weighted extraction from a massive number of nodes within a time complexity, and we maintain a Fenwick Tree (or Sum Tree) data structure in the contract.

* Tree structure: Leaf nodes store the weight of each arbitrator.$$ $W\_i$ $$,The parent node stores the sum of the weights of its child nodes. The root node stores the total weight of the entire network. $$ $W\_{total}$ $$。
* Selection logic:
  1. Random numbers generated using VRF $$ $R$ $$,Calculate the target value $$ $T = R \pmod{W\_{total}}$ $$。
  2. Iterate from the root node to find the node that satisfies the condition $$ $\sum\_{j=1}^{k-1} W\_j \le T < \sum\_{j=1}^{k} W\_j$ $$ Index of  $$ $k$ $$。
  3. node $$ $k$ $$ That is, the selected arbitrator.

3\. Sybil Resistance Analysis

Attackers might attempt to split large sums of money into multiple smaller accounts (Sybil Nodes) to increase their overall probability of being selected.

However, due to the introduction of a non-linear factor $\alpha$ in our weighting formula (where $(A+B)^\alpha < A^\alpha + B^\alpha$ when $\alpha < 1$), splitting accounts mathematically increases the overall weight.

To curb this splitting, we introduce a Minimum Stake Threshold and a Gas cost barrier. More importantly, the reputation score $R\_i$ is difficult to split—a new account's $R\_i$ is an initial value, far lower than that of older accounts with a long history. Therefore, splitting funds results in the loss of the "reputation multiplier" advantage, making splitting attacks economically unprofitable.

***

This section demonstrates, through mathematical formulas and a data structure (Sum Tree), how OmniPact achieves both rational power allocation and system security through algorithmic design while ensuring randomness.


# 4.3 The Commit-Reveal Scheme

On a transparent public blockchain, all transaction data is instantly visible to the entire network upon broadcast. If the arbitrator directly submits the voting results (e.g`Vote: YES),`Subsequent arbitrators will be able to see the choices of the early voters. This can lead to serious mirroring attacks or free-riding behavior—arbitrators no longer analyze the evidence independently but blindly follow the choices of early voters, undermining the "independent judgment" assumption required for Schelling point games.

To address this issue, OmniPact implemented a strict Commit-Reveal two-phase voting protocol.

#### 4.3.1 Phase 1: The Commit Phase&#x20;

At this stage, the arbitrator has made a ruling, but the ruling must be "sealed" and uploaded to the blockchain. We use a one-way hash function to implement this "digital envelope".

1\. Local Computation

The arbitrator client generates the following data locally:

* Vote ($$ $V$ $$):Judgment results (e.g.`1` Buyer wins,`2` Seller's representative wins).
* Salt ($$ $S$ $$): A high-entropy random number (e.g., a large 256-bit integer). Salt is crucial to prevent brute-force attacks.

2\. Hash Generation

Arbitrator calculates commitment hash $C$：

$$
C\_i = \text{Keccak256}(V\_i \parallel S\_i \parallel \text{Address}\_i)
$$

* $$ $\parallel$ $$: Data splicing operation.
* Address Binding: Including the sender's address in the hash calculation prevents other malicious nodes from directly copying (replaying) the hash value to forge votes.

3\. On-Chain Submission

Arbitrator call commitVote(bytes32 commitment)。

* Only hash values ​​are stored on the chain.$$ $C\_i$ $$。
* Privacy: Due to the one-way nature of hash functions, and $$ $S\_i$ $$ Not disclosed, and outsiders (including other arbitrators) cannot obtain information from it $$ $C\_i$ $$ Reverse deduction $$ $V\_i$ $$。
* Note: Gas fees will be charged at this stage.

#### 4.3.2 Phase 2: The Reveal Phase&#x20;

&#x20;`commitPeriod` Once the agreement concludes (e.g., 24 hours later), it enters the disclosure phase. At this point, all arbitrators must disclose their original data to verify the commitments.

1\. Data Exposure

The arbitrator calls revealVote(uint256 vote, uint256 salt).

2\. On-Chain Verification

The smart contract re-executes the hash calculation and compares it with the commitment stored in Phase 1:

Solidity

```
function revealVote(uint256 _vote, uint256 _salt) external {
    // 1. Reconstruct the hash
    bytes32 computedHash = keccak256(abi.encodePacked(_vote, _salt, msg.sender));
    
    // 2. Retrieve stored commitment
    bytes32 storedHash = commitments[msg.sender][disputeId];
    
    // 3. Verify
    require(computedHash == storedHash, "Hash mismatch! Vote altered.");
    
    // 4. Record valid vote
    // ... logic to update vote counts ...
}
```

* Consistency check: If an arbitrator attempts to change a vote during the disclosure phase (e.g., seeing everyone else voted A and wanting to change their vote to A), they will be unable to find a new one $$ $S'$ $$ Make $$ $\text{Hash}(A, S') == \text{StoredHash}(B, S)$ $$(Hash collision) The transaction will be rejected.

#### 4.3.3 Security Analysis: Preventing Mirroring

1\. Salt Generation

If only Keccak256(Vote) is calculated, the hash can be cracked instantly by brute force due to the extremely small value space of $V$ (typically only 2-3 options).

Introducing a random salt ($S$) greatly expands the input space, making brute force computationally infeasible. The OmniPact SDK automatically generates a strong random salt locally and stores it encrypted on the user's device.

2\. Enforced Independence

Because no genuine voting information was leaked before the end of the Commit phase, all arbitrators were forced to independently review the evidence and make their judgments. When the Reveal phase began, everyone revealed their cards simultaneously, at which point it was impossible to change the outcome.

3\. Non-Reveal Penalty

If an arbitrator submits a hash during the Commit phase but finds themselves in the minority during the Reveal phase, they might choose not to reveal (abstain from voting) to avoid being penalized.

To curb this behavior, OmniPact stipulates that committing but not revealing is equivalent to abstaining and will incur a slight reputation point deduction. This ensures that arbitrators are incentivized to complete the entire process.

***

This mechanism is the most classic cryptographic primitive in decentralized voting systems. By explaining in detail the role of Salt and the necessity of Address Binding, it demonstrates the rigor of the protocol's detailed design.


# 4.4 Recursive Appeal System

Statistically, random sampling of small samples (only 3 arbitrators in the first round) can lead to erroneous rulings due to probability bias or targeted bribery. OmniPact does not assume that a single round of rulings is absolutely correct, but rather provides a mechanism to correct errors.

We model the dispute resolution process as a multi-round game. Each round of appeal expands the jury size, thus, according to the law of large numbers, increasing the probability that the verdict approximates the objective truth $$ $P(Truth) \to 1$ $$.

#### 4.4.1 Exponential Cost Escalation Model&#x20;

To prevent malicious users from launching "dust attacks" or stalling through endless appeals, appeals must come at a high financial cost.

1.Jury Scaling

The number of arbitrators required for each round of appeal, $N$, grows exponentially.

设$N\_k$ represents the number of arbitrators in the $k$th round (initially $k=0, N\_0=3$):

$$
N\_{k+1} = 2 \times N\_k + 1
$$

* Round 0: 3 Jurors
* Round 1: 7 Jurors
* Round 2: 15 Jurors
* Round 3: 31 Jurors ...

This increase ensures that the weight of a new round of voting always exceeds the sum of all previous rounds, thus guaranteeing that a new ruling can override an old one.

2\. Appeal Fee Calculation

The party initiating the appeal (Appellant) must pay enough to cover the costs of a new round of arbitrators.

$$
C\_{appeal}(k+1) = N\_{k+1} \times (F\_{juror} + F\_{tax})
$$

* $$ $F\_{juror}$ $$: Standard service fee for a single arbitrator.
* $$ $F\_{tax}$ $$: Agreement tax or destruction fee (to prevent zero-cost attacks).

3\. War of Attrition

This is essentially a chicken game of "who is more convinced that they are right".

* The honest party is convinced that as the number of people increases, the truth will be seen by the majority, and is therefore willing to pay the high appeal fees upfront because they expect to receive a refund and a reward if they ultimately win the case.
* The lying party: Knowing that the cost of bribery will increase exponentially with the number of people involved (bribing 31 people is much harder than bribing 3), the attacker's expected value quickly becomes negative as appeal costs skyrocket.

$$
EV\_{attacker} = P(Win) \times Amount - C\_{appeal}
$$

When $C\_{appeal} > Amount$, a rational attacker will drop the appeal.

***

#### 4.4.2 The Supreme Court: Finality Enforcement&#x20;

In theory, appeals can proceed indefinitely, but to ensure commercial efficiency, there must be a finality. When the cost of appeal exceeds the amount in dispute or triggers an ecological security threshold, the case will be transferred to the OmniPact Supreme Court.

1\. Triggers

* Economic ceiling: When.
* Round limit: The game is still undecided after reaching Round 5 (63 arbitrators).

2\. Composition of the final jury

The final review panel is no longer composed of randomly selected ordinary nodes, but rather of "veteran nodes" consisting of the top 1% of Stakers or DAO Elected Delegates.

* Real-name/semi-real-name: Veteran nodes are usually linked to real-world reputation (such as well-known Web3 organizations or auditing firms).
* Public voting: The final appeal will no longer use a commit-reveal process, but will instead be conducted through a public, named vote. This means their verdict will be directly subject to moral scrutiny by the entire community.

3\. Finality & The Right to Fork

The jury's ruling is final and directly modifies the financial status of the OES contract.

What if the jury is corrupt?

This is the ultimate defense for decentralized protocols. If the final jury makes an obviously wrong ruling (e.g., the whole world saw the seller send an empty packet, but the jury ruled in favor of the seller), the community will initiate a Social Consensus Fork.

* Honest community members will deploy a new version of the OmniPact contract.
* In this version, the staked tokens of corrupt jury nodes will be removed (slashed).
* The market will sell off old chain tokens and buy new chain tokens.

This ultimate deterrent of the "potential fork" forces the final jury (even though they own 51% of the tokens) to refrain from wrongdoing, as doing so would cause the value of their tokens to drop to zero.


# Omni-ID: Reputation & Identity Protocol

Omni-ID is the "soul" of the OmniPact protocol. It transforms users' on-chain behavioral data into quantifiable assets. Unlike traditional Web2 credit scores (black boxes), Omni-ID is completely open source, composable, and user-sovereign.


# 5.1 SBT Architecture

### 5.1 SBT Architecture&#x20;

At the heart of Omni-ID technology is a Dynamic Soulbound Token. We abandoned the ERC-721 standard used for art collection and adopted the ERC-5192 (Minimal Soulbound NFTs) standard, which is designed specifically for “non-transferable relationships.”

#### 5.1.1 Compliance with ERC-5192&#x20;

1. Why choose ERC-5192?

The traditional ERC-721 standard allows for the free transfer of tokens, which is fatal to reputation systems—if a "five-star" account can be sold to malicious fraudsters, then reputation becomes worthless.

ERC-5192 is the "minimum soul-binding interface" standard established by the Ethereum community. It enforces locking logic on top of ERC-721.

2\. Locking Mechanism

The Omni-ID contract rewrote the underlying transfer functions, physically blocking the transfer path at the code level:

Solidity

```
// Omni-ID Core Logic
function transferFrom(address from, address to, uint256 tokenId) public override {
    revert("OmniID: Soulbound token cannot be transferred");
}

function safeTransferFrom(address from, address to, uint256 tokenId) public override {
    revert("OmniID: Soulbound token cannot be transferred");
}

// ERC-5192 Interface Implementation
function locked(uint256 tokenId) external view returns (bool) {
    return true; // Permanently locked upon minting
}
```

* Uniqueness constraint: Each wallet address is limited to one Omni-ID in Mint.`balanceOf(user)` It is always equal to 0 or 1.
* Revocability: Although users cannot transfer their IDs, the protocol has the highest authority (triggered by DAN adjudication) to execute`burn()` This is the ultimate punishment for serious fraudsters (such as those proven to have carried out Sybil attacks or malicious scams) – a “digital death penalty.”

#### 5.1.2 Metadata Storage and Update Logic&#x20;

Omni-ID had to resolve a contradiction: reputation scores needed to be frequently accessed by smart contracts (e.g., to calculate fee discounts), but complete profile data was too massive to be stored entirely on the blockchain.

To address this, we adopted a "dual-layer storage" architecture.

**A. Layer 1: On-Chain Reputation State**&#x20;

Storage location: Ethereum/L2 State Trie&#x20;

Data content: Only the most core quantitative indicators are stored.

Solidity

```
struct IdentityStatus {
    uint16 score;        // Current Omni-Score (0-1000)
    uint32 totalTx;      // Total transaction count
    uint8 tier;          // User Level (Newbie/Expert/Master)
    bool isHuman;        // ZK-KYC status flag
}
mapping(uint256 => IdentityStatus) public identityData;
```

* Purpose: To allow other smart contracts (such as OES escrow contracts, DeFi lending protocols) to `IIdentity.getScore(user)` It atomically reads user credit information, thereby automating the logic of "high credit, no deposit required" or "low fee".

**B. Layer 2: Off-Chain Contextual Metadata**&#x20;

Storage location: IPFS / Arweave

Data content: Rich, visually appealing data.

JSON

```
{
  "name": "Alice.eth",
  "description": "Solidity Developer | 98% Success Rate",
  "image": "ipfs://bafy...", // Dynamic PFP based on Tier
  "attributes": [
    {"trait_type": "Skills", "value": "Python"},
    {"trait_type": "Badges", "value": "Top Seller 2025"},
    {"trait_type": "Review_Last", "value": "Great work, very fast!"}
  ]
}
```

* Linking method: On-chain storage only `tokenURI` pointer.
* Purpose: To provide front-end DApps, OpenSea, or recruitment platforms with a way to display users' detailed resumes.

**C. The Dynamic Update Cycle**&#x20;

Omni-ID is not a static NFT; it evolves in real time with user behavior.

1. Trigger:

   When an OES escrow transaction is finalized or arbitration is completed, the OES contract triggers emitReputationUpdate.
2. Calculation:

   The on-chain ReputationController contract calculates the new score increment $\Delta S$ according to a predefined formula (see Section 5.2).
3. State Mutation:

   The controller calls the Omni-ID contract's updateScore(tokenId, newScore).

   * Access control: This function is modified by the following modifiers `onlyProtocol` Protect your data and strictly prohibit users from modifying their scores.
4. Metadata Refresh:

   If a user's level changes (e.g., from Level 1 to Level 2), the contract will trigger the BatchMetadataUpdate event (EIP-4906), notifying platforms such as OpenSea to fetch the latest NFT image again (e.g., a medal changes from bronze to gold).

***

> This section demonstrates to technical readers, through a two-layer storage architecture, that Omni-ID possesses both DeFi composability (lightweight on-chain data) and a Web2-level user experience (enriched off-chain data).


# 5.2 Reputation Scoring Vector

Omni-Score ($$ $S$ $$) It is a dynamic numerical value between 0 and 1000. It is not a static stored value, but rather based on the user's historical interaction vector $$ $\vec{H}$ $$ The function results are calculated in real time.

#### 5.2.1 The Decay Algorithm: $$ $R(t)$ $$ calculation&#x20;

To reflect the "time-sensitive nature of reputation" (i.e., honesty a year ago is not as important as honesty yesterday), all positive behavior integrals are subject to the Half-Life Algorithm.

**Basic Decay Formula:**

The user's current reputation $S(t)$ is defined as:

$$
(t) = \sum\_{i=1}^{n} \left( P\_i \cdot e^{-\lambda(t\_{now} - t\_i)} \right)
$$

* $$ $P\_i$ $$:  $$ $i$ $$ The base points earned from each successful transaction.
* $$ $t\_{now}$ $$: Current block timestamp.
* $$ $t\_i$ $$:  $$ $i$ $$ The timestamp of the completed transaction.
* $$ $\lambda$ $$: Decay Constant. Setting$$ $\lambda \approx 1.8 \times 10^{-7}$ $$,This means that the half-life of the credit score is approximately 6 months.

**Mechanism significance:**

This means users cannot simply rely on their high scores accumulated early on. If a high-scoring user becomes inactive, their score will gradually decline over time, eventually returning to the baseline. This forces business nodes to maintain consistent and stable performance in fulfilling their obligations.

#### 5.2.2 Multi-dimensional Weighting

In addition to the time dimension, the basic points for a single transaction $$ $P\_i$ $$ It is determined by a weighted vector of three core dimensions: transaction volume, interaction frequency, and counterparty quality.

Integral generating function $$ $f(Tx)$ $$：

$$
P\_{Tx} = \underbrace{w\_1 \cdot \ln(1 + V\_{usd})}*{\text{Volume (Logarithmic)}} + \underbrace{w\_2 \cdot \mathbb{I}*{diverse}}*{\text{Diversity Bonus}} - \underbrace{w\_3 \cdot \text{Risk}}*{\text{Risk Factor}}
$$

**1. Volume: Logarithmic Growth**

We are concerned about the transaction amount$$ $V\_{usd}$ $$ Using natural logarithm $$ $\ln$ $$ Processing, rather than nonlinear processing.

* Reason: To prevent "whale hegemony." The reputation boost from a single $1 million transaction should be far less than that from 1 million $1 transactions. Reputation comes from proven honesty, not simply from displays of wealth.
* Example: A transaction of 100 U earns 10 points, while a transaction of 10,000 U earns 20 points (instead of 1,000 points).

**2. Frequency & Diversity**&#x20;

To defend against "Sybil Washing" (i.e., creating two separate accounts to trade and inflate scores), a counterparty diversity coefficient was introduced($$ $\mathbb{I}\_{diverse}$ $$).

* The algorithm constructs a local social graph $$ $G(V, E)$ $$。
* If a user always transacts with the same address,$$ $\mathbb{I}\_{diverse}$ $$ It will decay exponentially to 0.
* You can only earn the full credits by trading with new, high-reputation counterparties.

**3. The "Glass Cannon" Penalty Logic**&#x20;

In the Omni-ID model, building reputation is like hiking up a mountain, while destroying reputation is like falling from a great height.

Once a user is determined to be "fraudulent" in DAN arbitration (i.e., loses the arbitration and is marked as malicious), their reputation score will trigger a nullifier:

$$
S\_{new} = S\_{old} \times (1 - \text{SeverityFactor})
$$

* SeverityFactor: For serious fraud (such as providing false logistics), this factor is 1.0 (directly reduced to zero); for minor breaches of contract (such as delays), this factor may be 0.2 (subtracted by 20%).
* This asymmetrical design ensures that the cost of wrongdoing is extremely high, making rational users cherish their Omni-Score as much as they would their feathers.


# 5.3 Sybil Resistance Mechanisms

This section demonstrates from both economic and topological perspectives how OmniPact can defend against large-scale fake account attacks. We prove that in the OmniPact protocol, the cost of establishing fake reputations increases exponentially until it exceeds the potential malicious gains.

***

In a decentralized pseudonym system, Sybil attacks—where attackers create a large number of fake identities to manipulate reputation or voting—are the biggest systemic threat. OmniPact abandons centralized authentication (such as uploading ID cards) and instead builds a defense system based on the "Cost of Forgery" and "Graph Analysis".

#### 5.3.1 Cost-of-Forgery Analysis&#x20;

Omni-ID's reputation score is not generated for free; it is forged by consuming real capital and time. Through protocol design, we have transformed "score trading" into an economically unsustainable and unprofitable activity.

1\. Wash Trading Attrition Model

Attackers attempt to boost their reputation score through self-dealing. However, every transaction that generates valid reputation must incur a protocol fee (e.g., 0.5%) and a gas fee.

The total cost of forging a high-reputation account$$ $C\_{forge}$ $$Defined as:

$$
C\_{forge} = \sum\_{i=1}^{N} \left( V\_i \times R\_{fee} + \text{Gas}*i \right) + \text{Cost}*{time}(Capital)
$$

* Vi$$ $V\_i$ $$: The amount of the i-th order.
* $$ $R\_{fee}$ $$Rfee:The fee charged by the protocol (this part of the funds will be recovered or destroyed by the national treasury, and is a pure expenditure for the attacker).
* $$ $\text{Cost}*{time}$ $$$$ $\text{Cost}*{time}$ $$Cost time: The opportunity cost of funds during the lock-up period (interest on funds).

Because the reputation score uses a logarithmic growth model, attackers must conduct a massive number of transactions to achieve a high score. As transaction volume accumulates, transaction fee attrition increases linearly, while reputation gains only increase logarithmically.

Ultimately, $C\_{forge}$ will far exceed the potential profit $E\_{profit}$ that the account could generate as a "fraudulent tool," making the attack economically unprofitable.

2\. Proof-of-Funds Barrier

Only accounts that have completed a substantial transfer of value can gain credibility.

* The system filters out all "micro-dust transactions".
* Funds must be locked in the Vault for a period of time (time-weighted value). Quick-in-quick-out flash loan attacks cannot accumulate credit points.

#### 5.3.2 Social Graph Verification&#x20;

In addition to economic barriers, OmniPact also uses graph theory to identify the topological characteristics of witch accounts. Witch accounts typically exhibit "dense internal interconnections and sparse external connections," forming isolated subgraphs.

1\. Trust Flow Algorithm

We introduce an iterative algorithm similar to EigenTrust++ or PageRank to calculate the global reputation weight.

$$
T\_{i} = (1 - a) \sum\_{j \in In(i)} (c\_{ji} \times T\_{j}) + a \cdot p\_{i}
$$

* If account A has a very high reputation (e.g., the address of a well-known auditing firm), then the reputation of account B, which has transacted with A, will increase accordingly (trust transfer).
* Island Detection: If a group of accounts $$ ${S\_1, S\_2, ..., S\_{100}}$ $$ If a cluster only trades with each other internally and never interacts with existing high-reputation nodes (mainnet) in the network, the algorithm will identify it as a Sybil Cluster.
* De-weighting: The weight of transactions originating from within the witch cluster in the reputation calculation formula $$ $w$ $$ It will be downgraded to 0.

2\. Web3 Identity Combination (Composable Identity Bootstrap)

OmniPact does not operate in isolation; we aggregate external DID (Decentralized Identity) signals as initial trust anchors:

* Gitcoin Passport: Reads the user's Gitcoin score.
* ENS / Lens Protocol: Analyzes users' social activity.
* Proof of Humanity: Verifies the status of a real person.

If a newly generated Omni-ID address has no history on the Ethereum mainnet (Nonce=0) and is not bound to any external DID, the system will automatically mark it as "High Risk" and impose a stricter "Slow Start" limit on its initial reputation accumulation, thereby further increasing the time cost of Sybil attacks.

***

> By combining "economic wear and tear" with "graph isolation," OmniPact has demonstrated that it can still construct a mathematically resistant and clean reputation network without relying on centralized KYC institutions.


# Privacy & Compliance Framework

OmniPact is committed to building a compliance-friendly ecosystem. We refuse to put users' sensitive data (PII) in plaintext on the blockchain. Instead, we use zk-SNARKs (zero-knowledge concise non-interactive knowledge proofs) technology to transform identity verification into cryptographic proof verification.


# 6.1 Zero-Knowledge Proofs for KYC (zk-KYC)

zk-KYC allows users to prove to the agreement: "I am a legitimate, unsanctioned, real user" without revealing "who I am".

#### 6.1.1 Circuit Design for Identity Verification&#x20;

Our ZK circuit (written based on Circom or Halo2) is designed to prove a specific arithmetic statement.

1\. Certificate Issuance (Credential Issuance - Off-chain)

First, the user presents physical credentials on their local device to a trusted third-party issuer (such as Synaps or Binance). Once the issuer verifies the credentials, they digitally sign the user's decentralized identifier (DID) to generate a credential $C$.

$$
C = \text{Sign}*{Issuer}(DID*{user}, \text{Attributes})
$$

2\. Circuit Statement

When a user wants to interact with OmniPact (e.g., to deposit a large sum of money), a Proof $\pi$ must be generated.

A zero-knowledge circuit $C\_{kyc}$ contains the following constraints:

* Inputs:
  * Private Inputs: User's private key $$ $sk$ $$,certificate $$ $C$ $$, the Merkle Path of the credentials.
  * Public Inputs: Issuer public key$$ $PK\_{Issuer}$ $$,Merkle Root on the compliance list $$ $R\_{valid}$ $$,Merkle Root on the sanctions list $$ $R\_{sanctions}$ $$。

**Constraints:**

* Signature verification: Proves that $C$ is indeed a valid credential issued by $PK\_{Issuer}$.

$$
\text{VerifySig}(PK\_{Issuer}, C) == \text{true}
$$

* Proof of Ownership: Proof of user ownership of the credentials $$ $C$ $$ Bound private key $$ $sk$ $$
* Membership: Proof that the credential exists in the valid user tree $$ $R\_{valid}$ $$ middle.
* Non-Membership: Proof that the user is not on the OFAC sanctions list $$ $R\_{sanctions}$ $$ middle.
* Attribute assertion: (Optional) Proof `Attributes.Age >= 18` 或 `Attributes.Country != "North Korea",`However, the specific values ​​are not disclosed.

3\. Output

Circuit output proof $\pi$. Smart contract verification.

$$
\text{Verify}(\pi, PublicInputs)
$$

If true, the transaction is allowed. No user names or identification numbers are stored on the blockchain throughout the entire process.

#### 6.1.2 Nullifier Implementation for Anonymity&#x20;

While protecting privacy, we must prevent "identity double-spending," which means that the same compliant user can re-enter under a different alias after being banned, or the same user can claim "newcomer rewards" multiple times. To address this, we have introduced a nullifier mechanism.

1\. Deterministic and irreversible identifiers

The nullifier is a hash value that is unique to the same user within the same scope, but it cannot be used to deduce the user's identity.

Nullifier calculation formula:

$$
Nullifier = \text{PoseidonHash}(sk\_{user}, \text{Scope}, \text{Salt})
$$

* $$ $sk\_{user}$ $$:The user's secret private key (which is also the private input of the ZK circuit).
* Scope: Scope parameter.
  * If it is a global ban list, the scope is `PROTOCOL_ID`。
  * If it is a single voting activity, the scope is `ELECTION_ID`。
* PoseidonHash: A hash algorithm that is friendly to ZK circuits.

2\. Mechanism

1. Generation: Each time a user submits zk-KYC proof, the circuit will calculate as a byproduct $$Nullifier$$ And it is made public as Public Output.
2. Record: Smart contracts maintain a `mapping(bytes32 => bool) usedNullifiers`。
3. Anti-replay:
   * If the goal is "limited to one per person", contract review `usedNullifiers[Nullifier]` Is it `true.`If so, then refuse.
   * If the purpose is "blacklist tracking," when a nullifier is marked as malicious by the OmniPact governance committee, that nullifier will be permanently added to the blacklist`Blacklist`。
4. Anonymity: due to $$ $sk\_{user}$ $$ Only the user knows that what an external observer sees is a string of random gibberish. Even if the user uses the OmniPact protocol in different DApps, the generated nullifier will be completely different as long as the scope is different, thus preventing cross-application linkability attacks.

***

{% hint style="success" %}
A perfect mathematical balance has been found between the seemingly contradictory demands of "absolute privacy" and "regulatory compliance".
{% endhint %}


# 6.2 Data Encryption Standards

The OmniPact protocol processes data in two categories: transient communication data (such as payment details in P2P chat) and persistent evidence data (such as contract files stored on IPFS). We have designed encryption standards for each of these two types of data.。

#### 6.2.1 ECIES for P2P Data&#x20;

For bank card numbers, Swift codes, or communication details in OTC transactions, the data must be end-to-end encrypted (E2EE) between the buyer and seller, and must be invisible to any third party (including OmniPact protocol nodes).

We directly utilize the existing Ethereum account`secp256k1`The key pair uses the ECIES (Elliptic Curve Integrated Encryption Scheme) standard.

* Key Derivation Workflow

Suppose Alice (the buyer) wants to send an encrypted message $M$ to Bob (the seller):

1. Temporary Key Generation: Alice generates a temporary, one-time private key $$ $r$ $$and the corresponding public key $$ $R = r \times G$ $$。
2. Shared Secret Computation (ECDH): Alice uses Bob's public key $K\_{Bob}$ to compute the shared point $S$: S = r \times K\_{Bob}

   (Note: After receiving the data, Bob can use his private key $k\_{Bob}$ to calculate $S = k\_{Bob} \times R$. According to the properties of elliptic curves, the $S$ calculated by both methods will be the same.)
3. Key Extension (KDF): This involves adding points $$ $S$ $$ Input key derivation function（如 ANSI-X9.63-KDF）,Generate a symmetric encryption key$$ $k\_{enc}$ $$ and message verification key $$ $k\_{mac}$ $$.
4. Encryption and Encapsulation:

$$
C = \text{AES-GCM-256}(M, k\_{enc})Tag = \text{HMAC-SHA256}(C, k\_{mac})
$$

5. Send: Alice will send the data packet $$ $(R, C, Tag)$ $$ Sent to Bob via relay network.

6\. Security advantages

* Forward Secrecy: Due to the use of a temporary key $$ $r$ $$,Even if Alice's long-term private key is leaked in the future, past session records will be difficult to decrypt in bulk (if combined with the Ratchet algorithm).
* Seamless experience: Users do not need to remember additional passwords; they can decrypt the device simply by signing it with a Web3 wallet (MetaMask).

***

#### 6.2.2 Dual-Key Architecture for Arbitration Evidence&#x20;

Evidence presents a unique challenge: it must remain confidential to the public under normal circumstances, but in the event of a dispute, it must be decryptable and readable by a randomly selected arbitrator.

To resolve the conflict between "privacy" and "judicial transparency," we designed a Dual-Key architecture.

1. The Hybrid Structure: All large files (such as PDFs and design drawings) are encrypted using the AES-256-CBC symmetric algorithm, generating ciphertext $Enc\_{Data}$.

The real core issue lies in: how should the AES key $K\_{sym}$ be stored?

2\. State 1: Normal Trading Period (The Private State)

At the initial stage of transaction creation, the AES key $K\_{sym}$ is encrypted and stored in the metadata:

* Key A (For Buyer): $$ $E\_{Pub\_{Buyer}}(K\_{sym})$ $$
* Key B (For Seller): $$ $E\_{Pub\_{Seller}}(K\_{sym})$ $$

At this point, the file is stored on IPFS, but only the buyer and seller can decrypt it $$ $K\_{sym}$ $$ This allows the file to be read. To the outside world, it appears as a jumble of gibberish.

3\. State Two: The Juror Access State

When the buyer raises a dispute, the protocol mandates that the buyer submit a new key envelope:

* Key C (For Jury): $$ $E\_{Key\_{DanRegistry}}(K\_{sym})$ $$

Here $$ $Key\_{DanRegistry}$ $$ It is not a single private key (otherwise there would be a single point of failure), but a set of threshold keys or temporary session public keys.

* Once an arbitrator is selected by the VRF, the arbitrator client securely obtains it from the party initiating the dispute (or the secret pool of the smart contract) via a Diffie-Hellman key exchange.
* This mechanism implements "(Access on Demand)": you only have the right to view evidence when a dispute arises and you are selected as the judge.

4\. Integrity Verification

To prevent one party from tampering with evidence after a dispute arises (e.g., secretly replacing encrypted files), the OES contract records the hash fingerprint of the file during the $S\_{lock}$ phase:

$$
\text{OnChainHash} = \text{Keccak256}(Enc\_{Data})
$$

> Before decrypting, the arbitrator will verify whether the hash of the IPFS file matches the on-chain record. This ensures the originality of the evidence presented in court.

***

> By introducing ECIES and a dual-key architecture, OmniPact demonstrates how it builds a robust yet flexible cryptographic defense between decentralized storage (public) and trade secrets (private).


# 6.3 Trusted Execution Environments (TEE)

While zero-knowledge proofs (ZK) are well-suited for verifying simple assertions (such as "I am an adult"), generating ZK proofs is prohibitively expensive and extremely difficult to develop for commercial scenarios with high computational loads or requiring general-purpose logic processing.

OmniPact introduces Trusted Execution Environments (TEEs) as a complementary solution. We have built a decentralized network of TEE nodes (based on Intel SGX or AMD SEV) to provide hardware-level isolated execution regions (Enclaves) for the protocol.

#### 6.3.1 Intel SGX Integration for "Compute-to-Data"

In traditional business data transactions, data must be sent to the buyer before it can be used, which leads to the risk of unlimited copying once the data is sold (the data breach paradox). OmniPact disrupts this model by adopting a Compute-to-Data architecture.

1\. Architecture Principles

* Encrypted Data at Rest: Data (such as medical records and financial transaction flows) is always stored in an encrypted state in IPFS or a private cloud.
* Encrypted Compute in Motion: When a buyer purchases the "right to use" data, they do not download the raw data, but instead upload an algorithm script (such as a Python training script).
* The Black Box (Enclave):
  1. The OmniPact TEE node loads encrypted data and algorithm scripts.
  2. Data is decrypted only within the CPU's encrypted memory region (Enclave).
  3. The CPU performs computational tasks (such as training models). Even node operators with physical machines cannot read plaintext data from memory.
  4. The calculation results (such as trained model weights or statistical reports) are encrypted and output and sent to the buyer.

2\. Commercial value

This enables OmniPact to support a privacy-preserving data marketplace. Businesses can sell “insights” into their data without having to sell ownership of it.

#### 6.3.2 Secure Enclaves for Sensitive IP Transfer&#x20;

For high-value intellectual property (IP) transactions—such as AI model weights, quantitative trading algorithms, and undisclosed zero-day vulnerability code—an extreme trust deadlock exists between the buyer and seller:

* Buyer: "How am I supposed to know it's real if you don't let me test the code?"
* Seller: "What if I let you test the code, and you copied it without paying?"

OmniPact uses TEE to create an "opaque inspection room".

1\. Remote Attestation - DCAP

Before a transaction begins, both the buyer and seller will verify the remote authentication report (Quote) of the TEE node.

* This is a digital certificate signed with the Intel hardware root key.
* This proves that the node is indeed running on real SGX hardware, and that the hash of the loaded code (OmniPact verifier) ​​is completely consistent with the open-source code and has not been tampered with.

2\. Key Exchange inside Enclave

1. Encrypted upload: The seller uploads the algorithm code to IPFS in encryption; the buyer uploads the test dataset in encryption.
2. Enclave execution: The TEE node pulls data from both sides. Inside the Enclave, the negotiated session key is used to decrypt the code and test data.
3. Run and verify: The code runs against the test data within the Enclave.
4. Output: The TEE node outputs a performance report (such as "Accuracy 98.5%" or "Backtesting Return 20%) to the buyer, rather than the code itself.
5. Funds settlement:
   * If the performance meets the requirements, the smart contract automatically releases the funds to the seller and (optionally) transfers the right to use the code to the buyer via Key Re-encryption.
   * If performance fails to meet requirements, the transaction is cancelled, and the code is never leaked to the buyer.

This mechanism perfectly solves the verification problem in digital asset transactions, making OmniPact the world's first platform to support "zero-trust intellectual property transactions".

***

> How OmniPact leverages hardware security technology to extend the capabilities of blockchain, enabling it to handle privacy-preserving transactions of the most critical assets of the AI ​​era—data and algorithms.


# RWA & Legal Engineering

When dealing with real-world assets (RWAs)—such as real estate, commodities, or employment contracts—the principle of "code is law" is often insufficient. When on-chain state (tokens) becomes decoupled from off-chain assets (houses), we need law as a last resort.

OmniPact introduces the concept of "Legal Engineering," constructing a compatibility layer between the Web3 world and traditional legal systems (Common Law/Civil Law) through a Ricardian Contracts architecture.


# 7.1 Ricardian Contracts

Definition: A Ricardian contract is a way of recording agreements in digital document form, possessing a dual nature:

Human-Readable: It is standard legal prose, understandable to lawyers and judges.

Machine-Readable: It contains a unique cryptographic identifier that smart contracts can recognize and execute.

OmniPact leverages this mechanism to ensure that every on-chain transaction is not merely a transfer of tokens, but also the digital execution of a legal contract.

#### 7.1.1 Hash-Linking Legal Prose to Smart Contract Code&#x20;

To prevent discrepancies between the "signed version" and the "executed version," we employ Cryptographic Hash Linking technology to achieve an atomic binding between legal text and the smart contract at a mathematical level.

1\. Architecture Flow

* Step 1: Templating

  The legal agreement was written as a Markdown or PDF template containing variables.

  * *Example*: "I, \[Seller\_Name], agree to sell \[Asset\_ID] to \[Buyer\_Name] for \[Amount]..."
* Step 2: Instantiation & Hashing

  When a user fills out an order on the DApp frontend, a template is populated to generate a unique legal document instance (PDF). The frontend calculates the SHA-256 hash value of this document:

$$
H\_{doc} = \text{SHA256}(\text{LegalDocument.pdf})
$$

* Step 3:On-Chain Anchoring

  $H\_{doc}$ It is passed as an immutable parameter to the `createEscrow()` function and permanently stored in the smart contract's state variables: Solidity

  ```
  bytes32 public constant AGREEMENT_HASH = 0x...; // Stores H_doc
  string public constant AGREEMENT_URI = "ipfs://Qm..."; // Points to the file
  ```

2\. Integrity Proof

Non-repudiation：

* If either party attempts to modify the contract terms afterward (even by changing just a punctuation mark), the document's hash value... $$ $H'\_{doc}$ $$ An avalanche effect will occur, along with on-chain storage. `AGREEMENT_HASH` Mismatch.
* Judicial validity: In a real court setting, the chain of evidence provided by OmniPact (on-chain transaction hash + original PDF) can prove that a specific version of the contract was signed by both parties at a specific time, and has extremely high electronic evidentiary value.

#### 7.1.2 Digital Signature Verification Standards (EIP-712)&#x20;

Simply anchoring the hash is insufficient; users must sign the hash to obtain "informed consent." Traditional blockchain signatures ( `0x8f2a...`)This is legally flawed because users can argue that "I don't know what I signed."

OmniPact fully implements the EIP-712 (Typed Structured Data Hashing and Signing) standard, bridging this "semantic gap".

1\. Structured Data Definition

We defined a clear data structure in the contract, rather than Ethereum's native binary stream.

Solidity

```
// EIP-712 Domain Separator prevents replay attacks across chains
struct EIP712Domain {
    string name;
    string version;
    uint256 chainId;
    address verifyingContract;
}

// The Business Logic Struct
struct CommercialAgreement {
    address buyer;
    address seller;
    uint256 price;
    string deliveryTerms;
    bytes32 legalDocHash; // Links to the Ricardian Prose
}
```

2\. Wallet Presentation

When a user clicks "Sign," MetaMask or the hardware wallet will display a fully readable card, instead of gibberish.

> Signing Request
>
> * Buyer: 0x123...
> * Seller: 0x456...
> * Price: 1000 USDT
> * Terms: "CIF Incoterms 2020"
> * LegalDocHash: 0xabc123... (Verified)

3\. On-Chain Verification

The OES contract uses \_hashTypedDataV4 to recover the signer's address, ensuring that the signature is indeed for the current context.

$$
Signer = \text{ecrecover}(\text{Keccak256}(\text{Domain} \parallel \text{StructHash}), v, r, s)
$$

Technical Significance: EIP-712 not only enhances the user experience, but more importantly, it fulfills the legal requirement of "informed consent." By including the legalDocHash in the structured signature, the user's acceptance of off-chain legal terms is cryptographically locked in the on-chain signature, achieving isomorphism between on-chain behavior and off-chain intent.

***

> OmniPact is more than just a geek toy; it's a robust legal technology infrastructure capable of handling complex business contracts.


# 7.2 IoT Oracle Integration

To automate the management of RWA assets, OmniPact must be able to trust data from physical sources. Instead of relying on unreliable manual input, we interact directly with the Internet of Things (IoT) device layer. We have built a trust architecture based on DID (Decentralized Identity) and Spatial Oracles.

#### 7.2.1 Device Identity (DID) Binding&#x20;

In the OmniPact network, a container sensor or a logistics truck is not just hardware; it is an Autonomous Economic Agent with a private key. We use the W3C DID standard and the ERC-725/1056 protocol to give devices on-chain identity.

1\. Hardware Root of Trust

To prevent data forgery (such as hackers simulating sensors to send false GPS signals), devices must have hardware-level security.

* Key Generation: Device's private key pair $$ $(Pk\_{dev}, Sk\_{dev})$ $$  The private key is generated inside the TPM (Trusted Platform Module) or HSM (Hardware Secure Module) security chip at the factory and never leaves the hardware.
* Registration: Device's public key $$ $Pk\_{dev}$ $$ Registered on OmniPact `IoTRegistry` It is bound to the contract by its physical serial number and owner.

2. Data Signing and Telemetry

When a device reports data (such as "current temperature -5°C"), it must digitally sign the data payload:

$$
Payload = { \text{Data}, \text{Timestamp}, \text{Nonce} }Signature = \text{Sign}(Sk\_{dev}, \text{Keccak256}(Payload))
$$

When a smart contract or oracle node receives data, it first verifies the signature:

$$
\text{Verify}(Pk\_{dev}, Payload, Signature) == \text{true}
$$

This ensures that the data indeed originates from that specific physical device and has not been tampered with during transmission.

#### 7.2.2 Geo-fencing Triggers Logic&#x20;

In supply chain finance and logistics guarantee scenarios, the release of funds often depends on changes in spatial state (e.g., goods entering the port of Rotterdam). OmniPact implements a hybrid on-chain/off-chain geofencing logic based on ray casting.

1\. Fence Definition

When creating a guarantee contract, the buyer and seller define a geographic polygon area $P$ (consisting of a series of latitude and longitude coordinates):

$$
P = {(x\_1, y\_1), (x\_2, y\_2), ..., (x\_n, y\_n)}
$$

2\. Trigger Algorithm

When an IoT device reports its current coordinates $C(x, y)$, the system needs to determine whether $C$ is inside $P$.

* Simple scenario (radius detection):

  Calculate the Euclidean distance $d = \sqrt{(x - x\_c)^2 + (y - y\_c)^2}$. If $d \le R$, then trigger the operation.

  (Note: On-chain computation consumes approximately 5k Gas)
* Complex scenes (polygon detection):

  The Ray Casting Algorithm is used to determine the relationship between a point and a polygon.

  * From point $$ $C$ $$ Draw a ray in any direction.
  * Calculate the number of intersections between the ray and the polygon boundary. $$ $N$ $$。
  * Logic: If $$ $N$ $$ If the number is odd, the point lies inside the polygon; if $$ $N$ $$ The number is even, and the point is on the outside.

3\. Execution Architecture

To save gas, complex ray calculations are typically performed off-chain in Chainlink Automation:

1. Monitor: The oracle node pulls the device signature coordinates every 10 minutes.
2. Compute: The node runs the Ray Casting algorithm off-chain.
3. Trigger: Once the result is `True` (Inside)The node sends to the OES contract `triggerDelivery(escrowId)` trade.
4. Verify:The contract verifies the oracle signature and the original device signature, and the state machine transitions.

Anti-Spoofing

* GPS Spoofing Prevention: Requires the device to simultaneously upload a list of nearby Wi-Fi MAC addresses or cell IDs, performing cross-verification via multi-source triangulation.

* Mobility Verification: Checks displacement speed within consecutive timestamps. If the device moves from New York to London within one second (abnormal speed), the contract will reject the data and trigger a risk control alert.

***

> OmniPact enables atomic-level synchronization between "logistics" in the physical world and "financial flow" in the blockchain world, providing a reliable technical path for the implementation of RWA.


# $PACT Tokenomics & Governance

OmniPact's economic model is designed according to the principle of "value flowing to the protocol, not to intermediaries." The $PACT token is not only a certificate of governance rights, but also a necessary means of production for maintaining cybersecurity and resolving disputes.


# 8.1 Token Utility Model

We decouple the utility of $PACT into two core pillars: a staking access mechanism for the supply side (arbitrators) and a deflationary repurchase mechanism for the demand side (protocol revenue).

#### 8.1.1 Staking Parameters for Jurors&#x20;

To prevent malicious nodes from launching Sybil attacks on the DAN network, $PACT serves as a "Sybil-resistant license." Only nodes that have staked a sufficient amount of tokens are eligible to be selected by the VRF algorithm and earn arbitration fees (ETH/USDC).

1\. Minimum Stake Threshold(Minimum Stake Threshold - $S\_{min}$)

To activate the arbitrator identity, a node must lock at least $S\_{min}$ $PACTs$ into the StakingContract.

* Parameter setting: $$ $S\_{min}$ $$ Dynamically anchor to the security requirements of the protocol. For example, set it as $$ $10,000 \text{ $PACT}$ $$。
* Purpose: Establish a baseline for attack costs. If an attacker wants to control 51% of the network's voting rights, they must purchase a huge amount of $PACT on the secondary market, which will drive up the coin price and thereby further increase the attack cost.

2\. Staking weights and selection probabilities (Stake-Weighted Probability)

While more staking increases the probability of being selected, we employed a sub-linear curve to prevent plutocratic dominance.

$$
P(Selected\_i) = \frac{\sqrt{S\_i}}{\sum\_{j=1}^{N} \sqrt{S\_j}}
$$

* Si$$ $S\_i$ $$: node $$ $i$ $$ The effective amount of collateral.
* Mechanism: Using the square root function $$ $\sqrt{S}$ $$ This means that if node A's staked amount is 100 times that of node B, its probability of being selected is only 10 times that of B. This encourages large holders to distribute their tokens across multiple nodes, thereby increasing the network's decentralization.

3\. Unbonding Period

To prevent "flash loan attacks on governance" or "escape after wrongdoing," staked tokens are subject to a 21-day unlocking period.

* Any unstake withdrawal will take 21 days to be credited to your account.
* During this period, if a node's past judgments are deemed malicious by the jury, its tokens in the unlocking queue can still be slashed.

4\. Slashing Mechanism

If an arbitrator cheats during the Reveal phase, or if their ruling is overturned by an appeal (incoherent vote), their staked tokens will be forfeited.

$$
Amount\_{slash} = S\_{stake} \times \alpha
$$

* $$ $\alpha$ $$: Penalty coefficient (e.g., 10%).
* Distribution: Of the forfeited tokens, 50% will be burned directly, and 50% will be awarded to the opposing arbitrator who cast the correct vote in the case.

***

#### 8.1.2 Fee Capture and Buyback-Burn Logic&#x20;

The OmniPact protocol generates cash flow through real business activities and creates deflationary pressure by directly injecting value into the $PACT token through a “buyback-and-burn” mechanism.

1\. Agreement Revenue Streams

The treasury captures the following types of value:

* Protocol Fee: A fee deducted from each OES-secured transaction. $$ $F\_{fee}$ $$（ 0.5%）。
* Arbitration Tax: A small portion (e.g., 5%) of the appeal fees paid by the losing party is taxed.
* Vault Yield: DeFi interest income generated by idle funds in OmniVault through the ERC-4626 strategy (Yield Spread).
  * Note: The agreement retains 20% of the interest rate spread, with the remaining 80% going to the user.

2\. The Auto-Buyback Engine

Instead of accumulating idle ETH or USDC, we automatically execute buybacks through smart contracts.

* Trigger: When accumulated income reaches a threshold (e.g., 10 ETH),`FeeDistributor` The contract is triggered automatically.
* Execution: The contract calls Uniswap V3 or Curve's TWAP (Time Weighted Average Price) oracle interface to purchase $PACT on the open market using ETH/USDC.

  Solidity

  ```
  function swapAndBurn() external onlyKeeper {
      uint256 amountIn = address(this).balance;
      uint256 amountOut = swapRouter.exactInputSingle(
          IV3SwapRouter.ExactInputSingleParams({
              tokenIn: WETH,
              tokenOut: PACT,
              fee: 3000,
              recipient: address(0xdead), // The Black Hole
              amountIn: amountIn,
              // ...
          })
      );
      emit TokensBurned(amountOut);
  }
  ```

3\. Economic Effect: Deflationary Flywheel

This mechanism creates a positive feedback loop between the coin price and protocol usage:

1. Usage $$ $\uparrow$ $$A$$ $\uparrow$ $$: More people are using OmniPact for escrow transactions.
2. Fees $$ $\uparrow$ $$A: The protocol captures more ETH/BNB/USDC revenue.
3. Buy Pressure A$$ $\uparrow$ $$: Automatic repurchase increases market demand for $PACT.
4. Supply $$ $\downarrow$ $$B: The repurchased tokens are burned, permanently reducing the circulating supply.
5. Price A$$ $\uparrow$ $$: The price of the coin rose due to the combined effect of increased demand and decreased supply.
6. Security A$$ $\uparrow$ $$: The increase in coin price raises the cost of attack (because$$ $S\_{min}$ $$and thus attract more high-value transactions, returning to step 1).

With this design, $PACT holders can passively share in the benefits of the protocol's growth through the deflation of the total token supply, even without participating in staking, thus avoiding the regulatory risks of defining the token as a security (because there are no direct dividends).

***

This section demonstrates to investors through rigorous formulas and logical derivations that OmniPact is not a "scam coin" project, but a decentralized business entity with strong cash flow capture capabilities and value support.


# 8.2 Governance (DAO )

The governance of OmniPact is not a simple "one token, one vote (1 Token = 1 Vote)" system, as this model is highly vulnerable to lending attacks (voting with borrowed tokens) or short-sighted capital behaviors. We adopt the vePACT (Vote-Escrowed PACT) model to ensure that only stakeholders who have made long-term commitments to the protocol can steer the ship.

#### 8.2.1 vePACT Implementation&#x20;

1\. Mechanism Definition

vePACT is a non-transferable, time-weighted governance right. Users must lock their $PACT tokens in the VotingEscrow contract to obtain vePACT.

Voting weight formula:

The user's voting weight $w$ depends on the number of locked assets $a$ and the remaining lock-up time $t$:

$$
w = a \times \frac{t\_{unlock} - t\_{now}}{t\_{max}}
$$

* Tmax$$ $t\_{max}$ $$: Maximum lock-up period (set to 4 years).
* Linear Decay: As time passes, the remaining lock-up period shortens, and the balance of vePACT held will decrease linearly. To maintain voting rights, users must continuously extend the lock-up period.

2\. Incentive Alignment

* Time weighting: The voting power of 1 token locked for 4 years is equivalent to that of 4 tokens locked for 1 year. This gives long-term believers more say than short-term speculators.
* Flash Loan Resistance: Since voting rights are based on locked positions (with a snapshot taken at block $N-1$), attackers cannot borrow coins, vote, and return them within a single block using flash loans.
* Earnings Boost: Users holding vePACT can receive a maximum 2.5x $PACT reward boost when participating in arbitration or providing liquidity.

#### 8.2.2 Governance Scope & Parameter Adjustment&#x20;

DAO does not manage everything. For the sake of security, we have divided governance rights into two categories: sensitive parameters and logical upgrades, and implemented strict execution delays.

1\. Governable Parameters

vePACT holders can modify the following core variables through on-chain proposals (OIP - OmniPact Improvement Proposal):

* Protocol Fee Rate ($$ $\phi$ $$):Transaction fee rate(Scope limit: 0% - 2%).
* Jurisdiction Whitelist: Approve the addition of new arbitrator nodes or the removal of malicious nodes.
* Vault Strategies: Approve the whitelist of DeFi protocols where idle funds can be invested (such as adding the Aave V3 strategy).
* Inflation Rate: Adjust the inflation/release curve of the token (if any).

2\. Time-delays & Security

To prevent funds from being stolen due to "malicious proposals being suddenly passed", all proposals must be subject to the constraints of the TimelockController contract.

* Process:
  1. Propose: Only users holding more than 1% of vePACT can initiate a proposal.
  2. Vote:Voting period (3 - 7 days).
  3. Queue:After the proposal is passed, it enters the "public notice and queuing period" (Timelock Delay).
  4. Execute: After the queuing period ends, anyone can trigger the execution.
* Emergency Brake\
  Set Delay = 48 hours.

  These 48 hours are the "escape window" of the protocol. If a malicious proposal is passed (such as changing the rate to 100%), the community and the Guardian Multisig will have time before the code takes effect to:

  * User: Withdraw funds (Rage Quit).
  * Guardian: Trigger `veto()` Veto power (only for extremely urgent safety accidents).

3\. Guardian Multisig

Before a DAO is fully mature (during the Progressive Decentralization phase), a 6-of-9 multi-signature wallet composed of the core team and well-known community members has limited permissions:

* Permissions: Only able to Pause the protocol (in case of a hack) or Veto malicious proposals.
* Restrictions: Guardians cannot withdraw funds nor modify the logic code.
* Sunset Clause: It is expected that 24 months after the mainnet goes live, the guardian rights will be completely removed through hard coding to achieve 100% decentralization.

***

> This section demonstrates the maturity of OmniPact in governance design: it not only empowers the community but also prevents the abuse of such power through mathematical models (veToken) and security mechanisms (Timelock).


# Security & Risk Analysis

As a decentralized protocol that carries high-value commercial transactions, security is the cornerstone of OmniPact. We not only pay attention to code vulnerabilities at the smart contract level (such as reentrancy attacks), but also focus on economic attacks at the game theory level.


# 9.1 Attack Vectors & Mitigation

We conducted a comprehensive stress test on the protocol based on the STRIDE threat model and designed defense mechanisms for the following three core attack vectors.

#### 9.1.1 51% Attacks on Arbitration&#x20;

#### Threat:

Attackers attempt to control more than half of the arbitrator seats in the DAN network, thereby stealing escrow funds or illegally seizing opponents' collateral through malicious majority voting (such as ruling that "empty packages are genuine").

#### Mitigation Strategies:

1. Random Sortition & Secrecy:

   Due to the adoption of VRF (Verifiable Random Function) and the Commit-Reveal mechanism, attackers cannot know who the specific arbitrators are before the voting results are revealed. This means that attackers cannot carry out precise bribery and can only attempt to bribe the entire network, which is economically impractical.
2. Appeal & Forking Deterrence:

   Even if an attacker temporarily breaks through the first round of arbitration (with 3 people) or even the second round (with 7 people), the victim can continue to appeal. As the size of the jury expands exponentially, the attack cost $C\_{attack}$ will quickly exceed the potential profit $R\_{profit}$.

$$
C\_{attack}(k) \approx \sum\_{r=0}^{k} (N\_r \times \text{BribeCost}) \gg R\_{profit}
$$

* Ultimate Defense: If an attacker has unlimited funds and controls 51% of the $PACT tokens (the final jury), the community will trigger a Social Fork. Honest nodes will migrate to the new contract, and the attacker's $PACT tokens will be zeroed out on the new chain. This "mutually assured destruction" deterrent ensures that rational large holders will not act maliciously.

3. Economic Isolation:

Each case is independent. Even if a certain case is attacked, the attacker's influence is limited to the fund pool of that case, and they cannot directly deplete other users' funds in OmniVault through this vulnerability.

#### 9.1.2 Flash Loan Attacks on Collateral&#x20;

**Threat:**

Attackers use Flash Loans to borrow huge amounts of funds within a single block, manipulate price oracles on DEXs (such as Uniswap), causing OmniPact to miscalculate the value of collateral (for example, determining insufficient collateral and liquidating it) or manipulate the share price of OmniVault.

**Mitigation Strategies:**

1. Hardened Oracles:

   OES strictly prohibits the direct use of DEX's instantaneous spot prices. We mandate the integration of Chainlink Price Feeds, which aggregate weighted data from multiple centralized and decentralized exchanges. A single flash loan cannot manipulate Chainlink's global consensus price.

   * Alternative plan: For long-tail assets, TWAP (Time-Weighted Average Price) is adopted. Attackers must continuously manipulate prices across multiple blocks, which is extremely costly.
2. ERC-4626 Defense:

   OmniVault adopts strict accounting standards when calculating the share exchange rate:

   * Donation Attack Prevention:During the initialization of the Vault, a small number of shares (Dead Shares) are pre-minted and then destroyed to prevent attackers from manipulating the exchange rate through donating assets to an empty pool, which could lead to rounding errors.
   * Virtual Offset: Introduce a virtual asset offset in the internal pricing formula to smooth out extreme exchange rate fluctuations.
3. Same-Block Restrictions:

   The protocol prohibits the completion of deposit and withdraw operations within the same block. This logically cuts off the path for risk-free arbitrage using flash loans.

#### 9.1.3 Front-running Protection&#x20;

Threat:

MEV searchers monitor the mempool.

* Scenario A (Rush to Accept Orders): When seeing a public acceptance order with high profits, increase the Gas fee to rush to accept the order first.
* Scenario B (Following the vote): Seeing that a high-reputation arbitrator has submitted a vote, one rushes to submit the same vote to fraudulently obtain rewards.

Mitigation Strategies:

1. Designated Taker:

   The OES contract supports the whitelist mode. Buyers can directly specify the sellerAddress when creating an order.

   Solidity

   ```
   modifier onlySeller() {
       require(msg.sender == escrow.seller || escrow.seller == address(0), "Not authorized");
       _;
   }
   ```

   In the case of a designated order, even if a searcher sees the transaction, they cannot front-run it because the addresses do not match.
2. Commit-Reveal :

   As described in Section 4.3, the arbitration voting is divided into two stages.

   * Commit phase: What is committed is the hash value $$ $H(Vote + Salt)$ $$However, although searchers can see the transactions, they cannot know the contents.
   * Reveal phase: At this point, everyone reveals simultaneously, and there is no point in jumping the gun anymore (because the Commit window has been closed).
3. Private Mempool Integration:

   For institutional-level large-value transactions, the OmniPact frontend is integrated with Flashbots Protect RPC by default. Transactions are not routed through the public mempool but are directly sent to miners for packaging, eliminating the possibility of being front-run at the physical network level.

***

> This section presents OmniPact's mature technical solutions for combating Web3-specific financial risks (MEV, flash loans) to auditing institutions and high-net-worth users.


# 9.2 Audits & Formal Verification

In the "dark forest" of Web3, code is money. To ensure that OmniPact can handle trillions of dollars in commercial transactions, we have built a comprehensive security verification system that includes manual audits, mathematical proofs, and crowdsourced testing.

#### 9.2.1 Multi-Firm Audit Strategy&#x20;

A single auditing firm is inevitably prone to blind spots. OmniPact adopts a "Multi-Layer, Multi-Firm" cross-auditing strategy, entrusting the most professional teams to review different components of the protocol.

* L2 Core (OES & DAN):Entrust OpenZeppelin and Trail of Bits.
  * Key points: Smart contract logic vulnerabilities, reentrancy attacks, permission management, and upgrade proxy security.
* Zero-Knowledge Circuits (zk-KYC): Entrust Veridise or Zellic.
  * Key points: Completeness of circuit constraints (Under-constrained circuits), correctness of the implementation of cryptographic primitives.
* Tokenomics & Governance: Delegate Gauntlet.
  * Key points: Economic model simulation, stress testing under extreme market conditions, and simulation of governance attack vectors.

Audit process: `Internal Audit -> Alpha Audit (Fix) -> Beta Audit (Fix) -> Final Audit -> Mainnet Launch`. All audit reports will be fully disclosed to the community before the mainnet goes live.

#### 9.2.2 Formal Verification

Traditional unit testing can only prove that "the code is valid under these specific circumstances," while formal verification can prove that "the code is valid under all circumstances." We transformed the core state machine logic of OES into a mathematical model and verified it using Certora Prover and K Framework.

Proof of Core Invariants:

We define and prove the following mathematical specifications（Specifications）：

1. Solvency Conservation:

$$
\forall t, \sum \text{Balances}*{user}(t) == \text{TotalSupply}*{Vault}(t)
$$

(Proof: The total assets of the Vault will always be equal to the sum of all users' book balances, with no凭空增发 or disappearance.)

2. FSM Monotonicity:

$S\_{lock} \rightarrow S\_{init}$ The reverse transformation of is impossible under any input sequence (Impossible).

(Proof: Once funds are locked, it is absolutely impossible for them to roll back to the initial state without triggering the settlement conditions.)

3. Liveness Property:

For any state $S \in Q$, there must exist a path $P$ such that $S \xrightarrow{P} S\_{final}$ or $S \xrightarrow{P} S\_{void}$。

(Proof: No matter what kind of interaction occurs, funds will never be permanently frozen in the contract.)

Through mathematical proof, we eliminated an entire category of logical errors before deploying the code.

#### 9.2.3 Bug Bounty & Continuous Monitoring

Security is a dynamic process, and the mainnet launch is just the beginning.

1\. Bug Bounty Program

We will launch the highest-level bounty program in the Web3 field:

* Critical: Highest reward $1,000,000 (USDC)For vulnerabilities that can lead to fund theft, loss of governance rights, or network paralysis.
* High: Maximum reward of $100,000. For vulnerabilities that can cause temporary service interruptions or partial functional failures.
* This mechanism transforms white hat hackers (Whitehats) worldwide into security testers for OmniPact.

2\. On-Chain Monitoring

Integrating Forta Network and OpenZeppelin Sentinel to deploy real-time monitoring robots (Bots):

* Anomaly Detection: Monitor abnormal large capital outflows, frequent interactions with flash loans, or unknown function call patterns.
* Auto-Pause: When obvious hacking activities are detected (such as continuous triggering of assertion failures), the Guardian multi-signature has the right to activate the Circuit Breaker, suspend the operation of the protocol, and prevent the expansion of losses.

***

> By introducing formal verification and a million-dollar bounty, it demonstrates to the community OmniPact's investment in security and establishes institutional-level trust endorsement.


# 9.3 Emergency Response Protocol (ERP)

Although OmniPact has undergone rigorous audits and formal verification, when facing unknown zero-day exploits, the protocol must have "Fail-Safe" capabilities. The ERP protocol aims to limit the losses caused by attacks to a controllable range and prevent systemic collapse.

#### 9.3.1 Circuit Breakers & Rate Limiting&#x20;

To prevent large-scale theft of funds in a short period of time, we have built-in Algorithmic Circuit Breakers in the OmniVault core contract. This is a set of passive defense logic that can be triggered automatically without manual intervention.

1\. Outflow Rate Limiting

We have set a time-window-based withdrawal limit for OmniVault.

$$
Limit(t) = TVL\_{t-1} \times \text{MaxDrawdownPercentage}
$$

* Mechanism: If the net outflow of funds exceeds 10% of TVL (safety threshold) within a specific time window (such as 1 hour), the contract will be automatically triggered. `Suspension` Status.
* Effect: This ensures that even if a hacker gains control, they cannot steal all the funds at once, giving the team and community valuable response time.

2\. Price Deviation Breaker

When the price feed from the oracle (Chainlink) fluctuates sharply (such as a 99% drop within 1 hour), or when the price difference from the backup oracle (such as Uniswap TWAP) exceeds 5%, all liquidation and exchange operations involving that asset will be automatically suspended.

#### 9.3.2 Pausable Interfaces&#x20;

Based on the OpenZeppelin Pausable standard, we divide the functions of the protocol into different security levels and implement refined pause control.

1\. Implementation

The core contract inherits from PausableUpgradeable. Key state-changing functions are protected by the whenNotPaused modifier.

Solidity

```
function deposit(address token, uint256 amount) external whenNotPaused {
    // ... logic
}

function withdraw(address token, uint256 amount) external {
    // Special logic: Usually, withdrawals will also be suspended in emergency mode to prevent the spread of bad debts.
    require(!isEmergencyPaused, "Protocol paused due to security event");
    // ... logic
}
```

2\. Trigger Authority

* Guardian Multisig (6-of-9): To respond to second-level attacks, a multi-signature wallet composed of core developers and trusted community leaders has the authority to instantly pause the protocol (Instant Pause).
* Note: To prevent abuse of power, Guardian only has the right to pause, not the right to unpause. Unpausing must be approved by a vote on a DAO timelock proposal. This ensures that the end of a state of emergency must undergo careful evaluation by the community.

3\. The ERP Workflow

Once the Forta monitoring robot detects attack characteristics:

1. Freeze : The fuse is automatically triggered or Guardianmanual call `pause()`At this point, all recharges, transaction creations, and fund withdrawals are frozen.
2. Diagnose: The security team and auditing firms (such as Trail of Bits) stepped in to analyze the attack vectors and determine the scope of the damage.
3. Patch : The development team writes a fix patch and deploys a new logic contract implementation through the UUPS proxy pattern.
4. Vote & Restart : Submit the repair plan to DAO for voting. After the community verifies that it is correct, the vote will be executed. `upgradeTo()` and `unpause()`, the agreement resumed normal operation.


# Conclusion: The Future of Trustless Commerce

In the first decade of Web3.0, we witnessed how DeFi (Decentralized Finance) reshaped the issuance and trading of currencies through code. However, finance is merely a means, not an end. The next revolution in blockchain will undoubtedly be DeCom (Decentralized Commerce) — that is, enabling crypto assets to truly flow into the exchange of real-world goods and services.

The birth of OmniPact Protocol is precisely to bridge this huge gap.

Through our original "FSM + Game Theory" two-layer consensus architecture, we have solved the long-standing "commercial oracle problem" that has plagued the industry. We have proven that: without relying on centralized giants like Amazon or Taobao, and without expensive legal intermediaries, the combination of code and social consensus is sufficient to build a more efficient, fairer, and globally universal trust layer.

•\
For developers: OmniPact is your toolbox. Using the OES state machine and DAN network, you can build the next generation of decentralized Taobao, Uber, or Upwork without worrying about underlying fund escrow and dispute resolution.\
•\
For enterprises: OmniPact is your global settlement channel. Through RWA adapters and privacy computing, you can access the trillion-scale crypto capital market with zero threshold, enabling efficient circulation of assets.\
•\
For individuals: OmniPact is your declaration of sovereignty. Through Omni-ID, you regain ownership of your own reputation data. Here, reputation is assets, and honesty is wealth.

What we are building is not just a protocol, but the TCP/IP of the Web3 world — a neutral, permissionless, and never-stopping value transmission and guarantee network.

Although the technical architecture is ready, the prosperity of the OmniPact ecosystem cannot be achieved without the joint construction of the community. This is an infinite game belonging to everyone. In this new world woven by cryptography and game theory, we invite every developer, arbitrator, merchant, and user to become a "node of trust."

{% hint style="success" %}
Escrow Everything, Connect Future.
{% endhint %}


# Get help

<figure><img src="/files/YsaCjzYCqoHRvBZVfjxy" alt=""><figcaption></figcaption></figure>

If you encounter difficulties, or if some functions do not work as expected, or if you are unsure whether some functions are working, this help section may be able to assist you.

### Help section

To help you quickly find the content you need, we have divided the help topics into multiple sections. Below is an overview of what you will find.

### Troubleshooting

The "[Troubleshooting Errors](/support/troubleshooting)" page collects various errors that users may encounter when using OmniPact. This page not only displays the problems but also provides solutions and explanations of the causes of the problems.

### Frequently Asked Questions

The[ Frequently Asked Questions (FAQ)](https://docs.omnipact.io/support/frequently-asked-questions) page addresses the questions commonly raised by OmniPact users. The answers to these questions provide advice, explanations, or links to practical resources.

### Other guidelines

There are also many guides in the help topics that can instruct you to solve technical problems. We will add guides for problems that frequently occur and may be difficult to solve, so if you encounter difficulties, be sure to look for relevant guides here.

### Seeking support

OmniPact does not have a dedicated customer service department. If you cannot find an answer to your problem here, you can go to the "[OmniPact Telegram Channel](https://t.me/addlist/yww-_328oDtmODY9)" or contact <omni@omnipact.io> for help. For your safety, if you are joining our Telegram channel for the first time, be sure to read the tips on fraud prevention.


# Troubleshooting


# Audit


# Omni Academy


# Frequently Asked Questions


