proof-of-take-sdk 2.0.0 → 3.0.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

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

package/dist/utils/pdaManager.js

@@ -30,8 +30,8 @@ class PDAManager {
             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)()[0],
-            seasonEscrowVault: (0, pdas_1.getSeasonEscrowVaultPda)()[0],
+            seasonDepositVault: (0, pdas_1.getSeasonDepositVaultPda)(params.seasonNumber)[0],
+            seasonEscrowVault: (0, pdas_1.getSeasonEscrowVaultPda)(params.seasonNumber)[0],
         };
     }
     /**
@@ -57,7 +57,7 @@ class PDAManager {
             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)()[0],
+            seasonDepositVault: (0, pdas_1.getSeasonDepositVaultPda)(params.seasonNumber)[0],
         };
     }
     /**
@@ -68,8 +68,8 @@ class PDAManager {
             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)()[0],
-            seasonEscrowVault: (0, pdas_1.getSeasonEscrowVaultPda)()[0],
+            seasonDepositVault: (0, pdas_1.getSeasonDepositVaultPda)(params.seasonNumber)[0],
+            seasonEscrowVault: (0, pdas_1.getSeasonEscrowVaultPda)(params.seasonNumber)[0],
         };
     }
     /**
@@ -82,7 +82,7 @@ class PDAManager {
             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],
+            seasonDepositVault: (0, pdas_1.getSeasonDepositVaultPda)(params.seasonNumber)[0],
         };
     }
 }

package/dist/utils/pdas.d.ts

@@ -59,11 +59,11 @@ export declare function getUserWindowParticipationPda(seasonNumber: BN, user: Pu
 /**
  * Derive the Season Deposit Vault PDA
  */
-export declare function getSeasonDepositVaultPda(): [PublicKey, number];
+export declare function getSeasonDepositVaultPda(seasonNumber: BN): [PublicKey, number];
 /**
  * Derive the Season Escrow Vault PDA
  */
-export declare function getSeasonEscrowVaultPda(): [PublicKey, number];
+export declare function getSeasonEscrowVaultPda(seasonNumber: BN): [PublicKey, number];
 /**
  * Derive the ReferralPenaltyClaim PDA
  * PDA model:

package/dist/utils/pdas.js

@@ -111,14 +111,14 @@ function getUserWindowParticipationPda(seasonNumber, user, tier, windowNumber) {
 /**
  * Derive the Season Deposit Vault PDA
  */
-function getSeasonDepositVaultPda() {
-    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("season_deposit_vault")], constants_1.PROGRAM_ID);
+function getSeasonDepositVaultPda(seasonNumber) {
+    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("season_deposit_vault"), seasonNumber.toArrayLike(Buffer, "le", 8)], 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);
+function getSeasonEscrowVaultPda(seasonNumber) {
+    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("season_escrow_vault"), seasonNumber.toArrayLike(Buffer, "le", 8)], constants_1.PROGRAM_ID);
 }
 /**
  * Derive the ReferralPenaltyClaim PDA

package/package.json

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