viem 2.55.0 → 2.55.1

package/actions/public/verifyHash.ts

@@ -19,8 +19,9 @@ import {
 } from '../../errors/contract.js'
 import type { InvalidHexBooleanError } from '../../errors/encoding.js'
 import type { ErrorType } from '../../errors/utils.js'
+import type { BlockTag } from '../../types/block.js'
 import type { Chain } from '../../types/chain.js'
-import type { ByteArray, Hex, Signature } from '../../types/misc.js'
+import type { ByteArray, Hash, Hex, Signature } from '../../types/misc.js'
 import type { OneOf } from '../../types/utils.js'
 import {
   type EncodeDeployDataErrorType,
@@ -61,10 +62,27 @@ import { type CallErrorType, type CallParameters, call } from './call.js'
 import { type GetCodeErrorType, getCode } from './getCode.js'
 import { type ReadContractErrorType, readContract } from './readContract.js'
 
-export type VerifyHashParameters = Pick<
-  CallParameters,
-  'blockNumber' | 'blockTag'
-> & {
+export type BlockParameters = OneOf<
+  | {
+      /** The block number to check if the contract was already deployed. */
+      blockNumber?: bigint | undefined
+    }
+  | {
+      /**
+       * The block tag to check if the contract was already deployed.
+       * @default 'latest'
+       */
+      blockTag?: BlockTag | undefined
+    }
+  | {
+      /** The block hash to check if the contract was already deployed. Implements [EIP-1898](https://eips.ethereum.org/EIPS/eip-1898). */
+      blockHash: Hash
+      /** Whether or not to require the block to be in the canonical chain. Only allowed in conjunction with `blockHash`. */
+      requireCanonical?: boolean | undefined
+    }
+>
+
+export type VerifyHashParameters = BlockParameters & {
   /** The address that signed the original message. */
   address: Address
   /** The chain to use. */
@@ -184,7 +202,15 @@ export async function verifyErc8010(
   client: Client,
   parameters: verifyErc8010.Parameters,
 ) {
-  const { address, blockNumber, blockTag, hash, multicallAddress } = parameters
+  const {
+    address,
+    blockHash,
+    blockNumber,
+    blockTag,
+    hash,
+    multicallAddress,
+    requireCanonical,
+  } = parameters
 
   const {
     authorization: authorization_ox,
@@ -196,17 +222,16 @@ export async function verifyErc8010(
   // Check if already delegated
   const code = await getCode(client, {
     address,
+    blockHash,
     blockNumber,
     blockTag,
+    requireCanonical,
   } as never)
 
   // If already delegated, perform standard ERC-1271 verification.
   if (code === concatHex(['0xef0100', authorization_ox.address]))
     return await verifyErc1271(client, {
-      address,
-      blockNumber,
-      blockTag,
-      hash,
+      ...parameters,
       signature,
     })
 
@@ -236,9 +261,11 @@ export async function verifyErc8010(
       : { code: multicall3Bytecode }),
     authorizationList: [authorization],
     abi: multicall3Abi,
+    blockHash,
     blockNumber,
     blockTag: 'pending',
     functionName: 'aggregate3',
+    requireCanonical,
     args: [
       [
         ...(initData
@@ -270,7 +297,7 @@ export async function verifyErc8010(
 }
 
 export namespace verifyErc8010 {
-  export type Parameters = Pick<CallParameters, 'blockNumber' | 'blockTag'> & {
+  export type Parameters = BlockParameters & {
     /** The address that signed the original message. */
     address: Address
     /** The hash to be verified. */
@@ -348,7 +375,7 @@ async function verifyErc6492(
 }
 
 export namespace verifyErc6492 {
-  export type Parameters = Pick<CallParameters, 'blockNumber' | 'blockTag'> & {
+  export type Parameters = BlockParameters & {
     /** The address that signed the original message. */
     address: Address
     /** The hash to be verified. */
@@ -365,7 +392,15 @@ export async function verifyErc1271(
   client: Client,
   parameters: verifyErc1271.Parameters,
 ) {
-  const { address, blockNumber, blockTag, hash, signature } = parameters
+  const {
+    address,
+    blockHash,
+    blockNumber,
+    blockTag,
+    hash,
+    requireCanonical,
+    signature,
+  } = parameters
 
   const result = await getAction(
     client,
@@ -375,9 +410,11 @@ export async function verifyErc1271(
     address,
     abi: erc1271Abi,
     args: [hash, signature],
+    blockHash,
     blockNumber,
     blockTag,
     functionName: 'isValidSignature',
+    requireCanonical,
   }).catch((error) => {
     if (error instanceof ContractFunctionExecutionError)
       throw new VerificationError()
@@ -389,7 +426,7 @@ export async function verifyErc1271(
 }
 
 export namespace verifyErc1271 {
-  export type Parameters = Pick<CallParameters, 'blockNumber' | 'blockTag'> & {
+  export type Parameters = BlockParameters & {
     /** The address that signed the original message. */
     address: Address
     /** The hash to be verified. */

package/actions/public/verifyMessage.ts

@@ -15,13 +15,17 @@ import { getAction } from '../../utils/getAction.js'
 import type { HashMessageErrorType } from '../../utils/signature/hashMessage.js'
 import { hashMessage } from '../../utils/signature/hashMessage.js'
 import {
+  type BlockParameters,
   type VerifyHashErrorType,
   type VerifyHashParameters,
   verifyHash,
 } from './verifyHash.js'
 
 export type VerifyMessageParameters = Prettify<
-  Omit<VerifyHashParameters, 'hash'> & {
+  Omit<
+    VerifyHashParameters,
+    'blockHash' | 'blockNumber' | 'blockTag' | 'hash' | 'requireCanonical'
+  > & {
     /** The address that signed the original message. */
     address: Address
     /** The message to be verified. */
@@ -29,7 +33,8 @@ export type VerifyMessageParameters = Prettify<
     /** The signature that was generated by signing the message with the address's private key. */
     signature: Hex | ByteArray | Signature
   }
->
+> &
+  BlockParameters
 
 export type VerifyMessageReturnType = boolean
 

package/actions/public/verifyTypedData.ts

@@ -12,6 +12,7 @@ import {
   hashTypedData,
 } from '../../utils/signature/hashTypedData.js'
 import {
+  type BlockParameters,
   type VerifyHashErrorType,
   type VerifyHashParameters,
   verifyHash,
@@ -20,7 +21,11 @@ import {
 export type VerifyTypedDataParameters<
   typedData extends TypedData | Record<string, unknown> = TypedData,
   primaryType extends keyof typedData | 'EIP712Domain' = keyof typedData,
-> = Omit<VerifyHashParameters, 'hash'> &
+> = Omit<
+  VerifyHashParameters,
+  'blockHash' | 'blockNumber' | 'blockTag' | 'hash' | 'requireCanonical'
+> &
+  BlockParameters &
   TypedDataDefinition<typedData, primaryType> & {
     /** The address to verify the typed data for. */
     address: Address

package/actions/public/waitForTransactionReceipt.ts

@@ -55,7 +55,7 @@ export type WaitForTransactionReceiptParameters<
 > = {
   /**
    * Whether to check for transaction replacements.
-   * @default true
+   * @default `client.chain?.supportsTransactionReplacementDetection ?? true`
    */
   checkReplacement?: boolean | undefined
   /**
@@ -143,7 +143,8 @@ export async function waitForTransactionReceipt<
   parameters: WaitForTransactionReceiptParameters<chain>,
 ): Promise<WaitForTransactionReceiptReturnType<chain>> {
   const {
-    checkReplacement = true,
+    checkReplacement = client.chain?.supportsTransactionReplacementDetection ??
+      true,
     confirmations = 1,
     hash,
     onReplaced,

package/actions/siwe/verifySiweMessage.ts

@@ -12,27 +12,27 @@ import {
   validateSiweMessage,
 } from '../../utils/siwe/validateSiweMessage.js'
 import {
+  type BlockParameters,
   type VerifyHashErrorType,
-  type VerifyHashParameters,
   verifyHash,
 } from '../public/verifyHash.js'
 
 export type VerifySiweMessageParameters = Prettify<
-  Pick<VerifyHashParameters, 'blockNumber' | 'blockTag'> &
-    Pick<
-      ValidateSiweMessageParameters,
-      'address' | 'domain' | 'nonce' | 'scheme' | 'time'
-    > & {
-      /**
-       * EIP-4361 formatted message.
-       */
-      message: string
-      /**
-       * Signature to check against.
-       */
-      signature: Hex
-    }
->
+  Pick<
+    ValidateSiweMessageParameters,
+    'address' | 'domain' | 'nonce' | 'scheme' | 'time'
+  > & {
+    /**
+     * EIP-4361 formatted message.
+     */
+    message: string
+    /**
+     * Signature to check against.
+     */
+    signature: Hex
+  }
+> &
+  BlockParameters
 
 export type VerifySiweMessageReturnType = boolean
 

package/errors/version.ts

@@ -1 +1 @@
-export const version = '2.55.0'
+export const version = '2.55.1'

package/package.json

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

package/tempo/Decorator.ts

@@ -4890,6 +4890,22 @@ type DecoratorBase<
     encryptedDepositSync: (
       parameters: zoneActions.encryptedDepositSync.Parameters<chain, account>,
     ) => Promise<zoneActions.encryptedDepositSync.ReturnValue>
+    /**
+     * Gets the active sequencer encryption key for a zone.
+     *
+     * @example
+     * ```ts
+     * const { keyIndex, publicKey } = await client.zone.getEncryptionKey({
+     *   zoneId: 7,
+     * })
+     * ```
+     *
+     * @param parameters - Parameters.
+     * @returns The active encryption key and its zero-based index.
+     */
+    getEncryptionKey: (
+      parameters: zoneActions.getEncryptionKey.Parameters,
+    ) => Promise<zoneActions.getEncryptionKey.ReturnValue>
     /**
      * Returns the authenticated account address and authorization token expiry.
      *
@@ -4935,6 +4951,22 @@ type DecoratorBase<
     getDepositStatus: (
       parameters: zoneActions.getDepositStatus.Parameters,
     ) => Promise<zoneActions.getDepositStatus.ReturnType>
+    /**
+     * Waits for a Tempo block's deposits to be processed by a zone.
+     *
+     * @example
+     * ```ts
+     * const status = await client.zone.waitForDepositStatus({
+     *   tempoBlockNumber: 1n,
+     * })
+     * ```
+     *
+     * @param parameters - Parameters.
+     * @returns The processed deposit status.
+     */
+    waitForDepositStatus: (
+      parameters: zoneActions.waitForDepositStatus.Parameters,
+    ) => Promise<zoneActions.waitForDepositStatus.ReturnType>
     /**
      * Returns the withdrawal fee for a given gas limit.
      *
@@ -5470,6 +5502,7 @@ export function decorator() {
         'encryptedDepositSync',
         'getAuthorizationTokenInfo',
         'getDepositStatus',
+        'getEncryptionKey',
         'getWithdrawalFee',
         'getZoneInfo',
         'requestWithdrawal',
@@ -5477,6 +5510,7 @@ export function decorator() {
         'requestVerifiableWithdrawal',
         'requestVerifiableWithdrawalSync',
         'signAuthorizationToken',
+        'waitForDepositStatus',
       ]),
     } as Decorator<chain, account>
   }