viem 2.18.7 → 2.19.0

package/experimental/eip7702/utils/serializeAuthorizationList.ts

@@ -0,0 +1,33 @@
+import type { ErrorType } from '../../../errors/utils.js'
+import { toHex } from '../../../utils/encoding/toHex.js'
+import { toYParitySignatureArray } from '../../../utils/transaction/serializeTransaction.js'
+import type {
+  AuthorizationList,
+  SerializedAuthorizationList,
+} from '../types/authorization.js'
+
+export type SerializeAuthorizationListReturnType = SerializedAuthorizationList
+
+export type SerializeAuthorizationListErrorType = ErrorType
+
+/*
+ * Serializes an EIP-7702 authorization list.
+ */
+export function serializeAuthorizationList(
+  authorizationList?: AuthorizationList<number, true> | undefined,
+): SerializeAuthorizationListReturnType {
+  if (!authorizationList || authorizationList.length === 0) return []
+
+  const serializedAuthorizationList = []
+  for (const authorization of authorizationList) {
+    const { contractAddress, chainId, nonce, ...signature } = authorization
+    serializedAuthorizationList.push([
+      toHex(chainId),
+      contractAddress,
+      [nonce ? toHex(nonce) : '0x'],
+      ...toYParitySignatureArray({}, signature),
+    ])
+  }
+
+  return serializedAuthorizationList as {} as SerializeAuthorizationListReturnType
+}

package/experimental/eip7702/utils/verifyAuthorization.ts

@@ -0,0 +1,52 @@
+import type { Address } from 'abitype'
+
+import type { ErrorType } from '../../../errors/utils.js'
+import {
+  type GetAddressErrorType,
+  getAddress,
+} from '../../../utils/address/getAddress.js'
+import {
+  type IsAddressEqualErrorType,
+  isAddressEqual,
+} from '../../../utils/address/isAddressEqual.js'
+import {
+  type RecoverAuthorizationAddressErrorType,
+  type RecoverAuthorizationAddressParameters,
+  recoverAuthorizationAddress,
+} from './recoverAuthorizationAddress.js'
+
+export type VerifyAuthorizationParameters =
+  RecoverAuthorizationAddressParameters & {
+    /** The address that signed the Authorization object. */
+    address: Address
+  }
+
+export type VerifyAuthorizationReturnType = boolean
+
+export type VerifyAuthorizationErrorType =
+  | IsAddressEqualErrorType
+  | GetAddressErrorType
+  | RecoverAuthorizationAddressErrorType
+  | ErrorType
+
+/**
+ * Verify that an Authorization object was signed by the provided address.
+ *
+ * - Docs {@link https://viem.sh/docs/utilities/verifyAuthorization}
+ *
+ * @param parameters - {@link VerifyAuthorizationParameters}
+ * @returns Whether or not the signature is valid. {@link VerifyAuthorizationReturnType}
+ */
+export async function verifyAuthorization({
+  address,
+  authorization,
+  signature,
+}: VerifyAuthorizationParameters): Promise<VerifyAuthorizationReturnType> {
+  return isAddressEqual(
+    getAddress(address),
+    await recoverAuthorizationAddress({
+      authorization,
+      signature,
+    }),
+  )
+}

package/experimental/erc7715/decorators/erc7715.ts

@@ -8,7 +8,7 @@ import {
   grantPermissions,
 } from '../actions/grantPermissions.js'
 
