Skip to content

Checkpoints and pending rewardsLink to this section

TL;DRLink to this section

  • A checkpoint processes settled work for rewards and applies scheduled mining-power changes.
  • You don't have to call one yourself to own a Miner or claim rewards that are already ready.
  • Anyone can call one, but the caller pays a network fee without a separate reward, and one call may not clear a backlog.

Why aren't all recorded rewards ready yet?Link to this section

Work settled on Ethereum still needs to be processed for rewards. A checkpoint is the transaction that does this: it processes settled rounds, calculates any new SQK, and applies mining-power changes when they're due. Until that happens, a work total can be ahead of the rewards ready to claim.

New power also has to wait for its scheduled round and for earlier rounds to be processed. Reaching that round on the clock doesn't by itself activate a newly minted Miner's power or a merge's increase. The checkpoint preserves the order, so new power can't earn rewards from before it was eligible.

Do you need to call a checkpoint?Link to this section

Not as a routine step for every owner. A checkpoint advances shared accounting, so its progress applies to eligible Miners regardless of who submits it. You don't need a separate call for each NFT, and a claim can pay already-funded rewards without running one.

Anyone may submit a checkpoint, including someone who owns no Miner. It requires no SQK spending approval, but the caller pays the Ethereum network fee and receives no separate payment for helping the system progress. Before choosing to call one, check whether progress is available and compare it with the estimated fee.

Looking up a reward balance doesn't run a checkpoint. Minting, merging, and claiming don't process a backlog either. Developers integrating an optional call should use the checkpoint procedure.

What can one call change?Link to this section

Each call processes a limited amount of settled work and scheduled activations. A large backlog can take several calls, and a processing limit can stop a call before a power change is applied. Later successful calls continue from the recorded progress rather than starting over.

A successful checkpoint can fund SQK, activate power, advance through rounds that pay nothing, or combine these outcomes. It doesn't pay NFT owners directly. You still need to claim separately to move ready SQK to your wallet.

Why might it create no SQK?Link to this section

Progress isn't a promise of payment. There may be no completed Squeek block, no eligible active mining power, a reward rate that has fallen to zero, or no remaining supply capacity. Processing empty rounds or applying an activation can also advance the system without creating tokens.

Rounds that pay zero are still processed once; their rewards aren't reserved for future Miners. Paying for another checkpoint can't recover them or increase the reward for the same work. How rewards work explains the pool and eligibility rules.

What happens during a pause or failure?Link to this section

A pause in Core, the settled-work contract, blocks checkpoints. That alone doesn't block claims of rewards already funded. If a required read, mint, or accounting check fails, the whole checkpoint is undone, while work already settled on Ethereum remains recorded.

A failed transaction can still cost a network fee. After a successful call, check the resulting progress rather than assuming the backlog is empty or a particular Miner has activated. Exact status fields, errors, and transaction checks stay in the Mining reference.