@metamask/transaction-pay-controller 16.3.0 → 16.4.0

package/dist/strategy/relay/RelayStrategy.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"RelayStrategy.mjs","sourceRoot":"","sources":["../../../src/strategy/relay/RelayStrategy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,2BAAuB;AAChD,OAAO,EAAE,iBAAiB,EAAE,2BAAuB;AASnD,MAAM,OAAO,aAAa;IACxB,KAAK,CAAC,SAAS,CACb,OAAoC;QAEpC,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,OAAO,CACX,OAA8C;QAE9C,OAAO,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import { getRelayQuotes } from './relay-quotes';\nimport { submitRelayQuotes } from './relay-submit';\nimport type { RelayQuote } from './types';\nimport type {\n  PayStrategy,\n  PayStrategyExecuteRequest,\n  PayStrategyGetQuotesRequest,\n  TransactionPayQuote,\n} from '../../types';\n\nexport class RelayStrategy implements PayStrategy<RelayQuote> {\n  async getQuotes(\n    request: PayStrategyGetQuotesRequest,\n  ): Promise<TransactionPayQuote<RelayQuote>[]> {\n    return getRelayQuotes(request);\n  }\n\n  async execute(\n    request: PayStrategyExecuteRequest<RelayQuote>,\n  ): ReturnType<PayStrategy<RelayQuote>['execute']> {\n    return await submitRelayQuotes(request);\n  }\n}\n"]}
+{"version":3,"file":"RelayStrategy.mjs","sourceRoot":"","sources":["../../../src/strategy/relay/RelayStrategy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,2BAAuB;AAChD,OAAO,EAAE,iBAAiB,EAAE,2BAAuB;AAQnD,OAAO,EAAE,sBAAsB,EAAE,sCAAkC;AAEnE,MAAM,OAAO,aAAa;IACxB,QAAQ,CAAC,OAAoC;QAC3C,MAAM,MAAM,GAAG,sBAAsB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACzD,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,SAAS,CACb,OAAoC;QAEpC,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,OAAO,CACX,OAA8C;QAE9C,OAAO,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import { getRelayQuotes } from './relay-quotes';\nimport { submitRelayQuotes } from './relay-submit';\nimport type { RelayQuote } from './types';\nimport type {\n  PayStrategy,\n  PayStrategyExecuteRequest,\n  PayStrategyGetQuotesRequest,\n  TransactionPayQuote,\n} from '../../types';\nimport { getPayStrategiesConfig } from '../../utils/feature-flags';\n\nexport class RelayStrategy implements PayStrategy<RelayQuote> {\n  supports(request: PayStrategyGetQuotesRequest): boolean {\n    const config = getPayStrategiesConfig(request.messenger);\n    return config.relay.enabled;\n  }\n\n  async getQuotes(\n    request: PayStrategyGetQuotesRequest,\n  ): Promise<TransactionPayQuote<RelayQuote>[]> {\n    return getRelayQuotes(request);\n  }\n\n  async execute(\n    request: PayStrategyExecuteRequest<RelayQuote>,\n  ): ReturnType<PayStrategy<RelayQuote>['execute']> {\n    return await submitRelayQuotes(request);\n  }\n}\n"]}

package/dist/strategy/relay/gas-station.cjs

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGasStationCostInSourceTokenRaw = exports.getGasStationEligibility = void 0;
+const controller_utils_1 = require("@metamask/controller-utils");
+const utils_1 = require("@metamask/utils");
+const bignumber_js_1 = require("bignumber.js");
+const logger_1 = require("../../logger.cjs");
+const feature_flags_1 = require("../../utils/feature-flags.cjs");
+const gas_1 = require("../../utils/gas.cjs");
+const log = (0, utils_1.createModuleLogger)(logger_1.projectLogger, 'relay-gas-station');
+function getGasStationEligibility(messenger, sourceChainId) {
+    const { relayDisabledGasStationChains } = (0, feature_flags_1.getFeatureFlags)(messenger);
+    const supportedChains = (0, feature_flags_1.getEIP7702SupportedChains)(messenger);
+    const chainSupportsGasStation = supportedChains.some((supportedChainId) => supportedChainId.toLowerCase() === sourceChainId.toLowerCase());
+    const isDisabledChain = relayDisabledGasStationChains.includes(sourceChainId);
+    return {
+        chainSupportsGasStation,
+        isDisabledChain,
+        isEligible: !isDisabledChain && chainSupportsGasStation,
+    };
+}
+exports.getGasStationEligibility = getGasStationEligibility;
+async function getGasStationCostInSourceTokenRaw({ firstStepData, messenger, request, totalGasEstimate, totalItemCount, }) {
+    const { data, to, value } = firstStepData;
+    const { from, sourceChainId, sourceTokenAddress } = request;
+    let gasFeeTokens;
+    try {
+        gasFeeTokens = await messenger.call('TransactionController:getGasFeeTokens', {
+            chainId: sourceChainId,
+            data,
+            from,
+            to,
+            value: (0, controller_utils_1.toHex)(value ?? '0'),
+        });
+    }
+    catch (error) {
+        log('Failed to estimate gas fee tokens', {
+            error,
+            sourceChainId,
+        });
+        return undefined;
+    }
+    const gasFeeToken = gasFeeTokens.find((singleGasFeeToken) => singleGasFeeToken.tokenAddress.toLowerCase() ===
+        sourceTokenAddress.toLowerCase());
+    if (!gasFeeToken) {
+        log('No matching source token in gas fee token estimate', {
+            sourceTokenAddress,
+            sourceChainId,
+        });
+        return undefined;
+    }
+    const gasFeeTokenWithNormalizedAmount = {
+        ...gasFeeToken,
+        amount: (0, controller_utils_1.toHex)(getNormalizedGasFeeTokenAmount({
+            gasFeeToken,
+            totalGasEstimate,
+            totalItemCount,
+        })),
+    };
+    const gasFeeTokenCost = (0, gas_1.calculateGasFeeTokenCost)({
+        chainId: sourceChainId,
+        gasFeeToken: gasFeeTokenWithNormalizedAmount,
+        messenger,
+    });
+    if (!gasFeeTokenCost) {
+        log('Unable to calculate gas fee token cost using fiat rates', {
+            sourceTokenAddress,
+            sourceChainId,
+        });
+        return undefined;
+    }
+    log('Estimated gas station cost for source token', {
+        amount: gasFeeTokenCost.raw,
+        sourceTokenAddress,
+        sourceChainId,
+    });
+    return gasFeeTokenCost;
+}
+exports.getGasStationCostInSourceTokenRaw = getGasStationCostInSourceTokenRaw;
+function getNormalizedGasFeeTokenAmount({ gasFeeToken, totalGasEstimate, totalItemCount, }) {
+    let amount = new bignumber_js_1.BigNumber(gasFeeToken.amount);
+    if (totalItemCount > 1) {
+        const gas = new bignumber_js_1.BigNumber(gasFeeToken.gas);
+        const gasFeeAmount = new bignumber_js_1.BigNumber(gasFeeToken.amount);
+        if (totalGasEstimate > 0 && gas.isGreaterThan(0)) {
+            const gasRate = gasFeeAmount.dividedBy(gas);
+            amount = gasRate.multipliedBy(totalGasEstimate);
+        }
+    }
+    return amount.integerValue(bignumber_js_1.BigNumber.ROUND_CEIL).toFixed(0);
+}
+//# sourceMappingURL=gas-station.cjs.map

