essential-eth 0.5.6 → 0.5.9

package/lib/cjs/providers/BaseProvider.js

@@ -14,15 +14,47 @@ var __importDefault = (this && this.__importDefault) || function (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 rpcUrl The URL to your Eth node. Consider POKT or Infura
+     * @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) {
         /**
@@ -36,7 +68,22 @@ class BaseProvider {
         this._rpcUrls = rpcUrls;
     }
     /**
-     * Returns the network this provider is connected to
+     * 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* () {
@@ -51,14 +98,14 @@ class BaseProvider {
         });
     }
     /**
-     * Gets the number of the most recently mined block on the network the provider is connected to
+     * Gets the number of the most recently mined block on the network the provider is connected to.
      *
-     * * Identical to [`ethers.provider.getBlockNumber`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getBlockNumber)
-     * * Identical to [`web3.eth.getBlockNumber`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#getblocknumber)
+     * * [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
-     * ```js
+     * ```javascript
      * await provider.getBlockNumber();
      * // 1053312
      * ```
@@ -70,127 +117,38 @@ class BaseProvider {
         });
     }
     /**
-     * * Similar to [`ethers.provider.getTransaction`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getTransaction), some information not included
+     * Gets information about a specified transaction, even if it hasn't been mined yet.
      *
-     * @returns information about one transaction
+     * * [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
-     * ```js
+     * ```javascript
      * await provider.getTransaction('0x9014ae6ef92464338355a79e5150e542ff9a83e2323318b21f40d6a3e65b4789');
-     *  {
-     *    accessList: [],
-     *    blockHash: '0x876810a013dbcd140f6fd6048c1dc33abbb901f1f96b394c2fa63aef3cb40b5d',
-     *    blockNumber: 14578286,
-     *    chainId: 1,
-     *    from: '0xdfD9dE5f6FA60BD70636c0900752E93a6144AEd4',
-     *    gas: Big {
-     *    s: 1,
-     *    e: 5,
-     *    c: [ 1, 1, 2, 1, 6, 3 ],
-     *    constructor: <ref *1> [Function: Big] {
-     *    DP: 20,
-     *    RM: 1,
-     *    NE: -7,
-     *    PE: 21,
-     *    strict: false,
-     *    roundDown: 0,
-     *    roundHalfUp: 1,
-     *    roundHalfEven: 2,
-     *    roundUp: 3,
-     *    Big: [Circular *1],
-     *    default: [Circular *1]
-     *    }
-     *    },
-     *    gasPrice: Big {
-     *    s: 1,
-     *    e: 10,
-     *    c: [
-     *    4, 8, 5, 9, 2,
-     *    4, 2, 6, 8, 5,
-     *    8
-     *    ],
-     *    constructor: <ref *1> [Function: Big] {
-     *    DP: 20,
-     *    RM: 1,
-     *    NE: -7,
-     *    PE: 21,
-     *    strict: false,
-     *    roundDown: 0,
-     *    roundHalfUp: 1,
-     *    roundHalfEven: 2,
-     *    roundUp: 3,
-     *    Big: [Circular *1],
-     *    default: [Circular *1]
-     *    }
-     *    },
-     *    hash: '0x9014ae6ef92464338355a79e5150e542ff9a83e2323318b21f40d6a3e65b4789',
-     *    input: '0x83259f170000000000000000000000000000000000000000000000000000000000000080000000000000000000000000dfd9de5f6fa60bd70636c0900752e93a6144aed400000000000000000000000000000000000000000000000000000000000000c0000000000000000000000000000000000000000000000000000000000000024000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000003000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000009e99ad11a214fd016b19dc3648678c5944859ae292b21c24ca94f857836c4596f1950c82dd0c23dd621af4763edc2f66466e63c5df9de0c1107b1cd16bf460fe93e43fd308e3444bc79c3d88a4cb961dc8367ab6ad048867afc76d193bca99cf3a068864ed4a7df1dbf1d4c52238eced3e5e05644b4040fc2b3ccb8557b0e99fff6131305a0ea2b8061b90bd418db5bbdd2e92129f52d93f90531465e309c4caec5b85285822b6196398d36f16f511811b61bbda6461e80e29210cd303118bdcee8df6fa0505ffbe8642094fd2ba4dd458496fe3b459ac880bbf71877c713e969ccf5ed7efab8a84ebc07e3939901371ca427e1192e455a8f35a6a1d7ad09e1475dd1758b36fa631dab5d70e99316b23c4c43094188d360cd9c3457355904e07c00000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000162074a7047f',
-     *    maxFeePerGas: Big {
-     *    s: 1,
-     *    e: 10,
-     *    c: [
-     *    6, 7, 6, 8, 1,
-     *    2, 6, 1, 6, 1,
-     *    8
-     *    ],
-     *    constructor: <ref *1> [Function: Big] {
-     *    DP: 20,
-     *    RM: 1,
-     *    NE: -7,
-     *    PE: 21,
-     *    strict: false,
-     *    roundDown: 0,
-     *    roundHalfUp: 1,
-     *    roundHalfEven: 2,
-     *    roundUp: 3,
-     *    Big: [Circular *1],
-     *    default: [Circular *1]
-     *    }
-     *    },
-     *    maxPriorityFeePerGas: Big {
-     *    s: 1,
-     *    e: 9,
-     *    c: [ 1, 5 ],
-     *    constructor: <ref *1> [Function: Big] {
-     *    DP: 20,
-     *    RM: 1,
-     *    NE: -7,
-     *    PE: 21,
-     *    strict: false,
-     *    roundDown: 0,
-     *    roundHalfUp: 1,
-     *    roundHalfEven: 2,
-     *    roundUp: 3,
-     *    Big: [Circular *1],
-     *    default: [Circular *1]
-     *    }
-     *    },
-     *    nonce: 129,
-     *    r: '0x59a7c15b12c18cd68d6c440963d959bff3e73831ffc938e75ecad07f7ee43fbc',
-     *    s: '0x1ebaf05f0d9273b16c2a7748b150a79d22533a8cd74552611cbe620fee3dcf1c',
-     *    to: '0x39B72d136ba3e4ceF35F48CD09587ffaB754DD8B',
-     *    transactionIndex: 29,
-     *    type: 2,
-     *    v: 0,
-     *    value: Big {
-     *    s: 1,
-     *    e: 0,
-     *    c: [ 0 ],
-     *    constructor: <ref *1> [Function: Big] {
-     *    DP: 20,
-     *    RM: 1,
-     *    NE: -7,
-     *    PE: 21,
-     *    strict: false,
-     *    roundDown: 0,
-     *    roundHalfUp: 1,
-     *    roundHalfEven: 2,
-     *    roundUp: 3,
-     *    Big: [Circular *1],
-     *    default: [Circular *1]
-     *    }
-     *    },
-     *    confirmations: 1210
-     *    }
+     * // {
+     * //   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) {
@@ -207,12 +165,64 @@ class BaseProvider {
         });
     }
     /**
-     * Gives information about a transaction that has already been mined. Includes additional information beyond what's provided by `getTransaction()`
+     * Gives information about a transaction that has already been mined. Includes additional information beyond what's provided by [`getTransaction`](/docs/api/modules#gettransaction).
      *
-     * * Similar to [`ethers.provider.getTransactionReceipt`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getTransactionReceipt), some information not included
+     * * [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* () {
@@ -227,129 +237,109 @@ class BaseProvider {
         });
     }
     /**
-     * Returns the transaction count from genesis up to specified blockTag
+     * Returns the number of sent transactions by an address, from genesis (or as far back as a provider looks) up to specified block.
      *
-     * * Same as `ethers.provider.getTransactionCount`
-     * * Same as `web3.eth.getTransactionCount`
+     * * [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
-     * ```js
-     * const address = '0x71660c4005ba85c37ccec55d0c4493e66fe775d3';
-     *  await provider
-     *   .getTransactionCount(address, 'latest')
+     * ```javascript
+     * await provider.getTransactionCount('0x71660c4005ba85c37ccec55d0c4493e66fe775d3');
      * // 1060000
      * ```
-     *
      * @example
-     * ```js
-     *  await provider
-     *   .getTransactionCount(address)
-     * // 1053312
+     * ```javascript
+     * await provider.getTransactionCount('0x71660c4005ba85c37ccec55d0c4493e66fe775d3', 'latest');
+     * // 1060000
      * ```
-     *
      * @example
-     * ```js
-     *  await provider
-     *   .getTransactionCount(address, 14649390)
+     * ```javascript
+     * await provider.getTransactionCount('0x71660c4005ba85c37ccec55d0c4493e66fe775d3', 14649390);
      * // 1053312
      * ```
      */
     getTransactionCount(address, blockTag = 'latest') {
         return __awaiter(this, void 0, void 0, function* () {
-            if (typeof blockTag === 'number') {
-                blockTag = `0x${blockTag.toString(16)}`;
-            }
+            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.
-     * Same as `web3.eth.getBlock` and `ethers.providers.getBlock`
+     * Gets information about a certain block, optionally with full transaction objects.
      *
-     * @param timeFrame The number, hash, or text-based description ('latest', 'earliest', or 'pending') of the block to collect information on.
+     * * [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
-     * ```js
-     * await provider.getBlock(14645431);
+     * ```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: [],
+     * // }
      * ```
-     *
-     * @example
-     * ```js
-     * await provider.getBlock('0x3e5cea9c2be7e0ab4b0aa04c24dafddc37571db2d2d345caf7f88b3366ece0cf');
-     * ```
-     *
-     * @example
-     * ```js
-     * await provider.getBlock('latest');
-     * {
-     *   number: 4232826,
-     *   hash: '0x93211a1cd17e154b183565ec685254a03f844a8e34824a46ce1bdd6753dcb669',
-     *   parentHash: '0x1b32bfcba1bb2a57f56e166a3bb06875a1978992999dfc8828397b4c1526f472',
-     *   sha3Uncles: '0x0fb399c67bb5a071ec8a22549223215ab76b7d4009941c9c37aa3c3936010463',
-     *   logsBloom: '0x00000000000000000000101000000000020000000000000000000000000000000000400000010000000000000000000000000000010000000008800000000800000000200000000000000000000000000000000000000000000002000000000000000000000000000040000000000040000000000000000000000000000000000000000000000001000000000004000000000010000000000000000020000000000000000200100020000000000000000080000000000080001000000000000000000001040000000000000000008000000020010100000000200000100000000000000000000000002000000080000000020400000000002000200000000000',
-     *   transactionsRoot: '0xc43b3f13e1fe810e34d3a26ffe465b72c7063a5c70a02de2c78e91e4d10bd9fb',
-     *   stateRoot: '0x04d7bc816537ea7ef3a16e76c9879d29f34f99d4154273c2e98e012a31bad745',
-     *   receiptsRoot: '0x89c6f781ceac0bd49c4d9aa9115df4a5d4dd0e0220ff7668012f15bc04222c6b',
-     *   miner: '0x31fe561eb2c628cD32Ec52573D7c4b7E4C278Bfa',
-     *   difficulty: '1300907486001755331049',
-     *   totalDifficulty: '5989929395521171616186006183',
-     *   extraData: '0xce018c495249532d62613031656132',
-     *   size: 5416,
-     *   gasLimit: 6800000,
-     *   gasUsed: 202955,
-     *   timestamp: 1649884910,
-     *   transactions: [
-     *     '0x6b34a59c7b9aead24fa6dad782f8a3ad84ed4a23ee09bcbf0bcf880840fbbe20',
-     *     '0x9a3851ca24d5336c6a0d48aba2c4b4769d7a672c9b01729c5eb9924efd1b19a7',
-     *     '0xc3ed3d198b62f2f3427ebfa3bbd0fcada4e3c0c189e4464e7eeceb403c75981e'
-     *   ],
-     *   uncles: [
-     *     '0x0c567c054e98153f10d651fbbc018891c1dd9d62a9ffd998e87678803e95b6ed',
-     *     '0xb7d69389dbfb057c6fcb4bc0582d46a2ba01170703f0dadf8cd1462b83e88753',
-     *     '0xd5f74ccd0ad4c58b3161e8c2c507c264231e5f28925061b809c02e5e4bb6db28'
-     *   ],
-     *   minimumGasPrice: '0x387ee40',
-     *   bitcoinMergedMiningHeader: '0x04000020e8567ed3d2480e15a1dd1b4335e4732ae343c037e4fd03000000000000000000ed10a8340d163d3e813bdd430f902f4e5a56828dc62313b2e23797c0be6b8516eb3e576297d8091735884f42',
-     *   bitcoinMergedMiningCoinbaseTransaction: '0x0000000000000140e910128fda7bac502dc5e0573bbaf12de8e2524f70c22f7bd160dedcb19a2521002b6a2952534b424c4f434b3ae493303f597fa368c0ccc4f8aceabf1c315bb7c9a07605c073a89f260040967aace6a7d9',
-     *   bitcoinMergedMiningMerkleProof: '0xdf63a3d7eb6fbcfb301311faa46e9a15b0408bb1a04e284daee86c273c1dfd65ede23f3170f806e9e0f4cef7ba6b56aa37470d9c23f96ec8e43d08b58645919c5e10bcb892897a731f8f9ce79c72dc0e390896bcd6c67bb38c0bdb72982b6cf05519968d76673572c3f3ef3a08b0ddb464863f1788f7cdbaad3fe44a8a8af576d430ac282fe28852c16df198ca96cc5f71a50695912efe1a836e8442be69e31b6d6f973da2818bce9a3a1c2d9be0671aee9a7776e398d6a03d1e178e20d84646004a3d03c0501334e629d9146aa6a01316dcbaa289df6e6c5e3090cadaddff22699cfc7ff09512fc0d65c5062f17c98561ce3c9510de210d9d654cf99f8d756ff37c9fa21e7122ee8cadb923341690845d572921425f2bd7e044558b7e07983ac4df28928028b0c13c3624dc7a965af8091b0cecc845bf7da5308c03b2c97d607f6706a599f802025894435f1d76ea4e67cc2fc4e1559f1206f559a24633de0f',
-     *   hashForMergedMining: '0xe493303f597fa368c0ccc4f8aceabf1c315bb7c9a07605c073a89f260040967a',
-     *   paidFees: '0xc0744dcb7a0',
-     *   cumulativeDifficulty: '0x1190930db285269e582'
-     *   }
-     *```
      */
     getBlock(timeFrame = 'latest', returnTransactionObjects = false) {
         return __awaiter(this, void 0, void 0, function* () {
-            let rpcTimeFrame;
             let type = 'Number';
-            if (typeof timeFrame === 'number') {
-                // exact block numbers require hex string format
-                rpcTimeFrame = `0x${timeFrame.toString(16)}`;
-            }
-            else if (timeFrame.startsWith('0x')) {
-                rpcTimeFrame = timeFrame;
+            if (typeof timeFrame === 'string' && timeFrame.length === 66) {
                 // use endpoint that accepts string
                 type = 'Hash';
             }
             else {
-                // "latest", "earliest", "pending", or hex string require no manipulation
-                rpcTimeFrame = timeFrame;
+                timeFrame = prepBlockTag(timeFrame);
             }
             const rpcBlock = (yield this.post((0, fetchers_1.buildRPCPostBody)(`eth_getBlockBy${type}`, [
-                rpcTimeFrame,
+                timeFrame,
                 returnTransactionObjects,
             ])));
             return (0, clean_block_1.cleanBlock)(rpcBlock, returnTransactionObjects);
         });
     }
     /**
-     * Returns the current gas price in wei as TinyBig
-     * Same as `ethers.provider.getGasPrice`
+     * 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* () {
@@ -358,32 +348,60 @@ class BaseProvider {
         });
     }
     /**
-     * Returns the balance of the account in wei as TinyBig
-     * * Same as [`ethers.provider.getBalance`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getBalance)
-     * * Same as `web3.eth.getBalance`
+     * 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
-     * ```js
-     *  await provider
-     *   .getBalance('0x7cB57B5A97eAbe94205C07890BE4c1aD31E486A8')
-     *   .then((balance) => console.log(balance.toString()));
-     * // "28798127851528138"
+     * ```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, but after being mined affected relevant state.
+     * An estimate may not be accurate since there could be another transaction on the network that was not accounted for.
      *
-     * * Same as ["estimateGas" in ethers.js](https://docs.ethers.io/v5/api/providers/provider/#Provider-estimateGas)
+     * * [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
-     * ```js
+     * ```javascript
      * await provider.estimateGas({
      *   // Wrapped ETH address
      *   to: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
@@ -391,15 +409,104 @@ class BaseProvider {
      *   value: etherToWei('1.0').toHexString(),
      * });
      * // { TinyBig: "27938" }
-     *
      * ```
-     * */
+     */
     estimateGas(transaction) {
         return __awaiter(this, void 0, void 0, function* () {
-            const body = (0, fetchers_1.buildRPCPostBody)('eth_estimateGas', [transaction]);
-            const gasUsed = (yield this.post(body));
+            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;