proof-of-take-sdk 5.0.4 → 5.0.6

package/README.md

@@ -339,6 +339,42 @@ await claimReward(program, {
 
 ---
 
+## Launchpad Integration (Moonpool/Sunpool)
+
+For bot developers integrating the launchpad functionality with automatic keypair generation, see the comprehensive guide:
+
+**📘 [LAUNCHPAD_BOT_INTEGRATION.md](../LAUNCHPAD_BOT_INTEGRATION.md)**
+
+### Quick Example
+
+```typescript
+import { joinSeason } from "@proof-of-miztake/sdk";
+import { BN } from "@coral-xyz/anchor";
+
+// Call joinSeason with launchpad mode
+const result = await joinSeason({
+  connection,
+  user: userPublicKey,
+  seasonNumber: new BN(1),
+  tier: 4,
+  launchpad: true,  // Enable launchpad mode
+});
+
+// ✅ CRITICAL: Extract and use the auto-generated keypair
+const signers = [adminWallet, userWallet];
+if (result.meta?.launchpadTokenMintKeypair) {
+  signers.push(result.meta.launchpadTokenMintKeypair);
+  console.log("Added launchpad mint keypair");
+}
+
+// Sign and send transaction with all signers
+tx.sign(...signers);
+```
+
+**Important:** The SDK auto-generates the launchpad mint keypair, but your bot must extract it from `result.meta.launchpadTokenMintKeypair` and include it when signing the transaction. See the full guide for details.
+
+---
+
 ## Building from Source
 
 ```bash

package/dist/instructions/joinSeason.d.ts

@@ -21,16 +21,6 @@ export interface JoinSeasonOptions {
     star?: boolean;
     /** If true, join uses launchpad mode (SOL in, virtual tokens escrowed; no SPL token accounts needed). */
     launchpad?: boolean;
-    /**
-     * Launchpad token mint keypair. OPTIONAL.
-     *
-     * - If NOT provided and launchpad=true: SDK will automatically generate a new keypair
-     *   for the mint and return it in the result.
-     * - If provided: SDK will use this keypair (useful for testing with specific keys).
-     *
-     * The SDK automatically adds the keypair as a signer to the transaction.
-     */
-    launchpadTokenMintKeypair?: Keypair;
     /** Launchpad slippage cap (lamports). Only used when launchpad=true. Defaults to u64::MAX. */
     maxSolInLamports?: BN;
     /**
@@ -52,12 +42,20 @@ export interface JoinSeasonOptions {
      * Only used when initializing a new pool (first join). Ignored when joining existing season.
      */
     symbol?: string;
+    /**
+     * Force generating a new launchpad token mint keypair, even if a moonpool already exists on-chain.
+     * Use this when creating a NEW Moonpool (i.e., the on-chain moonpool account may exist but was
+     * never fully initialized, or you want to start fresh with a new token mint).
+     * Only applies to launchpad mode.
+     */
+    forceNewLaunchpadMint?: boolean;
     /** Optional injected timestamp (seconds) for optimistic state calculation */
     now?: BN;
     feePayer?: PublicKey;
     currentAccounts?: {
         seasonSettings?: SeasonSettings;
         season?: Season;
+        moonpool?: any;
     };
 }
 /**

package/dist/instructions/joinSeason.js

@@ -38,26 +38,42 @@ async function joinSeason(options) {
         tier: options.tier,
         tokenMint,
     });
-    // Auto-generate keypair for launchpad mode if not provided
-    let launchpadTokenMintKeypair = options.launchpadTokenMintKeypair;
+    // Auto-generate keypair for launchpad mode when moonpool is being initialized
+    let launchpadTokenMintKeypair;
     let launchpadTokenMintPubkey;
     if (launchpad) {
-        if (launchpadTokenMintKeypair) {
-            // Use provided keypair
+        // If forceNewLaunchpadMint is set, skip on-chain checks and always generate a new keypair
+        if (options.forceNewLaunchpadMint) {
+            launchpadTokenMintKeypair = web3_js_1.Keypair.generate();
             launchpadTokenMintPubkey = launchpadTokenMintKeypair.publicKey;
+            console.log("[joinSeason] forceNewLaunchpadMint=true - generated new launchpad mint keypair:", launchpadTokenMintPubkey.toString());
         }
         else {
-            // Check if mint account already exists
-            const mintAccountInfo = await options.connection.getAccountInfo(pdasBase.launchpadTokenMint);
-            if (mintAccountInfo) {
-                // Mint already exists, use the existing PDA address
-                launchpadTokenMintPubkey = pdasBase.launchpadTokenMint;
+            // Check if moonpool is already initialized
+            // First check currentAccounts (for LiteSVM or optimistic updates)
+            let moonpoolData = options.currentAccounts?.moonpool ?? null;
+            // If not provided, try to fetch it from the network
+            if (!moonpoolData) {
+                try {
+                    moonpoolData = await program.account.moonpool.fetch(pdasBase.moonpool);
+                    console.log("[joinSeason] Moonpool data fetched, launchpadTokenMint:", moonpoolData.launchpadTokenMint.toString());
+                }
+                catch (error) {
+                    // Moonpool doesn't exist (first join scenario) or network error - treat as first join
+                    moonpoolData = null;
+                }
             }
-            else {
-                // Mint doesn't exist, generate a new keypair
+            if (!moonpoolData || moonpoolData.launchpadTokenMint.equals(web3_js_1.PublicKey.default)) {
+                // Moonpool doesn't exist yet (first join) - generate a keypair for the mint
+                // The mint will be created and stored in the moonpool during initialization
                 launchpadTokenMintKeypair = web3_js_1.Keypair.generate();
                 launchpadTokenMintPubkey = launchpadTokenMintKeypair.publicKey;
-                console.log("[joinSeason] Auto-generated launchpad mint keypair:", launchpadTokenMintPubkey.toString());
+                console.log("[joinSeason] First join - generated launchpad mint keypair:", launchpadTokenMintPubkey.toString());
+            }
+            else {
+                // Moonpool is already initialized - use the mint address stored in moonpool
+                launchpadTokenMintPubkey = moonpoolData.launchpadTokenMint;
+                console.log("[joinSeason] Moonpool exists - using stored mint address:", launchpadTokenMintPubkey.toString());
             }
         }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "proof-of-take-sdk",
-  "version": "5.0.4",
+  "version": "5.0.6",
   "description": "TypeScript SDK for Proof of Take Solana program",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",