viem 2.49.3 → 2.50.4

package/actions/public/getCode.ts

@@ -5,12 +5,12 @@ import type { Transport } from '../../clients/transports/createTransport.js'
 import type { ErrorType } from '../../errors/utils.js'
 import type { BlockTag } from '../../types/block.js'
 import type { Chain } from '../../types/chain.js'
-import type { Hex } from '../../types/misc.js'
-import type { RequestErrorType } from '../../utils/buildRequest.js'
+import type { Hash, Hex } from '../../types/misc.js'
 import {
-  type NumberToHexErrorType,
-  numberToHex,
-} from '../../utils/encoding/toHex.js'
+  type FormatBlockParameterErrorType,
+  formatBlockParameter,
+} from '../../utils/block/formatBlockParameter.js'
+import type { RequestErrorType } from '../../utils/buildRequest.js'
 
 export type GetCodeParameters = {
   address: Address
@@ -18,17 +18,29 @@ export type GetCodeParameters = {
   | {
       blockNumber?: undefined
       blockTag?: BlockTag | undefined
+      blockHash?: undefined
+      requireCanonical?: undefined
     }
   | {
       blockNumber?: bigint | undefined
       blockTag?: undefined
+      blockHash?: undefined
+      requireCanonical?: undefined
+    }
+  | {
+      blockNumber?: undefined
+      blockTag?: undefined
+      /** The bytecode at a block specified by block hash. */
+      blockHash: Hash
+      /** Whether or not to throw an error if the block is not in the canonical chain. Only allowed in conjunction with `blockHash`. */
+      requireCanonical?: boolean | undefined
     }
 )
 
 export type GetCodeReturnType = Hex | undefined
 
 export type GetCodeErrorType =
-  | NumberToHexErrorType
+  | FormatBlockParameterErrorType
   | RequestErrorType
   | ErrorType
 
@@ -57,16 +69,28 @@ export type GetCodeErrorType =
  */
 export async function getCode<chain extends Chain | undefined>(
   client: Client<Transport, chain>,
-  { address, blockNumber, blockTag = 'latest' }: GetCodeParameters,
+  {
+    address,
+    blockHash,
+    blockNumber,
+    blockTag = 'latest',
+    requireCanonical,
+  }: GetCodeParameters,
 ): Promise<GetCodeReturnType> {
-  const blockNumberHex =
-    blockNumber !== undefined ? numberToHex(blockNumber) : undefined
+  const block = formatBlockParameter({
+    blockHash,
+    blockNumber,
+    blockTag,
+    requireCanonical,
+  })
   const hex = await client.request(
     {
       method: 'eth_getCode',
-      params: [address, blockNumberHex || blockTag],
+      params: [address, block],
+    },
+    {
+      dedupe: typeof blockNumber === 'bigint' || blockHash !== undefined,
     },
-    { dedupe: Boolean(blockNumberHex) },
   )
   if (hex === '0x') return undefined
   return hex

package/actions/public/getProof.ts

@@ -6,11 +6,11 @@ import type { BlockTag } from '../../types/block.js'
 import type { Chain } from '../../types/chain.js'
 import type { Hash } from '../../types/misc.js'
 import type { Proof } from '../../types/proof.js'
-import type { RequestErrorType } from '../../utils/buildRequest.js'
 import {
-  type NumberToHexErrorType,
-  numberToHex,
-} from '../../utils/encoding/toHex.js'
+  type FormatBlockParameterErrorType,
+  formatBlockParameter,
+} from '../../utils/block/formatBlockParameter.js'
+import type { RequestErrorType } from '../../utils/buildRequest.js'
 import {
   type FormatProofErrorType,
   formatProof,
@@ -26,6 +26,8 @@ export type GetProofParameters = {
       /** The block number. */
       blockNumber?: bigint | undefined
       blockTag?: undefined
+      blockHash?: undefined
+      requireCanonical?: undefined
     }
   | {
       blockNumber?: undefined
@@ -34,13 +36,23 @@ export type GetProofParameters = {
        * @default 'latest'
        */
       blockTag?: BlockTag | undefined
+      blockHash?: undefined
+      requireCanonical?: undefined
+    }
+  | {
+      blockNumber?: undefined
+      blockTag?: undefined
+      /** The proof at a block specified by block hash. */
+      blockHash: Hash
+      /** Whether or not to throw an error if the block is not in the canonical chain. Only allowed in conjunction with `blockHash`. */
+      requireCanonical?: boolean | undefined
     }
 )
 
 export type GetProofReturnType = Proof
 
 export type GetProofErrorType =
-  | NumberToHexErrorType
+  | FormatBlockParameterErrorType
   | FormatProofErrorType
   | RequestErrorType
   | ErrorType
@@ -74,19 +86,23 @@ export async function getProof<chain extends Chain | undefined>(
   client: Client<Transport, chain>,
   {
     address,
+    blockHash,
     blockNumber,
-    blockTag: blockTag_,
+    blockTag = 'latest',
+    requireCanonical,
     storageKeys,
   }: GetProofParameters,
 ): Promise<GetProofReturnType> {
-  const blockTag = blockTag_ ?? 'latest'
-
-  const blockNumberHex =
-    blockNumber !== undefined ? numberToHex(blockNumber) : undefined
+  const block = formatBlockParameter({
+    blockHash,
+    blockNumber,
+    blockTag,
+    requireCanonical,
+  })
 
   const proof = await client.request({
     method: 'eth_getProof',
-    params: [address, storageKeys, blockNumberHex || blockTag],
+    params: [address, storageKeys, block],
   })
 
   return formatProof(proof)

package/actions/public/getStorageAt.ts

@@ -5,12 +5,12 @@ import type { Transport } from '../../clients/transports/createTransport.js'
 import type { ErrorType } from '../../errors/utils.js'
 import type { BlockTag } from '../../types/block.js'
 import type { Chain } from '../../types/chain.js'
-import type { Hex } from '../../types/misc.js'
-import type { RequestErrorType } from '../../utils/buildRequest.js'
+import type { Hash, Hex } from '../../types/misc.js'
 import {
-  type NumberToHexErrorType,
-  numberToHex,
-} from '../../utils/encoding/toHex.js'
+  type FormatBlockParameterErrorType,
+  formatBlockParameter,
+} from '../../utils/block/formatBlockParameter.js'
+import type { RequestErrorType } from '../../utils/buildRequest.js'
 
 export type GetStorageAtParameters = {
   address: Address
@@ -19,17 +19,29 @@ export type GetStorageAtParameters = {
   | {
       blockNumber?: undefined
       blockTag?: BlockTag | undefined
+      blockHash?: undefined
+      requireCanonical?: undefined
     }
   | {
       blockNumber?: bigint | undefined
       blockTag?: undefined
+      blockHash?: undefined
+      requireCanonical?: undefined
+    }
+  | {
+      blockNumber?: undefined
+      blockTag?: undefined
+      /** The storage value at a block specified by block hash. */
+      blockHash: Hash
+      /** Whether or not to throw an error if the block is not in the canonical chain. Only allowed in conjunction with `blockHash`. */
+      requireCanonical?: boolean | undefined
     }
 )
 
 export type GetStorageAtReturnType = Hex | undefined
 
 export type GetStorageAtErrorType =
-  | NumberToHexErrorType
+  | FormatBlockParameterErrorType
   | RequestErrorType
   | ErrorType
 
@@ -59,13 +71,24 @@ export type GetStorageAtErrorType =
  */
 export async function getStorageAt<chain extends Chain | undefined>(
   client: Client<Transport, chain>,
-  { address, blockNumber, blockTag = 'latest', slot }: GetStorageAtParameters,
+  {
+    address,
+    blockHash,
+    blockNumber,
+    blockTag = 'latest',
+    requireCanonical,
+    slot,
+  }: GetStorageAtParameters,
 ): Promise<GetStorageAtReturnType> {
-  const blockNumberHex =
-    blockNumber !== undefined ? numberToHex(blockNumber) : undefined
+  const block = formatBlockParameter({
+    blockHash,
+    blockNumber,
+    blockTag,
+    requireCanonical,
+  })
   const data = await client.request({
     method: 'eth_getStorageAt',
-    params: [address, slot, blockNumberHex || blockTag],
+    params: [address, slot, block],
   })
   return data
 }

package/actions/public/getTransactionCount.ts

@@ -6,15 +6,16 @@ import type { Transport } from '../../clients/transports/createTransport.js'
 import type { ErrorType } from '../../errors/utils.js'
 import type { BlockTag } from '../../types/block.js'
 import type { Chain } from '../../types/chain.js'
+import type { Hash } from '../../types/misc.js'
+import {
+  type FormatBlockParameterErrorType,
+  formatBlockParameter,
+} from '../../utils/block/formatBlockParameter.js'
 import type { RequestErrorType } from '../../utils/buildRequest.js'
 import {
   type HexToNumberErrorType,
   hexToNumber,
 } from '../../utils/encoding/fromHex.js'
-import {
-  type NumberToHexErrorType,
-  numberToHex,
-} from '../../utils/encoding/toHex.js'
 
 export type GetTransactionCountParameters = {
   /** The account address. */
@@ -24,18 +25,30 @@ export type GetTransactionCountParameters = {
       /** The block number. */
       blockNumber?: bigint | undefined
       blockTag?: undefined
+      blockHash?: undefined
+      requireCanonical?: undefined
     }
   | {
       blockNumber?: undefined
       /** The block tag. Defaults to 'latest'. */
       blockTag?: BlockTag | undefined
+      blockHash?: undefined
+      requireCanonical?: undefined
+    }
+  | {
+      blockNumber?: undefined
+      blockTag?: undefined
+      /** The transaction count at a block specified by block hash. */
+      blockHash: Hash
+      /** Whether or not to throw an error if the block is not in the canonical chain. Only allowed in conjunction with `blockHash`. */
+      requireCanonical?: boolean | undefined
     }
 )
 export type GetTransactionCountReturnType = number
 
 export type GetTransactionCountErrorType =
   | RequestErrorType
-  | NumberToHexErrorType
+  | FormatBlockParameterErrorType
   | HexToNumberErrorType
   | ErrorType
 
@@ -67,18 +80,27 @@ export async function getTransactionCount<
   account extends Account | undefined,
 >(
   client: Client<Transport, chain, account>,
-  { address, blockTag = 'latest', blockNumber }: GetTransactionCountParameters,
+  {
+    address,
+    blockHash,
+    blockNumber,
+    blockTag = 'latest',
+    requireCanonical,
+  }: GetTransactionCountParameters,
 ): Promise<GetTransactionCountReturnType> {
+  const block = formatBlockParameter({
+    blockHash,
+    blockNumber,
+    blockTag,
+    requireCanonical,
+  })
   const count = await client.request(
     {
       method: 'eth_getTransactionCount',
-      params: [
-        address,
-        typeof blockNumber === 'bigint' ? numberToHex(blockNumber) : blockTag,
-      ],
+      params: [address, block],
     },
     {
-      dedupe: Boolean(blockNumber),
+      dedupe: typeof blockNumber === 'bigint' || blockHash !== undefined,
     },
   )
   return hexToNumber(count)

package/actions/public/multicall.ts

@@ -45,9 +45,11 @@ export type MulticallParameters<
 > = Pick<
   CallParameters,
   | 'authorizationList'
+  | 'blockHash'
   | 'blockNumber'
   | 'blockOverrides'
   | 'blockTag'
+  | 'requireCanonical'
   | 'stateOverride'
 > & {
   /** The account to use for the multicall. */
@@ -138,9 +140,11 @@ export async function multicall<
     account,
     authorizationList,
     allowFailure = true,
+    blockHash,
     blockNumber,
     blockOverrides,
     blockTag,
+    requireCanonical,
     stateOverride,
   } = parameters
   const contracts = parameters.contracts as ContractFunctionParameters[]
@@ -237,10 +241,12 @@ export async function multicall<
         account,
         args: [calls],
         authorizationList,
+        blockHash,
         blockNumber,
         blockOverrides,
         blockTag,
         functionName: 'aggregate3',
+        requireCanonical,
         stateOverride,
       }),
     ),

package/actions/public/readContract.ts

@@ -44,11 +44,13 @@ export type ReadContractParameters<
     CallParameters,
     | 'account'
     | 'authorizationList'
+    | 'blockHash'
     | 'blockNumber'
     | 'blockOverrides'
     | 'blockTag'
     | 'factory'
     | 'factoryData'
+    | 'requireCanonical'
     | 'stateOverride'
   >
 > &

package/actions/wallet/prepareTransactionRequest.ts

@@ -38,15 +38,7 @@ import type {
   GetChainParameter,
 } from '../../types/chain.js'
 import type { GetTransactionRequestKzgParameter } from '../../types/kzg.js'
-import type {
-  TransactionRequest,
-  TransactionRequestEIP1559,
-  TransactionRequestEIP2930,
-  TransactionRequestEIP4844,
-  TransactionRequestEIP7702,
-  TransactionRequestLegacy,
-  TransactionSerializable,
-} from '../../types/transaction.js'
+import type { TransactionSerializable } from '../../types/transaction.js'
 import type {
   ExactPartial,
   IsNever,
@@ -106,6 +98,12 @@ type ParameterTypeToParameters<
 > = parameterType extends 'fees'
   ? 'maxFeePerGas' | 'maxPriorityFeePerGas' | 'gasPrice'
   : parameterType
+type ExtractTransactionRequest<transactionRequest, transactionType> =
+  transactionRequest extends { type?: infer type | undefined }
+    ? Extract<transactionType, type> extends never
+      ? never
+      : transactionRequest
+    : never
 
 export type PrepareTransactionRequestRequest<
   chain extends Chain | undefined = Chain | undefined,
@@ -166,12 +164,10 @@ export type PrepareTransactionRequestReturnType<
     : GetTransactionType<request> extends 'legacy'
       ? unknown
       : GetTransactionType<request>,
-  _transactionRequest extends TransactionRequest =
-    | (_transactionType extends 'legacy' ? TransactionRequestLegacy : never)
-    | (_transactionType extends 'eip1559' ? TransactionRequestEIP1559 : never)
-    | (_transactionType extends 'eip2930' ? TransactionRequestEIP2930 : never)
-    | (_transactionType extends 'eip4844' ? TransactionRequestEIP4844 : never)
-    | (_transactionType extends 'eip7702' ? TransactionRequestEIP7702 : never),
+  _transactionRequest = ExtractTransactionRequest<
+    UnionOmit<FormattedTransactionRequest<_derivedChain>, 'from'>,
+    _transactionType
+  >,
 > = Prettify<
   UnionRequiredBy<
     Extract<

package/actions/wallet/sendTransaction.ts

@@ -190,6 +190,7 @@ export async function sendTransaction<
       docsPath: '/docs/actions/wallet/sendTransaction',
     })
   const account = account_ ? parseAccount(account_) : null
