proof-of-take-sdk 5.0.5 → 5.0.7

package/dist/idl/proof_of_take.json

@@ -311,12 +311,17 @@
           "name": "referral_penalty_claim",
           "writable": true
         },
+        {
+          "name": "launchpad_token_mint",
+          "docs": [
+            "Required for PDA derivation. Validated by Moonpool seeds constraint."
+          ]
+        },
         {
           "name": "moonpool",
           "docs": [
-            "Global Moonpool PDA (required when `season.is_moonpool()`).",
-            "The Moonpool is the Moon's seesaw for buying and selling stars (virtual tokens).",
-            "Shared across all seasons for this token mint."
+            "Moonpool PDA - unique per launchpad_token_mint (required when `season.is_moonpool()`).",
+            "The Moonpool is the Moon's seesaw for buying and selling stars (virtual tokens)."
           ],
           "writable": true,
           "optional": true,
@@ -337,7 +342,7 @@
               },
               {
                 "kind": "account",
-                "path": "token_mint"
+                "path": "launchpad_token_mint"
               },
               {
                 "kind": "const",
@@ -358,7 +363,7 @@
         {
           "name": "moonpool_treasury",
           "docs": [
-            "Shared across all seasons for this token mint.",
+            "Unique per launchpad_token_mint.",
             "",
             "Safety:",
             "- Address is constrained by PDA seeds.",
@@ -393,7 +398,7 @@
               },
               {
                 "kind": "account",
-                "path": "token_mint"
+                "path": "launchpad_token_mint"
               },
               {
                 "kind": "const",
@@ -664,12 +669,17 @@
             ]
           }
         },
