@oobe-protocol-labs/synapse-client-sdk 1.0.7 → 1.2.0

package/dist/cjs/programs/associated-token.js

@@ -0,0 +1,113 @@
+"use strict";
+/**
+ * Associated Token Account Program instruction encoders.
+ *
+ * Encodes the instructions for creating Associated Token Accounts (ATAs),
+ * which are deterministically derived from the owner wallet and token mint.
+ *
+ * Program ID: `ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL`
+ *
+ * @module programs/associated-token
+ * @since 1.1.0
+ *
+ * @example
+ * ```ts
+ * import { AssociatedToken } from '@oobe-protocol-labs/synapse-client-sdk/programs';
+ * import { Pubkey } from '@oobe-protocol-labs/synapse-client-sdk';
+ *
+ * const ix = AssociatedToken.create({
+ *   payer: Pubkey('PayerWallet...'),
+ *   owner: Pubkey('OwnerWallet...'),
+ *   mint: Pubkey('TokenMint...'),
+ * });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AssociatedToken = exports.ASSOCIATED_TOKEN_PROGRAM = void 0;
+const types_1 = require("../core/types");
+const types_2 = require("./types");
+const spl_token_1 = require("./spl-token");
+// ── Program ID ─────────────────────────────────────────────────
+/**
+ * Associated Token Account Program address.
+ * @since 1.1.0
+ */
+exports.ASSOCIATED_TOKEN_PROGRAM = (0, types_1.Pubkey)('ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL');
+/** @internal System Program for account creation. */
+const SYSTEM_PROGRAM = (0, types_1.Pubkey)('11111111111111111111111111111111');
+// ── AssociatedToken namespace ──────────────────────────────────
+/**
+ * Associated Token Account Program instruction encoders.
+ *
+ * @since 1.1.0
+ */
+exports.AssociatedToken = {
+    /** ATA Program address. */
+    programId: exports.ASSOCIATED_TOKEN_PROGRAM,
+    /**
+     * Create a new Associated Token Account.
+     *
+     * Fails if the ATA already exists. For an idempotent version that
+     * succeeds even if the ATA exists, use {@link createIdempotent}.
+     *
+     * @since 1.1.0
+     */
+    create(p) {
+        const tokenPid = p.tokenProgramId ?? spl_token_1.TOKEN_PROGRAM;
+        return {
+            programId: exports.ASSOCIATED_TOKEN_PROGRAM,
+            keys: [
+                (0, types_2.writableSigner)(p.payer),
+                (0, types_2.writable)(p.associatedToken),
+                (0, types_2.readonly)(p.owner),
+                (0, types_2.readonly)(p.mint),
+                (0, types_2.readonly)(SYSTEM_PROGRAM),
+                (0, types_2.readonly)(tokenPid),
+            ],
+            data: new Uint8Array([0 /* AtaIx.Create */]),
+        };
+    },
+    /**
+     * Create an ATA idempotently — succeeds even if the account already exists.
+     *
+     * This is the recommended way to create ATAs in production.
+     *
+     * @since 1.1.0
+     */
+    createIdempotent(p) {
+        const tokenPid = p.tokenProgramId ?? spl_token_1.TOKEN_PROGRAM;
+        return {
+            programId: exports.ASSOCIATED_TOKEN_PROGRAM,
+            keys: [
+                (0, types_2.writableSigner)(p.payer),
+                (0, types_2.writable)(p.associatedToken),
+                (0, types_2.readonly)(p.owner),
+                (0, types_2.readonly)(p.mint),
+                (0, types_2.readonly)(SYSTEM_PROGRAM),
+                (0, types_2.readonly)(tokenPid),
+            ],
+            data: new Uint8Array([1 /* AtaIx.CreateIdempotent */]),
+        };
+    },
+    /**
+     * Recover tokens from a nested associated token account.
+     *
+     * @since 1.1.0
+     */
+    recoverNested(p) {
+        const tokenPid = p.tokenProgramId ?? spl_token_1.TOKEN_PROGRAM;
+        return {
+            programId: exports.ASSOCIATED_TOKEN_PROGRAM,
+            keys: [
+                (0, types_2.writable)(p.nestedAssociatedToken),
+                (0, types_2.readonly)(p.nestedMint),
+                (0, types_2.writable)(p.destinationAssociatedToken),
+                (0, types_2.readonly)(p.ownerMint),
+                (0, types_2.writableSigner)(p.owner),
+                (0, types_2.readonly)(tokenPid),
+            ],
+            data: new Uint8Array([2 /* AtaIx.RecoverNested */]),
+        };
+    },
+};
+//# sourceMappingURL=associated-token.js.map

