@metamask/transaction-pay-controller 23.13.1 → 23.15.0

package/dist/strategy/relay/hyperliquid-activation.d.cts

@@ -0,0 +1,46 @@
+import type { QuoteRequest, TransactionPayControllerMessenger } from "../../types.cjs";
+/**
+ * Minimal shape of a HyperLiquid `userNonFundingLedgerUpdates` entry. Only the
+ * fields used to determine transfer direction are typed.
+ */
+export type HyperLiquidLedgerUpdate = {
+    delta?: {
+        type?: string;
+        user?: string;
+        destination?: string;
+    };
+};
+/**
+ * Whether the HyperCore account has already paid the activation fee.
+ *
+ * The fee is charged on the account's first outbound send/withdrawal, so an
+ * account that has only ever received deposits (or has no non-funding ledger
+ * history) is treated as unactivated. Direction matters: only entries the
+ * account itself initiated count.
+ *
+ * @param updates - Raw HyperLiquid non-funding ledger updates.
+ * @param address - The account's address.
+ * @returns True when the account has made a prior outbound transfer.
+ */
+export declare function isHyperLiquidAccountActivated(updates: HyperLiquidLedgerUpdate[], address: string): boolean;
+/**
+ * Reserve the one-time HyperLiquid activation fee for an unactivated HyperCore
+ * source account.
+ *
+ * Reduces the amount sent to the provider so HyperLiquid retains enough balance
+ * for the activation fee on the `sendAsset` step, and records the reserved fee
+ * (USD) so it can be added to the provider fee — keeping the displayed
+ * withdrawal amount unchanged.
+ *
+ * No-op for non-HyperLiquid sources, when the feature flag is disabled, when
+ * the account is already activated, or when the amount is too small to reserve.
+ *
+ * @param request - Normalized quote request.
+ * @param messenger - Controller messenger.
+ * @param transactionType - Parent transaction type used to resolve the feature
+ * flag override.
+ * @param signal - Optional abort signal forwarded to the activation request.
+ * @returns The (possibly adjusted) quote request.
+ */
+export declare function applyHyperliquidActivationFee(request: QuoteRequest, messenger: TransactionPayControllerMessenger, transactionType?: string, signal?: AbortSignal): Promise<QuoteRequest>;
+//# sourceMappingURL=hyperliquid-activation.d.cts.map

package/dist/strategy/relay/hyperliquid-activation.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperliquid-activation.d.cts","sourceRoot":"","sources":["../../../src/strategy/relay/hyperliquid-activation.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,YAAY,EACZ,iCAAiC,EAClC,wBAAoB;AAcrB;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,CAAC,EAAE;QACN,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH,CAAC;AAmCF;;;;;;;;;;;GAWG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,uBAAuB,EAAE,EAClC,OAAO,EAAE,MAAM,GACd,OAAO,CAUT;AA8CD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,iCAAiC,EAC5C,eAAe,CAAC,EAAE,MAAM,EACxB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,CAAC,CA4CvB"}

package/dist/strategy/relay/hyperliquid-activation.d.mts

@@ -0,0 +1,46 @@
+import type { QuoteRequest, TransactionPayControllerMessenger } from "../../types.mjs";
+/**
+ * Minimal shape of a HyperLiquid `userNonFundingLedgerUpdates` entry. Only the
+ * fields used to determine transfer direction are typed.
+ */
+export type HyperLiquidLedgerUpdate = {
+    delta?: {
+        type?: string;
+        user?: string;
+        destination?: string;
+    };
+};
+/**
+ * Whether the HyperCore account has already paid the activation fee.
+ *
+ * The fee is charged on the account's first outbound send/withdrawal, so an
+ * account that has only ever received deposits (or has no non-funding ledger
+ * history) is treated as unactivated. Direction matters: only entries the
+ * account itself initiated count.
+ *
+ * @param updates - Raw HyperLiquid non-funding ledger updates.
+ * @param address - The account's address.
+ * @returns True when the account has made a prior outbound transfer.
+ */
+export declare function isHyperLiquidAccountActivated(updates: HyperLiquidLedgerUpdate[], address: string): boolean;
+/**
+ * Reserve the one-time HyperLiquid activation fee for an unactivated HyperCore
+ * source account.
+ *
+ * Reduces the amount sent to the provider so HyperLiquid retains enough balance
+ * for the activation fee on the `sendAsset` step, and records the reserved fee
+ * (USD) so it can be added to the provider fee — keeping the displayed
+ * withdrawal amount unchanged.
+ *
+ * No-op for non-HyperLiquid sources, when the feature flag is disabled, when
+ * the account is already activated, or when the amount is too small to reserve.
+ *
+ * @param request - Normalized quote request.
+ * @param messenger - Controller messenger.
+ * @param transactionType - Parent transaction type used to resolve the feature
+ * flag override.
+ * @param signal - Optional abort signal forwarded to the activation request.
+ * @returns The (possibly adjusted) quote request.
+ */
+export declare function applyHyperliquidActivationFee(request: QuoteRequest, messenger: TransactionPayControllerMessenger, transactionType?: string, signal?: AbortSignal): Promise<QuoteRequest>;
+//# sourceMappingURL=hyperliquid-activation.d.mts.map

