viem 2.37.10 → 2.37.12

package/actions/public/getBlock.ts

@@ -128,5 +128,5 @@ export async function getBlock<
   if (!block) throw new BlockNotFoundError({ blockHash, blockNumber })
 
   const format = client.chain?.formatters?.block?.format || formatBlock
-  return format(block)
+  return format(block, 'getBlock')
 }

package/actions/public/getTransaction.ts

@@ -148,5 +148,5 @@ export async function getTransaction<
 
   const format =
     client.chain?.formatters?.transaction?.format || formatTransaction
-  return format(transaction)
+  return format(transaction, 'getTransaction')
 }

package/actions/public/getTransactionReceipt.ts

@@ -68,5 +68,8 @@ export async function getTransactionReceipt<chain extends Chain | undefined>(
   const format =
     client.chain?.formatters?.transactionReceipt?.format ||
     formatTransactionReceipt
-  return format(receipt) as GetTransactionReceiptReturnType<chain>
+  return format(
+    receipt,
+    'getTransactionReceipt',
+  ) as GetTransactionReceiptReturnType<chain>
 }

package/actions/test/sendUnsignedTransaction.ts

@@ -72,20 +72,23 @@ export async function sendUnsignedTransaction<
   const chainFormat = client.chain?.formatters?.transactionRequest?.format
   const format = chainFormat || formatTransactionRequest
 
