@metamask-previews/network-controller 36.0.0-preview-abca9bcea → 37.0.0-preview-0a30e47

package/dist/rpc-service-analytics.d.cts

@@ -1,85 +0,0 @@
-import type { AnalyticsTrackingEvent } from "@metamask/analytics-controller";
-import type { NetworkControllerMessenger, NetworkControllerRpcEndpointDegradedEvent, NetworkControllerRpcEndpointUnavailableEvent } from "./NetworkController.cjs";
-type RpcEndpointUnavailablePayload = NetworkControllerRpcEndpointUnavailableEvent['payload'][0];
-type RpcEndpointDegradedPayload = NetworkControllerRpcEndpointDegradedEvent['payload'][0];
-/**
- * The names of the analytics events that {@link NetworkController} emits when an
- * RPC endpoint becomes unavailable or degraded.
- */
-export type RpcServiceEventName = 'RPC Service Unavailable' | 'RPC Service Degraded';
-/**
- * Configuration that enables {@link NetworkController} to emit analytics events
- * for unavailable or degraded RPC endpoints.
- *
- * The pieces here are client-specific and cannot be derived inside the
- * controller: deciding whether an endpoint URL is safe to report depends on the
- * client's lists of known networks, and the sample rate depends on the client's
- * build environment.
- */
-export type NetworkControllerAnalyticsOptions = {
-    /**
-     * Returns `true` if the given RPC endpoint URL is safe to report verbatim (a
-     * "public" endpoint), or `false` if it must be reported as the literal string
-     * `'custom'` to avoid leaking private servers. Defaults to `() => false`.
-     */
-    isRpcEndpointUrlPublic?: (endpointUrl: string) => boolean;
-    /**
-     * The proportion of events to emit, between 0 and 1. `1` emits every event,
-     * `0` emits none. Clients typically use a small value (e.g. `0.01`) in
-     * production to stay within their analytics quota, and `1` in development.
-     * Defaults to `0`.
-     */
-    rpcServiceEventsSampleRate?: number;
-};
-/**
- * {@link NetworkControllerAnalyticsOptions} with defaults applied, as used
- * internally once the controller has filled in any omitted properties.
- */
-export type ResolvedNetworkControllerAnalyticsOptions = Required<NetworkControllerAnalyticsOptions>;
-/**
- * Hides any API key contained in an RPC endpoint URL by reducing it to its
- * host, but only when the endpoint is considered public. Non-public endpoints
- * (and URLs that cannot be parsed) are reported as the literal string
- * `'custom'`.
- *
- * @param endpointUrl - The URL of the RPC endpoint.
- * @param isPublic - Whether the endpoint is safe to report verbatim.
- * @returns The sanitized value to report.
- */
-export declare function sanitizeRpcEndpointUrl(endpointUrl: string, isPublic: boolean): string;
-/**
- * Builds the "RPC Service Unavailable" analytics tracking event.
- *
- * @param payload - The `rpcEndpointUnavailable` event payload.
- * @param isRpcEndpointUrlPublic - Returns whether the endpoint URL is safe to
- * report verbatim.
- * @returns The analytics tracking event.
- */
-export declare function buildRpcServiceUnavailableAnalyticsTrackingEvent(payload: RpcEndpointUnavailablePayload, isRpcEndpointUrlPublic: (endpointUrl: string) => boolean): AnalyticsTrackingEvent;
-/**
- * Builds the "RPC Service Degraded" analytics tracking event.
- *
- * @param payload - The `rpcEndpointDegraded` event payload.
- * @param isRpcEndpointUrlPublic - Returns whether the endpoint URL is safe to
- * report verbatim.
- * @returns The analytics tracking event.
- */
-export declare function buildRpcServiceDegradedAnalyticsTrackingEvent(payload: RpcEndpointDegradedPayload, isRpcEndpointUrlPublic: (endpointUrl: string) => boolean): AnalyticsTrackingEvent;
-/**
- * Emits an "RPC Service Unavailable" analytics event.
- *
- * @param messenger - The controller messenger.
- * @param analyticsOptions - The analytics configuration.
- * @param payload - The `rpcEndpointUnavailable` event payload.
- */
-export declare function trackRpcServiceUnavailable(messenger: NetworkControllerMessenger, analyticsOptions: ResolvedNetworkControllerAnalyticsOptions, payload: RpcEndpointUnavailablePayload): void;
-/**
- * Emits an "RPC Service Degraded" analytics event.
- *
- * @param messenger - The controller messenger.
- * @param analyticsOptions - The analytics configuration.
- * @param payload - The `rpcEndpointDegraded` event payload.
- */
-export declare function trackRpcServiceDegraded(messenger: NetworkControllerMessenger, analyticsOptions: ResolvedNetworkControllerAnalyticsOptions, payload: RpcEndpointDegradedPayload): void;
-export {};
-//# sourceMappingURL=rpc-service-analytics.d.cts.map

