Skip to main content

EigenDA Blazar (V2) Migration

Operators running v1 will need to define new v2 specific environment variables, expose 2 new ports, and update their socket registration as part of the migration to v2.

Testnet Migration Timeline​

We are asking for all testnet operators to migrate to v2 within 2 weeks post Blazar testnet launch (Feb 20, 2025).

During this period, ejections based on Blazar (V2) signing rates will be paused (ejections based on V1 signing rate will continue to be performed). After this period, operator signing rates will be measured as the worse of V1 and Blazar (V2) signing rate, and will be ejected based on the worse of the two signing rates.

Migration Steps​

1. Update .env with v2 specific environment variables​

NODE_V2_RUNTIME_MODE=v1-and-v2

NODE_V2_DISPERSAL_PORT=32006
NODE_V2_RETRIEVAL_PORT=32007

# Internal ports for Nginx reverse proxy
NODE_INTERNAL_V2_DISPERSAL_PORT=${NODE_V2_DISPERSAL_PORT}
NODE_INTERNAL_V2_RETRIEVAL_PORT=${NODE_V2_RETRIEVAL_PORT}

2. Update MAIN_SERVICE_IMAGE​

MAIN_SERVICE_IMAGE=ghcr.io/layr-labs/eigenda/opr-node:0.9.0-rc.0

3. Update socket registration​

EigenDA Blazar adds new ports to the socket registration. Socket registration update is required to receive v2 traffic.

Ensure that you are using the latest version of the eigenda-operator-setup before updating the socket.

(eigenda-operator-setup) > ./run.sh update-socket
You are about to update your socket to: 23.93.87.155:32005;32004;32006;32007
Confirm? [Y/n]

4. Restart the node and monitor for reachability checks​

The node will check reachability of v1 & v2 sockets. If reachability checks are failing, check that the new ports are open and accessible.

Feb 20 19:47:07.861 INF node/node.go:743 Reachability check v1 - dispersal socket ONLINE component=Node status="node.Dispersal is available" socket=operator.eigenda.xyz:32001
Feb 20 19:47:07.861 INF node/node.go:750 Reachability check v1 - retrieval socket ONLINE component=Node status="node.Retrieval is available" socket=operator.eigenda.xyz:32002
Feb 20 19:47:07.867 INF node/node.go:743 Reachability check v2 - dispersal socket ONLINE component=Node status="validator.Dispersal is available" socket=operator.eigenda.xyz:32003
Feb 20 19:47:07.867 INF node/node.go:750 Reachability check v2 - retrieval socket ONLINE component=Node status="validator.Retrieval is available" socket=operator.eigenda.xyz:32005

5. Confirm v2 StoreChunks requests are being served​

Feb 20 19:50:36.741 INF grpc/server_v2.go:140 new StoreChunks request batchHeaderHash=873ac1c7faeec0f1e5c886142d0b364a94b3e906f1b4b4f1b0466a5f79cecefb numBlobs=14 referenceBlockNumber=3393054
Feb 20 19:50:41.765 INF grpc/server_v2.go:140 new StoreChunks request batchHeaderHash=76873d64609d50aaf90e1c435c9278c588f1a174a4c0b4a721438a7d44bb2f1e numBlobs=18 referenceBlockNumber=3393054
Feb 20 19:50:46.760 INF grpc/server_v2.go:140 new StoreChunks request batchHeaderHash=8182f31c9b58e04f0a09dfbf1634a73e47a660b441f65c7a35ef9e7afd064493 numBlobs=16 referenceBlockNumber=3393054

Remote BLS Signer API Migration​

With the release of EigenDA Blazar, the the node has been upgraded to use the latest cerberus remote BLS signer API.

This upgrade requires the operator to define the NODE_BLS_SIGNER_API_KEY environment variable within the .env file.

Follow the steps from the cerberus setup guide to create an API key.

Environment Variable Reference​

EIGENDA_RUNTIME_MODE​

This environment variable will be used to determine the runtime mode of the EigenDA node.

  • v1-and-v2: The node will serve both v1 and v2 traffic (default)
  • v2-only: The node will serve v2 traffic only
  • v1-only: The node will serve v1 traffic only

The v1-only & v2-only modes are intended for isolating traffic to separate validator instances - where 1 instance serves v1 traffic and a second instance serves v2 traffic.

EIGENDA_V2_DISPERSAL_PORT​

Operators must publically expose this port. This port will be used to listen for dispersal requests from the EigenDA v2 API. IP whitelisting is no longer required with v2.

EIGENDA_V2_RETRIEVAL_PORT​

Operators must publically expose this port. This port will be used to listen for retrieval requests from the EigenDA v2 API.

EIGENDA_INTERNAL_V2_DISPERSAL_PORT​

This port is intended for Nginx reverse proxy use. It is not required if the operator is not using a reverse proxy.

EIGENDA_INTERNAL_V2_RETRIEVAL_PORT​

This port is intended for Nginx reverse proxy use. It is not required if the operator is not using a reverse proxy.