chore: rename loadCachedBeaconState to loadUnfinalizedCachedBeaconState

packages/state-transition/src/cache/stateCache.ts

@@ -156,8 +156,9 @@ export function createCachedBeaconState<T extends BeaconStateAllForks>(
  * Create a CachedBeaconState given a cached seed state and state bytes
  * This guarantees that the returned state shares the same tree with the seed state
  * Check loadState() api for more details
+ * TODO: after EIP-6110 need to provide a pivotValidatorIndex to decide which comes to finalized validators cache, which comes to unfinalized cache
  */
-export function loadCachedBeaconState<T extends BeaconStateAllForks & BeaconStateCache>(
+export function loadUnfinalizedCachedBeaconState<T extends BeaconStateAllForks & BeaconStateCache>(
   cachedSeedState: T,
   stateBytes: Uint8Array,
   opts?: EpochCacheOpts

packages/state-transition/src/index.ts

@@ -25,7 +25,7 @@ export type {
 // Main state caches
 export {
   createCachedBeaconState,
-  loadCachedBeaconState,
+  loadUnfinalizedCachedBeaconState,
   type BeaconStateCache,
   isCachedBeaconState,
   isStateBalancesNodesPopulated,

packages/state-transition/test/unit/cachedBeaconState.test.ts

@@ -5,7 +5,7 @@ import {config} from "@lodestar/config/default";
 import {createBeaconConfig} from "@lodestar/config";
 import {createCachedBeaconStateTest} from "../utils/state.js";
 import {PubkeyIndexMap} from "../../src/cache/pubkeyCache.js";
-import {createCachedBeaconState, loadCachedBeaconState} from "../../src/cache/stateCache.js";
+import {createCachedBeaconState, loadUnfinalizedCachedBeaconState} from "../../src/cache/stateCache.js";
 import {interopPubkeysCached} from "../utils/interop.js";
 import {modifyStateSameValidator, newStateWithValidators} from "../utils/capella.js";
 
@@ -136,15 +136,15 @@ describe("CachedBeaconState", () => {
 
         // confirm loadState() result
         const stateBytes = state.serialize();
-        const newCachedState = loadCachedBeaconState(seedState, stateBytes, {skipSyncCommitteeCache: true});
+        const newCachedState = loadUnfinalizedCachedBeaconState(seedState, stateBytes, {skipSyncCommitteeCache: true});
         const newStateBytes = newCachedState.serialize();
         expect(newStateBytes).to.be.deep.equal(stateBytes, "loadState: state bytes are not equal");
         expect(newCachedState.hashTreeRoot()).to.be.deep.equal(
           state.hashTreeRoot(),
           "loadState: state root is not equal"
         );
 
-        // confirm loadCachedBeaconState() result
+        // confirm loadUnfinalizedCachedBeaconState() result
         for (let i = 0; i < newCachedState.validators.length; i++) {
           expect(newCachedState.epochCtx.pubkey2index.get(newCachedState.validators.get(i).pubkey)).to.be.equal(i);
           expect(newCachedState.epochCtx.index2pubkey[i].toBytes()).to.be.deep.equal(pubkeys[i]);