@trixter-osec/core 0.40.4

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

@@ -0,0 +1,63 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MethodsBuilderFactory = exports.AccountClient = void 0;
+const instruction_js_1 = __importDefault(require("./instruction.js"));
+const transaction_js_1 = __importDefault(require("./transaction.js"));
+const rpc_js_1 = __importDefault(require("./rpc.js"));
+const account_js_1 = __importDefault(require("./account.js"));
+const simulate_js_1 = __importDefault(require("./simulate.js"));
+const common_js_1 = require("../common.js");
+const methods_1 = require("./methods");
+const views_1 = __importDefault(require("./views"));
+var account_js_2 = require("./account.js");
+Object.defineProperty(exports, "AccountClient", { enumerable: true, get: function () { return account_js_2.AccountClient; } });
+var methods_2 = require("./methods");
+Object.defineProperty(exports, "MethodsBuilderFactory", { enumerable: true, get: function () { return methods_2.MethodsBuilderFactory; } });
+class NamespaceFactory {
+    /**
+     * Generates all namespaces for a given program.
+     */
+    static build(idl, coder, programId, provider, getCustomResolver) {
+        const rpc = {};
+        const instruction = {};
+        const transaction = {};
+        const simulate = {};
+        const methods = {};
+        const view = {};
+        const idlErrors = (0, common_js_1.parseIdlErrors)(idl);
+        const account = idl.accounts
+            ? account_js_1.default.build(idl, coder, programId, provider)
+            : {};
+        idl.instructions.forEach((idlIx) => {
+            const ixItem = instruction_js_1.default.build(idlIx, (ixName, ix) => coder.instruction.encode(ixName, ix), programId);
+            const txItem = transaction_js_1.default.build(idlIx, ixItem);
+            const rpcItem = rpc_js_1.default.build(idlIx, txItem, idlErrors, provider);
+            const simulateItem = simulate_js_1.default.build(idlIx, txItem, idlErrors, provider, coder, programId, idl);
+            const viewItem = views_1.default.build(programId, idlIx, simulateItem, idl);
+            const methodItem = methods_1.MethodsBuilderFactory.build(provider, programId, idlIx, ixItem, txItem, rpcItem, simulateItem, viewItem, account, idl.types || [], getCustomResolver === null || getCustomResolver === void 0 ? void 0 : getCustomResolver(idlIx));
+            const name = idlIx.name;
+            instruction[name] = ixItem;
+            transaction[name] = txItem;
+            rpc[name] = rpcItem;
+            simulate[name] = simulateItem;
+            methods[name] = methodItem;
+            if (viewItem) {
+                view[name] = viewItem;
+            }
+        });
+        return [
+            rpc,
+            instruction,
+            transaction,
+            account,
+            simulate,
+            methods,
+            view,
+        ];
+    }
+}
+exports.default = NamespaceFactory;
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/program/namespace/index.ts"],"names":[],"mappings":";;;;;;AAIA,sEAA4E;AAC5E,sEAA4E;AAC5E,sDAAoD;AACpD,8DAAgE;AAChE,gEAAmE;AACnE,4CAA8C;AAC9C,uCAAoE;AACpE,oDAAqD;AAOrD,2CAA+E;AAApD,2GAAA,aAAa,OAAA;AAGxC,qCAAoE;AAA3D,gHAAA,qBAAqB,OAAA;AAG9B,MAAqB,gBAAgB;IACnC;;OAEG;IACI,MAAM,CAAC,KAAK,CACjB,GAAQ,EACR,KAAY,EACZ,SAAoB,EACpB,QAAkB,EAClB,iBAE2C;QAU3C,MAAM,GAAG,GAAiB,EAAE,CAAC;QAC7B,MAAM,WAAW,GAAyB,EAAE,CAAC;QAC7C,MAAM,WAAW,GAAyB,EAAE,CAAC;QAC7C,MAAM,QAAQ,GAAsB,EAAE,CAAC;QACvC,MAAM,OAAO,GAAqB,EAAE,CAAC;QACrC,MAAM,IAAI,GAAkB,EAAE,CAAC;QAE/B,MAAM,SAAS,GAAG,IAAA,0BAAc,EAAC,GAAG,CAAC,CAAC;QAEtC,MAAM,OAAO,GAA0B,GAAG,CAAC,QAAQ;YACjD,CAAC,CAAC,oBAAc,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC;YACvD,CAAC,CAAE,EAA4B,CAAC;QAElC,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YACjC,MAAM,MAAM,GAAG,wBAAkB,CAAC,KAAK,CACrC,KAAK,EACL,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,EACpD,SAAS,CACV,CAAC;YACF,MAAM,MAAM,GAAG,wBAAkB,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACvD,MAAM,OAAO,GAAG,gBAAU,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;YACrE,MAAM,YAAY,GAAG,qBAAe,CAAC,KAAK,CACxC,KAAK,EACL,MAAM,EACN,SAAS,EACT,QAAQ,EACR,KAAK,EACL,SAAS,EACT,GAAG,CACJ,CAAC;YACF,MAAM,QAAQ,GAAG,eAAW,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,CAAC,CAAC;YACxE,MAAM,UAAU,GAAG,+BAAqB,CAAC,KAAK,CAC5C,QAAQ,EACR,SAAS,EACT,KAAK,EACL,MAAM,EACN,MAAM,EACN,OAAO,EACP,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,GAAG,CAAC,KAAK,IAAI,EAAE,EACf,iBAAiB,aAAjB,iBAAiB,uBAAjB,iBAAiB,CAAG,KAAK,CAAC,CAC3B,CAAC;YACF,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;YAExB,WAAW,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;YAC3B,WAAW,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;YAC3B,GAAG,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;YACpB,QAAQ,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC;YAC3B,IAAI,QAAQ,EAAE,CAAC;gBACb,IAAI,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC;YACxB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO;YACL,GAAwB;YACxB,WAAwC;YACxC,WAAwC;YACxC,OAAO;YACP,QAAkC;YAClC,OAAgC;YAChC,IAA0B;SAC3B,CAAC;IACJ,CAAC;CACF;AAvFD,mCAuFC"}

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

