proof-of-take-sdk 3.0.1 → 3.0.3

package/dist/utils/depositTier.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDepositTierName = getDepositTierName;
+exports.isDepositTier = isDepositTier;
+function getDepositTierName(tier) {
+    if ("copper" in tier)
+        return "copper";
+    if ("silver" in tier)
+        return "silver";
+    if ("gold" in tier)
+        return "gold";
+    if ("platinum" in tier)
+        return "platinum";
+    if ("mithril" in tier)
+        return "mithril";
+    // Exhaustiveness fallback (should be unreachable if SeasonDepositTier stays in sync)
+    throw new Error("Unknown depositTier");
+}
+function isDepositTier(tier, name) {
+    return getDepositTierName(tier) === name;
+}

package/dist/utils/enumHelpers.d.ts

@@ -1,4 +1,4 @@
-import { SeasonState, WindowState } from "../types";
+import { SeasonState, WindowState, SeasonStateLike, WindowStateLike } from "../types";
 /**
  * Enum helper utilities
  *
@@ -22,9 +22,7 @@ import { SeasonState, WindowState } from "../types";
  * isSeasonState({ active: {} }, SeasonState.Active)     // Anchor object
  * ```
  */
-export declare function isSeasonState(state: SeasonState | {
-    [key: string]: {};
-} | number, variant: SeasonState): boolean;
+export declare function isSeasonState(state: SeasonStateLike, variant: SeasonState): boolean;
 /**
  * Check if a WindowState matches a specific variant
  *
@@ -40,24 +38,18 @@ export declare function isSeasonState(state: SeasonState | {
  * isWindowState({ finalized: {} }, WindowState.Finalized)
  * ```
  */
-export declare function isWindowState(state: WindowState | {
-    [key: string]: {};
-} | number, variant: WindowState): boolean;
+export declare function isWindowState(state: WindowStateLike, variant: WindowState): boolean;
 /**
  * Normalize SeasonState to numeric format
  *
  * @param state - Season state in any format
  * @returns Numeric representation (0=Uninitialized, 1=Active, 2=Ended)
  */
-export declare function normalizeSeasonState(state: SeasonState | {
-    [key: string]: {};
-} | number): number;
+export declare function normalizeSeasonState(state: SeasonStateLike): number;
 /**
  * Normalize WindowState to numeric format
  *
  * @param state - Window state in any format
  * @returns Numeric representation (0=Uninitialized, 1=Active, 2=Finalized)
  */
-export declare function normalizeWindowState(state: WindowState | {
-    [key: string]: {};
-} | number): number;
+export declare function normalizeWindowState(state: WindowStateLike): number;

package/dist/utils/enumHelpers.js

