@fuel-ts/account 0.0.0-rc-1962-20240328175938 → 0.0.0-rc-1895-20240329092733

package/dist/providers/transaction-response/transaction-response.d.ts.map

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

package/dist/providers/utils/extract-tx-error.d.ts

@@ -0,0 +1,30 @@
+import { FuelError } from '@fuel-ts/errors';
+import type { GqlTransactionStatusFragmentFragment } from '../__generated__/operations';
+import type { TransactionResultReceipt } from '../transaction-response';
+import type { FailureStatus } from '../transaction-summary';
+/**
+ * Assembles an error message for a panic status.
+ * @param status - The transaction failure status.
+ * @returns The error message.
+ */
+export declare const assemblePanicError: (status: FailureStatus) => string;
+/**
+ * Assembles an error message for a revert status.
+ * @param receipts - The transaction result processed receipts.
+ * @param logs - The transaction decoded logs.
+ * @returns The error message.
+ */
+export declare const assembleRevertError: (receipts: Array<TransactionResultReceipt>, logs: Array<unknown>) => string;
+interface IExtractTxError {
+    receipts: Array<TransactionResultReceipt>;
+    status?: GqlTransactionStatusFragmentFragment | null;
+    logs: Array<unknown>;
+}
+/**
+ * Extracts the transaction error and returns a FuelError object.
+ * @param IExtractTxError - The parameters for extracting the error.
+ * @returns The FuelError object.
+ */
+export declare const extractTxError: (params: IExtractTxError) => FuelError;
+export {};
+//# sourceMappingURL=extract-tx-error.d.ts.map

package/dist/providers/utils/extract-tx-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-tx-error.d.ts","sourceRoot":"","sources":["../../../src/providers/utils/extract-tx-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAcvD,OAAO,KAAK,EAAE,oCAAoC,EAAE,MAAM,6BAA6B,CAAC;AACxF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,WAAY,aAAa,WAQvD,CAAC;AAKF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,aACpB,MAAM,wBAAwB,CAAC,QACnC,MAAM,OAAO,CAAC,WA+CrB,CAAC;AAEF,UAAU,eAAe;IACvB,QAAQ,EAAE,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC1C,MAAM,CAAC,EAAE,oCAAoC,GAAG,IAAI,CAAC;IACrD,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACtB;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,WAAY,eAAe,KAAG,SAcxD,CAAC"}

package/dist/providers/utils/index.d.ts

@@ -3,4 +3,5 @@ export * from './block-explorer';
 export * from './gas';
 export * from './json';
 export * from './sleep';
+export * from './extract-tx-error';
 //# sourceMappingURL=index.d.ts.map

package/dist/providers/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,OAAO,CAAC;AACtB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,OAAO,CAAC;AACtB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,oBAAoB,CAAC"}

package/dist/test-utils.global.js

@@ -42424,7 +42424,60 @@ ${MessageCoinFragmentFragmentDoc}`;
   var MAX_SCRIPT_DATA_LENGTH = 1024 * 1024 * 1024;
   var MAX_PREDICATE_LENGTH = 1024 * 1024;
   var MAX_PREDICATE_DATA_LENGTH = 1024 * 1024;
+  var FAILED_REQUIRE_SIGNAL = "0xffffffffffff0000";
   var FAILED_TRANSFER_TO_ADDRESS_SIGNAL = "0xffffffffffff0001";
+  var FAILED_ASSERT_EQ_SIGNAL = "0xffffffffffff0003";
+  var FAILED_ASSERT_SIGNAL = "0xffffffffffff0004";
+  var FAILED_ASSERT_NE_SIGNAL = "0xffffffffffff0005";
+  var PANIC_REASONS = [
+    "UnknownPanicReason",
+    "Revert",
+    "OutOfGas",
+    "TransactionValidity",
+    "MemoryOverflow",
+    "ArithmeticOverflow",
+    "ContractNotFound",
+    "MemoryOwnership",
+    "NotEnoughBalance",
+    "ExpectedInternalContext",
+    "AssetIdNotFound",
+    "InputNotFound",
+    "OutputNotFound",
+    "WitnessNotFound",
+    "TransactionMaturity",
+    "InvalidMetadataIdentifier",
+    "MalformedCallStructure",
+    "ReservedRegisterNotWritable",
+    "InvalidFlags",
+    "InvalidImmediateValue",
+    "ExpectedCoinInput",
+    "EcalError",
+    "MemoryWriteOverlap",
+    "ContractNotInInputs",
+    "InternalBalanceOverflow",
+    "ContractMaxSize",
+    "ExpectedUnallocatedStack",
+    "MaxStaticContractsReached",
+    "TransferAmountCannotBeZero",
+    "ExpectedOutputVariable",
+    "ExpectedParentInternalContext",
+    "PredicateReturnedNonOne",
+    "ContractIdAlreadyDeployed",
+    "ContractMismatch",
+    "MessageDataTooLong",
+    "ArithmeticError",
+    "ContractInstructionNotAllowed",
+    "TransferZeroCoins",
+    "InvalidInstruction",
+    "MemoryNotExecutable",
+    "PolicyIsNotSet",
+    "PolicyNotFound",
+    "TooManyReceipts",
+    "BalanceOverflow",
+    "InvalidBlockHeight",
+    "TooManySlots"
+  ];
+  var PANIC_DOC_URL = "https://docs.rs/fuel-asm/latest/fuel_asm/enum.PanicReason.html";
 
   // src/providers/utils/receipts.ts
   var doesReceiptHaveMissingOutputVariables = (receipt) => receipt.type === ReceiptType.Revert && receipt.val.toString("hex") === FAILED_TRANSFER_TO_ADDRESS_SIGNAL;
@@ -42737,6 +42790,64 @@ ${MessageCoinFragmentFragmentDoc}`;
     });
   }
 
