arrow-left

All pages
gitbookPowered by GitBook
1 of 4

Loading...

Loading...

Loading...

Loading...

About Onyx

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.

Introduction

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.

hashtag
Quick Start Below:

Onyx

Comphrensive Developer Docs

XCN Staking

Ethereum-based XCN Staking

XCN Governance

Voting and Governance Module

Chain Info

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.

hashtag
Public RPC Endpoints

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:

Type
Url
Notes

hashtag
Additional Network Resources

To enhance blockchain interaction and facilitate development on Onyx, the following key resources are available:

Resource
URL
Notes

hashtag
Network Parameters

Below are the specific network parameters for Onyx:

Type
Value
Notes

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.

Smart Contracts

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.

hashtag
Layer 1 Governance & Staking

The smart contracts for Onyx on Ethereum are below:

Name
Address
Details

hashtag
Layer 3 Core Protocol Contracts

The core smart contracts of Onyx define the network’s fundamental operations, including transaction finalization, message passing, and state synchronization.

Name
Address
Details

hashtag
Token Bridge Contracts

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.

hashtag
L2 Token Bridge Contracts:

Name
Address
Details

hashtag
L3 Token Bridge Contracts

Name
Address
Details

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