viem 2.37.11 → 2.37.13

package/actions/public/call.ts

@@ -226,23 +226,26 @@ export async function call<chain extends Chain | undefined>(
     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,
-      authorizationList,
-      blobs,
-      data,
-      gas,
-      gasPrice,
-      maxFeePerBlobGas,
-      maxFeePerGas,
-      maxPriorityFeePerGas,
-      nonce,
-      to: deploylessCall ? undefined : to,
-      value,
-    } as TransactionRequest) 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,
+        authorizationList,
+        blobs,
+        data,
+        gas,
+        gasPrice,
+        maxFeePerBlobGas,
+        maxFeePerGas,
+        maxPriorityFeePerGas,
+        nonce,
+        to: deploylessCall ? undefined : to,
+        value,
+      } as TransactionRequest,
+      'call',
+    ) as TransactionRequest
 
     if (
       batch &&

package/actions/public/createAccessList.ts

@@ -127,20 +127,23 @@ export async function createAccessList<chain extends Chain | undefined>(
     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,
-      blobs,
-      data,
-      gas,
-      gasPrice,
-      maxFeePerBlobGas,
-      maxFeePerGas,
-      maxPriorityFeePerGas,
-      to,
-      value,
-    } as TransactionRequest) 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,
+        blobs,
+        data,
+        gas,
+        gasPrice,
+        maxFeePerBlobGas,
+        maxFeePerGas,
+        maxPriorityFeePerGas,
+        to,
+        value,
+      } as TransactionRequest,
+      'createAccessList',
+    ) as TransactionRequest
 
     const response = await client.request({
       method: 'eth_createAccessList',

package/actions/public/estimateGas.ts

@@ -165,24 +165,27 @@ 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,
-      authorizationList,
-      blobs,
-      blobVersionedHashes,
-      data,
-      gas,
-      gasPrice,
-      maxFeePerBlobGas,
-      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,
+        authorizationList,
+        blobs,
+        blobVersionedHashes,
+        data,
+        gas,
+        gasPrice,
+        maxFeePerBlobGas,
+        maxFeePerGas,
+        maxPriorityFeePerGas,
+        nonce,
+        to,
+        value,
+      } as TransactionRequest,
+      'estimateGas',
+    )
 
     return BigInt(
       await client.request({

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/chains/definitions/domaTestnet.ts

@@ -0,0 +1,21 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+
+export const domaTestnet = /*#__PURE__*/ defineChain({
+  id: 97_476,
+  name: 'Doma Testnet',
+  nativeCurrency: {
+    decimals: 18,
+    name: 'Ether',
+    symbol: 'ETH',
+  },
+  rpcUrls: {
+    default: { http: ['https://rpc-testnet.doma.xyz'] },
+  },
+  blockExplorers: {
+    default: {
+      name: 'Doma Testnet Explorer',
+      url: 'https://explorer-testnet.doma.xyz',
+    },
+  },
+  testnet: true,
+})

package/chains/definitions/nitrographTestnet.ts

@@ -0,0 +1,23 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+
+export const nitrographTestnet = /*#__PURE__*/ defineChain({
+  id: 200024,
+  name: 'Nitrograph Testnet',
+  testnet: true,
+  rpcUrls: {
+    default: {
+      http: ['https://rpc-testnet.nitrograph.foundation'],
+    },
+  },
+  nativeCurrency: {
+    name: 'Nitro',
+    symbol: 'NOS',
+    decimals: 18,
+  },
+  blockExplorers: {
+    default: {
+      url: 'https://explorer-testnet.nitrograph.foundation',
+      name: 'Nitrograph Explorer',
+    },
+  },
+})

package/chains/definitions/tronNile.ts

@@ -0,0 +1,19 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+
+export const tronNile = /*#__PURE__*/ defineChain({
+  id: 3448148188,
+  name: 'Tron Nile',
+  nativeCurrency: { name: 'TRON', symbol: 'TRX', decimals: 6 },
+  rpcUrls: {
+    default: {
+      http: ['https://nile.trongrid.io/jsonrpc'],
+    },
+  },
+  blockExplorers: {
+    default: {
+      name: 'Tronscan',
+      url: 'https://nile.tronscan.org',
+    },
+  },
+  testnet: true,
+})

package/chains/index.ts

@@ -100,6 +100,7 @@ export { bxnTestnet } from './definitions/bxnTestnet.js'
 export { cannon } from './definitions/cannon.js'
 export { canto } from './definitions/canto.js'
 export { celo } from './definitions/celo.js'
+/** @deprecated use `celoSepolia` instead */
 export { celoAlfajores } from './definitions/celoAlfajores.js'
 export { celoSepolia } from './definitions/celoSepolia.js'
 export { chang } from './definitions/chang.js'
@@ -144,6 +145,7 @@ export { diode } from './definitions/diode.js'
 export { disChain } from './definitions/disChain.js'
 export { dodochainTestnet } from './definitions/dodochainTestnet.js'
 export { dogechain } from './definitions/dogechain.js'
+export { domaTestnet } from './definitions/domaTestnet.js'
 export { donatuz } from './definitions/donatuz.js'
 export { dosChain } from './definitions/dosChain.js'
 export { dosChainTestnet } from './definitions/dosChainTestnet.js'
@@ -400,6 +402,7 @@ export { newton } from './definitions/newton.js'
 export { nexi } from './definitions/nexi.js'
 export { nexilix } from './definitions/nexilix.js'
 export { nibiru } from './definitions/nibiru.js'
+export { nitrographTestnet } from './definitions/nitrographTestnet.js'
 export { oasisTestnet } from './definitions/oasisTestnet.js'
 export { oasys } from './definitions/oasys.js'
 export { odysseyTestnet } from './definitions/odysseyTestnet.js'
@@ -589,6 +592,7 @@ export { tomb } from './definitions/tomb.js'
 export { treasure } from './definitions/treasure.js'
 export { treasureTopaz } from './definitions/treasureTopaz.js'
 export { tron } from './definitions/tron.js'
+export { tronNile } from './definitions/tronNile.js'
 export { tronShasta } from './definitions/tronShasta.js'
 export { ubiq } from './definitions/ubiq.js'
 export { ultra } from './definitions/ultra.js'

package/errors/version.ts

@@ -1 +1 @@
-export const version = '2.37.11'
+export const version = '2.37.13'

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.11",
+  "version": "2.37.13",
   "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/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',