essential-eth 0.5.4 → 0.5.5

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

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

package/lib/cjs/index.d.ts

@@ -1,15 +1,19 @@
-import { Contract } from './classes/Contract';
-import { FallthroughProvider } from './providers/FallthroughProvider';
+import { BaseContract, Contract } from './classes/Contract';
+import { ConstructorOptions, FallthroughProvider } from './providers/FallthroughProvider';
 import { JsonRpcProvider, jsonRpcProvider } from './providers/JsonRpcProvider';
 import { tinyBig, TinyBig } from './shared/tiny-big/tiny-big';
-import { BlockResponse } from './types/Block.types';
+import { BlockResponse, BlockTag, RPCBlock } from './types/Block.types';
 import { ContractTypes, JSONABI, JSONABIArgument } from './types/Contract.types';
 import { Network } from './types/Network.types';
-import { TransactionResponse } from './types/Transaction.types';
+import { BlockTransactionResponse, Log, RPCLog, RPCTransaction, RPCTransactionReceipt, TransactionReceipt, TransactionResponse } from './types/Transaction.types';
+import { computeAddress } from './utils/compute-address';
+import { computePublicKey } from './utils/compute-public-key';
 import { etherToGwei } from './utils/ether-to-gwei';
 import { etherToWei } from './utils/ether-to-wei';
 import { gweiToEther } from './utils/gwei-to-ether';
+import { hashMessage } from './utils/hash-message';
 import { isAddress } from './utils/is-address';
+import { splitSignature } from './utils/split-signature';
 import { toChecksumAddress } from './utils/to-checksum-address';
 import { toUtf8Bytes } from './utils/to-utf8-bytes';
 import { weiToEther } from './utils/wei-to-ether';
@@ -17,4 +21,4 @@ export * from './utils/bytes';
 export * from './utils/hash-message';
 export * from './utils/keccak256';
 export * from './utils/solidity-keccak256';
-export { etherToWei, etherToGwei, isAddress, jsonRpcProvider, JsonRpcProvider, FallthroughProvider, tinyBig, toChecksumAddress, weiToEther, gweiToEther, toUtf8Bytes, Contract, TinyBig, BlockResponse, ContractTypes, JSONABI, JSONABIArgument, Network, TransactionResponse, };
+export { etherToWei, etherToGwei, isAddress, jsonRpcProvider, JsonRpcProvider, FallthroughProvider, tinyBig, toChecksumAddress, weiToEther, gweiToEther, hashMessage, splitSignature, toUtf8Bytes, computeAddress, computePublicKey, Contract, TinyBig, BaseContract, BlockResponse, ContractTypes, JSONABI, JSONABIArgument, Network, TransactionResponse, RPCBlock, RPCTransaction, RPCTransactionReceipt, TransactionReceipt, BlockTag, RPCLog, Log, BlockTransactionResponse, ConstructorOptions, };

package/lib/cjs/index.js

@@ -14,8 +14,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TinyBig = exports.Contract = exports.toUtf8Bytes = exports.gweiToEther = exports.weiToEther = exports.toChecksumAddress = exports.tinyBig = exports.FallthroughProvider = exports.JsonRpcProvider = exports.jsonRpcProvider = exports.isAddress = exports.etherToGwei = exports.etherToWei = void 0;
+exports.BaseContract = exports.TinyBig = exports.Contract = exports.computePublicKey = exports.computeAddress = exports.toUtf8Bytes = exports.splitSignature = exports.hashMessage = exports.gweiToEther = exports.weiToEther = exports.toChecksumAddress = exports.tinyBig = exports.FallthroughProvider = exports.JsonRpcProvider = exports.jsonRpcProvider = exports.isAddress = exports.etherToGwei = exports.etherToWei = void 0;
 const Contract_1 = require("./classes/Contract");
+Object.defineProperty(exports, "BaseContract", { enumerable: true, get: function () { return Contract_1.BaseContract; } });
 Object.defineProperty(exports, "Contract", { enumerable: true, get: function () { return Contract_1.Contract; } });
 const FallthroughProvider_1 = require("./providers/FallthroughProvider");
 Object.defineProperty(exports, "FallthroughProvider", { enumerable: true, get: function () { return FallthroughProvider_1.FallthroughProvider; } });
