viem 2.17.11 → 2.18.1

package/clients/decorators/public.ts

@@ -945,7 +945,7 @@ export type PublicActions<
     type extends FeeValuesType = 'eip1559',
   >(
     args?: EstimateFeesPerGasParameters<chain, chainOverride, type> | undefined,
-  ) => Promise<EstimateFeesPerGasReturnType>
+  ) => Promise<EstimateFeesPerGasReturnType<type>>
   /**
    * Returns a list of logs or hashes based on a [Filter](/docs/glossary/terms#filter) since the last time it was called.
    *

package/constants/abis.ts

@@ -209,17 +209,14 @@ export const universalSignatureValidatorAbi = [
   {
     inputs: [
       {
-        internalType: 'address',
         name: '_signer',
         type: 'address',
       },
       {
-        internalType: 'bytes32',
         name: '_hash',
         type: 'bytes32',
       },
       {
-        internalType: 'bytes',
         name: '_signature',
         type: 'bytes',
       },

package/constants/address.ts

@@ -1 +1,5 @@
+export const entryPoint06Address =
+  '0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789' as const
+export const entryPoint07Address =
+  '0x0000000071727De22E5E9d8BAf0edAc6f37da032' as const
 export const zeroAddress = '0x0000000000000000000000000000000000000000' as const

package/errors/account.ts

@@ -9,7 +9,7 @@ export class AccountNotFoundError extends BaseError {
     super(
       [
         'Could not find an Account to execute with this Action.',
-        'Please provide an Account with the `account` argument on the Action, or by supplying an `account` to the WalletClient.',
+        'Please provide an Account with the `account` argument on the Action, or by supplying an `account` to the Client.',
       ].join('\n'),
       {
         docsPath,
@@ -18,3 +18,24 @@ export class AccountNotFoundError extends BaseError {
     )
   }
 }
+
+export type AccountTypeNotSupportedErrorType = AccountTypeNotSupportedError & {
+  name: 'AccountTypeNotSupportedError'
+}
+export class AccountTypeNotSupportedError extends BaseError {
+  override name = 'AccountTypeNotSupportedError'
+  constructor({
+    docsPath,
+    metaMessages,
+    type,
+  }: {
+    docsPath?: string | undefined
+    metaMessages?: string[] | undefined
+    type: string
+  }) {
+    super(`Account type "${type}" is not supported.`, {
+      docsPath,
+      metaMessages,
+    })
+  }
+}

package/errors/contract.ts

@@ -152,7 +152,7 @@ export class ContractFunctionExecutionError extends BaseError {
         docsPath,
         metaMessages: [
           ...(cause.metaMessages ? [...cause.metaMessages, ' '] : []),
-          'Contract Call:',
+          prettyArgs && 'Contract Call:',
           prettyArgs,
         ].filter(Boolean) as string[],
       },

package/errors/rpc.ts

@@ -148,10 +148,10 @@ export class MethodNotFoundRpcError extends RpcError {
   override name = 'MethodNotFoundRpcError'
   static code = -32601 as const
 
-  constructor(cause: Error) {
+  constructor(cause: Error, { method }: { method?: string } = {}) {
     super(cause, {
       code: MethodNotFoundRpcError.code,
-      shortMessage: 'The method does not exist / is not available.',
+      shortMessage: `The method${method ? ` "${method}"` : ''} does not exist / is not available.`,
     })
   }
 }
@@ -301,10 +301,10 @@ export class MethodNotSupportedRpcError extends RpcError {
   override name = 'MethodNotSupportedRpcError'
   static code = -32004 as const
 
-  constructor(cause: Error) {
+  constructor(cause: Error, { method }: { method?: string } = {}) {
     super(cause, {
       code: MethodNotSupportedRpcError.code,
-      shortMessage: 'Method is not implemented.',
+      shortMessage: `Method${method ? ` "${method}"` : ''} is not implemented.`,
     })
   }
 }
@@ -409,10 +409,10 @@ export class UnsupportedProviderMethodError extends ProviderRpcError {
   override name = 'UnsupportedProviderMethodError'
   static code = 4200 as const
 
-  constructor(cause: Error) {
+  constructor(cause: Error, { method }: { method?: string } = {}) {
     super(cause, {
       code: UnsupportedProviderMethodError.code,
-      shortMessage: 'The Provider does not support the requested method.',
+      shortMessage: `The Provider does not support the requested method${method ? ` " ${method}"` : ''}.`,
     })
   }
 }

package/errors/version.ts

@@ -1 +1 @@
-export const version = '2.17.11'
+export const version = '2.18.1'

package/index.ts

@@ -439,9 +439,9 @@ export type {
   WatchAssetReturnType,
 } from './actions/wallet/watchAsset.js'
 export type {
-  VerifyHashErrorType,
-  VerifyHashParameters,
-  VerifyHashReturnType,
+  VerifyHashErrorType as VerifyHashActionErrorType,
+  VerifyHashParameters as VerifyHashActionParameters,
+  VerifyHashReturnType as VerifyHashActionReturnType,
 } from './actions/public/verifyHash.js'
 export type {
   VerifyTypedDataErrorType as VerifyTypedDataActionErrorType,
@@ -1004,6 +1004,8 @@ export type {
 } from './types/misc.js'
 export type {
   AddEthereumChainParameter,
+  BundlerRpcSchema,
+  DebugBundlerRpcSchema,
   EIP1193EventMap,
   EIP1193Events,
   EIP1193Parameters,
@@ -1294,6 +1296,8 @@ export {
   type SerializeSignatureErrorType as SignatureToHexErrorType,
   /** @deprecated Use `serializeSignature` instead. */
   serializeSignature as signatureToHex,