+        {
+          "name": "launchpad_token_mint",
+          "docs": [
+            "Required for PDA derivation. Validated by Moonpool seeds constraint."
+          ]
+        },
         {
           "name": "moonpool",
           "docs": [
-            "Global Moonpool PDA (required when `season.is_moonpool()`).",
-            "The Moonpool is the Moon's seesaw for buying and selling stars (virtual tokens).",
-            "Shared across all seasons for this token mint."
+            "Moonpool PDA - unique per launchpad_token_mint (required when `season.is_moonpool()`).",
+            "The Moonpool is the Moon's seesaw for buying and selling stars (virtual tokens)."
           ],
           "writable": true,
           "optional": true,
@@ -690,7 +700,7 @@
               },
               {
                 "kind": "account",
-                "path": "token_mint"
+                "path": "launchpad_token_mint"
               },
               {
                 "kind": "const",
@@ -711,7 +721,7 @@
         {
           "name": "moonpool_treasury",
           "docs": [
-            "Shared across all seasons for this token mint.",
+            "Unique per launchpad_token_mint.",
             "",
             "Safety:",
             "- Address is constrained by PDA seeds.",
@@ -746,7 +756,7 @@
               },
               {
                 "kind": "account",
-                "path": "token_mint"
+                "path": "launchpad_token_mint"
               },
               {
                 "kind": "const",
@@ -1093,12 +1103,17 @@
           "name": "season_membership",
           "writable": true
         },
+        {
+          "name": "launchpad_token_mint",
+          "docs": [
+            "Required for PDA derivation. Validated by Moonpool seeds constraint."
+          ]
+        },
         {
           "name": "moonpool",
           "docs": [
-            "Global Moonpool PDA (required when `season.is_moonpool()`).",
-            "The Moonpool is the Moon's seesaw for buying and selling stars (virtual tokens).",
-            "Shared across all seasons for this token mint."
+            "Moonpool PDA - unique per launchpad_token_mint (required when `season.is_moonpool()`).",
+            "The Moonpool is the Moon's seesaw for buying and selling stars (virtual tokens)."
           ],
           "writable": true,
           "optional": true,
@@ -1119,7 +1134,7 @@
               },
               {
                 "kind": "account",
-                "path": "token_mint"
+                "path": "launchpad_token_mint"
               },
               {
                 "kind": "const",
@@ -1140,7 +1155,7 @@
         {
           "name": "moonpool_treasury",
           "docs": [
-            "Shared across all seasons for this token mint.",
+            "Unique per launchpad_token_mint.",
             "",
             "Safety:",
             "- Address is constrained by PDA seeds.",
@@ -1175,7 +1190,7 @@
               },
               {
                 "kind": "account",
-                "path": "token_mint"
+                "path": "launchpad_token_mint"
               },
               {
                 "kind": "const",
@@ -2921,10 +2936,13 @@
         {
           "name": "moonpool",
           "docs": [
-            "Global Moonpool PDA (shared across all seasons for this token mint).",
+            "Moonpool PDA - unique per launchpad_token_mint.",
             "The Moonpool is the Moon's seesaw for buying and selling stars (real SPL Token-2022 tokens).",
             "Contains reserve state for the constant-product AMM.",
             "",
+            "Each unique launchpad_token_mint creates a unique Moonpool, allowing multiple \"Stars\"",
+            "to coexist for the same token_mint.",
+            "",
             "SECURITY: This account is MANDATORY (not optional) to prevent bypassing the",
             "launchpad mode check. If a previous season was launchpad mode, subsequent",
             "seasons MUST also be launchpad mode - we enforce this by always checking",
@@ -2948,7 +2966,7 @@
               },
               {
                 "kind": "account",
-                "path": "token_mint"
+                "path": "launchpad_token_mint"
               },
               {
                 "kind": "const",
@@ -2969,7 +2987,7 @@
         {
           "name": "moonpool_treasury",
           "docs": [
-            "Shared across all seasons for this token mint.",
+            "Unique per launchpad_token_mint, paired with its corresponding Moonpool.",
             "",
             "SECURITY: This account is MANDATORY alongside the pool to ensure consistent",
             "mode validation across seasons.",
@@ -3006,7 +3024,7 @@
               },
               {
                 "kind": "account",
-                "path": "token_mint"
+                "path": "launchpad_token_mint"
               },
               {
                 "kind": "const",
@@ -3530,6 +3548,10 @@
         {
           "name": "symbol",
           "type": "string"
+        },
+        {
+          "name": "force_new_launchpad_mint",
+          "type": "bool"
         }
       ]
     },

package/dist/instructions/claimReferralPenaltyForWindow.d.ts

@@ -12,6 +12,11 @@ export interface ClaimReferralPenaltyForWindowOptions {
     seasonNumber: BN;
     /** Token mint this season is scoped to (used for PDA derivation). Defaults to MIZD_TOKEN_MINT. */
     tokenMint?: PublicKey;
+    /**
+     * SPL Token-2022 mint for the launchpad token (required for launchpad mode).
+     * Used for PDA derivation of moonpool and treasury.
+     */
+    launchpadTokenMint: PublicKey;
     windowNumber: WindowNumberLike;
     /** Tier number: 0=copper, 1=silver, 2=gold, 3=platinum, 4=mithril */
     tier: TierNumber;

package/dist/instructions/claimReferralPenaltyForWindow.js

@@ -7,6 +7,7 @@ const anchor_1 = require("@coral-xyz/anchor");
 const web3_js_1 = require("@solana/web3.js");
 const spl_token_1 = require("@solana/spl-token");
 const pdaManager_1 = require("../utils/pdaManager");
+const pdas_1 = require("../utils/pdas");
 const constants_1 = require("../utils/constants");
 const programHelpers_1 = require("../utils/programHelpers");
 const signerHelpers_1 = require("../utils/signerHelpers");
@@ -25,14 +26,18 @@ async function claimReferralPenaltyForWindow(options) {
         tier: options.tier,
         tokenMint,
     });
+    // Derive Moonpool and Treasury PDAs using the launchpadTokenMint
+    const [moonpoolPda] = (0, pdas_1.getMoonpoolPda)(options.launchpadTokenMint);
+    const [moonpoolTreasuryPda] = (0, pdas_1.getMoonpoolTreasuryPda)(options.launchpadTokenMint);
     const accounts = {
         seasonSettings: pdas.seasonSettings,
         season: pdas.season,
         seasonMembership: pdas.seasonMembership,
         userWindowParticipation: pdas.userWindowParticipation,
         referralPenaltyClaim: pdas.referralPenaltyClaim,
-        moonpool: launchpad ? pdas.moonpool : null,
-        moonpoolTreasury: launchpad ? pdas.moonpoolTreasury : null,
+        launchpadTokenMint: options.launchpadTokenMint,
+        moonpool: launchpad ? moonpoolPda : null,
+        moonpoolTreasury: launchpad ? moonpoolTreasuryPda : null,
         seasonDepositVault: launchpad ? null : pdas.seasonDepositVault,
         mizdMint: constants_1.MIZD_TOKEN_MINT,
         tokenMint,

package/dist/instructions/claimSignupRewards.d.ts

@@ -18,6 +18,11 @@ export interface ClaimSignupRewardsOptions {
     seasonNumber: BN;
     /** Token mint this season is scoped to (used for PDA derivation). Defaults to MIZD_TOKEN_MINT. */
     tokenMint?: PublicKey;
+    /**
+     * SPL Token-2022 mint for the launchpad token (required for launchpad mode).
+     * Used for PDA derivation of moonpool and treasury.
+     */
+    launchpadTokenMint: PublicKey;
     /** Tier number: 0=copper, 1=silver, 2=gold, 3=platinum, 4=mithril */
     tier: TierNumber;
     /** If true, claim uses launchpad mode (SOL payout; token accounts can be omitted). */

package/dist/instructions/claimSignupRewards.js

@@ -7,6 +7,7 @@ const anchor_1 = require("@coral-xyz/anchor");
 const web3_js_1 = require("@solana/web3.js");
 const spl_token_1 = require("@solana/spl-token");
 const pdaManager_1 = require("../utils/pdaManager");
+const pdas_1 = require("../utils/pdas");
 const constants_1 = require("../utils/constants");
 const programHelpers_1 = require("../utils/programHelpers");
 const signerHelpers_1 = require("../utils/signerHelpers");
@@ -34,11 +35,15 @@ async function claimSignupRewards(options) {
     const userMizdAta = launchpad
         ? null
         : (0, spl_token_1.getAssociatedTokenAddressSync)(constants_1.MIZD_TOKEN_MINT, options.user);
+    // Derive Moonpool and Treasury PDAs using the launchpadTokenMint
+    const [moonpoolPda] = (0, pdas_1.getMoonpoolPda)(options.launchpadTokenMint);
+    const [moonpoolTreasuryPda] = (0, pdas_1.getMoonpoolTreasuryPda)(options.launchpadTokenMint);
     const accounts = {
         seasonMembership: pdas.seasonMembership,
         season: pdas.season,
-        moonpool: launchpad ? pdas.moonpool : null,
-        moonpoolTreasury: launchpad ? pdas.moonpoolTreasury : null,
+        launchpadTokenMint: options.launchpadTokenMint,
+        moonpool: launchpad ? moonpoolPda : null,
+        moonpoolTreasury: launchpad ? moonpoolTreasuryPda : null,
         signupRewardsPda: pdas.signupRewardsPda,
         signupRewardsMizdAta,
         mizdMint: constants_1.MIZD_TOKEN_MINT,

package/dist/instructions/claimWindowRewards.d.ts

@@ -29,6 +29,11 @@ export interface ClaimWindowRewardsOptions {
     seasonNumber: BN;
     /** Token mint this season is scoped to (used for PDA derivation). Defaults to MIZD_TOKEN_MINT. */
     tokenMint?: PublicKey;
+    /**
+     * SPL Token-2022 mint for the launchpad token (required for launchpad mode).
+     * Used for PDA derivation of moonpool and treasury.
+     */
+    launchpadTokenMint: PublicKey;
     windowNumber: WindowNumberLike;
     /** Tier number: 0=copper, 1=silver, 2=gold, 3=platinum, 4=mithril */
     tier: TierNumber;

package/dist/instructions/claimWindowRewards.js

@@ -7,6 +7,7 @@ const anchor_1 = require("@coral-xyz/anchor");
 const spl_token_1 = require("@solana/spl-token");
 const web3_js_1 = require("@solana/web3.js");
 const pdaManager_1 = require("../utils/pdaManager");
+const pdas_1 = require("../utils/pdas");
 const constants_1 = require("../utils/constants");
 const programHelpers_1 = require("../utils/programHelpers");
 const signerHelpers_1 = require("../utils/signerHelpers");
@@ -34,14 +35,18 @@ async function claimWindowRewards(options) {
         tier: options.tier,
         tokenMint,
     });
+    // Derive Moonpool and Treasury PDAs using the launchpadTokenMint
+    const [moonpoolPda] = (0, pdas_1.getMoonpoolPda)(options.launchpadTokenMint);
+    const [moonpoolTreasuryPda] = (0, pdas_1.getMoonpoolTreasuryPda)(options.launchpadTokenMint);
     const accounts = {
         seasonSettings: pdas.seasonSettings,
         season: pdas.season,
         rewardWindow: pdas.rewardWindow,
         userWindowParticipation: pdas.userWindowParticipation,
         seasonMembership: pdas.seasonMembership,
-        moonpool: launchpad ? pdas.moonpool : null,
-        moonpoolTreasury: launchpad ? pdas.moonpoolTreasury : null,
+        launchpadTokenMint: options.launchpadTokenMint,
+        moonpool: launchpad ? moonpoolPda : null,
+        moonpoolTreasury: launchpad ? moonpoolTreasuryPda : null,
         seasonDepositVault: launchpad ? null : pdas.seasonDepositVault,
         mizdMint: constants_1.MIZD_TOKEN_MINT,
         tokenMint,

package/dist/instructions/joinSeason.d.ts

@@ -42,6 +42,13 @@ 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;

package/dist/instructions/joinSeason.js

@@ -9,6 +9,7 @@ const anchor_1 = require("@coral-xyz/anchor");
 const web3_js_1 = require("@solana/web3.js");
 const spl_token_1 = require("@solana/spl-token");
 const pdaManager_1 = require("../utils/pdaManager");
+const pdas_1 = require("../utils/pdas");
 const constants_1 = require("../utils/constants");
 const programHelpers_1 = require("../utils/programHelpers");
 const signerHelpers_1 = require("../utils/signerHelpers");
@@ -42,37 +43,37 @@ async function joinSeason(options) {
     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
+        // 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] First join - generated launchpad mint keypair:", launchpadTokenMintPubkey.toString());
+            console.log("[joinSeason] forceNewLaunchpadMint=true - generated new 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());
+            // For non-force mode, we need an existing launchpadTokenMint to find the moonpool
+            // Check currentAccounts first (for LiteSVM or optimistic updates)
+            let moonpoolData = options.currentAccounts?.moonpool ?? null;
+            if (moonpoolData && !moonpoolData.launchpadTokenMint.equals(web3_js_1.PublicKey.default)) {
+                // Use the launchpadTokenMint from the provided moonpool data
+                launchpadTokenMintPubkey = moonpoolData.launchpadTokenMint;
+                console.log("[joinSeason] Using launchpadTokenMint from currentAccounts:", launchpadTokenMintPubkey.toString());
+            }
+            else {
+                // No moonpool data provided - this is a first join scenario
+                // Generate a keypair for the mint (the mint will be created on-chain)
+                launchpadTokenMintKeypair = web3_js_1.Keypair.generate();
+                launchpadTokenMintPubkey = launchpadTokenMintKeypair.publicKey;
+                console.log("[joinSeason] First join - generated launchpad mint keypair:", launchpadTokenMintPubkey.toString());
+            }
         }
     }
     else {
         // Non-launchpad mode, use PDA
         launchpadTokenMintPubkey = pdasBase.launchpadTokenMint;
     }
+    // Derive Moonpool and Treasury PDAs using the launchpadTokenMint
+    const [moonpoolPda] = (0, pdas_1.getMoonpoolPda)(launchpadTokenMintPubkey);
+    const [moonpoolTreasuryPda] = (0, pdas_1.getMoonpoolTreasuryPda)(launchpadTokenMintPubkey);
     const rootAdminTokenAccount = launchpad
         ? null
         : (0, spl_token_1.getAssociatedTokenAddressSync)(constants_1.MIZD_TOKEN_MINT, constants_1.ADMIN_PUBLIC_KEY);
@@ -85,6 +86,8 @@ async function joinSeason(options) {
         : (0, spl_token_1.getAssociatedTokenAddressSync)(constants_1.MIZD_TOKEN_MINT, pdasBase.userJoinCredit, true);
     const pdas = {
         ...pdasBase,
+        moonpool: moonpoolPda,
+        moonpoolTreasury: moonpoolTreasuryPda,
         launchpadTokenMint: launchpadTokenMintPubkey,
         userJoinCreditVault: userJoinCreditVault ?? web3_js_1.PublicKey.default,
     };
@@ -95,8 +98,8 @@ async function joinSeason(options) {
         // SECURITY: Pool accounts are now MANDATORY (non-optional) to prevent bypassing
         // the mode check. The on-chain program validates pool state to ensure
         // subsequent seasons use the same mode (launchpad/classic) as the first season.
-        moonpool: pdas.moonpool,
-        moonpoolTreasury: pdas.moonpoolTreasury,
+        moonpool: moonpoolPda,
+        moonpoolTreasury: moonpoolTreasuryPda,
         launchpadTokenMint: pdas.launchpadTokenMint,
         sunpool: pdas.sunpool,
         seasonDepositVault: launchpad ? null : pdas.seasonDepositVault,
@@ -132,7 +135,7 @@ async function joinSeason(options) {
     const methodBuilder = program.methods
         // Anchor expects BN for u64 args.
         // referrerTier defaults to 0 if no referrer (ignored on-chain)
-        .joinSeason(options.seasonNumber, options.tier, referrer, options.referrerTier ?? 0, options.star ?? false, launchpad, options.maxSolInLamports ?? new anchor_1.BN(0), options.expectedSolInLamports ?? new anchor_1.BN(0), options.maxSlippageBps ?? 0, options.starFlagPrompt ?? "", options.symbol ?? "")
+        .joinSeason(options.seasonNumber, options.tier, referrer, options.referrerTier ?? 0, options.star ?? false, launchpad, options.maxSolInLamports ?? new anchor_1.BN(0), options.expectedSolInLamports ?? new anchor_1.BN(0), options.maxSlippageBps ?? 0, options.starFlagPrompt ?? "", options.symbol ?? "", options.forceNewLaunchpadMint ?? false)
         .accounts(accounts);
     if (remainingAccounts.length > 0) {
         methodBuilder.remainingAccounts(remainingAccounts);

package/dist/types/accountTypes.d.ts

@@ -84,6 +84,7 @@ export interface ClaimWindowRewardsAccounts {
     rewardWindow: PublicKey;
     userWindowParticipation: PublicKey;
     seasonMembership: PublicKey;
+    launchpadTokenMint: PublicKey;
     moonpool: PublicKey | null;
     moonpoolTreasury: PublicKey | null;
     seasonDepositVault: PublicKey | null;
@@ -101,6 +102,7 @@ export interface ClaimReferralPenaltyForWindowAccounts {
     seasonMembership: PublicKey;
     userWindowParticipation: PublicKey;
     referralPenaltyClaim: PublicKey;
+    launchpadTokenMint: PublicKey;
     moonpool: PublicKey | null;
     moonpoolTreasury: PublicKey | null;
     seasonDepositVault: PublicKey | null;
@@ -115,6 +117,7 @@ export interface ClaimReferralPenaltyForWindowAccounts {
 export interface ClaimSignupRewardsAccounts {
     seasonMembership: PublicKey;
     season: PublicKey;
+    launchpadTokenMint: PublicKey;
     moonpool: PublicKey | null;
     moonpoolTreasury: PublicKey | null;
     signupRewardsPda: PublicKey;

package/dist/types/proof_of_take.d.ts

@@ -317,12 +317,17 @@ export type ProofOfTake = {
                     "name": "referralPenaltyClaim";
                     "writable": true;
                 },
+                {
+                    "name": "launchpadTokenMint";
+                    "docs": [
+                        "Required for PDA derivation. Validated by Moonpool seeds constraint."
+                    ];
+                },
                 {
                     "name": "moonpool";
                     "docs": [
-                        "Global Moonpool PDA (required when `season.is_moonpool()`).",
-                        "The Moonpool is the Moon's seesaw for buying and selling stars (virtual tokens).",
-                        "Shared across all seasons for this token mint."
+                        "Moonpool PDA - unique per launchpad_token_mint (required when `season.is_moonpool()`).",
+                        "The Moonpool is the Moon's seesaw for buying and selling stars (virtual tokens)."
                     ];
                     "writable": true;
                     "optional": true;
@@ -343,7 +348,7 @@ export type ProofOfTake = {
                             },
                             {
                                 "kind": "account";
-                                "path": "tokenMint";
+                                "path": "launchpadTokenMint";
                             },
                             {
                                 "kind": "const";
@@ -364,7 +369,7 @@ export type ProofOfTake = {
                 {
                     "name": "moonpoolTreasury";
                     "docs": [
-                        "Shared across all seasons for this token mint.",
+                        "Unique per launchpad_token_mint.",
                         "",
                         "Safety:",
                         "- Address is constrained by PDA seeds.",
@@ -399,7 +404,7 @@ export type ProofOfTake = {
                             },
                             {
                                 "kind": "account";
-                                "path": "tokenMint";
+                                "path": "launchpadTokenMint";
                             },
                             {
                                 "kind": "const";
@@ -670,12 +675,17 @@ export type ProofOfTake = {
                         ];
                     };
                 },
+                {
+                    "name": "launchpadTokenMint";
+                    "docs": [
+                        "Required for PDA derivation. Validated by Moonpool seeds constraint."
+                    ];
+                },
                 {
                     "name": "moonpool";
                     "docs": [
-                        "Global Moonpool PDA (required when `season.is_moonpool()`).",
-                        "The Moonpool is the Moon's seesaw for buying and selling stars (virtual tokens).",
-                        "Shared across all seasons for this token mint."
+                        "Moonpool PDA - unique per launchpad_token_mint (required when `season.is_moonpool()`).",
+                        "The Moonpool is the Moon's seesaw for buying and selling stars (virtual tokens)."
                     ];
                     "writable": true;
                     "optional": true;
@@ -696,7 +706,7 @@ export type ProofOfTake = {
                             },
                             {
                                 "kind": "account";
-                                "path": "tokenMint";
+                                "path": "launchpadTokenMint";
                             },
                             {
                                 "kind": "const";
@@ -717,7 +727,7 @@ export type ProofOfTake = {
                 {
                     "name": "moonpoolTreasury";
                     "docs": [
-                        "Shared across all seasons for this token mint.",
+                        "Unique per launchpad_token_mint.",
                         "",
                         "Safety:",
                         "- Address is constrained by PDA seeds.",
@@ -752,7 +762,7 @@ export type ProofOfTake = {
                             },
                             {
                                 "kind": "account";
-                                "path": "tokenMint";
+                                "path": "launchpadTokenMint";
                             },
                             {
                                 "kind": "const";
@@ -1099,12 +1109,17 @@ export type ProofOfTake = {
                     "name": "seasonMembership";
                     "writable": true;
                 },
+                {
+                    "name": "launchpadTokenMint";
+                    "docs": [
+                        "Required for PDA derivation. Validated by Moonpool seeds constraint."
+                    ];
+                },
                 {
                     "name": "moonpool";
                     "docs": [
-                        "Global Moonpool PDA (required when `season.is_moonpool()`).",
-                        "The Moonpool is the Moon's seesaw for buying and selling stars (virtual tokens).",
-                        "Shared across all seasons for this token mint."
+                        "Moonpool PDA - unique per launchpad_token_mint (required when `season.is_moonpool()`).",
+                        "The Moonpool is the Moon's seesaw for buying and selling stars (virtual tokens)."
                     ];
                     "writable": true;
                     "optional": true;
@@ -1125,7 +1140,7 @@ export type ProofOfTake = {
                             },
                             {
                                 "kind": "account";
-                                "path": "tokenMint";
+                                "path": "launchpadTokenMint";
                             },
                             {
                                 "kind": "const";
@@ -1146,7 +1161,7 @@ export type ProofOfTake = {
                 {
                     "name": "moonpoolTreasury";
                     "docs": [
-                        "Shared across all seasons for this token mint.",
+                        "Unique per launchpad_token_mint.",
                         "",
                         "Safety:",
                         "- Address is constrained by PDA seeds.",
@@ -1181,7 +1196,7 @@ export type ProofOfTake = {
                             },
                             {
                                 "kind": "account";
-                                "path": "tokenMint";
+                                "path": "launchpadTokenMint";
                             },
                             {
                                 "kind": "const";
@@ -2927,10 +2942,13 @@ export type ProofOfTake = {
                 {
                     "name": "moonpool";
                     "docs": [
-                        "Global Moonpool PDA (shared across all seasons for this token mint).",
+                        "Moonpool PDA - unique per launchpad_token_mint.",
                         "The Moonpool is the Moon's seesaw for buying and selling stars (real SPL Token-2022 tokens).",
                         "Contains reserve state for the constant-product AMM.",
                         "",
+                        "Each unique launchpad_token_mint creates a unique Moonpool, allowing multiple \"Stars\"",
+                        "to coexist for the same token_mint.",
+                        "",
                         "SECURITY: This account is MANDATORY (not optional) to prevent bypassing the",
                         "launchpad mode check. If a previous season was launchpad mode, subsequent",
                         "seasons MUST also be launchpad mode - we enforce this by always checking",
@@ -2954,7 +2972,7 @@ export type ProofOfTake = {
                             },
                             {
                                 "kind": "account";
-                                "path": "tokenMint";
+                                "path": "launchpadTokenMint";
                             },
                             {
                                 "kind": "const";
@@ -2975,7 +2993,7 @@ export type ProofOfTake = {
                 {
                     "name": "moonpoolTreasury";
                     "docs": [
-                        "Shared across all seasons for this token mint.",
+                        "Unique per launchpad_token_mint, paired with its corresponding Moonpool.",
                         "",
                         "SECURITY: This account is MANDATORY alongside the pool to ensure consistent",
                         "mode validation across seasons.",
@@ -3012,7 +3030,7 @@ export type ProofOfTake = {
                             },
                             {
                                 "kind": "account";
-                                "path": "tokenMint";
+                                "path": "launchpadTokenMint";
                             },
                             {
                                 "kind": "const";
@@ -3536,6 +3554,10 @@ export type ProofOfTake = {
                 {
                     "name": "symbol";
                     "type": "string";
+                },
+                {
+                    "name": "forceNewLaunchpadMint";
+                    "type": "bool";
                 }
             ];
         },

package/dist/utils/pdas.d.ts

@@ -62,16 +62,16 @@ export declare function getUserWindowParticipationPda(seasonNumber: SeasonNumber
  */
 export declare function getSeasonDepositVaultPda(seasonNumber: SeasonNumberLike, tokenMint?: PublicKey): [PublicKey, number];
 /**
- * Derive the global Moonpool PDA (real SOL + real SPL Token-2022 reserves).
+ * Derive the Moonpool PDA (real SOL + real SPL Token-2022 reserves).
  * The Moonpool is the Moon's seesaw for buying and selling stars (real SPL Token-2022 tokens).
- * Shared across all seasons for a given token mint.
+ * Each unique launchpadTokenMint creates a unique Moonpool, allowing multiple "Stars" to coexist.
  */
-export declare function getMoonpoolPda(tokenMint?: PublicKey): [PublicKey, number];
+export declare function getMoonpoolPda(launchpadTokenMint: PublicKey): [PublicKey, number];
 /**
- * Derive the global MoonpoolTreasury PDA (system account holding real SOL).
- * Shared across all seasons for a given token mint.
+ * Derive the MoonpoolTreasury PDA (system account holding real SOL).
+ * Unique per launchpadTokenMint, paired with its corresponding Moonpool.
  */
-export declare function getMoonpoolTreasuryPda(tokenMint?: PublicKey): [PublicKey, number];
+export declare function getMoonpoolTreasuryPda(launchpadTokenMint: PublicKey): [PublicKey, number];
 /**
  * Derive the Launchpad Token Mint PDA (SPL Token-2022 mint).
  * The mint authority is the Moonpool PDA itself.

package/dist/utils/pdas.js

@@ -144,25 +144,25 @@ function getSeasonDepositVaultPda(seasonNumber, tokenMint = constants_1.MIZD_TOK
     ], constants_1.PROGRAM_ID);
 }
 /**
- * Derive the global Moonpool PDA (real SOL + real SPL Token-2022 reserves).
+ * Derive the Moonpool PDA (real SOL + real SPL Token-2022 reserves).
  * The Moonpool is the Moon's seesaw for buying and selling stars (real SPL Token-2022 tokens).
- * Shared across all seasons for a given token mint.
+ * Each unique launchpadTokenMint creates a unique Moonpool, allowing multiple "Stars" to coexist.
  */
-function getMoonpoolPda(tokenMint = constants_1.MIZD_TOKEN_MINT) {
+function getMoonpoolPda(launchpadTokenMint) {
     return web3_js_1.PublicKey.findProgramAddressSync([
         Buffer.from(constants_1.MOONPOOL_SEED),
-        tokenMint.toBuffer(),
+        launchpadTokenMint.toBuffer(),
         constants_1.SEASON_INSTANCE_ID.toArrayLike(Buffer, "le", 8),
     ], constants_1.PROGRAM_ID);
 }
 /**
- * Derive the global MoonpoolTreasury PDA (system account holding real SOL).
- * Shared across all seasons for a given token mint.
+ * Derive the MoonpoolTreasury PDA (system account holding real SOL).
+ * Unique per launchpadTokenMint, paired with its corresponding Moonpool.
  */
-function getMoonpoolTreasuryPda(tokenMint = constants_1.MIZD_TOKEN_MINT) {
+function getMoonpoolTreasuryPda(launchpadTokenMint) {
     return web3_js_1.PublicKey.findProgramAddressSync([
         Buffer.from(constants_1.MOONPOOL_TREASURY_SEED),
-        tokenMint.toBuffer(),
+        launchpadTokenMint.toBuffer(),
         constants_1.SEASON_INSTANCE_ID.toArrayLike(Buffer, "le", 8),
     ], constants_1.PROGRAM_ID);
 }

package/package.json

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