@metamask-previews/transaction-controller 69.4.0-preview-507508c10 → 69.4.0-preview-0efc7ef01

package/CHANGELOG.md

@@ -10,6 +10,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Changed
 
 - Bump `@metamask/network-controller` from `^35.0.0` to `^35.0.1` ([#9758](https://github.com/MetaMask/core/pull/9758))
+- Replace underpriced dapp-suggested gas fees with the wallet's suggested estimates ([#9704](https://github.com/MetaMask/core/pull/9704))
+  - If the new `replaceUnderpricedDappGasFees` feature flag is enabled for the chain, dapp-suggested EIP-1559 fees with a `maxFeePerGas` below the current low estimate are replaced with the suggested medium values, as they are unlikely to result in inclusion in a block before fee values change.
+  - The `userFeeLevel` for such transactions is set to `medium` instead of `dappSuggested`, so the values are kept updated while the transaction is unapproved.
+  - The original dapp-suggested values remain available via `dappSuggestedGasFees` on the transaction metadata.
+  - Disabled by default.
+- Ignore underpriced saved (advanced) gas fee preferences in favour of the wallet's suggested estimates ([#9704](https://github.com/MetaMask/core/pull/9704))
+  - If the new `replaceUnderpricedSavedGasFees` feature flag is enabled for the chain, saved custom fees with a `maxBaseFee` below the current low estimate are ignored and the suggested medium values are used instead, as they are unlikely to result in inclusion in a block before fee values change.
+  - Level-based saved preferences track current estimates and are never ignored.
+  - The `userFeeLevel` for such transactions is set to `medium` instead of `custom`, so the values are kept updated while the transaction is unapproved.
+  - Disabled by default.
 
 ### Fixed
 

package/dist/utils/feature-flags.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getTimeoutAttempts = exports.getGasEstimateBuffer = exports.getGasEstimateFallback = exports.getGasFeeRandomisation = exports.getAcceleratedPollingParams = exports.getTransactionHistoryLimit = exports.getSubmitHistoryLimit = exports.getBatchSizeLimit = exports.getEIP7702UpgradeContractAddress = exports.getEIP7702ContractAddresses = exports.getEIP7702SupportedChains = exports.FeatureFlag = void 0;
+exports.getReplaceUnderpricedSavedGasFeesEnabled = exports.getReplaceUnderpricedDappGasFeesEnabled = exports.getTimeoutAttempts = exports.getGasEstimateBuffer = exports.getGasEstimateFallback = exports.getGasFeeRandomisation = exports.getAcceleratedPollingParams = exports.getTransactionHistoryLimit = exports.getSubmitHistoryLimit = exports.getBatchSizeLimit = exports.getEIP7702UpgradeContractAddress = exports.getEIP7702ContractAddresses = exports.getEIP7702SupportedChains = exports.FeatureFlag = void 0;
 const utils_1 = require("@metamask/utils");
 const logger_js_1 = require("../logger.cjs");
 const signature_js_1 = require("./signature.cjs");
@@ -203,6 +203,38 @@ function getTimeoutAttempts(chainId, messenger) {
         timeoutAttemptsFlags?.default);
 }
 exports.getTimeoutAttempts = getTimeoutAttempts;
+/**
+ * Retrieves whether underpriced dapp-suggested gas fees should be replaced
+ * with the wallet's suggested fees.
+ *
+ * @param chainId - The chain ID.
+ * @param messenger - The controller messenger instance.
+ * @returns Whether the replacement is enabled.
+ */
+function getReplaceUnderpricedDappGasFeesEnabled(chainId, messenger) {
+    const featureFlags = getFeatureFlags(messenger);
+    const replaceUnderpricedDappGasFeesFlags = featureFlags?.[FeatureFlag.Transactions]?.replaceUnderpricedDappGasFees;
+    return (replaceUnderpricedDappGasFeesFlags?.perChainConfig?.[chainId] ??
+        replaceUnderpricedDappGasFeesFlags?.default ??
+        false);
+}
+exports.getReplaceUnderpricedDappGasFeesEnabled = getReplaceUnderpricedDappGasFeesEnabled;
+/**
+ * Retrieves whether underpriced saved (advanced) gas fee preferences should be
+ * ignored in favour of the wallet's suggested fees.
+ *
+ * @param chainId - The chain ID.
+ * @param messenger - The controller messenger instance.
+ * @returns Whether the replacement is enabled.
+ */
+function getReplaceUnderpricedSavedGasFeesEnabled(chainId, messenger) {
+    const featureFlags = getFeatureFlags(messenger);
+    const replaceUnderpricedSavedGasFeesFlags = featureFlags?.[FeatureFlag.Transactions]?.replaceUnderpricedSavedGasFees;
+    return (replaceUnderpricedSavedGasFeesFlags?.perChainConfig?.[chainId] ??
+        replaceUnderpricedSavedGasFeesFlags?.default ??
+        false);
+}
+exports.getReplaceUnderpricedSavedGasFeesEnabled = getReplaceUnderpricedSavedGasFeesEnabled;
 /**
  * Retrieves the relevant feature flags from the remote feature flag controller.
  *

package/dist/utils/feature-flags.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"feature-flags.cjs","sourceRoot":"","sources":["../../src/utils/feature-flags.ts"],"names":[],"mappings":"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","sourcesContent":["import { createModuleLogger } from '@metamask/utils';\nimport type { Hex } from '@metamask/utils';\n\nimport { projectLogger } from '../logger.js';\nimport type { TransactionControllerMessenger } from '../TransactionController.js';\nimport { isValidSignature } from './signature.js';\nimport { padHexToEvenLength } from './utils.js';\n\nconst DEFAULT_BATCH_SIZE_LIMIT = 10;\nconst DEFAULT_ACCELERATED_POLLING_COUNT_MAX = 10;\nconst DEFAULT_ACCELERATED_POLLING_INTERVAL_MS = 3 * 1000;\nconst DEFAULT_BLOCK_TIME = 12 * 1000;\nconst DEFAULT_GAS_ESTIMATE_FALLBACK_BLOCK_PERCENT = 35;\nconst DEFAULT_GAS_ESTIMATE_BUFFER = 1;\nconst DEFAULT_SUBMIT_HISTORY_LIMIT = 100;\nconst DEFAULT_TRANSACTION_HISTORY_LIMIT = 40;\n\n/**\n * Feature flags supporting the transaction controller.\n */\nexport enum FeatureFlag {\n  EIP7702 = 'confirmations_eip_7702',\n  GasBuffer = 'confirmations_gas_buffer',\n  Transactions = 'confirmations_transactions',\n}\n\ntype GasEstimateFallback = {\n  /**\n   * The fixed gas estimate fallback for a transaction.\n   */\n  fixed?: number;\n\n  /**\n   * The percentage multiplier gas estimate fallback for a transaction.\n   */\n  percentage?: number;\n\n  /**\n   * The maximum gas limit the fallback can resolve to, representing the chain's\n   * per-transaction gas cap. Clamps the `fixed` or `percentage`-derived fallback\n   * so it can never exceed the gas limit the RPC will accept (e.g. ~33.5M on\n   * Polygon, whereas 35% of its ~140M block gas limit would otherwise be ~49M).\n   */\n  maxGasLimit?: number;\n};\n\nexport type TransactionControllerFeatureFlags = {\n  /** Feature flags to support EIP-7702 / type-4 transactions. */\n  [FeatureFlag.EIP7702]?: {\n    /**\n     * All contracts that support EIP-7702 batch transactions.\n     * Keyed by chain ID.\n     * First entry in each array is the contract that standard EOAs will be upgraded to.\n     */\n    contracts?: Record<\n      Hex,\n      {\n        /** Address of the smart contract. */\n        address: Hex;\n\n        /** Signature to verify the contract is authentic. */\n        signature: Hex;\n      }[]\n    >;\n\n    /** Chains enabled for EIP-7702 batch transactions. */\n    supportedChains?: Hex[];\n  };\n\n  /**\n   * Buffers added to gas limit estimations.\n   * Values are multipliers such as `1.5` meaning 150% of the original gas limit.\n   */\n  [FeatureFlag.GasBuffer]?: {\n    /** Fallback buffer for all chains and transactions. */\n    default?: number;\n\n    /**\n     * Buffer for included network RPCs only and not those added by user.\n     * Takes priority over `default`.\n     */\n    included?: number;\n\n    /** Buffers for specific chains. */\n    perChainConfig?: {\n      [chainId: Hex]: {\n        /**\n         * Buffer for the chain for all transactions.\n         * Takes priority over non-chain `included`.\n         */\n        base?: number;\n\n        /**\n         * Buffer if network RPC is included and not added by user.\n         * Takes priority over `base`.\n         */\n        included?: number;\n\n        /**\n         * Buffer for the chain for EIP-7702 / type 4 transactions only.\n         * Only if `data` included and `to` matches `from`.\n         * Takes priority over `included` and `base`.\n         */\n        eip7702?: number;\n      };\n    };\n  };\n\n  /** Miscellaneous feature flags to support the transaction controller. */\n  [FeatureFlag.Transactions]?: {\n    /** Maximum number of transactions that can be in an external batch. */\n    batchSizeLimit?: number;\n\n    /** Maximum number of entries in the submit history. */\n    submitHistoryLimit?: number;\n\n    /** Maximum number of transactions stored in state. */\n    transactionHistoryLimit?: number;\n\n    /**\n     * Accelerated polling is used to speed up the polling process for\n     * transactions that are not yet confirmed.\n     */\n    acceleratedPolling?: {\n      /** Accelerated polling parameters on a per-chain basis. */\n      perChainConfig?: {\n        [chainId: Hex]: {\n          /**\n           * Block time in milliseconds.\n           */\n          blockTime?: number;\n\n          /**\n           * Maximum number of polling requests that can be made in a row, before\n           * the normal polling resumes.\n           */\n          countMax?: number;\n\n          /** Interval between polling requests in milliseconds. */\n          intervalMs?: number;\n        };\n      };\n\n      /** Default `countMax` in case no chain-specific parameter is set. */\n      defaultCountMax?: number;\n\n      /** Default `intervalMs` in case no chain-specific parameter is set. */\n      defaultIntervalMs?: number;\n    };\n\n    gasFeeRandomisation?: {\n      /** Randomised gas fee digits per chainId. */\n      randomisedGasFeeDigits?: Record<Hex, number>;\n\n      /** Number of digits to preserve for randomised gas fee digits. */\n      preservedNumberOfDigits?: number;\n    };\n\n    /** Gas estimate fallback is used as a fallback in case of failure to obtain the gas estimate values. */\n    gasEstimateFallback?: {\n      /** Gas estimate fallback per-chain basis. */\n      perChainConfig?: {\n        [chainId: Hex]: GasEstimateFallback;\n      };\n\n      /**\n       * Default gas estimate fallback.\n       * This value is used when no specific gas estimate fallback is found for a chain ID.\n       */\n      default?: GasEstimateFallback;\n    };\n\n    /**\n     * Number of attempts to wait before automatically marking a transaction as failed\n     * if it has no receipt status and hash is not found on the network.\n     */\n    timeoutAttempts?: {\n      /** Automatic fail threshold on a per-chain basis. */\n      perChainConfig?: {\n        [chainId: Hex]: number;\n      };\n\n      /**\n       * Default automatic fail threshold.\n       * This value is used when no specific threshold is found for a chain ID.\n       */\n      default?: number;\n    };\n  };\n};\n\nconst log = createModuleLogger(projectLogger, 'feature-flags');\n\n/**\n * Retrieves the supported EIP-7702 chains.\n *\n * @param messenger - The controller messenger instance.\n * @returns The supported chains.\n */\nexport function getEIP7702SupportedChains(\n  messenger: TransactionControllerMessenger,\n): Hex[] {\n  const featureFlags = getFeatureFlags(messenger);\n  return featureFlags?.[FeatureFlag.EIP7702]?.supportedChains ?? [];\n}\n\n/**\n * Retrieves the supported EIP-7702 contract addresses for a given chain ID.\n *\n * @param chainId - The chain ID.\n * @param messenger - The controller messenger instance.\n * @param publicKey - The public key used to validate the contract authenticity.\n * @returns The supported contract addresses.\n */\nexport function getEIP7702ContractAddresses(\n  chainId: Hex,\n  messenger: TransactionControllerMessenger,\n  publicKey: Hex,\n): Hex[] {\n  const featureFlags = getFeatureFlags(messenger);\n\n  const contracts =\n    featureFlags?.[FeatureFlag.EIP7702]?.contracts?.[\n      chainId.toLowerCase() as Hex\n    ] ?? [];\n\n  return contracts\n    .filter((contract) =>\n      isValidSignature(\n        [contract.address, padHexToEvenLength(chainId) as Hex],\n        contract.signature,\n        publicKey,\n      ),\n    )\n    .map((contract) => contract.address);\n}\n\n/**\n * Retrieves the EIP-7702 upgrade contract address.\n *\n * @param chainId - The chain ID.\n * @param messenger - The controller messenger instance.\n * @param publicKey - The public key used to validate the contract authenticity.\n * @returns The upgrade contract address.\n */\nexport function getEIP7702UpgradeContractAddress(\n  chainId: Hex,\n  messenger: TransactionControllerMessenger,\n  publicKey: Hex,\n): Hex | undefined {\n  return getEIP7702ContractAddresses(chainId, messenger, publicKey)?.[0];\n}\n\n/**\n * Retrieves the batch size limit.\n * Defaults to 10 if not set.\n *\n * @param messenger - The controller messenger instance.\n * @returns  The batch size limit.\n */\nexport function getBatchSizeLimit(\n  messenger: TransactionControllerMessenger,\n): number {\n  const featureFlags = getFeatureFlags(messenger);\n  return (\n    featureFlags?.[FeatureFlag.Transactions]?.batchSizeLimit ??\n    DEFAULT_BATCH_SIZE_LIMIT\n  );\n}\n\n/**\n * Retrieves the submit history limit.\n * Defaults to 100 if not set.\n *\n * @param messenger - The controller messenger instance.\n * @returns The submit history limit.\n */\nexport function getSubmitHistoryLimit(\n  messenger: TransactionControllerMessenger,\n): number {\n  const featureFlags = getFeatureFlags(messenger);\n  return (\n    featureFlags?.[FeatureFlag.Transactions]?.submitHistoryLimit ??\n    DEFAULT_SUBMIT_HISTORY_LIMIT\n  );\n}\n\n/**\n * Retrieves the transaction history limit.\n * Defaults to 40 if not set.\n *\n * @param messenger - The controller messenger instance.\n * @returns The transaction history limit.\n */\nexport function getTransactionHistoryLimit(\n  messenger: TransactionControllerMessenger,\n): number | undefined {\n  const featureFlags = getFeatureFlags(messenger);\n\n  if (!featureFlags) {\n    return undefined;\n  }\n\n  return (\n    featureFlags[FeatureFlag.Transactions]?.transactionHistoryLimit ??\n    DEFAULT_TRANSACTION_HISTORY_LIMIT\n  );\n}\n\n/**\n * Retrieves the accelerated polling parameters for a given chain ID.\n *\n * @param chainId - The chain ID.\n * @param messenger - The controller messenger instance.\n * @returns The accelerated polling parameters: `countMax` and `intervalMs`.\n */\nexport function getAcceleratedPollingParams(\n  chainId: Hex,\n  messenger: TransactionControllerMessenger,\n): { blockTime: number; countMax: number; intervalMs: number } {\n  const featureFlags = getFeatureFlags(messenger);\n\n  const acceleratedPollingParams =\n    featureFlags?.[FeatureFlag.Transactions]?.acceleratedPolling;\n\n  const countMax =\n    acceleratedPollingParams?.perChainConfig?.[chainId]?.countMax ??\n    acceleratedPollingParams?.defaultCountMax ??\n    DEFAULT_ACCELERATED_POLLING_COUNT_MAX;\n\n  const intervalMs =\n    acceleratedPollingParams?.perChainConfig?.[chainId]?.intervalMs ??\n    acceleratedPollingParams?.defaultIntervalMs ??\n    DEFAULT_ACCELERATED_POLLING_INTERVAL_MS;\n\n  const blockTime =\n    acceleratedPollingParams?.perChainConfig?.[chainId]?.blockTime ??\n    DEFAULT_BLOCK_TIME;\n\n  return { blockTime, countMax, intervalMs };\n}\n\n/**\n * Retrieves the gas fee randomisation parameters.\n *\n * @param messenger - The controller messenger instance.\n * @returns The gas fee randomisation parameters.\n */\nexport function getGasFeeRandomisation(\n  messenger: TransactionControllerMessenger,\n): {\n  randomisedGasFeeDigits: Record<Hex, number>;\n  preservedNumberOfDigits: number | undefined;\n} {\n  const featureFlags = getFeatureFlags(messenger);\n\n  const gasFeeRandomisation =\n    featureFlags?.[FeatureFlag.Transactions]?.gasFeeRandomisation ?? {};\n\n  return {\n    randomisedGasFeeDigits: gasFeeRandomisation.randomisedGasFeeDigits ?? {},\n    preservedNumberOfDigits: gasFeeRandomisation.preservedNumberOfDigits,\n  };\n}\n\n/**\n * Retrieves the gas estimate fallback for a given chain ID.\n * Defaults to the default gas estimate fallback if not set.\n *\n * @param chainId - The chain ID.\n * @param messenger - The controller messenger instance.\n * @returns The gas estimate fallback.\n */\nexport function getGasEstimateFallback(\n  chainId: Hex,\n  messenger: TransactionControllerMessenger,\n): {\n  fixed?: number;\n  percentage: number;\n  maxGasLimit?: number;\n} {\n  const featureFlags = getFeatureFlags(messenger);\n\n  const gasEstimateFallbackFlags =\n    featureFlags?.[FeatureFlag.Transactions]?.gasEstimateFallback;\n\n  const chainFlags = gasEstimateFallbackFlags?.perChainConfig?.[chainId];\n\n  const percentage =\n    chainFlags?.percentage ??\n    gasEstimateFallbackFlags?.default?.percentage ??\n    DEFAULT_GAS_ESTIMATE_FALLBACK_BLOCK_PERCENT;\n\n  const fixed = chainFlags?.fixed ?? gasEstimateFallbackFlags?.default?.fixed;\n\n  const maxGasLimit =\n    chainFlags?.maxGasLimit ?? gasEstimateFallbackFlags?.default?.maxGasLimit;\n\n  return { fixed, percentage, maxGasLimit };\n}\n\n/**\n * Retrieves the gas buffers for a given chain ID.\n *\n * @param request - The request object.\n * @param request.chainId - The chain ID.\n * @param request.isCustomRPC - Whether the network RPC is added by the user.\n * @param request.isUpgradeWithData - Whether the transaction is an EIP-7702 upgrade combined with a call.\n * @param request.messenger - The controller messenger instance.\n * @returns The gas buffers.\n */\nexport function getGasEstimateBuffer({\n  chainId,\n  isCustomRPC,\n  isUpgradeWithData,\n  messenger,\n}: {\n  chainId: Hex;\n  isCustomRPC: boolean;\n  isUpgradeWithData: boolean;\n  messenger: TransactionControllerMessenger;\n}): number {\n  const featureFlags = getFeatureFlags(messenger);\n  const gasBufferFlags = featureFlags?.[FeatureFlag.GasBuffer];\n  const chainFlags = gasBufferFlags?.perChainConfig?.[chainId];\n  const chainIncludedRPCBuffer = isCustomRPC ? undefined : chainFlags?.included;\n\n  const defaultIncludedRPCBuffer = isCustomRPC\n    ? undefined\n    : gasBufferFlags?.included;\n\n  const upgradeBuffer = isUpgradeWithData ? chainFlags?.eip7702 : undefined;\n\n  return (\n    upgradeBuffer ??\n    chainIncludedRPCBuffer ??\n    chainFlags?.base ??\n    defaultIncludedRPCBuffer ??\n    gasBufferFlags?.default ??\n    DEFAULT_GAS_ESTIMATE_BUFFER\n  );\n}\n\n/**\n * Retrieves the incoming transactions polling interval.\n * Retrieves the number of attempts to wait before automatically marking a transaction as dropped\n * if it has no receipt status.\n *\n * @param chainId - The chain ID.\n * @param messenger - The controller messenger instance.\n * @returns The threshold number of attempts, or undefined if the feature is disabled.\n */\nexport function getTimeoutAttempts(\n  chainId: Hex,\n  messenger: TransactionControllerMessenger,\n): number | undefined {\n  const featureFlags = getFeatureFlags(messenger);\n\n  const timeoutAttemptsFlags =\n    featureFlags?.[FeatureFlag.Transactions]?.timeoutAttempts;\n\n  return (\n    timeoutAttemptsFlags?.perChainConfig?.[chainId] ??\n    timeoutAttemptsFlags?.default\n  );\n}\n\n/**\n * Retrieves the relevant feature flags from the remote feature flag controller.\n *\n * @param messenger - The messenger instance.\n * @returns The feature flags.\n */\nfunction getFeatureFlags(\n  messenger: TransactionControllerMessenger,\n): TransactionControllerFeatureFlags | undefined {\n  try {\n    const featureFlags = messenger.call(\n      'RemoteFeatureFlagController:getState',\n    ).remoteFeatureFlags;\n\n    log('Retrieved feature flags', featureFlags);\n\n    return featureFlags as TransactionControllerFeatureFlags;\n  } catch {\n    log('RemoteFeatureFlagController not available');\n    return undefined;\n  }\n}\n"]}
+{"version":3,"file":"feature-flags.cjs","sourceRoot":"","sources":["../../src/utils/feature-flags.ts"],"names":[],"mappings":"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","sourcesContent":["import { createModuleLogger } from '@metamask/utils';\nimport type { Hex } from '@metamask/utils';\n\nimport { projectLogger } from '../logger.js';\nimport type { TransactionControllerMessenger } from '../TransactionController.js';\nimport { isValidSignature } from './signature.js';\nimport { padHexToEvenLength } from './utils.js';\n\nconst DEFAULT_BATCH_SIZE_LIMIT = 10;\nconst DEFAULT_ACCELERATED_POLLING_COUNT_MAX = 10;\nconst DEFAULT_ACCELERATED_POLLING_INTERVAL_MS = 3 * 1000;\nconst DEFAULT_BLOCK_TIME = 12 * 1000;\nconst DEFAULT_GAS_ESTIMATE_FALLBACK_BLOCK_PERCENT = 35;\nconst DEFAULT_GAS_ESTIMATE_BUFFER = 1;\nconst DEFAULT_SUBMIT_HISTORY_LIMIT = 100;\nconst DEFAULT_TRANSACTION_HISTORY_LIMIT = 40;\n\n/**\n * Feature flags supporting the transaction controller.\n */\nexport enum FeatureFlag {\n  EIP7702 = 'confirmations_eip_7702',\n  GasBuffer = 'confirmations_gas_buffer',\n  Transactions = 'confirmations_transactions',\n}\n\ntype GasEstimateFallback = {\n  /**\n   * The fixed gas estimate fallback for a transaction.\n   */\n  fixed?: number;\n\n  /**\n   * The percentage multiplier gas estimate fallback for a transaction.\n   */\n  percentage?: number;\n\n  /**\n   * The maximum gas limit the fallback can resolve to, representing the chain's\n   * per-transaction gas cap. Clamps the `fixed` or `percentage`-derived fallback\n   * so it can never exceed the gas limit the RPC will accept (e.g. ~33.5M on\n   * Polygon, whereas 35% of its ~140M block gas limit would otherwise be ~49M).\n   */\n  maxGasLimit?: number;\n};\n\nexport type TransactionControllerFeatureFlags = {\n  /** Feature flags to support EIP-7702 / type-4 transactions. */\n  [FeatureFlag.EIP7702]?: {\n    /**\n     * All contracts that support EIP-7702 batch transactions.\n     * Keyed by chain ID.\n     * First entry in each array is the contract that standard EOAs will be upgraded to.\n     */\n    contracts?: Record<\n      Hex,\n      {\n        /** Address of the smart contract. */\n        address: Hex;\n\n        /** Signature to verify the contract is authentic. */\n        signature: Hex;\n      }[]\n    >;\n\n    /** Chains enabled for EIP-7702 batch transactions. */\n    supportedChains?: Hex[];\n  };\n\n  /**\n   * Buffers added to gas limit estimations.\n   * Values are multipliers such as `1.5` meaning 150% of the original gas limit.\n   */\n  [FeatureFlag.GasBuffer]?: {\n    /** Fallback buffer for all chains and transactions. */\n    default?: number;\n\n    /**\n     * Buffer for included network RPCs only and not those added by user.\n     * Takes priority over `default`.\n     */\n    included?: number;\n\n    /** Buffers for specific chains. */\n    perChainConfig?: {\n      [chainId: Hex]: {\n        /**\n         * Buffer for the chain for all transactions.\n         * Takes priority over non-chain `included`.\n         */\n        base?: number;\n\n        /**\n         * Buffer if network RPC is included and not added by user.\n         * Takes priority over `base`.\n         */\n        included?: number;\n\n        /**\n         * Buffer for the chain for EIP-7702 / type 4 transactions only.\n         * Only if `data` included and `to` matches `from`.\n         * Takes priority over `included` and `base`.\n         */\n        eip7702?: number;\n      };\n    };\n  };\n\n  /** Miscellaneous feature flags to support the transaction controller. */\n  [FeatureFlag.Transactions]?: {\n    /** Maximum number of transactions that can be in an external batch. */\n    batchSizeLimit?: number;\n\n    /** Maximum number of entries in the submit history. */\n    submitHistoryLimit?: number;\n\n    /** Maximum number of transactions stored in state. */\n    transactionHistoryLimit?: number;\n\n    /**\n     * Accelerated polling is used to speed up the polling process for\n     * transactions that are not yet confirmed.\n     */\n    acceleratedPolling?: {\n      /** Accelerated polling parameters on a per-chain basis. */\n      perChainConfig?: {\n        [chainId: Hex]: {\n          /**\n           * Block time in milliseconds.\n           */\n          blockTime?: number;\n\n          /**\n           * Maximum number of polling requests that can be made in a row, before\n           * the normal polling resumes.\n           */\n          countMax?: number;\n\n          /** Interval between polling requests in milliseconds. */\n          intervalMs?: number;\n        };\n      };\n\n      /** Default `countMax` in case no chain-specific parameter is set. */\n      defaultCountMax?: number;\n\n      /** Default `intervalMs` in case no chain-specific parameter is set. */\n      defaultIntervalMs?: number;\n    };\n\n    gasFeeRandomisation?: {\n      /** Randomised gas fee digits per chainId. */\n      randomisedGasFeeDigits?: Record<Hex, number>;\n\n      /** Number of digits to preserve for randomised gas fee digits. */\n      preservedNumberOfDigits?: number;\n    };\n\n    /** Gas estimate fallback is used as a fallback in case of failure to obtain the gas estimate values. */\n    gasEstimateFallback?: {\n      /** Gas estimate fallback per-chain basis. */\n      perChainConfig?: {\n        [chainId: Hex]: GasEstimateFallback;\n      };\n\n      /**\n       * Default gas estimate fallback.\n       * This value is used when no specific gas estimate fallback is found for a chain ID.\n       */\n      default?: GasEstimateFallback;\n    };\n\n    /**\n     * Number of attempts to wait before automatically marking a transaction as failed\n     * if it has no receipt status and hash is not found on the network.\n     */\n    timeoutAttempts?: {\n      /** Automatic fail threshold on a per-chain basis. */\n      perChainConfig?: {\n        [chainId: Hex]: number;\n      };\n\n      /**\n       * Default automatic fail threshold.\n       * This value is used when no specific threshold is found for a chain ID.\n       */\n      default?: number;\n    };\n\n    /**\n     * Replacement of underpriced dapp-suggested gas fees.\n     * If enabled, dapp-suggested EIP-1559 fees with a `maxFeePerGas` below the\n     * current low estimate are replaced with the wallet's suggested fees, as\n     * they are unlikely to be included in a block before fee values change.\n     */\n    replaceUnderpricedDappGasFees?: {\n      /** Enablement on a per-chain basis. */\n      perChainConfig?: {\n        [chainId: Hex]: boolean;\n      };\n\n      /**\n       * Default enablement.\n       * This value is used when no specific value is found for a chain ID.\n       */\n      default?: boolean;\n    };\n\n    /**\n     * Replacement of underpriced saved (advanced) gas fee preferences.\n     * If enabled, saved custom fees with a `maxBaseFee` below the current low\n     * estimate are ignored in favour of the wallet's suggested fees, as they\n     * are unlikely to be included in a block before fee values change.\n     * Level-based saved preferences track current estimates and are never\n     * ignored.\n     */\n    replaceUnderpricedSavedGasFees?: {\n      /** Enablement on a per-chain basis. */\n      perChainConfig?: {\n        [chainId: Hex]: boolean;\n      };\n\n      /**\n       * Default enablement.\n       * This value is used when no specific value is found for a chain ID.\n       */\n      default?: boolean;\n    };\n  };\n};\n\nconst log = createModuleLogger(projectLogger, 'feature-flags');\n\n/**\n * Retrieves the supported EIP-7702 chains.\n *\n * @param messenger - The controller messenger instance.\n * @returns The supported chains.\n */\nexport function getEIP7702SupportedChains(\n  messenger: TransactionControllerMessenger,\n): Hex[] {\n  const featureFlags = getFeatureFlags(messenger);\n  return featureFlags?.[FeatureFlag.EIP7702]?.supportedChains ?? [];\n}\n\n/**\n * Retrieves the supported EIP-7702 contract addresses for a given chain ID.\n *\n * @param chainId - The chain ID.\n * @param messenger - The controller messenger instance.\n * @param publicKey - The public key used to validate the contract authenticity.\n * @returns The supported contract addresses.\n */\nexport function getEIP7702ContractAddresses(\n  chainId: Hex,\n  messenger: TransactionControllerMessenger,\n  publicKey: Hex,\n): Hex[] {\n  const featureFlags = getFeatureFlags(messenger);\n\n  const contracts =\n    featureFlags?.[FeatureFlag.EIP7702]?.contracts?.[\n      chainId.toLowerCase() as Hex\n    ] ?? [];\n\n  return contracts\n    .filter((contract) =>\n      isValidSignature(\n        [contract.address, padHexToEvenLength(chainId) as Hex],\n        contract.signature,\n        publicKey,\n      ),\n    )\n    .map((contract) => contract.address);\n}\n\n/**\n * Retrieves the EIP-7702 upgrade contract address.\n *\n * @param chainId - The chain ID.\n * @param messenger - The controller messenger instance.\n * @param publicKey - The public key used to validate the contract authenticity.\n * @returns The upgrade contract address.\n */\nexport function getEIP7702UpgradeContractAddress(\n  chainId: Hex,\n  messenger: TransactionControllerMessenger,\n  publicKey: Hex,\n): Hex | undefined {\n  return getEIP7702ContractAddresses(chainId, messenger, publicKey)?.[0];\n}\n\n/**\n * Retrieves the batch size limit.\n * Defaults to 10 if not set.\n *\n * @param messenger - The controller messenger instance.\n * @returns  The batch size limit.\n */\nexport function getBatchSizeLimit(\n  messenger: TransactionControllerMessenger,\n): number {\n  const featureFlags = getFeatureFlags(messenger);\n  return (\n    featureFlags?.[FeatureFlag.Transactions]?.batchSizeLimit ??\n    DEFAULT_BATCH_SIZE_LIMIT\n  );\n}\n\n/**\n * Retrieves the submit history limit.\n * Defaults to 100 if not set.\n *\n * @param messenger - The controller messenger instance.\n * @returns The submit history limit.\n */\nexport function getSubmitHistoryLimit(\n  messenger: TransactionControllerMessenger,\n): number {\n  const featureFlags = getFeatureFlags(messenger);\n  return (\n    featureFlags?.[FeatureFlag.Transactions]?.submitHistoryLimit ??\n    DEFAULT_SUBMIT_HISTORY_LIMIT\n  );\n}\n\n/**\n * Retrieves the transaction history limit.\n * Defaults to 40 if not set.\n *\n * @param messenger - The controller messenger instance.\n * @returns The transaction history limit.\n */\nexport function getTransactionHistoryLimit(\n  messenger: TransactionControllerMessenger,\n): number | undefined {\n  const featureFlags = getFeatureFlags(messenger);\n\n  if (!featureFlags) {\n    return undefined;\n  }\n\n  return (\n    featureFlags[FeatureFlag.Transactions]?.transactionHistoryLimit ??\n    DEFAULT_TRANSACTION_HISTORY_LIMIT\n  );\n}\n\n/**\n * Retrieves the accelerated polling parameters for a given chain ID.\n *\n * @param chainId - The chain ID.\n * @param messenger - The controller messenger instance.\n * @returns The accelerated polling parameters: `countMax` and `intervalMs`.\n */\nexport function getAcceleratedPollingParams(\n  chainId: Hex,\n  messenger: TransactionControllerMessenger,\n): { blockTime: number; countMax: number; intervalMs: number } {\n  const featureFlags = getFeatureFlags(messenger);\n\n  const acceleratedPollingParams =\n    featureFlags?.[FeatureFlag.Transactions]?.acceleratedPolling;\n\n  const countMax =\n    acceleratedPollingParams?.perChainConfig?.[chainId]?.countMax ??\n    acceleratedPollingParams?.defaultCountMax ??\n    DEFAULT_ACCELERATED_POLLING_COUNT_MAX;\n\n  const intervalMs =\n    acceleratedPollingParams?.perChainConfig?.[chainId]?.intervalMs ??\n    acceleratedPollingParams?.defaultIntervalMs ??\n    DEFAULT_ACCELERATED_POLLING_INTERVAL_MS;\n\n  const blockTime =\n    acceleratedPollingParams?.perChainConfig?.[chainId]?.blockTime ??\n    DEFAULT_BLOCK_TIME;\n\n  return { blockTime, countMax, intervalMs };\n}\n\n/**\n * Retrieves the gas fee randomisation parameters.\n *\n * @param messenger - The controller messenger instance.\n * @returns The gas fee randomisation parameters.\n */\nexport function getGasFeeRandomisation(\n  messenger: TransactionControllerMessenger,\n): {\n  randomisedGasFeeDigits: Record<Hex, number>;\n  preservedNumberOfDigits: number | undefined;\n} {\n  const featureFlags = getFeatureFlags(messenger);\n\n  const gasFeeRandomisation =\n    featureFlags?.[FeatureFlag.Transactions]?.gasFeeRandomisation ?? {};\n\n  return {\n    randomisedGasFeeDigits: gasFeeRandomisation.randomisedGasFeeDigits ?? {},\n    preservedNumberOfDigits: gasFeeRandomisation.preservedNumberOfDigits,\n  };\n}\n\n/**\n * Retrieves the gas estimate fallback for a given chain ID.\n * Defaults to the default gas estimate fallback if not set.\n *\n * @param chainId - The chain ID.\n * @param messenger - The controller messenger instance.\n * @returns The gas estimate fallback.\n */\nexport function getGasEstimateFallback(\n  chainId: Hex,\n  messenger: TransactionControllerMessenger,\n): {\n  fixed?: number;\n  percentage: number;\n  maxGasLimit?: number;\n} {\n  const featureFlags = getFeatureFlags(messenger);\n\n  const gasEstimateFallbackFlags =\n    featureFlags?.[FeatureFlag.Transactions]?.gasEstimateFallback;\n\n  const chainFlags = gasEstimateFallbackFlags?.perChainConfig?.[chainId];\n\n  const percentage =\n    chainFlags?.percentage ??\n    gasEstimateFallbackFlags?.default?.percentage ??\n    DEFAULT_GAS_ESTIMATE_FALLBACK_BLOCK_PERCENT;\n\n  const fixed = chainFlags?.fixed ?? gasEstimateFallbackFlags?.default?.fixed;\n\n  const maxGasLimit =\n    chainFlags?.maxGasLimit ?? gasEstimateFallbackFlags?.default?.maxGasLimit;\n\n  return { fixed, percentage, maxGasLimit };\n}\n\n/**\n * Retrieves the gas buffers for a given chain ID.\n *\n * @param request - The request object.\n * @param request.chainId - The chain ID.\n * @param request.isCustomRPC - Whether the network RPC is added by the user.\n * @param request.isUpgradeWithData - Whether the transaction is an EIP-7702 upgrade combined with a call.\n * @param request.messenger - The controller messenger instance.\n * @returns The gas buffers.\n */\nexport function getGasEstimateBuffer({\n  chainId,\n  isCustomRPC,\n  isUpgradeWithData,\n  messenger,\n}: {\n  chainId: Hex;\n  isCustomRPC: boolean;\n  isUpgradeWithData: boolean;\n  messenger: TransactionControllerMessenger;\n}): number {\n  const featureFlags = getFeatureFlags(messenger);\n  const gasBufferFlags = featureFlags?.[FeatureFlag.GasBuffer];\n  const chainFlags = gasBufferFlags?.perChainConfig?.[chainId];\n  const chainIncludedRPCBuffer = isCustomRPC ? undefined : chainFlags?.included;\n\n  const defaultIncludedRPCBuffer = isCustomRPC\n    ? undefined\n    : gasBufferFlags?.included;\n\n  const upgradeBuffer = isUpgradeWithData ? chainFlags?.eip7702 : undefined;\n\n  return (\n    upgradeBuffer ??\n    chainIncludedRPCBuffer ??\n    chainFlags?.base ??\n    defaultIncludedRPCBuffer ??\n    gasBufferFlags?.default ??\n    DEFAULT_GAS_ESTIMATE_BUFFER\n  );\n}\n\n/**\n * Retrieves the incoming transactions polling interval.\n * Retrieves the number of attempts to wait before automatically marking a transaction as dropped\n * if it has no receipt status.\n *\n * @param chainId - The chain ID.\n * @param messenger - The controller messenger instance.\n * @returns The threshold number of attempts, or undefined if the feature is disabled.\n */\nexport function getTimeoutAttempts(\n  chainId: Hex,\n  messenger: TransactionControllerMessenger,\n): number | undefined {\n  const featureFlags = getFeatureFlags(messenger);\n\n  const timeoutAttemptsFlags =\n    featureFlags?.[FeatureFlag.Transactions]?.timeoutAttempts;\n\n  return (\n    timeoutAttemptsFlags?.perChainConfig?.[chainId] ??\n    timeoutAttemptsFlags?.default\n  );\n}\n\n/**\n * Retrieves whether underpriced dapp-suggested gas fees should be replaced\n * with the wallet's suggested fees.\n *\n * @param chainId - The chain ID.\n * @param messenger - The controller messenger instance.\n * @returns Whether the replacement is enabled.\n */\nexport function getReplaceUnderpricedDappGasFeesEnabled(\n  chainId: Hex,\n  messenger: TransactionControllerMessenger,\n): boolean {\n  const featureFlags = getFeatureFlags(messenger);\n\n  const replaceUnderpricedDappGasFeesFlags =\n    featureFlags?.[FeatureFlag.Transactions]?.replaceUnderpricedDappGasFees;\n\n  return (\n    replaceUnderpricedDappGasFeesFlags?.perChainConfig?.[chainId] ??\n    replaceUnderpricedDappGasFeesFlags?.default ??\n    false\n  );\n}\n\n/**\n * Retrieves whether underpriced saved (advanced) gas fee preferences should be\n * ignored in favour of the wallet's suggested fees.\n *\n * @param chainId - The chain ID.\n * @param messenger - The controller messenger instance.\n * @returns Whether the replacement is enabled.\n */\nexport function getReplaceUnderpricedSavedGasFeesEnabled(\n  chainId: Hex,\n  messenger: TransactionControllerMessenger,\n): boolean {\n  const featureFlags = getFeatureFlags(messenger);\n\n  const replaceUnderpricedSavedGasFeesFlags =\n    featureFlags?.[FeatureFlag.Transactions]?.replaceUnderpricedSavedGasFees;\n\n  return (\n    replaceUnderpricedSavedGasFeesFlags?.perChainConfig?.[chainId] ??\n    replaceUnderpricedSavedGasFeesFlags?.default ??\n    false\n  );\n}\n\n/**\n * Retrieves the relevant feature flags from the remote feature flag controller.\n *\n * @param messenger - The messenger instance.\n * @returns The feature flags.\n */\nfunction getFeatureFlags(\n  messenger: TransactionControllerMessenger,\n): TransactionControllerFeatureFlags | undefined {\n  try {\n    const featureFlags = messenger.call(\n      'RemoteFeatureFlagController:getState',\n    ).remoteFeatureFlags;\n\n    log('Retrieved feature flags', featureFlags);\n\n    return featureFlags as TransactionControllerFeatureFlags;\n  } catch {\n    log('RemoteFeatureFlagController not available');\n    return undefined;\n  }\n}\n"]}

package/dist/utils/feature-flags.d.cts

@@ -143,6 +143,42 @@ export type TransactionControllerFeatureFlags = {
              */
             default?: number;
         };
+        /**
+         * Replacement of underpriced dapp-suggested gas fees.
+         * If enabled, dapp-suggested EIP-1559 fees with a `maxFeePerGas` below the
+         * current low estimate are replaced with the wallet's suggested fees, as
+         * they are unlikely to be included in a block before fee values change.
+         */
+        replaceUnderpricedDappGasFees?: {
+            /** Enablement on a per-chain basis. */
+            perChainConfig?: {
+                [chainId: Hex]: boolean;
+            };
+            /**
+             * Default enablement.
+             * This value is used when no specific value is found for a chain ID.
+             */
+            default?: boolean;
+        };
+        /**
+         * Replacement of underpriced saved (advanced) gas fee preferences.
+         * If enabled, saved custom fees with a `maxBaseFee` below the current low
+         * estimate are ignored in favour of the wallet's suggested fees, as they
+         * are unlikely to be included in a block before fee values change.
+         * Level-based saved preferences track current estimates and are never
+         * ignored.
+         */
+        replaceUnderpricedSavedGasFees?: {
+            /** Enablement on a per-chain basis. */
+            perChainConfig?: {
+                [chainId: Hex]: boolean;
+            };
+            /**
+             * Default enablement.
+             * This value is used when no specific value is found for a chain ID.
+             */
+            default?: boolean;
+        };
     };
 };
 /**
@@ -255,5 +291,23 @@ export declare function getGasEstimateBuffer({ chainId, isCustomRPC, isUpgradeWi
  * @returns The threshold number of attempts, or undefined if the feature is disabled.
  */
 export declare function getTimeoutAttempts(chainId: Hex, messenger: TransactionControllerMessenger): number | undefined;
