quantumcoin 6.14.2 → 6.14.5

package/src.ts/providers/community.ts

@@ -1,49 +1,49 @@
-/**
- *  There are many awesome community services that provide Ethereum
- *  nodes both for developers just starting out and for large-scale
- *  communities.
- *
- *  @_section: api/providers/thirdparty: Community Providers  [thirdparty]
- */
-
-/**
- *  Providers which offer community credentials should extend this
- *  to notify any interested consumers whether community credentials
- *  are in-use.
- */
-export interface CommunityResourcable {
-    /**
-     *  Returns true if the instance is connected using the community
-     *  credentials.
-     */
-    isCommunityResource(): boolean;
-}
-
-// Show the throttle message only once per service
-const shown: Set<string> = new Set();
-
-/**
- *  Displays a warning in the console when the community resource is
- *  being used too heavily by the app, recommending the developer
- *  acquire their own credentials instead of using the community
- *  credentials.
- *
- *  The notification will only occur once per service.
- */
-export function showThrottleMessage(service: string): void {
-    if (shown.has(service)) { return; }
-    shown.add(service);
-
-    console.log("========= NOTICE =========")
-    console.log(`Request-Rate Exceeded for ${ service } (this message will not be repeated)`);
-    console.log("");
-    console.log("The default API keys for each service are provided as a highly-throttled,");
-    console.log("community resource for low-traffic projects and early prototyping.");
-    console.log("");
-    console.log("While your application will continue to function, we highly recommended");
-    console.log("signing up for your own API keys to improve performance, increase your");
-    console.log("request rate/limit and enable other perks, such as metrics and advanced APIs.");
-    console.log("");
-    console.log("For more details: https:/\/docs.ethers.org/api-keys/");
-    console.log("==========================");
-}
+/**
+ *  There are many awesome community services that provide Ethereum
+ *  nodes both for developers just starting out and for large-scale
+ *  communities.
+ *
+ *  @_section: api/providers/thirdparty: Community Providers  [thirdparty]
+ */
+
+/**
+ *  Providers which offer community credentials should extend this
+ *  to notify any interested consumers whether community credentials
+ *  are in-use.
+ */
+export interface CommunityResourcable {
+    /**
+     *  Returns true if the instance is connected using the community
+     *  credentials.
+     */
+    isCommunityResource(): boolean;
+}
+
+// Show the throttle message only once per service
+const shown: Set<string> = new Set();
+
+/**
+ *  Displays a warning in the console when the community resource is
+ *  being used too heavily by the app, recommending the developer
+ *  acquire their own credentials instead of using the community
+ *  credentials.
+ *
+ *  The notification will only occur once per service.
+ */
+export function showThrottleMessage(service: string): void {
+    if (shown.has(service)) { return; }
+    shown.add(service);
+
+    console.log("========= NOTICE =========")
+    console.log(`Request-Rate Exceeded for ${ service } (this message will not be repeated)`);
+    console.log("");
+    console.log("The default API keys for each service are provided as a highly-throttled,");
+    console.log("community resource for low-traffic projects and early prototyping.");
+    console.log("");
+    console.log("While your application will continue to function, we highly recommended");
+    console.log("signing up for your own API keys to improve performance, increase your");
+    console.log("request rate/limit and enable other perks, such as metrics and advanced APIs.");
+    console.log("");
+    console.log("For more details: https:/\/docs.ethers.org/api-keys/");
+    console.log("==========================");
+}

package/src.ts/providers/contracts.ts

