echidna v1.6 releases: Ethereum fuzz testing framework
echidna
Echidna is a weird creature that eats bugs and is highly electrosensitive (with apologies to Jacob Stanley)
More seriously, Echidna is a Haskell program designed for fuzzing/property-based testing of Ethereum smarts contracts. It uses sophisticated grammar-based fuzzing campaigns based on a contract ABI to falsify user-defined predicates or Solidity assertions. We designed Echidna with modularity in mind, so it can be easily extended to include new mutations or test specific contracts in specific cases.
Features
- Generates inputs tailored to your actual code
- Optional corpus collection, mutation and coverage guidance to find deeper bugs
- Optional Slither integration to extract useful information before the fuzzing campaign
- Curses-based retro UI, text-only or JSON output
- Automatic testcase minimization for quick triage
- Seamless integration into the development workflow
- Maximum gas usage reporting of the fuzzing campaign
- Support for a complex contract initialization with Etheno and Truffle
Changelog v1.6
- Slither is now a required dependency.
- Made sure that gets mapped correctly, fixing #474 (#503)
- Fix library timestamp/block delay issue (#510)
- Make stack limit exceeded a revert (#517)
- Add some default transaction constants (#532)
- Make large constants work better with dictionaries (#523)
- Fix “flanky” corpus tests (#537)
- HEVM updated to 150dddc67b6cbad75fd4ae5a689452892f55ea26 (0.42) (#511)
- this may introduce a slight performance hit as everything is partially symbolic
- Improved shrinking and pretty printing (#518)
- Integrate slither results (#451)
- Disagreements about
MonadStateandMonadReader(#545, #513) - Simplified a bunch of code (#548, #549, #513)
- Fix negative address bug (#552)
- Various Github Actions improvements (#527, #554)
- Allow to bypass EIP-170 and set up a custom max code size (#544)
Installation
docker is recommended to install Echidna.
docker pull trailofbits/echidna
docker run trailofbits/echidna
for example
docker run -v `pwd`:/src trailofbits/echidna echidna-test /src/solidity/cli.sol
If you’d prefer to build from source, use Stack. stack install . should build and compile echidna-test in ~/.local/bin You will need to link against libreadline and libsecp256k1 (built with recovery enabled), which should be installed with the package manager of your choosing. If you’re getting errors building related to linking, try tinkering with –extra-include-dirs and –extra-lib-dirs.
Use
Copyright (C) 2018
