2021-03-14 21:54:30 +00:00
# Ethereum 2.0 Altair Beacon chain changes
2020-11-12 09:28:05 +00:00
## Table of contents
2020-11-16 09:09:04 +00:00
<!-- TOC -->
<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE - RUN doctoc TO UPDATE -->
2020-11-12 09:28:05 +00:00
- [Introduction ](#introduction )
2021-02-01 20:48:55 +00:00
- [Custom types ](#custom-types )
2020-11-15 10:56:24 +00:00
- [Constants ](#constants )
2021-03-02 01:19:12 +00:00
- [Participation flag indices ](#participation-flag-indices )
2021-03-16 15:30:25 +00:00
- [Incentivization weights ](#incentivization-weights )
2021-01-05 13:56:32 +00:00
- [Misc ](#misc )
2020-11-12 09:28:05 +00:00
- [Configuration ](#configuration )
2021-02-11 21:53:29 +00:00
- [Updated penalty values ](#updated-penalty-values )
2021-01-05 13:56:32 +00:00
- [Misc ](#misc-1 )
2020-11-15 10:56:24 +00:00
- [Time parameters ](#time-parameters )
- [Domain types ](#domain-types )
- [Containers ](#containers )
2021-03-09 22:16:26 +00:00
- [Modified containers ](#modified-containers )
2020-11-15 10:56:24 +00:00
- [`BeaconBlockBody` ](#beaconblockbody )
- [`BeaconState` ](#beaconstate )
- [New containers ](#new-containers )
2021-03-15 20:43:49 +00:00
- [`SyncAggregate` ](#syncaggregate )
2020-11-15 10:56:24 +00:00
- [`SyncCommittee` ](#synccommittee )
2020-11-12 09:28:05 +00:00
- [Helper functions ](#helper-functions )
2020-12-15 05:18:20 +00:00
- [`Predicates` ](#predicates )
- [`eth2_fast_aggregate_verify` ](#eth2_fast_aggregate_verify )
2021-01-05 21:17:34 +00:00
- [Misc ](#misc-2 )
2021-03-16 15:30:25 +00:00
- [`get_flag_indices_and_weights` ](#get_flag_indices_and_weights )
2021-03-02 01:19:12 +00:00
- [`add_flag` ](#add_flag )
- [`has_flag` ](#has_flag )
2020-11-12 09:28:05 +00:00
- [Beacon state accessors ](#beacon-state-accessors )
2020-11-15 10:56:24 +00:00
- [`get_sync_committee_indices` ](#get_sync_committee_indices )
- [`get_sync_committee` ](#get_sync_committee )
2021-03-16 15:30:25 +00:00
- [`get_base_reward_per_increment` ](#get_base_reward_per_increment )
2021-01-05 21:17:34 +00:00
- [`get_base_reward` ](#get_base_reward )
2021-01-05 13:56:32 +00:00
- [`get_unslashed_participating_indices` ](#get_unslashed_participating_indices )
2021-03-15 11:08:41 +00:00
- [`get_flag_index_deltas` ](#get_flag_index_deltas )
- [Modified `get_inactivity_penalty_deltas` ](#modified-get_inactivity_penalty_deltas )
2021-02-11 21:53:29 +00:00
- [Beacon state mutators ](#beacon-state-mutators )
2021-03-15 11:08:41 +00:00
- [Modified `slash_validator` ](#modified-slash_validator )
2020-11-12 09:28:05 +00:00
- [Block processing ](#block-processing )
2021-03-02 01:19:12 +00:00
- [Modified `process_attestation` ](#modified-process_attestation )
2021-03-09 20:21:16 +00:00
- [Modified `process_deposit` ](#modified-process_deposit )
2020-11-15 10:56:24 +00:00
- [Sync committee processing ](#sync-committee-processing )
2020-11-16 09:09:04 +00:00
- [Epoch processing ](#epoch-processing )
2021-03-02 01:19:12 +00:00
- [Justification and finalization ](#justification-and-finalization )
2021-03-15 11:08:41 +00:00
- [Inactivity scores ](#inactivity-scores )
2021-03-02 01:19:12 +00:00
- [Rewards and penalties ](#rewards-and-penalties )
- [Slashings ](#slashings )
2021-01-29 15:49:51 +00:00
- [Participation flags updates ](#participation-flags-updates )
2021-03-02 01:19:12 +00:00
- [Sync committee updates ](#sync-committee-updates )
2021-04-20 15:38:48 +00:00
- [Initialize state for pure Altair testnets and test vectors ](#initialize-state-for-pure-altair-testnets-and-test-vectors )
2020-11-16 09:09:04 +00:00
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
<!-- /TOC -->
2020-11-15 10:56:24 +00:00
2020-11-12 09:28:05 +00:00
## Introduction
2021-03-15 11:08:41 +00:00
Altair is the first beacon chain hard fork. Its main features are:
2020-12-18 23:22:11 +00:00
2021-03-15 11:08:41 +00:00
* sync committees to support light clients
* incentive accounting reforms to reduce spec complexity
2021-03-16 15:30:25 +00:00
* penalty parameter updates towards their planned maximally punitive values
2020-11-15 10:56:24 +00:00
2021-02-01 20:46:27 +00:00
## Custom types
| Name | SSZ equivalent | Description |
| - | - | - |
2021-03-15 11:08:41 +00:00
| `ParticipationFlags` | `uint8` | a succinct representation of 8 boolean participation flags |
2021-02-01 20:46:27 +00:00
2020-11-15 10:56:24 +00:00
## Constants
2021-03-02 01:19:12 +00:00
### Participation flag indices
2020-12-18 23:22:11 +00:00
2020-11-15 10:56:24 +00:00
| Name | Value |
2020-12-18 23:22:11 +00:00
| - | - |
2021-03-02 01:19:12 +00:00
| `TIMELY_HEAD_FLAG_INDEX` | `0` |
| `TIMELY_SOURCE_FLAG_INDEX` | `1` |
| `TIMELY_TARGET_FLAG_INDEX` | `2` |
2020-12-18 23:22:11 +00:00
2021-03-16 15:30:25 +00:00
### Incentivization weights
2020-12-18 23:22:11 +00:00
| Name | Value |
| - | - |
Typing problems fixes (#2271)
* Typing problem fixed: `process_block_header` passes `Bytes32()` to `state_root` of `BeaconBlockHeader`, which type is `Root`
* Typing problem fixed in `initialize_beacon_state_from_eth1`: `len` returns an `int` value, while `deposit_count=uint64` of `Eth1Data` has type `uint64`
* Typing problem fixed in `process_rewards_and_penalties`: `numerator` of type `int` passed to `weight` parameter of `get_flag_index_deltas`, which has type `uint64`
* Typing problem fixed in `process_attestation`; `False` passes as `crosslink_success` parameter of `PendingAttestation`, which has type `boolean`. `False` is an instance of `(python.)bool` and is not an instance of `(ssz.)boolean`
* Typing problem fixed: `shard_data_roots` of `ShardTransition` has type `List[Bytes32]`, but its elements are used as if they were `Root` values, e.g. in `process_chunk_challenge` method: passed to `data_root` of `CustodyChunkChallengeRecord` which has type `Root`
* Typing problem fixed in `process_custody_final_updates`: `index` has type `int`, while `validator_indices_in_records` has type `Set[ValidatorIndex]`, so tesing whether `index in validator_indices_in_records` can be risky, depending on implementation details. `ValidatorIndex(index) in validator_indices_in_records` is a safer variant.
* Typing problem fixed: `slashed` parameter of `pack_compact_validator` has type `(python.)bool`, however in `committee_to_compact_committee` a value of `(ssz.)boolean` is passed as a value of the parameter
* Typing problem fixed: `inactivity_scores` is a `List[uint64,...]`, while it is intialized/appended with values of `(python.)int` type
* fixed according to @protolambda suggestions
* changed types of _WEIGHT constants and appropriate variables/parameters, according to @protolambda suggestions
* revert code formatting back
* Introduced ZERO_ROOT according to @protolambda 's suggestion
* Reverted back to , according to @protolambda comments
2021-03-25 21:03:21 +00:00
| `TIMELY_HEAD_WEIGHT` | `uint64(12)` |
| `TIMELY_SOURCE_WEIGHT` | `uint64(12)` |
| `TIMELY_TARGET_WEIGHT` | `uint64(24)` |
| `SYNC_REWARD_WEIGHT` | `uint64(8)` |
2021-03-30 16:53:58 +00:00
| `PROPOSER_WEIGHT` | `uint64(8)` |
Typing problems fixes (#2271)
* Typing problem fixed: `process_block_header` passes `Bytes32()` to `state_root` of `BeaconBlockHeader`, which type is `Root`
* Typing problem fixed in `initialize_beacon_state_from_eth1`: `len` returns an `int` value, while `deposit_count=uint64` of `Eth1Data` has type `uint64`
* Typing problem fixed in `process_rewards_and_penalties`: `numerator` of type `int` passed to `weight` parameter of `get_flag_index_deltas`, which has type `uint64`
* Typing problem fixed in `process_attestation`; `False` passes as `crosslink_success` parameter of `PendingAttestation`, which has type `boolean`. `False` is an instance of `(python.)bool` and is not an instance of `(ssz.)boolean`
* Typing problem fixed: `shard_data_roots` of `ShardTransition` has type `List[Bytes32]`, but its elements are used as if they were `Root` values, e.g. in `process_chunk_challenge` method: passed to `data_root` of `CustodyChunkChallengeRecord` which has type `Root`
* Typing problem fixed in `process_custody_final_updates`: `index` has type `int`, while `validator_indices_in_records` has type `Set[ValidatorIndex]`, so tesing whether `index in validator_indices_in_records` can be risky, depending on implementation details. `ValidatorIndex(index) in validator_indices_in_records` is a safer variant.
* Typing problem fixed: `slashed` parameter of `pack_compact_validator` has type `(python.)bool`, however in `committee_to_compact_committee` a value of `(ssz.)boolean` is passed as a value of the parameter
* Typing problem fixed: `inactivity_scores` is a `List[uint64,...]`, while it is intialized/appended with values of `(python.)int` type
* fixed according to @protolambda suggestions
* changed types of _WEIGHT constants and appropriate variables/parameters, according to @protolambda suggestions
* revert code formatting back
* Introduced ZERO_ROOT according to @protolambda 's suggestion
* Reverted back to , according to @protolambda comments
2021-03-25 21:03:21 +00:00
| `WEIGHT_DENOMINATOR` | `uint64(64)` |
2020-12-18 23:22:11 +00:00
2021-04-02 13:52:32 +00:00
*Note*: The sum of the weights equal `WEIGHT_DENOMINATOR` .
2020-12-18 23:22:11 +00:00
### Misc
| Name | Value |
| - | - |
2020-12-15 05:18:20 +00:00
| `G2_POINT_AT_INFINITY` | `BLSSignature(b'\xc0' + b'\x00' * 95)` |
2021-01-05 17:11:46 +00:00
## Configuration
2021-02-11 21:53:29 +00:00
### Updated penalty values
2021-03-22 23:28:45 +00:00
This patch updates a few configuration values to move penalty parameters toward their final, maximum security values.
2021-02-11 21:53:29 +00:00
*Note*: The spec does *not* override previous configuration values but instead creates new values and replaces usage throughout.
| Name | Value |
| - | - |
2021-03-15 17:46:53 +00:00
| `INACTIVITY_PENALTY_QUOTIENT_ALTAIR` | `uint64(3 * 2**24)` (= 50,331,648) |
| `MIN_SLASHING_PENALTY_QUOTIENT_ALTAIR` | `uint64(2**6)` (= 64) |
| `PROPORTIONAL_SLASHING_MULTIPLIER_ALTAIR` | `uint64(2)` |
2021-02-11 21:53:29 +00:00
2020-11-12 09:28:05 +00:00
### Misc
| Name | Value |
2021-03-15 11:08:41 +00:00
| - | - |
2021-03-02 01:19:12 +00:00
| `SYNC_COMMITTEE_SIZE` | `uint64(2**10)` (= 1,024) |
2021-03-19 13:59:49 +00:00
| `SYNC_PUBKEYS_PER_AGGREGATE` | `uint64(2**6)` (= 64) |
2021-03-15 11:08:41 +00:00
| `INACTIVITY_SCORE_BIAS` | `uint64(4)` |
2020-11-15 10:56:24 +00:00
### Time parameters
| Name | Value | Unit | Duration |
| - | - | :-: | :-: |
| `EPOCHS_PER_SYNC_COMMITTEE_PERIOD` | `Epoch(2**8)` (= 256) | epochs | ~27 hours |
2020-11-12 09:28:05 +00:00
### Domain types
| Name | Value |
| - | - |
2020-11-15 10:56:24 +00:00
| `DOMAIN_SYNC_COMMITTEE` | `DomainType('0x07000000')` |
2021-02-18 04:47:52 +00:00
| `DOMAIN_SYNC_COMMITTEE_SELECTION_PROOF` | `DomainType('0x08000000')` |
| `DOMAIN_CONTRIBUTION_AND_PROOF` | `DomainType('0x09000000')` |
2020-11-15 10:56:24 +00:00
## Containers
2020-11-12 09:28:05 +00:00
2021-03-09 22:16:26 +00:00
### Modified containers
2020-12-07 15:10:39 +00:00
2020-12-15 05:18:20 +00:00
#### `BeaconBlockBody`
2020-11-12 09:28:05 +00:00
```python
2021-03-02 01:19:12 +00:00
class BeaconBlockBody(Container):
randao_reveal: BLSSignature
eth1_data: Eth1Data # Eth1 data vote
graffiti: Bytes32 # Arbitrary data
# Operations
proposer_slashings: List[ProposerSlashing, MAX_PROPOSER_SLASHINGS]
attester_slashings: List[AttesterSlashing, MAX_ATTESTER_SLASHINGS]
attestations: List[Attestation, MAX_ATTESTATIONS]
deposits: List[Deposit, MAX_DEPOSITS]
voluntary_exits: List[SignedVoluntaryExit, MAX_VOLUNTARY_EXITS]
2021-03-15 20:43:49 +00:00
# [New in Altair]
sync_aggregate: SyncAggregate
2020-11-12 09:28:05 +00:00
```
2020-11-15 10:56:24 +00:00
#### `BeaconState`
2020-11-12 09:28:05 +00:00
```python
2020-12-18 23:22:11 +00:00
class BeaconState(Container):
# Versioning
genesis_time: uint64
genesis_validators_root: Root
slot: Slot
fork: Fork
# History
latest_block_header: BeaconBlockHeader
block_roots: Vector[Root, SLOTS_PER_HISTORICAL_ROOT]
state_roots: Vector[Root, SLOTS_PER_HISTORICAL_ROOT]
historical_roots: List[Root, HISTORICAL_ROOTS_LIMIT]
# Eth1
eth1_data: Eth1Data
eth1_data_votes: List[Eth1Data, EPOCHS_PER_ETH1_VOTING_PERIOD * SLOTS_PER_EPOCH]
eth1_deposit_index: uint64
# Registry
validators: List[Validator, VALIDATOR_REGISTRY_LIMIT]
balances: List[Gwei, VALIDATOR_REGISTRY_LIMIT]
# Randomness
randao_mixes: Vector[Bytes32, EPOCHS_PER_HISTORICAL_VECTOR]
# Slashings
slashings: Vector[Gwei, EPOCHS_PER_SLASHINGS_VECTOR] # Per-epoch sums of slashed effective balances
# Participation
2021-03-15 11:08:41 +00:00
previous_epoch_participation: List[ParticipationFlags, VALIDATOR_REGISTRY_LIMIT] # [Modified in Altair]
2021-03-15 14:42:50 +00:00
current_epoch_participation: List[ParticipationFlags, VALIDATOR_REGISTRY_LIMIT] # [Modified in Altair]
2020-12-18 23:22:11 +00:00
# Finality
justification_bits: Bitvector[JUSTIFICATION_BITS_LENGTH] # Bit set for every recent justified epoch
previous_justified_checkpoint: Checkpoint
current_justified_checkpoint: Checkpoint
finalized_checkpoint: Checkpoint
2021-03-15 11:08:41 +00:00
# Inactivity
inactivity_scores: List[uint64, VALIDATOR_REGISTRY_LIMIT] # [New in Altair]
# Sync
2021-03-11 16:28:58 +00:00
current_sync_committee: SyncCommittee # [New in Altair]
next_sync_committee: SyncCommittee # [New in Altair]
2020-11-12 09:28:05 +00:00
```
2020-11-15 10:56:24 +00:00
### New containers
2020-11-12 09:28:05 +00:00
2021-03-15 20:43:49 +00:00
#### `SyncAggregate`
```python
class SyncAggregate(Container):
sync_committee_bits: Bitvector[SYNC_COMMITTEE_SIZE]
sync_committee_signature: BLSSignature
```
2020-11-15 10:56:24 +00:00
#### `SyncCommittee`
2020-11-12 09:28:05 +00:00
```python
2020-11-15 10:56:24 +00:00
class SyncCommittee(Container):
2020-11-18 09:19:32 +00:00
pubkeys: Vector[BLSPubkey, SYNC_COMMITTEE_SIZE]
2021-03-19 13:59:49 +00:00
pubkey_aggregates: Vector[BLSPubkey, SYNC_COMMITTEE_SIZE // SYNC_PUBKEYS_PER_AGGREGATE]
2020-11-12 09:28:05 +00:00
```
## Helper functions
2020-12-15 05:18:20 +00:00
### `Predicates`
#### `eth2_fast_aggregate_verify`
```python
def eth2_fast_aggregate_verify(pubkeys: Sequence[BLSPubkey], message: Bytes32, signature: BLSSignature) -> bool:
"""
Wrapper to ``bls.FastAggregateVerify`` accepting the ``G2_POINT_AT_INFINITY`` signature when ``pubkeys`` is empty.
"""
if len(pubkeys) == 0 and signature == G2_POINT_AT_INFINITY:
return True
return bls.FastAggregateVerify(pubkeys, message, signature)
```
2021-01-05 20:48:26 +00:00
### Misc
2021-03-16 15:30:25 +00:00
#### `get_flag_indices_and_weights`
2021-01-05 20:48:26 +00:00
```python
Typing problems fixes (#2271)
* Typing problem fixed: `process_block_header` passes `Bytes32()` to `state_root` of `BeaconBlockHeader`, which type is `Root`
* Typing problem fixed in `initialize_beacon_state_from_eth1`: `len` returns an `int` value, while `deposit_count=uint64` of `Eth1Data` has type `uint64`
* Typing problem fixed in `process_rewards_and_penalties`: `numerator` of type `int` passed to `weight` parameter of `get_flag_index_deltas`, which has type `uint64`
* Typing problem fixed in `process_attestation`; `False` passes as `crosslink_success` parameter of `PendingAttestation`, which has type `boolean`. `False` is an instance of `(python.)bool` and is not an instance of `(ssz.)boolean`
* Typing problem fixed: `shard_data_roots` of `ShardTransition` has type `List[Bytes32]`, but its elements are used as if they were `Root` values, e.g. in `process_chunk_challenge` method: passed to `data_root` of `CustodyChunkChallengeRecord` which has type `Root`
* Typing problem fixed in `process_custody_final_updates`: `index` has type `int`, while `validator_indices_in_records` has type `Set[ValidatorIndex]`, so tesing whether `index in validator_indices_in_records` can be risky, depending on implementation details. `ValidatorIndex(index) in validator_indices_in_records` is a safer variant.
* Typing problem fixed: `slashed` parameter of `pack_compact_validator` has type `(python.)bool`, however in `committee_to_compact_committee` a value of `(ssz.)boolean` is passed as a value of the parameter
* Typing problem fixed: `inactivity_scores` is a `List[uint64,...]`, while it is intialized/appended with values of `(python.)int` type
* fixed according to @protolambda suggestions
* changed types of _WEIGHT constants and appropriate variables/parameters, according to @protolambda suggestions
* revert code formatting back
* Introduced ZERO_ROOT according to @protolambda 's suggestion
* Reverted back to , according to @protolambda comments
2021-03-25 21:03:21 +00:00
def get_flag_indices_and_weights() -> Sequence[Tuple[int, uint64]]:
2021-01-05 20:48:26 +00:00
return (
2021-03-16 15:30:25 +00:00
(TIMELY_HEAD_FLAG_INDEX, TIMELY_HEAD_WEIGHT),
(TIMELY_SOURCE_FLAG_INDEX, TIMELY_SOURCE_WEIGHT),
(TIMELY_TARGET_FLAG_INDEX, TIMELY_TARGET_WEIGHT),
2021-01-05 20:48:26 +00:00
)
```
2021-03-02 01:19:12 +00:00
#### `add_flag`
2021-02-01 20:46:27 +00:00
```python
2021-03-02 01:19:12 +00:00
def add_flag(flags: ParticipationFlags, flag_index: int) -> ParticipationFlags:
flag = ParticipationFlags(2**flag_index)
return flags | flag
2021-02-01 20:46:27 +00:00
```
2021-01-05 20:48:26 +00:00
2021-03-02 01:19:12 +00:00
#### `has_flag`
2021-02-01 20:46:27 +00:00
```python
2021-03-02 01:19:12 +00:00
def has_flag(flags: ParticipationFlags, flag_index: int) -> bool:
flag = ParticipationFlags(2**flag_index)
return flags & flag == flag
2021-02-01 20:46:27 +00:00
```
2021-01-05 20:48:26 +00:00
2020-11-15 10:56:24 +00:00
### Beacon state accessors
#### `get_sync_committee_indices`
2020-11-12 09:28:05 +00:00
```python
2020-11-15 10:56:24 +00:00
def get_sync_committee_indices(state: BeaconState, epoch: Epoch) -> Sequence[ValidatorIndex]:
2020-11-12 09:28:05 +00:00
"""
2021-01-19 12:52:40 +00:00
Return the sequence of sync committee indices (which may include duplicate indices) for a given state and epoch.
2021-01-19 12:24:25 +00:00
"""
2020-12-07 15:10:39 +00:00
MAX_RANDOM_BYTE = 2**8 - 1
2020-11-15 17:23:44 +00:00
base_epoch = Epoch((max(epoch // EPOCHS_PER_SYNC_COMMITTEE_PERIOD, 1) - 1) * EPOCHS_PER_SYNC_COMMITTEE_PERIOD)
2020-11-18 09:19:32 +00:00
active_validator_indices = get_active_validator_indices(state, base_epoch)
active_validator_count = uint64(len(active_validator_indices))
2020-11-15 10:56:24 +00:00
seed = get_seed(state, base_epoch, DOMAIN_SYNC_COMMITTEE)
2020-12-15 05:18:20 +00:00
i = 0
sync_committee_indices: List[ValidatorIndex] = []
2020-11-18 09:19:32 +00:00
while len(sync_committee_indices) < SYNC_COMMITTEE_SIZE:
shuffled_index = compute_shuffled_index(uint64(i % active_validator_count), active_validator_count, seed)
candidate_index = active_validator_indices[shuffled_index]
2020-11-18 08:15:30 +00:00
random_byte = hash(seed + uint_to_bytes(uint64(i // 32)))[i % 32]
effective_balance = state.validators[candidate_index].effective_balance
2021-01-19 12:52:40 +00:00
if effective_balance * MAX_RANDOM_BYTE >= MAX_EFFECTIVE_BALANCE * random_byte: # Sample with replacement
2020-11-18 09:19:32 +00:00
sync_committee_indices.append(candidate_index)
2020-11-18 08:15:30 +00:00
i += 1
2020-11-18 09:19:32 +00:00
return sync_committee_indices
2020-11-12 09:28:05 +00:00
```
2020-11-15 17:23:44 +00:00
#### `get_sync_committee`
2020-11-12 09:28:05 +00:00
```python
2020-11-15 10:56:24 +00:00
def get_sync_committee(state: BeaconState, epoch: Epoch) -> SyncCommittee:
2020-11-12 09:28:05 +00:00
"""
2020-11-15 10:56:24 +00:00
Return the sync committee for a given state and epoch.
2020-11-12 09:28:05 +00:00
"""
2020-11-15 10:56:24 +00:00
indices = get_sync_committee_indices(state, epoch)
2021-03-09 20:21:16 +00:00
pubkeys = [state.validators[index].pubkey for index in indices]
2021-03-19 13:59:49 +00:00
partition = [pubkeys[i:i + SYNC_PUBKEYS_PER_AGGREGATE] for i in range(0, len(pubkeys), SYNC_PUBKEYS_PER_AGGREGATE)]
2021-03-19 10:04:46 +00:00
pubkey_aggregates = [bls.AggregatePKs(preaggregate) for preaggregate in partition]
2021-03-09 20:21:16 +00:00
return SyncCommittee(pubkeys=pubkeys, pubkey_aggregates=pubkey_aggregates)
2020-11-12 09:28:05 +00:00
```
2021-03-16 15:30:25 +00:00
#### `get_base_reward_per_increment`
```python
def get_base_reward_per_increment(state: BeaconState) -> Gwei:
return Gwei(EFFECTIVE_BALANCE_INCREMENT * BASE_REWARD_FACTOR // integer_squareroot(get_total_active_balance(state)))
```
2021-01-05 20:48:26 +00:00
#### `get_base_reward`
*Note*: The function `get_base_reward` is modified with the removal of `BASE_REWARDS_PER_EPOCH` .
```python
def get_base_reward(state: BeaconState, index: ValidatorIndex) -> Gwei:
2021-03-16 15:30:25 +00:00
increments = state.validators[index].effective_balance // EFFECTIVE_BALANCE_INCREMENT
return Gwei(increments * get_base_reward_per_increment(state))
2021-01-05 20:48:26 +00:00
```
2020-12-18 23:22:11 +00:00
#### `get_unslashed_participating_indices`
```python
2021-03-02 01:19:12 +00:00
def get_unslashed_participating_indices(state: BeaconState, flag_index: int, epoch: Epoch) -> Set[ValidatorIndex]:
2021-02-01 20:46:27 +00:00
"""
2021-03-15 11:08:41 +00:00
Return the active and unslashed validator indices for the given epoch and flag index.
2021-02-01 20:46:27 +00:00
"""
2020-12-18 23:22:11 +00:00
assert epoch in (get_previous_epoch(state), get_current_epoch(state))
if epoch == get_current_epoch(state):
epoch_participation = state.current_epoch_participation
else:
epoch_participation = state.previous_epoch_participation
2021-03-02 01:19:12 +00:00
active_validator_indices = get_active_validator_indices(state, epoch)
participating_indices = [i for i in active_validator_indices if has_flag(epoch_participation[i], flag_index)]
2020-12-18 23:22:11 +00:00
return set(filter(lambda index: not state.validators[index].slashed, participating_indices))
```
2021-03-15 11:08:41 +00:00
#### `get_flag_index_deltas`
2020-12-18 23:22:11 +00:00
```python
2021-03-16 15:30:25 +00:00
def get_flag_index_deltas(state: BeaconState, flag_index: int, weight: uint64) -> Tuple[Sequence[Gwei], Sequence[Gwei]]:
2020-12-18 23:22:11 +00:00
"""
2021-03-15 11:08:41 +00:00
Return the deltas for a given flag index by scanning through the participation flags.
2020-12-18 23:22:11 +00:00
"""
rewards = [Gwei(0)] * len(state.validators)
2021-01-05 20:48:26 +00:00
penalties = [Gwei(0)] * len(state.validators)
2021-03-02 01:19:12 +00:00
unslashed_participating_indices = get_unslashed_participating_indices(state, flag_index, get_previous_epoch(state))
2020-12-18 23:22:11 +00:00
increment = EFFECTIVE_BALANCE_INCREMENT # Factored out from balances to avoid uint64 overflow
unslashed_participating_increments = get_total_balance(state, unslashed_participating_indices) // increment
active_increments = get_total_active_balance(state) // increment
for index in get_eligible_validator_indices(state):
base_reward = get_base_reward(state, index)
if index in unslashed_participating_indices:
if is_in_inactivity_leak(state):
2021-03-15 11:08:41 +00:00
# This flag reward cancels the inactivity penalty corresponding to the flag index
2021-03-16 15:30:25 +00:00
rewards[index] += Gwei(base_reward * weight // WEIGHT_DENOMINATOR)
2020-12-18 23:22:11 +00:00
else:
2021-03-16 15:30:25 +00:00
reward_numerator = base_reward * weight * unslashed_participating_increments
rewards[index] += Gwei(reward_numerator // (active_increments * WEIGHT_DENOMINATOR))
2021-01-05 20:48:26 +00:00
else:
2021-03-16 15:30:25 +00:00
penalties[index] += Gwei(base_reward * weight // WEIGHT_DENOMINATOR)
2021-01-05 20:48:26 +00:00
return rewards, penalties
2020-12-18 23:22:11 +00:00
```
2021-03-15 11:08:41 +00:00
#### Modified `get_inactivity_penalty_deltas`
2020-12-18 23:22:11 +00:00
2021-02-11 21:53:29 +00:00
*Note*: The function `get_inactivity_penalty_deltas` is modified in the selection of matching target indices
and the removal of `BASE_REWARDS_PER_EPOCH` .
2020-12-18 23:22:11 +00:00
```python
def get_inactivity_penalty_deltas(state: BeaconState) -> Tuple[Sequence[Gwei], Sequence[Gwei]]:
"""
2021-03-15 11:08:41 +00:00
Return the inactivity penalty deltas by considering timely target participation flags and inactivity scores.
2020-12-18 23:22:11 +00:00
"""
2021-03-09 19:52:04 +00:00
rewards = [Gwei(0) for _ in range(len(state.validators))]
2021-01-05 20:48:26 +00:00
penalties = [Gwei(0) for _ in range(len(state.validators))]
2021-03-15 11:08:41 +00:00
if is_in_inactivity_leak(state):
previous_epoch = get_previous_epoch(state)
matching_target_indices = get_unslashed_participating_indices(state, TIMELY_TARGET_FLAG_INDEX, previous_epoch)
for index in get_eligible_validator_indices(state):
2021-03-16 15:30:25 +00:00
for (_, weight) in get_flag_indices_and_weights():
2021-03-15 11:08:41 +00:00
# This inactivity penalty cancels the flag reward corresponding to the flag index
2021-03-16 15:30:25 +00:00
penalties[index] += Gwei(get_base_reward(state, index) * weight // WEIGHT_DENOMINATOR)
2021-03-15 11:08:41 +00:00
if index not in matching_target_indices:
penalty_numerator = state.validators[index].effective_balance * state.inactivity_scores[index]
2021-03-15 17:46:53 +00:00
penalty_denominator = INACTIVITY_SCORE_BIAS * INACTIVITY_PENALTY_QUOTIENT_ALTAIR
2021-03-15 11:08:41 +00:00
penalties[index] += Gwei(penalty_numerator // penalty_denominator)
2021-01-05 20:48:26 +00:00
return rewards, penalties
2020-12-18 23:22:11 +00:00
```
2021-02-11 21:53:29 +00:00
### Beacon state mutators
2021-03-15 11:08:41 +00:00
#### Modified `slash_validator`
2021-02-11 21:53:29 +00:00
2021-04-07 01:44:24 +00:00
*Note*: The function `slash_validator` is modified to use `MIN_SLASHING_PENALTY_QUOTIENT_ALTAIR`
and use `PROPOSER_WEIGHT` when calculating the proposer reward.
2021-02-11 21:53:29 +00:00
```python
def slash_validator(state: BeaconState,
slashed_index: ValidatorIndex,
whistleblower_index: ValidatorIndex=None) -> None:
"""
Slash the validator with index ``slashed_index``.
"""
epoch = get_current_epoch(state)
initiate_validator_exit(state, slashed_index)
validator = state.validators[slashed_index]
validator.slashed = True
validator.withdrawable_epoch = max(validator.withdrawable_epoch, Epoch(epoch + EPOCHS_PER_SLASHINGS_VECTOR))
state.slashings[epoch % EPOCHS_PER_SLASHINGS_VECTOR] += validator.effective_balance
2021-03-15 17:46:53 +00:00
decrease_balance(state, slashed_index, validator.effective_balance // MIN_SLASHING_PENALTY_QUOTIENT_ALTAIR)
2021-02-11 21:53:29 +00:00
# Apply proposer and whistleblower rewards
proposer_index = get_beacon_proposer_index(state)
if whistleblower_index is None:
whistleblower_index = proposer_index
whistleblower_reward = Gwei(validator.effective_balance // WHISTLEBLOWER_REWARD_QUOTIENT)
2021-03-26 10:51:29 +00:00
proposer_reward = Gwei(whistleblower_reward * PROPOSER_WEIGHT // WEIGHT_DENOMINATOR)
2021-02-11 21:53:29 +00:00
increase_balance(state, proposer_index, proposer_reward)
increase_balance(state, whistleblower_index, Gwei(whistleblower_reward - proposer_reward))
```
2020-11-12 09:28:05 +00:00
### Block processing
```python
def process_block(state: BeaconState, block: BeaconBlock) -> None:
2020-12-15 05:18:20 +00:00
process_block_header(state, block)
process_randao(state, block.body)
process_eth1_data(state, block.body)
2021-03-11 13:22:38 +00:00
process_operations(state, block.body) # [Modified in Altair]
2021-03-15 20:43:49 +00:00
process_sync_committee(state, block.body.sync_aggregate) # [New in Altair]
2020-11-12 09:28:05 +00:00
```
2021-03-02 01:19:12 +00:00
#### Modified `process_attestation`
2020-12-18 23:22:11 +00:00
*Note*: The function `process_attestation` is modified to do incentive accounting with epoch participation flags.
```python
def process_attestation(state: BeaconState, attestation: Attestation) -> None:
data = attestation.data
assert data.target.epoch in (get_previous_epoch(state), get_current_epoch(state))
assert data.target.epoch == compute_epoch_at_slot(data.slot)
assert data.slot + MIN_ATTESTATION_INCLUSION_DELAY < = state.slot < = data.slot + SLOTS_PER_EPOCH
assert data.index < get_committee_count_per_slot ( state , data . target . epoch )
2021-01-05 20:48:26 +00:00
2020-12-18 23:22:11 +00:00
committee = get_beacon_committee(state, data.slot, data.index)
assert len(attestation.aggregation_bits) == len(committee)
2021-01-05 20:48:26 +00:00
2020-12-18 23:22:11 +00:00
if data.target.epoch == get_current_epoch(state):
epoch_participation = state.current_epoch_participation
justified_checkpoint = state.current_justified_checkpoint
else:
epoch_participation = state.previous_epoch_participation
justified_checkpoint = state.previous_justified_checkpoint
2021-01-05 20:48:26 +00:00
2020-12-18 23:22:11 +00:00
# Matching roots
is_matching_head = data.beacon_block_root == get_block_root_at_slot(state, data.slot)
is_matching_source = data.source == justified_checkpoint
is_matching_target = data.target.root == get_block_root(state, data.target.epoch)
assert is_matching_source
2021-01-05 20:48:26 +00:00
# Verify signature
assert is_valid_indexed_attestation(state, get_indexed_attestation(state, attestation))
2021-03-02 01:19:12 +00:00
# Participation flag indices
participation_flag_indices = []
2021-03-27 16:13:46 +00:00
if is_matching_head and is_matching_target and state.slot == data.slot + MIN_ATTESTATION_INCLUSION_DELAY:
2021-03-02 01:19:12 +00:00
participation_flag_indices.append(TIMELY_HEAD_FLAG_INDEX)
2020-12-18 23:22:11 +00:00
if is_matching_source and state.slot < = data.slot + integer_squareroot(SLOTS_PER_EPOCH):
2021-03-02 01:19:12 +00:00
participation_flag_indices.append(TIMELY_SOURCE_FLAG_INDEX)
2020-12-18 23:22:11 +00:00
if is_matching_target and state.slot < = data.slot + SLOTS_PER_EPOCH:
2021-03-02 01:19:12 +00:00
participation_flag_indices.append(TIMELY_TARGET_FLAG_INDEX)
2021-01-05 20:48:26 +00:00
2020-12-18 23:22:11 +00:00
# Update epoch participation flags
proposer_reward_numerator = 0
for index in get_attesting_indices(state, data, attestation.aggregation_bits):
2021-03-16 15:30:25 +00:00
for flag_index, weight in get_flag_indices_and_weights():
2021-03-02 01:19:12 +00:00
if flag_index in participation_flag_indices and not has_flag(epoch_participation[index], flag_index):
epoch_participation[index] = add_flag(epoch_participation[index], flag_index)
2021-03-16 15:30:25 +00:00
proposer_reward_numerator += get_base_reward(state, index) * weight
2021-01-05 20:48:26 +00:00
2020-12-18 23:22:11 +00:00
# Reward proposer
2021-03-26 10:51:29 +00:00
proposer_reward_denominator = (WEIGHT_DENOMINATOR - PROPOSER_WEIGHT) * WEIGHT_DENOMINATOR // PROPOSER_WEIGHT
proposer_reward = Gwei(proposer_reward_numerator // proposer_reward_denominator)
2020-12-18 23:22:11 +00:00
increase_balance(state, get_beacon_proposer_index(state), proposer_reward)
```
2021-03-09 20:21:16 +00:00
#### Modified `process_deposit`
2021-01-05 18:09:39 +00:00
2021-03-15 11:08:41 +00:00
*Note*: The function `process_deposit` is modified to initialize `inactivity_scores` , `previous_epoch_participation` , `current_epoch_participation` .
2021-01-05 18:09:39 +00:00
```python
def process_deposit(state: BeaconState, deposit: Deposit) -> None:
# Verify the Merkle branch
assert is_valid_merkle_branch(
leaf=hash_tree_root(deposit.data),
branch=deposit.proof,
depth=DEPOSIT_CONTRACT_TREE_DEPTH + 1, # Add 1 for the List length mix-in
index=state.eth1_deposit_index,
root=state.eth1_data.deposit_root,
)
# Deposits must be processed in order
state.eth1_deposit_index += 1
pubkey = deposit.data.pubkey
amount = deposit.data.amount
2021-03-15 11:08:41 +00:00
validator_pubkeys = [validator.pubkey for validator in state.validators]
2021-01-05 18:09:39 +00:00
if pubkey not in validator_pubkeys:
# Verify the deposit signature (proof of possession) which is not checked by the deposit contract
deposit_message = DepositMessage(
pubkey=deposit.data.pubkey,
withdrawal_credentials=deposit.data.withdrawal_credentials,
amount=deposit.data.amount,
)
domain = compute_domain(DOMAIN_DEPOSIT) # Fork-agnostic domain since deposits are valid across forks
signing_root = compute_signing_root(deposit_message, domain)
2021-03-15 11:08:41 +00:00
# Initialize validator if the deposit signature is valid
if bls.Verify(pubkey, signing_root, deposit.data.signature):
state.validators.append(get_validator_from_deposit(state, deposit))
state.balances.append(amount)
state.previous_epoch_participation.append(ParticipationFlags(0b0000_0000))
state.current_epoch_participation.append(ParticipationFlags(0b0000_0000))
Typing problems fixes (#2271)
* Typing problem fixed: `process_block_header` passes `Bytes32()` to `state_root` of `BeaconBlockHeader`, which type is `Root`
* Typing problem fixed in `initialize_beacon_state_from_eth1`: `len` returns an `int` value, while `deposit_count=uint64` of `Eth1Data` has type `uint64`
* Typing problem fixed in `process_rewards_and_penalties`: `numerator` of type `int` passed to `weight` parameter of `get_flag_index_deltas`, which has type `uint64`
* Typing problem fixed in `process_attestation`; `False` passes as `crosslink_success` parameter of `PendingAttestation`, which has type `boolean`. `False` is an instance of `(python.)bool` and is not an instance of `(ssz.)boolean`
* Typing problem fixed: `shard_data_roots` of `ShardTransition` has type `List[Bytes32]`, but its elements are used as if they were `Root` values, e.g. in `process_chunk_challenge` method: passed to `data_root` of `CustodyChunkChallengeRecord` which has type `Root`
* Typing problem fixed in `process_custody_final_updates`: `index` has type `int`, while `validator_indices_in_records` has type `Set[ValidatorIndex]`, so tesing whether `index in validator_indices_in_records` can be risky, depending on implementation details. `ValidatorIndex(index) in validator_indices_in_records` is a safer variant.
* Typing problem fixed: `slashed` parameter of `pack_compact_validator` has type `(python.)bool`, however in `committee_to_compact_committee` a value of `(ssz.)boolean` is passed as a value of the parameter
* Typing problem fixed: `inactivity_scores` is a `List[uint64,...]`, while it is intialized/appended with values of `(python.)int` type
* fixed according to @protolambda suggestions
* changed types of _WEIGHT constants and appropriate variables/parameters, according to @protolambda suggestions
* revert code formatting back
* Introduced ZERO_ROOT according to @protolambda 's suggestion
* Reverted back to , according to @protolambda comments
2021-03-25 21:03:21 +00:00
state.inactivity_scores.append(uint64(0))
2021-01-05 18:09:39 +00:00
else:
# Increase balance by deposit amount
index = ValidatorIndex(validator_pubkeys.index(pubkey))
increase_balance(state, index, amount)
```
2020-11-15 10:56:24 +00:00
#### Sync committee processing
2020-11-12 09:28:05 +00:00
```python
2021-03-15 20:43:49 +00:00
def process_sync_committee(state: BeaconState, aggregate: SyncAggregate) -> None:
2020-11-15 10:56:24 +00:00
# Verify sync committee aggregate signature signing over the previous slot block root
2020-12-07 15:10:39 +00:00
committee_pubkeys = state.current_sync_committee.pubkeys
2021-04-02 13:52:32 +00:00
participant_pubkeys = [pubkey for pubkey, bit in zip(committee_pubkeys, aggregate.sync_committee_bits) if bit]
previous_slot = max(state.slot, Slot(1)) - Slot(1)
2020-11-15 10:56:24 +00:00
domain = get_domain(state, DOMAIN_SYNC_COMMITTEE, compute_epoch_at_slot(previous_slot))
signing_root = compute_signing_root(get_block_root_at_slot(state, previous_slot), domain)
2021-04-02 13:52:32 +00:00
assert eth2_fast_aggregate_verify(participant_pubkeys, signing_root, aggregate.sync_committee_signature)
2021-03-16 15:30:25 +00:00
2021-04-02 14:05:54 +00:00
# Compute participant and proposer rewards
2021-03-16 15:30:25 +00:00
total_active_increments = get_total_active_balance(state) // EFFECTIVE_BALANCE_INCREMENT
total_base_rewards = Gwei(get_base_reward_per_increment(state) * total_active_increments)
2021-04-02 13:52:32 +00:00
max_participant_rewards = Gwei(total_base_rewards * SYNC_REWARD_WEIGHT // WEIGHT_DENOMINATOR // SLOTS_PER_EPOCH)
participant_reward = Gwei(max_participant_rewards // SYNC_COMMITTEE_SIZE)
2021-04-02 14:05:54 +00:00
proposer_reward = Gwei(participant_reward * PROPOSER_WEIGHT // (WEIGHT_DENOMINATOR - PROPOSER_WEIGHT))
2021-04-02 13:52:32 +00:00
2021-04-02 14:05:54 +00:00
# Apply participant and proposer rewards
2021-04-02 13:52:32 +00:00
committee_indices = get_sync_committee_indices(state, get_current_epoch(state))
participant_indices = [index for index, bit in zip(committee_indices, aggregate.sync_committee_bits) if bit]
for participant_index in participant_indices:
increase_balance(state, participant_index, participant_reward)
2021-03-26 10:51:29 +00:00
increase_balance(state, get_beacon_proposer_index(state), proposer_reward)
2020-11-12 09:28:05 +00:00
```
### Epoch processing
2021-01-19 13:41:34 +00:00
```python
def process_epoch(state: BeaconState) -> None:
2021-03-11 13:22:38 +00:00
process_justification_and_finalization(state) # [Modified in Altair]
2021-03-15 11:08:41 +00:00
process_inactivity_updates(state) # [New in Altair]
2021-03-11 13:22:38 +00:00
process_rewards_and_penalties(state) # [Modified in Altair]
2021-01-19 13:41:34 +00:00
process_registry_updates(state)
2021-03-11 13:22:38 +00:00
process_slashings(state) # [Modified in Altair]
2021-01-27 06:42:50 +00:00
process_eth1_data_reset(state)
process_effective_balance_updates(state)
process_slashings_reset(state)
process_randao_mixes_reset(state)
process_historical_roots_update(state)
2021-03-11 13:22:38 +00:00
process_participation_flag_updates(state) # [New in Altair]
process_sync_committee_updates(state) # [New in Altair]
2021-01-19 13:41:34 +00:00
```
2021-03-02 01:19:12 +00:00
#### Justification and finalization
2020-12-15 05:18:20 +00:00
2021-03-21 03:22:37 +00:00
*Note*: The function `process_justification_and_finalization` is modified to adapt to the new participation records.
2020-12-15 05:18:20 +00:00
```python
2020-12-18 23:22:11 +00:00
def process_justification_and_finalization(state: BeaconState) -> None:
# Initial FFG checkpoint values have a `0x00` stub for `root` .
# Skip FFG updates in the first two epochs to avoid corner cases that might result in modifying this stub.
if get_current_epoch(state) < = GENESIS_EPOCH + 1:
return
2021-03-22 16:50:18 +00:00
previous_indices = get_unslashed_participating_indices(state, TIMELY_TARGET_FLAG_INDEX, get_previous_epoch(state))
current_indices = get_unslashed_participating_indices(state, TIMELY_TARGET_FLAG_INDEX, get_current_epoch(state))
total_active_balance = get_total_active_balance(state)
previous_target_balance = get_total_balance(state, previous_indices)
current_target_balance = get_total_balance(state, current_indices)
weigh_justification_and_finalization(state, total_active_balance, previous_target_balance, current_target_balance)
2020-12-18 23:22:11 +00:00
```
2020-12-15 05:18:20 +00:00
2021-03-15 11:08:41 +00:00
#### Inactivity scores
2021-03-09 19:52:04 +00:00
2021-03-15 11:08:41 +00:00
*Note*: The function `process_inactivity_updates` is new.
2021-03-09 20:21:16 +00:00
2021-03-09 19:52:04 +00:00
```python
2021-03-15 11:08:41 +00:00
def process_inactivity_updates(state: BeaconState) -> None:
2021-03-09 19:52:04 +00:00
for index in get_eligible_validator_indices(state):
2021-03-15 11:08:41 +00:00
if index in get_unslashed_participating_indices(state, TIMELY_TARGET_FLAG_INDEX, get_previous_epoch(state)):
if state.inactivity_scores[index] > 0:
state.inactivity_scores[index] -= 1
2021-03-09 19:52:04 +00:00
elif is_in_inactivity_leak(state):
2021-03-15 11:08:41 +00:00
state.inactivity_scores[index] += INACTIVITY_SCORE_BIAS
2021-03-09 19:52:04 +00:00
```
2021-03-02 01:19:12 +00:00
#### Rewards and penalties
2020-12-18 23:22:11 +00:00
2021-03-15 11:08:41 +00:00
*Note*: The function `process_rewards_and_penalties` is modified to support the incentive accounting reforms.
2020-12-18 23:22:11 +00:00
```python
def process_rewards_and_penalties(state: BeaconState) -> None:
# No rewards are applied at the end of `GENESIS_EPOCH` because rewards are for work done in the previous epoch
if get_current_epoch(state) == GENESIS_EPOCH:
return
2021-03-15 11:08:41 +00:00
2021-03-16 15:30:25 +00:00
flag_indices_and_numerators = get_flag_indices_and_weights()
2021-03-15 11:08:41 +00:00
flag_deltas = [get_flag_index_deltas(state, index, numerator) for (index, numerator) in flag_indices_and_numerators]
2020-12-18 23:22:11 +00:00
deltas = flag_deltas + [get_inactivity_penalty_deltas(state)]
2021-01-05 20:48:26 +00:00
for (rewards, penalties) in deltas:
2020-12-18 23:22:11 +00:00
for index in range(len(state.validators)):
increase_balance(state, ValidatorIndex(index), rewards[index])
2021-01-05 20:48:26 +00:00
decrease_balance(state, ValidatorIndex(index), penalties[index])
2020-12-15 05:18:20 +00:00
```
2021-03-02 01:19:12 +00:00
#### Slashings
2021-02-11 21:53:29 +00:00
2021-03-15 17:46:53 +00:00
*Note*: The function `process_slashings` is modified to use `PROPORTIONAL_SLASHING_MULTIPLIER_ALTAIR` .
2021-02-11 21:53:29 +00:00
```python
def process_slashings(state: BeaconState) -> None:
epoch = get_current_epoch(state)
total_balance = get_total_active_balance(state)
2021-03-15 17:46:53 +00:00
adjusted_total_slashing_balance = min(sum(state.slashings) * PROPORTIONAL_SLASHING_MULTIPLIER_ALTAIR, total_balance)
2021-02-11 21:53:29 +00:00
for index, validator in enumerate(state.validators):
if validator.slashed and epoch + EPOCHS_PER_SLASHINGS_VECTOR // 2 == validator.withdrawable_epoch:
increment = EFFECTIVE_BALANCE_INCREMENT # Factored out from penalty numerator to avoid uint64 overflow
penalty_numerator = validator.effective_balance // increment * adjusted_total_slashing_balance
penalty = penalty_numerator // total_balance * increment
decrease_balance(state, ValidatorIndex(index), penalty)
```
2021-03-02 01:19:12 +00:00
#### Participation flags updates
*Note*: The function `process_participation_flag_updates` is new.
```python
def process_participation_flag_updates(state: BeaconState) -> None:
state.previous_epoch_participation = state.current_epoch_participation
state.current_epoch_participation = [ParticipationFlags(0b0000_0000) for _ in range(len(state.validators))]
```
2021-01-19 13:41:34 +00:00
#### Sync committee updates
2020-12-15 05:18:20 +00:00
2021-03-02 01:19:12 +00:00
*Note*: The function `process_sync_committee_updates` is new.
2020-11-12 09:28:05 +00:00
```python
2021-01-19 13:41:34 +00:00
def process_sync_committee_updates(state: BeaconState) -> None:
2020-11-15 10:56:24 +00:00
next_epoch = get_current_epoch(state) + Epoch(1)
if next_epoch % EPOCHS_PER_SYNC_COMMITTEE_PERIOD == 0:
state.current_sync_committee = state.next_sync_committee
state.next_sync_committee = get_sync_committee(state, next_epoch + EPOCHS_PER_SYNC_COMMITTEE_PERIOD)
2020-11-12 09:28:05 +00:00
```
2021-04-09 16:53:37 +00:00
2021-04-20 15:37:53 +00:00
## Initialize state for pure Altair testnets and test vectors
2021-04-09 16:53:37 +00:00
2021-04-20 15:37:53 +00:00
This helper function is only for initializing the state for pure Altair testnets and tests.
2021-04-12 14:02:04 +00:00
2021-04-21 08:42:54 +00:00
*Note*: The function `initialize_beacon_state_from_eth1` is modified: (1) using `ALTAIR_FORK_VERSION` as the current fork version, (2) utilizing the Altair `BeaconBlockBody` when constructing the initial `latest_block_header` , and (3) adding initial sync committees.
2021-04-09 16:53:37 +00:00
```python
def initialize_beacon_state_from_eth1(eth1_block_hash: Bytes32,
eth1_timestamp: uint64,
deposits: Sequence[Deposit]) -> BeaconState:
fork = Fork(
previous_version=GENESIS_FORK_VERSION,
2021-04-27 18:11:15 +00:00
current_version=ALTAIR_FORK_VERSION, # [Modified in Altair]
2021-04-09 16:53:37 +00:00
epoch=GENESIS_EPOCH,
)
state = BeaconState(
genesis_time=eth1_timestamp + GENESIS_DELAY,
fork=fork,
eth1_data=Eth1Data(block_hash=eth1_block_hash, deposit_count=uint64(len(deposits))),
latest_block_header=BeaconBlockHeader(body_root=hash_tree_root(BeaconBlockBody())),
randao_mixes=[eth1_block_hash] * EPOCHS_PER_HISTORICAL_VECTOR, # Seed RANDAO with Eth1 entropy
)
# Process deposits
leaves = list(map(lambda deposit: deposit.data, deposits))
for index, deposit in enumerate(deposits):
deposit_data_list = List[DepositData, 2**DEPOSIT_CONTRACT_TREE_DEPTH](*leaves[:index + 1])
state.eth1_data.deposit_root = hash_tree_root(deposit_data_list)
process_deposit(state, deposit)
# Process activations
for index, validator in enumerate(state.validators):
balance = state.balances[index]
validator.effective_balance = min(balance - balance % EFFECTIVE_BALANCE_INCREMENT, MAX_EFFECTIVE_BALANCE)
if validator.effective_balance == MAX_EFFECTIVE_BALANCE:
validator.activation_eligibility_epoch = GENESIS_EPOCH
validator.activation_epoch = GENESIS_EPOCH
# Set genesis validators root for domain separation and chain versioning
state.genesis_validators_root = hash_tree_root(state.validators)
2021-04-16 03:34:50 +00:00
# [New in Altair] Fill in sync committees
2021-04-09 16:53:37 +00:00
state.current_sync_committee = get_sync_committee(state, get_current_epoch(state))
state.next_sync_committee = get_sync_committee(state, get_current_epoch(state) + EPOCHS_PER_SYNC_COMMITTEE_PERIOD)
return state
```