> For the complete documentation index, see [llms.txt](https://docs.onyx.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.onyx.org/reference/faq.md). # FAQ and Troubleshooting ## 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](/developer-guide/network-fees.md) 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](/developer-guide/exchange-integration.md#liquid-staking-data-integration). 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](/reference/contracts.md). 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. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.onyx.org/reference/faq.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.