@lodestar/state-transition 1.42.0-dev.7df0e2c8fa → 1.42.0-dev.8300b502a6

package/lib/stateView/interface.d.ts

@@ -1,5 +1,6 @@
 import { CompactMultiProof } from "@chainsafe/persistent-merkle-tree";
 import { BitArray, ByteViews } from "@chainsafe/ssz";
+import { ForkName, ForkPostAltair, ForkPostBellatrix, ForkPostCapella, ForkPostDeneb, ForkPostElectra, ForkPostFulu, ForkPostGloas } from "@lodestar/params";
 import { BeaconBlock, BeaconState, BlindedBeaconBlock, BuilderIndex, Bytes32, Epoch, ExecutionPayloadBid, ExecutionPayloadHeader, Root, RootHex, SignedBeaconBlock, SignedBlindedBeaconBlock, Slot, ValidatorIndex, altair, capella, electra, fulu, gloas, phase0, rewards } from "@lodestar/types";
 import { Checkpoint, Fork } from "@lodestar/types/phase0";
 import { ProcessExecutionPayloadEnvelopeOpts } from "../block/processExecutionPayloadEnvelope.js";
@@ -15,6 +16,7 @@ import { EpochShuffling } from "../util/epochShuffling.js";
  * A read-only view of the BeaconState.
  */
 export interface IBeaconStateView {
+    forkName: ForkName;
     slot: Slot;
     fork: Fork;
     epoch: Epoch;
@@ -29,38 +31,6 @@ export interface IBeaconStateView {
     getBlockRootAtEpoch(epoch: Epoch): Root;
     getStateRootAtSlot(slot: Slot): Root;
     getRandaoMix(epoch: Epoch): Bytes32;
-    previousEpochParticipation: Uint8Array;
-    currentEpochParticipation: Uint8Array;
-    getPreviousEpochParticipation(validatorIndex: ValidatorIndex): number;
-    getCurrentEpochParticipation(validatorIndex: ValidatorIndex): number;
-    latestExecutionPayloadHeader: ExecutionPayloadHeader;
-    /**
-     * Cross-fork accessor for the execution block hash of the most recently included payload.
-     * Pre-gloas: returns latestExecutionPayloadHeader.blockHash (bellatrix–fulu).
-     * Gloas+: returns the dedicated latestBlockHash state field (EIP-7732).
-     * Throws before bellatrix.
-     */
-    latestBlockHash: Bytes32;
-    /**
-     * The execution block number of the most recently included payload.
-     * Named payloadBlockNumber (not latestBlockNumber) to mirror ExecutionPayloadHeader.blockNumber pre-gloas.
-     * Only available from bellatrix through fulu — not tracked on BeaconState in gloas+ (EIP-7732).
-     * Throws before bellatrix and from gloas onwards.
-     */
-    payloadBlockNumber: number;
-    historicalSummaries: capella.HistoricalSummaries;
-    pendingDeposits: electra.PendingDeposits;
-    pendingDepositsCount: number;
-    pendingPartialWithdrawals: electra.PendingPartialWithdrawals;
-    pendingPartialWithdrawalsCount: number;
-    pendingConsolidations: electra.PendingConsolidations;
-    pendingConsolidationsCount: number;
-    proposerLookahead: fulu.ProposerLookahead;
-    executionPayloadAvailability: BitArray;
-    latestExecutionPayloadBid: ExecutionPayloadBid;
-    getBuilder(index: BuilderIndex): gloas.Builder;
-    canBuilderCoverBid(builderIndex: BuilderIndex, bidAmount: number): boolean;
-    getIndexInPayloadTimelinessCommittee(validatorIndex: ValidatorIndex, slot: Slot): number;
     getShufflingAtEpoch(epoch: Epoch): EpochShuffling;
     previousDecisionRoot: RootHex;
     currentDecisionRoot: RootHex;
@@ -73,13 +43,6 @@ export interface IBeaconStateView {
     currentProposers: ValidatorIndex[];
     nextProposers: ValidatorIndex[];
     getBeaconProposer(slot: Slot): ValidatorIndex;
-    currentSyncCommittee: altair.SyncCommittee;
-    nextSyncCommittee: altair.SyncCommittee;
-    currentSyncCommitteeIndexed: SyncCommitteeCache;
-    syncProposerReward: number;
-    getIndexedSyncCommitteeAtEpoch(epoch: Epoch): SyncCommitteeCache;
-    /** Get indexed sync committee with slot+1 offset for duty lookups */
-    getIndexedSyncCommittee(slot: Slot): SyncCommitteeCache;
     effectiveBalanceIncrements: EffectiveBalanceIncrements;
     getEffectiveBalanceIncrementsZeroInactive(): EffectiveBalanceIncrements;
     getBalance(index: number): number;
@@ -89,25 +52,13 @@ export interface IBeaconStateView {
     activeValidatorCount: number;
     getAllValidators(): phase0.Validator[];
     getAllBalances(): number[];
-    isExecutionStateType: boolean;
-    isMergeTransitionComplete: boolean;
-    isExecutionEnabled(block: BeaconBlock | BlindedBeaconBlock): boolean;
-    getExpectedWithdrawals(): {
-        expectedWithdrawals: capella.Withdrawal[];
-        processedBuilderWithdrawalsCount: number;
-        processedPartialWithdrawalsCount: number;
-        processedBuildersSweepCount: number;
-        processedValidatorSweepCount: number;
-    };
     proposerRewards: RewardCache;
     computeBlockRewards(block: BeaconBlock, proposerRewards?: RewardCache): Promise<rewards.BlockRewards>;
     computeAttestationsRewards(validatorIds?: (ValidatorIndex | string)[]): Promise<rewards.AttestationsRewards>;
-    computeSyncCommitteeRewards(block: BeaconBlock, validatorIds: (ValidatorIndex | string)[]): Promise<rewards.SyncCommitteeRewards>;
     getLatestWeakSubjectivityCheckpointEpoch(): Epoch;
     getVoluntaryExitValidity(signedVoluntaryExit: phase0.SignedVoluntaryExit, verifySignature: boolean): VoluntaryExitValidity;
     isValidVoluntaryExit(signedVoluntaryExit: phase0.SignedVoluntaryExit, verifySignature: boolean): boolean;
     getFinalizedRootProof(): Uint8Array[];
-    getSyncCommitteesWitness(): SyncCommitteeWitness;
     getSingleProof(gindex: bigint): Uint8Array[];
     createMultiProof(descriptor: Uint8Array): CompactMultiProof;
     computeUnrealizedCheckpoints(): {
@@ -135,6 +86,102 @@ export interface IBeaconStateView {
     processSlots(slot: Slot, epochTransitionCacheOpts?: EpochTransitionCacheOpts & {
         dontTransferCache?: boolean;
     }, modules?: StateTransitionModules): IBeaconStateView;
+}
+/** Altair+ state fields — use isStatePostAltair() guard */
+export interface IBeaconStateViewAltair extends IBeaconStateView {
+    forkName: ForkPostAltair;
+    previousEpochParticipation: Uint8Array;
+    currentEpochParticipation: Uint8Array;
+    getPreviousEpochParticipation(validatorIndex: ValidatorIndex): number;
+    getCurrentEpochParticipation(validatorIndex: ValidatorIndex): number;
+    currentSyncCommittee: altair.SyncCommittee;
+    nextSyncCommittee: altair.SyncCommittee;
+    currentSyncCommitteeIndexed: SyncCommitteeCache;
+    syncProposerReward: number;
+    getIndexedSyncCommitteeAtEpoch(epoch: Epoch): SyncCommitteeCache;
+    /** Get indexed sync committee with slot+1 offset for duty lookups */
+    getIndexedSyncCommittee(slot: Slot): SyncCommitteeCache;
+    computeSyncCommitteeRewards(block: BeaconBlock, validatorIds: (ValidatorIndex | string)[]): Promise<rewards.SyncCommitteeRewards>;
+    getSyncCommitteesWitness(): SyncCommitteeWitness;
+}
+/** Bellatrix+ state fields — use isStatePostBellatrix() guard */
+export interface IBeaconStateViewBellatrix extends IBeaconStateViewAltair {
+    forkName: ForkPostBellatrix;
+    latestExecutionPayloadHeader: ExecutionPayloadHeader;
+    /**
+     * Cross-fork accessor for the execution block hash of the most recently included payload.
+     * Pre-gloas: returns latestExecutionPayloadHeader.blockHash (bellatrix–fulu).
+     * Gloas+: returns the dedicated latestBlockHash state field (EIP-7732).
+     * Throws before bellatrix.
+     */
+    latestBlockHash: Bytes32;
+    /**
+     * The execution block number of the most recently included payload.
+     * Named payloadBlockNumber (not latestBlockNumber) to mirror ExecutionPayloadHeader.blockNumber pre-gloas.
+     * Only available from bellatrix through fulu — not tracked on BeaconState in gloas+ (EIP-7732).
+     * Throws before bellatrix and from gloas onwards.
+     */
+    payloadBlockNumber: number;
+    isExecutionStateType: boolean;
+    isMergeTransitionComplete: boolean;
+    isExecutionEnabled(block: BeaconBlock | BlindedBeaconBlock): boolean;
+}
+/** Capella+ state fields — use isStatePostCapella() guard */
+export interface IBeaconStateViewCapella extends IBeaconStateViewBellatrix {
+    forkName: ForkPostCapella;
+    historicalSummaries: capella.HistoricalSummaries;
+    getExpectedWithdrawals(): {
+        expectedWithdrawals: capella.Withdrawal[];
+        processedBuilderWithdrawalsCount: number;
+        processedPartialWithdrawalsCount: number;
+        processedBuildersSweepCount: number;
+        processedValidatorSweepCount: number;
+    };
+}
+/** Deneb+ state — no new state-view fields; placeholder for fork completeness and isStatePostDeneb() narrowing */
+export interface IBeaconStateViewDeneb extends IBeaconStateViewCapella {
+    forkName: ForkPostDeneb;
+}
+/** Electra+ state fields — use isStatePostElectra() guard */
+export interface IBeaconStateViewElectra extends IBeaconStateViewDeneb {
+    forkName: ForkPostElectra;
+    pendingDeposits: electra.PendingDeposits;
+    pendingDepositsCount: number;
+    pendingPartialWithdrawals: electra.PendingPartialWithdrawals;
+    pendingPartialWithdrawalsCount: number;
+    pendingConsolidations: electra.PendingConsolidations;
+    pendingConsolidationsCount: number;
+}
+/** Fulu+ state fields — use isStatePostFulu() guard */
+export interface IBeaconStateViewFulu extends IBeaconStateViewElectra {
+    forkName: ForkPostFulu;
+    proposerLookahead: fulu.ProposerLookahead;
+}
+/** Gloas+ state fields — use isStatePostGloas() guard */
+export interface IBeaconStateViewGloas extends IBeaconStateViewFulu {
+    forkName: ForkPostGloas;
+    executionPayloadAvailability: BitArray;
+    latestExecutionPayloadBid: ExecutionPayloadBid;
+    payloadExpectedWithdrawals: capella.Withdrawal[];
+    getBuilder(index: BuilderIndex): gloas.Builder;
+    canBuilderCoverBid(builderIndex: BuilderIndex, bidAmount: number): boolean;
+    getIndexInPayloadTimelinessCommittee(validatorIndex: ValidatorIndex, slot: Slot): number;
     processExecutionPayloadEnvelope(signedEnvelope: gloas.SignedExecutionPayloadEnvelope, opts?: ProcessExecutionPayloadEnvelopeOpts): IBeaconStateView;
 }
+/**
+ * Type constraint for the concrete BeaconStateView class.
+ * Requires all fields from the latest fork interface (IBeaconStateViewGloas) but keeps
+ * forkName as ForkName since the class wraps any fork's state.
+ * Sub-interfaces retain their narrowed forkName discriminants for caller-side type guards.
+ */
+export type IBeaconStateViewLatestFork = Omit<IBeaconStateViewGloas, "forkName"> & {
+    forkName: ForkName;
+};
+export declare function isStatePostAltair(state: IBeaconStateView): state is IBeaconStateViewAltair;
+export declare function isStatePostBellatrix(state: IBeaconStateView): state is IBeaconStateViewBellatrix;
+export declare function isStatePostCapella(state: IBeaconStateView): state is IBeaconStateViewCapella;
+export declare function isStatePostDeneb(state: IBeaconStateView): state is IBeaconStateViewDeneb;
+export declare function isStatePostElectra(state: IBeaconStateView): state is IBeaconStateViewElectra;
+export declare function isStatePostFulu(state: IBeaconStateView): state is IBeaconStateViewFulu;
+export declare function isStatePostGloas(state: IBeaconStateView): state is IBeaconStateViewGloas;
 //# sourceMappingURL=interface.d.ts.map

package/lib/stateView/interface.d.ts.map

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

package/lib/stateView/interface.js

@@ -1,2 +1,23 @@
-export {};
+import { isForkPostAltair, isForkPostBellatrix, isForkPostCapella, isForkPostDeneb, isForkPostElectra, isForkPostFulu, isForkPostGloas, } from "@lodestar/params";
+export function isStatePostAltair(state) {
+    return isForkPostAltair(state.forkName);
+}
+export function isStatePostBellatrix(state) {
+    return isForkPostBellatrix(state.forkName);
+}
+export function isStatePostCapella(state) {
+    return isForkPostCapella(state.forkName);
+}
+export function isStatePostDeneb(state) {
+    return isForkPostDeneb(state.forkName);
+}
+export function isStatePostElectra(state) {
+    return isForkPostElectra(state.forkName);
+}
+export function isStatePostFulu(state) {
+    return isForkPostFulu(state.forkName);
+}
+export function isStatePostGloas(state) {
+    return isForkPostGloas(state.forkName);
+}
 //# sourceMappingURL=interface.js.map

package/lib/stateView/interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../src/stateView/interface.ts"],"names":[],"mappings":""}
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../src/stateView/interface.ts"],"names":[],"mappings":"AAEA,OAAO,EASL,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAuP1B,MAAM,UAAU,iBAAiB,CAAC,KAAuB,EAAmC;IAC1F,OAAO,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AAAA,CACzC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAuB,EAAsC;IAChG,OAAO,mBAAmB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AAAA,CAC5C;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAuB,EAAoC;IAC5F,OAAO,iBAAiB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AAAA,CAC1C;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAuB,EAAkC;IACxF,OAAO,eAAe,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AAAA,CACxC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAuB,EAAoC;IAC5F,OAAO,iBAAiB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AAAA,CAC1C;AAED,MAAM,UAAU,eAAe,CAAC,KAAuB,EAAiC;IACtF,OAAO,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AAAA,CACvC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAuB,EAAkC;IACxF,OAAO,eAAe,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AAAA,CACxC"}

package/lib/stateView/stateViewFactory.d.ts

@@ -0,0 +1,40 @@
+import { BeaconConfig } from "@lodestar/config";
+import { PubkeyCache } from "../cache/pubkeyCache.js";
+import { BeaconStateAllForks } from "../cache/types.js";
+import { IBeaconStateView } from "./interface.js";
+type NodeJSOpts = {
+    useNative: false;
+    anchorState: BeaconStateAllForks;
+    config: BeaconConfig;
+    pubkeyCache: PubkeyCache;
+};
+type NativeOpts = {
+    useNative: true;
+    stateBytes: Uint8Array;
+};
+/**
+ * Create a BeaconStateView from a pre-deserialized state. Used at node startup.
+ *
+ * The caller is responsible for creating and populating `pubkeyCache` (it is also
+ * passed separately to BeaconNode.init, so it must live outside this factory).
+ *
+ * Set `useNative: true` to use the native (Zig) implementation once available.
+ */
+export declare function createBeaconStateView(opts: NodeJSOpts | NativeOpts): IBeaconStateView;
+type RegenNodeJSOpts = {
+    useNative: false;
+    config: BeaconConfig;
+    stateBytes: Uint8Array;
+};
+type RegenNativeOpts = {
+    useNative: true;
+    stateBytes: Uint8Array;
+};
+/**
+ * Create a BeaconStateView from raw SSZ bytes. Used in the historical state regen worker thread.
+ *
+ * Set `useNative: true` to use the native (Zig) implementation once available.
+ */
+export declare function createBeaconStateViewForHistoricalRegen(opts: RegenNodeJSOpts | RegenNativeOpts): IBeaconStateView;
+export {};
+//# sourceMappingURL=stateViewFactory.d.ts.map

package/lib/stateView/stateViewFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateViewFactory.d.ts","sourceRoot":"","sources":["../../src/stateView/stateViewFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAC,WAAW,EAAoB,MAAM,yBAAyB,CAAC;AAEvE,OAAO,EAAC,mBAAmB,EAAC,MAAM,mBAAmB,CAAC;AAGtD,OAAO,EAAC,gBAAgB,EAAC,MAAM,gBAAgB,CAAC;AAIhD,KAAK,UAAU,GAAG;IAChB,SAAS,EAAE,KAAK,CAAC;IACjB,WAAW,EAAE,mBAAmB,CAAC;IACjC,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;CAC1B,CAAC;AAEF,KAAK,UAAU,GAAG;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,UAAU,EAAE,UAAU,CAAC;CACxB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,gBAAgB,CAOrF;AAeD,KAAK,eAAe,GAAG;IACrB,SAAS,EAAE,KAAK,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,UAAU,CAAC;CACxB,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,SAAS,EAAE,IAAI,CAAC;IAChB,UAAU,EAAE,UAAU,CAAC;CACxB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,uCAAuC,CAAC,IAAI,EAAE,eAAe,GAAG,eAAe,GAAG,gBAAgB,CASjH"}

package/lib/stateView/stateViewFactory.js

@@ -0,0 +1,46 @@
+import { createPubkeyCache } from "../cache/pubkeyCache.js";
+import { createCachedBeaconState } from "../cache/stateCache.js";
+import { getStateTypeFromBytes } from "../util/sszBytes.js";
+import { BeaconStateView } from "./beaconStateView.js";
+/**
+ * Create a BeaconStateView from a pre-deserialized state. Used at node startup.
+ *
+ * The caller is responsible for creating and populating `pubkeyCache` (it is also
+ * passed separately to BeaconNode.init, so it must live outside this factory).
+ *
+ * Set `useNative: true` to use the native (Zig) implementation once available.
+ */
+export function createBeaconStateView(opts) {
+    if (opts.useNative) {
+        throw new Error("Native (Zig) BeaconStateView not yet implemented");
+    }
+    const { anchorState, config, pubkeyCache } = opts;
+    const cachedState = createCachedBeaconState(anchorState, { config, pubkeyCache }, { skipSyncPubkeys: true });
+    return new BeaconStateView(cachedState);
+}
+// ---- createBeaconStateViewForHistoricalRegen (regen path) ----
+// Reused across all historical state regen calls in the worker thread
+const pubkeyCacheRegen = createPubkeyCache();
+function syncPubkeyCache(state, pubkeyCache) {
+    const newCount = state.validators.length;
+    for (let i = pubkeyCache.size; i < newCount; i++) {
+        const pubkey = state.validators.getReadonly(i).pubkey;
+        pubkeyCache.set(i, pubkey);
+    }
+}
+/**
+ * Create a BeaconStateView from raw SSZ bytes. Used in the historical state regen worker thread.
+ *
+ * Set `useNative: true` to use the native (Zig) implementation once available.
+ */
+export function createBeaconStateViewForHistoricalRegen(opts) {
+    if (opts.useNative) {
+        throw new Error("Native (Zig) BeaconStateView not yet implemented");
+    }
+    const { config, stateBytes } = opts;
+    const state = getStateTypeFromBytes(config, stateBytes).deserializeToViewDU(stateBytes);
+    syncPubkeyCache(state, pubkeyCacheRegen);
+    const cachedState = createCachedBeaconState(state, { config, pubkeyCache: pubkeyCacheRegen }, { skipSyncPubkeys: true });
+    return new BeaconStateView(cachedState);
+}
+//# sourceMappingURL=stateViewFactory.js.map

package/lib/stateView/stateViewFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateViewFactory.js","sourceRoot":"","sources":["../../src/stateView/stateViewFactory.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,iBAAiB,EAAC,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAC,uBAAuB,EAAC,MAAM,wBAAwB,CAAC;AAE/D,OAAO,EAAC,qBAAqB,EAAC,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAC,eAAe,EAAC,MAAM,sBAAsB,CAAC;AAiBrD;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAA6B,EAAoB;IACrF,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,MAAM,EAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAC,GAAG,IAAI,CAAC;IAChD,MAAM,WAAW,GAAG,uBAAuB,CAAC,WAAW,EAAE,EAAC,MAAM,EAAE,WAAW,EAAC,EAAE,EAAC,eAAe,EAAE,IAAI,EAAC,CAAC,CAAC;IACzG,OAAO,IAAI,eAAe,CAAC,WAAW,CAAC,CAAC;AAAA,CACzC;AAED,iEAAiE;AAEjE,sEAAsE;AACtE,MAAM,gBAAgB,GAAG,iBAAiB,EAAE,CAAC;AAE7C,SAAS,eAAe,CAAC,KAA0B,EAAE,WAAwB,EAAQ;IACnF,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC;IACzC,KAAK,IAAI,CAAC,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QACjD,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACtD,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC;AAAA,CACF;AAaD;;;;GAIG;AACH,MAAM,UAAU,uCAAuC,CAAC,IAAuC,EAAoB;IACjH,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,MAAM,EAAC,MAAM,EAAE,UAAU,EAAC,GAAG,IAAI,CAAC;IAClC,MAAM,KAAK,GAAG,qBAAqB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC;IACxF,eAAe,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;IACzC,MAAM,WAAW,GAAG,uBAAuB,CAAC,KAAK,EAAE,EAAC,MAAM,EAAE,WAAW,EAAE,gBAAgB,EAAC,EAAE,EAAC,eAAe,EAAE,IAAI,EAAC,CAAC,CAAC;IACrH,OAAO,IAAI,eAAe,CAAC,WAAW,CAAC,CAAC;AAAA,CACzC"}

package/lib/testUtils/cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/testUtils/cache.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,aAAa,QAAgD,CAAC"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/testUtils/cache.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,aAAa,QAA2C,CAAC"}

package/lib/testUtils/cache.js

@@ -3,5 +3,5 @@ import { fileURLToPath } from "node:url";
 // Global variable __dirname no longer available in ES6 modules.
 // Solutions: https://stackoverflow.com/questions/46745014/alternative-for-dirname-in-node-js-when-using-es6-modules
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-export const testCachePath = path.join(__dirname, "../../test/test-cache");
+export const testCachePath = path.join(__dirname, "../../test-cache");
 //# sourceMappingURL=cache.js.map

package/lib/testUtils/cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/testUtils/cache.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAC,aAAa,EAAC,MAAM,UAAU,CAAC;AAEvC,gEAAgE;AAChE,oHAAoH;AACpH,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE/D,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,uBAAuB,CAAC,CAAC"}
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/testUtils/cache.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAC,aAAa,EAAC,MAAM,UAAU,CAAC;AAEvC,gEAAgE;AAChE,oHAAoH;AACpH,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE/D,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC"}

package/lib/testUtils/util.d.ts

@@ -1,6 +1,6 @@
 import { PublicKey, SecretKey } from "@chainsafe/blst";
 import { Slot, phase0 } from "@lodestar/types";
-import { BeaconStateAltair, CachedBeaconStateAllForks, CachedBeaconStateAltair, CachedBeaconStatePhase0 } from "../types.js";
+import { BeaconStateAltair, BeaconStateElectra, CachedBeaconStateAllForks, CachedBeaconStateAltair, CachedBeaconStateElectra, CachedBeaconStatePhase0 } from "../types.js";
 /**
  * Number of validators in prater is 210000 as of May 2021
  */
@@ -35,10 +35,22 @@ export declare function generatePerfTestCachedStateAltair(opts?: {
     goBackOneSlot: boolean;
     vc?: number;
 }): CachedBeaconStateAltair;
+/**
+ * Warning: This function has side effects on the cached state
+ * The order in which the caches are populated is important and can cause stable tests to fail.
+ */
+export declare function generatePerfTestCachedStateElectra(opts?: {
+    goBackOneSlot: boolean;
+    vc?: number;
+}): CachedBeaconStateElectra;
 /**
  * This is generated from Medalla state 756416
  */
 export declare function generatePerformanceStateAltair(pubkeysArg?: Uint8Array[]): BeaconStateAltair;
+/**
+ * This is generated from the same performance state as Altair, upgraded to Electra fields.
+ */
+export declare function generatePerformanceStateElectra(pubkeysArg?: Uint8Array[]): BeaconStateElectra;
 /**
  * This is generated from Medalla block 756417
  */

package/lib/testUtils/util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/testUtils/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAE,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAcrD,OAAO,EAAc,IAAI,EAAE,MAAM,EAAM,MAAM,iBAAiB,CAAC;AAW/D,OAAO,EACL,iBAAiB,EAEjB,yBAAyB,EACzB,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,aAAa,CAAC;AAarB;;GAEG;AACH,eAAO,MAAM,aAAa,SAAS,CAAC;AACpC,eAAO,MAAM,WAAW,MAAM,CAAC;AAE/B;;;;;GAKG;AACH,eAAO,MAAM,WAAW,sBAAgC,CAAC;AAKzD,eAAO,MAAM,cAAc,QAAQ,CAAC;AAEpC,wBAAgB,UAAU,CAAC,EAAE,SAAgB;;;;EAK5C;AAED,2FAA2F;AAC3F,wBAAgB,qBAAqB,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAEvE;AAED,2FAA2F;AAC3F,wBAAgB,2BAA2B,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAQ7E;AAaD,wBAAgB,iCAAiC,CAAC,IAAI,CAAC,EAAE;IAAC,aAAa,EAAE,OAAO,CAAA;CAAC,GAAG,uBAAuB,CA0F1G;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,uBAAuB,GAAG,IAAI,CASpF;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,CAAC,IAAI,CAAC,EAAE;IACvD,aAAa,EAAE,OAAO,CAAC;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,GAAG,uBAAuB,CA0B1B;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,UAAU,CAAC,EAAE,UAAU,EAAE,GAAG,iBAAiB,CAoC3F;AAED;;GAEG;AACH,wBAAgB,8BAA8B,IAAI,MAAM,CAAC,iBAAiB,CAgBzE;AA2ED,wBAAgB,2CAA2C,CAAC,EAC1D,EAAE,EACF,IAAI,EACL,EAAE;IACD,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,IAAI,CAAC;CACZ,GAAG,yBAAyB,CAoD5B"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/testUtils/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAE,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAcrD,OAAO,EAAc,IAAI,EAAE,MAAM,EAAM,MAAM,iBAAiB,CAAC;AAW/D,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAElB,yBAAyB,EACzB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,aAAa,CAAC;AAgBrB;;GAEG;AACH,eAAO,MAAM,aAAa,SAAS,CAAC;AACpC,eAAO,MAAM,WAAW,MAAM,CAAC;AAE/B;;;;;GAKG;AACH,eAAO,MAAM,WAAW,sBAAgC,CAAC;AAKzD,eAAO,MAAM,cAAc,QAAQ,CAAC;AAEpC,wBAAgB,UAAU,CAAC,EAAE,SAAgB;;;;EAK5C;AAED,2FAA2F;AAC3F,wBAAgB,qBAAqB,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAEvE;AAED,2FAA2F;AAC3F,wBAAgB,2BAA2B,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAQ7E;AAaD,wBAAgB,iCAAiC,CAAC,IAAI,CAAC,EAAE;IAAC,aAAa,EAAE,OAAO,CAAA;CAAC,GAAG,uBAAuB,CA0F1G;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,uBAAuB,GAAG,IAAI,CASpF;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,CAAC,IAAI,CAAC,EAAE;IACvD,aAAa,EAAE,OAAO,CAAC;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,GAAG,uBAAuB,CAgC1B;AAED;;;GAGG;AACH,wBAAgB,kCAAkC,CAAC,IAAI,CAAC,EAAE;IACxD,aAAa,EAAE,OAAO,CAAC;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,GAAG,wBAAwB,CAoC3B;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,UAAU,CAAC,EAAE,UAAU,EAAE,GAAG,iBAAiB,CAyC3F;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,UAAU,CAAC,EAAE,UAAU,EAAE,GAAG,kBAAkB,CAgD7F;AAED;;GAEG;AACH,wBAAgB,8BAA8B,IAAI,MAAM,CAAC,iBAAiB,CAgBzE;AA2ED,wBAAgB,2CAA2C,CAAC,EAC1D,EAAE,EACF,IAAI,EACL,EAAE;IACD,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,IAAI,CAAC;CACZ,GAAG,yBAAyB,CAoD5B"}

package/lib/testUtils/util.js

@@ -16,6 +16,9 @@ let phase0SignedBlock = null;
 let altairState = null;
 let altairCachedState23637 = null;
 let altairCachedState23638 = null;
+let electraState = null;
+let electraCachedState23637 = null;
+let electraCachedState23638 = null;
 /**
  * Number of validators in prater is 210000 as of May 2021
  */
@@ -52,10 +55,10 @@ export function getSecretKeyFromIndexCached(validatorIndex) {
     }
     return sk;
 }
-function getPubkeyCaches({ pubkeysMod }) {
+function getPubkeyCaches({ pubkeysMod }, vc = numValidators) {
     // Manually sync pubkeys to prevent doing BLS opts 110_000 times
     const pubkeyCache = createPubkeyCache();
-    for (let i = 0; i < numValidators; i++) {
+    for (let i = 0; i < vc; i++) {
         const pubkey = pubkeysMod[i % keypairsMod];
         pubkeyCache.set(i, pubkey);
     }
@@ -151,31 +154,83 @@ export function cachedStateAltairPopulateCaches(state) {
  * The order in which the caches are populated is important and can cause stable tests to fail.
  */
 export function generatePerfTestCachedStateAltair(opts) {
-    const { pubkeys, pubkeysMod, pubkeysModObj } = getPubkeys(opts?.vc);
-    const { pubkeyCache } = getPubkeyCaches({ pubkeys, pubkeysMod, pubkeysModObj });
+    const vc = opts?.vc ?? numValidators;
+    const { pubkeys, pubkeysMod, pubkeysModObj } = getPubkeys(vc);
+    const { pubkeyCache } = getPubkeyCaches({ pubkeys, pubkeysMod, pubkeysModObj }, vc);
     const altairConfig = createChainForkConfig({ ALTAIR_FORK_EPOCH: 0 });
     const origState = generatePerformanceStateAltair(pubkeys);
-    if (!altairCachedState23637) {
+    // For non-default vc, generate fresh without caching to avoid accumulating large states in memory
+    const isDefaultVc = vc === numValidators;
+    let cachedState23637 = isDefaultVc ? altairCachedState23637 : null;
+    if (!cachedState23637) {
         const state = origState.clone();
         state.slot -= 1;
-        altairCachedState23637 = createCachedBeaconState(state, {
+        cachedState23637 = createCachedBeaconState(state, {
             config: createBeaconConfig(altairConfig, state.genesisValidatorsRoot),
             pubkeyCache,
         });
+        if (isDefaultVc)
+            altairCachedState23637 = cachedState23637;
+    }
+    let cachedState23638 = isDefaultVc ? altairCachedState23638 : null;
+    if (!cachedState23638) {
+        cachedState23638 = processSlots(cachedState23637, cachedState23637.slot + 1);
+        cachedState23638.slot += 1;
+        if (isDefaultVc)
+            altairCachedState23638 = cachedState23638;
+    }
+    const resultingState = opts?.goBackOneSlot ? cachedState23637 : cachedState23638;
+    return resultingState.clone();
+}
+/**
+ * Warning: This function has side effects on the cached state
+ * The order in which the caches are populated is important and can cause stable tests to fail.
+ */
+export function generatePerfTestCachedStateElectra(opts) {
+    const vc = opts?.vc ?? numValidators;
+    const { pubkeys, pubkeysMod, pubkeysModObj } = getPubkeys(vc);
+    const { pubkeyCache } = getPubkeyCaches({ pubkeys, pubkeysMod, pubkeysModObj }, vc);
+    const electraConfig = createChainForkConfig({
+        ALTAIR_FORK_EPOCH: 0,
+        BELLATRIX_FORK_EPOCH: 0,
+        CAPELLA_FORK_EPOCH: 0,
+        DENEB_FORK_EPOCH: 0,
+        ELECTRA_FORK_EPOCH: 0,
+    });
+    const origState = generatePerformanceStateElectra(pubkeys);
+    // For non-default vc, generate fresh without caching to avoid accumulating large states in memory
+    const isDefaultVc = vc === numValidators;
+    let cachedState23637 = isDefaultVc ? electraCachedState23637 : null;
+    if (!cachedState23637) {
+        const state = origState.clone();
+        state.slot -= 1;
+        cachedState23637 = createCachedBeaconState(state, {
+            config: createBeaconConfig(electraConfig, state.genesisValidatorsRoot),
+            pubkeyCache,
+        });
+        if (isDefaultVc)
+            electraCachedState23637 = cachedState23637;
     }
-    if (!altairCachedState23638) {
-        altairCachedState23638 = processSlots(altairCachedState23637, altairCachedState23637.slot + 1);
-        altairCachedState23638.slot += 1;
+    let cachedState23638 = isDefaultVc ? electraCachedState23638 : null;
+    if (!cachedState23638) {
+        cachedState23638 = processSlots(cachedState23637, cachedState23637.slot + 1);
+        cachedState23638.slot += 1;
+        if (isDefaultVc)
+            electraCachedState23638 = cachedState23638;
     }
-    const resultingState = opts?.goBackOneSlot ? altairCachedState23637 : altairCachedState23638;
+    const resultingState = opts?.goBackOneSlot ? cachedState23637 : cachedState23638;
     return resultingState.clone();
 }
 /**
  * This is generated from Medalla state 756416
  */
 export function generatePerformanceStateAltair(pubkeysArg) {
-    if (!altairState) {
-        const pubkeys = pubkeysArg || getPubkeys().pubkeys;
+    const pubkeys = pubkeysArg || getPubkeys().pubkeys;
+    const vc = pubkeys.length;
+    const isDefaultVc = vc === numValidators;
+    // Only use cached state for default vc to avoid accumulating large states in memory
+    let cached = isDefaultVc ? altairState : null;
+    if (!cached) {
         const statePhase0 = buildPerformanceStatePhase0(pubkeys);
         const state = statePhase0;
         state.previousEpochParticipation = newFilledArray(pubkeys.length, 0b111);
@@ -185,19 +240,64 @@ export function generatePerformanceStateAltair(pubkeysArg) {
         state.currentSyncCommittee = ssz.altair.SyncCommittee.defaultValue();
         state.nextSyncCommittee = state.currentSyncCommittee;
         // Now the state is fully populated to convert to ViewDU
-        altairState = ssz.altair.BeaconState.toViewDU(state);
+        cached = ssz.altair.BeaconState.toViewDU(state);
         // Now set correct syncCommittees
         const epoch = computeEpochAtSlot(state.slot);
-        const activeValidatorIndices = getActiveValidatorIndices(altairState, epoch);
-        const effectiveBalanceIncrements = getEffectiveBalanceIncrements(altairState);
-        const { syncCommittee } = getNextSyncCommittee(ForkSeq.altair, altairState, activeValidatorIndices, effectiveBalanceIncrements);
+        const activeValidatorIndices = getActiveValidatorIndices(cached, epoch);
+        const effectiveBalanceIncrements = getEffectiveBalanceIncrements(cached);
+        const { syncCommittee } = getNextSyncCommittee(ForkSeq.altair, cached, activeValidatorIndices, effectiveBalanceIncrements);
         state.currentSyncCommittee = syncCommittee;
         state.nextSyncCommittee = syncCommittee;
-        altairState = ssz.altair.BeaconState.toViewDU(state);
+        cached = ssz.altair.BeaconState.toViewDU(state);
         // cache roots
-        altairState.hashTreeRoot();
+        cached.hashTreeRoot();
+        if (isDefaultVc)
+            altairState = cached;
+    }
+    return cached.clone();
+}
+/**
+ * This is generated from the same performance state as Altair, upgraded to Electra fields.
+ */
+export function generatePerformanceStateElectra(pubkeysArg) {
+    const pubkeys = pubkeysArg || getPubkeys().pubkeys;
+    const vc = pubkeys.length;
+    const isDefaultVc = vc === numValidators;
+    // Only use cached state for default vc to avoid accumulating large states in memory
+    let cached = isDefaultVc ? electraState : null;
+    if (!cached) {
+        const electraConfig = createChainForkConfig({
+            ALTAIR_FORK_EPOCH: 0,
+            BELLATRIX_FORK_EPOCH: 0,
+            CAPELLA_FORK_EPOCH: 0,
+            DENEB_FORK_EPOCH: 0,
+            ELECTRA_FORK_EPOCH: 0,
+        });
+        const state = ssz.electra.BeaconState.defaultValue();
+        Object.assign(state, buildPerformanceStatePhase0(pubkeys));
+        state.fork.previousVersion = electraConfig.DENEB_FORK_VERSION;
+        state.fork.currentVersion = electraConfig.ELECTRA_FORK_VERSION;
+        state.fork.epoch = electraConfig.ELECTRA_FORK_EPOCH;
+        state.previousEpochParticipation = newFilledArray(pubkeys.length, 0b111);
+        state.currentEpochParticipation = state.previousEpochParticipation;
+        state.inactivityScores = Array.from({ length: pubkeys.length }, (_, i) => i % 2);
+        state.currentSyncCommittee = ssz.altair.SyncCommittee.defaultValue();
+        state.nextSyncCommittee = state.currentSyncCommittee;
+        state.latestExecutionPayloadHeader = ssz.electra.ExecutionPayloadHeader.defaultValue();
+        state.depositRequestsStartIndex = 2023n;
+        cached = ssz.electra.BeaconState.toViewDU(state);
+        const epoch = computeEpochAtSlot(state.slot);
+        const activeValidatorIndices = getActiveValidatorIndices(cached, epoch);
+        const effectiveBalanceIncrements = getEffectiveBalanceIncrements(cached);
+        const { syncCommittee } = getNextSyncCommittee(ForkSeq.electra, cached, activeValidatorIndices, effectiveBalanceIncrements);
+        state.currentSyncCommittee = syncCommittee;
+        state.nextSyncCommittee = syncCommittee;
+        cached = ssz.electra.BeaconState.toViewDU(state);
+        cached.hashTreeRoot();
+        if (isDefaultVc)
+            electraState = cached;
     }
-    return altairState.clone();
+    return cached.clone();
 }
 /**
  * This is generated from Medalla block 756417