proof-of-take-sdk 3.0.2 → 3.0.4

package/dist/constants/season.d.ts

@@ -11,6 +11,8 @@ export declare const SEASON_CONSTANTS: {
     readonly SEASON_DURATION: 604800;
     /** Duration of each window in seconds (8 hours) */
     readonly WINDOW_DURATION: 28800;
+    /** Claim buffer duration in seconds (5 minutes) */
+    readonly CLAIM_BUFFER_DURATION: 300;
     /** Total number of windows per season */
     readonly TOTAL_WINDOWS_PER_SEASON: 21;
     /** Maximum members allowed per season (DOS protection) */

package/dist/constants/season.js

@@ -15,6 +15,8 @@ exports.SEASON_CONSTANTS = {
     SEASON_DURATION: 604800,
     /** Duration of each window in seconds (8 hours) */
     WINDOW_DURATION: 28800,
+    /** Claim buffer duration in seconds (5 minutes) */
+    CLAIM_BUFFER_DURATION: 300,
     /** Total number of windows per season */
     TOTAL_WINDOWS_PER_SEASON: 21,
     /** Maximum members allowed per season (DOS protection) */

package/dist/idl/proof_of_take.json

@@ -1135,6 +1135,123 @@
         }
       ]
     },
+    {
+      "name": "initialize_reward_window",
+      "discriminator": [
+        206,
+        116,
+        55,
+        128,
+        199,
+        75,
+        194,
+        213
+      ],
+      "accounts": [
+        {
+          "name": "season_settings",
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  115,
+                  101,
+                  97,
+                  115,
+                  111,
+                  110,
+                  95,
+                  115,
+                  101,
+                  116,
+                  116,
+                  105,
+                  110,
+                  103,
+                  115
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "season",
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  115,
+                  101,
+                  97,
+                  115,
+                  111,
+                  110
+                ]
+              },
+              {
+                "kind": "arg",
+                "path": "season_number"
+              }
+            ]
+          }
+        },
+        {
+          "name": "reward_window",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  114,
+                  101,
+                  119,
+                  97,
+                  114,
+                  100,
+                  95,
+                  119,
+                  105,
+                  110,
+                  100,
+                  111,
+                  119
+                ]
+              },
+              {
+                "kind": "arg",
+                "path": "season_number"
+              },
+              {
+                "kind": "arg",
+                "path": "window_number"
+              }
+            ]
+          }
+        },
+        {
+          "name": "admin",
+          "writable": true,
+          "signer": true
+        },
+        {
+          "name": "system_program",
+          "address": "11111111111111111111111111111111"
+        }
+      ],
+      "args": [
+        {
+          "name": "season_number",
+          "type": "u64"
+        },
+        {
+          "name": "window_number",
+          "type": "u64"
+        }
+      ]
+    },
     {
       "name": "initialize_season_settings",
       "discriminator": [

package/dist/index.d.ts

@@ -22,6 +22,8 @@ export { claimReferralPenaltyForWindow } from "./instructions/claimReferralPenal
 export type { ClaimReferralPenaltyForWindowOptions } from "./instructions/claimReferralPenaltyForWindow";
 export { withdrawSeasonDeposit } from "./instructions/withdrawSeasonDeposit";
 export type { WithdrawSeasonDepositOptions } from "./instructions/withdrawSeasonDeposit";
+export { initializeRewardWindow } from "./instructions/initializeRewardWindow";
+export type { InitializeRewardWindowOptions, InitializeRewardWindowPdas, } from "./instructions/initializeRewardWindow";
 export { toggleSeasonPause } from "./instructions/toggleSeasonPause";
 export { updateSeasonAdmin } from "./instructions/updateSeasonAdmin";
 export { viewSeasonMembershipStatus } from "./instructions/viewSeasonMembershipStatus";
@@ -45,7 +47,7 @@ export * from "./constants/season";
 export * from "./types";
 export * from "./types/instructionResults";
 export * from "./types/accountTypes";
-export type { ProofOfTakeIdlAccounts, AnchorMiztake, AnchorMiztakeStatistics, AnchorUserStats, AnchorSeasonSettings, AnchorSeason, AnchorSeasonMembership, AnchorRewardWindow, AnchorUserWindowParticipation, AnchorReferralPenaltyClaim, ProofOfTakeIdlTypes, AnchorCurrentSeasonView, AnchorSeasonMembershipStatusView, AnchorWindowStatusView, TierNumber, Sha256HexString, Bytes32, WindowIndex, WindowNumberLike, DepositTierName, SeasonDepositTier, SeasonStateAnchor, WindowStateAnchor, SeasonStateLike, WindowStateLike, FixedLengthArray, EligibleStakePerWindow, } from "./types";
+export type { ProofOfTakeIdlAccounts, AnchorMiztake, AnchorMiztakeStatistics, AnchorUserStats, AnchorSeasonSettings, AnchorSeason, AnchorSeasonMembership, AnchorRewardWindow, AnchorUserWindowParticipation, AnchorReferralPenaltyClaim, ProofOfTakeIdlTypes, AnchorCurrentSeasonView, AnchorSeasonMembershipStatusView, AnchorWindowStatusView, TierNumber, Sha256HexString, Bytes32, WindowIndex, WindowNumberLike, SeasonNumberLike, DepositTierName, SeasonDepositTier, SeasonStateAnchor, WindowStateAnchor, SeasonStateLike, WindowStateLike, FixedLengthArray, EligibleStakePerWindow, } from "./types";
 export type { StandardInstructionResult, StandardInstructionResultWithPdas, StandardInstructionResultWithPdasAndAccounts, } from "./types/instructionResults";
 export type { ProofOfTake } from "./types/proof_of_take";
 export { IDL } from "./idl/idl";

package/dist/index.js

@@ -21,7 +21,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VERSION = exports.getProgramReadOnly = exports.createProgramWithId = exports.createProgram = exports.IDL = exports.PDAManager = exports.getProgram = exports.viewCurrentSeason = exports.viewWindowStatus = exports.viewSeasonMembershipStatus = exports.updateSeasonAdmin = exports.toggleSeasonPause = exports.withdrawSeasonDeposit = exports.claimReferralPenaltyForWindow = exports.claimWindowRewards = exports.confirmedPostOnX = exports.joinSeason = exports.initializeEscrowVault = exports.initializeSeasonVault = exports.initializeSeasonSettings = exports.initializeStatistics = exports.getMiztakePdaForParams = exports.createMiztake = void 0;
+exports.VERSION = exports.getProgramReadOnly = exports.createProgramWithId = exports.createProgram = exports.IDL = exports.PDAManager = exports.getProgram = exports.viewCurrentSeason = exports.viewWindowStatus = exports.viewSeasonMembershipStatus = exports.updateSeasonAdmin = exports.toggleSeasonPause = exports.initializeRewardWindow = exports.withdrawSeasonDeposit = exports.claimReferralPenaltyForWindow = exports.claimWindowRewards = exports.confirmedPostOnX = exports.joinSeason = exports.initializeEscrowVault = exports.initializeSeasonVault = exports.initializeSeasonSettings = exports.initializeStatistics = exports.getMiztakePdaForParams = exports.createMiztake = void 0;
 // NOTE:
 // We intentionally export `getProgram` via a local const assignment (instead of `export * from ...`)
 // so that the compiled CommonJS output uses a writable property. This makes it possible to mock
@@ -53,6 +53,8 @@ Object.defineProperty(exports, "claimReferralPenaltyForWindow", { enumerable: tr
 var withdrawSeasonDeposit_1 = require("./instructions/withdrawSeasonDeposit");
 Object.defineProperty(exports, "withdrawSeasonDeposit", { enumerable: true, get: function () { return withdrawSeasonDeposit_1.withdrawSeasonDeposit; } });
 // Season admin instructions
+var initializeRewardWindow_1 = require("./instructions/initializeRewardWindow");
+Object.defineProperty(exports, "initializeRewardWindow", { enumerable: true, get: function () { return initializeRewardWindow_1.initializeRewardWindow; } });
 var toggleSeasonPause_1 = require("./instructions/toggleSeasonPause");
 Object.defineProperty(exports, "toggleSeasonPause", { enumerable: true, get: function () { return toggleSeasonPause_1.toggleSeasonPause; } });
 var updateSeasonAdmin_1 = require("./instructions/updateSeasonAdmin");

package/dist/instructions/initializeRewardWindow.d.ts

@@ -0,0 +1,23 @@
+import { Connection, PublicKey } from "@solana/web3.js";
+import { StandardInstructionResultWithPdas } from "../types/instructionResults";
+import type { SeasonNumberLike, WindowNumberLike } from "../types";
+export type InitializeRewardWindowPdas = {
+    seasonSettings: PublicKey;
+    season: PublicKey;
+    rewardWindow: PublicKey;
+};
+export interface InitializeRewardWindowOptions {
+    connection: Connection;
+    /** Root admin public key (must sign and pays for account creation). */
+    admin: PublicKey;
+    seasonNumber: SeasonNumberLike;
+    windowNumber: WindowNumberLike;
+    feePayer?: PublicKey;
+}
+/**
+ * Initialize (materialize) a missing RewardWindow PDA (root-admin only).
+ *
+ * This is a maintenance instruction used to ensure a `RewardWindow` exists even in windows with
+ * no miztake creation, so empty windows can be finalized and season accounting can be reconciled.
+ */
+export declare function initializeRewardWindow(options: InitializeRewardWindowOptions): Promise<StandardInstructionResultWithPdas<InitializeRewardWindowPdas>>;

package/dist/instructions/initializeRewardWindow.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initializeRewardWindow = initializeRewardWindow;
+const web3_js_1 = require("@solana/web3.js");
+const pdas_1 = require("../utils/pdas");
+const programHelpers_1 = require("../utils/programHelpers");
+const signerHelpers_1 = require("../utils/signerHelpers");
+const conversions_1 = require("../utils/conversions");
+/**
+ * Initialize (materialize) a missing RewardWindow PDA (root-admin only).
+ *
+ * This is a maintenance instruction used to ensure a `RewardWindow` exists even in windows with
+ * no miztake creation, so empty windows can be finalized and season accounting can be reconciled.
+ */
+async function initializeRewardWindow(options) {
+    const program = (0, programHelpers_1.getProgram)(options.connection);
+    const seasonNumberBn = (0, conversions_1.toSeasonNumberBn)(options.seasonNumber);
+    const windowNumberBn = (0, conversions_1.toWindowNumberBn)(options.windowNumber);
+    const [seasonSettings] = (0, pdas_1.getSeasonSettingsPda)();
+    const [season] = (0, pdas_1.getSeasonPda)(seasonNumberBn);
+    const [rewardWindow] = (0, pdas_1.getRewardWindowPda)(seasonNumberBn, windowNumberBn);
+    const accounts = {
+        seasonSettings,
+        season,
+        rewardWindow,
+        admin: options.admin,
+        systemProgram: web3_js_1.SystemProgram.programId,
+    };
+    const instruction = await program.methods
+        .initializeRewardWindow(seasonNumberBn, windowNumberBn)
+        .accounts(accounts)
+        .instruction();
+    const signers = (0, signerHelpers_1.buildSigners)([{ publicKey: options.admin, role: "admin" }], options.feePayer);
+    return {
+        instructions: [instruction],
+        signers,
+        pdas: { seasonSettings, season, rewardWindow },
+    };
+}

package/dist/types/accountTypes.d.ts

@@ -35,6 +35,13 @@ export interface InitializeEscrowVaultAccounts {
     tokenProgram: PublicKey;
     systemProgram: PublicKey;
 }
+export interface InitializeRewardWindowAccounts {
+    seasonSettings: PublicKey;
+    season: PublicKey;
+    rewardWindow: PublicKey;
+    admin: PublicKey;
+    systemProgram: PublicKey;
+}
 export interface InitializeStatisticsAccounts {
     miztakeStatistics: PublicKey;
     admin: PublicKey;

package/dist/types/proof_of_take.d.ts

@@ -1141,6 +1141,123 @@ export type ProofOfTake = {
                 }
             ];
         },
+        {
+            "name": "initializeRewardWindow";
+            "discriminator": [
+                206,
+                116,
+                55,
+                128,
+                199,
+                75,
+                194,
+                213
+            ];
+            "accounts": [
+                {
+                    "name": "seasonSettings";
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    115,
+                                    101,
+                                    97,
+                                    115,
+                                    111,
+                                    110,
+                                    95,
+                                    115,
+                                    101,
+                                    116,
+                                    116,
+                                    105,
+                                    110,
+                                    103,
+                                    115
+                                ];
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "season";
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    115,
+                                    101,
+                                    97,
+                                    115,
+                                    111,
+                                    110
+                                ];
+                            },
+                            {
+                                "kind": "arg";
+                                "path": "seasonNumber";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "rewardWindow";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    114,
+                                    101,
+                                    119,
+                                    97,
+                                    114,
+                                    100,
+                                    95,
+                                    119,
+                                    105,
+                                    110,
+                                    100,
+                                    111,
+                                    119
+                                ];
+                            },
+                            {
+                                "kind": "arg";
+                                "path": "seasonNumber";
+                            },
+                            {
+                                "kind": "arg";
+                                "path": "windowNumber";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "admin";
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "systemProgram";
+                    "address": "11111111111111111111111111111111";
+                }
+            ];
+            "args": [
+                {
+                    "name": "seasonNumber";
+                    "type": "u64";
+                },
+                {
+                    "name": "windowNumber";
+                    "type": "u64";
+                }
+            ];
+        },
         {
             "name": "initializeSeasonSettings";
             "discriminator": [

package/package.json

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