essential-eth 0.4.9-beta.3 → 0.4.10

package/lib/esm/classes/utils/fetchers.js

@@ -0,0 +1,43 @@
+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 unfetch from 'isomorphic-unfetch';
+export function post(url, body) {
+    return unfetch(url, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify(body),
+    })
+        .then((r) => __awaiter(this, void 0, void 0, function* () {
+        const t = yield r.text();
+        try {
+            return JSON.parse(t);
+        }
+        catch (_a) {
+            throw new Error(`Invalid JSON RPC response: "${t}"`);
+        }
+    }))
+        .then((response) => {
+        const result = response === null || response === void 0 ? void 0 : response.result;
+        if (!result) {
+            throw new Error(`Invalid JSON RPC response: ${JSON.stringify(response)}`);
+        }
+        return response.result;
+    });
+}
+export function buildRPCPostBody(method, params) {
+    return {
+        jsonrpc: '2.0',
+        id: 1,
+        method,
+        params,
+    };
+}

package/lib/esm/index.d.ts

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

package/lib/esm/index.js

@@ -0,0 +1,10 @@
+import { Contract } from './classes/Contract';
+import { JsonRpcProvider, jsonRpcProvider } from './providers/JsonRpcProvider';
+import { tinyBig, TinyBig } from './shared/tiny-big/tiny-big';
+import { etherToGwei } from './utils/ether-to-gwei';
+import { etherToWei } from './utils/ether-to-wei';
+import { gweiToEther } from './utils/gwei-to-ether';
+import { isAddress } from './utils/is-address';
+import { toChecksumAddress } from './utils/to-checksum-address';
+import { weiToEther } from './utils/wei-to-ether';
+export { etherToWei, etherToGwei, isAddress, jsonRpcProvider, JsonRpcProvider, tinyBig, toChecksumAddress, weiToEther, gweiToEther, Contract, TinyBig, };

package/{dist → lib}/esm/providers/JsonRpcProvider.d.ts

@@ -1,10 +1,11 @@
+import { TinyBig } from '../shared/tiny-big/tiny-big';
 import { Block } from '../types/Block.types';
 import { Network } from '../types/Network.types';
 export declare class JsonRpcProvider {
-    readonly _rpcUrl: Array<string>;
-    _rpcUrlCounter: number;
-    constructor(rpcUrl?: string | Array<string>);
+    readonly _rpcUrl: string;
+    constructor(rpcUrl?: string);
     getBlock(timeFrame: 'latest' | 'earliest' | 'pending' | number, returnTransactionObjects?: boolean): Promise<Block>;
     getNetwork(): Promise<Network>;
+    getGasPrice(): Promise<TinyBig>;
 }
 export declare function jsonRpcProvider(rpcUrl?: string): JsonRpcProvider;

package/{dist → lib}/esm/providers/JsonRpcProvider.js

@@ -10,19 +10,11 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 import { cleanBlock } from '../classes/utils/clean-block';
 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._rpcUrl = (() => {
-            if (!rpcUrl) {
-                return ['https://free-eth-node.com/api/eth'];
-            }
-            else if (!Array.isArray(rpcUrl)) {
-                return [rpcUrl];
-            }
-            return rpcUrl;
-        })();
-        this._rpcUrlCounter = 0;
+        this._rpcUrl = rpcUrl || 'https://free-eth-node.com/api/eth';
     }
     getBlock(timeFrame, returnTransactionObjects = false) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -34,15 +26,10 @@ export class JsonRpcProvider {
                 rpcTimeFrame = timeFrame;
             }
             const req = () => __awaiter(this, void 0, void 0, function* () {
-                return yield post(this._rpcUrl[this._rpcUrlCounter], buildRPCPostBody('eth_getBlockByNumber', [
+                return yield post(this._rpcUrl, buildRPCPostBody('eth_getBlockByNumber', [
                     rpcTimeFrame,
                     returnTransactionObjects,
-                ])).catch((e) => {
-                    if (e.code === 'ENOTFOUND') {
-                        this._rpcUrlCounter++;
-                        return req();
-                    }
-                });
+                ]));
             });
             const nodeResponse = (yield req());
             return cleanBlock(nodeResponse, returnTransactionObjects);
