essential-eth 0.5.11-next.1 → 0.5.12

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

@@ -0,0 +1,17 @@
+/**
+ * Converts a string in scientific notation formatting to string in decimal format
+ *
+ * @param scientificString a string in scientific format to convert to decimal
+ * @returns a string of a decimal number equivalent to the specified scientificString
+ * @example
+ * ```javascript
+ * scientificStrToDecimalStr('2.3e-5');
+ * // '0.000023'
+ * ```
+ * @example
+ * ```javascript
+ * scientificStrToDecimalStr('2.3e+5');
+ * // '230000'
+ * ```
+ */
+export declare function scientificStrToDecimalStr(scientificString: string): string;

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

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scientificStrToDecimalStr = void 0;
+/**
+ * Strips both leading and trailing zeroes from a number string
+ *
+ * @param numberString the string of numbers to strip zeros from
+ * @returns a string of numbers without leading or trailing zeros
+ * @example
+ * ```javascript
+ * stripTrailingZeros('0005280');
+ * // '5280'
+ * ```
+ */
+function stripTrailingZeroes(numberString) {
+    const isNegative = numberString.startsWith('-');
+    numberString = numberString.replace('-', '');
+    numberString = numberString.replace(/\.0*$/g, '' /* for numbers like "1.0" -> "1" */);
+    numberString = numberString.replace(/^0+/, '');
+    // for numbers like "1.10" -> "1.1"
+    if (numberString.includes('.')) {
+        numberString = numberString.replace(/0+$/, '');
+    }
+    if (numberString.startsWith('.')) {
+        // so that ".1" returns as "0.1"
+        numberString = `0${numberString}`;
+    }
+    return `${isNegative ? '-' : ''}${numberString}`;
+}
+/**
+ * Converts a string in scientific notation formatting to string in decimal format
+ *
+ * @param scientificString a string in scientific format to convert to decimal
+ * @returns a string of a decimal number equivalent to the specified scientificString
+ * @example
+ * ```javascript
+ * scientificStrToDecimalStr('2.3e-5');
+ * // '0.000023'
+ * ```
+ * @example
+ * ```javascript
+ * scientificStrToDecimalStr('2.3e+5');
+ * // '230000'
+ * ```
+ */
+function scientificStrToDecimalStr(scientificString) {
+    // Does not contain "e" nor "E"
+    if (!scientificString.match(/e/i /* lowercase and uppercase E */)) {
+        return stripTrailingZeroes(scientificString);
+    }
+    // eslint-disable-next-line prefer-const
+    let [base, power] = scientificString.split(/e/i /* lowercase and uppercase E */);
+    // remove the leading "-" if negative
+    const isNegative = Number(base) < 0;
+    base = base.replace('-', '');
+    base = stripTrailingZeroes(base);
+    const [wholeNumber, fraction /* move decimal this many places */ = ''] = base.split('.');
+    if (Number(power) === 0) {
+        return `${isNegative ? '-' : ''}${stripTrailingZeroes(base)}`;
+    }
+    else {
+        const includesDecimal = base.includes('.');
+        if (!includesDecimal) {
+            base = `${base}.`;
+        }
+        base = base.replace('.', '');
+        const baseLength = base.length;
+        let splitPaddedNumber;
+        if (Number(power) < 0) {
+            // move decimal left
+            if (wholeNumber.length < Math.abs(Number(power))) {
+                base = base.padStart(baseLength + Math.abs(Number(power)) - wholeNumber.length, '0');
+            }
+            splitPaddedNumber = base.split('');
+            if (wholeNumber.length < Math.abs(Number(power))) {
+                // starts with zeroes
+                splitPaddedNumber = ['.', ...splitPaddedNumber];
+            }
+            else {
+                splitPaddedNumber.splice(splitPaddedNumber.length - Math.abs(Number(power)), 0, '.');
+            }
+        }
+        else {
+            // move decimal right
+            if (fraction.length < Math.abs(Number(power))) {
+                base = base.padEnd(baseLength + Math.abs(Number(power)) - fraction.length, '0');
+            }
+            splitPaddedNumber = base.split('');
+            if (fraction.length > Math.abs(Number(power))) {
+                splitPaddedNumber.splice(splitPaddedNumber.length - Math.abs(Number(power)), 0, '.');
+            }
+        }
+        const toReturn = stripTrailingZeroes(splitPaddedNumber.join(''));
+        return `${isNegative ? '-' : ''}${toReturn}`;
+    }
+}
+exports.scientificStrToDecimalStr = scientificStrToDecimalStr;

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