package/dist/rpc-service-analytics.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"rpc-service-analytics.d.cts","sourceRoot":"","sources":["../src/rpc-service-analytics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,uCAAuC;AAW7E,OAAO,KAAK,EACV,0BAA0B,EAC1B,yCAAyC,EACzC,4CAA4C,EAC7C,gCAA+B;AAGhC,KAAK,6BAA6B,GAChC,4CAA4C,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AAE7D,KAAK,0BAA0B,GAC7B,yCAAyC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AAE1D;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAC3B,yBAAyB,GACzB,sBAAsB,CAAC;AAE3B;;;;;;;;GAQG;AACH,MAAM,MAAM,iCAAiC,GAAG;IAC9C;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1D;;;;;OAKG;IACH,0BAA0B,CAAC,EAAE,MAAM,CAAC;CACrC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,yCAAyC,GACnD,QAAQ,CAAC,iCAAiC,CAAC,CAAC;AAE9C;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,OAAO,GAChB,MAAM,CAUR;AA+DD;;;;;;;GAOG;AACH,wBAAgB,gDAAgD,CAC9D,OAAO,EAAE,6BAA6B,EACtC,sBAAsB,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,GACvD,sBAAsB,CAUxB;AAED;;;;;;;GAOG;AACH,wBAAgB,6CAA6C,CAC3D,OAAO,EAAE,0BAA0B,EACnC,sBAAsB,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,GACvD,sBAAsB,CAiBxB;AAqDD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,0BAA0B,EACrC,gBAAgB,EAAE,yCAAyC,EAC3D,OAAO,EAAE,6BAA6B,GACrC,IAAI,CAWN;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,0BAA0B,EACrC,gBAAgB,EAAE,yCAAyC,EAC3D,OAAO,EAAE,0BAA0B,GAClC,IAAI,CAWN"}

package/dist/rpc-service-analytics.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"rpc-service-analytics.d.mts","sourceRoot":"","sources":["../src/rpc-service-analytics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,uCAAuC;AAW7E,OAAO,KAAK,EACV,0BAA0B,EAC1B,yCAAyC,EACzC,4CAA4C,EAC7C,gCAA+B;AAGhC,KAAK,6BAA6B,GAChC,4CAA4C,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AAE7D,KAAK,0BAA0B,GAC7B,yCAAyC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AAE1D;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAC3B,yBAAyB,GACzB,sBAAsB,CAAC;AAE3B;;;;;;;;GAQG;AACH,MAAM,MAAM,iCAAiC,GAAG;IAC9C;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1D;;;;;OAKG;IACH,0BAA0B,CAAC,EAAE,MAAM,CAAC;CACrC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,yCAAyC,GACnD,QAAQ,CAAC,iCAAiC,CAAC,CAAC;AAE9C;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,OAAO,GAChB,MAAM,CAUR;AA+DD;;;;;;;GAOG;AACH,wBAAgB,gDAAgD,CAC9D,OAAO,EAAE,6BAA6B,EACtC,sBAAsB,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,GACvD,sBAAsB,CAUxB;AAED;;;;;;;GAOG;AACH,wBAAgB,6CAA6C,CAC3D,OAAO,EAAE,0BAA0B,EACnC,sBAAsB,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,GACvD,sBAAsB,CAiBxB;AAqDD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,0BAA0B,EACrC,gBAAgB,EAAE,yCAAyC,EAC3D,OAAO,EAAE,6BAA6B,GACrC,IAAI,CAWN;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,0BAA0B,EACrC,gBAAgB,EAAE,yCAAyC,EAC3D,OAAO,EAAE,0BAA0B,GAClC,IAAI,CAWN"}

