eth2.0-specs/configs/minimal.yaml

# Minimal preset


# Misc
# ---------------------------------------------------------------

# [customized] Just 4 committees for slot for testing purposes
MAX_COMMITTEES_PER_SLOT: 4
# [customized] unsecure, but fast
TARGET_COMMITTEE_SIZE: 4
# 2**11 (= 2,048)
MAX_VALIDATORS_PER_COMMITTEE: 2048
# 2**2 (= 4)
MIN_PER_EPOCH_CHURN_LIMIT: 4
# 2**16 (= 65,536)
CHURN_LIMIT_QUOTIENT: 65536
# [customized] Faster, but unsecure.
SHUFFLE_ROUND_COUNT: 10
# [customized]
MIN_GENESIS_ACTIVE_VALIDATOR_COUNT: 64
# Jan 3, 2020
MIN_GENESIS_TIME: 1578009600

#
#
# Fork Choice
# ---------------------------------------------------------------
# 2**1 (= 1)
SAFE_SLOTS_TO_UPDATE_JUSTIFIED: 2

#
# Validator
# ---------------------------------------------------------------
# [customized] process deposits more quickly, but insecure
ETH1_FOLLOW_DISTANCE: 16
# 2**4 (= 16)
TARGET_AGGREGATORS_PER_COMMITTEE: 16
# 2**0 (= 1)
RANDOM_SUBNETS_PER_VALIDATOR: 1
# 2**8 (= 256)
EPOCHS_PER_RANDOM_SUBNET_SUBSCRIPTION: 256
# 14 (estimate from Eth1 mainnet)
SECONDS_PER_ETH1_BLOCK: 14


# Deposit contract
# ---------------------------------------------------------------
# **TBD**
DEPOSIT_CONTRACT_ADDRESS: 0x1234567890123456789012345678901234567890


# Gwei values
# ---------------------------------------------------------------
# 2**0 * 10**9 (= 1,000,000,000) Gwei
MIN_DEPOSIT_AMOUNT: 1000000000
# 2**5 * 10**9 (= 32,000,000,000) Gwei
MAX_EFFECTIVE_BALANCE: 32000000000
# 2**4 * 10**9 (= 16,000,000,000) Gwei
EJECTION_BALANCE: 16000000000
# 2**0 * 10**9 (= 1,000,000,000) Gwei
EFFECTIVE_BALANCE_INCREMENT: 1000000000


# Initial values
# ---------------------------------------------------------------
# 0, GENESIS_EPOCH is derived from this constant
GENESIS_SLOT: 0
# Highest byte set to 0x01 to avoid collisions with mainnet versioning
GENESIS_FORK_VERSION: 0x00000001
BLS_WITHDRAWAL_PREFIX: 0x00


# Time parameters
# ---------------------------------------------------------------
# [customized] Faster to spin up testnets, but does not give validator reasonable warning time for genesis
MIN_GENESIS_DELAY: 300
# [customized] Faster for testing purposes
SECONDS_PER_SLOT: 6
# 2**0 (= 1) slots 6 seconds
MIN_ATTESTATION_INCLUSION_DELAY: 1
# [customized] fast epochs
SLOTS_PER_EPOCH: 8
# 2**0 (= 1) epochs
MIN_SEED_LOOKAHEAD: 1
# 2**2 (= 4) epochs
MAX_SEED_LOOKAHEAD: 4
# [customized] higher frequency new deposits from eth1 for testing
SLOTS_PER_ETH1_VOTING_PERIOD: 16
# [customized] smaller state
SLOTS_PER_HISTORICAL_ROOT: 64
# 2**8 (= 256) epochs
MIN_VALIDATOR_WITHDRAWABILITY_DELAY: 256
# 2**11 (= 2,048) epochs
PERSISTENT_COMMITTEE_PERIOD: 2048
# [customized] fast catchup crosslinks
MAX_EPOCHS_PER_CROSSLINK: 4
# 2**2 (= 4) epochs
MIN_EPOCHS_TO_INACTIVITY_PENALTY: 4
# [customized] 2**12 (= 4,096) epochs
EARLY_DERIVED_SECRET_PENALTY_MAX_FUTURE_EPOCHS: 4096
# 2**2 (= 4) epochs
EPOCHS_PER_CUSTODY_PERIOD: 4
# 2**2 (= 4) epochs
CUSTODY_PERIOD_TO_RANDAO_PADDING: 4


