feat: add monad failover rpc

.github/scripts/bundle.sh

@@ -33,6 +33,7 @@ export QUICKNODE_MAINNET_URL=""
 export QUICKNODE_OPTIMISM_URL=""
 export QUICKNODE_POLYGON_URL=""
 export QUICKNODE_SEI_URL=""
+export QUICKNODE_MONAD_URL=""
 export SEGMENT_BETA_WRITE_KEY=""
 export SEGMENT_EXPERIMENTAL_WRITE_KEY=""
 export SEGMENT_FLASK_WRITE_KEY=""

.github/workflows/publish-release.yml

@@ -50,6 +50,7 @@ jobs:
       QUICKNODE_OPTIMISM_URL: ${{ secrets.QUICKNODE_OPTIMISM_URL }}
       QUICKNODE_POLYGON_URL: ${{ secrets.QUICKNODE_POLYGON_URL }}
       QUICKNODE_SEI_URL: ${{ secrets.QUICKNODE_SEI_URL }}
+      QUICKNODE_MONAD_URL: ${{ secrets.QUICKNODE_MONAD_URL }}
       SEGMENT_BETA_WRITE_KEY: ${{ secrets.SEGMENT_BETA_WRITE_KEY }}
       SEGMENT_EXPERIMENTAL_WRITE_KEY: ${{ secrets.SEGMENT_EXPERIMENTAL_WRITE_KEY }}
       SEGMENT_FLASK_WRITE_KEY: ${{ secrets.SEGMENT_FLASK_WRITE_KEY }}

.github/workflows/run-build.yml

@@ -78,6 +78,7 @@ jobs:
       QUICKNODE_OPTIMISM_URL: ${{ secrets.QUICKNODE_OPTIMISM_URL }}
       QUICKNODE_POLYGON_URL: ${{ secrets.QUICKNODE_POLYGON_URL }}
       QUICKNODE_SEI_URL: ${{ secrets.QUICKNODE_SEI_URL }}
+      QUICKNODE_MONAD_URL: ${{ secrets.QUICKNODE_MONAD_URL }}
       SEGMENT_BETA_WRITE_KEY: ${{ secrets.SEGMENT_BETA_WRITE_KEY }}
       SEGMENT_EXPERIMENTAL_WRITE_KEY: ${{ secrets.SEGMENT_EXPERIMENTAL_WRITE_KEY }}
       SEGMENT_FLASK_WRITE_KEY: ${{ secrets.SEGMENT_FLASK_WRITE_KEY }}

app/scripts/migrations/186.test.ts

