v5.0.0

[prestonvanloon]

v5.0.0

Behold the Prysm v5 release with official support for Deneb on Ethereum mainnet!

Deneb is scheduled for mainnet epoch 269568 on March 13, 2024 at 01:55:35pm UTC. All operators
MUST update their Prysm software to v5.0.0 or later before the upgrade in order to continue
following the blockchain.

This release brings improvements to the backfill functionality of the beacon node to support backfilling blobs. If running a beacon node with checkpoint sync, we encourage you to test the backfilling functionality and share your feedback. Run with backfill enabled using the flag --enable-experimental-backfill.

Known Issues

• --backfill-batch-size with a value of 1 or less breaks backfill. handle special case of batch size=1 #13646
• Validator client on v4.2.0 or older uses some API methods that are incompatible with beacon node
  v5. Ensure that you have updated the beacon node and validator client to v4.2.1 and then upgrade
  to v5 or update both processes at the same time to minimize downtime.

Added

API

• Support beacon_committee_selections Implement beacon committee selections #13503
• /eth/v1/beacon/deposit_snapshot Add /eth/v1/beacon/deposit_snapshot endpoint #13514

Docker

• Docker images now have coreutils pre-installed docker: Add coreutils to docker images #13564

Metrics

• da_waited_time_milliseconds tracks total time waiting for data availablity check in ReceiveBlock
  Add metric for data availability wait time #13534
• blob_written, blob_disk_count, blob_disk_bytes new metrics for tracking blobs on disk metrics for count and size of blob files #13614

Uncategorized

• Backfill supports blob backfilling Backfill Blobs #13595
• Add mainnet deneb fork epoch config add mainnet fork epoch #13601

Changed

Database

• --clear-db and --force-clear-db flags now remove blobs as well as beaconchain.db db: clear blobs when using --clear-db or --force-clear-db #13605

Flags

• EIP-4881 is now on by default. Makes Our New Deposit Trie The Default #13555

Fork Choice

• Updates filtering logic to match spec Fork choice filter changes #13464

Verbose signature verification is now on by default #13556

Metrics

• gossip_block_arrival_milliseconds and gossip_block_verification_milliseconds measure in
  milliseconds instead of nanoseconds Correct metrics from ns to ms #13540
• aggregate_attestations_t1 histogram buckets have been updated Update aggregate atts t1 bucket values #13607

p2p

• Reduce lookahead period from 8 to 4. This reduces block batch sizes during sync to account for
  larger blocks in deneb. Reduce Lookahead Steps Parameter #13599

Uncategorized

• Update gohashtree to v0.0.4-beta Update Gohashtree to v0.0.4-beta #13569
• Various logging improvements Revise blob sidecar not found log #13571 Enhance EL block height log #13582 Rename block by range request log #13561 Improve vc logs #13573 Suppress Unwanted P2P Errors #13598 Use Gwei for value in get header log #13608 Clean Up Deposit Processing Logs #13611 add BlockBatchLimit comment: Maximum 128 #13502 Remove leftover log #13627
• Improved operations during syncing Add Sync Checker #13580
• Backfill starts after initial-sync is complete Backfill start after init-sync at head #13623

Deprecated

Flag removal

The following flags have been removed entirely:

• --enable-reorg-late-blocks Remove deprecated late reorg flag #13536
• --disable-vectorized-htr Remove disable vectorized htr flag #13537
• --aggregate-parallel Remove deprecated aggregate parallel flag #13538
• --build-block-parallel Remove deprecated build block parallel flag #13539
• --enable-registration-cache, disable-gossip-batch-aggregation Remove deprecated flags: gossip batch registration and registration cache #13606
• --safe-slots-to-import-optimistically Remove safe slots to import flag #13624
• --show-deposit-data removing show deposit data flag #13618

Removed

API

• Prysm gRPC slasher endpoints are removed Slasher: Remove unused RPC. #13594
• Remove /eth/v1/debug/beacon/states/{state_id} Remove /eth/v1/debug/beacon/states/{state_id} #13619
• Prysm gRPC endpoints that were marked as deprecated in v4 have been removed Remove deprecated items #13600
• Remove /eth/v1/beacon/blocks/{block_id} Remove /eth/v1/beacon/blocks/{block_id} #13628

Fixed

API

• Return unaggregated if no aggregated attestations available in GetAggregateAttestation Fetch unaggregated atts in GetAggregateAttestation #13533
• Fix JWT auth checks in certain API endpoints used by the web UI fixing jwt auth checks for web ui #13565 handle slice out of range #13568
• Return consensus block value in wei units Return consensus block value in Wei #13575
• Minor fixes in protobuf files Fix a few minor nits in protobuf definitions #13512
• Fix 500 error when requesting blobs from a block without blobs Beacon API: get blob fix retention cases #13585
• Handle cases were EL client is syncing and unable to provide payloads Handle Syncing Executon Client #13597
• /eth/v1/beacon/blob_sidecars/{block_id} correctly returns an error when invalid indices are requested Blob API - invalid indicies should error instead of ignored #13616

Fork choice

• Fix head state fetch when proposing a failed reorg Get the right head state when proposing a failed reorg #13579
• Fix data race in background forkchoice update call Data Race on the background FCU call #13602

p2p

• Correctly return "unavailable" response to peers requesting batches before the node completes
  backfill. Validate Range Availibility #13587

Slasher

• Many significant improvements and fixes to the prysm slasher Beacon node slasher improvement #13549 Slasher: Refactor and add tests #13589 Slasher: Fixes double votes false positive and attester slashings duplication. #13596 Slasher: Fix surrounded votes false negative #13612 Slasher: Reduce cold start duration. #13620
• Fixed slashing gossip checks, improves peer scores for slasher peers Fix Slashing Gossip Checks #13574

Uncategorized

• Log warning if attempting to exit more than 5 validators at a time validator exiting ux improvement, add a log and update size for promptui #13542
• Do not cache inactive public keys Do Not Cache For Non Active Public Keys #13581
• Validator exits prints testnet URLs validator/exit: Print other testnet beaconcha.in URLs #13610 add tests for beaconcha baseURL #13308
• Fix pending block/blob zero peer edge case Fix pending block/blob zero peer edge case #13625
• Check non-zero blob data is written to disk db/blobs: Check non-zero data is written to disk #13647
• Avoid blob partial filepath collisions with mem addr entropy avoid part path collisions with mem addr entropy #13648

Security

v5.0.0 of Prysm is required to maintain participation in the network after the Deneb upgrade.

Full diff: v4.2.1...v5.0.0

---

This discussion was created from the release v5.0.0.

[adaszko]

Hi, I'm getting this compilation error when trying to use github.com/prysmaticlabs/prysm/v5/proto/prysm/v1alpha1 go package (it works for v4):

prysmgrpc/chainhead.go:24:44: undefined: ethpb.BeaconChain_StreamChainHeadClient
prysmgrpc/chainhead.go:27:22: conn.StreamChainHead undefined (type "github.com/prysmaticlabs/prysm/v5/proto/prysm/v1alpha1".BeaconChainClient has no field or method StreamChainHead)

Is there any upgrade guide?

[adaszko]

I got a response on Discord: you can use the events endpoint now on the beacon API https://ethereum.github.io/beacon-APIs/?urls.primaryName=dev#/Events/eventstream