Skip to main content

EpochUsageRegistry

Purpose​

Collects aggregated usage reports per epoch from registered gateways.

Key state​

  • epochs[epochId] -> { providerUnits, gatewayUnits, finalized }
  • providerUnits[epochId][provider]
  • gatewayUnits[epochId][gateway]
  • providerDataTypeUnits[epochId][provider][dataTypeHash]

Key functions​

  • submitEpochUsage(epochId, provider, dataTypeHash, units)
  • finalizeEpoch(epochId) (owner)

Events​

  • EpochUsageSubmitted
  • EpochFinalized

Roles and permissions​

  • Only active gateways (via GatewayRegistry) can submit usage.
  • Owner finalizes epochs.

Security notes​

Epoch submissions are aggregated and assumed honest in MVP. Disputes are out of scope and planned for governance phases.