Skip to content

Releases: sigp/lighthouse

Tiny Rick

02 Dec 05:57
v6.0.0
c042dc1
Compare
Choose a tag to compare

Summary

This low-priority major release introduces new features and optimisations which are backwards-incompatible with Lighthouse v5.x.y. If you are running Nethermind we recommend waiting for the release of Nethermind v1.30.0 before upgrading due to an incompatibility (see Known Issues).

After many months of testing, this releases stabilises hierarchical state diffs, resulting in much more compact archive nodes! This long-awaited feature was also known as on-disk tree-states, and was available for pre-release testing in Lighthouse v5.1.222-exp.

Other notable changes include:

  • Removal and deprecation of several old CLI flags. Some flags will need to be removed in order for Lighthouse to start, see below for a full list.
  • Improved beacon node failover and prioritisation in the validator client.
  • Support for engine_getBlobsV1 to speed up import and propagation of blobs.
  • Optimised peer discovery and long-term subnet subscription logic.
  • New commands for lighthouse validator-manager.
  • Improved light client support. Enabled via --light-client-server.
  • SSZ by default for blocks published by the VC.

⚠️ Breaking Changes ⚠️

Upgrading to Lighthouse v6.0.0 should be automatic for most users, but you must:

  • Remove any unsupported CLI flags (see below), and
  • Be aware of the one-way database migration and the changes to archive nodes.

Once you upgrade a beacon node to Lighthouse v6.0.0, you cannot downgrade to v5.x.y without re-syncing.

⚠️ Database Migration ⚠️

The beacon node database migration for v6.0.0 is applied automatically upon upgrading. No manual action is required to upgrade.

There is no database downgrade available. We did not take this choice lightly, but in order to deliver hierarchical state diffs, a one-way database migration was simplest. If you do find yourself wanting to downgrade, re-syncing using checkpoint sync is highly recommended as it will get the node back online in just a few minutes.

For Archive Nodes

The migration enables hierarchical state diffs which necessitates the deletion of previously stored historic states. If you are running an archive node, then all historic states will be deleted upon upgrading. If you would like to continue running an archive node, you should use the --reconstruct-historic-states flag so that state reconstruction can restart from slot 0.

If you would like to change the density of diffs, you can use the new flag --hierarchy-exponents which should be applied the first time you start after upgrading. We have found that the hierarchy-exponents configuration does not greatly impact query times which tend to be dominated by cache builds and affected more by query ordering. We still recommend avoiding parallel state queries at the same slot, and making use of sequential calls where possible (e.g. in indexing services). We plan to continue optimising parallel queries and cache builds in future releases, without requiring a re-sync.

For more information on configuring the hierarchy exponents see the updated documentation on Database Configuration in the Lighthouse book.

Hierarchy Exponents Storage requirement Sequential slot query Uncached query
5,9,11,13,16,18,21 (default) 418 GiB 250-700 ms up to 10 s
5,7,11 (frequent snapshots) 589 GiB 250-700 ms up to 6 s
0,5,7,11 (per-slot diffs) 1915 GiB+ 250-700 ms up to 2 s

As part of the archive node changes the format of the "anchor" has also changed. For an archive node the anchor will no longer be null and will instead take the value:

"anchor": {
  "anchor_slot": "0",
  "oldest_block_slot": "0",
  "oldest_block_parent": "0x0000000000000000000000000000000000000000000000000000000000000000",
  "state_upper_limit": "0",
  "state_lower_limit": "0"
}

Don't be put off by the state_upper_limit being equal to 0: this indicates that all states with slots >= 0 are available, i.e. full state history.

NOTE: if you are upgrading from v5.1.222-exp you need to re-sync from scratch. The database upgrade will fail if attempted.

⚠️ Removed CLI Flags ⚠️

The following beacon node flags which were previously deprecated have been deleted. You must remove them from your beacon node arguments before updating to v6.0.0:

  • --self-limiter
  • --http-spec-fork
  • --http-allow-sync-stalled
  • --disable-lock-timeouts
  • --always-prefer-builder-payload
  • --progressive-balances
  • --disable-duplicate-warn-logs
  • -l (env logger)

The following validator client flags have also been deleted and must be removed before starting up:

  • --latency-measurement-service
  • --disable-run-on-all
  • --produce-block-v3

In many cases the behaviour enabled by these flags has become the default and no replacement flag is necessary. If you would like to fine-tune some aspect of Lighthouse's behaviour the full list of CLI flags is available in the book:

⚠️ Deprecated CLI Flags ⚠️

The following beacon node flags have been deprecated. You should remove them, but the beacon node will still start if they are provided.

  • --eth1
  • --dummy-eth1

The following global (BN and VC) flags have also been deprecated:

  • --terminal-total-difficulty-override
  • --terminal-block-hash-override
  • --terminal-block-hash-epoch-override
  • --safe-slots-to-import-optimistically

⚠️ Modified CLI Flags ⚠️

The beacon node flag --purge-db will now only delete the database in interactive mode, and requires manual confirmation. If it is provided in a non-interactive context, e.g. under systemd or docker then it will have no effect. The beacon node will start without anything being deleted.

If you wish to use the old purge-db behaviour it is available via the flag --purge-db-force which never asks for confirmation.

Network Optimisations

This release includes optimisations to Lighthouse's subnet subscription logic, updates to peer discovery, and fine-tuning of IDONTWANT and rate limiting.

Users should see similar performance with reduced bandwidth. Users running a large number of validators (1000+) on a single beacon node may notice a reduction in the number of subscribed subnets, but can opt-in to subscribing to more subnets using --subscribe-all-subnets if desired (e.g. for marginally increasing block rewards from included attestations).

Validator Client Fallback Optimisations

The beacon node fallback feature in the validator client has been refactored for greater responsiveness. Validator clients running with multiple beacon nodes will now switch more aggressively to the "healthiest" looking beacon node, where health status is determined by:

  • Sync distance (head distance from the current slot).
  • Execution layer (EL) health (whether the EL is online and not erroring).
  • Optimistic sync status (whether the EL is syncing).

The impact of this change should be less downtime during upgrades, and better resilience to faulty or broken beacon nodes.

Users running majority clients should be aware that in the case of a faulty majority client, the validator client may prefer the faulty chain due to it appearing healthier. The best defense against this problem is to run some (or all) validator clients without any connection to a beacon node running a majority CL client or majority EL client.

New Validator Manager Commands

The Lighthouse validator manager is the recommended way to manage validators from the CLI, without having to shut down the validator client.

In this release it has gained several new capabilities:

  • lighthouse vm import: now supports standard keystores generated by other tools like staking-deposit-cli.
  • lighthouse vm list: a new read-only command to list the validator keys that a VC has imported.
  • lighthouse vm delete: a new command to remove a key from a validator client, e.g. after exiting.

For details on these commands and available flags, see the docs: https://lighthouse-book.sigmaprime.io/validator-manager.html

Future releases will continue to expand the number of available commands, with the goal of eventually deprecating the previous lighthouse account-manager CLI.