package/dist/strategy/relay/hyperliquid-activation.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperliquid-activation.d.mts","sourceRoot":"","sources":["../../../src/strategy/relay/hyperliquid-activation.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,YAAY,EACZ,iCAAiC,EAClC,wBAAoB;AAcrB;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,CAAC,EAAE;QACN,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH,CAAC;AAmCF;;;;;;;;;;;GAWG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,uBAAuB,EAAE,EAClC,OAAO,EAAE,MAAM,GACd,OAAO,CAUT;AA8CD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,iCAAiC,EAC5C,eAAe,CAAC,EAAE,MAAM,EACxB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,CAAC,CA4CvB"}

package/dist/strategy/relay/hyperliquid-activation.mjs

@@ -0,0 +1,150 @@
+import { createModuleLogger } from "@metamask/utils";
+import { BigNumber } from "bignumber.js";
+import { HYPERCORE_USDC_DECIMALS } from "../../constants.mjs";
+import { projectLogger } from "../../logger.mjs";
+import { getHyperliquidActivationFeeConfig } from "../../utils/feature-flags.mjs";
+import { HYPERLIQUID_INFO_URL } from "./constants.mjs";
+const log = createModuleLogger(projectLogger, 'hyperliquid-activation');
+/**
+ * HyperLiquid non-funding ledger `delta` types that represent an outbound
+ * transfer initiated by the account (and therefore pay the activation fee).
+ * A funding deposit can arrive as an inbound `send`, so direction is checked
+ * for transfer types via the `user`/`destination` fields.
+ */
+const OUTBOUND_TRANSFER_TYPES = new Set(['send', 'spotTransfer']);
+/**
+ * Whether a single ledger entry is an outbound action initiated by the account.
+ *
+ * @param update - The ledger entry.
+ * @param normalizedAddress - The account's lowercased address.
+ * @returns True when the account itself sent funds out.
+ */
+function isOutboundFromAccount(update, normalizedAddress) {
+    const delta = update?.delta;
+    if (!delta?.type) {
+        return false;
+    }
+    // Bridge withdrawals are always outbound from the account.
+    if (delta.type === 'withdraw') {
+        return true;
+    }
+    // A spot send/transfer counts only when this account is the sender and the
+    // funds leave it (an inbound receipt has `user` set to the other party).
+    if (OUTBOUND_TRANSFER_TYPES.has(delta.type)) {
+        const sender = delta.user?.toLowerCase();
+        const destination = delta.destination?.toLowerCase();
+        return sender === normalizedAddress && destination !== normalizedAddress;
+    }
+    return false;
+}
+/**
+ * Whether the HyperCore account has already paid the activation fee.
+ *
+ * The fee is charged on the account's first outbound send/withdrawal, so an
+ * account that has only ever received deposits (or has no non-funding ledger
+ * history) is treated as unactivated. Direction matters: only entries the
+ * account itself initiated count.
+ *
+ * @param updates - Raw HyperLiquid non-funding ledger updates.
+ * @param address - The account's address.
+ * @returns True when the account has made a prior outbound transfer.
+ */
+export function isHyperLiquidAccountActivated(updates, address) {
+    if (!address) {
+        return false;
+    }
+    const normalizedAddress = address.toLowerCase();
+    return updates.some((update) => isOutboundFromAccount(update, normalizedAddress));
+}
+/**
+ * Query HyperLiquid for the account's activation state.
+ *
+ * On any error (network failure, non-OK response, malformed body) the account
+ * is treated as activated so the common path is never penalised by a transient
+ * HyperLiquid outage; an unactivated account would then surface the original
+ * HyperLiquid error, matching the pre-feature behaviour.
+ *
+ * @param address - The HyperCore account address.
+ * @param signal - Optional abort signal forwarded to the request.
+ * @returns True when the account is activated (or activation can't be determined).
+ */
+async function fetchIsAccountActivated(address, signal) {
+    try {
+        const response = await fetch(HYPERLIQUID_INFO_URL, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                type: 'userNonFundingLedgerUpdates',
+                user: address,
+                startTime: 0,
+            }),
+            signal,
+        });
+        if (!response.ok) {
+            log('Activation check returned non-OK, assuming activated', {
+                status: response.status,
+            });
+            return true;
+        }
+        const updates = (await response.json());
+        return isHyperLiquidAccountActivated(updates, address);
+    }
+    catch (error) {
+        log('Activation check failed, assuming activated', { error });
+        return true;
+    }
+}
+/**
+ * Reserve the one-time HyperLiquid activation fee for an unactivated HyperCore
+ * source account.
+ *
+ * Reduces the amount sent to the provider so HyperLiquid retains enough balance
+ * for the activation fee on the `sendAsset` step, and records the reserved fee
+ * (USD) so it can be added to the provider fee — keeping the displayed
+ * withdrawal amount unchanged.
+ *
+ * No-op for non-HyperLiquid sources, when the feature flag is disabled, when
+ * the account is already activated, or when the amount is too small to reserve.
+ *
+ * @param request - Normalized quote request.
+ * @param messenger - Controller messenger.
+ * @param transactionType - Parent transaction type used to resolve the feature
+ * flag override.
+ * @param signal - Optional abort signal forwarded to the activation request.
+ * @returns The (possibly adjusted) quote request.
+ */
+export async function applyHyperliquidActivationFee(request, messenger, transactionType, signal) {
+    if (!request.isHyperliquidSource) {
+        return request;
+    }
+    const { enabled, amountUsd } = getHyperliquidActivationFeeConfig(messenger, transactionType);
+    if (!enabled) {
+        return request;
+    }
+    const activated = await fetchIsAccountActivated(request.from, signal);
+    if (activated) {
+        return request;
+    }
+    const feeRaw = new BigNumber(amountUsd).shiftedBy(HYPERCORE_USDC_DECIMALS);
+    const reducedAmount = new BigNumber(request.sourceTokenAmount).minus(feeRaw);
+    // Can't reserve more than the balance — let the original amount through so
+    // the existing HyperLiquid error surfaces (withdrawable <= activation fee).
+    if (reducedAmount.lte(0)) {
+        log('Skipping activation reserve as amount is not greater than fee', {
+            sourceTokenAmount: request.sourceTokenAmount,
+            feeRaw: feeRaw.toFixed(0),
+        });
+        return request;
+    }
+    log('Reserving HyperLiquid activation fee', {
+        amountUsd,
+        originalSourceTokenAmount: request.sourceTokenAmount,
+        reducedSourceTokenAmount: reducedAmount.toFixed(0),
+    });
+    return {
+        ...request,
+        sourceTokenAmount: reducedAmount.toFixed(0),
+        hyperliquidActivationFeeUsd: String(amountUsd),
+    };
+}
+//# sourceMappingURL=hyperliquid-activation.mjs.map

