Releases: foundry-rs/foundry
Nightly (2025-08-24)
Nightly (2025-08-25)
Nightly
Nightly (2025-08-23)
Other
- chore: fix flaky lint test (#11402) by @grandizzy
- chore(docs): mention keystore in wallet error message, improve readability (#11405) by @zerosnacks
- fix: canonicalize paths in
forge doc
(#11406) by @onbjerg - fix(cast): apply contract code size limit in cast run (#11400) by @grandizzy
Full Changelog:
v1.3.2
Foundry v1.3.2
Foundry v1.3.2 is a bugfix release for forge.
Forge Fixes
- fix(lint): explicit message when lint on build failures (#11224) by @grandizzy
- fix(lint): lint only files that we build (#11247) by @grandizzy
- fix: force 4844 txtype in blobhashes setter (#11355) by @mattsse
- fix(forge): handle error if etherscan identifier cannot resolve config (#11356) by @grandizzy
- fix: disable tx gas limit cap (#11347) by @mattsse
- fix(forge): write ordered deps in foundry.lock (#11360) by @grandizzy
- fix(invariant): ensure strategy always generates valid sender (#11370) by @grandizzy
- fix(forge): do not panic on checkpoint revert (#11380) by @grandizzy
Full Changelog:
stable
Foundry v1.3.2
Foundry v1.3.2 is a bugfix release for forge.
Forge Fixes
- fix(lint): explicit message when lint on build failures (#11224) by @grandizzy
- fix(lint): lint only files that we build (#11247) by @grandizzy
- fix: force 4844 txtype in blobhashes setter (#11355) by @mattsse
- fix(forge): handle error if etherscan identifier cannot resolve config (#11356) by @grandizzy
- fix: disable tx gas limit cap (#11347) by @mattsse
- fix(forge): write ordered deps in foundry.lock (#11360) by @grandizzy
- fix(invariant): ensure strategy always generates valid sender (#11370) by @grandizzy
- fix(forge): do not panic on checkpoint revert (#11380) by @grandizzy
Foundry v1.3.1
Foundry v1.3.1 is a bugfix release for anvil, cast and forge.
Anvil Fixes
- fix(anvil): unwrap panic in eth/backend/mem/mod.rs (#11141) by @zerosnacks
- fix: use empty 7702 auths (#11182) by @mattsse
Cast Fixes
- fix(cast): use all providers if local artifacts used (#11090) by @grandizzy
- fix(cast): improve handling of mktx --raw-unsigned with runtime validation (#11111) by @mablr
Forge Fixes
- fix(forge): consistent handling unresolved imports (#11164) by @grandizzy
- fix(lint): exclude disabled ids in multi-lint passes (#11122) by @0xrusowsky
- fix(forge): bump compilers to fix remapping sol file (#11184) by @grandizzy
- fix(coverage): disambiguate duplicate function names (#11188) by @DaniPopes
- fix(forge): set state changes journal in active fork (#11196) by @grandizzy
- fix(forge): improve error messages for etherscan verification failures (#11194) by @shiyasmohd
- fix(fmt): don't panic on stdin read failure (#11226) by @DaniPopes
- fix(forge script): repeated vm.createSelectFork with same RPC causes segfault (#11250) by @zerosnacks
Foundry v1.3.0
This release includes support for forge lint
, time-based campaigns and coverage-guided fuzzing for invariant tests, table tests, fork test improvements for Reth clients, and new EIP-712 features. Foundry v1.3.0 is built on top of the latest revm v27
Foundry v1.3.0 is built on top of the latest revm v27 and comes with an improved foundryup
installer.
foundryup
, which avoids unnecessary downloads and verifies hashes of downloaded binaries upon install. You can update your installation by running: foundryup --update
.
Performance Improvements
- This release includes an updated
revm
(#11079) and an optimized inspector stack (#11077), which enhances Forge test performance by up to 21.50% compared to previous versions
Forge Test
Repository | v1.2.3 | v1.3.0 |
---|---|---|
ithacaxyz-account | 3.69 s | 3.12 s |
solady | 2.95 s | 2.32 s |
Uniswap-v4-core | 8.03 s | 6.76 s |
sparkdotfi-spark-psm | 57.02 s | 44.76 s |
Forge Fuzz Test
Repository | v1.2.3 | v1.3.0 |
---|---|---|
ithacaxyz-account | 3.58 s | 3.39 s |
solady | 3.34 s | 2.54 s |
Uniswap-v4-core | 8.03 s | 7.46 s |
sparkdotfi-spark-psm | 3.70 s | 3.06 s |
- Forked tests using the Reth client are now faster thanks to the
eth_getAccountInfo
API (#10496 #10838), reducing account data fetching from three requests to one. Foundry detects ifeth_getAccountInfo
is available and falls back to the legacy method otherwise.
Example: Runningforge test --mt statefulFuzz_curve_test
on spark-alm-controller showed over 5 seconds in test time savings.
Provider | Response Time |
---|---|
reth-ethereum.ithaca.xyz (with eth_getAccountInfo ) |
45.21s |
reth-ethereum.ithaca.xyz (without eth_getAccountInfo ) |
50.83s |
QuickNode (Paid) | 59.66s |
Alchemy (Free Tier) | 182.12s |
Infura (Free Tier) | 176.88s |
Forge Lint
As of v1.3.0, Forge ships with a built-in linter (#10405) that analyzes Solidity code for style, correctness, and best practices.
- Lint rules are configurable in the
[lint]
section offoundry.toml
and via inline comment directives. - Lints can be customized by severity or specific rule identifiers.
- By default, linting runs during
forge build
. To disable it, setlint_on_build = false
. - For more details please refer to foundry docs:
Supported lints
Linter configuration docs
How to contribute a lint rule
Invariant Test Improvements
Time-Based Campaigns
Previously, invariant tests were limited by a fixed number of runs (default: 256
, max: 4294967295
).
Now you can run them for a specific time duration by setting the timeout
value (in seconds) in the [invariant]
section of foundry.toml
(#10190).
The test progress bar shows the number of runs and the end time.
test/GuidedTest.t.sol:CounterTest
→ invariant_Puzzle5: [4360] Runs, ends at 11:03:28 2025-06-03 UTC
→ invariant_Puzzle3: [8784] Runs, ends at 14:50:08 2025-06-04 UTC
→ invariant_Puzzle6: [77762] Runs, ends at 05:56:48 2025-06-09 UTC
→ invariant_Puzzle2: [8739] Runs, ends at 12:50:08 2025-06-02 UTC
Coverage-Guided Fuzzing
Enable this mode by setting a path to corpus_dir
in your invariant config (#10190).
The coverage-Guided fuzzing mode targets a corpus_min_size
by mutating entries a number of times (default: 5), favoring those likely to uncover new paths.
Supported mutations:
splice
: Combines two sequencesinterleave
: Weaves two sequences togetherprefix
: Overwrites the beginning of a sequencesuffix
: Overwrites the end of a sequencemutate args
: Randomizes some call arguments
Additional notes:
- Entries that generate new coverage are saved to disk (default:
.gz
; setcorpus_gzip = false
to save as JSON). - On reruns, the saved corpus is loaded and reused.
- Metadata (as JSON) is persisted for evicted corpus entries. This includes a unique ID, mutation count, and coverage improvements.
- The fuzzing progress bar displays metrics for cumulative edges and features, corpus count and number of favored entries.
test/forge/invariant/StaticInvariantTest.sol:StaticInvariantTest
→ invariantHealthy: [60/2000] Runs
- cumulative edges seen: 41
- cumulative features seen: 6
- corpus count: 15
- favored items: 14
For more details please refer to invariant docs.
Table Tests
Foundry v1.3.0 comes with support for table testing (#10775), which enables the definition of a dataset (the "table") and the execution of a test function for each entry in that dataset. This approach helps ensure that certain combinations of inputs and conditions are tested.
For more details please refer to table testing foundry docs.
Improved EIP-712 support
Foundry v1.3.0 comes with additional utilities (commands and new cheatcodes) to make it easy and reliable to work with EIP-712 signatures (#10510).
For more details please refer to EIP-712 foundry guide.
Other
- new Anvil APIs including endpoints to deal and set allowance for ERC20 tokens, add balance and get blob by hash
- Vyper support for
forge verify-contract
command fail_on_revert
config for stateless fuzz tests
Anvil Features
- feat(anvil): add block context overrides for eth_call and eth_estimateGas (#10487) by @mablr
- feat: added rpc method to deal ERC20 tokens (#10495) by @Soubhik-10
- feat: implement add_balance endpoint (#10636) by @pistomat
- feat: Add anvil set erc20 allowance endpoint (#10746) by @pistomat
- feat: added eth_sendRawTransactionSync and eth_sendTransactionSync support for anvil (#10860) by @Rimeeeeee
- feat(
anvil
): reset to in-mem (#10897) by @yash-atreya - feat: added get_blob_by_hash (#10987) by @Soubhik-10
- feat: add support for passthrough of debug_codeByHash (#11053) by @cakevm
- feat(anvil): use signatures identifier for --print-traces (#11070) by @mattsse
Anvil Fixes
- fix(anvil): guard against the blockchain advancing while checking latest block (#10714) by @alexghr
- bug(anvil): incorrectly adds +1 gas when estimating transactions with explicit empty data field (#10786) by @gitToki
- fix(
anvil
): inject the P256 precompile for--odyssey
upon EVM construction and fixNotActivated
error for--optimism
(#10567) by @zerosnacks - fix(
anvil
): latest evm version should be prague (#10653) by @yash-atreya - fix: populate missing fields for eth simulate (#10682) by @mattsse
- fix: receipt conversion (#10853) by @mattsse
- fix: spawn state writer blocking (#10922) by @mattsse
- fix: dont check pool for gettransaction receipt (#10946) by @mattsse
- fix: use correct mix hash for header (#10951) by @mattsse
- fix: use existing functions for accountinfo (#11134) by @mattsse
- fix(anvil): unwrap panic in eth/backend/mem/mod.rs (#11141) by @zerosnacks
Cast Features
Nightly (2025-08-22)
Other
- feat: Remove unneeded TODO in EtherscanIdentifier (#11385) by @aganisgash
- ci: enable testing for aarch64 linux (#11386) by @DaniPopes
- test(anvil): ignore flaky tests (#11389) by @DaniPopes
- test(cheatcodes): strings with {} are not roundtrippable (#11391) by @DaniPopes
- fix(cast): calldata-decode --json nested tuple formatting (#11212) by @minhd-vu
- chore(cheatocodes): remove as_debug (#11395) by @DaniPopes
- chore: remove a bunch of unnecessary #[inline] (#11397) by @DaniPopes
Full Changelog:
Nightly (2025-08-21)
Other
- feat(lint): geiger (#11377) by @0xrusowsky
- feat(config): support numeric keys in
[fork.<chain>]
section (#11340) by @0xrusowsky - feat: refactor precompiles decoding, show output (#11382) by @DaniPopes
- feat: add nushell completions (#11311) by @0xferrous
- Fix/cast abi strict args (#11189) by @simon0820s
- chore: aggregate PRs (#11384) by @DaniPopes
- fix(invariant): ensure strategy always generates valid sender (#11370) by @grandizzy
Full Changelog:
Nightly (2025-08-21)
Other
- fix(forge): write ordered deps in foundry.lock (#11360) by @grandizzy
- fix(forge): handle error if etherscan identifier cannot resolve config (#11356) by @grandizzy
- feat(lint): mixedCase exceptions (#11330) by @0xrusowsky
Full Changelog:
Nightly (2025-08-19)
Other
- feat(cheats): support arrays + rename
read
+ resolve env vars (#11302) by @0xrusowsky