lemon.fun
lemon.fun
PROTOCOL HANDBOOK

lemon.fun.

Every on-chain component of the lemon.fun launchpad, the token lifecycle from creation to graduation, and the public HTTP API for third-party terminals, indexers and market-data providers. All contracts are immutable, unowned, and verified on Blockscout.

Download .docxOpen explorer ↗

§1Chain & Infrastructure

NetworkRobinhood Chain (Arbitrum Orbit L2)
Chain ID4663
Native gasETH
Public RPChttps://rpc.mainnet.chain.robinhood.com
Explorerrobinhoodchain.blockscout.com ↗
DEX venueUniswap V3 (clAMM), 1% fee tier — default graduation venue. Sushi V3 retained as fallback.
Frontendlemon.fun

§2Token Lifecycle

2.1  Creation

A creator calls LemonCurveFactory.launch(...) with token metadata (name, ticker, image, socials) and an optional dev-buy amount in ETH. In a single transaction the factory:

2.2  Bonding phase

While raised WETH is below threshold, all trading happens against BondingCurve. Every buy and sell pays a fixed 1% platform + 1% creator fee; the remainder is routed through the constant-product formula. Events: Buy(...) / Sell(...).

2.3  Graduation

When cumulative raised WETH reaches the threshold, the next buy triggers graduate() atomically: wraps raised ETH, creates the Uniswap V3 pool (TOKEN/WETH, 1% tier) if missing, mints a full-range LP position with retained tokens + raised WETH, and transfers the LP NFT to a fresh LpLocker. Emits Graduated(token, pool, lpLocker, tokenId).

2.4  Post-graduation

Trading moves to the Uniswap V3 pool via the canonical SwapRouter02. Standard pool fees accrue to the LP NFT held by LpLocker. Any caller may invoke LpLocker.collect(); the contract splits the collected fees 50/50 between platform and creator. LP principal is permanently locked — no withdraw or migrate function exists.

§3Per-Launch Contracts

LemonToken

ERC-20 with fixed 1,000,000,000 supply, immutable launcher, optional maxWallet + anti-snipe window. Metadata (socials, image URI) is written into the token at creation. Pool-touching transfers are blocked until graduation to prevent price manipulation from bot-created dust pools.

BondingCurve

Constant-product virtual-reserve curve (K = virtualEth × (virtualToken + supply)). Charges a fixed 1% platform + 1% creator fee on every buy and sell — no adjustable/hidden fees. Auto-graduates when raised WETH ≥ graduationThreshold (default 4.0 WETH).

LpLocker

Owns the Uniswap V3 LP NFT after graduation. Fees collected via NonfungiblePositionManager.collect() are split 50/50 between the platform and creator; LP principal is permanently locked (no withdraw or migrate).

§4Platform Contracts

Lemon platform

LemonCurveFactory (v3 · vault-free)0x4924d006edd8c142eb3f78c4e8437bf718764485

Current production factory. Deploys LemonToken + BondingCurve in one transaction directly from the factory (shallow deploy depth for scanner-friendly verification). DEX-agnostic: takes the target DEX factory + position manager as call-time parameters, so the same factory can graduate to Uniswap V3, Sushi V3, or any future clAMM without redeployment.

CurveDeployer0x85a9fb0b18d225e86b2d597d5e6cc8f0156b0ac5

Deploys individual BondingCurve instances with immutable graduation and fee parameters.

TokenDeployer (legacy)0x3764335bb53b8752c42bebd170ba606e26535e81

Standalone token deployer from the previous stack. Retained for backward-compatible integrations; new launches use LemonCurveFactory only.

Platform Fee Receiver0x6b73Ab1e4a4A7A7Da757aC2Ab89F0cf93fa291a5

Multisig-controlled EOA that receives the 1% platform fee during bonding and 50% of the graduated pool's swap fees via LpLocker.

Robinhood Chain — Uniswap V3 (default)

Uniswap V3 Factory0x1f7d7550b1b028f7571e69a784071f0205fd2efa

Canonical Uniswap V3 factory on Robinhood Chain. Called at graduation to create the TOKEN/WETH pool (1% fee tier).

