chore: add is gasFeeSponsored field in transaction batch params (#7064)

## Explanation

This PR introduces a new boolean flag, isGasFeeSponsored, across the
Transaction Controller and Bridge Status Controller to indicate when a
transaction’s gas fee is sponsored (i.e., paid by MetaMask or another
service provider).

This complements the existing isGasFeeIncluded flag, which tracks when
the gas cost is embedded within the transaction itself. Together, these
flags enable more accurate handling of different gas payment scenarios.

Especially needed for the fully sponsored scenario for SEI and MONAD
chain.


<!--
Thanks for your contribution! Take a moment to answer these questions so
that reviewers have the information they need to properly understand
your changes:

* What is the current state of things and why does it need to change?
* What is the solution your changes offer and how does it work?
* Are there any changes whose purpose might not obvious to those
unfamiliar with the domain?
* If your primary goal was to update one package but you found you had
to update another one along the way, why did you do so?
* If you had to upgrade a dependency, why did you do so?
-->

## References

<!--
Are there any issues that this pull request is tied to?
Are there other links that reviewers should consult to understand these
changes better?
Are there client or consumer pull requests to adopt any breaking
changes?

For example:

* Fixes #12345
* Related to #67890
-->

## Checklist

- [ ] I've updated the test suite for new or updated code as appropriate
- [ ] I've updated documentation (JSDoc, Markdown, etc.) for new or
updated code as appropriate
- [ ] 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
- [ ] I've prepared draft pull requests for clients and consumer
packages to resolve any breaking changes

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> Adds `isGasFeeSponsored` flag to transaction batches and
addTransaction, wiring it from BridgeStatusController quotes through to
TransactionController.
> 
> - **Transaction Controller**:
> - Add `isGasFeeSponsored` to `TransactionBatchRequest` and
`AddTransactionOptions` types; persist on transactions.
> - Pass `isGasFeeSponsored` through `addTransactionBatch` paths
(EIP-7702 and hook-based) by forwarding `userRequest.isGasFeeSponsored`
when calling `addTransaction`.
> - Update tests to include `isGasFeeSponsored` in expected metadata;
changelog updated.
> - **Bridge Status Controller**:
> - Read `gasSponsored` from quote and set `isGasFeeSponsored` on batch
params in `getAddTransactionBatchParams`.
> - Update snapshots to include `isGasFeeSponsored` in batch request
objects.
> - **Changelogs**: Document new `isGasFeeSponsored` support in both
packages.
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
0a5a3ad. This will update automatically
on new commits. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

Author: khanti42

packages/bridge-status-controller/CHANGELOG.md

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Add isGasFeeSponsored field in transaction batch params ([#7064](https://github.com/MetaMask/core/pull/7064))
+
 ## [59.0.0]
 
 ### Changed

packages/bridge-status-controller/src/__snapshots__/bridge-status-controller.test.ts.snap

@@ -1252,6 +1252,7 @@ Array [
       "disable7702": true,
       "from": "0xaccount1",
       "isGasFeeIncluded": false,
+      "isGasFeeSponsored": false,
       "networkClientId": "arbitrum",
       "origin": "metamask",
       "requireApproval": false,
@@ -2952,6 +2953,7 @@ Array [
       "disable7702": true,
       "from": "0xaccount1",
       "isGasFeeIncluded": false,
+      "isGasFeeSponsored": false,
       "networkClientId": "arbitrum",
       "origin": "metamask",
       "requireApproval": false,

packages/bridge-status-controller/src/utils/transaction.ts

@@ -300,6 +300,7 @@ export const getAddTransactionBatchParams = async ({
       feeData: { txFee },
       gasIncluded,
       gasIncluded7702,
+      gasSponsored,
     },
     sentAmount,
     toTokenAmount,
@@ -393,6 +394,7 @@ export const getAddTransactionBatchParams = async ({
   >[0] = {
     disable7702,
     isGasFeeIncluded: Boolean(gasIncluded7702),
+    isGasFeeSponsored: Boolean(gasSponsored),
     networkClientId,
     requireApproval,
     origin: 'metamask',

packages/transaction-controller/CHANGELOG.md

@@ -10,6 +10,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 
 - Calculate operator fee for OP stack networks and include it in `layer1GasFee` ([#6979](https://github.com/MetaMask/core/pull/6979))
+- Add support for `isGasFeeSponsored` field in transaction batch and add transaction options ([#7064](https://github.com/MetaMask/core/pull/7064))
 
 ## [61.1.0]
 

packages/transaction-controller/src/TransactionController.test.ts

@@ -1692,6 +1692,7 @@ describe('TransactionController', () => {
         id: expect.any(String),
         isFirstTimeInteraction: undefined,
         isGasFeeIncluded: undefined,
+        isGasFeeSponsored: undefined,
         nestedTransactions: undefined,
         networkClientId: NETWORK_CLIENT_ID_MOCK,
         origin: undefined,

packages/transaction-controller/src/TransactionController.ts

@@ -1216,6 +1216,7 @@ export class TransactionController extends BaseController<
       deviceConfirmedOn,
       disableGasBuffer,
       isGasFeeIncluded,
+      isGasFeeSponsored,
       method,
       nestedTransactions,
       networkClientId,
@@ -1315,6 +1316,7 @@ export class TransactionController extends BaseController<
           disableGasBuffer,
           id: random(),
           isGasFeeIncluded,
+          isGasFeeSponsored,
           isFirstTimeInteraction: undefined,
           nestedTransactions,
           networkClientId,

packages/transaction-controller/src/types.ts

@@ -1726,6 +1726,9 @@ export type TransactionBatchRequest = {
   /** Whether MetaMask will be compensated for the gas fee by the transaction. */
   isGasFeeIncluded?: boolean;
 
+  /** Whether MetaMask will sponsor the gas fee for the transaction. */
+  isGasFeeSponsored?: boolean;
+
   /** ID of the network client to submit the transaction. */
   networkClientId: NetworkClientId;
 
@@ -2061,6 +2064,9 @@ export type AddTransactionOptions = {
   /** Whether MetaMask will be compensated for the gas fee by the transaction. */
   isGasFeeIncluded?: boolean;
 
+  /** Whether MetaMask will sponsor the gas fee for the transaction. */
+  isGasFeeSponsored?: boolean;
+
   /** RPC method that requested the transaction. */
   method?: string;
 

packages/transaction-controller/src/utils/batch.test.ts

@@ -810,6 +810,33 @@ describe('Batch Utils', () => {
       },
     );
 
+    it.each([true, false])(
+      'passes isGasFeeSponsored flag (%s) through to addTransaction when provided (EIP-7702 path)',
+      async (isGasFeeSponsored) => {
+        isAccountUpgradedToEIP7702Mock.mockResolvedValueOnce({
+          delegationAddress: undefined,
+          isSupported: true,
+        });
+
+        addTransactionMock.mockResolvedValueOnce({
+          transactionMeta: TRANSACTION_META_MOCK,
+          result: Promise.resolve(''),
+        });
+
+        request.request.isGasFeeSponsored = isGasFeeSponsored;
+
+        await addTransactionBatch(request);
+
+        expect(addTransactionMock).toHaveBeenCalledTimes(1);
+        expect(addTransactionMock).toHaveBeenCalledWith(
+          expect.any(Object),
+          expect.objectContaining({
+            isGasFeeSponsored,
+          }),
+        );
+      },
+    );
+
     describe('validates security', () => {
       it('using transaction params', async () => {
         isAccountUpgradedToEIP7702Mock.mockResolvedValueOnce({

packages/transaction-controller/src/utils/batch.ts

@@ -401,6 +401,7 @@ async function addTransactionBatchWith7702(
   const { result } = await addTransaction(txParams, {
     batchId,
     isGasFeeIncluded: userRequest.isGasFeeIncluded,
+    isGasFeeSponsored: userRequest.isGasFeeSponsored,
     nestedTransactions,
     networkClientId,
     origin,