essential-eth 0.4.9 → 0.5.0

package/lib/cjs/classes/utils/clean-block.d.ts

@@ -1,6 +1,6 @@
-import { Block } from '../..';
+import { BlockResponse } from '../..';
 import { RPCBlock } from '../../types/Block.types';
 /**
- * Converts hex to decimal and checksum-addresses all addresses
+ * Converts RPC block response to more JS-friendly format
  */
-export declare function cleanBlock(block: RPCBlock, returnTransactionObjects: boolean): Block;
+export declare function cleanBlock(block: RPCBlock, returnTransactionObjects: boolean): BlockResponse;

package/lib/cjs/classes/utils/clean-block.js

@@ -5,7 +5,7 @@ const __1 = require("../..");
 const clean_transaction_1 = require("./clean-transaction");
 const hex_to_decimal_1 = require("./hex-to-decimal");
 /**
- * Converts hex to decimal and checksum-addresses all addresses
+ * Converts RPC block response to more JS-friendly format
  */
 function cleanBlock(block, returnTransactionObjects) {
     const cleanedBlock = Object.assign({}, block);
@@ -36,8 +36,9 @@ function cleanBlock(block, returnTransactionObjects) {
     });
     // for all full transactions
     if (returnTransactionObjects) {
+        const txns = block.transactions;
         // could be renamed "cleanTransaction" in the future
-        cleanedBlock.transactions.forEach((transaction, index) => {
+        txns.forEach((transaction, index) => {
             cleanedBlock.transactions[index] = (0, clean_transaction_1.cleanTransaction)(transaction);
         });
     }

package/lib/cjs/classes/utils/clean-transaction.d.ts

@@ -1,5 +1,5 @@
-import { RPCTransaction, Transaction } from '../../types/Transaction.types';
+import { RPCTransaction, TransactionResponse } from '../../types/Transaction.types';
 /**
- * Converts hex to decimal and checksum-addresses all addresses
+ * Converts RPC transaction response to more JS-friendly format
  */
-export declare function cleanTransaction(transaction: RPCTransaction): Transaction;
+export declare function cleanTransaction(transaction: RPCTransaction): TransactionResponse;

package/lib/cjs/classes/utils/clean-transaction.js

@@ -4,7 +4,7 @@ exports.cleanTransaction = void 0;
 const __1 = require("../..");
 const hex_to_decimal_1 = require("./hex-to-decimal");
 /**
- * Converts hex to decimal and checksum-addresses all addresses
+ * Converts RPC transaction response to more JS-friendly format
  */
 function cleanTransaction(transaction) {
     const cleanedTransaction = Object.assign({}, transaction);
@@ -15,22 +15,26 @@ function cleanTransaction(transaction) {
             return;
         switch (key) {
             case 'blockNumber':
-            case 'gas':
+            case 'chainId':
             case 'nonce':
             case 'transactionIndex':
             case 'type':
+            case 'v':
                 cleanedTransaction[key] = Number((0, hex_to_decimal_1.hexToDecimal)(transaction[key]));
                 break;
-            case 'gasPrice':
-            case 'value':
-                cleanedTransaction[key] = (0, hex_to_decimal_1.hexToDecimal)(transaction[key]);
-                break;
             case 'from':
             case 'to':
                 if (transaction[key]) {
                     cleanedTransaction[key] = (0, __1.toChecksumAddress)(transaction[key]);
                 }
                 break;
+            case 'value':
+            case 'gas':
+            case 'gasPrice':
+            case 'maxFeePerGas':
+            case 'maxPriorityFeePerGas':
+                cleanedTransaction[key] = (0, __1.tinyBig)((0, hex_to_decimal_1.hexToDecimal)(transaction[key]));
+                break;
         }
     });
     return cleanedTransaction;

package/lib/cjs/classes/utils/fetchers.d.ts

@@ -1,9 +1,9 @@
 export declare function post(url: string, body: Record<string, unknown>): Promise<any>;
-declare type RPCMethodName = 'eth_getBlockByNumber' | 'eth_call' | 'eth_chainId' | 'eth_gasPrice';
-export declare function buildRPCPostBody(method: RPCMethodName, params: any[]): {
+declare type RPCMethodName = 'eth_getBlockByNumber' | 'eth_call' | 'eth_chainId' | 'eth_gasPrice' | 'eth_getBalance' | 'eth_getTransactionByHash';
+export declare function buildRPCPostBody(method: RPCMethodName, params: unknown[]): {
     jsonrpc: string;
     id: number;
     method: RPCMethodName;
-    params: any[];
+    params: unknown[];
 };
 export {};

package/lib/cjs/index.d.ts

@@ -1,12 +1,15 @@
 import { Contract } from './classes/Contract';
 import { JsonRpcProvider, jsonRpcProvider } from './providers/JsonRpcProvider';
 import { tinyBig, TinyBig } from './shared/tiny-big/tiny-big';
-import { Block } from './types/Block.types';
+import { BlockResponse } from './types/Block.types';
 import { ContractTypes, JSONABI, JSONABIArgument } from './types/Contract.types';
 import { Network } from './types/Network.types';
-import { Transaction } from './types/Transaction.types';
+import { TransactionResponse } from './types/Transaction.types';
+import { etherToGwei } from './utils/ether-to-gwei';
 import { etherToWei } from './utils/ether-to-wei';
+import { gweiToEther } from './utils/gwei-to-ether';
+import { hexZeroPad } from './utils/hex-zero-pad';
 import { isAddress } from './utils/is-address';
 import { toChecksumAddress } from './utils/to-checksum-address';
 import { weiToEther } from './utils/wei-to-ether';
-export { etherToWei, isAddress, jsonRpcProvider, JsonRpcProvider, tinyBig, toChecksumAddress, weiToEther, Contract, TinyBig, Block, ContractTypes, JSONABI, JSONABIArgument, Network, Transaction, };
+export { etherToWei, etherToGwei, isAddress, jsonRpcProvider, JsonRpcProvider, tinyBig, toChecksumAddress, weiToEther, gweiToEther, hexZeroPad, Contract, TinyBig, BlockResponse, ContractTypes, JSONABI, JSONABIArgument, Network, TransactionResponse, };

package/lib/cjs/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TinyBig = exports.Contract = exports.weiToEther = exports.toChecksumAddress = exports.tinyBig = exports.JsonRpcProvider = exports.jsonRpcProvider = exports.isAddress = exports.etherToWei = void 0;
+exports.TinyBig = exports.Contract = exports.hexZeroPad = exports.gweiToEther = exports.weiToEther = exports.toChecksumAddress = exports.tinyBig = exports.JsonRpcProvider = exports.jsonRpcProvider = exports.isAddress = exports.etherToGwei = exports.etherToWei = void 0;
 const Contract_1 = require("./classes/Contract");
 Object.defineProperty(exports, "Contract", { enumerable: true, get: function () { return Contract_1.Contract; } });
 const JsonRpcProvider_1 = require("./providers/JsonRpcProvider");
@@ -9,8 +9,14 @@ Object.defineProperty(exports, "jsonRpcProvider", { enumerable: true, get: funct
 const tiny_big_1 = require("./shared/tiny-big/tiny-big");
 Object.defineProperty(exports, "tinyBig", { enumerable: true, get: function () { return tiny_big_1.tinyBig; } });
 Object.defineProperty(exports, "TinyBig", { enumerable: true, get: function () { return tiny_big_1.TinyBig; } });
+const ether_to_gwei_1 = require("./utils/ether-to-gwei");
+Object.defineProperty(exports, "etherToGwei", { enumerable: true, get: function () { return ether_to_gwei_1.etherToGwei; } });
 const ether_to_wei_1 = require("./utils/ether-to-wei");
 Object.defineProperty(exports, "etherToWei", { enumerable: true, get: function () { return ether_to_wei_1.etherToWei; } });
+const gwei_to_ether_1 = require("./utils/gwei-to-ether");
+Object.defineProperty(exports, "gweiToEther", { enumerable: true, get: function () { return gwei_to_ether_1.gweiToEther; } });
+const hex_zero_pad_1 = require("./utils/hex-zero-pad");
+Object.defineProperty(exports, "hexZeroPad", { enumerable: true, get: function () { return hex_zero_pad_1.hexZeroPad; } });
 const is_address_1 = require("./utils/is-address");
 Object.defineProperty(exports, "isAddress", { enumerable: true, get: function () { return is_address_1.isAddress; } });
 const to_checksum_address_1 = require("./utils/to-checksum-address");

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

@@ -1,17 +1,64 @@
 import { TinyBig } from '../shared/tiny-big/tiny-big';
-import { Block } from '../types/Block.types';
+import { BlockResponse, BlockTag } from '../types/Block.types';
 import { Network } from '../types/Network.types';
+import { TransactionResponse } from '../types/Transaction.types';
 export declare class JsonRpcProvider {
     /**
-     * The URL to your Eth node. Consider POKT or Infura
+     * @ignore
      */
     readonly _rpcUrl: string;
+    /**
+     * @ignore
+     */
+    private post;
+    /**
+     * @param rpcUrl The URL to your Eth node. Consider POKT or Infura
+     */
     constructor(rpcUrl?: string);
     /**
      * Returns the block requested
      * Same as `web3.eth.getBlock`
+     * @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' | 'earliest' | 'pending' | number, returnTransactionObjects?: boolean): Promise<Block>;
+    getBlock(timeFrame: BlockTag, returnTransactionObjects?: boolean): Promise<BlockResponse>;
     /**
      * Returns the network this provider is connected to
      */
@@ -21,8 +68,156 @@ export declare class JsonRpcProvider {
      * Same as `ethers.provider.getGasPrice`
      */
     getGasPrice(): Promise<TinyBig>;
+    /**
+     * Returns the balance of the account in wei as TinyBig
+     * Same as `ethers.provider.getBalance`
+     * Same as `web3.eth.getBalance`
+     *
+     * @example
+     * ```js
+     *  await provider
+     *   .getBalance('0x7cB57B5A97eAbe94205C07890BE4c1aD31E486A8')
+     *   .then((balance) => console.log(balance.toString()));
+     * // "28798127851528138"
+     * ```
+     */
+    getBalance(address: string, blockTag?: BlockTag): Promise<TinyBig>;
+    /**
+     * Similar to `ethers.provider.getTransaction`, some information not included
+     *
+     * @params hash A transaction hash
+     * @returns information about one transaction
+     * @example
+     * ```js
+     * 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
+     *    }
+     * ```
+     */
+    getTransaction(hash: string): Promise<TransactionResponse>;
 }
 /**
  * Helper function to avoid "new"
+ *
+ * @example
+ * ```javascript
+ * jsonRpcProvider().getBlock('latest').then(block => {
+ *   console.log(block.number);
+ * })
+ * // 14530496
+ * ```
  */
 export declare function jsonRpcProvider(rpcUrl?: string): JsonRpcProvider;

package/lib/cjs/providers/JsonRpcProvider.js

@@ -14,19 +14,66 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.jsonRpcProvider = exports.JsonRpcProvider = void 0;
 const clean_block_1 = require("../classes/utils/clean-block");
+const clean_transaction_1 = require("../classes/utils/clean-transaction");
 const fetchers_1 = require("../classes/utils/fetchers");
 const hex_to_decimal_1 = require("../classes/utils/hex-to-decimal");
 const tiny_big_1 = require("../shared/tiny-big/tiny-big");
 const chains_info_1 = __importDefault(require("./utils/chains-info"));
 class JsonRpcProvider {
+    /**
+     * @param rpcUrl The URL to your Eth node. Consider POKT or Infura
+     */
     constructor(rpcUrl) {
+        /**
+         * @ignore
+         */
+        this.post = (body) => (0, fetchers_1.post)(this._rpcUrl, body);
         this._rpcUrl = rpcUrl || 'https://free-eth-node.com/api/eth';
     }
     /**
      * Returns the block requested
      * Same as `web3.eth.getBlock`
+     * @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 /* block number as integer */, returnTransactionObjects = false) {
+    getBlock(timeFrame, returnTransactionObjects = false) {
         return __awaiter(this, void 0, void 0, function* () {
             let rpcTimeFrame;
             if (typeof timeFrame === 'number') {
@@ -37,14 +84,11 @@ class JsonRpcProvider {
                 // "latest", "earliest", and "pending" require no manipulation
                 rpcTimeFrame = timeFrame;
             }
-            const req = () => __awaiter(this, void 0, void 0, function* () {
-                return yield (0, fetchers_1.post)(this._rpcUrl, (0, fetchers_1.buildRPCPostBody)('eth_getBlockByNumber', [
-                    rpcTimeFrame,
-                    returnTransactionObjects,
-                ]));
-            });
-            const nodeResponse = (yield req());
-            return (0, clean_block_1.cleanBlock)(nodeResponse, returnTransactionObjects);
+            const rpcBlock = (yield this.post((0, fetchers_1.buildRPCPostBody)('eth_getBlockByNumber', [
+                rpcTimeFrame,
+                returnTransactionObjects,
+            ])));
+            return (0, clean_block_1.cleanBlock)(rpcBlock, returnTransactionObjects);
         });
     }
     /**
@@ -52,11 +96,8 @@ class JsonRpcProvider {
      */
     getNetwork() {
         return __awaiter(this, void 0, void 0, function* () {
-            const req = () => __awaiter(this, void 0, void 0, function* () {
-                return yield (0, fetchers_1.post)(this._rpcUrl, (0, fetchers_1.buildRPCPostBody)('eth_chainId', []));
-            });
-            const nodeResponse = (yield req());
-            const chainId = (0, hex_to_decimal_1.hexToDecimal)(nodeResponse);
+            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),
@@ -71,17 +112,179 @@ class JsonRpcProvider {
      */
     getGasPrice() {
         return __awaiter(this, void 0, void 0, function* () {
-            const req = () => __awaiter(this, void 0, void 0, function* () {
-                return yield (0, fetchers_1.post)(this._rpcUrl, (0, fetchers_1.buildRPCPostBody)('eth_gasPrice', []));
-            });
-            const nodeResponse = (yield req()); /* '0x153cfb1ad0' */
-            return (0, tiny_big_1.tinyBig)((0, hex_to_decimal_1.hexToDecimal)(nodeResponse));
+            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 as TinyBig
+     * Same as `ethers.provider.getBalance`
+     * Same as `web3.eth.getBalance`
+     *
+     * @example
+     * ```js
+     *  await provider
+     *   .getBalance('0x7cB57B5A97eAbe94205C07890BE4c1aD31E486A8')
+     *   .then((balance) => console.log(balance.toString()));
+     * // "28798127851528138"
+     * ```
+     */
+    getBalance(address, blockTag = 'latest') {
+        return __awaiter(this, void 0, void 0, function* () {
+            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));
+        });
+    }
+    /**
+     * Similar to `ethers.provider.getTransaction`, some information not included
+     *
+     * @params hash A transaction hash
+     * @returns information about one transaction
+     * @example
+     * ```js
+     * 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
+     *    }
+     * ```
+     */
+    getTransaction(hash) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const [rpcTransaction, blockNumber] = yield Promise.all([
+                this.post((0, fetchers_1.buildRPCPostBody)('eth_getTransactionByHash', [hash])),
+                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;
         });
     }
 }
 exports.JsonRpcProvider = JsonRpcProvider;
 /**
  * Helper function to avoid "new"
+ *
+ * @example
+ * ```javascript
+ * jsonRpcProvider().getBlock('latest').then(block => {
+ *   console.log(block.number);
+ * })
+ * // 14530496
+ * ```
  */
 function jsonRpcProvider(rpcUrl) {
     return new JsonRpcProvider(rpcUrl);

package/lib/cjs/providers/test/rpc-urls.d.ts

@@ -1,3 +1,10 @@
 export declare const fakeUrls: {
     readonly notRPCButRealHttp: "https://httpstat.us/200";
 };
+export declare const rpcUrls: {
+    mainnet: string;
+    gno: string;
+    bnb: string;
+    arb1: string;
+    gor: string;
+};