@@ -0,0 +1,57 @@
+import { AccountMeta, PublicKey, TransactionInstruction } from "@solana/web3.js";
+import { Idl, IdlInstructionAccountItem, IdlInstruction } from "../../idl.js";
+import { Accounts } from "../context.js";
+import { AllInstructions, AllInstructionsMap, InstructionContextFn, MakeInstructionsNamespace } from "./types.js";
+export default class InstructionNamespaceFactory {
+    static build<IDL extends Idl, I extends AllInstructions<IDL>>(idlIx: I, encodeFn: InstructionEncodeFn<I>, programId: PublicKey): InstructionFn<IDL, I>;
+    static accountsArray(ctx: Accounts | undefined, accounts: readonly IdlInstructionAccountItem[], programId: PublicKey, ixName?: string): AccountMeta[];
+}
+/**
+ * The namespace provides functions to build [[TransactionInstruction]]
+ * objects for each method of a program.
+ *
+ * ## Usage
+ *
+ * ```javascript
+ * instruction.<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.instruction.increment({
+ *   accounts: {
+ *     counter,
+ *   },
+ * });
+ * ```
+ */
+export type InstructionNamespace<IDL extends Idl = Idl, I extends IdlInstruction = AllInstructions<IDL>> = MakeInstructionsNamespace<IDL, I, TransactionInstruction, {
+    [M in keyof AllInstructionsMap<IDL>]: {
+        accounts: (ctx: Accounts<AllInstructionsMap<IDL>[M]["accounts"][number]>) => unknown;
+    };
+}>;
+/**
+ * Function to create a `TransactionInstruction` generated from an IDL.
+ * Additionally it provides an `accounts` utility method, returning a list
+ * of ordered accounts for the instruction.
+ */
+export type InstructionFn<IDL extends Idl = Idl, I extends AllInstructions<IDL> = AllInstructions<IDL>> = InstructionContextFn<IDL, I, TransactionInstruction> & IxProps<Accounts<I["accounts"][number]>>;
+type IxProps<A extends Accounts> = {
+    /**
+     * Returns an ordered list of accounts associated with the instruction.
+     */
+    accounts: (ctx: A) => AccountMeta[];
+};
+export type InstructionEncodeFn<I extends IdlInstruction = IdlInstruction> = (ixName: I["name"], ix: any) => Buffer;
+export {};
+//# sourceMappingURL=instruction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"instruction.d.ts","sourceRoot":"","sources":["../../../../src/program/namespace/instruction.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,SAAS,EACT,sBAAsB,EACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,GAAG,EACH,yBAAyB,EAEzB,cAAc,EAEf,MAAM,cAAc,CAAC;AAQtB,OAAO,EAAE,QAAQ,EAAmB,MAAM,eAAe,CAAC;AAE1D,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EAEpB,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAEpB,MAAM,CAAC,OAAO,OAAO,2BAA2B;WAChC,KAAK,CAAC,GAAG,SAAS,GAAG,EAAE,CAAC,SAAS,eAAe,CAAC,GAAG,CAAC,EACjE,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAChC,SAAS,EAAE,SAAS,GACnB,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC;WA0CV,aAAa,CACzB,GAAG,EAAE,QAAQ,GAAG,SAAS,EACzB,QAAQ,EAAE,SAAS,yBAAyB,EAAE,EAC9C,SAAS,EAAE,SAAS,EACpB,MAAM,CAAC,EAAE,MAAM,GACd,WAAW,EAAE;CAyCjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,MAAM,oBAAoB,CAC9B,GAAG,SAAS,GAAG,GAAG,GAAG,EACrB,CAAC,SAAS,cAAc,GAAG,eAAe,CAAC,GAAG,CAAC,IAC7C,yBAAyB,CAC3B,GAAG,EACH,CAAC,EACD,sBAAsB,EACtB;KACG,CAAC,IAAI,MAAM,kBAAkB,CAAC,GAAG,CAAC,GAAG;QACpC,QAAQ,EAAE,CACR,GAAG,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,KAC1D,OAAO,CAAC;KACd;CACF,CACF,CAAC;AAEF;;;;GAIG;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,sBAAsB,CAAC,GACtD,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAE3C,KAAK,OAAO,CAAC,CAAC,SAAS,QAAQ,IAAI;IACjC;;OAEG;IACH,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,WAAW,EAAE,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,IAAI,CAC3E,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EACjB,EAAE,EAAE,GAAG,KACJ,MAAM,CAAC"}

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