@@ -0,0 +1,201 @@
+import { RpcEndpointType } from '@metamask/network-controller';
+import { CHAIN_IDS } from '../../../shared/constants/network';
+import { migrate, version } from './185';
+
+const VERSION = version;
+const oldVersion = VERSION - 1;
+const QUICKNODE_MONAD_URL = 'https://example.quicknode.com/monad';
+const MONAD_CHAIN_ID = CHAIN_IDS.MONAD;
+
+describe(`migration #${VERSION}`, () => {
+  let originalEnv: NodeJS.ProcessEnv;
+
+  beforeEach(() => {
+    originalEnv = { ...process.env };
+    global.sentry = { captureException: jest.fn() };
+  });
+
+  afterEach(() => {
+    process.env = originalEnv;
+    global.sentry = undefined;
+  });
+
+  it('updates the version metadata', async () => {
+    const oldStorage = {
+      meta: { version: oldVersion },
+      data: {
+        NetworkController: {
+          networkConfigurationsByChainId: {},
+        },
+      },
+    };
+
+    const newStorage = await migrate(oldStorage);
+
+    expect(newStorage.meta).toStrictEqual({ version: VERSION });
+  });
+
+  it('logs a warning and returns the original state if NetworkController is missing', async () => {
+    const oldStorage = {
+      meta: { version: oldVersion },
+      data: {},
+    };
+
+    const mockWarn = jest.spyOn(console, 'warn').mockImplementation(jest.fn());
+
+    const newStorage = await migrate(oldStorage);
+
+    expect(mockWarn).toHaveBeenCalledWith(
+      `Migration ${VERSION}: NetworkController not found.`,
+    );
+    expect(newStorage.data).toStrictEqual(oldStorage.data);
+  });
+
+  it('does nothing if Monad network does not exist in the state', async () => {
+    const oldStorage = {
+      meta: { version: oldVersion },
+      data: {
+        NetworkController: {
+          networkConfigurationsByChainId: {
+            '0x1': {
+              rpcEndpoints: [
+                {
+                  type: RpcEndpointType.Infura,
+                  url: `https://mainnet.infura.io/v3/`,
+                },
+              ],
+            },
+          },
+        },
+      },
+    };
+
+    const newStorage = await migrate(oldStorage);
+
+    expect(newStorage.data).toStrictEqual(oldStorage.data);
+  });
+
+  it('does not add failover URL if QUICKNODE_MONAD_URL env variable is not set', async () => {
+    const oldStorage = {
+      meta: { version: oldVersion },
+      data: {
+        NetworkController: {
+          networkConfigurationsByChainId: {
+            [MONAD_CHAIN_ID]: {
+              rpcEndpoints: [
+                {
+                  type: RpcEndpointType.Custom,
+                  url: `https://monad-mainnet.infura.io/v3/`,
+                },
+              ],
+            },
+          },
+        },
+      },
+    };
+
+    const newStorage = await migrate(oldStorage);
+
+    // When QUICKNODE_MONAD_URL is not set, no failover URL should be added
+    expect(newStorage.data).toStrictEqual(oldStorage.data);
+  });
+
+  it('does not add failover URL if there is already a failover URL', async () => {
+    process.env.QUICKNODE_MONAD_URL = QUICKNODE_MONAD_URL;
+
+    const existingFailoverUrl = 'https://existing-failover.com';
+
+    const oldStorage = {
+      meta: { version: oldVersion },
+      data: {
+        NetworkController: {
+          networkConfigurationsByChainId: {
+            [MONAD_CHAIN_ID]: {
+              rpcEndpoints: [
+                {
+                  type: RpcEndpointType.Custom,
+                  url: `https://monad-mainnet.infura.io/v3/`,
+                  failoverUrls: [existingFailoverUrl],
+                },
+              ],
+            },
+          },
+        },
+      },
+    };
+
+    const newStorage = await migrate(oldStorage);
+
+    expect(newStorage.data).toStrictEqual(oldStorage.data);
+  });
+
+  it('adds QuickNode failover URL to all Monad RPC endpoints when no failover URLs exist', async () => {
+    process.env.QUICKNODE_MONAD_URL = QUICKNODE_MONAD_URL;
+
+    const oldStorage = {
+      meta: { version: oldVersion },
+      data: {
+        NetworkController: {
+          networkConfigurationsByChainId: {
+            [MONAD_CHAIN_ID]: {
+              rpcEndpoints: [
+                {
+                  type: RpcEndpointType.Infura,
+                  url: `https://monad-mainnet.infura.io/v3/`,
+                },
+                {
+                  type: RpcEndpointType.Custom,
+                  url: `https://some-monad-rpc.com`,
+                },
+              ],
+            },
+            '0x1': {
+              rpcEndpoints: [
+                {
+                  type: RpcEndpointType.Custom,
+                  url: `https://ethereum-mainnet.infura.io/v3/`,
+                },
+              ],
+            },
+          },
+        },
+      },
+    };
+
+    const expectedStorage = {
+      meta: { version: VERSION },
+      data: {
+        NetworkController: {
+          networkConfigurationsByChainId: {
+            [MONAD_CHAIN_ID]: {
+              rpcEndpoints: [
+                {
+                  type: RpcEndpointType.Infura,
+                  url: `https://monad-mainnet.infura.io/v3/`,
+                  failoverUrls: [QUICKNODE_MONAD_URL],
+                },
+                {
+                  type: RpcEndpointType.Custom,
+                  url: `https://some-monad-rpc.com`,
+                  failoverUrls: [QUICKNODE_MONAD_URL],
+                },
+              ],
+            },
+            '0x1': {
+              rpcEndpoints: [
+                {
+                  type: RpcEndpointType.Custom,
+                  url: `https://ethereum-mainnet.infura.io/v3/`,
+                },
+              ],
+            },
+          },
+        },
+      },
+    };
+
+    const newStorage = await migrate(oldStorage);
+
+    expect(newStorage).toStrictEqual(expectedStorage);
+  });
+});

app/scripts/migrations/186.ts

