proof-of-take-sdk 5.0.11 → 5.0.13

package/dist/index.d.ts

@@ -11,8 +11,8 @@ export type { CreateMiztakeOptions, CreateMiztakeResult, CreateMiztakePdas, Crea
 export { initializeStatistics, isInitialized, } from "./instructions/initializeStatistics";
 export { initializeSeasonSettings } from "./instructions/initializeSeasonSettings";
 export { initializeSeasonVault } from "./instructions/initializeSeasonVault";
-export { joinSeason, joinSeasonClassic, joinSeasonLaunchpad, joinSeasonAndInitialize, joinSeasonLaunchpadAndInitialize, } from "./instructions/joinSeason";
-export type { JoinSeasonOptions, JoinSeasonClassicOptions, JoinSeasonLaunchpadOptions, JoinSeasonAndInitializeOptions, } from "./instructions/joinSeason";
+export { createMoonpool, joinMoonpoolSeason, joinSunpool, joinSeasonClassic, joinSeasonLaunchpad, } from "./instructions/joinSeason";
+export type { CreateMoonpoolOptions, JoinMoonpoolSeasonOptions, JoinSunpoolOptions, JoinSeasonClassicOptions, JoinSeasonLaunchpadOptions, } from "./instructions/joinSeason";
 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.joinSeasonLaunchpadAndInitialize = exports.joinSeasonAndInitialize = exports.joinSeasonLaunchpad = exports.joinSeasonClassic = exports.joinSeason = 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.joinSeasonLaunchpad = exports.joinSeasonClassic = 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
@@ -42,11 +42,11 @@ 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, "joinSeason", { enumerable: true, get: function () { return joinSeason_1.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; } });
-Object.defineProperty(exports, "joinSeasonAndInitialize", { enumerable: true, get: function () { return joinSeason_1.joinSeasonAndInitialize; } });
-Object.defineProperty(exports, "joinSeasonLaunchpadAndInitialize", { enumerable: true, get: function () { return joinSeason_1.joinSeasonLaunchpadAndInitialize; } });
 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/joinSeason.d.ts

@@ -3,164 +3,250 @@ import { Connection, Keypair, PublicKey } from "@solana/web3.js";
 import { Season, SeasonMembership, SeasonSettings, TierNumber } from "../types";
 import { StandardInstructionResultWithPdas } from "../types/instructionResults";
 /**
- * Options for joinSeason instruction (joining an existing season)
+ * Options for createMoonpool instruction (creating a new Moonpool + first join)
  */
