@lodestar/beacon-node 1.49.0-dev.ee7c2aa8ee → 1.49.0-dev.f362c805cf

package/lib/sync/backfill/backfill.d.ts

@@ -1,169 +0,0 @@
-import { EventEmitter } from "node:events";
-import { StrictEventEmitter } from "strict-event-emitter-types";
-import { BeaconConfig } from "@lodestar/config";
-import { IBeaconStateView } from "@lodestar/state-transition";
-import { Root, SignedBeaconBlock, Slot, phase0 } from "@lodestar/types";
-import { Logger } from "@lodestar/utils";
-import { IBeaconChain } from "../../chain/index.js";
-import { IBeaconDb } from "../../db/index.js";
-import { Metrics } from "../../metrics/metrics.js";
-import { INetwork } from "../../network/index.js";
-import { BackfillBlock, BackfillBlockHeader } from "./verify.js";
-export type BackfillSyncModules = {
-    chain: IBeaconChain;
-    db: IBeaconDb;
-    network: INetwork;
-    config: BeaconConfig;
-    logger: Logger;
-    metrics: Metrics | null;
-    anchorState: IBeaconStateView;
-    wsCheckpoint?: phase0.Checkpoint;
-    signal: AbortSignal;
-};
-type BackfillModules = BackfillSyncModules & {
-    syncAnchor: BackFillSyncAnchor;
-    backfillStartFromSlot: Slot;
-    prevFinalizedCheckpointBlock: BackfillBlockHeader;
-    wsCheckpointHeader: BackfillBlockHeader | null;
-    backfillRangeWrittenSlot: Slot | null;
-};
-export type BackfillSyncOpts = {
-    backfillBatchSize: number;
-};
-export declare enum BackfillSyncEvent {
-    completed = "BackfillSync-completed"
-}
-export declare enum BackfillSyncMethod {
-    database = "database",
-    backfilled_ranges = "backfilled_ranges",
-    rangesync = "rangesync",
-    blockbyroot = "blockbyroot"
-}
-export declare enum BackfillSyncStatus {
-    pending = "pending",
-    syncing = "syncing",
-    completed = "completed",
-    aborted = "aborted"
-}
-type BackfillSyncEvents = {
-    [BackfillSyncEvent.completed]: (
-    /** Oldest slot synced */
-    oldestSlotSynced: Slot) => void;
-};
-type BackfillSyncEmitter = StrictEventEmitter<EventEmitter, BackfillSyncEvents>;
-/**
- * At any given point, we should have
- * 1. anchorBlock (with its root anchorBlockRoot at anchorSlot) for next round of sync
- *    which is the same as the lastBackSyncedBlock
- * 2. We know the anchorBlockRoot but don't have its anchorBlock and anchorSlot yet, and its
- *    parent of lastBackSyncedBlock we synced in a previous successfull round
- * 3. We just started with only anchorBlockRoot, but we know (and will validate) its anchorSlot
- */
-type BackFillSyncAnchor = {
-    anchorBlock: SignedBeaconBlock;
-    anchorBlockRoot: Root;
-    anchorSlot: Slot;
-    lastBackSyncedBlock: BackfillBlock;
-} | {
-    anchorBlock: null;
-    anchorBlockRoot: Root;
-    anchorSlot: null;
-    lastBackSyncedBlock: BackfillBlock;
-} | {
-    anchorBlock: null;
-    anchorBlockRoot: Root;
-    anchorSlot: Slot;
-    lastBackSyncedBlock: null;
-};
-declare const BackfillSync_base: new () => BackfillSyncEmitter;
-export declare class BackfillSync extends BackfillSync_base {
-    /** Lowest slot that we have backfilled to */
-    syncAnchor: BackFillSyncAnchor;
-    private readonly chain;
-    private readonly network;
-    private readonly db;
-    private readonly config;
-    private readonly logger;
-    private readonly metrics;
-    /**
-     * Process in blocks of at max batchSize
-     */
-    private opts;
-    /**
-     * If wsCheckpoint provided was in past then the (db) state from which beacon node started,
-     * needs to be validated as per spec.
-     *
-     * 1. This could lie in between of the previous backfilled range, in which case it would be
-     *    sufficient to check if its DB, once the linkage to that range has been verified.
-     * 2. Else if it lies outside the backfilled range, the linkage to this checkpoint in
-     *    backfill needs to be verified.
-     */
-    private wsCheckpointHeader;
-    private wsValidated;
-    /**
-     * From https://github.com/ethereum/consensus-specs/blob/v1.6.1/specs/phase0/weak-subjectivity.md
-     *
-     *
-     * If
-     *   1. The wsCheckpoint provided was ahead of the db's finalized checkpoint or
-     *   2. There were gaps in the backfill - keys to backfillRanges are always (by construction)
-     *     a) Finalized Checkpoint or b) previous wsCheckpoint
-     *
-     * the linkage to the previous finalized/wss checkpoint(s) needs to be verfied. If there is
-     * no such checkpoint remaining, the linkage to genesis needs to be validated
-     *
-     * Initialize with the blockArchive's last block, and on verification update to the next
-     * preceding backfillRange key's checkpoint.
-     */
-    private prevFinalizedCheckpointBlock;
-    /** Starting point that this specific backfill sync "session" started from */
-    private backfillStartFromSlot;
-    private backfillRangeWrittenSlot;
-    private processor;
-    private peers;
-    private status;
-    private signal;
-    constructor(opts: BackfillSyncOpts, modules: BackfillModules);
-    /**
-     * Use the root of the anchorState of the beacon node as the starting point of the
-     * backfill sync with its expected slot to be anchorState.slot, which will be
-     * validated once the block is resolved in the backfill sync.
-     *
-     * NOTE: init here is quite light involving couple of
-     *
-     *   1. db keys lookup in stateArchive/backfilledRanges
-     *   2. computing root(s) for anchorBlockRoot and prevFinalizedCheckpointBlock
-     *
-     * The way we initialize beacon node, wsCheckpoint's slot is always <= anchorSlot
-     * If:
-     *   the root belonging to wsCheckpoint is in the DB, we need to verify linkage to it
-     *   i.e. it becomes our first prevFinalizedCheckpointBlock
-     * Else
-     *   we initialize prevFinalizedCheckpointBlock from the last stored db finalized state
-     *   for verification and when we go below its epoch we just check if a correct block
-     *   corresponding to wsCheckpoint root was stored.
-     *
-     * and then we continue going back and verifying the next unconnected previous finalized
-     * or wsCheckpoints identifiable as the keys of backfill sync.
-     */
-    static init<T extends BackfillSync = BackfillSync>(opts: BackfillSyncOpts, modules: BackfillSyncModules): Promise<T>;
-    /** Throw / return all AsyncGenerators */
-    close(): void;
-    /**
-     * @returns Returns oldestSlotSynced
-     */
-    private sync;
-    private addPeer;
-    private removePeer;
-    /**
-     * Ensure that any weak subjectivity checkpoint provided in past with respect
-     * the initialization point is the same block tree as the DB once backfill
-     */
-    private checkIfCheckpointSyncedAndValidate;
-    private checkUpdateFromBackfillSequences;
-    private fastBackfillDb;
-    private syncBlockByRoot;
-    private syncRange;
-}
-export {};
-//# sourceMappingURL=backfill.d.ts.map

package/lib/sync/backfill/backfill.d.ts.map

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