package/dist/strategy/relay/hyperliquid-activation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperliquid-activation.mjs","sourceRoot":"","sources":["../../../src/strategy/relay/hyperliquid-activation.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Hex } from '@metamask/utils';\nimport { createModuleLogger } from '@metamask/utils';\nimport { BigNumber } from 'bignumber.js';\n\nimport { HYPERCORE_USDC_DECIMALS } from '../../constants';\nimport { projectLogger } from '../../logger';\nimport type {\n  QuoteRequest,\n  TransactionPayControllerMessenger,\n} from '../../types';\nimport { getHyperliquidActivationFeeConfig } from '../../utils/feature-flags';\nimport { HYPERLIQUID_INFO_URL } from './constants';\n\nconst log = createModuleLogger(projectLogger, 'hyperliquid-activation');\n\n/**\n * HyperLiquid non-funding ledger `delta` types that represent an outbound\n * transfer initiated by the account (and therefore pay the activation fee).\n * A funding deposit can arrive as an inbound `send`, so direction is checked\n * for transfer types via the `user`/`destination` fields.\n */\nconst OUTBOUND_TRANSFER_TYPES = new Set(['send', 'spotTransfer']);\n\n/**\n * Minimal shape of a HyperLiquid `userNonFundingLedgerUpdates` entry. Only the\n * fields used to determine transfer direction are typed.\n */\nexport type HyperLiquidLedgerUpdate = {\n  delta?: {\n    type?: string;\n    user?: string;\n    destination?: string;\n  };\n};\n\n/**\n * Whether a single ledger entry is an outbound action initiated by the account.\n *\n * @param update - The ledger entry.\n * @param normalizedAddress - The account's lowercased address.\n * @returns True when the account itself sent funds out.\n */\nfunction isOutboundFromAccount(\n  update: HyperLiquidLedgerUpdate,\n  normalizedAddress: string,\n): boolean {\n  const delta = update?.delta;\n\n  if (!delta?.type) {\n    return false;\n  }\n\n  // Bridge withdrawals are always outbound from the account.\n  if (delta.type === 'withdraw') {\n    return true;\n  }\n\n  // A spot send/transfer counts only when this account is the sender and the\n  // funds leave it (an inbound receipt has `user` set to the other party).\n  if (OUTBOUND_TRANSFER_TYPES.has(delta.type)) {\n    const sender = delta.user?.toLowerCase();\n    const destination = delta.destination?.toLowerCase();\n    return sender === normalizedAddress && destination !== normalizedAddress;\n  }\n\n  return false;\n}\n\n/**\n * Whether the HyperCore account has already paid the activation fee.\n *\n * The fee is charged on the account's first outbound send/withdrawal, so an\n * account that has only ever received deposits (or has no non-funding ledger\n * history) is treated as unactivated. Direction matters: only entries the\n * account itself initiated count.\n *\n * @param updates - Raw HyperLiquid non-funding ledger updates.\n * @param address - The account's address.\n * @returns True when the account has made a prior outbound transfer.\n */\nexport function isHyperLiquidAccountActivated(\n  updates: HyperLiquidLedgerUpdate[],\n  address: string,\n): boolean {\n  if (!address) {\n    return false;\n  }\n\n  const normalizedAddress = address.toLowerCase();\n\n  return updates.some((update) =>\n    isOutboundFromAccount(update, normalizedAddress),\n  );\n}\n\n/**\n * Query HyperLiquid for the account's activation state.\n *\n * On any error (network failure, non-OK response, malformed body) the account\n * is treated as activated so the common path is never penalised by a transient\n * HyperLiquid outage; an unactivated account would then surface the original\n * HyperLiquid error, matching the pre-feature behaviour.\n *\n * @param address - The HyperCore account address.\n * @param signal - Optional abort signal forwarded to the request.\n * @returns True when the account is activated (or activation can't be determined).\n */\nasync function fetchIsAccountActivated(\n  address: Hex,\n  signal?: AbortSignal,\n): Promise<boolean> {\n  try {\n    const response = await fetch(HYPERLIQUID_INFO_URL, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify({\n        type: 'userNonFundingLedgerUpdates',\n        user: address,\n        startTime: 0,\n      }),\n      signal,\n    });\n\n    if (!response.ok) {\n      log('Activation check returned non-OK, assuming activated', {\n        status: response.status,\n      });\n      return true;\n    }\n\n    const updates = (await response.json()) as HyperLiquidLedgerUpdate[];\n\n    return isHyperLiquidAccountActivated(updates, address);\n  } catch (error) {\n    log('Activation check failed, assuming activated', { error });\n    return true;\n  }\n}\n\n/**\n * Reserve the one-time HyperLiquid activation fee for an unactivated HyperCore\n * source account.\n *\n * Reduces the amount sent to the provider so HyperLiquid retains enough balance\n * for the activation fee on the `sendAsset` step, and records the reserved fee\n * (USD) so it can be added to the provider fee — keeping the displayed\n * withdrawal amount unchanged.\n *\n * No-op for non-HyperLiquid sources, when the feature flag is disabled, when\n * the account is already activated, or when the amount is too small to reserve.\n *\n * @param request - Normalized quote request.\n * @param messenger - Controller messenger.\n * @param transactionType - Parent transaction type used to resolve the feature\n * flag override.\n * @param signal - Optional abort signal forwarded to the activation request.\n * @returns The (possibly adjusted) quote request.\n */\nexport async function applyHyperliquidActivationFee(\n  request: QuoteRequest,\n  messenger: TransactionPayControllerMessenger,\n  transactionType?: string,\n  signal?: AbortSignal,\n): Promise<QuoteRequest> {\n  if (!request.isHyperliquidSource) {\n    return request;\n  }\n\n  const { enabled, amountUsd } = getHyperliquidActivationFeeConfig(\n    messenger,\n    transactionType,\n  );\n\n  if (!enabled) {\n    return request;\n  }\n\n  const activated = await fetchIsAccountActivated(request.from, signal);\n\n  if (activated) {\n    return request;\n  }\n\n  const feeRaw = new BigNumber(amountUsd).shiftedBy(HYPERCORE_USDC_DECIMALS);\n  const reducedAmount = new BigNumber(request.sourceTokenAmount).minus(feeRaw);\n\n  // Can't reserve more than the balance — let the original amount through so\n  // the existing HyperLiquid error surfaces (withdrawable <= activation fee).\n  if (reducedAmount.lte(0)) {\n    log('Skipping activation reserve as amount is not greater than fee', {\n      sourceTokenAmount: request.sourceTokenAmount,\n      feeRaw: feeRaw.toFixed(0),\n    });\n    return request;\n  }\n\n  log('Reserving HyperLiquid activation fee', {\n    amountUsd,\n    originalSourceTokenAmount: request.sourceTokenAmount,\n    reducedSourceTokenAmount: reducedAmount.toFixed(0),\n  });\n\n  return {\n    ...request,\n    sourceTokenAmount: reducedAmount.toFixed(0),\n    hyperliquidActivationFeeUsd: String(amountUsd),\n  };\n}\n"]}

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

@@ -17,6 +17,7 @@ const quote_gas_1 = require("../../utils/quote-gas.cjs");
 const token_1 = require("../../utils/token.cjs");
 const transaction_1 = require("../../utils/transaction.cjs");
 const constants_2 = require("./constants.cjs");
+const hyperliquid_activation_1 = require("./hyperliquid-activation.cjs");
 const withdraw_1 = require("./polymarket/withdraw.cjs");
 const relay_api_1 = require("./relay-api.cjs");
 const relay_max_gas_station_1 = require("./relay-max-gas-station.cjs");
@@ -26,6 +27,7 @@ const log = (0, utils_1.createModuleLogger)(logger_1.projectLogger, 'relay-strat
 const POST_QUOTE_GAS_BUFFER = 1.1;
 // Hardcoded gas allowance for the prepended payment override transaction(s).
 const PAYMENT_OVERRIDE_GAS = 75000;
+const ZERO_AMOUNT = { fiat: '0', human: '0', raw: '0', usd: '0' };
 /**
  * Fetches Relay quotes.
  *
@@ -36,7 +38,7 @@ async function getRelayQuotes(request) {
     const { requests } = request;
     log('Fetching quotes', requests);
     try {
-        const normalizedRequests = requests
+        const normalizedRequests = await Promise.all(requests
             .filter((singleRequest) => {
             const hasTargetMinimum = singleRequest.targetAmountMinimum !== '0';
             const isPostQuote = Boolean(singleRequest.isPostQuote);
@@ -44,7 +46,8 @@ async function getRelayQuotes(request) {
                 new bignumber_js_1.BigNumber(singleRequest.sourceTokenAmount).gt(0);
             return hasTargetMinimum || isPostQuote || isExactInputRequest;
         })
-            .map((singleRequest) => normalizeRequest(singleRequest, request.transaction));
+            .map((singleRequest) => normalizeRequest(singleRequest, request.transaction))
+            .map((normalizedRequest) => (0, hyperliquid_activation_1.applyHyperliquidActivationFee)(normalizedRequest, request.messenger, request.transaction.type, request.signal)));
         log('Normalized requests', normalizedRequests);
         return await Promise.all(normalizedRequests.map((singleRequest) => getQuoteWithMaxAmountHandling(singleRequest, request)));
     }
@@ -356,11 +359,15 @@ async function normalizeQuote(quote, request, fullRequest) {
     const subsidizedFeeUsd = getSubsidizedFeeAmountUsd(quote);
     const appFeeUsd = new bignumber_js_1.BigNumber(quote.fees?.app?.amountUsd ?? '0');
     const metaMaskFee = (0, amounts_1.getFiatValueFromUsd)(appFeeUsd, usdToFiatRate);
-    // Subtract app fee from provider fee since totalImpact.usd already includes it
-    const providerFeeUsd = calculateProviderFee(quote).minus(appFeeUsd);
-    const provider = subsidizedFeeUsd.gt(0)
-        ? { usd: '0', fiat: '0' }
-        : (0, amounts_1.getFiatValueFromUsd)(providerFeeUsd, usdToFiatRate);
+    // Subtract app fee from provider fee since totalImpact.usd already includes
+    // it. The relay provider fee is forced to zero when the quote is subsidized,
+    // but any reserved HyperLiquid activation fee is withheld from the source
+    // send regardless, so it must always be surfaced in the provider fee.
+    const activationFeeUsd = new bignumber_js_1.BigNumber(request.hyperliquidActivationFeeUsd ?? '0');
+    const providerFeeUsd = subsidizedFeeUsd.gt(0)
+        ? activationFeeUsd
+        : calculateProviderFee(quote).minus(appFeeUsd).plus(activationFeeUsd);
+    const provider = (0, amounts_1.getFiatValueFromUsd)(providerFeeUsd, usdToFiatRate);
     const { gasLimits, is7702, isGasFeeToken: isSourceGasFeeToken, ...sourceNetwork } = await calculateSourceNetworkCost(quote, messenger, request, fullRequest.transaction);
     const targetNetwork = {
         usd: '0',
@@ -466,10 +473,9 @@ async function calculateSourceNetworkCost(quote, messenger, request, transaction
     const { from, sourceChainId, sourceTokenAddress } = request;
     if (quote.metamask?.isExecute) {
         log('Zeroing network fees for execute flow');
-        const zeroAmount = { fiat: '0', human: '0', raw: '0', usd: '0' };
         return {
-            estimate: zeroAmount,
-            max: zeroAmount,
+            estimate: ZERO_AMOUNT,
+            max: ZERO_AMOUNT,
             gasLimits: [],
             is7702: false,
         };
@@ -478,14 +484,26 @@ async function calculateSourceNetworkCost(quote, messenger, request, transaction
     // sendAsset (off-chain signature), not an on-chain transaction.
     if (request.isHyperliquidSource) {
         log('Zeroing network fees for HyperLiquid withdrawal (gasless)');
-        const zeroAmount = { fiat: '0', human: '0', raw: '0', usd: '0' };
         return {
-            estimate: zeroAmount,
-            max: zeroAmount,
+            estimate: ZERO_AMOUNT,
+            max: ZERO_AMOUNT,
             gasLimits: [],
             is7702: false,
         };
     }
+    if (transaction.isGasFeeSponsored &&
+        request.sourceChainId === transaction.chainId &&
+        request.targetChainId === transaction.chainId) {
+        log('Zeroing source network fees for sponsored same-chain Relay route');
+        // Gas limit is zero as sponsored transactions go through the EIP-7702
+        // gas station hook and do not require user-paid gas.
+        return {
+            estimate: ZERO_AMOUNT,
+            max: ZERO_AMOUNT,
+            gasLimits: [0],
+            is7702: true,
+        };
+    }
     const txSteps = quote.steps.filter((step) => step.kind === 'transaction');
     const relayParams = txSteps
         .flatMap((step) => step.items)