-export interface JoinSeasonOptions {
+export interface CreateMoonpoolOptions {
     connection: Connection;
     user: PublicKey;
     seasonNumber: BN;
-    /** Token mint this season is scoped to (used for PDA derivation). 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; must match the tier they joined with) */
-    referrerTier?: TierNumber;
-    /** If true, root admin funds join fee + deposit (currently only allowed for tier=0 on-chain). */
+    /** If true, root admin funds the SOL for the join. */
     star?: boolean;
-    /** If true, join uses launchpad mode (SOL in, virtual tokens escrowed; no SPL token accounts needed). */
-    launchpad?: boolean;
-    /** Launchpad slippage cap (lamports). Only used when launchpad=true. Defaults to u64::MAX. */
+    /** Hard cap in lamports for slippage protection. */
     maxSolInLamports?: BN;
-    /**
-     * Launchpad slippage ergonomics:
-     * - Provide `expectedSolInLamports` (your quote) and `maxSlippageBps` and the program will enforce
-     *   `sol_required <= expected * (1 + bps/10_000)`.
-     * - If both this and `maxSolInLamports` are provided, the program uses the tighter cap.
-     */
+    /** Expected SOL in lamports for bps slippage protection. */
     expectedSolInLamports?: BN;
-    /** Max slippage in basis points (0..=10_000). Used only when expectedSolInLamports > 0. */
+    /** Max slippage in basis points (0..=5000). */
     maxSlippageBps?: number;
-    /**
-     * Star flag prompt: a short message (max 33 chars) displayed when users raise their flag.
-     * Only used when initializing a new pool (first join). Ignored when joining existing season.
-     */
-    starFlagPrompt?: string;
-    /**
-     * Token symbol (max 4 chars, e.g., "MIZD", "USDT", "MOON").
-     * Only used when initializing a new pool (first join). Ignored when joining existing season.
-     */
-    symbol?: string;
-    /**
-     * Force generating a new launchpad token mint keypair, even if a moonpool already exists on-chain.
-     * Use this when creating a NEW Moonpool (i.e., the on-chain moonpool account may exist but was
-     * never fully initialized, or you want to start fresh with a new token mint).
-     * Only applies to launchpad mode.
-     */
-    forceNewLaunchpadMint?: boolean;
+    /** 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;
-        moonpool?: any;
     };
 }
-/**
- * Options for initializing a new season (first joiner).
- * Requires starFlagPrompt and symbol since they will be stored in the pool accounts.
- */
-export type JoinSeasonAndInitializeOptions = Omit<JoinSeasonOptions, "starFlagPrompt" | "symbol"> & {
-    /**
-     * Star flag prompt: a short message (max 33 chars) displayed when users raise their flag.
-     * REQUIRED when initializing a new pool.
-     */
-    starFlagPrompt: string;
-    /**
-     * Token symbol (max 4 chars, e.g., "MIZD", "USDT", "MOON").
-     * REQUIRED when initializing a new pool.
-     */
-    symbol: string;
+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;
 };
 /**
- * Options for the classic (non-launchpad) joinSeason wrapper.
- * This avoids exposing nullable optional accounts to app code.
+ * 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 type JoinSeasonClassicOptions = Omit<JoinSeasonOptions, "launchpad" | "maxSolInLamports" | "expectedSolInLamports" | "maxSlippageBps"> & {
-    launchpad?: never;
-    maxSolInLamports?: never;
-    expectedSolInLamports?: never;
-    maxSlippageBps?: never;
-};
+export declare function createMoonpool(options: CreateMoonpoolOptions): Promise<StandardInstructionResultWithPdas<CreateMoonpoolPdas, CreateMoonpoolUpdatedAccounts, CreateMoonpoolMeta>>;
 /**
- * Options for the launchpad joinSeason wrapper.
- * (No SPL token accounts needed; user pays SOL to the pool PDA.)
+ * Options for joinMoonpoolSeason instruction (joining an existing Moonpool)
  */
-export type JoinSeasonLaunchpadOptions = Omit<JoinSeasonOptions, "launchpad" | "maxSolInLamports" | "expectedSolInLamports" | "maxSlippageBps"> & {
-    launchpad?: never;
-    /** Optional hard cap in lamports (0 disables this cap on-chain). */
+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;
-    /** Optional expected SOL in lamports for bps slippage protection (0 disables on-chain). */
+    /** Expected SOL in lamports for bps slippage protection. */
     expectedSolInLamports?: BN;
-    /** Optional max slippage bps (0 disables on-chain). */
+    /** Max slippage in basis points (0..=5000). */
     maxSlippageBps?: number;
-};
-type JoinSeasonPdas = {
+    /** 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 JoinSeasonMeta = {
-    /** The keypair used for the launchpad mint (only set if auto-generated) */
-    launchpadTokenMintKeypair?: Keypair;
-};
-type JoinSeasonUpdatedAccounts = {
+type JoinSunpoolUpdatedAccounts = {
     seasonSettings?: SeasonSettings;
     season?: Season;
     seasonMembership?: SeasonMembership;
 };
 /**
- * Join a season
- *
- * Signers: user + root admin (root admin pays for signup-rewards vault ATA creation when a referrer is present)
- * User pays for season (if needed) and membership accounts
- * Transfers active deposit into the season vault; the late-join escrow portion is converted into non-withdrawable join credit
+ * Join a Sunpool season (classic mode with MIZD).
  *
- * IMPORTANT: If providing a referrer, you MUST also provide referrerTier.
- * The referrerTier must match the tier the referrer actually joined the season with.
- * The referrer must have already joined the season before being used as a referrer.
+ * This instruction:
+ * - Lazily initializes Sunpool if needed
+ * - Lazily initializes Season if needed
+ * - Creates SeasonMembership
+ * - Handles MIZD token transfers and join credit
  *
- * @param options - Join season options
- * @returns Instructions, signers, PDAs, and optimistically created/updated accounts
+ * @param options - JoinSunpool options
+ * @returns Instructions, signers, and PDAs
  */
-export declare function joinSeason(options: JoinSeasonOptions): Promise<StandardInstructionResultWithPdas<JoinSeasonPdas, JoinSeasonUpdatedAccounts, JoinSeasonMeta>>;
+export declare function joinSunpool(options: JoinSunpoolOptions): Promise<StandardInstructionResultWithPdas<JoinSunpoolPdas, JoinSunpoolUpdatedAccounts>>;
 /**
- * Convenience wrapper: classic (non-launchpad) joinSeason.
- * - Keeps the existing MIZD-based join behavior.
- * - App code never passes nullable optional accounts.
+ * Options for the launchpad joinSeason wrapper.
+ * This is a convenience alias that routes to createMoonpool or joinMoonpoolSeason.
  */
-export declare function joinSeasonClassic(options: JoinSeasonClassicOptions): Promise<StandardInstructionResultWithPdas<JoinSeasonPdas, JoinSeasonUpdatedAccounts, JoinSeasonMeta>>;
+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: launchpad joinSeason.
- * - Uses SOL in + virtual token escrow.
- * - App code never passes nullable optional accounts.
+ * 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<JoinSeasonPdas, JoinSeasonUpdatedAccounts, JoinSeasonMeta>>;
+export declare function joinSeasonLaunchpad(options: JoinSeasonLaunchpadOptions): Promise<StandardInstructionResultWithPdas<any, any, JoinSeasonLaunchpadMeta>>;
 /**
- * Join season AND initialize it (first joiner).
- * Use this when you know the season doesn't exist yet.
- *
- * @param options - Options with REQUIRED starFlagPrompt
- * @throws Error if starFlagPrompt is empty or exceeds 33 characters
+ * Options for the classic (non-launchpad) joinSeason wrapper.
  */
-export declare function joinSeasonAndInitialize(options: JoinSeasonAndInitializeOptions): Promise<StandardInstructionResultWithPdas<JoinSeasonPdas, JoinSeasonUpdatedAccounts, JoinSeasonMeta>>;
+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;
+    };
+};
 /**
- * Join season AND initialize it in launchpad mode (first joiner).
- * Use this when you know the season doesn't exist yet and want launchpad mode.
+ * Convenience wrapper for classic (non-launchpad) mode joins.
+ * Routes to joinSunpool instruction.
  *
- * @param options - Options with REQUIRED starFlagPrompt
- * @throws Error if starFlagPrompt is empty or exceeds 33 characters
+ * @param options - Join options
+ * @returns Instructions, signers, and PDAs
  */
-export declare function joinSeasonLaunchpadAndInitialize(options: Omit<JoinSeasonLaunchpadOptions, "starFlagPrompt"> & {
-    starFlagPrompt: string;
-}): Promise<StandardInstructionResultWithPdas<JoinSeasonPdas, JoinSeasonUpdatedAccounts, JoinSeasonMeta>>;
+export declare function joinSeasonClassic(options: JoinSeasonClassicOptions): Promise<StandardInstructionResultWithPdas<JoinSunpoolPdas, JoinSunpoolUpdatedAccounts>>;
 export {};