Skip to main content

Query Receipt

Query receipts are signed audit records produced by gateways. They record what was served and how it was priced.

Structure (v1)​

  • kind: olymp.query_receipt.v1
  • requestId: request correlation id
  • gateway: { address, name? }
  • consumer: { address }
  • pricing: { asset, units, amount, pricingModel }
  • settlement: { mode, txHash, epochId, usageId }
  • served: { anchorId, provider, scoreBlock, trustTier }
  • timestamps: { requestedAt, servedAt }
  • signature: EIP-712 signature by gateway operator

Settlement modes​

  • ONCHAIN_PER_CALL: settlement is done per request on-chain.
  • EPOCH_BATCHED: settlement is done per epoch (scalable).

For EPOCH_BATCHED, usageId identifies the epoch-level settlement entry. Multiple receipts may share the same usageId.

Signature rules​

Gateways MUST sign receipts using EIP-712 typed data. Receipts are integrity artifacts and do not imply outcomes.

Disclaimers​

Receipts are audit records only. Fees and distributions may be zero. No guarantees. Not investment advice.