proof-of-take-sdk 1.0.0

package/dist/instructions/toggleSeasonPause.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toggleSeasonPause = toggleSeasonPause;
+const pdas_1 = require("../utils/pdas");
+const programHelpers_1 = require("../utils/programHelpers");
+const signerHelpers_1 = require("../utils/signerHelpers");
+const optimistic_1 = require("../optimistic");
+/**
+ * Toggle season system pause
+ *
+ * Single signer: admin (season admin)
+ * Toggles the isPaused flag on season settings
+ *
+ * @param connection - Solana connection
+ * @param admin - Season admin's public key
+ * @param feePayer - Optional separate fee payer for transaction fees
+ * @param seasonSettings - Optional season settings (returns updated version)
+ * @returns Instructions, signers, and optimistically updated settings
+ */
+async function toggleSeasonPause(connection, admin, feePayer, seasonSettings) {
+    const program = (0, programHelpers_1.getProgram)(connection);
+    const [seasonSettingsPda] = (0, pdas_1.getSeasonSettingsPda)();
+    const accounts = {
+        seasonSettings: seasonSettingsPda,
+        admin: admin,
+    };
+    const instruction = await program.methods
+        .toggleSeasonPause()
+        .accounts(accounts)
+        .instruction();
+    const signers = (0, signerHelpers_1.buildSigners)([{ publicKey: admin, role: "admin" }], feePayer);
+    const updatedSettings = seasonSettings
+        ? (0, optimistic_1.updateSeasonSettingsForPauseToggle)(seasonSettings)
+        : undefined;
+    return {
+        instructions: [instruction],
+        signers,
+        ...(updatedSettings && {
+            updatedAccounts: { seasonSettings: updatedSettings },
+        }),
+    };
+}

package/dist/instructions/updateSeasonAdmin.d.ts

@@ -0,0 +1,23 @@
+import { Connection, PublicKey, TransactionInstruction } from "@solana/web3.js";
+import { SeasonSettings } from "../types";
+import { SignerInfo } from "../utils/signerHelpers";
+/**
+ * Update season admin
+ *
+ * Single signer: current admin
+ * Updates the admin field on season settings
+ *
+ * @param connection - Solana connection
+ * @param currentAdmin - Current season admin's public key
+ * @param newAdmin - New admin public key
+ * @param feePayer - Optional separate fee payer for transaction fees
+ * @param seasonSettings - Optional season settings (returns updated version)
+ * @returns Instructions, signers, and optimistically updated settings
+ */
+export declare function updateSeasonAdmin(connection: Connection, currentAdmin: PublicKey, newAdmin: PublicKey, feePayer?: PublicKey, seasonSettings?: SeasonSettings): Promise<{
+    instructions: TransactionInstruction[];
+    signers: SignerInfo[];
+    updatedAccounts?: {
+        seasonSettings: SeasonSettings;
+    };
+}>;

package/dist/instructions/updateSeasonAdmin.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateSeasonAdmin = updateSeasonAdmin;
+const pdas_1 = require("../utils/pdas");
+const programHelpers_1 = require("../utils/programHelpers");
+const signerHelpers_1 = require("../utils/signerHelpers");
+const optimistic_1 = require("../optimistic");
+/**
+ * Update season admin
+ *
+ * Single signer: current admin
+ * Updates the admin field on season settings
+ *
+ * @param connection - Solana connection
+ * @param currentAdmin - Current season admin's public key
+ * @param newAdmin - New admin public key
+ * @param feePayer - Optional separate fee payer for transaction fees
+ * @param seasonSettings - Optional season settings (returns updated version)
+ * @returns Instructions, signers, and optimistically updated settings
+ */
+async function updateSeasonAdmin(connection, currentAdmin, newAdmin, feePayer, seasonSettings) {
+    const program = (0, programHelpers_1.getProgram)(connection);
+    const [seasonSettingsPda] = (0, pdas_1.getSeasonSettingsPda)();
+    const accounts = {
+        seasonSettings: seasonSettingsPda,
+        currentAdmin: currentAdmin,
+    };
+    const instruction = await program.methods
+        .updateSeasonAdmin(newAdmin)
+        .accounts(accounts)
+        .instruction();
+    const signers = (0, signerHelpers_1.buildSigners)([{ publicKey: currentAdmin, role: "currentAdmin" }], feePayer);
+    const updatedSettings = seasonSettings
+        ? (0, optimistic_1.updateSeasonSettingsForAdminUpdate)(seasonSettings, newAdmin)
+        : undefined;
+    return {
+        instructions: [instruction],
+        signers,
+        ...(updatedSettings && {
+            updatedAccounts: { seasonSettings: updatedSettings },
+        }),
+    };
+}

