proof-of-take-sdk 4.0.0 → 5.0.1

package/dist/idl/proof_of_take.json

@@ -314,7 +314,7 @@
         {
           "name": "moonpool",
           "docs": [
-            "Global Moonpool PDA (required when `season.launchpad == true`).",
+            "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."
           ],
@@ -667,7 +667,7 @@
         {
           "name": "moonpool",
           "docs": [
-            "Global Moonpool PDA (required when `season.launchpad == true`).",
+            "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."
           ],
@@ -1096,7 +1096,7 @@
         {
           "name": "moonpool",
           "docs": [
-            "Global Moonpool PDA (required when `season.launchpad == true`).",
+            "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."
           ],
@@ -3570,6 +3570,10 @@
         {
           "name": "star_flag_prompt",
           "type": "string"
+        },
+        {
+          "name": "symbol",
+          "type": "string"
         }
       ]
     },
@@ -5695,76 +5699,86 @@
     },
     {
       "code": 6061,
+      "name": "SymbolTooLong",
+      "msg": "Symbol cannot be longer than 4 characters"
+    },
+    {
+      "code": 6062,
+      "name": "SymbolRequired",
+      "msg": "Symbol is required when initializing a new pool"
+    },
+    {
+      "code": 6063,
       "name": "InvalidUserJoinCreditOwner",
       "msg": "Invalid user join credit owner"
     },
     {
-      "code": 6062,
+      "code": 6064,
       "name": "JoinCreditPendingSeasonMismatch",
       "msg": "Pending join credit is locked for a different season than expected"
     },
     {
-      "code": 6063,
+      "code": 6065,
       "name": "MissingLaunchpadPoolAccount",
       "msg": "Missing required launchpad pool account"
     },
     {
-      "code": 6064,
+      "code": 6066,
       "name": "MissingLaunchpadTreasuryAccount",
       "msg": "Missing required launchpad treasury account"
     },
     {
-      "code": 6065,
+      "code": 6067,
       "name": "LaunchpadModeMismatch",
       "msg": "Launchpad mode mismatch (season launchpad flag does not match instruction argument)"
     },
     {
-      "code": 6066,
+      "code": 6068,
       "name": "InsufficientLaunchpadTokenReserve",
       "msg": "Insufficient launchpad token reserve in pool"
     },
     {
-      "code": 6067,
+      "code": 6069,
       "name": "InsufficientLaunchpadTokenEscrow",
       "msg": "Insufficient launchpad token escrow balance"
     },
     {
-      "code": 6068,
+      "code": 6070,
       "name": "LaunchpadMaxSolExceeded",
       "msg": "Launchpad buy exceeds max SOL input (slippage)"
     },
     {
-      "code": 6069,
+      "code": 6071,
       "name": "MissingRequiredAccount",
       "msg": "Missing required account for this mode"
     },
     {
-      "code": 6070,
+      "code": 6072,
       "name": "UnexpectedAccountForMode",
       "msg": "Unexpected account provided for this mode"
     },
     {
-      "code": 6071,
+      "code": 6073,
       "name": "LaunchpadModeRequired",
       "msg": "Launchpad mode is required: launchpad pool is already initialized"
     },
     {
-      "code": 6072,
+      "code": 6074,
       "name": "ClassicModeRequired",
       "msg": "Classic mode is required: sunpool is already initialized"
     },
     {
-      "code": 6073,
+      "code": 6075,
       "name": "InvariantViolation",
       "msg": "AMM invariant violation: k decreased after trade (this should never happen)"
     },
     {
-      "code": 6074,
+      "code": 6076,
       "name": "InvalidLaunchpadTokenMint",
       "msg": "Invalid launchpad token mint: does not match the stored mint in Moonpool"
     },
     {
-      "code": 6075,
+      "code": 6077,
       "name": "InvalidSunpoolTokenMint",
       "msg": "Invalid sunpool token mint: does not match the stored mint in Sunpool"
     }
@@ -6502,6 +6516,38 @@
               "Unix timestamp when the Moonpool was initialized."
             ],
             "type": "i64"
