lfx-reward-back-sdk 0.1.0 → 1.0.0

package/dist/client.d.ts

@@ -41,10 +41,19 @@ export declare class LfxRewardBackClient {
     /**
      * Admin: withdraw_tokens
      *
-     * Withdraw from vault to the configured withdrawal_wallet's ATA.
-     * Caller must pass the recipient ATA (for withdrawal_wallet).
+     * Low-level instruction builder. Use buildWithdrawTokensIxs for automatic ATA creation.
      */
     withdrawTokensIx(recipientTokenAccount: web3.PublicKey, tokenMint: web3.PublicKey, amount: bigint | number): web3.TransactionInstruction;
+    /**
+     * Admin: withdraw_tokens (high-level helper)
+     *
+     * Automatically calculates withdrawal wallet's ATA and includes ATA creation instruction if needed.
+     * Reads withdrawal_wallet from GlobalInfo and derives its ATA for the token mint.
+     */
+    buildWithdrawTokensIxs(withdrawalWallet: web3.PublicKey, tokenMint: web3.PublicKey, amount: bigint | number): Promise<{
+        ixs: web3.TransactionInstruction[];
+        recipientTokenAccount: web3.PublicKey;
+    }>;
     /**
      * Admin: start_withdrawal_vote
      */

package/dist/client.js

@@ -202,8 +202,7 @@ class LfxRewardBackClient {
     /**
      * Admin: withdraw_tokens
      *
-     * Withdraw from vault to the configured withdrawal_wallet's ATA.
-     * Caller must pass the recipient ATA (for withdrawal_wallet).
+     * Low-level instruction builder. Use buildWithdrawTokensIxs for automatic ATA creation.
      */
     withdrawTokensIx(recipientTokenAccount, tokenMint, amount) {
         const [globalInfoPda] = this.getGlobalInfoPDA();
@@ -227,6 +226,27 @@ class LfxRewardBackClient {
             data,
         });
     }
+    /**
+     * Admin: withdraw_tokens (high-level helper)
+     *
+     * Automatically calculates withdrawal wallet's ATA and includes ATA creation instruction if needed.
+     * Reads withdrawal_wallet from GlobalInfo and derives its ATA for the token mint.
+     */
+    async buildWithdrawTokensIxs(withdrawalWallet, tokenMint, amount) {
+        const ixs = [];
+        // Automatically calculate withdrawal wallet's ATA
+        const recipientTokenAccount = await (0, spl_token_1.getAssociatedTokenAddress)(tokenMint, withdrawalWallet, false, spl_token_1.TOKEN_2022_PROGRAM_ID, spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID);
+        // Ensure ATA exists (processed commitment for fast UX)
+        const ataInfo = await this.connection.getAccountInfo(recipientTokenAccount, 'processed');
+        if (!ataInfo) {
+            ixs.push((0, spl_token_1.createAssociatedTokenAccountInstruction)(this.wallet.publicKey, // payer (admin)
+            recipientTokenAccount, withdrawalWallet, // owner
+            tokenMint, spl_token_1.TOKEN_2022_PROGRAM_ID, spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID));
+        }
+        // Append withdraw_tokens ix
+        ixs.push(this.withdrawTokensIx(recipientTokenAccount, tokenMint, amount));
+        return { ixs, recipientTokenAccount };
+    }
     /**
      * Admin: start_withdrawal_vote
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lfx-reward-back-sdk",
-  "version": "0.1.0",
+  "version": "1.0.0",
   "description": "SDK for LFX Reward (Admin/Backoffice)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",