@@ -0,0 +1,58 @@
+import Big from 'big.js';
+/**
+ * A wrapper around [big.js](https://github.com/MikeMcl/big.js) which expands scientific notation and creates a "toHexString" function.
+ * This is the return type of every operation on ether, wei, etc.
+ */
+export declare class TinyBig extends Big {
+    constructor(value: string | number | TinyBig | Big);
+    /**
+     * Used anytime you're passing in "value" to ethers or web3
+     * For now, TypeScript will complain that `TinyBig` is not a `BigNumberish`. You can // @ts-ignore or call this
+     *
+     * @returns the TinyBig represented as a hex string
+     * @example
+     * ```javascript
+     * tinyBig(293).toHexString();
+     * // '0x125'
+     * ```
+     * @example
+     * ```javascript
+     * tinyBig(681365874).toHexString();
+     * // '0x289cd172'
+     */
+    toHexString(): string;
+    toNumber(): number;
+    toString(): string;
+    /**
+     * Eithers pads or shortens a string to a specified length
+     *
+     * @param str the string to pad or chop
+     * @param padChar the character to pad the string with
+     * @param length the desired length of the given string
+     * @returns a string of the desired length, either padded with the specified padChar or with the beginning of the string chopped off
+     * @example
+     * ```javascript
+     * padAndChop('essential-eth', 'a', 8);
+     * // 'tial-eth'
+     * ```
+     * @example
+     * ```javascript
+     * padAndChop('essential-eth', 'A', 20);
+     * // 'AAAAAAAessential-eth'
+     * ```
+     */
+    private padAndChop;
+    toTwos(bitCount: number): Big;
+}
+/**
+ * Helper factory function so that you don't have to type "new" when instantiating a new TinyBig
+ *
+ * @param value the value to initiate the TinyBig with
+ * @returns an initiated {@link 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

@@ -0,0 +1,101 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tinyBig = exports.TinyBig = void 0;
+const big_js_1 = __importDefault(require("big.js"));
+const hex_to_decimal_1 = require("../../classes/utils/hex-to-decimal");
+const helpers_1 = require("./helpers");
+/**
+ * A wrapper around [big.js](https://github.com/MikeMcl/big.js) which expands scientific notation and creates a "toHexString" function.
+ * This is the return type of every operation on ether, wei, etc.
+ */
+class TinyBig extends big_js_1.default {
+    constructor(value) {
+        if (typeof value === 'string' && value.startsWith('0x')) {
+            value = (0, hex_to_decimal_1.hexToDecimal)(value);
+        }
+        super(value);
+        /**
+         * Eithers pads or shortens a string to a specified length
+         *
+         * @param str the string to pad or chop
+         * @param padChar the character to pad the string with
+         * @param length the desired length of the given string
+         * @returns a string of the desired length, either padded with the specified padChar or with the beginning of the string chopped off
+         * @example
+         * ```javascript
+         * padAndChop('essential-eth', 'a', 8);
+         * // 'tial-eth'
+         * ```
+         * @example
+         * ```javascript
+         * padAndChop('essential-eth', 'A', 20);
+         * // 'AAAAAAAessential-eth'
+         * ```
+         */
+        this.padAndChop = (str, padChar, length) => {
+            return (Array(length).fill(padChar).join('') + str).slice(length * -1);
+        };
+    }
+    /**
+     * Used anytime you're passing in "value" to ethers or web3
+     * For now, TypeScript will complain that `TinyBig` is not a `BigNumberish`. You can // @ts-ignore or call this
+     *
+     * @returns the TinyBig represented as a hex string
+     * @example
+     * ```javascript
+     * tinyBig(293).toHexString();
+     * // '0x125'
+     * ```
+     * @example
+     * ```javascript
+     * tinyBig(681365874).toHexString();
+     * // '0x289cd172'
+     */
+    toHexString() {
+        return `0x${BigInt(this.toString()).toString(16)}`;
+    }
+    toNumber() {
+        return Number((0, helpers_1.scientificStrToDecimalStr)(super.toString()));
+    }
+    toString() {
+        if (this.toNumber() === 0) {
+            return '0';
+        }
+        return (0, helpers_1.scientificStrToDecimalStr)(super.toString());
+    }
+    toTwos(bitCount) {
+        let binaryStr;
+        if (this.gte(0)) {
+            const twosComp = this.toNumber().toString(2);
+            binaryStr = this.padAndChop(twosComp, '0', bitCount || twosComp.length);
+        }
+        else {
+            binaryStr = this.plus(Math.pow(2, bitCount)).toNumber().toString(2);
+            if (Number(binaryStr) < 0) {
+                throw new Error('Cannot calculate twos complement');
+            }
+        }
+        const binary = `0b${binaryStr}`;
+        const decimal = Number(binary);
+        return tinyBig(decimal);
+    }
+}
+exports.TinyBig = TinyBig;
+/**
+ * Helper factory function so that you don't have to type "new" when instantiating a new TinyBig
+ *
+ * @param value the value to initiate the TinyBig with
+ * @returns an initiated {@link TinyBig}
+ * @example
+ * ```javascript
+ * tinyBig(10).times(3).toNumber()
+ * // 30
+ * ```
+ */
+function tinyBig(value) {
+    return new TinyBig(value);
+}
+exports.tinyBig = tinyBig;

