# Active users (weekly) Methodology

## 1. Overview

Active users (weekly) measures the number of unique addresses that make a revenue-generating transaction with SUNSwap V2. For SUNSwap V2, this metric is represented by the unique transaction senders (traders) who execute swaps through the protocol's liquidity pools. The signing wallet address of the transaction is utilized to identify unique users, rather than intermediate router contracts. This metric is used to evaluate user adoption, engagement, and transaction activity on the decentralized exchange.

## 2. Data sources

- **Blockchain events**: `Swap` events from `Pair` contracts and transaction metadata, covering Tron

## 3. Step-by-step calculation

### Component A: Swap event extraction

- **Purpose**: Identify swap transactions executed on SUNSwap V2 liquidity pools.
- **Logic**: `Swap` events are parsed from `Pair` contracts on Tron. For each event, the transaction hash, block timestamp, and sender address are extracted.
- **Key fields**: `block_timestamp` (timing), `transaction_hash` (transaction identifier), `sender` (contract user address)

### Component B: Transaction signer resolution

- **Purpose**: Identify the actual user address that initiated the swap.
- **Logic**: Swap events are joined with native transaction metadata using the transaction hash. The transaction signer address is extracted to represent the actual user, ensuring that intermediate router contracts are not counted as active users.
- **Key fields**: `from_address` (transaction signer)

### Component C: Weekly unique aggregation

- **Purpose**: Aggregate unique users on a weekly basis.
- **Logic**: Transaction signer addresses are truncated to weekly intervals based on the block timestamp. Distinct user addresses are aggregated per 7-day window to calculate the active users (weekly) metric. Chain availability filters are applied to align the data with approved freshness boundaries.
- **Key fields**: `timestamp` (weekly truncated time), `user_address` (unique user identifier)

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

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

Active users (weekly)