FAQ

Common questions about RealSafe Locker answered.

General Questions

What is RealSafe Locker?

RealSafe Locker is a trustless smart contract protocol for locking DEX liquidity. It prevents teams from removing liquidity before a specified time, building trust and preventing rug pulls.

Why should I lock my liquidity?

For Projects:

  • Build trust with your community

  • Prove anti-rug commitment

  • Marketing advantage over competitors

  • Transparent on-chain verification

For LPs:

  • Force long-term commitment (diamond hands)

  • Collect fees while locked (V3)

  • Remove temptation to exit early

Is RealSafe Locker safe?

Yes! Clavis is built with multiple security layers:

  • Based on battle-tested UNCX architecture

  • OpenZeppelin security primitives

  • Non-custodial design

  • No admin backdoors

  • Open source and verifiable

Read Security Docs →

Locking Questions

How much does it cost to lock?

Creation Fee:

  • Monad Testnet: 0.0001 MON per lock

  • Monad Testnet: 0.0001 MON per lock

Claim Fee (V3 only):

  • 1% on claimed trading fees

  • Only charged when you claim fees

No unlock fee!

What's the maximum lock time?

10 years from the current date.

Can I lock liquidity permanently?

Yes, but NOT RECOMMENDED. Permanent locks can NEVER be unlocked, even by you. Only use for token burns or permanent commitments.

Can I lock partial liquidity?

Yes! You can lock any amount:

  • V2: Lock some or all of your LP tokens

  • V3: Lock specific positions (each NFT is separate)

V2 vs V3 Questions

V2 or V3 - which should I use?

Side-by-side comparison of V2 and V3 features

Use V2 if:

  • You have LP tokens (ERC-20) from Uniswap V2

  • You want simpler setup and lower gas

  • You want to add more tokens to existing locks

Use V3 if:

  • You have NFT positions from Uniswap V3

  • You want to claim fees while locked

  • You're using concentrated liquidity

Can I add more tokens to a V3 lock?

No. V3 positions (NFTs) have fixed liquidity. You cannot add to them.

For V2, yes! You can add more LP tokens to existing V2 locks.

How do fees work?

Visual breakdown of fee structure

V3 Locks:

  • Trading fees accumulate separately

  • Claim fees anytime via claimFees()

  • 1% protocol fee on claimed fees

  • Fees go to your collect address

V2 Locks:

  • Trading fees automatically increase LP token value

  • No separate claiming needed

  • You receive full value (including fees) when you unlock

  • No protocol fee on V2

Managing Locks

Can I unlock early?

No. Locks are time-based by design. You must wait until the unlock date. This is what makes them trustless.

Exception: If you set a custom condition that returns true, you can unlock early.

Can I extend my lock?

Yes! You can extend the unlock date anytime before unlocking:

  • Must be later than current unlock date

  • Max 10 years from now

  • No fee for extending

  • Can extend multiple times

Can I transfer lock ownership?

Yes! Using a secure 2-step process:

  1. Current owner initiates transfer

  2. New owner accepts transfer

This prevents accidental transfers to wrong addresses.

Can I change the collect address?

Yes (V3 only). Call setCollectAddress() anytime to change where fees go.

What happens if I lose my wallet?

Unfortunately, locks are tied to wallet addresses. If you lose access to your wallet, you lose access to your locks.

Prevention:

  • Backup private keys securely

  • Use hardware wallets for large amounts

  • Consider multi-sig wallets for team locks

Fee Questions

Why is there a creation fee?

The creation fee:

  • Covers protocol costs

  • Prevents spam locks

  • Funds ongoing development

  • Very small (0.0001 ETH/MON)

What is the claim fee?

For V3 locks only: 1% of claimed trading fees.

Example:

  • You claim 10 ETH in fees

  • 0.1 ETH goes to protocol (1%)

  • 9.9 ETH goes to you (99%)

V2 has no claim fee!

Are there any unlock fees?

No! Unlocking is completely free (only gas costs).

Technical Questions

Which networks are supported?

Live:

  • Monad Testnet

Coming Soon:

  • Monad Mainnet

Can I interact with contracts directly?

Yes! All contracts are public and verifiable:

Monad Testnet:

  • V3 Locker: 0x0b4619Ed28429a392C79aed87E6572F34ab6199e

  • V2 Locker: 0x527713F26D0769E5EaE5A77b530511025fB4FDe7

Monad Testnet:

  • V3 Locker: 0x2D0dFc5a6731315D8f911E8534746D89B7472175

  • V2 Locker: 0xe373C89A77dE728D50c7372C8Fe139B292a7DFE2

Full contract docs →

Is the code open source?

Yes! View on GitHub: https://github.com/hexsouptech/clavis-locker

How can I integrate Clavis into my dApp?

See our Developer Documentation for:

  • Smart contract interfaces

  • Integration examples

  • Subgraph queries

  • Best practices

Troubleshooting

"Insufficient creation fee" error

Cause: Didn't send enough ETH/MON with transaction.

Solution:

# Check current fee
cast call LOCKER_ADDRESS "creationFee()" --rpc-url RPC_URL

Send this amount as value in transaction.

Common errors and their solutions

"NFT Transfer Failed" error

Cause: NFT not approved to locker contract.

Solution: Approve first:

positionManager.approve(lockerAddress, tokenId);

"Lock Not Unlocked" error

Cause: Trying to unlock before unlock date.

Solution:

  • Check unlock date

  • Wait until date passes

  • Check if custom condition is met

Transaction keeps failing

Common causes:

  • Insufficient gas

  • Wrong network selected

  • Contract paused (very rare)

Solutions:

  • Increase gas limit

  • Verify network in wallet

  • Check contract status

  • Try again during lower network activity

Can't see my lock

Causes:

  • Wrong network

  • Transaction still pending

  • Using different wallet

Solutions:

  • Switch to correct network

  • Wait for confirmation

  • Connect wallet that created lock

Conditional Unlocks

What are conditional unlocks?

Locks with custom unlock logic beyond time-based:

  • Price-based: Unlock when asset reaches price

  • Governance: Unlock after DAO vote

  • Milestone: Unlock after goals achieved

  • Multi-sig: Require multiple signatures

Different types of conditional unlocks

Learn more →

Are conditions safe?

Built-in conditions are safe. For custom conditions:

  • Warning: Verify contract code first

  • Warning: Understand the logic

  • Warning: Check admin addresses

  • Time-based unlock still works as fallback

Can I create my own condition?

Yes! Implement the ILockCondition interface.

Developer guide →

Project-Specific Questions

How much liquidity should I lock?

Recommendations:

  • Minimum: 50% of initial liquidity

  • Good: 80-90% of initial liquidity

  • Excellent: 100% of initial liquidity

More locked = more trust!

How long should I lock for?

Initial launch:

  • Minimum: 30 days

  • Recommended: 90-180 days

  • Long-term: 1 year+

You can extend later! Start with 90 days and extend to show continued commitment.

Should I create one lock or multiple?

Single lock:

  • Simple

  • Clear messaging

  • Lower gas costs

Multiple locks (vesting):

  • Progressive unlocks (e.g., 25% every 6 months)

  • Shows planning

  • Reduces dump risk

Example vesting schedule with staggered unlocks

Both are fine! Choose based on your tokenomics.

How do I show my lock to investors?

  1. Get your lock's shareable link

  2. Add to website

  3. Tweet announcement

  4. Share on X

  5. Show on DexScreener/DexTools (if supported)

Verification guide →

Still Have Questions?

Community Support

Developer Docs

Can't find your answer? Reach out on X

PreviousVerifying LocksNextOverview

Last updated