@metamask-previews/transaction-controller 69.6.1-preview-4f4c98e → 69.6.1-preview-eb263b0ee

package/dist/utils/retry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.cjs","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":";;;AAAA,iEAAiE;AAEjE,2CAAwC;AAQxC;;;;;;;GAOG;AACH,SAAgB,uCAAuC,CACrD,yBAA4C,EAC5C,IAAY,EACZ,YAAqD;IAErD,MAAM,WAAW,GAAG,oBAAoB,CACtC,yBAAyB,EACzB,IAAI,EACJ,YAAY,CACb,CAAC;IAEF,MAAM,aAAa,GAAG,sBAAsB,CAC1C,yBAAyB,EACzB,IAAI,EACJ,YAAY,CACb,CAAC;IAEF,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,WAAW,GAAsB;YACrC,GAAG,yBAAyB;YAC5B,GAAG,aAAa;SACjB,CAAC;QAEF,OAAO,WAAW,CAAC,QAAQ,CAAC;QAE5B,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,WAAW,GAAsB;YACrC,GAAG,yBAAyB;YAC5B,QAAQ,EAAE,WAAW;SACtB,CAAC;QAEF,OAAO,WAAW,CAAC,YAAY,CAAC;QAChC,OAAO,WAAW,CAAC,oBAAoB,CAAC;QAExC,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,MAAM,IAAI,KAAK,CACb,8EAA8E,CAC/E,CAAC;AACJ,CAAC;AA3CD,0FA2CC;AAED;;;;;;;GAOG;AACH,SAAS,sBAAsB,CAC7B,yBAA4C,EAC5C,IAAY,EACZ,YAAqD;IAErD,IACE,YAAY;QACZ,cAAc,IAAI,YAAY;QAC9B,sBAAsB,IAAI,YAAY,EACtC,CAAC;QACD,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,MAAM,mBAAmB,GAAG,yBAAyB,CAAC,YAEzC,CAAC;IAEd,MAAM,2BAA2B,GAC/B,yBAAyB,CAAC,oBAAuC,CAAC;IAEpE,IACE,CAAC,mBAAmB;QACpB,CAAC,2BAA2B;QAC5B,mBAAmB,KAAK,KAAK;QAC7B,2BAA2B,KAAK,KAAK,EACrC,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,YAAY,GAAG,WAAW,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC;IAC5D,MAAM,oBAAoB,GAAG,WAAW,CAAC,2BAA2B,EAAE,IAAI,CAAC,CAAC;IAE5E,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,CAAC;AAChD,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,oBAAoB,CAC3B,yBAA4C,EAC5C,IAAY,EACZ,YAAqD;IAErD,IAAI,YAAY,IAAI,UAAU,IAAI,YAAY,EAAE,CAAC;QAC/C,OAAO,YAAY,CAAC,QAAe,CAAC;IACtC,CAAC;IAED,MAAM,eAAe,GAAG,yBAAyB,CAAC,QAA2B,CAAC;IAE9E,IAAI,CAAC,eAAe,IAAI,eAAe,KAAK,KAAK,EAAE,CAAC;QAClD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,WAAW,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;GAMG;AACH,SAAS,WAAW,CAAC,KAAsB,EAAE,UAAkB;IAC7D,MAAM,YAAY,GAAG,IAAA,sCAAmB,EAAC,KAAK,CAAC,CAAC;IAChD,MAAM,aAAa,GAAG,QAAQ,CAAC,GAAG,YAAY,GAAG,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;IAEnE,OAAO,IAAA,aAAK,EAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;AAC3C,CAAC","sourcesContent":["import { convertHexToDecimal } from '@metamask/controller-utils';\nimport type { Hex } from '@metamask/utils';\nimport { add0x } from '@metamask/utils';\n\nimport type {\n  FeeMarketEIP1559Values,\n  GasPriceValue,\n  TransactionParams,\n} from '../types.js';\n\n/**\n * Returns new transaction parameters with increased gas fees.\n *\n * @param originalTransactionParams - The original transaction parameters.\n * @param rate - The rate by which to increase the existing gas fee properties.\n * @param newGasValues - Optional new gas values to use instead of increased the existing values.\n * @returns The new transaction parameters with the increased gas fee properties.\n */\nexport function getTransactionParamsWithIncreasedGasFee(\n  originalTransactionParams: TransactionParams,\n  rate: number,\n  newGasValues?: GasPriceValue | FeeMarketEIP1559Values,\n): TransactionParams {\n  const newGasPrice = getIncreasedGasPrice(\n    originalTransactionParams,\n    rate,\n    newGasValues,\n  );\n\n  const new1559Values = getIncreased1559Values(\n    originalTransactionParams,\n    rate,\n    newGasValues,\n  );\n\n  if (new1559Values) {\n    const newTxParams: TransactionParams = {\n      ...originalTransactionParams,\n      ...new1559Values,\n    };\n\n    delete newTxParams.gasPrice;\n\n    return newTxParams;\n  }\n\n  if (newGasPrice) {\n    const newTxParams: TransactionParams = {\n      ...originalTransactionParams,\n      gasPrice: newGasPrice,\n    };\n\n    delete newTxParams.maxFeePerGas;\n    delete newTxParams.maxPriorityFeePerGas;\n\n    return newTxParams;\n  }\n\n  throw new Error(\n    'Cannot increase gas fee as no current values and no new values were provided',\n  );\n}\n\n/**\n * Generate the increased EIP-1559 gas properties.\n *\n * @param originalTransactionParams - The original transaction parameters.\n * @param rate - The rate by which to increase the existing gas fee properties.\n * @param newGasValues - Optional new gas values to use instead of increased the existing values.\n * @returns The new EIP-1559 gas properties.\n */\nfunction getIncreased1559Values(\n  originalTransactionParams: TransactionParams,\n  rate: number,\n  newGasValues?: GasPriceValue | FeeMarketEIP1559Values,\n): FeeMarketEIP1559Values | undefined {\n  if (\n    newGasValues &&\n    'maxFeePerGas' in newGasValues &&\n    'maxPriorityFeePerGas' in newGasValues\n  ) {\n    return newGasValues;\n  }\n\n  const currentMaxFeePerGas = originalTransactionParams.maxFeePerGas as\n    | Hex\n    | undefined;\n\n  const currentMaxPriorityFeePerGas =\n    originalTransactionParams.maxPriorityFeePerGas as Hex | undefined;\n\n  if (\n    !currentMaxFeePerGas ||\n    !currentMaxPriorityFeePerGas ||\n    currentMaxFeePerGas === '0x0' ||\n    currentMaxPriorityFeePerGas === '0x0'\n  ) {\n    return undefined;\n  }\n\n  const maxFeePerGas = multiplyHex(currentMaxFeePerGas, rate);\n  const maxPriorityFeePerGas = multiplyHex(currentMaxPriorityFeePerGas, rate);\n\n  return { maxFeePerGas, maxPriorityFeePerGas };\n}\n\n/**\n * Generate the increased gas price.\n *\n * @param originalTransactionParams - The original transaction parameters.\n * @param rate - The rate by which to increase the existing gas fee properties.\n * @param newGasValues - Optional new gas values to use instead of increased the existing values.\n * @returns The new gas price.\n */\nfunction getIncreasedGasPrice(\n  originalTransactionParams: TransactionParams,\n  rate: number,\n  newGasValues?: GasPriceValue | FeeMarketEIP1559Values,\n): Hex | undefined {\n  if (newGasValues && 'gasPrice' in newGasValues) {\n    return newGasValues.gasPrice as Hex;\n  }\n\n  const currentGasPrice = originalTransactionParams.gasPrice as Hex | undefined;\n\n  if (!currentGasPrice || currentGasPrice === '0x0') {\n    return undefined;\n  }\n\n  return multiplyHex(currentGasPrice, rate);\n}\n\n/**\n * Multiply a hex value by a multiplier.\n *\n * @param value - The hex value to multiply.\n * @param multiplier - The multiplier.\n * @returns The multiplied hex value.\n */\nfunction multiplyHex(value: Hex | undefined, multiplier: number): Hex {\n  const decimalValue = convertHexToDecimal(value);\n  const decimalResult = parseInt(`${decimalValue * multiplier}`, 10);\n\n  return add0x(decimalResult.toString(16));\n}\n"]}

