@lodestar/state-transition 1.43.0-dev.6641fd750e → 1.43.0-dev.9c8becae00

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (54) hide show
  1. package/lib/cache/epochCache.d.ts +3 -1
  2. package/lib/cache/epochCache.d.ts.map +1 -1
  3. package/lib/cache/epochCache.js +31 -13
  4. package/lib/cache/epochCache.js.map +1 -1
  5. package/lib/cache/epochTransitionCache.d.ts +5 -0
  6. package/lib/cache/epochTransitionCache.d.ts.map +1 -1
  7. package/lib/cache/epochTransitionCache.js +1 -0
  8. package/lib/cache/epochTransitionCache.js.map +1 -1
  9. package/lib/epoch/index.d.ts +3 -1
  10. package/lib/epoch/index.d.ts.map +1 -1
  11. package/lib/epoch/index.js +8 -1
  12. package/lib/epoch/index.js.map +1 -1
  13. package/lib/epoch/processPtcWindow.d.ts +11 -0
  14. package/lib/epoch/processPtcWindow.d.ts.map +1 -0
  15. package/lib/epoch/processPtcWindow.js +28 -0
  16. package/lib/epoch/processPtcWindow.js.map +1 -0
  17. package/lib/slot/upgradeStateToGloas.d.ts.map +1 -1
  18. package/lib/slot/upgradeStateToGloas.js +2 -1
  19. package/lib/slot/upgradeStateToGloas.js.map +1 -1
  20. package/lib/stateTransition.d.ts +1 -2
  21. package/lib/stateTransition.d.ts.map +1 -1
  22. package/lib/stateTransition.js +1 -2
  23. package/lib/stateTransition.js.map +1 -1
  24. package/lib/stateView/beaconStateView.d.ts +1 -7
  25. package/lib/stateView/beaconStateView.d.ts.map +1 -1
  26. package/lib/stateView/beaconStateView.js +14 -25
  27. package/lib/stateView/beaconStateView.js.map +1 -1
  28. package/lib/stateView/interface.d.ts +8 -8
  29. package/lib/stateView/interface.d.ts.map +1 -1
  30. package/lib/stateView/interface.js.map +1 -1
  31. package/lib/util/attestation.d.ts +12 -1
  32. package/lib/util/attestation.d.ts.map +1 -1
  33. package/lib/util/attestation.js +23 -8
  34. package/lib/util/attestation.js.map +1 -1
  35. package/lib/util/execution.d.ts +4 -2
  36. package/lib/util/execution.d.ts.map +1 -1
  37. package/lib/util/execution.js +7 -0
  38. package/lib/util/execution.js.map +1 -1
  39. package/lib/util/gloas.d.ts +8 -3
  40. package/lib/util/gloas.d.ts.map +1 -1
  41. package/lib/util/gloas.js +26 -1
  42. package/lib/util/gloas.js.map +1 -1
  43. package/package.json +8 -8
  44. package/src/cache/epochCache.ts +32 -30
  45. package/src/cache/epochTransitionCache.ts +7 -0
  46. package/src/epoch/index.ts +9 -0
  47. package/src/epoch/processPtcWindow.ts +38 -0
  48. package/src/slot/upgradeStateToGloas.ts +2 -1
  49. package/src/stateTransition.ts +1 -2
  50. package/src/stateView/beaconStateView.ts +22 -29
  51. package/src/stateView/interface.ts +13 -8
  52. package/src/util/attestation.ts +37 -8
  53. package/src/util/execution.ts +11 -1
  54. package/src/util/gloas.ts +49 -3
package/package.json CHANGED
@@ -11,7 +11,7 @@
11
11
  "bugs": {
12
12
  "url": "https://github.com/ChainSafe/lodestar/issues"
13
13
  },
14
- "version": "1.43.0-dev.6641fd750e",
14
+ "version": "1.43.0-dev.9c8becae00",
15
15
  "type": "module",
16
16
  "exports": {
17
17
  ".": {
@@ -65,16 +65,16 @@
65
65
  "@chainsafe/persistent-merkle-tree": "^1.2.1",
66
66
  "@chainsafe/persistent-ts": "^1.0.0",
67
67
  "@chainsafe/pubkey-index-map": "^3.0.0",
68
- "@chainsafe/ssz": "^1.2.2",
68
+ "@chainsafe/ssz": "^1.4.0",
69
69
  "@chainsafe/swap-or-not-shuffle": "^1.2.1",
70
- "@lodestar/config": "^1.43.0-dev.6641fd750e",
71
- "@lodestar/params": "^1.43.0-dev.6641fd750e",
72
- "@lodestar/types": "^1.43.0-dev.6641fd750e",
73
- "@lodestar/utils": "^1.43.0-dev.6641fd750e",
70
+ "@lodestar/config": "^1.43.0-dev.9c8becae00",
71
+ "@lodestar/params": "^1.43.0-dev.9c8becae00",
72
+ "@lodestar/types": "^1.43.0-dev.9c8becae00",
73
+ "@lodestar/utils": "^1.43.0-dev.9c8becae00",
74
74
  "@vekexasia/bigint-buffer2": "^1.1.1"
75
75
  },
76
76
  "devDependencies": {
77
- "@lodestar/api": "^1.43.0-dev.6641fd750e"
77
+ "@lodestar/api": "^1.43.0-dev.9c8becae00"
78
78
  },
79
79
  "keywords": [
80
80
  "ethereum",
@@ -82,5 +82,5 @@
82
82
  "beacon",
83
83
  "blockchain"
84
84
  ],
85
- "gitHead": "9791abe98717579326dbf4c9b55e8dd637a6f778"
85
+ "gitHead": "39ee967f34e6936a7449d99b4c18bdfdfdc2a73a"
86
86
  }