@@ -25,17 +26,24 @@ 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 compute_address_1 = require("./utils/compute-address");
+Object.defineProperty(exports, "computeAddress", { enumerable: true, get: function () { return compute_address_1.computeAddress; } });
+const compute_public_key_1 = require("./utils/compute-public-key");
+Object.defineProperty(exports, "computePublicKey", { enumerable: true, get: function () { return compute_public_key_1.computePublicKey; } });
 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 hash_message_1 = require("./utils/hash-message");
+Object.defineProperty(exports, "hashMessage", { enumerable: true, get: function () { return hash_message_1.hashMessage; } });
 const is_address_1 = require("./utils/is-address");
 Object.defineProperty(exports, "isAddress", { enumerable: true, get: function () { return is_address_1.isAddress; } });
+const split_signature_1 = require("./utils/split-signature");
+Object.defineProperty(exports, "splitSignature", { enumerable: true, get: function () { return split_signature_1.splitSignature; } });
 const to_checksum_address_1 = require("./utils/to-checksum-address");
 Object.defineProperty(exports, "toChecksumAddress", { enumerable: true, get: function () { return to_checksum_address_1.toChecksumAddress; } });
-// import { verifyMessage } from './utils/verify-message';
 const to_utf8_bytes_1 = require("./utils/to-utf8-bytes");
 Object.defineProperty(exports, "toUtf8Bytes", { enumerable: true, get: function () { return to_utf8_bytes_1.toUtf8Bytes; } });
 const wei_to_ether_1 = require("./utils/wei-to-ether");

package/lib/cjs/logger/package-version.d.ts

@@ -1 +1 @@
-export declare const version = "0.5.4";
+export declare const version = "0.5.5";

package/lib/cjs/logger/package-version.js

@@ -2,4 +2,4 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.version = void 0;
 // Generated by genversion.
-exports.version = '0.5.4';
+exports.version = '0.5.5';

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

