viem 2.34.0 → 2.35.0-canary-20250821143721

package/_types/utils/ens/toCoinType.d.ts

@@ -0,0 +1,12 @@
+import { type EnsInvalidChainIdErrorType } from '../../errors/ens.js';
+import type { ErrorType } from '../../errors/utils.js';
+export type ToCoinTypeError = EnsInvalidChainIdErrorType | ErrorType;
+/**
+ * @description Converts a chainId to a ENSIP-9 compliant coinType
+ *
+ * @example
+ * toCoinType(10)
+ * 2147483658n
+ */
+export declare function toCoinType(chainId: number): bigint;
+//# sourceMappingURL=toCoinType.d.ts.map

package/_types/utils/ens/toCoinType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toCoinType.d.ts","sourceRoot":"","sources":["../../../utils/ens/toCoinType.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,qBAAqB,CAAA;AAC5B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAEtD,MAAM,MAAM,eAAe,GAAG,0BAA0B,GAAG,SAAS,CAAA;AAIpE;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKlD"}

package/actions/ens/getEnsAddress.ts

@@ -38,15 +38,35 @@ import {
 
 export type GetEnsAddressParameters = Prettify<
   Pick<ReadContractParameters, 'blockNumber' | 'blockTag'> & {
-    /** ENSIP-9 compliant coinType used to resolve addresses for other chains */
-    coinType?: number | undefined
-    /** Universal Resolver gateway URLs to use for resolving CCIP-read requests. */
+    /**
+     * ENSIP-9 compliant coinType (chain) to get ENS address for.
+     *
+     * To get the `coinType` for a chain id, use the `toCoinType` function:
+     * ```ts
+     * import { toCoinType } from 'viem'
+     * import { base } from 'viem/chains'
+     *
+     * const coinType = toCoinType(base.id)
+     * ```
+     *
+     * @default 60n
+     */
+    coinType?: bigint | undefined
+    /**
+     * Universal Resolver gateway URLs to use for resolving CCIP-read requests.
+     */
     gatewayUrls?: string[] | undefined
-    /** Name to get the address for. */
+    /**
+     * Name to get the address for.
+     */
     name: string
-    /** Whether or not to throw errors propagated from the ENS Universal Resolver Contract. */
+    /**
+     * Whether or not to throw errors propagated from the ENS Universal Resolver Contract.
+     */
     strict?: boolean | undefined
-    /** Address of ENS Universal Resolver Contract. */
+    /**
+     * Address of ENS Universal Resolver Contract.
+     */
     universalResolverAddress?: Address | undefined
   }
 >
@@ -116,19 +136,22 @@ export async function getEnsAddress<chain extends Chain | undefined>(
   const tlds = chain?.ensTlds
   if (tlds && !tlds.some((tld) => name.endsWith(tld))) return null
 
+  const args = (() => {
+    if (coinType != null) return [namehash(name), BigInt(coinType)] as const
+    return [namehash(name)] as const
+  })()
+
   try {
     const functionData = encodeFunctionData({
       abi: addressResolverAbi,
       functionName: 'addr',
-      ...(coinType != null
-        ? { args: [namehash(name), BigInt(coinType)] }
-        : { args: [namehash(name)] }),
+      args,
     })
 
     const readContractParameters = {
       address: universalResolverAddress,
       abi: universalResolverResolveAbi,
-      functionName: 'resolve',
+      functionName: 'resolveWithGateways',
       args: [
         toHex(packetToBytes(name)),
         functionData,
@@ -146,7 +169,7 @@ export async function getEnsAddress<chain extends Chain | undefined>(
 
     const address = decodeFunctionResult({
       abi: addressResolverAbi,
-      args: coinType != null ? [namehash(name), BigInt(coinType)] : undefined,
+      args,
       functionName: 'addr',
       data: res[0],
     })
@@ -156,7 +179,7 @@ export async function getEnsAddress<chain extends Chain | undefined>(
     return address
   } catch (err) {
     if (strict) throw err
-    if (isNullUniversalResolverError(err, 'resolve')) return null
+    if (isNullUniversalResolverError(err)) return null
     throw err
   }
 }

package/actions/ens/getEnsName.ts

@@ -10,12 +10,9 @@ import {
   type GetChainContractAddressErrorType,
   getChainContractAddress,
 } from '../../utils/chain/getChainContractAddress.js'
-import { type ToHexErrorType, toHex } from '../../utils/encoding/toHex.js'
 import { isNullUniversalResolverError } from '../../utils/ens/errors.js'
-import {
-  type PacketToBytesErrorType,
-  packetToBytes,
-} from '../../utils/ens/packetToBytes.js'
+import { localBatchGatewayUrl } from '../../utils/ens/localBatchGatewayRequest.js'
+import type { PacketToBytesErrorType } from '../../utils/ens/packetToBytes.js'
 import { getAction } from '../../utils/getAction.js'
 import {
   type ReadContractErrorType,
@@ -25,13 +22,35 @@ import {
 
 export type GetEnsNameParameters = Prettify<
   Pick<ReadContractParameters, 'blockNumber' | 'blockTag'> & {
-    /** Address to get ENS name for. */
+    /**
+     * Address to get ENS name for.
+     */
     address: Address
-    /** Universal Resolver gateway URLs to use for resolving CCIP-read requests. */
+    /**
+     * ENSIP-9 compliant coinType (chain) to get ENS name for.
+     *
+     * To get the `coinType` for a chain id, use the `toCoinType` function:
+     * ```ts
+     * import { toCoinType } from 'viem'
+     * import { base } from 'viem/chains'
+     *
+     * const coinType = toCoinType(base.id)
+     * ```
+     *
+     * @default 60n
+     */
+    coinType?: bigint | undefined
+    /**
+     * Universal Resolver gateway URLs to use for resolving CCIP-read requests.
+     */
     gatewayUrls?: string[] | undefined
-    /** Whether or not to throw errors propagated from the ENS Universal Resolver Contract. */
+    /**
+     * Whether or not to throw errors propagated from the ENS Universal Resolver Contract.
+     */
     strict?: boolean | undefined
-    /** Address of ENS Universal Resolver Contract. */
+    /**
+     * Address of ENS Universal Resolver Contract.
+     */
     universalResolverAddress?: Address | undefined
   }
 >
@@ -41,7 +60,6 @@ export type GetEnsNameReturnType = string | null
 export type GetEnsNameErrorType =
   | GetChainContractAddressErrorType
   | ReadContractErrorType
-  | ToHexErrorType
   | PacketToBytesErrorType
   | ErrorType
 
@@ -73,54 +91,50 @@ export type GetEnsNameErrorType =
  */
 export async function getEnsName<chain extends Chain | undefined>(
   client: Client<Transport, chain>,
-  {
+  parameters: GetEnsNameParameters,
+): Promise<GetEnsNameReturnType> {
+  const {
     address,
     blockNumber,
     blockTag,
+    coinType = 60n,
     gatewayUrls,
     strict,
-    universalResolverAddress: universalResolverAddress_,
-  }: GetEnsNameParameters,
-): Promise<GetEnsNameReturnType> {
-  let universalResolverAddress = universalResolverAddress_
-  if (!universalResolverAddress) {
-    if (!client.chain)
+  } = parameters
+  const { chain } = client
+
+  const universalResolverAddress = (() => {
+    if (parameters.universalResolverAddress)
+      return parameters.universalResolverAddress
+    if (!chain)
       throw new Error(
         'client chain not configured. universalResolverAddress is required.',
       )
-
-    universalResolverAddress = getChainContractAddress({
+    return getChainContractAddress({
       blockNumber,
-      chain: client.chain,
+      chain,
       contract: 'ensUniversalResolver',
     })
-  }
+  })()
 
-  const reverseNode = `${address.toLowerCase().substring(2)}.addr.reverse`
   try {
     const readContractParameters = {
       address: universalResolverAddress,
       abi: universalResolverReverseAbi,
-      functionName: 'reverse',
-      args: [toHex(packetToBytes(reverseNode))],
+      args: [address, coinType, gatewayUrls ?? [localBatchGatewayUrl]],
+      functionName: 'reverseWithGateways',
       blockNumber,
       blockTag,
     } as const
 
     const readContractAction = getAction(client, readContract, 'readContract')
 
-    const [name, resolvedAddress] = gatewayUrls
-      ? await readContractAction({
-          ...readContractParameters,
-          args: [...readContractParameters.args, gatewayUrls],
-        })
-      : await readContractAction(readContractParameters)
+    const [name] = await readContractAction(readContractParameters)
 
-    if (address.toLowerCase() !== resolvedAddress.toLowerCase()) return null
-    return name
+    return name || null
   } catch (err) {
     if (strict) throw err
-    if (isNullUniversalResolverError(err, 'reverse')) return null
+    if (isNullUniversalResolverError(err)) return null
     throw err
   }
 }

package/actions/ens/getEnsResolver.ts

@@ -102,7 +102,11 @@ export async function getEnsResolver<chain extends Chain | undefined>(
       {
         inputs: [{ type: 'bytes' }],
         name: 'findResolver',
-        outputs: [{ type: 'address' }, { type: 'bytes32' }],
+        outputs: [
+          { type: 'address' },
+          { type: 'bytes32' },
+          { type: 'uint256' },
+        ],
         stateMutability: 'view',
         type: 'function',
       },

package/actions/ens/getEnsText.ts

@@ -118,7 +118,6 @@ export async function getEnsText<chain extends Chain | undefined>(
     const readContractParameters = {
       address: universalResolverAddress,
       abi: universalResolverResolveAbi,
-      functionName: 'resolve',
       args: [
         toHex(packetToBytes(name)),
         encodeFunctionData({
@@ -128,6 +127,7 @@ export async function getEnsText<chain extends Chain | undefined>(
         }),
         gatewayUrls ?? [localBatchGatewayUrl],
       ],
+      functionName: 'resolveWithGateways',
       blockNumber,
       blockTag,
     } as const
@@ -147,7 +147,7 @@ export async function getEnsText<chain extends Chain | undefined>(
     return record === '' ? null : record
   } catch (err) {
     if (strict) throw err
-    if (isNullUniversalResolverError(err, 'resolve')) return null
+    if (isNullUniversalResolverError(err)) return null
     throw err
   }
 }

package/actions/public/waitForTransactionReceipt.ts

@@ -175,8 +175,8 @@ export async function waitForTransactionReceipt<
 
   const timer = timeout
     ? setTimeout(() => {
-        _unwatch()
-        _unobserve()
+        _unwatch?.()
+        _unobserve?.()
         reject(new WaitForTransactionReceiptTimeoutError({ hash }))
       }, timeout)
     : undefined
@@ -194,7 +194,7 @@ export async function waitForTransactionReceipt<
       if (receipt && confirmations <= 1) {
         clearTimeout(timer)
         emit.resolve(receipt)
-        _unobserve()
+        _unobserve?.()
         return
       }
 
@@ -210,9 +210,9 @@ export async function waitForTransactionReceipt<
         async onBlockNumber(blockNumber_) {
           const done = (fn: () => void) => {
             clearTimeout(timer)
-            _unwatch()
+            _unwatch?.()
             fn()
-            _unobserve()
+            _unobserve?.()
           }
 
           let blockNumber = blockNumber_

package/chains/definitions/avalanche.ts

@@ -3,6 +3,7 @@ import { defineChain } from '../../utils/chain/defineChain.js'
 export const avalanche = /*#__PURE__*/ defineChain({
   id: 43_114,
   name: 'Avalanche',
+  blockTime: 1_700,
   nativeCurrency: {
     decimals: 18,
     name: 'Avalanche',

package/chains/definitions/berachain.ts

@@ -1,7 +1,9 @@
 import { defineChain } from '../../utils/chain/defineChain.js'
+
 export const berachain = /*#__PURE__*/ defineChain({
   id: 80094,
   name: 'Berachain',
+  blockTime: 2_000,
   nativeCurrency: {
     decimals: 18,
     name: 'BERA Token',
@@ -17,8 +19,8 @@ export const berachain = /*#__PURE__*/ defineChain({
       blockCreated: 877007,
     },
     ensUniversalResolver: {
-      address: '0xddfb18888a9466688235887dec2a10c4f5effee9',
-      blockCreated: 877008,
+      address: '0x4D41762915F83c76EcaF6776d9b08076aA32b492',
+      blockCreated: 9310021,
     },
   },
   rpcUrls: {

package/chains/definitions/berachainBepolia.ts

@@ -2,6 +2,7 @@ import { defineChain } from '../../utils/chain/defineChain.js'
 
 export const berachainBepolia = /*#__PURE__*/ defineChain({
   id: 80069,
+  blockTime: 2_000,
   name: 'Berachain Bepolia',
   nativeCurrency: {
     decimals: 18,

package/chains/definitions/bsc.ts

@@ -3,6 +3,7 @@ import { defineChain } from '../../utils/chain/defineChain.js'
 export const bsc = /*#__PURE__*/ defineChain({
   id: 56,
   name: 'BNB Smart Chain',
+  blockTime: 750,
   nativeCurrency: {
     decimals: 18,
     name: 'BNB',

package/chains/definitions/eduChain.ts

@@ -19,5 +19,11 @@ export const eduChain = /*#__PURE__*/ defineChain({
       url: 'https://educhain.blockscout.com/',
     },
   },
+  contracts: {
+    multicall3: {
+      address: '0xcA11bde05977b3631167028862bE2a173976CA11',
+      blockCreated: 16410660,
+    },
+  },
   testnet: false,
 })

package/chains/definitions/etherlink.ts

@@ -3,6 +3,7 @@ import { defineChain } from '../../utils/chain/defineChain.js'
 export const etherlink = /*#__PURE__*/ defineChain({
   id: 42793,
   name: 'Etherlink',
+  blockTime: 4_830,
   nativeCurrency: {
     decimals: 18,
     name: 'Tez',

package/chains/definitions/hemi.ts

@@ -4,6 +4,7 @@ export const hemi = /*#__PURE__*/ defineChain({
   id: 43111,
   name: 'Hemi',
   network: 'Hemi',
+  blockTime: 12_000,
   nativeCurrency: {
     name: 'Ether',
     symbol: 'ETH',

package/chains/definitions/holesky.ts

@@ -21,13 +21,9 @@ export const holesky = /*#__PURE__*/ defineChain({
       address: '0xca11bde05977b3631167028862be2a173976ca11',
       blockCreated: 77,
     },
-    ensRegistry: {
-      address: '0x00000000000C2E074eC69A0dFb2997BA6C7d2e1e',
-      blockCreated: 801613,
-    },
     ensUniversalResolver: {
-      address: '0xa6AC935D4971E3CD133b950aE053bECD16fE7f3b',
-      blockCreated: 973484,
+      address: '0xeeeeeeee14d718c2b47d9923deab1335e144eeee',
+      blockCreated: 4_295_055,
     },
   },
   testnet: true,

package/chains/definitions/linea.ts

@@ -29,8 +29,8 @@ export const linea = /*#__PURE__*/ defineChain({
       blockCreated: 6682888,
     },
     ensUniversalResolver: {
-      address: '0x3aA974fb3f8C1E02796048BDCdeD79e9D53a6965',
-      blockCreated: 6683000,
+      address: '0x4D41762915F83c76EcaF6776d9b08076aA32b492',
+      blockCreated: 22_222_151,
     },
   },
   ensTlds: ['.linea.eth'],

package/chains/definitions/lineaSepolia.ts

@@ -29,8 +29,8 @@ export const lineaSepolia = /*#__PURE__*/ defineChain({
       blockCreated: 2395094,
     },
     ensUniversalResolver: {
-      address: '0x72560a31B3DAEE82B984a7F51c6b3b1bb7CC9F50',
-      blockCreated: 2395255,
+      address: '0x4D41762915F83c76EcaF6776d9b08076aA32b492',
+      blockCreated: 17_168_484,
     },
   },
   ensTlds: ['.linea.eth'],

package/chains/definitions/mainnet.ts

@@ -18,12 +18,9 @@ export const mainnet = /*#__PURE__*/ defineChain({
     },
   },
   contracts: {
-    ensRegistry: {
-      address: '0x00000000000C2E074eC69A0dFb2997BA6C7d2e1e',
-    },
     ensUniversalResolver: {
-      address: '0xce01f8eee7E479C928F8919abD53E553a36CeF67',
-      blockCreated: 19_258_213,
+      address: '0xeeeeeeee14d718c2b47d9923deab1335e144eeee',
+      blockCreated: 23_085_558,
     },
     multicall3: {
       address: '0xca11bde05977b3631167028862be2a173976ca11',

package/chains/definitions/mantraDuKongEVMTestnet.ts

@@ -0,0 +1,21 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+
+export const mantraDuKongEVMTestnet = /*#__PURE__*/ defineChain({
+  id: 5887,
+  name: 'MANTRA DuKong EVM Testnet',
+  nativeCurrency: {
+    decimals: 18,
+    name: 'OM',
+    symbol: 'OM',
+  },
+  rpcUrls: {
+    default: { http: ['https://evm.dukong.mantrachain.io'] },
+  },
+  blockExplorers: {
+    default: {
+      name: 'MANTRAScan',
+      url: 'https://mantrascan.io/dukong',
+    },
+  },
+  testnet: true,
+})

package/chains/definitions/megaethTestnet.ts

@@ -2,6 +2,7 @@ import { defineChain } from '../../utils/chain/defineChain.js'
 
 export const megaethTestnet = /*#__PURE__*/ defineChain({
   id: 6342,
+  blockTime: 1_000,
   name: 'MegaETH Testnet',
   nativeCurrency: {
     name: 'MegaETH Testnet Ether',

package/chains/definitions/monadTestnet.ts

@@ -3,6 +3,7 @@ import { defineChain } from '../../utils/chain/defineChain.js'
 export const monadTestnet = /*#__PURE__*/ defineChain({
   id: 10_143,
   name: 'Monad Testnet',
+  blockTime: 400,
   nativeCurrency: {
     name: 'Testnet MON Token',
     symbol: 'MON',

package/chains/definitions/sepolia.ts

@@ -21,10 +21,9 @@ export const sepolia = /*#__PURE__*/ defineChain({
       address: '0xca11bde05977b3631167028862be2a173976ca11',
       blockCreated: 751532,
     },
-    ensRegistry: { address: '0x00000000000C2E074eC69A0dFb2997BA6C7d2e1e' },
     ensUniversalResolver: {
-      address: '0xc8Af999e38273D658BE1b921b88A9Ddf005769cC',
-      blockCreated: 5_317_080,
+      address: '0xeeeeeeee14d718c2b47d9923deab1335e144eeee',
+      blockCreated: 8_928_790,
     },
   },
   testnet: true,

package/chains/definitions/sonic.ts

@@ -3,6 +3,7 @@ import { defineChain } from '../../utils/chain/defineChain.js'
 export const sonic = /*#__PURE__*/ defineChain({
   id: 146,
   name: 'Sonic',
+  blockTime: 630,
   nativeCurrency: {
     decimals: 18,
     name: 'Sonic',

package/chains/index.ts

@@ -335,6 +335,7 @@ export { mantaTestnet } from './definitions/mantaTestnet.js'
 export { mantle } from './definitions/mantle.js'
 export { mantleSepoliaTestnet } from './definitions/mantleSepoliaTestnet.js'
 export { mantleTestnet } from './definitions/mantleTestnet.js'
+export { mantraDuKongEVMTestnet } from './definitions/mantraDuKongEVMTestnet.js'
 export { mapProtocol } from './definitions/mapProtocol.js'
 export { matchain } from './definitions/matchain.js'
 export { matchainTestnet } from './definitions/matchainTestnet.js'