> For the complete documentation index, see [llms.txt](https://onex-3.gitbook.io/onex-document/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://onex-3.gitbook.io/onex-document/coin/migration.md).

# Migration

## 3.1 Migration Architecture Overview

ONEx Token (ERC-20 on Polygon Mainnet) migrates **1:1** to ONEx Coin (native gas token on ONEx Chain L2, built with Polygon CDK).

**Migration ratio: 1 ONEx Token = 1 ONEx Coin. No supply change. No dilution.**

***

## 3.2 Bridge Security Model

| Security Feature           | Specification                                                                                     |
| -------------------------- | ------------------------------------------------------------------------------------------------- |
| ZK Verification            | Both SNARK and STARK proofs required, from independent prover networks                            |
| Withdrawal Delay           | 24-hour mandatory delay for amounts exceeding $50,000 USDT equivalent                             |
| Bridge Insurance Fund      | 2% of ICO raise ($316,000) held in separate multisig — pays out on bridge failure within 48 hours |
| Bridge Guardian Multisig   | 3-of-5 — emergency pause capability held by 5 independent security firms                          |
| Transaction Monitoring     | Chainalysis + in-house anomaly detection, alerts within 30 seconds                                |
| Maximum Single Transaction | $500,000 equivalent — larger amounts require DAO approval + 48h timelock                          |

***

## 3.3 Migration Process

{% stepper %}
{% step %}

### Prepare ONEx Chain

* Deploy Polygon CDK Chain with `zkevm_use_gas_token_contract=true`
* ONEx Coin configured as native gas token (not wrapped ERC-20)
* All contracts audited by minimum 3 independent security firms before deployment
  {% endstep %}

{% step %}

### Lock Old Supply (Polygon Mainnet)

* User deposits ONEx Token into Escrow Contract via `deposit(amount)` function
* **NO WITHDRAW FUNCTION EXISTS** — deposits are irreversible by design
* Tokens are effectively burned on L1 upon deposit
* Supply integrity guaranteed: total L1 locked = total L2 minted, always
  {% endstep %}

{% step %}

### Mint Native Coin (ONEx Chain L2)

* Bridge Message relayed from L1 Escrow to L2 Escrow with ZK proof
* L2 Escrow calls `mint(user, amount)` — minting native ONEx Coin to user wallet
* Migration processing time: 10–30 minutes (ZK proof generation)
  {% endstep %}
  {% endstepper %}

***

## 3.4 User Migration Flow

```
Connect Wallet → Approve ERC-20 → Deposit to Escrow (L1) 
→ Wait for ZK proof → Receive ONEx Coin (L2)
```

***

## 3.5 Liquidity Migration

* Deploy Liquidity Pool on DEX (ONEx Chain) BEFORE migration opens
* Seed LP with Treasury Supply (USDT + ONEx Coin)
* Gradually wind down L1 liquidity pools over 90-day transition period
* Migration ratio maintained throughout: **1:1 always**