package/dist/rpc-service-analytics.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"rpc-service-analytics.mjs","sourceRoot":"","sources":["../src/rpc-service-analytics.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iCAAiC,EAAE,iDAAiD;AAE7F,OAAO,EACL,WAAW,EACX,WAAW,EACX,QAAQ,EACR,WAAW,EACX,SAAS,EACV,wBAAwB;AAOzB,OAAO,EAAE,iBAAiB,EAAE,sCAAqC;AAgDjE;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CACpC,WAAmB,EACnB,QAAiB;IAEjB,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,wBAAwB,CAC/B,IAAyB,EACzB,UAAgC;IAEhC,OAAO;QACL,IAAI;QACJ,UAAU;QACV,mBAAmB,EAAE,EAAE;QACvB,iBAAiB,EAAE,KAAK;QACxB,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC;KAClD,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,oCAAoC,CAAC,EAC5C,OAAO,EACP,WAAW,EACX,KAAK,EACL,sBAAsB,GAMvB;IACC,MAAM,YAAY,GAAG,sBAAsB,CACzC,WAAW,EACX,sBAAsB,CAAC,WAAW,CAAC,CACpC,CAAC;IAEF,4DAA4D;IAC5D,OAAO;QACL,aAAa,EAAE,UAAU,WAAW,CAAC,OAAO,CAAC,EAAE;QAC/C,UAAU,EAAE,YAAY;QACxB,gBAAgB,EAAE,YAAY,EAAE,qDAAqD;QACrF,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;YACnB,WAAW,CAAC,KAAK,EAAE,YAAY,CAAC;YAChC,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC;YAC3B,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,UAAU,EAAE;YACnC,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gDAAgD,CAC9D,OAAsC,EACtC,sBAAwD;IAExD,OAAO,wBAAwB,CAC7B,yBAAyB,EACzB,oCAAoC,CAAC;QACnC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,sBAAsB;KACvB,CAAC,CACH,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,6CAA6C,CAC3D,OAAmC,EACnC,sBAAwD;IAExD,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IAExE,4DAA4D;IAC5D,OAAO,wBAAwB,CAAC,sBAAsB,EAAE;QACtD,GAAG,oCAAoC,CAAC;YACtC,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,sBAAsB;SACvB,CAAC;QACF,eAAe,EAAE,aAAa;QAC9B,IAAI;QACJ,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;QAC5D,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;KACxD,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAS,oBAAoB,CAAC,EAC5B,SAAS,EACT,gBAAgB,EAChB,KAAK,EACL,kBAAkB,GAMnB;IACC,IAAI,CAAC;QACH,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO;QACT,CAAC;QAED,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QACvE,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QAED,IACE,iCAAiC,CAAC,WAAW,CAAC;YAC9C,gBAAgB,CAAC,0BAA0B,EAC3C,CAAC;YACD,OAAO;QACT,CAAC;QAED,SAAS,CAAC,IAAI,CAAC,gCAAgC,EAAE,kBAAkB,EAAE,CAAC,CAAC;IACzE,CAAC;IAAC,OAAO,WAAW,EAAE,CAAC;QACrB,SAAS,CAAC,gBAAgB,EAAE,CAC1B,SAAS,CAAC,WAAW,EAAE,kCAAkC,CAAC,CAC3D,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B,CACxC,SAAqC,EACrC,gBAA2D,EAC3D,OAAsC;IAEtC,oBAAoB,CAAC;QACnB,SAAS;QACT,gBAAgB;QAChB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,kBAAkB,EAAE,GAAG,EAAE,CACvB,gDAAgD,CAC9C,OAAO,EACP,gBAAgB,CAAC,sBAAsB,CACxC;KACJ,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACrC,SAAqC,EACrC,gBAA2D,EAC3D,OAAmC;IAEnC,oBAAoB,CAAC;QACnB,SAAS;QACT,gBAAgB;QAChB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,kBAAkB,EAAE,GAAG,EAAE,CACvB,6CAA6C,CAC3C,OAAO,EACP,gBAAgB,CAAC,sBAAsB,CACxC;KACJ,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { AnalyticsTrackingEvent } from '@metamask/analytics-controller';\nimport { generateDeterministicRandomNumber } from '@metamask/remote-feature-flag-controller';\nimport type { Hex, Json } from '@metamask/utils';\nimport {\n  hasProperty,\n  hexToNumber,\n  isObject,\n  isValidJson,\n  wrapError,\n} from '@metamask/utils';\n\nimport type {\n  NetworkControllerMessenger,\n  NetworkControllerRpcEndpointDegradedEvent,\n  NetworkControllerRpcEndpointUnavailableEvent,\n} from './NetworkController.js';\nimport { isConnectionError } from './rpc-service/rpc-service.js';\n\ntype RpcEndpointUnavailablePayload =\n  NetworkControllerRpcEndpointUnavailableEvent['payload'][0];\n\ntype RpcEndpointDegradedPayload =\n  NetworkControllerRpcEndpointDegradedEvent['payload'][0];\n\n/**\n * The names of the analytics events that {@link NetworkController} emits when an\n * RPC endpoint becomes unavailable or degraded.\n */\nexport type RpcServiceEventName =\n  | 'RPC Service Unavailable'\n  | 'RPC Service Degraded';\n\n/**\n * Configuration that enables {@link NetworkController} to emit analytics events\n * for unavailable or degraded RPC endpoints.\n *\n * The pieces here are client-specific and cannot be derived inside the\n * controller: deciding whether an endpoint URL is safe to report depends on the\n * client's lists of known networks, and the sample rate depends on the client's\n * build environment.\n */\nexport type NetworkControllerAnalyticsOptions = {\n  /**\n   * Returns `true` if the given RPC endpoint URL is safe to report verbatim (a\n   * \"public\" endpoint), or `false` if it must be reported as the literal string\n   * `'custom'` to avoid leaking private servers. Defaults to `() => false`.\n   */\n  isRpcEndpointUrlPublic?: (endpointUrl: string) => boolean;\n  /**\n   * The proportion of events to emit, between 0 and 1. `1` emits every event,\n   * `0` emits none. Clients typically use a small value (e.g. `0.01`) in\n   * production to stay within their analytics quota, and `1` in development.\n   * Defaults to `0`.\n   */\n  rpcServiceEventsSampleRate?: number;\n};\n\n/**\n * {@link NetworkControllerAnalyticsOptions} with defaults applied, as used\n * internally once the controller has filled in any omitted properties.\n */\nexport type ResolvedNetworkControllerAnalyticsOptions =\n  Required<NetworkControllerAnalyticsOptions>;\n\n/**\n * Hides any API key contained in an RPC endpoint URL by reducing it to its\n * host, but only when the endpoint is considered public. Non-public endpoints\n * (and URLs that cannot be parsed) are reported as the literal string\n * `'custom'`.\n *\n * @param endpointUrl - The URL of the RPC endpoint.\n * @param isPublic - Whether the endpoint is safe to report verbatim.\n * @returns The sanitized value to report.\n */\nexport function sanitizeRpcEndpointUrl(\n  endpointUrl: string,\n  isPublic: boolean,\n): string {\n  if (!isPublic) {\n    return 'custom';\n  }\n\n  try {\n    return new URL(endpointUrl).host;\n  } catch {\n    return 'custom';\n  }\n}\n\n/**\n * Wraps a name and properties into the shape expected by the\n * `AnalyticsController:trackEvent` action.\n *\n * @param name - The analytics event name.\n * @param properties - The analytics event properties.\n * @returns The analytics tracking event.\n */\nfunction toAnalyticsTrackingEvent(\n  name: RpcServiceEventName,\n  properties: Record<string, Json>,\n): AnalyticsTrackingEvent {\n  return {\n    name,\n    properties,\n    sensitiveProperties: {},\n    saveDataRecording: false,\n    hasProperties: Object.keys(properties).length > 0,\n  };\n}\n\n/**\n * Builds the properties common to both RPC service events.\n *\n * @param args - The arguments.\n * @param args.chainId - The chain ID that the endpoint represents.\n * @param args.endpointUrl - The URL of the endpoint.\n * @param args.error - The connection or response error encountered.\n * @param args.isRpcEndpointUrlPublic - Returns whether the endpoint URL is safe\n * to report verbatim.\n * @returns The common analytics event properties.\n */\nfunction buildCommonRpcServiceEventProperties({\n  chainId,\n  endpointUrl,\n  error,\n  isRpcEndpointUrlPublic,\n}: {\n  chainId: Hex;\n  endpointUrl: string;\n  error: unknown;\n  isRpcEndpointUrlPublic: (endpointUrl: string) => boolean;\n}): Record<string, Json> {\n  const sanitizedUrl = sanitizeRpcEndpointUrl(\n    endpointUrl,\n    isRpcEndpointUrlPublic(endpointUrl),\n  );\n\n  // The names of analytics properties have a particular case.\n  return {\n    chain_id_caip: `eip155:${hexToNumber(chainId)}`,\n    rpc_domain: sanitizedUrl,\n    rpc_endpoint_url: sanitizedUrl, // @deprecated - Will be removed in a future release.\n    ...(isObject(error) &&\n    hasProperty(error, 'httpStatus') &&\n    isValidJson(error.httpStatus)\n      ? { http_status: error.httpStatus }\n      : {}),\n  };\n}\n\n/**\n * Builds the \"RPC Service Unavailable\" analytics tracking event.\n *\n * @param payload - The `rpcEndpointUnavailable` event payload.\n * @param isRpcEndpointUrlPublic - Returns whether the endpoint URL is safe to\n * report verbatim.\n * @returns The analytics tracking event.\n */\nexport function buildRpcServiceUnavailableAnalyticsTrackingEvent(\n  payload: RpcEndpointUnavailablePayload,\n  isRpcEndpointUrlPublic: (endpointUrl: string) => boolean,\n): AnalyticsTrackingEvent {\n  return toAnalyticsTrackingEvent(\n    'RPC Service Unavailable',\n    buildCommonRpcServiceEventProperties({\n      chainId: payload.chainId,\n      endpointUrl: payload.endpointUrl,\n      error: payload.error,\n      isRpcEndpointUrlPublic,\n    }),\n  );\n}\n\n/**\n * Builds the \"RPC Service Degraded\" analytics tracking event.\n *\n * @param payload - The `rpcEndpointDegraded` event payload.\n * @param isRpcEndpointUrlPublic - Returns whether the endpoint URL is safe to\n * report verbatim.\n * @returns The analytics tracking event.\n */\nexport function buildRpcServiceDegradedAnalyticsTrackingEvent(\n  payload: RpcEndpointDegradedPayload,\n  isRpcEndpointUrlPublic: (endpointUrl: string) => boolean,\n): AnalyticsTrackingEvent {\n  const { duration, retryReason, rpcMethodName, traceId, type } = payload;\n\n  // The names of analytics properties have a particular case.\n  return toAnalyticsTrackingEvent('RPC Service Degraded', {\n    ...buildCommonRpcServiceEventProperties({\n      chainId: payload.chainId,\n      endpointUrl: payload.endpointUrl,\n      error: payload.error,\n      isRpcEndpointUrlPublic,\n    }),\n    rpc_method_name: rpcMethodName,\n    type,\n    ...(retryReason ? { retry_reason: retryReason } : {}),\n    ...(duration === undefined ? {} : { duration_ms: duration }),\n    ...(traceId === undefined ? {} : { trace_id: traceId }),\n  });\n}\n\n/**\n * Delivers an RPC service analytics event via the\n * `AnalyticsController:trackEvent` action, skipping local connection errors,\n * users without an analytics ID, and events that fall outside the configured\n * sample. Failures never propagate to the caller.\n *\n * @param args - The arguments.\n * @param args.messenger - The controller messenger.\n * @param args.analyticsOptions - The analytics configuration.\n * @param args.error - The error encountered, used to skip local connection errors.\n * @param args.buildTrackingEvent - Builds the event to deliver. Called lazily\n * inside the `try` so that a throw from the client's `isRpcEndpointUrlPublic` is\n * captured rather than propagated, and so the event is not built when it will\n * not be sent.\n */\nfunction trackRpcServiceEvent({\n  messenger,\n  analyticsOptions,\n  error,\n  buildTrackingEvent,\n}: {\n  messenger: NetworkControllerMessenger;\n  analyticsOptions: ResolvedNetworkControllerAnalyticsOptions;\n  error: unknown;\n  buildTrackingEvent: () => AnalyticsTrackingEvent;\n}): void {\n  try {\n    if (isConnectionError(error)) {\n      return;\n    }\n\n    const { analyticsId } = messenger.call('AnalyticsController:getState');\n    if (!analyticsId) {\n      return;\n    }\n\n    if (\n      generateDeterministicRandomNumber(analyticsId) >=\n      analyticsOptions.rpcServiceEventsSampleRate\n    ) {\n      return;\n    }\n\n    messenger.call('AnalyticsController:trackEvent', buildTrackingEvent());\n  } catch (caughtError) {\n    messenger.captureException?.(\n      wrapError(caughtError, 'Could not create analytics event'),\n    );\n  }\n}\n\n/**\n * Emits an \"RPC Service Unavailable\" analytics event.\n *\n * @param messenger - The controller messenger.\n * @param analyticsOptions - The analytics configuration.\n * @param payload - The `rpcEndpointUnavailable` event payload.\n */\nexport function trackRpcServiceUnavailable(\n  messenger: NetworkControllerMessenger,\n  analyticsOptions: ResolvedNetworkControllerAnalyticsOptions,\n  payload: RpcEndpointUnavailablePayload,\n): void {\n  trackRpcServiceEvent({\n    messenger,\n    analyticsOptions,\n    error: payload.error,\n    buildTrackingEvent: () =>\n      buildRpcServiceUnavailableAnalyticsTrackingEvent(\n        payload,\n        analyticsOptions.isRpcEndpointUrlPublic,\n      ),\n  });\n}\n\n/**\n * Emits an \"RPC Service Degraded\" analytics event.\n *\n * @param messenger - The controller messenger.\n * @param analyticsOptions - The analytics configuration.\n * @param payload - The `rpcEndpointDegraded` event payload.\n */\nexport function trackRpcServiceDegraded(\n  messenger: NetworkControllerMessenger,\n  analyticsOptions: ResolvedNetworkControllerAnalyticsOptions,\n  payload: RpcEndpointDegradedPayload,\n): void {\n  trackRpcServiceEvent({\n    messenger,\n    analyticsOptions,\n    error: payload.error,\n    buildTrackingEvent: () =>\n      buildRpcServiceDegradedAnalyticsTrackingEvent(\n        payload,\n        analyticsOptions.isRpcEndpointUrlPublic,\n      ),\n  });\n}\n"]}