-  const request = format({
-    // Pick out extra data that might exist on the chain's transaction request type.
-    ...extract(rest, { format: chainFormat }),
-    accessList,
-    data,
-    from,
-    gas,
-    gasPrice,
-    maxFeePerGas,
-    maxPriorityFeePerGas,
-    nonce,
-    to,
-    value,
-  } as TransactionRequest)
+  const request = format(
+    {
+      // Pick out extra data that might exist on the chain's transaction request type.
+      ...extract(rest, { format: chainFormat }),
+      accessList,
+      data,
+      from,
+      gas,
+      gasPrice,
+      maxFeePerGas,
+      maxPriorityFeePerGas,
+      nonce,
+      to,
+      value,
+    } as TransactionRequest,
+    'sendUnsignedTransaction',
+  )
   const hash = await client.request({
     method: 'eth_sendUnsignedTransaction',
     params: [request],

package/actions/wallet/sendTransaction.ts

@@ -219,25 +219,28 @@ export async function sendTransaction<
       const chainFormat = client.chain?.formatters?.transactionRequest?.format
       const format = chainFormat || formatTransactionRequest
 
-      const request = format({
-        // Pick out extra data that might exist on the chain's transaction request type.
-        ...extract(rest, { format: chainFormat }),
-        accessList,
-        authorizationList,
-        blobs,
-        chainId,
-        data,
-        from: account?.address,
-        gas,
-        gasPrice,
-        maxFeePerBlobGas,
-        maxFeePerGas,
-        maxPriorityFeePerGas,
-        nonce,
-        to,
-        type,
-        value,
-      } as TransactionRequest)
+      const request = format(
+        {
+          // Pick out extra data that might exist on the chain's transaction request type.
+          ...extract(rest, { format: chainFormat }),
+          accessList,
+          authorizationList,
+          blobs,
+          chainId,
+          data,
+          from: account?.address,
+          gas,
+          gasPrice,
+          maxFeePerBlobGas,
+          maxFeePerGas,
+          maxPriorityFeePerGas,
+          nonce,
+          to,
+          type,
+          value,
+        } as TransactionRequest,
+        'sendTransaction',
+      )
 
       const isWalletNamespaceSupported = supportsWalletNamespace.get(client.uid)
       const method = isWalletNamespaceSupported

package/actions/wallet/signTransaction.ts

@@ -172,7 +172,10 @@ export async function signTransaction<
       method: 'eth_signTransaction',
       params: [
         {
-          ...format(transaction as unknown as TransactionRequest),
+          ...format(
+            transaction as unknown as TransactionRequest,
+            'signTransaction',
+          ),
           chainId: numberToHex(chainId),
           from: account.address,
         } as unknown as RpcTransactionRequest,

package/errors/version.ts

@@ -1 +1 @@
-export const version = '2.37.10'
+export const version = '2.37.12'

package/linea/actions/estimateGas.ts

@@ -89,20 +89,23 @@ export async function estimateGas<
     const chainFormat = client.chain?.formatters?.transactionRequest?.format
     const format = chainFormat || formatTransactionRequest
 
-    const request = format({
-      // Pick out extra data that might exist on the chain's transaction request type.
-      ...extract(rest, { format: chainFormat }),
-      from: account?.address,
-      accessList,
-      data,
-      gas,
-      gasPrice,
-      maxFeePerGas,
-      maxPriorityFeePerGas,
-      nonce,
-      to,
-      value,
-    } as TransactionRequest)
+    const request = format(
+      {
+        // Pick out extra data that might exist on the chain's transaction request type.
+        ...extract(rest, { format: chainFormat }),
+        from: account?.address,
+        accessList,
+        data,
+        gas,
+        gasPrice,
+        maxFeePerGas,
+        maxPriorityFeePerGas,
+        nonce,
+        to,
+        value,
+      } as TransactionRequest,
+      'estimateGas',
+    )
 
     type LineaEstimateGasSchema = Filter<
       LineaRpcSchema,

package/package.json

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

package/types/chain.ts

@@ -185,7 +185,7 @@ export type ChainFormatters = {
 }
 
 export type ChainFormatter<type extends string = string> = {
-  format: (args: any) => any
+  format: (args: any, action?: string | undefined) => any
   type: type
 }
 

package/types/transaction.ts

@@ -259,14 +259,20 @@ export type TransactionRequestEIP4844<
   index = number,
   type = 'eip4844',
 > = RequiredBy<TransactionRequestBase<quantity, index, type>, 'to'> &
-  RequiredBy<ExactPartial<FeeValuesEIP4844<quantity>>, 'maxFeePerBlobGas'> & {
+  ExactPartial<FeeValuesEIP4844<quantity>> & {
     accessList?: AccessList | undefined
-    /** The blobs associated with this transaction. */
-    blobs: readonly Hex[] | readonly ByteArray[]
-    blobVersionedHashes?: readonly Hex[] | undefined
-    kzg?: Kzg | undefined
     sidecars?: readonly BlobSidecar<Hex>[] | undefined
-  }
+  } & OneOf<
+    | {
+        blobs?: readonly Hex[] | readonly ByteArray[] | undefined
+        blobVersionedHashes: readonly Hex[]
+      }
+    | {
+        blobs: readonly Hex[] | readonly ByteArray[]
+        blobVersionedHashes?: readonly Hex[] | undefined
+        kzg?: Kzg | undefined
+      }
+  >
 
 export type TransactionRequestEIP7702<
   quantity = bigint,
@@ -360,11 +366,15 @@ export type TransactionSerializableEIP1559<
 export type TransactionSerializableEIP4844<
   quantity = bigint,
   index = number,
-> = TransactionSerializableBase<quantity, index> &
+  nullableSidecars extends boolean = boolean,
+> = RequiredBy<TransactionSerializableBase<quantity, index>, 'to'> &
   ExactPartial<FeeValuesEIP4844<quantity>> & {
     accessList?: AccessList | undefined
     chainId: number
-    sidecars?: readonly BlobSidecar<Hex>[] | false | undefined
+    sidecars?:
+      | readonly BlobSidecar<Hex>[]
+      | (nullableSidecars extends true ? false : never)
+      | undefined
     type?: 'eip4844' | undefined
     yParity?: number | undefined
   } & OneOf<

package/utils/formatters/block.ts

@@ -40,7 +40,10 @@ export type FormattedBlock<
 
 export type FormatBlockErrorType = ErrorType
 
-export function formatBlock(block: ExactPartial<RpcBlock>) {
+export function formatBlock(
+  block: ExactPartial<RpcBlock>,
+  _?: string | undefined,
+) {
   const transactions = (block.transactions ?? []).map((transaction) => {
     if (typeof transaction === 'string') return transaction
     return formatTransaction(transaction)

package/utils/formatters/formatter.ts

@@ -5,7 +5,7 @@ export type DefineFormatterErrorType = ErrorType
 
 export function defineFormatter<type extends string, parameters, returnType>(
   type: type,
-  format: (_: parameters) => returnType,
+  format: (args: parameters, action?: string | undefined) => returnType,
 ) {
   return <
     parametersOverride,
@@ -16,12 +16,15 @@ export function defineFormatter<type extends string, parameters, returnType>(
     format: overrides,
   }: {
     exclude?: exclude | undefined
-    format: (_: parametersOverride) => returnTypeOverride
+    format: (
+      args: parametersOverride,
+      action?: string | undefined,
+    ) => returnTypeOverride
   }) => {
     return {
       exclude,
-      format: (args: parametersOverride) => {
-        const formatted = format(args as any)
+      format: (args: parametersOverride, action?: string | undefined) => {
+        const formatted = format(args as any, action)
         if (exclude) {
           for (const key of exclude) {
             delete (formatted as any)[key]
@@ -29,7 +32,7 @@ export function defineFormatter<type extends string, parameters, returnType>(
         }
         return {
           ...formatted,
-          ...overrides(args),
+          ...overrides(args, action),
         } as Prettify<returnTypeOverride> & {
           [_key in exclude[number]]: never
         }

package/utils/formatters/transaction.ts

@@ -45,7 +45,10 @@ export const transactionType = {
 
 export type FormatTransactionErrorType = ErrorType
 
-export function formatTransaction(transaction: ExactPartial<RpcTransaction>) {
+export function formatTransaction(
+  transaction: ExactPartial<RpcTransaction>,
+  _?: string | undefined,
+) {
   const transaction_ = {
     ...transaction,
     blockHash: transaction.blockHash ? transaction.blockHash : null,

package/utils/formatters/transactionReceipt.ts

@@ -29,6 +29,7 @@ export type FormatTransactionReceiptErrorType = ErrorType
 
 export function formatTransactionReceipt(
   transactionReceipt: ExactPartial<RpcTransactionReceipt>,
+  _?: string | undefined,
 ) {
   const receipt = {
     ...transactionReceipt,

package/utils/formatters/transactionRequest.ts

@@ -34,6 +34,7 @@ export type FormatTransactionRequestErrorType = ErrorType
 
 export function formatTransactionRequest(
   request: ExactPartial<TransactionRequest>,
+  _?: string | undefined,
 ) {
   const rpcRequest = {} as RpcTransactionRequest
 

package/utils/transaction/parseTransaction.ts

@@ -73,7 +73,9 @@ export type ParseTransactionReturnType<
   ?
       | (type extends 'eip1559' ? TransactionSerializableEIP1559 : never)
       | (type extends 'eip2930' ? TransactionSerializableEIP2930 : never)
-      | (type extends 'eip4844' ? TransactionSerializableEIP4844 : never)
+      | (type extends 'eip4844'
+          ? TransactionSerializableEIP4844<bigint, number, false>
+          : never)
       | (type extends 'eip7702' ? TransactionSerializableEIP7702 : never)
       | (type extends 'legacy' ? TransactionSerializableLegacy : never)
   : TransactionSerializable
@@ -276,9 +278,9 @@ function parseTransactionEIP4844(
   const transaction = {
     blobVersionedHashes: blobVersionedHashes as Hex[],
     chainId: hexToNumber(chainId as Hex),
+    to,
     type: 'eip4844',
   } as TransactionSerializableEIP4844
-  if (isHex(to) && to !== '0x') transaction.to = to
   if (isHex(gas) && gas !== '0x') transaction.gas = hexToBigInt(gas)
   if (isHex(data) && data !== '0x') transaction.data = data
   if (isHex(nonce)) transaction.nonce = nonce === '0x' ? 0 : hexToNumber(nonce)

package/utils/transaction/serializeTransaction.ts

@@ -25,7 +25,7 @@ import type {
   TransactionSerializedLegacy,
   TransactionType,
 } from '../../types/transaction.js'
-import type { OneOf } from '../../types/utils.js'
+import type { MaybePromise, OneOf } from '../../types/utils.js'
 import {
   type SerializeAuthorizationListErrorType,
   serializeAuthorizationList,
@@ -87,9 +87,14 @@ export type SerializeTransactionFn<
   transaction extends TransactionSerializableGeneric = TransactionSerializable,
   ///
   _transactionType extends TransactionType = never,
-> = typeof serializeTransaction<
-  OneOf<TransactionSerializable | transaction>,
-  _transactionType
+> = (
+  transaction: OneOf<TransactionSerializable | transaction>,
+  signature?: Signature | undefined,
+) => MaybePromise<
+  SerializedTransactionReturnType<
+    OneOf<TransactionSerializable | transaction>,
+    _transactionType
+  >
 >
 
 export type SerializeTransactionErrorType =

package/zksync/actions/estimateFee.ts

@@ -27,10 +27,13 @@ export async function estimateFee<
   const account = account_ ? parseAccount(account_) : client.account
 
   const formatters = client.chain?.formatters
-  const formatted = formatters?.transactionRequest?.format({
-    ...request,
-    from: account?.address,
-  })
+  const formatted = formatters?.transactionRequest?.format(
+    {
+      ...request,
+      from: account?.address,
+    },
+    'estimateFee',
+  )
 
   const result = await client.request({
     method: 'zks_estimateFee',

package/zksync/actions/estimateGasL1ToL2.ts

@@ -24,10 +24,13 @@ export async function estimateGasL1ToL2<
   const account = account_ ? parseAccount(account_) : client.account
 
   const formatters = client.chain?.formatters
-  const formatted = formatters?.transactionRequest?.format({
-    ...request,
-    from: account?.address,
-  })
+  const formatted = formatters?.transactionRequest?.format(
+    {
+      ...request,
+      from: account?.address,
+    },
+    'estimateGasL1ToL2',
+  )
 
   const result = await client.request({
     method: 'zks_estimateGasL1ToL2',