rpctestgen is a test fixture generator for the execution layer JSON-RPC API.
Conceptually, it is similar to retesteth, in that it 1) takes
test definitions, 2) executes them against a client, and 3) outputs the
exchange.
The full API specification can be found in
ethereum/exeuction-apis.
rpctestgen runs with sane defaults. The tests will be filled with whatever
binary geth matches in the $PATH. For a full list of options, see
rpctestgen --help.
To fill all tests, simply run make fill.
$ make fill
go build .
./rpctestgen
starting client
filling tests...
generating tests/eth_blockNumber/simple-test.io done.
generating tests/eth_getBlockByNumber/get-genesis.io done.
generating tests/eth_getBlockByNumber/get-block-n.io done.This will write the generated test fixtures to tests/ directory. In addition
to JSON-RPC exchange, a chain.rlp and genesis.json will be included so that
the exchange can be verified on all clients.
The fixtures are very simple. Each statement is delimited by a newline. The
>> prefix denotes a request sent to the client. The << prefix denotes the
client's response.
>> {"jsonrpc":"2.0","id":1,"method":"eth_blockNumber"}
<< {"jsonrpc":"2.0","id":1,"result":"0x3"}