package/dist/selectors.cjs

@@ -1,16 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getRpcFailoverMode = void 0;
-/**
- * Reads the RPC failover mode from the remote feature flags, defaulting to
- * `disabled` when the flag is absent or not a recognized value.
- *
- * @param state - The remote feature flag controller state.
- * @returns The RPC failover mode.
- */
-function getRpcFailoverMode(state) {
-    const mode = state.remoteFeatureFlags.corePlatformRpcFailoverMode;
-    return mode === 'enabled' || mode === 'forced' ? mode : 'disabled';
-}
-exports.getRpcFailoverMode = getRpcFailoverMode;
-//# sourceMappingURL=selectors.cjs.map

package/dist/selectors.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"selectors.cjs","sourceRoot":"","sources":["../src/selectors.ts"],"names":[],"mappings":";;;AAeA;;;;;;GAMG;AACH,SAAgB,kBAAkB,CAChC,KAAuC;IAEvC,MAAM,IAAI,GAAG,KAAK,CAAC,kBAAkB,CAAC,2BAA2B,CAAC;IAClE,OAAO,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC;AACrE,CAAC;AALD,gDAKC","sourcesContent":["import { RemoteFeatureFlagControllerState } from '@metamask/remote-feature-flag-controller';\n\n/**\n * The RPC failover behavior for Infura networks, controlled by the\n * `corePlatformRpcFailoverMode` remote feature flag.\n *\n * - `disabled`: failover URLs are ignored; traffic stays on the primary\n *   endpoint.\n * - `enabled`: traffic automatically diverts to failover URLs when the primary\n *   endpoint is unavailable.\n * - `forced`: Infura endpoints that have failover URLs route all traffic to\n *   those failover URLs, bypassing Infura entirely.\n */\nexport type RpcFailoverMode = 'disabled' | 'enabled' | 'forced';\n\n/**\n * Reads the RPC failover mode from the remote feature flags, defaulting to\n * `disabled` when the flag is absent or not a recognized value.\n *\n * @param state - The remote feature flag controller state.\n * @returns The RPC failover mode.\n */\nexport function getRpcFailoverMode(\n  state: RemoteFeatureFlagControllerState,\n): RpcFailoverMode {\n  const mode = state.remoteFeatureFlags.corePlatformRpcFailoverMode;\n  return mode === 'enabled' || mode === 'forced' ? mode : 'disabled';\n}\n"]}

