# Omnex Bridge DApp Guide

This guide will walk you through the process of using the **Omnex Layer Bridge** to transfer assets, specifically ETH, between the Ethereum network and the **Omnex Layer** network.

Below are the details for the mainnet and testnet versions of the bridge:

| Version                   | DApp URL                   | Network                                                                                                  |
| ------------------------- | -------------------------- | -------------------------------------------------------------------------------------------------------- |
| **Omnex Bridge(Mainnet)** | <https://bridge.omnex.co/> | <p>Layer1: <em><strong>Base Mainnet</strong></em><br>Layer2: <em><strong>Omnex Mainnet</strong></em></p> |

***

### Prerequisites <a href="#prerequisites" id="prerequisites"></a>

Before you begin, please ensure you have the following:

* A web3 wallet, such as **MetaMask** or **OKX Wallet**.
* ETH in your wallet on the source network (Ethereum or Sepolia) to pay for gas fees and the deposit amount.

***

### 1. Connecting Your Wallet <a href="#id-1-connecting-your-wallet" id="id-1-connecting-your-wallet"></a>

First, navigate to the Omnex Bridge DApp homepage.

1. **Initiate Connection**: Click the **"Connect Wallet"** button.

<figure><img src="https://485661076-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaTdjVVwqlIn4uvi2FVUT%2Fuploads%2FWEscjLtPeWxygaXD8lKz%2Fconnect-wallet%20(1).png?alt=media&#x26;token=a33cded0-c35d-42e8-848c-53933667dfb3" alt=""><figcaption></figcaption></figure>

1. **Choose Your Wallet**: A pop-up will appear. Select either MetaMask or OKX Wallet.

<figure><img src="https://485661076-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaTdjVVwqlIn4uvi2FVUT%2Fuploads%2FBwg1zeMouyclg7iRclek%2FNew%20Project%20(6).png?alt=media&#x26;token=82774aa3-0f53-4686-bc78-2f68ffa9f4ee" alt=""><figcaption></figcaption></figure>

3. Approve and Configure: Follow the prompts in your wallet extension to approve the connection. The DApp will also prompt you to add or switch to the correct network (e.g., **Omnex Layer** Mainnet or **Omnex Layer** Testnet) if you are not already connected to it. You can also use the network switcher in the top-right corner to change networks manually.

***

### 2. How to Deposit (from Ethereum to Omnex) <a href="#id-2-how-to-deposit-from-ethereum-to-jovay" id="id-2-how-to-deposit-from-ethereum-to-jovay"></a>

The deposit process transfers ETH from the Base network (L1) to the Omnex network (L2).

1. **Select Deposit**: Navigate to the **"Deposit"** tab.
2. **Enter Amount**: Input the amount of ETH you wish to transfer to Omnex.

<figure><img src="https://485661076-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaTdjVVwqlIn4uvi2FVUT%2Fuploads%2FutCa5f23pdvUFYFReLaG%2Fdeposit-tab.png?alt=media&#x26;token=564784b8-c507-461e-b845-286a5137ceec" alt=""><figcaption></figcaption></figure>

3. **Start Deposit**: Click the **"Deposit"** button.
4. **Confirm Transaction**: Your wallet will pop up asking you to confirm the transaction. Review the details and confirm.

<figure><img src="https://485661076-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaTdjVVwqlIn4uvi2FVUT%2Fuploads%2FIYSVIPLSZab5mfDulBRo%2Fconfirm-deposit-transaction.png?alt=media&#x26;token=436c2663-9280-4012-9370-8445a8170a19" alt=""><figcaption></figcaption></figure>

5. **Monitor Progress**: After confirming, the transaction will appear in the history panel on the right. You can click on this transaction to view its status.

<figure><img src="https://485661076-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaTdjVVwqlIn4uvi2FVUT%2Fuploads%2FTjyc8Q3t1sa1mNOBD78K%2FNew%20Project%20(7).png?alt=media&#x26;token=88d96386-519a-4b5a-b824-b756d3a79da9" alt=""><figcaption></figcaption></figure>

The deposit process involves two main stages:

* The transaction is first finalized on Ethereum (L1).
* The **Omnex Layer** Relayer detects the finalized L1 transaction and processes the corresponding deposit on **Omnex Layer** (L2).

6. **Deposit Complete**: Once the process is finished, the status will update to "Completed". You can then click the "View on **Omnex Layer**Scan" link to see your transaction details on the **Omnex Layer** block explorer.

