eth2.0-specs/configs/mainnet.yaml

# Mainnet config

# Extends the mainnet preset
PRESET_BASE: 'mainnet'

# Free-form short name of the network that this configuration applies to - known
# canonical network names include:
# * 'mainnet' - there can be only one
# * 'prater' - testnet
# Must match the regex: [a-z0-9\-]
CONFIG_NAME: 'mainnet'

# Transition
# ---------------------------------------------------------------
# Estimated on Sept 15, 2022
TERMINAL_TOTAL_DIFFICULTY: 58750000000000000000000
# By default, don't use these params
TERMINAL_BLOCK_HASH: 0x0000000000000000000000000000000000000000000000000000000000000000
TERMINAL_BLOCK_HASH_ACTIVATION_EPOCH: 18446744073709551615


# Genesis
# ---------------------------------------------------------------
# `2**14` (= 16,384)
MIN_GENESIS_ACTIVE_VALIDATOR_COUNT: 16384
# Dec 1, 2020, 12pm UTC
MIN_GENESIS_TIME: 1606824000
# Mainnet initial fork version, recommend altering for testnets
GENESIS_FORK_VERSION: 0x00000000
# 604800 seconds (7 days)
GENESIS_DELAY: 604800


# Forking
# ---------------------------------------------------------------
# Some forks are disabled for now:
#  - These may be re-assigned to another fork-version later
#  - Temporarily set to max uint64 value: 2**64 - 1

# Altair
ALTAIR_FORK_VERSION: 0x01000000
ALTAIR_FORK_EPOCH: 74240  # Oct 27, 2021, 10:56:23am UTC
# Bellatrix
BELLATRIX_FORK_VERSION: 0x02000000
BELLATRIX_FORK_EPOCH: 144896  # Sept 6, 2022, 11:34:47am UTC
# Capella
CAPELLA_FORK_VERSION: 0x03000000
CAPELLA_FORK_EPOCH: 194048  # April 12, 2023, 10:27:35pm UTC
# Deneb
DENEB_FORK_VERSION: 0x04000000
DENEB_FORK_EPOCH: 269568  # March 13, 2024, 01:55:35pm UTC
# Electra
ELECTRA_FORK_VERSION: 0x05000000
ELECTRA_FORK_EPOCH: 18446744073709551615  # temporary stub
# EIP7594
EIP7594_FORK_VERSION: 0x06000000  # temporary stub
EIP7594_FORK_EPOCH: 18446744073709551615
# WHISK
WHISK_FORK_VERSION: 0x08000000  # temporary stub
WHISK_FORK_EPOCH: 18446744073709551615

# Time parameters
# ---------------------------------------------------------------
# 12 seconds
SECONDS_PER_SLOT: 12
# 14 (estimate from Eth1 mainnet)
SECONDS_PER_ETH1_BLOCK: 14
# 2**8 (= 256) epochs ~27 hours
MIN_VALIDATOR_WITHDRAWABILITY_DELAY: 256
# 2**8 (= 256) epochs ~27 hours
SHARD_COMMITTEE_PERIOD: 256
# 2**11 (= 2,048) Eth1 blocks ~8 hours
ETH1_FOLLOW_DISTANCE: 2048


# Validator cycle
# ---------------------------------------------------------------
# 2**2 (= 4)
INACTIVITY_SCORE_BIAS: 4
# 2**4 (= 16)
INACTIVITY_SCORE_RECOVERY_RATE: 16
# 2**4 * 10**9 (= 16,000,000,000) Gwei
EJECTION_BALANCE: 16000000000
# 2**2 (= 4)
MIN_PER_EPOCH_CHURN_LIMIT: 4
# 2**16 (= 65,536)
CHURN_LIMIT_QUOTIENT: 65536
# [New in Deneb:EIP7514] 2**3 (= 8)
MAX_PER_EPOCH_ACTIVATION_CHURN_LIMIT: 8

# Fork choice
# ---------------------------------------------------------------
# 40%
PROPOSER_SCORE_BOOST: 40
# 20%
REORG_HEAD_WEIGHT_THRESHOLD: 20
# 160%
REORG_PARENT_WEIGHT_THRESHOLD: 160
# `2` epochs
REORG_MAX_EPOCHS_SINCE_FINALIZATION: 2


