@trixter-osec/core 0.40.4

package/dist/cjs/program/namespace/methods.js

@@ -0,0 +1,309 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MethodsBuilder = exports.MethodsBuilderFactory = void 0;
+exports.isPartialAccounts = isPartialAccounts;
+exports.flattenPartialAccounts = flattenPartialAccounts;
+const accounts_resolver_js_1 = require("../accounts-resolver.js");
+const common_js_1 = require("../common.js");
+class MethodsBuilderFactory {
+    static build(provider, programId, idlIx, ixFn, txFn, rpcFn, simulateFn, viewFn, accountNamespace, idlTypes, customResolver) {
+        return (...args) => new MethodsBuilder(args, ixFn, txFn, rpcFn, simulateFn, viewFn, provider, programId, idlIx, accountNamespace, idlTypes, customResolver);
+    }
+}
+exports.MethodsBuilderFactory = MethodsBuilderFactory;
+function isPartialAccounts(partialAccount) {
+    return (typeof partialAccount === "object" &&
+        partialAccount !== null &&
+        !("_bn" in partialAccount) // Ensures not a pubkey
+    );
+}
+function flattenPartialAccounts(partialAccounts, throwOnNull) {
+    const toReturn = {};
+    for (const accountName in partialAccounts) {
+        const account = partialAccounts[accountName];
+        if (account === null) {
+            if (throwOnNull)
+                throw new Error("Failed to resolve optionals due to IDL type mismatch with input accounts!");
+            continue;
+        }
+        toReturn[accountName] = isPartialAccounts(account)
+            ? flattenPartialAccounts(account, true)
+            : (0, common_js_1.translateAddress)(account);
+    }
+    return toReturn;
+}
+class MethodsBuilder {
+    constructor(_args, _ixFn, _txFn, _rpcFn, _simulateFn, _viewFn, provider, programId, idlIx, accountNamespace, idlTypes, customResolver) {
+        this._args = _args;
+        this._ixFn = _ixFn;
+        this._txFn = _txFn;
+        this._rpcFn = _rpcFn;
+        this._simulateFn = _simulateFn;
+        this._viewFn = _viewFn;
+        this._accounts = {};
+        this._remainingAccounts = [];
+        this._signers = [];
+        this._preInstructions = [];
+        this._postInstructions = [];
+        this._resolveAccounts = true;
+        this._accountsResolver = new accounts_resolver_js_1.AccountsResolver(_args, this._accounts, provider, programId, idlIx, accountNamespace, idlTypes, customResolver);
+    }
+    args(args) {
+        this._args = args;
+        this._accountsResolver.args(args);
+    }
+    /**
+     * Set instruction accounts with account resolution.
+     *
+     * This method only accepts accounts that cannot be resolved.
+     *
+     * See {@link accountsPartial} for overriding the account resolution or
+     * {@link accountsStrict} for strictly specifying all accounts.
+     */
+    accounts(accounts) {
+        // @ts-ignore
+        return this.accountsPartial(accounts);
+    }
+    /**
+     * Set instruction accounts with account resolution.
+     *
+     * There is no functional difference between this method and {@link accounts}
+     * method, the only difference is this method allows specifying all accounts
+     * even if they can be resolved. On the other hand, {@link accounts} method
+     * doesn't accept accounts that can be resolved.
+     */
+    accountsPartial(accounts) {
+        this._resolveAccounts = true;
+        this._accountsResolver.resolveOptionals(accounts);
+        return this;
+    }
+    /**
+     * Set instruction accounts without account resolution.
+     *
+     * All accounts strictly need to be specified when this method is used.
+     *
+     * See {@link accounts} and {@link accountsPartial} methods for automatically
+     * resolving accounts.
+     *
+     * @param accounts instruction accounts
+     */
+    accountsStrict(accounts) {
+        this._resolveAccounts = false;
+        this._accountsResolver.resolveOptionals(accounts);
+        return this;
+    }
+    /**
+     * Set instruction signers.
+     *
+     * Note that calling this method appends the given signers to the existing
+     * signers (instead of overriding them).
+     *
+     * @param signers signers to append
+     */
+    signers(signers) {
+        this._signers = this._signers.concat(signers);
+        return this;
+    }
+    /**
+     * Set remaining accounts.
+     *
+     * Note that calling this method appends the given accounts to the existing
+     * remaining accounts (instead of overriding them).
+     *
+     * @param accounts remaining accounts
+     */
+    remainingAccounts(accounts) {
+        this._remainingAccounts = this._remainingAccounts.concat(accounts);
+        return this;
+    }
+    /**
+     * Set previous instructions.
+     *
+     * See {@link postInstructions} to set the post instructions instead.
+     *
+     * @param ixs instructions
+     * @param prepend whether to prepend to the existing previous instructions
+     */
+    preInstructions(ixs, prepend = false) {
+        if (prepend) {
+            this._preInstructions = ixs.concat(this._preInstructions);
+        }
+        else {
+            this._preInstructions = this._preInstructions.concat(ixs);
+        }
+        return this;
+    }
+    /**
+     * Set post instructions.
+     *
+     * See {@link preInstructions} to set the previous instructions instead.
+     *
+     * @param ixs instructions
+     */
+    postInstructions(ixs) {
+        this._postInstructions = this._postInstructions.concat(ixs);
+        return this;
+    }
+    /**
+     * Get the public keys of the instruction accounts.
+     *
+     * The return type is an object with account names as keys and their public
+     * keys as their values.
+     *
+     * Note that an account key is `undefined` if the account hasn't yet been
+     * specified or resolved.
+     */
+    async pubkeys() {
+        if (this._resolveAccounts) {
+            await this._accountsResolver.resolve();
+        }
+        // @ts-ignore
+        return this._accounts;
+    }
+    /**
+     * Create an instruction based on the current configuration.
+     *
+     * See {@link transaction} to create a transaction instead.
+     *
+     * @returns the transaction instruction
+     */
+    async instruction() {
+        if (this._resolveAccounts) {
+            await this._accountsResolver.resolve();
+        }
+        // @ts-ignore
+        return this._ixFn(...this._args, {
+            accounts: this._accounts,
+            signers: this._signers,
+            remainingAccounts: this._remainingAccounts,
+            preInstructions: this._preInstructions,
+            postInstructions: this._postInstructions,
+        });
+    }
+    /**
+     * Create a transaction based on the current configuration.
+     *
+     * This method doesn't send the created transaction. Use {@link rpc} method
+     * to conveniently send an confirm the configured transaction.
+     *
+     * See {@link instruction} to only create an instruction instead.
+     *
+     * @returns the transaction
+     */
+    async transaction() {
+        if (this._resolveAccounts) {
+            await this._accountsResolver.resolve();
+        }
+        // @ts-ignore
+        return this._txFn(...this._args, {
+            accounts: this._accounts,
+            signers: this._signers,
+            remainingAccounts: this._remainingAccounts,
+            preInstructions: this._preInstructions,
+            postInstructions: this._postInstructions,
+        });
+    }
+    /**
+     * Simulate the configured transaction.
+     *
+     * @param options confirmation options
+     * @returns the simulation response
+     */
+    async simulate(options) {
+        if (this._resolveAccounts) {
+            await this._accountsResolver.resolve();
+        }
+        // @ts-ignore
+        return this._simulateFn(...this._args, {
+            accounts: this._accounts,
+            signers: this._signers,
+            remainingAccounts: this._remainingAccounts,
+            preInstructions: this._preInstructions,
+            postInstructions: this._postInstructions,
+            options,
+        });
+    }
+    /**
+     * View the configured transaction.
+     *
+     * Note that to use this method, the instruction needs to return a value and
+     * all its accounts must be read-only.
+     *
+     * @param options confirmation options
+     * @returns the return value of the instruction
+     */
+    async view(options) {
+        if (this._resolveAccounts) {
+            await this._accountsResolver.resolve();
+        }
+        if (!this._viewFn) {
+            throw new Error([
+                "Method does not support views.",
+                "The instruction should return a value, and its accounts must be read-only",
+            ].join(" "));
+        }
+        // @ts-ignore
+        return this._viewFn(...this._args, {
+            accounts: this._accounts,
+            signers: this._signers,
+            remainingAccounts: this._remainingAccounts,
+            preInstructions: this._preInstructions,
+            postInstructions: this._postInstructions,
+            options,
+        });
+    }
+    /**
+     * Send and confirm the configured transaction.
+     *
+     * See {@link rpcAndKeys} to both send the transaction and get the resolved
+     * account public keys.
+     *
+     * @param options confirmation options
+     * @returns the transaction signature
+     */
+    async rpc(options) {
+        if (this._resolveAccounts) {
+            await this._accountsResolver.resolve();
+        }
+        // @ts-ignore
+        return this._rpcFn(...this._args, {
+            accounts: this._accounts,
+            signers: this._signers,
+            remainingAccounts: this._remainingAccounts,
+            preInstructions: this._preInstructions,
+            postInstructions: this._postInstructions,
+            options,
+        });
+    }
+    /**
+     * Conveniently call both {@link rpc} and {@link pubkeys} methods.
+     *
+     * @param options confirmation options
+     * @returns the transaction signature and account public keys
+     */
+    async rpcAndKeys(options) {
+        return {
+            signature: await this.rpc(options),
+            pubkeys: (await this.pubkeys()),
+        };
+    }
+    /**
+     * Get instruction information necessary to include the instruction inside a
+     * transaction.
+     *
+     * # Example
+     *
+     * ```ts
+     * const { instruction, signers, pubkeys } = await method.prepare();
+     * ```
+     */
+    async prepare() {
+        return {
+            instruction: await this.instruction(),
+            signers: this._signers,
+            pubkeys: await this.pubkeys(),
+        };
+    }
+}
+exports.MethodsBuilder = MethodsBuilder;
+//# sourceMappingURL=methods.js.map