<figure><img src="https://485661076-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaTdjVVwqlIn4uvi2FVUT%2Fuploads%2F2mqd7cdKvSZKpufwOg8N%2FNew%20Project%20(8).png?alt=media&#x26;token=5fdc2a98-74c0-4302-83fc-1fbd8fd8f485" alt=""><figcaption></figcaption></figure>

<figure><img src="https://485661076-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaTdjVVwqlIn4uvi2FVUT%2Fuploads%2FF0dn6AabuKuXELz1Yls8%2FNew%20Project%20(9).png?alt=media&#x26;token=c1d043ea-15f7-4050-9cc8-814992b4515b" alt=""><figcaption></figcaption></figure>

***

### 3. How to Withdraw (from Omnex to Ethereum) <a href="#id-3-how-to-withdraw-from-jovay-to-ethereum" id="id-3-how-to-withdraw-from-jovay-to-ethereum"></a>

The withdrawal process transfers ETH from the **Omnex Layer** network (L2) back to the Ethereum network (L1). This is a multi-step process.

1. **Switch to Omnex Layer**: Make sure the DApp is switched to the **Omnex Layer** network in the top-right corner; if it isn't, you can click “Switch to the **Omnex Layer** network”.
2. **Select Withdraw**: Navigate to the **"Withdraw"** tab.
3. **Enter Amount**: Input the amount of ETH you wish to withdraw to Ethereum.
4. **Start Withdrawal**: Click the **"Withdraw"** button and confirm the transaction in your wallet.

<figure><img src="https://485661076-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaTdjVVwqlIn4uvi2FVUT%2Fuploads%2FmcnCjE5N8wGgb4t5yFSe%2Fwithdraw-tab.png?alt=media&#x26;token=ed8d5361-f8da-4fe9-8a48-af2692ea6be7" alt=""><figcaption></figcaption></figure>

5. **Track Withdrawal Status**: Click on the transaction in the history panel to track its progress through several stages:

<figure><img src="https://485661076-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaTdjVVwqlIn4uvi2FVUT%2Fuploads%2FnkXQSrMpkZkw2R3uM8OV%2FNew%20Project%20(10).png?alt=media&#x26;token=75e6d0f6-4793-4d92-8992-ee14720806c1" alt=""><figcaption></figcaption></figure>

<figure><img src="https://485661076-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaTdjVVwqlIn4uvi2FVUT%2Fuploads%2FN4zt00PYb3exPf2wmczu%2Fwithdraw-history.png?alt=media&#x26;token=26803ad8-adaa-406b-a646-315eb8fb6251" alt=""><figcaption></figcaption></figure>

* **Wait for wallet confirmation**: The initial state after you submit the transaction.
* **The transaction is being confirmed on Omnex Layer**: Your withdrawal is being processed and included in a block on the **Omnex Layer** network.
* **TEE is generating withdrawal proof**: The Trusted Execution Environment (TEE) is creating the necessary proof for your withdrawal.
* **Proof submitted**: The withdrawal proof has been posted to the Base network.
* **Withdrawals are ready**: The funds are now ready to be claimed on Base Chain.

6. **Claim Your Funds**: This is a crucial manual step. Once the status reaches "Withdrawals are ready on Ethereum," you must click the "Claim Funds" button. This will initiate a new transaction on the Ethereum network to transfer the funds to your wallet.

**Note**: The withdrawal process starts on **Omnex Layer**, but once the proof is submitted to the Ethereum network, you will need to switch to the Base network to "Claim Funds".

When you click "Claim Funds," MetaMask will pop up a confirmation window. After verifying the details, click **Confirm** to complete the transfer and receive your funds.

7. **Withdrawal Complete:** Once you confirm the “Claim Funds” transaction in your wallet and it’s successfully verified on the Ethereum blockchain, your withdrawal through **Omnex Layer** is complete. You can check the finalized transaction on an Ethereum block explorer (such as Etherscan) and view your updated ETH balance in your wallet.

***

### 4. Transaction History

The panel on the right side of the page shows your recent transaction history through **Omnex Layer**.

You can filter the list by selecting **“All”**, **“Deposit”**, or **“Withdraw.”**

If your most recent transaction isn’t visible, try switching between these tabs or refreshing the page to update the list.

***

{% hint style="warning" %}
Please be advised: To maintain the security of funds, the **Omnex Layer bridge** operates with protective limits. The current network-wide **daily withdrawal limit is 25 ETH**. This limit is shared among all users and resets periodically.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://omnex-layer.gitbook.io/omnex-layer/guides/omnex-bridge-dapp-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
