# Active users (weekly) Methodology

## 1. Overview

Active users (weekly) is defined as the number of unique addresses that make a revenue-generating transaction with a project over a 7-day rolling window. For SUNSwap V4, this metric is calculated by identifying unique transaction signers who interact with the protocol's liquidity pools. Intermediary router contracts are excluded from the user count to ensure only organic end-users are represented. This metric is utilized to assess user engagement, adoption trends, and transactional activity on the protocol.

## 2. Data sources

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

## 3. Step-by-step calculation

### Component A: SUNSwap V4 swap transaction extraction

- **Purpose**: The identification of swap transactions executed on SUNSwap V4 and the extraction of the associated transaction signers.
- **Logic**: `Swap` events from `PoolManager` contracts are parsed to identify swap activity. These events are joined with native transaction data on the Tron blockchain using the transaction hash. The transaction signer address (the wallet that initiated and signed the transaction) is extracted from the transaction data, while the swap timestamp is captured from the block header.
- **Key fields**: `timestamp` (timing), `transaction_hash` (transaction identifier), `user_address` (user address)

### Component B: Weekly active user aggregation

- **Purpose**: The calculation of the weekly count of unique active users for SUNSwap V4.
- **Logic**: The extracted transaction signer addresses are truncated to weekly intervals based on the block timestamp. Duplicate addresses are removed within each 7-day rolling window to isolate unique active users. The final metric is calculated by counting the distinct transaction signers per 7-day window for SUNSwap V4.
- **Key fields**: `timestamp` (weekly truncated time), `user_address` (unique transaction signer)

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

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

Active users (weekly)