+  // src/providers/utils/extract-tx-error.ts
+  var assemblePanicError = (status) => {
+    let errorMessage = `The transaction reverted with reason: "${status.reason}".`;
+    if (PANIC_REASONS.includes(status.reason)) {
+      errorMessage = `${errorMessage}
+
+You can read more about this error at:
+
+${PANIC_DOC_URL}#variant.${status.reason}`;
+    }
+    return errorMessage;
+  };
+  var stringify2 = (obj) => JSON.stringify(obj, null, 2);
+  var assembleRevertError = (receipts, logs) => {
+    let errorMessage = "The transaction reverted with an unknown reason.";
+    const revertReceipt = receipts.find(({ type: type3 }) => type3 === ReceiptType.Revert);
+    if (revertReceipt) {
+      const reasonHex = bn(revertReceipt.val).toHex();
+      switch (reasonHex) {
+        case FAILED_REQUIRE_SIGNAL: {
+          errorMessage = `The transaction reverted because a "require" statement has thrown ${logs.length ? stringify2(logs[0]) : "an error."}.`;
+          break;
+        }
+        case FAILED_ASSERT_EQ_SIGNAL: {
+          const sufix = logs.length >= 2 ? ` comparing ${stringify2(logs[1])} and ${stringify2(logs[0])}.` : ".";
+          errorMessage = `The transaction reverted because of an "assert_eq" statement${sufix}`;
+          break;
+        }
+        case FAILED_ASSERT_NE_SIGNAL: {
+          const sufix = logs.length >= 2 ? ` comparing ${stringify2(logs[1])} and ${stringify2(logs[0])}.` : ".";
+          errorMessage = `The transaction reverted because of an "assert_ne" statement${sufix}`;
+          break;
+        }
+        case FAILED_ASSERT_SIGNAL:
+          errorMessage = `The transaction reverted because an "assert" statement failed to evaluate to true.`;
+          break;
+        case FAILED_TRANSFER_TO_ADDRESS_SIGNAL:
+          errorMessage = `The transaction reverted because it's missing an "OutputChange".`;
+          break;
+        default:
+          errorMessage = `The transaction reverted with an unknown reason: ${revertReceipt.val}`;
+      }
+    }
+    return errorMessage;
+  };
+  var extractTxError = (params) => {
+    const { receipts, status, logs } = params;
+    const isPanic = receipts.some(({ type: type3 }) => type3 === ReceiptType.Panic);
+    let err = status?.type === "FailureStatus" && isPanic ? assemblePanicError(status) : assembleRevertError(receipts, logs);
+    err += `
+
+logs: ${JSON.stringify(logs, null, 2)}`;
+    err += `
+
+receipts: ${JSON.stringify(receipts, null, 2)}`;
+    return new FuelError(ErrorCode.SCRIPT_REVERTED, err);
+  };
+
   // src/providers/transaction-request/errors.ts
   var NoWitnessAtIndexError = class extends Error {
     constructor(index) {
@@ -44494,14 +44605,26 @@ ${MessageCoinFragmentFragmentDoc}`;
         gqlTransaction: this.gqlTransaction,
         ...transactionSummary
       };
+      let logs = [];
       if (this.abis) {
-        const logs = getDecodedLogs(
+        logs = getDecodedLogs(
           transactionSummary.receipts,
           this.abis.main,
           this.abis.otherContractsAbis
         );
         transactionResult.logs = logs;
       }
+      if (transactionResult.isStatusFailure) {
+        const {
+          receipts,
+          gqlTransaction: { status }
+        } = transactionResult;
+        throw extractTxError({
+          receipts,
+          status,
+          logs
+        });
+      }
       return transactionResult;
     }
     /**
@@ -44510,14 +44633,7 @@ ${MessageCoinFragmentFragmentDoc}`;
      * @param contractsAbiMap - The contracts ABI map.
      */
     async wait(contractsAbiMap) {
-      const result = await this.waitForResult(contractsAbiMap);
-      if (result.isStatusFailure) {
-        throw new FuelError(
-          ErrorCode.TRANSACTION_FAILED,
-          `Transaction failed: ${result.gqlTransaction.status.reason}`
-        );
-      }
-      return result;
+      return this.waitForResult(contractsAbiMap);
     }
   };