Foundry is a blazing fast, portable and modular toolkit for Ethereum application development written in Rust.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
Go to file
Matthias Seitz 0f1dea4f46
fix(evm): clone current journaled state if active (#4667)
23 hours ago
.cargo fmt: all (#3398) 6 months ago
.github ci: rm redundant env setting (#4606) 2 weeks ago
anvil fix(anvil): properly detect tx type based on tx fields (#4663) 1 day ago
binder use workspace dependency for ethers-rs (#4613) 1 week ago
cast chore: remove unwrap (#4655) 4 days ago
chisel fix(chisel): respect --use and --offline (#4657) 3 days ago
cli fix(cast): cast wallet keystore regression (#4641) 6 days ago
common use workspace dependency for ethers-rs (#4613) 1 week ago
config chore(clippy): make clippy happy (#4647) 5 days ago
doc use workspace dependency for ethers-rs (#4613) 1 week ago
docs/dev fix: empty `setUp` with default sender on `forge script` (#3817) 4 months ago
evm fix(evm): clone current journaled state if active (#4667) 23 hours ago
fmt use workspace dependency for ethers-rs (#4613) 1 week ago
forge fix(evm): clone current journaled state if active (#4667) 23 hours ago
foundryup fix install script (#4644) 6 days ago
macros use workspace dependency for ethers-rs (#4613) 1 week ago
testdata fix(evm): clone current journaled state if active (#4667) 23 hours ago
ui use workspace dependency for ethers-rs (#4613) 1 week ago
utils fix struct name output by only returning last name segment (#4646) 5 days ago
.dockerignore feat: alpine based docker image (#981) 1 year ago
.git-blame-ignore-revs chore: add .git-blame-ignore-revs (#4358) 1 month ago
.gitignore feat: add serde feature flag to anvil-core (#3603) 5 months ago
CONTRIBUTING.md Fix: typos (#3408) 6 months ago
Cargo.lock chore(deps): bump ethers (#4621) 1 week ago
Cargo.toml chore(deps): bump ethers (#4621) 1 week ago
Dockerfile fix(docker): libc (#3893) 4 months ago
LICENSE-APACHE fmt: all (#3398) 6 months ago
LICENSE-MIT fmt: all (#3398) 6 months ago
README.md chore(README): add chisel install instructions (#4421) 1 month ago
deny.toml Fix misspells (#4583) 2 weeks ago
rustfmt.toml respect silent argument in script command (#4160) 2 months ago

README.md

Foundry logo

Foundry

Github Actions Telegram Chat Telegram Support

Foundry is a blazing fast, portable and modular toolkit for Ethereum application development written in Rust.

Foundry consists of:

  • Forge: Ethereum testing framework (like Truffle, Hardhat and DappTools).
  • Cast: Swiss army knife for interacting with EVM smart contracts, sending transactions and getting chain data.
  • Anvil: Local Ethereum node, akin to Ganache, Hardhat Network.
  • Chisel: Fast, utilitarian, and verbose solidity REPL.

Need help getting started with Foundry? Read the 📖 Foundry Book (WIP)!

Demo

Installation

Having issues? See the troubleshooting section.

First run the command below to get foundryup, the Foundry toolchain installer:

curl -L https://foundry.paradigm.xyz | bash

If you do not want to use the redirect, feel free to manually download the foundryup installation script from here.

Then, run foundryup in a new terminal session or after reloading your PATH.

Other ways to use foundryup, and other documentation, can be found here. Happy forging!

Installing from Source

For people that want to install from source, you can do so like below:

git clone https://github.com/foundry-rs/foundry
cd foundry
# install cast + forge
cargo install --path ./cli --profile local --bins --locked --force
# install anvil
cargo install --path ./anvil --profile local --locked --force
# install chisel
cargo install --path ./chisel --profile local --locked --force

Or via cargo install --git https://github.com/foundry-rs/foundry --profile local --locked foundry-cli anvil chisel.

Installing for CI in Github Action

See https://github.com/foundry-rs/foundry-toolchain GitHub Action.

Installing via Docker

Foundry maintains a Docker image repository.

You can pull the latest release image like so:

docker pull ghcr.io/foundry-rs/foundry:latest

For examples and guides on using this image, see the Docker section in the book.

Installing on Windows

If you encounter issues installing Foundry on your machine, we recommend trying to use Windows Subsystem for Linux (WSL) as an alternative. WSL allows you to run Linux applications directly on Windows, which can help avoid some common installation problems. You can follow the instructions provided by Microsoft to install WSL on your Windows machine WSL

Manual Download

You can manually download nightly releases here.

Forge

Features

  • Fast & flexible compilation pipeline
    • Automatic Solidity compiler version detection & installation (under ~/.svm)
    • Incremental compilation & caching: Only changed files are re-compiled
    • Parallel compilation
    • Non-standard directory structures support (e.g. Hardhat repos)
  • Tests are written in Solidity (like in DappTools)
  • Fast fuzz testing with shrinking of inputs & printing of counter-examples
  • Fast remote RPC forking mode, leveraging Rust's async infrastructure like tokio
  • Flexible debug logging
    • DappTools-style, using DsTest's emitted logs
    • Hardhat-style, using the popular console.sol contract
  • Portable (5-10MB) & easy to install without requiring Nix or any other package manager
  • Fast CI with the Foundry GitHub action.

How Fast?

Forge is quite fast at both compiling (leveraging ethers-solc) and testing.

See the benchmarks below. More benchmarks can be found in the v0.2.0 announcement post and in the Convex Shutdown Simulation repository.

Testing Benchmarks

Project Forge DappTools Speedup
transmissions11/solmate 2.8s 6m34s 140x
reflexer-labs/geb 0.4s 23s 57.5x
Rari-Capital/vaults 0.28s 6.5s 23x

Note: In the above benchmarks, compilation was always skipped

Compilation Benchmarks

Compilation benchmarks

Takeaway: Forge compilation is consistently faster by a factor of 1.7-11.3x, depending on the amount of caching involved.

Cast

Cast is a swiss army knife for interacting with Ethereum applications from the command line.

More documentation can be found in the cast package.

Configuration

Using foundry.toml

Foundry is designed to be very configurable. You can configure Foundry using a file called foundry.toml in the root of your project, or any other parent directory. See config package for all available options.

Configuration can be arbitrarily namespaced by profiles. The default profile is named default (see "Default Profile").

You can select another profile using the FOUNDRY_PROFILE environment variable. You can also override parts of your configuration using FOUNDRY_ or DAPP_ prefixed environment variables, like FOUNDRY_SRC.

forge init creates a basic, extendable foundry.toml file.

To see your current configuration, run forge config. To see only basic options (as set with forge init), run forge config --basic. This can be used to create a new foundry.toml file with forge config --basic > foundry.toml.

By default forge config shows the currently selected foundry profile and its values. It also accepts the same arguments as forge build.

DappTools Compatibility

You can re-use your .dapprc environment variables by running source .dapprc beforehand using a Foundry tool.

Additional Configuration

You can find additional setup and configurations guides in the Foundry Book:

Troubleshooting Installation

libusb Error When Running forge/cast

If you are using the binaries as released, you may see the following error on MacOS:

dyld: Library not loaded: /usr/local/opt/libusb/lib/libusb-1.0.0.dylib

In order to fix this, you must install libusb like so:

brew install libusb

Out of Date GLIBC Error When Running forge From Default foundryup Install:

If you run into an error resembling the following when using foundryup:

forge: /lib/x86_64-linux-gnu/libc.so.6: version 'GLIBC_2.29' not found (required by forge)

There are 2 workarounds:

  1. Building from source: foundryup -b master
  2. Using Docker

Contributing

See our contributing guidelines.

Getting Help

First, see if the answer to your question can be found in book, or in the relevant crate.

If the answer is not there:

If you want to contribute, or follow along with contributor discussion, you can use our main telegram to chat with us about the development of Foundry!

Acknowledgements

  • Foundry is a clean-room rewrite of the testing framework DappTools. None of this would have been possible without the DappHub team's work over the years.
  • Matthias Seitz: Created ethers-solc which is the backbone of our compilation pipeline, as well as countless contributions to ethers, in particular the abigen macros.
  • Rohit Narurkar: Created the Rust Solidity version manager svm-rs which we use to auto-detect and manage multiple Solidity versions.
  • Brock Elmore: For extending the VM's cheatcodes and implementing structured call tracing, a critical feature for debugging smart contract calls.
  • All the other contributors to the ethers-rs & foundry repositories and chatrooms.