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.
When a settlement's cutoff date passes without execution, the settlement expires. Original senders can then withdraw their locked assets from the settlement contract.
When you can withdraw
Withdrawal is available when:
- The settlement has reached its cutoff date
- The settlement was not executed before expiration
- You are an original sender who approved and locked assets
Who receives vs who triggers
When withdrawal is triggered, only the original senders receive their locked assets back. Recipients receive nothing since no transfer occurred. However, anyone can trigger the withdrawal transaction - there are no caller restrictions. All refunds happen in a single atomic transaction.
Prerequisites
- The settlement is in Expired state
- The settlement has not been cancelled
- The withdrawal has not already been executed (one-time operation)
Steps
Find expired settlements
Navigate to Settlements and filter by Expired status.
Settlements that have passed their cutoff date without execution will appear here.
Verify expiration
Open the settlement detail page and confirm:
- Status shows Expired
- The cutoff date has passed
- You have locked assets in the settlement
Withdraw your assets
Click Withdraw on the settlement detail page.
Review the confirmation showing:
- The assets being returned
- The amounts you locked
- Your wallet address
Click Confirm and authenticate with your PIN or OTP.
Verify withdrawal
After the transaction confirms:
- All locked assets are returned to their original senders in a single transaction
- The settlement shows the withdrawal is complete
- This withdrawal can only occur once for the entire settlement
What happens during withdrawal
- Single transaction refunds everyone: All locked assets are transferred from the settlement contract back to their original senders atomically
- Anyone can trigger: Any address can call the withdrawal function - there are no caller restrictions
- On-chain record: The withdrawal transaction and all refunds are recorded on-chain
Common expiration scenarios
Local settlement expiration
A party never approved:
- Settlement never reached Ready state
- Cutoff date passed
- All senders who approved can withdraw their locked assets
HTLC settlement expiration
Secret was never revealed:
- Settlement reached Armed state (all approved)
- No one revealed the secret before cutoff
- All senders can withdraw their locked assets
Check all chains
For HTLC settlements, expiration on one chain doesn't affect other chains. Check the settlement status on each chain and withdraw where applicable.
Timing considerations
Withdraw promptly after expiration:
- Assets remain in the contract until withdrawn
- There's no deadline to withdraw, but prompt action is recommended
- The settlement cannot be reactivated after expiration
Troubleshooting
| Issue | Solution |
|---|---|
| Withdraw button not visible | Verify settlement has expired and you locked assets |
| Withdraw button disabled | You may have already withdrawn, or didn't have locked assets |
| "Settlement not expired" | Cutoff date hasn't passed yet - wait or check the date |
| Transaction fails | Check if assets were already withdrawn |
Next steps
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.
Yield schedule
Automate the distribution of yields, dividends, and interest payments to token holders. The yield schedule addon handles recurring payments without manual intervention.