378 lines
15 KiB
Nim
378 lines
15 KiB
Nim
# beacon_chain
|
|
# Copyright (c) 2021-2022 Status Research & Development GmbH
|
|
# Licensed and distributed under either of
|
|
# * MIT license (license terms in the root directory or at https://opensource.org/licenses/MIT).
|
|
# * Apache v2 license (license terms in the root directory or at https://www.apache.org/licenses/LICENSE-2.0).
|
|
# at your option. This file may not be copied, modified, or distributed except according to those terms.
|
|
|
|
{.used.}
|
|
|
|
import
|
|
# Standard library
|
|
std/[algorithm, sequtils, sets],
|
|
# Status libraries
|
|
stew/bitops2,
|
|
# Beacon chain internals
|
|
../../../beacon_chain/spec/datatypes/altair,
|
|
../../../beacon_chain/spec/
|
|
[beaconstate, forks, helpers, light_client_sync, signatures,
|
|
state_transition],
|
|
# Mock helpers
|
|
../../mocking/[mock_blocks, mock_genesis],
|
|
# Test utilities
|
|
../../testutil, ../../testblockutil
|
|
|
|
# References to `vFuture` refer to the pre-release proposal of the libp2p based
|
|
# light client sync protocol. Conflicting release versions are not in use.
|
|
# https://github.com/ethereum/consensus-specs/pull/2802
|
|
|
|
# https://github.com/ethereum/consensus-specs/blob/v1.1.10/tests/core/pyspec/eth2spec/test/helpers/sync_committee.py#L27-L44
|
|
proc compute_aggregate_sync_committee_signature(
|
|
forked: ForkedHashedBeaconState,
|
|
signature_slot: Slot,
|
|
participants: openArray[ValidatorIndex],
|
|
block_root: Eth2Digest): ValidatorSig =
|
|
template state: untyped {.inject.} = forked.altairData.data
|
|
|
|
if len(participants) == 0:
|
|
return ValidatorSig.infinity
|
|
|
|
var
|
|
aggregateSig {.noinit.}: AggregateSignature
|
|
initialized = false
|
|
for validator_index in participants:
|
|
let
|
|
privkey = MockPrivKeys[validator_index]
|
|
signature = get_sync_committee_message_signature(
|
|
state.fork,
|
|
state.genesis_validators_root,
|
|
signature_slot,
|
|
block_root,
|
|
privkey)
|
|
if not initialized:
|
|
initialized = true
|
|
aggregateSig.init(signature)
|
|
else:
|
|
aggregateSig.aggregate(signature)
|
|
aggregateSig.finish.toValidatorSig
|
|
|
|
proc block_for_next_slot(
|
|
cfg: RuntimeConfig,
|
|
forked: var ForkedHashedBeaconState,
|
|
cache: var StateCache,
|
|
withAttestations = false): ForkedSignedBeaconBlock =
|
|
template state: untyped {.inject.} = forked.altairData.data
|
|
|
|
let attestations =
|
|
if withAttestations:
|
|
let block_root = withState(forked): state.latest_block_root
|
|
makeFullAttestations(forked, block_root, state.slot, cache)
|
|
else:
|
|
@[]
|
|
|
|
addTestBlock(
|
|
forked, cache, attestations = attestations, cfg = cfg)
|
|
|
|
let full_sync_committee_bits = block:
|
|
var res: BitArray[SYNC_COMMITTEE_SIZE]
|
|
res.bytes.fill(byte.high)
|
|
res
|
|
|
|
# https://github.com/ethereum/consensus-specs/blob/v1.1.10/tests/core/pyspec/eth2spec/test/helpers/light_client.py#L6-L15
|
|
func initialize_light_client_store(state: auto): LightClientStore =
|
|
LightClientStore(
|
|
finalized_header: BeaconBlockHeader(),
|
|
current_sync_committee: state.current_sync_committee,
|
|
next_sync_committee: state.next_sync_committee,
|
|
best_valid_update: none(altair.LightClientUpdate),
|
|
optimistic_header: BeaconBlockHeader(),
|
|
previous_max_active_participants: 0,
|
|
current_max_active_participants: 0,
|
|
)
|
|
|
|
suite "EF - Altair - Unittests - Sync protocol" & preset():
|
|
let
|
|
cfg = block:
|
|
var res = defaultRuntimeConfig
|
|
res.ALTAIR_FORK_EPOCH = GENESIS_EPOCH
|
|
res
|
|
genesisState = newClone(initGenesisState(cfg = cfg))
|
|
|
|
# https://github.com/ethereum/consensus-specs/blob/vFuture/tests/core/pyspec/eth2spec/test/altair/unittests/test_sync_protocol.py#L27-L77
|
|
test "test_process_light_client_update_not_timeout":
|
|
let forked = assignClone(genesisState[])
|
|
template state: untyped {.inject.} = forked[].altairData.data
|
|
var store = initialize_light_client_store(state)
|
|
|
|
# Block at slot 1 doesn't increase sync committee period,
|
|
# so it won't update snapshot
|
|
var cache = StateCache()
|
|
let
|
|
signed_block = block_for_next_slot(cfg, forked[], cache).altairData
|
|
block_header = signed_block.toBeaconBlockHeader
|
|
|
|
# Sync committee signing the block_header
|
|
signature_slot = block_header.slot + 1
|
|
all_pubkeys = state.validators.mapIt(it.pubkey)
|
|
committee = state.current_sync_committee.pubkeys
|
|
.mapIt(all_pubkeys.find(it).ValidatorIndex)
|
|
sync_committee_bits = full_sync_committee_bits
|
|
sync_committee_signature = compute_aggregate_sync_committee_signature(
|
|
forked[], signature_slot, committee, block_header.hash_tree_root())
|
|
sync_aggregate = SyncAggregate(
|
|
sync_committee_bits: sync_committee_bits,
|
|
sync_committee_signature: sync_committee_signature)
|
|
|
|
template next_sync_committee(): auto = state.next_sync_committee
|
|
var next_sync_committee_branch {.noinit.}:
|
|
array[log2trunc(altair.NEXT_SYNC_COMMITTEE_INDEX), Eth2Digest]
|
|
state.build_proof(
|
|
altair.NEXT_SYNC_COMMITTEE_INDEX, next_sync_committee_branch)
|
|
|
|
# Ensure that finality checkpoint is genesis
|
|
check: state.finalized_checkpoint.epoch == 0
|
|
# Finality is unchanged
|
|
let
|
|
finality_header = BeaconBlockHeader()
|
|
pre_store_finalized_header = store.finalized_header
|
|
var finality_branch:
|
|
array[log2trunc(altair.FINALIZED_ROOT_INDEX), Eth2Digest]
|
|
|
|
let
|
|
update = altair.LightClientUpdate(
|
|
attested_header: block_header,
|
|
next_sync_committee: next_sync_committee,
|
|
next_sync_committee_branch: next_sync_committee_branch,
|
|
finalized_header: finality_header,
|
|
finality_branch: finality_branch,
|
|
sync_aggregate: sync_aggregate,
|
|
fork_version: state.fork.current_version)
|
|
res = process_light_client_update(
|
|
store, update, signature_slot, cfg, state.genesis_validators_root)
|
|
|
|
check:
|
|
res.isOk
|
|
store.current_max_active_participants > 0
|
|
store.optimistic_header == update.attested_header
|
|
store.finalized_header == pre_store_finalized_header
|
|
store.best_valid_update.get == update
|
|
|
|
# https://github.com/ethereum/consensus-specs/blob/vFuture/tests/core/pyspec/eth2spec/test/altair/unittests/test_sync_protocol.py#L80-L136
|
|
test "test_process_light_client_update_at_period_boundary":
|
|
var forked = assignClone(genesisState[])
|
|
template state: untyped {.inject.} = forked[].altairData.data
|
|
var store = initialize_light_client_store(state)
|
|
|
|
# Forward to slot before next sync committee period so that next block is final one in period
|
|
var
|
|
cache = StateCache()
|
|
info = ForkedEpochInfo()
|
|
process_slots(
|
|
cfg, forked[], Slot(UPDATE_TIMEOUT - 2), cache, info, flags = {}).expect("no failure")
|
|
let
|
|
snapshot_period = sync_committee_period(store.optimistic_header.slot)
|
|
update_period = sync_committee_period(state.slot)
|
|
check: snapshot_period == update_period
|
|
|
|
let
|
|
signed_block = block_for_next_slot(cfg, forked[], cache).altairData
|
|
block_header = signed_block.toBeaconBlockHeader
|
|
|
|
# Sync committee signing the block_header
|
|
signature_slot = block_header.slot + 1
|
|
all_pubkeys = state.validators.mapIt(it.pubkey)
|
|
committee = state.next_sync_committee.pubkeys
|
|
.mapIt(all_pubkeys.find(it).ValidatorIndex)
|
|
sync_committee_bits = full_sync_committee_bits
|
|
sync_committee_signature = compute_aggregate_sync_committee_signature(
|
|
forked[], signature_slot, committee, block_header.hash_tree_root())
|
|
sync_aggregate = SyncAggregate(
|
|
sync_committee_bits: sync_committee_bits,
|
|
sync_committee_signature: sync_committee_signature)
|
|
|
|
# Sync committee is omitted (signed by next sync committee)
|
|
next_sync_committee = SyncCommittee()
|
|
var next_sync_committee_branch:
|
|
array[log2trunc(altair.NEXT_SYNC_COMMITTEE_INDEX), Eth2Digest]
|
|
# Finality is unchanged
|
|
let
|
|
finality_header = BeaconBlockHeader()
|
|
pre_store_finalized_header = store.finalized_header
|
|
var finality_branch:
|
|
array[log2trunc(altair.FINALIZED_ROOT_INDEX), Eth2Digest]
|
|
|
|
let
|
|
update = altair.LightClientUpdate(
|
|
attested_header: block_header,
|
|
next_sync_committee: next_sync_committee,
|
|
next_sync_committee_branch: next_sync_committee_branch,
|
|
finalized_header: finality_header,
|
|
finality_branch: finality_branch,
|
|
sync_aggregate: sync_aggregate,
|
|
fork_version: state.fork.current_version)
|
|
res = process_light_client_update(
|
|
store, update, signature_slot, cfg, state.genesis_validators_root)
|
|
|
|
check:
|
|
res.isOk
|
|
store.current_max_active_participants > 0
|
|
store.optimistic_header == update.attested_header
|
|
store.finalized_header == pre_store_finalized_header
|
|
store.best_valid_update.get == update
|
|
|
|
# https://github.com/ethereum/consensus-specs/blob/vFuture/tests/core/pyspec/eth2spec/test/altair/unittests/test_sync_protocol.py#L139-L193
|
|
test "process_light_client_update_timeout":
|
|
let forked = assignClone(genesisState[])
|
|
template state: untyped {.inject.} = forked[].altairData.data
|
|
var store = initialize_light_client_store(state)
|
|
|
|
# Forward to next sync committee period
|
|
var
|
|
cache = StateCache()
|
|
info = ForkedEpochInfo()
|
|
process_slots(
|
|
cfg, forked[], Slot(UPDATE_TIMEOUT), cache, info, flags = {}).expect("no failure")
|
|
let
|
|
snapshot_period = sync_committee_period(store.optimistic_header.slot)
|
|
update_period = sync_committee_period(state.slot)
|
|
check: snapshot_period + 1 == update_period
|
|
|
|
let
|
|
signed_block = block_for_next_slot(cfg, forked[], cache).altairData
|
|
block_header = signed_block.toBeaconBlockHeader
|
|
|
|
# Sync committee signing the block_header
|
|
signature_slot = block_header.slot + 1
|
|
all_pubkeys = state.validators.mapIt(it.pubkey)
|
|
committee = state.current_sync_committee.pubkeys
|
|
.mapIt(all_pubkeys.find(it).ValidatorIndex)
|
|
sync_committee_bits = full_sync_committee_bits
|
|
sync_committee_signature = compute_aggregate_sync_committee_signature(
|
|
forked[], signature_slot, committee, block_header.hash_tree_root())
|
|
sync_aggregate = SyncAggregate(
|
|
sync_committee_bits: sync_committee_bits,
|
|
sync_committee_signature: sync_committee_signature)
|
|
|
|
# Sync committee is updated
|
|
template next_sync_committee(): auto = state.next_sync_committee
|
|
var next_sync_committee_branch {.noinit.}:
|
|
array[log2trunc(altair.NEXT_SYNC_COMMITTEE_INDEX), Eth2Digest]
|
|
state.build_proof(
|
|
altair.NEXT_SYNC_COMMITTEE_INDEX, next_sync_committee_branch)
|
|
# Finality is unchanged
|
|
let finality_header = BeaconBlockHeader()
|
|
var finality_branch:
|
|
array[log2trunc(altair.FINALIZED_ROOT_INDEX), Eth2Digest]
|
|
|
|
let
|
|
update = altair.LightClientUpdate(
|
|
attested_header: block_header,
|
|
next_sync_committee: next_sync_committee,
|
|
next_sync_committee_branch: next_sync_committee_branch,
|
|
finalized_header: finality_header,
|
|
finality_branch: finality_branch,
|
|
sync_aggregate: sync_aggregate,
|
|
fork_version: state.fork.current_version)
|
|
res = process_light_client_update(
|
|
store, update, signature_slot, cfg, state.genesis_validators_root)
|
|
|
|
check:
|
|
res.isOk
|
|
store.previous_max_active_participants > 0
|
|
store.optimistic_header == update.attested_header
|
|
store.finalized_header == update.attested_header
|
|
store.best_valid_update.isNone
|
|
|
|
# https://github.com/ethereum/consensus-specs/blob/vFuture/tests/core/pyspec/eth2spec/test/altair/unittests/test_sync_protocol.py#L196-L260
|
|
test "process_light_client_update_finality_updated":
|
|
let forked = assignClone(genesisState[])
|
|
template state: untyped {.inject.} = forked[].altairData.data
|
|
var store = initialize_light_client_store(state)
|
|
|
|
# Change finality
|
|
var
|
|
cache = StateCache()
|
|
info = ForkedEpochInfo()
|
|
blocks = newSeq[ForkedSignedBeaconBlock]()
|
|
process_slots(
|
|
cfg, forked[], Slot(SLOTS_PER_EPOCH * 2), cache, info, flags = {}).expect("no failure")
|
|
for slot in 0 ..< SLOTS_PER_EPOCH:
|
|
blocks.add block_for_next_slot(cfg, forked[], cache,
|
|
withAttestations = true)
|
|
let finalized = assignClone(forked[])
|
|
template finalized_state: untyped {.inject.} = finalized[].altairData.data
|
|
for slot in 0 ..< SLOTS_PER_EPOCH:
|
|
blocks.add block_for_next_slot(cfg, forked[], cache,
|
|
withAttestations = true)
|
|
for slot in 0 ..< SLOTS_PER_EPOCH:
|
|
blocks.add block_for_next_slot(cfg, forked[], cache,
|
|
withAttestations = true)
|
|
# Ensure that finality checkpoint has changed
|
|
check: state.finalized_checkpoint.epoch == 3
|
|
check: state.finalized_checkpoint.root ==
|
|
mockBlockForNextSlot(finalized[]).altairData.message.parent_root
|
|
# Ensure that it's same period
|
|
let
|
|
snapshot_period = sync_committee_period(store.optimistic_header.slot)
|
|
update_period = sync_committee_period(state.slot)
|
|
check: snapshot_period == update_period
|
|
|
|
# Updated sync_committee and finality
|
|
template next_sync_committee(): auto = finalized_state.next_sync_committee
|
|
var next_sync_committee_branch {.noinit.}:
|
|
array[log2trunc(altair.NEXT_SYNC_COMMITTEE_INDEX), Eth2Digest]
|
|
finalized_state.build_proof(
|
|
altair.NEXT_SYNC_COMMITTEE_INDEX, next_sync_committee_branch)
|
|
let
|
|
finalized_block = blocks[SLOTS_PER_EPOCH - 1].altairData
|
|
finalized_block_header = finalized_block.toBeaconBlockHeader
|
|
check:
|
|
finalized_block_header.slot ==
|
|
start_slot(state.finalized_checkpoint.epoch)
|
|
finalized_block_header.hash_tree_root() ==
|
|
state.finalized_checkpoint.root
|
|
var finality_branch {.noinit.}:
|
|
array[log2trunc(altair.FINALIZED_ROOT_INDEX), Eth2Digest]
|
|
state.build_proof(
|
|
altair.FINALIZED_ROOT_INDEX, finality_branch)
|
|
|
|
# Build block header
|
|
let
|
|
blck = mockBlock(forked[], state.slot, cfg = cfg).altairData.message
|
|
block_header = BeaconBlockHeader(
|
|
slot: blck.slot,
|
|
proposer_index: blck.proposer_index,
|
|
parent_root: blck.parent_root,
|
|
state_root: state.hash_tree_root(),
|
|
body_root: blck.body.hash_tree_root())
|
|
|
|
# Sync committee signing the finalized_block_header
|
|
signature_slot = block_header.slot + 1
|
|
all_pubkeys = state.validators.mapIt(it.pubkey)
|
|
committee = state.current_sync_committee.pubkeys
|
|
.mapIt(all_pubkeys.find(it).ValidatorIndex)
|
|
sync_committee_bits = full_sync_committee_bits
|
|
sync_committee_signature = compute_aggregate_sync_committee_signature(
|
|
forked[], signature_slot, committee, block_header.hash_tree_root())
|
|
sync_aggregate = SyncAggregate(
|
|
sync_committee_bits: sync_committee_bits,
|
|
sync_committee_signature: sync_committee_signature)
|
|
|
|
update = altair.LightClientUpdate(
|
|
attested_header: block_header,
|
|
next_sync_committee: next_sync_committee,
|
|
next_sync_committee_branch: next_sync_committee_branch,
|
|
finalized_header: finalized_block_header,
|
|
finality_branch: finality_branch,
|
|
sync_aggregate: sync_aggregate,
|
|
fork_version: state.fork.current_version)
|
|
res = process_light_client_update(
|
|
store, update, signature_slot, cfg, state.genesis_validators_root)
|
|
|
|
check:
|
|
res.isOk
|
|
store.current_max_active_participants > 0
|
|
store.optimistic_header == update.attested_header
|
|
store.finalized_header == update.finalized_header
|
|
store.best_valid_update.isNone
|