Collection of JSON RPC black-box testing tools

1. Installation

   1. Prerequisites
   2. Obtaining rpc-tests

2. Integration Testing

3. Performance Testing

4. Contributing

Using rpc-tests requires installing:

• Vegeta >= 12.8.4
• Python >= 3.10
• [python3-jsonpatch] >= 1.32 (see README on integration subfolder)
• [json-diff] using npm (see README on integration subfolder)

After installation, make sure vegeta, json-diff and json-patch-jsondiff commands are available at your shell prompt.

After installation, make sure python3 and pip3 commands are available at your shell prompt by running python3 -h and pip3 -h.

To obtain rpc-tests source code for the first time:

git clone https://github.com/erigontech/rpc-tests.git

rpc-tests uses a few Python third-party libraries, so after you've updated to the latest code with

git pull

update the dependencies as well by running

sudo apt install python3-pip python3-venv
python3 -m venv .
./bin/pip3 install -r requirements.txt

Check out the dedicated guide in Integration Tests.

Check out the dedicated guide in Performance Tests.

python3 -m rpctests.block_by_number

python3 -m rpctests.empty_blocks

python3 -m rpctests.filter_changes

python3 -m rpctests.replay_request

python3 -m rpctests.replay_tx

python3 -m rpctests.subscriptions

pytest