@@ -24,6 +24,20 @@ export declare abstract class BaseProvider {
      * Returns the network this provider is connected to
      */
     getNetwork(): Promise<Network>;
+    /**
+     * Gets the number of the most recently mined block on the network the provider is connected to
+     *
+     * * Identical to [`ethers.provider.getBlockNumber`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getBlockNumber)
+     * * Identical to [`web3.eth.getBlockNumber`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#getblocknumber)
+     *
+     * @returns the number of the most recently mined block
+     * @example
+     * ```js
+     * await provider.getBlockNumber();
+     * // 1053312
+     * ```
+     */
+    getBlockNumber(): Promise<number>;
     /**
      * * Similar to [`ethers.provider.getTransaction`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getTransaction), some information not included
      *

package/lib/cjs/providers/BaseProvider.js

@@ -50,6 +50,25 @@ class BaseProvider {
             };
         });
     }
+    /**
+     * Gets the number of the most recently mined block on the network the provider is connected to
+     *
+     * * Identical to [`ethers.provider.getBlockNumber`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getBlockNumber)
+     * * Identical to [`web3.eth.getBlockNumber`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#getblocknumber)
+     *
+     * @returns the number of the most recently mined block
+     * @example
+     * ```js
+     * await provider.getBlockNumber();
+     * // 1053312
+     * ```
+     */
+    getBlockNumber() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const currentBlockNumber = (yield this.post((0, fetchers_1.buildRPCPostBody)('eth_blockNumber', [])));
+            return Number((0, hex_to_decimal_1.hexToDecimal)(currentBlockNumber));
+        });
+    }
     /**
      * * Similar to [`ethers.provider.getTransaction`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getTransaction), some information not included
      *

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

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

package/lib/cjs/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[];
@@ -201,14 +207,18 @@ declare const _default: {
     "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 +229,8 @@ declare const _default: {
     "2223": string[];
     "2559": string[];
     "2569": string[];
+    "2612": string[];
+    "2613": string[];
     "3000": string[];
     "3001": string[];
     "3331": string[];
@@ -254,6 +266,7 @@ declare const _default: {
     "8723": string[];
     "8724": string[];
     "8888": string[];
+    "8898": string[];
     "8995": string[];
     "9000": string[];
     "9001": string[];
@@ -274,10 +287,13 @@ declare const _default: {
     "19845": string[];
     "21337": string[];
     "21816": string[];
+    "22023": string[];
     "24484": string[];
     "24734": string[];
+    "30067": string[];
     "31102": string[];
     "31337": string[];
+    "32520": string[];
     "32659": string[];
     "39797": string[];
     "42069": string[];

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

@@ -367,6 +367,9 @@ exports.default = {
     "226": [
         "TLA"
     ],
+    "239": [
+        "AITD"
+    ],
     "246": [
         "ewt"
     ],
@@ -439,6 +442,9 @@ exports.default = {
     "513": [
         "aact"
     ],
+    "534": [
+        "CNDL"
+    ],
     "555": [
         "CLASS"
     ],
@@ -448,9 +454,18 @@ exports.default = {
     "588": [
         "metis-stardust"
     ],
+    "592": [
+        "astr"
+    ],
     "595": [
         "maca"
     ],
+    "596": [
+        "tkar"
+    ],
+    "597": [
+        "taca"
+    ],
     "600": [
         "mesh-chain-testnet"
     ],
@@ -472,6 +487,9 @@ exports.default = {
     "721": [
         "tfeth"
     ],
+    "776": [
+        "opc"
+    ],
     "777": [
         "cth"
     ],
@@ -613,6 +631,9 @@ exports.default = {
     "1688": [
         "LUDAN"
     ],
+    "1819": [
+        "cubet"
+    ],
     "1856": [
         "tsf"
     ],
@@ -628,6 +649,12 @@ exports.default = {
     "2001": [
         "milkAda"
     ],
+    "2008": [
+        "cloudwalk_testnet"
+    ],
+    "2009": [
+        "cloudwalk_mainnet"
+    ],
     "2020": [
         "420"
     ],
@@ -637,6 +664,9 @@ exports.default = {
     "2022": [
         "edgt"
     ],
+    "2023": [
+        "taycan-testnet"
+    ],
     "2025": [
         "rpg"
     ],
@@ -667,6 +697,12 @@ exports.default = {
     "2569": [
         "tpc"
     ],
+    "2612": [
+        "EZChain"
+    ],
+    "2613": [
+        "Fuji-EZChain"
+    ],
     "3000": [
         "cennz-r"
     ],
@@ -772,6 +808,9 @@ exports.default = {
     "8888": [
         "ambrostestnet"
     ],
+    "8898": [
+        "mmt"
+    ],
     "8995": [
         "berg"
     ],
@@ -830,7 +869,10 @@ exports.default = {
         "cennz-a"
     ],
     "21816": [
-        "oml"
+        "omc"
+    ],
+    "22023": [
+        "SFL"
     ],
     "24484": [
         "web"
@@ -838,12 +880,18 @@ exports.default = {
     "24734": [
         "mintme"
     ],
+    "30067": [
+        "Piece"
+    ],
     "31102": [
         "esn"
     ],
     "31337": [
         "got"
     ],
+    "32520": [
+        "Brise"
+    ],
     "32659": [
         "fsn"
     ],
@@ -878,7 +926,7 @@ exports.default = {
         "ALFA"
     ],
     "45000": [
-        "autobahn"
+        "Autobahn Network"
     ],
     "47805": [
         "REI"

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

@@ -0,0 +1,8 @@
+/**
+ * Computes the address that corresponds to a specified public or private key
+ *
+ * @param key the public or private key to find the address related to
+ *
+ * @returns the address that corresponds to the key specified
+ */
+export declare function computeAddress(key: string): string;

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

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeAddress = void 0;
+const __1 = require("..");
+const bytes_1 = require("./bytes");
+const keccak256_1 = require("./keccak256");
+/**
+ * Computes the address that corresponds to a specified public or private key
+ *
+ * @param key the public or private key to find the address related to
+ *
+ * @returns the address that corresponds to the key specified
+ */
+function computeAddress(key) {
+    // compressed public keys start with 0x04
+    // uncompressed public keys start with 0x03 or 0x02
+    if (!key.startsWith('0x04') &&
+        !key.startsWith('0x03') &&
+        !key.startsWith('0x02')) {
+        key = (0, __1.computePublicKey)(key);
+    }
+    return (0, __1.toChecksumAddress)((0, bytes_1.hexDataSlice)((0, keccak256_1.keccak256)((0, bytes_1.hexDataSlice)(key, 1)), 12));
+}
+exports.computeAddress = computeAddress;

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

