v1.5.0-alpha.6 -- Mareep -- is the alpha release for the coming Electra upgrade.

PR showing full diff can be found here: #3920

Altair

• Simplify is_better_update condition #3816

Electra

• Update correlation penalty computation #3882
• Move requests out of execution_payload into beacon_block.body #3875
• Remove stale comment on latest_execution_payload_header #3929
• Remove unnecessary signing domain for consolidations #3915
• Minor fixes on Electra spec and test helper #3914
• Simplify name of helper get_validator_max_effective_balance #3909
• Harmonize process_withdrawals spec with 3761 #3905

EIP-7594 (PeerDAS)

• Use explicit csc integer size #3897
• Change csc types to back to uint64 #3908
• Delete g2_lincomb in poly-commits-sampling spec #3913

EIP-7732 (ePBS)

• Fix some typos #3902
• Modify ExecutionPayloadEnvelopeByRoot #3890
• Refactor beacon chain state transition function #3898
• Require the builder is active and non-slashed #3888

Testing, repo, etc

• Update python to 3.12.4 #3880
• Fix the install_pyspec_test CI check #3894
• Fix test vector generators to work with Python 3.12 #3927
• Add cronjob for test vector generation #3922
• Update README and dependencies #3879
• Randomize validator index in partial withdrawal test #3892
• Get rid of compute_state_by_epoch_processing_to #3878
• Ensure EL block hash is updated when beacon parent root is overridden #3881
• Fix yield statement in test_get_custody_columns #3931

v1.5.0-alpha.5 -- Pincurchin -- is the alpha release for the coming Electra upgrade.

This is the spec target for peerdas-devnet-2.

PR showing full diff can be found here: #3889

Bellatrix and Capella fork choice

• [non-substantive] Minor refactoring by removing redundant copy() #3877

Experimental

EIP-7594 (PeerDAS)

DAS Core

• Disable peer sampling & add minimal fork choice #3870 #3883
• [non-substantive] Remove matrix specific configuration value #3887

v1.5.0-alpha.4 -- Tynamo -- is the alpha release for the coming Electra upgrade.

