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

package/dist/esm/programs/system.js

@@ -0,0 +1,228 @@
+/**
+ * System Program instruction encoders.
+ *
+ * Encodes the most common System Program instructions as raw
+ * {@link TransactionInstruction} objects ready to be included in a
+ * Solana transaction.
+ *
+ * Program ID: `11111111111111111111111111111111`
+ *
+ * @module programs/system
+ * @since 1.1.0
+ *
+ * @example
+ * ```ts
+ * import { SystemProgram } from '@oobe-protocol-labs/synapse-client-sdk/programs';
+ * import { Pubkey, Lamports } from '@oobe-protocol-labs/synapse-client-sdk';
+ *
+ * const ix = SystemProgram.transfer({
+ *   from: Pubkey('Sender...'),
+ *   to: Pubkey('Receiver...'),
+ *   lamports: Lamports(1_000_000_000n),
+ * });
+ * ```
+ */
+import { Pubkey } from '../core/types.js';
+import { InstructionWriter, writableSigner, writable, readonly, readonlySigner } from './types.js';
+// ── Program ID ─────────────────────────────────────────────────
+/**
+ * System Program address.
+ * @since 1.1.0
+ */
+export const SYSTEM_PROGRAM = Pubkey('11111111111111111111111111111111');
+// ── Recent blockhash sysvar ────────────────────────────────────
+/** @internal */
+const RECENT_BLOCKHASHES_SYSVAR = Pubkey('SysvarRecentB1teleHashes11111111111111111111');
+/** @internal */
+const RENT_SYSVAR = Pubkey('SysvarRent111111111111111111111111111111111');
+// ── SystemProgram namespace ────────────────────────────────────
+/**
+ * System Program instruction encoders.
+ *
+ * Static methods produce {@link TransactionInstruction} objects for the
+ * native Solana System Program.
+ *
+ * @since 1.1.0
+ */
+export const SystemProgram = {
+    /** System Program address. */
+    programId: SYSTEM_PROGRAM,
+    /**
+     * Transfer SOL between two accounts.
+     *
+     * @param p - Transfer parameters.
+     * @returns Encoded instruction.
+     * @since 1.1.0
+     */
+    transfer(p) {
+        const w = new InstructionWriter(12);
+        w.u32(2 /* SystemIx.Transfer */);
+        w.u64(BigInt(p.lamports));
+        return {
+            programId: SYSTEM_PROGRAM,
+            keys: [writableSigner(p.from), writable(p.to)],
+            data: w.toBytes(),
+        };
+    },
+    /**
+     * Create a new account with allocated space and program owner.
+     *
+     * @param p - CreateAccount parameters.
+     * @returns Encoded instruction.
+     * @since 1.1.0
+     */
+    createAccount(p) {
+        const w = new InstructionWriter(52);
+        w.u32(0 /* SystemIx.CreateAccount */);
+        w.u64(BigInt(p.lamports));
+        w.u64(BigInt(p.space));
+        w.pubkey(p.programId);
+        return {
+            programId: SYSTEM_PROGRAM,
+            keys: [writableSigner(p.from), writableSigner(p.newAccount)],
+            data: w.toBytes(),
+        };
+    },
+    /**
+     * Assign an account to a program.
+     *
+     * @param p - Assign parameters.
+     * @returns Encoded instruction.
+     * @since 1.1.0
+     */
+    assign(p) {
+        const w = new InstructionWriter(36);
+        w.u32(1 /* SystemIx.Assign */);
+        w.pubkey(p.programId);
+        return {
+            programId: SYSTEM_PROGRAM,
+            keys: [writableSigner(p.account)],
+            data: w.toBytes(),
+        };
+    },
+    /**
+     * Allocate space for an account (without funding or assigning owner).
+     *
+     * @param p - Allocate parameters.
+     * @returns Encoded instruction.
+     * @since 1.1.0
+     */
+    allocate(p) {
+        const w = new InstructionWriter(12);
+        w.u32(8 /* SystemIx.Allocate */);
+        w.u64(BigInt(p.space));
+        return {
+            programId: SYSTEM_PROGRAM,
+            keys: [writableSigner(p.account)],
+            data: w.toBytes(),
+        };
+    },
+    /**
+     * Create account with a seed-derived address.
+     *
+     * @param p - CreateAccountWithSeed parameters.
+     * @returns Encoded instruction.
+     * @since 1.1.0
+     */
+    createAccountWithSeed(p) {
+        const seedBytes = new TextEncoder().encode(p.seed);
+        // 4 (ix) + 32 (base) + 4 (seed len) + seedBytes + 8 (lamports) + 8 (space) + 32 (owner)
+        const dataLen = 4 + 32 + 4 + seedBytes.length + 8 + 8 + 32;
+        const w = new InstructionWriter(dataLen);
+        w.u32(3 /* SystemIx.CreateAccountWithSeed */);
+        w.pubkey(p.base);
+        w.u32(seedBytes.length); // Rust string length prefix
+        w.raw(seedBytes);
+        w.u64(BigInt(p.lamports));
+        w.u64(BigInt(p.space));
+        w.pubkey(p.programId);
+        const keys = [writableSigner(p.from), writable(p.newAccount)];
+        // If base !== from, base is also a signer
+        if (p.base !== p.from) {
+            keys.push(readonlySigner(p.base));
+        }
+        return { programId: SYSTEM_PROGRAM, keys, data: w.toBytes() };
+    },
+    /**
+     * Advance a durable nonce account.
+     *
+     * @param p - AdvanceNonce parameters.
+     * @returns Encoded instruction.
+     * @since 1.1.0
+     */
+    advanceNonce(p) {
+        const w = new InstructionWriter(4);
+        w.u32(4 /* SystemIx.AdvanceNonceAccount */);
+        return {
+            programId: SYSTEM_PROGRAM,
+            keys: [
+                writable(p.nonceAccount),
+                readonly(RECENT_BLOCKHASHES_SYSVAR),
+                readonlySigner(p.authority),
+            ],
+            data: w.toBytes(),
+        };
+    },
+    /**
+     * Withdraw lamports from a nonce account.
+     *
+     * @param p - WithdrawNonce parameters.
+     * @returns Encoded instruction.
+     * @since 1.1.0
+     */
+    withdrawNonce(p) {
+        const w = new InstructionWriter(12);
+        w.u32(5 /* SystemIx.WithdrawNonceAccount */);
+        w.u64(BigInt(p.lamports));
+        return {
+            programId: SYSTEM_PROGRAM,
+            keys: [
+                writable(p.nonceAccount),
+                writable(p.to),
+                readonly(RECENT_BLOCKHASHES_SYSVAR),
+                readonly(RENT_SYSVAR),
+                readonlySigner(p.authority),
+            ],
+            data: w.toBytes(),
+        };
+    },
+    /**
+     * Initialize a nonce account (must be pre-allocated with SystemProgram.createAccount).
+     *
+     * @param p - InitializeNonce parameters.
+     * @returns Encoded instruction.
+     * @since 1.1.0
+     */
+    initializeNonce(p) {
+        const w = new InstructionWriter(36);
+        w.u32(6 /* SystemIx.InitializeNonceAccount */);
+        w.pubkey(p.authority);
+        return {
+            programId: SYSTEM_PROGRAM,
+            keys: [
+                writable(p.nonceAccount),
+                readonly(RECENT_BLOCKHASHES_SYSVAR),
+                readonly(RENT_SYSVAR),
+            ],
+            data: w.toBytes(),
+        };
+    },
+    /**
+     * Change the authority of a nonce account.
+     *
+     * @param p - AuthorizeNonce parameters.
+     * @returns Encoded instruction.
+     * @since 1.1.0
+     */
+    authorizeNonce(p) {
+        const w = new InstructionWriter(36);
+        w.u32(7 /* SystemIx.AuthorizeNonceAccount */);
+        w.pubkey(p.newAuthority);
+        return {
+            programId: SYSTEM_PROGRAM,
+            keys: [writable(p.nonceAccount), readonlySigner(p.authority)],
+            data: w.toBytes(),
+        };
+    },
+};
+//# sourceMappingURL=system.js.map

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

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