package/dist/cjs/program/namespace/methods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"methods.js","sourceRoot":"","sources":["../../../../src/program/namespace/methods.ts"],"names":[],"mappings":"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"}

package/dist/cjs/program/namespace/rpc.d.ts

@@ -0,0 +1,49 @@
+import { TransactionSignature } from "@solana/web3.js";
+import Provider from "../../provider.js";
+import { Idl } from "../../idl.js";
+import { TransactionFn } from "./transaction.js";
+import { AllInstructions, InstructionContextFn, MakeInstructionsNamespace } from "./types.js";
+export default class RpcFactory {
+    static build<IDL extends Idl, I extends AllInstructions<IDL>>(idlIx: I, txFn: TransactionFn<IDL, I>, idlErrors: Map<number, string>, provider: Provider): RpcFn;
+}
+/**
+ * The namespace provides async methods to send signed transactions for each
+ * *non*-state method on Anchor program.
+ *
+ * Keys are method names, values are RPC functions returning a
+ * [[TransactionInstruction]].
+ *
+ * ## Usage
+ *
+ * ```javascript
+ * rpc.<method>(...args, ctx);
+ * ```
+ *
+ * ## Parameters
+ *
+ * 1. `args` - The positional arguments for the program. The type and number
+ *    of these arguments depend on the program being used.
+ * 2. `ctx`  - [[Context]] non-argument parameters to pass to the method.
+ *    Always the last parameter in the method call.
+ * ```
+ *
+ * ## Example
+ *
+ * To send a transaction invoking the `increment` method above,
+ *
+ * ```javascript
+ * const txSignature = await program.rpc.increment({
+ *   accounts: {
+ *     counter,
+ *     authority,
+ *   },
+ * });
+ * ```
+ */
+export type RpcNamespace<IDL extends Idl = Idl, I extends AllInstructions<IDL> = AllInstructions<IDL>> = MakeInstructionsNamespace<IDL, I, Promise<TransactionSignature>>;
+/**
+ * RpcFn is a single RPC method generated from an IDL, sending a transaction
+ * paid for and signed by the configured provider.
+ */
+export type RpcFn<IDL extends Idl = Idl, I extends AllInstructions<IDL> = AllInstructions<IDL>> = InstructionContextFn<IDL, I, Promise<TransactionSignature>>;
+//# sourceMappingURL=rpc.d.ts.map

