essential-eth 0.13.0 → 1.0.0

package/dist/index.js

@@ -1,9 +1,8 @@
-import { logger, encodeData, decodeRPCResponse, toChecksumAddress, hexlify } from './chunk-C4VOKUKQ.js';
-export { arrayify, computeAddress, computePublicKey, concat, hashMessage, hexConcat, hexDataLength, hexDataSlice, hexStripZeros, hexValue, hexZeroPad, hexlify, isAddress, isBytes, isBytesLike, isHexString, keccak256, pack, solidityKeccak256, splitSignature, stripZeros, toChecksumAddress, toUtf8Bytes, zeroPad } from './chunk-C4VOKUKQ.js';
-import { hexToDecimal, tinyBig, TinyBig } from './chunk-UXC5R4JE.js';
-export { TinyBig, etherToGwei, etherToWei, gweiToEther, tinyBig, weiToEther } from './chunk-UXC5R4JE.js';
+import { keccak256, toUtf8Bytes, logger, encodeData, decodeRPCResponse, arrayify, hexlify, toChecksumAddress, hexToDecimal } from './chunk-CLIQ4S3P.js';
+export { arrayify, computeAddress, computePublicKey, concat, hashMessage, hexConcat, hexDataLength, hexDataSlice, hexStripZeros, hexValue, hexZeroPad, hexlify, isAddress, isBytes, isBytesLike, isHexString, keccak256, pack, solidityKeccak256, splitSignature, stripZeros, toChecksumAddress, toUtf8Bytes, zeroPad } from './chunk-CLIQ4S3P.js';
+import { formatFixed, toBigInt, parseFixed } from './chunk-GFWRB7PT.js';
+export { etherToGwei, etherToWei, gweiToEther, weiToEther } from './chunk-GFWRB7PT.js';
 import unfetch from 'isomorphic-unfetch';