package/dist/selectors.d.cts

@@ -1,22 +0,0 @@
-import { RemoteFeatureFlagControllerState } from "@metamask/remote-feature-flag-controller";
-/**
- * The RPC failover behavior for Infura networks, controlled by the
- * `corePlatformRpcFailoverMode` remote feature flag.
- *
- * - `disabled`: failover URLs are ignored; traffic stays on the primary
- *   endpoint.
- * - `enabled`: traffic automatically diverts to failover URLs when the primary
- *   endpoint is unavailable.
- * - `forced`: Infura endpoints that have failover URLs route all traffic to
- *   those failover URLs, bypassing Infura entirely.
- */
-export type RpcFailoverMode = 'disabled' | 'enabled' | 'forced';
-/**
- * Reads the RPC failover mode from the remote feature flags, defaulting to
- * `disabled` when the flag is absent or not a recognized value.
- *
- * @param state - The remote feature flag controller state.
- * @returns The RPC failover mode.
- */
-export declare function getRpcFailoverMode(state: RemoteFeatureFlagControllerState): RpcFailoverMode;
-//# sourceMappingURL=selectors.d.cts.map

package/dist/selectors.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"selectors.d.cts","sourceRoot":"","sources":["../src/selectors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,iDAAiD;AAE5F;;;;;;;;;;GAUG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEhE;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,gCAAgC,GACtC,eAAe,CAGjB"}

