📡Validator Node Set-Up

Discover the steps to set up your Validator Node along with a detailed video walkthrough.

Welcome! This guide will walk you through setting up your BLOCX Validator Node using the official BLOCXTECH GitHub repository.

---

Prerequisites

• Linux-based VPS or server

• Basic command-line knowledge

• Your BLOCX wallet address for fee recipient

---

Pre-step: Install Git on your System

Install Git on your system to proceed with the next steps.

sudo apt install git

---

Step 0: Clone the Repository

Start by cloning the setup repository to your server:

git clone https://github.com/BLOCXTECH/BLOCX-Node-Setup.git
cd BLOCX-Node-Setup

---

Step 1: Set Up Docker

Run the setup script to install Docker:

./docker-setup.sh

Note: If you're setting up a regular node (not a validator), skip ahead to Step 6.

---

Step 2: Generate Validator Keys

Create your validator mnemonic using the deposit CLI:

./bin/blocx-deposit-cli new-mnemonic --eth1_withdrawal_address 'your eth withdrawal address'

eth1_withdrawal_address will receive the rewards from the validator and will also be used for the validator exit. Ensure this address is final, as it will not change after the validator is created.

• Running above command there will be some prompts go through all the prompt and provide all the necessory details.

• when it asks:

  • Please choose the (mainnet or testnet) network/chain name ['blocx']: [blocx]:

  • Choose 'blocx', as we want to create a validator for the BLOCX network.

---

Step 3: Save Your Mnemonic

Follow the prompts carefully and remember your password. Move the generated keys to their required locations:

mkdir -p keys/validator_keys el-cl-genesis-data/jwt && cp -rf validator_keys/* keys/validator_keys

---

Step 4: Generate Keystore Secrets

Use your mnemonic password to generate keystore secrets:

python3 generate_keys.py --password 'your_password_here'

---

Step 5: Set Fee Recipient Address

Export your Ethereum address to receive rewards:

export FEE_RECIPIENT=0xYourEthereumAddress

Replace 0xYourEthereumAddress with your actual wallet address.

---

Step 6: Initialize and Start Your Node

Run the wrapper script. When prompted, choose the following:

• init to initialize the node

• start to launch the node

./initExecution.sh

---

Once you select start, the script will ask you to provide the following details:

• ✅ NODE1_ADDRESS – Enter remote Execution Layer IP (e.g., 66.42.97.78)

• ✅ EXECUTION_PORT – Default is 8545 (can be changed)

• ✅ CONSENSUS_PORT – Default is 5052 (can be changed)

• ✅ CHAIN_ID – Provide the BLOCX chain ID, Default is 86996

You can leave all other optional fields blank.

Next, you'll be asked:

Do you want to set validator node (Y/N):

Type Y and press Enter to continue with a Network node setup.

✅ You should see:

[+] Running 3/3
Container blocx-execution-1  Started
Container blocx-beacon-1     Started
Container blocx-validator-1  Started
Node started successfully.

After getting this output, your node will connect to the network and start syncing

Verify your Docker logs to check that your node is started syncing with the network

docker logs `container name` -f
e.g (docker logs blocx-beacon-1 -f)

---

Step 7: Stake via Launchpad

Note: Before submitting your deposit.json file to the staking launchpad, ensure your node is fully synced with the network. If your validator gets approved while your node is not synced, you may receive penalties.

To finalize your validator, stake your deposit via the BLOCX Staking Launchpad:

Launchpad

Follow the instructions there to complete the validator registration.

---

Video Walkthrough until Step 6:

This video is temporary, we do not claim credit for it.

88MB

Step 0 - Step 6.mp4