2018-11-14 21:01:57 +00:00
# Ethereum 2.0 Phase 0 -- The Beacon Chain
2018-09-20 05:20:49 +00:00
2018-11-30 18:58:44 +00:00
**NOTICE**: This document is a work-in-progress for researchers and implementers. It reflects recent spec changes and takes precedence over the Python proof-of-concept implementation [[python-poc]](#ref-python-poc).
2018-09-20 05:20:49 +00:00
2018-11-28 07:23:37 +00:00
## Table of contents
2018-12-01 05:29:19 +00:00
<!-- TOC -->
- [Ethereum 2.0 Phase 0 -- The Beacon Chain ](#ethereum-20-phase-0----the-beacon-chain )
- [Table of contents ](#table-of-contents )
- [Introduction ](#introduction )
- [Notation ](#notation )
- [Terminology ](#terminology )
- [Constants ](#constants )
2018-12-04 10:57:09 +00:00
- [Misc ](#misc )
- [Deposit contract ](#deposit-contract )
- [Initial values ](#initial-values )
- [Time parameters ](#time-parameters )
- [Reward and penalty quotients ](#reward-and-penalty-quotients )
- [Status codes ](#status-codes )
2018-12-07 15:18:06 +00:00
- [Max operations per block ](#max-operations-per-block )
2018-12-04 10:57:09 +00:00
- [Validator registry delta flags ](#validator-registry-delta-flags )
- [Signature domains ](#signature-domains )
2018-12-01 05:29:19 +00:00
- [Data structures ](#data-structures )
2018-12-07 15:15:55 +00:00
- [Beacon chain operations ](#beacon-chain-operations )
2018-12-07 01:13:19 +00:00
- [Proposer slashings ](#proposer-slashings )
2018-12-07 18:51:15 +00:00
- [`ProposerSlashing` ](#proposerslashing )
2018-12-07 01:13:19 +00:00
- [Casper slashings ](#casper-slashings )
2018-12-07 18:51:15 +00:00
- [`CasperSlashing` ](#casperslashing )
2018-12-09 14:33:12 +00:00
- [`SlashableVoteData` ](#slashablevotedata )
2018-12-07 01:13:19 +00:00
- [Attestations ](#attestations )
2018-12-07 18:51:15 +00:00
- [`Attestation` ](#attestation )
2018-12-07 01:13:19 +00:00
- [`AttestationData` ](#attestationdata )
- [Deposits ](#deposits )
2018-12-07 18:51:15 +00:00
- [`Deposit` ](#deposit )
- [`DepositParameters` ](#depositparameters )
2018-12-07 01:13:19 +00:00
- [Exits ](#exits )
2018-12-07 18:51:15 +00:00
- [`Exit` ](#exit )
2018-12-01 05:29:19 +00:00
- [Beacon chain blocks ](#beacon-chain-blocks )
- [`BeaconBlock` ](#beaconblock )
2018-12-07 13:46:52 +00:00
- [`BeaconBlockBody` ](#beaconblockbody )
2018-12-01 05:29:19 +00:00
- [`ProposalSignedData` ](#proposalsigneddata )
- [Beacon chain state ](#beacon-chain-state )
- [`BeaconState` ](#beaconstate )
- [`ValidatorRecord` ](#validatorrecord )
- [`CrosslinkRecord` ](#crosslinkrecord )
2018-12-04 10:57:09 +00:00
- [`ShardCommittee` ](#shardcommittee )
2018-12-01 05:29:19 +00:00
- [`ShardReassignmentRecord` ](#shardreassignmentrecord )
- [`CandidatePoWReceiptRootRecord` ](#candidatepowreceiptrootrecord )
- [`PendingAttestationRecord` ](#pendingattestationrecord )
- [`ForkData` ](#forkdata )
2018-12-04 10:57:09 +00:00
- [Ethereum 1.0 deposit contract ](#ethereum-10-deposit-contract )
2018-12-04 11:47:41 +00:00
- [Deposit arguments ](#deposit-arguments )
2018-12-11 16:02:59 +00:00
- [`Eth1Deposit` logs ](#eth1deposit-logs )
2018-12-04 11:47:41 +00:00
- [`ChainStart` log ](#chainstart-log )
- [Vyper code ](#vyper-code )
2018-12-01 05:29:19 +00:00
- [Beacon chain processing ](#beacon-chain-processing )
- [Beacon chain fork choice rule ](#beacon-chain-fork-choice-rule )
- [Beacon chain state transition function ](#beacon-chain-state-transition-function )
- [Helper functions ](#helper-functions )
2018-12-07 12:18:55 +00:00
- [`is_active_validator` ](#is_active_validator )
2018-12-01 05:29:19 +00:00
- [`get_active_validator_indices` ](#get_active_validator_indices )
- [`shuffle` ](#shuffle )
- [`split` ](#split )
- [`clamp` ](#clamp )
- [`get_new_shuffling` ](#get_new_shuffling )
2018-12-04 10:57:09 +00:00
- [`get_shard_committees_at_slot` ](#get_shard_committees_at_slot )
2018-12-01 05:29:19 +00:00
- [`get_block_hash` ](#get_block_hash )
- [`get_beacon_proposer_index` ](#get_beacon_proposer_index )
2018-12-07 15:05:29 +00:00
- [`get_updated_ancestor_hashes` ](#get_updated_ancestor_hashes )
2018-12-01 05:29:19 +00:00
- [`get_attestation_participants` ](#get_attestation_participants )
- [`bytes1`, `bytes2`, ... ](#bytes1-bytes2- )
- [`get_effective_balance` ](#get_effective_balance )
- [`get_new_validator_registry_delta_chain_tip` ](#get_new_validator_registry_delta_chain_tip )
2018-12-10 22:14:08 +00:00
- [`get_fork_version` ](#get_fork_version )
2018-12-05 14:41:11 +00:00
- [`get_domain` ](#get_domain )
2018-12-10 22:58:36 +00:00
- [`SSZTreeHash` ](#ssztreehash )
2018-12-07 20:09:49 +00:00
- [`verify_casper_votes` ](#verify_casper_votes )
2018-12-01 05:29:19 +00:00
- [`integer_squareroot` ](#integer_squareroot )
2018-12-10 22:14:08 +00:00
- [`BLSVerify` ](#blsverify )
2018-12-01 05:29:19 +00:00
- [On startup ](#on-startup )
2018-12-10 22:30:25 +00:00
- [Routine for processing deposits ](#routine-for-processing-deposits )
- [Routine for updating validator status ](#routine-for-updating-validator-status )
2018-12-04 21:28:31 +00:00
- [Per-slot processing ](#per-slot-processing )
2018-12-05 11:22:15 +00:00
- [Proposer signature ](#proposer-signature )
- [RANDAO ](#randao )
- [PoW receipt root ](#pow-receipt-root )
2018-12-07 18:51:15 +00:00
- [Block operations ](#block-operations )
2018-12-07 01:16:10 +00:00
- [Proposer slashings ](#proposer-slashings-1 )
- [Casper slashings ](#casper-slashings-1 )
- [Attestations ](#attestations-1 )
- [Deposits ](#deposits-1 )
- [Exits ](#exits-1 )
2018-12-07 12:18:55 +00:00
- [Ejections ](#ejections )
2018-12-04 21:28:31 +00:00
- [Per-epoch processing ](#per-epoch-processing )
2018-12-05 11:22:15 +00:00
- [Helpers ](#helpers )
- [Receipt roots ](#receipt-roots )
- [Justification ](#justification )
- [Finalization ](#finalization )
- [Crosslinks ](#crosslinks )
- [Justification and finalization rewards and penalties ](#justification-and-finalization-rewards-and-penalties )
- [Crosslink rewards and penalties ](#crosslink-rewards-and-penalties )
- [Validator registry ](#validator-registry )
2018-12-01 05:29:19 +00:00
- [Proposer reshuffling ](#proposer-reshuffling )
2018-12-05 11:22:15 +00:00
- [Final updates ](#final-updates )
2018-12-05 19:03:24 +00:00
- [State root processing ](#state-root-processing )
2018-12-01 05:29:19 +00:00
- [Appendix ](#appendix )
- [Appendix A - Hash function ](#appendix-a---hash-function )
- [References ](#references )
- [Normative ](#normative )
- [Informative ](#informative )
- [Copyright ](#copyright )
<!-- /TOC -->
2018-11-28 07:23:37 +00:00
## Introduction
2018-09-20 05:20:49 +00:00
2018-11-14 21:01:57 +00:00
This document represents the specification for Phase 0 of Ethereum 2.0 -- The Beacon Chain.
2018-11-30 18:14:17 +00:00
At the core of Ethereum 2.0 is a system chain called the "beacon chain". The beacon chain stores and manages the registry of [validators ](#dfn-validator ). In the initial deployment phases of Ethereum 2.0 the only mechanism to become a [validator ](#dfn-validator ) is to make a one-way ETH transaction to a deposit contract on Ethereum 1.0. Activation as a [validator ](#dfn-validator ) happens when deposit transaction receipts are processed by the beacon chain, the activation balance is reached, and after a queuing process. Exit is either voluntary or done forcibly as a penalty for misbehavior.
2018-09-20 05:20:49 +00:00
2018-11-30 14:28:33 +00:00
The primary source of load on the beacon chain is "attestations". Attestations are availability votes for a shard block, and simultaneously proof of stake votes for a beacon chain block. A sufficient number of attestations for the same shard block create a "crosslink", confirming the shard segment up to that shard block into the beacon chain. Crosslinks also serve as infrastructure for asynchronous cross-shard communication.
2018-09-20 05:20:49 +00:00
2018-11-29 01:56:25 +00:00
## Notation
2018-11-30 14:28:33 +00:00
Unless otherwise indicated, code appearing in `this style` is to be interpreted as an algorithm defined in Python. Implementations may implement such algorithms using any code and programming language desired as long as the behavior is identical to that of the algorithm provided.
2018-11-28 07:23:37 +00:00
## Terminology
2018-09-20 05:20:49 +00:00
2018-11-30 17:31:09 +00:00
* **Validator** < a id = "dfn-validator" ></ a > - a participant in the Casper/sharding consensus system. You can become one by depositing 32 ETH into the Casper mechanism.
2018-11-30 18:14:17 +00:00
* **Active validator** < a id = "dfn-active-validator" ></ a > - a [validator ](#dfn-validator ) currently participating in the protocol which the Casper mechanism looks to produce and attest to blocks, crosslinks and other consensus objects.
* **Committee** - a (pseudo-) randomly sampled subset of [active validators ](#dfn-active-validator ). When a committee is referred to collectively, as in "this committee attests to X", this is assumed to mean "some subset of that committee that contains enough [validators ](#dfn-validator ) that the protocol recognizes it as representing the committee".
2018-11-30 17:31:09 +00:00
* **Proposer** - the [validator ](#dfn-validator ) that creates a beacon chain block
* **Attester** - a [validator ](#dfn-validator ) that is part of a committee that needs to sign off on a beacon chain block while simultaneously creating a link (crosslink) to a recent shard block on a particular shard chain.
2018-09-20 05:20:49 +00:00
* **Beacon chain** - the central PoS chain that is the base of the sharding system.
2018-10-02 02:21:15 +00:00
* **Shard chain** - one of the chains on which user transactions take place and account data is stored.
2018-09-20 05:20:49 +00:00
* **Crosslink** - a set of signatures from a committee attesting to a block in a shard chain, which can be included into the beacon chain. Crosslinks are the main means by which the beacon chain "learns about" the updated state of shard chains.
2018-10-16 22:03:29 +00:00
* **Slot** - a period of `SLOT_DURATION` seconds, during which one proposer has the ability to create a beacon chain block and some attesters have the ability to make attestations
2018-11-30 17:31:09 +00:00
* **Epoch** - an aligned span of slots during which all [validators ](#dfn-validator ) get exactly one chance to make an attestation
2018-09-20 05:20:49 +00:00
* **Finalized**, **justified** - see Casper FFG finalization here: https://arxiv.org/abs/1710.09437
2018-11-30 17:31:09 +00:00
* **Withdrawal period** - the number of slots between a [validator ](#dfn-validator ) exit and the [validator ](#dfn-validator ) balance being withdrawable
2018-10-03 07:27:39 +00:00
* **Genesis time** - the Unix time of the genesis beacon chain block at slot 0
2018-09-20 05:20:49 +00:00
2018-11-28 07:23:37 +00:00
## Constants
2018-09-20 05:20:49 +00:00
2018-12-04 10:57:09 +00:00
### Misc
2018-11-30 14:28:33 +00:00
| Name | Value | Unit |
| - | - | :-: |
2018-12-04 10:57:09 +00:00
| `SHARD_COUNT` | `2**10` (= 1,024) | shards |
2018-11-30 17:31:09 +00:00
| `TARGET_COMMITTEE_SIZE` | `2**8` (= 256) | [validators ](#dfn-validator ) |
2018-12-07 12:18:55 +00:00
| `EJECTION_BALANCE` | `2**4` (= 16) | ETH |
2018-12-04 10:57:09 +00:00
| `MAX_BALANCE_CHURN_QUOTIENT` | `2**5` (= 32) | - |
2018-11-30 14:28:33 +00:00
| `GWEI_PER_ETH` | `10**9` | Gwei/ETH |
| `BEACON_CHAIN_SHARD_NUMBER` | `2**64 - 1` | - |
2018-12-09 14:33:12 +00:00
| `BLS_WITHDRAWAL_PREFIX_BYTE` | `0x00` | - |
2018-12-07 20:09:49 +00:00
| `MAX_CASPER_VOTES` | `2**10` (= 1,024) | votes |
2018-11-30 14:28:33 +00:00
2018-12-04 10:57:09 +00:00
* For the safety of crosslinks a minimum committee size of 111 is [recommended ](https://vitalik.ca/files/Ithaca201807_Sharding.pdf ). (Unbiasable randomness with a Verifiable Delay Function (VDF) will improve committee robustness and lower the safe minimum committee size.) The shuffling algorithm generally ensures (assuming sufficient validators) committee sizes at least `TARGET_COMMITTEE_SIZE // 2` .
### Deposit contract
| Name | Value | Unit |
| - | - | :-: |
| `DEPOSIT_CONTRACT_ADDRESS` | **TBD** |
| `DEPOSIT_CONTRACT_TREE_DEPTH` | `2**5` (= 32) | - |
| `MIN_DEPOSIT` | `2**0` (= 1) | ETH |
| `MAX_DEPOSIT` | `2**5` (= 32) | ETH |
### Initial values
| Name | Value |
| - | - |
| `INITIAL_FORK_VERSION` | `0` |
| `INITIAL_SLOT_NUMBER` | `0` |
| `ZERO_HASH` | `bytes([0] * 32)` |
### Time parameters
2018-11-30 14:28:33 +00:00
| Name | Value | Unit | Duration |
| - | - | :-: | :-: |
| `SLOT_DURATION` | `6` | seconds | 6 seconds |
| `MIN_ATTESTATION_INCLUSION_DELAY` | `2**2` (= 4) | slots | 24 seconds |
| `EPOCH_LENGTH` | `2**6` (= 64) | slots | 6.4 minutes |
| `MIN_VALIDATOR_REGISTRY_CHANGE_INTERVAL` | `2**8` (= 256) | slots | 25.6 minutes |
| `POW_RECEIPT_ROOT_VOTING_PERIOD` | `2**10` (= 1,024) | slots | ~1.7 hours |
| `SHARD_PERSISTENT_COMMITTEE_CHANGE_PERIOD` | `2**17` (= 131,072) | slots | ~9 days |
| `COLLECTIVE_PENALTY_CALCULATION_PERIOD` | `2**20` (= 1,048,576) | slots | ~73 days |
2018-12-05 14:41:11 +00:00
| `ZERO_BALANCE_VALIDATOR_TTL` | `2**22` (= 4,194,304) | slots | ~291 days |
2018-11-30 14:28:33 +00:00
2018-12-04 10:57:09 +00:00
### Reward and penalty quotients
2018-10-03 07:27:39 +00:00
2018-11-30 14:28:33 +00:00
| Name | Value |
| - | - |
| `BASE_REWARD_QUOTIENT` | `2**11` (= 2,048) |
| `WHISTLEBLOWER_REWARD_QUOTIENT` | `2**9` (= 512) |
| `INCLUDER_REWARD_QUOTIENT` | `2**3` (= 8) |
2018-12-09 13:08:11 +00:00
| `INACTIVITY_PENALTY_QUOTIENT` | `2**34` (= 17,179,869,184) |
2018-10-03 07:27:39 +00:00
2018-12-09 13:08:11 +00:00
* The `BASE_REWARD_QUOTIENT` parameter dictates the per-epoch reward. It corresponds to ~2.54% annual interest assuming 10 million participating ETH in every epoch.
* The `INACTIVITY_PENALTY_QUOTIENT` equals `INVERSE_SQRT_E_DROP_TIME**2` where `INVERSE_SQRT_E_DROP_TIME := 2**17 slots` (~9 days) is the time it takes the inactivity penalty to reduce the balance of non-participating [validators ](#dfn-validator ) to about `1/sqrt(e) ~= 60.6%` . Indeed, the balance retained by offline [validators ](#dfn-validator ) after `n` slots is about `(1-1/INACTIVITY_PENALTY_QUOTIENT)**(n**2/2)` so after `INVERSE_SQRT_E_DROP_TIME` slots it is roughly `(1-1/INACTIVITY_PENALTY_QUOTIENT)**(INACTIVITY_PENALTY_QUOTIENT/2) ~= 1/sqrt(e)` .
2018-12-04 10:57:09 +00:00
### Status codes
2018-10-03 07:27:39 +00:00
2018-10-04 13:16:31 +00:00
| Name | Value |
2018-11-30 14:28:33 +00:00
| - | - |
2018-10-05 10:38:30 +00:00
| `PENDING_ACTIVATION` | `0` |
| `ACTIVE` | `1` |
2018-12-04 16:07:46 +00:00
| `ACTIVE_PENDING_EXIT` | `2` |
2018-12-04 10:57:09 +00:00
| `EXITED_WITHOUT_PENALTY` | `3` |
| `EXITED_WITH_PENALTY` | `4` |
2018-10-04 13:16:31 +00:00
2018-12-07 15:18:06 +00:00
### Max operations per block
2018-10-04 13:16:31 +00:00
2018-12-07 01:02:23 +00:00
| Name | Value |
2018-12-07 01:07:26 +00:00
| - | - |
2018-12-07 01:02:23 +00:00
| `MAX_PROPOSER_SLASHINGS` | `2**4` (= 16) |
| `MAX_CASPER_SLASHINGS` | `2**4` (= 16) |
| `MAX_ATTESTATIONS` | `2**7` (= 128) |
| `MAX_DEPOSITS` | `2**4` (= 16) |
| `MAX_EXITS` | `2**4` (= 16) |
2018-10-04 13:16:31 +00:00
2018-12-04 10:57:09 +00:00
### Validator registry delta flags
2018-10-04 13:16:31 +00:00
| Name | Value |
2018-11-30 14:28:33 +00:00
| - | - |
| `ACTIVATION` | `0` |
2018-10-04 13:16:31 +00:00
| `EXIT` | `1` |
2018-09-20 05:20:49 +00:00
2018-12-04 10:57:09 +00:00
### Signature domains
2018-11-20 01:13:58 +00:00
2018-12-10 19:55:11 +00:00
| Name | Value |
2018-11-30 14:28:33 +00:00
| - | - |
2018-11-20 01:13:58 +00:00
| `DOMAIN_DEPOSIT` | `0` |
| `DOMAIN_ATTESTATION` | `1` |
| `DOMAIN_PROPOSAL` | `2` |
2018-11-30 14:28:33 +00:00
| `DOMAIN_EXIT` | `3` |
2018-10-04 10:09:39 +00:00
## Data structures
2018-11-30 14:28:33 +00:00
2018-12-07 15:15:55 +00:00
### Beacon chain operations
2018-11-30 14:28:33 +00:00
2018-12-07 01:13:19 +00:00
#### Proposer slashings
2018-11-30 14:28:33 +00:00
2018-12-07 18:51:15 +00:00
##### `ProposerSlashing`
2018-11-30 14:28:33 +00:00
```python
{
2018-12-07 01:13:19 +00:00
# Proposer index
'proposer_index': 'uint24',
# First proposal data
'proposal_data_1': ProposalSignedData,
# First proposal signature
'proposal_signature_1': '[uint384]',
# Second proposal data
'proposal_data_2': ProposalSignedData,
# Second proposal signature
'proposal_signature_2': '[uint384]',
2018-11-30 14:28:33 +00:00
}
```
2018-12-07 01:13:19 +00:00
#### Casper slashings
2018-09-20 05:20:49 +00:00
2018-12-07 18:51:15 +00:00
##### `CasperSlashing`
2018-09-20 05:20:49 +00:00
```python
2018-10-04 10:09:39 +00:00
{
2018-12-07 20:09:49 +00:00
# First batch of votes
2018-12-09 14:33:12 +00:00
'votes_1': SlashableVoteData,
2018-12-07 20:09:49 +00:00
# Second batch of votes
2018-12-09 14:33:12 +00:00
'votes_2': SlashableVoteData,
2018-12-06 23:51:01 +00:00
}
```
2018-12-09 14:33:12 +00:00
##### `SlashableVoteData`
2018-12-06 23:51:01 +00:00
```python
{
2018-12-07 01:13:19 +00:00
# Proof-of-custody indices (0 bits)
'aggregate_signature_poc_0_indices': '[uint24]',
# Proof-of-custody indices (1 bits)
'aggregate_signature_poc_1_indices': '[uint24]',
# Attestation data
'data': AttestationData,
# Aggregate signature
'aggregate_signature': '[uint384]',
2018-12-06 23:51:01 +00:00
}
```
2018-12-07 01:13:19 +00:00
#### Attestations
2018-12-06 23:51:01 +00:00
2018-12-07 18:51:15 +00:00
##### `Attestation`
2018-10-02 02:21:15 +00:00
```python
2018-10-04 10:09:39 +00:00
{
2018-11-30 14:28:33 +00:00
# Attestation data
'data': AttestationData,
2018-11-26 23:32:53 +00:00
# Attester participation bitfield
2018-11-30 14:28:33 +00:00
'participation_bitfield': 'bytes',
2018-11-26 22:12:39 +00:00
# Proof of custody bitfield
2018-11-30 14:28:33 +00:00
'custody_bitfield': 'bytes',
2018-10-04 10:09:39 +00:00
# BLS aggregate signature
2018-12-04 10:57:09 +00:00
'aggregate_signature': ['uint384'],
2018-10-02 02:21:15 +00:00
}
```
2018-12-07 01:13:19 +00:00
##### `AttestationData`
2018-11-20 07:40:04 +00:00
2018-10-02 02:21:15 +00:00
```python
2018-10-04 10:09:39 +00:00
{
2018-10-02 02:21:15 +00:00
# Slot number
2018-10-16 11:55:03 +00:00
'slot': 'uint64',
2018-10-04 10:09:39 +00:00
# Shard number
2018-11-24 21:20:20 +00:00
'shard': 'uint64',
2018-11-30 14:28:33 +00:00
# Hash of the signed beacon block
'beacon_block_hash': 'hash32',
# Hash of the ancestor at the epoch boundary
'epoch_boundary_hash': 'hash32',
2018-10-04 10:09:39 +00:00
# Shard block hash being attested to
2018-10-02 02:21:15 +00:00
'shard_block_hash': 'hash32',
2018-11-14 21:01:57 +00:00
# Last crosslink hash
2018-11-30 14:28:33 +00:00
'latest_crosslink_hash': 'hash32',
# Slot of the last justified beacon block
2018-10-16 11:55:03 +00:00
'justified_slot': 'uint64',
2018-11-30 14:28:33 +00:00
# Hash of the last justified beacon block
2018-10-02 02:21:15 +00:00
'justified_block_hash': 'hash32',
}
```
2018-12-07 01:13:19 +00:00
#### Deposits
2018-12-07 01:02:23 +00:00
2018-12-07 18:51:15 +00:00
##### `Deposit`
2018-11-20 07:40:04 +00:00
```python
{
2018-12-07 01:02:23 +00:00
# Receipt Merkle branch
'merkle_branch': '[hash32]',
# Merkle tree index
'merkle_tree_index': 'uint64',
# Deposit data
'deposit_data': {
# Deposit parameters
2018-12-07 18:51:15 +00:00
'deposit_parameters': DepositParameters,
2018-12-07 01:02:23 +00:00
# Value in Gwei
'value': 'uint64',
# Timestamp from deposit contract
'timestamp': 'uint64',
},
}
```
2018-12-07 18:51:15 +00:00
##### `DepositParameters`
2018-12-07 01:13:19 +00:00
```python
{
# BLS pubkey
'pubkey': 'uint384',
# BLS proof of possession (a BLS signature)
'proof_of_possession': ['uint384'],
# Withdrawal credentials
'withdrawal_credentials': 'hash32',
# Initial RANDAO commitment
'randao_commitment': 'hash32',
}
```
#### Exits
2018-12-07 18:51:15 +00:00
##### `Exit`
2018-12-07 01:02:23 +00:00
```python
{
# Minimum slot for processing exit
'slot': 'unit64',
# Index of the exiting validator
'validator_index': 'uint64',
# Validator signature
'signature': '[uint384]',
}
```
### Beacon chain blocks
2018-12-07 14:12:58 +00:00
#### `BeaconBlock`
2018-11-20 07:40:04 +00:00
```python
{
2018-12-07 14:12:58 +00:00
## Header ##
2018-11-20 07:40:04 +00:00
'slot': 'uint64',
2018-12-07 01:02:23 +00:00
# Skip list of ancestor beacon block hashes
# i'th item is the most recent ancestor whose slot is a multiple of 2**i for i = 0, ..., 31
'ancestor_hashes': ['hash32'],
'state_root': 'hash32',
'randao_reveal': 'hash32',
'candidate_pow_receipt_root': 'hash32',
'signature': ['uint384'],
2018-12-07 14:12:58 +00:00
## Body ##
'body': BeaconBlockBody,
2018-11-20 07:40:04 +00:00
}
```
2018-12-07 01:02:23 +00:00
#### `BeaconBlockBody`
2018-10-02 02:21:15 +00:00
2018-10-04 10:09:39 +00:00
```python
2018-10-04 10:22:50 +00:00
{
2018-12-07 18:51:15 +00:00
'attestations': [Attestation],
'proposer_slashings': [ProposerSlashing],
'casper_slashings': [CasperSlashing],
'deposits': [Deposit],
'exits': [Exit],
2018-11-20 07:40:04 +00:00
}
```
2018-12-07 01:02:23 +00:00
#### `ProposalSignedData`
2018-10-02 02:21:15 +00:00
2018-10-04 10:09:39 +00:00
```python
2018-10-04 10:22:50 +00:00
{
2018-12-07 01:02:23 +00:00
# Slot number
'slot': 'uint64',
# Shard number (`BEACON_CHAIN_SHARD_NUMBER` for beacon chain)
'shard': 'uint64',
# Block hash
'block_hash': 'hash32',
2018-10-04 10:09:39 +00:00
}
```
### Beacon chain state
2018-09-20 05:20:49 +00:00
2018-11-30 14:28:33 +00:00
#### `BeaconState`
2018-09-20 05:20:49 +00:00
```python
2018-10-04 10:09:39 +00:00
{
2018-12-04 21:28:31 +00:00
# Misc
'slot': 'uint64',
'genesis_time': 'uint64',
'fork_data': ForkData, # For versioning hard forks
2018-11-30 14:28:33 +00:00
# Validator registry
'validator_registry': [ValidatorRecord],
'validator_registry_latest_change_slot': 'uint64',
'validator_registry_exit_count': 'uint64',
2018-12-04 21:28:31 +00:00
'validator_registry_delta_chain_tip': 'hash32', # For light clients to track deltas
2018-11-30 14:28:33 +00:00
# Randomness and committees
'randao_mix': 'hash32',
'next_seed': 'hash32',
2018-12-04 10:57:09 +00:00
'shard_committees_at_slots': [[ShardCommittee]],
2018-10-30 08:45:28 +00:00
'persistent_committees': [['uint24']],
2018-11-05 12:41:03 +00:00
'persistent_committee_reassignments': [ShardReassignmentRecord],
2018-11-30 14:28:33 +00:00
# Finality
'previous_justified_slot': 'uint64',
'justified_slot': 'uint64',
2018-12-04 10:57:09 +00:00
'justification_bitfield': 'uint64',
2018-11-30 14:28:33 +00:00
'finalized_slot': 'uint64',
# Recent state
'latest_crosslinks': [CrosslinkRecord],
'latest_block_hashes': ['hash32'], # Needed to process attestations, older to newer
2018-12-04 10:57:09 +00:00
'latest_penalized_exit_balances': ['uint64'], # Balances penalized at every withdrawal period
2018-11-30 14:28:33 +00:00
'latest_attestations': [PendingAttestationRecord],
2018-11-22 23:09:36 +00:00
# PoW receipt root
'processed_pow_receipt_root': 'hash32',
2018-11-24 21:41:53 +00:00
'candidate_pow_receipt_roots': [CandidatePoWReceiptRootRecord],
2018-09-20 05:20:49 +00:00
}
```
2018-11-30 14:28:33 +00:00
#### `ValidatorRecord`
2018-09-20 05:20:49 +00:00
```python
2018-10-04 10:09:39 +00:00
{
# BLS public key
2018-11-17 23:20:39 +00:00
'pubkey': 'uint384',
2018-11-24 21:04:07 +00:00
# Withdrawal credentials
'withdrawal_credentials': 'hash32',
2018-10-04 10:09:39 +00:00
# RANDAO commitment
2018-09-20 05:20:49 +00:00
'randao_commitment': 'hash32',
2018-12-05 11:22:15 +00:00
# Slots the proposer has skipped (i.e. layers of RANDAO expected)
2018-11-25 11:23:34 +00:00
'randao_skips': 'uint64',
2018-10-16 12:50:31 +00:00
# Balance in Gwei
2018-10-16 11:55:03 +00:00
'balance': 'uint64',
2018-10-04 10:09:39 +00:00
# Status code
2018-11-26 10:47:32 +00:00
'status': 'uint64',
2018-11-24 21:07:25 +00:00
# Slot when validator last changed status (or 0)
2018-11-30 14:28:33 +00:00
'latest_status_change_slot': 'uint64',
# Exit counter when validator exited (or 0)
'exit_count': 'uint64',
2018-09-20 05:20:49 +00:00
}
```
2018-11-30 14:28:33 +00:00
#### `CrosslinkRecord`
2018-10-02 02:21:15 +00:00
```python
2018-10-04 10:09:39 +00:00
{
# Slot number
2018-10-16 11:55:03 +00:00
'slot': 'uint64',
2018-12-05 14:34:50 +00:00
# Shard block hash
2018-11-30 14:28:33 +00:00
'shard_block_hash': 'hash32',
2018-10-02 02:21:15 +00:00
}
```
2018-12-04 10:57:09 +00:00
#### `ShardCommittee`
2018-09-20 05:20:49 +00:00
```python
2018-10-04 13:26:13 +00:00
{
# Shard number
2018-11-24 21:20:20 +00:00
'shard': 'uint64',
2018-10-04 13:26:13 +00:00
# Validator indices
2018-11-30 14:28:33 +00:00
'committee': ['uint24'],
# Total validator count (for proofs of custody)
'total_validator_count': 'uint64',
2018-09-20 05:20:49 +00:00
}
```
2018-12-01 05:29:19 +00:00
#### `ShardReassignmentRecord`
2018-10-30 08:45:28 +00:00
```python
{
# Which validator to reassign
2018-11-06 09:43:21 +00:00
'validator_index': 'uint24',
2018-10-30 08:45:28 +00:00
# To which shard
2018-11-24 21:20:20 +00:00
'shard': 'uint64',
2018-10-30 08:45:28 +00:00
# When
2018-11-30 14:28:33 +00:00
'slot': 'uint64',
2018-10-30 08:45:28 +00:00
}
```
2018-11-30 14:28:33 +00:00
#### `CandidatePoWReceiptRootRecord`
2018-11-24 21:12:27 +00:00
```python
{
2018-11-24 21:41:53 +00:00
# Candidate PoW receipt root
'candidate_pow_receipt_root': 'hash32',
# Vote count
2018-11-30 14:28:33 +00:00
'votes': 'uint64',
2018-11-24 21:12:27 +00:00
}
```
2018-11-30 14:28:33 +00:00
#### `PendingAttestationRecord`
2018-12-04 10:57:09 +00:00
2018-11-26 22:12:39 +00:00
```python
{
# Signed data
2018-11-30 14:28:33 +00:00
'data': AttestationData,
2018-11-28 07:23:37 +00:00
# Attester participation bitfield
2018-11-30 14:28:33 +00:00
'participation_bitfield': 'bytes',
2018-11-26 22:12:39 +00:00
# Proof of custody bitfield
2018-11-30 14:28:33 +00:00
'custody_bitfield': 'bytes',
2018-11-26 22:12:39 +00:00
# Slot in which it was included
2018-11-30 14:28:33 +00:00
'slot_included': 'uint64',
2018-11-27 03:52:06 +00:00
}
```
2018-11-30 14:28:33 +00:00
#### `ForkData`
2018-12-04 10:57:09 +00:00
2018-11-30 14:28:33 +00:00
```python
{
# Previous fork version
'pre_fork_version': 'uint64',
# Post fork version
'post_fork_version': 'uint64',
# Fork slot number
'fork_slot': 'uint64',
2018-12-03 03:08:33 +00:00
}
2018-11-30 14:28:33 +00:00
```
2018-12-04 10:57:09 +00:00
## Ethereum 1.0 deposit contract
2018-12-04 11:47:41 +00:00
The initial deployment phases of Ethereum 2.0 are implemented without consensus changes to Ethereum 1.0. A deposit contract at address `DEPOSIT_CONTRACT_ADDRESS` is added to Ethereum 1.0 for deposits of ETH to the beacon chain. Validator balances will be withdrawable to the shards when the EVM2.0 is deployed and the shards have state.
2018-12-04 10:57:09 +00:00
2018-12-04 11:47:41 +00:00
### Deposit arguments
2018-12-04 10:57:09 +00:00
2018-12-07 18:51:15 +00:00
The deposit contract has a single `deposit` function which takes as argument a SimpleSerialize'd `DepositParameters` . One of the `DepositParameters` fields is `withdrawal_credentials` which must satisfy:
2018-12-04 10:57:09 +00:00
2018-12-09 14:33:12 +00:00
* `withdrawal_credentials[:1] == BLS_WITHDRAWAL_PREFIX_BYTE`
2018-12-04 11:47:41 +00:00
* `withdrawal_credentials[1:] == hash(withdrawal_pubkey)[1:]` where `withdrawal_pubkey` is a BLS pubkey
We recommend the private key corresponding to `withdrawal_pubkey` be stored in cold storage until a withdrawal is required.
2018-12-11 16:02:59 +00:00
### `Eth1Deposit` logs
2018-12-04 11:47:41 +00:00
2018-12-11 16:02:59 +00:00
Every deposit, of size between `MIN_DEPOSIT` and `MAX_DEPOSIT` , emits an `Eth1Deposit` log for consumption by the beacon chain. The deposit contract does little validation, pushing most of the validator onboarding logic to the beacon chain. In particular, the proof of possession (a BLS12-381 signature) is not verified by the deposit contract.
2018-12-04 11:47:41 +00:00
### `ChainStart` log
When sufficiently many full deposits have been made the deposit contract emits the `ChainStart` log. The beacon chain may then be initialized by calling the `on_startup` function (defined below) where:
* `genesis_time` equals `time` in the `ChainStart` log
* `processed_pow_receipt_root` equals `receipt_root` in the `ChainStart` log
2018-12-11 16:02:59 +00:00
* `initial_validator_deposits` is a list of `Deposit` objects built according to the `Eth1Deposit` logs up to the deposit that triggered the `ChainStart` log, processed in the order in which they were emitted (oldest to newest)
2018-12-04 11:47:41 +00:00
### Vyper code
2018-12-04 10:57:09 +00:00
```python
2018-12-11 16:29:09 +00:00
## compiled with v0.1.0-beta.4 ##
2018-12-04 10:57:09 +00:00
MIN_DEPOSIT: constant(uint256) = 1 # ETH
MAX_DEPOSIT: constant(uint256) = 32 # ETH
GWEI_PER_ETH: constant(uint256) = 1000000000 # 10**9
CHAIN_START_FULL_DEPOSIT_THRESHOLD: constant(uint256) = 16384 # 2**14
DEPOSIT_CONTRACT_TREE_DEPTH: constant(uint256) = 32
SECONDS_PER_DAY: constant(uint256) = 86400
2018-12-11 16:02:59 +00:00
Eth1Deposit: event({previous_receipt_root: bytes32, data: bytes[2064], deposit_count: uint256})
2018-12-04 10:57:09 +00:00
ChainStart: event({receipt_root: bytes32, time: bytes[8]})
receipt_tree: bytes32[uint256]
2018-12-04 16:07:46 +00:00
deposit_count: uint256
2018-12-04 10:57:09 +00:00
full_deposit_count: uint256
@payable
@public
def deposit(deposit_parameters: bytes[2048]):
2018-12-04 16:07:46 +00:00
assert msg.value >= as_wei_value(MIN_DEPOSIT, "ether")
assert msg.value < = as_wei_value(MAX_DEPOSIT, "ether")
index: uint256 = self.deposit_count + 2**DEPOSIT_CONTRACT_TREE_DEPTH
2018-12-04 10:57:09 +00:00
msg_gwei_bytes8: bytes[8] = slice(concat("", convert(msg.value / GWEI_PER_ETH, bytes32)), start=24, len=8)
timestamp_bytes8: bytes[8] = slice(concat("", convert(block.timestamp, bytes32)), start=24, len=8)
deposit_data: bytes[2064] = concat(msg_gwei_bytes8, timestamp_bytes8, deposit_parameters)
2018-12-11 16:02:59 +00:00
log.Eth1Deposit(self.receipt_tree[1], deposit_data, self.deposit_count)
2018-12-04 10:57:09 +00:00
2018-12-04 16:07:46 +00:00
# add deposit to merkle tree
2018-12-04 10:57:09 +00:00
self.receipt_tree[index] = sha3(deposit_data)
for i in range(32): # DEPOSIT_CONTRACT_TREE_DEPTH (range of constant var not yet supported)
index /= 2
self.receipt_tree[index] = sha3(concat(self.receipt_tree[index * 2], self.receipt_tree[index * 2 + 1]))
2018-12-04 16:07:46 +00:00
self.deposit_count += 1
2018-12-04 10:57:09 +00:00
if msg.value == as_wei_value(MAX_DEPOSIT, "ether"):
self.full_deposit_count += 1
if self.full_deposit_count == CHAIN_START_FULL_DEPOSIT_THRESHOLD:
timestamp_day_boundary: uint256 = as_unitless_number(block.timestamp) - as_unitless_number(block.timestamp) % SECONDS_PER_DAY + SECONDS_PER_DAY
timestamp_day_boundary_bytes8: bytes[8] = slice(concat("", convert(timestamp_day_boundary, bytes32)), start=24, len=8)
log.ChainStart(self.receipt_tree[1], timestamp_day_boundary_bytes8)
@public
@constant
def get_receipt_root() -> bytes32:
return self.receipt_tree[1]
```
2018-10-04 10:09:39 +00:00
## Beacon chain processing
2018-09-20 05:20:49 +00:00
2018-11-30 14:28:33 +00:00
The beacon chain is the system chain for Ethereum 2.0. The main responsibilities of the beacon chain are:
2018-10-02 02:21:15 +00:00
2018-11-30 17:31:09 +00:00
* Store and maintain the registry of [validators ](#dfn-validator )
2018-10-02 15:20:07 +00:00
* Process crosslinks (see above)
2018-12-04 21:28:31 +00:00
* Process its per-slot consensus, as well as the finality gadget
2018-10-02 02:21:15 +00:00
2018-12-04 21:28:31 +00:00
Processing the beacon chain is similar to processing the Ethereum 1.0 chain. Clients download and process blocks, and maintain a view of what is the current "canonical chain", terminating at the current "head". However, because of the beacon chain's relationship with Ethereum 1.0, and because it is a proof-of-stake chain, there are differences.
2018-09-20 05:20:49 +00:00
2018-11-30 14:28:33 +00:00
For a beacon chain block, `block` , to be processed by a node, the following conditions must be met:
2018-09-20 05:20:49 +00:00
2018-12-10 23:08:04 +00:00
* The parent block with `SSZTreeHash` `block.ancestor_hashes[0]` has been processed and accepted.
2018-12-07 13:46:52 +00:00
* The node has processed its `state` up to slot, `block.slot - 1` .
2018-11-30 14:28:33 +00:00
* The Ethereum 1.0 block pointed to by the `state.processed_pow_receipt_root` has been processed and accepted.
2018-12-07 13:46:52 +00:00
* The node's local clock time is greater than or equal to `state.genesis_time + block.slot * SLOT_DURATION` .
2018-09-20 05:20:49 +00:00
2018-10-16 22:03:29 +00:00
If these conditions are not met, the client should delay processing the beacon block until the conditions are all satisfied.
2018-09-20 05:20:49 +00:00
2018-12-05 11:22:15 +00:00
Beacon block production is significantly different because of the proof of stake mechanism. A client simply checks what it thinks is the canonical chain when it should create a block, and looks up what its slot number is; when the slot arrives, it either proposes or attests to a block as required. Note that this requires each node to have a clock that is roughly (i.e. within `SLOT_DURATION` seconds) synchronized with the other nodes.
2018-09-20 05:20:49 +00:00
### Beacon chain fork choice rule
2018-11-30 17:31:09 +00:00
The beacon chain fork choice rule is a hybrid that combines justification and finality with Latest Message Driven (LMD) Greediest Heaviest Observed SubTree (GHOST). At any point in time a [validator ](#dfn-validator ) `v` subjectively calculates the beacon chain head as follows.
2018-09-20 05:20:49 +00:00
2018-11-30 17:31:09 +00:00
* Let `store` be the set of attestations and blocks that the [validator ](#dfn-validator ) `v` has observed and verified (in particular, block ancestors must be recursively verified). Attestations not part of any chain are still included in `store` .
2018-11-23 14:46:25 +00:00
* Let `finalized_head` be the finalized block with the highest slot number. (A block `B` is finalized if there is a descendant of `B` in `store` the processing of which sets `B` as finalized.)
2018-11-30 14:28:33 +00:00
* Let `justified_head` be the descendant of `finalized_head` with the highest slot number that has been justified for at least `EPOCH_LENGTH` slots. (A block `B` is justified if there is a descendant of `B` in `store` the processing of which sets `B` as justified.) If no such descendant exists set `justified_head` to `finalized_head` .
2018-12-07 13:46:52 +00:00
* Let `get_ancestor(store, block, slot)` be the ancestor of `block` with slot number `slot` . The `get_ancestor` function can be defined recursively as `def get_ancestor(store, block, slot): return block if block.slot == slot else get_ancestor(store, store.get_parent(block), slot)` .
2018-11-30 17:31:09 +00:00
* Let `get_latest_attestation(store, validator)` be the attestation with the highest slot number in `store` from `validator` . If several such attestations exist, use the one the [validator ](#dfn-validator ) `v` observed first.
2018-11-23 15:23:22 +00:00
* Let `get_latest_attestation_target(store, validator)` be the target block in the attestation `get_latest_attestation(store, validator)` .
2018-11-23 20:10:03 +00:00
* The head is `lmd_ghost(store, justified_head)` where the function `lmd_ghost` is defined below. Note that the implementation below is suboptimal; there are implementations that compute the head in time logarithmic in slot count.
2018-09-20 05:20:49 +00:00
2018-11-22 13:24:20 +00:00
```python
def lmd_ghost(store, start):
2018-11-30 14:28:33 +00:00
validators = start.state.validator_registry
2018-11-26 03:22:15 +00:00
active_validators = [validators[i] for i in
2018-12-06 01:26:07 +00:00
get_active_validator_indices(validators)]
2018-11-26 03:22:15 +00:00
attestation_targets = [get_latest_attestation_target(store, validator)
for validator in active_validators]
2018-11-23 15:23:22 +00:00
def get_vote_count(block):
2018-11-26 03:22:15 +00:00
return len([target for target in attestation_targets if
2018-12-07 13:46:52 +00:00
get_ancestor(store, target, block.slot) == block])
2018-11-23 15:23:22 +00:00
2018-11-22 13:24:20 +00:00
head = start
while 1:
2018-11-23 15:23:22 +00:00
children = get_children(head)
if len(children) == 0:
2018-12-05 18:40:08 +00:00
return head
2018-11-23 15:23:22 +00:00
head = max(children, key=get_vote_count)
2018-11-22 13:24:20 +00:00
```
2018-09-20 05:20:49 +00:00
## Beacon chain state transition function
2018-11-30 14:28:33 +00:00
We now define the state transition function. At a high level the state transition is made up of two parts:
2018-09-20 05:20:49 +00:00
2018-12-04 21:28:31 +00:00
1. The per-slot transitions, which happens every slot, and only affects a parts of the `state` .
2. The per-epoch transitions, which happens at every epoch boundary (i.e. `state.slot % EPOCH_LENGTH == 0` ), and affects the entire `state` .
2018-09-20 05:20:49 +00:00
2018-12-05 18:40:08 +00:00
The per-slot transitions generally focus on verifying aggregate signatures and saving temporary records relating to the per-slot activity in the `BeaconState` . The per-epoch transitions focus on the [validator ](#dfn-validator ) registry, including adjusting balances and activating and exiting [validators ](#dfn-validator ), as well as processing crosslinks and managing block justification/finalization.
2018-09-20 05:20:49 +00:00
### Helper functions
2018-11-30 14:28:33 +00:00
Note: The definitions below are for specification purposes and are not necessarily optimal implementations.
2018-12-07 12:18:55 +00:00
#### `is_active_validator`
2018-12-10 10:11:41 +00:00
```python
2018-12-07 12:18:55 +00:00
def is_active_validator(validator: ValidatorRecord) -> bool:
"""
Checks if ``validator`` is active.
"""
return validator.status in [ACTIVE, ACTIVE_PENDING_EXIT]
```
2018-11-30 14:28:33 +00:00
#### `get_active_validator_indices`
2018-09-20 05:20:49 +00:00
```python
2018-12-03 14:14:31 +00:00
def get_active_validator_indices(validators: [ValidatorRecord]) -> List[int]:
2018-11-30 14:28:33 +00:00
"""
Gets indices of active validators from ``validators``.
"""
2018-12-07 12:18:55 +00:00
return [i for i, v in enumerate(validators) if is_active_validator(v)]
2018-09-20 05:20:49 +00:00
```
2018-11-04 22:26:24 +00:00
2018-11-30 14:28:33 +00:00
#### `shuffle`
2018-09-20 05:20:49 +00:00
```python
2018-11-30 14:28:33 +00:00
def shuffle(values: List[Any], seed: Hash32) -> List[Any]:
2018-10-07 06:21:37 +00:00
"""
2018-11-30 14:28:33 +00:00
Returns the shuffled ``values`` with ``seed`` as entropy.
2018-10-07 06:21:37 +00:00
"""
values_count = len(values)
2018-10-11 05:56:46 +00:00
# Entropy is consumed from the seed in 3-byte (24 bit) chunks.
2018-10-16 00:17:34 +00:00
rand_bytes = 3
# The highest possible result of the RNG.
rand_max = 2 ** (rand_bytes * 8) - 1
# The range of the RNG places an upper-bound on the size of the list that
# may be shuffled. It is a logic error to supply an oversized list.
2018-10-11 05:56:46 +00:00
assert values_count < rand_max
2018-10-03 14:28:42 +00:00
2018-10-07 06:21:37 +00:00
output = [x for x in values]
2018-09-20 05:20:49 +00:00
source = seed
2018-10-07 06:21:37 +00:00
index = 0
2018-10-11 05:56:46 +00:00
while index < values_count - 1:
2018-10-16 00:17:34 +00:00
# Re-hash the `source` to obtain a new pattern of bytes.
2018-10-03 13:45:33 +00:00
source = hash(source)
2018-10-16 00:17:34 +00:00
# Iterate through the `source` bytes in 3-byte chunks.
for position in range(0, 32 - (32 % rand_bytes), rand_bytes):
# Determine the number of indices remaining in `values` and exit
# once the last index is reached.
2018-10-07 06:21:37 +00:00
remaining = values_count - index
2018-10-07 14:48:37 +00:00
if remaining == 1:
2018-09-20 05:20:49 +00:00
break
2018-10-07 06:21:37 +00:00
2018-10-16 00:17:34 +00:00
# Read 3-bytes of `source` as a 24-bit big-endian integer.
2018-11-30 14:28:33 +00:00
sample_from_source = int.from_bytes(source[position:position + rand_bytes], 'big')
2018-10-11 05:56:46 +00:00
# Sample values greater than or equal to `sample_max` will cause
# modulo bias when mapped into the `remaining` range.
sample_max = rand_max - rand_max % remaining
2018-10-07 06:21:37 +00:00
2018-10-11 05:56:46 +00:00
# Perform a swap if the consumed entropy will not cause modulo bias.
2018-10-10 18:47:40 +00:00
if sample_from_source < sample_max:
2018-10-16 00:17:34 +00:00
# Select a replacement index for the current index.
2018-10-07 06:21:37 +00:00
replacement_position = (sample_from_source % remaining) + index
2018-10-16 00:17:34 +00:00
# Swap the current index with the replacement index.
2018-10-07 14:48:37 +00:00
output[index], output[replacement_position] = output[replacement_position], output[index]
2018-10-07 06:21:37 +00:00
index += 1
else:
2018-10-11 05:56:46 +00:00
# The sample causes modulo bias. A new sample should be read.
2018-10-07 06:21:37 +00:00
pass
return output
2018-09-20 05:20:49 +00:00
```
2018-11-30 14:28:33 +00:00
#### `split`
2018-09-20 05:20:49 +00:00
```python
2018-11-30 14:28:33 +00:00
def split(values: List[Any], split_count: int) -> List[Any]:
2018-10-07 06:21:37 +00:00
"""
2018-11-30 14:28:33 +00:00
Splits ``values`` into ``split_count`` pieces.
2018-10-07 06:21:37 +00:00
"""
2018-11-30 14:28:33 +00:00
list_length = len(values)
2018-10-07 06:21:37 +00:00
return [
2018-11-30 14:28:33 +00:00
values[(list_length * i // split_count): (list_length * (i + 1) // split_count)]
2018-10-09 07:33:22 +00:00
for i in range(split_count)
2018-10-07 06:21:37 +00:00
]
2018-09-20 05:20:49 +00:00
```
2018-11-30 14:28:33 +00:00
#### `clamp`
2018-10-09 23:26:03 +00:00
```python
2018-10-14 13:30:52 +00:00
def clamp(minval: int, maxval: int, x: int) -> int:
2018-11-30 14:28:33 +00:00
"""
Clamps ``x`` between ``minval`` and ``maxval``.
"""
2018-10-14 13:30:52 +00:00
if x < = minval:
return minval
elif x >= maxval:
return maxval
else:
return x
2018-10-09 23:26:03 +00:00
```
2018-11-30 14:28:33 +00:00
#### `get_new_shuffling`
2018-09-20 05:20:49 +00:00
```python
2018-10-07 06:21:37 +00:00
def get_new_shuffling(seed: Hash32,
validators: List[ValidatorRecord],
2018-12-04 10:57:09 +00:00
crosslinking_start_shard: int) -> List[List[ShardCommittee]]:
2018-11-30 14:28:33 +00:00
"""
Shuffles ``validators`` into shard committees using ``seed`` as entropy.
"""
2018-11-28 07:23:37 +00:00
active_validator_indices = get_active_validator_indices(validators)
2018-10-07 06:21:37 +00:00
2018-10-14 13:30:52 +00:00
committees_per_slot = clamp(
1,
2018-11-30 14:28:33 +00:00
SHARD_COUNT // EPOCH_LENGTH,
len(active_validator_indices) // EPOCH_LENGTH // TARGET_COMMITTEE_SIZE,
2018-10-14 13:30:52 +00:00
)
2018-10-07 14:48:37 +00:00
2018-10-07 06:21:37 +00:00
# Shuffle with seed
2018-11-28 07:23:37 +00:00
shuffled_active_validator_indices = shuffle(active_validator_indices, seed)
2018-10-07 06:21:37 +00:00
2018-11-30 14:28:33 +00:00
# Split the shuffled list into epoch_length pieces
validators_per_slot = split(shuffled_active_validator_indices, EPOCH_LENGTH)
2018-10-07 06:21:37 +00:00
2018-11-30 14:28:33 +00:00
output = []
2018-10-07 06:21:37 +00:00
for slot, slot_indices in enumerate(validators_per_slot):
# Split the shuffled list into committees_per_slot pieces
2018-09-20 05:20:49 +00:00
shard_indices = split(slot_indices, committees_per_slot)
2018-10-07 06:21:37 +00:00
2018-10-14 13:30:52 +00:00
shard_id_start = crosslinking_start_shard + slot * committees_per_slot
2018-12-04 10:57:09 +00:00
shard_committees = [
ShardCommittee(
2018-10-14 13:30:52 +00:00
shard=(shard_id_start + shard_position) % SHARD_COUNT,
2018-11-30 14:28:33 +00:00
committee=indices,
total_validator_count=len(active_validator_indices),
2018-10-07 06:21:37 +00:00
)
2018-10-14 13:30:52 +00:00
for shard_position, indices in enumerate(shard_indices)
2018-10-07 06:21:37 +00:00
]
2018-10-14 13:30:52 +00:00
output.append(shards_and_committees_for_slot)
2018-10-07 06:21:37 +00:00
return output
2018-09-20 05:20:49 +00:00
```
2018-11-30 14:28:33 +00:00
Here's a diagram of what is going on:
2018-09-20 05:20:49 +00:00
![](http://vitalik.ca/files/ShuffleAndAssign.png?1)
2018-12-04 10:57:09 +00:00
#### `get_shard_committees_at_slot`
2018-09-20 05:20:49 +00:00
```python
2018-12-04 10:57:09 +00:00
def get_shard_committees_at_slot(state: BeaconState,
slot: int) -> List[ShardCommittee]:
2018-11-30 14:28:33 +00:00
"""
2018-12-04 10:57:09 +00:00
Returns the ``ShardCommittee`` for the ``slot``.
2018-11-30 14:28:33 +00:00
"""
2018-12-05 18:40:08 +00:00
earliest_slot_in_array = state.slot - (state.slot % EPOCH_LENGTH) - EPOCH_LENGTH
2018-11-30 14:28:33 +00:00
assert earliest_slot_in_array < = slot < earliest_slot_in_array + EPOCH_LENGTH * 2
2018-12-04 10:57:09 +00:00
return state.shard_committees_at_slots[slot - earliest_slot_in_array]
2018-11-30 14:28:33 +00:00
```
2018-09-20 05:20:49 +00:00
2018-11-30 14:28:33 +00:00
#### `get_block_hash`
```python
2018-11-15 13:20:25 +00:00
def get_block_hash(state: BeaconState,
2018-10-07 06:39:17 +00:00
slot: int) -> Hash32:
2018-11-30 14:28:33 +00:00
"""
Returns the block hash at a recent ``slot``.
"""
2018-12-05 18:40:08 +00:00
earliest_slot_in_array = state.slot - len(state.latest_block_hashes)
assert earliest_slot_in_array < = slot < state.slot
2018-11-30 14:28:33 +00:00
return state.latest_block_hashes[slot - earliest_slot_in_array]
2018-09-20 05:20:49 +00:00
```
2018-12-10 23:08:04 +00:00
`get_block_hash(_, s)` should always return `SSZTreeHash` of the block in the beacon chain at slot `s` , and `get_shard_committees_at_slot(_, s)` should not change unless the [validator ](#dfn-validator ) registry changes.
2018-09-20 05:20:49 +00:00
2018-11-30 14:28:33 +00:00
#### `get_beacon_proposer_index`
2018-11-20 07:40:04 +00:00
```python
2018-12-05 18:49:45 +00:00
def get_beacon_proposer_index(state: BeaconState,
2018-12-05 18:40:08 +00:00
slot: int) -> int:
2018-11-30 14:28:33 +00:00
"""
Returns the beacon proposer index for the ``slot``.
"""
2018-12-04 10:57:09 +00:00
first_committee = get_shard_committees_at_slot(state, slot)[0].committee
2018-11-30 14:28:33 +00:00
return first_committee[slot % len(first_committee)]
2018-11-20 07:40:04 +00:00
```
2018-12-06 16:25:35 +00:00
#### `get_updated_ancestor_hashes`
```python
2018-12-06 16:41:50 +00:00
def get_updated_ancestor_hashes(latest_block: BeaconBlock,
latest_hash: Hash32) -> List[Hash32]:
2018-12-07 13:46:52 +00:00
new_ancestor_hashes = copy.deepcopy(latest_block.ancestor_hashes)
2018-12-06 16:25:35 +00:00
for i in range(32):
2018-12-07 13:46:52 +00:00
if latest_block.slot % 2**i == 0:
2018-12-06 16:41:50 +00:00
new_ancestor_hashes[i] = latest_hash
2018-12-06 16:25:35 +00:00
return new_ancestor_hashes
```
2018-11-30 14:28:33 +00:00
#### `get_attestation_participants`
2018-11-20 21:49:43 +00:00
```python
2018-12-07 12:18:55 +00:00
def get_attestation_participants(state: BeaconState,
2018-11-30 14:28:33 +00:00
attestation_data: AttestationData,
participation_bitfield: bytes) -> List[int]:
"""
Returns the participant indices at for the ``attestation_data`` and ``participation_bitfield``.
"""
2018-12-04 10:57:09 +00:00
# Find the relevant committee
shard_committees = get_shard_committees_at_slot(state, attestation_data.slot)
shard_committee = [x for x in shard_committees if x.shard == attestation_data.shard][0]
assert len(participation_bitfield) == ceil_div8(len(shard_committee.committee))
# Find the participating attesters in the committee
2018-11-26 22:12:39 +00:00
participants = []
2018-12-04 10:57:09 +00:00
for i, validator_index in enumerate(shard_committee.committee):
participation_bit = (participation_bitfield[i//8] >> (7 - (i % 8))) % 2
if participation_bit == 1:
2018-11-30 14:28:33 +00:00
participants.append(validator_index)
2018-11-26 22:12:39 +00:00
return participants
2018-11-20 07:40:04 +00:00
```
2018-11-30 14:28:33 +00:00
#### `bytes1`, `bytes2`, ...
`bytes1(x): return x.to_bytes(1, 'big')` , `bytes2(x): return x.to_bytes(2, 'big')` , and so on for all integers, particularly 1, 2, 3, 4, 8, 32.
2018-09-20 05:20:49 +00:00
2018-11-30 14:28:33 +00:00
#### `get_effective_balance`
2018-11-25 11:33:05 +00:00
2018-12-01 05:29:19 +00:00
```python
2018-11-30 14:28:33 +00:00
def get_effective_balance(validator: ValidatorRecord) -> int:
"""
Returns the effective balance (also known as "balance at stake") for the ``validator``.
"""
return min(validator.balance, MAX_DEPOSIT)
2018-11-25 11:33:05 +00:00
```
2018-11-30 14:28:33 +00:00
#### `get_new_validator_registry_delta_chain_tip`
2018-10-02 23:05:30 +00:00
```python
2018-11-30 14:28:33 +00:00
def get_new_validator_registry_delta_chain_tip(current_validator_registry_delta_chain_tip: Hash32,
index: int,
pubkey: int,
flag: int) -> Hash32:
"""
Compute the next hash in the validator registry delta hash chain.
"""
return hash(
current_validator_registry_delta_chain_tip +
2018-11-26 13:12:14 +00:00
bytes1(flag) +
bytes3(index) +
2018-12-09 12:33:13 +00:00
bytes48(pubkey)
2018-11-26 13:12:14 +00:00
)
2018-10-02 23:05:30 +00:00
```
2018-09-20 05:20:49 +00:00
2018-12-10 22:14:08 +00:00
#### `get_fork_version`
```python
def get_fork_version(fork_data: ForkData,
slot: int) -> int:
if slot < fork_data.fork_slot:
return fork_data.pre_fork_version
else:
return fork_data.post_fork_version
```
2018-12-05 14:41:11 +00:00
#### `get_domain`
```python
def get_domain(fork_data: ForkData,
slot: int,
domain_type: int) -> int:
return get_fork_version(
fork_data,
slot
) * 2* *32 + domain_type
```
2018-12-10 22:58:36 +00:00
#### `SSZTreeHash`
`SSZTreeHash` is a function for hashing objects into a single root utilizing a hash tree structure. `SSZTreeHash` is defined in the [SimpleSerialize spec ](https://github.com/ethereum/eth2.0-specs/blob/master/specs/simple-serialize.md#tree-hash ).
2018-12-07 20:09:49 +00:00
#### `verify_casper_votes`
2018-12-07 01:02:23 +00:00
```python
2018-12-10 10:11:41 +00:00
def verify_casper_votes(state: BeaconState, votes: SlashableVoteData) -> bool:
2018-12-07 20:09:49 +00:00
if len(votes.aggregate_signature_poc_0_indices) + len(votes.aggregate_signature_poc_1_indices) > MAX_CASPER_VOTES:
return False
pubs = [aggregate_pubkey([state.validators[i].pubkey for i in votes.aggregate_signature_poc_0_indices]),
aggregate_pubkey([state.validators[i].pubkey for i in votes.aggregate_signature_poc_1_indices])]
return BLSMultiVerify(pubkeys=pubs, msgs=[SSZTreeHash(votes)+bytes1(0), SSZTreeHash(votes)+bytes1(1), sig=aggregate_signature)
2018-12-07 01:02:23 +00:00
```
2018-11-30 14:28:33 +00:00
#### `integer_squareroot`
2018-09-30 23:02:09 +00:00
2018-09-30 14:56:43 +00:00
```python
2018-11-30 14:28:33 +00:00
def integer_squareroot(n: int) -> int:
"""
The largest integer ``x`` such that ``x**2`` is less than ``n``.
"""
2018-09-30 23:38:47 +00:00
x = n
y = (x + 1) // 2
while y < x:
x = y
y = (x + n // x) // 2
return x
2018-09-30 14:56:43 +00:00
```
2018-12-10 22:14:08 +00:00
#### `BLSVerify`
2018-12-11 16:13:31 +00:00
`BLSVerify` is a function for verifying a BLS12-381 signature, defined in the [BLS Verification spec ](https://github.com/ethereum/eth2.0-specs/blob/master/specs/bls_verify.md ).
2018-12-10 22:14:08 +00:00
2018-09-20 05:20:49 +00:00
### On startup
2018-12-05 11:22:15 +00:00
A valid block with slot `INITIAL_SLOT_NUMBER` (a "genesis block") has the following values. Other validity rules (e.g. requiring a signature) do not apply.
2018-11-16 16:41:59 +00:00
```python
{
2018-12-07 01:02:23 +00:00
'header': BeaconBlockHeader(
slot=INITIAL_SLOT_NUMBER,
ancestor_hashes=[ZERO_HASH for i in range(32)],
state_root=STARTUP_STATE_ROOT,
randao_reveal=ZERO_HASH,
candidate_pow_receipt_root=ZERO_HASH,
proposer_signature=[0, 0]
),
'body': BeaconBlockBody(
proposer_slashings=[],
casper_slashings=[],
attestations=[],
deposits=[],
exits=[]
),
2018-11-16 16:41:59 +00:00
}
```
`STARTUP_STATE_ROOT` is the root of the initial state, computed by running the following code:
2018-10-02 15:20:07 +00:00
```python
2018-12-11 16:02:59 +00:00
def on_startup(initial_validator_deposits: List[Deposit],
2018-11-26 16:21:59 +00:00
genesis_time: int,
2018-11-26 13:12:14 +00:00
processed_pow_receipt_root: Hash32) -> BeaconState:
2018-11-15 13:20:25 +00:00
state = BeaconState(
2018-12-04 21:28:31 +00:00
# Misc
slot=INITIAL_SLOT_NUMBER,
genesis_time=genesis_time,
fork_data=ForkData(
pre_fork_version=INITIAL_FORK_VERSION,
post_fork_version=INITIAL_FORK_VERSION,
fork_slot=INITIAL_SLOT_NUMBER,
),
# Validator registry
2018-12-11 16:02:59 +00:00
validator_registry=[],
2018-11-30 14:28:33 +00:00
validator_registry_latest_change_slot=INITIAL_SLOT_NUMBER,
validator_registry_exit_count=0,
validator_registry_delta_chain_tip=ZERO_HASH,
2018-12-04 21:28:31 +00:00
2018-11-30 14:28:33 +00:00
# Randomness and committees
randao_mix=ZERO_HASH,
next_seed=ZERO_HASH,
2018-12-10 21:16:06 +00:00
shard_committees_at_slots=[],
persistent_committees=[],
2018-11-06 09:43:21 +00:00
persistent_committee_reassignments=[],
2018-12-04 21:28:31 +00:00
2018-11-30 14:28:33 +00:00
# Finality
previous_justified_slot=INITIAL_SLOT_NUMBER,
justified_slot=INITIAL_SLOT_NUMBER,
2018-12-04 10:57:09 +00:00
justification_bitfield=0,
2018-11-30 14:28:33 +00:00
finalized_slot=INITIAL_SLOT_NUMBER,
2018-12-04 21:28:31 +00:00
2018-11-30 14:28:33 +00:00
# Recent state
2018-12-05 14:34:50 +00:00
latest_crosslinks=[CrosslinkRecord(slot=INITIAL_SLOT_NUMBER, shard_block_hash=ZERO_HASH) for _ in range(SHARD_COUNT)],
2018-11-30 14:28:33 +00:00
latest_block_hashes=[ZERO_HASH for _ in range(EPOCH_LENGTH * 2)],
latest_penalized_exit_balances=[],
latest_attestations=[],
2018-12-04 21:28:31 +00:00
2018-11-30 14:28:33 +00:00
# PoW receipt root
2018-11-24 21:41:53 +00:00
processed_pow_receipt_root=processed_pow_receipt_root,
2018-11-24 21:12:27 +00:00
candidate_pow_receipt_roots=[],
2018-10-09 07:33:22 +00:00
)
2018-12-10 21:16:06 +00:00
# handle initial deposits and activations
2018-12-11 16:02:59 +00:00
for deposit in initial_validator_deposits:
2018-12-10 21:16:06 +00:00
validator_index = process_deposit(
state=state,
2018-12-11 16:02:59 +00:00
pubkey=deposit.deposit_data.deposit_parameters.pubkey,
deposit=deposit.deposit_data.value,
proof_of_possession=deposit.deposit_data.deposit_parameters.proof_of_possession,
withdrawal_credentials=deposit.deposit_data.deposit_parameters.withdrawal_credentials,
randao_commitment=deposit.deposit_data.deposit_parameters.randao_commitment
2018-12-10 21:16:06 +00:00
)
if state.validator_registry[index].balance >= MAX_DEPOSIT:
2018-12-11 15:49:50 +00:00
update_validator_status(state, index, ACTIVE)
2018-12-10 21:16:06 +00:00
# set initial committee shuffling
initial_shuffling = get_new_shuffling(ZERO_HASH, initial_validator_registry, 0)
state.shard_committees_at_slots = initial_shuffling + initial_shuffling
# set initial persistent shuffling
active_validator_indices = get_active_validator_indices(state.validator_registry)
state.persistent_committees = split(shuffle(active_validator_indices, ZERO_HASH), SHARD_COUNT)
2018-11-15 13:20:25 +00:00
return state
2018-10-02 15:20:07 +00:00
```
2018-09-20 05:20:49 +00:00
2018-12-10 21:16:06 +00:00
### Routine for processing deposits
2018-10-18 02:00:45 +00:00
2018-12-10 22:14:08 +00:00
First, a helper function:
2018-10-18 02:00:45 +00:00
```python
2018-11-27 11:36:47 +00:00
def min_empty_validator_index(validators: List[ValidatorRecord], current_slot: int) -> int:
2018-10-18 02:00:45 +00:00
for i, v in enumerate(validators):
2018-12-04 10:57:09 +00:00
if v.balance == 0 and v.latest_status_change_slot + ZERO_BALANCE_VALIDATOR_TTL < = current_slot:
2018-10-18 02:00:45 +00:00
return i
return None
2018-12-10 21:16:06 +00:00
```
2018-10-18 02:00:45 +00:00
2018-12-10 22:14:08 +00:00
Now, to add a [validator ](#dfn-validator ) or top up an existing [validator ](#dfn-validator )'s balance by some `deposit` amount:
2018-11-27 03:52:06 +00:00
2018-12-10 21:16:06 +00:00
```python
def process_deposit(state: BeaconState,
pubkey: int,
deposit: int,
proof_of_possession: bytes,
withdrawal_credentials: Hash32,
randao_commitment: Hash32,
status: int) -> int:
"""
Process a deposit from Ethereum 1.0.
Note that this function mutates ``state``.
"""
2018-11-26 13:12:14 +00:00
assert BLSVerify(
pub=pubkey,
2018-11-30 14:28:33 +00:00
msg=hash(bytes32(pubkey) + withdrawal_credentials + randao_commitment),
2018-11-26 13:12:14 +00:00
sig=proof_of_possession,
domain=get_domain(
2018-12-10 21:16:06 +00:00
state.fork_data,
state.slot,
2018-11-26 13:12:14 +00:00
DOMAIN_DEPOSIT
)
)
2018-12-10 21:16:06 +00:00
validator_pubkeys = [v.pubkey for v in state.validator_registry]
2018-12-10 19:55:11 +00:00
2018-11-27 19:51:12 +00:00
if pubkey not in validator_pubkeys:
2018-11-30 14:28:33 +00:00
# Add new validator
validator = ValidatorRecord(
2018-11-27 19:51:12 +00:00
pubkey=pubkey,
withdrawal_credentials=withdrawal_credentials,
randao_commitment=randao_commitment,
randao_skips=0,
2018-11-30 14:28:33 +00:00
balance=deposit,
2018-12-10 21:16:06 +00:00
status=PENDING_ACTIVATION,
latest_status_change_slot=state.slot,
2018-11-30 14:28:33 +00:00
exit_count=0
2018-11-27 19:51:12 +00:00
)
2018-11-30 14:28:33 +00:00
index = min_empty_validator_index(validators_copy)
2018-11-27 19:51:12 +00:00
if index is None:
2018-12-10 21:16:06 +00:00
state.validator_registry.append(validator)
2018-11-30 14:28:33 +00:00
index = len(validators_copy) - 1
2018-11-27 19:51:12 +00:00
else:
2018-12-10 21:16:06 +00:00
state.validator_registry[index] = validator
2018-11-27 19:51:12 +00:00
else:
2018-11-30 14:28:33 +00:00
# Increase balance by deposit
2018-11-27 19:51:12 +00:00
index = validator_pubkeys.index(pubkey)
2018-12-10 21:16:06 +00:00
validator = state.validator_registry[index]
2018-11-30 14:28:33 +00:00
assert validator.withdrawal_credentials == withdrawal_credentials
validator.balance += deposit
2018-11-27 19:51:12 +00:00
2018-12-10 21:16:06 +00:00
return index
2018-11-20 01:13:58 +00:00
```
2018-12-05 18:40:08 +00:00
2018-12-10 22:30:25 +00:00
### Routine for updating validator status
2018-10-01 22:19:16 +00:00
```python
2018-12-11 15:49:50 +00:00
def update_validator_status(state: BeaconState,
index: int,
2018-12-10 21:16:06 +00:00
new_status: int) -> None:
2018-11-27 17:06:09 +00:00
"""
2018-12-10 21:16:06 +00:00
Update the validator status with the given ``index`` to ``new_status``.
2018-12-11 15:49:50 +00:00
Handle other general accounting related to this status update.
2018-12-04 10:57:09 +00:00
Note that this function mutates ``state``.
2018-11-27 17:06:09 +00:00
"""
2018-12-10 21:16:06 +00:00
if new_status == ACTIVE:
2018-12-11 15:49:50 +00:00
activate_validator(state, index)
2018-12-10 21:16:06 +00:00
if new_status == ACTIVE_PENDING_EXIT:
2018-12-11 15:49:50 +00:00
initiate_validator_exit(state, index)
2018-12-10 21:16:06 +00:00
if new_status in [EXITED_WITH_PENALTY, EXITED_WITHOUT_PENALTY]:
2018-12-11 15:49:50 +00:00
exit_validator(state, index, new_status)
2018-12-10 21:16:06 +00:00
```
2018-11-27 17:07:30 +00:00
2018-12-10 22:42:28 +00:00
The following are helpers and should only be called via `update_validator_status` :
2018-12-10 21:16:06 +00:00
```python
2018-12-11 15:49:50 +00:00
def activate_validator(state: BeaconState,
index: int) -> None:
2018-12-10 21:16:06 +00:00
"""
Activate the validator with the given ``index``.
Note that this function mutates ``state``.
"""
if validator.status != PENDING_ACTIVATION:
return
validator = state.validator_registry[index]
validator.status = ACTIVE
validator.latest_status_change_slot = state.slot
state.validator_registry_delta_chain_tip = get_new_validator_registry_delta_chain_tip(
validator_registry_delta_chain_tip=validator_registry_delta_chain_tip,
2018-12-10 22:17:42 +00:00
index=index,
2018-12-10 21:16:06 +00:00
pubkey=validator.pubkey,
flag=ACTIVATION,
)
2018-10-01 22:19:16 +00:00
```
2018-12-10 21:16:06 +00:00
```python
2018-12-11 15:49:50 +00:00
def initiate_validator_exit(state: BeaconState,
index: int) -> None:
"""
Initiate exit for the validator with the given ``index``.
Note that this function mutates ``state``.
"""
if validator.status != ACTIVE:
return
2018-12-10 21:16:06 +00:00
validator = state.validator_registry[index]
validator.status = ACTIVE_PENDING_EXIT
validator.latest_status_change_slot = state.slot
```
2018-10-11 18:14:48 +00:00
```python
2018-12-11 15:49:50 +00:00
def exit_validator(state: BeaconState,
index: int,
2018-12-10 21:16:06 +00:00
new_status: int) -> None:
2018-11-27 17:06:09 +00:00
"""
2018-12-04 10:57:09 +00:00
Exit the validator with the given ``index``.
Note that this function mutates ``state``.
2018-11-27 17:06:09 +00:00
"""
2018-11-30 14:28:33 +00:00
validator = state.validator_registry[index]
2018-12-10 21:16:06 +00:00
prev_status = validator.status
2018-12-11 15:49:50 +00:00
if prev_status == EXITED_WITH_PENALTY:
return
2018-12-07 12:18:55 +00:00
validator.status = new_status
validator.latest_status_change_slot = state.slot
2018-11-30 14:28:33 +00:00
2018-12-10 11:22:42 +00:00
if new_status == EXITED_WITH_PENALTY:
2018-12-07 12:18:55 +00:00
state.latest_penalized_exit_balances[state.slot // COLLECTIVE_PENALTY_CALCULATION_PERIOD] += get_effective_balance(validator)
2018-12-10 19:55:11 +00:00
2018-12-07 12:18:55 +00:00
whistleblower = state.validator_registry[get_beacon_proposer_index(state, state.slot)]
2018-11-30 14:28:33 +00:00
whistleblower_reward = validator.balance // WHISTLEBLOWER_REWARD_QUOTIENT
whistleblower.balance += whistleblower_reward
validator.balance -= whistleblower_reward
2018-12-11 15:49:50 +00:00
if prev_status == EXITED_WITHOUT_PENALTY
2018-12-10 21:16:06 +00:00
return
2018-12-10 21:56:22 +00:00
# The following updates only occur if not previous exited
2018-12-10 21:16:06 +00:00
state.validator_registry_exit_count += 1
validator.exit_count = state.validator_registry_exit_count
2018-11-30 14:28:33 +00:00
state.validator_registry_delta_chain_tip = get_new_validator_registry_delta_chain_tip(
validator_registry_delta_chain_tip=state.validator_registry_delta_chain_tip,
2018-11-26 13:12:14 +00:00
index=index,
pubkey=validator.pubkey,
2018-12-10 21:16:06 +00:00
flag=EXIT
2018-11-26 13:12:14 +00:00
)
2018-12-10 21:16:06 +00:00
# Remove validator from persistent committees
for committee in state.persistent_committees:
for i, validator_index in committee:
if validator_index == index:
committee.pop(i)
break
2018-10-11 18:14:48 +00:00
```
2018-12-04 21:28:31 +00:00
## Per-slot processing
2018-09-20 05:20:49 +00:00
2018-12-05 18:40:08 +00:00
Below are the processing steps that happen at every slot.
2018-12-05 17:30:37 +00:00
2018-12-06 22:12:33 +00:00
* Let `latest_block` be the latest `BeaconBlock` that was processed in the chain.
2018-12-10 22:58:36 +00:00
* Let `latest_hash` be the `SSZTreeHash` of `latest_block` .
2018-12-06 16:25:35 +00:00
* Set `state.slot += 1`
2018-12-06 16:41:50 +00:00
* Set `state.latest_block_hashes = state.latest_block_hashes + [latest_hash]` . (The output of `get_block_hash` should not change, except that it will no longer throw for `state.slot - 1` ).
2018-09-20 05:20:49 +00:00
2018-12-05 18:40:08 +00:00
If there is a block from the proposer for `state.slot` , we process that incoming block:
2018-12-10 10:11:41 +00:00
2018-12-05 18:40:08 +00:00
* Let `block` be that associated incoming block.
2018-12-07 13:46:52 +00:00
* Verify that `block.slot == state.slot`
* Verify that `block.ancestor_hashes` equals `get_updated_ancestor_hashes(latest_block, latest_hash)` .
2018-09-20 05:20:49 +00:00
2018-12-06 22:12:33 +00:00
If there is no block from the proposer at state.slot:
2018-12-10 10:11:41 +00:00
2018-12-06 22:12:33 +00:00
* Set `state.validator_registry[get_beacon_proposer_index(state, state.slot)].randao_skips += 1` .
2018-12-06 16:41:50 +00:00
* Skip all other per-slot processing. Move directly to [per-epoch processing ](#per-epoch-processing ).
2018-09-20 05:20:49 +00:00
2018-12-05 11:22:15 +00:00
### Proposer signature
2018-12-10 22:58:36 +00:00
* Let `block_hash_without_sig` be the `SSZTreeHash` of `block` where `block.signature` is set to `[0, 0]` .
* Let `proposal_hash = SSZTreeHash(ProposalSignedData(state.slot, BEACON_CHAIN_SHARD_NUMBER, block_hash_without_sig))` .
2018-12-07 13:46:52 +00:00
* Verify that `BLSVerify(pubkey=state.validator_registry[get_beacon_proposer_index(state, state.slot)].pubkey, data=proposal_hash, sig=block.signature, domain=get_domain(state.fork_data, state.slot, DOMAIN_PROPOSAL))` .
2018-09-20 05:20:49 +00:00
2018-12-05 11:22:15 +00:00
### RANDAO
2018-10-11 17:57:30 +00:00
* Let `repeat_hash(x, n) = x if n == 0 else repeat_hash(hash(x), n-1)` .
2018-12-04 21:28:31 +00:00
* Let `proposer = state.validator_registry[get_beacon_proposer_index(state, state.slot)]` .
2018-12-07 13:46:52 +00:00
* Verify that `repeat_hash(block.randao_reveal, proposer.randao_skips + 1) == proposer.randao_commitment` .
* Set `state.randao_mix = xor(state.randao_mix, block.randao_reveal)` .
* Set `proposer.randao_commitment = block.randao_reveal` .
2018-11-30 14:28:33 +00:00
* Set `proposer.randao_skips = 0` .
2018-09-20 05:20:49 +00:00
2018-12-05 11:22:15 +00:00
### PoW receipt root
2018-11-22 23:09:36 +00:00
2018-12-07 13:46:52 +00:00
* If `block.candidate_pow_receipt_root` is `x.candidate_pow_receipt_root` for some `x` in `state.candidate_pow_receipt_roots` , set `x.votes += 1` .
* Otherwise, append to `state.candidate_pow_receipt_roots` a new `CandidatePoWReceiptRootRecord(candidate_pow_receipt_root=block.candidate_pow_receipt_root, votes=1)` .
2018-11-30 14:28:33 +00:00
2018-12-07 18:51:15 +00:00
### Block operations
2018-11-16 12:54:03 +00:00
2018-12-07 01:02:23 +00:00
#### Proposer slashings
2018-11-16 15:48:57 +00:00
2018-12-07 01:02:23 +00:00
Verify that `len(block.body.proposer_slashings) <= MAX_PROPOSER_SLASHINGS` .
2018-11-16 12:54:03 +00:00
2018-12-07 01:02:23 +00:00
For each `proposer_slashing` in `block.body.proposer_slashings` :
2018-11-16 12:54:03 +00:00
2018-12-07 18:43:11 +00:00
* Let `proposer = state.validator_registry[proposer_slashing.proposer_index]` .
2018-12-10 22:58:36 +00:00
* Verify that `BLSVerify(pubkey=proposer.pubkey, msg=SSZTreeHash(proposer_slashing.proposal_data_1), sig=proposer_slashing.proposal_signature_1, domain=get_domain(state.fork_data, proposer_slashing.proposal_data_1.slot, DOMAIN_PROPOSAL))` .
* Verify that `BLSVerify(pubkey=proposer.pubkey, msg=SSZTreeHash(proposer_slashing.proposal_data_2), sig=proposer_slashing.proposal_signature_2, domain=get_domain(state.fork_data, proposer_slashing.proposal_data_2.slot, DOMAIN_PROPOSAL))` .
2018-12-07 01:02:23 +00:00
* Verify that `proposer_slashing.proposal_data_1.slot == proposer_slashing.proposal_data_2.slot` .
2018-12-07 18:43:11 +00:00
* Verify that `proposer_slashing.proposal_data_1.shard == proposer_slashing.proposal_data_2.shard` .
* Verify that `proposer_slashing.proposal_data_1.block_hash != proposer_slashing.proposal_data_2.block_hash` .
2018-12-07 01:02:23 +00:00
* Verify that `proposer.status != EXITED_WITH_PENALTY` .
2018-12-11 15:49:50 +00:00
* Run `update_validator_status(state, proposer_slashing.proposer_index, new_status=EXITED_WITH_PENALTY)` .
2018-11-16 12:54:03 +00:00
2018-12-07 01:02:23 +00:00
#### Casper slashings
2018-11-16 12:54:03 +00:00
2018-12-07 01:02:23 +00:00
Verify that `len(block.body.casper_slashings) <= MAX_CASPER_SLASHINGS` .
2018-11-16 12:54:03 +00:00
2018-12-07 01:02:23 +00:00
For each `casper_slashing` in `block.body.casper_slashings` :
2018-11-16 12:54:03 +00:00
2018-12-07 20:09:49 +00:00
* Verify that `verify_casper_votes(state, casper_slashing.votes_1)` .
* Verify that `verify_casper_votes(state, casper_slashing.votes_2)` .
* Verify that `casper_slashing.votes_1.data != casper_slashing.votes_2.data` .
2018-12-04 10:57:09 +00:00
* Let `indices(vote) = vote.aggregate_signature_poc_0_indices + vote.aggregate_signature_poc_1_indices` .
2018-12-07 20:09:49 +00:00
* Let `intersection = [x for x in indices(casper_slashing.votes_1) if x in indices(casper_slashing.votes_2)]` .
2018-11-30 14:28:33 +00:00
* Verify that `len(intersection) >= 1` .
2018-12-07 20:09:49 +00:00
* Verify that `casper_slashing.votes_1.data.justified_slot + 1 < casper_slashing.votes_2.data.justified_slot + 1 == casper_slashing.votes_2.data.slot < casper_slashing.votes_1.data.slot` or `casper_slashing.votes_1.data.slot == casper_slashing.votes_2.data.slot` .
2018-12-11 15:49:50 +00:00
* For each [validator ](#dfn-validator ) index `i` in `intersection` , if `state.validator_registry[i].status` does not equal `EXITED_WITH_PENALTY` , then run `update_validator_status(state, i, new_status=EXITED_WITH_PENALTY)`
2018-09-20 05:20:49 +00:00
2018-12-07 01:02:23 +00:00
#### Attestations
2018-11-16 12:54:03 +00:00
2018-12-07 01:02:23 +00:00
Verify that `len(block.body.attestations) <= MAX_ATTESTATIONS` .
2018-11-20 07:40:04 +00:00
2018-12-07 01:02:23 +00:00
For each `attestation` in `block.body.attestations` :
2018-11-30 14:28:33 +00:00
2018-12-10 20:38:32 +00:00
* Verify that `attestation.data.slot + MIN_ATTESTATION_INCLUSION_DELAY <= state.slot` .
* Verify that `attestation.data.slot + EPOCH_LENGTH >= state.slot` .
2018-12-07 01:02:23 +00:00
* Verify that `attestation.data.justified_slot` is equal to `state.justified_slot if attestation.data.slot >= state.slot - (state.slot % EPOCH_LENGTH) else state.previous_justified_slot` .
* Verify that `attestation.data.justified_block_hash` is equal to `get_block_hash(state, attestation.data.justified_slot)` .
* Verify that either `attestation.data.latest_crosslink_hash` or `attestation.data.shard_block_hash` equals `state.latest_crosslinks[shard].shard_block_hash` .
* `aggregate_signature` verification:
* Let `participants = get_attestation_participants(state, attestation.data, attestation.participation_bitfield)` .
* Let `group_public_key = BLSAddPubkeys([state.validator_registry[v].pubkey for v in participants])` .
2018-12-10 20:38:32 +00:00
* Verify that `BLSVerify(pubkey=group_public_key, msg=SSZTreeHash(attestation.data) + bytes1(0), sig=attestation.aggregate_signature, domain=get_domain(state.fork_data, attestation.data.slot, DOMAIN_ATTESTATION))` .
* [TO BE REMOVED IN PHASE 1] Verify that `attestation.data.shard_block_hash == ZERO_HASH` .
2018-12-07 01:02:23 +00:00
* Append `PendingAttestationRecord(data=attestation.data, participation_bitfield=attestation.participation_bitfield, custody_bitfield=attestation.custody_bitfield, slot_included=state.slot)` to `state.latest_attestations` .
2018-11-20 07:40:04 +00:00
2018-12-07 01:02:23 +00:00
#### Deposits
2018-11-18 12:06:01 +00:00
2018-12-07 01:02:23 +00:00
Verify that `len(block.body.deposits) <= MAX_DEPOSITS` .
2018-11-18 12:06:01 +00:00
2018-12-10 22:17:42 +00:00
[TODO: add logic to ensure that deposits from 1.0 chain are processed in order]
2018-12-10 22:14:08 +00:00
2018-12-07 01:02:23 +00:00
For each `deposit` in `block.body.deposits` :
2018-11-18 12:06:01 +00:00
2018-12-07 18:51:15 +00:00
* Let `serialized_deposit_data` be the serialized form of `deposit.deposit_data` . It should be the `DepositParameters` followed by 8 bytes for `deposit_data.value` and 8 bytes for `deposit_data.timestamp` . That is, it should match `deposit_data` in the [Ethereum 1.0 deposit contract ](#ethereum-10-chain-deposit-contract ) of which the hash was placed into the Merkle tree.
2018-12-07 01:02:23 +00:00
* Use the following procedure to verify `deposit.merkle_branch` , setting `leaf=serialized_deposit_data` , `depth=DEPOSIT_CONTRACT_TREE_DEPTH` and `root=state.processed_pow_receipt_root` :
2018-11-18 12:06:01 +00:00
```python
def verify_merkle_branch(leaf: Hash32, branch: [Hash32], depth: int, index: int, root: Hash32) -> bool:
value = leaf
for i in range(depth):
if index % 2:
value = hash(branch[i], value)
else:
value = hash(value, branch[i])
return value == root
```
2018-12-07 01:02:23 +00:00
* Verify that `state.slot - (deposit.deposit_data.timestamp - state.genesis_time) // SLOT_DURATION < ZERO_BALANCE_VALIDATOR_TTL` .
2018-11-30 14:28:33 +00:00
* Run the following:
2018-11-27 18:25:25 +00:00
2018-11-30 14:28:33 +00:00
```python
process_deposit(
state=state,
2018-12-07 01:02:23 +00:00
pubkey=deposit.deposit_data.deposit_parameters.pubkey,
deposit=deposit.deposit_data.value,
proof_of_possession=deposit.deposit_data.deposit_parameters.proof_of_possession,
withdrawal_credentials=deposit.deposit_data.deposit_parameters.withdrawal_credentials,
2018-12-10 21:16:06 +00:00
randao_commitment=deposit.deposit_data.deposit_parameters.randao_commitment
2018-11-30 14:28:33 +00:00
)
```
2018-11-18 12:06:01 +00:00
2018-12-07 01:02:23 +00:00
#### Exits
Verify that `len(block.body.exits) <= MAX_EXITS` .
For each `exit` in `block.body.exits` :
* Let `validator = state.validator_registry[exit.validator_index]` .
* Verify that `BLSVerify(pubkey=validator.pubkey, msg=ZERO_HASH, sig=exit.signature, domain=get_domain(state.fork_data, exit.slot, DOMAIN_EXIT))` .
* Verify that `validator.status == ACTIVE` .
* Verify that `state.slot >= exit.slot` .
* Verify that `state.slot >= validator.latest_status_change_slot + SHARD_PERSISTENT_COMMITTEE_CHANGE_PERIOD` .
2018-12-11 15:49:50 +00:00
* Run `update_validator_status(state, validator_index, new_status=ACTIVE_PENDING_EXIT)` .
2018-12-10 10:11:41 +00:00
2018-12-07 12:18:55 +00:00
### Ejections
* Run `process_ejections(state)` .
2018-12-10 10:11:41 +00:00
```python
2018-12-07 12:18:55 +00:00
def process_ejections(state: BeaconState) -> None:
"""
Iterate through the validator registry
and eject active validators with balance below ``EJECTION_BALANCE``.
"""
2018-12-10 22:42:28 +00:00
for index, validator in enumerate(state.validator_registry):
if is_active_validator(validor) and validator.balance < EJECTION_BALANCE:
2018-12-11 15:49:50 +00:00
update_validator_status(state, index, new_status=EXITED_WITHOUT_PENALTY)
2018-12-07 12:18:55 +00:00
```
2018-12-04 21:28:31 +00:00
## Per-epoch processing
2018-09-20 05:20:49 +00:00
2018-12-06 22:38:40 +00:00
The steps below happen when `state.slot % EPOCH_LENGTH == 0` .
2018-10-02 02:21:15 +00:00
2018-12-05 11:22:15 +00:00
### Helpers
2018-09-20 05:20:49 +00:00
2018-11-30 17:31:09 +00:00
All [validators ](#dfn-validator ):
2018-09-20 05:20:49 +00:00
2018-11-30 14:28:33 +00:00
* Let `active_validators = [state.validator_registry[i] for i in get_active_validator_indices(state.validator_registry)]` .
2018-12-05 11:22:15 +00:00
* Let `total_balance = sum([get_effective_balance(v) for v in active_validators])` .
2018-12-05 14:34:50 +00:00
* Let `base_reward_quotient = BASE_REWARD_QUOTIENT * integer_squareroot(total_balance // GWEI_PER_ETH)` .
* Let `base_reward(v) = get_effective_balance(v) // base_reward_quotient` for any validator `v` .
2018-12-11 19:22:17 +00:00
* Let `base_inactivity_penalty(v, slots_since_finality) = base_reward(v) + get_effective_balance(v) * slots_since_finality // INACTIVITY_PENALTY_QUOTIENT` for any validator `v` .
2018-09-20 05:20:49 +00:00
2018-11-30 17:31:09 +00:00
[Validators ](#dfn-Validator ) justifying the epoch boundary block at the start of the current epoch:
2018-10-06 12:32:19 +00:00
2018-12-06 22:38:40 +00:00
* Let `this_epoch_attestations = [a for a in state.latest_attestations if state.slot - EPOCH_LENGTH <= a.data.slot < state.slot]` . (Note: this is the set of attestations of slots in the epoch `state.slot-EPOCH_LENGTH...state.slot-1` , _not_ attestations that got included in the chain during the epoch `state.slot-EPOCH_LENGTH...state.slot-1` .)
* Let `this_epoch_boundary_attestations = [a for a in this_epoch_attestations if a.data.epoch_boundary_hash == get_block_hash(state, state.slot-EPOCH_LENGTH) and a.justified_slot == state.justified_slot]` .
2018-12-07 12:23:55 +00:00
* Let `this_epoch_boundary_attester_indices` be the union of the [validator ](#dfn-validator ) index sets given by `[get_attestation_participants(state, a.data, a.participation_bitfield) for a in this_epoch_boundary_attestations]` .
* Let `this_epoch_boundary_attesters = [state.validator_registry[i] for indices in this_epoch_boundary_attester_indices for i in indices]` .
2018-11-30 14:28:33 +00:00
* Let `this_epoch_boundary_attesting_balance = sum([get_effective_balance(v) for v in this_epoch_boundary_attesters])` .
2018-10-06 12:32:19 +00:00
2018-11-30 17:31:09 +00:00
[Validators ](#dfn-Validator ) justifying the epoch boundary block at the start of the previous epoch:
2018-11-26 22:12:39 +00:00
2018-12-06 22:56:23 +00:00
* Let `previous_epoch_attestations = [a for a in state.latest_attestations if state.slot - 2 * EPOCH_LENGTH <= a.slot < state.slot - EPOCH_LENGTH]` .
2018-12-11 19:22:17 +00:00
* Let `previous_epoch_attester_indices` be the union of the validator index sets given by `[get_attestation_participants(state, a.data, a.participation_bitfield) for a in previous_epoch_attestations]` .
* Let `previous_epoch_attesters = [state.validator_registry[i] for indices in previous_epoch_attester_indices for i in indices]` .
* Let `previous_epoch_justified_attestations = [a for a in this_epoch_attestations + previous_epoch_attestations if a.justified_slot == state.previous_justified_slot]` .
* Let `previous_epoch_justified_attester_indices` be the union of the validator index sets given by `[get_attestation_participants(state, a.data, a.participation_bitfield) for a in previous_epoch_justified_attestations]` .
* Let `previous_epoch_justified_attesters = [state.validator_registry[i] for indices in previous_epoch_justified_attester_indices for i in indices]` .
* Let `previous_epoch_justified_attesting_balance = sum([get_effective_balance(v) for v in previous_epoch_justified_attesters])` .
* Let `previous_epoch_boundary_attestations = [a for a in previous_epoch_justified_attestations if a.epoch_boundary_hash == get_block_hash(state, state.slot - 2 * EPOCH_LENGTH)]` .
2018-12-07 12:23:55 +00:00
* Let `previous_epoch_boundary_attester_indices` be the union of the validator index sets given by `[get_attestation_participants(state, a.data, a.participation_bitfield) for a in previous_epoch_boundary_attestations]` .
* Let `previous_epoch_boundary_attesters = [state.validator_registry[i] for indices in previous_epoch_boundary_attester_indices for i in indices]` .
2018-11-30 14:28:33 +00:00
* Let `previous_epoch_boundary_attesting_balance = sum([get_effective_balance(v) for v in previous_epoch_boundary_attesters])` .
2018-11-26 22:12:39 +00:00
2018-12-11 19:22:17 +00:00
* Let `previous_epoch_head_attestations = [a for a in previous_epoch_attestations if a.beacon_block_hash == get_block_hash(state, a.slot)]` .
* Let `previous_epoch_head_attester_indices` be the union of the validator index sets given by `[get_attestation_participants(state, a.data, a.participation_bitfield) for a in previous_epoch_head_attestations]` .
* Let `previous_epoch_head_attesters = [state.validator_registry[i] for indices in previous_epoch_head_attester_indices for i in indices]` .
* Let `previous_epoch_head_attesting_balance = sum([get_effective_balance(v) for v in previous_epoch_head_attesters])` .
2018-12-05 14:34:50 +00:00
For every `shard_committee` in `state.shard_committees_at_slots` :
2018-11-26 22:12:39 +00:00
2018-12-05 14:34:50 +00:00
* Let `attesting_validators(shard_committee, shard_block_hash)` be the union of the [validator ](#dfn-validator ) index sets given by `[get_attestation_participants(state, a.data, a.participation_bitfield) for a in this_epoch_attestations + previous_epoch_attestations if a.shard == shard_committee.shard and a.shard_block_hash == shard_block_hash]` .
2018-12-11 13:25:21 +00:00
* Let `winning_hash(shard_committee)` be equal to the value of `shard_block_hash` such that `sum([get_effective_balance(v) for v in attesting_validators(shard_committee, shard_block_hash)])` is maximized (ties broken by favoring lower `shard_block_hash` values).
* Let `attesting_validators(shard_committee)` be equal to `attesting_validators(shard_committee, winning_hash(shard_committee))` for convenience.
2018-12-05 14:34:50 +00:00
* Let `total_attesting_balance(shard_committee)` be the sum of the balances-at-stake of `attesting_validators(shard_committee)` .
* Let `total_balance(shard_committee) = sum([get_effective_balance(v) for v in shard_committee.committee])` .
* Let `inclusion_slot(v) = a.slot_included` for the attestation `a` where `v` is in `get_attestation_participants(state, a.data, a.participation_bitfield)` .
* Let `inclusion_distance(v) = a.slot_included - a.data.slot` where `a` is the above attestation.
2018-12-10 19:55:11 +00:00
* Let `adjust_for_inclusion_distance(magnitude, distance)` be the function below.
2018-11-24 18:30:18 +00:00
```python
2018-11-30 14:28:33 +00:00
def adjust_for_inclusion_distance(magnitude: int, distance: int) -> int:
2018-12-05 11:22:15 +00:00
"""
Adjusts the reward of an attestation based on how long it took to get included (the longer, the lower the reward).
Returns a value between ``0`` and ``magnitude``.
""
2018-11-30 14:28:33 +00:00
return magnitude // 2 + (magnitude // 2) * MIN_ATTESTATION_INCLUSION_DELAY // distance
2018-11-24 18:30:18 +00:00
```
2018-11-20 21:49:43 +00:00
2018-12-05 11:22:15 +00:00
### Receipt roots
2018-11-26 23:39:35 +00:00
2018-12-05 14:34:50 +00:00
If `state.slot % POW_RECEIPT_ROOT_VOTING_PERIOD == 0` :
2018-12-05 11:22:15 +00:00
2018-12-05 14:34:50 +00:00
* Set `state.processed_pow_receipt_root = x.receipt_root` if `x.votes * 2 > POW_RECEIPT_ROOT_VOTING_PERIOD` for some `x` in `state.candidate_pow_receipt_root` .
2018-12-05 11:22:15 +00:00
* Set `state.candidate_pow_receipt_roots = []` .
### Justification
2018-10-02 02:21:15 +00:00
2018-12-05 11:22:15 +00:00
* Set `state.previous_justified_slot = state.justified_slot` .
2018-12-05 14:34:50 +00:00
* Set `state.justification_bitfield = (state.justification_bitfield * 2) % 2**64` .
2018-12-06 22:38:40 +00:00
* Set `state.justification_bitfield |= 2` and `state.justified_slot = state.slot - 2 * EPOCH_LENGTH` if `3 * previous_epoch_boundary_attesting_balance >= 2 * total_balance` .
* Set `state.justification_bitfield |= 1` and `state.justified_slot = state.slot - 1 * EPOCH_LENGTH` if `3 * this_epoch_boundary_attesting_balance >= 2 * total_balance` .
2018-12-05 11:22:15 +00:00
2018-12-05 20:07:41 +00:00
### Finalization
2018-12-05 11:22:15 +00:00
2018-12-06 22:51:29 +00:00
Set `state.finalized_slot = state.previous_justified_slot` if any of the following are true:
2018-12-10 10:11:41 +00:00
2018-12-06 22:51:29 +00:00
* `state.previous_justified_slot == state.slot - 2 * EPOCH_LENGTH and state.justification_bitfield % 4 == 3`
* `state.previous_justified_slot == state.slot - 3 * EPOCH_LENGTH and state.justification_bitfield % 8 == 7`
* `state.previous_justified_slot == state.slot - 4 * EPOCH_LENGTH and state.justification_bitfield % 16 in (15, 14)`
2018-09-20 05:20:49 +00:00
2018-12-05 11:22:15 +00:00
### Crosslinks
2018-10-06 12:32:19 +00:00
2018-12-05 11:22:15 +00:00
For every `shard_committee` in `state.shard_committees_at_slots` :
2018-09-20 05:20:49 +00:00
2018-12-05 19:14:16 +00:00
* Set `state.latest_crosslinks[shard] = CrosslinkRecord(slot=state.slot, shard_block_hash=winning_hash(shard_committee))` if `3 * total_attesting_balance(shard_committee) >= 2 * total_balance(shard_committee)` .
2018-12-05 11:22:15 +00:00
### Justification and finalization rewards and penalties
2018-09-20 05:20:49 +00:00
2018-10-16 11:55:03 +00:00
Note: When applying penalties in the following balance recalculations implementers should make sure the `uint64` does not underflow.
2018-12-05 14:34:50 +00:00
* Let `slots_since_finality = state.slot - state.finalized_slot` .
2018-11-26 23:44:29 +00:00
2018-12-05 14:34:50 +00:00
Case 1: `slots_since_finality <= 4 * EPOCH_LENGTH` :
2018-09-20 05:20:49 +00:00
2018-12-11 19:22:17 +00:00
* Expected FFG source:
* Any [validator ](#dfn-validator ) `v` in `previous_epoch_justified_attesters` gains `adjust_for_inclusion_distance(base_reward(v) * previous_epoch_justified_attesting_balance // total_balance, inclusion_distance(v))` .
* Any [active validator ](#dfn-active-validator ) `v` not in `previous_epoch_justified_attesters` loses `base_reward(v)` .
* Expected FFG target:
* Any [validator ](#dfn-validator ) `v` in `previous_epoch_boundary_attesters` gains `adjust_for_inclusion_distance(base_reward(v) * previous_epoch_boundary_attesting_balance // total_balance, inclusion_distance(v))` .
* Any [active validator ](#dfn-active-validator ) `v` not in `previous_epoch_boundary_attesters` loses `base_reward(v)` .
* Expected beacon chain head:
* Any [validator ](#dfn-validator ) `v` in `previous_epoch_head_attesters` gains `adjust_for_inclusion_distance(base_reward(v) * previous_epoch_head_attesting_balance // total_balance, inclusion_distance(v))` .
* Any [active validator ](#dfn-active-validator ) `v` not in `previous_epoch_head_attesters` loses `base_reward(v)` .
2018-09-20 05:20:49 +00:00
2018-12-05 14:34:50 +00:00
Case 2: `slots_since_finality > 4 * EPOCH_LENGTH` :
2018-09-20 05:20:49 +00:00
2018-12-11 19:22:17 +00:00
* Any [active validator ](#dfn-active-validator ) `v` not in `previous_epoch_justified_attesters` , loses `base_inactivity_penalty(v, slots_since_finality)` .
* Any [active validator ](#dfn-active-validator ) `v` not in `previous_epoch_boundary_attesters` , loses `base_inactivity_penalty(v, slots_since_finality)` .
* Any [active validator ](#dfn-active-validator ) `v` not in `previous_epoch_head_attesters` , loses `base_inactivity_penalty(v, slots_since_finality)` .
* Any [validator ](#dfn-validator ) with `status == EXITED_WITH_PENALTY` , loses `3 * base_inactivity_penalty(v, slots_since_finality)` .
2018-09-20 05:20:49 +00:00
2018-12-11 19:22:17 +00:00
For each `v` in `previous_epoch_attesters` , we determine the proposer `proposer_index = get_beacon_proposer_index(state, inclusion_slot(v))` and set `state.validator_registry[proposer_index].balance += base_reward(v) // INCLUDER_REWARD_QUOTIENT` .
2018-10-01 22:19:16 +00:00
2018-12-05 11:22:15 +00:00
### Crosslink rewards and penalties
2018-09-20 05:20:49 +00:00
2018-12-05 14:34:50 +00:00
For every `shard_committee` in `state.shard_committees_at_slots[:EPOCH_LENGTH]` (i.e. the objects corresponding to the epoch before the current one), for each `v` in `[state.validator_registry[index] for index in shard_committee.committee]` , adjust balances as follows:
2018-09-20 05:20:49 +00:00
2018-12-05 14:34:50 +00:00
* If `v in attesting_validators(shard_committee)` , `v.balance += adjust_for_inclusion_distance(base_reward(v) * total_attesting_balance(shard_committee) // total_balance(shard_committee)), inclusion_distance(v))` .
* If `v not in attesting_validators(shard_committee)` , `v.balance -= base_reward(v)` .
2018-11-23 04:54:11 +00:00
2018-12-05 11:22:15 +00:00
### Validator registry
2018-09-20 05:20:49 +00:00
2018-12-05 11:22:15 +00:00
If the following are satisfied:
2018-09-20 05:20:49 +00:00
2018-11-30 14:28:33 +00:00
* `state.finalized_slot > state.validator_registry_latest_change_slot`
2018-12-05 19:14:16 +00:00
* `state.latest_crosslinks[shard].slot > state.validator_registry_latest_change_slot` for every shard number `shard` in `state.shard_committees_at_slots`
2018-09-20 05:20:49 +00:00
2018-12-05 20:35:58 +00:00
update the validator registry and associated fields by running
2018-12-05 11:22:15 +00:00
```python
2018-12-06 22:12:33 +00:00
def update_validator_registry(state: BeaconState) -> None:
2018-12-05 20:35:58 +00:00
"""
2018-12-06 22:12:33 +00:00
Update validator registry.
2018-12-05 20:35:58 +00:00
Note that this function mutates ``state``.
"""
2018-11-30 14:28:33 +00:00
# The active validators
2018-12-10 21:16:06 +00:00
active_validator_indices = get_active_validator_indices(state.validator_registry)
2018-12-04 19:49:26 +00:00
# The total effective balance of active validators
2018-12-05 11:22:15 +00:00
total_balance = sum([get_effective_balance(v) for i, v in enumerate(validator_registry) if i in active_validator_indices])
2018-12-10 19:55:11 +00:00
2018-12-04 19:49:26 +00:00
# The maximum balance churn in Gwei (for deposits and exits separately)
max_balance_churn = max(
MAX_DEPOSIT * GWEI_PER_ETH,
total_balance // (2 * MAX_BALANCE_CHURN_QUOTIENT)
2018-10-01 22:19:16 +00:00
)
2018-12-04 19:49:26 +00:00
# Activate validators within the allowable balance churn
balance_churn = 0
2018-12-10 22:30:25 +00:00
for index, validator in enumerate(state.validator_registry):
2018-12-05 11:22:15 +00:00
if validator.status == PENDING_ACTIVATION and validator.balance >= MAX_DEPOSIT:
2018-12-04 19:49:26 +00:00
# Check the balance churn would be within the allowance
2018-12-05 11:22:15 +00:00
balance_churn += get_effective_balance(validator)
2018-12-04 19:49:26 +00:00
if balance_churn > max_balance_churn:
break
# Activate validator
2018-12-11 15:49:50 +00:00
update_validator_status(state, index, new_status=ACTIVE)
2018-12-04 19:49:26 +00:00
2018-12-10 19:55:11 +00:00
# Exit validators within the allowable balance churn
2018-12-04 19:49:26 +00:00
balance_churn = 0
2018-12-10 22:30:25 +00:00
for index, validator in enumerate(state.validator_registry):
2018-12-05 11:22:15 +00:00
if validator.status == ACTIVE_PENDING_EXIT:
2018-12-04 19:49:26 +00:00
# Check the balance churn would be within the allowance
2018-12-05 11:22:15 +00:00
balance_churn += get_effective_balance(validator)
2018-12-04 19:49:26 +00:00
if balance_churn > max_balance_churn:
break
# Exit validator
2018-12-11 15:49:50 +00:00
update_validator_status(state, index, new_status=EXITED_WITHOUT_PENALTY)
2018-12-10 21:16:06 +00:00
2018-10-01 22:19:16 +00:00
2018-10-02 15:20:07 +00:00
# Calculate the total ETH that has been penalized in the last ~2-3 withdrawal periods
2018-11-05 12:37:07 +00:00
period_index = current_slot // COLLECTIVE_PENALTY_CALCULATION_PERIOD
2018-10-01 22:19:16 +00:00
total_penalties = (
2018-11-30 14:28:33 +00:00
(latest_penalized_exit_balances[period_index]) +
(latest_penalized_exit_balances[period_index - 1] if period_index >= 1 else 0) +
(latest_penalized_exit_balances[period_index - 2] if period_index >= 2 else 0)
2018-10-01 22:19:16 +00:00
)
2018-11-05 12:37:07 +00:00
2018-11-30 14:28:33 +00:00
# Calculate penalties for slashed validators
def to_penalize(v):
return v.status == EXITED_WITH_PENALTY
2018-12-05 11:22:15 +00:00
validators_to_penalize = filter(to_penalize, validator_registry)
2018-11-30 14:28:33 +00:00
for v in validators_to_penalize:
v.balance -= get_effective_balance(v) * min(total_penalties * 3, total_balance) // total_balance
2018-11-05 12:37:07 +00:00
2018-12-05 20:35:58 +00:00
return validator_registry, latest_penalized_exit_balances, validator_registry_delta_chain_tip
2018-10-01 22:19:16 +00:00
```
2018-11-07 16:47:27 +00:00
2018-12-05 11:22:15 +00:00
Also perform the following updates:
2018-11-05 12:38:25 +00:00
2018-12-04 21:28:31 +00:00
* Set `state.validator_registry_latest_change_slot = state.slot` .
2018-12-04 10:57:09 +00:00
* Set `state.shard_committees_at_slots[:EPOCH_LENGTH] = state.shard_committees_at_slots[EPOCH_LENGTH:]` .
2018-12-06 21:54:39 +00:00
* Set `state.shard_committees_at_slots[EPOCH_LENGTH:] = get_new_shuffling(state.next_seed, state.validator_registry, next_start_shard)` where `next_start_shard = (state.shard_committees_at_slots[-1][-1].shard + 1) % SHARD_COUNT` .
2018-11-30 14:28:33 +00:00
* Set `state.next_seed = state.randao_mix` .
2018-09-20 05:20:49 +00:00
2018-12-05 11:22:15 +00:00
If a validator registry update does _not_ happen do the following:
2018-10-18 17:54:57 +00:00
2018-12-04 10:57:09 +00:00
* Set `state.shard_committees_at_slots[:EPOCH_LENGTH] = state.shard_committees_at_slots[EPOCH_LENGTH:]` .
2018-12-05 14:34:50 +00:00
* Let `slots_since_finality = state.slot - state.validator_registry_latest_change_slot` .
2018-12-04 10:57:09 +00:00
* Let `start_shard = state.shard_committees_at_slots[0][0].shard` .
2018-12-05 14:34:50 +00:00
* If `slots_since_finality * EPOCH_LENGTH <= MIN_VALIDATOR_REGISTRY_CHANGE_INTERVAL` or `slots_since_finality` is an exact power of 2, set `state.shard_committees_at_slots[EPOCH_LENGTH:] = get_new_shuffling(state.next_seed, state.validator_registry, start_shard)` and set `state.next_seed = state.randao_mix` . Note that `start_shard` is not changed from the last epoch.
2018-10-18 17:54:57 +00:00
2018-11-28 07:23:37 +00:00
### Proposer reshuffling
2018-10-18 17:54:57 +00:00
2018-11-27 11:30:19 +00:00
Run the following code to update the shard proposer set:
2018-10-19 20:01:15 +00:00
2018-10-30 08:45:28 +00:00
```python
2018-11-30 14:28:33 +00:00
active_validator_indices = get_active_validator_indices(state.validator_registry)
2018-11-05 12:38:25 +00:00
num_validators_to_reshuffle = len(active_validator_indices) // SHARD_PERSISTENT_COMMITTEE_CHANGE_PERIOD
for i in range(num_validators_to_reshuffle):
2018-11-08 16:28:44 +00:00
# Multiplying i to 2 to ensure we have different input to all the required hashes in the shuffling
# and none of the hashes used for entropy in this loop will be the same
2018-11-30 14:28:33 +00:00
validator_index = active_validator_indices[hash(state.randao_mix + bytes8(i * 2)) % len(active_validator_indices)]
2018-11-15 13:20:25 +00:00
new_shard = hash(state.randao_mix + bytes8(i * 2 + 1)) % SHARD_COUNT
2018-11-05 12:38:25 +00:00
shard_reassignment_record = ShardReassignmentRecord(
2018-11-30 14:28:33 +00:00
validator_index=validator_index,
2018-11-05 12:38:25 +00:00
shard=new_shard,
2018-11-27 11:30:19 +00:00
slot=s + SHARD_PERSISTENT_COMMITTEE_CHANGE_PERIOD
2018-11-05 12:38:25 +00:00
)
2018-11-15 13:20:25 +00:00
state.persistent_committee_reassignments.append(shard_reassignment_record)
2018-11-05 12:38:25 +00:00
2018-11-27 11:30:19 +00:00
while len(state.persistent_committee_reassignments) > 0 and state.persistent_committee_reassignments[0].slot < = s:
2018-11-30 14:28:33 +00:00
reassignment = state.persistent_committee_reassignments.pop(0)
2018-11-15 13:20:25 +00:00
for committee in state.persistent_committees:
2018-11-30 14:28:33 +00:00
if reassignment.validator_index in committee:
committee.pop(committee.index(reassignment.validator_index))
state.persistent_committees[reassignment.shard].append(reassignment.validator_index)
2018-10-19 20:01:15 +00:00
```
2018-09-20 05:20:49 +00:00
2018-12-05 11:22:15 +00:00
### Final updates
2018-09-20 05:20:49 +00:00
2018-12-06 22:38:40 +00:00
* Remove any `attestation` in `state.latest_attestations` such that `attestation.data.slot < state.slot - EPOCH_LENGTH` .
2018-11-30 14:28:33 +00:00
* Set `state.latest_block_hashes = state.latest_block_hashes[EPOCH_LENGTH:]` .
2018-10-18 17:54:57 +00:00
2018-12-05 19:03:24 +00:00
## State root processing
2018-12-10 23:08:04 +00:00
Verify `block.state_root == SSZTreeHash(state)` if there exists a `block` for the slot being processed.
2018-12-05 19:03:24 +00:00
2018-09-26 15:30:24 +00:00
# Appendix
## Appendix A - Hash function
2018-12-04 15:50:44 +00:00
In Phase 0 the beacon chain is deployed with the same hash function as Ethereum 1.0, i.e. Keccak-256 (also incorrectly known as SHA3). We aim to migrate to a S[T/N]ARK-friendly hash function in a future Ethereum 2.0 deployment phase.
2018-09-26 15:30:24 +00:00
2018-11-29 16:12:12 +00:00
# References
This section is divided into Normative and Informative references. Normative references are those that must be read in order to implement this specification, while Informative references are merely that, information. An example of the former might be the details of a required consensus algorithm, and an example of the latter might be a pointer to research that demonstrates why a particular consensus algorithm might be better suited for inclusion in the standard than another.
## Normative
## Informative
2018-12-10 19:55:11 +00:00
< a id = "ref-python-poc" ></ a > _**python-poc**_
2018-11-30 18:56:44 +00:00
_Python proof-of-concept implementation_ . Ethereum Foundation. URL: https://github.com/ethereum/beacon_chain
2018-11-29 16:12:12 +00:00
2018-11-28 07:23:37 +00:00
# Copyright
2018-09-22 07:06:53 +00:00
Copyright and related rights waived via [CC0 ](https://creativecommons.org/publicdomain/zero/1.0/ ).