Tony

Summary

This release marks the first minor version increase since the v1.1.x series. It contains several improvements to Lighthouse's stability and performance, particularly for users running multiple validators.

Removal of the pubkey cache file (which has historically been a source of obscure bugs) necessitates a change to the database schema, which will be applied automatically on start-up. A side effect of this schema change is that downgrading Lighthouse will not be possible after upgrading. We will be standing by to make a point release should any issues arrive, although increased testing for this release gives us hope that won't be necessary.

Due to the changes to the API, it is essential to update both the beacon node and validator client to the new version.

This release should improve the health of the entire network (in addition to boosting individual rewards), so we recommend that all users upgrade as soon as they're able.

Highlights

• A mechanism was introduced to handle blocks that arrive early. This has the potential to improve validator rewards by ensuring that Lighthouse follows the chain as promptly as possible, and also solves an issue with peer reputation (#2155).
• Update the HTTP API to align with the API spec on the validator status field. This is a breaking change which will require changes to downstream API consumers (#2149).
• Prune the slashing protection database periodically, to prevent it from becoming oversized and slowing down signing. This is particularly relevant for users with large numbers of validators (100+), and has shown marked improvements for our Pyrmont validators (#2194).
• Add the ability to set the graffiti from a file, for maximum flexibility when defacing the graffiti wall. Check out the docs for this new feature in the book: https://lighthouse-book.sigmaprime.io/graffiti.html (#2044).
• Remove the pubkey cache file (pubkey_cache.ssz), storing its contents in the database instead (#2234).
• Expedite block proposal by running slot processing before the proposal window. This aims to get blocks out earlier so that they have more time to propagate and are less likely to be orphaned (#2241).

All Changes

• Release v1.2.0 (#2249)
• Fix proposer cache priming upon state advance (#2252)
• Release candidate v1.2.0-rc.0 (#2248)
• Prevent adding and dialing bootnodes when discovery is disabled (#2247)
• Update blst to 0.3.3 (#2246)
• Use advanced state for block production (#2241)
• Use the database to persist the pubkey cache (#2234)
• Resolve RUSTSEC-2020-0146 (#2242)
• Expose the startup timestamp to Prometheus (#2233)
• Set graffiti per validator (#2044)
• Update to the latest libp2p (#2239)
• Bump spec tests to v1.0.1 (#2235)
• Improve error when user doesn't have a wallet (#2231)
• update tokio-stream to 0.1.3 and use BroadcastStream (#2212)
• Lint for sum and product in consensus code (#2226)
• Make lighthouse_version compatible with old Git (#2223)
• Prune slashing protection DB (#2194)
• Allow HTTP API to return SSZ blocks (#2209)
• Update ValidatorStatus to match the v1 API (#2149)
• Handle early blocks (#2155)
• Fix lighthouse_version (#2221)

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

Hamurai

Summary

This release contains a fix to a known issue which can cause excessive memory consumption as documented in #2215.

We recommend all users update at their earliest convenience. Users directly experiencing the issue described in #2215 should update immediately.

Additionally, a false-positive warning about resource consumption ("State advance too slow") was fixed. See #2214 for more details.

Excessive Resource Consumption

If your node is continually printing the follow log, then you are affected by the bug described in #2215 and should update as soon as possible:

Feb xx xx:xx:xx.xxx INFO Address updated                         udp_port: 9000, ip: ::ffff:xxx.xxx.xxx.xxx, service: libp2p

Note: the Lighthouse team is only aware of 3 or 4 cases at this point in time.

All Changes

• v1.1.3 (#2217)
• Fix false positive "State advance too slow" logs (#2218)
• Address ENR update loop (#2216)

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

Jerry Smith

Summary

Fixes a bug (#2211) which prevented the HTTP servers from starting when the CORS wildcard was supplied.

This update is only recommended for users who are experiencing issues with the CORS flag. There is no need to upgrade if your Lighthouse nodes are running on v1.1.1 without emitting any relevant CRIT, ERRO or WARN messages.

Users running versions prior to v1.1.1 should upgrade to v1.1.2 for the reasons described in the v1.1.1 release notes.

CORS Bug

The following flags would cause an issue if supplied to the v1.1.1 BN or VC:

• --http-allow-origin "*"
• --metrics-allow-origin "*"

All Changes

• v1.1.2 (#2213)
• Switch back to warp with cors wildcard support (#2211)
• Add slot offset computing to be downloaded slot (#2198)
• Fix short sha in github actions (#2210)
• Update rustup in release action (#2206)

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

Rick WTM-72

This release contains important optimizations that reduce the propagation times of new blocks on the network. It is recommended that all users upgrade to this version as block propagation delays directly impact validator profits.

Additionally, an upgrade to a upstream dependency (tokio) contains an important fix to a runtime panic. See #2099 for more detail.

Breaking Changes

No breaking changes to the Lighthouse API. The latest version of stable Rust will be required to compile (Rust 1.50).

All Changes

• v1.1.1 (#2202)
• Upgrade rand_core (#2201)
• Advance state to next slot after importing block (#2174)
• Dht persistence on drop (v2) (#2200)
• Rust 1.50 fixes (#2199)
• Automated release Github upload fix (#2192)
• Update bootnode ENRs (#2191)
• Add a GitHub Action to cancel previous runs (#2180)
• Prevent adding duplicate validators to validator_definitions.yml (#2166)
• Update for clippy 1.50 (#2193)
• Remove links to old master branch (#2190)
• Update to tokio 1.1 (#2172)
• Check that pull requests target unstable (#2187)
• Avoid resizing attn signature sets vec (#2184)
• Ignore vulnerability in hyper (#2188)
• Avoid temp allocations with slog (#2183)
• Add metrics for beacon block propagation (#2173)
• fix a couple typos in comments in merkle_hasher (#2171)
• Fix simulator failed runs (#2181)
• Fix clippy errors on tests (#2160)

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

Dr. Wong

This minor release contains some important protection from excessive resource consumption in some uncommon cases (#2130). We recommend all users update both their BNs and VCs to this version.

The breaking changes in this release should be insignificant for most, see below for more information.

New Features

The most notable feature is the new "validator monitor" that allows a BN to provide additional logging and metrics for specific validators.

This provides the long-awaited "validator balance" metric and many, many others.

Additionally, you get additional logs about your validators activities (e.g. attestation inclusion in blocks).

See the validator monitor docs for more information.

Breaking Changes

Breaking changes are fairly minor in this release, but may have edge-case impacts for those running custom or non-Lighthouse validator clients.

• Disallow attestation production earlier than head (#2130)
  • Does not permit the creation of AttestationData via the API for slots earlier than the head. This is a fast patch to an immediate issue, in the future we plan to implement a more flexible solution with #2169.

All Changes

• Detailed validator monitoring (#2151)
• Fix bug from #2163 (#2165)
• Disallow attestation production earlier than head (#2130)
• Represent slots in secs instead of millisecs (#2163)
• Add lcli command to replace state pubkeys (#1999)
• Simplify enum -> str with strum (#2164)
• Modify proto array loop (#2154)
• Automate docker version tag (#2150)
• Update docs: Change --beacon-node to --beacon-nodes (#2145)
• Fix: end_slot returns incorrect value (#2138)
• Fix timing issue in obtaining the Fork (#2158)
• remove protected environment (#2135)
• Clippy 1.49.0 updates and dht persistence test fix (#2156)
• Fix race condition when creating LocalBeaconNode (#2137)
• Disconnect from peers quicker on internet issues (#2147)
• Use cross in linux x86 64 release flow (#2136)
• Add docs about redundancy (#2142)
• update smallvec (#2152)
• replace tempdir by tempfile (#2143)
• Reduce ping interval (#2132)
• Remove duplicate log in BN fallback (#2116)
• Ssz state api endpoint (#2111)
• test_decode_malicious_status_message improvements (#2104)
• Fix typo in ssz_snappy.rs comment (#2103)

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

Helium-Q

We strongly recommend all users running v1.0.4 or earlier to update to v1.0.6. However, users on v1.0.5 who are not experiencing issues can safely skip this update.

This release fixes two bugs in v1.0.5 which accidentally caused two breaking changes:

• The --beacon-node flag was no longer respected (#2121)
• The slasher database became invalid (#2125)

Although these bugs were not security risks, they caused significant user frustration during the holiday period. We apologize for any stress and inconvenience caused. Our testing suite is generally focused on catching high-severity logic bugs but we will work to expand it to prevent API breakages like this.

Summary

• Version v1.0.6 (#2126)
• Remove default beacon node value from clap (#2121)
• Fix slasher database schema migration to v2 (#2125)
• Tweak error messages for ease of investigation (#2122)

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

Baby Legs

We strongly recommend all users upgrade to v1.0.5 as it contains an important fix for subnet discovery (#2095) and dependency updates (#2084).

Feature: BN Redundancy

This release allows the VC to connect to multiple BNs. This means one can use lighthouse vc --beacon-nodes to direct a validator client at multiple BNs. Whenever a BN fails to respond, the VC will try again on the next BN.

Example

lighthouse vc --beacon-nodes http://localhost:5052,http://192.168.1.100:5052

If localhost goes down (perhaps during an update), the VC will attempt to use 192.168.1.100 instead.

Summary

• Version v1.0.5 (#2117)
• Tidy slasher logs for known slashings (#2108)
• Update libp2p (#2101)
• add automated release workflow (#2077)
• Eliminate uses of expect in ssz_snappy.rs (#2105)
• Add docs for /lighthouse/validators/keystore api (#2071)
• Optimise tree hash caching for block production (#2106)
• BN Fallback v2 (#2080)
• Subnet discovery fixes (#2095)
• Revert "add caching to test suite (#2089)" (#2098)
• Fix Syncing Simulator (#2049)
• Delete uncompressed genesis states (#2092)
• add caching to test suite (#2089)
• Add slasher broadcast (#2079)
• Improve eth1 fallback logging (#2096)
• impl Resource Unavailable RPC error (#2072)
• Update dependencies (#2084)
• Improve docker auto builds (#2078)

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

Tall Morty

We recommend all users upgrade to v1.0.4, particularly users who have previously experienced database corruption, or who are running a slasher. Please see below for details of breaking changes, including removal of the websocket server.

Breaking Changes

• Removed the legacy websocket server in favour of the standardised server-sent-events API (#1920).
• Disabled Medalla and other legacy testnet support by default, improving compilation time (#1989)

Summary

• Improved handling of I/O errors during block processing. We hope that this spells the end of corrupt databases and resyncs! (#2068)
• Fix a bug in the slasher that caused it to miss some blocks (#2047).
• Networking improvements that strengthen peering, and may improve attestation effectiveness (#2075, #2041).
• New --eth1-purge-cache flag that can be used to clean out the Eth1 cache without a resync. This should only be used if your node is unable to recover from an error like FailedToInsertDeposit(NonConsecutive {..}). The flag is supplied to the beacon node command like so: lighthouse bn --eth1-purge-cache (#2039).

All Changes

• Softer penalties for missing blocks (#2075)
• Multiarch docker GitHub actions (#2065)
• Revert fork choice if disk write fails (#2068)
• Improve compile time (#1989)
• Downgrades a valid log (#2057)
• fix default network handling (#2029)
• More metrics + RPC tweaks (#2041)
• update dependencies (#2032)
• Remove audit ignore ws server (#2051)
• Fix default values and --network flag in Voluntary exits book page (#2056)
• Pass failed gossip blocks to the slasher (#2047)
• Add a eth1-purge-cache cli option (#2039)
• Server sent events (#1920)
• Validators endpoint status code (#2040)
• Update blst to 0.3.2 (#2034)
• Fingerprint new client identify agent string (#2027)
• Pretty-print EIP-3076 tests (#1977)
• Normalize keystore passwords (#1972)
• Minor fixes (#2038)
• Fix new clippy lints (#2036)
• delete validator-dir path printing in subcommands (#2025)
• Add Content-Type to metrics server (#2019)
• Fix broken custom data directories link (#2000)

Docker Hub

NEW in this release: multi-arch Docker images. Thanks to amazing work by @realbigsean in #2065,
our Docker Hub images are now capable of running on x86_64 or ARM64! That includes
the Raspberry Pi 4 🎉

You can get the latest release via the :latest or :v1.0.4 tags:

• sigp/lighthouse:latest
• sigp/lighthouse:v1.0.4

The latest dev build is available via the :latest-unstable tag:

• sigp/lighthouse:latest-unstable

For the multi-arch build, please use :latest rather than :v1.0.4.

Binaries

See pre-built binaries documentation.

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

Ricktiminus Sancheziminius

We recommend all users to upgrade to v1.0.3, especially if they're experiencing timeouts with their eth1 endpoint.

Please note

Users may see a new log message:

Nov 30 21:04:28.268 WARN Syncing eth1 block cache   est_blocks_remaining: initializing deposits, msg: sync can take longer when using remote eth1 nodes, service: slot_notifier

This log indicates that your beacon node is downloading blocks and deposits from your eth1 node. When the est_blocks_remaining is initializing_deposits, your node is downloading deposit logs. It may stay in this stage for several minutes. Once the deposits logs are finished downloading, the est_blocks_remaining value will start decreasing.

It is perfectly normal to see this log when starting a node for the first time or after being off for more than several minutes.

If this log continues appearing sporadically during operation, there may be an issue with your eth1 endpoint.

Summary

• Increasing timeouts and decreases payload size for log request from eth1 nodes.
• Reduces the impact of timeouts when they do occur.
• Logs information about eth1 syncing whilst users are waiting for genesis.
• Adds the lighthouse bn --private flag which zeros-out graffiti and does not publish client information in the identify protocol.

All Changes

• Add privacy option (#2016)
• Improve eth1 block sync (#2008)
• No string in slog (#2017)
• Update PGP key in README (#1986)
• Drop discovery log to trace (#2007)

DockerHub

• sigp/lighthouse:v1.0.3

Binaries

See pre-built binaries documentation.

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

Juggling Rick

We recommend all users to upgrade to v1.0.2, especially if they're intending to stake with a genesis validator.

This release updates core dependencies in Lighthouse and is highly encouraged for all nodes to run for mainnet.

Summary

• Updates the core executor to a tokio 0.3 runtime and modifies the structure of the task executor
• Updates libp2p (security fixes, spec incompatibility updates)
• Updates BLST to the latest official version of BLST
• UPnP handling improvements

All Changes

• Upgrade to tokio 0.3 and related core sub-dependencies (#1839)
• Update BLST to the latest version (#1979)
• Fix type in docs (#1990)

DockerHub

• sigp/lighthouse:v1.0.2

Binaries

See pre-built binaries documentation.

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