@@ -39,6 +39,8 @@ function isSeasonState(state, variant) {
     // Check if value is Anchor object format
     if (typeof state === "object" && state !== null && !Array.isArray(state)) {
         const key = Object.keys(state)[0];
+        if (!key)
+            return false;
         return key === variantName;
     }
     // Otherwise compare numeric values
@@ -68,6 +70,8 @@ function isWindowState(state, variant) {
     const variantName = variantMap[variant];
     if (typeof state === "object" && state !== null && !Array.isArray(state)) {
         const key = Object.keys(state)[0];
+        if (!key)
+            return false;
         return key === variantName;
     }
     return state === variant;
@@ -86,6 +90,8 @@ function normalizeSeasonState(state) {
     };
     if (typeof state === "object" && state !== null && !Array.isArray(state)) {
         const key = Object.keys(state)[0];
+        if (!key)
+            return -1;
         return map[key] ?? -1;
     }
     return state;
@@ -104,6 +110,8 @@ function normalizeWindowState(state) {
     };
     if (typeof state === "object" && state !== null && !Array.isArray(state)) {
         const key = Object.keys(state)[0];
+        if (!key)
+            return -1;
         return map[key] ?? -1;
     }
     return state;

package/dist/utils/fetchAccount.d.ts

@@ -0,0 +1,11 @@
+import type { Program } from "@coral-xyz/anchor";
+import type { PublicKey } from "@solana/web3.js";
+/**
+ * Typed fetch helper: returns null if the account does not exist / can't be decoded.
+ * Keeps callers out of try/catch ladders.
+ */
+export declare function fetchAccountOrNull<T>(fetcher: (address: PublicKey) => Promise<T>, address: PublicKey): Promise<T | null>;
+/**
+ * Convenience wrapper for Anchor `program.account.<name>.fetch`.
+ */
+export declare function fetchProgramAccountOrNull<T>(program: Program, fetcher: (address: PublicKey) => Promise<T>, address: PublicKey): Promise<T | null>;

package/dist/utils/fetchAccount.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchAccountOrNull = fetchAccountOrNull;
+exports.fetchProgramAccountOrNull = fetchProgramAccountOrNull;
+/**
+ * Typed fetch helper: returns null if the account does not exist / can't be decoded.
+ * Keeps callers out of try/catch ladders.
+ */
+async function fetchAccountOrNull(fetcher, address) {
+    try {
+        return await fetcher(address);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Convenience wrapper for Anchor `program.account.<name>.fetch`.
+ */
+async function fetchProgramAccountOrNull(program, fetcher, address) {
+    void program; // keeps signature stable if we want to extend later
+    return await fetchAccountOrNull(fetcher, address);
+}

package/dist/utils/index.js

@@ -1,2 +1,3 @@
+"use strict";
 // Utility exports
 // No additional utility exports needed - all utilities are exported directly from index.ts

package/dist/utils/pdaManager.d.ts

@@ -1,5 +1,6 @@
 import { PublicKey } from "@solana/web3.js";
 import { BN } from "@coral-xyz/anchor";
+import type { SeasonNumberLike, Sha256HexString, TierNumber } from "../types";
 /**
  * PDA Manager for deriving related PDAs together
  * Reduces boilerplate in instruction files
@@ -9,12 +10,12 @@ export declare class PDAManager {
      * Derive all PDAs needed for create_miztake instruction
      */
     static deriveMiztakePdas(params: {
-        shaHash: string;
+        shaHash: Sha256HexString | string;
         telegramId: BN;
-        seasonNumber: BN;
+        seasonNumber: SeasonNumberLike;
         windowNumber: BN;
         user: PublicKey;
-        tier: number;
+        tier: TierNumber;
     }): {
         miztake: PublicKey;
         userStats: PublicKey;
@@ -30,8 +31,8 @@ export declare class PDAManager {
      */
     static deriveJoinSeasonPdas(params: {
         user: PublicKey;
-        seasonNumber: BN;
-        tier: number;
+        seasonNumber: SeasonNumberLike;
+        tier: TierNumber;
     }): {
         seasonSettings: PublicKey;
         season: PublicKey;
@@ -44,11 +45,11 @@ export declare class PDAManager {
      */
     static deriveConfirmedPostPdas(params: {
         user: PublicKey;
-        seasonNumber: BN;
+        seasonNumber: SeasonNumberLike;
         windowNumber: BN;
-        tier: number;
+        tier: TierNumber;
         /** SHA-256 hex string (64 chars) */
-        miztakeShaHash: string;
+        miztakeShaHash: Sha256HexString | string;
     }): {
         seasonSettings: PublicKey;
         seasonMembership: PublicKey;
@@ -62,9 +63,9 @@ export declare class PDAManager {
      */
     static deriveClaimWindowRewardsPdas(params: {
         user: PublicKey;
-        seasonNumber: BN;
+        seasonNumber: SeasonNumberLike;
         windowNumber: BN;
-        tier: number;
+        tier: TierNumber;
     }): {
         seasonSettings: PublicKey;
         season: PublicKey;
@@ -78,8 +79,8 @@ export declare class PDAManager {
      */
     static deriveWithdrawDepositPdas(params: {
         user: PublicKey;
-        seasonNumber: BN;
-        tier: number;
+        seasonNumber: SeasonNumberLike;
+        tier: TierNumber;
     }): {
         seasonSettings: PublicKey;
         season: PublicKey;
@@ -92,9 +93,9 @@ export declare class PDAManager {
      */
     static deriveClaimReferralPenaltyForWindowPdas(params: {
         referredUser: PublicKey;
-        seasonNumber: BN;
+        seasonNumber: SeasonNumberLike;
         windowNumber: BN;
-        tier: number;
+        tier: TierNumber;
     }): {
         seasonSettings: PublicKey;
         season: PublicKey;

package/dist/utils/pdaManager.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PDAManager = void 0;
+const conversions_1 = require("./conversions");
 const pdas_1 = require("./pdas");
 /**
  * PDA Manager for deriving related PDAs together
@@ -11,39 +12,42 @@ class PDAManager {
      * Derive all PDAs needed for create_miztake instruction
      */
     static deriveMiztakePdas(params) {
+        const seasonNumber = (0, conversions_1.toSeasonNumberBn)(params.seasonNumber);
         return {
             miztake: (0, pdas_1.getMiztakePda)(params.shaHash)[0],
             userStats: (0, pdas_1.getUserStatsPda)(params.telegramId)[0],
             miztakeStatistics: (0, pdas_1.getMiztakeStatisticsPda)()[0],
             seasonSettings: (0, pdas_1.getSeasonSettingsPda)()[0],
-            season: (0, pdas_1.getSeasonPda)(params.seasonNumber)[0],
-            seasonMembership: (0, pdas_1.getSeasonMembershipPda)(params.seasonNumber, params.user, params.tier)[0],
-            rewardWindow: (0, pdas_1.getRewardWindowPda)(params.seasonNumber, params.windowNumber)[0],
-            userWindowParticipation: (0, pdas_1.getUserWindowParticipationPda)(params.seasonNumber, params.user, params.tier, params.windowNumber)[0],
+            season: (0, pdas_1.getSeasonPda)(seasonNumber)[0],
+            seasonMembership: (0, pdas_1.getSeasonMembershipPda)(seasonNumber, params.user, params.tier)[0],
+            rewardWindow: (0, pdas_1.getRewardWindowPda)(seasonNumber, params.windowNumber)[0],
+            userWindowParticipation: (0, pdas_1.getUserWindowParticipationPda)(seasonNumber, params.user, params.tier, params.windowNumber)[0],
         };
     }
     /**
      * Derive PDAs for join_season instruction
      */
     static deriveJoinSeasonPdas(params) {
+        const seasonNumber = (0, conversions_1.toSeasonNumberBn)(params.seasonNumber);
         return {
             seasonSettings: (0, pdas_1.getSeasonSettingsPda)()[0],
-            season: (0, pdas_1.getSeasonPda)(params.seasonNumber)[0],
-            seasonMembership: (0, pdas_1.getSeasonMembershipPda)(params.seasonNumber, params.user, params.tier)[0],
-            seasonDepositVault: (0, pdas_1.getSeasonDepositVaultPda)(params.seasonNumber)[0],
-            seasonEscrowVault: (0, pdas_1.getSeasonEscrowVaultPda)(params.seasonNumber)[0],
+            season: (0, pdas_1.getSeasonPda)(seasonNumber)[0],
+            seasonMembership: (0, pdas_1.getSeasonMembershipPda)(seasonNumber, params.user, params.tier)[0],
+            seasonDepositVault: (0, pdas_1.getSeasonDepositVaultPda)(seasonNumber)[0],
+            seasonEscrowVault: (0, pdas_1.getSeasonEscrowVaultPda)(seasonNumber)[0],
         };
     }
     /**
      * Derive PDAs for confirmed_post_on_x instruction
      */
     static deriveConfirmedPostPdas(params) {
+        const seasonNumber = (0, conversions_1.toSeasonNumberBn)(params.seasonNumber);
         return {
             seasonSettings: (0, pdas_1.getSeasonSettingsPda)()[0],
-            seasonMembership: (0, pdas_1.getSeasonMembershipPda)(params.seasonNumber, params.user, params.tier)[0],
-            season: (0, pdas_1.getSeasonPda)(params.seasonNumber)[0],
-            rewardWindow: (0, pdas_1.getRewardWindowPda)(params.seasonNumber, params.windowNumber)[0],
-            userWindowParticipation: (0, pdas_1.getUserWindowParticipationPda)(params.seasonNumber, params.user, params.tier, params.windowNumber)[0],
+            seasonMembership: (0, pdas_1.getSeasonMembershipPda)(seasonNumber, params.user, params.tier)[0],
+            season: (0, pdas_1.getSeasonPda)(seasonNumber)[0],
+            rewardWindow: (0, pdas_1.getRewardWindowPda)(seasonNumber, params.windowNumber)[0],
+            userWindowParticipation: (0, pdas_1.getUserWindowParticipationPda)(seasonNumber, params.user, params.tier, params.windowNumber)[0],
             miztake: (0, pdas_1.getMiztakePda)(params.miztakeShaHash)[0],
         };
     }
@@ -51,38 +55,41 @@ class PDAManager {
      * Derive PDAs for claim_window_rewards instruction
      */
     static deriveClaimWindowRewardsPdas(params) {
+        const seasonNumber = (0, conversions_1.toSeasonNumberBn)(params.seasonNumber);
         return {
             seasonSettings: (0, pdas_1.getSeasonSettingsPda)()[0],
-            season: (0, pdas_1.getSeasonPda)(params.seasonNumber)[0],
-            rewardWindow: (0, pdas_1.getRewardWindowPda)(params.seasonNumber, params.windowNumber)[0],
-            userWindowParticipation: (0, pdas_1.getUserWindowParticipationPda)(params.seasonNumber, params.user, params.tier, params.windowNumber)[0],
-            seasonMembership: (0, pdas_1.getSeasonMembershipPda)(params.seasonNumber, params.user, params.tier)[0],
-            seasonDepositVault: (0, pdas_1.getSeasonDepositVaultPda)(params.seasonNumber)[0],
+            season: (0, pdas_1.getSeasonPda)(seasonNumber)[0],
+            rewardWindow: (0, pdas_1.getRewardWindowPda)(seasonNumber, params.windowNumber)[0],
+            userWindowParticipation: (0, pdas_1.getUserWindowParticipationPda)(seasonNumber, params.user, params.tier, params.windowNumber)[0],
+            seasonMembership: (0, pdas_1.getSeasonMembershipPda)(seasonNumber, params.user, params.tier)[0],
+            seasonDepositVault: (0, pdas_1.getSeasonDepositVaultPda)(seasonNumber)[0],
         };
     }
     /**
      * Derive PDAs for withdraw_season_deposit instruction
      */
     static deriveWithdrawDepositPdas(params) {
+        const seasonNumber = (0, conversions_1.toSeasonNumberBn)(params.seasonNumber);
         return {
             seasonSettings: (0, pdas_1.getSeasonSettingsPda)()[0],
-            season: (0, pdas_1.getSeasonPda)(params.seasonNumber)[0],
-            seasonMembership: (0, pdas_1.getSeasonMembershipPda)(params.seasonNumber, params.user, params.tier)[0],
-            seasonDepositVault: (0, pdas_1.getSeasonDepositVaultPda)(params.seasonNumber)[0],
-            seasonEscrowVault: (0, pdas_1.getSeasonEscrowVaultPda)(params.seasonNumber)[0],
+            season: (0, pdas_1.getSeasonPda)(seasonNumber)[0],
+            seasonMembership: (0, pdas_1.getSeasonMembershipPda)(seasonNumber, params.user, params.tier)[0],
+            seasonDepositVault: (0, pdas_1.getSeasonDepositVaultPda)(seasonNumber)[0],
+            seasonEscrowVault: (0, pdas_1.getSeasonEscrowVaultPda)(seasonNumber)[0],
         };
     }
     /**
      * Derive PDAs for claim_referral_penalty_for_window instruction
      */
     static deriveClaimReferralPenaltyForWindowPdas(params) {
+        const seasonNumber = (0, conversions_1.toSeasonNumberBn)(params.seasonNumber);
         return {
             seasonSettings: (0, pdas_1.getSeasonSettingsPda)()[0],
-            season: (0, pdas_1.getSeasonPda)(params.seasonNumber)[0],
-            seasonMembership: (0, pdas_1.getSeasonMembershipPda)(params.seasonNumber, params.referredUser, params.tier)[0],
-            userWindowParticipation: (0, pdas_1.getUserWindowParticipationPda)(params.seasonNumber, params.referredUser, params.tier, params.windowNumber)[0],
-            referralPenaltyClaim: (0, pdas_1.getReferralPenaltyClaimPda)(params.seasonNumber, params.referredUser, params.tier, params.windowNumber)[0],
-            seasonDepositVault: (0, pdas_1.getSeasonDepositVaultPda)(params.seasonNumber)[0],
+            season: (0, pdas_1.getSeasonPda)(seasonNumber)[0],
+            seasonMembership: (0, pdas_1.getSeasonMembershipPda)(seasonNumber, params.referredUser, params.tier)[0],
+            userWindowParticipation: (0, pdas_1.getUserWindowParticipationPda)(seasonNumber, params.referredUser, params.tier, params.windowNumber)[0],
+            referralPenaltyClaim: (0, pdas_1.getReferralPenaltyClaimPda)(seasonNumber, params.referredUser, params.tier, params.windowNumber)[0],
+            seasonDepositVault: (0, pdas_1.getSeasonDepositVaultPda)(seasonNumber)[0],
         };
     }
 }

package/dist/utils/pdas.d.ts

@@ -1,5 +1,6 @@
 import { PublicKey } from "@solana/web3.js";
 import { BN } from "@coral-xyz/anchor";
+import type { SeasonNumberLike, Sha256HexString, TierNumber } from "../types";
 /**
  * PDA (Program Derived Address) derivation helpers
  */
@@ -16,7 +17,7 @@ export declare function getUserStatsPda(telegramId: BN): [PublicKey, number];
  * Derive the Miztake PDA for a given SHA hash
  * @param shaHash - The SHA-256 hash as a 64-char hex string
  */
-export declare function getMiztakePda(shaHash: string): [PublicKey, number];
+export declare function getMiztakePda(shaHash: Sha256HexString | string): [PublicKey, number];
 /**
  * Derive the SeasonSettings PDA
  */
@@ -25,7 +26,7 @@ export declare function getSeasonSettingsPda(): [PublicKey, number];
  * Derive the Season PDA for a given season number
  * @param seasonNumber - The season number
  */
-export declare function getSeasonPda(seasonNumber: BN): [PublicKey, number];
+export declare function getSeasonPda(seasonNumber: SeasonNumberLike): [PublicKey, number];
 /**
  * Derive the SeasonMembership PDA
  * PDA model:
@@ -38,13 +39,13 @@ export declare function getSeasonPda(seasonNumber: BN): [PublicKey, number];
  * @param user - The user's public key
  * @param tier - Tier number (1..=5)
  */
-export declare function getSeasonMembershipPda(seasonNumber: BN, user: PublicKey, tier: number): [PublicKey, number];
+export declare function getSeasonMembershipPda(seasonNumber: SeasonNumberLike, user: PublicKey, tier: TierNumber): [PublicKey, number];
 /**
  * Derive the RewardWindow PDA
  * @param seasonNumber - The season number
  * @param windowNumber - The window number
  */
-export declare function getRewardWindowPda(seasonNumber: BN, windowNumber: BN): [PublicKey, number];
+export declare function getRewardWindowPda(seasonNumber: SeasonNumberLike, windowNumber: BN): [PublicKey, number];
 /**
  * Derive the UserWindowParticipation PDA
  * PDA model:
@@ -55,15 +56,15 @@ export declare function getRewardWindowPda(seasonNumber: BN, windowNumber: BN):
  * @param tier - Tier number (1..=5)
  * @param windowNumber - The window number
  */
-export declare function getUserWindowParticipationPda(seasonNumber: BN, user: PublicKey, tier: number, windowNumber: BN): [PublicKey, number];
+export declare function getUserWindowParticipationPda(seasonNumber: SeasonNumberLike, user: PublicKey, tier: TierNumber, windowNumber: BN): [PublicKey, number];
 /**
  * Derive the Season Deposit Vault PDA
  */
-export declare function getSeasonDepositVaultPda(seasonNumber: BN): [PublicKey, number];
+export declare function getSeasonDepositVaultPda(seasonNumber: SeasonNumberLike): [PublicKey, number];
 /**
  * Derive the Season Escrow Vault PDA
  */
-export declare function getSeasonEscrowVaultPda(seasonNumber: BN): [PublicKey, number];
+export declare function getSeasonEscrowVaultPda(seasonNumber: SeasonNumberLike): [PublicKey, number];
 /**
  * Derive the ReferralPenaltyClaim PDA
  * PDA model:
@@ -74,4 +75,4 @@ export declare function getSeasonEscrowVaultPda(seasonNumber: BN): [PublicKey, n
  * @param tier - Tier number (1..=5)
  * @param windowNumber - The window number
  */
-export declare function getReferralPenaltyClaimPda(seasonNumber: BN, referredUser: PublicKey, tier: number, windowNumber: BN): [PublicKey, number];
+export declare function getReferralPenaltyClaimPda(seasonNumber: SeasonNumberLike, referredUser: PublicKey, tier: TierNumber, windowNumber: BN): [PublicKey, number];

package/dist/utils/pdas.js

@@ -14,6 +14,8 @@ exports.getReferralPenaltyClaimPda = getReferralPenaltyClaimPda;
 const web3_js_1 = require("@solana/web3.js");
 const constants_1 = require("./constants");
 const conversions_1 = require("./conversions");
+const tierPenalty_1 = require("./tierPenalty");
+const conversions_2 = require("./conversions");
 /**
  * PDA (Program Derived Address) derivation helpers
  */
@@ -35,7 +37,8 @@ function getUserStatsPda(telegramId) {
  * @param shaHash - The SHA-256 hash as a 64-char hex string
  */
 function getMiztakePda(shaHash) {
-    const shaHashBytes = (0, conversions_1.sha256HexToBytes32)(shaHash);
+    const normalized = typeof shaHash === "string" ? (0, conversions_1.toSha256HexString)(shaHash) : shaHash;
+    const shaHashBytes = (0, conversions_1.sha256HexToBytes32)(normalized);
     return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from(constants_1.MIZTAKE_SEED), shaHashBytes], constants_1.PROGRAM_ID);
 }
 /**
@@ -49,7 +52,8 @@ function getSeasonSettingsPda() {
  * @param seasonNumber - The season number
  */
 function getSeasonPda(seasonNumber) {
-    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("season"), seasonNumber.toArrayLike(Buffer, "le", 8)], constants_1.PROGRAM_ID);
+    const seasonBn = (0, conversions_2.toSeasonNumberBn)(seasonNumber);
+    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("season"), seasonBn.toArrayLike(Buffer, "le", 8)], constants_1.PROGRAM_ID);
 }
 /**
  * Derive the SeasonMembership PDA
@@ -64,14 +68,13 @@ function getSeasonPda(seasonNumber) {
  * @param tier - Tier number (1..=5)
  */
 function getSeasonMembershipPda(seasonNumber, user, tier) {
-    if (!Number.isInteger(tier) || tier < 1 || tier > 5) {
-        throw new Error("Invalid tier: must be an integer between 1 and 5");
-    }
+    const t = (0, tierPenalty_1.assertValidTierNumber)(tier);
+    const seasonBn = (0, conversions_2.toSeasonNumberBn)(seasonNumber);
     return web3_js_1.PublicKey.findProgramAddressSync([
         Buffer.from("season_membership"),
-        seasonNumber.toArrayLike(Buffer, "le", 8),
+        seasonBn.toArrayLike(Buffer, "le", 8),
         user.toBuffer(),
-        Buffer.from([tier]),
+        Buffer.from([t]),
     ], constants_1.PROGRAM_ID);
 }
 /**
@@ -80,9 +83,10 @@ function getSeasonMembershipPda(seasonNumber, user, tier) {
  * @param windowNumber - The window number
  */
 function getRewardWindowPda(seasonNumber, windowNumber) {
+    const seasonBn = (0, conversions_2.toSeasonNumberBn)(seasonNumber);
     return web3_js_1.PublicKey.findProgramAddressSync([
         Buffer.from("reward_window"),
-        seasonNumber.toArrayLike(Buffer, "le", 8),
+        seasonBn.toArrayLike(Buffer, "le", 8),
         windowNumber.toArrayLike(Buffer, "le", 8),
     ], constants_1.PROGRAM_ID);
 }
@@ -97,14 +101,13 @@ function getRewardWindowPda(seasonNumber, windowNumber) {
  * @param windowNumber - The window number
  */
 function getUserWindowParticipationPda(seasonNumber, user, tier, windowNumber) {
-    if (!Number.isInteger(tier) || tier < 1 || tier > 5) {
-        throw new Error("Invalid tier: must be an integer between 1 and 5");
-    }
+    const t = (0, tierPenalty_1.assertValidTierNumber)(tier);
+    const seasonBn = (0, conversions_2.toSeasonNumberBn)(seasonNumber);
     return web3_js_1.PublicKey.findProgramAddressSync([
         Buffer.from("user_window"),
-        seasonNumber.toArrayLike(Buffer, "le", 8),
+        seasonBn.toArrayLike(Buffer, "le", 8),
         user.toBuffer(),
-        Buffer.from([tier]),
+        Buffer.from([t]),
         windowNumber.toArrayLike(Buffer, "le", 8),
     ], constants_1.PROGRAM_ID);
 }
@@ -112,13 +115,15 @@ function getUserWindowParticipationPda(seasonNumber, user, tier, windowNumber) {
  * Derive the Season Deposit Vault PDA
  */
 function getSeasonDepositVaultPda(seasonNumber) {
-    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("season_deposit_vault"), seasonNumber.toArrayLike(Buffer, "le", 8)], constants_1.PROGRAM_ID);
+    const seasonBn = (0, conversions_2.toSeasonNumberBn)(seasonNumber);
+    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("season_deposit_vault"), seasonBn.toArrayLike(Buffer, "le", 8)], constants_1.PROGRAM_ID);
 }
 /**
  * Derive the Season Escrow Vault PDA
  */
 function getSeasonEscrowVaultPda(seasonNumber) {
-    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("season_escrow_vault"), seasonNumber.toArrayLike(Buffer, "le", 8)], constants_1.PROGRAM_ID);
+    const seasonBn = (0, conversions_2.toSeasonNumberBn)(seasonNumber);
+    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("season_escrow_vault"), seasonBn.toArrayLike(Buffer, "le", 8)], constants_1.PROGRAM_ID);
 }
 /**
  * Derive the ReferralPenaltyClaim PDA
@@ -131,14 +136,13 @@ function getSeasonEscrowVaultPda(seasonNumber) {
  * @param windowNumber - The window number
  */
 function getReferralPenaltyClaimPda(seasonNumber, referredUser, tier, windowNumber) {
-    if (!Number.isInteger(tier) || tier < 1 || tier > 5) {
-        throw new Error("Invalid tier: must be an integer between 1 and 5");
-    }
+    const t = (0, tierPenalty_1.assertValidTierNumber)(tier);
+    const seasonBn = (0, conversions_2.toSeasonNumberBn)(seasonNumber);
     return web3_js_1.PublicKey.findProgramAddressSync([
         Buffer.from(constants_1.REFERRAL_PENALTY_CLAIM_SEED),
-        seasonNumber.toArrayLike(Buffer, "le", 8),
+        seasonBn.toArrayLike(Buffer, "le", 8),
         referredUser.toBuffer(),
-        Buffer.from([tier]),
+        Buffer.from([t]),
         windowNumber.toArrayLike(Buffer, "le", 8),
     ], constants_1.PROGRAM_ID);
 }

package/dist/utils/programHelpers.js

@@ -13,6 +13,6 @@ const anchorHelpers_1 = require("./anchorHelpers");
 function getProgram(connection) {
     const provider = (0, anchorHelpers_1.createReadOnlyProvider)(connection);
     // Ensure a stable program id even if the bundled IDL JSON was generated without `address`.
-    const idlWithAddress = (0, anchorHelpers_1.withIdlAddress)(idl_1.IDL, constants_1.PROGRAM_ID);
+    const idlWithAddress = (0, anchorHelpers_1.withIdlAddress)(idl_1.ANCHOR_IDL, constants_1.PROGRAM_ID);
     return new anchor_1.Program(idlWithAddress, provider);
 }

package/dist/utils/signerHelpers.d.ts

@@ -1,10 +1,11 @@
 import { PublicKey } from "@solana/web3.js";
+export type SignerRole = "admin" | "user" | "payer" | "feePayer" | "claimant" | "currentAdmin";
 /**
  * Signer information
  */
 export interface SignerInfo {
     publicKey: PublicKey;
-    role: string;
+    role: SignerRole;
 }
 /**
  * Build signers array with optional fee payer

package/dist/utils/simulationHelpers.js

@@ -43,15 +43,16 @@ async function simulateInstruction(connection, instructions, signers, feePayer)
     transaction.recentBlockhash = blockhash;
     try {
         const simulation = await connection.simulateTransaction(transaction, undefined, [...signers.map((s) => s.publicKey)]);
+        const error = simulation.value.err !== null ? JSON.stringify(simulation.value.err) : undefined;
+        const returnData = simulation.value.returnData ?? undefined;
+        const accounts = simulation.value.accounts ?? undefined;
         return {
             success: simulation.value.err === null,
             logs: simulation.value.logs || [],
             unitsConsumed: simulation.value.unitsConsumed || 0,
-            error: simulation.value.err
-                ? JSON.stringify(simulation.value.err)
-                : undefined,
-            returnData: simulation.value.returnData || undefined,
-            accounts: simulation.value.accounts || undefined,
+            ...(error !== undefined ? { error } : {}),
+            ...(returnData !== undefined ? { returnData } : {}),
+            ...(accounts !== undefined ? { accounts } : {}),
         };
     }
     catch (error) {
@@ -143,9 +144,9 @@ async function dryRun(connection, instructions, signers) {
     const result = await simulateInstruction(connection, instructions, signers);
     return {
         willSucceed: result.success,
-        error: result.error,
         logs: result.logs,
         unitsConsumed: result.unitsConsumed,
+        ...(result.error !== undefined ? { error: result.error } : {}),
     };
 }
 /**

package/dist/utils/tierPenalty.d.ts

@@ -1,9 +1,9 @@
 import { BN } from "@coral-xyz/anchor";
-import { SeasonDepositTier } from "../types";
+import { SeasonDepositTier, TierNumber } from "../types";
 /**
  * Validate and normalize a tier number (1..=5).
  */
-export declare function assertValidTierNumber(tier: number): number;
+export declare function assertValidTierNumber(tier: number): TierNumber;
 /**
  * Convert numeric tier (1..=5) to the Anchor enum representation.
  */

package/dist/utils/tierPenalty.js

@@ -4,6 +4,7 @@ exports.assertValidTierNumber = assertValidTierNumber;
 exports.tierNumberToDepositTier = tierNumberToDepositTier;
 exports.getTierPenaltyPerWindow = getTierPenaltyPerWindow;
 const anchor_1 = require("@coral-xyz/anchor");
+const depositTier_1 = require("./depositTier");
 /**
  * Validate and normalize a tier number (1..=5).
  */
@@ -40,15 +41,16 @@ function tierNumberToDepositTier(tier) {
  */
 function getTierPenaltyPerWindow(tier) {
     // Base units (7 decimals): 1 MIZD = 10_000_000
-    if ("copper" in tier)
-        return new anchor_1.BN(1000000); // 0.1 MIZD
-    if ("silver" in tier)
-        return new anchor_1.BN(10000000); // 1 MIZD
-    if ("gold" in tier)
-        return new anchor_1.BN(100000000); // 10 MIZD
-    if ("platinum" in tier)
-        return new anchor_1.BN(1000000000); // 100 MIZD
-    if ("mithril" in tier)
-        return new anchor_1.BN(10000000000); // 1,000 MIZD
-    throw new Error("Unknown depositTier");
+    switch ((0, depositTier_1.getDepositTierName)(tier)) {
+        case "copper":
+            return new anchor_1.BN(1000000); // 0.1 MIZD
+        case "silver":
+            return new anchor_1.BN(10000000); // 1 MIZD
+        case "gold":
+            return new anchor_1.BN(100000000); // 10 MIZD
+        case "platinum":
+            return new anchor_1.BN(1000000000); // 100 MIZD
+        case "mithril":
+            return new anchor_1.BN(10000000000); // 1,000 MIZD
+    }
 }