package/dist/utils/{retry.d.ts → retry.d.cts}

@@ -1,4 +1,4 @@
-import type { FeeMarketEIP1559Values, GasPriceValue, TransactionParams } from '../types.js';
+import type { FeeMarketEIP1559Values, GasPriceValue, TransactionParams } from "../types.cjs";
 /**
  * Returns new transaction parameters with increased gas fees.
  *
@@ -8,4 +8,4 @@ import type { FeeMarketEIP1559Values, GasPriceValue, TransactionParams } from '.
  * @returns The new transaction parameters with the increased gas fee properties.
  */
 export declare function getTransactionParamsWithIncreasedGasFee(originalTransactionParams: TransactionParams, rate: number, newGasValues?: GasPriceValue | FeeMarketEIP1559Values): TransactionParams;
-//# sourceMappingURL=retry.d.ts.map
+//# sourceMappingURL=retry.d.cts.map

package/dist/utils/retry.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.cts","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,sBAAsB,EACtB,aAAa,EACb,iBAAiB,EAClB,qBAAoB;AAErB;;;;;;;GAOG;AACH,wBAAgB,uCAAuC,CACrD,yBAAyB,EAAE,iBAAiB,EAC5C,IAAI,EAAE,MAAM,EACZ,YAAY,CAAC,EAAE,aAAa,GAAG,sBAAsB,GACpD,iBAAiB,CAuCnB"}

package/dist/utils/retry.d.mts

@@ -0,0 +1,11 @@
+import type { FeeMarketEIP1559Values, GasPriceValue, TransactionParams } from "../types.mjs";
+/**
+ * Returns new transaction parameters with increased gas fees.
+ *
+ * @param originalTransactionParams - The original transaction parameters.
+ * @param rate - The rate by which to increase the existing gas fee properties.
+ * @param newGasValues - Optional new gas values to use instead of increased the existing values.
+ * @returns The new transaction parameters with the increased gas fee properties.
+ */
+export declare function getTransactionParamsWithIncreasedGasFee(originalTransactionParams: TransactionParams, rate: number, newGasValues?: GasPriceValue | FeeMarketEIP1559Values): TransactionParams;
+//# sourceMappingURL=retry.d.mts.map

package/dist/utils/retry.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.mts","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,sBAAsB,EACtB,aAAa,EACb,iBAAiB,EAClB,qBAAoB;AAErB;;;;;;;GAOG;AACH,wBAAgB,uCAAuC,CACrD,yBAAyB,EAAE,iBAAiB,EAC5C,IAAI,EAAE,MAAM,EACZ,YAAY,CAAC,EAAE,aAAa,GAAG,sBAAsB,GACpD,iBAAiB,CAuCnB"}

package/dist/utils/{retry.js → retry.mjs}