+/**
+ * Retrieves whether underpriced dapp-suggested gas fees should be replaced
+ * with the wallet's suggested fees.
+ *
+ * @param chainId - The chain ID.
+ * @param messenger - The controller messenger instance.
+ * @returns Whether the replacement is enabled.
+ */
+export declare function getReplaceUnderpricedDappGasFeesEnabled(chainId: Hex, messenger: TransactionControllerMessenger): boolean;
+/**
+ * Retrieves whether underpriced saved (advanced) gas fee preferences should be
+ * ignored in favour of the wallet's suggested fees.
+ *
+ * @param chainId - The chain ID.
+ * @param messenger - The controller messenger instance.
+ * @returns Whether the replacement is enabled.
+ */
+export declare function getReplaceUnderpricedSavedGasFeesEnabled(chainId: Hex, messenger: TransactionControllerMessenger): boolean;
 export {};
 //# sourceMappingURL=feature-flags.d.cts.map

package/dist/utils/feature-flags.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-flags.d.cts","sourceRoot":"","sources":["../../src/utils/feature-flags.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"feature-flags.d.cts","sourceRoot":"","sources":["../../src/utils/feature-flags.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,wBAAwB;AAG3C,OAAO,KAAK,EAAE,8BAA8B,EAAE,qCAAoC;AAalF;;GAEG;AACH,oBAAY,WAAW;IACrB,OAAO,2BAA2B;IAClC,SAAS,6BAA6B;IACtC,YAAY,+BAA+B;CAC5C;AAED,KAAK,mBAAmB,GAAG;IACzB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG;IAC9C,+DAA+D;IAC/D,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,EAAE;QACtB;;;;WAIG;QACH,SAAS,CAAC,EAAE,MAAM,CAChB,GAAG,EACH;YACE,qCAAqC;YACrC,OAAO,EAAE,GAAG,CAAC;YAEb,qDAAqD;YACrD,SAAS,EAAE,GAAG,CAAC;SAChB,EAAE,CACJ,CAAC;QAEF,sDAAsD;QACtD,eAAe,CAAC,EAAE,GAAG,EAAE,CAAC;KACzB,CAAC;IAEF;;;OAGG;IACH,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE;QACxB,uDAAuD;QACvD,OAAO,CAAC,EAAE,MAAM,CAAC;QAEjB;;;WAGG;QACH,QAAQ,CAAC,EAAE,MAAM,CAAC;QAElB,mCAAmC;QACnC,cAAc,CAAC,EAAE;YACf,CAAC,OAAO,EAAE,GAAG,GAAG;gBACd;;;mBAGG;gBACH,IAAI,CAAC,EAAE,MAAM,CAAC;gBAEd;;;mBAGG;gBACH,QAAQ,CAAC,EAAE,MAAM,CAAC;gBAElB;;;;mBAIG;gBACH,OAAO,CAAC,EAAE,MAAM,CAAC;aAClB,CAAC;SACH,CAAC;KACH,CAAC;IAEF,yEAAyE;IACzE,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,EAAE;QAC3B,uEAAuE;QACvE,cAAc,CAAC,EAAE,MAAM,CAAC;QAExB,uDAAuD;QACvD,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAE5B,sDAAsD;QACtD,uBAAuB,CAAC,EAAE,MAAM,CAAC;QAEjC;;;WAGG;QACH,kBAAkB,CAAC,EAAE;YACnB,2DAA2D;YAC3D,cAAc,CAAC,EAAE;gBACf,CAAC,OAAO,EAAE,GAAG,GAAG;oBACd;;uBAEG;oBACH,SAAS,CAAC,EAAE,MAAM,CAAC;oBAEnB;;;uBAGG;oBACH,QAAQ,CAAC,EAAE,MAAM,CAAC;oBAElB,yDAAyD;oBACzD,UAAU,CAAC,EAAE,MAAM,CAAC;iBACrB,CAAC;aACH,CAAC;YAEF,qEAAqE;YACrE,eAAe,CAAC,EAAE,MAAM,CAAC;YAEzB,uEAAuE;YACvE,iBAAiB,CAAC,EAAE,MAAM,CAAC;SAC5B,CAAC;QAEF,mBAAmB,CAAC,EAAE;YACpB,6CAA6C;YAC7C,sBAAsB,CAAC,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAE7C,kEAAkE;YAClE,uBAAuB,CAAC,EAAE,MAAM,CAAC;SAClC,CAAC;QAEF,wGAAwG;QACxG,mBAAmB,CAAC,EAAE;YACpB,6CAA6C;YAC7C,cAAc,CAAC,EAAE;gBACf,CAAC,OAAO,EAAE,GAAG,GAAG,mBAAmB,CAAC;aACrC,CAAC;YAEF;;;eAGG;YACH,OAAO,CAAC,EAAE,mBAAmB,CAAC;SAC/B,CAAC;QAEF;;;WAGG;QACH,eAAe,CAAC,EAAE;YAChB,qDAAqD;YACrD,cAAc,CAAC,EAAE;gBACf,CAAC,OAAO,EAAE,GAAG,GAAG,MAAM,CAAC;aACxB,CAAC;YAEF;;;eAGG;YACH,OAAO,CAAC,EAAE,MAAM,CAAC;SAClB,CAAC;QAEF;;;;;WAKG;QACH,6BAA6B,CAAC,EAAE;YAC9B,uCAAuC;YACvC,cAAc,CAAC,EAAE;gBACf,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC;aACzB,CAAC;YAEF;;;eAGG;YACH,OAAO,CAAC,EAAE,OAAO,CAAC;SACnB,CAAC;QAEF;;;;;;;WAOG;QACH,8BAA8B,CAAC,EAAE;YAC/B,uCAAuC;YACvC,cAAc,CAAC,EAAE;gBACf,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC;aACzB,CAAC;YAEF;;;eAGG;YACH,OAAO,CAAC,EAAE,OAAO,CAAC;SACnB,CAAC;KACH,CAAC;CACH,CAAC;AAIF;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,8BAA8B,GACxC,GAAG,EAAE,CAGP;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,GAAG,EACZ,SAAS,EAAE,8BAA8B,EACzC,SAAS,EAAE,GAAG,GACb,GAAG,EAAE,CAiBP;AAED;;;;;;;GAOG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,GAAG,EACZ,SAAS,EAAE,8BAA8B,EACzC,SAAS,EAAE,GAAG,GACb,GAAG,GAAG,SAAS,CAEjB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,8BAA8B,GACxC,MAAM,CAMR;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,8BAA8B,GACxC,MAAM,CAMR;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,8BAA8B,GACxC,MAAM,GAAG,SAAS,CAWpB;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,GAAG,EACZ,SAAS,EAAE,8BAA8B,GACxC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAqB7D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,8BAA8B,GACxC;IACD,sBAAsB,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC5C,uBAAuB,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7C,CAUA;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,GAAG,EACZ,SAAS,EAAE,8BAA8B,GACxC;IACD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAmBA;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,OAAO,EACP,WAAW,EACX,iBAAiB,EACjB,SAAS,GACV,EAAE;IACD,OAAO,EAAE,GAAG,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;IACrB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,SAAS,EAAE,8BAA8B,CAAC;CAC3C,GAAG,MAAM,CAoBT;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,GAAG,EACZ,SAAS,EAAE,8BAA8B,GACxC,MAAM,GAAG,SAAS,CAUpB;AAED;;;;;;;GAOG;AACH,wBAAgB,uCAAuC,CACrD,OAAO,EAAE,GAAG,EACZ,SAAS,EAAE,8BAA8B,GACxC,OAAO,CAWT;AAED;;;;;;;GAOG;AACH,wBAAgB,wCAAwC,CACtD,OAAO,EAAE,GAAG,EACZ,SAAS,EAAE,8BAA8B,GACxC,OAAO,CAWT"}

package/dist/utils/feature-flags.d.mts

@@ -143,6 +143,42 @@ export type TransactionControllerFeatureFlags = {
              */
             default?: number;
         };
+        /**
+         * Replacement of underpriced dapp-suggested gas fees.
+         * If enabled, dapp-suggested EIP-1559 fees with a `maxFeePerGas` below the
+         * current low estimate are replaced with the wallet's suggested fees, as
+         * they are unlikely to be included in a block before fee values change.
+         */
+        replaceUnderpricedDappGasFees?: {
+            /** Enablement on a per-chain basis. */
+            perChainConfig?: {
+                [chainId: Hex]: boolean;
+            };
+            /**
+             * Default enablement.
+             * This value is used when no specific value is found for a chain ID.
+             */
+            default?: boolean;
+        };
+        /**
+         * Replacement of underpriced saved (advanced) gas fee preferences.
+         * If enabled, saved custom fees with a `maxBaseFee` below the current low
+         * estimate are ignored in favour of the wallet's suggested fees, as they
+         * are unlikely to be included in a block before fee values change.
+         * Level-based saved preferences track current estimates and are never
+         * ignored.
+         */
+        replaceUnderpricedSavedGasFees?: {
+            /** Enablement on a per-chain basis. */
+            perChainConfig?: {
+                [chainId: Hex]: boolean;
+            };
+            /**
+             * Default enablement.
+             * This value is used when no specific value is found for a chain ID.
+             */
+            default?: boolean;
+        };
     };
 };
 /**
@@ -255,5 +291,23 @@ export declare function getGasEstimateBuffer({ chainId, isCustomRPC, isUpgradeWi
  * @returns The threshold number of attempts, or undefined if the feature is disabled.
  */
 export declare function getTimeoutAttempts(chainId: Hex, messenger: TransactionControllerMessenger): number | undefined;
+/**
+ * Retrieves whether underpriced dapp-suggested gas fees should be replaced
+ * with the wallet's suggested fees.
+ *
+ * @param chainId - The chain ID.
+ * @param messenger - The controller messenger instance.
+ * @returns Whether the replacement is enabled.
+ */
+export declare function getReplaceUnderpricedDappGasFeesEnabled(chainId: Hex, messenger: TransactionControllerMessenger): boolean;
+/**
+ * Retrieves whether underpriced saved (advanced) gas fee preferences should be
+ * ignored in favour of the wallet's suggested fees.
+ *
+ * @param chainId - The chain ID.
+ * @param messenger - The controller messenger instance.
+ * @returns Whether the replacement is enabled.
+ */
+export declare function getReplaceUnderpricedSavedGasFeesEnabled(chainId: Hex, messenger: TransactionControllerMessenger): boolean;
 export {};
 //# sourceMappingURL=feature-flags.d.mts.map

