# beacon_chain # Copyright (c) 2018-2024 Status Research & Development GmbH # Licensed and distributed under either of # * MIT license (license terms in the root directory or at https://opensource.org/licenses/MIT). # * Apache v2 license (license terms in the root directory or at https://www.apache.org/licenses/LICENSE-2.0). # at your option. This file may not be copied, modified, or distributed except according to those terms. {.push raises: [].} import std/[strutils, parseutils, tables, typetraits], chronos/timer, stew/[byteutils], stint, web3/primitives as web3types, ./datatypes/constants export constants export stint, web3types.toHex, web3types.`==` const # https://github.com/ethereum/consensus-specs/blob/v1.4.0-beta.6/specs/phase0/beacon-chain.md#withdrawal-prefixes BLS_WITHDRAWAL_PREFIX*: byte = 0 ETH1_ADDRESS_WITHDRAWAL_PREFIX*: byte = 1 # Constants from `validator.md` not covered by config/presets in the spec TARGET_AGGREGATORS_PER_COMMITTEE*: uint64 = 16 # Not used anywhere; only for network preset checking EPOCHS_PER_RANDOM_SUBNET_SUBSCRIPTION: uint64 = 256 TTFB_TIMEOUT* = 5'u64 MESSAGE_DOMAIN_INVALID_SNAPPY*: array[4, byte] = [0x00, 0x00, 0x00, 0x00] MESSAGE_DOMAIN_VALID_SNAPPY*: array[4, byte] = [0x01, 0x00, 0x00, 0x00] type Version* = distinct array[4, byte] Eth1Address* = web3types.Address RuntimeConfig* = object ## https://github.com/ethereum/consensus-specs/tree/v1.4.0-beta.4/configs PRESET_BASE*: string CONFIG_NAME*: string # Transition TERMINAL_TOTAL_DIFFICULTY*: UInt256 TERMINAL_BLOCK_HASH*: Hash32 TERMINAL_BLOCK_HASH_ACTIVATION_EPOCH*: Epoch # Not actively used, but part of the spec # Genesis MIN_GENESIS_ACTIVE_VALIDATOR_COUNT*: uint64 MIN_GENESIS_TIME*: uint64 GENESIS_FORK_VERSION*: Version GENESIS_DELAY*: uint64 # Forking ALTAIR_FORK_VERSION*: Version ALTAIR_FORK_EPOCH*: Epoch BELLATRIX_FORK_VERSION*: Version BELLATRIX_FORK_EPOCH*: Epoch CAPELLA_FORK_VERSION*: Version CAPELLA_FORK_EPOCH*: Epoch DENEB_FORK_VERSION*: Version DENEB_FORK_EPOCH*: Epoch ELECTRA_FORK_VERSION*: Version ELECTRA_FORK_EPOCH*: Epoch FULU_FORK_VERSION*: Version FULU_FORK_EPOCH*: Epoch # Time parameters # TODO SECONDS_PER_SLOT*: uint64 SECONDS_PER_ETH1_BLOCK*: uint64 MIN_VALIDATOR_WITHDRAWABILITY_DELAY*: uint64 SHARD_COMMITTEE_PERIOD*: uint64 ETH1_FOLLOW_DISTANCE*: uint64 # Validator cycle INACTIVITY_SCORE_BIAS*: uint64 INACTIVITY_SCORE_RECOVERY_RATE*: uint64 EJECTION_BALANCE*: uint64 MIN_PER_EPOCH_CHURN_LIMIT*: uint64 CHURN_LIMIT_QUOTIENT*: uint64 MAX_PER_EPOCH_ACTIVATION_CHURN_LIMIT*: uint64 # Fork choice # TODO PROPOSER_SCORE_BOOST*: uint64 # TODO REORG_HEAD_WEIGHT_THRESHOLD*: uint64 # TODO REORG_PARENT_WEIGHT_THRESHOLD*: uint64 # TODO REORG_MAX_EPOCHS_SINCE_FINALIZATION*: uint64 # Deposit contract DEPOSIT_CHAIN_ID*: uint64 DEPOSIT_NETWORK_ID*: uint64 DEPOSIT_CONTRACT_ADDRESS*: Eth1Address # Networking # TODO GOSSIP_MAX_SIZE*: uint64 # TODO MAX_REQUEST_BLOCKS*: uint64 # TODO EPOCHS_PER_SUBNET_SUBSCRIPTION*: uint64 MIN_EPOCHS_FOR_BLOCK_REQUESTS*: uint64 # TODO MAX_CHUNK_SIZE*: uint64 # TODO TTFB_TIMEOUT*: uint64 # TODO RESP_TIMEOUT*: uint64 # TODO ATTESTATION_PROPAGATION_SLOT_RANGE*: uint64 # TODO MAXIMUM_GOSSIP_CLOCK_DISPARITY*: uint64 # TODO MESSAGE_DOMAIN_INVALID_SNAPPY*: array[4, byte] # TODO MESSAGE_DOMAIN_VALID_SNAPPY*: array[4, byte] # TODO SUBNETS_PER_NODE*: uint64 # TODO ATTESTATION_SUBNET_COUNT*: uint64 # TODO ATTESTATION_SUBNET_EXTRA_BITS*: uint64 # TODO ATTESTATION_SUBNET_PREFIX_BITS*: uint64 # Deneb # TODO MAX_REQUEST_BLOCKS_DENEB*: uint64 # TODO MAX_REQUEST_BLOB_SIDECARS*: uint64 MIN_EPOCHS_FOR_BLOB_SIDECARS_REQUESTS*: uint64 # TODO BLOB_SIDECAR_SUBNET_COUNT*: uint64 # Electra MIN_PER_EPOCH_CHURN_LIMIT_ELECTRA*: uint64 MAX_PER_EPOCH_ACTIVATION_EXIT_CHURN_LIMIT*: uint64 BLOB_SIDECAR_SUBNET_COUNT_ELECTRA*: uint64 MAX_BLOBS_PER_BLOCK_ELECTRA*: uint64 MAX_REQUEST_BLOB_SIDECARS_ELECTRA*: uint64 PresetFile* = object values*: Table[string, string] missingValues*: seq[string] PresetFileError* = object of CatchableError PresetIncompatibleError* = object of CatchableError const const_preset* {.strdefine.} = "mainnet" # No-longer used values from legacy config files ignoredValues = [ "TRANSITION_TOTAL_DIFFICULTY", # Name that appears in some altair alphas, obsolete, remove when no more testnets "MIN_ANCHOR_POW_BLOCK_DIFFICULTY", # Name that appears in some altair alphas, obsolete, remove when no more testnets "RANDOM_SUBNETS_PER_VALIDATOR", # Removed in consensus-specs v1.4.0 ] when const_preset == "mainnet": import ./presets/mainnet export mainnet # TODO Move this to RuntimeConfig const SECONDS_PER_SLOT* {.intdefine.}: uint64 = 12 # The default run-time config specifies the default configuration values # that will be used if a particular run-time config is missing specific # confugration values (which will be then taken from this config object). # It mostly matches the mainnet config with the exception of few properties # such as `CONFIG_NAME`, `TERMINAL_TOTAL_DIFFICULTY`, `*_FORK_EPOCH`, etc # which must be effectively overriden in all network (including mainnet). const defaultRuntimeConfig* = RuntimeConfig( # 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 # * 'sepolia' - testnet # * 'holesky' - testnet # Must match the regex: [a-z0-9\-] CONFIG_NAME: "", # Transition # --------------------------------------------------------------- # TBD, 2**256-2**10 is a placeholder TERMINAL_TOTAL_DIFFICULTY: u256"115792089237316195423570985008687907853269984665640564039457584007913129638912", # By default, don't use these params TERMINAL_BLOCK_HASH: Hash32.fromHex( "0x0000000000000000000000000000000000000000000000000000000000000000"), # 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: Version [byte 0x00, 0x00, 0x00, 0x00], # 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: Version [byte 0x01, 0x00, 0x00, 0x00], ALTAIR_FORK_EPOCH: FAR_FUTURE_EPOCH, # Bellatrix BELLATRIX_FORK_VERSION: Version [byte 0x02, 0x00, 0x00, 0x00], BELLATRIX_FORK_EPOCH: FAR_FUTURE_EPOCH, # Capella CAPELLA_FORK_VERSION: Version [byte 0x03, 0x00, 0x00, 0x00], CAPELLA_FORK_EPOCH: FAR_FUTURE_EPOCH, # Deneb DENEB_FORK_VERSION: Version [byte 0x04, 0x00, 0x00, 0x00], DENEB_FORK_EPOCH: FAR_FUTURE_EPOCH, # Electra ELECTRA_FORK_VERSION: Version [byte 0x05, 0x00, 0x00, 0x00], ELECTRA_FORK_EPOCH: FAR_FUTURE_EPOCH, # Fulu FULU_FORK_VERSION: Version [byte 0x06, 0x00, 0x00, 0x00], FULU_FORK_EPOCH: FAR_FUTURE_EPOCH, # Time parameters # --------------------------------------------------------------- # 12 seconds # TODO 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'u64, # 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, # Deposit contract # --------------------------------------------------------------- # Ethereum PoW Mainnet DEPOSIT_CHAIN_ID: 1, DEPOSIT_NETWORK_ID: 1, DEPOSIT_CONTRACT_ADDRESS: default(Eth1Address), # Networking # --------------------------------------------------------------- # `10 * 2**20` (= 10485760, 10 MiB) # TODO GOSSIP_MAX_SIZE: 10485760, # `2**10` (= 1024) # TODO MAX_REQUEST_BLOCKS: 1024, # `2**8` (= 256) # TODO 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) # TODO MAX_CHUNK_SIZE: 10485760, # 5s # TODO TTFB_TIMEOUT: 5, # 10s # TODO RESP_TIMEOUT: 10, # TODO ATTESTATION_PROPAGATION_SLOT_RANGE: 32, # 500ms # TODO MAXIMUM_GOSSIP_CLOCK_DISPARITY: 500, # TODO MESSAGE_DOMAIN_INVALID_SNAPPY: [byte 0x00, 0x00, 0x00, 0x00], # TODO MESSAGE_DOMAIN_VALID_SNAPPY: [byte 0x01, 0x00, 0x00, 0x00], # 2 subnets per node # TODO SUBNETS_PER_NODE: 2, # 2**8 (= 64) # TODO ATTESTATION_SUBNET_COUNT: 64, # TODO ATTESTATION_SUBNET_EXTRA_BITS: 0, # ceillog2(ATTESTATION_SUBNET_COUNT) + ATTESTATION_SUBNET_EXTRA_BITS # TODO ATTESTATION_SUBNET_PREFIX_BITS: 6, # Deneb # `2**7` (=128) # TODO MAX_REQUEST_BLOCKS_DENEB: 128, # MAX_REQUEST_BLOCKS_DENEB * MAX_BLOBS_PER_BLOCK # TODO MAX_REQUEST_BLOB_SIDECARS: 768, # `2**12` (= 4096 epochs, ~18 days) MIN_EPOCHS_FOR_BLOB_SIDECARS_REQUESTS: 4096, # `6` # TODO BLOB_SIDECAR_SUBNET_COUNT: 6, # Electra # 2**7 * 10**9 (= 128,000,000,000) MIN_PER_EPOCH_CHURN_LIMIT_ELECTRA: 128000000000'u64, # 2**8 * 10**9 (= 256,000,000,000) MAX_PER_EPOCH_ACTIVATION_EXIT_CHURN_LIMIT: 256000000000'u64, # `9` BLOB_SIDECAR_SUBNET_COUNT_ELECTRA: 9, # `uint64(9)` MAX_BLOBS_PER_BLOCK_ELECTRA: 9, # MAX_REQUEST_BLOCKS_DENEB * MAX_BLOBS_PER_BLOCK_ELECTRA MAX_REQUEST_BLOB_SIDECARS_ELECTRA: 1152 ) elif const_preset == "gnosis": import ./presets/gnosis export gnosis # TODO Move this to RuntimeConfig const SECONDS_PER_SLOT* {.intdefine.}: uint64 = 5 # The default run-time config specifies the default configuration values # that will be used if a particular run-time config is missing specific # confugration values (which will be then taken from this config object). # It mostly matches the gnosis config with the exception of few properties # such as `CONFIG_NAME`, `TERMINAL_TOTAL_DIFFICULTY`, `*_FORK_EPOCH`, etc # which must be effectively overriden in all network (including mainnet). const defaultRuntimeConfig* = RuntimeConfig( # Mainnet config # Extends the mainnet preset PRESET_BASE: "gnosis", # Free-form short name of the network that this configuration applies to - known # canonical network names include: # * 'mainnet' - there can be only one # * 'sepolia' - testnet # * 'holesky' - testnet # Must match the regex: [a-z0-9\-] CONFIG_NAME: "", # Transition # --------------------------------------------------------------- # TBD, 2**256-2**10 is a placeholder TERMINAL_TOTAL_DIFFICULTY: u256"115792089237316195423570985008687907853269984665640564039457584007913129638912", # By default, don't use these params TERMINAL_BLOCK_HASH: BlockHash.fromHex( "0x0000000000000000000000000000000000000000000000000000000000000000"), # Genesis # --------------------------------------------------------------- # `2**14` (= 16,384) MIN_GENESIS_ACTIVE_VALIDATOR_COUNT: 4096, # Dec 1, 2020, 12pm UTC MIN_GENESIS_TIME: 1638968400, # Mainnet initial fork version, recommend altering for testnets GENESIS_FORK_VERSION: Version [byte 0x00, 0x00, 0x00, 0x64], # 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: Version [byte 0x01, 0x00, 0x00, 0x64], ALTAIR_FORK_EPOCH: FAR_FUTURE_EPOCH, # Bellatrix BELLATRIX_FORK_VERSION: Version [byte 0x02, 0x00, 0x00, 0x64], BELLATRIX_FORK_EPOCH: FAR_FUTURE_EPOCH, # Capella CAPELLA_FORK_VERSION: Version [byte 0x03, 0x00, 0x00, 0x64], CAPELLA_FORK_EPOCH: FAR_FUTURE_EPOCH, # Deneb DENEB_FORK_VERSION: Version [byte 0x04, 0x00, 0x00, 0x64], DENEB_FORK_EPOCH: FAR_FUTURE_EPOCH, # Electra ELECTRA_FORK_VERSION: Version [byte 0x05, 0x00, 0x00, 0x64], ELECTRA_FORK_EPOCH: FAR_FUTURE_EPOCH, # Fulu FULU_FORK_VERSION: Version [byte 0x06, 0x00, 0x00, 0x00], FULU_FORK_EPOCH: FAR_FUTURE_EPOCH, # Time parameters # --------------------------------------------------------------- # 12 seconds # TODO SECONDS_PER_SLOT: 12, # 14 (estimate from Eth1 mainnet) SECONDS_PER_ETH1_BLOCK: 5, # 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'u64, # 2**2 (= 4) MIN_PER_EPOCH_CHURN_LIMIT: 4, # 2**16 (= 65,536) CHURN_LIMIT_QUOTIENT: 4096, # [New in Deneb:EIP7514] 2**3 (= 8) MAX_PER_EPOCH_ACTIVATION_CHURN_LIMIT: 8, # Deposit contract # --------------------------------------------------------------- # Gnosis PoW Mainnet DEPOSIT_CHAIN_ID: 100, DEPOSIT_NETWORK_ID: 100, DEPOSIT_CONTRACT_ADDRESS: default(Eth1Address), # Networking # --------------------------------------------------------------- # `10 * 2**20` (= 10485760, 10 MiB) # TODO GOSSIP_MAX_SIZE: 10485760, # `2**10` (= 1024) # TODO MAX_REQUEST_BLOCKS: 1024, # `2**8` (= 256) # TODO 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) # TODO MAX_CHUNK_SIZE: 10485760, # 5s # TODO TTFB_TIMEOUT: 5, # 10s # TODO RESP_TIMEOUT: 10, # TODO ATTESTATION_PROPAGATION_SLOT_RANGE: 32, # 500ms # TODO MAXIMUM_GOSSIP_CLOCK_DISPARITY: 500, # TODO MESSAGE_DOMAIN_INVALID_SNAPPY: [byte 0x00, 0x00, 0x00, 0x00], # TODO MESSAGE_DOMAIN_VALID_SNAPPY: [byte 0x01, 0x00, 0x00, 0x00], # 2 subnets per node # TODO SUBNETS_PER_NODE: 2, # 2**8 (= 64) # TODO ATTESTATION_SUBNET_COUNT: 64, # TODO ATTESTATION_SUBNET_EXTRA_BITS: 0, # ceillog2(ATTESTATION_SUBNET_COUNT) + ATTESTATION_SUBNET_EXTRA_BITS # TODO ATTESTATION_SUBNET_PREFIX_BITS: 6, # Deneb # `2**7` (=128) # TODO MAX_REQUEST_BLOCKS_DENEB: 128, # MAX_REQUEST_BLOCKS_DENEB * MAX_BLOBS_PER_BLOCK # TODO MAX_REQUEST_BLOB_SIDECARS: 768, # `2**12` (= 4096 epochs, ~18 days) MIN_EPOCHS_FOR_BLOB_SIDECARS_REQUESTS: 16384, # `6` # TODO BLOB_SIDECAR_SUBNET_COUNT: 6, # Electra # 2**7 * 10**9 (= 128,000,000,000) MIN_PER_EPOCH_CHURN_LIMIT_ELECTRA: 128000000000'u64, # 2**8 * 10**9 (= 256,000,000,000) MAX_PER_EPOCH_ACTIVATION_EXIT_CHURN_LIMIT: 256000000000'u64, # `9` BLOB_SIDECAR_SUBNET_COUNT_ELECTRA: 9, # `uint64(9)` MAX_BLOBS_PER_BLOCK_ELECTRA: 9, # MAX_REQUEST_BLOCKS_DENEB * MAX_BLOBS_PER_BLOCK_ELECTRA MAX_REQUEST_BLOB_SIDECARS_ELECTRA: 1152 ) elif const_preset == "minimal": import ./presets/minimal export minimal const SECONDS_PER_SLOT* {.intdefine.}: uint64 = 6 # https://github.com/ethereum/consensus-specs/blob/v1.4.0-beta.5/configs/minimal.yaml const defaultRuntimeConfig* = RuntimeConfig( # Minimal config # Extends the minimal preset PRESET_BASE: "minimal", # Free-form short name of the network that this configuration applies to - known # canonical network names include: # * 'mainnet' - there can be only one # * 'sepolia' - testnet # * 'holesky' - testnet # Must match the regex: [a-z0-9\-] CONFIG_NAME: "minimal", # Transition # --------------------------------------------------------------- # 2**256-2**10 for testing minimal network TERMINAL_TOTAL_DIFFICULTY: u256"115792089237316195423570985008687907853269984665640564039457584007913129638912", # By default, don't use these params TERMINAL_BLOCK_HASH: Hash32.fromHex( "0x0000000000000000000000000000000000000000000000000000000000000000"), # Genesis # --------------------------------------------------------------- # [customized] MIN_GENESIS_ACTIVE_VALIDATOR_COUNT: 64, # Jan 3, 2020 MIN_GENESIS_TIME: 1578009600, # Highest byte set to 0x01 to avoid collisions with mainnet versioning GENESIS_FORK_VERSION: Version [byte 0x00, 0x00, 0x00, 0x01], # [customized] Faster to spin up testnets, but does not give validator reasonable warning time for genesis GENESIS_DELAY: 300, # Forking # --------------------------------------------------------------- # Values provided for illustrative purposes. # Individual tests/testnets may set different values. # Altair ALTAIR_FORK_VERSION: Version [byte 0x01, 0x00, 0x00, 0x01], ALTAIR_FORK_EPOCH: Epoch(uint64.high), # Bellatrix BELLATRIX_FORK_VERSION: Version [byte 0x02, 0x00, 0x00, 0x01], BELLATRIX_FORK_EPOCH: Epoch(uint64.high), # Capella CAPELLA_FORK_VERSION: Version [byte 0x03, 0x00, 0x00, 0x01], CAPELLA_FORK_EPOCH: Epoch(uint64.high), # Deneb DENEB_FORK_VERSION: Version [byte 0x04, 0x00, 0x00, 0x01], DENEB_FORK_EPOCH: Epoch(uint64.high), # Electra ELECTRA_FORK_VERSION: Version [byte 0x05, 0x00, 0x00, 0x01], ELECTRA_FORK_EPOCH: Epoch(uint64.high), # Fulu FULU_FORK_VERSION: Version [byte 0x06, 0x00, 0x00, 0x01], FULU_FORK_EPOCH: Epoch(uint64.high), # Time parameters # --------------------------------------------------------------- # [customized] Faster for testing purposes # TODO SECONDS_PER_SLOT: 6, # 14 (estimate from Eth1 mainnet) SECONDS_PER_ETH1_BLOCK: 14, # 2**8 (= 256) epochs MIN_VALIDATOR_WITHDRAWABILITY_DELAY: 256, # [customized] higher frequency of committee turnover and faster time to acceptable voluntary exit SHARD_COMMITTEE_PERIOD: 64, # [customized] process deposits more quickly, but insecure ETH1_FOLLOW_DISTANCE: 16, # 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'u64, # [customized] more easily demonstrate the difference between this value and the activation churn limit MIN_PER_EPOCH_CHURN_LIMIT: 2, # [customized] scale queue churn at much lower validator counts for testing CHURN_LIMIT_QUOTIENT: 32, # [New in Deneb:EIP7514] [customized] MAX_PER_EPOCH_ACTIVATION_CHURN_LIMIT: 4, # Deposit contract # --------------------------------------------------------------- # Ethereum Goerli testnet DEPOSIT_CHAIN_ID: 5, DEPOSIT_NETWORK_ID: 5, # Configured on a per testnet basis DEPOSIT_CONTRACT_ADDRESS: default(Eth1Address), # Networking # --------------------------------------------------------------- # `10 * 2**20` (= 10485760, 10 MiB) # TODO GOSSIP_MAX_SIZE: 10485760, # `2**10` (= 1024) # TODO MAX_REQUEST_BLOCKS: 1024, # `2**8` (= 256) # TODO EPOCHS_PER_SUBNET_SUBSCRIPTION: 256, # [customized] `MIN_VALIDATOR_WITHDRAWABILITY_DELAY + CHURN_LIMIT_QUOTIENT // 2` (= 272) MIN_EPOCHS_FOR_BLOCK_REQUESTS: 272, # `10 * 2**20` (=10485760, 10 MiB) # TODO MAX_CHUNK_SIZE: 10485760, # 5s # TODO TTFB_TIMEOUT: 5, # 10s # TODO RESP_TIMEOUT: 10, # TODO ATTESTATION_PROPAGATION_SLOT_RANGE: 32, # 500ms # TODO MAXIMUM_GOSSIP_CLOCK_DISPARITY: 500, # TODO MESSAGE_DOMAIN_INVALID_SNAPPY: [byte 0x00, 0x00, 0x00, 0x00], # TODO MESSAGE_DOMAIN_VALID_SNAPPY: [byte 0x01, 0x00, 0x00, 0x00], # 2 subnets per node # TODO SUBNETS_PER_NODE: 2, # 2**8 (= 64) # TODO ATTESTATION_SUBNET_COUNT: 64, # TODO ATTESTATION_SUBNET_EXTRA_BITS: 0, # ceillog2(ATTESTATION_SUBNET_COUNT) + ATTESTATION_SUBNET_EXTRA_BITS # TODO ATTESTATION_SUBNET_PREFIX_BITS: 6, # Deneb # `2**7` (=128) # TODO MAX_REQUEST_BLOCKS_DENEB: 128, # MAX_REQUEST_BLOCKS_DENEB * MAX_BLOBS_PER_BLOCK # TODO MAX_REQUEST_BLOB_SIDECARS: 768, # `2**12` (= 4096 epochs, ~18 days) MIN_EPOCHS_FOR_BLOB_SIDECARS_REQUESTS: 4096, # `6` # TODO BLOB_SIDECAR_SUBNET_COUNT: 6, # Electra # [customized] 2**6 * 10**9 (= 64,000,000,000) MIN_PER_EPOCH_CHURN_LIMIT_ELECTRA: 64000000000'u64, # [customized] 2**7 * 10**9 (= 128,000,000,000) MAX_PER_EPOCH_ACTIVATION_EXIT_CHURN_LIMIT: 128000000000'u64, # `9` BLOB_SIDECAR_SUBNET_COUNT_ELECTRA: 9, # `uint64(9)` MAX_BLOBS_PER_BLOCK_ELECTRA: 9, # MAX_REQUEST_BLOCKS_DENEB * MAX_BLOBS_PER_BLOCK_ELECTRA MAX_REQUEST_BLOB_SIDECARS_ELECTRA: 1152, ) else: {.error: "Only mainnet, gnosis, and minimal presets supported".} # macro createConstantsFromPreset*(path: static string): untyped = # result = newStmtList() # let preset = try: readPresetFile(path) # except CatchableError as err: # error err.msg # TODO: This should be marked as noreturn # return # for name, value in preset.values: # let # typ = getType(name) # value = if typ in ["int64", "uint64", "byte"]: typ & "(" & value & ")" # else: "parse(" & typ & ", \"" & value & "\")" # try: # result.add parseStmt("const $1* {.intdefine.} = $2" % [$name, value]) # except ValueError: # doAssert false, "All values in the presets are printable" # if preset.missingValues.card > 0: # warning "Missing constants in preset: " & $preset.missingValues # createConstantsFromPreset const_preset const SLOTS_PER_SYNC_COMMITTEE_PERIOD* = SLOTS_PER_EPOCH * EPOCHS_PER_SYNC_COMMITTEE_PERIOD # https://github.com/ethereum/consensus-specs/blob/v1.4.0-alpha.3/specs/phase0/p2p-interface.md#configuration func safeMinEpochsForBlockRequests*(cfg: RuntimeConfig): uint64 = cfg.MIN_VALIDATOR_WITHDRAWABILITY_DELAY + cfg.CHURN_LIMIT_QUOTIENT div 2 func parse(T: type uint64, input: string): T {.raises: [ValueError].} = var res: BiggestUInt if input.len > 2 and input[0] == '0' and input[1] == 'x': if parseHex(input, res) != input.len: raise newException(ValueError, "The constant value should be a valid hex integer") else: if parseBiggestUInt(input, res) != input.len: raise newException(ValueError, "The constant value should be a valid unsigned integer") uint64(res) template parse(T: type byte, input: string): T = byte parse(uint64, input) func parse(T: type array[4, byte], input: string): T {.raises: [ValueError].} = hexToByteArray(input, 4) func parse(T: type Version, input: string): T {.raises: [ValueError].} = Version hexToByteArray(input, 4) template parse(T: type Slot, input: string): T = Slot parse(uint64, input) template parse(T: type Epoch, input: string): T = Epoch parse(uint64, input) template parse(T: type string, input: string): T = input.strip(chars = {'"', '\''}) template parse(T: type Eth1Address, input: string): T = Eth1Address.fromHex(input) template parse(T: type Hash32, input: string): T = Hash32.fromHex(input) template parse(T: type UInt256, input: string): T = parse(input, UInt256, 10) func parse(T: type DomainType, input: string): T {.raises: [ValueError].} = DomainType hexToByteArray(input, 4) proc readRuntimeConfig*( fileContent: string, path: string): (RuntimeConfig, seq[string]) {. raises: [PresetFileError, PresetIncompatibleError].} = var lineNum = 0 cfg = defaultRuntimeConfig template lineinfo: string = try: "$1($2) " % [path, $lineNum] except ValueError: path template fail(msg) = raise newException(PresetFileError, lineinfo() & msg) var names: seq[string] for name, field in cfg.fieldPairs(): names.add name var values: Table[string, string] for line in splitLines(fileContent): inc lineNum if line.len == 0 or line[0] == '#': continue # remove any trailing comments let line = line.split("#")[0] let lineParts = line.split(":") if lineParts.len != 2: fail "Invalid syntax: A preset file should include only assignments in the form 'ConstName: Value'" if lineParts[0] in ignoredValues: continue values[lineParts[0]] = lineParts[1].strip # Certain config keys are baked into the binary at compile-time # and cannot be overridden via config. template checkCompatibility( constValue: untyped, name: string, operator: untyped = `==`): untyped = if values.hasKey(name): const opDesc = astToStr(operator) try: let value = parse(typeof(constValue), values[name]) when constValue is distinct: if not operator(distinctBase(value), distinctBase(constValue)): raise (ref PresetFileError)(msg: "Cannot override config" & " (required: " & name & opDesc & $distinctBase(constValue) & " - config: " & name & "=" & values[name] & ")") else: if not operator(value, constValue): raise (ref PresetFileError)(msg: "Cannot override config" & " (required: " & name & opDesc & $constValue & " - config: " & name & "=" & values[name] & ")") values.del name except ValueError: raise (ref PresetFileError)(msg: "Unable to parse " & name) template checkCompatibility( constValue: untyped, operator: untyped = `==`): untyped = block: const name = astToStr(constValue) checkCompatibility(constValue, name, operator) checkCompatibility SECONDS_PER_SLOT checkCompatibility BLS_WITHDRAWAL_PREFIX checkCompatibility MAX_COMMITTEES_PER_SLOT checkCompatibility TARGET_COMMITTEE_SIZE checkCompatibility MAX_VALIDATORS_PER_COMMITTEE checkCompatibility SHUFFLE_ROUND_COUNT checkCompatibility HYSTERESIS_QUOTIENT checkCompatibility HYSTERESIS_DOWNWARD_MULTIPLIER checkCompatibility HYSTERESIS_UPWARD_MULTIPLIER checkCompatibility MIN_DEPOSIT_AMOUNT checkCompatibility MAX_EFFECTIVE_BALANCE checkCompatibility EFFECTIVE_BALANCE_INCREMENT checkCompatibility MIN_ATTESTATION_INCLUSION_DELAY checkCompatibility SLOTS_PER_EPOCH checkCompatibility MIN_SEED_LOOKAHEAD checkCompatibility MAX_SEED_LOOKAHEAD checkCompatibility EPOCHS_PER_ETH1_VOTING_PERIOD checkCompatibility SLOTS_PER_HISTORICAL_ROOT checkCompatibility MIN_EPOCHS_TO_INACTIVITY_PENALTY checkCompatibility EPOCHS_PER_HISTORICAL_VECTOR checkCompatibility EPOCHS_PER_SLASHINGS_VECTOR checkCompatibility HISTORICAL_ROOTS_LIMIT checkCompatibility VALIDATOR_REGISTRY_LIMIT checkCompatibility BASE_REWARD_FACTOR checkCompatibility WHISTLEBLOWER_REWARD_QUOTIENT checkCompatibility PROPOSER_REWARD_QUOTIENT checkCompatibility INACTIVITY_PENALTY_QUOTIENT checkCompatibility MIN_SLASHING_PENALTY_QUOTIENT checkCompatibility PROPORTIONAL_SLASHING_MULTIPLIER checkCompatibility MAX_PROPOSER_SLASHINGS checkCompatibility MAX_ATTESTER_SLASHINGS checkCompatibility MAX_ATTESTATIONS checkCompatibility MAX_DEPOSITS checkCompatibility MAX_VOLUNTARY_EXITS checkCompatibility TARGET_AGGREGATORS_PER_COMMITTEE checkCompatibility EPOCHS_PER_RANDOM_SUBNET_SUBSCRIPTION checkCompatibility DOMAIN_BEACON_PROPOSER checkCompatibility DOMAIN_BEACON_ATTESTER checkCompatibility DOMAIN_RANDAO checkCompatibility DOMAIN_DEPOSIT checkCompatibility DOMAIN_VOLUNTARY_EXIT checkCompatibility DOMAIN_SELECTION_PROOF checkCompatibility DOMAIN_AGGREGATE_AND_PROOF checkCompatibility DOMAIN_SYNC_COMMITTEE checkCompatibility DOMAIN_SYNC_COMMITTEE_SELECTION_PROOF checkCompatibility DOMAIN_CONTRIBUTION_AND_PROOF checkCompatibility GOSSIP_MAX_SIZE checkCompatibility MAX_REQUEST_BLOCKS checkCompatibility EPOCHS_PER_SUBNET_SUBSCRIPTION checkCompatibility MAX_CHUNK_SIZE checkCompatibility TTFB_TIMEOUT checkCompatibility RESP_TIMEOUT checkCompatibility ATTESTATION_PROPAGATION_SLOT_RANGE checkCompatibility MAXIMUM_GOSSIP_CLOCK_DISPARITY.milliseconds.uint64, "MAXIMUM_GOSSIP_CLOCK_DISPARITY" checkCompatibility MESSAGE_DOMAIN_INVALID_SNAPPY checkCompatibility MESSAGE_DOMAIN_VALID_SNAPPY checkCompatibility SUBNETS_PER_NODE checkCompatibility ATTESTATION_SUBNET_COUNT checkCompatibility ATTESTATION_SUBNET_EXTRA_BITS checkCompatibility ATTESTATION_SUBNET_PREFIX_BITS checkCompatibility MAX_REQUEST_BLOCKS_DENEB checkCompatibility MAX_REQUEST_BLOCKS_DENEB * MAX_BLOBS_PER_BLOCK, "MAX_REQUEST_BLOB_SIDECARS" checkCompatibility BLOB_SIDECAR_SUBNET_COUNT checkCompatibility MAX_BLOBS_PER_BLOCK_ELECTRA checkCompatibility MAX_REQUEST_BLOB_SIDECARS_ELECTRA # https://github.com/ethereum/consensus-specs/blob/v1.5.0-alpha.10/specs/phase0/fork-choice.md#configuration # Isn't being used as a preset in the usual way: at any time, there's one correct value checkCompatibility PROPOSER_SCORE_BOOST checkCompatibility REORG_HEAD_WEIGHT_THRESHOLD checkCompatibility REORG_PARENT_WEIGHT_THRESHOLD checkCompatibility REORG_MAX_EPOCHS_SINCE_FINALIZATION for name, field in cfg.fieldPairs(): if name in values: try: field = parse(typeof(field), values[name]) values.del name except ValueError: raise (ref PresetFileError)(msg: "Unable to parse " & name) if cfg.PRESET_BASE != const_preset: raise (ref PresetIncompatibleError)( msg: "Config not compatible with binary, compile with -d:const_preset=" & cfg.PRESET_BASE) # Requires initialized `cfg` checkCompatibility cfg.safeMinEpochsForBlockRequests(), "MIN_EPOCHS_FOR_BLOCK_REQUESTS", `>=` var unknowns: seq[string] for name in values.keys: unknowns.add name (cfg, unknowns) proc readRuntimeConfig*( path: string): (RuntimeConfig, seq[string]) {. raises: [IOError, PresetFileError, PresetIncompatibleError].} = readRuntimeConfig(readFile(path), path) template name*(cfg: RuntimeConfig): string = if cfg.CONFIG_NAME.len() > 0: cfg.CONFIG_NAME else: const_preset func defaultLightClientDataMaxPeriods*(cfg: RuntimeConfig): uint64 = const epochsPerPeriod = EPOCHS_PER_SYNC_COMMITTEE_PERIOD let maxEpochs = cfg.MIN_EPOCHS_FOR_BLOCK_REQUESTS (maxEpochs + epochsPerPeriod - 1) div epochsPerPeriod