retesteth
testeth via RPC (wiki: https://github.com/ethereum/retesteth/wiki)
(Execution stats: http://retesteth.ethdevops.io/)
- A test generaion tool for the test fillers https://github.com/ethereum/tests/tree/develop/src
- Building instruction for beginners: retesteth + solidity build
- Usage tutorial
The Goal
- A test tool that would be capable of running current Blockchain tests against any client by sending rpc request to the client instatnce on either local or remote host. (using unix or TCP sockets)
- Filling existing tests (generating post state from *Filler.json instruction files) using rpc and any exisiting client
- Running rpc request - response tests with a provided client on localhost
- 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
Current progress
- done: State tests execution and filling was done as PoC on ethereum cpp client (aleth)
- done: Tests execution using threads on localhost with multimple instances of a client (geth + aleth)
- done: Develop minimum set of rpc methods that are to be implemented on other clients and could be used to run tests via rpc
- done: PoC Running Blockchain tests using geth client
- done: Implement a set of PoC methods in other client then aleth
- done: Refactoring and stability when generating GeneralStateTests
- done: Blockchain test generation support
- now: Use retesteth to produce fork tests with geth/besu/aleth
- now: Refactor the code, impove stability
Building instructions
git clone [email protected]:ethereum/retesteth.git
cd retesteth
mkdir build
cd build
cmake ..
make -j4
Or try building instruction for begginers: retesteth + solidity build
Usage
WIKI: https://github.com/ethereum/retesteth/wiki
Requres 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
Docker instructions
See: https://github.com/ethereum/retesteth/wiki/Docker-instructions
RPC Methods
See: https://github.com/ethereum/retesteth/wiki/RPC-Methods
Contact
Telegram: @wdimitry
Building instructions for beginners
Dependencies
GIT
sudo apt-get update
sudo apt-get install git g++ build-essential
Cmake
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
Retesteth
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
Solidity
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