package/dist/cjs/programs/associated-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"associated-token.js","sourceRoot":"","sources":["../../../src/programs/associated-token.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;;AAEH,yCAAuC;AAEvC,mCAA6D;AAC7D,2CAA4C;AAE5C,kEAAkE;AAElE;;;GAGG;AACU,QAAA,wBAAwB,GAAG,IAAA,cAAM,EAAC,8CAA8C,CAAC,CAAC;AAE/F,qDAAqD;AACrD,MAAM,cAAc,GAAG,IAAA,cAAM,EAAC,kCAAkC,CAAC,CAAC;AAiDlE,kEAAkE;AAElE;;;;GAIG;AACU,QAAA,eAAe,GAAG;IAC7B,2BAA2B;IAC3B,SAAS,EAAE,gCAAwB;IAEnC;;;;;;;OAOG;IACH,MAAM,CAAC,CAAkB;QACvB,MAAM,QAAQ,GAAG,CAAC,CAAC,cAAc,IAAI,yBAAa,CAAC;QACnD,OAAO;YACL,SAAS,EAAE,gCAAwB;YACnC,IAAI,EAAE;gBACJ,IAAA,sBAAc,EAAC,CAAC,CAAC,KAAK,CAAC;gBACvB,IAAA,gBAAQ,EAAC,CAAC,CAAC,eAAe,CAAC;gBAC3B,IAAA,gBAAQ,EAAC,CAAC,CAAC,KAAK,CAAC;gBACjB,IAAA,gBAAQ,EAAC,CAAC,CAAC,IAAI,CAAC;gBAChB,IAAA,gBAAQ,EAAC,cAAc,CAAC;gBACxB,IAAA,gBAAQ,EAAC,QAAQ,CAAC;aACnB;YACD,IAAI,EAAE,IAAI,UAAU,CAAC,sBAAc,CAAC;SACrC,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,gBAAgB,CAAC,CAAkB;QACjC,MAAM,QAAQ,GAAG,CAAC,CAAC,cAAc,IAAI,yBAAa,CAAC;QACnD,OAAO;YACL,SAAS,EAAE,gCAAwB;YACnC,IAAI,EAAE;gBACJ,IAAA,sBAAc,EAAC,CAAC,CAAC,KAAK,CAAC;gBACvB,IAAA,gBAAQ,EAAC,CAAC,CAAC,eAAe,CAAC;gBAC3B,IAAA,gBAAQ,EAAC,CAAC,CAAC,KAAK,CAAC;gBACjB,IAAA,gBAAQ,EAAC,CAAC,CAAC,IAAI,CAAC;gBAChB,IAAA,gBAAQ,EAAC,cAAc,CAAC;gBACxB,IAAA,gBAAQ,EAAC,QAAQ,CAAC;aACnB;YACD,IAAI,EAAE,IAAI,UAAU,CAAC,gCAAwB,CAAC;SAC/C,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,aAAa,CAAC,CAAsB;QAClC,MAAM,QAAQ,GAAG,CAAC,CAAC,cAAc,IAAI,yBAAa,CAAC;QACnD,OAAO;YACL,SAAS,EAAE,gCAAwB;YACnC,IAAI,EAAE;gBACJ,IAAA,gBAAQ,EAAC,CAAC,CAAC,qBAAqB,CAAC;gBACjC,IAAA,gBAAQ,EAAC,CAAC,CAAC,UAAU,CAAC;gBACtB,IAAA,gBAAQ,EAAC,CAAC,CAAC,0BAA0B,CAAC;gBACtC,IAAA,gBAAQ,EAAC,CAAC,CAAC,SAAS,CAAC;gBACrB,IAAA,sBAAc,EAAC,CAAC,CAAC,KAAK,CAAC;gBACvB,IAAA,gBAAQ,EAAC,QAAQ,CAAC;aACnB;YACD,IAAI,EAAE,IAAI,UAAU,CAAC,6BAAqB,CAAC;SAC5C,CAAC;IACJ,CAAC;CACO,CAAC"}