@@ -0,0 +1,9 @@
+import { BytesLike } from './bytes';
+/**
+ * Computes the public key from a given private key
+ *
+ * @param key the private key to find a public key from
+ *
+ * @returns the public key
+ */
+export declare function computePublicKey(privKey: BytesLike): string;

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

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computePublicKey = void 0;
+const secp256k1_1 = require("@noble/secp256k1");
+const bytes_1 = require("./bytes");
+/**
+ * Computes the public key from a given private key
+ *
+ * @param key the private key to find a public key from
+ *
+ * @returns the public key
+ */
+function computePublicKey(privKey) {
+    privKey = (0, bytes_1.hexlify)(privKey).slice(2);
+    return '0x' + secp256k1_1.Point.fromPrivateKey(privKey).toHex();
+}
+exports.computePublicKey = computePublicKey;

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

@@ -0,0 +1,26 @@
+import { Signature, SignatureLike } from './bytes';
+/**
+ * Expands a signature into the full signature object and fills in missing properties.
+ *
+ * * Same as ["splitSignature" in ethers.js](https://docs.ethers.io/v5/api/utils/bytes/#utils-splitSignature)
+ *
+ * @param signature the signature object to split, parse, and compute missing properties from
+ *
+ * @returns a full signature object with all properties filled
+ *
+ * @example
+ * ```javascript
+ * const signature = '0x60bc4ed91f2021aefe7045f3f77bd12f87eb733aee24bd1965343b3c27b3971647252185b7d2abb411b01b5d1ac4ab41ea486df1e9b396758c1aec6c1b6eee331b';
+ * splitSignature(signature);
+ *  {
+ *    r: "0x60bc4ed91f2021aefe7045f3f77bd12f87eb733aee24bd1965343b3c27b39716",
+ *    s: "0x47252185b7d2abb411b01b5d1ac4ab41ea486df1e9b396758c1aec6c1b6eee33",
+ *    _vs: "0x47252185b7d2abb411b01b5d1ac4ab41ea486df1e9b396758c1aec6c1b6eee33",
+ *    recoveryParam: 0,
+ *    v: 27,
+ *    yParityAndS: "0x47252185b7d2abb411b01b5d1ac4ab41ea486df1e9b396758c1aec6c1b6eee33",
+ *    compact: "0x60bc4ed91f2021aefe7045f3f77bd12f87eb733aee24bd1965343b3c27b3971647252185b7d2abb411b01b5d1ac4ab41ea486df1e9b396758c1aec6c1b6eee33"
+ *  }
+ * ```
+ */
+export declare function splitSignature(signature: SignatureLike): Signature;

package/lib/cjs/utils/split-signature.js