@@ -1,42 +1,42 @@
-import type {
-    Provider, TransactionRequest, TransactionResponse
-} from "./provider.js";
-
-/**
- *  A **ContractRunner** is a generic interface which defines an object
- *  capable of interacting with a Contract on the network.
- *
- *  The more operations supported, the more utility it is capable of.
- *
- *  The most common ContractRunners are [Providers](Provider) which enable
- *  read-only access and [Signers](Signer) which enable write-access.
- */
-export interface ContractRunner {
-    /**
-     *  The provider used for necessary state querying operations.
-     *
-     *  This can also point to the **ContractRunner** itself, in the
-     *  case of an [[AbstractProvider]].
-     */
-    provider: null | Provider;
-
-    /**
-     *  Required to estimate gas.
-     */
-    estimateGas?: (tx: TransactionRequest) => Promise<bigint>;
-
-    /**
-     * Required for pure, view or static calls to contracts.
-     */
-    call?: (tx: TransactionRequest) => Promise<string>;
-
-    /**
-     *  Required to support ENS names
-     */
-    resolveName?: (name: string) => Promise<null | string>;
-
-    /**
-     *  Required for state mutating calls
-     */
-    sendTransaction?: (tx: TransactionRequest) => Promise<TransactionResponse>;
-}
+import type {
+    Provider, TransactionRequest, TransactionResponse
+} from "./provider.js";
+
+/**
+ *  A **ContractRunner** is a generic interface which defines an object
+ *  capable of interacting with a Contract on the network.
+ *
+ *  The more operations supported, the more utility it is capable of.
+ *
+ *  The most common ContractRunners are [Providers](Provider) which enable
+ *  read-only access and [Signers](Signer) which enable write-access.
+ */
+export interface ContractRunner {
+    /**
+     *  The provider used for necessary state querying operations.
+     *
+     *  This can also point to the **ContractRunner** itself, in the
+     *  case of an [[AbstractProvider]].
+     */
+    provider: null | Provider;
+
+    /**
+     *  Required to estimate gas.
+     */
+    estimateGas?: (tx: TransactionRequest) => Promise<bigint>;
+
+    /**
+     * Required for pure, view or static calls to contracts.
+     */
+    call?: (tx: TransactionRequest) => Promise<string>;
+
+    /**
+     *  Required to support ENS names
+     */
+    resolveName?: (name: string) => Promise<null | string>;
+
+    /**
+     *  Required for state mutating calls
+     */
+    sendTransaction?: (tx: TransactionRequest) => Promise<TransactionResponse>;
+}

package/src.ts/providers/default-provider.ts

