@chainsafe/lodestar 1.50.0-dev.7f24e06bb6 → 1.50.0-dev.814fe8c461

package/lib/cmds/beacon/stateInitialization/checkpointState.d.ts

@@ -0,0 +1,7 @@
+import { ArchivedStateBytes, StateInitialization, StateInitializationOptions, StatePreparationContext } from "./types.js";
+type CheckpointOptions = Pick<StateInitializationOptions, "wssCheckpoint" | "forceCheckpointSync" | "ignoreWeakSubjectivityCheck">;
+export declare function prepareCheckpointFileInitialization(checkpointState: string, options: CheckpointOptions, archived: ArchivedStateBytes | null, context: StatePreparationContext): Promise<StateInitialization>;
+export declare function prepareCheckpointApiInitialization(checkpointSyncUrl: string, options: CheckpointOptions, archived: ArchivedStateBytes | null, context: StatePreparationContext): Promise<StateInitialization>;
+export declare function prepareUnfinalizedCheckpointInitialization(options: CheckpointOptions & Pick<StateInitializationOptions, "lastPersistedCheckpointState" | "unsafeCheckpointState" | "chain.nHistoricalStatesFileDataStore">, archived: ArchivedStateBytes | null, context: StatePreparationContext): Promise<StateInitialization | null>;
+export {};
+//# sourceMappingURL=checkpointState.d.ts.map

package/lib/cmds/beacon/stateInitialization/checkpointState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpointState.d.ts","sourceRoot":"","sources":["../../../../src/cmds/beacon/stateInitialization/checkpointState.ts"],"names":[],"mappings":"AAgBA,OAAO,EACL,kBAAkB,EAGlB,mBAAmB,EACnB,0BAA0B,EAC1B,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAGpB,KAAK,iBAAiB,GAAG,IAAI,CAC3B,0BAA0B,EAC1B,eAAe,GAAG,qBAAqB,GAAG,6BAA6B,CACxE,CAAC;AAEF,wBAAsB,mCAAmC,CACvD,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,kBAAkB,GAAG,IAAI,EACnC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,mBAAmB,CAAC,CAmB9B;AAED,wBAAsB,kCAAkC,CACtD,iBAAiB,EAAE,MAAM,EACzB,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,kBAAkB,GAAG,IAAI,EACnC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,mBAAmB,CAAC,CAuB9B;AAED,wBAAsB,0CAA0C,CAC9D,OAAO,EAAE,iBAAiB,GACxB,IAAI,CACF,0BAA0B,EAC1B,8BAA8B,GAAG,uBAAuB,GAAG,sCAAsC,CAClG,EACH,QAAQ,EAAE,kBAAkB,GAAG,IAAI,EACnC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAuCrC"}

package/lib/cmds/beacon/stateInitialization/checkpointState.js

