proof-of-take-sdk 5.0.6 → 5.0.8

package/dist/getters/getSeasonLaunchpadPool.d.ts

@@ -22,10 +22,13 @@ export type LaunchpadPoolView = {
  * Shared across all seasons for this token mint.
  * @deprecated Use getMoonpool instead
  */
-export declare function getSeasonLaunchpadPool(connection: Connection, seasonNumber: BN, tokenMint?: PublicKey): Promise<LaunchpadPoolView>;
+export declare function getSeasonLaunchpadPool(connection: Connection, seasonNumber: BN, launchpadTokenMint: PublicKey): Promise<LaunchpadPoolView>;
 /**
  * View the global Moonpool status (spot price, reserves, k).
  * The Moonpool is the Moon's seesaw for buying and selling stars (virtual tokens).
- * Shared across all seasons for this token mint.
+ * Unique per launchpadTokenMint - each Moonpool has its own Season and reserves.
+ * @param connection - Solana connection
+ * @param seasonNumber - The season number
+ * @param launchpadTokenMint - The launchpad token mint (unique per Moonpool)
  */
-export declare function getMoonpool(connection: Connection, seasonNumber: BN, tokenMint?: PublicKey): Promise<LaunchpadPoolView>;
+export declare function getMoonpool(connection: Connection, seasonNumber: BN, launchpadTokenMint: PublicKey): Promise<LaunchpadPoolView>;

package/dist/getters/getSeasonLaunchpadPool.js

@@ -13,25 +13,29 @@ const pdas_1 = require("../utils/pdas");
  * Shared across all seasons for this token mint.
  * @deprecated Use getMoonpool instead
  */
-async function getSeasonLaunchpadPool(connection, seasonNumber, tokenMint = constants_1.MIZD_TOKEN_MINT) {
-    return getMoonpool(connection, seasonNumber, tokenMint);
+async function getSeasonLaunchpadPool(connection, seasonNumber, launchpadTokenMint) {
+    return getMoonpool(connection, seasonNumber, launchpadTokenMint);
 }
 /**
  * View the global Moonpool status (spot price, reserves, k).
  * The Moonpool is the Moon's seesaw for buying and selling stars (virtual tokens).
- * Shared across all seasons for this token mint.
+ * Unique per launchpadTokenMint - each Moonpool has its own Season and reserves.
+ * @param connection - Solana connection
+ * @param seasonNumber - The season number
+ * @param launchpadTokenMint - The launchpad token mint (unique per Moonpool)
  */
-async function getMoonpool(connection, seasonNumber, tokenMint = constants_1.MIZD_TOKEN_MINT) {
+async function getMoonpool(connection, seasonNumber, launchpadTokenMint) {
     const program = (0, programHelpers_1.getProgram)(connection);
-    const [season] = (0, pdas_1.getSeasonPda)(seasonNumber, tokenMint);
-    // Global PDAs (no seasonNumber in derivation)
-    const [moonpool] = (0, pdas_1.getMoonpoolPda)(tokenMint);
-    const [moonpoolTreasury] = (0, pdas_1.getMoonpoolTreasuryPda)(tokenMint);
+    // Season PDA uses launchpadTokenMint for Moonpool mode
+    const [season] = (0, pdas_1.getSeasonPda)(seasonNumber, constants_1.MIZD_TOKEN_MINT, launchpadTokenMint);
+    // Moonpool and treasury PDAs are scoped to launchpadTokenMint
+    const [moonpool] = (0, pdas_1.getMoonpoolPda)(launchpadTokenMint);
+    const [moonpoolTreasury] = (0, pdas_1.getMoonpoolTreasuryPda)(launchpadTokenMint);
     const view = await program.methods
         .viewLaunchpadPool(seasonNumber)
         // Anchor's generated `.accounts` typing for `.view()` is sometimes overly strict;
         // provide the correct accounts and cast to avoid leaking this complexity to callers.
-        .accounts({ season, moonpool, moonpoolTreasury, tokenMint })
+        .accounts({ season, moonpool, moonpoolTreasury, tokenMint: launchpadTokenMint })
         .view();
     // Anchor returns u128 as BN (and u64/i64 as BN).
     return {

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.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");
@@ -49,38 +50,30 @@ async function joinSeason(options) {
             console.log("[joinSeason] forceNewLaunchpadMint=true - generated new launchpad mint keypair:", launchpadTokenMintPubkey.toString());
         }
         else {
-            // Check if moonpool is already initialized
-            // First check currentAccounts (for LiteSVM or optimistic updates)
+            // 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 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)) {
+                // Use the launchpadTokenMint from the provided moonpool data
+                launchpadTokenMintPubkey = moonpoolData.launchpadTokenMint;
+                console.log("[joinSeason] Using launchpadTokenMint from currentAccounts:", launchpadTokenMintPubkey.toString());
             }
-            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
+            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 {
-                // 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;
     }
+    // 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);
@@ -93,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,
     };
@@ -103,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,
@@ -140,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

@@ -23,14 +23,18 @@ export declare function getMiztakePda(shaHash: Sha256HexString | string): [Publi
  */
 export declare function getSeasonSettingsPda(): [PublicKey, number];
 /**
- * Derive the Season PDA for a given season number
+ * Derive the Season PDA for a given season number.
+ * For Moonpool mode, pass launchpadTokenMint to scope the Season to a specific Moonpool.
  * @param seasonNumber - The season number
+ * @param tokenMint - The token mint (MIZD) - used only if launchpadTokenMint is not provided
+ * @param launchpadTokenMint - The launchpad token mint (unique per Moonpool) - use this for Moonpool mode
  */
-export declare function getSeasonPda(seasonNumber: SeasonNumberLike, tokenMint?: PublicKey): [PublicKey, number];
+export declare function getSeasonPda(seasonNumber: SeasonNumberLike, tokenMint?: PublicKey, launchpadTokenMint?: PublicKey): [PublicKey, number];
 /**
- * Derive the SeasonMembership PDA
+ * Derive the SeasonMembership PDA.
+ * For Moonpool mode, pass launchpadTokenMint to scope the membership to a specific Moonpool.
  * PDA model:
- *   seeds = ["season_membership", season_number_le_u64, user_pubkey_bytes, tier_u8]
+ *   seeds = ["season_membership", mint_pubkey, instance_id, season_number_le_u64, user_pubkey_bytes, tier_u8]
  *
  * Tier mapping (u8):
  * 0 = copper, 1 = silver, 2 = gold, 3 = platinum, 4 = mithril
@@ -38,8 +42,10 @@ export declare function getSeasonPda(seasonNumber: SeasonNumberLike, tokenMint?:
  * @param seasonNumber - The season number
  * @param user - The user's public key
  * @param tier - Tier number (0..=4)
+ * @param tokenMint - The token mint (MIZD) - used only if launchpadTokenMint is not provided
+ * @param launchpadTokenMint - The launchpad token mint (unique per Moonpool) - use this for Moonpool mode
  */
-export declare function getSeasonMembershipPda(seasonNumber: SeasonNumberLike, user: PublicKey, tier: TierNumber, tokenMint?: PublicKey): [PublicKey, number];
+export declare function getSeasonMembershipPda(seasonNumber: SeasonNumberLike, user: PublicKey, tier: TierNumber, tokenMint?: PublicKey, launchpadTokenMint?: PublicKey): [PublicKey, number];
 /**
  * Derive the RewardWindow PDA
  * @param seasonNumber - The season number
@@ -62,16 +68,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

@@ -57,22 +57,28 @@ function getSeasonSettingsPda() {
     return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("season_settings")], constants_1.PROGRAM_ID);
 }
 /**
- * Derive the Season PDA for a given season number
+ * Derive the Season PDA for a given season number.
+ * For Moonpool mode, pass launchpadTokenMint to scope the Season to a specific Moonpool.
  * @param seasonNumber - The season number
+ * @param tokenMint - The token mint (MIZD) - used only if launchpadTokenMint is not provided
+ * @param launchpadTokenMint - The launchpad token mint (unique per Moonpool) - use this for Moonpool mode
  */
-function getSeasonPda(seasonNumber, tokenMint = constants_1.MIZD_TOKEN_MINT) {
+function getSeasonPda(seasonNumber, tokenMint = constants_1.MIZD_TOKEN_MINT, launchpadTokenMint) {
     const seasonBn = (0, conversions_2.toSeasonNumberBn)(seasonNumber);
+    // For Moonpool mode, use launchpadTokenMint; for classic mode, use tokenMint
+    const mintToUse = launchpadTokenMint || tokenMint;
     return web3_js_1.PublicKey.findProgramAddressSync([
         Buffer.from("season"),
-        tokenMint.toBuffer(),
+        mintToUse.toBuffer(),
         constants_1.SEASON_INSTANCE_ID.toArrayLike(Buffer, "le", 8),
         seasonBn.toArrayLike(Buffer, "le", 8),
     ], constants_1.PROGRAM_ID);
 }
 /**
- * Derive the SeasonMembership PDA
+ * Derive the SeasonMembership PDA.
+ * For Moonpool mode, pass launchpadTokenMint to scope the membership to a specific Moonpool.
  * PDA model:
- *   seeds = ["season_membership", season_number_le_u64, user_pubkey_bytes, tier_u8]
+ *   seeds = ["season_membership", mint_pubkey, instance_id, season_number_le_u64, user_pubkey_bytes, tier_u8]
  *
  * Tier mapping (u8):
  * 0 = copper, 1 = silver, 2 = gold, 3 = platinum, 4 = mithril
@@ -80,13 +86,17 @@ function getSeasonPda(seasonNumber, tokenMint = constants_1.MIZD_TOKEN_MINT) {
  * @param seasonNumber - The season number
  * @param user - The user's public key
  * @param tier - Tier number (0..=4)
+ * @param tokenMint - The token mint (MIZD) - used only if launchpadTokenMint is not provided
+ * @param launchpadTokenMint - The launchpad token mint (unique per Moonpool) - use this for Moonpool mode
  */
-function getSeasonMembershipPda(seasonNumber, user, tier, tokenMint = constants_1.MIZD_TOKEN_MINT) {
+function getSeasonMembershipPda(seasonNumber, user, tier, tokenMint = constants_1.MIZD_TOKEN_MINT, launchpadTokenMint) {
     const t = (0, tierPenalty_1.assertValidTierNumber)(tier);
     const seasonBn = (0, conversions_2.toSeasonNumberBn)(seasonNumber);
+    // For Moonpool mode, use launchpadTokenMint; for classic mode, use tokenMint
+    const mintToUse = launchpadTokenMint || tokenMint;
     return web3_js_1.PublicKey.findProgramAddressSync([
         Buffer.from("season_membership"),
-        tokenMint.toBuffer(),
+        mintToUse.toBuffer(),
         constants_1.SEASON_INSTANCE_ID.toArrayLike(Buffer, "le", 8),
         seasonBn.toArrayLike(Buffer, "le", 8),
         user.toBuffer(),
@@ -144,25 +154,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.6",
+  "version": "5.0.8",
   "description": "TypeScript SDK for Proof of Take Solana program",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",