# Onyx App (Mainnet)

**Onyx App** is the primary DeFi interface for Goliath Mainnet. It provides swap, bridge, and liquid staking functionality in a single application.

**Access:** <https://app.onyx.org>

## Modules

| Module             | Description                                                        |
| ------------------ | ------------------------------------------------------------------ |
| **Swap**           | Token swaps via UniswapV2-style AMM on Goliath Mainnet             |
| **Bridge**         | Cross-chain transfers between Ethereum Mainnet and Goliath Mainnet |
| **Liquid Staking** | Stake XCN and receive staked position tokens                       |

***

## Swap (DEX)

Onyx App's swap module uses a UniswapV2 constant-product AMM deployed on Goliath Mainnet (Chain 327).

### Supported Tokens

| Token                  | Contract Address                             | Notes                                                         |
| ---------------------- | -------------------------------------------- | ------------------------------------------------------------- |
| **WXCN** (Wrapped XCN) | `0x1a0Da75ADf091a69E7285e596bB27218D77E17a9` | Fully permissionless. Anyone can deposit/withdraw.            |
| **ETH**                | `0x9253587505c3B7E7b9DEE118AE1AcB53eEC0E4b6` | Bridged ERC-20. Minted by BridgeMint on cross-chain transfer. |
| **USDC**               | `0xC8410270bb53f6c99A2EFe6eD3686a8630Efe22B` | Bridged ERC-20. Minted by BridgeMint on cross-chain transfer. |

{% hint style="info" %}
XCN is the native gas token on Goliath Mainnet. WXCN is the ERC-20 wrapped form used in AMM pools.
{% endhint %}

### Core DEX Contracts

| Contract              | Address                                      | Notes                                                |
| --------------------- | -------------------------------------------- | ---------------------------------------------------- |
| **UniswapV2Factory**  | `0x008c99EedA17E193e5F788536234C6b3520B8D15` | Protocol fees permanently locked (feeToSetter = 0x0) |
| **UniswapV2Router02** | `0xa973c5626eEaF7F482439753953e9B28C6aF3674` | Stateless utility, no admin functions                |
| **Multicall3**        | `0x88b4BC8e5bd74327B5456466F3f30143986cC1f9` | Permissionless read-only aggregator                  |

{% hint style="warning" %}
The UniswapV2Factory `feeToSetter` is permanently locked to the zero address due to a relay deployment issue. Protocol fees can never be enabled on this factory instance.
{% endhint %}

### User Flow

