@metamask/network-controller 30.0.0 → 30.1.0

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AA6CA,6DAM6B;AAL3B,qIAAA,gCAAgC,OAAA;AAChC,oIAAA,+BAA+B,OAAA;AAC/B,gHAAA,WAAW,OAAA;AACX,sHAAA,iBAAiB,OAAA;AACjB,oHAAA,eAAe,OAAA;AAEjB,kDAA4B;AAO5B,qCAA4C;AAAnC,0GAAA,iBAAiB,OAAA;AAK1B,qEAA8D;AAArD,4HAAA,mBAAmB,OAAA;AAC5B,6DAA8D;AAArD,gHAAA,iBAAiB,OAAA","sourcesContent":["export type { AutoManagedNetworkClient } from './create-auto-managed-network-client';\nexport type {\n  Block,\n  NetworkMetadata,\n  NetworkConfiguration,\n  BuiltInNetworkClientId,\n  CustomNetworkClientId,\n  NetworkClientId,\n  NetworksMetadata,\n  NetworkState,\n  BlockTrackerProxy,\n  ProviderProxy,\n  AddNetworkFields,\n  UpdateNetworkFields,\n  NetworkControllerStateChangeEvent,\n  NetworkControllerNetworkWillChangeEvent,\n  NetworkControllerNetworkDidChangeEvent,\n  NetworkControllerInfuraIsBlockedEvent,\n  NetworkControllerInfuraIsUnblockedEvent,\n  NetworkControllerNetworkAddedEvent,\n  NetworkControllerNetworkRemovedEvent,\n  NetworkControllerEvents,\n  NetworkControllerGetStateAction,\n  NetworkControllerGetEthQueryAction,\n  NetworkControllerGetNetworkClientByIdAction,\n  NetworkControllerGetSelectedNetworkClientAction,\n  NetworkControllerGetSelectedChainIdAction,\n  NetworkControllerGetEIP1559CompatibilityAction,\n  NetworkControllerFindNetworkClientIdByChainIdAction,\n  NetworkControllerSetProviderTypeAction,\n  NetworkControllerSetActiveNetworkAction,\n  NetworkControllerAddNetworkAction,\n  NetworkControllerRemoveNetworkAction,\n  NetworkControllerUpdateNetworkAction,\n  NetworkControllerGetNetworkConfigurationByNetworkClientId,\n  NetworkControllerActions,\n  NetworkControllerMessenger,\n  NetworkControllerOptions,\n  NetworkControllerRpcEndpointChainUnavailableEvent,\n  NetworkControllerRpcEndpointUnavailableEvent,\n  NetworkControllerRpcEndpointChainDegradedEvent,\n  NetworkControllerRpcEndpointDegradedEvent,\n  NetworkControllerRpcEndpointChainAvailableEvent,\n  NetworkControllerRpcEndpointRetriedEvent,\n} from './NetworkController';\nexport {\n  getDefaultNetworkControllerState,\n  selectAvailableNetworkClientIds,\n  knownKeysOf,\n  NetworkController,\n  RpcEndpointType,\n} from './NetworkController';\nexport * from './constants';\nexport type { BlockTracker, Provider } from './types';\nexport type {\n  NetworkClientConfiguration,\n  InfuraNetworkClientConfiguration,\n  CustomNetworkClientConfiguration,\n} from './types';\nexport { NetworkClientType } from './types';\nexport type { NetworkClient } from './create-network-client';\nexport type { AbstractRpcService } from './rpc-service/abstract-rpc-service';\nexport type { RpcServiceRequestable } from './rpc-service/rpc-service-requestable';\nexport type { DegradedEventType, RetryReason } from './create-network-client';\nexport { classifyRetryReason } from './create-network-client';\nexport { isConnectionError } from './rpc-service/rpc-service';\n"]}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAkCA,6DAM6B;AAL3B,qIAAA,gCAAgC,OAAA;AAChC,oIAAA,+BAA+B,OAAA;AAC/B,gHAAA,WAAW,OAAA;AACX,sHAAA,iBAAiB,OAAA;AACjB,oHAAA,eAAe,OAAA;AAEjB,kDAA4B;AAO5B,qCAA4C;AAAnC,0GAAA,iBAAiB,OAAA;AAK1B,qEAA8D;AAArD,4HAAA,mBAAmB,OAAA;AAC5B,6DAA8D;AAArD,gHAAA,iBAAiB,OAAA","sourcesContent":["export type { AutoManagedNetworkClient } from './create-auto-managed-network-client';\nexport type {\n  Block,\n  NetworkMetadata,\n  NetworkConfiguration,\n  BuiltInNetworkClientId,\n  CustomNetworkClientId,\n  NetworkClientId,\n  NetworksMetadata,\n  NetworkState,\n  BlockTrackerProxy,\n  ProviderProxy,\n  AddNetworkFields,\n  UpdateNetworkFields,\n  NetworkControllerStateChangeEvent,\n  NetworkControllerNetworkWillChangeEvent,\n  NetworkControllerNetworkDidChangeEvent,\n  NetworkControllerInfuraIsBlockedEvent,\n  NetworkControllerInfuraIsUnblockedEvent,\n  NetworkControllerNetworkAddedEvent,\n  NetworkControllerNetworkRemovedEvent,\n  NetworkControllerEvents,\n  NetworkControllerGetStateAction,\n  NetworkControllerGetNetworkConfigurationByNetworkClientId,\n  NetworkControllerActions,\n  NetworkControllerMessenger,\n  NetworkControllerOptions,\n  NetworkControllerRpcEndpointChainUnavailableEvent,\n  NetworkControllerRpcEndpointUnavailableEvent,\n  NetworkControllerRpcEndpointChainDegradedEvent,\n  NetworkControllerRpcEndpointDegradedEvent,\n  NetworkControllerRpcEndpointChainAvailableEvent,\n  NetworkControllerRpcEndpointRetriedEvent,\n} from './NetworkController';\nexport {\n  getDefaultNetworkControllerState,\n  selectAvailableNetworkClientIds,\n  knownKeysOf,\n  NetworkController,\n  RpcEndpointType,\n} from './NetworkController';\nexport * from './constants';\nexport type { BlockTracker, Provider } from './types';\nexport type {\n  NetworkClientConfiguration,\n  InfuraNetworkClientConfiguration,\n  CustomNetworkClientConfiguration,\n} from './types';\nexport { NetworkClientType } from './types';\nexport type { NetworkClient } from './create-network-client';\nexport type { AbstractRpcService } from './rpc-service/abstract-rpc-service';\nexport type { RpcServiceRequestable } from './rpc-service/rpc-service-requestable';\nexport type { DegradedEventType, RetryReason } from './create-network-client';\nexport { classifyRetryReason } from './create-network-client';\nexport { isConnectionError } from './rpc-service/rpc-service';\nexport type {\n  NetworkControllerGetEthQueryAction,\n  NetworkControllerGetNetworkClientByIdAction,\n  NetworkControllerGetSelectedNetworkClientAction,\n  NetworkControllerGetSelectedChainIdAction,\n  NetworkControllerGetEIP1559CompatibilityAction,\n  NetworkControllerFindNetworkClientIdByChainIdAction,\n  NetworkControllerSetProviderTypeAction,\n  NetworkControllerSetActiveNetworkAction,\n  NetworkControllerGetNetworkConfigurationByChainIdAction,\n  NetworkControllerGetNetworkConfigurationByNetworkClientIdAction,\n  NetworkControllerAddNetworkAction,\n  NetworkControllerRemoveNetworkAction,\n  NetworkControllerUpdateNetworkAction,\n  NetworkControllerEnableRpcFailoverAction,\n  NetworkControllerDisableRpcFailoverAction,\n  NetworkControllerGetProviderAndBlockTrackerAction,\n  NetworkControllerGetNetworkClientRegistryAction,\n  NetworkControllerInitializeProviderAction,\n  NetworkControllerLookupNetworkAction,\n  NetworkControllerLookupNetworkByClientIdAction,\n  NetworkControllerGet1559CompatibilityWithNetworkClientIdAction,\n  NetworkControllerResetConnectionAction,\n  NetworkControllerRollbackToPreviousProviderAction,\n  NetworkControllerLoadBackupAction,\n} from './NetworkController-method-action-types';\n"]}

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 export type { AutoManagedNetworkClient } from "./create-auto-managed-network-client.cjs";
-export type { Block, NetworkMetadata, NetworkConfiguration, BuiltInNetworkClientId, CustomNetworkClientId, NetworkClientId, NetworksMetadata, NetworkState, BlockTrackerProxy, ProviderProxy, AddNetworkFields, UpdateNetworkFields, NetworkControllerStateChangeEvent, NetworkControllerNetworkWillChangeEvent, NetworkControllerNetworkDidChangeEvent, NetworkControllerInfuraIsBlockedEvent, NetworkControllerInfuraIsUnblockedEvent, NetworkControllerNetworkAddedEvent, NetworkControllerNetworkRemovedEvent, NetworkControllerEvents, NetworkControllerGetStateAction, NetworkControllerGetEthQueryAction, NetworkControllerGetNetworkClientByIdAction, NetworkControllerGetSelectedNetworkClientAction, NetworkControllerGetSelectedChainIdAction, NetworkControllerGetEIP1559CompatibilityAction, NetworkControllerFindNetworkClientIdByChainIdAction, NetworkControllerSetProviderTypeAction, NetworkControllerSetActiveNetworkAction, NetworkControllerAddNetworkAction, NetworkControllerRemoveNetworkAction, NetworkControllerUpdateNetworkAction, NetworkControllerGetNetworkConfigurationByNetworkClientId, NetworkControllerActions, NetworkControllerMessenger, NetworkControllerOptions, NetworkControllerRpcEndpointChainUnavailableEvent, NetworkControllerRpcEndpointUnavailableEvent, NetworkControllerRpcEndpointChainDegradedEvent, NetworkControllerRpcEndpointDegradedEvent, NetworkControllerRpcEndpointChainAvailableEvent, NetworkControllerRpcEndpointRetriedEvent, } from "./NetworkController.cjs";
+export type { Block, NetworkMetadata, NetworkConfiguration, BuiltInNetworkClientId, CustomNetworkClientId, NetworkClientId, NetworksMetadata, NetworkState, BlockTrackerProxy, ProviderProxy, AddNetworkFields, UpdateNetworkFields, NetworkControllerStateChangeEvent, NetworkControllerNetworkWillChangeEvent, NetworkControllerNetworkDidChangeEvent, NetworkControllerInfuraIsBlockedEvent, NetworkControllerInfuraIsUnblockedEvent, NetworkControllerNetworkAddedEvent, NetworkControllerNetworkRemovedEvent, NetworkControllerEvents, NetworkControllerGetStateAction, NetworkControllerGetNetworkConfigurationByNetworkClientId, NetworkControllerActions, NetworkControllerMessenger, NetworkControllerOptions, NetworkControllerRpcEndpointChainUnavailableEvent, NetworkControllerRpcEndpointUnavailableEvent, NetworkControllerRpcEndpointChainDegradedEvent, NetworkControllerRpcEndpointDegradedEvent, NetworkControllerRpcEndpointChainAvailableEvent, NetworkControllerRpcEndpointRetriedEvent, } from "./NetworkController.cjs";
 export { getDefaultNetworkControllerState, selectAvailableNetworkClientIds, knownKeysOf, NetworkController, RpcEndpointType, } from "./NetworkController.cjs";
 export * from "./constants.cjs";
 export type { BlockTracker, Provider } from "./types.cjs";
@@ -11,4 +11,5 @@ export type { RpcServiceRequestable } from "./rpc-service/rpc-service-requestabl
 export type { DegradedEventType, RetryReason } from "./create-network-client.cjs";
 export { classifyRetryReason } from "./create-network-client.cjs";
 export { isConnectionError } from "./rpc-service/rpc-service.cjs";
+export type { NetworkControllerGetEthQueryAction, NetworkControllerGetNetworkClientByIdAction, NetworkControllerGetSelectedNetworkClientAction, NetworkControllerGetSelectedChainIdAction, NetworkControllerGetEIP1559CompatibilityAction, NetworkControllerFindNetworkClientIdByChainIdAction, NetworkControllerSetProviderTypeAction, NetworkControllerSetActiveNetworkAction, NetworkControllerGetNetworkConfigurationByChainIdAction, NetworkControllerGetNetworkConfigurationByNetworkClientIdAction, NetworkControllerAddNetworkAction, NetworkControllerRemoveNetworkAction, NetworkControllerUpdateNetworkAction, NetworkControllerEnableRpcFailoverAction, NetworkControllerDisableRpcFailoverAction, NetworkControllerGetProviderAndBlockTrackerAction, NetworkControllerGetNetworkClientRegistryAction, NetworkControllerInitializeProviderAction, NetworkControllerLookupNetworkAction, NetworkControllerLookupNetworkByClientIdAction, NetworkControllerGet1559CompatibilityWithNetworkClientIdAction, NetworkControllerResetConnectionAction, NetworkControllerRollbackToPreviousProviderAction, NetworkControllerLoadBackupAction, } from "./NetworkController-method-action-types.cjs";
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,wBAAwB,EAAE,iDAA6C;AACrF,YAAY,EACV,KAAK,EACL,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,iCAAiC,EACjC,uCAAuC,EACvC,sCAAsC,EACtC,qCAAqC,EACrC,uCAAuC,EACvC,kCAAkC,EAClC,oCAAoC,EACpC,uBAAuB,EACvB,+BAA+B,EAC/B,kCAAkC,EAClC,2CAA2C,EAC3C,+CAA+C,EAC/C,yCAAyC,EACzC,8CAA8C,EAC9C,mDAAmD,EACnD,sCAAsC,EACtC,uCAAuC,EACvC,iCAAiC,EACjC,oCAAoC,EACpC,oCAAoC,EACpC,yDAAyD,EACzD,wBAAwB,EACxB,0BAA0B,EAC1B,wBAAwB,EACxB,iDAAiD,EACjD,4CAA4C,EAC5C,8CAA8C,EAC9C,yCAAyC,EACzC,+CAA+C,EAC/C,wCAAwC,GACzC,gCAA4B;AAC7B,OAAO,EACL,gCAAgC,EAChC,+BAA+B,EAC/B,WAAW,EACX,iBAAiB,EACjB,eAAe,GAChB,gCAA4B;AAC7B,gCAA4B;AAC5B,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,oBAAgB;AACtD,YAAY,EACV,0BAA0B,EAC1B,gCAAgC,EAChC,gCAAgC,GACjC,oBAAgB;AACjB,OAAO,EAAE,iBAAiB,EAAE,oBAAgB;AAC5C,YAAY,EAAE,aAAa,EAAE,oCAAgC;AAC7D,YAAY,EAAE,kBAAkB,EAAE,+CAA2C;AAC7E,YAAY,EAAE,qBAAqB,EAAE,kDAA8C;AACnF,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,oCAAgC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,oCAAgC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,sCAAkC"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,wBAAwB,EAAE,iDAA6C;AACrF,YAAY,EACV,KAAK,EACL,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,iCAAiC,EACjC,uCAAuC,EACvC,sCAAsC,EACtC,qCAAqC,EACrC,uCAAuC,EACvC,kCAAkC,EAClC,oCAAoC,EACpC,uBAAuB,EACvB,+BAA+B,EAC/B,yDAAyD,EACzD,wBAAwB,EACxB,0BAA0B,EAC1B,wBAAwB,EACxB,iDAAiD,EACjD,4CAA4C,EAC5C,8CAA8C,EAC9C,yCAAyC,EACzC,+CAA+C,EAC/C,wCAAwC,GACzC,gCAA4B;AAC7B,OAAO,EACL,gCAAgC,EAChC,+BAA+B,EAC/B,WAAW,EACX,iBAAiB,EACjB,eAAe,GAChB,gCAA4B;AAC7B,gCAA4B;AAC5B,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,oBAAgB;AACtD,YAAY,EACV,0BAA0B,EAC1B,gCAAgC,EAChC,gCAAgC,GACjC,oBAAgB;AACjB,OAAO,EAAE,iBAAiB,EAAE,oBAAgB;AAC5C,YAAY,EAAE,aAAa,EAAE,oCAAgC;AAC7D,YAAY,EAAE,kBAAkB,EAAE,+CAA2C;AAC7E,YAAY,EAAE,qBAAqB,EAAE,kDAA8C;AACnF,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,oCAAgC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,oCAAgC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,sCAAkC;AAC9D,YAAY,EACV,kCAAkC,EAClC,2CAA2C,EAC3C,+CAA+C,EAC/C,yCAAyC,EACzC,8CAA8C,EAC9C,mDAAmD,EACnD,sCAAsC,EACtC,uCAAuC,EACvC,uDAAuD,EACvD,+DAA+D,EAC/D,iCAAiC,EACjC,oCAAoC,EACpC,oCAAoC,EACpC,wCAAwC,EACxC,yCAAyC,EACzC,iDAAiD,EACjD,+CAA+C,EAC/C,yCAAyC,EACzC,oCAAoC,EACpC,8CAA8C,EAC9C,8DAA8D,EAC9D,sCAAsC,EACtC,iDAAiD,EACjD,iCAAiC,GAClC,oDAAgD"}

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 export type { AutoManagedNetworkClient } from "./create-auto-managed-network-client.mjs";
-export type { Block, NetworkMetadata, NetworkConfiguration, BuiltInNetworkClientId, CustomNetworkClientId, NetworkClientId, NetworksMetadata, NetworkState, BlockTrackerProxy, ProviderProxy, AddNetworkFields, UpdateNetworkFields, NetworkControllerStateChangeEvent, NetworkControllerNetworkWillChangeEvent, NetworkControllerNetworkDidChangeEvent, NetworkControllerInfuraIsBlockedEvent, NetworkControllerInfuraIsUnblockedEvent, NetworkControllerNetworkAddedEvent, NetworkControllerNetworkRemovedEvent, NetworkControllerEvents, NetworkControllerGetStateAction, NetworkControllerGetEthQueryAction, NetworkControllerGetNetworkClientByIdAction, NetworkControllerGetSelectedNetworkClientAction, NetworkControllerGetSelectedChainIdAction, NetworkControllerGetEIP1559CompatibilityAction, NetworkControllerFindNetworkClientIdByChainIdAction, NetworkControllerSetProviderTypeAction, NetworkControllerSetActiveNetworkAction, NetworkControllerAddNetworkAction, NetworkControllerRemoveNetworkAction, NetworkControllerUpdateNetworkAction, NetworkControllerGetNetworkConfigurationByNetworkClientId, NetworkControllerActions, NetworkControllerMessenger, NetworkControllerOptions, NetworkControllerRpcEndpointChainUnavailableEvent, NetworkControllerRpcEndpointUnavailableEvent, NetworkControllerRpcEndpointChainDegradedEvent, NetworkControllerRpcEndpointDegradedEvent, NetworkControllerRpcEndpointChainAvailableEvent, NetworkControllerRpcEndpointRetriedEvent, } from "./NetworkController.mjs";
+export type { Block, NetworkMetadata, NetworkConfiguration, BuiltInNetworkClientId, CustomNetworkClientId, NetworkClientId, NetworksMetadata, NetworkState, BlockTrackerProxy, ProviderProxy, AddNetworkFields, UpdateNetworkFields, NetworkControllerStateChangeEvent, NetworkControllerNetworkWillChangeEvent, NetworkControllerNetworkDidChangeEvent, NetworkControllerInfuraIsBlockedEvent, NetworkControllerInfuraIsUnblockedEvent, NetworkControllerNetworkAddedEvent, NetworkControllerNetworkRemovedEvent, NetworkControllerEvents, NetworkControllerGetStateAction, NetworkControllerGetNetworkConfigurationByNetworkClientId, NetworkControllerActions, NetworkControllerMessenger, NetworkControllerOptions, NetworkControllerRpcEndpointChainUnavailableEvent, NetworkControllerRpcEndpointUnavailableEvent, NetworkControllerRpcEndpointChainDegradedEvent, NetworkControllerRpcEndpointDegradedEvent, NetworkControllerRpcEndpointChainAvailableEvent, NetworkControllerRpcEndpointRetriedEvent, } from "./NetworkController.mjs";
 export { getDefaultNetworkControllerState, selectAvailableNetworkClientIds, knownKeysOf, NetworkController, RpcEndpointType, } from "./NetworkController.mjs";
 export * from "./constants.mjs";
 export type { BlockTracker, Provider } from "./types.mjs";
