Ansem Launch Documentation

Ansem Launch is a token launch protocol built on Solana. It enables one-click token launches with Meteora DBC bonding curves, automatic migration to Meteora DAMM v2 pools, and a reward system powered by the ANSEM token.

Quick Start

# Clone and install
git clone https://github.com/ansem/ansem-launch.git
cd ansem-launch
npm install --legacy-peer-deps

# Set up environment
cp .env.example .env.local
# Edit .env.local with your values

# Start database
docker compose up -d postgres redis

# Run migrations
npm run db:generate --filter=@ansem/database
npm run db:push --filter=@ansem/database
npm run db:seed --filter=@ansem/database

# Start development
npm run dev

Architecture

The platform is built as a monorepo with Turborepo:

  • apps/web — Next.js 15 frontend + API routes
  • packages/database — Prisma schema + client
  • packages/types — Shared TypeScript types
  • packages/config — Shared configuration
  • packages/solana-sdk — Solana program interactions
  • workers/keeper — Background job processor (BullMQ)
  • programs/* — Anchor Solana programs

Launch Flow

  1. Creator configures token parameters (name, symbol, supply, price)
  2. Transaction creates an SPL token and initializes a Meteora DBC pool
  3. Anti-sniper protection bundles token creation + initial buy via Jito
  4. Users can buy/sell tokens through the bonding curve
  5. Each transaction swaps a percentage to ANSEM (Jupiter)
  6. When migration conditions are met, pool migrates to DAMM v2

Authentication

All authenticated endpoints require a session cookie obtained via wallet signature verification:

POST /api/v1/auth/nonce  { "wallet": "..." }
POST /api/v1/auth/verify { "wallet": "...", "signature": "...", "nonce": "..." }

Launches API

GET  /api/v1/launches          # List launches
POST /api/v1/launches          # Create launch
GET  /api/v1/launches/:id      # Get launch details
GET  /api/v1/launches/:id/stats # Launch statistics

Webhooks

The platform sends webhook events for key lifecycle events:

  • launch.created — A new token launch is created
  • launch.migrated — Liquidity migrated to DAMM v2
  • launch.cancelled — Launch was cancelled
  • reward.distributed — Rewards epoch completed

Webhooks are delivered with retry (5s, 15s, 60s, 5m, 30m backoff).

OpenAPI Specification

The full OpenAPI spec is available at /api/openapi.yaml and in the repository at docs/openapi.yaml.

Ansem Launch