Skip to content

How work reaches EthereumLink to this section

TL;DRLink to this section

  • Settlement adds checked wheel-work records to Ethereum.
  • A submitted transaction still needs to succeed and pass confirmation checks before it appears as confirmed work.
  • There isn't a promised settlement time.
  • Recording work doesn't mint SQK or make rewards ready to claim.

What does settlement add?Link to this section

The device saves wheel work before any of it reaches Ethereum. Settlement takes eligible, checked rounds from that history and records them in Core, the contract that tracks settled work. The public chain view then waits for confirmations before showing the result.

These are separate steps, not an instant update from the wheel. Seeing recent activity, an accepted record, or a transaction hash doesn't mean the work has settled. Even a successful settlement doesn't by itself fund rewards: Mining and Token handle that separately.

How it worksLink to this section

The Oracle first verifies the device's records and completed round totals. The Reporter selects eligible work and signs permission to settle that exact batch. A separate relayer sends the transaction to Ethereum and pays its gas cost.

Core checks the signed batch before recording the work. Public chain views show it after deployment checks and 12 confirmations. Neither the Oracle nor the Reporter may invent missing device records to move this process forward.

Why can it take longer?Link to this section

The Reporter runs on a five-minute schedule, but that's not a settlement deadline. Outages, eligibility checks, incidents, insufficient gas, and indexing delays can all delay the public result.

The stages below help distinguish waiting for a submission from waiting for a confirmed result.

Milestone What it means What it does not mean
Accepted telemetry Oracle checks passed Work has settled or rewards are funded
Eligible closure A completed round is approved for settlement A transaction has been sent
Prepared authorization The batch has been signed and saved Ethereum has executed it
Submitted transaction The relayer sent it to Ethereum It succeeded or has enough confirmations
Successful receipt Core executed the transaction Public confirmed views already include it
Confirmed projection The result passed confirmation and deployment checks It can never be reorganized, or rewards are funded

Technical detail: settlement rulesLink to this section

Each batch names the last round it covers, called the certification frontier. It lists positive-work rounds explicitly and certifies omitted rounds within that range as zero. Core emits RoundRecorded and BatchSettled events for the settlement.

  • The Oracle checks signatures, device identity, approved counter history, record order, hardware origin, and exact round totals. Cumulative work must not decrease.
  • The Reporter uses EIP-712 to sign the batch, including the Core implementation, a one-use nonce, and a deadline.
  • If a submitted transaction's outcome is uncertain, the service checks the saved attempt rather than guessing a replacement batch.
  • A batch contains at most 16 positive-work rounds. Zero-work gaps do not count toward this limit.
  • The Reporter waits for positive work before submitting preceding zero-work rounds.
  • Retrying identical telemetry does not count it twice; the Oracle rejects conflicting duplicates.
  • A successful authorization uses up its nonce. Pausing, unpausing, or rotating the Reporter invalidates prepared signatures.
  • The Reporter stops signing if deployment, RPC, contract code, telemetry, incident, or saved transaction checks leave an unresolved outcome.
  • Indexer or API failure affects public views, not Core records, Pi counting, or Oracle receipt checks.
  • Mining and Token fund rewards; a Core BatchSettled event does not tell you how much SQK you can claim.

ExampleLink to this section

Illustrative sparse batch: round 1 closes with 4 work units, round 2 with zero, and round 3 with 6. A batch through round 3 carries positive entries for rounds 1 and 3 while certifying round 2 as zero. Core adds 10 work units but creates no token balance.

Illustrative batch: Core has settled through round 10. The Pi records zero work in rounds 11 and 12, then 5 work units in round 13.

The Reporter submits a batch through round 13 with one positive entry for that round. Core records rounds 11 and 12 as zero and adds only 5 work units.

Without a later positive-work round, the Reporter keeps the zero-work rounds waiting. They remain recorded zeros, not missing observations.