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

package/dist/TransactionPayController.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransactionPayController.cjs","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';\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 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          current as never,\n          this.messenger,\n          this.#getBalance,\n        );\n\n        shouldUpdateQuotes = true;\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/TransactionPayController.d.cts

@@ -0,0 +1,101 @@
+import { BaseController } from "@metamask/base-controller";
+import type { TransactionMeta } from "@metamask/transaction-controller";
+import { CONTROLLER_NAME, TransactionPayStrategy } from "./constants.cjs";
+import type { GetAmountDataCallback, GetDelegationTransactionCallback, GetPaymentOverrideDataCallback, PolymarketCallbacks, TransactionConfigCallback, TransactionPayControllerMessenger, TransactionPayFiatOptions, TransactionPayControllerOptions, TransactionPayControllerState, UpdateFiatPaymentRequest, UpdatePaymentTokenRequest } from "./types.cjs";
+export declare class TransactionPayController extends BaseController<typeof CONTROLLER_NAME, TransactionPayControllerState, TransactionPayControllerMessenger> {
+    #private;
+    constructor({ fiatOptions, getAmountData, getBalance, getDelegationTransaction, getPaymentOverrideData, getStrategy, getStrategies, messenger, polymarket, state, }: TransactionPayControllerOptions);
+    /**
+     * Sets the transaction configuration.
+     *
+     * The callback receives the current configuration properties and can mutate
+     * them in place. Updated values are written back to the transaction data.
+     *
+     * @param transactionId - The ID of the transaction to configure.
+     * @param callback - A callback that receives a mutable {@link TransactionConfig} object.
+     */
+    setTransactionConfig(transactionId: string, callback: TransactionConfigCallback): void;
+    /**
+     * Updates the payment token for a transaction.
+     *
+     * Resolves token metadata and balances, then stores the new payment token
+     * in the transaction data. This triggers recalculation of source amounts
+     * and quote retrieval.
+     *
+     * @param request - The payment token update request containing the
+     * transaction ID, token address, and chain ID.
+     */
+    updatePaymentToken(request: UpdatePaymentTokenRequest): void;
+    /**
+     * Updates the fiat payment state for a transaction.
+     *
+     * The request callback receives the current fiat payment state and can
+     * mutate it to update properties such as the selected payment method or
+     * fiat amount.
+     *
+     * @param request - The fiat payment update request containing the
+     * transaction ID and a callback to mutate fiat payment state.
+     */
+    updateFiatPayment(request: UpdateFiatPaymentRequest): void;
+    /**
+     * Gets the delegation transaction for a given transaction.
+     *
+     * Converts the provided transaction into a redeem delegation by delegating
+     * to the configured callback. Returns the delegation transaction data
+     * including the encoded call data, target address, value, and an optional
+     * authorization list.
+     *
+     * @param args - The arguments forwarded to the {@link GetDelegationTransactionCallback},
+     * containing the transaction metadata.
+     * @returns A promise resolving to the delegation transaction data.
+     */
+    getDelegationTransaction(...args: Parameters<GetDelegationTransactionCallback>): ReturnType<GetDelegationTransactionCallback>;
+    /**
+     * Returns additional transactions for the paymentOverride flow.
+     *
+     * Delegates to the client-supplied {@link GetPaymentOverrideDataCallback}.
+     * Called during quote execution when `paymentOverride` is defined on the transaction.
+     * Returns an empty array when no callback is configured.
+     *
+     * @param args - The arguments forwarded to the {@link GetPaymentOverrideDataCallback}.
+     * @returns A promise resolving to the additional transactions array.
+     */
+    getAmountData(...args: Parameters<GetAmountDataCallback>): ReturnType<GetAmountDataCallback>;
+    /**
+     * Returns optional fiat execution configuration.
+     *
+     * This is intentionally not stored in controller state.
+     *
+     * @returns Fiat execution options, if configured.
+     */
+    getFiatOptions(): TransactionPayFiatOptions | undefined;
+    getPaymentOverrideData(...args: Parameters<GetPaymentOverrideDataCallback>): ReturnType<GetPaymentOverrideDataCallback>;
+    /**
+     * Gets the preferred strategy for a transaction.
+     *
+     * Returns the first strategy from the ordered list of strategies applicable
+     * to the given transaction. Falls back to the default strategy order derived
+     * from feature flags when no custom strategy callback is configured.
+     *
+     * @param transaction - The transaction metadata to determine the strategy for.
+     * @returns The preferred {@link TransactionPayStrategy} for the transaction.
+     */
+    getStrategy(transaction: TransactionMeta): TransactionPayStrategy;
+    /**
+     * Derives the Polymarket deposit-wallet address for an EOA via the
+     * client-supplied callback.
+     *
+     * @param args - The arguments forwarded to {@link PolymarketCallbacks.getDepositWalletAddress}.
+     * @returns A promise resolving to the deposit-wallet address.
+     */
+    polymarketGetDepositWalletAddress(...args: Parameters<PolymarketCallbacks['getDepositWalletAddress']>): ReturnType<PolymarketCallbacks['getDepositWalletAddress']>;
+    /**
+     * Signs and broadcasts a Polymarket deposit-wallet batch via the
+     * client-supplied callback.
+     *
+     * @param args - The arguments forwarded to {@link PolymarketCallbacks.submitDepositWalletBatch}.
+     * @returns A promise resolving to the relayer-issued source hash.
+     */
+    polymarketSubmitDepositWalletBatch(...args: Parameters<PolymarketCallbacks['submitDepositWalletBatch']>): ReturnType<PolymarketCallbacks['submitDepositWalletBatch']>;
+}
+//# sourceMappingURL=TransactionPayController.d.cts.map

