Repository navigation
·
2 commits
to master
since this release
Immutable
release. Only release title and notes can be modified.
Foundry 1.10.0 replaces revm with evm2, a new blazing fast execution engine, across Forge, Anvil, Cast and Chisel. Read Action required before upgrading, because gas numbers and some execution details change.
What you get:
- Up to 4.5× faster tests on evm2. A tighter interpreter, and inspectors that step only the opcodes they act on, make
forge test4.5× faster than 1.9.0 on Morpho Blue, 3.5× on Spark PSM and 2.1× on Aave v4. - Pinned Solar releases.
solc = "solar:0.3.0"pins a Solar release, which Forge downloads if it is missing, andforge build -j 4compiles with four Solar threads. - Tempo T14 configurable accounts. Create configurable accounts, manage their owners and thresholds, and send transactions their owners sign, from Cast, Forge and Anvil.
- Faster debugger. On the 1.46M-step Aave v4 test, SolDB is ready in 1.40 s instead of 1.96 s, with peak memory around 1 GiB. The opcode pane shows PUSH values again.
- Deeper invariant campaigns. Runs resume from states reached by earlier runs, and failing fuzz and invariant tests report minimized counterexamples.
- About 220 fixes across symbolic execution, coverage, cheatcodes, fuzzing, Anvil and Cast.
Action required
- Gas snapshots (evm2): regenerate them. Fork warmth and fork transient storage no longer leak from
setUp, andvm.setArbitraryStorageleaves slots cold. A halting call undervm.expectRevertnow consumes all forwarded gas, as on chain, unless the test makes it directly as a non-static call withisolate = true. If later work in the test runs out of gas, forward a fixed amount, as intarget.f{gas: 100_000}()(#17541, #18396). - Remappings: when a dependency's remapping conflicts with another dependency or a root path, it now applies only inside that dependency, which can change which copy a dependency compiles against. A root import of that alias then fails with an error that suggests the remapping to add, or silently resolves to another target, and Forge warns in that case. Adding the old line to your root remappings restores 1.9 resolution for the whole project (#18433, #18573, #18590, #18603).
- Test discovery: only suites under
src,testandscriptrun, andforge testwarns about project suites it skips. Widentestto keep running them (#18424, #18572). - Invariants: snapshot fuzzing is on by default, so a run can start from a state an earlier run reached instead of from
setUp. Handlers andafterInvarianthooks that assume a fresh state per run can fail (#18018).
Performance
- evm2: inspectors step only the opcodes they act on and per-call and per-step overhead is trimmed, so
forge testis 4.5× faster than 1.9.0 on Morpho Blue, 3.5× on Spark PSM and 2.1× on Aave v4 (#17541, #18412, #18476) by @mablr, @stevencartavia, @grandizzy, @joshieDo, @emmajam, @pepyakin, @0xKarl98, @figtracer. - Debugger: the Aave v4 session is ready in 1.40 s instead of 1.96 s. The recorder appends only new stack words and no longer uses excessive memory on multi-call transactions such as Tempo batches (#18285, #18392, #18394) by @figtracer, @mablr, @stevencartavia.
- Invariant campaigns: predicates run without instrumentation, campaigns drop the tracer, prefixes replay once, and hints and coverage keys are smaller (#18121, #18244, #18166, #18180, #18474, #18243) by @figtracer.
- Forks, Anvil, gas reports and coverage: the opt-in
fork_prefetchalso prefetches the state of simulated calls, Anvil fork history shares unchanged state, and gas reports and coverage use less memory (#18247, #18435, #18423, #18129, #18473, #18475) by @figtracer, @mablr, @stevencartavia. - Linking, cheatcodes and lints: library paths are canonicalized only when needed, cheatcodes cache env overrides, and
reentrancy-balanceno longer re-analyzes callees per call site (#18160, #18125, #18063) by @figtracer, @stevencartavia, @DaniPopes.
Features
Forge
- Solar:
solc = "solar:<version>", also accepted by--useandFOUNDRY_SOLC_VERSION, pins an exact Solar release that Forge downloads and checks. Forge passes its thread count to Solar (#18068, #18092) by @stevencartavia, @mablr, @DaniPopes. - Invariant and fuzz campaigns: snapshot fuzzing resumes runs from states with rare storage features, delays come from the fuzz dictionary, and
invariant.call_gas_limitcaps campaign calls. Failing tests report minimized values that still fail the same way, and the dictionary prefers typed samples. The experimentalinstrumented_edgestakes coverage from compiler-instrumented builds, which need an unreleased Solar plugin (#18018, #18139, #18227, #18250, #18391, #18195, #18165, #18167, #18179, #18204) by @0xalpharush, @stevencartavia, @mablr, @figtracer. - Symbolic execution:
forge equivalencechecks that two runtime bytecodes behave the same for every input, and the opt-in--symbolic-liveworker solves branches during invariant campaigns. Added Amsterdam opcodes,CLZandmulDivreasoning (#18065, #18145, #18093, #18091, #18442, #18498) by @0xalpharush, @stevencartavia, @mattsse, @mablr, @figtracer, @Thomas-Smets. - Coverage, state diffs and lints:
forge coverage --keep-optimizerkeeps optimizer settings. State diffs label EIP-1967 proxy slots, dynamic array elements and ERC-7201 namespaces declared in libraries, and two lints catch colliding namespaces and slots that don't match their namespace (#18445, #18500, #18501, #18028, #18029, #18030) by @DaniPopes, @sakulstra, @mablr, @stevencartavia. - Scripts and properties:
forge scriptlists the contracts it deployed, named byvm.label, andforge propertiesagents search different focus areas, set with--focus(#17971, #18189, #18194) by @aelmanaa, @mablr, @figtracer, @stevencartavia.
Tempo T14 configurable accounts
- Cast:
cast walletcreates configurable accounts and manages their owners.send,mktx,batch-send,estimateand zone transfers sign as configurable accounts with their owners' keys, a configurable account can act as another account's access key, and owners on other machines approve withcast wallet sign --no-hash, including--p256.cast txshows their signatures (#18378, #18410, #18407, #18506, #18510, #18535, #18507, #18426, #18421, #18508) by @mablr, @stevencartavia. - Forge: cheatcodes derive, digest and sign for configurable accounts, and
forge scriptsends as one whose owners sign on other machines (#18408, #18411, #18443) by @mablr. - Anvil: it simulates and impersonates configurable accounts, including forked ones, and traces decode their precompile (#18377, #18536, #18509, #18374, #18372) by @mablr.
Anvil and Cast
- Anvil:
anvil_tempoCreateTokencreates TIP-20 tokens at chosen addresses, and Tempo forks infer their epoch length (#18099, #18020, #18077) by @0xKarl98, @mablr. - Cast:
cast safeverifies Safe transaction hashes locally, takes--chainand rejects a chain ID mismatch, and decodes Safe v1.3.0 events. Errors name an eaten trailing flag or the transaction hash that timed out (#18418, #18425, #17926, #17813) by @0xKarl98, @mablr, @ninglinLiu, @stevencartavia, @aelmanaa.
Bug fixes
Execution and Anvil
- Execution: fork preflight reads drop
requireCanonical, so Rootstock forks work (#18486) by @Ynyesto. - Anvil: calls, estimates and replays treat empty accounts as absent, as mining does, and Monad RPCs report the charged gas (#18128, #18513) by @stevencartavia, @mablr, @haythemsellami.
- Anvil RPC and mining: mining and RPC locks are fixed, reorg blocks differ from the blocks they replace, deep fork rollbacks restore block hashes, Otterscan searches respect the head and keep block order, beacon blob lookups work, and Tempo fork dev accounts get fee tokens. Gas estimation prints console logs only on failure, full DKG is announced before rotation, and transactions below intrinsic or calldata floor gas, legacy transactions for other chains and code over Tempo precompiles are rejected (#16711, #18064, #18239, #18275, #18439, #18014, #18015, #18131, #18135, #18560, #17940, #18069, #18279, #18010, #18100) by @gomesalexandre, @mablr, @stevencartavia, @0xKarl98, @figtracer, @Snan0M, @aelmanaa, @mortezashojaei.
Cheatcodes and state diffs
- Cheatcodes: stale deals are cleared,
expectCreateignores failed creates, cheatcode forks use the retry settings, fork-mode access checks the executing code,writeJsonhandles quoted keys and self-referencing structs serialize. Env values are redacted from errors (#18176, #18155, #18074, #18358, #18004, #18466, #17724) by @stevencartavia, @mablr, @0xKarl98, @Steven-J-22, @figtracer, @Naveen-6087. - State diffs: accesses are attributed to the right frame and account, and struct members, user-defined value types and proxy storage decode correctly (#18381, #18505, #18147, #18148, #18161, #18496, #18497, #18499) by @stevencartavia, @mablr, @sakulstra.
Fuzzing, invariants and coverage
- Invariants: every failed handler assertion is detected with its message, timed campaigns check the initial state, reverts between checks fail every invariant, and
afterInvariantcounterexamples drop an unexecuted call. Shrinking stops at the invariant timeout and keeps its progress (#18158, #18286, #18357, #18455, #18454, #18405, #18414) by @stevencartavia, @mablr, @figtracer. - Fuzzing: corpus calls are kept and admitted correctly, the final sync no longer livelocks, the reported failure and
call_overridetargets are deterministic, runtime dictionary samples are no longer crowded out by literals,SUB-based equality checks give comparison hints, and coverage includes the failing input (#18122, #18137, #18230, #18484, #18123, #18124, #18197, #17989, #18456) by @stevencartavia, @mablr, @figtracer, @aelmanaa. - Coverage: failure stubs,
breakandcontinuearms, and source offsets of dynamically linked tests map to the right items, andrequire, ternary, Yulif, function and statement anchors match solc under Solar and via-IR (#18094, #18446, #18518, #18528, #18529, #18185, #18447, #18450, #18448, #18516, #18517, #18541, #18563) by @djolertrk, @mablr, @DaniPopes.
Symbolic execution
- Forge equivalence: the engine matches Forge for call depth, halts,
CREATElimits, EIP-7702, env and expectation cheatcodes,dealand nonce writes,BLOBHASHand invariants aftersetUp. Counterexamples replay the model's storage, and missing storage layouts are recompiled (#17854, #18120, #18432, #18544, #18299, #18459, #18463, #18462, #18102, #18059, #18136, #18175, #18341, #18344, #18338, #18315, #18355, #18365, #18366, #18367, #18368, #18387, #18388, #18144, #18066, #18090, #18101, #18431, #18440, #18441, #18458, #18582) by @mablr, @stevencartavia, @figtracer, @grandizzy, @joshieDo, @emmajam, @pepyakin, @0xKarl98, @mattsse. - Solver and normalizer: common DeFi math now proves instead of timing out, including
mulDiv,ceilDiv, pro-rata shares, vault round trips, divide-first fees and constant-product swaps. Large storage offsets can alias, and keccak, division, remainder and masking facts are decided before the solver (#18057, #18058, #18193, #18342, #18346, #18349, #18350, #18351, #18530, #18531, #18546, #18547, #18548, #18551, #18557, #18559, #18561, #18545, #18169, #18583, #18587, #18591, #18592, #18597, #18598, #18600, #18601, #18595) by @stevencartavia, @mablr, @figtracer, @grandizzy, @joshieDo, @emmajam, @pepyakin, @0xKarl98, @clement-ux, @Thomas-Smets.
Forge, scripts and config
- Formatter:
forge fmtno longer writes unparsable files,forloop block styles are respected, unmatcheddisable-enddirectives are ignored, blank lines no longer make single-line bodies unstable, zero trimming no longer leaves underscores, and default and configured inputs that resolve outside the project root are skipped (#18182, #18393, #18356, #18422, #17509, #18237) by @Thomas-Smets, @mablr, @0xKarl98, @figtracer, @stevencartavia, @erkancamli. - Forge:
forge test --jsonstays valid JSON withlive_logson and during long fuzz campaigns with edge coverage,forge testanalyzes all sources, gas snapshot groups can no longer be absolute paths or contain.or..,forge createwaits for lagging receipts, andforge propertiescampaigns no longer share session files (#18419, #18383, #18477, #18468, #18232, #18008) by @stevencartavia, @mablr, @figtracer, @0xKarl98, @kutluhaneth46. - Config: empty library lists parse, chainless explorer entries get their own cache, unknown
[rpc_endpoints]and[etherscan]keys warn, andfoundry.lockends with a newline (#18472, #18487, #17981, #18379) by @unixglo, @mablr, @0xKarl98, @aelmanaa. - Scripts:
--resumestops at reverts across sequences, a plain--broadcastover an unreadable previous export requires--start-fresh, several Ledger signers load at once, sponsored estimates include fee payer access, EIP-7702 authorizations survive fee token resolution on Tempo, and prompts work without a terminal (#18149, #18436, #18606, #18404, #18428, #18005) by @mablr, @stevencartavia, @Steven-J-22. - Traces, debugger and lints: revert data with control characters shows as hex, constructor runtimes and test linking backtraces resolve, events with struct parameters decode from the signature cache, ERC-7201 labels survive extra compiler profiles, PUSH values show in the debugger, and
reentrancy-eventsno longer treats call-free assembly as an external call.forge initandforge installsay whengitis missing (#17934, #17949, #17904, #18041, #17986, #18115, #18467, #18045) by @aelmanaa, @mablr, @stevencartavia, @PlasticDigits, @figtracer, @Osraka.
Cast and Chisel
- Cast: ENS names resolve only for address arguments, arguments after raw calldata and out-of-range
to-int256values are rejected,cast logsrejects extra topics instead of dropping them,sig --optimizeno longer wraps the nonce,decode-eventkeeps cached indexed flags, andcast wallet newworks in unreadable directories. Cast reports an unresolvable project root instead of panicking (#18119, #18252, #18072, #17682, #17755, #17990, #18007, #18586) by @mablr, @0xKarl98, @Snan0M, @clippytool, @stevencartavia, @figtracer, @Ravan002, @aelmanaa, @mattsse. - Chisel: inspection works with Solar and
--ir-minimum, calls without a return value need no semicolon, and dumps work without source matches (#18199, #18233, #18043, #18201) by @mattsse, @stevencartavia, @rome-xi, @figtracer, @aelmanaa, @mablr.
Other fixes and chores
- Fixes to changes made earlier in this release, mostly from the evm2 migration and the new invariant, symbolic, remapping and configurable-account features (#18332, #18359, #18396, #18363, #18333, #18385, #18549, #18395, #18427, #18164, #18174, #18519, #18112, #18231, #18461, #18406, #18162, #18576, #18537, #18580, #18420, #18570) by @figtracer, @mablr, @stevencartavia, @grandizzy, @joshieDo, @emmajam, @pepyakin, @0xKarl98, @mds1, @haythemsellami.
- Tests, CI, docs and refactors (#17894, #18143, #18178, #18187, #18434, #18113, #18114, #18116, #18118, #18228, #18245, #18095, #18502, #18444, #18429, #18542, #18375, #18413, #18061, #17952, #17897, #18097, #18060, #18449, #18521, #18080, #18533, #18539, #18562, #18525, #18522, #18062, #18141, #18150, #18170, #18191, #18370, #18380, #18401, #18403, #18409, #18437, #18534, #18568, #18569, #18584, #18577, #18578) by @0xKarl98, @mablr, @joshieDo, @gakonst, @figtracer, @stevencartavia, @DaniPopes, @aelmanaa, @ninglinLiu, @jenpaff.
Other behavior changes
- evm2: transfers that overflow a balance saturate instead of halting, re-selecting a fork restores its whole block environment, and
vm.setEvmVersionapplies to new calls only. Traces show halted nested calls using all forwarded gas. Anvil removes empty touched accounts (EIP-161), so state roots can differ from 1.9, and rejects EIP-4844 transactions on OP Stack networks (#17541, #18278). - Downgrades: older versions discard fork caches written by 1.10 and cannot load Anvil dumps written with
--preserve-historical-states(#17541). - Tempo T14:
cast wallet newcreates a configurable account on Tempo chains with T14 active. Pass--eoafor a conventional account (#18378, #18410). - Invariants: multi-worker campaigns no longer reserve a worker for selector focus. Use
targetSelectorto target one handler (#18184). - Symbolic execution (preview): soundness fixes turn some previously passing tests into failures with replayed counterexamples (#18057, #18090, #18101, #18175).
- Lints: the new ERC-7201 lints run on build and fail builds with
--deny warnings(#18029, #18030). - Rust API: revm types are gone from
foundry-evm*andanvil, and Anvil'sPrecompileFactoryno longer hasinstall(#17541, #18375).
Dependencies
- evm2 e25a95f, alloy 2.6.1, and foundry-core 989f05e with foundry-wallets 4d18327 (#18384, #18554, #18520, #18284, #18483, #18606) by @stevencartavia, @mablr, @0xKarl98
- Base from the
foundrybranch of foundry-rs/base, and op-alloy from thedevelopbranch of foundry-rs/optimism (#18581, #18579) by @mablr - Tempo with T14 configurable accounts (#18372, #18389, #18417, #18430, #18460, #18471, #18554) by @mablr, @zerosnacks, @stevencartavia
- rustix 1.1.6 and zip 9.0.5 for RUSTSEC-2026-0486 and RUSTSEC-2026-0548. RUSTSEC-2026-0441 (pin-utils), RUSTSEC-2026-0459 (SQLite WAL) and RUSTSEC-2026-0543 (chrono) are ignored until patched releases exist (#18399, #18532, #18146, #18255) by @mablr, @0xrusowsky
- Weekly dependency updates (#18253, #18254, #18489) by @mablr
New contributors
@clippytool, @erkancamli, @kutluhaneth46, @Naveen-6087, @PlasticDigits, @rome-xi, @Steven-J-22, @unixglo and @Ynyesto.