@lodestar/beacon-node 1.30.0-dev.dd729f5ece → 1.30.0-peerDAS.490e786a03

package/lib/chain/validation/dataColumnSidecar.d.ts

@@ -0,0 +1,28 @@
+import { Root, Slot, SubnetID, deneb, fulu } from "@lodestar/types";
+import { Metrics } from "../../metrics/metrics.js";
+import { IBeaconChain } from "../interface.js";
+export declare function validateGossipDataColumnSidecar(chain: IBeaconChain, dataColumnSidecar: fulu.DataColumnSidecar, gossipSubnet: SubnetID): Promise<void>;
+export declare function validateDataColumnsSidecars(blockSlot: Slot, blockRoot: Root, blockKzgCommitments: deneb.BlobKzgCommitments, dataColumnSidecars: fulu.DataColumnSidecars, metrics: Metrics | null, opts?: {
+    skipProofsCheck: boolean;
+}): void;
+/**
+ * SPEC FUNCTION
+ * https://github.com/ethereum/consensus-specs/blob/dev/specs/fulu/p2p-interface.md#verify_data_column_sidecar
+ */
+export declare function verifyDataColumnSidecar(dataColumnSidecar: fulu.DataColumnSidecar): void;
+/**
+ * SPEC FUNCTION
+ * https://github.com/ethereum/consensus-specs/blob/dev/specs/fulu/p2p-interface.md#verify_data_column_sidecar_kzg_proofs
+ */
+export declare function verifyDataColumnSidecarKzgProofs(commitments: Uint8Array[], cellIndices: number[], cells: Uint8Array[], proofs: Uint8Array[]): void;
+/**
+ * SPEC FUNCTION
+ * https://github.com/ethereum/consensus-specs/blob/dev/specs/fulu/p2p-interface.md#verify_data_column_sidecar_inclusion_proof
+ */
+export declare function verifyDataColumnSidecarInclusionProof(dataColumnSidecar: fulu.DataColumnSidecar): boolean;
+/**
+ * SPEC FUNCTION
+ * https://github.com/ethereum/consensus-specs/blob/dev/specs/fulu/p2p-interface.md#compute_subnet_for_data_column_sidecar
+ */
+export declare function computeSubnetForDataColumnSidecar(columnSidecar: fulu.DataColumnSidecar): SubnetID;
+//# sourceMappingURL=dataColumnSidecar.d.ts.map

package/lib/chain/validation/dataColumnSidecar.js

