essential-eth 0.5.4 → 0.5.9

package/lib/esm/providers/BaseProvider.d.ts

@@ -1,7 +1,8 @@
 import { TinyBig } from '../shared/tiny-big/tiny-big';
 import { BlockResponse, BlockTag } from '../types/Block.types';
+import { Filter, FilterByBlockHash } from '../types/Filter.types';
 import { Network } from '../types/Network.types';
-import { TransactionReceipt, TransactionResponse } from '../types/Transaction.types';
+import { Log, TransactionReceipt, TransactionRequest, TransactionResponse } from '../types/Transaction.types';
 export declare abstract class BaseProvider {
     abstract selectRpcUrl(): string;
     abstract post(body: Record<string, unknown>): Promise<any>;
@@ -9,10 +10,15 @@ export declare abstract class BaseProvider {
     protected _post: (body: Record<string, unknown>) => Promise<any>;
     constructor(rpcUrls: string[]);
     getNetwork(): Promise<Network>;
+    getBlockNumber(): Promise<number>;
     getTransaction(transactionHash: string): Promise<TransactionResponse>;
     getTransactionReceipt(transactionHash: string): Promise<TransactionReceipt>;
     getTransactionCount(address: string, blockTag?: BlockTag): Promise<number>;
     getBlock(timeFrame?: BlockTag, returnTransactionObjects?: boolean): Promise<BlockResponse>;
     getGasPrice(): Promise<TinyBig>;
     getBalance(address: string, blockTag?: BlockTag): Promise<TinyBig>;
+    getCode(address: string, blockTag?: BlockTag): Promise<string>;
+    estimateGas(transaction: TransactionRequest): Promise<TinyBig>;
+    getLogs(filter: Filter | FilterByBlockHash): Promise<Array<Log>>;
+    call(transaction: TransactionRequest, blockTag?: BlockTag): Promise<string>;
 }

package/lib/esm/providers/BaseProvider.js

@@ -8,12 +8,20 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { cleanBlock } from '../classes/utils/clean-block';
+import { cleanLog } from '../classes/utils/clean-log';
 import { cleanTransaction } from '../classes/utils/clean-transaction';
 import { cleanTransactionReceipt } from '../classes/utils/clean-transaction-receipt';
 import { buildRPCPostBody, post } from '../classes/utils/fetchers';
 import { hexToDecimal } from '../classes/utils/hex-to-decimal';
+import { prepareTransaction } from '../classes/utils/prepare-transaction';
+import { logger } from '../logger/logger';
 import { tinyBig } from '../shared/tiny-big/tiny-big';
 import chainsInfo from './utils/chains-info';
+function prepBlockTag(blockTag) {
+    return typeof blockTag === 'number'
+        ? tinyBig(blockTag).toHexString()
+        : blockTag;
+}
 export class BaseProvider {
     constructor(rpcUrls) {
         this._rpcUrls = [];
@@ -32,6 +40,12 @@ export class BaseProvider {
             };
         });
     }
