viem 2.7.9 → 2.7.10

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "viem",
   "description": "TypeScript Interface for Ethereum",
-  "version": "2.7.9",
+  "version": "2.7.10",
   "main": "./_cjs/index.js",
   "module": "./_esm/index.js",
   "types": "./_types/index.d.ts",

package/utils/abi/getAbiItem.ts

@@ -155,7 +155,7 @@ export function isArgOfType(arg: unknown, abiParameter: AbiParameter): boolean {
   const abiParameterType = abiParameter.type
   switch (abiParameterType) {
     case 'address':
-      return isAddress(arg as Address)
+      return isAddress(arg as Address, { strict: false })
     case 'bool':
       return argType === 'boolean'
     case 'function':
@@ -233,9 +233,9 @@ export function getAmbiguousTypes(
     const ambiguous = (() => {
       if (types.includes('address') && types.includes('bytes20')) return true
       if (types.includes('address') && types.includes('string'))
-        return isAddress(args[parameterIndex] as Address)
+        return isAddress(args[parameterIndex] as Address, { strict: false })
       if (types.includes('address') && types.includes('bytes'))
-        return isAddress(args[parameterIndex] as Address)
+        return isAddress(args[parameterIndex] as Address, { strict: false })
       return false
     })()
 

package/utils/address/isAddress.ts

@@ -1,10 +1,35 @@
 import type { Address } from 'abitype'
 import type { ErrorType } from '../../errors/utils.js'
+import { LruMap } from '../lru.js'
+import { checksumAddress } from './getAddress.js'
 
 const addressRegex = /^0x[a-fA-F0-9]{40}$/
 
+const isAddressCache = /*#__PURE__*/ new LruMap<boolean>(8192)
+
+export type IsAddressOptions = {
+  /**
+   * Enables strict mode. Whether or not to compare the address against its checksum.
+   *
+   * @default true
+   */
+  strict?: boolean
+}
+
 export type IsAddressErrorType = ErrorType
 
-export function isAddress(address: string): address is Address {
-  return addressRegex.test(address)
+export function isAddress(
+  address: string,
+  { strict = true }: IsAddressOptions = {},
+): address is Address {
+  if (isAddressCache.has(address)) return isAddressCache.get(address)!
+
+  const result = (() => {
+    if (!addressRegex.test(address)) return false
+    if (address.toLowerCase() === address) return true
+    if (strict) return checksumAddress(address as Address) === address
+    return true
+  })()
+  isAddressCache.set(address, result)
+  return result
 }

package/utils/address/isAddressEqual.ts

@@ -11,7 +11,9 @@ export type IsAddressEqualReturnType = boolean
 export type IsAddressEqualErrorType = InvalidAddressErrorType | ErrorType
 
 export function isAddressEqual(a: Address, b: Address) {
-  if (!isAddress(a)) throw new InvalidAddressError({ address: a })
-  if (!isAddress(b)) throw new InvalidAddressError({ address: b })
+  if (!isAddress(a, { strict: false }))
+    throw new InvalidAddressError({ address: a })
+  if (!isAddress(b, { strict: false }))
+    throw new InvalidAddressError({ address: b })
   return a.toLowerCase() === b.toLowerCase()
 }

package/utils/lru.ts

@@ -0,0 +1,20 @@
+/**
+ * Map with a LRU (Least recently used) policy.
+ *
+ * @link https://en.wikipedia.org/wiki/Cache_replacement_policies#LRU
+ */
+export class LruMap<value = unknown> extends Map<string, value> {
+  maxSize: number
+
+  constructor(size: number) {
+    super()
+    this.maxSize = size
+  }
+
+  override set(key: string, value: value) {
+    super.set(key, value)
+    if (this.maxSize && this.size > this.maxSize)
+      this.delete(this.keys().next().value)
+    return this
+  }
+}

package/utils/transaction/parseTransaction.ts

@@ -326,7 +326,8 @@ export function parseAccessList(accessList_: RecursiveArray<Hex>): AccessList {
   for (let i = 0; i < accessList_.length; i++) {
     const [address, storageKeys] = accessList_[i] as [Hex, Hex[]]
 
-    if (!isAddress(address)) throw new InvalidAddressError({ address })
+    if (!isAddress(address, { strict: false }))
+      throw new InvalidAddressError({ address })
 
     accessList.push({
       address: address,

package/utils/transaction/serializeAccessList.ts

@@ -42,7 +42,7 @@ export function serializeAccessList(
       }
     }
 
-    if (!isAddress(address)) {
+    if (!isAddress(address, { strict: false })) {
       throw new InvalidAddressError({ address })
     }