proof-of-take-sdk 1.0.0

package/dist/utils/conversions.d.ts

@@ -0,0 +1,25 @@
+import { BN } from "@coral-xyz/anchor";
+/**
+ * Safely convert BN to number for u64 fields
+ * Throws if the BN is larger than JavaScript's MAX_SAFE_INTEGER
+ *
+ * @param bn - BN to convert
+ * @returns Safe number
+ * @throws Error if BN is too large
+ */
+export declare function bnToU64(bn: BN): number;
+/**
+ * Convert BN to number with fallback for large numbers
+ * Returns undefined if number is too large to safely convert
+ *
+ * @param bn - BN to convert
+ * @returns Safe number or undefined
+ */
+export declare function bnToU64Safe(bn: BN): number | undefined;
+/**
+ * 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.
+ */
+export declare function sha256HexToBytes32(shaHex: string): Uint8Array;

package/dist/utils/conversions.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bnToU64 = bnToU64;
+exports.bnToU64Safe = bnToU64Safe;
+exports.sha256HexToBytes32 = sha256HexToBytes32;
+const anchor_1 = require("@coral-xyz/anchor");
+/**
+ * Safely convert BN to number for u64 fields
+ * Throws if the BN is larger than JavaScript's MAX_SAFE_INTEGER
+ *
+ * @param bn - BN to convert
+ * @returns Safe number
+ * @throws Error if BN is too large
+ */
+function bnToU64(bn) {
+    if (bn.gt(new anchor_1.BN(Number.MAX_SAFE_INTEGER))) {
+        throw new Error(`BN too large to safely convert to number: ${bn.toString()}`);
+    }
+    return bn.toNumber();
+}
+/**
+ * Convert BN to number with fallback for large numbers
+ * Returns undefined if number is too large to safely convert
+ *
+ * @param bn - BN to convert
+ * @returns Safe number or undefined
+ */
+function bnToU64Safe(bn) {
+    if (bn.gt(new anchor_1.BN(Number.MAX_SAFE_INTEGER))) {
+        return undefined;
+    }
+    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) {
+    if (typeof shaHex !== "string") {
+        throw new Error("sha256HexToBytes32: 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");
+    }
+    const buf = Buffer.from(normalized, "hex");
+    if (buf.length !== 32) {
+        throw new Error("sha256HexToBytes32: decoded length != 32");
+    }
+    return new Uint8Array(buf);
+}

package/dist/utils/enumHelpers.d.ts

