DOCUMENTATION

Quick Start

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

Documentation

Tokenomics

Add Onyx Mainnet

The fastest way to add Onyx to MetaMask or another EVM wallet is from Onyx Scan: 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:

SettingValue
Network nameOnyx Mainnet
RPC URLhttps://rpc.onyx.org
Chain ID327
Currency symbolXCN
Explorerhttps://onyxscan.org

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. See Network Fees for the current snapshot, calculation, and USD denomination.