package/dist/cjs/program/namespace/rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../../../../src/program/namespace/rpc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,QAAQ,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAEpB,MAAM,CAAC,OAAO,OAAO,UAAU;WACf,KAAK,CAAC,GAAG,SAAS,GAAG,EAAE,CAAC,SAAS,eAAe,CAAC,GAAG,CAAC,EACjE,KAAK,EAAE,CAAC,EACR,IAAI,EAAE,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC,EAC3B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,QAAQ,EAAE,QAAQ,GACjB,KAAK;CAsBT;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,MAAM,YAAY,CACtB,GAAG,SAAS,GAAG,GAAG,GAAG,EACrB,CAAC,SAAS,eAAe,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,GAAG,CAAC,IACnD,yBAAyB,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC;AAErE;;;GAGG;AACH,MAAM,MAAM,KAAK,CACf,GAAG,SAAS,GAAG,GAAG,GAAG,EACrB,CAAC,SAAS,eAAe,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,GAAG,CAAC,IACnD,oBAAoB,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC"}

package/dist/cjs/program/namespace/rpc.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const context_js_1 = require("../context.js");
+const error_js_1 = require("../../error.js");
+class RpcFactory {
+    static build(idlIx, txFn, idlErrors, provider) {
+        const rpc = async (...args) => {
+            var _a;
+            const tx = txFn(...args);
+            const [, ctx] = (0, context_js_1.splitArgsAndCtx)(idlIx, [...args]);
+            if (provider.sendAndConfirm === undefined) {
+                throw new Error("This function requires 'Provider.sendAndConfirm' to be implemented.");
+            }
+            try {
+                return await provider.sendAndConfirm(tx, (_a = ctx.signers) !== null && _a !== void 0 ? _a : [], ctx.options);
+            }
+            catch (err) {
+                throw (0, error_js_1.translateError)(err, idlErrors);
+            }
+        };
+        return rpc;
+    }
+}
+exports.default = RpcFactory;
+//# sourceMappingURL=rpc.js.map