@@ -1,5 +1,5 @@
-import { convertHexToDecimal } from '@metamask/controller-utils';
-import { add0x } from '@metamask/utils';
+import { convertHexToDecimal } from "@metamask/controller-utils";
+import { add0x } from "@metamask/utils";
 /**
  * Returns new transaction parameters with increased gas fees.
  *
@@ -86,4 +86,4 @@ function multiplyHex(value, multiplier) {
     const decimalResult = parseInt(`${decimalValue * multiplier}`, 10);
     return add0x(decimalResult.toString(16));
 }
-//# sourceMappingURL=retry.js.map
+//# sourceMappingURL=retry.mjs.map

package/dist/utils/retry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.mjs","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,mCAAmC;AAEjE,OAAO,EAAE,KAAK,EAAE,wBAAwB;AAQxC;;;;;;;GAOG;AACH,MAAM,UAAU,uCAAuC,CACrD,yBAA4C,EAC5C,IAAY,EACZ,YAAqD;IAErD,MAAM,WAAW,GAAG,oBAAoB,CACtC,yBAAyB,EACzB,IAAI,EACJ,YAAY,CACb,CAAC;IAEF,MAAM,aAAa,GAAG,sBAAsB,CAC1C,yBAAyB,EACzB,IAAI,EACJ,YAAY,CACb,CAAC;IAEF,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,WAAW,GAAsB;YACrC,GAAG,yBAAyB;YAC5B,GAAG,aAAa;SACjB,CAAC;QAEF,OAAO,WAAW,CAAC,QAAQ,CAAC;QAE5B,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,WAAW,GAAsB;YACrC,GAAG,yBAAyB;YAC5B,QAAQ,EAAE,WAAW;SACtB,CAAC;QAEF,OAAO,WAAW,CAAC,YAAY,CAAC;QAChC,OAAO,WAAW,CAAC,oBAAoB,CAAC;QAExC,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,MAAM,IAAI,KAAK,CACb,8EAA8E,CAC/E,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,sBAAsB,CAC7B,yBAA4C,EAC5C,IAAY,EACZ,YAAqD;IAErD,IACE,YAAY;QACZ,cAAc,IAAI,YAAY;QAC9B,sBAAsB,IAAI,YAAY,EACtC,CAAC;QACD,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,MAAM,mBAAmB,GAAG,yBAAyB,CAAC,YAEzC,CAAC;IAEd,MAAM,2BAA2B,GAC/B,yBAAyB,CAAC,oBAAuC,CAAC;IAEpE,IACE,CAAC,mBAAmB;QACpB,CAAC,2BAA2B;QAC5B,mBAAmB,KAAK,KAAK;QAC7B,2BAA2B,KAAK,KAAK,EACrC,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,YAAY,GAAG,WAAW,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC;IAC5D,MAAM,oBAAoB,GAAG,WAAW,CAAC,2BAA2B,EAAE,IAAI,CAAC,CAAC;IAE5E,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,CAAC;AAChD,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,oBAAoB,CAC3B,yBAA4C,EAC5C,IAAY,EACZ,YAAqD;IAErD,IAAI,YAAY,IAAI,UAAU,IAAI,YAAY,EAAE,CAAC;QAC/C,OAAO,YAAY,CAAC,QAAe,CAAC;IACtC,CAAC;IAED,MAAM,eAAe,GAAG,yBAAyB,CAAC,QAA2B,CAAC;IAE9E,IAAI,CAAC,eAAe,IAAI,eAAe,KAAK,KAAK,EAAE,CAAC;QAClD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,WAAW,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;GAMG;AACH,SAAS,WAAW,CAAC,KAAsB,EAAE,UAAkB;IAC7D,MAAM,YAAY,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,aAAa,GAAG,QAAQ,CAAC,GAAG,YAAY,GAAG,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;IAEnE,OAAO,KAAK,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;AAC3C,CAAC","sourcesContent":["import { convertHexToDecimal } from '@metamask/controller-utils';\nimport type { Hex } from '@metamask/utils';\nimport { add0x } from '@metamask/utils';\n\nimport type {\n  FeeMarketEIP1559Values,\n  GasPriceValue,\n  TransactionParams,\n} from '../types.js';\n\n/**\n * Returns new transaction parameters with increased gas fees.\n *\n * @param originalTransactionParams - The original transaction parameters.\n * @param rate - The rate by which to increase the existing gas fee properties.\n * @param newGasValues - Optional new gas values to use instead of increased the existing values.\n * @returns The new transaction parameters with the increased gas fee properties.\n */\nexport function getTransactionParamsWithIncreasedGasFee(\n  originalTransactionParams: TransactionParams,\n  rate: number,\n  newGasValues?: GasPriceValue | FeeMarketEIP1559Values,\n): TransactionParams {\n  const newGasPrice = getIncreasedGasPrice(\n    originalTransactionParams,\n    rate,\n    newGasValues,\n  );\n\n  const new1559Values = getIncreased1559Values(\n    originalTransactionParams,\n    rate,\n    newGasValues,\n  );\n\n  if (new1559Values) {\n    const newTxParams: TransactionParams = {\n      ...originalTransactionParams,\n      ...new1559Values,\n    };\n\n    delete newTxParams.gasPrice;\n\n    return newTxParams;\n  }\n\n  if (newGasPrice) {\n    const newTxParams: TransactionParams = {\n      ...originalTransactionParams,\n      gasPrice: newGasPrice,\n    };\n\n    delete newTxParams.maxFeePerGas;\n    delete newTxParams.maxPriorityFeePerGas;\n\n    return newTxParams;\n  }\n\n  throw new Error(\n    'Cannot increase gas fee as no current values and no new values were provided',\n  );\n}\n\n/**\n * Generate the increased EIP-1559 gas properties.\n *\n * @param originalTransactionParams - The original transaction parameters.\n * @param rate - The rate by which to increase the existing gas fee properties.\n * @param newGasValues - Optional new gas values to use instead of increased the existing values.\n * @returns The new EIP-1559 gas properties.\n */\nfunction getIncreased1559Values(\n  originalTransactionParams: TransactionParams,\n  rate: number,\n  newGasValues?: GasPriceValue | FeeMarketEIP1559Values,\n): FeeMarketEIP1559Values | undefined {\n  if (\n    newGasValues &&\n    'maxFeePerGas' in newGasValues &&\n    'maxPriorityFeePerGas' in newGasValues\n  ) {\n    return newGasValues;\n  }\n\n  const currentMaxFeePerGas = originalTransactionParams.maxFeePerGas as\n    | Hex\n    | undefined;\n\n  const currentMaxPriorityFeePerGas =\n    originalTransactionParams.maxPriorityFeePerGas as Hex | undefined;\n\n  if (\n    !currentMaxFeePerGas ||\n    !currentMaxPriorityFeePerGas ||\n    currentMaxFeePerGas === '0x0' ||\n    currentMaxPriorityFeePerGas === '0x0'\n  ) {\n    return undefined;\n  }\n\n  const maxFeePerGas = multiplyHex(currentMaxFeePerGas, rate);\n  const maxPriorityFeePerGas = multiplyHex(currentMaxPriorityFeePerGas, rate);\n\n  return { maxFeePerGas, maxPriorityFeePerGas };\n}\n\n/**\n * Generate the increased gas price.\n *\n * @param originalTransactionParams - The original transaction parameters.\n * @param rate - The rate by which to increase the existing gas fee properties.\n * @param newGasValues - Optional new gas values to use instead of increased the existing values.\n * @returns The new gas price.\n */\nfunction getIncreasedGasPrice(\n  originalTransactionParams: TransactionParams,\n  rate: number,\n  newGasValues?: GasPriceValue | FeeMarketEIP1559Values,\n): Hex | undefined {\n  if (newGasValues && 'gasPrice' in newGasValues) {\n    return newGasValues.gasPrice as Hex;\n  }\n\n  const currentGasPrice = originalTransactionParams.gasPrice as Hex | undefined;\n\n  if (!currentGasPrice || currentGasPrice === '0x0') {\n    return undefined;\n  }\n\n  return multiplyHex(currentGasPrice, rate);\n}\n\n/**\n * Multiply a hex value by a multiplier.\n *\n * @param value - The hex value to multiply.\n * @param multiplier - The multiplier.\n * @returns The multiplied hex value.\n */\nfunction multiplyHex(value: Hex | undefined, multiplier: number): Hex {\n  const decimalValue = convertHexToDecimal(value);\n  const decimalResult = parseInt(`${decimalValue * multiplier}`, 10);\n\n  return add0x(decimalResult.toString(16));\n}\n"]}

package/dist/utils/revert-reason.cjs

