essential-eth 0.5.1 → 0.5.4-alpha.0

package/lib/esm/index.d.ts

@@ -1,4 +1,5 @@
 import { Contract } from './classes/Contract';
+import { FallthroughProvider } from './providers/FallthroughProvider';
 import { JsonRpcProvider, jsonRpcProvider } from './providers/JsonRpcProvider';
 import { tinyBig, TinyBig } from './shared/tiny-big/tiny-big';
 import { BlockResponse } from './types/Block.types';
@@ -13,4 +14,4 @@ import { toChecksumAddress } from './utils/to-checksum-address';
 import { weiToEther } from './utils/wei-to-ether';
 export * from './utils/bytes';
 export * from './utils/solidity-keccak256';
-export { etherToWei, etherToGwei, isAddress, jsonRpcProvider, JsonRpcProvider, tinyBig, toChecksumAddress, weiToEther, gweiToEther, Contract, TinyBig, BlockResponse, ContractTypes, JSONABI, JSONABIArgument, Network, TransactionResponse, };
+export { etherToWei, etherToGwei, isAddress, jsonRpcProvider, JsonRpcProvider, FallthroughProvider, tinyBig, toChecksumAddress, weiToEther, gweiToEther, Contract, TinyBig, BlockResponse, ContractTypes, JSONABI, JSONABIArgument, Network, TransactionResponse, };

package/lib/esm/index.js

@@ -1,4 +1,5 @@
 import { Contract } from './classes/Contract';
+import { FallthroughProvider } from './providers/FallthroughProvider';
 import { JsonRpcProvider, jsonRpcProvider } from './providers/JsonRpcProvider';
 import { tinyBig, TinyBig } from './shared/tiny-big/tiny-big';
 import { etherToGwei } from './utils/ether-to-gwei';
@@ -9,4 +10,4 @@ import { toChecksumAddress } from './utils/to-checksum-address';
 import { weiToEther } from './utils/wei-to-ether';
 export * from './utils/bytes';
 export * from './utils/solidity-keccak256';
-export { etherToWei, etherToGwei, isAddress, jsonRpcProvider, JsonRpcProvider, tinyBig, toChecksumAddress, weiToEther, gweiToEther, Contract, TinyBig, };
+export { etherToWei, etherToGwei, isAddress, jsonRpcProvider, JsonRpcProvider, FallthroughProvider, tinyBig, toChecksumAddress, weiToEther, gweiToEther, Contract, TinyBig, };

package/lib/esm/logger/package-version.d.ts

@@ -1 +1 @@
-export declare const version = "0.5.1";
+export declare const version = "0.5.4-alpha.0";

package/lib/esm/logger/package-version.js

@@ -1 +1 @@
-export const version = '0.5.1';
+export const version = '0.5.4-alpha.0';

package/lib/esm/providers/BaseProvider.d.ts

@@ -0,0 +1,17 @@
+import { TinyBig } from '../shared/tiny-big/tiny-big';
+import { BlockResponse, BlockTag } from '../types/Block.types';
+import { Network } from '../types/Network.types';
+import { TransactionResponse } from '../types/Transaction.types';
+export declare abstract class BaseProvider {
+    abstract selectRpcUrl(): string;
+    abstract post(body: Record<string, unknown>): Promise<any>;
+    readonly _rpcUrls: string[];
+    protected _post: (body: Record<string, unknown>) => Promise<any>;
+    constructor(rpcUrls: string[]);
+    getNetwork(): Promise<Network>;
+    getTransaction(transactionHash: string): Promise<TransactionResponse>;
+    getTransactionCount(address: string, blockTag?: BlockTag): Promise<number>;
+    getBlock(timeFrame?: BlockTag, returnTransactionObjects?: boolean): Promise<BlockResponse>;
+    getGasPrice(): Promise<TinyBig>;
+    getBalance(address: string, blockTag?: BlockTag): Promise<TinyBig>;
+}

package/lib/esm/providers/BaseProvider.js