package/dist/instructions/viewCurrentSeason.d.ts

@@ -0,0 +1,12 @@
+import { Connection } from "@solana/web3.js";
+import { CurrentSeasonView } from "../types";
+/**
+ * View current season (read-only)
+ *
+ * No signers required
+ * Returns view struct with current season details
+ *
+ * @param connection - Solana connection
+ * @returns View data with current season info
+ */
+export declare function viewCurrentSeason(connection: Connection): Promise<CurrentSeasonView>;

package/dist/instructions/viewCurrentSeason.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.viewCurrentSeason = viewCurrentSeason;
+const pdas_1 = require("../utils/pdas");
+const programHelpers_1 = require("../utils/programHelpers");
+/**
+ * View current season (read-only)
+ *
+ * No signers required
+ * Returns view struct with current season details
+ *
+ * @param connection - Solana connection
+ * @returns View data with current season info
+ */
+async function viewCurrentSeason(connection) {
+    const program = (0, programHelpers_1.getProgram)(connection);
+    const [seasonSettingsPda] = (0, pdas_1.getSeasonSettingsPda)();
+    // The view requires the Season account as well; derive it from SeasonSettings.currentSeasonNumber.
+    const seasonSettings = await program.account.seasonSettings.fetch(seasonSettingsPda);
+    const [seasonPda] = (0, pdas_1.getSeasonPda)(seasonSettings.currentSeasonNumber);
+    const accounts = {
+        seasonSettings: seasonSettingsPda,
+        season: seasonPda,
+    };
+    const result = await program.methods
+        .viewCurrentSeason()
+        .accounts(accounts)
+        .view();
+    return result;
+}

package/dist/instructions/viewSeasonMembershipStatus.d.ts

@@ -0,0 +1,16 @@
+import { Connection, PublicKey } from "@solana/web3.js";
+import { BN } from "@coral-xyz/anchor";
+import { SeasonMembershipStatusView } from "../types";
+/**
+ * View season membership status (read-only)
+ *
+ * No signers required
+ * Returns view struct with membership details
+ *
+ * @param connection - Solana connection
+ * @param user - User's public key
+ * @param seasonMembershipId - Membership ID
+ * @param seasonNumber - Season number
+ * @returns View data with membership status
+ */
+export declare function viewSeasonMembershipStatus(connection: Connection, user: PublicKey, seasonMembershipId: BN, seasonNumber: BN): Promise<SeasonMembershipStatusView>;

package/dist/instructions/viewSeasonMembershipStatus.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.viewSeasonMembershipStatus = viewSeasonMembershipStatus;
+const pdas_1 = require("../utils/pdas");
+const programHelpers_1 = require("../utils/programHelpers");
+/**
+ * View season membership status (read-only)
+ *
+ * No signers required
+ * Returns view struct with membership details
+ *
+ * @param connection - Solana connection
+ * @param user - User's public key
+ * @param seasonMembershipId - Membership ID
+ * @param seasonNumber - Season number
+ * @returns View data with membership status
+ */
+async function viewSeasonMembershipStatus(connection, user, seasonMembershipId, seasonNumber) {
+    const program = (0, programHelpers_1.getProgram)(connection);
+    const [seasonSettingsPda] = (0, pdas_1.getSeasonSettingsPda)();
+    const [seasonMembershipPda] = (0, pdas_1.getSeasonMembershipPda)(user, seasonMembershipId);
+    const [seasonPda] = (0, pdas_1.getSeasonPda)(seasonNumber);
+    const accounts = {
+        seasonSettings: seasonSettingsPda,
+        seasonMembership: seasonMembershipPda,
+        season: seasonPda,
+    };
+    const result = await program.methods
+        .viewSeasonMembershipStatus()
+        .accounts(accounts)
+        .view();
+    return result;
+}

package/dist/instructions/viewWindowStatus.d.ts

@@ -0,0 +1,15 @@
+import { Connection } from "@solana/web3.js";
+import { BN } from "@coral-xyz/anchor";
+import { WindowStatusView } from "../types";
+/**
+ * View window status (read-only)
+ *
+ * No signers required
+ * Returns view struct with window details
+ *
+ * @param connection - Solana connection
+ * @param seasonNumber - Season number
+ * @param windowNumber - Window number
+ * @returns View data with window status
+ */
+export declare function viewWindowStatus(connection: Connection, seasonNumber: BN, windowNumber: BN): Promise<WindowStatusView>;