package/dist/esm/programs/types.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Shared types for Solana native instruction encoders.
+ *
+ * Provides the low-level building blocks ({@link AccountMeta},
+ * {@link TransactionInstruction}, {@link InstructionWriter}) used by
+ * every program encoder in this module.
+ *
+ * These types mirror the Solana runtime ABI and are fully compatible with
+ * `@solana/kit`'s `IInstruction` interface, so they can be appended to a
+ * Kit `TransactionMessage` without any conversion.
+ *
+ * @module programs/types
+ * @since 1.1.0
+ *
+ * @example
+ * ```ts
+ * import { InstructionWriter } from '@oobe-protocol-labs/synapse-client-sdk/programs';
+ *
+ * const w = new InstructionWriter(12); // 12-byte data buffer
+ * w.u32(2);         // instruction discriminator
+ * w.u64(1_000_000_000n); // lamports
+ * const data = w.toBytes();
+ * ```
+ */
+import type { Pubkey } from '../core/types';
+/**
+ * Describes a single account input for a Solana instruction.
+ *
+ * @since 1.1.0
+ */
+export interface AccountMeta {
+    /** Account public key (base58). */
+    pubkey: Pubkey;
+    /** Must the account sign the transaction? */
+    isSigner: boolean;
+    /** Will the instruction modify this account's data or lamports? */
+    isWritable: boolean;
+}
+/**
+ * A fully encoded Solana transaction instruction.
+ *
+ * This is the SDK-native representation. Use `toKitInstruction()` from
+ * the `programs` module to convert to a `@solana/kit` `IInstruction`.
+ *
+ * @since 1.1.0
+ */
+export interface TransactionInstruction {
+    /** Program that will process this instruction. */
+    programId: Pubkey;
+    /** Ordered list of account inputs. */
+    keys: AccountMeta[];
+    /** Serialised instruction data (Borsh / custom binary). */
+    data: Uint8Array;
+}
+/**
+ * Zero-allocation binary writer for instruction data.
+ *
+ * Little-endian, offset-tracking — the write-side counterpart of
+ * {@link AccountReader} from the `decoders` module.
+ *
+ * @since 1.1.0
+ */
+export declare class InstructionWriter {
+    private offset;
+    private readonly view;
+    private readonly bytes;
+    /**
+     * @param size - Exact byte length of the instruction data buffer.
+     */
+    constructor(size: number);
+    /** Current write position. @since 1.1.0 */
+    get position(): number;
+    /** Write an unsigned 8-bit integer. @since 1.1.0 */
+    u8(val: number): this;
+    /** Write an unsigned 16-bit integer (little-endian). @since 1.1.0 */
+    u16(val: number): this;
+    /** Write an unsigned 32-bit integer (little-endian). @since 1.1.0 */
+    u32(val: number): this;
+    /** Write an unsigned 64-bit integer (little-endian). @since 1.1.0 */
+    u64(val: bigint): this;
+    /** Write a signed 64-bit integer (little-endian). @since 1.1.0 */
+    i64(val: bigint): this;
+    /**
+     * Write a 32-byte public key from base58 into the buffer.
+     *
+     * **Note:** For instruction data that embeds raw pubkeys (rare — most
+     * programs reference accounts via the `keys` array). Uses the SDK's
+     * built-in base58 decoder.
+     *
+     * @since 1.1.0
+     */
+    pubkey(key: Pubkey): this;
+    /** Write raw bytes. @since 1.1.0 */
+    raw(data: Uint8Array): this;
+    /** Return the completed instruction data buffer. @since 1.1.0 */
+    toBytes(): Uint8Array;
+}
+/**
+ * Decode a base58 string to bytes. Self-contained, zero-dep.
+ * @internal
+ */
+export declare function decodeBase58(str: string): Uint8Array;
+/** Create a writable, signer account meta. @since 1.1.0 */
+export declare function writableSigner(pubkey: Pubkey): AccountMeta;
+/** Create a writable, non-signer account meta. @since 1.1.0 */
+export declare function writable(pubkey: Pubkey): AccountMeta;
+/** Create a read-only, signer account meta. @since 1.1.0 */
+export declare function readonlySigner(pubkey: Pubkey): AccountMeta;
+/** Create a read-only, non-signer account meta. @since 1.1.0 */
+export declare function readonly(pubkey: Pubkey): AccountMeta;
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/programs/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/programs/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAI5C;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,QAAQ,EAAE,OAAO,CAAC;IAClB,mEAAmE;IACnE,UAAU,EAAE,OAAO,CAAC;CACrB;AAID;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,2DAA2D;IAC3D,IAAI,EAAE,UAAU,CAAC;CAClB;AAID;;;;;;;GAOG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAW;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IAEnC;;OAEG;gBACS,IAAI,EAAE,MAAM;IAKxB,2CAA2C;IAC3C,IAAI,QAAQ,IAAI,MAAM,CAAwB;IAE9C,oDAAoD;IACpD,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAMrB,qEAAqE;IACrE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAMtB,qEAAqE;IACrE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAMtB,qEAAqE;IACrE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAMtB,kEAAkE;IAClE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAMtB;;;;;;;;OAQG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAOzB,oCAAoC;IACpC,GAAG,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAM3B,iEAAiE;IACjE,OAAO,IAAI,UAAU;CAGtB;AAQD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CA2BpD;AAID,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAE1D;AAED,+DAA+D;AAC/D,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAEpD;AAED,4DAA4D;AAC5D,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAE1D;AAED,gEAAgE;AAChE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAEpD"}

