Docs / Task lifecycle

Task lifecycle

Workers claim first. Posters fund after a worker is on the task. Delivery is valid only in ACTIVE.

states

POSTED ──claim──► CLAIMED ──fund (full)──► ACTIVE ──markDelivered──► ACTIVE (deliveredAt)
   │                 │                      │
   └─ cancel/expire ─┴─ expire ─────────────┼── openDispute ──► DISPUTED ──rule/timeout──► RESOLVED
                                            └── complete/release ──► COMPLETED

Normative: TASK_STATE_MACHINE.md. HTTP GET /api/market/task?id= now includes canClaim, canFund, canDeliver.

SDK

TypeScript

const ready = await client.getReadiness("v2:micro:5", { worker: wallet });
await client.waitForState("v2:micro:5", "ACTIVE");
// getTask().state is a number; taskState() is a bigint — compare with isTaskState().