@lodestar/beacon-node 1.50.0-dev.5ad1067954 → 1.50.0-dev.6155cf7acc

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 (130) hide show
  1. package/lib/api/impl/beacon/index.d.ts.map +1 -1
  2. package/lib/api/impl/beacon/index.js +13 -0
  3. package/lib/api/impl/beacon/index.js.map +1 -1
  4. package/lib/api/impl/beacon/state/index.d.ts.map +1 -1
  5. package/lib/api/impl/beacon/state/index.js +23 -3
  6. package/lib/api/impl/beacon/state/index.js.map +1 -1
  7. package/lib/api/impl/debug/index.d.ts.map +1 -1
  8. package/lib/api/impl/debug/index.js +26 -18
  9. package/lib/api/impl/debug/index.js.map +1 -1
  10. package/lib/api/impl/validator/index.d.ts +1 -0
  11. package/lib/api/impl/validator/index.d.ts.map +1 -1
  12. package/lib/api/impl/validator/index.js +23 -1
  13. package/lib/api/impl/validator/index.js.map +1 -1
  14. package/lib/chain/archiveStore/archiveStore.d.ts +5 -0
  15. package/lib/chain/archiveStore/archiveStore.d.ts.map +1 -1
  16. package/lib/chain/archiveStore/archiveStore.js +13 -23
  17. package/lib/chain/archiveStore/archiveStore.js.map +1 -1
  18. package/lib/chain/archiveStore/utils/pruneHistory.d.ts +1 -1
  19. package/lib/chain/archiveStore/utils/pruneHistory.d.ts.map +1 -1
  20. package/lib/chain/archiveStore/utils/pruneHistory.js +2 -1
  21. package/lib/chain/archiveStore/utils/pruneHistory.js.map +1 -1
  22. package/lib/chain/blocks/importBlock.d.ts.map +1 -1
  23. package/lib/chain/blocks/importBlock.js +7 -3
  24. package/lib/chain/blocks/importBlock.js.map +1 -1
  25. package/lib/chain/chain.d.ts +4 -1
  26. package/lib/chain/chain.d.ts.map +1 -1
  27. package/lib/chain/chain.js +41 -5
  28. package/lib/chain/chain.js.map +1 -1
  29. package/lib/chain/emitter.d.ts +7 -1
  30. package/lib/chain/emitter.d.ts.map +1 -1
  31. package/lib/chain/emitter.js +5 -0
  32. package/lib/chain/emitter.js.map +1 -1
  33. package/lib/chain/forkChoice/index.d.ts.map +1 -1
  34. package/lib/chain/forkChoice/index.js +2 -0
  35. package/lib/chain/forkChoice/index.js.map +1 -1
  36. package/lib/chain/interface.d.ts +1 -0
  37. package/lib/chain/interface.d.ts.map +1 -1
  38. package/lib/chain/opPools/aggregatedAttestationPool.d.ts +4 -2
  39. package/lib/chain/opPools/aggregatedAttestationPool.d.ts.map +1 -1
  40. package/lib/chain/opPools/aggregatedAttestationPool.js +30 -8
  41. package/lib/chain/opPools/aggregatedAttestationPool.js.map +1 -1
  42. package/lib/chain/opPools/proposerPreferencesPool.d.ts +4 -4
  43. package/lib/chain/opPools/proposerPreferencesPool.d.ts.map +1 -1
  44. package/lib/chain/opPools/proposerPreferencesPool.js +14 -11
  45. package/lib/chain/opPools/proposerPreferencesPool.js.map +1 -1
  46. package/lib/chain/options.d.ts +1 -0
  47. package/lib/chain/options.d.ts.map +1 -1
  48. package/lib/chain/seenCache/seenGossipBlockInput.d.ts +7 -0
  49. package/lib/chain/seenCache/seenGossipBlockInput.d.ts.map +1 -1
  50. package/lib/chain/seenCache/seenGossipBlockInput.js +21 -0
  51. package/lib/chain/seenCache/seenGossipBlockInput.js.map +1 -1
  52. package/lib/chain/shufflingCache.d.ts +1 -0
  53. package/lib/chain/shufflingCache.d.ts.map +1 -1
  54. package/lib/chain/shufflingCache.js +4 -0
  55. package/lib/chain/shufflingCache.js.map +1 -1
  56. package/lib/db/beacon.d.ts +2 -0
  57. package/lib/db/beacon.d.ts.map +1 -1
  58. package/lib/db/beacon.js +3 -0
  59. package/lib/db/beacon.js.map +1 -1
  60. package/lib/db/buckets.d.ts +2 -1
  61. package/lib/db/buckets.d.ts.map +1 -1
  62. package/lib/db/buckets.js +1 -0
  63. package/lib/db/buckets.js.map +1 -1
  64. package/lib/db/interface.d.ts +2 -0
  65. package/lib/db/interface.d.ts.map +1 -1
  66. package/lib/db/repositories/blockArchiveIndex.d.ts +2 -2
  67. package/lib/db/repositories/blockArchiveIndex.d.ts.map +1 -1
  68. package/lib/db/repositories/earliestAvailableSlot.d.ts +11 -0
  69. package/lib/db/repositories/earliestAvailableSlot.d.ts.map +1 -0
  70. package/lib/db/repositories/earliestAvailableSlot.js +19 -0
  71. package/lib/db/repositories/earliestAvailableSlot.js.map +1 -0
  72. package/lib/metrics/metrics/lodestar.d.ts +1 -0
  73. package/lib/metrics/metrics/lodestar.d.ts.map +1 -1
  74. package/lib/metrics/metrics/lodestar.js +4 -0
  75. package/lib/metrics/metrics/lodestar.js.map +1 -1
  76. package/lib/network/processor/gossipHandlers.d.ts.map +1 -1
  77. package/lib/network/processor/gossipHandlers.js +59 -63
  78. package/lib/network/processor/gossipHandlers.js.map +1 -1
  79. package/lib/node/nodejs.d.ts +3 -1
  80. package/lib/node/nodejs.d.ts.map +1 -1
  81. package/lib/node/nodejs.js +2 -1
  82. package/lib/node/nodejs.js.map +1 -1
  83. package/lib/sync/range/batch.d.ts +5 -5
  84. package/lib/sync/range/batch.d.ts.map +1 -1
  85. package/lib/sync/range/batch.js +11 -17
  86. package/lib/sync/range/batch.js.map +1 -1
  87. package/lib/sync/range/chain.d.ts +4 -4
  88. package/lib/sync/range/chain.d.ts.map +1 -1
  89. package/lib/sync/range/chain.js +12 -6
  90. package/lib/sync/range/chain.js.map +1 -1
  91. package/lib/sync/range/range.d.ts.map +1 -1
  92. package/lib/sync/range/range.js +25 -11
  93. package/lib/sync/range/range.js.map +1 -1
  94. package/lib/sync/unknownBlock.d.ts +5 -2
  95. package/lib/sync/unknownBlock.d.ts.map +1 -1
  96. package/lib/sync/unknownBlock.js +44 -20
  97. package/lib/sync/unknownBlock.js.map +1 -1
  98. package/lib/sync/utils/downloadByRange.d.ts +38 -14
  99. package/lib/sync/utils/downloadByRange.d.ts.map +1 -1
  100. package/lib/sync/utils/downloadByRange.js +84 -39
  101. package/lib/sync/utils/downloadByRange.js.map +1 -1
  102. package/package.json +17 -17
  103. package/src/api/impl/beacon/index.ts +15 -0
  104. package/src/api/impl/beacon/state/index.ts +31 -3
  105. package/src/api/impl/debug/index.ts +28 -19
  106. package/src/api/impl/validator/index.ts +24 -2
  107. package/src/chain/archiveStore/archiveStore.ts +18 -24
  108. package/src/chain/archiveStore/utils/pruneHistory.ts +4 -1
  109. package/src/chain/blocks/importBlock.ts +9 -3
  110. package/src/chain/chain.ts +58 -4
  111. package/src/chain/emitter.ts +7 -1
  112. package/src/chain/forkChoice/index.ts +2 -0
  113. package/src/chain/interface.ts +1 -0
  114. package/src/chain/opPools/aggregatedAttestationPool.ts +34 -10
  115. package/src/chain/opPools/proposerPreferencesPool.ts +14 -10
  116. package/src/chain/options.ts +1 -1
  117. package/src/chain/seenCache/seenGossipBlockInput.ts +23 -0
  118. package/src/chain/shufflingCache.ts +5 -0
  119. package/src/db/beacon.ts +3 -0
  120. package/src/db/buckets.ts +1 -0
  121. package/src/db/interface.ts +2 -0
  122. package/src/db/repositories/earliestAvailableSlot.ts +19 -0
  123. package/src/metrics/metrics/lodestar.ts +4 -0
  124. package/src/network/processor/gossipHandlers.ts +90 -76
  125. package/src/node/nodejs.ts +4 -0
  126. package/src/sync/range/batch.ts +14 -19
  127. package/src/sync/range/chain.ts +15 -8
  128. package/src/sync/range/range.ts +26 -12
  129. package/src/sync/unknownBlock.ts +57 -21
  130. package/src/sync/utils/downloadByRange.ts +123 -58
