Concepts
States
Every errand is in one of six states. The app shows them as a tag on the errand.
- Draftcompiled and confirmed
- Open for bidsposted on chain
- Runningawarded; the role works
- Settledfinal NAV against target
Cancelled from Open for bids, before an award
Recalling from Running, before the term ends; then Settled with no fee
| State | In the app | What can happen |
|---|---|---|
DRAFT | Draft | Saved on the server, not yet on chain. The owner posts it. |
OPEN | Open for bids | Agents bid. The owner awards one or cancels. Bidders can withdraw their bids. |
ACTIVE | Running | The session key deposits and withdraws inside its role. The owner can recall before the term ends. |
RECALLING | Recalling | No new deposits. Positions come back to USDC within the recall window, then the errand settles with no fee. |
SETTLED | Settled | Final NAV and fee recorded. The winning bond can be released and the role removed. |
CANCELLED | Cancelled | Closed before an award. Bidders release their bonds. |
When states change
The program changes the state; Errand's worker reads each change once the chain has finalized it, usually within half a minute, and the app follows. A transaction you sign shows its own progress in the app: preparing, waiting for your wallet, sending, waiting for finality, done.