@@ -0,0 +1,165 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.splitSignature = void 0;
+const logger_1 = require("./../logger/logger");
+const bytes_1 = require("./bytes");
+/**
+ * Expands a signature into the full signature object and fills in missing properties.
+ *
+ * * Same as ["splitSignature" in ethers.js](https://docs.ethers.io/v5/api/utils/bytes/#utils-splitSignature)
+ *
+ * @param signature the signature object to split, parse, and compute missing properties from
+ *
+ * @returns a full signature object with all properties filled
+ *
+ * @example
+ * ```javascript
+ * const signature = '0x60bc4ed91f2021aefe7045f3f77bd12f87eb733aee24bd1965343b3c27b3971647252185b7d2abb411b01b5d1ac4ab41ea486df1e9b396758c1aec6c1b6eee331b';
+ * splitSignature(signature);
+ *  {
+ *    r: "0x60bc4ed91f2021aefe7045f3f77bd12f87eb733aee24bd1965343b3c27b39716",
+ *    s: "0x47252185b7d2abb411b01b5d1ac4ab41ea486df1e9b396758c1aec6c1b6eee33",
+ *    _vs: "0x47252185b7d2abb411b01b5d1ac4ab41ea486df1e9b396758c1aec6c1b6eee33",
+ *    recoveryParam: 0,
+ *    v: 27,
+ *    yParityAndS: "0x47252185b7d2abb411b01b5d1ac4ab41ea486df1e9b396758c1aec6c1b6eee33",
+ *    compact: "0x60bc4ed91f2021aefe7045f3f77bd12f87eb733aee24bd1965343b3c27b3971647252185b7d2abb411b01b5d1ac4ab41ea486df1e9b396758c1aec6c1b6eee33"
+ *  }
+ * ```
+ */
+function splitSignature(signature) {
+    const result = {
+        r: '0x',
+        s: '0x',
+        _vs: '0x',
+        recoveryParam: 0,
+        v: 0,
+        yParityAndS: '0x',
+        compact: '0x',
+    };
+    if ((0, bytes_1.isBytesLike)(signature)) {
+        const bytes = (0, bytes_1.arrayify)(signature);
+        // Get the r, s and v
+        if (bytes.length === 64) {
+            // EIP-2098; pull the v from the top bit of s and clear it
+            result.v = 27 + (bytes[32] >> 7);
+            bytes[32] &= 0x7f;
+            result.r = (0, bytes_1.hexlify)(bytes.slice(0, 32));
+            result.s = (0, bytes_1.hexlify)(bytes.slice(32, 64));
+        }
+        else if (bytes.length === 65) {
+            result.r = (0, bytes_1.hexlify)(bytes.slice(0, 32));
+            result.s = (0, bytes_1.hexlify)(bytes.slice(32, 64));
+            result.v = bytes[64];
+        }
+        else {
+            logger_1.logger.throwArgumentError('invalid signature string', 'signature', signature);
+        }
+        // Allow a recid to be used as the v
+        if (result.v < 27) {
+            if (result.v === 0 || result.v === 1) {
+                result.v += 27;
+            }
+            else {
+                logger_1.logger.throwArgumentError('signature invalid v byte', 'signature', signature);
+            }
+        }
+        // Compute recoveryParam from v
+        result.recoveryParam = 1 - (result.v % 2);
+        // Compute _vs from recoveryParam and s
+        if (result.recoveryParam) {
+            bytes[32] |= 0x80;
+        }
+        result._vs = (0, bytes_1.hexlify)(bytes.slice(32, 64));
+    }
+    else {
+        result.r = signature.r;
+        result.s = signature.s;
+        result.v = signature.v;
+        result.recoveryParam = signature.recoveryParam;
+        result._vs = signature._vs;
+        // If the _vs is available, use it to populate missing s, v and recoveryParam
+        // and verify non-missing s, v and recoveryParam
+        if (result._vs != null) {
+            const vs_1 = (0, bytes_1.zeroPad)((0, bytes_1.arrayify)(result._vs), 32);
+            result._vs = (0, bytes_1.hexlify)(vs_1);
+            // Set or check the recid
+            const recoveryParam = vs_1[0] >= 128 ? 1 : 0;
+            if (result.recoveryParam == null) {
+                result.recoveryParam = recoveryParam;
+            }
+            else if (result.recoveryParam !== recoveryParam) {
+                logger_1.logger.throwArgumentError('signature recoveryParam mismatch _vs', 'signature', signature);
+            }
+            // Set or check the s
+            vs_1[0] &= 0x7f;
+            const s = (0, bytes_1.hexlify)(vs_1);
+            if (result.s == null) {
+                result.s = s;
+            }
+            else if (result.s !== s) {
+                logger_1.logger.throwArgumentError('signature v mismatch _vs', 'signature', signature);
+            }
+        }
+        // Use recid and v to populate each other
+        if (result.recoveryParam == null) {
+            if (result.v == null) {
+                logger_1.logger.throwArgumentError('signature missing v and recoveryParam', 'signature', signature);
+            }
+            else if (result.v === 0 || result.v === 1) {
+                result.recoveryParam = result.v;
+            }
+            else {
+                result.recoveryParam = 1 - (result.v % 2);
+            }
+        }
+        else {
+            if (result.v == null) {
+                result.v = 27 + result.recoveryParam;
+            }
+            else {
+                const recId = result.v === 0 || result.v === 1 ? result.v : 1 - (result.v % 2);
+                if (result.recoveryParam !== recId) {
+                    logger_1.logger.throwArgumentError('signature recoveryParam mismatch v', 'signature', signature);
+                }
+            }
+        }
+        if (result.r == null || !(0, bytes_1.isHexString)(result.r)) {
+            logger_1.logger.throwArgumentError('signature missing or invalid r', 'signature', signature);
+        }
+        else {
+            result.r = (0, bytes_1.hexZeroPad)(result.r, 32);
+        }
+        if (result.s == null || !(0, bytes_1.isHexString)(result.s)) {
+            logger_1.logger.throwArgumentError('signature missing or invalid s', 'signature', signature);
+        }
+        else {
+            result.s = (0, bytes_1.hexZeroPad)(result.s, 32);
+        }
+        const vs = (0, bytes_1.arrayify)(result.s);
+        if (vs[0] >= 128) {
+            logger_1.logger.throwArgumentError('signature s out of range', 'signature', signature);
+        }
+        if (result.recoveryParam) {
+            vs[0] |= 0x80;
+        }
+        const _vs = (0, bytes_1.hexlify)(vs);
+        if (result._vs) {
+            if (!(0, bytes_1.isHexString)(result._vs)) {
+                logger_1.logger.throwArgumentError('signature invalid _vs', 'signature', signature);
+            }
+            result._vs = (0, bytes_1.hexZeroPad)(result._vs, 32);
+        }
+        // Set or check the _vs
+        if (result._vs == null) {
+            result._vs = _vs;
+        }
+        else if (result._vs !== _vs) {
+            logger_1.logger.throwArgumentError('signature _vs mismatch v and s', 'signature', signature);
+        }
+    }
+    result.yParityAndS = result._vs;
+    result.compact = result.r + result.yParityAndS.substring(2);
+    return result;
+}
+exports.splitSignature = splitSignature;

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

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

