fix(linea): send stateOverride to linea_estimateGas

[moyanghe-uniswap]

Problem

estimateGas from viem/linea accepts stateOverride in its parameter type (inherited from the base EstimateGasParameters), but the implementation silently drops it: the argument is destructured into a rest object that is never serialized, and params is built as block ? [request, block] : [request]. Overrides never reach the node.

This matters on Linea specifically because linea_estimateGas always validates the sender's real balance against gas * price + value (unlike eth_estimateGas, which skips the balance check when no gas price is supplied). Without a working balance override there is no way to quote gas for an account that isn't funded yet — e.g. previewing a WETH unwrap for a wallet that holds no native ETH, which is exactly when users unwrap. Such calls fail with transaction up-front cost … exceeds transaction sender account balance (or a Besu Cannot remove … wei from account internal error once a non-zero value reaches the transfer step).

Fix

• Serialize stateOverride with the existing internal serializeStateOverride and send it on linea_estimateGas. When no block is given it rides as the second positional param in the eth_call account-map shape — verified accepted by the Linea mainnet public sequencer (rpc.linea.build), Linea Sepolia (rpc.sepolia.linea.build), and Alchemy's Linea endpoints:

  // params: [tx, {"0x1111…": {"balance": "0x21e19e0c9bab2400000"}}]
  → {"result":{"gasLimit":"0x5208","baseFeePerGas":"0x7","priorityFeePerGas":"0x24137da"}}
  

• Add the missing [transaction, stateOverride] variant to LineaRpcSchema's Parameters union, and allow Hex for the block position of the 3-param variant (the 2-param variant already allowed it; the implementation passes numberToHex(blockNumber)).

• New test args: stateOverride against Linea Sepolia: the exact unfunded-sender call that the existing error: insufficient balance test expects to fail now succeeds with a balance override — it fails without this PR and passes with it.

Notes for reviewers

• The pre-existing error: insufficient balance test currently fails on main against Linea Sepolia: the node now reports a non-zero-value transfer from an unfunded sender as a Besu Cannot remove … wei from account internal error rather than the up-front-cost message. This PR loosens that assertion to accept either message; happy to split that out if preferred.
• Node behavior observed while testing (not changed by this PR): the Linea sequencer rejects every linea_estimateGas call that includes a block param ([tx, "latest"], [tx, blockNumberHex], and the 3-param shape all return Internal error), so the block path appears unusable against current nodes. This PR leaves that path as-is and only threads stateOverride through.

[changeset-bot]

🦋 Changeset detected

Latest commit: c763a43

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
viem	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[vercel]

@moyanghe-uniswap is attempting to deploy a commit to the Wevm Team on Vercel.

A member of the Team first needs to authorize it.

[moyanghe-uniswap]

cc @jxom @tmm — small fix for viem/linea estimateGas dropping stateOverride; tests run against live Linea Sepolia. Happy to adjust anything.