@@ -0,0 +1,192 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractRevert = exports.decodeRevert = exports.OnChainFailureError = void 0;
+const abi_1 = require("@ethersproject/abi");
+const logger_js_1 = require("../logger.cjs");
+const provider_js_1 = require("./provider.cjs");
+const log = (0, logger_js_1.createModuleLogger)(logger_js_1.projectLogger, 'revert-reason');
+const ERROR_SELECTOR = '0x08c379a0';
+const PANIC_SELECTOR = '0x4e487b71';
+/**
+ * Solidity panic code descriptions.
+ *
+ * @see https://docs.soliditylang.org/en/latest/control-structures.html#panic-via-assert-and-error-via-require
+ */
+const PANIC_CODE_MESSAGES = {
+    '0x00': 'Generic compiler panic',
+    '0x01': 'Assertion failed',
+    '0x11': 'Arithmetic overflow or underflow',
+    '0x12': 'Division or modulo by zero',
+    '0x21': 'Invalid enum value',
+    '0x22': 'Incorrectly encoded storage byte array',
+    '0x31': 'Pop on empty array',
+    '0x32': 'Array index out of bounds',
+    '0x41': 'Memory allocation overflow',
+    '0x51': 'Call to zero-initialized function',
+};
+/**
+ * Error thrown by `PendingTransactionTracker` when a transaction failed
+ * on-chain, carrying any decoded revert.
+ */
+class OnChainFailureError extends Error {
+    constructor(revert) {
+        const suffix = revert?.message ? `: ${revert.message}` : '';
+        super(`Transaction failed on-chain${suffix}`);
+        this.name = 'OnChainFailureError';
+        this.revert = revert;
+    }
+}
+exports.OnChainFailureError = OnChainFailureError;
+/**
+ * Decode an EVM revert into a `Revert` containing both the decoded
+ * human-readable message and the original raw `data`. Accepts either a
+ * raw revert data hex string, or a thrown JSON-RPC error of the shape
+ * `{ data: Hex | { data: Hex } }`. Handles `Error(string)`,
+ * `Panic(uint256)`, and falls back to a raw `Custom error: 0x<selector>`
+ * reference for unknown custom errors.
+ *
+ * @param input - Raw revert data hex, or a thrown JSON-RPC error.
+ * @param source - Optional label included in debug logs to identify the
+ * caller (e.g. `gas`, `simulation`).
+ * @returns A `Revert` if any data was found, otherwise `undefined`.
+ */
+function decodeRevert(input, source) {
+    const data = toRevertDataHex(input);
+    if (!data) {
+        return undefined;
+    }
+    const message = decodeMessage(data);
+    const revert = {
+        ...(message ? { message } : {}),
+        data,
+    };
+    logRevert(source, revert);
+    return revert;
+}
+exports.decodeRevert = decodeRevert;
+/**
+ * Replay a transaction that failed on-chain via `eth_estimateGas` to
+ * recover the revert reason. `eth_estimateGas` is used instead of
+ * `eth_call` to avoid `RetryOnEmptyMiddleware`, which retries reverted
+ * `eth_call` responses 10 times and discards the original error data.
+ *
+ * Always resolves; never throws.
+ *
+ * @param input - Extraction inputs.
+ * @param input.messenger - Transaction controller messenger.
+ * @param input.networkClientId - Network client ID to replay against.
+ * @param input.txParams - Transaction parameters for the failed tx.
+ * @returns A `Revert`, or `undefined` if none could be observed.
+ */
+async function extractRevert({ messenger, networkClientId, txParams, }) {
+    if (!txParams?.to && !txParams?.data) {
+        return undefined;
+    }
+    const callParams = {};
+    if (txParams.from) {
+        callParams.from = txParams.from;
+    }
+    if (txParams.to) {
+        callParams.to = txParams.to;
+    }
+    if (txParams.data) {
+        callParams.data = txParams.data;
+    }
+    if (txParams.value) {
+        callParams.value = txParams.value;
+    }
+    try {
+        await (0, provider_js_1.rpcRequest)({
+            messenger,
+            networkClientId,
+            // `eth_estimateGas` is used instead of `eth_call` to bypass
+            // `RetryOnEmptyMiddleware`, which retries reverted `eth_call`
+            // responses and discards the original revert data.
+            method: 'eth_estimateGas',
+            params: [callParams],
+        });
+        return undefined;
+    }
+    catch (error) {
+        return decodeRevert(error, 'receipt');
+    }
+}
+exports.extractRevert = extractRevert;
+/**
+ * Coerce a `RevertInput` to a non-empty revert data hex string.
+ *
+ * @param input - Raw hex or thrown JSON-RPC error.
+ * @returns The revert data hex, or `undefined`.
+ */
+function toRevertDataHex(input) {
+    if (isHex(input)) {
+        return input;
+    }
+    if (typeof input !== 'object' || input === null) {
+        return undefined;
+    }
+    const { data } = input;
+    if (isHex(data)) {
+        return data;
+    }
+    if (typeof data === 'object' && data !== null && isHex(data.data)) {
+        return data.data;
+    }
+    return undefined;
+}
+/**
+ * Type guard for non-empty `0x`-prefixed hex strings.
+ *
+ * @param value - Value to test.
+ * @returns Whether the value is a non-empty hex string.
+ */
+function isHex(value) {
+    return typeof value === 'string' && value.startsWith('0x') && value !== '0x';
+}
+/**
+ * Decode raw revert data into a human-readable string.
+ *
+ * @param data - Raw revert data hex.
+ * @returns Decoded message, or `undefined` if undecodable.
+ */
+function decodeMessage(data) {
+    if (!data || data === '0x') {
+        return undefined;
+    }
+    if (data.length < 10) {
+        return `execution reverted (${data})`;
+    }
+    const selector = data.slice(0, 10).toLowerCase();
+    const payload = `0x${data.slice(10)}`;
+    if (selector === ERROR_SELECTOR) {
+        try {
+            const [reason] = abi_1.defaultAbiCoder.decode(['string'], payload);
+            return typeof reason === 'string' ? reason : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    if (selector === PANIC_SELECTOR) {
+        try {
+            const [code] = abi_1.defaultAbiCoder.decode(['uint256'], payload);
+            const codeHex = code.toHexString().toLowerCase();
+            const description = PANIC_CODE_MESSAGES[codeHex] ?? 'Unknown panic';
+            return `Panic: ${description}`;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    return `Custom error: ${selector}`;
+}
+/**
+ * Emit a single structured debug line for a decoded revert.
+ *
+ * @param source - Source label, when known.
+ * @param revert - Resolved Revert.
+ */
+function logRevert(source, revert) {
+    log('Decoded revert', source ?? 'unknown', revert);
+}
+//# sourceMappingURL=revert-reason.cjs.map

package/dist/utils/revert-reason.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"revert-reason.cjs","sourceRoot":"","sources":["../../src/utils/revert-reason.ts"],"names":[],"mappings":"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","sourcesContent":["import { defaultAbiCoder } from '@ethersproject/abi';\nimport type { NetworkClientId } from '@metamask/network-controller';\nimport type { Hex } from '@metamask/utils';\n\nimport { createModuleLogger, projectLogger } from '../logger.js';\nimport type { TransactionControllerMessenger } from '../TransactionController.js';\nimport type { Revert, TransactionParams } from '../types.js';\nimport { rpcRequest } from './provider.js';\n\nconst log = createModuleLogger(projectLogger, 'revert-reason');\n\nconst ERROR_SELECTOR = '0x08c379a0';\nconst PANIC_SELECTOR = '0x4e487b71';\n\n/**\n * Solidity panic code descriptions.\n *\n * @see https://docs.soliditylang.org/en/latest/control-structures.html#panic-via-assert-and-error-via-require\n */\nconst PANIC_CODE_MESSAGES: Record<string, string> = {\n  '0x00': 'Generic compiler panic',\n  '0x01': 'Assertion failed',\n  '0x11': 'Arithmetic overflow or underflow',\n  '0x12': 'Division or modulo by zero',\n  '0x21': 'Invalid enum value',\n  '0x22': 'Incorrectly encoded storage byte array',\n  '0x31': 'Pop on empty array',\n  '0x32': 'Array index out of bounds',\n  '0x41': 'Memory allocation overflow',\n  '0x51': 'Call to zero-initialized function',\n};\n\n/**\n * Input accepted by `decodeRevert`. Either raw revert data hex, or a\n * thrown JSON-RPC error carrying the data on `data` (standard) or\n * nested `data.data` (some older node forks).\n */\ntype RevertInput =\n  | Hex\n  | undefined\n  | { data?: Hex | { data?: Hex } | null }\n  | null;\n\n/**\n * Error thrown by `PendingTransactionTracker` when a transaction failed\n * on-chain, carrying any decoded revert.\n */\nexport class OnChainFailureError extends Error {\n  readonly revert?: Revert;\n\n  constructor(revert?: Revert) {\n    const suffix = revert?.message ? `: ${revert.message}` : '';\n    super(`Transaction failed on-chain${suffix}`);\n    this.name = 'OnChainFailureError';\n    this.revert = revert;\n  }\n}\n\n/**\n * Decode an EVM revert into a `Revert` containing both the decoded\n * human-readable message and the original raw `data`. Accepts either a\n * raw revert data hex string, or a thrown JSON-RPC error of the shape\n * `{ data: Hex | { data: Hex } }`. Handles `Error(string)`,\n * `Panic(uint256)`, and falls back to a raw `Custom error: 0x<selector>`\n * reference for unknown custom errors.\n *\n * @param input - Raw revert data hex, or a thrown JSON-RPC error.\n * @param source - Optional label included in debug logs to identify the\n * caller (e.g. `gas`, `simulation`).\n * @returns A `Revert` if any data was found, otherwise `undefined`.\n */\nexport function decodeRevert(\n  input: RevertInput,\n  source?: string,\n): Revert | undefined {\n  const data = toRevertDataHex(input);\n  if (!data) {\n    return undefined;\n  }\n\n  const message = decodeMessage(data);\n  const revert: Revert = {\n    ...(message ? { message } : {}),\n    data,\n  };\n\n  logRevert(source, revert);\n  return revert;\n}\n\n/**\n * Replay a transaction that failed on-chain via `eth_estimateGas` to\n * recover the revert reason. `eth_estimateGas` is used instead of\n * `eth_call` to avoid `RetryOnEmptyMiddleware`, which retries reverted\n * `eth_call` responses 10 times and discards the original error data.\n *\n * Always resolves; never throws.\n *\n * @param input - Extraction inputs.\n * @param input.messenger - Transaction controller messenger.\n * @param input.networkClientId - Network client ID to replay against.\n * @param input.txParams - Transaction parameters for the failed tx.\n * @returns A `Revert`, or `undefined` if none could be observed.\n */\nexport async function extractRevert({\n  messenger,\n  networkClientId,\n  txParams,\n}: {\n  messenger: TransactionControllerMessenger;\n  networkClientId: NetworkClientId;\n  txParams: TransactionParams;\n}): Promise<Revert | undefined> {\n  if (!txParams?.to && !txParams?.data) {\n    return undefined;\n  }\n\n  const callParams: Record<string, string> = {};\n  if (txParams.from) {\n    callParams.from = txParams.from;\n  }\n  if (txParams.to) {\n    callParams.to = txParams.to;\n  }\n  if (txParams.data) {\n    callParams.data = txParams.data;\n  }\n  if (txParams.value) {\n    callParams.value = txParams.value;\n  }\n\n  try {\n    await rpcRequest({\n      messenger,\n      networkClientId,\n      // `eth_estimateGas` is used instead of `eth_call` to bypass\n      // `RetryOnEmptyMiddleware`, which retries reverted `eth_call`\n      // responses and discards the original revert data.\n      method: 'eth_estimateGas',\n      params: [callParams],\n    });\n    return undefined;\n  } catch (error: unknown) {\n    return decodeRevert(error as RevertInput, 'receipt');\n  }\n}\n\n/**\n * Coerce a `RevertInput` to a non-empty revert data hex string.\n *\n * @param input - Raw hex or thrown JSON-RPC error.\n * @returns The revert data hex, or `undefined`.\n */\nfunction toRevertDataHex(input: RevertInput): Hex | undefined {\n  if (isHex(input)) {\n    return input;\n  }\n\n  if (typeof input !== 'object' || input === null) {\n    return undefined;\n  }\n\n  const { data } = input;\n  if (isHex(data)) {\n    return data;\n  }\n\n  if (typeof data === 'object' && data !== null && isHex(data.data)) {\n    return data.data;\n  }\n\n  return undefined;\n}\n\n/**\n * Type guard for non-empty `0x`-prefixed hex strings.\n *\n * @param value - Value to test.\n * @returns Whether the value is a non-empty hex string.\n */\nfunction isHex(value: unknown): value is Hex {\n  return typeof value === 'string' && value.startsWith('0x') && value !== '0x';\n}\n\n/**\n * Decode raw revert data into a human-readable string.\n *\n * @param data - Raw revert data hex.\n * @returns Decoded message, or `undefined` if undecodable.\n */\nfunction decodeMessage(data: Hex | undefined): string | undefined {\n  if (!data || data === '0x') {\n    return undefined;\n  }\n\n  if (data.length < 10) {\n    return `execution reverted (${data})`;\n  }\n\n  const selector = data.slice(0, 10).toLowerCase();\n  const payload = `0x${data.slice(10)}`;\n\n  if (selector === ERROR_SELECTOR) {\n    try {\n      const [reason] = defaultAbiCoder.decode(['string'], payload);\n      return typeof reason === 'string' ? reason : undefined;\n    } catch {\n      return undefined;\n    }\n  }\n\n  if (selector === PANIC_SELECTOR) {\n    try {\n      const [code] = defaultAbiCoder.decode(['uint256'], payload) as [\n        { toHexString: () => string },\n      ];\n      const codeHex = code.toHexString().toLowerCase() as Hex;\n      const description = PANIC_CODE_MESSAGES[codeHex] ?? 'Unknown panic';\n      return `Panic: ${description}`;\n    } catch {\n      return undefined;\n    }\n  }\n\n  return `Custom error: ${selector}`;\n}\n\n/**\n * Emit a single structured debug line for a decoded revert.\n *\n * @param source - Source label, when known.\n * @param revert - Resolved Revert.\n */\nfunction logRevert(source: string | undefined, revert: Revert): void {\n  log('Decoded revert', source ?? 'unknown', revert);\n}\n"]}

package/dist/utils/{revert-reason.d.ts → revert-reason.d.cts}

@@ -1,7 +1,7 @@
-import type { NetworkClientId } from '@metamask/network-controller';
-import type { Hex } from '@metamask/utils';
-import type { TransactionControllerMessenger } from '../TransactionController.js';
-import type { Revert, TransactionParams } from '../types.js';
+import type { NetworkClientId } from "@metamask/network-controller";
+import type { Hex } from "@metamask/utils";
+import type { TransactionControllerMessenger } from "../TransactionController.cjs";
+import type { Revert, TransactionParams } from "../types.cjs";
 /**
  * Input accepted by `decodeRevert`. Either raw revert data hex, or a
  * thrown JSON-RPC error carrying the data on `data` (standard) or
@@ -54,4 +54,4 @@ export declare function extractRevert({ messenger, networkClientId, txParams, }:
     txParams: TransactionParams;
 }): Promise<Revert | undefined>;
 export {};
-//# sourceMappingURL=revert-reason.d.ts.map
+//# sourceMappingURL=revert-reason.d.cts.map

package/dist/utils/revert-reason.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revert-reason.d.cts","sourceRoot":"","sources":["../../src/utils/revert-reason.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,qCAAqC;AACpE,OAAO,KAAK,EAAE,GAAG,EAAE,wBAAwB;AAG3C,OAAO,KAAK,EAAE,8BAA8B,EAAE,qCAAoC;AAClF,OAAO,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,qBAAoB;AA0B7D;;;;GAIG;AACH,KAAK,WAAW,GACZ,GAAG,GACH,SAAS,GACT;IAAE,IAAI,CAAC,EAAE,GAAG,GAAG;QAAE,IAAI,CAAC,EAAE,GAAG,CAAA;KAAE,GAAG,IAAI,CAAA;CAAE,GACtC,IAAI,CAAC;AAET;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEb,MAAM,CAAC,EAAE,MAAM;CAM5B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,WAAW,EAClB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,GAAG,SAAS,CAcpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,aAAa,CAAC,EAClC,SAAS,EACT,eAAe,EACf,QAAQ,GACT,EAAE;IACD,SAAS,EAAE,8BAA8B,CAAC;IAC1C,eAAe,EAAE,eAAe,CAAC;IACjC,QAAQ,EAAE,iBAAiB,CAAC;CAC7B,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAiC9B"}

package/dist/utils/revert-reason.d.mts

@@ -0,0 +1,57 @@
+import type { NetworkClientId } from "@metamask/network-controller";
+import type { Hex } from "@metamask/utils";
+import type { TransactionControllerMessenger } from "../TransactionController.mjs";
+import type { Revert, TransactionParams } from "../types.mjs";
+/**
+ * Input accepted by `decodeRevert`. Either raw revert data hex, or a
+ * thrown JSON-RPC error carrying the data on `data` (standard) or
+ * nested `data.data` (some older node forks).
+ */
+type RevertInput = Hex | undefined | {
+    data?: Hex | {
+        data?: Hex;
+    } | null;
+} | null;
+/**
+ * Error thrown by `PendingTransactionTracker` when a transaction failed
+ * on-chain, carrying any decoded revert.
+ */
+export declare class OnChainFailureError extends Error {
+    readonly revert?: Revert;
+    constructor(revert?: Revert);
+}
+/**
+ * Decode an EVM revert into a `Revert` containing both the decoded
+ * human-readable message and the original raw `data`. Accepts either a
+ * raw revert data hex string, or a thrown JSON-RPC error of the shape
+ * `{ data: Hex | { data: Hex } }`. Handles `Error(string)`,
+ * `Panic(uint256)`, and falls back to a raw `Custom error: 0x<selector>`
+ * reference for unknown custom errors.
+ *
+ * @param input - Raw revert data hex, or a thrown JSON-RPC error.
+ * @param source - Optional label included in debug logs to identify the
+ * caller (e.g. `gas`, `simulation`).
+ * @returns A `Revert` if any data was found, otherwise `undefined`.
+ */
+export declare function decodeRevert(input: RevertInput, source?: string): Revert | undefined;
+/**
+ * Replay a transaction that failed on-chain via `eth_estimateGas` to
+ * recover the revert reason. `eth_estimateGas` is used instead of
+ * `eth_call` to avoid `RetryOnEmptyMiddleware`, which retries reverted
+ * `eth_call` responses 10 times and discards the original error data.
+ *
+ * Always resolves; never throws.
+ *
+ * @param input - Extraction inputs.
+ * @param input.messenger - Transaction controller messenger.
+ * @param input.networkClientId - Network client ID to replay against.
+ * @param input.txParams - Transaction parameters for the failed tx.
+ * @returns A `Revert`, or `undefined` if none could be observed.
+ */
+export declare function extractRevert({ messenger, networkClientId, txParams, }: {
+    messenger: TransactionControllerMessenger;
+    networkClientId: NetworkClientId;
+    txParams: TransactionParams;
+}): Promise<Revert | undefined>;
+export {};
+//# sourceMappingURL=revert-reason.d.mts.map

package/dist/utils/revert-reason.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revert-reason.d.mts","sourceRoot":"","sources":["../../src/utils/revert-reason.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,qCAAqC;AACpE,OAAO,KAAK,EAAE,GAAG,EAAE,wBAAwB;AAG3C,OAAO,KAAK,EAAE,8BAA8B,EAAE,qCAAoC;AAClF,OAAO,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,qBAAoB;AA0B7D;;;;GAIG;AACH,KAAK,WAAW,GACZ,GAAG,GACH,SAAS,GACT;IAAE,IAAI,CAAC,EAAE,GAAG,GAAG;QAAE,IAAI,CAAC,EAAE,GAAG,CAAA;KAAE,GAAG,IAAI,CAAA;CAAE,GACtC,IAAI,CAAC;AAET;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEb,MAAM,CAAC,EAAE,MAAM;CAM5B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,WAAW,EAClB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,GAAG,SAAS,CAcpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,aAAa,CAAC,EAClC,SAAS,EACT,eAAe,EACf,QAAQ,GACT,EAAE;IACD,SAAS,EAAE,8BAA8B,CAAC;IAC1C,eAAe,EAAE,eAAe,CAAC;IACjC,QAAQ,EAAE,iBAAiB,CAAC;CAC7B,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAiC9B"}

package/dist/utils/{revert-reason.js → revert-reason.mjs}

@@ -1,6 +1,6 @@
-import { defaultAbiCoder } from '@ethersproject/abi';
-import { createModuleLogger, projectLogger } from '../logger.js';
-import { rpcRequest } from './provider.js';
+import { defaultAbiCoder } from "@ethersproject/abi";
+import { createModuleLogger, projectLogger } from "../logger.mjs";
+import { rpcRequest } from "./provider.mjs";
 const log = createModuleLogger(projectLogger, 'revert-reason');
 const ERROR_SELECTOR = '0x08c379a0';
 const PANIC_SELECTOR = '0x4e487b71';
@@ -183,4 +183,4 @@ function decodeMessage(data) {
 function logRevert(source, revert) {
     log('Decoded revert', source ?? 'unknown', revert);
 }
-//# sourceMappingURL=revert-reason.js.map
+//# sourceMappingURL=revert-reason.mjs.map

package/dist/utils/revert-reason.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"revert-reason.mjs","sourceRoot":"","sources":["../../src/utils/revert-reason.ts"],"names":[],"mappings":"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","sourcesContent":["import { defaultAbiCoder } from '@ethersproject/abi';\nimport type { NetworkClientId } from '@metamask/network-controller';\nimport type { Hex } from '@metamask/utils';\n\nimport { createModuleLogger, projectLogger } from '../logger.js';\nimport type { TransactionControllerMessenger } from '../TransactionController.js';\nimport type { Revert, TransactionParams } from '../types.js';\nimport { rpcRequest } from './provider.js';\n\nconst log = createModuleLogger(projectLogger, 'revert-reason');\n\nconst ERROR_SELECTOR = '0x08c379a0';\nconst PANIC_SELECTOR = '0x4e487b71';\n\n/**\n * Solidity panic code descriptions.\n *\n * @see https://docs.soliditylang.org/en/latest/control-structures.html#panic-via-assert-and-error-via-require\n */\nconst PANIC_CODE_MESSAGES: Record<string, string> = {\n  '0x00': 'Generic compiler panic',\n  '0x01': 'Assertion failed',\n  '0x11': 'Arithmetic overflow or underflow',\n  '0x12': 'Division or modulo by zero',\n  '0x21': 'Invalid enum value',\n  '0x22': 'Incorrectly encoded storage byte array',\n  '0x31': 'Pop on empty array',\n  '0x32': 'Array index out of bounds',\n  '0x41': 'Memory allocation overflow',\n  '0x51': 'Call to zero-initialized function',\n};\n\n/**\n * Input accepted by `decodeRevert`. Either raw revert data hex, or a\n * thrown JSON-RPC error carrying the data on `data` (standard) or\n * nested `data.data` (some older node forks).\n */\ntype RevertInput =\n  | Hex\n  | undefined\n  | { data?: Hex | { data?: Hex } | null }\n  | null;\n\n/**\n * Error thrown by `PendingTransactionTracker` when a transaction failed\n * on-chain, carrying any decoded revert.\n */\nexport class OnChainFailureError extends Error {\n  readonly revert?: Revert;\n\n  constructor(revert?: Revert) {\n    const suffix = revert?.message ? `: ${revert.message}` : '';\n    super(`Transaction failed on-chain${suffix}`);\n    this.name = 'OnChainFailureError';\n    this.revert = revert;\n  }\n}\n\n/**\n * Decode an EVM revert into a `Revert` containing both the decoded\n * human-readable message and the original raw `data`. Accepts either a\n * raw revert data hex string, or a thrown JSON-RPC error of the shape\n * `{ data: Hex | { data: Hex } }`. Handles `Error(string)`,\n * `Panic(uint256)`, and falls back to a raw `Custom error: 0x<selector>`\n * reference for unknown custom errors.\n *\n * @param input - Raw revert data hex, or a thrown JSON-RPC error.\n * @param source - Optional label included in debug logs to identify the\n * caller (e.g. `gas`, `simulation`).\n * @returns A `Revert` if any data was found, otherwise `undefined`.\n */\nexport function decodeRevert(\n  input: RevertInput,\n  source?: string,\n): Revert | undefined {\n  const data = toRevertDataHex(input);\n  if (!data) {\n    return undefined;\n  }\n\n  const message = decodeMessage(data);\n  const revert: Revert = {\n    ...(message ? { message } : {}),\n    data,\n  };\n\n  logRevert(source, revert);\n  return revert;\n}\n\n/**\n * Replay a transaction that failed on-chain via `eth_estimateGas` to\n * recover the revert reason. `eth_estimateGas` is used instead of\n * `eth_call` to avoid `RetryOnEmptyMiddleware`, which retries reverted\n * `eth_call` responses 10 times and discards the original error data.\n *\n * Always resolves; never throws.\n *\n * @param input - Extraction inputs.\n * @param input.messenger - Transaction controller messenger.\n * @param input.networkClientId - Network client ID to replay against.\n * @param input.txParams - Transaction parameters for the failed tx.\n * @returns A `Revert`, or `undefined` if none could be observed.\n */\nexport async function extractRevert({\n  messenger,\n  networkClientId,\n  txParams,\n}: {\n  messenger: TransactionControllerMessenger;\n  networkClientId: NetworkClientId;\n  txParams: TransactionParams;\n}): Promise<Revert | undefined> {\n  if (!txParams?.to && !txParams?.data) {\n    return undefined;\n  }\n\n  const callParams: Record<string, string> = {};\n  if (txParams.from) {\n    callParams.from = txParams.from;\n  }\n  if (txParams.to) {\n    callParams.to = txParams.to;\n  }\n  if (txParams.data) {\n    callParams.data = txParams.data;\n  }\n  if (txParams.value) {\n    callParams.value = txParams.value;\n  }\n\n  try {\n    await rpcRequest({\n      messenger,\n      networkClientId,\n      // `eth_estimateGas` is used instead of `eth_call` to bypass\n      // `RetryOnEmptyMiddleware`, which retries reverted `eth_call`\n      // responses and discards the original revert data.\n      method: 'eth_estimateGas',\n      params: [callParams],\n    });\n    return undefined;\n  } catch (error: unknown) {\n    return decodeRevert(error as RevertInput, 'receipt');\n  }\n}\n\n/**\n * Coerce a `RevertInput` to a non-empty revert data hex string.\n *\n * @param input - Raw hex or thrown JSON-RPC error.\n * @returns The revert data hex, or `undefined`.\n */\nfunction toRevertDataHex(input: RevertInput): Hex | undefined {\n  if (isHex(input)) {\n    return input;\n  }\n\n  if (typeof input !== 'object' || input === null) {\n    return undefined;\n  }\n\n  const { data } = input;\n  if (isHex(data)) {\n    return data;\n  }\n\n  if (typeof data === 'object' && data !== null && isHex(data.data)) {\n    return data.data;\n  }\n\n  return undefined;\n}\n\n/**\n * Type guard for non-empty `0x`-prefixed hex strings.\n *\n * @param value - Value to test.\n * @returns Whether the value is a non-empty hex string.\n */\nfunction isHex(value: unknown): value is Hex {\n  return typeof value === 'string' && value.startsWith('0x') && value !== '0x';\n}\n\n/**\n * Decode raw revert data into a human-readable string.\n *\n * @param data - Raw revert data hex.\n * @returns Decoded message, or `undefined` if undecodable.\n */\nfunction decodeMessage(data: Hex | undefined): string | undefined {\n  if (!data || data === '0x') {\n    return undefined;\n  }\n\n  if (data.length < 10) {\n    return `execution reverted (${data})`;\n  }\n\n  const selector = data.slice(0, 10).toLowerCase();\n  const payload = `0x${data.slice(10)}`;\n\n  if (selector === ERROR_SELECTOR) {\n    try {\n      const [reason] = defaultAbiCoder.decode(['string'], payload);\n      return typeof reason === 'string' ? reason : undefined;\n    } catch {\n      return undefined;\n    }\n  }\n\n  if (selector === PANIC_SELECTOR) {\n    try {\n      const [code] = defaultAbiCoder.decode(['uint256'], payload) as [\n        { toHexString: () => string },\n      ];\n      const codeHex = code.toHexString().toLowerCase() as Hex;\n      const description = PANIC_CODE_MESSAGES[codeHex] ?? 'Unknown panic';\n      return `Panic: ${description}`;\n    } catch {\n      return undefined;\n    }\n  }\n\n  return `Custom error: ${selector}`;\n}\n\n/**\n * Emit a single structured debug line for a decoded revert.\n *\n * @param source - Source label, when known.\n * @param revert - Resolved Revert.\n */\nfunction logRevert(source: string | undefined, revert: Revert): void {\n  log('Decoded revert', source ?? 'unknown', revert);\n}\n"]}

package/dist/utils/signature.cjs

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidSignature = void 0;
+const wallet_1 = require("@ethersproject/wallet");
+const utils_1 = require("@metamask/utils");
+/**
+ * Verify if the signature is the specified data signed by the specified public key.
+ *
+ * @param data - The data to check.
+ * @param signature - The signature to check.
+ * @param publicKey - The public key to check.
+ * @returns True if the signature is correct, false otherwise.
+ */
+function isValidSignature(data, signature, publicKey) {
+    try {
+        const joinedHex = (0, utils_1.add0x)(data.map(utils_1.remove0x).join(''));
+        const dataBytes = (0, utils_1.hexToBytes)(joinedHex);
+        const actualPublicKey = (0, wallet_1.verifyMessage)(dataBytes, signature);
+        return actualPublicKey.toLowerCase() === publicKey.toLowerCase();
+    }
+    catch {
+        return false;
+    }
+}
+exports.isValidSignature = isValidSignature;
+//# sourceMappingURL=signature.cjs.map

package/dist/utils/signature.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature.cjs","sourceRoot":"","sources":["../../src/utils/signature.ts"],"names":[],"mappings":";;;AAAA,kDAAsD;AAEtD,2CAA8D;AAE9D;;;;;;;GAOG;AACH,SAAgB,gBAAgB,CAC9B,IAAW,EACX,SAAc,EACd,SAAc;IAEd,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAA,aAAK,EAAC,IAAI,CAAC,GAAG,CAAC,gBAAQ,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACrD,MAAM,SAAS,GAAG,IAAA,kBAAU,EAAC,SAAS,CAAC,CAAC;QACxC,MAAM,eAAe,GAAG,IAAA,sBAAa,EAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAE5D,OAAO,eAAe,CAAC,WAAW,EAAE,KAAK,SAAS,CAAC,WAAW,EAAE,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAdD,4CAcC","sourcesContent":["import { verifyMessage } from '@ethersproject/wallet';\nimport type { Hex } from '@metamask/utils';\nimport { add0x, hexToBytes, remove0x } from '@metamask/utils';\n\n/**\n * Verify if the signature is the specified data signed by the specified public key.\n *\n * @param data - The data to check.\n * @param signature - The signature to check.\n * @param publicKey - The public key to check.\n * @returns True if the signature is correct, false otherwise.\n */\nexport function isValidSignature(\n  data: Hex[],\n  signature: Hex,\n  publicKey: Hex,\n): boolean {\n  try {\n    const joinedHex = add0x(data.map(remove0x).join(''));\n    const dataBytes = hexToBytes(joinedHex);\n    const actualPublicKey = verifyMessage(dataBytes, signature);\n\n    return actualPublicKey.toLowerCase() === publicKey.toLowerCase();\n  } catch {\n    return false;\n  }\n}\n"]}

package/dist/utils/{signature.d.ts → signature.d.cts}

@@ -1,4 +1,4 @@
-import type { Hex } from '@metamask/utils';
+import type { Hex } from "@metamask/utils";
 /**
  * Verify if the signature is the specified data signed by the specified public key.
  *
@@ -8,4 +8,4 @@ import type { Hex } from '@metamask/utils';
  * @returns True if the signature is correct, false otherwise.
  */
 export declare function isValidSignature(data: Hex[], signature: Hex, publicKey: Hex): boolean;
-//# sourceMappingURL=signature.d.ts.map
+//# sourceMappingURL=signature.d.cts.map

package/dist/utils/signature.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature.d.cts","sourceRoot":"","sources":["../../src/utils/signature.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,wBAAwB;AAG3C;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,GAAG,EAAE,EACX,SAAS,EAAE,GAAG,EACd,SAAS,EAAE,GAAG,GACb,OAAO,CAUT"}

package/dist/utils/signature.d.mts

@@ -0,0 +1,11 @@
+import type { Hex } from "@metamask/utils";
+/**
+ * Verify if the signature is the specified data signed by the specified public key.
+ *
+ * @param data - The data to check.
+ * @param signature - The signature to check.
+ * @param publicKey - The public key to check.
+ * @returns True if the signature is correct, false otherwise.
+ */
+export declare function isValidSignature(data: Hex[], signature: Hex, publicKey: Hex): boolean;
+//# sourceMappingURL=signature.d.mts.map

package/dist/utils/signature.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature.d.mts","sourceRoot":"","sources":["../../src/utils/signature.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,wBAAwB;AAG3C;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,GAAG,EAAE,EACX,SAAS,EAAE,GAAG,EACd,SAAS,EAAE,GAAG,GACb,OAAO,CAUT"}

package/dist/utils/{signature.js → signature.mjs}

@@ -1,5 +1,5 @@
-import { verifyMessage } from '@ethersproject/wallet';
-import { add0x, hexToBytes, remove0x } from '@metamask/utils';
+import { verifyMessage } from "@ethersproject/wallet";
+import { add0x, hexToBytes, remove0x } from "@metamask/utils";
 /**
  * Verify if the signature is the specified data signed by the specified public key.
  *
@@ -19,4 +19,4 @@ export function isValidSignature(data, signature, publicKey) {
         return false;
     }
 }
-//# sourceMappingURL=signature.js.map
+//# sourceMappingURL=signature.mjs.map

package/dist/utils/signature.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature.mjs","sourceRoot":"","sources":["../../src/utils/signature.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,8BAA8B;AAEtD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,wBAAwB;AAE9D;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAW,EACX,SAAc,EACd,SAAc;IAEd,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACrD,MAAM,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;QACxC,MAAM,eAAe,GAAG,aAAa,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAE5D,OAAO,eAAe,CAAC,WAAW,EAAE,KAAK,SAAS,CAAC,WAAW,EAAE,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC","sourcesContent":["import { verifyMessage } from '@ethersproject/wallet';\nimport type { Hex } from '@metamask/utils';\nimport { add0x, hexToBytes, remove0x } from '@metamask/utils';\n\n/**\n * Verify if the signature is the specified data signed by the specified public key.\n *\n * @param data - The data to check.\n * @param signature - The signature to check.\n * @param publicKey - The public key to check.\n * @returns True if the signature is correct, false otherwise.\n */\nexport function isValidSignature(\n  data: Hex[],\n  signature: Hex,\n  publicKey: Hex,\n): boolean {\n  try {\n    const joinedHex = add0x(data.map(remove0x).join(''));\n    const dataBytes = hexToBytes(joinedHex);\n    const actualPublicKey = verifyMessage(dataBytes, signature);\n\n    return actualPublicKey.toLowerCase() === publicKey.toLowerCase();\n  } catch {\n    return false;\n  }\n}\n"]}