+  let nonceManagerParameters: { address: Address; chainId: number } | undefined
 
   try {
     assertRequest(parameters as AssertRequestParameters)
@@ -309,6 +310,16 @@ export async function sendTransaction<
     }
 
     if (account?.type === 'local') {
+      if (account.nonceManager && typeof nonce === 'undefined') {
+        const requestChainId = (rest as unknown as { chainId?: number }).chainId
+        const chainId = await (async () => {
+          if (typeof requestChainId === 'number') return requestChainId
+          if (chain) return chain.id
+          return getAction(client, getChainId, 'getChainId')({})
+        })()
+        nonceManagerParameters = { address: account.address, chainId }
+      }
+
       // Prepare the request for signing (assign appropriate fees, etc.)
       const request = await getAction(
         client,
@@ -366,6 +377,8 @@ export async function sendTransaction<
     })
   } catch (err) {
     if (err instanceof AccountTypeNotSupportedError) throw err
+    if (nonceManagerParameters)
+      account?.nonceManager?.reset(nonceManagerParameters)
     throw getTransactionError(err as BaseError, {
       ...parameters,
       account,

package/actions/wallet/sendTransactionSync.ts

@@ -213,6 +213,7 @@ export async function sendTransactionSync<
       docsPath: '/docs/actions/wallet/sendTransactionSync',
     })
   const account = account_ ? parseAccount(account_) : null
+  let nonceManagerParameters: { address: Address; chainId: number } | undefined
 
   try {
     assertRequest(parameters as AssertRequestParameters)
@@ -348,6 +349,16 @@ export async function sendTransactionSync<
     }
 
     if (account?.type === 'local') {
+      if (account.nonceManager && typeof nonce === 'undefined') {
+        const requestChainId = (rest as unknown as { chainId?: number }).chainId
+        const chainId = await (async () => {
+          if (typeof requestChainId === 'number') return requestChainId
+          if (chain) return chain.id
+          return getAction(client, getChainId, 'getChainId')({})
+        })()
+        nonceManagerParameters = { address: account.address, chainId }
+      }
+
       // Prepare the request for signing (assign appropriate fees, etc.)
       const request = await getAction(
         client,
@@ -407,6 +418,11 @@ export async function sendTransactionSync<
     })
   } catch (err) {
     if (err instanceof AccountTypeNotSupportedError) throw err
+    if (
+      nonceManagerParameters &&
+      !(err instanceof TransactionReceiptRevertedError)
+    )
+      account?.nonceManager?.reset(nonceManagerParameters)
     throw getTransactionError(err as BaseError, {
       ...parameters,
       account,

package/chains/definitions/mizuhikiTestnetAwaji.ts

@@ -0,0 +1,26 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+
+export const mizuhikiTestnetAwaji = /*#__PURE__*/ defineChain({
+  id: 6497,
+  name: 'MIZUHIKI Testnet Awaji',
+  nativeCurrency: { name: 'MIZU', symbol: 'MIZU', decimals: 18 },
+  rpcUrls: {
+    default: {
+      http: ['https://rpc.awaji.mizuhiki.io'],
+    },
+  },
+  blockExplorers: {
+    default: {
+      name: 'Blockscout',
+      url: 'https://awaji.blockscout.com',
+      apiUrl: 'https://awaji.blockscout.com/api',
+    },
+  },
+  contracts: {
+    multicall3: {
+      address: '0xca11bde05977b3631167028862be2a173976ca11',
+      blockCreated: 0,
+    },
+  },
+  testnet: true,
+})

package/chains/definitions/morphHolesky.ts

@@ -14,7 +14,7 @@ export const morphHolesky = /*#__PURE__*/ defineChain({
     default: {
       name: 'Morph Holesky Explorer',
       url: 'https://explorer-holesky.morphl2.io',
-      apiUrl: 'https://explorer-api-holesky.morphl2.io/api?',
+      apiUrl: 'https://explorer-api-holesky.morphl2.io/api',
     },
   },
   testnet: true,

package/chains/definitions/sentrix.ts

@@ -0,0 +1,26 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+
+export const sentrix = /*#__PURE__*/ defineChain({
+  id: 7119,
+  name: 'Sentrix Chain',
+  nativeCurrency: { name: 'Sentrix', symbol: 'SRX', decimals: 18 },
+  blockTime: 1_000,
+  rpcUrls: {
+    default: {
+      http: ['https://rpc.sentrixchain.com'],
+      webSocket: ['wss://rpc.sentrixchain.com/ws'],
+    },
+  },
+  blockExplorers: {
+    default: {
+      name: 'SentrixScan',
+      url: 'https://scan.sentrixchain.com',
+    },
+  },
+  contracts: {
+    multicall3: {
+      address: '0xFd4b34b5763f54a580a0d9f7997A2A993ef9ceE9',
+      blockCreated: 717_078,
+    },
+  },
+})

package/chains/definitions/sentrixTestnet.ts

@@ -0,0 +1,27 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+
+export const sentrixTestnet = /*#__PURE__*/ defineChain({
+  id: 7120,
+  name: 'Sentrix Testnet',
+  nativeCurrency: { name: 'Sentrix', symbol: 'SRX', decimals: 18 },
+  blockTime: 1_000,
+  rpcUrls: {
+    default: {
+      http: ['https://testnet-rpc.sentrixchain.com'],
+      webSocket: ['wss://testnet-rpc.sentrixchain.com/ws'],
+    },
+  },
+  blockExplorers: {
+    default: {
+      name: 'SentrixScan Testnet',
+      url: 'https://scan-testnet.sentrixchain.com',
+    },
+  },
+  contracts: {
+    multicall3: {
+      address: '0x7900826De548425c6BE56caEbD4760AB0155Cd54',
+      blockCreated: 723_191,
+    },
+  },
+  testnet: true,
+})

package/chains/definitions/sova.ts

@@ -16,7 +16,7 @@ export const sova = /*#__PURE__*/ defineChain({
   blockExplorers: {
     default: {
       name: 'Sova Block Explorer',
-      url: 'hhttps://explorer.sova.io',
+      url: 'https://explorer.sova.io',
     },
   },
   testnet: false,

package/chains/index.ts

@@ -415,6 +415,7 @@ export { mezoTestnet } from './definitions/mezoTestnet.js'
 export { mint } from './definitions/mint.js'
 export { mintSepoliaTestnet } from './definitions/mintSepoliaTestnet.js'
 export { mitosisTestnet } from './definitions/mitosisTestnet.js'
+export { mizuhikiTestnetAwaji } from './definitions/mizuhikiTestnetAwaji.js'
 export { mode } from './definitions/mode.js'
 export { modeTestnet } from './definitions/modeTestnet.js'
 export { monad } from './definitions/monad.js'
@@ -539,6 +540,8 @@ export { scrollSepolia } from './definitions/scrollSepolia.js'
 export { sei } from './definitions/sei.js'
 export { seismicDevnet } from './definitions/seismicDevnet.js'
 export { seiTestnet } from './definitions/seiTestnet.js'
+export { sentrix } from './definitions/sentrix.js'
+export { sentrixTestnet } from './definitions/sentrixTestnet.js'
 export { sepolia } from './definitions/sepolia.js'
 export { shape } from './definitions/shape.js'
 export { shapeSepolia } from './definitions/shapeSepolia.js'
@@ -763,6 +766,28 @@ export { zoraTestnet } from './definitions/zoraTestnet.js'
 //////////////////////////////////////////////////////////////////////////////////////
 // Required type exports to prevent TypeScript error "TS2742".
 
+export type {
+  /** @deprecated */
+  Signed as KeyAuthorizationSigned,
+} from 'ox/tempo/KeyAuthorization'
+export type {
+  /** @deprecated */
+  SignatureEnvelope,
+  /** @deprecated */
+  SignatureEnvelopeRpc,
+} from 'ox/tempo/SignatureEnvelope'
+export type {
+  /** @deprecated */
+  Address as TempoAddress,
+} from 'ox/tempo/TempoAddress'
+export type {
+  /** @deprecated */
+  TokenIdOrAddress,
+} from 'ox/tempo/TokenId'
+export type {
+  /** @deprecated */
+  Call as TxEnvelopeTempoCall,
+} from 'ox/tempo/TxEnvelopeTempo'
 export type {
   assertTransactionCIP42 as assertTransactionCIP42Celo,
   assertTransactionCIP64 as assertTransactionCIP64Celo,
@@ -820,6 +845,34 @@ export type {
   TransactionSerializableDeposit,
   TransactionSerializedDeposit,
 } from '../op-stack/types/transaction.js'
+export type {
+  /** @deprecated */
+  Transaction as z_Transaction,
+  /** @deprecated */
+  TransactionReceipt as z_TransactionReceipt,
+  /** @deprecated */
+  TransactionReceiptRpc as z_TransactionReceiptRpc,
+  /** @deprecated */
+  TransactionRequest as z_TransactionRequest,
+  /** @deprecated */
+  TransactionRequestRpc as z_TransactionRequestRpc,
+  /** @deprecated */
+  TransactionRequestTempo as z_TransactionRequestTempo,
+  /** @deprecated */
+  TransactionRpc as z_TransactionRpc,
+  /** @deprecated */
+  TransactionSerializable as z_TransactionSerializable,
+  /** @deprecated */
+  TransactionSerializableTempo as z_TransactionSerializableTempo,
+  /** @deprecated */
+  TransactionSerialized as z_TransactionSerialized,
+  /** @deprecated */
+  TransactionSerializedTempo as z_TransactionSerializedTempo,
+  /** @deprecated */
+  TransactionTempo as z_TransactionTempo,
+  /** @deprecated */
+  TransactionType as z_TransactionType,
+} from '../tempo/Transaction.js'
 export type {
   Assign,
   Omit,