package/dist/instructions/viewWindowStatus.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.viewWindowStatus = viewWindowStatus;
+const pdas_1 = require("../utils/pdas");
+const programHelpers_1 = require("../utils/programHelpers");
+/**
+ * View window status (read-only)
+ *
+ * No signers required
+ * Returns view struct with window details
+ *
+ * @param connection - Solana connection
+ * @param seasonNumber - Season number
+ * @param windowNumber - Window number
+ * @returns View data with window status
+ */
+async function viewWindowStatus(connection, seasonNumber, windowNumber) {
+    const program = (0, programHelpers_1.getProgram)(connection);
+    const [rewardWindowPda] = (0, pdas_1.getRewardWindowPda)(seasonNumber, windowNumber);
+    const accounts = {
+        rewardWindow: rewardWindowPda,
+    };
+    const result = await program.methods
+        .viewWindowStatus()
+        .accounts(accounts)
+        .view();
+    return result;
+}

package/dist/instructions/withdrawSeasonDeposit.d.ts

@@ -0,0 +1,38 @@
+import { BN } from "@coral-xyz/anchor";
+import { Connection, PublicKey } from "@solana/web3.js";
+import { SeasonSettings, Season, SeasonMembership } from "../types";
+import { StandardInstructionResult } from "../types/instructionResults";
+type WithdrawSeasonDepositUpdatedAccounts = {
+    seasonSettings?: SeasonSettings;
+    season?: Season;
+    seasonMembership?: SeasonMembership;
+};
+/**
+ * Options for withdrawSeasonDeposit instruction
+ */
+export interface WithdrawSeasonDepositOptions {
+    connection: Connection;
+    user: PublicKey;
+    userTokenAccount: PublicKey;
+    seasonMembershipId: BN;
+    feePayer?: PublicKey;
+    currentAccounts?: {
+        seasonSettings?: SeasonSettings;
+        season?: Season;
+        seasonMembership?: SeasonMembership;
+    };
+}
+/**
+ * Withdraw season deposit
+ *
+ * Single signer: user
+ * Transfers remaining deposit from vault to user
+ * May finalize season on first withdrawal
+ *
+ * @param options - Withdraw season deposit options
+ * @returns Instructions, signers, withdrawal amount, and optimistically updated accounts
+ */
+export declare function withdrawSeasonDeposit(options: WithdrawSeasonDepositOptions): Promise<StandardInstructionResult<Record<string, PublicKey>, WithdrawSeasonDepositUpdatedAccounts, {
+    withdrawalAmount: BN;
+}>>;
+export {};

package/dist/instructions/withdrawSeasonDeposit.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withdrawSeasonDeposit = withdrawSeasonDeposit;
+const spl_token_1 = require("@solana/spl-token");
+const pdaManager_1 = require("../utils/pdaManager");
+const constants_1 = require("../utils/constants");
+const programHelpers_1 = require("../utils/programHelpers");
+const signerHelpers_1 = require("../utils/signerHelpers");
+const optimistic_1 = require("../optimistic");
+/**
+ * Withdraw season deposit
+ *
+ * Single signer: user
+ * Transfers remaining deposit from vault to user
+ * May finalize season on first withdrawal
+ *
+ * @param options - Withdraw season deposit options
+ * @returns Instructions, signers, withdrawal amount, and optimistically updated accounts
+ */
+async function withdrawSeasonDeposit(options) {
+    const program = (0, programHelpers_1.getProgram)(options.connection);
+    const curr = options.currentAccounts || {};
+    if (!curr.seasonMembership) {
+        throw new Error("seasonMembership required for withdrawSeasonDeposit");
+    }
+    const seasonNumber = curr.seasonMembership.seasonNumber;
+    const pdas = pdaManager_1.PDAManager.deriveWithdrawDepositPdas({
+        user: options.user,
+        seasonNumber,
+        seasonMembershipId: options.seasonMembershipId,
+    });
+    const accounts = {
+        seasonSettings: pdas.seasonSettings,
+        season: pdas.season,
+        seasonMembership: pdas.seasonMembership,
+        seasonDepositVault: pdas.seasonDepositVault,
+        seasonEscrowVault: pdas.seasonEscrowVault,
+        mizdMint: constants_1.MIZD_TOKEN_MINT,
+        userTokenAccount: options.userTokenAccount,
+        user: options.user,
+        tokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
+    };
+    const instruction = await program.methods
+        .withdrawSeasonDeposit()
+        .accounts(accounts)
+        .instruction();
+    const signers = (0, signerHelpers_1.buildSigners)([{ publicKey: options.user, role: "user" }], options.feePayer);
+    // OPTIMISTIC UPDATES
+    let withdrawalAmount;
+    let updatedAccounts = undefined;
+    if (curr.seasonMembership && curr.season && curr.seasonSettings) {
+        const result = (0, optimistic_1.calculateWithdrawalAmount)(curr.seasonMembership, curr.season, curr.seasonSettings);
+        withdrawalAmount = result.withdrawalAmount;
+        updatedAccounts = {
+            seasonSettings: result.updatedSettings,
+            season: result.updatedSeason,
+            seasonMembership: result.updatedMembership,
+        };
+    }
+    return {
+        instructions: [instruction],
+        signers,
+        ...(updatedAccounts && { updatedAccounts }),
+        ...(withdrawalAmount && { metadata: { withdrawalAmount } }),
+    };
+}

