# Merge F2F Interop Event: EthereumJS Client ###### tags: `EthereumJS` `Merge` `Interop` ## Introduction See [Client Milestone Tracker](https://hackmd.io/_9XZIkDBTlqGJejVnOSOJg?view) for a general overview. If you get a connection going - amazing! Let us know or mark it in the milestone tracker hackmd and find Ryan or Holger to try out Mx+1 🙂! If you have any issues or logs to report please send to Ryan (@ralxz on telegram) ## EthereumJS Setup Please ensure you have Node 12.x+ installed (16.x preferred, 12.x+ should work fine) 1. `git clone --depth 1 --branch merge-contd-2 https://github.com/ethereumjs/ethereumjs-monorepo.git` 2. `cd ethereumjs-monorepo` 4. `npm i` 5. `cd packages/client` ### Ports Our JSON-RPC API for both `eth_` and `engine_` are currently served on port `8545` (if you'd like to change ports: `--rpcport` or `--port` for devp2p port. we will separate `engine_` onto a different port as a next task) ### Endpoints We don't currently have the entire `eth_` JSON-RPC API implemented, but have some key ones including `eth_getBlockByNumber` with `latest` and `earliest`. `eth_getLogs` currently mocked as an empty response (as a hack for Merge interop). ## M2 1-to-1 Interop (no transition) ### EthereumJS <-> Lodestar (M2) First start the EthereumJS client: ```shell! npm run client:start -- --gethGenesis=./test/testdata/geth_genesis_merge_interop_taunas.json --rpc --rpcEngine --rpcport=8545 --loglevel=debug ``` * (the `./test/testdata/geth_genesis_merge_interop_taunas.json` file exists in the branch you checked out) Install Lodestar following the [Amphora instructions](https://github.com/ChainSafe/lodestar/tree/master/amphora#amphora-readme) and run with: ```shell ./lodestar dev --genesisValidators 32 --startValidators 0:31 \ --api.rest.enabled --api.rest.host 0.0.0.0 \ --sync.isSingleNode \ --eth1.enabled --eth1.providerUrls http://localhost:8545/ \ --logFile beacon.log --logLevelFile debug --logRotate --logMaxFiles 5 \ --params.SECONDS_PER_SLOT 4 \ --params.ALTAIR_FORK_EPOCH 0 \ --params.MERGE_FORK_EPOCH 0 \ --params.TERMINAL_TOTAL_DIFFICULTY 0 \ --genesisEth1Hash=0x9287c1b0a22416cd3122d466ad7d79f80886e028a596e6bb9d525c3e4de37709 \ --execution.urls http://localhost:8545/ ``` ## M3 1-to-1 Interop (with transition) ### EthereumJS <-> Lodestar (M3) You can use the following key pair for running the EthereumJS client and start mining: ```shell= Address: 0xf6b913c5747c0ae128adc0e41f0adfd88aff7bc9 Private key: 0x17eb958eb18cb2ecbf8ad26b9f008db9baa3d6dbf80ad949cf261f327e58ea6c ``` Run the EthereumJS client with: ```shell! npm run client:start -- --gethGenesis=./test/testdata/geth_genesis_merge_interop_taunas_own_signer.json --rpc --rpcEngine --rpcport=8545 --loglevel=debug --mine --unlock=0xf6b913c5747c0ae128adc0e41f0adfd88aff7bc9 ``` When prompted unlock the miner account with the private key from above. Start the Lodestar client with: ```shell ./lodestar dev --genesisValidators 32 --startValidators 0:31 \ --api.rest.enabled --api.rest.host 0.0.0.0 \ --sync.isSingleNode \ --eth1.enabled --eth1.providerUrls http://localhost:8545/ \ --logFile beacon.log --logLevelFile debug --logRotate --logMaxFiles 5 \ --params.SECONDS_PER_SLOT 4 \ --params.ALTAIR_FORK_EPOCH 0 \ --params.MERGE_FORK_EPOCH 1 \ --params.TERMINAL_TOTAL_DIFFICULTY 66 \ --execution.urls http://localhost:8545/ ``` ## Hacknet v2 For running an Eth2 client EthereumJS client combination on [Hacknet v2](https://github.com/karalabe/hacknet/tree/main/v2) you need to clone the repository (`git clone https://github.com/karalabe/hacknet.git`), directory is assumed to be on the same level as the `ethereumjs-monorepo` directory. ### EthereumJS / Lodestar Update to the latest state of the `merge-contd-2` branch (see above) with `git pull merge-contd-2` and reinstall and build with `npm i` from the root of the monorepo. Then start the EthereumJS client with: ```shell! rm -Rf [DATA_DIRECTORY] && DEBUG=devp2p:eth npm run client:start -- --gethGenesis=../../../hacknet/v2/genesis.json --rpc --rpcEngine --rpcport=8545 --loglevel=debug --bootnodes=35.178.114.73:30303 ``` Follow installing and running Loadstar from [these instructions](https://github.com/ChainSafe/lodestar/tree/merge-interop/amphora/v2). For more reproduceable results you might run with deleting the data folder before: ```shell! rm -Rf amphora/v2/temp/ && amphora/v2/run.sh ``` ## Mergemock (WIP, have not gotten working on local yet -ryan) Follow the [quick start instructions](https://github.com/protolambda/mergemock#quick-start). Update `genesis.json` and set `terminalTotalDifficulty` to `37179869184` Run client with: ```bash! npm run client:start -- --gethGenesis=../../../mergemock/genesis.json --rpc --rpcEngine --rpcport=8545 --loglevel=debug ``` Copy the `enode://` from this logged line: ```bash! INFO [10-08|10:30:07] Listener up transport=rlpx url=enode://0da614598ab5996889fc6f28983a1169e3508e8e07f0c1102fa55f7d7c047678c98465721a414b97a158673f49456bb138d45376d373c9b5593eb028241df935@[::]:30303 ``` and replace `[::]` with `0.0.0.0` Run mergemock with: ```bash! ./mergemock consensus --engine="http://localhost:8545" --slot-time="5s" --ttd=37179869184 --node="enode://0da614598ab5996889fc6f28983a1169e3508e8e07f0c1102fa55f7d7c047678c98465721a414b97a158673f49456bb138d45376d373c9b5593eb028241df935@0.0.0.0:30303" ```