@@ -0,0 +1,245 @@
+import { DATA_COLUMN_SIDECAR_SUBNET_COUNT, KZG_COMMITMENTS_INCLUSION_PROOF_DEPTH, KZG_COMMITMENTS_SUBTREE_INDEX, NUMBER_OF_COLUMNS, } from "@lodestar/params";
+import { ssz } from "@lodestar/types";
+import { toHex, toRootHex, verifyMerkleBranch } from "@lodestar/utils";
+import { computeStartSlotAtEpoch, getBlockHeaderProposerSignatureSet } from "@lodestar/state-transition";
+import { byteArrayEquals } from "../../util/bytes.js";
+import { ckzg } from "../../util/kzg.js";
+import { DataColumnSidecarErrorCode, DataColumnSidecarGossipError } from "../errors/dataColumnSidecarError.js";
+import { GossipAction } from "../errors/gossipValidation.js";
+import { RegenCaller } from "../regen/interface.js";
+// SPEC FUNCTION
+// https://github.com/ethereum/consensus-specs/blob/dev/specs/fulu/p2p-interface.md#data_column_sidecar_subnet_id
+export async function validateGossipDataColumnSidecar(chain, dataColumnSidecar, gossipSubnet) {
+    const blockHeader = dataColumnSidecar.signedBlockHeader.message;
+    // 1) [REJECT] The sidecar is valid as verified by verify_data_column_sidecar
+    verifyDataColumnSidecar(dataColumnSidecar);
+    // 2) [REJECT] The sidecar is for the correct subnet -- i.e. compute_subnet_for_data_column_sidecar(sidecar.index) == subnet_id
+    if (computeSubnetForDataColumnSidecar(dataColumnSidecar) !== gossipSubnet) {
+        throw new DataColumnSidecarGossipError(GossipAction.REJECT, {
+            code: DataColumnSidecarErrorCode.INVALID_SUBNET,
+            columnIdx: dataColumnSidecar.index,
+            gossipSubnet: gossipSubnet,
+        });
+    }
+    // 3) [IGNORE] The sidecar is not from a future slot (with a MAXIMUM_GOSSIP_CLOCK_DISPARITY allowance)
+    //             -- i.e. validate that sidecar.slot <= current_slot (a client MAY queue future blocks
+    //             for processing at the appropriate slot).
+    const currentSlotWithGossipDisparity = chain.clock.currentSlotWithGossipDisparity;
+    if (currentSlotWithGossipDisparity < blockHeader.slot) {
+        throw new DataColumnSidecarGossipError(GossipAction.IGNORE, {
+            code: DataColumnSidecarErrorCode.FUTURE_SLOT,
+            currentSlot: currentSlotWithGossipDisparity,
+            blockSlot: blockHeader.slot,
+        });
+    }
+    // 4) [IGNORE] The sidecar is from a slot greater than the latest finalized slot -- i.e. validate that
+    //             sidecar.slot > compute_start_slot_at_epoch(state.finalized_checkpoint.epoch)
+    const finalizedCheckpoint = chain.forkChoice.getFinalizedCheckpoint();
+    const finalizedSlot = computeStartSlotAtEpoch(finalizedCheckpoint.epoch);
+    if (blockHeader.slot <= finalizedSlot) {
+        throw new DataColumnSidecarGossipError(GossipAction.IGNORE, {
+            code: DataColumnSidecarErrorCode.WOULD_REVERT_FINALIZED_SLOT,
+            blockSlot: blockHeader.slot,
+            finalizedSlot,
+        });
+    }
+    // 6) [IGNORE] The sidecar's block's parent (defined by block_header.parent_root) has been seen (via gossip
+    //             or non-gossip sources)
+    const parentRoot = toRootHex(blockHeader.parentRoot);
+    const parentBlock = chain.forkChoice.getBlockHex(parentRoot);
+    if (parentBlock === null) {
+        // If fork choice does *not* consider the parent to be a descendant of the finalized block,
+        // then there are two more cases:
+        //
+        // 1. We have the parent stored in our database. Because fork-choice has confirmed the
+        //    parent is *not* in our post-finalization DAG, all other blocks must be either
+        //    pre-finalization or conflicting with finalization.
+        // 2. The parent is unknown to us, we probably want to download it since it might actually
+        //    descend from the finalized root.
+        // (Non-Lighthouse): Since we prune all blocks non-descendant from finalized checking the `db.block` database won't be useful to guard
+        // against known bad fork blocks, so we throw PARENT_UNKNOWN for cases (1) and (2)
+        throw new DataColumnSidecarGossipError(GossipAction.IGNORE, {
+            code: DataColumnSidecarErrorCode.PARENT_UNKNOWN,
+            parentRoot,
+        });
+    }
+    // 8) [REJECT] The sidecar is from a higher slot than the sidecar's block's parent
+    if (parentBlock.slot >= blockHeader.slot) {
+        throw new DataColumnSidecarGossipError(GossipAction.REJECT, {
+            code: DataColumnSidecarErrorCode.NOT_LATER_THAN_PARENT,
+            parentSlot: parentBlock.slot,
+            slot: blockHeader.slot,
+        });
+    }
+    // getBlockSlotState also checks for whether the current finalized checkpoint is an ancestor of the block.
+    // As a result, we throw an IGNORE (whereas the spec says we should REJECT for this scenario).
+    // this is something we should change this in the future to make the code airtight to the spec.
+    // 7) [REJECT] The sidecar's block's parent passes validation.
+    const blockState = await chain.regen
+        .getBlockSlotState(parentRoot, blockHeader.slot, { dontTransferCache: true }, RegenCaller.validateGossipBlock)
+        .catch(() => {
+        throw new DataColumnSidecarGossipError(GossipAction.IGNORE, {
+            code: DataColumnSidecarErrorCode.PARENT_UNKNOWN,
+            parentRoot,
+        });
+    });
+    // 5) [REJECT] The proposer signature of sidecar.signed_block_header, is valid with respect to the block_header.proposer_index pubkey.
+    const signatureSet = getBlockHeaderProposerSignatureSet(blockState, dataColumnSidecar.signedBlockHeader);
+    // Don't batch so verification is not delayed
+    if (!(await chain.bls.verifySignatureSets([signatureSet], {
+        verifyOnMainThread: blockHeader.slot > chain.forkChoice.getHead().slot,
+    }))) {
+        throw new DataColumnSidecarGossipError(GossipAction.REJECT, {
+            code: DataColumnSidecarErrorCode.PROPOSAL_SIGNATURE_INVALID,
+        });
+    }
+    // 9) [REJECT] The current finalized_checkpoint is an ancestor of the sidecar's block
+    //             -- i.e. get_checkpoint_block(store, block_header.parent_root, store.finalized_checkpoint.epoch)
+    //                     == store.finalized_checkpoint.root
+    // Handled by 7)
+    // 10) [REJECT] The sidecar's kzg_commitments field inclusion proof is valid as verified by
+    //              verify_data_column_sidecar_inclusion_proof
+    //              TODO: Can cache result on (commitments, proof, header) in the future
+    if (!verifyDataColumnSidecarInclusionProof(dataColumnSidecar)) {
+        throw new DataColumnSidecarGossipError(GossipAction.REJECT, {
+            code: DataColumnSidecarErrorCode.INCLUSION_PROOF_INVALID,
+            slot: dataColumnSidecar.signedBlockHeader.message.slot,
+            columnIdx: dataColumnSidecar.index,
+        });
+    }
+    // 11) [REJECT] The sidecar's column data is valid as verified by verify_data_column_sidecar_kzg_proofs
+    try {
+        verifyDataColumnSidecarKzgProofs(dataColumnSidecar.kzgCommitments, Array.from({ length: dataColumnSidecar.column.length }, () => dataColumnSidecar.index), dataColumnSidecar.column, dataColumnSidecar.kzgProofs);
+    }
+    catch {
+        throw new DataColumnSidecarGossipError(GossipAction.REJECT, {
+            code: DataColumnSidecarErrorCode.INVALID_KZG_PROOF,
+            slot: blockHeader.slot,
+            columnIdx: dataColumnSidecar.index,
+        });
+    }
+    // 12) [IGNORE] The sidecar is the first sidecar for the tuple (block_header.slot, block_header.proposer_index,
+    //              sidecar.index) with valid header signature, sidecar inclusion proof, and kzg proof
+    //              -- Handled in seenGossipBlockInput
+    // 13) [REJECT] The sidecar is proposed by the expected proposer_index for the block's slot in the context of the current
+    //              shuffling (defined by block_header.parent_root/block_header.slot). If the proposer_index cannot
+    //              immediately be verified against the expected shuffling, the sidecar MAY be queued for later processing
+    //              while proposers for the block's branch are calculated -- in such a case do not REJECT, instead IGNORE
+    //              this message.
+    const proposerIndex = blockHeader.proposerIndex;
+    const expectedProposerIndex = blockState.epochCtx.getBeaconProposer(blockHeader.slot);
+    if (proposerIndex !== expectedProposerIndex) {
+        throw new DataColumnSidecarGossipError(GossipAction.REJECT, {
+            code: DataColumnSidecarErrorCode.INCORRECT_PROPOSER,
+            actualProposerIndex: proposerIndex,
+            expectedProposerIndex,
+        });
+    }
+}
+export function validateDataColumnsSidecars(blockSlot, blockRoot, blockKzgCommitments, dataColumnSidecars, metrics, opts = { skipProofsCheck: false }) {
+    const commitmentBytes = [];
+    const cellIndices = [];
+    const cells = [];
+    const proofBytes = [];
+    for (let sidecarsIndex = 0; sidecarsIndex < dataColumnSidecars.length; sidecarsIndex++) {
+        const columnSidecar = dataColumnSidecars[sidecarsIndex];
+        const { index: columnIndex, column, kzgCommitments, kzgProofs } = columnSidecar;
+        const columnBlockHeader = columnSidecar.signedBlockHeader.message;
+        const columnBlockRoot = ssz.phase0.BeaconBlockHeader.hashTreeRoot(columnBlockHeader);
+        if (columnBlockHeader.slot !== blockSlot ||
+            !byteArrayEquals(columnBlockRoot, blockRoot) ||
+            kzgCommitments.length === 0 ||
+            blockKzgCommitments.length === 0 ||
+            blockKzgCommitments.length !== kzgCommitments.length ||
+            blockKzgCommitments
+                .map((commitment, i) => byteArrayEquals(commitment, kzgCommitments[i]))
+                .filter((result) => result === false).length) {
+            throw new Error(`Invalid data column sidecar slot=${columnBlockHeader.slot} columnBlockRoot=${toHex(columnBlockRoot)} columnIndex=${columnIndex} for the block blockRoot=${toHex(blockRoot)} slot=${blockSlot} sidecarsIndex=${sidecarsIndex}`);
+        }
+        if (columnIndex >= NUMBER_OF_COLUMNS) {
+            throw new Error(`Invalid data sidecar columnIndex=${columnIndex} in slot=${blockSlot} blockRoot=${toHex(blockRoot)} sidecarsIndex=${sidecarsIndex}`);
+        }
+        if (column.length !== kzgCommitments.length || column.length !== kzgProofs.length) {
+            throw new Error(`Invalid data sidecar array lengths for columnIndex=${columnIndex} in slot=${blockSlot} blockRoot=${toHex(blockRoot)}`);
+        }
+        commitmentBytes.push(...kzgCommitments);
+        cellIndices.push(...Array.from({ length: column.length }, () => columnIndex));
+        cells.push(...column);
+        proofBytes.push(...kzgProofs);
+    }
+    if (opts.skipProofsCheck) {
+        return;
+    }
+    let valid;
+    try {
+        const timer = metrics?.peerDas.kzgVerificationDataColumnBatchTime.startTimer();
+        valid = ckzg.verifyCellKzgProofBatch(commitmentBytes, cellIndices, cells, proofBytes);
+        timer?.();
+    }
+    catch (err) {
+        err.message = `Error in verifyCellKzgProofBatch for slot=${blockSlot} blockRoot=${toHex(blockRoot)}`;
+        throw err;
+    }
+    if (!valid) {
+        throw new Error(`Invalid data column sidecars in slot=${blockSlot} blockRoot=${toHex(blockRoot)}`);
+    }
+}
+/**
+ * SPEC FUNCTION
+ * https://github.com/ethereum/consensus-specs/blob/dev/specs/fulu/p2p-interface.md#verify_data_column_sidecar
+ */
+export function verifyDataColumnSidecar(dataColumnSidecar) {
+    if (dataColumnSidecar.index >= NUMBER_OF_COLUMNS) {
+        throw new DataColumnSidecarGossipError(GossipAction.REJECT, {
+            code: DataColumnSidecarErrorCode.INVALID_INDEX,
+            columnIdx: dataColumnSidecar.index,
+        });
+    }
+    if (dataColumnSidecar.kzgCommitments.length === 0) {
+        throw new DataColumnSidecarGossipError(GossipAction.REJECT, {
+            code: DataColumnSidecarErrorCode.NO_COMMITMENTS,
+            columnIdx: dataColumnSidecar.index,
+        });
+    }
+    if (dataColumnSidecar.column.length !== dataColumnSidecar.kzgCommitments.length ||
+        dataColumnSidecar.column.length !== dataColumnSidecar.kzgProofs.length) {
+        throw new DataColumnSidecarGossipError(GossipAction.REJECT, {
+            code: DataColumnSidecarErrorCode.MISMATCHED_LENGTHS,
+            columnLength: dataColumnSidecar.column.length,
+            commitmentsLength: dataColumnSidecar.kzgCommitments.length,
+            proofsLength: dataColumnSidecar.kzgProofs.length,
+        });
+    }
+}
+/**
+ * SPEC FUNCTION
+ * https://github.com/ethereum/consensus-specs/blob/dev/specs/fulu/p2p-interface.md#verify_data_column_sidecar_kzg_proofs
+ */
+export function verifyDataColumnSidecarKzgProofs(commitments, cellIndices, cells, proofs) {
+    let valid;
+    try {
+        valid = ckzg.verifyCellKzgProofBatch(commitments, cellIndices, cells, proofs);
+    }
+    catch (e) {
+        e.message = `Error on verifyCellKzgProofBatch: ${e.message}`;
+        throw e;
+    }
+    if (!valid) {
+        throw Error("Invalid verifyCellKzgProofBatch");
+    }
+}
+/**
+ * SPEC FUNCTION
+ * https://github.com/ethereum/consensus-specs/blob/dev/specs/fulu/p2p-interface.md#verify_data_column_sidecar_inclusion_proof
+ */
+export function verifyDataColumnSidecarInclusionProof(dataColumnSidecar) {
+    return verifyMerkleBranch(ssz.deneb.BlobKzgCommitments.hashTreeRoot(dataColumnSidecar.kzgCommitments), dataColumnSidecar.kzgCommitmentsInclusionProof, KZG_COMMITMENTS_INCLUSION_PROOF_DEPTH, KZG_COMMITMENTS_SUBTREE_INDEX, dataColumnSidecar.signedBlockHeader.message.bodyRoot);
+}
+/**
+ * SPEC FUNCTION
+ * https://github.com/ethereum/consensus-specs/blob/dev/specs/fulu/p2p-interface.md#compute_subnet_for_data_column_sidecar
+ */
+export function computeSubnetForDataColumnSidecar(columnSidecar) {
+    return columnSidecar.index % DATA_COLUMN_SIDECAR_SUBNET_COUNT;
+}
+//# sourceMappingURL=dataColumnSidecar.js.map