package/dist/optimistic/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Optimistic account updates
+ *
+ * This module contains all optimistic update logic separated from instruction building.
+ * Each function mirrors the on-chain logic to predict state changes before confirmation.
+ */
+export { getCurrentTimestamp, createEmptyUserStats, initializeUserStats, updateUserStatsForMiztakeCreation, updateMiztakeStatisticsForCreation, initializeUserWindowParticipation, initializeRewardWindow, updateMiztakeForSeasonUse, initializeSeasonMembership, updateSeasonForJoin, updateWindowForConfirmation, updateParticipationForConfirmation, updateMembershipForConfirmation, updateSeasonForConfirmation, updateWindowForFinalization, updateParticipationForClaim, updateMembershipForClaim, initializeReferralPenaltyClaim, calculateWithdrawalAmount, updateSeasonSettingsForPauseToggle, updateSeasonSettingsForAdminUpdate, } from "../utils/accountUpdates";

package/dist/optimistic/index.js

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * Optimistic account updates
+ *
+ * This module contains all optimistic update logic separated from instruction building.
+ * Each function mirrors the on-chain logic to predict state changes before confirmation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateSeasonSettingsForAdminUpdate = exports.updateSeasonSettingsForPauseToggle = exports.calculateWithdrawalAmount = exports.initializeReferralPenaltyClaim = exports.updateMembershipForClaim = exports.updateParticipationForClaim = exports.updateWindowForFinalization = exports.updateSeasonForConfirmation = exports.updateMembershipForConfirmation = exports.updateParticipationForConfirmation = exports.updateWindowForConfirmation = exports.updateSeasonForJoin = exports.initializeSeasonMembership = exports.updateMiztakeForSeasonUse = exports.initializeRewardWindow = exports.initializeUserWindowParticipation = exports.updateMiztakeStatisticsForCreation = exports.updateUserStatsForMiztakeCreation = exports.initializeUserStats = exports.createEmptyUserStats = exports.getCurrentTimestamp = void 0;
+// Re-export all optimistic update functions from accountUpdates
+// This provides a cleaner separation of concerns
+var accountUpdates_1 = require("../utils/accountUpdates");
+Object.defineProperty(exports, "getCurrentTimestamp", { enumerable: true, get: function () { return accountUpdates_1.getCurrentTimestamp; } });
+Object.defineProperty(exports, "createEmptyUserStats", { enumerable: true, get: function () { return accountUpdates_1.createEmptyUserStats; } });
+Object.defineProperty(exports, "initializeUserStats", { enumerable: true, get: function () { return accountUpdates_1.initializeUserStats; } });
+Object.defineProperty(exports, "updateUserStatsForMiztakeCreation", { enumerable: true, get: function () { return accountUpdates_1.updateUserStatsForMiztakeCreation; } });
+Object.defineProperty(exports, "updateMiztakeStatisticsForCreation", { enumerable: true, get: function () { return accountUpdates_1.updateMiztakeStatisticsForCreation; } });
+Object.defineProperty(exports, "initializeUserWindowParticipation", { enumerable: true, get: function () { return accountUpdates_1.initializeUserWindowParticipation; } });
+Object.defineProperty(exports, "initializeRewardWindow", { enumerable: true, get: function () { return accountUpdates_1.initializeRewardWindow; } });
+Object.defineProperty(exports, "updateMiztakeForSeasonUse", { enumerable: true, get: function () { return accountUpdates_1.updateMiztakeForSeasonUse; } });
+Object.defineProperty(exports, "initializeSeasonMembership", { enumerable: true, get: function () { return accountUpdates_1.initializeSeasonMembership; } });
+Object.defineProperty(exports, "updateSeasonForJoin", { enumerable: true, get: function () { return accountUpdates_1.updateSeasonForJoin; } });
+Object.defineProperty(exports, "updateWindowForConfirmation", { enumerable: true, get: function () { return accountUpdates_1.updateWindowForConfirmation; } });
+Object.defineProperty(exports, "updateParticipationForConfirmation", { enumerable: true, get: function () { return accountUpdates_1.updateParticipationForConfirmation; } });
+Object.defineProperty(exports, "updateMembershipForConfirmation", { enumerable: true, get: function () { return accountUpdates_1.updateMembershipForConfirmation; } });
+Object.defineProperty(exports, "updateSeasonForConfirmation", { enumerable: true, get: function () { return accountUpdates_1.updateSeasonForConfirmation; } });
+Object.defineProperty(exports, "updateWindowForFinalization", { enumerable: true, get: function () { return accountUpdates_1.updateWindowForFinalization; } });
+Object.defineProperty(exports, "updateParticipationForClaim", { enumerable: true, get: function () { return accountUpdates_1.updateParticipationForClaim; } });
+Object.defineProperty(exports, "updateMembershipForClaim", { enumerable: true, get: function () { return accountUpdates_1.updateMembershipForClaim; } });
+Object.defineProperty(exports, "initializeReferralPenaltyClaim", { enumerable: true, get: function () { return accountUpdates_1.initializeReferralPenaltyClaim; } });
+Object.defineProperty(exports, "calculateWithdrawalAmount", { enumerable: true, get: function () { return accountUpdates_1.calculateWithdrawalAmount; } });
+Object.defineProperty(exports, "updateSeasonSettingsForPauseToggle", { enumerable: true, get: function () { return accountUpdates_1.updateSeasonSettingsForPauseToggle; } });
+Object.defineProperty(exports, "updateSeasonSettingsForAdminUpdate", { enumerable: true, get: function () { return accountUpdates_1.updateSeasonSettingsForAdminUpdate; } });