+  type SerializeSignatureParameters,
+  type SerializeSignatureReturnType,
   type SerializeSignatureErrorType,
   serializeSignature,
 } from './utils/signature/serializeSignature.js'
@@ -1306,6 +1310,12 @@ export {
   type ToRlpErrorType,
   type ToRlpReturnType,
 } from './utils/encoding/toRlp.js'
+export {
+  type VerifyHashErrorType,
+  type VerifyHashParameters,
+  type VerifyHashReturnType,
+  verifyHash,
+} from './utils/signature/verifyHash.js'
 export {
   type VerifyMessageErrorType,
   type VerifyMessageParameters,
@@ -1686,3 +1696,10 @@ export {
   createNonceManager,
   nonceManager,
 } from './utils/nonceManager.js'
+export type {
+  RpcEstimateUserOperationGasReturnType,
+  RpcGetUserOperationByHashReturnType,
+  RpcUserOperation,
+  RpcUserOperationReceipt,
+  RpcUserOperationRequest,
+} from './account-abstraction/types/rpc.js'

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "viem",
   "description": "TypeScript Interface for Ethereum",
-  "version": "2.17.11",
+  "version": "2.18.1",
   "main": "./_cjs/index.js",
   "module": "./_esm/index.js",
   "types": "./_types/index.d.ts",
@@ -24,6 +24,11 @@
       "import": "./_esm/index.js",
       "default": "./_cjs/index.js"
     },
+    "./account-abstraction": {
+      "types": "./_types/account-abstraction/index.d.ts",
+      "import": "./_esm/account-abstraction/index.js",
+      "default": "./_cjs/account-abstraction/index.js"
+    },
     "./accounts": {
       "types": "./_types/accounts/index.d.ts",
       "import": "./_esm/accounts/index.js",
@@ -163,6 +168,7 @@
     "@scure/bip39": "1.3.0",
     "abitype": "1.0.5",
     "isows": "1.0.4",
+    "webauthn-p256": "0.0.5",
     "ws": "8.17.1"
   },
   "license": "MIT",

package/types/eip1193.ts