package/lib/esm/index.d.ts

@@ -1,15 +1,19 @@
-import { Contract } from './classes/Contract';
-import { FallthroughProvider } from './providers/FallthroughProvider';
+import { BaseContract, Contract } from './classes/Contract';
+import { ConstructorOptions, FallthroughProvider } from './providers/FallthroughProvider';
 import { JsonRpcProvider, jsonRpcProvider } from './providers/JsonRpcProvider';
 import { tinyBig, TinyBig } from './shared/tiny-big/tiny-big';
-import { BlockResponse } from './types/Block.types';
+import { BlockResponse, BlockTag, RPCBlock } from './types/Block.types';
 import { ContractTypes, JSONABI, JSONABIArgument } from './types/Contract.types';
 import { Network } from './types/Network.types';
-import { TransactionResponse } from './types/Transaction.types';
+import { BlockTransactionResponse, Log, RPCLog, RPCTransaction, RPCTransactionReceipt, TransactionReceipt, TransactionResponse } from './types/Transaction.types';
+import { computeAddress } from './utils/compute-address';
+import { computePublicKey } from './utils/compute-public-key';
 import { etherToGwei } from './utils/ether-to-gwei';
 import { etherToWei } from './utils/ether-to-wei';
 import { gweiToEther } from './utils/gwei-to-ether';
+import { hashMessage } from './utils/hash-message';
 import { isAddress } from './utils/is-address';
+import { splitSignature } from './utils/split-signature';
 import { toChecksumAddress } from './utils/to-checksum-address';
 import { toUtf8Bytes } from './utils/to-utf8-bytes';
 import { weiToEther } from './utils/wei-to-ether';
@@ -17,4 +21,4 @@ export * from './utils/bytes';
 export * from './utils/hash-message';
 export * from './utils/keccak256';
 export * from './utils/solidity-keccak256';
-export { etherToWei, etherToGwei, isAddress, jsonRpcProvider, JsonRpcProvider, FallthroughProvider, tinyBig, toChecksumAddress, weiToEther, gweiToEther, toUtf8Bytes, Contract, TinyBig, BlockResponse, ContractTypes, JSONABI, JSONABIArgument, Network, TransactionResponse, };
+export { etherToWei, etherToGwei, isAddress, jsonRpcProvider, JsonRpcProvider, FallthroughProvider, tinyBig, toChecksumAddress, weiToEther, gweiToEther, hashMessage, splitSignature, toUtf8Bytes, computeAddress, computePublicKey, Contract, TinyBig, BaseContract, BlockResponse, ContractTypes, JSONABI, JSONABIArgument, Network, TransactionResponse, RPCBlock, RPCTransaction, RPCTransactionReceipt, TransactionReceipt, BlockTag, RPCLog, Log, BlockTransactionResponse, ConstructorOptions, };