package/dist/cjs/programs/compute-budget.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Compute Budget Program instruction encoders.
+ *
+ * Encodes priority fee and compute unit instructions that control
+ * transaction scheduling and resource allocation.
+ *
+ * Program ID: `ComputeBudget111111111111111111111111111111`
+ *
+ * @module programs/compute-budget
+ * @since 1.1.0
+ *
+ * @example
+ * ```ts
+ * import { ComputeBudget } from '@oobe-protocol-labs/synapse-client-sdk/programs';
+ *
+ * // Set priority fee (micro-lamports per CU)
+ * const priorityIx = ComputeBudget.setComputeUnitPrice({ microLamports: 50_000n });
+ *
+ * // Set compute unit limit
+ * const limitIx = ComputeBudget.setComputeUnitLimit({ units: 400_000 });
+ * ```
+ */
+import type { TransactionInstruction } from './types';
+/**
+ * Compute Budget Program address.
+ * @since 1.1.0
+ */
+export declare const COMPUTE_BUDGET_PROGRAM: never;
+/**
+ * Params for {@link ComputeBudget.setComputeUnitLimit}.
+ * @since 1.1.0
+ */
+export interface SetComputeUnitLimitParams {
+    /** Maximum compute units for the transaction (max 1_400_000). */
+    units: number;
+}
+/**
+ * Params for {@link ComputeBudget.setComputeUnitPrice}.
+ * @since 1.1.0
+ */
+export interface SetComputeUnitPriceParams {
+    /** Priority fee in micro-lamports per compute unit. */
+    microLamports: bigint;
+}
+/**
+ * Params for {@link ComputeBudget.requestHeapFrame}.
+ * @since 1.1.0
+ */
+export interface RequestHeapFrameParams {
+    /** Heap size in bytes (must be multiple of 1024, max 256 KiB). */
+    bytes: number;
+}
+/**
+ * Params for {@link ComputeBudget.setLoadedAccountsDataSizeLimit}.
+ * @since 1.1.0
+ */
+export interface SetLoadedAccountsDataSizeLimitParams {
+    /** Maximum total loaded accounts data size in bytes. */
+    bytes: number;
+}
+/**
+ * Compute Budget Program instruction encoders.
+ *
+ * These instructions must be included at the **beginning** of a
+ * transaction to take effect.
+ *
+ * @since 1.1.0
+ */
+export declare const ComputeBudget: {
+    /** Compute Budget Program address. */
+    readonly programId: never;
+    /**
+     * Set the compute unit limit for the transaction.
+     *
+     * Default is 200_000 CU. Max is 1_400_000 CU.
+     * Setting a lower limit can reduce priority fees.
+     *
+     * @since 1.1.0
+     */
+    readonly setComputeUnitLimit: (p: SetComputeUnitLimitParams) => TransactionInstruction;
+    /**
+     * Set the priority fee (price per compute unit).
+     *
+     * Priority fee = `microLamports × computeUnitsUsed`.
+     * A value of 50_000 micro-lamports ≈ 0.05 lamports/CU.
+     *
+     * @since 1.1.0
+     */
+    readonly setComputeUnitPrice: (p: SetComputeUnitPriceParams) => TransactionInstruction;
+    /**
+     * Request a larger heap frame for the transaction.
+     *
+     * Default heap is 32 KiB. Max is 256 KiB. Must be a multiple of 1024.
+     *
+     * @since 1.1.0
+     */
+    readonly requestHeapFrame: (p: RequestHeapFrameParams) => TransactionInstruction;
+    /**
+     * Set the maximum total size of loaded accounts data.
+     *
+     * @since 1.1.0
+     */
+    readonly setLoadedAccountsDataSizeLimit: (p: SetLoadedAccountsDataSizeLimitParams) => TransactionInstruction;
+};
+//# sourceMappingURL=compute-budget.d.ts.map

package/dist/cjs/programs/compute-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-budget.d.ts","sourceRoot":"","sources":["../../../src/programs/compute-budget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAKtD;;;GAGG;AACH,eAAO,MAAM,sBAAsB,OAAwD,CAAC;AAc5F;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,uDAAuD;IACvD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,oCAAoC;IACnD,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;CACf;AAID;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa;IACxB,sCAAsC;;IAGtC;;;;;;;OAOG;sCACoB,yBAAyB,KAAG,sBAAsB;IAOzE;;;;;;;OAOG;sCACoB,yBAAyB,KAAG,sBAAsB;IAOzE;;;;;;OAMG;mCACiB,sBAAsB,KAAG,sBAAsB;IAOnE;;;;OAIG;iDAC+B,oCAAoC,KAAG,sBAAsB;CAMvF,CAAC"}

package/dist/cjs/programs/compute-budget.js

