proof-of-take-sdk 3.0.12 → 3.0.13

package/dist/instructions/joinSeason.d.ts

@@ -14,6 +14,8 @@ export interface JoinSeasonOptions {
     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;
     /** Optional injected timestamp (seconds) for optimistic state calculation */
     now?: BN;
     feePayer?: PublicKey;
@@ -41,6 +43,10 @@ type JoinSeasonUpdatedAccounts = {
  * User pays for season (if needed) and membership accounts
  * Transfers full tier deposit from user to vault, then escrows the pre-join portion
  *
+ * 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.
+ *
  * @param options - Join season options
  * @returns Instructions, signers, PDAs, and optimistically created/updated accounts
  */

package/dist/instructions/joinSeason.js

@@ -21,6 +21,10 @@ const remainingAccounts_1 = require("../utils/remainingAccounts");
  * User pays for season (if needed) and membership accounts
  * Transfers full tier deposit from user to vault, then escrows the pre-join portion
  *
+ * 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.
+ *
  * @param options - Join season options
  * @returns Instructions, signers, PDAs, and optimistically created/updated accounts
  */
@@ -48,11 +52,19 @@ async function joinSeason(options) {
         systemProgram: web3_js_1.SystemProgram.programId,
     };
     const referrer = options.referrer ?? web3_js_1.PublicKey.default;
-    const remainingAccounts = (0, remainingAccounts_1.getJoinSeasonRemainingAccounts)({
-        seasonNumber: options.seasonNumber,
-        tier: options.tier,
-        referrer,
-    });
+    const hasReferrer = !referrer.equals(web3_js_1.PublicKey.default);
+    // Validate: if referrer is provided, referrerTier must also be provided
+    if (hasReferrer && options.referrerTier === undefined) {
+        throw new Error("referrerTier is required when referrer is provided");
+    }
+    const remainingAccounts = hasReferrer
+        ? (0, remainingAccounts_1.getJoinSeasonRemainingAccounts)({
+            seasonNumber: options.seasonNumber,
+            tier: options.tier,
+            referrer,
+            referrerTier: options.referrerTier,
+        })
+        : [];
     const methodBuilder = program.methods
         // Anchor expects BN for u64 args.
         .joinSeason(options.seasonNumber, options.tier, referrer)

package/dist/utils/remainingAccounts.d.ts

@@ -15,4 +15,5 @@ export declare function getJoinSeasonRemainingAccounts(params: {
     seasonNumber: BN;
     tier: TierNumber;
     referrer: PublicKey;
+    referrerTier: TierNumber;
 }): AccountMeta[];

package/dist/utils/remainingAccounts.js

@@ -17,7 +17,7 @@ const constants_1 = require("./constants");
 function getJoinSeasonRemainingAccounts(params) {
     if (params.referrer.equals(web3_js_1.PublicKey.default))
         return [];
-    const [referrerSeasonMembership] = (0, pdas_1.getSeasonMembershipPda)(params.seasonNumber, params.referrer, params.tier);
+    const [referrerSeasonMembership] = (0, pdas_1.getSeasonMembershipPda)(params.seasonNumber, params.referrer, params.referrerTier);
     const [signupRewardsPda] = (0, pdas_1.getSignupRewardsPda)(params.seasonNumber, params.referrer);
     // IMPORTANT: PDA owners are off-curve; allowOwnerOffCurve must be true.
     const signupRewardsMizdAta = (0, spl_token_1.getAssociatedTokenAddressSync)(constants_1.MIZD_TOKEN_MINT, signupRewardsPda, true);

package/package.json

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