Local settlements
Cancel a local XvP settlement before execution and return locked assets to the senders.
A local XvP settlement contains only on-chain DALP asset flows. Any local participant can cancel while the settlement is still open.
Cancellation works before or after all approvals are collected. DALP closes the settlement and refunds locked local assets to the addresses that provided them.
Before you start
Use this page when the settlement type is Local.
If the settlement includes external flows, use the HTLC cancellation guide. Fully approved HTLC settlements use cancel votes instead of immediate unilateral cancellation.
You need:
- A wallet that belongs to a local participant in the settlement.
- An open settlement that has not executed, expired, or already been cancelled.
- PIN or OTP verification for the wallet confirmation.
When cancellation is available
| Settlement state | Can you cancel? | What happens |
|---|---|---|
| Pending | Yes | The settlement closes. Any locked assets are refunded to their senders. |
| Ready | Yes | The settlement closes before execution. Locked assets are refunded to their senders. |
| Executed | No | The exchange already completed. |
| Expired | No | Use Withdraw expired if you approved and need to recover locked assets. |
| Cancelled | No | The settlement is already closed. |
Local cancellation is unilateral
A local settlement does not need a vote to cancel. One local participant can cancel while the settlement remains open. The vote-based cancellation flow only applies to HTLC settlements after all local approvals are in place.
Cancellation flow
The same wallet confirmation covers the status change and the refund. The console submits the cancellation request to the settlement contract. For a local settlement, that request closes the settlement immediately and returns any locked local escrow to the sender addresses recorded on the local flows.
Example: approved assets return to the sender
A local participant can cancel after assets are approved and locked. In the contract flow below, Alice approves a 200-token local flow, the settlement holds those tokens in escrow, and Alice cancels before execution. The cancellation empties the settlement escrow, returns Alice's balance to its starting amount, and clears the settlement ledger for Alice's locked amount.
| Moment | Settlement escrow | Alice balance | Locked amount for Alice |
|---|---|---|---|
| Before approval | 0 tokens | 500 tokens | 0 tokens |
| After approval | 200 tokens | 300 tokens | 200 tokens |
| After cancellation | 0 tokens | 500 tokens | 0 tokens |
This example only applies to local flows. If the settlement contains an external flow and all local approvals are already in place, the HTLC cancellation path uses cancel votes instead.
Cancel the settlement
Open the settlement
Go to Settlements and open the local settlement you want to cancel. Check that the status is Pending or Ready.
Start cancellation
Open the Manage menu and choose Cancel settlement.
If the option is not visible, the settlement is terminal, your wallet is not a local participant, or your wallet has already cast a cancel vote where the settlement type uses voting.
Confirm in the wallet
Review the confirmation dialog, then confirm with your PIN or OTP. The platform submits a cancellation transaction for the settlement address.
Check the result
After the transaction confirms, refresh the settlement detail page or return to the settlements list.
You should see:
- Settlement status Cancelled.
- No further approve, execute, revoke, or cancel options for that settlement.
- Previously locked local assets returned to the original sender addresses.
What cancellation changes
Cancellation is final for that settlement. It does not edit the flows, reopen approvals, or create a replacement settlement.
If the parties still want to exchange assets, create a new settlement with the corrected terms.
When a local participant cancels, the settlement contract refunds escrowed local assets to the sender addresses that locked them. Assets that were never approved were never locked, so there is nothing to refund for those flows.
Troubleshooting
| Issue | What to check |
|---|---|
| Cancel settlement is not visible | Confirm the settlement is Pending or Ready and that the connected wallet is a local participant. |
| The settlement is expired | Use Withdraw expired instead of cancellation. |
| The transaction fails | The settlement may have executed, expired, or been cancelled before your transaction was mined. Refresh the settlement and check its current status. |
| You need to undo a cancellation | You cannot reactivate a cancelled settlement. Create a new settlement if the exchange should still happen. |
Next steps
Cancel
Stop an open XvP settlement and return locked assets to their original senders. Learn when the cancel endpoint cancels immediately, when it records an HTLC cancel vote, and when expired-withdrawal is the correct recovery path.
HTLC settlements
Cancel an HTLC settlement before it is armed, or coordinate the local participants who must vote when the settlement already has all local approvals.