feat: introduce operator fee for OP stack networks

pedronfigueiredo · pedronfigueiredo · commit 7e4011513414 · 2025-10-28T13:25:36.000Z
diff --git a/packages/transaction-controller/CHANGELOG.md b/packages/transaction-controller/CHANGELOG.md
@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Calculate operator fee for OP stack networks and include it in `layer1GasFee` ([#6979](https://github.com/MetaMask/core/pull/6979))
+
 ### Changed
 
 - Identify OP stack chains using gas API ([#6899](https://github.com/MetaMask/core/pull/6899))
diff --git a/packages/transaction-controller/src/gas-flows/OracleLayer1GasFeeFlow.test.ts b/packages/transaction-controller/src/gas-flows/OracleLayer1GasFeeFlow.test.ts
@@ -1,14 +1,14 @@
 import type { TypedTransaction } from '@ethereumjs/tx';
 import { TransactionFactory } from '@ethereumjs/tx';
+import { BigNumber } from '@ethersproject/bignumber';
 import { Contract } from '@ethersproject/contracts';
 import type { Provider } from '@metamask/network-controller';
 import type { Hex } from '@metamask/utils';
-
-import { OracleLayer1GasFeeFlow } from './OracleLayer1GasFeeFlow';
 import { CHAIN_IDS } from '../constants';
 import type { TransactionControllerMessenger } from '../TransactionController';
 import type { Layer1GasFeeFlowRequest, TransactionMeta } from '../types';
 import { TransactionStatus } from '../types';
+import { OracleLayer1GasFeeFlow } from './OracleLayer1GasFeeFlow';
 
 jest.mock('@ethersproject/contracts', () => ({
   Contract: jest.fn(),
@@ -36,7 +36,8 @@ const TRANSACTION_META_MOCK: TransactionMeta = {
 
 const SERIALIZED_TRANSACTION_MOCK = '0x1234';
 const ORACLE_ADDRESS_MOCK = '0x5678' as Hex;
-const LAYER_1_FEE_MOCK = '0x9ABCD';
+const LAYER_1_FEE_MOCK = '0x09abcd';
+const OPERATOR_FEE_MOCK = '0x5';
 const DEFAULT_GAS_PRICE_ORACLE_ADDRESS =
   '0x420000000000000000000000000000000000000F';
 
@@ -98,9 +99,10 @@ class DefaultOracleLayer1GasFeeFlow extends OracleLayer1GasFeeFlow {
 
 describe('OracleLayer1GasFeeFlow', () => {
   const contractMock = jest.mocked(Contract);
-  const contractGetL1FeeMock: jest.MockedFn<
-    () => Promise<{ toHexString: () => string }>
-  > = jest.fn();
+  const contractGetL1FeeMock: jest.MockedFn<() => Promise<BigNumber>> =
+    jest.fn();
+  const contractGetOperatorFeeMock: jest.MockedFn<() => Promise<BigNumber>> =
+    jest.fn();
 
   let request: Layer1GasFeeFlowRequest;
 
@@ -112,13 +114,14 @@ describe('OracleLayer1GasFeeFlow', () => {
 
     contractMock.mockClear();
     contractGetL1FeeMock.mockClear();
+    contractGetOperatorFeeMock.mockClear();
 
-    contractGetL1FeeMock.mockResolvedValue({
-      toHexString: () => LAYER_1_FEE_MOCK,
-    });
+    contractGetL1FeeMock.mockResolvedValue(BigNumber.from(LAYER_1_FEE_MOCK));
+    contractGetOperatorFeeMock.mockResolvedValue(BigNumber.from(0));
 
     contractMock.mockReturnValue({
       getL1Fee: contractGetL1FeeMock,
+      getOperatorFee: contractGetOperatorFeeMock,
     } as unknown as Contract);
   });
 
@@ -156,6 +159,7 @@ describe('OracleLayer1GasFeeFlow', () => {
       expect(contractGetL1FeeMock).toHaveBeenCalledWith(
         serializedTransactionMock,
       );
+      expect(contractGetOperatorFeeMock).not.toHaveBeenCalled();
     });
 
     it('signs transaction with dummy key if supported by flow', async () => {
@@ -180,6 +184,7 @@ describe('OracleLayer1GasFeeFlow', () => {
       });
 
       expect(typedTransactionMock.sign).toHaveBeenCalledTimes(1);
+      expect(contractGetOperatorFeeMock).not.toHaveBeenCalled();
     });
 
     describe('throws', () => {
@@ -228,5 +233,75 @@ describe('OracleLayer1GasFeeFlow', () => {
       expect(oracleAddress).toBe(DEFAULT_GAS_PRICE_ORACLE_ADDRESS);
       expect(typedTransactionMock.sign).not.toHaveBeenCalled();
     });
+
+    it('adds operator fee when gas used is available', async () => {
+      const gasUsed = '0x5208';
+      request = {
+        ...request,
+        transactionMeta: {
+          ...request.transactionMeta,
+          gasUsed,
+        },
+      };
+
+      contractGetOperatorFeeMock.mockResolvedValueOnce(
+        BigNumber.from(OPERATOR_FEE_MOCK),
+      );
+
+      const flow = new MockOracleLayer1GasFeeFlow(false);
+      const response = await flow.getLayer1Fee(request);
+
+      expect(contractGetOperatorFeeMock).toHaveBeenCalledTimes(1);
+      expect(contractGetOperatorFeeMock).toHaveBeenCalledWith(gasUsed);
+      expect(response).toStrictEqual({
+        layer1Fee: BigNumber.from(LAYER_1_FEE_MOCK)
+          .add(BigNumber.from(OPERATOR_FEE_MOCK))
+          .toHexString(),
+      });
+    });
+
+    it('defaults operator fee to zero when call fails', async () => {
+      const gasUsed = '0x1';
+      request = {
+        ...request,
+        transactionMeta: {
+          ...request.transactionMeta,
+          gasUsed,
+        },
+      };
+
+      contractGetOperatorFeeMock.mockRejectedValueOnce(new Error('revert'));
+
+      const flow = new MockOracleLayer1GasFeeFlow(false);
+      const response = await flow.getLayer1Fee(request);
+
+      expect(contractGetOperatorFeeMock).toHaveBeenCalledTimes(1);
+      expect(response).toStrictEqual({
+        layer1Fee: LAYER_1_FEE_MOCK,
+      });
+    });
+
+    it('defaults operator fee to zero when call returns undefined', async () => {
+      const gasUsed = '0x2';
+      request = {
+        ...request,
+        transactionMeta: {
+          ...request.transactionMeta,
+          gasUsed,
+        },
+      };
+
+      contractGetOperatorFeeMock.mockResolvedValueOnce(
+        undefined as unknown as BigNumber,
+      );
+
+      const flow = new MockOracleLayer1GasFeeFlow(false);
+      const response = await flow.getLayer1Fee(request);
+
+      expect(contractGetOperatorFeeMock).toHaveBeenCalledTimes(1);
+      expect(response).toStrictEqual({
+        layer1Fee: LAYER_1_FEE_MOCK,
+      });
+    });
   });
 });
diff --git a/packages/transaction-controller/src/gas-flows/OracleLayer1GasFeeFlow.ts b/packages/transaction-controller/src/gas-flows/OracleLayer1GasFeeFlow.ts
@@ -1,3 +1,4 @@
+import { BigNumber } from '@ethersproject/bignumber';
 import { Contract } from '@ethersproject/contracts';
 import { Web3Provider, type ExternalProvider } from '@ethersproject/providers';
 import type { Hex } from '@metamask/utils';
@@ -15,14 +16,48 @@ import { prepareTransaction } from '../utils/prepare';
 
 const log = createModuleLogger(projectLogger, 'oracle-layer1-gas-fee-flow');
 
+const ZERO = BigNumber.from(0);
+
 const DUMMY_KEY =
   'abcdef0123456789abcdef0123456789abcdef0123456789abcdef0123456789';
 
 const GAS_PRICE_ORACLE_ABI = [
   {
-    inputs: [{ internalType: 'bytes', name: '_data', type: 'bytes' }],
+    inputs: [
+      {
+        internalType: 'bytes',
+        name: '_data',
+        type: 'bytes',
+      },
+    ],
     name: 'getL1Fee',
-    outputs: [{ internalType: 'uint256', name: '', type: 'uint256' }],
+    outputs: [
+      {
+        internalType: 'uint256',
+        name: '',
+        type: 'uint256',
+      },
+    ],
+    stateMutability: 'view',
+    type: 'function',
+  },
+  // only available post Isthmus
+  {
+    inputs: [
+      {
+        internalType: 'uint256',
+        name: '_gasUsed',
+        type: 'uint256',
+      },
+    ],
+    name: 'getOperatorFee',
+    outputs: [
+      {
+        internalType: 'uint256',
+        name: '',
+        type: 'uint256',
+      },
+    ],
     stateMutability: 'view',
     type: 'function',
   },
@@ -73,25 +108,35 @@ export abstract class OracleLayer1GasFeeFlow implements Layer1GasFeeFlow {
     request: Layer1GasFeeFlowRequest,
   ): Promise<Layer1GasFeeFlowResponse> {
     try {
-      return await this.#getOracleLayer1GasFee(request);
+      const { provider, transactionMeta } = request;
+
+      const contract = this.#getGasPriceOracleContract(
+        provider,
+        transactionMeta.chainId,
+      );
+
+      const oracleFee = await this.#getOracleLayer1GasFee(
+        contract,
+        transactionMeta,
+      );
+      const operatorFee = await this.#getOperatorLayer1GasFee(
+        contract,
+        transactionMeta,
+      );
+
+      return {
+        layer1Fee: oracleFee.add(operatorFee).toHexString(),
+      };
     } catch (error) {
       log('Failed to get oracle layer 1 gas fee', error);
       throw new Error(`Failed to get oracle layer 1 gas fee`);
     }
   }
 
   async #getOracleLayer1GasFee(
-    request: Layer1GasFeeFlowRequest,
-  ): Promise<Layer1GasFeeFlowResponse> {
-    const { provider, transactionMeta } = request;
-
-    const contract = new Contract(
-      this.getOracleAddressForChain(transactionMeta.chainId),
-      GAS_PRICE_ORACLE_ABI,
-      // Network controller provider type is incompatible with ethers provider
-      new Web3Provider(provider as unknown as ExternalProvider),
-    );
-
+    contract: Contract,
+    transactionMeta: TransactionMeta,
+  ): Promise<BigNumber> {
     const serializedTransaction = this.#buildUnserializedTransaction(
       transactionMeta,
       this.shouldSignTransaction(),
@@ -103,9 +148,31 @@ export abstract class OracleLayer1GasFeeFlow implements Layer1GasFeeFlow {
       throw new Error('No value returned from oracle contract');
     }
 
-    return {
-      layer1Fee: result.toHexString(),
-    };
+    return BigNumber.from(result);
+  }
+
+  async #getOperatorLayer1GasFee(
+    contract: Contract,
+    transactionMeta: TransactionMeta,
+  ): Promise<BigNumber> {
+    const { gasUsed } = transactionMeta;
+
+    if (!gasUsed) {
+      return ZERO;
+    }
+
+    try {
+      const result = await contract.getOperatorFee(gasUsed);
+
+      if (result === undefined) {
+        return ZERO;
+      }
+
+      return BigNumber.from(result);
+    } catch (error) {
+      log('Failed to get operator layer 1 gas fee', error);
+      return ZERO;
+    }
   }
 
   #buildUnserializedTransaction(
@@ -134,4 +201,16 @@ export abstract class OracleLayer1GasFeeFlow implements Layer1GasFeeFlow {
       gasLimit: transactionMeta.txParams.gas,
     };
   }
+
+  #getGasPriceOracleContract(
+    provider: Layer1GasFeeFlowRequest['provider'],
+    chainId: Hex,
+  ) {
+    return new Contract(
+      this.getOracleAddressForChain(chainId),
+      GAS_PRICE_ORACLE_ABI,
+      // Network controller provider type is incompatible with ethers provider
+      new Web3Provider(provider as unknown as ExternalProvider),
+    );
+  }
 }
