proof-of-take-sdk 3.0.5 → 3.0.8

package/dist/instructions/joinSeason.js

@@ -13,6 +13,7 @@ const optimistic_1 = require("../optimistic");
 const pdas_1 = require("../utils/pdas");
 const tierPenalty_1 = require("../utils/tierPenalty");
 const enumHelpers_1 = require("../utils/enumHelpers");
+const remainingAccounts_1 = require("../utils/remainingAccounts");
 /**
  * Join a season
  *
@@ -30,6 +31,7 @@ async function joinSeason(options) {
         seasonNumber: options.seasonNumber,
         tier: options.tier,
     });
+    const rootAdminTokenAccount = (0, spl_token_1.getAssociatedTokenAddressSync)(constants_1.MIZD_TOKEN_MINT, constants_1.ADMIN_PUBLIC_KEY);
     const accounts = {
         seasonSettings: pdas.seasonSettings,
         season: pdas.season,
@@ -37,17 +39,30 @@ async function joinSeason(options) {
         seasonDepositVault: pdas.seasonDepositVault,
         seasonEscrowVault: pdas.seasonEscrowVault,
         mizdMint: constants_1.MIZD_TOKEN_MINT,
+        rootAdmin: constants_1.ADMIN_PUBLIC_KEY,
+        rootAdminTokenAccount,
         userTokenAccount: options.userTokenAccount,
         user: options.user,
+        associatedTokenProgram: spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID,
         tokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
         systemProgram: web3_js_1.SystemProgram.programId,
     };
-    const instruction = await program.methods
+    const referrer = options.referrer ?? web3_js_1.PublicKey.default;
+    const remainingAccounts = (0, remainingAccounts_1.getJoinSeasonRemainingAccounts)({
+        seasonNumber: options.seasonNumber,
+        tier: options.tier,
+        referrer,
+    });
+    const methodBuilder = program.methods
         // Anchor expects BN for u64 args.
-        .joinSeason(options.seasonNumber, options.tier, options.referrer ?? web3_js_1.PublicKey.default)
-        .accounts(accounts)
-        .instruction();
-    const signers = (0, signerHelpers_1.buildSigners)([{ publicKey: options.user, role: "user" }], options.feePayer);
+        .joinSeason(options.seasonNumber, options.tier, referrer)
+        .accounts(accounts);
+    if (remainingAccounts.length > 0) {
+        methodBuilder.remainingAccounts(remainingAccounts);
+    }
+    const instruction = await methodBuilder.instruction();
+    const feePayer = (0, signerHelpers_1.getDefaultFeePayer)(options.feePayer);
+    const signers = (0, signerHelpers_1.buildSigners)([(0, signerHelpers_1.asUserSigner)(options.user)], feePayer);
     // OPTIMISTIC UPDATES
     const curr = options.currentAccounts || {};
     const now = (0, optimistic_1.getCurrentTimestamp)(options.now);

package/dist/instructions/toggleSeasonPause.js

@@ -5,6 +5,7 @@ const pdas_1 = require("../utils/pdas");
 const programHelpers_1 = require("../utils/programHelpers");
 const signerHelpers_1 = require("../utils/signerHelpers");
 const optimistic_1 = require("../optimistic");
+const instructionResultHelpers_1 = require("../utils/instructionResultHelpers");
 /**
  * Toggle season system pause
  *
@@ -28,16 +29,14 @@ async function toggleSeasonPause(connection, admin, feePayer, seasonSettings) {
         .toggleSeasonPause()
         .accounts(accounts)
         .instruction();
-    const signers = (0, signerHelpers_1.buildSigners)([{ publicKey: admin, role: "admin" }], feePayer);
+    const actualFeePayer = (0, signerHelpers_1.resolveFeePayer)({ feePayer, admin });
+    const signers = (0, signerHelpers_1.buildSigners)([(0, signerHelpers_1.asAdminSigner)(admin)], actualFeePayer);
     const updatedSettings = seasonSettings
         ? (0, optimistic_1.updateSeasonSettingsForPauseToggle)(seasonSettings)
         : undefined;
-    return {
-        instructions: [instruction],
+    return (0, instructionResultHelpers_1.singleInstruction)(instruction, {
         signers,
         pdas: { seasonSettings: seasonSettingsPda },
-        ...(updatedSettings && {
-            updatedAccounts: { seasonSettings: updatedSettings },
-        }),
-    };
+        ...(updatedSettings && { updatedAccounts: { seasonSettings: updatedSettings } }),
+    });
 }

package/dist/instructions/updateSeasonAdmin.js

@@ -5,6 +5,7 @@ const pdas_1 = require("../utils/pdas");
 const programHelpers_1 = require("../utils/programHelpers");
 const signerHelpers_1 = require("../utils/signerHelpers");
 const optimistic_1 = require("../optimistic");
+const instructionResultHelpers_1 = require("../utils/instructionResultHelpers");
 /**
  * Update season admin
  *
@@ -29,16 +30,14 @@ async function updateSeasonAdmin(connection, currentAdmin, newAdmin, feePayer, s
         .updateSeasonAdmin(newAdmin)
         .accounts(accounts)
         .instruction();
-    const signers = (0, signerHelpers_1.buildSigners)([{ publicKey: currentAdmin, role: "currentAdmin" }], feePayer);
+    const actualFeePayer = (0, signerHelpers_1.resolveFeePayer)({ feePayer, admin: currentAdmin });
+    const signers = (0, signerHelpers_1.buildSigners)([(0, signerHelpers_1.asCurrentAdminSigner)(currentAdmin)], actualFeePayer);
     const updatedSettings = seasonSettings
         ? (0, optimistic_1.updateSeasonSettingsForAdminUpdate)(seasonSettings, newAdmin)
         : undefined;
-    return {
-        instructions: [instruction],
+    return (0, instructionResultHelpers_1.singleInstruction)(instruction, {
         signers,
         pdas: { seasonSettings: seasonSettingsPda },
-        ...(updatedSettings && {
-            updatedAccounts: { seasonSettings: updatedSettings },
-        }),
-    };
+        ...(updatedSettings && { updatedAccounts: { seasonSettings: updatedSettings } }),
+    });
 }

package/dist/instructions/viewSeasonMembershipStatus.d.ts

@@ -10,7 +10,7 @@ import { SeasonMembershipStatusView, TierNumber } from "../types";
  * @param connection - Solana connection
  * @param user - User's public key
  * @param seasonNumber - Season number
- * @param tier - Tier number: 1=copper, 2=silver, 3=gold, 4=platinum, 5=mithril
+ * @param tier - Tier number: 0=copper, 1=silver, 2=gold, 3=platinum, 4=mithril
  * @returns View data with membership status
  */
 export declare function viewSeasonMembershipStatus(connection: Connection, user: PublicKey, seasonNumber: BN, tier: TierNumber): Promise<SeasonMembershipStatusView>;

