@lodestar/beacon-node/lib/chain/blocks/types.d.ts

A Typescript implementation of the beacon chain

import type { ChainForkConfig } from "@lodestar/config";
import type { BlockExecutionStatus, PayloadExecutionStatus } from "@lodestar/fork-choice";
import { DataAvailabilityStatus, IBeaconStateView } from "@lodestar/state-transition";
import type { IndexedAttestation, Slot, fulu } from "@lodestar/types";
import { IBlockInput } from "./blockInput/types.js";
export declare enum GossipedInputType {
    block = "block",
    blob = "blob",
    dataColumn = "data_column"
}
type DataColumnData = {
    dataColumn: fulu.DataColumnSidecar;
    dataColumnBytes: Uint8Array | null;
};
export type DataColumnsCacheMap = Map<number, DataColumnData>;
export declare function blockRequiresBlobs(config: ChainForkConfig, blockSlot: Slot, clockSlot: Slot): boolean;
export declare enum AttestationImportOpt {
    Skip = 0,
    Force = 1
}
export declare enum BlobSidecarValidation {
    /** When recieved in gossip the blobs are individually verified before import */
    Individual = 0,
    /**
     * Blobs when recieved in req/resp can be fully verified before import
     * but currently used in spec tests where blobs come without proofs and assumed
     * to be valid
     */
    Full = 1
}
export type ImportPayloadOpts = {
    /**
     * Set to true when the envelope was already validated upstream (e.g., gossip/API validation):
     * signature is trusted and execution_requests_root was already verified against the bid.
     * When false/undefined, both are verified during import.
     */
    validSignature?: boolean;
};
export type ImportBlockOpts = {
    /**
     * TEMP: Review if this is safe, Lighthouse always imports attestations even in finalized sync.
     */
    importAttestations?: AttestationImportOpt;
    /**
     * If error would trigger BlockErrorCode ALREADY_KNOWN or GENESIS_BLOCK, just ignore the block and don't verify nor
     * import the block and return void | Promise<void>.
     * Used by range sync and unknown block sync.
     */
    ignoreIfKnown?: boolean;
    /**
     * If error would trigger WOULD_REVERT_FINALIZED_SLOT, it means the block is finalized and we could ignore the block.
     * Don't import and return void | Promise<void>
     * Used by range sync.
     */
    ignoreIfFinalized?: boolean;
    /**
     * From RangeSync module, we won't attest to this block so it's okay to ignore a SYNCING message from execution layer
     */
    fromRangeSync?: boolean;
    /**
     * Verify signatures on main thread or not.
     */
    blsVerifyOnMainThread?: boolean;
    /**
     * Metadata: `true` if only the block proposer signature has been verified
     */
    validProposerSignature?: boolean;
    /**
     * Metadata: `true` if all the signatures including the proposer signature have been verified
     */
    validSignatures?: boolean;
    /** Set to true if already run `validateBlobSidecars()` sucessfully on the blobs */
    validBlobSidecars?: BlobSidecarValidation;
    /** Seen timestamp seconds */
    seenTimestampSec?: number;
};
/**
 * A wrapper around a `SignedBeaconBlock` that indicates that this block is fully verified and ready to import.
 *
 * `executionStatus` reflects the outcome of execution payload verification at block-import time:
 * - pre-gloas: Valid | Syncing | PreMerge (from EL notifyNewPayload against the in-block payload)
 * - post-gloas: inherited from parent's chain (Valid/Syncing) by importBlock; payload arrives
 *   separately as an envelope and creates the FULL variant later via onExecutionPayload
 */
export type FullyVerifiedBlock = {
    blockInput: IBlockInput;
    postState: IBeaconStateView;
    parentBlockSlot: Slot;
    proposerBalanceDelta: number;
    dataAvailabilityStatus: DataAvailabilityStatus;
    /** Pre-computed indexed attestations from signature verification to avoid duplicate work */
    indexedAttestations: IndexedAttestation[];
    /** Seen timestamp seconds */
    seenTimestampSec: number;
    /** If the execution payload couldn't be verified because of EL syncing status, used in optimistic sync */
    executionStatus: BlockExecutionStatus | PayloadExecutionStatus;
};
export {};
//# sourceMappingURL=types.d.ts.map