proof-of-take-sdk 3.0.7 → 3.0.8

package/dist/utils/signerHelpers.d.ts

@@ -7,6 +7,26 @@ export interface SignerInfo {
     publicKey: PublicKey;
     role: SignerRole;
 }
+/**
+ * Resolve fee payer for this SDK.
+ *
+ * Policy:
+ * - If `feePayer` is provided, use it.
+ * - Else if an instruction-specific `admin` key is provided, use it.
+ * - Else fall back to global `ADMIN_PUBLIC_KEY`.
+ */
+export declare function resolveFeePayer(params?: {
+    feePayer?: PublicKey | undefined;
+    admin?: PublicKey | undefined;
+}): PublicKey;
+/** Back-compat alias (admin pays by default). */
+export declare function getDefaultFeePayer(feePayer?: PublicKey): PublicKey;
+export declare const asAdminSigner: (publicKey: PublicKey) => SignerInfo;
+export declare const asUserSigner: (publicKey: PublicKey) => SignerInfo;
+export declare const asClaimantSigner: (publicKey: PublicKey) => SignerInfo;
+export declare const asCurrentAdminSigner: (publicKey: PublicKey) => SignerInfo;
+export declare const asFeePayerSigner: (publicKey: PublicKey) => SignerInfo;
+export declare const asPayerSigner: (publicKey: PublicKey) => SignerInfo;
 /**
  * Build signers array with optional fee payer
  * Automatically deduplicates if fee payer is already in required signers

package/dist/utils/signerHelpers.js

@@ -1,6 +1,56 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.asPayerSigner = exports.asFeePayerSigner = exports.asCurrentAdminSigner = exports.asClaimantSigner = exports.asUserSigner = exports.asAdminSigner = void 0;
+exports.resolveFeePayer = resolveFeePayer;
+exports.getDefaultFeePayer = getDefaultFeePayer;
 exports.buildSigners = buildSigners;
+const constants_1 = require("./constants");
+/**
+ * Resolve fee payer for this SDK.
+ *
+ * Policy:
+ * - If `feePayer` is provided, use it.
+ * - Else if an instruction-specific `admin` key is provided, use it.
+ * - Else fall back to global `ADMIN_PUBLIC_KEY`.
+ */
+function resolveFeePayer(params) {
+    return params?.feePayer ?? params?.admin ?? constants_1.ADMIN_PUBLIC_KEY;
+}
+/** Back-compat alias (admin pays by default). */
+function getDefaultFeePayer(feePayer) {
+    return resolveFeePayer({ feePayer });
+}
+// ---- Signer constructors (to avoid ad-hoc role strings) ----
+const asAdminSigner = (publicKey) => ({
+    publicKey,
+    role: "admin",
+});
+exports.asAdminSigner = asAdminSigner;
+const asUserSigner = (publicKey) => ({
+    publicKey,
+    role: "user",
+});
+exports.asUserSigner = asUserSigner;
+const asClaimantSigner = (publicKey) => ({
+    publicKey,
+    role: "claimant",
+});
+exports.asClaimantSigner = asClaimantSigner;
+const asCurrentAdminSigner = (publicKey) => ({
+    publicKey,
+    role: "currentAdmin",
+});
+exports.asCurrentAdminSigner = asCurrentAdminSigner;
+const asFeePayerSigner = (publicKey) => ({
+    publicKey,
+    role: "feePayer",
+});
+exports.asFeePayerSigner = asFeePayerSigner;
+const asPayerSigner = (publicKey) => ({
+    publicKey,
+    role: "payer",
+});
+exports.asPayerSigner = asPayerSigner;
 /**
  * Build signers array with optional fee payer
  * Automatically deduplicates if fee payer is already in required signers
@@ -11,11 +61,20 @@ exports.buildSigners = buildSigners;
  */
 function buildSigners(requiredSigners, feePayer) {
     const signers = [...requiredSigners];
-    if (feePayer) {
-        const alreadyIncluded = signers.some((s) => s.publicKey.equals(feePayer));
-        if (!alreadyIncluded) {
-            signers.push({ publicKey: feePayer, role: "feePayer" });
-        }
+    if (!feePayer) {
+        return signers;
+    }
+    // If fee payer is already among required signers (e.g. admin), move that signer to the front
+    // while preserving its original role. This ensures builders that default to signers[0] will
+    // still behave correctly, and avoids requiring a separate "feePayer" wallet mapping.
+    const existingIdx = signers.findIndex((s) => s.publicKey.equals(feePayer));
+    if (existingIdx >= 0) {
+        const existing = signers.splice(existingIdx, 1)[0];
+        signers.unshift(existing);
+        return signers;
     }
+    // Otherwise, include an explicit fee payer signer (callers must provide a wallet for role "feePayer").
+    const role = feePayer.equals(constants_1.ADMIN_PUBLIC_KEY) ? "admin" : "feePayer";
+    signers.unshift({ publicKey: feePayer, role });
     return signers;
 }

package/dist/utils/tierPenalty.d.ts

@@ -1,11 +1,11 @@
 import { BN } from "@coral-xyz/anchor";
 import { SeasonDepositTier, TierNumber } from "../types";
 /**
- * Validate and normalize a tier number (1..=5).
+ * Validate and normalize a tier number (0..=4).
  */
 export declare function assertValidTierNumber(tier: number): TierNumber;
 /**
- * Convert numeric tier (1..=5) to the Anchor enum representation.
+ * Convert numeric tier (0..=4) to the Anchor enum representation.
  */
 export declare function tierNumberToDepositTier(tier: number): SeasonDepositTier;
 /**

package/dist/utils/tierPenalty.js

@@ -6,28 +6,28 @@ exports.getTierPenaltyPerWindow = getTierPenaltyPerWindow;
 const anchor_1 = require("@coral-xyz/anchor");
 const depositTier_1 = require("./depositTier");
 /**
- * Validate and normalize a tier number (1..=5).
+ * Validate and normalize a tier number (0..=4).
  */
 function assertValidTierNumber(tier) {
-    if (!Number.isInteger(tier) || tier < 1 || tier > 5) {
-        throw new Error("Invalid tier: must be an integer between 1 and 5");
+    if (!Number.isInteger(tier) || tier < 0 || tier > 4) {
+        throw new Error("Invalid tier: must be an integer between 0 and 4");
     }
     return tier;
 }
 /**
- * Convert numeric tier (1..=5) to the Anchor enum representation.
+ * Convert numeric tier (0..=4) to the Anchor enum representation.
  */
 function tierNumberToDepositTier(tier) {
     switch (assertValidTierNumber(tier)) {
-        case 1:
+        case 0:
             return { copper: {} };
-        case 2:
+        case 1:
             return { silver: {} };
-        case 3:
+        case 2:
             return { gold: {} };
-        case 4:
+        case 3:
             return { platinum: {} };
-        case 5:
+        case 4:
             return { mithril: {} };
     }
     // unreachable

package/dist/utils/tierSeeds.d.ts

@@ -0,0 +1,8 @@
+import type { TierNumber } from "../types";
+/**
+ * Canonical tier encoding used for PDA seeds across the program.
+ *
+ * IMPORTANT: The tier byte is part of PDA seeds for several accounts (e.g. SeasonMembership,
+ * UserWindowParticipation, ReferralPenaltyClaim). Changing this mapping changes addresses.
+ */
+export declare function toTierSeedByte(tier: TierNumber): number;

package/dist/utils/tierSeeds.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toTierSeedByte = toTierSeedByte;
+/**
+ * Canonical tier encoding used for PDA seeds across the program.
+ *
+ * IMPORTANT: The tier byte is part of PDA seeds for several accounts (e.g. SeasonMembership,
+ * UserWindowParticipation, ReferralPenaltyClaim). Changing this mapping changes addresses.
+ */
+function toTierSeedByte(tier) {
+    // Currently the TierNumber union is already the canonical seed byte (0..4),
+    // but keeping this indirection makes future tier encoding changes a 1-line edit.
+    return tier;
+}

package/dist/utils/transactionBuilder.d.ts

@@ -35,6 +35,7 @@ export declare class TransactionBuilder {
     private connection;
     private wallets;
     constructor(connection: Connection, wallets: Map<string, WalletAdapter>);
+    private getFeePayerFromSigners;
     /**
      * Build a transaction from instructions
      */

package/dist/utils/transactionBuilder.js

@@ -12,6 +12,14 @@ class TransactionBuilder {
         this.connection = connection;
         this.wallets = wallets;
     }
+    getFeePayerFromSigners(signers) {
+        const explicit = signers.find((s) => s.role === "feePayer")?.publicKey;
+        const fallback = signers[0]?.publicKey;
+        if (!explicit && !fallback) {
+            throw new Error("At least one signer required");
+        }
+        return explicit ?? fallback;
+    }
     /**
      * Build a transaction from instructions
      */
@@ -60,11 +68,8 @@ class TransactionBuilder {
      * Build, sign, and send a transaction
      */
     async buildSignAndSend(instructions, signers, options) {
-        // Determine fee payer (first signer by default)
-        const feePayer = signers[0]?.publicKey;
-        if (!feePayer) {
-            throw new Error("At least one signer required");
-        }
+        // Determine fee payer (explicit feePayer role preferred; else first signer)
+        const feePayer = this.getFeePayerFromSigners(signers);
         // Build transaction
         const transaction = await this.buildTransaction(instructions, feePayer, options);
         // Sign transaction
@@ -84,10 +89,7 @@ class TransactionBuilder {
      * Simulate a transaction without sending
      */
     async simulate(instructions, signers) {
-        const feePayer = signers[0]?.publicKey;
-        if (!feePayer) {
-            throw new Error("At least one signer required for simulation");
-        }
+        const feePayer = this.getFeePayerFromSigners(signers);
         const transaction = await this.buildTransaction(instructions, feePayer);
         try {
             const simulation = await this.connection.simulateTransaction(transaction);

package/package.json

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