package/dist/TransactionPayController.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransactionPayController.d.cts","sourceRoot":"","sources":["../src/TransactionPayController.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,kCAAkC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,yCAAyC;AAMxE,OAAO,EACL,eAAe,EAEf,sBAAsB,EACvB,wBAAuB;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,oBAAmB;AAmCpB,qBAAa,wBAAyB,SAAQ,cAAc,CAC1D,OAAO,eAAe,EACtB,6BAA6B,EAC7B,iCAAiC,CAClC;;gBAqBa,EACV,WAAW,EACX,aAAa,EACb,UAAU,EACV,wBAAwB,EACxB,sBAAsB,EACtB,WAAW,EACX,aAAa,EACb,SAAS,EACT,UAAU,EACV,KAAK,GACN,EAAE,+BAA+B;IA0ClC;;;;;;;;OAQG;IACH,oBAAoB,CAClB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,yBAAyB,GAClC,IAAI;IA6BP;;;;;;;;;OASG;IACH,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,IAAI;IAO5D;;;;;;;;;OASG;IACH,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI;IAO1D;;;;;;;;;;;OAWG;IACH,wBAAwB,CACtB,GAAG,IAAI,EAAE,UAAU,CAAC,gCAAgC,CAAC,GACpD,UAAU,CAAC,gCAAgC,CAAC;IAI/C;;;;;;;;;OASG;IACH,aAAa,CACX,GAAG,IAAI,EAAE,UAAU,CAAC,qBAAqB,CAAC,GACzC,UAAU,CAAC,qBAAqB,CAAC;IAIpC;;;;;;OAMG;IACH,cAAc,IAAI,yBAAyB,GAAG,SAAS;IAIvD,sBAAsB,CACpB,GAAG,IAAI,EAAE,UAAU,CAAC,8BAA8B,CAAC,GAClD,UAAU,CAAC,8BAA8B,CAAC;IAM7C;;;;;;;;;OASG;IACH,WAAW,CAAC,WAAW,EAAE,eAAe,GAAG,sBAAsB;IAIjE;;;;;;OAMG;IACH,iCAAiC,CAC/B,GAAG,IAAI,EAAE,UAAU,CAAC,mBAAmB,CAAC,yBAAyB,CAAC,CAAC,GAClE,UAAU,CAAC,mBAAmB,CAAC,yBAAyB,CAAC,CAAC;IAI7D;;;;;;OAMG;IACH,kCAAkC,CAChC,GAAG,IAAI,EAAE,UAAU,CAAC,mBAAmB,CAAC,0BAA0B,CAAC,CAAC,GACnE,UAAU,CAAC,mBAAmB,CAAC,0BAA0B,CAAC,CAAC;CA4H/D"}

package/dist/TransactionPayController.d.mts

@@ -0,0 +1,101 @@
+import { BaseController } from "@metamask/base-controller";
+import type { TransactionMeta } from "@metamask/transaction-controller";
+import { CONTROLLER_NAME, TransactionPayStrategy } from "./constants.mjs";
+import type { GetAmountDataCallback, GetDelegationTransactionCallback, GetPaymentOverrideDataCallback, PolymarketCallbacks, TransactionConfigCallback, TransactionPayControllerMessenger, TransactionPayFiatOptions, TransactionPayControllerOptions, TransactionPayControllerState, UpdateFiatPaymentRequest, UpdatePaymentTokenRequest } from "./types.mjs";
+export declare class TransactionPayController extends BaseController<typeof CONTROLLER_NAME, TransactionPayControllerState, TransactionPayControllerMessenger> {
+    #private;
+    constructor({ fiatOptions, getAmountData, getBalance, getDelegationTransaction, getPaymentOverrideData, getStrategy, getStrategies, messenger, polymarket, state, }: TransactionPayControllerOptions);
+    /**
+     * Sets the transaction configuration.
+     *
+     * The callback receives the current configuration properties and can mutate
+     * them in place. Updated values are written back to the transaction data.
+     *
+     * @param transactionId - The ID of the transaction to configure.
+     * @param callback - A callback that receives a mutable {@link TransactionConfig} object.
+     */
+    setTransactionConfig(transactionId: string, callback: TransactionConfigCallback): void;
+    /**
+     * Updates the payment token for a transaction.
+     *
+     * Resolves token metadata and balances, then stores the new payment token
+     * in the transaction data. This triggers recalculation of source amounts
+     * and quote retrieval.
+     *
+     * @param request - The payment token update request containing the
+     * transaction ID, token address, and chain ID.
+     */
+    updatePaymentToken(request: UpdatePaymentTokenRequest): void;
+    /**
+     * Updates the fiat payment state for a transaction.
+     *
+     * The request callback receives the current fiat payment state and can
+     * mutate it to update properties such as the selected payment method or
+     * fiat amount.
+     *
+     * @param request - The fiat payment update request containing the
+     * transaction ID and a callback to mutate fiat payment state.
+     */
+    updateFiatPayment(request: UpdateFiatPaymentRequest): void;
+    /**
+     * Gets the delegation transaction for a given transaction.
+     *
+     * Converts the provided transaction into a redeem delegation by delegating
+     * to the configured callback. Returns the delegation transaction data
+     * including the encoded call data, target address, value, and an optional
+     * authorization list.
+     *
+     * @param args - The arguments forwarded to the {@link GetDelegationTransactionCallback},
+     * containing the transaction metadata.
+     * @returns A promise resolving to the delegation transaction data.
+     */
+    getDelegationTransaction(...args: Parameters<GetDelegationTransactionCallback>): ReturnType<GetDelegationTransactionCallback>;
+    /**
+     * Returns additional transactions for the paymentOverride flow.
+     *
+     * Delegates to the client-supplied {@link GetPaymentOverrideDataCallback}.
+     * Called during quote execution when `paymentOverride` is defined on the transaction.
+     * Returns an empty array when no callback is configured.
+     *
+     * @param args - The arguments forwarded to the {@link GetPaymentOverrideDataCallback}.
+     * @returns A promise resolving to the additional transactions array.
+     */
+    getAmountData(...args: Parameters<GetAmountDataCallback>): ReturnType<GetAmountDataCallback>;
+    /**
+     * Returns optional fiat execution configuration.
+     *
+     * This is intentionally not stored in controller state.
+     *
+     * @returns Fiat execution options, if configured.
+     */
+    getFiatOptions(): TransactionPayFiatOptions | undefined;
+    getPaymentOverrideData(...args: Parameters<GetPaymentOverrideDataCallback>): ReturnType<GetPaymentOverrideDataCallback>;
+    /**
+     * Gets the preferred strategy for a transaction.
+     *
+     * Returns the first strategy from the ordered list of strategies applicable
+     * to the given transaction. Falls back to the default strategy order derived
+     * from feature flags when no custom strategy callback is configured.
+     *
+     * @param transaction - The transaction metadata to determine the strategy for.
+     * @returns The preferred {@link TransactionPayStrategy} for the transaction.
+     */
+    getStrategy(transaction: TransactionMeta): TransactionPayStrategy;
+    /**
+     * Derives the Polymarket deposit-wallet address for an EOA via the
+     * client-supplied callback.
+     *
+     * @param args - The arguments forwarded to {@link PolymarketCallbacks.getDepositWalletAddress}.
+     * @returns A promise resolving to the deposit-wallet address.
+     */
+    polymarketGetDepositWalletAddress(...args: Parameters<PolymarketCallbacks['getDepositWalletAddress']>): ReturnType<PolymarketCallbacks['getDepositWalletAddress']>;
+    /**
+     * Signs and broadcasts a Polymarket deposit-wallet batch via the
+     * client-supplied callback.
+     *
+     * @param args - The arguments forwarded to {@link PolymarketCallbacks.submitDepositWalletBatch}.
+     * @returns A promise resolving to the relayer-issued source hash.
+     */
+    polymarketSubmitDepositWalletBatch(...args: Parameters<PolymarketCallbacks['submitDepositWalletBatch']>): ReturnType<PolymarketCallbacks['submitDepositWalletBatch']>;
+}
+//# sourceMappingURL=TransactionPayController.d.mts.map