package/dist/cjs/program/namespace/rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../../../../src/program/namespace/rpc.ts"],"names":[],"mappings":";;AAGA,8CAAgD;AAEhD,6CAAgD;AAOhD,MAAqB,UAAU;IACtB,MAAM,CAAC,KAAK,CACjB,KAAQ,EACR,IAA2B,EAC3B,SAA8B,EAC9B,QAAkB;QAElB,MAAM,GAAG,GAAkB,KAAK,EAAE,GAAG,IAAI,EAAE,EAAE;;YAC3C,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;YACzB,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,IAAA,4BAAe,EAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;YAClD,IAAI,QAAQ,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;gBAC1C,MAAM,IAAI,KAAK,CACb,qEAAqE,CACtE,CAAC;YACJ,CAAC;YACD,IAAI,CAAC;gBACH,OAAO,MAAM,QAAQ,CAAC,cAAc,CAClC,EAAE,EACF,MAAA,GAAG,CAAC,OAAO,mCAAI,EAAE,EACjB,GAAG,CAAC,OAAO,CACZ,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,IAAA,yBAAc,EAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YACvC,CAAC;QACH,CAAC,CAAC;QAEF,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AA5BD,6BA4BC"}

package/dist/cjs/program/namespace/simulate.d.ts

@@ -0,0 +1,57 @@
+import { PublicKey } from "@solana/web3.js";
+import Provider from "../../provider.js";
+import { TransactionFn } from "./transaction.js";
+import { Event } from "../event.js";
+import { Coder } from "../../coder/index.js";
+import { Idl } from "../../idl.js";
+import { AllInstructions, InstructionContextFn, MakeInstructionsNamespace } from "./types";
+export default class SimulateFactory {
+    static build<IDL extends Idl, I extends AllInstructions<IDL>>(idlIx: AllInstructions<IDL>, txFn: TransactionFn<IDL>, idlErrors: Map<number, string>, provider: Provider, coder: Coder, programId: PublicKey, idl: IDL): SimulateFn<IDL, I>;
+}
+/**
+ * The namespace provides functions to simulate transactions for each method
+ * of a program, returning a list of deserialized events *and* raw program
+ * logs.
+ *
+ * One can use this to read data calculated from a program on chain, by
+ * emitting an event in the program and reading the emitted event client side
+ * via the `simulate` namespace.
+ *
+ * ## Usage
+ *
+ * ```javascript
+ * program.simulate.<method>(...args, ctx);
+ * ```
+ *
+ * ## Parameters
+ *
+ * 1. `args` - The positional arguments for the program. The type and number
+ *    of these arguments depend on the program being used.
+ * 2. `ctx`  - [[Context]] non-argument parameters to pass to the method.
+ *    Always the last parameter in the method call.
+ *
+ * ## Example
+ *
+ * To simulate the `increment` method above,
+ *
+ * ```javascript
+ * const events = await program.simulate.increment({
+ *   accounts: {
+ *     counter,
+ *   },
+ * });
+ * ```
+ */
+export type SimulateNamespace<IDL extends Idl = Idl, I extends AllInstructions<IDL> = AllInstructions<IDL>> = MakeInstructionsNamespace<IDL, I, Promise<SimulateResponse>>;
+/**
+ * SimulateFn is a single method generated from an IDL. It simulates a method
+ * against a cluster configured by the provider, returning a list of all the
+ * events and raw logs that were emitted during the execution of the
+ * method.
+ */
+export type SimulateFn<IDL extends Idl = Idl, I extends AllInstructions<IDL> = AllInstructions<IDL>> = InstructionContextFn<IDL, I, Promise<SimulateResponse>>;
+export type SimulateResponse = {
+    events: readonly Event[];
+    raw: readonly string[];
+};
+//# sourceMappingURL=simulate.d.ts.map

