feat: forward duration and traceId to RPC Service Degraded segment events (#29964)

## **Description**

Bumps `@metamask/network-controller` to `^31.0.0` and
`@metamask/controller-utils` to `^12.0.0`, which introduce two new
optional payload fields on `NetworkController:rpcEndpointDegraded` (and
`…ChainDegraded`):

- `duration` (`number | undefined`): the policy execution time in
milliseconds when the request succeeded but exceeded the degraded
threshold. `undefined` when retries were exhausted.
- `traceId` (`string | undefined`): the value of the `X-Trace-Id`
response header from the last request attempt. `undefined` when no
response was received or the header was absent.

This PR threads both fields through `onRpcEndpointDegraded` →
`trackRpcEndpointEvent` and emits them on the `RPC Service Degraded`
Segment event as `duration_ms` and `trace_id` (snake_case, to match
existing properties such as `rpc_method_name` and `retry_reason`). Both
keys are conditionally omitted from the event when the upstream value is
`undefined`, so we don't pollute Segment with empty values.

A `resolutions` entry pins `@metamask/network-controller` to `31.0.0`
repo-wide to dedupe the nested copy that
`@metamask/multichain-network-controller@^3.1.0` still pulls in at
`^30.1.0`. Without this dedupe, TypeScript reports nominal-type
mismatches across packages that consume `NetworkConfiguration` /
`NetworkState` (e.g. `transaction-controller-init.ts`,
`assets-list.ts`). The runtime change in 31.0.0 is additive only (two
optional payload fields), so forcing the multichain dep onto the newer
version is safe.

This enables correlating degraded RPC events with backend traces for
debugging RPC health, and surfaces the actual slow-success latency.

See core PR
[MetaMask/core#8455](MetaMask/core#8455) for the
upstream change.

## **Changelog**

CHANGELOG entry: null

## **Related issues**

Fixes: [WPC-963](https://consensyssoftware.atlassian.net/browse/WPC-963)

## **Manual testing steps**

\`\`\`gherkin
Feature: RPC degraded events carry duration and trace ID

Scenario: slow but successful RPC request emits duration_ms and trace_id
Given a network whose RPC endpoint responds slowly (>5s) and returns an
X-Trace-Id header
    And MetaMetrics is enabled
When the user performs an action that issues a JSON-RPC call (e.g.
switching chains, refreshing balances)
Then the outgoing "RPC Service Degraded" Segment event contains numeric
duration_ms
And the event contains trace_id equal to the response's X-Trace-Id
header

  Scenario: retries-exhausted RPC request omits duration_ms
Given a network whose RPC endpoint returns retriable errors (e.g. 503)
for every attempt
    And MetaMetrics is enabled
    When the user performs an action that issues a JSON-RPC call
Then the outgoing "RPC Service Degraded" Segment event omits the
duration_ms property
And the event includes trace_id only if a response with X-Trace-Id was
received before failing
\`\`\`

## **Screenshots/Recordings**

N/A — no UI change.

### **Before**

### **After**

## **Pre-merge author checklist**

- [x] 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).
- [x] I've completed the PR template to the best of my ability
- [x] I've included tests if applicable
- [x] 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.

#### Performance checks (if applicable)

- [ ] I've tested on Android
- [ ] I've tested with a power user scenario
- [ ] I've instrumented key operations with Sentry traces for production
performance metrics

## **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.

[WPC-963]:
https://consensyssoftware.atlassian.net/browse/WPC-963?atlOrigin=eyJpIjoiNWRkNTljNzYxNjVmNDY3MDlhMDU5Y2ZhYzA5YTRkZjUiLCJwIjoiZ2l0aHViLWNvbS1KU1cifQ

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> **Medium Risk**
> Touches network telemetry wiring and analytics event payloads; low
functional impact, but mistakes could break/alter Segment schema and
degrade monitoring quality.
> 
> **Overview**
> **RPC degraded telemetry now includes more context.** The
`NetworkController:rpcEndpointDegraded` subscription forwards optional
`duration` and `traceId` into
`onRpcEndpointDegraded`/`trackRpcEndpointEvent`, emitting them to
Segment as `duration_ms` and `trace_id` only when defined, with new unit
tests covering both presence and omission.
> 
> **Dependency + fixture updates.** Bumps/pins
`@metamask/network-controller` to `31.0.0` (plus `controller-utils` and
`remote-feature-flag-controller`), adds new default network entries
(Avalanche, Monad Mainnet, MegaETH Mainnet, ZKsync Era) to test
background state and updates Infura API mocks and AddressSelector
sorting expectations accordingly.
> 
> <sup>Reviewed by [Cursor Bugbot](https://cursor.com/bugbot) for commit
73534c4. Bugbot is set up for automated
code reviews on this repo. Configure
[here](https://www.cursor.com/dashboard/bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

Author: cryptodev-2s

app/components/Views/AddressSelector/AddressSelector.test.tsx

@@ -140,10 +140,14 @@ describe('AccountSelector', () => {
       MAINNET_DISPLAY_NAME,
       LINEA_MAINNET_DISPLAY_NAME,
       ARBITRUM_DISPLAY_NAME,
+      'Avalanche Mainnet',
       BASE_DISPLAY_NAME,
       BNB_DISPLAY_NAME,
+      'MegaETH Mainnet',
+      'Monad Mainnet',
       OPTIMISM_DISPLAY_NAME,
       POLYGON_DISPLAY_NAME,
+      'ZKsync Era',
     ]);
     expect(networkNames).not.toContain('Solana');
   });

app/core/Engine/controllers/network-controller-init.ts

@@ -219,19 +219,23 @@ export const networkControllerInit: MessengerClientInitFunction<
     'NetworkController:rpcEndpointDegraded',
     async ({
       chainId,
+      duration,
       endpointUrl,
       error,
       rpcMethodName,
+      traceId,
       type,
       retryReason,
     }) => {
       onRpcEndpointDegraded({
         chainId,
+        duration,
         endpointUrl,
         error,
         infuraProjectId,
         retryReason,
         rpcMethodName,
+        traceId,
         trackEvent: ({ event, properties }) => {
           buildAndTrackEvent(initMessenger, event, properties);
         },

app/core/Engine/controllers/network-controller/messenger-action-handlers.test.ts

@@ -322,6 +322,67 @@ describe('onRpcEndpointDegraded', () => {
       });
       /* eslint-enable @typescript-eslint/naming-convention */
     });
+
+    it('includes duration_ms and trace_id when present in the payload', () => {
+      shouldCreateRpcServiceEventsMock.mockReturnValue(true);
+      isPublicEndpointUrlMock.mockReturnValue(true);
+      const trackEvent = jest.fn();
+
+      onRpcEndpointDegraded({
+        chainId: '0xaa36a7',
+        duration: 5123,
+        endpointUrl: 'https://example.com',
+        error: undefined,
+        infuraProjectId: 'the-infura-project-id',
+        rpcMethodName: 'eth_blockNumber',
+        traceId: 'abc-123-trace',
+        trackEvent,
+        type: 'slow_success',
+        metaMetricsId:
+          '0x86bacb9b2bf9a7e8d2b147eadb95ac9aaa26842327cd24afc8bd4b3c1d136420',
+      });
+
+      // The names of Segment properties have a particular case.
+      /* eslint-disable @typescript-eslint/naming-convention */
+      expect(trackEvent).toHaveBeenCalledWith({
+        event: expect.objectContaining({
+          category: 'RPC Service Degraded',
+        }),
+        properties: {
+          chain_id_caip: 'eip155:11155111',
+          type: 'slow_success',
+          rpc_endpoint_url: 'example.com',
+          rpc_domain: 'example.com',
+          rpc_method_name: 'eth_blockNumber',
+          duration_ms: 5123,
+          trace_id: 'abc-123-trace',
+        },
+      });
+      /* eslint-enable @typescript-eslint/naming-convention */
+    });
+
+    it('omits duration_ms and trace_id when they are undefined in the payload', () => {
+      shouldCreateRpcServiceEventsMock.mockReturnValue(true);
+      isPublicEndpointUrlMock.mockReturnValue(true);
+      const trackEvent = jest.fn();
+
+      onRpcEndpointDegraded({
+        chainId: '0xaa36a7',
+        endpointUrl: 'https://example.com',
+        error: new HttpError(420),
+        infuraProjectId: 'the-infura-project-id',
+        rpcMethodName: 'eth_blockNumber',
+        trackEvent,
+        type: 'retries_exhausted',
+        retryReason: 'non_successful_http_status',
+        metaMetricsId:
+          '0x86bacb9b2bf9a7e8d2b147eadb95ac9aaa26842327cd24afc8bd4b3c1d136420',
+      });
+
+      const [[call]] = trackEvent.mock.calls;
+      expect(call.properties).not.toHaveProperty('duration_ms');
+      expect(call.properties).not.toHaveProperty('trace_id');
+    });
   });
 
   describe('if the Segment event should not be created', () => {

app/core/Engine/controllers/network-controller/messenger-action-handlers.ts

@@ -71,6 +71,8 @@ export function onRpcEndpointUnavailable({
  *
  * @param args - The arguments.
  * @param args.chainId - The chain ID that the endpoint represents.
+ * @param args.duration - The policy execution time in milliseconds when the
+ * request succeeded but was slow. `undefined` when retries were exhausted.
  * @param args.endpointUrl - The URL of the endpoint.
  * @param args.error - The connection or response error encountered after making
  * a request to the RPC endpoint.
@@ -79,28 +81,34 @@ export function onRpcEndpointUnavailable({
  * @param args.retryReason - The category of error that was retried (only
  * present when `type` is `'retries_exhausted'`).
  * @param args.rpcMethodName - The JSON-RPC method that was being executed.
+ * @param args.traceId - The value of the `X-Trace-Id` response header from the
+ * last request attempt, or `undefined` if the header was not present.
  * @param args.trackEvent - The function that will create the Segment event.
  * @param args.type - Why the endpoint became degraded (`'slow_success'` or
  * `'retries_exhausted'`).
  */
 export function onRpcEndpointDegraded({
   chainId,
+  duration,
   endpointUrl,
   error,
   infuraProjectId,
   metaMetricsId,
   retryReason,
   rpcMethodName,
+  traceId,
   trackEvent,
   type,
 }: {
   chainId: Hex;
+  duration?: number;
   endpointUrl: string;
   error: unknown;
   infuraProjectId: string;
   metaMetricsId: string | null | undefined;
   retryReason?: RetryReason;
   rpcMethodName: string;
+  traceId?: string;
   trackEvent: (options: {
     event: IMetaMetricsEvent | ITrackingEvent;
     properties: JsonMap;
@@ -109,12 +117,14 @@ export function onRpcEndpointDegraded({
 }): void {
   trackRpcEndpointEvent(MetaMetricsEvents.RPC_SERVICE_DEGRADED, {
     chainId,
+    duration,
     endpointUrl,
     error,
     infuraProjectId,
     metaMetricsId,
     retryReason,
     rpcMethodName,
+    traceId,
     trackEvent,
     type,
   });
@@ -127,6 +137,9 @@ export function onRpcEndpointDegraded({
  * @param event - The Segment event to create.
  * @param args - The remaining arguments.
  * @param args.chainId - The chain ID that the endpoint represents.
+ * @param args.duration - The policy execution time in milliseconds when the
+ * request succeeded but was slow (only present for degraded events from a
+ * slow success).
  * @param args.endpointUrl - The URL of the endpoint.
  * @param args.error - The connection or response error encountered after making
  * a request to the RPC endpoint.
@@ -136,6 +149,8 @@ export function onRpcEndpointDegraded({
  * present for degraded events when `type` is `'retries_exhausted'`).
  * @param args.rpcMethodName - The JSON-RPC method that was being executed
  * (only present for degraded events).
+ * @param args.traceId - The value of the `X-Trace-Id` response header from the
+ * last request attempt (only present for degraded events).
  * @param args.trackEvent - The function that will create the Segment event.
  * @param args.type - Why the endpoint became degraded (only present for
  * degraded events).
@@ -144,21 +159,25 @@ export function trackRpcEndpointEvent(
   event: (typeof MetaMetricsEvents)[keyof typeof MetaMetricsEvents],
   {
     chainId,
+    duration,
     endpointUrl,
     error,
     infuraProjectId,
     retryReason,
     rpcMethodName,
+    traceId,
     trackEvent,
     type,
     metaMetricsId,
   }: {
     chainId: Hex;
+    duration?: number;
     endpointUrl: string;
     error: unknown;
     infuraProjectId: string;
     retryReason?: RetryReason;
     rpcMethodName?: string;
+    traceId?: string;
     trackEvent: (options: {
       event: IMetaMetricsEvent | ITrackingEvent;
       properties: JsonMap;
@@ -188,6 +207,8 @@ export function trackRpcEndpointEvent(
     ...(rpcMethodName ? { rpc_method_name: rpcMethodName } : {}),
     ...(type ? { type } : {}),
     ...(retryReason ? { retry_reason: retryReason } : {}),
+    ...(duration === undefined ? {} : { duration_ms: duration }),
+    ...(traceId === undefined ? {} : { trace_id: traceId }),
     ...(isObject(error) &&
     'httpStatus' in error &&
     isValidJson(error.httpStatus)

app/util/test/initial-background-state.json

@@ -237,6 +237,66 @@
             "url": "https://base-mainnet.infura.io/v3/{infuraProjectId}"
           }
         ]
+      },
+      "0x8f": {
+        "blockExplorerUrls": [],
+        "chainId": "0x8f",
+        "defaultRpcEndpointIndex": 0,
+        "name": "Monad Mainnet",
+        "nativeCurrency": "MON",
+        "rpcEndpoints": [
+          {
+            "failoverUrls": [],
+            "networkClientId": "monad-mainnet",
+            "type": "infura",
+            "url": "https://monad-mainnet.infura.io/v3/{infuraProjectId}"
+          }
+        ]
+      },
+      "0x10e6": {
+        "blockExplorerUrls": [],
+        "chainId": "0x10e6",
+        "defaultRpcEndpointIndex": 0,
+        "name": "MegaETH Mainnet",
+        "nativeCurrency": "ETH",
+        "rpcEndpoints": [
+          {
+            "failoverUrls": [],
+            "networkClientId": "megaeth-mainnet",
+            "type": "infura",
+            "url": "https://megaeth-mainnet.infura.io/v3/{infuraProjectId}"
+          }
+        ]
+      },
+      "0x144": {
+        "blockExplorerUrls": [],
+        "chainId": "0x144",
+        "defaultRpcEndpointIndex": 0,
+        "name": "ZKsync Era",
+        "nativeCurrency": "ETH",
+        "rpcEndpoints": [
+          {
+            "failoverUrls": [],
+            "networkClientId": "zksync-mainnet",
+            "type": "infura",
+            "url": "https://zksync-mainnet.infura.io/v3/{infuraProjectId}"
+          }
+        ]
+      },
+      "0xa86a": {
+        "blockExplorerUrls": [],
+        "chainId": "0xa86a",
+        "defaultRpcEndpointIndex": 0,
+        "name": "Avalanche Mainnet",
+        "nativeCurrency": "AVAX",
+        "rpcEndpoints": [
+          {
+            "failoverUrls": [],
+            "networkClientId": "avalanche-mainnet",
+            "type": "infura",
+            "url": "https://avalanche-mainnet.infura.io/v3/{infuraProjectId}"
+          }
+        ]
       }
     }
   },

package.json

@@ -165,6 +165,7 @@
     ]
   },
   "resolutions": {
+    "@metamask/network-controller": "31.0.0",
     "@react-native-community/viewpager": "patch:@react-native-community/viewpager@npm%3A3.3.0#~/.yarn/patches/@react-native-community-viewpager-npm-3.3.0.patch",
     "@solana-mobile/mobile-wallet-adapter-protocol": "^2.2.5",
     "@appium/schema/json-schema": "^0.4.0",
@@ -247,7 +248,7 @@
     "@metamask/client-controller": "^1.0.1",
     "@metamask/compliance-controller": "2.0.0",
     "@metamask/connectivity-controller": "^0.1.0",
-    "@metamask/controller-utils": "^11.18.0",
+    "@metamask/controller-utils": "^12.0.0",
     "@metamask/core-backend": "^6.2.0",
     "@metamask/delegation-controller": "^2.0.2",
     "@metamask/delegation-deployments": "^1.0.0",
@@ -299,7 +300,7 @@
     "@metamask/multichain-network-controller": "^3.1.0",
     "@metamask/multichain-transactions-controller": "^7.1.0",
     "@metamask/native-utils": "^0.8.0",
-    "@metamask/network-controller": "^30.0.0",
+    "@metamask/network-controller": "^31.0.0",
     "@metamask/network-enablement-controller": "^5.1.0",
     "@metamask/notification-services-controller": "^23.1.0",
     "@metamask/permission-controller": "^13.1.1",
@@ -317,7 +318,7 @@
     "@metamask/react-native-payments": "patch:@metamask/react-native-payments@npm%3A2.0.2#~/.yarn/patches/@metamask-react-native-payments-npm-2.0.2-4ddc5f9862.patch",
     "@metamask/react-native-search-api": "1.0.1",
     "@metamask/react-native-webview": "patch:@metamask/react-native-webview@npm%3A14.6.0#~/.yarn/patches/@metamask-react-native-webview-npm-14.6.0-f12ccc06ff.patch",
-    "@metamask/remote-feature-flag-controller": "^4.1.0",
+    "@metamask/remote-feature-flag-controller": "^4.2.1",
     "@metamask/rpc-errors": "^7.0.2",
     "@metamask/sample-controllers": "^3.0.0",
     "@metamask/scure-bip39": "^2.1.0",

tests/api-mocking/mock-responses/infura-mocks.ts

@@ -66,6 +66,9 @@ const createInfuraMocks = () => {
     'starknet-sepolia.infura.io',
     'ipfs.infura.io',
     'sei-mainnet.infura.io',
+    'monad-mainnet.infura.io',
+    'megaeth-mainnet.infura.io',
+    'zksync-mainnet.infura.io',
   ];
 
   endpoints.forEach((endpoint) => {