twitter

etherscan

website

Blockchains (L2)

Unichain

# Unichain Token incentives Methodology

## 1. Overview

The Unichain token incentives metric measures the daily USD value of token rewards distributed through incentive campaigns created via the Angle protocol's Uniswap v4 Merkl router oracle. This metric tracks incentive programs designed to encourage liquidity provision and trading activity on Unichain by capturing campaign creation events and distributing the total campaign budgets evenly across campaign durations to create a daily time series of incentive expenditure.

## 2. Data sources

- **Blockchain events**: Parsed `CampaignCreated` events from the Angle protocol's Uniswap v4 Merkl router oracle contract on Ethereum
- **Campaign data**: Event logs containing campaign parameters including reward token addresses, total budget amounts, start timestamps, and duration periods
- **External data**: End-of-day token price feeds for USD conversion and token metadata for decimal correction
- **Transaction data**: Ethereum transaction records containing the campaign creation events with block timestamps and transaction hashes

## 3. Step-by-step calculation

### Component A: Campaign extraction and processing
- **Purpose**: Extract and normalize campaign creation data from blockchain events
- **Logic**: Capture `CampaignCreated` events from the Angle protocol's Merkl router oracle contract on Ethereum. Extract the reward token address from the `rewardToken` field, total campaign budget from the `amount` field, campaign duration from the `duration` field, and start time from the `startTimestamp` field. Convert Unix timestamps to proper timestamp formats and calculate campaign end dates by adding duration to start timestamp. Calculate campaign duration in days by dividing the duration seconds by 86400.
- **Key fields**: `rewardToken` for token address, `amount` for total budget, `startTimestamp` for campaign start, `duration` for campaign length, `transaction_hash` for unique identification

### Component B: Daily amount distribution
- **Purpose**: Convert lump-sum campaign budgets into daily incentive amounts distributed across campaign duration
- **Logic**: Calculate daily incentive amount by dividing the total campaign budget by the campaign duration in days. Generate a continuous date series spanning from campaign start date to campaign end date using date array generation. Assign the calculated daily amount to each day within the campaign period, creating individual daily records for each campaign day.
- **Key fields**: `daily_amount` calculated as total budget divided by duration days, `timestamp` for each day in the campaign period, `campaign_start_date` and `campaign_end_date` for time boundaries

### Component C: Daily aggregation
- **Purpose**: Combine incentive amounts from all active campaigns for each day
- **Logic**: Group daily records by timestamp, token address, and chain identifier. Sum all `daily_amount` values for each combination to handle cases where multiple campaigns for the same token are running simultaneously. Filter to exclude future dates by ensuring timestamps are less than the current timestamp.
- **Key fields**: Aggregated `token_incentives` as sum of daily amounts, grouped by `timestamp`, `token_address`, and `chain_id`

### Final aggregation
- **Combining components**: Daily incentive amounts from all campaigns are summed by date and token to create total daily incentive values
- **Currency conversion**: Token amounts are converted to USD using end-of-day price feeds with automatic decimal correction based on token metadata
- **Time aggregation**: Data is aggregated to daily boundaries with timestamp truncation to day level
- **Final calculation**: The final metric represents the total USD value of token incentives distributed daily across all active campaigns on Unichain, with zero-filling applied to maintain consistent time series for dates with no active campaigns

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

Value of native tokens distributed as incentives.

UnichainUNI

Token incentives

Token incentives

Competitive landscape

Chain breakdown