+    getBlockNumber() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const currentBlockNumber = (yield this.post(buildRPCPostBody('eth_blockNumber', [])));
+            return Number(hexToDecimal(currentBlockNumber));
+        });
+    }
     getTransaction(transactionHash) {
         return __awaiter(this, void 0, void 0, function* () {
             const [rpcTransaction, blockNumber] = yield Promise.all([
@@ -58,29 +72,22 @@ export class BaseProvider {
     }
     getTransactionCount(address, blockTag = 'latest') {
         return __awaiter(this, void 0, void 0, function* () {
-            if (typeof blockTag === 'number') {
-                blockTag = `0x${blockTag.toString(16)}`;
-            }
+            blockTag = prepBlockTag(blockTag);
             const transactionCount = (yield this.post(buildRPCPostBody('eth_getTransactionCount', [address, blockTag])));
             return Number(hexToDecimal(transactionCount));
         });
     }
     getBlock(timeFrame = 'latest', returnTransactionObjects = false) {
         return __awaiter(this, void 0, void 0, function* () {
-            let rpcTimeFrame;
             let type = 'Number';
-            if (typeof timeFrame === 'number') {
-                rpcTimeFrame = `0x${timeFrame.toString(16)}`;
-            }
-            else if (timeFrame.startsWith('0x')) {
-                rpcTimeFrame = timeFrame;
+            if (typeof timeFrame === 'string' && timeFrame.length === 66) {
                 type = 'Hash';
             }
             else {
-                rpcTimeFrame = timeFrame;
+                timeFrame = prepBlockTag(timeFrame);
             }
             const rpcBlock = (yield this.post(buildRPCPostBody(`eth_getBlockBy${type}`, [
-                rpcTimeFrame,
+                timeFrame,
                 returnTransactionObjects,
             ])));
             return cleanBlock(rpcBlock, returnTransactionObjects);
@@ -94,8 +101,57 @@ export class BaseProvider {
     }
     getBalance(address, blockTag = 'latest') {
         return __awaiter(this, void 0, void 0, function* () {
+            blockTag = prepBlockTag(blockTag);
             const hexBalance = (yield this.post(buildRPCPostBody('eth_getBalance', [address, blockTag])));
             return tinyBig(hexToDecimal(hexBalance));
         });
     }
+    getCode(address, blockTag = 'latest') {
+        return __awaiter(this, void 0, void 0, function* () {
+            blockTag = prepBlockTag(blockTag);
+            const contractCode = (yield this.post(buildRPCPostBody('eth_getCode', [address, blockTag])));
+            return contractCode;
+        });
+    }
+    estimateGas(transaction) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const rpcTransaction = prepareTransaction(transaction);
+            const gasUsed = (yield this.post(buildRPCPostBody('eth_estimateGas', [rpcTransaction])));
+            return tinyBig(hexToDecimal(gasUsed));
+        });
+    }
+    getLogs(filter) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const filterByRange = filter;
+            if (filterByRange.fromBlock)
+                filterByRange.fromBlock = prepBlockTag(filterByRange.fromBlock);
+            if (filterByRange.toBlock)
+                filterByRange.toBlock = prepBlockTag(filterByRange.toBlock);
+            const rpcLogs = (yield this.post(buildRPCPostBody('eth_getLogs', [filter])));
+            const logs = rpcLogs.map((log) => cleanLog(log, false));
+            return logs;
+        });
+    }
+    call(transaction, blockTag = 'latest') {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (transaction.gasPrice &&
+                (transaction.maxPriorityFeePerGas || transaction.maxFeePerGas)) {
+                logger.throwError('Cannot specify both "gasPrice" and ("maxPriorityFeePerGas" or "maxFeePerGas")', {
+                    gasPrice: transaction.gasPrice,
+                    maxFeePerGas: transaction.maxFeePerGas,
+                    maxPriorityFeePerGas: transaction.maxPriorityFeePerGas,
+                });
+            }
+            if (transaction.maxFeePerGas && transaction.maxPriorityFeePerGas) {
+                logger.throwError('Cannot specify both "maxFeePerGas" and "maxPriorityFeePerGas"', {
+                    maxFeePerGas: transaction.maxFeePerGas,
+                    maxPriorityFeePerGas: transaction.maxPriorityFeePerGas,
+                });
+            }
+            blockTag = prepBlockTag(blockTag);
+            const rpcTransaction = prepareTransaction(transaction);
+            const transactionRes = (yield this.post(buildRPCPostBody('eth_call', [rpcTransaction, blockTag])));
+            return transactionRes;
+        });
+    }
 }

package/lib/esm/providers/FallthroughProvider.d.ts

@@ -1,5 +1,5 @@
 import { BaseProvider } from './BaseProvider';
