Appearance

v0.0.1-rc5 ​

This release supersedes v0.0.1-rc4.

Changes ​

  • Updated Docker image tag to getoptimum/gateway:v0.0.1-rc5
  • No configuration changes — all setup and usage instructions remain identical to rc1
  • Multiple bug fixes and improvements across Lighthouse integration, Electra handshake support, and partner metrics documentation.

Fixes ​

Lighthouse Integration Improvements ​

Fixed critical connection issues with Lighthouse consensus client and added support for Electra handshake protocols.

Lighthouse Connection Fixes:

  • Resolved unknown stream protocol errors for Electra-specific requests
  • Added proper handling for /eth2/beacon_chain/req/blob_sidecars_by_range/1/ssz_snappy protocol
  • Enhanced beacon block range request handling with /eth2/beacon_chain/req/beacon_blocks_by_range/2/ssz_snappy

Electra Handshake Support:

Gateway now properly handles Electra upgrade protocols that Lighthouse clients expect:

text
# Previously failing (rc4):
>>> received unknown stream for protocol: /eth2/beacon_chain/req/blob_sidecars_by_range/1/ssz_snappy 10ff060000734e615070590114000010708f2ae0041500000000002000000000000000
>>> received unknown stream for protocol: /eth2/beacon_chain/req/beacon_blocks_by_range/2/ssz_snappy 18ff060000734e61507059011c000008c72ccfc00415000000000020000000000000000100000000000000

# Now handled correctly (rc5):
{"timestamp":1758747116,"_level":"debug","short_message":"received metadata request","commit":"rc4","flow":"metadata","peer":"16Uiu2HAmTuVkXwHwHDNZPUNWtAHk1msL5gtg8cvP32sQUaXWHSNm"}

Verified with Lighthouse v7.1.0:

  • Successfully connects to Optimum Gateway
  • All Electra blob sidecar topics subscribed and functional
  • Electra handshake protocols work without connection errors

Notes ​

If you were previously running v0.0.1-rc4, you can switch to rc5 simply by updating the Docker image tag in your docker run or docker-compose configuration.

Quick Start ​

Follow the Quick Start Guide but use the updated Docker image:

bash
docker pull getoptimum/gateway:v0.0.1-rc5

Troubleshooting ​

If you encounter connection issues with Lighthouse or other CL clients, see the Troubleshooting Guide.

Metrics ​

We’ve standardized and expanded metrics in rc5 to make them easier to reason about and align with validator operator expectations.