proof-of-take-sdk 5.0.3 → 5.0.5

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

@@ -1,5 +1,5 @@
 import { BN } from "@coral-xyz/anchor";
-import { Connection, PublicKey } from "@solana/web3.js";
+import { Connection, Keypair, PublicKey } from "@solana/web3.js";
 import { Season, SeasonMembership, SeasonSettings, TierNumber } from "../types";
 import { StandardInstructionResultWithPdas } from "../types/instructionResults";
 /**
@@ -48,6 +48,7 @@ export interface JoinSeasonOptions {
     currentAccounts?: {
         seasonSettings?: SeasonSettings;
         season?: Season;
+        moonpool?: any;
     };
 }
 /**
@@ -101,6 +102,10 @@ type JoinSeasonPdas = {
     userJoinCredit: PublicKey;
     userJoinCreditVault: PublicKey;
 };
+type JoinSeasonMeta = {
+    /** The keypair used for the launchpad mint (only set if auto-generated) */
+    launchpadTokenMintKeypair?: Keypair;
+};
 type JoinSeasonUpdatedAccounts = {
     seasonSettings?: SeasonSettings;
     season?: Season;
@@ -120,19 +125,19 @@ type JoinSeasonUpdatedAccounts = {
  * @param options - Join season options
  * @returns Instructions, signers, PDAs, and optimistically created/updated accounts
  */
-export declare function joinSeason(options: JoinSeasonOptions): Promise<StandardInstructionResultWithPdas<JoinSeasonPdas, JoinSeasonUpdatedAccounts>>;
+export declare function joinSeason(options: JoinSeasonOptions): Promise<StandardInstructionResultWithPdas<JoinSeasonPdas, JoinSeasonUpdatedAccounts, JoinSeasonMeta>>;
 /**
  * Convenience wrapper: classic (non-launchpad) joinSeason.
  * - Keeps the existing MIZD-based join behavior.
  * - App code never passes nullable optional accounts.
  */
-export declare function joinSeasonClassic(options: JoinSeasonClassicOptions): Promise<StandardInstructionResultWithPdas<JoinSeasonPdas, JoinSeasonUpdatedAccounts>>;
+export declare function joinSeasonClassic(options: JoinSeasonClassicOptions): Promise<StandardInstructionResultWithPdas<JoinSeasonPdas, JoinSeasonUpdatedAccounts, JoinSeasonMeta>>;
 /**
  * Convenience wrapper: launchpad joinSeason.
  * - Uses SOL in + virtual token escrow.
  * - App code never passes nullable optional accounts.
  */
-export declare function joinSeasonLaunchpad(options: JoinSeasonLaunchpadOptions): Promise<StandardInstructionResultWithPdas<JoinSeasonPdas, JoinSeasonUpdatedAccounts>>;
+export declare function joinSeasonLaunchpad(options: JoinSeasonLaunchpadOptions): Promise<StandardInstructionResultWithPdas<JoinSeasonPdas, JoinSeasonUpdatedAccounts, JoinSeasonMeta>>;
 /**
  * Join season AND initialize it (first joiner).
  * Use this when you know the season doesn't exist yet.
@@ -140,7 +145,7 @@ export declare function joinSeasonLaunchpad(options: JoinSeasonLaunchpadOptions)
  * @param options - Options with REQUIRED starFlagPrompt
  * @throws Error if starFlagPrompt is empty or exceeds 33 characters
  */
-export declare function joinSeasonAndInitialize(options: JoinSeasonAndInitializeOptions): Promise<StandardInstructionResultWithPdas<JoinSeasonPdas, JoinSeasonUpdatedAccounts>>;
+export declare function joinSeasonAndInitialize(options: JoinSeasonAndInitializeOptions): Promise<StandardInstructionResultWithPdas<JoinSeasonPdas, JoinSeasonUpdatedAccounts, JoinSeasonMeta>>;
 /**
  * Join season AND initialize it in launchpad mode (first joiner).
  * Use this when you know the season doesn't exist yet and want launchpad mode.
@@ -150,5 +155,5 @@ export declare function joinSeasonAndInitialize(options: JoinSeasonAndInitialize
  */
 export declare function joinSeasonLaunchpadAndInitialize(options: Omit<JoinSeasonLaunchpadOptions, "starFlagPrompt"> & {
     starFlagPrompt: string;
-}): Promise<StandardInstructionResultWithPdas<JoinSeasonPdas, JoinSeasonUpdatedAccounts>>;
+}): Promise<StandardInstructionResultWithPdas<JoinSeasonPdas, JoinSeasonUpdatedAccounts, JoinSeasonMeta>>;
 export {};

package/dist/instructions/joinSeason.js

@@ -38,6 +38,41 @@ async function joinSeason(options) {
         tier: options.tier,
         tokenMint,
     });
+    // Auto-generate keypair for launchpad mode when moonpool is being initialized
+    let launchpadTokenMintKeypair;
+    let launchpadTokenMintPubkey;
+    if (launchpad) {
+        // 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;
+            }
+        }
+        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] 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());
+        }
+    }
+    else {
+        // Non-launchpad mode, use PDA
+        launchpadTokenMintPubkey = pdasBase.launchpadTokenMint;
+    }
     const rootAdminTokenAccount = launchpad
         ? null
         : (0, spl_token_1.getAssociatedTokenAddressSync)(constants_1.MIZD_TOKEN_MINT, constants_1.ADMIN_PUBLIC_KEY);
@@ -50,6 +85,7 @@ async function joinSeason(options) {
         : (0, spl_token_1.getAssociatedTokenAddressSync)(constants_1.MIZD_TOKEN_MINT, pdasBase.userJoinCredit, true);
     const pdas = {
         ...pdasBase,
+        launchpadTokenMint: launchpadTokenMintPubkey,
         userJoinCreditVault: userJoinCreditVault ?? web3_js_1.PublicKey.default,
     };
     const accounts = {
@@ -105,7 +141,16 @@ async function joinSeason(options) {
     // For star joins, make the transaction fully sponsored: force the fee payer to be the root admin.
     // This prevents clients from accidentally using an unfunded/nonexistent fee payer account.
     const feePayer = options.star ? constants_1.ADMIN_PUBLIC_KEY : (0, signerHelpers_1.getDefaultFeePayer)(options.feePayer);
-    const signers = (0, signerHelpers_1.buildSigners)([(0, signerHelpers_1.asAdminSigner)(constants_1.ADMIN_PUBLIC_KEY), (0, signerHelpers_1.asUserSigner)(options.user)], feePayer);
+    // Build signers array
+    const signersList = [(0, signerHelpers_1.asAdminSigner)(constants_1.ADMIN_PUBLIC_KEY), (0, signerHelpers_1.asUserSigner)(options.user)];
+    // Add launchpad token mint keypair as signer if it exists (either provided or auto-generated)
+    if (launchpad && launchpadTokenMintKeypair) {
+        signersList.push({
+            publicKey: launchpadTokenMintKeypair.publicKey,
+            role: "payer", // Use 'payer' role for the mint keypair
+        });
+    }
+    const signers = (0, signerHelpers_1.buildSigners)(signersList, feePayer);
     // OPTIMISTIC UPDATES
     const curr = options.currentAccounts || {};
     const now = (0, optimistic_1.getCurrentTimestamp)(options.now);
@@ -148,6 +193,13 @@ async function joinSeason(options) {
                 },
             }
             : {}),
+        ...(launchpadTokenMintKeypair
+            ? {
+                meta: {
+                    launchpadTokenMintKeypair,
+                },
+            }
+            : {}),
     };
 }
 /**

package/package.json

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