# Deposit contract
# ---------------------------------------------------------------
# Ethereum PoW Mainnet
DEPOSIT_CHAIN_ID: 1
DEPOSIT_NETWORK_ID: 1
DEPOSIT_CONTRACT_ADDRESS: 0x00000000219ab540356cBB839Cbe05303d7705Fa


# Networking
# ---------------------------------------------------------------
# `10 * 2**20` (= 10485760, 10 MiB)
GOSSIP_MAX_SIZE: 10485760
# `2**10` (= 1024)
MAX_REQUEST_BLOCKS: 1024
# `2**8` (= 256)
EPOCHS_PER_SUBNET_SUBSCRIPTION: 256
# `MIN_VALIDATOR_WITHDRAWABILITY_DELAY + CHURN_LIMIT_QUOTIENT // 2` (= 33024, ~5 months)
MIN_EPOCHS_FOR_BLOCK_REQUESTS: 33024
# `10 * 2**20` (=10485760, 10 MiB)
MAX_CHUNK_SIZE: 10485760
# 5s
TTFB_TIMEOUT: 5
# 10s
RESP_TIMEOUT: 10
ATTESTATION_PROPAGATION_SLOT_RANGE: 32
# 500ms
MAXIMUM_GOSSIP_CLOCK_DISPARITY: 500
MESSAGE_DOMAIN_INVALID_SNAPPY: 0x00000000
MESSAGE_DOMAIN_VALID_SNAPPY: 0x01000000
# 2 subnets per node
SUBNETS_PER_NODE: 2
# 2**8 (= 64)
ATTESTATION_SUBNET_COUNT: 64
ATTESTATION_SUBNET_EXTRA_BITS: 0
# ceillog2(ATTESTATION_SUBNET_COUNT) + ATTESTATION_SUBNET_EXTRA_BITS
ATTESTATION_SUBNET_PREFIX_BITS: 6

# Deneb
# `2**7` (=128)
MAX_REQUEST_BLOCKS_DENEB: 128
# MAX_REQUEST_BLOCKS_DENEB * MAX_BLOBS_PER_BLOCK
MAX_REQUEST_BLOB_SIDECARS: 768
# `2**12` (= 4096 epochs, ~18 days)
MIN_EPOCHS_FOR_BLOB_SIDECARS_REQUESTS: 4096
# `6`
BLOB_SIDECAR_SUBNET_COUNT: 6

# Whisk
# `Epoch(2**8)`
WHISK_EPOCHS_PER_SHUFFLING_PHASE: 256
# `Epoch(2)`
WHISK_PROPOSER_SELECTION_GAP: 2

# EIP7594
NUMBER_OF_COLUMNS: 128
MAX_CELLS_IN_EXTENDED_MATRIX: 768
DATA_COLUMN_SIDECAR_SUBNET_COUNT: 32
MAX_REQUEST_DATA_COLUMN_SIDECARS: 16384
SAMPLES_PER_SLOT: 8
CUSTODY_REQUIREMENT: 1
TARGET_NUMBER_OF_PEERS: 70

# [New in Electra:EIP7251]
MIN_PER_EPOCH_CHURN_LIMIT_ELECTRA: 128000000000 # 2**7 * 10**9 (= 128,000,000,000)
MAX_PER_EPOCH_ACTIVATION_EXIT_CHURN_LIMIT: 256000000000 # 2**8 * 10**9 (= 256,000,000,000)
update with configs<>presets separation 2021-05-06 17:49:33 +00:00			`# Mainnet config`

			`# Extends the mainnet preset`
			`PRESET_BASE: 'mainnet'`

Add `CONFIG_NAME` to configs Runtime configurations apply to a certain network and the name of that network is useful for humans such that they can talk about it. Some of the existing configs already include a `CONFIG_NAME` toggle - might as well add it here as well and avoid some confusion - this name above all becomes useful in the beacon API. By extension, the `CONFIG_NAME` config will appear in the beacon api as a result of being defined here. 2021-12-29 11:40:16 +00:00			`# Free-form short name of the network that this configuration applies to - known`
			`# canonical network names include:`
			`# * 'mainnet' - there can be only one`
			`# * 'prater' - testnet`
			`# Must match the regex: [a-z0-9\-]`
			`CONFIG_NAME: 'mainnet'`

