aerolock

documentation

everything you need to know about deploying and managing LP token lockers on aerodrome finance

quick start

  1. connect your wallet - click "launch app" and connect your web3 wallet
  2. deploy your locker - provide your aerodrome LP token address and fee receiver
  3. pay deployment fee - send $75 worth of ETH to deploy your custom locker contract
  4. lock your tokens - lock LP tokens into your new locker contract
  5. manage & claim - track your locks and claim LP fees through the dashboard

core concepts

what is a locker?

a locker is your own deployed smart contract that holds your aerodrome LP tokens with configurable timelock protection. once deployed, you own and control it completely.

each locker is a unique contract address
each locker holds a single aerodrome LP token
you can create multiple locks within one locker

withdrawal timelock

to withdraw locked tokens, you must first trigger withdrawal, which starts a mandatory 30-day waiting period. this timelock provides security and prevents instant withdrawals.

how it works
  1. trigger withdrawal for your lock
  2. wait 30 days for timelock to expire
  3. withdraw your tokens after timelock completes
canceling withdrawal
if you trigger withdrawal by mistake, you can cancel it before the timelock expires, resetting the lock to its original state

LP fee claiming

aerodrome v2 pools pay trading fees separately from the LP tokens, so they have to be claimed. while your tokens are locked, the locker keeps earning those fees and you can claim them at any time without affecting your lock status.

deployment process

step 1: prepare your LP tokens

you need aerodrome LP tokens from a liquidity pool on base network. get the contract address of your LP token pair.

step 2: configure your locker

provide the following information:

  • LP token address - the aerodrome pool contract address
  • fee receiver address - where LP fees will be sent when claimed

step 3: pay deployment fee

deployment costs $75 worth of ETH (paid in ETH). this covers gas costs and platform maintenance.

payment is sent to: 0xc0dca68EFdCC63aD109B301585b4b8E38cAe344e

step 4: deploy

your wallet deploys the locker contract. aerolock then checks on-chain that the deployment and payment came from your wallet and that the payment covers the fee, adds the locker to your dashboard, and submits its source code for basescan verification.

managing locks

adding more locks

you can create multiple locks within the same locker contract or top up existing locks with additional LP tokens. simply approve and transfer more LP tokens through your locker dashboard.

withdrawing tokens

to withdraw tokens, you must first trigger withdrawal, then wait for the timelock period to complete:

  1. go to your locker details page
  2. click "trigger withdrawal" for your lock
  3. wait 30 days for the timelock to expire
  4. click "withdraw" to claim your tokens

claiming LP fees

LP fees accumulate while tokens are locked. claim them anytime through your locker dashboard without affecting your lock status. fees are claimed for the whole locker at once and always go to the locker's fee receiver address.

canceling withdrawal

if you trigger withdrawal by mistake, you can cancel it any time before the 30-day timelock expires. this resets your lock to its active state and you'll need to trigger withdrawal again when you're ready.

technical details

smart contract

each locker is deployed directly from the aerolock app. the locker contracts are:

  • non-upgradeable and immutable
  • fully owned by the deployer
  • identical bytecode across all deployments
  • open source, verified on basescan and sourcify

network

aerolock operates exclusively on base network. make sure your wallet is connected to base mainnet before deploying.

security

  • on-chain payment verification
  • timelock protection on withdrawals
  • withdrawals require 30 days' public notice
  • no platform admin key: aerolock can't move, pause or unlock anything

contract verification

all aerolock lockers are deployed from the same source code, and new lockers are submitted for basescan verification automatically. compiler settings: solidity 0.8.20, optimizer off, evm version shanghai, MIT license.

  • every locker uses the same source code
  • bytecode can be compared across deployments on basescan
  • access basescan links and verification info from your locker dashboard

view your locker details page for direct links to basescan and verification information. for help with manual verification, reach out on X or github.

security

what the locker owner can do

  • lock LP tokens and top up existing locks
  • trigger a withdrawal, which starts a public 30-day countdown, and cancel it
  • withdraw LP only after that countdown has finished
  • change the fee receiver and claim LP fees
  • transfer ownership (the new owner must accept), or renounce it, which locks the LP permanently

what nobody can do

  • withdraw LP without the 30-day notice - not the owner, not aerolock
  • take the locked LP token through the token-recovery function (it's blocked for the LP token)
  • upgrade or change the contract - it has no proxy and no platform admin
  • redirect fees anywhere except the locker's fee receiver

checking a lock

every locker has a public page at aerolock.app/locked/<locker address> showing each lock's live status read from base: locked, withdrawal pending (with the date it unlocks), or withdrawable. a pending withdrawal can't be hidden - it's on-chain for the full 30 days before any liquidity can leave.

audit status

the locker contract has not had an independent third-party audit yet. its full source is public and verified on basescan and sourcify, and it builds on openzeppelin's ownable2step and safeerc20. questions or findings: reach out on X or open an issue on github.

frequently asked questions

your LP tokens continue earning fees from the aerodrome pool while locked. you can claim these fees at any time through the locker dashboard without affecting your lock status.

yes! you can create multiple locks within the same locker contract or top up existing locks. simply approve and transfer more LP tokens through your locker dashboard.

you must first trigger withdrawal, which starts a mandatory 30-day waiting period. after the timelock expires, you can withdraw your tokens at any time. this delay provides security and prevents instant withdrawals.

no, the $75 deployment fee is non-refundable. it covers gas costs for contract deployment and platform maintenance. make sure to double-check all details before deploying.

the locker contract ownership is tied to the deployer's wallet address. while the contract itself cannot transfer ownership, you control it through your wallet's private keys. always keep your wallet secure.

all aerodrome LP tokens on base network are supported. simply provide the LP token contract address when deploying your locker. the system will automatically verify it's a valid aerodrome pool.

once the 30-day timelock expires after triggering withdrawal, you can withdraw your tokens at any time through the locker dashboard. there's no expiration - your tokens remain safely in the contract until you choose to complete the withdrawal.

each locker has a public showcase page that displays your locked positions. you can share this page link with investors, partners, or community members to prove your liquidity commitment. find the share button in your locker details.

need more help?

can't find what you're looking for? reach out to our community

ask on Xview on github