@@ -0,0 +1,99 @@
+"use strict";
+/**
+ * Compute Budget Program instruction encoders.
+ *
+ * Encodes priority fee and compute unit instructions that control
+ * transaction scheduling and resource allocation.
+ *
+ * Program ID: `ComputeBudget111111111111111111111111111111`
+ *
+ * @module programs/compute-budget
+ * @since 1.1.0
+ *
+ * @example
+ * ```ts
+ * import { ComputeBudget } from '@oobe-protocol-labs/synapse-client-sdk/programs';
+ *
+ * // Set priority fee (micro-lamports per CU)
+ * const priorityIx = ComputeBudget.setComputeUnitPrice({ microLamports: 50_000n });
+ *
+ * // Set compute unit limit
+ * const limitIx = ComputeBudget.setComputeUnitLimit({ units: 400_000 });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ComputeBudget = exports.COMPUTE_BUDGET_PROGRAM = void 0;
+const types_1 = require("../core/types");
+const types_2 = require("./types");
+// ── Program ID ─────────────────────────────────────────────────
+/**
+ * Compute Budget Program address.
+ * @since 1.1.0
+ */
+exports.COMPUTE_BUDGET_PROGRAM = (0, types_1.Pubkey)('ComputeBudget111111111111111111111111111111');
+// ── ComputeBudget namespace ────────────────────────────────────
+/**
+ * Compute Budget Program instruction encoders.
+ *
+ * These instructions must be included at the **beginning** of a
+ * transaction to take effect.
+ *
+ * @since 1.1.0
+ */
+exports.ComputeBudget = {
+    /** Compute Budget Program address. */
+    programId: exports.COMPUTE_BUDGET_PROGRAM,
+    /**
+     * Set the compute unit limit for the transaction.
+     *
+     * Default is 200_000 CU. Max is 1_400_000 CU.
+     * Setting a lower limit can reduce priority fees.
+     *
+     * @since 1.1.0
+     */
+    setComputeUnitLimit(p) {
+        const w = new types_2.InstructionWriter(5);
+        w.u8(2 /* CbIx.SetComputeUnitLimit */);
+        w.u32(p.units);
+        return { programId: exports.COMPUTE_BUDGET_PROGRAM, keys: [], data: w.toBytes() };
+    },
+    /**
+     * Set the priority fee (price per compute unit).
+     *
+     * Priority fee = `microLamports × computeUnitsUsed`.
+     * A value of 50_000 micro-lamports ≈ 0.05 lamports/CU.
+     *
+     * @since 1.1.0
+     */
+    setComputeUnitPrice(p) {
+        const w = new types_2.InstructionWriter(9);
+        w.u8(3 /* CbIx.SetComputeUnitPrice */);
+        w.u64(p.microLamports);
+        return { programId: exports.COMPUTE_BUDGET_PROGRAM, keys: [], data: w.toBytes() };
+    },
+    /**
+     * Request a larger heap frame for the transaction.
+     *
+     * Default heap is 32 KiB. Max is 256 KiB. Must be a multiple of 1024.
+     *
+     * @since 1.1.0
+     */
+    requestHeapFrame(p) {
+        const w = new types_2.InstructionWriter(5);
+        w.u8(1 /* CbIx.RequestHeapFrame */);
+        w.u32(p.bytes);
+        return { programId: exports.COMPUTE_BUDGET_PROGRAM, keys: [], data: w.toBytes() };
+    },
+    /**
+     * Set the maximum total size of loaded accounts data.
+     *
+     * @since 1.1.0
+     */
+    setLoadedAccountsDataSizeLimit(p) {
+        const w = new types_2.InstructionWriter(5);
+        w.u8(4 /* CbIx.SetLoadedAccountsDataSizeLimit */);
+        w.u32(p.bytes);
+        return { programId: exports.COMPUTE_BUDGET_PROGRAM, keys: [], data: w.toBytes() };
+    },
+};
+//# sourceMappingURL=compute-budget.js.map

