Releases: foundry-rs/foundry
Nightly (2025-09-10)
Other
- fix(forge): update only the specific dep (#11588) by @grandizzy
- fix(forge): custom verifiers should not throw on unknown etherscan chains (#11442) by @grandizzy
- refactor(deps): reuse aws and gcp package from alloy (#11573) by @TropicalDog17
Full Changelog:
Nightly
Other
- fix(forge): update only the specific dep (#11588) by @grandizzy
- fix(forge): custom verifiers should not throw on unknown etherscan chains (#11442) by @grandizzy
- refactor(deps): reuse aws and gcp package from alloy (#11573) by @TropicalDog17
Full Changelog:
v1.3.5
Foundry v1.3.5
Foundry v1.3.5 is a bugfix release for cast state overrides.
Cast Fixes
- fix(cast): allow comma-separated values for overrides (#11577 ) by @grandizzy
Full Changelog:
stable
Foundry v1.3.5
Foundry v1.3.5 is a bugfix release for cast state overrides.
Cast Fixes
- fix(cast): allow comma-separated values for overrides (#11577 ) by @grandizzy
Foundry v1.3.4
Foundry v1.3.4 is a bugfix release.
Forge Fixes
- fix: bump version v1.3.4 (#11529 ) by @grandizzy
Foundry v1.3.3
Foundry v1.3.3 is a bugfix release for forge.
Forge Fixes
- fix(forge): do not throw if etherescan api key set and unknown chain (#11444) by @grandizzy
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 writ...
Nightly (2025-09-09)
Other
- feat(common): identify bytes and string slots using storageLayout (#11476) by @yash-atreya
- feat: make
find_by_deployed_code_exact
smarter (#11560) by @klkvr - feat(cheatcodes): vm.getStorageSlots (#11537) by @yash-atreya
- chore(meta): add missing alloy patches (#11581) by @DaniPopes
- Fix panic on NaN/Inf values in TOML to JSON conversion (#11574) by @prestoalvarez
Full Changelog:
Nightly (2025-09-08)
Other
- chore: bump v1.3.5 (#11576) by @grandizzy
- fix(forge): show logs and coverage for table tests (#11575) by @grandizzy
Full Changelog:
Nightly (2025-09-07)
Nightly (2025-09-06)
Other
- chore: fix isolate workflow, exclude state diff (#11558) by @grandizzy
- feat(lint): impl erc20 transfer check using HIR (#11552) by @0xrusowsky
- fix(cast): allow comma-separated values for overrides (#11553) by @grandizzy
- feat(forge): add --empty to forge init (#11554) by @aganisgash
Full Changelog:
Nightly (2025-09-05)
Other
- Update to soldeer 0.7.0 (#11543) by @mario-eth
- fix: workflow event conclusion (#11544) by @o-az
- fix(forge): skip scripts in get_sources_to_compile (#11540) by @DaniPopes
- Update documentation for transaction hash fetching (#11546) by @ritzdorf
- chore(config): figment provider clean up (#11539) by @DaniPopes
- fix(cast): correct error message for --ends-with hex parsing (#11549) by @Forostovec
Full Changelog:
Nightly (2025-09-04)
Other
- chore: tweak
npm
publish & handlenightly
releases (#11513) by @o-az - fix: bump version v1.3.4 (#11514) by @grandizzy
- feat(forge verify-contract): update Sourcify integration to support API v2 (#11438) by @manuelwedler
- fix(
forge lint
): addURI
(e.g.tokenURI
from ERC721 / ERC6909) as exception tomixed-case-function
(#11533) by @zerosnacks - refactor(chisel): refactor crate (#11500) by @DaniPopes
- test: redact test which may install solc (#11534) by @DaniPopes
- feat(forge): add params natspec for enums (#10022) by @samooyo
- fix: Shell deadlock 2 (#11535) by @DaniPopes
- refactor(common): remove
ReportKind
struct (#11511) by @mablr - perf: parallelize remappings provider (#11536) by @DaniPopes
- chore(evm): re-use project output in SourceData (#11541) by @DaniPopes