package/dist/types/accountTypes.d.ts

@@ -0,0 +1,121 @@
+import { PublicKey } from "@solana/web3.js";
+/**
+ * Typed account interfaces for Anchor instructions
+ * These match the account structures in the Rust program
+ */
+export interface CreateMiztakeAccounts {
+    miztake: PublicKey;
+    userStats: PublicKey;
+    miztakeStatistics: PublicKey;
+    seasonSettings: PublicKey;
+    season: PublicKey;
+    seasonMembership: PublicKey;
+    rewardWindow: PublicKey;
+    userWindowParticipation: PublicKey;
+    user: PublicKey;
+    admin: PublicKey;
+    systemProgram: PublicKey;
+}
+export interface InitializeSeasonSettingsAccounts {
+    seasonSettings: PublicKey;
+    admin: PublicKey;
+    systemProgram: PublicKey;
+}
+export interface InitializeSeasonVaultAccounts {
+    seasonDepositVault: PublicKey;
+    mizdMint: PublicKey;
+    admin: PublicKey;
+    tokenProgram: PublicKey;
+    systemProgram: PublicKey;
+}
+export interface InitializeEscrowVaultAccounts {
+    seasonEscrowVault: PublicKey;
+    mizdMint: PublicKey;
+    admin: PublicKey;
+    tokenProgram: PublicKey;
+    systemProgram: PublicKey;
+}
+export interface InitializeStatisticsAccounts {
+    miztakeStatistics: PublicKey;
+    admin: PublicKey;
+    payer: PublicKey;
+    systemProgram: PublicKey;
+}
+export interface JoinSeasonAccounts {
+    seasonSettings: PublicKey;
+    season: PublicKey;
+    seasonMembership: PublicKey;
+    seasonDepositVault: PublicKey;
+    seasonEscrowVault: PublicKey;
+    mizdMint: PublicKey;
+    userTokenAccount: PublicKey;
+    user: PublicKey;
+    tokenProgram: PublicKey;
+    systemProgram: PublicKey;
+}
+export interface ConfirmedPostOnXAccounts {
+    seasonSettings: PublicKey;
+    seasonMembership: PublicKey;
+    season: PublicKey;
+    rewardWindow: PublicKey;
+    userWindowParticipation: PublicKey;
+    miztake: PublicKey;
+    admin: PublicKey;
+}
+export interface ClaimWindowRewardsAccounts {
+    seasonSettings: PublicKey;
+    season: PublicKey;
+    rewardWindow: PublicKey;
+    userWindowParticipation: PublicKey;
+    seasonMembership: PublicKey;
+    seasonDepositVault: PublicKey;
+    mizdMint: PublicKey;
+    userTokenAccount: PublicKey;
+    referrerTokenAccount: PublicKey;
+    user: PublicKey;
+    tokenProgram: PublicKey;
+}
+export interface ClaimReferralPenaltyForWindowAccounts {
+    seasonSettings: PublicKey;
+    season: PublicKey;
+    seasonMembership: PublicKey;
+    userWindowParticipation: PublicKey;
+    referralPenaltyClaim: PublicKey;
+    seasonDepositVault: PublicKey;
+    mizdMint: PublicKey;
+    recipientTokenAccount: PublicKey;
+    claimant: PublicKey;
+    tokenProgram: PublicKey;
+    systemProgram: PublicKey;
+}
+export interface WithdrawSeasonDepositAccounts {
+    seasonSettings: PublicKey;
+    season: PublicKey;
+    seasonMembership: PublicKey;
+    seasonDepositVault: PublicKey;
+    seasonEscrowVault: PublicKey;
+    mizdMint: PublicKey;
+    userTokenAccount: PublicKey;
+    user: PublicKey;
+    tokenProgram: PublicKey;
+}
+export interface ToggleSeasonPauseAccounts {
+    seasonSettings: PublicKey;
+    admin: PublicKey;
+}
+export interface UpdateSeasonAdminAccounts {
+    seasonSettings: PublicKey;
+    currentAdmin: PublicKey;
+}
+export interface ViewSeasonMembershipStatusAccounts {
+    seasonSettings: PublicKey;
+    season: PublicKey;
+    seasonMembership: PublicKey;
+}
+export interface ViewWindowStatusAccounts {
+    rewardWindow: PublicKey;
+}
+export interface ViewCurrentSeasonAccounts {
+    seasonSettings: PublicKey;
+    season: PublicKey;
+}

