Disputes
If a dispute is raised, follow these steps.
- Review order context and timestamps.
- Submit supporting evidence in-app.
- Follow settlement updates and resulting order state transitions.
Disputes are settled on-chain by the order's Circle Admin (or a capability-holder authorized for that Circle), who assigns user or merchant fault. Dispute windows govern when a dispute can be raised.
The windows are enforced on-chain by order type. For a buy order, the user can raise a dispute from 15 minutes after the order was placed up to 24 hours after it was placed. A buy dispute additionally requires the order to be in a cancelled state with a recorded paid timestamp. For a sell or pay order, the window runs from 30 minutes after placement up to 7 days after placement. Attempts outside these bounds revert.
| Order type | Earliest a dispute can open | Latest a dispute can open |
|---|---|---|
| Buy | 15 minutes after placement | 24 hours after placement |
| Sell or pay | 30 minutes after placement | 7 days after placement |
Jury-based escalation tiers and governance-vote finality for disputes are planned for a future release.