Add TBD for TTD and add the value to the configs 2021-09-18 06:39:54 +00:00			`# Transition`
			`# ---------------------------------------------------------------`
Merge mainnet ttd and bellatrix values (#2969) * merge mainnet ttd and bellatrix values * Update configs/minimal.yaml Co-authored-by: Paul Harris <paul.harris@consensys.net> Co-authored-by: Paul Harris <paul.harris@consensys.net> 2022-08-15 14:00:14 +00:00			`# Estimated on Sept 15, 2022`
			`TERMINAL_TOTAL_DIFFICULTY: 58750000000000000000000`
ad TBH_ACTIVATION_EPOCH 2021-10-18 19:38:08 +00:00			`# By default, don't use these params`
Add TERMINAL_BLOCK_HASH override 2021-09-22 18:18:41 +00:00			`TERMINAL_BLOCK_HASH: 0x0000000000000000000000000000000000000000000000000000000000000000`
Fix setup.py parser and rename `TBH_ACTIVATION_EPOCH` -> `TERMINAL_BLOCK_HASH_ACTIVATION_EPOCH` 2021-10-19 03:25:50 +00:00			`TERMINAL_BLOCK_HASH_ACTIVATION_EPOCH: 18446744073709551615`
ad TBH_ACTIVATION_EPOCH 2021-10-18 19:38:08 +00:00
Add TBD for TTD and add the value to the configs 2021-09-18 06:39:54 +00:00
Add back newlines in configs 2021-09-23 23:51:20 +00:00
update with configs<>presets separation 2021-05-06 17:49:33 +00:00			`# Genesis`
			`# ---------------------------------------------------------------`
			# `2**14` (= 16,384)
			`MIN_GENESIS_ACTIVE_VALIDATOR_COUNT: 16384`
			`# Dec 1, 2020, 12pm UTC`
			`MIN_GENESIS_TIME: 1606824000`
			`# Mainnet initial fork version, recommend altering for testnets`
			`GENESIS_FORK_VERSION: 0x00000000`
			`# 604800 seconds (7 days)`
			`GENESIS_DELAY: 604800`


			`# Forking`
			`# ---------------------------------------------------------------`
			`# Some forks are disabled for now:`
clarify config/preset separation, address review comments by @djrtwo 2021-05-19 15:15:34 +00:00			`# - These may be re-assigned to another fork-version later`
			`# - Temporarily set to max uint64 value: 2**64 - 1`
update with configs<>presets separation 2021-05-06 17:49:33 +00:00
			`# Altair`
			`ALTAIR_FORK_VERSION: 0x01000000`
Update configs/mainnet.yaml Co-authored-by: terence tsao <terence@prysmaticlabs.com> 2021-09-24 18:28:46 +00:00			`ALTAIR_FORK_EPOCH: 74240 # Oct 27, 2021, 10:56:23am UTC`
Merge -> Bellatrix 2021-12-22 07:46:18 +00:00			`# Bellatrix`
			`BELLATRIX_FORK_VERSION: 0x02000000`
Merge mainnet ttd and bellatrix values (#2969) * merge mainnet ttd and bellatrix values * Update configs/minimal.yaml Co-authored-by: Paul Harris <paul.harris@consensys.net> Co-authored-by: Paul Harris <paul.harris@consensys.net> 2022-08-15 14:00:14 +00:00			`BELLATRIX_FORK_EPOCH: 144896 # Sept 6, 2022, 11:34:47am UTC`
add capella to circleci build 2021-12-01 18:40:54 +00:00			`# Capella`
			`CAPELLA_FORK_VERSION: 0x03000000`
computed epoch, rather than slot number 2023-03-17 00:20:58 +00:00			`CAPELLA_FORK_EPOCH: 194048 # April 12, 2023, 10:27:35pm UTC`
Replaced EIP4844 references with Deneb Fixes #3207 2023-01-23 14:08:34 +00:00			`# Deneb`
			`DENEB_FORK_VERSION: 0x04000000`
Schedule Deneb for Mainnet As discussed in https://github.com/ethereum/pm/issues/951, schedule Deneb for epoch 269568. 2024-02-08 14:32:28 +00:00			`DENEB_FORK_EPOCH: 269568 # March 13, 2024, 01:55:35pm UTC`
add electra configs 2024-03-25 11:15:53 +00:00			`# Electra`
Merge EIP-7549 into Electra 2024-04-05 17:02:03 +00:00			`ELECTRA_FORK_VERSION: 0x05000000`
Misc fix 2024-04-27 04:11:29 +00:00			`ELECTRA_FORK_EPOCH: 18446744073709551615 # temporary stub`
			`# EIP7594`
			`EIP7594_FORK_VERSION: 0x06000000 # temporary stub`
			`EIP7594_FORK_EPOCH: 18446744073709551615`
Add initialize_beacon_state_from_eth1 (#3428) 2023-06-14 15:55:07 +00:00			`# WHISK`
add electra configs 2024-03-25 11:15:53 +00:00			`WHISK_FORK_VERSION: 0x08000000 # temporary stub`
Add initialize_beacon_state_from_eth1 (#3428) 2023-06-14 15:55:07 +00:00			`WHISK_FORK_EPOCH: 18446744073709551615`
add capella to circleci build 2021-12-01 18:40:54 +00:00
update with configs<>presets separation 2021-05-06 17:49:33 +00:00			`# Time parameters`
			`# ---------------------------------------------------------------`
			`# 12 seconds`
			`SECONDS_PER_SLOT: 12`
			`# 14 (estimate from Eth1 mainnet)`
			`SECONDS_PER_ETH1_BLOCK: 14`
			`# 2**8 (= 256) epochs ~27 hours`
			`MIN_VALIDATOR_WITHDRAWABILITY_DELAY: 256`
			`# 2**8 (= 256) epochs ~27 hours`
			`SHARD_COMMITTEE_PERIOD: 256`
			`# 2**11 (= 2,048) Eth1 blocks ~8 hours`
			`ETH1_FOLLOW_DISTANCE: 2048`


clarify config/preset separation, address review comments by @djrtwo 2021-05-19 15:15:34 +00:00			`# Validator cycle`
update with configs<>presets separation 2021-05-06 17:49:33 +00:00			`# ---------------------------------------------------------------`
			`# 2**2 (= 4)`
			`INACTIVITY_SCORE_BIAS: 4`
			`# 2**4 (= 16)`
			`INACTIVITY_SCORE_RECOVERY_RATE: 16`
clarify config/preset separation, address review comments by @djrtwo 2021-05-19 15:15:34 +00:00			`# 2*4 10**9 (= 16,000,000,000) Gwei`
			`EJECTION_BALANCE: 16000000000`
update with configs<>presets separation 2021-05-06 17:49:33 +00:00			`# 2**2 (= 4)`
			`MIN_PER_EPOCH_CHURN_LIMIT: 4`
			`# 2**16 (= 65,536)`
			`CHURN_LIMIT_QUOTIENT: 65536`
Apply suggestions from code review Co-authored-by: danny <dannyjryan@gmail.com> 2023-09-15 14:02:34 +00:00			`# [New in Deneb:EIP7514] 2**3 (= 8)`
Add EIP-7514 into Deneb 2023-09-15 02:25:47 +00:00			`MAX_PER_EPOCH_ACTIVATION_CHURN_LIMIT: 8`
update with configs<>presets separation 2021-05-06 17:49:33 +00:00
add PROPOSER_SCORE_BOOST to configuration yaml files 2021-11-23 00:02:46 +00:00			`# Fork choice`
			`# ---------------------------------------------------------------`
Update PROPOSER_SCORE_BOOST to 40 percent (#2895) 2022-05-20 19:15:40 +00:00			`# 40%`
			`PROPOSER_SCORE_BOOST: 40`
Update config files 2023-10-24 17:42:30 +00:00			`# 20%`
Clarifications for proposer boost reorgs 2023-10-26 06:44:48 +00:00			`REORG_HEAD_WEIGHT_THRESHOLD: 20`
Update config files 2023-10-24 17:42:30 +00:00			`# 160%`
			`REORG_PARENT_WEIGHT_THRESHOLD: 160`
			# `2` epochs
			`REORG_MAX_EPOCHS_SINCE_FINALIZATION: 2`

add PROPOSER_SCORE_BOOST to configuration yaml files 2021-11-23 00:02:46 +00:00
update with configs<>presets separation 2021-05-06 17:49:33 +00:00			`# Deposit contract`
			`# ---------------------------------------------------------------`
			`# Ethereum PoW Mainnet`
			`DEPOSIT_CHAIN_ID: 1`
			`DEPOSIT_NETWORK_ID: 1`
			`DEPOSIT_CONTRACT_ADDRESS: 0x00000000219ab540356cBB839Cbe05303d7705Fa`
Add networking configs to config files 2023-05-16 15:36:52 +00:00

			`# Networking`
			`# ---------------------------------------------------------------`
Moved configuration into network preset instead of constants. (#3394) * Moved configuration into network preset instead of constants. Now that `MAX_CHUNK_SIZE` and `GOSSIP_MAX_SIZE` are in configuration, we no longer need separate constants to represent them in the spec when they change in Bellatrix. I've changed the usage, and put the values into the presets, but I'm not sure if I've updated the descriptions in the best way... This is following on from the work in #3375 where a number of constants got moved into configuration, so we no longer need these constants to be separately represented, they can simply be updated in presets. * Update presets/minimal/bellatrix.yaml Co-authored-by: Hsiao-Wei Wang <hsiaowei.eth@gmail.com> * Update presets/mainnet/bellatrix.yaml Co-authored-by: Hsiao-Wei Wang <hsiaowei.eth@gmail.com> * Moved preset items into the correct section and updated TOC. It looked like the items listed in configuration about the max size and chunk size were no longer needed since we're updating preset values now and the preset changes seem to only be listed in the changes at the top. * review feedback * hopefully correct this time! Moved the 2 fields from configs into presets completely as suggested. * WIP - changing back to being in config and updating the phase 0 value... I think this should be close but want to see what's outstanding. * fix intellij's formatting of table. * more fixes --------- Co-authored-by: Hsiao-Wei Wang <hsiaowei.eth@gmail.com> 2023-06-09 15:12:38 +00:00			# `10 * 2**20` (= 10485760, 10 MiB)
			`GOSSIP_MAX_SIZE: 10485760`
Add networking configs to config files 2023-05-16 15:36:52 +00:00			# `2**10` (= 1024)
			`MAX_REQUEST_BLOCKS: 1024`
move epoch subscription length to config 2023-05-23 19:52:36 +00:00			# `2**8` (= 256)
			`EPOCHS_PER_SUBNET_SUBSCRIPTION: 256`
Add networking configs to config files 2023-05-16 15:36:52 +00:00			# `MIN_VALIDATOR_WITHDRAWABILITY_DELAY + CHURN_LIMIT_QUOTIENT // 2` (= 33024, ~5 months)
			`MIN_EPOCHS_FOR_BLOCK_REQUESTS: 33024`
Moved configuration into network preset instead of constants. (#3394) * Moved configuration into network preset instead of constants. Now that `MAX_CHUNK_SIZE` and `GOSSIP_MAX_SIZE` are in configuration, we no longer need separate constants to represent them in the spec when they change in Bellatrix. I've changed the usage, and put the values into the presets, but I'm not sure if I've updated the descriptions in the best way... This is following on from the work in #3375 where a number of constants got moved into configuration, so we no longer need these constants to be separately represented, they can simply be updated in presets. * Update presets/minimal/bellatrix.yaml Co-authored-by: Hsiao-Wei Wang <hsiaowei.eth@gmail.com> * Update presets/mainnet/bellatrix.yaml Co-authored-by: Hsiao-Wei Wang <hsiaowei.eth@gmail.com> * Moved preset items into the correct section and updated TOC. It looked like the items listed in configuration about the max size and chunk size were no longer needed since we're updating preset values now and the preset changes seem to only be listed in the changes at the top. * review feedback * hopefully correct this time! Moved the 2 fields from configs into presets completely as suggested. * WIP - changing back to being in config and updating the phase 0 value... I think this should be close but want to see what's outstanding. * fix intellij's formatting of table. * more fixes --------- Co-authored-by: Hsiao-Wei Wang <hsiaowei.eth@gmail.com> 2023-06-09 15:12:38 +00:00			# `10 * 2**20` (=10485760, 10 MiB)
			`MAX_CHUNK_SIZE: 10485760`
Add networking configs to config files 2023-05-16 15:36:52 +00:00			`# 5s`
			`TTFB_TIMEOUT: 5`
			`# 10s`
			`RESP_TIMEOUT: 10`
			`ATTESTATION_PROPAGATION_SLOT_RANGE: 32`
			`# 500ms`
			`MAXIMUM_GOSSIP_CLOCK_DISPARITY: 500`
			`MESSAGE_DOMAIN_INVALID_SNAPPY: 0x00000000`
			`MESSAGE_DOMAIN_VALID_SNAPPY: 0x01000000`
			`# 2 subnets per node`
			`SUBNETS_PER_NODE: 2`
			`# 2**8 (= 64)`
			`ATTESTATION_SUBNET_COUNT: 64`
			`ATTESTATION_SUBNET_EXTRA_BITS: 0`
			`# ceillog2(ATTESTATION_SUBNET_COUNT) + ATTESTATION_SUBNET_EXTRA_BITS`
			`ATTESTATION_SUBNET_PREFIX_BITS: 6`
Update `MAX_BLOBS_PER_BLOCK` to `6` and add Deneb networking configs to yaml files (#3410) 2023-06-09 15:10:00 +00:00
			`# Deneb`
			# `2**7` (=128)
			`MAX_REQUEST_BLOCKS_DENEB: 128`
			`# MAX_REQUEST_BLOCKS_DENEB * MAX_BLOBS_PER_BLOCK`
			`MAX_REQUEST_BLOB_SIDECARS: 768`
			# `2**12` (= 4096 epochs, ~18 days)
			`MIN_EPOCHS_FOR_BLOB_SIDECARS_REQUESTS: 4096`
Move `BLOB_SIDECAR_SUBNET_COUNT` to networking config 2023-06-12 15:57:21 +00:00			# `6`
			`BLOB_SIDECAR_SUBNET_COUNT: 6`
Update preset and config files 2023-08-21 09:58:08 +00:00
			`# Whisk`
			# `Epoch(2**8)`
			`WHISK_EPOCHS_PER_SHUFFLING_PHASE: 256`
			# `Epoch(2)`
			`WHISK_PROPOSER_SELECTION_GAP: 2`
Make `CUSTODY_REQUIREMENT` unit be subnets; move some depended helpers to `das-core.md` 2024-01-19 16:24:53 +00:00
			`# EIP7594`
Apply PR feedback 2024-02-27 13:42:32 +00:00			`NUMBER_OF_COLUMNS: 128`
rename 2024-04-22 12:02:42 +00:00			`MAX_CELLS_IN_EXTENDED_MATRIX: 768`
Make `CUSTODY_REQUIREMENT` unit be subnets; move some depended helpers to `das-core.md` 2024-01-19 16:24:53 +00:00			`DATA_COLUMN_SIDECAR_SUBNET_COUNT: 32`
Apply PR feedback 2024-02-27 13:42:32 +00:00			`MAX_REQUEST_DATA_COLUMN_SIDECARS: 16384`
EIP-7594: add custody settings config (#3766) * EIP-7594: add custody settings config * Add `TARGET_NUMBER_OF_PEERS` to config * add TARGET_NUMBER_OF_PEERS Co-authored-by: Hsiao-Wei Wang <hsiaowei.eth@gmail.com> * fix double TARGET_NUMBER_OF_PEERS * fix tests --------- Co-authored-by: Hsiao-Wei Wang <hsiaowei.eth@gmail.com> 2024-05-15 12:34:41 +00:00			`SAMPLES_PER_SLOT: 8`
			`CUSTODY_REQUIREMENT: 1`
			`TARGET_NUMBER_OF_PEERS: 70`
Add EIP-7251 spec Co-authored-by: fradamt <104826920+fradamt@users.noreply.github.com> 2024-03-08 03:41:20 +00:00
Add EIP-7251 to Electra fork 2024-04-09 18:49:58 +00:00			`# [New in Electra:EIP7251]`
			`MIN_PER_EPOCH_CHURN_LIMIT_ELECTRA: 128000000000 # 2*7 10**9 (= 128,000,000,000)`
Add EIP-7251 spec Co-authored-by: fradamt <104826920+fradamt@users.noreply.github.com> 2024-03-08 03:41:20 +00:00			`MAX_PER_EPOCH_ACTIVATION_EXIT_CHURN_LIMIT: 256000000000 # 2*8 10**9 (= 256,000,000,000)`