Skip to main content

Rewards and Epochs

Epoch rewards distribute protocol fees to providers and gateways based on usage reports.

Components

  • GatewayRegistry: registers gateway operators.
  • EpochUsageRegistry: collects usage aggregates per epoch.
  • EpochRewardDistributor: splits pools and allows pull-based claims.

Flow

Notes

  • Usage reports are aggregated per epoch to avoid per-request on-chain costs.
  • Gateways MUST be registered to submit usage reports (MVP).
  • Claims are pull-based and proportional to reported units.
  • Epoch identifiers are computed off-chain as floor((now - epochStart) / epochLength).
  • Gateways SHOULD submit usage periodically during an epoch and after restarts to avoid gaps.

Disclaimers

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