essential-eth 0.5.1 → 0.5.4-alpha.0

package/lib/cjs/providers/JsonRpcProvider.js

@@ -1,277 +1,25 @@
 "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.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 {
+const BaseProvider_1 = require("./BaseProvider");
+class JsonRpcProvider extends BaseProvider_1.BaseProvider {
     /**
-     * @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'
-     *   }
-     *```
+     * @ignore
      */
-    getBlock(timeFrame = 'latest', returnTransactionObjects = false) {
-        return __awaiter(this, void 0, void 0, function* () {
-            let rpcTimeFrame;
-            if (typeof timeFrame === 'number') {
-                // exact block numbers require hex string format
-                rpcTimeFrame = `0x${timeFrame.toString(16)}`;
-            }
-            else {
-                // "latest", "earliest", and "pending" require no manipulation
-                rpcTimeFrame = timeFrame;
-            }
-            const rpcBlock = (yield this.post((0, fetchers_1.buildRPCPostBody)('eth_getBlockByNumber', [
-                rpcTimeFrame,
-                returnTransactionObjects,
-            ])));
-            return (0, clean_block_1.cleanBlock)(rpcBlock, returnTransactionObjects);
-        });
+    selectRpcUrl() {
+        return this._rpcUrls[0];
     }
     /**
-     * Returns the network this provider is connected to
+     * @ignore
      */
-    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
-            };
-        });
+    post(body) {
+        return this._post(body);
     }
     /**
-     * Returns the current gas price in wei as TinyBig
-     * Same as `ethers.provider.getGasPrice`
-     */
-    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 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
-     *    }
-     * ```
+     * @param rpcUrl The URL to your Eth node. Consider POKT or Infura
      */
-    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;
-        });
+    constructor(rpcUrl = 'https://free-eth-node.com/api/eth') {
+        super([rpcUrl]);
     }
 }
 exports.JsonRpcProvider = JsonRpcProvider;

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

@@ -3,6 +3,7 @@ export declare const fakeUrls: {
 };
 export declare const rpcUrls: {
     mainnet: string;
+    matic: string;
     gno: string;
     bnb: string;
     arb1: string;

package/lib/cjs/providers/test/rpc-urls.js

@@ -6,6 +6,7 @@ exports.fakeUrls = {
 };
 exports.rpcUrls = {
     mainnet: `${process.env.RPC_ORIGIN}/api/eth`,
+    matic: `${process.env.RPC_ORIGIN}/api/MATIC`,
     gno: `${process.env.RPC_ORIGIN}/api/gno`,
     bnb: `${process.env.RPC_ORIGIN}/api/bnb`,
     arb1: `${process.env.RPC_ORIGIN}/api/arb1`,

package/lib/cjs/providers/utils/chains-info.d.ts

@@ -61,6 +61,7 @@ declare const _default: {
     "67": string[];
     "68": string[];
     "69": string[];
+    "70": string[];
     "71": string[];
     "74": string[];
     "76": string[];
@@ -217,6 +218,7 @@ declare const _default: {
     "2221": string[];
     "2223": string[];
     "2559": string[];
+    "2569": string[];
     "3000": string[];
     "3001": string[];
     "3331": string[];
@@ -298,6 +300,7 @@ declare const _default: {
     "60002": string[];
     "60103": string[];
     "62320": string[];
+    "62621": string[];
     "63000": string[];
     "63001": string[];
     "69420": string[];
@@ -343,6 +346,7 @@ declare const _default: {
     "333999": string[];
     "421611": string[];
     "444900": string[];
+    "512512": string[];
     "666666": string[];
     "888888": string[];
     "955305": string[];

package/lib/cjs/providers/utils/chains-info.js

@@ -193,6 +193,9 @@ exports.default = {
     "69": [
         "okov"
     ],
+    "70": [
+        "hsc"
+    ],
     "71": [
         "cfxtest"
     ],
@@ -661,6 +664,9 @@ exports.default = {
     "2559": [
         "ktoc"
     ],
+    "2569": [
+        "tpc"
+    ],
     "3000": [
         "cennz-r"
     ],
@@ -904,6 +910,9 @@ exports.default = {
     "62320": [
         "BKLV"
     ],
+    "62621": [
+        "mtv"
+    ],
     "63000": [
         "ecs"
     ],
@@ -1039,6 +1048,9 @@ exports.default = {
     "444900": [
         "wlkt"
     ],
+    "512512": [
+        "cmp"
+    ],
     "666666": [
         "vpioneer"
     ],

package/lib/cjs/shared/tiny-big/tiny-big.d.ts

@@ -1,7 +1,7 @@
 import Big from 'big.js';
 /**
- * A wrapper around big.js which expands scientific notation and creates a "toHexString" function.
- * This is the return type of every operation on ether, wei, etc.
+ * A wrapper around [big.js](https://github.com/MikeMcl/big.js) which expands scientific notation and creates a "toHexString" function.
+ * * This is the return type of every operation on ether, wei, etc.
  */
 export declare class TinyBig extends Big {
     constructor(value: string | number | TinyBig | Big);

package/lib/cjs/shared/tiny-big/tiny-big.js

@@ -7,8 +7,8 @@ exports.tinyBig = exports.TinyBig = void 0;
 const big_js_1 = __importDefault(require("big.js"));
 const helpers_1 = require("./helpers");
 /**
- * A wrapper around big.js which expands scientific notation and creates a "toHexString" function.
- * This is the return type of every operation on ether, wei, etc.
+ * A wrapper around [big.js](https://github.com/MikeMcl/big.js) which expands scientific notation and creates a "toHexString" function.
+ * * This is the return type of every operation on ether, wei, etc.
  */
 class TinyBig extends big_js_1.default {
     constructor(value) {

package/lib/cjs/utils/bytes.d.ts

@@ -33,12 +33,93 @@ export interface Signature {
     yParityAndS: string;
     compact: string;
 }
+/**
+ * Returns true if and only if value is a valid [Bytes](#bytes) or DataHexString
+ * * Same as [`ethers.utils.isBytesLike`](https://docs.ethers.io/v5/api/utils/bytes/#utils-isBytesLike)
+ *
+ * @example
+ * ```js
+ * isBytesLike([1,2,3]);
+ * // true
+ * ```
+ *
+ * @example
+ * ```js
+ * isBytesLike(false);
+ * // false
+ * ```
+ *
+ * @example
+ * ```js
+ * isBytesLike(new Uint8Array(1));
+ * // true
+ * ```
+ */
 export declare function isBytesLike(value: any): value is BytesLike;
+/**
+ * Returns true if and only if value is a valid [Bytes](#bytes)
+ * * Same as [`ethers.utils.isBytes`](https://docs.ethers.io/v5/api/utils/bytes/#utils-isBytes)
+ *
+ * @example
+ * ```js
+ * isBytes([1,2,3]);
+ * // true
+ * ```
+ *
+ * @example
+ * ```js
+ * isBytes(false);
+ * // false
+ * ```
+ *
+ * @example
+ * ```js
+ * isBytes(new Uint8Array(1));
+ * // true
+ * ```
+ */
 export declare function isBytes(value: any): value is Bytes;
+/**
+ * Converts DataHexStringOrArrayish to a Uint8Array
+ * * Same as [`ethers.utils.arrayify`](https://docs.ethers.io/v5/api/utils/bytes/#utils-arrayify)
+ *
+ * @example
+ * ```js
+ * arrayify(1);
+ * // Uint8Array(1) [ 1 ]
+ * ```
+ *
+ * @example
+ * ```js
+ * arrayify(0x1234);
+ * // Uint8Array(2) [ 18, 52 ]
+ * ```
+ *
+ * @example
+ * ```js
+ * arrayify('0x1', { hexPad: 'right' });
+ * // Uint8Array(1) [ 16 ]
+ * ```
+ */
 export declare function arrayify(value: BytesLike | Hexable | number, options?: DataOptions): Uint8Array;
-export declare function concat(items: ReadonlyArray<BytesLike>): Uint8Array;
+/**
+ * Concatenates all the BytesLike in arrayOfBytesLike into a single Uint8Array.
+ * * Same as [`ethers.utils.concat`](https://docs.ethers.io/v5/api/utils/bytes/#utils-concat)
+ *
+ * @example
+ * ```js
+ * concat([0, 1]);
+ * // Uint8Array(2) [ 0, 1 ]
+ * ```
+ */
+export declare function concat(arrayOfBytesLike: ReadonlyArray<BytesLike>): Uint8Array;
 export declare function stripZeros(value: BytesLike): Uint8Array;
 export declare function zeroPad(value: BytesLike, length: number): Uint8Array;
+/**
+ * Returns true if and only if object is a valid hex string.
+ * If length is specified and object is not a valid DataHexString of length bytes, an InvalidArgument error is thrown.
+ * * Same as [`ethers.utils.isHexString`](https://docs.ethers.io/v5/api/utils/bytes/#utils-isHexString)
+ */
 export declare function isHexString(value: any, length?: number): boolean;
 /**
  * @example

package/lib/cjs/utils/bytes.js

@@ -3,10 +3,31 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.hexZeroPad = exports.hexStripZeros = exports.hexValue = exports.hexConcat = exports.hexDataSlice = exports.hexDataLength = exports.hexlify = exports.isHexString = exports.zeroPad = exports.stripZeros = exports.concat = exports.arrayify = exports.isBytes = exports.isBytesLike = void 0;
 const logger_1 = require("../logger/logger");
-///////////////////////////////
 function isHexable(value) {
     return !!value.toHexString;
 }
+/**
+ * Returns true if and only if value is a valid [Bytes](#bytes) or DataHexString
+ * * Same as [`ethers.utils.isBytesLike`](https://docs.ethers.io/v5/api/utils/bytes/#utils-isBytesLike)
+ *
+ * @example
+ * ```js
+ * isBytesLike([1,2,3]);
+ * // true
+ * ```
+ *
+ * @example
+ * ```js
+ * isBytesLike(false);
+ * // false
+ * ```
+ *
+ * @example
+ * ```js
+ * isBytesLike(new Uint8Array(1));
+ * // true
+ * ```
+ */
 function isBytesLike(value) {
     return (isHexString(value) && !(value.length % 2)) || isBytes(value);
 }
@@ -14,6 +35,28 @@ exports.isBytesLike = isBytesLike;
 function isInteger(value) {
     return typeof value === 'number' && value == value && value % 1 === 0;
 }
+/**
+ * Returns true if and only if value is a valid [Bytes](#bytes)
+ * * Same as [`ethers.utils.isBytes`](https://docs.ethers.io/v5/api/utils/bytes/#utils-isBytes)
+ *
+ * @example
+ * ```js
+ * isBytes([1,2,3]);
+ * // true
+ * ```
+ *
+ * @example
+ * ```js
+ * isBytes(false);
+ * // false
+ * ```
+ *
+ * @example
+ * ```js
+ * isBytes(new Uint8Array(1));
+ * // true
+ * ```
+ */
 function isBytes(value) {
     if (value == null) {
         return false;
@@ -36,6 +79,28 @@ function isBytes(value) {
     return true;
 }
 exports.isBytes = isBytes;
+/**
+ * Converts DataHexStringOrArrayish to a Uint8Array
+ * * Same as [`ethers.utils.arrayify`](https://docs.ethers.io/v5/api/utils/bytes/#utils-arrayify)
+ *
+ * @example
+ * ```js
+ * arrayify(1);
+ * // Uint8Array(1) [ 1 ]
+ * ```
+ *
+ * @example
+ * ```js
+ * arrayify(0x1234);
+ * // Uint8Array(2) [ 18, 52 ]
+ * ```
+ *
+ * @example
+ * ```js
+ * arrayify('0x1', { hexPad: 'right' });
+ * // Uint8Array(1) [ 16 ]
+ * ```
+ */
 function arrayify(value, options) {
     if (!options) {
         options = {};
@@ -85,8 +150,18 @@ function arrayify(value, options) {
     return logger_1.logger.throwArgumentError('invalid arrayify value', 'value', value);
 }
 exports.arrayify = arrayify;
-function concat(items) {
-    const objects = items.map((item) => arrayify(item));
+/**
+ * Concatenates all the BytesLike in arrayOfBytesLike into a single Uint8Array.
+ * * Same as [`ethers.utils.concat`](https://docs.ethers.io/v5/api/utils/bytes/#utils-concat)
+ *
+ * @example
+ * ```js
+ * concat([0, 1]);
+ * // Uint8Array(2) [ 0, 1 ]
+ * ```
+ */
+function concat(arrayOfBytesLike) {
+    const objects = arrayOfBytesLike.map((item) => arrayify(item));
     const length = objects.reduce((accum, item) => accum + item.length, 0);
     const result = new Uint8Array(length);
     objects.reduce((offset, object) => {
@@ -123,6 +198,11 @@ function zeroPad(value, length) {
     return result;
 }
 exports.zeroPad = zeroPad;
+/**
+ * Returns true if and only if object is a valid hex string.
+ * If length is specified and object is not a valid DataHexString of length bytes, an InvalidArgument error is thrown.
+ * * Same as [`ethers.utils.isHexString`](https://docs.ethers.io/v5/api/utils/bytes/#utils-isHexString)
+ */
 function isHexString(value, length) {
     if (typeof value !== 'string' || !value.match(/^0x[0-9A-Fa-f]*$/)) {
         return false;

package/lib/cjs/utils/solidity-keccak256.js

@@ -3,13 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.solidityKeccak256 = exports.hashKeccak256 = exports.pack = void 0;
 const buffer_1 = require("buffer");
 const sha3_1 = require("sha3");
+const encode_decode_transaction_1 = require("../classes/utils/encode-decode-transaction");
 const logger_1 = require("../logger/logger");
 const tiny_big_1 = require("../shared/tiny-big/tiny-big");
 const bytes_1 = require("./bytes");
 const regexBytes = new RegExp('^bytes([0-9]+)$');
 const regexNumber = new RegExp('^(u?int)([0-9]*)$');
 const regexArray = new RegExp('^(.*)\\[([0-9]*)\\]$');
-const Zeros = '0000000000000000000000000000000000000000000000000000000000000000';
 function _pack(type, value, isArray) {
     switch (type) {
         case 'address':
@@ -55,7 +55,7 @@ function _pack(type, value, isArray) {
             logger_1.logger.throwArgumentError(`invalid value for ${type}`, 'value', value);
         }
         if (isArray) {
-            return (0, bytes_1.arrayify)((value + Zeros).substring(0, 66));
+            return (0, bytes_1.arrayify)((value + encode_decode_transaction_1.hexFalse).substring(0, 66));
         }
         return value;
     }

package/lib/esm/classes/Contract.js

@@ -40,7 +40,7 @@ export class BaseContract {
                             ? estimateGas(data)
                             : null;
                     const req = () => __awaiter(this, void 0, void 0, function* () {
-                        return yield post(this._provider._rpcUrl, buildRPCPostBody('eth_call', [
+                        return yield post(this._provider.selectRpcUrl(), buildRPCPostBody('eth_call', [
                             Object.assign({ to: this._address.toLowerCase(), data }, (decimalGas
                                 ? { gas: `0x${decimalGas.toString(16)}` }
                                 : {})),

package/lib/esm/classes/utils/encode-decode-transaction.d.ts

@@ -1,3 +1,4 @@
 import { JSONABIArgument } from '../../types/Contract.types';
+export declare const hexFalse: string;
 export declare function encodeData(jsonABIArgument: JSONABIArgument, args: any[]): string;
 export declare function decodeRPCResponse(jsonABIArgument: JSONABIArgument, nodeResponse: string): string | number | boolean | import("../..").TinyBig | (string | number | boolean | import("../..").TinyBig)[];

package/lib/esm/classes/utils/encode-decode-transaction.js

@@ -1,8 +1,8 @@
 import { Keccak } from 'sha3';
 import { tinyBig, toChecksumAddress } from '../..';
 import { hexToDecimal } from './hex-to-decimal';
-const hexTrue = '0000000000000000000000000000000000000000000000000000000000000001';
-const hexFalse = '0000000000000000000000000000000000000000000000000000000000000000';
+export const hexFalse = '0'.repeat(64);
+const hexTrue = '0'.repeat(63) + '1';
 function expandType(type) {
     if (type === 'uint[]') {
         return 'uint256[]';

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

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