Bridge
Use the Mainnet bridge and interpret its live status correctly.
Use Bridge to Onyx to move XCN, ETH, and USDC between Ethereum Mainnet and Onyx Mainnet.
The bridge supports both directions. Fees, minimums, and processing times differ by direction. Always confirm current values in the app before you submit a transfer.
Supported assets
XCN
ERC-20 XCN
Native XCN (gas and transfers)
ETH
Native ETH
Bridged ETH (18 decimals)
USDC
ERC-20 USDC
Bridged USDC (6 decimals)
All three assets can move in both directions when the bridge is operational. If an asset is unavailable in the app, treat it as unsupported regardless of what appears elsewhere in the ecosystem.
Fees
Bridge fees are application-level charges and are separate from Onyx network gas. They can include a percentage charge, a per-asset minimum fee, or both. Directional fees and minimum transfer amounts can change.
Use the Onyx Bridge for the exact amount you will receive. Integrations must fetch the current limits and a live fee quote immediately before confirmation; documentation examples are not a source of truth for mutable bridge values.
See Network Fees for transactions submitted on Onyx. Transactions submitted on Ethereum incur Ethereum network gas separately.
Processing times and delays
Bridge transfers are not instant. Each transfer moves through several phases:
Source confirmation — your transaction is confirmed on the sending chain.
Security hold (Onyx → Ethereum only) — withdrawals wait approximately 1 hour before the relayer submits the Ethereum leg.
Relay — the bridge operator processes the transfer.
Destination submission — the receiving-chain transaction is broadcast.
Completion — funds arrive at your destination address.
Total time depends on network congestion, relayer load, and the direction you are bridging. Track progress in the Bridge app. A successful source transaction does not mean the destination leg has finished.
When bridge health is degraded, the app may enter maintenance mode and pause new transfers. Existing transfers can still be tracked — do not resubmit the same transfer.
For bridge APIs, smart-account requirements, and integration details, see Bridge Integration. External integrators use https://bridgeapi.onyx.org/api/v1.
Last updated