website

github

twitter

Blockchains (L1)

XDC Network

# XDC Network Token incentives Methodology

## 1. Overview

Token incentives measures the total USD value of token rewards distributed to users through XDC Network's Surge Program on a daily basis. This metric tracks incentive payments made through a merkle-based distribution system, where users claim allocated token rewards from the Distributor contract. The metric provides visibility into XDC's token-based user acquisition and engagement spending, aggregating all claimed incentives by day and converting them to USD for standardized reporting.

## 2. Data sources

- **XDC blockchain events**: Parsed `Claimed` events from the Distributor contract on XDC blockchain, containing user addresses, token addresses, and claimed amounts
- **End-of-day price feeds**: Token price data used to convert claimed token amounts to USD values
- **Token metadata**: Token decimal information required for proper amount normalization and calculation accuracy

## 3. Step-by-step calculation

### Component A: Raw incentive claims extraction
- **Purpose**: Captures all token incentive claims from the XDC Network Surge Program
- **Logic**: Extracts `Claimed` events from the Distributor contract on XDC blockchain. Each event contains the claiming user's `address`, the `token` address being claimed, and the claimed `amount`. The events represent successful claims from the merkle-based distribution system where users prove their eligibility and claim allocated token rewards. All claims are deduplicated using transaction hash and log index to ensure each claim is counted only once.
- **Key fields**: `address` (claiming user), `token` (token contract address), `amount` (raw claimed amount), `block_timestamp` (claim time), `transaction_hash` and `log_index` (for deduplication)

### Component B: Daily aggregation and USD conversion
- **Purpose**: Aggregates daily incentive distributions and standardizes values in USD
- **Logic**: Groups all incentive claims by day using timestamp truncation to daily boundaries. For each day, sums all claimed token amounts across all users and tokens. Applies decimal correction to normalize token amounts according to each token's decimal places. Converts the corrected token amounts to USD using end-of-day price feeds, matching token addresses to their corresponding prices on the claim date.
- **Key fields**: `timestamp` (daily boundary), `amount` (aggregated USD value), `token_address` (for price lookup), `chain_id` (XDC identifier)

### Final aggregation
- **Combining components**: Daily aggregated claims are processed through the finalization macro which validates data integrity and ensures complete time series coverage
- **Currency conversion**: Token amounts are converted to USD using end-of-day price feeds, with decimal correction applied before conversion to ensure accurate pricing
- **Time aggregation**: All claims within each calendar day are summed to produce a single daily incentive value
- **Final calculation**: The final metric represents the total USD value of all token incentives claimed on XDC Network each day, with missing days filled with zero values to maintain complete time series data

*This methodology was automatically generated by Token Terminal's methodology analyzer.*

Value of native tokens distributed as incentives.

XDC NetworkXDC

Token incentives

Token incentives

Competitive landscape