@lodestar/state-transition 1.35.0-dev.e9dd48f165 → 1.35.0-dev.fcf8d024ea

package/src/block/processAttestationsAltair.ts

@@ -0,0 +1,184 @@
+import {byteArrayEquals} from "@chainsafe/ssz";
+import {
+  ForkSeq,
+  MIN_ATTESTATION_INCLUSION_DELAY,
+  PROPOSER_WEIGHT,
+  SLOTS_PER_EPOCH,
+  TIMELY_HEAD_FLAG_INDEX,
+  TIMELY_HEAD_WEIGHT,
+  TIMELY_SOURCE_FLAG_INDEX,
+  TIMELY_SOURCE_WEIGHT,
+  TIMELY_TARGET_FLAG_INDEX,
+  TIMELY_TARGET_WEIGHT,
+  WEIGHT_DENOMINATOR,
+} from "@lodestar/params";
+import {Attestation, Epoch, phase0} from "@lodestar/types";
+import {intSqrt} from "@lodestar/utils";
+import {BeaconStateTransitionMetrics} from "../metrics.js";
+import {getAttestationWithIndicesSignatureSet} from "../signatureSets/indexedAttestation.js";
+import {CachedBeaconStateAltair} from "../types.js";
+import {increaseBalance, verifySignatureSet} from "../util/index.js";
+import {RootCache} from "../util/rootCache.js";
+import {checkpointToStr, isTimelyTarget, validateAttestation} from "./processAttestationPhase0.js";
+
+const PROPOSER_REWARD_DOMINATOR = ((WEIGHT_DENOMINATOR - PROPOSER_WEIGHT) * WEIGHT_DENOMINATOR) / PROPOSER_WEIGHT;
+
+/** Same to https://github.com/ethereum/eth2.0-specs/blob/v1.1.0-alpha.5/specs/altair/beacon-chain.md#has_flag */
+const TIMELY_SOURCE = 1 << TIMELY_SOURCE_FLAG_INDEX;
+const TIMELY_TARGET = 1 << TIMELY_TARGET_FLAG_INDEX;
+const TIMELY_HEAD = 1 << TIMELY_HEAD_FLAG_INDEX;
+const SLOTS_PER_EPOCH_SQRT = intSqrt(SLOTS_PER_EPOCH);
+
+export function processAttestationsAltair(
+  fork: ForkSeq,
+  state: CachedBeaconStateAltair,
+  attestations: Attestation[],
+  verifySignature = true,
+  metrics?: BeaconStateTransitionMetrics | null
+): void {
+  const {epochCtx} = state;
+  const {effectiveBalanceIncrements} = epochCtx;
+  const stateSlot = state.slot;
+  const rootCache = new RootCache(state);
+  const currentEpoch = epochCtx.epoch;
+
+  // Process all attestations first and then increase the balance of the proposer once
+  let proposerReward = 0;
+  let newSeenAttesters = 0;
+  let newSeenAttestersEffectiveBalance = 0;
+  for (const attestation of attestations) {
+    const data = attestation.data;
+
+    validateAttestation(fork, state, attestation);
+
+    // Retrieve the validator indices from the attestation participation bitfield
+    const attestingIndices = epochCtx.getAttestingIndices(fork, attestation);
+
+    // this check is done last because its the most expensive (if signature verification is toggled on)
+    // TODO: Why should we verify an indexed attestation that we just created? If it's just for the signature
+    // we can verify only that and nothing else.
+    if (verifySignature) {
+      const sigSet = getAttestationWithIndicesSignatureSet(state, attestation, attestingIndices);
+      if (!verifySignatureSet(sigSet)) {
+        throw new Error("Attestation signature is not valid");
+      }
+    }
+
+    const inCurrentEpoch = data.target.epoch === currentEpoch;
+    const epochParticipation = inCurrentEpoch ? state.currentEpochParticipation : state.previousEpochParticipation;
+
+    const flagsAttestation = getAttestationParticipationStatus(
+      fork,
+      data,
+      stateSlot - data.slot,
+      epochCtx.epoch,
+      rootCache
+    );
+
+    // For each participant, update their participation
+    // In epoch processing, this participation info is used to calculate balance updates
+    let totalBalanceIncrementsWithWeight = 0;
+    const validators = state.validators;
+    for (const validatorIndex of attestingIndices) {
+      const flags = epochParticipation.get(validatorIndex);
+
+      // For normal block, > 90% of attestations belong to current epoch
+      // At epoch boundary, 100% of attestations belong to previous epoch
+      // so we want to update the participation flag tree in batch
+
+      // Note ParticipationFlags type uses option {setBitwiseOR: true}, .set() does a |= operation
+      epochParticipation.set(validatorIndex, flagsAttestation);
+      // epochParticipation.setStatus(index, newStatus);
+
+      // Returns flags that are NOT set before (~ bitwise NOT) AND are set after
+      const flagsNewSet = ~flags & flagsAttestation;
+      if (flagsNewSet !== 0) {
+        newSeenAttesters++;
+        newSeenAttestersEffectiveBalance += effectiveBalanceIncrements[validatorIndex];
+      }
+
+      // Spec:
+      // baseReward = state.validators[index].effectiveBalance / EFFECTIVE_BALANCE_INCREMENT * baseRewardPerIncrement;
+      // proposerRewardNumerator += baseReward * totalWeight
+      let totalWeight = 0;
+      if ((flagsNewSet & TIMELY_SOURCE) === TIMELY_SOURCE) totalWeight += TIMELY_SOURCE_WEIGHT;
+      if ((flagsNewSet & TIMELY_TARGET) === TIMELY_TARGET) totalWeight += TIMELY_TARGET_WEIGHT;
+      if ((flagsNewSet & TIMELY_HEAD) === TIMELY_HEAD) totalWeight += TIMELY_HEAD_WEIGHT;
+
+      if (totalWeight > 0) {
+        totalBalanceIncrementsWithWeight += effectiveBalanceIncrements[validatorIndex] * totalWeight;
+      }
+
+      // TODO: describe issue. Compute progressive target balances
+      // When processing each attestation, increase the cummulative target balance. Only applies post-altair
+      if ((flagsNewSet & TIMELY_TARGET) === TIMELY_TARGET) {
+        const validator = validators.getReadonly(validatorIndex);
+        if (!validator.slashed) {
+          if (inCurrentEpoch) {
+            epochCtx.currentTargetUnslashedBalanceIncrements += effectiveBalanceIncrements[validatorIndex];
+          } else {
+            epochCtx.previousTargetUnslashedBalanceIncrements += effectiveBalanceIncrements[validatorIndex];
+          }
+        }
+      }
+    }
+
+    // Do the discrete math inside the loop to ensure a deterministic result
+    const totalIncrements = totalBalanceIncrementsWithWeight;
+    const proposerRewardNumerator = totalIncrements * state.epochCtx.baseRewardPerIncrement;
+    proposerReward += Math.floor(proposerRewardNumerator / PROPOSER_REWARD_DOMINATOR);
+  }
+
+  metrics?.newSeenAttestersPerBlock.set(newSeenAttesters);
+  metrics?.newSeenAttestersEffectiveBalancePerBlock.set(newSeenAttestersEffectiveBalance);
+  metrics?.attestationsPerBlock.set(attestations.length);
+
+  increaseBalance(state, epochCtx.getBeaconProposer(state.slot), proposerReward);
+  state.proposerRewards.attestations = proposerReward;
+}
+
+/**
+ * https://github.com/ethereum/consensus-specs/blob/v1.1.10/specs/altair/beacon-chain.md#get_attestation_participation_flag_indices
+ */
+export function getAttestationParticipationStatus(
+  fork: ForkSeq,
+  data: phase0.AttestationData,
+  inclusionDelay: number,
+  currentEpoch: Epoch,
+  rootCache: RootCache
+): number {
+  const justifiedCheckpoint =
+    data.target.epoch === currentEpoch ? rootCache.currentJustifiedCheckpoint : rootCache.previousJustifiedCheckpoint;
+
+  // The source and target votes are part of the FFG vote, the head vote is part of the fork choice vote
+  // Both are tracked to properly incentivise validators
+  //
+  // The source vote always matches the justified checkpoint (else its invalid)
+  // The target vote should match the most recent checkpoint (eg: the first root of the epoch)
+  // The head vote should match the root at the attestation slot (eg: the root at data.slot)
+  const isMatchingSource = checkpointValueEquals(data.source, justifiedCheckpoint);
+  if (!isMatchingSource) {
+    throw new Error(
+      `Attestation source does not equal justified checkpoint: source=${checkpointToStr(
+        data.source
+      )} justifiedCheckpoint=${checkpointToStr(justifiedCheckpoint)}`
+    );
+  }
+
+  const isMatchingTarget = byteArrayEquals(data.target.root, rootCache.getBlockRoot(data.target.epoch));
+
+  // a timely head is only be set if the target is _also_ matching
+  const isMatchingHead =
+    isMatchingTarget && byteArrayEquals(data.beaconBlockRoot, rootCache.getBlockRootAtSlot(data.slot));
+
+  let flags = 0;
+  if (isMatchingSource && inclusionDelay <= SLOTS_PER_EPOCH_SQRT) flags |= TIMELY_SOURCE;
+  if (isMatchingTarget && isTimelyTarget(fork, inclusionDelay)) flags |= TIMELY_TARGET;
+  if (isMatchingHead && inclusionDelay === MIN_ATTESTATION_INCLUSION_DELAY) flags |= TIMELY_HEAD;
+
+  return flags;
+}
+
+export function checkpointValueEquals(cp1: phase0.Checkpoint, cp2: phase0.Checkpoint): boolean {
+  return cp1.epoch === cp2.epoch && byteArrayEquals(cp1.root, cp2.root);
+}

package/src/block/processAttesterSlashing.ts

@@ -0,0 +1,59 @@
+import {ForkSeq} from "@lodestar/params";
+import {AttesterSlashing} from "@lodestar/types";
+import {CachedBeaconStateAllForks} from "../types.js";
+import {getAttesterSlashableIndices, isSlashableAttestationData, isSlashableValidator} from "../util/index.js";
+import {isValidIndexedAttestationBigint} from "./isValidIndexedAttestation.js";
+import {slashValidator} from "./slashValidator.js";
+
+/**
+ * Process an AttesterSlashing operation. Initiates the exit of a validator, decreases the balance of the slashed
+ * validators and increases the block proposer balance.
+ *
+ * PERF: Work depends on number of AttesterSlashing per block. On regular networks the average is 0 / block.
+ */
+export function processAttesterSlashing(
+  fork: ForkSeq,
+  state: CachedBeaconStateAllForks,
+  attesterSlashing: AttesterSlashing,
+  verifySignatures = true
+): void {
+  assertValidAttesterSlashing(state, attesterSlashing, verifySignatures);
+
+  const intersectingIndices = getAttesterSlashableIndices(attesterSlashing);
+
+  let slashedAny = false;
+  const validators = state.validators; // Get the validators sub tree once for all indices
+  // Spec requires to sort indexes beforehand
+  for (const index of intersectingIndices.sort((a, b) => a - b)) {
+    if (isSlashableValidator(validators.getReadonly(index), state.epochCtx.epoch)) {
+      slashValidator(fork, state, index);
+      slashedAny = true;
+    }
+  }
+
+  if (!slashedAny) {
+    throw new Error("AttesterSlashing did not result in any slashings");
+  }
+}
+
+export function assertValidAttesterSlashing(
+  state: CachedBeaconStateAllForks,
+  attesterSlashing: AttesterSlashing,
+  verifySignatures = true
+): void {
+  const attestation1 = attesterSlashing.attestation1;
+  const attestation2 = attesterSlashing.attestation2;
+
+  if (!isSlashableAttestationData(attestation1.data, attestation2.data)) {
+    throw new Error("AttesterSlashing is not slashable");
+  }
+
+  // In state transition, AttesterSlashing attestations are only partially validated. Their slot and epoch could
+  // be higher than the clock and the slashing would still be valid. Same applies to attestation data index, which
+  // can be any arbitrary value. Must use bigint variants to hash correctly to all possible values
+  for (const [i, attestation] of [attestation1, attestation2].entries()) {
+    if (!isValidIndexedAttestationBigint(state, attestation, verifySignatures)) {
+      throw new Error(`AttesterSlashing attestation${i} is invalid`);
+    }
+  }
+}

package/src/block/processBlobKzgCommitments.ts

@@ -0,0 +1,21 @@
+import {BlockExternalData, ExecutionPayloadStatus} from "./externalData.js";
+
+/**
+ * https://github.com/ethereum/consensus-specs/blob/11a037fd9227e29ee809c9397b09f8cc3383a8c0/specs/eip4844/beacon-chain.md#blob-kzg-commitments
+ *
+ * def process_blob_kzg_commitments(state: BeaconState, body: BeaconBlockBody):
+ *   assert verify_kzg_commitments_against_transactions(
+ *     body.execution_payload.transactions,
+ *     body.blob_kzg_commitments
+ *   )
+ */
+export function processBlobKzgCommitments(externalData: BlockExternalData): void {
+  switch (externalData.executionPayloadStatus) {
+    case ExecutionPayloadStatus.preMerge:
+      throw Error("executionPayloadStatus preMerge");
+    case ExecutionPayloadStatus.invalid:
+      throw Error("Invalid execution payload");
+    case ExecutionPayloadStatus.valid:
+      break; // ok
+  }
+}

package/src/block/processBlockHeader.ts

@@ -0,0 +1,54 @@
+import {byteArrayEquals} from "@chainsafe/ssz";
+import {BeaconBlock, BlindedBeaconBlock, ssz} from "@lodestar/types";
+import {toRootHex} from "@lodestar/utils";
+import {ZERO_HASH} from "../constants/index.js";
+import {CachedBeaconStateAllForks} from "../types.js";
+import {blindedOrFullBlockToHeader} from "../util/index.js";
+/**
+ * Converts a Deposit record (created by the eth-execution deposit contract) into a Validator object that goes into the eth-consensus state.
+ *
+ * PERF: Fixed work independent of block contents.
+ * NOTE: `block` body root MUST be pre-cached.
+ */
+export function processBlockHeader(state: CachedBeaconStateAllForks, block: BeaconBlock | BlindedBeaconBlock): void {
+  const slot = state.slot;
+  // verify that the slots match
+  if (block.slot !== slot) {
+    throw new Error(`Block slot does not match state slot blockSlot=${block.slot} stateSlot=${slot}`);
+  }
+  // Verify that the block is newer than latest block header
+  if (!(block.slot > state.latestBlockHeader.slot)) {
+    throw new Error(
+      `Block is not newer than latest block header blockSlot=${block.slot} latestBlockHeader.slot=${state.latestBlockHeader.slot}`
+    );
+  }
+  // verify that proposer index is the correct index
+  const proposerIndex = state.epochCtx.getBeaconProposer(slot);
+  if (block.proposerIndex !== proposerIndex) {
+    throw new Error(
+      `Block proposer index does not match state proposer index blockProposerIndex=${block.proposerIndex} stateProposerIndex=${proposerIndex}`
+    );
+  }
+
+  // verify that the parent matches
+  if (!byteArrayEquals(block.parentRoot, ssz.phase0.BeaconBlockHeader.hashTreeRoot(state.latestBlockHeader))) {
+    throw new Error(
+      `Block parent root ${toRootHex(block.parentRoot)} does not match state latest block, block slot=${slot}`
+    );
+  }
+
+  const blockHeader = blindedOrFullBlockToHeader(state.config, block);
+  // cache current block as the new latest block
+  state.latestBlockHeader = ssz.phase0.BeaconBlockHeader.toViewDU({
+    slot,
+    proposerIndex,
+    parentRoot: block.parentRoot,
+    stateRoot: ZERO_HASH,
+    bodyRoot: blockHeader.bodyRoot,
+  });
+
+  // verify proposer is not slashed. Only once per block, may use the slower read from tree
+  if (state.validators.getReadonly(proposerIndex).slashed) {
+    throw new Error("Block proposer is slashed");
+  }
+}

package/src/block/processBlsToExecutionChange.ts

@@ -0,0 +1,78 @@
+import {digest} from "@chainsafe/as-sha256";
+import {byteArrayEquals} from "@chainsafe/ssz";
+import {BLS_WITHDRAWAL_PREFIX, ETH1_ADDRESS_WITHDRAWAL_PREFIX} from "@lodestar/params";
+import {capella} from "@lodestar/types";
+import {toHex} from "@lodestar/utils";
+import {verifyBlsToExecutionChangeSignature} from "../signatureSets/index.js";
+import {CachedBeaconStateCapella} from "../types.js";
+
+export function processBlsToExecutionChange(
+  state: CachedBeaconStateCapella,
+  signedBlsToExecutionChange: capella.SignedBLSToExecutionChange
+): void {
+  const addressChange = signedBlsToExecutionChange.message;
+
+  const validation = isValidBlsToExecutionChange(state, signedBlsToExecutionChange, true);
+  if (!validation.valid) {
+    throw validation.error;
+  }
+
+  const validator = state.validators.get(addressChange.validatorIndex);
+  const newWithdrawalCredentials = new Uint8Array(32);
+  newWithdrawalCredentials[0] = ETH1_ADDRESS_WITHDRAWAL_PREFIX;
+  newWithdrawalCredentials.set(addressChange.toExecutionAddress, 12);
+
+  // Set the new credentials back
+  validator.withdrawalCredentials = newWithdrawalCredentials;
+}
+
+export function isValidBlsToExecutionChange(
+  state: CachedBeaconStateCapella,
+  signedBLSToExecutionChange: capella.SignedBLSToExecutionChange,
+  verifySignature = true
+): {valid: true} | {valid: false; error: Error} {
+  const addressChange = signedBLSToExecutionChange.message;
+
+  if (addressChange.validatorIndex >= state.validators.length) {
+    return {
+      valid: false,
+      error: Error(
+        `withdrawalValidatorIndex ${addressChange.validatorIndex} > state.validators len ${state.validators.length}`
+      ),
+    };
+  }
+
+  const validator = state.validators.getReadonly(addressChange.validatorIndex);
+  const {withdrawalCredentials} = validator;
+  if (withdrawalCredentials[0] !== BLS_WITHDRAWAL_PREFIX) {
+    return {
+      valid: false,
+      error: Error(
+        `Invalid withdrawalCredentials prefix expected=${BLS_WITHDRAWAL_PREFIX} actual=${withdrawalCredentials[0]}`
+      ),
+    };
+  }
+
+  const digestCredentials = digest(addressChange.fromBlsPubkey);
+  // Set the BLS_WITHDRAWAL_PREFIX on the digestCredentials for direct match
+  digestCredentials[0] = BLS_WITHDRAWAL_PREFIX;
+  if (!byteArrayEquals(withdrawalCredentials, digestCredentials)) {
+    return {
+      valid: false,
+      error: Error(
+        `Invalid withdrawalCredentials expected=${toHex(withdrawalCredentials)} actual=${toHex(digestCredentials)}`
+      ),
+    };
+  }
+
+  if (verifySignature && !verifyBlsToExecutionChangeSignature(state, signedBLSToExecutionChange)) {
+    return {
+      valid: false,
+      error: Error(
+        `Signature could not be verified for BLS to Execution Change for validatorIndex${addressChange.validatorIndex}`
+      ),
+    };
+  }
+
+  return {valid: true};
+}

