viem 2.55.11 → 2.55.15

package/actions/wallet/prepareTransactionRequest.ts

@@ -340,20 +340,6 @@ export async function prepareTransactionRequest<
   let account = account_ ? parseAccount(account_) : account_
 
   let nonce = request.nonce
-  if (
-    parameters.includes('nonce') &&
-    typeof nonce === 'undefined' &&
-    account &&
-    nonceManager
-  ) {
-    const chainId = await getChainId()
-    nonce = await nonceManager.consume({
-      address: account.address,
-      chainId,
-      client,
-    })
-  }
-
   if (
     prepareTransactionRequest?.fn &&
     prepareTransactionRequest.runAt?.includes('beforeFillTransaction')
@@ -370,6 +356,20 @@ export async function prepareTransactionRequest<
     account = sender ? parseAccount(sender) : undefined
   }
 
+  if (
+    parameters.includes('nonce') &&
+    typeof nonce === 'undefined' &&
+    account &&
+    nonceManager
+  ) {
+    const chainId = await getChainId()
+    nonce = await nonceManager.consume({
+      address: account.address,
+      chainId,
+      client,
+    })
+  }
+
   const attemptFill = (() => {
     // Do not attempt if blobs are provided.
     if (
@@ -380,9 +380,6 @@ export async function prepareTransactionRequest<
     )
       return false
 
-    // Do not attempt if `eth_fillTransaction` is not supported.
-    if (supportsFillTransaction.get(client.uid) === false) return false
-
     // Always attempt if the caller explicitly requested a non-empty set of
     // `parameters` and a fee payer signature is being requested (e.g. Tempo
     // sponsorship via `feePayer: true`/`Account`) and has not already been
@@ -408,6 +405,10 @@ export async function prepareTransactionRequest<
     )
       return true
 
+    // Sponsorship can route fill requests to a different endpoint, so it must
+    // bypass support state cached from a non-sponsored request.
+    if (supportsFillTransaction.get(client.uid) === false) return false
+
     // Should attempt `eth_fillTransaction` if "fees" or "gas" are required to be populated,
     // otherwise, can just use the other individual calls.
     const shouldAttempt = ['fees', 'gas'].some((parameter) =>

package/actions/wallet/sendTransaction.ts

@@ -47,6 +47,7 @@ import {
 } from '../../utils/formatters/transactionRequest.js'
 import { getAction } from '../../utils/getAction.js'
 import { LruMap } from '../../utils/lru.js'
+import type { NonceManager } from '../../utils/nonceManager.js'
 import {
   type AssertRequestErrorType,
   type AssertRequestParameters,
@@ -310,15 +311,29 @@ 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 }
-      }
+      const nonceManager = ((): NonceManager | undefined => {
+        if (!account.nonceManager || typeof nonce !== 'undefined')
+          return account.nonceManager
+        const nonceManager = account.nonceManager
+        return {
+          consume(parameters) {
+            nonceManagerParameters = {
+              address: parameters.address,
+              chainId: parameters.chainId,
+            }
+            return nonceManager.consume(parameters)
+          },
+          get(parameters) {
+            return nonceManager.get(parameters)
+          },
+          increment(parameters) {
+            return nonceManager.increment(parameters)
+          },
+          reset(parameters) {
+            return nonceManager.reset(parameters)
+          },
+        }
+      })()
 
       // Prepare the request for signing (assign appropriate fees, etc.)
       const request = await getAction(
@@ -338,7 +353,7 @@ export async function sendTransaction<
         maxFeePerGas,
         maxPriorityFeePerGas,
         nonce,
-        nonceManager: account.nonceManager,
+        nonceManager,
         parameters: [...defaultParameters, 'sidecars'],
         type,
         value,

package/actions/wallet/sendTransactionSync.ts

@@ -51,6 +51,7 @@ import {
 } from '../../utils/formatters/transactionRequest.js'
 import { getAction } from '../../utils/getAction.js'
 import { LruMap } from '../../utils/lru.js'
+import type { NonceManager } from '../../utils/nonceManager.js'
 import {
   type AssertRequestErrorType,
   type AssertRequestParameters,
@@ -349,15 +350,29 @@ 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 }
-      }
+      const nonceManager = ((): NonceManager | undefined => {
+        if (!account.nonceManager || typeof nonce !== 'undefined')
+          return account.nonceManager
+        const nonceManager = account.nonceManager
+        return {
+          consume(parameters) {
+            nonceManagerParameters = {
+              address: parameters.address,
+              chainId: parameters.chainId,
+            }
+            return nonceManager.consume(parameters)
+          },
+          get(parameters) {
+            return nonceManager.get(parameters)
+          },
+          increment(parameters) {
+            return nonceManager.increment(parameters)
+          },
+          reset(parameters) {
+            return nonceManager.reset(parameters)
+          },
+        }
+      })()
 
       // Prepare the request for signing (assign appropriate fees, etc.)
       const request = await getAction(
@@ -377,7 +392,7 @@ export async function sendTransactionSync<
         maxFeePerGas,
         maxPriorityFeePerGas,
         nonce,
-        nonceManager: account.nonceManager,
+        nonceManager,
         parameters: [...defaultParameters, 'sidecars'],
         type,
         value,

package/clients/createClient.ts

@@ -350,9 +350,9 @@ function isPlainObject(value: unknown): value is Record<string, unknown> {
  * Binds an action function to a `client`, returning a parameter-only version
  * along with any helpers the action exposes. Helpers that need a client
  * (`.call`, `.calls`, `.callWithPeriod`, `.estimateGas`, `.prepare`,
- * `.prepareRecipient`, `.simulate`) are bound to `client`; pure helpers
- * (`.extractEvent`, `.extractEvents`) are copied as-is. Used by decorators
- * that attach namespaced actions to a Client.
+ * `.prepareRecipient`, `.predict`, `.simulate`) are bound to `client`;
+ * pure helpers (`.extractEvent`, `.extractEvents`) are copied as-is. Used
+ * by decorators that attach namespaced actions to a Client.
  * @internal
  */
 export function bindActionDecorators(
@@ -367,6 +367,7 @@ export function bindActionDecorators(
     'estimateGas',
     'prepare',
     'prepareRecipient',
+    'predict',
     'simulate',
   ] as const)
     if (Object.hasOwn(action, key)) {

package/clients/decorators/public.ts

@@ -240,6 +240,11 @@ import {
   type WaitForTransactionReceiptReturnType,
   waitForTransactionReceipt,
 } from '../../actions/public/waitForTransactionReceipt.js'
+import {
+  type WatchBlockHeadersParameters,
+  type WatchBlockHeadersReturnType,
+  watchBlockHeaders,
+} from '../../actions/public/watchBlockHeaders.js'
 import {
   type WatchBlockNumberParameters,
   type WatchBlockNumberReturnType,
@@ -305,6 +310,7 @@ import type {
 } from '../../types/contract.js'
 import type { FeeValuesType } from '../../types/fee.js'
 import type { FilterType } from '../../types/filter.js'
+import type { HasTransportType } from '../../types/transport.js'
 import { bindActionDecorators, type Client } from '../createClient.js'
 import type { Transport } from '../transports/createTransport.js'
 
@@ -1988,6 +1994,32 @@ export type PublicActions<
   watchBlockNumber: (
     args: WatchBlockNumberParameters,
   ) => WatchBlockNumberReturnType
+  /**
+   * Watches and returns incoming block headers without fetching full blocks.
+   *
+   * - Docs: https://viem.sh/docs/actions/public/watchBlockHeaders
+   * - JSON-RPC Methods: Uses a WebSocket or IPC subscription via [`eth_subscribe`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_subscribe) and the `"newHeads"` event.
+   *
+   * @param args - {@link WatchBlockHeadersParameters}
+   * @returns A function that can be invoked to stop watching for new block headers. {@link WatchBlockHeadersReturnType}
+   *
+   * @example
+   * import { createPublicClient, webSocket } from 'viem'
+   * import { mainnet } from 'viem/chains'
+   *
+   * const client = createPublicClient({
+   *   chain: mainnet,
+   *   transport: webSocket(),
+   * })
+   * const unwatch = client.watchBlockHeaders({
+   *   onBlockHeader: (blockHeader) => console.log(blockHeader),
+   * })
+   */
+  watchBlockHeaders: (
+    args: HasTransportType<transport, 'webSocket' | 'ipc'> extends true
+      ? WatchBlockHeadersParameters<chain>
+      : never,
+  ) => WatchBlockHeadersReturnType
   /**
    * Watches and returns information for incoming blocks.
    *
@@ -2337,6 +2369,7 @@ export function publicActions<
     uninstallFilter: (args) => uninstallFilter(client, args),
     waitForTransactionReceipt: (args) =>
       waitForTransactionReceipt(client, args),
+    watchBlockHeaders: (args) => watchBlockHeaders(client, args),
     watchBlocks: (args) => watchBlocks(client, args),
     watchBlockNumber: (args) => watchBlockNumber(client, args),
     watchContractEvent: (args) => watchContractEvent(client, args),

package/errors/version.ts

@@ -1 +1 @@
-export const version = '2.55.11'
+export const version = '2.55.15'

package/index.ts

@@ -320,6 +320,14 @@ export type {
   WaitForTransactionReceiptParameters,
   WaitForTransactionReceiptReturnType,
 } from './actions/public/waitForTransactionReceipt.js'
+export type {
+  BlockHeader,
+  OnBlockHeader,
+  OnBlockHeaderParameter,
+  WatchBlockHeadersErrorType,
+  WatchBlockHeadersParameters,
+  WatchBlockHeadersReturnType,
+} from './actions/public/watchBlockHeaders.js'
 export type {
   OnBlockNumberFn,
   OnBlockNumberParameter,

package/package.json

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

package/tempo/Decorator.ts

@@ -1744,6 +1744,37 @@ type DecoratorBase<
     ) => () => void
   }
   earn: {
+    /** Deploys a deterministic ERC-4626 engine. */
+    createErc4626Engine: (
+      parameters: earnActions.createErc4626Engine.Parameters<chain, account>,
+    ) => Promise<earnActions.createErc4626Engine.ReturnValue>
+    /** Deploys a deterministic ERC-4626 engine and waits for confirmation. */
+    createErc4626EngineSync: (
+      parameters: earnActions.createErc4626EngineSync.Parameters<
+        chain,
+        account
+      >,
+    ) => Promise<earnActions.createErc4626EngineSync.ReturnValue>
+    /** Deploys the EarnShare, EarnVault, and EarnFees contracts. */
+    createStack: (
+      parameters: earnActions.createStack.Parameters<chain, account>,
+    ) => Promise<earnActions.createStack.ReturnValue>
+    /** Deploys an Earn stack and waits for confirmation. */
+    createStackSync: (
+      parameters: earnActions.createStackSync.Parameters<chain, account>,
+    ) => Promise<earnActions.createStackSync.ReturnValue>
+    /** Binds an ERC-4626 engine to its EarnVault. */
+    bindErc4626Engine: (
+      parameters: earnActions.bindErc4626Engine.Parameters<chain, account>,
+    ) => Promise<earnActions.bindErc4626Engine.ReturnValue>
+    /** Binds an ERC-4626 engine and waits for confirmation. */
+    bindErc4626EngineSync: (
+      parameters: earnActions.bindErc4626EngineSync.Parameters<chain, account>,
+    ) => Promise<earnActions.bindErc4626EngineSync.ReturnValue>
+    /** Deploys and binds a complete, resumable ERC-4626 Earn stack. */
+    deployErc4626StackSync: (
+      parameters: earnActions.deployErc4626StackSync.Parameters<chain, account>,
+    ) => Promise<earnActions.deployErc4626StackSync.ReturnValue>
     /**
      * Creates and attaches an admission-only TIP-403 policy to an Earn share
      * token. Existing holders remain able to send shares while
@@ -5686,6 +5717,9 @@ type BoundActionHelpers<action> = (action extends { call: infer helper }
   (action extends { prepareRecipient: infer helper }
     ? { prepareRecipient: BoundHelper<helper> }
     : {}) &
+  (action extends { predict: infer helper }
+    ? { predict: BoundHelper<helper> }
+    : {}) &
   (action extends { simulate: infer helper }
     ? { simulate: BoundHelper<helper> }
     : {}) &
@@ -5888,11 +5922,18 @@ export function decorator() {
         'watchOrderPlaced',
       ]),
       earn: bindActions(client, earnActions, [
+        'bindErc4626Engine',
+        'bindErc4626EngineSync',
         'configureExitSafePolicy',
+        'createErc4626Engine',
+        'createErc4626EngineSync',
+        'createStack',
+        'createStackSync',
         'deposit',
         'depositSync',
         'depositShares',
         'depositSharesSync',
+        'deployErc4626StackSync',
         'privateDeposit',
         'privateDepositSync',
         'getFeeState',