Man Painted Silver Who Makes Robot Noises

🧑‍🔧 Release Candidate: Not for Production Use 🧑‍🔧

This is a release candidate. It is not production-ready and not recommended for mainnet use.

For more information on release candidates, see: https://lighthouse-book.sigmaprime.io/advanced-release-candidates.html

Summary

This release-candidate provides the updated total terminal difficulty (TTD) value for the Sepolia testnet. We recommend all users who wish to participate in the Sepolia merge to upgrade to this release.

Users on other networks (Mainnet, Prater, Ropsten, etc) do not need to upgrade to this release.

All Changes

• v2.3.2-rc.0 (#3289)
• Update Sepolia TTD (#3288)
• Recover from NonConsecutive eth1 errors (#3273)
• Test the pruning of excess peers using randomly generated input (#3248)
• Add more paths to HTTP API metrics (#3282)
• Add some debug logs for checkpoint sync (#3281)
• Deprecate step param in BlocksByRange RPC request (#3275)
• Initial work to remove engines fallback from the execution_layer crate (#3257)
• Enable malloc metrics for the VC (#3279)
• Avoid cloning snapshots during sync (#3271)
• Fix validator_monitor_prev_epoch_ metrics (#2911)
• Do not penalize peers on execution layer offline errors (#3258)
• Update cargo lockfile to fix RUSTSEC-2022-0025, RUSTSEC-2022-0026 and RUSTSEC-2022-0027 (#3278)
• Add sepolia config (#3268)

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-v2.3.2-rc.0-x86_64-apple-darwin.tar.gz	PGP Signature
	x86_64	lighthouse-v2.3.2-rc.0-x86_64-apple-darwin-portable.tar.gz	PGP Signature
	x86_64	lighthouse-v2.3.2-rc.0-x86_64-unknown-linux-gnu.tar.gz	PGP Signature
	x86_64	lighthouse-v2.3.2-rc.0-x86_64-unknown-linux-gnu-portable.tar.gz	PGP Signature
	aarch64	lighthouse-v2.3.2-rc.0-aarch64-unknown-linux-gnu.tar.gz	PGP Signature
	aarch64	lighthouse-v2.3.2-rc.0-aarch64-unknown-linux-gnu-portable.tar.gz	PGP Signature
	x86_64	lighthouse-v2.3.2-rc.0-x86_64-windows.tar.gz	PGP Signature
	x86_64	lighthouse-v2.3.2-rc.0-x86_64-windows-portable.tar.gz	PGP Signature
System	Option	-	Resource
	Docker	v2.3.2-rc.0	sigp/lighthouse

Butter Robot

Summary

This high-priority release contains important bug-fixes and improvements that we recommend for all users.

Notable changes include:

• Fix to prevent clock drift interfering with fork choice (#3243)
• Significant optimisations to reduce likelihood of missed head/target attestations (#3254, #3229)
• Fixes to networking issues (#3236, #3233, #3259, #2361)
• Improvements for the Ropsten testnet (#2340, #3234)

Breaking Changes

There are no known breaking changes in this release.

Reminder: Docker Base Image

In the previous release (v2.3.0), the Docker base image was updated from Ubuntu 20.04 to Ubuntu 22.04 LTS. Older versions of Docker are unable to run the new image due to an incompatibility, so please ensure that you update your Docker engine past version 20.10.10 (released Oct 2021). Please see #3230 for more information.

Update Priority

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

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

The Beacon Node may be updated without the Validator Client, however we recommend updating both components.

See Update Priorities for more information about this table.

All Changes

• v2.3.1 (#3262)
• Improve substream management (#3261)
• Optimise per_epoch_processing low-hanging-fruit (#3254)
• Lint against panicky calls in async functions (#3250)
• Pin MDBX at last version with Win/Mac support (#3246)
• minor libp2p upgrade (#3259)
• Only use authenticated endpoints during EE integration testing (#3253)
• do not count sync batch attempts when peer is not at fault (#3245)
• update libp2p (#3233)
• Fix per-slot timer in presence of clock changes (#3243)
• reduce reprocess queue/channel sizes (#3239)
• Fix: PeerManager doesn't remove "outbound only" peers which should be pruned (#3236)
• Update Ropsten TTD (#3240)
• Improve eth1 block cache sync (for Ropsten) (#3234)
• Switch Nethermind integration tests to use master branch (#3228)
• Emit log when fee recipient values are inconsistent (#3202)
• Use a stable tag for ubuntu in dockerfile (#3231)
• Inline safe_arith methods (#3229)
• Use genesis slot for node/syncing (#3226)
• Fix typo in peer state transition log (#3224)
• Add lcli indexed-attestations (#3221)
• Fix links in docs (#3219)

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-v2.3.1-x86_64-apple-darwin.tar.gz	PGP Signature
	x86_64	lighthouse-v2.3.1-x86_64-apple-darwin-portable.tar.gz	PGP Signature
	x86_64	lighthouse-v2.3.1-x86_64-unknown-linux-gnu.tar.gz	PGP Signature
	x86_64	lighthouse-v2.3.1-x86_64-unknown-linux-gnu-portable.tar.gz	PGP Signature
	aarch64	lighthouse-v2.3.1-aarch64-unknown-linux-gnu.tar.gz	PGP Signature
	aarch64	lighthouse-v2.3.1-aarch64-unknown-linux-gnu-portable.tar.gz	PGP Signature
	x86_64	lighthouse-v2.3.1-x86_64-windows.tar.gz	PGP Signature
	x86_64	lighthouse-v2.3.1-x86_64-windows-portable.tar.gz	PGP Signature
System	Option	-	Resource
	Docker	v2.3.1	sigp/lighthouse

Baby Wizard

Summary

This high priority release contains important bug-fixes and improvements that we recommend for all users. Importantly, fixes are included for the recent 7-block re-org on mainnet. Fast and widespread adoption of this release will help protect the network from repetition of this event.

This release also contains fixes to increase the chances of getting head votes and producing blocks during degenerate scenarios.

Notable changes include:

• Bug-fix to increase likelihood of block production in degenerate cases (#3188)
• Bug-fix to prevent missed head votes in degenerate cases (#3183)
• Running fork choice before proposing a block (#3168)
• Proposer boost reduced to 40% (#3201)
• Optimisation to lessen impact of backfill resource hogging (#3215)
• Support for the Ropsten Beacon Chain (#3184, #3225)
• Support for the Remote Key Manager API (#3162)
• Various improvements to syncing and networking (#3142, #3153, #3182)
• Bug-fix for HTTP Accept header parsing (#3185)
• Client authentication for Web3Signer (#3170)
• Smaller intermediate images during Docker builds (#3174)
• Fixes for merge testnets (#3165)

Thanks to external contributors @ackintosh, @huitseeker, @zsluedem and @petertdavies. Special shout-out to @tthebst who contributed two important PRs to this release (#3162, #3188).

Ropsten

Use the --network ropsten flag to join the Ropsten testnet.

This release introduces support for the Ropsten Beacon Chain with the updated total terminal difficulty (TTD) value of 1e32. We recommend all Ropsten users running v2.3.0-rc.0 to upgrade to this version before the Ropsten beacon chain genesis (less than 12 hours away, at the time of writing).

Breaking Changes

❗ Database Schema Upgrade ❗

This release contains a backwards-incompatible database schema migration for any network that has undergone "the merge" (see #3157). At the time of writing, this includes Kiln and Kintsugi but excludes Prater and Mainnet. For clarity:

• Prater, Mainnet: users who upgrade to v2.3.0 are able to downgrade to v2.2.x and v2.1.x releases using lighthouse db
• Kiln, Kinstugi: users who upgrade to v2.3.0 are not able to downgrade to any prior release

See the Database Migrations documentation for more information on downgrading.

Docker Base Image

The Docker base image has been updated from Ubuntu 20.04 to Ubuntu 22.04 LTS. Older versions of Docker are unable to run the new image due to an incompatibility, so please ensure that you update your Docker engine past version 20.10.10 (released Oct 2021). Please see #3230 for more information.

Update Priority

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

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

The Beacon Node may be updated without the Validator Client, however we recommend updating both components.

See Update Priorities for more information about this table.

All Changes

• v2.3.0 (#3222)
• Set Ropsten TTD to unrealistically high value (#3225)
• move backfill sync jobs from highest priority to lowest (#3215)
• Add new VC metrics for beacon node availability (#3193)
• v2.3.0-rc.0 (#3218)
• Avoid parallel fork choice runs during sync (#3217)
• Document database migrations (#3203)
• Decrease proposer boost to 40% (#3201)
• Call per_slot_task from a blocking thread (v2) (#3199)
• Remove build status badge from README (#3195)
• Fix Rust 1.61 clippy lints (#3192)
• Add Ropsten configuration (#3184)
• Run fork choice before block proposal (#3168)
• Log out response status when we hit PayloadIdUnavailable (#3190)
• Tiny improvement: PeerManager and maximum discovery query (#3182)
• Add client authentication to Web3Signer validators (#3170)
• Avoid unnecessary slashing protection when publishing blocks (#3188)
• Fix http header accept parsing problem (#3185)
• Remove DB migrations for legacy database schemas (#3181)
• Prevent attestation to future blocks from early attester cache (#3183)
• Allow TaskExecutor to be used in async tests (#3178)
• [refactor] Refactor Option/Result combinators (#3180)
• Remove lcli block packing analysis (#3179)
• Separate execution payloads in the DB (#3157)
• Exclude EE build dirs from Docker context (#3174)
• Add remotekey API support (#3162)
• Fix: no version info in homebrew package (#3167)
• Don't panic in forkchoiceUpdated handler (#3165)
• Fix Execution Engine integration tests (#3163)
• Change the url of the blog post (#3161)
• Poll shutdown timeout in rpc handler (#3153)
• log upgrades + prevent dialing of disconnecting peers (#3148)
• Disallow attesting to optimistic head (#3140)
• keep failed finalized chains to avoid retries (#3142)

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-v2.3.0-x86_64-apple-darwin.tar.gz	PGP Signature
	x86_64	lighthouse-v2.3.0-x86_64-apple-darwin-portable.tar.gz	PGP Signature
	x86_64	lighthouse-v2.3.0-x86_64-unknown-linux-gnu.tar.gz	PGP Signature
	x86_64	lighthouse-v2.3.0-x86_64-unknown-linux-gnu-portable.tar.gz	PGP Signature
	aarch64	lighthouse-v2.3.0-aarch64-unknown-linux-gnu.tar.gz	PGP Signature
	aarch64	lighthouse-v2.3.0-aarch64-unknown-linux-gnu-portable.tar.gz	PGP Signature
	x86_64	lighthouse-v2.3.0-x86_64-windows.tar.gz	PGP Signature
	x86_64	lighthouse-v2.3.0-x86_64-windows-portable.tar.gz	PGP Signature
System	Option	-	Resource
	Docker	v2.3.0	sigp/lighthouse

Robobros

🧑‍🔧 Release Candidate: Not for Production Use 🧑‍🔧

This is a release candidate. It is not production-ready and not recommended for mainnet use.

Whilst we do not recommend this release for critical and/or mainnet use, we would appreciate help testing this release on testnets.

For more information on release candidates, see: https://lighthouse-book.sigmaprime.io/advanced-release-candidates.html

Summary

This release candidate introduces support for the Ropsten Beacon Chain, among other changes.

The Ropsten Beacon Chain will launch on Monday, May 30th, 2022 3:00:00 PM +UTC. The long-standing Ropsten testnet is expected to undergo "the merge" in early June 2022. Any user that wishes to participate in the Ropsten merge must use this release candidate (or any following release).

Ropsten

Use the --network ropsten flag to join the Ropsten testnet.

Breaking Changes

❗ Database Schema Upgrade ❗

This release contains a backwards-incompatible database schema migration for any network that has undergone "the merge" (see #3157). At the time of writing, this includes Kiln and Kintsugi but excludes Prater and Mainnet. For clarity:

• Prater, Mainnet: users who upgrade to v2.3.0-rc.0 are able to downgrade to v2.2.x and v2.1.x releases.
• Kiln, Kinstugi: users who upgrade to v2.3.0-rc.0 are not able to downgrade to any prior release

All Changes

• v2.3.0-rc.0 (#3218)
• Avoid parallel fork choice runs during sync (#3217)
• Document database migrations (#3203)
• Decrease proposer boost to 40% (#3201)
• Call per_slot_task from a blocking thread (v2) (#3199)
• Remove build status badge from README (#3195)
• Fix Rust 1.61 clippy lints (#3192)
• Add Ropsten configuration (#3184)
• Run fork choice before block proposal (#3168)
• Log out response status when we hit PayloadIdUnavailable (#3190)
• Tiny improvement: PeerManager and maximum discovery query (#3182)
• Add client authentication to Web3Signer validators (#3170)
• Avoid unnecessary slashing protection when publishing blocks (#3188)
• Fix http header accept parsing problem (#3185)
• Remove DB migrations for legacy database schemas (#3181)
• Prevent attestation to future blocks from early attester cache (#3183)
• Allow TaskExecutor to be used in async tests (#3178)
• [refactor] Refactor Option/Result combinators (#3180)
• Remove lcli block packing analysis (#3179)
• Separate execution payloads in the DB (#3157)
• Exclude EE build dirs from Docker context (#3174)
• Add remotekey API support (#3162)
• Fix: no version info in homebrew package (#3167)
• Don't panic in forkchoiceUpdated handler (#3165)
• Fix Execution Engine integration tests (#3163)
• Change the url of the blog post (#3161)
• Poll shutdown timeout in rpc handler (#3153)
• log upgrades + prevent dialing of disconnecting peers (#3148)
• Disallow attesting to optimistic head (#3140)
• keep failed finalized chains to avoid retries (#3142)

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-v2.3.0-rc.0-x86_64-apple-darwin.tar.gz	PGP Signature
	x86_64	lighthouse-v2.3.0-rc.0-x86_64-apple-darwin-portable.tar.gz	PGP Signature
	x86_64	lighthouse-v2.3.0-rc.0-x86_64-unknown-linux-gnu.tar.gz	PGP Signature
	x86_64	lighthouse-v2.3.0-rc.0-x86_64-unknown-linux-gnu-portable.tar.gz	PGP Signature
	aarch64	lighthouse-v2.3.0-rc.0-aarch64-unknown-linux-gnu.tar.gz	PGP Signature
	aarch64	lighthouse-v2.3.0-rc.0-aarch64-unknown-linux-gnu-portable.tar.gz	PGP Signature
	x86_64	lighthouse-v2.3.0-rc.0-x86_64-windows.tar.gz	PGP Signature
	x86_64	lighthouse-v2.3.0-rc.0-x86_64-windows-portable.tar.gz	PGP Signature
System	Option	-	Resource
	Docker	v2.3.0-rc.0	sigp/lighthouse

Talking Cat

Summary

This release fixes a bug in Lighthouse v2.2.0 that prevented some nodes from completing sync.

The majority of nodes running v2.2.0 will not have been affected by the bug, but nodes attempting to sync from genesis would get stuck at slot 0 forever, and nodes performing checkpoint sync would fail to download blocks from before the Altair hard fork (Oct 2021). The bug occurred as a result of changes made to RPC limits in preparation for the Merge, and has been fixed in PR #3146. Please see that pull request for more detail.

Users upgrading from v2.1 should also read the release notes for v2.2.0 to understand a new protocol feature called proposer boost which has been enabled in v2.2: https://github.com/sigp/lighthouse/releases/tag/v2.2.0

Backwards Compatibility

This release is fully backwards-compatible with the previous releases v2.2.0 and v2.1.x.

Downgrading from v2.2.1 to v2.1.x is also supported without any manual intervention.

Update Priority

This update is a Medium Priority update for users of Lighthouse v2.2.0, and a Low Priority update for v2.1.x.

User Class	Beacon Node	Validator Client
Staking Users	Low Priority*	Low Priority*
Non-Staking Users	Low Priority*	---

See Update Priorities for more information about this table.

All Changes

• v2.2.1 (#3149)
• Don't log crits for missing EE before Bellatrix (#3150)
• Fix rpc limits version 2 (#3146)
• Transition Block Proposer Preparation (#3088)
• Fix SPRP default value in cli (#3145)
• Ensure VALID response from fcU updates protoarray (#3126)
• Add tests for importing blocks on invalid parents (#3123)

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-v2.2.1-x86_64-apple-darwin.tar.gz	PGP Signature
	x86_64	lighthouse-v2.2.1-x86_64-apple-darwin-portable.tar.gz	PGP Signature
	x86_64	lighthouse-v2.2.1-x86_64-unknown-linux-gnu.tar.gz	PGP Signature
	x86_64	lighthouse-v2.2.1-x86_64-unknown-linux-gnu-portable.tar.gz	PGP Signature
	aarch64	lighthouse-v2.2.1-aarch64-unknown-linux-gnu.tar.gz	PGP Signature
	aarch64	lighthouse-v2.2.1-aarch64-unknown-linux-gnu-portable.tar.gz	PGP Signature
	x86_64	lighthouse-v2.2.1-x86_64-windows.tar.gz	PGP Signature
	x86_64	lighthouse-v2.2.1-x86_64-windows-portable.tar.gz	PGP Signature
System	Option	-	Resource
	Docker	v2.2.1	sigp/lighthouse

Balthromaw

Summary

This release includes a minor protocol upgrade named proposer boost, which is designed to mitigate several attacks against fork choice.

It is recommended that all users upgrade over the course of the next few weeks.

Proposer Boost

Background

Proposer boost mitigates attacks involving the delayed publishing of blocks and attestations. By creating disagreement amongst honest nodes, an attacker could frustrate consensus and cause re-orgs. For more detail on the attacks mitigated, please see Three Attacks on Proof-of-Stake Ethereum by researchers from the Ethereum Foundation and Stanford University.

Mitigation

Proposer boost mitigates the attacks by granting additional power to the proposer of each block, equal to 70% of the weight of the attesters in a single slot. This 70% "boost" is only granted to timely blocks, which prevents the delayed-publishing attack while also incentivizing on-time block publication in general. For more information please see the accompanying pull request to the beacon chain specification: ethereum/consensus-specs#2730.

Upgrade Strategy

By virtue of being a protocol change, proposer boost needs to be rolled out by a large fraction of the nodes on the network in order to be effective. This Lighthouse release is coordinated with forthcoming releases from the other consensus clients.

Although it's best for all nodes on the network to adopt proposer boost within a short time frame, we estimate that the impact of upgrades spaced over the course of a few weeks will be minimal. For more detailed analysis please see #3131.

In addition to theoretical analysis and unit testing, proposer boost has also undergone extensive testing on the Prater testnet, where it has been enabled for several months.

Other New Features

• The beacon node and validator client HTTP APIs can now be hosted on IPv6 addresses (#3104).
• The concurrency of request handling during sync was improved (#3036).
• A command for manually inspecting the beacon node's database was added (#3129).
• Lots of progress was made towards The Merge, including:
  • Groundwork for MEV (#3062)
  • Bugfixes (#3133, #3132, #3125, #3071).

Backwards Compatibility

This release is fully backwards-compatible with the previous release.

Downgrading from v2.2.0 to v2.1.x is also supported without any manual intervention.

Update Priority

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

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

See Update Priorities for more information about this table.

All Changes

• v2.2.0 (#3139)
• Update mdbook runner to Ubuntu 20.04 (#3138)
• Update and consolidate dependencies (#3136)
• Fix merge rpc length limits (#3133)
• Conserve disk space by raising default SPRP (#3137)
• Enable proposer boost on mainnet and GBC (#3131)
• Strip newline from jwt secrets (#3132)
• Add lighthouse db command (#3129)
• Kiln mev boost (#3062)
• json rpc id to value (#3110)
• Increase timeouts for EEs (#3125)
• Update engine state in broadcast (#3071)
• Improve slashing import log (#3122)
• Fix typos in docs (#3121)
• Target geth master in integration testing (#3120)
• Optionally skip RANDAO verification during block production (#3116)
• Add merge objects to lcli parse-ssz subcommand (#3119)
• feat: Update ASCII art (#3113)
• Support IPv6 in BN and VC HTTP APIs (#3104)
• Add Nethermind integration tests (#3100)
• Remove sync await points (#3036)
• Add Proposer Cache Pruning & POS Activated Banner (#3109)
• Fix ganache windows CI attempt 2 (#3107)
• Fix ganache in windows CI (#3105)
• Correct typos book (#3099)
• Updates to tests and local testnet for Ganache 7 (#3056)

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-v2.2.0-x86_64-apple-darwin.tar.gz	PGP Signature
	x86_64	lighthouse-v2.2.0-x86_64-apple-darwin-portable.tar.gz	PGP Signature
	x86_64	lighthouse-v2.2.0-x86_64-unknown-linux-gnu.tar.gz	PGP Signature
	x86_64	lighthouse-v2.2.0-x86_64-unknown-linux-gnu-portable.tar.gz	PGP Signature
	aarch64	lighthouse-v2.2.0-aarch64-unknown-linux-gnu.tar.gz	PGP Signature
	aarch64	lighthouse-v2.2.0-aarch64-unknown-linux-gnu-portable.tar.gz	PGP Signature
	x86_64	lighthouse-v2.2.0-x86_64-windows.tar.gz	PGP Signature
	x86_64	lighthouse-v2.2.0-x86_64-windows-portable.tar.gz	PGP Signature
System	Option	-	Resource
	Docker	v2.2.0	sigp/lighthouse

Hydrogen-F

Summary

This is a security-focussed release to address a denial-of-service vulnerability in OpenSSL (CVE-2022-0778).

Lighthouse does not rely on OpenSSL for any of its P2P functionality, but does make use of OpenSSL TLS when making HTTPS connections. We recommend that users upgrade to this release from v2.1.4 if they are using HTTPS URLs in their configuration and are concerned about the denial-of-service risk, see below for details.

OpenSSL Vulnerability Detail

If configured, Lighthouse will use HTTPS to connect to URLs passed to --eth1-endpoints, --checkpoint-sync-url or --beacon-nodes (from the validator client). These URLs typically correspond to servers trusted by the user, but still pose a denial-of-service risk if the connection is intercepted by an intermediary (e.g. an ISP or public hotspot router). We believe that attacks are unlikely to occur in practice, and that their impact would be relatively minor — lighthouse would hang, but there would be no slashing risk nor risk of signing keys being compromised.

For more information please see:

• OpenSSL security advisory: https://www.openssl.org/news/secadv/20220315.txt
• Lighthouse fix: #3095

Backwards Compatibility

Other than the OpenSSL fix, this release is functionally equivalent to the previous release, and is 100% backward compatible.

Update Priority

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

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

See Update Priorities for more information about this table.

All Changes

• v2.1.5 (#3096)
• Update openssl for CVE-2022-0778 (#3095)
• Clarify proposers message is about current epoch (#3084)
• Add minimum supported Rust version (#3082)

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-v2.1.5-x86_64-apple-darwin.tar.gz	PGP Signature
	x86_64	lighthouse-v2.1.5-x86_64-apple-darwin-portable.tar.gz	PGP Signature
	x86_64	lighthouse-v2.1.5-x86_64-unknown-linux-gnu.tar.gz	PGP Signature
	x86_64	lighthouse-v2.1.5-x86_64-unknown-linux-gnu-portable.tar.gz	PGP Signature
	aarch64	lighthouse-v2.1.5-aarch64-unknown-linux-gnu.tar.gz	PGP Signature
	aarch64	lighthouse-v2.1.5-aarch64-unknown-linux-gnu-portable.tar.gz	PGP Signature
	x86_64	lighthouse-v2.1.5-x86_64-windows.tar.gz	PGP Signature
	x86_64	lighthouse-v2.1.5-x86_64-windows-portable.tar.gz	PGP Signature
System	Option	-	Resource
	Docker	v2.1.5	sigp/lighthouse

Magnesium-J

Summary

This release contains optimisations to P2P networking to improve validator performance. It also contains new functionality for The Merge and out-of-the-box support for the Kiln testnet via the --network kiln flag.

This release will increase the default peer count from 50 to 80. Users who don't specify a custom --target-peers value should see an increased peer count after updating. This is normal and expected.

Other notable features include:

• Ignore non-routable IPs in discovery (#3023)
  • See the "Breaking Changes" section for more details.
• Removal of unnecessary error/warning logs related to sync committees (#2999, #3086)
• Support for requesting proposer duties for the next epoch via the HTTP API (#2963)
• Addition of an API to compute block packing efficiency (#2879)
• Improved performance when a VC encounters timeout errors for a BN (#3022)
• Addition of --validator-dir alias, to aid usability (#3034)
• Fixes to missing quotes on integer values on the API (#3074, #3080)

Increased Peer Count

Ensuring peak performance on the P2P network frequently involves trade-offs between bandwidth usage and ensuring there is a diverse and useful set of peers. The trade-off space varies over time as the network increases in size and as different implementations evolve.

As described in this comment, increasing the default peer count from 50 to 80 has shown to provide significant benefits in peer management whilst making a less significant impact on network bandwidth.

The upside of this change is that we expect less "InsufficientPeers" errors, therefore reducing penalties caused by missed/late attestations or sync messages. The downside is that we expect users to notice a ~50% increase in bytes transmitted on the network and a ~15% increase in bytes recieved (mileage may vary).

Users who prefer minimal bandwidth are free to use --target-peers 50 and maintain the status-quo. That being said, we expect most users will be happy with the new default value of 80.

Breaking Changes

Discovery and Non-Routable IPs

In #3032, Lighthouse now ignores non-globally-routable IP addresses during discovery. This prevents some cloud providers (e.g., Hetzner) from banning Lighthouse under the (false) premise that it is maliciously scanning the private network.

We only expect this to impact developers running local testnets and enterprise users with sophisticated internal P2P routing. This change can be reverted by adding the --enable-private-discovery flag to the BN.

Kintsugi

The Kintsugi testnet is not supported by this release. Users should prefer Kiln.

VC and BN Update Procedure

The VC and BN between this release and the previous are compatible. You may update them independently.

Update Priority

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

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

See Update Priorities for more information about this table.

All Changes

• v2.1.4 (#3076)
• Ignore attestations to finalized blocks (don't reject) (#3052)
• Lower debug! logs to trace! (#3053)
• Rename random to prev_randao (#3040)
• Custom RPC request management for sync (#3029)
• Update libp2p (#3039)
• Filter non global ips from discovery (#3023)
• Rename Eth1/Eth2 in documents (#3021)
• Increase default target-peer count to 80 (#3005)
• Enforce Optimistic Sync Conditions & CLI Tests (v2) (#3050)
• Cleanup small issues (#3027)
• Retrospective invalidation of exec. payloads for opt. sync (#2837)
• Update to Rust 1.59 and 2021 edition (#3038)
• Ensure logfile respects the validators-dir CLI flag (#3003)
• Add aliases for validator-dir flags (#3034)
• Avoid hogging the fallback status lock in the VC (#3022)
• Increase Bors timeout, refine target-branch-check (#3035)
• Add API to compute block packing efficiency data (#2879)
• Allow proposer duties request for the next epoch (#2963)
• Fix sync committee polling for 0 validators (#2999)
• Improved peer management (#2993)
• Use SmallVec in Bitfield (#3025)
• Engine API v1.0.0.alpha.6 + interop tests (#3024)
• Update to consensus-specs v1.1.9 (#3016)
• Update block reward API docs (#3013)

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-v2.1.4-x86_64-apple-darwin.tar.gz	PGP Signature
	x86_64	lighthouse-v2.1.4-x86_64-apple-darwin-portable.tar.gz	PGP Signature
	x86_64	lighthouse-v2.1.4-x86_64-unknown-linux-gnu.tar.gz	PGP Signature
	x86_64	lighthouse-v2.1.4-x86_64-unknown-linux-gnu-portable.tar.gz	PGP Signature
	aarch64	lighthouse-v2.1.4-aarch64-unknown-linux-gnu.tar.gz	PGP Signature
	aarch64	lighthouse-v2.1.4-aarch64-unknown-linux-gnu-portable.tar.gz	PGP Signature
	x86_64	lighthouse-v2.1.4-x86_64-windows.tar.gz	PGP Signature
	x86_64	lighthouse-v2.1.4-x86_64-windows-portable.tar.gz	PGP Signature
System	Option	-	Resource
	Docker	v2.1.4	sigp/lighthouse

Garbage Goober

Summary

This release addresses a bug in rust-libp2p which has been causing the Lighthouse networking stack to perform poorly since the v2.1.0 release.

This bug-fix significantly improves peer stability and is recommended for any user who is seeing an erratic peer-count and/or missing attestations due to InsufficientPeers.

Fix to rust-libp2p

Since the v2.1.0 release, users have been reporting issues with peer stability manifesting as missed attestations.

After months of developer hours investigating this issue and making peer stability improvements via other methods, we are relieved to have identified an obscure but impactful bug in rust-libp2p.

Whilst user feedback will be the ultimate indicator of success, we are confident that this release will represent a major improvement in peer stability.

Lighthouse relies on a regular "heartbeat" from rust-libp2p in order to perform many critical tasks. An unfortunate regression in rust-libp2p caused the heartbeat to become irregular and stretch from a 700ms interval to several minutes. We have raised this issue with the rust-libp2p developers who have been receptive and are working on a fix. To provide relief to our users, Lighthouse is using a Sigma Prime fork of rust-libp2p with a hot-fix applied.

Breaking Changes

The Pyrmont network is no longer natively supported by Lighthouse (#2543). This means that the --network pyrmont flag will no longer work.

Since the Pyrmont testnet is abandoned and in a state of disarray, we do not expect this to be of concern to our users. The Prater testnet has superseded the Pyrmont testnet.

Users can still opt to use the --testnet-dir flag to manually sync the Prymont network, if desired.

VC and BN Update Procedure

The VC and BN between this release and the previous are compatible. You may update them independently.

Update Priority

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

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

See Update Priorities for more information about this table.

All Changes

• v2.1.3 (#3017)
• Remove Pyrmont testnet (#2543)
• libp2p upgrade + gossipsub interval fix (#3012)
• Add "update priority" (#2988)
• Allow per validator fee recipient via flag or file in validator client (similar to graffiti / graffiti-file) (#2924)
• Bump crossbeam-utils to fix cargo-audit CI failure (#3004)
• Fix Docker run -p for both TCP and UDP (#2998)
• Gossip cache timeout adjustments (#2997)
• Correct a dial race condition (#2992)
• upgrade libp2p (#2933)
• Retry gossipsub messages when insufficient peers (#2964)

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-v2.1.3-x86_64-apple-darwin.tar.gz	PGP Signature
	x86_64	lighthouse-v2.1.3-x86_64-apple-darwin-portable.tar.gz	PGP Signature
	x86_64	lighthouse-v2.1.3-x86_64-unknown-linux-gnu.tar.gz	PGP Signature
	x86_64	lighthouse-v2.1.3-x86_64-unknown-linux-gnu-portable.tar.gz	PGP Signature
	aarch64	lighthouse-v2.1.3-aarch64-unknown-linux-gnu.tar.gz	PGP Signature
	aarch64	lighthouse-v2.1.3-aarch64-unknown-linux-gnu-portable.tar.gz	PGP Signature
	x86_64	lighthouse-v2.1.3-x86_64-windows.tar.gz	PGP Signature
	x86_64	lighthouse-v2.1.3-x86_64-windows-portable.tar.gz	PGP Signature
System	Option	-	Resource
	Docker	v2.1.3	sigp/lighthouse

Heistotron

Summary

This release significantly improves peer stability and is recommended for any user who is seeing an erratic peer-count and/or missing attestations due to InsufficientPeers.

In addition to peer stability improvements, this release also contains:

• Eth2 Key Manager API support for the validator client (#2736)
• Docker Hub images with CPU-optimized "modern" BLST (#2966)
• Support for --network gnosis (#2931)

Peer Scoring Stability

There appears to be a significant portion of peers which are transmitting late messages on the p2p gossip network. The cause is yet to be determined and it's clear that more time will be required to investigate. The late messages are not likely to consume a significant amount of system or network resources, so it seems beneficial to network stability to temporarily tolerate peers who exhibit this behaviour (see (#2976). Once the cause(s) of the late messages is/are determined, we will revisit the peer-scoring parameters.

Optimized Docker Images

If you are running Lighthouse under Docker on a modern CPU then you can probably upgrade to the latest-modern tag for a 20-30% speed-up on signature verification.

If you are running the Lighthouse image manually, use latest-modern or v2.1.2-modern in your docker commands, e.g.

docker run sigp/lighthouse:latest-modern

If you are using lighthouse-docker then you can upgrade by setting LIGHTHOUSE_VERSION=latest-modern in your .env file.

To check whether your CPU is compatible with the optimized image, see Portability in the book. For more information on all the available images, see Available Docker Images.

VC and BN Update Procedure

The VC and BN between this release and the previous are compatible. You may update them independently.

Update Priority

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

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

User Classes and Priorities

Staking users are those who use lighthouse bn and lighthouse vc to stake on the Beacon Chain. Non-staking users are those who run a lighthouse bn for non-staking purposes (e.g., data analysis or applications).

High priority updates should be completed as soon as possible (e.g., hours or days). Medium priority updates should be completed at the next convenience (e.g., days or a week). Low priority updates should be completed in the next routine update cycle (e.g., two weeks).

All Changes

• v2.1.2 (#2980)
• Add checks to prevent fwding old messages (#2978)
• Add strict penalties const bool (#2976)
• Fix small typo in error log (#2975)
• local testnet: Fix an error on startup (#2973)
• Run setup.sh foreground in order to avoid timing issues (#2970)
• Optimized Docker images (#2966)
• Reduce gossip history (#2969)
• Parse uint256 as decimal string (#2957)
• Implement standard keystore API (#2736)
• Native support for Gnosis Beacon Chain network (#2931)
• Avoid looking up pre-finalization blocks (#2909)
• Add API to compute discrete validator attestation performance (#2874)
• Outaded flag in lighthouse book (#2965)
• Implement API for block rewards (#2628)
• Add flag to disable confirmation when performing voluntary exits (#2955)
• Set mmap threshold to 128KB in malloc utils (#2937)
• Code quality improvents to the network service (#2932)
• Document why we hash downloaded blocks for both sync algs (#2927)
• Fix errors from local testnet scripts on MacOS (#2919)

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-v2.1.2-x86_64-apple-darwin.tar.gz	PGP Signature
	x86_64	lighthouse-v2.1.2-x86_64-apple-darwin-portable.tar.gz	PGP Signature
	x86_64	lighthouse-v2.1.2-x86_64-unknown-linux-gnu.tar.gz	PGP Signature
	x86_64	lighthouse-v2.1.2-x86_64-unknown-linux-gnu-portable.tar.gz	PGP Signature
	aarch64	lighthouse-v2.1.2-aarch64-unknown-linux-gnu.tar.gz	PGP Signature
	aarch64	lighthouse-v2.1.2-aarch64-unknown-linux-gnu-portable.tar.gz	PGP Signature
	x86_64	lighthouse-v2.1.2-x86_64-windows.tar.gz	PGP Signature
	x86_64	lighthouse-v2.1.2-x86_64-windows-portable.tar.gz	PGP Signature
System	Option	-	Resource
	Docker	v2.1.2	sigp/lighthouse