essential-eth 0.5.9 → 0.5.10

package/lib/cjs/providers/BaseProvider.js

@@ -1,512 +0,0 @@
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseProvider = void 0;
-const clean_block_1 = require("../classes/utils/clean-block");
-const clean_log_1 = require("../classes/utils/clean-log");
-const clean_transaction_1 = require("../classes/utils/clean-transaction");
-const clean_transaction_receipt_1 = require("../classes/utils/clean-transaction-receipt");
-const fetchers_1 = require("../classes/utils/fetchers");
-const hex_to_decimal_1 = require("../classes/utils/hex-to-decimal");
-const prepare_transaction_1 = require("../classes/utils/prepare-transaction");
-const logger_1 = require("../logger/logger");
-const tiny_big_1 = require("../shared/tiny-big/tiny-big");
-const chains_info_1 = __importDefault(require("./utils/chains-info"));
-/**
- * Converts a block tag into the right format when needed.
- *
- * * No equivalent in ethers.js
- * * No equivalent in web3.js
- *
- * @internal
- * @param blockTag the block tag to convert/return as a hex string
- * @returns the specified block tag formatted as a hex string
- * @example
- * ```javascript
- * prepBlockTag(14848183);
- * // '0xe290b7'
- * ```
- * @example
- * ```javascript
- * prepBlockTag('0xe290b7');
- * // '0xe290b7'
- * ```
- */
-function prepBlockTag(blockTag) {
-    return typeof blockTag === 'number'
-        ? (0, tiny_big_1.tinyBig)(blockTag).toHexString()
-        : blockTag;
-}
-class BaseProvider {
-    /**
-     * @param rpcUrls The URL(s) to your Eth node(s). Consider POKT or Infura
-     * @example
-     * `https://free-eth-node.com/api/eth`
-     * @example
-     * `https://mainnet.infura.io/v3/YOUR-PROJECT-ID`
-     */
-    constructor(rpcUrls) {
-        /**
-         * @ignore
-         */
-        this._rpcUrls = [];
-        /**
-         * @ignore
-         */
-        this._post = (body) => (0, fetchers_1.post)(this.selectRpcUrl(), body);
-        this._rpcUrls = rpcUrls;
-    }
-    /**
-     * Gets information (name, chainId, and ensAddress when applicable) about the network the provider is connected to.
-     *
-     * * [Identical](/docs/api#isd) to [`ethers.provider.getNetwork`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getNetwork) in ethers.js
-     * * [Similar](/docs/api#isd) to [`web3.eth.getChainId`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#getchainid) in web3.js, returns more than just the `chainId`
-     *
-     * @returns information about the network this provider is currently connected to
-     * @example
-     * ```javascript
-     * jsonRpcProvider('https://free-eth-node.com/api/eth').getNetwork();
-     * // { chainId: 1, name: 'eth', ensAddress: '0x00000000000C2E074eC69A0dFb2997BA6C7d2e1e' }
-     * ```
-     * @example
-     * ```javascript
-     * jsonRpcProvider('https://free-eth-node.com/api/MATIC').getNetwork();
-     * // { chainId: 137, name: 'MATIC', ensAddress: null }
-     * ```
-     */
-    getNetwork() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const hexChainId = (yield this.post((0, fetchers_1.buildRPCPostBody)('eth_chainId', [])));
-            const chainId = (0, hex_to_decimal_1.hexToDecimal)(hexChainId);
-            const info = chains_info_1.default[chainId];
-            return {
-                chainId: Number(chainId),
-                name: info[0] || 'unknown',
-                ensAddress: info[1] || null, // only send ensAddress if it exists
-            };
-        });
-    }
-    /**
-     * Gets the number of the most recently mined block on the network the provider is connected to.
-     *
-     * * [Identical](/docs/api#isd) to [`ethers.provider.getBlockNumber`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getBlockNumber) in ethers.js
-     * * [Identical](/docs/api#isd) to [`web3.eth.getBlockNumber`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#getblocknumber) in web3.js
-     *
-     * @returns the number of the most recently mined block
-     * @example
-     * ```javascript
-     * await provider.getBlockNumber();
-     * // 1053312
-     * ```
-     */
-    getBlockNumber() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const currentBlockNumber = (yield this.post((0, fetchers_1.buildRPCPostBody)('eth_blockNumber', [])));
-            return Number((0, hex_to_decimal_1.hexToDecimal)(currentBlockNumber));
-        });
-    }
-    /**
-     * Gets information about a specified transaction, even if it hasn't been mined yet.
-     *
-     * * [Similar](/docs/api#isd) to [`ethers.provider.getTransaction`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getTransaction) in ethers.js, does not have `wait` method that waits until the transaction has been mined
-     * * [Similar](/docs/api#isd) to [`web3.eth.getTransaction`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#gettransaction) in web3.js, some information returned using different types
-     *
-     * @param transactionHash the hash of the transaction to get information about
-     * @returns information about the specified transaction
-     * @example
-     * ```javascript
-     * await provider.getTransaction('0x9014ae6ef92464338355a79e5150e542ff9a83e2323318b21f40d6a3e65b4789');
-     * // {
-     * //   accessList: [],
-     * //   blockHash: "0x876810a013dbcd140f6fd6048c1dc33abbb901f1f96b394c2fa63aef3cb40b5d",
-     * //   blockNumber: 14578286,
-     * //   chainId: 1,
-     * //   from: "0xdfD9dE5f6FA60BD70636c0900752E93a6144AEd4",
-     * //   gas: { TinyBig: 112163 },
-     * //   gasPrice: { TinyBig: 48592426858 },
-     * //   hash: "0x9014ae6ef92464338355a79e5150e542ff9a83e2323318b21f40d6a3e65b4789",
-     * //   input: "0x83259f17000000000000000000000000000000000000000000...",
-     * //   maxFeePerGas: { TinyBig: 67681261618 },
-     * //   maxPriorityFeePerGas: { TinyBig: 1500000000 },
-     * //   nonce: { TinyBig: 129 },
-     * //   r: "0x59a7c15b12c18cd68d6c440963d959bff3e73831ffc938e75ecad07f7ee43fbc",
-     * //   s: "0x1ebaf05f0d9273b16c2a7748b150a79d22533a8cd74552611cbe620fee3dcf1c",
-     * //   to: "0x39B72d136ba3e4ceF35F48CD09587ffaB754DD8B",
-     * //   transactionIndex: 29,
-     * //   type: 2,
-     * //   v: 0,
-     * //   value: { TinyBig: 0 },
-     * //   confirmations: 298140,
-     * // }
-     * ```
-     */
-    getTransaction(transactionHash) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const [rpcTransaction, blockNumber] = yield Promise.all([
-                this.post((0, fetchers_1.buildRPCPostBody)('eth_getTransactionByHash', [transactionHash])),
-                this.getBlock('latest'),
-            ]);
-            const cleanedTransaction = (0, clean_transaction_1.cleanTransaction)(rpcTransaction);
-            // https://ethereum.stackexchange.com/questions/2881/how-to-get-the-transaction-confirmations-using-the-json-rpc
-            cleanedTransaction.confirmations =
-                blockNumber.number - cleanedTransaction.blockNumber + 1;
-            return cleanedTransaction;
-        });
-    }
-    /**
-     * Gives information about a transaction that has already been mined. Includes additional information beyond what's provided by [`getTransaction`](/docs/api/modules#gettransaction).
-     *
-     * * [Identical](/docs/api#isd) to [`ethers.provider.getTransactionReceipt`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getTransactionReceipt) in ethers.js
-     * * [Similar](/docs/api#isd) to [`web3.eth.getTransactionReceipt`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#gettransactionreceipt) in web3.js, some information returned using different types
-     *
-     * @param transactionHash the hash of the transaction to get information about
-     * @returns information about the specified transaction that has already been mined
-     * @example
-     * ```javascript
-     * await provider.getTransactionReceipt('0x9014ae6ef92464338355a79e5150e542ff9a83e2323318b21f40d6a3e65b4789');
-     * // {
-     * //   blockHash: "0x876810a013dbcd140f6fd6048c1dc33abbb901f1f96b394c2fa63aef3cb40b5d",
-     * //   blockNumber: 14578286,
-     * //   contractAddress: null,
-     * //   cumulativeGasUsed: { TinyBig: 3067973 },
-     * //   effectiveGasPrice: { TinyBig: 48592426858 },
-     * //   from: "0xdfD9dE5f6FA60BD70636c0900752E93a6144AEd4",
-     * //   gasUsed: { TinyBig: 112163 },
-     * //   logs: [
-     * //     {
-     * //       address: "0x0eDF9bc41Bbc1354c70e2107F80C42caE7FBBcA8",
-     * //       blockHash: "0x876810a013dbcd140f6fd6048c1dc33abbb901f1f96b394c2fa63aef3cb40b5d",
-     * //       blockNumber: 14578286,
-     * //       data: "0x0000000000000000000000000000000000000000000003a12ec797b5484968c1",
-     * //       logIndex: 42,
-     * //       topics: [
-     * //         "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
-     * //         "0x00000000000000000000000039b72d136ba3e4cef35f48cd09587ffab754dd8b",
-     * //         "0x000000000000000000000000dfd9de5f6fa60bd70636c0900752e93a6144aed4",
-     * //       ],
-     * //       transactionHash: "0x9014ae6ef92464338355a79e5150e542ff9a83e2323318b21f40d6a3e65b4789",
-     * //       transactionIndex: 29,
-     * //     },
-     * //     {
-     * //       address: "0x39B72d136ba3e4ceF35F48CD09587ffaB754DD8B",
-     * //       blockHash: "0x876810a013dbcd140f6fd6048c1dc33abbb901f1f96b394c2fa63aef3cb40b5d",
-     * //       blockNumber: 14578286,
-     * //       data: "0x0000000000000000000000000000000000000000000003a12ec797b5484968c1",
-     * //       logIndex: 43,
-     * //       topics: [
-     * //         "0x34fcbac0073d7c3d388e51312faf357774904998eeb8fca628b9e6f65ee1cbf7",
-     * //         "0x000000000000000000000000dfd9de5f6fa60bd70636c0900752e93a6144aed4",
-     * //         "0x0000000000000000000000000000000000000000000000000000000000000003",
-     * //       ],
-     * //       transactionHash: "0x9014ae6ef92464338355a79e5150e542ff9a83e2323318b21f40d6a3e65b4789",
-     * //       transactionIndex: 29,
-     * //     },
-     * //   ],
-     * //   logsBloom: "0x00000000000000000000000000000...",
-     * //   status: 1,
-     * //   to: "0x39B72d136ba3e4ceF35F48CD09587ffaB754DD8B",
-     * //   transactionHash: "0x9014ae6ef92464338355a79e5150e542ff9a83e2323318b21f40d6a3e65b4789",
-     * //   transactionIndex: 29,
-     * //   type: 2,
-     * //   byzantium: true,
-     * //   confirmations: 298171,
-     * // }
-     * ```
-     */
-    getTransactionReceipt(transactionHash) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const [rpcTransaction, blockNumber] = yield Promise.all([
-                this.post((0, fetchers_1.buildRPCPostBody)('eth_getTransactionReceipt', [transactionHash])),
-                this.getBlock('latest'),
-            ]);
-            const cleanedTransactionReceipt = (0, clean_transaction_receipt_1.cleanTransactionReceipt)(rpcTransaction);
-            cleanedTransactionReceipt.confirmations =
-                blockNumber.number - cleanedTransactionReceipt.blockNumber + 1;
-            return cleanedTransactionReceipt;
-        });
-    }
-    /**
-     * Returns the number of sent transactions by an address, from genesis (or as far back as a provider looks) up to specified block.
-     *
-     * * [Identical](/docs/api#isd) to [`ethers.provider.getTransactionCount`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getTransactionCount) in ethers.js
-     * * [Identical](/docs/api#isd) to [`web3.eth.getTransactionCount`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#gettransactioncount) in web3.js
-     *
-     * @param address the address to count number of sent transactions
-     * @param blockTag the block to count transactions up to, inclusive
-     * @returns the number of transactions sent by the specified address
-     * @example
-     * ```javascript
-     * await provider.getTransactionCount('0x71660c4005ba85c37ccec55d0c4493e66fe775d3');
-     * // 1060000
-     * ```
-     * @example
-     * ```javascript
-     * await provider.getTransactionCount('0x71660c4005ba85c37ccec55d0c4493e66fe775d3', 'latest');
-     * // 1060000
-     * ```
-     * @example
-     * ```javascript
-     * await provider.getTransactionCount('0x71660c4005ba85c37ccec55d0c4493e66fe775d3', 14649390);
-     * // 1053312
-     * ```
-     */
-    getTransactionCount(address, blockTag = 'latest') {
-        return __awaiter(this, void 0, void 0, function* () {
-            blockTag = prepBlockTag(blockTag);
-            const transactionCount = (yield this.post((0, fetchers_1.buildRPCPostBody)('eth_getTransactionCount', [address, blockTag])));
-            return Number((0, hex_to_decimal_1.hexToDecimal)(transactionCount));
-        });
-    }
-    /**
-     * Gets information about a certain block, optionally with full transaction objects.
-     *
-     * * [Similar](/docs/api#isd) to [`ethers.provider.getBlock`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getLogs) in ethers.js, includes some additional information. Can also return block with full transaction objects, similar to [`ethers.providers.getBlockWithTransactions`]
-     * * [Identical](/docs/api#isd) to [`web3.eth.getBlock`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#getpastlogs) in web3.js
-     *
-     * @param timeFrame The number, hash, or text-based description ('latest', 'earliest', or 'pending') of the block to collect information on.
-     * @param returnTransactionObjects Whether to also return data about the transactions on the block.
-     * @returns A BlockResponse object with information about the specified block
-     * @example
-     * ```javascript
-     * await provider.getBlock(14879862);
-     * // {
-     * //   baseFeePerGas: { TinyBig: 39095728776 },
-     * //   difficulty: { TinyBig: 14321294455359973 },
-     * //   extraData: "0x486976656f6e2073672d6865617679",
-     * //   gasLimit: { TinyBig: 29970620 },
-     * //   gasUsed: { TinyBig: 20951384 },
-     * //   hash: "0x563b458ec3c4f87393b53f70bdddc0058497109b784d8cacd9247ddf267049ab",
-     * //   logsBloom:
-     * //     "0x9f38794fe80b521794df6efad8b0d2e9582f9ec3959a3f9384bda0fa371cfa5fac5af9d515c6bdf1ec325f5b5f7ebdd6a3a9fae17b38a86d4dc4b0971afc68d8086640550f4c156e6f923f4a1bb94fb0bed6cdcc474c5c64bfeff7a4a906f72b9a7b94004ee58efc53d63ac66961acd3a431b2d896cc9fd75f6072960bced45f770587caf130f57504decfcb63c6ca8fbc5bdbd749edd5a99a7375d2b81872289adb775fb3c928259f4be39c6d3f4d5b6217822979bb88c1f1fb62429b1b6d41cf4e3f77f9e1db3f5723108f1e5b1255dd734ad8cdb11e7ea22487c788e67c83777b6f395e504ca59c64f52245ee6de3804cf809e5caa4f0ea6a9aa9eb6ed801",
-     * //   miner: "0x1aD91ee08f21bE3dE0BA2ba6918E714dA6B45836",
-     * //   mixHash: "0x73cc9419bfb89c9d41c3a8c34ce56b5ebe468bdcf870258d2e77262275d580ec",
-     * //   nonce: "0x976f3f5d596ffb08",
-     * //   number: 14879862,
-     * //   parentHash: "0x95986ae14a71face8d9a6a379edd875b2e8bc73e4de0d9d460e7752bddb0f579",
-     * //   receiptsRoot: "0x8e6ba2fd9bee602b653dae6e3132f16538c2c5df24f1df8c000392053f73defa",
-     * //   sha3Uncles: "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
-     * //   size: { TinyBig: 134483 },
-     * //   stateRoot: "0xbf2bb67bd1c741f3d00904b8451d7c2cf4e3a2726f5a5884792ede2074747b85",
-     * //   timestamp: { TinyBig: 1654016186 },
-     * //   totalDifficulty: { TinyBig: 50478104614257705213748 },
-     * //   transactions: [
-     * //     "0xb3326a9149809603a2c28545e50e4f7d16e194bf5ee9764e0544603854c4a8d2",
-     * //     "0x8b42095f8d335404a4896b2817b8e5e3d86a5a87cb434a8eec295d5280a7f48e",
-     * //     "0x882f78fcb73f0f7ad0700bb0424a8b4beb366aaa93b88a3562c49a8d0ce4dcff",
-     * //     ...
-     * //   ],
-     * //   transactionsRoot: "0x5934902f3dcc263ec34f24318179bf6301f53f4834685792066026f3a4849d72",
-     * //   uncles: [],
-     * // }
-     * ```
-     */
-    getBlock(timeFrame = 'latest', returnTransactionObjects = false) {
-        return __awaiter(this, void 0, void 0, function* () {
-            let type = 'Number';
-            if (typeof timeFrame === 'string' && timeFrame.length === 66) {
-                // use endpoint that accepts string
-                type = 'Hash';
-            }
-            else {
-                timeFrame = prepBlockTag(timeFrame);
-            }
-            const rpcBlock = (yield this.post((0, fetchers_1.buildRPCPostBody)(`eth_getBlockBy${type}`, [
-                timeFrame,
-                returnTransactionObjects,
-            ])));
-            return (0, clean_block_1.cleanBlock)(rpcBlock, returnTransactionObjects);
-        });
-    }
-    /**
-     * Gives an estimate of the current gas price in wei.
-     *
-     * * [Similar](/docs/api#isd) to [`ethers.provider.getGasPrice`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getGasPrice) in ethers.js, does not have a parameter specifying what unit you'd like to return. See also [`weiToEther`](/docs/api/modules#weitoether) and [`etherToGwei`](/docs/api/modules#ethertogwei)
-     * * [Identical](/docs/api#isd) to [`web3.eth.getGasPrice`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#getgasprice) in web3.js, returns a number (TinyBig) instead of a string
-     *
-     * @returns an estimate of the current gas price in wei
-     * @example
-     * ```javascript
-     * await provider.getGasPrice();
-     * // 52493941856
-     * ```
-     */
-    getGasPrice() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const hexGasPrice = (yield this.post((0, fetchers_1.buildRPCPostBody)('eth_gasPrice', [])));
-            return (0, tiny_big_1.tinyBig)((0, hex_to_decimal_1.hexToDecimal)(hexGasPrice));
-        });
-    }
-    /**
-     * Returns the balance of the account in wei.
-     *
-     * * [Identical](/docs/api#isd) to [`ethers.provider.getBalance`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getBalance) in ethers.js
-     * * [Identical](/docs/api#isd) to [`web3.eth.getBalance`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#getbalance) in web3.js, returns a number (TinyBig) instead of a string
-     *
-     * @param address the address to check the balance of
-     * @param blockTag the block to check the specified address' balance on
-     * @returns the balance of the network's native token for the specified address on the specified block
-     * @example
-     * ```javascript
-     *  await provider.getBalance('0x7cB57B5A97eAbe94205C07890BE4c1aD31E486A8');
-     * // 28798127851528138
-     * ```
-     */
-    getBalance(address, blockTag = 'latest') {
-        return __awaiter(this, void 0, void 0, function* () {
-            blockTag = prepBlockTag(blockTag);
-            const hexBalance = (yield this.post((0, fetchers_1.buildRPCPostBody)('eth_getBalance', [address, blockTag])));
-            return (0, tiny_big_1.tinyBig)((0, hex_to_decimal_1.hexToDecimal)(hexBalance));
-        });
-    }
-    /**
-     * Gets the code of a contract on a specified block.
-     *
-     * * [Identical](/docs/api#isd) to [`ethers.provider.getCode`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getCode) in ethers.js
-     * * [Identical](/docs/api#isd) to [`web3.eth.getCode`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#getcode) in web3.js
-     *
-     * @param address the contract address to get the contract code from
-     * @param blockTag the block height to search for the contract code from. Contract code can change, so this allows for checking a specific block
-     * @returns the contract creation code for the specified address at the specified block height
-     * @example
-     * ```javascript
-     * await jsonRpcProvider().getCode('0xaC6095720221C79C6E7C638d260A2eFBC5D8d880', 'latest');
-     * // '0x608060405234801561001057600080fd5b506004361061...'
-     * ```
-     */
-    getCode(address, blockTag = 'latest') {
-        return __awaiter(this, void 0, void 0, function* () {
-            blockTag = prepBlockTag(blockTag);
-            const contractCode = (yield this.post((0, fetchers_1.buildRPCPostBody)('eth_getCode', [address, blockTag])));
-            return contractCode;
-        });
-    }
-    /**
-     * Returns an estimate of the amount of gas that would be required to submit transaction to the network.
-     * An estimate may not be accurate since there could be another transaction on the network that was not accounted for.
-     *
-     * * [Identical](/docs/api#isd) to [`ethers.provider.estimateGas`](https://docs.ethers.io/v5/api/providers/provider/#Provider-estimateGas) in ethers.js
-     * * [Identical](/docs/api#isd) to [`web3.eth.estimateGas`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#estimateGas) in web3.js
-     *
-     * @param transaction the transaction to check the estimated gas cost for
-     * @returns the estimated amount of gas charged for submitting the specified transaction to the blockchain
-     * @example
-     * ```javascript
-     * await provider.estimateGas({
-     *   // Wrapped ETH address
-     *   to: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
-     *   data: "0xd0e30db0",
-     *   value: etherToWei('1.0').toHexString(),
-     * });
-     * // { TinyBig: "27938" }
-     * ```
-     */
-    estimateGas(transaction) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const rpcTransaction = (0, prepare_transaction_1.prepareTransaction)(transaction);
-            const gasUsed = (yield this.post((0, fetchers_1.buildRPCPostBody)('eth_estimateGas', [rpcTransaction])));
-            return (0, tiny_big_1.tinyBig)((0, hex_to_decimal_1.hexToDecimal)(gasUsed));
-        });
-    }
-    /**
-     * Returns transaction receipt event logs that match a specified filter.
-     * May return `[]` if parameters are too broad, even if logs exist.
-     *
-     * * [Identical](/docs/api#isd) to [`ethers.provider.getLogs`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getLogs) in ethers.js
-     * * [Identical](/docs/api#isd) to [`web3.eth.getPastLogs`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#getpastlogs) in web3.js
-     *
-     * @param filter parameters to filter the logs by
-     * @returns an array of logs matching the specified filter
-     * @example
-     * ```javascript
-     * provider.getLogs({
-     *   address: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
-     *   topics: [
-     *     "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
-     *     "0x00000000000000000000000021b8065d10f73ee2e260e5b47d3344d3ced7596e",
-     *   ],
-     *   fromBlock: 14825027,
-     *   toBlock: 14825039,
-     * });
-     *
-     * [
-     *   {
-     *     address: '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2',
-     *     blockHash: '0x8e0dfac2f704851960f866c8708b3bef2f66c0fee0329cf25ff0261b264ca6bc',
-     *     blockNumber: 14825029,
-     *     data: '0x000000000000000000000000000000000000000000000000005f862ee352a38a',
-     *     logIndex: 384,
-     *     removed: false,
-     *     topics: [
-     *       '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef',
-     *       '0x00000000000000000000000021b8065d10f73ee2e260e5b47d3344d3ced7596e',
-     *       '0x00000000000000000000000068b3465833fb72a70ecdf485e0e4c7bd8665fc45'
-     *     ],
-     *     transactionHash: '0xbd49031be16f8fd1775f4e0fe79b408ffd8ae9c65b2827ee47e3238e3f51f4c0',
-     *     transactionIndex: 226
-     *   }
-     * ]
-     * ```
-     */
-    getLogs(filter) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const filterByRange = filter;
-            if (filterByRange.fromBlock)
-                filterByRange.fromBlock = prepBlockTag(filterByRange.fromBlock);
-            if (filterByRange.toBlock)
-                filterByRange.toBlock = prepBlockTag(filterByRange.toBlock);
-            const rpcLogs = (yield this.post((0, fetchers_1.buildRPCPostBody)('eth_getLogs', [filter])));
-            const logs = rpcLogs.map((log) => (0, clean_log_1.cleanLog)(log, false));
-            return logs;
-        });
-    }
-    /**
-     * Returns the result of adding a transaction to the blockchain without actually adding that transaction to the blockchain.
-     * Does not require any ether as gas.
-     *
-     * * [Identical](/docs/api#isd) to [`ethers.provider.call`](https://docs.ethers.io/v5/api/providers/provider/#Provider-call) in ethers.js
-     * * [Identical](/docs/api#isd) to [`web3.eth.call`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#call) in web3.js
-     *
-     * @param transaction the transaction object to, in theory, execute. Doesn't actually get added to the blockchain.
-     * @param blockTag the block to execute this transaction on
-     * @returns the result of executing the transaction on the specified block
-     * @example
-     * ```javascript
-     * await provider.call({ to: "0x6b175474e89094c44da98b954eedeac495271d0f", data: "0x70a082310000000000000000000000006E0d01A76C3Cf4288372a29124A26D4353EE51BE" });
-     * // '0x0000000000000000000000000000000000000000000000000858898f93629000'
-     * ```
-     */
-    call(transaction, blockTag = 'latest') {
-        return __awaiter(this, void 0, void 0, function* () {
-            if (transaction.gasPrice &&
-                (transaction.maxPriorityFeePerGas || transaction.maxFeePerGas)) {
-                logger_1.logger.throwError('Cannot specify both "gasPrice" and ("maxPriorityFeePerGas" or "maxFeePerGas")', {
-                    gasPrice: transaction.gasPrice,
-                    maxFeePerGas: transaction.maxFeePerGas,
-                    maxPriorityFeePerGas: transaction.maxPriorityFeePerGas,
-                });
-            }
-            if (transaction.maxFeePerGas && transaction.maxPriorityFeePerGas) {
-                logger_1.logger.throwError('Cannot specify both "maxFeePerGas" and "maxPriorityFeePerGas"', {
-                    maxFeePerGas: transaction.maxFeePerGas,
-                    maxPriorityFeePerGas: transaction.maxPriorityFeePerGas,
-                });
-            }
-            blockTag = prepBlockTag(blockTag);
-            const rpcTransaction = (0, prepare_transaction_1.prepareTransaction)(transaction);
-            const transactionRes = (yield this.post((0, fetchers_1.buildRPCPostBody)('eth_call', [rpcTransaction, blockTag])));
-            return transactionRes;
-        });
-    }
-}
-exports.BaseProvider = BaseProvider;