package/dist/cjs/program/namespace/simulate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulate.d.ts","sourceRoot":"","sources":["../../../../src/program/namespace/simulate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,QAAQ,MAAM,mBAAmB,CAAC;AAGzC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAe,KAAK,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAEnC,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,SAAS,CAAC;AAEjB,MAAM,CAAC,OAAO,OAAO,eAAe;WACpB,KAAK,CAAC,GAAG,SAAS,GAAG,EAAE,CAAC,SAAS,eAAe,CAAC,GAAG,CAAC,EACjE,KAAK,EAAE,eAAe,CAAC,GAAG,CAAC,EAC3B,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,EACxB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,GAAG,GACP,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC;CAuCtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,MAAM,iBAAiB,CAC3B,GAAG,SAAS,GAAG,GAAG,GAAG,EACrB,CAAC,SAAS,eAAe,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,GAAG,CAAC,IACnD,yBAAyB,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,MAAM,UAAU,CACpB,GAAG,SAAS,GAAG,GAAG,GAAG,EACrB,CAAC,SAAS,eAAe,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,GAAG,CAAC,IACnD,oBAAoB,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC;AAG5D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;IACzB,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;CACxB,CAAC"}

package/dist/cjs/program/namespace/simulate.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const context_js_1 = require("../context.js");
+const event_js_1 = require("../event.js");
+const error_js_1 = require("../../error.js");
+class SimulateFactory {
+    static build(idlIx, txFn, idlErrors, provider, coder, programId, idl) {
+        const simulate = async (...args) => {
+            var _a;
+            const tx = txFn(...args);
+            const [, ctx] = (0, context_js_1.splitArgsAndCtx)(idlIx, [...args]);
+            let resp = undefined;
+            if (provider.simulate === undefined) {
+                throw new Error("This function requires 'Provider.simulate' to be implemented.");
+            }
+            try {
+                resp = await provider.simulate(tx, ctx.signers, (_a = ctx.options) === null || _a === void 0 ? void 0 : _a.commitment);
+            }
+            catch (err) {
+                throw (0, error_js_1.translateError)(err, idlErrors);
+            }
+            if (resp === undefined) {
+                throw new Error("Unable to simulate transaction");
+            }
+            const logs = resp.logs;
+            if (!logs) {
+                throw new Error("Simulated logs not found");
+            }
+            const events = [];
+            if (idl.events) {
+                let parser = new event_js_1.EventParser(programId, coder);
+                for (const event of parser.parseLogs(logs)) {
+                    events.push(event);
+                }
+            }
+            return { events, raw: logs };
+        };
+        return simulate;
+    }
+}
+exports.default = SimulateFactory;
+//# sourceMappingURL=simulate.js.map