@@ -0,0 +1,136 @@
+import { getErrorMessage, hasProperty, Hex, isObject } from '@metamask/utils';
+import { cloneDeep } from 'lodash';
+import { captureException } from '../../../shared/lib/sentry';
+import { CHAIN_IDS } from '../../../shared/constants/network';
+
+type VersionedData = {
+  meta: { version: number };
+  data: Record<string, unknown>;
+};
+
+export const version = 185;
+
+const MONAD_CHAIN_ID: Hex = CHAIN_IDS.MONAD;
+
+/**
+ * This migration adds QuickNode failover URL to Monad network RPC endpoints
+ * that use Infura and don't already have a failover URL configured.
+ *
+ * @param originalVersionedData - The original MetaMask extension state.
+ * @returns Updated versioned MetaMask extension state.
+ */
+export async function migrate(
+  originalVersionedData: VersionedData,
+): Promise<VersionedData> {
+  const versionedData = cloneDeep(originalVersionedData);
+  versionedData.meta.version = version;
+
+  try {
+    transformState(versionedData.data);
+  } catch (error) {
+    console.error(error);
+    const newError = new Error(
+      `Migration #${version}: ${getErrorMessage(error)}`,
+    );
+    captureException(newError);
+    // Even though we encountered an error, we need the migration to pass for
+    // the migrator tests to work
+    versionedData.data = originalVersionedData.data;
+  }
+
+  return versionedData;
+}
+
+function transformState(state: Record<string, unknown>) {
+  if (!hasProperty(state, 'NetworkController')) {
+    console.warn(`Migration ${version}: NetworkController not found.`);
+    return state;
+  }
+
+  const networkState = state.NetworkController;
+  if (!isObject(networkState)) {
+    global.sentry?.captureException?.(
+      new Error(
+        `Migration ${version}: NetworkController is not an object: ${typeof networkState}`,
+      ),
+    );
+    return state;
+  }
+
+  if (!hasProperty(networkState, 'networkConfigurationsByChainId')) {
+    global.sentry?.captureException?.(
+      new Error(
+        `Migration ${version}: NetworkController missing property networkConfigurationsByChainId.`,
+      ),
+    );
+    return state;
+  }
+
+  if (!isObject(networkState.networkConfigurationsByChainId)) {
+    global.sentry?.captureException?.(
+      new Error(
+        `Migration ${version}: NetworkController.networkConfigurationsByChainId is not an object: ${typeof networkState.networkConfigurationsByChainId}.`,
+      ),
+    );
+    return state;
+  }
+
+  const { networkConfigurationsByChainId } = networkState;
+
+  // Get Monad network configuration
+  const monadNetworkConfiguration =
+    networkConfigurationsByChainId[MONAD_CHAIN_ID];
+
+  if (!monadNetworkConfiguration) {
+    // Monad network doesn't exist, nothing to migrate
+    return state;
+  }
+
+  if (
+    !isObject(monadNetworkConfiguration) ||
+    !hasProperty(monadNetworkConfiguration, 'rpcEndpoints') ||
+    !Array.isArray(monadNetworkConfiguration.rpcEndpoints)
+  ) {
+    global.sentry?.captureException?.(
+      new Error(
+        `Migration ${version}: Monad network configuration has invalid rpcEndpoints.`,
+      ),
+    );
+    return state;
+  }
+
+  // Update RPC endpoints to add failover URL if needed
+  monadNetworkConfiguration.rpcEndpoints =
+    monadNetworkConfiguration.rpcEndpoints.map((rpcEndpoint) => {
+      // Skip if endpoint is not an object or doesn't have a url property
+      if (
+        !isObject(rpcEndpoint) ||
+        !hasProperty(rpcEndpoint, 'url') ||
+        typeof rpcEndpoint.url !== 'string'
+      ) {
+        return rpcEndpoint;
+      }
+
+      // Skip if endpoint already has failover URLs
+      if (
+        hasProperty(rpcEndpoint, 'failoverUrls') &&
+        Array.isArray(rpcEndpoint.failoverUrls) &&
+        rpcEndpoint.failoverUrls.length > 0
+      ) {
+        return rpcEndpoint;
+      }
+
+      // Add QuickNode failover URL
+      const quickNodeUrl = process.env.QUICKNODE_MONAD_URL;
+      if (quickNodeUrl) {
+        return {
+          ...rpcEndpoint,
+          failoverUrls: [quickNodeUrl],
+        };
+      }
+
+      return rpcEndpoint;
+    });
+
+  return state;
+}

builds.yml

@@ -305,6 +305,7 @@ env:
   - QUICKNODE_BASE_URL: null
   - QUICKNODE_BSC_URL: null
   - QUICKNODE_SEI_URL: null
+  - QUICKNODE_MONAD_URL: null
 
   ###
   # API keys to 3rd party services

development/build/config.js

@@ -23,6 +23,7 @@ const VARIABLES_REQUIRED_IN_PRODUCTION = {
     'QUICKNODE_BASE_URL',
     'QUICKNODE_BSC_URL',
     'QUICKNODE_SEI_URL',
+    'QUICKNODE_MONAD_URL',
     'APPLE_PROD_CLIENT_ID',
     'GOOGLE_PROD_CLIENT_ID',
   ],

shared/constants/network.ts

@@ -1439,6 +1439,7 @@ export const QUICKNODE_ENDPOINT_URLS_BY_INFURA_NETWORK_NAME = {
   'base-mainnet': () => process.env.QUICKNODE_BASE_URL,
   'bsc-mainnet': () => process.env.QUICKNODE_BSC_URL,
   'sei-mainnet': () => process.env.QUICKNODE_SEI_URL,
+  'monad-mainnet': () => process.env.QUICKNODE_MONAD_URL,
 };
 
 export function getFailoverUrlsForInfuraNetwork(
@@ -1579,6 +1580,7 @@ export const FEATURED_RPCS: AddNetworkFields[] = [
     rpcEndpoints: [
       {
         url: `https://monad-mainnet.infura.io/v3/${infuraProjectId}`,
+        failoverUrls: getFailoverUrlsForInfuraNetwork('monad-mainnet'),
         type: RpcEndpointType.Custom,
       },
     ],