package/dist/selectors.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"selectors.d.mts","sourceRoot":"","sources":["../src/selectors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,iDAAiD;AAE5F;;;;;;;;;;GAUG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEhE;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,gCAAgC,GACtC,eAAe,CAGjB"}

package/dist/selectors.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"selectors.mjs","sourceRoot":"","sources":["../src/selectors.ts"],"names":[],"mappings":"AAeA;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAuC;IAEvC,MAAM,IAAI,GAAG,KAAK,CAAC,kBAAkB,CAAC,2BAA2B,CAAC;IAClE,OAAO,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC;AACrE,CAAC","sourcesContent":["import { RemoteFeatureFlagControllerState } from '@metamask/remote-feature-flag-controller';\n\n/**\n * The RPC failover behavior for Infura networks, controlled by the\n * `corePlatformRpcFailoverMode` remote feature flag.\n *\n * - `disabled`: failover URLs are ignored; traffic stays on the primary\n *   endpoint.\n * - `enabled`: traffic automatically diverts to failover URLs when the primary\n *   endpoint is unavailable.\n * - `forced`: Infura endpoints that have failover URLs route all traffic to\n *   those failover URLs, bypassing Infura entirely.\n */\nexport type RpcFailoverMode = 'disabled' | 'enabled' | 'forced';\n\n/**\n * Reads the RPC failover mode from the remote feature flags, defaulting to\n * `disabled` when the flag is absent or not a recognized value.\n *\n * @param state - The remote feature flag controller state.\n * @returns The RPC failover mode.\n */\nexport function getRpcFailoverMode(\n  state: RemoteFeatureFlagControllerState,\n): RpcFailoverMode {\n  const mode = state.remoteFeatureFlags.corePlatformRpcFailoverMode;\n  return mode === 'enabled' || mode === 'forced' ? mode : 'disabled';\n}\n"]}

