FAQ and Troubleshooting

Current Onyx limitations and troubleshooting guidance.

Is Onyx a rollup or Layer 3?

No. Onyx is an EVM-compatible Layer 1 with its own aBFT consensus.

Why did a transfer to a new address run out of gas?

The recipient account may need to be created on first receipt. Use eth_estimateGas with the real transaction and do not hardcode 21,000.

Why does native XCN have 18 RPC decimals but only 8 usable decimals?

JSON-RPC uses an 18-decimal wei-style representation while the native ledger settles in tinyxcn at 8-decimal precision. Align native values to multiples of 10^10 RPC units.

How much does an Onyx transaction cost?

The fee depends on the gas used and the current gas price. Onyx prices network resources in USD terms and converts the charge into XCN using the network's current conversion rate. See Network Fees for the latest verified snapshot, examples, and live queries.

Which RPC methods are supported?

Common wallet, transaction, contract-call, log, and subscription methods are supported. Complete parity with every Ethereum client-specific extension is not promised. Test the methods your product requires.

Why is the bridge unavailable or still processing?

Check the app maintenance state and the operation status. Source confirmation, security holds, relayer state, and destination submission are distinct phases. Do not resubmit the same transfer merely because it has not completed within an assumed time.

Where do I find current bridge fees and minimums?

Use https://app.onyx.org/api/bridge-proxy/api/v1/bridge/limits and a live fee quote. Documentation examples are not a source of truth for mutable values.

Where do I find current staking APR and TVL?

Use the Onyx App or the live staking endpoint described in the Exchange Integration Guide. Check timestamp and freshness fields before relying on the rate. Rates are variable and owner-adjustable.

Why does Markets show an asset that I cannot trade or bridge?

Metadata presence is not support. Check active execution markets, live bridge limits, and the contract registry. Only enable assets that the current app and API explicitly support.

Does the validator dashboard prove the whole network is healthy?

No single UI proves consensus, indexing, and RPC health together. Compare dashboard status, current RPC block height, explorer/mirror freshness, and your own receipts.