@@ -0,0 +1,88 @@
+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());
+    });
+};
+import { cleanBlock } from '../classes/utils/clean-block';
+import { cleanTransaction } from '../classes/utils/clean-transaction';
+import { buildRPCPostBody, post } from '../classes/utils/fetchers';
+import { hexToDecimal } from '../classes/utils/hex-to-decimal';
+import { tinyBig } from '../shared/tiny-big/tiny-big';
+import chainsInfo from './utils/chains-info';
+export class BaseProvider {
+    constructor(rpcUrls) {
+        this._rpcUrls = [];
+        this._post = (body) => post(this.selectRpcUrl(), body);
+        this._rpcUrls = rpcUrls;
+    }
+    getNetwork() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const hexChainId = (yield this.post(buildRPCPostBody('eth_chainId', [])));
+            const chainId = hexToDecimal(hexChainId);
+            const info = chainsInfo[chainId];
+            return {
+                chainId: Number(chainId),
+                name: info[0] || 'unknown',
+                ensAddress: info[1] || null,
+            };
+        });
+    }
+    getTransaction(transactionHash) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const [rpcTransaction, blockNumber] = yield Promise.all([
+                this.post(buildRPCPostBody('eth_getTransactionByHash', [transactionHash])),
+                this.getBlock('latest'),
+            ]);
+            const cleanedTransaction = cleanTransaction(rpcTransaction);
+            cleanedTransaction.confirmations =
+                blockNumber.number - cleanedTransaction.blockNumber + 1;
+            return cleanedTransaction;
+        });
+    }
+    getTransactionCount(address, blockTag = 'latest') {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (typeof blockTag === 'number') {
+                blockTag = `0x${blockTag.toString(16)}`;
+            }
+            const transactionCount = (yield this.post(buildRPCPostBody('eth_getTransactionCount', [address, blockTag])));
+            return Number(hexToDecimal(transactionCount));
+        });
+    }
+    getBlock(timeFrame = 'latest', returnTransactionObjects = false) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let rpcTimeFrame;
+            let type = 'Number';
+            if (typeof timeFrame === 'number') {
+                rpcTimeFrame = `0x${timeFrame.toString(16)}`;
+            }
+            else if (timeFrame.startsWith('0x')) {
+                rpcTimeFrame = timeFrame;
+                type = 'Hash';
+            }
+            else {
+                rpcTimeFrame = timeFrame;
+            }
+            const rpcBlock = (yield this.post(buildRPCPostBody(`eth_getBlockBy${type}`, [
+                rpcTimeFrame,
+                returnTransactionObjects,
+            ])));
+            return cleanBlock(rpcBlock, returnTransactionObjects);
+        });
+    }
+    getGasPrice() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const hexGasPrice = (yield this.post(buildRPCPostBody('eth_gasPrice', [])));
+            return tinyBig(hexToDecimal(hexGasPrice));
+        });
+    }
+    getBalance(address, blockTag = 'latest') {
+        return __awaiter(this, void 0, void 0, function* () {
+            const hexBalance = (yield this.post(buildRPCPostBody('eth_getBalance', [address, blockTag])));
+            return tinyBig(hexToDecimal(hexBalance));
+        });
+    }
+}

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

@@ -0,0 +1,12 @@
+import { BaseProvider } from './BaseProvider';
+interface ConstructorOptions {
+    timeoutDuration?: number;
+}
+export declare class FallthroughProvider extends BaseProvider {
+    private rpcUrlCounter;
+    private readonly timeoutDuration;
+    selectRpcUrl(): string;
+    constructor(rpcUrls: string[], options?: ConstructorOptions);
+    post: (body: Record<string, unknown>) => Promise<any>;
+}
+export {};

package/lib/esm/providers/FallthroughProvider.js

@@ -0,0 +1,41 @@
+import { logger } from '../logger/logger';
+import { BaseProvider } from './BaseProvider';
+const promiseTimeout = (prom, time) => Promise.race([
+    prom,
+    new Promise((_r, reject) => setTimeout(() => reject('Promise timed out'), time)),
+]);
+const DEFAULT_TIMEOUT_DURATION = 8000;
+export class FallthroughProvider extends BaseProvider {
+    constructor(rpcUrls, options = {}) {
+        if (!Array.isArray(rpcUrls)) {
+            logger.throwError('Array required', { rpcUrls });
+        }
+        if (rpcUrls.length <= 1) {
+            logger.throwError('More than one rpcUrl is required', { rpcUrls });
+        }
+        super(rpcUrls);
+        this.rpcUrlCounter = 0;
+        this.post = (body) => {
+            const genesisCount = this.rpcUrlCounter;
+            const recursivePostRetry = () => {
+                const genesisRpcUrl = this.selectRpcUrl();
+                const res = promiseTimeout(this._post(body), this.timeoutDuration).catch((e) => {
+                    if (genesisRpcUrl === this.selectRpcUrl()) {
+                        this.rpcUrlCounter =
+                            (this.rpcUrlCounter + 1) % this._rpcUrls.length;
+                    }
+                    if (this.rpcUrlCounter === genesisCount) {
+                        throw e;
+                    }
+                    return recursivePostRetry();
+                });
+                return res;
+            };
+            return recursivePostRetry();
+        };
+        this.timeoutDuration = options.timeoutDuration || DEFAULT_TIMEOUT_DURATION;
+    }
+    selectRpcUrl() {
+        return this._rpcUrls[this.rpcUrlCounter];
+    }
+}

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

