For the complete documentation index, see llms.txt. This page is also available as Markdown.

Quick Start

Add Onyx Mainnet to a wallet and make a safe first transaction.

Add Onyx Mainnet

The fastest way to add Onyx to MetaMask or another EVM wallet is from the Onyx Explorer: open the explorer and use the Add Onyx Network control in the bottom-left corner for a one-click wallet prompt.

You can also enter the network details manually:

Setting
Value

Network name

Onyx Mainnet

RPC URL

https://rpc.onyx.org

Chain ID

327

Currency symbol

XCN

For dApp / programmatic wallet setup (wallet_addEthereumChain) and RPC eth_chainId verification, see Developer Guide → Getting Started.

Important transaction rules

  • XCN is represented with 18 decimals through JSON-RPC, but the native ledger has 8-decimal precision. See XCN Decimal Handling.

  • A transfer to a new address can require substantially more gas because the account is created on first receipt. Always use eth_estimateGas; never hardcode 21,000. See Lazy Account Creation.

  • Read eth_gasPrice when preparing a transaction and handle RPC errors instead of assuming Ethereum Mainnet fee-market behavior.

Last updated