@metamask-previews/transaction-pay-controller 30.1.0-preview-0bfdd33e2 → 30.1.0-preview-082d695

package/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Add optional `isGasFeeSponsored` callback to `TransactionPayControllerOptions`, exposed as the `TransactionPayController:isGasFeeSponsored` action ([#10575](https://github.com/MetaMask/core/pull/10575))
+  - Relay and server quotes use it to zero source network fees for sponsored same-chain routes and record the decision on the quote so submission uses the same gas limits.
+
+### Changed
+
+- **BREAKING:** Pay no longer sets `isExternalSign` on the target transaction when quotes are available ([#10575](https://github.com/MetaMask/core/pull/10575))
+  - Clients should return `shouldSign: false` from the `TransactionController` `shouldSign` hook when the transaction has executable Pay quotes.
+- **BREAKING:** Relay, server, and second-leg submissions pass `forceIsGasFeeSponsored` instead of `isGasFeeSponsored`, and Relay and server quotes, including deferred second-leg opt-in, no longer read `TransactionMeta.isGasFeeSponsored` ([#10575](https://github.com/MetaMask/core/pull/10575))
+
 ## [30.1.0]
 
 ### Added

package/dist/TransactionPayController-method-action-types.d.ts

@@ -74,6 +74,19 @@ export type TransactionPayControllerGetAmountDataAction = {
     type: `TransactionPayController:getAmountData`;
     handler: TransactionPayController['getAmountData'];
 };
+/**
+ * Determines whether the gas fee of a transaction is sponsored.
+ *
+ * Delegates to the client-supplied {@link IsGasFeeSponsoredCallback}.
+ * Returns not sponsored when no callback is configured.
+ *
+ * @param args - The arguments forwarded to the {@link IsGasFeeSponsoredCallback}.
+ * @returns A promise resolving to whether the gas fee is sponsored.
+ */
+export type TransactionPayControllerIsGasFeeSponsoredAction = {
+    type: `TransactionPayController:isGasFeeSponsored`;
+    handler: TransactionPayController['isGasFeeSponsored'];
+};
 /**
  * Returns optional fiat execution configuration.
  *
@@ -128,5 +141,5 @@ export type TransactionPayControllerPolymarketSubmitDepositWalletBatchAction = {
 /**
  * Union of all TransactionPayController action types.
  */
-export type TransactionPayControllerMethodActions = TransactionPayControllerSetTransactionConfigAction | TransactionPayControllerUpdatePaymentTokenAction | TransactionPayControllerUpdateFiatPaymentAction | TransactionPayControllerGetDelegationTransactionAction | TransactionPayControllerGetAmountDataAction | TransactionPayControllerGetFiatOptionsAction | TransactionPayControllerGetPaymentOverrideDataAction | TransactionPayControllerGetStrategyAction | TransactionPayControllerPolymarketGetDepositWalletAddressAction | TransactionPayControllerPolymarketSubmitDepositWalletBatchAction;
+export type TransactionPayControllerMethodActions = TransactionPayControllerSetTransactionConfigAction | TransactionPayControllerUpdatePaymentTokenAction | TransactionPayControllerUpdateFiatPaymentAction | TransactionPayControllerGetDelegationTransactionAction | TransactionPayControllerGetAmountDataAction | TransactionPayControllerIsGasFeeSponsoredAction | TransactionPayControllerGetFiatOptionsAction | TransactionPayControllerGetPaymentOverrideDataAction | TransactionPayControllerGetStrategyAction | TransactionPayControllerPolymarketGetDepositWalletAddressAction | TransactionPayControllerPolymarketSubmitDepositWalletBatchAction;
 //# sourceMappingURL=TransactionPayController-method-action-types.d.ts.map

package/dist/TransactionPayController-method-action-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TransactionPayController-method-action-types.d.ts","sourceRoot":"","sources":["../src/TransactionPayController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAE9E;;;;;;;;GAQG;AACH,MAAM,MAAM,kDAAkD,GAAG;IAC/D,IAAI,EAAE,+CAA+C,CAAC;IACtD,OAAO,EAAE,wBAAwB,CAAC,sBAAsB,CAAC,CAAC;CAC3D,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,gDAAgD,GAAG;IAC7D,IAAI,EAAE,6CAA6C,CAAC;IACpD,OAAO,EAAE,wBAAwB,CAAC,oBAAoB,CAAC,CAAC;CACzD,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,+CAA+C,GAAG;IAC5D,IAAI,EAAE,4CAA4C,CAAC;IACnD,OAAO,EAAE,wBAAwB,CAAC,mBAAmB,CAAC,CAAC;CACxD,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,sDAAsD,GAAG;IACnE,IAAI,EAAE,mDAAmD,CAAC;IAC1D,OAAO,EAAE,wBAAwB,CAAC,0BAA0B,CAAC,CAAC;CAC/D,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,2CAA2C,GAAG;IACxD,IAAI,EAAE,wCAAwC,CAAC;IAC/C,OAAO,EAAE,wBAAwB,CAAC,eAAe,CAAC,CAAC;CACpD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,4CAA4C,GAAG;IACzD,IAAI,EAAE,yCAAyC,CAAC;IAChD,OAAO,EAAE,wBAAwB,CAAC,gBAAgB,CAAC,CAAC;CACrD,CAAC;AAEF,MAAM,MAAM,oDAAoD,GAAG;IACjE,IAAI,EAAE,iDAAiD,CAAC;IACxD,OAAO,EAAE,wBAAwB,CAAC,wBAAwB,CAAC,CAAC;CAC7D,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,yCAAyC,GAAG;IACtD,IAAI,EAAE,sCAAsC,CAAC;IAC7C,OAAO,EAAE,wBAAwB,CAAC,aAAa,CAAC,CAAC;CAClD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,+DAA+D,GAAG;IAC5E,IAAI,EAAE,4DAA4D,CAAC;IACnE,OAAO,EAAE,wBAAwB,CAAC,mCAAmC,CAAC,CAAC;CACxE,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,gEAAgE,GAAG;IAC7E,IAAI,EAAE,6DAA6D,CAAC;IACpE,OAAO,EAAE,wBAAwB,CAAC,oCAAoC,CAAC,CAAC;CACzE,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qCAAqC,GAC7C,kDAAkD,GAClD,gDAAgD,GAChD,+CAA+C,GAC/C,sDAAsD,GACtD,2CAA2C,GAC3C,4CAA4C,GAC5C,oDAAoD,GACpD,yCAAyC,GACzC,+DAA+D,GAC/D,gEAAgE,CAAC"}
+{"version":3,"file":"TransactionPayController-method-action-types.d.ts","sourceRoot":"","sources":["../src/TransactionPayController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAE9E;;;;;;;;GAQG;AACH,MAAM,MAAM,kDAAkD,GAAG;IAC/D,IAAI,EAAE,+CAA+C,CAAC;IACtD,OAAO,EAAE,wBAAwB,CAAC,sBAAsB,CAAC,CAAC;CAC3D,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,gDAAgD,GAAG;IAC7D,IAAI,EAAE,6CAA6C,CAAC;IACpD,OAAO,EAAE,wBAAwB,CAAC,oBAAoB,CAAC,CAAC;CACzD,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,+CAA+C,GAAG;IAC5D,IAAI,EAAE,4CAA4C,CAAC;IACnD,OAAO,EAAE,wBAAwB,CAAC,mBAAmB,CAAC,CAAC;CACxD,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,sDAAsD,GAAG;IACnE,IAAI,EAAE,mDAAmD,CAAC;IAC1D,OAAO,EAAE,wBAAwB,CAAC,0BAA0B,CAAC,CAAC;CAC/D,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,2CAA2C,GAAG;IACxD,IAAI,EAAE,wCAAwC,CAAC;IAC/C,OAAO,EAAE,wBAAwB,CAAC,eAAe,CAAC,CAAC;CACpD,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,+CAA+C,GAAG;IAC5D,IAAI,EAAE,4CAA4C,CAAC;IACnD,OAAO,EAAE,wBAAwB,CAAC,mBAAmB,CAAC,CAAC;CACxD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,4CAA4C,GAAG;IACzD,IAAI,EAAE,yCAAyC,CAAC;IAChD,OAAO,EAAE,wBAAwB,CAAC,gBAAgB,CAAC,CAAC;CACrD,CAAC;AAEF,MAAM,MAAM,oDAAoD,GAAG;IACjE,IAAI,EAAE,iDAAiD,CAAC;IACxD,OAAO,EAAE,wBAAwB,CAAC,wBAAwB,CAAC,CAAC;CAC7D,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,yCAAyC,GAAG;IACtD,IAAI,EAAE,sCAAsC,CAAC;IAC7C,OAAO,EAAE,wBAAwB,CAAC,aAAa,CAAC,CAAC;CAClD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,+DAA+D,GAAG;IAC5E,IAAI,EAAE,4DAA4D,CAAC;IACnE,OAAO,EAAE,wBAAwB,CAAC,mCAAmC,CAAC,CAAC;CACxE,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,gEAAgE,GAAG;IAC7E,IAAI,EAAE,6DAA6D,CAAC;IACpE,OAAO,EAAE,wBAAwB,CAAC,oCAAoC,CAAC,CAAC;CACzE,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qCAAqC,GAC7C,kDAAkD,GAClD,gDAAgD,GAChD,+CAA+C,GAC/C,sDAAsD,GACtD,2CAA2C,GAC3C,+CAA+C,GAC/C,4CAA4C,GAC5C,oDAAoD,GACpD,yCAAyC,GACzC,+DAA+D,GAC/D,gEAAgE,CAAC"}

package/dist/TransactionPayController-method-action-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"TransactionPayController-method-action-types.js","sourceRoot":"","sources":["../src/TransactionPayController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { TransactionPayController } from './TransactionPayController.js';\n\n/**\n * Sets the transaction configuration.\n *\n * The callback receives the current configuration properties and can mutate\n * them in place. Updated values are written back to the transaction data.\n *\n * @param transactionId - The ID of the transaction to configure.\n * @param callback - A callback that receives a mutable {@link TransactionConfig} object.\n */\nexport type TransactionPayControllerSetTransactionConfigAction = {\n  type: `TransactionPayController:setTransactionConfig`;\n  handler: TransactionPayController['setTransactionConfig'];\n};\n\n/**\n * Updates the payment token for a transaction.\n *\n * Resolves token metadata and balances, then stores the new payment token\n * in the transaction data. This triggers recalculation of source amounts\n * and quote retrieval.\n *\n * @param request - The payment token update request containing the\n * transaction ID, token address, and chain ID.\n */\nexport type TransactionPayControllerUpdatePaymentTokenAction = {\n  type: `TransactionPayController:updatePaymentToken`;\n  handler: TransactionPayController['updatePaymentToken'];\n};\n\n/**\n * Updates the fiat payment state for a transaction.\n *\n * The request callback receives the current fiat payment state and can\n * mutate it to update properties such as the selected payment method or\n * fiat amount.\n *\n * @param request - The fiat payment update request containing the\n * transaction ID and a callback to mutate fiat payment state.\n */\nexport type TransactionPayControllerUpdateFiatPaymentAction = {\n  type: `TransactionPayController:updateFiatPayment`;\n  handler: TransactionPayController['updateFiatPayment'];\n};\n\n/**\n * Gets the delegation transaction for a given transaction.\n *\n * Converts the provided transaction into a redeem delegation by delegating\n * to the configured callback. Returns the delegation transaction data\n * including the encoded call data, target address, value, and an optional\n * authorization list.\n *\n * @param args - The arguments forwarded to the {@link GetDelegationTransactionCallback},\n * containing the transaction metadata.\n * @returns A promise resolving to the delegation transaction data.\n */\nexport type TransactionPayControllerGetDelegationTransactionAction = {\n  type: `TransactionPayController:getDelegationTransaction`;\n  handler: TransactionPayController['getDelegationTransaction'];\n};\n\n/**\n * Returns additional transactions for the paymentOverride flow.\n *\n * Delegates to the client-supplied {@link GetPaymentOverrideDataCallback}.\n * Called during quote execution when `paymentOverride` is defined on the transaction.\n * Returns an empty array when no callback is configured.\n *\n * @param args - The arguments forwarded to the {@link GetPaymentOverrideDataCallback}.\n * @returns A promise resolving to the additional transactions array.\n */\nexport type TransactionPayControllerGetAmountDataAction = {\n  type: `TransactionPayController:getAmountData`;\n  handler: TransactionPayController['getAmountData'];\n};\n\n/**\n * Returns optional fiat execution configuration.\n *\n * This is intentionally not stored in controller state.\n *\n * @returns Fiat execution options, if configured.\n */\nexport type TransactionPayControllerGetFiatOptionsAction = {\n  type: `TransactionPayController:getFiatOptions`;\n  handler: TransactionPayController['getFiatOptions'];\n};\n\nexport type TransactionPayControllerGetPaymentOverrideDataAction = {\n  type: `TransactionPayController:getPaymentOverrideData`;\n  handler: TransactionPayController['getPaymentOverrideData'];\n};\n\n/**\n * Gets the preferred strategy for a transaction.\n *\n * Returns the first strategy from the ordered list of strategies applicable\n * to the given transaction. Falls back to the default strategy order derived\n * from feature flags when no custom strategy callback is configured.\n *\n * @param transaction - The transaction metadata to determine the strategy for.\n * @returns The preferred {@link TransactionPayStrategy} for the transaction.\n */\nexport type TransactionPayControllerGetStrategyAction = {\n  type: `TransactionPayController:getStrategy`;\n  handler: TransactionPayController['getStrategy'];\n};\n\n/**\n * Derives the Polymarket deposit-wallet address for an EOA via the\n * client-supplied callback.\n *\n * @param args - The arguments forwarded to {@link PolymarketCallbacks.getDepositWalletAddress}.\n * @returns A promise resolving to the deposit-wallet address.\n */\nexport type TransactionPayControllerPolymarketGetDepositWalletAddressAction = {\n  type: `TransactionPayController:polymarketGetDepositWalletAddress`;\n  handler: TransactionPayController['polymarketGetDepositWalletAddress'];\n};\n\n/**\n * Signs and broadcasts a Polymarket deposit-wallet batch via the\n * client-supplied callback.\n *\n * @param args - The arguments forwarded to {@link PolymarketCallbacks.submitDepositWalletBatch}.\n * @returns A promise resolving to the relayer-issued source hash.\n */\nexport type TransactionPayControllerPolymarketSubmitDepositWalletBatchAction = {\n  type: `TransactionPayController:polymarketSubmitDepositWalletBatch`;\n  handler: TransactionPayController['polymarketSubmitDepositWalletBatch'];\n};\n\n/**\n * Union of all TransactionPayController action types.\n */\nexport type TransactionPayControllerMethodActions =\n  | TransactionPayControllerSetTransactionConfigAction\n  | TransactionPayControllerUpdatePaymentTokenAction\n  | TransactionPayControllerUpdateFiatPaymentAction\n  | TransactionPayControllerGetDelegationTransactionAction\n  | TransactionPayControllerGetAmountDataAction\n  | TransactionPayControllerGetFiatOptionsAction\n  | TransactionPayControllerGetPaymentOverrideDataAction\n  | TransactionPayControllerGetStrategyAction\n  | TransactionPayControllerPolymarketGetDepositWalletAddressAction\n  | TransactionPayControllerPolymarketSubmitDepositWalletBatchAction;\n"]}
+{"version":3,"file":"TransactionPayController-method-action-types.js","sourceRoot":"","sources":["../src/TransactionPayController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { TransactionPayController } from './TransactionPayController.js';\n\n/**\n * Sets the transaction configuration.\n *\n * The callback receives the current configuration properties and can mutate\n * them in place. Updated values are written back to the transaction data.\n *\n * @param transactionId - The ID of the transaction to configure.\n * @param callback - A callback that receives a mutable {@link TransactionConfig} object.\n */\nexport type TransactionPayControllerSetTransactionConfigAction = {\n  type: `TransactionPayController:setTransactionConfig`;\n  handler: TransactionPayController['setTransactionConfig'];\n};\n\n/**\n * Updates the payment token for a transaction.\n *\n * Resolves token metadata and balances, then stores the new payment token\n * in the transaction data. This triggers recalculation of source amounts\n * and quote retrieval.\n *\n * @param request - The payment token update request containing the\n * transaction ID, token address, and chain ID.\n */\nexport type TransactionPayControllerUpdatePaymentTokenAction = {\n  type: `TransactionPayController:updatePaymentToken`;\n  handler: TransactionPayController['updatePaymentToken'];\n};\n\n/**\n * Updates the fiat payment state for a transaction.\n *\n * The request callback receives the current fiat payment state and can\n * mutate it to update properties such as the selected payment method or\n * fiat amount.\n *\n * @param request - The fiat payment update request containing the\n * transaction ID and a callback to mutate fiat payment state.\n */\nexport type TransactionPayControllerUpdateFiatPaymentAction = {\n  type: `TransactionPayController:updateFiatPayment`;\n  handler: TransactionPayController['updateFiatPayment'];\n};\n\n/**\n * Gets the delegation transaction for a given transaction.\n *\n * Converts the provided transaction into a redeem delegation by delegating\n * to the configured callback. Returns the delegation transaction data\n * including the encoded call data, target address, value, and an optional\n * authorization list.\n *\n * @param args - The arguments forwarded to the {@link GetDelegationTransactionCallback},\n * containing the transaction metadata.\n * @returns A promise resolving to the delegation transaction data.\n */\nexport type TransactionPayControllerGetDelegationTransactionAction = {\n  type: `TransactionPayController:getDelegationTransaction`;\n  handler: TransactionPayController['getDelegationTransaction'];\n};\n\n/**\n * Returns additional transactions for the paymentOverride flow.\n *\n * Delegates to the client-supplied {@link GetPaymentOverrideDataCallback}.\n * Called during quote execution when `paymentOverride` is defined on the transaction.\n * Returns an empty array when no callback is configured.\n *\n * @param args - The arguments forwarded to the {@link GetPaymentOverrideDataCallback}.\n * @returns A promise resolving to the additional transactions array.\n */\nexport type TransactionPayControllerGetAmountDataAction = {\n  type: `TransactionPayController:getAmountData`;\n  handler: TransactionPayController['getAmountData'];\n};\n\n/**\n * Determines whether the gas fee of a transaction is sponsored.\n *\n * Delegates to the client-supplied {@link IsGasFeeSponsoredCallback}.\n * Returns not sponsored when no callback is configured.\n *\n * @param args - The arguments forwarded to the {@link IsGasFeeSponsoredCallback}.\n * @returns A promise resolving to whether the gas fee is sponsored.\n */\nexport type TransactionPayControllerIsGasFeeSponsoredAction = {\n  type: `TransactionPayController:isGasFeeSponsored`;\n  handler: TransactionPayController['isGasFeeSponsored'];\n};\n\n/**\n * Returns optional fiat execution configuration.\n *\n * This is intentionally not stored in controller state.\n *\n * @returns Fiat execution options, if configured.\n */\nexport type TransactionPayControllerGetFiatOptionsAction = {\n  type: `TransactionPayController:getFiatOptions`;\n  handler: TransactionPayController['getFiatOptions'];\n};\n\nexport type TransactionPayControllerGetPaymentOverrideDataAction = {\n  type: `TransactionPayController:getPaymentOverrideData`;\n  handler: TransactionPayController['getPaymentOverrideData'];\n};\n\n/**\n * Gets the preferred strategy for a transaction.\n *\n * Returns the first strategy from the ordered list of strategies applicable\n * to the given transaction. Falls back to the default strategy order derived\n * from feature flags when no custom strategy callback is configured.\n *\n * @param transaction - The transaction metadata to determine the strategy for.\n * @returns The preferred {@link TransactionPayStrategy} for the transaction.\n */\nexport type TransactionPayControllerGetStrategyAction = {\n  type: `TransactionPayController:getStrategy`;\n  handler: TransactionPayController['getStrategy'];\n};\n\n/**\n * Derives the Polymarket deposit-wallet address for an EOA via the\n * client-supplied callback.\n *\n * @param args - The arguments forwarded to {@link PolymarketCallbacks.getDepositWalletAddress}.\n * @returns A promise resolving to the deposit-wallet address.\n */\nexport type TransactionPayControllerPolymarketGetDepositWalletAddressAction = {\n  type: `TransactionPayController:polymarketGetDepositWalletAddress`;\n  handler: TransactionPayController['polymarketGetDepositWalletAddress'];\n};\n\n/**\n * Signs and broadcasts a Polymarket deposit-wallet batch via the\n * client-supplied callback.\n *\n * @param args - The arguments forwarded to {@link PolymarketCallbacks.submitDepositWalletBatch}.\n * @returns A promise resolving to the relayer-issued source hash.\n */\nexport type TransactionPayControllerPolymarketSubmitDepositWalletBatchAction = {\n  type: `TransactionPayController:polymarketSubmitDepositWalletBatch`;\n  handler: TransactionPayController['polymarketSubmitDepositWalletBatch'];\n};\n\n/**\n * Union of all TransactionPayController action types.\n */\nexport type TransactionPayControllerMethodActions =\n  | TransactionPayControllerSetTransactionConfigAction\n  | TransactionPayControllerUpdatePaymentTokenAction\n  | TransactionPayControllerUpdateFiatPaymentAction\n  | TransactionPayControllerGetDelegationTransactionAction\n  | TransactionPayControllerGetAmountDataAction\n  | TransactionPayControllerIsGasFeeSponsoredAction\n  | TransactionPayControllerGetFiatOptionsAction\n  | TransactionPayControllerGetPaymentOverrideDataAction\n  | TransactionPayControllerGetStrategyAction\n  | TransactionPayControllerPolymarketGetDepositWalletAddressAction\n  | TransactionPayControllerPolymarketSubmitDepositWalletBatchAction;\n"]}

package/dist/TransactionPayController.d.ts

@@ -1,10 +1,10 @@
 import { BaseController } from '@metamask/base-controller';
 import type { TransactionMeta } from '@metamask/transaction-controller';
 import { CONTROLLER_NAME, TransactionPayStrategy } from './constants.js';
-import type { GetAmountDataCallback, GetDelegationTransactionCallback, GetPaymentOverrideDataCallback, PolymarketCallbacks, TransactionConfigCallback, TransactionPayControllerMessenger, TransactionPayFiatOptions, TransactionPayControllerOptions, TransactionPayControllerState, UpdateFiatPaymentRequest, UpdatePaymentTokenRequest } from './types.js';
+import type { GetAmountDataCallback, GetDelegationTransactionCallback, GetPaymentOverrideDataCallback, IsGasFeeSponsoredCallback, PolymarketCallbacks, TransactionConfigCallback, TransactionPayControllerMessenger, TransactionPayFiatOptions, TransactionPayControllerOptions, TransactionPayControllerState, UpdateFiatPaymentRequest, UpdatePaymentTokenRequest } from './types.js';
 export declare class TransactionPayController extends BaseController<typeof CONTROLLER_NAME, TransactionPayControllerState, TransactionPayControllerMessenger> {
     #private;
-    constructor({ fiatOptions, getAmountData, getBalance, getDelegationTransaction, getPaymentOverrideData, getStrategy, getStrategies, messenger, polymarket, state, }: TransactionPayControllerOptions);
+    constructor({ fiatOptions, getAmountData, getBalance, getDelegationTransaction, getPaymentOverrideData, getStrategy, getStrategies, isGasFeeSponsored, messenger, polymarket, state, }: TransactionPayControllerOptions);
     /**
      * Sets the transaction configuration.
      *
@@ -61,6 +61,16 @@ export declare class TransactionPayController extends BaseController<typeof CONT
      * @returns A promise resolving to the additional transactions array.
      */
     getAmountData(...args: Parameters<GetAmountDataCallback>): ReturnType<GetAmountDataCallback>;
+    /**
+     * Determines whether the gas fee of a transaction is sponsored.
+     *
+     * Delegates to the client-supplied {@link IsGasFeeSponsoredCallback}.
+     * Returns not sponsored when no callback is configured.
+     *
+     * @param args - The arguments forwarded to the {@link IsGasFeeSponsoredCallback}.
+     * @returns A promise resolving to whether the gas fee is sponsored.
+     */
+    isGasFeeSponsored(...args: Parameters<IsGasFeeSponsoredCallback>): ReturnType<IsGasFeeSponsoredCallback>;
     /**
      * Returns optional fiat execution configuration.
      *

package/dist/TransactionPayController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TransactionPayController.d.ts","sourceRoot":"","sources":["../src/TransactionPayController.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAMxE,OAAO,EACL,eAAe,EAEf,sBAAsB,EACvB,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EACV,qBAAqB,EAErB,gCAAgC,EAChC,8BAA8B,EAC9B,mBAAmB,EAEnB,yBAAyB,EAEzB,iCAAiC,EACjC,yBAAyB,EACzB,+BAA+B,EAC/B,6BAA6B,EAC7B,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAmCpB,qBAAa,wBAAyB,SAAQ,cAAc,CAC1D,OAAO,eAAe,EACtB,6BAA6B,EAC7B,iCAAiC,CAClC;;IAqBC,YAAY,EACV,WAAW,EACX,aAAa,EACb,UAAU,EACV,wBAAwB,EACxB,sBAAsB,EACtB,WAAW,EACX,aAAa,EACb,SAAS,EACT,UAAU,EACV,KAAK,GACN,EAAE,+BAA+B,EAwCjC;IAED;;;;;;;;OAQG;IACH,oBAAoB,CAClB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,yBAAyB,GAClC,IAAI,CA2BN;IAED;;;;;;;;;OASG;IACH,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,IAAI,CAK3D;IAED;;;;;;;;;OASG;IACH,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAKzD;IAED;;;;;;;;;;;OAWG;IACH,wBAAwB,CACtB,GAAG,IAAI,EAAE,UAAU,CAAC,gCAAgC,CAAC,GACpD,UAAU,CAAC,gCAAgC,CAAC,CAE9C;IAED;;;;;;;;;OASG;IACH,aAAa,CACX,GAAG,IAAI,EAAE,UAAU,CAAC,qBAAqB,CAAC,GACzC,UAAU,CAAC,qBAAqB,CAAC,CAEnC;IAED;;;;;;OAMG;IACH,cAAc,IAAI,yBAAyB,GAAG,SAAS,CAEtD;IAED,sBAAsB,CACpB,GAAG,IAAI,EAAE,UAAU,CAAC,8BAA8B,CAAC,GAClD,UAAU,CAAC,8BAA8B,CAAC,CAI5C;IAED;;;;;;;;;OASG;IACH,WAAW,CAAC,WAAW,EAAE,eAAe,GAAG,sBAAsB,CAEhE;IAED;;;;;;OAMG;IACH,iCAAiC,CAC/B,GAAG,IAAI,EAAE,UAAU,CAAC,mBAAmB,CAAC,yBAAyB,CAAC,CAAC,GAClE,UAAU,CAAC,mBAAmB,CAAC,yBAAyB,CAAC,CAAC,CAE5D;IAED;;;;;;OAMG;IACH,kCAAkC,CAChC,GAAG,IAAI,EAAE,UAAU,CAAC,mBAAmB,CAAC,0BAA0B,CAAC,CAAC,GACnE,UAAU,CAAC,mBAAmB,CAAC,0BAA0B,CAAC,CAAC,CAE7D;CAiJF"}
+{"version":3,"file":"TransactionPayController.d.ts","sourceRoot":"","sources":["../src/TransactionPayController.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAMxE,OAAO,EACL,eAAe,EAEf,sBAAsB,EACvB,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EACV,qBAAqB,EAErB,gCAAgC,EAChC,8BAA8B,EAC9B,yBAAyB,EACzB,mBAAmB,EAEnB,yBAAyB,EAEzB,iCAAiC,EACjC,yBAAyB,EACzB,+BAA+B,EAC/B,6BAA6B,EAC7B,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAoCpB,qBAAa,wBAAyB,SAAQ,cAAc,CAC1D,OAAO,eAAe,EACtB,6BAA6B,EAC7B,iCAAiC,CAClC;;IAuBC,YAAY,EACV,WAAW,EACX,aAAa,EACb,UAAU,EACV,wBAAwB,EACxB,sBAAsB,EACtB,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,SAAS,EACT,UAAU,EACV,KAAK,GACN,EAAE,+BAA+B,EAyCjC;IAED;;;;;;;;OAQG;IACH,oBAAoB,CAClB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,yBAAyB,GAClC,IAAI,CA2BN;IAED;;;;;;;;;OASG;IACH,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,IAAI,CAK3D;IAED;;;;;;;;;OASG;IACH,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAKzD;IAED;;;;;;;;;;;OAWG;IACH,wBAAwB,CACtB,GAAG,IAAI,EAAE,UAAU,CAAC,gCAAgC,CAAC,GACpD,UAAU,CAAC,gCAAgC,CAAC,CAE9C;IAED;;;;;;;;;OASG;IACH,aAAa,CACX,GAAG,IAAI,EAAE,UAAU,CAAC,qBAAqB,CAAC,GACzC,UAAU,CAAC,qBAAqB,CAAC,CAEnC;IAED;;;;;;;;OAQG;IACH,iBAAiB,CACf,GAAG,IAAI,EAAE,UAAU,CAAC,yBAAyB,CAAC,GAC7C,UAAU,CAAC,yBAAyB,CAAC,CAKvC;IAED;;;;;;OAMG;IACH,cAAc,IAAI,yBAAyB,GAAG,SAAS,CAEtD;IAED,sBAAsB,CACpB,GAAG,IAAI,EAAE,UAAU,CAAC,8BAA8B,CAAC,GAClD,UAAU,CAAC,8BAA8B,CAAC,CAI5C;IAED;;;;;;;;;OASG;IACH,WAAW,CAAC,WAAW,EAAE,eAAe,GAAG,sBAAsB,CAEhE;IAED;;;;;;OAMG;IACH,iCAAiC,CAC/B,GAAG,IAAI,EAAE,UAAU,CAAC,mBAAmB,CAAC,yBAAyB,CAAC,CAAC,GAClE,UAAU,CAAC,mBAAmB,CAAC,yBAAyB,CAAC,CAAC,CAE5D;IAED;;;;;;OAMG;IACH,kCAAkC,CAChC,GAAG,IAAI,EAAE,UAAU,CAAC,mBAAmB,CAAC,0BAA0B,CAAC,CAAC,GACnE,UAAU,CAAC,mBAAmB,CAAC,0BAA0B,CAAC,CAAC,CAE7D;CAiJF"}

package/dist/TransactionPayController.js

@@ -14,6 +14,7 @@ const MESSENGER_EXPOSED_METHODS = [
     'getFiatOptions',
     'getPaymentOverrideData',
     'getStrategy',
+    'isGasFeeSponsored',
     'polymarketGetDepositWalletAddress',
     'polymarketSubmitDepositWalletBatch',
     'setTransactionConfig',
@@ -39,8 +40,9 @@ export class TransactionPayController extends BaseController {
     #getPaymentOverrideData;
     #getStrategy;
     #getStrategies;
+    #isGasFeeSponsored;
     #polymarket;
-    constructor({ fiatOptions, getAmountData, getBalance, getDelegationTransaction, getPaymentOverrideData, getStrategy, getStrategies, messenger, polymarket, state, }) {
+    constructor({ fiatOptions, getAmountData, getBalance, getDelegationTransaction, getPaymentOverrideData, getStrategy, getStrategies, isGasFeeSponsored, messenger, polymarket, state, }) {
         super({
             name: CONTROLLER_NAME,
             metadata: stateMetadata,
@@ -54,6 +56,7 @@ export class TransactionPayController extends BaseController {
         this.#getPaymentOverrideData = getPaymentOverrideData;
         this.#getStrategy = getStrategy;
         this.#getStrategies = getStrategies;
+        this.#isGasFeeSponsored = isGasFeeSponsored;
         this.#polymarket = polymarket;
         this.messenger.registerMethodActionHandlers(this, MESSENGER_EXPOSED_METHODS);
         subscribeTransactionChanges(messenger, this.#updateTransactionData.bind(this), this.#removeTransactionData.bind(this));
@@ -156,6 +159,19 @@ export class TransactionPayController extends BaseController {
     getAmountData(...args) {
         return this.#getAmountData?.(...args) ?? Promise.resolve({ updates: [] });
     }
+    /**
+     * Determines whether the gas fee of a transaction is sponsored.
+     *
+     * Delegates to the client-supplied {@link IsGasFeeSponsoredCallback}.
+     * Returns not sponsored when no callback is configured.
+     *
+     * @param args - The arguments forwarded to the {@link IsGasFeeSponsoredCallback}.
+     * @returns A promise resolving to whether the gas fee is sponsored.
+     */
+    isGasFeeSponsored(...args) {
+        return (this.#isGasFeeSponsored?.(...args) ??
+            Promise.resolve({ isGasFeeSponsored: false }));
+    }
     /**
      * Returns optional fiat execution configuration.
      *

package/dist/TransactionPayController.js.map

@@ -1 +1 @@
-{"version":3,"file":"TransactionPayController.js","sourceRoot":"","sources":["../src/TransactionPayController.ts"],"names":[],"mappings":"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","sourcesContent":["import type { StateMetadata } from '@metamask/base-controller';\nimport { BaseController } from '@metamask/base-controller';\nimport type { TransactionMeta } from '@metamask/transaction-controller';\nimport type { Draft } from 'immer';\nimport { noop } from 'lodash-es';\n\nimport { updateFiatPayment } from './actions/update-fiat-payment.js';\nimport { updatePaymentToken } from './actions/update-payment-token.js';\nimport {\n  CONTROLLER_NAME,\n  isTransactionPayStrategy,\n  TransactionPayStrategy,\n} from './constants.js';\nimport { QuoteRefresher } from './helpers/QuoteRefresher.js';\nimport type {\n  GetAmountDataCallback,\n  GetBalanceCallback,\n  GetDelegationTransactionCallback,\n  GetPaymentOverrideDataCallback,\n  PolymarketCallbacks,\n  TransactionConfig,\n  TransactionConfigCallback,\n  TransactionData,\n  TransactionPayControllerMessenger,\n  TransactionPayFiatOptions,\n  TransactionPayControllerOptions,\n  TransactionPayControllerState,\n  UpdateFiatPaymentRequest,\n  UpdatePaymentTokenRequest,\n} from './types.js';\nimport { getStrategyOrder } from './utils/feature-flags.js';\nimport { updateQuotes } from './utils/quotes.js';\nimport { updateSourceAmounts } from './utils/source-amounts.js';\nimport {\n  subscribeAssetChanges,\n  subscribeTransactionChanges,\n} from './utils/transaction.js';\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'getAmountData',\n  'getDelegationTransaction',\n  'getFiatOptions',\n  'getPaymentOverrideData',\n  'getStrategy',\n  'polymarketGetDepositWalletAddress',\n  'polymarketSubmitDepositWalletBatch',\n  'setTransactionConfig',\n  'updateFiatPayment',\n  'updatePaymentToken',\n] as const;\n\nconst stateMetadata: StateMetadata<TransactionPayControllerState> = {\n  transactionData: {\n    includeInDebugSnapshot: false,\n    includeInStateLogs: true,\n    persist: false,\n    usedInUi: true,\n  },\n};\n\nconst getDefaultState = (): TransactionPayControllerState => ({\n  transactionData: {},\n});\n\nexport class TransactionPayController extends BaseController<\n  typeof CONTROLLER_NAME,\n  TransactionPayControllerState,\n  TransactionPayControllerMessenger\n> {\n  readonly #fiatOptions?: TransactionPayFiatOptions;\n\n  readonly #getAmountData?: GetAmountDataCallback;\n\n  readonly #getBalance?: GetBalanceCallback;\n\n  readonly #getDelegationTransaction: GetDelegationTransactionCallback;\n\n  readonly #getPaymentOverrideData?: GetPaymentOverrideDataCallback;\n\n  readonly #getStrategy?: (\n    transaction: TransactionMeta,\n  ) => TransactionPayStrategy;\n\n  readonly #getStrategies?: (\n    transaction: TransactionMeta,\n  ) => TransactionPayStrategy[];\n\n  readonly #polymarket?: PolymarketCallbacks;\n\n  constructor({\n    fiatOptions,\n    getAmountData,\n    getBalance,\n    getDelegationTransaction,\n    getPaymentOverrideData,\n    getStrategy,\n    getStrategies,\n    messenger,\n    polymarket,\n    state,\n  }: TransactionPayControllerOptions) {\n    super({\n      name: CONTROLLER_NAME,\n      metadata: stateMetadata,\n      messenger,\n      state: { ...getDefaultState(), ...state },\n    });\n\n    this.#fiatOptions = fiatOptions;\n    this.#getAmountData = getAmountData;\n    this.#getBalance = getBalance;\n    this.#getDelegationTransaction = getDelegationTransaction;\n    this.#getPaymentOverrideData = getPaymentOverrideData;\n    this.#getStrategy = getStrategy;\n    this.#getStrategies = getStrategies;\n    this.#polymarket = polymarket;\n\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n\n    subscribeTransactionChanges(\n      messenger,\n      this.#updateTransactionData.bind(this),\n      this.#removeTransactionData.bind(this),\n    );\n\n    subscribeAssetChanges(\n      messenger,\n      () => this.state,\n      this.#updateTransactionData.bind(this),\n    );\n\n    // eslint-disable-next-line no-new\n    new QuoteRefresher({\n      getStrategies: this.#getStrategiesWithFallback.bind(this),\n      messenger,\n      updateTransactionData: this.#updateTransactionData.bind(this),\n    });\n  }\n\n  /**\n   * Sets the transaction configuration.\n   *\n   * The callback receives the current configuration properties and can mutate\n   * them in place. Updated values are written back to the transaction data.\n   *\n   * @param transactionId - The ID of the transaction to configure.\n   * @param callback - A callback that receives a mutable {@link TransactionConfig} object.\n   */\n  setTransactionConfig(\n    transactionId: string,\n    callback: TransactionConfigCallback,\n  ): void {\n    this.#updateTransactionData(transactionId, (transactionData) => {\n      const config: TransactionConfig = {\n        accountOverride: transactionData.accountOverride,\n        atomic: transactionData.atomic,\n        isHyperliquidSource: transactionData.isHyperliquidSource,\n        isMaxAmount: transactionData.isMaxAmount,\n        isPolymarketDepositWallet: transactionData.isPolymarketDepositWallet,\n        isPostQuote: transactionData.isPostQuote,\n        isQuoteRequired: transactionData.isQuoteRequired,\n        paymentOverride: transactionData.paymentOverride,\n        refundTo: transactionData.refundTo,\n      };\n\n      const previousAccountOverride = config.accountOverride;\n\n      callback(config);\n\n      Object.assign(transactionData, config);\n\n      if (\n        !config.isPostQuote &&\n        config.accountOverride !== previousAccountOverride\n      ) {\n        transactionData.paymentToken = undefined;\n      }\n    });\n  }\n\n  /**\n   * Updates the payment token for a transaction.\n   *\n   * Resolves token metadata and balances, then stores the new payment token\n   * in the transaction data. This triggers recalculation of source amounts\n   * and quote retrieval.\n   *\n   * @param request - The payment token update request containing the\n   * transaction ID, token address, and chain ID.\n   */\n  updatePaymentToken(request: UpdatePaymentTokenRequest): void {\n    updatePaymentToken(request, {\n      messenger: this.messenger,\n      updateTransactionData: this.#updateTransactionData.bind(this),\n    });\n  }\n\n  /**\n   * Updates the fiat payment state for a transaction.\n   *\n   * The request callback receives the current fiat payment state and can\n   * mutate it to update properties such as the selected payment method or\n   * fiat amount.\n   *\n   * @param request - The fiat payment update request containing the\n   * transaction ID and a callback to mutate fiat payment state.\n   */\n  updateFiatPayment(request: UpdateFiatPaymentRequest): void {\n    updateFiatPayment(request, {\n      messenger: this.messenger,\n      updateTransactionData: this.#updateTransactionData.bind(this),\n    });\n  }\n\n  /**\n   * Gets the delegation transaction for a given transaction.\n   *\n   * Converts the provided transaction into a redeem delegation by delegating\n   * to the configured callback. Returns the delegation transaction data\n   * including the encoded call data, target address, value, and an optional\n   * authorization list.\n   *\n   * @param args - The arguments forwarded to the {@link GetDelegationTransactionCallback},\n   * containing the transaction metadata.\n   * @returns A promise resolving to the delegation transaction data.\n   */\n  getDelegationTransaction(\n    ...args: Parameters<GetDelegationTransactionCallback>\n  ): ReturnType<GetDelegationTransactionCallback> {\n    return this.#getDelegationTransaction(...args);\n  }\n\n  /**\n   * Returns additional transactions for the paymentOverride flow.\n   *\n   * Delegates to the client-supplied {@link GetPaymentOverrideDataCallback}.\n   * Called during quote execution when `paymentOverride` is defined on the transaction.\n   * Returns an empty array when no callback is configured.\n   *\n   * @param args - The arguments forwarded to the {@link GetPaymentOverrideDataCallback}.\n   * @returns A promise resolving to the additional transactions array.\n   */\n  getAmountData(\n    ...args: Parameters<GetAmountDataCallback>\n  ): ReturnType<GetAmountDataCallback> {\n    return this.#getAmountData?.(...args) ?? Promise.resolve({ updates: [] });\n  }\n\n  /**\n   * Returns optional fiat execution configuration.\n   *\n   * This is intentionally not stored in controller state.\n   *\n   * @returns Fiat execution options, if configured.\n   */\n  getFiatOptions(): TransactionPayFiatOptions | undefined {\n    return this.#fiatOptions;\n  }\n\n  getPaymentOverrideData(\n    ...args: Parameters<GetPaymentOverrideDataCallback>\n  ): ReturnType<GetPaymentOverrideDataCallback> {\n    return (\n      this.#getPaymentOverrideData?.(...args) ?? Promise.resolve({ calls: [] })\n    );\n  }\n\n  /**\n   * Gets the preferred strategy for a transaction.\n   *\n   * Returns the first strategy from the ordered list of strategies applicable\n   * to the given transaction. Falls back to the default strategy order derived\n   * from feature flags when no custom strategy callback is configured.\n   *\n   * @param transaction - The transaction metadata to determine the strategy for.\n   * @returns The preferred {@link TransactionPayStrategy} for the transaction.\n   */\n  getStrategy(transaction: TransactionMeta): TransactionPayStrategy {\n    return this.#getStrategiesWithFallback(transaction)[0];\n  }\n\n  /**\n   * Derives the Polymarket deposit-wallet address for an EOA via the\n   * client-supplied callback.\n   *\n   * @param args - The arguments forwarded to {@link PolymarketCallbacks.getDepositWalletAddress}.\n   * @returns A promise resolving to the deposit-wallet address.\n   */\n  polymarketGetDepositWalletAddress(\n    ...args: Parameters<PolymarketCallbacks['getDepositWalletAddress']>\n  ): ReturnType<PolymarketCallbacks['getDepositWalletAddress']> {\n    return this.#requirePolymarket().getDepositWalletAddress(...args);\n  }\n\n  /**\n   * Signs and broadcasts a Polymarket deposit-wallet batch via the\n   * client-supplied callback.\n   *\n   * @param args - The arguments forwarded to {@link PolymarketCallbacks.submitDepositWalletBatch}.\n   * @returns A promise resolving to the relayer-issued source hash.\n   */\n  polymarketSubmitDepositWalletBatch(\n    ...args: Parameters<PolymarketCallbacks['submitDepositWalletBatch']>\n  ): ReturnType<PolymarketCallbacks['submitDepositWalletBatch']> {\n    return this.#requirePolymarket().submitDepositWalletBatch(...args);\n  }\n\n  #requirePolymarket(): PolymarketCallbacks {\n    if (!this.#polymarket) {\n      throw new Error('TransactionPayController: Polymarket callbacks missing');\n    }\n    return this.#polymarket;\n  }\n\n  #removeTransactionData(transactionId: string): void {\n    this.update((state) => {\n      delete state.transactionData[transactionId];\n    });\n  }\n\n  #updateTransactionData(\n    transactionId: string,\n    fn: (transactionData: Draft<TransactionData>) => void,\n  ): void {\n    let shouldUpdateQuotes = false;\n\n    this.update((state) => {\n      const { transactionData } = state;\n      let current = transactionData[transactionId];\n      const originalPaymentToken = current?.paymentToken;\n      const originalTokens = current?.tokens;\n      const originalIsMaxAmount = current?.isMaxAmount;\n      const originalIsPostQuote = current?.isPostQuote;\n      const originalAccountOverride = current?.accountOverride;\n      const originalFiatPaymentAmount = current?.fiatPayment?.amountFiat;\n      const originalFiatPaymentMethodId =\n        current?.fiatPayment?.selectedPaymentMethodId;\n\n      if (!current) {\n        transactionData[transactionId] = {\n          fiatPayment: {},\n          isLoading: false,\n          tokens: [],\n        };\n\n        current = transactionData[transactionId];\n      }\n\n      fn(current);\n\n      const isPaymentTokenUpdated =\n        current.paymentToken?.address?.toLowerCase() !==\n          originalPaymentToken?.address?.toLowerCase() ||\n        current.paymentToken?.chainId !== originalPaymentToken?.chainId;\n\n      const isPaymentTokenBalanceUpdated =\n        current.paymentToken?.balanceRaw !== originalPaymentToken?.balanceRaw;\n\n      const isTokensUpdated = current.tokens !== originalTokens;\n      const isIsMaxUpdated = current.isMaxAmount !== originalIsMaxAmount;\n      const isPostQuoteUpdated = current.isPostQuote !== originalIsPostQuote;\n      const isAccountOverrideUpdated =\n        current.accountOverride !== originalAccountOverride;\n      const isFiatAmountUpdated =\n        current.fiatPayment?.amountFiat !== originalFiatPaymentAmount;\n      const isFiatPaymentMethodUpdated =\n        current.fiatPayment?.selectedPaymentMethodId !==\n        originalFiatPaymentMethodId;\n\n      if (\n        isPaymentTokenUpdated ||\n        isIsMaxUpdated ||\n        isTokensUpdated ||\n        isPostQuoteUpdated ||\n        isAccountOverrideUpdated\n      ) {\n        updateSourceAmounts(\n          transactionId,\n          /* oxlint-disable typescript/no-unnecessary-type-assertion */\n          current as never,\n          /* oxlint-enable typescript/no-unnecessary-type-assertion */\n          this.messenger,\n          this.#getBalance,\n        );\n\n        shouldUpdateQuotes = true;\n      } else if (\n        isPaymentTokenBalanceUpdated &&\n        current.isMaxAmount &&\n        !current.isPostQuote\n      ) {\n        // On max the source amount is the payment token balance, so a\n        // refreshed balance must re-derive it, otherwise the amount stays at\n        // whatever the balance was when the token was selected. Quotes are not\n        // requested again here: the balance is refreshed by `updateQuotes`\n        // itself, which reads the re-derived amounts before building requests.\n        updateSourceAmounts(\n          transactionId,\n          /* oxlint-disable typescript/no-unnecessary-type-assertion */\n          current as never,\n          /* oxlint-enable typescript/no-unnecessary-type-assertion */\n          this.messenger,\n          this.#getBalance,\n        );\n      }\n\n      if (isFiatAmountUpdated || isFiatPaymentMethodUpdated) {\n        shouldUpdateQuotes = true;\n      }\n    });\n\n    if (shouldUpdateQuotes) {\n      updateQuotes({\n        getStrategies: this.#getStrategiesWithFallback.bind(this),\n        messenger: this.messenger,\n        transactionData: this.state.transactionData[transactionId],\n        transactionId,\n        updateTransactionData: this.#updateTransactionData.bind(this),\n      }).catch(noop);\n    }\n  }\n\n  #getStrategiesWithFallback(\n    transaction: TransactionMeta,\n  ): TransactionPayStrategy[] {\n    const transactionData = this.state.transactionData[transaction.id];\n\n    const strategyCandidates: unknown[] =\n      this.#getStrategies?.(transaction) ??\n      (this.#getStrategy ? [this.#getStrategy(transaction)] : []);\n\n    const validStrategies = strategyCandidates.filter(\n      (strategy): strategy is TransactionPayStrategy =>\n        isTransactionPayStrategy(strategy),\n    );\n\n    if (validStrategies.length) {\n      return validStrategies;\n    }\n\n    const paymentToken = transactionData?.paymentToken;\n\n    return getStrategyOrder(\n      this.messenger,\n      paymentToken?.chainId,\n      paymentToken?.address,\n      transaction.type,\n      transactionData?.fiatPayment?.selectedPaymentMethodId,\n    );\n  }\n}\n"]}
+{"version":3,"file":"TransactionPayController.js","sourceRoot":"","sources":["../src/TransactionPayController.ts"],"names":[],"mappings":"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","sourcesContent":["import type { StateMetadata } from '@metamask/base-controller';\nimport { BaseController } from '@metamask/base-controller';\nimport type { TransactionMeta } from '@metamask/transaction-controller';\nimport type { Draft } from 'immer';\nimport { noop } from 'lodash-es';\n\nimport { updateFiatPayment } from './actions/update-fiat-payment.js';\nimport { updatePaymentToken } from './actions/update-payment-token.js';\nimport {\n  CONTROLLER_NAME,\n  isTransactionPayStrategy,\n  TransactionPayStrategy,\n} from './constants.js';\nimport { QuoteRefresher } from './helpers/QuoteRefresher.js';\nimport type {\n  GetAmountDataCallback,\n  GetBalanceCallback,\n  GetDelegationTransactionCallback,\n  GetPaymentOverrideDataCallback,\n  IsGasFeeSponsoredCallback,\n  PolymarketCallbacks,\n  TransactionConfig,\n  TransactionConfigCallback,\n  TransactionData,\n  TransactionPayControllerMessenger,\n  TransactionPayFiatOptions,\n  TransactionPayControllerOptions,\n  TransactionPayControllerState,\n  UpdateFiatPaymentRequest,\n  UpdatePaymentTokenRequest,\n} from './types.js';\nimport { getStrategyOrder } from './utils/feature-flags.js';\nimport { updateQuotes } from './utils/quotes.js';\nimport { updateSourceAmounts } from './utils/source-amounts.js';\nimport {\n  subscribeAssetChanges,\n  subscribeTransactionChanges,\n} from './utils/transaction.js';\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'getAmountData',\n  'getDelegationTransaction',\n  'getFiatOptions',\n  'getPaymentOverrideData',\n  'getStrategy',\n  'isGasFeeSponsored',\n  'polymarketGetDepositWalletAddress',\n  'polymarketSubmitDepositWalletBatch',\n  'setTransactionConfig',\n  'updateFiatPayment',\n  'updatePaymentToken',\n] as const;\n\nconst stateMetadata: StateMetadata<TransactionPayControllerState> = {\n  transactionData: {\n    includeInDebugSnapshot: false,\n    includeInStateLogs: true,\n    persist: false,\n    usedInUi: true,\n  },\n};\n\nconst getDefaultState = (): TransactionPayControllerState => ({\n  transactionData: {},\n});\n\nexport class TransactionPayController extends BaseController<\n  typeof CONTROLLER_NAME,\n  TransactionPayControllerState,\n  TransactionPayControllerMessenger\n> {\n  readonly #fiatOptions?: TransactionPayFiatOptions;\n\n  readonly #getAmountData?: GetAmountDataCallback;\n\n  readonly #getBalance?: GetBalanceCallback;\n\n  readonly #getDelegationTransaction: GetDelegationTransactionCallback;\n\n  readonly #getPaymentOverrideData?: GetPaymentOverrideDataCallback;\n\n  readonly #getStrategy?: (\n    transaction: TransactionMeta,\n  ) => TransactionPayStrategy;\n\n  readonly #getStrategies?: (\n    transaction: TransactionMeta,\n  ) => TransactionPayStrategy[];\n\n  readonly #isGasFeeSponsored?: IsGasFeeSponsoredCallback;\n\n  readonly #polymarket?: PolymarketCallbacks;\n\n  constructor({\n    fiatOptions,\n    getAmountData,\n    getBalance,\n    getDelegationTransaction,\n    getPaymentOverrideData,\n    getStrategy,\n    getStrategies,\n    isGasFeeSponsored,\n    messenger,\n    polymarket,\n    state,\n  }: TransactionPayControllerOptions) {\n    super({\n      name: CONTROLLER_NAME,\n      metadata: stateMetadata,\n      messenger,\n      state: { ...getDefaultState(), ...state },\n    });\n\n    this.#fiatOptions = fiatOptions;\n    this.#getAmountData = getAmountData;\n    this.#getBalance = getBalance;\n    this.#getDelegationTransaction = getDelegationTransaction;\n    this.#getPaymentOverrideData = getPaymentOverrideData;\n    this.#getStrategy = getStrategy;\n    this.#getStrategies = getStrategies;\n    this.#isGasFeeSponsored = isGasFeeSponsored;\n    this.#polymarket = polymarket;\n\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n\n    subscribeTransactionChanges(\n      messenger,\n      this.#updateTransactionData.bind(this),\n      this.#removeTransactionData.bind(this),\n    );\n\n    subscribeAssetChanges(\n      messenger,\n      () => this.state,\n      this.#updateTransactionData.bind(this),\n    );\n\n    // eslint-disable-next-line no-new\n    new QuoteRefresher({\n      getStrategies: this.#getStrategiesWithFallback.bind(this),\n      messenger,\n      updateTransactionData: this.#updateTransactionData.bind(this),\n    });\n  }\n\n  /**\n   * Sets the transaction configuration.\n   *\n   * The callback receives the current configuration properties and can mutate\n   * them in place. Updated values are written back to the transaction data.\n   *\n   * @param transactionId - The ID of the transaction to configure.\n   * @param callback - A callback that receives a mutable {@link TransactionConfig} object.\n   */\n  setTransactionConfig(\n    transactionId: string,\n    callback: TransactionConfigCallback,\n  ): void {\n    this.#updateTransactionData(transactionId, (transactionData) => {\n      const config: TransactionConfig = {\n        accountOverride: transactionData.accountOverride,\n        atomic: transactionData.atomic,\n        isHyperliquidSource: transactionData.isHyperliquidSource,\n        isMaxAmount: transactionData.isMaxAmount,\n        isPolymarketDepositWallet: transactionData.isPolymarketDepositWallet,\n        isPostQuote: transactionData.isPostQuote,\n        isQuoteRequired: transactionData.isQuoteRequired,\n        paymentOverride: transactionData.paymentOverride,\n        refundTo: transactionData.refundTo,\n      };\n\n      const previousAccountOverride = config.accountOverride;\n\n      callback(config);\n\n      Object.assign(transactionData, config);\n\n      if (\n        !config.isPostQuote &&\n        config.accountOverride !== previousAccountOverride\n      ) {\n        transactionData.paymentToken = undefined;\n      }\n    });\n  }\n\n  /**\n   * Updates the payment token for a transaction.\n   *\n   * Resolves token metadata and balances, then stores the new payment token\n   * in the transaction data. This triggers recalculation of source amounts\n   * and quote retrieval.\n   *\n   * @param request - The payment token update request containing the\n   * transaction ID, token address, and chain ID.\n   */\n  updatePaymentToken(request: UpdatePaymentTokenRequest): void {\n    updatePaymentToken(request, {\n      messenger: this.messenger,\n      updateTransactionData: this.#updateTransactionData.bind(this),\n    });\n  }\n\n  /**\n   * Updates the fiat payment state for a transaction.\n   *\n   * The request callback receives the current fiat payment state and can\n   * mutate it to update properties such as the selected payment method or\n   * fiat amount.\n   *\n   * @param request - The fiat payment update request containing the\n   * transaction ID and a callback to mutate fiat payment state.\n   */\n  updateFiatPayment(request: UpdateFiatPaymentRequest): void {\n    updateFiatPayment(request, {\n      messenger: this.messenger,\n      updateTransactionData: this.#updateTransactionData.bind(this),\n    });\n  }\n\n  /**\n   * Gets the delegation transaction for a given transaction.\n   *\n   * Converts the provided transaction into a redeem delegation by delegating\n   * to the configured callback. Returns the delegation transaction data\n   * including the encoded call data, target address, value, and an optional\n   * authorization list.\n   *\n   * @param args - The arguments forwarded to the {@link GetDelegationTransactionCallback},\n   * containing the transaction metadata.\n   * @returns A promise resolving to the delegation transaction data.\n   */\n  getDelegationTransaction(\n    ...args: Parameters<GetDelegationTransactionCallback>\n  ): ReturnType<GetDelegationTransactionCallback> {\n    return this.#getDelegationTransaction(...args);\n  }\n\n  /**\n   * Returns additional transactions for the paymentOverride flow.\n   *\n   * Delegates to the client-supplied {@link GetPaymentOverrideDataCallback}.\n   * Called during quote execution when `paymentOverride` is defined on the transaction.\n   * Returns an empty array when no callback is configured.\n   *\n   * @param args - The arguments forwarded to the {@link GetPaymentOverrideDataCallback}.\n   * @returns A promise resolving to the additional transactions array.\n   */\n  getAmountData(\n    ...args: Parameters<GetAmountDataCallback>\n  ): ReturnType<GetAmountDataCallback> {\n    return this.#getAmountData?.(...args) ?? Promise.resolve({ updates: [] });\n  }\n\n  /**\n   * Determines whether the gas fee of a transaction is sponsored.\n   *\n   * Delegates to the client-supplied {@link IsGasFeeSponsoredCallback}.\n   * Returns not sponsored when no callback is configured.\n   *\n   * @param args - The arguments forwarded to the {@link IsGasFeeSponsoredCallback}.\n   * @returns A promise resolving to whether the gas fee is sponsored.\n   */\n  isGasFeeSponsored(\n    ...args: Parameters<IsGasFeeSponsoredCallback>\n  ): ReturnType<IsGasFeeSponsoredCallback> {\n    return (\n      this.#isGasFeeSponsored?.(...args) ??\n      Promise.resolve({ isGasFeeSponsored: false })\n    );\n  }\n\n  /**\n   * Returns optional fiat execution configuration.\n   *\n   * This is intentionally not stored in controller state.\n   *\n   * @returns Fiat execution options, if configured.\n   */\n  getFiatOptions(): TransactionPayFiatOptions | undefined {\n    return this.#fiatOptions;\n  }\n\n  getPaymentOverrideData(\n    ...args: Parameters<GetPaymentOverrideDataCallback>\n  ): ReturnType<GetPaymentOverrideDataCallback> {\n    return (\n      this.#getPaymentOverrideData?.(...args) ?? Promise.resolve({ calls: [] })\n    );\n  }\n\n  /**\n   * Gets the preferred strategy for a transaction.\n   *\n   * Returns the first strategy from the ordered list of strategies applicable\n   * to the given transaction. Falls back to the default strategy order derived\n   * from feature flags when no custom strategy callback is configured.\n   *\n   * @param transaction - The transaction metadata to determine the strategy for.\n   * @returns The preferred {@link TransactionPayStrategy} for the transaction.\n   */\n  getStrategy(transaction: TransactionMeta): TransactionPayStrategy {\n    return this.#getStrategiesWithFallback(transaction)[0];\n  }\n\n  /**\n   * Derives the Polymarket deposit-wallet address for an EOA via the\n   * client-supplied callback.\n   *\n   * @param args - The arguments forwarded to {@link PolymarketCallbacks.getDepositWalletAddress}.\n   * @returns A promise resolving to the deposit-wallet address.\n   */\n  polymarketGetDepositWalletAddress(\n    ...args: Parameters<PolymarketCallbacks['getDepositWalletAddress']>\n  ): ReturnType<PolymarketCallbacks['getDepositWalletAddress']> {\n    return this.#requirePolymarket().getDepositWalletAddress(...args);\n  }\n\n  /**\n   * Signs and broadcasts a Polymarket deposit-wallet batch via the\n   * client-supplied callback.\n   *\n   * @param args - The arguments forwarded to {@link PolymarketCallbacks.submitDepositWalletBatch}.\n   * @returns A promise resolving to the relayer-issued source hash.\n   */\n  polymarketSubmitDepositWalletBatch(\n    ...args: Parameters<PolymarketCallbacks['submitDepositWalletBatch']>\n  ): ReturnType<PolymarketCallbacks['submitDepositWalletBatch']> {\n    return this.#requirePolymarket().submitDepositWalletBatch(...args);\n  }\n\n  #requirePolymarket(): PolymarketCallbacks {\n    if (!this.#polymarket) {\n      throw new Error('TransactionPayController: Polymarket callbacks missing');\n    }\n    return this.#polymarket;\n  }\n\n  #removeTransactionData(transactionId: string): void {\n    this.update((state) => {\n      delete state.transactionData[transactionId];\n    });\n  }\n\n  #updateTransactionData(\n    transactionId: string,\n    fn: (transactionData: Draft<TransactionData>) => void,\n  ): void {\n    let shouldUpdateQuotes = false;\n\n    this.update((state) => {\n      const { transactionData } = state;\n      let current = transactionData[transactionId];\n      const originalPaymentToken = current?.paymentToken;\n      const originalTokens = current?.tokens;\n      const originalIsMaxAmount = current?.isMaxAmount;\n      const originalIsPostQuote = current?.isPostQuote;\n      const originalAccountOverride = current?.accountOverride;\n      const originalFiatPaymentAmount = current?.fiatPayment?.amountFiat;\n      const originalFiatPaymentMethodId =\n        current?.fiatPayment?.selectedPaymentMethodId;\n\n      if (!current) {\n        transactionData[transactionId] = {\n          fiatPayment: {},\n          isLoading: false,\n          tokens: [],\n        };\n\n        current = transactionData[transactionId];\n      }\n\n      fn(current);\n\n      const isPaymentTokenUpdated =\n        current.paymentToken?.address?.toLowerCase() !==\n          originalPaymentToken?.address?.toLowerCase() ||\n        current.paymentToken?.chainId !== originalPaymentToken?.chainId;\n\n      const isPaymentTokenBalanceUpdated =\n        current.paymentToken?.balanceRaw !== originalPaymentToken?.balanceRaw;\n\n      const isTokensUpdated = current.tokens !== originalTokens;\n      const isIsMaxUpdated = current.isMaxAmount !== originalIsMaxAmount;\n      const isPostQuoteUpdated = current.isPostQuote !== originalIsPostQuote;\n      const isAccountOverrideUpdated =\n        current.accountOverride !== originalAccountOverride;\n      const isFiatAmountUpdated =\n        current.fiatPayment?.amountFiat !== originalFiatPaymentAmount;\n      const isFiatPaymentMethodUpdated =\n        current.fiatPayment?.selectedPaymentMethodId !==\n        originalFiatPaymentMethodId;\n\n      if (\n        isPaymentTokenUpdated ||\n        isIsMaxUpdated ||\n        isTokensUpdated ||\n        isPostQuoteUpdated ||\n        isAccountOverrideUpdated\n      ) {\n        updateSourceAmounts(\n          transactionId,\n          /* oxlint-disable typescript/no-unnecessary-type-assertion */\n          current as never,\n          /* oxlint-enable typescript/no-unnecessary-type-assertion */\n          this.messenger,\n          this.#getBalance,\n        );\n\n        shouldUpdateQuotes = true;\n      } else if (\n        isPaymentTokenBalanceUpdated &&\n        current.isMaxAmount &&\n        !current.isPostQuote\n      ) {\n        // On max the source amount is the payment token balance, so a\n        // refreshed balance must re-derive it, otherwise the amount stays at\n        // whatever the balance was when the token was selected. Quotes are not\n        // requested again here: the balance is refreshed by `updateQuotes`\n        // itself, which reads the re-derived amounts before building requests.\n        updateSourceAmounts(\n          transactionId,\n          /* oxlint-disable typescript/no-unnecessary-type-assertion */\n          current as never,\n          /* oxlint-enable typescript/no-unnecessary-type-assertion */\n          this.messenger,\n          this.#getBalance,\n        );\n      }\n\n      if (isFiatAmountUpdated || isFiatPaymentMethodUpdated) {\n        shouldUpdateQuotes = true;\n      }\n    });\n\n    if (shouldUpdateQuotes) {\n      updateQuotes({\n        getStrategies: this.#getStrategiesWithFallback.bind(this),\n        messenger: this.messenger,\n        transactionData: this.state.transactionData[transactionId],\n        transactionId,\n        updateTransactionData: this.#updateTransactionData.bind(this),\n      }).catch(noop);\n    }\n  }\n\n  #getStrategiesWithFallback(\n    transaction: TransactionMeta,\n  ): TransactionPayStrategy[] {\n    const transactionData = this.state.transactionData[transaction.id];\n\n    const strategyCandidates: unknown[] =\n      this.#getStrategies?.(transaction) ??\n      (this.#getStrategy ? [this.#getStrategy(transaction)] : []);\n\n    const validStrategies = strategyCandidates.filter(\n      (strategy): strategy is TransactionPayStrategy =>\n        isTransactionPayStrategy(strategy),\n    );\n\n    if (validStrategies.length) {\n      return validStrategies;\n    }\n\n    const paymentToken = transactionData?.paymentToken;\n\n    return getStrategyOrder(\n      this.messenger,\n      paymentToken?.chainId,\n      paymentToken?.address,\n      transaction.type,\n      transactionData?.fiatPayment?.selectedPaymentMethodId,\n    );\n  }\n}\n"]}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-export type { GetAmountDataCallback, GetAmountDataRequest, GetAmountDataResponse, GetBalanceCallback, GetBalanceRequest, GetBalanceResponse, GetPaymentOverrideDataRequest, GetPaymentOverrideDataResponse, TransactionConfig, TransactionConfigCallback, TransactionData, TransactionFiatPayment, TransactionFiatPaymentCallback, TransactionPayFiatOptions, TransactionPayControllerActions, TransactionPayControllerEvents, TransactionPayControllerGetStateAction, TransactionPayControllerMessenger, TransactionPayControllerOptions, TransactionPayControllerState, PolymarketCallbacks, QuoteErrorInfo, QuoteErrorReason, TransactionPayControllerStateChangeEvent, TransactionPaymentToken, TransactionPayQuote, TransactionPayRequiredToken, TransactionPaySourceAmount, TransactionPayTotals, UpdateFiatPaymentRequest, UpdatePaymentTokenRequest, } from './types.js';
-export type { TransactionPayControllerGetAmountDataAction, TransactionPayControllerGetDelegationTransactionAction, TransactionPayControllerGetFiatOptionsAction, TransactionPayControllerGetStrategyAction, TransactionPayControllerPolymarketGetDepositWalletAddressAction, TransactionPayControllerPolymarketSubmitDepositWalletBatchAction, TransactionPayControllerSetTransactionConfigAction, TransactionPayControllerUpdatePaymentTokenAction, TransactionPayControllerUpdateFiatPaymentAction, } from './TransactionPayController-method-action-types.js';
+export type { GetAmountDataCallback, GetAmountDataRequest, GetAmountDataResponse, GetBalanceCallback, GetBalanceRequest, GetBalanceResponse, GetPaymentOverrideDataRequest, GetPaymentOverrideDataResponse, IsGasFeeSponsoredCallback, TransactionConfig, TransactionConfigCallback, TransactionData, TransactionFiatPayment, TransactionFiatPaymentCallback, TransactionPayFiatOptions, TransactionPayControllerActions, TransactionPayControllerEvents, TransactionPayControllerGetStateAction, TransactionPayControllerMessenger, TransactionPayControllerOptions, TransactionPayControllerState, PolymarketCallbacks, QuoteErrorInfo, QuoteErrorReason, TransactionPayControllerStateChangeEvent, TransactionPaymentToken, TransactionPayQuote, TransactionPayRequiredToken, TransactionPaySourceAmount, TransactionPayTotals, UpdateFiatPaymentRequest, UpdatePaymentTokenRequest, } from './types.js';
+export type { TransactionPayControllerGetAmountDataAction, TransactionPayControllerGetDelegationTransactionAction, TransactionPayControllerGetFiatOptionsAction, TransactionPayControllerGetStrategyAction, TransactionPayControllerIsGasFeeSponsoredAction, TransactionPayControllerPolymarketGetDepositWalletAddressAction, TransactionPayControllerPolymarketSubmitDepositWalletBatchAction, TransactionPayControllerSetTransactionConfigAction, TransactionPayControllerUpdatePaymentTokenAction, TransactionPayControllerUpdateFiatPaymentAction, } from './TransactionPayController-method-action-types.js';
 export { PaymentOverride, TransactionPayStrategy } from './constants.js';
 export { TransactionPayController } from './TransactionPayController.js';
 export { TransactionPayPublishHook } from './helpers/TransactionPayPublishHook.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,6BAA6B,EAC7B,8BAA8B,EAC9B,iBAAiB,EACjB,yBAAyB,EACzB,eAAe,EACf,sBAAsB,EACtB,8BAA8B,EAC9B,yBAAyB,EACzB,+BAA+B,EAC/B,8BAA8B,EAC9B,sCAAsC,EACtC,iCAAiC,EACjC,+BAA+B,EAC/B,6BAA6B,EAC7B,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,wCAAwC,EACxC,uBAAuB,EACvB,mBAAmB,EACnB,2BAA2B,EAC3B,0BAA0B,EAC1B,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,2CAA2C,EAC3C,sDAAsD,EACtD,4CAA4C,EAC5C,yCAAyC,EACzC,+DAA+D,EAC/D,gEAAgE,EAChE,kDAAkD,EAClD,gDAAgD,EAChD,+CAA+C,GAChD,MAAM,mDAAmD,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,6BAA6B,EAC7B,8BAA8B,EAC9B,yBAAyB,EACzB,iBAAiB,EACjB,yBAAyB,EACzB,eAAe,EACf,sBAAsB,EACtB,8BAA8B,EAC9B,yBAAyB,EACzB,+BAA+B,EAC/B,8BAA8B,EAC9B,sCAAsC,EACtC,iCAAiC,EACjC,+BAA+B,EAC/B,6BAA6B,EAC7B,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,wCAAwC,EACxC,uBAAuB,EACvB,mBAAmB,EACnB,2BAA2B,EAC3B,0BAA0B,EAC1B,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,2CAA2C,EAC3C,sDAAsD,EACtD,4CAA4C,EAC5C,yCAAyC,EACzC,+CAA+C,EAC/C,+DAA+D,EAC/D,gEAAgE,EAChE,kDAAkD,EAClD,gDAAgD,EAChD,+CAA+C,GAChD,MAAM,mDAAmD,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA4CA,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC","sourcesContent":["export type {\n  GetAmountDataCallback,\n  GetAmountDataRequest,\n  GetAmountDataResponse,\n  GetBalanceCallback,\n  GetBalanceRequest,\n  GetBalanceResponse,\n  GetPaymentOverrideDataRequest,\n  GetPaymentOverrideDataResponse,\n  TransactionConfig,\n  TransactionConfigCallback,\n  TransactionData,\n  TransactionFiatPayment,\n  TransactionFiatPaymentCallback,\n  TransactionPayFiatOptions,\n  TransactionPayControllerActions,\n  TransactionPayControllerEvents,\n  TransactionPayControllerGetStateAction,\n  TransactionPayControllerMessenger,\n  TransactionPayControllerOptions,\n  TransactionPayControllerState,\n  PolymarketCallbacks,\n  QuoteErrorInfo,\n  QuoteErrorReason,\n  TransactionPayControllerStateChangeEvent,\n  TransactionPaymentToken,\n  TransactionPayQuote,\n  TransactionPayRequiredToken,\n  TransactionPaySourceAmount,\n  TransactionPayTotals,\n  UpdateFiatPaymentRequest,\n  UpdatePaymentTokenRequest,\n} from './types.js';\nexport type {\n  TransactionPayControllerGetAmountDataAction,\n  TransactionPayControllerGetDelegationTransactionAction,\n  TransactionPayControllerGetFiatOptionsAction,\n  TransactionPayControllerGetStrategyAction,\n  TransactionPayControllerPolymarketGetDepositWalletAddressAction,\n  TransactionPayControllerPolymarketSubmitDepositWalletBatchAction,\n  TransactionPayControllerSetTransactionConfigAction,\n  TransactionPayControllerUpdatePaymentTokenAction,\n  TransactionPayControllerUpdateFiatPaymentAction,\n} from './TransactionPayController-method-action-types.js';\nexport { PaymentOverride, TransactionPayStrategy } from './constants.js';\nexport { TransactionPayController } from './TransactionPayController.js';\nexport { TransactionPayPublishHook } from './helpers/TransactionPayPublishHook.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA8CA,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC","sourcesContent":["export type {\n  GetAmountDataCallback,\n  GetAmountDataRequest,\n  GetAmountDataResponse,\n  GetBalanceCallback,\n  GetBalanceRequest,\n  GetBalanceResponse,\n  GetPaymentOverrideDataRequest,\n  GetPaymentOverrideDataResponse,\n  IsGasFeeSponsoredCallback,\n  TransactionConfig,\n  TransactionConfigCallback,\n  TransactionData,\n  TransactionFiatPayment,\n  TransactionFiatPaymentCallback,\n  TransactionPayFiatOptions,\n  TransactionPayControllerActions,\n  TransactionPayControllerEvents,\n  TransactionPayControllerGetStateAction,\n  TransactionPayControllerMessenger,\n  TransactionPayControllerOptions,\n  TransactionPayControllerState,\n  PolymarketCallbacks,\n  QuoteErrorInfo,\n  QuoteErrorReason,\n  TransactionPayControllerStateChangeEvent,\n  TransactionPaymentToken,\n  TransactionPayQuote,\n  TransactionPayRequiredToken,\n  TransactionPaySourceAmount,\n  TransactionPayTotals,\n  UpdateFiatPaymentRequest,\n  UpdatePaymentTokenRequest,\n} from './types.js';\nexport type {\n  TransactionPayControllerGetAmountDataAction,\n  TransactionPayControllerGetDelegationTransactionAction,\n  TransactionPayControllerGetFiatOptionsAction,\n  TransactionPayControllerGetStrategyAction,\n  TransactionPayControllerIsGasFeeSponsoredAction,\n  TransactionPayControllerPolymarketGetDepositWalletAddressAction,\n  TransactionPayControllerPolymarketSubmitDepositWalletBatchAction,\n  TransactionPayControllerSetTransactionConfigAction,\n  TransactionPayControllerUpdatePaymentTokenAction,\n  TransactionPayControllerUpdateFiatPaymentAction,\n} from './TransactionPayController-method-action-types.js';\nexport { PaymentOverride, TransactionPayStrategy } from './constants.js';\nexport { TransactionPayController } from './TransactionPayController.js';\nexport { TransactionPayPublishHook } from './helpers/TransactionPayPublishHook.js';\n"]}

package/dist/strategy/relay/relay-quotes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"relay-quotes.d.ts","sourceRoot":"","sources":["../../../src/strategy/relay/relay-quotes.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAGV,2BAA2B,EAG3B,mBAAmB,EACpB,MAAM,gBAAgB,CAAC;AAyCxB,OAAO,KAAK,EACV,UAAU,EAIX,MAAM,YAAY,CAAC;AAuBpB;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,mBAAmB,CAAC,UAAU,CAAC,EAAE,CAAC,CAsE5C"}
+{"version":3,"file":"relay-quotes.d.ts","sourceRoot":"","sources":["../../../src/strategy/relay/relay-quotes.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAGV,2BAA2B,EAG3B,mBAAmB,EACpB,MAAM,gBAAgB,CAAC;AA0CxB,OAAO,KAAK,EACV,UAAU,EAIX,MAAM,YAAY,CAAC;AAuBpB;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,mBAAmB,CAAC,UAAU,CAAC,EAAE,CAAC,CAsE5C"}

package/dist/strategy/relay/relay-quotes.js

@@ -8,7 +8,7 @@ import { TransactionPayStrategy } from '../../index.js';
 import { projectLogger } from '../../logger.js';
 import { getFiatValueFromUsd } from '../../utils/amounts.js';
 import { getFeatureFlags, getRelayOriginGasOverhead, getSlippage, getStablecoins, isAtomicMaxEnabled, isEIP7702Chain, isRelayExecuteEnabled, } from '../../utils/feature-flags.js';
-import { GasPaymentMode, resolveGasPayment, resolveGasStationCost, } from '../../utils/gas-payment.js';
+import { GasPaymentMode, getGasFeeSponsorship, resolveGasPayment, resolveGasStationCost, } from '../../utils/gas-payment.js';
 import { calculateGasCost } from '../../utils/gas.js';
 import { estimateQuoteGasLimits } from '../../utils/quote-gas.js';
 import { resolveNonAtomicRecipient } from '../../utils/second-leg.js';
@@ -411,7 +411,7 @@ async function normalizeQuote(quote, request, fullRequest) {
         ? activationFeeUsd
         : calculateProviderFee(quote).minus(appFeeUsd).plus(activationFeeUsd);
     const provider = getFiatValueFromUsd(providerFeeUsd, usdToFiatRate);
-    const { gasLimits, is7702, isGasFeeToken: isSourceGasFeeToken, ...sourceNetwork } = await calculateSourceNetworkCost(quote, messenger, request, fullRequest.transaction, fullRequest.accountSupports7702);
+    const { gasLimits, is7702, isGasFeeToken: isSourceGasFeeToken, isSourceGasFeeSponsored, ...sourceNetwork } = await calculateSourceNetworkCost(quote, messenger, request, fullRequest.transaction, fullRequest.accountSupports7702);
     const targetNetwork = {
         usd: '0',
         fiat: '0',
@@ -430,6 +430,7 @@ async function normalizeQuote(quote, request, fullRequest) {
         ...quote.metamask,
         gasLimits: is7702 ? [gasLimits[0]] : gasLimits,
         is7702,
+        ...(isSourceGasFeeSponsored ? { isSourceGasFeeSponsored } : {}),
     };
     return {
         dust,
@@ -524,14 +525,16 @@ async function calculateSourceNetworkCost(quote, messenger, request, transaction
     const isExecuteFlow = Boolean(quote.metamask?.isExecute);
     const isHyperliquidWithdrawal = Boolean(request.isHyperliquidSource);
     const isPolymarketDepositWallet = Boolean(request.isPolymarketDepositWallet);
+    const isGasFeeSponsored = await getGasFeeSponsorship({
+        accountSupports7702,
+        messenger,
+        request,
+        transaction,
+    });
     const gasPayment = resolveGasPayment({
         isDelegated: isExecuteFlow || isHyperliquidWithdrawal || isPolymarketDepositWallet,
+        isGasFeeSponsored,
         sourceTokenAddress,
-        sponsorship: {
-            accountSupports7702,
-            request,
-            transaction,
-        },
     });
     if (gasPayment.mode === GasPaymentMode.Delegation) {
         log('Zeroing network fees as the user does not pay origin gas', {
@@ -555,6 +558,7 @@ async function calculateSourceNetworkCost(quote, messenger, request, transaction
             max: ZERO_AMOUNT,
             gasLimits: [0],
             is7702: true,
+            isSourceGasFeeSponsored: true,
         };
     }
     const txSteps = quote.steps.filter((step) => step.kind === 'transaction');