@metamask-previews/network-controller 22.1.1-preview-ee77a6d9 → 22.1.1-preview-33c13522

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask-previews/network-controller",
-  "version": "22.1.1-preview-ee77a6d9",
+  "version": "22.1.1-preview-33c13522",
   "description": "Provides an interface to the currently selected network via a MetaMask-compatible provider object",
   "keywords": [
     "MetaMask",

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

@@ -1,109 +0,0 @@
-"use strict";
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var _RpcServiceChain_instances, _RpcServiceChain_services, _RpcServiceChain_buildRpcServiceChain;
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RpcServiceChain = void 0;
-const rpc_service_1 = require("./rpc-service.cjs");
-/**
- * This class constructs a chain of RpcService objects which represent a
- * particular network. The first object in the chain is intended to be the primary
- * way of reaching the network and the remaining objects are used as failovers.
- */
-class RpcServiceChain {
-    /**
-     * Constructs a new RpcServiceChain object.
-     *
-     * @param args - The arguments.
-     * @param args.fetch - A function that can be used to make an HTTP request.
-     * If your JavaScript environment supports `fetch` natively, you'll probably
-     * want to pass that; otherwise you can pass an equivalent (such as `fetch`
-     * via `node-fetch`).
-     * @param args.btoa - A function that can be used to convert a binary string
-     * into base-64. Used to encode authorization credentials.
-     * @param args.serviceConfigurations - The options for the RPC services that
-     * you want to construct. This class takes a set of configuration objects and
-     * not literal `RpcService`s to account for the possibility that we may want
-     * to send request headers to official Infura endpoints and not failovers.
-     */
-    constructor({ fetch: givenFetch, btoa: givenBtoa, serviceConfigurations, }) {
-        _RpcServiceChain_instances.add(this);
-        _RpcServiceChain_services.set(this, void 0);
-        __classPrivateFieldSet(this, _RpcServiceChain_services, __classPrivateFieldGet(this, _RpcServiceChain_instances, "m", _RpcServiceChain_buildRpcServiceChain).call(this, {
-            serviceConfigurations,
-            fetch: givenFetch,
-            btoa: givenBtoa,
-        }), "f");
-    }
-    /**
-     * Listens for when any of the RPC services retry a request.
-     *
-     * @param listener - The callback to be called when the retry occurs.
-     * @returns What {@link RpcService.onRetry} returns.
-     */
-    onRetry(listener) {
-        const disposables = __classPrivateFieldGet(this, _RpcServiceChain_services, "f").map((service) => service.onRetry(listener));
-        return {
-            dispose() {
-                disposables.forEach((disposable) => disposable.dispose());
-            },
-        };
-    }
-    /**
-     * Listens for when any of the RPC services retry the request too many times
-     * in a row.
-     *
-     * @param listener - The callback to be called when the retry occurs.
-     * @returns What {@link RpcService.onBreak} returns.
-     */
-    onBreak(listener) {
-        const disposables = __classPrivateFieldGet(this, _RpcServiceChain_services, "f").map((service) => service.onBreak(listener));
-        return {
-            dispose() {
-                disposables.forEach((disposable) => disposable.dispose());
-            },
-        };
-    }
-    /**
-     * Listens for when any of the RPC services send a slow request.
-     *
-     * @param listener - The callback to be called when the retry occurs.
-     * @returns What {@link RpcService.onRetry} returns.
-     */
-    onDegraded(listener) {
-        const disposables = __classPrivateFieldGet(this, _RpcServiceChain_services, "f").map((service) => service.onDegraded(listener));
-        return {
-            dispose() {
-                disposables.forEach((disposable) => disposable.dispose());
-            },
-        };
-    }
-    async request(jsonRpcRequest, fetchOptions = {}) {
-        return __classPrivateFieldGet(this, _RpcServiceChain_services, "f")[0].request(jsonRpcRequest, fetchOptions);
-    }
-}
-exports.RpcServiceChain = RpcServiceChain;
-_RpcServiceChain_services = new WeakMap(), _RpcServiceChain_instances = new WeakSet(), _RpcServiceChain_buildRpcServiceChain = function _RpcServiceChain_buildRpcServiceChain({ serviceConfigurations, fetch: givenFetch, btoa: givenBtoa, }) {
-    return [...serviceConfigurations]
-        .reverse()
-        .reduce((workingServices, serviceConfiguration, index) => {
-        const failoverService = index > 0 ? workingServices[0] : undefined;
-        const service = new rpc_service_1.RpcService({
-            fetch: givenFetch,
-            btoa: givenBtoa,
-            ...serviceConfiguration,
-            failoverService,
-        });
-        return [service, ...workingServices];
-    }, []);
-};
-//# sourceMappingURL=rpc-service-chain.cjs.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"rpc-service-chain.cjs","sourceRoot":"","sources":["../../src/rpc-service/rpc-service-chain.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAQA,mDAA2C;AAkB3C;;;;GAIG;AACH,MAAa,eAAe;IAG1B;;;;;;;;;;;;;;OAcG;IACH,YAAY,EACV,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,SAAS,EACf,qBAAqB,GAKtB;;QAzBQ,4CAAwB;QA0B/B,uBAAA,IAAI,6BAAa,uBAAA,IAAI,yEAAsB,MAA1B,IAAI,EAAuB;YAC1C,qBAAqB;YACrB,KAAK,EAAE,UAAU;YACjB,IAAI,EAAE,SAAS;SAChB,CAAC,MAAA,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,QAA8C;QACpD,MAAM,WAAW,GAAG,uBAAA,IAAI,iCAAU,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CACjD,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAC1B,CAAC;QAEF,OAAO;YACL,OAAO;gBACL,WAAW,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;YAC5D,CAAC;SACF,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,OAAO,CAAC,QAA8C;QACpD,MAAM,WAAW,GAAG,uBAAA,IAAI,iCAAU,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CACjD,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAC1B,CAAC;QAEF,OAAO;YACL,OAAO;gBACL,WAAW,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;YAC5D,CAAC;SACF,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,QAAiD;QAC1D,MAAM,WAAW,GAAG,uBAAA,IAAI,iCAAU,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CACjD,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAC7B,CAAC;QAEF,OAAO;YACL,OAAO;gBACL,WAAW,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;YAC5D,CAAC;SACF,CAAC;IACJ,CAAC;IAgDD,KAAK,CAAC,OAAO,CACX,cAAsC,EACtC,eAA6B,EAAE;QAE/B,OAAO,uBAAA,IAAI,iCAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;IACjE,CAAC;CAqCF;AAjLD,0CAiLC;8KAtBuB,EACpB,qBAAqB,EACrB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,SAAS,GAKhB;IACC,OAAO,CAAC,GAAG,qBAAqB,CAAC;SAC9B,OAAO,EAAE;SACT,MAAM,CAAC,CAAC,eAA6B,EAAE,oBAAoB,EAAE,KAAK,EAAE,EAAE;QACrE,MAAM,eAAe,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACnE,MAAM,OAAO,GAAG,IAAI,wBAAU,CAAC;YAC7B,KAAK,EAAE,UAAU;YACjB,IAAI,EAAE,SAAS;YACf,GAAG,oBAAoB;YACvB,eAAe;SAChB,CAAC,CAAC;QACH,OAAO,CAAC,OAAO,EAAE,GAAG,eAAe,CAAC,CAAC;IACvC,CAAC,EAAE,EAAE,CAAC,CAAC;AACX,CAAC","sourcesContent":["import type {\n  Json,\n  JsonRpcParams,\n  JsonRpcRequest,\n  JsonRpcResponse,\n} from '@metamask/utils';\n\nimport type { AbstractRpcService } from './abstract-rpc-service';\nimport { RpcService } from './rpc-service';\nimport type { FetchOptions } from './shared';\n\n/**\n * The subset of options accepted by the RpcServiceChain constructor which\n * represent a single endpoint.\n */\ntype RpcServiceConfiguration = {\n  /**\n   * The URL of the endpoint.\n   */\n  endpointUrl: URL | string;\n  /**\n   * The options to pass to `fetch` when making the request to the endpoint.\n   */\n  fetchOptions?: FetchOptions;\n};\n\n/**\n * This class constructs a chain of RpcService objects which represent a\n * particular network. The first object in the chain is intended to be the primary\n * way of reaching the network and the remaining objects are used as failovers.\n */\nexport class RpcServiceChain implements AbstractRpcService {\n  readonly #services: RpcService[];\n\n  /**\n   * Constructs a new RpcServiceChain object.\n   *\n   * @param args - The arguments.\n   * @param args.fetch - A function that can be used to make an HTTP request.\n   * If your JavaScript environment supports `fetch` natively, you'll probably\n   * want to pass that; otherwise you can pass an equivalent (such as `fetch`\n   * via `node-fetch`).\n   * @param args.btoa - A function that can be used to convert a binary string\n   * into base-64. Used to encode authorization credentials.\n   * @param args.serviceConfigurations - The options for the RPC services that\n   * you want to construct. This class takes a set of configuration objects and\n   * not literal `RpcService`s to account for the possibility that we may want\n   * to send request headers to official Infura endpoints and not failovers.\n   */\n  constructor({\n    fetch: givenFetch,\n    btoa: givenBtoa,\n    serviceConfigurations,\n  }: {\n    fetch: typeof fetch;\n    btoa: typeof btoa;\n    serviceConfigurations: RpcServiceConfiguration[];\n  }) {\n    this.#services = this.#buildRpcServiceChain({\n      serviceConfigurations,\n      fetch: givenFetch,\n      btoa: givenBtoa,\n    });\n  }\n\n  /**\n   * Listens for when any of the RPC services retry a request.\n   *\n   * @param listener - The callback to be called when the retry occurs.\n   * @returns What {@link RpcService.onRetry} returns.\n   */\n  onRetry(listener: Parameters<RpcService['onRetry']>[0]) {\n    const disposables = this.#services.map((service) =>\n      service.onRetry(listener),\n    );\n\n    return {\n      dispose() {\n        disposables.forEach((disposable) => disposable.dispose());\n      },\n    };\n  }\n\n  /**\n   * Listens for when any of the RPC services retry the request too many times\n   * in a row.\n   *\n   * @param listener - The callback to be called when the retry occurs.\n   * @returns What {@link RpcService.onBreak} returns.\n   */\n  onBreak(listener: Parameters<RpcService['onBreak']>[0]) {\n    const disposables = this.#services.map((service) =>\n      service.onBreak(listener),\n    );\n\n    return {\n      dispose() {\n        disposables.forEach((disposable) => disposable.dispose());\n      },\n    };\n  }\n\n  /**\n   * Listens for when any of the RPC services send a slow request.\n   *\n   * @param listener - The callback to be called when the retry occurs.\n   * @returns What {@link RpcService.onRetry} returns.\n   */\n  onDegraded(listener: Parameters<RpcService['onDegraded']>[0]) {\n    const disposables = this.#services.map((service) =>\n      service.onDegraded(listener),\n    );\n\n    return {\n      dispose() {\n        disposables.forEach((disposable) => disposable.dispose());\n      },\n    };\n  }\n\n  /**\n   * Makes a request to the first RPC service in the chain. If this service is\n   * down, then the request is forwarded to the next service in the chain, etc.\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 \"method not found\" error if the response status is 405.\n   * @throws A rate limiting error if the response HTTP status is 429.\n   * @throws A timeout error if the response HTTP status is 503 or 504.\n   * @throws A generic error if the response HTTP status is not 2xx but also not\n   * 405, 429, 503, or 504.\n   */\n  async request<Params extends JsonRpcParams, Result extends Json>(\n    jsonRpcRequest: JsonRpcRequest<Params> & { method: 'eth_getBlockByNumber' },\n    fetchOptions?: FetchOptions,\n  ): Promise<JsonRpcResponse<Result> | JsonRpcResponse<null>>;\n\n  /**\n   * Makes a request to the first RPC service in the chain. If this service is\n   * down, then the request is forwarded to the next service in the chain, etc.\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 \"method not found\" error if the response status is 405.\n   * @throws A rate limiting error if the response HTTP status is 429.\n   * @throws A timeout error if the response HTTP status is 503 or 504.\n   * @throws A generic error if the response HTTP status is not 2xx but also not\n   * 405, 429, 503, or 504.\n   */\n  async request<Params extends JsonRpcParams, Result extends Json>(\n    jsonRpcRequest: JsonRpcRequest<Params>,\n    fetchOptions?: FetchOptions,\n  ): Promise<JsonRpcResponse<Result>>;\n\n  async request<Params extends JsonRpcParams, Result extends Json>(\n    jsonRpcRequest: JsonRpcRequest<Params>,\n    fetchOptions: FetchOptions = {},\n  ): Promise<JsonRpcResponse<Result | null>> {\n    return this.#services[0].request(jsonRpcRequest, fetchOptions);\n  }\n\n  /**\n   * Constructs the chain of RPC services. The second RPC service is\n   * configured as the failover for the first, the third service is\n   * configured as the failover for the second, etc.\n   *\n   * @param args - The arguments.\n   * @param args.serviceConfigurations - The options for the RPC services that\n   * you want to construct.\n   * @param args.fetch - A function that can be used to make an HTTP request.\n   * @param args.btoa - A function that can be used to convert a binary string\n   * into base-64. Used to encode authorization credentials.\n   * @returns The constructed chain of RPC services.\n   */\n  #buildRpcServiceChain({\n    serviceConfigurations,\n    fetch: givenFetch,\n    btoa: givenBtoa,\n  }: {\n    serviceConfigurations: RpcServiceConfiguration[];\n    fetch: typeof fetch;\n    btoa: typeof btoa;\n  }): RpcService[] {\n    return [...serviceConfigurations]\n      .reverse()\n      .reduce((workingServices: RpcService[], serviceConfiguration, index) => {\n        const failoverService = index > 0 ? workingServices[0] : undefined;\n        const service = new RpcService({\n          fetch: givenFetch,\n          btoa: givenBtoa,\n          ...serviceConfiguration,\n          failoverService,\n        });\n        return [service, ...workingServices];\n      }, []);\n  }\n}\n"]}

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

@@ -1,116 +0,0 @@
-import type { Json, JsonRpcParams, JsonRpcRequest, JsonRpcResponse } from "@metamask/utils";
-import type { AbstractRpcService } from "./abstract-rpc-service.cjs";
-import { RpcService } from "./rpc-service.cjs";
-import type { FetchOptions } from "./shared.cjs";
-/**
- * The subset of options accepted by the RpcServiceChain constructor which
- * represent a single endpoint.
- */
-type RpcServiceConfiguration = {
-    /**
-     * The URL of the endpoint.
-     */
-    endpointUrl: URL | string;
-    /**
-     * The options to pass to `fetch` when making the request to the endpoint.
-     */
-    fetchOptions?: FetchOptions;
-};
-/**
- * This class constructs a chain of RpcService objects which represent a
- * particular network. The first object in the chain is intended to be the primary
- * way of reaching the network and the remaining objects are used as failovers.
- */
-export declare class RpcServiceChain implements AbstractRpcService {
-    #private;
-    /**
-     * Constructs a new RpcServiceChain object.
-     *
-     * @param args - The arguments.
-     * @param args.fetch - A function that can be used to make an HTTP request.
-     * If your JavaScript environment supports `fetch` natively, you'll probably
-     * want to pass that; otherwise you can pass an equivalent (such as `fetch`
-     * via `node-fetch`).
-     * @param args.btoa - A function that can be used to convert a binary string
-     * into base-64. Used to encode authorization credentials.
-     * @param args.serviceConfigurations - The options for the RPC services that
-     * you want to construct. This class takes a set of configuration objects and
-     * not literal `RpcService`s to account for the possibility that we may want
-     * to send request headers to official Infura endpoints and not failovers.
-     */
-    constructor({ fetch: givenFetch, btoa: givenBtoa, serviceConfigurations, }: {
-        fetch: typeof fetch;
-        btoa: typeof btoa;
-        serviceConfigurations: RpcServiceConfiguration[];
-    });
-    /**
-     * Listens for when any of the RPC services retry a request.
-     *
-     * @param listener - The callback to be called when the retry occurs.
-     * @returns What {@link RpcService.onRetry} returns.
-     */
-    onRetry(listener: Parameters<RpcService['onRetry']>[0]): {
-        dispose(): void;
-    };
-    /**
-     * Listens for when any of the RPC services retry the request too many times
-     * in a row.
-     *
-     * @param listener - The callback to be called when the retry occurs.
-     * @returns What {@link RpcService.onBreak} returns.
-     */
-    onBreak(listener: Parameters<RpcService['onBreak']>[0]): {
-        dispose(): void;
-    };
-    /**
-     * Listens for when any of the RPC services send a slow request.
-     *
-     * @param listener - The callback to be called when the retry occurs.
-     * @returns What {@link RpcService.onRetry} returns.
-     */
-    onDegraded(listener: Parameters<RpcService['onDegraded']>[0]): {
-        dispose(): void;
-    };
-    /**
-     * Makes a request to the first RPC service in the chain. If this service is
-     * down, then the request is forwarded to the next service in the chain, etc.
-     *
-     * This overload is specifically designed for `eth_getBlockByNumber`, which
-     * can return a `result` of `null` despite an expected `Result` being
-     * provided.
-     *
-     * @param jsonRpcRequest - The JSON-RPC request to send to the endpoint.
-     * @param fetchOptions - An options bag for {@link fetch} which further
-     * specifies the request.
-     * @returns The decoded JSON-RPC response from the endpoint.
-     * @throws A "method not found" error if the response status is 405.
-     * @throws A rate limiting error if the response HTTP status is 429.
-     * @throws A timeout error if the response HTTP status is 503 or 504.
-     * @throws A generic error if the response HTTP status is not 2xx but also not
-     * 405, 429, 503, or 504.
-     */
-    request<Params extends JsonRpcParams, Result extends Json>(jsonRpcRequest: JsonRpcRequest<Params> & {
-        method: 'eth_getBlockByNumber';
-    }, fetchOptions?: FetchOptions): Promise<JsonRpcResponse<Result> | JsonRpcResponse<null>>;
-    /**
-     * Makes a request to the first RPC service in the chain. If this service is
-     * down, then the request is forwarded to the next service in the chain, etc.
-     *
-     * This overload is designed for all RPC methods except for
-     * `eth_getBlockByNumber`, which are expected to return a `result` of the
-     * expected `Result`.
-     *
-     * @param jsonRpcRequest - The JSON-RPC request to send to the endpoint.
-     * @param fetchOptions - An options bag for {@link fetch} which further
-     * specifies the request.
-     * @returns The decoded JSON-RPC response from the endpoint.
-     * @throws A "method not found" error if the response status is 405.
-     * @throws A rate limiting error if the response HTTP status is 429.
-     * @throws A timeout error if the response HTTP status is 503 or 504.
-     * @throws A generic error if the response HTTP status is not 2xx but also not
-     * 405, 429, 503, or 504.
-     */
-    request<Params extends JsonRpcParams, Result extends Json>(jsonRpcRequest: JsonRpcRequest<Params>, fetchOptions?: FetchOptions): Promise<JsonRpcResponse<Result>>;
-}
-export {};
-//# sourceMappingURL=rpc-service-chain.d.cts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"rpc-service-chain.d.cts","sourceRoot":"","sources":["../../src/rpc-service/rpc-service-chain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,IAAI,EACJ,aAAa,EACb,cAAc,EACd,eAAe,EAChB,wBAAwB;AAEzB,OAAO,KAAK,EAAE,kBAAkB,EAAE,mCAA+B;AACjE,OAAO,EAAE,UAAU,EAAE,0BAAsB;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAiB;AAE7C;;;GAGG;AACH,KAAK,uBAAuB,GAAG;IAC7B;;OAEG;IACH,WAAW,EAAE,GAAG,GAAG,MAAM,CAAC;IAC1B;;OAEG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B,CAAC;AAEF;;;;GAIG;AACH,qBAAa,eAAgB,YAAW,kBAAkB;;IAGxD;;;;;;;;;;;;;;OAcG;gBACS,EACV,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,SAAS,EACf,qBAAqB,GACtB,EAAE;QACD,KAAK,EAAE,OAAO,KAAK,CAAC;QACpB,IAAI,EAAE,OAAO,IAAI,CAAC;QAClB,qBAAqB,EAAE,uBAAuB,EAAE,CAAC;KAClD;IAQD;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;;;IAYtD;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;;;IAYtD;;;;;OAKG;IACH,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;;;IAY5D;;;;;;;;;;;;;;;;;OAiBG;IACG,OAAO,CAAC,MAAM,SAAS,aAAa,EAAE,MAAM,SAAS,IAAI,EAC7D,cAAc,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG;QAAE,MAAM,EAAE,sBAAsB,CAAA;KAAE,EAC3E,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,cAAc,CAAC,MAAM,CAAC,EACtC,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;CA4CpC"}

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

@@ -1,116 +0,0 @@
-import type { Json, JsonRpcParams, JsonRpcRequest, JsonRpcResponse } from "@metamask/utils";
-import type { AbstractRpcService } from "./abstract-rpc-service.mjs";
-import { RpcService } from "./rpc-service.mjs";
-import type { FetchOptions } from "./shared.mjs";
-/**
- * The subset of options accepted by the RpcServiceChain constructor which
- * represent a single endpoint.
- */
-type RpcServiceConfiguration = {
-    /**
-     * The URL of the endpoint.
-     */
-    endpointUrl: URL | string;
-    /**
-     * The options to pass to `fetch` when making the request to the endpoint.
-     */
-    fetchOptions?: FetchOptions;
-};
-/**
- * This class constructs a chain of RpcService objects which represent a
- * particular network. The first object in the chain is intended to be the primary
- * way of reaching the network and the remaining objects are used as failovers.
- */
-export declare class RpcServiceChain implements AbstractRpcService {
-    #private;
-    /**
-     * Constructs a new RpcServiceChain object.
-     *
-     * @param args - The arguments.
-     * @param args.fetch - A function that can be used to make an HTTP request.
-     * If your JavaScript environment supports `fetch` natively, you'll probably
-     * want to pass that; otherwise you can pass an equivalent (such as `fetch`
-     * via `node-fetch`).
-     * @param args.btoa - A function that can be used to convert a binary string
-     * into base-64. Used to encode authorization credentials.
-     * @param args.serviceConfigurations - The options for the RPC services that
-     * you want to construct. This class takes a set of configuration objects and
-     * not literal `RpcService`s to account for the possibility that we may want
-     * to send request headers to official Infura endpoints and not failovers.
-     */
-    constructor({ fetch: givenFetch, btoa: givenBtoa, serviceConfigurations, }: {
-        fetch: typeof fetch;
-        btoa: typeof btoa;
-        serviceConfigurations: RpcServiceConfiguration[];
-    });
-    /**
-     * Listens for when any of the RPC services retry a request.
-     *
-     * @param listener - The callback to be called when the retry occurs.
-     * @returns What {@link RpcService.onRetry} returns.
-     */
-    onRetry(listener: Parameters<RpcService['onRetry']>[0]): {
-        dispose(): void;
-    };
-    /**
-     * Listens for when any of the RPC services retry the request too many times
-     * in a row.
-     *
-     * @param listener - The callback to be called when the retry occurs.
-     * @returns What {@link RpcService.onBreak} returns.
-     */
-    onBreak(listener: Parameters<RpcService['onBreak']>[0]): {
-        dispose(): void;
-    };
-    /**
-     * Listens for when any of the RPC services send a slow request.
-     *
-     * @param listener - The callback to be called when the retry occurs.
-     * @returns What {@link RpcService.onRetry} returns.
-     */
-    onDegraded(listener: Parameters<RpcService['onDegraded']>[0]): {
-        dispose(): void;
-    };
-    /**
-     * Makes a request to the first RPC service in the chain. If this service is
-     * down, then the request is forwarded to the next service in the chain, etc.
-     *
-     * This overload is specifically designed for `eth_getBlockByNumber`, which
-     * can return a `result` of `null` despite an expected `Result` being
-     * provided.
-     *
-     * @param jsonRpcRequest - The JSON-RPC request to send to the endpoint.
-     * @param fetchOptions - An options bag for {@link fetch} which further
-     * specifies the request.
-     * @returns The decoded JSON-RPC response from the endpoint.
-     * @throws A "method not found" error if the response status is 405.
-     * @throws A rate limiting error if the response HTTP status is 429.
-     * @throws A timeout error if the response HTTP status is 503 or 504.
-     * @throws A generic error if the response HTTP status is not 2xx but also not
-     * 405, 429, 503, or 504.
-     */
-    request<Params extends JsonRpcParams, Result extends Json>(jsonRpcRequest: JsonRpcRequest<Params> & {
-        method: 'eth_getBlockByNumber';
-    }, fetchOptions?: FetchOptions): Promise<JsonRpcResponse<Result> | JsonRpcResponse<null>>;
-    /**
-     * Makes a request to the first RPC service in the chain. If this service is
-     * down, then the request is forwarded to the next service in the chain, etc.
-     *
-     * This overload is designed for all RPC methods except for
-     * `eth_getBlockByNumber`, which are expected to return a `result` of the
-     * expected `Result`.
-     *
-     * @param jsonRpcRequest - The JSON-RPC request to send to the endpoint.
-     * @param fetchOptions - An options bag for {@link fetch} which further
-     * specifies the request.
-     * @returns The decoded JSON-RPC response from the endpoint.
-     * @throws A "method not found" error if the response status is 405.
-     * @throws A rate limiting error if the response HTTP status is 429.
-     * @throws A timeout error if the response HTTP status is 503 or 504.
-     * @throws A generic error if the response HTTP status is not 2xx but also not
-     * 405, 429, 503, or 504.
-     */
-    request<Params extends JsonRpcParams, Result extends Json>(jsonRpcRequest: JsonRpcRequest<Params>, fetchOptions?: FetchOptions): Promise<JsonRpcResponse<Result>>;
-}
-export {};
-//# sourceMappingURL=rpc-service-chain.d.mts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"rpc-service-chain.d.mts","sourceRoot":"","sources":["../../src/rpc-service/rpc-service-chain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,IAAI,EACJ,aAAa,EACb,cAAc,EACd,eAAe,EAChB,wBAAwB;AAEzB,OAAO,KAAK,EAAE,kBAAkB,EAAE,mCAA+B;AACjE,OAAO,EAAE,UAAU,EAAE,0BAAsB;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAiB;AAE7C;;;GAGG;AACH,KAAK,uBAAuB,GAAG;IAC7B;;OAEG;IACH,WAAW,EAAE,GAAG,GAAG,MAAM,CAAC;IAC1B;;OAEG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B,CAAC;AAEF;;;;GAIG;AACH,qBAAa,eAAgB,YAAW,kBAAkB;;IAGxD;;;;;;;;;;;;;;OAcG;gBACS,EACV,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,SAAS,EACf,qBAAqB,GACtB,EAAE;QACD,KAAK,EAAE,OAAO,KAAK,CAAC;QACpB,IAAI,EAAE,OAAO,IAAI,CAAC;QAClB,qBAAqB,EAAE,uBAAuB,EAAE,CAAC;KAClD;IAQD;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;;;IAYtD;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;;;IAYtD;;;;;OAKG;IACH,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;;;IAY5D;;;;;;;;;;;;;;;;;OAiBG;IACG,OAAO,CAAC,MAAM,SAAS,aAAa,EAAE,MAAM,SAAS,IAAI,EAC7D,cAAc,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG;QAAE,MAAM,EAAE,sBAAsB,CAAA;KAAE,EAC3E,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,cAAc,CAAC,MAAM,CAAC,EACtC,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;CA4CpC"}

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

@@ -1,105 +0,0 @@
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var _RpcServiceChain_instances, _RpcServiceChain_services, _RpcServiceChain_buildRpcServiceChain;
-import { RpcService } from "./rpc-service.mjs";
-/**
- * This class constructs a chain of RpcService objects which represent a
- * particular network. The first object in the chain is intended to be the primary
- * way of reaching the network and the remaining objects are used as failovers.
- */
-export class RpcServiceChain {
-    /**
-     * Constructs a new RpcServiceChain object.
-     *
-     * @param args - The arguments.
-     * @param args.fetch - A function that can be used to make an HTTP request.
-     * If your JavaScript environment supports `fetch` natively, you'll probably
-     * want to pass that; otherwise you can pass an equivalent (such as `fetch`
-     * via `node-fetch`).
-     * @param args.btoa - A function that can be used to convert a binary string
-     * into base-64. Used to encode authorization credentials.
-     * @param args.serviceConfigurations - The options for the RPC services that
-     * you want to construct. This class takes a set of configuration objects and
-     * not literal `RpcService`s to account for the possibility that we may want
-     * to send request headers to official Infura endpoints and not failovers.
-     */
-    constructor({ fetch: givenFetch, btoa: givenBtoa, serviceConfigurations, }) {
-        _RpcServiceChain_instances.add(this);
-        _RpcServiceChain_services.set(this, void 0);
-        __classPrivateFieldSet(this, _RpcServiceChain_services, __classPrivateFieldGet(this, _RpcServiceChain_instances, "m", _RpcServiceChain_buildRpcServiceChain).call(this, {
-            serviceConfigurations,
-            fetch: givenFetch,
-            btoa: givenBtoa,
-        }), "f");
-    }
-    /**
-     * Listens for when any of the RPC services retry a request.
-     *
-     * @param listener - The callback to be called when the retry occurs.
-     * @returns What {@link RpcService.onRetry} returns.
-     */
-    onRetry(listener) {
-        const disposables = __classPrivateFieldGet(this, _RpcServiceChain_services, "f").map((service) => service.onRetry(listener));
-        return {
-            dispose() {
-                disposables.forEach((disposable) => disposable.dispose());
-            },
-        };
-    }
-    /**
-     * Listens for when any of the RPC services retry the request too many times
-     * in a row.
-     *
-     * @param listener - The callback to be called when the retry occurs.
-     * @returns What {@link RpcService.onBreak} returns.
-     */
-    onBreak(listener) {
-        const disposables = __classPrivateFieldGet(this, _RpcServiceChain_services, "f").map((service) => service.onBreak(listener));
-        return {
-            dispose() {
-                disposables.forEach((disposable) => disposable.dispose());
-            },
-        };
-    }
-    /**
-     * Listens for when any of the RPC services send a slow request.
-     *
-     * @param listener - The callback to be called when the retry occurs.
-     * @returns What {@link RpcService.onRetry} returns.
-     */
-    onDegraded(listener) {
-        const disposables = __classPrivateFieldGet(this, _RpcServiceChain_services, "f").map((service) => service.onDegraded(listener));
-        return {
-            dispose() {
-                disposables.forEach((disposable) => disposable.dispose());
-            },
-        };
-    }
-    async request(jsonRpcRequest, fetchOptions = {}) {
-        return __classPrivateFieldGet(this, _RpcServiceChain_services, "f")[0].request(jsonRpcRequest, fetchOptions);
-    }
-}
-_RpcServiceChain_services = new WeakMap(), _RpcServiceChain_instances = new WeakSet(), _RpcServiceChain_buildRpcServiceChain = function _RpcServiceChain_buildRpcServiceChain({ serviceConfigurations, fetch: givenFetch, btoa: givenBtoa, }) {
-    return [...serviceConfigurations]
-        .reverse()
-        .reduce((workingServices, serviceConfiguration, index) => {
-        const failoverService = index > 0 ? workingServices[0] : undefined;
-        const service = new RpcService({
-            fetch: givenFetch,
-            btoa: givenBtoa,
-            ...serviceConfiguration,
-            failoverService,
-        });
-        return [service, ...workingServices];
-    }, []);
-};
-//# sourceMappingURL=rpc-service-chain.mjs.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"rpc-service-chain.mjs","sourceRoot":"","sources":["../../src/rpc-service/rpc-service-chain.ts"],"names":[],"mappings":";;;;;;;;;;;;AAQA,OAAO,EAAE,UAAU,EAAE,0BAAsB;AAkB3C;;;;GAIG;AACH,MAAM,OAAO,eAAe;IAG1B;;;;;;;;;;;;;;OAcG;IACH,YAAY,EACV,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,SAAS,EACf,qBAAqB,GAKtB;;QAzBQ,4CAAwB;QA0B/B,uBAAA,IAAI,6BAAa,uBAAA,IAAI,yEAAsB,MAA1B,IAAI,EAAuB;YAC1C,qBAAqB;YACrB,KAAK,EAAE,UAAU;YACjB,IAAI,EAAE,SAAS;SAChB,CAAC,MAAA,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,QAA8C;QACpD,MAAM,WAAW,GAAG,uBAAA,IAAI,iCAAU,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CACjD,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAC1B,CAAC;QAEF,OAAO;YACL,OAAO;gBACL,WAAW,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;YAC5D,CAAC;SACF,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,OAAO,CAAC,QAA8C;QACpD,MAAM,WAAW,GAAG,uBAAA,IAAI,iCAAU,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CACjD,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAC1B,CAAC;QAEF,OAAO;YACL,OAAO;gBACL,WAAW,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;YAC5D,CAAC;SACF,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,QAAiD;QAC1D,MAAM,WAAW,GAAG,uBAAA,IAAI,iCAAU,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CACjD,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAC7B,CAAC;QAEF,OAAO;YACL,OAAO;gBACL,WAAW,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;YAC5D,CAAC;SACF,CAAC;IACJ,CAAC;IAgDD,KAAK,CAAC,OAAO,CACX,cAAsC,EACtC,eAA6B,EAAE;QAE/B,OAAO,uBAAA,IAAI,iCAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;IACjE,CAAC;CAqCF;8KAtBuB,EACpB,qBAAqB,EACrB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,SAAS,GAKhB;IACC,OAAO,CAAC,GAAG,qBAAqB,CAAC;SAC9B,OAAO,EAAE;SACT,MAAM,CAAC,CAAC,eAA6B,EAAE,oBAAoB,EAAE,KAAK,EAAE,EAAE;QACrE,MAAM,eAAe,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACnE,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC;YAC7B,KAAK,EAAE,UAAU;YACjB,IAAI,EAAE,SAAS;YACf,GAAG,oBAAoB;YACvB,eAAe;SAChB,CAAC,CAAC;QACH,OAAO,CAAC,OAAO,EAAE,GAAG,eAAe,CAAC,CAAC;IACvC,CAAC,EAAE,EAAE,CAAC,CAAC;AACX,CAAC","sourcesContent":["import type {\n  Json,\n  JsonRpcParams,\n  JsonRpcRequest,\n  JsonRpcResponse,\n} from '@metamask/utils';\n\nimport type { AbstractRpcService } from './abstract-rpc-service';\nimport { RpcService } from './rpc-service';\nimport type { FetchOptions } from './shared';\n\n/**\n * The subset of options accepted by the RpcServiceChain constructor which\n * represent a single endpoint.\n */\ntype RpcServiceConfiguration = {\n  /**\n   * The URL of the endpoint.\n   */\n  endpointUrl: URL | string;\n  /**\n   * The options to pass to `fetch` when making the request to the endpoint.\n   */\n  fetchOptions?: FetchOptions;\n};\n\n/**\n * This class constructs a chain of RpcService objects which represent a\n * particular network. The first object in the chain is intended to be the primary\n * way of reaching the network and the remaining objects are used as failovers.\n */\nexport class RpcServiceChain implements AbstractRpcService {\n  readonly #services: RpcService[];\n\n  /**\n   * Constructs a new RpcServiceChain object.\n   *\n   * @param args - The arguments.\n   * @param args.fetch - A function that can be used to make an HTTP request.\n   * If your JavaScript environment supports `fetch` natively, you'll probably\n   * want to pass that; otherwise you can pass an equivalent (such as `fetch`\n   * via `node-fetch`).\n   * @param args.btoa - A function that can be used to convert a binary string\n   * into base-64. Used to encode authorization credentials.\n   * @param args.serviceConfigurations - The options for the RPC services that\n   * you want to construct. This class takes a set of configuration objects and\n   * not literal `RpcService`s to account for the possibility that we may want\n   * to send request headers to official Infura endpoints and not failovers.\n   */\n  constructor({\n    fetch: givenFetch,\n    btoa: givenBtoa,\n    serviceConfigurations,\n  }: {\n    fetch: typeof fetch;\n    btoa: typeof btoa;\n    serviceConfigurations: RpcServiceConfiguration[];\n  }) {\n    this.#services = this.#buildRpcServiceChain({\n      serviceConfigurations,\n      fetch: givenFetch,\n      btoa: givenBtoa,\n    });\n  }\n\n  /**\n   * Listens for when any of the RPC services retry a request.\n   *\n   * @param listener - The callback to be called when the retry occurs.\n   * @returns What {@link RpcService.onRetry} returns.\n   */\n  onRetry(listener: Parameters<RpcService['onRetry']>[0]) {\n    const disposables = this.#services.map((service) =>\n      service.onRetry(listener),\n    );\n\n    return {\n      dispose() {\n        disposables.forEach((disposable) => disposable.dispose());\n      },\n    };\n  }\n\n  /**\n   * Listens for when any of the RPC services retry the request too many times\n   * in a row.\n   *\n   * @param listener - The callback to be called when the retry occurs.\n   * @returns What {@link RpcService.onBreak} returns.\n   */\n  onBreak(listener: Parameters<RpcService['onBreak']>[0]) {\n    const disposables = this.#services.map((service) =>\n      service.onBreak(listener),\n    );\n\n    return {\n      dispose() {\n        disposables.forEach((disposable) => disposable.dispose());\n      },\n    };\n  }\n\n  /**\n   * Listens for when any of the RPC services send a slow request.\n   *\n   * @param listener - The callback to be called when the retry occurs.\n   * @returns What {@link RpcService.onRetry} returns.\n   */\n  onDegraded(listener: Parameters<RpcService['onDegraded']>[0]) {\n    const disposables = this.#services.map((service) =>\n      service.onDegraded(listener),\n    );\n\n    return {\n      dispose() {\n        disposables.forEach((disposable) => disposable.dispose());\n      },\n    };\n  }\n\n  /**\n   * Makes a request to the first RPC service in the chain. If this service is\n   * down, then the request is forwarded to the next service in the chain, etc.\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 \"method not found\" error if the response status is 405.\n   * @throws A rate limiting error if the response HTTP status is 429.\n   * @throws A timeout error if the response HTTP status is 503 or 504.\n   * @throws A generic error if the response HTTP status is not 2xx but also not\n   * 405, 429, 503, or 504.\n   */\n  async request<Params extends JsonRpcParams, Result extends Json>(\n    jsonRpcRequest: JsonRpcRequest<Params> & { method: 'eth_getBlockByNumber' },\n    fetchOptions?: FetchOptions,\n  ): Promise<JsonRpcResponse<Result> | JsonRpcResponse<null>>;\n\n  /**\n   * Makes a request to the first RPC service in the chain. If this service is\n   * down, then the request is forwarded to the next service in the chain, etc.\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 \"method not found\" error if the response status is 405.\n   * @throws A rate limiting error if the response HTTP status is 429.\n   * @throws A timeout error if the response HTTP status is 503 or 504.\n   * @throws A generic error if the response HTTP status is not 2xx but also not\n   * 405, 429, 503, or 504.\n   */\n  async request<Params extends JsonRpcParams, Result extends Json>(\n    jsonRpcRequest: JsonRpcRequest<Params>,\n    fetchOptions?: FetchOptions,\n  ): Promise<JsonRpcResponse<Result>>;\n\n  async request<Params extends JsonRpcParams, Result extends Json>(\n    jsonRpcRequest: JsonRpcRequest<Params>,\n    fetchOptions: FetchOptions = {},\n  ): Promise<JsonRpcResponse<Result | null>> {\n    return this.#services[0].request(jsonRpcRequest, fetchOptions);\n  }\n\n  /**\n   * Constructs the chain of RPC services. The second RPC service is\n   * configured as the failover for the first, the third service is\n   * configured as the failover for the second, etc.\n   *\n   * @param args - The arguments.\n   * @param args.serviceConfigurations - The options for the RPC services that\n   * you want to construct.\n   * @param args.fetch - A function that can be used to make an HTTP request.\n   * @param args.btoa - A function that can be used to convert a binary string\n   * into base-64. Used to encode authorization credentials.\n   * @returns The constructed chain of RPC services.\n   */\n  #buildRpcServiceChain({\n    serviceConfigurations,\n    fetch: givenFetch,\n    btoa: givenBtoa,\n  }: {\n    serviceConfigurations: RpcServiceConfiguration[];\n    fetch: typeof fetch;\n    btoa: typeof btoa;\n  }): RpcService[] {\n    return [...serviceConfigurations]\n      .reverse()\n      .reduce((workingServices: RpcService[], serviceConfiguration, index) => {\n        const failoverService = index > 0 ? workingServices[0] : undefined;\n        const service = new RpcService({\n          fetch: givenFetch,\n          btoa: givenBtoa,\n          ...serviceConfiguration,\n          failoverService,\n        });\n        return [service, ...workingServices];\n      }, []);\n  }\n}\n"]}