website

twitter

github

Lending

Prime Numbers

# Prime Numbers Total value locked Methodology

## 1. Overview

PrimeNumbers TVL measures the total value of assets locked in the PrimeNumbers protocol on XDC Network. This metric combines two distinct value pools: traditional lending pool deposits where users provide liquidity to earn interest, and Prime staking where users stake XDC tokens. The calculation tracks daily changes in locked value across both pools, applies decimal corrections and USD conversions, and maintains cumulative balances over time to provide a comprehensive view of protocol adoption and capital efficiency.

## 2. Data sources

- **XDC blockchain event logs**: Parsed `LendingPool_Deposit_event` and `LendingPool_Withdraw_event` logs from PrimeNumbers lending contracts capturing user deposit and withdrawal activities
- **XDC token transfer events**: Parsed `Transfer` events for the psXDC token (`0x9b8e12b0bac165b86967e771d98b520ec3f665a6`) to track staking and unstaking activities through token mints and burns
- **End-of-day token price feeds**: USD price data for converting token amounts to dollar values
- **Token metadata**: Decimal precision information for proper amount normalization across different tokens

## 3. Step-by-step calculation

### Component A: Lending pool deposit and withdrawal tracking
- **Purpose**: Captures user deposits and withdrawals from PrimeNumbers lending pools to calculate traditional lending TVL
- **Logic**: Extract deposit events from XDC blockchain logs containing reserve token address, user address, amount, and on-behalf-of recipient. Extract withdrawal events containing reserve token, user address, withdrawal amount, and destination address. Both event types include block timestamp, transaction hash, and log index for precise tracking. Filter events using incremental logic to process only recent data efficiently.
- **Key fields**: `reserve` (token address), `user` (depositor/withdrawer), `amount` (deposit/withdrawal quantity), `onBehalfOf` (beneficiary), `to` (withdrawal destination)

### Component B: Lending pool TVL calculation
- **Purpose**: Converts raw deposit/withdrawal events into daily TVL balances for each token market
- **Logic**: Combine deposit events as positive amounts and withdrawal events as negative amounts. Aggregate flows by day, chain, product, version, and token address. Calculate cumulative TVL using window function partitioned by chain, product, and token address, ordered by timestamp to maintain running balance over time.
- **Key fields**: `amount` (daily net flow), `tvl` (cumulative balance), `token_address` (market identifier)

### Component C: Prime staking mint and burn tracking  
- **Purpose**: Tracks XDC staking through psXDC token supply changes, where psXDC represents staked XDC in 1:1 ratio
- **Logic**: Identify psXDC token mints by finding transfers from null address (`0x0000000000000000000000000000000000000000`) which occur when users stake XDC. Identify psXDC token burns by finding transfers to null address which occur when users unstake XDC. Extract block timestamp, transaction hash, log index, and amount for each mint/burn event.
- **Key fields**: `token_address` (psXDC contract), `amount` (minted/burned quantity), `from_address` and `to_address` (null for mints/burns)

### Component D: Prime staking TVL calculation
- **Purpose**: Converts psXDC mint/burn events into daily staking TVL representing total XDC staked
- **Logic**: Combine psXDC mints as positive amounts and burns as negative amounts. Apply decimal correction using token metadata to normalize amounts. Aggregate flows by day, chain, and token address. Fill missing days with zero amounts to maintain continuous time series. Calculate cumulative psXDC supply using window function, which represents total XDC staked since psXDC is minted 1:1 with staked XDC.
- **Key fields**: `amount` (daily mint/burn flow), `total_supply` (cumulative psXDC supply representing staked XDC)

### Component E: TVL breakdown processing
- **Purpose**: Standardizes lending pool TVL data and calculates daily changes for aggregation
- **Logic**: Apply decimal correction to lending pool TVL using token metadata. Calculate daily delta TVL by taking difference between current day balance and previous day balance using lag window function partitioned by chain, product, and token address. Add lending pool metadata including pool address and market identifiers.
- **Key fields**: `delta_tvl` (daily TVL change), `lending_pool_address`, `lending_market_address`

### Final aggregation
- **Combining components**: Aggregate delta TVL from lending pool breakdowns by day, timestamp grain, chain, product, and token address. Calculate cumulative TVL over time using window function. Fill forward missing days using fill strategy. Union lending pool TVL data with Prime staking TVL data, where staking uses product ID `Prime Staking` and total supply as TVL amount.
- **Currency conversion**: Convert token amounts to USD by joining with end-of-day price feeds matched on timestamp, chain, and token address. Use mapped token addresses for price lookup to handle any address normalization requirements.
- **Time aggregation**: Use daily timestamp grain with timestamp truncation to day boundaries. Fill forward missing days to maintain continuous time series without gaps.
- **Final calculation**: Apply finalization macro for TVL metrics with fill zeros strategy and apply chain availability filtering. The final metric represents total USD value locked across both lending pools and staking pools in the PrimeNumbers protocol on XDC Network.

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

Total value locked (TVL)

Total value locked (TVL) — value deposited into the project's applications.

Prime NumbersPRFI

Total value locked

Total value locked

Competitive landscape

Chain breakdown