package/dist/esm/programs/types.js

@@ -0,0 +1,157 @@
+/**
+ * Shared types for Solana native instruction encoders.
+ *
+ * Provides the low-level building blocks ({@link AccountMeta},
+ * {@link TransactionInstruction}, {@link InstructionWriter}) used by
+ * every program encoder in this module.
+ *
+ * These types mirror the Solana runtime ABI and are fully compatible with
+ * `@solana/kit`'s `IInstruction` interface, so they can be appended to a
+ * Kit `TransactionMessage` without any conversion.
+ *
+ * @module programs/types
+ * @since 1.1.0
+ *
+ * @example
+ * ```ts
+ * import { InstructionWriter } from '@oobe-protocol-labs/synapse-client-sdk/programs';
+ *
+ * const w = new InstructionWriter(12); // 12-byte data buffer
+ * w.u32(2);         // instruction discriminator
+ * w.u64(1_000_000_000n); // lamports
+ * const data = w.toBytes();
+ * ```
+ */
+// ── Instruction Writer ─────────────────────────────────────────
+/**
+ * Zero-allocation binary writer for instruction data.
+ *
+ * Little-endian, offset-tracking — the write-side counterpart of
+ * {@link AccountReader} from the `decoders` module.
+ *
+ * @since 1.1.0
+ */
+export class InstructionWriter {
+    offset = 0;
+    view;
+    bytes;
+    /**
+     * @param size - Exact byte length of the instruction data buffer.
+     */
+    constructor(size) {
+        this.bytes = new Uint8Array(size);
+        this.view = new DataView(this.bytes.buffer);
+    }
+    /** Current write position. @since 1.1.0 */
+    get position() { return this.offset; }
+    /** Write an unsigned 8-bit integer. @since 1.1.0 */
+    u8(val) {
+        this.view.setUint8(this.offset, val);
+        this.offset += 1;
+        return this;
+    }
+    /** Write an unsigned 16-bit integer (little-endian). @since 1.1.0 */
+    u16(val) {
+        this.view.setUint16(this.offset, val, true);
+        this.offset += 2;
+        return this;
+    }
+    /** Write an unsigned 32-bit integer (little-endian). @since 1.1.0 */
+    u32(val) {
+        this.view.setUint32(this.offset, val, true);
+        this.offset += 4;
+        return this;
+    }
+    /** Write an unsigned 64-bit integer (little-endian). @since 1.1.0 */
+    u64(val) {
+        this.view.setBigUint64(this.offset, val, true);
+        this.offset += 8;
+        return this;
+    }
+    /** Write a signed 64-bit integer (little-endian). @since 1.1.0 */
+    i64(val) {
+        this.view.setBigInt64(this.offset, val, true);
+        this.offset += 8;
+        return this;
+    }
+    /**
+     * Write a 32-byte public key from base58 into the buffer.
+     *
+     * **Note:** For instruction data that embeds raw pubkeys (rare — most
+     * programs reference accounts via the `keys` array). Uses the SDK's
+     * built-in base58 decoder.
+     *
+     * @since 1.1.0
+     */
+    pubkey(key) {
+        const decoded = decodeBase58(key);
+        this.bytes.set(decoded, this.offset);
+        this.offset += 32;
+        return this;
+    }
+    /** Write raw bytes. @since 1.1.0 */
+    raw(data) {
+        this.bytes.set(data, this.offset);
+        this.offset += data.length;
+        return this;
+    }
+    /** Return the completed instruction data buffer. @since 1.1.0 */
+    toBytes() {
+        return this.bytes;
+    }
+}
+// ── Base58 decoder (self-contained) ────────────────────────────
+const B58_ALPHABET = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
+const B58_MAP = new Uint8Array(128).fill(255);
+for (let i = 0; i < B58_ALPHABET.length; i++)
+    B58_MAP[B58_ALPHABET.charCodeAt(i)] = i;
+/**
+ * Decode a base58 string to bytes. Self-contained, zero-dep.
+ * @internal
+ */
+export function decodeBase58(str) {
+    if (str.length === 0)
+        return new Uint8Array(0);
+    let zeros = 0;
+    while (zeros < str.length && str[zeros] === '1')
+        zeros++;
+    const size = ((str.length - zeros) * 733 / 1000 + 1) >>> 0;
+    const b256 = new Uint8Array(size);
+    let length = 0;
+    for (let i = zeros; i < str.length; i++) {
+        let carry = B58_MAP[str.charCodeAt(i)];
+        if (carry === 255)
+            throw new Error(`Invalid base58 character: ${str[i]}`);
+        let j = 0;
+        for (let k = size - 1; (carry !== 0 || j < length) && k >= 0; k--, j++) {
+            carry += 58 * b256[k];
+            b256[k] = carry % 256;
+            carry = (carry / 256) >>> 0;
+        }
+        length = j;
+    }
+    let idx = size - length;
+    const result = new Uint8Array(zeros + length);
+    // Leading zeros are already 0 in the result
+    for (let i = 0; idx < size; i++, idx++)
+        result[zeros + i] = b256[idx];
+    return result;
+}
+// ── Helper constructors ────────────────────────────────────────
+/** Create a writable, signer account meta. @since 1.1.0 */
+export function writableSigner(pubkey) {
+    return { pubkey, isSigner: true, isWritable: true };
+}
+/** Create a writable, non-signer account meta. @since 1.1.0 */
+export function writable(pubkey) {
+    return { pubkey, isSigner: false, isWritable: true };
+}
+/** Create a read-only, signer account meta. @since 1.1.0 */
+export function readonlySigner(pubkey) {
+    return { pubkey, isSigner: true, isWritable: false };
+}
+/** Create a read-only, non-signer account meta. @since 1.1.0 */
+export function readonly(pubkey) {
+    return { pubkey, isSigner: false, isWritable: false };
+}
+//# sourceMappingURL=types.js.map

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oobe-protocol-labs/synapse-client-sdk",
-  "version": "1.0.7",
+  "version": "1.2.0",
   "description": "Synapse Client SDK -- Typed Solana RPC gateway with @solana/kit native types, 53 JSON-RPC methods, DAS, WebSocket, gRPC/Geyser parser, signers/wallets, and AI agent tooling (LangChain, x402) | Powered by oobeprotocol.ai (OOBE)",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -115,6 +115,46 @@
       "types": "./dist/esm/accounts/index.d.ts",
       "import": "./dist/esm/accounts/index.js",
       "require": "./dist/cjs/accounts/index.js"
