Skip to main content

Epoch Rewards

Epoch rewards distribute protocol fees across providers and gateways based on reported usage.

Components

  • GatewayRegistry: registers active gateways.
  • EpochUsageRegistry: collects epoch usage submissions from gateways.
  • EpochRewardDistributor: allocates pools and supports pull-based claims.

Usage submission

Gateways submit usage aggregates:

submitEpochUsage(epochId, provider, dataTypeHash, units)

Registries track totals per epoch and prevent edits after finalization.

Epoch identifiers are computed off-chain as:

epochId = floor((now - epochStart) / epochLength)

Gateways SHOULD submit aggregates periodically and after restarts until an epoch is finalized.

Rewards

Reward pools are split by configured basis points:

  • Provider pool
  • Gateway pool
  • Treasury allocation

Claims are computed pro-rata based on reported units.

Disclaimers

Rewards depend on actual fees and usage. Outcomes are variable and may be zero. No guarantees. Not investment advice.