Run EigenLayer Holesky Node - zellular-xyz/zsequencer GitHub Wiki

Recommended Node Specifications

For running a Zellular Sequencer node, the General Purpose - large with 2 vCPUs, 8 GB RAM and 5 Mbps network bandwidth is sufficient.

Install Docker

Follow these instructions to install the latest version of docker.

Generate Keys

Follow these instructions to install the eigenlayer cli to generate the BLS and ECDSA key files for your node:

eigenlayer operator keys create --key-type ecdsa zellular
eigenlayer operator keys create --key-type bls zellular

Register the Operator

Follow the EigenLayer Operator Guide to fund your ECDSA wallet and register as an operator on EigenLayer core contracts.

Zellular Holesky testnet operators need at least 1 Lido Staked Ether (stETH) delegated to them. Obtain Holesky testnet ethers from the available faucets. Use the Lido testnet staking dashboard to stake these ethers and receive Lido staking tokens. Restake these tokens on the EigenLayer Holesky dashboard and delegate them to your operator.

Get docker-compose.yml

mkdir zsequencer
cd zsequencer
curl -o docker-compose.yml https://raw.githubusercontent.com/zellular-xyz/zsequencer/main/docker-compose-pull.yml

Setup Environment

Fetch the .env.example and save that as .env using the following command:

curl -o .env https://raw.githubusercontent.com/zellular-xyz/zsequencer/main/.env.example

Then modify the .env file with the appropriate parameters:

ZSEQUENCER_BLS_KEY_FILE=~/.eigenlayer/operator_keys/zellular.bls.key.json
ZSEQUENCER_BLS_KEY_PASSWORD=[your password for bls key file]
ZSEQUENCER_ECDSA_KEY_FILE=~/.eigenlayer/operator_keys/zellular.ecdsa.key.json
ZSEQUENCER_ECDSA_KEY_PASSWORD=[your password for ecdsa key file]
ZSEQUENCER_REGISTER_SOCKET=[htttp://server-ip:port]

[!NOTE] The only required variables to set are:

  • path to BLS & ECDSA key files and their passwords
  • socket URL for registering the operator with Zellular AVS on EigenLayer

Run the Node

docker compose up -d