Skip to content

Releases: foundry-rs/foundry

Nightly (2025-09-10)

10 Sep 06:11
cff3dec
Compare
Choose a tag to compare
Nightly (2025-09-10) Pre-release
Pre-release

Other

Full Changelog:

nightly...nightly-cff3dec14a10f6f60dda6d85bd0e8446bd80b886

Nightly

10 Jul 18:13
cff3dec
Compare
Choose a tag to compare
Nightly Pre-release
Pre-release

Other

Full Changelog:

nightly...nightly-cff3dec14a10f6f60dda6d85bd0e8446bd80b886

v1.3.5

08 Sep 15:31
9979a41
Compare
Choose a tag to compare

Foundry v1.3.5

Foundry v1.3.5 is a bugfix release for cast state overrides.

Cast Fixes

Full Changelog:

v1.3.4...v1.3.5

stable

20 Dec 08:57
9979a41
Compare
Choose a tag to compare

Foundry v1.3.5

Foundry v1.3.5 is a bugfix release for cast state overrides.

Cast Fixes

Foundry v1.3.4

Foundry v1.3.4 is a bugfix release.

Forge Fixes

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

Foundry v1.3.1

Foundry v1.3.1 is a bugfix release for anvil, cast and forge.

Anvil Fixes

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

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.

⚠️ It is highly recommended to update to latest version of foundryup, which avoids unnecessary downloads and verifies hashes of downloaded binaries upon install. You can update your installation by running: foundryup --update.

Performance Improvements

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 if eth_getAccountInfo is available and falls back to the legacy method otherwise.
    Example: Running forge 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 of foundry.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, set lint_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 sequences
  • interleave: Weaves two sequences together
  • prefix: Overwrites the beginning of a sequence
  • suffix: Overwrites the end of a sequence
  • mutate args: Randomizes some call arguments

Additional notes:

  • Entries that generate new coverage are saved to disk (default: .gz; set corpus_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

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 fix NotActivated 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...
Read more

Nightly (2025-09-09)

09 Sep 06:15
79140e9
Compare
Choose a tag to compare
Nightly (2025-09-09) Pre-release
Pre-release

Other

Full Changelog:

nightly...nightly-79140e963bac2a7ac86df915ec7f281e196281a4

Nightly (2025-09-08)

08 Sep 06:12
124f134
Compare
Choose a tag to compare
Nightly (2025-09-08) Pre-release
Pre-release

Other

Full Changelog:

nightly...nightly-124f134ab286da5d0939de14378573cf24121e1e

Nightly (2025-09-07)

07 Sep 06:14
d45ff5b
Compare
Choose a tag to compare
Nightly (2025-09-07) Pre-release
Pre-release

Other

  • chore(deps): weekly cargo update (#11569) by @github-actions[bot]

Full Changelog:

nightly...nightly-d45ff5b65af924cd901d7972b14ce62caa85276c

Nightly (2025-09-06)

06 Sep 06:12
05d4a02
Compare
Choose a tag to compare
Nightly (2025-09-06) Pre-release
Pre-release

Other

Full Changelog:

nightly...nightly-05d4a02f95ca0d3c5b2017ec925dfd0380bc3ab7

Nightly (2025-09-05)

05 Sep 06:11
c732ea3
Compare
Choose a tag to compare
Nightly (2025-09-05) Pre-release
Pre-release

Other

Full Changelog:

nightly...nightly-c732ea38473cc7cd5e169120c4fbe08e40c85ef8

Nightly (2025-09-04)

04 Sep 06:14
21b69ff
Compare
Choose a tag to compare
Nightly (2025-09-04) Pre-release
Pre-release

Other

Full Changelog:

nightly...nightly-21b69ffe2c39620f45bc02f8751518b5f9ac3ac0