essential-eth 0.4.9 → 0.4.10

package/lib/cjs/index.d.ts

@@ -5,8 +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 { 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, 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,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TinyBig = exports.Contract = exports.weiToEther = exports.toChecksumAddress = exports.tinyBig = exports.JsonRpcProvider = exports.jsonRpcProvider = exports.isAddress = exports.etherToWei = 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");
@@ -9,8 +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 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

@@ -24,5 +24,13 @@ export declare class JsonRpcProvider {
 }
 /**
  * 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

@@ -82,6 +82,14 @@ class JsonRpcProvider {
 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

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

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

@@ -1,6 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.fakeUrls = void 0;
+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`,
+};

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

@@ -123,6 +123,7 @@ declare const _default: {
     "262": string[];
     "269": string[];
     "288": string[];
+    "300": string[];
     "321": string[];
     "322": string[];
     "333": string[];
@@ -169,6 +170,7 @@ declare const _default: {
     "999": string[];
     "1001": string[];
     "1007": string[];
+    "1008": string[];
     "1010": string[];
     "1012": string[];
     "1022": string[];
@@ -197,6 +199,7 @@ declare const _default: {
     "1688": string[];
     "1856": string[];
     "1898": string[];
+    "1984": string[];
     "1987": string[];
     "2001": string[];
     "2020": string[];

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

@@ -379,6 +379,9 @@ exports.default = {
     "288": [
         "Boba"
     ],
+    "300": [
+        "ogc"
+    ],
     "321": [
         "kcs"
     ],
@@ -517,6 +520,9 @@ exports.default = {
     "1007": [
         "tnew"
     ],
+    "1008": [
+        "eun"
+    ],
     "1010": [
         "EVC"
     ],
@@ -601,6 +607,9 @@ exports.default = {
     "1898": [
         "boya"
     ],
+    "1984": [
+        "euntest"
+    ],
     "1987": [
         "egem"
     ],

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

@@ -15,5 +15,11 @@ export declare class TinyBig extends Big {
 }
 /**
  * Helper factory function so that you don't have to type "new" when instantiating a new TinyBig
+ *
+ * @example
+ * ```javascript
+ * tinyBig(10).times(3).toNumber()
+ * // 30
+ * ```
  */
 export declare function tinyBig(value: string | number | TinyBig | Big): TinyBig;

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

@@ -34,6 +34,12 @@ class TinyBig extends big_js_1.default {
 exports.TinyBig = TinyBig;
 /**
  * Helper factory function so that you don't have to type "new" when instantiating a new TinyBig
+ *
+ * @example
+ * ```javascript
+ * tinyBig(10).times(3).toNumber()
+ * // 30
+ * ```
  */
 function tinyBig(value) {
     return new TinyBig(value);

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

@@ -0,0 +1,26 @@
+import Big from 'big.js';
+import { TinyBig } from '../shared/tiny-big/tiny-big';
+/**
+ * Convert from Ether to Gwei
+ *
+ * No direct equivalent in ether.js; requires multiple functions to achieve.
+ *
+ * No direct equivalent in web3; requires multiple functions to achieve.
+ *
+ * @example
+ * ```javascript
+ * etherToGwei('1000').toString()
+ * // '1000000000000'
+ * etherToGwei(1000).toString()
+ * // '1000000000000'
+ * ```
+ *
+ * @example
+ * ```javascript
+ * etherToGwei('1000').toNumber()
+ * // 1000000000000
+ * etherToGwei(1000).toNumber()
+ * // 1000000000000
+ * ```
+ */
+export declare function etherToGwei(etherQuantity: string | number | TinyBig | Big): TinyBig;

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

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.etherToGwei = void 0;
+const tiny_big_1 = require("../shared/tiny-big/tiny-big");
+const validate_type_1 = require("../shared/validate-type");
+/**
+ * Convert from Ether to Gwei
+ *
+ * No direct equivalent in ether.js; requires multiple functions to achieve.
+ *
+ * No direct equivalent in web3; requires multiple functions to achieve.
+ *
+ * @example
+ * ```javascript
+ * etherToGwei('1000').toString()
+ * // '1000000000000'
+ * etherToGwei(1000).toString()
+ * // '1000000000000'
+ * ```
+ *
+ * @example
+ * ```javascript
+ * etherToGwei('1000').toNumber()
+ * // 1000000000000
+ * etherToGwei(1000).toNumber()
+ * // 1000000000000
+ * ```
+ */
+function etherToGwei(etherQuantity) {
+    (0, validate_type_1.validateType)(etherQuantity, ['string', 'number', 'object']);
+    const result = (0, tiny_big_1.tinyBig)(etherQuantity).times('1000000000');
+    return (0, tiny_big_1.tinyBig)(result);
+}
+exports.etherToGwei = etherToGwei;

package/lib/cjs/utils/ether-to-wei.d.ts

@@ -1,9 +1,11 @@
 import Big from 'big.js';
 import { TinyBig } from '../shared/tiny-big/tiny-big';
 /**
- * Similar to ["parseEther" in ethers.js](https://docs.ethers.io/v4/api-utils.html#ether-strings-and-wei)
+ * Convert Ether to Wei
  *
- * Similar to ["toWei" in web3](https://web3js.readthedocs.io/en/v1.2.11/web3-utils.html?highlight=towei#towei)
+ * Similar to ["parseEther" in ethers.js](https://docs.ethers.io/v5/api/utils/display-logic/#utils-parseEther)
+ *
+ * Similar to ["toWei" in web3.js](https://web3js.readthedocs.io/en/v1.7.1/web3-utils.html#towei)
  *
  * @example
  * ```javascript

package/lib/cjs/utils/ether-to-wei.js

@@ -4,9 +4,11 @@ exports.etherToWei = void 0;
 const tiny_big_1 = require("../shared/tiny-big/tiny-big");
 const validate_type_1 = require("../shared/validate-type");
 /**
- * Similar to ["parseEther" in ethers.js](https://docs.ethers.io/v4/api-utils.html#ether-strings-and-wei)
+ * Convert Ether to Wei
  *
- * Similar to ["toWei" in web3](https://web3js.readthedocs.io/en/v1.2.11/web3-utils.html?highlight=towei#towei)
+ * Similar to ["parseEther" in ethers.js](https://docs.ethers.io/v5/api/utils/display-logic/#utils-parseEther)
+ *
+ * Similar to ["toWei" in web3.js](https://web3js.readthedocs.io/en/v1.7.1/web3-utils.html#towei)
  *
  * @example
  * ```javascript

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

@@ -0,0 +1,26 @@
+import Big from 'big.js';
+import { TinyBig } from './../shared/tiny-big/tiny-big';
+/**
+ * Convert from Gwei to Ether
+ *
+ * No direct equivalent in ethers.js; requires multiple functions to achieve.
+ *
+ * No direct equivalent in web3; requires multiple functions to achieve.
+ *
+ * @example
+ * ```javascript
+ * gweiToEther('1000000000000').toString()
+ * // '1000'
+ * gweiToEther(1000000000000).toString()
+ * // '1000'
+ * ```
+ *
+ * @example
+ * ```javascript
+ * gweiToEther('1000000000000').toNumber()
+ * // 1000
+ * gweiToEther(1000000000000).toNumber()
+ * // 1000
+ * ```
+ */
+export declare function gweiToEther(gweiQuantity: string | number | TinyBig | Big): TinyBig;

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

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.gweiToEther = void 0;
+const tiny_big_1 = require("../shared/tiny-big/tiny-big");
+const validate_type_1 = require("../shared/validate-type");
+/**
+ * Convert from Gwei to Ether
+ *
+ * No direct equivalent in ethers.js; requires multiple functions to achieve.
+ *
+ * No direct equivalent in web3; requires multiple functions to achieve.
+ *
+ * @example
+ * ```javascript
+ * gweiToEther('1000000000000').toString()
+ * // '1000'
+ * gweiToEther(1000000000000).toString()
+ * // '1000'
+ * ```
+ *
+ * @example
+ * ```javascript
+ * gweiToEther('1000000000000').toNumber()
+ * // 1000
+ * gweiToEther(1000000000000).toNumber()
+ * // 1000
+ * ```
+ */
+function gweiToEther(gweiQuantity) {
+    (0, validate_type_1.validateType)(gweiQuantity, ['string', 'number', 'object']);
+    const result = (0, tiny_big_1.tinyBig)(gweiQuantity).div('1000000000');
+    return (0, tiny_big_1.tinyBig)(result);
+}
+exports.gweiToEther = gweiToEther;

package/lib/cjs/utils/is-address.d.ts

@@ -1,5 +1,24 @@
 /**
  * Returns a boolean as to whether the input is a valid address.
  * Does NOT support ICAP addresses
+ *
+ * @example
+ * ```javascript
+ * isAddress('0xc0deaf6bd3f0c6574a6a625ef2f22f62a5150eab');
+ * // true
+ * ```
+ *
+ * @example
+ * ```javascript
+ * isAddress('bad');
+ * // false
+ * ```
+ *
+ * @example
+ * ```javascript
+ * // Does NOT support ENS.
+ * isAddress('vitalik.eth');
+ * // false
+ * ```
  */
 export declare function isAddress(address: string): boolean;

package/lib/cjs/utils/is-address.js

@@ -6,6 +6,25 @@ const validate_type_1 = require("../shared/validate-type");
 /**
  * Returns a boolean as to whether the input is a valid address.
  * Does NOT support ICAP addresses
+ *
+ * @example
+ * ```javascript
+ * isAddress('0xc0deaf6bd3f0c6574a6a625ef2f22f62a5150eab');
+ * // true
+ * ```
+ *
+ * @example
+ * ```javascript
+ * isAddress('bad');
+ * // false
+ * ```
+ *
+ * @example
+ * ```javascript
+ * // Does NOT support ENS.
+ * isAddress('vitalik.eth');
+ * // false
+ * ```
  */
 function isAddress(address) {
     (0, validate_type_1.validateType)(address, ['string']);

package/lib/cjs/utils/to-checksum-address.d.ts

@@ -10,8 +10,8 @@
  * // '0xfB6916095ca1df60bB79Ce92cE3Ea74c37c5d359'
  * ```
  *
- * Similar to ["getAddress" in ethers.js](https://docs.ethers.io/v4/api-utils.html#utils-getaddress)
+ * Similar to ["getAddress" in ethers.js](https://docs.ethers.io/v5/api/utils/address/#utils-getAddress)
  *
- * Similar to ["toChecksumAddress" in web3](https://web3js.readthedocs.io/en/v1.2.11/web3-utils.html#tochecksumaddress)
+ * Similar to ["toChecksumAddress" in web3.js](https://web3js.readthedocs.io/en/v1.7.1/web3-utils.html#tochecksumaddress)
  */
 export declare function toChecksumAddress(address: string): string;

package/lib/cjs/utils/to-checksum-address.js

@@ -15,9 +15,9 @@ const validate_type_1 = require("../shared/validate-type");
  * // '0xfB6916095ca1df60bB79Ce92cE3Ea74c37c5d359'
  * ```
  *
- * Similar to ["getAddress" in ethers.js](https://docs.ethers.io/v4/api-utils.html#utils-getaddress)
+ * Similar to ["getAddress" in ethers.js](https://docs.ethers.io/v5/api/utils/address/#utils-getAddress)
  *
- * Similar to ["toChecksumAddress" in web3](https://web3js.readthedocs.io/en/v1.2.11/web3-utils.html#tochecksumaddress)
+ * Similar to ["toChecksumAddress" in web3.js](https://web3js.readthedocs.io/en/v1.7.1/web3-utils.html#tochecksumaddress)
  */
 function toChecksumAddress(address) {
     (0, validate_type_1.validateType)(address, ['string']);

package/lib/cjs/utils/wei-to-ether.d.ts

@@ -1,26 +1,26 @@
 import Big from 'big.js';
-import { TinyBig } from './../shared/tiny-big/tiny-big';
+import { TinyBig } from '../shared/tiny-big/tiny-big';
 /**
- * Convert from Ether to Wei
+ * Convert from Wei to Ether
  *
- * Similar to ["formatEther" in ethers.js](https://docs.ethers.io/v4/api-utils.html#ether-strings-and-wei)
+ * Similar to ["formatEther" in ethers.js](https://docs.ethers.io/v5/api/utils/display-logic/#utils-formatEther)
  *
- * Similar to ["fromWei" in web3](https://web3js.readthedocs.io/en/v1.2.11/web3-utils.html#fromwei)
+ * Similar to ["fromWei" in web3.js](https://web3js.readthedocs.io/en/v1.7.1/web3-utils.html#fromwei)
  *
  * @example
  * ```javascript
- * etherToWei('1000').toString()
- * // '1000000000000000000000'
- * etherToWei(1000).toString()
- * '1000000000000000000000'
+ * weiToEther('1000000000000000000000').toString()
+ * // '1000'
+ * weiToEther(1000000000000000000000).toString()
+ * // '1000'
  * ```
  *
  * @example
  * ```javascript
- * etherToWei('1000').toNumber()
- * // 1000000000000000000000
- * etherToWei(1000).toNumber()
- * // 1000000000000000000000
+ * weiToEther('1000000000000000000000').toNumber()
+ * // 1000
+ * weiToEther(1000000000000000000000).toNumber()
+ * // 1000
  * ```
  */
 export declare function weiToEther(weiQuantity: string | number | TinyBig | Big): TinyBig;

package/lib/cjs/utils/wei-to-ether.js

@@ -4,26 +4,26 @@ exports.weiToEther = void 0;
 const tiny_big_1 = require("../shared/tiny-big/tiny-big");
 const validate_type_1 = require("../shared/validate-type");
 /**
- * Convert from Ether to Wei
+ * Convert from Wei to Ether
  *
- * Similar to ["formatEther" in ethers.js](https://docs.ethers.io/v4/api-utils.html#ether-strings-and-wei)
+ * Similar to ["formatEther" in ethers.js](https://docs.ethers.io/v5/api/utils/display-logic/#utils-formatEther)
  *
- * Similar to ["fromWei" in web3](https://web3js.readthedocs.io/en/v1.2.11/web3-utils.html#fromwei)
+ * Similar to ["fromWei" in web3.js](https://web3js.readthedocs.io/en/v1.7.1/web3-utils.html#fromwei)
  *
  * @example
  * ```javascript
- * etherToWei('1000').toString()
- * // '1000000000000000000000'
- * etherToWei(1000).toString()
- * '1000000000000000000000'
+ * weiToEther('1000000000000000000000').toString()
+ * // '1000'
+ * weiToEther(1000000000000000000000).toString()
+ * // '1000'
  * ```
  *
  * @example
  * ```javascript
- * etherToWei('1000').toNumber()
- * // 1000000000000000000000
- * etherToWei(1000).toNumber()
- * // 1000000000000000000000
+ * weiToEther('1000000000000000000000').toNumber()
+ * // 1000
+ * weiToEther(1000000000000000000000).toNumber()
+ * // 1000
  * ```
  */
 function weiToEther(weiQuantity) {

package/lib/esm/index.d.ts

@@ -5,8 +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 { 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, 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/esm/index.js

@@ -1,8 +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, isAddress, jsonRpcProvider, JsonRpcProvider, tinyBig, toChecksumAddress, weiToEther, Contract, TinyBig, };
+export { etherToWei, etherToGwei, isAddress, jsonRpcProvider, JsonRpcProvider, tinyBig, toChecksumAddress, weiToEther, gweiToEther, Contract, TinyBig, };

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

@@ -1,3 +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

@@ -1,3 +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/lib/esm/providers/utils/chains-info.d.ts

@@ -123,6 +123,7 @@ declare const _default: {
     "262": string[];
     "269": string[];
     "288": string[];
+    "300": string[];
     "321": string[];
     "322": string[];
     "333": string[];
@@ -169,6 +170,7 @@ declare const _default: {
     "999": string[];
     "1001": string[];
     "1007": string[];
+    "1008": string[];
     "1010": string[];
     "1012": string[];
     "1022": string[];
@@ -197,6 +199,7 @@ declare const _default: {
     "1688": string[];
     "1856": string[];
     "1898": string[];
+    "1984": string[];
     "1987": string[];
     "2001": string[];
     "2020": string[];

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

@@ -375,6 +375,9 @@ export default {
     "288": [
         "Boba"
     ],
+    "300": [
+        "ogc"
+    ],
     "321": [
         "kcs"
     ],
@@ -513,6 +516,9 @@ export default {
     "1007": [
         "tnew"
     ],
+    "1008": [
+        "eun"
+    ],
     "1010": [
         "EVC"
     ],
@@ -597,6 +603,9 @@ export default {
     "1898": [
         "boya"
     ],
+    "1984": [
+        "euntest"
+    ],
     "1987": [
         "egem"
     ],

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/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,7 +1,7 @@
 {
   "name": "essential-eth",
   "description": "Ultralight JS library for Ethereum utilities",
-  "version": "0.4.9",
+  "version": "0.4.10",
   "license": "MIT",
   "sideEffects": false,
   "main": "./lib/cjs/index.js",
@@ -36,8 +36,8 @@
     "@types/jest-dev-server": "^5.0.0",
     "@types/node": "^16.10.1",
     "@types/prettier": "^2.4.4",
-    "@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",

package/readme.md

@@ -126,6 +126,56 @@ weiToEther('1000000000000000000').toNumber();
 
 <br/>
 
+#### `gweiToEther`
+
+```typescript
+gweiToEther(gweiQuantity: string | number | TinyBig | Big): TinyBig
+```
+
+<details>
+  <summary>View Example</summary>
+
+```typescript
+import { gweiToEther } from 'essential-eth';
+
+gweiToEther(1000000000).toString();
+// "1"
+
+gweiToEther(1000000000).toNumber();
+// 1
+gweiToEther('1000000000').toNumber();
+// 1
+```
+
+</details>
+
+<br/>
+
+#### `etherToGwei`
+
+```typescript
+etherToGwei(etherQuantity: string | number | TinyBig | Big): TinyBig
+```
+
+<details>
+  <summary>View Example</summary>
+
+```typescript
+import { etherToGwei } from 'essential-eth';
+
+etherToGwei(0.000000001).toString();
+// "1"
+
+etherToGwei(0.000000001).toNumber();
+// 1
+etherToGwei('0.000000001').toNumber();
+// 1
+```
+
+</details>
+
+<br/>
+
 #### `toChecksumAddress`
 
 ```typescript