Before any money moves
Creating an order reserves part of the Maker’s ad. If the Bridger never funds it, the reservation is released after ~30 minutes. Nothing happened on-chain, so there’s nothing to refund.A locked trade that didn’t settle
1
Start the cancel
After the deadline, anyone can start a cancel on the ad chain
(
claimCancel). The trade shows Cancellation claimed and the
cancel window opens.2
The cancel window
During the window, a co-signed payout or a proof that the trade
settled still ends it as settled. Either party can also file a
dispute.
3
Finish the cancel
After the window, anyone can finish it (
finalizeCancel). The Maker’s
lock returns to the ad, and a cancel leaf is recorded in the ad
chain’s Merkle Mountain Range.4
Refund the deposit
On the order chain, the refund (
refundByCancel) proves that cancel
leaf and returns the Bridger’s full deposit. The trade shows Refund
on its way, then Cancelled.An order the Maker never locked
If the Bridger funded the order but the Maker never locked, there’s no lock to release. After the deadline, anyone can cancel the order on the ad chain (cancelNeverLocked) by proving the Bridger’s deposit. That records
a cancel leaf, and the Bridger is refunded on the order chain the same way
as above.
The same route refunds an order whose fee changed
between the deposit and the lock.
Who sends these transactions
All of these calls are permissionless. The relayer normally sends them, so you don’t have to do anything. If you’d rather not wait, the trade page has a button for each step that applies (Claim cancel, Finalize cancel, Cancel never-locked order, Refund the deposit), and the relayer serves the data and proofs each one needs.A payout that couldn’t be delivered
If a payout can’t be pushed to a recipient (for example, a token transfer fails), the amount isn’t lost and the trade still ends. It’s credited to the recipient as a claimable balance, which they withdraw withclaim.
Claiming is never blocked by a pause.
One side settled, the other didn’t
If one side’s payout landed but the other’s didn’t, the missing side can be completed by proving the settled one (presentSettled). The trade page
offers Record the settled leg and Settle the other leg for this.