testeth via RPC. Test run, generation by t8ntool protocol
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.
winsvega 3a8e440113
Update README.md
3 months ago
cmake Remove cryptopp dependency 5 months ago
libdataobj support retesteth file.json cmd style type 3 months ago
libdevcore remove namespace fs=boost::filesystem from headers 7 months ago
libdevcrypto Remove unused crypto functions 5 months ago
retesteth fix thread race 3 months ago
web update nimbus configs 3 months ago
.clang-format refactor state test generation 3 years ago
.gitignore gitignore 5 years ago
CMakeLists.txt update besu config to t8n 3 months ago
Dockerfile update solc version in Dockerfile 3 months ago
LICENSE add GPL license 5 years ago
README.md Update README.md 3 months ago
circle.yml update go1.19 for circle linux 3 months ago
cleanincludes.sh remove redundant includes in cpp 7 months ago
dretesteth.sh fix dretesteth --help and --version flags 5 months ago
toolchain.cmake update to CXX17 7 months ago



tests execution/generation via transition tool (t8n) (https://ethereum-tests.readthedocs.io/en/latest/t8ntool-ref.html)
(Execution stats: http://retesteth.ethdevops.io/)


If installed in the system, simply navigate to ethereum/tests
Need supported client's t8n alises in the system path. To generate complex test need solc, lllc in the system path.

Execute test:

retesteth test.json     

Generate test:

retesteth testFiller.json --filltests

Debug options: --vmtrace, --statediff, --poststate and many more.
retesteth --help for more info and documentation: https://ethereum-tests.readthedocs.io

Or docker version: http://retesteth.ethdevops.io/release/0.3.0-shanghai/dretesteth-0.3.0-shanghai.tar

The Goal

  • A test tool that would be capable of running current Blockchain/State tests against any client
  • On client side use transition tool executable which exports client core logic of transaction execution on given state
  • Filling existing tests (generating post state from *Filler.json/yml/py instruction files) using the above and any existing client
  • Running request - response tests with a provided client
  • Bunch tests execution with many clients with many threads
  • A minimum set of additional RPC methods for client to negotiate with the tool: https://github.com/ethereum/retesteth/wiki/RPC-Methods
  • Or a simple transition tool that is also usefull for transaction debugging: https://ethereum-tests.readthedocs.io/en/latest/t8ntool-ref.html

Current progress

  • geth t8n supported
  • ethereumjs t8n supported
  • nimbus t8n supported
  • besu t8n [maintanence]

Building instructions

Ubuntu (retesteth):

git clone git@github.com:ethereum/retesteth.git
cd retesteth
mkdir build
cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make -j4

MacOS (retesteth + tests + geth):

HOMEBREW_NO_AUTO_UPDATE=1 brew install -q cmake ninja git go@1.16
git clone --depth 1 https://github.com/ethereum/go-ethereum.git
git clone --depth 1 https://github.com/ethereum/tests.git
cd go-ethereum
make all
ln -s ./build/bin/evm /usr/local/bin/evm
cd ..
git clone https://github.com/ethereum/retesteth.git
cd retesteth
mkdir build
cd build
cmake .. -G Ninja -DCMAKE_BUILD_TYPE=Release -DCMAKE_TOOLCHAIN_FILE=../toolchain.cmake
cmake --build .

MacOS / Ubuntu dependecy issues: If one of the following dependecies is failing to autoinstall, some times due to outdated version or fails to build on OS, you can install it locally from a version that works (newer) and select in -DLOCALDEPS flag

rm -r /root/.hunter
rm CMakeCache.txt

Try building instruction for beginners: retesteth + solidity build


Wiki: https://github.com/ethereum/retesteth/wiki Requires to have a client installed on your system. Read the wiki page on detailed instruction on how to configure your client to work with retesteth https://github.com/ethereum/retesteth/wiki/Add-client-configuration-to-Retesteth

./retesteth -t GeneralStateTests -- --testpath "your path to ethereum/tests repo"

Docker instructions

See: https://github.com/ethereum/retesteth/wiki/Docker-instructions

RPC Methods

See: https://github.com/ethereum/retesteth/wiki/RPC-Methods


Telegram: @wdimitry

Building instructions for beginners



sudo apt-get update
sudo apt-get install git g++ build-essential


Make sure the version is higher than VERSION 3.9.3, otherwise install cmake from a different source

sudo apt-cache policy cmake
sudo apt-get install cmake


cd ~
mkdir Ethereum
cd Ethereum
git clone https://github.com/ethereum/retesteth.git
cd retesteth
mkdir build
cd build
cmake ..

Now you should see the successful build files generation result:

Configuring done
-- Generating done
-- Build files have been written

Run the build command to compile: -j threadCount to optimize the build speed. Depending on your processor threads it will increase the building speed.

make -j4


check the available boost version by sudo apt-cache policy libboost-all-dev

install boost dependency boost if version >=1.65 sudo apt-get install libboost-all-dev

Solidity building instructions:

cd ~
cd Ethereum
git clone https://github.com/ethereum/solidity.git
cd solidity
git checkout 8f2595957bfc0f3cd18ca29240dabcd6b2122dfd
mkdir build
cd build
cmake .. -DLLL=1
make lllc -j4