Local settlements
Learn how to cancel a local XvP settlement and return locked assets to senders. Any local participant can cancel at any time before execution.
Cancelling a local settlement stops the exchange and returns all locked assets to their original senders. For local settlements, cancellation is straightforward.
Who can cancel
Any local participant (sender or recipient in a local flow) can cancel a local settlement at any time before execution.
| Settlement state | Can cancel? |
|---|---|
| Pending (not all approved) | Yes |
| Ready (all approved) | Yes |
| Executed | No |
| Expired | No - use withdraw |
Unilateral cancellation
Unlike HTLC settlements, local settlements can be cancelled by any single participant at any time. No voting or agreement from other parties is required.
Prerequisites
- You are a local participant (sender or recipient in a local flow)
- The settlement has not been executed or expired
Steps
Open the settlement
Navigate to Settlements and find the settlement you want to cancel.
Cancel the settlement
Click Cancel on the settlement detail page.
Review the confirmation and click Confirm. Authenticate with your PIN or OTP.
Verify cancellation
After the transaction confirms:
- Settlement status changes to Cancelled
- All locked assets are returned to their original senders
- The settlement cannot be reactivated
What happens after cancellation
- All escrowed assets are returned to their original sender addresses
- The settlement permanently enters Cancelled state
- No further actions can be taken on this settlement
Troubleshooting
| Issue | Solution |
|---|---|
| Cancel button not visible | You must be a local participant (sender or recipient in a local flow) |
| Cancel button disabled | Settlement may be already cancelled or executed |
| Transaction fails | Check if settlement was executed or cancelled by another party |
Alternative: Withdraw from expired
If the settlement expired (cutoff date passed), use Withdraw expired instead.
Next steps
HTLC settlements
Learn how to cancel an HTLC settlement. Before arming, any participant can cancel. After arming, all local participants must vote to cancel unanimously.
Withdraw expired
Learn how to recover your assets from an expired XvP settlement. When the cutoff date passes without execution, original senders can withdraw their locked assets.