@@ -32,10 +32,10 @@ import {
32
32
  calculateShufflingDecisionRoot,
33
33
  computeEpochShuffling,
34
34
  } from "../util/epochShuffling.js";
35
+ import {getPtcWindowEpochCacheData} from "../util/gloas.js";
35
36
  import {
36
37
  computeActivationExitEpoch,
37
38
  computeEpochAtSlot,
38
- computePayloadTimelinessCommitteesForEpoch,
39
39
  computeProposers,
40
40
  computeSyncPeriodAtEpoch,
41
41
  getActivationChurnLimit,
@@ -56,7 +56,7 @@ import {sumTargetUnslashedBalanceIncrements} from "../util/targetUnslashedBalanc
56
56
  import {EffectiveBalanceIncrements, getEffectiveBalanceIncrementsWithLen} from "./effectiveBalanceIncrements.js";
57
57
  import {EpochTransitionCache} from "./epochTransitionCache.js";
58
58
  import {PubkeyCache, createPubkeyCache, syncPubkeys} from "./pubkeyCache.js";
59
- import {CachedBeaconStateAllForks, CachedBeaconStateFulu} from "./stateCache.js";
59
+ import {CachedBeaconStateAllForks, CachedBeaconStateFulu, CachedBeaconStateGloas} from "./stateCache.js";
60
60
  import {
61
61
  SyncCommitteeCache,
62
62
  SyncCommitteeCacheEmpty,
@@ -226,11 +226,12 @@ export class EpochCache {
226
226
  /** TODO: Indexed SyncCommitteeCache */
227
227
  nextSyncCommitteeIndexed: SyncCommitteeCache;
228
228
 
229
- // TODO GLOAS: See if we need to cache PTC for next epoch
230
229
  // PTC for previous epoch, required for slot N block validating slot N-1 attestations
231
230
  previousPayloadTimelinessCommittees: Uint32Array[];
232
231
  // PTC for current epoch, computed eagerly at epoch transition
233
232
  payloadTimelinessCommittees: Uint32Array[];
233
+ // PTC for next epoch, precomputed from the ptc window for future duty serving
234
+ nextPayloadTimelinessCommittees: Uint32Array[];
234
235
 
235
236
  // TODO: Helper stats
236
237
  syncPeriod: SyncPeriod;
@@ -270,6 +271,7 @@ export class EpochCache {
270
271
  nextSyncCommitteeIndexed: SyncCommitteeCache;
271
272
  previousPayloadTimelinessCommittees: Uint32Array[];
272
273
  payloadTimelinessCommittees: Uint32Array[];
274
+ nextPayloadTimelinessCommittees: Uint32Array[];
273
275
  epoch: Epoch;
274
276
  syncPeriod: SyncPeriod;
275
277
  }) {
@@ -301,6 +303,7 @@ export class EpochCache {
301
303
  this.nextSyncCommitteeIndexed = data.nextSyncCommitteeIndexed;
302
304
  this.previousPayloadTimelinessCommittees = data.previousPayloadTimelinessCommittees;
303
305
  this.payloadTimelinessCommittees = data.payloadTimelinessCommittees;
306
+ this.nextPayloadTimelinessCommittees = data.nextPayloadTimelinessCommittees;
304
307
  this.epoch = data.epoch;
305
308
  this.syncPeriod = data.syncPeriod;
306
309
  }
@@ -451,25 +454,13 @@ export class EpochCache {
451
454
  nextSyncCommitteeIndexed = new SyncCommitteeCacheEmpty();
452
455
  }
453
456
 
454
- // Compute PTC for all slots in the prev/current epoch
457
+ // Copy previous/current epoch PTC slices from state.ptcWindow once, then serve hot-path lookups from epochCtx.
455
458
  let previousPayloadTimelinessCommittees: Uint32Array[] = [];
456
459
  let payloadTimelinessCommittees: Uint32Array[] = [];
460
+ let nextPayloadTimelinessCommittees: Uint32Array[] = [];
457
461
  if (currentEpoch >= config.GLOAS_FORK_EPOCH) {
458
- payloadTimelinessCommittees = computePayloadTimelinessCommitteesForEpoch(
459
- state,
460
- currentEpoch,
461
- currentShuffling.committees,
462
- effectiveBalanceIncrements
463
- );
464
-
465
- if (!isGenesis && previousEpoch >= config.GLOAS_FORK_EPOCH) {
466
- previousPayloadTimelinessCommittees = computePayloadTimelinessCommitteesForEpoch(
467
- state,
468
- previousEpoch,
469
- previousShuffling.committees,
470
- effectiveBalanceIncrements
471
- );
472
- }
462
+ ({previousPayloadTimelinessCommittees, payloadTimelinessCommittees, nextPayloadTimelinessCommittees} =
463
+ getPtcWindowEpochCacheData(state as CachedBeaconStateGloas));
473
464
  }
474
465
 
475
466
  // Precompute churnLimit for efficient initiateValidatorExit() during block proposing MUST be recompute everytime the
@@ -546,6 +537,7 @@ export class EpochCache {
546
537
  nextSyncCommitteeIndexed,
547
538
  previousPayloadTimelinessCommittees,
548
539
  payloadTimelinessCommittees,
540
+ nextPayloadTimelinessCommittees,
549
541
  epoch: currentEpoch,
550
542
  syncPeriod: computeSyncPeriodAtEpoch(currentEpoch),
551
543
  });
@@ -592,6 +584,7 @@ export class EpochCache {
592
584
  nextSyncCommitteeIndexed: this.nextSyncCommitteeIndexed,
593
585
  previousPayloadTimelinessCommittees: this.previousPayloadTimelinessCommittees,
594
586
  payloadTimelinessCommittees: this.payloadTimelinessCommittees,
587
+ nextPayloadTimelinessCommittees: this.nextPayloadTimelinessCommittees,
595
588
  epoch: this.epoch,
596
589
  syncPeriod: this.syncPeriod,
597
590
  });
@@ -695,21 +688,26 @@ export class EpochCache {
695
688
  /**
696
689
  * At fork boundary, this runs post-fork logic and it happens after `upgradeState*` is called.
697
690
  */
698
- finalProcessEpoch(state: CachedBeaconStateAllForks): void {
691
+ finalProcessEpoch(state: CachedBeaconStateAllForks, epochTransitionCache: EpochTransitionCache): void {
699
692
  // this.epoch was updated at the end of afterProcessEpoch()
700
693
  const upcomingEpoch = this.epoch;
701
694
  const epochAfterUpcoming = upcomingEpoch + 1;
702
695
 
703
696
  this.proposersPrevEpoch = this.proposers;
704
697
  if (upcomingEpoch >= this.config.GLOAS_FORK_EPOCH) {
705
- // Shift and compute current epoch PTC eagerly for all slots
706
- this.previousPayloadTimelinessCommittees = this.payloadTimelinessCommittees;
707
- this.payloadTimelinessCommittees = computePayloadTimelinessCommitteesForEpoch(
708
- state,
709
- upcomingEpoch,
710
- this.currentShuffling.committees,
711
- this.effectiveBalanceIncrements
712
- );
698
+ if (epochTransitionCache.nextEpochPayloadTimelinessCommittees) {
699
+ // shift arrays from transition cache
700
+ this.previousPayloadTimelinessCommittees = this.payloadTimelinessCommittees;
701
+ this.payloadTimelinessCommittees = this.nextPayloadTimelinessCommittees;
702
+ this.nextPayloadTimelinessCommittees = epochTransitionCache.nextEpochPayloadTimelinessCommittees;
703
+ } else {
704
+ // Fork boundary: processPtcWindow didn't run, read from freshly initialized state.ptcWindow
705
+ ({
706
+ previousPayloadTimelinessCommittees: this.previousPayloadTimelinessCommittees,
707
+ payloadTimelinessCommittees: this.payloadTimelinessCommittees,
708
+ nextPayloadTimelinessCommittees: this.nextPayloadTimelinessCommittees,
709
+ } = getPtcWindowEpochCacheData(state as CachedBeaconStateGloas));
710
+ }
713
711
  }
714
712
  if (upcomingEpoch >= this.config.FULU_FORK_EPOCH) {
715
713
  // Populate proposer cache with lookahead from state
@@ -1034,12 +1032,16 @@ export class EpochCache {
1034
1032
  throw new Error("Payload Timeliness Committee is not available before gloas fork");
1035
1033
  }
1036
1034
 
1035
+ if (epoch === this.epoch - 1) {
1036
+ return this.previousPayloadTimelinessCommittees[slot % SLOTS_PER_EPOCH];
1037
+ }
1038
+
1037
1039
  if (epoch === this.epoch) {
1038
1040
  return this.payloadTimelinessCommittees[slot % SLOTS_PER_EPOCH];
1039
1041
  }
1040
1042
 
1041
- if (epoch === this.epoch - 1 && this.previousPayloadTimelinessCommittees.length > 0) {
1042
- return this.previousPayloadTimelinessCommittees[slot % SLOTS_PER_EPOCH];
1043
+ if (epoch === this.epoch + 1) {
1044
+ return this.nextPayloadTimelinessCommittees[slot % SLOTS_PER_EPOCH];
1043
1045
  }
1044
1046
 
1045
1047
  throw new Error(`Payload Timeliness Committee is not available for slot=${slot}`);
@@ -158,6 +158,12 @@ export interface EpochTransitionCache {
158
158
  */
159
159
  nextShuffling: EpochShuffling | null;
160
160
 
161
+ /**
162
+ * Pre-computed PTC for epoch N + MIN_SEED_LOOKAHEAD + 1, populated by processPtcWindow (Gloas+).
163
+ * Used by finalProcessEpoch to shift PTC arrays in epoch cache without reading from state.
164
+ */
165
+ nextEpochPayloadTimelinessCommittees: Uint32Array[] | null;
166
+
161
167
  /**
162
168
  * Altair specific, this is total active balances for the next epoch.
163
169
  * This is only used in `afterProcessEpoch` to compute base reward and sync participant reward.
@@ -502,6 +508,7 @@ export function beforeProcessEpoch(
502
508
  indicesToEject,
503
509
  nextShufflingActiveIndices,
504
510
  nextShuffling: null,
511
+ nextEpochPayloadTimelinessCommittees: null,
505
512
  // to be updated in processEffectiveBalanceUpdates
506
513
  nextEpochTotalActiveBalanceByIncrement: 0,
507
514
  isActivePrevEpoch,
@@ -28,6 +28,7 @@ import {processParticipationRecordUpdates} from "./processParticipationRecordUpd
28
28
  import {processPendingConsolidations} from "./processPendingConsolidations.js";
29
29
  import {processPendingDeposits} from "./processPendingDeposits.js";
30
30
  import {processProposerLookahead} from "./processProposerLookahead.js";
31
+ import {processPtcWindow} from "./processPtcWindow.js";
31
32
  import {processRandaoMixesReset} from "./processRandaoMixesReset.js";
32
33
  import {processRegistryUpdates} from "./processRegistryUpdates.js";
33
34
  import {processRewardsAndPenalties} from "./processRewardsAndPenalties.js";
@@ -55,6 +56,7 @@ export {
55
56
  processPendingDeposits,
56
57
  processPendingConsolidations,
57
58
  processProposerLookahead,
59
+ processPtcWindow,
58
60
  processBuilderPendingPayments,
59
61
  };
60
62
 
@@ -81,6 +83,7 @@ export enum EpochTransitionStep {
81
83
  processPendingDeposits = "processPendingDeposits",
82
84
  processPendingConsolidations = "processPendingConsolidations",
83
85
  processProposerLookahead = "processProposerLookahead",
86
+ processPtcWindow = "processPtcWindow",
84
87
  processBuilderPendingPayments = "processBuilderPendingPayments",
85
88
  }
86
89
 
@@ -211,4 +214,10 @@ export function processEpoch(
211
214
  processProposerLookahead(fork, state as CachedBeaconStateFulu, cache);
212
215
  timer?.();
213
216
  }
217
+
218
+ if (fork >= ForkSeq.gloas) {
219
+ const timer = metrics?.epochTransitionStepTime.startTimer({step: EpochTransitionStep.processPtcWindow});
220
+ processPtcWindow(state as CachedBeaconStateGloas, cache);
221
+ timer?.();
222
+ }
214
223
  }
@@ -0,0 +1,38 @@
1
+ import {MIN_SEED_LOOKAHEAD} from "@lodestar/params";
2
+ import {ssz} from "@lodestar/types";
3
+ import {CachedBeaconStateGloas, EpochTransitionCache} from "../types.js";
4
+ import {computeEpochShuffling} from "../util/epochShuffling.js";
5
+ import {computePayloadTimelinessCommitteesForEpoch} from "../util/seed.js";
6
+
7
+ /**
8
+ * Update the `ptc_window` field in the beacon state by shifting out the oldest epoch's
9
+ * PTC entries and appending newly computed entries for the next lookahead epoch.
10
+ * Stashes the computed PTCs in the transition cache for finalProcessEpoch to shift
11
+ * into the epoch cache without reading from state.
12
+ *
13
+ * Spec: https://github.com/ethereum/consensus-specs/blob/v1.7.0-alpha.4/specs/gloas/beacon-chain.md#new-process_ptc_window
14
+ */
15
+ export function processPtcWindow(state: CachedBeaconStateGloas, cache: EpochTransitionCache): void {
16
+ const nextEpoch = state.epochCtx.epoch + MIN_SEED_LOOKAHEAD + 1;
17
+ const nextEpochShuffling =
18
+ cache.nextShuffling ?? computeEpochShuffling(state, cache.nextShufflingActiveIndices, nextEpoch);
19
+ cache.nextShuffling = nextEpochShuffling;
20
+
21
+ const newNextPayloadTimelinessCommittees = computePayloadTimelinessCommitteesForEpoch(
22
+ state,
23
+ nextEpoch,
24
+ nextEpochShuffling.committees,
25
+ state.epochCtx.effectiveBalanceIncrements
26
+ );
27
+
28
+ // Stash for finalProcessEpoch to shift into epoch cache
29
+ cache.nextEpochPayloadTimelinessCommittees = newNextPayloadTimelinessCommittees;
30
+
31
+ // Write shifted window to state: current(N) + next(N+1) + newlyComputed(N+2)
32
+ // From the perspective of upcoming epoch N+1, this is previous + current + next
33
+ state.ptcWindow = ssz.gloas.PtcWindow.toViewDU([
34
+ ...state.epochCtx.payloadTimelinessCommittees,
35
+ ...state.epochCtx.nextPayloadTimelinessCommittees,
36
+ ...newNextPayloadTimelinessCommittees,
37
+ ]);
38
+ }
@@ -5,7 +5,7 @@ import {isValidDepositSignature} from "../block/processDeposit.js";
5
5
  import {applyDepositForBuilder} from "../block/processDepositRequest.js";
6
6
  import {getCachedBeaconState} from "../cache/stateCache.js";
7
7
  import {CachedBeaconStateFulu, CachedBeaconStateGloas} from "../types.js";
8
- import {isBuilderWithdrawalCredential} from "../util/gloas.js";
8
+ import {initializePtcWindow, isBuilderWithdrawalCredential} from "../util/gloas.js";
9
9
  import {isValidatorKnown} from "../util/index.js";
10
10
 
11
11
  /**
@@ -61,6 +61,7 @@ export function upgradeStateToGloas(stateFulu: CachedBeaconStateFulu): CachedBea
61
61
  stateGloasView.pendingPartialWithdrawals = stateGloasCloned.pendingPartialWithdrawals;
62
62
  stateGloasView.pendingConsolidations = stateGloasCloned.pendingConsolidations;
63
63
  stateGloasView.proposerLookahead = stateGloasCloned.proposerLookahead;
64
+ stateGloasView.ptcWindow = ssz.gloas.PtcWindow.toViewDU(initializePtcWindow(stateFulu));
64
65
 
65
66
  for (let i = 0; i < SLOTS_PER_HISTORICAL_ROOT; i++) {
66
67
  stateGloasView.executionPayloadAvailability.set(i, true);
@@ -76,7 +76,6 @@ export enum StateHashTreeRootSource {
76
76
  prepareNextEpoch = "prepare_next_epoch",
77
77
  regenState = "regen_state",
78
78
  computeNewStateRoot = "compute_new_state_root",
79
- computePayloadEnvelopeStateRoot = "compute_payload_envelope_state_root",
80
79
  }
81
80
 
82
81
  /**
@@ -283,7 +282,7 @@ function processSlotsWithTransientCache(
283
282
  {
284
283
  const timer = metrics?.epochTransitionStepTime.startTimer({step: EpochTransitionStep.finalProcessEpoch});
285
284
  // last step to prepare epoch data that depends on the upgraded state, for example proposerLookahead of BeaconStateFulu
286
- postState.epochCtx.finalProcessEpoch(postState);
285
+ postState.epochCtx.finalProcessEpoch(postState, epochTransitionCache);
287
286
  timer?.();
288
287
  }
289
288
 
@@ -59,7 +59,12 @@ import {getBlockRootAtSlot} from "../util/blockRoot.js";
59
59
  import {computeAnchorCheckpoint} from "../util/computeAnchorCheckpoint.js";
60
60
  import {computeEpochAtSlot, computeStartSlotAtEpoch} from "../util/epoch.js";
61
61
  import {EpochShuffling} from "../util/epochShuffling.js";
62
- import {isExecutionEnabled, isExecutionStateType, isMergeTransitionComplete} from "../util/execution.js";
62
+ import {
63
+ isExecutionEnabled,
64
+ isExecutionStateType,
65
+ isGloasStateType,
66
+ isMergeTransitionComplete,
67
+ } from "../util/execution.js";
63
68
  import {canBuilderCoverBid} from "../util/gloas.js";
64
69
  import {loadState} from "../util/loadState/loadState.js";
65
70
  import {getRandaoMix} from "../util/seed.js";
@@ -79,8 +84,6 @@ export class BeaconStateView implements IBeaconStateViewLatestFork {
79
84
  private _currentEpochParticipation: Uint8Array | null = null;
80
85
  // bellatrix
81
86
  private _latestExecutionPayloadHeader: ExecutionPayloadHeader | null = null;
82
- // Caches the cross-fork latestBlockHash value
83
- private _latestBlockHash: Bytes32 | null = null;
84
87
  // capella
85
88
  private _historicalSummaries: capella.HistoricalSummaries | null = null;
86
89
  // electra
@@ -213,9 +216,13 @@ export class BeaconStateView implements IBeaconStateViewLatestFork {
213
216
  // bellatrix
214
217
 
215
218
  get latestExecutionPayloadHeader(): ExecutionPayloadHeader {
216
- if (this.config.getForkSeq(this.cachedState.slot) < ForkSeq.bellatrix) {
219
+ const forkSeq = this.config.getForkSeq(this.cachedState.slot);
220
+ if (forkSeq < ForkSeq.bellatrix) {
217
221
  throw new Error("latestExecutionPayloadHeader is not available before Bellatrix");
218
222
  }
223
+ if (forkSeq >= ForkSeq.gloas) {
224
+ throw new Error("latestExecutionPayloadHeader is not available after Gloas");
225
+ }
219
226
 
220
227
  if (this._latestExecutionPayloadHeader === null) {
221
228
  this._latestExecutionPayloadHeader = (
@@ -226,30 +233,6 @@ export class BeaconStateView implements IBeaconStateViewLatestFork {
226
233
  return this._latestExecutionPayloadHeader;
227
234
  }
228
235
 
229
- /**
230
- * Cross-fork accessor for the execution block hash of the most recently included payload.
231
- * Pre-gloas: reads from latestExecutionPayloadHeader.blockHash.
232
- * Gloas+: reads the dedicated latestBlockHash field (EIP-7732).
233
- */
234
- get latestBlockHash(): Bytes32 {
235
- const forkSeq = this.config.getForkSeq(this.cachedState.slot);
236
- if (forkSeq < ForkSeq.bellatrix) {
237
- throw new Error("latestBlockHash is not available before Bellatrix");
238
- }
239
-
240
- if (this._latestBlockHash === null) {
241
- if (forkSeq >= ForkSeq.gloas) {
242
- this._latestBlockHash = (this.cachedState as CachedBeaconStateGloas).latestBlockHash;
243
- } else {
244
- this._latestBlockHash = (
245
- this.cachedState as CachedBeaconStateExecutions
246
- ).latestExecutionPayloadHeader.blockHash;
247
- }
248
- }
249
-
250
- return this._latestBlockHash;
251
- }
252
-
253
236
  /**
254
237
  * The execution block number of the most recently included payload.
255
238
  * Named payloadBlockNumber (not latestBlockNumber) to mirror ExecutionPayloadHeader.blockNumber pre-gloas.
@@ -360,6 +343,13 @@ export class BeaconStateView implements IBeaconStateViewLatestFork {
360
343
 
361
344
  // gloas
362
345
 
346
+ get latestBlockHash(): Bytes32 {
347
+ if (this.config.getForkSeq(this.cachedState.slot) < ForkSeq.gloas) {
348
+ throw new Error("latestBlockHash is not available before Gloas");
349
+ }
350
+ return (this.cachedState as CachedBeaconStateGloas).latestBlockHash;
351
+ }
352
+
363
353
  get executionPayloadAvailability(): BitArray {
364
354
  if (this.config.getForkSeq(this.cachedState.slot) < ForkSeq.gloas) {
365
355
  throw new Error("executionPayloadAvailability is not available before Gloas");
@@ -589,7 +579,10 @@ export class BeaconStateView implements IBeaconStateViewLatestFork {
589
579
  }
590
580
 
591
581
  get isMergeTransitionComplete(): boolean {
592
- return isExecutionStateType(this.cachedState) && isMergeTransitionComplete(this.cachedState);
582
+ return (
583
+ (isExecutionStateType(this.cachedState) || isGloasStateType(this.cachedState)) &&
584
+ isMergeTransitionComplete(this.cachedState)
585
+ );
593
586
  }
594
587
 
595
588
  // Block production
@@ -187,13 +187,6 @@ export interface IBeaconStateViewAltair extends IBeaconStateView {
187
187
  export interface IBeaconStateViewBellatrix extends IBeaconStateViewAltair {
188
188
  forkName: ForkPostBellatrix;
189
189
  latestExecutionPayloadHeader: ExecutionPayloadHeader;
190
- /**
191
- * Cross-fork accessor for the execution block hash of the most recently included payload.
192
- * Pre-gloas: returns latestExecutionPayloadHeader.blockHash (bellatrix–fulu).
193
- * Gloas+: returns the dedicated latestBlockHash state field (EIP-7732).
194
- * Throws before bellatrix.
195
- */
196
- latestBlockHash: Bytes32;
197
190
  /**
198
191
  * The execution block number of the most recently included payload.
199
192
  * Named payloadBlockNumber (not latestBlockNumber) to mirror ExecutionPayloadHeader.blockNumber pre-gloas.
@@ -244,6 +237,11 @@ export interface IBeaconStateViewFulu extends IBeaconStateViewElectra {
244
237
  /** Gloas+ state fields — use isStatePostGloas() guard */
245
238
  export interface IBeaconStateViewGloas extends IBeaconStateViewFulu {
246
239
  forkName: ForkPostGloas;
240
+ /** Removed from BeaconState in gloas. Use `latestBlockHash` instead. */
241
+ latestExecutionPayloadHeader: never;
242
+ /** Removed from BeaconState in gloas. */
243
+ payloadBlockNumber: never;
244
+ latestBlockHash: Bytes32;
247
245
  executionPayloadAvailability: BitArray;
248
246
  latestExecutionPayloadBid: ExecutionPayloadBid;
249
247
  payloadExpectedWithdrawals: capella.Withdrawal[];
@@ -262,7 +260,14 @@ export interface IBeaconStateViewGloas extends IBeaconStateViewFulu {
262
260
  * forkName as ForkName since the class wraps any fork's state.
263
261
  * Sub-interfaces retain their narrowed forkName discriminants for caller-side type guards.
264
262
  */
265
- export type IBeaconStateViewLatestFork = Omit<IBeaconStateViewGloas, "forkName"> & {forkName: ForkName};
263
+ export type IBeaconStateViewLatestFork = Omit<
264
+ IBeaconStateViewGloas,
265
+ "forkName" | "latestExecutionPayloadHeader" | "payloadBlockNumber"
266
+ > & {
267
+ forkName: ForkName;
268
+ latestExecutionPayloadHeader: ExecutionPayloadHeader;
269
+ payloadBlockNumber: number;
270
+ };
266
271
  export function isStatePostAltair(state: IBeaconStateView): state is IBeaconStateViewAltair {
267
272
  return isForkPostAltair(state.forkName);
268
273
  }
@@ -1,5 +1,13 @@
1
- import {MIN_ATTESTATION_INCLUSION_DELAY, SLOTS_PER_EPOCH} from "@lodestar/params";
2
- import {AttesterSlashing, Slot, ValidatorIndex, phase0, ssz} from "@lodestar/types";
1
+ import {ForkSeq, MIN_ATTESTATION_INCLUSION_DELAY, SLOTS_PER_EPOCH} from "@lodestar/params";
2
+ import {
3
+ AttesterSlashing,
4
+ IndexedAttestation,
5
+ IndexedAttestationBigint,
6
+ Slot,
7
+ ValidatorIndex,
8
+ phase0,
9
+ ssz,
10
+ } from "@lodestar/types";
3
11
 
4
12
  /**
5
13
  * Check if [[data1]] and [[data2]] are slashable according to Casper FFG rules.
@@ -22,15 +30,36 @@ export function isValidAttestationSlot(attestationSlot: Slot, currentSlot: Slot)
22
30
  );
23
31
  }
24
32
 
25
- export function getAttesterSlashableIndices(attesterSlashing: AttesterSlashing): ValidatorIndex[] {
33
+ /**
34
+ * Compute the intersection of two sorted validator index lists.
35
+ * Both inputs must be sorted in ascending order (per spec).
36
+ */
37
+ export function getIntersectingIndices(indices1: ValidatorIndex[], indices2: ValidatorIndex[]): ValidatorIndex[] {
26
38
  const indices: ValidatorIndex[] = [];
27
- const attSet1 = new Set(attesterSlashing.attestation1.attestingIndices);
28
- const attArr2 = attesterSlashing.attestation2.attestingIndices;
29
- for (let i = 0, len = attArr2.length; i < len; i++) {
30
- const index = attArr2[i];
31
- if (attSet1.has(index)) {
39
+ const alreadyPresent = new Set(indices1);
40
+ for (let i = 0, len = indices2.length; i < len; i++) {
41
+ const index = indices2[i];
42
+ if (alreadyPresent.has(index)) {
32
43
  indices.push(index);
33
44
  }
34
45
  }
35
46
  return indices;
36
47
  }
48
+
49
+ export function getAttesterSlashableIndices(attesterSlashing: AttesterSlashing): ValidatorIndex[] {
50
+ return getIntersectingIndices(
51
+ attesterSlashing.attestation1.attestingIndices,
52
+ attesterSlashing.attestation2.attestingIndices
53
+ );
54
+ }
55
+
56
+ /**
57
+ * Convert IndexedAttestation to IndexedAttestationBigint via SSZ roundtrip.
58
+ * Both types share the same binary layout — only the JS numeric representation differs.
59
+ */
60
+ export function toIndexedAttestationBigint(att: IndexedAttestation, fork: ForkSeq): IndexedAttestationBigint {
61
+ const sszType = fork >= ForkSeq.electra ? ssz.electra.IndexedAttestation : ssz.phase0.IndexedAttestation;
62
+ const sszTypeBigint =
63
+ fork >= ForkSeq.electra ? ssz.electra.IndexedAttestationBigint : ssz.phase0.IndexedAttestationBigint;
64
+ return sszTypeBigint.deserialize(sszType.serialize(att));
65
+ }
@@ -18,6 +18,7 @@ import {
18
18
  BeaconStateBellatrix,
19
19
  BeaconStateCapella,
20
20
  BeaconStateExecutions,
21
+ BeaconStateGloas,
21
22
  CachedBeaconStateAllForks,
22
23
  CachedBeaconStateExecutions,
23
24
  } from "../types.js";
@@ -46,7 +47,11 @@ export function isExecutionEnabled(state: BeaconStateExecutions, block: BeaconBl
46
47
  * Merge is complete when the state includes execution layer data:
47
48
  * state.latestExecutionPayloadHeader NOT EMPTY or state is post-capella
48
49
  */
49
- export function isMergeTransitionComplete(state: BeaconStateExecutions): boolean {
50
+ export function isMergeTransitionComplete(state: BeaconStateExecutions | BeaconStateGloas): boolean {
51
+ if (isGloasStateType(state)) {
52
+ return true;
53
+ }
54
+
50
55
  if (isCapellaStateType(state)) {
51
56
  // All networks have completed the merge transition before capella
52
57
  return true;
@@ -71,6 +76,11 @@ export function isCapellaStateType(state: BeaconStateAllForks): state is BeaconS
71
76
  );
72
77
  }
73
78
 
79
+ /** Type guard for gloas.BeaconState */
80
+ export function isGloasStateType(state: BeaconStateAllForks): state is BeaconStateGloas {
81
+ return (state as BeaconStateGloas).latestBlockHash !== undefined;
82
+ }
83
+
74
84
  /** Type guard for bellatrix.CachedBeaconState */
75
85
  export function isExecutionCachedStateType(state: CachedBeaconStateAllForks): state is CachedBeaconStateExecutions {
76
86
  return (state as CachedBeaconStateExecutions).latestExecutionPayloadHeader !== undefined;
package/src/util/gloas.ts CHANGED
@@ -6,16 +6,20 @@ import {
6
6
  EFFECTIVE_BALANCE_INCREMENT,
7
7
  FAR_FUTURE_EPOCH,
8
8
  MIN_DEPOSIT_AMOUNT,
9
+ MIN_SEED_LOOKAHEAD,
10
+ PTC_SIZE,
9
11
  SLOTS_PER_EPOCH,
10
12
  } from "@lodestar/params";
11
13
  import {BuilderIndex, Epoch, ValidatorIndex, gloas} from "@lodestar/types";
12
14
  import {AttestationData} from "@lodestar/types/phase0";
13
15
  import {byteArrayEquals} from "@lodestar/utils";
14
- import {IBeaconStateViewGloas} from "../stateView/interface.js";
15
- import {CachedBeaconStateGloas} from "../types.js";
16
+ import {CachedBeaconStateFulu, CachedBeaconStateGloas} from "../types.js";
16
17
  import {getBlockRootAtSlot} from "./blockRoot.js";
17
18
  import {computeEpochAtSlot} from "./epoch.js";
19
+ import {computeEpochShuffling} from "./epochShuffling.js";
18
20
  import {RootCache} from "./rootCache.js";
21
+ import {computePayloadTimelinessCommitteesForEpoch} from "./seed.js";
22
+ import {getActiveValidatorIndices} from "./validator.js";
19
23
 
20
24
  export function isBuilderWithdrawalCredential(withdrawalCredentials: Uint8Array): boolean {
21
25
  return withdrawalCredentials[0] === BUILDER_WITHDRAWAL_PREFIX;
@@ -168,6 +172,48 @@ export function isAttestationSameSlotRootCache(rootCache: RootCache, data: Attes
168
172
  return isMatchingBlockRoot && isCurrentBlockRoot;
169
173
  }
170
174
 
171
- export function isParentBlockFull(state: CachedBeaconStateGloas | IBeaconStateViewGloas): boolean {
175
+ export function isParentBlockFull(state: CachedBeaconStateGloas): boolean {
172
176
  return byteArrayEquals(state.latestExecutionPayloadBid.blockHash, state.latestBlockHash);
173
177
  }
178
+
179
+ export function initializePtcWindow(state: CachedBeaconStateFulu): Uint32Array[] {
180
+ const ptcWindow: Uint32Array[] = Array.from({length: SLOTS_PER_EPOCH}, () => new Uint32Array(PTC_SIZE));
181
+ const currentEpoch = state.epochCtx.epoch;
182
+
183
+ for (let epochOffset = 0; epochOffset <= MIN_SEED_LOOKAHEAD; epochOffset++) {
184
+ const epoch = currentEpoch + epochOffset;
185
+ const shuffling =
186
+ state.epochCtx.getShufflingAtEpochOrNull(epoch) ??
187
+ computeEpochShuffling(state, getActiveValidatorIndices(state, epoch), epoch);
188
+
189
+ ptcWindow.push(
190
+ ...computePayloadTimelinessCommitteesForEpoch(
191
+ state,
192
+ epoch,
193
+ shuffling.committees,
194
+ state.epochCtx.effectiveBalanceIncrements
195
+ )
196
+ );
197
+ }
198
+
199
+ return ptcWindow;
200
+ }
201
+
202
+ export function getPtcWindowEpochCacheData(state: CachedBeaconStateGloas): {
203
+ previousPayloadTimelinessCommittees: Uint32Array[];
204
+ payloadTimelinessCommittees: Uint32Array[];
205
+ nextPayloadTimelinessCommittees: Uint32Array[];
206
+ } {
207
+ const toUint32Arrays = (views: ReturnType<typeof state.ptcWindow.getReadonlyByRange>) =>
208
+ views.map((v) => Uint32Array.from(v.getAll()));
209
+
210
+ const previousPtcWindow = state.ptcWindow.getReadonlyByRange(0, SLOTS_PER_EPOCH);
211
+ const currentPtcWindow = state.ptcWindow.getReadonlyByRange(SLOTS_PER_EPOCH, SLOTS_PER_EPOCH);
212
+ const nextPtcWindow = state.ptcWindow.getReadonlyByRange(2 * SLOTS_PER_EPOCH, SLOTS_PER_EPOCH);
213
+
214
+ return {
215
+ previousPayloadTimelinessCommittees: toUint32Arrays(previousPtcWindow),
216
+ payloadTimelinessCommittees: toUint32Arrays(currentPtcWindow),
217
+ nextPayloadTimelinessCommittees: toUint32Arrays(nextPtcWindow),
218
+ };
219
+ }