package/dist/strategy/relay/gas-station.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"gas-station.cjs","sourceRoot":"","sources":["../../../src/strategy/relay/gas-station.ts"],"names":[],"mappings":"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","sourcesContent":["import { toHex } from '@metamask/controller-utils';\nimport type { GasFeeToken } from '@metamask/transaction-controller';\nimport type { Hex } from '@metamask/utils';\nimport { createModuleLogger } from '@metamask/utils';\nimport { BigNumber } from 'bignumber.js';\n\nimport { projectLogger } from '../../logger';\nimport type {\n  Amount,\n  QuoteRequest,\n  TransactionPayControllerMessenger,\n} from '../../types';\nimport {\n  getEIP7702SupportedChains,\n  getFeatureFlags,\n} from '../../utils/feature-flags';\nimport { calculateGasFeeTokenCost } from '../../utils/gas';\n\nconst log = createModuleLogger(projectLogger, 'relay-gas-station');\n\ntype GasStationCostParams = {\n  firstStepData: {\n    data: Hex;\n    to: Hex;\n    value?: string;\n  };\n  messenger: TransactionPayControllerMessenger;\n  request: Pick<QuoteRequest, 'from' | 'sourceChainId' | 'sourceTokenAddress'>;\n  totalGasEstimate: number;\n  totalItemCount: number;\n};\n\nexport type GasStationEligibility = {\n  chainSupportsGasStation: boolean;\n  isDisabledChain: boolean;\n  isEligible: boolean;\n};\n\nexport function getGasStationEligibility(\n  messenger: TransactionPayControllerMessenger,\n  sourceChainId: QuoteRequest['sourceChainId'],\n): GasStationEligibility {\n  const { relayDisabledGasStationChains } = getFeatureFlags(messenger);\n  const supportedChains = getEIP7702SupportedChains(messenger);\n  const chainSupportsGasStation = supportedChains.some(\n    (supportedChainId) =>\n      supportedChainId.toLowerCase() === sourceChainId.toLowerCase(),\n  );\n\n  const isDisabledChain = relayDisabledGasStationChains.includes(sourceChainId);\n\n  return {\n    chainSupportsGasStation,\n    isDisabledChain,\n    isEligible: !isDisabledChain && chainSupportsGasStation,\n  };\n}\n\nexport async function getGasStationCostInSourceTokenRaw({\n  firstStepData,\n  messenger,\n  request,\n  totalGasEstimate,\n  totalItemCount,\n}: GasStationCostParams): Promise<Amount | undefined> {\n  const { data, to, value } = firstStepData;\n  const { from, sourceChainId, sourceTokenAddress } = request;\n\n  let gasFeeTokens: GasFeeToken[];\n\n  try {\n    gasFeeTokens = await messenger.call(\n      'TransactionController:getGasFeeTokens',\n      {\n        chainId: sourceChainId,\n        data,\n        from,\n        to,\n        value: toHex(value ?? '0'),\n      },\n    );\n  } catch (error) {\n    log('Failed to estimate gas fee tokens', {\n      error,\n      sourceChainId,\n    });\n    return undefined;\n  }\n\n  const gasFeeToken = gasFeeTokens.find(\n    (singleGasFeeToken) =>\n      singleGasFeeToken.tokenAddress.toLowerCase() ===\n      sourceTokenAddress.toLowerCase(),\n  );\n\n  if (!gasFeeToken) {\n    log('No matching source token in gas fee token estimate', {\n      sourceTokenAddress,\n      sourceChainId,\n    });\n    return undefined;\n  }\n\n  const gasFeeTokenWithNormalizedAmount = {\n    ...gasFeeToken,\n    amount: toHex(\n      getNormalizedGasFeeTokenAmount({\n        gasFeeToken,\n        totalGasEstimate,\n        totalItemCount,\n      }),\n    ),\n  };\n\n  const gasFeeTokenCost = calculateGasFeeTokenCost({\n    chainId: sourceChainId,\n    gasFeeToken: gasFeeTokenWithNormalizedAmount,\n    messenger,\n  });\n\n  if (!gasFeeTokenCost) {\n    log('Unable to calculate gas fee token cost using fiat rates', {\n      sourceTokenAddress,\n      sourceChainId,\n    });\n    return undefined;\n  }\n\n  log('Estimated gas station cost for source token', {\n    amount: gasFeeTokenCost.raw,\n    sourceTokenAddress,\n    sourceChainId,\n  });\n\n  return gasFeeTokenCost;\n}\n\nfunction getNormalizedGasFeeTokenAmount({\n  gasFeeToken,\n  totalGasEstimate,\n  totalItemCount,\n}: {\n  gasFeeToken: GasFeeToken;\n  totalGasEstimate: number;\n  totalItemCount: number;\n}): string {\n  let amount = new BigNumber(gasFeeToken.amount);\n\n  if (totalItemCount > 1) {\n    const gas = new BigNumber(gasFeeToken.gas);\n    const gasFeeAmount = new BigNumber(gasFeeToken.amount);\n\n    if (totalGasEstimate > 0 && gas.isGreaterThan(0)) {\n      const gasRate = gasFeeAmount.dividedBy(gas);\n      amount = gasRate.multipliedBy(totalGasEstimate);\n    }\n  }\n\n  return amount.integerValue(BigNumber.ROUND_CEIL).toFixed(0);\n}\n"]}

package/dist/strategy/relay/gas-station.d.cts

@@ -0,0 +1,22 @@
+import type { Hex } from "@metamask/utils";
+import type { Amount, QuoteRequest, TransactionPayControllerMessenger } from "../../types.cjs";
+type GasStationCostParams = {
+    firstStepData: {
+        data: Hex;
+        to: Hex;
+        value?: string;
+    };
+    messenger: TransactionPayControllerMessenger;
+    request: Pick<QuoteRequest, 'from' | 'sourceChainId' | 'sourceTokenAddress'>;
+    totalGasEstimate: number;
+    totalItemCount: number;
+};
+export type GasStationEligibility = {
+    chainSupportsGasStation: boolean;
+    isDisabledChain: boolean;
+    isEligible: boolean;
+};
+export declare function getGasStationEligibility(messenger: TransactionPayControllerMessenger, sourceChainId: QuoteRequest['sourceChainId']): GasStationEligibility;
+export declare function getGasStationCostInSourceTokenRaw({ firstStepData, messenger, request, totalGasEstimate, totalItemCount, }: GasStationCostParams): Promise<Amount | undefined>;
+export {};
+//# sourceMappingURL=gas-station.d.cts.map

package/dist/strategy/relay/gas-station.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gas-station.d.cts","sourceRoot":"","sources":["../../../src/strategy/relay/gas-station.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,wBAAwB;AAK3C,OAAO,KAAK,EACV,MAAM,EACN,YAAY,EACZ,iCAAiC,EAClC,wBAAoB;AASrB,KAAK,oBAAoB,GAAG;IAC1B,aAAa,EAAE;QACb,IAAI,EAAE,GAAG,CAAC;QACV,EAAE,EAAE,GAAG,CAAC;QACR,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,SAAS,EAAE,iCAAiC,CAAC;IAC7C,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,eAAe,GAAG,oBAAoB,CAAC,CAAC;IAC7E,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,uBAAuB,EAAE,OAAO,CAAC;IACjC,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,iCAAiC,EAC5C,aAAa,EAAE,YAAY,CAAC,eAAe,CAAC,GAC3C,qBAAqB,CAevB;AAED,wBAAsB,iCAAiC,CAAC,EACtD,aAAa,EACb,SAAS,EACT,OAAO,EACP,gBAAgB,EAChB,cAAc,GACf,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAuEpD"}