package/dist/types.cjs

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NetworkClientType = void 0;
-/**
- * The type of network client that can be created.
- */
-var NetworkClientType;
-(function (NetworkClientType) {
-    NetworkClientType["Custom"] = "custom";
-    NetworkClientType["Infura"] = "infura";
-})(NetworkClientType || (exports.NetworkClientType = NetworkClientType = {}));
-//# sourceMappingURL=types.cjs.map

package/dist/types.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.cjs","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAeA;;GAEG;AACH,IAAY,iBAGX;AAHD,WAAY,iBAAiB;IAC3B,sCAAiB,CAAA;IACjB,sCAAiB,CAAA;AACnB,CAAC,EAHW,iBAAiB,iCAAjB,iBAAiB,QAG5B","sourcesContent":["import type { BlockTracker as BaseBlockTracker } from '@metamask/eth-block-tracker';\nimport type { InternalProvider } from '@metamask/eth-json-rpc-provider';\nimport type { MiddlewareContext } from '@metamask/json-rpc-engine/v2';\nimport type { Hex } from '@metamask/utils';\n\nexport type Provider = InternalProvider<\n  MiddlewareContext<\n    { origin: string; skipCache: boolean } & Record<string, unknown>\n  >\n>;\n\nexport type BlockTracker = BaseBlockTracker & {\n  checkForLatestBlock(): Promise<string>;\n};\n\n/**\n * The type of network client that can be created.\n */\nexport enum NetworkClientType {\n  Custom = 'custom',\n  Infura = 'infura',\n}\n\n/**\n * A configuration object that can be used to create a client for a network.\n */\ntype CommonNetworkClientConfiguration = {\n  chainId: Hex;\n  failoverRpcUrls?: string[];\n  ticker: string;\n};\n\n/**\n * A configuration object that can be used to create a client for a custom\n * network.\n */\nexport type CustomNetworkClientConfiguration =\n  CommonNetworkClientConfiguration & {\n    rpcUrl: string;\n    type: NetworkClientType.Custom;\n  };\n\n/**\n * A configuration object that can be used to create a client for an Infura\n * network.\n */\nexport type InfuraNetworkClientConfiguration =\n  CommonNetworkClientConfiguration & {\n    network: string;\n    infuraProjectId: string;\n    type: NetworkClientType.Infura;\n  };\n\n/**\n * A configuration object that can be used to create a client for a network.\n */\nexport type NetworkClientConfiguration =\n  | CustomNetworkClientConfiguration\n  | InfuraNetworkClientConfiguration;\n"]}

package/dist/types.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.cts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,IAAI,gBAAgB,EAAE,oCAAoC;AACpF,OAAO,KAAK,EAAE,gBAAgB,EAAE,wCAAwC;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,qCAAqC;AACtE,OAAO,KAAK,EAAE,GAAG,EAAE,wBAAwB;AAE3C,MAAM,MAAM,QAAQ,GAAG,gBAAgB,CACrC,iBAAiB,CACf;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CACjE,CACF,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,gBAAgB,GAAG;IAC5C,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACxC,CAAC;AAEF;;GAEG;AACH,oBAAY,iBAAiB;IAC3B,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB;AAED;;GAEG;AACH,KAAK,gCAAgC,GAAG;IACtC,OAAO,EAAE,GAAG,CAAC;IACb,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,gCAAgC,GAC1C,gCAAgC,GAAG;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC;CAChC,CAAC;AAEJ;;;GAGG;AACH,MAAM,MAAM,gCAAgC,GAC1C,gCAAgC,GAAG;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC;CAChC,CAAC;AAEJ;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAClC,gCAAgC,GAChC,gCAAgC,CAAC"}

package/dist/types.d.mts

