---
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.