viem 2.36.0 → 2.36.1-jxom-erc8010-20250901014739

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "viem",
   "description": "TypeScript Interface for Ethereum",
-  "version": "2.36.0",
+  "version": "2.36.1-jxom-erc8010-20250901014739",
   "main": "./_cjs/index.js",
   "module": "./_esm/index.js",
   "types": "./_types/index.d.ts",
@@ -195,13 +195,13 @@
     }
   },
   "dependencies": {
-    "@noble/curves": "1.9.6",
+    "@noble/curves": "1.9.1",
     "@noble/hashes": "1.8.0",
     "@scure/bip32": "1.7.0",
     "@scure/bip39": "1.6.0",
     "abitype": "1.0.8",
     "isows": "1.0.7",
-    "ox": "0.9.1",
+    "ox": "0.9.3",
     "ws": "8.18.3"
   },
   "license": "MIT",

package/types/chain.ts

@@ -42,7 +42,7 @@ export type Chain<
           ensRegistry?: ChainContract | undefined
           ensUniversalResolver?: ChainContract | undefined
           multicall3?: ChainContract | undefined
-          universalSignatureVerifier?: ChainContract | undefined
+          erc6492Verifier?: ChainContract | undefined
         }
       >
     | undefined

package/utils/index.ts

@@ -441,12 +441,24 @@ export {
   type IsErc6492SignatureReturnType,
   isErc6492Signature,
 } from './signature/isErc6492Signature.js'
+export {
+  type IsErc8010SignatureErrorType,
+  type IsErc8010SignatureParameters,
+  type IsErc8010SignatureReturnType,
+  isErc8010Signature,
+} from './signature/isErc8010Signature.js'
 export {
   type ParseErc6492SignatureErrorType,
   type ParseErc6492SignatureParameters,
   type ParseErc6492SignatureReturnType,
   parseErc6492Signature,
 } from './signature/parseErc6492Signature.js'
