Approve
Learn how to approve your flows in an XvP settlement. Approving locks your assets into the settlement contract as escrow until execution or cancellation.
When you're a sender in an XvP settlement, you must approve to lock your assets into the settlement contract. This step is required before the settlement can execute.
What approval means
When you approve a settlement:
- Your tokens are transferred from your wallet to the XvP contract
- The assets are held in escrow until the settlement executes or is cancelled
- Your approval is recorded on-chain
- The settlement progresses toward execution
Only senders approve
You only need to approve if you are sending assets in the settlement. Recipients do not need to take any action.
Prerequisites
- You are listed as a sender in one or more local flows
- Your wallet holds sufficient assets for the flows you're sending
Steps
Find the settlement
Navigate to Settlements in the sidebar. Pending settlements where you need to approve are marked with an action indicator.
Click on the settlement to open its detail page.
Review the flows
Before approving, carefully review:
- All flows in the settlement (who sends what to whom)
- Your specific flows (what you're sending and to whom)
- The cutoff date
- For HTLC settlements: the hashlock and timelock
Approve your flows
Click Approve on the settlement detail page.
A confirmation dialog shows:
- The tokens being locked
- The amounts being transferred to escrow
- The recipient addresses
Review and click Confirm, then authenticate with your PIN or OTP.
Verify approval status
After the transaction confirms:
- Your approval status changes to "Approved"
- The settlement shows updated approval count (e.g., "2 of 3 approved")
- If you were the final sender to approve, the settlement may execute (if auto-execute is enabled)
What happens after approval
| Settlement type | What happens when all approve |
|---|---|
| Local (auto-execute on) | Settlement executes immediately |
| Local (auto-execute off) | Settlement enters Ready state, awaiting manual execution |
| HTLC | Settlement enters Armed state, awaiting secret reveal |
Revoking approval
Revocation rules differ by settlement type:
Local settlements:
- You can revoke your approval at any time before execution
- Revocation is allowed even after the settlement becomes Ready (fully approved)
HTLC settlements:
- You can revoke only before the settlement becomes Armed (before all approvals are received)
- Once Armed (fully approved), revocation is not allowed
See Revoke approval for detailed steps.
Troubleshooting
| Issue | Solution |
|---|---|
| Approve button disabled | You may not be a sender in any local flows |
| Insufficient balance | Ensure your wallet has enough assets for your flows |
| Transaction reverts | Check compliance requirements on the token |