|
|
|
|
EVM Tool
|
|
|
|
|
========
|
|
|
|
|
|
|
|
|
|
EVM Tool is a stand alone EVM executor and test execution tool. The
|
|
|
|
|
principal purpose of the tool is for testing and validation of the EVM
|
|
|
|
|
and enclosing data structures.
|
|
|
|
|
|
|
|
|
|
Using EVM Tool in execution-specification-tests
|
|
|
|
|
-----------------------------------------------
|
|
|
|
|
|
|
|
|
|
### Building Execution Tests on macOS
|
|
|
|
|
|
|
|
|
|
Current as of 26 Jun 2024.
|
|
|
|
|
|
|
|
|
|
MacOS users will typically encounter two problems,one relating to the
|
|
|
|
|
version of Python used and one relating to zsh.
|
|
|
|
|
|
|
|
|
|
Homebrew will only install the most recent version of Python
|
|
|
|
|
as `python3`, and that is 3.11. The execution tests require 3.10. The
|
|
|
|
|
solution is to use a 3.10 version of python to set up the virtual
|
|
|
|
|
environment.
|
|
|
|
|
|
|
|
|
|
```zsh
|
|
|
|
|
python3.10 -m venv ./venv/
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Zsh requires braces to be escaped in the command line, so the step to
|
|
|
|
|
install python packages needs to escape the brackets
|
|
|
|
|
|
|
|
|
|
```zsh
|
|
|
|
|
pip install -e .\[docs,lint,test\]
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
An all-in-one script, using homebrew, would look like
|
|
|
|
|
|
|
|
|
|
```zsh
|
|
|
|
|
brew install ethereum solidity
|
|
|
|
|
git clone https://github.com/ethereum/execution-spec-tests
|
|
|
|
|
cd execution-spec-tests
|
|
|
|
|
python3 -m venv ./venv/
|
|
|
|
|
source ./venv/bin/activate
|
|
|
|
|
pip install -e .\[docs,lint,test\]
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### Building EvmTool on macOS
|
|
|
|
|
|
|
|
|
|
First you need a Java 21+ JDK installed, if not already installed.
|
|
|
|
|
|
|
|
|
|
It is recommended you install [SDKMAN](https://sdkman.io/install) to
|
|
|
|
|
manage the jvm install.
|
|
|
|
|
|
|
|
|
|
```zsh
|
|
|
|
|
sdk install java 21.0.3-tem
|
|
|
|
|
sdk use java 21.0.3-tem
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Once a JVM is installed you use the gradle target:
|
|
|
|
|
|
|
|
|
|
```zsh
|
|
|
|
|
./gradlew installDist -x test
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
The resulting binary
|
|
|
|
|
is `build/install/besu/bin/evmtool`
|
|
|
|
|
|
|
|
|
|
If the testing repository and besu are installed in the same parent
|
|
|
|
|
directory, the command to run the execution tests is
|
|
|
|
|
|
|
|
|
|
```zsh
|
|
|
|
|
fill -v tests --evm-bin ../besu/build/install/besu/bin/evmtool
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Assuming homebrew and SDKMan are both installed, the complete script is
|
|
|
|
|
|
|
|
|
|
```zsh
|
|
|
|
|
sdk install java 21.0.3-tem
|
|
|
|
|
sdk use java 21.0.3-tem
|
|
|
|
|
git clone https://github.com/hyperledger/besu
|
|
|
|
|
cd besu
|
|
|
|
|
./gradlew installDist -x test
|
|
|
|
|
cd ..
|
|
|
|
|
|
|
|
|
|
brew install ethereum solidity
|
|
|
|
|
solc-select install latest
|
|
|
|
|
solc-select use latest
|
|
|
|
|
git clone https://github.com/ethereum/execution-spec-tests
|
|
|
|
|
cd execution-spec-tests
|
|
|
|
|
python3 -m venv ./venv/
|
|
|
|
|
source ./venv/bin/activate
|
|
|
|
|
pip install -e .\[docs,lint,test\]
|
|
|
|
|
|
|
|
|
|
fill -v tests --evm-bin ../besu/build/install/besu/bin/evmtool
|
|
|
|
|
```
|
|
|
|
|
|
