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

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

@@ -0,0 +1,355 @@
+/**
+ * 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.js';
+import { InstructionWriter, writableSigner, writable, readonly, readonlySigner } from './types.js';
+// ── Program IDs ────────────────────────────────────────────────
+/**
+ * SPL Token Program v1 address.
+ * @since 1.1.0
+ */
+export const TOKEN_PROGRAM = Pubkey('TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA');
+/**
+ * SPL Token-2022 (Token Extensions) Program address.
+ * @since 1.1.0
+ */
+export const TOKEN_2022_PROGRAM = Pubkey('TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb');
+// ── Sysvar ─────────────────────────────────────────────────────
+/** @internal */
+const RENT_SYSVAR = Pubkey('SysvarRent111111111111111111111111111111111');
+// ── Helpers ────────────────────────────────────────────────────
+/** @internal Build owner key(s) — single signer or multisig */
+function ownerKeys(owner, multiSigners, ownerWritable = false) {
+    if (multiSigners && multiSigners.length > 0) {
+        return [
+            ownerWritable ? writable(owner) : readonly(owner),
+            ...multiSigners.map(s => readonlySigner(s)),
+        ];
+    }
+    return [ownerWritable ? writableSigner(owner) : readonlySigner(owner)];
+}
+// ── SplToken namespace ─────────────────────────────────────────
+/**
+ * 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 const SplToken = {
+    /** SPL Token v1 program ID. */
+    programId: TOKEN_PROGRAM,
+    /** Token-2022 program ID. */
+    token2022ProgramId: TOKEN_2022_PROGRAM,
+    /**
+     * Initialize a new token mint.
+     * @since 1.1.0
+     */
+    initializeMint(p) {
+        const pid = p.programId ?? TOKEN_PROGRAM;
+        const hasFreezeAuth = p.freezeAuthority != null;
+        const w = new InstructionWriter(67);
+        w.u8(0 /* TokenIx.InitializeMint */);
+        w.u8(p.decimals);
+        w.pubkey(p.mintAuthority);
+        w.u8(hasFreezeAuth ? 1 : 0); // COption tag
+        if (hasFreezeAuth) {
+            w.pubkey(p.freezeAuthority);
+        }
+        else {
+            w.raw(new Uint8Array(32)); // padding
+        }
+        return {
+            programId: pid,
+            keys: [writable(p.mint), readonly(RENT_SYSVAR)],
+            data: w.toBytes(),
+        };
+    },
+    /**
+     * Initialize a token account for a given mint and owner.
+     * @since 1.1.0
+     */
+    initializeAccount(p) {
+        const pid = p.programId ?? TOKEN_PROGRAM;
+        const w = new InstructionWriter(1);
+        w.u8(1 /* TokenIx.InitializeAccount */);
+        return {
+            programId: pid,
+            keys: [
+                writable(p.account),
+                readonly(p.mint),
+                readonly(p.owner),
+                readonly(RENT_SYSVAR),
+            ],
+            data: w.toBytes(),
+        };
+    },
+    /**
+     * Transfer tokens (unchecked — no decimal verification).
+     * Prefer {@link transferChecked} for safety.
+     * @since 1.1.0
+     */
+    transfer(p) {
+        const pid = p.programId ?? TOKEN_PROGRAM;
+        const w = new InstructionWriter(9);
+        w.u8(3 /* TokenIx.Transfer */);
+        w.u64(p.amount);
+        return {
+            programId: pid,
+            keys: [
+                writable(p.source),
+                writable(p.destination),
+                ...ownerKeys(p.owner, p.multiSigners),
+            ],
+            data: w.toBytes(),
+        };
+    },
+    /**
+     * Transfer tokens with decimal verification (recommended).
+     * @since 1.1.0
+     */
+    transferChecked(p) {
+        const pid = p.programId ?? TOKEN_PROGRAM;
+        const w = new InstructionWriter(10);
+        w.u8(12 /* TokenIx.TransferChecked */);
+        w.u64(p.amount);
+        w.u8(p.decimals);
+        return {
+            programId: pid,
+            keys: [
+                writable(p.source),
+                readonly(p.mint),
+                writable(p.destination),
+                ...ownerKeys(p.owner, p.multiSigners),
+            ],
+            data: w.toBytes(),
+        };
+    },
+    /**
+     * Approve a delegate to spend tokens from the account.
+     * @since 1.1.0
+     */
+    approve(p) {
+        const pid = p.programId ?? TOKEN_PROGRAM;
+        const w = new InstructionWriter(9);
+        w.u8(4 /* TokenIx.Approve */);
+        w.u64(p.amount);
+        return {
+            programId: pid,
+            keys: [
+                writable(p.account),
+                readonly(p.delegate),
+                ...ownerKeys(p.owner, p.multiSigners),
+            ],
+            data: w.toBytes(),
+        };
+    },
+    /**
+     * Approve a delegate with decimal verification.
+     * @since 1.1.0
+     */
+    approveChecked(p) {
+        const pid = p.programId ?? TOKEN_PROGRAM;
+        const w = new InstructionWriter(10);
+        w.u8(13 /* TokenIx.ApproveChecked */);
+        w.u64(p.amount);
+        w.u8(p.decimals);
+        return {
+            programId: pid,
+            keys: [
+                writable(p.account),
+                readonly(p.mint),
+                readonly(p.delegate),
+                ...ownerKeys(p.owner, p.multiSigners),
+            ],
+            data: w.toBytes(),
+        };
+    },
+    /**
+     * Revoke a previously approved delegate.
+     * @since 1.1.0
+     */
+    revoke(p) {
+        const pid = p.programId ?? TOKEN_PROGRAM;
+        const w = new InstructionWriter(1);
+        w.u8(5 /* TokenIx.Revoke */);
+        return {
+            programId: pid,
+            keys: [writable(p.account), ...ownerKeys(p.owner, p.multiSigners)],
+            data: w.toBytes(),
+        };
+    },
+    /**
+     * Mint new tokens to a destination account.
+     * @since 1.1.0
+     */
+    mintTo(p) {
+        const pid = p.programId ?? TOKEN_PROGRAM;
+        const w = new InstructionWriter(9);
+        w.u8(7 /* TokenIx.MintTo */);
+        w.u64(p.amount);
+        return {
+            programId: pid,
+            keys: [
+                writable(p.mint),
+                writable(p.destination),
+                ...ownerKeys(p.authority, p.multiSigners),
+            ],
+            data: w.toBytes(),
+        };
+    },
+    /**
+     * Mint new tokens with decimal verification.
+     * @since 1.1.0
+     */
+    mintToChecked(p) {
+        const pid = p.programId ?? TOKEN_PROGRAM;
+        const w = new InstructionWriter(10);
+        w.u8(14 /* TokenIx.MintToChecked */);
+        w.u64(p.amount);
+        w.u8(p.decimals);
+        return {
+            programId: pid,
+            keys: [
+                writable(p.mint),
+                writable(p.destination),
+                ...ownerKeys(p.authority, p.multiSigners),
+            ],
+            data: w.toBytes(),
+        };
+    },
+    /**
+     * Burn tokens from an account.
+     * @since 1.1.0
+     */
+    burn(p) {
+        const pid = p.programId ?? TOKEN_PROGRAM;
+        const w = new InstructionWriter(9);
+        w.u8(8 /* TokenIx.Burn */);
+        w.u64(p.amount);
+        return {
+            programId: pid,
+            keys: [
+                writable(p.account),
+                writable(p.mint),
+                ...ownerKeys(p.owner, p.multiSigners),
+            ],
+            data: w.toBytes(),
+        };
+    },
+    /**
+     * Burn tokens with decimal verification.
+     * @since 1.1.0
+     */
+    burnChecked(p) {
+        const pid = p.programId ?? TOKEN_PROGRAM;
+        const w = new InstructionWriter(10);
+        w.u8(15 /* TokenIx.BurnChecked */);
+        w.u64(p.amount);
+        w.u8(p.decimals);
+        return {
+            programId: pid,
+            keys: [
+                writable(p.account),
+                writable(p.mint),
+                ...ownerKeys(p.owner, p.multiSigners),
+            ],
+            data: w.toBytes(),
+        };
+    },
+    /**
+     * Close a token account, reclaiming SOL rent.
+     * @since 1.1.0
+     */
+    closeAccount(p) {
+        const pid = p.programId ?? TOKEN_PROGRAM;
+        const w = new InstructionWriter(1);
+        w.u8(9 /* TokenIx.CloseAccount */);
+        return {
+            programId: pid,
+            keys: [
+                writable(p.account),
+                writable(p.destination),
+                ...ownerKeys(p.owner, p.multiSigners),
+            ],
+            data: w.toBytes(),
+        };
+    },
+    /**
+     * Freeze a token account (prevents transfers).
+     * @since 1.1.0
+     */
+    freezeAccount(p) {
+        const pid = p.programId ?? TOKEN_PROGRAM;
+        const w = new InstructionWriter(1);
+        w.u8(10 /* TokenIx.FreezeAccount */);
+        return {
+            programId: pid,
+            keys: [
+                writable(p.account),
+                readonly(p.mint),
+                ...ownerKeys(p.authority, p.multiSigners),
+            ],
+            data: w.toBytes(),
+        };
+    },
+    /**
+     * Thaw a previously frozen token account.
+     * @since 1.1.0
+     */
+    thawAccount(p) {
+        const pid = p.programId ?? TOKEN_PROGRAM;
+        const w = new InstructionWriter(1);
+        w.u8(11 /* TokenIx.ThawAccount */);
+        return {
+            programId: pid,
+            keys: [
+                writable(p.account),
+                readonly(p.mint),
+                ...ownerKeys(p.authority, p.multiSigners),
+            ],
+            data: w.toBytes(),
+        };
+    },
+    /**
+     * Sync the lamport balance of a native SOL token account.
+     * @since 1.1.0
+     */
+    syncNative(p) {
+        const pid = p.programId ?? TOKEN_PROGRAM;
+        const w = new InstructionWriter(1);
+        w.u8(17 /* TokenIx.SyncNative */);
+        return {
+            programId: pid,
+            keys: [writable(p.account)],
+            data: w.toBytes(),
+        };
+    },
+};
+//# sourceMappingURL=spl-token.js.map