@@ -1,49 +0,0 @@
-import type { BlockTracker as BaseBlockTracker } from "@metamask/eth-block-tracker";
-import type { InternalProvider } from "@metamask/eth-json-rpc-provider";
-import type { MiddlewareContext } from "@metamask/json-rpc-engine/v2";
-import type { Hex } from "@metamask/utils";
-export type Provider = InternalProvider<MiddlewareContext<{
-    origin: string;
-    skipCache: boolean;
-} & Record<string, unknown>>>;
-export type BlockTracker = BaseBlockTracker & {
-    checkForLatestBlock(): Promise<string>;
-};
-/**
- * The type of network client that can be created.
- */
-export declare enum NetworkClientType {
-    Custom = "custom",
-    Infura = "infura"
-}
-/**
- * A configuration object that can be used to create a client for a network.
- */
-type CommonNetworkClientConfiguration = {
-    chainId: Hex;
-    failoverRpcUrls?: string[];
-    ticker: string;
-};
-/**
- * A configuration object that can be used to create a client for a custom
- * network.
- */
-export type CustomNetworkClientConfiguration = CommonNetworkClientConfiguration & {
-    rpcUrl: string;
-    type: NetworkClientType.Custom;
-};
-/**
- * A configuration object that can be used to create a client for an Infura
- * network.
- */
-export type InfuraNetworkClientConfiguration = CommonNetworkClientConfiguration & {
-    network: string;
-    infuraProjectId: string;
-    type: NetworkClientType.Infura;
-};
-/**
- * A configuration object that can be used to create a client for a network.
- */
-export type NetworkClientConfiguration = CustomNetworkClientConfiguration | InfuraNetworkClientConfiguration;
-export {};
-//# sourceMappingURL=types.d.mts.map

package/dist/types.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.mts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,IAAI,gBAAgB,EAAE,oCAAoC;AACpF,OAAO,KAAK,EAAE,gBAAgB,EAAE,wCAAwC;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,qCAAqC;AACtE,OAAO,KAAK,EAAE,GAAG,EAAE,wBAAwB;AAE3C,MAAM,MAAM,QAAQ,GAAG,gBAAgB,CACrC,iBAAiB,CACf;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CACjE,CACF,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,gBAAgB,GAAG;IAC5C,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACxC,CAAC;AAEF;;GAEG;AACH,oBAAY,iBAAiB;IAC3B,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB;AAED;;GAEG;AACH,KAAK,gCAAgC,GAAG;IACtC,OAAO,EAAE,GAAG,CAAC;IACb,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,gCAAgC,GAC1C,gCAAgC,GAAG;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC;CAChC,CAAC;AAEJ;;;GAGG;AACH,MAAM,MAAM,gCAAgC,GAC1C,gCAAgC,GAAG;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC;CAChC,CAAC;AAEJ;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAClC,gCAAgC,GAChC,gCAAgC,CAAC"}

package/dist/types.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.mjs","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAeA;;GAEG;AACH,MAAM,CAAN,IAAY,iBAGX;AAHD,WAAY,iBAAiB;IAC3B,sCAAiB,CAAA;IACjB,sCAAiB,CAAA;AACnB,CAAC,EAHW,iBAAiB,KAAjB,iBAAiB,QAG5B","sourcesContent":["import type { BlockTracker as BaseBlockTracker } from '@metamask/eth-block-tracker';\nimport type { InternalProvider } from '@metamask/eth-json-rpc-provider';\nimport type { MiddlewareContext } from '@metamask/json-rpc-engine/v2';\nimport type { Hex } from '@metamask/utils';\n\nexport type Provider = InternalProvider<\n  MiddlewareContext<\n    { origin: string; skipCache: boolean } & Record<string, unknown>\n  >\n>;\n\nexport type BlockTracker = BaseBlockTracker & {\n  checkForLatestBlock(): Promise<string>;\n};\n\n/**\n * The type of network client that can be created.\n */\nexport enum NetworkClientType {\n  Custom = 'custom',\n  Infura = 'infura',\n}\n\n/**\n * A configuration object that can be used to create a client for a network.\n */\ntype CommonNetworkClientConfiguration = {\n  chainId: Hex;\n  failoverRpcUrls?: string[];\n  ticker: string;\n};\n\n/**\n * A configuration object that can be used to create a client for a custom\n * network.\n */\nexport type CustomNetworkClientConfiguration =\n  CommonNetworkClientConfiguration & {\n    rpcUrl: string;\n    type: NetworkClientType.Custom;\n  };\n\n/**\n * A configuration object that can be used to create a client for an Infura\n * network.\n */\nexport type InfuraNetworkClientConfiguration =\n  CommonNetworkClientConfiguration & {\n    network: string;\n    infuraProjectId: string;\n    type: NetworkClientType.Infura;\n  };\n\n/**\n * A configuration object that can be used to create a client for a network.\n */\nexport type NetworkClientConfiguration =\n  | CustomNetworkClientConfiguration\n  | InfuraNetworkClientConfiguration;\n"]}