Fetch Blobs Optimisation

This release supports the new engine_getBlobsV1 API for accelerating the import of blocks with blobs. If the API is supported by your execution node, Lighthouse will use it to load blobs from the mempool without waiting for them to arrive on gossip. Our testing indicates that this will help Ethereum scale to a higher blob count, but we need more data from real networks before committing to a blob count increase.

There are several new Prometheus metrics to track the hit rate:

  • beacon_blobs_from_el_received_total
  • beacon_blobs_from_el_expected_total
  • beacon_blobs_from_el_hit_total

Logs at debug level also show the operation of this new feature (grep for fetch_blobs).

At the time of writing the follow execution clients support the API:

  • Reth v1.0.7 or newer.
  • Besu v24.9.1 or newer.
  • Geth v1.14.12 or newer.

Unsupported:

  • Nethermind v1.29.x (buggy, see below).
  • Erigon.

🐛 Known Issues 🐛

Nethermind v1.29.x engine_getBlobsV1 bug

Nethermind versions v1.29.0 and v1.29.1 include ...

Read more

Risotto Groupon

08 Aug 05:49
v5.3.0
d6ba8c3
Compare
Choose a tag to compare

Summary

This medium-priority release contains performance optimisations, bugfixes and new features. There are several breaking changes detailed below.

