proof-of-take-sdk 1.0.0 → 2.1.0

package/dist/utils/accountUpdates.d.ts

@@ -13,6 +13,34 @@ import { Miztake, UserStats, MiztakeStatistics, SeasonSettings, Season, SeasonMe
  * @returns Current Unix timestamp in seconds
  */
 export declare function getCurrentTimestamp(now?: BN): BN;
+/**
+ * Build the Season account object that is expected to be created by on-chain lazy initialization.
+ *
+ * This is a PURE helper (no RPC). It mirrors `season_helpers::initialize_season`:
+ * - `season_state = Active`
+ * - `started_at = current_time`
+ * - `ends_at = current_time + season_duration`
+ * - all counters and totals initialized to zero
+ * - schedule `eligible_stake_per_window` initialized to 21 zeros
+ * - PDA bump derived locally from seeds (no RPC)
+ *
+ * IMPORTANT:
+ * To match on-chain state exactly, you must supply the same `startedAt` that the transaction
+ * will observe on-chain (i.e. `Clock::get()?.unix_timestamp` at execution time) and the same
+ * season duration as stored in SeasonSettings at that moment. If you don't have settings locally,
+ * we fall back to the canonical defaults (7 days, 21 windows).
+ */
+export declare function expectedToBeLazyInitialized(params: {
+    /** Season number to initialize. */
+    seasonNumber: BN;
+    /** Unix timestamp in seconds used as `started_at` (i64 on-chain). */
+    startedAt: BN;
+    /**
+     * Optional settings snapshot (recommended) to compute `endsAt` and `totalWindows`.
+     * Providing this avoids drift if settings ever change.
+     */
+    seasonSettings?: Pick<SeasonSettings, "seasonDuration" | "totalWindowsPerSeason" | "lastSeasonEndsAt">;
+}): Season;
 /**
  * Create an empty/initialized UserStats object
  * Used when initializing a new user stats account
@@ -66,11 +94,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 +125,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 +134,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 +225,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 +234,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

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getCurrentTimestamp = getCurrentTimestamp;
+exports.expectedToBeLazyInitialized = expectedToBeLazyInitialized;
 exports.createEmptyUserStats = createEmptyUserStats;
 exports.initializeUserStats = initializeUserStats;
 exports.updateUserStatsForMiztakeCreation = updateUserStatsForMiztakeCreation;
@@ -42,6 +43,55 @@ function getCurrentTimestamp(now) {
         return now;
     return new anchor_1.BN(Math.floor(Date.now() / 1000)); // Convert JS milliseconds → seconds
 }
+/**
+ * Build the Season account object that is expected to be created by on-chain lazy initialization.
+ *
+ * This is a PURE helper (no RPC). It mirrors `season_helpers::initialize_season`:
+ * - `season_state = Active`
+ * - `started_at = current_time`
+ * - `ends_at = current_time + season_duration`
+ * - all counters and totals initialized to zero
+ * - schedule `eligible_stake_per_window` initialized to 21 zeros
+ * - PDA bump derived locally from seeds (no RPC)
+ *
+ * IMPORTANT:
+ * To match on-chain state exactly, you must supply the same `startedAt` that the transaction
+ * will observe on-chain (i.e. `Clock::get()?.unix_timestamp` at execution time) and the same
+ * season duration as stored in SeasonSettings at that moment. If you don't have settings locally,
+ * we fall back to the canonical defaults (7 days, 21 windows).
+ */
+function expectedToBeLazyInitialized(params) {
+    const seasonDuration = params.seasonSettings?.seasonDuration ?? new anchor_1.BN(604800); // 7 days
+    const totalWindows = params.seasonSettings?.totalWindowsPerSeason ?? 21;
+    // Derive bump seed locally (mirrors Anchor ctx.bumps.season).
+    const [, bump] = (0, pdas_1.getSeasonPda)(params.seasonNumber);
+    const lastSeasonEndsAt = params.seasonSettings?.lastSeasonEndsAt ?? new anchor_1.BN(0);
+    // If lastSeasonEndsAt is 0 (first season), use params.startedAt.
+    // Otherwise, use lastSeasonEndsAt exactly (gapless).
+    // Note: We ignore params.startedAt in the gapless case to match on-chain logic,
+    // but in practice the caller should ideally pass the correct gapless time.
+    const effectiveStartedAt = lastSeasonEndsAt.isZero()
+        ? params.startedAt
+        : lastSeasonEndsAt;
+    return {
+        seasonNumber: params.seasonNumber,
+        seasonState: types_1.SeasonState.Active,
+        startedAt: effectiveStartedAt,
+        endsAt: effectiveStartedAt.add(seasonDuration),
+        totalWindows,
+        totalMembers: new anchor_1.BN(0),
+        copperMembersCount: new anchor_1.BN(0),
+        silverMembersCount: new anchor_1.BN(0),
+        goldMembersCount: new anchor_1.BN(0),
+        platinumMembersCount: new anchor_1.BN(0),
+        mithrilMembersCount: new anchor_1.BN(0),
+        eligibleStakePerWindow: Array.from({ length: 21 }, () => new anchor_1.BN(0)),
+        totalDepositsHeld: new anchor_1.BN(0),
+        totalSuccessfulPosts: new anchor_1.BN(0),
+        totalPenaltiesCollected: new anchor_1.BN(0),
+        bump,
+    };
+}
 /**
  * Create an empty/initialized UserStats object
  * Used when initializing a new user stats account
@@ -135,17 +185,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 +252,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 +261,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 +529,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.1.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>;