171 lines
6.3 KiB
Nim
171 lines
6.3 KiB
Nim
# beacon_chain
|
|
# Copyright (c) 2018-2019 Status Research & Development GmbH
|
|
# Licensed and distributed under either of
|
|
# * MIT license (license terms in the root directory or at http://opensource.org/licenses/MIT).
|
|
# * Apache v2 license (license terms in the root directory or at http://www.apache.org/licenses/LICENSE-2.0).
|
|
# at your option. This file may not be copied, modified, or distributed except according to those terms.
|
|
|
|
# This file contains constants that are part of the spec and thus subject to
|
|
# serialization and spec updates.
|
|
|
|
import
|
|
math
|
|
|
|
type
|
|
Slot* = distinct uint64
|
|
Epoch* = distinct uint64
|
|
|
|
{.experimental: "codeReordering".} # SLOTS_PER_EPOCH is use before being defined in spec
|
|
|
|
const
|
|
# Misc
|
|
# ---------------------------------------------------------------
|
|
# https://github.com/ethereum/eth2.0-specs/blob/v0.8.4/specs/core/0_beacon-chain.md#misc
|
|
|
|
SHARD_COUNT* {.intdefine.} = 1024 ##\
|
|
## Number of shards supported by the network - validators will jump around
|
|
## between these shards and provide attestations to their state.
|
|
## Compile with -d:SHARD_COUNT=4 for fewer shard (= better with low validator counts)
|
|
|
|
TARGET_COMMITTEE_SIZE* = 2^7 ##\
|
|
## Number of validators in the committee attesting to one shard
|
|
## Per spec:
|
|
## For the safety of crosslinks `TARGET_COMMITTEE_SIZE` exceeds
|
|
## [the recommended minimum committee size of 111](https://vitalik.ca/files/Ithaca201807_Sharding.pdf);
|
|
## with sufficient active validators (at least
|
|
## `SLOTS_PER_EPOCH * TARGET_COMMITTEE_SIZE`), the shuffling algorithm ensures
|
|
## committee sizes at least `TARGET_COMMITTEE_SIZE`. (Unbiasable randomness
|
|
## with a Verifiable Delay Function (VDF) will improve committee robustness
|
|
## and lower the safe minimum committee size.)
|
|
|
|
MAX_VALIDATORS_PER_COMMITTEE* = 2^12 ##\
|
|
## votes
|
|
|
|
MIN_PER_EPOCH_CHURN_LIMIT* = 4
|
|
|
|
CHURN_LIMIT_QUOTIENT* = 2^16
|
|
|
|
SHUFFLE_ROUND_COUNT* = 90
|
|
|
|
# Constants (TODO: not actually configurable)
|
|
# https://github.com/ethereum/eth2.0-specs/blob/v0.8.4/specs/core/0_beacon-chain.md#constants
|
|
BASE_REWARDS_PER_EPOCH* = 5
|
|
|
|
DEPOSIT_CONTRACT_TREE_DEPTH* = 32
|
|
|
|
# Gwei values
|
|
# ---------------------------------------------------------------
|
|
# https://github.com/ethereum/eth2.0-specs/blob/v0.8.4/specs/core/0_beacon-chain.md#gwei-values
|
|
|
|
MIN_DEPOSIT_AMOUNT* = 2'u64^0 * 10'u64^9 ##\
|
|
## Minimum amounth of ETH that can be deposited in one call - deposits can
|
|
## be used either to top up an existing validator or commit to a new one
|
|
|
|
MAX_EFFECTIVE_BALANCE* = 2'u64^5 * 10'u64^9 ##\
|
|
## Maximum amounth of ETH that can be deposited in one call
|
|
|
|
EJECTION_BALANCE* = 2'u64^4 * 10'u64^9 ##\
|
|
## Once the balance of a validator drops below this, it will be ejected from
|
|
## the validator pool
|
|
|
|
EFFECTIVE_BALANCE_INCREMENT* = 2'u64^0 * 10'u64^9
|
|
|
|
# Initial values
|
|
# ---------------------------------------------------------------
|
|
# https://github.com/ethereum/eth2.0-specs/blob/v0.8.3/configs/mainnet.yaml#L45
|
|
|
|
GENESIS_SLOT* = 0.Slot
|
|
BLS_WITHDRAWAL_PREFIX* = 0'u8
|
|
|
|
# Time parameters
|
|
# ---------------------------------------------------------------
|
|
# https://github.com/ethereum/eth2.0-specs/blob/v0.8.4/specs/core/0_fork-choice.md#time-parameters
|
|
|
|
SECONDS_PER_SLOT*{.intdefine.} = 6'u64 # Compile with -d:SECONDS_PER_SLOT=1 for 6x faster slots
|
|
## TODO consistent time unit across projects, similar to C++ chrono?
|
|
|
|
# https://github.com/ethereum/eth2.0-specs/blob/v0.8.4/specs/core/0_beacon-chain.md#time-parameters
|
|
MIN_ATTESTATION_INCLUSION_DELAY* = 1 ##\
|
|
## (24 seconds)
|
|
## Number of slots that attestations stay in the attestation
|
|
## pool before being added to a block.
|
|
## The attestation delay exists so that there is time for attestations to
|
|
## propagate before the block is created.
|
|
## When creating an attestation, the validator will look at the best
|
|
## information known to at that time, and may not revise it during the same
|
|
## slot (see `is_double_vote`) - the delay gives the validator a chance to
|
|
## wait towards the end of the slot and still have time to publish the
|
|
## attestation.
|
|
|
|
SLOTS_PER_EPOCH* {.intdefine.} = 64 ##\
|
|
## (~6.4 minutes)
|
|
## slots that make up an epoch, at the end of which more heavy
|
|
## processing is done
|
|
## Compile with -d:SLOTS_PER_EPOCH=4 for shorter epochs
|
|
|
|
MIN_SEED_LOOKAHEAD* = 1 ##\
|
|
## epochs (~6.4 minutes)
|
|
|
|
ACTIVATION_EXIT_DELAY* = 4 ##\
|
|
## epochs (~25.6 minutes)
|
|
|
|
SLOTS_PER_ETH1_VOTING_PERIOD* = 1024 ##\
|
|
## slots (~1.7 hours)
|
|
|
|
SLOTS_PER_HISTORICAL_ROOT* = 8192 ##\
|
|
## slots (13 hours)
|
|
|
|
MIN_VALIDATOR_WITHDRAWABILITY_DELAY* = 2'u64^8 ##\
|
|
## epochs (~27 hours)
|
|
|
|
PERSISTENT_COMMITTEE_PERIOD* = 2'u64^11 ##\
|
|
## epochs (9 days)
|
|
|
|
MAX_EPOCHS_PER_CROSSLINK* = 2'u64^6 ##\
|
|
## epochs (~7 hours)
|
|
|
|
MIN_EPOCHS_TO_INACTIVITY_PENALTY* = 2'u64^2 ##\
|
|
## epochs (25.6 minutes)
|
|
|
|
# State vector lengths
|
|
# ---------------------------------------------------------------
|
|
# https://github.com/ethereum/eth2.0-specs/blob/v0.8.3/configs/mainnet.yaml#L81
|
|
EPOCHS_PER_HISTORICAL_VECTOR* = 65536
|
|
EPOCHS_PER_SLASHINGS_VECTOR* = 8192
|
|
HISTORICAL_ROOTS_LIMIT* = 16777216
|
|
VALIDATOR_REGISTRY_LIMIT* = 1099511627776
|
|
|
|
# Reward and penalty quotients
|
|
# ---------------------------------------------------------------
|
|
# https://github.com/ethereum/eth2.0-specs/blob/v0.8.4/specs/core/0_beacon-chain.md#rewards-and-penalties
|
|
BASE_REWARD_FACTOR* = 2'u64^6
|
|
WHISTLEBLOWER_REWARD_QUOTIENT* = 2'u64^9
|
|
PROPOSER_REWARD_QUOTIENT* = 2'u64^3
|
|
INACTIVITY_PENALTY_QUOTIENT* = 2'u64^25
|
|
MIN_SLASHING_PENALTY_QUOTIENT* = 32 # 2^5
|
|
|
|
# Max operations per block
|
|
# ---------------------------------------------------------------
|
|
# https://github.com/ethereum/eth2.0-specs/blob/v0.8.4/specs/core/0_beacon-chain.md#max-operations-per-block
|
|
MAX_PROPOSER_SLASHINGS* = 2^4
|
|
MAX_ATTESTER_SLASHINGS* = 2^0
|
|
MAX_ATTESTATIONS* = 2^7
|
|
MAX_DEPOSITS* = 2^4
|
|
MAX_VOLUNTARY_EXITS* = 2^4
|
|
MAX_TRANSFERS* = 0
|
|
|
|
MIN_GENESIS_TIME* {.intdefine.} = 0
|
|
MIN_GENESIS_ACTIVE_VALIDATOR_COUNT* {.intdefine.} = 99
|
|
|
|
type
|
|
# Signature domains
|
|
# ---------------------------------------------------------------
|
|
# https://github.com/ethereum/eth2.0-specs/blob/v0.8.4/specs/core/0_beacon-chain.md#signature-domain-types
|
|
DomainType* {.pure.} = enum
|
|
DOMAIN_BEACON_PROPOSER = 0
|
|
DOMAIN_RANDAO = 1
|
|
DOMAIN_ATTESTATION = 2
|
|
DOMAIN_DEPOSIT = 3
|
|
DOMAIN_VOLUNTARY_EXIT = 4
|
|
DOMAIN_TRANSFER = 5
|