proof-of-take-sdk 1.0.0 → 2.0.0

package/dist/utils/accountUpdates.d.ts

@@ -66,11 +66,11 @@ export declare function updateMiztakeStatisticsForCreation(statistics: MiztakeSt
  * @param user - User's public key
  * @param seasonNumber - Season number
  * @param windowNumber - Window number
- * @param seasonMembershipId - Season membership ID
+ * @param tier - Tier number (1..=5)
  * @param miztakeId - The miztake ID to associate
  * @returns Initialized/Updated UserWindowParticipation object
  */
-export declare function initializeUserWindowParticipation(user: PublicKey, seasonNumber: BN, windowNumber: BN, seasonMembershipId: BN, miztakeId: BN): UserWindowParticipation;
+export declare function initializeUserWindowParticipation(user: PublicKey, seasonNumber: BN, windowNumber: BN, tier: number, miztakeId: BN): UserWindowParticipation;
 /**
  * Initialize RewardWindow
  * Mirrors the logic from season_helpers::initialize_window
@@ -97,7 +97,7 @@ export declare function updateMiztakeForSeasonUse(miztake: Miztake, seasonNumber
  * Mirrors the initialization from join_season.rs (lines 84-96)
  *
  * @param user - User's public key
- * @param seasonMembershipId - Membership ID
+ * @param tier - Tier number (1..=5)
  * @param seasonNumber - Season number
  * @param depositTier - Tier chosen at join time
  * @param depositAmount - Active deposit amount (participates in rewards/penalties)
@@ -106,7 +106,7 @@ export declare function updateMiztakeForSeasonUse(miztake: Miztake, seasonNumber
  * @param joinedWindowNumber - Window number when joined
  * @returns Initialized SeasonMembership object
  */
-export declare function initializeSeasonMembership(user: PublicKey, seasonMembershipId: BN, seasonNumber: BN, depositTier: SeasonDepositTier, referrer: PublicKey, depositAmount: BN, depositEscrowedAmount: BN, joinedAt: BN, joinedWindowNumber: BN, bump: number): SeasonMembership;
+export declare function initializeSeasonMembership(user: PublicKey, seasonNumber: BN, depositTier: SeasonDepositTier, referrer: PublicKey, depositAmount: BN, depositEscrowedAmount: BN, joinedAt: BN, joinedWindowNumber: BN, bump: number): SeasonMembership;
 /**
  * Update Season after a user joins
  * Mirrors the update from join_season.rs (lines 98-104)
@@ -197,7 +197,7 @@ export declare function updateMembershipForClaim(membership: SeasonMembership, r
  * @param referredUser - The user who missed the window
  * @param seasonNumber - Season number
  * @param windowNumber - Window number
- * @param seasonMembershipId - Referred user's membership id
+ * @param tier - Tier number (1..=5)
  * @param claimant - Referrer (or root admin if no referrer)
  * @param perWindowPenalty - Tier penalty per window (base units)
  * @param claimedAt - Unix timestamp in seconds (i64 on-chain, represented as BN in SDK)
@@ -206,7 +206,7 @@ export declare function initializeReferralPenaltyClaim(params: {
     referredUser: PublicKey;
     seasonNumber: BN;
     windowNumber: BN;
-    seasonMembershipId: BN;
+    tier: number;
     claimant: PublicKey;
     perWindowPenalty: BN;
     claimedAt?: BN;

package/dist/utils/accountUpdates.js

@@ -135,17 +135,16 @@ function updateMiztakeStatisticsForCreation(statistics) {
  * @param user - User's public key
  * @param seasonNumber - Season number
  * @param windowNumber - Window number
- * @param seasonMembershipId - Season membership ID
+ * @param tier - Tier number (1..=5)
  * @param miztakeId - The miztake ID to associate
  * @returns Initialized/Updated UserWindowParticipation object
  */
-function initializeUserWindowParticipation(user, seasonNumber, windowNumber, seasonMembershipId, miztakeId) {
-    const [, bump] = (0, pdas_1.getUserWindowParticipationPda)(user, seasonNumber, windowNumber, seasonMembershipId);
+function initializeUserWindowParticipation(user, seasonNumber, windowNumber, tier, miztakeId) {
+    const [, bump] = (0, pdas_1.getUserWindowParticipationPda)(seasonNumber, user, tier, windowNumber);
     return {
         user,
         seasonNumber,
         windowNumber,
-        seasonMembershipId,
         postedSuccessfully: false,
         claimedReward: false,
         rewardAmount: new anchor_1.BN(0),
@@ -203,7 +202,7 @@ function updateMiztakeForSeasonUse(miztake, seasonNumber, windowNumber) {
  * Mirrors the initialization from join_season.rs (lines 84-96)
  *
  * @param user - User's public key
- * @param seasonMembershipId - Membership ID
+ * @param tier - Tier number (1..=5)
  * @param seasonNumber - Season number
  * @param depositTier - Tier chosen at join time
  * @param depositAmount - Active deposit amount (participates in rewards/penalties)
@@ -212,9 +211,8 @@ function updateMiztakeForSeasonUse(miztake, seasonNumber, windowNumber) {
  * @param joinedWindowNumber - Window number when joined
  * @returns Initialized SeasonMembership object
  */
-function initializeSeasonMembership(user, seasonMembershipId, seasonNumber, depositTier, referrer, depositAmount, depositEscrowedAmount, joinedAt, joinedWindowNumber, bump) {
+function initializeSeasonMembership(user, seasonNumber, depositTier, referrer, depositAmount, depositEscrowedAmount, joinedAt, joinedWindowNumber, bump) {
     return {
-        id: seasonMembershipId,
         owner: user,
         referrer,
         seasonNumber,
@@ -481,20 +479,19 @@ function updateMembershipForClaim(membership, rewardAmount) {
  * @param referredUser - The user who missed the window
  * @param seasonNumber - Season number
  * @param windowNumber - Window number
- * @param seasonMembershipId - Referred user's membership id
+ * @param tier - Tier number (1..=5)
  * @param claimant - Referrer (or root admin if no referrer)
  * @param perWindowPenalty - Tier penalty per window (base units)
  * @param claimedAt - Unix timestamp in seconds (i64 on-chain, represented as BN in SDK)
  */
 function initializeReferralPenaltyClaim(params) {
-    const [, bump] = (0, pdas_1.getReferralPenaltyClaimPda)(params.referredUser, params.seasonNumber, params.windowNumber, params.seasonMembershipId);
+    const [, bump] = (0, pdas_1.getReferralPenaltyClaimPda)(params.seasonNumber, params.referredUser, params.tier, params.windowNumber);
     const claimedAt = getCurrentTimestamp(params.claimedAt);
     const amount = params.perWindowPenalty.muln(20).divn(100);
     return {
         referredUser: params.referredUser,
         seasonNumber: params.seasonNumber,
         windowNumber: params.windowNumber,
-        seasonMembershipId: params.seasonMembershipId,
         claimant: params.claimant,
         amount,
         claimedAt,

package/dist/utils/constants.d.ts

@@ -7,7 +7,6 @@ export declare const ADMIN_PUBLIC_KEY: PublicKey;
 export declare const MIZD_TOKEN_MINT: PublicKey;
 export declare const DEFAULT_FEE_RECIPIENT: PublicKey;
 export declare const MIZTAKE_STATISTICS_SEED = "miztake_statistics";
-export declare const TOKEN_VAULT_SEED = "token_vault";
 export declare const USER_STATS_SEED = "user_stats";
 export declare const MIZTAKE_SEED = "miztake";
 export declare const REFERRAL_PENALTY_CLAIM_SEED = "referral_penalty_claim";

package/dist/utils/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MIN_HASH_LENGTH = exports.MAX_USERNAME_LENGTH = exports.MAX_MAX_CLAIMABLE = exports.MIN_MAX_CLAIMABLE = exports.MAX_FEE = exports.MIN_FEE = exports.DEFAULT_MAX_CLAIMABLE = exports.DEFAULT_MIZTAKE_FEE = exports.REFERRAL_PENALTY_CLAIM_SEED = exports.MIZTAKE_SEED = exports.USER_STATS_SEED = exports.TOKEN_VAULT_SEED = exports.MIZTAKE_STATISTICS_SEED = exports.DEFAULT_FEE_RECIPIENT = exports.MIZD_TOKEN_MINT = exports.ADMIN_PUBLIC_KEY = exports.PROGRAM_ID = void 0;
+exports.MIN_HASH_LENGTH = exports.MAX_USERNAME_LENGTH = exports.MAX_MAX_CLAIMABLE = exports.MIN_MAX_CLAIMABLE = exports.MAX_FEE = exports.MIN_FEE = exports.DEFAULT_MAX_CLAIMABLE = exports.DEFAULT_MIZTAKE_FEE = exports.REFERRAL_PENALTY_CLAIM_SEED = exports.MIZTAKE_SEED = exports.USER_STATS_SEED = exports.MIZTAKE_STATISTICS_SEED = exports.DEFAULT_FEE_RECIPIENT = exports.MIZD_TOKEN_MINT = exports.ADMIN_PUBLIC_KEY = exports.PROGRAM_ID = void 0;
 const web3_js_1 = require("@solana/web3.js");
 /**
  * Proof of Miztake Program Constants
@@ -15,7 +15,6 @@ exports.MIZD_TOKEN_MINT = new web3_js_1.PublicKey("mizdS9fDNUKWZcXBeRhJoJQHJJmsT
 exports.DEFAULT_FEE_RECIPIENT = new web3_js_1.PublicKey("Dkhu2VgGPfvXPVuohG2fPfryRacWMpNBJXvRGF1dhzUh");
 // Seeds for PDAs
 exports.MIZTAKE_STATISTICS_SEED = "miztake_statistics";
-exports.TOKEN_VAULT_SEED = "token_vault";
 exports.USER_STATS_SEED = "user_stats";
 exports.MIZTAKE_SEED = "miztake";
 exports.REFERRAL_PENALTY_CLAIM_SEED = "referral_penalty_claim";

package/dist/utils/pdaManager.d.ts

@@ -13,8 +13,8 @@ export declare class PDAManager {
         telegramId: BN;
         seasonNumber: BN;
         windowNumber: BN;
-        seasonMembershipId: BN;
         user: PublicKey;
+        tier: number;
     }): {
         miztake: PublicKey;
         userStats: PublicKey;
@@ -31,7 +31,7 @@ export declare class PDAManager {
     static deriveJoinSeasonPdas(params: {
         user: PublicKey;
         seasonNumber: BN;
-        seasonMembershipId: BN;
+        tier: number;
     }): {
         seasonSettings: PublicKey;
         season: PublicKey;
@@ -46,7 +46,7 @@ export declare class PDAManager {
         user: PublicKey;
         seasonNumber: BN;
         windowNumber: BN;
-        seasonMembershipId: BN;
+        tier: number;
         /** SHA-256 hex string (64 chars) */
         miztakeShaHash: string;
     }): {
@@ -64,7 +64,7 @@ export declare class PDAManager {
         user: PublicKey;
         seasonNumber: BN;
         windowNumber: BN;
-        seasonMembershipId: BN;
+        tier: number;
     }): {
         seasonSettings: PublicKey;
         season: PublicKey;
@@ -79,7 +79,7 @@ export declare class PDAManager {
     static deriveWithdrawDepositPdas(params: {
         user: PublicKey;
         seasonNumber: BN;
-        seasonMembershipId: BN;
+        tier: number;
     }): {
         seasonSettings: PublicKey;
         season: PublicKey;
@@ -94,7 +94,7 @@ export declare class PDAManager {
         referredUser: PublicKey;
         seasonNumber: BN;
         windowNumber: BN;
-        referredSeasonMembershipId: BN;
+        tier: number;
     }): {
         seasonSettings: PublicKey;
         season: PublicKey;

package/dist/utils/pdaManager.js

@@ -17,9 +17,9 @@ class PDAManager {
             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],
+            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.user, params.seasonNumber, params.windowNumber, params.seasonMembershipId)[0],
+            userWindowParticipation: (0, pdas_1.getUserWindowParticipationPda)(params.seasonNumber, params.user, params.tier, params.windowNumber)[0],
         };
     }
     /**
@@ -29,7 +29,7 @@ class PDAManager {
         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],
+            seasonMembership: (0, pdas_1.getSeasonMembershipPda)(params.seasonNumber, params.user, params.tier)[0],
             seasonDepositVault: (0, pdas_1.getSeasonDepositVaultPda)()[0],
             seasonEscrowVault: (0, pdas_1.getSeasonEscrowVaultPda)()[0],
         };
@@ -40,10 +40,10 @@ class PDAManager {
     static deriveConfirmedPostPdas(params) {
         return {
             seasonSettings: (0, pdas_1.getSeasonSettingsPda)()[0],
-            seasonMembership: (0, pdas_1.getSeasonMembershipPda)(params.user, params.seasonMembershipId)[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.user, params.seasonNumber, params.windowNumber, params.seasonMembershipId)[0],
+            userWindowParticipation: (0, pdas_1.getUserWindowParticipationPda)(params.seasonNumber, params.user, params.tier, params.windowNumber)[0],
             miztake: (0, pdas_1.getMiztakePda)(params.miztakeShaHash)[0],
         };
     }
@@ -55,8 +55,8 @@ class PDAManager {
             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],
+            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)()[0],
         };
     }
@@ -67,7 +67,7 @@ class PDAManager {
         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],
+            seasonMembership: (0, pdas_1.getSeasonMembershipPda)(params.seasonNumber, params.user, params.tier)[0],
             seasonDepositVault: (0, pdas_1.getSeasonDepositVaultPda)()[0],
             seasonEscrowVault: (0, pdas_1.getSeasonEscrowVaultPda)()[0],
         };
@@ -79,9 +79,9 @@ class PDAManager {
         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],
+            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)()[0],
         };
     }

package/dist/utils/pdas.d.ts

@@ -7,10 +7,6 @@ import { BN } from "@coral-xyz/anchor";
  * 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
@@ -32,10 +28,17 @@ export declare function getSeasonSettingsPda(): [PublicKey, number];
 export declare function getSeasonPda(seasonNumber: BN): [PublicKey, number];
 /**
  * Derive the SeasonMembership PDA
+ * PDA model:
+ *   seeds = ["season_membership", season_number_le_u64, user_pubkey_bytes, tier_u8]
+ *
+ * Tier mapping (u8):
+ * 1 = copper, 2 = silver, 3 = gold, 4 = platinum, 5 = mithril
+ *
+ * @param seasonNumber - The season number
  * @param user - The user's public key
- * @param seasonMembershipId - The membership ID
+ * @param tier - Tier number (1..=5)
  */
-export declare function getSeasonMembershipPda(user: PublicKey, seasonMembershipId: BN): [PublicKey, number];
+export declare function getSeasonMembershipPda(seasonNumber: BN, user: PublicKey, tier: number): [PublicKey, number];
 /**
  * Derive the RewardWindow PDA
  * @param seasonNumber - The season number
@@ -44,12 +47,15 @@ export declare function getSeasonMembershipPda(user: PublicKey, seasonMembership
 export declare function getRewardWindowPda(seasonNumber: BN, windowNumber: BN): [PublicKey, number];
 /**
  * Derive the UserWindowParticipation PDA
- * @param user - The user's public key
+ * PDA model:
+ *   seeds = ["user_window", season_number_le_u64, user_pubkey_bytes, tier_u8, window_number_le_u64]
+ *
  * @param seasonNumber - The season number
+ * @param user - The user's public key
+ * @param tier - Tier number (1..=5)
  * @param windowNumber - The window number
- * @param seasonMembershipId - The membership ID
  */
-export declare function getUserWindowParticipationPda(user: PublicKey, seasonNumber: BN, windowNumber: BN, seasonMembershipId: BN): [PublicKey, number];
+export declare function getUserWindowParticipationPda(seasonNumber: BN, user: PublicKey, tier: number, windowNumber: BN): [PublicKey, number];
 /**
  * Derive the Season Deposit Vault PDA
  */
@@ -60,9 +66,12 @@ export declare function getSeasonDepositVaultPda(): [PublicKey, number];
 export declare function getSeasonEscrowVaultPda(): [PublicKey, number];
 /**
  * Derive the ReferralPenaltyClaim PDA
- * @param referredUser - The referred user's public key (the user who missed)
+ * PDA model:
+ *   seeds = ["referral_penalty_claim", season_number_le_u64, referred_user_pubkey_bytes, tier_u8, window_number_le_u64]
+ *
  * @param seasonNumber - The season number
+ * @param referredUser - The referred user's public key (the user who missed)
+ * @param tier - Tier number (1..=5)
  * @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];
+export declare function getReferralPenaltyClaimPda(seasonNumber: BN, referredUser: PublicKey, tier: number, windowNumber: BN): [PublicKey, number];

package/dist/utils/pdas.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getMiztakeStatisticsPda = getMiztakeStatisticsPda;
-exports.getTokenVaultPda = getTokenVaultPda;
 exports.getUserStatsPda = getUserStatsPda;
 exports.getMiztakePda = getMiztakePda;
 exports.getSeasonSettingsPda = getSeasonSettingsPda;
@@ -24,12 +23,6 @@ const conversions_1 = require("./conversions");
 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
@@ -60,14 +53,25 @@ function getSeasonPda(seasonNumber) {
 }
 /**
  * Derive the SeasonMembership PDA
+ * PDA model:
+ *   seeds = ["season_membership", season_number_le_u64, user_pubkey_bytes, tier_u8]
+ *
+ * Tier mapping (u8):
+ * 1 = copper, 2 = silver, 3 = gold, 4 = platinum, 5 = mithril
+ *
+ * @param seasonNumber - The season number
  * @param user - The user's public key
- * @param seasonMembershipId - The membership ID
+ * @param tier - Tier number (1..=5)
  */
-function getSeasonMembershipPda(user, seasonMembershipId) {
+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");
+    }
     return web3_js_1.PublicKey.findProgramAddressSync([
         Buffer.from("season_membership"),
+        seasonNumber.toArrayLike(Buffer, "le", 8),
         user.toBuffer(),
-        seasonMembershipId.toArrayLike(Buffer, "le", 8),
+        Buffer.from([tier]),
     ], constants_1.PROGRAM_ID);
 }
 /**
@@ -84,18 +88,24 @@ function getRewardWindowPda(seasonNumber, windowNumber) {
 }
 /**
  * Derive the UserWindowParticipation PDA
- * @param user - The user's public key
+ * PDA model:
+ *   seeds = ["user_window", season_number_le_u64, user_pubkey_bytes, tier_u8, window_number_le_u64]
+ *
  * @param seasonNumber - The season number
+ * @param user - The user's public key
+ * @param tier - Tier number (1..=5)
  * @param windowNumber - The window number
- * @param seasonMembershipId - The membership ID
  */
-function getUserWindowParticipationPda(user, seasonNumber, windowNumber, seasonMembershipId) {
+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");
+    }
     return web3_js_1.PublicKey.findProgramAddressSync([
         Buffer.from("user_window"),
-        user.toBuffer(),
         seasonNumber.toArrayLike(Buffer, "le", 8),
+        user.toBuffer(),
+        Buffer.from([tier]),
         windowNumber.toArrayLike(Buffer, "le", 8),
-        seasonMembershipId.toArrayLike(Buffer, "le", 8),
     ], constants_1.PROGRAM_ID);
 }
 /**
@@ -112,17 +122,23 @@ function getSeasonEscrowVaultPda() {
 }
 /**
  * Derive the ReferralPenaltyClaim PDA
- * @param referredUser - The referred user's public key (the user who missed)
+ * PDA model:
+ *   seeds = ["referral_penalty_claim", season_number_le_u64, referred_user_pubkey_bytes, tier_u8, window_number_le_u64]
+ *
  * @param seasonNumber - The season number
+ * @param referredUser - The referred user's public key (the user who missed)
+ * @param tier - Tier number (1..=5)
  * @param windowNumber - The window number
- * @param seasonMembershipId - The referred user's membership id
  */
-function getReferralPenaltyClaimPda(referredUser, seasonNumber, windowNumber, seasonMembershipId) {
+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");
+    }
     return web3_js_1.PublicKey.findProgramAddressSync([
         Buffer.from(constants_1.REFERRAL_PENALTY_CLAIM_SEED),
-        referredUser.toBuffer(),
         seasonNumber.toArrayLike(Buffer, "le", 8),
+        referredUser.toBuffer(),
+        Buffer.from([tier]),
         windowNumber.toArrayLike(Buffer, "le", 8),
-        seasonMembershipId.toArrayLike(Buffer, "le", 8),
     ], constants_1.PROGRAM_ID);
 }

package/dist/utils/tierPenalty.d.ts

@@ -1,5 +1,13 @@
 import { BN } from "@coral-xyz/anchor";
 import { SeasonDepositTier } from "../types";
+/**
+ * Validate and normalize a tier number (1..=5).
+ */
+export declare function assertValidTierNumber(tier: number): number;
+/**
+ * Convert numeric tier (1..=5) to the Anchor enum representation.
+ */
+export declare function tierNumberToDepositTier(tier: number): SeasonDepositTier;
 /**
  * Tier-based per-window penalty amount (base units, 7 decimals).
  *

package/dist/utils/tierPenalty.js

@@ -1,7 +1,37 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertValidTierNumber = assertValidTierNumber;
+exports.tierNumberToDepositTier = tierNumberToDepositTier;
 exports.getTierPenaltyPerWindow = getTierPenaltyPerWindow;
 const anchor_1 = require("@coral-xyz/anchor");
+/**
+ * Validate and normalize a tier number (1..=5).
+ */
+function assertValidTierNumber(tier) {
+    if (!Number.isInteger(tier) || tier < 1 || tier > 5) {
+        throw new Error("Invalid tier: must be an integer between 1 and 5");
+    }
+    return tier;
+}
+/**
+ * Convert numeric tier (1..=5) to the Anchor enum representation.
+ */
+function tierNumberToDepositTier(tier) {
+    switch (assertValidTierNumber(tier)) {
+        case 1:
+            return { copper: {} };
+        case 2:
+            return { silver: {} };
+        case 3:
+            return { gold: {} };
+        case 4:
+            return { platinum: {} };
+        case 5:
+            return { mithril: {} };
+    }
+    // unreachable
+    throw new Error("Invalid tier");
+}
 /**
  * Tier-based per-window penalty amount (base units, 7 decimals).
  *

package/package.json

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

package/dist/getters/getTokenVault.d.ts

@@ -1,30 +0,0 @@
-import { Connection } from "@solana/web3.js";
-import { BN } from "@coral-xyz/anchor";
-/**
- * Get the token vault account information
- *
- * @param connection - Solana connection
- * @returns Token vault account data
- */
-export declare function getTokenVault(connection: Connection): Promise<{
-    address: import("@solana/web3.js").PublicKey;
-    data: {
-        mint: import("@solana/web3.js").PublicKey;
-        owner: import("@solana/web3.js").PublicKey;
-        amount: any;
-        delegate: import("@solana/web3.js").PublicKey;
-        delegatedAmount: bigint;
-        isInitialized: boolean;
-        isFrozen: boolean;
-        isNative: boolean;
-        closeAuthority: import("@solana/web3.js").PublicKey;
-    };
-}>;
-/**
- * Check if token vault is initialized
- */
-export declare function isVaultInitialized(connection: Connection): Promise<boolean>;
-/**
- * Get vault balance (amount of MIZD tokens in vault)
- */
-export declare function getVaultTokenBalance(connection: Connection): Promise<BN>;

package/dist/getters/getTokenVault.js

@@ -1,56 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getTokenVault = getTokenVault;
-exports.isVaultInitialized = isVaultInitialized;
-exports.getVaultTokenBalance = getVaultTokenBalance;
-const spl_token_1 = require("@solana/spl-token");
-const anchor_1 = require("@coral-xyz/anchor");
-const pdas_1 = require("../utils/pdas");
-/**
- * Get the token vault account information
- *
- * @param connection - Solana connection
- * @returns Token vault account data
- */
-async function getTokenVault(connection) {
-    const [vaultPda] = (0, pdas_1.getTokenVaultPda)();
-    try {
-        const vaultAccount = await (0, spl_token_1.getAccount)(connection, vaultPda);
-        return {
-            address: vaultPda,
-            data: {
-                mint: vaultAccount.mint,
-                owner: vaultAccount.owner,
-                amount: new anchor_1.BN(vaultAccount.amount.toString()),
-                delegate: vaultAccount.delegate,
-                delegatedAmount: vaultAccount.delegatedAmount,
-                isInitialized: vaultAccount.isInitialized,
-                isFrozen: vaultAccount.isFrozen,
-                isNative: vaultAccount.isNative,
-                closeAuthority: vaultAccount.closeAuthority,
-            },
-        };
-    }
-    catch (error) {
-        throw new Error(`Token vault not found or not initialized: ${error}`);
-    }
-}
-/**
- * Check if token vault is initialized
- */
-async function isVaultInitialized(connection) {
-    try {
-        await getTokenVault(connection);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Get vault balance (amount of MIZD tokens in vault)
- */
-async function getVaultTokenBalance(connection) {
-    const vault = await getTokenVault(connection);
-    return vault.data.amount;
-}