viem 2.55.4 → 2.55.5

package/actions/public/multicall.ts

@@ -32,6 +32,11 @@ import {
   getContractError,
 } from '../../utils/errors/getContractError.js'
 import { getAction } from '../../utils/getAction.js'
+import {
+  type CreateBatchSchedulerErrorType,
+  createBatchScheduler,
+} from '../../utils/promise/createBatchScheduler.js'
+import { stringify } from '../../utils/stringify.js'
 import type { CallParameters } from './call.js'
 import { type ReadContractErrorType, readContract } from './readContract.js'
 
@@ -82,6 +87,7 @@ export type MulticallReturnType<
 >
 
 export type MulticallErrorType =
+  | CreateBatchSchedulerErrorType
   | GetChainContractAddressErrorType
   | ReadContractErrorType
   | GetContractErrorReturnType<
@@ -89,6 +95,14 @@ export type MulticallErrorType =
     >
   | ErrorType
 
+type Aggregate3Call = {
+  allowFailure: boolean
+  callData: Hex
+  target: Address
+}
+
+type Aggregate3Calls = Aggregate3Call[]
+
 /**
  * Similar to [`readContract`](https://viem.sh/docs/contract/readContract), but batches up multiple functions on a contract in a single RPC call via the [`multicall3` contract](https://github.com/mds1/multicall).
  *
@@ -169,12 +183,6 @@ export async function multicall<
     )
   })()
 
-  type Aggregate3Calls = {
-    allowFailure: boolean
-    callData: Hex
-    target: Address
-  }[]
-
   const chunkedCalls: Aggregate3Calls[] = [[]]
   let currentChunk = 0
   let currentChunkSize = 0
@@ -227,9 +235,27 @@ export async function multicall<
     }
   }
 
+  const batching = Boolean(client.batch?.multicall)
+  const batches = batching
+    ? chunkedCalls.flatMap((calls) => calls.map((call) => [call]))
+    : chunkedCalls
   const aggregate3Results = await Promise.allSettled(
-    chunkedCalls.map((calls) =>
-      getAction(
+    batches.map((calls) => {
+      if (batching)
+        return scheduleMulticall(client, {
+          account,
+          authorizationList,
+          batchSize,
+          blockHash,
+          blockNumber,
+          blockOverrides,
+          blockTag,
+          call: calls[0]!,
+          multicallAddress,
+          requireCanonical,
+          stateOverride,
+        }).then((result) => [result])
+      return getAction(
         client,
         readContract,
         'readContract',
@@ -248,8 +274,8 @@ export async function multicall<
         functionName: 'aggregate3',
         requireCanonical,
         stateOverride,
-      }),
-    ),
+      })
+    }),
   )
 
   const results = []
@@ -260,7 +286,7 @@ export async function multicall<
     // then append the failure reason to each contract result.
     if (result.status === 'rejected') {
       if (!allowFailure) throw result.reason
-      for (let j = 0; j < chunkedCalls[i].length; j++) {
+      for (let j = 0; j < batches[i].length; j++) {
         results.push({
           status: 'failure',
           error: result.reason,
@@ -277,7 +303,7 @@ export async function multicall<
       const { returnData, success } = aggregate3Result[j]
 
       // Extract the request call data from the original call.
-      const { callData } = chunkedCalls[i][j]
+      const { callData } = batches[i][j]
 
       // Extract the contract config for this call from the `contracts` argument
       // for decoding.
@@ -313,3 +339,57 @@ export async function multicall<
     throw new BaseError('multicall results mismatch')
   return results as MulticallReturnType<contracts, allowFailure>
 }
+
+type ScheduleMulticallParameters = Pick<
+  MulticallParameters,
+  | 'account'
+  | 'authorizationList'
+  | 'blockHash'
+  | 'blockNumber'
+  | 'blockOverrides'
+  | 'blockTag'
+  | 'requireCanonical'
+  | 'stateOverride'
+> & {
+  batchSize: number
+  call: Aggregate3Call
+  multicallAddress: Address | null
+}
+
+async function scheduleMulticall(
+  client: Client<Transport>,
+  parameters: ScheduleMulticallParameters,
+) {
+  const { batchSize, call, multicallAddress, ...rest } = parameters
+  const { wait = 0 } =
+    typeof client.batch?.multicall === 'object' ? client.batch.multicall : {}
+  const { schedule } = createBatchScheduler({
+    id: stringify(['multicall', client.uid, batchSize, multicallAddress, rest]),
+    wait,
+    shouldSplitBatch(calls: Aggregate3Calls) {
+      if (batchSize === 0) return false
+      const size = calls.reduce(
+        (size, { callData }) => size + (callData.length - 2) / 2,
+        0,
+      )
+      return size > batchSize
+    },
+    fn: (calls: Aggregate3Calls) =>
+      getAction(
+        client,
+        readContract,
+        'readContract',
+      )({
+        ...(multicallAddress === null
+          ? { code: multicall3Bytecode }
+          : { address: multicallAddress }),
+        ...rest,
+        abi: multicall3Abi,
+        args: [calls],
+        functionName: 'aggregate3',
+      }),
+  })
+
+  const [result] = await schedule(call)
+  return result
+}

package/actions/wallet/prepareTransactionRequest.ts

@@ -337,7 +337,7 @@ export async function prepareTransactionRequest<
     return chainId
   }
 
-  const account = account_ ? parseAccount(account_) : account_
+  let account = account_ ? parseAccount(account_) : account_
 
   let nonce = request.nonce
   if (
@@ -366,6 +366,8 @@ export async function prepareTransactionRequest<
       },
     )
     nonce ??= request.nonce
+    const sender = request.account ?? (request as TransactionRequest).from
+    account = sender ? parseAccount(sender) : undefined
   }
 
   const attemptFill = (() => {
@@ -381,6 +383,31 @@ export async function prepareTransactionRequest<
     // 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
+    // filled. The fee payer signature can only be obtained as a side effect
+    // of `eth_fillTransaction` (the relay co-signs the returned transaction),
+    // so it must be called even when nonce/gas/fees are already fully
+    // populated, or when the caller's `parameters` option omits `'fees'`/
+    // `'gas'` entirely — otherwise the transaction silently ends up without
+    // a fee payer signature. This check intentionally runs before the
+    // `shouldAttempt` gate below, since fee-payer sponsorship is independent
+    // of which parameters the caller opted into filling.
+    //
+    // The `parameters.length > 0` guard excludes internal micro-prepare calls
+    // that explicitly pass an empty `parameters` array (e.g. `estimateGas`'s
+    // internal `prepareTransactionRequest` call for local accounts) — those
+    // are deliberately scoped to fill nothing, and should not independently
+    // re-attempt `eth_fillTransaction` for fee-payer sponsorship.
+    if (
+      parameters.length > 0 &&
+      'feePayer' in request &&
+      (request as any).feePayer &&
+      !('feePayerSignature' in request && (request as any).feePayerSignature)
+    )
+      return true
+
     // 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/errors/version.ts

@@ -1 +1 @@
-export const version = '2.55.4'
+export const version = '2.55.5'

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "viem",
   "description": "TypeScript Interface for Ethereum",
-  "version": "2.55.4",
+  "version": "2.55.5",
   "main": "./_cjs/index.js",
   "module": "./_esm/index.js",
   "types": "./_types/index.d.ts",
@@ -234,7 +234,7 @@
     "@scure/bip39": "1.6.0",
     "abitype": "1.2.3",
     "isows": "1.0.7",
-    "ox": "0.14.30",
+    "ox": "0.14.31",
     "ws": "8.21.0"
   },
   "license": "MIT",

package/tempo/Transaction.ts

@@ -379,7 +379,7 @@ async function serializeTempo(
     return SignatureEnvelope.from({
       genesisConfig: transaction.multisig,
       signatures: sorted,
-      ...(nonce ? {} : { init: true }),
+      ...(nonce || transaction.nonceKey ? {} : { init: true }),
     })
   })()