@@ -0,0 +1,63 @@
+import { SeasonState, WindowState } from "../types";
+/**
+ * Enum helper utilities
+ *
+ * These helpers handle the difference between:
+ * - SDK numeric enums (SeasonState.Active = 1)
+ * - Anchor deserialized object enums ({ active: {} })
+ */
+/**
+ * Check if a SeasonState matches a specific variant
+ *
+ * Handles both SDK numeric format and Anchor object format
+ *
+ * @param state - The season state to check (from Anchor or SDK)
+ * @param variant - The variant to check against
+ * @returns True if state matches the variant
+ *
+ * @example
+ * ```typescript
+ * // Works with both formats:
+ * isSeasonState(season.seasonState, SeasonState.Active) // SDK numeric
+ * isSeasonState({ active: {} }, SeasonState.Active)     // Anchor object
+ * ```
+ */
+export declare function isSeasonState(state: SeasonState | {
+    [key: string]: {};
+} | number, variant: SeasonState): boolean;
+/**
+ * Check if a WindowState matches a specific variant
+ *
+ * Handles both SDK numeric format and Anchor object format
+ *
+ * @param state - The window state to check (from Anchor or SDK)
+ * @param variant - The variant to check against
+ * @returns True if state matches the variant
+ *
+ * @example
+ * ```typescript
+ * isWindowState(window.windowState, WindowState.Active)
+ * isWindowState({ finalized: {} }, WindowState.Finalized)
+ * ```
+ */
+export declare function isWindowState(state: WindowState | {
+    [key: string]: {};
+} | number, 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;
+/**
+ * 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;

package/dist/utils/enumHelpers.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSeasonState = isSeasonState;
+exports.isWindowState = isWindowState;
+exports.normalizeSeasonState = normalizeSeasonState;
+exports.normalizeWindowState = normalizeWindowState;
+const types_1 = require("../types");
+/**
+ * Enum helper utilities
+ *
+ * These helpers handle the difference between:
+ * - SDK numeric enums (SeasonState.Active = 1)
+ * - Anchor deserialized object enums ({ active: {} })
+ */
+/**
+ * Check if a SeasonState matches a specific variant
+ *
+ * Handles both SDK numeric format and Anchor object format
+ *
+ * @param state - The season state to check (from Anchor or SDK)
+ * @param variant - The variant to check against
+ * @returns True if state matches the variant
+ *
+ * @example
+ * ```typescript
+ * // Works with both formats:
+ * isSeasonState(season.seasonState, SeasonState.Active) // SDK numeric
+ * isSeasonState({ active: {} }, SeasonState.Active)     // Anchor object
+ * ```
+ */
+function isSeasonState(state, variant) {
+    // Map variant to string representation
+    const variantMap = {
+        [types_1.SeasonState.Uninitialized]: "uninitialized",
+        [types_1.SeasonState.Active]: "active",
+        [types_1.SeasonState.Ended]: "ended",
+    };
+    const variantName = variantMap[variant];
+    // Check if value is Anchor object format
+    if (typeof state === "object" && state !== null && !Array.isArray(state)) {
+        const key = Object.keys(state)[0];
+        return key === variantName;
+    }
+    // Otherwise compare numeric values
+    return state === variant;
+}
+/**
+ * Check if a WindowState matches a specific variant
+ *
+ * Handles both SDK numeric format and Anchor object format
+ *
+ * @param state - The window state to check (from Anchor or SDK)
+ * @param variant - The variant to check against
+ * @returns True if state matches the variant
+ *
+ * @example
+ * ```typescript
+ * isWindowState(window.windowState, WindowState.Active)
+ * isWindowState({ finalized: {} }, WindowState.Finalized)
+ * ```
+ */
+function isWindowState(state, variant) {
+    const variantMap = {
+        [types_1.WindowState.Uninitialized]: "uninitialized",
+        [types_1.WindowState.Active]: "active",
+        [types_1.WindowState.Finalized]: "finalized",
+    };
+    const variantName = variantMap[variant];
+    if (typeof state === "object" && state !== null && !Array.isArray(state)) {
+        const key = Object.keys(state)[0];
+        return key === variantName;
+    }
+    return state === variant;
+}
+/**
+ * Normalize SeasonState to numeric format
+ *
+ * @param state - Season state in any format
+ * @returns Numeric representation (0=Uninitialized, 1=Active, 2=Ended)
+ */
+function normalizeSeasonState(state) {
+    const map = {
+        uninitialized: 0,
+        active: 1,
+        ended: 2,
+    };
+    if (typeof state === "object" && state !== null && !Array.isArray(state)) {
+        const key = Object.keys(state)[0];
+        return map[key] ?? -1;
+    }
+    return state;
+}
+/**
+ * Normalize WindowState to numeric format
+ *
+ * @param state - Window state in any format
+ * @returns Numeric representation (0=Uninitialized, 1=Active, 2=Finalized)
+ */
+function normalizeWindowState(state) {
+    const map = {
+        uninitialized: 0,
+        active: 1,
+        finalized: 2,
+    };
+    if (typeof state === "object" && state !== null && !Array.isArray(state)) {
+        const key = Object.keys(state)[0];
+        return map[key] ?? -1;
+    }
+    return state;
+}

package/dist/utils/index.js

@@ -0,0 +1,2 @@
+// Utility exports
+// No additional utility exports needed - all utilities are exported directly from index.ts

package/dist/utils/pdaManager.d.ts

@@ -0,0 +1,106 @@
+import { PublicKey } from "@solana/web3.js";
+import { BN } from "@coral-xyz/anchor";
+/**
+ * PDA Manager for deriving related PDAs together
+ * Reduces boilerplate in instruction files
+ */
+export declare class PDAManager {
+    /**
+     * Derive all PDAs needed for create_miztake instruction
+     */
+    static deriveMiztakePdas(params: {
+        shaHash: string;
+        telegramId: BN;
+        seasonNumber: BN;
+        windowNumber: BN;
+        seasonMembershipId: BN;
+        user: PublicKey;
+    }): {
+        miztake: PublicKey;
+        userStats: PublicKey;
+        miztakeStatistics: PublicKey;
+        seasonSettings: PublicKey;
+        season: PublicKey;
+        seasonMembership: PublicKey;
+        rewardWindow: PublicKey;
+        userWindowParticipation: PublicKey;
+    };
+    /**
+     * Derive PDAs for join_season instruction
+     */
+    static deriveJoinSeasonPdas(params: {
+        user: PublicKey;
+        seasonNumber: BN;
+        seasonMembershipId: BN;
+    }): {
+        seasonSettings: PublicKey;
+        season: PublicKey;
+        seasonMembership: PublicKey;
+        seasonDepositVault: PublicKey;
+        seasonEscrowVault: PublicKey;
+    };
+    /**
+     * Derive PDAs for confirmed_post_on_x instruction
+     */
+    static deriveConfirmedPostPdas(params: {
+        user: PublicKey;
+        seasonNumber: BN;
+        windowNumber: BN;
+        seasonMembershipId: BN;
+        /** SHA-256 hex string (64 chars) */
+        miztakeShaHash: string;
+    }): {
+        seasonSettings: PublicKey;
+        seasonMembership: PublicKey;
+        season: PublicKey;
+        rewardWindow: PublicKey;
+        userWindowParticipation: PublicKey;
+        miztake: PublicKey;
+    };
+    /**
+     * Derive PDAs for claim_window_rewards instruction
+     */
+    static deriveClaimWindowRewardsPdas(params: {
+        user: PublicKey;
+        seasonNumber: BN;
+        windowNumber: BN;
+        seasonMembershipId: BN;
+    }): {
+        seasonSettings: PublicKey;
+        season: PublicKey;
+        rewardWindow: PublicKey;
+        userWindowParticipation: PublicKey;
+        seasonMembership: PublicKey;
+        seasonDepositVault: PublicKey;
+    };
+    /**
+     * Derive PDAs for withdraw_season_deposit instruction
+     */
+    static deriveWithdrawDepositPdas(params: {
+        user: PublicKey;
+        seasonNumber: BN;
+        seasonMembershipId: BN;
+    }): {
+        seasonSettings: PublicKey;
+        season: PublicKey;
+        seasonMembership: PublicKey;
+        seasonDepositVault: PublicKey;
+        seasonEscrowVault: PublicKey;
+    };
+    /**
+     * Derive PDAs for claim_referral_penalty_for_window instruction
+     */
+    static deriveClaimReferralPenaltyForWindowPdas(params: {
+        referredUser: PublicKey;
+        seasonNumber: BN;
+        windowNumber: BN;
+        referredSeasonMembershipId: BN;
+    }): {
+        seasonSettings: PublicKey;
+        season: PublicKey;
+        seasonMembership: PublicKey;
+        userWindowParticipation: PublicKey;
+        referralPenaltyClaim: PublicKey;
+        seasonDepositVault: PublicKey;
+    };
+}

package/dist/utils/pdaManager.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PDAManager = void 0;
+const pdas_1 = require("./pdas");
+/**
+ * PDA Manager for deriving related PDAs together
+ * Reduces boilerplate in instruction files
+ */
+class PDAManager {
+    /**
+     * Derive all PDAs needed for create_miztake instruction
+     */
+    static deriveMiztakePdas(params) {
+        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.user, params.seasonMembershipId)[0],
+            rewardWindow: (0, pdas_1.getRewardWindowPda)(params.seasonNumber, params.windowNumber)[0],
+            userWindowParticipation: (0, pdas_1.getUserWindowParticipationPda)(params.user, params.seasonNumber, params.windowNumber, params.seasonMembershipId)[0],
+        };
+    }
+    /**
+     * Derive PDAs for join_season instruction
+     */
+    static deriveJoinSeasonPdas(params) {
+        return {
+            seasonSettings: (0, pdas_1.getSeasonSettingsPda)()[0],
+            season: (0, pdas_1.getSeasonPda)(params.seasonNumber)[0],
+            seasonMembership: (0, pdas_1.getSeasonMembershipPda)(params.user, params.seasonMembershipId)[0],
+            seasonDepositVault: (0, pdas_1.getSeasonDepositVaultPda)()[0],
+            seasonEscrowVault: (0, pdas_1.getSeasonEscrowVaultPda)()[0],
+        };
+    }
+    /**
+     * Derive PDAs for confirmed_post_on_x instruction
+     */
+    static deriveConfirmedPostPdas(params) {
+        return {
+            seasonSettings: (0, pdas_1.getSeasonSettingsPda)()[0],
+            seasonMembership: (0, pdas_1.getSeasonMembershipPda)(params.user, params.seasonMembershipId)[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.user, params.seasonNumber, params.windowNumber, params.seasonMembershipId)[0],
+            miztake: (0, pdas_1.getMiztakePda)(params.miztakeShaHash)[0],
+        };
+    }
+    /**
+     * Derive PDAs for claim_window_rewards instruction
+     */
+    static deriveClaimWindowRewardsPdas(params) {
+        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.user, params.seasonNumber, params.windowNumber, params.seasonMembershipId)[0],
+            seasonMembership: (0, pdas_1.getSeasonMembershipPda)(params.user, params.seasonMembershipId)[0],
+            seasonDepositVault: (0, pdas_1.getSeasonDepositVaultPda)()[0],
+        };
+    }
+    /**
+     * Derive PDAs for withdraw_season_deposit instruction
+     */
+    static deriveWithdrawDepositPdas(params) {
+        return {
+            seasonSettings: (0, pdas_1.getSeasonSettingsPda)()[0],
+            season: (0, pdas_1.getSeasonPda)(params.seasonNumber)[0],
+            seasonMembership: (0, pdas_1.getSeasonMembershipPda)(params.user, params.seasonMembershipId)[0],
+            seasonDepositVault: (0, pdas_1.getSeasonDepositVaultPda)()[0],
+            seasonEscrowVault: (0, pdas_1.getSeasonEscrowVaultPda)()[0],
+        };
+    }
+    /**
+     * Derive PDAs for claim_referral_penalty_for_window instruction
+     */
+    static deriveClaimReferralPenaltyForWindowPdas(params) {
+        return {
+            seasonSettings: (0, pdas_1.getSeasonSettingsPda)()[0],
+            season: (0, pdas_1.getSeasonPda)(params.seasonNumber)[0],
+            seasonMembership: (0, pdas_1.getSeasonMembershipPda)(params.referredUser, params.referredSeasonMembershipId)[0],
+            userWindowParticipation: (0, pdas_1.getUserWindowParticipationPda)(params.referredUser, params.seasonNumber, params.windowNumber, params.referredSeasonMembershipId)[0],
+            referralPenaltyClaim: (0, pdas_1.getReferralPenaltyClaimPda)(params.referredUser, params.seasonNumber, params.windowNumber, params.referredSeasonMembershipId)[0],
+            seasonDepositVault: (0, pdas_1.getSeasonDepositVaultPda)()[0],
+        };
+    }
+}
+exports.PDAManager = PDAManager;

