DOCUMENTATION

EVM JSON-RPC

Supported EVM JSON-RPC usage on Onyx Mainnet.

Documentation

Tokenomics

Mainnet endpoint: https://rpc.onyx.org

Common methods

The public relay supports the EVM methods commonly needed by wallets, exchanges, and applications, including:

  • Network and blocks: eth_chainId, net_version, eth_blockNumber, eth_getBlockByNumber, eth_getBlockByHash
  • Accounts and state: eth_getBalance, eth_getTransactionCount, eth_getCode, eth_getStorageAt
  • Transactions: eth_sendRawTransaction, eth_getTransactionByHash, eth_getTransactionReceipt
  • Contracts and fees: eth_call, eth_estimateGas, eth_gasPrice, eth_maxPriorityFeePerGas
  • Events: eth_getLogs and supported filter/subscription methods

Onyx does not promise support for every Ethereum client extension, debug method, pending-pool behavior, or future RPC method. Probe the exact method set your application requires and handle method not found or method not supported responses.

Example

bash

curl -sS https://rpc.onyx.org \
  -H 'content-type: application/json' \
  --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

Onyx-specific considerations

  • Native XCN is returned in 18-decimal RPC units but settles at 8-decimal ledger precision.
  • eth_estimateGas must be used for transfers because the recipient account may need to be created.
  • Read the current gas price; do not use fixed price tiers copied from another network. See Network Fees for Onyx's fee calculation and USD denomination.
  • Public capacity and throttling can change. Back off on transient errors and arrange dedicated service before depending on a specific SLA. To run your own endpoint, see Run an Onyx RPC.