@@ -1,5 +1,11 @@
 import type { Address } from 'abitype'
 
+import type {
+  RpcEstimateUserOperationGasReturnType,
+  RpcGetUserOperationByHashReturnType,
+  RpcUserOperation,
+  RpcUserOperationReceipt,
+} from '../account-abstraction/types/rpc.js'
 import type { BlockTag } from './block.js'
 import type { Hash, Hex, LogTopic } from './misc.js'
 import type { RpcStateOverride } from './rpc.js'
@@ -16,12 +22,17 @@ import type {
   RpcTransactionRequest as TransactionRequest,
   RpcUncle as Uncle,
 } from './rpc.js'
-import type { ExactPartial, OneOf, Prettify } from './utils.js'
+import type { ExactPartial, OneOf, PartialBy, Prettify } from './utils.js'
 
 //////////////////////////////////////////////////
 // Provider
 
-export type EIP1474Methods = [...PublicRpcSchema, ...WalletRpcSchema]
+export type EIP1474Methods = [
+  ...PublicRpcSchema,
+  ...WalletRpcSchema,
+  ...BundlerRpcSchema,
+  ...PaymasterRpcSchema,
+]
 
 export type EIP1193Provider = Prettify<
   EIP1193Events & {
@@ -228,6 +239,307 @@ export type WatchAssetParams = {
   }
 }
 