This release includes an Electra bugfix (#3868).

PR showing full diff can be found here: #3853

SSZ

• Fix spec error in get_generalized_index function #3838

Safe block

• Rename get_safe_execution_payload_hash -> *_block_hash #3595

Capella

• [non-substantive] Make process_withdrawals slightly cleaner (equivalent functionality) #3761

Deneb

• [non-substantive] Make MAX_BLOBS_PER_BLOCK a config parameter #3817

Electra

• Fix off-by-one in process_pending_consolidations #3868

Light client

• Update light client specifications for Electra #3811

Experimental

EIP-7594 (PeerDAS)

DAS Core

• Clarify reconstruction and cross-seeding #3794
• Clarify PeerDAS sampling #3782
• Update get_data_column_sidecars to take cells/proofs #3836

Cryptography

• Remove proof parameter from recover_cells_and_kzg_proofs #3819
• Use "universal verification equation" in verify_cell_kzg_proof_batch #3812
• In batch cell verification, check if there are zero cells #3835
• In batch cell verification, take commitment for each cell #3834
• Remove verify_cell_kzg_proof (non-batch) #3830
• Rename column_index to cell_index in KZG spec by #3841
• Replace recover_data with recover_polynomialcoeff #3820
• Improve documentation in recovery code #3858

Networking

• Add MetadataV3 with custody_subnet_count #3821

[new] EIP-7732 (Enshrined Proposer-Builder Separation, ePBS)

• Core protocol update #3828 #3869

Testing, repo, etc

• Bump remerkleable to v0.1.28 #3807
• Add Electra merkle proof test vectors #3763
• Fix typing issue when 10e10 is interpreted as float #3810
• Update test_incorrect_not_enough_consolidation_churn_available and add assertions to test cases #3814
• Add more Electra fork tests #3764
• Proofread #3822 #3823 #3826 #3837 #3849 #3863 3873
• Fix EL block hash computation for Deneb #3829
• Fix indentation for some kzg_7594 tests #3855
• For pytest, replace NUMBER_OF_CORES with auto #3846
• Remove compute_cells test format #3860
• Update test formats #3860 #3848

v1.5.0-alpha.3 -- Twiga -- is the alpha release for the coming Electra upgrade.

It is the spec target of pectra-devnet-1.

PR showing full diff can be found here: #3786

Electra

• Add Electra version of AggregateAndProof #3759
• Properly calculate proposer probabilities #3769
• EL-triggered consolidations #3775
• Handle top-ups to exiting/exited validators #3776
• Rename DepositReceipt to DepositRequest #3757
• Rename objects with prefix ExecutionLayerXXX #3791
• Append new committee_bits field to end of Attestation #3768
• Switch the rest of the spec to MAX_EFFECTIVE_BALANCE_ELECTRA #3783

Experimental

EIP-7594 (PeerDAS)

DAS Core

• Add custody settings config #3766
• recover_cells_and_kzg_proofs & matrix refactor #3788
• Update ENR record #3772

Cryptography

• Add a missing check and a missing test vector for recover_all_cells #3765
• Fix shift_polynomialcoeff #3792
• Have a section listing Public Methods #3795
• Rename CellID to CellIndex #3797
• Remove compute_cells method #3796
• Refactor cell recovery code by #3781 #3806

Networking

• Provide max size for columns by range request #3760

[new] EIP-6800 (Verkle/Verge)

• The Verge CL Specs #3230

Testing, repo, etc

• Change duplicate cell id test to use 65 cell ids #3758
• Fix typo #3771 #3773 #3801 #3805
• Refactor #3774
• Fix scripts/build_run_docker_tests.sh #3790
• Adds CI to generate test vectors #3793
• Update compute_el_header_block_hash for EIP-7685 #3778
• Extend Tests for FFT and Coset FFT #3804

v1.5.0-alpha.2 -- Electivire -- is the alpha release for the coming Electra upgrade.

It is the spec target of pectra-devnet-0, with bug fixes on test cases.

It also includes some essential EIP-7594 fixes for initial interop.

PR showing full diff can be found here: #3749

Phase0

• [non-substantive] Fix typo on CommitteeIndex in p2p spec #3756

Electra

• [non-substantive] EIP-7549: Fix typo in get_committee_indices #3740

Experimental

EIP-7594 (PeerDAS)

DAS Core

• Fix get_custody_columns #3748

Cryptography

• Add type casts #3734

Networking

• Pad column indices when calling verify_cell_kzg_proof_batch #3745
• Add DataColumnSidecarsByRange v1 Req/Resp #3750

Testing, repo, etc

• Remove test_consolidation.py since they are not valid test vectors #3736
• Add decorator to all "invalid" test cases #3741
• Add .copy() where needed in tests #3743
• Fix rng of tests #3731
• Github Action runner overhaul #3751

v1.5.0-alpha.1 -- Electabuzz -- is the alpha release for the coming Electra upgrade.

It is the spec target of pectra-devnet-0, with bug fixes on test cases and new fork tests.

It also includes the new EIP-7549 (PeerDAS) tests with new test formats for general/eip7594/kzg and {mainnet, minimal}/eip7594/networking/get_custody_columns.

PR showing full diff can be found here: #3725

Electra

• [non-substantive] Refactor upgrade_to_electra() in https://github.com/ethereum/consensus-specs/pull/3711
• [non-substantive] Minor comment on ExecutionLayerWithdrawalRequest #3707

Experimental

EIP7594 (PeerDAS)

DAS Core

• Make get_custody_columns return sorted values and add get_custody_columns #3715
• Fix EIP7594_FORK_VERSION test #3730

Cryptography

Shout out to @kevaundray, @jtraglia, and @asn-d6!

• Rename CELLS_PER_BLOB to CELLS_PER_EXT_BLOB #3694
• Change g2_lincomb to take in G2Point #3692
• Fix and elaborates on comments #3695
• For compute_kzg_proof_multi remove remainder polynomial when in monomial form #3696
• Change recover_polynomial to recover_all_cells #3702
• Remove extra return value in construct_vanishing_polynomial #3704
• Add more description for the kzg verify algorithm by #3703
• Add a new config MAX_EXTENDED_MATRIX_SIZE #3708
• Add BLS_MODULUS to places where the result of a subtraction can be negative #3709
• Integrate new CosetEvals type by #3701
• Use CELLS_PER_EXT_BLOB to compute the number of columns #3710
• Make List Copy explicit in divide_polynomialcoeff #3706
• Add asserts for public functions #3684
• Use py-arkworks's multi-exp method inside of g1_lincomb and g2_lincomb #3714
• Replace "proofs" with "kzg_proofs" in function names #3727
• Fix bls.multi_exp when using py_ecc #3730

Testing, repo, etc

• Fix and move test_multiple_consolidations_* tests to sanity block tests #3724
• Fix consolidation test_invalid_*_signature tests #3728
• Add Electra fork tests #3720
• Add EIP-7594 to TESTGEN_FORKS #3721
• Add kzg_7594 test formats #3718
• Add initial version of kzg_7594 test generator #3693
• Rename formats/kzg to formats/kzg_4844 #3716
• Fix test_effective_balance_hysteresis_with_compounding_credentials test #3730
• Enable EIP7594 merkle proof testgen and use bls.use_fastest() in default testgen #3732

v1.5.0-alpha.0 -- Elekid -- is the alpha release for the coming Electra upgrade.

Thank you all for helping with this baby Electra release! 🐣

PR showing full diff can be found here: #3675

Phase 0

• [networking] Align seen_ttl with attestation lifetime #3627

Deneb

• [non-substantive] Clarify voluntary_exits gossip topic after Capella #3651

Electra

Miscs

• Update Electra config #3632
• Init Electra (EIP6110 + EIP7002) #3615
• Add EIP-7549 to Electra #3653
• Track blob gas when upgrading to Electra #3665
• Add EIP-7251 to Electra #3668
• EIP-7002/7251: clarify pending partial withdrawals handling #3679

EIP-6110

• Rename get_eth1_deposit_count function #3629

EIP-7002

• Bugfix when processing execution layer exit request #3660
• Some clean ups from merging EIP-7002 into Electra #3666

EIP-7251

• Increase MAX_EFFECTIVE_BALANCE #3618
• Fix bug in get_active_balance() #3637
• Rename PartialWithdrawal field #3643
• Use MIN_ACTIVATION_BALANCE instead of MAX_EFFECTIVE_BALANCE #3647
• Remove extra queue_excess_active_balance call #3654
• Fix EIP-7251 tests #3656
• Rename get_churn_limit() for clarity #3676
• Enforce Activation Rate Limit at Fork Transition #3659
• Fix off-by-one in churn computations #3682

EIP-7549

• Move committee index outside Attestation #3559
• Clarify network vs on chain aggregation #3628
• Flatten aggregate_bits #3631
• Enable EIP-7549 on CI by #3640
• Misc changes #3636 #3657
• Fix has_sufficient_effective_balanc computation #3658
• Clarify electra validator spec with EIP7549 #3669
• Add AttesterSlashing to modified containers #3674

Experimental

EIP7594 (PeerDAS)

• Check for degree overflow in multiply_polynomialcoeff() #3619
• Add PeerDAS protocol #3574
• Use FIELD_ELEMENTS_PER_EXT_BLOB in NUMBER_OF_COLUMNS #3662

Testing, repo, etc

• Update single_merkle_proof.md test format docs #3635
• Remove wip messages on shipped forks #3646
• Typo fixes #3645
• Add EIP7549 aggregation logic in testing tool #3649 #3680
• Add EIP-7549 tests and Electra random tests #3670
• Remove duplicate deposit processing tests #3678
• Fix electra tests and enable testgen #3681
• Fix broken exit tests due to change in the churn computation by #3690
• Fix tests by #3691

v1.4.0 -- Delivery at Dawn -- is the mainnet release for the Deneb upgrade that went live on March 13, 2024.

PR showing full diff can be found here: #3621

Phase0

• [non-substantive] Refactor with new constant UINT64_MAX_SQRT: #3608

Testing, repo, etc

• Remove the wrong test case: #3607
• Typo fixes: #3596, #3620

v1.4.0-beta.7 -- Denebian Whale -- is a beta release for the coming Deneb upgrade.

This release sets the mainnet Deneb fork epoch (DENEB_FORK_EPOCH) value.

Note that to be cautious, we still use the beta pre-release to avoid any last-minute updates. We will bump to v1.4.0 right after the mainnet fork is activated.

PR showing full diff can be found here: #3598

Phase 0

Beacon chain

• Handle integer_squareroot bound case #3600

Deneb

• Schedule Deneb for Mainnet #3597

EIP-7594 (PeerDAS)

• [Cryptography] Optimization: reduce len() calls in add_polynomialcoeff helper #3581
• [Cryptography] Public methods must accept raw bytes #3579
• [Cryptography] Initial refactor of recover_polynomial() #3591

Testing, repo, etc

• Add py.typed file for mypy #3588 #3594
• Add EIP-7514 higher-churn-limit-to-lower tests #3602

v1.4.0-beta.6 Release note

v1.4.0-beta.6 -- Psychrolutes marcidus -- is a beta release for upcoming Deneb devnets.

This release adds new field g1_monomial to the trusted setup file. It can be found at the upstream. The latest sha256
checksum: f8e44a31ebf0a6d0734dcb301b0716e2c77f3ae18ed0cab0870fbcc2ca55616f

PR showing full diff can be found here: #3578

Phase 0

Fork choice

• Confirmation rule prerequisite - fork choice filter change #3431

Networking

• Align gossip validation for aggregates with single attestations #3552
• Use fork choice to determine finalized_checkpoint in gossip validation #3543

Light client

• Refactoring #3569, #3571
• Rename _INDEX generalized index constants to _GINDEX #3537, #3563
• Gossip additional LightClientFinalityUpdate on new supermajority #3549
• Use types for representing LC Merkle branches #3563

SSZ

• byte type and canonical JSON mapping #3506

Whisk

• Add WHISK fork only tests #3442

EIP-7594 (WIP - still in its early stages)

• EIP-7594: Add cryptography specs for sampling #3557, #3583

Testing, repo, etc

• Pyspec refactoring #3562, #3567
• Pyspec dockerization #3477, #3573
• Consider fork transitions when using get_sync_aggregate #3572
• Add guard when fill_prev_epoch is True in epoch 0 by #3570
• Add transition test case of non-empty pre-state historical_roots #3585

v1.4.0-beta.5 -- Serve It Up -- is a beta release for upcoming Deneb devnets.

#3551 clarifies when a client can be unblocked on serving beacon blocks and blob side cars. Although this will help clients conform to a more optimal behaviour, it is not a breaking change (v1.4.0-beta.4 can be transparently swapped and interop with v1.4.0-beta.5).

_PR showing full diff can be found here: #3554

Phase 0

• Clarify when clients can serve blocks in byRoot RPC methods #3551

Deneb

• Clarify when clients can serve blocks and sidecars in byRoot RPC methods #3551
• [non-substantive] Remove unused DOMAIN_BLOB_SIDECAR #3542
• [non-substantive] Remove SignedBlobSidecar refs from p2p spec #3541
• [non-substantive] Move blob_sidecar_{subnet_id} to "Blob subnets" section #3556

Testing, repo, etc

• Fix FC tests by removing extra tick #3548
• Ensure on_tick precondition time >= store.time in fork-choice tests #3550
• Add randomized block blob_kzg_commitment_merkle_proof cases #3555

v1.4.0-beta.4 -- Prove It -- is a beta release for upcoming Deneb devnets. Note, this contains a substantial breaking change to how Blobs are sent around on the p2p (#3531, #3540) and is expected to delay the next devnet(s) by a few weeks as clients incorporate (largely simplifying!) changes.

Shout-out to @terencechain and @potuz for re-opening the conversation about how Blobs are sent around on the p2p and massive shout-out 🙏 to @fradamt for suggesting the utilization of BeaconBlockHeaders and merkle proofs to allay the ongoing concerns.

_PR showing full diff can be found here: #3536

Phase 0

• Allow honest validators to reorg late blocks #3034

Deneb

• Reject blobs which reference already finalized parent blocks #3529
• Add blob sidecar inclusion proof and other relevant p2p changes #3531 #3540
• Suggest sidecars by root callers verify blob sidecars #3535
• [non-substantive Clarify not to invalidate valid and available (wrt blobs) blocks #3526
• [non-substantive] Update block production description in validator doc to more precisely reflect the latest flow #3533
• [non-substantive] Remove BLOB_TX_TYPE from spec (and move to tests) #3534

v1.4.0-beta.3 -- The Summoning -- is a beta release for the upcoming Deneb devnet-10 and potentially beyond.

Shout-out to @tbenr for identifying a critical blob gossip condition late in the game! 🙌

PR showing full diff can be found here: #3523

Deneb

EIP-4844

• Change minimal preset FIELD_ELEMENTS_PER_BLOB to 4096 and use the mainnet KZG ceremony trusted setup output #3521
• Add new gossip rule to REJECT sidecars with index >= MAX_BLOBS_PER_BLOCK #3525

Experimental R&D

Whisk

• Use add_validator_to_registry in whisk #3486

Testing, repo, etc

• Fix Deneb fork choice baseline test case #3508
• Add KZG G1_POINT_AT_INFINITY test cases #3507 #3513
• Fix typo #3509 #3522

v1.4.0-beta.2 -- -- is a beta release for the upcoming Deneb devnet-9 and potentially beyond. It introduces EIP-7514, which applies the maximum activation churn limit. Additionally, it adds a fork-choice rule proposer boost adjustment.

Special thanks to @wenceslas-sanchez for making contributions via the EPF program.

PR showing full diff can be found here: #3504

Phase0

• [Fork choice] Apply proposer boost to the first block in case of equivocation #3352

Deneb

EIP-7514

• Add EIP-7514: Add Max Epoch Churn Limit #3499

Experimental R&D

Whisk

• Move non-preset values to config #3482 #3485
• Do not mutate candidates during cooldown #3483
• Pin curdleproofs package dependency to v0.1.1 #3495

Testing, repo, etc

• [New test vectors] Add Deneb fork choice tests #3463
• [Test vectors paths update] Rename BLS/KZG suite name #3484
• Fix redundant SSZ generic tests #3468
• Fix test generator multiprocessing mode bug #3473
• Fix verify_blob_kzg_proof_batch test format description #3471
• Remove old warnings for in-development specs #3494
• Typo fixes: #3476 #3503
• Fix link to libp2p Yamux specification #3493

v1.4.0-beta.1 -- Sagittarius A*'s Superhot Bizarre Gaseous Globule -- is a beta release for the upcoming Deneb devnet-8 and potentially beyond. Deneb is stable other than the "data gas" -> "blob gas" renaming (#3461).

Additionally, a number of additional Deneb tests have been added (#3459, #3457, #3464), some small iterations made in R&D EIPs, and a handful of build/CI refactors.

PR showing full diff can be found here: #3465

Deneb

• EIP-4844
  • Add test cases to execution payload processing #3459
  • More deneb 4844 tests #3457
  • Rename "data gas" to "blob gas" #3461
• EIP-7045
  • Fix and reward fork transition test #3464

Experimental R&D

• EIP-7002: Execution layer triggerable exits #3349
• WHISK: Fix some nits in whisk spec #3452
• EIP-6914: Update the equivocating indices in the fork-choice store #3446

Testing, repo, etc

• Auto manage SpecBuilder prev fork inheritance #3436
• Refactor setup.py #3393
• Upgrade wheel, pip, and setuptools with make install_test #3443
• Add --fork-list arg to testgen #3456

v1.4.0-beta.0 -- Consensus Specs: Tim's Vision -- is the first beta release for the upcoming Deneb upgrade. The move from alpha to beta signifies that Deneb is considered to be feature complete and not intended to change substantively from here. That said, there may still be minor patches, configuration changes, bug fixes, and (unlikely, but possible) feature removals.

EIP 4788, 7044, and 7045 are added to the Deneb build in this release. It is expected that devnets will shift to being fully featured (rather than just 4844) in the coming weeks.

PR showing full diff can be found here: #3437

Phase 0

• [non-substantive] Add add_validator_to_registry function to modularize for future upgrades #3311

Deneb

• EIP-7044: Lock voluntary exit domain on capella #3288
• EIP-7045: Increase max attestation inclusion slot #3360
• EIP-4788: Expose parent beacon block root in EL #3421

Experimental R&D

Whisk

• Iterative progress on feature build #3426, #3428, #3407, #3425, #3427, #3424

Testing, repo, etc

• Lock doctoc version #3429
• Remove manual workflow branch input #3439

v1.4.0-alpha.3 -- Magpie Bridge -- is an alpha release for the coming Deneb upgrade.

PR showing full diff can be found here: #3418

It increases BLOB_SIDECAR_SUBNET_COUNT to 6 for the incoming™️ Dencun devnet.

Deneb

• Update BLOB_SIDECAR_SUBNET_COUNT to 6 in line with max blobs limit update and add it to config #3416

Testing, repo, etc

• Rework the markdown files path loader logic #3412
• Update pyspec dependency #3414 #3415

v1.4.0-alpha.2 -- Trumpeter Swan -- is an alpha release for the coming Deneb upgrade.

PR showing full diff can be found here: #3411

It increases MAX_BLOBS_PER_BLOCK to 6 for the next Dencun devnet.

Deneb

• Update MAX_BLOBS_PER_BLOCK to 6 and add Deneb networking configs to yaml files #3410
• [non-substantive] Remove assert from is_data_available #3404
• [non-substantive] De-duplicate range references in BlobSidecarsByRange #3162
• [non-substantive] specially mark EIP4844 changes #3406

Experimental

Whisk

• Add Whisk (SSLE) feature spec #3342 #3408

Testing, repo, etc

• Ensure make lint resolves to the right pylint and mypy versions #3409
• Clean up and simplify networking configs GOSSIP_MAX_SIZE and MAX_CHUNK_SIZE setting #3394

v1.4.0-alpha.1 -- A bit of gas -- is the an alpha release for the coming Deneb upgrade.

PR showing full diff can be found here: #3396

It includes some ExecutionPayload field updates.

Deneb

• Add data_gas_used field to ExecutionPayload #3391
• Change excess_data_gas and data_gas_used type from uint256 to uint64
• [non-substantive] Remove extraneous length check from deneb forkchoice #3368

Testing, repo, etc

• Turn off light client tests for feature specs #3389 #3398

v1.4.0-alpha.0 -- Big Commitments -- is the an alpha release for the coming Deneb upgrade.

This includes a handful of breaking changes in preparation for the next wave of testnets. Thank you for the many contributors on this front.

The attnets revamp (#3312) has been released in a backwards compatible fashion (no peer downscoring yet). Thanks @AgeManning for carrying this over the finish line!

PR showing full diff can be found here: #3380

Phase 0

• Attnet revamp: Subnet backbone structure based on beacon nodes #3312
• [non-substantive] Add networking configuration to config files #3375

Bellatrix

• [non-substantive] Change process_execution_payload function signature and Execution Engine API wrapper due to #3359.
  • Note that the test format has been changed accordingly.

Capella

• [non-substantive] Remove is_merge_transition_block check since Capella #3232
• [non-substantive] Remove is_execution_enabled condition since Capella #3350

Deneb

• Update the endianness of the polynomial commitments to be big endian #3354
• Use engine_newPayloadV3 to pass versioned_hashes to EL for validation #3359
• Update block's blob_kzg_commitments size limit to MAX_BLOB_COMMITMENTS_PER_BLOCK #3338, #3384
• Add GetPayloadResponse dataclass for get_payload API #3341
• Explicitly specify the number of sidecar subnets #3346 #3373
• Add group of invalid G1 points in KZG tests #3344
• Deneb refactoring and new tests #3340

Experimental

EIP6914

• EIP6914 - Reuse indexes with full sweep #3307

EIP4788

• Add EIP-4788 feature #3319

Testing, repo, etc

• Multiprocessing testgen runner #3347, #3383, #3386
• Fix CircleCI Python version #3372
• Enable EIP-6110 in pytest #3309
• Fix process_inactivity_updates test cases #3348
• Minor typos, formatting, grammar, etc #3369 #3328 #3334 #3337 #3308 #3382
• Fix docs site deployment #3387