viem 2.8.10 → 2.8.12

package/errors/contract.ts

@@ -44,7 +44,10 @@ export class CallExecutionError extends BaseError {
       to,
       value,
       stateOverride,
-    }: CallParameters & { chain?: Chain; docsPath?: string },
+    }: CallParameters & {
+      chain?: Chain | undefined
+      docsPath?: string | undefined
+    },
   ) {
     const account = account_ ? parseAccount(account_) : undefined
     let prettyArgs = prettyPrint({
@@ -89,12 +92,12 @@ export type ContractFunctionExecutionErrorType =
   }
 export class ContractFunctionExecutionError extends BaseError {
   abi: Abi
-  args?: unknown[]
+  args?: unknown[] | undefined
   override cause: BaseError
-  contractAddress?: Address
-  formattedArgs?: string
+  contractAddress?: Address | undefined
+  formattedArgs?: string | undefined
   functionName: string
-  sender?: Address
+  sender?: Address | undefined
 
   override name = 'ContractFunctionExecutionError'
 
@@ -109,11 +112,11 @@ export class ContractFunctionExecutionError extends BaseError {
       sender,
     }: {
       abi: Abi
-      args?: any
-      contractAddress?: Address
-      docsPath?: string
+      args?: any | undefined
+      contractAddress?: Address | undefined
+      docsPath?: string | undefined
       functionName: string
-      sender?: Address
+      sender?: Address | undefined
     },
   ) {
     const abiItem = getAbiItem({ abi, args, name: functionName })
@@ -170,16 +173,21 @@ export type ContractFunctionRevertedErrorType =
 export class ContractFunctionRevertedError extends BaseError {
   override name = 'ContractFunctionRevertedError'
 
-  data?: DecodeErrorResultReturnType
-  reason?: string
-  signature?: Hex
+  data?: DecodeErrorResultReturnType | undefined
+  reason?: string | undefined
+  signature?: Hex | undefined
 
   constructor({
     abi,
     data,
     functionName,
     message,
-  }: { abi: Abi; data?: Hex; functionName: string; message?: string }) {
+  }: {
+    abi: Abi
+    data?: Hex | undefined
+    functionName: string
+    message?: string | undefined
+  }) {
     let cause: Error | undefined
     let decodedData: DecodeErrorResultReturnType | undefined = undefined
     let metaMessages: string[] | undefined
@@ -277,12 +285,15 @@ export class RawContractError extends BaseError {
   code = 3
   override name = 'RawContractError'
 
-  data?: Hex | { data?: Hex }
+  data?: Hex | { data?: Hex | undefined } | undefined
 
   constructor({
     data,
     message,
-  }: { data?: Hex | { data?: Hex }; message?: string }) {
+  }: {
+    data?: Hex | { data?: Hex | undefined } | undefined
+    message?: string | undefined
+  }) {
     super(message || '')
     this.data = data
   }

package/errors/encoding.ts

@@ -14,10 +14,10 @@ export class IntegerOutOfRangeError extends BaseError {
     size,
     value,
   }: {
-    max?: string
+    max?: string | undefined
     min: string
-    signed?: boolean
-    size?: number
+    signed?: boolean | undefined
+    size?: number | undefined
     value: string
   }) {
     super(

package/errors/estimateGas.ts

@@ -30,9 +30,9 @@ export class EstimateGasExecutionError extends BaseError {
       to,
       value,
     }: Omit<EstimateGasParameters<any>, 'account'> & {
-      account?: Account
-      chain?: Chain
-      docsPath?: string
+      account?: Account | undefined
+      chain?: Chain | undefined
+      docsPath?: string | undefined
     },
   ) {
     const prettyArgs = prettyPrint({

package/errors/node.ts

@@ -24,7 +24,7 @@ export class ExecutionRevertedError extends BaseError {
   constructor({
     cause,
     message,
-  }: { cause?: BaseError; message?: string } = {}) {
+  }: { cause?: BaseError | undefined; message?: string | undefined } = {}) {
     const reason = message
       ?.replace('execution reverted: ', '')
       ?.replace('execution reverted', '')
@@ -49,7 +49,10 @@ export class FeeCapTooHighError extends BaseError {
   constructor({
     cause,
     maxFeePerGas,
-  }: { cause?: BaseError; maxFeePerGas?: bigint } = {}) {
+  }: {
+    cause?: BaseError | undefined
+    maxFeePerGas?: bigint | undefined
+  } = {}) {
     super(
       `The fee cap (\`maxFeePerGas\`${
         maxFeePerGas ? ` = ${formatGwei(maxFeePerGas)} gwei` : ''
@@ -71,7 +74,10 @@ export class FeeCapTooLowError extends BaseError {
   constructor({
     cause,
     maxFeePerGas,
-  }: { cause?: BaseError; maxFeePerGas?: bigint } = {}) {
+  }: {
+    cause?: BaseError | undefined
+    maxFeePerGas?: bigint | undefined
+  } = {}) {
     super(
       `The fee cap (\`maxFeePerGas\`${
         maxFeePerGas ? ` = ${formatGwei(maxFeePerGas)}` : ''
@@ -89,7 +95,10 @@ export type NonceTooHighErrorType = NonceTooHighError & {
 export class NonceTooHighError extends BaseError {
   static nodeMessage = /nonce too high/
   override name = 'NonceTooHighError'
-  constructor({ cause, nonce }: { cause?: BaseError; nonce?: number } = {}) {
+  constructor({
+    cause,
+    nonce,
+  }: { cause?: BaseError | undefined; nonce?: number | undefined } = {}) {
     super(
       `Nonce provided for the transaction ${
         nonce ? `(${nonce}) ` : ''
@@ -106,7 +115,10 @@ export class NonceTooLowError extends BaseError {
   static nodeMessage =
     /nonce too low|transaction already imported|already known/
   override name = 'NonceTooLowError'
-  constructor({ cause, nonce }: { cause?: BaseError; nonce?: number } = {}) {
+  constructor({
+    cause,
+    nonce,
+  }: { cause?: BaseError | undefined; nonce?: number | undefined } = {}) {
     super(
       [
         `Nonce provided for the transaction ${
@@ -125,7 +137,10 @@ export type NonceMaxValueErrorType = NonceMaxValueError & {
 export class NonceMaxValueError extends BaseError {
   static nodeMessage = /nonce has max value/
   override name = 'NonceMaxValueError'
-  constructor({ cause, nonce }: { cause?: BaseError; nonce?: number } = {}) {
+  constructor({
+    cause,
+    nonce,
+  }: { cause?: BaseError | undefined; nonce?: number | undefined } = {}) {
     super(
       `Nonce provided for the transaction ${
         nonce ? `(${nonce}) ` : ''
@@ -141,7 +156,7 @@ export type InsufficientFundsErrorType = InsufficientFundsError & {
 export class InsufficientFundsError extends BaseError {
   static nodeMessage = /insufficient funds/
   override name = 'InsufficientFundsError'
-  constructor({ cause }: { cause?: BaseError } = {}) {
+  constructor({ cause }: { cause?: BaseError | undefined } = {}) {
     super(
       [
         'The total cost (gas * gas fee + value) of executing this transaction exceeds the balance of the account.',
@@ -169,7 +184,10 @@ export type IntrinsicGasTooHighErrorType = IntrinsicGasTooHighError & {
 export class IntrinsicGasTooHighError extends BaseError {
   static nodeMessage = /intrinsic gas too high|gas limit reached/
   override name = 'IntrinsicGasTooHighError'
-  constructor({ cause, gas }: { cause?: BaseError; gas?: bigint } = {}) {
+  constructor({
+    cause,
+    gas,
+  }: { cause?: BaseError | undefined; gas?: bigint | undefined } = {}) {
     super(
       `The amount of gas ${
         gas ? `(${gas}) ` : ''
@@ -187,7 +205,10 @@ export type IntrinsicGasTooLowErrorType = IntrinsicGasTooLowError & {
 export class IntrinsicGasTooLowError extends BaseError {
   static nodeMessage = /intrinsic gas too low/
   override name = 'IntrinsicGasTooLowError'
-  constructor({ cause, gas }: { cause?: BaseError; gas?: bigint } = {}) {
+  constructor({
+    cause,
+    gas,
+  }: { cause?: BaseError | undefined; gas?: bigint | undefined } = {}) {
     super(
       `The amount of gas ${
         gas ? `(${gas}) ` : ''
@@ -206,7 +227,7 @@ export type TransactionTypeNotSupportedErrorType =
 export class TransactionTypeNotSupportedError extends BaseError {
   static nodeMessage = /transaction type not valid/
   override name = 'TransactionTypeNotSupportedError'
-  constructor({ cause }: { cause?: BaseError }) {
+  constructor({ cause }: { cause?: BaseError | undefined }) {
     super('The transaction type is not supported for this chain.', {
       cause,
     })
@@ -225,9 +246,9 @@ export class TipAboveFeeCapError extends BaseError {
     maxPriorityFeePerGas,
     maxFeePerGas,
   }: {
-    cause?: BaseError
-    maxPriorityFeePerGas?: bigint
-    maxFeePerGas?: bigint
+    cause?: BaseError | undefined
+    maxPriorityFeePerGas?: bigint | undefined
+    maxFeePerGas?: bigint | undefined
   } = {}) {
     super(
       [
@@ -252,7 +273,7 @@ export type UnknownNodeErrorType = UnknownNodeError & {
 export class UnknownNodeError extends BaseError {
   override name = 'UnknownNodeError'
 
-  constructor({ cause }: { cause?: BaseError }) {
+  constructor({ cause }: { cause?: BaseError | undefined }) {
     super(`An error occurred while executing: ${cause?.shortMessage}`, {
       cause,
     })

package/errors/request.ts

@@ -9,9 +9,9 @@ export type HttpRequestErrorType = HttpRequestError & {
 export class HttpRequestError extends BaseError {
   override name = 'HttpRequestError'
 
-  body?: { [x: string]: unknown } | { [y: string]: unknown }[]
-  headers?: Headers
-  status?: number
+  body?: { [x: string]: unknown } | { [y: string]: unknown }[] | undefined
+  headers?: Headers | undefined
+  status?: number | undefined
   url: string
 
   constructor({
@@ -21,10 +21,10 @@ export class HttpRequestError extends BaseError {
     status,
     url,
   }: {
-    body?: { [x: string]: unknown } | { [y: string]: unknown }[]
-    details?: string
-    headers?: Headers
-    status?: number
+    body?: { [x: string]: unknown } | { [y: string]: unknown }[] | undefined
+    details?: string | undefined
+    headers?: Headers | undefined
+    status?: number | undefined
     url: string
   }) {
     super('HTTP request failed.', {

package/errors/rpc.ts

@@ -21,9 +21,9 @@ export type RpcErrorCode =
   | -32042 // Method not found
 
 type RpcErrorOptions<TCode extends number = RpcErrorCode> = {
-  code?: TCode | (number & {})
-  docsPath?: string
-  metaMessages?: string[]
+  code?: TCode | (number & {}) | undefined
+  docsPath?: string | undefined
+  metaMessages?: string[] | undefined
   shortMessage: string
 }
 
@@ -76,13 +76,13 @@ export class ProviderRpcError<
 > extends RpcError<ProviderRpcErrorCode> {
   override name = 'ProviderRpcError'
 
-  data?: T
+  data?: T | undefined
 
   constructor(
     cause: Error,
     options: Prettify<
       RpcErrorOptions<ProviderRpcErrorCode> & {
-        data?: T
+        data?: T | undefined
       }
     >,
   ) {

package/errors/transaction.ts

@@ -165,8 +165,8 @@ export class TransactionExecutionError extends BaseError {
       value,
     }: Omit<SendTransactionParameters, 'account' | 'chain'> & {
       account: Account
-      chain?: Chain
-      docsPath?: string
+      chain?: Chain | undefined
+      docsPath?: string | undefined
     },
   ) {
     const prettyArgs = prettyPrint({
@@ -214,11 +214,11 @@ export class TransactionNotFoundError extends BaseError {
     hash,
     index,
   }: {
-    blockHash?: Hash
-    blockNumber?: bigint
-    blockTag?: BlockTag
-    hash?: Hash
-    index?: number
+    blockHash?: Hash | undefined
+    blockNumber?: bigint | undefined
+    blockTag?: BlockTag | undefined
+    hash?: Hash | undefined
+    index?: number | undefined
   }) {
     let identifier = 'Transaction'
     if (blockTag && index !== undefined)

package/errors/version.ts

@@ -1 +1 @@
-export const version = '2.8.10'
+export const version = '2.8.12'

package/index.ts

@@ -909,6 +909,8 @@ export type {
   TransactionRequestEIP4844,
 } from './types/transaction.js'
 export type {
+  ExactPartial,
+  ExactRequired,
   IsNever,
   OneOf,
   Opaque,

package/package.json

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

package/types/block.ts

@@ -62,14 +62,14 @@ export type Block<
   /** List of uncle hashes */
   uncles: Hash[]
   /** List of withdrawal objects */
-  withdrawals?: Withdrawal[]
+  withdrawals?: Withdrawal[] | undefined
   /** Root of the this block’s withdrawals trie */
-  withdrawalsRoot?: Hex
+  withdrawalsRoot?: Hex | undefined
 }
 
 export type BlockIdentifier<TQuantity = bigint> = {
   /** Whether or not to throw an error if the block is not in the canonical chain as described below. Only allowed in conjunction with the blockHash tag. Defaults to false. */
-  requireCanonical?: boolean
+  requireCanonical?: boolean | undefined
 } & (
   | {
       /** The block in the canonical chain with this number */

package/types/chain.ts

@@ -60,7 +60,7 @@ export type Chain<
   testnet?: boolean | undefined
 
   /** Custom chain data. */
-  custom?: custom
+  custom?: custom | undefined
   /**
    * Modifies how chain data structures (ie. Blocks, Transactions, etc)
    * are formatted & typed.

package/types/contract.ts

@@ -308,11 +308,11 @@ export type GetValue<
   _Narrowable extends boolean = IsNarrowable<TAbi, Abi>,
 > = _Narrowable extends true
   ? TAbiFunction['stateMutability'] extends 'payable'
-    ? { value?: NoUndefined<TValueType> }
+    ? { value?: NoUndefined<TValueType> | undefined }
     : TAbiFunction['payable'] extends true
-      ? { value?: NoUndefined<TValueType> }
-      : { value?: never }
-  : { value?: TValueType }
+      ? { value?: NoUndefined<TValueType> | undefined }
+      : { value?: never | undefined }
+  : { value?: TValueType | undefined }
 
 //////////////////////////////////////////////////////////////////////////////////////////////////
 
@@ -399,7 +399,9 @@ export type AbiEventParametersToPrimitiveTypes<
               name: infer Name extends string
             }
               ? Name
-              : never]?: AbiEventParameterToPrimitiveType<Parameter, Options>
+              : never]?:
+              | AbiEventParameterToPrimitiveType<Parameter, Options>
+              | undefined
           } extends infer Mapped
         ? Prettify<
             MaybeRequired<

package/types/eip1193.ts

@@ -16,7 +16,7 @@ import type {
   RpcTransactionRequest as TransactionRequest,
   RpcUncle as Uncle,
 } from './rpc.js'
-import type { Prettify } from './utils.js'
+import type { ExactPartial, Prettify } from './utils.js'
 
 //////////////////////////////////////////////////
 // Provider
@@ -86,14 +86,16 @@ export type AddEthereumChainParameter = {
   /** The chain name. */
   chainName: string
   /** Native currency for the chain. */
-  nativeCurrency?: {
-    name: string
-    symbol: string
-    decimals: number
-  }
+  nativeCurrency?:
+    | {
+        name: string
+        symbol: string
+        decimals: number
+      }
+    | undefined
   rpcUrls: readonly string[]
-  blockExplorerUrls?: string[]
-  iconUrls?: string[]
+  blockExplorerUrls?: string[] | undefined
+  iconUrls?: string[] | undefined
 }
 
 export type NetworkSync = {
@@ -129,7 +131,7 @@ export type WatchAssetParams = {
     /** The number of token decimals */
     decimals: number
     /** A string url of the token logo */
-    image?: string
+    image?: string | undefined
   }
 }
 
@@ -228,13 +230,13 @@ export type PublicRpcSchema = [
   {
     Method: 'eth_call'
     Parameters:
-      | [transaction: Partial<TransactionRequest>]
+      | [transaction: ExactPartial<TransactionRequest>]
       | [
-          transaction: Partial<TransactionRequest>,
+          transaction: ExactPartial<TransactionRequest>,
           block: BlockNumber | BlockTag | BlockIdentifier,
         ]
       | [
-          transaction: Partial<TransactionRequest>,
+          transaction: ExactPartial<TransactionRequest>,
           block: BlockNumber | BlockTag | BlockIdentifier,
           stateOverrideSet: RpcStateOverride,
         ]
@@ -451,18 +453,18 @@ export type PublicRpcSchema = [
     Method: 'eth_getLogs'
     Parameters: [
       {
-        address?: Address | Address[]
-        topics?: LogTopic[]
+        address?: Address | Address[] | undefined
+        topics?: LogTopic[] | undefined
       } & (
         | {
-            fromBlock?: BlockNumber | BlockTag
-            toBlock?: BlockNumber | BlockTag
-            blockHash?: never
+            fromBlock?: BlockNumber | BlockTag | undefined
+            toBlock?: BlockNumber | BlockTag | undefined
+            blockHash?: never | undefined
           }
         | {
-            fromBlock?: never
-            toBlock?: never
-            blockHash?: Hash
+            fromBlock?: never | undefined
+            toBlock?: never | undefined
+            blockHash?: Hash | undefined
           }
       ),
     ]
@@ -650,10 +652,10 @@ export type PublicRpcSchema = [
     Method: 'eth_newFilter'
     Parameters: [
       filter: {
-        fromBlock?: BlockNumber | BlockTag
-        toBlock?: BlockNumber | BlockTag
-        address?: Address | Address[]
-        topics?: LogTopic[]
+        fromBlock?: BlockNumber | BlockTag | undefined
+        toBlock?: BlockNumber | BlockTag | undefined
+        address?: Address | Address[] | undefined
+        topics?: LogTopic[] | undefined
       },
     ]
     ReturnType: Quantity
@@ -766,7 +768,7 @@ export type TestRpcSchema<TMode extends string> = [
    */
   {
     Method: `${TMode}_loadState`
-    Parameters?: [Hex]
+    Parameters?: [Hex] | undefined
     ReturnType: void
   },
   /**
@@ -1008,7 +1010,7 @@ export type TestRpcSchema<TMode extends string> = [
    */
   {
     Method: 'evm_revert'
-    Parameters?: [id: Quantity]
+    Parameters?: [id: Quantity] | undefined
     ReturnType: void
   },
   /**
@@ -1080,12 +1082,14 @@ export type TestRpcSchema<TMode extends string> = [
    */
   {
     Method: 'evm_mine'
-    Parameters?: [
-      {
-        /** Number of blocks to mine. */
-        blocks: Hex
-      },
-    ]
+    Parameters?:
+      | [
+          {
+            /** Number of blocks to mine. */
+            blocks: Hex
+          },
+        ]
+      | undefined
     ReturnType: void
   },
   /**
@@ -1321,7 +1325,7 @@ export type WalletRpcSchema = [
 
 export type RpcSchema = readonly {
   Method: string
-  Parameters?: unknown
+  Parameters?: unknown | undefined
   ReturnType: unknown
 }[]
 
@@ -1338,21 +1342,21 @@ export type EIP1193Parameters<
             : never
         } & (TRpcSchema[K] extends TRpcSchema[number]
           ? TRpcSchema[K]['Parameters'] extends undefined
-            ? { params?: never }
+            ? { params?: never | undefined }
             : { params: TRpcSchema[K]['Parameters'] }
           : never)
       >
     }[number]
   : {
       method: string
-      params?: unknown
+      params?: unknown | undefined
     }
 
 export type EIP1193RequestOptions = {
   // The base delay (in ms) between retries.
-  retryDelay?: number
+  retryDelay?: number | undefined
   // The max number of times to retry.
-  retryCount?: number
+  retryCount?: number | undefined
 }
 
 type DerivedRpcSchema<
@@ -1380,5 +1384,5 @@ export type EIP1193RequestFn<
     : unknown,
 >(
   args: TParameters,
-  options?: EIP1193RequestOptions,
+  options?: EIP1193RequestOptions | undefined,
 ) => Promise<_ReturnType>

package/types/ens.ts

@@ -1,5 +1,5 @@
 export type AssetGateway = 'ipfs' | 'arweave'
 
 export type AssetGatewayUrls = {
-  [_key in AssetGateway]?: string
+  [_key in AssetGateway]?: string | undefined
 }

package/types/fee.ts

@@ -11,20 +11,20 @@ export type FeeHistory<TQuantity = bigint> = {
   /** Lowest number block of the returned range. */
   oldestBlock: TQuantity
   /** An array of effective priority fees (in wei) per gas data points from a single block. All zeroes are returned if the block is empty. */
-  reward?: TQuantity[][]
+  reward?: TQuantity[][] | undefined
 }
 
 export type FeeValuesLegacy<TQuantity = bigint> = {
   /** Base fee per gas. */
   gasPrice: TQuantity
-  maxFeePerBlobGas?: never
-  maxFeePerGas?: never
-  maxPriorityFeePerGas?: never
+  maxFeePerBlobGas?: never | undefined
+  maxFeePerGas?: never | undefined
+  maxPriorityFeePerGas?: never | undefined
 }
 
 export type FeeValuesEIP1559<TQuantity = bigint> = {
-  gasPrice?: never
-  maxFeePerBlobGas?: never
+  gasPrice?: never | undefined
+  maxFeePerBlobGas?: never | undefined
   /** Total fee per gas in wei (gasPrice/baseFeePerGas + maxPriorityFeePerGas). */
   maxFeePerGas: TQuantity
   /** Max priority fee per gas (in wei). */

package/types/filter.ts

@@ -31,14 +31,14 @@ export type Filter<
   type: TFilterType
 } & (TFilterType extends 'event'
   ? {
-      fromBlock?: TFromBlock
-      toBlock?: TToBlock
+      fromBlock?: TFromBlock | undefined
+      toBlock?: TToBlock | undefined
     } & (TAbi extends Abi
       ? undefined extends TEventName
         ? {
             abi: TAbi
-            args?: never
-            eventName?: never
+            args?: never | undefined
+            eventName?: never | undefined
             strict: TStrict
           }
         : TArgs extends MaybeExtractEventArgsFromAbi<TAbi, TEventName>
@@ -50,14 +50,14 @@ export type Filter<
             }
           : {
               abi: TAbi
-              args?: never
+              args?: never | undefined
               eventName: TEventName
               strict: TStrict
             }
       : {
-          abi?: never
-          args?: never
-          eventName?: never
-          strict?: never
+          abi?: never | undefined
+          args?: never | undefined
+          eventName?: never | undefined
+          strict?: never | undefined
         })
   : {})

package/types/kzg.ts

@@ -21,7 +21,7 @@ export type GetTransactionRequestKzgParameter<
 > = MaybeRequired<
   {
     /** KZG implementation */
-    kzg?: Kzg
+    kzg?: Kzg | undefined
   },
   request extends {
     account: LocalAccount<string, Address>