package/dist/utils/feature-flags.d.mts.map

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

package/dist/utils/feature-flags.mjs

@@ -189,6 +189,36 @@ export function getTimeoutAttempts(chainId, messenger) {
     return (timeoutAttemptsFlags?.perChainConfig?.[chainId] ??
         timeoutAttemptsFlags?.default);
 }
+/**
+ * Retrieves whether underpriced dapp-suggested gas fees should be replaced
+ * with the wallet's suggested fees.
+ *
+ * @param chainId - The chain ID.
+ * @param messenger - The controller messenger instance.
+ * @returns Whether the replacement is enabled.
+ */
+export function getReplaceUnderpricedDappGasFeesEnabled(chainId, messenger) {
+    const featureFlags = getFeatureFlags(messenger);
+    const replaceUnderpricedDappGasFeesFlags = featureFlags?.[FeatureFlag.Transactions]?.replaceUnderpricedDappGasFees;
+    return (replaceUnderpricedDappGasFeesFlags?.perChainConfig?.[chainId] ??
+        replaceUnderpricedDappGasFeesFlags?.default ??
+        false);
+}
+/**
+ * Retrieves whether underpriced saved (advanced) gas fee preferences should be
+ * ignored in favour of the wallet's suggested fees.
+ *
+ * @param chainId - The chain ID.
+ * @param messenger - The controller messenger instance.
+ * @returns Whether the replacement is enabled.
+ */
+export function getReplaceUnderpricedSavedGasFeesEnabled(chainId, messenger) {
+    const featureFlags = getFeatureFlags(messenger);
+    const replaceUnderpricedSavedGasFeesFlags = featureFlags?.[FeatureFlag.Transactions]?.replaceUnderpricedSavedGasFees;
+    return (replaceUnderpricedSavedGasFeesFlags?.perChainConfig?.[chainId] ??
+        replaceUnderpricedSavedGasFeesFlags?.default ??
+        false);
+}
 /**
  * Retrieves the relevant feature flags from the remote feature flag controller.
  *

package/dist/utils/feature-flags.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"feature-flags.mjs","sourceRoot":"","sources":["../../src/utils/feature-flags.ts"],"names":[],"mappings":"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","sourcesContent":["import { createModuleLogger } from '@metamask/utils';\nimport type { Hex } from '@metamask/utils';\n\nimport { projectLogger } from '../logger.js';\nimport type { TransactionControllerMessenger } from '../TransactionController.js';\nimport { isValidSignature } from './signature.js';\nimport { padHexToEvenLength } from './utils.js';\n\nconst DEFAULT_BATCH_SIZE_LIMIT = 10;\nconst DEFAULT_ACCELERATED_POLLING_COUNT_MAX = 10;\nconst DEFAULT_ACCELERATED_POLLING_INTERVAL_MS = 3 * 1000;\nconst DEFAULT_BLOCK_TIME = 12 * 1000;\nconst DEFAULT_GAS_ESTIMATE_FALLBACK_BLOCK_PERCENT = 35;\nconst DEFAULT_GAS_ESTIMATE_BUFFER = 1;\nconst DEFAULT_SUBMIT_HISTORY_LIMIT = 100;\nconst DEFAULT_TRANSACTION_HISTORY_LIMIT = 40;\n\n/**\n * Feature flags supporting the transaction controller.\n */\nexport enum FeatureFlag {\n  EIP7702 = 'confirmations_eip_7702',\n  GasBuffer = 'confirmations_gas_buffer',\n  Transactions = 'confirmations_transactions',\n}\n\ntype GasEstimateFallback = {\n  /**\n   * The fixed gas estimate fallback for a transaction.\n   */\n  fixed?: number;\n\n  /**\n   * The percentage multiplier gas estimate fallback for a transaction.\n   */\n  percentage?: number;\n\n  /**\n   * The maximum gas limit the fallback can resolve to, representing the chain's\n   * per-transaction gas cap. Clamps the `fixed` or `percentage`-derived fallback\n   * so it can never exceed the gas limit the RPC will accept (e.g. ~33.5M on\n   * Polygon, whereas 35% of its ~140M block gas limit would otherwise be ~49M).\n   */\n  maxGasLimit?: number;\n};\n\nexport type TransactionControllerFeatureFlags = {\n  /** Feature flags to support EIP-7702 / type-4 transactions. */\n  [FeatureFlag.EIP7702]?: {\n    /**\n     * All contracts that support EIP-7702 batch transactions.\n     * Keyed by chain ID.\n     * First entry in each array is the contract that standard EOAs will be upgraded to.\n     */\n    contracts?: Record<\n      Hex,\n      {\n        /** Address of the smart contract. */\n        address: Hex;\n\n        /** Signature to verify the contract is authentic. */\n        signature: Hex;\n      }[]\n    >;\n\n    /** Chains enabled for EIP-7702 batch transactions. */\n    supportedChains?: Hex[];\n  };\n\n  /**\n   * Buffers added to gas limit estimations.\n   * Values are multipliers such as `1.5` meaning 150% of the original gas limit.\n   */\n  [FeatureFlag.GasBuffer]?: {\n    /** Fallback buffer for all chains and transactions. */\n    default?: number;\n\n    /**\n     * Buffer for included network RPCs only and not those added by user.\n     * Takes priority over `default`.\n     */\n    included?: number;\n\n    /** Buffers for specific chains. */\n    perChainConfig?: {\n      [chainId: Hex]: {\n        /**\n         * Buffer for the chain for all transactions.\n         * Takes priority over non-chain `included`.\n         */\n        base?: number;\n\n        /**\n         * Buffer if network RPC is included and not added by user.\n         * Takes priority over `base`.\n         */\n        included?: number;\n\n        /**\n         * Buffer for the chain for EIP-7702 / type 4 transactions only.\n         * Only if `data` included and `to` matches `from`.\n         * Takes priority over `included` and `base`.\n         */\n        eip7702?: number;\n      };\n    };\n  };\n\n  /** Miscellaneous feature flags to support the transaction controller. */\n  [FeatureFlag.Transactions]?: {\n    /** Maximum number of transactions that can be in an external batch. */\n    batchSizeLimit?: number;\n\n    /** Maximum number of entries in the submit history. */\n    submitHistoryLimit?: number;\n\n    /** Maximum number of transactions stored in state. */\n    transactionHistoryLimit?: number;\n\n    /**\n     * Accelerated polling is used to speed up the polling process for\n     * transactions that are not yet confirmed.\n     */\n    acceleratedPolling?: {\n      /** Accelerated polling parameters on a per-chain basis. */\n      perChainConfig?: {\n        [chainId: Hex]: {\n          /**\n           * Block time in milliseconds.\n           */\n          blockTime?: number;\n\n          /**\n           * Maximum number of polling requests that can be made in a row, before\n           * the normal polling resumes.\n           */\n          countMax?: number;\n\n          /** Interval between polling requests in milliseconds. */\n          intervalMs?: number;\n        };\n      };\n\n      /** Default `countMax` in case no chain-specific parameter is set. */\n      defaultCountMax?: number;\n\n      /** Default `intervalMs` in case no chain-specific parameter is set. */\n      defaultIntervalMs?: number;\n    };\n\n    gasFeeRandomisation?: {\n      /** Randomised gas fee digits per chainId. */\n      randomisedGasFeeDigits?: Record<Hex, number>;\n\n      /** Number of digits to preserve for randomised gas fee digits. */\n      preservedNumberOfDigits?: number;\n    };\n\n    /** Gas estimate fallback is used as a fallback in case of failure to obtain the gas estimate values. */\n    gasEstimateFallback?: {\n      /** Gas estimate fallback per-chain basis. */\n      perChainConfig?: {\n        [chainId: Hex]: GasEstimateFallback;\n      };\n\n      /**\n       * Default gas estimate fallback.\n       * This value is used when no specific gas estimate fallback is found for a chain ID.\n       */\n      default?: GasEstimateFallback;\n    };\n\n    /**\n     * Number of attempts to wait before automatically marking a transaction as failed\n     * if it has no receipt status and hash is not found on the network.\n     */\n    timeoutAttempts?: {\n      /** Automatic fail threshold on a per-chain basis. */\n      perChainConfig?: {\n        [chainId: Hex]: number;\n      };\n\n      /**\n       * Default automatic fail threshold.\n       * This value is used when no specific threshold is found for a chain ID.\n       */\n      default?: number;\n    };\n  };\n};\n\nconst log = createModuleLogger(projectLogger, 'feature-flags');\n\n/**\n * Retrieves the supported EIP-7702 chains.\n *\n * @param messenger - The controller messenger instance.\n * @returns The supported chains.\n */\nexport function getEIP7702SupportedChains(\n  messenger: TransactionControllerMessenger,\n): Hex[] {\n  const featureFlags = getFeatureFlags(messenger);\n  return featureFlags?.[FeatureFlag.EIP7702]?.supportedChains ?? [];\n}\n\n/**\n * Retrieves the supported EIP-7702 contract addresses for a given chain ID.\n *\n * @param chainId - The chain ID.\n * @param messenger - The controller messenger instance.\n * @param publicKey - The public key used to validate the contract authenticity.\n * @returns The supported contract addresses.\n */\nexport function getEIP7702ContractAddresses(\n  chainId: Hex,\n  messenger: TransactionControllerMessenger,\n  publicKey: Hex,\n): Hex[] {\n  const featureFlags = getFeatureFlags(messenger);\n\n  const contracts =\n    featureFlags?.[FeatureFlag.EIP7702]?.contracts?.[\n      chainId.toLowerCase() as Hex\n    ] ?? [];\n\n  return contracts\n    .filter((contract) =>\n      isValidSignature(\n        [contract.address, padHexToEvenLength(chainId) as Hex],\n        contract.signature,\n        publicKey,\n      ),\n    )\n    .map((contract) => contract.address);\n}\n\n/**\n * Retrieves the EIP-7702 upgrade contract address.\n *\n * @param chainId - The chain ID.\n * @param messenger - The controller messenger instance.\n * @param publicKey - The public key used to validate the contract authenticity.\n * @returns The upgrade contract address.\n */\nexport function getEIP7702UpgradeContractAddress(\n  chainId: Hex,\n  messenger: TransactionControllerMessenger,\n  publicKey: Hex,\n): Hex | undefined {\n  return getEIP7702ContractAddresses(chainId, messenger, publicKey)?.[0];\n}\n\n/**\n * Retrieves the batch size limit.\n * Defaults to 10 if not set.\n *\n * @param messenger - The controller messenger instance.\n * @returns  The batch size limit.\n */\nexport function getBatchSizeLimit(\n  messenger: TransactionControllerMessenger,\n): number {\n  const featureFlags = getFeatureFlags(messenger);\n  return (\n    featureFlags?.[FeatureFlag.Transactions]?.batchSizeLimit ??\n    DEFAULT_BATCH_SIZE_LIMIT\n  );\n}\n\n/**\n * Retrieves the submit history limit.\n * Defaults to 100 if not set.\n *\n * @param messenger - The controller messenger instance.\n * @returns The submit history limit.\n */\nexport function getSubmitHistoryLimit(\n  messenger: TransactionControllerMessenger,\n): number {\n  const featureFlags = getFeatureFlags(messenger);\n  return (\n    featureFlags?.[FeatureFlag.Transactions]?.submitHistoryLimit ??\n    DEFAULT_SUBMIT_HISTORY_LIMIT\n  );\n}\n\n/**\n * Retrieves the transaction history limit.\n * Defaults to 40 if not set.\n *\n * @param messenger - The controller messenger instance.\n * @returns The transaction history limit.\n */\nexport function getTransactionHistoryLimit(\n  messenger: TransactionControllerMessenger,\n): number | undefined {\n  const featureFlags = getFeatureFlags(messenger);\n\n  if (!featureFlags) {\n    return undefined;\n  }\n\n  return (\n    featureFlags[FeatureFlag.Transactions]?.transactionHistoryLimit ??\n    DEFAULT_TRANSACTION_HISTORY_LIMIT\n  );\n}\n\n/**\n * Retrieves the accelerated polling parameters for a given chain ID.\n *\n * @param chainId - The chain ID.\n * @param messenger - The controller messenger instance.\n * @returns The accelerated polling parameters: `countMax` and `intervalMs`.\n */\nexport function getAcceleratedPollingParams(\n  chainId: Hex,\n  messenger: TransactionControllerMessenger,\n): { blockTime: number; countMax: number; intervalMs: number } {\n  const featureFlags = getFeatureFlags(messenger);\n\n  const acceleratedPollingParams =\n    featureFlags?.[FeatureFlag.Transactions]?.acceleratedPolling;\n\n  const countMax =\n    acceleratedPollingParams?.perChainConfig?.[chainId]?.countMax ??\n    acceleratedPollingParams?.defaultCountMax ??\n    DEFAULT_ACCELERATED_POLLING_COUNT_MAX;\n\n  const intervalMs =\n    acceleratedPollingParams?.perChainConfig?.[chainId]?.intervalMs ??\n    acceleratedPollingParams?.defaultIntervalMs ??\n    DEFAULT_ACCELERATED_POLLING_INTERVAL_MS;\n\n  const blockTime =\n    acceleratedPollingParams?.perChainConfig?.[chainId]?.blockTime ??\n    DEFAULT_BLOCK_TIME;\n\n  return { blockTime, countMax, intervalMs };\n}\n\n/**\n * Retrieves the gas fee randomisation parameters.\n *\n * @param messenger - The controller messenger instance.\n * @returns The gas fee randomisation parameters.\n */\nexport function getGasFeeRandomisation(\n  messenger: TransactionControllerMessenger,\n): {\n  randomisedGasFeeDigits: Record<Hex, number>;\n  preservedNumberOfDigits: number | undefined;\n} {\n  const featureFlags = getFeatureFlags(messenger);\n\n  const gasFeeRandomisation =\n    featureFlags?.[FeatureFlag.Transactions]?.gasFeeRandomisation ?? {};\n\n  return {\n    randomisedGasFeeDigits: gasFeeRandomisation.randomisedGasFeeDigits ?? {},\n    preservedNumberOfDigits: gasFeeRandomisation.preservedNumberOfDigits,\n  };\n}\n\n/**\n * Retrieves the gas estimate fallback for a given chain ID.\n * Defaults to the default gas estimate fallback if not set.\n *\n * @param chainId - The chain ID.\n * @param messenger - The controller messenger instance.\n * @returns The gas estimate fallback.\n */\nexport function getGasEstimateFallback(\n  chainId: Hex,\n  messenger: TransactionControllerMessenger,\n): {\n  fixed?: number;\n  percentage: number;\n  maxGasLimit?: number;\n} {\n  const featureFlags = getFeatureFlags(messenger);\n\n  const gasEstimateFallbackFlags =\n    featureFlags?.[FeatureFlag.Transactions]?.gasEstimateFallback;\n\n  const chainFlags = gasEstimateFallbackFlags?.perChainConfig?.[chainId];\n\n  const percentage =\n    chainFlags?.percentage ??\n    gasEstimateFallbackFlags?.default?.percentage ??\n    DEFAULT_GAS_ESTIMATE_FALLBACK_BLOCK_PERCENT;\n\n  const fixed = chainFlags?.fixed ?? gasEstimateFallbackFlags?.default?.fixed;\n\n  const maxGasLimit =\n    chainFlags?.maxGasLimit ?? gasEstimateFallbackFlags?.default?.maxGasLimit;\n\n  return { fixed, percentage, maxGasLimit };\n}\n\n/**\n * Retrieves the gas buffers for a given chain ID.\n *\n * @param request - The request object.\n * @param request.chainId - The chain ID.\n * @param request.isCustomRPC - Whether the network RPC is added by the user.\n * @param request.isUpgradeWithData - Whether the transaction is an EIP-7702 upgrade combined with a call.\n * @param request.messenger - The controller messenger instance.\n * @returns The gas buffers.\n */\nexport function getGasEstimateBuffer({\n  chainId,\n  isCustomRPC,\n  isUpgradeWithData,\n  messenger,\n}: {\n  chainId: Hex;\n  isCustomRPC: boolean;\n  isUpgradeWithData: boolean;\n  messenger: TransactionControllerMessenger;\n}): number {\n  const featureFlags = getFeatureFlags(messenger);\n  const gasBufferFlags = featureFlags?.[FeatureFlag.GasBuffer];\n  const chainFlags = gasBufferFlags?.perChainConfig?.[chainId];\n  const chainIncludedRPCBuffer = isCustomRPC ? undefined : chainFlags?.included;\n\n  const defaultIncludedRPCBuffer = isCustomRPC\n    ? undefined\n    : gasBufferFlags?.included;\n\n  const upgradeBuffer = isUpgradeWithData ? chainFlags?.eip7702 : undefined;\n\n  return (\n    upgradeBuffer ??\n    chainIncludedRPCBuffer ??\n    chainFlags?.base ??\n    defaultIncludedRPCBuffer ??\n    gasBufferFlags?.default ??\n    DEFAULT_GAS_ESTIMATE_BUFFER\n  );\n}\n\n/**\n * Retrieves the incoming transactions polling interval.\n * Retrieves the number of attempts to wait before automatically marking a transaction as dropped\n * if it has no receipt status.\n *\n * @param chainId - The chain ID.\n * @param messenger - The controller messenger instance.\n * @returns The threshold number of attempts, or undefined if the feature is disabled.\n */\nexport function getTimeoutAttempts(\n  chainId: Hex,\n  messenger: TransactionControllerMessenger,\n): number | undefined {\n  const featureFlags = getFeatureFlags(messenger);\n\n  const timeoutAttemptsFlags =\n    featureFlags?.[FeatureFlag.Transactions]?.timeoutAttempts;\n\n  return (\n    timeoutAttemptsFlags?.perChainConfig?.[chainId] ??\n    timeoutAttemptsFlags?.default\n  );\n}\n\n/**\n * Retrieves the relevant feature flags from the remote feature flag controller.\n *\n * @param messenger - The messenger instance.\n * @returns The feature flags.\n */\nfunction getFeatureFlags(\n  messenger: TransactionControllerMessenger,\n): TransactionControllerFeatureFlags | undefined {\n  try {\n    const featureFlags = messenger.call(\n      'RemoteFeatureFlagController:getState',\n    ).remoteFeatureFlags;\n\n    log('Retrieved feature flags', featureFlags);\n\n    return featureFlags as TransactionControllerFeatureFlags;\n  } catch {\n    log('RemoteFeatureFlagController not available');\n    return undefined;\n  }\n}\n"]}
+{"version":3,"file":"feature-flags.mjs","sourceRoot":"","sources":["../../src/utils/feature-flags.ts"],"names":[],"mappings":"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","sourcesContent":["import { createModuleLogger } from '@metamask/utils';\nimport type { Hex } from '@metamask/utils';\n\nimport { projectLogger } from '../logger.js';\nimport type { TransactionControllerMessenger } from '../TransactionController.js';\nimport { isValidSignature } from './signature.js';\nimport { padHexToEvenLength } from './utils.js';\n\nconst DEFAULT_BATCH_SIZE_LIMIT = 10;\nconst DEFAULT_ACCELERATED_POLLING_COUNT_MAX = 10;\nconst DEFAULT_ACCELERATED_POLLING_INTERVAL_MS = 3 * 1000;\nconst DEFAULT_BLOCK_TIME = 12 * 1000;\nconst DEFAULT_GAS_ESTIMATE_FALLBACK_BLOCK_PERCENT = 35;\nconst DEFAULT_GAS_ESTIMATE_BUFFER = 1;\nconst DEFAULT_SUBMIT_HISTORY_LIMIT = 100;\nconst DEFAULT_TRANSACTION_HISTORY_LIMIT = 40;\n\n/**\n * Feature flags supporting the transaction controller.\n */\nexport enum FeatureFlag {\n  EIP7702 = 'confirmations_eip_7702',\n  GasBuffer = 'confirmations_gas_buffer',\n  Transactions = 'confirmations_transactions',\n}\n\ntype GasEstimateFallback = {\n  /**\n   * The fixed gas estimate fallback for a transaction.\n   */\n  fixed?: number;\n\n  /**\n   * The percentage multiplier gas estimate fallback for a transaction.\n   */\n  percentage?: number;\n\n  /**\n   * The maximum gas limit the fallback can resolve to, representing the chain's\n   * per-transaction gas cap. Clamps the `fixed` or `percentage`-derived fallback\n   * so it can never exceed the gas limit the RPC will accept (e.g. ~33.5M on\n   * Polygon, whereas 35% of its ~140M block gas limit would otherwise be ~49M).\n   */\n  maxGasLimit?: number;\n};\n\nexport type TransactionControllerFeatureFlags = {\n  /** Feature flags to support EIP-7702 / type-4 transactions. */\n  [FeatureFlag.EIP7702]?: {\n    /**\n     * All contracts that support EIP-7702 batch transactions.\n     * Keyed by chain ID.\n     * First entry in each array is the contract that standard EOAs will be upgraded to.\n     */\n    contracts?: Record<\n      Hex,\n      {\n        /** Address of the smart contract. */\n        address: Hex;\n\n        /** Signature to verify the contract is authentic. */\n        signature: Hex;\n      }[]\n    >;\n\n    /** Chains enabled for EIP-7702 batch transactions. */\n    supportedChains?: Hex[];\n  };\n\n  /**\n   * Buffers added to gas limit estimations.\n   * Values are multipliers such as `1.5` meaning 150% of the original gas limit.\n   */\n  [FeatureFlag.GasBuffer]?: {\n    /** Fallback buffer for all chains and transactions. */\n    default?: number;\n\n    /**\n     * Buffer for included network RPCs only and not those added by user.\n     * Takes priority over `default`.\n     */\n    included?: number;\n\n    /** Buffers for specific chains. */\n    perChainConfig?: {\n      [chainId: Hex]: {\n        /**\n         * Buffer for the chain for all transactions.\n         * Takes priority over non-chain `included`.\n         */\n        base?: number;\n\n        /**\n         * Buffer if network RPC is included and not added by user.\n         * Takes priority over `base`.\n         */\n        included?: number;\n\n        /**\n         * Buffer for the chain for EIP-7702 / type 4 transactions only.\n         * Only if `data` included and `to` matches `from`.\n         * Takes priority over `included` and `base`.\n         */\n        eip7702?: number;\n      };\n    };\n  };\n\n  /** Miscellaneous feature flags to support the transaction controller. */\n  [FeatureFlag.Transactions]?: {\n    /** Maximum number of transactions that can be in an external batch. */\n    batchSizeLimit?: number;\n\n    /** Maximum number of entries in the submit history. */\n    submitHistoryLimit?: number;\n\n    /** Maximum number of transactions stored in state. */\n    transactionHistoryLimit?: number;\n\n    /**\n     * Accelerated polling is used to speed up the polling process for\n     * transactions that are not yet confirmed.\n     */\n    acceleratedPolling?: {\n      /** Accelerated polling parameters on a per-chain basis. */\n      perChainConfig?: {\n        [chainId: Hex]: {\n          /**\n           * Block time in milliseconds.\n           */\n          blockTime?: number;\n\n          /**\n           * Maximum number of polling requests that can be made in a row, before\n           * the normal polling resumes.\n           */\n          countMax?: number;\n\n          /** Interval between polling requests in milliseconds. */\n          intervalMs?: number;\n        };\n      };\n\n      /** Default `countMax` in case no chain-specific parameter is set. */\n      defaultCountMax?: number;\n\n      /** Default `intervalMs` in case no chain-specific parameter is set. */\n      defaultIntervalMs?: number;\n    };\n\n    gasFeeRandomisation?: {\n      /** Randomised gas fee digits per chainId. */\n      randomisedGasFeeDigits?: Record<Hex, number>;\n\n      /** Number of digits to preserve for randomised gas fee digits. */\n      preservedNumberOfDigits?: number;\n    };\n\n    /** Gas estimate fallback is used as a fallback in case of failure to obtain the gas estimate values. */\n    gasEstimateFallback?: {\n      /** Gas estimate fallback per-chain basis. */\n      perChainConfig?: {\n        [chainId: Hex]: GasEstimateFallback;\n      };\n\n      /**\n       * Default gas estimate fallback.\n       * This value is used when no specific gas estimate fallback is found for a chain ID.\n       */\n      default?: GasEstimateFallback;\n    };\n\n    /**\n     * Number of attempts to wait before automatically marking a transaction as failed\n     * if it has no receipt status and hash is not found on the network.\n     */\n    timeoutAttempts?: {\n      /** Automatic fail threshold on a per-chain basis. */\n      perChainConfig?: {\n        [chainId: Hex]: number;\n      };\n\n      /**\n       * Default automatic fail threshold.\n       * This value is used when no specific threshold is found for a chain ID.\n       */\n      default?: number;\n    };\n\n    /**\n     * Replacement of underpriced dapp-suggested gas fees.\n     * If enabled, dapp-suggested EIP-1559 fees with a `maxFeePerGas` below the\n     * current low estimate are replaced with the wallet's suggested fees, as\n     * they are unlikely to be included in a block before fee values change.\n     */\n    replaceUnderpricedDappGasFees?: {\n      /** Enablement on a per-chain basis. */\n      perChainConfig?: {\n        [chainId: Hex]: boolean;\n      };\n\n      /**\n       * Default enablement.\n       * This value is used when no specific value is found for a chain ID.\n       */\n      default?: boolean;\n    };\n\n    /**\n     * Replacement of underpriced saved (advanced) gas fee preferences.\n     * If enabled, saved custom fees with a `maxBaseFee` below the current low\n     * estimate are ignored in favour of the wallet's suggested fees, as they\n     * are unlikely to be included in a block before fee values change.\n     * Level-based saved preferences track current estimates and are never\n     * ignored.\n     */\n    replaceUnderpricedSavedGasFees?: {\n      /** Enablement on a per-chain basis. */\n      perChainConfig?: {\n        [chainId: Hex]: boolean;\n      };\n\n      /**\n       * Default enablement.\n       * This value is used when no specific value is found for a chain ID.\n       */\n      default?: boolean;\n    };\n  };\n};\n\nconst log = createModuleLogger(projectLogger, 'feature-flags');\n\n/**\n * Retrieves the supported EIP-7702 chains.\n *\n * @param messenger - The controller messenger instance.\n * @returns The supported chains.\n */\nexport function getEIP7702SupportedChains(\n  messenger: TransactionControllerMessenger,\n): Hex[] {\n  const featureFlags = getFeatureFlags(messenger);\n  return featureFlags?.[FeatureFlag.EIP7702]?.supportedChains ?? [];\n}\n\n/**\n * Retrieves the supported EIP-7702 contract addresses for a given chain ID.\n *\n * @param chainId - The chain ID.\n * @param messenger - The controller messenger instance.\n * @param publicKey - The public key used to validate the contract authenticity.\n * @returns The supported contract addresses.\n */\nexport function getEIP7702ContractAddresses(\n  chainId: Hex,\n  messenger: TransactionControllerMessenger,\n  publicKey: Hex,\n): Hex[] {\n  const featureFlags = getFeatureFlags(messenger);\n\n  const contracts =\n    featureFlags?.[FeatureFlag.EIP7702]?.contracts?.[\n      chainId.toLowerCase() as Hex\n    ] ?? [];\n\n  return contracts\n    .filter((contract) =>\n      isValidSignature(\n        [contract.address, padHexToEvenLength(chainId) as Hex],\n        contract.signature,\n        publicKey,\n      ),\n    )\n    .map((contract) => contract.address);\n}\n\n/**\n * Retrieves the EIP-7702 upgrade contract address.\n *\n * @param chainId - The chain ID.\n * @param messenger - The controller messenger instance.\n * @param publicKey - The public key used to validate the contract authenticity.\n * @returns The upgrade contract address.\n */\nexport function getEIP7702UpgradeContractAddress(\n  chainId: Hex,\n  messenger: TransactionControllerMessenger,\n  publicKey: Hex,\n): Hex | undefined {\n  return getEIP7702ContractAddresses(chainId, messenger, publicKey)?.[0];\n}\n\n/**\n * Retrieves the batch size limit.\n * Defaults to 10 if not set.\n *\n * @param messenger - The controller messenger instance.\n * @returns  The batch size limit.\n */\nexport function getBatchSizeLimit(\n  messenger: TransactionControllerMessenger,\n): number {\n  const featureFlags = getFeatureFlags(messenger);\n  return (\n    featureFlags?.[FeatureFlag.Transactions]?.batchSizeLimit ??\n    DEFAULT_BATCH_SIZE_LIMIT\n  );\n}\n\n/**\n * Retrieves the submit history limit.\n * Defaults to 100 if not set.\n *\n * @param messenger - The controller messenger instance.\n * @returns The submit history limit.\n */\nexport function getSubmitHistoryLimit(\n  messenger: TransactionControllerMessenger,\n): number {\n  const featureFlags = getFeatureFlags(messenger);\n  return (\n    featureFlags?.[FeatureFlag.Transactions]?.submitHistoryLimit ??\n    DEFAULT_SUBMIT_HISTORY_LIMIT\n  );\n}\n\n/**\n * Retrieves the transaction history limit.\n * Defaults to 40 if not set.\n *\n * @param messenger - The controller messenger instance.\n * @returns The transaction history limit.\n */\nexport function getTransactionHistoryLimit(\n  messenger: TransactionControllerMessenger,\n): number | undefined {\n  const featureFlags = getFeatureFlags(messenger);\n\n  if (!featureFlags) {\n    return undefined;\n  }\n\n  return (\n    featureFlags[FeatureFlag.Transactions]?.transactionHistoryLimit ??\n    DEFAULT_TRANSACTION_HISTORY_LIMIT\n  );\n}\n\n/**\n * Retrieves the accelerated polling parameters for a given chain ID.\n *\n * @param chainId - The chain ID.\n * @param messenger - The controller messenger instance.\n * @returns The accelerated polling parameters: `countMax` and `intervalMs`.\n */\nexport function getAcceleratedPollingParams(\n  chainId: Hex,\n  messenger: TransactionControllerMessenger,\n): { blockTime: number; countMax: number; intervalMs: number } {\n  const featureFlags = getFeatureFlags(messenger);\n\n  const acceleratedPollingParams =\n    featureFlags?.[FeatureFlag.Transactions]?.acceleratedPolling;\n\n  const countMax =\n    acceleratedPollingParams?.perChainConfig?.[chainId]?.countMax ??\n    acceleratedPollingParams?.defaultCountMax ??\n    DEFAULT_ACCELERATED_POLLING_COUNT_MAX;\n\n  const intervalMs =\n    acceleratedPollingParams?.perChainConfig?.[chainId]?.intervalMs ??\n    acceleratedPollingParams?.defaultIntervalMs ??\n    DEFAULT_ACCELERATED_POLLING_INTERVAL_MS;\n\n  const blockTime =\n    acceleratedPollingParams?.perChainConfig?.[chainId]?.blockTime ??\n    DEFAULT_BLOCK_TIME;\n\n  return { blockTime, countMax, intervalMs };\n}\n\n/**\n * Retrieves the gas fee randomisation parameters.\n *\n * @param messenger - The controller messenger instance.\n * @returns The gas fee randomisation parameters.\n */\nexport function getGasFeeRandomisation(\n  messenger: TransactionControllerMessenger,\n): {\n  randomisedGasFeeDigits: Record<Hex, number>;\n  preservedNumberOfDigits: number | undefined;\n} {\n  const featureFlags = getFeatureFlags(messenger);\n\n  const gasFeeRandomisation =\n    featureFlags?.[FeatureFlag.Transactions]?.gasFeeRandomisation ?? {};\n\n  return {\n    randomisedGasFeeDigits: gasFeeRandomisation.randomisedGasFeeDigits ?? {},\n    preservedNumberOfDigits: gasFeeRandomisation.preservedNumberOfDigits,\n  };\n}\n\n/**\n * Retrieves the gas estimate fallback for a given chain ID.\n * Defaults to the default gas estimate fallback if not set.\n *\n * @param chainId - The chain ID.\n * @param messenger - The controller messenger instance.\n * @returns The gas estimate fallback.\n */\nexport function getGasEstimateFallback(\n  chainId: Hex,\n  messenger: TransactionControllerMessenger,\n): {\n  fixed?: number;\n  percentage: number;\n  maxGasLimit?: number;\n} {\n  const featureFlags = getFeatureFlags(messenger);\n\n  const gasEstimateFallbackFlags =\n    featureFlags?.[FeatureFlag.Transactions]?.gasEstimateFallback;\n\n  const chainFlags = gasEstimateFallbackFlags?.perChainConfig?.[chainId];\n\n  const percentage =\n    chainFlags?.percentage ??\n    gasEstimateFallbackFlags?.default?.percentage ??\n    DEFAULT_GAS_ESTIMATE_FALLBACK_BLOCK_PERCENT;\n\n  const fixed = chainFlags?.fixed ?? gasEstimateFallbackFlags?.default?.fixed;\n\n  const maxGasLimit =\n    chainFlags?.maxGasLimit ?? gasEstimateFallbackFlags?.default?.maxGasLimit;\n\n  return { fixed, percentage, maxGasLimit };\n}\n\n/**\n * Retrieves the gas buffers for a given chain ID.\n *\n * @param request - The request object.\n * @param request.chainId - The chain ID.\n * @param request.isCustomRPC - Whether the network RPC is added by the user.\n * @param request.isUpgradeWithData - Whether the transaction is an EIP-7702 upgrade combined with a call.\n * @param request.messenger - The controller messenger instance.\n * @returns The gas buffers.\n */\nexport function getGasEstimateBuffer({\n  chainId,\n  isCustomRPC,\n  isUpgradeWithData,\n  messenger,\n}: {\n  chainId: Hex;\n  isCustomRPC: boolean;\n  isUpgradeWithData: boolean;\n  messenger: TransactionControllerMessenger;\n}): number {\n  const featureFlags = getFeatureFlags(messenger);\n  const gasBufferFlags = featureFlags?.[FeatureFlag.GasBuffer];\n  const chainFlags = gasBufferFlags?.perChainConfig?.[chainId];\n  const chainIncludedRPCBuffer = isCustomRPC ? undefined : chainFlags?.included;\n\n  const defaultIncludedRPCBuffer = isCustomRPC\n    ? undefined\n    : gasBufferFlags?.included;\n\n  const upgradeBuffer = isUpgradeWithData ? chainFlags?.eip7702 : undefined;\n\n  return (\n    upgradeBuffer ??\n    chainIncludedRPCBuffer ??\n    chainFlags?.base ??\n    defaultIncludedRPCBuffer ??\n    gasBufferFlags?.default ??\n    DEFAULT_GAS_ESTIMATE_BUFFER\n  );\n}\n\n/**\n * Retrieves the incoming transactions polling interval.\n * Retrieves the number of attempts to wait before automatically marking a transaction as dropped\n * if it has no receipt status.\n *\n * @param chainId - The chain ID.\n * @param messenger - The controller messenger instance.\n * @returns The threshold number of attempts, or undefined if the feature is disabled.\n */\nexport function getTimeoutAttempts(\n  chainId: Hex,\n  messenger: TransactionControllerMessenger,\n): number | undefined {\n  const featureFlags = getFeatureFlags(messenger);\n\n  const timeoutAttemptsFlags =\n    featureFlags?.[FeatureFlag.Transactions]?.timeoutAttempts;\n\n  return (\n    timeoutAttemptsFlags?.perChainConfig?.[chainId] ??\n    timeoutAttemptsFlags?.default\n  );\n}\n\n/**\n * Retrieves whether underpriced dapp-suggested gas fees should be replaced\n * with the wallet's suggested fees.\n *\n * @param chainId - The chain ID.\n * @param messenger - The controller messenger instance.\n * @returns Whether the replacement is enabled.\n */\nexport function getReplaceUnderpricedDappGasFeesEnabled(\n  chainId: Hex,\n  messenger: TransactionControllerMessenger,\n): boolean {\n  const featureFlags = getFeatureFlags(messenger);\n\n  const replaceUnderpricedDappGasFeesFlags =\n    featureFlags?.[FeatureFlag.Transactions]?.replaceUnderpricedDappGasFees;\n\n  return (\n    replaceUnderpricedDappGasFeesFlags?.perChainConfig?.[chainId] ??\n    replaceUnderpricedDappGasFeesFlags?.default ??\n    false\n  );\n}\n\n/**\n * Retrieves whether underpriced saved (advanced) gas fee preferences should be\n * ignored in favour of the wallet's suggested fees.\n *\n * @param chainId - The chain ID.\n * @param messenger - The controller messenger instance.\n * @returns Whether the replacement is enabled.\n */\nexport function getReplaceUnderpricedSavedGasFeesEnabled(\n  chainId: Hex,\n  messenger: TransactionControllerMessenger,\n): boolean {\n  const featureFlags = getFeatureFlags(messenger);\n\n  const replaceUnderpricedSavedGasFeesFlags =\n    featureFlags?.[FeatureFlag.Transactions]?.replaceUnderpricedSavedGasFees;\n\n  return (\n    replaceUnderpricedSavedGasFeesFlags?.perChainConfig?.[chainId] ??\n    replaceUnderpricedSavedGasFeesFlags?.default ??\n    false\n  );\n}\n\n/**\n * Retrieves the relevant feature flags from the remote feature flag controller.\n *\n * @param messenger - The messenger instance.\n * @returns The feature flags.\n */\nfunction getFeatureFlags(\n  messenger: TransactionControllerMessenger,\n): TransactionControllerFeatureFlags | undefined {\n  try {\n    const featureFlags = messenger.call(\n      'RemoteFeatureFlagController:getState',\n    ).remoteFeatureFlags;\n\n    log('Retrieved feature flags', featureFlags);\n\n    return featureFlags as TransactionControllerFeatureFlags;\n  } catch {\n    log('RemoteFeatureFlagController not available');\n    return undefined;\n  }\n}\n"]}

