Unlocking
Complete guide to unlocking your locked liquidity when the time comes.
Overview
This guide covers:
Checking if you can unlock
Unlocking V2 LP tokens
Unlocking V3 positions
Troubleshooting unlock issues
Before Unlocking
Check Unlock Status
Using Web App:
Go to https://app.realsafe.io
Connect wallet
Go to "My Locks"
Check status indicator:
Locked: Cannot unlock yet
Ready: Can unlock now
Shows time remaining
Lock showing locked status with time remaining
Lock ready to unlock
Using Smart Contract:
bool canUnlock = locker.canUnlock(lockId);Requirements to Unlock
All of these must be true:
Current time >= unlock date
You are the lock owner
Lock is still active (not already unlocked)
If condition is set, condition returns
true
Unlocking V2 LP Tokens
Step-by-Step
1. Navigate to Your Locks
Go to https://app.realsafe.io
Connect wallet
Click "My Locks"
Find the V2 lock to unlock
2. Verify You Can Unlock
Check unlock date has passed
Status should show "Ready to Unlock"
Button will be enabled
Unlock button disabled while locked
Unlock button enabled when ready
3. Click Unlock
Click "Unlock" button
Review lock details one last time
Confirm transaction in wallet
4. Receive Your Tokens
LP tokens sent back to your wallet
Includes all accrued trading fees!
Lock marked as inactive
What You Receive
V2 LP Tokens:
Full original amount
Plus all accrued trading fees (auto-compounded into token value)
No unlock fee charged
Unlocking V3 Positions
Step-by-Step
1. Navigate to Your Locks
Go to https://app.realsafe.io
Connect wallet
Click "My Locks"
Find the V3 lock to unlock
2. (Optional) Claim Final Fees
Before unlocking, consider claiming remaining fees:
Click "Claim Fees" button
Confirm transaction
Fees sent to your collect address
V3 lock showing unclaimed fees
Note: You can also claim fees after unlocking!
3. Click Withdraw
Click "Withdraw" button
Choose recipient address (usually your wallet)
Confirm transaction in wallet
V3 withdraw confirmation modal
4. Receive Your NFT
NFT position returned to your wallet
Position data unchanged
Can now manage freely in Uniswap
Success! Your tokens/NFT are returned
What You Receive
V3 NFT Position:
Your original NFT with same token ID
All liquidity intact
Unclaimed fees still claimable via Uniswap
No unlock fee charged
Conditional Unlocks
If your lock has a custom condition set:
How Conditions Work
Locks can unlock when:
Time-based: Unlock date reached, OR
Condition-based: Condition returns
true
Either one being true allows unlock!
Checking Condition Status
Via Web App:
Shows condition status on lock card
"Condition Met" or "Condition Not Met"
Lock with custom condition status
Via Contract:
bool conditionMet = ILockCondition(conditionAddress).isUnlocked(locker, lockId);Common Condition Types
TimeBasedCondition:
Admin sets custom unlock timestamp
Can be earlier than original unlock date
PriceCondition:
Unlocks when asset reaches target price
Requires oracle integration
GovernanceCondition:
Unlocks after DAO vote passes
Requires proposal execution
Learn more about conditions →
After Unlocking
What Happens to Lock
Lock marked as inactive
Cannot be reused or modified
Still visible in lock history
Lock ID remains in your lock list
What You Can Do
With V2 LP Tokens:
Remove liquidity from pool
Trade LP tokens
Lock again (creates new lock)
Provide more liquidity
With V3 Position:
Remove liquidity
Adjust price range
Collect remaining fees
Close position
Troubleshooting
"Cannot Unlock Yet" Error
Cause: Unlock date hasn't been reached.
Solution:
Check current date/time
Verify unlock date of lock
Wait until unlock date passes
Time shown in your local timezone
"Not Lock Owner" Error
Cause: Connected wallet is not the lock owner.
Solution:
Check which wallet created the lock
Connect correct wallet
If transferred ownership, use new owner wallet
"Lock Not Active" Error
Cause: Lock already unlocked or invalid.
Solution:
Check if lock was already unlocked
Verify Lock ID is correct
Refresh page and try again
"Condition Not Met" Error
Cause: Custom condition returns false.
Solution:
Wait for condition to be met
Check condition status/requirements
Alternative: Wait for time-based unlock
Contact condition administrator if needed
Transaction Fails
Common causes:
Insufficient gas
Network congestion
Contract paused (rare, emergency only)
Solutions:
Increase gas limit
Try during lower network activity
Check contract status on block explorer
Emergency Situations
Contract Paused
In very rare emergency situations, contracts may be paused.
What this means:
Cannot unlock temporarily
Funds are safe
Pause is temporary
What to do:
Check official announcements on X
Wait for unpause announcement
Lost Wallet Access
Problem: Lost access to wallet that owns lock.
Unfortunately:
Locks are tied to wallet addresses
No recovery mechanism (by design for security)
No admin backdoor
Prevention:
Backup private keys securely
Use hardware wallets
Consider multi-sig for large amounts
Test recovery process
Best Practices
Before Unlock Date
Set calendar reminder for unlock date
Claim V3 fees regularly (don't wait for unlock)
Monitor lock status in "My Locks"
Keep some ETH/MON for unlock gas
On Unlock Date
Verify you can unlock before trying
Check gas prices (wait if too high)
Have plan for unlocked liquidity
Consider immediately relocking to extend commitment
After Unlocking
Verify tokens/NFT in your wallet
Save transaction hash for records
Update community if project liquidity
Consider creating new lock if continuing
Extending Instead of Unlocking
Don't want to unlock yet? Extend your lock!
Why Extend
Show continued commitment
Build more community trust
Keep fees collecting (V3)
Maintain locked liquidity status
How to Extend
Before unlock date, go to lock details
Click "Extend Lock" button
Choose new unlock date (must be later)
Confirm transaction
No fee for extending!
Learn more about extending →
Next Steps
Locking Guide - Lock again or lock new positions
Verifying Locks - Show proof of locks
FAQ - More questions answered
Need help unlocking? Reach out on X
Last updated