Process Ethereum VM bytecode and/or contracts
Stand-alone C++20 executable used to run EVM bytecode and contracts. Acts only as the execution layer. Allows users to run bytecode scripts, deploy contracts, and call contracts on provided state & contexts.
make all
NOTE: Dependencies must be compiled & linked into compilation aswell.
proc-evm comes with various commandline functions, including :
Run - runs bytecode as a script on the state ( no contract call )
./bin/proc-evm run --snapshotFile ./path/to/snapshot.json --blockContextFile ./path/to/blockcontext.json --txContextFile ./path/to/txcontext.json --contractCode 600260040160005260206000f3
Deploy - deploys contract on state using init code ( in the standard EVM way )
./bin/proc-evm deploy --snapshotFile ./path/to/snapshot.json --blockContextFile ./path/to/blockcontext.json --txContextFile ./path/to/txcontext.json --contractCode 6001600201600a55600D6014600039600D6000F3600260040160005260206000F3
Deploy At - deploys contract on state using init code to specified address ( useful in genesis setup )
./bin/proc-evm deployAt --snapshotFile ./path/to/snapshot.json --blockContextFile ./path/to/blockcontext.json --txContextFile ./path/to/txcontext.json --contractCode 6001600201600a55600D6014600039600D6000F3600260040160005260206000F3 --deployAddress 4200000000000000000000000000000000000000
Call - call a contract in state w/ provided args ( in the standard EVM way )
./bin/proc-evm call --contractAddress 4200000000000000000000000000000000000000 --snapshotFile ./path/to/snapshot.json --blockContextFile ./path/to/blockcontext.json --txContextFile ./path/to/txcontext.json
Note : Use -h flag on each sub-command to see more options
This repo contains a library setup aswell, to use proc-evm within your code.
Add include path to compilation -I./path/to/proc-evm/include.
Import into your code.
#include <proc-evm/proc-evm.h>
Use proc-evm functionality as desired.
This includes CallContext, Stack, Memory, Opcodes, commands, and more.
NOTE: Dependencies must be compiled & linked into compilation aswell.
- intx : 256-bit (32-byte) unsigned integers
- ethash : Ethereum hash functions
- evm-cpp-utils : EVM state & context types + utils
This repo contains various tests under ./test/ to make sure things are working.
To run use :
make run-test
make deploy-test
make deploy-at-test
make call-test
Check the diff in ./test/snapshot.json to see if things processed properly.
Brandon Roberts @b-j-roberts