website

twitter

Infrastructure

Helio

# Helio Fees Methodology

## 1. Overview

Heliopay fees measures the total daily fee revenue collected by the Heliopay protocol on Solana. This metric captures fees paid to Heliopay in both native SOL tokens and various SPL tokens, providing a comprehensive view of the protocol's fee-generating activity. The calculation identifies transfers directed to Heliopay's designated fee collection addresses and aggregates them by day, converting all amounts to USD for standardized reporting.

## 2. Data sources

- **Solana native token transfers**: Records of SOL transfers between addresses on the Solana blockchain, including transfer amounts, timestamps, transaction signers, and recipient addresses
- **Solana SPL token transfers**: Records of SPL (Solana Program Library) token transfers, capturing transfers of various tokens built on Solana with details including token addresses, transfer amounts, recipients, and transaction metadata  
- **End-of-day token price feeds**: Daily closing prices for SOL and SPL tokens used to convert fee amounts to USD values
- **Token metadata**: Information about token decimal places and other properties needed for accurate amount calculations

## 3. Step-by-step calculation

### Component A: SOL fee collection
- **Purpose**: Identifies and extracts native SOL tokens collected as fees by Heliopay
- **Logic**: Filters Solana native token transfers to identify payments made TO the Heliopay fee collection address `FudPMePeNqmnjMX19zEKDfGXpbp6HAdW6ZGprB5gYRTZ`. Excludes any transfers originating FROM this same address to avoid counting internal transfers or refunds as fee revenue. Captures the transfer `amount`, `block_timestamp`, `transaction_id`, and `transaction_signer` for each qualifying transfer. Sets the `token_address` to the native SOL token identifier and `chain` to 'solana'
- **Key fields**: `amount` (fee amount in native SOL), `block_timestamp` (when the fee was collected), `transaction_signer` (the address paying the fee), `token_address` (set to SOL's identifier)

### Component B: SPL token fee collection  
- **Purpose**: Identifies and extracts SPL tokens collected as fees by Heliopay
- **Logic**: Filters SPL token transfers to identify payments made TO the same Heliopay fee collection address `FudPMePeNqmnjMX19zEKDfGXpbp6HAdW6ZGprB5gYRTZ`. Applies the same exclusion logic to prevent counting transfers FROM the fee address as revenue. Captures the `amount`, `token_address`, `block_timestamp`, `transaction_id`, and `transaction_signer` for each qualifying SPL token transfer. Records the specific SPL token address to track fees across different token types
- **Key fields**: `amount` (fee amount in the specific SPL token), `token_address` (address of the SPL token being transferred), `block_timestamp`, `transaction_signer`

### Component C: Daily aggregation
- **Purpose**: Combines SOL and SPL fee data and aggregates by day
- **Logic**: Unions the SOL and SPL fee streams into a single dataset. Groups all fee collection records by daily timestamp boundaries using `timestamp_trunc` to the day level. Aggregates by `chain`, `token_address`, and day, summing the total `amount` of fees collected for each token on each day. This creates daily totals for each type of token collected as fees
- **Key fields**: `timestamp` (daily boundary), `chain_id` (always 'solana'), `token_address`, `fees` (summed daily amount)

### Component D: USD conversion and decimal correction
- **Purpose**: Converts all token amounts to USD values with proper decimal handling  
- **Logic**: Applies the `convert_to_usd_and_correct_decimals` macro to transform token amounts into standardized USD values. Uses end-of-day price feeds to convert each token's daily fee total to USD at that day's closing price. Corrects for each token's specific decimal places to ensure accurate amount calculations (e.g., SOL uses 9 decimals, different SPL tokens may use different decimal places)
- **Key fields**: USD-denominated fee amounts with proper decimal adjustments applied

### Final aggregation
- **Combining components**: All fee types (SOL and SPL tokens) are already combined in the daily aggregation step and converted to a common USD denomination
- **Currency conversion**: Uses end-of-day token prices to convert native token amounts to USD values, with decimal correction applied based on each token's specifications
- **Time aggregation**: Daily boundaries are established by truncating timestamps to the day level, with all fees within each 24-hour period summed together  
- **Final calculation**: The final metric value represents the total USD value of fees collected by Heliopay on each day across all token types (SOL and SPL tokens), with zero-filling applied for days with no fee activity to maintain complete time series data

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

Total value users pay to use a protocol (gross fees, user-paid fees).

Helio

Fees

Fees

Competitive landscape