proof-of-take-sdk 3.0.0 → 3.0.2

package/dist/utils/conversions.js

@@ -2,7 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.bnToU64 = bnToU64;
 exports.bnToU64Safe = bnToU64Safe;
+exports.toSha256HexString = toSha256HexString;
+exports.isSha256HexString = isSha256HexString;
 exports.sha256HexToBytes32 = sha256HexToBytes32;
+exports.assertWindowIndex = assertWindowIndex;
+exports.toWindowNumberBn = toWindowNumberBn;
+exports.toEligibleStakePerWindow = toEligibleStakePerWindow;
+exports.toSeasonNumberBn = toSeasonNumberBn;
 const anchor_1 = require("@coral-xyz/anchor");
 /**
  * Safely convert BN to number for u64 fields
@@ -31,23 +37,65 @@ function bnToU64Safe(bn) {
     }
     return bn.toNumber();
 }
-/**
- * Convert a 64-char SHA-256 hex string to a 32-byte Uint8Array.
- *
- * IMPORTANT: The on-chain program uses the raw 32-byte digest as PDA seed
- * (`seeds = [b\"miztake\", sha_hash_bytes]`), NOT the ASCII prefix of the hex string.
- */
-function sha256HexToBytes32(shaHex) {
+function toSha256HexString(shaHex) {
     if (typeof shaHex !== "string") {
-        throw new Error("sha256HexToBytes32: shaHex must be a string");
+        throw new Error("toSha256HexString: shaHex must be a string");
     }
     const normalized = shaHex.toLowerCase();
     if (!/^[0-9a-f]{64}$/.test(normalized)) {
-        throw new Error("sha256HexToBytes32: expected 64-char lowercase hex string");
+        throw new Error("toSha256HexString: expected 64-char hex string");
     }
+    return normalized;
+}
+function isSha256HexString(value) {
+    return (typeof value === "string" &&
+        /^[0-9a-f]{64}$/.test(value.toLowerCase()));
+}
+function sha256HexToBytes32(shaHex) {
+    const normalized = typeof shaHex === "string" ? toSha256HexString(shaHex) : shaHex;
     const buf = Buffer.from(normalized, "hex");
     if (buf.length !== 32) {
         throw new Error("sha256HexToBytes32: decoded length != 32");
     }
     return new Uint8Array(buf);
 }
+/**
+ * Validate a window index (0..20).
+ * Accepts BN (u64) or number; returns a narrowed WindowIndex.
+ */
+function assertWindowIndex(value) {
+    const n = typeof value === "number"
+        ? value
+        : value.toNumber(); // safe: window index is small in this program
+    if (!Number.isInteger(n) || n < 0 || n > 20) {
+        throw new Error("Invalid window index: must be an integer between 0 and 20");
+    }
+    return n;
+}
+/**
+ * Normalize a window number-like input to BN and validate it's within 0..20.
+ */
+function toWindowNumberBn(value) {
+    const bn = typeof value === "number" ? new anchor_1.BN(value) : value;
+    assertWindowIndex(bn);
+    return bn;
+}
+/**
+ * Runtime check + safe cast for the on-chain `[u64; 21]` schedule.
+ *
+ * This avoids `as unknown as ...` casts at call sites.
+ */
+function toEligibleStakePerWindow(value) {
+    if (value.length !== 21) {
+        throw new Error(`Invalid eligibleStakePerWindow length: expected 21, got ${value.length}`);
+    }
+    // We intentionally cast after validation.
+    return value;
+}
+function toSeasonNumberBn(value) {
+    const bn = typeof value === "number" ? new anchor_1.BN(value) : value;
+    if (bn.isNeg()) {
+        throw new Error("Invalid season number: must be >= 0");
+    }
+    return bn;
+}

package/dist/utils/depositTier.d.ts

@@ -0,0 +1,3 @@
+import { DepositTierName, SeasonDepositTier } from "../types";
+export declare function getDepositTierName(tier: SeasonDepositTier): DepositTierName;
+export declare function isDepositTier(tier: SeasonDepositTier, name: DepositTierName): boolean;

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