LP24 Protocol Documentation

Complete developer reference for integrating with the LP24 bonding-curve protocol. Deploy tokens, trade on bonding curves, and interact with graduated Uniswap V4 pools — all permissionlessly, directly from smart contracts.

Decentralised by Design

Every function documented here can be called directly on-chain without using the LP24 frontend. The protocol has no admin keys, no owner, and no upgrade mechanism. This documentation exists so that any developer or smart contract can integrate with LP24 independently.

What is LP24?

LP24 is a permissionless token launch protocol deployed on Base and BSC. It combines a bonding curve for initial price discovery with automatic graduation into a Uniswap V4 liquidity pool. The entire lifecycle — from token creation to fully-traded DEX pair — happens without any manual intervention.

Protocol at a Glance

1
Deploy Token + Bonding Curve
Call Factory.deploy_pair() with a name, symbol, and vanity salt. Pays a small deployment fee. Creates a minimal-proxy token and bonding curve in one transaction.
2
Trade on Bonding Curve
Anyone can buy and sell lots on the bonding curve. Price increases quadratically with supply. A dynamic tax (12% → 1.2%) decreases as supply grows. Deployer tokens are locked (cannot sell).
3
Graduation
When all 800,000 lots are sold, the curve automatically graduates. It mints 400M liquidity tokens, creates a Uniswap V4 pool via the Hook, and enables free trading. The deployer receives 90% of accumulated fees.
4
Post-Graduation Trading
The token trades on Uniswap V4 with dynamic hook fees (1.2% / 0.8% / 0.4%). Fees are split: 30% deployer, 10% platform, 60% reinvested as liquidity. All fee operations are permissionless.
5
Community Takeover (Optional)
Token holders can initiate a CTO vote to replace the deployer. Requires 5% stake + 0.0001 ETH fee, 40% quorum, and simple majority over a 3-day voting period.
Deploy a Token →
Step-by-step guide to deploying your first token pair via the Factory contract.
Buy & Sell Tokens →
How to trade on bonding curves using ethers.js or direct contract calls.
Factory Reference →
Complete function reference for the Factory deployment contract.
BondingCurve Reference →
Buy, sell, quote, and refund functions on the bonding curve.
LiquidityGenHook Reference →
Fee distribution, reinvestment, buy-and-burn, and CTO voting.
Constants & Parameters →
All protocol constants across Base and BSC chains.

Supported Chains

ParameterBaseBSC
Native TokenETHBNB
Deployment Fee0.0006 ETH0.0012 BNB
Graduation Liquidity0.04 ETH0.08 BNB
Block Time2s~3s
Inclusion Window10 blocks (20s)44 blocks (~132s)