2020-06-16 05:45:04 +00:00
|
|
|
# beacon_chain
|
2021-02-25 13:37:22 +00:00
|
|
|
# Copyright (c) 2018-2021 Status Research & Development GmbH
|
2020-06-16 05:45:04 +00:00
|
|
|
# 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.
|
|
|
|
|
|
|
|
{.push raises: [Defect].}
|
|
|
|
|
|
|
|
import
|
2020-07-07 23:02:14 +00:00
|
|
|
../ssz/merkleization,
|
|
|
|
./crypto, ./digest, ./datatypes, ./helpers, ./presets
|
2020-06-16 05:45:04 +00:00
|
|
|
|
2020-06-25 10:23:10 +00:00
|
|
|
template withTrust(sig: SomeSig, body: untyped): bool =
|
|
|
|
when sig is TrustedSig:
|
|
|
|
true
|
|
|
|
else:
|
|
|
|
body
|
|
|
|
|
2021-03-29 19:17:48 +00:00
|
|
|
func getDepositMessage(depositData: DepositData): DepositMessage =
|
|
|
|
DepositMessage(
|
|
|
|
pubkey: depositData.pubkey,
|
|
|
|
amount: depositData.amount,
|
|
|
|
withdrawal_credentials: depositData.withdrawal_credentials)
|
|
|
|
|
2020-09-01 13:44:40 +00:00
|
|
|
func compute_slot_root*(
|
|
|
|
fork: Fork, genesis_validators_root: Eth2Digest, slot: Slot
|
|
|
|
): Eth2Digest =
|
2020-06-16 05:45:04 +00:00
|
|
|
let
|
|
|
|
epoch = compute_epoch_at_slot(slot)
|
|
|
|
domain = get_domain(
|
|
|
|
fork, DOMAIN_SELECTION_PROOF, epoch, genesis_validators_root)
|
2020-09-01 13:44:40 +00:00
|
|
|
result = compute_signing_root(slot, domain)
|
2020-06-16 05:45:04 +00:00
|
|
|
|
2021-02-25 13:37:22 +00:00
|
|
|
# https://github.com/ethereum/eth2.0-specs/blob/v1.0.1/specs/phase0/validator.md#aggregation-selection
|
2020-09-01 13:44:40 +00:00
|
|
|
func get_slot_signature*(
|
|
|
|
fork: Fork, genesis_validators_root: Eth2Digest, slot: Slot,
|
|
|
|
privkey: ValidatorPrivKey): ValidatorSig =
|
|
|
|
blsSign(privKey, compute_slot_root(fork, genesis_validators_root, slot).data)
|
2020-06-16 05:45:04 +00:00
|
|
|
|
2020-07-23 14:38:28 +00:00
|
|
|
proc verify_slot_signature*(
|
2020-07-02 16:15:27 +00:00
|
|
|
fork: Fork, genesis_validators_root: Eth2Digest, slot: Slot,
|
|
|
|
pubkey: ValidatorPubKey, signature: SomeSig): bool =
|
|
|
|
withTrust(signature):
|
|
|
|
let
|
|
|
|
epoch = compute_epoch_at_slot(slot)
|
|
|
|
domain = get_domain(
|
|
|
|
fork, DOMAIN_SELECTION_PROOF, epoch, genesis_validators_root)
|
|
|
|
signing_root = compute_signing_root(slot, domain)
|
|
|
|
|
|
|
|
blsVerify(pubkey, signing_root.data, signature)
|
|
|
|
|
2020-09-01 13:44:40 +00:00
|
|
|
func compute_epoch_root*(
|
|
|
|
fork: Fork, genesis_validators_root: Eth2Digest, epoch: Epoch
|
|
|
|
): Eth2Digest =
|
|
|
|
let
|
|
|
|
domain = get_domain(fork, DOMAIN_RANDAO, epoch, genesis_validators_root)
|
|
|
|
result = compute_signing_root(epoch, domain)
|
|
|
|
|
2021-02-25 13:37:22 +00:00
|
|
|
# https://github.com/ethereum/eth2.0-specs/blob/v1.0.1/specs/phase0/validator.md#randao-reveal
|
2020-06-16 05:45:04 +00:00
|
|
|
func get_epoch_signature*(
|
|
|
|
fork: Fork, genesis_validators_root: Eth2Digest, epoch: Epoch,
|
|
|
|
privkey: ValidatorPrivKey): ValidatorSig =
|
2020-09-01 13:44:40 +00:00
|
|
|
blsSign(privKey, compute_epoch_root(fork, genesis_validators_root, epoch).data)
|
2020-06-16 05:45:04 +00:00
|
|
|
|
2020-07-23 14:38:28 +00:00
|
|
|
proc verify_epoch_signature*(
|
2020-06-16 05:45:04 +00:00
|
|
|
fork: Fork, genesis_validators_root: Eth2Digest, epoch: Epoch,
|
2020-06-25 10:23:10 +00:00
|
|
|
pubkey: ValidatorPubKey, signature: SomeSig): bool =
|
|
|
|
withTrust(signature):
|
|
|
|
let
|
|
|
|
domain = get_domain(fork, DOMAIN_RANDAO, epoch, genesis_validators_root)
|
|
|
|
signing_root = compute_signing_root(epoch, domain)
|
2020-06-16 05:45:04 +00:00
|
|
|
|
2020-06-25 10:23:10 +00:00
|
|
|
blsVerify(pubkey, signing_root.data, signature)
|
2020-06-16 05:45:04 +00:00
|
|
|
|
2020-09-01 13:44:40 +00:00
|
|
|
func compute_block_root*(
|
2020-06-16 05:45:04 +00:00
|
|
|
fork: Fork, genesis_validators_root: Eth2Digest, slot: Slot,
|
2020-09-01 13:44:40 +00:00
|
|
|
root: Eth2Digest): Eth2Digest =
|
2020-06-16 05:45:04 +00:00
|
|
|
let
|
|
|
|
epoch = compute_epoch_at_slot(slot)
|
|
|
|
domain = get_domain(
|
|
|
|
fork, DOMAIN_BEACON_PROPOSER, epoch, genesis_validators_root)
|
2020-09-01 13:44:40 +00:00
|
|
|
result = compute_signing_root(root, domain)
|
2020-06-16 05:45:04 +00:00
|
|
|
|
2021-02-25 13:37:22 +00:00
|
|
|
# https://github.com/ethereum/eth2.0-specs/blob/v1.0.1/specs/phase0/validator.md#signature
|
2020-09-01 13:44:40 +00:00
|
|
|
func get_block_signature*(
|
|
|
|
fork: Fork, genesis_validators_root: Eth2Digest, slot: Slot,
|
|
|
|
root: Eth2Digest, privkey: ValidatorPrivKey): ValidatorSig =
|
|
|
|
blsSign(privKey, compute_block_root(fork, genesis_validators_root, slot, root).data)
|
2020-06-16 05:45:04 +00:00
|
|
|
|
2020-07-23 14:38:28 +00:00
|
|
|
proc verify_block_signature*(
|
2020-06-16 05:45:04 +00:00
|
|
|
fork: Fork, genesis_validators_root: Eth2Digest, slot: Slot,
|
2020-06-25 10:23:10 +00:00
|
|
|
blck: Eth2Digest | SomeBeaconBlock | BeaconBlockHeader,
|
|
|
|
pubkey: ValidatorPubKey,
|
|
|
|
signature: SomeSig): bool =
|
|
|
|
withTrust(signature):
|
|
|
|
let
|
|
|
|
epoch = compute_epoch_at_slot(slot)
|
|
|
|
domain = get_domain(
|
|
|
|
fork, DOMAIN_BEACON_PROPOSER, epoch, genesis_validators_root)
|
|
|
|
signing_root = compute_signing_root(blck, domain)
|
|
|
|
|
|
|
|
blsVerify(pubKey, signing_root.data, signature)
|
2020-06-16 05:45:04 +00:00
|
|
|
|
2020-09-01 13:44:40 +00:00
|
|
|
func compute_aggregate_and_proof_root*(fork: Fork, genesis_validators_root: Eth2Digest,
|
|
|
|
aggregate_and_proof: AggregateAndProof,
|
|
|
|
): Eth2Digest =
|
2020-06-16 05:45:04 +00:00
|
|
|
let
|
|
|
|
epoch = compute_epoch_at_slot(aggregate_and_proof.aggregate.data.slot)
|
|
|
|
domain = get_domain(
|
|
|
|
fork, DOMAIN_AGGREGATE_AND_PROOF, epoch, genesis_validators_root)
|
2020-09-01 13:44:40 +00:00
|
|
|
result = compute_signing_root(aggregate_and_proof, domain)
|
2020-06-16 05:45:04 +00:00
|
|
|
|
2021-02-25 13:37:22 +00:00
|
|
|
# https://github.com/ethereum/eth2.0-specs/blob/v1.0.1/specs/phase0/validator.md#broadcast-aggregate
|
2020-09-01 13:44:40 +00:00
|
|
|
func get_aggregate_and_proof_signature*(fork: Fork, genesis_validators_root: Eth2Digest,
|
|
|
|
aggregate_and_proof: AggregateAndProof,
|
|
|
|
privKey: ValidatorPrivKey): ValidatorSig =
|
|
|
|
blsSign(privKey, compute_aggregate_and_proof_root(fork, genesis_validators_root,
|
|
|
|
aggregate_and_proof).data)
|
2020-06-16 05:45:04 +00:00
|
|
|
|
2020-07-23 14:38:28 +00:00
|
|
|
proc verify_aggregate_and_proof_signature*(fork: Fork, genesis_validators_root: Eth2Digest,
|
2020-07-02 16:15:27 +00:00
|
|
|
aggregate_and_proof: AggregateAndProof,
|
|
|
|
pubkey: ValidatorPubKey, signature: SomeSig): bool =
|
|
|
|
withTrust(signature):
|
|
|
|
let
|
|
|
|
epoch = compute_epoch_at_slot(aggregate_and_proof.aggregate.data.slot)
|
|
|
|
domain = get_domain(
|
|
|
|
fork, DOMAIN_AGGREGATE_AND_PROOF, epoch, genesis_validators_root)
|
|
|
|
signing_root = compute_signing_root(aggregate_and_proof, domain)
|
|
|
|
|
|
|
|
blsVerify(pubKey, signing_root.data, signature)
|
|
|
|
|
2020-09-01 13:44:40 +00:00
|
|
|
func compute_attestation_root*(
|
2020-06-16 05:45:04 +00:00
|
|
|
fork: Fork, genesis_validators_root: Eth2Digest,
|
2020-09-01 13:44:40 +00:00
|
|
|
attestation_data: AttestationData
|
|
|
|
): Eth2Digest =
|
2020-06-16 05:45:04 +00:00
|
|
|
let
|
|
|
|
epoch = attestation_data.target.epoch
|
|
|
|
domain = get_domain(
|
|
|
|
fork, DOMAIN_BEACON_ATTESTER, epoch, genesis_validators_root)
|
2020-09-01 13:44:40 +00:00
|
|
|
result = compute_signing_root(attestation_data, domain)
|
2020-06-16 05:45:04 +00:00
|
|
|
|
2021-02-25 13:37:22 +00:00
|
|
|
# https://github.com/ethereum/eth2.0-specs/blob/v1.0.1/specs/phase0/validator.md#aggregate-signature
|
2020-09-01 13:44:40 +00:00
|
|
|
func get_attestation_signature*(
|
|
|
|
fork: Fork, genesis_validators_root: Eth2Digest,
|
|
|
|
attestation_data: AttestationData,
|
|
|
|
privkey: ValidatorPrivKey): ValidatorSig =
|
|
|
|
blsSign(privKey, compute_attestation_root(fork, genesis_validators_root,
|
|
|
|
attestation_data).data)
|
2020-06-16 05:45:04 +00:00
|
|
|
|
2020-07-23 14:38:28 +00:00
|
|
|
proc verify_attestation_signature*(
|
2020-06-16 05:45:04 +00:00
|
|
|
fork: Fork, genesis_validators_root: Eth2Digest,
|
|
|
|
attestation_data: AttestationData,
|
|
|
|
pubkeys: openArray[ValidatorPubKey],
|
2020-06-25 10:23:10 +00:00
|
|
|
signature: SomeSig): bool =
|
|
|
|
withTrust(signature):
|
|
|
|
let
|
|
|
|
epoch = attestation_data.target.epoch
|
|
|
|
domain = get_domain(
|
|
|
|
fork, DOMAIN_BEACON_ATTESTER, epoch, genesis_validators_root)
|
|
|
|
signing_root = compute_signing_root(attestation_data, domain)
|
2020-06-16 05:45:04 +00:00
|
|
|
|
2020-06-25 10:23:10 +00:00
|
|
|
blsFastAggregateVerify(pubkeys, signing_root.data, signature)
|
2020-06-16 05:45:04 +00:00
|
|
|
|
2021-02-25 13:37:22 +00:00
|
|
|
# https://github.com/ethereum/eth2.0-specs/blob/v1.0.1/specs/phase0/beacon-chain.md#deposits
|
2020-07-07 23:02:14 +00:00
|
|
|
func get_deposit_signature*(preset: RuntimePreset,
|
|
|
|
deposit: DepositData,
|
|
|
|
privkey: ValidatorPrivKey): ValidatorSig =
|
2020-06-16 05:45:04 +00:00
|
|
|
let
|
|
|
|
deposit_message = deposit.getDepositMessage()
|
|
|
|
# Fork-agnostic domain since deposits are valid across forks
|
2020-07-07 23:02:14 +00:00
|
|
|
domain = compute_domain(DOMAIN_DEPOSIT, preset.GENESIS_FORK_VERSION)
|
2020-06-16 05:45:04 +00:00
|
|
|
signing_root = compute_signing_root(deposit_message, domain)
|
|
|
|
|
|
|
|
blsSign(privKey, signing_root.data)
|
|
|
|
|
2020-07-23 14:38:28 +00:00
|
|
|
proc verify_deposit_signature*(preset: RuntimePreset,
|
2020-07-07 23:02:14 +00:00
|
|
|
deposit: DepositData): bool =
|
2020-06-16 05:45:04 +00:00
|
|
|
let
|
|
|
|
deposit_message = deposit.getDepositMessage()
|
|
|
|
# Fork-agnostic domain since deposits are valid across forks
|
2020-07-07 23:02:14 +00:00
|
|
|
domain = compute_domain(DOMAIN_DEPOSIT, preset.GENESIS_FORK_VERSION)
|
2020-06-16 05:45:04 +00:00
|
|
|
signing_root = compute_signing_root(deposit_message, domain)
|
|
|
|
|
|
|
|
blsVerify(deposit.pubkey, signing_root.data, deposit.signature)
|
|
|
|
|
2020-11-27 19:48:33 +00:00
|
|
|
func get_voluntary_exit_signature*(
|
|
|
|
fork: Fork,
|
|
|
|
genesis_validators_root: Eth2Digest,
|
|
|
|
voluntary_exit: VoluntaryExit,
|
|
|
|
privkey: ValidatorPrivKey): ValidatorSig =
|
|
|
|
let
|
|
|
|
domain = get_domain(
|
|
|
|
fork, DOMAIN_VOLUNTARY_EXIT, voluntary_exit.epoch, genesis_validators_root)
|
|
|
|
signing_root = compute_signing_root(voluntary_exit, domain)
|
|
|
|
|
|
|
|
blsSign(privKey, signing_root.data)
|
|
|
|
|
2020-07-23 14:38:28 +00:00
|
|
|
proc verify_voluntary_exit_signature*(
|
2020-11-27 19:48:33 +00:00
|
|
|
fork: Fork,
|
|
|
|
genesis_validators_root: Eth2Digest,
|
2020-06-16 05:45:04 +00:00
|
|
|
voluntary_exit: VoluntaryExit,
|
2020-11-27 19:48:33 +00:00
|
|
|
pubkey: ValidatorPubKey,
|
|
|
|
signature: SomeSig): bool =
|
2020-06-25 10:23:10 +00:00
|
|
|
withTrust(signature):
|
|
|
|
let
|
|
|
|
domain = get_domain(
|
|
|
|
fork, DOMAIN_VOLUNTARY_EXIT, voluntary_exit.epoch, genesis_validators_root)
|
|
|
|
signing_root = compute_signing_root(voluntary_exit, domain)
|
|
|
|
|
|
|
|
blsVerify(pubkey, signing_root.data, signature)
|