@@ -1,96 +1,96 @@
-
-import { assert } from "../utils/index.js";
-
-import { FallbackProvider } from "./provider-fallback.js";
-import { JsonRpcProvider } from "./provider-jsonrpc.js";
-import { Network } from "./network.js";
-import { WebSocketProvider } from "./provider-websocket.js";
-
-import type { AbstractProvider } from "./abstract-provider.js";
-import type { Networkish } from "./network.js";
-import { WebSocketLike } from "./provider-websocket.js";
-
-function isWebSocketLike(value: any): value is WebSocketLike {
-    return (value && typeof(value.send) === "function" &&
-        typeof(value.close) === "function");
-}
-
-const Testnets = "goerli kovan sepolia classicKotti optimism-goerli arbitrum-goerli matic-mumbai bnbt".split(" ");
-
-/**
- *  Returns a default provider for %%network%%.
- *
- *  If %%network%% is a [[WebSocketLike]] or string that begins with
- *  ``"ws:"`` or ``"wss:"``, a [[WebSocketProvider]] is returned backed
- *  by that WebSocket or URL.
- *
- *  If %%network%% is a string that begins with ``"HTTP:"`` or ``"HTTPS:"``,
- *  a [[JsonRpcProvider]] is returned connected to that URL.
- *
- *  Otherwise, a default provider is created backed by well-known public
- *  Web3 backends (such as [[link-infura]]) using community-provided API
- *  keys.
- *
- *  The %%options%% allows specifying custom API keys per backend (setting
- *  an API key to ``"-"`` will omit that provider) and ``options.exclusive``
- *  can be set to either a backend name or and array of backend names, which
- *  will whitelist **only** those backends.
- *
- *  Current backend strings supported are:
- *
- *  @example:
- *    // Connect to a local Geth node
- *    provider = getDefaultProvider("http://localhost:8545/");
- *
- *    // Connect to Ethereum mainnet with any current and future
- *    // third-party services available
- *    provider = getDefaultProvider("mainnet");
- *
- *    // Connect to Polygon, but only allow Etherscan and
- *    // INFURA and use "MY_API_KEY" in calls to Etherscan.
- *    provider = getDefaultProvider("matic", {
- *      etherscan: "MY_API_KEY",
- *      exclusive: [ "etherscan", "infura" ]
- *    });
- */
-export function getDefaultProvider(network?: string | Networkish | WebSocketLike, options?: any): AbstractProvider {
-    if (options == null) { options = { }; }
-
-    if (typeof(network) === "string" && network.match(/^https?:/)) {
-        return new JsonRpcProvider(network);
-    }
-
-    if (typeof(network) === "string" && network.match(/^wss?:/) || isWebSocketLike(network)) {
-        return new WebSocketProvider(network);
-    }
-
-    // Get the network and name, if possible
-    let staticNetwork: null | Network = null;
-    try {
-        staticNetwork = Network.from(network);
-    } catch (error) { }
-
-
-    const providers: Array<AbstractProvider> = [ ];
-
-    assert(providers.length, "unsupported default network", "UNSUPPORTED_OPERATION", {
-        operation: "getDefaultProvider"
-    });
-
-    // No need for a FallbackProvider
-    if (providers.length === 1) { return providers[0]; }
-
-    // We use the floor because public third-party providers can be unreliable,
-    // so a low number of providers with a large quorum will fail too often
-    let quorum = Math.floor(providers.length / 2);
-    if (quorum > 2) { quorum = 2; }
-
-    // Testnets don't need as strong a security gaurantee and speed is
-    // more useful during testing
-    if (staticNetwork && Testnets.indexOf(staticNetwork.name) !== -1) { quorum = 1; }
-
-    // Provided override qorum takes priority
-    if (options && options.quorum) { quorum = options.quorum; }
-
-    return new FallbackProvider(providers, undefined, { quorum });
-}
+
+import { assert } from "../utils/index.js";
+
+import { FallbackProvider } from "./provider-fallback.js";
+import { JsonRpcProvider } from "./provider-jsonrpc.js";
+import { Network } from "./network.js";
+import { WebSocketProvider } from "./provider-websocket.js";
+
+import type { AbstractProvider } from "./abstract-provider.js";
+import type { Networkish } from "./network.js";
+import { WebSocketLike } from "./provider-websocket.js";
+
+function isWebSocketLike(value: any): value is WebSocketLike {
+    return (value && typeof(value.send) === "function" &&
+        typeof(value.close) === "function");
+}
+
+const Testnets = "goerli kovan sepolia classicKotti optimism-goerli arbitrum-goerli matic-mumbai bnbt".split(" ");
+
+/**
+ *  Returns a default provider for %%network%%.
+ *
+ *  If %%network%% is a [[WebSocketLike]] or string that begins with
+ *  ``"ws:"`` or ``"wss:"``, a [[WebSocketProvider]] is returned backed
+ *  by that WebSocket or URL.
+ *
+ *  If %%network%% is a string that begins with ``"HTTP:"`` or ``"HTTPS:"``,
+ *  a [[JsonRpcProvider]] is returned connected to that URL.
+ *
+ *  Otherwise, a default provider is created backed by well-known public
+ *  Web3 backends (such as [[link-infura]]) using community-provided API
+ *  keys.
+ *
+ *  The %%options%% allows specifying custom API keys per backend (setting
+ *  an API key to ``"-"`` will omit that provider) and ``options.exclusive``
+ *  can be set to either a backend name or and array of backend names, which
+ *  will whitelist **only** those backends.
+ *
+ *  Current backend strings supported are:
+ *
+ *  @example:
+ *    // Connect to a local Geth node
+ *    provider = getDefaultProvider("http://localhost:8545/");
+ *
+ *    // Connect to Ethereum mainnet with any current and future
+ *    // third-party services available
+ *    provider = getDefaultProvider("mainnet");
+ *
+ *    // Connect to Polygon, but only allow Etherscan and
+ *    // INFURA and use "MY_API_KEY" in calls to Etherscan.
+ *    provider = getDefaultProvider("matic", {
+ *      etherscan: "MY_API_KEY",
+ *      exclusive: [ "etherscan", "infura" ]
+ *    });
+ */
+export function getDefaultProvider(network?: string | Networkish | WebSocketLike, options?: any): AbstractProvider {
+    if (options == null) { options = { }; }
+
+    if (typeof(network) === "string" && network.match(/^https?:/)) {
+        return new JsonRpcProvider(network);
+    }
+
+    if (typeof(network) === "string" && network.match(/^wss?:/) || isWebSocketLike(network)) {
+        return new WebSocketProvider(network);
+    }
+
+    // Get the network and name, if possible
+    let staticNetwork: null | Network = null;
+    try {
+        staticNetwork = Network.from(network);
+    } catch (error) { }
+
+
+    const providers: Array<AbstractProvider> = [ ];
+
+    assert(providers.length, "unsupported default network", "UNSUPPORTED_OPERATION", {
+        operation: "getDefaultProvider"
+    });
+
+    // No need for a FallbackProvider
+    if (providers.length === 1) { return providers[0]; }
+
+    // We use the floor because public third-party providers can be unreliable,
+    // so a low number of providers with a large quorum will fail too often
+    let quorum = Math.floor(providers.length / 2);
+    if (quorum > 2) { quorum = 2; }
+
+    // Testnets don't need as strong a security gaurantee and speed is
+    // more useful during testing
+    if (staticNetwork && Testnets.indexOf(staticNetwork.name) !== -1) { quorum = 1; }
+
+    // Provided override qorum takes priority
+    if (options && options.quorum) { quorum = options.quorum; }
+
+    return new FallbackProvider(providers, undefined, { quorum });
+}