@@ -51,12 +38,7 @@ export class JsonRpcProvider {
     getNetwork() {
         return __awaiter(this, void 0, void 0, function* () {
             const req = () => __awaiter(this, void 0, void 0, function* () {
-                return yield post(this._rpcUrl[this._rpcUrlCounter], buildRPCPostBody('eth_chainId', [])).catch((e) => {
-                    if (e.code === 'ENOTFOUND') {
-                        this._rpcUrlCounter++;
-                        return req();
-                    }
-                });
+                return yield post(this._rpcUrl, buildRPCPostBody('eth_chainId', []));
             });
             const nodeResponse = (yield req());
             const chainId = hexToDecimal(nodeResponse);
@@ -68,6 +50,15 @@ export class JsonRpcProvider {
             };
         });
     }
+    getGasPrice() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const req = () => __awaiter(this, void 0, void 0, function* () {
+                return yield post(this._rpcUrl, buildRPCPostBody('eth_gasPrice', []));
+            });
+            const nodeResponse = (yield req());
+            return tinyBig(hexToDecimal(nodeResponse));
+        });
+    }
 }
 export function jsonRpcProvider(rpcUrl) {
     return new JsonRpcProvider(rpcUrl);

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

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

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

@@ -0,0 +1,8 @@
+export const fakeUrls = {
+    notRPCButRealHttp: 'https://httpstat.us/200',
+};
+export const rpcUrls = {
+    mainnet: `${process.env.RPC_ORIGIN}/api/eth`,
+    gno: `${process.env.RPC_ORIGIN}/api/gno`,
+    bnb: `${process.env.RPC_ORIGIN}/api/bnb`,
+};

package/{dist → lib}/esm/providers/utils/chains-info.d.ts

@@ -45,6 +45,7 @@ declare const _default: {
     "51": string[];
     "52": string[];
     "53": string[];
+    "54": string[];
     "55": string[];
     "56": string[];
     "57": string[];
@@ -98,9 +99,11 @@ declare const _default: {
     "127": string[];
     "128": string[];
     "137": string[];
+    "141": string[];
     "142": string[];
     "162": string[];
     "163": string[];
+    "168": string[];
     "170": string[];
     "172": string[];
     "186": string[];
@@ -109,7 +112,10 @@ declare const _default: {
     "199": string[];
     "200": string[];
     "211": string[];
+    "218": string[];
     "222": string[];
+    "225": string[];
+    "226": string[];
     "246": string[];
     "250": string[];
     "256": string[];
@@ -117,6 +123,7 @@ declare const _default: {
     "262": string[];
     "269": string[];
     "288": string[];
+    "300": string[];
     "321": string[];
     "322": string[];
     "333": string[];
@@ -145,6 +152,7 @@ declare const _default: {
     "721": string[];
     "777": string[];
     "787": string[];
+    "788": string[];
     "803": string[];
     "820": string[];
     "821": string[];
@@ -162,6 +170,7 @@ declare const _default: {
     "999": string[];
     "1001": string[];
     "1007": string[];
+    "1008": string[];
     "1010": string[];
     "1012": string[];
     "1022": string[];
@@ -180,14 +189,19 @@ declare const _default: {
     "1280": string[];
     "1284": string[];
     "1285": string[];
+    "1286": string[];
     "1287": string[];
     "1288": string[];
+    "1337": string[];
     "1618": string[];
     "1620": string[];
     "1657": string[];
+    "1688": string[];
     "1856": string[];
     "1898": string[];
+    "1984": string[];
     "1987": string[];
+    "2001": string[];
     "2020": string[];
     "2021": string[];
     "2022": string[];
@@ -195,7 +209,10 @@ declare const _default: {
     "2100": string[];
     "2101": string[];
     "2213": string[];
+    "2221": string[];
     "2559": string[];
+    "3000": string[];
+    "3001": string[];
     "3331": string[];
     "3333": string[];
     "3334": string[];
@@ -205,12 +222,14 @@ declare const _default: {
     "3966": string[];
     "3967": string[];
     "4002": string[];
+    "4102": string[];
     "4689": string[];
     "4690": string[];
     "4918": string[];
     "5197": string[];
     "5315": string[];
     "5700": string[];
+    "5777": string[];
     "5851": string[];
     "5869": string[];
     "6626": string[];
@@ -259,6 +278,7 @@ declare const _default: {
     "43113": string[];
     "43114": string[];
     "44787": string[];
+    "45000": string[];
     "47805": string[];
     "49797": string[];
     "53935": string[];
@@ -300,10 +320,10 @@ declare const _default: {
     "110006": string[];
     "110007": string[];
     "110008": string[];
+    "200101": string[];
     "200625": string[];
     "201018": string[];
     "201030": string[];
-    "210309": string[];
     "210425": string[];
     "234666": string[];
     "246529": string[];
@@ -319,6 +339,7 @@ declare const _default: {
     "1313114": string[];
     "1313500": string[];
     "1337702": string[];
+    "2203181": string[];
     "7762959": string[];
     "11155111": string[];
     "13371337": string[];

package/{dist → lib}/esm/providers/utils/chains-info.js

@@ -141,6 +141,9 @@ export default {
     "53": [
         "tcet"
     ],
+    "54": [
+        "OP"
+    ],
     "55": [
         "ZYX"
     ],
@@ -300,6 +303,9 @@ export default {
     "137": [
         "MATIC"
     ],
+    "141": [
+        "OPtest"
+    ],
     "142": [
         "dax"
     ],
@@ -309,6 +315,9 @@ export default {
     "163": [
         "pht"
     ],
+    "168": [
+        "aioz"
+    ],
     "170": [
         "hoosmartchain"
     ],
@@ -333,9 +342,18 @@ export default {
     "211": [
         "EDI"
     ],
+    "218": [
+        "SO1-old"
+    ],
     "222": [
         "ASK"
     ],
+    "225": [
+        "LA"
+    ],
+    "226": [
+        "TLA"
+    ],
     "246": [
         "ewt"
     ],
@@ -357,6 +375,9 @@ export default {
     "288": [
         "Boba"
     ],
+    "300": [
+        "ogc"
+    ],
     "321": [
         "kcs"
     ],
@@ -441,6 +462,9 @@ export default {
     "787": [
         "aca"
     ],
+    "788": [
+        "taero"
+    ],
     "803": [
         "haic"
     ],
@@ -492,6 +516,9 @@ export default {
     "1007": [
         "tnew"
     ],
+    "1008": [
+        "eun"
+    ],
     "1010": [
         "EVC"
     ],
@@ -546,12 +573,18 @@ export default {
     "1285": [
         "mriver"
     ],
+    "1286": [
+        "mrock-old"
+    ],
     "1287": [
         "mbase"
     ],
     "1288": [
         "mrock"
     ],
+    "1337": [
+        "cennz-a"
+    ],
     "1618": [
         "cate"
     ],
@@ -561,15 +594,24 @@ export default {
     "1657": [
         "bta"
     ],
+    "1688": [
+        "LUDAN"
+    ],
     "1856": [
         "tsf"
     ],
     "1898": [
         "boya"
     ],
+    "1984": [
+        "euntest"
+    ],
     "1987": [
         "egem"
     ],
+    "2001": [
+        "milkAda"
+    ],
     "2020": [
         "420"
     ],
@@ -591,9 +633,18 @@ export default {
     "2213": [
         "evanesco"
     ],
+    "2221": [
+        "kava"
+    ],
     "2559": [
         "ktoc"
     ],
+    "3000": [
+        "cennz-r"
+    ],
+    "3001": [
+        "cennz-n"
+    ],
     "3331": [
         "zcrbeach"
     ],
@@ -621,6 +672,9 @@ export default {
     "4002": [
         "tftm"
     ],
+    "4102": [
+        "aioz-testnet"
+    ],
     "4689": [
         "iotex-mainnet"
     ],
@@ -639,6 +693,9 @@ export default {
     "5700": [
         "tsys"
     ],
+    "5777": [
+        "dgcc"
+    ],
     "5851": [
         "Ontology Testnet"
     ],
@@ -783,6 +840,9 @@ export default {
     "44787": [
         "ALFA"
     ],
+    "45000": [
+        "autobahn"
+    ],
     "47805": [
         "REI"
     ],
@@ -906,6 +966,9 @@ export default {
     "110008": [
         "qkc-d-s7"
     ],
+    "200101": [
+        "milkTAda"
+    ],
     "200625": [
         "aka"
     ],
@@ -915,9 +978,6 @@ export default {
     "201030": [
         "alayadev"
     ],
-    "210309": [
-        "platondev"
-    ],
     "210425": [
         "platon"
     ],
@@ -963,6 +1023,9 @@ export default {
     "1337702": [
         "kintsugi"
     ],
+    "2203181": [
+        "platondev"
+    ],
     "7762959": [
         "music"
     ],

package/lib/esm/utils/ether-to-gwei.d.ts

@@ -0,0 +1,3 @@
+import Big from 'big.js';
+import { TinyBig } from '../shared/tiny-big/tiny-big';
+export declare function etherToGwei(etherQuantity: string | number | TinyBig | Big): TinyBig;

package/lib/esm/utils/ether-to-gwei.js

@@ -0,0 +1,7 @@
+import { tinyBig } from '../shared/tiny-big/tiny-big';
+import { validateType } from '../shared/validate-type';
+export function etherToGwei(etherQuantity) {
+    validateType(etherQuantity, ['string', 'number', 'object']);
+    const result = tinyBig(etherQuantity).times('1000000000');
+    return tinyBig(result);
+}

package/lib/esm/utils/gwei-to-ether.d.ts

@@ -0,0 +1,3 @@
+import Big from 'big.js';
+import { TinyBig } from './../shared/tiny-big/tiny-big';
+export declare function gweiToEther(gweiQuantity: string | number | TinyBig | Big): TinyBig;

package/lib/esm/utils/gwei-to-ether.js

@@ -0,0 +1,7 @@
+import { tinyBig } from '../shared/tiny-big/tiny-big';
+import { validateType } from '../shared/validate-type';
+export function gweiToEther(gweiQuantity) {
+    validateType(gweiQuantity, ['string', 'number', 'object']);
+    const result = tinyBig(gweiQuantity).div('1000000000');
+    return tinyBig(result);
+}

package/{dist → lib}/esm/utils/is-address.js

@@ -1,5 +1,5 @@
+import { toChecksumAddress } from '..';
 import { validateType } from '../shared/validate-type';
-import { toChecksumAddress } from '../utils';
 export function isAddress(address) {
     validateType(address, ['string']);
     try {

package/{dist → lib}/esm/utils/wei-to-ether.d.ts

@@ -1,3 +1,3 @@
 import Big from 'big.js';
-import { TinyBig } from './../shared/tiny-big/tiny-big';
+import { TinyBig } from '../shared/tiny-big/tiny-big';
 export declare function weiToEther(weiQuantity: string | number | TinyBig | Big): TinyBig;

package/package.json

@@ -1,14 +1,13 @@
 {
   "name": "essential-eth",
   "description": "Ultralight JS library for Ethereum utilities",
-  "version": "0.4.9-beta.3",
+  "version": "0.4.10",
   "license": "MIT",
   "sideEffects": false,
-  "main": "./dist/cjs/index.js",
-  "module": "./dist/esm/index.js",
-  "types": "./dist/cjs/index.d.ts",
+  "main": "./lib/cjs/index.js",
+  "module": "./lib/esm/index.js",
   "files": [
-    "dist/"
+    "lib/"
   ],
   "bugs": {
     "url": "https://github.com/dawsbot/essential-eth/issues"
@@ -17,16 +16,15 @@
   "author": "@dawsbot",
   "scripts": {
     "test": "npm-run-all --parallel jest compile lint",
+    "test:all-node-versions": "npx trevor",
     "lint": "eslint .",
     "compile": "npm-run-all --parallel tsc:esm tsc:cjs",
     "tsc:esm": "tsc -p tsconfig.json",
     "tsc:cjs": "tsc -p tsconfig-cjs.json",
-    "build": "rm -rf dist && npm run compile",
-    "prepublishOnly": "npm run build && npm run build:website && npm run build:website:new-version",
+    "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()",
-    "build:website": "sh scripts/build-website.sh",
-    "build:website:new-version": "typedoc --options typedoc/options-new-version.js",
     "pre-commit": "sh scripts/pre-commit.sh"
   },
   "devDependencies": {
@@ -38,9 +36,8 @@
     "@types/jest-dev-server": "^5.0.0",
     "@types/node": "^16.10.1",
     "@types/prettier": "^2.4.4",
-    "@types/supertest": "^2.0.11",
-    "@typescript-eslint/eslint-plugin": "^5.17.0",
-    "@typescript-eslint/parser": "^5.17.0",
+    "@typescript-eslint/eslint-plugin": "^5.18.0",
+    "@typescript-eslint/parser": "^5.18.0",
     "body-parser": "^1.19.0",
     "dotenv": "^16.0.0",
     "eslint": "^8.12.0",
@@ -50,15 +47,14 @@
     "husky": "^4.3.0",
     "jest": "^27.5.1",
     "jest-dev-server": "^6.0.3",
-    "just-omit": "^1.2.0",
+    "just-omit": "^2.0.1",
     "lint-staged": "^12.3.7",
     "npm-run-all": "^4.1.5",
-    "prettier": "^2.6.1",
+    "prettier": "^2.6.2",
     "prettier-plugin-organize-imports": "^2.3.4",
-    "supertest": "^6.1.6",
     "ts-jest": "^27.1.4",
     "ts-node": "^10.2.1",
-    "typedoc": "^0.22.12",
+    "typedoc": "^0.22.13",
     "typescript": "^4.6.3",
     "web3": "^1.7.1"
   },
@@ -70,7 +66,7 @@
   },
   "husky": {
     "hooks": {
-      "pre-commit": "lint-staged && run-p pre-commit test build:website build:chains-info"
+      "pre-commit": "lint-staged && run-p pre-commit test build:chains-info"
     }
   },
   "lint-staged": {