package/dist/cjs/programs/compute-budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-budget.js","sourceRoot":"","sources":["../../../src/programs/compute-budget.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;AAEH,yCAAuC;AAEvC,mCAA4C;AAE5C,kEAAkE;AAElE;;;GAGG;AACU,QAAA,sBAAsB,GAAG,IAAA,cAAM,EAAC,6CAA6C,CAAC,CAAC;AAkD5F,kEAAkE;AAElE;;;;;;;GAOG;AACU,QAAA,aAAa,GAAG;IAC3B,sCAAsC;IACtC,SAAS,EAAE,8BAAsB;IAEjC;;;;;;;OAOG;IACH,mBAAmB,CAAC,CAA4B;QAC9C,MAAM,CAAC,GAAG,IAAI,yBAAiB,CAAC,CAAC,CAAC,CAAC;QACnC,CAAC,CAAC,EAAE,kCAA0B,CAAC;QAC/B,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACf,OAAO,EAAE,SAAS,EAAE,8BAAsB,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;IAC5E,CAAC;IAED;;;;;;;OAOG;IACH,mBAAmB,CAAC,CAA4B;QAC9C,MAAM,CAAC,GAAG,IAAI,yBAAiB,CAAC,CAAC,CAAC,CAAC;QACnC,CAAC,CAAC,EAAE,kCAA0B,CAAC;QAC/B,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;QACvB,OAAO,EAAE,SAAS,EAAE,8BAAsB,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;IAC5E,CAAC;IAED;;;;;;OAMG;IACH,gBAAgB,CAAC,CAAyB;QACxC,MAAM,CAAC,GAAG,IAAI,yBAAiB,CAAC,CAAC,CAAC,CAAC;QACnC,CAAC,CAAC,EAAE,+BAAuB,CAAC;QAC5B,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACf,OAAO,EAAE,SAAS,EAAE,8BAAsB,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;IAC5E,CAAC;IAED;;;;OAIG;IACH,8BAA8B,CAAC,CAAuC;QACpE,MAAM,CAAC,GAAG,IAAI,yBAAiB,CAAC,CAAC,CAAC,CAAC;QACnC,CAAC,CAAC,EAAE,6CAAqC,CAAC;QAC1C,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACf,OAAO,EAAE,SAAS,EAAE,8BAAsB,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;IAC5E,CAAC;CACO,CAAC"}

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

@@ -0,0 +1,74 @@
+/**
+ * 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 });
+ * ```
+ */
+export { type AccountMeta, type TransactionInstruction, InstructionWriter, decodeBase58, writableSigner, writable, readonlySigner, readonly, } from './types';
+export { SystemProgram, SYSTEM_PROGRAM, type TransferParams as SystemTransferParams, type CreateAccountParams, type AssignParams, type AllocateParams, type CreateAccountWithSeedParams, type AdvanceNonceParams, type WithdrawNonceParams, type InitializeNonceParams, type AuthorizeNonceParams, } from './system';
+export { SplToken, TOKEN_PROGRAM, TOKEN_2022_PROGRAM, type InitializeMintParams, type InitializeAccountParams, type TransferParams as TokenTransferParams, type TransferCheckedParams, type ApproveParams, type ApproveCheckedParams, type RevokeParams, type MintToParams, type MintToCheckedParams, type BurnParams, type BurnCheckedParams, type CloseAccountParams, type FreezeThawParams, type SyncNativeParams, } from './spl-token';
+export { AssociatedToken, ASSOCIATED_TOKEN_PROGRAM, type CreateATAParams, type RecoverNestedParams, } from './associated-token';
+export { Memo, MEMO_PROGRAM_V2, MEMO_PROGRAM_V1, type AddMemoParams, } from './memo';
+export { ComputeBudget, COMPUTE_BUDGET_PROGRAM, type SetComputeUnitLimitParams, type SetComputeUnitPriceParams, type RequestHeapFrameParams, type SetLoadedAccountsDataSizeLimitParams, } from './compute-budget';
+import type { TransactionInstruction } from './types';
+import type { Instruction } from '@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),
+ * );
+ * ```
+ */
+export declare function toKitInstruction(ix: TransactionInstruction): Instruction;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/programs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAGH,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAC3B,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,QAAQ,EACR,cAAc,EACd,QAAQ,GACT,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,aAAa,EACb,cAAc,EACd,KAAK,cAAc,IAAI,oBAAoB,EAC3C,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,2BAA2B,EAChC,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,QAAQ,EACR,aAAa,EACb,kBAAkB,EAClB,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,cAAc,IAAI,mBAAmB,EAC1C,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,KAAK,eAAe,EACpB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,IAAI,EACJ,eAAe,EACf,eAAe,EACf,KAAK,aAAa,GACnB,MAAM,QAAQ,CAAC;AAGhB,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC3B,KAAK,oCAAoC,GAC1C,MAAM,kBAAkB,CAAC;AAI1B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEtD,OAAO,KAAK,EAAW,WAAW,EAAiC,MAAM,aAAa,CAAC;AAGvF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,sBAAsB,GAAG,WAAW,CAWxE"}

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"}