1. Connect wallet to Goliath Mainnet (Chain ID `327`)
2. Open [app.onyx.org](https://app.onyx.org)
3. Choose input/output token pair
4. Set amount and review price impact/slippage
5. Approve token (first swap per token)
6. Confirm swap transaction

***

## Bridge

The Onyx App bridge transfers assets between **Ethereum Mainnet** (Chain 1) and **Goliath Mainnet** (Chain 327).

### Supported Bridge Assets

| Asset    |        Ethereum -> Goliath        |          Goliath -> Ethereum         |
| -------- | :-------------------------------: | :----------------------------------: |
| **ETH**  | Lock on Ethereum, mint on Goliath | Burn on Goliath, release on Ethereum |
| **USDC** | Lock on Ethereum, mint on Goliath | Burn on Goliath, release on Ethereum |
| **XCN**  | Lock on Ethereum, mint on Goliath | Burn on Goliath, release on Ethereum |

### Bridge Contracts

| Contract       | Network          | Address                                      |
| -------------- | ---------------- | -------------------------------------------- |
| **BridgeLock** | Ethereum Mainnet | `0xa9fd64b5095d626f5a3a67e6db7fb766345f8092` |
| **BridgeMint** | Goliath Mainnet  | `0x1d14ae13ca030eb5e9e2857e911af515cf5ffff2` |

### How the Bridge Works

```
Ethereum Mainnet                              Goliath Mainnet
================                              ===============

+------------------+                          +------------------+
| BridgeLock       |    Relayer monitors      | BridgeMint       |
| Locks ETH/USDC/  | ======================> | Mints bridged    |
| XCN on Ethereum  |    and relays proofs     | tokens on Goliath|
+------------------+                          +------------------+

+------------------+                          +------------------+
| BridgeLock       |    Relayer monitors      | BridgeMint       |
| Releases tokens  | <====================== | Burns bridged    |
| on Ethereum      |    and relays proofs     | tokens on Goliath|
+------------------+                          +------------------+
```

### Bridge Transfer Times

| Direction               | Approximate Time | Why                                                                 |
| ----------------------- | ---------------- | ------------------------------------------------------------------- |
| **Ethereum -> Goliath** | \~5 minutes      | Waits for Ethereum block finality (6 confirmations) before relaying |
| **Goliath -> Ethereum** | \~1 hour         | Includes a security hold period before releasing funds on Ethereum  |

### Bridge Fees

Bridging from **Ethereum to Goliath is free** — no fees are charged on deposits.

Bridging from **Goliath to Ethereum** incurs a withdrawal fee to cover Ethereum gas costs. The fee is calculated as:

> **Fee = max(0.25% of transfer amount, minimum fee for the token)**

This means the bridge always charges at least the **minimum fee** (which covers Ethereum gas costs for the relayer), even if 0.25% of your transfer would be less. For larger transfers, the standard 0.25% rate applies.

#### Fee Schedule (Goliath -> Ethereum)

| Token    | Fee Rate | Minimum Fee | Minimum Bridge Amount |
| -------- | -------- | ----------- | --------------------- |
| **ETH**  | 0.25%    | 0.003 ETH   | 0.01 ETH              |
| **USDC** | 0.25%    | 5 USDC      | 10 USDC               |
| **XCN**  | 0.25%    | 1,000 XCN   | 5,000 XCN             |

{% hint style="info" %}
The **minimum fee** is a gas-coverage floor — if 0.25% of your transfer is less than the minimum fee, the minimum fee is charged instead. For example, withdrawing 100 USDC would result in a 5 USDC fee (the minimum), not 0.25 USDC.
{% endhint %}

#### Examples

| Transfer      | 0.25% Would Be | Minimum Fee | Actual Fee Charged              |
| ------------- | -------------- | ----------- | ------------------------------- |
| 0.5 ETH       | 0.00125 ETH    | 0.003 ETH   | **0.003 ETH** (minimum applies) |
| 5 ETH         | 0.0125 ETH     | 0.003 ETH   | **0.0125 ETH** (0.25% applies)  |
| 100 USDC      | 0.25 USDC      | 5 USDC      | **5 USDC** (minimum applies)    |
| 10,000 USDC   | 25 USDC        | 5 USDC      | **25 USDC** (0.25% applies)     |
| 10,000 XCN    | 25 XCN         | 1,000 XCN   | **1,000 XCN** (minimum applies) |
| 1,000,000 XCN | 2,500 XCN      | 1,000 XCN   | **2,500 XCN** (0.25% applies)   |

{% hint style="warning" %}
Transfers below the **minimum bridge amount** are rejected. You must bridge at least 0.01 ETH, 10 USDC, or 5,000 XCN when withdrawing to Ethereum.
{% endhint %}

### User Flow

**Ethereum -> Goliath** (\~5 minutes, no fee)**:**

1. Connect wallet to Ethereum Mainnet
2. Approve and lock tokens in BridgeLock
3. Wait for relayer confirmation (\~5 minutes)
4. Switch to Goliath Mainnet to verify receipt

**Goliath -> Ethereum** (\~1 hour, 0.25% fee)**:**

1. Connect wallet to Goliath Mainnet
2. Approve and burn bridged tokens via BridgeMint
3. Wait for relayer confirmation (\~1 hour)
4. Switch to Ethereum Mainnet to verify receipt

***

## Liquid Staking

Liquid staking on Goliath Mainnet lets users stake XCN and earn rewards while maintaining liquidity through a staked position token.

### Staking Contract

| Contract            | Address                                      | Notes                  |
| ------------------- | -------------------------------------------- | ---------------------- |
| **StakedXCNDirect** | `0xA553a603e2f84fEa6c1fc225E0945FE176C72F74` | UUPS upgradeable proxy |

**Current balance:** 107,790 XCN staked

### Key Features

* Stake XCN and earn rewards automatically
* UUPS upgradeable contract with owner controls
* Owner can adjust reward rates, treasury, and fee parameters
* Pause/unpause functionality for emergency situations

### User Flow

1. Connect wallet to Goliath Mainnet (Chain ID `327`)
2. Open [app.onyx.org](https://app.onyx.org) liquid staking module
3. Enter XCN amount and submit stake
4. Rewards accrue automatically
5. Unstake when ready to receive XCN back

***

## Network Configuration

To use Onyx App, connect your wallet to Goliath Mainnet:

| Field                  | Value                                                          |
| ---------------------- | -------------------------------------------------------------- |
| **Network Name**       | Goliath Mainnet                                                |
| **RPC URL**            | [`https://rpc.goliath.net`](https://rpc.goliath.net)           |
| **Chain ID**           | `327`                                                          |
| **Currency Symbol**    | `XCN`                                                          |
| **Block Explorer URL** | [`https://explorer.goliath.net`](https://explorer.goliath.net) |

***

## Related Documentation

* [**Bridge Integration (Developer Guide)**](/developer-guide/bridge.md) - Build your own bridge client for mobile or web
* [**Slingshot (Testnet DeFi)**](/defi/slingshot.md) - DeFi interface for Goliath Testnet
* [**Smart Contract Addresses**](/reference/contracts.md) - Full contract registry for both networks
* [**Rewards Overview**](/rewards/overview.md) - Staking and validator reward details


---

# 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://docs.goliath.net/defi/onyx-app.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.