# Onyx Points

## Summary

Onyx Points is a user-centric rewards mechanism integrated into the Onyx XCN Ledger, specifically engineered to incentivize liquidity provision and active engagement within the broader Onyx blockchain infrastructure. This program is designed to reinforce ecosystem stability, promote organic asset utilization, and position Onyx as a premier protocol hub for institutional blockchain and bank applications, decentralized finance practitioners, capital allocators, and yield-maximizing participants.<br>

Participants can accrue Onyx Points by holding and transacting with approved (whitelisted) digital assets across a curated selection of decentralized applications (dApps) that will be available by Season Two within the Onyx ecosystem. These interactions are tracked and quantified through an on-chain metric system that reflects real economic activity and protocol contribution. Onyx Points serve as non-transferable, reward-bearing credentials to the associated wallet addresses connected to the system.

### Seasons

The distribution of Onyx Points is decentralised and organized into discrete epochs known as “Seasons.” Each Season is finite and governed by predefined block height parameters to ensure deterministic issuance and prevent inflationary supply shocks. Points earned are tokenized in the form of NFT-based positions, enabling composability, future utility layering, and provable ownership while also enhancing the gamification layer of user engagement.

**Season One** of the **Onyx Points Program** commenced with the protocol’s initial deployment at Onyx XCN Ledger mainnet block height **#8305000,** marking the official launch of the incentives framework. This inaugural Season will run through **August 2025 (Adjusted from September 2025 following OIP-61)**, culminating in a retroactive allocation of Onyx Points to eligible participants based on their cumulative on-chain activity since the program’s genesis block. This retroactive model ensures that early adopters and contributors are equitably rewarded for their foundational support of the Onyx protocol.&#x20;

**Season Two** of the **Onyx Points Program** officially launched in **August 2025**, introducing a refreshed incentive structure designed to further reward community engagement. A total of 10 million Onyx Points are distributed daily, split evenly between two key groups of contributors: **XCN Stakers** and **XCN Ledger** participants. Each group receives **5 million points per day,** with rewards allocated proportionally based on individual participation levels within that group. This balanced approach ensures that both stakers and ledger participants are recognized and rewarded fairly.\
**Goliath** introduces a core upgrade to the Onyx Points Program by migrating point calculation from the Onyx XCN Ledger to Goliath. This enables real-time, on-chain scoring with higher throughput and greater precision in tracking user activity. Goliath now serves as the dedicated computation layer for all point accrual, while the Onyx XCN Ledger remains the settlement and identity layer. This separation improves scalability, reduces latency, and removes reliance on delayed indexing systems.\
**Key Updates:**\
Goliath-Native Scoring\
All points are calculated directly on Goliath at execution time.\
Broader Activity Coverage\
Supports complex interactions\
Cross-Chain Attribution\
Activity bridged from external networks is tracked and scored uniformly\
Lower Latency\
Near real-time point visibility for participants\
Emissions\
Goliath introduces a dynamic emission model, adjusting daily distribution based on overall activity to maintain sustainability.\
Continuity - Points from previous Season remain valid, with balances seamlessly carried forward into the Goliath-based system.

Goliath introduces a core upgrade to the Onyx Points Program by migrating the XCN Ledger segment of points allocation to the Onyx Layer 1. Points are now calculated directly on the Onyx Layer 1, enabling real-time, on-chain scoring with higher throughput and greater precision in tracking user activity across the ecosystem. This upgrade improves scalability, reduces latency, and removes reliance on delayed indexing systems.


---

# Agent Instructions: 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:

```
GET https://docs.onyx.org/points/onyx-points.md?ask=<question>
```

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.