@@ -11,4 +11,5 @@ export type { RpcServiceRequestable } from "./rpc-service/rpc-service-requestabl
 export type { DegradedEventType, RetryReason } from "./create-network-client.mjs";
 export { classifyRetryReason } from "./create-network-client.mjs";
 export { isConnectionError } from "./rpc-service/rpc-service.mjs";
+export type { NetworkControllerGetEthQueryAction, NetworkControllerGetNetworkClientByIdAction, NetworkControllerGetSelectedNetworkClientAction, NetworkControllerGetSelectedChainIdAction, NetworkControllerGetEIP1559CompatibilityAction, NetworkControllerFindNetworkClientIdByChainIdAction, NetworkControllerSetProviderTypeAction, NetworkControllerSetActiveNetworkAction, NetworkControllerGetNetworkConfigurationByChainIdAction, NetworkControllerGetNetworkConfigurationByNetworkClientIdAction, NetworkControllerAddNetworkAction, NetworkControllerRemoveNetworkAction, NetworkControllerUpdateNetworkAction, NetworkControllerEnableRpcFailoverAction, NetworkControllerDisableRpcFailoverAction, NetworkControllerGetProviderAndBlockTrackerAction, NetworkControllerGetNetworkClientRegistryAction, NetworkControllerInitializeProviderAction, NetworkControllerLookupNetworkAction, NetworkControllerLookupNetworkByClientIdAction, NetworkControllerGet1559CompatibilityWithNetworkClientIdAction, NetworkControllerResetConnectionAction, NetworkControllerRollbackToPreviousProviderAction, NetworkControllerLoadBackupAction, } from "./NetworkController-method-action-types.mjs";
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,wBAAwB,EAAE,iDAA6C;AACrF,YAAY,EACV,KAAK,EACL,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,iCAAiC,EACjC,uCAAuC,EACvC,sCAAsC,EACtC,qCAAqC,EACrC,uCAAuC,EACvC,kCAAkC,EAClC,oCAAoC,EACpC,uBAAuB,EACvB,+BAA+B,EAC/B,kCAAkC,EAClC,2CAA2C,EAC3C,+CAA+C,EAC/C,yCAAyC,EACzC,8CAA8C,EAC9C,mDAAmD,EACnD,sCAAsC,EACtC,uCAAuC,EACvC,iCAAiC,EACjC,oCAAoC,EACpC,oCAAoC,EACpC,yDAAyD,EACzD,wBAAwB,EACxB,0BAA0B,EAC1B,wBAAwB,EACxB,iDAAiD,EACjD,4CAA4C,EAC5C,8CAA8C,EAC9C,yCAAyC,EACzC,+CAA+C,EAC/C,wCAAwC,GACzC,gCAA4B;AAC7B,OAAO,EACL,gCAAgC,EAChC,+BAA+B,EAC/B,WAAW,EACX,iBAAiB,EACjB,eAAe,GAChB,gCAA4B;AAC7B,gCAA4B;AAC5B,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,oBAAgB;AACtD,YAAY,EACV,0BAA0B,EAC1B,gCAAgC,EAChC,gCAAgC,GACjC,oBAAgB;AACjB,OAAO,EAAE,iBAAiB,EAAE,oBAAgB;AAC5C,YAAY,EAAE,aAAa,EAAE,oCAAgC;AAC7D,YAAY,EAAE,kBAAkB,EAAE,+CAA2C;AAC7E,YAAY,EAAE,qBAAqB,EAAE,kDAA8C;AACnF,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,oCAAgC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,oCAAgC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,sCAAkC"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,wBAAwB,EAAE,iDAA6C;AACrF,YAAY,EACV,KAAK,EACL,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,iCAAiC,EACjC,uCAAuC,EACvC,sCAAsC,EACtC,qCAAqC,EACrC,uCAAuC,EACvC,kCAAkC,EAClC,oCAAoC,EACpC,uBAAuB,EACvB,+BAA+B,EAC/B,yDAAyD,EACzD,wBAAwB,EACxB,0BAA0B,EAC1B,wBAAwB,EACxB,iDAAiD,EACjD,4CAA4C,EAC5C,8CAA8C,EAC9C,yCAAyC,EACzC,+CAA+C,EAC/C,wCAAwC,GACzC,gCAA4B;AAC7B,OAAO,EACL,gCAAgC,EAChC,+BAA+B,EAC/B,WAAW,EACX,iBAAiB,EACjB,eAAe,GAChB,gCAA4B;AAC7B,gCAA4B;AAC5B,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,oBAAgB;AACtD,YAAY,EACV,0BAA0B,EAC1B,gCAAgC,EAChC,gCAAgC,GACjC,oBAAgB;AACjB,OAAO,EAAE,iBAAiB,EAAE,oBAAgB;AAC5C,YAAY,EAAE,aAAa,EAAE,oCAAgC;AAC7D,YAAY,EAAE,kBAAkB,EAAE,+CAA2C;AAC7E,YAAY,EAAE,qBAAqB,EAAE,kDAA8C;AACnF,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,oCAAgC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,oCAAgC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,sCAAkC;AAC9D,YAAY,EACV,kCAAkC,EAClC,2CAA2C,EAC3C,+CAA+C,EAC/C,yCAAyC,EACzC,8CAA8C,EAC9C,mDAAmD,EACnD,sCAAsC,EACtC,uCAAuC,EACvC,uDAAuD,EACvD,+DAA+D,EAC/D,iCAAiC,EACjC,oCAAoC,EACpC,oCAAoC,EACpC,wCAAwC,EACxC,yCAAyC,EACzC,iDAAiD,EACjD,+CAA+C,EAC/C,yCAAyC,EACzC,oCAAoC,EACpC,8CAA8C,EAC9C,8DAA8D,EAC9D,sCAAsC,EACtC,iDAAiD,EACjD,iCAAiC,GAClC,oDAAgD"}

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA6CA,OAAO,EACL,gCAAgC,EAChC,+BAA+B,EAC/B,WAAW,EACX,iBAAiB,EACjB,eAAe,EAChB,gCAA4B;AAC7B,gCAA4B;AAO5B,OAAO,EAAE,iBAAiB,EAAE,oBAAgB;AAK5C,OAAO,EAAE,mBAAmB,EAAE,oCAAgC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,sCAAkC","sourcesContent":["export type { AutoManagedNetworkClient } from './create-auto-managed-network-client';\nexport type {\n  Block,\n  NetworkMetadata,\n  NetworkConfiguration,\n  BuiltInNetworkClientId,\n  CustomNetworkClientId,\n  NetworkClientId,\n  NetworksMetadata,\n  NetworkState,\n  BlockTrackerProxy,\n  ProviderProxy,\n  AddNetworkFields,\n  UpdateNetworkFields,\n  NetworkControllerStateChangeEvent,\n  NetworkControllerNetworkWillChangeEvent,\n  NetworkControllerNetworkDidChangeEvent,\n  NetworkControllerInfuraIsBlockedEvent,\n  NetworkControllerInfuraIsUnblockedEvent,\n  NetworkControllerNetworkAddedEvent,\n  NetworkControllerNetworkRemovedEvent,\n  NetworkControllerEvents,\n  NetworkControllerGetStateAction,\n  NetworkControllerGetEthQueryAction,\n  NetworkControllerGetNetworkClientByIdAction,\n  NetworkControllerGetSelectedNetworkClientAction,\n  NetworkControllerGetSelectedChainIdAction,\n  NetworkControllerGetEIP1559CompatibilityAction,\n  NetworkControllerFindNetworkClientIdByChainIdAction,\n  NetworkControllerSetProviderTypeAction,\n  NetworkControllerSetActiveNetworkAction,\n  NetworkControllerAddNetworkAction,\n  NetworkControllerRemoveNetworkAction,\n  NetworkControllerUpdateNetworkAction,\n  NetworkControllerGetNetworkConfigurationByNetworkClientId,\n  NetworkControllerActions,\n  NetworkControllerMessenger,\n  NetworkControllerOptions,\n  NetworkControllerRpcEndpointChainUnavailableEvent,\n  NetworkControllerRpcEndpointUnavailableEvent,\n  NetworkControllerRpcEndpointChainDegradedEvent,\n  NetworkControllerRpcEndpointDegradedEvent,\n  NetworkControllerRpcEndpointChainAvailableEvent,\n  NetworkControllerRpcEndpointRetriedEvent,\n} from './NetworkController';\nexport {\n  getDefaultNetworkControllerState,\n  selectAvailableNetworkClientIds,\n  knownKeysOf,\n  NetworkController,\n  RpcEndpointType,\n} from './NetworkController';\nexport * from './constants';\nexport type { BlockTracker, Provider } from './types';\nexport type {\n  NetworkClientConfiguration,\n  InfuraNetworkClientConfiguration,\n  CustomNetworkClientConfiguration,\n} from './types';\nexport { NetworkClientType } from './types';\nexport type { NetworkClient } from './create-network-client';\nexport type { AbstractRpcService } from './rpc-service/abstract-rpc-service';\nexport type { RpcServiceRequestable } from './rpc-service/rpc-service-requestable';\nexport type { DegradedEventType, RetryReason } from './create-network-client';\nexport { classifyRetryReason } from './create-network-client';\nexport { isConnectionError } from './rpc-service/rpc-service';\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAkCA,OAAO,EACL,gCAAgC,EAChC,+BAA+B,EAC/B,WAAW,EACX,iBAAiB,EACjB,eAAe,EAChB,gCAA4B;AAC7B,gCAA4B;AAO5B,OAAO,EAAE,iBAAiB,EAAE,oBAAgB;AAK5C,OAAO,EAAE,mBAAmB,EAAE,oCAAgC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,sCAAkC","sourcesContent":["export type { AutoManagedNetworkClient } from './create-auto-managed-network-client';\nexport type {\n  Block,\n  NetworkMetadata,\n  NetworkConfiguration,\n  BuiltInNetworkClientId,\n  CustomNetworkClientId,\n  NetworkClientId,\n  NetworksMetadata,\n  NetworkState,\n  BlockTrackerProxy,\n  ProviderProxy,\n  AddNetworkFields,\n  UpdateNetworkFields,\n  NetworkControllerStateChangeEvent,\n  NetworkControllerNetworkWillChangeEvent,\n  NetworkControllerNetworkDidChangeEvent,\n  NetworkControllerInfuraIsBlockedEvent,\n  NetworkControllerInfuraIsUnblockedEvent,\n  NetworkControllerNetworkAddedEvent,\n  NetworkControllerNetworkRemovedEvent,\n  NetworkControllerEvents,\n  NetworkControllerGetStateAction,\n  NetworkControllerGetNetworkConfigurationByNetworkClientId,\n  NetworkControllerActions,\n  NetworkControllerMessenger,\n  NetworkControllerOptions,\n  NetworkControllerRpcEndpointChainUnavailableEvent,\n  NetworkControllerRpcEndpointUnavailableEvent,\n  NetworkControllerRpcEndpointChainDegradedEvent,\n  NetworkControllerRpcEndpointDegradedEvent,\n  NetworkControllerRpcEndpointChainAvailableEvent,\n  NetworkControllerRpcEndpointRetriedEvent,\n} from './NetworkController';\nexport {\n  getDefaultNetworkControllerState,\n  selectAvailableNetworkClientIds,\n  knownKeysOf,\n  NetworkController,\n  RpcEndpointType,\n} from './NetworkController';\nexport * from './constants';\nexport type { BlockTracker, Provider } from './types';\nexport type {\n  NetworkClientConfiguration,\n  InfuraNetworkClientConfiguration,\n  CustomNetworkClientConfiguration,\n} from './types';\nexport { NetworkClientType } from './types';\nexport type { NetworkClient } from './create-network-client';\nexport type { AbstractRpcService } from './rpc-service/abstract-rpc-service';\nexport type { RpcServiceRequestable } from './rpc-service/rpc-service-requestable';\nexport type { DegradedEventType, RetryReason } from './create-network-client';\nexport { classifyRetryReason } from './create-network-client';\nexport { isConnectionError } from './rpc-service/rpc-service';\nexport type {\n  NetworkControllerGetEthQueryAction,\n  NetworkControllerGetNetworkClientByIdAction,\n  NetworkControllerGetSelectedNetworkClientAction,\n  NetworkControllerGetSelectedChainIdAction,\n  NetworkControllerGetEIP1559CompatibilityAction,\n  NetworkControllerFindNetworkClientIdByChainIdAction,\n  NetworkControllerSetProviderTypeAction,\n  NetworkControllerSetActiveNetworkAction,\n  NetworkControllerGetNetworkConfigurationByChainIdAction,\n  NetworkControllerGetNetworkConfigurationByNetworkClientIdAction,\n  NetworkControllerAddNetworkAction,\n  NetworkControllerRemoveNetworkAction,\n  NetworkControllerUpdateNetworkAction,\n  NetworkControllerEnableRpcFailoverAction,\n  NetworkControllerDisableRpcFailoverAction,\n  NetworkControllerGetProviderAndBlockTrackerAction,\n  NetworkControllerGetNetworkClientRegistryAction,\n  NetworkControllerInitializeProviderAction,\n  NetworkControllerLookupNetworkAction,\n  NetworkControllerLookupNetworkByClientIdAction,\n  NetworkControllerGet1559CompatibilityWithNetworkClientIdAction,\n  NetworkControllerResetConnectionAction,\n  NetworkControllerRollbackToPreviousProviderAction,\n  NetworkControllerLoadBackupAction,\n} from './NetworkController-method-action-types';\n"]}

package/dist/rpc-service/abstract-rpc-service.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"abstract-rpc-service.cjs","sourceRoot":"","sources":["../../src/rpc-service/abstract-rpc-service.ts"],"names":[],"mappings":"","sourcesContent":["import type { RpcServiceRequestable } from './rpc-service-requestable';\n\n/**\n * The interface for a service class responsible for making a request to an RPC\n * endpoint or a group of RPC endpoints.\n */\nexport type AbstractRpcService = RpcServiceRequestable & {\n  /**\n   * The URL of the RPC endpoint.\n   */\n  endpointUrl: URL;\n};\n"]}
+{"version":3,"file":"abstract-rpc-service.cjs","sourceRoot":"","sources":["../../src/rpc-service/abstract-rpc-service.ts"],"names":[],"mappings":"","sourcesContent":["import type { RpcServiceRequestable } from './rpc-service-requestable';\n\n/**\n * The interface for a service class responsible for making a request to an RPC\n * endpoint or a group of RPC endpoints.\n *\n * @deprecated Don't use this interface (it will be removed in an upcoming major\n * version). If you need to take an \"RPC-service-like\" argument, it's best to\n * declare which properties you're interested in rather than accepting the\n * entire RPC service interface.\n */\nexport type AbstractRpcService = RpcServiceRequestable & {\n  /**\n   * The URL of the RPC endpoint.\n   */\n  endpointUrl: URL;\n};\n"]}

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

