Skip to content

Releases: foundry-rs/foundry

Nightly (2025-08-24)

24 Aug 06:13
e90a623
Compare
Choose a tag to compare

Nightly (2025-08-25)

25 Aug 06:12
38d01e1
Compare
Choose a tag to compare
Nightly (2025-08-25) Pre-release
Pre-release

Other

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

Full Changelog:

nightly...nightly-38d01e1e069187b1ec217d4873756bb9e9718cee

Nightly

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

Other

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

Full Changelog:

nightly...nightly-38d01e1e069187b1ec217d4873756bb9e9718cee

Nightly (2025-08-23)

23 Aug 06:12
ad2e7ae
Compare
Choose a tag to compare
Nightly (2025-08-23) Pre-release
Pre-release

Other

Full Changelog:

nightly...nightly-ad2e7aeda5161a300f4e4154a834906b53c43d17

v1.3.2

21 Aug 16:34
c4245d6
Compare
Choose a tag to compare

Foundry v1.3.2

Foundry v1.3.2 is a bugfix release for forge.

Forge Fixes

Full Changelog:

v1.3.1...v1.3.2

stable

20 Dec 08:57
c4245d6
Compare
Choose a tag to compare

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 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

  • feat: add cast da-estimate (#10588) by @mattsse
  • feat(cast mktx): add support for "--ethsign" option (#10641) by @mablr
  • feat(cast): add --cost for `es...
Read more

Nightly (2025-08-22)

22 Aug 06:12
6071d59
Compare
Choose a tag to compare
Nightly (2025-08-22) Pre-release
Pre-release

Other

Full Changelog:

nightly...nightly-6071d59dc5b1d9d411822fe92f4182d204a10e00

Nightly (2025-08-21)

21 Aug 12:19
599f5e0
Compare
Choose a tag to compare
Nightly (2025-08-21) Pre-release
Pre-release

Other

Full Changelog:

nightly...nightly-599f5e04555c440c30b8e77c8a7c785dfd57b121

Nightly (2025-08-21)

21 Aug 06:11
3e32767
Compare
Choose a tag to compare
Nightly (2025-08-21) Pre-release
Pre-release

Other

Full Changelog:

nightly...nightly-3e32767d2f15ddac6232b82b4afd84d8c2c028f9

Nightly (2025-08-19)

19 Aug 06:46
e345c17
Compare
Choose a tag to compare
Nightly (2025-08-19) Pre-release
Pre-release

Other

  • feat(cheats): support arrays + rename read + resolve env vars (#11302) by @0xrusowsky

Full Changelog:

nightly...nightly-e345c17f03f9e60099d2e5d957e5d5174adefdfb