package/dist/strategy/relay/gas-station.d.mts

@@ -0,0 +1,22 @@
+import type { Hex } from "@metamask/utils";
+import type { Amount, QuoteRequest, TransactionPayControllerMessenger } from "../../types.mjs";
+type GasStationCostParams = {
+    firstStepData: {
+        data: Hex;
+        to: Hex;
+        value?: string;
+    };
+    messenger: TransactionPayControllerMessenger;
+    request: Pick<QuoteRequest, 'from' | 'sourceChainId' | 'sourceTokenAddress'>;
+    totalGasEstimate: number;
+    totalItemCount: number;
+};
+export type GasStationEligibility = {
+    chainSupportsGasStation: boolean;
+    isDisabledChain: boolean;
+    isEligible: boolean;
+};
+export declare function getGasStationEligibility(messenger: TransactionPayControllerMessenger, sourceChainId: QuoteRequest['sourceChainId']): GasStationEligibility;
+export declare function getGasStationCostInSourceTokenRaw({ firstStepData, messenger, request, totalGasEstimate, totalItemCount, }: GasStationCostParams): Promise<Amount | undefined>;
+export {};
+//# sourceMappingURL=gas-station.d.mts.map

package/dist/strategy/relay/gas-station.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gas-station.d.mts","sourceRoot":"","sources":["../../../src/strategy/relay/gas-station.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,wBAAwB;AAK3C,OAAO,KAAK,EACV,MAAM,EACN,YAAY,EACZ,iCAAiC,EAClC,wBAAoB;AASrB,KAAK,oBAAoB,GAAG;IAC1B,aAAa,EAAE;QACb,IAAI,EAAE,GAAG,CAAC;QACV,EAAE,EAAE,GAAG,CAAC;QACR,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,SAAS,EAAE,iCAAiC,CAAC;IAC7C,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,eAAe,GAAG,oBAAoB,CAAC,CAAC;IAC7E,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,uBAAuB,EAAE,OAAO,CAAC;IACjC,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,iCAAiC,EAC5C,aAAa,EAAE,YAAY,CAAC,eAAe,CAAC,GAC3C,qBAAqB,CAevB;AAED,wBAAsB,iCAAiC,CAAC,EACtD,aAAa,EACb,SAAS,EACT,OAAO,EACP,gBAAgB,EAChB,cAAc,GACf,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAuEpD"}

package/dist/strategy/relay/gas-station.mjs

@@ -0,0 +1,87 @@
+import { toHex } from "@metamask/controller-utils";
+import { createModuleLogger } from "@metamask/utils";
+import { BigNumber } from "bignumber.js";
+import { projectLogger } from "../../logger.mjs";
+import { getEIP7702SupportedChains, getFeatureFlags } from "../../utils/feature-flags.mjs";
+import { calculateGasFeeTokenCost } from "../../utils/gas.mjs";
+const log = createModuleLogger(projectLogger, 'relay-gas-station');
+export function getGasStationEligibility(messenger, sourceChainId) {
+    const { relayDisabledGasStationChains } = getFeatureFlags(messenger);
+    const supportedChains = getEIP7702SupportedChains(messenger);
+    const chainSupportsGasStation = supportedChains.some((supportedChainId) => supportedChainId.toLowerCase() === sourceChainId.toLowerCase());
+    const isDisabledChain = relayDisabledGasStationChains.includes(sourceChainId);
+    return {
+        chainSupportsGasStation,
+        isDisabledChain,
+        isEligible: !isDisabledChain && chainSupportsGasStation,
+    };
+}
+export async function getGasStationCostInSourceTokenRaw({ firstStepData, messenger, request, totalGasEstimate, totalItemCount, }) {
+    const { data, to, value } = firstStepData;
+    const { from, sourceChainId, sourceTokenAddress } = request;
+    let gasFeeTokens;
+    try {
+        gasFeeTokens = await messenger.call('TransactionController:getGasFeeTokens', {
+            chainId: sourceChainId,
+            data,
+            from,
+            to,
+            value: toHex(value ?? '0'),
+        });
+    }
+    catch (error) {
+        log('Failed to estimate gas fee tokens', {
+            error,
+            sourceChainId,
+        });
+        return undefined;
+    }
+    const gasFeeToken = gasFeeTokens.find((singleGasFeeToken) => singleGasFeeToken.tokenAddress.toLowerCase() ===
+        sourceTokenAddress.toLowerCase());
+    if (!gasFeeToken) {
+        log('No matching source token in gas fee token estimate', {
+            sourceTokenAddress,
+            sourceChainId,
+        });
+        return undefined;
+    }
+    const gasFeeTokenWithNormalizedAmount = {
+        ...gasFeeToken,
+        amount: toHex(getNormalizedGasFeeTokenAmount({
+            gasFeeToken,
+            totalGasEstimate,
+            totalItemCount,
+        })),
+    };
+    const gasFeeTokenCost = calculateGasFeeTokenCost({
+        chainId: sourceChainId,
+        gasFeeToken: gasFeeTokenWithNormalizedAmount,
+        messenger,
+    });
+    if (!gasFeeTokenCost) {
+        log('Unable to calculate gas fee token cost using fiat rates', {
+            sourceTokenAddress,
+            sourceChainId,
+        });
+        return undefined;
+    }
+    log('Estimated gas station cost for source token', {
+        amount: gasFeeTokenCost.raw,
+        sourceTokenAddress,
+        sourceChainId,
+    });
+    return gasFeeTokenCost;
+}
+function getNormalizedGasFeeTokenAmount({ gasFeeToken, totalGasEstimate, totalItemCount, }) {
+    let amount = new BigNumber(gasFeeToken.amount);
+    if (totalItemCount > 1) {
+        const gas = new BigNumber(gasFeeToken.gas);
+        const gasFeeAmount = new BigNumber(gasFeeToken.amount);
+        if (totalGasEstimate > 0 && gas.isGreaterThan(0)) {
+            const gasRate = gasFeeAmount.dividedBy(gas);
+            amount = gasRate.multipliedBy(totalGasEstimate);
+        }
+    }
+    return amount.integerValue(BigNumber.ROUND_CEIL).toFixed(0);
+}
+//# sourceMappingURL=gas-station.mjs.map

