@oobe-protocol-labs/synapse-client-sdk 1.0.8 → 1.2.1

package/dist/cjs/programs/index.js

@@ -0,0 +1,112 @@
+"use strict";
+/**
+ * Native Solana instruction encoders.
+ *
+ * Zero-dependency encoders for the core Solana programs: System, SPL Token,
+ * Associated Token Account, Memo, and Compute Budget.
+ *
+ * Each encoder produces a {@link TransactionInstruction} that can be used
+ * with the SDK's transaction building utilities or converted to a
+ * `@solana/kit` instruction via {@link toKitInstruction}.
+ *
+ * @module programs
+ * @since 1.1.0
+ *
+ * @example
+ * ```ts
+ * import {
+ *   SystemProgram, SplToken, AssociatedToken,
+ *   ComputeBudget, Memo,
+ * } from '@oobe-protocol-labs/synapse-client-sdk/programs';
+ * import { Pubkey, Lamports } from '@oobe-protocol-labs/synapse-client-sdk';
+ *
+ * // SOL transfer
+ * const transferIx = SystemProgram.transfer({
+ *   from: Pubkey('Sender...'),
+ *   to: Pubkey('Receiver...'),
+ *   lamports: Lamports(1_000_000_000n),
+ * });
+ *
+ * // SPL Token transfer
+ * const tokenIx = SplToken.transferChecked({
+ *   source: Pubkey('SrcTokenAcct...'),
+ *   mint: Pubkey('Mint...'),
+ *   destination: Pubkey('DstTokenAcct...'),
+ *   owner: Pubkey('Wallet...'),
+ *   amount: 1_000_000n,
+ *   decimals: 6,
+ * });
+ *
+ * // Priority fee
+ * const feeIx = ComputeBudget.setComputeUnitPrice({ microLamports: 50_000n });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMPUTE_BUDGET_PROGRAM = exports.ComputeBudget = exports.MEMO_PROGRAM_V1 = exports.MEMO_PROGRAM_V2 = exports.Memo = exports.ASSOCIATED_TOKEN_PROGRAM = exports.AssociatedToken = exports.TOKEN_2022_PROGRAM = exports.TOKEN_PROGRAM = exports.SplToken = exports.SYSTEM_PROGRAM = exports.SystemProgram = exports.readonly = exports.readonlySigner = exports.writable = exports.writableSigner = exports.decodeBase58 = exports.InstructionWriter = void 0;
+exports.toKitInstruction = toKitInstruction;
+// ── Types & Writer ─────────────────────────────────────────────
+var types_1 = require("./types");
+Object.defineProperty(exports, "InstructionWriter", { enumerable: true, get: function () { return types_1.InstructionWriter; } });
+Object.defineProperty(exports, "decodeBase58", { enumerable: true, get: function () { return types_1.decodeBase58; } });
+Object.defineProperty(exports, "writableSigner", { enumerable: true, get: function () { return types_1.writableSigner; } });
+Object.defineProperty(exports, "writable", { enumerable: true, get: function () { return types_1.writable; } });
+Object.defineProperty(exports, "readonlySigner", { enumerable: true, get: function () { return types_1.readonlySigner; } });
+Object.defineProperty(exports, "readonly", { enumerable: true, get: function () { return types_1.readonly; } });
+// ── System Program ─────────────────────────────────────────────
+var system_1 = require("./system");
+Object.defineProperty(exports, "SystemProgram", { enumerable: true, get: function () { return system_1.SystemProgram; } });
+Object.defineProperty(exports, "SYSTEM_PROGRAM", { enumerable: true, get: function () { return system_1.SYSTEM_PROGRAM; } });
+// ── SPL Token ──────────────────────────────────────────────────
+var spl_token_1 = require("./spl-token");
+Object.defineProperty(exports, "SplToken", { enumerable: true, get: function () { return spl_token_1.SplToken; } });
+Object.defineProperty(exports, "TOKEN_PROGRAM", { enumerable: true, get: function () { return spl_token_1.TOKEN_PROGRAM; } });
+Object.defineProperty(exports, "TOKEN_2022_PROGRAM", { enumerable: true, get: function () { return spl_token_1.TOKEN_2022_PROGRAM; } });
+// ── Associated Token Account ───────────────────────────────────
+var associated_token_1 = require("./associated-token");
+Object.defineProperty(exports, "AssociatedToken", { enumerable: true, get: function () { return associated_token_1.AssociatedToken; } });
+Object.defineProperty(exports, "ASSOCIATED_TOKEN_PROGRAM", { enumerable: true, get: function () { return associated_token_1.ASSOCIATED_TOKEN_PROGRAM; } });
+// ── Memo ───────────────────────────────────────────────────────
+var memo_1 = require("./memo");
+Object.defineProperty(exports, "Memo", { enumerable: true, get: function () { return memo_1.Memo; } });
+Object.defineProperty(exports, "MEMO_PROGRAM_V2", { enumerable: true, get: function () { return memo_1.MEMO_PROGRAM_V2; } });
+Object.defineProperty(exports, "MEMO_PROGRAM_V1", { enumerable: true, get: function () { return memo_1.MEMO_PROGRAM_V1; } });
+// ── Compute Budget ─────────────────────────────────────────────
+var compute_budget_1 = require("./compute-budget");
+Object.defineProperty(exports, "ComputeBudget", { enumerable: true, get: function () { return compute_budget_1.ComputeBudget; } });
+Object.defineProperty(exports, "COMPUTE_BUDGET_PROGRAM", { enumerable: true, get: function () { return compute_budget_1.COMPUTE_BUDGET_PROGRAM; } });
+const kit_1 = require("@solana/kit");
+/**
+ * Convert a Synapse {@link TransactionInstruction} to a `@solana/kit`
+ * `IInstruction` for use with Kit's transaction builder.
+ *
+ * @param ix - Synapse instruction to convert.
+ * @returns Kit-compatible instruction.
+ * @since 1.1.0
+ *
+ * @example
+ * ```ts
+ * import { SystemProgram, toKitInstruction } from '@oobe-protocol-labs/synapse-client-sdk/programs';
+ * import { pipe, createTransactionMessage, appendTransactionMessageInstruction } from '@oobe-protocol-labs/synapse-client-sdk/kit';
+ *
+ * const ix = SystemProgram.transfer({ from, to, lamports: 1_000_000_000n });
+ * const kitIx = toKitInstruction(ix);
+ *
+ * const msg = pipe(
+ *   createTransactionMessage({ version: 0 }),
+ *   m => appendTransactionMessageInstruction(kitIx, m),
+ * );
+ * ```
+ */
+function toKitInstruction(ix) {
+    return {
+        programAddress: (0, kit_1.address)(ix.programId),
+        accounts: ix.keys.map((k) => ({
+            address: (0, kit_1.address)(k.pubkey),
+            role: k.isSigner
+                ? (k.isWritable ? kit_1.AccountRole.WRITABLE_SIGNER : kit_1.AccountRole.READONLY_SIGNER)
+                : (k.isWritable ? kit_1.AccountRole.WRITABLE : kit_1.AccountRole.READONLY),
+        })),
+        data: ix.data,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/cjs/programs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/programs/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;;;AAyGH,4CAWC;AAlHD,kEAAkE;AAClE,iCASiB;AANf,0GAAA,iBAAiB,OAAA;AACjB,qGAAA,YAAY,OAAA;AACZ,uGAAA,cAAc,OAAA;AACd,iGAAA,QAAQ,OAAA;AACR,uGAAA,cAAc,OAAA;AACd,iGAAA,QAAQ,OAAA;AAGV,kEAAkE;AAClE,mCAYkB;AAXhB,uGAAA,aAAa,OAAA;AACb,wGAAA,cAAc,OAAA;AAYhB,kEAAkE;AAClE,yCAkBqB;AAjBnB,qGAAA,QAAQ,OAAA;AACR,0GAAA,aAAa,OAAA;AACb,+GAAA,kBAAkB,OAAA;AAiBpB,kEAAkE;AAClE,uDAK4B;AAJ1B,mHAAA,eAAe,OAAA;AACf,4HAAA,wBAAwB,OAAA;AAK1B,kEAAkE;AAClE,+BAKgB;AAJd,4FAAA,IAAI,OAAA;AACJ,uGAAA,eAAe,OAAA;AACf,uGAAA,eAAe,OAAA;AAIjB,kEAAkE;AAClE,mDAO0B;AANxB,+GAAA,aAAa,OAAA;AACb,wHAAA,sBAAsB,OAAA;AAYxB,qCAAiE;AAEjE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,SAAgB,gBAAgB,CAAC,EAA0B;IACzD,OAAO;QACL,cAAc,EAAE,IAAA,aAAU,EAAC,EAAE,CAAC,SAA8B,CAAY;QACxE,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAiB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5C,OAAO,EAAE,IAAA,aAAU,EAAC,CAAC,CAAC,MAA2B,CAAY;YAC7D,IAAI,EAAE,CAAC,CAAC,QAAQ;gBACd,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,iBAAW,CAAC,eAAe,CAAC,CAAC,CAAC,iBAAW,CAAC,eAAe,CAAC;gBAC5E,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,iBAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,iBAAW,CAAC,QAAQ,CAAC;SACjE,CAAC,CAAC;QACH,IAAI,EAAE,EAAE,CAAC,IAAI;KACd,CAAC;AACJ,CAAC"}

package/dist/cjs/programs/memo.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Memo Program instruction encoder.
+ *
+ * Encodes a memo instruction that attaches an arbitrary UTF-8 string
+ * to a transaction. Supports both Memo v1 and v2.
+ *
+ * Program ID (v2): `MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr`
+ * Program ID (v1): `Memo1UhkJBfCR6MNcUpSSKvyfcY7YFW5p5JHblJRK9R`
+ *
+ * @module programs/memo
+ * @since 1.1.0
+ *
+ * @example
+ * ```ts
+ * import { Memo } from '@oobe-protocol-labs/synapse-client-sdk/programs';
+ * import { Pubkey } from '@oobe-protocol-labs/synapse-client-sdk';
+ *
+ * const ix = Memo.addMemo({
+ *   message: 'Hello from Synapse SDK!',
+ *   signer: Pubkey('MyWallet...'),
+ * });
+ * ```
+ */
+import { Pubkey } from '../core/types';
+import type { TransactionInstruction } from './types';
+/**
+ * SPL Memo Program v2 address.
+ * @since 1.1.0
+ */
+export declare const MEMO_PROGRAM_V2: never;
+/**
+ * SPL Memo Program v1 address (deprecated, but still supported on-chain).
+ * @since 1.1.0
+ */
+export declare const MEMO_PROGRAM_V1: never;
+/**
+ * Params for {@link Memo.addMemo}.
+ * @since 1.1.0
+ */
+export interface AddMemoParams {
+    /** UTF-8 memo string (max ~566 bytes for a single instruction). */
+    message: string;
+    /** Signer pubkey (optional — if provided, the memo is signed). */
+    signer?: Pubkey;
+    /** Additional signers. */
+    additionalSigners?: Pubkey[];
+    /** Use Memo v1 program instead of v2 (default: false). */
+    useV1?: boolean;
+}
+/**
+ * SPL Memo Program instruction encoders.
+ *
+ * @since 1.1.0
+ */
+export declare const Memo: {
+    /** Memo v2 program ID. */
+    readonly programId: never;
+    /** Memo v1 program ID. */
+    readonly v1ProgramId: never;
+    /**
+     * Add a memo to a transaction.
+     *
+     * The memo content is the raw instruction data (no discriminator).
+     * If a signer is provided, the memo is validated on-chain.
+     *
+     * @since 1.1.0
+     */
+    readonly addMemo: (p: AddMemoParams) => TransactionInstruction;
+};
+//# sourceMappingURL=memo.d.ts.map

package/dist/cjs/programs/memo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memo.d.ts","sourceRoot":"","sources":["../../../src/programs/memo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAKtD;;;GAGG;AACH,eAAO,MAAM,eAAe,OAAwD,CAAC;AAErF;;;GAGG;AACH,eAAO,MAAM,eAAe,OAAwD,CAAC;AAIrF;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,0DAA0D;IAC1D,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAID;;;;GAIG;AACH,eAAO,MAAM,IAAI;IACf,0BAA0B;;IAE1B,0BAA0B;;IAG1B;;;;;;;OAOG;0BACQ,aAAa,KAAG,sBAAsB;CAgBzC,CAAC"}

package/dist/cjs/programs/memo.js

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * Memo Program instruction encoder.
+ *
+ * Encodes a memo instruction that attaches an arbitrary UTF-8 string
+ * to a transaction. Supports both Memo v1 and v2.
+ *
+ * Program ID (v2): `MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr`
+ * Program ID (v1): `Memo1UhkJBfCR6MNcUpSSKvyfcY7YFW5p5JHblJRK9R`
+ *
+ * @module programs/memo
+ * @since 1.1.0
+ *
+ * @example
+ * ```ts
+ * import { Memo } from '@oobe-protocol-labs/synapse-client-sdk/programs';
+ * import { Pubkey } from '@oobe-protocol-labs/synapse-client-sdk';
+ *
+ * const ix = Memo.addMemo({
+ *   message: 'Hello from Synapse SDK!',
+ *   signer: Pubkey('MyWallet...'),
+ * });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Memo = exports.MEMO_PROGRAM_V1 = exports.MEMO_PROGRAM_V2 = void 0;
+const types_1 = require("../core/types");
+const types_2 = require("./types");
+// ── Program IDs ────────────────────────────────────────────────
+/**
+ * SPL Memo Program v2 address.
+ * @since 1.1.0
+ */
+exports.MEMO_PROGRAM_V2 = (0, types_1.Pubkey)('MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr');
+/**
+ * SPL Memo Program v1 address (deprecated, but still supported on-chain).
+ * @since 1.1.0
+ */
+exports.MEMO_PROGRAM_V1 = (0, types_1.Pubkey)('Memo1UhkJBfCR6MNcUpSSKvyfcY7YFW5p5JHblJRK9R');
+// ── Memo namespace ─────────────────────────────────────────────
+/**
+ * SPL Memo Program instruction encoders.
+ *
+ * @since 1.1.0
+ */
+exports.Memo = {
+    /** Memo v2 program ID. */
+    programId: exports.MEMO_PROGRAM_V2,
+    /** Memo v1 program ID. */
+    v1ProgramId: exports.MEMO_PROGRAM_V1,
+    /**
+     * Add a memo to a transaction.
+     *
+     * The memo content is the raw instruction data (no discriminator).
+     * If a signer is provided, the memo is validated on-chain.
+     *
+     * @since 1.1.0
+     */
+    addMemo(p) {
+        const pid = p.useV1 ? exports.MEMO_PROGRAM_V1 : exports.MEMO_PROGRAM_V2;
+        const data = new TextEncoder().encode(p.message);
+        const keys = [];
+        if (p.signer) {
+            keys.push((0, types_2.readonlySigner)(p.signer));
+        }
+        if (p.additionalSigners) {
+            for (const s of p.additionalSigners) {
+                keys.push((0, types_2.readonlySigner)(s));
+            }
+        }
+        return { programId: pid, keys, data };
+    },
+};
+//# sourceMappingURL=memo.js.map

package/dist/cjs/programs/memo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memo.js","sourceRoot":"","sources":["../../../src/programs/memo.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;;AAEH,yCAAuC;AAEvC,mCAAyC;AAEzC,kEAAkE;AAElE;;;GAGG;AACU,QAAA,eAAe,GAAG,IAAA,cAAM,EAAC,6CAA6C,CAAC,CAAC;AAErF;;;GAGG;AACU,QAAA,eAAe,GAAG,IAAA,cAAM,EAAC,6CAA6C,CAAC,CAAC;AAmBrF,kEAAkE;AAElE;;;;GAIG;AACU,QAAA,IAAI,GAAG;IAClB,0BAA0B;IAC1B,SAAS,EAAE,uBAAe;IAC1B,0BAA0B;IAC1B,WAAW,EAAE,uBAAe;IAE5B;;;;;;;OAOG;IACH,OAAO,CAAC,CAAgB;QACtB,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,uBAAe,CAAC,CAAC,CAAC,uBAAe,CAAC;QACxD,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,EAAE,CAAC;QAEhB,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;YACb,IAAI,CAAC,IAAI,CAAC,IAAA,sBAAc,EAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;QACtC,CAAC;QACD,IAAI,CAAC,CAAC,iBAAiB,EAAE,CAAC;YACxB,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,iBAAiB,EAAE,CAAC;gBACpC,IAAI,CAAC,IAAI,CAAC,IAAA,sBAAc,EAAC,CAAC,CAAC,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QAED,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACxC,CAAC;CACO,CAAC"}

package/dist/cjs/programs/spl-token.d.ts

@@ -0,0 +1,373 @@
+/**
+ * SPL Token Program instruction encoders.
+ *
+ * Encodes the most common SPL Token v1 instructions. Also works for
+ * Token-2022 when using the basic instruction set (the program ID is
+ * the only difference — pass `TOKEN_2022_PROGRAM` as `programId`).
+ *
+ * Program ID (v1): `TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA`
+ * Program ID (2022): `TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb`
+ *
+ * @module programs/spl-token
+ * @since 1.1.0
+ *
+ * @example
+ * ```ts
+ * import { SplToken } from '@oobe-protocol-labs/synapse-client-sdk/programs';
+ * import { Pubkey } from '@oobe-protocol-labs/synapse-client-sdk';
+ *
+ * const ix = SplToken.transferChecked({
+ *   source: Pubkey('SourceTokenAccount...'),
+ *   mint: Pubkey('TokenMint...'),
+ *   destination: Pubkey('DestTokenAccount...'),
+ *   owner: Pubkey('WalletOwner...'),
+ *   amount: 1_000_000n,
+ *   decimals: 6,
+ * });
+ * ```
+ */
+import { Pubkey } from '../core/types';
+import type { TransactionInstruction } from './types';
+/**
+ * SPL Token Program v1 address.
+ * @since 1.1.0
+ */
+export declare const TOKEN_PROGRAM: never;
+/**
+ * SPL Token-2022 (Token Extensions) Program address.
+ * @since 1.1.0
+ */
+export declare const TOKEN_2022_PROGRAM: never;
+/**
+ * Params for {@link SplToken.initializeMint}.
+ * @since 1.1.0
+ */
+export interface InitializeMintParams {
+    /** Mint account (must be pre-allocated). */
+    mint: Pubkey;
+    /** Number of decimals. */
+    decimals: number;
+    /** Mint authority. */
+    mintAuthority: Pubkey;
+    /** Optional freeze authority. */
+    freezeAuthority?: Pubkey | null;
+    /** Token program ID (default: Token v1). */
+    programId?: Pubkey;
+}
+/**
+ * Params for {@link SplToken.initializeAccount}.
+ * @since 1.1.0
+ */
+export interface InitializeAccountParams {
+    /** Token account (must be pre-allocated). */
+    account: Pubkey;
+    /** Token mint. */
+    mint: Pubkey;
+    /** Account owner. */
+    owner: Pubkey;
+    /** Token program ID (default: Token v1). */
+    programId?: Pubkey;
+}
+/**
+ * Params for {@link SplToken.transfer}.
+ * @since 1.1.0
+ */
+export interface TransferParams {
+    /** Source token account. */
+    source: Pubkey;
+    /** Destination token account. */
+    destination: Pubkey;
+    /** Owner of the source account (signer). */
+    owner: Pubkey;
+    /** Amount of tokens (raw, no decimals). */
+    amount: bigint;
+    /** Additional signer pubkeys for multisig owner. */
+    multiSigners?: Pubkey[];
+    /** Token program ID (default: Token v1). */
+    programId?: Pubkey;
+}
+/**
+ * Params for {@link SplToken.transferChecked}.
+ * @since 1.1.0
+ */
+export interface TransferCheckedParams {
+    /** Source token account. */
+    source: Pubkey;
+    /** Token mint (used for decimal verification). */
+    mint: Pubkey;
+    /** Destination token account. */
+    destination: Pubkey;
+    /** Owner of the source account (signer). */
+    owner: Pubkey;
+    /** Amount of tokens (raw, no decimals). */
+    amount: bigint;
+    /** Expected number of decimals for the mint. */
+    decimals: number;
+    /** Additional signer pubkeys for multisig owner. */
+    multiSigners?: Pubkey[];
+    /** Token program ID (default: Token v1). */
+    programId?: Pubkey;
+}
+/**
+ * Params for {@link SplToken.approve}.
+ * @since 1.1.0
+ */
+export interface ApproveParams {
+    /** Token account. */
+    account: Pubkey;
+    /** Delegate to approve. */
+    delegate: Pubkey;
+    /** Owner of the token account (signer). */
+    owner: Pubkey;
+    /** Amount to approve. */
+    amount: bigint;
+    /** Additional signer pubkeys for multisig owner. */
+    multiSigners?: Pubkey[];
+    /** Token program ID (default: Token v1). */
+    programId?: Pubkey;
+}
+/**
+ * Params for {@link SplToken.approveChecked}.
+ * @since 1.1.0
+ */
+export interface ApproveCheckedParams {
+    /** Token account. */
+    account: Pubkey;
+    /** Token mint. */
+    mint: Pubkey;
+    /** Delegate to approve. */
+    delegate: Pubkey;
+    /** Owner of the token account (signer). */
+    owner: Pubkey;
+    /** Amount to approve. */
+    amount: bigint;
+    /** Expected number of decimals. */
+    decimals: number;
+    /** Additional signer pubkeys for multisig owner. */
+    multiSigners?: Pubkey[];
+    /** Token program ID (default: Token v1). */
+    programId?: Pubkey;
+}
+/**
+ * Params for {@link SplToken.revoke}.
+ * @since 1.1.0
+ */
+export interface RevokeParams {
+    /** Token account. */
+    account: Pubkey;
+    /** Owner (signer). */
+    owner: Pubkey;
+    /** Additional signer pubkeys for multisig owner. */
+    multiSigners?: Pubkey[];
+    /** Token program ID (default: Token v1). */
+    programId?: Pubkey;
+}
+/**
+ * Params for {@link SplToken.mintTo}.
+ * @since 1.1.0
+ */
+export interface MintToParams {
+    /** Token mint. */
+    mint: Pubkey;
+    /** Destination token account. */
+    destination: Pubkey;
+    /** Mint authority (signer). */
+    authority: Pubkey;
+    /** Amount to mint. */
+    amount: bigint;
+    /** Additional signer pubkeys for multisig authority. */
+    multiSigners?: Pubkey[];
+    /** Token program ID (default: Token v1). */
+    programId?: Pubkey;
+}
+/**
+ * Params for {@link SplToken.mintToChecked}.
+ * @since 1.1.0
+ */
+export interface MintToCheckedParams {
+    /** Token mint. */
+    mint: Pubkey;
+    /** Destination token account. */
+    destination: Pubkey;
+    /** Mint authority (signer). */
+    authority: Pubkey;
+    /** Amount to mint. */
+    amount: bigint;
+    /** Expected number of decimals. */
+    decimals: number;
+    /** Additional signer pubkeys for multisig authority. */
+    multiSigners?: Pubkey[];
+    /** Token program ID (default: Token v1). */
+    programId?: Pubkey;
+}
+/**
+ * Params for {@link SplToken.burn}.
+ * @since 1.1.0
+ */
+export interface BurnParams {
+    /** Token account to burn from. */
+    account: Pubkey;
+    /** Token mint. */
+    mint: Pubkey;
+    /** Owner of the token account (signer). */
+    owner: Pubkey;
+    /** Amount to burn. */
+    amount: bigint;
+    /** Additional signer pubkeys for multisig owner. */
+    multiSigners?: Pubkey[];
+    /** Token program ID (default: Token v1). */
+    programId?: Pubkey;
+}
+/**
+ * Params for {@link SplToken.burnChecked}.
+ * @since 1.1.0
+ */
+export interface BurnCheckedParams {
+    /** Token account to burn from. */
+    account: Pubkey;
+    /** Token mint. */
+    mint: Pubkey;
+    /** Owner of the token account (signer). */
+    owner: Pubkey;
+    /** Amount to burn. */
+    amount: bigint;
+    /** Expected number of decimals. */
+    decimals: number;
+    /** Additional signer pubkeys for multisig owner. */
+    multiSigners?: Pubkey[];
+    /** Token program ID (default: Token v1). */
+    programId?: Pubkey;
+}
+/**
+ * Params for {@link SplToken.closeAccount}.
+ * @since 1.1.0
+ */
+export interface CloseAccountParams {
+    /** Token account to close. */
+    account: Pubkey;
+    /** Destination for remaining SOL rent. */
+    destination: Pubkey;
+    /** Owner of the token account (signer). */
+    owner: Pubkey;
+    /** Additional signer pubkeys for multisig owner. */
+    multiSigners?: Pubkey[];
+    /** Token program ID (default: Token v1). */
+    programId?: Pubkey;
+}
+/**
+ * Params for {@link SplToken.freezeAccount} / {@link SplToken.thawAccount}.
+ * @since 1.1.0
+ */
+export interface FreezeThawParams {
+    /** Token account to freeze/thaw. */
+    account: Pubkey;
+    /** Token mint. */
+    mint: Pubkey;
+    /** Freeze authority (signer). */
+    authority: Pubkey;
+    /** Additional signer pubkeys for multisig authority. */
+    multiSigners?: Pubkey[];
+    /** Token program ID (default: Token v1). */
+    programId?: Pubkey;
+}
+/**
+ * Params for {@link SplToken.syncNative}.
+ * @since 1.1.0
+ */
+export interface SyncNativeParams {
+    /** Native SOL token account (wrapped SOL). */
+    account: Pubkey;
+    /** Token program ID (default: Token v1). */
+    programId?: Pubkey;
+}
+/**
+ * SPL Token Program instruction encoders.
+ *
+ * Static methods produce {@link TransactionInstruction} objects for the
+ * SPL Token Program (v1) and Token-2022.
+ *
+ * @since 1.1.0
+ */
+export declare const SplToken: {
+    /** SPL Token v1 program ID. */
+    readonly programId: never;
+    /** Token-2022 program ID. */
+    readonly token2022ProgramId: never;
+    /**
+     * Initialize a new token mint.
+     * @since 1.1.0
+     */
+    readonly initializeMint: (p: InitializeMintParams) => TransactionInstruction;
+    /**
+     * Initialize a token account for a given mint and owner.
+     * @since 1.1.0
+     */
+    readonly initializeAccount: (p: InitializeAccountParams) => TransactionInstruction;
+    /**
+     * Transfer tokens (unchecked — no decimal verification).
+     * Prefer {@link transferChecked} for safety.
+     * @since 1.1.0
+     */
+    readonly transfer: (p: TransferParams) => TransactionInstruction;
+    /**
+     * Transfer tokens with decimal verification (recommended).
+     * @since 1.1.0
+     */
+    readonly transferChecked: (p: TransferCheckedParams) => TransactionInstruction;
+    /**
+     * Approve a delegate to spend tokens from the account.
+     * @since 1.1.0
+     */
+    readonly approve: (p: ApproveParams) => TransactionInstruction;
+    /**
+     * Approve a delegate with decimal verification.
+     * @since 1.1.0
+     */
+    readonly approveChecked: (p: ApproveCheckedParams) => TransactionInstruction;
+    /**
+     * Revoke a previously approved delegate.
+     * @since 1.1.0
+     */
+    readonly revoke: (p: RevokeParams) => TransactionInstruction;
+    /**
+     * Mint new tokens to a destination account.
+     * @since 1.1.0
+     */
+    readonly mintTo: (p: MintToParams) => TransactionInstruction;
+    /**
+     * Mint new tokens with decimal verification.
+     * @since 1.1.0
+     */
+    readonly mintToChecked: (p: MintToCheckedParams) => TransactionInstruction;
+    /**
+     * Burn tokens from an account.
+     * @since 1.1.0
+     */
+    readonly burn: (p: BurnParams) => TransactionInstruction;
+    /**
+     * Burn tokens with decimal verification.
+     * @since 1.1.0
+     */
+    readonly burnChecked: (p: BurnCheckedParams) => TransactionInstruction;
+    /**
+     * Close a token account, reclaiming SOL rent.
+     * @since 1.1.0
+     */
+    readonly closeAccount: (p: CloseAccountParams) => TransactionInstruction;
+    /**
+     * Freeze a token account (prevents transfers).
+     * @since 1.1.0
+     */
+    readonly freezeAccount: (p: FreezeThawParams) => TransactionInstruction;
+    /**
+     * Thaw a previously frozen token account.
+     * @since 1.1.0
+     */
+    readonly thawAccount: (p: FreezeThawParams) => TransactionInstruction;
+    /**
+     * Sync the lamport balance of a native SOL token account.
+     * @since 1.1.0
+     */
+    readonly syncNative: (p: SyncNativeParams) => TransactionInstruction;
+};
+//# sourceMappingURL=spl-token.d.ts.map

package/dist/cjs/programs/spl-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spl-token.d.ts","sourceRoot":"","sources":["../../../src/programs/spl-token.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAKtD;;;GAGG;AACH,eAAO,MAAM,aAAa,OAAwD,CAAC;AAEnF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,OAAwD,CAAC;AAgCxF;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAiBD;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ;IACnB,+BAA+B;;IAE/B,6BAA6B;;IAG7B;;;OAGG;iCACe,oBAAoB,KAAG,sBAAsB;IAoB/D;;;OAGG;oCACkB,uBAAuB,KAAG,sBAAsB;IAgBrE;;;;OAIG;2BACS,cAAc,KAAG,sBAAsB;IAgBnD;;;OAGG;kCACgB,qBAAqB,KAAG,sBAAsB;IAkBjE;;;OAGG;0BACQ,aAAa,KAAG,sBAAsB;IAgBjD;;;OAGG;iCACe,oBAAoB,KAAG,sBAAsB;IAkB/D;;;OAGG;yBACO,YAAY,KAAG,sBAAsB;IAW/C;;;OAGG;yBACO,YAAY,KAAG,sBAAsB;IAgB/C;;;OAGG;gCACc,mBAAmB,KAAG,sBAAsB;IAiB7D;;;OAGG;uBACK,UAAU,KAAG,sBAAsB;IAgB3C;;;OAGG;8BACY,iBAAiB,KAAG,sBAAsB;IAiBzD;;;OAGG;+BACa,kBAAkB,KAAG,sBAAsB;IAe3D;;;OAGG;gCACc,gBAAgB,KAAG,sBAAsB;IAe1D;;;OAGG;8BACY,gBAAgB,KAAG,sBAAsB;IAexD;;;OAGG;6BACW,gBAAgB,KAAG,sBAAsB;CAU/C,CAAC"}