+          },
+          {
+            "name": "star_flag_prompt",
+            "docs": [
+              "Star flag prompt: a short message (max 33 chars) displayed when users raise their flag.",
+              "Example: \"Show your star to the Moon!\""
+            ],
+            "type": "string"
+          },
+          {
+            "name": "symbol",
+            "docs": [
+              "Token symbol (max 4 chars, e.g., \"MOON\", \"SOL\")."
+            ],
+            "type": "string"
+          }
+        ]
+      }
+    },
+    {
+      "name": "PoolType",
+      "type": {
+        "kind": "enum",
+        "variants": [
+          {
+            "name": "Uninitialized"
+          },
+          {
+            "name": "Sunpool"
+          },
+          {
+            "name": "Moonpool"
           }
         ]
       }
@@ -6947,22 +6993,23 @@
             "type": "u64"
           },
           {
-            "name": "launchpad",
+            "name": "pool_type",
             "docs": [
-              "Launchpad mode flag.",
+              "Pool type for this season.",
               "",
-              "If true, this season uses a SOL↔virtual-token launchpad pool and claim flows pay SOL by",
-              "selling escrowed virtual tokens. No SPL \"season token\" is minted or transferred."
-            ],
-            "type": "bool"
-          },
-          {
-            "name": "star_flag_prompt",
-            "docs": [
-              "Star flag prompt: a short message (max 33 chars) displayed when users raise their flag.",
-              "Example: \"Show your star to the Moon!\""
+              "- Uninitialized: Season not yet configured with a pool type",
+              "- Sunpool: Classic mode with SPL token transfers (non-launchpad)",
+              "- Moonpool: Launchpad mode with SOL↔virtual-token pool; claim flows pay SOL by",
+              "selling escrowed virtual tokens. No SPL \"season token\" is minted or transferred.",
+              "",
+              "Note: The pool account itself can be derived via PDA (Moonpool or Sunpool)",
+              "using the token_mint field, so we don't store it here."
             ],
-            "type": "string"
+            "type": {
+              "defined": {
+                "name": "PoolType"
+              }
+            }
           },
           {
             "name": "bump",
@@ -7536,6 +7583,21 @@
               "Timestamp when this Sunpool was initialized."
             ],
             "type": "i64"
+          },
+          {
+            "name": "star_flag_prompt",
+            "docs": [
+              "Star flag prompt: a short message (max 33 chars) displayed when users raise their flag.",
+              "Example: \"Show your star to the Sun!\""
+            ],
+            "type": "string"
+          },
+          {
+            "name": "symbol",
+            "docs": [
+              "Token symbol (max 4 chars, e.g., \"MIZD\", \"USDT\")."
+            ],
+            "type": "string"
           }
         ]
       }

package/dist/instructions/joinSeason.d.ts

