website

twitter

discord

github

Blockchains (L1)

Sonic

# Sonic FeeM rewards Methodology

## 1. Overview

Sonic feeM rewards represent the total daily token incentives distributed through Sonic's fee monetization program. This metric captures the value of rewards claimed by users from Sonic's GasMonetization contract, measuring the economic incentives flowing to ecosystem participants. The calculation aggregates all reward claims per day and converts them to USD for standardized reporting.

## 2. Data sources

- **Sonic blockchain events**: Parsed `RewardClaimCompleted` events from Sonic's GasMonetization contract, containing reward claim transactions with project IDs, epoch numbers, and claim amounts
- **Token price data**: End-of-day price feeds for the Sonic token (contract address `0x039e2fb66102314ce7b64ce5ce3e5183bc94ad38`) used for USD conversion
- **Token metadata**: Sonic token configuration data including decimal precision and contract information

## 3. Step-by-step calculation

### Component A: Raw feeM claim extraction
- **Purpose**: Extract and validate individual reward claim events from Sonic's GasMonetization contract
- **Logic**: Parse `RewardClaimCompleted` events from Sonic blockchain data, extracting transaction metadata including block timestamp, transaction hash, log index, and contract address. Cast event parameters including `projectId` (feeM project identifier), `epochNumber` (reward distribution period), and `amount` (reward amount in wei). Filter out removed/invalid transactions to ensure data quality.
- **Key fields**: `block_timestamp` for timing, `transaction_hash` for uniqueness, `feem_project_id` for project tracking, `feem_epoch_number` for reward period, and `amount` containing the raw reward value in wei

### Component B: Daily aggregation and token conversion
- **Purpose**: Convert wei amounts to Sonic tokens and aggregate by day
- **Logic**: Truncate block timestamps to daily boundaries using day-level granularity. Convert raw `amount` values from wei to Sonic tokens by dividing by 1e18 (18 decimal places). Group all reward claims by day, chain ID (sonic), and product ID (sonic), then sum the converted token amounts. Add static token address reference for the Sonic token used in rewards.
- **Key fields**: Daily `timestamp` boundary, `token_incentives` as the summed Sonic token amount, `token_address` pointing to Sonic's contract, `chain_id` and `product_id` for identification

### Component C: USD conversion
- **Purpose**: Convert daily Sonic token amounts to USD values
- **Logic**: Apply the `convert_to_usd_and_correct_decimals` macro to transform `token_incentives` amounts into USD. Use end-of-day price feeds for the Sonic token to determine exchange rates. Skip decimal correction since amounts are already properly formatted from the wei conversion. Join price data based on token address and timestamp to ensure accurate daily valuations.
- **Key fields**: `token_incentives` converted to USD equivalent, maintaining timestamp and identification fields

### Final aggregation
- **Combining components**: The final metric uses the USD-converted daily token incentive amounts directly, with feeM rewards being equivalent to token incentives for Sonic
- **Currency conversion**: USD conversion uses end-of-day price feeds matched to daily timestamps, ensuring consistent valuation timing
- **Time aggregation**: Data is aggregated at daily boundaries, with timestamps truncated to day precision
- **Final calculation**: The final `feem_rewards` value equals the daily sum of all RewardClaimCompleted amounts, converted from wei to Sonic tokens (divided by 1e18) and then to USD using end-of-day prices. Gap filling ensures continuous daily series with zeros for days without claims.

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

Developer rewards distributed through Sonic's FeeM program.

SonicS

Archived

FeeM rewards

FeeM rewards

Competitive landscape