package/lib/cjs/providers/FallthroughProvider.d.ts

@@ -1,24 +0,0 @@
-import { BaseProvider } from './BaseProvider';
-export interface ConstructorOptions {
-    timeoutDuration?: number;
-}
-/**
- * @beta
- * A JSON RPC Provider which moves to the next URL when one fails.
- */
-export declare class FallthroughProvider extends BaseProvider {
-    /**
-     * @ignore
-     */
-    private rpcUrlCounter;
-    private readonly timeoutDuration;
-    /**
-     * @ignore
-     */
-    selectRpcUrl(): string;
-    constructor(rpcUrls: string[], options?: ConstructorOptions);
-    /**
-     * @ignore
-     */
-    post: (body: Record<string, unknown>) => Promise<any>;
-}

package/lib/cjs/providers/FallthroughProvider.js

@@ -1,65 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FallthroughProvider = void 0;
-const logger_1 = require("../logger/logger");
-const BaseProvider_1 = require("./BaseProvider");
-// https://advancedweb.hu/how-to-add-timeout-to-a-promise-in-javascript/
-const promiseTimeout = (prom, time) => Promise.race([
-    prom,
-    new Promise((_r, reject) => setTimeout(() => reject('Promise timed out'), time)),
-]);
-const DEFAULT_TIMEOUT_DURATION = 8000;
-/**
- * @beta
- * A JSON RPC Provider which moves to the next URL when one fails.
- */
-class FallthroughProvider extends BaseProvider_1.BaseProvider {
-    constructor(rpcUrls, options = {}) {
-        if (!Array.isArray(rpcUrls)) {
-            logger_1.logger.throwError('Array required', { rpcUrls });
-        }
-        if (rpcUrls.length <= 1) {
-            logger_1.logger.throwError('More than one rpcUrl is required', { rpcUrls });
-        }
-        super(rpcUrls);
-        // index of current trusted rpc url
-        /**
-         * @ignore
-         */
-        this.rpcUrlCounter = 0;
-        /**
-         * @ignore
-         */
-        this.post = (body) => {
-            // while failing post, add to rpcUrlCounter and post again
-            const genesisCount = this.rpcUrlCounter;
-            const recursivePostRetry = () => {
-                // Times out request
-                const genesisRpcUrl = this.selectRpcUrl();
-                const res = promiseTimeout(this._post(body), this.timeoutDuration).catch((e) => {
-                    // A mutex: Only add if no other instance has discovered this url as failing yet
-                    if (genesisRpcUrl === this.selectRpcUrl()) {
-                        // add one and handle array overflow
-                        this.rpcUrlCounter =
-                            (this.rpcUrlCounter + 1) % this._rpcUrls.length;
-                    }
-                    // we've already tried this rpc, throw for good
-                    if (this.rpcUrlCounter === genesisCount) {
-                        throw e;
-                    }
-                    return recursivePostRetry();
-                });
-                return res;
-            };
-            return recursivePostRetry();
-        };
-        this.timeoutDuration = options.timeoutDuration || DEFAULT_TIMEOUT_DURATION;
-    }
-    /**
-     * @ignore
-     */
-    selectRpcUrl() {
-        return this._rpcUrls[this.rpcUrlCounter];
-    }
-}
-exports.FallthroughProvider = FallthroughProvider;

package/lib/cjs/providers/JsonRpcProvider.d.ts

@@ -1,33 +0,0 @@
-import { BaseProvider } from './BaseProvider';
-export declare class JsonRpcProvider extends BaseProvider {
-    /**
-     * @ignore
-     */
-    selectRpcUrl(): string;
-    /**
-     * @ignore
-     */
-    post(body: Record<string, unknown>): Promise<any>;
-    /**
-     * @param rpcUrl The URL to your Eth node. Consider POKT or Infura
-     * @example
-     * `https://free-eth-node.com/api/eth`
-     * @example
-     * `https://mainnet.infura.io/v3/YOUR-PROJECT-ID`
-     */
-    constructor(rpcUrl?: string);
-}
-/**
- * Helper function to avoid "new"
- *
- * @param rpcUrl the RPC URL to post requests to
- * @returns an initiated {@link JsonRpcProvider}
- * @example
- * ```javascript
- * jsonRpcProvider().getBlock('latest').then(block => {
- *   console.log(block.number);
- * })
- * // 14530496
- * ```
- */
-export declare function jsonRpcProvider(rpcUrl?: string): JsonRpcProvider;