+export {
+  type ParseErc8010SignatureErrorType,
+  type ParseErc8010SignatureParameters,
+  type ParseErc8010SignatureReturnType,
+  parseErc8010Signature,
+} from './signature/parseErc8010Signature.js'
 export {
   type RecoverAddressErrorType,
   type RecoverAddressParameters,
@@ -477,6 +489,12 @@ export {
   type SerializeErc6492SignatureReturnType,
   serializeErc6492Signature,
 } from './signature/serializeErc6492Signature.js'
+export {
+  type SerializeErc8010SignatureErrorType,
+  type SerializeErc8010SignatureParameters,
+  type SerializeErc8010SignatureReturnType,
+  serializeErc8010Signature,
+} from './signature/serializeErc8010Signature.js'
 export {
   type VerifyHashErrorType,
   type VerifyHashParameters,

package/utils/rpc/http.ts

@@ -15,6 +15,10 @@ import { stringify } from '../stringify.js'
 import { idCache } from './id.js'
 
 export type HttpRpcClientOptions = {
+  /** Override for the fetch function used to make requests. */
+  fetchFn?:
+    | ((input: string | URL | Request, init?: RequestInit) => Promise<Response>)
+    | undefined
   /** Request configuration to pass to `fetch`. */
   fetchOptions?: Omit<RequestInit, 'body'> | undefined
   /** A callback to handle the request. */
@@ -37,6 +41,8 @@ export type HttpRequestParameters<
 > = {
   /** The RPC request body. */
   body: body
+  /** Override for the fetch function used to make requests. */
+  fetchFn?: HttpRpcClientOptions['fetchFn'] | undefined
   /** Request configuration to pass to `fetch`. */
   fetchOptions?: HttpRpcClientOptions['fetchOptions'] | undefined
   /** A callback to handle the response. */
@@ -78,6 +84,7 @@ export function getHttpRpcClient(
     async request(params) {
       const {
         body,
+        fetchFn = options.fetchFn ?? fetch,
         onRequest = options.onRequest,
         onResponse = options.onResponse,
         timeout = options.timeout ?? 10_000,
@@ -117,7 +124,7 @@ export function getHttpRpcClient(
             }
             const request = new Request(url, init)
             const args = (await onRequest?.(request, init)) ?? { ...init, url }
-            const response = await fetch(args.url ?? url, args)
+            const response = await fetchFn(args.url ?? url, args)
             return response
           },
           {

package/utils/signature/isErc8010Signature.ts

@@ -0,0 +1,14 @@
+import * as SignatureErc8010 from 'ox/erc8010/SignatureErc8010'
+import type { ErrorType } from '../../errors/utils.js'
+import type { Hex } from '../../types/misc.js'
+
+export type IsErc8010SignatureParameters = Hex
+export type IsErc8010SignatureReturnType = boolean
+export type IsErc8010SignatureErrorType = ErrorType
+
+/** Whether or not the signature is an ERC-8010 formatted signature. */
+export function isErc8010Signature(
+  signature: IsErc8010SignatureParameters,
+): IsErc8010SignatureReturnType {
+  return SignatureErc8010.validate(signature)
+}

package/utils/signature/parseErc8010Signature.ts

@@ -0,0 +1,67 @@
+import type { Address } from 'abitype'
+import * as SignatureErc8010 from 'ox/erc8010/SignatureErc8010'
+import type { ErrorType } from '../../errors/utils.js'
+import type { SignedAuthorization } from '../../types/authorization.js'
+import type { Hex } from '../../types/misc.js'
+import type { OneOf, Prettify } from '../../types/utils.js'
+import { numberToHex } from '../encoding/toHex.js'
+import {
+  type IsErc8010SignatureErrorType,
+  isErc8010Signature,
+} from './isErc8010Signature.js'
+
+export type ParseErc8010SignatureParameters = Hex
+
+export type ParseErc8010SignatureReturnType = Prettify<
+  OneOf<
+    | {
+        /** Address of the initializer. */
+        address?: Address | undefined
+        /** Authorization signed by the delegatee. */
+        authorization: SignedAuthorization
+        /** Data to initialize the delegation. */
+        data?: Hex | undefined
+        /** The original signature. */
+        signature: Hex
+      }
+    | {
+        /** The original signature. */
+        signature: Hex
+      }
+  >
+>
+
+export type ParseErc8010SignatureErrorType =
+  | IsErc8010SignatureErrorType
+  | ErrorType
+
+/**
+ * @description Parses a hex-formatted ERC-8010 flavoured signature.
+ * If the signature is not in ERC-8010 format, then the underlying (original) signature is returned.
+ *
+ * @param signature ERC-8010 signature in hex format.
+ * @returns The parsed ERC-8010 signature.
+ */
+export function parseErc8010Signature(
+  signature: ParseErc8010SignatureParameters,
+): ParseErc8010SignatureReturnType {
+  if (!isErc8010Signature(signature)) return { signature }
+
+  const {
+    authorization: authorization_ox,
+    to,
+    ...rest
+  } = SignatureErc8010.unwrap(signature)
+  return {
+    authorization: {
+      address: authorization_ox.address,
+      chainId: authorization_ox.chainId,
+      nonce: Number(authorization_ox.nonce),
+      r: numberToHex(authorization_ox.r, { size: 32 }),
+      s: numberToHex(authorization_ox.s, { size: 32 }),
+      yParity: authorization_ox.yParity,
+    },
+    ...(to ? { address: to } : {}),
+    ...rest,
+  }
+}

package/utils/signature/serializeErc8010Signature.ts

@@ -0,0 +1,53 @@
+import type { Address } from 'abitype'
+import * as SignatureErc8010 from 'ox/erc8010/SignatureErc8010'
+import type { ErrorType } from '../../errors/utils.js'
+import type { SignedAuthorization } from '../../types/authorization.js'
+import type { ByteArray, Hex } from '../../types/misc.js'
+import { hexToBytes } from '../encoding/toBytes.js'
+
+type To = 'bytes' | 'hex'
+
+export type SerializeErc8010SignatureParameters<to extends To = 'hex'> = {
+  /** Address of the initializer. */
+  address?: Address | undefined
+  /** Authorization signed by the delegatee. */
+  authorization: SignedAuthorization
+  /** Data to initialize the delegation. */
+  data?: Hex | undefined
+  /** The original signature. */
+  signature: Hex
+  to?: to | To | undefined
+}
+
+export type SerializeErc8010SignatureReturnType<to extends To = 'hex'> =
+  | (to extends 'hex' ? Hex : never)
+  | (to extends 'bytes' ? ByteArray : never)
+
+export type SerializeErc8010SignatureErrorType = ErrorType
+
+/**
+ * @description Serializes a ERC-8010 flavoured signature into hex format.
+ *
+ * @param signature ERC-8010 signature in object format.
+ * @returns ERC-8010 signature in hex format.
+ */
+export function serializeErc8010Signature<to extends To = 'hex'>(
+  parameters: SerializeErc8010SignatureParameters<to>,
+): SerializeErc8010SignatureReturnType<to> {
+  const { address, data, signature, to = 'hex' } = parameters
+  const signature_ = SignatureErc8010.wrap({
+    authorization: {
+      address: parameters.authorization.address,
+      chainId: parameters.authorization.chainId,
+      nonce: BigInt(parameters.authorization.nonce),
+      r: BigInt(parameters.authorization.r),
+      s: BigInt(parameters.authorization.s),
+      yParity: parameters.authorization.yParity!,
+    },
+    data,
+    signature,
+    to: address,
+  })
+  if (to === 'hex') return signature_ as SerializeErc8010SignatureReturnType<to>
+  return hexToBytes(signature_) as SerializeErc8010SignatureReturnType<to>
+}