Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

chore(holesky): pin lighthouse image, change docs #510

Merged
merged 2 commits into from
Dec 4, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
72 changes: 33 additions & 39 deletions testnets/holesky/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,33 +12,33 @@ This document provides instructions for running Bolt on the Holesky testnet.

<!-- vim-markdown-toc GFM -->

- [Prerequisites](#prerequisites)
- [On-Chain Registration](#on-chain-registration)
- [Validator Registration](#validator-registration)
- [Registration Steps](#registration-steps)
- [Bolt Network Entrypoint](#bolt-network-entrypoint)
- [Operator Registration](#operator-registration)
- [Symbiotic Registration Steps](#symbiotic-registration-steps)
- [EigenLayer Registration Steps](#eigenlayer-registration-steps)
- [Off-Chain Setup](#off-chain-setup)
- [Docker Mode (recommended)](#docker-mode-recommended)
- [Commit-Boost Mode](#commit-boost-mode)
- [Native Mode (advanced)](#native-mode-advanced)
- [Building and running the MEV-Boost fork binary](#building-and-running-the-mev-boost-fork-binary)
- [Building and running the Bolt sidecar binary](#building-and-running-the-bolt-sidecar-binary)
- [Configuration file](#configuration-file)
- [Observability](#observability)
- [Firewall Configuration](#firewall-configuration)
- [Reference](#reference)
- [Supported RPC nodes](#supported-rpc-nodes)
- [Supported Relays](#supported-relays)
- [Command-line options](#command-line-options)
- [Delegations and signing options for Native and Docker Compose Mode](#delegations-and-signing-options-for-native-and-docker-compose-mode)
- [`bolt` CLI](#bolt-cli)
- [Installation and usage](#installation-and-usage)
- [Using a private key directly](#using-a-private-key-directly)
- [Using a ERC-2335 Keystore](#using-a-erc-2335-keystore)
- [Avoid restarting the beacon node](#avoid-restarting-the-beacon-node)
* [Prerequisites](#prerequisites)
* [On-Chain Registration](#on-chain-registration)
* [Validator Registration](#validator-registration)
* [Registration Steps](#registration-steps)
* [Bolt Network Entrypoint](#bolt-network-entrypoint)
* [Operator Registration](#operator-registration)
* [Symbiotic Registration Steps](#symbiotic-registration-steps)
* [EigenLayer Registration Steps](#eigenlayer-registration-steps)
* [Off-Chain Setup](#off-chain-setup)
* [Docker Mode (recommended)](#docker-mode-recommended)
* [Commit-Boost Mode](#commit-boost-mode)
* [Native Mode (advanced)](#native-mode-advanced)
* [Building and running the MEV-Boost fork binary](#building-and-running-the-mev-boost-fork-binary)
* [Building and running the Bolt sidecar binary](#building-and-running-the-bolt-sidecar-binary)
* [Configuration file](#configuration-file)
* [Observability](#observability)
* [Firewall Configuration](#firewall-configuration)
* [Reference](#reference)
* [Supported RPC nodes](#supported-rpc-nodes)
* [Supported Relays](#supported-relays)
* [Command-line options](#command-line-options)
* [Delegations and signing options for Native and Docker Compose Mode](#delegations-and-signing-options-for-native-and-docker-compose-mode)
* [`bolt` CLI](#bolt-cli)
* [Installation and usage](#installation-and-usage)
* [Using a private key directly](#using-a-private-key-directly)
* [Using a ERC-2335 Keystore](#using-a-erc-2335-keystore)
* [Avoid restarting the beacon node](#avoid-restarting-the-beacon-node)

<!-- vim-markdown-toc -->

Expand Down Expand Up @@ -71,21 +71,15 @@ client implementations to download and run them.

> [!IMPORTANT]
> In order to correctly run the Bolt sidecar and avoid commitment faults the
> beacon node must be configured so that:
> beacon node and the validator client must be configured so that:
>
> 1. the node's `builder-api` (or equivalent flag) must point to the Bolt
> Sidecar API.
> 2. the node will always prefer the builder payload. For instance, in
> Lighthouse this can be achieved by providing the following flags:
>
> ```text
> --always-prefer-builder-payload
> --builder-fallback-disable-checks
> ```
>
> In other clients like Vouch, the same can be achieved by setting the
> `builder-boost-factor` to a large value like `18446744073709551615` (`2**64 -
1`).
> 2. the node and the validator client will always prefer the builder payload,
> and try to use the builder API. For instance, in Lighthouse this can be
> done by setting the `builder-fallback-disable-checks` flag and the
> `builder-boost-factor` to a large value like `18446744073709551615`
> (`2**64 - 1`).
>
> It might be necessary to restart your beacon node depending on your existing
> setup. See the [Avoid Restarting the Beacon
Expand Down
2 changes: 1 addition & 1 deletion testnets/holesky/docker-compose.pbs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ services:
]

beacon:
image: sigp/lighthouse:latest
image: sigp/lighthouse:v5.3.0
restart: unless-stopped
volumes:
- "chaindata:/var/lib/chaindata"
Expand Down
Loading