package/dist/strategy/relay/gas-station.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"gas-station.mjs","sourceRoot":"","sources":["../../../src/strategy/relay/gas-station.ts"],"names":[],"mappings":"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","sourcesContent":["import { toHex } from '@metamask/controller-utils';\nimport type { GasFeeToken } from '@metamask/transaction-controller';\nimport type { Hex } from '@metamask/utils';\nimport { createModuleLogger } from '@metamask/utils';\nimport { BigNumber } from 'bignumber.js';\n\nimport { projectLogger } from '../../logger';\nimport type {\n  Amount,\n  QuoteRequest,\n  TransactionPayControllerMessenger,\n} from '../../types';\nimport {\n  getEIP7702SupportedChains,\n  getFeatureFlags,\n} from '../../utils/feature-flags';\nimport { calculateGasFeeTokenCost } from '../../utils/gas';\n\nconst log = createModuleLogger(projectLogger, 'relay-gas-station');\n\ntype GasStationCostParams = {\n  firstStepData: {\n    data: Hex;\n    to: Hex;\n    value?: string;\n  };\n  messenger: TransactionPayControllerMessenger;\n  request: Pick<QuoteRequest, 'from' | 'sourceChainId' | 'sourceTokenAddress'>;\n  totalGasEstimate: number;\n  totalItemCount: number;\n};\n\nexport type GasStationEligibility = {\n  chainSupportsGasStation: boolean;\n  isDisabledChain: boolean;\n  isEligible: boolean;\n};\n\nexport function getGasStationEligibility(\n  messenger: TransactionPayControllerMessenger,\n  sourceChainId: QuoteRequest['sourceChainId'],\n): GasStationEligibility {\n  const { relayDisabledGasStationChains } = getFeatureFlags(messenger);\n  const supportedChains = getEIP7702SupportedChains(messenger);\n  const chainSupportsGasStation = supportedChains.some(\n    (supportedChainId) =>\n      supportedChainId.toLowerCase() === sourceChainId.toLowerCase(),\n  );\n\n  const isDisabledChain = relayDisabledGasStationChains.includes(sourceChainId);\n\n  return {\n    chainSupportsGasStation,\n    isDisabledChain,\n    isEligible: !isDisabledChain && chainSupportsGasStation,\n  };\n}\n\nexport async function getGasStationCostInSourceTokenRaw({\n  firstStepData,\n  messenger,\n  request,\n  totalGasEstimate,\n  totalItemCount,\n}: GasStationCostParams): Promise<Amount | undefined> {\n  const { data, to, value } = firstStepData;\n  const { from, sourceChainId, sourceTokenAddress } = request;\n\n  let gasFeeTokens: GasFeeToken[];\n\n  try {\n    gasFeeTokens = await messenger.call(\n      'TransactionController:getGasFeeTokens',\n      {\n        chainId: sourceChainId,\n        data,\n        from,\n        to,\n        value: toHex(value ?? '0'),\n      },\n    );\n  } catch (error) {\n    log('Failed to estimate gas fee tokens', {\n      error,\n      sourceChainId,\n    });\n    return undefined;\n  }\n\n  const gasFeeToken = gasFeeTokens.find(\n    (singleGasFeeToken) =>\n      singleGasFeeToken.tokenAddress.toLowerCase() ===\n      sourceTokenAddress.toLowerCase(),\n  );\n\n  if (!gasFeeToken) {\n    log('No matching source token in gas fee token estimate', {\n      sourceTokenAddress,\n      sourceChainId,\n    });\n    return undefined;\n  }\n\n  const gasFeeTokenWithNormalizedAmount = {\n    ...gasFeeToken,\n    amount: toHex(\n      getNormalizedGasFeeTokenAmount({\n        gasFeeToken,\n        totalGasEstimate,\n        totalItemCount,\n      }),\n    ),\n  };\n\n  const gasFeeTokenCost = calculateGasFeeTokenCost({\n    chainId: sourceChainId,\n    gasFeeToken: gasFeeTokenWithNormalizedAmount,\n    messenger,\n  });\n\n  if (!gasFeeTokenCost) {\n    log('Unable to calculate gas fee token cost using fiat rates', {\n      sourceTokenAddress,\n      sourceChainId,\n    });\n    return undefined;\n  }\n\n  log('Estimated gas station cost for source token', {\n    amount: gasFeeTokenCost.raw,\n    sourceTokenAddress,\n    sourceChainId,\n  });\n\n  return gasFeeTokenCost;\n}\n\nfunction getNormalizedGasFeeTokenAmount({\n  gasFeeToken,\n  totalGasEstimate,\n  totalItemCount,\n}: {\n  gasFeeToken: GasFeeToken;\n  totalGasEstimate: number;\n  totalItemCount: number;\n}): string {\n  let amount = new BigNumber(gasFeeToken.amount);\n\n  if (totalItemCount > 1) {\n    const gas = new BigNumber(gasFeeToken.gas);\n    const gasFeeAmount = new BigNumber(gasFeeToken.amount);\n\n    if (totalGasEstimate > 0 && gas.isGreaterThan(0)) {\n      const gasRate = gasFeeAmount.dividedBy(gas);\n      amount = gasRate.multipliedBy(totalGasEstimate);\n    }\n  }\n\n  return amount.integerValue(BigNumber.ROUND_CEIL).toFixed(0);\n}\n"]}

package/dist/strategy/relay/relay-max-gas-station.cjs

