# Onyx Documentation ## Onyx Docs - [Welcome to Onyx](https://docs.onyx.org/readme.md): Current user and developer documentation for Onyx Mainnet. - [About Onyx](https://docs.onyx.org/readme/about-onyx.md): What Onyx Mainnet is and how its public interfaces fit together. - [Chain Info](https://docs.onyx.org/readme/chain-info.md): Verified Onyx Mainnet and Testnet connection details. - [Quick Start](https://docs.onyx.org/readme/quick-start.md): Add Onyx Mainnet to a wallet and make a safe first transaction. - [About XCN](https://docs.onyx.org/onyxcoin/about-xcn.md) - [Token Supply](https://docs.onyx.org/onyxcoin/token-supply.md) - [Token Distribution](https://docs.onyx.org/onyxcoin/token-distribution.md) - [Utility and Governance](https://docs.onyx.org/onyxcoin/utility-and-governance.md) - [MiCA Whitepaper](https://docs.onyx.org/onyxcoin/mica-whitepaper.md) - [Getting Started](https://docs.onyx.org/developer-guide/getting-started.md): Connect EVM tooling to Onyx Mainnet safely. - [Exchange Integration Guide](https://docs.onyx.org/developer-guide/exchange-integration.md): Current integration guide for exchanges, custodians, and wallet backends. - [XCN Decimal Handling](https://docs.onyx.org/developer-guide/decimal-handling.md): Correctly convert native XCN between ledger and JSON-RPC units. - [Lazy Account Creation](https://docs.onyx.org/developer-guide/lazy-create-gas.md): Estimate gas correctly when a transfer creates its destination account. - [Deploying Contracts](https://docs.onyx.org/developer-guide/deploying-contracts.md): Deploy and verify Solidity contracts on Onyx Mainnet. - [Bridge Integration](https://docs.onyx.org/developer-guide/bridge.md): Integrate the Onyx bridge without hardcoding mutable limits or operator addresses. - [REST API Reference](https://docs.onyx.org/developer-guide/bridge/api-reference.md): Public bridge REST endpoints and dynamic discovery rules. - [Smart Account Integration](https://docs.onyx.org/developer-guide/bridge/smart-account-integration.md): ERC-1271 and ERC-4337 requirements for native-XCN bridge intents. - [Network Architecture](https://docs.onyx.org/developer-guide/overview.md): High-level deployed architecture of Onyx Mainnet. - [Onyx App](https://docs.onyx.org/onyx-defi/onyx-app.md): Mainnet entry point for Onyx swap, bridge, staking, farming, and migration. - [Swap and Markets](https://docs.onyx.org/onyx-defi/onyx-app/markets.md): Trade on Onyx Mainnet swap markets. - [Bridge](https://docs.onyx.org/onyx-defi/onyx-app/bridge.md): Use the Mainnet bridge and interpret its live status correctly. - [Staking and stXCN](https://docs.onyx.org/onyx-defi/onyx-app/staking.md): Stake XCN on Onyx Mainnet and understand stXCN rewards and risks. - [Farming](https://docs.onyx.org/onyx-defi/onyx-app/farming.md): Add XCN/USDC liquidity and farm XCN rewards on Onyx. - [Migrate to Onyx](https://docs.onyx.org/onyx-defi/onyx-app/migrate.md): Move legacy Ethereum-staked XCN to Onyx with optional auto-staking. - [Testnet DeFi and Slingshot](https://docs.onyx.org/onyx-defi/testnet-defi.md): Short guide to the Onyx Testnet Slingshot interface. - [Swap](https://docs.onyx.org/onyx-defi/testnet-defi/swap.md) - [Bridge](https://docs.onyx.org/onyx-defi/testnet-defi/bridge.md) - [Migrate](https://docs.onyx.org/onyx-defi/testnet-defi/migrate.md) - [Yield](https://docs.onyx.org/onyx-defi/testnet-defi/yield.md) - [Rewards Overview](https://docs.onyx.org/rewards/overview.md): Distinguish Onyx liquid staking, protocol staking rewards, and validator rewards. - [Liquid Staking Rewards](https://docs.onyx.org/rewards/staking-rewards.md): How Onyx Mainnet liquid staking rewards are represented. - [Validator Rewards](https://docs.onyx.org/rewards/validator-rewards.md): High-level description of rewards for Onyx node operators. - [Running a Validator](https://docs.onyx.org/rewards/running-a-validator.md): Current public boundary for joining Onyx Mainnet as a validator. - [Validator Dashboard](https://docs.onyx.org/rewards/validator-dashboard.md): Public Onyx validator status dashboard. - [Overview](https://docs.onyx.org/governance/quickstart.md): Onyx Governance is controlled by the Onyx DAO through decentralized smart contracts and voted by XCN Stakers. - [Security](https://docs.onyx.org/governance/security.md): Governance Security and Stability Mechanisms - [Onyx Points](https://docs.onyx.org/points/onyx-points.md) - [Earning Points](https://docs.onyx.org/points/earning-points.md) - [Whitelisted Assets](https://docs.onyx.org/points/whitelisted-assets.md) - [AI Agent](https://docs.onyx.org/onyx-ai/ai-agent.md): Summary of the Onyx AI Agent deployed for users of XCN Ledger. - [Core Features](https://docs.onyx.org/onyx-ai/core-features.md): Onyx AI Core Blockchain Features - [Wallet Infrastructure](https://docs.onyx.org/onyx-ai/wallet-infrastructure.md): Onyx AI Agent's Blockchain Wallet Infrastructure - [EVM JSON-RPC](https://docs.onyx.org/apis/evm-json-rpc.md): Supported EVM JSON-RPC usage on Onyx Mainnet. - [XCN Token](https://docs.onyx.org/tokenomics/xcn-token.md): XCN on Ethereum and as the native coin of Onyx Mainnet. - [Smart Contract Addresses](https://docs.onyx.org/reference/contracts.md): Live-verified smart contract addresses for Onyx Mainnet and Ethereum counterparts. - [FAQ and Troubleshooting](https://docs.onyx.org/reference/faq.md): Current Onyx limitations and troubleshooting guidance. - [Terms of Service](https://docs.onyx.org/reference/terms.md): Onyx DApp Terms of Service - [Bug Bounty](https://docs.onyx.org/reference/bug-bounty.md): The Onyx Bug Bounty Program is designed for a community-centric problem-solving approach for the Onyx smart contracts. --- # 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, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on a page URL with the `ask` query parameter: ``` GET https://docs.onyx.org/readme.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.