Atoms and lifecycle
The five Atom states, every allowed transition, and the deadline rules that decide who can act and when.
Every Commercial Atom follows a fixed state machine. This page lists the states, the transitions between them, and the timing rules. Only the transitions shown here exist.
Implementation candidate
States and outcomes
An Atom is in exactly one of five coarse states.
| State | Meaning |
|---|---|
PENDING_ACCEPTANCE | Funds are escrowed. The Seller has not yet accepted the terms |
PENDING_REACCEPTANCE | The Seller proposed a revision. The Buyer has not yet accepted it |
ACTIVE | Both sides agreed. The work is running or waiting to be confirmed |
DISPUTED | A root opened a dispute. A case is in progress |
FINALIZED | The Atom has a terminal outcome. Nothing can change it |
CANCELLED and EXPIRED are outcomes, not extra states. FINALIZED is absorbing: once an Atom reaches it, no transition leaves it.
The terminal outcomes are:
| Outcome | Seller share | When it happens |
|---|---|---|
RELEASE | 10,000 BPS (all) | Buyer confirms, or the challenge window ends with no dispute, or a dispute resolves for the Seller |
REFUND | 0 BPS | A dispute resolves for the Buyer |
SPLIT | 1 to 9,999 BPS | A dispute resolves with a shared result |
CANCELLED | 0 BPS | A root cancels while the Atom is pending |
EXPIRED | 0 BPS | A pending deadline passes |
A basis point (BPS) is one hundredth of a percent, so 10,000 BPS is 100%.
Transitions
| From | Trigger | To |
|---|---|---|
PENDING_ACCEPTANCE | Seller accepts | ACTIVE |
PENDING_ACCEPTANCE | Seller proposes a revision | PENDING_REACCEPTANCE |
PENDING_ACCEPTANCE | Either root cancels before the deadline | FINALIZED (CANCELLED) |
PENDING_ACCEPTANCE | Anyone calls the timeout at the deadline | FINALIZED (EXPIRED) |
PENDING_REACCEPTANCE | Buyer accepts the revision | ACTIVE |
PENDING_REACCEPTANCE | Either root cancels before the deadline | FINALIZED (CANCELLED) |
PENDING_REACCEPTANCE | Anyone calls the timeout at the deadline | FINALIZED (EXPIRED) |
ACTIVE | Valid Buyer completion | FINALIZED (RELEASE) |
ACTIVE | Anyone calls the challenge timeout | FINALIZED (RELEASE) |
ACTIVE | A root opens a dispute (only if the Atom allows it) | DISPUTED |
DISPUTED | Eligible agreement or award | FINALIZED (RELEASE, REFUND or SPLIT) |
An Atom starts in PENDING_ACCEPTANCE when the Seller must accept on-chain. If the Atom is created with no acceptance step, the Seller signs at creation and the Atom starts in ACTIVE.
Timing rules
All timing uses the block timestamp. Time alone never moves an Atom: a timeout only becomes callable, and someone must send a transaction.
- Pending deadline. The acceptance deadline is the creation time plus the acceptance window. Actions are allowed while
nowis before the deadline. At the deadline, the permissionless timeout takes over. - Revision. A revision can change only the completion mode, the execution duration and the challenge window. It must keep a positive challenge window. The Buyer then has a reacceptance window that never extends past the proposal deadline.
- Active deadlines. After activation,
executionDeadlineis the activation time plus the execution duration.challengeDeadlineis the execution deadline plus the challenge window. The challenge window must be positive. The execution duration may be zero.
The Buyer can confirm completion at any time before challengeDeadline, including before the execution deadline.
| Completion mode | Root Buyer can confirm | Buyer delegate can confirm | Challenge timeout releases |
|---|---|---|---|
ROOT_ONLY | Yes | No | Yes |
ROOT_OR_DELEGATE | Yes | Yes, with a matching session action | Yes |
TIMEOUT_ONLY | No | No | Yes |
An action uses "before T" and its paired timeout uses "at or after T", so exactly one of them owns each moment. When two valid transactions compete, such as a completion and a dispute opening, the first one included on chain wins. A signature or mempool arrival reserves nothing.
Disputes
A dispute is possible only if the Atom was created with the EITHER_ROOT dispute preset. With the DISABLED preset, no dispute can ever open and the Atom exits through completion or the challenge timeout.
Either root, and only a root, can open a dispute in the window from executionDeadline up to but not including challengeDeadline. Opening starts a procedure. It does not choose a payout and does not move funds.
A case has two live phases:
- Negotiation. Starts when the dispute opens and lasts for the Atom's negotiation window.
- Arbitration. Anyone can advance the case here once negotiation ends. Arbitration has no end time.
The ways out of a dispute depend on the time:
| Period | Buyer and Seller agree | Sinera approval plus one root | Independent award |
|---|---|---|---|
| During negotiation | Available | Available | Not available |
| After negotiation, first 14 days | Available | Closed | Not available |
| After those 14 days | Available | Closed | Available |
A dispute never times out into a payout. If neither side agrees and no award is signed, funds stay in escrow. See Fees and settlement for what each route costs and Security model for who signs an award.