-import Big from 'big.js';
 
 // src/classes/Contract.ts
 function estimateGas(txnData) {
@@ -78,7 +77,8 @@ function cleanTransaction(transaction) {
     ...transaction
   };
   Object.keys(transaction).forEach((key) => {
-    if (!transaction[key]) return;
+    if (!transaction[key])
+      return;
     switch (key) {
       case "blockNumber":
       case "chainId":
@@ -99,7 +99,7 @@ function cleanTransaction(transaction) {
       case "maxFeePerGas":
       case "maxPriorityFeePerGas":
       case "nonce":
-        cleanedTransaction[key] = tinyBig(hexToDecimal(transaction[key]));
+        cleanedTransaction[key] = BigInt(hexToDecimal(transaction[key]));
         break;
     }
   });
@@ -110,7 +110,8 @@ function cleanTransaction(transaction) {
 function cleanBlock(block, returnTransactionObjects) {
   const cleanedBlock = { ...block };
   Object.keys(block).forEach((key) => {
-    if (!block[key]) return;
+    if (!block[key])
+      return;
     switch (key) {
       case "difficulty":
       case "totalDifficulty":
@@ -119,7 +120,7 @@ function cleanBlock(block, returnTransactionObjects) {
       case "size":
       case "timestamp":
       case "baseFeePerGas":
-        cleanedBlock[key] = tinyBig(hexToDecimal(block[key]));
+        cleanedBlock[key] = BigInt(hexToDecimal(block[key]));
         break;
       case "number":
         cleanedBlock[key] = Number(hexToDecimal(block[key]));
@@ -172,7 +173,8 @@ function cleanTransactionReceipt(transactionReceipt) {
     ...cleanedTransaction
   };
   Object.keys(transactionReceipt).forEach((key) => {
-    if (!transactionReceipt[key]) return;
+    if (!transactionReceipt[key])
+      return;
     switch (key) {
       case "status":
         cleanedTransactionReceipt[key] = Number(
@@ -189,7 +191,7 @@ function cleanTransactionReceipt(transactionReceipt) {
       case "cumulativeGasUsed":
       case "effectiveGasPrice":
       case "gasUsed":
-        cleanedTransactionReceipt[key] = tinyBig(
+        cleanedTransactionReceipt[key] = BigInt(
           hexToDecimal(transactionReceipt[key])
         );
         break;
@@ -238,6 +240,8 @@ function buildRPCPostBody(method, params) {
     params
   };
 }
+
+// src/classes/utils/prepare-transaction.ts
 function prepareTransaction(transaction) {
   const preparedTransaction = {
     ...transaction
@@ -252,15 +256,13 @@ function prepareTransaction(transaction) {
         case "maxPriorityFeePerGas":
         case "value": {
           const value = transaction[key];
-          if (value instanceof TinyBig) {
-            preparedTransaction[key] = value.toHexString();
-          } else if (value instanceof Big) {
-            preparedTransaction[key] = `0x${BigInt(value.toString()).toString(
-              16
-            )}`;
-          } else if (typeof transaction[key] === "number")
-            preparedTransaction[key] = "0x" + transaction[key].toString(16);
-          else preparedTransaction[key] = transaction[key].toString();
+          if (typeof value === "bigint") {
+            preparedTransaction[key] = "0x" + value.toString(16);
+          } else if (typeof value === "number") {
+            preparedTransaction[key] = "0x" + value.toString(16);
+          } else {
+            preparedTransaction[key] = value.toString();
+          }
           break;
         }
         case "data":
@@ -272,6 +274,20 @@ function prepareTransaction(transaction) {
   return preparedTransaction;
 }
 
+// src/utils/namehash.ts
+function namehash(name) {
+  let node = "0x0000000000000000000000000000000000000000000000000000000000000000";
+  if (name === "") {
+    return node;
+  }
+  const labels = name.split(".");
+  for (let i = labels.length - 1; i >= 0; i--) {
+    const labelHash = keccak256(toUtf8Bytes(labels[i]));
+    node = keccak256("0x" + node.slice(2) + labelHash.slice(2));
+  }
+  return node;
+}
+
 // src/providers/utils/chains-info.ts
 var chains_info_default = {
   "1": [
@@ -343,7 +359,7 @@ var chains_info_default = {
 
 // src/providers/BaseProvider.ts
 function prepBlockTag(blockTag) {
-  return typeof blockTag === "number" ? tinyBig(blockTag).toHexString() : blockTag;
+  return typeof blockTag === "number" ? "0x" + blockTag.toString(16) : blockTag;
 }
 var BaseProvider = class {
   /**
@@ -369,7 +385,6 @@ var BaseProvider = class {
    *
    * * [Identical](/docs/api#isd) to [`ethers.provider.getNetwork`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getNetwork) in ethers.js
    * * [Similar](/docs/api#isd) to [`web3.eth.getChainId`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#getchainid) in web3.js, returns more than just the `chainId`
-   *
    * @returns information about the network this provider is currently connected to
    * @example
    * ```javascript
@@ -400,7 +415,6 @@ var BaseProvider = class {
    *
    * * [Identical](/docs/api#isd) to [`ethers.provider.getBlockNumber`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getBlockNumber) in ethers.js
    * * [Identical](/docs/api#isd) to [`web3.eth.getBlockNumber`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#getblocknumber) in web3.js
-   *
    * @returns the number of the most recently mined block
    * @example
    * ```javascript
@@ -419,7 +433,6 @@ var BaseProvider = class {
    *
    * * [Similar](/docs/api#isd) to [`ethers.provider.getTransaction`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getTransaction) in ethers.js, does not have `wait` method that waits until the transaction has been mined
    * * [Similar](/docs/api#isd) to [`web3.eth.getTransaction`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#gettransaction) in web3.js, some information returned using different types
-   *
    * @param transactionHash the hash of the transaction to get information about
    * @returns information about the specified transaction
    * @example
@@ -431,20 +444,20 @@ var BaseProvider = class {
    * //   blockNumber: 14578286,
    * //   chainId: 1,
    * //   from: "0xdfD9dE5f6FA60BD70636c0900752E93a6144AEd4",
-   * //   gas: { TinyBig: 112163 },
-   * //   gasPrice: { TinyBig: 48592426858 },
+   * //   gas: 112163n,
+   * //   gasPrice: 48592426858n,
    * //   hash: "0x9014ae6ef92464338355a79e5150e542ff9a83e2323318b21f40d6a3e65b4789",
    * //   input: "0x83259f17000000000000000000000000000000000000000000...",
-   * //   maxFeePerGas: { TinyBig: 67681261618 },
-   * //   maxPriorityFeePerGas: { TinyBig: 1500000000 },
-   * //   nonce: { TinyBig: 129 },
+   * //   maxFeePerGas: 67681261618n,
+   * //   maxPriorityFeePerGas: 1500000000n,
+   * //   nonce: 129n,
    * //   r: "0x59a7c15b12c18cd68d6c440963d959bff3e73831ffc938e75ecad07f7ee43fbc",
    * //   s: "0x1ebaf05f0d9273b16c2a7748b150a79d22533a8cd74552611cbe620fee3dcf1c",
    * //   to: "0x39B72d136ba3e4ceF35F48CD09587ffaB754DD8B",
    * //   transactionIndex: 29,
    * //   type: 2,
    * //   v: 0,
-   * //   value: { TinyBig: 0 },
+   * //   value: 0n,
    * //   confirmations: 298140,
    * // }
    * ```
@@ -465,7 +478,6 @@ var BaseProvider = class {
    *
    * * [Identical](/docs/api#isd) to [`ethers.provider.getTransactionReceipt`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getTransactionReceipt) in ethers.js
    * * [Similar](/docs/api#isd) to [`web3.eth.getTransactionReceipt`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#gettransactionreceipt) in web3.js, some information returned using different types
-   *
    * @param transactionHash the hash of the transaction to get information about
    * @returns information about the specified transaction that has already been mined
    * @example
@@ -475,10 +487,10 @@ var BaseProvider = class {
    * //   blockHash: "0x876810a013dbcd140f6fd6048c1dc33abbb901f1f96b394c2fa63aef3cb40b5d",
    * //   blockNumber: 14578286,
    * //   contractAddress: null,
-   * //   cumulativeGasUsed: { TinyBig: 3067973 },
-   * //   effectiveGasPrice: { TinyBig: 48592426858 },
+   * //   cumulativeGasUsed: 3067973n,
+   * //   effectiveGasPrice: 48592426858n,
    * //   from: "0xdfD9dE5f6FA60BD70636c0900752E93a6144AEd4",
-   * //   gasUsed: { TinyBig: 112163 },
+   * //   gasUsed: 112163n,
    * //   logs: [
    * //     {
    * //       address: "0x0eDF9bc41Bbc1354c70e2107F80C42caE7FBBcA8",
@@ -536,7 +548,6 @@ var BaseProvider = class {
    *
    * * [Identical](/docs/api#isd) to [`ethers.provider.getTransactionCount`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getTransactionCount) in ethers.js
    * * [Identical](/docs/api#isd) to [`web3.eth.getTransactionCount`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#gettransactioncount) in web3.js
-   *
    * @param address the address to count number of sent transactions
    * @param blockTag the block to count transactions up to, inclusive
    * @returns the number of transactions sent by the specified address
@@ -568,7 +579,6 @@ var BaseProvider = class {
    *
    * * [Similar](/docs/api#isd) to [`ethers.provider.getBlock`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getLogs) in ethers.js, includes some additional information. Can also return block with full transaction objects, similar to [`ethers.providers.getBlockWithTransactions`]
    * * [Identical](/docs/api#isd) to [`web3.eth.getBlock`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#getpastlogs) in web3.js
-   *
    * @param timeFrame The number, hash, or text-based description ('latest', 'earliest', or 'pending') of the block to collect information on.
    * @param returnTransactionObjects Whether to also return data about the transactions on the block.
    * @returns A BlockResponse object with information about the specified block
@@ -576,11 +586,11 @@ var BaseProvider = class {
    * ```javascript
    * await provider.getBlock(14879862);
    * // {
-   * //   baseFeePerGas: { TinyBig: 39095728776 },
-   * //   difficulty: { TinyBig: 14321294455359973 },
+   * //   baseFeePerGas: 39095728776n,
+   * //   difficulty: 14321294455359973n,
    * //   extraData: "0x486976656f6e2073672d6865617679",
-   * //   gasLimit: { TinyBig: 29970620 },
-   * //   gasUsed: { TinyBig: 20951384 },
+   * //   gasLimit: 29970620n,
+   * //   gasUsed: 20951384n,
    * //   hash: "0x563b458ec3c4f87393b53f70bdddc0058497109b784d8cacd9247ddf267049ab",
    * //   logsBloom:
    * //     "0x9f38794fe80b521794df6efad8b0d2e9582f9ec3959a3f9384bda0fa371cfa5fac5af9d515c6bdf1ec325f5b5f7ebdd6a3a9fae17b38a86d4dc4b0971afc68d8086640550f4c156e6f923f4a1bb94fb0bed6cdcc474c5c64bfeff7a4a906f72b9a7b94004ee58efc53d63ac66961acd3a431b2d896cc9fd75f6072960bced45f770587caf130f57504decfcb63c6ca8fbc5bdbd749edd5a99a7375d2b81872289adb775fb3c928259f4be39c6d3f4d5b6217822979bb88c1f1fb62429b1b6d41cf4e3f77f9e1db3f5723108f1e5b1255dd734ad8cdb11e7ea22487c788e67c83777b6f395e504ca59c64f52245ee6de3804cf809e5caa4f0ea6a9aa9eb6ed801",
@@ -591,10 +601,10 @@ var BaseProvider = class {
    * //   parentHash: "0x95986ae14a71face8d9a6a379edd875b2e8bc73e4de0d9d460e7752bddb0f579",
    * //   receiptsRoot: "0x8e6ba2fd9bee602b653dae6e3132f16538c2c5df24f1df8c000392053f73defa",
    * //   sha3Uncles: "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
-   * //   size: { TinyBig: 134483 },
+   * //   size: 134483n,
    * //   stateRoot: "0xbf2bb67bd1c741f3d00904b8451d7c2cf4e3a2726f5a5884792ede2074747b85",
-   * //   timestamp: { TinyBig: 1654016186 },
-   * //   totalDifficulty: { TinyBig: 50478104614257705213748 },
+   * //   timestamp: 1654016186n,
+   * //   totalDifficulty: 50478104614257705213748n,
    * //   transactions: [
    * //     "0xb3326a9149809603a2c28545e50e4f7d16e194bf5ee9764e0544603854c4a8d2",
    * //     "0x8b42095f8d335404a4896b2817b8e5e3d86a5a87cb434a8eec295d5280a7f48e",
@@ -625,8 +635,7 @@ var BaseProvider = class {
    * Gives an estimate of the current gas price in wei.
    *
    * * [Similar](/docs/api#isd) to [`ethers.provider.getGasPrice`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getGasPrice) in ethers.js, does not have a parameter specifying what unit you'd like to return. See also [`weiToEther`](/docs/api/modules#weitoether) and [`etherToGwei`](/docs/api/modules#ethertogwei)
-   * * [Identical](/docs/api#isd) to [`web3.eth.getGasPrice`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#getgasprice) in web3.js, returns a number (TinyBig) instead of a string
-   *
+   * * [Identical](/docs/api#isd) to [`web3.eth.getGasPrice`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#getgasprice) in web3.js, returns a number (bigint) instead of a string
    * @returns an estimate of the current gas price in wei
    * @example
    * ```javascript
@@ -638,14 +647,13 @@ var BaseProvider = class {
     const hexGasPrice = await this.post(
       buildRPCPostBody("eth_gasPrice", [])
     );
-    return tinyBig(hexToDecimal(hexGasPrice));
+    return BigInt(hexToDecimal(hexGasPrice));
   }
   /**
    * Returns the balance of the account in wei.
    *
    * * [Identical](/docs/api#isd) to [`ethers.provider.getBalance`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getBalance) in ethers.js
-   * * [Identical](/docs/api#isd) to [`web3.eth.getBalance`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#getbalance) in web3.js, returns a number (TinyBig) instead of a string
-   *
+   * * [Identical](/docs/api#isd) to [`web3.eth.getBalance`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#getbalance) in web3.js, returns a number (bigint) instead of a string
    * @param address the address to check the balance of
    * @param blockTag the block to check the specified address' balance on
    * @returns the balance of the network's native token for the specified address on the specified block
@@ -660,14 +668,13 @@ var BaseProvider = class {
     const hexBalance = await this.post(
       buildRPCPostBody("eth_getBalance", [address, blockTag])
     );
-    return tinyBig(hexToDecimal(hexBalance));
+    return BigInt(hexToDecimal(hexBalance));
   }
   /**
    * Gets the code of a contract on a specified block.
    *
    * * [Identical](/docs/api#isd) to [`ethers.provider.getCode`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getCode) in ethers.js
    * * [Identical](/docs/api#isd) to [`web3.eth.getCode`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#getcode) in web3.js
-   *
    * @param address the contract address to get the contract code from
    * @param blockTag the block height to search for the contract code from. Contract code can change, so this allows for checking a specific block
    * @returns the contract creation code for the specified address at the specified block height
@@ -690,7 +697,6 @@ var BaseProvider = class {
    *
    * * [Identical](/docs/api#isd) to [`ethers.provider.estimateGas`](https://docs.ethers.io/v5/api/providers/provider/#Provider-estimateGas) in ethers.js
    * * [Identical](/docs/api#isd) to [`web3.eth.estimateGas`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#estimateGas) in web3.js
-   *
    * @param transaction the transaction to check the estimated gas cost for
    * @returns the estimated amount of gas charged for submitting the specified transaction to the blockchain
    * @example
@@ -701,7 +707,7 @@ var BaseProvider = class {
    *   data: "0xd0e30db0",
    *   value: etherToWei('1.0').toHexString(),
    * });
-   * // { TinyBig: "27938" }
+   * // 27938n
    * ```
    */
   async estimateGas(transaction) {
@@ -709,7 +715,7 @@ var BaseProvider = class {
     const gasUsed = await this.post(
       buildRPCPostBody("eth_estimateGas", [rpcTransaction])
     );
-    return tinyBig(hexToDecimal(gasUsed));
+    return BigInt(hexToDecimal(gasUsed));
   }
   /**
    * Returns the current recommended FeeData to use in a transaction.
@@ -717,16 +723,15 @@ var BaseProvider = class {
    * For legacy transactions and networks which do not support EIP-1559, the gasPrice should be used.Returns an estimate of the amount of gas that would be required to submit transaction to the network.
    *
    * * [Identical](/docs/api#isd) to [`ethers.provider.getFeeData`](https://docs.ethers.org/v5/api/providers/provider/#Provider-getFeeData) in ethers.js
-   *
    * @returns an object with gas estimates for the network currently
    * @example
    * ```javascript
    * await provider.getFeeData();
    * // {
-   * //   gasPrice: { TinyBig: "14184772639" },
-   * //   lastBaseFeePerGas: { TinyBig: "14038523098" },
-   * //   maxFeePerGas: { TinyBig: "29577046196" },
-   * //   maxPriorityFeePerGas: { TinyBig: "1500000000" }
+   * //   gasPrice: 14184772639n,
+   * //   lastBaseFeePerGas: 14038523098n,
+   * //   maxFeePerGas: 29577046196n,
+   * //   maxPriorityFeePerGas: 1500000000n
    * // }
    * ```
    */
@@ -738,10 +743,8 @@ var BaseProvider = class {
     let lastBaseFeePerGas = null, maxFeePerGas = null, maxPriorityFeePerGas = null;
     if (block && block.baseFeePerGas) {
       lastBaseFeePerGas = block.baseFeePerGas;
-      maxPriorityFeePerGas = tinyBig("1500000000");
-      maxFeePerGas = tinyBig(
-        block.baseFeePerGas.mul(2).add(maxPriorityFeePerGas)
-      );
+      maxPriorityFeePerGas = BigInt("1500000000");
+      maxFeePerGas = block.baseFeePerGas * 2n + maxPriorityFeePerGas;
     }
     return { lastBaseFeePerGas, maxFeePerGas, maxPriorityFeePerGas, gasPrice };
   }
@@ -751,7 +754,6 @@ var BaseProvider = class {
    *
    * * [Identical](/docs/api#isd) to [`ethers.provider.getLogs`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getLogs) in ethers.js
    * * [Identical](/docs/api#isd) to [`web3.eth.getPastLogs`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#getpastlogs) in web3.js
-   *
    * @param filter parameters to filter the logs by
    * @returns an array of logs matching the specified filter
    * @example
@@ -803,7 +805,6 @@ var BaseProvider = class {
    *
    * * [Identical](/docs/api#isd) to [`ethers.provider.call`](https://docs.ethers.io/v5/api/providers/provider/#Provider-call) in ethers.js
    * * [Identical](/docs/api#isd) to [`web3.eth.call`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#call) in web3.js
-   *
    * @param transaction the transaction object to, in theory, execute. Doesn't actually get added to the blockchain.
    * @param blockTag the block to execute this transaction on
    * @returns the result of executing the transaction on the specified block
@@ -840,6 +841,61 @@ var BaseProvider = class {
     );
     return transactionRes;
   }
+  /**
+   * Resolves an ENS name to an Ethereum address.
+   *
+   * Performs the full ENS resolution process:
+   * 1. Computes the namehash of the ENS name
+   * 2. Queries the ENS Registry for the resolver contract
+   * 3. Queries the resolver for the address
+   *
+   * * [Identical](/docs/api#isd) to [`ethers.provider.resolveName`](https://docs.ethers.io/v5/api/providers/provider/#Provider-resolveName) in ethers.js
+   * @param name the ENS name to resolve (e.g. 'vitalik.eth')
+   * @returns the Ethereum address the name resolves to, or null if not found
+   * @example
+   * ```javascript
+   * await provider.resolveName('vitalik.eth');
+   * // '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'
+   * ```
+   * @example
+   * ```javascript
+   * await provider.resolveName('thisshouldnotexist12345.eth');
+   * // null
+   * ```
+   */
+  async resolveName(name) {
+    const ENS_REGISTRY = "0x00000000000C2E074eC69A0dFb2997BA6C7d2e1e";
+    const RESOLVER_SELECTOR = "0x0178b8bf";
+    const ADDR_SELECTOR = "0x3b3b57de";
+    const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000000000000000000000000000";
+    const node = namehash(name);
+    const nodeWithoutPrefix = node.slice(2);
+    const resolverData = RESOLVER_SELECTOR + nodeWithoutPrefix;
+    const resolverResult = await this.call({
+      to: ENS_REGISTRY,
+      data: resolverData
+    });
+    if (!resolverResult || resolverResult === ZERO_ADDRESS) {
+      return null;
+    }
+    const resolverAddress = "0x" + resolverResult.slice(26);
+    if (resolverAddress === "0x0000000000000000000000000000000000000000" || resolverAddress === "0x" + "0".repeat(resolverResult.length - 2)) {
+      return null;
+    }
+    const addrData = ADDR_SELECTOR + nodeWithoutPrefix;
+    const addrResult = await this.call({
+      to: resolverAddress,
+      data: addrData
+    });
+    if (!addrResult || addrResult === ZERO_ADDRESS) {
+      return null;
+    }
+    const rawAddress = "0x" + addrResult.slice(26);
+    if (rawAddress === "0x0000000000000000000000000000000000000000") {
+      return null;
+    }
+    return toChecksumAddress(rawAddress);
+  }
 };
 
 // src/providers/JsonRpcProvider.ts
@@ -941,4 +997,149 @@ var FallthroughProvider = class extends BaseProvider {
   };
 };
 
-export { AlchemyProvider, BaseContract, Contract, FallthroughProvider, JsonRpcProvider, jsonRpcProvider };
+// src/utils/abi-encode-decode.ts
+function findFunctionABI(abi, functionName) {
+  const entry = abi.find(
+    (item) => item.type === "function" && item.name === functionName
+  );
+  if (!entry) {
+    throw new Error(`Function "${functionName}" not found in ABI`);
+  }
+  return entry;
+}
+function encodeFunctionData(abi, functionName, args = []) {
+  const abiEntry = findFunctionABI(abi, functionName);
+  return encodeData(abiEntry, args);
+}
+function decodeFunctionResult(abi, functionName, data) {
+  const abiEntry = findFunctionABI(abi, functionName);
+  return decodeRPCResponse(abiEntry, data);
+}
+
+// src/utils/to-utf8-string.ts
+function toUtf8String(bytes) {
+  return new TextDecoder().decode(arrayify(bytes));
+}
+
+// src/utils/bytes32-string.ts
+function encodeBytes32String(text) {
+  const bytes = toUtf8Bytes(text);
+  if (bytes.length > 31) {
+    throw new Error("bytes32 string must be less than 32 bytes");
+  }
+  const padded = new Uint8Array(32);
+  padded.set(bytes);
+  return hexlify(padded);
+}
+function decodeBytes32String(bytes32) {
+  let hex = bytes32;
+  if (hex.startsWith("0x") || hex.startsWith("0X")) {
+    hex = hex.slice(2);
+  }
+  hex = hex.replace(/(00)+$/, "");
+  if (hex.length === 0)
+    return "";
+  return toUtf8String("0x" + hex);
+}
+
+// src/utils/decode-event-log.ts
+function computeEventTopic(event) {
+  const types = event.inputs.map((input) => input.type);
+  const signature = `${event.name}(${types.join(",")})`;
+  return keccak256(toUtf8Bytes(signature));
+}
+function decodeValue(hexChunk, type) {
+  if (type === "bool") {
+    return hexChunk[hexChunk.length - 1] === "1";
+  }
+  if (type === "address") {
+    return toChecksumAddress(`0x${hexChunk.slice(24)}`);
+  }
+  if (type === "bytes32") {
+    return `0x${hexChunk}`;
+  }
+  if (type === "uint8") {
+    return Number(BigInt(`0x${hexChunk}`));
+  }
+  if (type.startsWith("uint")) {
+    return BigInt(`0x${hexChunk}`);
+  }
+  if (type.startsWith("int")) {
+    return BigInt(`0x${hexChunk}`);
+  }
+  throw new Error(
+    `essential-eth does not yet support decoding "${type}" in event logs. Make a PR today!`
+  );
+}
+function decodeEventLog(abi, log) {
+  const topic0 = log.topics[0];
+  const events = abi.filter((entry) => entry.type === "event");
+  let matchedEvent;
+  for (const event of events) {
+    const hash = computeEventTopic(event);
+    if (hash === topic0) {
+      matchedEvent = event;
+      break;
+    }
+  }
+  if (!matchedEvent) {
+    throw new Error(`No matching event found in ABI for topic0: ${topic0}`);
+  }
+  const args = {};
+  let topicIndex = 1;
+  let dataOffset = 0;
+  const rawData = log.data.startsWith("0x") ? log.data.slice(2) : log.data;
+  for (const input of matchedEvent.inputs) {
+    if (input.indexed) {
+      const topicHex = log.topics[topicIndex];
+      const hexChunk = topicHex.startsWith("0x") ? topicHex.slice(2) : topicHex;
+      args[input.name] = decodeValue(hexChunk, input.type);
+      topicIndex++;
+    } else {
+      const hexChunk = rawData.slice(dataOffset, dataOffset + 64);
+      args[input.name] = decodeValue(hexChunk, input.type);
+      dataOffset += 64;
+    }
+  }
+  return {
+    eventName: matchedEvent.name,
+    args
+  };
+}
+
+// src/utils/event-topic.ts
+function getEventTopic(eventSignature) {
+  return keccak256(toUtf8Bytes(eventSignature));
+}
+function getEventSignature(abi, eventName) {
+  const event = abi.find(
+    (entry) => entry.type === "event" && entry.name === eventName
+  );
+  if (!event) {
+    throw new Error(`Event "${eventName}" not found in ABI`);
+  }
+  const signature = `${event.name}(${event.inputs.map((input) => input.type).join(",")})`;
+  return getEventTopic(signature);
+}
+
+// src/utils/format-units.ts
+function formatUnits(value, decimals = 18) {
+  return formatFixed(toBigInt(value), decimals);
+}
+
+// src/utils/get-address.ts
+function getAddress(address) {
+  return toChecksumAddress(address);
+}
+
+// src/utils/id.ts
+function id(text) {
+  return keccak256(toUtf8Bytes(text));
+}
+
+// src/utils/parse-units.ts
+function parseUnits(value, decimals = 18) {
+  return parseFixed(value, decimals);
+}
+
+export { AlchemyProvider, BaseContract, Contract, FallthroughProvider, JsonRpcProvider, decodeBytes32String, decodeEventLog, decodeFunctionResult, encodeBytes32String, encodeFunctionData, formatUnits, getAddress, getEventSignature, getEventTopic, id, jsonRpcProvider, namehash, parseUnits, toUtf8String };

package/dist/utils.d.ts

@@ -1,3 +1,2 @@
-export { d as arrayify, e as computeAddress, f as computePublicKey, g as concat, h as hashMessage, i as hexConcat, j as hexDataLength, k as hexDataSlice, l as hexStripZeros, m as hexValue, n as hexZeroPad, o as hexlify, p as isAddress, q as isBytes, r as isBytesLike, s as isHexString, t as keccak256, u as pack, v as solidityKeccak256, w as splitSignature, x as stripZeros, y as toChecksumAddress, z as toUtf8Bytes, A as zeroPad } from './index-utils-D40THakY.js';
+export { a as arrayify, p as computeAddress, q as computePublicKey, d as concat, r as hashMessage, h as hexConcat, e as hexDataLength, f as hexDataSlice, i as hexStripZeros, j as hexValue, k as hexZeroPad, g as hexlify, t as isAddress, l as isBytes, m as isBytesLike, n as isHexString, u as keccak256, v as pack, w as solidityKeccak256, x as splitSignature, s as stripZeros, y as toChecksumAddress, A as toUtf8Bytes, z as zeroPad } from './index-utils-e8a8adc8.js';
 export { etherToGwei, etherToWei, gweiToEther, weiToEther } from './conversions.js';
-import 'big.js';

package/dist/utils.js

@@ -1,2 +1,2 @@
-export { arrayify, computeAddress, computePublicKey, concat, hashMessage, hexConcat, hexDataLength, hexDataSlice, hexStripZeros, hexValue, hexZeroPad, hexlify, isAddress, isBytes, isBytesLike, isHexString, keccak256, pack, solidityKeccak256, splitSignature, stripZeros, toChecksumAddress, toUtf8Bytes, zeroPad } from './chunk-C4VOKUKQ.js';
-export { etherToGwei, etherToWei, gweiToEther, weiToEther } from './chunk-UXC5R4JE.js';
+export { arrayify, computeAddress, computePublicKey, concat, hashMessage, hexConcat, hexDataLength, hexDataSlice, hexStripZeros, hexValue, hexZeroPad, hexlify, isAddress, isBytes, isBytesLike, isHexString, keccak256, pack, solidityKeccak256, splitSignature, stripZeros, toChecksumAddress, toUtf8Bytes, zeroPad } from './chunk-CLIQ4S3P.js';
+export { etherToGwei, etherToWei, gweiToEther, weiToEther } from './chunk-GFWRB7PT.js';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "essential-eth",
   "description": "Ultralight JS for Ethereum",
-  "version": "0.13.0",
+  "version": "1.0.0",
   "license": "MIT",
   "sideEffects": false,
   "type": "module",
@@ -26,7 +26,7 @@
   },
   "types": "./dist/index.d.ts",
   "engines": {
-    "node": ">=18"
+    "node": ">=16"
   },
   "files": [
     "dist/"
@@ -64,7 +64,7 @@
     "bn.js": "^5.2.1",
     "dotenv": "^16.0.0",
     "eslint": "^8.16.0",
-    "eslint-plugin-jsdoc": "^38.0.2",
+    "eslint-plugin-jsdoc": "^47.0.2",
     "eslint-plugin-vitest": "^0.1.5",
     "husky": "^7.0.4",
     "lint-staged": "^13.2.1",
@@ -72,7 +72,8 @@
     "perf_hooks": "^0.0.1",
     "prettier": "^3.2.5",
     "prettier-plugin-organize-imports": "^3.2.4",
-    "tsup": "^8.5.1",
+    "tsup": "^7.2.0",
+    "vite": "^4.5.0",
     "typedoc": "^0.24.5",
     "typescript": "^4.9.4",
     "vitest": "^0.34.6",
@@ -81,8 +82,6 @@
   "dependencies": {
     "@noble/hashes": "^2.0.1",
     "@noble/secp256k1": "^1.5.5",
-    "@types/big.js": "^6.1.6",
-    "big.js": "^6.2.1",
     "ethers": "^5.7.2",
     "isomorphic-unfetch": "^3.1.0",
     "sha3": "^2.1.4"