package/dist/cjs/program/namespace/simulate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulate.js","sourceRoot":"","sources":["../../../../src/program/namespace/simulate.ts"],"names":[],"mappings":";;AAGA,8CAAgD;AAEhD,0CAAiD;AAGjD,6CAAgD;AAOhD,MAAqB,eAAe;IAC3B,MAAM,CAAC,KAAK,CACjB,KAA2B,EAC3B,IAAwB,EACxB,SAA8B,EAC9B,QAAkB,EAClB,KAAY,EACZ,SAAoB,EACpB,GAAQ;QAER,MAAM,QAAQ,GAAoB,KAAK,EAAE,GAAG,IAAI,EAAE,EAAE;;YAClD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;YACzB,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,IAAA,4BAAe,EAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;YAClD,IAAI,IAAI,GAA+C,SAAS,CAAC;YACjE,IAAI,QAAQ,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACpC,MAAM,IAAI,KAAK,CACb,+DAA+D,CAChE,CAAC;YACJ,CAAC;YACD,IAAI,CAAC;gBACH,IAAI,GAAG,MAAM,QAAS,CAAC,QAAQ,CAC7B,EAAE,EACF,GAAG,CAAC,OAAO,EACX,MAAA,GAAG,CAAC,OAAO,0CAAE,UAAU,CACxB,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,IAAA,yBAAc,EAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YACvC,CAAC;YACD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;YACpD,CAAC;YACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;YACvB,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;YAC9C,CAAC;YAED,MAAM,MAAM,GAAY,EAAE,CAAC;YAC3B,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;gBACf,IAAI,MAAM,GAAG,IAAI,sBAAW,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;gBAC/C,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC3C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACrB,CAAC;YACH,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;QAC/B,CAAC,CAAC;QAEF,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAhDD,kCAgDC"}

package/dist/cjs/program/namespace/transaction.d.ts

@@ -0,0 +1,42 @@
+import { Transaction } from "@solana/web3.js";
+import { Idl } from "../../idl.js";
+import { InstructionFn } from "./instruction.js";
+import { AllInstructions, InstructionContextFn, MakeInstructionsNamespace } from "./types.js";
+export default class TransactionFactory {
+    static build<IDL extends Idl, I extends AllInstructions<IDL>>(idlIx: I, ixFn: InstructionFn<IDL, I>): TransactionFn<IDL, I>;
+}
+/**
+ * The namespace provides functions to build [[Transaction]] objects for each
+ * method of a program.
+ *
+ * ## Usage
+ *
+ * ```javascript
+ * program.transaction.<method>(...args, ctx);
+ * ```
+ *
+ * ## Parameters
+ *
+ * 1. `args` - The positional arguments for the program. The type and number
+ *    of these arguments depend on the program being used.
+ * 2. `ctx`  - [[Context]] non-argument parameters to pass to the method.
+ *    Always the last parameter in the method call.
+ *
+ * ## Example
+ *
+ * To create an instruction for the `increment` method above,
+ *
+ * ```javascript
+ * const tx = await program.transaction.increment({
+ *   accounts: {
+ *     counter,
+ *   },
+ * });
+ * ```
+ */
+export type TransactionNamespace<IDL extends Idl = Idl, I extends AllInstructions<IDL> = AllInstructions<IDL>> = MakeInstructionsNamespace<IDL, I, Transaction>;
+/**
+ * Tx is a function to create a `Transaction` for a given program instruction.
+ */
+export type TransactionFn<IDL extends Idl = Idl, I extends AllInstructions<IDL> = AllInstructions<IDL>> = InstructionContextFn<IDL, I, Transaction>;
+//# sourceMappingURL=transaction.d.ts.map