package/dist/types/accountTypes.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/instructionResults.d.ts

@@ -0,0 +1,44 @@
+import { TransactionInstruction, PublicKey } from "@solana/web3.js";
+import { SignerInfo } from "../utils/signerHelpers";
+/**
+ * Base instruction result
+ * All instruction functions return this standardized structure
+ */
+export interface InstructionResult {
+    instructions: TransactionInstruction[];
+    signers: SignerInfo[];
+}
+/**
+ * Standard instruction result with PDAs and optional updated accounts
+ * This is the unified return type for all instructions
+ */
+export interface StandardInstructionResult<TPdas extends Record<string, PublicKey> = Record<string, PublicKey>, TAccounts = Record<string, unknown>, TMeta = Record<string, unknown>> extends InstructionResult {
+    /** Program-derived addresses created or used by this instruction */
+    pdas?: TPdas;
+    /** Optimistically updated account states (if current accounts were provided) */
+    updatedAccounts?: TAccounts;
+    /** Additional metadata (e.g., calculated amounts, derived values) */
+    metadata?: TMeta;
+}
+/**
+ * Legacy: Instruction result with PDA addresses
+ * @deprecated Use StandardInstructionResult instead
+ */
+export interface InstructionResultWithPdas extends InstructionResult {
+    pdas: Record<string, PublicKey>;
+}
+/**
+ * Legacy: Instruction result with optimistically updated accounts
+ * @deprecated Use StandardInstructionResult instead
+ */
+export interface InstructionResultWithAccounts<T = Record<string, unknown>> extends InstructionResult {
+    updatedAccounts?: T;
+}
+/**
+ * Legacy: Full instruction result with both PDAs and updated accounts
+ * @deprecated Use StandardInstructionResult instead
+ */
+export interface FullInstructionResult<T = Record<string, unknown>> extends InstructionResult {
+    pdas: Record<string, PublicKey>;
+    updatedAccounts?: T;
+}

package/dist/types/instructionResults.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });