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: 18446744073709551615
# EIP6110
EIP6110_FORK_VERSION: 0x05000000  # temporary stub
EIP6110_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


# Fork choice
# ---------------------------------------------------------------
# 40%
PROPOSER_SCORE_BOOST: 40

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


# Networking
# ---------------------------------------------------------------
# `2**20` (= 1048576, 1 MiB)
GOSSIP_MAX_SIZE: 1048576
# `2**10` (= 1024)
MAX_REQUEST_BLOCKS: 1024
# `MIN_VALIDATOR_WITHDRAWABILITY_DELAY + CHURN_LIMIT_QUOTIENT // 2` (= 33024, ~5 months)
MIN_EPOCHS_FOR_BLOCK_REQUESTS: 33024
# `2**20` (=1048576, 1 MiB) 
MAX_CHUNK_SIZE: 1048576
# 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 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`
			`DENEB_FORK_EPOCH: 18446744073709551615`
Add EIP-6110 to the pytest scope 2023-03-27 12:58:43 +00:00			`# EIP6110`
Fix EIP-6110 configs 2023-03-28 06:49:13 +00:00			`EIP6110_FORK_VERSION: 0x05000000 # temporary stub`
Add EIP-6110 to the pytest scope 2023-03-27 12:58:43 +00:00			`EIP6110_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`


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`
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`
			`# ---------------------------------------------------------------`
			# `2**20` (= 1048576, 1 MiB)
			`GOSSIP_MAX_SIZE: 1048576`
			# `2**10` (= 1024)
			`MAX_REQUEST_BLOCKS: 1024`
			# `MIN_VALIDATOR_WITHDRAWABILITY_DELAY + CHURN_LIMIT_QUOTIENT // 2` (= 33024, ~5 months)
			`MIN_EPOCHS_FOR_BLOCK_REQUESTS: 33024`
			# `2**20` (=1048576, 1 MiB)
			`MAX_CHUNK_SIZE: 1048576`
			`# 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`