# Stage.fun > Stage.fun is a token launchpad for entertainment IP, brands and productions on the Monad blockchain. Every launch ("stage") picks a **pair asset** — USDC, MON, or an Anchored tokenized US stock/ETF such as aBIL — and sells either through a fixed-price tiered **round** (patrons commit the pair asset, refunds if the target is missed) or through a **bonding curve** priced in that asset that graduates into permanently locked Uniswap V4 liquidity. Authentication is via Privy (WalletConnect for agents). The app runs on Monad mainnet (chain ID 143) and Monad testnet (chain ID 10143) and is served at https://app.stage.fun (the old stagefun.vercel.app host is retired: do not use it). ## Key concepts - **Stage / round**: a fixed-price token launch with patron tiers, gates, NFT passes and vesting. Patrons commit the round's pair asset; the launch graduates when the producer calls `beginExecution()`, seeding a Uniswap V4 position (TOKEN / pair asset). - **Curve launch**: a 1,000,000,000-token launch sold through a constant-product curve in the pair asset from the first trade (800M on the curve, 200M reserved for the pool). Graduates permissionlessly when the curve holds `H` (the graduation threshold, sized in USD at launch: Small $30k / Standard $60k / Large $250k graduation FDV, `H` = 20% of it). 1% fee on every trade split creator / platform; time-decaying anti-snipe tax; the V4 position is held by a locker with no withdraw path. - **Pair asset** ("Paired with"): the ERC-20 a launch is quoted in. `quote_asset_address`, `quote_symbol`, `quote_decimals` (6 for USDC, 18 for MON and stocks), `quote_kind` (`STABLE` | `WRAPPED_NATIVE` | `STOCK`). MON is WMON on-chain; the UI shows "MON" and wraps in the same transaction batch. Stock pairs are operator-enabled per asset, geofenced, and gated by the Anchored StockOracle market session. - **Patron**: a user who commits to a round. **Producer**: the creator. **Culture coin**: the launched ERC-20. - **Amounts**: every API amount is a base-unit string; convert with `quote_decimals` / `token_decimals`. Never assume 6 decimals. ## Product surfaces - [Pools (rounds)](https://app.stage.fun/pools): featured, actively raising and trading rounds - [Round page](https://app.stage.fun//overview): tiers, commit, funds, trading tabs - [Curves list](https://app.stage.fun/launches): bonding-curve launches, filter by status and pair asset - [Curve page](https://app.stage.fun//curve): chart, buy/sell widget, trades, graduation state, creator fees - [Create a round](https://app.stage.fun/pools/create): 3-page wizard with launch mode and "Paired with" selector - [Create a curve](https://app.stage.fun/launches/new): admin-gated while the pairs stack is unreleased - [Profile](https://app.stage.fun/profile): wallets, tokens, commitments - [Human docs](https://app.stage.fun/docs): launch-round and commit guides, skill pages ## API Base: https://app.stage.fun/api. Full contract: [docs/pairs/API.md](https://github.com/blocklive/stagefun/blob/main/docs/pairs/API.md). - [GET /api/pools/list](https://app.stage.fun/api/pools/list): rounds and curves with pair meta (`quote_*`, `launch_mode`) and both display and `*_base_units` amounts - [GET /api/pools/search?q=](https://app.stage.fun/api/pools/search?q=): search pools by name / ticker / slug - [GET /api/pools/[id]](https://app.stage.fun/api/pools/): one pool by UUID or slug (`?chain=1` refreshes amounts from the contract) - [GET /api/pairs?network=monad-mainnet](https://app.stage.fun/api/pairs?network=monad-mainnet): pair-asset registry with USD prices, market session and `launchable` flag - [GET /api/pairs/[address]/price](https://app.stage.fun/api/pairs/): one pair asset's oracle price - [GET /api/launches?network=&status="e=&sort=](https://app.stage.fun/api/launches?network=monad-mainnet): curve launches with progress, price, mcap, 24h volume - [GET /api/launches/[curveAddress]](https://app.stage.fun/api/launches/): live on-chain snapshot (reserves, progress, snipe tax for `?recipient=`) plus last trades - [GET /api/launches/[curveAddress]/quote?side=buy|sell&amount=&buyer=](https://app.stage.fun/api/launches/): exact trade quote via `quoteBuy` / `quoteSell` - [GET /api/launches/[curveAddress]/trades?limit=&before=](https://app.stage.fun/api/launches/): paged trade history - [GET /api/amm-candles?source=curve&curve=&resolution=](https://app.stage.fun/api/amm-candles): OHLCV built from curve trades (quote per token) - [GET /api/geo/check](https://app.stage.fun/api/geo/check): `{ country, stockPairsBlocked }` — stock-paired routes answer HTTP 451 `GEO_BLOCKED` from geofenced regions - POST /api/pools/create: registers a launch from its transaction receipt (`launch_mode`, `quote_asset_address`, `blockchainResult.transactionHash`); every on-chain field is derived from the factory's `PoolCreated` / `LaunchCreated` log, never from the client - POST /api/auth/accept-terms with `{ "stock_pairs": true }`: records the stock-pairs attestation on the user ## Contracts (Monad) Spec: [docs/pairs/CONTRACTS.md](https://github.com/blocklive/stagefun/blob/main/docs/pairs/CONTRACTS.md). Addresses: [src/lib/contracts/addresses.ts](https://github.com/blocklive/stagefun/blob/main/src/lib/contracts/addresses.ts). - **StageDotFunPoolFactory / StageDotFunPool** (rounds): mainnet factory v0.1.0 `0x99b7aa9DDb0634695473FD6159F0069aFb8Eb096` (USDC only). v0.2.0 adds a per-pool `depositToken` with an owner allowlist, decimal-safe LP mint, price-safe V4 seeding (`retrySeedLiquidity()` permissionless), OZ Pausable — built, on Monad testnet since 2026-10-09 (launchpad factory only; mainnet still v0.1.0). - **StagePairRegistry**: allow-listed pair assets (`enabled`, `decimals`, `kind`, oracle adapter, `maxOracleAge`, `allowClosedSession`, `maxRaiseQuote` per launch). - **StagePairFactory**: `launch(LaunchParams)` deploys token + curve clone, converts the tier's USD anchor to `H` in pair units, optional atomic snipe-exempt first buy; `previewLaunch(quote, tierId)`. - **StageBondingCurve** (one clone per launch): `buy(quoteIn, minTokensOut, recipient, deadline)`, `sell(tokensIn, minQuoteOut, recipient, deadline)`, `quoteBuy`, `quoteSell`, `getReserves`, `params()`, `readyToGraduate`, permissionless `graduate()` / `retryGraduation()`, `claimCreatorFees()`. - **StageLiquidityLocker**: holds the graduated V4 position forever; `collect(tokenId)` and `claim(tokenId)` stream LP fees creator / platform; `addRemainder(tokenId)` re-mints leftovers. - Pair assets: USDC `0x754704bc059f8c67012fed69bc8a327a5aafb603` (6 dec), WMON `0x3bd359c1119da7da1d913d1c4d2b7c461115433a` (18), aBIL `0x4fc5b9f8933597d3ecf84d0611687e1dc8dd576f` (18, Anchored). Anchored StockOracle `0x037848af338c38e1e0ab722be80bf4c2e612a1f7` (`latestPrice(keccak256(TICKER))`, session enum, stale over weekends). - Uniswap V4: PoolManager `0x188d586ddcf52439676ca21a244753fa19f9ea8e`, PositionManager `0x5b7ec4a94ff9bedb700fb82ab09d5846972f4016`. Graduated pools are hookless (fee 1%, tickSpacing 200) and routable on every Uniswap surface. ## Operations - [docs/pairs/OPERATIONS.md](https://github.com/blocklive/stagefun/blob/main/docs/pairs/OPERATIONS.md): registry roster, oracle / session guard, stock-fee treasury policy, deploy checklist, geofence and terms, incident playbook (stuck graduation, skipped round seeding) - [docs/pairs/00_STATUS.md](https://github.com/blocklive/stagefun/blob/main/docs/pairs/00_STATUS.md): what shipped in each PR, what is not deployed, open founder decisions - [docs/plans/pairs/00_PLAN.md](https://github.com/blocklive/stagefun/blob/main/docs/plans/pairs/00_PLAN.md) and [ADR-003](https://github.com/blocklive/stagefun/blob/main/docs/adr/003-per-launch-pair-asset-and-curve-launches.md): the design and its reasoning ## Authentication Stage.fun uses Privy. The agent flow is WalletConnect: 1. Open https://app.stage.fun/pools and click Login. While new accounts need an invite password, a Stage dialog comes first: an existing account clicks "Log in", a new one enters the invite password (ask your operator) and clicks "Create account". Then "Continue with a wallet", then "WalletConnect" 2. Copy the `wc:` URI and pair a WalletConnect-compatible wallet; the session namespace MUST include `eth_sendTransaction` and `personal_sign` or Privy silently rejects the pairing 3. Sign the SIWE challenge; save the session cookies 4. Privy creates an embedded wallet (pays gas — fund it with MON) and a smart wallet next to your external wallet Supported chains: eip155:143 (Monad mainnet), eip155:10143 (Monad testnet), eip155:1. WalletConnect URIs expire in about a minute. Do not retry login rapidly — each attempt may create a duplicate account. ## OpenClaw Skills Installable skills for OpenClaw agents. Each skill is a markdown file with step-by-step instructions and inline code; the raw files are served at https://app.stage.fun/skills/.md and described at https://app.stage.fun/docs/skills. - [Create Account / Login](https://app.stage.fun/skills/login.md): WalletConnect pairing, SIWE signing, cookie persistence, funding the embedded wallet - [Create a Round](https://app.stage.fun/skills/create-round.md): the 3-page create form incl. launch mode and pair-asset selector, tiers, on-chain deployment - [Commit to a Round](https://app.stage.fun/skills/commit.md): reading a round's pair asset, funding the wallet with it (USDC / MON / Monday Trade for stocks), approval, committing; geofence and attestation on stock pairs - [Curve Launches](https://app.stage.fun/skills/curve-launch.md): listing launches, quoting, buying and selling via the API and the curve contract, `params()` and the snipe schedule, graduation and fees, stock-pair gates, launching a curve ## For AI agents and bots - Authenticate via WalletConnect (not browser-extension injection); save cookies; respect rate limits - Read `quote_symbol` / `quote_decimals` / `launch_mode` before funding a wallet or building a transaction - On curve launches, wait out the snipe window unless you are exempt (`currentSnipeTaxBps(recipient)`) - Do not manipulate trading or front-run other users; identify yourself in your user agent or profile when possible ## Blockchain details - Network: Monad (EVM). Mainnet RPC https://rpc.monad.xyz (chain ID 143); testnet RPC https://testnet-rpc.monad.xyz (chain ID 10143) - Gas: MON. Pair assets: USDC, WMON (shown as MON), Anchored stock tokens - Token standard: ERC-20 (round culture coins 6 decimals; curve launch tokens 18 decimals) ## Optional - [Monad documentation](https://docs.monad.xyz): chain documentation - [Privy documentation](https://docs.privy.io): authentication - [WalletConnect docs](https://docs.walletconnect.com): protocol reference - [Anchored Finance](https://anchored.finance): issuer of the tokenized stocks used as pair assets - [Monday Trade](https://monday.trade): permissionless on-chain primary market for Anchored tokens on Monad - [Uniswap V4 docs](https://docs.uniswap.org/contracts/v4/overview): where graduated liquidity lives - [ERC-8004 spec](https://eips.ethereum.org/EIPS/eip-8004): trustless agents standard