package/dist/TransactionPayController.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransactionPayController.d.mts","sourceRoot":"","sources":["../src/TransactionPayController.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,kCAAkC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,yCAAyC;AAMxE,OAAO,EACL,eAAe,EAEf,sBAAsB,EACvB,wBAAuB;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,oBAAmB;AAmCpB,qBAAa,wBAAyB,SAAQ,cAAc,CAC1D,OAAO,eAAe,EACtB,6BAA6B,EAC7B,iCAAiC,CAClC;;gBAqBa,EACV,WAAW,EACX,aAAa,EACb,UAAU,EACV,wBAAwB,EACxB,sBAAsB,EACtB,WAAW,EACX,aAAa,EACb,SAAS,EACT,UAAU,EACV,KAAK,GACN,EAAE,+BAA+B;IA0ClC;;;;;;;;OAQG;IACH,oBAAoB,CAClB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,yBAAyB,GAClC,IAAI;IA6BP;;;;;;;;;OASG;IACH,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,IAAI;IAO5D;;;;;;;;;OASG;IACH,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI;IAO1D;;;;;;;;;;;OAWG;IACH,wBAAwB,CACtB,GAAG,IAAI,EAAE,UAAU,CAAC,gCAAgC,CAAC,GACpD,UAAU,CAAC,gCAAgC,CAAC;IAI/C;;;;;;;;;OASG;IACH,aAAa,CACX,GAAG,IAAI,EAAE,UAAU,CAAC,qBAAqB,CAAC,GACzC,UAAU,CAAC,qBAAqB,CAAC;IAIpC;;;;;;OAMG;IACH,cAAc,IAAI,yBAAyB,GAAG,SAAS;IAIvD,sBAAsB,CACpB,GAAG,IAAI,EAAE,UAAU,CAAC,8BAA8B,CAAC,GAClD,UAAU,CAAC,8BAA8B,CAAC;IAM7C;;;;;;;;;OASG;IACH,WAAW,CAAC,WAAW,EAAE,eAAe,GAAG,sBAAsB;IAIjE;;;;;;OAMG;IACH,iCAAiC,CAC/B,GAAG,IAAI,EAAE,UAAU,CAAC,mBAAmB,CAAC,yBAAyB,CAAC,CAAC,GAClE,UAAU,CAAC,mBAAmB,CAAC,yBAAyB,CAAC,CAAC;IAI7D;;;;;;OAMG;IACH,kCAAkC,CAChC,GAAG,IAAI,EAAE,UAAU,CAAC,mBAAmB,CAAC,0BAA0B,CAAC,CAAC,GACnE,UAAU,CAAC,mBAAmB,CAAC,0BAA0B,CAAC,CAAC;CA4H/D"}

package/dist/TransactionPayController.mjs

