Quickstart

Lock your liquidity in 5 minutes! This guide covers the fastest way to lock your V2 LP tokens or V3 positions using the RealSafe web app.

Prerequisites

  • MetaMask or compatible Web3 wallet

  • V2 LP tokens OR V3 NFT position to lock

  • Small amount of ETH/MON for creation fee (~0.0001)

Method 1: Using the Web App (Recommended)

Step 1: Connect Your Wallet

  1. Go to https://app.realsafe.io

  2. Click "Connect Wallet"

  3. Select your wallet (MetaMask, WalletConnect, etc.)

  4. Approve the connection

Step 2: Choose Locker Type

For V2 LP Tokens:

  • Click "V2 Locker" tab

  • Select the LP token you want to lock from dropdown

For V3 Positions:

  • Click "V3 Locker" tab

  • Your V3 positions will load automatically

Step 3: Configure Your Lock

Example: V2 lock configuration with all fields

  1. Amount (V2 only): Enter how many LP tokens to lock

  2. Unlock Date: Choose when you want to unlock

    • Click date picker

    • Or enter number of days (e.g., "90" for 90 days)

  3. Collect Address (V3 only): Where trading fees should go

    • Leave blank to use your wallet address

  4. Condition (Advanced): Leave as "None" for simple time-lock

Example: V3 lock configuration with position selected

Step 4: Approve & Lock

  1. Click "Approve" button

    • This lets the locker contract access your tokens

    • Confirm the transaction in your wallet

    • Wait for confirmation (~10-30 seconds)

Approve transaction in MetaMask

  1. Click "Lock" button

    • Review the summary popup

    • Make sure unlock date is correct

    • Click "Confirm Lock"

    • Confirm the transaction in your wallet

    • Pay the creation fee (~0.0001 ETH/MON)

Lock transaction showing creation fee

Step 5: Done!

Your liquidity is now locked! You'll see:

  • Success message with your Lock ID

  • Lock details (amount, unlock date, etc.)

  • Your lock in the "My Locks" page

Success screen with Lock ID - save this!

Method 2: Using Smart Contracts Directly

If you prefer interacting with contracts directly (advanced users):

For V3 Positions

// 1. Approve NFT to locker
positionManager.approve(v3LockerAddress, tokenId);

// 2. Lock the position
v3Locker.lockPosition{value: 0.0001 ether}(
    tokenId,                           // Your NFT token ID
    block.timestamp + 90 days,         // Unlock in 90 days
    msg.sender,                        // Fees go to you
    address(0)                         // No custom condition
);

For V2 LP Tokens

// 1. Approve LP tokens to locker
lpToken.approve(v2LockerAddress, amount);

// 2. Lock the tokens
v2Locker.lockLP{value: 0.0001 ether}(
    lpTokenAddress,                    // LP token address
    1000 * 1e18,                       // Amount to lock
    block.timestamp + 90 days,         // Unlock in 90 days
    false,                             // Not permanent
    address(0)                         // No custom condition
);

Managing Your Locks

View Your Locks

  1. Go to https://app.realsafe.io

  2. Connect your wallet

  3. Click "My Locks" in navigation

  4. See all your active locks with details

View all your active locks

Claim Trading Fees (V3 Only)

  1. Go to "My Locks"

  2. Find your V3 lock

  3. Click "Claim Fees" button

  4. Confirm transaction

  5. Fees are sent to your collect address

Claim fees from your V3 lock anytime

Note: V2 LP tokens don't have a claim button because fees automatically increase your token value!

Extend Your Lock

  1. Go to "My Locks"

  2. Click the lock you want to extend

  3. Click "Extend Lock" button

  4. Choose new unlock date (must be later than current)

  5. Confirm transaction (no fee for extending!)

Extend your lock to show continued commitment

Unlock Your Liquidity

  1. Go to "My Locks"

  2. Wait until unlock date has passed

  3. Click "Unlock" button (will be greyed out until unlock time)

  4. Confirm transaction

  5. Your tokens/NFT are returned to your wallet!

Unlock button becomes active when lock is ready

Quick Tips

Best Practices

  • Start with a test lock: Lock a small amount first to learn the process

  • Double-check dates: Make sure your unlock date is correct before confirming

  • Save your Lock ID: Keep a record of your lock IDs for easy reference

  • Use hardware wallet: For large amounts, use Ledger/Trezor for security

Common Mistakes to Avoid

  • Wrong network: Make sure you're on the correct network (Monad Testnet)

  • Insufficient gas: Keep extra ETH/MON for gas fees

  • Too long lock: Remember max is 10 years, choose wisely!

  • Forgetting to approve: Always approve before locking (two transactions)

Pro Tips

  • Claim fees regularly: V3 users can claim fees anytime, don't let them accumulate too much

  • Extend strategically: Extending your lock shows long-term commitment to community

  • Check before unlock: Use "Can Unlock?" button to verify you can unlock before trying

Troubleshooting

"Transaction Failed" Error

Causes:

  • Insufficient gas

  • Already locked this NFT/tokens

  • Unlock date in the past or too far future

Solutions:

  • Check you have enough ETH/MON for gas

  • Make sure NFT/tokens aren't already locked

  • Verify unlock date is between now and 10 years

"Approval Failed" Error

Causes:

  • Trying to approve 0 amount (V2)

  • NFT not in your wallet

  • Already approved

Solutions:

  • For V2: Enter amount before approving

  • For V3: Make sure you own the NFT

  • Try refreshing the page

Can't See My Lock

Causes:

  • Wrong network selected

  • Transaction still pending

  • Using different wallet address

Solutions:

  • Switch to correct network in wallet

  • Wait for transaction confirmation

  • Connect correct wallet that created lock

Need More Help?

Next Steps

Congratulations! You're now ready to lock your liquidity securely!

PreviousGetting StartedNextLocking Liquidity

Last updated