History

realbigsean 63da81de62 check for eip4844 unaccessed files		2023-01-12 08:50:02 -05:00
..
src	get ef tests passing after capella rebase	2023-01-11 18:32:15 -05:00
tests	merge upstream, fix compile errors	2023-01-11 13:52:58 -05:00
.gitignore	Add a new bls test (#3235 )	2022-10-12 23:40:42 +00:00
Cargo.toml	fix compilation errors from merge	2022-12-23 10:27:01 -05:00
check_all_files_accessed.py	check for eip4844 unaccessed files	2023-01-12 08:50:02 -05:00
Makefile	add historical summaries (#3865 )	2023-01-11 12:40:21 +11:00
README.md	Update spec tests to v1.1.0-beta.4 (#2548 )	2021-09-25 05:58:35 +00:00

Consensus Specification Tests

This crate parses and executes the test vectors at ethereum/consensus-spec-tests.

Functionality is achieved only via the $ cargo test --features ef_tests command.

Running the Tests

Because the test vectors are very large, we do not download or run them by default. To download them, run (in this directory):

$ make

Note: this may download hundreds of MB of compressed archives from the ethereum/consensus-spec-tests, which may expand into several GB of files.

If successful, you should now have the extracted tests in ./consensus-spec-tests.

Run them with:

$ cargo test --features ef_tests

The tests won't run without the ef_tests feature enabled (this is to ensure that a top-level cargo test --all won't fail on missing files).

When you download the tests, the downloaded archives will be kept in addition to the extracted files. You have several options for saving space:

Delete the archives (make clean-archives), and keep the extracted files. Suitable for everyday use, just don't re-run make or it will redownload the archives.
Delete the extracted files (make clean-test-files), and keep the archives. Suitable for CI, or temporarily saving space. If you re-run make it will extract the archives rather than redownloading them.
Delete everything (make clean). Good for updating to a new version, or if you no longer wish to run the EF tests.