feat: relay transactions (#7122)

## Explanation

Support transactions in Relay quotes via delegation and EIP-7702.

## References

Related to
[#5945](MetaMask/MetaMask-planning#5945)

## Checklist

- [x] I've updated the test suite for new or updated code as appropriate
- [x] I've updated documentation (JSDoc, Markdown, etc.) for new or
updated code as appropriate
- [x] I've communicated my changes to consumers by [updating changelogs
for packages I've
changed](https://github.com/MetaMask/core/tree/main/docs/contributing.md#updating-changelogs),
highlighting breaking changes as necessary
- [x] I've prepared draft pull requests for clients and consumer
packages to resolve any breaking changes

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> Adds EIP-7702 delegation support to include target transactions in
Relay quotes and submission, requiring a new getDelegationTransaction
option, updating polling/fees, and normalizing Hyperliquid deposits.
> 
> - **Breaking**:
> - Require `getDelegationTransaction` in `TransactionPayController`
options; expose `TransactionPayController:getDelegationTransaction`
action and related types/exports.
> - **Relay strategy**:
> - Include transactions in Relay quote requests: add
`authorizationList`, set `tradeType` to `EXACT_OUTPUT`, and send `txs`
(token transfer + delegation).
> - Add `CHAIN_ID_HYPERCORE` and normalize Arbitrum USDC deposits to
direct Hyperliquid deposits; skip delegation when no tx params or
Hypercore.
> - Remove `skipTransaction` handling; always set target network fee to
`0` in quotes.
> - Submission: poll Relay status (configurable
`RELAY_POLLING_INTERVAL`); skip polling for same-chain; handle
`fallback` status; return target `transactionHash` (or `0x0` fallback);
clear original tx nonce and mark intent complete; track required tx IDs.
> - **Totals**:
> - Change token filtering to ignore `skipIfBalance` balance sufficiency
when summing amounts.
> - **Misc**:
>   - Update tests and changelog; minor constants/util refactors.
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
1d4c565. This will update automatically
on new commits. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

Author: matthewwalsh0

packages/transaction-pay-controller/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- **BREAKING:** Include transactions in Relay quotes via EIP-7702 and delegation ([#7122](https://github.com/MetaMask/core/pull/7122))
+  - Requires new `getDelegationTransaction` constructor option.
+
 ### Fixed
 
 - Read Relay provider fees directly from response ([#7098](https://github.com/MetaMask/core/pull/7098))

packages/transaction-pay-controller/src/TransactionPayController.test.ts

@@ -37,6 +37,7 @@ describe('TransactionPayController', () => {
    */
   function createController() {
     return new TransactionPayController({
+      getDelegationTransaction: jest.fn(),
       messenger,
     });
   }
@@ -85,6 +86,7 @@ describe('TransactionPayController', () => {
 
     it('returns callback value if provided', async () => {
       new TransactionPayController({
+        getDelegationTransaction: jest.fn(),
         getStrategy: async () => TransactionPayStrategy.Test,
         messenger,
       });

packages/transaction-pay-controller/src/TransactionPayController.ts

@@ -8,6 +8,7 @@ import { updatePaymentToken } from './actions/update-payment-token';
 import { CONTROLLER_NAME, TransactionPayStrategy } from './constants';
 import { QuoteRefresher } from './helpers/QuoteRefresher';
 import type {
+  GetDelegationTransactionCallback,
   TransactionData,
   TransactionPayControllerMessenger,
   TransactionPayControllerOptions,
@@ -36,11 +37,14 @@ export class TransactionPayController extends BaseController<
   TransactionPayControllerState,
   TransactionPayControllerMessenger
 > {
+  readonly #getDelegationTransaction: GetDelegationTransactionCallback;
+
   readonly #getStrategy?: (
     transaction: TransactionMeta,
   ) => Promise<TransactionPayStrategy>;
 
   constructor({
+    getDelegationTransaction,
     getStrategy,
     messenger,
     state,
@@ -52,6 +56,7 @@ export class TransactionPayController extends BaseController<
       state: { ...getDefaultState(), ...state },
     });
 
+    this.#getDelegationTransaction = getDelegationTransaction;
     this.#getStrategy = getStrategy;
 
     this.#registerActionHandlers();
@@ -127,6 +132,11 @@ export class TransactionPayController extends BaseController<
   }
 
   #registerActionHandlers() {
+    this.messenger.registerActionHandler(
+      'TransactionPayController:getDelegationTransaction',
+      this.#getDelegationTransaction.bind(this),
+    );
+
     this.messenger.registerActionHandler(
       'TransactionPayController:getStrategy',
       this.#getStrategy ?? (async () => TransactionPayStrategy.Relay),

packages/transaction-pay-controller/src/index.ts

@@ -1,6 +1,7 @@
 export type {
   TransactionPayControllerActions,
   TransactionPayControllerEvents,
+  TransactionPayControllerGetDelegationTransactionAction,
   TransactionPayControllerGetStateAction,
   TransactionPayControllerGetStrategyAction,
   TransactionPayControllerMessenger,

packages/transaction-pay-controller/src/strategy/relay/constants.ts

@@ -2,6 +2,8 @@ export const ARBITRUM_USDC_ADDRESS =
   '0xaf88d065e77c8cC2239327C5EDb3A432268e5831';
 export const CHAIN_ID_ARBITRUM = '0xa4b1';
 export const CHAIN_ID_POLYGON = '0x89';
+export const CHAIN_ID_HYPERCORE = '0x539';
 export const RELAY_URL_BASE = 'https://api.relay.link';
 export const RELAY_URL_QUOTE = `${RELAY_URL_BASE}/quote`;
 export const RELAY_FALLBACK_GAS_LIMIT = 900000;
+export const RELAY_POLLING_INTERVAL = 1000; // 1 Second

packages/transaction-pay-controller/src/strategy/relay/relay-quotes.test.ts

@@ -1,5 +1,6 @@
 import { successfulFetch } from '@metamask/controller-utils';
 import type { TransactionMeta } from '@metamask/transaction-controller';
+import type { Hex } from '@metamask/utils';
 import { cloneDeep } from 'lodash';
 
 import {
@@ -12,7 +13,10 @@ import { getRelayQuotes } from './relay-quotes';
 import type { RelayQuote } from './types';
 import { NATIVE_TOKEN_ADDRESS } from '../../constants';
 import { getMessengerMock } from '../../tests/messenger-mock';
-import type { QuoteRequest } from '../../types';
+import type {
+  GetDelegationTransactionCallback,
+  QuoteRequest,
+} from '../../types';
 import { calculateGasCost, calculateTransactionGasCost } from '../../utils/gas';
 import { getNativeToken, getTokenFiatRate } from '../../utils/token';
 
@@ -25,14 +29,14 @@ jest.mock('@metamask/controller-utils', () => ({
 }));
 
 const QUOTE_REQUEST_MOCK: QuoteRequest = {
-  from: '0x123',
+  from: '0x1234567890123456789012345678901234567891',
   sourceBalanceRaw: '10000000000000000000',
   sourceChainId: '0x1',
   sourceTokenAddress: '0xabc',
   sourceTokenAmount: '1000000000000000000',
   targetAmountMinimum: '123',
   targetChainId: '0x2',
-  targetTokenAddress: '0xdef',
+  targetTokenAddress: '0x1234567890123456789012345678901234567890',
 };
 
 const QUOTE_MOCK = {
@@ -62,12 +66,12 @@ const QUOTE_MOCK = {
           },
           data: {
             chainId: 1,
-            data: '0x123',
-            from: '0x1',
+            data: '0x123' as Hex,
+            from: '0x1' as Hex,
             gas: '21000',
             maxFeePerGas: '1000000000',
             maxPriorityFeePerGas: '2000000000',
-            to: '0x2',
+            to: '0x2' as Hex,
             value: '300000',
           },
           status: 'complete',
@@ -78,7 +82,20 @@ const QUOTE_MOCK = {
   ],
 } as RelayQuote;
 
-const TRANSACTION_META_MOCK = {} as TransactionMeta;
+const TRANSACTION_META_MOCK = { txParams: {} } as TransactionMeta;
+
+const DELEGATION_RESULT_MOCK = {
+  authorizationList: [
+    {
+      chainId: '0x1' as Hex,
+      nonce: '0x2' as Hex,
+      yParity: '0x1' as Hex,
+    },
+  ],
+  data: '0x111' as Hex,
+  to: '0x222' as Hex,
+  value: '0x333' as Hex,
+} as Awaited<ReturnType<GetDelegationTransactionCallback>>;
 
 describe('Relay Quotes Utils', () => {
   const successfulFetchMock = jest.mocked(successfulFetch);
@@ -90,8 +107,11 @@ describe('Relay Quotes Utils', () => {
     calculateTransactionGasCost,
   );
 
-  const { messenger, getRemoteFeatureFlagControllerStateMock } =
-    getMessengerMock();
+  const {
+    messenger,
+    getDelegationTransactionMock,
+    getRemoteFeatureFlagControllerStateMock,
+  } = getMessengerMock();
 
   beforeEach(() => {
     jest.resetAllMocks();
@@ -115,6 +135,8 @@ describe('Relay Quotes Utils', () => {
       cacheTimestamp: 0,
       remoteFeatureFlags: {},
     });
+
+    getDelegationTransactionMock.mockResolvedValue(DELEGATION_RESULT_MOCK);
   });
 
   describe('getRelayQuotes', () => {
@@ -164,6 +186,52 @@ describe('Relay Quotes Utils', () => {
       );
     });
 
+    it('includes transactions in request', async () => {
+      successfulFetchMock.mockResolvedValue({
+        json: async () => QUOTE_MOCK,
+      } as never);
+
+      await getRelayQuotes({
+        messenger,
+        requests: [QUOTE_REQUEST_MOCK],
+        transaction: {
+          ...TRANSACTION_META_MOCK,
+          txParams: {
+            data: '0xabc' as Hex,
+          },
+        } as TransactionMeta,
+      });
+
+      const body = JSON.parse(
+        successfulFetchMock.mock.calls[0][1]?.body as string,
+      );
+
+      expect(body).toStrictEqual(
+        expect.objectContaining({
+          authorizationList: [
+            {
+              chainId: 1,
+              nonce: 2,
+              yParity: 1,
+            },
+          ],
+          tradeType: 'EXACT_OUTPUT',
+          txs: [
+            {
+              to: QUOTE_REQUEST_MOCK.targetTokenAddress,
+              data: '0xa9059cbb0000000000000000000000001234567890123456789012345678901234567891000000000000000000000000000000000000000000000000000000000000007b',
+              value: '0x0',
+            },
+            {
+              to: DELEGATION_RESULT_MOCK.to,
+              data: DELEGATION_RESULT_MOCK.data,
+              value: DELEGATION_RESULT_MOCK.value,
+            },
+          ],
+        }),
+      );
+    });
+
     it('sends request to url from feature flag', async () => {
       successfulFetchMock.mockResolvedValue({
         json: async () => QUOTE_MOCK,
@@ -325,8 +393,8 @@ describe('Relay Quotes Utils', () => {
       });
 
       expect(result[0].fees.targetNetwork).toStrictEqual({
-        usd: '1.23',
-        fiat: '2.34',
+        usd: '0',
+        fiat: '0',
       });
     });