# Active users (weekly) Methodology

## 1. Overview

Active users (weekly) measures the number of unique addresses that make a revenue-generating transaction with SUNSwap V1. Specifically, the unique transaction senders who execute swaps on SUNSwap V1 are captured. This metric is utilized to understand user engagement and adoption of the protocol's initial version. Active users (weekly) are measured over a 7-day rolling window.

## 2. Data sources

- **Blockchain events**: `TokenPurchase` and `TrxPurchase` events from `Exchange` contracts, combined with transaction metadata on Tron

## 3. Step-by-step calculation

### Component A: SUNSwap V1 swap event extraction

- **Purpose**: Extract swap transactions and identify the participating users
- **Logic**: `TokenPurchase` and `TrxPurchase` events are parsed from `Exchange` contracts. These events are joined with transaction metadata to identify the transaction signer (the wallet address that initiated and signed the transaction) rather than the contract or router address. The transaction sender address is designated as the primary user address.
- **Key fields**: `block_timestamp` (timing), `transaction_hash` (transaction identification), `from_address` (user address)

### Component B: Weekly active user aggregation

- **Purpose**: Aggregate unique users on a weekly basis
- **Logic**: Transaction sender addresses are grouped by 7-day window using UTC boundaries. Distinct user addresses are aggregated per 7-day window to calculate the active users (weekly) metric. Chain availability filters are applied to ensure data freshness and exclude archived periods.
- **Key fields**: `timestamp` (weekly boundary), `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)