@@ -0,0 +1,292 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _TransactionPayController_instances, _TransactionPayController_fiatOptions, _TransactionPayController_getAmountData, _TransactionPayController_getBalance, _TransactionPayController_getDelegationTransaction, _TransactionPayController_getPaymentOverrideData, _TransactionPayController_getStrategy, _TransactionPayController_getStrategies, _TransactionPayController_polymarket, _TransactionPayController_requirePolymarket, _TransactionPayController_removeTransactionData, _TransactionPayController_updateTransactionData, _TransactionPayController_getStrategiesWithFallback;
+import { BaseController } from "@metamask/base-controller";
+import $lodash from "lodash";
+const { noop } = $lodash;
+import { updateFiatPayment } from "./actions/update-fiat-payment.mjs";
+import { updatePaymentToken } from "./actions/update-payment-token.mjs";
+import { CONTROLLER_NAME, isTransactionPayStrategy, TransactionPayStrategy } from "./constants.mjs";
+import { QuoteRefresher } from "./helpers/QuoteRefresher.mjs";
+import { getStrategyOrder } from "./utils/feature-flags.mjs";
+import { updateQuotes } from "./utils/quotes.mjs";
+import { updateSourceAmounts } from "./utils/source-amounts.mjs";
+import { subscribeAssetChanges, subscribeTransactionChanges } from "./utils/transaction.mjs";
+const MESSENGER_EXPOSED_METHODS = [
+    'getAmountData',
+    'getDelegationTransaction',
+    'getFiatOptions',
+    'getPaymentOverrideData',
+    'getStrategy',
+    'polymarketGetDepositWalletAddress',
+    'polymarketSubmitDepositWalletBatch',
+    'setTransactionConfig',
+    'updateFiatPayment',
+    'updatePaymentToken',
+];
+const stateMetadata = {
+    transactionData: {
+        includeInDebugSnapshot: false,
+        includeInStateLogs: true,
+        persist: false,
+        usedInUi: true,
+    },
+};
+const getDefaultState = () => ({
+    transactionData: {},
+});
+export class TransactionPayController extends BaseController {
+    constructor({ fiatOptions, getAmountData, getBalance, getDelegationTransaction, getPaymentOverrideData, getStrategy, getStrategies, messenger, polymarket, state, }) {
+        super({
+            name: CONTROLLER_NAME,
+            metadata: stateMetadata,
+            messenger,
+            state: { ...getDefaultState(), ...state },
+        });
+        _TransactionPayController_instances.add(this);
+        _TransactionPayController_fiatOptions.set(this, void 0);
+        _TransactionPayController_getAmountData.set(this, void 0);
+        _TransactionPayController_getBalance.set(this, void 0);
+        _TransactionPayController_getDelegationTransaction.set(this, void 0);
+        _TransactionPayController_getPaymentOverrideData.set(this, void 0);
+        _TransactionPayController_getStrategy.set(this, void 0);
+        _TransactionPayController_getStrategies.set(this, void 0);
+        _TransactionPayController_polymarket.set(this, void 0);
+        __classPrivateFieldSet(this, _TransactionPayController_fiatOptions, fiatOptions, "f");
+        __classPrivateFieldSet(this, _TransactionPayController_getAmountData, getAmountData, "f");
+        __classPrivateFieldSet(this, _TransactionPayController_getBalance, getBalance, "f");
+        __classPrivateFieldSet(this, _TransactionPayController_getDelegationTransaction, getDelegationTransaction, "f");
+        __classPrivateFieldSet(this, _TransactionPayController_getPaymentOverrideData, getPaymentOverrideData, "f");
+        __classPrivateFieldSet(this, _TransactionPayController_getStrategy, getStrategy, "f");
+        __classPrivateFieldSet(this, _TransactionPayController_getStrategies, getStrategies, "f");
+        __classPrivateFieldSet(this, _TransactionPayController_polymarket, polymarket, "f");
+        this.messenger.registerMethodActionHandlers(this, MESSENGER_EXPOSED_METHODS);
+        subscribeTransactionChanges(messenger, __classPrivateFieldGet(this, _TransactionPayController_instances, "m", _TransactionPayController_updateTransactionData).bind(this), __classPrivateFieldGet(this, _TransactionPayController_instances, "m", _TransactionPayController_removeTransactionData).bind(this));
+        subscribeAssetChanges(messenger, () => this.state, __classPrivateFieldGet(this, _TransactionPayController_instances, "m", _TransactionPayController_updateTransactionData).bind(this));
+        // eslint-disable-next-line no-new
+        new QuoteRefresher({
+            getStrategies: __classPrivateFieldGet(this, _TransactionPayController_instances, "m", _TransactionPayController_getStrategiesWithFallback).bind(this),
+            messenger,
+            updateTransactionData: __classPrivateFieldGet(this, _TransactionPayController_instances, "m", _TransactionPayController_updateTransactionData).bind(this),
+        });
+    }
+    /**
+     * Sets the transaction configuration.
+     *
+     * The callback receives the current configuration properties and can mutate
+     * them in place. Updated values are written back to the transaction data.
+     *
+     * @param transactionId - The ID of the transaction to configure.
+     * @param callback - A callback that receives a mutable {@link TransactionConfig} object.
+     */
+    setTransactionConfig(transactionId, callback) {
+        __classPrivateFieldGet(this, _TransactionPayController_instances, "m", _TransactionPayController_updateTransactionData).call(this, transactionId, (transactionData) => {
+            const config = {
+                accountOverride: transactionData.accountOverride,
+                atomic: transactionData.atomic,
+                isHyperliquidSource: transactionData.isHyperliquidSource,
+                isMaxAmount: transactionData.isMaxAmount,
+                isPolymarketDepositWallet: transactionData.isPolymarketDepositWallet,
+                isPostQuote: transactionData.isPostQuote,
+                isQuoteRequired: transactionData.isQuoteRequired,
+                paymentOverride: transactionData.paymentOverride,
+                refundTo: transactionData.refundTo,
+            };
+            const previousAccountOverride = config.accountOverride;
+            callback(config);
+            Object.assign(transactionData, config);
+            if (!config.isPostQuote &&
+                config.accountOverride !== previousAccountOverride) {
+                transactionData.paymentToken = undefined;
+            }
+        });
+    }
+    /**
+     * Updates the payment token for a transaction.
+     *
+     * Resolves token metadata and balances, then stores the new payment token
+     * in the transaction data. This triggers recalculation of source amounts
+     * and quote retrieval.
+     *
+     * @param request - The payment token update request containing the
+     * transaction ID, token address, and chain ID.
+     */
+    updatePaymentToken(request) {
+        updatePaymentToken(request, {
+            messenger: this.messenger,
+            updateTransactionData: __classPrivateFieldGet(this, _TransactionPayController_instances, "m", _TransactionPayController_updateTransactionData).bind(this),
+        });
+    }
+    /**
+     * Updates the fiat payment state for a transaction.
+     *
+     * The request callback receives the current fiat payment state and can
+     * mutate it to update properties such as the selected payment method or
+     * fiat amount.
+     *
+     * @param request - The fiat payment update request containing the
+     * transaction ID and a callback to mutate fiat payment state.
+     */
+    updateFiatPayment(request) {
+        updateFiatPayment(request, {
+            messenger: this.messenger,
+            updateTransactionData: __classPrivateFieldGet(this, _TransactionPayController_instances, "m", _TransactionPayController_updateTransactionData).bind(this),
+        });
+    }
+    /**
+     * Gets the delegation transaction for a given transaction.
+     *
+     * Converts the provided transaction into a redeem delegation by delegating
+     * to the configured callback. Returns the delegation transaction data
+     * including the encoded call data, target address, value, and an optional
+     * authorization list.
+     *
+     * @param args - The arguments forwarded to the {@link GetDelegationTransactionCallback},
+     * containing the transaction metadata.
+     * @returns A promise resolving to the delegation transaction data.
+     */
+    getDelegationTransaction(...args) {
+        return __classPrivateFieldGet(this, _TransactionPayController_getDelegationTransaction, "f").call(this, ...args);
+    }
+    /**
+     * Returns additional transactions for the paymentOverride flow.
+     *
+     * Delegates to the client-supplied {@link GetPaymentOverrideDataCallback}.
+     * Called during quote execution when `paymentOverride` is defined on the transaction.
+     * Returns an empty array when no callback is configured.
+     *
+     * @param args - The arguments forwarded to the {@link GetPaymentOverrideDataCallback}.
+     * @returns A promise resolving to the additional transactions array.
+     */
+    getAmountData(...args) {
+        return __classPrivateFieldGet(this, _TransactionPayController_getAmountData, "f")?.call(this, ...args) ?? Promise.resolve({ updates: [] });
+    }
+    /**
+     * Returns optional fiat execution configuration.
+     *
+     * This is intentionally not stored in controller state.
+     *
+     * @returns Fiat execution options, if configured.
+     */
+    getFiatOptions() {
+        return __classPrivateFieldGet(this, _TransactionPayController_fiatOptions, "f");
+    }
+    getPaymentOverrideData(...args) {
+        return (__classPrivateFieldGet(this, _TransactionPayController_getPaymentOverrideData, "f")?.call(this, ...args) ?? Promise.resolve({ calls: [] }));
+    }
+    /**
+     * Gets the preferred strategy for a transaction.
+     *
+     * Returns the first strategy from the ordered list of strategies applicable
+     * to the given transaction. Falls back to the default strategy order derived
+     * from feature flags when no custom strategy callback is configured.
+     *
+     * @param transaction - The transaction metadata to determine the strategy for.
+     * @returns The preferred {@link TransactionPayStrategy} for the transaction.
+     */
+    getStrategy(transaction) {
+        return __classPrivateFieldGet(this, _TransactionPayController_instances, "m", _TransactionPayController_getStrategiesWithFallback).call(this, transaction)[0];
+    }
+    /**
+     * Derives the Polymarket deposit-wallet address for an EOA via the
+     * client-supplied callback.
+     *
+     * @param args - The arguments forwarded to {@link PolymarketCallbacks.getDepositWalletAddress}.
+     * @returns A promise resolving to the deposit-wallet address.
+     */
+    polymarketGetDepositWalletAddress(...args) {
+        return __classPrivateFieldGet(this, _TransactionPayController_instances, "m", _TransactionPayController_requirePolymarket).call(this).getDepositWalletAddress(...args);
+    }
+    /**
+     * Signs and broadcasts a Polymarket deposit-wallet batch via the
+     * client-supplied callback.
+     *
+     * @param args - The arguments forwarded to {@link PolymarketCallbacks.submitDepositWalletBatch}.
+     * @returns A promise resolving to the relayer-issued source hash.
+     */
+    polymarketSubmitDepositWalletBatch(...args) {
+        return __classPrivateFieldGet(this, _TransactionPayController_instances, "m", _TransactionPayController_requirePolymarket).call(this).submitDepositWalletBatch(...args);
+    }
+}
+_TransactionPayController_fiatOptions = new WeakMap(), _TransactionPayController_getAmountData = new WeakMap(), _TransactionPayController_getBalance = new WeakMap(), _TransactionPayController_getDelegationTransaction = new WeakMap(), _TransactionPayController_getPaymentOverrideData = new WeakMap(), _TransactionPayController_getStrategy = new WeakMap(), _TransactionPayController_getStrategies = new WeakMap(), _TransactionPayController_polymarket = new WeakMap(), _TransactionPayController_instances = new WeakSet(), _TransactionPayController_requirePolymarket = function _TransactionPayController_requirePolymarket() {
+    if (!__classPrivateFieldGet(this, _TransactionPayController_polymarket, "f")) {
+        throw new Error('TransactionPayController: Polymarket callbacks missing');
+    }
+    return __classPrivateFieldGet(this, _TransactionPayController_polymarket, "f");
+}, _TransactionPayController_removeTransactionData = function _TransactionPayController_removeTransactionData(transactionId) {
+    this.update((state) => {
+        delete state.transactionData[transactionId];
+    });
+}, _TransactionPayController_updateTransactionData = function _TransactionPayController_updateTransactionData(transactionId, fn) {
+    let shouldUpdateQuotes = false;
+    this.update((state) => {
+        const { transactionData } = state;
+        let current = transactionData[transactionId];
+        const originalPaymentToken = current?.paymentToken;
+        const originalTokens = current?.tokens;
+        const originalIsMaxAmount = current?.isMaxAmount;
+        const originalIsPostQuote = current?.isPostQuote;
+        const originalAccountOverride = current?.accountOverride;
+        const originalFiatPaymentAmount = current?.fiatPayment?.amountFiat;
+        const originalFiatPaymentMethodId = current?.fiatPayment?.selectedPaymentMethodId;
+        if (!current) {
+            transactionData[transactionId] = {
+                fiatPayment: {},
+                isLoading: false,
+                tokens: [],
+            };
+            current = transactionData[transactionId];
+        }
+        fn(current);
+        const isPaymentTokenUpdated = current.paymentToken?.address?.toLowerCase() !==
+            originalPaymentToken?.address?.toLowerCase() ||
+            current.paymentToken?.chainId !== originalPaymentToken?.chainId;
+        const isTokensUpdated = current.tokens !== originalTokens;
+        const isIsMaxUpdated = current.isMaxAmount !== originalIsMaxAmount;
+        const isPostQuoteUpdated = current.isPostQuote !== originalIsPostQuote;
+        const isAccountOverrideUpdated = current.accountOverride !== originalAccountOverride;
+        const isFiatAmountUpdated = current.fiatPayment?.amountFiat !== originalFiatPaymentAmount;
+        const isFiatPaymentMethodUpdated = current.fiatPayment?.selectedPaymentMethodId !==
+            originalFiatPaymentMethodId;
+        if (isPaymentTokenUpdated ||
+            isIsMaxUpdated ||
+            isTokensUpdated ||
+            isPostQuoteUpdated ||
+            isAccountOverrideUpdated) {
+            updateSourceAmounts(transactionId, current, this.messenger, __classPrivateFieldGet(this, _TransactionPayController_getBalance, "f"));
+            shouldUpdateQuotes = true;
+        }
+        if (isFiatAmountUpdated || isFiatPaymentMethodUpdated) {
+            shouldUpdateQuotes = true;
+        }
+    });
+    if (shouldUpdateQuotes) {
+        updateQuotes({
+            getStrategies: __classPrivateFieldGet(this, _TransactionPayController_instances, "m", _TransactionPayController_getStrategiesWithFallback).bind(this),
+            messenger: this.messenger,
+            transactionData: this.state.transactionData[transactionId],
+            transactionId,
+            updateTransactionData: __classPrivateFieldGet(this, _TransactionPayController_instances, "m", _TransactionPayController_updateTransactionData).bind(this),
+        }).catch(noop);
+    }
+}, _TransactionPayController_getStrategiesWithFallback = function _TransactionPayController_getStrategiesWithFallback(transaction) {
+    const transactionData = this.state.transactionData[transaction.id];
+    const strategyCandidates = __classPrivateFieldGet(this, _TransactionPayController_getStrategies, "f")?.call(this, transaction) ??
+        (__classPrivateFieldGet(this, _TransactionPayController_getStrategy, "f") ? [__classPrivateFieldGet(this, _TransactionPayController_getStrategy, "f").call(this, transaction)] : []);
+    const validStrategies = strategyCandidates.filter((strategy) => isTransactionPayStrategy(strategy));
+    if (validStrategies.length) {
+        return validStrategies;
+    }
+    const paymentToken = transactionData?.paymentToken;
+    return getStrategyOrder(this.messenger, paymentToken?.chainId, paymentToken?.address, transaction.type, transactionData?.fiatPayment?.selectedPaymentMethodId);
+};
+//# sourceMappingURL=TransactionPayController.mjs.map

