website

twitter

discord

github

Blockchains (L1)

Sonic

# Sonic Token incentives Methodology

## 1. Overview

The Sonic token incentives metric measures the daily USD value of feeM (fee monetization) rewards claimed by users on the Sonic blockchain. This metric tracks how much the protocol distributes in token incentives as part of its gas monetization program, where users can claim Sonic tokens as rewards. The calculation aggregates all daily reward claims, converts them from wei to Sonic tokens, and provides the final value in USD.

## 2. Data sources

- **Blockchain events**: Parsed Sonic blockchain `RewardClaimCompleted` events emitted by the GasMonetization contract when users successfully claim feeM rewards
- **Event data**: Sonic transaction logs containing claim timestamps, project IDs, epoch numbers, and reward amounts in wei
- **External data**: End-of-day price feeds for Sonic token (contract address `0x039e2fb66102314ce7b64ce5ce3e5183bc94ad38`) and token metadata for decimal handling

## 3. Step-by-step calculation

### Component A: feeM reward claim extraction
- **Purpose**: Extract and process raw feeM reward claim events from the Sonic blockchain
- **Logic**: The calculation starts with parsed `RewardClaimCompleted` events from Sonic's GasMonetization contract. These events are emitted whenever users claim their feeM rewards. The system extracts key fields including block timestamps, transaction hashes, log indices, contract addresses, project IDs, epoch numbers, and claim amounts. All fields are safely cast to appropriate data types, with amounts stored as bignumeric to handle large wei values. The `address` field captures the contract address, `feem_project_id` identifies the specific project, `feem_epoch_number` tracks the reward epoch, and `amount` contains the raw wei value of the claimed reward.
- **Key fields**: `block_timestamp` for timing, `transaction_hash` for transaction identification, `feem_project_id` for project tracking, `feem_epoch_number` for epoch identification, and `amount` for the raw wei claim amount

### Component B: Daily aggregation and token conversion  
- **Purpose**: Aggregate daily claim amounts and convert from wei to Sonic token units
- **Logic**: The raw event data is grouped by day using timestamp truncation to daily boundaries. All claim amounts within each day are summed together to get the total daily rewards claimed. The aggregated wei amounts are then converted to Sonic token units by dividing by 1e18 (since Sonic tokens use 18 decimal places like most ERC-20 tokens). The calculation also includes standard grouping fields for chain ID (sonic), product ID (sonic), and the specific token address (`0x039e2fb66102314ce7b64ce5ce3e5183bc94ad38`) to maintain data consistency across Token Terminal's metrics framework.
- **Key fields**: `timestamp` truncated to daily boundaries, `chain_id` and `product_id` both set to 'sonic', `token_address` for the Sonic token, and `token_incentives` containing the converted token amounts

### Component C: USD conversion
- **Purpose**: Convert daily Sonic token amounts to USD values using end-of-day pricing
- **Logic**: The daily Sonic token incentive amounts are converted to USD using Token Terminal's standard currency conversion macro. This process matches the token amounts with end-of-day price feeds for the Sonic token, applying the appropriate exchange rate for each day. The conversion uses the token's contract address to ensure accurate price matching and handles any decimal adjustments needed for proper USD calculation.
- **Key fields**: All original fields plus USD-converted values for the token incentive amounts

### Final aggregation
- **Combining components**: The USD-converted incentive data flows through Token Terminal's standard metric finalization process, which validates the data schema, ensures proper field naming and typing, and applies consistency checks across the dataset.
- **Currency conversion**: USD conversion uses end-of-day price feeds matched by the Sonic token contract address (`0x039e2fb66102314ce7b64ce5ce3e5183bc94ad38`), with conversion applied to the daily aggregated token amounts
- **Time aggregation**: Data is aggregated to daily boundaries by truncating block timestamps to day level, with all claims within a 24-hour period summed together
- **Final calculation**: The final metric represents the total USD value of feeM reward claims per day on Sonic, calculated as the sum of all daily claim amounts converted from wei to Sonic tokens (divided by 1e18) and then converted to USD using end-of-day exchange rates. Missing days are filled with zero values to ensure complete time series data, and results are filtered based on chain availability configuration.

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

Value of native tokens distributed as incentives.

SonicS

Archived

Token incentives

Token incentives

Competitive landscape