essential-eth 1.0.0 → 1.1.0

package/dist/{chunk-CLIQ4S3P.js → chunk-4V2QY6OK.js}

@@ -26,7 +26,7 @@ function toChecksumAddress(address) {
 }
 
 // src/logger/package-version.ts
-var version = "1.0.0";
+var version = "1.1.0";
 
 // src/logger/logger.ts
 var Logger = class {

package/dist/index.cjs

@@ -522,7 +522,7 @@ function buildRPCPostBody(method, params) {
 }
 
 // src/logger/package-version.ts
-var version = "1.0.0";
+var version = "1.1.0";
 
 // src/logger/logger.ts
 var Logger = class {
@@ -1486,6 +1486,82 @@ var BaseProvider = class {
     }
     return toChecksumAddress(rawAddress);
   }
+  /**
+   * Performs reverse ENS resolution to get the ENS name associated with an address.
+   *
+   * Performs the full ENS reverse resolution process:
+   * 1. Formats the address as a reverse lookup: `{address}.addr.reverse`
+   * 2. Computes the namehash of the reverse name
+   * 3. Queries the ENS Registry for the resolver contract
+   * 4. Queries the resolver for the name
+   * 5. Verifies the name resolves back to the original address (per ENSIP-3)
+   *
+   * * [Identical](/docs/api#isd) to [`viem.getEnsName`](https://viem.sh/docs/ens/actions/getEnsName) in viem
+   * @param address the Ethereum address to look up (e.g. '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045')
+   * @returns the ENS name the address resolves to, or null if not found or verification fails
+   * @example
+   * ```javascript
+   * await provider.lookupAddress('0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045');
+   * // 'vitalik.eth'
+   * ```
+   * @example
+   * ```javascript
+   * await provider.lookupAddress('0x0000000000000000000000000000000000000000');
+   * // null
+   * ```
+   */
+  async lookupAddress(address) {
+    const ENS_REGISTRY = "0x00000000000C2E074eC69A0dFb2997BA6C7d2e1e";
+    const RESOLVER_SELECTOR = "0x0178b8bf";
+    const NAME_SELECTOR = "0x691f3431";
+    const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000000000000000000000000000";
+    const addressLower = address.toLowerCase();
+    const addressWithoutPrefix = addressLower.startsWith("0x") ? addressLower.slice(2) : addressLower;
+    const reverseName = `${addressWithoutPrefix}.addr.reverse`;
+    const node = namehash(reverseName);
+    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 nameData = NAME_SELECTOR + nodeWithoutPrefix;
+    const nameResult = await this.call({
+      to: resolverAddress,
+      data: nameData
+    });
+    if (!nameResult || nameResult === ZERO_ADDRESS) {
+      return null;
+    }
+    const lengthHex = nameResult.slice(2 + 64, 2 + 128);
+    const length = parseInt(lengthHex, 16);
+    if (length === 0) {
+      return null;
+    }
+    const dataHex = nameResult.slice(2 + 128);
+    const name = dataHex.slice(0, length * 2).match(/.{1,2}/g)?.map((byte) => String.fromCharCode(parseInt(byte, 16))).join("");
+    if (!name) {
+      return null;
+    }
+    try {
+      const verifyAddress = await this.resolveName(name);
+      const normalizedAddress = addressLower.startsWith("0x") ? addressLower : "0x" + addressLower;
+      const normalizedVerifyAddress = verifyAddress?.toLowerCase();
+      if (normalizedVerifyAddress !== normalizedAddress) {
+        return null;
+      }
+    } catch {
+      return null;
+    }
+    return name;
+  }
 };
 
 // src/providers/JsonRpcProvider.ts
