test: Create anvil manager class (#15046)

<!--
Please submit this PR as a draft initially.
Do not mark it as "Ready for review" until the template has been
completely filled out, and PR status checks have passed at least once.
-->

## **Description**

This is part 2/3 of Anvil Utils. The purpose of this PR is to add an
AnvilManager class, which is essentially a wrapper around @viem/anvil
that manages an anvil instance that will be used in our tests. It
includes:

-  Lifecycle methods (start, quit) for controlling the server
- A `getProvider()` method that returns wallet, public, and test clients
-  Utility methods like getAccounts and setAccountBalance


## **Related issues**

Fixes: https://consensyssoftware.atlassian.net/browse/MMQA-524

## **Manual testing steps**

1. Go to this page...
2.
3.

## **Screenshots/Recordings**

<!-- If applicable, add screenshots and/or recordings to visualize the
before and after of your change. -->

### **Before**

<!-- [screenshots/recordings] -->

### **After**

<!-- [screenshots/recordings] -->

## **Pre-merge author checklist**

- [ ] I’ve followed [MetaMask Contributor
Docs](https://github.com/MetaMask/contributor-docs) and [MetaMask Mobile
Coding
Standards](https://github.com/MetaMask/metamask-mobile/blob/main/.github/guidelines/CODING_GUIDELINES.md).
- [ ] I've completed the PR template to the best of my ability
- [ ] I’ve included tests if applicable
- [ ] I’ve documented my code using [JSDoc](https://jsdoc.app/) format
if applicable
- [ ] I’ve applied the right labels on the PR (see [labeling
guidelines](https://github.com/MetaMask/metamask-mobile/blob/main/.github/guidelines/LABELING_GUIDELINES.md)).
Not required for external contributors.

## **Pre-merge reviewer checklist**

- [ ] I've manually tested the PR (e.g. pull and build branch, run the
app, test code being changed).
- [ ] I confirm that this PR addresses all acceptance criteria described
in the ticket it closes and includes the necessary testing evidence such
as recordings and or screenshots.

Author: cortisiko

e2e/api-specs/run-api-spec-tests.js

@@ -1,3 +1,4 @@
 /* eslint-disable import/no-commonjs */
 require('@babel/register');
+require('ts-node/register');
 require('./json-rpc-coverage.js');

e2e/fixtures/fixture-helper.js

@@ -1,14 +1,20 @@
 /* eslint-disable no-console, import/no-nodejs-modules */
 import FixtureServer, { DEFAULT_FIXTURE_SERVER_PORT } from './fixture-server';
 import FixtureBuilder from './fixture-builder';
+import { AnvilManager, defaultOptions } from '../seeder/anvil-manager';
 import Ganache from '../../app/util/test/ganache';
+
 import GanacheSeeder from '../../app/util/test/ganache-seeder';
 import axios from 'axios';
 import path from 'path';
 import createStaticServer from '../create-static-server';
-import { DEFAULT_MOCKSERVER_PORT, getFixturesServerPort, getLocalTestDappPort, getMockServerPort } from './utils';
+import {
+  DEFAULT_MOCKSERVER_PORT,
+  getFixturesServerPort,
+  getLocalTestDappPort,
+  getMockServerPort,
+} from './utils';
 import Utilities from '../utils/Utilities';
-import { device } from 'detox';
 import TestHelpers from '../helpers';
 import { startMockServer, stopMockServer } from '../api-mocking/mock-server';
 
@@ -31,6 +37,84 @@ const isFixtureServerStarted = async () => {
   }
 };
 
+// SRP corresponding to the vault set in the default fixtures - it's an empty test account, not secret
+export const defaultGanacheOptions = {
+  hardfork: 'london',
+  mnemonic:
+    'drive manage close raven tape average sausage pledge riot furnace august tip',
+};
+
+/**
+ *
+ * Normalizes the localNodeOptions into a consistent format to handle different data structures.
+ * Case 1: A string: localNodeOptions = 'anvil'
+ * Case 2: Array of strings: localNodeOptions = ['anvil', 'bitcoin']
+ * Case 3: Array of objects: localNodeOptions =
+ * [
+ *  { type: 'anvil', options: {anvilOpts}},
+ *  { type: 'bitcoin',options: {bitcoinOpts}},
+ * ]
+ * Case 4: Options object without type: localNodeOptions = {options}
+ *
+ * @param {string | object | Array} localNodeOptions - The input local node options.
+ * @returns {Array} The normalized local node options.
+ */
+function normalizeLocalNodeOptions(localNodeOptions) {
+  if (typeof localNodeOptions === 'string') {
+    // Case 1: Passing a string
+    return [
+      {
+        type: localNodeOptions,
+        options:
+          localNodeOptions === 'ganache'
+            ? defaultGanacheOptions
+            : localNodeOptions === 'anvil'
+            ? defaultOptions
+            : {},
+      },
+    ];
+  } else if (Array.isArray(localNodeOptions)) {
+    return localNodeOptions.map((node) => {
+      if (typeof node === 'string') {
+        // Case 2: Array of strings
+        return {
+          type: node,
+          options:
+            node === 'ganache'
+              ? defaultGanacheOptions
+              : node === 'anvil'
+              ? defaultOptions
+              : {},
+        };
+      }
+      if (typeof node === 'object' && node !== null) {
+        // Case 3: Array of objects
+        const type = node.type || 'ganache';
+        return {
+          type,
+          options:
+            type === 'ganache'
+              ? { ...defaultGanacheOptions, ...(node.options || {}) }
+              : type === 'anvil'
+              ? { ...defaultOptions, ...(node.options || {}) }
+              : node.options || {},
+        };
+      }
+      throw new Error(`Invalid localNodeOptions entry: ${node}`);
+    });
+  }
+  if (typeof localNodeOptions === 'object' && localNodeOptions !== null) {
+    // Case 4: Passing an options object without type
+    return [
+      {
+        type: 'ganache',
+        options: { ...defaultGanacheOptions, ...localNodeOptions },
+      },
+    ];
+  }
+  throw new Error(`Invalid localNodeOptions type: ${typeof localNodeOptions}`);
+}
+
 /**
  * Loads a fixture into the fixture server.
  *
@@ -99,40 +183,74 @@ export async function withFixtures(options, testSuite) {
     smartContract,
     disableGanache,
     dapp,
+    localNodeOptions = 'ganache',
     dappOptions,
     dappPath = undefined,
     dappPaths,
     testSpecificMock,
-    launchArgs
+    launchArgs,
   } = options;
 
   const fixtureServer = new FixtureServer();
   let mockServer;
   let mockServerPort = DEFAULT_MOCKSERVER_PORT;
+  const localNodeOptsNormalized = normalizeLocalNodeOptions(localNodeOptions);
 
   if (testSpecificMock) {
     mockServerPort = getMockServerPort();
     mockServer = await startMockServer(testSpecificMock, mockServerPort);
   }
 
-  let ganacheServer;
-  if (!disableGanache) {
-    ganacheServer = new Ganache();
+  let localNode;
+  const localNodes = [];
+
+  try {
+    // Start servers based on the localNodes array
+    if (!disableGanache) {
+      for (let i = 0; i < localNodeOptsNormalized.length; i++) {
+        const nodeType = localNodeOptsNormalized[i].type;
+        const nodeOptions = localNodeOptsNormalized[i].options || {};
+
+        switch (nodeType) {
+          case 'anvil':
+            localNode = new AnvilManager();
+            await localNode.start(nodeOptions);
+            localNodes.push(localNode);
+            await localNode.setAccountBalance('1200');
+
+            break;
+
+          case 'ganache':
+            localNode = new Ganache();
+            await localNode.start(nodeOptions);
+            localNodes.push(localNode);
+            break;
+
+          case 'none':
+            break;
+
+          default:
+            throw new Error(
+              `Unsupported localNode: '${nodeType}'. Cannot start the server.`,
+            );
+        }
+      }
+    }
+  } catch (error) {
+    console.error(error);
+    throw error;
   }
+
   const dappBasePort = getLocalTestDappPort();
   let numberOfDapps = dapp ? 1 : 0;
   const dappServer = [];
 
   try {
     let contractRegistry;
-    if (ganacheOptions && !disableGanache) {
-      await ganacheServer.start(ganacheOptions);
-
-      if (smartContract) {
-        const ganacheSeeder = new GanacheSeeder(ganacheServer.getProvider());
-        await ganacheSeeder.deploySmartContract(smartContract);
-        contractRegistry = ganacheSeeder.getContractRegistry();
-      }
+    if (!disableGanache && smartContract) {
+      const ganacheSeeder = new GanacheSeeder(localNodes[0].getProvider());
+      await ganacheSeeder.deploySmartContract(smartContract);
+      contractRegistry = ganacheSeeder.getContractRegistry();
     }
 
     if (dapp) {
@@ -171,26 +289,30 @@ export async function withFixtures(options, testSuite) {
     );
     // Due to the fact that the app was already launched on `init.js`, it is necessary to
     // launch into a fresh installation of the app to apply the new fixture loaded perviously.
-      if (restartDevice) {
-        await TestHelpers.launchApp({
-          delete: true,
-          launchArgs: {
-            fixtureServerPort: `${getFixturesServerPort()}`,
-            detoxURLBlacklistRegex: Utilities.BlacklistURLs,
-            mockServerPort: `${mockServerPort}`,
-            ...(launchArgs || {}),
-          },
-        });
+    if (restartDevice) {
+      await TestHelpers.launchApp({
+        delete: true,
+        launchArgs: {
+          fixtureServerPort: `${getFixturesServerPort()}`,
+          detoxURLBlacklistRegex: Utilities.BlacklistURLs,
+          mockServerPort: `${mockServerPort}`,
+          ...(launchArgs || {}),
+        },
+      });
     }
 
-    await testSuite({ contractRegistry, mockServer });
+    await testSuite({ contractRegistry, mockServer, localNodes }); // Pass localNodes instead of anvilServer
   } catch (error) {
     console.error(error);
     throw error;
   } finally {
-    if (ganacheOptions && !disableGanache) {
-      await ganacheServer.quit();
+    // Clean up all local nodes
+    for (const server of localNodes) {
+      if (server) {
+        await server.quit();
+      }
     }
+
     if (dapp) {
       for (let i = 0; i < numberOfDapps; i++) {
         if (dappServer[i] && dappServer[i].listening) {
@@ -213,10 +335,3 @@ export async function withFixtures(options, testSuite) {
     await stopFixtureServer(fixtureServer);
   }
 }
-
-// SRP corresponding to the vault set in the default fixtures - it's an empty test account, not secret
-export const defaultGanacheOptions = {
-  hardfork: 'london',
-  mnemonic:
-    'drive manage close raven tape average sausage pledge riot furnace august tip',
-};

e2e/pages/Network/NetworkListModal.js

@@ -70,6 +70,7 @@ class NetworkListModal {
 
   async changeNetworkTo(networkName, custom) {
     const elem = this.getCustomNetwork(networkName, custom);
+    await TestHelpers.delay(3000);
     await Gestures.waitAndTap(elem);
     await TestHelpers.delay(3000);
   }
@@ -103,6 +104,7 @@ class NetworkListModal {
   }
 
   async tapAddNetworkButton() {
+    await TestHelpers.delay(3000);
     await Gestures.waitAndTap(this.addPopularNetworkButton);
   }
   async deleteNetwork() {

e2e/seeder/anvil-clients.ts

@@ -5,7 +5,6 @@ import {
   http,
 } from 'viem';
 import { anvil as baseAnvil } from 'viem/chains';
-
 /**
  * Creates a set of clients for interacting with an Anvil test node
  * @param {number} chainId - The chain ID for the network