@@ -2,6 +2,11 @@ import type { RpcServiceRequestable } from "./rpc-service-requestable.cjs";
 /**
  * The interface for a service class responsible for making a request to an RPC
  * endpoint or a group of RPC endpoints.
+ *
+ * @deprecated Don't use this interface (it will be removed in an upcoming major
+ * version). If you need to take an "RPC-service-like" argument, it's best to
+ * declare which properties you're interested in rather than accepting the
+ * entire RPC service interface.
  */
 export type AbstractRpcService = RpcServiceRequestable & {
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"abstract-rpc-service.d.cts","sourceRoot":"","sources":["../../src/rpc-service/abstract-rpc-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,sCAAkC;AAEvE;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,qBAAqB,GAAG;IACvD;;OAEG;IACH,WAAW,EAAE,GAAG,CAAC;CAClB,CAAC"}
+{"version":3,"file":"abstract-rpc-service.d.cts","sourceRoot":"","sources":["../../src/rpc-service/abstract-rpc-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,sCAAkC;AAEvE;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,GAAG,qBAAqB,GAAG;IACvD;;OAEG;IACH,WAAW,EAAE,GAAG,CAAC;CAClB,CAAC"}

package/dist/rpc-service/abstract-rpc-service.d.mts

@@ -2,6 +2,11 @@ import type { RpcServiceRequestable } from "./rpc-service-requestable.mjs";
 /**
  * The interface for a service class responsible for making a request to an RPC
  * endpoint or a group of RPC endpoints.
+ *
+ * @deprecated Don't use this interface (it will be removed in an upcoming major
+ * version). If you need to take an "RPC-service-like" argument, it's best to
+ * declare which properties you're interested in rather than accepting the
+ * entire RPC service interface.
  */
 export type AbstractRpcService = RpcServiceRequestable & {
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"abstract-rpc-service.d.mts","sourceRoot":"","sources":["../../src/rpc-service/abstract-rpc-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,sCAAkC;AAEvE;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,qBAAqB,GAAG;IACvD;;OAEG;IACH,WAAW,EAAE,GAAG,CAAC;CAClB,CAAC"}
+{"version":3,"file":"abstract-rpc-service.d.mts","sourceRoot":"","sources":["../../src/rpc-service/abstract-rpc-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,sCAAkC;AAEvE;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,GAAG,qBAAqB,GAAG;IACvD;;OAEG;IACH,WAAW,EAAE,GAAG,CAAC;CAClB,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"abstract-rpc-service.mjs","sourceRoot":"","sources":["../../src/rpc-service/abstract-rpc-service.ts"],"names":[],"mappings":"","sourcesContent":["import type { RpcServiceRequestable } from './rpc-service-requestable';\n\n/**\n * The interface for a service class responsible for making a request to an RPC\n * endpoint or a group of RPC endpoints.\n */\nexport type AbstractRpcService = RpcServiceRequestable & {\n  /**\n   * The URL of the RPC endpoint.\n   */\n  endpointUrl: URL;\n};\n"]}
+{"version":3,"file":"abstract-rpc-service.mjs","sourceRoot":"","sources":["../../src/rpc-service/abstract-rpc-service.ts"],"names":[],"mappings":"","sourcesContent":["import type { RpcServiceRequestable } from './rpc-service-requestable';\n\n/**\n * The interface for a service class responsible for making a request to an RPC\n * endpoint or a group of RPC endpoints.\n *\n * @deprecated Don't use this interface (it will be removed in an upcoming major\n * version). If you need to take an \"RPC-service-like\" argument, it's best to\n * declare which properties you're interested in rather than accepting the\n * entire RPC service interface.\n */\nexport type AbstractRpcService = RpcServiceRequestable & {\n  /**\n   * The URL of the RPC endpoint.\n   */\n  endpointUrl: URL;\n};\n"]}

package/dist/rpc-service/rpc-service-chain.cjs

@@ -14,8 +14,8 @@ var _RpcServiceChain_onAvailableEventEmitter, _RpcServiceChain_onBreakEventEmitt
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RpcServiceChain = void 0;
 const controller_utils_1 = require("@metamask/controller-utils");
-const rpc_service_1 = require("./rpc-service.cjs");
 const logger_1 = require("../logger.cjs");
+const rpc_service_1 = require("./rpc-service.cjs");
 const log = (0, logger_1.createModuleLogger)(logger_1.projectLogger, 'RpcServiceChain');
 /**
  * Statuses that the RPC service chain can be in.

package/dist/rpc-service/rpc-service-chain.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"rpc-service-chain.cjs","sourceRoot":"","sources":["../../src/rpc-service/rpc-service-chain.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  CircuitState,\n  CockatielEventEmitter,\n} from '@metamask/controller-utils';\nimport type {\n  Json,\n  JsonRpcParams,\n  JsonRpcRequest,\n  JsonRpcResponse,\n} from '@metamask/utils';\nimport { IDisposable } from 'cockatiel';\n\nimport { RpcService } from './rpc-service';\nimport type { RpcServiceOptions } from './rpc-service';\nimport type {\n  CockatielEventToEventListenerWithData,\n  ExcludeCockatielEventData,\n  ExtractCockatielEventData,\n  FetchOptions,\n} from './shared';\nimport { projectLogger, createModuleLogger } from '../logger';\n\nconst log = createModuleLogger(projectLogger, 'RpcServiceChain');\n\n/**\n * Statuses that the RPC service chain can be in.\n */\nconst STATUSES = {\n  Available: 'available',\n  Degraded: 'degraded',\n  Unknown: 'unknown',\n  Unavailable: 'unavailable',\n} as const;\n\n/**\n * Statuses that the RPC service chain can be in.\n */\ntype Status = (typeof STATUSES)[keyof typeof STATUSES];\n\n/**\n * This class constructs and manages requests to a chain of RpcService objects\n * which represent RPC endpoints with which to access a particular network. The\n * first service in the chain is intended to be the primary way of hitting the\n * network and the remaining services are used as failovers.\n */\nexport class RpcServiceChain {\n  /**\n   * The event emitter for the `onAvailable` event.\n   */\n  readonly #onAvailableEventEmitter: CockatielEventEmitter<\n    ExcludeCockatielEventData<\n      ExtractCockatielEventData<RpcService['onAvailable']>,\n      'endpointUrl'\n    >\n  >;\n\n  /**\n   * The event emitter for the `onBreak` event.\n   */\n  readonly #onBreakEventEmitter: CockatielEventEmitter<\n    ExcludeCockatielEventData<\n      ExtractCockatielEventData<RpcService['onBreak']>,\n      'endpointUrl'\n    >\n  >;\n\n  /**\n   * The event emitter for the `onDegraded` event.\n   */\n  readonly #onDegradedEventEmitter: CockatielEventEmitter<\n    ExcludeCockatielEventData<\n      ExtractCockatielEventData<RpcService['onDegraded']>,\n      'endpointUrl'\n    >\n  >;\n\n  /**\n   * The first RPC service that requests will be sent to.\n   */\n  readonly #primaryService: RpcService;\n\n  /**\n   * The RPC services in the chain.\n   */\n  readonly #services: RpcService[];\n\n  /**\n   * The status of the RPC service chain.\n   */\n  #status: Status;\n\n  /**\n   * Constructs a new RpcServiceChain object.\n   *\n   * @param rpcServiceConfigurations - The options for the RPC services\n   * that you want to construct. Each object in this array is the same as\n   * {@link RpcServiceOptions}.\n   */\n  constructor(\n    rpcServiceConfigurations: [RpcServiceOptions, ...RpcServiceOptions[]],\n  ) {\n    this.#services = rpcServiceConfigurations.map(\n      (rpcServiceConfiguration) => new RpcService(rpcServiceConfiguration),\n    );\n    this.#primaryService = this.#services[0];\n\n    this.#status = STATUSES.Unknown;\n    this.#onBreakEventEmitter = new CockatielEventEmitter<\n      ExcludeCockatielEventData<\n        ExtractCockatielEventData<RpcService['onBreak']>,\n        'endpointUrl'\n      >\n    >();\n\n    this.#onDegradedEventEmitter = new CockatielEventEmitter<\n      ExcludeCockatielEventData<\n        ExtractCockatielEventData<RpcService['onDegraded']>,\n        'endpointUrl'\n      >\n    >();\n    for (const service of this.#services) {\n      service.onDegraded((data) => {\n        if (this.#status !== STATUSES.Degraded) {\n          log('Updating status to \"degraded\"', data);\n          this.#status = STATUSES.Degraded;\n          const { endpointUrl, ...rest } = data;\n          this.#onDegradedEventEmitter.emit(rest);\n        }\n      });\n    }\n\n    this.#onAvailableEventEmitter = new CockatielEventEmitter<\n      ExcludeCockatielEventData<\n        ExtractCockatielEventData<RpcService['onAvailable']>,\n        'endpointUrl'\n      >\n    >();\n    for (const service of this.#services) {\n      service.onAvailable((data) => {\n        if (this.#status !== STATUSES.Available) {\n          log('Updating status to \"available\"', data);\n          this.#status = STATUSES.Available;\n          const { endpointUrl, ...rest } = data;\n          this.#onAvailableEventEmitter.emit(rest);\n        }\n      });\n    }\n  }\n\n  /**\n   * Calls the provided callback when any of the RPC services is retried.\n   *\n   * This is mainly useful for tests.\n   *\n   * @param listener - The callback to be called.\n   * @returns An object with a `dispose` method which can be used to unregister\n   * the event listener.\n   */\n  onServiceRetry(\n    listener: CockatielEventToEventListenerWithData<\n      RpcService['onRetry'],\n      { primaryEndpointUrl: string }\n    >,\n  ): { dispose(): void } {\n    const disposables = this.#services.map((service) =>\n      service.onRetry((data) => {\n        listener({\n          ...data,\n          primaryEndpointUrl: this.#primaryService.endpointUrl.toString(),\n        });\n      }),\n    );\n\n    return {\n      dispose(): void {\n        disposables.forEach((disposable) => disposable.dispose());\n      },\n    };\n  }\n\n  /**\n   * Calls the provided callback only when the maximum number of failed\n   * consecutive attempts to receive a 2xx response has been reached for all\n   * RPC services in the chain, and all services' underlying circuits have\n   * broken.\n   *\n   * The callback will not be called if a service's circuit breaks but its\n   * failover does not. Use `onServiceBreak` if you'd like a lower level of\n   * granularity.\n   *\n   * @param listener - The callback to be called.\n   * @returns An object with a `dispose` method which can be used to unregister\n   * the callback.\n   */\n  onBreak(\n    listener: (\n      data: ExcludeCockatielEventData<\n        ExtractCockatielEventData<RpcService['onBreak']>,\n        'endpointUrl'\n      >,\n    ) => void,\n  ): IDisposable {\n    return this.#onBreakEventEmitter.addListener(listener);\n  }\n\n  /**\n   * Calls the provided callback each time when, for *any* of the RPC services\n   * in this chain, the maximum number of failed consecutive attempts to receive\n   * a 2xx response has been reached and the underlying circuit has broken. A\n   * more granular version of `onBreak`.\n   *\n   * @param listener - The callback to be called.\n   * @returns An object with a `dispose` method which can be used to unregister\n   * the callback.\n   */\n  onServiceBreak(\n    listener: CockatielEventToEventListenerWithData<\n      RpcService['onBreak'],\n      { primaryEndpointUrl: string }\n    >,\n  ): IDisposable {\n    const disposables = this.#services.map((service) =>\n      service.onBreak((data) => {\n        listener({\n          ...data,\n          primaryEndpointUrl: this.#primaryService.endpointUrl.toString(),\n        });\n      }),\n    );\n\n    return {\n      dispose(): void {\n        disposables.forEach((disposable) => disposable.dispose());\n      },\n    };\n  }\n\n  /**\n   * Calls the provided callback if no requests have been initiated yet or\n   * all requests to RPC services in this chain have responded successfully in a\n   * timely fashion, and then one of the two conditions apply:\n   *\n   * 1. When a retriable error is encountered making a request to an RPC\n   * service, and the request is retried until a set maximum is reached.\n   * 2. When a RPC service responds successfully, but the request takes longer\n   * than a set number of seconds to complete.\n   *\n   * Note that the callback will be called even if there are local connectivity\n   * issues which prevent requests from being initiated. This is intentional.\n   *\n   * Also note this callback will only be called if the RPC service chain as a\n   * whole is in a \"degraded\" state, and will then only be called once (e.g., it\n   * will not be called if a failover service falls into a degraded state, then\n   * the primary comes back online, but it is slow). Use `onServiceDegraded` if\n   * you'd like a lower level of granularity.\n   *\n   * @param listener - The callback to be called.\n   * @returns An object with a `dispose` method which can be used to unregister\n   * the callback.\n   */\n  onDegraded(\n    listener: (\n      data: ExcludeCockatielEventData<\n        ExtractCockatielEventData<RpcService['onDegraded']>,\n        'endpointUrl'\n      >,\n    ) => void,\n  ): IDisposable {\n    return this.#onDegradedEventEmitter.addListener(listener);\n  }\n\n  /**\n   * Calls the provided callback each time one of the two conditions apply:\n   *\n   * 1. When a retriable error is encountered making a request to an RPC\n   * service, and the request is retried until a set maximum is reached.\n   * 2. When a RPC service responds successfully, but the request takes longer\n   * than a set number of seconds to complete.\n   *\n   * Note that the callback will be called even if there are local connectivity\n   * issues which prevent requests from being initiated. This is intentional.\n   *\n   * This is a more granular version of `onDegraded`. The callback will be\n   * called for each slow request to an RPC service. It may also be called again\n   * if a failover service falls into a degraded state, then the primary comes\n   * back online, but it is slow.\n   *\n   * @param listener - The callback to be called.\n   * @returns An object with a `dispose` method which can be used to unregister\n   * the callback.\n   */\n  onServiceDegraded(\n    listener: CockatielEventToEventListenerWithData<\n      RpcService['onDegraded'],\n      { primaryEndpointUrl: string }\n    >,\n  ): IDisposable {\n    const disposables = this.#services.map((service) =>\n      service.onDegraded((data) => {\n        listener({\n          ...data,\n          primaryEndpointUrl: this.#primaryService.endpointUrl.toString(),\n        });\n      }),\n    );\n\n    return {\n      dispose(): void {\n        disposables.forEach((disposable) => disposable.dispose());\n      },\n    };\n  }\n\n  /**\n   * Calls the provided callback in one of the following two conditions:\n   *\n   * 1. The first time that a 2xx request is made to any of the RPC services in\n   * this chain.\n   * 2. When requests to any the failover RPC services in this chain were\n   * failing such that they were degraded or their underyling circuits broke,\n   * but the first request to the primary succeeds again.\n   *\n   * Note this callback will only be called if the RPC service chain as a whole\n   * is in an \"available\" state.\n   *\n   * @param listener - The callback to be called.\n   * @returns An object with a `dispose` method which can be used to unregister\n   * the callback.\n   */\n  onAvailable(\n    listener: (\n      data: ExcludeCockatielEventData<\n        ExtractCockatielEventData<RpcService['onAvailable']>,\n        'endpointUrl'\n      >,\n    ) => void,\n  ): IDisposable {\n    return this.#onAvailableEventEmitter.addListener(listener);\n  }\n\n  /**\n   * Uses the RPC services in the chain to make a request, using each service\n   * after the first as a fallback to the previous one as necessary.\n   *\n   * This overload is specifically designed for `eth_getBlockByNumber`, which\n   * can return a `result` of `null` despite an expected `Result` being\n   * provided.\n   *\n   * @param jsonRpcRequest - The JSON-RPC request to send to the endpoint.\n   * @param fetchOptions - An options bag for {@link fetch} which further\n   * specifies the request.\n   * @returns The decoded JSON-RPC response from the endpoint.\n   * @throws A 401 error if the response status is 401.\n   * @throws A \"rate limiting\" error if the response HTTP status is 429.\n   * @throws A \"resource unavailable\" error if the response status is 402, 404, or any 5xx.\n   * @throws A generic HTTP client error (-32100) for any other 4xx status codes.\n   * @throws A \"parse\" error if the response is not valid JSON.\n   */\n  async request<Params extends JsonRpcParams, Result extends Json>(\n    jsonRpcRequest: Readonly<JsonRpcRequest<Params>> & {\n      method: 'eth_getBlockByNumber';\n    },\n    fetchOptions?: FetchOptions,\n  ): Promise<JsonRpcResponse<Result> | JsonRpcResponse<null>>;\n\n  /**\n   * Uses the RPC services in the chain to make a request, using each service\n   * after the first as a fallback to the previous one as necessary.\n   *\n   * This overload is designed for all RPC methods except for\n   * `eth_getBlockByNumber`, which are expected to return a `result` of the\n   * expected `Result`.\n   *\n   * @param jsonRpcRequest - The JSON-RPC request to send to the endpoint.\n   * @param fetchOptions - An options bag for {@link fetch} which further\n   * specifies the request.\n   * @returns The decoded JSON-RPC response from the endpoint.\n   * @throws A 401 error if the response status is 401.\n   * @throws A \"rate limiting\" error if the response HTTP status is 429.\n   * @throws A \"resource unavailable\" error if the response status is 402, 404, or any 5xx.\n   * @throws A generic HTTP client error (-32100) for any other 4xx status codes.\n   * @throws A \"parse\" error if the response is not valid JSON.\n   */\n  async request<Params extends JsonRpcParams, Result extends Json>(\n    jsonRpcRequest: Readonly<JsonRpcRequest<Params>>,\n    fetchOptions?: FetchOptions,\n  ): Promise<JsonRpcResponse<Result>>;\n\n  async request<Params extends JsonRpcParams, Result extends Json>(\n    jsonRpcRequest: Readonly<JsonRpcRequest<Params>>,\n    fetchOptions: FetchOptions = {},\n  ): Promise<JsonRpcResponse<Result | null>> {\n    // Start with the primary (first) service and switch to failovers as the\n    // need arises. This is a bit confusing, so keep reading for more on how\n    // this works.\n\n    let availableServiceIndex: number | undefined;\n    let response: JsonRpcResponse<Result> | undefined;\n\n    for (const [i, service] of this.#services.entries()) {\n      log(`Trying service #${i + 1}...`);\n      const previousCircuitState = service.getCircuitState();\n\n      try {\n        // Try making the request through the service.\n        response = await service.request<Params, Result>(\n          jsonRpcRequest,\n          fetchOptions,\n        );\n        log('Service successfully received request.');\n        availableServiceIndex = i;\n        break;\n      } catch (error) {\n        // Oops, that didn't work.\n        // Capture this error so that we can handle it later.\n\n        const { lastError } = service;\n        const isCircuitOpen = service.getCircuitState() === CircuitState.Open;\n\n        log('Service failed! error =', error, 'lastError = ', lastError);\n\n        if (isCircuitOpen) {\n          if (i < this.#services.length - 1) {\n            log(\n              \"This service's circuit is open. Proceeding to next service...\",\n            );\n            continue;\n          }\n\n          if (\n            previousCircuitState !== CircuitState.Open &&\n            this.#status !== STATUSES.Unavailable &&\n            lastError !== undefined\n          ) {\n            // If the service's circuit just broke and it's the last one in the\n            // chain, then trigger the onBreak event. (But if for some reason we\n            // have already done this, then don't do it.)\n            log(\n              'This service\\'s circuit just opened and it is the last service. Updating status to \"unavailable\" and triggering onBreak.',\n            );\n            this.#status = STATUSES.Unavailable;\n            this.#onBreakEventEmitter.emit({\n              error: lastError,\n            });\n          }\n        }\n\n        // The service failed, and we throw whatever the error is. The calling\n        // code can try again if it so desires.\n        log(\n          `${isCircuitOpen ? '' : \"This service's circuit is closed. \"}Re-throwing error.`,\n        );\n        throw error;\n      }\n    }\n\n    if (response) {\n      // If one of the services is available, reset all of the circuits of the\n      // following services. If we didn't do this and the service became\n      // unavailable in the future, and any of the failovers' circuits were\n      // open (due to previous failures), we would receive a \"circuit broken\"\n      // error when we attempted to divert traffic to the failovers again.\n      //\n      if (availableServiceIndex !== undefined) {\n        for (const [i, service] of [...this.#services.entries()].slice(\n          availableServiceIndex + 1,\n        )) {\n          log(`Resetting policy for service #${i + 1}.`);\n          service.resetPolicy();\n        }\n      }\n\n      return response;\n    }\n\n    // The only way we can end up here is if there are no services to loop over.\n    // That is not possible due to the types on the constructor, but TypeScript\n    // doesn't know this, so we have to appease it.\n    throw new Error('Nothing to return');\n  }\n}\n"]}
+{"version":3,"file":"rpc-service-chain.cjs","sourceRoot":"","sources":["../../src/rpc-service/rpc-service-chain.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  CircuitState,\n  CockatielEventEmitter,\n} from '@metamask/controller-utils';\nimport type {\n  Json,\n  JsonRpcParams,\n  JsonRpcRequest,\n  JsonRpcResponse,\n} from '@metamask/utils';\nimport { IDisposable } from 'cockatiel';\n\nimport { projectLogger, createModuleLogger } from '../logger';\nimport { RpcService } from './rpc-service';\nimport type { RpcServiceOptions } from './rpc-service';\nimport type {\n  CockatielEventToEventListenerWithData,\n  ExcludeCockatielEventData,\n  ExtractCockatielEventData,\n  FetchOptions,\n} from './shared';\n\nconst log = createModuleLogger(projectLogger, 'RpcServiceChain');\n\n/**\n * Statuses that the RPC service chain can be in.\n */\nconst STATUSES = {\n  Available: 'available',\n  Degraded: 'degraded',\n  Unknown: 'unknown',\n  Unavailable: 'unavailable',\n} as const;\n\n/**\n * Statuses that the RPC service chain can be in.\n */\ntype Status = (typeof STATUSES)[keyof typeof STATUSES];\n\n/**\n * This class constructs and manages requests to a chain of RpcService objects\n * which represent RPC endpoints with which to access a particular network. The\n * first service in the chain is intended to be the primary way of hitting the\n * network and the remaining services are used as failovers.\n */\nexport class RpcServiceChain {\n  /**\n   * The event emitter for the `onAvailable` event.\n   */\n  readonly #onAvailableEventEmitter: CockatielEventEmitter<\n    ExcludeCockatielEventData<\n      ExtractCockatielEventData<RpcService['onAvailable']>,\n      'endpointUrl'\n    >\n  >;\n\n  /**\n   * The event emitter for the `onBreak` event.\n   */\n  readonly #onBreakEventEmitter: CockatielEventEmitter<\n    ExcludeCockatielEventData<\n      ExtractCockatielEventData<RpcService['onBreak']>,\n      'endpointUrl'\n    >\n  >;\n\n  /**\n   * The event emitter for the `onDegraded` event.\n   */\n  readonly #onDegradedEventEmitter: CockatielEventEmitter<\n    ExcludeCockatielEventData<\n      ExtractCockatielEventData<RpcService['onDegraded']>,\n      'endpointUrl'\n    >\n  >;\n\n  /**\n   * The first RPC service that requests will be sent to.\n   */\n  readonly #primaryService: RpcService;\n\n  /**\n   * The RPC services in the chain.\n   */\n  readonly #services: RpcService[];\n\n  /**\n   * The status of the RPC service chain.\n   */\n  #status: Status;\n\n  /**\n   * Constructs a new RpcServiceChain object.\n   *\n   * @param rpcServiceConfigurations - The options for the RPC services\n   * that you want to construct. Each object in this array is the same as\n   * {@link RpcServiceOptions}.\n   */\n  constructor(\n    rpcServiceConfigurations: [RpcServiceOptions, ...RpcServiceOptions[]],\n  ) {\n    this.#services = rpcServiceConfigurations.map(\n      (rpcServiceConfiguration) => new RpcService(rpcServiceConfiguration),\n    );\n    this.#primaryService = this.#services[0];\n\n    this.#status = STATUSES.Unknown;\n    this.#onBreakEventEmitter = new CockatielEventEmitter<\n      ExcludeCockatielEventData<\n        ExtractCockatielEventData<RpcService['onBreak']>,\n        'endpointUrl'\n      >\n    >();\n\n    this.#onDegradedEventEmitter = new CockatielEventEmitter<\n      ExcludeCockatielEventData<\n        ExtractCockatielEventData<RpcService['onDegraded']>,\n        'endpointUrl'\n      >\n    >();\n    for (const service of this.#services) {\n      service.onDegraded((data) => {\n        if (this.#status !== STATUSES.Degraded) {\n          log('Updating status to \"degraded\"', data);\n          this.#status = STATUSES.Degraded;\n          const { endpointUrl, ...rest } = data;\n          this.#onDegradedEventEmitter.emit(rest);\n        }\n      });\n    }\n\n    this.#onAvailableEventEmitter = new CockatielEventEmitter<\n      ExcludeCockatielEventData<\n        ExtractCockatielEventData<RpcService['onAvailable']>,\n        'endpointUrl'\n      >\n    >();\n    for (const service of this.#services) {\n      service.onAvailable((data) => {\n        if (this.#status !== STATUSES.Available) {\n          log('Updating status to \"available\"', data);\n          this.#status = STATUSES.Available;\n          const { endpointUrl, ...rest } = data;\n          this.#onAvailableEventEmitter.emit(rest);\n        }\n      });\n    }\n  }\n\n  /**\n   * Calls the provided callback when any of the RPC services is retried.\n   *\n   * This is mainly useful for tests.\n   *\n   * @param listener - The callback to be called.\n   * @returns An object with a `dispose` method which can be used to unregister\n   * the event listener.\n   */\n  onServiceRetry(\n    listener: CockatielEventToEventListenerWithData<\n      RpcService['onRetry'],\n      { primaryEndpointUrl: string }\n    >,\n  ): { dispose(): void } {\n    const disposables = this.#services.map((service) =>\n      service.onRetry((data) => {\n        listener({\n          ...data,\n          primaryEndpointUrl: this.#primaryService.endpointUrl.toString(),\n        });\n      }),\n    );\n\n    return {\n      dispose(): void {\n        disposables.forEach((disposable) => disposable.dispose());\n      },\n    };\n  }\n\n  /**\n   * Calls the provided callback only when the maximum number of failed\n   * consecutive attempts to receive a 2xx response has been reached for all\n   * RPC services in the chain, and all services' underlying circuits have\n   * broken.\n   *\n   * The callback will not be called if a service's circuit breaks but its\n   * failover does not. Use `onServiceBreak` if you'd like a lower level of\n   * granularity.\n   *\n   * @param listener - The callback to be called.\n   * @returns An object with a `dispose` method which can be used to unregister\n   * the callback.\n   */\n  onBreak(\n    listener: (\n      data: ExcludeCockatielEventData<\n        ExtractCockatielEventData<RpcService['onBreak']>,\n        'endpointUrl'\n      >,\n    ) => void,\n  ): IDisposable {\n    return this.#onBreakEventEmitter.addListener(listener);\n  }\n\n  /**\n   * Calls the provided callback each time when, for *any* of the RPC services\n   * in this chain, the maximum number of failed consecutive attempts to receive\n   * a 2xx response has been reached and the underlying circuit has broken. A\n   * more granular version of `onBreak`.\n   *\n   * @param listener - The callback to be called.\n   * @returns An object with a `dispose` method which can be used to unregister\n   * the callback.\n   */\n  onServiceBreak(\n    listener: CockatielEventToEventListenerWithData<\n      RpcService['onBreak'],\n      { primaryEndpointUrl: string }\n    >,\n  ): IDisposable {\n    const disposables = this.#services.map((service) =>\n      service.onBreak((data) => {\n        listener({\n          ...data,\n          primaryEndpointUrl: this.#primaryService.endpointUrl.toString(),\n        });\n      }),\n    );\n\n    return {\n      dispose(): void {\n        disposables.forEach((disposable) => disposable.dispose());\n      },\n    };\n  }\n\n  /**\n   * Calls the provided callback if no requests have been initiated yet or\n   * all requests to RPC services in this chain have responded successfully in a\n   * timely fashion, and then one of the two conditions apply:\n   *\n   * 1. When a retriable error is encountered making a request to an RPC\n   * service, and the request is retried until a set maximum is reached.\n   * 2. When a RPC service responds successfully, but the request takes longer\n   * than a set number of seconds to complete.\n   *\n   * Note that the callback will be called even if there are local connectivity\n   * issues which prevent requests from being initiated. This is intentional.\n   *\n   * Also note this callback will only be called if the RPC service chain as a\n   * whole is in a \"degraded\" state, and will then only be called once (e.g., it\n   * will not be called if a failover service falls into a degraded state, then\n   * the primary comes back online, but it is slow). Use `onServiceDegraded` if\n   * you'd like a lower level of granularity.\n   *\n   * @param listener - The callback to be called.\n   * @returns An object with a `dispose` method which can be used to unregister\n   * the callback.\n   */\n  onDegraded(\n    listener: (\n      data: ExcludeCockatielEventData<\n        ExtractCockatielEventData<RpcService['onDegraded']>,\n        'endpointUrl'\n      >,\n    ) => void,\n  ): IDisposable {\n    return this.#onDegradedEventEmitter.addListener(listener);\n  }\n\n  /**\n   * Calls the provided callback each time one of the two conditions apply:\n   *\n   * 1. When a retriable error is encountered making a request to an RPC\n   * service, and the request is retried until a set maximum is reached.\n   * 2. When a RPC service responds successfully, but the request takes longer\n   * than a set number of seconds to complete.\n   *\n   * Note that the callback will be called even if there are local connectivity\n   * issues which prevent requests from being initiated. This is intentional.\n   *\n   * This is a more granular version of `onDegraded`. The callback will be\n   * called for each slow request to an RPC service. It may also be called again\n   * if a failover service falls into a degraded state, then the primary comes\n   * back online, but it is slow.\n   *\n   * @param listener - The callback to be called.\n   * @returns An object with a `dispose` method which can be used to unregister\n   * the callback.\n   */\n  onServiceDegraded(\n    listener: CockatielEventToEventListenerWithData<\n      RpcService['onDegraded'],\n      { primaryEndpointUrl: string }\n    >,\n  ): IDisposable {\n    const disposables = this.#services.map((service) =>\n      service.onDegraded((data) => {\n        listener({\n          ...data,\n          primaryEndpointUrl: this.#primaryService.endpointUrl.toString(),\n        });\n      }),\n    );\n\n    return {\n      dispose(): void {\n        disposables.forEach((disposable) => disposable.dispose());\n      },\n    };\n  }\n\n  /**\n   * Calls the provided callback in one of the following two conditions:\n   *\n   * 1. The first time that a 2xx request is made to any of the RPC services in\n   * this chain.\n   * 2. When requests to any the failover RPC services in this chain were\n   * failing such that they were degraded or their underyling circuits broke,\n   * but the first request to the primary succeeds again.\n   *\n   * Note this callback will only be called if the RPC service chain as a whole\n   * is in an \"available\" state.\n   *\n   * @param listener - The callback to be called.\n   * @returns An object with a `dispose` method which can be used to unregister\n   * the callback.\n   */\n  onAvailable(\n    listener: (\n      data: ExcludeCockatielEventData<\n        ExtractCockatielEventData<RpcService['onAvailable']>,\n        'endpointUrl'\n      >,\n    ) => void,\n  ): IDisposable {\n    return this.#onAvailableEventEmitter.addListener(listener);\n  }\n\n  /**\n   * Uses the RPC services in the chain to make a request, using each service\n   * after the first as a fallback to the previous one as necessary.\n   *\n   * This overload is specifically designed for `eth_getBlockByNumber`, which\n   * can return a `result` of `null` despite an expected `Result` being\n   * provided.\n   *\n   * @param jsonRpcRequest - The JSON-RPC request to send to the endpoint.\n   * @param fetchOptions - An options bag for {@link fetch} which further\n   * specifies the request.\n   * @returns The decoded JSON-RPC response from the endpoint.\n   * @throws A 401 error if the response status is 401.\n   * @throws A \"rate limiting\" error if the response HTTP status is 429.\n   * @throws A \"resource unavailable\" error if the response status is 402, 404, or any 5xx.\n   * @throws A generic HTTP client error (-32100) for any other 4xx status codes.\n   * @throws A \"parse\" error if the response is not valid JSON.\n   */\n  async request<Params extends JsonRpcParams, Result extends Json>(\n    jsonRpcRequest: Readonly<JsonRpcRequest<Params>> & {\n      method: 'eth_getBlockByNumber';\n    },\n    fetchOptions?: FetchOptions,\n  ): Promise<JsonRpcResponse<Result> | JsonRpcResponse<null>>;\n\n  /**\n   * Uses the RPC services in the chain to make a request, using each service\n   * after the first as a fallback to the previous one as necessary.\n   *\n   * This overload is designed for all RPC methods except for\n   * `eth_getBlockByNumber`, which are expected to return a `result` of the\n   * expected `Result`.\n   *\n   * @param jsonRpcRequest - The JSON-RPC request to send to the endpoint.\n   * @param fetchOptions - An options bag for {@link fetch} which further\n   * specifies the request.\n   * @returns The decoded JSON-RPC response from the endpoint.\n   * @throws A 401 error if the response status is 401.\n   * @throws A \"rate limiting\" error if the response HTTP status is 429.\n   * @throws A \"resource unavailable\" error if the response status is 402, 404, or any 5xx.\n   * @throws A generic HTTP client error (-32100) for any other 4xx status codes.\n   * @throws A \"parse\" error if the response is not valid JSON.\n   */\n  async request<Params extends JsonRpcParams, Result extends Json>(\n    jsonRpcRequest: Readonly<JsonRpcRequest<Params>>,\n    fetchOptions?: FetchOptions,\n  ): Promise<JsonRpcResponse<Result>>;\n\n  async request<Params extends JsonRpcParams, Result extends Json>(\n    jsonRpcRequest: Readonly<JsonRpcRequest<Params>>,\n    fetchOptions: FetchOptions = {},\n  ): Promise<JsonRpcResponse<Result | null>> {\n    // Start with the primary (first) service and switch to failovers as the\n    // need arises. This is a bit confusing, so keep reading for more on how\n    // this works.\n\n    let availableServiceIndex: number | undefined;\n    let response: JsonRpcResponse<Result> | undefined;\n\n    for (const [i, service] of this.#services.entries()) {\n      log(`Trying service #${i + 1}...`);\n      const previousCircuitState = service.getCircuitState();\n\n      try {\n        // Try making the request through the service.\n        response = await service.request<Params, Result>(\n          jsonRpcRequest,\n          fetchOptions,\n        );\n        log('Service successfully received request.');\n        availableServiceIndex = i;\n        break;\n      } catch (error) {\n        // Oops, that didn't work.\n        // Capture this error so that we can handle it later.\n\n        const { lastError } = service;\n        const isCircuitOpen = service.getCircuitState() === CircuitState.Open;\n\n        log('Service failed! error =', error, 'lastError = ', lastError);\n\n        if (isCircuitOpen) {\n          if (i < this.#services.length - 1) {\n            log(\n              \"This service's circuit is open. Proceeding to next service...\",\n            );\n            continue;\n          }\n\n          if (\n            previousCircuitState !== CircuitState.Open &&\n            this.#status !== STATUSES.Unavailable &&\n            lastError !== undefined\n          ) {\n            // If the service's circuit just broke and it's the last one in the\n            // chain, then trigger the onBreak event. (But if for some reason we\n            // have already done this, then don't do it.)\n            log(\n              'This service\\'s circuit just opened and it is the last service. Updating status to \"unavailable\" and triggering onBreak.',\n            );\n            this.#status = STATUSES.Unavailable;\n            this.#onBreakEventEmitter.emit({\n              error: lastError,\n            });\n          }\n        }\n\n        // The service failed, and we throw whatever the error is. The calling\n        // code can try again if it so desires.\n        log(\n          `${isCircuitOpen ? '' : \"This service's circuit is closed. \"}Re-throwing error.`,\n        );\n        throw error;\n      }\n    }\n\n    if (response) {\n      // If one of the services is available, reset all of the circuits of the\n      // following services. If we didn't do this and the service became\n      // unavailable in the future, and any of the failovers' circuits were\n      // open (due to previous failures), we would receive a \"circuit broken\"\n      // error when we attempted to divert traffic to the failovers again.\n      //\n      if (availableServiceIndex !== undefined) {\n        for (const [i, service] of [...this.#services.entries()].slice(\n          availableServiceIndex + 1,\n        )) {\n          log(`Resetting policy for service #${i + 1}.`);\n          service.resetPolicy();\n        }\n      }\n\n      return response;\n    }\n\n    // The only way we can end up here is if there are no services to loop over.\n    // That is not possible due to the types on the constructor, but TypeScript\n    // doesn't know this, so we have to appease it.\n    throw new Error('Nothing to return');\n  }\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"rpc-service-chain.d.cts","sourceRoot":"","sources":["../../src/rpc-service/rpc-service-chain.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,IAAI,EACJ,aAAa,EACb,cAAc,EACd,eAAe,EAChB,wBAAwB;AACzB,OAAO,EAAE,WAAW,EAAE,kBAAkB;AAExC,OAAO,EAAE,UAAU,EAAE,0BAAsB;AAC3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,0BAAsB;AACvD,OAAO,KAAK,EACV,qCAAqC,EACrC,yBAAyB,EACzB,yBAAyB,EACzB,YAAY,EACb,qBAAiB;AAoBlB;;;;;GAKG;AACH,qBAAa,eAAe;;IA8C1B;;;;;;OAMG;gBAED,wBAAwB,EAAE,CAAC,iBAAiB,EAAE,GAAG,iBAAiB,EAAE,CAAC;IAkDvE;;;;;;;;OAQG;IACH,cAAc,CACZ,QAAQ,EAAE,qCAAqC,CAC7C,UAAU,CAAC,SAAS,CAAC,EACrB;QAAE,kBAAkB,EAAE,MAAM,CAAA;KAAE,CAC/B,GACA;QAAE,OAAO,IAAI,IAAI,CAAA;KAAE;IAiBtB;;;;;;;;;;;;;OAaG;IACH,OAAO,CACL,QAAQ,EAAE,CACR,IAAI,EAAE,yBAAyB,CAC7B,yBAAyB,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,EAChD,aAAa,CACd,KACE,IAAI,GACR,WAAW;IAId;;;;;;;;;OASG;IACH,cAAc,CACZ,QAAQ,EAAE,qCAAqC,CAC7C,UAAU,CAAC,SAAS,CAAC,EACrB;QAAE,kBAAkB,EAAE,MAAM,CAAA;KAAE,CAC/B,GACA,WAAW;IAiBd;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,UAAU,CACR,QAAQ,EAAE,CACR,IAAI,EAAE,yBAAyB,CAC7B,yBAAyB,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,EACnD,aAAa,CACd,KACE,IAAI,GACR,WAAW;IAId;;;;;;;;;;;;;;;;;;;OAmBG;IACH,iBAAiB,CACf,QAAQ,EAAE,qCAAqC,CAC7C,UAAU,CAAC,YAAY,CAAC,EACxB;QAAE,kBAAkB,EAAE,MAAM,CAAA;KAAE,CAC/B,GACA,WAAW;IAiBd;;;;;;;;;;;;;;;OAeG;IACH,WAAW,CACT,QAAQ,EAAE,CACR,IAAI,EAAE,yBAAyB,CAC7B,yBAAyB,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,EACpD,aAAa,CACd,KACE,IAAI,GACR,WAAW;IAId;;;;;;;;;;;;;;;;;OAiBG;IACG,OAAO,CAAC,MAAM,SAAS,aAAa,EAAE,MAAM,SAAS,IAAI,EAC7D,cAAc,EAAE,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,GAAG;QACjD,MAAM,EAAE,sBAAsB,CAAC;KAChC,EACD,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAE3D;;;;;;;;;;;;;;;;;OAiBG;IACG,OAAO,CAAC,MAAM,SAAS,aAAa,EAAE,MAAM,SAAS,IAAI,EAC7D,cAAc,EAAE,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,EAChD,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;CA8FpC"}
+{"version":3,"file":"rpc-service-chain.d.cts","sourceRoot":"","sources":["../../src/rpc-service/rpc-service-chain.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,IAAI,EACJ,aAAa,EACb,cAAc,EACd,eAAe,EAChB,wBAAwB;AACzB,OAAO,EAAE,WAAW,EAAE,kBAAkB;AAGxC,OAAO,EAAE,UAAU,EAAE,0BAAsB;AAC3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,0BAAsB;AACvD,OAAO,KAAK,EACV,qCAAqC,EACrC,yBAAyB,EACzB,yBAAyB,EACzB,YAAY,EACb,qBAAiB;AAmBlB;;;;;GAKG;AACH,qBAAa,eAAe;;IA8C1B;;;;;;OAMG;gBAED,wBAAwB,EAAE,CAAC,iBAAiB,EAAE,GAAG,iBAAiB,EAAE,CAAC;IAkDvE;;;;;;;;OAQG;IACH,cAAc,CACZ,QAAQ,EAAE,qCAAqC,CAC7C,UAAU,CAAC,SAAS,CAAC,EACrB;QAAE,kBAAkB,EAAE,MAAM,CAAA;KAAE,CAC/B,GACA;QAAE,OAAO,IAAI,IAAI,CAAA;KAAE;IAiBtB;;;;;;;;;;;;;OAaG;IACH,OAAO,CACL,QAAQ,EAAE,CACR,IAAI,EAAE,yBAAyB,CAC7B,yBAAyB,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,EAChD,aAAa,CACd,KACE,IAAI,GACR,WAAW;IAId;;;;;;;;;OASG;IACH,cAAc,CACZ,QAAQ,EAAE,qCAAqC,CAC7C,UAAU,CAAC,SAAS,CAAC,EACrB;QAAE,kBAAkB,EAAE,MAAM,CAAA;KAAE,CAC/B,GACA,WAAW;IAiBd;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,UAAU,CACR,QAAQ,EAAE,CACR,IAAI,EAAE,yBAAyB,CAC7B,yBAAyB,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,EACnD,aAAa,CACd,KACE,IAAI,GACR,WAAW;IAId;;;;;;;;;;;;;;;;;;;OAmBG;IACH,iBAAiB,CACf,QAAQ,EAAE,qCAAqC,CAC7C,UAAU,CAAC,YAAY,CAAC,EACxB;QAAE,kBAAkB,EAAE,MAAM,CAAA;KAAE,CAC/B,GACA,WAAW;IAiBd;;;;;;;;;;;;;;;OAeG;IACH,WAAW,CACT,QAAQ,EAAE,CACR,IAAI,EAAE,yBAAyB,CAC7B,yBAAyB,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,EACpD,aAAa,CACd,KACE,IAAI,GACR,WAAW;IAId;;;;;;;;;;;;;;;;;OAiBG;IACG,OAAO,CAAC,MAAM,SAAS,aAAa,EAAE,MAAM,SAAS,IAAI,EAC7D,cAAc,EAAE,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,GAAG;QACjD,MAAM,EAAE,sBAAsB,CAAC;KAChC,EACD,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAE3D;;;;;;;;;;;;;;;;;OAiBG;IACG,OAAO,CAAC,MAAM,SAAS,aAAa,EAAE,MAAM,SAAS,IAAI,EAC7D,cAAc,EAAE,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,EAChD,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;CA8FpC"}

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

@@ -1 +1 @@
-{"version":3,"file":"rpc-service-chain.d.mts","sourceRoot":"","sources":["../../src/rpc-service/rpc-service-chain.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,IAAI,EACJ,aAAa,EACb,cAAc,EACd,eAAe,EAChB,wBAAwB;AACzB,OAAO,EAAE,WAAW,EAAE,kBAAkB;AAExC,OAAO,EAAE,UAAU,EAAE,0BAAsB;AAC3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,0BAAsB;AACvD,OAAO,KAAK,EACV,qCAAqC,EACrC,yBAAyB,EACzB,yBAAyB,EACzB,YAAY,EACb,qBAAiB;AAoBlB;;;;;GAKG;AACH,qBAAa,eAAe;;IA8C1B;;;;;;OAMG;gBAED,wBAAwB,EAAE,CAAC,iBAAiB,EAAE,GAAG,iBAAiB,EAAE,CAAC;IAkDvE;;;;;;;;OAQG;IACH,cAAc,CACZ,QAAQ,EAAE,qCAAqC,CAC7C,UAAU,CAAC,SAAS,CAAC,EACrB;QAAE,kBAAkB,EAAE,MAAM,CAAA;KAAE,CAC/B,GACA;QAAE,OAAO,IAAI,IAAI,CAAA;KAAE;IAiBtB;;;;;;;;;;;;;OAaG;IACH,OAAO,CACL,QAAQ,EAAE,CACR,IAAI,EAAE,yBAAyB,CAC7B,yBAAyB,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,EAChD,aAAa,CACd,KACE,IAAI,GACR,WAAW;IAId;;;;;;;;;OASG;IACH,cAAc,CACZ,QAAQ,EAAE,qCAAqC,CAC7C,UAAU,CAAC,SAAS,CAAC,EACrB;QAAE,kBAAkB,EAAE,MAAM,CAAA;KAAE,CAC/B,GACA,WAAW;IAiBd;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,UAAU,CACR,QAAQ,EAAE,CACR,IAAI,EAAE,yBAAyB,CAC7B,yBAAyB,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,EACnD,aAAa,CACd,KACE,IAAI,GACR,WAAW;IAId;;;;;;;;;;;;;;;;;;;OAmBG;IACH,iBAAiB,CACf,QAAQ,EAAE,qCAAqC,CAC7C,UAAU,CAAC,YAAY,CAAC,EACxB;QAAE,kBAAkB,EAAE,MAAM,CAAA;KAAE,CAC/B,GACA,WAAW;IAiBd;;;;;;;;;;;;;;;OAeG;IACH,WAAW,CACT,QAAQ,EAAE,CACR,IAAI,EAAE,yBAAyB,CAC7B,yBAAyB,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,EACpD,aAAa,CACd,KACE,IAAI,GACR,WAAW;IAId;;;;;;;;;;;;;;;;;OAiBG;IACG,OAAO,CAAC,MAAM,SAAS,aAAa,EAAE,MAAM,SAAS,IAAI,EAC7D,cAAc,EAAE,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,GAAG;QACjD,MAAM,EAAE,sBAAsB,CAAC;KAChC,EACD,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAE3D;;;;;;;;;;;;;;;;;OAiBG;IACG,OAAO,CAAC,MAAM,SAAS,aAAa,EAAE,MAAM,SAAS,IAAI,EAC7D,cAAc,EAAE,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,EAChD,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;CA8FpC"}
+{"version":3,"file":"rpc-service-chain.d.mts","sourceRoot":"","sources":["../../src/rpc-service/rpc-service-chain.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,IAAI,EACJ,aAAa,EACb,cAAc,EACd,eAAe,EAChB,wBAAwB;AACzB,OAAO,EAAE,WAAW,EAAE,kBAAkB;AAGxC,OAAO,EAAE,UAAU,EAAE,0BAAsB;AAC3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,0BAAsB;AACvD,OAAO,KAAK,EACV,qCAAqC,EACrC,yBAAyB,EACzB,yBAAyB,EACzB,YAAY,EACb,qBAAiB;AAmBlB;;;;;GAKG;AACH,qBAAa,eAAe;;IA8C1B;;;;;;OAMG;gBAED,wBAAwB,EAAE,CAAC,iBAAiB,EAAE,GAAG,iBAAiB,EAAE,CAAC;IAkDvE;;;;;;;;OAQG;IACH,cAAc,CACZ,QAAQ,EAAE,qCAAqC,CAC7C,UAAU,CAAC,SAAS,CAAC,EACrB;QAAE,kBAAkB,EAAE,MAAM,CAAA;KAAE,CAC/B,GACA;QAAE,OAAO,IAAI,IAAI,CAAA;KAAE;IAiBtB;;;;;;;;;;;;;OAaG;IACH,OAAO,CACL,QAAQ,EAAE,CACR,IAAI,EAAE,yBAAyB,CAC7B,yBAAyB,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,EAChD,aAAa,CACd,KACE,IAAI,GACR,WAAW;IAId;;;;;;;;;OASG;IACH,cAAc,CACZ,QAAQ,EAAE,qCAAqC,CAC7C,UAAU,CAAC,SAAS,CAAC,EACrB;QAAE,kBAAkB,EAAE,MAAM,CAAA;KAAE,CAC/B,GACA,WAAW;IAiBd;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,UAAU,CACR,QAAQ,EAAE,CACR,IAAI,EAAE,yBAAyB,CAC7B,yBAAyB,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,EACnD,aAAa,CACd,KACE,IAAI,GACR,WAAW;IAId;;;;;;;;;;;;;;;;;;;OAmBG;IACH,iBAAiB,CACf,QAAQ,EAAE,qCAAqC,CAC7C,UAAU,CAAC,YAAY,CAAC,EACxB;QAAE,kBAAkB,EAAE,MAAM,CAAA;KAAE,CAC/B,GACA,WAAW;IAiBd;;;;;;;;;;;;;;;OAeG;IACH,WAAW,CACT,QAAQ,EAAE,CACR,IAAI,EAAE,yBAAyB,CAC7B,yBAAyB,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,EACpD,aAAa,CACd,KACE,IAAI,GACR,WAAW;IAId;;;;;;;;;;;;;;;;;OAiBG;IACG,OAAO,CAAC,MAAM,SAAS,aAAa,EAAE,MAAM,SAAS,IAAI,EAC7D,cAAc,EAAE,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,GAAG;QACjD,MAAM,EAAE,sBAAsB,CAAC;KAChC,EACD,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAE3D;;;;;;;;;;;;;;;;;OAiBG;IACG,OAAO,CAAC,MAAM,SAAS,aAAa,EAAE,MAAM,SAAS,IAAI,EAC7D,cAAc,EAAE,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,EAChD,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;CA8FpC"}

package/dist/rpc-service/rpc-service-chain.mjs

@@ -11,8 +11,8 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 };
 var _RpcServiceChain_onAvailableEventEmitter, _RpcServiceChain_onBreakEventEmitter, _RpcServiceChain_onDegradedEventEmitter, _RpcServiceChain_primaryService, _RpcServiceChain_services, _RpcServiceChain_status;
 import { CircuitState, CockatielEventEmitter } from "@metamask/controller-utils";
-import { RpcService } from "./rpc-service.mjs";
 import { projectLogger, createModuleLogger } from "../logger.mjs";
+import { RpcService } from "./rpc-service.mjs";
 const log = createModuleLogger(projectLogger, 'RpcServiceChain');
 /**
  * Statuses that the RPC service chain can be in.

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

@@ -1 +1 @@
-{"version":3,"file":"rpc-service-chain.mjs","sourceRoot":"","sources":["../../src/rpc-service/rpc-service-chain.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  CircuitState,\n  CockatielEventEmitter,\n} from '@metamask/controller-utils';\nimport type {\n  Json,\n  JsonRpcParams,\n  JsonRpcRequest,\n  JsonRpcResponse,\n} from '@metamask/utils';\nimport { IDisposable } from 'cockatiel';\n\nimport { RpcService } from './rpc-service';\nimport type { RpcServiceOptions } from './rpc-service';\nimport type {\n  CockatielEventToEventListenerWithData,\n  ExcludeCockatielEventData,\n  ExtractCockatielEventData,\n  FetchOptions,\n} from './shared';\nimport { projectLogger, createModuleLogger } from '../logger';\n\nconst log = createModuleLogger(projectLogger, 'RpcServiceChain');\n\n/**\n * Statuses that the RPC service chain can be in.\n */\nconst STATUSES = {\n  Available: 'available',\n  Degraded: 'degraded',\n  Unknown: 'unknown',\n  Unavailable: 'unavailable',\n} as const;\n\n/**\n * Statuses that the RPC service chain can be in.\n */\ntype Status = (typeof STATUSES)[keyof typeof STATUSES];\n\n/**\n * This class constructs and manages requests to a chain of RpcService objects\n * which represent RPC endpoints with which to access a particular network. The\n * first service in the chain is intended to be the primary way of hitting the\n * network and the remaining services are used as failovers.\n */\nexport class RpcServiceChain {\n  /**\n   * The event emitter for the `onAvailable` event.\n   */\n  readonly #onAvailableEventEmitter: CockatielEventEmitter<\n    ExcludeCockatielEventData<\n      ExtractCockatielEventData<RpcService['onAvailable']>,\n      'endpointUrl'\n    >\n  >;\n\n  /**\n   * The event emitter for the `onBreak` event.\n   */\n  readonly #onBreakEventEmitter: CockatielEventEmitter<\n    ExcludeCockatielEventData<\n      ExtractCockatielEventData<RpcService['onBreak']>,\n      'endpointUrl'\n    >\n  >;\n\n  /**\n   * The event emitter for the `onDegraded` event.\n   */\n  readonly #onDegradedEventEmitter: CockatielEventEmitter<\n    ExcludeCockatielEventData<\n      ExtractCockatielEventData<RpcService['onDegraded']>,\n      'endpointUrl'\n    >\n  >;\n\n  /**\n   * The first RPC service that requests will be sent to.\n   */\n  readonly #primaryService: RpcService;\n\n  /**\n   * The RPC services in the chain.\n   */\n  readonly #services: RpcService[];\n\n  /**\n   * The status of the RPC service chain.\n   */\n  #status: Status;\n\n  /**\n   * Constructs a new RpcServiceChain object.\n   *\n   * @param rpcServiceConfigurations - The options for the RPC services\n   * that you want to construct. Each object in this array is the same as\n   * {@link RpcServiceOptions}.\n   */\n  constructor(\n    rpcServiceConfigurations: [RpcServiceOptions, ...RpcServiceOptions[]],\n  ) {\n    this.#services = rpcServiceConfigurations.map(\n      (rpcServiceConfiguration) => new RpcService(rpcServiceConfiguration),\n    );\n    this.#primaryService = this.#services[0];\n\n    this.#status = STATUSES.Unknown;\n    this.#onBreakEventEmitter = new CockatielEventEmitter<\n      ExcludeCockatielEventData<\n        ExtractCockatielEventData<RpcService['onBreak']>,\n        'endpointUrl'\n      >\n    >();\n\n    this.#onDegradedEventEmitter = new CockatielEventEmitter<\n      ExcludeCockatielEventData<\n        ExtractCockatielEventData<RpcService['onDegraded']>,\n        'endpointUrl'\n      >\n    >();\n    for (const service of this.#services) {\n      service.onDegraded((data) => {\n        if (this.#status !== STATUSES.Degraded) {\n          log('Updating status to \"degraded\"', data);\n          this.#status = STATUSES.Degraded;\n          const { endpointUrl, ...rest } = data;\n          this.#onDegradedEventEmitter.emit(rest);\n        }\n      });\n    }\n\n    this.#onAvailableEventEmitter = new CockatielEventEmitter<\n      ExcludeCockatielEventData<\n        ExtractCockatielEventData<RpcService['onAvailable']>,\n        'endpointUrl'\n      >\n    >();\n    for (const service of this.#services) {\n      service.onAvailable((data) => {\n        if (this.#status !== STATUSES.Available) {\n          log('Updating status to \"available\"', data);\n          this.#status = STATUSES.Available;\n          const { endpointUrl, ...rest } = data;\n          this.#onAvailableEventEmitter.emit(rest);\n        }\n      });\n    }\n  }\n\n  /**\n   * Calls the provided callback when any of the RPC services is retried.\n   *\n   * This is mainly useful for tests.\n   *\n   * @param listener - The callback to be called.\n   * @returns An object with a `dispose` method which can be used to unregister\n   * the event listener.\n   */\n  onServiceRetry(\n    listener: CockatielEventToEventListenerWithData<\n      RpcService['onRetry'],\n      { primaryEndpointUrl: string }\n    >,\n  ): { dispose(): void } {\n    const disposables = this.#services.map((service) =>\n      service.onRetry((data) => {\n        listener({\n          ...data,\n          primaryEndpointUrl: this.#primaryService.endpointUrl.toString(),\n        });\n      }),\n    );\n\n    return {\n      dispose(): void {\n        disposables.forEach((disposable) => disposable.dispose());\n      },\n    };\n  }\n\n  /**\n   * Calls the provided callback only when the maximum number of failed\n   * consecutive attempts to receive a 2xx response has been reached for all\n   * RPC services in the chain, and all services' underlying circuits have\n   * broken.\n   *\n   * The callback will not be called if a service's circuit breaks but its\n   * failover does not. Use `onServiceBreak` if you'd like a lower level of\n   * granularity.\n   *\n   * @param listener - The callback to be called.\n   * @returns An object with a `dispose` method which can be used to unregister\n   * the callback.\n   */\n  onBreak(\n    listener: (\n      data: ExcludeCockatielEventData<\n        ExtractCockatielEventData<RpcService['onBreak']>,\n        'endpointUrl'\n      >,\n    ) => void,\n  ): IDisposable {\n    return this.#onBreakEventEmitter.addListener(listener);\n  }\n\n  /**\n   * Calls the provided callback each time when, for *any* of the RPC services\n   * in this chain, the maximum number of failed consecutive attempts to receive\n   * a 2xx response has been reached and the underlying circuit has broken. A\n   * more granular version of `onBreak`.\n   *\n   * @param listener - The callback to be called.\n   * @returns An object with a `dispose` method which can be used to unregister\n   * the callback.\n   */\n  onServiceBreak(\n    listener: CockatielEventToEventListenerWithData<\n      RpcService['onBreak'],\n      { primaryEndpointUrl: string }\n    >,\n  ): IDisposable {\n    const disposables = this.#services.map((service) =>\n      service.onBreak((data) => {\n        listener({\n          ...data,\n          primaryEndpointUrl: this.#primaryService.endpointUrl.toString(),\n        });\n      }),\n    );\n\n    return {\n      dispose(): void {\n        disposables.forEach((disposable) => disposable.dispose());\n      },\n    };\n  }\n\n  /**\n   * Calls the provided callback if no requests have been initiated yet or\n   * all requests to RPC services in this chain have responded successfully in a\n   * timely fashion, and then one of the two conditions apply:\n   *\n   * 1. When a retriable error is encountered making a request to an RPC\n   * service, and the request is retried until a set maximum is reached.\n   * 2. When a RPC service responds successfully, but the request takes longer\n   * than a set number of seconds to complete.\n   *\n   * Note that the callback will be called even if there are local connectivity\n   * issues which prevent requests from being initiated. This is intentional.\n   *\n   * Also note this callback will only be called if the RPC service chain as a\n   * whole is in a \"degraded\" state, and will then only be called once (e.g., it\n   * will not be called if a failover service falls into a degraded state, then\n   * the primary comes back online, but it is slow). Use `onServiceDegraded` if\n   * you'd like a lower level of granularity.\n   *\n   * @param listener - The callback to be called.\n   * @returns An object with a `dispose` method which can be used to unregister\n   * the callback.\n   */\n  onDegraded(\n    listener: (\n      data: ExcludeCockatielEventData<\n        ExtractCockatielEventData<RpcService['onDegraded']>,\n        'endpointUrl'\n      >,\n    ) => void,\n  ): IDisposable {\n    return this.#onDegradedEventEmitter.addListener(listener);\n  }\n\n  /**\n   * Calls the provided callback each time one of the two conditions apply:\n   *\n   * 1. When a retriable error is encountered making a request to an RPC\n   * service, and the request is retried until a set maximum is reached.\n   * 2. When a RPC service responds successfully, but the request takes longer\n   * than a set number of seconds to complete.\n   *\n   * Note that the callback will be called even if there are local connectivity\n   * issues which prevent requests from being initiated. This is intentional.\n   *\n   * This is a more granular version of `onDegraded`. The callback will be\n   * called for each slow request to an RPC service. It may also be called again\n   * if a failover service falls into a degraded state, then the primary comes\n   * back online, but it is slow.\n   *\n   * @param listener - The callback to be called.\n   * @returns An object with a `dispose` method which can be used to unregister\n   * the callback.\n   */\n  onServiceDegraded(\n    listener: CockatielEventToEventListenerWithData<\n      RpcService['onDegraded'],\n      { primaryEndpointUrl: string }\n    >,\n  ): IDisposable {\n    const disposables = this.#services.map((service) =>\n      service.onDegraded((data) => {\n        listener({\n          ...data,\n          primaryEndpointUrl: this.#primaryService.endpointUrl.toString(),\n        });\n      }),\n    );\n\n    return {\n      dispose(): void {\n        disposables.forEach((disposable) => disposable.dispose());\n      },\n    };\n  }\n\n  /**\n   * Calls the provided callback in one of the following two conditions:\n   *\n   * 1. The first time that a 2xx request is made to any of the RPC services in\n   * this chain.\n   * 2. When requests to any the failover RPC services in this chain were\n   * failing such that they were degraded or their underyling circuits broke,\n   * but the first request to the primary succeeds again.\n   *\n   * Note this callback will only be called if the RPC service chain as a whole\n   * is in an \"available\" state.\n   *\n   * @param listener - The callback to be called.\n   * @returns An object with a `dispose` method which can be used to unregister\n   * the callback.\n   */\n  onAvailable(\n    listener: (\n      data: ExcludeCockatielEventData<\n        ExtractCockatielEventData<RpcService['onAvailable']>,\n        'endpointUrl'\n      >,\n    ) => void,\n  ): IDisposable {\n    return this.#onAvailableEventEmitter.addListener(listener);\n  }\n\n  /**\n   * Uses the RPC services in the chain to make a request, using each service\n   * after the first as a fallback to the previous one as necessary.\n   *\n   * This overload is specifically designed for `eth_getBlockByNumber`, which\n   * can return a `result` of `null` despite an expected `Result` being\n   * provided.\n   *\n   * @param jsonRpcRequest - The JSON-RPC request to send to the endpoint.\n   * @param fetchOptions - An options bag for {@link fetch} which further\n   * specifies the request.\n   * @returns The decoded JSON-RPC response from the endpoint.\n   * @throws A 401 error if the response status is 401.\n   * @throws A \"rate limiting\" error if the response HTTP status is 429.\n   * @throws A \"resource unavailable\" error if the response status is 402, 404, or any 5xx.\n   * @throws A generic HTTP client error (-32100) for any other 4xx status codes.\n   * @throws A \"parse\" error if the response is not valid JSON.\n   */\n  async request<Params extends JsonRpcParams, Result extends Json>(\n    jsonRpcRequest: Readonly<JsonRpcRequest<Params>> & {\n      method: 'eth_getBlockByNumber';\n    },\n    fetchOptions?: FetchOptions,\n  ): Promise<JsonRpcResponse<Result> | JsonRpcResponse<null>>;\n\n  /**\n   * Uses the RPC services in the chain to make a request, using each service\n   * after the first as a fallback to the previous one as necessary.\n   *\n   * This overload is designed for all RPC methods except for\n   * `eth_getBlockByNumber`, which are expected to return a `result` of the\n   * expected `Result`.\n   *\n   * @param jsonRpcRequest - The JSON-RPC request to send to the endpoint.\n   * @param fetchOptions - An options bag for {@link fetch} which further\n   * specifies the request.\n   * @returns The decoded JSON-RPC response from the endpoint.\n   * @throws A 401 error if the response status is 401.\n   * @throws A \"rate limiting\" error if the response HTTP status is 429.\n   * @throws A \"resource unavailable\" error if the response status is 402, 404, or any 5xx.\n   * @throws A generic HTTP client error (-32100) for any other 4xx status codes.\n   * @throws A \"parse\" error if the response is not valid JSON.\n   */\n  async request<Params extends JsonRpcParams, Result extends Json>(\n    jsonRpcRequest: Readonly<JsonRpcRequest<Params>>,\n    fetchOptions?: FetchOptions,\n  ): Promise<JsonRpcResponse<Result>>;\n\n  async request<Params extends JsonRpcParams, Result extends Json>(\n    jsonRpcRequest: Readonly<JsonRpcRequest<Params>>,\n    fetchOptions: FetchOptions = {},\n  ): Promise<JsonRpcResponse<Result | null>> {\n    // Start with the primary (first) service and switch to failovers as the\n    // need arises. This is a bit confusing, so keep reading for more on how\n    // this works.\n\n    let availableServiceIndex: number | undefined;\n    let response: JsonRpcResponse<Result> | undefined;\n\n    for (const [i, service] of this.#services.entries()) {\n      log(`Trying service #${i + 1}...`);\n      const previousCircuitState = service.getCircuitState();\n\n      try {\n        // Try making the request through the service.\n        response = await service.request<Params, Result>(\n          jsonRpcRequest,\n          fetchOptions,\n        );\n        log('Service successfully received request.');\n        availableServiceIndex = i;\n        break;\n      } catch (error) {\n        // Oops, that didn't work.\n        // Capture this error so that we can handle it later.\n\n        const { lastError } = service;\n        const isCircuitOpen = service.getCircuitState() === CircuitState.Open;\n\n        log('Service failed! error =', error, 'lastError = ', lastError);\n\n        if (isCircuitOpen) {\n          if (i < this.#services.length - 1) {\n            log(\n              \"This service's circuit is open. Proceeding to next service...\",\n            );\n            continue;\n          }\n\n          if (\n            previousCircuitState !== CircuitState.Open &&\n            this.#status !== STATUSES.Unavailable &&\n            lastError !== undefined\n          ) {\n            // If the service's circuit just broke and it's the last one in the\n            // chain, then trigger the onBreak event. (But if for some reason we\n            // have already done this, then don't do it.)\n            log(\n              'This service\\'s circuit just opened and it is the last service. Updating status to \"unavailable\" and triggering onBreak.',\n            );\n            this.#status = STATUSES.Unavailable;\n            this.#onBreakEventEmitter.emit({\n              error: lastError,\n            });\n          }\n        }\n\n        // The service failed, and we throw whatever the error is. The calling\n        // code can try again if it so desires.\n        log(\n          `${isCircuitOpen ? '' : \"This service's circuit is closed. \"}Re-throwing error.`,\n        );\n        throw error;\n      }\n    }\n\n    if (response) {\n      // If one of the services is available, reset all of the circuits of the\n      // following services. If we didn't do this and the service became\n      // unavailable in the future, and any of the failovers' circuits were\n      // open (due to previous failures), we would receive a \"circuit broken\"\n      // error when we attempted to divert traffic to the failovers again.\n      //\n      if (availableServiceIndex !== undefined) {\n        for (const [i, service] of [...this.#services.entries()].slice(\n          availableServiceIndex + 1,\n        )) {\n          log(`Resetting policy for service #${i + 1}.`);\n          service.resetPolicy();\n        }\n      }\n\n      return response;\n    }\n\n    // The only way we can end up here is if there are no services to loop over.\n    // That is not possible due to the types on the constructor, but TypeScript\n    // doesn't know this, so we have to appease it.\n    throw new Error('Nothing to return');\n  }\n}\n"]}
+{"version":3,"file":"rpc-service-chain.mjs","sourceRoot":"","sources":["../../src/rpc-service/rpc-service-chain.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  CircuitState,\n  CockatielEventEmitter,\n} from '@metamask/controller-utils';\nimport type {\n  Json,\n  JsonRpcParams,\n  JsonRpcRequest,\n  JsonRpcResponse,\n} from '@metamask/utils';\nimport { IDisposable } from 'cockatiel';\n\nimport { projectLogger, createModuleLogger } from '../logger';\nimport { RpcService } from './rpc-service';\nimport type { RpcServiceOptions } from './rpc-service';\nimport type {\n  CockatielEventToEventListenerWithData,\n  ExcludeCockatielEventData,\n  ExtractCockatielEventData,\n  FetchOptions,\n} from './shared';\n\nconst log = createModuleLogger(projectLogger, 'RpcServiceChain');\n\n/**\n * Statuses that the RPC service chain can be in.\n */\nconst STATUSES = {\n  Available: 'available',\n  Degraded: 'degraded',\n  Unknown: 'unknown',\n  Unavailable: 'unavailable',\n} as const;\n\n/**\n * Statuses that the RPC service chain can be in.\n */\ntype Status = (typeof STATUSES)[keyof typeof STATUSES];\n\n/**\n * This class constructs and manages requests to a chain of RpcService objects\n * which represent RPC endpoints with which to access a particular network. The\n * first service in the chain is intended to be the primary way of hitting the\n * network and the remaining services are used as failovers.\n */\nexport class RpcServiceChain {\n  /**\n   * The event emitter for the `onAvailable` event.\n   */\n  readonly #onAvailableEventEmitter: CockatielEventEmitter<\n    ExcludeCockatielEventData<\n      ExtractCockatielEventData<RpcService['onAvailable']>,\n      'endpointUrl'\n    >\n  >;\n\n  /**\n   * The event emitter for the `onBreak` event.\n   */\n  readonly #onBreakEventEmitter: CockatielEventEmitter<\n    ExcludeCockatielEventData<\n      ExtractCockatielEventData<RpcService['onBreak']>,\n      'endpointUrl'\n    >\n  >;\n\n  /**\n   * The event emitter for the `onDegraded` event.\n   */\n  readonly #onDegradedEventEmitter: CockatielEventEmitter<\n    ExcludeCockatielEventData<\n      ExtractCockatielEventData<RpcService['onDegraded']>,\n      'endpointUrl'\n    >\n  >;\n\n  /**\n   * The first RPC service that requests will be sent to.\n   */\n  readonly #primaryService: RpcService;\n\n  /**\n   * The RPC services in the chain.\n   */\n  readonly #services: RpcService[];\n\n  /**\n   * The status of the RPC service chain.\n   */\n  #status: Status;\n\n  /**\n   * Constructs a new RpcServiceChain object.\n   *\n   * @param rpcServiceConfigurations - The options for the RPC services\n   * that you want to construct. Each object in this array is the same as\n   * {@link RpcServiceOptions}.\n   */\n  constructor(\n    rpcServiceConfigurations: [RpcServiceOptions, ...RpcServiceOptions[]],\n  ) {\n    this.#services = rpcServiceConfigurations.map(\n      (rpcServiceConfiguration) => new RpcService(rpcServiceConfiguration),\n    );\n    this.#primaryService = this.#services[0];\n\n    this.#status = STATUSES.Unknown;\n    this.#onBreakEventEmitter = new CockatielEventEmitter<\n      ExcludeCockatielEventData<\n        ExtractCockatielEventData<RpcService['onBreak']>,\n        'endpointUrl'\n      >\n    >();\n\n    this.#onDegradedEventEmitter = new CockatielEventEmitter<\n      ExcludeCockatielEventData<\n        ExtractCockatielEventData<RpcService['onDegraded']>,\n        'endpointUrl'\n      >\n    >();\n    for (const service of this.#services) {\n      service.onDegraded((data) => {\n        if (this.#status !== STATUSES.Degraded) {\n          log('Updating status to \"degraded\"', data);\n          this.#status = STATUSES.Degraded;\n          const { endpointUrl, ...rest } = data;\n          this.#onDegradedEventEmitter.emit(rest);\n        }\n      });\n    }\n\n    this.#onAvailableEventEmitter = new CockatielEventEmitter<\n      ExcludeCockatielEventData<\n        ExtractCockatielEventData<RpcService['onAvailable']>,\n        'endpointUrl'\n      >\n    >();\n    for (const service of this.#services) {\n      service.onAvailable((data) => {\n        if (this.#status !== STATUSES.Available) {\n          log('Updating status to \"available\"', data);\n          this.#status = STATUSES.Available;\n          const { endpointUrl, ...rest } = data;\n          this.#onAvailableEventEmitter.emit(rest);\n        }\n      });\n    }\n  }\n\n  /**\n   * Calls the provided callback when any of the RPC services is retried.\n   *\n   * This is mainly useful for tests.\n   *\n   * @param listener - The callback to be called.\n   * @returns An object with a `dispose` method which can be used to unregister\n   * the event listener.\n   */\n  onServiceRetry(\n    listener: CockatielEventToEventListenerWithData<\n      RpcService['onRetry'],\n      { primaryEndpointUrl: string }\n    >,\n  ): { dispose(): void } {\n    const disposables = this.#services.map((service) =>\n      service.onRetry((data) => {\n        listener({\n          ...data,\n          primaryEndpointUrl: this.#primaryService.endpointUrl.toString(),\n        });\n      }),\n    );\n\n    return {\n      dispose(): void {\n        disposables.forEach((disposable) => disposable.dispose());\n      },\n    };\n  }\n\n  /**\n   * Calls the provided callback only when the maximum number of failed\n   * consecutive attempts to receive a 2xx response has been reached for all\n   * RPC services in the chain, and all services' underlying circuits have\n   * broken.\n   *\n   * The callback will not be called if a service's circuit breaks but its\n   * failover does not. Use `onServiceBreak` if you'd like a lower level of\n   * granularity.\n   *\n   * @param listener - The callback to be called.\n   * @returns An object with a `dispose` method which can be used to unregister\n   * the callback.\n   */\n  onBreak(\n    listener: (\n      data: ExcludeCockatielEventData<\n        ExtractCockatielEventData<RpcService['onBreak']>,\n        'endpointUrl'\n      >,\n    ) => void,\n  ): IDisposable {\n    return this.#onBreakEventEmitter.addListener(listener);\n  }\n\n  /**\n   * Calls the provided callback each time when, for *any* of the RPC services\n   * in this chain, the maximum number of failed consecutive attempts to receive\n   * a 2xx response has been reached and the underlying circuit has broken. A\n   * more granular version of `onBreak`.\n   *\n   * @param listener - The callback to be called.\n   * @returns An object with a `dispose` method which can be used to unregister\n   * the callback.\n   */\n  onServiceBreak(\n    listener: CockatielEventToEventListenerWithData<\n      RpcService['onBreak'],\n      { primaryEndpointUrl: string }\n    >,\n  ): IDisposable {\n    const disposables = this.#services.map((service) =>\n      service.onBreak((data) => {\n        listener({\n          ...data,\n          primaryEndpointUrl: this.#primaryService.endpointUrl.toString(),\n        });\n      }),\n    );\n\n    return {\n      dispose(): void {\n        disposables.forEach((disposable) => disposable.dispose());\n      },\n    };\n  }\n\n  /**\n   * Calls the provided callback if no requests have been initiated yet or\n   * all requests to RPC services in this chain have responded successfully in a\n   * timely fashion, and then one of the two conditions apply:\n   *\n   * 1. When a retriable error is encountered making a request to an RPC\n   * service, and the request is retried until a set maximum is reached.\n   * 2. When a RPC service responds successfully, but the request takes longer\n   * than a set number of seconds to complete.\n   *\n   * Note that the callback will be called even if there are local connectivity\n   * issues which prevent requests from being initiated. This is intentional.\n   *\n   * Also note this callback will only be called if the RPC service chain as a\n   * whole is in a \"degraded\" state, and will then only be called once (e.g., it\n   * will not be called if a failover service falls into a degraded state, then\n   * the primary comes back online, but it is slow). Use `onServiceDegraded` if\n   * you'd like a lower level of granularity.\n   *\n   * @param listener - The callback to be called.\n   * @returns An object with a `dispose` method which can be used to unregister\n   * the callback.\n   */\n  onDegraded(\n    listener: (\n      data: ExcludeCockatielEventData<\n        ExtractCockatielEventData<RpcService['onDegraded']>,\n        'endpointUrl'\n      >,\n    ) => void,\n  ): IDisposable {\n    return this.#onDegradedEventEmitter.addListener(listener);\n  }\n\n  /**\n   * Calls the provided callback each time one of the two conditions apply:\n   *\n   * 1. When a retriable error is encountered making a request to an RPC\n   * service, and the request is retried until a set maximum is reached.\n   * 2. When a RPC service responds successfully, but the request takes longer\n   * than a set number of seconds to complete.\n   *\n   * Note that the callback will be called even if there are local connectivity\n   * issues which prevent requests from being initiated. This is intentional.\n   *\n   * This is a more granular version of `onDegraded`. The callback will be\n   * called for each slow request to an RPC service. It may also be called again\n   * if a failover service falls into a degraded state, then the primary comes\n   * back online, but it is slow.\n   *\n   * @param listener - The callback to be called.\n   * @returns An object with a `dispose` method which can be used to unregister\n   * the callback.\n   */\n  onServiceDegraded(\n    listener: CockatielEventToEventListenerWithData<\n      RpcService['onDegraded'],\n      { primaryEndpointUrl: string }\n    >,\n  ): IDisposable {\n    const disposables = this.#services.map((service) =>\n      service.onDegraded((data) => {\n        listener({\n          ...data,\n          primaryEndpointUrl: this.#primaryService.endpointUrl.toString(),\n        });\n      }),\n    );\n\n    return {\n      dispose(): void {\n        disposables.forEach((disposable) => disposable.dispose());\n      },\n    };\n  }\n\n  /**\n   * Calls the provided callback in one of the following two conditions:\n   *\n   * 1. The first time that a 2xx request is made to any of the RPC services in\n   * this chain.\n   * 2. When requests to any the failover RPC services in this chain were\n   * failing such that they were degraded or their underyling circuits broke,\n   * but the first request to the primary succeeds again.\n   *\n   * Note this callback will only be called if the RPC service chain as a whole\n   * is in an \"available\" state.\n   *\n   * @param listener - The callback to be called.\n   * @returns An object with a `dispose` method which can be used to unregister\n   * the callback.\n   */\n  onAvailable(\n    listener: (\n      data: ExcludeCockatielEventData<\n        ExtractCockatielEventData<RpcService['onAvailable']>,\n        'endpointUrl'\n      >,\n    ) => void,\n  ): IDisposable {\n    return this.#onAvailableEventEmitter.addListener(listener);\n  }\n\n  /**\n   * Uses the RPC services in the chain to make a request, using each service\n   * after the first as a fallback to the previous one as necessary.\n   *\n   * This overload is specifically designed for `eth_getBlockByNumber`, which\n   * can return a `result` of `null` despite an expected `Result` being\n   * provided.\n   *\n   * @param jsonRpcRequest - The JSON-RPC request to send to the endpoint.\n   * @param fetchOptions - An options bag for {@link fetch} which further\n   * specifies the request.\n   * @returns The decoded JSON-RPC response from the endpoint.\n   * @throws A 401 error if the response status is 401.\n   * @throws A \"rate limiting\" error if the response HTTP status is 429.\n   * @throws A \"resource unavailable\" error if the response status is 402, 404, or any 5xx.\n   * @throws A generic HTTP client error (-32100) for any other 4xx status codes.\n   * @throws A \"parse\" error if the response is not valid JSON.\n   */\n  async request<Params extends JsonRpcParams, Result extends Json>(\n    jsonRpcRequest: Readonly<JsonRpcRequest<Params>> & {\n      method: 'eth_getBlockByNumber';\n    },\n    fetchOptions?: FetchOptions,\n  ): Promise<JsonRpcResponse<Result> | JsonRpcResponse<null>>;\n\n  /**\n   * Uses the RPC services in the chain to make a request, using each service\n   * after the first as a fallback to the previous one as necessary.\n   *\n   * This overload is designed for all RPC methods except for\n   * `eth_getBlockByNumber`, which are expected to return a `result` of the\n   * expected `Result`.\n   *\n   * @param jsonRpcRequest - The JSON-RPC request to send to the endpoint.\n   * @param fetchOptions - An options bag for {@link fetch} which further\n   * specifies the request.\n   * @returns The decoded JSON-RPC response from the endpoint.\n   * @throws A 401 error if the response status is 401.\n   * @throws A \"rate limiting\" error if the response HTTP status is 429.\n   * @throws A \"resource unavailable\" error if the response status is 402, 404, or any 5xx.\n   * @throws A generic HTTP client error (-32100) for any other 4xx status codes.\n   * @throws A \"parse\" error if the response is not valid JSON.\n   */\n  async request<Params extends JsonRpcParams, Result extends Json>(\n    jsonRpcRequest: Readonly<JsonRpcRequest<Params>>,\n    fetchOptions?: FetchOptions,\n  ): Promise<JsonRpcResponse<Result>>;\n\n  async request<Params extends JsonRpcParams, Result extends Json>(\n    jsonRpcRequest: Readonly<JsonRpcRequest<Params>>,\n    fetchOptions: FetchOptions = {},\n  ): Promise<JsonRpcResponse<Result | null>> {\n    // Start with the primary (first) service and switch to failovers as the\n    // need arises. This is a bit confusing, so keep reading for more on how\n    // this works.\n\n    let availableServiceIndex: number | undefined;\n    let response: JsonRpcResponse<Result> | undefined;\n\n    for (const [i, service] of this.#services.entries()) {\n      log(`Trying service #${i + 1}...`);\n      const previousCircuitState = service.getCircuitState();\n\n      try {\n        // Try making the request through the service.\n        response = await service.request<Params, Result>(\n          jsonRpcRequest,\n          fetchOptions,\n        );\n        log('Service successfully received request.');\n        availableServiceIndex = i;\n        break;\n      } catch (error) {\n        // Oops, that didn't work.\n        // Capture this error so that we can handle it later.\n\n        const { lastError } = service;\n        const isCircuitOpen = service.getCircuitState() === CircuitState.Open;\n\n        log('Service failed! error =', error, 'lastError = ', lastError);\n\n        if (isCircuitOpen) {\n          if (i < this.#services.length - 1) {\n            log(\n              \"This service's circuit is open. Proceeding to next service...\",\n            );\n            continue;\n          }\n\n          if (\n            previousCircuitState !== CircuitState.Open &&\n            this.#status !== STATUSES.Unavailable &&\n            lastError !== undefined\n          ) {\n            // If the service's circuit just broke and it's the last one in the\n            // chain, then trigger the onBreak event. (But if for some reason we\n            // have already done this, then don't do it.)\n            log(\n              'This service\\'s circuit just opened and it is the last service. Updating status to \"unavailable\" and triggering onBreak.',\n            );\n            this.#status = STATUSES.Unavailable;\n            this.#onBreakEventEmitter.emit({\n              error: lastError,\n            });\n          }\n        }\n\n        // The service failed, and we throw whatever the error is. The calling\n        // code can try again if it so desires.\n        log(\n          `${isCircuitOpen ? '' : \"This service's circuit is closed. \"}Re-throwing error.`,\n        );\n        throw error;\n      }\n    }\n\n    if (response) {\n      // If one of the services is available, reset all of the circuits of the\n      // following services. If we didn't do this and the service became\n      // unavailable in the future, and any of the failovers' circuits were\n      // open (due to previous failures), we would receive a \"circuit broken\"\n      // error when we attempted to divert traffic to the failovers again.\n      //\n      if (availableServiceIndex !== undefined) {\n        for (const [i, service] of [...this.#services.entries()].slice(\n          availableServiceIndex + 1,\n        )) {\n          log(`Resetting policy for service #${i + 1}.`);\n          service.resetPolicy();\n        }\n      }\n\n      return response;\n    }\n\n    // The only way we can end up here is if there are no services to loop over.\n    // That is not possible due to the types on the constructor, but TypeScript\n    // doesn't know this, so we have to appease it.\n    throw new Error('Nothing to return');\n  }\n}\n"]}

package/dist/rpc-service/rpc-service-requestable.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"rpc-service-requestable.cjs","sourceRoot":"","sources":["../../src/rpc-service/rpc-service-requestable.ts"],"names":[],"mappings":"","sourcesContent":["import type { ServicePolicy } from '@metamask/controller-utils';\nimport type {\n  Json,\n  JsonRpcParams,\n  JsonRpcRequest,\n  JsonRpcResponse,\n} from '@metamask/utils';\n\nimport type {\n  CockatielEventToEventListenerWithData,\n  ExcludeCockatielEventData,\n  ExtendCockatielEventData,\n  ExtractCockatielEventData,\n  FetchOptions,\n} from './shared';\n\n/**\n * The interface for a service class responsible for making a request to a\n * target, whether that is a single RPC endpoint or an RPC endpoint in an RPC\n * service chain.\n */\nexport type RpcServiceRequestable = {\n  /**\n   * Listens for when the RPC service retries the request.\n   *\n   * @param listener - The callback to be called when the retry occurs.\n   * @returns What {@link ServicePolicy.onRetry} returns.\n   * @see {@link createServicePolicy}\n   */\n  onRetry(\n    listener: CockatielEventToEventListenerWithData<\n      ServicePolicy['onRetry'],\n      { endpointUrl: string }\n    >,\n  ): ReturnType<ServicePolicy['onRetry']>;\n\n  /**\n   * Listens for when the RPC service retries the request too many times in a\n   * row.\n   *\n   * @param listener - The callback to be called when the circuit is broken.\n   * @returns What {@link ServicePolicy.onBreak} returns.\n   * @see {@link createServicePolicy}\n   */\n  onBreak(\n    listener: (\n      data: ExcludeCockatielEventData<\n        ExtendCockatielEventData<\n          ExtractCockatielEventData<ServicePolicy['onBreak']>,\n          { endpointUrl: string }\n        >,\n        'isolated'\n      >,\n    ) => void,\n  ): ReturnType<ServicePolicy['onBreak']>;\n\n  /**\n   * Listens for when the policy underlying this RPC service detects a slow\n   * request.\n   *\n   * @param listener - The callback to be called when the request is slow.\n   * @returns What {@link ServicePolicy.onDegraded} returns.\n   * @see {@link createServicePolicy}\n   */\n  onDegraded(\n    listener: CockatielEventToEventListenerWithData<\n      ServicePolicy['onDegraded'],\n      { endpointUrl: string; rpcMethodName: string }\n    >,\n  ): ReturnType<ServicePolicy['onDegraded']>;\n\n  /**\n   * Listens for when the policy underlying this RPC service is available.\n   *\n   * @param listener - The callback to be called when the request is available.\n   * @returns What {@link ServicePolicy.onDegraded} returns.\n   * @see {@link createServicePolicy}\n   */\n  onAvailable(\n    listener: CockatielEventToEventListenerWithData<\n      ServicePolicy['onAvailable'],\n      { endpointUrl: string }\n    >,\n  ): ReturnType<ServicePolicy['onAvailable']>;\n\n  /**\n   * Makes a request to the target.\n   */\n  request<Params extends JsonRpcParams, Result extends Json>(\n    jsonRpcRequest: Readonly<JsonRpcRequest<Params>>,\n    fetchOptions?: FetchOptions,\n  ): Promise<JsonRpcResponse<Result | null>>;\n};\n"]}
+{"version":3,"file":"rpc-service-requestable.cjs","sourceRoot":"","sources":["../../src/rpc-service/rpc-service-requestable.ts"],"names":[],"mappings":"","sourcesContent":["import type { ServicePolicy } from '@metamask/controller-utils';\nimport type {\n  Json,\n  JsonRpcParams,\n  JsonRpcRequest,\n  JsonRpcResponse,\n} from '@metamask/utils';\n\nimport type {\n  CockatielEventToEventListenerWithData,\n  ExcludeCockatielEventData,\n  ExtendCockatielEventData,\n  ExtractCockatielEventData,\n  FetchOptions,\n} from './shared';\n\n/**\n * The interface for a service class responsible for making a request to a\n * target, whether that is a single RPC endpoint or an RPC endpoint in an RPC\n * service chain.\n *\n * @deprecated Don't use this interface (it will be removed in an upcoming major\n * version). If you need to take an \"RPC-service-like\" argument, it's best to\n * declare which properties you're interested in rather than accepting the\n * entire RPC service interface.\n */\nexport type RpcServiceRequestable = {\n  /**\n   * Listens for when the RPC service retries the request.\n   *\n   * @param listener - The callback to be called when the retry occurs.\n   * @returns What {@link ServicePolicy.onRetry} returns.\n   * @see {@link createServicePolicy}\n   */\n  onRetry(\n    listener: CockatielEventToEventListenerWithData<\n      ServicePolicy['onRetry'],\n      { endpointUrl: string }\n    >,\n  ): ReturnType<ServicePolicy['onRetry']>;\n\n  /**\n   * Listens for when the RPC service retries the request too many times in a\n   * row.\n   *\n   * @param listener - The callback to be called when the circuit is broken.\n   * @returns What {@link ServicePolicy.onBreak} returns.\n   * @see {@link createServicePolicy}\n   */\n  onBreak(\n    listener: (\n      data: ExcludeCockatielEventData<\n        ExtendCockatielEventData<\n          ExtractCockatielEventData<ServicePolicy['onBreak']>,\n          { endpointUrl: string }\n        >,\n        'isolated'\n      >,\n    ) => void,\n  ): ReturnType<ServicePolicy['onBreak']>;\n\n  /**\n   * Listens for when the policy underlying this RPC service detects a slow\n   * request.\n   *\n   * @param listener - The callback to be called when the request is slow.\n   * @returns What {@link ServicePolicy.onDegraded} returns.\n   * @see {@link createServicePolicy}\n   */\n  onDegraded(\n    listener: CockatielEventToEventListenerWithData<\n      ServicePolicy['onDegraded'],\n      { endpointUrl: string; rpcMethodName: string }\n    >,\n  ): ReturnType<ServicePolicy['onDegraded']>;\n\n  /**\n   * Listens for when the policy underlying this RPC service is available.\n   *\n   * @param listener - The callback to be called when the request is available.\n   * @returns What {@link ServicePolicy.onDegraded} returns.\n   * @see {@link createServicePolicy}\n   */\n  onAvailable(\n    listener: CockatielEventToEventListenerWithData<\n      ServicePolicy['onAvailable'],\n      { endpointUrl: string }\n    >,\n  ): ReturnType<ServicePolicy['onAvailable']>;\n\n  /**\n   * Makes a request to the target.\n   */\n  request<Params extends JsonRpcParams, Result extends Json>(\n    jsonRpcRequest: Readonly<JsonRpcRequest<Params>>,\n    fetchOptions?: FetchOptions,\n  ): Promise<JsonRpcResponse<Result | null>>;\n};\n"]}

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

@@ -5,6 +5,11 @@ import type { CockatielEventToEventListenerWithData, ExcludeCockatielEventData,
  * The interface for a service class responsible for making a request to a
  * target, whether that is a single RPC endpoint or an RPC endpoint in an RPC
  * service chain.
+ *
+ * @deprecated Don't use this interface (it will be removed in an upcoming major
+ * version). If you need to take an "RPC-service-like" argument, it's best to
+ * declare which properties you're interested in rather than accepting the
+ * entire RPC service interface.
  */
 export type RpcServiceRequestable = {
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"rpc-service-requestable.d.cts","sourceRoot":"","sources":["../../src/rpc-service/rpc-service-requestable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,mCAAmC;AAChE,OAAO,KAAK,EACV,IAAI,EACJ,aAAa,EACb,cAAc,EACd,eAAe,EAChB,wBAAwB;AAEzB,OAAO,KAAK,EACV,qCAAqC,EACrC,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,YAAY,EACb,qBAAiB;AAElB;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC;;;;;;OAMG;IACH,OAAO,CACL,QAAQ,EAAE,qCAAqC,CAC7C,aAAa,CAAC,SAAS,CAAC,EACxB;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CACxB,GACA,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC;IAExC;;;;;;;OAOG;IACH,OAAO,CACL,QAAQ,EAAE,CACR,IAAI,EAAE,yBAAyB,CAC7B,wBAAwB,CACtB,yBAAyB,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,EACnD;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CACxB,EACD,UAAU,CACX,KACE,IAAI,GACR,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC;IAExC;;;;;;;OAOG;IACH,UAAU,CACR,QAAQ,EAAE,qCAAqC,CAC7C,aAAa,CAAC,YAAY,CAAC,EAC3B;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAC/C,GACA,UAAU,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC;IAE3C;;;;;;OAMG;IACH,WAAW,CACT,QAAQ,EAAE,qCAAqC,CAC7C,aAAa,CAAC,aAAa,CAAC,EAC5B;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CACxB,GACA,UAAU,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC;IAE5C;;OAEG;IACH,OAAO,CAAC,MAAM,SAAS,aAAa,EAAE,MAAM,SAAS,IAAI,EACvD,cAAc,EAAE,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,EAChD,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,eAAe,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;CAC5C,CAAC"}
+{"version":3,"file":"rpc-service-requestable.d.cts","sourceRoot":"","sources":["../../src/rpc-service/rpc-service-requestable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,mCAAmC;AAChE,OAAO,KAAK,EACV,IAAI,EACJ,aAAa,EACb,cAAc,EACd,eAAe,EAChB,wBAAwB;AAEzB,OAAO,KAAK,EACV,qCAAqC,EACrC,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,YAAY,EACb,qBAAiB;AAElB;;;;;;;;;GASG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC;;;;;;OAMG;IACH,OAAO,CACL,QAAQ,EAAE,qCAAqC,CAC7C,aAAa,CAAC,SAAS,CAAC,EACxB;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CACxB,GACA,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC;IAExC;;;;;;;OAOG;IACH,OAAO,CACL,QAAQ,EAAE,CACR,IAAI,EAAE,yBAAyB,CAC7B,wBAAwB,CACtB,yBAAyB,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,EACnD;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CACxB,EACD,UAAU,CACX,KACE,IAAI,GACR,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC;IAExC;;;;;;;OAOG;IACH,UAAU,CACR,QAAQ,EAAE,qCAAqC,CAC7C,aAAa,CAAC,YAAY,CAAC,EAC3B;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAC/C,GACA,UAAU,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC;IAE3C;;;;;;OAMG;IACH,WAAW,CACT,QAAQ,EAAE,qCAAqC,CAC7C,aAAa,CAAC,aAAa,CAAC,EAC5B;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CACxB,GACA,UAAU,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC;IAE5C;;OAEG;IACH,OAAO,CAAC,MAAM,SAAS,aAAa,EAAE,MAAM,SAAS,IAAI,EACvD,cAAc,EAAE,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,EAChD,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,eAAe,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;CAC5C,CAAC"}

package/dist/rpc-service/rpc-service-requestable.d.mts

@@ -5,6 +5,11 @@ import type { CockatielEventToEventListenerWithData, ExcludeCockatielEventData,
  * The interface for a service class responsible for making a request to a
  * target, whether that is a single RPC endpoint or an RPC endpoint in an RPC
  * service chain.
+ *
+ * @deprecated Don't use this interface (it will be removed in an upcoming major
+ * version). If you need to take an "RPC-service-like" argument, it's best to
+ * declare which properties you're interested in rather than accepting the
+ * entire RPC service interface.
  */
 export type RpcServiceRequestable = {
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"rpc-service-requestable.d.mts","sourceRoot":"","sources":["../../src/rpc-service/rpc-service-requestable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,mCAAmC;AAChE,OAAO,KAAK,EACV,IAAI,EACJ,aAAa,EACb,cAAc,EACd,eAAe,EAChB,wBAAwB;AAEzB,OAAO,KAAK,EACV,qCAAqC,EACrC,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,YAAY,EACb,qBAAiB;AAElB;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC;;;;;;OAMG;IACH,OAAO,CACL,QAAQ,EAAE,qCAAqC,CAC7C,aAAa,CAAC,SAAS,CAAC,EACxB;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CACxB,GACA,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC;IAExC;;;;;;;OAOG;IACH,OAAO,CACL,QAAQ,EAAE,CACR,IAAI,EAAE,yBAAyB,CAC7B,wBAAwB,CACtB,yBAAyB,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,EACnD;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CACxB,EACD,UAAU,CACX,KACE,IAAI,GACR,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC;IAExC;;;;;;;OAOG;IACH,UAAU,CACR,QAAQ,EAAE,qCAAqC,CAC7C,aAAa,CAAC,YAAY,CAAC,EAC3B;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAC/C,GACA,UAAU,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC;IAE3C;;;;;;OAMG;IACH,WAAW,CACT,QAAQ,EAAE,qCAAqC,CAC7C,aAAa,CAAC,aAAa,CAAC,EAC5B;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CACxB,GACA,UAAU,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC;IAE5C;;OAEG;IACH,OAAO,CAAC,MAAM,SAAS,aAAa,EAAE,MAAM,SAAS,IAAI,EACvD,cAAc,EAAE,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,EAChD,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,eAAe,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;CAC5C,CAAC"}
+{"version":3,"file":"rpc-service-requestable.d.mts","sourceRoot":"","sources":["../../src/rpc-service/rpc-service-requestable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,mCAAmC;AAChE,OAAO,KAAK,EACV,IAAI,EACJ,aAAa,EACb,cAAc,EACd,eAAe,EAChB,wBAAwB;AAEzB,OAAO,KAAK,EACV,qCAAqC,EACrC,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,YAAY,EACb,qBAAiB;AAElB;;;;;;;;;GASG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC;;;;;;OAMG;IACH,OAAO,CACL,QAAQ,EAAE,qCAAqC,CAC7C,aAAa,CAAC,SAAS,CAAC,EACxB;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CACxB,GACA,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC;IAExC;;;;;;;OAOG;IACH,OAAO,CACL,QAAQ,EAAE,CACR,IAAI,EAAE,yBAAyB,CAC7B,wBAAwB,CACtB,yBAAyB,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,EACnD;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CACxB,EACD,UAAU,CACX,KACE,IAAI,GACR,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC;IAExC;;;;;;;OAOG;IACH,UAAU,CACR,QAAQ,EAAE,qCAAqC,CAC7C,aAAa,CAAC,YAAY,CAAC,EAC3B;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAC/C,GACA,UAAU,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC;IAE3C;;;;;;OAMG;IACH,WAAW,CACT,QAAQ,EAAE,qCAAqC,CAC7C,aAAa,CAAC,aAAa,CAAC,EAC5B;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CACxB,GACA,UAAU,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC;IAE5C;;OAEG;IACH,OAAO,CAAC,MAAM,SAAS,aAAa,EAAE,MAAM,SAAS,IAAI,EACvD,cAAc,EAAE,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,EAChD,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,eAAe,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;CAC5C,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"rpc-service-requestable.mjs","sourceRoot":"","sources":["../../src/rpc-service/rpc-service-requestable.ts"],"names":[],"mappings":"","sourcesContent":["import type { ServicePolicy } from '@metamask/controller-utils';\nimport type {\n  Json,\n  JsonRpcParams,\n  JsonRpcRequest,\n  JsonRpcResponse,\n} from '@metamask/utils';\n\nimport type {\n  CockatielEventToEventListenerWithData,\n  ExcludeCockatielEventData,\n  ExtendCockatielEventData,\n  ExtractCockatielEventData,\n  FetchOptions,\n} from './shared';\n\n/**\n * The interface for a service class responsible for making a request to a\n * target, whether that is a single RPC endpoint or an RPC endpoint in an RPC\n * service chain.\n */\nexport type RpcServiceRequestable = {\n  /**\n   * Listens for when the RPC service retries the request.\n   *\n   * @param listener - The callback to be called when the retry occurs.\n   * @returns What {@link ServicePolicy.onRetry} returns.\n   * @see {@link createServicePolicy}\n   */\n  onRetry(\n    listener: CockatielEventToEventListenerWithData<\n      ServicePolicy['onRetry'],\n      { endpointUrl: string }\n    >,\n  ): ReturnType<ServicePolicy['onRetry']>;\n\n  /**\n   * Listens for when the RPC service retries the request too many times in a\n   * row.\n   *\n   * @param listener - The callback to be called when the circuit is broken.\n   * @returns What {@link ServicePolicy.onBreak} returns.\n   * @see {@link createServicePolicy}\n   */\n  onBreak(\n    listener: (\n      data: ExcludeCockatielEventData<\n        ExtendCockatielEventData<\n          ExtractCockatielEventData<ServicePolicy['onBreak']>,\n          { endpointUrl: string }\n        >,\n        'isolated'\n      >,\n    ) => void,\n  ): ReturnType<ServicePolicy['onBreak']>;\n\n  /**\n   * Listens for when the policy underlying this RPC service detects a slow\n   * request.\n   *\n   * @param listener - The callback to be called when the request is slow.\n   * @returns What {@link ServicePolicy.onDegraded} returns.\n   * @see {@link createServicePolicy}\n   */\n  onDegraded(\n    listener: CockatielEventToEventListenerWithData<\n      ServicePolicy['onDegraded'],\n      { endpointUrl: string; rpcMethodName: string }\n    >,\n  ): ReturnType<ServicePolicy['onDegraded']>;\n\n  /**\n   * Listens for when the policy underlying this RPC service is available.\n   *\n   * @param listener - The callback to be called when the request is available.\n   * @returns What {@link ServicePolicy.onDegraded} returns.\n   * @see {@link createServicePolicy}\n   */\n  onAvailable(\n    listener: CockatielEventToEventListenerWithData<\n      ServicePolicy['onAvailable'],\n      { endpointUrl: string }\n    >,\n  ): ReturnType<ServicePolicy['onAvailable']>;\n\n  /**\n   * Makes a request to the target.\n   */\n  request<Params extends JsonRpcParams, Result extends Json>(\n    jsonRpcRequest: Readonly<JsonRpcRequest<Params>>,\n    fetchOptions?: FetchOptions,\n  ): Promise<JsonRpcResponse<Result | null>>;\n};\n"]}
+{"version":3,"file":"rpc-service-requestable.mjs","sourceRoot":"","sources":["../../src/rpc-service/rpc-service-requestable.ts"],"names":[],"mappings":"","sourcesContent":["import type { ServicePolicy } from '@metamask/controller-utils';\nimport type {\n  Json,\n  JsonRpcParams,\n  JsonRpcRequest,\n  JsonRpcResponse,\n} from '@metamask/utils';\n\nimport type {\n  CockatielEventToEventListenerWithData,\n  ExcludeCockatielEventData,\n  ExtendCockatielEventData,\n  ExtractCockatielEventData,\n  FetchOptions,\n} from './shared';\n\n/**\n * The interface for a service class responsible for making a request to a\n * target, whether that is a single RPC endpoint or an RPC endpoint in an RPC\n * service chain.\n *\n * @deprecated Don't use this interface (it will be removed in an upcoming major\n * version). If you need to take an \"RPC-service-like\" argument, it's best to\n * declare which properties you're interested in rather than accepting the\n * entire RPC service interface.\n */\nexport type RpcServiceRequestable = {\n  /**\n   * Listens for when the RPC service retries the request.\n   *\n   * @param listener - The callback to be called when the retry occurs.\n   * @returns What {@link ServicePolicy.onRetry} returns.\n   * @see {@link createServicePolicy}\n   */\n  onRetry(\n    listener: CockatielEventToEventListenerWithData<\n      ServicePolicy['onRetry'],\n      { endpointUrl: string }\n    >,\n  ): ReturnType<ServicePolicy['onRetry']>;\n\n  /**\n   * Listens for when the RPC service retries the request too many times in a\n   * row.\n   *\n   * @param listener - The callback to be called when the circuit is broken.\n   * @returns What {@link ServicePolicy.onBreak} returns.\n   * @see {@link createServicePolicy}\n   */\n  onBreak(\n    listener: (\n      data: ExcludeCockatielEventData<\n        ExtendCockatielEventData<\n          ExtractCockatielEventData<ServicePolicy['onBreak']>,\n          { endpointUrl: string }\n        >,\n        'isolated'\n      >,\n    ) => void,\n  ): ReturnType<ServicePolicy['onBreak']>;\n\n  /**\n   * Listens for when the policy underlying this RPC service detects a slow\n   * request.\n   *\n   * @param listener - The callback to be called when the request is slow.\n   * @returns What {@link ServicePolicy.onDegraded} returns.\n   * @see {@link createServicePolicy}\n   */\n  onDegraded(\n    listener: CockatielEventToEventListenerWithData<\n      ServicePolicy['onDegraded'],\n      { endpointUrl: string; rpcMethodName: string }\n    >,\n  ): ReturnType<ServicePolicy['onDegraded']>;\n\n  /**\n   * Listens for when the policy underlying this RPC service is available.\n   *\n   * @param listener - The callback to be called when the request is available.\n   * @returns What {@link ServicePolicy.onDegraded} returns.\n   * @see {@link createServicePolicy}\n   */\n  onAvailable(\n    listener: CockatielEventToEventListenerWithData<\n      ServicePolicy['onAvailable'],\n      { endpointUrl: string }\n    >,\n  ): ReturnType<ServicePolicy['onAvailable']>;\n\n  /**\n   * Makes a request to the target.\n   */\n  request<Params extends JsonRpcParams, Result extends Json>(\n    jsonRpcRequest: Readonly<JsonRpcRequest<Params>>,\n    fetchOptions?: FetchOptions,\n  ): Promise<JsonRpcResponse<Result | null>>;\n};\n"]}