@@ -0,0 +1,94 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const web3_js_1 = require("@solana/web3.js");
+const idl_js_1 = require("../../idl.js");
+const error_js_1 = require("../../error.js");
+const common_js_1 = require("../common.js");
+const context_js_1 = require("../context.js");
+const features = __importStar(require("../../utils/features.js"));
+class InstructionNamespaceFactory {
+    static build(idlIx, encodeFn, programId) {
+        if (idlIx.name === "_inner") {
+            throw new error_js_1.IdlError("the _inner name is reserved");
+        }
+        const ix = (...args) => {
+            const [ixArgs, ctx] = (0, context_js_1.splitArgsAndCtx)(idlIx, [...args]);
+            (0, common_js_1.validateAccounts)(idlIx.accounts, ctx.accounts);
+            validateInstruction(idlIx, ...args);
+            const keys = ix.accounts(ctx.accounts);
+            if (ctx.remainingAccounts !== undefined) {
+                keys.push(...ctx.remainingAccounts);
+            }
+            if (features.isSet("debug-logs")) {
+                console.log("Outgoing account metas:", keys);
+            }
+            return new web3_js_1.TransactionInstruction({
+                keys,
+                programId,
+                data: encodeFn(idlIx.name, (0, common_js_1.toInstruction)(idlIx, ...ixArgs)),
+            });
+        };
+        // Utility fn for ordering the accounts for this instruction.
+        ix["accounts"] = (accs) => {
+            return InstructionNamespaceFactory.accountsArray(accs, idlIx.accounts, programId, idlIx.name);
+        };
+        return ix;
+    }
+    static accountsArray(ctx, accounts, programId, ixName) {
+        if (!ctx) {
+            return [];
+        }
+        return accounts
+            .map((acc) => {
+            if ((0, idl_js_1.isCompositeAccounts)(acc)) {
+                const rpcAccs = ctx[acc.name];
+                return InstructionNamespaceFactory.accountsArray(rpcAccs, acc.accounts, programId, ixName).flat();
+            }
+            let pubkey;
+            try {
+                pubkey = (0, common_js_1.translateAddress)(ctx[acc.name]);
+            }
+            catch (err) {
+                throw new Error(`Wrong input type for account "${acc.name}" in the instruction accounts object${ixName !== undefined ? ' for instruction "' + ixName + '"' : ""}. Expected PublicKey or string.`);
+            }
+            const isOptional = acc.optional && pubkey.equals(programId);
+            const isWritable = Boolean(acc.writable && !isOptional);
+            const isSigner = Boolean(acc.signer && !isOptional);
+            return {
+                pubkey,
+                isWritable,
+                isSigner,
+            };
+        })
+            .flat();
+    }
+}
+exports.default = InstructionNamespaceFactory;
+// Throws error if any argument required for the `ix` is not given.
+function validateInstruction(ix, ...args) {
+    // todo
+}
+//# sourceMappingURL=instruction.js.map

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

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

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