package/dist/esm/programs/spl-token.js.map

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

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

@@ -0,0 +1,231 @@
+/**
+ * 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';
+import type { Lamports } from '../core/types';
+import type { TransactionInstruction } from './types';
+/**
+ * System Program address.
+ * @since 1.1.0
+ */
+export declare const SYSTEM_PROGRAM: never;
+/**
+ * Params for {@link SystemProgram.transfer}.
+ * @since 1.1.0
+ */
+export interface TransferParams {
+    /** Funding account (signer). */
+    from: Pubkey;
+    /** Recipient account. */
+    to: Pubkey;
+    /** Amount in lamports. */
+    lamports: Lamports | bigint;
+}
+/**
+ * Params for {@link SystemProgram.createAccount}.
+ * @since 1.1.0
+ */
+export interface CreateAccountParams {
+    /** Funding account (signer). */
+    from: Pubkey;
+    /** New account (signer). */
+    newAccount: Pubkey;
+    /** Lamports to transfer to the new account. */
+    lamports: Lamports | bigint;
+    /** Space in bytes to allocate for account data. */
+    space: number;
+    /** Program owner of the new account. */
+    programId: Pubkey;
+}
+/**
+ * Params for {@link SystemProgram.assign}.
+ * @since 1.1.0
+ */
+export interface AssignParams {
+    /** Account to assign (signer). */
+    account: Pubkey;
+    /** New program owner. */
+    programId: Pubkey;
+}
+/**
+ * Params for {@link SystemProgram.allocate}.
+ * @since 1.1.0
+ */
+export interface AllocateParams {
+    /** Account to allocate space for (signer). */
+    account: Pubkey;
+    /** Space in bytes. */
+    space: number;
+}
+/**
+ * Params for {@link SystemProgram.createAccountWithSeed}.
+ * @since 1.1.0
+ */
+export interface CreateAccountWithSeedParams {
+    /** Funding account (signer). */
+    from: Pubkey;
+    /** Created account (derived from base + seed + programId). */
+    newAccount: Pubkey;
+    /** Base address for seed derivation (signer). */
+    base: Pubkey;
+    /** Seed string (max 32 bytes UTF-8). */
+    seed: string;
+    /** Lamports to fund. */
+    lamports: Lamports | bigint;
+    /** Data space in bytes. */
+    space: number;
+    /** Owner program of the new account. */
+    programId: Pubkey;
+}
+/**
+ * Params for {@link SystemProgram.advanceNonce}.
+ * @since 1.1.0
+ */
+export interface AdvanceNonceParams {
+    /** Nonce account. */
+    nonceAccount: Pubkey;
+    /** Nonce authority (signer). */
+    authority: Pubkey;
+}
+/**
+ * Params for {@link SystemProgram.withdrawNonce}.
+ * @since 1.1.0
+ */
+export interface WithdrawNonceParams {
+    /** Nonce account. */
+    nonceAccount: Pubkey;
+    /** Nonce authority (signer). */
+    authority: Pubkey;
+    /** Destination for withdrawn lamports. */
+    to: Pubkey;
+    /** Amount to withdraw. */
+    lamports: Lamports | bigint;
+}
+/**
+ * Params for {@link SystemProgram.initializeNonce}.
+ * @since 1.1.0
+ */
+export interface InitializeNonceParams {
+    /** Nonce account (must be already allocated). */
+    nonceAccount: Pubkey;
+    /** Nonce authority. */
+    authority: Pubkey;
+}
+/**
+ * Params for {@link SystemProgram.authorizeNonce}.
+ * @since 1.1.0
+ */
+export interface AuthorizeNonceParams {
+    /** Nonce account. */
+    nonceAccount: Pubkey;
+    /** Current authority (signer). */
+    authority: Pubkey;
+    /** New authority. */
+    newAuthority: Pubkey;
+}
+/**
+ * System Program instruction encoders.
+ *
+ * Static methods produce {@link TransactionInstruction} objects for the
+ * native Solana System Program.
+ *
+ * @since 1.1.0
+ */
+export declare const SystemProgram: {
+    /** System Program address. */
+    readonly programId: never;
+    /**
+     * Transfer SOL between two accounts.
+     *
+     * @param p - Transfer parameters.
+     * @returns Encoded instruction.
+     * @since 1.1.0
+     */
+    readonly transfer: (p: TransferParams) => TransactionInstruction;
+    /**
+     * Create a new account with allocated space and program owner.
+     *
+     * @param p - CreateAccount parameters.
+     * @returns Encoded instruction.
+     * @since 1.1.0
+     */
+    readonly createAccount: (p: CreateAccountParams) => TransactionInstruction;
+    /**
+     * Assign an account to a program.
+     *
+     * @param p - Assign parameters.
+     * @returns Encoded instruction.
+     * @since 1.1.0
+     */
+    readonly assign: (p: AssignParams) => TransactionInstruction;
+    /**
+     * Allocate space for an account (without funding or assigning owner).
+     *
+     * @param p - Allocate parameters.
+     * @returns Encoded instruction.
+     * @since 1.1.0
+     */
+    readonly allocate: (p: AllocateParams) => TransactionInstruction;
+    /**
+     * Create account with a seed-derived address.
+     *
+     * @param p - CreateAccountWithSeed parameters.
+     * @returns Encoded instruction.
+     * @since 1.1.0
+     */
+    readonly createAccountWithSeed: (p: CreateAccountWithSeedParams) => TransactionInstruction;
+    /**
+     * Advance a durable nonce account.
+     *
+     * @param p - AdvanceNonce parameters.
+     * @returns Encoded instruction.
+     * @since 1.1.0
+     */
+    readonly advanceNonce: (p: AdvanceNonceParams) => TransactionInstruction;
+    /**
+     * Withdraw lamports from a nonce account.
+     *
+     * @param p - WithdrawNonce parameters.
+     * @returns Encoded instruction.
+     * @since 1.1.0
+     */
+    readonly withdrawNonce: (p: WithdrawNonceParams) => TransactionInstruction;
+    /**
+     * Initialize a nonce account (must be pre-allocated with SystemProgram.createAccount).
+     *
+     * @param p - InitializeNonce parameters.
+     * @returns Encoded instruction.
+     * @since 1.1.0
+     */
+    readonly initializeNonce: (p: InitializeNonceParams) => TransactionInstruction;
+    /**
+     * Change the authority of a nonce account.
+     *
+     * @param p - AuthorizeNonce parameters.
+     * @returns Encoded instruction.
+     * @since 1.1.0
+     */
+    readonly authorizeNonce: (p: AuthorizeNonceParams) => TransactionInstruction;
+};
+//# sourceMappingURL=system.d.ts.map

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

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