@@ -1520,7 +1596,7 @@ function jsonRpcProvider(rpcUrl) {
 // src/providers/AlchemyProvider.ts
 var AlchemyProvider = class extends JsonRpcProvider {
   constructor(apiKey, network = "mainnet") {
-    const alchemyUrl = `https://eth-${network}.alchemyapi.io/v2/${apiKey}`;
+    const alchemyUrl = `https://eth-${network}.g.alchemy.com/v2/${apiKey}`;
     super(alchemyUrl);
   }
 };

package/dist/index.d.ts

@@ -195,6 +195,7 @@ declare abstract class BaseProvider {
     getLogs(filter: Filter | FilterByBlockHash): Promise<Array<Log>>;
     call(transaction: TransactionRequest, blockTag?: BlockTag): Promise<string>;
     resolveName(name: string): Promise<string | null>;
+    lookupAddress(address: string): Promise<string | null>;
 }
 
 declare class JsonRpcProvider extends BaseProvider {

package/dist/index.js

@@ -1,5 +1,5 @@
-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 { keccak256, toUtf8Bytes, logger, encodeData, decodeRPCResponse, arrayify, hexlify, toChecksumAddress, hexToDecimal } from './chunk-4V2QY6OK.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-4V2QY6OK.js';
 import { formatFixed, toBigInt, parseFixed } from './chunk-GFWRB7PT.js';
 export { etherToGwei, etherToWei, gweiToEther, weiToEther } from './chunk-GFWRB7PT.js';
 import unfetch from 'isomorphic-unfetch';
@@ -896,6 +896,82 @@ var BaseProvider = class {
     }
     return toChecksumAddress(rawAddress);
   }
+  /**
+   * Performs reverse ENS resolution to get the ENS name associated with an address.
+   *
+   * Performs the full ENS reverse resolution process:
+   * 1. Formats the address as a reverse lookup: `{address}.addr.reverse`
+   * 2. Computes the namehash of the reverse name
+   * 3. Queries the ENS Registry for the resolver contract
+   * 4. Queries the resolver for the name
+   * 5. Verifies the name resolves back to the original address (per ENSIP-3)
+   *
+   * * [Identical](/docs/api#isd) to [`viem.getEnsName`](https://viem.sh/docs/ens/actions/getEnsName) in viem
+   * @param address the Ethereum address to look up (e.g. '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045')
+   * @returns the ENS name the address resolves to, or null if not found or verification fails
+   * @example
+   * ```javascript
+   * await provider.lookupAddress('0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045');
+   * // 'vitalik.eth'
+   * ```
+   * @example
+   * ```javascript
+   * await provider.lookupAddress('0x0000000000000000000000000000000000000000');
+   * // null
+   * ```
+   */
+  async lookupAddress(address) {
+    const ENS_REGISTRY = "0x00000000000C2E074eC69A0dFb2997BA6C7d2e1e";
+    const RESOLVER_SELECTOR = "0x0178b8bf";
+    const NAME_SELECTOR = "0x691f3431";
+    const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000000000000000000000000000";
+    const addressLower = address.toLowerCase();
+    const addressWithoutPrefix = addressLower.startsWith("0x") ? addressLower.slice(2) : addressLower;
+    const reverseName = `${addressWithoutPrefix}.addr.reverse`;
+    const node = namehash(reverseName);
+    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 nameData = NAME_SELECTOR + nodeWithoutPrefix;
+    const nameResult = await this.call({
+      to: resolverAddress,
+      data: nameData
+    });
+    if (!nameResult || nameResult === ZERO_ADDRESS) {
+      return null;
+    }
+    const lengthHex = nameResult.slice(2 + 64, 2 + 128);
+    const length = parseInt(lengthHex, 16);
+    if (length === 0) {
+      return null;
+    }
+    const dataHex = nameResult.slice(2 + 128);
+    const name = dataHex.slice(0, length * 2).match(/.{1,2}/g)?.map((byte) => String.fromCharCode(parseInt(byte, 16))).join("");
+    if (!name) {
+      return null;
+    }
+    try {
+      const verifyAddress = await this.resolveName(name);
+      const normalizedAddress = addressLower.startsWith("0x") ? addressLower : "0x" + addressLower;
+      const normalizedVerifyAddress = verifyAddress?.toLowerCase();
+      if (normalizedVerifyAddress !== normalizedAddress) {
+        return null;
+      }
+    } catch {
+      return null;
+    }
+    return name;
+  }
 };
 
 // src/providers/JsonRpcProvider.ts
@@ -930,7 +1006,7 @@ function jsonRpcProvider(rpcUrl) {
 // src/providers/AlchemyProvider.ts
 var AlchemyProvider = class extends JsonRpcProvider {
   constructor(apiKey, network = "mainnet") {
-    const alchemyUrl = `https://eth-${network}.alchemyapi.io/v2/${apiKey}`;
+    const alchemyUrl = `https://eth-${network}.g.alchemy.com/v2/${apiKey}`;
     super(alchemyUrl);
   }
 };

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-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-4V2QY6OK.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": "1.0.0",
+  "version": "1.1.0",
   "license": "MIT",
   "sideEffects": false,
   "type": "module",

package/readme.md

@@ -27,10 +27,10 @@
 
 Measured with esbuild. Smaller is better.
 
-| What you import                          | essential-eth@1.0.0 | ethers@6.16.0 | viem@2.45.1 | web3@4.16.0 |   ox@0.12.0    |
+| What you import                          | essential-eth@1.1.0 | ethers@6.16.0 | viem@2.45.1 | web3@4.16.0 |   ox@0.12.0    |
 | ---------------------------------------- | :-----------------: | :-----------: | :---------: | :---------: | :------------: |
-| **Full library**                         |   **42.2 kB** 🏆    |   394.0 kB    |  348.3 kB   |  495.8 kB   |    612.8 kB    |
-| **Provider** (getBalance, getBlock, etc) |       29.9 kB       |   260.0 kB    |  269.5 kB   |  454.5 kB   | **10.9 kB** 🏆 |
+| **Full library**                         |   **43.1 kB** 🏆    |   394.0 kB    |  348.3 kB   |  495.8 kB   |    612.8 kB    |
+| **Provider** (getBalance, getBlock, etc) |       30.8 kB       |   260.0 kB    |  269.5 kB   |  454.5 kB   | **10.9 kB** 🏆 |
 | **Contract** (read-only calls)           |   **24.8 kB** 🏆    |    86.6 kB    |  179.8 kB   |  264.9 kB   |    49.9 kB     |
 | **Conversions** (wei, gwei, ether)       |    **1.2 kB** 🏆    |    10.4 kB    |   2.7 kB    |  454.5 kB   |     3.7 kB     |
 
@@ -174,7 +174,7 @@ Browsers:
 ```html
 
 <!-- index.html -->
-<script src="https://unpkg.com/essential-eth@1.0.0"></script>
+<script src="https://unpkg.com/essential-eth@1.1.0"></script>
 ```