package/lib/chain/validation/dataColumnSidecar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataColumnSidecar.js","sourceRoot":"","sources":["../../../src/chain/validation/dataColumnSidecar.ts"],"names":[],"mappings":"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"}

package/lib/chain/validatorMonitor.d.ts

@@ -4,7 +4,7 @@ import { BeaconBlock, RootHex, SubnetID, altair, deneb } from "@lodestar/types";
 import { Epoch, Slot, ValidatorIndex } from "@lodestar/types";
 import { IndexedAttestation, SignedAggregateAndProof } from "@lodestar/types";
 import { Logger } from "@lodestar/utils";
-import { Metrics } from "../metrics/index.js";
+import { RegistryMetricCreator } from "../metrics/index.js";
 type Seconds = number;
 export declare enum OpSource {
     api = "api",
@@ -14,7 +14,7 @@ export type ValidatorMonitor = {
     registerLocalValidator(index: number): void;
     registerLocalValidatorInSyncCommittee(index: number, untilEpoch: Epoch): void;
     registerValidatorStatuses(currentEpoch: Epoch, inclusionDelays: number[], flags: number[], isActiveCurrEpoch: boolean[], isActivePrevEpoch: boolean[], balances?: number[]): void;
-    registerBeaconBlock(src: OpSource, seenTimestampSec: Seconds, block: BeaconBlock): void;
+    registerBeaconBlock(src: OpSource, delaySec: Seconds, block: BeaconBlock): void;
     registerBlobSidecar(src: OpSource, seenTimestampSec: Seconds, blob: deneb.BlobSidecar): void;
     registerImportedBlock(block: BeaconBlock, data: {
         proposerBalanceDelta: number;
@@ -34,7 +34,7 @@ export type ValidatorMonitorOpts = {
     validatorMonitorLogs?: boolean;
 };
 export declare const defaultValidatorMonitorOpts: ValidatorMonitorOpts;
-export declare function createValidatorMonitor(metrics: Metrics | null, config: ChainForkConfig, genesisTime: number, logger: Logger, opts: ValidatorMonitorOpts): ValidatorMonitor;
+export declare function createValidatorMonitor(metricsRegister: RegistryMetricCreator | null, config: ChainForkConfig, genesisTime: number, logger: Logger, opts: ValidatorMonitorOpts): ValidatorMonitor;
 /**
  * Cache to prevent accessing the state tree to fetch block roots repeteadly.
  * In normal network conditions the same root is read multiple times, specially the target.