Skip to content
testeth via RPC
C++ CMake Other
Branch: master
Clone or download
Latest commit 9c33be8 Aug 14, 2019

README.md

retesteth

testeth via RPC (wiki: https://github.com/ethereum/retesteth/wiki)

A test generaion tool for the test fillers https://github.com/ethereum/tests/tree/develop/src

! notice: This is a prototype and WIP !

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
  • now: Use retesteth to produce fork tests with geth/pantheon/aleth
  • soon: Blockchain test generation support

Building instructions

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

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

Skype: wins_vega

You can’t perform that action at this time.