package/dist/instructions/viewSeasonMembershipStatus.js

@@ -12,7 +12,7 @@ const programHelpers_1 = require("../utils/programHelpers");
  * @param connection - Solana connection
  * @param user - User's public key
  * @param seasonNumber - Season number
- * @param tier - Tier number: 1=copper, 2=silver, 3=gold, 4=platinum, 5=mithril
+ * @param tier - Tier number: 0=copper, 1=silver, 2=gold, 3=platinum, 4=mithril
  * @returns View data with membership status
  */
 async function viewSeasonMembershipStatus(connection, user, seasonNumber, tier) {

package/dist/instructions/withdrawSeasonDeposit.d.ts

@@ -15,7 +15,7 @@ export interface WithdrawSeasonDepositOptions {
     user: PublicKey;
     userTokenAccount: PublicKey;
     seasonNumber: BN;
-    /** Tier number: 1=copper, 2=silver, 3=gold, 4=platinum, 5=mithril */
+    /** Tier number: 0=copper, 1=silver, 2=gold, 3=platinum, 4=mithril */
     tier: TierNumber;
     feePayer?: PublicKey;
     currentAccounts?: {

package/dist/instructions/withdrawSeasonDeposit.js

@@ -40,7 +40,8 @@ async function withdrawSeasonDeposit(options) {
         .withdrawSeasonDeposit(options.tier)
         .accounts(accounts)
         .instruction();
-    const signers = (0, signerHelpers_1.buildSigners)([{ publicKey: options.user, role: "user" }], options.feePayer);
+    const feePayer = (0, signerHelpers_1.getDefaultFeePayer)(options.feePayer);
+    const signers = (0, signerHelpers_1.buildSigners)([(0, signerHelpers_1.asUserSigner)(options.user)], feePayer);
     // OPTIMISTIC UPDATES
     let withdrawalAmount;
     let updatedAccounts = undefined;

package/dist/types/accountTypes.d.ts

@@ -55,8 +55,11 @@ export interface JoinSeasonAccounts {
     seasonDepositVault: PublicKey;
     seasonEscrowVault: PublicKey;
     mizdMint: PublicKey;
+    rootAdmin: PublicKey;
+    rootAdminTokenAccount: PublicKey;
     userTokenAccount: PublicKey;
     user: PublicKey;
+    associatedTokenProgram: PublicKey;
     tokenProgram: PublicKey;
     systemProgram: PublicKey;
 }

package/dist/types/proof_of_take.d.ts

@@ -1602,6 +1602,100 @@ export type ProofOfTake = {
                     "name": "mizdMint";
                     "address": "mizdS9fDNUKWZcXBeRhJoJQHJJmsTeF4fFRyPdXWv99";
                 },
+                {
+                    "name": "rootAdmin";
+                    "address": "Lude4DE3jDXVViJ3s7bUfPXdXy8Zq7G1stMwHNQrc2s";
+                },
+                {
+                    "name": "rootAdminTokenAccount";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "account";
+                                "path": "rootAdmin";
+                            },
+                            {
+                                "kind": "const";
+                                "value": [
+                                    6,
+                                    221,
+                                    246,
+                                    225,
+                                    215,
+                                    101,
+                                    161,
+                                    147,
+                                    217,
+                                    203,
+                                    225,
+                                    70,
+                                    206,
+                                    235,
+                                    121,
+                                    172,
+                                    28,
+                                    180,
+                                    133,
+                                    237,
+                                    95,
+                                    91,
+                                    55,
+                                    145,
+                                    58,
+                                    140,
+                                    245,
+                                    133,
+                                    126,
+                                    255,
+                                    0,
+                                    169
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "mizdMint";
+                            }
+                        ];
+                        "program": {
+                            "kind": "const";
+                            "value": [
+                                140,
+                                151,
+                                37,
+                                143,
+                                78,
+                                36,
+                                137,
+                                241,
+                                187,
+                                61,
+                                16,
+                                41,
+                                20,
+                                142,
+                                13,
+                                131,
+                                11,
+                                90,
+                                19,
+                                153,
+                                218,
+                                255,
+                                16,
+                                132,
+                                4,
+                                142,
+                                123,
+                                216,
+                                219,
+                                233,
+                                248,
+                                89
+                            ];
+                        };
+                    };
+                },
                 {
                     "name": "userTokenAccount";
                     "writable": true;
@@ -1611,6 +1705,10 @@ export type ProofOfTake = {
                     "writable": true;
                     "signer": true;
                 },
+                {
+                    "name": "associatedTokenProgram";
+                    "address": "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL";
+                },
                 {
                     "name": "tokenProgram";
                     "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
@@ -2837,43 +2935,58 @@ export type ProofOfTake = {
         },
         {
             "code": 6035;
+            "name": "invalidReferrerMembership";
+            "msg": "Invalid referrer season membership account";
+        },
+        {
+            "code": 6036;
             "name": "referralPenaltyAlreadyClaimed";
             "msg": "Referral penalty already claimed for this user/window";
         },
         {
-            "code": 6036;
+            "code": 6037;
             "name": "referralPenaltyClaimNotAvailableYet";
             "msg": "Referral penalty claim not available yet (must wait until window end + claim buffer)";
         },
         {
-            "code": 6037;
+            "code": 6038;
             "name": "referralPenaltyNotEligibleForWindow";
             "msg": "Referred user was not eligible for this window";
         },
         {
-            "code": 6038;
+            "code": 6039;
             "name": "referralPenaltyNoMissedPenalty";
             "msg": "Referred user posted successfully (no penalty to claim)";
         },
         {
-            "code": 6039;
+            "code": 6040;
             "name": "windowAlreadyFinalized";
             "msg": "Window is already finalized";
         },
         {
-            "code": 6040;
+            "code": 6041;
             "name": "windowNotEmpty";
             "msg": "Window is not empty (has successful posters)";
         },
         {
-            "code": 6041;
+            "code": 6042;
             "name": "calculationError";
             "msg": "Calculation error";
         },
         {
-            "code": 6042;
+            "code": 6043;
             "name": "insufficientFunds";
             "msg": "Insufficient funds";
+        },
+        {
+            "code": 6044;
+            "name": "noWindowRewardsToClaim";
+            "msg": "Nothing to claim for this window (reward amount is 0)";
+        },
+        {
+            "code": 6045;
+            "name": "noReferralPenaltyToClaim";
+            "msg": "Nothing to claim for this window (referral penalty amount is 0)";
         }
     ];
     "types": [
@@ -3050,7 +3163,7 @@ export type ProofOfTake = {
                     {
                         "name": "tier";
                         "docs": [
-                            "Tier number used for the membership PDA (1..=5)"
+                            "Tier number used for the membership PDA (0..=4)"
                         ];
                         "type": "u8";
                     },
@@ -3103,7 +3216,7 @@ export type ProofOfTake = {
                     {
                         "name": "tier";
                         "docs": [
-                            "Tier number used for the membership PDA (1..=5)"
+                            "Tier number used for the membership PDA (0..=4)"
                         ];
                         "type": "u8";
                     },
@@ -3210,7 +3323,7 @@ export type ProofOfTake = {
                     {
                         "name": "tier";
                         "docs": [
-                            "Tier number used for the membership PDA (1..=5)"
+                            "Tier number used for the membership PDA (0..=4)"
                         ];
                         "type": "u8";
                     },
@@ -3560,7 +3673,7 @@ export type ProofOfTake = {
                     {
                         "name": "tier";
                         "docs": [
-                            "Tier number used for the membership PDA (1..=5)"
+                            "Tier number used for the membership PDA (0..=4)"
                         ];
                         "type": "u8";
                     },
@@ -3651,7 +3764,7 @@ export type ProofOfTake = {
                     {
                         "name": "tier";
                         "docs": [
-                            "Tier number used for the membership PDA (1..=5)"
+                            "Tier number used for the membership PDA (0..=4)"
                         ];
                         "type": "u8";
                     },
@@ -3697,6 +3810,13 @@ export type ProofOfTake = {
                         ];
                         "type": "pubkey";
                     },
+                    {
+                        "name": "referralCount";
+                        "docs": [
+                            "Total number of successful referrals for this membership (incremented when others join with this member as referrer)"
+                        ];
+                        "type": "u64";
+                    },
                     {
                         "name": "seasonNumber";
                         "docs": [

package/dist/types.d.ts

@@ -16,9 +16,9 @@ type AnchorEnumVariant<K extends string> = {
 };
 /**
  * Tier number used across the program (and PDA seeds).
- * 1=copper, 2=silver, 3=gold, 4=platinum, 5=mithril
+ * 0=copper, 1=silver, 2=gold, 3=platinum, 4=mithril
  */
-export type TierNumber = 1 | 2 | 3 | 4 | 5;
+export type TierNumber = 0 | 1 | 2 | 3 | 4;
 /**
  * Branded types for common on-chain invariants.
  */
@@ -170,6 +170,8 @@ export interface SeasonMembership {
     owner: PublicKey;
     /** Optional referrer (PublicKey.default means no referrer). */
     referrer: PublicKey;
+    /** Total number of successful referrals for this membership. */
+    referralCount: BN;
     seasonNumber: BN;
     depositTier: SeasonDepositTier;
     depositAmount: BN;

package/dist/utils/accountConverters.js

@@ -93,6 +93,7 @@ function toSdkSeasonMembership(a) {
     return {
         owner: a.owner,
         referrer: a.referrer,
+        referralCount: a.referralCount,
         seasonNumber: a.seasonNumber,
         depositTier: a.depositTier,
         depositAmount: a.depositAmount,

package/dist/utils/accountUpdates.d.ts

@@ -94,7 +94,7 @@ export declare function updateMiztakeStatisticsForCreation(statistics: MiztakeSt
  * @param user - User's public key
  * @param seasonNumber - Season number
  * @param windowNumber - Window number
- * @param tier - Tier number (1..=5)
+ * @param tier - Tier number (0..=4)
  * @param miztakeId - The miztake ID to associate
  * @returns Initialized/Updated UserWindowParticipation object
  */
@@ -125,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 tier - Tier number (1..=5)
+ * @param tier - Tier number (0..=4)
  * @param seasonNumber - Season number
  * @param depositTier - Tier chosen at join time
  * @param depositAmount - Active deposit amount (participates in rewards/penalties)
@@ -225,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 tier - Tier number (1..=5)
+ * @param tier - Tier number (0..=4)
  * @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)

package/dist/utils/accountUpdates.js

@@ -188,7 +188,7 @@ function updateMiztakeStatisticsForCreation(statistics) {
  * @param user - User's public key
  * @param seasonNumber - Season number
  * @param windowNumber - Window number
- * @param tier - Tier number (1..=5)
+ * @param tier - Tier number (0..=4)
  * @param miztakeId - The miztake ID to associate
  * @returns Initialized/Updated UserWindowParticipation object
  */
@@ -255,7 +255,7 @@ function updateMiztakeForSeasonUse(miztake, seasonNumber, windowNumber) {
  * Mirrors the initialization from join_season.rs (lines 84-96)
  *
  * @param user - User's public key
- * @param tier - Tier number (1..=5)
+ * @param tier - Tier number (0..=4)
  * @param seasonNumber - Season number
  * @param depositTier - Tier chosen at join time
  * @param depositAmount - Active deposit amount (participates in rewards/penalties)
@@ -268,6 +268,7 @@ function initializeSeasonMembership(user, seasonNumber, depositTier, referrer, d
     return {
         owner: user,
         referrer,
+        referralCount: new anchor_1.BN(0),
         seasonNumber,
         depositTier,
         depositAmount,
@@ -538,7 +539,7 @@ function updateMembershipForClaim(membership, rewardAmount) {
  * @param referredUser - The user who missed the window
  * @param seasonNumber - Season number
  * @param windowNumber - Window number
- * @param tier - Tier number (1..=5)
+ * @param tier - Tier number (0..=4)
  * @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)

package/dist/utils/instructionResultHelpers.d.ts

@@ -0,0 +1,7 @@
+import type { TransactionInstruction } from "@solana/web3.js";
+/**
+ * Small helper to standardize SDK instruction result shape.
+ */
+export declare function singleInstruction<T extends object>(instruction: TransactionInstruction, rest: T): T & {
+    instructions: TransactionInstruction[];
+};

package/dist/utils/instructionResultHelpers.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.singleInstruction = singleInstruction;
+/**
+ * Small helper to standardize SDK instruction result shape.
+ */
+function singleInstruction(instruction, rest) {
+    return { instructions: [instruction], ...rest };
+}

package/dist/utils/pdas.d.ts

@@ -33,11 +33,11 @@ export declare function getSeasonPda(seasonNumber: SeasonNumberLike): [PublicKey
  *   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
+ * 0 = copper, 1 = silver, 2 = gold, 3 = platinum, 4 = mithril
  *
  * @param seasonNumber - The season number
  * @param user - The user's public key
- * @param tier - Tier number (1..=5)
+ * @param tier - Tier number (0..=4)
  */
 export declare function getSeasonMembershipPda(seasonNumber: SeasonNumberLike, user: PublicKey, tier: TierNumber): [PublicKey, number];
 /**
@@ -53,7 +53,7 @@ export declare function getRewardWindowPda(seasonNumber: SeasonNumberLike, windo
  *
  * @param seasonNumber - The season number
  * @param user - The user's public key
- * @param tier - Tier number (1..=5)
+ * @param tier - Tier number (0..=4)
  * @param windowNumber - The window number
  */
 export declare function getUserWindowParticipationPda(seasonNumber: SeasonNumberLike, user: PublicKey, tier: TierNumber, windowNumber: BN): [PublicKey, number];
@@ -72,7 +72,7 @@ export declare function getSeasonEscrowVaultPda(seasonNumber: SeasonNumberLike):
  *
  * @param seasonNumber - The season number
  * @param referredUser - The referred user's public key (the user who missed)
- * @param tier - Tier number (1..=5)
+ * @param tier - Tier number (0..=4)
  * @param windowNumber - The window number
  */
 export declare function getReferralPenaltyClaimPda(seasonNumber: SeasonNumberLike, referredUser: PublicKey, tier: TierNumber, windowNumber: BN): [PublicKey, number];

package/dist/utils/pdas.js

@@ -15,6 +15,7 @@ const web3_js_1 = require("@solana/web3.js");
 const constants_1 = require("./constants");
 const conversions_1 = require("./conversions");
 const tierPenalty_1 = require("./tierPenalty");
+const tierSeeds_1 = require("./tierSeeds");
 const conversions_2 = require("./conversions");
 /**
  * PDA (Program Derived Address) derivation helpers
@@ -61,11 +62,11 @@ function getSeasonPda(seasonNumber) {
  *   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
+ * 0 = copper, 1 = silver, 2 = gold, 3 = platinum, 4 = mithril
  *
  * @param seasonNumber - The season number
  * @param user - The user's public key
- * @param tier - Tier number (1..=5)
+ * @param tier - Tier number (0..=4)
  */
 function getSeasonMembershipPda(seasonNumber, user, tier) {
     const t = (0, tierPenalty_1.assertValidTierNumber)(tier);
@@ -74,7 +75,7 @@ function getSeasonMembershipPda(seasonNumber, user, tier) {
         Buffer.from("season_membership"),
         seasonBn.toArrayLike(Buffer, "le", 8),
         user.toBuffer(),
-        Buffer.from([t]),
+        Buffer.from([(0, tierSeeds_1.toTierSeedByte)(t)]),
     ], constants_1.PROGRAM_ID);
 }
 /**
@@ -97,7 +98,7 @@ function getRewardWindowPda(seasonNumber, windowNumber) {
  *
  * @param seasonNumber - The season number
  * @param user - The user's public key
- * @param tier - Tier number (1..=5)
+ * @param tier - Tier number (0..=4)
  * @param windowNumber - The window number
  */
 function getUserWindowParticipationPda(seasonNumber, user, tier, windowNumber) {
@@ -107,7 +108,7 @@ function getUserWindowParticipationPda(seasonNumber, user, tier, windowNumber) {
         Buffer.from("user_window"),
         seasonBn.toArrayLike(Buffer, "le", 8),
         user.toBuffer(),
-        Buffer.from([t]),
+        Buffer.from([(0, tierSeeds_1.toTierSeedByte)(t)]),
         windowNumber.toArrayLike(Buffer, "le", 8),
     ], constants_1.PROGRAM_ID);
 }
@@ -132,7 +133,7 @@ function getSeasonEscrowVaultPda(seasonNumber) {
  *
  * @param seasonNumber - The season number
  * @param referredUser - The referred user's public key (the user who missed)
- * @param tier - Tier number (1..=5)
+ * @param tier - Tier number (0..=4)
  * @param windowNumber - The window number
  */
 function getReferralPenaltyClaimPda(seasonNumber, referredUser, tier, windowNumber) {
@@ -142,7 +143,7 @@ function getReferralPenaltyClaimPda(seasonNumber, referredUser, tier, windowNumb
         Buffer.from(constants_1.REFERRAL_PENALTY_CLAIM_SEED),
         seasonBn.toArrayLike(Buffer, "le", 8),
         referredUser.toBuffer(),
-        Buffer.from([t]),
+        Buffer.from([(0, tierSeeds_1.toTierSeedByte)(t)]),
         windowNumber.toArrayLike(Buffer, "le", 8),
     ], constants_1.PROGRAM_ID);
 }

package/dist/utils/programErrors.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Helpers for working with Solana/Anchor program errors.
+ *
+ * Goal: prefer checking errors by numeric code (stable) instead of string names
+ * (which may differ by casing between IDL vs generated TS types).
+ */
+/**
+ * Try to extract a custom program error code (Anchor error code number).
+ *
+ * Returns `null` if the code cannot be determined.
+ */
+export declare function getCustomProgramErrorCode(err: unknown): number | null;
+export declare function isCustomProgramErrorCode(err: unknown, code: number): boolean;