viem 2.9.26 → 2.9.28

package/_types/utils/signature/verifyTypedData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verifyTypedData.d.ts","sourceRoot":"","sources":["../../../utils/signature/verifyTypedData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AACnE,OAAO,EAAE,KAAK,mBAAmB,EAAc,MAAM,0BAA0B,CAAA;AAC/E,OAAO,EACL,KAAK,uBAAuB,EAE7B,MAAM,8BAA8B,CAAA;AAErC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EACL,KAAK,iCAAiC,EAEvC,MAAM,8BAA8B,CAAA;AAErC,MAAM,MAAM,yBAAyB,CACnC,SAAS,SAAS,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EACjE,WAAW,SAAS,MAAM,SAAS,GAAG,cAAc,GAAG,MAAM,SAAS,IACpE,mBAAmB,CAAC,SAAS,EAAE,WAAW,CAAC,GAAG;IAChD,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAA;IAChB,8BAA8B;IAC9B,SAAS,EAAE,GAAG,GAAG,SAAS,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAAA;AAE/C,MAAM,MAAM,wBAAwB,GAChC,uBAAuB,GACvB,mBAAmB,GACnB,iCAAiC,GACjC,SAAS,CAAA;AAEb;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CACnC,KAAK,CAAC,SAAS,SAAS,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3D,WAAW,SAAS,MAAM,SAAS,GAAG,cAAc,EAEpD,UAAU,EAAE,yBAAyB,CAAC,SAAS,EAAE,WAAW,CAAC,GAC5D,OAAO,CAAC,yBAAyB,CAAC,CAapC"}
+{"version":3,"file":"verifyTypedData.d.ts","sourceRoot":"","sources":["../../../utils/signature/verifyTypedData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AACnE,OAAO,EAAE,KAAK,mBAAmB,EAAc,MAAM,0BAA0B,CAAA;AAC/E,OAAO,EACL,KAAK,uBAAuB,EAE7B,MAAM,8BAA8B,CAAA;AAErC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EACL,KAAK,iCAAiC,EAEvC,MAAM,8BAA8B,CAAA;AAErC,MAAM,MAAM,yBAAyB,CACnC,SAAS,SAAS,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EACjE,WAAW,SAAS,MAAM,SAAS,GAAG,cAAc,GAAG,MAAM,SAAS,IACpE,mBAAmB,CAAC,SAAS,EAAE,WAAW,CAAC,GAAG;IAChD,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAA;IAChB,8BAA8B;IAC9B,SAAS,EAAE,GAAG,GAAG,SAAS,GAAG,SAAS,CAAA;CACvC,CAAA;AAED,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAAA;AAE/C,MAAM,MAAM,wBAAwB,GAChC,uBAAuB,GACvB,mBAAmB,GACnB,iCAAiC,GACjC,SAAS,CAAA;AAEb;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CACnC,KAAK,CAAC,SAAS,SAAS,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3D,WAAW,SAAS,MAAM,SAAS,GAAG,cAAc,EAEpD,UAAU,EAAE,yBAAyB,CAAC,SAAS,EAAE,WAAW,CAAC,GAC5D,OAAO,CAAC,yBAAyB,CAAC,CAapC"}

package/_types/zksync/utils/assertEip712Request.d.ts

@@ -1,6 +1,6 @@
 import type { ErrorType } from '../../errors/utils.js';
-import { type AssertRequestErrorType } from '../../index.js';
 import type { ExactPartial } from '../../types/utils.js';
+import { type AssertRequestErrorType } from '../../utils/transaction/assertRequest.js';
 import type { zkSync } from '../../zksync/chains.js';
 import type { SendTransactionParameters } from '../actions/sendTransaction.js';
 export type AssertEip712RequestParameters = ExactPartial<SendTransactionParameters<typeof zkSync>>;

package/_types/zksync/utils/assertEip712Request.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assertEip712Request.d.ts","sourceRoot":"","sources":["../../../zksync/utils/assertEip712Request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAE,KAAK,sBAAsB,EAAiB,MAAM,gBAAgB,CAAA;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AACpD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAA;AAI9E,MAAM,MAAM,6BAA6B,GAAG,YAAY,CACtD,yBAAyB,CAAC,OAAO,MAAM,CAAC,CACzC,CAAA;AAED,MAAM,MAAM,4BAA4B,GAAG,sBAAsB,GAAG,SAAS,CAAA;AAE7E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,6BAA6B,QAItE"}
+{"version":3,"file":"assertEip712Request.d.ts","sourceRoot":"","sources":["../../../zksync/utils/assertEip712Request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,EACL,KAAK,sBAAsB,EAE5B,MAAM,0CAA0C,CAAA;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AACpD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAA;AAI9E,MAAM,MAAM,6BAA6B,GAAG,YAAY,CACtD,yBAAyB,CAAC,OAAO,MAAM,CAAC,CACzC,CAAA;AAED,MAAM,MAAM,4BAA4B,GAAG,sBAAsB,GAAG,SAAS,CAAA;AAE7E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,6BAA6B,QAItE"}

package/actions/public/verifyHash.ts

@@ -7,16 +7,19 @@ import { universalSignatureValidatorByteCode } from '../../constants/contracts.j
 import { CallExecutionError } from '../../errors/contract.js'
 import type { ErrorType } from '../../errors/utils.js'
 import type { Chain } from '../../types/chain.js'
-import type { ByteArray, Hex } from '../../types/misc.js'
-import type { EncodeDeployDataErrorType } from '../../utils/abi/encodeDeployData.js'
+import type { ByteArray, Hex, Signature } from '../../types/misc.js'
+import {
+  type EncodeDeployDataErrorType,
+  encodeDeployData,
+} from '../../utils/abi/encodeDeployData.js'
 import {
   type IsBytesEqualErrorType,
   isBytesEqual,
 } from '../../utils/data/isBytesEqual.js'
-import type { IsHexErrorType } from '../../utils/data/isHex.js'
-import type { ToHexErrorType } from '../../utils/encoding/toHex.js'
+import { type IsHexErrorType, isHex } from '../../utils/data/isHex.js'
+import { type ToHexErrorType, bytesToHex } from '../../utils/encoding/toHex.js'
 import { getAction } from '../../utils/getAction.js'
-import { encodeDeployData, isHex, toHex } from '../../utils/index.js'
+import { signatureToHex } from '../../utils/signature/signatureToHex.js'
 import { type CallErrorType, type CallParameters, call } from './call.js'
 
 export type VerifyHashParameters = Pick<
@@ -28,7 +31,7 @@ export type VerifyHashParameters = Pick<
   /** The hash to be verified. */
   hash: Hex
   /** The signature that was generated by signing the message with the address's private key. */
-  signature: Hex | ByteArray
+  signature: Hex | ByteArray | Signature
 }
 
 export type VerifyHashReturnType = boolean
@@ -52,7 +55,12 @@ export async function verifyHash<TChain extends Chain | undefined>(
   client: Client<Transport, TChain>,
   { address, hash, signature, ...callRequest }: VerifyHashParameters,
 ): Promise<VerifyHashReturnType> {
-  const signatureHex = isHex(signature) ? signature : toHex(signature)
+  const signatureHex = (() => {
+    if (isHex(signature)) return signature
+    if (typeof signature === 'object' && 'r' in signature && 's' in signature)
+      return signatureToHex(signature)
+    return bytesToHex(signature)
+  })()
 
   try {
     const { data } = await getAction(

package/actions/public/verifyMessage.ts

@@ -4,8 +4,13 @@ import type { Client } from '../../clients/createClient.js'
 import type { Transport } from '../../clients/transports/createTransport.js'
 import type { ErrorType } from '../../errors/utils.js'
 import type { Chain } from '../../types/chain.js'
-import type { ByteArray, Hex, SignableMessage } from '../../types/misc.js'
-import { hashMessage } from '../../utils/index.js'
+import type {
+  ByteArray,
+  Hex,
+  SignableMessage,
+  Signature,
+} from '../../types/misc.js'
+import { hashMessage } from '../../utils/signature/hashMessage.js'
 import type { HashMessageErrorType } from '../../utils/signature/hashMessage.js'
 import {
   type VerifyHashErrorType,
@@ -19,7 +24,7 @@ export type VerifyMessageParameters = Omit<VerifyHashParameters, 'hash'> & {
   /** The message to be verified. */
   message: SignableMessage
   /** The signature that was generated by signing the message with the address's private key. */
-  signature: Hex | ByteArray
+  signature: Hex | ByteArray | Signature
 }
 
 export type VerifyMessageReturnType = boolean

package/actions/public/verifyTypedData.ts

@@ -4,7 +4,7 @@ import type { Client } from '../../clients/createClient.js'
 import type { Transport } from '../../clients/transports/createTransport.js'
 import type { ErrorType } from '../../errors/utils.js'
 import type { Chain } from '../../types/chain.js'
-import type { ByteArray, Hex } from '../../types/misc.js'
+import type { ByteArray, Hex, Signature } from '../../types/misc.js'
 import type { TypedDataDefinition } from '../../types/typedData.js'
 import {
   type HashTypedDataErrorType,
@@ -24,7 +24,7 @@ export type VerifyTypedDataParameters<
     /** The address to verify the typed data for. */
     address: Address
     /** The signature to verify */
-    signature: Hex | ByteArray
+    signature: Hex | ByteArray | Signature
   }
 
 export type VerifyTypedDataReturnType = boolean

package/actions/public/watchEvent.ts

@@ -11,7 +11,10 @@ import type { Filter } from '../../types/filter.js'
 import type { Log } from '../../types/log.js'
 import type { LogTopic } from '../../types/misc.js'
 import type { GetPollOptions } from '../../types/transport.js'
-import type { EncodeEventTopicsParameters } from '../../utils/index.js'
+import {
+  type EncodeEventTopicsParameters,
+  encodeEventTopics,
+} from '../../utils/abi/encodeEventTopics.js'
 import { type ObserveErrorType, observe } from '../../utils/observe.js'
 import { poll } from '../../utils/poll.js'
 import { type StringifyErrorType, stringify } from '../../utils/stringify.js'
@@ -23,12 +26,9 @@ import {
 import { InvalidInputRpcError } from '../../errors/rpc.js'
 import type { ErrorType } from '../../errors/utils.js'
 import type { BlockNumber } from '../../types/block.js'
+import { decodeEventLog } from '../../utils/abi/decodeEventLog.js'
+import { formatLog } from '../../utils/formatters/log.js'
 import { getAction } from '../../utils/getAction.js'
-import {
-  decodeEventLog,
-  encodeEventTopics,
-  formatLog,
-} from '../../utils/index.js'
 import {
   type CreateEventFilterParameters,
   createEventFilter,

package/celo/fees.ts

@@ -1,9 +1,9 @@
 import type { Client } from '../clients/createClient.js'
-import {
-  type Address,
-  type ChainEstimateFeesPerGasFnParameters,
-  type ChainFees,
-  type Hex,
+import type {
+  Address,
+  ChainEstimateFeesPerGasFnParameters,
+  ChainFees,
+  Hex,
 } from '../index.js'
 
 import { formatters } from './formatters.js'

package/chains/definitions/areonNetwork.ts

@@ -1,6 +1,6 @@
 import { defineChain } from '../../utils/chain/defineChain.js'
 
-export const areonNetwork = defineChain({
+export const areonNetwork = /*#__PURE__*/ defineChain({
   id: 463,
   name: 'Areon Network',
   nativeCurrency: { decimals: 18, name: 'AREA', symbol: 'AREA' },

package/chains/definitions/areonNetworkTestnet.ts

@@ -1,6 +1,6 @@
 import { defineChain } from '../../utils/chain/defineChain.js'
 
-export const areonNetworkTestnet = defineChain({
+export const areonNetworkTestnet = /*#__PURE__*/ defineChain({
   id: 462,
   name: 'Areon Network Testnet',
   nativeCurrency: { decimals: 18, name: 'TAREA', symbol: 'TAREA' },

package/chains/definitions/bxnTestnet.ts

@@ -20,4 +20,5 @@ export const bxnTestnet = /*#__PURE__*/ defineChain({
       apiUrl: 'https://testnet-explorer.blackfort.network/api',
     },
   },
+  testnet: true,
 })

package/chains/definitions/cyber.ts

@@ -22,5 +22,4 @@ export const cyber = /*#__PURE__*/ defineChain({
       blockCreated: 43798,
     },
   },
-  testnet: true,
 })

package/chains/definitions/darwinia.ts

@@ -1,6 +1,6 @@
 import { defineChain } from '../../utils/chain/defineChain.js'
 
-export const darwinia = defineChain({
+export const darwinia = /*#__PURE__*/ defineChain({
   id: 46,
   name: 'Darwinia Network',
   nativeCurrency: {

package/chains/definitions/immutableZkEvmTestnet.ts

@@ -1,6 +1,6 @@
 import { defineChain } from '../../utils/chain/defineChain.js'
 
-export const immutableZkEvmTestnet = defineChain({
+export const immutableZkEvmTestnet = /*#__PURE__*/ defineChain({
   id: 13473,
   name: 'Immutable zkEVM Testnet',
   nativeCurrency: {

package/chains/definitions/reyaNetwork.ts

@@ -1,6 +1,6 @@
 import { defineChain } from '../../utils/chain/defineChain.js'
 
-export const reyaNetwork = defineChain({
+export const reyaNetwork = /*#__PURE__*/ defineChain({
   id: 1729,
   name: 'Reya Network',
   nativeCurrency: { decimals: 18, name: 'Ether', symbol: 'ETH' },

package/chains/definitions/yooldoVerse.ts

@@ -0,0 +1,18 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+
+export const yooldoVerse = /*#__PURE__*/ defineChain({
+  id: 50_005,
+  name: 'Yooldo Verse',
+  nativeCurrency: { name: 'OAS', symbol: 'OAS', decimals: 18 },
+  rpcUrls: {
+    default: {
+      http: ['https://rpc.yooldo-verse.xyz'],
+    },
+  },
+  blockExplorers: {
+    default: {
+      name: 'Yooldo Verse Explorer',
+      url: 'https://explorer.yooldo-verse.xyz',
+    },
+  },
+})

package/chains/definitions/yooldoVerseTestnet.ts

@@ -0,0 +1,19 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+
+export const yooldoVerseTestnet = /*#__PURE__*/ defineChain({
+  id: 50_006,
+  name: 'Yooldo Verse Testnet',
+  nativeCurrency: { name: 'OAS', symbol: 'OAS', decimals: 18 },
+  rpcUrls: {
+    default: {
+      http: ['https://rpc.testnet.yooldo-verse.xyz'],
+    },
+  },
+  blockExplorers: {
+    default: {
+      name: 'Yooldo Verse Testnet Explorer',
+      url: 'https://explorer.testnet.yooldo-verse.xyz',
+    },
+  },
+  testnet: true,
+})

package/chains/index.ts

@@ -247,6 +247,8 @@ export {
 export { xLayer } from './definitions/xLayer.js'
 export { xdc } from './definitions/xdc.js'
 export { xdcTestnet } from './definitions/xdcTestnet.js'
+export { yooldoVerse } from './definitions/yooldoVerse.js'
+export { yooldoVerseTestnet } from './definitions/yooldoVerseTestnet.js'
 export { zetachain } from './definitions/zetachain.js'
 export { zetachainAthensTestnet } from './definitions/zetachainAthensTestnet.js'
 export { zhejiang } from './definitions/zhejiang.js'

package/errors/version.ts

@@ -1 +1 @@
-export const version = '2.9.26'
+export const version = '2.9.28'

package/experimental/eip3074/utils/recoverAuthMessageAddress.ts

@@ -1,6 +1,6 @@
 import type { Address } from 'abitype'
 
-import type { ByteArray, Hex } from '../../../types/misc.js'
+import type { ByteArray, Hex, Signature } from '../../../types/misc.js'
 
 import type { ErrorType } from '../../../errors/utils.js'
 import { keccak256 } from '../../../utils/hash/keccak256.js'
@@ -11,7 +11,7 @@ import {
 import { type ToAuthMessageParameters, toAuthMessage } from './toAuthMessage.js'
 
 export type RecoverAuthMessageAddressParameters = ToAuthMessageParameters & {
-  signature: Hex | ByteArray
+  signature: Hex | ByteArray | Signature
 }
 
 export type RecoverAuthMessageAddressReturnType = Address

package/experimental/eip5792/actions/sendCalls.ts

@@ -15,7 +15,7 @@ import type { OneOf } from '../../../types/utils.js'
 import { parseAccount } from '../../../utils/accounts.js'
 import type { RequestErrorType } from '../../../utils/buildRequest.js'
 import { numberToHex } from '../../../utils/encoding/toHex.js'
-import { getTransactionError } from '../../../utils/index.js'
+import { getTransactionError } from '../../../utils/errors/getTransactionError.js'
 
 export type SendCallsParameters<
   chain extends Chain | undefined = Chain | undefined,

package/package.json

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

package/utils/abi/parseEventLogs.ts

@@ -1,13 +1,13 @@
 import type { Abi } from 'abitype'
-import type { ErrorType } from '../../errors/utils.js'
 import {
   AbiEventSignatureNotFoundError,
   DecodeLogDataMismatch,
   DecodeLogTopicsMismatch,
-  type RpcLog,
-} from '../../index.js'
+} from '../../errors/abi.js'
+import type { ErrorType } from '../../errors/utils.js'
 import type { ContractEventName } from '../../types/contract.js'
 import type { Log } from '../../types/log.js'
+import type { RpcLog } from '../../types/rpc.js'
 import {
   type DecodeEventLogErrorType,
   decodeEventLog,

package/utils/encoding/toRlp.ts

@@ -1,5 +1,5 @@
+import { BaseError } from '../../errors/base.js'
 import type { ErrorType } from '../../errors/utils.js'
-import { BaseError } from '../../index.js'
 import type { ByteArray, Hex } from '../../types/misc.js'
 import {
   type CreateCursorErrorType,

package/utils/signature/hexToSignature.ts

@@ -21,11 +21,24 @@ export type HexToSignatureErrorType = NumberToHexErrorType | ErrorType
  */
 export function hexToSignature(signatureHex: Hex) {
   const { r, s } = secp256k1.Signature.fromCompact(signatureHex.slice(2, 130))
-  const v = BigInt(`0x${signatureHex.slice(130)}`)
+  const yParityOrV = Number(`0x${signatureHex.slice(130)}`)
+  const [v, yParity] = (() => {
+    if (yParityOrV === 0 || yParityOrV === 1) return [undefined, yParityOrV]
+    if (yParityOrV === 27) return [BigInt(yParityOrV), 0]
+    if (yParityOrV === 28) return [BigInt(yParityOrV), 1]
+    throw new Error('Invalid yParityOrV value')
+  })()
+
+  if (typeof v !== 'undefined')
+    return {
+      r: numberToHex(r, { size: 32 }),
+      s: numberToHex(s, { size: 32 }),
+      v,
+      yParity,
+    } satisfies Signature
   return {
     r: numberToHex(r, { size: 32 }),
     s: numberToHex(s, { size: 32 }),
-    v,
-    yParity: v === 28n ? 1 : 0,
+    yParity,
   } satisfies Signature
 }

package/utils/signature/recoverAddress.ts

@@ -1,14 +1,14 @@
 import type { Address } from 'abitype'
 
 import { publicKeyToAddress } from '../../accounts/utils/publicKeyToAddress.js'
-import type { ByteArray, Hex } from '../../types/misc.js'
+import type { ByteArray, Hex, Signature } from '../../types/misc.js'
 
 import type { ErrorType } from '../../errors/utils.js'
 import { recoverPublicKey } from './recoverPublicKey.js'
 
 export type RecoverAddressParameters = {
   hash: Hex | ByteArray
-  signature: Hex | ByteArray
+  signature: Hex | ByteArray | Signature
 }
 
 export type RecoverAddressReturnType = Address

package/utils/signature/recoverMessageAddress.ts

@@ -1,6 +1,11 @@
 import type { Address } from 'abitype'
 
-import type { ByteArray, Hex, SignableMessage } from '../../types/misc.js'
+import type {
+  ByteArray,
+  Hex,
+  SignableMessage,
+  Signature,
+} from '../../types/misc.js'
 
 import type { ErrorType } from '../../errors/utils.js'
 import { type HashMessageErrorType, hashMessage } from './hashMessage.js'
@@ -11,7 +16,7 @@ import {
 
 export type RecoverMessageAddressParameters = {
   message: SignableMessage
-  signature: Hex | ByteArray
+  signature: Hex | ByteArray | Signature
 }
 
 export type RecoverMessageAddressReturnType = Address

package/utils/signature/recoverPublicKey.ts

@@ -1,12 +1,16 @@
 import type { ErrorType } from '../../errors/utils.js'
-import type { ByteArray, Hex } from '../../types/misc.js'
+import type { ByteArray, Hex, Signature } from '../../types/misc.js'
 import { type IsHexErrorType, isHex } from '../data/isHex.js'
-import { type HexToNumberErrorType, hexToNumber } from '../encoding/fromHex.js'
+import {
+  type HexToNumberErrorType,
+  hexToBigInt,
+  hexToNumber,
+} from '../encoding/fromHex.js'
 import { toHex } from '../encoding/toHex.js'
 
 export type RecoverPublicKeyParameters = {
   hash: Hex | ByteArray
-  signature: Hex | ByteArray
+  signature: Hex | ByteArray | Signature
 }
 
 export type RecoverPublicKeyReturnType = Hex
@@ -20,20 +24,39 @@ export async function recoverPublicKey({
   hash,
   signature,
 }: RecoverPublicKeyParameters): Promise<RecoverPublicKeyReturnType> {
-  const signatureHex = isHex(signature) ? signature : toHex(signature)
   const hashHex = isHex(hash) ? hash : toHex(hash)
 
-  // Derive v = recoveryId + 27 from end of the signature (27 is added when signing the message)
-  // The recoveryId represents the y-coordinate on the secp256k1 elliptic curve and can have a value [0, 1].
-  let v = hexToNumber(`0x${signatureHex.slice(130)}`)
-  if (v === 0 || v === 1) v += 27
-
   const { secp256k1 } = await import('@noble/curves/secp256k1')
-  const publicKey = secp256k1.Signature.fromCompact(
-    signatureHex.substring(2, 130),
-  )
-    .addRecoveryBit(v - 27)
+  const signature_ = (() => {
+    // typeof signature: `Signature`
+    if (typeof signature === 'object' && 'r' in signature && 's' in signature) {
+      const { r, s, v, yParity } = signature
+      const yParityOrV = Number(yParity ?? v)!
+      const recoveryBit = toRecoveryBit(yParityOrV)
+      return new secp256k1.Signature(
+        hexToBigInt(r),
+        hexToBigInt(s),
+      ).addRecoveryBit(recoveryBit)
+    }
+
+    // typeof signature: `Hex | ByteArray`
+    const signatureHex = isHex(signature) ? signature : toHex(signature)
+    const yParityOrV = hexToNumber(`0x${signatureHex.slice(130)}`)
+    const recoveryBit = toRecoveryBit(yParityOrV)
+    return secp256k1.Signature.fromCompact(
+      signatureHex.substring(2, 130),
+    ).addRecoveryBit(recoveryBit)
+  })()
+
+  const publicKey = signature_
     .recoverPublicKey(hashHex.substring(2))
     .toHex(false)
   return `0x${publicKey}`
 }
+
+function toRecoveryBit(yParityOrV: number) {
+  if (yParityOrV === 0 || yParityOrV === 1) return yParityOrV
+  if (yParityOrV === 27) return 0
+  if (yParityOrV === 28) return 1
+  throw new Error('Invalid yParityOrV value')
+}

package/utils/signature/recoverTransactionAddress.ts

@@ -1,6 +1,6 @@
 import type { Address } from 'abitype'
 import type { ErrorType } from '../../errors/utils.js'
-import type { ByteArray, Hex } from '../../types/misc.js'
+import type { ByteArray, Hex, Signature } from '../../types/misc.js'
 import type { TransactionSerialized } from '../../types/transaction.js'
 import { type Keccak256ErrorType, keccak256 } from '../hash/keccak256.js'
 import { parseTransaction } from '../transaction/parseTransaction.js'
@@ -19,7 +19,7 @@ import {
 
 export type RecoverTransactionAddressParameters = {
   serializedTransaction: TransactionSerialized
-  signature?: Hex | ByteArray
+  signature?: Hex | ByteArray | Signature
 }
 
 export type RecoverTransactionAddressReturnType = Address
@@ -53,6 +53,7 @@ export async function recoverTransactionAddress(
     s: undefined,
     v: undefined,
     yParity: undefined,
+    sidecars: undefined,
   })
 
   return await recoverAddress({

package/utils/signature/recoverTypedDataAddress.ts

@@ -1,6 +1,6 @@
 import type { Address, TypedData } from 'abitype'
 
-import type { ByteArray, Hex } from '../../types/misc.js'
+import type { ByteArray, Hex, Signature } from '../../types/misc.js'
 import type { TypedDataDefinition } from '../../types/typedData.js'
 
 import type { ErrorType } from '../../errors/utils.js'
@@ -14,7 +14,7 @@ export type RecoverTypedDataAddressParameters<
   typedData extends TypedData | Record<string, unknown> = TypedData,
   primaryType extends keyof typedData | 'EIP712Domain' = keyof typedData,
 > = TypedDataDefinition<typedData, primaryType> & {
-  signature: Hex | ByteArray
+  signature: Hex | ByteArray | Signature
 }
 
 export type RecoverTypedDataAddressReturnType = Address

package/utils/signature/signatureToCompactSignature.ts

@@ -1,11 +1,7 @@
 import type { ErrorType } from '../../errors/utils.js'
 import type { CompactSignature, Signature } from '../../types/misc.js'
-import {
-  type BytesToHexErrorType,
-  type HexToBytesErrorType,
-  bytesToHex,
-  hexToBytes,
-} from '../index.js'
+import { type HexToBytesErrorType, hexToBytes } from '../encoding/toBytes.js'
+import { type BytesToHexErrorType, bytesToHex } from '../encoding/toHex.js'
 
 export type SignatureToCompactSignatureErrorType =
   | HexToBytesErrorType

package/utils/signature/verifyMessage.ts

@@ -1,6 +1,11 @@
 import type { Address } from 'abitype'
 
-import type { ByteArray, Hex, SignableMessage } from '../../types/misc.js'
+import type {
+  ByteArray,
+  Hex,
+  SignableMessage,
+  Signature,
+} from '../../types/misc.js'
 import { type GetAddressErrorType, getAddress } from '../address/getAddress.js'
 import {
   type IsAddressEqualErrorType,
@@ -19,7 +24,7 @@ export type VerifyMessageParameters = {
   /** The message to be verified. */
   message: SignableMessage
   /** The signature that was generated by signing the message with the address's private key. */
-  signature: Hex | ByteArray
+  signature: Hex | ByteArray | Signature
 }
 
 export type VerifyMessageReturnType = boolean

package/utils/signature/verifyTypedData.ts

@@ -1,6 +1,6 @@
 import type { Address, TypedData } from 'abitype'
 
-import type { ByteArray, Hex } from '../../types/misc.js'
+import type { ByteArray, Hex, Signature } from '../../types/misc.js'
 import type { TypedDataDefinition } from '../../types/typedData.js'
 import { type GetAddressErrorType, getAddress } from '../address/getAddress.js'
 import {
@@ -21,7 +21,7 @@ export type VerifyTypedDataParameters<
   /** The address to verify the typed data for. */
   address: Address
   /** The signature to verify */
-  signature: Hex | ByteArray
+  signature: Hex | ByteArray | Signature
 }
 
 export type VerifyTypedDataReturnType = boolean

package/zksync/utils/assertEip712Request.ts

@@ -1,6 +1,9 @@
 import type { ErrorType } from '../../errors/utils.js'
-import { type AssertRequestErrorType, assertRequest } from '../../index.js'
 import type { ExactPartial } from '../../types/utils.js'
+import {
+  type AssertRequestErrorType,
+  assertRequest,
+} from '../../utils/transaction/assertRequest.js'
 import type { zkSync } from '../../zksync/chains.js'
 import type { SendTransactionParameters } from '../actions/sendTransaction.js'
 import { InvalidEip712TransactionError } from '../errors/transaction.js'