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

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

@@ -0,0 +1,110 @@
+/**
+ * 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...'),
+ * });
+ * ```
+ */
+import { Pubkey } from '../core/types.js';
+import { writableSigner, writable, readonly } from './types.js';
+import { TOKEN_PROGRAM } from './spl-token.js';
+// ── Program ID ─────────────────────────────────────────────────
+/**
+ * Associated Token Account Program address.
+ * @since 1.1.0
+ */
+export const ASSOCIATED_TOKEN_PROGRAM = Pubkey('ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL');
+/** @internal System Program for account creation. */
+const SYSTEM_PROGRAM = Pubkey('11111111111111111111111111111111');
+// ── AssociatedToken namespace ──────────────────────────────────
+/**
+ * Associated Token Account Program instruction encoders.
+ *
+ * @since 1.1.0
+ */
+export const AssociatedToken = {
+    /** ATA Program address. */
+    programId: 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 ?? TOKEN_PROGRAM;
+        return {
+            programId: ASSOCIATED_TOKEN_PROGRAM,
+            keys: [
+                writableSigner(p.payer),
+                writable(p.associatedToken),
+                readonly(p.owner),
+                readonly(p.mint),
+                readonly(SYSTEM_PROGRAM),
+                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 ?? TOKEN_PROGRAM;
+        return {
+            programId: ASSOCIATED_TOKEN_PROGRAM,
+            keys: [
+                writableSigner(p.payer),
+                writable(p.associatedToken),
+                readonly(p.owner),
+                readonly(p.mint),
+                readonly(SYSTEM_PROGRAM),
+                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 ?? TOKEN_PROGRAM;
+        return {
+            programId: ASSOCIATED_TOKEN_PROGRAM,
+            keys: [
+                writable(p.nestedAssociatedToken),
+                readonly(p.nestedMint),
+                writable(p.destinationAssociatedToken),
+                readonly(p.ownerMint),
+                writableSigner(p.owner),
+                readonly(tokenPid),
+            ],
+            data: new Uint8Array([2 /* AtaIx.RecoverNested */]),
+        };
+    },
+};
+//# sourceMappingURL=associated-token.js.map

package/dist/esm/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,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,kEAAkE;AAElE;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC,8CAA8C,CAAC,CAAC;AAE/F,qDAAqD;AACrD,MAAM,cAAc,GAAG,MAAM,CAAC,kCAAkC,CAAC,CAAC;AAiDlE,kEAAkE;AAElE;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,2BAA2B;IAC3B,SAAS,EAAE,wBAAwB;IAEnC;;;;;;;OAOG;IACH,MAAM,CAAC,CAAkB;QACvB,MAAM,QAAQ,GAAG,CAAC,CAAC,cAAc,IAAI,aAAa,CAAC;QACnD,OAAO;YACL,SAAS,EAAE,wBAAwB;YACnC,IAAI,EAAE;gBACJ,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC;gBACvB,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC;gBAC3B,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;gBACjB,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;gBAChB,QAAQ,CAAC,cAAc,CAAC;gBACxB,QAAQ,CAAC,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,aAAa,CAAC;QACnD,OAAO;YACL,SAAS,EAAE,wBAAwB;YACnC,IAAI,EAAE;gBACJ,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC;gBACvB,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC;gBAC3B,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;gBACjB,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;gBAChB,QAAQ,CAAC,cAAc,CAAC;gBACxB,QAAQ,CAAC,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,aAAa,CAAC;QACnD,OAAO;YACL,SAAS,EAAE,wBAAwB;YACnC,IAAI,EAAE;gBACJ,QAAQ,CAAC,CAAC,CAAC,qBAAqB,CAAC;gBACjC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC;gBACtB,QAAQ,CAAC,CAAC,CAAC,0BAA0B,CAAC;gBACtC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;gBACrB,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC;gBACvB,QAAQ,CAAC,QAAQ,CAAC;aACnB;YACD,IAAI,EAAE,IAAI,UAAU,CAAC,6BAAqB,CAAC;SAC5C,CAAC;IACJ,CAAC;CACO,CAAC"}

package/dist/esm/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/esm/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/esm/programs/compute-budget.js

@@ -0,0 +1,96 @@
+/**
+ * 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 { Pubkey } from '../core/types.js';
+import { InstructionWriter } from './types.js';
+// ── Program ID ─────────────────────────────────────────────────
+/**
+ * Compute Budget Program address.
+ * @since 1.1.0
+ */
+export const COMPUTE_BUDGET_PROGRAM = 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
+ */
+export const ComputeBudget = {
+    /** Compute Budget Program address. */
+    programId: 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 InstructionWriter(5);
+        w.u8(2 /* CbIx.SetComputeUnitLimit */);
+        w.u32(p.units);
+        return { programId: 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 InstructionWriter(9);
+        w.u8(3 /* CbIx.SetComputeUnitPrice */);
+        w.u64(p.microLamports);
+        return { programId: 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 InstructionWriter(5);
+        w.u8(1 /* CbIx.RequestHeapFrame */);
+        w.u32(p.bytes);
+        return { programId: 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 InstructionWriter(5);
+        w.u8(4 /* CbIx.SetLoadedAccountsDataSizeLimit */);
+        w.u32(p.bytes);
+        return { programId: COMPUTE_BUDGET_PROGRAM, keys: [], data: w.toBytes() };
+    },
+};
+//# sourceMappingURL=compute-budget.js.map

package/dist/esm/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,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE5C,kEAAkE;AAElE;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,6CAA6C,CAAC,CAAC;AAkD5F,kEAAkE;AAElE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,sCAAsC;IACtC,SAAS,EAAE,sBAAsB;IAEjC;;;;;;;OAOG;IACH,mBAAmB,CAAC,CAA4B;QAC9C,MAAM,CAAC,GAAG,IAAI,iBAAiB,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,sBAAsB,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,iBAAiB,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,sBAAsB,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,iBAAiB,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,sBAAsB,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,iBAAiB,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,sBAAsB,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;IAC5E,CAAC;CACO,CAAC"}

package/dist/esm/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/esm/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/esm/programs/index.js

@@ -0,0 +1,90 @@
+/**
+ * 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 });
+ * ```
+ */
+// ── Types & Writer ─────────────────────────────────────────────
+export { InstructionWriter, decodeBase58, writableSigner, writable, readonlySigner, readonly, } from './types.js';
+// ── System Program ─────────────────────────────────────────────
+export { SystemProgram, SYSTEM_PROGRAM, } from './system.js';
+// ── SPL Token ──────────────────────────────────────────────────
+export { SplToken, TOKEN_PROGRAM, TOKEN_2022_PROGRAM, } from './spl-token.js';
+// ── Associated Token Account ───────────────────────────────────
+export { AssociatedToken, ASSOCIATED_TOKEN_PROGRAM, } from './associated-token.js';
+// ── Memo ───────────────────────────────────────────────────────
+export { Memo, MEMO_PROGRAM_V2, MEMO_PROGRAM_V1, } from './memo.js';
+// ── Compute Budget ─────────────────────────────────────────────
+export { ComputeBudget, COMPUTE_BUDGET_PROGRAM, } from './compute-budget.js';
+import { address as kitAddress, AccountRole } 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 function toKitInstruction(ix) {
+    return {
+        programAddress: kitAddress(ix.programId),
+        accounts: ix.keys.map((k) => ({
+            address: kitAddress(k.pubkey),
+            role: k.isSigner
+                ? (k.isWritable ? AccountRole.WRITABLE_SIGNER : AccountRole.READONLY_SIGNER)
+                : (k.isWritable ? AccountRole.WRITABLE : AccountRole.READONLY),
+        })),
+        data: ix.data,
+    };
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/programs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,kEAAkE;AAClE,OAAO,EAGL,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,QAAQ,EACR,cAAc,EACd,QAAQ,GACT,MAAM,SAAS,CAAC;AAEjB,kEAAkE;AAClE,OAAO,EACL,aAAa,EACb,cAAc,GAUf,MAAM,UAAU,CAAC;AAElB,kEAAkE;AAClE,OAAO,EACL,QAAQ,EACR,aAAa,EACb,kBAAkB,GAenB,MAAM,aAAa,CAAC;AAErB,kEAAkE;AAClE,OAAO,EACL,eAAe,EACf,wBAAwB,GAGzB,MAAM,oBAAoB,CAAC;AAE5B,kEAAkE;AAClE,OAAO,EACL,IAAI,EACJ,eAAe,EACf,eAAe,GAEhB,MAAM,QAAQ,CAAC;AAEhB,kEAAkE;AAClE,OAAO,EACL,aAAa,EACb,sBAAsB,GAKvB,MAAM,kBAAkB,CAAC;AAO1B,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAA0B;IACzD,OAAO;QACL,cAAc,EAAE,UAAU,CAAC,EAAE,CAAC,SAA8B,CAAY;QACxE,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAiB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5C,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,MAA2B,CAAY;YAC7D,IAAI,EAAE,CAAC,CAAC,QAAQ;gBACd,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC,CAAC,WAAW,CAAC,eAAe,CAAC;gBAC5E,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC;SACjE,CAAC,CAAC;QACH,IAAI,EAAE,EAAE,CAAC,IAAI;KACd,CAAC;AACJ,CAAC"}

package/dist/esm/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/esm/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/esm/programs/memo.js

@@ -0,0 +1,71 @@
+/**
+ * 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.js';
+import { readonlySigner } from './types.js';
+// ── Program IDs ────────────────────────────────────────────────
+/**
+ * SPL Memo Program v2 address.
+ * @since 1.1.0
+ */
+export const MEMO_PROGRAM_V2 = Pubkey('MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr');
+/**
+ * SPL Memo Program v1 address (deprecated, but still supported on-chain).
+ * @since 1.1.0
+ */
+export const MEMO_PROGRAM_V1 = Pubkey('Memo1UhkJBfCR6MNcUpSSKvyfcY7YFW5p5JHblJRK9R');
+// ── Memo namespace ─────────────────────────────────────────────
+/**
+ * SPL Memo Program instruction encoders.
+ *
+ * @since 1.1.0
+ */
+export const Memo = {
+    /** Memo v2 program ID. */
+    programId: MEMO_PROGRAM_V2,
+    /** Memo v1 program ID. */
+    v1ProgramId: 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 ? MEMO_PROGRAM_V1 : MEMO_PROGRAM_V2;
+        const data = new TextEncoder().encode(p.message);
+        const keys = [];
+        if (p.signer) {
+            keys.push(readonlySigner(p.signer));
+        }
+        if (p.additionalSigners) {
+            for (const s of p.additionalSigners) {
+                keys.push(readonlySigner(s));
+            }
+        }
+        return { programId: pid, keys, data };
+    },
+};
+//# sourceMappingURL=memo.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memo.js","sourceRoot":"","sources":["../../../src/programs/memo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC,kEAAkE;AAElE;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,6CAA6C,CAAC,CAAC;AAErF;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,6CAA6C,CAAC,CAAC;AAmBrF,kEAAkE;AAElE;;;;GAIG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,0BAA0B;IAC1B,SAAS,EAAE,eAAe;IAC1B,0BAA0B;IAC1B,WAAW,EAAE,eAAe;IAE5B;;;;;;;OAOG;IACH,OAAO,CAAC,CAAgB;QACtB,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,eAAe,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,cAAc,CAAC,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,cAAc,CAAC,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"}