@@ -0,0 +1,206 @@
+import { AccountMeta, ConfirmOptions, PublicKey, Signer, Transaction, TransactionInstruction, TransactionSignature } from "@solana/web3.js";
+import { Idl, IdlInstructionAccount, IdlInstructionAccountItem, IdlInstructionAccounts, IdlTypeDef } from "../../idl.js";
+import Provider from "../../provider.js";
+import { AccountsGeneric, CustomAccountResolver } from "../accounts-resolver.js";
+import { Address } from "../common.js";
+import { Accounts } from "../context.js";
+import { AccountNamespace } from "./account.js";
+import { InstructionFn } from "./instruction.js";
+import { RpcFn } from "./rpc.js";
+import { SimulateFn, SimulateResponse } from "./simulate.js";
+import { TransactionFn } from "./transaction.js";
+import { AllInstructions, InstructionAccountAddresses, MakeMethodsNamespace, MethodsFn } from "./types.js";
+import { ViewFn } from "./views.js";
+export type MethodsNamespace<IDL extends Idl = Idl, I extends AllInstructions<IDL> = AllInstructions<IDL>> = MakeMethodsNamespace<IDL, I>;
+export declare class MethodsBuilderFactory {
+    static build<IDL extends Idl, I extends AllInstructions<IDL>>(provider: Provider, programId: PublicKey, idlIx: AllInstructions<IDL>, ixFn: InstructionFn<IDL>, txFn: TransactionFn<IDL>, rpcFn: RpcFn<IDL>, simulateFn: SimulateFn<IDL>, viewFn: ViewFn<IDL> | undefined, accountNamespace: AccountNamespace<IDL>, idlTypes: IdlTypeDef[], customResolver?: CustomAccountResolver<IDL>): MethodsFn<IDL, I, MethodsBuilder<IDL, I>>;
+}
+type ResolvedAccounts<A extends IdlInstructionAccountItem = IdlInstructionAccountItem> = PartialUndefined<ResolvedAccountsRecursive<A>>;
+type ResolvedAccountsRecursive<A extends IdlInstructionAccountItem = IdlInstructionAccountItem> = OmitNever<{
+    [N in A["name"]]: ResolvedAccount<A & {
+        name: N;
+    }>;
+}>;
+type ResolvedAccount<A extends IdlInstructionAccountItem = IdlInstructionAccountItem> = A extends IdlInstructionAccounts ? ResolvedAccountsRecursive<A["accounts"][number]> : A extends NonNullable<Pick<IdlInstructionAccount, "address">> ? never : A extends NonNullable<Pick<IdlInstructionAccount, "pda">> ? never : A extends NonNullable<Pick<IdlInstructionAccount, "relations">> ? never : A extends {
+    signer: true;
+} ? Address | undefined : PartialAccount<A>;
+type PartialUndefined<T, P extends keyof T = {
+    [K in keyof T]: undefined extends T[K] ? K : never;
+}[keyof T]> = Partial<Pick<T, P>> & Pick<T, Exclude<keyof T, P>>;
+type OmitNever<T extends Record<string, any>> = {
+    [K in keyof T as T[K] extends never ? never : K]: T[K];
+};
+export type PartialAccounts<A extends IdlInstructionAccountItem = IdlInstructionAccountItem> = Partial<{
+    [N in A["name"]]: PartialAccount<A & {
+        name: N;
+    }>;
+}>;
+type PartialAccount<A extends IdlInstructionAccountItem = IdlInstructionAccountItem> = A extends IdlInstructionAccounts ? PartialAccounts<A["accounts"][number]> : A extends {
+    optional: true;
+} ? Address | null : Address;
+export declare function isPartialAccounts(partialAccount: any): partialAccount is PartialAccounts;
+export declare function flattenPartialAccounts<A extends IdlInstructionAccountItem>(partialAccounts: PartialAccounts<A>, throwOnNull: boolean): AccountsGeneric;
+export declare class MethodsBuilder<IDL extends Idl, I extends AllInstructions<IDL>, A extends I["accounts"][number] = I["accounts"][number]> {
+    private _args;
+    private _ixFn;
+    private _txFn;
+    private _rpcFn;
+    private _simulateFn;
+    private _viewFn;
+    private _accounts;
+    private _remainingAccounts;
+    private _signers;
+    private _preInstructions;
+    private _postInstructions;
+    private _accountsResolver;
+    private _resolveAccounts;
+    constructor(_args: Array<any>, _ixFn: InstructionFn<IDL>, _txFn: TransactionFn<IDL>, _rpcFn: RpcFn<IDL>, _simulateFn: SimulateFn<IDL>, _viewFn: ViewFn<IDL> | undefined, provider: Provider, programId: PublicKey, idlIx: AllInstructions<IDL>, accountNamespace: AccountNamespace<IDL>, idlTypes: IdlTypeDef[], customResolver?: CustomAccountResolver<IDL>);
+    args(args: Array<any>): void;
+    /**
+     * 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: ResolvedAccounts<A>): this;
+    /**
+     * 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: PartialAccounts<A>): 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: Accounts<A>): 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: Array<Signer>): 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: Array<AccountMeta>): 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: Array<TransactionInstruction>, prepend?: boolean): this;
+    /**
+     * Set post instructions.
+     *
+     * See {@link preInstructions} to set the previous instructions instead.
+     *
+     * @param ixs instructions
+     */
+    postInstructions(ixs: Array<TransactionInstruction>): 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.
+     */
+    pubkeys(): Promise<Partial<InstructionAccountAddresses<IDL, I>>>;
+    /**
+     * Create an instruction based on the current configuration.
+     *
+     * See {@link transaction} to create a transaction instead.
+     *
+     * @returns the transaction instruction
+     */
+    instruction(): Promise<TransactionInstruction>;
+    /**
+     * 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
+     */
+    transaction(): Promise<Transaction>;
+    /**
+     * Simulate the configured transaction.
+     *
+     * @param options confirmation options
+     * @returns the simulation response
+     */
+    simulate(options?: ConfirmOptions): Promise<SimulateResponse>;
+    /**
+     * 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
+     */
+    view(options?: ConfirmOptions): Promise<any>;
+    /**
+     * 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
+     */
+    rpc(options?: ConfirmOptions): Promise<TransactionSignature>;
+    /**
+     * Conveniently call both {@link rpc} and {@link pubkeys} methods.
+     *
+     * @param options confirmation options
+     * @returns the transaction signature and account public keys
+     */
+    rpcAndKeys(options?: ConfirmOptions): Promise<{
+        signature: TransactionSignature;
+        pubkeys: InstructionAccountAddresses<IDL, I>;
+    }>;
+    /**
+     * Get instruction information necessary to include the instruction inside a
+     * transaction.
+     *
+     * # Example
+     *
+     * ```ts
+     * const { instruction, signers, pubkeys } = await method.prepare();
+     * ```
+     */
+    prepare(): Promise<{
+        instruction: TransactionInstruction;
+        signers: Signer[];
+        pubkeys: Partial<InstructionAccountAddresses<IDL, I>>;
+    }>;
+}
+export {};
+//# sourceMappingURL=methods.d.ts.map

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

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