Genesis Launch

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.