@@ -0,0 +1,242 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRelayMaxGasStationQuote = void 0;
+const utils_1 = require("@metamask/utils");
+const bignumber_js_1 = require("bignumber.js");
+const gas_station_1 = require("./gas-station.cjs");
+const logger_1 = require("../../logger.cjs");
+const token_1 = require("../../utils/token.cjs");
+const log = (0, utils_1.createModuleLogger)(logger_1.projectLogger, 'relay-max-gas-station');
+const PROBE_AMOUNT_PERCENTAGE = 0.25;
+var GasCostEstimateSource;
+(function (GasCostEstimateSource) {
+    GasCostEstimateSource["GasStation"] = "gas-station";
+    GasCostEstimateSource["Probe"] = "probe";
+    GasCostEstimateSource["Quote"] = "quote";
+})(GasCostEstimateSource || (GasCostEstimateSource = {}));
+/**
+ * Returns a Relay max-amount quote using a two-phase gas-station fallback.
+ *
+ * It first requests a standard max quote (phase 1), then when needed estimates
+ * gas in source-token units (directly or via a probe quote), requests an
+ * adjusted max quote (phase 2), and accepts phase 2 only if validation passes
+ * (source gas fee token selected, gas-limit checks, affordability).
+ *
+ * If any step fails or validation is unsafe, it safely falls back to phase 1.
+ * Successful phase-2 quotes are tagged with `metamask.isMaxGasStation = true`.
+ *
+ * @param request - Relay quote request for a max-amount flow.
+ * @param fullRequest - Full quote request context including messenger and transaction.
+ * @param getSingleQuote - Quote fetcher used for phase-1, phase-2, and probe quotes.
+ * @returns The validated adjusted phase-2 quote, or the original phase-1 quote on fallback.
+ */
+async function getRelayMaxGasStationQuote(request, fullRequest, getSingleQuote) {
+    const { messenger } = fullRequest;
+    const { sourceChainId, sourceTokenAmount } = request;
+    const context = {
+        fullRequest,
+        getSingleQuote,
+        messenger,
+        request,
+    };
+    const phase1Quote = await getSingleQuote(request, fullRequest);
+    const nativeBalanceCheck = checkEnoughNativeBalanceIfSourceGasFeeTokenNotUsed(phase1Quote, messenger, request);
+    if (nativeBalanceCheck.hasEnoughNativeBalance) {
+        return fallbackToPhase1(phase1Quote, 'Native balance is sufficient for gas', {
+            nativeBalance: nativeBalanceCheck.nativeBalance,
+            nativeGasCost: nativeBalanceCheck.nativeGasCostRaw,
+        });
+    }
+    const gasStationEligibility = (0, gas_station_1.getGasStationEligibility)(messenger, sourceChainId);
+    if (!gasStationEligibility.isEligible) {
+        return fallbackToPhase1(phase1Quote, 'Gas station is disabled or unsupported');
+    }
+    const sourceAmountBN = new bignumber_js_1.BigNumber(sourceTokenAmount);
+    const probeCost = await getProbeGasCostInSourceTokenRaw(context);
+    if (!probeCost) {
+        return fallbackToPhase1(phase1Quote, 'Unable to estimate gas-station source token cost');
+    }
+    const initialGasEstimate = {
+        amount: probeCost,
+        source: GasCostEstimateSource.Probe,
+    };
+    const adjustedSourceAmount = getAdjustedSourceAmount(sourceAmountBN, initialGasEstimate.amount);
+    if (!adjustedSourceAmount.isGreaterThan(0)) {
+        return fallbackToPhase1(phase1Quote, 'Insufficient balance for gas station after max adjustment');
+    }
+    const phase2Quote = await getAdjustedPhase2Quote(adjustedSourceAmount, initialGasEstimate, context);
+    if (!phase2Quote) {
+        return fallbackToPhase1(phase1Quote, 'Adjusted phase-2 quote request failed');
+    }
+    if (!phase2Quote.fees.isSourceGasFeeToken) {
+        return fallbackToPhase1(phase1Quote, 'Adjusted quote did not return source gas fee token pricing');
+    }
+    const phase1GasLimits = phase1Quote.original.metamask.gasLimits ?? [];
+    const phase2GasLimits = phase2Quote.original.metamask.gasLimits ?? [];
+    if (!hasMatchingGasLimitShape(phase1GasLimits, phase2GasLimits)) {
+        return fallbackToPhase1(phase1Quote, 'Adjusted quote gas limit shape changed between phases', {
+            phase1GasLimits,
+            phase2GasLimits,
+        });
+    }
+    const phase1TotalGasLimit = getTotalGasLimit(phase1GasLimits);
+    const phase2TotalGasLimit = getTotalGasLimit(phase2GasLimits);
+    if (phase2TotalGasLimit > phase1TotalGasLimit) {
+        return fallbackToPhase1(phase1Quote, 'Adjusted quote total gas limit increased between phases', {
+            phase1TotalGasLimit,
+            phase2TotalGasLimit,
+        });
+    }
+    const validationGasEstimate = new bignumber_js_1.BigNumber(phase2Quote.fees.sourceNetwork.max.raw);
+    if (!isAdjustedAmountAffordable(adjustedSourceAmount, validationGasEstimate, sourceAmountBN)) {
+        return fallbackToPhase1(phase1Quote, 'Adjusted quote fails affordability validation', {
+            adjustedSourceAmount: adjustedSourceAmount.toString(10),
+            validationGasCost: validationGasEstimate.toString(10),
+        });
+    }
+    markQuoteAsMaxGasStation(phase2Quote);
+    return phase2Quote;
+}
+exports.getRelayMaxGasStationQuote = getRelayMaxGasStationQuote;
+function checkEnoughNativeBalanceIfSourceGasFeeTokenNotUsed(quote, messenger, request) {
+    if (quote.fees.isSourceGasFeeToken) {
+        return { hasEnoughNativeBalance: false };
+    }
+    const nativeGasCostRaw = quote.fees.sourceNetwork.max.raw;
+    const nativeBalance = (0, token_1.getTokenBalance)(messenger, request.from, request.sourceChainId, (0, token_1.getNativeToken)(request.sourceChainId));
+    return {
+        hasEnoughNativeBalance: new bignumber_js_1.BigNumber(nativeBalance).isGreaterThanOrEqualTo(nativeGasCostRaw),
+        nativeBalance,
+        nativeGasCostRaw,
+    };
+}
+function getAdjustedSourceAmount(sourceAmount, estimatedGasCost) {
+    return sourceAmount
+        .minus(estimatedGasCost)
+        .integerValue(bignumber_js_1.BigNumber.ROUND_DOWN);
+}
+function isAdjustedAmountAffordable(adjustedSourceAmount, gasCost, originalSourceAmount) {
+    return adjustedSourceAmount
+        .plus(gasCost)
+        .isLessThanOrEqualTo(originalSourceAmount);
+}
+async function getAdjustedPhase2Quote(adjustedSourceAmount, initialGasEstimate, context) {
+    const { fullRequest, getSingleQuote, request } = context;
+    log('Requesting adjusted max quote', {
+        adjustedAmount: adjustedSourceAmount.toString(10),
+        gasCostInSourceToken: initialGasEstimate.amount.toString(10),
+        gasEstimateSource: initialGasEstimate.source,
+        originalAmount: request.sourceTokenAmount,
+    });
+    try {
+        return await getSingleQuote({
+            ...request,
+            sourceTokenAmount: adjustedSourceAmount.toFixed(0, bignumber_js_1.BigNumber.ROUND_DOWN),
+        }, fullRequest);
+    }
+    catch (error) {
+        log('Adjusted quote request failed, falling back to phase-1 quote', {
+            error,
+        });
+        return undefined;
+    }
+}
+async function getGasCostFromQuoteOrGasStation(quote, messenger, request) {
+    const gasCost = quote.fees.sourceNetwork.max;
+    if (quote.fees.isSourceGasFeeToken) {
+        log('Gas cost already in source token units', { raw: gasCost.raw });
+        return {
+            amount: new bignumber_js_1.BigNumber(gasCost.raw),
+            source: GasCostEstimateSource.Quote,
+        };
+    }
+    const firstStepData = quote.original.steps[0]?.items[0]?.data;
+    if (!firstStepData) {
+        return undefined;
+    }
+    const totalItemCount = quote.original.steps.reduce((count, step) => count + step.items.length, 0);
+    const totalGasEstimate = (quote.original.metamask.gasLimits ?? []).reduce((acc, gasLimit) => acc + gasLimit, 0);
+    const gasStationCost = await (0, gas_station_1.getGasStationCostInSourceTokenRaw)({
+        firstStepData,
+        messenger,
+        request: {
+            from: request.from,
+            sourceChainId: request.sourceChainId,
+            sourceTokenAddress: request.sourceTokenAddress,
+        },
+        totalGasEstimate,
+        totalItemCount,
+    });
+    if (!gasStationCost) {
+        return undefined;
+    }
+    return {
+        amount: new bignumber_js_1.BigNumber(gasStationCost.raw),
+        source: GasCostEstimateSource.GasStation,
+    };
+}
+async function getProbeGasCostInSourceTokenRaw(context) {
+    const { fullRequest, getSingleQuote, messenger, request } = context;
+    const sourceTokenInfo = (0, token_1.getTokenInfo)(messenger, request.sourceTokenAddress, request.sourceChainId);
+    if (!sourceTokenInfo) {
+        return undefined;
+    }
+    const probeAmount = getProbeSourceAmountRaw(request.sourceTokenAmount, sourceTokenInfo.decimals);
+    if (!probeAmount || probeAmount === request.sourceTokenAmount) {
+        return undefined;
+    }
+    log('Requesting probe quote for gas station estimation', {
+        originalSourceAmount: request.sourceTokenAmount,
+        probeAmount,
+    });
+    let probeQuote;
+    try {
+        probeQuote = await getSingleQuote({
+            ...request,
+            sourceTokenAmount: probeAmount,
+        }, fullRequest);
+    }
+    catch (error) {
+        log('Probe quote request failed', { error });
+        return undefined;
+    }
+    if (!probeQuote) {
+        return undefined;
+    }
+    const probeEstimate = await getGasCostFromQuoteOrGasStation(probeQuote, messenger, request);
+    return probeEstimate?.amount;
+}
+function getProbeSourceAmountRaw(sourceAmountRaw, sourceDecimals) {
+    const sourceAmount = new bignumber_js_1.BigNumber(sourceAmountRaw);
+    if (sourceAmount.isLessThanOrEqualTo(0)) {
+        return undefined;
+    }
+    const probeRawAmount = sourceAmount
+        .multipliedBy(PROBE_AMOUNT_PERCENTAGE)
+        .integerValue(bignumber_js_1.BigNumber.ROUND_FLOOR);
+    // Minimum probe size: ~0.01 token for tokens with >=2 decimals,
+    // otherwise one raw unit for low-decimal tokens.
+    const minimumProbeRaw = new bignumber_js_1.BigNumber(1).shiftedBy(Math.max(sourceDecimals - 2, 0));
+    const probeRaw = bignumber_js_1.BigNumber.minimum(sourceAmount, bignumber_js_1.BigNumber.maximum(probeRawAmount, minimumProbeRaw)).integerValue(bignumber_js_1.BigNumber.ROUND_FLOOR);
+    if (probeRaw.isLessThanOrEqualTo(0)) {
+        return undefined;
+    }
+    return probeRaw.toFixed(0);
+}
+function fallbackToPhase1(phase1Quote, message, paramsToLog) {
+    log(message, paramsToLog);
+    return phase1Quote;
+}
+function hasMatchingGasLimitShape(phase1, phase2) {
+    return phase1.length === phase2.length;
+}
+function getTotalGasLimit(gasLimits) {
+    return gasLimits.reduce((total, gasLimit) => total + gasLimit, 0);
+}
+function markQuoteAsMaxGasStation(quote) {
+    quote.original.metamask = {
+        ...quote.original.metamask,
+        isMaxGasStation: true,
+    };
+}
+//# sourceMappingURL=relay-max-gas-station.cjs.map

