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.
# 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 opensFindings 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.