package/{dist → lib/cjs}/shared/validate-type.d.ts

@@ -1,3 +1,3 @@
-declare type JSPrimitiveTypes = 'string' | 'number' | 'bigint' | 'boolean' | 'symbol' | 'undefined' | 'object' | 'function';
-export declare const validateType: (value: unknown, allowedTypes: JSPrimitiveTypes[]) => void;
-export {};
+declare type JSPrimitiveTypes = 'string' | 'number' | 'bigint' | 'boolean' | 'symbol' | 'undefined' | 'object' | 'function';
+export declare const validateType: (value: unknown, allowedTypes: JSPrimitiveTypes[]) => void;
+export {};

package/lib/cjs/shared/validate-type.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateType = void 0;
+const validateType = (value, allowedTypes) => {
+    if (!allowedTypes.includes(typeof value)) {
+        throw new Error(`${allowedTypes.join(' or ')} required. Received ${typeof value}`);
+    }
+};
+exports.validateType = validateType;

package/{dist → lib/cjs}/types/Block.types.d.ts

@@ -1,40 +1,41 @@
-import type { TinyBig } from './../shared/tiny-big/tiny-big';
-import type { BlockTransactionResponse, RPCTransaction } from './Transaction.types';
-declare type Modify<T, R> = Omit<T, keyof R> & R;
-export declare type BlockResponse = Modify<RPCBlock, {
-    baseFeePerGas: TinyBig;
-    difficulty: TinyBig;
-    gasLimit: TinyBig;
-    gasUsed: TinyBig;
-    nonce: TinyBig;
-    number: number;
-    size: TinyBig;
-    timestamp: TinyBig;
-    totalDifficulty: TinyBig;
-    transactions: Array<string | BlockTransactionResponse>;
-}>;
-export interface RPCBlock {
-    baseFeePerGas: string;
-    difficulty: string;
-    extraData: string;
-    gasLimit: string;
-    gasUsed: string;
-    hash: string;
-    logsBloom: string;
-    miner: string;
-    mixHash: string;
-    nonce: string;
-    number: string;
-    parentHash: string;
-    receiptsRoot: string;
-    sha3Uncles: string;
-    size: string;
-    stateRoot: string;
-    timestamp: string;
-    totalDifficulty: string;
-    transactions: Array<string | RPCTransaction>;
-    transactionsRoot: string;
-    uncles: Array<string>;
-}
-export declare type BlockTag = 'latest' | 'earliest' | 'pending' | number | string;
-export {};
+import type { TinyBig } from './../shared/tiny-big/tiny-big';
+import type { BlockTransactionResponse, RPCTransaction } from './Transaction.types';
+declare type Modify<T, R> = Omit<T, keyof R> & R;
+export declare type BlockResponse = Modify<RPCBlock, {
+    baseFeePerGas: TinyBig;
+    difficulty: TinyBig;
+    gasLimit: TinyBig;
+    gasUsed: TinyBig;
+    nonce: TinyBig;
+    number: number;
+    size: TinyBig;
+    timestamp: TinyBig;
+    totalDifficulty: TinyBig;
+    transactions: Array<string | BlockTransactionResponse>;
+}>;
+/** Exact response from backend */
+export interface RPCBlock {
+    baseFeePerGas: string;
+    difficulty: string;
+    extraData: string;
+    gasLimit: string;
+    gasUsed: string;
+    hash: string;
+    logsBloom: string;
+    miner: string;
+    mixHash: string;
+    nonce: string;
+    number: string;
+    parentHash: string;
+    receiptsRoot: string;
+    sha3Uncles: string;
+    size: string;
+    stateRoot: string;
+    timestamp: string;
+    totalDifficulty: string;
+    transactions: Array<string | RPCTransaction>;
+    transactionsRoot: string;
+    uncles: Array<string>;
+}
+export declare type BlockTag = 'latest' | 'earliest' | 'pending' | number | string;
+export {};