+    },
+    "./programs": {
+      "types": "./dist/esm/programs/index.d.ts",
+      "import": "./dist/esm/programs/index.js",
+      "require": "./dist/cjs/programs/index.js"
+    },
+    "./programs/system": {
+      "types": "./dist/esm/programs/system.d.ts",
+      "import": "./dist/esm/programs/system.js",
+      "require": "./dist/cjs/programs/system.js"
+    },
+    "./programs/spl-token": {
+      "types": "./dist/esm/programs/spl-token.d.ts",
+      "import": "./dist/esm/programs/spl-token.js",
+      "require": "./dist/cjs/programs/spl-token.js"
+    },
+    "./programs/associated-token": {
+      "types": "./dist/esm/programs/associated-token.d.ts",
+      "import": "./dist/esm/programs/associated-token.js",
+      "require": "./dist/cjs/programs/associated-token.js"
+    },
+    "./programs/memo": {
+      "types": "./dist/esm/programs/memo.d.ts",
+      "import": "./dist/esm/programs/memo.js",
+      "require": "./dist/cjs/programs/memo.js"
+    },
+    "./programs/compute-budget": {
+      "types": "./dist/esm/programs/compute-budget.d.ts",
+      "import": "./dist/esm/programs/compute-budget.js",
+      "require": "./dist/cjs/programs/compute-budget.js"
+    },
+    "./programs/types": {
+      "types": "./dist/esm/programs/types.d.ts",
+      "import": "./dist/esm/programs/types.js",
+      "require": "./dist/cjs/programs/types.js"
+    },
+    "./context": {
+      "types": "./dist/esm/context/index.d.ts",
+      "import": "./dist/esm/context/index.js",
+      "require": "./dist/cjs/context/index.js"
     }
   },
   "files": [