About Onyx: A High-Performance Layer 3 Blockchain
Onyx, also referred to as the XCN Ledger, is a highly scalable Layer 3 blockchain network that is architected for performance, security, and cost efficiency. It is deployed using the Arbitrum Orbit stack and benefits from the robust security foundation of Coinbase’s Base Layer 2 blockchain. This unique architecture enables Onyx to inherit the modular scalability of Arbitrum while maintaining the security assurances provided by Base, offering an optimized environment for developers building next-generation decentralized applications (dApps).
Onyx is fully Ethereum Virtual Machine (EVM) compatible, allowing seamless deployment of smart contracts and interoperability with existing Ethereum-based applications and tooling. Developers can build and deploy decentralized finance (DeFi) protocols, payment solutions, governance frameworks, and other blockchain-based services while leveraging Onyx’s high throughput and low transaction costs.
With an institutional-grade infrastructure, Onyx is designed to support large-scale applications and enterprise adoption, ensuring high availability, robust security mechanisms, and scalability optimizations.
The Onyx Documentation Hub is the central resource for institutions and developers looking to build, integrate, and leverage the full potential of Onyx This comprehensive documentation provides in-depth technical details, architecture specifications, and implementation guidelines for developers aiming to utilize Onyx’s blockchain infrastructure efficiently.
Beyond just technical references, this hub serves as a developer-centric knowledge base, offering code samples, API references, SDK integration guides, and best practices for optimizing smart contract deployments and blockchain interactions. Whether you are designing custom dApps, implementing scalable payment systems, or integrating Onyx into multi-chain architectures, the documentation provides a structured approach to understanding transaction finality, network security, gas optimizations, and governance mechanisms within the Onyx ecosystem.
By leveraging the resources provided, institutions and developers can streamline development workflows, enhance security practices, and maximize the performance of their blockchain-based applications on Onyx.
XCN Governance
Voting and Governance Module
Onyx Blockchain Information
This section provides essential technical details regarding Onyx’s publicly available Remote Procedure Call (RPC) endpoints, allowing developers to interact with the Onyx blockchain network. These RPC endpoints facilitate smart contract deployments, transaction broadcasting, data querying, and state synchronization with the Onyx blockchain. Developers and infrastructure providers can integrate these endpoints into their applications, wallets, or blockchain indexing services to ensure seamless interaction with the Onyx network.
Onyx provides both HTTPS and WebSocket (WSS) RPC endpoints, enabling developers to connect to the network for executing transactions and retrieving blockchain state data. The WebSocket endpoint is particularly useful for applications requiring real-time event subscriptions, such as monitoring contract events or transaction confirmations. The available endpoints are:
To enhance blockchain interaction and facilitate development on Onyx, the following key resources are available:
Below are the specific network parameters for Onyx:
HTTPS RPC
https://rpc.onyx.org
Standard RPC for JSON-RPC API requests
WebSocket RPC
wss://rpc.onyx.org
Enables real-time event-driven interactions
Block Explorer
https://explorer.onyx.org
A fully-featured blockchain explorer allowing users and developers to inspect transactions, smart contracts, and network state
Cross-Chain Bridge
https://bridge.onyx.org
A dedicated bridge enabling seamless asset transfers between Onyx and other blockchain networks.
Chain ID
80888
The unique identifier for the Onyx network, required for network configuration in development environments and wallet connections.
Gas Token
XCN
The native token used for gas fees within the Onyx network, required to execute transactions and deploy smart contracts. The contract address for XCN on Onyx is: 0x9c632E6Aaa3eA73f91554f8A3cB2ED2F29605e0C.
Onyx Smart Contract Addresses
The following smart contract addresses are integral to the Onyx blockchain infrastructure. These addresses correspond to core protocol contracts and token bridge contracts, which facilitate transaction processing, cross-chain interoperability, and protocol governance. Developers building on Onyx should reference these addresses for contract interactions, cross-chain asset transfers, and network-specific implementations.
The smart contracts for Onyx on Ethereum are below:
The core smart contracts of Onyx define the network’s fundamental operations, including transaction finalization, message passing, and state synchronization.
The Token Bridge Contracts enable seamless asset transfers between Onyx and external networks. These contracts are responsible for asset locking, minting, and validation in both Layer 2 (L2) and Layer 3 (L3) environments.
XCN Unitroller
0x3fA642C0bBad64569eb8424af35F518347249216
The XCN Farming contract for Uniswap V2 XCN-WETH pool.
Onyx DAO Registry
0xf161C603Ed58E81694765fdE7095184d1c52A6BB
The Onyx DAO registry contract governs the protocol's service providers through onchain governance.
0x10e9F660ed21e662e7f3fB4a49B0Bd9B219bEf95
Handles message relays from L3 back to L2.
AdminProxy
0x615b81747e819e0dB25c13570D5DA45Ef9bc81B3
Administrative contract for protocol governance and upgradeability.
SequencerInbox
0xdA2445f1cA60bC2C739A96298746aDBB6706f011
Responsible for batching and sequencing transactions before final inclusion in the rollup state.
Bridge
0xcdf10130c75D42a3880Ae521734EaA8631aC2905
Facilitates cross-chain asset transfers between Onyx and external networks.
Utils
0x23264394923E4aEB990234180c37Bf757667C6f7
Provides auxiliary functions for the Onyx protocol.
ValidatorWalletCreator
0x2A8ccC4829c0323b470357cffDaD492C789f9315
Generates validator wallets for network security operations.
L3UpgradeExecutor
0x00177AC867e05EC9209a70be32A79157D065E6dE
Manages network upgrades and protocol-level modifications
0x3CaA4581e7bA1Af2607e0198aF4E4C208f09c98b
Directs token movements between networks.
StandardGateway
0x167D43d1D60DE2320B5E143F9c6a058092A913C2
Supports standard ERC-20 token transfers between Onyx and L2 chains.
0x0707DDF430c956A7642aD543d462752b32A04CCB
Controls upgradeability of bridge contracts.
Router
0x716f4586941Cfb4704F947CdAA2b2CB6432397ff
Directs token transactions across L3 and connected networks.
StandardGateway
0x64B59bC9Ac590AE050353A9F21875E35c48Ea4AF
Processes standard ERC-20 token bridging between L3 and other supported networks.
Governor
0xdec2f31c3984f3440540dc78ef21b1369d4ef767
The core Governance contract for Onyx.
Timelock
0x08eDF0F2AF8672029eb445742B3b4072c6158DF3
The Timelock security contract for Onyx Governance.
XCN Staking
0x23445c63FeEf8D85956dc0f19aDe87606D0e19A9
Rollup
0x50752f7988d0195d4d5fb09a1A22B8354b5A8c0b
Handles L3 rollup execution and state commitments.
Inbox
0x8635f49481A90DeD18E8D0eB374028C4b39E700F
Manages incoming messages from L2 to L3.
CustomGateway
0x5e1035ca5f4e00F37C2e33E4d7FE6611AdE76A1a
Handles L2-specific custom token bridging.
Multicall
0xb444317D808b5cFfE66495920D40A35E7D247cC4
Enables batched contract calls to optimize transactions.
CustomGateway
0x98c0C61F5Ca34F5d471a89Ac350BbaF8dd48b3FB
Manages custom asset transfers at the L3 level.
Multicall
0x07f1104a28A6D805A847Ca8ec57d1A3a9f430fCf
Allows batch execution of multiple contract calls in a single transaction.
The XCN Staking contract that determines vote weight for Onyx Governance.
Outbox
Router
ProxyAdmin