# State vector lengths
# ---------------------------------------------------------------
# [customized] smaller state
EPOCHS_PER_HISTORICAL_VECTOR: 64
# [customized] smaller state
EPOCHS_PER_SLASHINGS_VECTOR: 64
# 2**24 (= 16,777,216) historical roots
HISTORICAL_ROOTS_LIMIT: 16777216
# 2**40 (= 1,099,511,627,776) validator spots
VALIDATOR_REGISTRY_LIMIT: 1099511627776


# Reward and penalty quotients
# ---------------------------------------------------------------
# 2**6 (= 64)
BASE_REWARD_FACTOR: 64
# 2**9 (= 512)
WHISTLEBLOWER_REWARD_QUOTIENT: 512
# 2**3 (= 8)
PROPOSER_REWARD_QUOTIENT: 8
# 2**25 (= 33,554,432)
INACTIVITY_PENALTY_QUOTIENT: 33554432
# 2**5 (= 32)
MIN_SLASHING_PENALTY_QUOTIENT: 32


# Max operations per block
# ---------------------------------------------------------------
# 2**4 (= 16)
MAX_PROPOSER_SLASHINGS: 16
# 2**0 (= 1)
MAX_ATTESTER_SLASHINGS: 1
# 2**7 (= 128)
MAX_ATTESTATIONS: 128
# 2**4 (= 16)
MAX_DEPOSITS: 16
# 2**4 (= 16)
MAX_VOLUNTARY_EXITS: 16


# Signature domains
# ---------------------------------------------------------------
DOMAIN_BEACON_PROPOSER: 0x00000000
DOMAIN_BEACON_ATTESTER: 0x01000000
DOMAIN_RANDAO: 0x02000000
DOMAIN_DEPOSIT: 0x03000000
DOMAIN_VOLUNTARY_EXIT: 0x04000000
DOMAIN_CUSTODY_BIT_CHALLENGE: 0x06000000
DOMAIN_SHARD_PROPOSER: 0x80000000
DOMAIN_SHARD_ATTESTER: 0x81000000


# Phase 1
# ---------------------------------------------------------------
SHARD_SLOTS_PER_BEACON_SLOT: 2
EPOCHS_PER_SHARD_PERIOD: 4
# PHASE_1_FORK_EPOCH >= EPOCHS_PER_SHARD_PERIOD * 2
PHASE_1_FORK_EPOCH: 8
# PHASE_1_FORK_SLOT = PHASE_1_FORK_EPOCH * SLOTS_PER_EPOCH
PHASE_1_FORK_SLOT: 64
include example configs and fork timelines, with format spec 2019-04-07 04:46:37 +00:00			`# Minimal preset`


			`# Misc`
			`# ---------------------------------------------------------------`

cleanup wrt Justin's comments 2019-10-17 08:47:51 +00:00			`# [customized] Just 4 committees for slot for testing purposes`
get crosslink committees by slot 2019-10-13 12:52:58 +00:00			`MAX_COMMITTEES_PER_SLOT: 4`
include minimal testing constants from previous pytests 2019-04-07 06:17:42 +00:00			`# [customized] unsecure, but fast`
			`TARGET_COMMITTEE_SIZE: 4`
update constants for phase 0 simplification 2019-10-20 04:38:00 +00:00			`# 2**11 (= 2,048)`
			`MAX_VALIDATORS_PER_COMMITTEE: 2048`