@@ -1,15 +1,7 @@
-import { TinyBig } from '../shared/tiny-big/tiny-big';
-import { BlockResponse, BlockTag } from '../types/Block.types';
-import { Network } from '../types/Network.types';
-import { TransactionResponse } from '../types/Transaction.types';
-export declare class JsonRpcProvider {
-    readonly _rpcUrl: string;
-    private post;
+import { BaseProvider } from './BaseProvider';
+export declare class JsonRpcProvider extends BaseProvider {
+    selectRpcUrl(): string;
+    post(body: Record<string, unknown>): Promise<any>;
     constructor(rpcUrl?: string);
-    getBlock(timeFrame?: BlockTag, returnTransactionObjects?: boolean): Promise<BlockResponse>;
-    getNetwork(): Promise<Network>;
-    getGasPrice(): Promise<TinyBig>;
-    getBalance(address: string, blockTag?: BlockTag): Promise<TinyBig>;
-    getTransaction(hash: string): Promise<TransactionResponse>;
 }
 export declare function jsonRpcProvider(rpcUrl?: string): JsonRpcProvider;

package/lib/esm/providers/JsonRpcProvider.js

@@ -1,74 +1,13 @@
-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());
-    });
-};
-import { cleanBlock } from '../classes/utils/clean-block';
-import { cleanTransaction } from '../classes/utils/clean-transaction';
-import { buildRPCPostBody, post } from '../classes/utils/fetchers';
-import { hexToDecimal } from '../classes/utils/hex-to-decimal';
-import { tinyBig } from '../shared/tiny-big/tiny-big';
-import chainsInfo from './utils/chains-info';
-export class JsonRpcProvider {
-    constructor(rpcUrl) {
-        this.post = (body) => post(this._rpcUrl, body);
-        this._rpcUrl = rpcUrl || 'https://free-eth-node.com/api/eth';
+import { BaseProvider } from './BaseProvider';
+export class JsonRpcProvider extends BaseProvider {
+    selectRpcUrl() {
+        return this._rpcUrls[0];
     }
-    getBlock(timeFrame = 'latest', returnTransactionObjects = false) {
-        return __awaiter(this, void 0, void 0, function* () {
-            let rpcTimeFrame;
-            if (typeof timeFrame === 'number') {
-                rpcTimeFrame = `0x${timeFrame.toString(16)}`;
-            }
-            else {
-                rpcTimeFrame = timeFrame;
-            }
-            const rpcBlock = (yield this.post(buildRPCPostBody('eth_getBlockByNumber', [
-                rpcTimeFrame,
-                returnTransactionObjects,
-            ])));
-            return cleanBlock(rpcBlock, returnTransactionObjects);
-        });
+    post(body) {
+        return this._post(body);
     }
-    getNetwork() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const hexChainId = (yield this.post(buildRPCPostBody('eth_chainId', [])));
-            const chainId = hexToDecimal(hexChainId);
-            const info = chainsInfo[chainId];
-            return {
-                chainId: Number(chainId),
-                name: info[0] || 'unknown',
-                ensAddress: info[1] || null,
-            };
-        });
-    }
-    getGasPrice() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const hexGasPrice = (yield this.post(buildRPCPostBody('eth_gasPrice', [])));
-            return tinyBig(hexToDecimal(hexGasPrice));
-        });
-    }
-    getBalance(address, blockTag = 'latest') {
-        return __awaiter(this, void 0, void 0, function* () {
-            const hexBalance = (yield this.post(buildRPCPostBody('eth_getBalance', [address, blockTag])));
-            return tinyBig(hexToDecimal(hexBalance));
-        });
-    }
-    getTransaction(hash) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const [rpcTransaction, blockNumber] = yield Promise.all([
-                this.post(buildRPCPostBody('eth_getTransactionByHash', [hash])),
-                this.getBlock('latest'),
-            ]);
-            const cleanedTransaction = cleanTransaction(rpcTransaction);
-            cleanedTransaction.confirmations =
-                blockNumber.number - cleanedTransaction.blockNumber + 1;
-            return cleanedTransaction;
-        });
+    constructor(rpcUrl = 'https://free-eth-node.com/api/eth') {
+        super([rpcUrl]);
     }
 }
 export function jsonRpcProvider(rpcUrl) {

package/lib/esm/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/esm/providers/test/rpc-urls.js

@@ -3,6 +3,7 @@ export const fakeUrls = {
 };
 export const 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/esm/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/esm/providers/utils/chains-info.js

@@ -189,6 +189,9 @@ export default {
     "69": [
         "okov"
     ],
+    "70": [
+        "hsc"
+    ],
     "71": [
         "cfxtest"
     ],
@@ -657,6 +660,9 @@ export default {
     "2559": [
         "ktoc"
     ],
+    "2569": [
+        "tpc"
+    ],
     "3000": [
         "cennz-r"
     ],
@@ -900,6 +906,9 @@ export default {
     "62320": [
         "BKLV"
     ],
+    "62621": [
+        "mtv"
+    ],
     "63000": [
         "ecs"
     ],
@@ -1035,6 +1044,9 @@ export default {
     "444900": [
         "wlkt"
     ],
+    "512512": [
+        "cmp"
+    ],
     "666666": [
         "vpioneer"
     ],

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

@@ -26,7 +26,7 @@ export interface Signature {
 export declare function isBytesLike(value: any): value is BytesLike;
 export declare function isBytes(value: any): value is Bytes;
 export declare function arrayify(value: BytesLike | Hexable | number, options?: DataOptions): Uint8Array;
-export declare function concat(items: ReadonlyArray<BytesLike>): Uint8Array;
+export declare function concat(arrayOfBytesLike: ReadonlyArray<BytesLike>): Uint8Array;
 export declare function stripZeros(value: BytesLike): Uint8Array;
 export declare function zeroPad(value: BytesLike, length: number): Uint8Array;
 export declare function isHexString(value: any, length?: number): boolean;

package/lib/esm/utils/bytes.js

@@ -77,8 +77,8 @@ export function arrayify(value, options) {
     }
     return logger.throwArgumentError('invalid arrayify value', 'value', value);
 }
-export function concat(items) {
-    const objects = items.map((item) => arrayify(item));
+export 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) => {

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

@@ -1,12 +1,12 @@
 import { Buffer } from 'buffer';
 import { Keccak } from 'sha3';
+import { hexFalse } from '../classes/utils/encode-decode-transaction';
 import { logger } from '../logger/logger';
 import { tinyBig } from '../shared/tiny-big/tiny-big';
 import { arrayify, concat, hexlify, zeroPad } from './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':
@@ -51,7 +51,7 @@ function _pack(type, value, isArray) {
             logger.throwArgumentError(`invalid value for ${type}`, 'value', value);
         }
         if (isArray) {
-            return arrayify((value + Zeros).substring(0, 66));
+            return arrayify((value + hexFalse).substring(0, 66));
         }
         return value;
     }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "essential-eth",
   "description": "Ultralight JS library for Ethereum utilities",
-  "version": "0.5.1",
+  "version": "0.5.4-alpha.0",
   "license": "MIT",
   "sideEffects": false,
   "main": "./lib/cjs/index.js",
@@ -22,15 +22,16 @@
     "tsc:esm": "tsc -p tsconfig.json",
     "tsc:cjs": "tsc -p tsconfig-cjs.json",
     "build": "rm -rf lib && npm run compile",
-    "prepublishOnly": "npm run build",
     "jest": "jest",
     "build:chains-info": "npx ts-node scripts/fetch-chains-info.ts # used in getNetwork()",
     "update-deps": "sh ./scripts/pre-commit.sh",
     "pre-commit": "run-p build:chains-info update-deps",
-    "prepare": "husky install"
+    "prepare": "husky install",
+    "version": "npx genversion --es6 src/logger/package-version.ts && git add src/logger/package-version.ts",
+    "postversion": "git push --follow-tags",
+    "prepublishOnly": "npm run build"
   },
   "devDependencies": {
-    "@ethersproject/keccak256": "^5.4.0",
     "@types/body-parser": "^1.19.1",
     "@types/eslint": "^8.4.1",
     "@types/express": "^4.17.13",
@@ -38,20 +39,21 @@
     "@types/jest-dev-server": "^5.0.0",
     "@types/node": "^16.10.1",
     "@types/prettier": "^2.4.4",
-    "@typescript-eslint/eslint-plugin": "^5.20.0",
-    "@typescript-eslint/parser": "^5.20.0",
+    "@typescript-eslint/eslint-plugin": "^5.21.0",
+    "@typescript-eslint/parser": "^5.21.0",
     "body-parser": "^1.19.0",
     "dotenv": "^16.0.0",
-    "eslint": "^8.13.0",
-    "eslint-plugin-jest": "^26.1.4",
+    "eslint": "^8.14.0",
+    "eslint-plugin-jest": "^26.1.5",
     "ethers": "^5.6.4",
     "express": "^4.17.1",
     "husky": "^7.0.4",
     "jest": "^27.5.1",
     "jest-dev-server": "^6.0.3",
     "just-omit": "^2.0.1",
-    "lint-staged": "^12.4.0",
+    "lint-staged": "^12.4.1",
     "npm-run-all": "^4.1.5",
+    "perf_hooks": "^0.0.1",
     "prettier": "^2.6.2",
     "prettier-plugin-organize-imports": "^2.3.4",
     "ts-jest": "^27.1.4",

package/readme.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="https://user-images.githubusercontent.com/3408480/163274699-ae4fb0f4-fca0-4745-bcd7-4868f80deaf6.png" title="Logo"/>
+  <img src="https://user-images.githubusercontent.com/3408480/163274699-ae4fb0f4-fca0-4745-bcd7-4868f80deaf6.png" height="220" title="Logo"/>
 
 </p>
 <p align="center">
@@ -8,7 +8,7 @@
     🪶 Essential Eth 🪶
   </b>
   <br/>
-  <i>A replacement for ethers & web3 that's 50x smaller</i>
+  <i>A replacement for ethers & web3 that's 20x smaller</i>
   <br/>
 </p>
 
@@ -37,6 +37,10 @@
 
 <br/>
 
+[![🧪 tests](https://github.com/Earnifi/essential-eth/actions/workflows/test.yml/badge.svg)](https://github.com/Earnifi/essential-eth/actions/workflows/test.yml) [![codecov](https://codecov.io/gh/Earnifi/essential-eth/branch/master/graph/badge.svg?token=E44EK6RWTZ)](https://codecov.io/gh/Earnifi/essential-eth) ![](https://badgen.net/bundlephobia/minzip/essential-eth) ![](https://badgen.net/bundlephobia/tree-shaking/essential-eth) ![](https://img.shields.io/npm/v/essential-eth)
+
+<br/>
+
 ## Install
 
 ```sh
@@ -251,10 +255,35 @@ import { JsonRpcProvider } from 'essential-eth';
 const essentialEth = new JsonRpcProvider(
   'RPC URL HERE' /* Try POKT or Infura */,
 );
-// OR for very quick testing (limited to 500 requests)
+// OR for very quick testing (limited to 10,000 requests)
 const essentialEth = new JsonRpcProvider();
 ```
 
+<details>
+  <summary>Want a redundant provider that handles outages?</summary>
+
+```typescript
+import { FallthroughProvider } from 'essential-eth';
+
+// The FallthroughProvider handles falling through to the next valid URL.
+// It's dynamic to never trust one URL again when it fails * until it has tried all other provided URLs
+// The default timeout for a request is 8 seconds after which it moves to the next URL
+const provider = new FallthroughProvider([
+  'https://bad.com',
+  'https://free-eth-node.com/api/eth',
+]);
+provider.getGasPrice().toNumber();
+/*
+39695942769
+*/
+```
+
+</details>
+
+ <br/>
+
+#### [`getTransactionCount(address, blockTag?): Promise<number>`](https://essential-eth.vercel.app/docs/api/classes/JsonRpcProvider#gettransactioncount)
+
 #### `getGasPrice`
 
 Returns the current gas price in gwei
@@ -617,8 +646,6 @@ Any function on a contract. Returns are the same as `ethers.js`, except that ins
 
 🧪 This repo is under active development. The API is less-fully featured than `web3` and `ethers`. More functions added often!
 
-![](https://badgen.net/bundlephobia/minzip/essential-eth) ![](https://badgen.net/bundlephobia/tree-shaking/essential-eth) ![](https://img.shields.io/npm/v/essential-eth) ![](https://badgen.net/bundlephobia/dependency-count/essential-eth)
-
 👨🏻‍💻 Breaking changes will exist between minor versions until `1.0.0` (Versions go `major.minor.patch`)
 
 <br/>