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.