@@ -0,0 +1,168 @@
+import { DbCPStateDatastore, FileCPStateDatastore, persistAnchorState } from "@lodestar/beacon-node";
+import { createBeaconConfig } from "@lodestar/config";
+import { computeEpochAtSlot, computeWeakSubjectivitySummaryFromStateBytes, getCurrentSlot, isWithinWeakSubjectivityPeriodFromSummary, readBeaconStateBytesMetadata, } from "@lodestar/state-transition";
+import { ssz } from "@lodestar/types";
+import { formatBytes, toRootHex } from "@lodestar/utils";
+import { fetchWeakSubjectivityStateBytes, getCheckpointFromArg } from "../../../networks/index.js";
+import { downloadOrLoadFile } from "../../../util/index.js";
+import { StateInitializationError, StateInitializationErrorCode } from "./errors.js";
+import { assertAnchorStateForkMatchesConfig } from "./validation.js";
+export async function prepareCheckpointFileInitialization(checkpointState, options, archived, context) {
+    context.logger.info("Loading checkpoint state", { checkpointState });
+    const bytes = await downloadOrLoadFile(checkpointState);
+    const stateBytes = new Uint8Array(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    context.logger.info("Loaded checkpoint state", { checkpointState, size: formatBytes(stateBytes.length) });
+    return prepareCheckpointInitialization({
+        stateBytes,
+        expectedCheckpoint: options.wssCheckpoint ? getCheckpointFromArg(options.wssCheckpoint) : null,
+        source: "checkpoint file",
+    }, archived, {
+        isFinalized: true,
+        forceCheckpointSync: Boolean(options.forceCheckpointSync),
+        ignoreWeakSubjectivityCheck: Boolean(options.ignoreWeakSubjectivityCheck),
+    }, context);
+}
+export async function prepareCheckpointApiInitialization(checkpointSyncUrl, options, archived, context) {
+    const { chainForkConfig, logger } = context;
+    try {
+        const url = new URL(checkpointSyncUrl);
+        logger.info("Fetching checkpoint state", { checkpointSyncUrl: url.origin });
+    }
+    catch (error) {
+        logger.error("Invalid checkpoint sync URL", { checkpointSyncUrl }, error);
+        throw error;
+    }
+    const { stateBytes, expectedCheckpoint } = await fetchWeakSubjectivityStateBytes(chainForkConfig, logger, {
+        checkpointSyncUrl,
+        wssCheckpoint: options.wssCheckpoint,
+    });
+    return prepareCheckpointInitialization({ stateBytes, expectedCheckpoint, source: "checkpointSyncUrl" }, archived, {
+        isFinalized: true,
+        forceCheckpointSync: Boolean(options.forceCheckpointSync),
+        ignoreWeakSubjectivityCheck: Boolean(options.ignoreWeakSubjectivityCheck),
+    }, context);
+}
+export async function prepareUnfinalizedCheckpointInitialization(options, archived, context) {
+    const { db, dataDir, logger } = context;
+    let bytes = null;
+    if (options.lastPersistedCheckpointState && !options.forceCheckpointSync) {
+        const store = options["chain.nHistoricalStatesFileDataStore"]
+            ? new FileCPStateDatastore(dataDir)
+            : new DbCPStateDatastore(db);
+        logger.verbose(`Finding last persisted checkpoint state from ${store.constructor.name}`);
+        bytes = await store.readLatestSafe();
+        if (bytes === null) {
+            logger.warn("Last persisted checkpoint state not found");
+        }
+        else {
+            logger.info("Found last persisted checkpoint state", { size: formatBytes(bytes.length) });
+        }
+    }
+    if (bytes === null && options.unsafeCheckpointState) {
+        logger.info("Loading checkpoint state", { unsafeCheckpointState: options.unsafeCheckpointState });
+        bytes = await downloadOrLoadFile(options.unsafeCheckpointState);
+        logger.info("Loaded checkpoint state", { size: formatBytes(bytes.length) });
+    }
+    if (bytes === null)
+        return null;
+    logger.warn("Initializing from unfinalized checkpoint state is unsafe and may cause the node to follow a minority chain");
+    const stateBytes = new Uint8Array(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    return prepareCheckpointInitialization({
+        stateBytes,
+        expectedCheckpoint: options.wssCheckpoint ? getCheckpointFromArg(options.wssCheckpoint) : null,
+        source: "unfinalized source",
+    }, archived, {
+        isFinalized: false,
+        forceCheckpointSync: Boolean(options.forceCheckpointSync),
+        ignoreWeakSubjectivityCheck: Boolean(options.ignoreWeakSubjectivityCheck),
+    }, context);
+}
+function prepareCheckpointInitialization(candidate, archived, policy, { chainForkConfig, db, logger }) {
+    const candidateMetadata = readBeaconStateBytesMetadata(candidate.stateBytes);
+    if (candidateMetadata === null) {
+        throw new StateInitializationError({ code: StateInitializationErrorCode.MALFORMED_STATE_BYTES }, `Cannot read state metadata from ${candidate.source}`);
+    }
+    if (archived !== null &&
+        (archived.metadata.genesisTime !== candidateMetadata.genesisTime ||
+            !ssz.Root.equals(archived.metadata.genesisValidatorsRoot, candidateMetadata.genesisValidatorsRoot))) {
+        throw new StateInitializationError({ code: StateInitializationErrorCode.INCOMPATIBLE_GENESIS }, "Db state and checkpoint state are not compatible, either clear the db or verify your checkpoint source");
+    }
+    const useArchived = archived !== null && archived.metadata.slot > candidateMetadata.slot && !policy.forceCheckpointSync;
+    if (useArchived) {
+        logger.verbose("Db state is ahead of the provided checkpoint state, using the db state to initialize the beacon chain");
+    }
+    const { stateBytes, metadata, weakSubjectivity } = useArchived
+        ? archived
+        : {
+            stateBytes: candidate.stateBytes,
+            metadata: candidateMetadata,
+            weakSubjectivity: computeWeakSubjectivitySummaryFromStateBytes(chainForkConfig, candidate.stateBytes, candidateMetadata),
+        };
+    if (weakSubjectivity === null) {
+        throw new StateInitializationError({ code: StateInitializationErrorCode.MALFORMED_STATE_BYTES }, `Cannot extract weak subjectivity summary from ${candidate.source}, expected ${chainForkConfig.getForkName(metadata.slot)} state at slot ${metadata.slot}, possible fork or network mismatch`);
+    }
+    const expectedCheckpoint = useArchived ? null : candidate.expectedCheckpoint;
+    const source = useArchived ? "db" : candidate.source;
+    const { isFinalized, ignoreWeakSubjectivityCheck } = policy;
+    const config = createBeaconConfig(chainForkConfig, metadata.genesisValidatorsRoot);
+    const archivedWithinWeakSubjectivityPeriod = useArchived ? archived.isWithinWeakSubjectivityPeriod : null;
+    // DB-selected anchors need no persistence, including at slot zero.
+    const shouldPersist = isFinalized && !useArchived;
+    return {
+        stateBytes,
+        config,
+        isFinalized,
+        validate(state) {
+            // A supplied checkpoint must match even when the period check is ignored.
+            if (expectedCheckpoint !== null)
+                assertStateMatchesCheckpoint(state, expectedCheckpoint);
+            const passedValidation = archivedWithinWeakSubjectivityPeriod ?? isWithinWeakSubjectivityPeriodFromSummary(config, weakSubjectivity);
+            if (!passedValidation && !ignoreWeakSubjectivityCheck) {
+                const clockEpoch = computeEpochAtSlot(getCurrentSlot(config, weakSubjectivity.genesisTime));
+                throw new StateInitializationError({ code: StateInitializationErrorCode.STALE_CHECKPOINT }, `The selected state with epoch ${weakSubjectivity.checkpointEpoch} is not within weak subjectivity period of ${weakSubjectivity.period} epochs from the current epoch ${clockEpoch}. Please verify your checkpoint source`);
+            }
+            assertAnchorStateForkMatchesConfig(config, state);
+            if (isFinalized) {
+                const source = useArchived ? "db" : "checkpoint";
+                const logData = {
+                    slot: state.slot,
+                    epoch: computeEpochAtSlot(state.slot),
+                    stateSize: formatBytes(stateBytes.length),
+                    stateRoot: toRootHex(state.hashTreeRoot()),
+                    isWithinWeakSubjectivityPeriod: passedValidation,
+                };
+                if (passedValidation) {
+                    logger.info(`Initializing beacon from a valid ${source} state`, logData);
+                }
+                else {
+                    logger.warn(`Initializing from a stale ${source} state vulnerable to long range attacks`, logData);
+                    logger.warn("Checkpoint sync recommended, please use --help to see checkpoint sync options");
+                }
+            }
+        },
+        persist: shouldPersist ? (state, bytes) => persistAnchorState(config, db, state, bytes) : null,
+        log(state) {
+            const { checkpoint } = state.computeAnchorCheckpoint();
+            logger.info("Initialized checkpoint state", {
+                source,
+                slot: state.slot,
+                epoch: checkpoint.epoch,
+                stateSize: formatBytes(stateBytes.length),
+                stateRoot: toRootHex(state.hashTreeRoot()),
+                checkpointRoot: toRootHex(checkpoint.root),
+                isFinalized,
+                ...(isFinalized ? {} : { lastProcessedSlot: state.latestBlockHeader.slot }),
+            });
+        },
+    };
+}
+function assertStateMatchesCheckpoint(state, checkpoint) {
+    const { root: blockRoot, epoch: stateEpoch } = state.computeAnchorCheckpoint().checkpoint;
+    if (!ssz.Root.equals(blockRoot, checkpoint.root)) {
+        throw new StateInitializationError({ code: StateInitializationErrorCode.CHECKPOINT_ROOT_MISMATCH }, `Roots do not match.  expected=${toRootHex(checkpoint.root)}, actual=${toRootHex(blockRoot)}`);
+    }
+    if (!ssz.Epoch.equals(stateEpoch, checkpoint.epoch)) {
+        throw new StateInitializationError({ code: StateInitializationErrorCode.CHECKPOINT_EPOCH_MISMATCH }, `Epochs do not match.  expected=${checkpoint.epoch}, actual=${stateEpoch}`);
+    }
+}
+//# sourceMappingURL=checkpointState.js.map

package/lib/cmds/beacon/stateInitialization/checkpointState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpointState.js","sourceRoot":"","sources":["../../../../src/cmds/beacon/stateInitialization/checkpointState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kBAAkB,EAAE,oBAAoB,EAAE,kBAAkB,EAAC,MAAM,uBAAuB,CAAC;AACnG,OAAO,EAAC,kBAAkB,EAAC,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAEL,kBAAkB,EAClB,4CAA4C,EAC5C,cAAc,EACd,yCAAyC,EACzC,4BAA4B,GAC7B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAC,GAAG,EAAC,MAAM,iBAAiB,CAAC;AAEpC,OAAO,EAAC,WAAW,EAAE,SAAS,EAAC,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAC,+BAA+B,EAAE,oBAAoB,EAAC,MAAM,4BAA4B,CAAC;AACjG,OAAO,EAAC,kBAAkB,EAAC,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAC,wBAAwB,EAAE,4BAA4B,EAAC,MAAM,aAAa,CAAC;AASnF,OAAO,EAAC,kCAAkC,EAAC,MAAM,iBAAiB,CAAC;AAOnE,MAAM,CAAC,KAAK,UAAU,mCAAmC,CACvD,eAAuB,EACvB,OAA0B,EAC1B,QAAmC,EACnC,OAAgC;IAEhC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAC,eAAe,EAAC,CAAC,CAAC;IACnE,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,eAAe,CAAC,CAAC;IACxD,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IACpF,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,yBAAyB,EAAE,EAAC,eAAe,EAAE,IAAI,EAAE,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,EAAC,CAAC,CAAC;IACxG,OAAO,+BAA+B,CACpC;QACE,UAAU;QACV,kBAAkB,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,oBAAoB,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI;QAC9F,MAAM,EAAE,iBAAiB;KAC1B,EACD,QAAQ,EACR;QACE,WAAW,EAAE,IAAI;QACjB,mBAAmB,EAAE,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC;QACzD,2BAA2B,EAAE,OAAO,CAAC,OAAO,CAAC,2BAA2B,CAAC;KAC1E,EACD,OAAO,CACR,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kCAAkC,CACtD,iBAAyB,EACzB,OAA0B,EAC1B,QAAmC,EACnC,OAAgC;IAEhC,MAAM,EAAC,eAAe,EAAE,MAAM,EAAC,GAAG,OAAO,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,iBAAiB,CAAC,CAAC;QACvC,MAAM,CAAC,IAAI,CAAC,2BAA2B,EAAE,EAAC,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAC,CAAC,CAAC;IAC5E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE,EAAC,iBAAiB,EAAC,EAAE,KAAc,CAAC,CAAC;QACjF,MAAM,KAAK,CAAC;IACd,CAAC;IACD,MAAM,EAAC,UAAU,EAAE,kBAAkB,EAAC,GAAG,MAAM,+BAA+B,CAAC,eAAe,EAAE,MAAM,EAAE;QACtG,iBAAiB;QACjB,aAAa,EAAE,OAAO,CAAC,aAAa;KACrC,CAAC,CAAC;IACH,OAAO,+BAA+B,CACpC,EAAC,UAAU,EAAE,kBAAkB,EAAE,MAAM,EAAE,mBAAmB,EAAC,EAC7D,QAAQ,EACR;QACE,WAAW,EAAE,IAAI;QACjB,mBAAmB,EAAE,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC;QACzD,2BAA2B,EAAE,OAAO,CAAC,OAAO,CAAC,2BAA2B,CAAC;KAC1E,EACD,OAAO,CACR,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0CAA0C,CAC9D,OAIG,EACH,QAAmC,EACnC,OAAgC;IAEhC,MAAM,EAAC,EAAE,EAAE,OAAO,EAAE,MAAM,EAAC,GAAG,OAAO,CAAC;IACtC,IAAI,KAAK,GAAsB,IAAI,CAAC;IACpC,IAAI,OAAO,CAAC,4BAA4B,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,CAAC;QACzE,MAAM,KAAK,GAAG,OAAO,CAAC,sCAAsC,CAAC;YAC3D,CAAC,CAAC,IAAI,oBAAoB,CAAC,OAAO,CAAC;YACnC,CAAC,CAAC,IAAI,kBAAkB,CAAC,EAAE,CAAC,CAAC;QAC/B,MAAM,CAAC,OAAO,CAAC,gDAAgD,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;QACzF,KAAK,GAAG,MAAM,KAAK,CAAC,cAAc,EAAE,CAAC;QACrC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,MAAM,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;QAC3D,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,uCAAuC,EAAE,EAAC,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,EAAC,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;QACpD,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAC,qBAAqB,EAAE,OAAO,CAAC,qBAAqB,EAAC,CAAC,CAAC;QAChG,KAAK,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;QAChE,MAAM,CAAC,IAAI,CAAC,yBAAyB,EAAE,EAAC,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,EAAC,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,CAAC,IAAI,CACT,4GAA4G,CAC7G,CAAC;IACF,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IACpF,OAAO,+BAA+B,CACpC;QACE,UAAU;QACV,kBAAkB,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,oBAAoB,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI;QAC9F,MAAM,EAAE,oBAAoB;KAC7B,EACD,QAAQ,EACR;QACE,WAAW,EAAE,KAAK;QAClB,mBAAmB,EAAE,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC;QACzD,2BAA2B,EAAE,OAAO,CAAC,OAAO,CAAC,2BAA2B,CAAC;KAC1E,EACD,OAAO,CACR,CAAC;AACJ,CAAC;AAED,SAAS,+BAA+B,CACtC,SAAwC,EACxC,QAAmC,EACnC,MAA+B,EAC/B,EAAC,eAAe,EAAE,EAAE,EAAE,MAAM,EAA0B;IAEtD,MAAM,iBAAiB,GAAG,4BAA4B,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAC7E,IAAI,iBAAiB,KAAK,IAAI,EAAE,CAAC;QAC/B,MAAM,IAAI,wBAAwB,CAChC,EAAC,IAAI,EAAE,4BAA4B,CAAC,qBAAqB,EAAC,EAC1D,mCAAmC,SAAS,CAAC,MAAM,EAAE,CACtD,CAAC;IACJ,CAAC;IACD,IACE,QAAQ,KAAK,IAAI;QACjB,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,KAAK,iBAAiB,CAAC,WAAW;YAC9D,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,qBAAqB,EAAE,iBAAiB,CAAC,qBAAqB,CAAC,CAAC,EACrG,CAAC;QACD,MAAM,IAAI,wBAAwB,CAChC,EAAC,IAAI,EAAE,4BAA4B,CAAC,oBAAoB,EAAC,EACzD,wGAAwG,CACzG,CAAC;IACJ,CAAC;IACD,MAAM,WAAW,GACf,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,GAAG,iBAAiB,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC;IACtG,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,CAAC,OAAO,CACZ,uGAAuG,CACxG,CAAC;IACJ,CAAC;IACD,MAAM,EAAC,UAAU,EAAE,QAAQ,EAAE,gBAAgB,EAAC,GAAG,WAAW;QAC1D,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC;YACE,UAAU,EAAE,SAAS,CAAC,UAAU;YAChC,QAAQ,EAAE,iBAAiB;YAC3B,gBAAgB,EAAE,4CAA4C,CAC5D,eAAe,EACf,SAAS,CAAC,UAAU,EACpB,iBAAiB,CAClB;SACF,CAAC;IACN,IAAI,gBAAgB,KAAK,IAAI,EAAE,CAAC;QAC9B,MAAM,IAAI,wBAAwB,CAChC,EAAC,IAAI,EAAE,4BAA4B,CAAC,qBAAqB,EAAC,EAC1D,iDAAiD,SAAS,CAAC,MAAM,cAAc,eAAe,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,kBAAkB,QAAQ,CAAC,IAAI,qCAAqC,CAC9L,CAAC;IACJ,CAAC;IACD,MAAM,kBAAkB,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC;IAC7E,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC;IACrD,MAAM,EAAC,WAAW,EAAE,2BAA2B,EAAC,GAAG,MAAM,CAAC;IAC1D,MAAM,MAAM,GAAG,kBAAkB,CAAC,eAAe,EAAE,QAAQ,CAAC,qBAAqB,CAAC,CAAC;IACnF,MAAM,oCAAoC,GAAG,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,8BAA8B,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1G,mEAAmE;IACnE,MAAM,aAAa,GAAG,WAAW,IAAI,CAAC,WAAW,CAAC;IAClD,OAAO;QACL,UAAU;QACV,MAAM;QACN,WAAW;QACX,QAAQ,CAAC,KAAK;YACZ,0EAA0E;YAC1E,IAAI,kBAAkB,KAAK,IAAI;gBAAE,4BAA4B,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC;YACzF,MAAM,gBAAgB,GACpB,oCAAoC,IAAI,yCAAyC,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;YAC9G,IAAI,CAAC,gBAAgB,IAAI,CAAC,2BAA2B,EAAE,CAAC;gBACtD,MAAM,UAAU,GAAG,kBAAkB,CAAC,cAAc,CAAC,MAAM,EAAE,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC;gBAC5F,MAAM,IAAI,wBAAwB,CAChC,EAAC,IAAI,EAAE,4BAA4B,CAAC,gBAAgB,EAAC,EACrD,iCAAiC,gBAAgB,CAAC,eAAe,8CAA8C,gBAAgB,CAAC,MAAM,kCAAkC,UAAU,wCAAwC,CAC3N,CAAC;YACJ,CAAC;YACD,kCAAkC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAClD,IAAI,WAAW,EAAE,CAAC;gBAChB,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC;gBACjD,MAAM,OAAO,GAAG;oBACd,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,KAAK,EAAE,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC;oBACrC,SAAS,EAAE,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC;oBACzC,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;oBAC1C,8BAA8B,EAAE,gBAAgB;iBACjD,CAAC;gBACF,IAAI,gBAAgB,EAAE,CAAC;oBACrB,MAAM,CAAC,IAAI,CAAC,oCAAoC,MAAM,QAAQ,EAAE,OAAO,CAAC,CAAC;gBAC3E,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,CAAC,6BAA6B,MAAM,yCAAyC,EAAE,OAAO,CAAC,CAAC;oBACnG,MAAM,CAAC,IAAI,CAAC,+EAA+E,CAAC,CAAC;gBAC/F,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,kBAAkB,CAAC,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI;QAC9F,GAAG,CAAC,KAAK;YACP,MAAM,EAAC,UAAU,EAAC,GAAG,KAAK,CAAC,uBAAuB,EAAE,CAAC;YACrD,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE;gBAC1C,MAAM;gBACN,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,KAAK,EAAE,UAAU,CAAC,KAAK;gBACvB,SAAS,EAAE,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC;gBACzC,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;gBAC1C,cAAc,EAAE,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC;gBAC1C,WAAW;gBACX,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAC,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAC,CAAC;aAC1E,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,4BAA4B,CAAC,KAAuB,EAAE,UAAsB;IACnF,MAAM,EAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAC,GAAG,KAAK,CAAC,uBAAuB,EAAE,CAAC,UAAU,CAAC;IACxF,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,wBAAwB,CAChC,EAAC,IAAI,EAAE,4BAA4B,CAAC,wBAAwB,EAAC,EAC7D,iCAAiC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,YAAY,SAAS,CAAC,SAAS,CAAC,EAAE,CAC9F,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,wBAAwB,CAChC,EAAC,IAAI,EAAE,4BAA4B,CAAC,yBAAyB,EAAC,EAC9D,kCAAkC,UAAU,CAAC,KAAK,YAAY,UAAU,EAAE,CAC3E,CAAC;IACJ,CAAC;AACH,CAAC"}

package/lib/cmds/beacon/stateInitialization/errors.d.ts

@@ -0,0 +1,17 @@
+import { LodestarError } from "@lodestar/utils";
+export declare enum StateInitializationErrorCode {
+    INVALID_CHECKPOINT_SOURCE = "INVALID_CHECKPOINT_SOURCE",
+    MALFORMED_STATE_BYTES = "MALFORMED_STATE_BYTES",
+    INCOMPATIBLE_GENESIS = "INCOMPATIBLE_GENESIS",
+    CHECKPOINT_ROOT_MISMATCH = "CHECKPOINT_ROOT_MISMATCH",
+    CHECKPOINT_EPOCH_MISMATCH = "CHECKPOINT_EPOCH_MISMATCH",
+    STALE_CHECKPOINT = "STALE_CHECKPOINT",
+    ANCHOR_STATE_FORK_MISMATCH = "ANCHOR_STATE_FORK_MISMATCH",
+    GENESIS_ROOT_MISMATCH = "GENESIS_ROOT_MISMATCH",
+    MISSING_INITIALIZATION_SOURCE = "MISSING_INITIALIZATION_SOURCE"
+}
+export declare class StateInitializationError extends LodestarError<{
+    code: StateInitializationErrorCode;
+}> {
+}
+//# sourceMappingURL=errors.d.ts.map

package/lib/cmds/beacon/stateInitialization/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/cmds/beacon/stateInitialization/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAC;AAE9C,oBAAY,4BAA4B;IACtC,yBAAyB,8BAA8B;IACvD,qBAAqB,0BAA0B;IAC/C,oBAAoB,yBAAyB;IAC7C,wBAAwB,6BAA6B;IACrD,yBAAyB,8BAA8B;IACvD,gBAAgB,qBAAqB;IACrC,0BAA0B,+BAA+B;IACzD,qBAAqB,0BAA0B;IAC/C,6BAA6B,kCAAkC;CAChE;AAED,qBAAa,wBAAyB,SAAQ,aAAa,CAAC;IAAC,IAAI,EAAE,4BAA4B,CAAA;CAAC,CAAC;CAAG"}

package/lib/cmds/beacon/stateInitialization/errors.js

@@ -0,0 +1,16 @@
+import { LodestarError } from "@lodestar/utils";
+export var StateInitializationErrorCode;
+(function (StateInitializationErrorCode) {
+    StateInitializationErrorCode["INVALID_CHECKPOINT_SOURCE"] = "INVALID_CHECKPOINT_SOURCE";
+    StateInitializationErrorCode["MALFORMED_STATE_BYTES"] = "MALFORMED_STATE_BYTES";
+    StateInitializationErrorCode["INCOMPATIBLE_GENESIS"] = "INCOMPATIBLE_GENESIS";
+    StateInitializationErrorCode["CHECKPOINT_ROOT_MISMATCH"] = "CHECKPOINT_ROOT_MISMATCH";
+    StateInitializationErrorCode["CHECKPOINT_EPOCH_MISMATCH"] = "CHECKPOINT_EPOCH_MISMATCH";
+    StateInitializationErrorCode["STALE_CHECKPOINT"] = "STALE_CHECKPOINT";
+    StateInitializationErrorCode["ANCHOR_STATE_FORK_MISMATCH"] = "ANCHOR_STATE_FORK_MISMATCH";
+    StateInitializationErrorCode["GENESIS_ROOT_MISMATCH"] = "GENESIS_ROOT_MISMATCH";
+    StateInitializationErrorCode["MISSING_INITIALIZATION_SOURCE"] = "MISSING_INITIALIZATION_SOURCE";
+})(StateInitializationErrorCode || (StateInitializationErrorCode = {}));
+export class StateInitializationError extends LodestarError {
+}
+//# sourceMappingURL=errors.js.map

package/lib/cmds/beacon/stateInitialization/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/cmds/beacon/stateInitialization/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAC;AAE9C,MAAM,CAAN,IAAY,4BAUX;AAVD,WAAY,4BAA4B;IACtC,uFAAuD,CAAA;IACvD,+EAA+C,CAAA;IAC/C,6EAA6C,CAAA;IAC7C,qFAAqD,CAAA;IACrD,uFAAuD,CAAA;IACvD,qEAAqC,CAAA;IACrC,yFAAyD,CAAA;IACzD,+EAA+C,CAAA;IAC/C,+FAA+D,CAAA;AACjE,CAAC,EAVW,4BAA4B,KAA5B,4BAA4B,QAUvC;AAED,MAAM,OAAO,wBAAyB,SAAQ,aAAmD;CAAG"}

package/lib/cmds/beacon/stateInitialization/genesisState.d.ts

@@ -0,0 +1,3 @@
+import { StateInitialization, StateInitializationOptions, StatePreparationContext } from "./types.js";
+export declare function prepareGenesisInitialization(options: Pick<StateInitializationOptions, "genesisStateFile" | "network">, { chainForkConfig, db, logger }: StatePreparationContext): Promise<StateInitialization>;
+//# sourceMappingURL=genesisState.d.ts.map

package/lib/cmds/beacon/stateInitialization/genesisState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"genesisState.d.ts","sourceRoot":"","sources":["../../../../src/cmds/beacon/stateInitialization/genesisState.ts"],"names":[],"mappings":"AAaA,OAAO,EAAC,mBAAmB,EAAE,0BAA0B,EAAE,uBAAuB,EAAC,MAAM,YAAY,CAAC;AAGpG,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,IAAI,CAAC,0BAA0B,EAAE,kBAAkB,GAAG,SAAS,CAAC,EACzE,EAAC,eAAe,EAAE,EAAE,EAAE,MAAM,EAAC,EAAE,uBAAuB,GACrD,OAAO,CAAC,mBAAmB,CAAC,CAiE9B"}

package/lib/cmds/beacon/stateInitialization/genesisState.js

@@ -0,0 +1,65 @@
+import { persistAnchorState } from "@lodestar/beacon-node";
+import { createBeaconConfig } from "@lodestar/config";
+import { computeEpochAtSlot, computeWeakSubjectivitySummaryFromStateBytes, isWithinWeakSubjectivityPeriodFromSummary, readBeaconStateBytesMetadata, } from "@lodestar/state-transition";
+import { formatBytes, toRootHex } from "@lodestar/utils";
+import { getGenesisFileUrl, getGenesisStateRoot } from "../../../networks/index.js";
+import { defaultNetwork } from "../../../options/globalOptions.js";
+import { downloadOrLoadFile } from "../../../util/index.js";
+import { StateInitializationError, StateInitializationErrorCode } from "./errors.js";
+import { assertAnchorStateForkMatchesConfig } from "./validation.js";
+export async function prepareGenesisInitialization(options, { chainForkConfig, db, logger }) {
+    const source = options.genesisStateFile || getGenesisFileUrl(options.network || defaultNetwork);
+    if (!source) {
+        throw new StateInitializationError({ code: StateInitializationErrorCode.MISSING_INITIALIZATION_SOURCE }, "Failed to initialize beacon state, please provide a genesis state file or use checkpoint sync");
+    }
+    logger.info("Loading genesis state", { genesisStateFile: source });
+    const bytes = await downloadOrLoadFile(source);
+    const stateBytes = new Uint8Array(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    logger.info("Loaded genesis state", { size: formatBytes(stateBytes.length) });
+    const metadata = readBeaconStateBytesMetadata(stateBytes);
+    if (metadata === null) {
+        throw new StateInitializationError({ code: StateInitializationErrorCode.MALFORMED_STATE_BYTES }, "Cannot read metadata from genesis state bytes");
+    }
+    const weakSubjectivity = computeWeakSubjectivitySummaryFromStateBytes(chainForkConfig, stateBytes, metadata);
+    if (weakSubjectivity === null) {
+        throw new StateInitializationError({ code: StateInitializationErrorCode.MALFORMED_STATE_BYTES }, `Cannot extract weak subjectivity summary from genesis state bytes, expected ${chainForkConfig.getForkName(metadata.slot)} state at slot ${metadata.slot}, possible fork or network mismatch`);
+    }
+    const config = createBeaconConfig(chainForkConfig, metadata.genesisValidatorsRoot);
+    const expectedRoot = getGenesisStateRoot(options.network);
+    return {
+        stateBytes,
+        config,
+        isFinalized: true,
+        validate(state) {
+            const stateRoot = toRootHex(state.hashTreeRoot());
+            if (expectedRoot !== null && stateRoot !== expectedRoot) {
+                throw new StateInitializationError({ code: StateInitializationErrorCode.GENESIS_ROOT_MISMATCH }, `Genesis state root mismatch expected=${expectedRoot} received=${stateRoot}`);
+            }
+            assertAnchorStateForkMatchesConfig(config, state);
+            const passedValidation = isWithinWeakSubjectivityPeriodFromSummary(config, weakSubjectivity);
+            const logData = {
+                slot: state.slot,
+                epoch: computeEpochAtSlot(state.slot),
+                stateSize: formatBytes(stateBytes.length),
+                stateRoot,
+                isWithinWeakSubjectivityPeriod: passedValidation,
+            };
+            if (passedValidation) {
+                logger.info("Initializing beacon from a valid checkpoint state", logData);
+            }
+            else {
+                logger.warn("Initializing from a stale checkpoint state vulnerable to long range attacks", logData);
+                logger.warn("Checkpoint sync recommended, please use --help to see checkpoint sync options");
+            }
+        },
+        persist: (state, bytes) => persistAnchorState(config, db, state, bytes),
+        log(state) {
+            logger.info("Initialized genesis state", {
+                slot: state.slot,
+                stateRoot: toRootHex(state.hashTreeRoot()),
+                isFinalized: true,
+            });
+        },
+    };
+}
+//# sourceMappingURL=genesisState.js.map

package/lib/cmds/beacon/stateInitialization/genesisState.js.map

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

package/lib/cmds/beacon/stateInitialization/prepareStateInitialization.d.ts

@@ -0,0 +1,4 @@
+import { ArchivedStateBytes, StateInitialization, StateInitializationOptions, StatePreparationContext } from "./types.js";
+export declare function prepareArchivedStateInitialization({ stateBytes, metadata, isWithinWeakSubjectivityPeriod }: ArchivedStateBytes, { chainForkConfig, logger }: StatePreparationContext): StateInitialization;
+export declare function prepareCheckpointSourceInitialization(options: StateInitializationOptions, archived: ArchivedStateBytes | null, context: StatePreparationContext): Promise<StateInitialization | null>;
+//# sourceMappingURL=prepareStateInitialization.d.ts.map

package/lib/cmds/beacon/stateInitialization/prepareStateInitialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepareStateInitialization.d.ts","sourceRoot":"","sources":["../../../../src/cmds/beacon/stateInitialization/prepareStateInitialization.ts"],"names":[],"mappings":"AAQA,OAAO,EAAC,kBAAkB,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,uBAAuB,EAAC,MAAM,YAAY,CAAC;AAGxH,wBAAgB,kCAAkC,CAChD,EAAC,UAAU,EAAE,QAAQ,EAAE,8BAA8B,EAAC,EAAE,kBAAkB,EAC1E,EAAC,eAAe,EAAE,MAAM,EAAC,EAAE,uBAAuB,GACjD,mBAAmB,CAgCrB;AAED,wBAAsB,qCAAqC,CACzD,OAAO,EAAE,0BAA0B,EACnC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,EACnC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAWrC"}

package/lib/cmds/beacon/stateInitialization/prepareStateInitialization.js

@@ -0,0 +1,52 @@
+import { createBeaconConfig } from "@lodestar/config";
+import { computeEpochAtSlot } from "@lodestar/state-transition";
+import { formatBytes, toRootHex } from "@lodestar/utils";
+import { prepareCheckpointApiInitialization, prepareCheckpointFileInitialization, prepareUnfinalizedCheckpointInitialization, } from "./checkpointState.js";
+import { assertAnchorStateForkMatchesConfig } from "./validation.js";
+export function prepareArchivedStateInitialization({ stateBytes, metadata, isWithinWeakSubjectivityPeriod }, { chainForkConfig, logger }) {
+    const config = createBeaconConfig(chainForkConfig, metadata.genesisValidatorsRoot);
+    return {
+        stateBytes,
+        config,
+        isFinalized: true,
+        validate(state) {
+            assertAnchorStateForkMatchesConfig(config, state);
+            const logData = {
+                slot: state.slot,
+                epoch: computeEpochAtSlot(state.slot),
+                stateSize: formatBytes(stateBytes.length),
+                stateRoot: toRootHex(state.hashTreeRoot()),
+                isWithinWeakSubjectivityPeriod,
+            };
+            if (isWithinWeakSubjectivityPeriod) {
+                logger.info("Initializing beacon from a valid db state", logData);
+            }
+            else {
+                logger.warn("Initializing from a stale db state vulnerable to long range attacks", logData);
+                logger.warn("Checkpoint sync recommended, please use --help to see checkpoint sync options");
+            }
+        },
+        persist: null,
+        log(state) {
+            logger.info("Initialized state from db", {
+                slot: state.slot,
+                epoch: computeEpochAtSlot(state.slot),
+                stateRoot: toRootHex(state.hashTreeRoot()),
+                isFinalized: true,
+            });
+        },
+    };
+}
+export async function prepareCheckpointSourceInitialization(options, archived, context) {
+    if (options.checkpointState) {
+        return prepareCheckpointFileInitialization(options.checkpointState, options, archived, context);
+    }
+    if (options.checkpointSyncUrl) {
+        return prepareCheckpointApiInitialization(options.checkpointSyncUrl, options, archived, context);
+    }
+    if (options.lastPersistedCheckpointState || options.unsafeCheckpointState) {
+        return prepareUnfinalizedCheckpointInitialization(options, archived, context);
+    }
+    return null;
+}
+//# sourceMappingURL=prepareStateInitialization.js.map

package/lib/cmds/beacon/stateInitialization/prepareStateInitialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepareStateInitialization.js","sourceRoot":"","sources":["../../../../src/cmds/beacon/stateInitialization/prepareStateInitialization.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kBAAkB,EAAC,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAC,kBAAkB,EAAC,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAC,WAAW,EAAE,SAAS,EAAC,MAAM,iBAAiB,CAAC;AACvD,OAAO,EACL,kCAAkC,EAClC,mCAAmC,EACnC,0CAA0C,GAC3C,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAC,kCAAkC,EAAC,MAAM,iBAAiB,CAAC;AAEnE,MAAM,UAAU,kCAAkC,CAChD,EAAC,UAAU,EAAE,QAAQ,EAAE,8BAA8B,EAAqB,EAC1E,EAAC,eAAe,EAAE,MAAM,EAA0B;IAElD,MAAM,MAAM,GAAG,kBAAkB,CAAC,eAAe,EAAE,QAAQ,CAAC,qBAAqB,CAAC,CAAC;IACnF,OAAO;QACL,UAAU;QACV,MAAM;QACN,WAAW,EAAE,IAAI;QACjB,QAAQ,CAAC,KAAK;YACZ,kCAAkC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAClD,MAAM,OAAO,GAAG;gBACd,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,KAAK,EAAE,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC;gBACrC,SAAS,EAAE,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC;gBACzC,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;gBAC1C,8BAA8B;aAC/B,CAAC;YACF,IAAI,8BAA8B,EAAE,CAAC;gBACnC,MAAM,CAAC,IAAI,CAAC,2CAA2C,EAAE,OAAO,CAAC,CAAC;YACpE,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,qEAAqE,EAAE,OAAO,CAAC,CAAC;gBAC5F,MAAM,CAAC,IAAI,CAAC,+EAA+E,CAAC,CAAC;YAC/F,CAAC;QACH,CAAC;QACD,OAAO,EAAE,IAAI;QACb,GAAG,CAAC,KAAK;YACP,MAAM,CAAC,IAAI,CAAC,2BAA2B,EAAE;gBACvC,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,KAAK,EAAE,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC;gBACrC,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;gBAC1C,WAAW,EAAE,IAAI;aAClB,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qCAAqC,CACzD,OAAmC,EACnC,QAAmC,EACnC,OAAgC;IAEhC,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;QAC5B,OAAO,mCAAmC,CAAC,OAAO,CAAC,eAAe,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAClG,CAAC;IACD,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;QAC9B,OAAO,kCAAkC,CAAC,OAAO,CAAC,iBAAiB,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACnG,CAAC;IACD,IAAI,OAAO,CAAC,4BAA4B,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;QAC1E,OAAO,0CAA0C,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/lib/cmds/beacon/stateInitialization/types.d.ts

@@ -0,0 +1,40 @@
+import { IBeaconDb } from "@lodestar/beacon-node";
+import { BeaconConfig, ChainForkConfig } from "@lodestar/config";
+import { IBeaconStateView, StateBytesMetadata, WeakSubjectivitySummary } from "@lodestar/state-transition";
+import { Checkpoint } from "@lodestar/types/phase0";
+import { Logger } from "@lodestar/utils";
+import { GlobalArgs } from "../../../options/globalOptions.js";
+import { BeaconArgs } from "../options.js";
+export type StateInitializationOptions = Pick<BeaconArgs & GlobalArgs, "checkpointState" | "checkpointSyncUrl" | "unsafeCheckpointState" | "lastPersistedCheckpointState" | "genesisStateFile" | "wssCheckpoint" | "forceCheckpointSync" | "ignoreWeakSubjectivityCheck" | "network" | "chain.nHistoricalStatesFileDataStore" | "chain.nativeStateView">;
+export type StatePreparationContext = {
+    chainForkConfig: ChainForkConfig;
+    db: IBeaconDb;
+    dataDir: string;
+    logger: Logger;
+};
+export type ArchivedStateBytes = {
+    stateBytes: Uint8Array;
+    metadata: StateBytesMetadata;
+    weakSubjectivity: WeakSubjectivitySummary;
+    isWithinWeakSubjectivityPeriod: boolean;
+};
+export type CheckpointStateBytesCandidate = {
+    stateBytes: Uint8Array;
+    expectedCheckpoint: Checkpoint | null;
+    source: "checkpoint file" | "checkpointSyncUrl" | "unfinalized source";
+};
+export type CheckpointStartupPolicy = {
+    isFinalized: boolean;
+    forceCheckpointSync: boolean;
+    ignoreWeakSubjectivityCheck: boolean;
+};
+/** Selected state bytes and source-specific initialization steps. */
+export type StateInitialization = {
+    stateBytes: Uint8Array;
+    config: BeaconConfig;
+    isFinalized: boolean;
+    validate: (state: IBeaconStateView) => void;
+    persist: ((state: IBeaconStateView, stateBytes: Uint8Array) => Promise<void>) | null;
+    log: (state: IBeaconStateView) => void;
+};
+//# sourceMappingURL=types.d.ts.map

package/lib/cmds/beacon/stateInitialization/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/cmds/beacon/stateInitialization/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAC,YAAY,EAAE,eAAe,EAAC,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAC,gBAAgB,EAAE,kBAAkB,EAAE,uBAAuB,EAAC,MAAM,4BAA4B,CAAC;AACzG,OAAO,EAAC,UAAU,EAAC,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAC,MAAM,EAAC,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAC,UAAU,EAAC,MAAM,mCAAmC,CAAC;AAC7D,OAAO,EAAC,UAAU,EAAC,MAAM,eAAe,CAAC;AAEzC,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAC3C,UAAU,GAAG,UAAU,EACrB,iBAAiB,GACjB,mBAAmB,GACnB,uBAAuB,GACvB,8BAA8B,GAC9B,kBAAkB,GAClB,eAAe,GACf,qBAAqB,GACrB,6BAA6B,GAC7B,SAAS,GACT,sCAAsC,GACtC,uBAAuB,CAC1B,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,eAAe,EAAE,eAAe,CAAC;IACjC,EAAE,EAAE,SAAS,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,gBAAgB,EAAE,uBAAuB,CAAC;IAC1C,8BAA8B,EAAE,OAAO,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,UAAU,EAAE,UAAU,CAAC;IACvB,kBAAkB,EAAE,UAAU,GAAG,IAAI,CAAC;IACtC,MAAM,EAAE,iBAAiB,GAAG,mBAAmB,GAAG,oBAAoB,CAAC;CACxE,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,WAAW,EAAE,OAAO,CAAC;IACrB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,2BAA2B,EAAE,OAAO,CAAC;CACtC,CAAC;AAEF,qEAAqE;AACrE,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IACrF,GAAG,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACxC,CAAC"}

package/lib/cmds/beacon/stateInitialization/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib/cmds/beacon/stateInitialization/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/cmds/beacon/stateInitialization/types.ts"],"names":[],"mappings":""}

package/lib/cmds/beacon/stateInitialization/validation.d.ts

@@ -0,0 +1,4 @@
+import { ChainForkConfig } from "@lodestar/config";
+import { IBeaconStateView } from "@lodestar/state-transition";
+export declare function assertAnchorStateForkMatchesConfig(config: ChainForkConfig, anchorState: IBeaconStateView): void;
+//# sourceMappingURL=validation.d.ts.map

package/lib/cmds/beacon/stateInitialization/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/cmds/beacon/stateInitialization/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,eAAe,EAAC,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAC,gBAAgB,EAA0B,MAAM,4BAA4B,CAAC;AAIrF,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,eAAe,EAAE,WAAW,EAAE,gBAAgB,GAAG,IAAI,CAU/G"}

package/lib/cmds/beacon/stateInitialization/validation.js

@@ -0,0 +1,12 @@
+import { computeStartSlotAtEpoch } from "@lodestar/state-transition";
+import { toHex } from "@lodestar/utils";
+import { StateInitializationError, StateInitializationErrorCode } from "./errors.js";
+export function assertAnchorStateForkMatchesConfig(config, anchorState) {
+    const expectedFork = config.getForkInfo(computeStartSlotAtEpoch(anchorState.fork.epoch));
+    const expectedForkVersion = toHex(expectedFork.version);
+    const stateFork = toHex(anchorState.fork.currentVersion);
+    if (stateFork !== expectedForkVersion) {
+        throw new StateInitializationError({ code: StateInitializationErrorCode.ANCHOR_STATE_FORK_MISMATCH }, `State current fork version ${stateFork} not equal to current config ${expectedForkVersion}. Maybe caused by importing a state from a different network`);
+    }
+}
+//# sourceMappingURL=validation.js.map

package/lib/cmds/beacon/stateInitialization/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../../src/cmds/beacon/stateInitialization/validation.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,uBAAuB,EAAC,MAAM,4BAA4B,CAAC;AACrF,OAAO,EAAC,KAAK,EAAC,MAAM,iBAAiB,CAAC;AACtC,OAAO,EAAC,wBAAwB,EAAE,4BAA4B,EAAC,MAAM,aAAa,CAAC;AAEnF,MAAM,UAAU,kCAAkC,CAAC,MAAuB,EAAE,WAA6B;IACvG,MAAM,YAAY,GAAG,MAAM,CAAC,WAAW,CAAC,uBAAuB,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACzF,MAAM,mBAAmB,GAAG,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IACxD,MAAM,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACzD,IAAI,SAAS,KAAK,mBAAmB,EAAE,CAAC;QACtC,MAAM,IAAI,wBAAwB,CAChC,EAAC,IAAI,EAAE,4BAA4B,CAAC,0BAA0B,EAAC,EAC/D,8BAA8B,SAAS,gCAAgC,mBAAmB,8DAA8D,CACzJ,CAAC;IACJ,CAAC;AACH,CAAC"}

package/lib/networks/index.d.ts

@@ -1,5 +1,4 @@
 import { ChainConfig, ChainForkConfig } from "@lodestar/config";
-import { BeaconStateAllForks } from "@lodestar/state-transition";
 import { Checkpoint } from "@lodestar/types/phase0";
 import { Logger } from "@lodestar/utils";
 export type NetworkName = "mainnet" | "dev" | "gnosis" | "sepolia" | "hoodi" | "plataberget" | "chiado" | "ephemery";
@@ -40,17 +39,12 @@ export declare function readBootnodes(bootnodesFilePath: string): string[];
 /**
  * Fetch weak subjectivity state from a remote beacon node
  */
-export declare function fetchWeakSubjectivityState(config: ChainForkConfig, logger: Logger, { checkpointSyncUrl, wssCheckpoint }: {
+export declare function fetchWeakSubjectivityStateBytes(config: ChainForkConfig, logger: Logger, { checkpointSyncUrl, wssCheckpoint }: {
     checkpointSyncUrl: string;
     wssCheckpoint?: string;
-}, { lastDbState, lastDbValidatorsBytes, }: {
-    lastDbState: BeaconStateAllForks | null;
-    lastDbValidatorsBytes: Uint8Array | null;
 }): Promise<{
-    wsState: BeaconStateAllForks;
-    wsStateBytes: Uint8Array;
-    wsCheckpoint: Checkpoint;
+    stateBytes: Uint8Array;
+    expectedCheckpoint: Checkpoint | null;
 }>;
 export declare function getCheckpointFromArg(checkpointStr: string): Checkpoint;
-export declare function getCheckpointFromState(state: BeaconStateAllForks): Checkpoint;
 //# sourceMappingURL=index.d.ts.map

package/lib/networks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/networks/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,WAAW,EAAE,eAAe,EAAC,MAAM,kBAAkB,CAAC;AAE9D,OAAO,EACL,mBAAmB,EAIpB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAC,UAAU,EAAC,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAC,MAAM,EAA+C,MAAM,iBAAiB,CAAC;AAWrF,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,aAAa,GAAG,QAAQ,GAAG,UAAU,CAAC;AACrH,eAAO,MAAM,YAAY,EAAE,WAAW,EAWrC,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,IAAI,WAAW,CAE1E;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,yBAAyB,EAAE,MAAM,CAAC;IAClC,0BAA0B,CAAC,EAAE,MAAM,CAAC;CACrC,CAAC;AAKF,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG;IACpD,WAAW,EAAE,WAAW,CAAC;IACzB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAqBA;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,CAExE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAErE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAKnF;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAY5E;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAcjF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,iBAAiB,EAAE,MAAM,GAAG,MAAM,EAAE,CAiBjE;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,MAAM,EACd,EAAC,iBAAiB,EAAE,aAAa,EAAC,EAAE;IAAC,iBAAiB,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAC,EACvF,EACE,WAAW,EACX,qBAAqB,GACtB,EAAE;IAAC,WAAW,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAAC,qBAAqB,EAAE,UAAU,GAAG,IAAI,CAAA;CAAC,GACrF,OAAO,CAAC;IAAC,OAAO,EAAE,mBAAmB,CAAC;IAAC,YAAY,EAAE,UAAU,CAAC;IAAC,YAAY,EAAE,UAAU,CAAA;CAAC,CAAC,CA8C7F;AAED,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,UAAU,CAOtE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,mBAAmB,GAAG,UAAU,CAO7E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/networks/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,WAAW,EAAE,eAAe,EAAC,MAAM,kBAAkB,CAAC;AAG9D,OAAO,EAAC,UAAU,EAAC,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAgB,MAAM,EAA+C,MAAM,iBAAiB,CAAC;AAWpG,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,aAAa,GAAG,QAAQ,GAAG,UAAU,CAAC;AACrH,eAAO,MAAM,YAAY,EAAE,WAAW,EAWrC,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,IAAI,WAAW,CAE1E;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,yBAAyB,EAAE,MAAM,CAAC;IAClC,0BAA0B,CAAC,EAAE,MAAM,CAAC;CACrC,CAAC;AAKF,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG;IACpD,WAAW,EAAE,WAAW,CAAC;IACzB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAqBA;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,CAExE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAErE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAKnF;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAY5E;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAcjF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,iBAAiB,EAAE,MAAM,GAAG,MAAM,EAAE,CAiBjE;AAED;;GAEG;AACH,wBAAsB,+BAA+B,CACnD,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,MAAM,EACd,EAAC,iBAAiB,EAAE,aAAa,EAAC,EAAE;IAAC,iBAAiB,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAC,GACtF,OAAO,CAAC;IAAC,UAAU,EAAE,UAAU,CAAC;IAAC,kBAAkB,EAAE,UAAU,GAAG,IAAI,CAAA;CAAC,CAAC,CAkD1E;AAED,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,UAAU,CAOtE"}

package/lib/networks/index.js

@@ -3,9 +3,7 @@ import { ENR } from "@chainsafe/enr";
 import { WireFormat, getClient } from "@lodestar/api";
 import { getStateSlotFromBytes } from "@lodestar/beacon-node";
 import { SLOTS_PER_EPOCH } from "@lodestar/params";
-import { computeCheckpointEpochAtStateSlot, getLatestBlockRoot, loadState, } from "@lodestar/state-transition";
-import { sszTypesFor } from "@lodestar/types";
-import { callFnWhenAwait, fetch, formatBytes, fromHex } from "@lodestar/utils";
+import { LodestarError, callFnWhenAwait, fetch, formatBytes, fromHex } from "@lodestar/utils";
 import { parseBootnodesFile } from "../util/format.js";
 import * as chiado from "./chiado.js";
 import * as dev from "./dev.js";
@@ -125,7 +123,7 @@ export function readBootnodes(bootnodesFilePath) {
 /**
  * Fetch weak subjectivity state from a remote beacon node
  */
-export async function fetchWeakSubjectivityState(config, logger, { checkpointSyncUrl, wssCheckpoint }, { lastDbState, lastDbValidatorsBytes, }) {
+export async function fetchWeakSubjectivityStateBytes(config, logger, { checkpointSyncUrl, wssCheckpoint }) {
     try {
         let wsCheckpoint;
         let stateId;
@@ -135,50 +133,39 @@ export async function fetchWeakSubjectivityState(config, logger, { checkpointSyn
             stateId = wsCheckpoint.epoch * SLOTS_PER_EPOCH;
         }
         else {
-            // Fetch current finalized state and extract checkpoint from it
+            // Checkpoint identity can be derived after the selected state is constructed.
             stateId = "finalized";
             wsCheckpoint = null;
         }
         // getStateV2 should be available for all forks including phase0
         const getStatePromise = api.debug.getStateV2({ stateId }, { responseWireFormat: WireFormat.ssz });
-        const { wsStateBytes, fork } = await callFnWhenAwait(getStatePromise, () => logger.info("Download in progress, please wait..."), GET_STATE_LOG_INTERVAL).then((res) => {
-            return { wsStateBytes: res.ssz(), fork: res.meta().version };
-        });
+        const response = await callFnWhenAwait(getStatePromise, () => logger.info("Download in progress, please wait..."), GET_STATE_LOG_INTERVAL);
+        const wsStateBytes = response.ssz();
+        const { version } = response.meta();
         const wsSlot = getStateSlotFromBytes(wsStateBytes);
         const logData = { stateId, size: formatBytes(wsStateBytes.length) };
         logger.info("Download completed", typeof stateId === "number" ? logData : { ...logData, slot: wsSlot });
-        let wsState;
-        if (lastDbState && lastDbValidatorsBytes) {
-            // use lastDbState to load wsState if possible to share the same state tree
-            wsState = loadState(config, lastDbState, wsStateBytes, lastDbValidatorsBytes).state;
-        }
-        else {
-            wsState = sszTypesFor(fork).BeaconState.deserializeToViewDU(wsStateBytes);
+        const expectedFork = config.getForkName(wsSlot);
+        if (version !== expectedFork) {
+            throw new LodestarError({ code: "CHECKPOINT_FORK_MISMATCH" }, `Checkpoint sync server returned ${version} state at slot ${wsSlot} but local config expects ${expectedFork}, verify --network or the chain config`);
         }
         return {
-            wsState,
-            wsStateBytes,
-            wsCheckpoint: wsCheckpoint ?? getCheckpointFromState(wsState),
+            stateBytes: new Uint8Array(wsStateBytes.buffer, wsStateBytes.byteOffset, wsStateBytes.byteLength),
+            expectedCheckpoint: wsCheckpoint,
         };
     }
     catch (e) {
-        throw new Error("Unable to fetch weak subjectivity state: " + e.message);
+        const error = new LodestarError({ code: "CHECKPOINT_DOWNLOAD_FAILED" }, "Unable to fetch weak subjectivity state: " + e.message);
+        error.cause = e;
+        throw error;
     }
 }
 export function getCheckpointFromArg(checkpointStr) {
     const checkpointRegex = /^(?:0x)?([0-9a-f]{64}):([0-9]+)$/;
     const match = checkpointRegex.exec(checkpointStr.toLowerCase());
     if (!match) {
-        throw new Error(`Could not parse checkpoint string: ${checkpointStr}`);
+        throw new LodestarError({ code: "INVALID_CHECKPOINT" }, `Could not parse checkpoint string: ${checkpointStr}`);
     }
     return { root: fromHex(match[1]), epoch: parseInt(match[2]) };
 }
-export function getCheckpointFromState(state) {
-    return {
-        // the correct checkpoint is based on state's slot, its latestBlockHeader's slot's epoch can be
-        // behind the state
-        epoch: computeCheckpointEpochAtStateSlot(state.slot),
-        root: getLatestBlockRoot(state),
-    };
-}
 //# sourceMappingURL=index.js.map