package/dist/utils/gas-fees.cjs

@@ -5,6 +5,7 @@ const controller_utils_1 = require("@metamask/controller-utils");
 const utils_1 = require("@metamask/utils");
 const logger_js_1 = require("../logger.cjs");
 const types_js_1 = require("../types.cjs");
+const feature_flags_js_1 = require("./feature-flags.cjs");
 const gas_flow_js_1 = require("./gas-flow.cjs");
 const provider_js_1 = require("./provider.cjs");
 const swaps_js_1 = require("./swaps.cjs");
@@ -23,7 +24,7 @@ async function updateGasFees(request) {
     const { txMeta } = request;
     const initialParams = { ...txMeta.txParams };
     const shouldIgnoreSavedGasFees = SAVED_GAS_FEES_IGNORED_TRANSACTION_TYPES.includes(txMeta.type);
-    const savedGasFees = shouldIgnoreSavedGasFees || hasInitialGasFeeParams(initialParams)
+    let savedGasFees = shouldIgnoreSavedGasFees || hasInitialGasFeeParams(initialParams)
         ? undefined
         : request.getSavedGasFees(txMeta);
     const suggestedGasFees = await getSuggestedGasFees({
@@ -31,6 +32,10 @@ async function updateGasFees(request) {
         savedGasFees,
     });
     log('Suggested gas fees', suggestedGasFees);
+    if (shouldIgnoreUnderpricedSavedGasFees(savedGasFees, suggestedGasFees, request)) {
+        log('Ignoring saved custom gas fees below low estimate', savedGasFees?.maxBaseFee, suggestedGasFees.low?.maxFeePerGas);
+        savedGasFees = undefined;
+    }
     const getGasFeeRequest = {
         ...request,
         initialParams,
@@ -83,6 +88,76 @@ function gweiDecimalToWeiDecimal(gweiDecimal) {
     return weiValue.toString().split('.')[0];
 }
 exports.gweiDecimalToWeiDecimal = gweiDecimalToWeiDecimal;
+/**
+ * Determine whether saved (advanced) gas fee preferences should be ignored in
+ * favour of the suggested gas fees, as the saved custom `maxBaseFee` is below
+ * the current low estimate and hence unlikely to result in timely inclusion in
+ * a block. Level-based saved preferences track current estimates and are never
+ * ignored.
+ *
+ * @param savedGasFees - The saved gas fee preferences.
+ * @param suggestedGasFees - The suggested gas fees.
+ * @param request - The request object.
+ * @returns Whether the saved gas fee preferences should be ignored.
+ */
+function shouldIgnoreUnderpricedSavedGasFees(savedGasFees, suggestedGasFees, request) {
+    const { eip1559, messenger, txMeta } = request;
+    if (!eip1559 ||
+        !savedGasFees?.maxBaseFee ||
+        !(0, feature_flags_js_1.getReplaceUnderpricedSavedGasFeesEnabled)(txMeta.chainId, messenger)) {
+        return false;
+    }
+    const lowMaxFeePerGas = suggestedGasFees.low?.maxFeePerGas;
+    const hasReplacement = Boolean(suggestedGasFees.maxFeePerGas) &&
+        Boolean(suggestedGasFees.maxPriorityFeePerGas);
+    if (!lowMaxFeePerGas || !hasReplacement) {
+        return false;
+    }
+    return isFeeBelowLowEstimate(gweiDecimalToWeiHex(savedGasFees.maxBaseFee), lowMaxFeePerGas);
+}
+/**
+ * Determine whether a fee value is below the low estimate.
+ *
+ * @param valueHex - The fee value as a hex string.
+ * @param lowMaxFeePerGasHex - The low estimate `maxFeePerGas` as a hex string.
+ * @returns Whether the fee value is below the low estimate.
+ */
+function isFeeBelowLowEstimate(valueHex, lowMaxFeePerGasHex) {
+    try {
+        return BigInt(valueHex) < BigInt(lowMaxFeePerGasHex);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Determine whether dapp-suggested gas fees should be ignored in favour of the
+ * suggested gas fees, as the dapp-suggested `maxFeePerGas` is below the current
+ * low estimate and hence unlikely to result in timely inclusion in a block.
+ *
+ * @param request - The request object.
+ * @returns Whether the dapp-suggested gas fees should be ignored.
+ */
+function shouldIgnoreDappGasFees(request) {
+    const { eip1559, initialParams, messenger, savedGasFees, suggestedGasFees, txMeta, } = request;
+    if (!eip1559 ||
+        savedGasFees ||
+        txMeta.isInternal ||
+        !(0, feature_flags_js_1.getReplaceUnderpricedDappGasFeesEnabled)(txMeta.chainId, messenger)) {
+        return false;
+    }
+    const dappMaxFeePerGas = initialParams.maxFeePerGas ??
+        (initialParams.gasPrice && !initialParams.maxPriorityFeePerGas
+            ? initialParams.gasPrice
+            : undefined);
+    const lowMaxFeePerGas = suggestedGasFees.low?.maxFeePerGas;
+    const hasReplacement = Boolean(suggestedGasFees.maxFeePerGas) &&
+        Boolean(suggestedGasFees.maxPriorityFeePerGas);
+    if (!dappMaxFeePerGas || !lowMaxFeePerGas || !hasReplacement) {
+        return false;
+    }
+    return isFeeBelowLowEstimate(dappMaxFeePerGas, lowMaxFeePerGas);
+}
 /**
  * Determine the maxFeePerGas value for the transaction.
  *
@@ -99,14 +174,20 @@ function getMaxFeePerGas(request) {
         log('Using maxFeePerGas from savedGasFees', maxFeePerGas);
         return maxFeePerGas;
     }
-    if (initialParams.maxFeePerGas) {
+    const ignoreDappGasFees = shouldIgnoreDappGasFees(request);
+    if (initialParams.maxFeePerGas && !ignoreDappGasFees) {
         log('Using maxFeePerGas from request', initialParams.maxFeePerGas);
         return initialParams.maxFeePerGas;
     }
-    if (initialParams.gasPrice && !initialParams.maxPriorityFeePerGas) {
+    if (initialParams.gasPrice &&
+        !initialParams.maxPriorityFeePerGas &&
+        !ignoreDappGasFees) {
         log('Setting maxFeePerGas to gasPrice from request', initialParams.gasPrice);
         return initialParams.gasPrice;
     }
+    if (ignoreDappGasFees) {
+        log('Ignoring dapp-suggested maxFeePerGas below low estimate', initialParams.maxFeePerGas ?? initialParams.gasPrice, suggestedGasFees.low?.maxFeePerGas);
+    }
     if (suggestedGasFees.maxFeePerGas) {
         log('Using suggested maxFeePerGas', suggestedGasFees.maxFeePerGas);
         return suggestedGasFees.maxFeePerGas;
@@ -134,11 +215,14 @@ function getMaxPriorityFeePerGas(request) {
         log('Using maxPriorityFeePerGas from savedGasFees.priorityFee', maxPriorityFeePerGas);
         return maxPriorityFeePerGas;
     }
-    if (initialParams.maxPriorityFeePerGas) {
+    const ignoreDappGasFees = shouldIgnoreDappGasFees(request);
+    if (initialParams.maxPriorityFeePerGas && !ignoreDappGasFees) {
         log('Using maxPriorityFeePerGas from request', initialParams.maxPriorityFeePerGas);
         return initialParams.maxPriorityFeePerGas;
     }
-    if (initialParams.gasPrice && !initialParams.maxFeePerGas) {
+    if (initialParams.gasPrice &&
+        !initialParams.maxFeePerGas &&
+        !ignoreDappGasFees) {
         log('Setting maxPriorityFeePerGas to gasPrice from request', initialParams.gasPrice);
         return initialParams.gasPrice;
     }
@@ -206,6 +290,12 @@ function getUserFeeLevel(request) {
         // overwrite the override or misrepresent the fee as matching the level.
         return canUseSavedLevel ? savedGasFees.level : types_js_1.UserFeeLevel.CUSTOM;
     }
+    // Underpriced dapp-suggested fees are replaced with the suggested medium
+    // values, so also use the medium fee level to keep the values updated while
+    // the transaction is unapproved.
+    if (shouldIgnoreDappGasFees(request)) {
+        return types_js_1.UserFeeLevel.MEDIUM;
+    }
     if (!initialParams.maxFeePerGas &&
         !initialParams.maxPriorityFeePerGas &&
         initialParams.gasPrice) {
@@ -251,10 +341,16 @@ function updateDefaultGasEstimates(txMeta) {
 async function getSuggestedGasFees(request) {
     const { eip1559, gasFeeFlows, getGasFeeEstimates, messenger, savedGasFees, txMeta, } = request;
     const { networkClientId } = txMeta;
+    const hasCompleteDappFees = eip1559 &&
+        Boolean(txMeta.txParams.maxFeePerGas) &&
+        Boolean(txMeta.txParams.maxPriorityFeePerGas);
+    // Estimates are still required for transactions with complete dapp-suggested
+    // fees if they may be replaced due to being underpriced.
+    const isEstimateRequiredForDappFees = hasCompleteDappFees &&
+        !txMeta.isInternal &&
+        (0, feature_flags_js_1.getReplaceUnderpricedDappGasFeesEnabled)(txMeta.chainId, messenger);
     if ((!eip1559 && txMeta.txParams.gasPrice) ||
-        (eip1559 &&
-            txMeta.txParams.maxFeePerGas &&
-            txMeta.txParams.maxPriorityFeePerGas)) {
+        (hasCompleteDappFees && !isEstimateRequiredForDappFees)) {
         return {};
     }
     const gasFeeFlow = (0, gas_flow_js_1.getGasFeeFlow)(txMeta, gasFeeFlows, messenger);
@@ -273,6 +369,7 @@ async function getSuggestedGasFees(request) {
                     ...(response.estimates[savedGasFeeEstimateLevel] ??
                         response.estimates.medium),
                     isEstimateLevelApplied: true,
+                    low: response.estimates.low,
                 };
             case types_js_1.GasFeeEstimateType.Legacy:
                 return {
@@ -295,6 +392,12 @@ async function getSuggestedGasFees(request) {
     catch (error) {
         log('Failed to get suggested gas fees', error);
     }
+    // Estimates on this path are only needed to check complete dapp-suggested
+    // fees, so no fallback is required and any failure must not block
+    // transaction creation.
+    if (hasCompleteDappFees) {
+        return {};
+    }
     const gasPriceHex = (await (0, provider_js_1.rpcRequest)({
         messenger,
         networkClientId,

package/dist/utils/gas-fees.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"gas-fees.cjs","sourceRoot":"","sources":["../../src/utils/gas-fees.ts"],"names":[],"mappings":";;;AAAA,iEAAmE;AAMnE,2CAA4D;AAE5D,6CAA6C;AAQ7C,2CAKqB;AACrB,gDAA8C;AAC9C,gDAA2C;AAC3C,0CAAoD;AAmCpD,MAAM,GAAG,GAAG,IAAA,0BAAkB,EAAC,yBAAa,EAAE,UAAU,CAAC,CAAC;AAE1D,MAAM,wCAAwC,GAAG;IAC/C,GAAG,iCAAsB;IACzB,0BAAe,CAAC,MAAM;IACtB,0BAAe,CAAC,cAAc;CAC/B,CAAC;AAEF;;;;GAIG;AACI,KAAK,UAAU,aAAa,CACjC,OAA6B;IAE7B,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC3B,MAAM,aAAa,GAAG,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAE7C,MAAM,wBAAwB,GAC5B,wCAAwC,CAAC,QAAQ,CAC/C,MAAM,CAAC,IAAuB,CAC/B,CAAC;IAEJ,MAAM,YAAY,GAChB,wBAAwB,IAAI,sBAAsB,CAAC,aAAa,CAAC;QAC/D,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAEtC,MAAM,gBAAgB,GAAG,MAAM,mBAAmB,CAAC;QACjD,GAAG,OAAO;QACV,YAAY;KACb,CAAC,CAAC;IAEH,GAAG,CAAC,oBAAoB,EAAE,gBAAgB,CAAC,CAAC;IAE5C,MAAM,gBAAgB,GAAqB;QACzC,GAAG,OAAO;QACV,aAAa;QACb,YAAY;QACZ,gBAAgB;KACjB,CAAC;IAEF,MAAM,CAAC,QAAQ,CAAC,YAAY,GAAG,eAAe,CAAC,gBAAgB,CAAC,CAAC;IAEjE,MAAM,CAAC,QAAQ,CAAC,oBAAoB;QAClC,uBAAuB,CAAC,gBAAgB,CAAC,CAAC;IAE5C,MAAM,CAAC,QAAQ,CAAC,QAAQ,GAAG,WAAW,CAAC,gBAAgB,CAAC,CAAC;IACzD,MAAM,CAAC,YAAY,GAAG,eAAe,CAAC,gBAAgB,CAAC,CAAC;IAExD,GAAG,CAAC,4BAA4B,EAAE;QAChC,YAAY,EAAE,MAAM,CAAC,QAAQ,CAAC,YAAY;QAC1C,oBAAoB,EAAE,MAAM,CAAC,QAAQ,CAAC,oBAAoB;QAC1D,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ;KACnC,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,QAAQ,CAAC,YAAY,IAAI,MAAM,CAAC,QAAQ,CAAC,oBAAoB,EAAE,CAAC;QACzE,OAAO,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAClC,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAC7B,OAAO,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC;QACpC,OAAO,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IAC9C,CAAC;IAED,yBAAyB,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC;AAtDD,sCAsDC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,KAAa;IAC/C,OAAO,IAAA,wBAAK,EAAC,IAAA,iCAAc,EAAC,KAAK,CAAC,CAAC,CAAC;AACtC,CAAC;AAFD,kDAEC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,uBAAuB,CAAC,WAA4B;IAClE,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,GAAG,CAAC;IAE3C,OAAO,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3C,CAAC;AAJD,0DAIC;AAED;;;;;GAKG;AACH,SAAS,eAAe,CAAC,OAAyB;IAChD,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC;IAE3E,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,YAAY,EAAE,UAAU,EAAE,CAAC;QAC7B,MAAM,YAAY,GAAG,mBAAmB,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QAClE,GAAG,CAAC,sCAAsC,EAAE,YAAY,CAAC,CAAC;QAC1D,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,IAAI,aAAa,CAAC,YAAY,EAAE,CAAC;QAC/B,GAAG,CAAC,iCAAiC,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;QACnE,OAAO,aAAa,CAAC,YAAY,CAAC;IACpC,CAAC;IAED,IAAI,aAAa,CAAC,QAAQ,IAAI,CAAC,aAAa,CAAC,oBAAoB,EAAE,CAAC;QAClE,GAAG,CACD,+CAA+C,EAC/C,aAAa,CAAC,QAAQ,CACvB,CAAC;QACF,OAAO,aAAa,CAAC,QAAQ,CAAC;IAChC,CAAC;IAED,IAAI,gBAAgB,CAAC,YAAY,EAAE,CAAC;QAClC,GAAG,CAAC,8BAA8B,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;QACnE,OAAO,gBAAgB,CAAC,YAAY,CAAC;IACvC,CAAC;IAED,IAAI,gBAAgB,CAAC,QAAQ,EAAE,CAAC;QAC9B,GAAG,CACD,4CAA4C,EAC5C,gBAAgB,CAAC,QAAQ,CAC1B,CAAC;QACF,OAAO,gBAAgB,CAAC,QAAQ,CAAC;IACnC,CAAC;IAED,GAAG,CAAC,sBAAsB,CAAC,CAAC;IAC5B,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,SAAS,uBAAuB,CAC9B,OAAyB;IAEzB,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,EAAE,GACtE,OAAO,CAAC;IAEV,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,YAAY,EAAE,WAAW,EAAE,CAAC;QAC9B,MAAM,oBAAoB,GAAG,mBAAmB,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;QAC3E,GAAG,CACD,0DAA0D,EAC1D,oBAAoB,CACrB,CAAC;QACF,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAED,IAAI,aAAa,CAAC,oBAAoB,EAAE,CAAC;QACvC,GAAG,CACD,yCAAyC,EACzC,aAAa,CAAC,oBAAoB,CACnC,CAAC;QACF,OAAO,aAAa,CAAC,oBAAoB,CAAC;IAC5C,CAAC;IAED,IAAI,aAAa,CAAC,QAAQ,IAAI,CAAC,aAAa,CAAC,YAAY,EAAE,CAAC;QAC1D,GAAG,CACD,uDAAuD,EACvD,aAAa,CAAC,QAAQ,CACvB,CAAC;QACF,OAAO,aAAa,CAAC,QAAQ,CAAC;IAChC,CAAC;IAED,IAAI,gBAAgB,CAAC,oBAAoB,EAAE,CAAC;QAC1C,GAAG,CACD,sCAAsC,EACtC,gBAAgB,CAAC,oBAAoB,CACtC,CAAC;QACF,OAAO,gBAAgB,CAAC,oBAAoB,CAAC;IAC/C,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;QACjC,GAAG,CACD,8CAA8C,EAC9C,MAAM,CAAC,QAAQ,CAAC,YAAY,CAC7B,CAAC;QACF,OAAO,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC;IACtC,CAAC;IAED,GAAG,CAAC,8BAA8B,CAAC,CAAC;IACpC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,SAAS,WAAW,CAAC,OAAyB;IAC5C,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC;IAE3E,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,YAAY,EAAE,QAAQ,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,mBAAmB,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC5D,GAAG,CAAC,2CAA2C,EAAE,QAAQ,CAAC,CAAC;QAC3D,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,aAAa,CAAC,QAAQ,EAAE,CAAC;QAC3B,GAAG,CAAC,6BAA6B,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC3D,OAAO,aAAa,CAAC,QAAQ,CAAC;IAChC,CAAC;IAED,IAAI,gBAAgB,CAAC,YAAY,EAAE,CAAC;QAClC,GAAG,CAAC,8BAA8B,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;QACnE,OAAO,gBAAgB,CAAC,YAAY,CAAC;IACvC,CAAC;IAED,IAAI,gBAAgB,CAAC,QAAQ,EAAE,CAAC;QAC9B,GAAG,CAAC,0BAA0B,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC3D,OAAO,gBAAgB,CAAC,QAAQ,CAAC;IACnC,CAAC;IAED,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACxB,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,SAAS,eAAe,CAAC,OAAyB;IAChD,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAE1E,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,iBAAiB,GACrB,YAAY,CAAC,UAAU,KAAK,SAAS;YACrC,YAAY,CAAC,WAAW,KAAK,SAAS;YACtC,YAAY,CAAC,QAAQ,KAAK,SAAS,CAAC;QAEtC,MAAM,gBAAgB,GACpB,CAAC,iBAAiB;YAClB,YAAY,CAAC,KAAK,KAAK,SAAS;YAChC,gBAAgB,CAAC,sBAAsB,CAAC;QAE1C,oEAAoE;QACpE,wEAAwE;QACxE,wEAAwE;QACxE,mEAAmE;QACnE,wEAAwE;QACxE,OAAO,gBAAgB,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,uBAAY,CAAC,MAAM,CAAC;IACrE,CAAC;IAED,IACE,CAAC,aAAa,CAAC,YAAY;QAC3B,CAAC,aAAa,CAAC,oBAAoB;QACnC,aAAa,CAAC,QAAQ,EACtB,CAAC;QACD,OAAO,MAAM,CAAC,UAAU;YACtB,CAAC,CAAC,uBAAY,CAAC,MAAM;YACrB,CAAC,CAAC,uBAAY,CAAC,cAAc,CAAC;IAClC,CAAC;IAED,IACE,CAAC,aAAa,CAAC,YAAY;QAC3B,CAAC,aAAa,CAAC,oBAAoB;QACnC,gBAAgB,CAAC,YAAY;QAC7B,gBAAgB,CAAC,oBAAoB,EACrC,CAAC;QACD,OAAO,uBAAY,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED,IACE,CAAC,aAAa,CAAC,YAAY;QAC3B,CAAC,aAAa,CAAC,oBAAoB;QACnC,gBAAgB,CAAC,QAAQ,EACzB,CAAC;QACD,OAAO,uBAAY,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,OAAO,uBAAY,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED,OAAO,uBAAY,CAAC,cAAc,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,SAAS,yBAAyB,CAAC,MAAuB;IACxD,MAAM,CAAC,mBAAmB,KAA1B,MAAM,CAAC,mBAAmB,GAAK,EAAE,EAAC;IAClC,MAAM,CAAC,mBAAmB,CAAC,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC;IAEvE,MAAM,CAAC,mBAAmB,CAAC,oBAAoB;QAC7C,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IAEvC,MAAM,CAAC,mBAAmB,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAC/D,MAAM,CAAC,mBAAmB,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;AAChE,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,mBAAmB,CAChC,OAA+D;IAE/D,MAAM,EACJ,OAAO,EACP,WAAW,EACX,kBAAkB,EAClB,SAAS,EACT,YAAY,EACZ,MAAM,GACP,GAAG,OAAO,CAAC;IACZ,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,CAAC;IAEnC,IACE,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACtC,CAAC,OAAO;YACN,MAAM,CAAC,QAAQ,CAAC,YAAY;YAC5B,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EACvC,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,UAAU,GAAG,IAAA,2BAAa,EAC9B,MAAM,EACN,WAAW,EACX,SAAS,CACI,CAAC;IAEhB,IAAI,CAAC;QACH,MAAM,oBAAoB,GAAG,MAAM,kBAAkB,CAAC,EAAE,eAAe,EAAE,CAAC,CAAC;QAE3E,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC;YAC3C,oBAAoB;YACpB,SAAS;YACT,eAAe,EAAE,MAAM;SACxB,CAAC,CAAC;QAEH,MAAM,kBAAkB,GAAG,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;QACpD,MAAM,wBAAwB,GAAG,2BAA2B,CAAC,YAAY,CAAC,CAAC;QAE3E,QAAQ,kBAAkB,EAAE,CAAC;YAC3B,KAAK,6BAAkB,CAAC,SAAS;gBAC/B,OAAO;oBACL,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,wBAAwB,CAAC;wBAC9C,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC;oBAC5B,sBAAsB,EAAE,IAAI;iBAC7B,CAAC;YACJ,KAAK,6BAAkB,CAAC,MAAM;gBAC5B,OAAO;oBACL,QAAQ,EACN,QAAQ,CAAC,SAAS,CAAC,wBAAwB,CAAC;wBAC5C,QAAQ,CAAC,SAAS,CAAC,MAAM;oBAC3B,sBAAsB,EAAE,IAAI;iBAC7B,CAAC;YACJ,KAAK,6BAAkB,CAAC,QAAQ;gBAC9B,OAAO;oBACL,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,QAAQ;oBACrC,sBAAsB,EAAE,KAAK;iBAC9B,CAAC;YACJ;gBACE,MAAM,IAAI,KAAK;gBACb,gFAAgF;gBAChF,4EAA4E;gBAC5E,yDAAyD,kBAAkB,EAAE,CAC9E,CAAC;QACN,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,kCAAkC,EAAE,KAAK,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,WAAW,GAAG,CAAC,MAAM,IAAA,wBAAU,EAAC;QACpC,SAAS;QACT,eAAe;QACf,MAAM,EAAE,cAAc;KACvB,CAAC,CAAoB,CAAC;IAEvB,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,IAAA,aAAK,EAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE9D,OAAO,EAAE,QAAQ,EAAE,CAAC;AACtB,CAAC;AAED,SAAS,sBAAsB,CAAC,aAAgC;IAC9D,OAAO;QACL,aAAa,CAAC,YAAY;QAC1B,aAAa,CAAC,oBAAoB;QAClC,aAAa,CAAC,QAAQ;KACvB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,2BAA2B,CAClC,YAAsC;IAEtC,OAAO,qBAAqB,CAAC,YAAY,EAAE,KAAK,CAAC;QAC/C,CAAC,CAAC,YAAY,CAAC,KAAK;QACpB,CAAC,CAAC,8BAAmB,CAAC,MAAM,CAAC;AACjC,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc;IAC3C,OAAO,MAAM,CAAC,MAAM,CAAC,8BAAmB,CAAC,CAAC,QAAQ,CAChD,KAA4B,CAC7B,CAAC;AACJ,CAAC","sourcesContent":["import { gweiDecToWEIBN, toHex } from '@metamask/controller-utils';\nimport type {\n  FetchGasFeeEstimateOptions,\n  GasFeeState,\n} from '@metamask/gas-fee-controller';\nimport type { Hex } from '@metamask/utils';\nimport { add0x, createModuleLogger } from '@metamask/utils';\n\nimport { projectLogger } from '../logger.js';\nimport type { TransactionControllerMessenger } from '../TransactionController.js';\nimport type {\n  SavedGasFees,\n  TransactionParams,\n  TransactionMeta,\n  GasFeeFlow,\n} from '../types.js';\nimport {\n  GasFeeEstimateLevel,\n  GasFeeEstimateType,\n  TransactionType,\n  UserFeeLevel,\n} from '../types.js';\nimport { getGasFeeFlow } from './gas-flow.js';\nimport { rpcRequest } from './provider.js';\nimport { SWAP_TRANSACTION_TYPES } from './swaps.js';\n\nexport type UpdateGasFeesRequest = {\n  eip1559: boolean;\n  gasFeeFlows: GasFeeFlow[];\n  getGasFeeEstimates: (\n    options: FetchGasFeeEstimateOptions,\n  ) => Promise<GasFeeState>;\n  getSavedGasFees: (\n    transactionMeta: TransactionMeta,\n  ) => SavedGasFees | undefined;\n  messenger: TransactionControllerMessenger;\n  txMeta: TransactionMeta;\n};\n\nexport type GetGasFeeRequest = UpdateGasFeesRequest & {\n  initialParams: TransactionParams;\n  savedGasFees?: SavedGasFees;\n  suggestedGasFees: SuggestedGasFees;\n};\n\ntype SuggestedGasFees = {\n  maxFeePerGas?: string;\n  maxPriorityFeePerGas?: string;\n  gasPrice?: string;\n\n  /**\n   * Whether the suggested fee was derived from a specific estimate level,\n   * such as `low`/`medium`/`high`. This is `false` for estimate types that\n   * do not support per-level pricing, such as a flat `eth_gasPrice` value,\n   * or when the gas fee flow failed and a raw RPC fallback was used.\n   */\n  isEstimateLevelApplied?: boolean;\n};\n\nconst log = createModuleLogger(projectLogger, 'gas-fees');\n\nconst SAVED_GAS_FEES_IGNORED_TRANSACTION_TYPES = [\n  ...SWAP_TRANSACTION_TYPES,\n  TransactionType.bridge,\n  TransactionType.bridgeApproval,\n];\n\n/**\n * Update the gas fee properties of the provided transaction meta.\n *\n * @param request - The request object.\n */\nexport async function updateGasFees(\n  request: UpdateGasFeesRequest,\n): Promise<void> {\n  const { txMeta } = request;\n  const initialParams = { ...txMeta.txParams };\n\n  const shouldIgnoreSavedGasFees =\n    SAVED_GAS_FEES_IGNORED_TRANSACTION_TYPES.includes(\n      txMeta.type as TransactionType,\n    );\n\n  const savedGasFees =\n    shouldIgnoreSavedGasFees || hasInitialGasFeeParams(initialParams)\n      ? undefined\n      : request.getSavedGasFees(txMeta);\n\n  const suggestedGasFees = await getSuggestedGasFees({\n    ...request,\n    savedGasFees,\n  });\n\n  log('Suggested gas fees', suggestedGasFees);\n\n  const getGasFeeRequest: GetGasFeeRequest = {\n    ...request,\n    initialParams,\n    savedGasFees,\n    suggestedGasFees,\n  };\n\n  txMeta.txParams.maxFeePerGas = getMaxFeePerGas(getGasFeeRequest);\n\n  txMeta.txParams.maxPriorityFeePerGas =\n    getMaxPriorityFeePerGas(getGasFeeRequest);\n\n  txMeta.txParams.gasPrice = getGasPrice(getGasFeeRequest);\n  txMeta.userFeeLevel = getUserFeeLevel(getGasFeeRequest);\n\n  log('Updated gas fee properties', {\n    maxFeePerGas: txMeta.txParams.maxFeePerGas,\n    maxPriorityFeePerGas: txMeta.txParams.maxPriorityFeePerGas,\n    gasPrice: txMeta.txParams.gasPrice,\n  });\n\n  if (txMeta.txParams.maxFeePerGas || txMeta.txParams.maxPriorityFeePerGas) {\n    delete txMeta.txParams.gasPrice;\n  }\n\n  if (txMeta.txParams.gasPrice) {\n    delete txMeta.txParams.maxFeePerGas;\n    delete txMeta.txParams.maxPriorityFeePerGas;\n  }\n\n  updateDefaultGasEstimates(txMeta);\n}\n\n/**\n * Convert GWEI from decimal string to WEI as hex string.\n *\n * @param value - The GWEI value as a decimal string.\n * @returns The WEI value in hex.\n */\nexport function gweiDecimalToWeiHex(value: string): Hex {\n  return toHex(gweiDecToWEIBN(value));\n}\n\n/**\n * Converts a value from Gwei decimal representation to Wei decimal representation\n *\n * @param gweiDecimal - The value in Gwei as a string or number\n * @returns The value in Wei as a string\n *\n * @example\n * // Convert 1.5 Gwei to Wei\n * gweiDecimalToWeiDecimal(\"1.5\")\n * // Returns \"1500000000\"\n */\nexport function gweiDecimalToWeiDecimal(gweiDecimal: string | number): string {\n  const weiValue = Number(gweiDecimal) * 1e9;\n\n  return weiValue.toString().split('.')[0];\n}\n\n/**\n * Determine the maxFeePerGas value for the transaction.\n *\n * @param request - The request object.\n * @returns The maxFeePerGas value.\n */\nfunction getMaxFeePerGas(request: GetGasFeeRequest): string | undefined {\n  const { savedGasFees, eip1559, initialParams, suggestedGasFees } = request;\n\n  if (!eip1559) {\n    return undefined;\n  }\n\n  if (savedGasFees?.maxBaseFee) {\n    const maxFeePerGas = gweiDecimalToWeiHex(savedGasFees.maxBaseFee);\n    log('Using maxFeePerGas from savedGasFees', maxFeePerGas);\n    return maxFeePerGas;\n  }\n\n  if (initialParams.maxFeePerGas) {\n    log('Using maxFeePerGas from request', initialParams.maxFeePerGas);\n    return initialParams.maxFeePerGas;\n  }\n\n  if (initialParams.gasPrice && !initialParams.maxPriorityFeePerGas) {\n    log(\n      'Setting maxFeePerGas to gasPrice from request',\n      initialParams.gasPrice,\n    );\n    return initialParams.gasPrice;\n  }\n\n  if (suggestedGasFees.maxFeePerGas) {\n    log('Using suggested maxFeePerGas', suggestedGasFees.maxFeePerGas);\n    return suggestedGasFees.maxFeePerGas;\n  }\n\n  if (suggestedGasFees.gasPrice) {\n    log(\n      'Setting maxFeePerGas to suggested gasPrice',\n      suggestedGasFees.gasPrice,\n    );\n    return suggestedGasFees.gasPrice;\n  }\n\n  log('maxFeePerGas not set');\n  return undefined;\n}\n\n/**\n * Determine the maxPriorityFeePerGas value for the transaction.\n *\n * @param request - The request object.\n * @returns The maxPriorityFeePerGas value.\n */\nfunction getMaxPriorityFeePerGas(\n  request: GetGasFeeRequest,\n): string | undefined {\n  const { eip1559, initialParams, savedGasFees, suggestedGasFees, txMeta } =\n    request;\n\n  if (!eip1559) {\n    return undefined;\n  }\n\n  if (savedGasFees?.priorityFee) {\n    const maxPriorityFeePerGas = gweiDecimalToWeiHex(savedGasFees.priorityFee);\n    log(\n      'Using maxPriorityFeePerGas from savedGasFees.priorityFee',\n      maxPriorityFeePerGas,\n    );\n    return maxPriorityFeePerGas;\n  }\n\n  if (initialParams.maxPriorityFeePerGas) {\n    log(\n      'Using maxPriorityFeePerGas from request',\n      initialParams.maxPriorityFeePerGas,\n    );\n    return initialParams.maxPriorityFeePerGas;\n  }\n\n  if (initialParams.gasPrice && !initialParams.maxFeePerGas) {\n    log(\n      'Setting maxPriorityFeePerGas to gasPrice from request',\n      initialParams.gasPrice,\n    );\n    return initialParams.gasPrice;\n  }\n\n  if (suggestedGasFees.maxPriorityFeePerGas) {\n    log(\n      'Using suggested maxPriorityFeePerGas',\n      suggestedGasFees.maxPriorityFeePerGas,\n    );\n    return suggestedGasFees.maxPriorityFeePerGas;\n  }\n\n  if (txMeta.txParams.maxFeePerGas) {\n    log(\n      'Setting maxPriorityFeePerGas to maxFeePerGas',\n      txMeta.txParams.maxFeePerGas,\n    );\n    return txMeta.txParams.maxFeePerGas;\n  }\n\n  log('maxPriorityFeePerGas not set');\n  return undefined;\n}\n\n/**\n * Determine the gasPrice value for the transaction.\n *\n * @param request - The request object.\n * @returns The gasPrice value.\n */\nfunction getGasPrice(request: GetGasFeeRequest): string | undefined {\n  const { eip1559, initialParams, savedGasFees, suggestedGasFees } = request;\n\n  if (eip1559) {\n    return undefined;\n  }\n\n  if (savedGasFees?.gasPrice) {\n    const gasPrice = gweiDecimalToWeiHex(savedGasFees.gasPrice);\n    log('Using gasPrice from savedGasFees.gasPrice', gasPrice);\n    return gasPrice;\n  }\n\n  if (initialParams.gasPrice) {\n    log('Using gasPrice from request', initialParams.gasPrice);\n    return initialParams.gasPrice;\n  }\n\n  if (suggestedGasFees.maxFeePerGas) {\n    log('Using suggested maxFeePerGas', suggestedGasFees.maxFeePerGas);\n    return suggestedGasFees.maxFeePerGas;\n  }\n\n  if (suggestedGasFees.gasPrice) {\n    log('Using suggested gasPrice', suggestedGasFees.gasPrice);\n    return suggestedGasFees.gasPrice;\n  }\n\n  log('gasPrice not set');\n  return undefined;\n}\n\n/**\n * Determine the user fee level.\n *\n * @param request - The request object.\n * @returns The user fee level.\n */\nfunction getUserFeeLevel(request: GetGasFeeRequest): string | undefined {\n  const { initialParams, savedGasFees, suggestedGasFees, txMeta } = request;\n\n  if (savedGasFees) {\n    const hasCustomOverride =\n      savedGasFees.maxBaseFee !== undefined ||\n      savedGasFees.priorityFee !== undefined ||\n      savedGasFees.gasPrice !== undefined;\n\n    const canUseSavedLevel =\n      !hasCustomOverride &&\n      savedGasFees.level !== undefined &&\n      suggestedGasFees.isEstimateLevelApplied;\n\n    // A custom override on any field, or an estimate type that does not\n    // support per-level pricing (e.g. a flat eth_gasPrice value), means the\n    // fee is no longer purely level-derived, so it must not be tracked as a\n    // live estimate level by the gas fee poller, which would otherwise\n    // overwrite the override or misrepresent the fee as matching the level.\n    return canUseSavedLevel ? savedGasFees.level : UserFeeLevel.CUSTOM;\n  }\n\n  if (\n    !initialParams.maxFeePerGas &&\n    !initialParams.maxPriorityFeePerGas &&\n    initialParams.gasPrice\n  ) {\n    return txMeta.isInternal\n      ? UserFeeLevel.CUSTOM\n      : UserFeeLevel.DAPP_SUGGESTED;\n  }\n\n  if (\n    !initialParams.maxFeePerGas &&\n    !initialParams.maxPriorityFeePerGas &&\n    suggestedGasFees.maxFeePerGas &&\n    suggestedGasFees.maxPriorityFeePerGas\n  ) {\n    return UserFeeLevel.MEDIUM;\n  }\n\n  if (\n    !initialParams.maxFeePerGas &&\n    !initialParams.maxPriorityFeePerGas &&\n    suggestedGasFees.gasPrice\n  ) {\n    return UserFeeLevel.MEDIUM;\n  }\n\n  if (txMeta.isInternal) {\n    return UserFeeLevel.MEDIUM;\n  }\n\n  return UserFeeLevel.DAPP_SUGGESTED;\n}\n\n/**\n * Update the default gas estimates for the provided transaction.\n *\n * @param txMeta - The transaction metadata.\n */\nfunction updateDefaultGasEstimates(txMeta: TransactionMeta): void {\n  txMeta.defaultGasEstimates ??= {};\n  txMeta.defaultGasEstimates.maxFeePerGas = txMeta.txParams.maxFeePerGas;\n\n  txMeta.defaultGasEstimates.maxPriorityFeePerGas =\n    txMeta.txParams.maxPriorityFeePerGas;\n\n  txMeta.defaultGasEstimates.gasPrice = txMeta.txParams.gasPrice;\n  txMeta.defaultGasEstimates.estimateType = txMeta.userFeeLevel;\n}\n\n/**\n * Retrieve the suggested gas fees using the gas fee flows.\n *\n * @param request - The request object.\n * @returns The suggested gas fees.\n */\nasync function getSuggestedGasFees(\n  request: UpdateGasFeesRequest & { savedGasFees?: SavedGasFees },\n): Promise<SuggestedGasFees> {\n  const {\n    eip1559,\n    gasFeeFlows,\n    getGasFeeEstimates,\n    messenger,\n    savedGasFees,\n    txMeta,\n  } = request;\n  const { networkClientId } = txMeta;\n\n  if (\n    (!eip1559 && txMeta.txParams.gasPrice) ||\n    (eip1559 &&\n      txMeta.txParams.maxFeePerGas &&\n      txMeta.txParams.maxPriorityFeePerGas)\n  ) {\n    return {};\n  }\n\n  const gasFeeFlow = getGasFeeFlow(\n    txMeta,\n    gasFeeFlows,\n    messenger,\n  ) as GasFeeFlow;\n\n  try {\n    const gasFeeControllerData = await getGasFeeEstimates({ networkClientId });\n\n    const response = await gasFeeFlow.getGasFees({\n      gasFeeControllerData,\n      messenger,\n      transactionMeta: txMeta,\n    });\n\n    const gasFeeEstimateType = response.estimates?.type;\n    const savedGasFeeEstimateLevel = getSavedGasFeeEstimateLevel(savedGasFees);\n\n    switch (gasFeeEstimateType) {\n      case GasFeeEstimateType.FeeMarket:\n        return {\n          ...(response.estimates[savedGasFeeEstimateLevel] ??\n            response.estimates.medium),\n          isEstimateLevelApplied: true,\n        };\n      case GasFeeEstimateType.Legacy:\n        return {\n          gasPrice:\n            response.estimates[savedGasFeeEstimateLevel] ??\n            response.estimates.medium,\n          isEstimateLevelApplied: true,\n        };\n      case GasFeeEstimateType.GasPrice:\n        return {\n          gasPrice: response.estimates.gasPrice,\n          isEstimateLevelApplied: false,\n        };\n      default:\n        throw new Error(\n          // TODO: Either fix this lint violation or explain why it's necessary to ignore.\n          // eslint-disable-next-line @typescript-eslint/restrict-template-expressions\n          `Unsupported gas fee estimate type returned from flow: ${gasFeeEstimateType}`,\n        );\n    }\n  } catch (error) {\n    log('Failed to get suggested gas fees', error);\n  }\n\n  const gasPriceHex = (await rpcRequest({\n    messenger,\n    networkClientId,\n    method: 'eth_gasPrice',\n  })) as Hex | undefined;\n\n  const gasPrice = gasPriceHex ? add0x(gasPriceHex) : undefined;\n\n  return { gasPrice };\n}\n\nfunction hasInitialGasFeeParams(initialParams: TransactionParams): boolean {\n  return [\n    initialParams.maxFeePerGas,\n    initialParams.maxPriorityFeePerGas,\n    initialParams.gasPrice,\n  ].some(Boolean);\n}\n\nfunction getSavedGasFeeEstimateLevel(\n  savedGasFees: SavedGasFees | undefined,\n): GasFeeEstimateLevel {\n  return isGasFeeEstimateLevel(savedGasFees?.level)\n    ? savedGasFees.level\n    : GasFeeEstimateLevel.Medium;\n}\n\nfunction isGasFeeEstimateLevel(level: unknown): level is GasFeeEstimateLevel {\n  return Object.values(GasFeeEstimateLevel).includes(\n    level as GasFeeEstimateLevel,\n  );\n}\n"]}
+{"version":3,"file":"gas-fees.cjs","sourceRoot":"","sources":["../../src/utils/gas-fees.ts"],"names":[],"mappings":"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","sourcesContent":["import { gweiDecToWEIBN, toHex } from '@metamask/controller-utils';\nimport type {\n  FetchGasFeeEstimateOptions,\n  GasFeeState,\n} from '@metamask/gas-fee-controller';\nimport type { Hex } from '@metamask/utils';\nimport { add0x, createModuleLogger } from '@metamask/utils';\n\nimport { projectLogger } from '../logger.js';\nimport type { TransactionControllerMessenger } from '../TransactionController.js';\nimport type {\n  FeeMarketGasFeeEstimateForLevel,\n  SavedGasFees,\n  TransactionParams,\n  TransactionMeta,\n  GasFeeFlow,\n} from '../types.js';\nimport {\n  GasFeeEstimateLevel,\n  GasFeeEstimateType,\n  TransactionType,\n  UserFeeLevel,\n} from '../types.js';\nimport {\n  getReplaceUnderpricedDappGasFeesEnabled,\n  getReplaceUnderpricedSavedGasFeesEnabled,\n} from './feature-flags.js';\nimport { getGasFeeFlow } from './gas-flow.js';\nimport { rpcRequest } from './provider.js';\nimport { SWAP_TRANSACTION_TYPES } from './swaps.js';\n\nexport type UpdateGasFeesRequest = {\n  eip1559: boolean;\n  gasFeeFlows: GasFeeFlow[];\n  getGasFeeEstimates: (\n    options: FetchGasFeeEstimateOptions,\n  ) => Promise<GasFeeState>;\n  getSavedGasFees: (\n    transactionMeta: TransactionMeta,\n  ) => SavedGasFees | undefined;\n  messenger: TransactionControllerMessenger;\n  txMeta: TransactionMeta;\n};\n\nexport type GetGasFeeRequest = UpdateGasFeesRequest & {\n  initialParams: TransactionParams;\n  savedGasFees?: SavedGasFees;\n  suggestedGasFees: SuggestedGasFees;\n};\n\ntype SuggestedGasFees = {\n  maxFeePerGas?: string;\n  maxPriorityFeePerGas?: string;\n  gasPrice?: string;\n\n  /**\n   * Whether the suggested fee was derived from a specific estimate level,\n   * such as `low`/`medium`/`high`. This is `false` for estimate types that\n   * do not support per-level pricing, such as a flat `eth_gasPrice` value,\n   * or when the gas fee flow failed and a raw RPC fallback was used.\n   */\n  isEstimateLevelApplied?: boolean;\n\n  low?: FeeMarketGasFeeEstimateForLevel;\n};\n\nconst log = createModuleLogger(projectLogger, 'gas-fees');\n\nconst SAVED_GAS_FEES_IGNORED_TRANSACTION_TYPES = [\n  ...SWAP_TRANSACTION_TYPES,\n  TransactionType.bridge,\n  TransactionType.bridgeApproval,\n];\n\n/**\n * Update the gas fee properties of the provided transaction meta.\n *\n * @param request - The request object.\n */\nexport async function updateGasFees(\n  request: UpdateGasFeesRequest,\n): Promise<void> {\n  const { txMeta } = request;\n  const initialParams = { ...txMeta.txParams };\n\n  const shouldIgnoreSavedGasFees =\n    SAVED_GAS_FEES_IGNORED_TRANSACTION_TYPES.includes(\n      txMeta.type as TransactionType,\n    );\n\n  let savedGasFees =\n    shouldIgnoreSavedGasFees || hasInitialGasFeeParams(initialParams)\n      ? undefined\n      : request.getSavedGasFees(txMeta);\n\n  const suggestedGasFees = await getSuggestedGasFees({\n    ...request,\n    savedGasFees,\n  });\n\n  log('Suggested gas fees', suggestedGasFees);\n\n  if (\n    shouldIgnoreUnderpricedSavedGasFees(savedGasFees, suggestedGasFees, request)\n  ) {\n    log(\n      'Ignoring saved custom gas fees below low estimate',\n      savedGasFees?.maxBaseFee,\n      suggestedGasFees.low?.maxFeePerGas,\n    );\n    savedGasFees = undefined;\n  }\n\n  const getGasFeeRequest: GetGasFeeRequest = {\n    ...request,\n    initialParams,\n    savedGasFees,\n    suggestedGasFees,\n  };\n\n  txMeta.txParams.maxFeePerGas = getMaxFeePerGas(getGasFeeRequest);\n\n  txMeta.txParams.maxPriorityFeePerGas =\n    getMaxPriorityFeePerGas(getGasFeeRequest);\n\n  txMeta.txParams.gasPrice = getGasPrice(getGasFeeRequest);\n  txMeta.userFeeLevel = getUserFeeLevel(getGasFeeRequest);\n\n  log('Updated gas fee properties', {\n    maxFeePerGas: txMeta.txParams.maxFeePerGas,\n    maxPriorityFeePerGas: txMeta.txParams.maxPriorityFeePerGas,\n    gasPrice: txMeta.txParams.gasPrice,\n  });\n\n  if (txMeta.txParams.maxFeePerGas || txMeta.txParams.maxPriorityFeePerGas) {\n    delete txMeta.txParams.gasPrice;\n  }\n\n  if (txMeta.txParams.gasPrice) {\n    delete txMeta.txParams.maxFeePerGas;\n    delete txMeta.txParams.maxPriorityFeePerGas;\n  }\n\n  updateDefaultGasEstimates(txMeta);\n}\n\n/**\n * Convert GWEI from decimal string to WEI as hex string.\n *\n * @param value - The GWEI value as a decimal string.\n * @returns The WEI value in hex.\n */\nexport function gweiDecimalToWeiHex(value: string): Hex {\n  return toHex(gweiDecToWEIBN(value));\n}\n\n/**\n * Converts a value from Gwei decimal representation to Wei decimal representation\n *\n * @param gweiDecimal - The value in Gwei as a string or number\n * @returns The value in Wei as a string\n *\n * @example\n * // Convert 1.5 Gwei to Wei\n * gweiDecimalToWeiDecimal(\"1.5\")\n * // Returns \"1500000000\"\n */\nexport function gweiDecimalToWeiDecimal(gweiDecimal: string | number): string {\n  const weiValue = Number(gweiDecimal) * 1e9;\n\n  return weiValue.toString().split('.')[0];\n}\n\n/**\n * Determine whether saved (advanced) gas fee preferences should be ignored in\n * favour of the suggested gas fees, as the saved custom `maxBaseFee` is below\n * the current low estimate and hence unlikely to result in timely inclusion in\n * a block. Level-based saved preferences track current estimates and are never\n * ignored.\n *\n * @param savedGasFees - The saved gas fee preferences.\n * @param suggestedGasFees - The suggested gas fees.\n * @param request - The request object.\n * @returns Whether the saved gas fee preferences should be ignored.\n */\nfunction shouldIgnoreUnderpricedSavedGasFees(\n  savedGasFees: SavedGasFees | undefined,\n  suggestedGasFees: SuggestedGasFees,\n  request: UpdateGasFeesRequest,\n): boolean {\n  const { eip1559, messenger, txMeta } = request;\n\n  if (\n    !eip1559 ||\n    !savedGasFees?.maxBaseFee ||\n    !getReplaceUnderpricedSavedGasFeesEnabled(txMeta.chainId, messenger)\n  ) {\n    return false;\n  }\n\n  const lowMaxFeePerGas = suggestedGasFees.low?.maxFeePerGas;\n\n  const hasReplacement =\n    Boolean(suggestedGasFees.maxFeePerGas) &&\n    Boolean(suggestedGasFees.maxPriorityFeePerGas);\n\n  if (!lowMaxFeePerGas || !hasReplacement) {\n    return false;\n  }\n\n  return isFeeBelowLowEstimate(\n    gweiDecimalToWeiHex(savedGasFees.maxBaseFee),\n    lowMaxFeePerGas,\n  );\n}\n\n/**\n * Determine whether a fee value is below the low estimate.\n *\n * @param valueHex - The fee value as a hex string.\n * @param lowMaxFeePerGasHex - The low estimate `maxFeePerGas` as a hex string.\n * @returns Whether the fee value is below the low estimate.\n */\nfunction isFeeBelowLowEstimate(\n  valueHex: string,\n  lowMaxFeePerGasHex: string,\n): boolean {\n  try {\n    return BigInt(valueHex) < BigInt(lowMaxFeePerGasHex);\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Determine whether dapp-suggested gas fees should be ignored in favour of the\n * suggested gas fees, as the dapp-suggested `maxFeePerGas` is below the current\n * low estimate and hence unlikely to result in timely inclusion in a block.\n *\n * @param request - The request object.\n * @returns Whether the dapp-suggested gas fees should be ignored.\n */\nfunction shouldIgnoreDappGasFees(request: GetGasFeeRequest): boolean {\n  const {\n    eip1559,\n    initialParams,\n    messenger,\n    savedGasFees,\n    suggestedGasFees,\n    txMeta,\n  } = request;\n\n  if (\n    !eip1559 ||\n    savedGasFees ||\n    txMeta.isInternal ||\n    !getReplaceUnderpricedDappGasFeesEnabled(txMeta.chainId, messenger)\n  ) {\n    return false;\n  }\n\n  const dappMaxFeePerGas =\n    initialParams.maxFeePerGas ??\n    (initialParams.gasPrice && !initialParams.maxPriorityFeePerGas\n      ? initialParams.gasPrice\n      : undefined);\n\n  const lowMaxFeePerGas = suggestedGasFees.low?.maxFeePerGas;\n\n  const hasReplacement =\n    Boolean(suggestedGasFees.maxFeePerGas) &&\n    Boolean(suggestedGasFees.maxPriorityFeePerGas);\n\n  if (!dappMaxFeePerGas || !lowMaxFeePerGas || !hasReplacement) {\n    return false;\n  }\n\n  return isFeeBelowLowEstimate(dappMaxFeePerGas, lowMaxFeePerGas);\n}\n\n/**\n * Determine the maxFeePerGas value for the transaction.\n *\n * @param request - The request object.\n * @returns The maxFeePerGas value.\n */\nfunction getMaxFeePerGas(request: GetGasFeeRequest): string | undefined {\n  const { savedGasFees, eip1559, initialParams, suggestedGasFees } = request;\n\n  if (!eip1559) {\n    return undefined;\n  }\n\n  if (savedGasFees?.maxBaseFee) {\n    const maxFeePerGas = gweiDecimalToWeiHex(savedGasFees.maxBaseFee);\n    log('Using maxFeePerGas from savedGasFees', maxFeePerGas);\n    return maxFeePerGas;\n  }\n\n  const ignoreDappGasFees = shouldIgnoreDappGasFees(request);\n\n  if (initialParams.maxFeePerGas && !ignoreDappGasFees) {\n    log('Using maxFeePerGas from request', initialParams.maxFeePerGas);\n    return initialParams.maxFeePerGas;\n  }\n\n  if (\n    initialParams.gasPrice &&\n    !initialParams.maxPriorityFeePerGas &&\n    !ignoreDappGasFees\n  ) {\n    log(\n      'Setting maxFeePerGas to gasPrice from request',\n      initialParams.gasPrice,\n    );\n    return initialParams.gasPrice;\n  }\n\n  if (ignoreDappGasFees) {\n    log(\n      'Ignoring dapp-suggested maxFeePerGas below low estimate',\n      initialParams.maxFeePerGas ?? initialParams.gasPrice,\n      suggestedGasFees.low?.maxFeePerGas,\n    );\n  }\n\n  if (suggestedGasFees.maxFeePerGas) {\n    log('Using suggested maxFeePerGas', suggestedGasFees.maxFeePerGas);\n    return suggestedGasFees.maxFeePerGas;\n  }\n\n  if (suggestedGasFees.gasPrice) {\n    log(\n      'Setting maxFeePerGas to suggested gasPrice',\n      suggestedGasFees.gasPrice,\n    );\n    return suggestedGasFees.gasPrice;\n  }\n\n  log('maxFeePerGas not set');\n  return undefined;\n}\n\n/**\n * Determine the maxPriorityFeePerGas value for the transaction.\n *\n * @param request - The request object.\n * @returns The maxPriorityFeePerGas value.\n */\nfunction getMaxPriorityFeePerGas(\n  request: GetGasFeeRequest,\n): string | undefined {\n  const { eip1559, initialParams, savedGasFees, suggestedGasFees, txMeta } =\n    request;\n\n  if (!eip1559) {\n    return undefined;\n  }\n\n  if (savedGasFees?.priorityFee) {\n    const maxPriorityFeePerGas = gweiDecimalToWeiHex(savedGasFees.priorityFee);\n    log(\n      'Using maxPriorityFeePerGas from savedGasFees.priorityFee',\n      maxPriorityFeePerGas,\n    );\n    return maxPriorityFeePerGas;\n  }\n\n  const ignoreDappGasFees = shouldIgnoreDappGasFees(request);\n\n  if (initialParams.maxPriorityFeePerGas && !ignoreDappGasFees) {\n    log(\n      'Using maxPriorityFeePerGas from request',\n      initialParams.maxPriorityFeePerGas,\n    );\n    return initialParams.maxPriorityFeePerGas;\n  }\n\n  if (\n    initialParams.gasPrice &&\n    !initialParams.maxFeePerGas &&\n    !ignoreDappGasFees\n  ) {\n    log(\n      'Setting maxPriorityFeePerGas to gasPrice from request',\n      initialParams.gasPrice,\n    );\n    return initialParams.gasPrice;\n  }\n\n  if (suggestedGasFees.maxPriorityFeePerGas) {\n    log(\n      'Using suggested maxPriorityFeePerGas',\n      suggestedGasFees.maxPriorityFeePerGas,\n    );\n    return suggestedGasFees.maxPriorityFeePerGas;\n  }\n\n  if (txMeta.txParams.maxFeePerGas) {\n    log(\n      'Setting maxPriorityFeePerGas to maxFeePerGas',\n      txMeta.txParams.maxFeePerGas,\n    );\n    return txMeta.txParams.maxFeePerGas;\n  }\n\n  log('maxPriorityFeePerGas not set');\n  return undefined;\n}\n\n/**\n * Determine the gasPrice value for the transaction.\n *\n * @param request - The request object.\n * @returns The gasPrice value.\n */\nfunction getGasPrice(request: GetGasFeeRequest): string | undefined {\n  const { eip1559, initialParams, savedGasFees, suggestedGasFees } = request;\n\n  if (eip1559) {\n    return undefined;\n  }\n\n  if (savedGasFees?.gasPrice) {\n    const gasPrice = gweiDecimalToWeiHex(savedGasFees.gasPrice);\n    log('Using gasPrice from savedGasFees.gasPrice', gasPrice);\n    return gasPrice;\n  }\n\n  if (initialParams.gasPrice) {\n    log('Using gasPrice from request', initialParams.gasPrice);\n    return initialParams.gasPrice;\n  }\n\n  if (suggestedGasFees.maxFeePerGas) {\n    log('Using suggested maxFeePerGas', suggestedGasFees.maxFeePerGas);\n    return suggestedGasFees.maxFeePerGas;\n  }\n\n  if (suggestedGasFees.gasPrice) {\n    log('Using suggested gasPrice', suggestedGasFees.gasPrice);\n    return suggestedGasFees.gasPrice;\n  }\n\n  log('gasPrice not set');\n  return undefined;\n}\n\n/**\n * Determine the user fee level.\n *\n * @param request - The request object.\n * @returns The user fee level.\n */\nfunction getUserFeeLevel(request: GetGasFeeRequest): string | undefined {\n  const { initialParams, savedGasFees, suggestedGasFees, txMeta } = request;\n\n  if (savedGasFees) {\n    const hasCustomOverride =\n      savedGasFees.maxBaseFee !== undefined ||\n      savedGasFees.priorityFee !== undefined ||\n      savedGasFees.gasPrice !== undefined;\n\n    const canUseSavedLevel =\n      !hasCustomOverride &&\n      savedGasFees.level !== undefined &&\n      suggestedGasFees.isEstimateLevelApplied;\n\n    // A custom override on any field, or an estimate type that does not\n    // support per-level pricing (e.g. a flat eth_gasPrice value), means the\n    // fee is no longer purely level-derived, so it must not be tracked as a\n    // live estimate level by the gas fee poller, which would otherwise\n    // overwrite the override or misrepresent the fee as matching the level.\n    return canUseSavedLevel ? savedGasFees.level : UserFeeLevel.CUSTOM;\n  }\n\n  // Underpriced dapp-suggested fees are replaced with the suggested medium\n  // values, so also use the medium fee level to keep the values updated while\n  // the transaction is unapproved.\n  if (shouldIgnoreDappGasFees(request)) {\n    return UserFeeLevel.MEDIUM;\n  }\n\n  if (\n    !initialParams.maxFeePerGas &&\n    !initialParams.maxPriorityFeePerGas &&\n    initialParams.gasPrice\n  ) {\n    return txMeta.isInternal\n      ? UserFeeLevel.CUSTOM\n      : UserFeeLevel.DAPP_SUGGESTED;\n  }\n\n  if (\n    !initialParams.maxFeePerGas &&\n    !initialParams.maxPriorityFeePerGas &&\n    suggestedGasFees.maxFeePerGas &&\n    suggestedGasFees.maxPriorityFeePerGas\n  ) {\n    return UserFeeLevel.MEDIUM;\n  }\n\n  if (\n    !initialParams.maxFeePerGas &&\n    !initialParams.maxPriorityFeePerGas &&\n    suggestedGasFees.gasPrice\n  ) {\n    return UserFeeLevel.MEDIUM;\n  }\n\n  if (txMeta.isInternal) {\n    return UserFeeLevel.MEDIUM;\n  }\n\n  return UserFeeLevel.DAPP_SUGGESTED;\n}\n\n/**\n * Update the default gas estimates for the provided transaction.\n *\n * @param txMeta - The transaction metadata.\n */\nfunction updateDefaultGasEstimates(txMeta: TransactionMeta): void {\n  txMeta.defaultGasEstimates ??= {};\n  txMeta.defaultGasEstimates.maxFeePerGas = txMeta.txParams.maxFeePerGas;\n\n  txMeta.defaultGasEstimates.maxPriorityFeePerGas =\n    txMeta.txParams.maxPriorityFeePerGas;\n\n  txMeta.defaultGasEstimates.gasPrice = txMeta.txParams.gasPrice;\n  txMeta.defaultGasEstimates.estimateType = txMeta.userFeeLevel;\n}\n\n/**\n * Retrieve the suggested gas fees using the gas fee flows.\n *\n * @param request - The request object.\n * @returns The suggested gas fees.\n */\nasync function getSuggestedGasFees(\n  request: UpdateGasFeesRequest & { savedGasFees?: SavedGasFees },\n): Promise<SuggestedGasFees> {\n  const {\n    eip1559,\n    gasFeeFlows,\n    getGasFeeEstimates,\n    messenger,\n    savedGasFees,\n    txMeta,\n  } = request;\n  const { networkClientId } = txMeta;\n\n  const hasCompleteDappFees =\n    eip1559 &&\n    Boolean(txMeta.txParams.maxFeePerGas) &&\n    Boolean(txMeta.txParams.maxPriorityFeePerGas);\n\n  // Estimates are still required for transactions with complete dapp-suggested\n  // fees if they may be replaced due to being underpriced.\n  const isEstimateRequiredForDappFees =\n    hasCompleteDappFees &&\n    !txMeta.isInternal &&\n    getReplaceUnderpricedDappGasFeesEnabled(txMeta.chainId, messenger);\n\n  if (\n    (!eip1559 && txMeta.txParams.gasPrice) ||\n    (hasCompleteDappFees && !isEstimateRequiredForDappFees)\n  ) {\n    return {};\n  }\n\n  const gasFeeFlow = getGasFeeFlow(\n    txMeta,\n    gasFeeFlows,\n    messenger,\n  ) as GasFeeFlow;\n\n  try {\n    const gasFeeControllerData = await getGasFeeEstimates({ networkClientId });\n\n    const response = await gasFeeFlow.getGasFees({\n      gasFeeControllerData,\n      messenger,\n      transactionMeta: txMeta,\n    });\n\n    const gasFeeEstimateType = response.estimates?.type;\n    const savedGasFeeEstimateLevel = getSavedGasFeeEstimateLevel(savedGasFees);\n\n    switch (gasFeeEstimateType) {\n      case GasFeeEstimateType.FeeMarket:\n        return {\n          ...(response.estimates[savedGasFeeEstimateLevel] ??\n            response.estimates.medium),\n          isEstimateLevelApplied: true,\n          low: response.estimates.low,\n        };\n      case GasFeeEstimateType.Legacy:\n        return {\n          gasPrice:\n            response.estimates[savedGasFeeEstimateLevel] ??\n            response.estimates.medium,\n          isEstimateLevelApplied: true,\n        };\n      case GasFeeEstimateType.GasPrice:\n        return {\n          gasPrice: response.estimates.gasPrice,\n          isEstimateLevelApplied: false,\n        };\n      default:\n        throw new Error(\n          // TODO: Either fix this lint violation or explain why it's necessary to ignore.\n          // eslint-disable-next-line @typescript-eslint/restrict-template-expressions\n          `Unsupported gas fee estimate type returned from flow: ${gasFeeEstimateType}`,\n        );\n    }\n  } catch (error) {\n    log('Failed to get suggested gas fees', error);\n  }\n\n  // Estimates on this path are only needed to check complete dapp-suggested\n  // fees, so no fallback is required and any failure must not block\n  // transaction creation.\n  if (hasCompleteDappFees) {\n    return {};\n  }\n\n  const gasPriceHex = (await rpcRequest({\n    messenger,\n    networkClientId,\n    method: 'eth_gasPrice',\n  })) as Hex | undefined;\n\n  const gasPrice = gasPriceHex ? add0x(gasPriceHex) : undefined;\n\n  return { gasPrice };\n}\n\nfunction hasInitialGasFeeParams(initialParams: TransactionParams): boolean {\n  return [\n    initialParams.maxFeePerGas,\n    initialParams.maxPriorityFeePerGas,\n    initialParams.gasPrice,\n  ].some(Boolean);\n}\n\nfunction getSavedGasFeeEstimateLevel(\n  savedGasFees: SavedGasFees | undefined,\n): GasFeeEstimateLevel {\n  return isGasFeeEstimateLevel(savedGasFees?.level)\n    ? savedGasFees.level\n    : GasFeeEstimateLevel.Medium;\n}\n\nfunction isGasFeeEstimateLevel(level: unknown): level is GasFeeEstimateLevel {\n  return Object.values(GasFeeEstimateLevel).includes(\n    level as GasFeeEstimateLevel,\n  );\n}\n"]}

package/dist/utils/gas-fees.d.cts

@@ -1,7 +1,7 @@
 import type { FetchGasFeeEstimateOptions, GasFeeState } from "@metamask/gas-fee-controller";
 import type { Hex } from "@metamask/utils";
 import type { TransactionControllerMessenger } from "../TransactionController.cjs";
-import type { SavedGasFees, TransactionParams, TransactionMeta, GasFeeFlow } from "../types.cjs";
+import type { FeeMarketGasFeeEstimateForLevel, SavedGasFees, TransactionParams, TransactionMeta, GasFeeFlow } from "../types.cjs";
 export type UpdateGasFeesRequest = {
     eip1559: boolean;
     gasFeeFlows: GasFeeFlow[];
@@ -26,6 +26,7 @@ type SuggestedGasFees = {
      * or when the gas fee flow failed and a raw RPC fallback was used.
      */
     isEstimateLevelApplied?: boolean;
+    low?: FeeMarketGasFeeEstimateForLevel;
 };
 /**
  * Update the gas fee properties of the provided transaction meta.

package/dist/utils/gas-fees.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"gas-fees.d.cts","sourceRoot":"","sources":["../../src/utils/gas-fees.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,0BAA0B,EAC1B,WAAW,EACZ,qCAAqC;AACtC,OAAO,KAAK,EAAE,GAAG,EAAE,wBAAwB;AAI3C,OAAO,KAAK,EAAE,8BAA8B,EAAE,qCAAoC;AAClF,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,UAAU,EACX,qBAAoB;AAWrB,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,kBAAkB,EAAE,CAClB,OAAO,EAAE,0BAA0B,KAChC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1B,eAAe,EAAE,CACf,eAAe,EAAE,eAAe,KAC7B,YAAY,GAAG,SAAS,CAAC;IAC9B,SAAS,EAAE,8BAA8B,CAAC;IAC1C,MAAM,EAAE,eAAe,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,GAAG;IACpD,aAAa,EAAE,iBAAiB,CAAC;IACjC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,gBAAgB,EAAE,gBAAgB,CAAC;CACpC,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC,CAAC;AAUF;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAoDf;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAEtD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAI5E"}
+{"version":3,"file":"gas-fees.d.cts","sourceRoot":"","sources":["../../src/utils/gas-fees.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,0BAA0B,EAC1B,WAAW,EACZ,qCAAqC;AACtC,OAAO,KAAK,EAAE,GAAG,EAAE,wBAAwB;AAI3C,OAAO,KAAK,EAAE,8BAA8B,EAAE,qCAAoC;AAClF,OAAO,KAAK,EACV,+BAA+B,EAC/B,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,UAAU,EACX,qBAAoB;AAerB,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,kBAAkB,EAAE,CAClB,OAAO,EAAE,0BAA0B,KAChC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1B,eAAe,EAAE,CACf,eAAe,EAAE,eAAe,KAC7B,YAAY,GAAG,SAAS,CAAC;IAC9B,SAAS,EAAE,8BAA8B,CAAC;IAC1C,MAAM,EAAE,eAAe,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,GAAG;IACpD,aAAa,EAAE,iBAAiB,CAAC;IACjC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,gBAAgB,EAAE,gBAAgB,CAAC;CACpC,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC,GAAG,CAAC,EAAE,+BAA+B,CAAC;CACvC,CAAC;AAUF;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CA+Df;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAEtD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAI5E"}

package/dist/utils/gas-fees.d.mts

@@ -1,7 +1,7 @@
 import type { FetchGasFeeEstimateOptions, GasFeeState } from "@metamask/gas-fee-controller";
 import type { Hex } from "@metamask/utils";
 import type { TransactionControllerMessenger } from "../TransactionController.mjs";
-import type { SavedGasFees, TransactionParams, TransactionMeta, GasFeeFlow } from "../types.mjs";
+import type { FeeMarketGasFeeEstimateForLevel, SavedGasFees, TransactionParams, TransactionMeta, GasFeeFlow } from "../types.mjs";
 export type UpdateGasFeesRequest = {
     eip1559: boolean;
     gasFeeFlows: GasFeeFlow[];
@@ -26,6 +26,7 @@ type SuggestedGasFees = {
      * or when the gas fee flow failed and a raw RPC fallback was used.
      */
     isEstimateLevelApplied?: boolean;
+    low?: FeeMarketGasFeeEstimateForLevel;
 };
 /**
  * Update the gas fee properties of the provided transaction meta.

package/dist/utils/gas-fees.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"gas-fees.d.mts","sourceRoot":"","sources":["../../src/utils/gas-fees.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,0BAA0B,EAC1B,WAAW,EACZ,qCAAqC;AACtC,OAAO,KAAK,EAAE,GAAG,EAAE,wBAAwB;AAI3C,OAAO,KAAK,EAAE,8BAA8B,EAAE,qCAAoC;AAClF,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,UAAU,EACX,qBAAoB;AAWrB,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,kBAAkB,EAAE,CAClB,OAAO,EAAE,0BAA0B,KAChC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1B,eAAe,EAAE,CACf,eAAe,EAAE,eAAe,KAC7B,YAAY,GAAG,SAAS,CAAC;IAC9B,SAAS,EAAE,8BAA8B,CAAC;IAC1C,MAAM,EAAE,eAAe,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,GAAG;IACpD,aAAa,EAAE,iBAAiB,CAAC;IACjC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,gBAAgB,EAAE,gBAAgB,CAAC;CACpC,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC,CAAC;AAUF;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAoDf;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAEtD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAI5E"}
+{"version":3,"file":"gas-fees.d.mts","sourceRoot":"","sources":["../../src/utils/gas-fees.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,0BAA0B,EAC1B,WAAW,EACZ,qCAAqC;AACtC,OAAO,KAAK,EAAE,GAAG,EAAE,wBAAwB;AAI3C,OAAO,KAAK,EAAE,8BAA8B,EAAE,qCAAoC;AAClF,OAAO,KAAK,EACV,+BAA+B,EAC/B,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,UAAU,EACX,qBAAoB;AAerB,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,kBAAkB,EAAE,CAClB,OAAO,EAAE,0BAA0B,KAChC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1B,eAAe,EAAE,CACf,eAAe,EAAE,eAAe,KAC7B,YAAY,GAAG,SAAS,CAAC;IAC9B,SAAS,EAAE,8BAA8B,CAAC;IAC1C,MAAM,EAAE,eAAe,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,GAAG;IACpD,aAAa,EAAE,iBAAiB,CAAC;IACjC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,gBAAgB,EAAE,gBAAgB,CAAC;CACpC,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC,GAAG,CAAC,EAAE,+BAA+B,CAAC;CACvC,CAAC;AAUF;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CA+Df;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAEtD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAI5E"}

package/dist/utils/gas-fees.mjs

@@ -2,6 +2,7 @@ import { gweiDecToWEIBN, toHex } from "@metamask/controller-utils";
 import { add0x, createModuleLogger } from "@metamask/utils";
 import { projectLogger } from "../logger.mjs";
 import { GasFeeEstimateLevel, GasFeeEstimateType, TransactionType, UserFeeLevel } from "../types.mjs";
+import { getReplaceUnderpricedDappGasFeesEnabled, getReplaceUnderpricedSavedGasFeesEnabled } from "./feature-flags.mjs";
 import { getGasFeeFlow } from "./gas-flow.mjs";
 import { rpcRequest } from "./provider.mjs";
 import { SWAP_TRANSACTION_TYPES } from "./swaps.mjs";
@@ -20,7 +21,7 @@ export async function updateGasFees(request) {
     const { txMeta } = request;
     const initialParams = { ...txMeta.txParams };
     const shouldIgnoreSavedGasFees = SAVED_GAS_FEES_IGNORED_TRANSACTION_TYPES.includes(txMeta.type);
-    const savedGasFees = shouldIgnoreSavedGasFees || hasInitialGasFeeParams(initialParams)
+    let savedGasFees = shouldIgnoreSavedGasFees || hasInitialGasFeeParams(initialParams)
         ? undefined
         : request.getSavedGasFees(txMeta);
     const suggestedGasFees = await getSuggestedGasFees({
@@ -28,6 +29,10 @@ export async function updateGasFees(request) {
         savedGasFees,
     });
     log('Suggested gas fees', suggestedGasFees);
+    if (shouldIgnoreUnderpricedSavedGasFees(savedGasFees, suggestedGasFees, request)) {
+        log('Ignoring saved custom gas fees below low estimate', savedGasFees?.maxBaseFee, suggestedGasFees.low?.maxFeePerGas);
+        savedGasFees = undefined;
+    }
     const getGasFeeRequest = {
         ...request,
         initialParams,
@@ -77,6 +82,76 @@ export function gweiDecimalToWeiDecimal(gweiDecimal) {
     const weiValue = Number(gweiDecimal) * 1e9;
     return weiValue.toString().split('.')[0];
 }
+/**
+ * Determine whether saved (advanced) gas fee preferences should be ignored in
+ * favour of the suggested gas fees, as the saved custom `maxBaseFee` is below
+ * the current low estimate and hence unlikely to result in timely inclusion in
+ * a block. Level-based saved preferences track current estimates and are never
+ * ignored.
+ *
+ * @param savedGasFees - The saved gas fee preferences.
+ * @param suggestedGasFees - The suggested gas fees.
+ * @param request - The request object.
+ * @returns Whether the saved gas fee preferences should be ignored.
+ */
+function shouldIgnoreUnderpricedSavedGasFees(savedGasFees, suggestedGasFees, request) {
+    const { eip1559, messenger, txMeta } = request;
+    if (!eip1559 ||
+        !savedGasFees?.maxBaseFee ||
+        !getReplaceUnderpricedSavedGasFeesEnabled(txMeta.chainId, messenger)) {
+        return false;
+    }
+    const lowMaxFeePerGas = suggestedGasFees.low?.maxFeePerGas;
+    const hasReplacement = Boolean(suggestedGasFees.maxFeePerGas) &&
+        Boolean(suggestedGasFees.maxPriorityFeePerGas);
+    if (!lowMaxFeePerGas || !hasReplacement) {
+        return false;
+    }
+    return isFeeBelowLowEstimate(gweiDecimalToWeiHex(savedGasFees.maxBaseFee), lowMaxFeePerGas);
+}
+/**
+ * Determine whether a fee value is below the low estimate.
+ *
+ * @param valueHex - The fee value as a hex string.
+ * @param lowMaxFeePerGasHex - The low estimate `maxFeePerGas` as a hex string.
+ * @returns Whether the fee value is below the low estimate.
+ */
+function isFeeBelowLowEstimate(valueHex, lowMaxFeePerGasHex) {
+    try {
+        return BigInt(valueHex) < BigInt(lowMaxFeePerGasHex);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Determine whether dapp-suggested gas fees should be ignored in favour of the
+ * suggested gas fees, as the dapp-suggested `maxFeePerGas` is below the current
+ * low estimate and hence unlikely to result in timely inclusion in a block.
+ *
+ * @param request - The request object.
+ * @returns Whether the dapp-suggested gas fees should be ignored.
+ */
+function shouldIgnoreDappGasFees(request) {
+    const { eip1559, initialParams, messenger, savedGasFees, suggestedGasFees, txMeta, } = request;
+    if (!eip1559 ||
+        savedGasFees ||
+        txMeta.isInternal ||
+        !getReplaceUnderpricedDappGasFeesEnabled(txMeta.chainId, messenger)) {
+        return false;
+    }
+    const dappMaxFeePerGas = initialParams.maxFeePerGas ??
+        (initialParams.gasPrice && !initialParams.maxPriorityFeePerGas
+            ? initialParams.gasPrice
+            : undefined);
+    const lowMaxFeePerGas = suggestedGasFees.low?.maxFeePerGas;
+    const hasReplacement = Boolean(suggestedGasFees.maxFeePerGas) &&
+        Boolean(suggestedGasFees.maxPriorityFeePerGas);
+    if (!dappMaxFeePerGas || !lowMaxFeePerGas || !hasReplacement) {
+        return false;
+    }
+    return isFeeBelowLowEstimate(dappMaxFeePerGas, lowMaxFeePerGas);
+}
 /**
  * Determine the maxFeePerGas value for the transaction.
  *
@@ -93,14 +168,20 @@ function getMaxFeePerGas(request) {
         log('Using maxFeePerGas from savedGasFees', maxFeePerGas);
         return maxFeePerGas;
     }
-    if (initialParams.maxFeePerGas) {
+    const ignoreDappGasFees = shouldIgnoreDappGasFees(request);
+    if (initialParams.maxFeePerGas && !ignoreDappGasFees) {
         log('Using maxFeePerGas from request', initialParams.maxFeePerGas);
         return initialParams.maxFeePerGas;
     }
-    if (initialParams.gasPrice && !initialParams.maxPriorityFeePerGas) {
+    if (initialParams.gasPrice &&
+        !initialParams.maxPriorityFeePerGas &&
+        !ignoreDappGasFees) {
         log('Setting maxFeePerGas to gasPrice from request', initialParams.gasPrice);
         return initialParams.gasPrice;
     }
+    if (ignoreDappGasFees) {
+        log('Ignoring dapp-suggested maxFeePerGas below low estimate', initialParams.maxFeePerGas ?? initialParams.gasPrice, suggestedGasFees.low?.maxFeePerGas);
+    }
     if (suggestedGasFees.maxFeePerGas) {
         log('Using suggested maxFeePerGas', suggestedGasFees.maxFeePerGas);
         return suggestedGasFees.maxFeePerGas;
@@ -128,11 +209,14 @@ function getMaxPriorityFeePerGas(request) {
         log('Using maxPriorityFeePerGas from savedGasFees.priorityFee', maxPriorityFeePerGas);
         return maxPriorityFeePerGas;
     }
-    if (initialParams.maxPriorityFeePerGas) {
+    const ignoreDappGasFees = shouldIgnoreDappGasFees(request);
+    if (initialParams.maxPriorityFeePerGas && !ignoreDappGasFees) {
         log('Using maxPriorityFeePerGas from request', initialParams.maxPriorityFeePerGas);
         return initialParams.maxPriorityFeePerGas;
     }
-    if (initialParams.gasPrice && !initialParams.maxFeePerGas) {
+    if (initialParams.gasPrice &&
+        !initialParams.maxFeePerGas &&
+        !ignoreDappGasFees) {
         log('Setting maxPriorityFeePerGas to gasPrice from request', initialParams.gasPrice);
         return initialParams.gasPrice;
     }
@@ -200,6 +284,12 @@ function getUserFeeLevel(request) {
         // overwrite the override or misrepresent the fee as matching the level.
         return canUseSavedLevel ? savedGasFees.level : UserFeeLevel.CUSTOM;
     }
+    // Underpriced dapp-suggested fees are replaced with the suggested medium
+    // values, so also use the medium fee level to keep the values updated while
+    // the transaction is unapproved.
+    if (shouldIgnoreDappGasFees(request)) {
+        return UserFeeLevel.MEDIUM;
+    }
     if (!initialParams.maxFeePerGas &&
         !initialParams.maxPriorityFeePerGas &&
         initialParams.gasPrice) {
@@ -245,10 +335,16 @@ function updateDefaultGasEstimates(txMeta) {
 async function getSuggestedGasFees(request) {
     const { eip1559, gasFeeFlows, getGasFeeEstimates, messenger, savedGasFees, txMeta, } = request;
     const { networkClientId } = txMeta;
+    const hasCompleteDappFees = eip1559 &&
+        Boolean(txMeta.txParams.maxFeePerGas) &&
+        Boolean(txMeta.txParams.maxPriorityFeePerGas);
+    // Estimates are still required for transactions with complete dapp-suggested
+    // fees if they may be replaced due to being underpriced.
+    const isEstimateRequiredForDappFees = hasCompleteDappFees &&
+        !txMeta.isInternal &&
+        getReplaceUnderpricedDappGasFeesEnabled(txMeta.chainId, messenger);
     if ((!eip1559 && txMeta.txParams.gasPrice) ||
-        (eip1559 &&
-            txMeta.txParams.maxFeePerGas &&
-            txMeta.txParams.maxPriorityFeePerGas)) {
+        (hasCompleteDappFees && !isEstimateRequiredForDappFees)) {
         return {};
     }
     const gasFeeFlow = getGasFeeFlow(txMeta, gasFeeFlows, messenger);
@@ -267,6 +363,7 @@ async function getSuggestedGasFees(request) {
                     ...(response.estimates[savedGasFeeEstimateLevel] ??
                         response.estimates.medium),
                     isEstimateLevelApplied: true,
+                    low: response.estimates.low,
                 };
             case GasFeeEstimateType.Legacy:
                 return {
@@ -289,6 +386,12 @@ async function getSuggestedGasFees(request) {
     catch (error) {
         log('Failed to get suggested gas fees', error);
     }
+    // Estimates on this path are only needed to check complete dapp-suggested
+    // fees, so no fallback is required and any failure must not block
+    // transaction creation.
+    if (hasCompleteDappFees) {
+        return {};
+    }
     const gasPriceHex = (await rpcRequest({
         messenger,
         networkClientId,

package/dist/utils/gas-fees.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"gas-fees.mjs","sourceRoot":"","sources":["../../src/utils/gas-fees.ts"],"names":[],"mappings":"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","sourcesContent":["import { gweiDecToWEIBN, toHex } from '@metamask/controller-utils';\nimport type {\n  FetchGasFeeEstimateOptions,\n  GasFeeState,\n} from '@metamask/gas-fee-controller';\nimport type { Hex } from '@metamask/utils';\nimport { add0x, createModuleLogger } from '@metamask/utils';\n\nimport { projectLogger } from '../logger.js';\nimport type { TransactionControllerMessenger } from '../TransactionController.js';\nimport type {\n  SavedGasFees,\n  TransactionParams,\n  TransactionMeta,\n  GasFeeFlow,\n} from '../types.js';\nimport {\n  GasFeeEstimateLevel,\n  GasFeeEstimateType,\n  TransactionType,\n  UserFeeLevel,\n} from '../types.js';\nimport { getGasFeeFlow } from './gas-flow.js';\nimport { rpcRequest } from './provider.js';\nimport { SWAP_TRANSACTION_TYPES } from './swaps.js';\n\nexport type UpdateGasFeesRequest = {\n  eip1559: boolean;\n  gasFeeFlows: GasFeeFlow[];\n  getGasFeeEstimates: (\n    options: FetchGasFeeEstimateOptions,\n  ) => Promise<GasFeeState>;\n  getSavedGasFees: (\n    transactionMeta: TransactionMeta,\n  ) => SavedGasFees | undefined;\n  messenger: TransactionControllerMessenger;\n  txMeta: TransactionMeta;\n};\n\nexport type GetGasFeeRequest = UpdateGasFeesRequest & {\n  initialParams: TransactionParams;\n  savedGasFees?: SavedGasFees;\n  suggestedGasFees: SuggestedGasFees;\n};\n\ntype SuggestedGasFees = {\n  maxFeePerGas?: string;\n  maxPriorityFeePerGas?: string;\n  gasPrice?: string;\n\n  /**\n   * Whether the suggested fee was derived from a specific estimate level,\n   * such as `low`/`medium`/`high`. This is `false` for estimate types that\n   * do not support per-level pricing, such as a flat `eth_gasPrice` value,\n   * or when the gas fee flow failed and a raw RPC fallback was used.\n   */\n  isEstimateLevelApplied?: boolean;\n};\n\nconst log = createModuleLogger(projectLogger, 'gas-fees');\n\nconst SAVED_GAS_FEES_IGNORED_TRANSACTION_TYPES = [\n  ...SWAP_TRANSACTION_TYPES,\n  TransactionType.bridge,\n  TransactionType.bridgeApproval,\n];\n\n/**\n * Update the gas fee properties of the provided transaction meta.\n *\n * @param request - The request object.\n */\nexport async function updateGasFees(\n  request: UpdateGasFeesRequest,\n): Promise<void> {\n  const { txMeta } = request;\n  const initialParams = { ...txMeta.txParams };\n\n  const shouldIgnoreSavedGasFees =\n    SAVED_GAS_FEES_IGNORED_TRANSACTION_TYPES.includes(\n      txMeta.type as TransactionType,\n    );\n\n  const savedGasFees =\n    shouldIgnoreSavedGasFees || hasInitialGasFeeParams(initialParams)\n      ? undefined\n      : request.getSavedGasFees(txMeta);\n\n  const suggestedGasFees = await getSuggestedGasFees({\n    ...request,\n    savedGasFees,\n  });\n\n  log('Suggested gas fees', suggestedGasFees);\n\n  const getGasFeeRequest: GetGasFeeRequest = {\n    ...request,\n    initialParams,\n    savedGasFees,\n    suggestedGasFees,\n  };\n\n  txMeta.txParams.maxFeePerGas = getMaxFeePerGas(getGasFeeRequest);\n\n  txMeta.txParams.maxPriorityFeePerGas =\n    getMaxPriorityFeePerGas(getGasFeeRequest);\n\n  txMeta.txParams.gasPrice = getGasPrice(getGasFeeRequest);\n  txMeta.userFeeLevel = getUserFeeLevel(getGasFeeRequest);\n\n  log('Updated gas fee properties', {\n    maxFeePerGas: txMeta.txParams.maxFeePerGas,\n    maxPriorityFeePerGas: txMeta.txParams.maxPriorityFeePerGas,\n    gasPrice: txMeta.txParams.gasPrice,\n  });\n\n  if (txMeta.txParams.maxFeePerGas || txMeta.txParams.maxPriorityFeePerGas) {\n    delete txMeta.txParams.gasPrice;\n  }\n\n  if (txMeta.txParams.gasPrice) {\n    delete txMeta.txParams.maxFeePerGas;\n    delete txMeta.txParams.maxPriorityFeePerGas;\n  }\n\n  updateDefaultGasEstimates(txMeta);\n}\n\n/**\n * Convert GWEI from decimal string to WEI as hex string.\n *\n * @param value - The GWEI value as a decimal string.\n * @returns The WEI value in hex.\n */\nexport function gweiDecimalToWeiHex(value: string): Hex {\n  return toHex(gweiDecToWEIBN(value));\n}\n\n/**\n * Converts a value from Gwei decimal representation to Wei decimal representation\n *\n * @param gweiDecimal - The value in Gwei as a string or number\n * @returns The value in Wei as a string\n *\n * @example\n * // Convert 1.5 Gwei to Wei\n * gweiDecimalToWeiDecimal(\"1.5\")\n * // Returns \"1500000000\"\n */\nexport function gweiDecimalToWeiDecimal(gweiDecimal: string | number): string {\n  const weiValue = Number(gweiDecimal) * 1e9;\n\n  return weiValue.toString().split('.')[0];\n}\n\n/**\n * Determine the maxFeePerGas value for the transaction.\n *\n * @param request - The request object.\n * @returns The maxFeePerGas value.\n */\nfunction getMaxFeePerGas(request: GetGasFeeRequest): string | undefined {\n  const { savedGasFees, eip1559, initialParams, suggestedGasFees } = request;\n\n  if (!eip1559) {\n    return undefined;\n  }\n\n  if (savedGasFees?.maxBaseFee) {\n    const maxFeePerGas = gweiDecimalToWeiHex(savedGasFees.maxBaseFee);\n    log('Using maxFeePerGas from savedGasFees', maxFeePerGas);\n    return maxFeePerGas;\n  }\n\n  if (initialParams.maxFeePerGas) {\n    log('Using maxFeePerGas from request', initialParams.maxFeePerGas);\n    return initialParams.maxFeePerGas;\n  }\n\n  if (initialParams.gasPrice && !initialParams.maxPriorityFeePerGas) {\n    log(\n      'Setting maxFeePerGas to gasPrice from request',\n      initialParams.gasPrice,\n    );\n    return initialParams.gasPrice;\n  }\n\n  if (suggestedGasFees.maxFeePerGas) {\n    log('Using suggested maxFeePerGas', suggestedGasFees.maxFeePerGas);\n    return suggestedGasFees.maxFeePerGas;\n  }\n\n  if (suggestedGasFees.gasPrice) {\n    log(\n      'Setting maxFeePerGas to suggested gasPrice',\n      suggestedGasFees.gasPrice,\n    );\n    return suggestedGasFees.gasPrice;\n  }\n\n  log('maxFeePerGas not set');\n  return undefined;\n}\n\n/**\n * Determine the maxPriorityFeePerGas value for the transaction.\n *\n * @param request - The request object.\n * @returns The maxPriorityFeePerGas value.\n */\nfunction getMaxPriorityFeePerGas(\n  request: GetGasFeeRequest,\n): string | undefined {\n  const { eip1559, initialParams, savedGasFees, suggestedGasFees, txMeta } =\n    request;\n\n  if (!eip1559) {\n    return undefined;\n  }\n\n  if (savedGasFees?.priorityFee) {\n    const maxPriorityFeePerGas = gweiDecimalToWeiHex(savedGasFees.priorityFee);\n    log(\n      'Using maxPriorityFeePerGas from savedGasFees.priorityFee',\n      maxPriorityFeePerGas,\n    );\n    return maxPriorityFeePerGas;\n  }\n\n  if (initialParams.maxPriorityFeePerGas) {\n    log(\n      'Using maxPriorityFeePerGas from request',\n      initialParams.maxPriorityFeePerGas,\n    );\n    return initialParams.maxPriorityFeePerGas;\n  }\n\n  if (initialParams.gasPrice && !initialParams.maxFeePerGas) {\n    log(\n      'Setting maxPriorityFeePerGas to gasPrice from request',\n      initialParams.gasPrice,\n    );\n    return initialParams.gasPrice;\n  }\n\n  if (suggestedGasFees.maxPriorityFeePerGas) {\n    log(\n      'Using suggested maxPriorityFeePerGas',\n      suggestedGasFees.maxPriorityFeePerGas,\n    );\n    return suggestedGasFees.maxPriorityFeePerGas;\n  }\n\n  if (txMeta.txParams.maxFeePerGas) {\n    log(\n      'Setting maxPriorityFeePerGas to maxFeePerGas',\n      txMeta.txParams.maxFeePerGas,\n    );\n    return txMeta.txParams.maxFeePerGas;\n  }\n\n  log('maxPriorityFeePerGas not set');\n  return undefined;\n}\n\n/**\n * Determine the gasPrice value for the transaction.\n *\n * @param request - The request object.\n * @returns The gasPrice value.\n */\nfunction getGasPrice(request: GetGasFeeRequest): string | undefined {\n  const { eip1559, initialParams, savedGasFees, suggestedGasFees } = request;\n\n  if (eip1559) {\n    return undefined;\n  }\n\n  if (savedGasFees?.gasPrice) {\n    const gasPrice = gweiDecimalToWeiHex(savedGasFees.gasPrice);\n    log('Using gasPrice from savedGasFees.gasPrice', gasPrice);\n    return gasPrice;\n  }\n\n  if (initialParams.gasPrice) {\n    log('Using gasPrice from request', initialParams.gasPrice);\n    return initialParams.gasPrice;\n  }\n\n  if (suggestedGasFees.maxFeePerGas) {\n    log('Using suggested maxFeePerGas', suggestedGasFees.maxFeePerGas);\n    return suggestedGasFees.maxFeePerGas;\n  }\n\n  if (suggestedGasFees.gasPrice) {\n    log('Using suggested gasPrice', suggestedGasFees.gasPrice);\n    return suggestedGasFees.gasPrice;\n  }\n\n  log('gasPrice not set');\n  return undefined;\n}\n\n/**\n * Determine the user fee level.\n *\n * @param request - The request object.\n * @returns The user fee level.\n */\nfunction getUserFeeLevel(request: GetGasFeeRequest): string | undefined {\n  const { initialParams, savedGasFees, suggestedGasFees, txMeta } = request;\n\n  if (savedGasFees) {\n    const hasCustomOverride =\n      savedGasFees.maxBaseFee !== undefined ||\n      savedGasFees.priorityFee !== undefined ||\n      savedGasFees.gasPrice !== undefined;\n\n    const canUseSavedLevel =\n      !hasCustomOverride &&\n      savedGasFees.level !== undefined &&\n      suggestedGasFees.isEstimateLevelApplied;\n\n    // A custom override on any field, or an estimate type that does not\n    // support per-level pricing (e.g. a flat eth_gasPrice value), means the\n    // fee is no longer purely level-derived, so it must not be tracked as a\n    // live estimate level by the gas fee poller, which would otherwise\n    // overwrite the override or misrepresent the fee as matching the level.\n    return canUseSavedLevel ? savedGasFees.level : UserFeeLevel.CUSTOM;\n  }\n\n  if (\n    !initialParams.maxFeePerGas &&\n    !initialParams.maxPriorityFeePerGas &&\n    initialParams.gasPrice\n  ) {\n    return txMeta.isInternal\n      ? UserFeeLevel.CUSTOM\n      : UserFeeLevel.DAPP_SUGGESTED;\n  }\n\n  if (\n    !initialParams.maxFeePerGas &&\n    !initialParams.maxPriorityFeePerGas &&\n    suggestedGasFees.maxFeePerGas &&\n    suggestedGasFees.maxPriorityFeePerGas\n  ) {\n    return UserFeeLevel.MEDIUM;\n  }\n\n  if (\n    !initialParams.maxFeePerGas &&\n    !initialParams.maxPriorityFeePerGas &&\n    suggestedGasFees.gasPrice\n  ) {\n    return UserFeeLevel.MEDIUM;\n  }\n\n  if (txMeta.isInternal) {\n    return UserFeeLevel.MEDIUM;\n  }\n\n  return UserFeeLevel.DAPP_SUGGESTED;\n}\n\n/**\n * Update the default gas estimates for the provided transaction.\n *\n * @param txMeta - The transaction metadata.\n */\nfunction updateDefaultGasEstimates(txMeta: TransactionMeta): void {\n  txMeta.defaultGasEstimates ??= {};\n  txMeta.defaultGasEstimates.maxFeePerGas = txMeta.txParams.maxFeePerGas;\n\n  txMeta.defaultGasEstimates.maxPriorityFeePerGas =\n    txMeta.txParams.maxPriorityFeePerGas;\n\n  txMeta.defaultGasEstimates.gasPrice = txMeta.txParams.gasPrice;\n  txMeta.defaultGasEstimates.estimateType = txMeta.userFeeLevel;\n}\n\n/**\n * Retrieve the suggested gas fees using the gas fee flows.\n *\n * @param request - The request object.\n * @returns The suggested gas fees.\n */\nasync function getSuggestedGasFees(\n  request: UpdateGasFeesRequest & { savedGasFees?: SavedGasFees },\n): Promise<SuggestedGasFees> {\n  const {\n    eip1559,\n    gasFeeFlows,\n    getGasFeeEstimates,\n    messenger,\n    savedGasFees,\n    txMeta,\n  } = request;\n  const { networkClientId } = txMeta;\n\n  if (\n    (!eip1559 && txMeta.txParams.gasPrice) ||\n    (eip1559 &&\n      txMeta.txParams.maxFeePerGas &&\n      txMeta.txParams.maxPriorityFeePerGas)\n  ) {\n    return {};\n  }\n\n  const gasFeeFlow = getGasFeeFlow(\n    txMeta,\n    gasFeeFlows,\n    messenger,\n  ) as GasFeeFlow;\n\n  try {\n    const gasFeeControllerData = await getGasFeeEstimates({ networkClientId });\n\n    const response = await gasFeeFlow.getGasFees({\n      gasFeeControllerData,\n      messenger,\n      transactionMeta: txMeta,\n    });\n\n    const gasFeeEstimateType = response.estimates?.type;\n    const savedGasFeeEstimateLevel = getSavedGasFeeEstimateLevel(savedGasFees);\n\n    switch (gasFeeEstimateType) {\n      case GasFeeEstimateType.FeeMarket:\n        return {\n          ...(response.estimates[savedGasFeeEstimateLevel] ??\n            response.estimates.medium),\n          isEstimateLevelApplied: true,\n        };\n      case GasFeeEstimateType.Legacy:\n        return {\n          gasPrice:\n            response.estimates[savedGasFeeEstimateLevel] ??\n            response.estimates.medium,\n          isEstimateLevelApplied: true,\n        };\n      case GasFeeEstimateType.GasPrice:\n        return {\n          gasPrice: response.estimates.gasPrice,\n          isEstimateLevelApplied: false,\n        };\n      default:\n        throw new Error(\n          // TODO: Either fix this lint violation or explain why it's necessary to ignore.\n          // eslint-disable-next-line @typescript-eslint/restrict-template-expressions\n          `Unsupported gas fee estimate type returned from flow: ${gasFeeEstimateType}`,\n        );\n    }\n  } catch (error) {\n    log('Failed to get suggested gas fees', error);\n  }\n\n  const gasPriceHex = (await rpcRequest({\n    messenger,\n    networkClientId,\n    method: 'eth_gasPrice',\n  })) as Hex | undefined;\n\n  const gasPrice = gasPriceHex ? add0x(gasPriceHex) : undefined;\n\n  return { gasPrice };\n}\n\nfunction hasInitialGasFeeParams(initialParams: TransactionParams): boolean {\n  return [\n    initialParams.maxFeePerGas,\n    initialParams.maxPriorityFeePerGas,\n    initialParams.gasPrice,\n  ].some(Boolean);\n}\n\nfunction getSavedGasFeeEstimateLevel(\n  savedGasFees: SavedGasFees | undefined,\n): GasFeeEstimateLevel {\n  return isGasFeeEstimateLevel(savedGasFees?.level)\n    ? savedGasFees.level\n    : GasFeeEstimateLevel.Medium;\n}\n\nfunction isGasFeeEstimateLevel(level: unknown): level is GasFeeEstimateLevel {\n  return Object.values(GasFeeEstimateLevel).includes(\n    level as GasFeeEstimateLevel,\n  );\n}\n"]}
+{"version":3,"file":"gas-fees.mjs","sourceRoot":"","sources":["../../src/utils/gas-fees.ts"],"names":[],"mappings":"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","sourcesContent":["import { gweiDecToWEIBN, toHex } from '@metamask/controller-utils';\nimport type {\n  FetchGasFeeEstimateOptions,\n  GasFeeState,\n} from '@metamask/gas-fee-controller';\nimport type { Hex } from '@metamask/utils';\nimport { add0x, createModuleLogger } from '@metamask/utils';\n\nimport { projectLogger } from '../logger.js';\nimport type { TransactionControllerMessenger } from '../TransactionController.js';\nimport type {\n  FeeMarketGasFeeEstimateForLevel,\n  SavedGasFees,\n  TransactionParams,\n  TransactionMeta,\n  GasFeeFlow,\n} from '../types.js';\nimport {\n  GasFeeEstimateLevel,\n  GasFeeEstimateType,\n  TransactionType,\n  UserFeeLevel,\n} from '../types.js';\nimport {\n  getReplaceUnderpricedDappGasFeesEnabled,\n  getReplaceUnderpricedSavedGasFeesEnabled,\n} from './feature-flags.js';\nimport { getGasFeeFlow } from './gas-flow.js';\nimport { rpcRequest } from './provider.js';\nimport { SWAP_TRANSACTION_TYPES } from './swaps.js';\n\nexport type UpdateGasFeesRequest = {\n  eip1559: boolean;\n  gasFeeFlows: GasFeeFlow[];\n  getGasFeeEstimates: (\n    options: FetchGasFeeEstimateOptions,\n  ) => Promise<GasFeeState>;\n  getSavedGasFees: (\n    transactionMeta: TransactionMeta,\n  ) => SavedGasFees | undefined;\n  messenger: TransactionControllerMessenger;\n  txMeta: TransactionMeta;\n};\n\nexport type GetGasFeeRequest = UpdateGasFeesRequest & {\n  initialParams: TransactionParams;\n  savedGasFees?: SavedGasFees;\n  suggestedGasFees: SuggestedGasFees;\n};\n\ntype SuggestedGasFees = {\n  maxFeePerGas?: string;\n  maxPriorityFeePerGas?: string;\n  gasPrice?: string;\n\n  /**\n   * Whether the suggested fee was derived from a specific estimate level,\n   * such as `low`/`medium`/`high`. This is `false` for estimate types that\n   * do not support per-level pricing, such as a flat `eth_gasPrice` value,\n   * or when the gas fee flow failed and a raw RPC fallback was used.\n   */\n  isEstimateLevelApplied?: boolean;\n\n  low?: FeeMarketGasFeeEstimateForLevel;\n};\n\nconst log = createModuleLogger(projectLogger, 'gas-fees');\n\nconst SAVED_GAS_FEES_IGNORED_TRANSACTION_TYPES = [\n  ...SWAP_TRANSACTION_TYPES,\n  TransactionType.bridge,\n  TransactionType.bridgeApproval,\n];\n\n/**\n * Update the gas fee properties of the provided transaction meta.\n *\n * @param request - The request object.\n */\nexport async function updateGasFees(\n  request: UpdateGasFeesRequest,\n): Promise<void> {\n  const { txMeta } = request;\n  const initialParams = { ...txMeta.txParams };\n\n  const shouldIgnoreSavedGasFees =\n    SAVED_GAS_FEES_IGNORED_TRANSACTION_TYPES.includes(\n      txMeta.type as TransactionType,\n    );\n\n  let savedGasFees =\n    shouldIgnoreSavedGasFees || hasInitialGasFeeParams(initialParams)\n      ? undefined\n      : request.getSavedGasFees(txMeta);\n\n  const suggestedGasFees = await getSuggestedGasFees({\n    ...request,\n    savedGasFees,\n  });\n\n  log('Suggested gas fees', suggestedGasFees);\n\n  if (\n    shouldIgnoreUnderpricedSavedGasFees(savedGasFees, suggestedGasFees, request)\n  ) {\n    log(\n      'Ignoring saved custom gas fees below low estimate',\n      savedGasFees?.maxBaseFee,\n      suggestedGasFees.low?.maxFeePerGas,\n    );\n    savedGasFees = undefined;\n  }\n\n  const getGasFeeRequest: GetGasFeeRequest = {\n    ...request,\n    initialParams,\n    savedGasFees,\n    suggestedGasFees,\n  };\n\n  txMeta.txParams.maxFeePerGas = getMaxFeePerGas(getGasFeeRequest);\n\n  txMeta.txParams.maxPriorityFeePerGas =\n    getMaxPriorityFeePerGas(getGasFeeRequest);\n\n  txMeta.txParams.gasPrice = getGasPrice(getGasFeeRequest);\n  txMeta.userFeeLevel = getUserFeeLevel(getGasFeeRequest);\n\n  log('Updated gas fee properties', {\n    maxFeePerGas: txMeta.txParams.maxFeePerGas,\n    maxPriorityFeePerGas: txMeta.txParams.maxPriorityFeePerGas,\n    gasPrice: txMeta.txParams.gasPrice,\n  });\n\n  if (txMeta.txParams.maxFeePerGas || txMeta.txParams.maxPriorityFeePerGas) {\n    delete txMeta.txParams.gasPrice;\n  }\n\n  if (txMeta.txParams.gasPrice) {\n    delete txMeta.txParams.maxFeePerGas;\n    delete txMeta.txParams.maxPriorityFeePerGas;\n  }\n\n  updateDefaultGasEstimates(txMeta);\n}\n\n/**\n * Convert GWEI from decimal string to WEI as hex string.\n *\n * @param value - The GWEI value as a decimal string.\n * @returns The WEI value in hex.\n */\nexport function gweiDecimalToWeiHex(value: string): Hex {\n  return toHex(gweiDecToWEIBN(value));\n}\n\n/**\n * Converts a value from Gwei decimal representation to Wei decimal representation\n *\n * @param gweiDecimal - The value in Gwei as a string or number\n * @returns The value in Wei as a string\n *\n * @example\n * // Convert 1.5 Gwei to Wei\n * gweiDecimalToWeiDecimal(\"1.5\")\n * // Returns \"1500000000\"\n */\nexport function gweiDecimalToWeiDecimal(gweiDecimal: string | number): string {\n  const weiValue = Number(gweiDecimal) * 1e9;\n\n  return weiValue.toString().split('.')[0];\n}\n\n/**\n * Determine whether saved (advanced) gas fee preferences should be ignored in\n * favour of the suggested gas fees, as the saved custom `maxBaseFee` is below\n * the current low estimate and hence unlikely to result in timely inclusion in\n * a block. Level-based saved preferences track current estimates and are never\n * ignored.\n *\n * @param savedGasFees - The saved gas fee preferences.\n * @param suggestedGasFees - The suggested gas fees.\n * @param request - The request object.\n * @returns Whether the saved gas fee preferences should be ignored.\n */\nfunction shouldIgnoreUnderpricedSavedGasFees(\n  savedGasFees: SavedGasFees | undefined,\n  suggestedGasFees: SuggestedGasFees,\n  request: UpdateGasFeesRequest,\n): boolean {\n  const { eip1559, messenger, txMeta } = request;\n\n  if (\n    !eip1559 ||\n    !savedGasFees?.maxBaseFee ||\n    !getReplaceUnderpricedSavedGasFeesEnabled(txMeta.chainId, messenger)\n  ) {\n    return false;\n  }\n\n  const lowMaxFeePerGas = suggestedGasFees.low?.maxFeePerGas;\n\n  const hasReplacement =\n    Boolean(suggestedGasFees.maxFeePerGas) &&\n    Boolean(suggestedGasFees.maxPriorityFeePerGas);\n\n  if (!lowMaxFeePerGas || !hasReplacement) {\n    return false;\n  }\n\n  return isFeeBelowLowEstimate(\n    gweiDecimalToWeiHex(savedGasFees.maxBaseFee),\n    lowMaxFeePerGas,\n  );\n}\n\n/**\n * Determine whether a fee value is below the low estimate.\n *\n * @param valueHex - The fee value as a hex string.\n * @param lowMaxFeePerGasHex - The low estimate `maxFeePerGas` as a hex string.\n * @returns Whether the fee value is below the low estimate.\n */\nfunction isFeeBelowLowEstimate(\n  valueHex: string,\n  lowMaxFeePerGasHex: string,\n): boolean {\n  try {\n    return BigInt(valueHex) < BigInt(lowMaxFeePerGasHex);\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Determine whether dapp-suggested gas fees should be ignored in favour of the\n * suggested gas fees, as the dapp-suggested `maxFeePerGas` is below the current\n * low estimate and hence unlikely to result in timely inclusion in a block.\n *\n * @param request - The request object.\n * @returns Whether the dapp-suggested gas fees should be ignored.\n */\nfunction shouldIgnoreDappGasFees(request: GetGasFeeRequest): boolean {\n  const {\n    eip1559,\n    initialParams,\n    messenger,\n    savedGasFees,\n    suggestedGasFees,\n    txMeta,\n  } = request;\n\n  if (\n    !eip1559 ||\n    savedGasFees ||\n    txMeta.isInternal ||\n    !getReplaceUnderpricedDappGasFeesEnabled(txMeta.chainId, messenger)\n  ) {\n    return false;\n  }\n\n  const dappMaxFeePerGas =\n    initialParams.maxFeePerGas ??\n    (initialParams.gasPrice && !initialParams.maxPriorityFeePerGas\n      ? initialParams.gasPrice\n      : undefined);\n\n  const lowMaxFeePerGas = suggestedGasFees.low?.maxFeePerGas;\n\n  const hasReplacement =\n    Boolean(suggestedGasFees.maxFeePerGas) &&\n    Boolean(suggestedGasFees.maxPriorityFeePerGas);\n\n  if (!dappMaxFeePerGas || !lowMaxFeePerGas || !hasReplacement) {\n    return false;\n  }\n\n  return isFeeBelowLowEstimate(dappMaxFeePerGas, lowMaxFeePerGas);\n}\n\n/**\n * Determine the maxFeePerGas value for the transaction.\n *\n * @param request - The request object.\n * @returns The maxFeePerGas value.\n */\nfunction getMaxFeePerGas(request: GetGasFeeRequest): string | undefined {\n  const { savedGasFees, eip1559, initialParams, suggestedGasFees } = request;\n\n  if (!eip1559) {\n    return undefined;\n  }\n\n  if (savedGasFees?.maxBaseFee) {\n    const maxFeePerGas = gweiDecimalToWeiHex(savedGasFees.maxBaseFee);\n    log('Using maxFeePerGas from savedGasFees', maxFeePerGas);\n    return maxFeePerGas;\n  }\n\n  const ignoreDappGasFees = shouldIgnoreDappGasFees(request);\n\n  if (initialParams.maxFeePerGas && !ignoreDappGasFees) {\n    log('Using maxFeePerGas from request', initialParams.maxFeePerGas);\n    return initialParams.maxFeePerGas;\n  }\n\n  if (\n    initialParams.gasPrice &&\n    !initialParams.maxPriorityFeePerGas &&\n    !ignoreDappGasFees\n  ) {\n    log(\n      'Setting maxFeePerGas to gasPrice from request',\n      initialParams.gasPrice,\n    );\n    return initialParams.gasPrice;\n  }\n\n  if (ignoreDappGasFees) {\n    log(\n      'Ignoring dapp-suggested maxFeePerGas below low estimate',\n      initialParams.maxFeePerGas ?? initialParams.gasPrice,\n      suggestedGasFees.low?.maxFeePerGas,\n    );\n  }\n\n  if (suggestedGasFees.maxFeePerGas) {\n    log('Using suggested maxFeePerGas', suggestedGasFees.maxFeePerGas);\n    return suggestedGasFees.maxFeePerGas;\n  }\n\n  if (suggestedGasFees.gasPrice) {\n    log(\n      'Setting maxFeePerGas to suggested gasPrice',\n      suggestedGasFees.gasPrice,\n    );\n    return suggestedGasFees.gasPrice;\n  }\n\n  log('maxFeePerGas not set');\n  return undefined;\n}\n\n/**\n * Determine the maxPriorityFeePerGas value for the transaction.\n *\n * @param request - The request object.\n * @returns The maxPriorityFeePerGas value.\n */\nfunction getMaxPriorityFeePerGas(\n  request: GetGasFeeRequest,\n): string | undefined {\n  const { eip1559, initialParams, savedGasFees, suggestedGasFees, txMeta } =\n    request;\n\n  if (!eip1559) {\n    return undefined;\n  }\n\n  if (savedGasFees?.priorityFee) {\n    const maxPriorityFeePerGas = gweiDecimalToWeiHex(savedGasFees.priorityFee);\n    log(\n      'Using maxPriorityFeePerGas from savedGasFees.priorityFee',\n      maxPriorityFeePerGas,\n    );\n    return maxPriorityFeePerGas;\n  }\n\n  const ignoreDappGasFees = shouldIgnoreDappGasFees(request);\n\n  if (initialParams.maxPriorityFeePerGas && !ignoreDappGasFees) {\n    log(\n      'Using maxPriorityFeePerGas from request',\n      initialParams.maxPriorityFeePerGas,\n    );\n    return initialParams.maxPriorityFeePerGas;\n  }\n\n  if (\n    initialParams.gasPrice &&\n    !initialParams.maxFeePerGas &&\n    !ignoreDappGasFees\n  ) {\n    log(\n      'Setting maxPriorityFeePerGas to gasPrice from request',\n      initialParams.gasPrice,\n    );\n    return initialParams.gasPrice;\n  }\n\n  if (suggestedGasFees.maxPriorityFeePerGas) {\n    log(\n      'Using suggested maxPriorityFeePerGas',\n      suggestedGasFees.maxPriorityFeePerGas,\n    );\n    return suggestedGasFees.maxPriorityFeePerGas;\n  }\n\n  if (txMeta.txParams.maxFeePerGas) {\n    log(\n      'Setting maxPriorityFeePerGas to maxFeePerGas',\n      txMeta.txParams.maxFeePerGas,\n    );\n    return txMeta.txParams.maxFeePerGas;\n  }\n\n  log('maxPriorityFeePerGas not set');\n  return undefined;\n}\n\n/**\n * Determine the gasPrice value for the transaction.\n *\n * @param request - The request object.\n * @returns The gasPrice value.\n */\nfunction getGasPrice(request: GetGasFeeRequest): string | undefined {\n  const { eip1559, initialParams, savedGasFees, suggestedGasFees } = request;\n\n  if (eip1559) {\n    return undefined;\n  }\n\n  if (savedGasFees?.gasPrice) {\n    const gasPrice = gweiDecimalToWeiHex(savedGasFees.gasPrice);\n    log('Using gasPrice from savedGasFees.gasPrice', gasPrice);\n    return gasPrice;\n  }\n\n  if (initialParams.gasPrice) {\n    log('Using gasPrice from request', initialParams.gasPrice);\n    return initialParams.gasPrice;\n  }\n\n  if (suggestedGasFees.maxFeePerGas) {\n    log('Using suggested maxFeePerGas', suggestedGasFees.maxFeePerGas);\n    return suggestedGasFees.maxFeePerGas;\n  }\n\n  if (suggestedGasFees.gasPrice) {\n    log('Using suggested gasPrice', suggestedGasFees.gasPrice);\n    return suggestedGasFees.gasPrice;\n  }\n\n  log('gasPrice not set');\n  return undefined;\n}\n\n/**\n * Determine the user fee level.\n *\n * @param request - The request object.\n * @returns The user fee level.\n */\nfunction getUserFeeLevel(request: GetGasFeeRequest): string | undefined {\n  const { initialParams, savedGasFees, suggestedGasFees, txMeta } = request;\n\n  if (savedGasFees) {\n    const hasCustomOverride =\n      savedGasFees.maxBaseFee !== undefined ||\n      savedGasFees.priorityFee !== undefined ||\n      savedGasFees.gasPrice !== undefined;\n\n    const canUseSavedLevel =\n      !hasCustomOverride &&\n      savedGasFees.level !== undefined &&\n      suggestedGasFees.isEstimateLevelApplied;\n\n    // A custom override on any field, or an estimate type that does not\n    // support per-level pricing (e.g. a flat eth_gasPrice value), means the\n    // fee is no longer purely level-derived, so it must not be tracked as a\n    // live estimate level by the gas fee poller, which would otherwise\n    // overwrite the override or misrepresent the fee as matching the level.\n    return canUseSavedLevel ? savedGasFees.level : UserFeeLevel.CUSTOM;\n  }\n\n  // Underpriced dapp-suggested fees are replaced with the suggested medium\n  // values, so also use the medium fee level to keep the values updated while\n  // the transaction is unapproved.\n  if (shouldIgnoreDappGasFees(request)) {\n    return UserFeeLevel.MEDIUM;\n  }\n\n  if (\n    !initialParams.maxFeePerGas &&\n    !initialParams.maxPriorityFeePerGas &&\n    initialParams.gasPrice\n  ) {\n    return txMeta.isInternal\n      ? UserFeeLevel.CUSTOM\n      : UserFeeLevel.DAPP_SUGGESTED;\n  }\n\n  if (\n    !initialParams.maxFeePerGas &&\n    !initialParams.maxPriorityFeePerGas &&\n    suggestedGasFees.maxFeePerGas &&\n    suggestedGasFees.maxPriorityFeePerGas\n  ) {\n    return UserFeeLevel.MEDIUM;\n  }\n\n  if (\n    !initialParams.maxFeePerGas &&\n    !initialParams.maxPriorityFeePerGas &&\n    suggestedGasFees.gasPrice\n  ) {\n    return UserFeeLevel.MEDIUM;\n  }\n\n  if (txMeta.isInternal) {\n    return UserFeeLevel.MEDIUM;\n  }\n\n  return UserFeeLevel.DAPP_SUGGESTED;\n}\n\n/**\n * Update the default gas estimates for the provided transaction.\n *\n * @param txMeta - The transaction metadata.\n */\nfunction updateDefaultGasEstimates(txMeta: TransactionMeta): void {\n  txMeta.defaultGasEstimates ??= {};\n  txMeta.defaultGasEstimates.maxFeePerGas = txMeta.txParams.maxFeePerGas;\n\n  txMeta.defaultGasEstimates.maxPriorityFeePerGas =\n    txMeta.txParams.maxPriorityFeePerGas;\n\n  txMeta.defaultGasEstimates.gasPrice = txMeta.txParams.gasPrice;\n  txMeta.defaultGasEstimates.estimateType = txMeta.userFeeLevel;\n}\n\n/**\n * Retrieve the suggested gas fees using the gas fee flows.\n *\n * @param request - The request object.\n * @returns The suggested gas fees.\n */\nasync function getSuggestedGasFees(\n  request: UpdateGasFeesRequest & { savedGasFees?: SavedGasFees },\n): Promise<SuggestedGasFees> {\n  const {\n    eip1559,\n    gasFeeFlows,\n    getGasFeeEstimates,\n    messenger,\n    savedGasFees,\n    txMeta,\n  } = request;\n  const { networkClientId } = txMeta;\n\n  const hasCompleteDappFees =\n    eip1559 &&\n    Boolean(txMeta.txParams.maxFeePerGas) &&\n    Boolean(txMeta.txParams.maxPriorityFeePerGas);\n\n  // Estimates are still required for transactions with complete dapp-suggested\n  // fees if they may be replaced due to being underpriced.\n  const isEstimateRequiredForDappFees =\n    hasCompleteDappFees &&\n    !txMeta.isInternal &&\n    getReplaceUnderpricedDappGasFeesEnabled(txMeta.chainId, messenger);\n\n  if (\n    (!eip1559 && txMeta.txParams.gasPrice) ||\n    (hasCompleteDappFees && !isEstimateRequiredForDappFees)\n  ) {\n    return {};\n  }\n\n  const gasFeeFlow = getGasFeeFlow(\n    txMeta,\n    gasFeeFlows,\n    messenger,\n  ) as GasFeeFlow;\n\n  try {\n    const gasFeeControllerData = await getGasFeeEstimates({ networkClientId });\n\n    const response = await gasFeeFlow.getGasFees({\n      gasFeeControllerData,\n      messenger,\n      transactionMeta: txMeta,\n    });\n\n    const gasFeeEstimateType = response.estimates?.type;\n    const savedGasFeeEstimateLevel = getSavedGasFeeEstimateLevel(savedGasFees);\n\n    switch (gasFeeEstimateType) {\n      case GasFeeEstimateType.FeeMarket:\n        return {\n          ...(response.estimates[savedGasFeeEstimateLevel] ??\n            response.estimates.medium),\n          isEstimateLevelApplied: true,\n          low: response.estimates.low,\n        };\n      case GasFeeEstimateType.Legacy:\n        return {\n          gasPrice:\n            response.estimates[savedGasFeeEstimateLevel] ??\n            response.estimates.medium,\n          isEstimateLevelApplied: true,\n        };\n      case GasFeeEstimateType.GasPrice:\n        return {\n          gasPrice: response.estimates.gasPrice,\n          isEstimateLevelApplied: false,\n        };\n      default:\n        throw new Error(\n          // TODO: Either fix this lint violation or explain why it's necessary to ignore.\n          // eslint-disable-next-line @typescript-eslint/restrict-template-expressions\n          `Unsupported gas fee estimate type returned from flow: ${gasFeeEstimateType}`,\n        );\n    }\n  } catch (error) {\n    log('Failed to get suggested gas fees', error);\n  }\n\n  // Estimates on this path are only needed to check complete dapp-suggested\n  // fees, so no fallback is required and any failure must not block\n  // transaction creation.\n  if (hasCompleteDappFees) {\n    return {};\n  }\n\n  const gasPriceHex = (await rpcRequest({\n    messenger,\n    networkClientId,\n    method: 'eth_gasPrice',\n  })) as Hex | undefined;\n\n  const gasPrice = gasPriceHex ? add0x(gasPriceHex) : undefined;\n\n  return { gasPrice };\n}\n\nfunction hasInitialGasFeeParams(initialParams: TransactionParams): boolean {\n  return [\n    initialParams.maxFeePerGas,\n    initialParams.maxPriorityFeePerGas,\n    initialParams.gasPrice,\n  ].some(Boolean);\n}\n\nfunction getSavedGasFeeEstimateLevel(\n  savedGasFees: SavedGasFees | undefined,\n): GasFeeEstimateLevel {\n  return isGasFeeEstimateLevel(savedGasFees?.level)\n    ? savedGasFees.level\n    : GasFeeEstimateLevel.Medium;\n}\n\nfunction isGasFeeEstimateLevel(level: unknown): level is GasFeeEstimateLevel {\n  return Object.values(GasFeeEstimateLevel).includes(\n    level as GasFeeEstimateLevel,\n  );\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask-previews/transaction-controller",
-  "version": "69.4.0-preview-507508c10",
+  "version": "69.4.0-preview-0efc7ef01",
   "description": "Stores transactions alongside their periodically updated statuses and manages interactions such as approval and cancellation",
   "keywords": [
     "Ethereum",