Skip to content

Job lifecycle

Every state a job and a case move through, and who acts at each step.

A job moves through six states. Work can only be paid once the job is funded and open.

Job states#

Draft
The hook team writes the objective and the scenarios it cares about.
Scoped
Scope, snapshot and acceptance rules are agreed and approved by the team.
Funded
The sponsor funds the budget. Paid work cannot open before this.
Open
Operators can run the job. Accepted cases draw from the budget.
Closed
The job stops taking new results, at its end date or when the budget is used.
Settled
All verdicts are final and every payout step has completed.

Case states#

Proposed
The agent suggested the case for a callback in scope.
Ran locally
The runner executed it against the snapshot on the operator's machine.
Submitted
The operator sent the case and its result to the verifier.
Verified
The verifier gave a verdict: accepted, duplicate, or failed verification.
Payout step
An accepted case from an eligible operator is paid the posted reward.

What a job defines#

Every job states the same fields, so operators can compare them. The format is a preview and may change.

yamlPreview format
# Job definition (preview format, subject to change)
job: demo-dynamic-fee-withdrawal
network: robinhood-chain
snapshot: demo-snap-4812330
hook:
  name: DynamicFeeHook
  callbacks: [beforeSwap, afterRemoveLiquidity]
objective: >
  Show whether a liquidity provider can withdraw at a fee
  different from the one the hook declared for that block.
pays_for: [findings, coverage]
acceptance:
  - reproduces on the snapshot with no extra state
  - asserts a concrete balance or fee outcome
  - not a duplicate of an accepted fingerprint
  - no wall-clock time, randomness or network access
reward:
  per_accepted_case: set by sponsor
  budget: funded before the job opens

Findings and coverage#

A job says what it pays for. Findings jobs pay for cases that show a concrete problem. Coverage jobs pay for new, reproducible paths through the hook, even when nothing breaks. Some jobs pay for both. See the demo coverage job.