proof-of-take-sdk 5.0.13 → 5.0.14

package/dist/index.d.ts

@@ -11,8 +11,12 @@ export type { CreateMiztakeOptions, CreateMiztakeResult, CreateMiztakePdas, Crea
 export { initializeStatistics, isInitialized, } from "./instructions/initializeStatistics";
 export { initializeSeasonSettings } from "./instructions/initializeSeasonSettings";
 export { initializeSeasonVault } from "./instructions/initializeSeasonVault";
-export { createMoonpool, joinMoonpoolSeason, joinSunpool, joinSeasonClassic, joinSeasonLaunchpad, } from "./instructions/joinSeason";
-export type { CreateMoonpoolOptions, JoinMoonpoolSeasonOptions, JoinSunpoolOptions, JoinSeasonClassicOptions, JoinSeasonLaunchpadOptions, } from "./instructions/joinSeason";
+export { createMoonpool } from "./instructions/createMoonpool";
+export type { CreateMoonpoolOptions, CreateMoonpoolPdas, CreateMoonpoolMeta, CreateMoonpoolUpdatedAccounts, } from "./instructions/createMoonpool";
+export { joinMoonpoolSeason } from "./instructions/joinMoonpoolSeason";
+export type { JoinMoonpoolSeasonOptions, JoinMoonpoolSeasonPdas, JoinMoonpoolSeasonUpdatedAccounts, } from "./instructions/joinMoonpoolSeason";
+export { joinSunpool } from "./instructions/joinSunpool";
+export type { JoinSunpoolOptions, JoinSunpoolPdas, JoinSunpoolUpdatedAccounts, } from "./instructions/joinSunpool";
 export { confirmedPostOnX } from "./instructions/confirmedPostOnX";
 export type { ConfirmedPostOnXOptions } from "./instructions/confirmedPostOnX";
 export { claimWindowRewards, claimWindowRewardsClassic, claimWindowRewardsLaunchpad, } from "./instructions/claimWindowRewards";

package/dist/index.js

@@ -21,7 +21,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VERSION = exports.closeReferralPenaltyClaim = exports.closeUserWindowParticipation = exports.closeRewardWindow = exports.closeSeasonMembership = exports.closeUserStats = exports.closeMiztake = exports.getUserStatsByPda = exports.getProgramReadOnly = exports.createProgramWithId = exports.createProgram = exports.ANCHOR_IDL = exports.IDL = exports.WindowState = exports.SeasonState = exports.PDAManager = exports.getProgram = exports.viewCurrentSeason = exports.viewWindowStatus = exports.viewSeasonMembershipStatus = exports.updateSeasonAdmin = exports.toggleSeasonPause = exports.initializeRewardWindow = exports.sellMizd = exports.buyMizd = exports.initializeBondingCurve = exports.withdrawSeasonDeposit = exports.claimSignupRewardsLaunchpad = exports.claimSignupRewardsClassic = exports.claimSignupRewards = exports.claimReferralPenaltyForWindowLaunchpad = exports.claimReferralPenaltyForWindowClassic = exports.claimReferralPenaltyForWindow = exports.claimWindowRewardsLaunchpad = exports.claimWindowRewardsClassic = exports.claimWindowRewards = exports.confirmedPostOnX = exports.joinSeasonLaunchpad = exports.joinSeasonClassic = exports.joinSunpool = exports.joinMoonpoolSeason = exports.createMoonpool = exports.initializeSeasonVault = exports.initializeSeasonSettings = exports.isInitialized = exports.initializeStatistics = exports.getMiztakePdaForParams = exports.createMiztake = void 0;
+exports.VERSION = exports.closeReferralPenaltyClaim = exports.closeUserWindowParticipation = exports.closeRewardWindow = exports.closeSeasonMembership = exports.closeUserStats = exports.closeMiztake = exports.getUserStatsByPda = exports.getProgramReadOnly = exports.createProgramWithId = exports.createProgram = exports.ANCHOR_IDL = exports.IDL = exports.WindowState = exports.SeasonState = exports.PDAManager = exports.getProgram = exports.viewCurrentSeason = exports.viewWindowStatus = exports.viewSeasonMembershipStatus = exports.updateSeasonAdmin = exports.toggleSeasonPause = exports.initializeRewardWindow = exports.sellMizd = exports.buyMizd = exports.initializeBondingCurve = exports.withdrawSeasonDeposit = exports.claimSignupRewardsLaunchpad = exports.claimSignupRewardsClassic = exports.claimSignupRewards = exports.claimReferralPenaltyForWindowLaunchpad = exports.claimReferralPenaltyForWindowClassic = exports.claimReferralPenaltyForWindow = exports.claimWindowRewardsLaunchpad = exports.claimWindowRewardsClassic = exports.claimWindowRewards = exports.confirmedPostOnX = exports.joinSunpool = exports.joinMoonpoolSeason = exports.createMoonpool = exports.initializeSeasonVault = exports.initializeSeasonSettings = exports.isInitialized = exports.initializeStatistics = exports.getMiztakePdaForParams = exports.createMiztake = void 0;
 // NOTE:
 // We intentionally export `getProgram` via a local const assignment (instead of `export * from ...`)
 // so that the compiled CommonJS output uses a writable property. This makes it possible to mock
@@ -41,12 +41,12 @@ Object.defineProperty(exports, "initializeSeasonSettings", { enumerable: true, g
 var initializeSeasonVault_1 = require("./instructions/initializeSeasonVault");
 Object.defineProperty(exports, "initializeSeasonVault", { enumerable: true, get: function () { return initializeSeasonVault_1.initializeSeasonVault; } });
 // Season membership instructions
-var joinSeason_1 = require("./instructions/joinSeason");
-Object.defineProperty(exports, "createMoonpool", { enumerable: true, get: function () { return joinSeason_1.createMoonpool; } });
-Object.defineProperty(exports, "joinMoonpoolSeason", { enumerable: true, get: function () { return joinSeason_1.joinMoonpoolSeason; } });
-Object.defineProperty(exports, "joinSunpool", { enumerable: true, get: function () { return joinSeason_1.joinSunpool; } });
-Object.defineProperty(exports, "joinSeasonClassic", { enumerable: true, get: function () { return joinSeason_1.joinSeasonClassic; } });
-Object.defineProperty(exports, "joinSeasonLaunchpad", { enumerable: true, get: function () { return joinSeason_1.joinSeasonLaunchpad; } });
+var createMoonpool_1 = require("./instructions/createMoonpool");
+Object.defineProperty(exports, "createMoonpool", { enumerable: true, get: function () { return createMoonpool_1.createMoonpool; } });
+var joinMoonpoolSeason_1 = require("./instructions/joinMoonpoolSeason");
+Object.defineProperty(exports, "joinMoonpoolSeason", { enumerable: true, get: function () { return joinMoonpoolSeason_1.joinMoonpoolSeason; } });
+var joinSunpool_1 = require("./instructions/joinSunpool");
+Object.defineProperty(exports, "joinSunpool", { enumerable: true, get: function () { return joinSunpool_1.joinSunpool; } });
 var confirmedPostOnX_1 = require("./instructions/confirmedPostOnX");
 Object.defineProperty(exports, "confirmedPostOnX", { enumerable: true, get: function () { return confirmedPostOnX_1.confirmedPostOnX; } });
 var claimWindowRewards_1 = require("./instructions/claimWindowRewards");

package/dist/instructions/createMoonpool.d.ts

@@ -0,0 +1,65 @@
+import { BN } from "@coral-xyz/anchor";
+import { Connection, Keypair, PublicKey } from "@solana/web3.js";
+import { Season, SeasonMembership, SeasonSettings, TierNumber } from "../types";
+import { StandardInstructionResultWithPdas } from "../types/instructionResults";
+/**
+ * Options for createMoonpool instruction (creating a new Moonpool + first join)
+ */
+export interface CreateMoonpoolOptions {
+    connection: Connection;
+    user: PublicKey;
+    seasonNumber: BN;
+    /** Tier number: 0=copper, 1=silver, 2=gold, 3=platinum, 4=mithril */
+    tier: TierNumber;
+    /** Optional referrer (PublicKey.default means no referrer) */
+    referrer?: PublicKey;
+    /** If true, root admin funds the SOL for the join. */
+    star?: boolean;
+    /** Hard cap in lamports for slippage protection. */
+    maxSolInLamports?: BN;
+    /** Expected SOL in lamports for bps slippage protection. */
+    expectedSolInLamports?: BN;
+    /** Max slippage in basis points (0..=5000). */
+    maxSlippageBps?: number;
+    /** Star flag prompt: a short message (max 33 chars). REQUIRED for new Moonpool. */
+    starFlagPrompt: string;
+    /** Token symbol (max 4 chars). REQUIRED for new Moonpool. */
+    symbol: string;
+    /** Optional injected timestamp (seconds) for optimistic state calculation */
+    now?: BN;
+    feePayer?: PublicKey;
+    currentAccounts?: {
+        seasonSettings?: SeasonSettings;
+        season?: Season;
+    };
+}
+export type CreateMoonpoolPdas = {
+    seasonSettings: PublicKey;
+    season: PublicKey;
+    seasonMembership: PublicKey;
+    moonpool: PublicKey;
+    moonpoolTreasury: PublicKey;
+    launchpadTokenMint: PublicKey;
+};
+export type CreateMoonpoolMeta = {
+    /** The keypair used for the launchpad mint (always generated for createMoonpool) */
+    launchpadTokenMintKeypair: Keypair;
+};
+export type CreateMoonpoolUpdatedAccounts = {
+    seasonSettings?: SeasonSettings;
+    season?: Season;
+    seasonMembership?: SeasonMembership;
+};
+/**
+ * Create a new Moonpool and perform the first launchpad join.
+ *
+ * This instruction:
+ * - Creates a new launchpad_token_mint (SPL Token-2022)
+ * - Initializes the Moonpool
+ * - Initializes the Season (scoped to launchpad_token_mint)
+ * - Creates the first SeasonMembership
+ *
+ * @param options - CreateMoonpool options
+ * @returns Instructions, signers, PDAs, and metadata with the generated keypair
+ */
+export declare function createMoonpool(options: CreateMoonpoolOptions): Promise<StandardInstructionResultWithPdas<CreateMoonpoolPdas, CreateMoonpoolUpdatedAccounts, CreateMoonpoolMeta>>;

package/dist/instructions/createMoonpool.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMoonpool = createMoonpool;
+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");
+/**
+ * Create a new Moonpool and perform the first launchpad join.
+ *
+ * This instruction:
+ * - Creates a new launchpad_token_mint (SPL Token-2022)
+ * - Initializes the Moonpool
+ * - Initializes the Season (scoped to launchpad_token_mint)
+ * - Creates the first SeasonMembership
+ *
+ * @param options - CreateMoonpool options
+ * @returns Instructions, signers, PDAs, and metadata with the generated keypair
+ */
+async function createMoonpool(options) {
+    const program = (0, programHelpers_1.getProgram)(options.connection);
+    // Validate required fields
+    if (!options.starFlagPrompt || options.starFlagPrompt.length === 0) {
+        throw new Error("starFlagPrompt is required when creating a new Moonpool");
+    }
+    if (options.starFlagPrompt.length > 33) {
+        throw new Error("starFlagPrompt cannot exceed 33 characters");
+    }
+    if (!options.symbol || options.symbol.length === 0) {
+        throw new Error("symbol is required when creating a new Moonpool");
+    }
+    if (options.symbol.length > 4) {
+        throw new Error("symbol cannot exceed 4 characters");
+    }
+    // Generate a new keypair for the launchpad token mint
+    const launchpadTokenMintKeypair = web3_js_1.Keypair.generate();
+    const launchpadTokenMintPubkey = launchpadTokenMintKeypair.publicKey;
+    console.log("[createMoonpool] Generated new launchpad mint keypair:", launchpadTokenMintPubkey.toString());
+    // Derive PDAs with the new launchpadTokenMint
+    const pdasBase = pdaManager_1.PDAManager.deriveJoinSeasonPdas({
+        user: options.user,
+        seasonNumber: options.seasonNumber,
+        tier: options.tier,
+        tokenMint: constants_1.MIZD_TOKEN_MINT,
+        launchpadTokenMint: launchpadTokenMintPubkey,
+    });
+    // Derive Moonpool and Treasury PDAs
+    const [moonpoolPda] = (0, pdas_1.getMoonpoolPda)(launchpadTokenMintPubkey);
+    const [moonpoolTreasuryPda] = (0, pdas_1.getMoonpoolTreasuryPda)(launchpadTokenMintPubkey);
+    const pdas = {
+        seasonSettings: pdasBase.seasonSettings,
+        season: pdasBase.season,
+        seasonMembership: pdasBase.seasonMembership,
+        moonpool: moonpoolPda,
+        moonpoolTreasury: moonpoolTreasuryPda,
+        launchpadTokenMint: launchpadTokenMintPubkey,
+    };
+    const referrer = options.referrer ?? web3_js_1.PublicKey.default;
+    const accounts = {
+        seasonSettings: pdas.seasonSettings,
+        season: pdas.season,
+        seasonMembership: pdas.seasonMembership,
+        moonpool: moonpoolPda,
+        moonpoolTreasury: moonpoolTreasuryPda,
+        launchpadTokenMint: launchpadTokenMintPubkey,
+        rootAdmin: constants_1.ADMIN_PUBLIC_KEY,
+        user: options.user,
+        token2022Program: spl_token_1.TOKEN_2022_PROGRAM_ID,
+        systemProgram: web3_js_1.SystemProgram.programId,
+    };
+    const instruction = await program.methods
+        .createMoonpool(options.seasonNumber, options.tier, referrer, options.star ?? false, options.maxSolInLamports ?? new anchor_1.BN(0), options.expectedSolInLamports ?? new anchor_1.BN(0), options.maxSlippageBps ?? 0, options.starFlagPrompt, options.symbol)
+        .accounts(accounts)
+        .instruction();
+    // For star joins, root admin pays
+    const feePayer = options.star ? constants_1.ADMIN_PUBLIC_KEY : (0, signerHelpers_1.getDefaultFeePayer)(options.feePayer);
+    // Build signers array - must include the launchpad mint keypair
+    const signersList = [
+        (0, signerHelpers_1.asAdminSigner)(constants_1.ADMIN_PUBLIC_KEY),
+        (0, signerHelpers_1.asUserSigner)(options.user),
+        { publicKey: launchpadTokenMintKeypair.publicKey, role: "payer" },
+    ];
+    const signers = (0, signerHelpers_1.buildSigners)(signersList, feePayer);
+    return {
+        instructions: [instruction],
+        signers,
+        pdas,
+        metadata: {
+            launchpadTokenMintKeypair,
+        },
+    };
+}

package/dist/instructions/joinMoonpoolSeason.d.ts

@@ -0,0 +1,59 @@
+import { BN } from "@coral-xyz/anchor";
+import { Connection, PublicKey } from "@solana/web3.js";
+import { Season, SeasonMembership, SeasonSettings, TierNumber } from "../types";
+import { StandardInstructionResultWithPdas } from "../types/instructionResults";
+/**
+ * Options for joinMoonpoolSeason instruction (joining an existing Moonpool)
+ */
+export interface JoinMoonpoolSeasonOptions {
+    connection: Connection;
+    user: PublicKey;
+    seasonNumber: BN;
+    /** The launchpad token mint of the Moonpool to join. REQUIRED. */
+    launchpadTokenMint: PublicKey;
+    /** Tier number: 0=copper, 1=silver, 2=gold, 3=platinum, 4=mithril */
+    tier: TierNumber;
+    /** Optional referrer (PublicKey.default means no referrer) */
+    referrer?: PublicKey;
+    /** If true, root admin funds the SOL for the join. */
+    star?: boolean;
+    /** Hard cap in lamports for slippage protection. */
+    maxSolInLamports?: BN;
+    /** Expected SOL in lamports for bps slippage protection. */
+    expectedSolInLamports?: BN;
+    /** Max slippage in basis points (0..=5000). */
+    maxSlippageBps?: number;
+    /** Optional injected timestamp (seconds) for optimistic state calculation */
+    now?: BN;
+    feePayer?: PublicKey;
+    currentAccounts?: {
+        seasonSettings?: SeasonSettings;
+        season?: Season;
+        moonpool?: any;
+    };
+}
+export type JoinMoonpoolSeasonPdas = {
+    seasonSettings: PublicKey;
+    season: PublicKey;
+    seasonMembership: PublicKey;
+    moonpool: PublicKey;
+    moonpoolTreasury: PublicKey;
+    launchpadTokenMint: PublicKey;
+};
+export type JoinMoonpoolSeasonUpdatedAccounts = {
+    seasonSettings?: SeasonSettings;
+    season?: Season;
+    seasonMembership?: SeasonMembership;
+};
+/**
+ * Join an existing Moonpool season.
+ *
+ * This instruction:
+ * - Requires Moonpool to already exist
+ * - Lazily initializes Season if needed (for new seasons with existing Moonpool)
+ * - Creates new SeasonMembership
+ *
+ * @param options - JoinMoonpoolSeason options
+ * @returns Instructions, signers, and PDAs
+ */
+export declare function joinMoonpoolSeason(options: JoinMoonpoolSeasonOptions): Promise<StandardInstructionResultWithPdas<JoinMoonpoolSeasonPdas, JoinMoonpoolSeasonUpdatedAccounts>>;

package/dist/instructions/joinMoonpoolSeason.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.joinMoonpoolSeason = joinMoonpoolSeason;
+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");
+/**
+ * Join an existing Moonpool season.
+ *
+ * This instruction:
+ * - Requires Moonpool to already exist
+ * - Lazily initializes Season if needed (for new seasons with existing Moonpool)
+ * - Creates new SeasonMembership
+ *
+ * @param options - JoinMoonpoolSeason options
+ * @returns Instructions, signers, and PDAs
+ */
+async function joinMoonpoolSeason(options) {
+    const program = (0, programHelpers_1.getProgram)(options.connection);
+    const launchpadTokenMintPubkey = options.launchpadTokenMint;
+    console.log("[joinMoonpoolSeason] Using existing launchpadTokenMint:", launchpadTokenMintPubkey.toString());
+    // Derive PDAs with the existing launchpadTokenMint
+    const pdasBase = pdaManager_1.PDAManager.deriveJoinSeasonPdas({
+        user: options.user,
+        seasonNumber: options.seasonNumber,
+        tier: options.tier,
+        tokenMint: constants_1.MIZD_TOKEN_MINT,
+        launchpadTokenMint: launchpadTokenMintPubkey,
+    });
+    // Derive Moonpool and Treasury PDAs
+    const [moonpoolPda] = (0, pdas_1.getMoonpoolPda)(launchpadTokenMintPubkey);
+    const [moonpoolTreasuryPda] = (0, pdas_1.getMoonpoolTreasuryPda)(launchpadTokenMintPubkey);
+    const pdas = {
+        seasonSettings: pdasBase.seasonSettings,
+        season: pdasBase.season,
+        seasonMembership: pdasBase.seasonMembership,
+        moonpool: moonpoolPda,
+        moonpoolTreasury: moonpoolTreasuryPda,
+        launchpadTokenMint: launchpadTokenMintPubkey,
+    };
+    const referrer = options.referrer ?? web3_js_1.PublicKey.default;
+    const accounts = {
+        seasonSettings: pdas.seasonSettings,
+        season: pdas.season,
+        seasonMembership: pdas.seasonMembership,
+        moonpool: moonpoolPda,
+        moonpoolTreasury: moonpoolTreasuryPda,
+        launchpadTokenMint: launchpadTokenMintPubkey,
+        rootAdmin: constants_1.ADMIN_PUBLIC_KEY,
+        user: options.user,
+        token2022Program: spl_token_1.TOKEN_2022_PROGRAM_ID,
+        systemProgram: web3_js_1.SystemProgram.programId,
+    };
+    const instruction = await program.methods
+        .joinMoonpoolSeason(options.seasonNumber, options.tier, referrer, options.star ?? false, options.maxSolInLamports ?? new anchor_1.BN(0), options.expectedSolInLamports ?? new anchor_1.BN(0), options.maxSlippageBps ?? 0)
+        .accounts(accounts)
+        .instruction();
+    // For star joins, root admin pays
+    const feePayer = options.star ? constants_1.ADMIN_PUBLIC_KEY : (0, signerHelpers_1.getDefaultFeePayer)(options.feePayer);
+    // Build signers array
+    const signersList = [
+        (0, signerHelpers_1.asAdminSigner)(constants_1.ADMIN_PUBLIC_KEY),
+        (0, signerHelpers_1.asUserSigner)(options.user),
+    ];
+    const signers = (0, signerHelpers_1.buildSigners)(signersList, feePayer);
+    return {
+        instructions: [instruction],
+        signers,
+        pdas,
+    };
+}

package/dist/instructions/joinSunpool.d.ts

@@ -0,0 +1,60 @@
+import { BN } from "@coral-xyz/anchor";
+import { Connection, PublicKey } from "@solana/web3.js";
+import { Season, SeasonMembership, SeasonSettings, TierNumber } from "../types";
+import { StandardInstructionResultWithPdas } from "../types/instructionResults";
+/**
+ * Options for joinSunpool instruction (classic mode with MIZD)
+ */
+export interface JoinSunpoolOptions {
+    connection: Connection;
+    user: PublicKey;
+    seasonNumber: BN;
+    /** Token mint this season is scoped to. Defaults to MIZD_TOKEN_MINT. */
+    tokenMint?: PublicKey;
+    /** Tier number: 0=copper, 1=silver, 2=gold, 3=platinum, 4=mithril */
+    tier: TierNumber;
+    /** Optional referrer (PublicKey.default means no referrer) */
+    referrer?: PublicKey;
+    /** Referrer's tier (required if referrer is provided) */
+    referrerTier?: TierNumber;
+    /** If true, root admin funds the MIZD for the join. */
+    star?: boolean;
+    /** Star flag prompt (max 33 chars). Required for first Sunpool initialization. */
+    starFlagPrompt?: string;
+    /** Token symbol (max 4 chars). Required for first Sunpool initialization. */
+    symbol?: string;
+    /** Optional injected timestamp (seconds) for optimistic state calculation */
+    now?: BN;
+    feePayer?: PublicKey;
+    currentAccounts?: {
+        seasonSettings?: SeasonSettings;
+        season?: Season;
+    };
+}
+export type JoinSunpoolPdas = {
+    seasonSettings: PublicKey;
+    season: PublicKey;
+    seasonMembership: PublicKey;
+    sunpool: PublicKey;
+    seasonDepositVault: PublicKey;
+    userJoinCredit: PublicKey;
+    userJoinCreditVault: PublicKey;
+};
+export type JoinSunpoolUpdatedAccounts = {
+    seasonSettings?: SeasonSettings;
+    season?: Season;
+    seasonMembership?: SeasonMembership;
+};
+/**
+ * Join a Sunpool season (classic mode with MIZD).
+ *
+ * This instruction:
+ * - Lazily initializes Sunpool if needed
+ * - Lazily initializes Season if needed
+ * - Creates SeasonMembership
+ * - Handles MIZD token transfers and join credit
+ *
+ * @param options - JoinSunpool options
+ * @returns Instructions, signers, and PDAs
+ */
+export declare function joinSunpool(options: JoinSunpoolOptions): Promise<StandardInstructionResultWithPdas<JoinSunpoolPdas, JoinSunpoolUpdatedAccounts>>;

package/dist/instructions/joinSunpool.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.joinSunpool = joinSunpool;
+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");
+/**
+ * Join a Sunpool season (classic mode with MIZD).
+ *
+ * This instruction:
+ * - Lazily initializes Sunpool if needed
+ * - Lazily initializes Season if needed
+ * - Creates SeasonMembership
+ * - Handles MIZD token transfers and join credit
+ *
+ * @param options - JoinSunpool options
+ * @returns Instructions, signers, and PDAs
+ */
+async function joinSunpool(options) {
+    const program = (0, programHelpers_1.getProgram)(options.connection);
+    const tokenMint = options.tokenMint ?? constants_1.MIZD_TOKEN_MINT;
+    console.log("[joinSunpool] Classic mode join with tokenMint:", tokenMint.toString());
+    // Derive PDAs - for Sunpool, use tokenMint for PDA derivation
+    const pdasBase = pdaManager_1.PDAManager.deriveJoinSeasonPdas({
+        user: options.user,
+        seasonNumber: options.seasonNumber,
+        tier: options.tier,
+        tokenMint,
+        launchpadTokenMint: tokenMint, // Sunpool uses tokenMint for Season/Membership PDAs
+    });
+    // Derive Sunpool PDA
+    const [sunpoolPda] = (0, pdas_1.getSunpoolPda)(tokenMint);
+    // User join credit vault ATA
+    const userJoinCreditVault = (0, spl_token_1.getAssociatedTokenAddressSync)(constants_1.MIZD_TOKEN_MINT, pdasBase.userJoinCredit, true);
+    // Token accounts
+    const rootAdminTokenAccount = (0, spl_token_1.getAssociatedTokenAddressSync)(constants_1.MIZD_TOKEN_MINT, constants_1.ADMIN_PUBLIC_KEY);
+    const userMizdAta = (0, spl_token_1.getAssociatedTokenAddressSync)(constants_1.MIZD_TOKEN_MINT, options.user);
+    const pdas = {
+        seasonSettings: pdasBase.seasonSettings,
+        season: pdasBase.season,
+        seasonMembership: pdasBase.seasonMembership,
+        sunpool: sunpoolPda,
+        seasonDepositVault: pdasBase.seasonDepositVault,
+        userJoinCredit: pdasBase.userJoinCredit,
+        userJoinCreditVault,
+    };
+    const referrer = options.referrer ?? web3_js_1.PublicKey.default;
+    const hasReferrer = !referrer.equals(web3_js_1.PublicKey.default);
+    // Validate referrer tier
+    if (hasReferrer && options.referrerTier === undefined) {
+        throw new Error("referrerTier is required when referrer is provided");
+    }
+    const accounts = {
+        seasonSettings: pdas.seasonSettings,
+        season: pdas.season,
+        seasonMembership: pdas.seasonMembership,
+        sunpool: sunpoolPda,
+        seasonDepositVault: pdas.seasonDepositVault,
+        userJoinCredit: pdas.userJoinCredit,
+        userJoinCreditVault,
+        mizdMint: constants_1.MIZD_TOKEN_MINT,
+        tokenMint,
+        rootAdmin: constants_1.ADMIN_PUBLIC_KEY,
+        rootAdminTokenAccount,
+        userTokenAccount: userMizdAta,
+        user: options.user,
+        associatedTokenProgram: spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID,
+        tokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
+        systemProgram: web3_js_1.SystemProgram.programId,
+    };
+    const instruction = await program.methods
+        .joinSunpool(options.seasonNumber, options.tier, referrer, options.referrerTier ?? 0, options.star ?? false, options.starFlagPrompt ?? "", options.symbol ?? "")
+        .accounts(accounts)
+        .instruction();
+    // For star joins, root admin pays
+    const feePayer = options.star ? constants_1.ADMIN_PUBLIC_KEY : (0, signerHelpers_1.getDefaultFeePayer)(options.feePayer);
+    // Build signers array
+    const signersList = [
+        (0, signerHelpers_1.asAdminSigner)(constants_1.ADMIN_PUBLIC_KEY),
+        (0, signerHelpers_1.asUserSigner)(options.user),
+    ];
+    const signers = (0, signerHelpers_1.buildSigners)(signersList, feePayer);
+    return {
+        instructions: [instruction],
+        signers,
+        pdas,
+    };
+}

package/package.json

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

package/dist/instructions/joinSeason.d.ts

@@ -1,252 +0,0 @@
-import { BN } from "@coral-xyz/anchor";
-import { Connection, Keypair, PublicKey } from "@solana/web3.js";
-import { Season, SeasonMembership, SeasonSettings, TierNumber } from "../types";
-import { StandardInstructionResultWithPdas } from "../types/instructionResults";
-/**
- * Options for createMoonpool instruction (creating a new Moonpool + first join)
- */
-export interface CreateMoonpoolOptions {
-    connection: Connection;
-    user: PublicKey;
-    seasonNumber: BN;
-    /** Tier number: 0=copper, 1=silver, 2=gold, 3=platinum, 4=mithril */
-    tier: TierNumber;
-    /** Optional referrer (PublicKey.default means no referrer) */
-    referrer?: PublicKey;
-    /** If true, root admin funds the SOL for the join. */
-    star?: boolean;
-    /** Hard cap in lamports for slippage protection. */
-    maxSolInLamports?: BN;
-    /** Expected SOL in lamports for bps slippage protection. */
-    expectedSolInLamports?: BN;
-    /** Max slippage in basis points (0..=5000). */
-    maxSlippageBps?: number;
-    /** Star flag prompt: a short message (max 33 chars). REQUIRED for new Moonpool. */
-    starFlagPrompt: string;
-    /** Token symbol (max 4 chars). REQUIRED for new Moonpool. */
-    symbol: string;
-    /** Optional injected timestamp (seconds) for optimistic state calculation */
-    now?: BN;
-    feePayer?: PublicKey;
-    currentAccounts?: {
-        seasonSettings?: SeasonSettings;
-        season?: Season;
-    };
-}
-type CreateMoonpoolPdas = {
-    seasonSettings: PublicKey;
-    season: PublicKey;
-    seasonMembership: PublicKey;
-    moonpool: PublicKey;
-    moonpoolTreasury: PublicKey;
-    launchpadTokenMint: PublicKey;
-};
-type CreateMoonpoolMeta = {
-    /** The keypair used for the launchpad mint (always generated for createMoonpool) */
-    launchpadTokenMintKeypair: Keypair;
-};
-type CreateMoonpoolUpdatedAccounts = {
-    seasonSettings?: SeasonSettings;
-    season?: Season;
-    seasonMembership?: SeasonMembership;
-};
-/**
- * Create a new Moonpool and perform the first launchpad join.
- *
- * This instruction:
- * - Creates a new launchpad_token_mint (SPL Token-2022)
- * - Initializes the Moonpool
- * - Initializes the Season (scoped to launchpad_token_mint)
- * - Creates the first SeasonMembership
- *
- * @param options - CreateMoonpool options
- * @returns Instructions, signers, PDAs, and metadata with the generated keypair
- */
-export declare function createMoonpool(options: CreateMoonpoolOptions): Promise<StandardInstructionResultWithPdas<CreateMoonpoolPdas, CreateMoonpoolUpdatedAccounts, CreateMoonpoolMeta>>;
-/**
- * Options for joinMoonpoolSeason instruction (joining an existing Moonpool)
- */
-export interface JoinMoonpoolSeasonOptions {
-    connection: Connection;
-    user: PublicKey;
-    seasonNumber: BN;
-    /** The launchpad token mint of the Moonpool to join. REQUIRED. */
-    launchpadTokenMint: PublicKey;
-    /** Tier number: 0=copper, 1=silver, 2=gold, 3=platinum, 4=mithril */
-    tier: TierNumber;
-    /** Optional referrer (PublicKey.default means no referrer) */
-    referrer?: PublicKey;
-    /** If true, root admin funds the SOL for the join. */
-    star?: boolean;
-    /** Hard cap in lamports for slippage protection. */
-    maxSolInLamports?: BN;
-    /** Expected SOL in lamports for bps slippage protection. */
-    expectedSolInLamports?: BN;
-    /** Max slippage in basis points (0..=5000). */
-    maxSlippageBps?: number;
-    /** Optional injected timestamp (seconds) for optimistic state calculation */
-    now?: BN;
-    feePayer?: PublicKey;
-    currentAccounts?: {
-        seasonSettings?: SeasonSettings;
-        season?: Season;
-        moonpool?: any;
-    };
-}
-type JoinMoonpoolSeasonPdas = {
-    seasonSettings: PublicKey;
-    season: PublicKey;
-    seasonMembership: PublicKey;
-    moonpool: PublicKey;
-    moonpoolTreasury: PublicKey;
-    launchpadTokenMint: PublicKey;
-};
-type JoinMoonpoolSeasonUpdatedAccounts = {
-    seasonSettings?: SeasonSettings;
-    season?: Season;
-    seasonMembership?: SeasonMembership;
-};
-/**
- * Join an existing Moonpool season.
- *
- * This instruction:
- * - Requires Moonpool to already exist
- * - Lazily initializes Season if needed (for new seasons with existing Moonpool)
- * - Creates new SeasonMembership
- *
- * @param options - JoinMoonpoolSeason options
- * @returns Instructions, signers, and PDAs
- */
-export declare function joinMoonpoolSeason(options: JoinMoonpoolSeasonOptions): Promise<StandardInstructionResultWithPdas<JoinMoonpoolSeasonPdas, JoinMoonpoolSeasonUpdatedAccounts>>;
-/**
- * Options for joinSunpool instruction (classic mode with MIZD)
- */
-export interface JoinSunpoolOptions {
-    connection: Connection;
-    user: PublicKey;
-    seasonNumber: BN;
-    /** Token mint this season is scoped to. Defaults to MIZD_TOKEN_MINT. */
-    tokenMint?: PublicKey;
-    /** Tier number: 0=copper, 1=silver, 2=gold, 3=platinum, 4=mithril */
-    tier: TierNumber;
-    /** Optional referrer (PublicKey.default means no referrer) */
-    referrer?: PublicKey;
-    /** Referrer's tier (required if referrer is provided) */
-    referrerTier?: TierNumber;
-    /** If true, root admin funds the MIZD for the join. */
-    star?: boolean;
-    /** Star flag prompt (max 33 chars). Required for first Sunpool initialization. */
-    starFlagPrompt?: string;
-    /** Token symbol (max 4 chars). Required for first Sunpool initialization. */
-    symbol?: string;
-    /** Optional injected timestamp (seconds) for optimistic state calculation */
-    now?: BN;
-    feePayer?: PublicKey;
-    currentAccounts?: {
-        seasonSettings?: SeasonSettings;
-        season?: Season;
-    };
-}
-type JoinSunpoolPdas = {
-    seasonSettings: PublicKey;
-    season: PublicKey;
-    seasonMembership: PublicKey;
-    sunpool: PublicKey;
-    seasonDepositVault: PublicKey;
-    userJoinCredit: PublicKey;
-    userJoinCreditVault: PublicKey;
-};
-type JoinSunpoolUpdatedAccounts = {
-    seasonSettings?: SeasonSettings;
-    season?: Season;
-    seasonMembership?: SeasonMembership;
-};
-/**
- * Join a Sunpool season (classic mode with MIZD).
- *
- * This instruction:
- * - Lazily initializes Sunpool if needed
- * - Lazily initializes Season if needed
- * - Creates SeasonMembership
- * - Handles MIZD token transfers and join credit
- *
- * @param options - JoinSunpool options
- * @returns Instructions, signers, and PDAs
- */
-export declare function joinSunpool(options: JoinSunpoolOptions): Promise<StandardInstructionResultWithPdas<JoinSunpoolPdas, JoinSunpoolUpdatedAccounts>>;
-/**
- * Options for the launchpad joinSeason wrapper.
- * This is a convenience alias that routes to createMoonpool or joinMoonpoolSeason.
- */
-export type JoinSeasonLaunchpadOptions = {
-    connection: Connection;
-    user: PublicKey;
-    seasonNumber: BN;
-    tier: TierNumber;
-    referrer?: PublicKey;
-    referrerTier?: TierNumber;
-    star?: boolean;
-    /** Hard cap in lamports for slippage protection. */
-    maxSolInLamports?: BN;
-    /** Expected SOL in lamports for bps slippage protection. */
-    expectedSolInLamports?: BN;
-    /** Max slippage in basis points (0..=5000). */
-    maxSlippageBps?: number;
-    /** Star flag prompt (max 33 chars). REQUIRED for creating new Moonpool. */
-    starFlagPrompt?: string;
-    /** Token symbol (max 4 chars). REQUIRED for creating new Moonpool. */
-    symbol?: string;
-    /** Force creating a new Moonpool (generates new launchpadTokenMint keypair). */
-    forceNewLaunchpadMint?: boolean;
-    now?: BN;
-    feePayer?: PublicKey;
-    currentAccounts?: {
-        seasonSettings?: SeasonSettings;
-        season?: Season;
-        moonpool?: any;
-    };
-};
-type JoinSeasonLaunchpadMeta = {
-    launchpadTokenMintKeypair?: Keypair;
-};
-/**
- * Convenience wrapper for launchpad mode joins.
- *
- * This function automatically determines whether to call:
- * - createMoonpool (if forceNewLaunchpadMint=true or no existing moonpool)
- * - joinMoonpoolSeason (if joining an existing moonpool)
- *
- * @param options - Join options
- * @returns Instructions, signers, PDAs, and metadata
- */
-export declare function joinSeasonLaunchpad(options: JoinSeasonLaunchpadOptions): Promise<StandardInstructionResultWithPdas<any, any, JoinSeasonLaunchpadMeta>>;
-/**
- * Options for the classic (non-launchpad) joinSeason wrapper.
- */
-export type JoinSeasonClassicOptions = {
-    connection: Connection;
-    user: PublicKey;
-    seasonNumber: BN;
-    tokenMint?: PublicKey;
-    tier: TierNumber;
-    referrer?: PublicKey;
-    referrerTier?: TierNumber;
-    star?: boolean;
-    starFlagPrompt?: string;
-    symbol?: string;
-    now?: BN;
-    feePayer?: PublicKey;
-    currentAccounts?: {
-        seasonSettings?: SeasonSettings;
-        season?: Season;
-    };
-};
-/**
- * Convenience wrapper for classic (non-launchpad) mode joins.
- * Routes to joinSunpool instruction.
- *
- * @param options - Join options
- * @returns Instructions, signers, and PDAs
- */
-export declare function joinSeasonClassic(options: JoinSeasonClassicOptions): Promise<StandardInstructionResultWithPdas<JoinSunpoolPdas, JoinSunpoolUpdatedAccounts>>;
-export {};

package/dist/instructions/joinSeason.js

@@ -1,331 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createMoonpool = createMoonpool;
-exports.joinMoonpoolSeason = joinMoonpoolSeason;
-exports.joinSunpool = joinSunpool;
-exports.joinSeasonLaunchpad = joinSeasonLaunchpad;
-exports.joinSeasonClassic = joinSeasonClassic;
-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");
-/**
- * Create a new Moonpool and perform the first launchpad join.
- *
- * This instruction:
- * - Creates a new launchpad_token_mint (SPL Token-2022)
- * - Initializes the Moonpool
- * - Initializes the Season (scoped to launchpad_token_mint)
- * - Creates the first SeasonMembership
- *
- * @param options - CreateMoonpool options
- * @returns Instructions, signers, PDAs, and metadata with the generated keypair
- */
-async function createMoonpool(options) {
-    const program = (0, programHelpers_1.getProgram)(options.connection);
-    // Validate required fields
-    if (!options.starFlagPrompt || options.starFlagPrompt.length === 0) {
-        throw new Error("starFlagPrompt is required when creating a new Moonpool");
-    }
-    if (options.starFlagPrompt.length > 33) {
-        throw new Error("starFlagPrompt cannot exceed 33 characters");
-    }
-    if (!options.symbol || options.symbol.length === 0) {
-        throw new Error("symbol is required when creating a new Moonpool");
-    }
-    if (options.symbol.length > 4) {
-        throw new Error("symbol cannot exceed 4 characters");
-    }
-    // Generate a new keypair for the launchpad token mint
-    const launchpadTokenMintKeypair = web3_js_1.Keypair.generate();
-    const launchpadTokenMintPubkey = launchpadTokenMintKeypair.publicKey;
-    console.log("[createMoonpool] Generated new launchpad mint keypair:", launchpadTokenMintPubkey.toString());
-    // Derive PDAs with the new launchpadTokenMint
-    const pdasBase = pdaManager_1.PDAManager.deriveJoinSeasonPdas({
-        user: options.user,
-        seasonNumber: options.seasonNumber,
-        tier: options.tier,
-        tokenMint: constants_1.MIZD_TOKEN_MINT,
-        launchpadTokenMint: launchpadTokenMintPubkey,
-    });
-    // Derive Moonpool and Treasury PDAs
-    const [moonpoolPda] = (0, pdas_1.getMoonpoolPda)(launchpadTokenMintPubkey);
-    const [moonpoolTreasuryPda] = (0, pdas_1.getMoonpoolTreasuryPda)(launchpadTokenMintPubkey);
-    const pdas = {
-        seasonSettings: pdasBase.seasonSettings,
-        season: pdasBase.season,
-        seasonMembership: pdasBase.seasonMembership,
-        moonpool: moonpoolPda,
-        moonpoolTreasury: moonpoolTreasuryPda,
-        launchpadTokenMint: launchpadTokenMintPubkey,
-    };
-    const referrer = options.referrer ?? web3_js_1.PublicKey.default;
-    const accounts = {
-        seasonSettings: pdas.seasonSettings,
-        season: pdas.season,
-        seasonMembership: pdas.seasonMembership,
-        moonpool: moonpoolPda,
-        moonpoolTreasury: moonpoolTreasuryPda,
-        launchpadTokenMint: launchpadTokenMintPubkey,
-        rootAdmin: constants_1.ADMIN_PUBLIC_KEY,
-        user: options.user,
-        token2022Program: spl_token_1.TOKEN_2022_PROGRAM_ID,
-        systemProgram: web3_js_1.SystemProgram.programId,
-    };
-    const instruction = await program.methods
-        .createMoonpool(options.seasonNumber, options.tier, referrer, options.star ?? false, options.maxSolInLamports ?? new anchor_1.BN(0), options.expectedSolInLamports ?? new anchor_1.BN(0), options.maxSlippageBps ?? 0, options.starFlagPrompt, options.symbol)
-        .accounts(accounts)
-        .instruction();
-    // For star joins, root admin pays
-    const feePayer = options.star ? constants_1.ADMIN_PUBLIC_KEY : (0, signerHelpers_1.getDefaultFeePayer)(options.feePayer);
-    // Build signers array - must include the launchpad mint keypair
-    const signersList = [
-        (0, signerHelpers_1.asAdminSigner)(constants_1.ADMIN_PUBLIC_KEY),
-        (0, signerHelpers_1.asUserSigner)(options.user),
-        { publicKey: launchpadTokenMintKeypair.publicKey, role: "payer" },
-    ];
-    const signers = (0, signerHelpers_1.buildSigners)(signersList, feePayer);
-    return {
-        instructions: [instruction],
-        signers,
-        pdas,
-        metadata: {
-            launchpadTokenMintKeypair,
-        },
-    };
-}
-/**
- * Join an existing Moonpool season.
- *
- * This instruction:
- * - Requires Moonpool to already exist
- * - Lazily initializes Season if needed (for new seasons with existing Moonpool)
- * - Creates new SeasonMembership
- *
- * @param options - JoinMoonpoolSeason options
- * @returns Instructions, signers, and PDAs
- */
-async function joinMoonpoolSeason(options) {
-    const program = (0, programHelpers_1.getProgram)(options.connection);
-    const launchpadTokenMintPubkey = options.launchpadTokenMint;
-    console.log("[joinMoonpoolSeason] Using existing launchpadTokenMint:", launchpadTokenMintPubkey.toString());
-    // Derive PDAs with the existing launchpadTokenMint
-    const pdasBase = pdaManager_1.PDAManager.deriveJoinSeasonPdas({
-        user: options.user,
-        seasonNumber: options.seasonNumber,
-        tier: options.tier,
-        tokenMint: constants_1.MIZD_TOKEN_MINT,
-        launchpadTokenMint: launchpadTokenMintPubkey,
-    });
-    // Derive Moonpool and Treasury PDAs
-    const [moonpoolPda] = (0, pdas_1.getMoonpoolPda)(launchpadTokenMintPubkey);
-    const [moonpoolTreasuryPda] = (0, pdas_1.getMoonpoolTreasuryPda)(launchpadTokenMintPubkey);
-    const pdas = {
-        seasonSettings: pdasBase.seasonSettings,
-        season: pdasBase.season,
-        seasonMembership: pdasBase.seasonMembership,
-        moonpool: moonpoolPda,
-        moonpoolTreasury: moonpoolTreasuryPda,
-        launchpadTokenMint: launchpadTokenMintPubkey,
-    };
-    const referrer = options.referrer ?? web3_js_1.PublicKey.default;
-    const accounts = {
-        seasonSettings: pdas.seasonSettings,
-        season: pdas.season,
-        seasonMembership: pdas.seasonMembership,
-        moonpool: moonpoolPda,
-        moonpoolTreasury: moonpoolTreasuryPda,
-        launchpadTokenMint: launchpadTokenMintPubkey,
-        rootAdmin: constants_1.ADMIN_PUBLIC_KEY,
-        user: options.user,
-        token2022Program: spl_token_1.TOKEN_2022_PROGRAM_ID,
-        systemProgram: web3_js_1.SystemProgram.programId,
-    };
-    const instruction = await program.methods
-        .joinMoonpoolSeason(options.seasonNumber, options.tier, referrer, options.star ?? false, options.maxSolInLamports ?? new anchor_1.BN(0), options.expectedSolInLamports ?? new anchor_1.BN(0), options.maxSlippageBps ?? 0)
-        .accounts(accounts)
-        .instruction();
-    // For star joins, root admin pays
-    const feePayer = options.star ? constants_1.ADMIN_PUBLIC_KEY : (0, signerHelpers_1.getDefaultFeePayer)(options.feePayer);
-    // Build signers array
-    const signersList = [
-        (0, signerHelpers_1.asAdminSigner)(constants_1.ADMIN_PUBLIC_KEY),
-        (0, signerHelpers_1.asUserSigner)(options.user),
-    ];
-    const signers = (0, signerHelpers_1.buildSigners)(signersList, feePayer);
-    return {
-        instructions: [instruction],
-        signers,
-        pdas,
-    };
-}
-/**
- * Join a Sunpool season (classic mode with MIZD).
- *
- * This instruction:
- * - Lazily initializes Sunpool if needed
- * - Lazily initializes Season if needed
- * - Creates SeasonMembership
- * - Handles MIZD token transfers and join credit
- *
- * @param options - JoinSunpool options
- * @returns Instructions, signers, and PDAs
- */
-async function joinSunpool(options) {
-    const program = (0, programHelpers_1.getProgram)(options.connection);
-    const tokenMint = options.tokenMint ?? constants_1.MIZD_TOKEN_MINT;
-    console.log("[joinSunpool] Classic mode join with tokenMint:", tokenMint.toString());
-    // Derive PDAs - for Sunpool, use tokenMint for PDA derivation
-    const pdasBase = pdaManager_1.PDAManager.deriveJoinSeasonPdas({
-        user: options.user,
-        seasonNumber: options.seasonNumber,
-        tier: options.tier,
-        tokenMint,
-        launchpadTokenMint: tokenMint, // Sunpool uses tokenMint for Season/Membership PDAs
-    });
-    // Derive Sunpool PDA
-    const [sunpoolPda] = (0, pdas_1.getSunpoolPda)(tokenMint);
-    // User join credit vault ATA
-    const userJoinCreditVault = (0, spl_token_1.getAssociatedTokenAddressSync)(constants_1.MIZD_TOKEN_MINT, pdasBase.userJoinCredit, true);
-    // Token accounts
-    const rootAdminTokenAccount = (0, spl_token_1.getAssociatedTokenAddressSync)(constants_1.MIZD_TOKEN_MINT, constants_1.ADMIN_PUBLIC_KEY);
-    const userMizdAta = (0, spl_token_1.getAssociatedTokenAddressSync)(constants_1.MIZD_TOKEN_MINT, options.user);
-    const pdas = {
-        seasonSettings: pdasBase.seasonSettings,
-        season: pdasBase.season,
-        seasonMembership: pdasBase.seasonMembership,
-        sunpool: sunpoolPda,
-        seasonDepositVault: pdasBase.seasonDepositVault,
-        userJoinCredit: pdasBase.userJoinCredit,
-        userJoinCreditVault,
-    };
-    const referrer = options.referrer ?? web3_js_1.PublicKey.default;
-    const hasReferrer = !referrer.equals(web3_js_1.PublicKey.default);
-    // Validate referrer tier
-    if (hasReferrer && options.referrerTier === undefined) {
-        throw new Error("referrerTier is required when referrer is provided");
-    }
-    const accounts = {
-        seasonSettings: pdas.seasonSettings,
-        season: pdas.season,
-        seasonMembership: pdas.seasonMembership,
-        sunpool: sunpoolPda,
-        seasonDepositVault: pdas.seasonDepositVault,
-        userJoinCredit: pdas.userJoinCredit,
-        userJoinCreditVault,
-        mizdMint: constants_1.MIZD_TOKEN_MINT,
-        tokenMint,
-        rootAdmin: constants_1.ADMIN_PUBLIC_KEY,
-        rootAdminTokenAccount,
-        userTokenAccount: userMizdAta,
-        user: options.user,
-        associatedTokenProgram: spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID,
-        tokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
-        systemProgram: web3_js_1.SystemProgram.programId,
-    };
-    const instruction = await program.methods
-        .joinSunpool(options.seasonNumber, options.tier, referrer, options.referrerTier ?? 0, options.star ?? false, options.starFlagPrompt ?? "", options.symbol ?? "")
-        .accounts(accounts)
-        .instruction();
-    // For star joins, root admin pays
-    const feePayer = options.star ? constants_1.ADMIN_PUBLIC_KEY : (0, signerHelpers_1.getDefaultFeePayer)(options.feePayer);
-    // Build signers array
-    const signersList = [
-        (0, signerHelpers_1.asAdminSigner)(constants_1.ADMIN_PUBLIC_KEY),
-        (0, signerHelpers_1.asUserSigner)(options.user),
-    ];
-    const signers = (0, signerHelpers_1.buildSigners)(signersList, feePayer);
-    return {
-        instructions: [instruction],
-        signers,
-        pdas,
-    };
-}
-/**
- * Convenience wrapper for launchpad mode joins.
- *
- * This function automatically determines whether to call:
- * - createMoonpool (if forceNewLaunchpadMint=true or no existing moonpool)
- * - joinMoonpoolSeason (if joining an existing moonpool)
- *
- * @param options - Join options
- * @returns Instructions, signers, PDAs, and metadata
- */
-async function joinSeasonLaunchpad(options) {
-    // Determine if we're creating a new Moonpool or joining an existing one
-    const shouldCreateNewMoonpool = options.forceNewLaunchpadMint ||
-        !options.currentAccounts?.moonpool ||
-        options.currentAccounts.moonpool.launchpadTokenMint?.equals(web3_js_1.PublicKey.default);
-    if (shouldCreateNewMoonpool) {
-        // Creating a new Moonpool - starFlagPrompt and symbol are required
-        if (!options.starFlagPrompt) {
-            throw new Error("starFlagPrompt is required when creating a new Moonpool");
-        }
-        if (!options.symbol) {
-            throw new Error("symbol is required when creating a new Moonpool");
-        }
-        return createMoonpool({
-            connection: options.connection,
-            user: options.user,
-            seasonNumber: options.seasonNumber,
-            tier: options.tier,
-            starFlagPrompt: options.starFlagPrompt,
-            symbol: options.symbol,
-            ...(options.referrer !== undefined && { referrer: options.referrer }),
-            ...(options.star !== undefined && { star: options.star }),
-            ...(options.maxSolInLamports !== undefined && { maxSolInLamports: options.maxSolInLamports }),
-            ...(options.expectedSolInLamports !== undefined && { expectedSolInLamports: options.expectedSolInLamports }),
-            ...(options.maxSlippageBps !== undefined && { maxSlippageBps: options.maxSlippageBps }),
-            ...(options.now !== undefined && { now: options.now }),
-            ...(options.feePayer !== undefined && { feePayer: options.feePayer }),
-            ...(options.currentAccounts !== undefined && { currentAccounts: options.currentAccounts }),
-        });
-    }
-    else {
-        // Joining an existing Moonpool
-        const launchpadTokenMint = options.currentAccounts.moonpool.launchpadTokenMint;
-        return joinMoonpoolSeason({
-            connection: options.connection,
-            user: options.user,
-            seasonNumber: options.seasonNumber,
-            launchpadTokenMint,
-            tier: options.tier,
-            ...(options.referrer !== undefined && { referrer: options.referrer }),
-            ...(options.star !== undefined && { star: options.star }),
-            ...(options.maxSolInLamports !== undefined && { maxSolInLamports: options.maxSolInLamports }),
-            ...(options.expectedSolInLamports !== undefined && { expectedSolInLamports: options.expectedSolInLamports }),
-            ...(options.maxSlippageBps !== undefined && { maxSlippageBps: options.maxSlippageBps }),
-            ...(options.now !== undefined && { now: options.now }),
-            ...(options.feePayer !== undefined && { feePayer: options.feePayer }),
-            ...(options.currentAccounts !== undefined && { currentAccounts: options.currentAccounts }),
-        });
-    }
-}
-/**
- * Convenience wrapper for classic (non-launchpad) mode joins.
- * Routes to joinSunpool instruction.
- *
- * @param options - Join options
- * @returns Instructions, signers, and PDAs
- */
-async function joinSeasonClassic(options) {
-    return joinSunpool({
-        connection: options.connection,
-        user: options.user,
-        seasonNumber: options.seasonNumber,
-        tier: options.tier,
-        ...(options.tokenMint !== undefined && { tokenMint: options.tokenMint }),
-        ...(options.referrer !== undefined && { referrer: options.referrer }),
-        ...(options.referrerTier !== undefined && { referrerTier: options.referrerTier }),
-        ...(options.star !== undefined && { star: options.star }),
-        ...(options.starFlagPrompt !== undefined && { starFlagPrompt: options.starFlagPrompt }),
-        ...(options.symbol !== undefined && { symbol: options.symbol }),
-        ...(options.now !== undefined && { now: options.now }),
-        ...(options.feePayer !== undefined && { feePayer: options.feePayer }),
-        ...(options.currentAccounts !== undefined && { currentAccounts: options.currentAccounts }),
-    });
-}