EpicLaunch Documentation

Welcome to the EpicLaunch docs. This platform lets you launch Solana tokens with a bonding curve, real royalties, and on-chain analytics. No backend database is required for core trading/royalty features; everything reads from-chain.

Core Concepts

  • Launch Program (Anchor 0.31.1): Stores token metadata, bonding curve reserves, and royalty accounting in a PDA per mint.
  • Royalties: 2% total fee on buys/sellsโ€”1% to platform treasury, 1% to social royalty pool configured by the creator.
  • Migration: When threshold reached, curve migrates to Raydium with SOL and remaining tokens. Liquidity SOL is burned.

Key On-chain Accounts

  • Launch account per token: name, symbol, uri, reserves, total_supply, created_at, total_royalties_in, creator_claimed, social_claimed, social_share_bps, etc.
  • launch_vault PDA (mint-seeded)
  • royalty_vault PDA (mint-seeded)

Useful API Endpoints

  • /api/launches โ€” List Launch accounts from-chain with sorting/paging and computed metrics.
  • /api/home/stats โ€” Aggregated stats for homepage (tokens launched, active users, total volume, royalties paid).
  • /api/trading/sol-price โ€” Live SOL/USD (CoinGecko/Coinbase/Binance with fallback).
  • /api/royalties/creator/balance โ€” Creator claimable per connected wallet.
  • /api/royalties/creator/claim โ€” Claim creator royalties.
  • /api/royalties/social/balance โ€” Social royalty pool/claimable for verified user.
  • /api/royalties/social/claim โ€” Claim social royalties (attested by platform authority).

Frontend Pages

  • Launch: Create token with metadata and seeds (EPIC) PDA derivation.
  • Explore: Browse tokens from /api/launches with server-side sort/paging.
  • Portfolio: Holdings/Trades and Royalties tabs. Royalties shows creator and social claims.
  • Token: Token detail, price/marketcap, curve, analytics, and trading data.

Environment

  • NEXT_PUBLIC_RPC_URL, NEXT_PUBLIC_TOKEN_LAUNCHPAD_PROGRAM_ID
  • NEXT_PUBLIC_SOL_PRICE_USD fallback for price