@lodestar/beacon-node 1.51.0-dev.bdcac30ee0 → 1.51.0-dev.c0cca9aa48

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 (166) hide show
  1. package/lib/api/impl/api.js +1 -1
  2. package/lib/api/impl/api.js.map +1 -1
  3. package/lib/api/impl/beacon/blocks/index.d.ts +2 -1
  4. package/lib/api/impl/beacon/blocks/index.d.ts.map +1 -1
  5. package/lib/api/impl/beacon/blocks/index.js +24 -32
  6. package/lib/api/impl/beacon/blocks/index.js.map +1 -1
  7. package/lib/api/impl/beacon/index.d.ts +2 -1
  8. package/lib/api/impl/beacon/index.d.ts.map +1 -1
  9. package/lib/api/impl/beacon/index.js +2 -2
  10. package/lib/api/impl/beacon/index.js.map +1 -1
  11. package/lib/api/impl/validator/index.d.ts.map +1 -1
  12. package/lib/api/impl/validator/index.js +4 -1
  13. package/lib/api/impl/validator/index.js.map +1 -1
  14. package/lib/api/options.d.ts +2 -0
  15. package/lib/api/options.d.ts.map +1 -1
  16. package/lib/api/options.js +1 -0
  17. package/lib/api/options.js.map +1 -1
  18. package/lib/chain/GetBlobsTracker.d.ts +11 -0
  19. package/lib/chain/GetBlobsTracker.d.ts.map +1 -1
  20. package/lib/chain/GetBlobsTracker.js +83 -27
  21. package/lib/chain/GetBlobsTracker.js.map +1 -1
  22. package/lib/chain/archiveStore/archiveStore.d.ts.map +1 -1
  23. package/lib/chain/archiveStore/archiveStore.js +1 -0
  24. package/lib/chain/archiveStore/archiveStore.js.map +1 -1
  25. package/lib/chain/archiveStore/utils/archiveBlocks.d.ts +4 -0
  26. package/lib/chain/archiveStore/utils/archiveBlocks.d.ts.map +1 -1
  27. package/lib/chain/archiveStore/utils/archiveBlocks.js +61 -97
  28. package/lib/chain/archiveStore/utils/archiveBlocks.js.map +1 -1
  29. package/lib/chain/blocks/importBlock.d.ts.map +1 -1
  30. package/lib/chain/blocks/importBlock.js +6 -5
  31. package/lib/chain/blocks/importBlock.js.map +1 -1
  32. package/lib/chain/blocks/importExecutionPayload.d.ts +4 -1
  33. package/lib/chain/blocks/importExecutionPayload.d.ts.map +1 -1
  34. package/lib/chain/blocks/importExecutionPayload.js +7 -2
  35. package/lib/chain/blocks/importExecutionPayload.js.map +1 -1
  36. package/lib/chain/blocks/index.js +2 -2
  37. package/lib/chain/blocks/index.js.map +1 -1
  38. package/lib/chain/blocks/payloadEnvelopeProcessor.d.ts +5 -5
  39. package/lib/chain/blocks/payloadEnvelopeProcessor.js +7 -7
  40. package/lib/chain/blocks/payloadEnvelopeProcessor.js.map +1 -1
  41. package/lib/chain/blocks/verifyBlock.d.ts.map +1 -1
  42. package/lib/chain/blocks/verifyBlock.js +1 -1
  43. package/lib/chain/blocks/verifyBlock.js.map +1 -1
  44. package/lib/chain/blocks/verifyBlocksDataAvailability.d.ts.map +1 -1
  45. package/lib/chain/blocks/verifyBlocksDataAvailability.js +8 -1
  46. package/lib/chain/blocks/verifyBlocksDataAvailability.js.map +1 -1
  47. package/lib/chain/blocks/verifyPayloadsDataAvailability.d.ts +3 -3
  48. package/lib/chain/blocks/verifyPayloadsDataAvailability.d.ts.map +1 -1
  49. package/lib/chain/blocks/verifyPayloadsDataAvailability.js +13 -6
  50. package/lib/chain/blocks/verifyPayloadsDataAvailability.js.map +1 -1
  51. package/lib/chain/bls/multithread/index.js +5 -5
  52. package/lib/chain/bls/multithread/index.js.map +1 -1
  53. package/lib/chain/chain.js +4 -4
  54. package/lib/chain/chain.js.map +1 -1
  55. package/lib/chain/errors/blockError.d.ts +1 -1
  56. package/lib/chain/errors/blockError.d.ts.map +1 -1
  57. package/lib/chain/errors/blockError.js +1 -1
  58. package/lib/chain/errors/blockError.js.map +1 -1
  59. package/lib/chain/interface.d.ts +1 -2
  60. package/lib/chain/interface.d.ts.map +1 -1
  61. package/lib/chain/interface.js.map +1 -1
  62. package/lib/chain/options.d.ts +0 -1
  63. package/lib/chain/options.d.ts.map +1 -1
  64. package/lib/chain/options.js +0 -1
  65. package/lib/chain/options.js.map +1 -1
  66. package/lib/chain/regen/interface.d.ts +0 -1
  67. package/lib/chain/regen/interface.d.ts.map +1 -1
  68. package/lib/chain/regen/interface.js +0 -1
  69. package/lib/chain/regen/interface.js.map +1 -1
  70. package/lib/chain/validation/executionPayloadBid.d.ts +0 -15
  71. package/lib/chain/validation/executionPayloadBid.d.ts.map +1 -1
  72. package/lib/chain/validation/executionPayloadBid.js +0 -153
  73. package/lib/chain/validation/executionPayloadBid.js.map +1 -1
  74. package/lib/db/beacon.d.ts +7 -0
  75. package/lib/db/beacon.d.ts.map +1 -1
  76. package/lib/db/beacon.js +34 -0
  77. package/lib/db/beacon.js.map +1 -1
  78. package/lib/db/dataColumnStore.d.ts +1 -1
  79. package/lib/db/dataColumnStore.d.ts.map +1 -1
  80. package/lib/db/dataColumnStore.js +1 -4
  81. package/lib/db/dataColumnStore.js.map +1 -1
  82. package/lib/db/interface.d.ts +1 -0
  83. package/lib/db/interface.d.ts.map +1 -1
  84. package/lib/db/repositories/dataColumnSidecarArchive.d.ts +6 -0
  85. package/lib/db/repositories/dataColumnSidecarArchive.d.ts.map +1 -1
  86. package/lib/db/repositories/dataColumnSidecarArchive.js +19 -0
  87. package/lib/db/repositories/dataColumnSidecarArchive.js.map +1 -1
  88. package/lib/execution/engine/index.d.ts +1 -1
  89. package/lib/execution/engine/index.d.ts.map +1 -1
  90. package/lib/execution/engine/index.js +1 -1
  91. package/lib/execution/engine/index.js.map +1 -1
  92. package/lib/execution/engine/interface.d.ts +1 -1
  93. package/lib/execution/engine/interface.d.ts.map +1 -1
  94. package/lib/execution/engine/interface.js.map +1 -1
  95. package/lib/index.d.ts +1 -0
  96. package/lib/index.d.ts.map +1 -1
  97. package/lib/index.js +2 -0
  98. package/lib/index.js.map +1 -1
  99. package/lib/metrics/metrics/lodestar.d.ts +3 -0
  100. package/lib/metrics/metrics/lodestar.d.ts.map +1 -1
  101. package/lib/metrics/metrics/lodestar.js +5 -0
  102. package/lib/metrics/metrics/lodestar.js.map +1 -1
  103. package/lib/monitoring/service.js +1 -1
  104. package/lib/monitoring/service.js.map +1 -1
  105. package/lib/network/network.d.ts.map +1 -1
  106. package/lib/network/network.js +3 -1
  107. package/lib/network/network.js.map +1 -1
  108. package/lib/network/processor/gossipHandlers.d.ts.map +1 -1
  109. package/lib/network/processor/gossipHandlers.js +33 -21
  110. package/lib/network/processor/gossipHandlers.js.map +1 -1
  111. package/lib/node/nodejs.d.ts.map +1 -1
  112. package/lib/node/nodejs.js +9 -1
  113. package/lib/node/nodejs.js.map +1 -1
  114. package/lib/node/options.d.ts +1 -1
  115. package/lib/node/options.d.ts.map +1 -1
  116. package/lib/node/options.js +1 -1
  117. package/lib/node/options.js.map +1 -1
  118. package/lib/sync/interface.d.ts.map +1 -1
  119. package/lib/sync/interface.js.map +1 -1
  120. package/lib/sync/unknownBlock.d.ts.map +1 -1
  121. package/lib/sync/unknownBlock.js +42 -18
  122. package/lib/sync/unknownBlock.js.map +1 -1
  123. package/lib/util/queue/itemQueue.js +1 -1
  124. package/lib/util/queue/itemQueue.js.map +1 -1
  125. package/lib/util/sszBytes.js +2 -2
  126. package/lib/util/sszBytes.js.map +1 -1
  127. package/package.json +15 -15
  128. package/src/api/impl/api.ts +1 -1
  129. package/src/api/impl/beacon/blocks/index.ts +51 -60
  130. package/src/api/impl/beacon/index.ts +3 -1
  131. package/src/api/impl/validator/index.ts +4 -1
  132. package/src/api/options.ts +3 -0
  133. package/src/chain/GetBlobsTracker.ts +95 -38
  134. package/src/chain/archiveStore/archiveStore.ts +1 -0
  135. package/src/chain/archiveStore/utils/archiveBlocks.ts +76 -130
  136. package/src/chain/blocks/importBlock.ts +8 -7
  137. package/src/chain/blocks/importExecutionPayload.ts +12 -2
  138. package/src/chain/blocks/index.ts +6 -2
  139. package/src/chain/blocks/payloadEnvelopeProcessor.ts +7 -7
  140. package/src/chain/blocks/verifyBlock.ts +1 -0
  141. package/src/chain/blocks/verifyBlocksDataAvailability.ts +10 -1
  142. package/src/chain/blocks/verifyPayloadsDataAvailability.ts +16 -6
  143. package/src/chain/bls/multithread/index.ts +5 -5
  144. package/src/chain/chain.ts +4 -4
  145. package/src/chain/errors/blockError.ts +1 -1
  146. package/src/chain/interface.ts +1 -2
  147. package/src/chain/options.ts +0 -2
  148. package/src/chain/regen/interface.ts +0 -1
  149. package/src/chain/validation/executionPayloadBid.ts +0 -180
  150. package/src/db/beacon.ts +44 -0
  151. package/src/db/dataColumnStore.ts +2 -4
  152. package/src/db/interface.ts +2 -0
  153. package/src/db/repositories/dataColumnSidecarArchive.ts +20 -0
  154. package/src/execution/engine/index.ts +1 -1
  155. package/src/execution/engine/interface.ts +1 -1
  156. package/src/index.ts +2 -0
  157. package/src/metrics/metrics/lodestar.ts +5 -0
  158. package/src/monitoring/service.ts +1 -1
  159. package/src/network/network.ts +3 -1
  160. package/src/network/processor/gossipHandlers.ts +41 -23
  161. package/src/node/nodejs.ts +18 -1
  162. package/src/node/options.ts +4 -5
  163. package/src/sync/interface.ts +1 -0
  164. package/src/sync/unknownBlock.ts +47 -28
  165. package/src/util/queue/itemQueue.ts +1 -1
  166. package/src/util/sszBytes.ts +2 -2
