#TestingTheMerge is an Ethereum community initiative to test the merge upgrade with various testnets. It is being spear headed by Marius van der Wijden and Parithosh Jayanthi. It is meant to test the recent experimental features added to various Ethereum clients supporting this protocol upgrade.
This guide is meant for people with little or some experience in running Ethereum clients and using the command-line interface (CLI). It will show you step by step how to setup your machine to join the Goerli/Prater merge testnet by giving you the instructions to install and configure all the tools needed. It will assume you are using a modern linux distribution with systemd and APT (like Ubuntu 20.04 or Ubuntu 22.04, but it should work on most recent debian derivatives) on a modern x86 CPU (Intel, AMD). A clean install of your operating system on a dedicated machine or a virtual machine before proceeding is preferable.
We will use the latest version for Geth and the latest version for Lighthouse. We will configure them to connect to the Goerli/Prater merge testnet. There is an alternative guide to this one who uses the Besu/Teku combo for its clients.
Almost all of these commands will be performed in a terminal. Start your Terminal application. Any line that starts with the dollar sign ($) is a command that need to be executed in your terminal. Do not input the dollar sign ($) in your terminal, only the text that comes after that.
Executing a command with sudo will occasionally ask you for your password. Make sure to enter your account password correctly. You can execute the command again if you fail to enter the correct password after a few attempts.
Make sure we have fully updated packages first.
$ sudo apt -y update
$ sudo apt -y upgradeInstall prerequisites commonly available.
$ sudo apt -y install software-properties-common wget curl cczeAdd the Ethereum PPA and install the Geth package.
$ sudo add-apt-repository -y ppa:ethereum/ethereum
$ sudo apt -y install gethDownload the latest release version for Lighthouse and extract it. If the latest version is more recent than what is used here, use that version and adjust for the new URL and archive name. Make sure to use the linux x86_64 version.
$ cd ~
$ wget https://github.com/sigp/lighthouse/releases/download/v4.2.0/lighthouse-v4.2.0-x86_64-unknown-linux-gnu.tar.gz
$ tar xvf lighthouse-v4.2.0-x86_64-unknown-linux-gnu.tar.gz
$ rm lighthouse-v4.2.0-x86_64-unknown-linux-gnu.tar.gzInstall this Lighthouse version globally.
$ sudo cp ~/lighthouse /usr/local/bin
$ rm ~/lighthouseCreate a JWT token file in a neutral location and make it readable to everyone. We will use the /var/lib/ethereum/jwttoken location to store the JWT token file.
$ sudo mkdir -p /var/lib/ethereum
$ openssl rand -hex 32 | tr -d "\n" | sudo tee /var/lib/ethereum/jwttoken
$ sudo chmod +r /var/lib/ethereum/jwttoken
Create a dedicated user for running Geth, create a directory for holding the data and assign the proper permissions.
$ sudo useradd --no-create-home --shell /bin/false goeth
$ sudo mkdir -p /var/lib/goethereum
$ sudo chown -R goeth:goeth /var/lib/goethereumCreate a systemd service config file to configure the Geth node service.
$ sudo nano /etc/systemd/system/geth.servicePaste the following service configuration into the file. Exit and save once done (Ctrl + X, Y, Enter).
[Unit]
Description=Go Ethereum Client - Geth (Goerli)
After=network.target
Wants=network.target
[Service]
User=goeth
Group=goeth
Type=simple
Restart=always
RestartSec=5
TimeoutStopSec=180
ExecStart=geth \
--goerli \
--http \
--datadir /var/lib/goethereum \
--metrics \
--metrics.expensive \
--pprof \
--authrpc.jwtsecret=/var/lib/ethereum/jwttoken
[Install]
WantedBy=default.targetReload systemd to reflect the changes and start the service. Check status to make sure it’s running correctly.
$ sudo systemctl daemon-reload
$ sudo systemctl start geth.service
$ sudo systemctl status geth.serviceIt should say active (running) in green text. If not then go back and repeat the steps to fix the problem. Press Q to quit (will not affect the geth service).
Enable the geth service to automatically start on reboot.
$ sudo systemctl enable geth.serviceYou can watch the live messages from your Geth node logs using this command. Make sure nothing suspicious shows up in your logs.
$ sudo journalctl -f -u geth.service -o cat | ccze -APress Ctrl + C to stop showing those messages.
Create a dedicated user for running the Lighthouse beacon node, create a directory for holding the data, copy testnet files and assign the proper permissions.
$ sudo useradd --no-create-home --shell /bin/false lighthousebeacon
$ sudo mkdir -p /var/lib/lighthouse
$ sudo chown -R lighthousebeacon:lighthousebeacon /var/lib/lighthouseCreate a systemd service config file to configure the Lighthouse beacon node service.
$ sudo nano /etc/systemd/system/lighthousebeacon.servicePaste the following service configuration into the file. Exit and save once done (Ctrl + X, Y, Enter).
[Unit]
Description=Lighthouse Ethereum Client Beacon Node (Goerli)
Wants=network-online.target
After=network-online.target
[Service]
Type=simple
User=lighthousebeacon
Group=lighthousebeacon
Restart=always
RestartSec=5
ExecStart=/usr/local/bin/lighthouse bn \
--network goerli \
--datadir /var/lib/lighthouse \
--http \
--execution-endpoint http://127.0.0.1:8551 \
--metrics \
--validator-monitor-auto \
--checkpoint-sync-url https://goerli.beaconstate.ethstaker.cc \
--execution-jwt /var/lib/ethereum/jwttoken
[Install]
WantedBy=multi-user.targetReload systemd to reflect the changes and start the service. Check status to make sure it’s running correctly.
$ sudo systemctl daemon-reload
$ sudo systemctl start lighthousebeacon.service
$ sudo systemctl status lighthousebeacon.serviceIt should say active (running) in green text. If not then go back and repeat the steps to fix the problem. Press Q to quit (will not affect the Lighthouse beacon node service).
Enable the Lighthouse beacon node service to automatically start on reboot.
$ sudo systemctl enable lighthousebeacon.serviceYou can watch the live messages from your Lighthouse beacon node logs using this command. Make sure nothing suspicious shows up in your logs.
$ sudo journalctl -f -u lighthousebeacon.service -o cat | ccze -APress Ctrl + C to stop showing those messages.
Requesting or obtaining enough Goerli ETH to perform your validator deposit can be challenging at this point. We suggest you use the EthStaker #cheap-goerli-validator free process. Join the EthStaker Discord server and use the /cheap-goerli-deposit slash command (start typing the command and it will show up above your input box). From there, follow the instructions from the bot. As a harder alternative, you can try obtaining 32 Goerli ETH from various faucets or bridges on https://faucetlink.to/goerli .
There are 2 great tools to create your validator keys:
- GUI based: Wagyu Key Gen
- CLI based: staking-deposit-cli
If you choose the Wagyu Key Gen application, make sure to select the Goerli network and follow the instructions provided. If you are using the #cheap-goerli-validator process, you will need to use 0x4D496CcC28058B1D74B7a19541663E21154f9c84 as your withdrawal address. This is only required for that process. When on Mainnet, you should use a withdrawal address you control if you want to use one.
If you choose the staking-deposit-cli application, here is how to create your validator keys:
$ cd ~
$ wget https://github.com/ethereum/staking-deposit-cli/releases/download/v2.5.0/staking_deposit-cli-d7b5304-linux-amd64.tar.gz
$ tar xvf staking_deposit-cli-d7b5304-linux-amd64.tar.gz
$ rm staking_deposit-cli-d7b5304-linux-amd64.tar.gz
$ cd staking_deposit-cli-d7b5304-linux-amd64/
$ ./deposit new-mnemonic --num_validators 1 --chain goerli --execution_address 0x4D496CcC28058B1D74B7a19541663E21154f9c84
$ ls -d $PWD/validator_keys/*Make sure to store your keystore password and your mnemonic somewhere safe. You should end up with a deposit file (starts with deposit_data- and ends with .json) and one or more keystore files (starts with keystore- and ends with .json), 1 per validator. Copy them around if needed. Make sure your deposit file and your keystore files are in a known and accessible location on your machine.
Next we will need to perform your deposit. If you used the #cheap-goerli-validator process, you can perform your deposit on https://goerli.launchpad.ethstaker.cc/ . If you managed to obtained 32 Goerli ETH, you can use the official Goerli launchpad on https://goerli.launchpad.ethereum.org/ .
Create a dedicated user for running the Lighthouse validator client, create a directory for holding the data and assign the proper permissions.
$ sudo useradd --no-create-home --shell /bin/false lighthousevalidator
$ sudo mkdir -p /var/lib/lighthouse/validators
$ sudo chown -R lighthousevalidator:lighthousevalidator /var/lib/lighthouse/validators
$ sudo chmod 700 /var/lib/lighthouse/validatorsImport your keystore that includes your validator key for the Lighthouse validator client. Running the first command will prompt you for that keystore password. Make sure to enter it correctly and avoid leaving it blank. Make sure to replace /path/to/keystores with the actual path to your keystores created in the previous step.
$ sudo /usr/local/bin/lighthouse account validator import \
--directory /path/to/keystores \
--datadir /var/lib/lighthouse \
--network goerli
$ sudo chown -R lighthousevalidator:lighthousevalidator /var/lib/lighthouse/validatorsCreate a systemd service config file to configure the Lighthouse validator client service.
$ sudo nano /etc/systemd/system/lighthousevalidator.servicePaste the following service configuration into the file. Exit and save once done (Ctrl + X, Y, Enter). Make sure to replace the 0x0000000000000000000000000000000000000000 address with your own Ethereum address that you control where you want to receive the transaction tips.
[Unit]
Description=Lighthouse Ethereum Client Validator Client (Goerli)
Wants=network-online.target
After=network-online.target
[Service]
User=lighthousevalidator
Group=lighthousevalidator
Type=simple
Restart=always
RestartSec=5
ExecStart=/usr/local/bin/lighthouse vc \
--network goerli \
--datadir /var/lib/lighthouse \
--graffiti EthStaker \
--metrics \
--suggested-fee-recipient 0x0000000000000000000000000000000000000000
[Install]
WantedBy=multi-user.targetReload systemd to reflect the changes and start the service. Check status to make sure it’s running correctly.
$ sudo systemctl daemon-reload
$ sudo systemctl start lighthousevalidator.service
$ sudo systemctl status lighthousevalidator.serviceIt should say active (running) in green text. If not then go back and repeat the steps to fix the problem. Press Q to quit (will not affect the Lighthouse validator client service).
Enable the Lighthouse validator client service to automatically start on reboot.
$ sudo systemctl enable lighthousevalidator.serviceYou can watch the live messages from your Lighthouse validator client logs using this command.
$ sudo journalctl -f -u lighthousevalidator.service -o cat | ccze -APress Ctrl + C to stop showing those messages.
If you have any question or if you need additional support, make sure to get in touch with the EthStaker community on:
- Discord: discord.io/ethstaker
- Reddit: reddit.com/r/ethstaker
Based on Somer Esat's guide. Based on Ethereum community's guide.