Launch tokens on Solana using Metaplex Genesis protocol
---
name: genesis-launch
description: Launch tokens on Solana using Metaplex Genesis protocol
metadata:
openclaw:
emoji: "\U0001F680"
requires:
config:
- "plugins.entries.genesis.enabled"
---
# 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.
don't have the plugin yet? install it then click "run inline in claude" again.