package/dist/strategy/relay/relay-max-gas-station.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-max-gas-station.cjs","sourceRoot":"","sources":["../../../src/strategy/relay/relay-max-gas-station.ts"],"names":[],"mappings":"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","sourcesContent":["import { createModuleLogger } from '@metamask/utils';\nimport { BigNumber } from 'bignumber.js';\n\nimport {\n  getGasStationEligibility,\n  getGasStationCostInSourceTokenRaw,\n} from './gas-station';\nimport type { RelayQuote } from './types';\nimport { projectLogger } from '../../logger';\nimport type {\n  PayStrategyGetQuotesRequest,\n  QuoteRequest,\n  TransactionPayControllerMessenger,\n  TransactionPayQuote,\n} from '../../types';\nimport {\n  getNativeToken,\n  getTokenBalance,\n  getTokenInfo,\n} from '../../utils/token';\n\nconst log = createModuleLogger(projectLogger, 'relay-max-gas-station');\n\nconst PROBE_AMOUNT_PERCENTAGE = 0.25;\n\nenum GasCostEstimateSource {\n  GasStation = 'gas-station',\n  Probe = 'probe',\n  Quote = 'quote',\n}\n\ntype GasCostEstimate = {\n  amount: BigNumber;\n  source: GasCostEstimateSource;\n};\n\ntype NativeBalanceCheckResult = {\n  hasEnoughNativeBalance: boolean;\n  nativeBalance?: string;\n  nativeGasCostRaw?: string;\n};\n\ntype GetSingleQuoteFn = (\n  request: QuoteRequest,\n  fullRequest: PayStrategyGetQuotesRequest,\n) => Promise<TransactionPayQuote<RelayQuote>>;\n\ntype MaxAmountQuoteContext = {\n  fullRequest: PayStrategyGetQuotesRequest;\n  getSingleQuote: GetSingleQuoteFn;\n  messenger: TransactionPayControllerMessenger;\n  request: QuoteRequest;\n};\n\n/**\n * Returns a Relay max-amount quote using a two-phase gas-station fallback.\n *\n * It first requests a standard max quote (phase 1), then when needed estimates\n * gas in source-token units (directly or via a probe quote), requests an\n * adjusted max quote (phase 2), and accepts phase 2 only if validation passes\n * (source gas fee token selected, gas-limit checks, affordability).\n *\n * If any step fails or validation is unsafe, it safely falls back to phase 1.\n * Successful phase-2 quotes are tagged with `metamask.isMaxGasStation = true`.\n *\n * @param request - Relay quote request for a max-amount flow.\n * @param fullRequest - Full quote request context including messenger and transaction.\n * @param getSingleQuote - Quote fetcher used for phase-1, phase-2, and probe quotes.\n * @returns The validated adjusted phase-2 quote, or the original phase-1 quote on fallback.\n */\nexport async function getRelayMaxGasStationQuote(\n  request: QuoteRequest,\n  fullRequest: PayStrategyGetQuotesRequest,\n  getSingleQuote: GetSingleQuoteFn,\n): Promise<TransactionPayQuote<RelayQuote>> {\n  const { messenger } = fullRequest;\n  const { sourceChainId, sourceTokenAmount } = request;\n  const context: MaxAmountQuoteContext = {\n    fullRequest,\n    getSingleQuote,\n    messenger,\n    request,\n  };\n\n  const phase1Quote = await getSingleQuote(request, fullRequest);\n\n  const nativeBalanceCheck = checkEnoughNativeBalanceIfSourceGasFeeTokenNotUsed(\n    phase1Quote,\n    messenger,\n    request,\n  );\n\n  if (nativeBalanceCheck.hasEnoughNativeBalance) {\n    return fallbackToPhase1(\n      phase1Quote,\n      'Native balance is sufficient for gas',\n      {\n        nativeBalance: nativeBalanceCheck.nativeBalance,\n        nativeGasCost: nativeBalanceCheck.nativeGasCostRaw,\n      },\n    );\n  }\n\n  const gasStationEligibility = getGasStationEligibility(\n    messenger,\n    sourceChainId,\n  );\n\n  if (!gasStationEligibility.isEligible) {\n    return fallbackToPhase1(\n      phase1Quote,\n      'Gas station is disabled or unsupported',\n    );\n  }\n\n  const sourceAmountBN = new BigNumber(sourceTokenAmount);\n  const probeCost = await getProbeGasCostInSourceTokenRaw(context);\n\n  if (!probeCost) {\n    return fallbackToPhase1(\n      phase1Quote,\n      'Unable to estimate gas-station source token cost',\n    );\n  }\n\n  const initialGasEstimate: GasCostEstimate = {\n    amount: probeCost,\n    source: GasCostEstimateSource.Probe,\n  };\n\n  const adjustedSourceAmount = getAdjustedSourceAmount(\n    sourceAmountBN,\n    initialGasEstimate.amount,\n  );\n\n  if (!adjustedSourceAmount.isGreaterThan(0)) {\n    return fallbackToPhase1(\n      phase1Quote,\n      'Insufficient balance for gas station after max adjustment',\n    );\n  }\n\n  const phase2Quote = await getAdjustedPhase2Quote(\n    adjustedSourceAmount,\n    initialGasEstimate,\n    context,\n  );\n\n  if (!phase2Quote) {\n    return fallbackToPhase1(\n      phase1Quote,\n      'Adjusted phase-2 quote request failed',\n    );\n  }\n\n  if (!phase2Quote.fees.isSourceGasFeeToken) {\n    return fallbackToPhase1(\n      phase1Quote,\n      'Adjusted quote did not return source gas fee token pricing',\n    );\n  }\n\n  const phase1GasLimits = phase1Quote.original.metamask.gasLimits ?? [];\n  const phase2GasLimits = phase2Quote.original.metamask.gasLimits ?? [];\n\n  if (!hasMatchingGasLimitShape(phase1GasLimits, phase2GasLimits)) {\n    return fallbackToPhase1(\n      phase1Quote,\n      'Adjusted quote gas limit shape changed between phases',\n      {\n        phase1GasLimits,\n        phase2GasLimits,\n      },\n    );\n  }\n\n  const phase1TotalGasLimit = getTotalGasLimit(phase1GasLimits);\n  const phase2TotalGasLimit = getTotalGasLimit(phase2GasLimits);\n\n  if (phase2TotalGasLimit > phase1TotalGasLimit) {\n    return fallbackToPhase1(\n      phase1Quote,\n      'Adjusted quote total gas limit increased between phases',\n      {\n        phase1TotalGasLimit,\n        phase2TotalGasLimit,\n      },\n    );\n  }\n\n  const validationGasEstimate = new BigNumber(\n    phase2Quote.fees.sourceNetwork.max.raw,\n  );\n\n  if (\n    !isAdjustedAmountAffordable(\n      adjustedSourceAmount,\n      validationGasEstimate,\n      sourceAmountBN,\n    )\n  ) {\n    return fallbackToPhase1(\n      phase1Quote,\n      'Adjusted quote fails affordability validation',\n      {\n        adjustedSourceAmount: adjustedSourceAmount.toString(10),\n        validationGasCost: validationGasEstimate.toString(10),\n      },\n    );\n  }\n\n  markQuoteAsMaxGasStation(phase2Quote);\n\n  return phase2Quote;\n}\n\nfunction checkEnoughNativeBalanceIfSourceGasFeeTokenNotUsed(\n  quote: TransactionPayQuote<RelayQuote>,\n  messenger: TransactionPayControllerMessenger,\n  request: QuoteRequest,\n): NativeBalanceCheckResult {\n  if (quote.fees.isSourceGasFeeToken) {\n    return { hasEnoughNativeBalance: false };\n  }\n\n  const nativeGasCostRaw = quote.fees.sourceNetwork.max.raw;\n  const nativeBalance = getTokenBalance(\n    messenger,\n    request.from,\n    request.sourceChainId,\n    getNativeToken(request.sourceChainId),\n  );\n\n  return {\n    hasEnoughNativeBalance: new BigNumber(nativeBalance).isGreaterThanOrEqualTo(\n      nativeGasCostRaw,\n    ),\n    nativeBalance,\n    nativeGasCostRaw,\n  };\n}\n\nfunction getAdjustedSourceAmount(\n  sourceAmount: BigNumber,\n  estimatedGasCost: BigNumber,\n): BigNumber {\n  return sourceAmount\n    .minus(estimatedGasCost)\n    .integerValue(BigNumber.ROUND_DOWN);\n}\n\nfunction isAdjustedAmountAffordable(\n  adjustedSourceAmount: BigNumber,\n  gasCost: BigNumber,\n  originalSourceAmount: BigNumber,\n): boolean {\n  return adjustedSourceAmount\n    .plus(gasCost)\n    .isLessThanOrEqualTo(originalSourceAmount);\n}\n\nasync function getAdjustedPhase2Quote(\n  adjustedSourceAmount: BigNumber,\n  initialGasEstimate: GasCostEstimate,\n  context: MaxAmountQuoteContext,\n): Promise<TransactionPayQuote<RelayQuote> | undefined> {\n  const { fullRequest, getSingleQuote, request } = context;\n\n  log('Requesting adjusted max quote', {\n    adjustedAmount: adjustedSourceAmount.toString(10),\n    gasCostInSourceToken: initialGasEstimate.amount.toString(10),\n    gasEstimateSource: initialGasEstimate.source,\n    originalAmount: request.sourceTokenAmount,\n  });\n\n  try {\n    return await getSingleQuote(\n      {\n        ...request,\n        sourceTokenAmount: adjustedSourceAmount.toFixed(\n          0,\n          BigNumber.ROUND_DOWN,\n        ),\n      },\n      fullRequest,\n    );\n  } catch (error) {\n    log('Adjusted quote request failed, falling back to phase-1 quote', {\n      error,\n    });\n    return undefined;\n  }\n}\n\nasync function getGasCostFromQuoteOrGasStation(\n  quote: TransactionPayQuote<RelayQuote>,\n  messenger: TransactionPayControllerMessenger,\n  request: QuoteRequest,\n): Promise<GasCostEstimate | undefined> {\n  const gasCost = quote.fees.sourceNetwork.max;\n\n  if (quote.fees.isSourceGasFeeToken) {\n    log('Gas cost already in source token units', { raw: gasCost.raw });\n    return {\n      amount: new BigNumber(gasCost.raw),\n      source: GasCostEstimateSource.Quote,\n    };\n  }\n\n  const firstStepData = quote.original.steps[0]?.items[0]?.data;\n\n  if (!firstStepData) {\n    return undefined;\n  }\n\n  const totalItemCount = quote.original.steps.reduce(\n    (count, step) => count + step.items.length,\n    0,\n  );\n\n  const totalGasEstimate = (quote.original.metamask.gasLimits ?? []).reduce(\n    (acc, gasLimit) => acc + gasLimit,\n    0,\n  );\n\n  const gasStationCost = await getGasStationCostInSourceTokenRaw({\n    firstStepData,\n    messenger,\n    request: {\n      from: request.from,\n      sourceChainId: request.sourceChainId,\n      sourceTokenAddress: request.sourceTokenAddress,\n    },\n    totalGasEstimate,\n    totalItemCount,\n  });\n\n  if (!gasStationCost) {\n    return undefined;\n  }\n\n  return {\n    amount: new BigNumber(gasStationCost.raw),\n    source: GasCostEstimateSource.GasStation,\n  };\n}\n\nasync function getProbeGasCostInSourceTokenRaw(\n  context: MaxAmountQuoteContext,\n): Promise<BigNumber | undefined> {\n  const { fullRequest, getSingleQuote, messenger, request } = context;\n\n  const sourceTokenInfo = getTokenInfo(\n    messenger,\n    request.sourceTokenAddress,\n    request.sourceChainId,\n  );\n\n  if (!sourceTokenInfo) {\n    return undefined;\n  }\n\n  const probeAmount = getProbeSourceAmountRaw(\n    request.sourceTokenAmount,\n    sourceTokenInfo.decimals,\n  );\n\n  if (!probeAmount || probeAmount === request.sourceTokenAmount) {\n    return undefined;\n  }\n\n  log('Requesting probe quote for gas station estimation', {\n    originalSourceAmount: request.sourceTokenAmount,\n    probeAmount,\n  });\n\n  let probeQuote: TransactionPayQuote<RelayQuote> | undefined;\n\n  try {\n    probeQuote = await getSingleQuote(\n      {\n        ...request,\n        sourceTokenAmount: probeAmount,\n      },\n      fullRequest,\n    );\n  } catch (error) {\n    log('Probe quote request failed', { error });\n    return undefined;\n  }\n\n  if (!probeQuote) {\n    return undefined;\n  }\n\n  const probeEstimate = await getGasCostFromQuoteOrGasStation(\n    probeQuote,\n    messenger,\n    request,\n  );\n\n  return probeEstimate?.amount;\n}\n\nfunction getProbeSourceAmountRaw(\n  sourceAmountRaw: string,\n  sourceDecimals: number,\n): string | undefined {\n  const sourceAmount = new BigNumber(sourceAmountRaw);\n\n  if (sourceAmount.isLessThanOrEqualTo(0)) {\n    return undefined;\n  }\n\n  const probeRawAmount = sourceAmount\n    .multipliedBy(PROBE_AMOUNT_PERCENTAGE)\n    .integerValue(BigNumber.ROUND_FLOOR);\n\n  // Minimum probe size: ~0.01 token for tokens with >=2 decimals,\n  // otherwise one raw unit for low-decimal tokens.\n  const minimumProbeRaw = new BigNumber(1).shiftedBy(\n    Math.max(sourceDecimals - 2, 0),\n  );\n\n  const probeRaw = BigNumber.minimum(\n    sourceAmount,\n    BigNumber.maximum(probeRawAmount, minimumProbeRaw),\n  ).integerValue(BigNumber.ROUND_FLOOR);\n\n  if (probeRaw.isLessThanOrEqualTo(0)) {\n    return undefined;\n  }\n\n  return probeRaw.toFixed(0);\n}\n\nfunction fallbackToPhase1(\n  phase1Quote: TransactionPayQuote<RelayQuote>,\n  message: string,\n  paramsToLog?: Record<string, unknown>,\n): TransactionPayQuote<RelayQuote> {\n  log(message, paramsToLog);\n  return phase1Quote;\n}\n\nfunction hasMatchingGasLimitShape(phase1: number[], phase2: number[]): boolean {\n  return phase1.length === phase2.length;\n}\n\nfunction getTotalGasLimit(gasLimits: number[]): number {\n  return gasLimits.reduce((total, gasLimit) => total + gasLimit, 0);\n}\n\nfunction markQuoteAsMaxGasStation(\n  quote: TransactionPayQuote<RelayQuote>,\n): void {\n  quote.original.metamask = {\n    ...quote.original.metamask,\n    isMaxGasStation: true,\n  };\n}\n"]}

package/dist/strategy/relay/relay-max-gas-station.d.cts

@@ -0,0 +1,22 @@
+import type { RelayQuote } from "./types.cjs";
+import type { PayStrategyGetQuotesRequest, QuoteRequest, TransactionPayQuote } from "../../types.cjs";
+type GetSingleQuoteFn = (request: QuoteRequest, fullRequest: PayStrategyGetQuotesRequest) => Promise<TransactionPayQuote<RelayQuote>>;
+/**
+ * Returns a Relay max-amount quote using a two-phase gas-station fallback.
+ *
+ * It first requests a standard max quote (phase 1), then when needed estimates
+ * gas in source-token units (directly or via a probe quote), requests an
+ * adjusted max quote (phase 2), and accepts phase 2 only if validation passes
+ * (source gas fee token selected, gas-limit checks, affordability).
+ *
+ * If any step fails or validation is unsafe, it safely falls back to phase 1.
+ * Successful phase-2 quotes are tagged with `metamask.isMaxGasStation = true`.
+ *
+ * @param request - Relay quote request for a max-amount flow.
+ * @param fullRequest - Full quote request context including messenger and transaction.
+ * @param getSingleQuote - Quote fetcher used for phase-1, phase-2, and probe quotes.
+ * @returns The validated adjusted phase-2 quote, or the original phase-1 quote on fallback.
+ */
+export declare function getRelayMaxGasStationQuote(request: QuoteRequest, fullRequest: PayStrategyGetQuotesRequest, getSingleQuote: GetSingleQuoteFn): Promise<TransactionPayQuote<RelayQuote>>;
+export {};
+//# sourceMappingURL=relay-max-gas-station.d.cts.map

package/dist/strategy/relay/relay-max-gas-station.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-max-gas-station.d.cts","sourceRoot":"","sources":["../../../src/strategy/relay/relay-max-gas-station.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,oBAAgB;AAE1C,OAAO,KAAK,EACV,2BAA2B,EAC3B,YAAY,EAEZ,mBAAmB,EACpB,wBAAoB;AA4BrB,KAAK,gBAAgB,GAAG,CACtB,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,2BAA2B,KACrC,OAAO,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC,CAAC;AAS9C;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,2BAA2B,EACxC,cAAc,EAAE,gBAAgB,GAC/B,OAAO,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC,CA4I1C"}

package/dist/strategy/relay/relay-max-gas-station.d.mts

@@ -0,0 +1,22 @@
+import type { RelayQuote } from "./types.mjs";
+import type { PayStrategyGetQuotesRequest, QuoteRequest, TransactionPayQuote } from "../../types.mjs";
+type GetSingleQuoteFn = (request: QuoteRequest, fullRequest: PayStrategyGetQuotesRequest) => Promise<TransactionPayQuote<RelayQuote>>;
+/**
+ * Returns a Relay max-amount quote using a two-phase gas-station fallback.
+ *
+ * It first requests a standard max quote (phase 1), then when needed estimates
+ * gas in source-token units (directly or via a probe quote), requests an
+ * adjusted max quote (phase 2), and accepts phase 2 only if validation passes
+ * (source gas fee token selected, gas-limit checks, affordability).
+ *
+ * If any step fails or validation is unsafe, it safely falls back to phase 1.
+ * Successful phase-2 quotes are tagged with `metamask.isMaxGasStation = true`.
+ *
+ * @param request - Relay quote request for a max-amount flow.
+ * @param fullRequest - Full quote request context including messenger and transaction.
+ * @param getSingleQuote - Quote fetcher used for phase-1, phase-2, and probe quotes.
+ * @returns The validated adjusted phase-2 quote, or the original phase-1 quote on fallback.
+ */
+export declare function getRelayMaxGasStationQuote(request: QuoteRequest, fullRequest: PayStrategyGetQuotesRequest, getSingleQuote: GetSingleQuoteFn): Promise<TransactionPayQuote<RelayQuote>>;
+export {};
+//# sourceMappingURL=relay-max-gas-station.d.mts.map

package/dist/strategy/relay/relay-max-gas-station.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-max-gas-station.d.mts","sourceRoot":"","sources":["../../../src/strategy/relay/relay-max-gas-station.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,oBAAgB;AAE1C,OAAO,KAAK,EACV,2BAA2B,EAC3B,YAAY,EAEZ,mBAAmB,EACpB,wBAAoB;AA4BrB,KAAK,gBAAgB,GAAG,CACtB,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,2BAA2B,KACrC,OAAO,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC,CAAC;AAS9C;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,2BAA2B,EACxC,cAAc,EAAE,gBAAgB,GAC/B,OAAO,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC,CA4I1C"}