-interface ConstructorOptions {
+export interface ConstructorOptions {
     timeoutDuration?: number;
 }
 export declare class FallthroughProvider extends BaseProvider {
@@ -9,4 +9,3 @@ export declare class FallthroughProvider extends BaseProvider {
     constructor(rpcUrls: string[], options?: ConstructorOptions);
     post: (body: Record<string, unknown>) => Promise<any>;
 }
-export {};

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

@@ -119,6 +119,7 @@ declare const _default: {
     "222": string[];
     "225": string[];
     "226": string[];
+    "239": string[];
     "246": string[];
     "250": string[];
     "256": string[];
@@ -143,10 +144,14 @@ declare const _default: {
     "499": string[];
     "512": string[];
     "513": string[];
+    "534": string[];
     "555": string[];
     "558": string[];
     "588": string[];
+    "592": string[];
     "595": string[];
+    "596": string[];
+    "597": string[];
     "600": string[];
     "666": string[];
     "686": string[];
@@ -154,6 +159,7 @@ declare const _default: {
     "707": string[];
     "708": string[];
     "721": string[];
+    "776": string[];
     "777": string[];
     "787": string[];
     "788": string[];
@@ -197,18 +203,24 @@ declare const _default: {
     "1287": string[];
     "1288": string[];
     "1337": string[];
+    "1506": string[];
+    "1507": string[];
     "1618": string[];
     "1620": string[];
     "1657": string[];
     "1688": string[];
+    "1819": string[];
     "1856": string[];
     "1898": string[];
     "1984": string[];
     "1987": string[];
     "2001": string[];
+    "2008": string[];
+    "2009": string[];
     "2020": string[];
     "2021": string[];
     "2022": string[];
+    "2023": string[];
     "2025": string[];
     "2100": string[];
     "2101": string[];
@@ -219,6 +231,8 @@ declare const _default: {
     "2223": string[];
     "2559": string[];
     "2569": string[];
+    "2612": string[];
+    "2613": string[];
     "3000": string[];
     "3001": string[];
     "3331": string[];
@@ -231,6 +245,7 @@ declare const _default: {
     "3967": string[];
     "4002": string[];
     "4102": string[];
+    "4181": string[];
     "4689": string[];
     "4690": string[];
     "4918": string[];
@@ -254,6 +269,7 @@ declare const _default: {
     "8723": string[];
     "8724": string[];
     "8888": string[];
+    "8898": string[];
     "8995": string[];
     "9000": string[];
     "9001": string[];
@@ -264,6 +280,8 @@ declare const _default: {
     "10001": string[];
     "10101": string[];
     "10823": string[];
+    "10946": string[];
+    "10947": string[];
     "11111": string[];
     "11437": string[];
     "12051": string[];
@@ -274,10 +292,14 @@ declare const _default: {
     "19845": string[];
     "21337": string[];
     "21816": string[];
+    "22023": string[];
     "24484": string[];
     "24734": string[];
+    "26863": string[];
+    "30067": string[];
     "31102": string[];
     "31337": string[];
+    "32520": string[];
     "32659": string[];
     "39797": string[];
     "42069": string[];
@@ -309,6 +331,8 @@ declare const _default: {
     "70002": string[];
     "70103": string[];
     "71393": string[];
+    "71401": string[];
+    "71402": string[];
     "73799": string[];
     "78110": string[];
     "80001": string[];
@@ -345,7 +369,9 @@ declare const _default: {
     "333888": string[];
     "333999": string[];
     "421611": string[];
+    "432201": string[];
     "444900": string[];
+    "474142": string[];
     "512512": string[];
     "666666": string[];
     "888888": string[];
@@ -353,6 +379,7 @@ declare const _default: {
     "1313114": string[];
     "1313500": string[];
     "1337702": string[];
+    "1337802": string[];
     "2203181": string[];
     "7762959": string[];
     "11155111": string[];

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

@@ -363,6 +363,9 @@ export default {
     "226": [
         "TLA"
     ],
+    "239": [
+        "AITD"
+    ],
     "246": [
         "ewt"
     ],
@@ -435,6 +438,9 @@ export default {
     "513": [
         "aact"
     ],
+    "534": [
+        "CNDL"
+    ],
     "555": [
         "CLASS"
     ],
@@ -444,9 +450,18 @@ export default {
     "588": [
         "metis-stardust"
     ],
+    "592": [
+        "astr"
+    ],
     "595": [
         "maca"
     ],
+    "596": [
+        "tkar"
+    ],
+    "597": [
+        "taca"
+    ],
     "600": [
         "mesh-chain-testnet"
     ],
@@ -468,6 +483,9 @@ export default {
     "721": [
         "tfeth"
     ],
+    "776": [
+        "opc"
+    ],
     "777": [
         "cth"
     ],
@@ -597,6 +615,12 @@ export default {
     "1337": [
         "cennz-old"
     ],
+    "1506": [
+        "Sherpax"
+    ],
+    "1507": [
+        "Sherpax Testnet"
+    ],
     "1618": [
         "cate"
     ],
@@ -609,6 +633,9 @@ export default {
     "1688": [
         "LUDAN"
     ],
+    "1819": [
+        "cubet"
+    ],
     "1856": [
         "tsf"
     ],
@@ -624,6 +651,12 @@ export default {
     "2001": [
         "milkAda"
     ],
+    "2008": [
+        "cloudwalk_testnet"
+    ],
+    "2009": [
+        "cloudwalk_mainnet"
+    ],
     "2020": [
         "420"
     ],
@@ -633,6 +666,9 @@ export default {
     "2022": [
         "edgt"
     ],
+    "2023": [
+        "taycan-testnet"
+    ],
     "2025": [
         "rpg"
     ],
@@ -663,6 +699,12 @@ export default {
     "2569": [
         "tpc"
     ],
+    "2612": [
+        "EZChain"
+    ],
+    "2613": [
+        "Fuji-EZChain"
+    ],
     "3000": [
         "cennz-r"
     ],
@@ -699,6 +741,9 @@ export default {
     "4102": [
         "aioz-testnet"
     ],
+    "4181": [
+        "PHI"
+    ],
     "4689": [
         "iotex-mainnet"
     ],
@@ -768,6 +813,9 @@ export default {
     "8888": [
         "ambrostestnet"
     ],
+    "8898": [
+        "mmt"
+    ],
     "8995": [
         "berg"
     ],
@@ -798,6 +846,12 @@ export default {
     "10823": [
         "CCP"
     ],
+    "10946": [
+        "quadrans"
+    ],
+    "10947": [
+        "quadranstestnet"
+    ],
     "11111": [
         "WAGMI"
     ],
@@ -826,7 +880,10 @@ export default {
         "cennz-a"
     ],
     "21816": [
-        "oml"
+        "omc"
+    ],
+    "22023": [
+        "SFL"
     ],
     "24484": [
         "web"
@@ -834,12 +891,21 @@ export default {
     "24734": [
         "mintme"
     ],
+    "26863": [
+        "OAC"
+    ],
+    "30067": [
+        "Piece"
+    ],
     "31102": [
         "esn"
     ],
     "31337": [
         "got"
     ],
+    "32520": [
+        "Brise"
+    ],
     "32659": [
         "fsn"
     ],
@@ -874,7 +940,7 @@ export default {
         "ALFA"
     ],
     "45000": [
-        "autobahn"
+        "Autobahn Network"
     ],
     "47805": [
         "REI"
@@ -933,6 +999,12 @@ export default {
     "71393": [
         "ckb"
     ],
+    "71401": [
+        "gw-testnet-v1"
+    ],
+    "71402": [
+        "gw-mainnet-v1"
+    ],
     "73799": [
         "vt"
     ],
@@ -1041,9 +1113,15 @@ export default {
     "421611": [
         "arb-rinkeby"
     ],
+    "432201": [
+        "Dexalot"
+    ],
     "444900": [
         "wlkt"
     ],
+    "474142": [
+        "oc"
+    ],
     "512512": [
         "cmp"
     ],
@@ -1065,6 +1143,9 @@ export default {
     "1337702": [
         "kintsugi"
     ],
+    "1337802": [
+        "kiln"
+    ],
     "2203181": [
         "platondev"
     ],
@@ -1180,6 +1261,6 @@ export default {
         "mole"
     ],
     "868455272153094": [
-        "gw-testnet-v1"
+        "gw-testnet-v1-deprecated"
     ]
 };

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

@@ -1,7 +1,11 @@
 import Big from 'big.js';
+import { hexToDecimal } from '../../classes/utils/hex-to-decimal';
 import { scientificStrToDecimalStr } from './helpers';
 export class TinyBig extends Big {
     constructor(value) {
+        if (typeof value === 'string' && value.startsWith('0x')) {
+            value = hexToDecimal(value);
+        }
         super(value);
         this.padAndChop = (str, padChar, length) => {
             return (Array(length).fill(padChar).join('') + str).slice(length * -1);

package/lib/esm/types/Block.types.d.ts

@@ -1,12 +1,16 @@
+import { TinyBig } from './../shared/tiny-big/tiny-big';
 import { BlockTransactionResponse, RPCTransaction } from './Transaction.types';
 declare type Modify<T, R> = Omit<T, keyof R> & R;
 export declare type BlockResponse = Modify<RPCBlock, {
-    gasLimit: number;
-    gasUsed: number;
+    baseFeePerGas: TinyBig;
+    difficulty: TinyBig;
+    gasLimit: TinyBig;
+    gasUsed: TinyBig;
+    nonce: TinyBig;
     number: number;
-    size: number;
-    timestamp: number;
-    baseFeePerGas: number;
+    size: TinyBig;
+    timestamp: TinyBig;
+    totalDifficulty: TinyBig;
     transactions: Array<string | BlockTransactionResponse>;
 }>;
 export interface RPCBlock {
@@ -28,9 +32,9 @@ export interface RPCBlock {
     stateRoot: string;
     timestamp: string;
     totalDifficulty: string;
-    transactions: Array<string> | Array<RPCTransaction>;
+    transactions: Array<string | RPCTransaction>;
     transactionsRoot: string;
-    uncles: unknown[];
+    uncles: Array<string>;
 }
 export declare type BlockTag = 'latest' | 'earliest' | 'pending' | number | string;
 export {};

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

@@ -0,0 +1,12 @@
+import { BlockTag } from './Block.types';
+export interface EventFilter {
+    address?: string;
+    topics?: Array<string | Array<string> | null>;
+}
+export interface Filter extends EventFilter {
+    fromBlock?: BlockTag;
+    toBlock?: BlockTag;
+}
+export interface FilterByBlockHash extends EventFilter {
+    blockHash?: string;
+}

package/lib/esm/types/Filter.types.js

@@ -0,0 +1 @@
+export {};

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

@@ -1,4 +1,6 @@
+import type Big from 'big.js';
 import { TinyBig } from '../shared/tiny-big/tiny-big';
+import { BytesLike } from './../utils/bytes';
 declare type Modify<T, R> = Omit<T, keyof R> & R;
 export interface RPCTransaction extends RPCBlockTransaction {
     maxFeePerGas: string;
@@ -7,14 +9,14 @@ export interface RPCTransaction extends RPCBlockTransaction {
 export declare type TransactionResponse = Modify<RPCTransaction, {
     blockNumber: number;
     chainId: number;
-    nonce: number;
+    gas: TinyBig;
+    gasLimit: TinyBig;
+    gasPrice: TinyBig;
+    nonce: TinyBig;
     transactionIndex: number;
     type: number;
     v: number;
     value: TinyBig;
-    gasPrice: TinyBig;
-    gas: TinyBig;
-    gasLimit: TinyBig;
 } & {
     maxFeePerGas: TinyBig;
     maxPriorityFeePerGas: TinyBig;
@@ -33,7 +35,31 @@ export declare type TransactionReceipt = Modify<RPCTransactionReceipt, {
     byzantium: boolean;
     confirmations: number;
 }>;
-export declare type Log = Modify<Omit<RPCLog, 'removed'>, {
+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;
+}
+export declare type Log = Modify<RPCLog, {
     blockNumber: number;
     logIndex: number;
     transactionIndex: number;

package/lib/esm/utils/compute-address.d.ts

@@ -0,0 +1 @@
+export declare function computeAddress(key: string): string;

package/lib/esm/utils/compute-address.js

@@ -0,0 +1,11 @@
+import { computePublicKey, toChecksumAddress } from '..';
+import { hexDataSlice } from './bytes';
+import { keccak256 } from './keccak256';
+export function computeAddress(key) {
+    if (!key.startsWith('0x04') &&
+        !key.startsWith('0x03') &&
+        !key.startsWith('0x02')) {
+        key = computePublicKey(key);
+    }
+    return toChecksumAddress(hexDataSlice(keccak256(hexDataSlice(key, 1)), 12));
+}

package/lib/esm/utils/compute-public-key.d.ts

@@ -0,0 +1,2 @@
+import { BytesLike } from './bytes';
+export declare function computePublicKey(privKey: BytesLike): string;

package/lib/esm/utils/compute-public-key.js

@@ -0,0 +1,6 @@
+import { Point } from '@noble/secp256k1';
+import { hexlify } from './bytes';
+export function computePublicKey(privKey) {
+    privKey = hexlify(privKey).slice(2);
+    return '0x' + Point.fromPrivateKey(privKey).toHex();
+}

package/lib/esm/utils/keccak256.d.ts

@@ -1,2 +1,2 @@
 import { BytesLike } from './bytes';
-export declare const keccak256: (data: BytesLike) => string;
+export declare function keccak256(data: BytesLike): string;

package/lib/esm/utils/keccak256.js

@@ -1,5 +1,5 @@
 import { Keccak } from 'sha3';
-export const keccak256 = (data) => {
+export function keccak256(data) {
     let bufferableData;
     if (typeof data === 'string') {
         bufferableData = Buffer.from(data.replace(/^0x/, ''), 'hex');
@@ -10,4 +10,4 @@ export const keccak256 = (data) => {
     const keccak = new Keccak(256);
     const addressHash = '0x' + keccak.update(bufferableData).digest('hex');
     return addressHash;
-};
+}

package/lib/esm/utils/split-signature.d.ts

@@ -0,0 +1,2 @@
+import { Signature, SignatureLike } from './bytes';
+export declare function splitSignature(signature: SignatureLike): Signature;