Skip to main content

Statistics (ζΠ\zeta_\Pi)

The Statistics transition tracks network performance metrics, validator statistics, and historical data aggregation.

Purpose​

  • Performance Metrics: Track block times, work-report counts, gas usage
  • Validator Stats: Monitor validator participation and performance
  • Historical Data: Aggregate statistics over epochs for analysis

State Structure​

π ∈ Statistics

Statistics {
  blocks_produced: u64,
  work_reports_processed: u64,
  total_gas_used: u64,
  validator_performance: Map<ValidatorIndex, ValidatorStats>
}

How It Works​

Block Statistics​

stats.blocks_produced += 1
stats.total_gas_used += block.gas_used

Validator Tracking​

stats.validator_performance[block.author].blocks_authored += 1

Epoch Aggregation​

At epoch boundaries, aggregate and archive statistics for historical analysis.

References: Gray Paper Section on Statistics

Implementation: tessera/jam/state/transitions/statistics/