consensus-specs
Ethereum Proof-of-Stake Consensus Specifications
File Explorer
- SKILL.md
- SKILL.md
- SKILL.md
- SKILL.md
- SKILL.md
- action.yml
- action.yml
- checks.yml
- comptests.yml
- labeler.yml
- release.yml
- stale.yml
- tests.yml
- website.yml
- labeler.yml
- pull_request_template.md
- release-drafter.yml
- mainnet.yaml
- minimal.yaml
- README.md
- trusted_setup_4096.json
- altair.yaml
- bellatrix.yaml
- capella.yaml
- deneb.yaml
- eip8148.yaml
- eip8321.yaml
- electra.yaml
- fulu.yaml
- gloas.yaml
- heze.yaml
- phase0.yaml
- trusted_setup_4096.json
- altair.yaml
- bellatrix.yaml
- capella.yaml
- deneb.yaml
- eip8148.yaml
- eip8321.yaml
- electra.yaml
- fulu.yaml
- gloas.yaml
- heze.yaml
- phase0.yaml
- README.md
- __init__.py
- altair.py
- base.py
- bellatrix.py
- capella.py
- deneb.py
- eip8025.py
- eip8148.py
- eip8321.py
- electra.py
- fulu.py
- gloas.py
- heze.py
- phase0.py
- __init__.py
- constants.py
- generate_specs.py
- helpers.py
- md_doc_paths.py
- md_to_spec.py
- typing.py
- check_fork_comments.py
- check_markdown_headings.py
- check_value_annotations.py
- combine_preset_coverage.py
- fix_note_style.py
- fix_trailing_whitespace.py
- gen_spec_indices.py
- strip_inline_tocs.py
- beacon-chain.md
- fork-choice.md
- beacon-chain.md
- fork-choice.md
- p2p-interface.md
- proof-engine.md
- prover.md
- beacon-chain.md
- fork.md
- p2p-interface.md
- validator.md
- beacon-chain.md
- fork.md
- p2p-interface.md
- validator.md
- full-node.md
- light-client.md
- p2p-interface.md
- sync-protocol.md
- beacon-chain.md
- bls.md
- fork-choice.md
- fork.md
- p2p-interface.md
- validator.md
- beacon-chain.md
- fast-confirmation.md
- fork-choice.md
- fork.md
- optimistic-sync.md
- p2p-interface.md
- validator.md
- fork.md
- full-node.md
- p2p-interface.md
- sync-protocol.md
- beacon-chain.md
- fork-choice.md
- fork.md
- p2p-interface.md
- validator.md
- fork.md
- full-node.md
- p2p-interface.md
- sync-protocol.md
- beacon-chain.md
- fork-choice.md
- fork.md
- p2p-interface.md
- validator.md
- fork.md
- p2p-interface.md
- sync-protocol.md
- beacon-chain.md
- fork.md
- p2p-interface.md
- validator.md
- weak-subjectivity.md
- p2p-interface.md
- beacon-chain.md
- das-core.md
- fork-choice.md
- fork.md
- p2p-interface.md
- validator.md
- fork.md
- full-node.md
- p2p-interface.md
- sync-protocol.md
- p2p-interface.md
- beacon-chain.md
- builder.md
- fast-confirmation.md
- fork-choice.md
- fork.md
- p2p-interface.md
- validator.md
- weak-subjectivity.md
- beacon-chain.md
- builder.md
- fork-choice.md
- fork.md
- inclusion-list.md
- optimistic-sync.md
- p2p-interface.md
- validator.md
- beacon-chain.md
- deposit-contract.md
- fast-confirmation.md
- fork-choice.md
- p2p-interface.md
- validator.md
- weak-subjectivity.md
- __init__.py
- decode.py
- encode.py
- random_value.py
- tools.py
- __init__.py
- test_process_sync_aggregate.py
- test_process_sync_aggregate_random.py
- __init__.py
- test_process_deposit.py
- __init__.py
- constants.py
- test_eth_aggregate_pubkeys.py
- test_eth_fast_aggregate_verify.py
- __init__.py
- test_process_inactivity_updates.py
- test_process_participation_flag_updates.py
- test_process_sync_committee_updates.py
- __init__.py
- test_altair_fork_basic.py
- test_altair_fork_random.py
- test_fork_active_validators.py
- __init__.py
- test_data_collection.py
- test_single_merkle_proof.py
- test_sync.py
- test_update_ranking.py
- __init__.py
- test_gossip_sync_committee_contribution_and_proof.py
- test_gossip_sync_committee_message.py
- __init__.py
- test_random.py
- __init__.py
- test_inactivity_scores.py
- __init__.py
- test_blocks.py
- __init__.py
- test_activations_and_exits.py
- test_leaking.py
- test_operations.py
- test_slashing.py
- test_transition.py
- __init__.py
- test_sync_protocol.py
- __init__.py
- test_networking.py
- __init__.py
- test_validator.py
- __init__.py
- test_config_invariants.py
- test_config_override.py
- __init__.py
- __init__.py
- test_process_deposit.py
- test_process_execution_payload.py
- test_process_voluntary_exit.py
- __init__.py
- test_bellatrix_fork_basic.py
- test_bellatrix_fork_random.py
- __init__.py
- test_on_merge_block.py
- __init__.py
- test_data_collection.py
- test_sync.py
- __init__.py
- test_gossip_beacon_block.py
- __init__.py
- test_random.py
- __init__.py
- test_blocks.py
- __init__.py
- test_optimistic.py
- __init__.py
- test_validator.py
- __init__.py
- test_execution_engine_interface.py
- test_is_valid_terminal_pow_block.py
- test_transition.py
- test_validate_merge_block.py
- __init__.py
- __init__.py
- test_process_bls_to_execution_change.py
- test_process_deposit.py
- test_process_execution_payload.py
- test_process_withdrawals.py
- __init__.py
- test_process_historical_summaries_update.py
- __init__.py
- test_capella_fork_basic.py
- test_capella_fork_random.py
- __init__.py
- test_data_collection.py
- test_single_merkle_proof.py
- test_sync.py
- __init__.py
- test_gossip_bls_to_execution_change.py
- __init__.py
- test_random.py
- __init__.py
- test_blocks.py
- __init__.py
- __init__.py
- test_process_execution_payload.py
- test_process_voluntary_exit.py
- __init__.py
- test_process_registry_updates.py
- __init__.py
- test_deneb_fork_basic.py
- test_deneb_fork_random.py
- __init__.py
- test_on_block.py
- __init__.py
- test_sync.py
- __init__.py
- test_single_merkle_proof.py
- __init__.py
- test_gossip_beacon_aggregate_and_proof.py
- test_gossip_beacon_attestation.py
- test_gossip_beacon_block.py
- test_gossip_blob_sidecar.py
- test_gossip_voluntary_exit.py
- __init__.py
- test_random.py
- __init__.py
- test_blocks.py
- __init__.py
- test_operations.py
- test_transition.py
- __init__.py
- test_validator.py
- __init__.py
- test_config_invariants.py
- test_execution_engine_interface.py
- __init__.py
- __init__.py
- __init__.py
- __init__.py
- test_p2p_size_bounds.py
- __init__.py
- __init__.py
- test_execution_requests.py
- __init__.py
- __init__.py
- test_process_randao.py
- test_process_randao_commitment_registration.py
- __init__.py
- test_process_pending_randao_commitments.py
- __init__.py
- test_eip8321_fork_basic.py
- __init__.py
- test_gossip_randao_commitment_registration.py
- __init__.py
- test_blocks.py
- __init__.py
- __init__.py
- test_process_attestation.py
- test_process_consolidation_request.py
- test_process_deposit_request.py
- test_process_voluntary_exit.py
- test_process_withdrawal_request.py
- test_process_withdrawals.py
- __init__.py
- test_apply_pending_deposit.py
- test_process_pending_deposits.py
- __init__.py
- test_process_effective_balance_updates.py
- test_process_pending_consolidations.py
- test_process_registry_updates.py
- __init__.py
- test_electra_fork_basic.py
- test_electra_fork_random.py
- __init__.py
- test_deposit_with_reorg.py
- __init__.py
- test_gossip_beacon_aggregate_and_proof.py
- test_gossip_beacon_attestation.py
- __init__.py
- test_random.py
- __init__.py
- test_blocks.py
- test_deposit_transition.py
- __init__.py
- test_slots.py
- __init__.py
- test_operations.py
- __init__.py
- test_config_invariants.py
- test_execution_engine_interface.py
- test_execution_requests.py
- __init__.py
- __init__.py
- test_process_proposer_lookahead.py
- __init__.py
- test_fulu_fork_basic.py
- test_fulu_fork_proposer_lookahead.py
- test_fulu_fork_random.py
- __init__.py
- test_on_block.py
- __init__.py
- test_sync.py
- __init__.py
- test_single_merkle_proof.py
- __init__.py
- test_compute_columns_for_custody_group.py
- test_get_custody_groups.py
- test_gossip_beacon_block.py
- test_gossip_data_column_sidecar.py
- test_gossip_partial_data_column_sidecar.py
- __init__.py
- test_random.py
- __init__.py
- test_blocks.py
- test_lookahead.py
- test_lookahead_slots.py
- __init__.py
- test_das.py
- __init__.py
- test_config_invariants.py
- test_custody.py
- test_networking.py
- test_security.py
- __init__.py
- test_compute_fork_digest.py
- __init__.py
- __init__.py
- test_process_attestation.py
- test_process_builder_deposit_request.py
- test_process_builder_exit_request.py
- test_process_deposit_request.py
- test_process_execution_payload_bid.py
- test_process_parent_execution_payload.py
- test_process_payload_attestation.py
- test_process_proposer_slashing.py
- test_process_voluntary_exit.py
- test_process_voluntary_exit_churn.py
- test_process_withdrawals.md
- test_process_withdrawals.py
- __init__.py
- test_process_builder_pending_payments.py
- test_process_pending_deposits.py
- test_process_pending_deposits_churn.py
- test_process_proposer_lookahead.py
- test_process_ptc_window.py
- __init__.py
- test_gloas_fork_basic.py
- test_gloas_fork_onboard_builders.py
- test_gloas_fork_proposer_lookahead.py
- test_gloas_fork_random.py
- __init__.py
- test_deposit_with_reorg.py
- test_get_head.py
- test_get_parent_payload_status.py
- test_on_attestation.py
- test_on_block.py
- test_on_execution_payload_envelope.py
- test_on_payload_attestation_message.py
- test_payload_data_availability.py
- test_payload_timeliness.py
- test_should_apply_proposer_boost.py
- __init__.py
- test_single_merkle_proof.py
- __init__.py
- test_gossip_beacon_aggregate_and_proof.py
- test_gossip_beacon_attestation.py
- test_gossip_beacon_block.py
- test_gossip_data_column_sidecar.py
- test_gossip_execution_payload_bid.py
- test_gossip_execution_payload_envelope.py
- test_gossip_payload_attestation_message.py
- test_gossip_proposer_preferences.py
- __init__.py
- test_gossip_partial_data_column_sidecar.py
- __init__.py
- test_random.py
- __init__.py
- test_blocks.py
- test_epoch_boundary.py
- test_slots.py
- __init__.py
- test_prepare_execution_payload.py
- test_validator.py
- __init__.py
- test_churn_limits.py
- test_config_invariants.py
- test_p2p_size_bounds.py
- __init__.py
- __init__.py
- fork.py
- __init__.py
- fork.py
- __init__.py
- fork.py
- __init__.py
- fork.py
- __init__.py
- fork.py
- randao.py
- __init__.py
- fork.py
- __init__.py
- fork.py
- state.py
- __init__.py
- bid.py
- fork.py
- proposer_preferences.py
- state.py
- __init__.py
- fork.py
- __init__.py
- attestations.py
- attester_slashings.py
- blob.py
- block.py
- block_header.py
- block_processing.py
- bls_to_execution_changes.py
- builder_deposit_requests.py
- builders.py
- churn.py
- consolidations.py
- constants.py
- das.py
- deposit_requests.py
- deposits.py
- epoch_processing.py
- execution_payload.py
- execution_payload_bid.py
- execution_requests.py
- fast_confirmation.py
- fork_choice.py
- fork_transition.py
- forks.py
- genesis.py
- gossip.py
- inactivity_scores.py
- inclusion_list.py
- keys.py
- light_client.py
- light_client_data_collection.py
- light_client_sync.py
- merkle.py
- multi_operations.py
- optimistic_sync.py
- p2p_size_bounds.py
- payload_attestation.py
- pow_block.py
- proposer_slashings.py
- random.py
- rewards.py
- shard_block.py
- specs.py
- state.py
- sync_committee.py
- typing.py
- voluntary_exits.py
- withdrawals.py
- __init__.py
- test_process_execution_payload_bid.py
- __init__.py
- test_heze_fork_basic.py
- __init__.py
- test_inclusion_list_store.py
- __init__.py
- test_validator.py
- __init__.py
- test_p2p_size_bounds.py
- __init__.py
- __init__.py
- test_process_attestation.py
- test_process_attester_slashing.py
- test_process_block_header.py
- test_process_deposit.py
- test_process_proposer_slashing.py
- test_process_voluntary_exit.py
- __init__.py
- test_process_effective_balance_updates.py
- test_process_eth1_data_reset.py
- test_process_historical_roots_update.py
- test_process_justification_and_finalization.py
- test_process_participation_record_updates.py
- test_process_randao_mixes_reset.py
- test_process_registry_updates.py
- test_process_rewards_and_penalties.py
- test_process_slashings.py
- test_process_slashings_reset.py
- __init__.py
- test_basic.py
- test_current_epoch.py
- test_empty_slots.py
- test_ffg.py
- test_is_one_confirmed.py
- test_previous_epoch.py
- test_reconfirmation.py
- test_restart_gu.py
- test_revert_finality.py
- test_variables.py
- __init__.py
- test_finality.py
- __init__.py
- test_ex_ante.py
- test_get_head.py
- test_get_proposer_head.py
- test_on_block.py
- test_reorg.py
- test_withholding.py
- __init__.py
- test_initialization.py
- test_validity.py
- __init__.py
- test_gossip_attester_slashing.py
- test_gossip_beacon_aggregate_and_proof.py
- test_gossip_beacon_attestation.py
- test_gossip_beacon_block.py
- test_gossip_proposer_slashing.py
- test_gossip_voluntary_exit.py
- __init__.py
- test_random.py
- __init__.py
- test_basic.py
- test_leak.py
- test_random.py
- __init__.py
- test_blocks.py
- test_slots.py
- __init__.py
- test_shuffling.py
- __init__.py
- test_ssz_static.py
- __init__.py
- test_on_attestation.py
- test_on_tick.py
- __init__.py
- test_integer_squareroot.py
- __init__.py
- test_validator_unittest.py
- __init__.py
- test_config_invariants.py
- __init__.py
- __init__.py
- yield_generator.py
- __init__.py
- block_randomized.py
- dumper.py
- manifest.py
- randomized_block_tests.py
- template_test.py
- utils.py
- yield_generator.py
- __init__.py
- conftest.py
- context.py
- exceptions.py
- __init__.py
- ssz_impl.py
- ssz_typing.py
- __init__.py
- bls.py
- hash_function.py
- kzg.py
- merkle_minimal.py
- test_merkle_minimal.py
- test_merkle_proof_util.py
- __init__.py
- py.typed
- README.md
- aggregate.md
- aggregate_verify.md
- eth_aggregate_pubkeys.md
- eth_fast_aggregate_verify.md
- fast_aggregate_verify.md
- README.md
- sign.md
- verify.md
- README.md
- README.md
- README.md
- README.md
- README.md
- initialization.md
- README.md
- validity.md
- data_collection.md
- README.md
- single_merkle_proof.md
- sync.md
- update_ranking.md
- README.md
- compute_columns_for_custody_group.md
- get_custody_groups.md
- gossip_validation.md
- README.md
- README.md
- README.md
- README.md
- blocks.md
- README.md
- slots.md
- README.md
- core.md
- README.md
- README.md
- README.md
- README.md
- __init__.py
- block_cover.py
- block_tree.py
- debug_helpers.py
- helpers.py
- mutation_operators.py
- scheduler.py
- test_case.py
- Block_cover.mzn
- Block_tree.mzn
- SM_links.mzn
- __init__.py
- conftest.py
- test_run.py
- block_cover.yaml
- block_tree_other.yaml
- block_tree_tree.yaml
- block_tree_tree_2.yaml
- test_gen.yaml
- block_cover.yaml
- block_tree_other.yaml
- block_tree_tree.yaml
- block_tree_tree_2.yaml
- test_gen.yaml
- block_cover.yaml
- block_tree_other.yaml
- block_tree_tree.yaml
- test_gen.yaml
- __init__.py
- conftest.py
- generate_comptests.py
- generate_test_instances.py
- README.md
- sample_attester_slashings.yaml
- sample_block_cover.yaml
- sample_block_tree.yaml
- sample_invalid_messages.yaml
- __init__.py
- gen_typing.py
- output.py
- pytest_support.py
- __init__.py
- __init__.py
- .gitignore
- AGENTS.md
- LICENSE
- Makefile
- pyproject.toml
- README.md
- renovate.json
- SECURITY.md
- uv.lock
- zensical.toml
# Installation Guide
pythonSetup Steps
git clone [email protected]:ethereum/consensus-specs.git
Clone the repository locally.
cd consensus-specs
Navigate to the project directory.
make help
View the list of available build and test commands.
Key Commands
make help
Print available Makefile targets and command list.
Refer to the official repository's Makefile and documentation for detailed dev and test setup.
# Use via CDN
jsDelivrjsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.
Link
Example
Command Glossary
Commands referenced in this DOCs, explained below.
git clone
View Details ▼
git clone
Clone an existing repository.
git clone {{remote_repository_location}} {{path/to/directory}}
Clone an existing repository into a new directory (the default directory is the repository name):
git clone --recursive {{remote_repository_location}}
Clone an existing repository and its submodules:
git clone {{[-n|--no-checkout]}} {{remote_repository_location}}
Clone only the `.git` directory of an existing repository:
# Project Badges
// repository documentation
Was this content helpful?
(0 ratings)