essential-eth 0.5.4 → 0.5.9

package/readme.md

@@ -8,12 +8,10 @@
     🪶 Essential Eth 🪶
   </b>
   <br/>
-  <i>A replacement for ethers & web3 that's 20x smaller</i>
+  <i>An alternative for ethers & web3 that's 20x smaller</i>
   <br/>
 </p>
 
----
-
 <br/>
 
 ## Why you should replace Ethers.js and web3
@@ -24,6 +22,8 @@
 
 ---
 
+[![🧪 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/>
 
 - 🏆️ <sub><sup>[smallest code size possible](https://bundlephobia.com/package/essential-eth)</sup></sub>
@@ -32,231 +32,942 @@
 - - ⚡️ Near-identical API to `ethers`
 - 🌲 Tree-shaking and no side-effects
 - 🙌 Supports multiple JS versions (CommonJS and ESM)
-  - ✅ Node 17, 16, 14, & 12
+  - ✅ Node 18, 16, 14, & 12
   - ✅ Web
 
 <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)
+## Table of Contents
 
-<br/>
+<!-- ⛔️ AUTO-GENERATED-CONTENT:START (TOC:collapse=true&collapseText=Click to expand) -->
+<details>
+<summary>Click to expand</summary>
+
+- [Why you should replace Ethers.js and web3](#why-you-should-replace-ethersjs-and-web3)
+- [Install](#install)
+- [🛠 Utils](#-utils)
+  - [`arrayify`](#arrayify)
+  - [`computeAddress`](#computeaddress)
+  - [`computePublicKey`](#computepublickey)
+  - [`concat`](#concat)
+  - [`etherToGwei`](#ethertogwei)
+  - [`etherToWei`](#ethertowei)
+  - [`gweiToEther`](#gweitoether)
+  - [`hashMessage`](#hashmessage)
+  - [`hexConcat`](#hexconcat)
+  - [`hexDataLength`](#hexdatalength)
+  - [`hexDataSlice`](#hexdataslice)
+  - [`hexStripZeros`](#hexstripzeros)
+  - [`hexValue`](#hexvalue)
+  - [`hexZeroPad`](#hexzeropad)
+  - [`hexlify`](#hexlify)
+  - [`isAddress`](#isaddress)
+  - [`isBytes`](#isbytes)
+  - [`isBytesLike`](#isbyteslike)
+  - [`isHexString`](#ishexstring)
+  - [`jsonRpcProvider`](#jsonrpcprovider)
+  - [`keccak256`](#keccak256)
+  - [`pack`](#pack)
+  - [`solidityKeccak256`](#soliditykeccak256)
+  - [`splitSignature`](#splitsignature)
+  - [`stripZeros`](#stripzeros)
+  - [`tinyBig`](#tinybig)
+  - [`toChecksumAddress`](#tochecksumaddress)
+  - [`toUtf8Bytes`](#toutf8bytes)
+  - [`weiToEther`](#weitoether)
+  - [`zeroPad`](#zeropad)
+- [Providers](#providers)
+  - [`call`](#call)
+  - [`estimateGas`](#estimategas)
+  - [`getBalance`](#getbalance)
+  - [`getBlock`](#getblock)
+  - [`getBlockNumber`](#getblocknumber)
+  - [`getCode`](#getcode)
+  - [`getGasPrice`](#getgasprice)
+  - [`getLogs`](#getlogs)
+  - [`getNetwork`](#getnetwork)
+  - [`getTransaction`](#gettransaction)
+  - [`getTransactionCount`](#gettransactioncount)
+  - [`getTransactionReceipt`](#gettransactionreceipt)
+- [Contract](#contract)
+  - [`contractFunctionName(args)`](#contractfunctionnameargs)
+- [More Info](#more-info)
+  - [Identical vs Similar vs Dissimliar {&#035;isd}](#identical-vs-similar-vs-dissimliar-isd)
+  - [Miscellaneous](#miscellaneous)
+
+</details>
+
+<!-- ⛔️ AUTO-GENERATED-CONTENT:END -->
+
+  <br/>
 
 ## Install
 
 ```sh
 npm install --save essential-eth # TypeScript types load automatically
 
-# or if you prefer yarn
+# or yarn
 yarn add essential-eth # TypeScript types load automatically
 ```
 
 <br/>
 
-## Utils (do not require connecting to an Eth node)
+## 🛠 Utils
+
+```typescript
+import { etherToWei } from 'essential-eth';
+
+// or in a non-import environment
+const { etherToWei } = require('essential-eth');
+```
+
+<!-- ⛔️ AUTO-GENERATED-CONTENT:START (FUNCTIONS) -->
+
+#### [`arrayify`](https://essential-eth.vercel.app/docs/api/modules#arrayify)
+
+```typescript
+arrayify(value: number | BytesLike | Hexable, options: DataOptions): Uint8Array
+```
+
+  <details>
+  <summary>View Example</summary>
+
+```js
+import { arrayify } from 'essential-eth';
+```
+
+```javascript
+arrayify(1);
+// Uint8Array(1) [ 1 ]
+```
+
+```javascript
+arrayify(0x1234);
+// Uint8Array(2) [ 18, 52 ]
+```
+
+```javascript
+arrayify('0x1', { hexPad: 'right' });
+// Uint8Array(1) [ 16 ]
+```
+
+  </details>
+
+  <br/>
+
+#### [`computeAddress`](https://essential-eth.vercel.app/docs/api/modules#computeaddress)
+
+```typescript
+computeAddress(key: string): string
+```
+
+  <details>
+  <summary>View Example</summary>
+
+```js
+import { computeAddress } from 'essential-eth';
+```
+
+```javascript
+computeAddress(
+  '0x0458eb591f407aef12936bd2989ca699cf5061de9c4964dd6eb6005fd8f580c407434447e813969a1be6e9954b002cad84dfc67a69e032b273e4695e7d0db2d952',
+); // public key
+// '0xA2902059a7BF992f1450BACD7357CCAa5cC8336a'
+```
+
+```javascript
+computeAddress(
+  '0x2f2c419acf4a1da8c1ebea75bb3fcfbd3ec2aa3bf0162901ccdc2f38b8f92427',
+); // private key
+// '0xA2902059a7BF992f1450BACD7357CCAa5cC8336a'
+```
+
+  </details>
+
+  <br/>
+
+#### [`computePublicKey`](https://essential-eth.vercel.app/docs/api/modules#computepublickey)
+
+```typescript
+computePublicKey(privKey: BytesLike): string
+```
+
+  <details>
+  <summary>View Example</summary>
+
+```js
+import { computePublicKey } from 'essential-eth';
+```
+
+```javascript
+computePublicKey(
+  '0xb27cc8dea0177d910110e8d3ec5480d56c723abf433529f4063f261ffdb9297c',
+);
+// '0x045cd0032015eecfde49f82f4e149d804e8ac6e3a0bface32e37c72a71ceac864fe84da7e8df84342f7b11dfb753c4d158f636142b46b29cf7f0f171ae0aa4fb87'
+```
+
+```javascript
+computePublicKey([
+  50, 102, 50, 99, 52, 49, 57, 97, 99, 102, 52, 97, 49, 100, 97, 56, 99, 49,
+  101, 98, 101, 97, 55, 53, 98, 98, 51, 102, 99, 102, 98, 100,
+]);
+// '0x04a9cea77eca949df84f661cee153426fb51f2294b9364b4fac240df57360b9b0ac9c99e4d7966491ab4c81f8c82e0cd24ec5759832ad4ab736d22c7d90b806ee8'
+```
+
+  </details>
+
+  <br/>
+
+#### [`concat`](https://essential-eth.vercel.app/docs/api/modules#concat)
+
+```typescript
+concat(arrayOfBytesLike: Array<BytesLikeWithNumber>): Uint8Array
+```
+
+  <details>
+  <summary>View Example</summary>
+
+```js
+import { concat } from 'essential-eth';
+```
+
+```javascript
+concat([0, 1]);
+// Uint8Array(2) [ 0, 1 ]
+```
+
+  </details>
+
+  <br/>
+
+#### [`etherToGwei`](https://essential-eth.vercel.app/docs/api/modules#ethertogwei)
+
+```typescript
+etherToGwei(etherQuantity: string | number | TinyBig | Big): TinyBig
+```
+
+  <details>
+  <summary>View Example</summary>
+
+```js
+import { etherToGwei } from 'essential-eth';
+```
+
+```javascript
+etherToGwei('1000').toString();
+// '1000000000000'
+etherToGwei(1000).toString();
+// '1000000000000'
+```
+
+```javascript
+etherToGwei('1000').toNumber();
+// 1000000000000
+etherToGwei(1000).toNumber();
+// 1000000000000
+```
+
+  </details>
+
+  <br/>
+
+#### [`etherToWei`](https://essential-eth.vercel.app/docs/api/modules#ethertowei)
 
 ```typescript
+etherToWei(etherQuantity: string | number | TinyBig | Big): TinyBig
+```
+
+  <details>
+  <summary>View Example</summary>
+
+```js
 import { etherToWei } from 'essential-eth';
+```
+
+```javascript
+etherToWei('1000').toString();
+// '1000000000000000000000'
+etherToWei(1000).toString();
+// '1000000000000000000000'
+```
+
+```javascript
+etherToWei('1000').toNumber();
+// 1000000000000000000000
+etherToWei(1000).toNumber();
+// 1000000000000000000000
+```
+
+  </details>
+
+  <br/>
+
+#### [`gweiToEther`](https://essential-eth.vercel.app/docs/api/modules#gweitoether)
+
+```typescript
+gweiToEther(gweiQuantity: string | number | TinyBig | Big): TinyBig
+```
+
+  <details>
+  <summary>View Example</summary>
+
+```js
+import { gweiToEther } from 'essential-eth';
+```
+
+```javascript
+gweiToEther('1000000000000').toString();
+// '1000'
+gweiToEther(1000000000000).toString();
+// '1000'
+```
+
+```javascript
+gweiToEther('1000000000000').toNumber();
+// 1000
+gweiToEther(1000000000000).toNumber();
+// 1000
+```
+
+  </details>
+
+  <br/>
+
+#### [`hashMessage`](https://essential-eth.vercel.app/docs/api/modules#hashmessage)
+
+```typescript
+hashMessage(message: string | Bytes): string
+```
+
+  <details>
+  <summary>View Example</summary>
+
+```js
+import { hashMessage } from 'essential-eth';
+```
+
+```javascript
+hashMessage('Hello World');
+// '0xa1de988600a42c4b4ab089b619297c17d53cffae5d5120d82d8a92d0bb3b78f2'
+```
+
+  </details>
+
+  <br/>
+
+#### [`hexConcat`](https://essential-eth.vercel.app/docs/api/modules#hexconcat)
+
+```typescript
+hexConcat(items: Array<BytesLike>): string
+```
+
+  <details>
+  <summary>View Example</summary>
+
+```js
+import { hexConcat } from 'essential-eth';
+```
+
+```javascript
+hexConcat([[2, 4, 0, 1], 9, '0x2934', '0x3947']);
+// '0x020400010929343947'
+```
+
+  </details>
+
+  <br/>
+
+#### [`hexDataLength`](https://essential-eth.vercel.app/docs/api/modules#hexdatalength)
+
+```typescript
+hexDataLength(data: BytesLike): undefined
+```
+
+  <details>
+  <summary>View Example</summary>
+
+```js
+import { hexDataLength } from 'essential-eth';
+```
+
+```javascript
+hexDataLength([2, 4, 0, 1]);
+// 4
+```
+
+```javascript
+hexDataLength('0x3925');
+// 2
+```
+
+  </details>
+
+  <br/>
+
+#### [`hexDataSlice`](https://essential-eth.vercel.app/docs/api/modules#hexdataslice)
+
+```typescript
+hexDataSlice(data: BytesLikeWithNumber, offset: number, endOffset: number): string
+```
+
+  <details>
+  <summary>View Example</summary>
+
+```js
+import { hexDataSlice } from 'essential-eth';
+```
+
+```javascript
+hexDataSlice([20, 6, 48], 0, 2);
+// '0x1406'
+```
+
+  </details>
+
+  <br/>
+
+#### [`hexStripZeros`](https://essential-eth.vercel.app/docs/api/modules#hexstripzeros)
+
+```typescript
+hexStripZeros(value: BytesLike): string
+```
+
+  <details>
+  <summary>View Example</summary>
+
+```js
+import { hexStripZeros } from 'essential-eth';
+```
+
+```javascript
+hexStripZeros([0, 0, 0, 48]);
+// '0x30'
+```
+
+  </details>
+
+  <br/>
+
+#### [`hexValue`](https://essential-eth.vercel.app/docs/api/modules#hexvalue)
+
+```typescript
+hexValue(value: number | bigint | BytesLike | Hexable): string
+```
+
+  <details>
+  <summary>View Example</summary>
+
+```js
+import { hexValue } from 'essential-eth';
+```
+
+```javascript
+hexValue(39);
+// '0x27'
+```
+
+```javascript
+hexValue([9, 4, 19, 4]);
+// '0x9041304'
+```
+
+  </details>
+
+  <br/>
+
+#### [`hexZeroPad`](https://essential-eth.vercel.app/docs/api/modules#hexzeropad)
+
+```typescript
+hexZeroPad(value: BytesLikeWithNumber, length: number): string
+```
+
+  <details>
+  <summary>View Example</summary>
+
+```js
+import { hexZeroPad } from 'essential-eth';
+```
+
+```javascript
+hexZeroPad('0x60', 2);
+// '0x0060'
+```
+
+```javascript
+hexZeroPad(0x60, 3);
+// '0x000060'
+```
+
+```javascript
+hexZeroPad('12345', 1);
+// Throws
+```
+
+  </details>
+
+  <br/>
+
+#### [`hexlify`](https://essential-eth.vercel.app/docs/api/modules#hexlify)
+
+```typescript
+hexlify(value: number | bigint | BytesLike | Hexable, options: DataOptions): string
+```
+
+  <details>
+  <summary>View Example</summary>
+
+```js
+import { hexlify } from 'essential-eth';
+```
+
+```javascript
+hexlify(4);
+// '0x04'
+```
+
+```javascript
+hexlify(14);
+// '0x0e'
+```
+
+  </details>
+
+  <br/>
+
+#### [`isAddress`](https://essential-eth.vercel.app/docs/api/modules#isaddress)
+
+```typescript
+isAddress(address: string): boolean
+```
+
+  <details>
+  <summary>View Example</summary>
+
+```js
+import { isAddress } from 'essential-eth';
+```
+
+```javascript
+isAddress('0xc0deaf6bd3f0c6574a6a625ef2f22f62a5150eab');
+// true
+```
+
+```javascript
+isAddress('bad');
+// false
+```
+
+```javascript
+// Does NOT support ENS.
+isAddress('vitalik.eth');
+// false
+```
+
+  </details>
+
+  <br/>
+
+#### [`isBytes`](https://essential-eth.vercel.app/docs/api/modules#isbytes)
+
+```typescript
+isBytes(value: any): value
+```
+
+  <details>
+  <summary>View Example</summary>
+
+```js
+import { isBytes } from 'essential-eth';
+```
+
+```javascript
+isBytes([1, 2, 3]);
+// true
+```
+
+```javascript
+isBytes(false);
+// false
+```
+
+```javascript
+isBytes(new Uint8Array(1));
+// true
+```
+
+  </details>
+
+  <br/>
+
+#### [`isBytesLike`](https://essential-eth.vercel.app/docs/api/modules#isbyteslike)
+
+```typescript
+isBytesLike(value: any): value
+```
+
+  <details>
+  <summary>View Example</summary>
+
+```js
+import { isBytesLike } from 'essential-eth';
+```
+
+```javascript
+isBytesLike([1, 2, 3]);
+// true
+```
+
+```javascript
+isBytesLike(false);
+// false
+```
+
+```javascript
+isBytesLike(new Uint8Array(1));
+// true
+```
+
+  </details>
+
+  <br/>
+
+#### [`isHexString`](https://essential-eth.vercel.app/docs/api/modules#ishexstring)
+
+```typescript
+isHexString(value: any, length: number): boolean
+```
+
+  <details>
+  <summary>View Example</summary>
+
+```js
+import { isHexString } from 'essential-eth';
+```
+
+```javascript
+isHexString('0x4924');
+// true
+```
+
+```javascript
+isHexString('0x4924', 4);
+// false
+// length of 4 in bytes would mean a hex string with 8 characters
+```
+
+  </details>
+
+  <br/>
+
+#### [`jsonRpcProvider`](https://essential-eth.vercel.app/docs/api/modules#jsonrpcprovider)
+
+```typescript
+jsonRpcProvider(rpcUrl: string): JsonRpcProvider
+```
+
+  <details>
+  <summary>View Example</summary>
+
+```js
+import { jsonRpcProvider } from 'essential-eth';
+```
+
+```javascript
+jsonRpcProvider()
+  .getBlock('latest')
+  .then((block) => {
+    console.log(block.number);
+  });
+// 14530496
+```
+
+  </details>
+
+  <br/>
+
+#### [`keccak256`](https://essential-eth.vercel.app/docs/api/modules#keccak256)
+
+```typescript
+keccak256(data: BytesLike): string
+```
+
+  <details>
+  <summary>View Example</summary>
+
+```js
+import { keccak256 } from 'essential-eth';
+```
+
+```javascript
+keccak256('essential-eth');
+// '0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470'
+
+keccak256('0x123');
+// '0x5fa2358263196dbbf23d1ca7a509451f7a2f64c15837bfbb81298b1e3e24e4fa'
+```
+
+  </details>
+
+  <br/>
+
+#### [`pack`](https://essential-eth.vercel.app/docs/api/modules#pack)
+
+```typescript
+pack(types: Array<string>, values: Array<any>): string
+```
+
+  <details>
+  <summary>View Example</summary>
+
+```js
+import { pack } from 'essential-eth';
+```
 
-// or in a non-import environment
-const { etherToWei } = require('essential-eth');
+```javascript
+const types = ['bool', 'string', 'uint64'];
+const values = [true, 'text', 30];
+pack(types, values);
+// '0x0174657874000000000000001e'
 ```
 
-- The return-type `TinyBig` is just [`Big`](https://github.com/MikeMcl/big.js) but expands scientific notation on `toNumber()` and `toString()`
+  </details>
 
-<br/>
+  <br/>
 
-#### `etherToWei`
+#### [`solidityKeccak256`](https://essential-eth.vercel.app/docs/api/modules#soliditykeccak256)
 
 ```typescript
-// convert ether to wei
-etherToWei(etherQuantity: string | number | TinyBig | Big): TinyBig
+solidityKeccak256(types: Array<string>, values: Array<any>): string
 ```
 
-<details>
+  <details>
   <summary>View Example</summary>
 
-```typescript
-import { etherToWei } from 'essential-eth';
-
-etherToWei(1).toString();
-// "1000000000000000000"
+```js
+import { solidityKeccak256 } from 'essential-eth';
+```
 
-etherToWei(1).toNumber();
-// 1000000000000000000
+```javascript
+const types = ['string', 'bool', 'uint32'];
+const values = ['essential-eth is great', true, 14];
+solidityKeccak256(types, values);
+// '0xe4d4c8e809faac09d58f468f0aeab9474fe8965d554c6c0f868c433c3fd6acab'
+```
 
-etherToWei('1').toNumber();
-// 1000000000000000000
+```javascript
+const types = ['bytes4', 'uint32[5]'];
+const values = [
+  [116, 101, 115, 116],
+  [5, 3, 4, 9, 18],
+];
+solidityKeccak256(types, values);
+// '0x038707a887f09355dc545412b058e7ba8f3c74047050c7c5e5e52eec608053d9'
 ```
 
-</details>
+  </details>
 
-<br/>
+  <br/>
 
-#### `weiToEther`
+#### [`splitSignature`](https://essential-eth.vercel.app/docs/api/modules#splitsignature)
 
 ```typescript
-// convert wei to ether
-weiToEther(weiQuantity: string | number | TinyBig | Big): TinyBig
+splitSignature(signature: SignatureLike): Signature
 ```
 
-<details>
+  <details>
   <summary>View Example</summary>
 
-```typescript
-import { weiToEther } from 'essential-eth';
-
-weiToEther(1000000000000000000).toString();
-// "1"
+```js
+import { splitSignature } from 'essential-eth';
+```
 
-weiToEther(1000000000000000000).toNumber();
-// 1
-weiToEther('1000000000000000000').toNumber();
-// 1
+```javascript
+const signature = '0x60bc4ed91f2021aefe7045f3f77bd12f87eb733aee24bd1965343b3c27b3971647252185b7d2abb411b01b5d1ac4ab41ea486df1e9b396758c1aec6c1b6eee331b';
+splitSignature(signature);
+ {
+   r: "0x60bc4ed91f2021aefe7045f3f77bd12f87eb733aee24bd1965343b3c27b39716",
+   s: "0x47252185b7d2abb411b01b5d1ac4ab41ea486df1e9b396758c1aec6c1b6eee33",
+   _vs: "0x47252185b7d2abb411b01b5d1ac4ab41ea486df1e9b396758c1aec6c1b6eee33",
+   recoveryParam: 0,
+   v: 27,
+   yParityAndS: "0x47252185b7d2abb411b01b5d1ac4ab41ea486df1e9b396758c1aec6c1b6eee33",
+   compact: "0x60bc4ed91f2021aefe7045f3f77bd12f87eb733aee24bd1965343b3c27b3971647252185b7d2abb411b01b5d1ac4ab41ea486df1e9b396758c1aec6c1b6eee33"
+ }
 ```
 
-</details>
+  </details>
 
-<br/>
+  <br/>
 
-#### `gweiToEther`
+#### [`stripZeros`](https://essential-eth.vercel.app/docs/api/modules#stripzeros)
 
 ```typescript
-gweiToEther(gweiQuantity: string | number | TinyBig | Big): TinyBig
+stripZeros(value: BytesLike): Uint8Array
 ```
 
-<details>
+  <details>
   <summary>View Example</summary>
 
-```typescript
-import { gweiToEther } from 'essential-eth';
-
-gweiToEther(1000000000).toString();
-// "1"
+```js
+import { stripZeros } from 'essential-eth';
+```
 
-gweiToEther(1000000000).toNumber();
-// 1
-gweiToEther('1000000000').toNumber();
-// 1
+```javascript
+stripZeros('0x00002834');
+// Uint8Array { [Iterator]  0: 40, 1: 52 }
+// Equivalent to '0x2834'
 ```
 
-</details>
+  </details>
 
-<br/>
+  <br/>
 
-#### `etherToGwei`
+#### [`tinyBig`](https://essential-eth.vercel.app/docs/api/modules#tinybig)
 
 ```typescript
-etherToGwei(etherQuantity: string | number | TinyBig | Big): TinyBig
+tinyBig(value: string | number | TinyBig | Big): TinyBig
 ```
 
-<details>
+  <details>
   <summary>View Example</summary>
 
-```typescript
-import { etherToGwei } from 'essential-eth';
-
-etherToGwei(0.000000001).toString();
-// "1"
+```js
+import { tinyBig } from 'essential-eth';
+```
 
-etherToGwei(0.000000001).toNumber();
-// 1
-etherToGwei('0.000000001').toNumber();
-// 1
+```javascript
+tinyBig(10).times(3).toNumber();
+// 30
 ```
 
-</details>
+  </details>
 
-<br/>
+  <br/>
 
-#### `toChecksumAddress`
+#### [`toChecksumAddress`](https://essential-eth.vercel.app/docs/api/modules#tochecksumaddress)
 
 ```typescript
-// return proper mixed-case address
-// does not support ICAP addresses
 toChecksumAddress(address: string): string
 ```
 
-<details>
+  <details>
   <summary>View Example</summary>
 
-```typescript
+```js
 import { toChecksumAddress } from 'essential-eth';
+```
 
-toChecksumAddress('0xc0deaf6bd3f0c6574a6a625ef2f22f62a5150eab');
-// "0xc0DEAF6bD3F0c6574a6a625EF2F22f62A5150EAB"
+```javascript
+toChecksumAddress('0xfB6916095ca1df60bB79Ce92cE3Ea74c37c5d359');
+// '0xfB6916095ca1df60bB79Ce92cE3Ea74c37c5d359'
 ```
 
-</details>
+Similar to ["getAddress" in ethers.js](https://docs.ethers.io/v5/api/utils/address/#utils-getAddress)
 
-<br/>
+Similar to ["toChecksumAddress" in web3.js](https://web3js.readthedocs.io/en/v1.7.1/web3-utils.html#tochecksumaddress)
+
+  </details>
 
-#### `isAddress`
+  <br/>
+
+#### [`toUtf8Bytes`](https://essential-eth.vercel.app/docs/api/modules#toutf8bytes)
 
 ```typescript
-// returns boolean as to whether input is a valid address
-// does not support ENS nor ICAP
-isAddress(address: string): boolean
+toUtf8Bytes(data: string): Uint8Array
 ```
 
-<details>
+  <details>
   <summary>View Example</summary>
 
-```typescript
-import { isAddress } from 'essential-eth';
-
-isAddress('0xc0deaf6bd3f0c6574a6a625ef2f22f62a5150eab');
-// true
+```js
+import { toUtf8Bytes } from 'essential-eth';
+```
 
-isAddress('bad');
-// false
+```javascript
+toUtf8Bytes('essential-eth');
+// Uint8Array { [Iterator] 0: 101, 1: 115, 2: 115, 3: 101, 4: 110, 5: 116, 6: 105, 7: 97, 8: 108, 9: 45, 10: 101, 11: 116, 12: 104 }
 
-// Does NOT support ENS.
-isAddress('vitalik.eth');
-// false
+toUtf8Bytes('ethereum');
+// Uint8Array { [Iterator]  0: 101, 1: 116, 2: 104, 3: 101, 4: 114, 5: 101, 6: 117, 7: 109 }
 ```
 
-</details>
+  </details>
 
-<br/>
+  <br/>
 
-#### `hexZeroPad`
+#### [`weiToEther`](https://essential-eth.vercel.app/docs/api/modules#weitoether)
 
 ```typescript
-// returns a hex string padded to a specified length of bytes
-// if the hex value provided is already longer than the padding value, the value itself is returned without alteration
-hexZeroPad(hexValue: string | number, length: number): string
+weiToEther(weiQuantity: string | number | TinyBig | Big): TinyBig
 ```
 
-<details>
+  <details>
   <summary>View Example</summary>
 
+```js
+import { weiToEther } from 'essential-eth';
+```
+
+```javascript
+weiToEther('1000000000000000000000').toString();
+// '1000'
+weiToEther(1000000000000000000000).toString();
+// '1000'
+```
+
+```javascript
+weiToEther('1000000000000000000000').toNumber();
+// 1000
+weiToEther(1000000000000000000000).toNumber();
+// 1000
+```
+
+  </details>
+
+  <br/>
+
+#### [`zeroPad`](https://essential-eth.vercel.app/docs/api/modules#zeropad)
+
 ```typescript
-import { hexZeroPad } from 'essential-eth';
+zeroPad(value: BytesLike, length: number): Uint8Array
+```
 
-hexZeroPad('0x60', 2);
-// '0x0060'
+  <details>
+  <summary>View Example</summary>
 
-hexZeroPad(0x60, 3);
-// '0x000060'
+```js
+import { zeroPad } from 'essential-eth';
+```
 
-// Length of string is already longer than padding value
-hexZeroPad('0x31323334', 3);
-// Throws error
+```javascript
+zeroPad('0x039284');
+// Uint8Array { [Iterator]  0: 0, 1: 0, 2: 0, 3: 3, 4: 146, 5: 132 }
+// Equivalent to 0x000000039284
 ```
 
-</details>
+```javascript
+zeroPad([39, 25, 103, 45], 5);
+// Uint8Array { [Iterator]  0: 0, 1: 39, 2: 25, 3: 103, 4: 45 }
+```
+
+  </details>
+
+  <br/>
+
+<!-- ⛔️ AUTO-GENERATED-CONTENT:END -->
+
+- _The return-type `TinyBig` is just [`Big`](https://github.com/MikeMcl/big.js) but expands scientific notation on `toNumber()` and `toString()`_
 
+<br/>
 <br/>
 
-## RPC
+## Providers
 
 ```typescript
 import { JsonRpcProvider } from 'essential-eth';
-const essentialEth = new JsonRpcProvider(
-  'RPC URL HERE' /* Try POKT or Infura */,
-);
+const provider = new JsonRpcProvider('RPC URL HERE' /* Try POKT or Infura */);
 // OR for very quick testing (limited to 10,000 requests)
-const essentialEth = new JsonRpcProvider();
+const provider = new JsonRpcProvider();
 ```
 
 <details>
@@ -282,294 +993,445 @@ provider.getGasPrice().toNumber();
 
  <br/>
 
-#### [`getTransactionCount(address, blockTag?): Promise<number>`](https://essential-eth.vercel.app/docs/api/classes/JsonRpcProvider#gettransactioncount)
-
-#### `getGasPrice`
+<!-- ⛔️ AUTO-GENERATED-CONTENT:START (PROVIDER) -->
 
-Returns the current gas price in gwei
+#### [`call`](https://essential-eth.vercel.app/docs/api/classes/JsonRpcProvider#call)
 
 ```typescript
-// Same as ethers.providers.getGasPrice
-getGasPrice(): Promise<TinyBig>
+provider.call(transaction: TransactionRequest, blockTag?: BlockTag): Promise<string>
 ```
 
-<details>
+  <details>
   <summary>View Example</summary>
 
-```typescript
+```js
 import { JsonRpcProvider } from 'essential-eth';
-
-const provider = new JsonRpcProvider('https://free-eth-node.com/api/eth');
-provider.getGasPrice().toNumber();
-/*
-39695942769
-*/
+const provider = new JsonRpcProvider('RPC URL HERE' /* Try Infura or POKT */);
 ```
 
-</details>
+```javascript
+await provider.call({
+  to: '0x6b175474e89094c44da98b954eedeac495271d0f',
+  data: '0x70a082310000000000000000000000006E0d01A76C3Cf4288372a29124A26D4353EE51BE',
+});
+// '0x0000000000000000000000000000000000000000000000000858898f93629000'
+```
 
-<br/>
+  </details>
 
-#### `getBalance`
+  <br/>
 
-Returns the balance of an address at a given block
+#### [`estimateGas`](https://essential-eth.vercel.app/docs/api/classes/JsonRpcProvider#estimategas)
 
 ```typescript
-// Same API as ethers.providers.getBalance
-// Same API as web3.eth.getBalance
-getBalance(address: string, blockTag?: BlockTag): Promise<TinyBig>
+provider.estimateGas(transaction: TransactionRequest): Promise<TinyBig>
 ```
 
-<details>
+  <details>
   <summary>View Example</summary>
 
+```js
+import { JsonRpcProvider } from 'essential-eth';
+const provider = new JsonRpcProvider('RPC URL HERE' /* Try Infura or POKT */);
+```
+
+```javascript
+await provider.estimateGas({
+  // Wrapped ETH address
+  to: '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2',
+  data: '0xd0e30db0',
+  value: etherToWei('1.0').toHexString(),
+});
+// { TinyBig: "27938" }
+```
+
+  </details>
+
+  <br/>
+
+#### [`getBalance`](https://essential-eth.vercel.app/docs/api/classes/JsonRpcProvider#getbalance)
+
 ```typescript
+provider.getBalance(address: string, blockTag?: BlockTag): Promise<TinyBig>
+```
+
+  <details>
+  <summary>View Example</summary>
+
+```js
 import { JsonRpcProvider } from 'essential-eth';
+const provider = new JsonRpcProvider('RPC URL HERE' /* Try Infura or POKT */);
+```
 
-const provider = new JsonRpcProvider();
-await provider
-  .getBalance('0x7cB57B5A97eAbe94205C07890BE4c1aD31E486A8')
-  .then((balance) => console.log(balance.toString()));
-// "28798127851528138"
+```javascript
+await provider.getBalance('0x7cB57B5A97eAbe94205C07890BE4c1aD31E486A8');
+// 28798127851528138
 ```
 
-</details>
+  </details>
 
-<br/>
+  <br/>
 
-#### `getNetwork`
+#### [`getBlock`](https://essential-eth.vercel.app/docs/api/classes/JsonRpcProvider#getblock)
 
-Returns a Network
+```typescript
+provider.getBlock(timeFrame?: BlockTag, returnTransactionObjects?: boolean): Promise<BlockResponse>
+```
+
+  <details>
+  <summary>View Example</summary>
+
+```js
+import { JsonRpcProvider } from 'essential-eth';
+const provider = new JsonRpcProvider('RPC URL HERE' /* Try Infura or POKT */);
+```
+
+```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: [],
+// }
+```
+
+  </details>
+
+  <br/>
+
+#### [`getBlockNumber`](https://essential-eth.vercel.app/docs/api/classes/JsonRpcProvider#getblocknumber)
 
 ```typescript
-// Same API as ethers.providers.getNetwork
-getNetwork(): Promise<Network>
+provider.getBlockNumber(): Promise<number>
 ```
 
-<details>
+  <details>
   <summary>View Example</summary>
 
+```js
+import { JsonRpcProvider } from 'essential-eth';
+const provider = new JsonRpcProvider('RPC URL HERE' /* Try Infura or POKT */);
+```
+
+```javascript
+await provider.getBlockNumber();
+// 1053312
+```
+
+  </details>
+
+  <br/>
+
+#### [`getCode`](https://essential-eth.vercel.app/docs/api/classes/JsonRpcProvider#getcode)
+
 ```typescript
+provider.getCode(address: string, blockTag?: BlockTag): Promise<string>
+```
+
+  <details>
+  <summary>View Example</summary>
+
+```js
 import { JsonRpcProvider } from 'essential-eth';
+const provider = new JsonRpcProvider('RPC URL HERE' /* Try Infura or POKT */);
+```
 
-const maticProvider = new JsonRpcProvider(
-  'https://free-eth-node.com/api/matic',
+```javascript
+await jsonRpcProvider().getCode(
+  '0xaC6095720221C79C6E7C638d260A2eFBC5D8d880',
+  'latest',
 );
-maticProvider.getNetwork();
-/*
-{ chainId: 137, name: 'MATIC', ensAddress: null }
-*/
+// '0x608060405234801561001057600080fd5b506004361061...'
+```
 
-const xdaiProvider = new JsonRpcProvider('https://free-eth-node.com/api/xdai');
-xdaiProvider.getNetwork();
-/*
-{ chainId: 100, name: 'xdai', ensAddress: null } }
-*/
+  </details>
+
+  <br/>
+
+#### [`getGasPrice`](https://essential-eth.vercel.app/docs/api/classes/JsonRpcProvider#getgasprice)
+
+```typescript
+provider.getGasPrice(): Promise<TinyBig>
 ```
 
-</details>
+  <details>
+  <summary>View Example</summary>
 
-<br/>
+```js
+import { JsonRpcProvider } from 'essential-eth';
+const provider = new JsonRpcProvider('RPC URL HERE' /* Try Infura or POKT */);
+```
+
+```javascript
+await provider.getGasPrice();
+// 52493941856
+```
+
+  </details>
 
-#### `getBlock`
+  <br/>
 
-Returns a Block
+#### [`getLogs`](https://essential-eth.vercel.app/docs/api/classes/JsonRpcProvider#getlogs)
 
 ```typescript
-// Same API as web3.eth.getBlock
-getBlock(timeFrame: number | "latest" | "earliest" | "pending", returnTransactionObjects?: boolean): Promise<Block>
+provider.getLogs(filter: Filter | FilterByBlockHash): Promise<Array<Log>>
 ```
 
-<details>
+  <details>
   <summary>View Example</summary>
 
+```js
+import { JsonRpcProvider } from 'essential-eth';
+const provider = new JsonRpcProvider('RPC URL HERE' /* Try Infura or POKT */);
+```
+
+```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,
+  },
+];
+```
+
+  </details>
+
+  <br/>
+
+#### [`getNetwork`](https://essential-eth.vercel.app/docs/api/classes/JsonRpcProvider#getnetwork)
+
 ```typescript
+provider.getNetwork(): Promise<Network>
+```
+
+  <details>
+  <summary>View Example</summary>
+
+```js
 import { JsonRpcProvider } from 'essential-eth';
-const essentialEth = new JsonRpcProvider();
-essentialEth.getBlock('latest');
+const provider = new JsonRpcProvider('RPC URL HERE' /* Try Infura or POKT */);
+```
 
-/*
-{
-        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'
-      }
-*/
+```javascript
+jsonRpcProvider('https://free-eth-node.com/api/eth').getNetwork();
+// { chainId: 1, name: 'eth', ensAddress: '0x00000000000C2E074eC69A0dFb2997BA6C7d2e1e' }
 ```
 
-</details>
+```javascript
+jsonRpcProvider('https://free-eth-node.com/api/MATIC').getNetwork();
+// { chainId: 137, name: 'MATIC', ensAddress: null }
+```
 
-<br/>
+  </details>
 
-#### `getTransaction`
+  <br/>
 
-Returns the Transaction associated with a given hash
+#### [`getTransaction`](https://essential-eth.vercel.app/docs/api/classes/JsonRpcProvider#gettransaction)
 
 ```typescript
-// Similar to ethers.provider.getTransaction, formatting may differ
-getTransaction(hash: string): Promise<Transaction>
+provider.getTransaction(transactionHash: string): Promise<TransactionResponse>
 ```
 
-<details>
+  <details>
   <summary>View Example</summary>
 
-```typescript
+```js
 import { JsonRpcProvider } from 'essential-eth';
-const essentialEth = new JsonRpcProvider();
+const provider = new JsonRpcProvider('RPC URL HERE' /* Try Infura or POKT */);
+```
+
+```javascript
 await provider.getTransaction(
   '0x9014ae6ef92464338355a79e5150e542ff9a83e2323318b21f40d6a3e65b4789',
 );
+// {
+//   accessList: [],
+//   blockHash: "0x876810a013dbcd140f6fd6048c1dc33abbb901f1f96b394c2fa63aef3cb40b5d",
+//   blockNumber: 14578286,
+//   chainId: 1,
+//   from: "0xdfD9dE5f6FA60BD70636c0900752E93a6144AEd4",
+//   gas: { TinyBig: 112163 },
+//   gasPrice: { TinyBig: 48592426858 },
+//   hash: "0x9014ae6ef92464338355a79e5150e542ff9a83e2323318b21f40d6a3e65b4789",
+//   input: "0x83259f17000000000000000000000000000000000000000000...",
+//   maxFeePerGas: { TinyBig: 67681261618 },
+//   maxPriorityFeePerGas: { TinyBig: 1500000000 },
+//   nonce: { TinyBig: 129 },
+//   r: "0x59a7c15b12c18cd68d6c440963d959bff3e73831ffc938e75ecad07f7ee43fbc",
+//   s: "0x1ebaf05f0d9273b16c2a7748b150a79d22533a8cd74552611cbe620fee3dcf1c",
+//   to: "0x39B72d136ba3e4ceF35F48CD09587ffaB754DD8B",
+//   transactionIndex: 29,
+//   type: 2,
+//   v: 0,
+//   value: { TinyBig: 0 },
+//   confirmations: 298140,
+// }
+```
 
-/*
-   {
-      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
-    }
-*/
+  </details>
+
+  <br/>
+
+#### [`getTransactionCount`](https://essential-eth.vercel.app/docs/api/classes/JsonRpcProvider#gettransactioncount)
+
+```typescript
+provider.getTransactionCount(address: string, blockTag?: BlockTag): Promise<number>
 ```
 
-</details>
+  <details>
+  <summary>View Example</summary>
+
+```js
+import { JsonRpcProvider } from 'essential-eth';
+const provider = new JsonRpcProvider('RPC URL HERE' /* Try Infura or POKT */);
+```
+
+```javascript
+await provider.getTransactionCount(
+  '0x71660c4005ba85c37ccec55d0c4493e66fe775d3',
+);
+// 1060000
+```
+
+```javascript
+await provider.getTransactionCount(
+  '0x71660c4005ba85c37ccec55d0c4493e66fe775d3',
+  'latest',
+);
+// 1060000
+```
+
+```javascript
+await provider.getTransactionCount(
+  '0x71660c4005ba85c37ccec55d0c4493e66fe775d3',
+  14649390,
+);
+// 1053312
+```
+
+  </details>
+
+  <br/>
+
+#### [`getTransactionReceipt`](https://essential-eth.vercel.app/docs/api/classes/JsonRpcProvider#gettransactionreceipt)
+
+```typescript
+provider.getTransactionReceipt(transactionHash: string): Promise<TransactionReceipt>
+```
+
+  <details>
+  <summary>View Example</summary>
+
+```js
+import { JsonRpcProvider } from 'essential-eth';
+const provider = new JsonRpcProvider('RPC URL HERE' /* Try Infura or POKT */);
+```
+
+```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,
+// }
+```
+
+  </details>
+
+  <br/>
+
+<!-- ⛔️ AUTO-GENERATED-CONTENT:END -->
 
 <br/>
 
@@ -577,7 +1439,7 @@ await provider.getTransaction(
 
 ⚠️ Only read functions are currently supported. ⚠️
 
-- 🧪 This is **highly experimental**, do not use this in production yet. (even though [earni.fi](https://earni.fi) does)
+- 🧪 `Contract` support is **experimental**, do not use this in production yet. (even though [earni.fi](https://earni.fi) does)
 
 Encoding support:
 
@@ -593,7 +1455,7 @@ Decoding support:
 - `bytes32`
 - `uint8`
 
-_Assume any smart-contract method outside the above types will break_
+_Assume all types outside the above types will break for now_
 
 ```typescript
 import { Contract, jsonRpcProvider, JSONABI } from 'essential-eth';
@@ -654,5 +1516,17 @@ Any function on a contract. Returns are the same as `ethers.js`, except that ins
 
 <br/>
 
+### Identical vs Similar vs Dissimliar {#isd}
+
+Throughout the documentation for `essential-eth`, you may notice that some functions are compared to `ethers.js` and `web3.js`. The keywords `identical`, `similar`, and `dissimilar` are used to help you migrate to `essential-eth`. Here's a guide on what these keywords mean:
+
+- Identical -- should behave exactly like the library you're already using, except the types might be different (`TinyBig` vs [`Bn.js`](https://github.com/indutny/bn.js)).
+- Similar -- can probably be used as a replacement to the library you're currently using, except there are some differences. Read the notes next to this keyword to see why these aren't considered `identical`.
+- Dissimilar -- _should not_ be used in place of the function you're currently using. Read the notes next to this keyword to see why these functions aren't considered `similar`, and potentially learn how to alter your implementation to make `essential-eth` work for you.
+
+Note: In `web3.js`, almost every method or function can be passed a callback. `essential-eth`, like `ethers.js`, does not include this functionality and trusts that users will rely on the much more modern [promise](https://javascript.info/promise-basics) and [async/await](https://javascript.info/async-await) patterns.
+
+### Miscellaneous
+
 - [📓 View full docs](https://essential-eth.vercel.app)
 - [📓 View changelog (by looking at releases diff)](https://github.com/dawsbot/essential-eth/releases)