@unclaimedsol/spl-burn-close-sdk 1.1.0 → 1.2.0

package/dist/index.cjs

@@ -61,3 +61,38 @@ export async function buildBurnAndCloseTransactions(connection, programId, user,
     }
     return txs;
 }
+/**
+ * Build a single **TransactionInstruction** that calls the on-chain
+ * burn+close program for a specific Token Program (either SPL Token or Token-2022).
+ *
+ * Unlike `buildBurnAndCloseTransactions`, this helper does **not**
+ * create or sign full transactions — it only constructs one
+ * instruction for a batch of (mint, ATA) pairs.
+ */
+export async function buildBurnAndCloseInstruction(programId, user, pairs, tokenProgramId) {
+    if (!pairs.length) {
+        return null;
+    }
+    // instruction data selector: 0 = burn_and_close_token_accounts
+    const data = Buffer.from([0]);
+    // accounts order MUST match the on-chain program's expectation:
+    // [0] fee_payer_account (your fee recipient)
+    // [1] user_wallet_account (the signer)
+    // [2] token_program_account (SPL Token program or Token-2022 program)
+    // [3] system_program_account
+    // then repeating (mint, ata) pairs, both writable
+    const keys = [
+        { pubkey: FEE_RECIPIENT, isSigner: false, isWritable: true },
+        { pubkey: user, isSigner: true, isWritable: true },
+        { pubkey: tokenProgramId, isSigner: false, isWritable: false },
+        { pubkey: SystemProgram.programId, isSigner: false, isWritable: false },
+    ];
+    for (const { mint, ata } of pairs) {
+        keys.push({ pubkey: mint, isSigner: false, isWritable: true }, { pubkey: ata, isSigner: false, isWritable: true });
+    }
+    return new TransactionInstruction({
+        programId,
+        keys,
+        data,
+    });
+}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Connection, PublicKey, Transaction, Commitment } from "@solana/web3.js";
+import { Connection, PublicKey, Transaction, TransactionInstruction, Commitment } from "@solana/web3.js";
 /** Exporting on-chain program ID for convenience */
 export declare const PROGRAM_ID: PublicKey;
 /** Hardcoded fee recipient on-chain expectation */
@@ -37,3 +37,12 @@ export type BuildOptions = {
  * @returns               Array of *unsigned* Transaction objects
  */
 export declare function buildBurnAndCloseTransactions(connection: Connection, programId: PublicKey, user: PublicKey, pairs: Pair[], options?: BuildOptions, tokenProgramId?: PublicKey): Promise<Transaction[]>;
+/**
+ * Build a single **TransactionInstruction** that calls the on-chain
+ * burn+close program for a specific Token Program (either SPL Token or Token-2022).
+ *
+ * Unlike `buildBurnAndCloseTransactions`, this helper does **not**
+ * create or sign full transactions — it only constructs one
+ * instruction for a batch of (mint, ATA) pairs.
+ */
+export declare function buildBurnAndCloseInstruction(programId: PublicKey, user: PublicKey, pairs: Pair[], tokenProgramId: PublicKey): Promise<TransactionInstruction | null>;

package/dist/index.js

@@ -61,3 +61,38 @@ export async function buildBurnAndCloseTransactions(connection, programId, user,
     }
     return txs;
 }
+/**
+ * Build a single **TransactionInstruction** that calls the on-chain
+ * burn+close program for a specific Token Program (either SPL Token or Token-2022).
+ *
+ * Unlike `buildBurnAndCloseTransactions`, this helper does **not**
+ * create or sign full transactions — it only constructs one
+ * instruction for a batch of (mint, ATA) pairs.
+ */
+export async function buildBurnAndCloseInstruction(programId, user, pairs, tokenProgramId) {
+    if (!pairs.length) {
+        return null;
+    }
+    // instruction data selector: 0 = burn_and_close_token_accounts
+    const data = Buffer.from([0]);
+    // accounts order MUST match the on-chain program's expectation:
+    // [0] fee_payer_account (your fee recipient)
+    // [1] user_wallet_account (the signer)
+    // [2] token_program_account (SPL Token program or Token-2022 program)
+    // [3] system_program_account
+    // then repeating (mint, ata) pairs, both writable
+    const keys = [
+        { pubkey: FEE_RECIPIENT, isSigner: false, isWritable: true },
+        { pubkey: user, isSigner: true, isWritable: true },
+        { pubkey: tokenProgramId, isSigner: false, isWritable: false },
+        { pubkey: SystemProgram.programId, isSigner: false, isWritable: false },
+    ];
+    for (const { mint, ata } of pairs) {
+        keys.push({ pubkey: mint, isSigner: false, isWritable: true }, { pubkey: ata, isSigner: false, isWritable: true });
+    }
+    return new TransactionInstruction({
+        programId,
+        keys,
+        data,
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unclaimedsol/spl-burn-close-sdk",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "SDK to burn and close SPL token accounts via the Unclaimed SOL program (with a built-in 5% fee).",
   "license": "MIT",
   "author": "Unclaimed SOL",