package/dist/TransactionPayController.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransactionPayController.mjs","sourceRoot":"","sources":["../src/TransactionPayController.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,OAAO,EAAE,cAAc,EAAE,kCAAkC;;;AAK3D,OAAO,EAAE,iBAAiB,EAAE,0CAAyC;AACrE,OAAO,EAAE,kBAAkB,EAAE,2CAA0C;AACvE,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,sBAAsB,EACvB,wBAAuB;AACxB,OAAO,EAAE,cAAc,EAAE,qCAAoC;AAiB7D,OAAO,EAAE,gBAAgB,EAAE,kCAAiC;AAC5D,OAAO,EAAE,YAAY,EAAE,2BAA0B;AACjD,OAAO,EAAE,mBAAmB,EAAE,mCAAkC;AAChE,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC5B,gCAA+B;AAEhC,MAAM,yBAAyB,GAAG;IAChC,eAAe;IACf,0BAA0B;IAC1B,gBAAgB;IAChB,wBAAwB;IACxB,aAAa;IACb,mCAAmC;IACnC,oCAAoC;IACpC,sBAAsB;IACtB,mBAAmB;IACnB,oBAAoB;CACZ,CAAC;AAEX,MAAM,aAAa,GAAiD;IAClE,eAAe,EAAE;QACf,sBAAsB,EAAE,KAAK;QAC7B,kBAAkB,EAAE,IAAI;QACxB,OAAO,EAAE,KAAK;QACd,QAAQ,EAAE,IAAI;KACf;CACF,CAAC;AAEF,MAAM,eAAe,GAAG,GAAkC,EAAE,CAAC,CAAC;IAC5D,eAAe,EAAE,EAAE;CACpB,CAAC,CAAC;AAEH,MAAM,OAAO,wBAAyB,SAAQ,cAI7C;IAqBC,YAAY,EACV,WAAW,EACX,aAAa,EACb,UAAU,EACV,wBAAwB,EACxB,sBAAsB,EACtB,WAAW,EACX,aAAa,EACb,SAAS,EACT,UAAU,EACV,KAAK,GAC2B;QAChC,KAAK,CAAC;YACJ,IAAI,EAAE,eAAe;YACrB,QAAQ,EAAE,aAAa;YACvB,SAAS;YACT,KAAK,EAAE,EAAE,GAAG,eAAe,EAAE,EAAE,GAAG,KAAK,EAAE;SAC1C,CAAC,CAAC;;QArCI,wDAAyC;QAEzC,0DAAuC;QAEvC,uDAAiC;QAEjC,qEAA4D;QAE5D,mEAAyD;QAEzD,wDAEmB;QAEnB,0DAEqB;QAErB,uDAAkC;QAqBzC,uBAAA,IAAI,yCAAgB,WAAW,MAAA,CAAC;QAChC,uBAAA,IAAI,2CAAkB,aAAa,MAAA,CAAC;QACpC,uBAAA,IAAI,wCAAe,UAAU,MAAA,CAAC;QAC9B,uBAAA,IAAI,sDAA6B,wBAAwB,MAAA,CAAC;QAC1D,uBAAA,IAAI,oDAA2B,sBAAsB,MAAA,CAAC;QACtD,uBAAA,IAAI,yCAAgB,WAAW,MAAA,CAAC;QAChC,uBAAA,IAAI,2CAAkB,aAAa,MAAA,CAAC;QACpC,uBAAA,IAAI,wCAAe,UAAU,MAAA,CAAC;QAE9B,IAAI,CAAC,SAAS,CAAC,4BAA4B,CACzC,IAAI,EACJ,yBAAyB,CAC1B,CAAC;QAEF,2BAA2B,CACzB,SAAS,EACT,uBAAA,IAAI,4FAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,EACtC,uBAAA,IAAI,4FAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,CACvC,CAAC;QAEF,qBAAqB,CACnB,SAAS,EACT,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAChB,uBAAA,IAAI,4FAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,CACvC,CAAC;QAEF,kCAAkC;QAClC,IAAI,cAAc,CAAC;YACjB,aAAa,EAAE,uBAAA,IAAI,gGAA2B,CAAC,IAAI,CAAC,IAAI,CAAC;YACzD,SAAS;YACT,qBAAqB,EAAE,uBAAA,IAAI,4FAAuB,CAAC,IAAI,CAAC,IAAI,CAAC;SAC9D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,oBAAoB,CAClB,aAAqB,EACrB,QAAmC;QAEnC,uBAAA,IAAI,4FAAuB,MAA3B,IAAI,EAAwB,aAAa,EAAE,CAAC,eAAe,EAAE,EAAE;YAC7D,MAAM,MAAM,GAAsB;gBAChC,eAAe,EAAE,eAAe,CAAC,eAAe;gBAChD,MAAM,EAAE,eAAe,CAAC,MAAM;gBAC9B,mBAAmB,EAAE,eAAe,CAAC,mBAAmB;gBACxD,WAAW,EAAE,eAAe,CAAC,WAAW;gBACxC,yBAAyB,EAAE,eAAe,CAAC,yBAAyB;gBACpE,WAAW,EAAE,eAAe,CAAC,WAAW;gBACxC,eAAe,EAAE,eAAe,CAAC,eAAe;gBAChD,eAAe,EAAE,eAAe,CAAC,eAAe;gBAChD,QAAQ,EAAE,eAAe,CAAC,QAAQ;aACnC,CAAC;YAEF,MAAM,uBAAuB,GAAG,MAAM,CAAC,eAAe,CAAC;YAEvD,QAAQ,CAAC,MAAM,CAAC,CAAC;YAEjB,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;YAEvC,IACE,CAAC,MAAM,CAAC,WAAW;gBACnB,MAAM,CAAC,eAAe,KAAK,uBAAuB,EAClD,CAAC;gBACD,eAAe,CAAC,YAAY,GAAG,SAAS,CAAC;YAC3C,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,kBAAkB,CAAC,OAAkC;QACnD,kBAAkB,CAAC,OAAO,EAAE;YAC1B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,qBAAqB,EAAE,uBAAA,IAAI,4FAAuB,CAAC,IAAI,CAAC,IAAI,CAAC;SAC9D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,iBAAiB,CAAC,OAAiC;QACjD,iBAAiB,CAAC,OAAO,EAAE;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,qBAAqB,EAAE,uBAAA,IAAI,4FAAuB,CAAC,IAAI,CAAC,IAAI,CAAC;SAC9D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;OAWG;IACH,wBAAwB,CACtB,GAAG,IAAkD;QAErD,OAAO,uBAAA,IAAI,0DAA0B,MAA9B,IAAI,EAA2B,GAAG,IAAI,CAAC,CAAC;IACjD,CAAC;IAED;;;;;;;;;OASG;IACH,aAAa,CACX,GAAG,IAAuC;QAE1C,OAAO,uBAAA,IAAI,+CAAe,EAAE,KAArB,IAAI,EAAkB,GAAG,IAAI,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;;OAMG;IACH,cAAc;QACZ,OAAO,uBAAA,IAAI,6CAAa,CAAC;IAC3B,CAAC;IAED,sBAAsB,CACpB,GAAG,IAAgD;QAEnD,OAAO,CACL,uBAAA,IAAI,wDAAwB,EAAE,KAA9B,IAAI,EAA2B,GAAG,IAAI,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAC1E,CAAC;IACJ,CAAC;IAED;;;;;;;;;OASG;IACH,WAAW,CAAC,WAA4B;QACtC,OAAO,uBAAA,IAAI,gGAA2B,MAA/B,IAAI,EAA4B,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC;IAED;;;;;;OAMG;IACH,iCAAiC,CAC/B,GAAG,IAAgE;QAEnE,OAAO,uBAAA,IAAI,wFAAmB,MAAvB,IAAI,CAAqB,CAAC,uBAAuB,CAAC,GAAG,IAAI,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;OAMG;IACH,kCAAkC,CAChC,GAAG,IAAiE;QAEpE,OAAO,uBAAA,IAAI,wFAAmB,MAAvB,IAAI,CAAqB,CAAC,wBAAwB,CAAC,GAAG,IAAI,CAAC,CAAC;IACrE,CAAC;CA0HF;;IAvHG,IAAI,CAAC,uBAAA,IAAI,4CAAY,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,uBAAA,IAAI,4CAAY,CAAC;AAC1B,CAAC,6GAEsB,aAAqB;IAC1C,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;QACpB,OAAO,KAAK,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC,6GAGC,aAAqB,EACrB,EAAqD;IAErD,IAAI,kBAAkB,GAAG,KAAK,CAAC;IAE/B,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;QACpB,MAAM,EAAE,eAAe,EAAE,GAAG,KAAK,CAAC;QAClC,IAAI,OAAO,GAAG,eAAe,CAAC,aAAa,CAAC,CAAC;QAC7C,MAAM,oBAAoB,GAAG,OAAO,EAAE,YAAY,CAAC;QACnD,MAAM,cAAc,GAAG,OAAO,EAAE,MAAM,CAAC;QACvC,MAAM,mBAAmB,GAAG,OAAO,EAAE,WAAW,CAAC;QACjD,MAAM,mBAAmB,GAAG,OAAO,EAAE,WAAW,CAAC;QACjD,MAAM,uBAAuB,GAAG,OAAO,EAAE,eAAe,CAAC;QACzD,MAAM,yBAAyB,GAAG,OAAO,EAAE,WAAW,EAAE,UAAU,CAAC;QACnE,MAAM,2BAA2B,GAC/B,OAAO,EAAE,WAAW,EAAE,uBAAuB,CAAC;QAEhD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,eAAe,CAAC,aAAa,CAAC,GAAG;gBAC/B,WAAW,EAAE,EAAE;gBACf,SAAS,EAAE,KAAK;gBAChB,MAAM,EAAE,EAAE;aACX,CAAC;YAEF,OAAO,GAAG,eAAe,CAAC,aAAa,CAAC,CAAC;QAC3C,CAAC;QAED,EAAE,CAAC,OAAO,CAAC,CAAC;QAEZ,MAAM,qBAAqB,GACzB,OAAO,CAAC,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE;YAC1C,oBAAoB,EAAE,OAAO,EAAE,WAAW,EAAE;YAC9C,OAAO,CAAC,YAAY,EAAE,OAAO,KAAK,oBAAoB,EAAE,OAAO,CAAC;QAElE,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,KAAK,cAAc,CAAC;QAC1D,MAAM,cAAc,GAAG,OAAO,CAAC,WAAW,KAAK,mBAAmB,CAAC;QACnE,MAAM,kBAAkB,GAAG,OAAO,CAAC,WAAW,KAAK,mBAAmB,CAAC;QACvE,MAAM,wBAAwB,GAC5B,OAAO,CAAC,eAAe,KAAK,uBAAuB,CAAC;QACtD,MAAM,mBAAmB,GACvB,OAAO,CAAC,WAAW,EAAE,UAAU,KAAK,yBAAyB,CAAC;QAChE,MAAM,0BAA0B,GAC9B,OAAO,CAAC,WAAW,EAAE,uBAAuB;YAC5C,2BAA2B,CAAC;QAE9B,IACE,qBAAqB;YACrB,cAAc;YACd,eAAe;YACf,kBAAkB;YAClB,wBAAwB,EACxB,CAAC;YACD,mBAAmB,CACjB,aAAa,EACb,OAAgB,EAChB,IAAI,CAAC,SAAS,EACd,uBAAA,IAAI,4CAAY,CACjB,CAAC;YAEF,kBAAkB,GAAG,IAAI,CAAC;QAC5B,CAAC;QAED,IAAI,mBAAmB,IAAI,0BAA0B,EAAE,CAAC;YACtD,kBAAkB,GAAG,IAAI,CAAC;QAC5B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,kBAAkB,EAAE,CAAC;QACvB,YAAY,CAAC;YACX,aAAa,EAAE,uBAAA,IAAI,gGAA2B,CAAC,IAAI,CAAC,IAAI,CAAC;YACzD,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,eAAe,EAAE,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,aAAa,CAAC;YAC1D,aAAa;YACb,qBAAqB,EAAE,uBAAA,IAAI,4FAAuB,CAAC,IAAI,CAAC,IAAI,CAAC;SAC9D,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;AACH,CAAC,qHAGC,WAA4B;IAE5B,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAEnE,MAAM,kBAAkB,GACtB,uBAAA,IAAI,+CAAe,EAAE,KAArB,IAAI,EAAkB,WAAW,CAAC;QAClC,CAAC,uBAAA,IAAI,6CAAa,CAAC,CAAC,CAAC,CAAC,uBAAA,IAAI,6CAAa,MAAjB,IAAI,EAAc,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAE9D,MAAM,eAAe,GAAG,kBAAkB,CAAC,MAAM,CAC/C,CAAC,QAAQ,EAAsC,EAAE,CAC/C,wBAAwB,CAAC,QAAQ,CAAC,CACrC,CAAC;IAEF,IAAI,eAAe,CAAC,MAAM,EAAE,CAAC;QAC3B,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,MAAM,YAAY,GAAG,eAAe,EAAE,YAAY,CAAC;IAEnD,OAAO,gBAAgB,CACrB,IAAI,CAAC,SAAS,EACd,YAAY,EAAE,OAAO,EACrB,YAAY,EAAE,OAAO,EACrB,WAAW,CAAC,IAAI,EAChB,eAAe,EAAE,WAAW,EAAE,uBAAuB,CACtD,CAAC;AACJ,CAAC","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';\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 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          current as never,\n          this.messenger,\n          this.#getBalance,\n        );\n\n        shouldUpdateQuotes = true;\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/actions/update-fiat-payment.cjs

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateFiatPayment = void 0;
+const utils_1 = require("@metamask/utils");
+const logger_js_1 = require("../logger.cjs");
+const transaction_js_1 = require("../utils/transaction.cjs");
+const log = (0, utils_1.createModuleLogger)(logger_js_1.projectLogger, 'update-fiat-payment');
+/**
+ * Update fiat payment state for a specific transaction.
+ *
+ * @param request - Request parameters.
+ * @param options - Options bag.
+ */
+function updateFiatPayment(request, options) {
+    const { transactionId, callback } = request;
+    const { messenger, updateTransactionData } = options;
+    const transaction = (0, transaction_js_1.getTransaction)(transactionId, messenger);
+    if (!transaction) {
+        throw new Error('Transaction not found');
+    }
+    log('Updated fiat payment', { transactionId });
+    updateTransactionData(transactionId, (data) => {
+        const currentFiatPayment = data.fiatPayment ?? {};
+        callback(currentFiatPayment);
+        data.fiatPayment = currentFiatPayment;
+    });
+}
+exports.updateFiatPayment = updateFiatPayment;
+//# sourceMappingURL=update-fiat-payment.cjs.map