essential-eth 0.4.9-beta.4 → 0.4.11

package/lib/cjs/classes/Contract.js

@@ -51,17 +51,12 @@ class BaseContract {
                             ? estimateGas(data)
                             : null;
                     const req = () => __awaiter(this, void 0, void 0, function* () {
-                        return yield (0, fetchers_1.post)(this._provider._rpcUrl[this._provider._rpcUrlCounter], (0, fetchers_1.buildRPCPostBody)('eth_call', [
-                            Object.assign({ to: this._address.toLowerCase(), data: data }, (decimalGas
+                        return yield (0, fetchers_1.post)(this._provider._rpcUrl, (0, fetchers_1.buildRPCPostBody)('eth_call', [
+                            Object.assign({ to: this._address.toLowerCase(), data }, (decimalGas
                                 ? { gas: `0x${decimalGas.toString(16)}` }
                                 : {})),
                             'latest',
-                        ])).catch((e) => {
-                            if (e.code === 'ENOTFOUND') {
-                                this._provider._rpcUrlCounter++;
-                                return req();
-                            }
-                        });
+                        ]));
                     });
                     const nodeResponse = yield req();
                     return (0, encode_decode_transaction_1.decodeRPCResponse)(jsonABIArgument, nodeResponse);

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

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

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

@@ -1,4 +1,13 @@
 "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 };
 };
@@ -13,10 +22,19 @@ function post(url, body) {
         },
         body: JSON.stringify(body),
     })
-        .then((r) => r.json())
+        .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) => {
-        if (response.error) {
-            throw new Error(response.error);
+        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;
     });

package/lib/cjs/index.d.ts

@@ -5,9 +5,10 @@ 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 * as utils from './utils';
+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 { utils, etherToWei, isAddress, jsonRpcProvider, JsonRpcProvider, tinyBig, toChecksumAddress, weiToEther, Contract, TinyBig, Block, ContractTypes, JSONABI, JSONABIArgument, Network, Transaction, };
+export { etherToWei, etherToGwei, isAddress, jsonRpcProvider, JsonRpcProvider, tinyBig, toChecksumAddress, weiToEther, gweiToEther, Contract, TinyBig, Block, ContractTypes, JSONABI, JSONABIArgument, Network, Transaction, };

package/lib/cjs/index.js

@@ -1,29 +1,6 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TinyBig = exports.Contract = exports.weiToEther = exports.toChecksumAddress = exports.tinyBig = exports.JsonRpcProvider = exports.jsonRpcProvider = exports.isAddress = exports.etherToWei = exports.utils = void 0;
+exports.TinyBig = exports.Contract = exports.gweiToEther = exports.weiToEther = exports.toChecksumAddress = exports.tinyBig = exports.JsonRpcProvider = exports.jsonRpcProvider = exports.isAddress = exports.etherToGwei = exports.etherToWei = void 0;
 const Contract_1 = require("./classes/Contract");
 Object.defineProperty(exports, "Contract", { enumerable: true, get: function () { return Contract_1.Contract; } });
 const JsonRpcProvider_1 = require("./providers/JsonRpcProvider");