package/lib/cjs/types/Block.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/{dist → lib/cjs}/types/Contract.types.d.ts

@@ -1,24 +1,24 @@
-export declare type ContractTypes = 'bool' | 'bytes1' | 'bytes2' | 'bytes3' | 'bytes4' | 'bytes5' | 'bytes6' | 'bytes7' | 'bytes8' | 'bytes9' | 'bytes10' | 'bytes11' | 'bytes12' | 'bytes13' | 'bytes14' | 'bytes15' | 'bytes16' | 'bytes17' | 'bytes18' | 'bytes19' | 'bytes20' | 'bytes21' | 'bytes22' | 'bytes23' | 'bytes24' | 'bytes25' | 'bytes26' | 'bytes27' | 'bytes28' | 'bytes29' | 'bytes30' | 'bytes31' | 'bytes32' | 'bytes32[]' | 'address' | 'address payable' | 'address[4]' | 'address[100]' | 'uint256' | 'uint256[100]' | 'uint8' | 'uint32' | string;
-export declare type ContractInterface = JSONABI;
-export declare type ContractFunction<T = any> = (...args: Array<any>) => Promise<T>;
-export interface JSONABIArgument {
-    anonymous?: false;
-    inputs: {
-        internalType?: ContractTypes | string;
-        name: string;
-        type: ContractTypes;
-        indexed?: boolean;
-    }[];
-    name?: string;
-    outputs?: {
-        internalType?: ContractTypes | string;
-        name: string;
-        type: ContractTypes;
-    }[];
-    stateMutability?: 'view' | 'nonpayable' | string;
-    type: 'function' | 'event' | 'constructor' | 'error' | 'fallback';
-    gas?: number;
-    constant?: boolean;
-    payable?: boolean;
-}
-export declare type JSONABI = JSONABIArgument[];
+export declare type ContractTypes = 'bool' | 'bytes1' | 'bytes2' | 'bytes3' | 'bytes4' | 'bytes5' | 'bytes6' | 'bytes7' | 'bytes8' | 'bytes9' | 'bytes10' | 'bytes11' | 'bytes12' | 'bytes13' | 'bytes14' | 'bytes15' | 'bytes16' | 'bytes17' | 'bytes18' | 'bytes19' | 'bytes20' | 'bytes21' | 'bytes22' | 'bytes23' | 'bytes24' | 'bytes25' | 'bytes26' | 'bytes27' | 'bytes28' | 'bytes29' | 'bytes30' | 'bytes31' | 'bytes32' | 'bytes32[]' | 'address' | 'address payable' | 'address[4]' | 'address[100]' | 'uint256' | 'uint256[100]' | 'uint8' | 'uint32' | string;
+export declare type ContractInterface = JSONABI;
+export declare type ContractFunction<T = any> = (...args: Array<any>) => Promise<T>;
+export interface JSONABIArgument {
+    anonymous?: false;
+    inputs: {
+        internalType?: ContractTypes | string;
+        name: string;
+        type: ContractTypes;
+        indexed?: boolean;
+    }[];
+    name?: string;
+    outputs?: {
+        internalType?: ContractTypes | string;
+        name: string;
+        type: ContractTypes;
+    }[];
+    stateMutability?: 'view' | 'nonpayable' | string;
+    type: 'function' | 'event' | 'constructor' | 'error' | 'fallback';
+    gas?: number;
+    constant?: boolean;
+    payable?: boolean;
+}
+export declare type JSONABI = JSONABIArgument[];

package/lib/cjs/types/Contract.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/cjs/types/Filter.types.d.ts

@@ -0,0 +1,16 @@
+import type { BlockTag } from './Block.types';
+export interface EventFilter {
+    address?: string;
+    topics?: Array<string | Array<string> | null>;
+}
+/**
+ * @param fromBlock block as starting point for range, inclusive
+ * @param toBlock block as ending point for range, inclusive
+ */
+export interface Filter extends EventFilter {
+    fromBlock?: BlockTag;
+    toBlock?: BlockTag;
+}
+export interface FilterByBlockHash extends EventFilter {
+    blockHash?: string;
+}

