status-im/eth2.0-specs
2
0
Fork 0
mirror of https://github.com/status-im/eth2.0-specs.git synced 2025-02-03 06:13:31 +00:00
Code Issues Projects Releases Wiki Activity
eth2.0-specs/configs/minimal.yaml

189 lines
5.4 KiB
YAML
Raw Permalink Normal View History

update with configs<>presets separation
2021-05-06 19:49:33 +02:00
# Minimal config
# Extends the minimal preset
PRESET_BASE: 'minimal'
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 12:40:16 +01: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: 'minimal'
Add TBD for TTD and add the value to the configs
2021-09-18 12:39:54 +06: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 08:00:14 -06:00
# 2**256-2**10 for testing minimal network
Changed terminal total difficulty to have some difficulty range for tests without overflow
2021-09-21 15:18:46 +03:00
TERMINAL_TOTAL_DIFFICULTY: 115792089237316195423570985008687907853269984665640564039457584007913129638912
ad TBH_ACTIVATION_EPOCH
2021-10-18 13:38:08 -06:00
# By default, don't use these params
Add TERMINAL_BLOCK_HASH override
2021-09-22 11:18:41 -07:00
TERMINAL_BLOCK_HASH: 0x0000000000000000000000000000000000000000000000000000000000000000
Fix setup.py parser and rename `TBH_ACTIVATION_EPOCH` -> `TERMINAL_BLOCK_HASH_ACTIVATION_EPOCH`
2021-10-19 11:25:50 +08:00
TERMINAL_BLOCK_HASH_ACTIVATION_EPOCH: 18446744073709551615
ad TBH_ACTIVATION_EPOCH
2021-10-18 13:38:08 -06:00
Add TBD for TTD and add the value to the configs
2021-09-18 12:39:54 +06:00
Add back newlines in configs
2021-09-23 16:51:20 -07:00
update with configs<>presets separation
2021-05-06 19:49:33 +02:00
# 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: 0x00000001
# [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: 0x01000001
ALTAIR_FORK_EPOCH: 18446744073709551615
Merge -> Bellatrix
2021-12-22 15:46:18 +08:00
# Bellatrix
BELLATRIX_FORK_VERSION: 0x02000001
BELLATRIX_FORK_EPOCH: 18446744073709551615
basic capella withdrawal in place
2021-12-01 11:37:30 -07:00
# Capella
CAPELLA_FORK_VERSION: 0x03000001
CAPELLA_FORK_EPOCH: 18446744073709551615
add electra configs
2024-03-25 12:15:53 +01:00
# Deneb
Replaced EIP4844 references with Deneb Fixes #3207
2023-01-23 15:08:34 +01:00
DENEB_FORK_VERSION: 0x04000001
DENEB_FORK_EPOCH: 18446744073709551615
add electra configs
2024-03-25 12:15:53 +01:00
# Electra
ELECTRA_FORK_VERSION: 0x05000001
ELECTRA_FORK_EPOCH: 18446744073709551615
wip wip Add `TARGET_NUMBER_OF_PEERS` Add networking spec draft fix simplification Rename `DoYouHave` to `GetCustodyStatus` Add DataLineSidecar design Apply suggestions from code review Co-authored-by: dankrad <mail@dankradfeist.de> Co-authored-by: danny <dannyjryan@gmail.com> Revamp after reviews and discussion Remove `CustodyStatus` minor fix Change`DataColumn` to `List[DataCell, MAX_BLOBS_PER_BLOCK]` Move folder Replace `DataColumnByRootAndIndex` with `DataColumnSidecarByRoot` message. Add extended data description Remove `DataRow` Apply suggestions from @jacobkaufmann code review Co-authored-by: Jacob Kaufmann <jacobkaufmann18@gmail.com> Represent matrix in `BLSFieldElement` form Add `assert time >= store.time` to `on_tick` Revert the spec. Only handle it in tests Remove extra tick cleanup leftover Add randomized block cases Specify RPC byRoot blocks-sidecars elegibility fix typo Update specs/phase0/p2p-interface.md Co-authored-by: Mikhail Kalinin <noblesse.knight@gmail.com> Update specs/deneb/p2p-interface.md Co-authored-by: Mikhail Kalinin <noblesse.knight@gmail.com> add failed on_block condition rephrase Update specs/phase0/p2p-interface.md Co-authored-by: Mikhail Kalinin <noblesse.knight@gmail.com> apply suggestion Update specs/deneb/p2p-interface.md Co-authored-by: danny <dannyjryan@gmail.com> Update specs/deneb/p2p-interface.md Co-authored-by: danny <dannyjryan@gmail.com> remove the last consider from on_block to state_transition simplify and add a new rule Update specs/phase0/p2p-interface.md Co-authored-by: Mikhail Kalinin <noblesse.knight@gmail.com> Update specs/deneb/p2p-interface.md Co-authored-by: Mikhail Kalinin <noblesse.knight@gmail.com> Update specs/deneb/p2p-interface.md Co-authored-by: danny <dannyjryan@gmail.com> remove gossip failure rules Apply suggestions from code review bump version to v1.4.0-beta.5 Move `blob_sidecar_{subnet_id}` to `Blob subnets` section Misc minor fix Add linter support Add column subnet validation. Split `verify_column_sidecar` into two functions Fix `get_data_column_sidecars` by using `compute_samples_and_proofs` Apply suggestions from code review Co-authored-by: danny <dannyjryan@gmail.com> Do not assign row custody Apply suggestions from code review Co-authored-by: danny <dannyjryan@gmail.com> Revamp reconstruction section Use depth as the primary preset for inclusion proof. Fix `get_data_column_sidecars` and add tests for merkle proof Change `SAMPLES_PER_SLOT` to 8 and add tests (requirement TBD) Apply PR feedback from @ppopth and @jtraglia Fix `get_data_column_sidecars` Co-authored-by: Pop Chunhapanya <haxx.pop@gmail.com> Apply suggestions from code review Co-authored-by: Pop Chunhapanya <haxx.pop@gmail.com> Apply suggestions from code review Co-authored-by: fradamt <104826920+fradamt@users.noreply.github.com> Co-authored-by: Jacob Kaufmann <jacobkaufmann18@gmail.com> Fix `get_data_column_sidecars` and `get_custody_lines` Apply suggestions from code review Co-authored-by: Jacob Kaufmann <jacobkaufmann18@gmail.com> Enhance tests fix typo Co-authored-by: fradamt <104826920+fradamt@users.noreply.github.com> Remove `epoch` from `get_custody_lines` fix fix
2023-11-14 12:04:42 +03:00
# EIP7594
EIP7594_FORK_VERSION: 0x06000001
EIP7594_FORK_EPOCH: 18446744073709551615
Misc fix
2024-04-27 12:11:29 +08:00
# WHISK
WHISK_FORK_VERSION: 0x08000001
WHISK_FORK_EPOCH: 18446744073709551615
Fix and add `EIP7732_FORK_EPOCH` and `EIP7594_FORK_VERSION`
2024-07-03 20:49:56 +08:00
# EIP7732
EIP7732_FORK_VERSION: 0x09000001
EIP7732_FORK_EPOCH: 18446744073709551615
update with configs<>presets separation
2021-05-06 19:49:33 +02:00
# Time parameters
# ---------------------------------------------------------------
# [customized] Faster for testing purposes
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
clarify config/preset separation, address review comments by @djrtwo
2021-05-19 17:15:34 +02:00
# Validator cycle
update with configs<>presets separation
2021-05-06 19:49:33 +02: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 17:15:34 +02:00
# 2**4 * 10**9 (= 16,000,000,000) Gwei
EJECTION_BALANCE: 16000000000
Apply suggestions from code review Co-authored-by: danny <dannyjryan@gmail.com>
2023-09-15 22:02:34 +08:00
# [customized] more easily demonstrate the difference between this value and the activation churn limit
Add basic activation churn limit tests
2023-09-13 17:04:39 +08:00
MIN_PER_EPOCH_CHURN_LIMIT: 2
add process_registry_updates tests for scaled churn limit
2021-09-07 20:34:28 -06:00
# [customized] scale queue churn at much lower validator counts for testing
CHURN_LIMIT_QUOTIENT: 32
Add EIP-7514 into Deneb
2023-09-15 10:25:47 +08:00
# [New in Deneb:EIP7514] [customized]
MAX_PER_EPOCH_ACTIVATION_CHURN_LIMIT: 4
update with configs<>presets separation
2021-05-06 19:49:33 +02:00
add PROPOSER_SCORE_BOOST to configuration yaml files
2021-11-22 17:02:46 -07:00
# Fork choice
# ---------------------------------------------------------------
Update PROPOSER_SCORE_BOOST to 40 percent (#2895)
2022-05-20 21:15:40 +02:00
# 40%
PROPOSER_SCORE_BOOST: 40
Update config files
2023-10-25 01:42:30 +08:00
# 20%
Clarifications for proposer boost reorgs
2023-10-26 17:44:48 +11:00
REORG_HEAD_WEIGHT_THRESHOLD: 20
Update config files
2023-10-25 01:42:30 +08: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-22 17:02:46 -07:00
update with configs<>presets separation
2021-05-06 19:49:33 +02:00
# Deposit contract
# ---------------------------------------------------------------
# Ethereum Goerli testnet
DEPOSIT_CHAIN_ID: 5
DEPOSIT_NETWORK_ID: 5
# Configured on a per testnet basis
DEPOSIT_CONTRACT_ADDRESS: 0x1234567890123456789012345678901234567890
Add networking configs to config files
2023-05-16 23:36:52 +08: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-10 01:12:38 +10:00
# `10 * 2**20` (= 10485760, 10 MiB)
GOSSIP_MAX_SIZE: 10485760
Add networking configs to config files
2023-05-16 23:36:52 +08:00
# `2**10` (= 1024)
MAX_REQUEST_BLOCKS: 1024
move epoch subscription length to config
2023-05-23 13:52:36 -06:00
# `2**8` (= 256)
EPOCHS_PER_SUBNET_SUBSCRIPTION: 256
Add networking configs to config files
2023-05-16 23:36:52 +08:00
# [customized] `MIN_VALIDATOR_WITHDRAWABILITY_DELAY + CHURN_LIMIT_QUOTIENT // 2` (= 272)
MIN_EPOCHS_FOR_BLOCK_REQUESTS: 272
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-10 01:12:38 +10:00
# `10 * 2**20` (=10485760, 10 MiB)
MAX_CHUNK_SIZE: 10485760
Add networking configs to config files
2023-05-16 23:36:52 +08: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 23:10:00 +08:00
# Deneb
# `2**7` (=128)
MAX_REQUEST_BLOCKS_DENEB: 128
# `2**12` (= 4096 epochs, ~18 days)
MIN_EPOCHS_FOR_BLOB_SIDECARS_REQUESTS: 4096
Move `BLOB_SIDECAR_SUBNET_COUNT` to networking config
2023-06-12 23:57:21 +08:00
# `6`
BLOB_SIDECAR_SUBNET_COUNT: 6
Make MAX_BLOBS_PER_BLOCK a config parameter
2024-06-25 18:22:16 +02:00
## `uint64(6)`
MAX_BLOBS_PER_BLOCK: 6
Add EIP-7691
2024-11-27 00:17:42 +08:00
# MAX_REQUEST_BLOCKS_DENEB * MAX_BLOBS_PER_BLOCK
MAX_REQUEST_BLOB_SIDECARS: 768
# Electra
# [customized] 2**6 * 10**9 (= 64,000,000,000)
Introduce TARGET_BLOBS_PER_BLOCK_ELECTRA
2024-12-03 10:05:12 -06:00
MIN_PER_EPOCH_CHURN_LIMIT_ELECTRA: 64000000000
Add EIP-7691
2024-11-27 00:17:42 +08:00
# [customized] 2**7 * 10**9 (= 128,000,000,000)
MAX_PER_EPOCH_ACTIVATION_EXIT_CHURN_LIMIT: 128000000000
# `9`
BLOB_SIDECAR_SUBNET_COUNT_ELECTRA: 9
Introduce TARGET_BLOBS_PER_BLOCK_ELECTRA
2024-12-03 10:05:12 -06:00
# `uint64(6)`
TARGET_BLOBS_PER_BLOCK_ELECTRA: 6
Put TARGET_BLOBS_PER_BLOCK before MAX_BLOBS_PER_BLOCK
2024-12-05 11:43:51 -06:00
# `uint64(9)`
MAX_BLOBS_PER_BLOCK_ELECTRA: 9
Add EIP-7691
2024-11-27 00:17:42 +08:00
# MAX_REQUEST_BLOCKS_DENEB * MAX_BLOBS_PER_BLOCK_ELECTRA
MAX_REQUEST_BLOB_SIDECARS_ELECTRA: 1152
Update preset and config files
2023-08-21 11:58:08 +02:00
# Whisk
WHISK_EPOCHS_PER_SHUFFLING_PHASE: 4
WHISK_PROPOSER_SELECTION_GAP: 1
Make `CUSTODY_REQUIREMENT` unit be subnets; move some depended helpers to `das-core.md`
2024-01-20 00:24:53 +08:00
# EIP7594
Apply PR feedback
2024-02-27 22:42:32 +09:00
NUMBER_OF_COLUMNS: 128
EIP-7594: Decouple network subnets from das-core Currently we use subnets as a unit of custody in the PeerDAS core protocol because it doesn't make sense to partially custody only some columns in the subnets and waste the bandwidth to download the columns the node doesn't custody. Since subnets correspond to GossipSub topics which are in a layer lower than the core protocol, using subnets as a unit of custody makes the core layer and the network layer too coupled to each other and leave no room for the network layer flexibility. This commit introduces "custody groups" which are used a unit of custody instead of subnets. The immediate benefit of the decoupling is that we can immediately increase the number of subnets without affecting the expected number of peers to cover all columns and affecting the network stability and without touching the core protocol. The reason we want to increase the number of subnets to match the number of columns is that the columns will be propagated through the network faster when they have their own subnets. Just like EIP-4844, each blob has its own subnet because, if all the blobs are in a single subnet, the blobs will be propagated more slowly. Since we keep the number of custody groups the same as the previous number of subnets (32), the expected number of peers you need to cover all the columns is not changed. In fact, you need only NUMBER_OF_COLUMNS and NUMBER_OF_CUSTODY_GROUPS to analyze the expected number, which makes the core protocol completely decoupled from the network layer.
2024-06-29 16:45:29 +07:00
NUMBER_OF_CUSTODY_GROUPS: 128
adjust configs
2024-08-07 17:41:26 +02:00
DATA_COLUMN_SIDECAR_SUBNET_COUNT: 128
Apply PR feedback
2024-02-27 22:42:32 +09: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 15:34:41 +03:00
SAMPLES_PER_SLOT: 8
adjust configs
2024-08-07 17:41:26 +02:00
CUSTODY_REQUIREMENT: 4
Make necessary changes for EIP7594 spec Previous to this commit, the max blob count for EIP7594 was 8. Now that we have raised the target/max to 6/9 for Electra, the max blob count for EIP7594 no longer makes sense. I've raised the target/max for it to 9/12 as a placeholder. This also serves as an example of what changes are necessary to increase the blob count in the future.
2024-12-05 12:57:06 -06:00
TARGET_BLOBS_PER_BLOCK_EIP7594: 9
MAX_BLOBS_PER_BLOCK_EIP7594: 12
Add `BLOB_SIDECAR_SUBNET_COUNT_EIP7594`, `MAX_BLOBS_PER_BLOCK_EIP7594`, and `MAX_REQUEST_BLOB_SIDECARS_EIP7594`
2024-11-13 13:42:15 +07:00
# `MAX_REQUEST_BLOCKS_DENEB * MAX_BLOBS_PER_BLOCK_EIP7594`
Make necessary changes for EIP7594 spec Previous to this commit, the max blob count for EIP7594 was 8. Now that we have raised the target/max to 6/9 for Electra, the max blob count for EIP7594 no longer makes sense. I've raised the target/max for it to 9/12 as a placeholder. This also serves as an example of what changes are necessary to increase the blob count in the future.
2024-12-05 12:57:06 -06:00
MAX_REQUEST_BLOB_SIDECARS_EIP7594: 1536
Add EIP-7251 spec Co-authored-by: fradamt <104826920+fradamt@users.noreply.github.com>
2024-03-08 11:41:20 +08:00
EIP-7732: Modify `ExecutionPayloadEnvelopeByRoot`
2024-08-20 13:54:36 +03:00
# EIP7732
MAX_REQUEST_PAYLOADS: 128
Reference in New Issue Copy Permalink