package/dist/cjs/program/namespace/transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../../../src/program/namespace/transaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAEpB,MAAM,CAAC,OAAO,OAAO,kBAAkB;WACvB,KAAK,CAAC,GAAG,SAAS,GAAG,EAAE,CAAC,SAAS,eAAe,CAAC,GAAG,CAAC,EACjE,KAAK,EAAE,CAAC,EACR,IAAI,EAAE,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC,GAC1B,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC;CAgBzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,MAAM,oBAAoB,CAC9B,GAAG,SAAS,GAAG,GAAG,GAAG,EACrB,CAAC,SAAS,eAAe,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,GAAG,CAAC,IACnD,yBAAyB,CAAC,GAAG,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,aAAa,CACvB,GAAG,SAAS,GAAG,GAAG,GAAG,EACrB,CAAC,SAAS,eAAe,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,GAAG,CAAC,IACnD,oBAAoB,CAAC,GAAG,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC"}

package/dist/cjs/program/namespace/transaction.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const web3_js_1 = require("@solana/web3.js");
+const context_js_1 = require("../context.js");
+class TransactionFactory {
+    static build(idlIx, ixFn) {
+        const txFn = (...args) => {
+            var _a, _b, _c;
+            const [, ctx] = (0, context_js_1.splitArgsAndCtx)(idlIx, [...args]);
+            const tx = new web3_js_1.Transaction();
+            if (ctx.preInstructions && ctx.instructions) {
+                throw new Error("instructions is deprecated, use preInstructions");
+            }
+            (_a = ctx.preInstructions) === null || _a === void 0 ? void 0 : _a.forEach((ix) => tx.add(ix));
+            (_b = ctx.instructions) === null || _b === void 0 ? void 0 : _b.forEach((ix) => tx.add(ix));
+            tx.add(ixFn(...args));
+            (_c = ctx.postInstructions) === null || _c === void 0 ? void 0 : _c.forEach((ix) => tx.add(ix));
+            return tx;
+        };
+        return txFn;
+    }
+}
+exports.default = TransactionFactory;
+//# sourceMappingURL=transaction.js.map

package/dist/cjs/program/namespace/transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.js","sourceRoot":"","sources":["../../../../src/program/namespace/transaction.ts"],"names":[],"mappings":";;AAAA,6CAA8C;AAE9C,8CAAgD;AAQhD,MAAqB,kBAAkB;IAC9B,MAAM,CAAC,KAAK,CACjB,KAAQ,EACR,IAA2B;QAE3B,MAAM,IAAI,GAA0B,CAAC,GAAG,IAAI,EAAe,EAAE;;YAC3D,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,IAAA,4BAAe,EAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;YAClD,MAAM,EAAE,GAAG,IAAI,qBAAW,EAAE,CAAC;YAC7B,IAAI,GAAG,CAAC,eAAe,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;gBAC5C,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;YACrE,CAAC;YACD,MAAA,GAAG,CAAC,eAAe,0CAAE,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YACjD,MAAA,GAAG,CAAC,YAAY,0CAAE,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YAC9C,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;YACtB,MAAA,GAAG,CAAC,gBAAgB,0CAAE,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YAClD,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QAEF,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AApBD,qCAoBC"}