@fuel-ts/account 0.0.0-rc-1356-20240520180710 → 0.0.0-rc-2333-20240520180734

package/dist/index.mjs

@@ -1714,6 +1714,15 @@ function normalizeJSON(root) {
   return normalize(clone(root));
 }
 
+// src/providers/utils/sleep.ts
+function sleep(time) {
+  return new Promise((resolve) => {
+    setTimeout(() => {
+      resolve(true);
+    }, time);
+  });
+}
+
 // src/providers/utils/extract-tx-error.ts
 import { ErrorCode as ErrorCode7, FuelError as FuelError7 } from "@fuel-ts/errors";
 import { bn as bn6 } from "@fuel-ts/math";
@@ -3739,7 +3748,6 @@ var TransactionResponse = class {
 };
 
 // src/providers/utils/auto-retry-fetch.ts
-import { sleep } from "@fuel-ts/utils";
 function getWaitDelay(options, retryAttemptNum) {
   const duration = options.baseDelay ?? 150;
   switch (options.backoff) {
@@ -5484,19 +5492,8 @@ var Account = class extends AbstractAccount {
    */
   async createTransfer(destination, amount, assetId, txParams = {}) {
     let request = new ScriptTransactionRequest(txParams);
-    const assetIdToTransfer = assetId ?? this.provider.getBaseAssetId();
-    request.addCoinOutput(Address3.fromAddressOrString(destination), amount, assetIdToTransfer);
-    const txCost = await this.provider.getTransactionCost(request, {
-      estimateTxDependencies: true,
-      resourcesOwner: this
-    });
-    request = this.validateGasLimitAndMaxFee({
-      transactionRequest: request,
-      gasUsed: txCost.gasUsed,
-      maxFee: txCost.maxFee,
-      txParams
-    });
-    await this.fund(request, txCost);
+    request = this.addTransfer(request, { destination, amount, assetId });
+    request = await this.estimateAndFundTransaction(request, txParams);
     return request;
   }
   /**
@@ -5509,16 +5506,57 @@ var Account = class extends AbstractAccount {
    * @returns A promise that resolves to the transaction response.
    */
   async transfer(destination, amount, assetId, txParams = {}) {
-    if (bn19(amount).lte(0)) {
-      throw new FuelError15(
-        ErrorCode15.INVALID_TRANSFER_AMOUNT,
-        "Transfer amount must be a positive number."
-      );
-    }
-    const assetIdToTransfer = assetId ?? this.provider.getBaseAssetId();
-    const request = await this.createTransfer(destination, amount, assetIdToTransfer, txParams);
+    const request = await this.createTransfer(destination, amount, assetId, txParams);
     return this.sendTransaction(request, { estimateTxDependencies: false });
   }
+  /**
+   * Transfers multiple amounts of a token to multiple recipients.
+   *
+   * @param transferParams - An array of `TransferParams` objects representing the transfers to be made.
+   * @param txParams - Optional transaction parameters.
+   * @returns A promise that resolves to a `TransactionResponse` object representing the transaction result.
+   */
+  async batchTransfer(transferParams, txParams = {}) {
+    let request = new ScriptTransactionRequest(txParams);
+    request = this.addBatchTransfer(request, transferParams);
+    request = await this.estimateAndFundTransaction(request, txParams);
+    return this.sendTransaction(request, { estimateTxDependencies: false });
+  }
+  /**
+   * Adds a transfer to the given transaction request.
+   *
+   * @param request - The script transaction request to add transfers to.
+   * @param transferParams - The object representing the transfer to be made.
+   * @returns The updated transaction request with the added transfer.
+   */
+  addTransfer(request, transferParams) {
+    const { destination, amount, assetId } = transferParams;
+    this.validateTransferAmount(amount);
+    request.addCoinOutput(
+      Address3.fromAddressOrString(destination),
+      amount,
+      assetId ?? this.provider.getBaseAssetId()
+    );
+    return request;
+  }
+  /**
+   * Adds multiple transfers to a script transaction request.
+   *
+   * @param request - The script transaction request to add transfers to.
+   * @param transferParams - An array of `TransferParams` objects representing the transfers to be made.
+   * @returns The updated script transaction request.
+   */
+  addBatchTransfer(request, transferParams) {
+    const baseAssetId = this.provider.getBaseAssetId();
+    transferParams.forEach(({ destination, amount, assetId }) => {
+      this.addTransfer(request, {
+        destination,
+        amount,
+        assetId: assetId ?? baseAssetId
+      });
+    });
+    return request;
+  }
   /**
    * Transfers coins to a contract address.
    *
@@ -5596,6 +5634,7 @@ var Account = class extends AbstractAccount {
     await this.fund(request, txCost);
     return this.sendTransaction(request);
   }
+  /** @hidden * */
   async signMessage(message) {
     if (!this._connector) {
       throw new FuelError15(ErrorCode15.MISSING_CONNECTOR, "A connector is required to sign messages.");
@@ -5651,6 +5690,31 @@ var Account = class extends AbstractAccount {
     }
     return this.provider.simulate(transactionRequest, { estimateTxDependencies: false });
   }
+  /** @hidden * */
+  validateTransferAmount(amount) {
+    if (bn19(amount).lte(0)) {
+      throw new FuelError15(
+        ErrorCode15.INVALID_TRANSFER_AMOUNT,
+        "Transfer amount must be a positive number."
+      );
+    }
+  }
+  /** @hidden * */
+  async estimateAndFundTransaction(transactionRequest, txParams) {
+    let request = transactionRequest;
+    const txCost = await this.provider.getTransactionCost(request, {
+      resourcesOwner: this
+    });
+    request = this.validateGasLimitAndMaxFee({
+      transactionRequest: request,
+      gasUsed: txCost.gasUsed,
+      maxFee: txCost.maxFee,
+      txParams
+    });
+    request = await this.fund(request, txCost);
+    return request;
+  }
+  /** @hidden * */
   validateGasLimitAndMaxFee({
     gasUsed,
     maxFee,
@@ -10134,6 +10198,7 @@ export {
   resolveGasDependentCosts,
   resolveIconPaths,
   returnZeroScript,
+  sleep,
   transactionRequestify,
   urlJoin,
   withTimeout,