viem 2.41.2 → 2.42.1

package/account-abstraction/constants/address.ts

@@ -4,3 +4,5 @@ export const entryPoint07Address =
   '0x0000000071727De22E5E9d8BAf0edAc6f37da032' as const
 export const entryPoint08Address =
   '0x4337084D9E255Ff0702461CF8895CE9E3b5Ff108' as const
+export const entryPoint09Address =
+  '0x433709009B8330FDa32311DF1C2AFA402eD8D009' as const

package/account-abstraction/index.ts

@@ -122,11 +122,13 @@ export {
   entryPoint06Abi,
   entryPoint07Abi,
   entryPoint08Abi,
+  entryPoint09Abi,
 } from './constants/abis.js'
 export {
   entryPoint06Address,
   entryPoint07Address,
   entryPoint08Address,
+  entryPoint09Address,
 } from './constants/address.js'
 
 export {

package/account-abstraction/types/entryPointVersion.ts

@@ -1,7 +1,7 @@
 import type { SmartAccount } from '../accounts/types.js'
 
 /** @link https://github.com/eth-infinitism/account-abstraction/releases */
-export type EntryPointVersion = '0.6' | '0.7' | '0.8'
+export type EntryPointVersion = '0.6' | '0.7' | '0.8' | '0.9'
 
 export type DeriveEntryPointVersion<account extends SmartAccount | undefined> =
   account extends SmartAccount

package/account-abstraction/types/userOperation.ts

@@ -11,6 +11,15 @@ export type EstimateUserOperationGasReturnType<
   entryPointVersion extends EntryPointVersion = EntryPointVersion,
   uint256 = bigint,
 > = OneOf<
+  | (entryPointVersion extends '0.9'
+      ? {
+          preVerificationGas: uint256
+          verificationGasLimit: uint256
+          callGasLimit: uint256
+          paymasterVerificationGasLimit?: uint256 | undefined
+          paymasterPostOpGasLimit?: uint256 | undefined
+        }
+      : never)
   | (entryPointVersion extends '0.8'
       ? {
           preVerificationGas: uint256
@@ -79,6 +88,44 @@ export type UserOperation<
   uint256 = bigint,
   uint32 = number,
 > = OneOf<
+  | (entryPointVersion extends '0.9'
+      ? {
+          /** Authorization data. */
+          authorization?: SignedAuthorization<uint32> | undefined
+          /** The data to pass to the `sender` during the main execution call. */
+          callData: Hex
+          /** The amount of gas to allocate the main execution call */
+          callGasLimit: uint256
+          /** Account factory. Only for new accounts. */
+          factory?: Address | undefined
+          /** Data for account factory. */
+          factoryData?: Hex | undefined
+          /** Maximum fee per gas. */
+          maxFeePerGas: uint256
+          /** Maximum priority fee per gas. */
+          maxPriorityFeePerGas: uint256
+          /** Anti-replay parameter. */
+          nonce: uint256
+          /** Address of paymaster contract. */
+          paymaster?: Address | undefined
+          /** Data for paymaster. */
+          paymasterData?: Hex | undefined
+          /** The amount of gas to allocate for the paymaster post-operation code. */
+          paymasterPostOpGasLimit?: uint256 | undefined
+          /** Paymaster signature. Can be provided separately for parallelizable signing. */
+          paymasterSignature?: Hex | undefined
+          /** The amount of gas to allocate for the paymaster validation code. */
+          paymasterVerificationGasLimit?: uint256 | undefined
+          /** Extra gas to pay the Bundler. */
+          preVerificationGas: uint256
+          /** The account making the operation. */
+          sender: Address
+          /** Data passed into the account to verify authorization. */
+          signature: Hex
+          /** The amount of gas to allocate for the verification step. */
+          verificationGasLimit: uint256
+        }
+      : never)
   | (entryPointVersion extends '0.8'
       ? {
           /** Authorization data. */
@@ -186,6 +233,19 @@ export type UserOperationRequest<
   uint256 = bigint,
   uint32 = number,
 > = OneOf<
+  | (entryPointVersion extends '0.9'
+      ? UnionPartialBy<
+          UserOperation<'0.9', uint256, uint32>,
+          // We are able to calculate these via `prepareUserOperation`.
+          | keyof EstimateUserOperationGasReturnType<'0.9'>
+          | 'callData'
+          | 'maxFeePerGas'
+          | 'maxPriorityFeePerGas'
+          | 'nonce'
+          | 'sender'
+          | 'signature'
+        >
+      : never)
   | (entryPointVersion extends '0.8'
       ? UnionPartialBy<
           UserOperation<'0.8', uint256, uint32>,

package/account-abstraction/utils/formatters/userOperationRequest.ts

@@ -39,6 +39,8 @@ export function formatUserOperationRequest(
     rpcRequest.paymasterPostOpGasLimit = numberToHex(
       request.paymasterPostOpGasLimit,
     )
+  if (typeof request.paymasterSignature !== 'undefined')
+    rpcRequest.paymasterSignature = request.paymasterSignature
   if (typeof request.paymasterVerificationGasLimit !== 'undefined')
     rpcRequest.paymasterVerificationGasLimit = numberToHex(
       request.paymasterVerificationGasLimit,

package/account-abstraction/utils/userOperation/getUserOperationHash.ts

@@ -41,7 +41,7 @@ export function getUserOperationHash<
     verificationGasLimit,
   } = userOperation
 
-  if (entryPointVersion === '0.8')
+  if (entryPointVersion === '0.8' || entryPointVersion === '0.9')
     return hashTypedData(
       getUserOperationTypedData({
         chainId,

package/account-abstraction/utils/userOperation/getUserOperationTypedData.ts

@@ -7,7 +7,7 @@ import { toPackedUserOperation } from './toPackedUserOperation.js'
 export type GetUserOperationTypedDataParameters = {
   chainId: number
   entryPointAddress: Address
-  userOperation: UserOperation<'0.8'>
+  userOperation: UserOperation<'0.8'> | UserOperation<'0.9'>
 }
 
 export type GetUserOperationTypedDataReturnType = TypedDataDefinition<

package/account-abstraction/utils/userOperation/toPackedUserOperation.ts

@@ -18,11 +18,12 @@ export function toPackedUserOperation(
     paymaster,
     paymasterData,
     paymasterPostOpGasLimit,
+    paymasterSignature,
     paymasterVerificationGasLimit,
     sender,
     signature = '0x',
     verificationGasLimit,
-  } = userOperation
+  } = userOperation as UserOperation & { paymasterSignature?: string }
 
   const accountGasLimits = concat([
     pad(numberToHex(verificationGasLimit || 0n), { size: 16 }),
@@ -34,6 +35,8 @@ export function toPackedUserOperation(
     pad(numberToHex(maxFeePerGas || 0n), { size: 16 }),
   ])
   const nonce = userOperation.nonce ?? 0n
+
+  // For v0.9, paymasterSignature can be provided separately and appended after paymasterData
   const paymasterAndData = paymaster
     ? concat([
         paymaster,
@@ -44,6 +47,7 @@ export function toPackedUserOperation(
           size: 16,
         }),
         paymasterData || '0x',
+        ...(paymasterSignature ? [paymasterSignature as `0x${string}`] : []),
       ])
     : '0x'
   const preVerificationGas = userOperation.preVerificationGas ?? 0n

package/chains/definitions/giwaSepolia.ts

@@ -47,3 +47,13 @@ export const giwaSepolia = /*#__PURE__*/ defineChain({
   testnet: true,
   sourceId,
 })
+
+export const giwaSepoliaPreconf = defineChain({
+  ...giwaSepolia,
+  experimental_preconfirmationTime: 200,
+  rpcUrls: {
+    default: {
+      http: ['https://sepolia-rpc-flashblocks.giwa.io'],
+    },
+  },
+})

package/chains/definitions/henesys.ts

@@ -0,0 +1,18 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+
+export const henesys = /*#__PURE__*/ defineChain({
+  id: 68414,
+  name: 'Henesys',
+  nativeCurrency: { name: 'NEXPACE', symbol: 'NXPC', decimals: 18 },
+  rpcUrls: {
+    default: {
+      http: ['https://henesys-rpc.msu.io'],
+    },
+  },
+  blockExplorers: {
+    default: {
+      name: 'Avalanche Explorer',
+      url: 'https://subnets.avax.network/henesys',
+    },
+  },
+})

package/chains/definitions/polygon.ts

@@ -14,7 +14,7 @@ export const polygon = /*#__PURE__*/ defineChain({
     default: {
       name: 'PolygonScan',
       url: 'https://polygonscan.com',
-      apiUrl: 'https://api.polygonscan.com/api',
+      apiUrl: 'https://api.etherscan.io/v2/api',
     },
   },
   contracts: {

package/chains/definitions/polygonAmoy.ts

@@ -13,7 +13,7 @@ export const polygonAmoy = /*#__PURE__*/ defineChain({
     default: {
       name: 'PolygonScan',
       url: 'https://amoy.polygonscan.com',
-      apiUrl: 'https://api-amoy.polygonscan.com/api',
+      apiUrl: 'https://api.etherscan.io/v2/api',
     },
   },
   contracts: {

package/chains/definitions/stableTestnet.ts

@@ -0,0 +1,25 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+
+export const stableTestnet = /*#__PURE__*/ defineChain({
+  id: 2201,
+  name: 'Stable Testnet',
+  nativeCurrency: {
+    decimals: 18,
+    name: 'gUSDT',
+    symbol: 'gUSDT',
+  },
+  rpcUrls: {
+    default: {
+      http: ['https://rpc.testnet.stable.xyz'],
+      webSocket: ['wss://rpc.testnet.stable.xyz'],
+    },
+  },
+  blockExplorers: {
+    default: {
+      name: 'Stablescan',
+      url: 'https://testnet.stablescan.xyz',
+      apiUrl: 'https://testnet.stablescan.xyz/api',
+    },
+  },
+  testnet: true,
+})

package/chains/definitions/taiko.ts

@@ -16,14 +16,14 @@ export const taiko = /*#__PURE__*/ defineChain({
   },
   blockExplorers: {
     default: {
-      name: 'Taikoscan',
+      name: 'Etherscan',
       url: 'https://taikoscan.io',
-      apiUrl: 'https://api.taikoscan.io/api',
     },
   },
   contracts: {
     multicall3: {
-      address: '0xcb2436774C3e191c85056d248EF4260ce5f27A9D',
+      address: '0xcA11bde05977b3631167028862bE2a173976CA11',
+      blockCreated: 11269,
     },
   },
 })

package/chains/definitions/taikoHoodi.ts

@@ -0,0 +1,26 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+
+export const taikoHoodi = /*#__PURE__*/ defineChain({
+  id: 167_013,
+  name: 'Taiko Hoodi',
+  nativeCurrency: { name: 'Ether', symbol: 'ETH', decimals: 18 },
+  rpcUrls: {
+    default: {
+      http: ['https://rpc.hoodi.taiko.xyz'],
+      webSocket: ['wss://ws.hoodi.taiko.xyz'],
+    },
+  },
+  blockExplorers: {
+    default: {
+      name: 'Etherscan',
+      url: 'https://hoodi.taikoscan.io/',
+    },
+  },
+  contracts: {
+    multicall3: {
+      address: '0xcA11bde05977b3631167028862bE2a173976CA11',
+      blockCreated: 581116,
+    },
+  },
+  testnet: true,
+})

package/chains/definitions/xrplevm.ts

@@ -0,0 +1,22 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+
+export const xrplevm = /*#__PURE__*/ defineChain({
+  id: 1440000,
+  name: 'XRPL EVM',
+  nativeCurrency: {
+    name: 'XRP',
+    symbol: 'XRP',
+    decimals: 18,
+  },
+  rpcUrls: {
+    default: { http: ['https://rpc.xrplevm.org'] },
+  },
+  blockExplorers: {
+    default: {
+      name: 'blockscout',
+      url: 'https://explorer.xrplevm.org',
+      apiUrl: 'https://explorer.xrplevm.org/api/v2',
+    },
+  },
+  testnet: false,
+})

package/chains/index.ts

@@ -227,7 +227,7 @@ export { garnet } from './definitions/garnet.js'
 export { gatechain } from './definitions/gatechain.js'
 export { geist } from './definitions/geist.js'
 export { genesys } from './definitions/genesys.js'
-export { giwaSepolia } from './definitions/giwaSepolia.js'
+export { giwaSepolia, giwaSepoliaPreconf } from './definitions/giwaSepolia.js'
 export { glideL1Protocol } from './definitions/glideL1Protocol.js'
 export { glideL2Protocol } from './definitions/glideL2Protocol.js'
 export { gnosis } from './definitions/gnosis.js'
@@ -259,6 +259,7 @@ export { hela } from './definitions/hela.js'
 export { heliosTestnet } from './definitions/heliosTestnet.js'
 export { hemi } from './definitions/hemi.js'
 export { hemiSepolia } from './definitions/hemiSepolia.js'
+export { henesys } from './definitions/henesys.js'
 export { holesky } from './definitions/holesky.js'
 export { hoodi } from './definitions/hoodi.js'
 export { hpb } from './definitions/hpb.js'
@@ -562,6 +563,7 @@ export { sophonTestnet } from './definitions/sophonTestnet.js'
 export { sova } from './definitions/sova.js'
 export { sovaSepolia } from './definitions/sovaSepolia.js'
 export { spicy } from './definitions/spicy.js'
+export { stableTestnet } from './definitions/stableTestnet.js'
 export {
   statusSepolia,
   statusSepolia as statusNetworkSepolia,
@@ -590,9 +592,14 @@ export { syscoinTestnet } from './definitions/syscoinTestnet.js'
 export { tac } from './definitions/tac.js'
 export { tacSPB } from './definitions/tacSPB.js'
 export { taiko } from './definitions/taiko.js'
+/** @deprecated Use `taikoHoodi` instead. */
 export { taikoHekla } from './definitions/taikoHekla.js'
+export { taikoHoodi } from './definitions/taikoHoodi.js'
+/** @deprecated Use `taikoHoodi` instead. */
 export { taikoJolnir } from './definitions/taikoJolnir.js'
+/** @deprecated Use `taikoHoodi` instead. */
 export { taikoKatla } from './definitions/taikoKatla.js'
+/** @deprecated Use `taikoHoodi` instead. */
 export { taikoTestnetSepolia } from './definitions/taikoTestnetSepolia.js'
 export { taraxa } from './definitions/taraxa.js'
 export { taraxaTestnet } from './definitions/taraxaTestnet.js'
@@ -663,6 +670,7 @@ export { xoneTestnet } from './definitions/xoneTestnet.js'
 export { xphereMainnet } from './definitions/xphereMainnet.js'
 export { xphereTestnet } from './definitions/xphereTestnet.js'
 export { xrOne } from './definitions/xrOne.js'
+export { xrplevm } from './definitions/xrplevm.js'
 export { xrplevmDevnet } from './definitions/xrplevmDevnet.js'
 export { xrplevmTestnet } from './definitions/xrplevmTestnet.js'
 export { xrSepolia } from './definitions/xrSepolia.js'

package/constants/address.ts

@@ -1,10 +1,3 @@
-export const entryPoint06Address =
-  '0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789' as const
-export const entryPoint07Address =
-  '0x0000000071727De22E5E9d8BAf0edAc6f37da032' as const
-export const entryPoint08Address =
-  '0x4337084D9E255Ff0702461CF8895CE9E3b5Ff108' as const
-
 export const ethAddress = '0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee' as const
 
 export const zeroAddress = '0x0000000000000000000000000000000000000000' as const

package/errors/version.ts

@@ -1 +1 @@
-export const version = '2.41.2'
+export const version = '2.42.1'

package/package.json

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

package/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../tsconfig.base.json",
+  "include": ["./**/*.ts"],
+  "exclude": ["./**/*.test.ts", "./**/*.test-d.ts", "./**/*.bench.ts", "./**/*.bench-d.ts"],
+  "compilerOptions": {
+    "composite": true,
+    "noEmit": true,
+    "baseUrl": ".",
+  }
+}

package/types/log.ts

@@ -31,6 +31,8 @@ export type Log<
   blockHash: pending extends true ? null : Hash
   /** Number of block containing this log or `null` if pending */
   blockNumber: pending extends true ? null : quantity
+  /** Timestamp of block containing this log or `null` if pending */
+  blockTimestamp?: (pending extends true ? null : quantity) | undefined
   /** Contains the non-indexed arguments of the log */
   data: Hex
   /** Index of this log within its block or `null` if pending */

package/utils/abi/parseEventLogs.ts

@@ -1,11 +1,6 @@
 // TODO(v3): checksum address.
 
 import type { Abi, AbiEvent, AbiEventParameter, Address } from 'abitype'
-import {
-  AbiEventSignatureNotFoundError,
-  DecodeLogDataMismatch,
-  DecodeLogTopicsMismatch,
-} from '../../errors/abi.js'
 import type { ErrorType } from '../../errors/utils.js'
 import type { ContractEventName, GetEventArgs } from '../../types/contract.js'
 import type { Log } from '../../types/log.js'
@@ -115,52 +110,74 @@ export function parseEventLogs<
 
   return logs
     .map((log) => {
-      try {
-        const abiItem = (abi as Abi).find(
-          (abiItem) =>
-            abiItem.type === 'event' &&
-            log.topics[0] === toEventSelector(abiItem),
-        ) as AbiEvent
-        if (!abiItem) return null
-
-        const event = decodeEventLog({
-          ...log,
-          abi: [abiItem],
-          strict,
-        })
-
-        // Check that the decoded event name matches the provided event name.
-        if (eventName && !eventName.includes(event.eventName)) return null
-
-        // Check that the decoded event args match the provided args.
-        if (
-          !includesArgs({
-            args: event.args,
-            inputs: abiItem.inputs,
-            matchArgs: args,
+      // Find all matching ABI items with the same selector.
+      // Multiple events can share the same selector but differ in indexed parameters
+      // (e.g., ERC20 vs ERC721 Transfer events).
+      const abiItems = (abi as Abi).filter(
+        (abiItem) =>
+          abiItem.type === 'event' &&
+          log.topics[0] === toEventSelector(abiItem),
+      ) as AbiEvent[]
+      if (abiItems.length === 0) return null
+
+      // Try each matching ABI item until one successfully decodes.
+      let event: { eventName: string; args: unknown } | undefined
+      let abiItem: AbiEvent | undefined
+
+      for (const item of abiItems) {
+        try {
+          event = decodeEventLog({
+            ...log,
+            abi: [item],
+            strict: true,
           })
-        )
-          return null
-
-        return { ...event, ...log }
-      } catch (err) {
-        let eventName: string | undefined
-        let isUnnamed: boolean | undefined
-
-        if (err instanceof AbiEventSignatureNotFoundError) return null
-        if (
-          err instanceof DecodeLogDataMismatch ||
-          err instanceof DecodeLogTopicsMismatch
-        ) {
-          // If strict mode is on, and log data/topics do not match event definition, skip.
-          if (strict) return null
-          eventName = err.abiItem.name
-          isUnnamed = err.abiItem.inputs?.some((x) => !('name' in x && x.name))
+          abiItem = item
+          break
+        } catch {
+          // Try next ABI item
         }
+      }
 
-        // Set args to empty if there is an error decoding (e.g. indexed/non-indexed params mismatch).
-        return { ...log, args: isUnnamed ? [] : {}, eventName }
+      // If strict decoding failed for all, and we're in non-strict mode,
+      // fall back to the first matching ABI item.
+      if (!event && !strict) {
+        abiItem = abiItems[0]
+        try {
+          event = decodeEventLog({
+            ...log,
+            abi: [abiItem],
+            strict: false,
+          })
+        } catch {
+          // If decoding still fails, return partial log in non-strict mode.
+          const isUnnamed = abiItem.inputs?.some(
+            (x) => !('name' in x && x.name),
+          )
+          return {
+            ...log,
+            args: isUnnamed ? [] : {},
+            eventName: abiItem.name,
+          }
+        }
       }
+
+      // If no event was found, return null.
+      if (!event || !abiItem) return null
+
+      // Check that the decoded event name matches the provided event name.
+      if (eventName && !eventName.includes(event.eventName)) return null
+
+      // Check that the decoded event args match the provided args.
+      if (
+        !includesArgs({
+          args: event.args,
+          inputs: abiItem.inputs,
+          matchArgs: args,
+        })
+      )
+        return null
+
+      return { ...event, ...log }
     })
     .filter(Boolean) as unknown as ParseEventLogsReturnType<
     abi,

package/utils/cursor.ts

@@ -233,7 +233,7 @@ export function createCursor(
   const cursor: Cursor = Object.create(staticCursor)
   cursor.bytes = bytes
   cursor.dataView = new DataView(
-    bytes.buffer,
+    bytes.buffer ?? bytes,
     bytes.byteOffset,
     bytes.byteLength,
   )

package/utils/formatters/log.ts

@@ -16,6 +16,11 @@ export function formatLog(
     ...log,
     blockHash: log.blockHash ? log.blockHash : null,
     blockNumber: log.blockNumber ? BigInt(log.blockNumber) : null,
+    blockTimestamp: log.blockTimestamp
+      ? BigInt(log.blockTimestamp)
+      : log.blockTimestamp === null
+        ? null
+        : undefined,
     logIndex: log.logIndex ? Number(log.logIndex) : null,
     transactionHash: log.transactionHash ? log.transactionHash : null,
     transactionIndex: log.transactionIndex

package/utils/rpc/socket.ts

@@ -247,13 +247,14 @@ export async function getSocketRpcClient<socket extends {}>(
                 body,
               })
 
-            // If we are unsubscribing from a topic, we want to remove the listener.
-            if (body.method === 'eth_unsubscribe')
-              subscriptions.delete(body.params?.[0])
-
             onResponse(response)
           }
 
+          // If we are unsubscribing from a topic, remove the listener immediately
+          // to prevent it from being re-subscribed on reconnect.
+          if (body.method === 'eth_unsubscribe')
+            subscriptions.delete(body.params?.[0])
+
           requests.set(id, { onResponse: callback, onError })
           try {
             socket.request({