package/lib/cjs/types/Filter.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/cjs/types/Network.types.d.ts

@@ -0,0 +1,8 @@
+/**
+ * A trimmed version of https://chainid.network/chains.json
+ */
+export interface Network {
+    chainId: number;
+    ensAddress: string | null;
+    name: string;
+}

package/lib/cjs/types/Network.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/cjs/types/Transaction.types.d.ts

@@ -0,0 +1,123 @@
+import type Big from 'big.js';
+import type { TinyBig } from '../shared/tiny-big/tiny-big';
+import type { BytesLike } from './../utils/bytes';
+declare type Modify<T, R> = Omit<T, keyof R> & R;
+export interface RPCTransaction extends RPCBlockTransaction {
+    maxFeePerGas: string;
+    maxPriorityFeePerGas: string;
+}
+export declare type TransactionResponse = Modify<RPCTransaction, {
+    blockNumber: number;
+    chainId: number;
+    gas: TinyBig;
+    gasLimit: TinyBig;
+    gasPrice: TinyBig;
+    nonce: TinyBig;
+    transactionIndex: number;
+    type: number;
+    v: number;
+    value: TinyBig;
+} & {
+    maxFeePerGas: TinyBig;
+    maxPriorityFeePerGas: TinyBig;
+    confirmations: number;
+}>;
+/**
+ * Type that contains information from the receipt of a transaction
+ *
+ * * Similar to [`Type TransactionReceipt on ethers.providers`](https://docs.ethers.io/v5/api/providers/types/#providers-TransactionReceipt)
+ */
+export declare type TransactionReceipt = Modify<RPCTransactionReceipt, {
+    blockNumber: number;
+    cumulativeGasUsed: TinyBig;
+    effectiveGasPrice: TinyBig;
+    gasUsed: TinyBig;
+    logs: Array<Log>;
+    status: number;
+    transactionIndex: number;
+    type: number;
+} & {
+    byzantium: boolean;
+    confirmations: number;
+}>;
+export interface RPCTransactionRequest {
+    from?: string;
+    to: string;
+    gas?: string;
+    gasPrice?: string;
+    value?: string;
+    data?: BytesLike;
+    nonce?: string;
+    maxPriorityFeePerGas?: string;
+    maxFeePerGas?: string;
+}
+export interface TransactionRequest {
+    to?: string;
+    from?: string;
+    nonce?: TinyBig | string | Big | number;
+    gas?: TinyBig | number | Big | string;
+    gasPrice?: TinyBig | Big | string | number;
+    data?: BytesLike;
+    value?: TinyBig | string | Big | number;
+    chainId?: number;
+    type?: number;
+    maxPriorityFeePerGas?: TinyBig | string | Big | number;
+    maxFeePerGas?: TinyBig | string | Big | number;
+}
+/**
+ * Type for the logs that are included in transaction receipts
+ * Similar to [`Type Log on ethers.providers`](https://docs.ethers.io/v5/api/providers/types/#providers-Log)
+ */
+export declare type Log = Modify<RPCLog, {
+    blockNumber: number;
+    logIndex: number;
+    transactionIndex: number;
+}>;
+export declare type BlockTransactionResponse = Omit<TransactionResponse, 'maxFeePerGas' | 'maxPriorityFeePerGas'>;
+/** What JSONRPC responds with in getBlock transaction array */
+export interface RPCBlockTransaction {
+    blockHash: string;
+    blockNumber: string;
+    chainId: string;
+    from: string;
+    gas: string;
+    gasPrice: string;
+    hash: string;
+    input: string;
+    nonce: string;
+    r: string;
+    s: string;
+    to: string;
+    transactionIndex: string;
+    type: string;
+    v: string;
+    value: string;
+}
+export interface RPCTransactionReceipt {
+    blockHash: string;
+    blockNumber: string;
+    contractAddress: string;
+    cumulativeGasUsed: string;
+    effectiveGasPrice: string;
+    from: string;
+    gasUsed: string;
+    logs: Array<RPCLog>;
+    logsBloom: string;
+    status: string;
+    to: string;
+    transactionHash: string;
+    transactionIndex: string;
+    type: string;
+}
+export interface RPCLog {
+    address: string;
+    blockHash: string;
+    blockNumber: string;
+    data: string;
+    logIndex: string;
+    removed?: boolean;
+    topics: Array<string>;
+    transactionHash: string;
+    transactionIndex: string;
+}
+export {};

package/lib/cjs/types/Transaction.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });