Bump all spec tags to v0.12.1 (#1275)

2026-03-03 00:31:50 +00:00 · 2020-06-19 11:18:27 +10:00
parent 9450a0f30d
commit 305724770d
65 changed files with 224 additions and 224 deletions
--- a/consensus/state_processing/src/common/get_attesting_indices.rs
+++ b/consensus/state_processing/src/common/get_attesting_indices.rs
@@ -2,7 +2,7 @@ use types::*;

 /// Returns validator indices which participated in the attestation, sorted by increasing index.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn get_attesting_indices<T: EthSpec>(
    committee: &[usize],
    bitlist: &BitList<T::MaxValidatorsPerCommittee>,
--- a/consensus/state_processing/src/common/get_base_reward.rs
+++ b/consensus/state_processing/src/common/get_base_reward.rs
@@ -4,7 +4,7 @@ use types::*;

 /// Returns the base reward for some validator.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn get_base_reward<T: EthSpec>(
    state: &BeaconState<T>,
    index: usize,
--- a/consensus/state_processing/src/common/get_indexed_attestation.rs
+++ b/consensus/state_processing/src/common/get_indexed_attestation.rs
@@ -6,7 +6,7 @@ type Result<T> = std::result::Result<T, BlockOperationError<Invalid>>;

 /// Convert `attestation` to (almost) indexed-verifiable form.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn get_indexed_attestation<T: EthSpec>(
    committee: &[usize],
    attestation: &Attestation<T>,
--- a/consensus/state_processing/src/common/initiate_validator_exit.rs
+++ b/consensus/state_processing/src/common/initiate_validator_exit.rs
@@ -3,7 +3,7 @@ use types::{BeaconStateError as Error, *};

 /// Initiate the exit of the validator of the given `index`.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn initiate_validator_exit<T: EthSpec>(
    state: &mut BeaconState<T>,
    index: usize,
--- a/consensus/state_processing/src/common/mod.rs
+++ b/consensus/state_processing/src/common/mod.rs
@@ -17,7 +17,7 @@ use types::{BeaconState, EthSpec};

 /// Increase the balance of a validator, erroring upon overflow, as per the spec.
 ///
-/// Spec v0.11.2
+/// Spec v0.12.1
 pub fn increase_balance<E: EthSpec>(
    state: &mut BeaconState<E>,
    index: usize,
@@ -28,7 +28,7 @@ pub fn increase_balance<E: EthSpec>(

 /// Decrease the balance of a validator, saturating upon overflow, as per the spec.
 ///
-/// Spec v0.11.2
+/// Spec v0.12.1
 pub fn decrease_balance<E: EthSpec>(state: &mut BeaconState<E>, index: usize, delta: u64) {
    state.balances[index] = state.balances[index].saturating_sub(delta);
 }
--- a/consensus/state_processing/src/common/slash_validator.rs
+++ b/consensus/state_processing/src/common/slash_validator.rs
@@ -5,7 +5,7 @@ use types::{BeaconStateError as Error, *};

 /// Slash the validator with index ``index``.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn slash_validator<T: EthSpec>(
    state: &mut BeaconState<T>,
    slashed_index: usize,
--- a/consensus/state_processing/src/genesis.rs
+++ b/consensus/state_processing/src/genesis.rs
@@ -7,7 +7,7 @@ use types::*;

 /// Initialize a `BeaconState` from genesis data.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 // TODO: this is quite inefficient and we probably want to rethink how we do this
 pub fn initialize_beacon_state_from_eth1<T: EthSpec>(
    eth1_block_hash: Hash256,
@@ -50,7 +50,7 @@ pub fn initialize_beacon_state_from_eth1<T: EthSpec>(

 /// Determine whether a candidate genesis state is suitable for starting the chain.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn is_valid_genesis_state<T: EthSpec>(state: &BeaconState<T>, spec: &ChainSpec) -> bool {
    state.genesis_time >= spec.min_genesis_time
        && state.get_active_validator_indices(T::genesis_epoch()).len() as u64
@@ -59,7 +59,7 @@ pub fn is_valid_genesis_state<T: EthSpec>(state: &BeaconState<T>, spec: &ChainSp

 /// Activate genesis validators, if their balance is acceptable.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn process_activations<T: EthSpec>(
    state: &mut BeaconState<T>,
    spec: &ChainSpec,
@@ -82,7 +82,7 @@ pub fn process_activations<T: EthSpec>(
 ///
 /// Does _not_ ensure that the time is greater than `MIN_GENESIS_TIME`.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn eth2_genesis_time(eth1_timestamp: u64, spec: &ChainSpec) -> Result<u64, ArithError> {
    eth1_timestamp.safe_add(spec.genesis_delay)
 }
--- a/consensus/state_processing/src/per_block_processing.rs
+++ b/consensus/state_processing/src/per_block_processing.rs
@@ -76,7 +76,7 @@ impl VerifySignatures {
 /// tree hash root of the block, NOT the signing root of the block. This function takes
 /// care of mixing in the domain.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn per_block_processing<T: EthSpec>(
    mut state: &mut BeaconState<T>,
    signed_block: &SignedBeaconBlock<T>,
@@ -148,7 +148,7 @@ pub fn per_block_processing<T: EthSpec>(

 /// Processes the block header.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn process_block_header<T: EthSpec>(
    state: &mut BeaconState<T>,
    block: &BeaconBlock<T>,
@@ -200,7 +200,7 @@ pub fn process_block_header<T: EthSpec>(

 /// Verifies the signature of a block.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn verify_block_signature<T: EthSpec>(
    state: &BeaconState<T>,
    block: &SignedBeaconBlock<T>,
@@ -225,7 +225,7 @@ pub fn verify_block_signature<T: EthSpec>(
 /// Verifies the `randao_reveal` against the block's proposer pubkey and updates
 /// `state.latest_randao_mixes`.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn process_randao<T: EthSpec>(
    state: &mut BeaconState<T>,
    block: &BeaconBlock<T>,
@@ -249,7 +249,7 @@ pub fn process_randao<T: EthSpec>(

 /// Update the `state.eth1_data_votes` based upon the `eth1_data` provided.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn process_eth1_data<T: EthSpec>(
    state: &mut BeaconState<T>,
    eth1_data: &Eth1Data,
@@ -266,7 +266,7 @@ pub fn process_eth1_data<T: EthSpec>(
 /// Returns `Ok(Some(eth1_data))` if adding the given `eth1_data` to `state.eth1_data_votes` would
 /// result in a change to `state.eth1_data`.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn get_new_eth1_data<T: EthSpec>(
    state: &BeaconState<T>,
    eth1_data: &Eth1Data,
@@ -290,7 +290,7 @@ pub fn get_new_eth1_data<T: EthSpec>(
 /// Returns `Ok(())` if the validation and state updates completed successfully, otherwise returns
 /// an `Err` describing the invalid object or cause of failure.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn process_proposer_slashings<T: EthSpec>(
    state: &mut BeaconState<T>,
    proposer_slashings: &[ProposerSlashing],
@@ -323,7 +323,7 @@ pub fn process_proposer_slashings<T: EthSpec>(
 /// Returns `Ok(())` if the validation and state updates completed successfully, otherwise returns
 /// an `Err` describing the invalid object or cause of failure.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn process_attester_slashings<T: EthSpec>(
    state: &mut BeaconState<T>,
    attester_slashings: &[AttesterSlashing<T>],
@@ -350,7 +350,7 @@ pub fn process_attester_slashings<T: EthSpec>(
 /// Returns `Ok(())` if the validation and state updates completed successfully, otherwise returns
 /// an `Err` describing the invalid object or cause of failure.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn process_attestations<T: EthSpec>(
    state: &mut BeaconState<T>,
    attestations: &[Attestation<T>],
@@ -391,7 +391,7 @@ pub fn process_attestations<T: EthSpec>(
 /// Returns `Ok(())` if the validation and state updates completed successfully, otherwise returns
 /// an `Err` describing the invalid object or cause of failure.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn process_deposits<T: EthSpec>(
    state: &mut BeaconState<T>,
    deposits: &[Deposit],
@@ -433,7 +433,7 @@ pub fn process_deposits<T: EthSpec>(

 /// Process a single deposit, optionally verifying its merkle proof.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn process_deposit<T: EthSpec>(
    state: &mut BeaconState<T>,
    deposit: &Deposit,
@@ -499,7 +499,7 @@ pub fn process_deposit<T: EthSpec>(
 /// Returns `Ok(())` if the validation and state updates completed successfully, otherwise returns
 /// an `Err` describing the invalid object or cause of failure.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn process_exits<T: EthSpec>(
    state: &mut BeaconState<T>,
    voluntary_exits: &[SignedVoluntaryExit],
--- a/consensus/state_processing/src/per_block_processing/is_valid_indexed_attestation.rs
+++ b/consensus/state_processing/src/per_block_processing/is_valid_indexed_attestation.rs
@@ -11,7 +11,7 @@ fn error(reason: Invalid) -> BlockOperationError<Invalid> {

 /// Verify an `IndexedAttestation`.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn is_valid_indexed_attestation<T: EthSpec>(
    state: &BeaconState<T>,
    indexed_attestation: &IndexedAttestation<T>,
--- a/consensus/state_processing/src/per_block_processing/verify_attestation.rs
+++ b/consensus/state_processing/src/per_block_processing/verify_attestation.rs
@@ -15,7 +15,7 @@ fn error(reason: Invalid) -> BlockOperationError<Invalid> {
 ///
 /// Optionally verifies the aggregate signature, depending on `verify_signatures`.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn verify_attestation_for_block_inclusion<T: EthSpec>(
    state: &BeaconState<T>,
    attestation: &Attestation<T>,
@@ -49,7 +49,7 @@ pub fn verify_attestation_for_block_inclusion<T: EthSpec>(
 /// Returns a descriptive `Err` if the attestation is malformed or does not accurately reflect the
 /// prior blocks in `state`.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn verify_attestation_for_state<T: EthSpec>(
    state: &BeaconState<T>,
    attestation: &Attestation<T>,
@@ -76,7 +76,7 @@ pub fn verify_attestation_for_state<T: EthSpec>(

 /// Check target epoch and source checkpoint.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 fn verify_casper_ffg_vote<T: EthSpec>(
    attestation: &Attestation<T>,
    state: &BeaconState<T>,
--- a/consensus/state_processing/src/per_block_processing/verify_attester_slashing.rs
+++ b/consensus/state_processing/src/per_block_processing/verify_attester_slashing.rs
@@ -16,7 +16,7 @@ fn error(reason: Invalid) -> BlockOperationError<Invalid> {
 /// Returns `Ok(())` if the `AttesterSlashing` is valid, otherwise indicates the reason for
 /// invalidity.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn verify_attester_slashing<T: EthSpec>(
    state: &BeaconState<T>,
    attester_slashing: &AttesterSlashing<T>,
@@ -45,7 +45,7 @@ pub fn verify_attester_slashing<T: EthSpec>(
 ///
 /// Returns Ok(indices) if `indices.len() > 0`.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn get_slashable_indices<T: EthSpec>(
    state: &BeaconState<T>,
    attester_slashing: &AttesterSlashing<T>,
--- a/consensus/state_processing/src/per_block_processing/verify_deposit.rs
+++ b/consensus/state_processing/src/per_block_processing/verify_deposit.rs
@@ -15,7 +15,7 @@ fn error(reason: DepositInvalid) -> BlockOperationError<DepositInvalid> {

 /// Verify `Deposit.pubkey` signed `Deposit.signature`.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn verify_deposit_signature(deposit_data: &DepositData, spec: &ChainSpec) -> Result<()> {
    let deposit_signature_message = deposit_pubkey_signature_message(&deposit_data, spec)
        .ok_or_else(|| error(DepositInvalid::BadBlsBytes))?;
@@ -47,7 +47,7 @@ pub fn get_existing_validator_index<T: EthSpec>(
 /// The deposit index is provided as a parameter so we can check proofs
 /// before they're due to be processed, and in parallel.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn verify_deposit_merkle_proof<T: EthSpec>(
    state: &BeaconState<T>,
    deposit: &Deposit,
--- a/consensus/state_processing/src/per_block_processing/verify_exit.rs
+++ b/consensus/state_processing/src/per_block_processing/verify_exit.rs
@@ -16,7 +16,7 @@ fn error(reason: ExitInvalid) -> BlockOperationError<ExitInvalid> {
 ///
 /// Returns `Ok(())` if the `Exit` is valid, otherwise indicates the reason for invalidity.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn verify_exit<T: EthSpec>(
    state: &BeaconState<T>,
    exit: &SignedVoluntaryExit,
@@ -28,7 +28,7 @@ pub fn verify_exit<T: EthSpec>(

 /// Like `verify_exit` but doesn't run checks which may become true in future states.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn verify_exit_time_independent_only<T: EthSpec>(
    state: &BeaconState<T>,
    exit: &SignedVoluntaryExit,
@@ -40,7 +40,7 @@ pub fn verify_exit_time_independent_only<T: EthSpec>(

 /// Parametric version of `verify_exit` that skips some checks if `time_independent_only` is true.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 fn verify_exit_parametric<T: EthSpec>(
    state: &BeaconState<T>,
    signed_exit: &SignedVoluntaryExit,
--- a/consensus/state_processing/src/per_block_processing/verify_proposer_slashing.rs
+++ b/consensus/state_processing/src/per_block_processing/verify_proposer_slashing.rs
@@ -14,7 +14,7 @@ fn error(reason: Invalid) -> BlockOperationError<Invalid> {
 ///
 /// Returns `Ok(())` if the `ProposerSlashing` is valid, otherwise indicates the reason for invalidity.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn verify_proposer_slashing<T: EthSpec>(
    proposer_slashing: &ProposerSlashing,
    state: &BeaconState<T>,
--- a/consensus/state_processing/src/per_epoch_processing.rs
+++ b/consensus/state_processing/src/per_epoch_processing.rs
@@ -25,7 +25,7 @@ pub struct EpochProcessingSummary {
 /// Mutates the given `BeaconState`, returning early if an error is encountered. If an error is
 /// returned, a state might be "half-processed" and therefore in an invalid state.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn per_epoch_processing<T: EthSpec>(
    state: &mut BeaconState<T>,
    spec: &ChainSpec,
@@ -78,7 +78,7 @@ pub fn per_epoch_processing<T: EthSpec>(
 /// - `finalized_epoch`
 /// - `finalized_root`
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 #[allow(clippy::if_same_then_else)] // For readability and consistency with spec.
 pub fn process_justification_and_finalization<T: EthSpec>(
    state: &mut BeaconState<T>,
@@ -154,7 +154,7 @@ pub fn process_justification_and_finalization<T: EthSpec>(

 /// Finish up an epoch update.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn process_final_updates<T: EthSpec>(
    state: &mut BeaconState<T>,
    spec: &ChainSpec,
--- a/consensus/state_processing/src/per_epoch_processing/apply_rewards.rs
+++ b/consensus/state_processing/src/per_epoch_processing/apply_rewards.rs
@@ -34,7 +34,7 @@ impl Delta {

 /// Apply attester and proposer rewards.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn process_rewards_and_penalties<T: EthSpec>(
    state: &mut BeaconState<T>,
    validator_statuses: &mut ValidatorStatuses,
@@ -65,7 +65,7 @@ pub fn process_rewards_and_penalties<T: EthSpec>(

 /// Apply rewards for participation in attestations during the previous epoch.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 fn get_attestation_deltas<T: EthSpec>(
    state: &BeaconState<T>,
    validator_statuses: &ValidatorStatuses,
@@ -269,7 +269,7 @@ fn get_proposer_reward(base_reward: u64, spec: &ChainSpec) -> Result<u64, Error>

 /// Is the validator eligible for penalties and rewards at the current epoch?
 ///
-/// Spec: v0.12.0
+/// Spec: v0.12.1
 fn is_eligible_validator(validator: &ValidatorStatus) -> bool {
    validator.is_active_in_previous_epoch
        || (validator.is_slashed && !validator.is_withdrawable_in_current_epoch)
--- a/consensus/state_processing/src/per_epoch_processing/process_slashings.rs
+++ b/consensus/state_processing/src/per_epoch_processing/process_slashings.rs
@@ -3,7 +3,7 @@ use types::{BeaconStateError as Error, *};

 /// Process slashings.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn process_slashings<T: EthSpec>(
    state: &mut BeaconState<T>,
    total_balance: u64,
--- a/consensus/state_processing/src/per_epoch_processing/registry_updates.rs
+++ b/consensus/state_processing/src/per_epoch_processing/registry_updates.rs
@@ -5,7 +5,7 @@ use types::*;

 /// Performs a validator registry update, if required.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn process_registry_updates<T: EthSpec>(
    state: &mut BeaconState<T>,
    spec: &ChainSpec,
--- a/consensus/state_processing/src/per_epoch_processing/validator_statuses.rs
+++ b/consensus/state_processing/src/per_epoch_processing/validator_statuses.rs
@@ -187,7 +187,7 @@ impl ValidatorStatuses {
    /// - Active validators
    /// - Total balances for the current and previous epochs.
    ///
-    /// Spec v0.11.1
+    /// Spec v0.12.1
    pub fn new<T: EthSpec>(
        state: &BeaconState<T>,
        spec: &ChainSpec,
@@ -231,7 +231,7 @@ impl ValidatorStatuses {
    /// Process some attestations from the given `state` updating the `statuses` and
    /// `total_balances` fields.
    ///
-    /// Spec v0.11.1
+    /// Spec v0.12.1
    pub fn process_attestations<T: EthSpec>(
        &mut self,
        state: &BeaconState<T>,
@@ -322,7 +322,7 @@ impl ValidatorStatuses {
 /// Returns `true` if the attestation's FFG target is equal to the hash of the `state`'s first
 /// beacon block in the given `epoch`.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 fn target_matches_epoch_start_block<T: EthSpec>(
    a: &PendingAttestation<T>,
    state: &BeaconState<T>,
@@ -337,7 +337,7 @@ fn target_matches_epoch_start_block<T: EthSpec>(
 /// Returns `true` if a `PendingAttestation` and `BeaconState` share the same beacon block hash for
 /// the current slot of the `PendingAttestation`.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 fn has_common_beacon_block_root<T: EthSpec>(
    a: &PendingAttestation<T>,
    state: &BeaconState<T>,
--- a/consensus/state_processing/src/per_slot_processing.rs
+++ b/consensus/state_processing/src/per_slot_processing.rs
@@ -13,7 +13,7 @@ pub enum Error {
 /// `state_root` is `None`, the root of `state` will be computed using a cached tree hash.
 /// Providing the `state_root` makes this function several orders of magniude faster.
 ///
-/// Spec v0.11.1
+/// Spec v0.12.1
 pub fn per_slot_processing<T: EthSpec>(
    state: &mut BeaconState<T>,
    state_root: Option<Hash256>,