@@ -34,9 +34,14 @@ export interface JoinSeasonOptions {
     maxSlippageBps?: number;
     /**
      * Star flag prompt: a short message (max 33 chars) displayed when users raise their flag.
-     * Only used when initializing a new season (first join). Ignored when joining existing season.
+     * 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;
     /** Optional injected timestamp (seconds) for optimistic state calculation */
     now?: BN;
     feePayer?: PublicKey;
@@ -47,14 +52,19 @@ export interface JoinSeasonOptions {
 }
 /**
  * Options for initializing a new season (first joiner).
- * Requires starFlagPrompt since it will be stored in the Season account.
+ * Requires starFlagPrompt and symbol since they will be stored in the pool accounts.
  */
-export type JoinSeasonAndInitializeOptions = Omit<JoinSeasonOptions, "starFlagPrompt"> & {
+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 season.
+     * 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;
 };
 /**
  * Options for the classic (non-launchpad) joinSeason wrapper.

package/dist/instructions/joinSeason.js

@@ -96,7 +96,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 ?? "")
+        .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 ?? "")
         .accounts(accounts);
     if (remainingAccounts.length > 0) {
         methodBuilder.remainingAccounts(remainingAccounts);

package/dist/types/proof_of_take.d.ts

@@ -320,7 +320,7 @@ export type ProofOfTake = {
                 {
                     "name": "moonpool";
                     "docs": [
-                        "Global Moonpool PDA (required when `season.launchpad == true`).",
+                        "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."
                     ];
@@ -673,7 +673,7 @@ export type ProofOfTake = {
                 {
                     "name": "moonpool";
                     "docs": [
-                        "Global Moonpool PDA (required when `season.launchpad == true`).",
+                        "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."
                     ];
@@ -1102,7 +1102,7 @@ export type ProofOfTake = {
                 {
                     "name": "moonpool";
                     "docs": [
-                        "Global Moonpool PDA (required when `season.launchpad == true`).",
+                        "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."
                     ];
@@ -3576,6 +3576,10 @@ export type ProofOfTake = {
                 {
                     "name": "starFlagPrompt";
                     "type": "string";
+                },
+                {
+                    "name": "symbol";
+                    "type": "string";
                 }
             ];
         },
@@ -5701,76 +5705,86 @@ export type ProofOfTake = {
         },
         {
             "code": 6061;
+            "name": "symbolTooLong";
+            "msg": "Symbol cannot be longer than 4 characters";
+        },
+        {
+            "code": 6062;
+            "name": "symbolRequired";
+            "msg": "Symbol is required when initializing a new pool";
+        },
+        {
+            "code": 6063;
             "name": "invalidUserJoinCreditOwner";
             "msg": "Invalid user join credit owner";
         },
         {
-            "code": 6062;
+            "code": 6064;
             "name": "joinCreditPendingSeasonMismatch";
             "msg": "Pending join credit is locked for a different season than expected";
         },
         {
-            "code": 6063;
+            "code": 6065;
             "name": "missingLaunchpadPoolAccount";
             "msg": "Missing required launchpad pool account";
         },
         {
-            "code": 6064;
+            "code": 6066;
             "name": "missingLaunchpadTreasuryAccount";
             "msg": "Missing required launchpad treasury account";
         },
         {
-            "code": 6065;
+            "code": 6067;
             "name": "launchpadModeMismatch";
             "msg": "Launchpad mode mismatch (season launchpad flag does not match instruction argument)";
         },
         {
-            "code": 6066;
+            "code": 6068;
             "name": "insufficientLaunchpadTokenReserve";
             "msg": "Insufficient launchpad token reserve in pool";
         },
         {
-            "code": 6067;
+            "code": 6069;
             "name": "insufficientLaunchpadTokenEscrow";
             "msg": "Insufficient launchpad token escrow balance";
         },
         {
-            "code": 6068;
+            "code": 6070;
             "name": "launchpadMaxSolExceeded";
             "msg": "Launchpad buy exceeds max SOL input (slippage)";
         },
         {
-            "code": 6069;
+            "code": 6071;
             "name": "missingRequiredAccount";
             "msg": "Missing required account for this mode";
         },
         {
-            "code": 6070;
+            "code": 6072;
             "name": "unexpectedAccountForMode";
             "msg": "Unexpected account provided for this mode";
         },
         {
-            "code": 6071;
+            "code": 6073;
             "name": "launchpadModeRequired";
             "msg": "Launchpad mode is required: launchpad pool is already initialized";
         },
         {
-            "code": 6072;
+            "code": 6074;
             "name": "classicModeRequired";
             "msg": "Classic mode is required: sunpool is already initialized";
         },
         {
-            "code": 6073;
+            "code": 6075;
             "name": "invariantViolation";
             "msg": "AMM invariant violation: k decreased after trade (this should never happen)";
         },
         {
-            "code": 6074;
+            "code": 6076;
             "name": "invalidLaunchpadTokenMint";
             "msg": "Invalid launchpad token mint: does not match the stored mint in Moonpool";
         },
         {
-            "code": 6075;
+            "code": 6077;
             "name": "invalidSunpoolTokenMint";
             "msg": "Invalid sunpool token mint: does not match the stored mint in Sunpool";
         }
@@ -6508,6 +6522,38 @@ export type ProofOfTake = {
                             "Unix timestamp when the Moonpool was initialized."
                         ];
                         "type": "i64";
+                    },
+                    {
+                        "name": "starFlagPrompt";
+                        "docs": [
+                            "Star flag prompt: a short message (max 33 chars) displayed when users raise their flag.",
+                            "Example: \"Show your star to the Moon!\""
+                        ];
+                        "type": "string";
+                    },
+                    {
+                        "name": "symbol";
+                        "docs": [
+                            "Token symbol (max 4 chars, e.g., \"MOON\", \"SOL\")."
+                        ];
+                        "type": "string";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "poolType";
+            "type": {
+                "kind": "enum";
+                "variants": [
+                    {
+                        "name": "uninitialized";
+                    },
+                    {
+                        "name": "sunpool";
+                    },
+                    {
+                        "name": "moonpool";
                     }
                 ];
             };
@@ -6953,22 +6999,23 @@ export type ProofOfTake = {
                         "type": "u64";
                     },
                     {
-                        "name": "launchpad";
+                        "name": "poolType";
                         "docs": [
-                            "Launchpad mode flag.",
+                            "Pool type for this season.",
                             "",
-                            "If true, this season uses a SOL↔virtual-token launchpad pool and claim flows pay SOL by",
-                            "selling escrowed virtual tokens. No SPL \"season token\" is minted or transferred."
-                        ];
-                        "type": "bool";
-                    },
-                    {
-                        "name": "starFlagPrompt";
-                        "docs": [
-                            "Star flag prompt: a short message (max 33 chars) displayed when users raise their flag.",
-                            "Example: \"Show your star to the Moon!\""
+                            "- Uninitialized: Season not yet configured with a pool type",
+                            "- Sunpool: Classic mode with SPL token transfers (non-launchpad)",
+                            "- Moonpool: Launchpad mode with SOL↔virtual-token pool; claim flows pay SOL by",
+                            "selling escrowed virtual tokens. No SPL \"season token\" is minted or transferred.",
+                            "",
+                            "Note: The pool account itself can be derived via PDA (Moonpool or Sunpool)",
+                            "using the token_mint field, so we don't store it here."
                         ];
-                        "type": "string";
+                        "type": {
+                            "defined": {
+                                "name": "poolType";
+                            };
+                        };
                     },
                     {
                         "name": "bump";
@@ -7542,6 +7589,21 @@ export type ProofOfTake = {
                             "Timestamp when this Sunpool was initialized."
                         ];
                         "type": "i64";
+                    },
+                    {
+                        "name": "starFlagPrompt";
+                        "docs": [
+                            "Star flag prompt: a short message (max 33 chars) displayed when users raise their flag.",
+                            "Example: \"Show your star to the Sun!\""
+                        ];
+                        "type": "string";
+                    },
+                    {
+                        "name": "symbol";
+                        "docs": [
+                            "Token symbol (max 4 chars, e.g., \"MIZD\", \"USDT\")."
+                        ];
+                        "type": "string";
                     }
                 ];
             };

package/dist/types.d.ts

@@ -100,14 +100,21 @@ export declare enum WindowState {
     Active = 1,
     Finalized = 2
 }
+export declare enum PoolType {
+    Uninitialized = 0,
+    Sunpool = 1,
+    Moonpool = 2
+}
 /**
  * Anchor enum formats returned by account fetches.
  * We accept both the SDK numeric enums and Anchor object enums throughout the SDK.
  */
 export type SeasonStateAnchor = AnchorEnumVariant<"uninitialized"> | AnchorEnumVariant<"active"> | AnchorEnumVariant<"ended">;
 export type WindowStateAnchor = AnchorEnumVariant<"uninitialized"> | AnchorEnumVariant<"active"> | AnchorEnumVariant<"finalized">;
+export type PoolTypeAnchor = AnchorEnumVariant<"uninitialized"> | AnchorEnumVariant<"sunpool"> | AnchorEnumVariant<"moonpool">;
 export type SeasonStateLike = SeasonState | SeasonStateAnchor | number;
 export type WindowStateLike = WindowState | WindowStateAnchor | number;
+export type PoolTypeLike = PoolType | PoolTypeAnchor | number;
 /**
  * Season deposit tier (Anchor enum representation)
  *
@@ -166,9 +173,7 @@ export interface Season {
     totalSuccessfulPosts: BN;
     totalPenaltiesCollected: BN;
     totalUnallocatedFunds: BN;
-    launchpad: boolean;
-    /** Star flag prompt: a short message (max 33 chars) displayed when users raise their flag. */
-    starFlagPrompt: string;
+    poolType: PoolTypeLike;
     bump: number;
 }
 export interface SeasonMembership {

package/dist/types.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WindowState = exports.SeasonState = void 0;
+exports.PoolType = exports.WindowState = exports.SeasonState = void 0;
 // Season Membership State Types
 var SeasonState;
 (function (SeasonState) {
@@ -14,3 +14,9 @@ var WindowState;
     WindowState[WindowState["Active"] = 1] = "Active";
     WindowState[WindowState["Finalized"] = 2] = "Finalized";
 })(WindowState || (exports.WindowState = WindowState = {}));
+var PoolType;
+(function (PoolType) {
+    PoolType[PoolType["Uninitialized"] = 0] = "Uninitialized";
+    PoolType[PoolType["Sunpool"] = 1] = "Sunpool";
+    PoolType[PoolType["Moonpool"] = 2] = "Moonpool";
+})(PoolType || (exports.PoolType = PoolType = {}));

package/dist/utils/accountConverters.js

@@ -88,8 +88,7 @@ function toSdkSeason(a) {
         totalSuccessfulPosts: a.totalSuccessfulPosts,
         totalPenaltiesCollected: a.totalPenaltiesCollected,
         totalUnallocatedFunds: a.totalUnallocatedFunds,
-        launchpad: a.launchpad,
-        starFlagPrompt: a.starFlagPrompt,
+        poolType: a.poolType,
         bump: a.bump,
     };
 }

package/dist/utils/accountUpdates.js

@@ -99,8 +99,7 @@ function expectedToBeLazyInitialized(params) {
         totalSuccessfulPosts: new anchor_1.BN(0),
         totalPenaltiesCollected: new anchor_1.BN(0),
         totalUnallocatedFunds: new anchor_1.BN(0),
-        launchpad: false,
-        starFlagPrompt: "",
+        poolType: types_1.PoolType.Sunpool,
         bump,
     };
 }

package/package.json

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