# Active users (monthly) Methodology

## 1. Overview

Active users (monthly) is defined as the number of unique addresses that execute a revenue-generating transaction with SUNSwap V3. Unique transaction signers interacting with SUNSwap V3 liquidity pools are tracked over a 30-day rolling window. This metric is utilized to evaluate user adoption, protocol engagement, and overall economic activity.

## 2. Data sources

- **Blockchain events**: `Swap` events from `Pool` contracts and transaction data, covering Tron

## 3. Step-by-step calculation

### Component A: SUNSwap V3 trade event extraction

- **Purpose**: Extract swap transactions and identify the transaction signers for SUNSwap V3.
- **Logic**: `Swap` events from `Pool` contracts on Tron are parsed to identify swap transactions. These events are joined with native transaction data using the transaction hash to extract the transaction signer address, representing the wallet that initiated and signed the transaction rather than the router or contract user address. The block timestamp, transaction hash, and user address are retained for each swap.
- **Key fields**: `block_timestamp` (timing), `transaction_hash` (transaction identifier), `user_address` (transaction signer address)

### Component B: Monthly active user aggregation

- **Purpose**: Aggregate unique transaction signers on a monthly basis.
- **Logic**: Transaction timestamps are truncated to monthly granularity using UTC month boundaries. Unique user addresses are aggregated per 30-day window to determine the active users (monthly). The user type is classified as a trader.
- **Key fields**: `timestamp` (monthly truncated time), `user_address` (unique signer address)

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

Unique revenue-generating users over a rolling 30-day window.

Active users (monthly)