Foundry with ZKsync Era

April 1, 2026 · View on GitHub

Install | Limitations | User Book | ZKsync Docs

Foundry ZKsync is a specialized fork of Foundry, tailored for ZKsync.

It extends Foundry's capabilities for Ethereum app development to support ZKsync, allowing for the compilation, deployment, testing, and interaction with smart contracts on ZKsync.

  • Latest upstream merge commit: c0fe76c
  • Pinned zksolc version: v1.5.15

🐞 Found an Issue?: Please report it to help us improve by opening an issue or submitting a pull request.

📖 User Book

For detailed information, including installation instructions, usage examples, and advanced guides, please refer to the Foundry ZKsync Book.

*If you are interested in contributing to the book, please refer to the Foundry ZKsync Book repository.*

🤝 Contributing

See our contributing guidelines.

🗣️ Getting Help

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

If the answer is not there:

Support

Having trouble? Check the Foundry Docs, or open an issue.

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in these crates by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

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 (now foundry-compilers) 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.
  • Thank you to Depot for sponsoring us with their fast GitHub runners and sccache, which we use in CI to reduce build and test times significantly.
  • All the other contributors to the ethers-rs, alloy & foundry repositories and chatrooms.

Foundry ZKsync