-export type WalletActionsErc7715 = {
+export type Erc7715Actions = {
   /**
    * Request permissions from a wallet to perform actions on behalf of a user.
    *
@@ -17,12 +17,12 @@ export type WalletActionsErc7715 = {
    * @example
    * import { createWalletClient, custom } from 'viem'
    * import { mainnet } from 'viem/chains'
-   * import { walletActionsErc7715 } from 'viem/experimental'
+   * import { erc7715Actions } from 'viem/experimental'
    *
    * const client = createWalletClient({
    *   chain: mainnet,
    *   transport: custom(window.ethereum),
-   * }).extend(walletActionsErc7715())
+   * }).extend(erc7715Actions())
    *
    * const result = await client.grantPermissions({
    *   expiry: 1716846083638,
@@ -56,23 +56,23 @@ export type WalletActionsErc7715 = {
  * @example
  * import { createPublicClient, createWalletClient, http } from 'viem'
  * import { mainnet } from 'viem/chains'
- * import { walletActionsErc7715 } from 'viem/experimental'
+ * import { erc7715Actions } from 'viem/experimental'
  *
  * const walletClient = createWalletClient({
  *   chain: mainnet,
  *   transport: http(),
- * }).extend(walletActionsErc7715())
+ * }).extend(erc7715Actions())
  *
  * const result = await walletClient.grantPermissions({...})
  */
-export function walletActionsErc7715() {
+export function erc7715Actions() {
   return <
     transport extends Transport,
     chain extends Chain | undefined = Chain | undefined,
     account extends Account | undefined = Account | undefined,
   >(
     client: Client<transport, chain, account>,
-  ): WalletActionsErc7715 => {
+  ): Erc7715Actions => {
     return {
       grantPermissions: (parameters) => grantPermissions(client, parameters),
     }

package/experimental/index.ts

@@ -31,10 +31,80 @@ export {
   writeContracts,
 } from './eip5792/actions/writeContracts.js'
 export {
-  type WalletActionsEip5792,
-  walletActionsEip5792,
+  /** @deprecated use `Eip5792Actions` instead. */
+  type Eip5792Actions as WalletActionsEip5792,
+  /** @deprecated use `eip5792Actions` instead. */
+  eip5792Actions as walletActionsEip5792,
+  type Eip5792Actions,
+  eip5792Actions,
 } from './eip5792/decorators/eip5792.js'
 
+export {
+  type Eip7702Actions,
+  eip7702Actions,
+} from './eip7702/decorators/eip7702.js'
+export {
+  type SignAuthorizationParameters,
+  type SignAuthorizationReturnType,
+  type SignAuthorizationErrorType,
+  signAuthorization,
+} from './eip7702/actions/signAuthorization.js'
+export {
+  type Authorization,
+  type SignedAuthorization,
+  type AuthorizationList,
+  type SignedAuthorizationList,
+  type SerializedAuthorization,
+  type SerializedAuthorizationList,
+} from './eip7702/types/authorization.js'
+export {
+  type RpcAuthorizationList,
+  type RpcAuthorization,
+} from './eip7702/types/rpc.js'
+export {
+  type HashAuthorizationParameters,
+  type HashAuthorizationReturnType,
+  type HashAuthorizationErrorType,
+  hashAuthorization,
+} from './eip7702/utils/hashAuthorization.js'
+export {
+  type RecoverAuthorizationAddressParameters,
+  type RecoverAuthorizationAddressReturnType,
+  type RecoverAuthorizationAddressErrorType,
+  recoverAuthorizationAddress,
+} from './eip7702/utils/recoverAuthorizationAddress.js'
+export {
+  type SerializeAuthorizationListReturnType,
+  type SerializeAuthorizationListErrorType,
+  serializeAuthorizationList,
+} from './eip7702/utils/serializeAuthorizationList.js'
+export {
+  type VerifyAuthorizationParameters,
+  type VerifyAuthorizationReturnType,
+  type VerifyAuthorizationErrorType,
+  verifyAuthorization,
+} from './eip7702/utils/verifyAuthorization.js'
+
+export {
+  type GrantPermissionsParameters,
+  type GrantPermissionsReturnType,
+  grantPermissions,
+} from './erc7715/actions/grantPermissions.js'
+export {
+  /** @deprecated use `Erc7715Actions` instead. */
+  type Erc7715Actions as WalletActionsErc7715,
+  /** @deprecated use `erc7715Actions` instead. */
+  erc7715Actions as walletActionsErc7715,
+  type Erc7715Actions,
+  erc7715Actions,
+} from './erc7715/decorators/erc7715.js'
+
+export {
+  type SoladyActions,
+  type SoladyActionsParameters,
+  soladyActions,
+} from './solady/decorators/solady.js'
+
 export {
   /** @deprecated This is no longer experimental – use `import type { ParseErc6492SignatureErrorType } from 'viem'` instead. */
   type ParseErc6492SignatureErrorType,
@@ -65,19 +135,3 @@ export {
   /** @deprecated This is no longer experimental – use `import { serializeErc6492Signature } from 'viem'` instead. */
   serializeErc6492Signature,
 } from '../utils/signature/serializeErc6492Signature.js'
-
-export {
-  type GrantPermissionsParameters,
-  type GrantPermissionsReturnType,
-  grantPermissions,
-} from './erc7715/actions/grantPermissions.js'
-export {
-  type WalletActionsErc7715,
-  walletActionsErc7715,
-} from './erc7715/decorators/erc7715.js'
-
-export {
-  type SoladyActions,
-  type SoladyActionsParameters,
-  soladyActions,
-} from './solady/decorators/solady.js'

package/index.ts

@@ -710,7 +710,7 @@ export {
   UnsupportedPackedAbiType,
   type UnsupportedPackedAbiTypeErrorType,
 } from './errors/abi.js'
-export { BaseError, type BaseErrorType } from './errors/base.js'
+export { BaseError, type BaseErrorType, setErrorConfig } from './errors/base.js'
 export {
   BlockNotFoundError,
   type BlockNotFoundErrorType,
@@ -941,36 +941,61 @@ export type {
   TransactionEIP1559,
   TransactionEIP2930,
   TransactionEIP4844,
+  TransactionEIP7702,
   TransactionLegacy,
   TransactionReceipt,
   TransactionRequest,
   TransactionRequestBase,
   TransactionRequestEIP1559,
   TransactionRequestEIP2930,
+  TransactionRequestEIP4844,
+  TransactionRequestEIP7702,
+  TransactionRequestGeneric,
   TransactionRequestLegacy,
   TransactionSerializable,
   TransactionSerializableBase,
   TransactionSerializableEIP1559,
   TransactionSerializableEIP2930,
   TransactionSerializableEIP4844,
+  TransactionSerializableEIP7702,
   TransactionSerializableGeneric,
   TransactionSerializableLegacy,
   TransactionSerialized,
   TransactionSerializedEIP1559,
   TransactionSerializedEIP2930,
   TransactionSerializedEIP4844,
+  TransactionSerializedEIP7702,
   TransactionSerializedGeneric,
   TransactionSerializedLegacy,
   TransactionType,
-  TransactionRequestEIP4844,
-  TransactionRequestGeneric,
 } from './types/transaction.js'
 export type {
+  Assign,
+  Branded,
+  Evaluate,
+  IsNarrowable,
+  IsUndefined,
+  IsUnion,
+  LooseOmit,
+  MaybePartial,
+  MaybePromise,
+  MaybeRequired,
+  Mutable,
+  NoInfer,
+  NoUndefined,
+  Omit,
+  Or,
+  PartialBy,
+  RequiredBy,
+  Some,
+  UnionEvaluate,
+  UnionLooseOmit,
+  ValueOf,
+  Prettify,
   ExactPartial,
   ExactRequired,
   IsNever,
   OneOf,
-  Opaque,
   UnionOmit,
   UnionPartialBy,
   UnionPick,

package/op-stack/errors/withdrawal.ts

@@ -5,9 +5,8 @@ export type GameNotFoundErrorType = GameNotFoundError & {
   name: 'GameNotFoundError'
 }
 export class GameNotFoundError extends BaseError {
-  override name = 'GameNotFoundError'
   constructor() {
-    super('Dispute game not found.')
+    super('Dispute game not found.', { name: 'GameNotFoundError' })
   }
 }
 
@@ -16,10 +15,10 @@ export type ReceiptContainsNoWithdrawalsErrorType =
     name: 'ReceiptContainsNoWithdrawalsError'
   }
 export class ReceiptContainsNoWithdrawalsError extends BaseError {
-  override name = 'ReceiptContainsNoWithdrawalsError'
   constructor({ hash }: { hash: Hex }) {
     super(
       `The provided transaction receipt with hash "${hash}" contains no withdrawals.`,
+      { name: 'ReceiptContainsNoWithdrawalsError' },
     )
   }
 }

package/package.json

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

package/types/rpc.ts

@@ -1,5 +1,6 @@
 import type { Address } from 'abitype'
 
+import type { RpcAuthorizationList } from '../experimental/eip7702/types/rpc.js'
 import type {
   Block,
   BlockIdentifier,
@@ -15,11 +16,13 @@ import type {
   TransactionEIP1559,
   TransactionEIP2930,
   TransactionEIP4844,
+  TransactionEIP7702,
   TransactionLegacy,
   TransactionReceipt,
   TransactionRequestEIP1559,
   TransactionRequestEIP2930,
   TransactionRequestEIP4844,
+  TransactionRequestEIP7702,
   TransactionRequestLegacy,
 } from './transaction.js'
 import type { Omit, OneOf, PartialBy } from './utils.js'
@@ -27,7 +30,13 @@ import type { Omit, OneOf, PartialBy } from './utils.js'
 export type Index = `0x${string}`
 export type Quantity = `0x${string}`
 export type Status = '0x0' | '0x1'
-export type TransactionType = '0x0' | '0x1' | '0x2' | (string & {})
+export type TransactionType =
+  | '0x0'
+  | '0x1'
+  | '0x2'
+  | '0x3'
+  | '0x4'
+  | (string & {})
 
 export type RpcBlock<
   blockTag extends BlockTag = BlockTag,
@@ -52,6 +61,10 @@ export type RpcTransactionRequest = OneOf<
   | TransactionRequestEIP2930<Quantity, Index, '0x1'>
   | TransactionRequestEIP1559<Quantity, Index, '0x2'>
   | TransactionRequestEIP4844<Quantity, Index, '0x3'>
+  | (Omit<
+      TransactionRequestEIP7702<Quantity, Index, '0x4'>,
+      'authorizationList'
+    > & { authorizationList?: RpcAuthorizationList | undefined })
 >
 // `yParity` is optional on the RPC type as some nodes do not return it
 // for 1559 & 2930 transactions (they should!).
@@ -69,6 +82,13 @@ export type RpcTransaction<pending extends boolean = boolean> = OneOf<
       Omit<TransactionEIP4844<Quantity, Index, pending, '0x3'>, 'typeHex'>,
       'yParity'
     >
+  | PartialBy<
+      Omit<
+        TransactionEIP7702<Quantity, Index, pending, '0x4'>,
+        'authorizationList' | 'typeHex'
+      > & { authorizationList?: RpcAuthorizationList | undefined },
+      'yParity'
+    >
 >
 
 type SuccessResult<result> = {