@@ -83,186 +83,6 @@ function isBidCompatibleWithHead(
83
83
  return buildsOnParentPayload;
84
84
  }
85
85
 
86
- /**
87
- * Validation for bids submitted via the API by the operator's own builder.
88
- *
89
- * Only non-transient checks are applied: slot later than parent, zero execution payment, blob
90
- * commitment count, builder eligibility, version and balance coverage, prev_randao, and signature.
91
- * Transient gossip rules (head compatibility, first bid per tuple, value increment, proposer
92
- * preferences) are not applied, since those only limit forwarding of peers' messages and the
93
- * builder may legitimately bid on a branch this node does not consider head.
94
- * The parent-payload builder-exit rule is omitted because this endpoint only accepts bids from
95
- * the operator's own builder.
96
- *
97
- * Throws on any failed check. Also throws if the bid's parent block is unknown or its state is
98
- * unavailable, since the checks cannot be evaluated against the parent branch.
99
- */
100
- export async function validateApiExecutionPayloadBid(
101
- chain: IBeaconChain,
102
- signedExecutionPayloadBid: gloas.SignedExecutionPayloadBid
103
- ): Promise<void> {
104
- const bid = signedExecutionPayloadBid.message;
105
- const bidParentBlockRoot = toRootHex(bid.parentBlockRoot);
106
-
107
- // [REJECT] `bid.execution_payment` is zero.
108
- if (bid.executionPayment !== 0n) {
109
- throw new ExecutionPayloadBidError(GossipAction.REJECT, {
110
- code: ExecutionPayloadBidErrorCode.NON_ZERO_EXECUTION_PAYMENT,
111
- builderIndex: bid.builderIndex,
112
- executionPayment: bid.executionPayment,
113
- });
114
- }
115
-
116
- // [REJECT] The bid's block hash is not equal to its parent block hash -- i.e.
117
- // `bid.block_hash != bid.parent_block_hash`.
118
- if (byteArrayEquals(bid.blockHash, bid.parentBlockHash)) {
119
- throw new ExecutionPayloadBidError(GossipAction.REJECT, {
120
- code: ExecutionPayloadBidErrorCode.BLOCK_HASH_EQUALS_PARENT_BLOCK_HASH,
121
- blockHash: toRootHex(bid.blockHash),
122
- });
123
- }
124
-
125
- // [REJECT] The length of KZG commitments is less than or equal to the limitation defined in the
126
- // consensus layer -- i.e. validate that
127
- // `len(bid.blob_kzg_commitments) <= get_blob_parameters(compute_epoch_at_slot(bid.slot)).max_blobs_per_block`.
128
- const blobKzgCommitmentsLen = bid.blobKzgCommitments.length;
129
- const maxBlobsPerBlock = chain.config.getMaxBlobsPerBlock(computeEpochAtSlot(bid.slot));
130
- if (blobKzgCommitmentsLen > maxBlobsPerBlock) {
131
- throw new ExecutionPayloadBidError(GossipAction.REJECT, {
132
- code: ExecutionPayloadBidErrorCode.TOO_MANY_KZG_COMMITMENTS,
133
- blobKzgCommitmentsLen,
134
- commitmentLimit: maxBlobsPerBlock,
135
- });
136
- }
137
-
138
- // [IGNORE] `bid.slot` is the current slot, or the next slot (`bid.slot - 1` is current), allowing for `MAXIMUM_GOSSIP_CLOCK_DISPARITY`.
139
- if (
140
- !chain.clock.isCurrentSlotGivenGossipDisparity(bid.slot) &&
141
- !chain.clock.isCurrentSlotGivenGossipDisparity(bid.slot - 1)
142
- ) {
143
- throw new ExecutionPayloadBidError(GossipAction.IGNORE, {
144
- code: ExecutionPayloadBidErrorCode.INVALID_SLOT,
145
- builderIndex: bid.builderIndex,
146
- slot: bid.slot,
147
- });
148
- }
149
-
150
- // [IGNORE] The bid is received after the inclusion list deadline of `bid.slot - 1`
151
- if (
152
- isForkPostHeze(chain.config.getForkName(bid.slot)) &&
153
- chain.clock.msFromSlot(bid.slot - 1) < chain.config.getInclusionListDueMs(chain.config.getForkName(bid.slot - 1))
154
- ) {
155
- throw new ExecutionPayloadBidError(GossipAction.IGNORE, {
156
- code: ExecutionPayloadBidErrorCode.BEFORE_INCLUSION_LIST_DEADLINE,
157
- builderIndex: bid.builderIndex,
158
- slot: bid.slot,
159
- });
160
- }
161
-
162
- // [IGNORE] `bid.parent_block_root` is the hash tree root of a known beacon block in fork choice.
163
- // Moved earlier than the spec ordering so we can derive the proposer dependent root for the
164
- // proposer-preferences lookup below from a known fork-choice block.
165
- const parentBlock = chain.forkChoice.getBlockHexDefaultStatus(bidParentBlockRoot);
166
- if (parentBlock === null) {
167
- throw new ExecutionPayloadBidError(GossipAction.IGNORE, {
168
- code: ExecutionPayloadBidErrorCode.UNKNOWN_BLOCK_ROOT,
169
- parentBlockRoot: bidParentBlockRoot,
170
- });
171
- }
172
-
173
- // [REJECT] The bid is for a higher slot than its parent block -- i.e.
174
- // validate that `bid.slot` is greater than the slot of the block with root
175
- // `bid.parent_block_root`.
176
- if (bid.slot <= parentBlock.slot) {
177
- throw new ExecutionPayloadBidError(GossipAction.REJECT, {
178
- code: ExecutionPayloadBidErrorCode.NOT_LATER_THAN_PARENT,
179
- parentSlot: parentBlock.slot,
180
- slot: bid.slot,
181
- });
182
- }
183
-
184
- const state = await chain.regen
185
- .getBlockSlotState(parentBlock, bid.slot, {dontTransferCache: true}, RegenCaller.validateApiExecutionPayloadBid)
186
- .catch(() => {
187
- throw new ExecutionPayloadBidError(GossipAction.IGNORE, {
188
- code: ExecutionPayloadBidErrorCode.UNKNOWN_BLOCK_ROOT,
189
- parentBlockRoot: bidParentBlockRoot,
190
- });
191
- });
192
-
193
- if (!isStatePostGloas(state)) {
194
- throw new Error(`Expected gloas+ state for execution payload bid validation, got fork=${state.forkName}`);
195
- }
196
-
197
- // [REJECT] `bid.builder_index` is within bounds -- i.e. `bid.builder_index < len(state.builders)`.
198
- // `state.getBuilder` returns a lazy SSZ `getReadonly` view that is not bounds-checked eagerly; an
199
- // out-of-range index only throws (`LeafNode has no right node`) on deferred field access (e.g. inside
200
- // `isActiveBuilder`), escaping a try/catch around `getBuilder`. Check the length explicitly instead.
201
- if (bid.builderIndex >= state.getBuildersLength()) {
202
- throw new ExecutionPayloadBidError(GossipAction.REJECT, {
203
- code: ExecutionPayloadBidErrorCode.BUILDER_NOT_ELIGIBLE,
204
- builderIndex: bid.builderIndex,
205
- });
206
- }
207
-
208
- // [REJECT] `bid.builder_index` is a valid/active builder index -- i.e.
209
- // `is_active_builder(state, bid.builder_index)` returns `True`.
210
- const builder = state.getBuilder(bid.builderIndex);
211
- if (!isActiveBuilder(builder, state.finalizedCheckpoint.epoch)) {
212
- throw new ExecutionPayloadBidError(GossipAction.REJECT, {
213
- code: ExecutionPayloadBidErrorCode.BUILDER_NOT_ELIGIBLE,
214
- builderIndex: bid.builderIndex,
215
- });
216
- }
217
-
218
- // [REJECT] The builder version is `PAYLOAD_BUILDER_VERSION` -- i.e.
219
- // `state.builders[bid.builder_index].version == PAYLOAD_BUILDER_VERSION`.
220
- if (builder.version !== PAYLOAD_BUILDER_VERSION) {
221
- throw new ExecutionPayloadBidError(GossipAction.REJECT, {
222
- code: ExecutionPayloadBidErrorCode.INVALID_BUILDER_VERSION,
223
- builderIndex: bid.builderIndex,
224
- version: builder.version,
225
- expectedVersion: PAYLOAD_BUILDER_VERSION,
226
- });
227
- }
228
-
229
- // [IGNORE] `bid.value` is less or equal than the builder's excess balance --
230
- // i.e. `can_builder_cover_bid(state, builder_index, amount)` returns `True`.
231
- if (!state.canBuilderCoverBid(bid.builderIndex, bid.value)) {
232
- throw new ExecutionPayloadBidError(GossipAction.IGNORE, {
233
- code: ExecutionPayloadBidErrorCode.BID_TOO_HIGH,
234
- bidValue: bid.value,
235
- builderBalance: builder.balance,
236
- });
237
- }
238
-
239
- // [REJECT] `bid.prev_randao` is the correct RANDAO mix -- i.e. validate that
240
- // `bid.prev_randao == get_randao_mix(parent_state, get_current_epoch(parent_state))`.
241
- const randaoMix = state.getRandaoMix(computeEpochAtSlot(state.slot));
242
- if (!byteArrayEquals(bid.prevRandao, randaoMix)) {
243
- throw new ExecutionPayloadBidError(GossipAction.REJECT, {
244
- code: ExecutionPayloadBidErrorCode.INVALID_PREV_RANDAO,
245
- builderIndex: bid.builderIndex,
246
- bidPrevRandao: toHex(bid.prevRandao),
247
- expectedPrevRandao: toHex(randaoMix),
248
- });
249
- }
250
-
251
- // [REJECT] `signed_execution_payload_bid.signature` is valid with respect to the `bid.builder_index`.
252
- const signatureSet = createSingleSignatureSetFromComponents(
253
- builder.pubkey,
254
- getExecutionPayloadBidSigningRoot(chain.config, bid),
255
- signedExecutionPayloadBid.signature
256
- );
257
- if (!(await chain.bls.verifySignatureSets([signatureSet]))) {
258
- throw new ExecutionPayloadBidError(GossipAction.REJECT, {
259
- code: ExecutionPayloadBidErrorCode.INVALID_SIGNATURE,
260
- builderIndex: bid.builderIndex,
261
- slot: bid.slot,
262
- });
263
- }
264
- }
265
-
266
86
  export async function validateGossipExecutionPayloadBid(
267
87
  chain: IBeaconChain,
268
88
  signedExecutionPayloadBid: gloas.SignedExecutionPayloadBid
package/src/db/beacon.ts CHANGED
@@ -30,6 +30,9 @@ import {
30
30
  VoluntaryExitRepository,
31
31
  } from "./repositories/index.js";
32
32
 
33
+ /** Below this size, seeks over leftover legacy column data stay cheap */
34
+ const LEGACY_DATA_COLUMNS_COMPACTION_MIN_BYTES = 1024 ** 3;
35
+
33
36
  export type BeaconDbOpts = {
34
37
  dataColumnDir: string;
35
38
  logger: Logger;
@@ -67,6 +70,7 @@ export class BeaconDb implements IBeaconDb {
67
70
  readonly dataColumns: IDataColumnStore;
68
71
  lastLegacyArchiveSlot: Slot | null = null;
69
72
  private readonly flatFileStore: FlatFileStore;
73
+ private readonly logger: Logger;
70
74
 
71
75
  constructor(
72
76
  config: ChainForkConfig,
@@ -100,6 +104,7 @@ export class BeaconDb implements IBeaconDb {
100
104
  this.syncCommittee = new SyncCommitteeRepository(config, db);
101
105
  this.syncCommitteeWitness = new SyncCommitteeWitnessRepository(config, db);
102
106
 
107
+ this.logger = opts.logger;
103
108
  this.flatFileStore = new FlatFileStore(opts.dataColumnDir, config, opts.logger, opts.metrics);
104
109
  this.dataColumns = new LegacyDataColumnStore(
105
110
  this.flatFileStore,
@@ -125,11 +130,50 @@ export class BeaconDb implements IBeaconDb {
125
130
  this.flatFileStore.setMetrics(flatFileStoreMetrics);
126
131
  }
127
132
 
133
+ /**
134
+ * Deletes made while an iterator held a snapshot can stay in the bottom LevelDB level, which `compactRange` never
135
+ * rewrites, so every seek into the legacy column buckets walks them. Writing a key at each end of the pruned range
136
+ * makes the compaction overlap those files and rewrite them.
137
+ */
138
+ async compactLegacyDataColumns(
139
+ prunedBeforeSlot: Slot,
140
+ minSizeBytes = LEGACY_DATA_COLUMNS_COMPACTION_MIN_BYTES
141
+ ): Promise<void> {
142
+ const archiveBucket = Bucket.allForks_dataColumnSidecarsArchive;
143
+ const start = encodeKey(Bucket.allForks_dataColumnSidecars, Buffer.alloc(0));
144
+ const end = encodeKey(archiveBucket, this.dataColumnSidecarArchive.getMinKeyRaw(prunedBeforeSlot));
145
+ const sizeBytes = await this.db.approximateSize(start, end);
146
+ if (sizeBytes < minSizeBytes) return;
147
+
148
+ // Column indices stay below 0xffff and hot column keys are shorter, so no sentinel matches a real key
149
+ const upperSentinel =
150
+ prunedBeforeSlot > 0
151
+ ? encodeKey(archiveBucket, this.dataColumnSidecarArchive.encodeKeyRaw(prunedBeforeSlot - 1, 0xffff))
152
+ : encodeKey(Bucket.allForks_dataColumnSidecars, Buffer.alloc(35, 0xff));
153
+ const sentinels = [start, upperSentinel];
154
+
155
+ this.logger.info("Compacting legacy data columns, this may take a while", {sizeBytes});
156
+ const startTime = Date.now();
157
+ await this.db.batchPut(sentinels.map((key) => ({key, value: new Uint8Array()})));
158
+ await this.db.compactRange(start, end);
159
+ await this.db.batchDelete(sentinels);
160
+ await this.db.compactRange(start, end);
161
+ this.logger.verbose("Compacted legacy data columns", {
162
+ durationMs: Date.now() - startTime,
163
+ sizeBytes: await this.db.approximateSize(start, end),
164
+ });
165
+ }
166
+
128
167
  async pruneHotDb(): Promise<void> {
129
168
  // Prune all hot blobs
130
169
  await this.blobSidecars.batchDelete(await this.blobSidecars.keys());
131
170
  // New columns are persisted in flat files, so this bucket only contains legacy hot data.
132
171
  await this.deleteBucketData(Bucket.allForks_dataColumnSidecars);
172
+ // Compact even if empty to reclaim tombstones left by previous startups.
173
+ await this.db.compactRange(
174
+ encodeKey(Bucket.allForks_dataColumnSidecars, Buffer.alloc(0)),
175
+ encodeKey(Bucket.allForks_dataColumnSidecars + 1, Buffer.alloc(0))
176
+ );
133
177
  // Prune all hot blocks
134
178
  // TODO: Enable once it's deemed safe
135
179
  // await this.block.batchDelete(await this.block.keys());
@@ -13,7 +13,7 @@ export type IndexedDataColumnBytes = {index: ColumnIndex; data: Uint8Array};
13
13
  type LegacyHotDataColumnStore = Pick<DataColumnSidecarRepository, "values" | "getManyBinary" | "deleteMany">;
14
14
  type LegacyArchiveDataColumnStore = Pick<
15
15
  DataColumnSidecarArchiveRepository,
16
- "values" | "getManyBinary" | "keys" | "deleteMany"
16
+ "values" | "getManyBinary" | "pruneBefore"
17
17
  >;
18
18
  type BlockRootIndex = Pick<BlockArchiveRepository, "getSlotByRoot">;
19
19
 
@@ -86,9 +86,7 @@ export class LegacyDataColumnStore implements IDataColumnStore {
86
86
 
87
87
  async pruneBefore(slot: Slot): Promise<Slot[]> {
88
88
  const flatFileSlots = await this.flatFiles.pruneBefore(slot);
89
- const prefixedKeys = await this.legacyArchive.keys({lt: {prefix: slot, id: 0}});
90
- const slots = [...new Set(prefixedKeys.map(({prefix}) => prefix))];
91
- if (slots.length > 0) await this.legacyArchive.deleteMany(slots);
89
+ const slots = await this.legacyArchive.pruneBefore(slot);
92
90
  return [...new Set([...flatFileSlots, ...slots])].sort((a, b) => a - b);
93
91
  }
94
92
  }
@@ -68,6 +68,8 @@ export interface IBeaconDb {
68
68
  readonly lastLegacyArchiveSlot: Slot | null;
69
69
  init(): Promise<void>;
70
70
 
71
+ compactLegacyDataColumns(prunedBeforeSlot: Slot, minSizeBytes?: number): Promise<void>;
72
+
71
73
  pruneHotDb(): Promise<void>;
72
74
 
73
75
  deleteDeprecatedEth1Data(): Promise<void>;
@@ -15,6 +15,8 @@ const SLOT_BYTE_SIZE = 8;
15
15
  * Indexed data by `slot` + `columnIndex`
16
16
  */
17
17
  export class DataColumnSidecarArchiveRepository extends PrefixedRepository<Slot, ColumnIndex, DataColumnSidecar> {
18
+ private prunedBeforeSlot: Slot | null = null;
19
+
18
20
  constructor(config: ChainForkConfig, db: Db) {
19
21
  const bucket = Bucket.allForks_dataColumnSidecarsArchive;
20
22
  // Type won't be used since we select it dynamically based on fork
@@ -70,4 +72,22 @@ export class DataColumnSidecarArchiveRepository extends PrefixedRepository<Slot,
70
72
  encodeNumberForDbKey(0, COLUMN_INDEX_BYTE_SIZE),
71
73
  ]);
72
74
  }
75
+
76
+ /**
77
+ * Deletes all entries before `slot`. Prunes only delete from the start of the bucket, so the first prune
78
+ * compacts the range to drop tombstones of earlier runs and later prunes resume where the previous one ended.
79
+ */
80
+ async pruneBefore(slot: Slot): Promise<Slot[]> {
81
+ if (this.prunedBeforeSlot === null) {
82
+ await this.db.compactRange(this.wrapKey(this.getMinKeyRaw(0)), this.wrapKey(this.getMinKeyRaw(slot)));
83
+ } else if (slot <= this.prunedBeforeSlot) {
84
+ return [];
85
+ }
86
+
87
+ const keys = await this.keys({gte: {prefix: this.prunedBeforeSlot ?? 0, id: 0}, lt: {prefix: slot, id: 0}});
88
+ const slots = [...new Set(keys.map(({prefix}) => prefix))];
89
+ if (slots.length > 0) await this.deleteMany(slots);
90
+ this.prunedBeforeSlot = slot;
91
+ return slots;
92
+ }
73
93
  }
@@ -17,8 +17,8 @@ import {EngineRestHttpClient} from "./restHttpClient.js";
17
17
  import {RestEngineTransport, formatClientVersionHeader} from "./restTransport.js";
18
18
  import {ExecutionEngineMockJsonRpcClient, JsonRpcBackend} from "./utils.js";
19
19
 
20
- export {ExecutionEngineHttp, ExecutionEngineDisabled, defaultExecutionEngineHttpOpts, engineApiModes};
21
20
  export type {EngineApiMode};
21
+ export {ExecutionEngineDisabled, ExecutionEngineHttp, defaultExecutionEngineHttpOpts, engineApiModes};
22
22
 
23
23
  export type ExecutionEngineOpts =
24
24
  | ({mode?: "http"} & ExecutionEngineHttpOpts)
@@ -25,7 +25,7 @@ import {PayloadId, PayloadIdCache, WithdrawalV1} from "./payloadIdCache.js";
25
25
  import {ExecutionPayloadBodyV2} from "./types.js";
26
26
  import {DATA} from "./utils.js";
27
27
 
28
- export {PayloadIdCache, type PayloadId, type WithdrawalV1};
28
+ export {type PayloadId, PayloadIdCache, type WithdrawalV1};
29
29
  export type ClientVersion = routes.node.ClientVersion;
30
30
  export const ClientCode = routes.node.ClientCode;
31
31
 
package/src/index.ts CHANGED
@@ -6,6 +6,8 @@ export {persistAnchorState} from "./chain/index.js";
6
6
  export {DbCPStateDatastore} from "./chain/stateCache/datastore/db.js";
7
7
  export {FileCPStateDatastore} from "./chain/stateCache/datastore/file.js";
8
8
  export {BeaconDb, type IBeaconDb} from "./db/index.js";
9
+ // Export execution engine to make it usable by builder
10
+ export {initializeExecutionEngine} from "./execution/index.js";
9
11
  // Export metrics utilities to de-duplicate validator metrics
10
12
  export {
11
13
  type HttpMetricsServer,
@@ -1474,6 +1474,11 @@ export function createLodestarMetrics(
1474
1474
  help: "Total number of InsertOutcome as a result of adding an execution payload bid from gossip to the pool",
1475
1475
  labelNames: ["insertOutcome"],
1476
1476
  }),
1477
+ apiInsertOutcome: register.counter<{insertOutcome: InsertOutcome}>({
1478
+ name: "lodestar_oppool_execution_payload_bid_pool_api_insert_outcome_total",
1479
+ help: "Total number of InsertOutcome as a result of adding an execution payload bid from api to the pool",
1480
+ labelNames: ["insertOutcome"],
1481
+ }),
1477
1482
  apiValidationTime: register.histogram({
1478
1483
  name: "lodestar_api_execution_payload_bid_validation_time_seconds",
1479
1484
  help: "Time elapsed for signed execution payload bid validation - api path",
@@ -101,7 +101,7 @@ export class MonitoringService {
101
101
  if (this.monitoringInterval) {
102
102
  clearTimeout(this.monitoringInterval);
103
103
  }
104
- if (this.pendingRequest) {
104
+ if (this.pendingRequest !== undefined) {
105
105
  this.fetchAbortController?.abort(FetchAbortReason.Close);
106
106
  await this.pendingRequest;
107
107
  }
@@ -855,7 +855,9 @@ export class Network implements INetwork {
855
855
  };
856
856
 
857
857
  private onTargetGroupCountUpdated = (count: number): void => {
858
- this.core.setTargetGroupCount(count);
858
+ this.core.setTargetGroupCount(count).catch((e) => {
859
+ this.logger.debug("Error setting target custody group count", {count}, e as Error);
860
+ });
859
861
  };
860
862
 
861
863
  private onPublishDataColumns = async (sidecars: DataColumnSidecar[]): Promise<void> => {
@@ -24,6 +24,7 @@ import {
24
24
  deneb,
25
25
  fulu,
26
26
  gloas,
27
+ isGloasBeaconBlock,
27
28
  isGloasDataColumnSidecar,
28
29
  ssz,
29
30
  sszTypesFor,
@@ -150,6 +151,31 @@ export function getGossipHandlers(modules: ValidatorFnsModules, options: GossipH
150
151
  */
151
152
  function getSequentialHandlers(modules: ValidatorFnsModules, options: GossipHandlerOpts): SequentialGossipHandlers {
152
153
  const {chain, config, metrics, logger, core} = modules;
154
+ const incompletePayloadWaits = new WeakSet<PayloadEnvelopeInput>();
155
+
156
+ function scheduleIncompletePayloadEnvelope(payloadInput: PayloadEnvelopeInput, peer: string): void {
157
+ if (payloadInput.isComplete() || incompletePayloadWaits.has(payloadInput)) {
158
+ return;
159
+ }
160
+ incompletePayloadWaits.add(payloadInput);
161
+
162
+ const fork = config.getForkName(payloadInput.slot);
163
+ const cutoffTimeMs = getCutoffTimeMs(chain, payloadInput.slot, config.getPayloadDueMs(fork));
164
+ payloadInput.waitForEnvelopeAndAllData(cutoffTimeMs).catch(() => {
165
+ if (
166
+ payloadInput.isComplete() ||
167
+ chain.seenPayloadEnvelopeInputCache.get(payloadInput.blockRootHex) !== payloadInput
168
+ ) {
169
+ return;
170
+ }
171
+ chain.logger.debug("Payload envelope incomplete at payload deadline", payloadInput.getLogMeta());
172
+ chain.emitter.emit(ChainEvent.incompletePayloadEnvelope, {
173
+ payloadInput,
174
+ peer,
175
+ source: BlockInputSource.gossip,
176
+ });
177
+ });
178
+ }
153
179
 
154
180
  /**
155
181
  * Add a gossip block to the seen caches. The proposer signature of the block MUST be verified.
@@ -692,11 +718,10 @@ function getSequentialHandlers(modules: ValidatorFnsModules, options: GossipHand
692
718
 
693
719
  if (e instanceof BlockError) {
694
720
  switch (e.type.code) {
695
- case BlockErrorCode.DATA_UNAVAILABLE: {
696
- // Error is quite frequent and not critical
721
+ case BlockErrorCode.DATA_UNAVAILABLE:
722
+ // Data did not arrive in time, BlockInputSync keeps pulling it and retries the import
697
723
  logLevel = LogLevel.debug;
698
724
  break;
699
- }
700
725
  // ALREADY_KNOWN should not happen with ignoreIfKnown=true above
701
726
  // PARENT_BLOCK_UNKNOWN should not happen, we handled this in validateBeaconBlock() function above
702
727
  case BlockErrorCode.ALREADY_KNOWN:
@@ -764,7 +789,12 @@ function getSequentialHandlers(modules: ValidatorFnsModules, options: GossipHand
764
789
  // roots per proposer and slot, which bounds full imports over gossip to one alternate
765
790
  chain.seenBlockProposers.hasBlockRoot(signedBlock.message.slot, e.type.proposerIndex, e.type.root) &&
766
791
  // A sibling with an unknown parent cannot be imported, sync fetches it if its branch becomes relevant
767
- chain.forkChoice.getBlockHexDefaultStatus(toRootHex(signedBlock.message.parentRoot)) !== null
792
+ chain.forkChoice.getBlockHexDefaultStatus(toRootHex(signedBlock.message.parentRoot)) !== null &&
793
+ (!isGloasBeaconBlock(signedBlock.message) ||
794
+ chain.forkChoice.getBlockHexAndBlockHash(
795
+ toRootHex(signedBlock.message.parentRoot),
796
+ toRootHex(signedBlock.message.body.signedExecutionPayloadBid.message.parentBlockHash)
797
+ ) !== null)
768
798
  ) {
769
799
  const blockInput = cacheSignatureVerifiedBlock(
770
800
  signedBlock,
@@ -902,25 +932,7 @@ function getSequentialHandlers(modules: ValidatorFnsModules, options: GossipHand
902
932
  // envelope arrival (gossip or API). An in-flight importExecutionPayload is awaiting
903
933
  // payloadInput.waitForAllData(); addColumn above will resolve it once hasAllData flips.
904
934
 
905
- if (!payloadInput.isComplete()) {
906
- const cutoffTimeMs = getCutoffTimeMs(chain, dataColumnSlot, BLOCK_AVAILABILITY_CUTOFF_MS);
907
- // do not await here to not delay gossip validation
908
- payloadInput.waitForEnvelopeAndAllData(cutoffTimeMs).catch((_e) => {
909
- chain.logger.debug(
910
- "Waited for envelope and data after receiving gossip column. Cut-off reached so emitting incompletePayloadEnvelope",
911
- {
912
- dataColumnIndex: index,
913
- ...payloadInputMeta,
914
- }
915
- );
916
- // TODO GLOAS: UnknownBlockSync to handle this event
917
- chain.emitter.emit(ChainEvent.incompletePayloadEnvelope, {
918
- payloadInput,
919
- peer: peerIdStr,
920
- source: BlockInputSource.gossip,
921
- });
922
- });
923
- }
935
+ scheduleIncompletePayloadEnvelope(payloadInput, peerIdStr);
924
936
  } catch (e) {
925
937
  logger.debug(
926
938
  "Error handling gossip data column",
@@ -1330,6 +1342,8 @@ function getSequentialHandlers(modules: ValidatorFnsModules, options: GossipHand
1330
1342
  peerIdStr,
1331
1343
  });
1332
1344
 
1345
+ scheduleIncompletePayloadEnvelope(payloadInput, peerIdStr);
1346
+
1333
1347
  chain.emitter.emit(routes.events.EventType.executionPayloadGossip, {
1334
1348
  slot,
1335
1349
  builderIndex: envelope.builderIndex,
@@ -1343,6 +1357,10 @@ function getSequentialHandlers(modules: ValidatorFnsModules, options: GossipHand
1343
1357
 
1344
1358
  if (e instanceof PayloadError) {
1345
1359
  switch (e.type.code) {
1360
+ case PayloadErrorCode.DATA_UNAVAILABLE:
1361
+ // Columns did not arrive in time, BlockInputSync keeps pulling them and retries the import
1362
+ logLevel = LogLevel.debug;
1363
+ break;
1346
1364
  // BLOCK_NOT_IN_FORK_CHOICE should not happen, validateGossipExecutionPayloadEnvelope above
1347
1365
  // already verified the block is in fork choice
1348
1366
  case PayloadErrorCode.BLOCK_NOT_IN_FORK_CHOICE:
@@ -13,11 +13,17 @@ import {BeaconApiMethods} from "@lodestar/api/beacon/server";
13
13
  import {BeaconConfig} from "@lodestar/config";
14
14
  import type {LoggerNode} from "@lodestar/logger/node";
15
15
  import {ZERO_HASH_HEX} from "@lodestar/params";
16
- import {IBeaconStateView, isStatePostBellatrix, isStatePostGloas} from "@lodestar/state-transition";
16
+ import {
17
+ IBeaconStateView,
18
+ computeStartSlotAtEpoch,
19
+ isStatePostBellatrix,
20
+ isStatePostGloas,
21
+ } from "@lodestar/state-transition";
17
22
  import {Slot} from "@lodestar/types";
18
23
  import {sleep, toRootHex} from "@lodestar/utils";
19
24
  import {ProcessShutdownCallback} from "@lodestar/validator";
20
25
  import {BeaconRestApiServer, getApi} from "../api/index.js";
26
+ import {getDataColumnSidecarsMinEpoch} from "../chain/archiveStore/utils/archiveBlocks.js";
21
27
  import {BeaconChain, IBeaconChain, initBeaconMetrics} from "../chain/index.js";
22
28
  import {ValidatorMonitor, createValidatorMonitor} from "../chain/validatorMonitor.js";
23
29
  import {IBeaconDb} from "../db/index.js";
@@ -212,6 +218,17 @@ export class BeaconNode {
212
218
 
213
219
  const clock = new Clock({config, genesisTime: anchorState.genesisTime, signal});
214
220
 
221
+ // Before any lookup into the legacy column buckets, which can be slow until compacted
222
+ const columnsMinEpoch =
223
+ opts.chain.archiveDataEpochs === Infinity
224
+ ? null
225
+ : getDataColumnSidecarsMinEpoch(config, clock.currentEpoch, opts.chain.archiveDataEpochs);
226
+ await db.compactLegacyDataColumns(
227
+ columnsMinEpoch !== null && columnsMinEpoch >= config.FULU_FORK_EPOCH
228
+ ? computeStartSlotAtEpoch(columnsMinEpoch)
229
+ : 0
230
+ );
231
+
215
232
  await db.init();
216
233
 
217
234
  // Prune hot db repos
@@ -19,16 +19,15 @@ import {SyncOptions, defaultSyncOptions} from "../sync/options.js";
19
19
 
20
20
  // Re-export so the CLI doesn't need to depend on lodestar-api
21
21
  export {allNamespaces} from "../api/rest/index.js";
22
-
22
+ export type {EngineApiMode};
23
23
  // Re-export to use as default values in CLI args
24
24
  export {
25
- defaultExecutionEngineHttpOpts,
26
- defaultExecutionBuilderHttpOpts,
27
- engineApiModes,
28
25
  ArchiveMode,
29
26
  DEFAULT_ARCHIVE_MODE,
27
+ defaultExecutionBuilderHttpOpts,
28
+ defaultExecutionEngineHttpOpts,
29
+ engineApiModes,
30
30
  };
31
- export type {EngineApiMode};
32
31
 
33
32
  export interface IBeaconNodeOptions {
34
33
  api: ApiOptions;
@@ -7,6 +7,7 @@ import {IBeaconDb} from "../db/index.js";
7
7
  import {Metrics} from "../metrics/index.js";
8
8
  import {INetwork} from "../network/index.js";
9
9
  import {SyncChainDebugState} from "./range/chain.js";
10
+
10
11
  export type {SyncChainDebugState};
11
12
 
12
13
  export type SyncingStatus = routes.node.SyncingStatus;