@metamask-previews/transaction-pay-controller 23.17.4-preview-8980fa5 → 23.17.4-preview-9a5366037

package/CHANGELOG.md

@@ -7,10 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Add an optional `isSubsidized` flag to `GetDelegationTransactionCallback` and send a signed `metamask` envelope with `executeVersion: 2` for Relay executes ([#9298](https://github.com/MetaMask/core/pull/9298))
+
 ### Changed
 
 - Refactor vault deposit utilities into shared `utils/` modules (`chomp`, `ma-vault-deposit`, `relay-post-ma-vault`) to prepare for the Relay Money Account deposit path ([#9303](https://github.com/MetaMask/core/pull/9303))
-- Bump `@metamask/messenger` from `^1.2.0` to `^2.0.0` ([#9392](https://github.com/MetaMask/core/pull/9392))
 
 ## [23.17.4]
 

package/dist/strategy/relay/relay-submit-execute.cjs

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.submitViaRelayExecute = void 0;
+const utils_1 = require("@metamask/utils");
+const bignumber_js_1 = require("bignumber.js");
+const logger_1 = require("../../logger.cjs");
+const error_prefix_1 = require("../../utils/error-prefix.cjs");
+const provider_1 = require("../../utils/provider.cjs");
+const constants_1 = require("./constants.cjs");
+const relay_api_1 = require("./relay-api.cjs");
+const log = (0, utils_1.createModuleLogger)(logger_1.projectLogger, 'relay-strategy');
+const RELAY_EXECUTE_ERROR_PREFIX = 'Execute: ';
+async function submitViaRelayExecute(quote, transaction, messenger, allParams) {
+    const isSubsidized = isSubsidizedRelayQuote(quote.original);
+    const requestId = getRelayExecuteRequestId(quote.original);
+    const metamask = getRelayExecuteMetamask(quote.original, isSubsidized);
+    const { from, sourceChainId } = quote.request;
+    const networkClientId = (0, provider_1.getNetworkClientId)(messenger, sourceChainId);
+    const executionTransaction = {
+        ...transaction,
+        chainId: sourceChainId,
+        networkClientId,
+        nestedTransactions: allParams.map((param) => ({
+            data: (param.data ?? '0x'),
+            to: param.to,
+            value: (param.value ?? '0x0'),
+        })),
+        txParams: {
+            ...transaction.txParams,
+            from,
+        },
+    };
+    const delegation = await messenger.call('TransactionPayController:getDelegationTransaction', { transaction: executionTransaction, isSubsidized });
+    log('Delegation result for execute', delegation);
+    const executeBody = {
+        executionKind: 'rawCalls',
+        data: {
+            chainId: Number(quote.request.sourceChainId),
+            to: delegation.to,
+            data: delegation.data,
+            value: new bignumber_js_1.BigNumber(delegation.value).toFixed(),
+            ...mapAuthorizationList(delegation.authorizationList),
+        },
+        executionOptions: {
+            subsidizeFees: false,
+        },
+        requestId,
+        metamask,
+    };
+    log('Submitting to Relay execute', { executeBody, from: quote.request.from });
+    let result;
+    try {
+        result = await (0, relay_api_1.submitRelayExecute)(messenger, executeBody);
+    }
+    catch (error) {
+        throw (0, error_prefix_1.prefixError)(error, RELAY_EXECUTE_ERROR_PREFIX);
+    }
+    log('Relay execute response', result);
+    // Server may return a different requestId (e.g. after JIT quote for subsidized).
+    // Replace the original quote requestId so waitForRelayCompletion polls the correct request.
+    replaceFirstStepRequestId(quote.original, result.requestId);
+    return constants_1.FALLBACK_HASH;
+}
+exports.submitViaRelayExecute = submitViaRelayExecute;
+function isSubsidizedRelayQuote(quote) {
+    return Number(quote.fees?.subsidized?.amountUsd ?? '0') > 0;
+}
+function stripRelayExecuteMarker(requestId) {
+    return requestId.includes('#mm')
+        ? requestId.slice(0, requestId.indexOf('#mm'))
+        : requestId;
+}
+function getRelayExecuteRequestId(quote) {
+    const requestId = quote.steps?.[0]?.requestId;
+    if (!requestId) {
+        throw new Error('Relay: Execute: Missing requestId in quote step');
+    }
+    return stripRelayExecuteMarker(requestId);
+}
+function getRelayExecuteMetamask(quote, isSubsidized) {
+    const signature = quote.metamask?.signature;
+    if (!signature) {
+        throw new Error('Relay: Execute: Missing metamask.signature — cannot submit to /relay/execute without the HMAC token');
+    }
+    return {
+        isSubsidized,
+        quoteRequest: quote.request,
+        signature,
+    };
+}
+function mapAuthorizationList(authorizationList) {
+    if (!authorizationList?.length) {
+        return {};
+    }
+    return {
+        authorizationList: authorizationList.map((auth) => ({
+            chainId: Number(auth.chainId),
+            address: auth.address,
+            nonce: Number(auth.nonce),
+            yParity: Number(auth.yParity),
+            r: auth.r,
+            s: auth.s,
+        })),
+    };
+}
+function replaceFirstStepRequestId(quote, requestId) {
+    /* istanbul ignore next: requestId is read from steps[0] earlier, so steps is non-empty here; defensive guard. */
+    const steps = quote.steps ?? [];
+    /* istanbul ignore if: requestId is read from steps[0] earlier, so steps is non-empty here; defensive guard. */
+    if (steps.length === 0) {
+        throw new Error('Relay: Execute: Cannot update requestId — quote has no steps');
+    }
+    const existingStep = steps[0];
+    const remainingSteps = steps.slice(1);
+    quote.steps = [{ ...existingStep, requestId }, ...remainingSteps];
+}
+//# sourceMappingURL=relay-submit-execute.cjs.map

package/dist/strategy/relay/relay-submit-execute.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-submit-execute.cjs","sourceRoot":"","sources":["../../../src/strategy/relay/relay-submit-execute.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TransactionParams } from '@metamask/transaction-controller';\nimport type {\n  AuthorizationList,\n  TransactionMeta,\n} 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  TransactionPayControllerMessenger,\n  TransactionPayQuote,\n} from '../../types';\nimport { prefixError } from '../../utils/error-prefix';\nimport { getNetworkClientId } from '../../utils/provider';\nimport { FALLBACK_HASH } from './constants';\nimport { submitRelayExecute } from './relay-api';\nimport type { RelayExecuteRequest, RelayQuote } from './types';\n\nconst log = createModuleLogger(projectLogger, 'relay-strategy');\nconst RELAY_EXECUTE_ERROR_PREFIX = 'Execute: ';\n\nexport async function submitViaRelayExecute(\n  quote: TransactionPayQuote<RelayQuote>,\n  transaction: TransactionMeta,\n  messenger: TransactionPayControllerMessenger,\n  allParams: TransactionParams[],\n): Promise<Hex> {\n  const isSubsidized = isSubsidizedRelayQuote(quote.original);\n  const requestId = getRelayExecuteRequestId(quote.original);\n  const metamask = getRelayExecuteMetamask(quote.original, isSubsidized);\n\n  const { from, sourceChainId } = quote.request;\n  const networkClientId = getNetworkClientId(messenger, sourceChainId);\n\n  const executionTransaction: TransactionMeta = {\n    ...transaction,\n    chainId: sourceChainId,\n    networkClientId,\n    nestedTransactions: allParams.map((param) => ({\n      data: (param.data ?? '0x') as Hex,\n      to: param.to as Hex,\n      value: (param.value ?? '0x0') as Hex,\n    })),\n    txParams: {\n      ...transaction.txParams,\n      from,\n    },\n  } as TransactionMeta;\n\n  const delegation = await messenger.call(\n    'TransactionPayController:getDelegationTransaction',\n    { transaction: executionTransaction, isSubsidized },\n  );\n\n  log('Delegation result for execute', delegation);\n\n  const executeBody: RelayExecuteRequest = {\n    executionKind: 'rawCalls',\n    data: {\n      chainId: Number(quote.request.sourceChainId),\n      to: delegation.to,\n      data: delegation.data,\n      value: new BigNumber(delegation.value).toFixed(),\n      ...mapAuthorizationList(delegation.authorizationList),\n    },\n    executionOptions: {\n      subsidizeFees: false,\n    },\n    requestId,\n    metamask,\n  };\n\n  log('Submitting to Relay execute', { executeBody, from: quote.request.from });\n\n  let result;\n  try {\n    result = await submitRelayExecute(messenger, executeBody);\n  } catch (error) {\n    throw prefixError(error, RELAY_EXECUTE_ERROR_PREFIX);\n  }\n\n  log('Relay execute response', result);\n\n  // Server may return a different requestId (e.g. after JIT quote for subsidized).\n  // Replace the original quote requestId so waitForRelayCompletion polls the correct request.\n  replaceFirstStepRequestId(quote.original, result.requestId);\n\n  return FALLBACK_HASH;\n}\n\nfunction isSubsidizedRelayQuote(quote: RelayQuote): boolean {\n  return Number(quote.fees?.subsidized?.amountUsd ?? '0') > 0;\n}\n\nfunction stripRelayExecuteMarker(requestId: string): string {\n  return requestId.includes('#mm')\n    ? requestId.slice(0, requestId.indexOf('#mm'))\n    : requestId;\n}\n\nfunction getRelayExecuteRequestId(quote: RelayQuote): string {\n  const requestId = quote.steps?.[0]?.requestId;\n  if (!requestId) {\n    throw new Error('Relay: Execute: Missing requestId in quote step');\n  }\n  return stripRelayExecuteMarker(requestId);\n}\n\nfunction getRelayExecuteMetamask(\n  quote: RelayQuote,\n  isSubsidized: boolean,\n): {\n  isSubsidized: boolean;\n  quoteRequest: RelayQuote['request'];\n  signature: string;\n} {\n  const signature = quote.metamask?.signature;\n  if (!signature) {\n    throw new Error(\n      'Relay: Execute: Missing metamask.signature — cannot submit to /relay/execute without the HMAC token',\n    );\n  }\n  return {\n    isSubsidized,\n    quoteRequest: quote.request,\n    signature,\n  };\n}\n\nfunction mapAuthorizationList(\n  authorizationList: AuthorizationList | undefined,\n): {\n  authorizationList?: {\n    chainId: number;\n    address: Hex;\n    nonce: number;\n    yParity: number;\n    r: Hex;\n    s: Hex;\n  }[];\n} {\n  if (!authorizationList?.length) {\n    return {};\n  }\n  return {\n    authorizationList: authorizationList.map((auth) => ({\n      chainId: Number(auth.chainId),\n      address: auth.address,\n      nonce: Number(auth.nonce),\n      yParity: Number(auth.yParity),\n      r: auth.r as Hex,\n      s: auth.s as Hex,\n    })),\n  };\n}\n\nfunction replaceFirstStepRequestId(quote: RelayQuote, requestId: string): void {\n  /* istanbul ignore next: requestId is read from steps[0] earlier, so steps is non-empty here; defensive guard. */\n  const steps = quote.steps ?? [];\n  /* istanbul ignore if: requestId is read from steps[0] earlier, so steps is non-empty here; defensive guard. */\n  if (steps.length === 0) {\n    throw new Error(\n      'Relay: Execute: Cannot update requestId — quote has no steps',\n    );\n  }\n\n  const existingStep = steps[0];\n  const remainingSteps = steps.slice(1);\n\n  quote.steps = [{ ...existingStep, requestId }, ...remainingSteps];\n}\n"]}

package/dist/strategy/relay/relay-submit-execute.d.cts

@@ -0,0 +1,7 @@
+import type { TransactionParams } from "@metamask/transaction-controller";
+import type { TransactionMeta } from "@metamask/transaction-controller";
+import type { Hex } from "@metamask/utils";
+import type { TransactionPayControllerMessenger, TransactionPayQuote } from "../../types.cjs";
+import type { RelayQuote } from "./types.cjs";
+export declare function submitViaRelayExecute(quote: TransactionPayQuote<RelayQuote>, transaction: TransactionMeta, messenger: TransactionPayControllerMessenger, allParams: TransactionParams[]): Promise<Hex>;
+//# sourceMappingURL=relay-submit-execute.d.cts.map

package/dist/strategy/relay/relay-submit-execute.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-submit-execute.d.cts","sourceRoot":"","sources":["../../../src/strategy/relay/relay-submit-execute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,yCAAyC;AAC1E,OAAO,KAAK,EAEV,eAAe,EAChB,yCAAyC;AAC1C,OAAO,KAAK,EAAE,GAAG,EAAE,wBAAwB;AAK3C,OAAO,KAAK,EACV,iCAAiC,EACjC,mBAAmB,EACpB,wBAAoB;AAKrB,OAAO,KAAK,EAAuB,UAAU,EAAE,oBAAgB;AAK/D,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,mBAAmB,CAAC,UAAU,CAAC,EACtC,WAAW,EAAE,eAAe,EAC5B,SAAS,EAAE,iCAAiC,EAC5C,SAAS,EAAE,iBAAiB,EAAE,GAC7B,OAAO,CAAC,GAAG,CAAC,CA8Dd"}

package/dist/strategy/relay/relay-submit-execute.d.mts

@@ -0,0 +1,7 @@
+import type { TransactionParams } from "@metamask/transaction-controller";
+import type { TransactionMeta } from "@metamask/transaction-controller";
+import type { Hex } from "@metamask/utils";
+import type { TransactionPayControllerMessenger, TransactionPayQuote } from "../../types.mjs";
+import type { RelayQuote } from "./types.mjs";
+export declare function submitViaRelayExecute(quote: TransactionPayQuote<RelayQuote>, transaction: TransactionMeta, messenger: TransactionPayControllerMessenger, allParams: TransactionParams[]): Promise<Hex>;
+//# sourceMappingURL=relay-submit-execute.d.mts.map

package/dist/strategy/relay/relay-submit-execute.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-submit-execute.d.mts","sourceRoot":"","sources":["../../../src/strategy/relay/relay-submit-execute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,yCAAyC;AAC1E,OAAO,KAAK,EAEV,eAAe,EAChB,yCAAyC;AAC1C,OAAO,KAAK,EAAE,GAAG,EAAE,wBAAwB;AAK3C,OAAO,KAAK,EACV,iCAAiC,EACjC,mBAAmB,EACpB,wBAAoB;AAKrB,OAAO,KAAK,EAAuB,UAAU,EAAE,oBAAgB;AAK/D,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,mBAAmB,CAAC,UAAU,CAAC,EACtC,WAAW,EAAE,eAAe,EAC5B,SAAS,EAAE,iCAAiC,EAC5C,SAAS,EAAE,iBAAiB,EAAE,GAC7B,OAAO,CAAC,GAAG,CAAC,CA8Dd"}

package/dist/strategy/relay/relay-submit-execute.mjs

@@ -0,0 +1,113 @@
+import { createModuleLogger } from "@metamask/utils";
+import { BigNumber } from "bignumber.js";
+import { projectLogger } from "../../logger.mjs";
+import { prefixError } from "../../utils/error-prefix.mjs";
+import { getNetworkClientId } from "../../utils/provider.mjs";
+import { FALLBACK_HASH } from "./constants.mjs";
+import { submitRelayExecute } from "./relay-api.mjs";
+const log = createModuleLogger(projectLogger, 'relay-strategy');
+const RELAY_EXECUTE_ERROR_PREFIX = 'Execute: ';
+export async function submitViaRelayExecute(quote, transaction, messenger, allParams) {
+    const isSubsidized = isSubsidizedRelayQuote(quote.original);
+    const requestId = getRelayExecuteRequestId(quote.original);
+    const metamask = getRelayExecuteMetamask(quote.original, isSubsidized);
+    const { from, sourceChainId } = quote.request;
+    const networkClientId = getNetworkClientId(messenger, sourceChainId);
+    const executionTransaction = {
+        ...transaction,
+        chainId: sourceChainId,
+        networkClientId,
+        nestedTransactions: allParams.map((param) => ({
+            data: (param.data ?? '0x'),
+            to: param.to,
+            value: (param.value ?? '0x0'),
+        })),
+        txParams: {
+            ...transaction.txParams,
+            from,
+        },
+    };
+    const delegation = await messenger.call('TransactionPayController:getDelegationTransaction', { transaction: executionTransaction, isSubsidized });
+    log('Delegation result for execute', delegation);
+    const executeBody = {
+        executionKind: 'rawCalls',
+        data: {
+            chainId: Number(quote.request.sourceChainId),
+            to: delegation.to,
+            data: delegation.data,
+            value: new BigNumber(delegation.value).toFixed(),
+            ...mapAuthorizationList(delegation.authorizationList),
+        },
+        executionOptions: {
+            subsidizeFees: false,
+        },
+        requestId,
+        metamask,
+    };
+    log('Submitting to Relay execute', { executeBody, from: quote.request.from });
+    let result;
+    try {
+        result = await submitRelayExecute(messenger, executeBody);
+    }
+    catch (error) {
+        throw prefixError(error, RELAY_EXECUTE_ERROR_PREFIX);
+    }
+    log('Relay execute response', result);
+    // Server may return a different requestId (e.g. after JIT quote for subsidized).
+    // Replace the original quote requestId so waitForRelayCompletion polls the correct request.
+    replaceFirstStepRequestId(quote.original, result.requestId);
+    return FALLBACK_HASH;
+}
+function isSubsidizedRelayQuote(quote) {
+    return Number(quote.fees?.subsidized?.amountUsd ?? '0') > 0;
+}
+function stripRelayExecuteMarker(requestId) {
+    return requestId.includes('#mm')
+        ? requestId.slice(0, requestId.indexOf('#mm'))
+        : requestId;
+}
+function getRelayExecuteRequestId(quote) {
+    const requestId = quote.steps?.[0]?.requestId;
+    if (!requestId) {
+        throw new Error('Relay: Execute: Missing requestId in quote step');
+    }
+    return stripRelayExecuteMarker(requestId);
+}
+function getRelayExecuteMetamask(quote, isSubsidized) {
+    const signature = quote.metamask?.signature;
+    if (!signature) {
+        throw new Error('Relay: Execute: Missing metamask.signature — cannot submit to /relay/execute without the HMAC token');
+    }
+    return {
+        isSubsidized,
+        quoteRequest: quote.request,
+        signature,
+    };
+}
+function mapAuthorizationList(authorizationList) {
+    if (!authorizationList?.length) {
+        return {};
+    }
+    return {
+        authorizationList: authorizationList.map((auth) => ({
+            chainId: Number(auth.chainId),
+            address: auth.address,
+            nonce: Number(auth.nonce),
+            yParity: Number(auth.yParity),
+            r: auth.r,
+            s: auth.s,
+        })),
+    };
+}
+function replaceFirstStepRequestId(quote, requestId) {
+    /* istanbul ignore next: requestId is read from steps[0] earlier, so steps is non-empty here; defensive guard. */
+    const steps = quote.steps ?? [];
+    /* istanbul ignore if: requestId is read from steps[0] earlier, so steps is non-empty here; defensive guard. */
+    if (steps.length === 0) {
+        throw new Error('Relay: Execute: Cannot update requestId — quote has no steps');
+    }
+    const existingStep = steps[0];
+    const remainingSteps = steps.slice(1);
+    quote.steps = [{ ...existingStep, requestId }, ...remainingSteps];
+}
+//# sourceMappingURL=relay-submit-execute.mjs.map

package/dist/strategy/relay/relay-submit-execute.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-submit-execute.mjs","sourceRoot":"","sources":["../../../src/strategy/relay/relay-submit-execute.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TransactionParams } from '@metamask/transaction-controller';\nimport type {\n  AuthorizationList,\n  TransactionMeta,\n} 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  TransactionPayControllerMessenger,\n  TransactionPayQuote,\n} from '../../types';\nimport { prefixError } from '../../utils/error-prefix';\nimport { getNetworkClientId } from '../../utils/provider';\nimport { FALLBACK_HASH } from './constants';\nimport { submitRelayExecute } from './relay-api';\nimport type { RelayExecuteRequest, RelayQuote } from './types';\n\nconst log = createModuleLogger(projectLogger, 'relay-strategy');\nconst RELAY_EXECUTE_ERROR_PREFIX = 'Execute: ';\n\nexport async function submitViaRelayExecute(\n  quote: TransactionPayQuote<RelayQuote>,\n  transaction: TransactionMeta,\n  messenger: TransactionPayControllerMessenger,\n  allParams: TransactionParams[],\n): Promise<Hex> {\n  const isSubsidized = isSubsidizedRelayQuote(quote.original);\n  const requestId = getRelayExecuteRequestId(quote.original);\n  const metamask = getRelayExecuteMetamask(quote.original, isSubsidized);\n\n  const { from, sourceChainId } = quote.request;\n  const networkClientId = getNetworkClientId(messenger, sourceChainId);\n\n  const executionTransaction: TransactionMeta = {\n    ...transaction,\n    chainId: sourceChainId,\n    networkClientId,\n    nestedTransactions: allParams.map((param) => ({\n      data: (param.data ?? '0x') as Hex,\n      to: param.to as Hex,\n      value: (param.value ?? '0x0') as Hex,\n    })),\n    txParams: {\n      ...transaction.txParams,\n      from,\n    },\n  } as TransactionMeta;\n\n  const delegation = await messenger.call(\n    'TransactionPayController:getDelegationTransaction',\n    { transaction: executionTransaction, isSubsidized },\n  );\n\n  log('Delegation result for execute', delegation);\n\n  const executeBody: RelayExecuteRequest = {\n    executionKind: 'rawCalls',\n    data: {\n      chainId: Number(quote.request.sourceChainId),\n      to: delegation.to,\n      data: delegation.data,\n      value: new BigNumber(delegation.value).toFixed(),\n      ...mapAuthorizationList(delegation.authorizationList),\n    },\n    executionOptions: {\n      subsidizeFees: false,\n    },\n    requestId,\n    metamask,\n  };\n\n  log('Submitting to Relay execute', { executeBody, from: quote.request.from });\n\n  let result;\n  try {\n    result = await submitRelayExecute(messenger, executeBody);\n  } catch (error) {\n    throw prefixError(error, RELAY_EXECUTE_ERROR_PREFIX);\n  }\n\n  log('Relay execute response', result);\n\n  // Server may return a different requestId (e.g. after JIT quote for subsidized).\n  // Replace the original quote requestId so waitForRelayCompletion polls the correct request.\n  replaceFirstStepRequestId(quote.original, result.requestId);\n\n  return FALLBACK_HASH;\n}\n\nfunction isSubsidizedRelayQuote(quote: RelayQuote): boolean {\n  return Number(quote.fees?.subsidized?.amountUsd ?? '0') > 0;\n}\n\nfunction stripRelayExecuteMarker(requestId: string): string {\n  return requestId.includes('#mm')\n    ? requestId.slice(0, requestId.indexOf('#mm'))\n    : requestId;\n}\n\nfunction getRelayExecuteRequestId(quote: RelayQuote): string {\n  const requestId = quote.steps?.[0]?.requestId;\n  if (!requestId) {\n    throw new Error('Relay: Execute: Missing requestId in quote step');\n  }\n  return stripRelayExecuteMarker(requestId);\n}\n\nfunction getRelayExecuteMetamask(\n  quote: RelayQuote,\n  isSubsidized: boolean,\n): {\n  isSubsidized: boolean;\n  quoteRequest: RelayQuote['request'];\n  signature: string;\n} {\n  const signature = quote.metamask?.signature;\n  if (!signature) {\n    throw new Error(\n      'Relay: Execute: Missing metamask.signature — cannot submit to /relay/execute without the HMAC token',\n    );\n  }\n  return {\n    isSubsidized,\n    quoteRequest: quote.request,\n    signature,\n  };\n}\n\nfunction mapAuthorizationList(\n  authorizationList: AuthorizationList | undefined,\n): {\n  authorizationList?: {\n    chainId: number;\n    address: Hex;\n    nonce: number;\n    yParity: number;\n    r: Hex;\n    s: Hex;\n  }[];\n} {\n  if (!authorizationList?.length) {\n    return {};\n  }\n  return {\n    authorizationList: authorizationList.map((auth) => ({\n      chainId: Number(auth.chainId),\n      address: auth.address,\n      nonce: Number(auth.nonce),\n      yParity: Number(auth.yParity),\n      r: auth.r as Hex,\n      s: auth.s as Hex,\n    })),\n  };\n}\n\nfunction replaceFirstStepRequestId(quote: RelayQuote, requestId: string): void {\n  /* istanbul ignore next: requestId is read from steps[0] earlier, so steps is non-empty here; defensive guard. */\n  const steps = quote.steps ?? [];\n  /* istanbul ignore if: requestId is read from steps[0] earlier, so steps is non-empty here; defensive guard. */\n  if (steps.length === 0) {\n    throw new Error(\n      'Relay: Execute: Cannot update requestId — quote has no steps',\n    );\n  }\n\n  const existingStep = steps[0];\n  const remainingSteps = steps.slice(1);\n\n  quote.steps = [{ ...existingStep, requestId }, ...remainingSteps];\n}\n"]}

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

@@ -15,9 +15,9 @@ const constants_1 = require("./constants.cjs");
 const hyperliquid_withdraw_1 = require("./hyperliquid-withdraw.cjs");
 const withdraw_1 = require("./polymarket/withdraw.cjs");
 const relay_api_1 = require("./relay-api.cjs");
+const relay_submit_execute_1 = require("./relay-submit-execute.cjs");
 const log = (0, utils_1.createModuleLogger)(logger_1.projectLogger, 'relay-strategy');
 const RELAY_ERROR_PREFIX = 'Relay: ';
-const RELAY_EXECUTE_ERROR_PREFIX = 'Execute: ';
 /**
  * Submits Relay quotes.
  *
@@ -68,6 +68,8 @@ async function executeSingleQuote(quote, messenger, transaction) {
         tx.txParams.nonce = undefined;
     });
     let polymarketPreSubmitUsdceBalance = 0n;
+    // Shallow clone so the server-returned requestId can be written back (state is frozen by Immer).
+    const mutableOriginal = { ...quote.original };
     if (quote.request.isHyperliquidSource) {
         await (0, hyperliquid_withdraw_1.submitHyperliquidWithdraw)(quote, quote.request.from, messenger);
     }
@@ -77,9 +79,9 @@ async function executeSingleQuote(quote, messenger, transaction) {
         setRelaySourceHash(transaction, messenger, sourceHash);
     }
     else {
-        await submitTransactions(quote, transaction, messenger);
+        await submitTransactions({ ...quote, original: mutableOriginal }, transaction, messenger);
     }
-    const completion = await waitForRelayCompletion(quote.original, messenger, {
+    const completion = await waitForRelayCompletion(mutableOriginal, messenger, {
         onSourceHash: (hash) => {
             log('Source hash received', hash);
             setRelaySourceHash(transaction, messenger, hash);
@@ -186,8 +188,12 @@ function normalizeParams(params, messenger) {
         data: params.data,
         from: params.from,
         gas: (0, controller_utils_1.toHex)(params.gas ?? featureFlags.relayFallbackGas.max),
-        maxFeePerGas: (0, controller_utils_1.toHex)(params.maxFeePerGas),
-        maxPriorityFeePerGas: (0, controller_utils_1.toHex)(params.maxPriorityFeePerGas),
+        maxFeePerGas: params.maxFeePerGas === undefined
+            ? undefined
+            : (0, controller_utils_1.toHex)(params.maxFeePerGas),
+        maxPriorityFeePerGas: params.maxPriorityFeePerGas === undefined
+            ? undefined
+            : (0, controller_utils_1.toHex)(params.maxPriorityFeePerGas),
         to: params.to,
         value: (0, controller_utils_1.toHex)(params.value ?? '0'),
     };
@@ -297,7 +303,7 @@ async function submitTransactions(quote, transaction, messenger) {
         allParams = [prependedParams, ...normalizedParams];
     }
     if (quote.original.metamask.isExecute) {
-        return await submitViaRelayExecute(quote, transaction, messenger, allParams);
+        return await (0, relay_submit_execute_1.submitViaRelayExecute)(quote, transaction, messenger, allParams);
     }
     return await submitViaTransactionController(quote, transaction, messenger, normalizedParams, allParams);
 }
@@ -327,76 +333,6 @@ async function buildDelegatedOriginalParams(transaction, messenger, relayParams)
         value: delegation.value,
     };
 }
-/**
- * Submit source transactions via Relay's /execute endpoint.
- *
- * Combines all source calls (approve + deposit, and optionally the
- * original transaction for post-quote flows) into a single EIP-7702
- * delegation transaction using getDelegationTransaction, then submits
- * it to Relay's /execute endpoint for gasless execution.
- *
- * @param quote - Relay quote.
- * @param transaction - Original transaction meta.
- * @param messenger - Controller messenger.
- * @param allParams - All source transaction params to combine.
- * @returns Fallback hash (actual hash comes from relay status polling).
- */
-async function submitViaRelayExecute(quote, transaction, messenger, allParams) {
-    const { from, sourceChainId } = quote.request;
-    const { requestId } = quote.original.steps[0];
-    const networkClientId = (0, provider_1.getNetworkClientId)(messenger, sourceChainId);
-    const sourceCallTransaction = {
-        ...transaction,
-        chainId: sourceChainId,
-        networkClientId,
-        nestedTransactions: allParams.map((params) => ({
-            data: (params.data ?? '0x'),
-            to: params.to,
-            value: (params.value ?? '0x0'),
-        })),
-        txParams: {
-            ...transaction.txParams,
-            from,
-        },
-    };
-    const delegation = await messenger.call('TransactionPayController:getDelegationTransaction', { transaction: sourceCallTransaction });
-    log('Delegation result for source calls', delegation);
-    const executeBody = {
-        executionKind: 'rawCalls',
-        data: {
-            chainId: Number(sourceChainId),
-            to: delegation.to,
-            data: delegation.data,
-            value: new bignumber_js_1.BigNumber(delegation.value).toFixed(),
-            ...(delegation.authorizationList?.length
-                ? {
-                    authorizationList: delegation.authorizationList.map((auth) => ({
-                        chainId: Number(auth.chainId),
-                        address: auth.address,
-                        nonce: Number(auth.nonce),
-                        yParity: Number(auth.yParity),
-                        r: auth.r,
-                        s: auth.s,
-                    })),
-                }
-                : {}),
-        },
-        executionOptions: {
-            subsidizeFees: false,
-        },
-        requestId,
-    };
-    log('Submitting via Relay execute', { executeBody, from });
-    let result;
-    try {
-        result = await (0, relay_api_1.submitRelayExecute)(messenger, executeBody);
-    }
-    catch (error) {
-        throw (0, error_prefix_1.prefixError)(error, RELAY_EXECUTE_ERROR_PREFIX);
-    }
-    log('Relay execute response', result);
-    return constants_1.FALLBACK_HASH;
-}
 /**
  * Submit source transactions via the TransactionController.
  *