package/src/block/processConsolidationRequest.ts

@@ -0,0 +1,147 @@
+import {FAR_FUTURE_EPOCH, MIN_ACTIVATION_BALANCE, PENDING_CONSOLIDATIONS_LIMIT} from "@lodestar/params";
+import {electra, ssz} from "@lodestar/types";
+import {CachedBeaconStateElectra} from "../types.js";
+import {hasEth1WithdrawalCredential} from "../util/capella.js";
+import {
+  hasCompoundingWithdrawalCredential,
+  hasExecutionWithdrawalCredential,
+  isPubkeyKnown,
+  switchToCompoundingValidator,
+} from "../util/electra.js";
+import {computeConsolidationEpochAndUpdateChurn} from "../util/epoch.js";
+import {getConsolidationChurnLimit, getPendingBalanceToWithdraw, isActiveValidator} from "../util/validator.js";
+
+// TODO Electra: Clean up necessary as there is a lot of overlap with isValidSwitchToCompoundRequest
+export function processConsolidationRequest(
+  state: CachedBeaconStateElectra,
+  consolidationRequest: electra.ConsolidationRequest
+): void {
+  const {sourcePubkey, targetPubkey, sourceAddress} = consolidationRequest;
+  if (!isPubkeyKnown(state, sourcePubkey) || !isPubkeyKnown(state, targetPubkey)) {
+    return;
+  }
+
+  const sourceIndex = state.epochCtx.getValidatorIndex(sourcePubkey);
+  const targetIndex = state.epochCtx.getValidatorIndex(targetPubkey);
+
+  if (sourceIndex === null || targetIndex === null) {
+    return;
+  }
+
+  if (isValidSwitchToCompoundRequest(state, consolidationRequest)) {
+    switchToCompoundingValidator(state, sourceIndex);
+    // Early return since we have already switched validator to compounding
+    return;
+  }
+
+  // Verify that source != target, so a consolidation cannot be used as an exit.
+  if (sourceIndex === targetIndex) {
+    return;
+  }
+
+  // If the pending consolidations queue is full, consolidation requests are ignored
+  if (state.pendingConsolidations.length >= PENDING_CONSOLIDATIONS_LIMIT) {
+    return;
+  }
+
+  // If there is too little available consolidation churn limit, consolidation requests are ignored
+  if (getConsolidationChurnLimit(state.epochCtx) <= MIN_ACTIVATION_BALANCE) {
+    return;
+  }
+
+  const sourceValidator = state.validators.get(sourceIndex);
+  const targetValidator = state.validators.getReadonly(targetIndex);
+  const sourceWithdrawalAddress = sourceValidator.withdrawalCredentials.subarray(12);
+  const currentEpoch = state.epochCtx.epoch;
+
+  // Verify source withdrawal credentials
+  const hasCorrectCredential = hasExecutionWithdrawalCredential(sourceValidator.withdrawalCredentials);
+  const isCorrectSourceAddress = Buffer.compare(sourceWithdrawalAddress, sourceAddress) === 0;
+  if (!(hasCorrectCredential && isCorrectSourceAddress)) {
+    return;
+  }
+
+  // Verify that target has compounding withdrawal credentials
+  if (!hasCompoundingWithdrawalCredential(targetValidator.withdrawalCredentials)) {
+    return;
+  }
+
+  // Verify the source and the target are active
+  if (!isActiveValidator(sourceValidator, currentEpoch) || !isActiveValidator(targetValidator, currentEpoch)) {
+    return;
+  }
+
+  // Verify exits for source and target have not been initiated
+  if (sourceValidator.exitEpoch !== FAR_FUTURE_EPOCH || targetValidator.exitEpoch !== FAR_FUTURE_EPOCH) {
+    return;
+  }
+
+  // Verify the source has been active long enough
+  if (currentEpoch < sourceValidator.activationEpoch + state.config.SHARD_COMMITTEE_PERIOD) {
+    return;
+  }
+
+  // Verify the source has no pending withdrawals in the queue
+  if (getPendingBalanceToWithdraw(state, sourceIndex) > 0) {
+    return;
+  }
+
+  // Initiate source validator exit and append pending consolidation
+  // TODO Electra: See if we can get rid of big int
+  const exitEpoch = computeConsolidationEpochAndUpdateChurn(state, BigInt(sourceValidator.effectiveBalance));
+  sourceValidator.exitEpoch = exitEpoch;
+  sourceValidator.withdrawableEpoch = exitEpoch + state.config.MIN_VALIDATOR_WITHDRAWABILITY_DELAY;
+
+  const pendingConsolidation = ssz.electra.PendingConsolidation.toViewDU({
+    sourceIndex,
+    targetIndex,
+  });
+  state.pendingConsolidations.push(pendingConsolidation);
+}
+
+/**
+ * Determine if we should set consolidation target validator to compounding credential
+ */
+function isValidSwitchToCompoundRequest(
+  state: CachedBeaconStateElectra,
+  consolidationRequest: electra.ConsolidationRequest
+): boolean {
+  const {sourcePubkey, targetPubkey, sourceAddress} = consolidationRequest;
+  const sourceIndex = state.epochCtx.getValidatorIndex(sourcePubkey);
+  const targetIndex = state.epochCtx.getValidatorIndex(targetPubkey);
+
+  // Verify pubkey exists
+  if (sourceIndex === null) {
+    // this check is mainly to make the compiler happy, pubkey is checked by the consumer already
+    return false;
+  }
+
+  // Switch to compounding requires source and target be equal
+  if (sourceIndex !== targetIndex) {
+    return false;
+  }
+
+  const sourceValidator = state.validators.getReadonly(sourceIndex);
+  const sourceWithdrawalAddress = sourceValidator.withdrawalCredentials.subarray(12);
+  // Verify request has been authorized
+  if (Buffer.compare(sourceWithdrawalAddress, sourceAddress) !== 0) {
+    return false;
+  }
+
+  // Verify source withdrawal credentials
+  if (!hasEth1WithdrawalCredential(sourceValidator.withdrawalCredentials)) {
+    return false;
+  }
+
+  // Verify the source is active
+  if (!isActiveValidator(sourceValidator, state.epochCtx.epoch)) {
+    return false;
+  }
+
+  // Verify exit for source has not been initiated
+  if (sourceValidator.exitEpoch !== FAR_FUTURE_EPOCH) {
+    return false;
+  }
+
+  return true;
+}