Sui Memecoin Launchpad

A production-grade launchpad for creating and distributing memecoins on Sui. This repository focuses on robust token lifecycle management, fair and transparent price discovery, and secure participant flows — purpose-built for on-chain communities and creators.

What this is

An on-chain system (Move smart contracts + optional backend/frontend) that standardizes how new tokens are created, priced, distributed, and supported after launch. It emphasizes safety, fairness, and extensibility while keeping UX simple for creators and buyers.

Core Concepts

• Project: A configurable bundle describing a token launch (supply, pricing curve, fees, caps, timelines, vesting).
• Token: A Sui coin with canonical metadata and supply controls managed by the launchpad.
• Market: Price discovery mechanism (bonding curve, fixed price, or auction) selected per project.
• Participation: Buyer actions (commit, buy, claim, redeem) governed by project state and rules.
• Treasury: Fee routing (protocol fee, creator fee, LP provisioning) and custody logic.

Architecture (high-level)

• Move modules (core)
  • Projects: create/update lifecycle state; validate invariants; emit events
  • Tokens: minting rights; supply bounds; metadata registration; freeze/lock
  • Markets: pricing policy abstraction; fair launch curve; fixed price; auction hooks
  • Escrow: commitment custody; claim windows; refunds; vesting streams
  • Fees: protocol fee schedule; creator fee splits; LP bootstrap
• Frontend (optional): creation wizard, allowlist upload, live sale dashboard, claim portal
• Backend (optional): indexing events, analytics, allowlist proofs, anti-bot heuristics

Token Lifecycle

1. Draft: Creator configures token metadata, supply cap, pricing model, allowlist, timelines, fee splits
2. Registered: Config sealed; project ID emitted; public preview opens
3. Sale/Discovery: Participants commit/buy based on pricing policy (curve, fixed, or auction)
4. Settlement: Funds routed to treasuries; vesting schedules initialized; LP optionally bootstrapped
5. Post‑launch: Claims unlock; vesting continues; governance and upgrades remain possible via admin keys or DAO

Pricing & Distribution Models

• Fair Launch Bonding Curve
  • Continuous price function; early buys raise price; transparent slippage
  • Anti‑MEV and rate‑limits via per‑tx caps and time‑weighted adjustments
• Fixed Price (FCFS or Allowlisted)
  • Supply tranche with max per address; configurable allowlist/merkle proofs
• Auction (Dutch/English)
  • Market‑driven price discovery; settlement rules encoded in Move

Safety & Integrity

• Invariant enforcement: Supply caps, time windows, price monotonicity, and one‑time actions guarded on‑chain
• Allowlists: Merkle proofs or off‑chain attestations; optional KYC gating via signature authority
• Anti‑bot features: Per‑block/period caps, cool‑downs, signature replay protection, optional captcha attestation
• Fail‑safe exits: Creator cannot withdraw committed funds in violation of settlement rules; buyer refunds on failed launches
• Auditability: All critical transitions emit events; indexable for public transparency

Fees & Treasury

• Protocol fee: Basis points on commitments or settlements routed to protocol treasury
• Creator fee: Configurable revenue share; optional streaming to team vesting vaults
• LP bootstrap: Portion of proceeds paired with tokens to seed a DEX pool post‑launch (config‑driven)

Extensibility

• Pluggable pricing: Implement new pricing policies behind the Markets interface
• Custom vesting: Add cliffs/linear schedules; revoke/extend hooks
• Governance: Upgrade paths via admin capability, DAO, or timelock patterns
• Integrations: DEX LP, launch badges/NFTs, referral systems, affiliate rewards

Event Model (selected)

• ProjectCreated(project_id, creator, config_hash)
• SaleOpened(project_id, market)
• Commitment(project_id, buyer, amount_base, price_snapshot)
• Settlement(project_id, proceeds_base, tokens_minted)
• Claimed(project_id, buyer, amount_token)
• Refunded(project_id, buyer, amount_base)

Threat Model (abridged)

• Reentrancy and cross‑module calls are minimized; functions use explicit capability checks
• Arithmetic under/overflow guarded; price math bounded; caps enforced on inputs
• Front‑running reduced via caps, randomized blocks, and (optionally) off‑chain match windows
• Admin keys scoped to narrow powers; emergency pause/close paths are explicitly defined

Roadmap

• Advanced auctions (batch clearing, sealed‑bid)
• Gas‑efficient allowlist proofs and off‑chain attesters
• First‑class LP seeding flows and post‑launch liquidity protections
• Creator reputation and trust signals (verifications, audits)
• Reference analytics subgraph/indexer

Why Sui + Move

Move’s resource model fits token lifecycles: capabilities encode rights; resources prevent accidental duplication; explicit transfer semantics make custody and vesting clear. Sui’s object‑centric design enables composable, auditable state transitions ideal for public token launches.

---

For collaborations, audits, or integrations, please reach out: 📬 Telegram @lorine93s