package/dist/utils/pdas.d.ts

@@ -0,0 +1,68 @@
+import { PublicKey } from "@solana/web3.js";
+import { BN } from "@coral-xyz/anchor";
+/**
+ * PDA (Program Derived Address) derivation helpers
+ */
+/**
+ * Derive the MiztakeStatistics PDA
+ */
+export declare function getMiztakeStatisticsPda(): [PublicKey, number];
+/**
+ * Derive the Token Vault PDA
+ */
+export declare function getTokenVaultPda(): [PublicKey, number];
+/**
+ * Derive the UserStats PDA for a given telegram ID
+ * @param telegramId - The user's Telegram ID
+ */
+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];
+/**
+ * Derive the SeasonSettings PDA
+ */
+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];
+/**
+ * Derive the SeasonMembership PDA
+ * @param user - The user's public key
+ * @param seasonMembershipId - The membership ID
+ */
+export declare function getSeasonMembershipPda(user: PublicKey, seasonMembershipId: BN): [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];
+/**
+ * Derive the UserWindowParticipation PDA
+ * @param user - The user's public key
+ * @param seasonNumber - The season number
+ * @param windowNumber - The window number
+ * @param seasonMembershipId - The membership ID
+ */
+export declare function getUserWindowParticipationPda(user: PublicKey, seasonNumber: BN, windowNumber: BN, seasonMembershipId: BN): [PublicKey, number];
+/**
+ * Derive the Season Deposit Vault PDA
+ */
+export declare function getSeasonDepositVaultPda(): [PublicKey, number];
+/**
+ * Derive the Season Escrow Vault PDA
+ */
+export declare function getSeasonEscrowVaultPda(): [PublicKey, number];
+/**
+ * Derive the ReferralPenaltyClaim PDA
+ * @param referredUser - The referred user's public key (the user who missed)
+ * @param seasonNumber - The season number
+ * @param windowNumber - The window number
+ * @param seasonMembershipId - The referred user's membership id
+ */
+export declare function getReferralPenaltyClaimPda(referredUser: PublicKey, seasonNumber: BN, windowNumber: BN, seasonMembershipId: BN): [PublicKey, number];