The main optimisations are:

  • Faster beacon node start-up due to an optimisation to the database schema (#5897). The schema migration is a backwards-incompatible change which is described in more detail below.
  • More reliable block proposals due to the use of the new v3 block production API (#5292).
  • Improvements to the validator client's broadcast mechanism (#5976, #6223).
  • Support for gossipsub IDONTWANT (#5422). This allows nodes to reduce their bandwidth usage by avoiding the download of duplicate messages.

The main bugfixes are:

  • Fix parsing of the VC proposer-nodes CLI flag (#6125).
  • Prevent connections from peers with a banned IP history (#6008).
  • Prevent UPnP queries when UPnP is disabled (#6170).
  • Corrections to lighthouse account CLI (#6153, #6091).
  • Update Sepolia bootnodes, fixing issues with 0 peers on Sepolia (#6037).

New features include:

  • A new Rust slasher database backend, redb (#4529). We still recommend running LMDB on mainnet, but encourage users to try redb on testnets using the flag --slasher-backend redb.
  • The default number of log files retained (logfile-max-number) has been increased from 5 to 10 to help with debugging issues (#6092).
  • Lots of code for the upcoming Electra and PeerDAS network upgrades (#5712, #5741, #5761, #5743).

Breaking Changes

🗑️ Removed CLI flags

The following CLI flags have been removed completely and will cause the BN to fail to start up if provided:

  • --builder-profit-threshold: This flag was already deprecated and has been incompatible since v5.2.0 (#6131).

You should remove any instances of these flags from your beacon node startup command.

👎 Deprecated CLI flags

Beacon node:

  • --disable-lock-timeouts: Lock timeouts are now disabled by default so this flag does nothing. It will be removed in a future release (#6048).
  • --self-limiter: The self limiter is now enabled by default. This flag will be removed in a future release. The purpose of this is to prevent Lighthouse from sending excessive requests to peers in case of bugs or edge case scenarios. The rate limit quotas can be configured via the existing --self-limiter-protocols flag (#6093).

Validator client:

  • --produce-block-v3: The produce block v3 API is now enabled by default and cannot be disabled, so this flag does nothing. It will be removed in a future release (#5292).

You should remove any instances of these flags from your BN/VC commands, although failing to do so will only result in a warning, not a failure to start.

🦀 Minimum Supported Rust Version 1.78.0 🦀

The minimum supported Rust version (MSRV) was updated to 1.78.0. Users who compile from source (i.e., not Docker or pre-built binary users) will receive the following error if they are using an earlier version of Rust:

lighthouse v5.3.0 (/home/sigp/lighthouse/lighthouse) cannot be built because it requires rustc 1.78 or newer

Users can typically obtain the latest version of Rust by running rustup update.

💾 Database Schema Upgrade

The beacon node database schema has been updated from v19 to v21. An automatic database schema upgrade will run when updating from a previous version. No manual intervention is required for upgrading.

The schema upgrade was required to prepare for the upcoming Electra fork, and to optimise how validator public keys are stored on disk. Public keys are now stored uncompressed, which uses twice as much space, but allows them to be loaded around 10x faster. This results in shorter start-up times after the initial start-up on v5.3.0.

If you decide to downgrade from v5.3.0, then a database schema downgrade is available. It must be run using the lighthouse db migrate command. For instructions on how to downgrade, see the Database Migrations section of the Lighthouse Book.

More details on the pubkey optimisation are found in the PR: #5897.

🐋 No more -portable tarballs or -modern images

There are no more -portable tarballs attached to this release, and the -modern Docker images on Docker Hub will no longer be updated. Both have been deprecated since v5.2.0 when portable builds became the default everywhere.

For portable binary users:

  • Download the latest .tar.gz for your platform. It will continue to work exactly as before.

For modern Docker image users:

  • Use the :latest tag, or the :v5.3.0 tag. It will be just as fast as the previously supplied -modern image.

📝 HTTP API /eth/v1/beacon/deposit_snapshot to use JSON response by default

The /eth/v1/beacon/deposit_snapshot now returns JSON response by default (instead of SSZ) if a header is not specified, for consistency with other beacon APIs.

See: #5813.

🐧 Jemalloc enabled by default on non-Windows targets

jemalloc is now necessary on Linux with the introduction of tree-states for performance reasons. The jemalloc feature is now enabled by default on non-Windows targets.

See: #5995.

🔓 Removal of signed validator client responses

Signing of validator client HTTP responses has been removed. This feature had limited utility and adoption, and removing it has simplified VC API token management. Unless you were relying on the Signature header in VC responses, no action is required.

See: #5529.

💵 Fee recipient required with --always-prepare-payload

The --suggested-fee-recipient flag is now required when --always-prepare-payload is set. This feature is likely only used by block builders and relays.

See: #6079.

Update Priority

This table provides priorities for which classes of users should update particular components.

User Class Beacon Node Validator Client
Staking Users Medium Medium
Non-Staking Users Medium ---

See Update Priorities for more information about this table.

Lighthouse BNs and VCs from v5.0.0, v5.1.x, v5.2.x and v5.3.x are compatible. However, we recommend that users update both the VC and BN to v5.3.0 if upgrading.

All Changes

  • Release v5.3.0 (#6194)
  • Broadcast VC requests in parallel and fix subscription error (#6223)
  • Don't expect DAS config in HTTP spec response (#6221)
  • Downgrade re-org log to INFO (#6220)
  • patch quick-protobuf (#6217)
  • Work around UB in LMDB bindings (#6211)
  • Avoid acquiring another read lock while holding one to avoid potential deadlock (#6200)
  • Swap finalized chains based on processed batches (#6203)
  • Use upgradable read lock for pubkey cache (#6190)
  • default vc to block v3 endpoint and deprecate block-v3 flag (#5292)
  • Remove timeout locks (#6048)
  • limit dial concurrency on Swarm (#6184)
  • Fix lighthouse account validator subcommands help text (#6091)
  • Iterate expired components from the da_checker (#5895)
  • Rust 1.80.0 lints (#6183)
  • Fix unexpected Marking peer disconnected in DHT (#6140)
  • Add DataColumnSidecar gossip topic and message handling (#6147)
  • Use then instead of then_some when checking upnp_enabled to avoid useless UPnP query (#6170)
  • Remove backwards compatibility for el_offline and is_optimstic (#6168)
  • Show correct total validator count during validator recovery (#6153)
  • Update msrv to 1.78.0 (#6159)
  • Revert --image-download always flag to avoid CI getting rate limited (#6163)
  • Siren Docs Upgrade (#5979)
  • Remove use of ethers core (#5301)
  • level down libp2p quic accept and close errors (#6148)
  • Make proposer duties work pre-genesis (#4789)
  • Update is_available check to support PeerDAS. (#6076)
  • Add PeerDAS presets and configs. (#6127)
  • Upgrade openssl to address cargo audit issue (#6143)
  • Attempt to fix flaky basic sim test (#6134)
  • Delete --builder-profit-threshold flag (#6131)
  • Return syncing on HTTP when sync is stalled (#6129)
  • Add an option to keep existing enclave when starting local testnet (#6065)
  • Add requires suggested-fee-recipient flag when always-prepare-payload is set (#6079)
  • Disable slasher default features (#6115)
  • Fix proposer-nodes cli flag name (#6125)
  • chore: update the trusted setup to match the consensus-specs version (#6117)
  • Track store metrics by DB column (#6041)
  • Ef tests electra (#5758)
  • Remove VC response signing and fix HTTP error handling (#5529)
  • Remove trace logging (#6103)
  • Measure consensus verification time (#6089)
  • Add block_gossip Beacon API events (#5864)
  • Bump default logfile-max-number to 10 (#6092)
  • Beacon api + validator electra (#5744)
  • Enable the o...
Read more

Kyle

28 Jun 04:02
v5.2.1
9e12c21
Compare
Choose a tag to compare

Summary

This medium-priority release contains bugfixes for issues identified in v5.2.0. Users who have experienced sync issues with v5.2.0 are recommended to upgrade.

The list of bugfixes includes:

  • Prevention of forwards sync stalls after restarting, through more robust handling of peer disconnects and errors (#5969, #5945, #5993).
  • Prevention of backfill sync stalls (#5969).
  • Removal of unnecessary warnings for stale blobs propagated on gossip by other clients (#5935). The log message WARN Could not verify blob sidecar for gossip. Ignoring the blob sidecar should no longer be seen.
  • Correct sizing of the slasher database for the growing validator sets on mainnet and Holesky (#5934).

Breaking Changes

There are no breaking changes between v5.2.0 and v5.2.1. Please see the release notes for v5.2.0 if you are upgrading from a prior 5.x.x release.

Known Issues

Teku 24.10 BN Incompatibility

Beacon nodes running Teku 24.10.x and newer are not compatible out of the box with the validator client from this release. If you want to run Lighthouse VC v5.2.x with Teku BN 24.10.x you must use the --produce-block-v3 flag with Lighthouse. Upgrading to Lighthouse v5.3.0 is preferable as it fixes the incompatibility without requiring any flags.

Nethermind v1.26.0 and Reth v1.0.0 engine_getClientVersionV1 bug

Nethermind v1.26.0 and Reth v1.0.0 include an implementation of engine_getClientVersionV1 which is not compliant with the API specification and does not work with Lighthouse. We recommend upgrading Nethermind to v1.27.0. At time of writing there is no compatible Reth release available.

The warning generated by a non-compliant implementation is:

WARN Execution engine call failed error: InvalidClientVersion("Input must be exactly 8 characters long (excluding any '0x' prefix)"), service: exec

This warning can be safely ignored, although it may cause a slight degradation to node performance as Lighthouse flip-flops the EL's state between healthy and unhealthy.

See NethermindEth/nethermind#7013 and paradigmxyz/reth#9137 for details.

Source builds without jemalloc will OOM on Linux

We've become aware of OOM issues for Lighthouse builds from source that disable the jemalloc feature on Linux. This is due to GNU malloc not handling the allocation of many tree nodes as well as other allocators (jemalloc, the Windows allocator). If you are building from source for Linux ensure that you include jemalloc in FEATURES (enabled by default). If you build the Dockerfile use --build-arg FEATURES=jemalloc (not enabled by default).

This will be addressed in v5.3.0 by an already-merged PR: #5995

Update Priority

This table provides priorities for which classes of users should update particular components.

User Class Beacon Node Validator Client
Staking Users Medium Low
Non-Staking Users Medium ---

See Update Priorities for more information about this table.

Lighthouse BNs and VCs from v5.0.0, v5.1.x and v5.2.x are compatible. However, we recommend that users update both the VC and BN to v5.2.1 if upgrading.

All changes

  • Release v5.2.1 (testing branch) (#5989)
  • Attempt to continue lookups after adding peers (#5993)
  • Remove all batches related to a peer on disconnect (#5969)
  • Update slasher DB size and Lighthouse book (#5934)
  • Ensure all handler events are covered (#5945)
  • report failed requests from RPC after being clear from rate limiter but not yet sent. (#5942)
  • Lower tolerance of stale blobs on gossip (#5935)
  • chore: simplify method to generate a random valid blob (#5946)
  • chore: change impl Into<T> for U to impl From<U> for T (#5948)
  • Update CI nethermind and LLVM versions (#5933)
  • Fix cargo audit: update curve25519-dalek (#5959)
  • Update local testnet documentation (#5896)
  • Fix SelfRateLimiter breaks the sequence of delayed_requests. (#5903)
  • Verify inclusion proof should not be fallible (#5787)
  • Remove extern crate (#5922)
  • Add FUNDING.json for DRIPS (#5932)
  • Fix CommandLineTest port conflicts on CI (#5908)
  • Remove some easy Electra TODOs (#5928)
  • Rust 1.79 lints (#5927)
  • Fix panic on startup in debug build (#5917)
  • Fix skip-ci on stable (#5909)
  • Beta compiler fixes (#5916)

See full changelog here.

Binaries

See pre-built binaries documentation.

The binaries are signed with Sigma Prime's PGP key: 15E66D941F697E28F49381F426416DC3F30674B0

System Architecture Binary PGP Signature
x86_64 lighthouse-v5.2.1-x86_64-apple-darwin.tar.gz PGP Signature
x86_64 lighthouse-v5.2.1-x86_64-apple-darwin-portable.tar.gz PGP Signature
x86_64 lighthouse-v5.2.1-x86_64-unknown-linux-gnu.tar.gz PGP Signature
x86_64 lighthouse-v5.2.1-x86_64-unknown-linux-gnu-portable.tar.gz PGP Signature
aarch64 lighthouse-v5.2.1-aarch64-unknown-linux-gnu.tar.gz PGP Signature
aarch64 lighthouse-v5.2.1-aarch64-unknown-linux-gnu-portable.tar.gz PGP Signature
x86_64 lighthouse-v5.2.1-x86_64-windows.tar.gz PGP Signature
x86_64 lighthouse-v5.2.1-x86_64-windows-portable.tar.gz PGP Signature
System Option - Resource
Docker v5.2.1 sigp/lighthouse

Tree People

11 Jun 03:20
v5.2.0
f1d88ba
Compare
Choose a tag to compare

Summary

This medium-priority release contains a major improvement to how states are managed in memory (tree-states) and an optimised epoch and block processing implementation. The beacon node now uses considerably less memory than the previous version thanks to more efficient state caching. It also includes other performance improvements, bug fixes and groundwork preparation for the upcoming Electra fork and PeerDAS upgrade.

memory

Notable changes in this release:

  • Epoch and block processing have been optimized, resulting in improved performance and security. The optimized epoch processing implementation is accompanied by a proof of correctness detailed in this post (#5279).
  • Introduce in-memory tree-states, providing more efficient state caching, improved overall performance and reduced memory usage (#5533).
  • Add server-sent events (SSE) for proposer slashing, attester slashing, and BLS to execution change (#5327, #5857).
  • Encode execution engine client version in block graffiti to probe execution layer client diversity, more details below (#5290).
  • Add new timing metrics for block availability to better reflect the actual delays caused by blob processing and other factors (#5510).
  • Update the proposer re-orgs feature to align with the latest spec (#5417).
  • Introduce new containers, presets, and configurations in preparation for the Electra fork (#5122, #5606, #5607, #5630, #5652, #5653).
  • Refactor and simplifications in sync and block lookup logic in preparation for PeerDAS (#5561, #5562, #5563, #5564, #5583, #5655).
  • Add a newbuilder-header-timeout flag, which allows for configuring timeouts for the get builder header API call (#5857)
  • Fix attestations not getting added to the aggregation pool. This improves the quality of aggregate attestations Lighthouse produces (#5863).

There are a few breaking changes. Please see the section on Breaking Changes below.

In-memory tree states (#5533)

This release introduces the memory-only portion of tree-states, marking a significant upgrade to state management. The beacon node can now hold ~64 times more states with approximately the same memory cost, significantly reducing memory usage and minimizing spikes. This enhancement also improves overall performance. Consequently, the default value for the --state-cache-size beacon node flag has been increased from 3 to 128. We recommend that users who had manually adjusted the state cache size try the new larger default.

This development brings us closer to the full implementation of tree-states (both in-memory and on-disk) in Lighthouse, an upgrade that has been in progress for over two years. Stay tuned for the remaining tree-states upgrades and their benefits in upcoming releases!

Encode execution engine client version in block graffiti (#5290)

To support better analysis of execution client diversity, Lighthouse now supports the engine_getClientVersionV1 API.

If no user graffiti is provided, and the method is supported by the execution node, then Lighthouse will use graffiti of the form:

  • GEab48LH5c2c

Here GE is the execution client shortcode corresponding to Geth, ab48 are the first 4 characters of Geth's commit hash, LH indicates Lighthouse, and 5c2c are the first 4 character's of Lighthouse's commit hash.

We expect execution clients to gradually gain support for this new API. Check your execution client's release notes for details. Note that the latest version of Nethermind (v1.26.0) includes a broken version of this API, so we recommend waiting until v1.27.0 is released before upgrading.

portable builds for Docker and binary releases (#5614, #5615)

All Lighthouse binaries and Docker images are now built using portable BLS. For backwards-compatibility *-modern Docker tags still exist as aliases. Similarly, binary tarballs for the -portable suffix are also attached to this release, but are identical to the unsuffixed binary tarballs. We recommend that automated update scripts switch over to using the :latest Docker image or the unsuffixed binary tarballs so we can remove the redundancy and streamline the available images and binaries in a future release.

The switch to portable is motivated by a change in the blst library to use runtime detection of hardware features. This puts portable builds on par for performance with modern builds, and simplifies the release update process for users and devs.

builder-header-timeout flag (#5857)

Lighthouse previously used a static timeout of 1.0s when requesting an execution payload header from an mev-boost relay. The new builder-header-timeout flag for the beacon node allows this value to be adjusted using a value in milliseconds, e.g. --builder-header-timeout 500 will set the timeout to 0.5s. This can be beneficial if communicating with a faraway relay which sometimes times out.

Breaking Changes

Several breaking changes have been made to CLI flags as part of a cleanup and modernisation effort. Please make sure to remove or update these flags as part of upgrading. The changes are described in detail below but the affected flags are:

  • VC: latency-measurement-service
  • BN: progressive-balances, http-spec-fork, http-allow-sync-stalled, self-limiter, inbound-rate-limiter.

We have avoided making breaking changes to the database schema in this release so that users can upgrade and downgrade more simply. The next release will include a number of on-disk changes.

🌲 If you were already running the tree-states beta (v5.1.222-exp), then the database schema for v5.2.0 is not compatible with your existing database. You need to either stay on that release, or wait for a new version that incorporates the on-disk changes (maybe v5.3.0). Unfortunately a re-sync will be required eventually, as the stable form of the tree-states DB will be different from the beta.

🦀 Minimum Supported Rust Version 1.77 🦀

The minimum supported Rust version (MSRV) has been updated to 1.77.0. Users who compile from source (i.e., not Docker or pre-built binary users) will receive the following error if they are using an earlier version of Rust:

lighthouse v5.2.0 (/home/sigp/lighthouse/lighthouse) cannot be built because it requires rustc 1.77 or newer

Users can typically obtain the latest version of Rust by running rustup update.

Deprecated latency-measurement-service flag

The validator client --latency-measurement-service flag is now deprecated in favour of --disable-latency-measurement-service. By default the latency measurement service is enabled, and can be disabled by providing the new --disable-latency-measurement-service flag. Using the prior --latency-measurement-service flag will have no effect and will become a hard error in a future release. This change was made as part of an upgrade to a new version of our CLI parsing library, Clap, in #5273.

Deprecated http-spec-fork and http-allow-sync-stalled flags (#5500)

Lighthouse now ignores the http-spec-fork value and keeps the default spec fork, as this option was rarely used.

The http-allow-sync-stalled flag has been deprecated and is now the default behaviour as Lighthouse now prioritises liveness for the HTTP API. These flags will be removed in upcoming releases.

See #5430 and #5500 for more details.

Deprecated --progressive-balances flag (#5279)

This optimisation (--progressive-balances=fast) is now the default and cannot be disabled. See #5279 for more details. A warning will be logged if the flag is provided, and in a future version we will remove the flag entirely.

Removed block processing metrics (#5510)

The block import metrics have been reworked to more accurately measure import delays and provide more insights into block availability and readiness for attestation.

The following block processing metrics have been removed:

  • beacon_block_observed_slot_start_delay_time
  • beacon_block_imported_observed_delay_time
  • beacon_block_head_imported_delay_time
  • beacon_block_head_slot_start_delay_time
  • beacon_block_head_slot_start_delay_exceeded_total
  • beacon_block_gossip_propagation_verification_delay_time
  • beacon_block_gossip_slot_start_delay_time
  • beacon_block_last_delay
  • beacon_block_gossip_arrived_late_total
  • beacon_blob_gossip_propagation_verification_delay_time
  • beacon_blob_gossip_slot_start_delay_time
  • beacon_blob_last_delay

For more details and the updated metrics, see #5510.

MDBX excluded from the Docker build (#5614)

The slasher-mdbx feature is no longer included as part of our standard Docker images.

The default slasher backend was changed from MDBX to LMDB in Lighthouse v4.3.0 for more stability and has been the recommended option. Advanced users can still use the slasher-mdbx feature with a custom Docker build.

Modified self-limiter flag

_This flag is mostly useful for developers and probably shouldn't be part of y...

Read more

Gul'karna

28 Mar 07:43
v5.1.3
3058b96
Compare
Choose a tag to compare

🔥 Hotfix 🔥

This hotfix release includes several bug fixes related to the handling of blobs. Upgrading to this release should result in less cache misses, lower peak memory usage, reduced bandwidth and greater stability.

This is a medium priority release.

We recommend that all users upgrade at their convenience. We particularly recommend upgrading if you are seeing either of these logs:

Mar 13 10:26:50.229 WARN Peer sent invalid response to parent request., reason: ExtraBlocksReturned, peer_id: ..., service: sync

Mar 24 23:20:56.001 WARN Did not advance head state reason: Err(HeadMissingFromSnapshotCache(...)), service: state_advance

Summary

Duplicate lookup bugfix

Since the release of v5.1.2 we have found a few more cases where Lighthouse could issue an excessive number of lookup requests for the same block. This would manifest as a warning log, followed by a loss of peers due to downscoring:

Mar 13 10:26:50.229 WARN Peer sent invalid response to parent request., reason: ExtraBlocksReturned, peer_id: ..., service: sync

The additional cases were related to concurrent lookups, and have been addressed in pull request #5488.

Blob RPC bugfix

We found that when Lighthouse imported a block after a blob RPC request, it was failing to run fork choice. This had several knock-on effects: the head state would be absent from the snapshot cache, which would lead to cache misses and further errors. In some instances, the cache misses would lead to a spike in memory usage while snapshots were reloaded from disk.

Fork choice now runs after all block imports (implemented in #5475). Some snapshot cache misses may still occur. We are planning to further improve snapshot handling in a future release.

Attestation cache size

The size of the seen-cache for attestation gossip has been updated in pull request #5493 to accomodate the wider validity window for attestations post-Deneb. This should result in reduced load by preventing old duplicate attestations from being reprocessed.

Light client server

The experimental light client server has been updated with Capella and Deneb support in pull request #4946. We do not yet recommend enabling it on mainnet. We will provide an update on the light client server in a future release.

Breaking Changes

None.

🐛 Known Issues 🐛

There is an outstanding bug in Lighthouse's UPnP implementation:

It can be worked around by running with --disable-upnp and manual port forwarding. We are planning another release containing a fix soon.

Update Priority

This table provides priorities for which classes of users should update particular components.

User Class Beacon Node Validator Client
Staking Users Medium Medium
Non-Staking Users Medium ---

See Update Priorities for more information about this table.

Lighthouse BNs and VCs from v5.0.0 and v5.1.0/v5.1.1/v5.1.2/v5.1.3 are intercompatible. However, we recommend that users update both the VC and BN to v5.1.3 if upgrading.

All Changes

  • Release v5.1.3 (#5497)
  • Bump duplicate cache time (#5493)
  • Lookup log improvements (#5491)
  • Single lookup improvements (#5488)
  • Run fork choice after RPC blob import (#5475)
  • Move gossipsub into a separate crate (#5401)
  • Fix double counted metrics (#5476)
  • Add Capella & Deneb light client support (#4946)
  • Delete PRE_CAPELLA_ENGINE_CAPABILITIES (#5406)
  • Built-in documentation text width in Lighthouse book (#5394)
  • Verify whether validators really are unknown during sync committee duty API request (#5174)
  • Make sure all geth processes are killed when stopping a local testnet (#5383)
  • Delete unused incomplete_processing_components (#5418)
  • Fix one and hide all beacon-processor flags (#5397)
  • chore: reduce scope of commitment (#5426)
  • chore: remove stale comment (#5440)
  • fix: tail command typo (#5456)
  • Improve parent lookup logging (#5451)

Binaries

See pre-built binaries documentation.

The binaries are signed with Sigma Prime's PGP key: 15E66D941F697E28F49381F426416DC3F30674B0

System Architecture Binary PGP Signature
x86_64 lighthouse-v5.1.3-x86_64-apple-darwin.tar.gz PGP Signature
x86_64 lighthouse-v5.1.3-x86_64-apple-darwin-portable.tar.gz PGP Signature
x86_64 lighthouse-v5.1.3-x86_64-unknown-linux-gnu.tar.gz PGP Signature
x86_64 lighthouse-v5.1.3-x86_64-unknown-linux-gnu-portable.tar.gz PGP Signature
aarch64 lighthouse-v5.1.3-aarch64-unknown-linux-gnu.tar.gz PGP Signature
aarch64 lighthouse-v5.1.3-aarch64-unknown-linux-gnu-portable.tar.gz PGP Signature
x86_64 lighthouse-v5.1.3-x86_64-windows.tar.gz PGP Signature
x86_64 lighthouse-v5.1.3-x86_64-windows-portable.tar.gz PGP Signature
System Option - Resource
Docker v5.1.3 sigp/lighthouse

Handsome Bigfoot

22 Mar 00:48
v5.1.2
5ce1619
Compare
Choose a tag to compare

🔥 Hotfix 🔥

This hotfix release includes a block lookup efficiency fix, a fix to stop propagation of slashings for attesters who have already been slashed, a fix to the --disable-upnp flag, and a couple of metric fixes.

This is a medium priority release.

We recommend you upgrade if you are seeing this log:

Mar 13 10:26:50.229 WARN Peer sent invalid response to parent request., reason: ExtraBlocksReturned, peer_id: ..., service: sync

Summary

We've had a couple reports of users seeing this log:

Mar 13 10:26:50.229 WARN Peer sent invalid response to parent request., reason: ExtraBlocksReturned, peer_id: ..., service: sync

This is a result of Lighthouse making duplicate requests to peers for the same block. This has been fixed in (#5432). If you are seeing this log, we recommend you upgrade.

Other client teams have notified us that Lighthouse propagates slashing messages for validators that have already been slashed. These messages are useless from the network's perspective so should be ignored (thanks @nisdas from Prysm). This has been resolved in (#5385).

The --disable-upnp was inneffective previously, but this has been fixed in (#5449).

Additionally this hotfix includes fixes to some metrics (#5404 and #5427).

Breaking Changes

None.

Update Priority

This table provides priorities for which classes of users should update particular components.

User Class Beacon Node Validator Client
Staking Users Medium Medium
Non-Staking Users Medium ---

See Update Priorities for more information about this table.

Lighthouse BNs and VCs from v5.0.0 and v5.1.0/v5.1.1/v5.1.2 are intercompatible. However, we recommend that users update both the VC and BN to v5.1.2 if upgrading.

All Changes

Changes relative to v5.1.1:

  • Release v5.1.2 (#5453)
  • disable libp2p upnp (#5449)
  • Fix gossip verification of duplicate attester slashings (#5385)
  • fix NAT nat_open metrics report (#5427)
  • Fix peer count metrics (#5404)
  • Improvements and Fixes in Documentation, Including Corrected Command Usage (#4998)
  • Fix Rust beta compiler errors 1.78.0-beta.1 (#5439)
  • Dedup parent blob requests (#5432)
  • Add attestation simulator, blobs info and some updates to Lighthouse Book (#5364)

Binaries

See pre-built binaries documentation.

The binaries are signed with Sigma Prime's PGP key: 15E66D941F697E28F49381F426416DC3F30674B0

System Architecture Binary PGP Signature
x86_64 lighthouse-v5.1.2-x86_64-apple-darwin.tar.gz PGP Signature
x86_64 lighthouse-v5.1.2-x86_64-apple-darwin-portable.tar.gz PGP Signature
x86_64 lighthouse-v5.1.2-x86_64-unknown-linux-gnu.tar.gz PGP Signature
x86_64 lighthouse-v5.1.2-x86_64-unknown-linux-gnu-portable.tar.gz PGP Signature
aarch64 lighthouse-v5.1.2-aarch64-unknown-linux-gnu.tar.gz PGP Signature
aarch64 lighthouse-v5.1.2-aarch64-unknown-linux-gnu-portable.tar.gz PGP Signature
x86_64 lighthouse-v5.1.2-x86_64-windows.tar.gz PGP Signature
x86_64 lighthouse-v5.1.2-x86_64-windows-portable.tar.gz PGP Signature
System Option - Resource
Docker v5.1.2 sigp/lighthouse

EXPERIMENTAL Tree States v5.1.222-exp

12 Mar 03:18
v5.1.222-exp
2cd0e60
Compare
Choose a tag to compare
Pre-release

Disclaimer

⚠️ You should not run this alpha release supporting mainnet validators ⚠️

If you are looking for the latest Lighthouse release please go to https://github.com/sigp/lighthouse/releases/latest.

Summary

This is an alpha release of upcoming changes to Lighthouse which improve disk usage and state management.

We are making this alpha release so that expert users may help us test these improvements. It is not backwards-compatible and not recommended for mainnet validators. Our current plan is to stabilise these changes shortly after the Deneb hard fork on mainnet.

For the adventurous, the main benefits are:

  • Smaller disk footprint for archive nodes, <200GB total. Use checkpoint sync, and set the flag --reconstruct-historic-states.
  • Smaller disk footprint for regular nodes, <30GB.
  • Faster handling of re-orgs.
  • Faster restarts.
  • Less disk I/O.

We hope that this is useful for running block explorers and supporting other beacon chain analytics. We are using it internally at SigP to run some of our analytics.

This release includes all the latest changes from v5.1.0 including Deneb on mainnet and the fixes for attestation performance. Check out the release notes for v5.1.0 for more information. Note that we do not recommend running mainnet validators using tree-states.

There are no substantial tree-states specific changes in this release, as we have been focussed on cleaning up the branch and preparing it for review & merge.

⚠️ Backwards Compatibility ⚠️

This release is backwards compatible with v5.0.111-exp, v4.6.222-exp, v4.6.111-exp, v4.5.444-exp, v4.5.222-exp and v4.4.111-exp.

This release is not backwards compatible with stable Lighthouse or tree-states releases prior to v4.4.111-exp. It uses a different database schema (v24) for which no automatic upgrade or downgrade is implemented. We intend to implement an automatic upgrade process once the new schema is finalized. A re-sync might be required to run future versions of tree-states. This release's schema might be the final iteration.

Please only run this release if you are willing to re-sync now, and again in several weeks/months.

There are several breaking changes to CLI flags:

  • The secret dummy flag --unsafe-and-dangerous-mode must be supplied. This is to prevent accidental upgrades to the release by users who don't know what they're getting themselves into. Unfortunately we found that far too many people accidentally ran previous tree-states releases on mainnet.
  • The flags --slots-per-restore-point and --historic-state-cache-size are deprecated and no longer necessary due to the freezer database using hierarchical diffs.
  • The flag --db-migration-period from tree-states v4.2.0-999-exp release is gone and has been replaced by --epochs-per-migration (same name as stable).

Known Issues

Expect a few sharp edges. Some things you may run into:

  • WARN Parent state is not advanced is logged excessively during sync. This is harmless, albeit annoying.
  • Memory usage may be a bit higher when using the parallel HTTP cache (see #5112).

If you observe any panics, crashes or major performance regressions, please open an issue!

Building from source

Build the v5.1.222-exp tag.

All Changes

  • Tree states release v5.1.222-exp
  • Fix macOS build by bumping cc (#5392)

Binaries

See pre-built binaries documentation.

The binaries are signed with Sigma Prime's PGP key: 15E66D941F697E28F49381F426416DC3F30674B0

System Architecture Binary PGP Signature
x86_64 lighthouse-v5.1.222-exp-x86_64-apple-darwin.tar.gz PGP Signature
x86_64 lighthouse-v5.1.222-exp-x86_64-apple-darwin-portable.tar.gz PGP Signature
x86_64 lighthouse-v5.1.222-exp-x86_64-unknown-linux-gnu.tar.gz PGP Signature
x86_64 lighthouse-v5.1.222-exp-x86_64-unknown-linux-gnu-portable.tar.gz PGP Signature
aarch64 lighthouse-v5.1.222-exp-aarch64-unknown-linux-gnu.tar.gz PGP Signature
aarch64 lighthouse-v5.1.222-exp-aarch64-unknown-linux-gnu-portable.tar.gz PGP Signature
x86_64 lighthouse-v5.1.222-exp-x86_64-windows.tar.gz PGP Signature
x86_64 lighthouse-v5.1.222-exp-x86_64-windows-portable.tar.gz PGP Signature
System Option - Resource
Docker v5.1.222-exp sigp/lighthouse

Summer Bigfoot

12 Mar 05:55
v5.1.1
2a3c709
Compare
Choose a tag to compare

🔥 Hotfix 🔥

This hotfix release is identical to v5.1.0, with the exception of some build system fixes for macOS.

If you have already updated to v5.1.0 then you can ignore this release.

The rest of the release notes describe the changes relative to v5.0.0.

Summary

This high-priority release includes a fix to ensure validator's messages are published on the network (#5357). Additionally, out-of-memory crashes are prevented by reducing peak memory usage (#5270).

This release (v5.1.1) and the previous v5 releases (v5.1.0 and v5.0.0) support the Deneb upgrade on March 13, 2024 at 13:55 UTC. Users who are already running v5.0.0 are not required to upgrade to v5.1.0/v5.1.1 before Deneb, but it is recommended.

Notable changes in this release:

  • Lighthouse now caches 3 states by default, rather than 4. The value can be modified with --state-cache-size (#5270)
  • The PATCH /lighthouse/validators/{validator_pubkey} VC HTTP API endpoint has been optimised (#5064)
  • A bug that prevented messages from being published to peers has been fixed (#5357)
  • Performance for NAT'd nodes has been improved (#5345)
  • Concurrent block production has been optimised, providing benefits for SSV operators (#5365)
  • A bug in the validator client which resulted in WARN Not enough time for a discovery search has been fixed (#5305)

Breaking Changes

Breaking Change: Milagro BLS is no longer supported

Lighthouse no longer supports the Milagro BLS library (#5298). This library was not recommended for production use and had to be manually enabled at compile time. We do not expect this change to impact users.

Reminder: Minimum Supported Rust Version 1.75.0

The minimum supported Rust version (MSRV) was updated to 1.75.0 in a previous release (v5.0.0). Users who compile from source (i.e., not Docker or pre-built binary users) will receive the following error if they are using an earlier version of Rust:

lighthouse v5.1.0 (/home/sigp/lighthouse/lighthouse) cannot be built because it requires rustc 1.75 or newer

Users can typically obtain the latest version of Rust by running rustup update.

Update Priority

This table provides priorities for which classes of users should update particular components.

User Class Beacon Node Validator Client
Staking Users High High
Non-Staking Users High ---

See Update Priorities for more information about this table.

Lighthouse BNs and VCs from v5.0.0 and v5.1.0/v5.1.1 are intercompatible. However, we recommend that users update both the VC and BN to v5.1.0/v5.1.1.

All Changes

Changes relative to v5.0.0:

  • Release v5.1.1 (#5396)
  • Fix macOS build by updating cc (#5393)
  • Release v5.1.0 (#5372)
  • Downgrade rate limited log (#5381)
  • Optimise concurrent block production (#5368)
  • Fix AddrInUse error in cli tests (#5266)
  • Explicit peers (#5333)
  • Improve peer performance for NAT'd nodes (#5345)
  • Reduce load on validator subscription channels (#5311)
  • Update CI actions to alleviate deprecation warnings (#5321)
  • Correct the metrics for topic subscriptions (#5344)
  • Attempt to publish to at least mesh_n peers (#5357)
  • Fix 5288: Doesn't POST if attestations is empty. (#5318)
  • Fix block v3 header decoding (#5366)
  • Delete milagro library (#5298)
  • Update dependency whoami (#5351)
  • Fix duties override bug in VC (#5305)
  • Improve logging around peer scoring (#5325)
  • bump ethereum_serde_utils (#5341)
  • Drop address_change_broadcast (#5287)
  • Optimise no-op PATCH ops in VC HTTP API (#5064)
  • Recognize the Caplin consensus client (#5304)
  • improve libp2p connected peer metrics (#5314)
  • remove exit-future (#5183)
  • remove nat module and use libp2p upnp (#4840)
  • Track multiaddr in connection status (#5308)
  • Fix typos and make block hash calculation public (#5275)
  • Add a cli option for the snapshot cache size (#5270)
  • Delete ancient, unused HTTP docs (#5281)
  • Run apt update before install. (#5295)
  • Add build instructions for Fedora/RHEL/CentOS (#5225)

Binaries

See pre-built binaries documentation.

The binaries are signed with Sigma Prime's PGP key: 15E66D941F697E28F49381F426416DC3F30674B0

System Architecture Binary PGP Signature
x86_64 lighthouse-v5.1.1-x86_64-apple-darwin.tar.gz PGP Signature
x86_64 lighthouse-v5.1.1-x86_64-apple-darwin-portable.tar.gz PGP Signature
x86_64 lighthouse-v5.1.1-x86_64-unknown-linux-gnu.tar.gz PGP Signature
x86_64 lighthouse-v5.1.1-x86_64-unknown-linux-gnu-portable.tar.gz PGP Signature
aarch64 lighthouse-v5.1.1-aarch64-unknown-linux-gnu.tar.gz PGP Signature
aarch64 lighthouse-v5.1.1-aarch64-unknown-linux-gnu-portable.tar.gz PGP Signature
x86_64 lighthouse-v5.1.1-x86_64-windows.tar.gz PGP Signature
x86_64 lighthouse-v5.1.1-x86_64-windows-portable.tar.gz PGP Signature
System Option - Resource
Docker v5.1.1 sigp/lighthouse

Bigfoot

11 Mar 02:27
v5.1.0
10a38a8
Compare
Choose a tag to compare

Summary

This high-priority release includes a fix to ensure validator's messages are published on the network (#5357). Additionally, out-of-memory crashes are prevented by reducing peak memory usage (#5270).

This release (v5.1.0) and the previous release (v5.0.0) both support the Deneb upgrade on March 13, 2024 at 13:55 UTC. Users who are already running v5.0.0 are not required to upgrade to v5.1.0 before Deneb, but it is recommended.

Notable changes in this release:

  • Lighthouse now caches 3 states by default, rather than 4. The value can be modified with --state-cache-size (#5270)
  • The PATCH /lighthouse/validators/{validator_pubkey} VC HTTP API endpoint has been optimised (#5064)
  • A bug that prevented messages from being published to peers has been fixed (#5357)
  • Performance for NAT'd nodes has been improved (#5345)
  • Concurrent block production has been optimised, providing benefits for SSV operators (#5365)
  • A bug in the validator client which resulted in WARN Not enough time for a discovery search has been fixed (#5305)

Breaking Changes

Breaking Change: Milagro BLS is no longer supported

Lighthouse no longer supports the Milagro BLS library (#5298). This library was not recommended for production use and had to be manually enabled at compile time. We do not expect this change to impact users.

Reminder: Minimum Supported Rust Version 1.75.0

The minimum supported Rust version (MSRV) was updated to 1.75.0 in a previous release (v5.0.0). Users who compile from source (i.e., not Docker or pre-built binary users) will receive the following error if they are using an earlier version of Rust:

lighthouse v5.1.0 (/home/sigp/lighthouse/lighthouse) cannot be built because it requires rustc 1.75 or newer

Users can typically obtain the latest version of Rust by running rustup update.

Update Priority

This table provides priorities for which classes of users should update particular components.

User Class Beacon Node Validator Client
Staking Users High High
Non-Staking Users High ---

See Update Priorities for more information about this table.

Lighthouse BNs and VCs from v5.0.0 and v5.1.0 are intercompatible. However, we recommend that users update both the VC and BN to v5.1.0.

All Changes

  • Release v5.1.0 (#5372)
  • Downgrade rate limited log (#5381)
  • Optimise concurrent block production (#5368)
  • Fix AddrInUse error in cli tests (#5266)
  • Explicit peers (#5333)
  • Improve peer performance for NAT'd nodes (#5345)
  • Reduce load on validator subscription channels (#5311)
  • Update CI actions to alleviate deprecation warnings (#5321)
  • Correct the metrics for topic subscriptions (#5344)
  • Attempt to publish to at least mesh_n peers (#5357)
  • Fix 5288: Doesn't POST if attestations is empty. (#5318)
  • Fix block v3 header decoding (#5366)
  • Delete milagro library (#5298)
  • Update dependency whoami (#5351)
  • Fix duties override bug in VC (#5305)
  • Improve logging around peer scoring (#5325)
  • bump ethereum_serde_utils (#5341)
  • Drop address_change_broadcast (#5287)
  • Optimise no-op PATCH ops in VC HTTP API (#5064)
  • Recognize the Caplin consensus client (#5304)
  • improve libp2p connected peer metrics (#5314)
  • remove exit-future (#5183)
  • remove nat module and use libp2p upnp (#4840)
  • Track multiaddr in connection status (#5308)
  • Fix typos and make block hash calculation public (#5275)
  • Add a cli option for the snapshot cache size (#5270)
  • Delete ancient, unused HTTP docs (#5281)
  • Run apt update before install. (#5295)
  • Add build instructions for Fedora/RHEL/CentOS (#5225)

Binaries

See pre-built binaries documentation.

The binaries are signed with Sigma Prime's PGP key: 15E66D941F697E28F49381F426416DC3F30674B0

System Architecture Binary PGP Signature
x86_64 lighthouse-v5.1.0-x86_64-apple-darwin.tar.gz PGP Signature
x86_64 lighthouse-v5.1.0-x86_64-apple-darwin-portable.tar.gz PGP Signature
x86_64 lighthouse-v5.1.0-x86_64-unknown-linux-gnu.tar.gz PGP Signature
x86_64 lighthouse-v5.1.0-x86_64-unknown-linux-gnu-portable.tar.gz PGP Signature
aarch64 lighthouse-v5.1.0-aarch64-unknown-linux-gnu.tar.gz PGP Signature
aarch64 lighthouse-v5.1.0-aarch64-unknown-linux-gnu-portable.tar.gz PGP Signature
x86_64 lighthouse-v5.1.0-x86_64-windows.tar.gz PGP Signature
x86_64 lighthouse-v5.1.0-x86_64-windows-portable.tar.gz PGP Signature
System Option - Resource
Docker v5.1.0 sigp/lighthouse

EXPERIMENTAL Tree States v5.0.111

23 Feb 05:11
v5.0.111-exp
20f53e7
Compare
Choose a tag to compare
Pre-release

Disclaimer

⚠️ You should not run this alpha release supporting mainnet validators ⚠️

If you are looking for the latest Lighthouse release please go to https://github.com/sigp/lighthouse/releases/latest.

Summary

This is an alpha release of upcoming changes to Lighthouse which improve disk usage and state management.

We are making this alpha release so that expert users may help us test these improvements. It is not backwards-compatible and not recommended for mainnet validators. Our current plan is to stabilise these changes shortly after the Deneb hard fork on mainnet.

For the adventurous, the main benefits are:

  • Smaller disk footprint for archive nodes, <200GB total. Use checkpoint sync, and set the flag --reconstruct-historic-states.
  • Smaller disk footprint for regular nodes, <30GB.
  • Faster handling of re-orgs.
  • Faster restarts.
  • Less disk I/O.

We hope that this is useful for running block explorers and supporting other beacon chain analytics. We are using it internally at SigP to run some of our analytics.

This release includes all the latest changes from v5.0.0 including Deneb on mainnet. Check out the release notes for v5.0.0 for more information. Note that we do not recommend running mainnet validators using tree-states.

There are no substantial tree-states specific changes in this release, as we have been focussed on cleaning up the branch and preparing it for review & merge.

⚠️ Backwards Compatibility ⚠️

This release is backwards compatible with v4.6.222-exp, v4.6.111-exp, v4.5.444-exp, v4.5.222-exp and v4.4.111-exp.

This release is not backwards compatible with stable Lighthouse or tree-states releases prior to v4.4.111-exp. It uses a different database schema (v24) for which no automatic upgrade or downgrade is implemented. We intend to implement an automatic upgrade process once the new schema is finalized. A re-sync might be required to run future versions of tree-states. This release's schema might be the final iteration.

Please only run this release if you are willing to re-sync now, and again in several weeks/months.

There are several breaking changes to CLI flags:

  • The secret dummy flag --unsafe-and-dangerous-mode must be supplied. This is to prevent accidental upgrades to the release by users who don't know what they're getting themselves into. Unfortunately we found that far too many people accidentally ran previous tree-states releases on mainnet.
  • The flags --slots-per-restore-point and --historic-state-cache-size are deprecated and no longer necessary due to the freezer database using hierarchical diffs.
  • The flag --db-migration-period from tree-states v4.2.0-999-exp release is gone and has been replaced by --epochs-per-migration (same name as stable).

Known Issues

Expect a few sharp edges. Some things you may run into:

  • WARN Parent state is not advanced is logged excessively during sync. This is harmless, albeit annoying.
  • Memory usage may be a bit higher when using the parallel HTTP cache (see #5112).

If you observe any panics, crashes or major performance regressions, please open an issue!

Building from source

Build the v5.0.111-exp tag.

All Changes

  • Tree states release v5.0.111-exp (#5276)
  • Fix tree-states tests (#5277)
  • Merge remote-tracking branch 'origin/unstable' into tree-states
  • Remove progressive balances mode (#5224)
  • Use epoch cache in block packing (#5223)
  • Delete unused epoch processing code (#5170)
  • Delete lighthouse db diff (#5171)

Binaries

See pre-built binaries documentation.

The binaries are signed with Sigma Prime's PGP key: 15E66D941F697E28F49381F426416DC3F30674B0

System Architecture Binary PGP Signature
x86_64 lighthouse-v5.0.111-exp-x86_64-apple-darwin.tar.gz PGP Signature
x86_64 lighthouse-v5.0.111-exp-x86_64-apple-darwin-portable.tar.gz PGP Signature
x86_64 lighthouse-v5.0.111-exp-x86_64-unknown-linux-gnu.tar.gz PGP Signature
x86_64 lighthouse-v5.0.111-exp-x86_64-unknown-linux-gnu-portable.tar.gz PGP Signature
aarch64 lighthouse-v5.0.111-exp-aarch64-unknown-linux-gnu.tar.gz PGP Signature
aarch64 lighthouse-v5.0.111-exp-aarch64-unknown-linux-gnu-portable.tar.gz PGP Signature
x86_64 lighthouse-v5.0.111-exp-x86_64-windows.tar.gz PGP Signature
x86_64 lighthouse-v5.0.111-exp-x86_64-windows-portable.tar.gz PGP Signature
System Option - Resource
Docker v5.0.111-exp sigp/lighthouse