@@ -189,6 +189,7 @@ export enum EngineBlockSelectionReason {
189
189
  BuilderTimeout = "builder_timeout",
190
190
  BuilderPending = "builder_pending",
191
191
  BuilderNoBid = "builder_no_bid",
192
+ BuilderCircuitBreaker = "builder_circuit_breaker",
192
193
  BuilderCensorship = "builder_censorship",
193
194
  BlockValue = "block_value",
194
195
  EnginePreferred = "engine_preferred",
@@ -1160,8 +1161,21 @@ export function getValidatorApi(
1160
1161
  : {}),
1161
1162
  };
1162
1163
 
1163
- // handle shouldOverrideBuilder separately
1164
- if (
1164
+ if (circuitBreakerActive && engineResult.status === "fulfilled") {
1165
+ source = ProducedBlockSource.engine;
1166
+ bestResult = engineResult;
1167
+ metrics?.blockProductionSelectionResults.inc({
1168
+ source: ProducedBlockSource.engine,
1169
+ reason: EngineBlockSelectionReason.BuilderCircuitBreaker,
1170
+ });
1171
+ logger.info("Selected local block: builder circuit breaker is active", {
1172
+ reason: EngineBlockSelectionReason.BuilderCircuitBreaker,
1173
+ ...logCtx,
1174
+ durationMs: engineResult.durationMs,
1175
+ ...getBlockValueLogInfo(engineResult.value),
1176
+ });
1177
+ } else if (
1178
+ // handle shouldOverrideBuilder separately
1165
1179
  engineResult.status === "fulfilled" &&
1166
1180
  engineResult.value.shouldOverrideBuilder &&
1167
1181
  (builderBidExpected || bidBlockResult.status === "fulfilled")
@@ -1286,6 +1300,10 @@ export function getValidatorApi(
1286
1300
  blobs: blobsBundle.blobs,
1287
1301
  };
1288
1302
 
1303
+ if (chain.opts.persistProducedPayloadEnvelopes) {
1304
+ chain.persistExecutionPayloadEnvelope(blockContents.executionPayloadEnvelope);
1305
+ }
1306
+
1289
1307
  return {
1290
1308
  data: blockContents,
1291
1309
  meta: {version: fork, consensusBlockValue, executionPayloadValue, executionPayloadIncluded: true},
@@ -2173,6 +2191,10 @@ export function getValidatorApi(
2173
2191
  blockHash: toRootHex(executionPayload.blockHash),
2174
2192
  });
2175
2193
 
2194
+ if (chain.opts.persistProducedPayloadEnvelopes) {
2195
+ chain.persistExecutionPayloadEnvelope(envelope);
2196
+ }
2197
+
2176
2198
  return {
2177
2199
  data: envelope,
2178
2200
  meta: {
@@ -113,7 +113,9 @@ export class ArchiveStore {
113
113
  this.logger,
114
114
  this.metrics,
115
115
  this.opts.anchorState.finalizedCheckpoint.epoch,
116
- this.chain.clock.currentEpoch
116
+ this.chain.clock.currentEpoch,
117
+ this.statePruneFromSlot,
118
+ this.advanceEarliestAvailableSlot
117
119
  ),
118
120
  () => this.logger.info("Still pruning historical data, please wait..."),
119
121
  30_000,
@@ -122,26 +124,6 @@ export class ArchiveStore {
122
124
  this.statePruneFromSlot = stateCutoffSlot;
123
125
  }
124
126
 
125
- // Initialize earliestAvailableSlot from the earliest block actually retained (after any pruning
126
- // above), rather than the anchor state slot set in the constructor. On an in-place restart the DB
127
- // still holds finalized history below the anchor; leaving the value at the anchor makes the node
128
- // reject by_range requests (beacon_blocks, execution_payload_envelopes and data_column_sidecars
129
- // all gate on this slot) for data it still retains. An empty archive (e.g. a fresh checkpoint
130
- // sync with nothing below the anchor) leaves the constructor's anchor slot in place.
131
- const earliestArchivedBlockSlot = await this.db.blockArchive.firstKey();
132
- if (earliestArchivedBlockSlot != null) {
133
- const oldEarliestAvailableSlot = this.chain.earliestAvailableSlot;
134
- this.chain.earliestAvailableSlot = earliestArchivedBlockSlot;
135
- this.logger.verbose("Initialized earliestAvailableSlot from retained block archive", {
136
- oldEarliestAvailableSlot,
137
- newEarliestAvailableSlot: earliestArchivedBlockSlot,
138
- });
139
- } else {
140
- this.logger.verbose("Empty block archive on init, keeping anchor earliestAvailableSlot", {
141
- earliestAvailableSlot: this.chain.earliestAvailableSlot,
142
- });
143
- }
144
-
145
127
  if (this.opts.serveHistoricalState) {
146
128
  this.historicalStateRegen = await HistoricalStateRegen.init({
147
129
  opts: {
@@ -158,6 +140,18 @@ export class ArchiveStore {
158
140
  }
159
141
  }
160
142
 
143
+ /**
144
+ * The CLI owns the initial value; this only advances it during pruneHistory.
145
+ * Persisted before any deletion so a crash mid-prune never leaves the floor below deleted data.
146
+ */
147
+ private advanceEarliestAvailableSlot = async (blockCutoffSlot: Slot): Promise<void> => {
148
+ const earliestAvailableSlot = Math.max(this.chain.earliestAvailableSlot, blockCutoffSlot);
149
+ if (earliestAvailableSlot !== this.chain.earliestAvailableSlot) {
150
+ await this.db.earliestAvailableSlot.set(earliestAvailableSlot);
151
+ this.chain.earliestAvailableSlot = earliestAvailableSlot;
152
+ }
153
+ };
154
+
161
155
  async close(): Promise<void> {
162
156
  await this.historicalStateRegen?.close();
163
157
  }
@@ -259,17 +253,17 @@ export class ArchiveStore {
259
253
 
260
254
  if (this.opts.pruneHistory) {
261
255
  timer = this.metrics?.processFinalizedCheckpoint.durationByTask.startTimer();
262
- const {blockCutoffSlot, stateCutoffSlot} = await pruneHistory(
256
+ const {stateCutoffSlot} = await pruneHistory(
263
257
  this.chain.config,
264
258
  this.db,
265
259
  this.logger,
266
260
  this.metrics,
267
261
  finalizedEpoch,
268
262
  this.chain.clock.currentEpoch,
269
- this.statePruneFromSlot
263
+ this.statePruneFromSlot,
264
+ this.advanceEarliestAvailableSlot
270
265
  );
271
266
  this.statePruneFromSlot = stateCutoffSlot;
272
- this.chain.earliestAvailableSlot = Math.max(this.chain.earliestAvailableSlot, blockCutoffSlot);
273
267
  timer?.({source: ArchiveStoreTask.PruneHistory});
274
268
  }
275
269
 
@@ -12,7 +12,8 @@ export async function pruneHistory(
12
12
  metrics: Metrics | null | undefined,
13
13
  finalizedEpoch: Epoch,
14
14
  currentEpoch: Epoch,
15
- statePruneFromSlot: Slot = 0
15
+ statePruneFromSlot: Slot,
16
+ beforePrune: (blockCutoffSlot: Slot) => Promise<void>
16
17
  ): Promise<{blockCutoffSlot: Slot; stateCutoffSlot: Slot}> {
17
18
  const blockCutoffEpoch = Math.min(
18
19
  // set by config, with underflow protection
@@ -51,6 +52,8 @@ export async function pruneHistory(
51
52
  stateSlots: prettyPrintIndices(states),
52
53
  });
53
54
 
55
+ await beforePrune(blockCutoffSlot);
56
+
54
57
  const step1 = metrics?.pruneHistory.pruneKeys.startTimer();
55
58
  await Promise.all([
56
59
  // ->
@@ -129,11 +129,17 @@ export async function importBlock(
129
129
 
130
130
  // Should compute checkpoint balances before forkchoice.onBlock
131
131
  this.checkpointBalancesCache.processState(blockRootHex, postState);
132
- if (fork >= ForkSeq.gloas) {
132
+ if (isGloasBeaconBlock(block.message)) {
133
+ // A gloas block has no payload of its own, it inherits the status of the payload it builds on,
134
+ // i.e. the parent variant matching the bid's parent block hash. The parent's default (PENDING)
135
+ // variant does not reflect a SYNCING parent payload, and onBlock would then mark that payload VALID.
133
136
  const parentRootHex = toRootHex(block.message.parentRoot);
134
- const parentBlock = this.forkChoice.getBlockHexDefaultStatus(parentRootHex);
137
+ const parentBlockHashHex = toRootHex(block.message.body.signedExecutionPayloadBid.message.parentBlockHash);
138
+ const parentBlock = this.forkChoice.getBlockHexAndBlockHash(parentRootHex, parentBlockHashHex);
135
139
  if (parentBlock === null) {
136
- throw Error(`Parent block not found in forkChoice, parentRoot=${parentRootHex}`);
140
+ throw Error(
141
+ `Parent block not found in forkChoice, parentRoot=${parentRootHex} parentBlockHash=${parentBlockHashHex}`
142
+ );
137
143
  }
138
144
  if (parentBlock.executionStatus === ExecutionStatus.Invalid) {
139
145
  throw Error(`Parent block has invalid execution status, parentRoot=${parentRootHex}`);
@@ -244,6 +244,7 @@ export class BeaconChain implements IBeaconChain {
244
244
  protected readonly blockProcessor: BlockProcessor;
245
245
  protected readonly payloadEnvelopeProcessor: PayloadEnvelopeProcessor;
246
246
  protected readonly db: IBeaconDb;
247
+ private genesisStateRoot?: RootHex | null;
247
248
  // this is only available if nHistoricalStates is enabled
248
249
  private readonly cpStateDatastore?: CPStateDatastore;
249
250
  private abortController = new AbortController();
@@ -278,6 +279,7 @@ export class BeaconChain implements IBeaconChain {
278
279
  validatorMonitor,
279
280
  anchorState,
280
281
  isAnchorStateFinalized,
282
+ earliestAvailableSlot,
281
283
  executionEngine,
282
284
  executionBuilder,
283
285
  builderApiClientOpts,
@@ -297,6 +299,7 @@ export class BeaconChain implements IBeaconChain {
297
299
  validatorMonitor: ValidatorMonitor | null;
298
300
  anchorState: IBeaconStateView;
299
301
  isAnchorStateFinalized: boolean;
302
+ earliestAvailableSlot: Slot;
300
303
  executionEngine: IExecutionEngine;
301
304
  executionBuilder?: IExecutionBuilder;
302
305
  builderApiClientOpts?: BuilderApiClientOpts;
@@ -325,7 +328,7 @@ export class BeaconChain implements IBeaconChain {
325
328
 
326
329
  this.blacklistedBlocks = new Map((opts.blacklistedBlocks ?? []).map((hex) => [hex, null]));
327
330
  this.attestationPool = new AttestationPool(config, clock, this.opts?.preaggregateSlotDistance, metrics);
328
- this.aggregatedAttestationPool = new AggregatedAttestationPool(this.config, metrics);
331
+ this.aggregatedAttestationPool = new AggregatedAttestationPool(this.config, metrics, logger);
329
332
  this.syncCommitteeMessagePool = new SyncCommitteeMessagePool(config, clock, this.opts?.preaggregateSlotDistance);
330
333
  this.syncContributionAndProofPool = new SyncContributionAndProofPool(config, clock, metrics, logger);
331
334
  this.executionPayloadBidPool = new ExecutionPayloadBidPool();
@@ -362,7 +365,7 @@ export class BeaconChain implements IBeaconChain {
362
365
  logger,
363
366
  });
364
367
 
365
- this._earliestAvailableSlot = anchorState.slot;
368
+ this._earliestAvailableSlot = earliestAvailableSlot;
366
369
 
367
370
  this.shufflingCache = new ShufflingCache(metrics, logger, this.opts, [
368
371
  {
@@ -573,7 +576,11 @@ export class BeaconChain implements IBeaconChain {
573
576
  }
574
577
 
575
578
  seenBlock(blockRoot: RootHex): boolean {
576
- return this.seenBlockInputCache.hasBlock(blockRoot) || this.forkChoice.hasBlockHexUnsafe(blockRoot);
579
+ return (
580
+ this.seenBlockInputCache.hasBlock(blockRoot) ||
581
+ this.seenBlockInputCache.isValidatingBlock(blockRoot) ||
582
+ this.forkChoice.hasBlockHexUnsafe(blockRoot)
583
+ );
577
584
  }
578
585
 
579
586
  seenPayloadEnvelope(blockRoot: RootHex): boolean {
@@ -703,6 +710,37 @@ export class BeaconChain implements IBeaconChain {
703
710
  stateRoot: RootHex,
704
711
  opts?: StateGetOpts
705
712
  ): Promise<{state: IBeaconStateView | Uint8Array; executionOptimistic: boolean; finalized: boolean} | null> {
713
+ const finalizedBlock = this.forkChoice.getFinalizedBlock();
714
+ const finalizedCheckpoint = this.forkChoice.getFinalizedCheckpoint();
715
+ // Checkpoint state only equals the block post-state if the block is at the epoch start slot
716
+ if (
717
+ finalizedBlock.stateRoot === stateRoot &&
718
+ finalizedBlock.slot === computeStartSlotAtEpoch(finalizedCheckpoint.epoch)
719
+ ) {
720
+ const state = this.regen.getCheckpointStateSync({
721
+ epoch: finalizedCheckpoint.epoch,
722
+ rootHex: finalizedCheckpoint.rootHex,
723
+ });
724
+ if (state) {
725
+ return {
726
+ state,
727
+ executionOptimistic: isOptimisticBlock(finalizedBlock),
728
+ finalized: finalizedCheckpoint.epoch !== GENESIS_EPOCH,
729
+ };
730
+ }
731
+ }
732
+
733
+ if (this.genesisStateRoot === undefined) {
734
+ const genesisBlock = await this.db.blockArchive.get(GENESIS_SLOT);
735
+ this.genesisStateRoot = genesisBlock ? toRootHex(genesisBlock.message.stateRoot) : null;
736
+ }
737
+ if (this.genesisStateRoot === stateRoot) {
738
+ const state = await this.db.stateArchive.getBinary(GENESIS_SLOT);
739
+ if (state) {
740
+ return {state, executionOptimistic: false, finalized: finalizedCheckpoint.epoch !== GENESIS_EPOCH};
741
+ }
742
+ }
743
+
706
744
  if (opts?.allowRegen) {
707
745
  const state = await this.regen.getState(stateRoot, RegenCaller.restApi);
708
746
  const block = this.forkChoice.getBlockDefaultStatus(
@@ -1504,6 +1542,22 @@ export class BeaconChain implements IBeaconChain {
1504
1542
  }
1505
1543
  }
1506
1544
 
1545
+ persistExecutionPayloadEnvelope(envelope: gloas.ExecutionPayloadEnvelope): void {
1546
+ const blockRoot = toRootHex(envelope.beaconBlockRoot);
1547
+ void this.persistSszObject(
1548
+ "ExecutionPayloadEnvelope",
1549
+ ssz.gloas.ExecutionPayloadEnvelope.serialize(envelope),
1550
+ blockRoot,
1551
+ "produced_execution_payload_envelope"
1552
+ ).catch((e) => {
1553
+ this.logger.error(
1554
+ "Error persisting produced execution payload envelope",
1555
+ {slot: envelope.payload.slotNumber, blockRoot},
1556
+ e as Error
1557
+ );
1558
+ });
1559
+ }
1560
+
1507
1561
  /**
1508
1562
  * Invalid state root error is critical and it causes the node to stale most of the time so we want to always
1509
1563
  * persist preState, postState and block for further investigation.
@@ -1699,7 +1753,7 @@ export class BeaconChain implements IBeaconChain {
1699
1753
  // remove date suffixes in file name, and check duplicate to avoid redundant persistence
1700
1754
  await writeIfNotExist(filepath, bytes);
1701
1755
 
1702
- this.logger.debug("Persisted invalid ssz object", {id: logStr, filepath});
1756
+ this.logger.debug("Persisted SSZ object", {id: logStr, filepath});
1703
1757
  }
1704
1758
 
1705
1759
  private onScrapeMetrics(metrics: Metrics): void {
@@ -1,7 +1,7 @@
1
1
  import {EventEmitter} from "node:events";
2
2
  import {StrictEventEmitter} from "strict-event-emitter-types";
3
3
  import {routes} from "@lodestar/api";
4
- import {CheckpointWithHex} from "@lodestar/fork-choice";
4
+ import {CheckpointWithHex, PtcQuorumEvent} from "@lodestar/fork-choice";
5
5
  import {IBeaconStateView} from "@lodestar/state-transition";
6
6
  import {DataColumnSidecar, RootHex, Slot, deneb, phase0} from "@lodestar/types";
7
7
  import {PeerIdStr} from "../util/peerId.js";
@@ -36,6 +36,11 @@ export enum ChainEvent {
36
36
  * This event is guaranteed to be triggered whenever the fork choice finalized checkpoint is updated. This is either in response to a newly processed block or a new clock tick.
37
37
  */
38
38
  forkChoiceFinalized = "forkChoice:finalized",
39
+ /**
40
+ * This event signals that the PTC verdict on a block was decided: a majority against payload presence or blob data
41
+ * availability, or a majority for both.
42
+ */
43
+ forkChoicePtcQuorum = "forkChoice:ptcQuorum",
39
44
  /**
40
45
  * This event signals that dependent services (e.g. custody sampling) should update to account for the new target group count.
41
46
  */
@@ -112,6 +117,7 @@ export type IChainEvents = ApiEvents & {
112
117
 
113
118
  [ChainEvent.forkChoiceJustified]: (checkpoint: CheckpointWithHex) => void;
114
119
  [ChainEvent.forkChoiceFinalized]: (checkpoint: CheckpointWithHex) => void;
120
+ [ChainEvent.forkChoicePtcQuorum]: (data: PtcQuorumEvent) => void;
115
121
 
116
122
  [ChainEvent.updateTargetCustodyGroupCount]: (targetGroupCount: number) => void;
117
123
 
@@ -124,6 +124,7 @@ export function initializeForkChoiceFromFinalizedState(
124
124
  onFinalized: (cp) => emitter.emit(ChainEvent.forkChoiceFinalized, cp),
125
125
  onFastConfirmation: ({block, slot, currentSlot}) =>
126
126
  emitter.emit(routes.events.EventType.fastConfirmation, {block, slot, currentSlot}),
127
+ onPtcQuorum: (data) => emitter.emit(ChainEvent.forkChoicePtcQuorum, data),
127
128
  }
128
129
  ),
129
130
 
@@ -222,6 +223,7 @@ export function initializeForkChoiceFromUnfinalizedState(
222
223
  onFinalized: (cp) => emitter.emit(ChainEvent.forkChoiceFinalized, cp),
223
224
  onFastConfirmation: ({block, slot, currentSlot}) =>
224
225
  emitter.emit(routes.events.EventType.fastConfirmation, {block, slot, currentSlot}),
226
+ onPtcQuorum: (data) => emitter.emit(ChainEvent.forkChoicePtcQuorum, data),
225
227
  }
226
228
  );
227
229
 
@@ -290,6 +290,7 @@ export interface IBeaconChain {
290
290
  updateBeaconProposerData(epoch: Epoch, proposers: ProposerPreparationData[]): Promise<void>;
291
291
 
292
292
  persistBlock(data: BeaconBlock | BlindedBeaconBlock, suffix?: string): void;
293
+ persistExecutionPayloadEnvelope(envelope: gloas.ExecutionPayloadEnvelope): void;
293
294
  persistInvalidStateRoot(
294
295
  preState: IBeaconStateView,
295
296
  postState: IBeaconStateView,
@@ -30,7 +30,7 @@ import {
30
30
  isStatePostGloas,
31
31
  } from "@lodestar/state-transition";
32
32
  import {Attestation, Epoch, RootHex, Slot, electra, isElectraAttestation, phase0, ssz} from "@lodestar/types";
33
- import {MapDef, assert, toRootHex} from "@lodestar/utils";
33
+ import {Logger, MapDef, assert, toRootHex} from "@lodestar/utils";
34
34
  import {Metrics} from "../../metrics/metrics.js";
35
35
  import {IntersectResult, intersectUint8Arrays} from "../../util/bitArray.js";
36
36
  import {getShufflingDependentRoot} from "../../util/dependentRoot.js";
@@ -58,7 +58,7 @@ export type AttestationsConsolidation = {
58
58
 
59
59
  /**
60
60
  * This function returns not seen participation for a given epoch and slot and committee index.
61
- * Return null if all validators are seen or no info to check.
61
+ * Return an empty set if all validators are seen, or null if the committee cannot be computed (e.g. missing shuffling).
62
62
  */
63
63
  type GetNotSeenValidatorsFn = (epoch: Epoch, slot: Slot, committeeIndex: number) => Set<number> | null;
64
64
 
@@ -140,7 +140,8 @@ export class AggregatedAttestationPool {
140
140
 
141
141
  constructor(
142
142
  private readonly config: BeaconConfig,
143
- private readonly metrics: Metrics | null = null
143
+ private readonly metrics: Metrics | null = null,
144
+ private readonly logger: Logger | null = null
144
145
  ) {
145
146
  metrics?.opPool.aggregatedAttestationPool.attDataPerSlot.addCollect(() => this.onScrapeMetrics(metrics));
146
147
  }
@@ -244,6 +245,7 @@ export class AggregatedAttestationPool {
244
245
  const consolidations = new Map<AttestationsConsolidation, number>();
245
246
  let scannedSlots = 0;
246
247
  let stopReason: ScannedSlotsTerminationReason | null = null;
248
+ const missingShufflingCommitteesByEpoch = new Map<Epoch, number>();
247
249
  slot: for (const slot of slots) {
248
250
  const attestationGroupByIndexByDataHash = this.attestationGroupByIndexByDataHexBySlot.get(slot);
249
251
  // should not happen
@@ -295,7 +297,12 @@ export class AggregatedAttestationPool {
295
297
 
296
298
  for (const [committeeIndex, attestationGroup] of attestationGroupByIndex.entries()) {
297
299
  const notSeenCommitteeMembers = notSeenValidatorsFn(epoch, slot, committeeIndex);
298
- if (notSeenCommitteeMembers === null || notSeenCommitteeMembers.size === 0) {
300
+ if (notSeenCommitteeMembers === null) {
301
+ // skip this committee instead of failing the whole block production, other epochs may still have shuffling
302
+ missingShufflingCommitteesByEpoch.set(epoch, (missingShufflingCommitteesByEpoch.get(epoch) ?? 0) + 1);
303
+ continue;
304
+ }
305
+ if (notSeenCommitteeMembers.size === 0) {
299
306
  this.metrics?.opPool.aggregatedAttestationPool.packedAttestations.seenCommittees.inc();
300
307
  continue;
301
308
  }
@@ -386,6 +393,18 @@ export class AggregatedAttestationPool {
386
393
  scannedSlots++;
387
394
  }
388
395
 
396
+ for (const [epoch, missingCommittees] of missingShufflingCommitteesByEpoch) {
397
+ this.metrics?.opPool.aggregatedAttestationPool.packedAttestations.missingShufflingCommittees.inc(
398
+ missingCommittees
399
+ );
400
+ this.logger?.debug("Missing shuffling when packing attestations, skipped committees", {
401
+ slot: stateSlot,
402
+ epoch,
403
+ decisionRoot: state.getShufflingDecisionRoot(epoch),
404
+ missingCommittees,
405
+ });
406
+ }
407
+
389
408
  this.metrics?.opPool.aggregatedAttestationPool.packedAttestations.totalConsolidations.set(consolidations.size);
390
409
 
391
410
  const sortedConsolidationsByScore = Array.from(consolidations.entries())
@@ -770,13 +789,18 @@ export function getNotSeenValidatorsFn(
770
789
  }
771
790
  const cacheKey = slot + "_" + committeeIndex;
772
791
  let notSeenCommitteeMembers = cachedNotSeenValidators.get(cacheKey);
773
- if (notSeenCommitteeMembers != null) {
774
- // if all validators are seen then return null, we don't need to check for any attestations of same committee again
775
- return notSeenCommitteeMembers.size === 0 ? null : notSeenCommitteeMembers;
792
+ if (notSeenCommitteeMembers !== undefined) {
793
+ return notSeenCommitteeMembers;
776
794
  }
777
795
 
778
796
  const decisionRoot = state.getShufflingDecisionRoot(computeEpochAtSlot(slot));
779
- const committee = shufflingCache.getBeaconCommittee(epoch, decisionRoot, slot, committeeIndex);
797
+ const committee = shufflingCache.getBeaconCommitteeOrNull(epoch, decisionRoot, slot, committeeIndex);
798
+ if (committee === null) {
799
+ // attestations in the pool were validated against a cached shuffling of the previous or current epoch,
800
+ // so a miss is a ShufflingCache bug. Return null so the caller tracks it via metrics/logs without failing
801
+ // block production. Don't fall back to the state's shuffling, that would hide the bug
802
+ return null;
803
+ }
780
804
  notSeenCommitteeMembers = new Set<number>();
781
805
  for (const [i, validatorIndex] of committee.entries()) {
782
806
  // no need to check flagIsTimelySource as if validator is not seen, it's participation status is 0
@@ -786,8 +810,8 @@ export function getNotSeenValidatorsFn(
786
810
  }
787
811
  }
788
812
  cachedNotSeenValidators.set(cacheKey, notSeenCommitteeMembers);
789
- // if all validators are seen then return null, we don't need to check for any attestations of same committee again
790
- return notSeenCommitteeMembers.size === 0 ? null : notSeenCommitteeMembers;
813
+ // an empty set means all validators are seen, we don't need to check for any attestations of same committee again
814
+ return notSeenCommitteeMembers;
791
815
  };
792
816
  }
793
817
 
@@ -6,8 +6,8 @@ import {toRootHex} from "@lodestar/utils";
6
6
  *
7
7
  * The primary consumer is `validateExecutionPayloadBid`, which looks up the matching
8
8
  * preferences via `get(bid.slot, dependent_root)` to enforce the IGNORE-existence and
9
- * REJECT-equality rules from the gloas spec. The beacon API `/pool/proposer_preferences`
10
- * GET endpoint reads from the same pool via `getAll`.
9
+ * REJECT-equality rules from the gloas spec. The beacon API `getProposerPreferences`
10
+ * endpoint reads from the same pool via `getAll`.
11
11
  *
12
12
  * `validator_index` is intentionally not part of the key: gossip validation enforces
13
13
  * `proposers[proposalSlot % SLOTS_PER_EPOCH] === validatorIndex` against the shuffling
@@ -37,15 +37,19 @@ export class ProposerPreferencesPool {
37
37
  byRoot.set(rootHex, signed);
38
38
  }
39
39
 
40
- /** API read-out: flatten across branches, optionally filtered by slot. */
41
- getAll(slot?: Slot): gloas.SignedProposerPreferences[] {
42
- if (slot !== undefined) {
43
- const byRoot = this.bySlot.get(slot);
44
- return byRoot ? Array.from(byRoot.values()) : [];
45
- }
40
+ /** API read-out: flatten across branches, optionally filtered by slot and dependent root. */
41
+ getAll(slot?: Slot, dependentRootHex?: RootHex): gloas.SignedProposerPreferences[] {
46
42
  const out: gloas.SignedProposerPreferences[] = [];
47
- for (const byRoot of this.bySlot.values()) {
48
- for (const v of byRoot.values()) out.push(v);
43
+ for (const [s, byRoot] of this.bySlot) {
44
+ if (slot !== undefined && s !== slot) {
45
+ continue;
46
+ }
47
+ for (const [root, signed] of byRoot) {
48
+ if (dependentRootHex !== undefined && root !== dependentRootHex) {
49
+ continue;
50
+ }
51
+ out.push(signed);
52
+ }
49
53
  }
50
54
  return out;
51
55
  }
@@ -27,8 +27,8 @@ export type IChainOptions = BlockProcessOpts &
27
27
  blsVerifyAllMainThread?: boolean;
28
28
  blsVerifyAllMultiThread?: boolean;
29
29
  blacklistedBlocks?: string[];
30
- // TODO GLOAS: add similar option for execution payload envelopes?
31
30
  persistProducedBlocks?: boolean;
31
+ persistProducedPayloadEnvelopes?: boolean;
32
32
  /** Archive finalized Gloas payload envelopes as headers (bodies reconstructed from the EL on read) */
33
33
  dedupePayloads?: boolean;
34
34
  persistInvalidSszObjects?: boolean;
@@ -111,6 +111,9 @@ export class SeenBlockInput {
111
111
  // there should only 1 block root per slot but we need to always compare against rootHex
112
112
  // and the signature to ensure we only skip verification if both match
113
113
  private verifiedProposerSignatures = new Map<Slot, Map<RootHex, BLSSignature>>();
114
+ // Roots of gossip blocks under validation, counted because blocks with the same root but different signatures
115
+ // can be validated concurrently
116
+ private validatingBlockRoots = new Map<RootHex, number>();
114
117
 
115
118
  constructor({
116
119
  config,
@@ -153,6 +156,26 @@ export class SeenBlockInput {
153
156
  return this.blockInputs.get(rootHex)?.hasBlock() ?? false;
154
157
  }
155
158
 
159
+ /**
160
+ * Mark a gossip block root as under validation, every call MUST be paired with `unmarkValidatingBlock()`
161
+ */
162
+ markValidatingBlock(rootHex: RootHex): void {
163
+ this.validatingBlockRoots.set(rootHex, (this.validatingBlockRoots.get(rootHex) ?? 0) + 1);
164
+ }
165
+
166
+ unmarkValidatingBlock(rootHex: RootHex): void {
167
+ const count = this.validatingBlockRoots.get(rootHex) ?? 0;
168
+ if (count <= 1) {
169
+ this.validatingBlockRoots.delete(rootHex);
170
+ } else {
171
+ this.validatingBlockRoots.set(rootHex, count - 1);
172
+ }
173
+ }
174
+
175
+ isValidatingBlock(rootHex: RootHex): boolean {
176
+ return this.validatingBlockRoots.has(rootHex);
177
+ }
178
+
156
179
  get(rootHex: RootHex): IBlockInput | undefined {
157
180
  return this.blockInputs.get(rootHex);
158
181
  }
@@ -205,6 +205,11 @@ export class ShufflingCache {
205
205
  return this.getBeaconCommittees(epoch, decisionRoot, slot, [index])[0];
206
206
  }
207
207
 
208
+ getBeaconCommitteeOrNull(epoch: number, decisionRoot: string, slot: Slot, index: CommitteeIndex): Uint32Array | null {
209
+ const shuffling = this.getSync(epoch, decisionRoot);
210
+ return shuffling === null ? null : getBeaconCommittees(shuffling, slot, [index])[0];
211
+ }
212
+
208
213
  getBeaconCommittees(epoch: number, decisionRoot: string, slot: Slot, indices: CommitteeIndex[]): Uint32Array[] {
209
214
  const shuffling = this.getShufflingOrThrow(epoch, decisionRoot);
210
215
  return getBeaconCommittees(shuffling, slot, indices);
package/src/db/beacon.ts CHANGED
@@ -8,6 +8,7 @@ import {FlatFileStore} from "./flatFileStore/flatFileStore.js";
8
8
  import type {FlatFileStoreMetrics} from "./flatFileStore/metrics.js";
9
9
  import {IBeaconDb} from "./interface.js";
10
10
  import {CheckpointStateRepository} from "./repositories/checkpointState.js";
11
+ import {EarliestAvailableSlotRepository} from "./repositories/earliestAvailableSlot.js";
11
12
  import {
12
13
  AttesterSlashingRepository,
13
14
  BLSToExecutionChangeRepository,
@@ -48,6 +49,7 @@ export class BeaconDb implements IBeaconDb {
48
49
 
49
50
  stateArchive: StateArchiveRepository;
50
51
  checkpointState: CheckpointStateRepository;
52
+ earliestAvailableSlot: EarliestAvailableSlotRepository;
51
53
 
52
54
  voluntaryExit: VoluntaryExitRepository;
53
55
  proposerSlashing: ProposerSlashingRepository;
@@ -83,6 +85,7 @@ export class BeaconDb implements IBeaconDb {
83
85
 
84
86
  this.stateArchive = new StateArchiveRepository(config, db);
85
87
  this.checkpointState = new CheckpointStateRepository(config, db);
88
+ this.earliestAvailableSlot = new EarliestAvailableSlotRepository(db);
86
89
  this.voluntaryExit = new VoluntaryExitRepository(config, db);
87
90
  this.blsToExecutionChange = new BLSToExecutionChangeRepository(config, db);
88
91
  this.proposerSlashing = new ProposerSlashingRepository(config, db);
package/src/db/buckets.ts CHANGED
@@ -72,6 +72,7 @@ export enum Bucket {
72
72
 
73
73
  gloas_executionPayloadEnvelope = 59, // GLOAS BeaconBlockRoot -> SignedExecutionPayloadEnvelope
74
74
  gloas_executionPayloadEnvelopeArchive = 60, // GLOAS Slot -> SignedExecutionPayloadEnvelope, or 0x00 + SignedExecutionPayloadHeaderEnvelope
75
+ earliestAvailableSlot = 61, // singleton -> Slot
75
76
  }
76
77
 
77
78
  export function getBucketNameByValue<T extends Bucket>(enumValue: T): keyof typeof Bucket {
@@ -3,6 +3,7 @@ import {Slot} from "@lodestar/types";
3
3
  import type {IDataColumnStore} from "./dataColumnStore.js";
4
4
  import type {FlatFileStoreMetrics} from "./flatFileStore/metrics.js";
5
5
  import {CheckpointStateRepository} from "./repositories/checkpointState.js";
6
+ import {EarliestAvailableSlotRepository} from "./repositories/earliestAvailableSlot.js";
6
7
  import {
7
8
  AttesterSlashingRepository,
8
9
  BLSToExecutionChangeRepository,
@@ -46,6 +47,7 @@ export interface IBeaconDb {
46
47
  stateArchive: StateArchiveRepository;
47
48
  // checkpoint states
48
49
  checkpointState: CheckpointStateRepository;
50
+ earliestAvailableSlot: EarliestAvailableSlotRepository;
49
51
 
50
52
  // op pool
51
53
  voluntaryExit: VoluntaryExitRepository;
@@ -0,0 +1,19 @@
1
+ import {Db, encodeKey} from "@lodestar/db";
2
+ import {Slot, ssz} from "@lodestar/types";
3
+ import {Bucket, getBucketNameByValue} from "../buckets.js";
4
+
5
+ export class EarliestAvailableSlotRepository {
6
+ private readonly key = encodeKey(Bucket.earliestAvailableSlot, 0);
7
+ private readonly opts = {bucketId: getBucketNameByValue(Bucket.earliestAvailableSlot)};
8
+
9
+ constructor(private readonly db: Db) {}
10
+
11
+ async get(): Promise<Slot | null> {
12
+ const bytes = await this.db.get(this.key, this.opts);
13
+ return bytes === null ? null : ssz.Slot.deserialize(bytes);
14
+ }
15
+
16
+ async set(slot: Slot): Promise<void> {
17
+ await this.db.put(this.key, ssz.Slot.serialize(slot), this.opts);
18
+ }
19
+ }
@@ -1281,6 +1281,10 @@ export function createLodestarMetrics(
1281
1281
  name: "lodestar_oppool_aggregated_attestation_pool_packed_attestations_seen_committees_total",
1282
1282
  help: "Total number of committees for which all members are seen when producing packed attestations",
1283
1283
  }),
1284
+ missingShufflingCommittees: register.gauge({
1285
+ name: "lodestar_oppool_aggregated_attestation_pool_packed_attestations_missing_shuffling_committees_total",
1286
+ help: "Total number of committees skipped due to missing shuffling when producing packed attestations",
1287
+ }),
1284
1288
  },
1285
1289
  },
1286
1290
  attestationPool: {