website

twitter

Blockchains (L1)

Plasma

# Plasma Token holders Methodology

## 1. Overview

The plasma tokenholders metric counts the unique number of addresses holding XLP tokens across supported blockchain networks. This metric provides insight into the distribution and adoption of Plasma's native liquidity provider tokens, serving as an indicator of protocol participation and decentralization. The calculation aggregates unique token holder addresses from blockchain transaction data and token balance information.

## 2. Data sources

The calculation relies on several key data sources:
- **Token transfer events**: Parsed ERC-20 `Transfer` events from supported blockchain networks to track token movements
- **Token balance snapshots**: Daily balance snapshots showing current token holdings for addresses
- **Token contract metadata**: Information about the XLP token contract addresses and decimals across different chains  
- **Blockchain transaction data**: Raw transaction records to validate token transfers and balance changes
- **Chain availability configuration**: Internal configuration data specifying which blockchain networks are currently supported for Plasma protocol metrics

## 3. Step-by-step calculation

### Component A: Native tokenholder data extraction
- **Purpose**: Retrieves the processed tokenholder counts from the underlying plasma native tokenholders calculation
- **Logic**: Extracts timestamped tokenholder counts that have already been calculated from raw blockchain data, including the timestamp grain (daily/hourly aggregation level), chain identifier, and the actual count of unique token holders
- **Key fields**: The `timestamp` field indicates when the measurement was taken, `timestamp_grain` specifies the aggregation level, `chain` identifies the blockchain network, and `tokenholders` contains the unique address count

### Component B: Data standardization and precision handling
- **Purpose**: Ensures numerical precision and applies standard metric formatting
- **Logic**: Casts the tokenholder count to `bignumeric` data type to handle large numbers and prevent precision loss, then applies the finalization macro to add standard metadata fields and ensure consistent output structure across all Token Terminal metrics
- **Key fields**: The `tokenholders` field is converted to high-precision numeric format, and additional metadata fields are added through the finalization process

### Final aggregation
- **Combining components**: The standardized tokenholder data is filtered through chain availability rules to ensure only supported blockchain networks are included in the final output
- **Currency conversion**: Not applicable for this count-based metric
- **Time aggregation**: Data is already aggregated at the appropriate time grain (typically daily) from the underlying native tokenholders calculation
- **Final calculation**: The final metric represents the count of unique addresses holding XLP tokens on each supported chain at each timestamp, with proper metadata and formatting applied for consistency with other Token Terminal metrics

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

Unique addresses holding a non-zero balance of the project's native token.

PlasmaXPL

Token holders

Token holders

Competitive landscape