genesis-launch

name	genesis-launch
description	Launch tokens on Solana using Metaplex Genesis protocol

Metaplex Genesis Token Launch

You can help users launch tokens on Solana using the Metaplex Genesis protocol. Genesis enables fair, transparent token launches with built-in liquidity pool graduation.

What is Genesis?

Genesis is a token launch protocol on Solana by Metaplex. It supports:

• LaunchPool: Fair token distribution where users deposit SOL during a time window, then claim tokens proportionally based on their share of total deposits.
• Unlocked Buckets: Direct token allocation for team, treasury, or airdrops.
• Raydium CPMM Graduation: Automatically creates a Raydium liquidity pool with raised SOL and allocated tokens after the launch concludes.

Launch Lifecycle

1. Create the launch (genesis_create_launch) - sets up the token and Genesis account
2. Configure buckets - add LaunchPool, Unlocked, and/or Raydium buckets
3. Finalize (genesis_finalize_launch) - locks configuration, launch goes live
4. Users deposit SOL during the deposit period
5. After deposit period, SOL flows to Raydium and a liquidity pool is created
6. Users claim their tokens during the claim period

Recommended Flow

When a user wants to launch a token, gather this information:

1. Token details: name, symbol, description, and image file path
2. Total supply: how many tokens (default: 1 billion)
3. Allocation split: what percentage goes to launchpool vs liquidity vs team
   • Example: 60% launchpool / 20% Raydium liquidity / 20% team
4. Timing: when deposits open, how long they last, when claims start

Common Configuration: LaunchPool + Raydium + Team

This is the most common setup. Example with 60/20/20 split:

Step 1: genesis_create_launch
  - name, symbol, description, imagePath
  - totalSupply: 1000000000

Step 2: genesis_add_raydium_pool (add this FIRST so you know the bucket index)
  - tokenAllocationPercent: 20
  - bucketIndex: 0

Step 3: genesis_add_launchpool
  - tokenAllocationPercent: 60
  - depositDurationHours: 72 (3 days)
  - claimDurationHours: 168 (7 days)
  - sendQuoteTokenToRaydiumBucketIndex: 0
  - bucketIndex: 0

Step 4: genesis_add_unlocked
  - tokenAllocationPercent: 20
  - bucketIndex: 0

Step 5: genesis_finalize_launch
  - raydiumBucketIndexes: [0]
  - launchpoolBucketIndexes: [0]
  - unlockedBucketIndexes: [0]

Important Notes

• Token allocations across all buckets must sum to exactly 100%
• Add the Raydium bucket before the LaunchPool so you can reference its bucket index in the launchpool's sendQuoteTokenToRaydiumBucketIndex
• The Raydium pool creation costs 0.15 SOL
• Metadata (image + JSON) is uploaded to Arweave via Irys, paid from the wallet's SOL
• Use genesis_launch_status to check a launch's current state at any time

Wallet Setup

The plugin needs a Solana keypair. Users can configure it via:

• Plugin config: keypairPath pointing to a JSON keypair file
• Environment variable: SOLANA_KEYPAIR_PATH
• Default: ~/.config/solana/id.json

The wallet must have enough SOL for transaction fees, Irys uploads, and the Raydium pool creation fee.