README.md

Near-evm

EVM interpreter as a NEAR smart contract.

It uses the EVM interpreter from parity-ethereum.

Pre-requisites

To develop Rust contracts you would need to:

• Install Rustup:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

• Add wasm target to your toolchain (if you already have installed Rust make sure to switch to rustup default stable):

rustup target add wasm32-unknown-unknown

Building

$ ./build.sh

This will build the contract code in res/near_evm.wasm.

Usage

Deploy contract on TestNet:

• Make sure you have the newest version of near-shell installed by running:

npm install -g near-shell

• If you are using TestNet, call near login (if you are using local node use NODE_ENV=development before commands below).

• Create contract's account, e.g. we will use evm:

near create_account evm --masterAccount=<account you used in near login/test.near for local>

• Deploy the compiled contract from res/near_evm.wasm at the building step:

near deploy --accountId=evm --wasmFile=res/near_evm.wasm

• TODO: hackery to actually deploy your EVM contract

Testing

1. Build the evm contract
   1. Ensure truffle is installed
   • npm i -g truffle
   1. Build the test contracts cd src/tests && ./build.sh
   2. build the Near EVM contract binary
   • cd ../.. && ./build.sh
2. Run the all tests including integration test
   1. cargo test --lib
3. To run the RPC tests:
   1. Run a local NEAR node
   2. check out nearcore from github
   3. compile and run nearcore - cd nearcore && python scripts/start_unittest.py --local --release
   4. Run the tests from this directory in another terminal window:
   • cargo test

Troubleshooting

You may need to install nightly if you get an error similar to the following:

error[E0554]: `#![feature]` may not be used on the stable release channel

1. Install nightly
   1. rustup toolchain install nightly
2. Run the Testing commands again