@@ -32,10 +9,12 @@ Object.defineProperty(exports, "jsonRpcProvider", { enumerable: true, get: funct
 const tiny_big_1 = require("./shared/tiny-big/tiny-big");
 Object.defineProperty(exports, "tinyBig", { enumerable: true, get: function () { return tiny_big_1.tinyBig; } });
 Object.defineProperty(exports, "TinyBig", { enumerable: true, get: function () { return tiny_big_1.TinyBig; } });
-const utils = __importStar(require("./utils"));
-exports.utils = utils;
+const ether_to_gwei_1 = require("./utils/ether-to-gwei");
+Object.defineProperty(exports, "etherToGwei", { enumerable: true, get: function () { return ether_to_gwei_1.etherToGwei; } });
 const ether_to_wei_1 = require("./utils/ether-to-wei");
 Object.defineProperty(exports, "etherToWei", { enumerable: true, get: function () { return ether_to_wei_1.etherToWei; } });
+const gwei_to_ether_1 = require("./utils/gwei-to-ether");
+Object.defineProperty(exports, "gweiToEther", { enumerable: true, get: function () { return gwei_to_ether_1.gweiToEther; } });
 const is_address_1 = require("./utils/is-address");
 Object.defineProperty(exports, "isAddress", { enumerable: true, get: function () { return is_address_1.isAddress; } });
 const to_checksum_address_1 = require("./utils/to-checksum-address");

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

@@ -1,23 +1,53 @@
-import { Block } from '../types/Block.types';
+import { TinyBig } from '../shared/tiny-big/tiny-big';
+import { Block, BlockTag } from '../types/Block.types';
 import { Network } from '../types/Network.types';
 export declare class JsonRpcProvider {
     /**
-     * The URL to your Eth node. Consider POKT or Infura
+     * @ignore
      */
-    readonly _rpcUrl: Array<string>;
-    _rpcUrlCounter: number;
-    constructor(rpcUrl?: string | Array<string>);
+    readonly _rpcUrl: string;
+    /**
+     * @param rpcUrl The URL to your Eth node. Consider POKT or Infura
+     */
+    constructor(rpcUrl?: string);
     /**
      * Returns the block requested
      * Same as `web3.eth.getBlock`
      */
-    getBlock(timeFrame: 'latest' | 'earliest' | 'pending' | number, returnTransactionObjects?: boolean): Promise<Block>;
+    getBlock(timeFrame: BlockTag, returnTransactionObjects?: boolean): Promise<Block>;
     /**
      * Returns the network this provider is connected to
      */
     getNetwork(): Promise<Network>;
+    /**
+     * Returns the current gas price in wei as TinyBig
+     * Same as `ethers.provider.getGasPrice`
+     */
+    getGasPrice(): Promise<TinyBig>;
+    /**
+     * Returns the balance of the account in wei as TinyBig
+     * Same as `ethers.provider.getBalance`
+     * Same as `web3.eth.getBalance`
+     *
+     * @example
+     * ```js
+     *  await provider
+     *   .getBalance('0x7cB57B5A97eAbe94205C07890BE4c1aD31E486A8')
+     *   .then((balance) => console.log(balance.toString()));
+     * // "28798127851528138"
+     * ```
+     */
+    getBalance(address: string, blockTag?: BlockTag): Promise<TinyBig>;
 }
 /**
  * Helper function to avoid "new"
+ *
+ * @example
+ * ```javascript
+ * jsonRpcProvider().getBlock('latest').then(block => {
+ *   console.log(block.number);
+ * })
+ * // 14530496
+ * ```
  */
 export declare function jsonRpcProvider(rpcUrl?: string): JsonRpcProvider;

package/lib/cjs/providers/JsonRpcProvider.js

@@ -16,25 +16,20 @@ exports.jsonRpcProvider = exports.JsonRpcProvider = void 0;
 const clean_block_1 = require("../classes/utils/clean-block");
 const fetchers_1 = require("../classes/utils/fetchers");
 const hex_to_decimal_1 = require("../classes/utils/hex-to-decimal");
+const tiny_big_1 = require("../shared/tiny-big/tiny-big");
 const chains_info_1 = __importDefault(require("./utils/chains-info"));
 class JsonRpcProvider {
+    /**
+     * @param rpcUrl The URL to your Eth node. Consider POKT or Infura
+     */
     constructor(rpcUrl) {
-        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';
     }
     /**
      * Returns the block requested
      * Same as `web3.eth.getBlock`
      */
-    getBlock(timeFrame /* block number as integer */, returnTransactionObjects = false) {
+    getBlock(timeFrame, returnTransactionObjects = false) {
         return __awaiter(this, void 0, void 0, function* () {
             let rpcTimeFrame;
             if (typeof timeFrame === 'number') {
@@ -45,17 +40,12 @@ class JsonRpcProvider {
                 // "latest", "earliest", and "pending" require no manipulation
                 rpcTimeFrame = timeFrame;
             }
-            const req = () => __awaiter(this, void 0, void 0, function* () {
-                return yield (0, fetchers_1.post)(this._rpcUrl[this._rpcUrlCounter], (0, fetchers_1.buildRPCPostBody)('eth_getBlockByNumber', [
+            const req = () => {
+                return (0, fetchers_1.post)(this._rpcUrl, (0, fetchers_1.buildRPCPostBody)('eth_getBlockByNumber', [
                     rpcTimeFrame,
                     returnTransactionObjects,
-                ])).catch((e) => {
-                    if (e.code === 'ENOTFOUND') {
-                        this._rpcUrlCounter++;
-                        return req();
-                    }
-                });
-            });
+                ]));
+            };
             const nodeResponse = (yield req());
             return (0, clean_block_1.cleanBlock)(nodeResponse, returnTransactionObjects);
         });
@@ -65,14 +55,9 @@ class JsonRpcProvider {
      */
     getNetwork() {
         return __awaiter(this, void 0, void 0, function* () {
-            const req = () => __awaiter(this, void 0, void 0, function* () {
-                return yield (0, fetchers_1.post)(this._rpcUrl[this._rpcUrlCounter], (0, fetchers_1.buildRPCPostBody)('eth_chainId', [])).catch((e) => {
-                    if (e.code === 'ENOTFOUND') {
-                        this._rpcUrlCounter++;
-                        return req();
-                    }
-                });
-            });
+            const req = () => {
+                return (0, fetchers_1.post)(this._rpcUrl, (0, fetchers_1.buildRPCPostBody)('eth_chainId', []));
+            };
             const nodeResponse = (yield req());
             const chainId = (0, hex_to_decimal_1.hexToDecimal)(nodeResponse);
             const info = chains_info_1.default[chainId];
@@ -83,10 +68,53 @@ class JsonRpcProvider {
             };
         });
     }
+    /**
+     * Returns the current gas price in wei as TinyBig
+     * Same as `ethers.provider.getGasPrice`
+     */
+    getGasPrice() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const req = () => {
+                return (0, fetchers_1.post)(this._rpcUrl, (0, fetchers_1.buildRPCPostBody)('eth_gasPrice', []));
+            };
+            const nodeResponse = (yield req()); /* '0x153cfb1ad0' */
+            return (0, tiny_big_1.tinyBig)((0, hex_to_decimal_1.hexToDecimal)(nodeResponse));
+        });
+    }
+    /**
+     * 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 req = () => {
+                return (0, fetchers_1.post)(this._rpcUrl, (0, fetchers_1.buildRPCPostBody)('eth_getBalance', [address, blockTag]));
+            };
+            const nodeResponse = (yield req()); /* '0x153cfb1ad0' */
+            return (0, tiny_big_1.tinyBig)((0, hex_to_decimal_1.hexToDecimal)(nodeResponse));
+        });
+    }
 }
 exports.JsonRpcProvider = JsonRpcProvider;
 /**
  * Helper function to avoid "new"
+ *
+ * @example
+ * ```javascript
+ * jsonRpcProvider().getBlock('latest').then(block => {
+ *   console.log(block.number);
+ * })
+ * // 14530496
+ * ```
  */
 function jsonRpcProvider(rpcUrl) {
     return new JsonRpcProvider(rpcUrl);

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

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

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

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rpcUrls = exports.fakeUrls = void 0;
+exports.fakeUrls = {
+    notRPCButRealHttp: 'https://httpstat.us/200',
+};
+exports.rpcUrls = {
+    mainnet: `${process.env.RPC_ORIGIN}/api/eth`,
+    gno: `${process.env.RPC_ORIGIN}/api/gno`,
+    bnb: `${process.env.RPC_ORIGIN}/api/bnb`,
+    arb1: `${process.env.RPC_ORIGIN}/api/arb1`,
+    gor: `${process.env.RPC_ORIGIN}/api/gor`,
+};

package/lib/cjs/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[];
@@ -243,6 +262,7 @@ declare const _default: {
     "16000": string[];
     "16001": string[];
     "19845": string[];
+    "21337": string[];
     "21816": string[];
     "24484": string[];
     "24734": string[];
@@ -259,6 +279,7 @@ declare const _default: {
     "43113": string[];
     "43114": string[];
     "44787": string[];
+    "45000": string[];
     "47805": string[];
     "49797": string[];
     "53935": string[];
@@ -300,10 +321,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 +340,7 @@ declare const _default: {
     "1313114": string[];
     "1313500": string[];
     "1337702": string[];
+    "2203181": string[];
     "7762959": string[];
     "11155111": string[];
     "13371337": string[];

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

@@ -145,6 +145,9 @@ exports.default = {
     "53": [
         "tcet"
     ],
+    "54": [
+        "OP"
+    ],
     "55": [
         "ZYX"
     ],
@@ -304,6 +307,9 @@ exports.default = {
     "137": [
         "MATIC"
     ],
+    "141": [
+        "OPtest"
+    ],
     "142": [
         "dax"
     ],
@@ -313,6 +319,9 @@ exports.default = {
     "163": [
         "pht"
     ],
+    "168": [
+        "aioz"
+    ],
     "170": [
         "hoosmartchain"
     ],
@@ -337,9 +346,18 @@ exports.default = {
     "211": [
         "EDI"
     ],
+    "218": [
+        "SO1-old"
+    ],
     "222": [
         "ASK"
     ],
+    "225": [
+        "LA"
+    ],
+    "226": [
+        "TLA"
+    ],
     "246": [
         "ewt"
     ],
@@ -361,6 +379,9 @@ exports.default = {
     "288": [
         "Boba"
     ],
+    "300": [
+        "ogc"
+    ],
     "321": [
         "kcs"
     ],
@@ -445,6 +466,9 @@ exports.default = {
     "787": [
         "aca"
     ],
+    "788": [
+        "taero"
+    ],
     "803": [
         "haic"
     ],
@@ -496,6 +520,9 @@ exports.default = {
     "1007": [
         "tnew"
     ],
+    "1008": [
+        "eun"
+    ],
     "1010": [
         "EVC"
     ],
@@ -550,12 +577,18 @@ exports.default = {
     "1285": [
         "mriver"
     ],
+    "1286": [
+        "mrock-old"
+    ],
     "1287": [
         "mbase"
     ],
     "1288": [
         "mrock"
     ],
+    "1337": [
+        "cennz-old"
+    ],
     "1618": [
         "cate"
     ],
@@ -565,15 +598,24 @@ exports.default = {
     "1657": [
         "bta"
     ],
+    "1688": [
+        "LUDAN"
+    ],
     "1856": [
         "tsf"
     ],
     "1898": [
         "boya"
     ],
+    "1984": [
+        "euntest"
+    ],
     "1987": [
         "egem"
     ],
+    "2001": [
+        "milkAda"
+    ],
     "2020": [
         "420"
     ],
@@ -595,9 +637,18 @@ exports.default = {
     "2213": [
         "evanesco"
     ],
+    "2221": [
+        "kava"
+    ],
     "2559": [
         "ktoc"
     ],
+    "3000": [
+        "cennz-r"
+    ],
+    "3001": [
+        "cennz-n"
+    ],
     "3331": [
         "zcrbeach"
     ],
@@ -625,6 +676,9 @@ exports.default = {
     "4002": [
         "tftm"
     ],
+    "4102": [
+        "aioz-testnet"
+    ],
     "4689": [
         "iotex-mainnet"
     ],
@@ -643,6 +697,9 @@ exports.default = {
     "5700": [
         "tsys"
     ],
+    "5777": [
+        "dgcc"
+    ],
     "5851": [
         "Ontology Testnet"
     ],
@@ -739,6 +796,9 @@ exports.default = {
     "19845": [
         "btcix"
     ],
+    "21337": [
+        "cennz-a"
+    ],
     "21816": [
         "oml"
     ],
@@ -787,6 +847,9 @@ exports.default = {
     "44787": [
         "ALFA"
     ],
+    "45000": [
+        "autobahn"
+    ],
     "47805": [
         "REI"
     ],
@@ -910,6 +973,9 @@ exports.default = {
     "110008": [
         "qkc-d-s7"
     ],
+    "200101": [
+        "milkTAda"
+    ],
     "200625": [
         "aka"
     ],
@@ -919,9 +985,6 @@ exports.default = {
     "201030": [
         "alayadev"
     ],
-    "210309": [
-        "platondev"
-    ],
     "210425": [
         "platon"
     ],
@@ -967,6 +1030,9 @@ exports.default = {
     "1337702": [
         "kintsugi"
     ],
+    "2203181": [
+        "platondev"
+    ],
     "7762959": [
         "music"
     ],