update constants to match latest dev (#933) 2019-04-16 04:57:57 +00:00			`# 2**2 (= 4)`
			`MIN_PER_EPOCH_CHURN_LIMIT: 4`
			`# 2**16 (= 65,536)`
			`CHURN_LIMIT_QUOTIENT: 65536`
			`# [customized] Faster, but unsecure.`
overhaul shuffling tests, focus on swap-or-not shuffle 2019-04-11 08:33:46 +00:00			`SHUFFLE_ROUND_COUNT: 10`
Fix `is_genesis_trigger` and add test case 2019-06-21 22:30:31 +00:00			`# [customized]`
fix genesis tests; sign deposit-datas, and lower min validator count for testing 2019-06-30 00:10:18 +00:00			`MIN_GENESIS_ACTIVE_VALIDATOR_COUNT: 64`
last few config fixes to match spec 2019-07-01 04:31:14 +00:00			`# Jan 3, 2020`
			`MIN_GENESIS_TIME: 1578009600`

further test bounce attack 2019-11-05 17:58:45 +00:00			`#`
			`#`
			`# Fork Choice`
			`# ---------------------------------------------------------------`
			`# 2**1 (= 1)`
			`SAFE_SLOTS_TO_UPDATE_JUSTIFIED: 2`
include example configs and fork timelines, with format spec 2019-04-07 04:46:37 +00:00
add validator constants to config 2019-11-12 15:42:57 +00:00			`#`
			`# Validator`
			`# ---------------------------------------------------------------`
			`# [customized] process deposits more quickly, but insecure`
			`ETH1_FOLLOW_DISTANCE: 16`
			`# 2**4 (= 16)`
			`TARGET_AGGREGATORS_PER_COMMITTEE: 16`
			`# 2**0 (= 1)`
			`RANDOM_SUBNETS_PER_VALIDATOR: 1`
			`# 2**8 (= 256)`
			`EPOCHS_PER_RANDOM_SUBNET_SUBSCRIPTION: 256`
modify get_eth1_data to use timestamp instead of block height 2020-01-03 16:37:37 +00:00			`# 14 (estimate from Eth1 mainnet)`
			`SECONDS_PER_ETH1_BLOCK: 14`
add validator constants to config 2019-11-12 15:42:57 +00:00
include example configs and fork timelines, with format spec 2019-04-07 04:46:37 +00:00
			`# Deposit contract`
			`# ---------------------------------------------------------------`
			`# TBD`
fix deposit contract placeholder address length 2019-04-14 09:38:37 +00:00			`DEPOSIT_CONTRACT_ADDRESS: 0x1234567890123456789012345678901234567890`
include example configs and fork timelines, with format spec 2019-04-07 04:46:37 +00:00

			`# Gwei values`
			`# ---------------------------------------------------------------`
update constants to match latest dev (#933) 2019-04-16 04:57:57 +00:00			`# 2*0 10**9 (= 1,000,000,000) Gwei`
include example configs and fork timelines, with format spec 2019-04-07 04:46:37 +00:00			`MIN_DEPOSIT_AMOUNT: 1000000000`
update constants to match latest dev (#933) 2019-04-16 04:57:57 +00:00			`# 2*5 10**9 (= 32,000,000,000) Gwei`
update config constants 2019-04-24 09:30:13 +00:00			`MAX_EFFECTIVE_BALANCE: 32000000000`
update constants to match latest dev (#933) 2019-04-16 04:57:57 +00:00			`# 2*4 10**9 (= 16,000,000,000) Gwei`
include example configs and fork timelines, with format spec 2019-04-07 04:46:37 +00:00			`EJECTION_BALANCE: 16000000000`
update constants to match latest dev (#933) 2019-04-16 04:57:57 +00:00			`# 2*0 10**9 (= 1,000,000,000) Gwei`
update configs 2019-04-26 07:57:20 +00:00			`EFFECTIVE_BALANCE_INCREMENT: 1000000000`
include example configs and fork timelines, with format spec 2019-04-07 04:46:37 +00:00

			`# Initial values`
			`# ---------------------------------------------------------------`
small constants update to reflect new genesis slot, and rename block sig domain (#978) 2019-04-22 06:38:44 +00:00			`# 0, GENESIS_EPOCH is derived from this constant`
			`GENESIS_SLOT: 0`
add GENESIS_FORK_VERSION and make associated modifications to support configuration of this variable 2020-01-04 00:48:03 +00:00			`# Highest byte set to 0x01 to avoid collisions with mainnet versioning`
			`GENESIS_FORK_VERSION: 0x00000001`
make config values reflect the withdrawal prefix is a byte 2019-06-30 22:26:46 +00:00			`BLS_WITHDRAWAL_PREFIX: 0x00`
include example configs and fork timelines, with format spec 2019-04-07 04:46:37 +00:00

			`# Time parameters`
			`# ---------------------------------------------------------------`
make genesis delay configurable 2020-01-05 22:29:23 +00:00			`# [customized] Faster to spin up testnets, but does not give validator reasonable warning time for genesis`
			`MIN_GENESIS_DELAY: 300`
update constants for phase 0 simplification 2019-10-20 04:38:00 +00:00			`# [customized] Faster for testing purposes`
include example configs and fork timelines, with format spec 2019-04-07 04:46:37 +00:00			`SECONDS_PER_SLOT: 6`
last few config fixes to match spec 2019-07-01 04:31:14 +00:00			`# 2**0 (= 1) slots 6 seconds`
			`MIN_ATTESTATION_INCLUSION_DELAY: 1`
include minimal testing constants from previous pytests 2019-04-07 06:17:42 +00:00			`# [customized] fast epochs`
			`SLOTS_PER_EPOCH: 8`
update naming of 2 constants, fix comments in minimal config (mainnet time estimates do not hold with different amount of slots per epoch) 2019-06-11 15:07:48 +00:00			`# 2**0 (= 1) epochs`
include example configs and fork timelines, with format spec 2019-04-07 04:46:37 +00:00			`MIN_SEED_LOOKAHEAD: 1`
update naming of 2 constants, fix comments in minimal config (mainnet time estimates do not hold with different amount of slots per epoch) 2019-06-11 15:07:48 +00:00			`# 2**2 (= 4) epochs`
Rename ACTIVATION_EXIT_DELAY to MAX_SEED_LOOKAHEAD for phase 1 2019-09-23 18:07:10 +00:00			`MAX_SEED_LOOKAHEAD: 4`
Work for new pyspec based test generators 2019-04-07 13:36:05 +00:00			`# [customized] higher frequency new deposits from eth1 for testing`
update constants for eth1 data voting to match spec (#952) 2019-04-17 05:23:14 +00:00			`SLOTS_PER_ETH1_VOTING_PERIOD: 16`
include minimal testing constants from previous pytests 2019-04-07 06:17:42 +00:00			`# [customized] smaller state`
			`SLOTS_PER_HISTORICAL_ROOT: 64`
update naming of 2 constants, fix comments in minimal config (mainnet time estimates do not hold with different amount of slots per epoch) 2019-06-11 15:07:48 +00:00			`# 2**8 (= 256) epochs`
include example configs and fork timelines, with format spec 2019-04-07 04:46:37 +00:00			`MIN_VALIDATOR_WITHDRAWABILITY_DELAY: 256`
update naming of 2 constants, fix comments in minimal config (mainnet time estimates do not hold with different amount of slots per epoch) 2019-06-11 15:07:48 +00:00			`# 2**11 (= 2,048) epochs`
include example configs and fork timelines, with format spec 2019-04-07 04:46:37 +00:00			`PERSISTENT_COMMITTEE_PERIOD: 2048`
fix max epochs var 2019-10-12 05:44:53 +00:00			`# [customized] fast catchup crosslinks`
			`MAX_EPOCHS_PER_CROSSLINK: 4`
update naming of 2 constants, fix comments in minimal config (mainnet time estimates do not hold with different amount of slots per epoch) 2019-06-11 15:07:48 +00:00			`# 2**2 (= 4) epochs`
update configs 2019-04-26 07:57:20 +00:00			`MIN_EPOCHS_TO_INACTIVITY_PENALTY: 4`
update naming of 2 constants, fix comments in minimal config (mainnet time estimates do not hold with different amount of slots per epoch) 2019-06-11 15:07:48 +00:00			`# [customized] 2**12 (= 4,096) epochs`
Dramatically speed up tests 2019-05-22 10:40:57 +00:00			`EARLY_DERIVED_SECRET_PENALTY_MAX_FUTURE_EPOCHS: 4096`
Legendre custody construction (#1305) * Stab at Legendre custody construction + some tests * Fix some problems and fix function puller to remove phase0 only lines in phase1 * Pass the linter * Add headings * Fix domain for BLS stub * Change Jacobi to Legendre * n -> q to clarify notation * Headings * Another missing heading * Custody subchunks via padding * Fix max_reveal_lateness stuff * Better names for reveal period functions * Better parametrization of max_reveal_lateness computation and tests for custody reveal processing * Fix linter * Allow challenging for one period after the custody reveal, shorter periods for minimal tests * Fix lint * Fix linter error 2019-08-11 17:05:17 +00:00			`# 2**2 (= 4) epochs`
			`EPOCHS_PER_CUSTODY_PERIOD: 4`
			`# 2**2 (= 4) epochs`
			`CUSTODY_PERIOD_TO_RANDAO_PADDING: 4`
include example configs and fork timelines, with format spec 2019-04-07 04:46:37 +00:00

Increase historical length and cleanups (#1196) * increase historical length and a few cleanups 2019-06-19 19:59:44 +00:00			`# State vector lengths`
include example configs and fork timelines, with format spec 2019-04-07 04:46:37 +00:00			`# ---------------------------------------------------------------`
include minimal testing constants from previous pytests 2019-04-07 06:17:42 +00:00			`# [customized] smaller state`
Increase historical length and cleanups (#1196) * increase historical length and a few cleanups 2019-06-19 19:59:44 +00:00			`EPOCHS_PER_HISTORICAL_VECTOR: 64`
include minimal testing constants from previous pytests 2019-04-07 06:17:42 +00:00			`# [customized] smaller state`
Slashing penalty calculation change (#1217) If the exit queue is very long, then a validator may take many months to exit. With the code as currently written, however, self-slashing is a potentially lucrative route to get one's money out faster, because one can exit in 36 days. This PR changes it so that slashing can only extend your withdrawal time, not contract it. Also, instead of the slashed balances used to calculate one's slashing penalty being those in `[withdrawal - 54 days ... withdrawal - 18 days]`, we now run the penalization algorithm once every 36 days that a validator is slashed but not withdrawn, so that it covers the 36-day period where the validator was actually slashed. It also moves the minimum slashing penalty to the `slash_validator` function so that it is only applied once. We also simplify the `slashed_balances` logic to be per-epoch. 2019-06-28 13:35:26 +00:00			`EPOCHS_PER_SLASHINGS_VECTOR: 64`
clean up list limit constants 2019-06-24 21:38:36 +00:00			`# 2**24 (= 16,777,216) historical roots`
			`HISTORICAL_ROOTS_LIMIT: 16777216`
			`# 2**40 (= 1,099,511,627,776) validator spots`
			`VALIDATOR_REGISTRY_LIMIT: 1099511627776`
include example configs and fork timelines, with format spec 2019-04-07 04:46:37 +00:00

			`# Reward and penalty quotients`
			`# ---------------------------------------------------------------`
last few config fixes to match spec 2019-07-01 04:31:14 +00:00			`# 2**6 (= 64)`
			`BASE_REWARD_FACTOR: 64`
update constants to match latest dev (#933) 2019-04-16 04:57:57 +00:00			`# 2**9 (= 512)`
Slashing penalty calculation change (#1217) If the exit queue is very long, then a validator may take many months to exit. With the code as currently written, however, self-slashing is a potentially lucrative route to get one's money out faster, because one can exit in 36 days. This PR changes it so that slashing can only extend your withdrawal time, not contract it. Also, instead of the slashed balances used to calculate one's slashing penalty being those in `[withdrawal - 54 days ... withdrawal - 18 days]`, we now run the penalization algorithm once every 36 days that a validator is slashed but not withdrawn, so that it covers the 36-day period where the validator was actually slashed. It also moves the minimum slashing penalty to the `slash_validator` function so that it is only applied once. We also simplify the `slashed_balances` logic to be per-epoch. 2019-06-28 13:35:26 +00:00			`WHISTLEBLOWER_REWARD_QUOTIENT: 512`
update constants to match latest dev (#933) 2019-04-16 04:57:57 +00:00			`# 2**3 (= 8)`
include example configs and fork timelines, with format spec 2019-04-07 04:46:37 +00:00			`PROPOSER_REWARD_QUOTIENT: 8`
update configs 2019-04-26 07:57:20 +00:00			`# 2**25 (= 33,554,432)`
			`INACTIVITY_PENALTY_QUOTIENT: 33554432`
			`# 2**5 (= 32)`
			`MIN_SLASHING_PENALTY_QUOTIENT: 32`
include example configs and fork timelines, with format spec 2019-04-07 04:46:37 +00:00

			`# Max operations per block`
			`# ---------------------------------------------------------------`
update constants to match latest dev (#933) 2019-04-16 04:57:57 +00:00			`# 2**4 (= 16)`
include example configs and fork timelines, with format spec 2019-04-07 04:46:37 +00:00			`MAX_PROPOSER_SLASHINGS: 16`
update constants to match latest dev (#933) 2019-04-16 04:57:57 +00:00			`# 2**0 (= 1)`
include example configs and fork timelines, with format spec 2019-04-07 04:46:37 +00:00			`MAX_ATTESTER_SLASHINGS: 1`
update constants to match latest dev (#933) 2019-04-16 04:57:57 +00:00			`# 2**7 (= 128)`
include example configs and fork timelines, with format spec 2019-04-07 04:46:37 +00:00			`MAX_ATTESTATIONS: 128`
update constants to match latest dev (#933) 2019-04-16 04:57:57 +00:00			`# 2**4 (= 16)`
include example configs and fork timelines, with format spec 2019-04-07 04:46:37 +00:00			`MAX_DEPOSITS: 16`
update constants to match latest dev (#933) 2019-04-16 04:57:57 +00:00			`# 2**4 (= 16)`
include example configs and fork timelines, with format spec 2019-04-07 04:46:37 +00:00			`MAX_VOLUNTARY_EXITS: 16`


			`# Signature domains`
			`# ---------------------------------------------------------------`
type BLS domain and domain type 2019-06-30 20:12:02 +00:00			`DOMAIN_BEACON_PROPOSER: 0x00000000`
Add domain_type to get_seed 2019-09-22 19:27:42 +00:00			`DOMAIN_BEACON_ATTESTER: 0x01000000`
			`DOMAIN_RANDAO: 0x02000000`
type BLS domain and domain type 2019-06-30 20:12:02 +00:00			`DOMAIN_DEPOSIT: 0x03000000`
			`DOMAIN_VOLUNTARY_EXIT: 0x04000000`
Add phase 1 domain to constant_presets files 2019-07-04 12:46:47 +00:00			`DOMAIN_CUSTODY_BIT_CHALLENGE: 0x06000000`
			`DOMAIN_SHARD_PROPOSER: 0x80000000`
			`DOMAIN_SHARD_ATTESTER: 0x81000000`
Add simple tests for `shard_state_transition` 2019-08-01 06:19:08 +00:00

			`# Phase 1`
			`# ---------------------------------------------------------------`
			`SHARD_SLOTS_PER_BEACON_SLOT: 2`
			`EPOCHS_PER_SHARD_PERIOD: 4`
			`# PHASE_1_FORK_EPOCH >= EPOCHS_PER_SHARD_PERIOD * 2`
			`PHASE_1_FORK_EPOCH: 8`
Shard slot -> slot for PHASE_1_FORK_SLOT part2 2019-08-27 12:10:39 +00:00			`# PHASE_1_FORK_SLOT = PHASE_1_FORK_EPOCH * SLOTS_PER_EPOCH`
			`PHASE_1_FORK_SLOT: 64`