package/dist/utils/pdas.js

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMiztakeStatisticsPda = getMiztakeStatisticsPda;
+exports.getTokenVaultPda = getTokenVaultPda;
+exports.getUserStatsPda = getUserStatsPda;
+exports.getMiztakePda = getMiztakePda;
+exports.getSeasonSettingsPda = getSeasonSettingsPda;
+exports.getSeasonPda = getSeasonPda;
+exports.getSeasonMembershipPda = getSeasonMembershipPda;
+exports.getRewardWindowPda = getRewardWindowPda;
+exports.getUserWindowParticipationPda = getUserWindowParticipationPda;
+exports.getSeasonDepositVaultPda = getSeasonDepositVaultPda;
+exports.getSeasonEscrowVaultPda = getSeasonEscrowVaultPda;
+exports.getReferralPenaltyClaimPda = getReferralPenaltyClaimPda;
+const web3_js_1 = require("@solana/web3.js");
+const constants_1 = require("./constants");
+const conversions_1 = require("./conversions");
+/**
+ * PDA (Program Derived Address) derivation helpers
+ */
+/**
+ * Derive the MiztakeStatistics PDA
+ */
+function getMiztakeStatisticsPda() {
+    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from(constants_1.MIZTAKE_STATISTICS_SEED)], constants_1.PROGRAM_ID);
+}
+/**
+ * Derive the Token Vault PDA
+ */
+function getTokenVaultPda() {
+    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from(constants_1.TOKEN_VAULT_SEED)], constants_1.PROGRAM_ID);
+}
+/**
+ * Derive the UserStats PDA for a given telegram ID
+ * @param telegramId - The user's Telegram ID
+ */
+function getUserStatsPda(telegramId) {
+    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from(constants_1.USER_STATS_SEED), telegramId.toArrayLike(Buffer, "le", 8)], constants_1.PROGRAM_ID);
+}
+/**
+ * Derive the Miztake PDA for a given SHA hash
+ * @param shaHash - The SHA-256 hash as a 64-char hex string
+ */
+function getMiztakePda(shaHash) {
+    const shaHashBytes = (0, conversions_1.sha256HexToBytes32)(shaHash);
+    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from(constants_1.MIZTAKE_SEED), shaHashBytes], constants_1.PROGRAM_ID);
+}
+/**
+ * Derive the SeasonSettings PDA
+ */
+function getSeasonSettingsPda() {
+    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("season_settings")], constants_1.PROGRAM_ID);
+}
+/**
+ * Derive the Season PDA for a given season number
+ * @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);
+}
+/**
+ * Derive the SeasonMembership PDA
+ * @param user - The user's public key
+ * @param seasonMembershipId - The membership ID
+ */
+function getSeasonMembershipPda(user, seasonMembershipId) {
+    return web3_js_1.PublicKey.findProgramAddressSync([
+        Buffer.from("season_membership"),
+        user.toBuffer(),
+        seasonMembershipId.toArrayLike(Buffer, "le", 8),
+    ], constants_1.PROGRAM_ID);
+}
+/**
+ * Derive the RewardWindow PDA
+ * @param seasonNumber - The season number
+ * @param windowNumber - The window number
+ */
+function getRewardWindowPda(seasonNumber, windowNumber) {
+    return web3_js_1.PublicKey.findProgramAddressSync([
+        Buffer.from("reward_window"),
+        seasonNumber.toArrayLike(Buffer, "le", 8),
+        windowNumber.toArrayLike(Buffer, "le", 8),
+    ], constants_1.PROGRAM_ID);
+}
+/**
+ * Derive the UserWindowParticipation PDA
+ * @param user - The user's public key
+ * @param seasonNumber - The season number
+ * @param windowNumber - The window number
+ * @param seasonMembershipId - The membership ID
+ */
+function getUserWindowParticipationPda(user, seasonNumber, windowNumber, seasonMembershipId) {
+    return web3_js_1.PublicKey.findProgramAddressSync([
+        Buffer.from("user_window"),
+        user.toBuffer(),
+        seasonNumber.toArrayLike(Buffer, "le", 8),
+        windowNumber.toArrayLike(Buffer, "le", 8),
+        seasonMembershipId.toArrayLike(Buffer, "le", 8),
+    ], constants_1.PROGRAM_ID);
+}
+/**
+ * Derive the Season Deposit Vault PDA
+ */
+function getSeasonDepositVaultPda() {
+    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("season_deposit_vault")], constants_1.PROGRAM_ID);
+}
+/**
+ * Derive the Season Escrow Vault PDA
+ */
+function getSeasonEscrowVaultPda() {
+    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("season_escrow_vault")], constants_1.PROGRAM_ID);
+}
+/**
+ * Derive the ReferralPenaltyClaim PDA
+ * @param referredUser - The referred user's public key (the user who missed)
+ * @param seasonNumber - The season number
+ * @param windowNumber - The window number
+ * @param seasonMembershipId - The referred user's membership id
+ */
+function getReferralPenaltyClaimPda(referredUser, seasonNumber, windowNumber, seasonMembershipId) {
+    return web3_js_1.PublicKey.findProgramAddressSync([
+        Buffer.from(constants_1.REFERRAL_PENALTY_CLAIM_SEED),
+        referredUser.toBuffer(),
+        seasonNumber.toArrayLike(Buffer, "le", 8),
+        windowNumber.toArrayLike(Buffer, "le", 8),
+        seasonMembershipId.toArrayLike(Buffer, "le", 8),
+    ], constants_1.PROGRAM_ID);
+}

package/dist/utils/programHelpers.d.ts

@@ -0,0 +1,9 @@
+import { Program } from "@coral-xyz/anchor";
+import { Connection } from "@solana/web3.js";
+import { ProofOfTake } from "../types";
+/**
+ * Create a program instance for the Proof of Take program
+ * @param connection - Solana connection
+ * @returns Program instance
+ */
+export declare function getProgram(connection: Connection): Program<ProofOfTake>;

package/dist/utils/programHelpers.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProgram = getProgram;
+const anchor_1 = require("@coral-xyz/anchor");
+const idl_1 = require("../idl/idl");
+const constants_1 = require("./constants");
+const anchorHelpers_1 = require("./anchorHelpers");
+/**
+ * Create a program instance for the Proof of Take program
+ * @param connection - Solana connection
+ * @returns Program instance
+ */
+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);
+    return new anchor_1.Program(idlWithAddress, provider);
+}