NonfungiblePositionManager0x73991a25c818bf1f1128deaab1492d45638de0d3

LP NFT manager. Positions minted at graduation are transferred to the token's LpLocker; fees are later collected via NPM.collect().

SwapRouter020xcaf681a66d020601342297493863e78c959e5cb2

Canonical Uniswap swap router used by the frontend and integrators to trade graduated pools.

Robinhood Chain — SushiSwap V3 (legacy fallback)

SushiSwap V3 Factory (legacy)0xe51960f1b45f1c9fb6d166e6a884f866fc70433b

Canonical Sushi V3 (clAMM) factory. No longer the default graduation venue; kept as a fallback DEX option supported by LemonCurveFactory.

Sushi NonfungiblePositionManager (legacy)0x51d0e5188afe12d502e29d982d20c190e7816107

LP NFT manager for Sushi V3. Used by tokens that graduated to Sushi prior to the Uniswap switch.

SushiSwapAdapter (legacy)0x6f6b1962191785babc87db4b37fcbed8d5b6be34

Uniswap-style exactInputSingle adapter over Sushi V3 pool.swap() for tokens graduated to Sushi.

Robinhood Chain — Core tokens

WETH0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73

Wrapped ETH used as the quote asset in every bonding curve and graduated pool.

USDG0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168

USD stablecoin native to Robinhood Chain (reference only).

§5Fee Model

PhasePlatformCreator
Bonding curve — buy1.0% of ETH in1.0% of ETH in
Bonding curve — sell1.0% of ETH out1.0% of ETH out
Post-graduation (Uniswap V3, 1% tier)50% of pool fees50% of pool fees

§6Public HTTP API

Base URL: https://lemon.fun. All endpoints are unauthenticated, CORS-enabled, and return application/json. Rate limits are per-IP and generous for indexers — contact the team for whitelisting.

GET/api/public/launchpad/home

Cached home feed: featured, trending, newly graduated. 15s edge cache.

GET/api/public/launchpad/stats

Aggregate counters (tokens launched, graduated, 24h volume ETH/USD).

GET/api/public/launchpad/tokens

Paginated token list. ?limit=1..200&offset=&sort=created|mcap|volume&graduated=true|false

GET/api/public/launchpad/token/:address

Full token detail: metadata, curve state, market cap, holders, graduated pool.

GET/api/public/launchpad/token/:address/trades

Recent buy/sell events. ?limit=1..500

POST/api/public/rpc

JSON-RPC proxy to the Alchemy Robinhood Chain endpoint. Standard eth_* methods.

6.1  Example — token detail

GET https://lemon.fun/api/public/launchpad/token/0x438ac56065af7c091bfa8f4d6d0214f36e273e02

{
  "address": "0x438a...3e02",
  "name": "catfrog",
  "ticker": "CATFROG",
  "curve": "0x...",
  "graduated": false,
  "raised_eth": "3.323",
  "graduation_threshold_eth": "4.0",
  "mcap_eth": 2.65,
  "price_eth": 0.00000000265,
  "holders": 128,
  "created_at": "2026-07-18T..."
}

6.2  On-chain event schema

LemonCurveFactory.Launched(address token, address curve, address creator, uint8 dex, uint256 graduationThresholdWei)BondingCurve.Buy(address buyer, uint256 ethIn, uint256 tokensOut, uint256 feePlatform, uint256 feeCreator)BondingCurve.Sell(address seller, uint256 tokensIn, uint256 ethOut, uint256 feePlatform, uint256 feeCreator)BondingCurve.Graduated(address token, address pool, address lpLocker, uint256 lpTokenId)LpLocker.FeesCollected(uint256 amount0, uint256 amount1, uint256 platformShare, uint256 creatorShare)

§7Security Posture

§8Contact & Verification

Bytecode for every contract in §4 is verified on Blockscout; the source Solidity is available in the platform's public repository.

Frontendhttps://lemon.fun
Explorerhttps://robinhoodchain.blockscout.com
RPChttps://rpc.mainnet.chain.robinhood.com

© 2026 lemon.fun — Independent, community-built launchpad on Robinhood Chain.