Launchpad documentation

Public Urufu launches follow one ERC-20 lifecycle: define coin, customize contract, safe launch, curve trading, then V4 graduation if the bonding curve reaches its target.

1. 01

   define coin

   name, ticker, artwork, description, and links. This is the public identity traders see on the launch and trade pages.

2. 02

   customize contract

   quick launch uses safe defaults; customizable curve adds shipped ERC-20 modules plus optional whitelist, sniper gate, and buyback-burn settings.

3. 03

   safe launch

   the router quotes the live fee, checks name/ticker availability, deploys the token, installs the bonding curve, and auto-renounces curve ownership.

4. 04

   curve trading

   buyers and sellers trade against the bonding curve immediately. Price moves with the curve reserves, and sellability depends on curve liquidity.

5. 05

   V4 graduation

   when the curve reaches its target, liquidity migrates to a Uniswap V4 pool with the platform hook for locked LP and creator fee routing.

A customizable curve can attach a community whitelist at launch. The creator pastes a supported contract address, the backend snapshots current holders, and the launch transaction stores a Merkle root.

• Whitelisted wallets use the proof path during the exclusive window; non-whitelisted wallets wait for fallback.
• 60% of curve supply is reserved for whitelist buyers while the window is active.
• The per-wallet cap is reserved supply divided by five, so a small set of holders cannot drain the full reserved slice from one wallet.
• The current frontend sets a 1-hour fallback window when the whitelist is applied.
• Whitelist buyers hold on-curve balances until graduation, then claim through the whitelist claim path.

Launch fees are quoted from the router. Creators can pay in ETH, or on chains where URU pay is wired, pay the quoted ETH-equivalent amount in URU through the router's URU launch path.

• Holding at least one urufu gemu pass applies a 20% launch-fee discount.
• Holding at least 100,000 URU applies a 40% launch-fee discount.
• Holding both applies a 50% combined discount in the frontend, with an on-chain hard cap protecting the router.
• The frontend checks the live URU/WETH V4 slot and the router floor before enabling URU payment.
• URU approvals are separate from the launch transaction; approve first, then launch.

Every public ERC-20 launch installs a bonding curve. The token supply starts inside the curve, the trade page is live after launch, and users buy or sell against the curve while it has reserves.

• The curve uses virtual reserves and a constant-product style price model.
• Buys add ETH and move the price up; sells remove ETH and move the price down.
• Pre-graduation curve trading charges a 1% trade fee routed by platform contracts, not a hidden creator kickback.
• Quick launch uses safe defaults, including a fixed supply and a safe launch; customizable curve exposes more knobs.
• A token that never graduates can keep trading on its curve as long as the curve has usable liquidity.

Graduation moves the market from the bonding curve to Uniswap V4. The graduator creates the pool, installs the platform hook, and moves the curve liquidity into the V4 position.

• The V4 LP is intended to be locked by hook behavior: remove-liquidity calls revert through the LP-lock hook.
• The trade page continues against the graduated market instead of the old curve path.
• Creator fee routing starts after graduation through the V4 hook configuration.
• Optional security and buyback-burn settings are written into the pool at graduation when selected.
• Graduation improves market depth, but it does not make price appreciation or future volume guaranteed.

• Launch fees use a documented split: 40% URU buyback, 35% urufu gemu NFT revenue, and 25% treasury.
• The 40% buyback slice funds the flywheel. ETH accrues in the buyback vault, a keeper swaps it for URU on-chain, and the bought URU is forwarded to the current distribution sink (redistribute to gemu holders, or burn, depending on the active sink).
• There is no launch-fee creator slot. That path was removed to avoid spam-launch farming.
• Creator earnings are post-graduation V4 swap fees, claimable from the configured creator address.
• Discounts lower the launch fee only; they do not remove gas costs or trading risk.

The frontend should be treated as the source of truth for which chain is currently launch-enabled. The create page reads deployed contract addresses from configuration, quotes from the live router, and disables launch when the selected chain is not wired.

• Robinhood Chain is the current culture-first target for the public flow.
• Historical Base and testnet code remains in the repository, but inactive chains should not be treated as public launch availability.
• Wrong-network and not-live states block the launch button before a transaction is sent.