# Constant Product xShadow staked Methodology

## 1. Overview

xShadow staked measures the total USD value of xShadow assets locked within the Constant Product staking module. This metric reflects the aggregate economic value committed by users to the governance and reward-accrual mechanisms of the protocol. It serves as a key indicator of long-term alignment and capital commitment within the Constant Product ecosystem.

## 2. Data sources

- **Blockchain events**: `Deposit` and `Withdraw` events from `VoteModule` contracts on Sonic
- **External data**: End-of-day price feeds for the xShadow asset and asset metadata for decimal normalization

## 3. Step-by-step calculation

### Component A: Staking inflow tracking

- **Purpose**: Capture all new xShadow assets committed to the staking module
- **Logic**: `Deposit` events are parsed from `VoteModule` contracts to identify inflows of xShadow assets. For each event, the transaction timestamp, account address, and asset amount are extracted. These events represent the increase in the staked supply for the Constant Product protocol.
- **Key fields**: `in_amount` (staking quantity), `in_from` (user address), `block_timestamp` (timing)

### Component B: Unstaking outflow tracking

- **Purpose**: Capture all xShadow assets removed from the staking module
- **Logic**: `Withdraw` events are parsed from `VoteModule` contracts to identify outflows of xShadow assets. Amounts extracted from these events are treated as negative values to accurately reflect the reduction in the total staked balance.
- **Key fields**: `in_amount` (unstaking quantity), `in_from` (user address), `block_timestamp` (timing)

### Component C: User-level balance aggregation

- **Purpose**: Maintain an accurate record of staked balances for every unique participant
- **Logic**: All deposit and withdrawal quantities are combined and aggregated by account and day. A cumulative sum is applied to the net daily changes to determine the running balance of staked assets per user. For days where no transactions occur, the previous day's balance is filled forward to ensure a continuous time series.

### Component D: Global aggregation and USD conversion

- **Purpose**: Normalize quantities to a single USD-denominated metric
- **Logic**: Individual user balances are summed daily to calculate the total staked supply of xShadow. These totals are normalized by the decimal precision defined in the asset metadata. The resulting quantities are multiplied by end-of-day price feeds to determine the final USD value. Daily values are calculated using UTC day boundaries.

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

xShadow staked