proof-of-take-sdk 5.0.3 → 5.0.4

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";
 /**
@@ -21,6 +21,16 @@ 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;
     /**
@@ -101,6 +111,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 +134,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 +154,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 +164,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,33 @@ async function joinSeason(options) {
         tier: options.tier,
         tokenMint,
     });
+    // Auto-generate keypair for launchpad mode if not provided
+    let launchpadTokenMintKeypair = options.launchpadTokenMintKeypair;
+    let launchpadTokenMintPubkey;
+    if (launchpad) {
+        if (launchpadTokenMintKeypair) {
+            // Use provided keypair
+            launchpadTokenMintPubkey = launchpadTokenMintKeypair.publicKey;
+        }
+        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;
+            }
+            else {
+                // Mint doesn't exist, generate a new keypair
+                launchpadTokenMintKeypair = web3_js_1.Keypair.generate();
+                launchpadTokenMintPubkey = launchpadTokenMintKeypair.publicKey;
+                console.log("[joinSeason] Auto-generated launchpad mint keypair:", 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 +77,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 +133,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 +185,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.4",
   "description": "TypeScript SDK for Proof of Take Solana program",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",