+export type BundlerRpcSchema = [
+  /**
+   * @description Returns the chain ID associated with the current network
+   *
+   * @link https://eips.ethereum.org/EIPS/eip-4337#-eth_chainid
+   */
+  {
+    Method: 'eth_chainId'
+    Parameters?: undefined
+    ReturnType: Hex
+  },
+  /**
+   * @description Estimate the gas values for a UserOperation.
+   *
+   * @link https://eips.ethereum.org/EIPS/eip-4337#-eth_estimateuseroperationgas
+   *
+   * @example
+   * provider.request({
+   *  method: 'eth_estimateUserOperationGas',
+   *  params: [{ ... }]
+   * })
+   * // => { ... }
+   */
+  {
+    Method: 'eth_estimateUserOperationGas'
+    Parameters:
+      | [userOperation: RpcUserOperation, entrypoint: Address]
+      | [
+          userOperation: RpcUserOperation,
+          entrypoint: Address,
+          stateOverrideSet: RpcStateOverride,
+        ]
+    ReturnType: RpcEstimateUserOperationGasReturnType
+  },
+  /**
+   * @description Return a UserOperation based on a hash.
+   *
+   * @link https://eips.ethereum.org/EIPS/eip-4337#-eth_getuseroperationbyhash
+   *
+   * @example
+   * provider.request({
+   *  method: 'eth_getUserOperationByHash',
+   *  params: ['0x...']
+   * })
+   * // => { ... }
+   */
+  {
+    Method: 'eth_getUserOperationByHash'
+    Parameters: [hash: Hash]
+    ReturnType: RpcGetUserOperationByHashReturnType | null
+  },
+  /**
+   * @description Return a UserOperation receipt based on a hash.
+   *
+   * @link https://eips.ethereum.org/EIPS/eip-4337#-eth_getuseroperationreceipt
+   *
+   * @example
+   * provider.request({
+   *  method: 'eth_getUserOperationReceipt',
+   *  params: ['0x...']
+   * })
+   * // => { ... }
+   */
+  {
+    Method: 'eth_getUserOperationReceipt'
+    Parameters: [hash: Hash]
+    ReturnType: RpcUserOperationReceipt | null
+  },
+  /**
+   * @description Submits a User Operation object to the User Operation pool of the client.
+   *
+   * @link https://eips.ethereum.org/EIPS/eip-4337#-eth_senduseroperation
+   *
+   * @example
+   * provider.request({
+   *  method: 'eth_sendUserOperation',
+   *  params: [{ ... }]
+   * })
+   * // => '0x...'
+   */
+  {
+    Method: 'eth_sendUserOperation'
+    Parameters: [userOperation: RpcUserOperation, entrypoint: Address]
+    ReturnType: Hash
+  },
+  /**
+   * @description Return the list of supported entry points by the client.
+   *
+   * @link https://eips.ethereum.org/EIPS/eip-4337#-eth_supportedentrypoints
+   */
+  {
+    Method: 'eth_supportedEntryPoints'
+    Parameters?: undefined
+    ReturnType: readonly Address[]
+  },
+]
+
+export type DebugBundlerRpcSchema = [
+  /**
+   * @description Clears the bundler mempool and reputation data of paymasters/accounts/factories/aggregators.
+   *
+   * @link https://github.com/eth-infinitism/bundler-spec/blob/a247b5de59a702063ea5b09d6136f119a061642b/src/debug/debug.yaml#L1
+   */
+  {
+    Method: 'debug_bundler_clearState'
+    Parameters?: undefined
+    ReturnType: undefined
+  },
+  /**
+   * @description Returns the current mempool
+   *
+   * @link https://github.com/eth-infinitism/bundler-spec/blob/a247b5de59a702063ea5b09d6136f119a061642b/src/debug/debug.yaml#L8
+   */
+  {
+    Method: 'debug_bundler_dumpMempool'
+    Parameters: [entryPoint: Address]
+    ReturnType: readonly { userOp: RpcUserOperation }[]
+  },
+  /**
+   * @description Forces the bundler to execute the entire current mempool.
+   *
+   * @link https://github.com/eth-infinitism/bundler-spec/blob/a247b5de59a702063ea5b09d6136f119a061642b/src/debug/debug.yaml#L19
+   */
+  {
+    Method: 'debug_bundler_sendBundleNow'
+    Parameters?: undefined
+    ReturnType: Hash
+  },
+  /**
+   * @description Toggles bundling mode between 'auto' and 'manual'
+   *
+   * @link https://github.com/eth-infinitism/bundler-spec/blob/a247b5de59a702063ea5b09d6136f119a061642b/src/debug/debug.yaml#L26
+   */
+  {
+    Method: 'debug_bundler_setBundlingMode'
+    Parameters: [mode: 'auto' | 'manual']
+    ReturnType: undefined
+  },
+  /**
+   * @description Sets reputation of given addresses.
+   *
+   * @link https://github.com/eth-infinitism/bundler-spec/blob/a247b5de59a702063ea5b09d6136f119a061642b/src/debug/debug.yaml#L37
+   */
+  {
+    Method: 'debug_bundler_setReputation'
+    Parameters: [
+      reputations: readonly {
+        address: Address
+        opsSeen: Hex
+        opsIncluded: Hex
+      }[],
+      entryPoint: Address,
+    ]
+    ReturnType: undefined
+  },
+  /**
+   * @description Returns the reputation data of all observed addresses.
+   *
+   * @link https://github.com/eth-infinitism/bundler-spec/blob/a247b5de59a702063ea5b09d6136f119a061642b/src/debug/debug.yaml#L52
+   */
+  {
+    Method: 'debug_bundler_dumpReputation'
+    Parameters: [entryPoint: Address]
+    ReturnType: readonly {
+      address: Address
+      opsSeen: Hex
+      opsIncluded: Hex
+    }[]
+  },
+  /**
+   * @description Add a bulk of UserOps into the mempool
+   *
+   * @link https://github.com/eth-infinitism/bundler-spec/blob/a247b5de59a702063ea5b09d6136f119a061642b/src/debug/debug.yaml#L64
+   */
+  {
+    Method: 'debug_bundler_addUserOps'
+    Parameters: [userOps: readonly RpcUserOperation[], entryPoint: Address]
+    ReturnType: undefined
+  },
+]
+
+export type PaymasterRpcSchema = [
+  /**
+   * @description Returns the chain ID associated with the current network
+   *
+   * @link https://eips.ethereum.org/EIPS/eip-4337#-eth_chainid
+   */
+  {
+    Method: 'pm_getPaymasterStubData'
+    Parameters?: [
+      userOperation: OneOf<
+        | PartialBy<
+            Pick<
+              RpcUserOperation<'0.6'>,
+              | 'callData'
+              | 'callGasLimit'
+              | 'initCode'
+              | 'maxFeePerGas'
+              | 'maxPriorityFeePerGas'
+              | 'nonce'
+              | 'sender'
+              | 'preVerificationGas'
+              | 'verificationGasLimit'
+            >,
+            | 'callGasLimit'
+            | 'initCode'
+            | 'maxFeePerGas'
+            | 'maxPriorityFeePerGas'
+            | 'preVerificationGas'
+            | 'verificationGasLimit'
+          >
+        | PartialBy<
+            Pick<
+              RpcUserOperation<'0.7'>,
+              | 'callData'
+              | 'callGasLimit'
+              | 'factory'
+              | 'factoryData'
+              | 'maxFeePerGas'
+              | 'maxPriorityFeePerGas'
+              | 'nonce'
+              | 'sender'
+              | 'preVerificationGas'
+              | 'verificationGasLimit'
+            >,
+            | 'callGasLimit'
+            | 'factory'
+            | 'factoryData'
+            | 'maxFeePerGas'
+            | 'maxPriorityFeePerGas'
+            | 'preVerificationGas'
+            | 'verificationGasLimit'
+          >
+      >,
+      entrypoint: Address,
+      chainId: Hex,
+      context: unknown,
+    ]
+    ReturnType: OneOf<
+      | { paymasterAndData: Hex }
+      | {
+          paymaster: Address
+          paymasterData: Hex
+          paymasterVerificationGasLimit: Hex
+          paymasterPostOpGasLimit: Hex
+        }
+    > & {
+      sponsor?: { name: string; icon?: string | undefined } | undefined
+      isFinal?: boolean | undefined
+    }
+  },
+  /**
+   * @description Returns values to be used in paymaster-related fields of a signed user operation.
+   *
+   * @link https://github.com/ethereum/ERCs/blob/master/ERCS/erc-7677.md#pm_getpaymasterdata
+   */
+  {
+    Method: 'pm_getPaymasterData'
+    Parameters?: [
+      userOperation:
+        | Pick<
+            RpcUserOperation<'0.6'>,
+            | 'callData'
+            | 'callGasLimit'
+            | 'initCode'
+            | 'maxFeePerGas'
+            | 'maxPriorityFeePerGas'
+            | 'nonce'
+            | 'sender'
+            | 'preVerificationGas'
+            | 'verificationGasLimit'
+          >
+        | Pick<
+            RpcUserOperation<'0.7'>,
+            | 'callData'
+            | 'callGasLimit'
+            | 'factory'
+            | 'factoryData'
+            | 'maxFeePerGas'
+            | 'maxPriorityFeePerGas'
+            | 'nonce'
+            | 'sender'
+            | 'preVerificationGas'
+            | 'verificationGasLimit'
+          >,
+      entrypoint: Address,
+      chainId: Hex,
+      context: unknown,
+    ]
+    ReturnType: OneOf<
+      | { paymasterAndData: Hex }
+      | {
+          paymaster: Address
+          paymasterData: Hex
+          paymasterVerificationGasLimit: Hex
+          paymasterPostOpGasLimit: Hex
+        }
+    >
+  },
+]
+
 export type PublicRpcSchema = [
   /**
    * @description Returns the version of the current client

package/types/multicall.ts

@@ -127,7 +127,7 @@ export type MulticallResponse<
   : result
 
 // infer contract parameters from `unknown`
-type GetMulticallContractParameters<
+export type GetMulticallContractParameters<
   contract,
   mutability extends AbiStateMutability,
 > = contract extends { abi: infer abi extends Abi } // 1. Check if `abi` is const-asserted or defined inline