@lodestar/beacon-node 1.51.0-dev.c6e566f915 → 1.51.0-dev.d2b5232209

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 (150) 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 +12 -7
  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 +11 -6
  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/utils/archiveBlocks.d.ts +4 -0
  23. package/lib/chain/archiveStore/utils/archiveBlocks.d.ts.map +1 -1
  24. package/lib/chain/archiveStore/utils/archiveBlocks.js +61 -97
  25. package/lib/chain/archiveStore/utils/archiveBlocks.js.map +1 -1
  26. package/lib/chain/blocks/importBlock.d.ts.map +1 -1
  27. package/lib/chain/blocks/importBlock.js +6 -5
  28. package/lib/chain/blocks/importBlock.js.map +1 -1
  29. package/lib/chain/blocks/importExecutionPayload.d.ts.map +1 -1
  30. package/lib/chain/blocks/importExecutionPayload.js +3 -2
  31. package/lib/chain/blocks/importExecutionPayload.js.map +1 -1
  32. package/lib/chain/blocks/index.js +2 -2
  33. package/lib/chain/blocks/index.js.map +1 -1
  34. package/lib/chain/blocks/payloadEnvelopeProcessor.d.ts +5 -5
  35. package/lib/chain/blocks/payloadEnvelopeProcessor.js +5 -5
  36. package/lib/chain/blocks/verifyBlock.d.ts.map +1 -1
  37. package/lib/chain/blocks/verifyBlock.js +1 -1
  38. package/lib/chain/blocks/verifyBlock.js.map +1 -1
  39. package/lib/chain/blocks/verifyPayloadsDataAvailability.d.ts +3 -3
  40. package/lib/chain/blocks/verifyPayloadsDataAvailability.d.ts.map +1 -1
  41. package/lib/chain/blocks/verifyPayloadsDataAvailability.js +6 -6
  42. package/lib/chain/blocks/verifyPayloadsDataAvailability.js.map +1 -1
  43. package/lib/chain/chain.js +4 -4
  44. package/lib/chain/chain.js.map +1 -1
  45. package/lib/chain/opPools/inclusionListStore.d.ts.map +1 -1
  46. package/lib/chain/opPools/inclusionListStore.js +2 -2
  47. package/lib/chain/opPools/inclusionListStore.js.map +1 -1
  48. package/lib/chain/produceBlock/produceBlockBody.d.ts.map +1 -1
  49. package/lib/chain/produceBlock/produceBlockBody.js +0 -1
  50. package/lib/chain/produceBlock/produceBlockBody.js.map +1 -1
  51. package/lib/chain/regen/interface.d.ts +0 -1
  52. package/lib/chain/regen/interface.d.ts.map +1 -1
  53. package/lib/chain/regen/interface.js +0 -1
  54. package/lib/chain/regen/interface.js.map +1 -1
  55. package/lib/chain/validation/executionPayloadBid.d.ts +0 -15
  56. package/lib/chain/validation/executionPayloadBid.d.ts.map +1 -1
  57. package/lib/chain/validation/executionPayloadBid.js +0 -153
  58. package/lib/chain/validation/executionPayloadBid.js.map +1 -1
  59. package/lib/chain/validation/inclusionList.d.ts.map +1 -1
  60. package/lib/chain/validation/inclusionList.js +11 -2
  61. package/lib/chain/validation/inclusionList.js.map +1 -1
  62. package/lib/db/beacon.d.ts +7 -0
  63. package/lib/db/beacon.d.ts.map +1 -1
  64. package/lib/db/beacon.js +34 -0
  65. package/lib/db/beacon.js.map +1 -1
  66. package/lib/db/dataColumnStore.d.ts +1 -1
  67. package/lib/db/dataColumnStore.d.ts.map +1 -1
  68. package/lib/db/dataColumnStore.js +1 -4
  69. package/lib/db/dataColumnStore.js.map +1 -1
  70. package/lib/db/interface.d.ts +1 -0
  71. package/lib/db/interface.d.ts.map +1 -1
  72. package/lib/db/repositories/dataColumnSidecarArchive.d.ts +6 -0
  73. package/lib/db/repositories/dataColumnSidecarArchive.d.ts.map +1 -1
  74. package/lib/db/repositories/dataColumnSidecarArchive.js +19 -0
  75. package/lib/db/repositories/dataColumnSidecarArchive.js.map +1 -1
  76. package/lib/execution/engine/blobVersionedHashes.d.ts +1 -1
  77. package/lib/execution/engine/blobVersionedHashes.d.ts.map +1 -1
  78. package/lib/execution/engine/blobVersionedHashes.js.map +1 -1
  79. package/lib/execution/engine/http.d.ts.map +1 -1
  80. package/lib/execution/engine/http.js +0 -1
  81. package/lib/execution/engine/http.js.map +1 -1
  82. package/lib/execution/engine/mock.d.ts.map +1 -1
  83. package/lib/execution/engine/mock.js +6 -4
  84. package/lib/execution/engine/mock.js.map +1 -1
  85. package/lib/execution/engine/payloadIdCache.d.ts +1 -2
  86. package/lib/execution/engine/payloadIdCache.d.ts.map +1 -1
  87. package/lib/execution/engine/payloadIdCache.js +3 -3
  88. package/lib/execution/engine/payloadIdCache.js.map +1 -1
  89. package/lib/execution/engine/sszTypes.d.ts +38 -38
  90. package/lib/execution/engine/types.d.ts +1 -1
  91. package/lib/execution/engine/types.d.ts.map +1 -1
  92. package/lib/execution/engine/types.js +7 -6
  93. package/lib/execution/engine/types.js.map +1 -1
  94. package/lib/index.d.ts +1 -0
  95. package/lib/index.d.ts.map +1 -1
  96. package/lib/index.js +2 -0
  97. package/lib/index.js.map +1 -1
  98. package/lib/metrics/metrics/lodestar.d.ts +3 -0
  99. package/lib/metrics/metrics/lodestar.d.ts.map +1 -1
  100. package/lib/metrics/metrics/lodestar.js +5 -0
  101. package/lib/metrics/metrics/lodestar.js.map +1 -1
  102. package/lib/network/gossip/topic.d.ts +6 -6
  103. package/lib/network/processor/gossipHandlers.d.ts.map +1 -1
  104. package/lib/network/processor/gossipHandlers.js +27 -18
  105. package/lib/network/processor/gossipHandlers.js.map +1 -1
  106. package/lib/network/processor/index.d.ts.map +1 -1
  107. package/lib/network/processor/index.js +26 -25
  108. package/lib/network/processor/index.js.map +1 -1
  109. package/lib/node/nodejs.d.ts.map +1 -1
  110. package/lib/node/nodejs.js +9 -1
  111. package/lib/node/nodejs.js.map +1 -1
  112. package/lib/sync/unknownBlock.d.ts.map +1 -1
  113. package/lib/sync/unknownBlock.js +42 -18
  114. package/lib/sync/unknownBlock.js.map +1 -1
  115. package/package.json +30 -30
  116. package/src/api/impl/api.ts +1 -1
  117. package/src/api/impl/beacon/blocks/index.ts +22 -17
  118. package/src/api/impl/beacon/index.ts +3 -1
  119. package/src/api/impl/validator/index.ts +11 -8
  120. package/src/api/options.ts +3 -0
  121. package/src/chain/GetBlobsTracker.ts +95 -38
  122. package/src/chain/archiveStore/utils/archiveBlocks.ts +76 -130
  123. package/src/chain/blocks/importBlock.ts +8 -7
  124. package/src/chain/blocks/importExecutionPayload.ts +3 -2
  125. package/src/chain/blocks/index.ts +6 -2
  126. package/src/chain/blocks/payloadEnvelopeProcessor.ts +5 -5
  127. package/src/chain/blocks/verifyBlock.ts +1 -0
  128. package/src/chain/blocks/verifyPayloadsDataAvailability.ts +7 -6
  129. package/src/chain/chain.ts +4 -4
  130. package/src/chain/opPools/inclusionListStore.ts +3 -3
  131. package/src/chain/produceBlock/produceBlockBody.ts +0 -1
  132. package/src/chain/regen/interface.ts +0 -1
  133. package/src/chain/validation/executionPayloadBid.ts +0 -180
  134. package/src/chain/validation/inclusionList.ts +11 -2
  135. package/src/db/beacon.ts +44 -0
  136. package/src/db/dataColumnStore.ts +2 -4
  137. package/src/db/interface.ts +2 -0
  138. package/src/db/repositories/dataColumnSidecarArchive.ts +20 -0
  139. package/src/execution/engine/blobVersionedHashes.ts +1 -1
  140. package/src/execution/engine/http.ts +0 -1
  141. package/src/execution/engine/mock.ts +6 -4
  142. package/src/execution/engine/payloadIdCache.ts +6 -7
  143. package/src/execution/engine/types.ts +8 -8
  144. package/src/index.ts +2 -0
  145. package/src/metrics/metrics/lodestar.ts +5 -0
  146. package/src/network/processor/gossipHandlers.ts +35 -20
  147. package/src/network/processor/index.ts +22 -23
  148. package/src/network/processor/types.ts +1 -1
  149. package/src/node/nodejs.ts +18 -1
  150. package/src/sync/unknownBlock.ts +47 -28
@@ -62,7 +62,7 @@ import {
62
62
  } from "../../../../chain/produceBlock/index.js";
63
63
  import {RegenCaller} from "../../../../chain/regen/index.js";
64
64
  import {validateGossipBlock, verifyBlockProposerSignature} from "../../../../chain/validation/block.js";
65
- import {validateApiExecutionPayloadBid} from "../../../../chain/validation/executionPayloadBid.js";
65
+ import {validateGossipExecutionPayloadBid} from "../../../../chain/validation/executionPayloadBid.js";
66
66
  import {validateApiExecutionPayloadEnvelope} from "../../../../chain/validation/executionPayloadEnvelope.js";
67
67
  import {OpSource} from "../../../../chain/validatorMonitor.js";
68
68
  import {
@@ -79,6 +79,7 @@ import {
79
79
  import {isOptimisticBlock} from "../../../../util/forkChoice.js";
80
80
  import {kzg} from "../../../../util/kzg.js";
81
81
  import {promiseAllMaybeAsync} from "../../../../util/promises.js";
82
+ import {ApiOptions} from "../../../options.js";
82
83
  import {ApiModules} from "../../types.js";
83
84
  import {assertUniqueItems} from "../../utils.js";
84
85
  import {getBlockResponse, toBeaconHeaderResponse} from "./utils.js";
@@ -96,16 +97,10 @@ const MAX_API_CLOCK_DISPARITY_MS = 1000;
96
97
  */
97
98
  const IDENTITY_PEER_ID = ""; // TODO: Compute identity keypair
98
99
 
99
- export function getBeaconBlockApi({
100
- chain,
101
- config,
102
- metrics,
103
- network,
104
- db,
105
- }: Pick<
106
- ApiModules,
107
- "chain" | "config" | "metrics" | "network" | "db"
108
- >): ApplicationMethods<routes.beacon.block.Endpoints> {
100
+ export function getBeaconBlockApi(
101
+ opts: ApiOptions,
102
+ {chain, config, metrics, network, db}: Pick<ApiModules, "chain" | "config" | "metrics" | "network" | "db">
103
+ ): ApplicationMethods<routes.beacon.block.Endpoints> {
109
104
  const publishBlockV2: ApplicationMethods<routes.beacon.block.Endpoints>["publishBlockV2"] = async (
110
105
  {signedBlockContents, broadcastValidation, builderUrl},
111
106
  context,
@@ -1077,15 +1072,25 @@ export function getBeaconBlockApi({
1077
1072
  throw new ApiError(400, `publishExecutionPayloadBid not supported for pre-gloas fork=${fork}`);
1078
1073
  }
1079
1074
 
1080
- const validationTimer = metrics?.opPool.executionPayloadBidPool.apiValidationTime.startTimer();
1081
- // TODO: once the builder is tested and can be trusted, skip this local validation
1082
- // to publish faster, accepting peer-score risk if it ever emits an invalid bid.
1083
- await validateApiExecutionPayloadBid(chain, signedExecutionPayloadBid);
1084
- validationTimer?.();
1085
-
1086
1075
  const elapsedSec = chain.clock.secFromSlot(slot, seenTimestampSec);
1087
1076
  metrics?.gossipExecutionPayloadBid.elapsedTimeTillReceived.observe({source: OpSource.api}, elapsedSec);
1088
1077
 
1078
+ if (!opts.disableBidValidation) {
1079
+ const validationTimer = metrics?.opPool.executionPayloadBidPool.apiValidationTime.startTimer();
1080
+ const {proposerIndex} = await validateGossipExecutionPayloadBid(chain, signedExecutionPayloadBid);
1081
+ validationTimer?.();
1082
+
1083
+ // Gossip does not deliver our own messages back to us, so a validated bid is added to the
1084
+ // pool here to allow a proposer on this node to select it
1085
+ const insertOutcome = chain.executionPayloadBidPool.add(
1086
+ signedExecutionPayloadBid,
1087
+ Math.floor(elapsedSec * 1000)
1088
+ );
1089
+ metrics?.opPool.executionPayloadBidPool.apiInsertOutcome.inc({insertOutcome});
1090
+
1091
+ chain.validatorMonitor?.registerExecutionPayloadBid(OpSource.api, proposerIndex, bid);
1092
+ }
1093
+
1089
1094
  const sentPeers = await network.publishSignedExecutionPayloadBid(signedExecutionPayloadBid);
1090
1095
 
1091
1096
  chain.emitter.emit(routes.events.EventType.executionPayloadBid, {
@@ -3,6 +3,7 @@ import {ApplicationMethods} from "@lodestar/api/server";
3
3
  import {isForkPostGloas} from "@lodestar/params";
4
4
  import {computeStartSlotAtEpoch} from "@lodestar/state-transition";
5
5
  import {toRootHex} from "@lodestar/utils";
6
+ import {ApiOptions} from "../../options.js";
6
7
  import {ApiError} from "../errors.js";
7
8
  import {ApiModules} from "../types.js";
8
9
  import {getBeaconBlockApi} from "./blocks/index.js";
@@ -11,9 +12,10 @@ import {getBeaconRewardsApi} from "./rewards/index.js";
11
12
  import {getBeaconStateApi} from "./state/index.js";
12
13
 
13
14
  export function getBeaconApi(
15
+ opts: ApiOptions,
14
16
  modules: Pick<ApiModules, "chain" | "config" | "logger" | "metrics" | "network" | "db" | "sync">
15
17
  ): ApplicationMethods<routes.beacon.Endpoints> {
16
- const block = getBeaconBlockApi(modules);
18
+ const block = getBeaconBlockApi(opts, modules);
17
19
  const pool = getBeaconPoolApi(modules);
18
20
  const state = getBeaconStateApi(modules);
19
21
  const rewards = getBeaconRewardsApi(modules);
@@ -254,13 +254,13 @@ export function getValidatorApi(
254
254
  genesisBlockRoot = state.computeAnchorCheckpoint().checkpoint.root;
255
255
  } else if (state.slot < SLOTS_PER_HISTORICAL_ROOT) {
256
256
  genesisBlockRoot = state.getBlockRootAtSlot(GENESIS_SLOT);
257
- }
258
-
259
- const blockRes = await chain.getCanonicalBlockAtSlot(GENESIS_SLOT);
260
- if (blockRes) {
261
- genesisBlockRoot = config
262
- .getForkTypes(blockRes.block.message.slot)
263
- .SignedBeaconBlock.hashTreeRoot(blockRes.block);
257
+ } else {
258
+ const blockRes = await chain.getCanonicalBlockAtSlot(GENESIS_SLOT);
259
+ if (blockRes) {
260
+ genesisBlockRoot = config
261
+ .getForkTypes(blockRes.block.message.slot)
262
+ .BeaconBlock.hashTreeRoot(blockRes.block.message);
263
+ }
264
264
  }
265
265
  }
266
266
 
@@ -1756,7 +1756,10 @@ export function getValidatorApi(
1756
1756
  }
1757
1757
  }
1758
1758
 
1759
- const dependentRoot = fromHex(state.getShufflingDecisionRoot(epoch));
1759
+ // The fork epoch PTC is computed at the fork from effective balances updated at the end of the
1760
+ // last pre-fork epoch, so its dependent root is one epoch later than for other epochs
1761
+ const dependentRootEpoch = epoch === config.GLOAS_FORK_EPOCH ? epoch + 1 : epoch;
1762
+ const dependentRoot = fromHex(state.getShufflingDecisionRoot(dependentRootEpoch));
1760
1763
 
1761
1764
  return {
1762
1765
  data: duties,
@@ -2,6 +2,8 @@ import {BeaconRestApiServerOpts, beaconRestApiServerOpts} from "./rest/index.js"
2
2
 
3
3
  export type ApiOptions = {
4
4
  maxGindicesInProof?: number;
5
+ /** Broadcast execution payload bids submitted via the API without running gossip validation */
6
+ disableBidValidation?: boolean;
5
7
  rest: BeaconRestApiServerOpts;
6
8
  commit?: string;
7
9
  version?: string;
@@ -10,6 +12,7 @@ export type ApiOptions = {
10
12
 
11
13
  export const defaultApiOptions: ApiOptions = {
12
14
  maxGindicesInProof: 512,
15
+ disableBidValidation: false,
13
16
  rest: beaconRestApiServerOpts,
14
17
  version: "dev",
15
18
  private: false,
@@ -1,10 +1,9 @@
1
1
  import {ChainForkConfig} from "@lodestar/config";
2
2
  import {computeEpochAtSlot} from "@lodestar/state-transition";
3
- import {Logger} from "@lodestar/utils";
3
+ import {Logger, pruneSetToMax} from "@lodestar/utils";
4
4
  import {BLOB_AND_PROOF_V2_RPC_BYTES} from "../execution/engine/types.js";
5
5
  import {IExecutionEngine} from "../execution/index.js";
6
6
  import {Metrics} from "../metrics/metrics.js";
7
- import {callInNextEventLoop} from "../util/eventLoop.js";
8
7
  import {
9
8
  DataColumnEngineResult,
10
9
  getBlobSidecarsFromExecution,
@@ -14,6 +13,11 @@ import {IBlockInput, isBlockInputBlobs} from "./blocks/blockInput/index.js";
14
13
  import {PayloadEnvelopeInput} from "./blocks/payloadEnvelopeInput/index.js";
15
14
  import {ChainEventEmitter} from "./emitter.js";
16
15
 
16
+ /** A `null` answer only changes if the EL receives the transactions later, so retries are few and spaced out */
17
+ export const MAX_GET_BLOBS_ATTEMPTS = 3;
18
+ export const GET_BLOBS_RETRY_INTERVAL_MS = 1000;
19
+ const MAX_TRACKED_BLOCK_ROOTS = 64;
20
+
17
21
  export type GetBlobsTrackerInit = {
18
22
  logger: Logger;
19
23
  executionEngine: IExecutionEngine;
@@ -32,6 +36,8 @@ export class GetBlobsTracker {
32
36
  metrics: Metrics | null;
33
37
  config: ChainForkConfig;
34
38
  activeReconstructions = new Set<string>();
39
+ failedAttempts = new Map<string, {count: number; lastAttemptMs: number; retryTimer?: NodeJS.Timeout}>();
40
+ pendingTriggers = new Set<string>();
35
41
  // Preallocate buffers for getBlobsV2 RPC calls
36
42
  // See https://github.com/ChainSafe/lodestar/pull/8282 for context
37
43
  blobsAndProofsBuffers: {buffers: Uint8Array[]; inUse: boolean}[] = [];
@@ -46,23 +52,55 @@ export class GetBlobsTracker {
46
52
 
47
53
  triggerGetBlobs(input: IBlockInput | PayloadEnvelopeInput): void {
48
54
  if (this.activeReconstructions.has(input.blockRootHex)) {
55
+ this.pendingTriggers.add(input.blockRootHex);
49
56
  return;
50
57
  }
51
58
 
59
+ const failed = this.failedAttempts.get(input.blockRootHex);
60
+ if (failed) {
61
+ if (failed.count >= MAX_GET_BLOBS_ATTEMPTS) {
62
+ return;
63
+ }
64
+ const waitMs = GET_BLOBS_RETRY_INTERVAL_MS - (Date.now() - failed.lastAttemptMs);
65
+ if (waitMs > 0) {
66
+ // Columns tend to arrive in one burst, so keep a single trailing retry instead of relying on a later trigger
67
+ failed.retryTimer ??= setTimeout(() => {
68
+ failed.retryTimer = undefined;
69
+ if (this.failedAttempts.get(input.blockRootHex) === failed && !input.hasAllData()) {
70
+ this.triggerGetBlobs(input);
71
+ }
72
+ }, waitMs).unref();
73
+ return;
74
+ }
75
+ }
76
+
77
+ // The request is sent right away, before block processing issues newPayload: ELs that drop a
78
+ // transaction's blobs once the payload is validated can only answer a request that gets there first
52
79
  if (!(input instanceof PayloadEnvelopeInput) && isBlockInputBlobs(input)) {
53
80
  // there is not preallocation for blob sidecars like there is for columns sidecars so no need to
54
81
  // store the index for the preallocated buffers
55
82
  this.activeReconstructions.add(input.blockRootHex);
56
- callInNextEventLoop(() => {
57
- const logCtx = {slot: input.slot, root: input.blockRootHex};
58
- this.logger.verbose("Trigger getBlobsV1 for block", logCtx);
59
- getBlobSidecarsFromExecution(this.config, this.executionEngine, this.metrics, this.emitter, input).finally(
60
- () => {
61
- this.logger.verbose("Completed getBlobsV1 for block", logCtx);
62
- this.activeReconstructions.delete(input.blockRootHex);
83
+ const logCtx = {slot: input.slot, root: input.blockRootHex};
84
+ this.logger.verbose("Trigger getBlobsV1 for block", logCtx);
85
+ let requestFailed = false;
86
+ getBlobSidecarsFromExecution(this.config, this.executionEngine, this.metrics, this.emitter, input)
87
+ .then(() => {
88
+ // EL errors and misses are handled inside the helper, blobs still missing means the attempt failed
89
+ if (!input.hasAllData()) {
90
+ requestFailed = true;
91
+ this.recordFailedAttempt(input.blockRootHex);
63
92
  }
64
- );
65
- });
93
+ })
94
+ .catch((error) => {
95
+ this.logger.debug("Error during getBlobsV1 for block", logCtx, error as Error);
96
+ requestFailed = true;
97
+ this.recordFailedAttempt(input.blockRootHex);
98
+ })
99
+ .finally(() => {
100
+ this.logger.verbose("Completed getBlobsV1 for block", logCtx);
101
+ this.activeReconstructions.delete(input.blockRootHex);
102
+ this.retryPendingTrigger(input, requestFailed);
103
+ });
66
104
 
67
105
  return;
68
106
  }
@@ -83,34 +121,53 @@ export class GetBlobsTracker {
83
121
  }
84
122
  timer?.();
85
123
 
86
- // We don't care about the outcome of this call,
87
- // just that it has been triggered for this block root.
88
124
  this.activeReconstructions.add(input.blockRootHex);
89
125
  this.blobsAndProofsBuffers[freeIndex].inUse = true;
90
- callInNextEventLoop(() => {
91
- const logCtx = {slot: input.slot, root: input.blockRootHex};
92
- this.logger.verbose("Trigger getBlobsV2 for block", logCtx);
93
- getDataColumnSidecarsFromExecution(
94
- this.config,
95
- this.executionEngine,
96
- this.emitter,
97
- input,
98
- this.metrics,
99
- this.blobsAndProofsBuffers[freeIndex].buffers
100
- )
101
- .then((result) => {
102
- this.logger.debug("getBlobsV2 result for block", {...logCtx, result});
103
- this.metrics?.dataColumns.dataColumnEngineResult.inc({result});
104
- })
105
- .catch((error) => {
106
- this.logger.debug("Error during getBlobsV2 for block", logCtx, error as Error);
107
- this.metrics?.dataColumns.dataColumnEngineResult.inc({result: DataColumnEngineResult.Failed});
108
- })
109
- .finally(() => {
110
- this.logger.verbose("Completed getBlobsV2 for block", logCtx);
111
- this.activeReconstructions.delete(input.blockRootHex);
112
- this.blobsAndProofsBuffers[freeIndex].inUse = false;
113
- });
114
- });
126
+ const logCtx = {slot: input.slot, root: input.blockRootHex};
127
+ this.logger.verbose("Trigger getBlobsV2 for block", logCtx);
128
+ let requestFailed = false;
129
+ getDataColumnSidecarsFromExecution(
130
+ this.config,
131
+ this.executionEngine,
132
+ this.emitter,
133
+ input,
134
+ this.metrics,
135
+ this.blobsAndProofsBuffers[freeIndex].buffers
136
+ )
137
+ .then((result) => {
138
+ this.logger.debug("getBlobsV2 result for block", {...logCtx, result});
139
+ this.metrics?.dataColumns.dataColumnEngineResult.inc({result});
140
+ if (result === DataColumnEngineResult.NullResponse) {
141
+ requestFailed = true;
142
+ this.recordFailedAttempt(input.blockRootHex);
143
+ }
144
+ })
145
+ .catch((error) => {
146
+ this.logger.debug("Error during getBlobsV2 for block", logCtx, error as Error);
147
+ this.metrics?.dataColumns.dataColumnEngineResult.inc({result: DataColumnEngineResult.Failed});
148
+ requestFailed = true;
149
+ this.recordFailedAttempt(input.blockRootHex);
150
+ })
151
+ .finally(() => {
152
+ this.logger.verbose("Completed getBlobsV2 for block", logCtx);
153
+ this.activeReconstructions.delete(input.blockRootHex);
154
+ this.blobsAndProofsBuffers[freeIndex].inUse = false;
155
+ this.retryPendingTrigger(input, requestFailed);
156
+ });
157
+ }
158
+
159
+ private retryPendingTrigger(input: IBlockInput | PayloadEnvelopeInput, requestFailed: boolean): void {
160
+ // Triggers dropped while the request was in flight re-enter once it failed, the attempt that was just
161
+ // recorded makes this arm the trailing retry instead of sending another request right away
162
+ if (this.pendingTriggers.delete(input.blockRootHex) && requestFailed) {
163
+ this.triggerGetBlobs(input);
164
+ }
165
+ }
166
+
167
+ private recordFailedAttempt(blockRootHex: string): void {
168
+ const failed = this.failedAttempts.get(blockRootHex);
169
+ clearTimeout(failed?.retryTimer);
170
+ this.failedAttempts.set(blockRootHex, {count: (failed?.count ?? 0) + 1, lastAttemptMs: Date.now()});
171
+ pruneSetToMax(this.failedAttempts, MAX_TRACKED_BLOCK_ROOTS);
115
172
  }
116
173
  }
@@ -1,11 +1,18 @@
1
1
  import path from "node:path";
2
2
  import {ChainForkConfig} from "@lodestar/config";
3
3
  import {KeyValue} from "@lodestar/db";
4
- import {CheckpointWithHex, ExecutionStatus, IForkChoice, PayloadStatus, ProtoBlock} from "@lodestar/fork-choice";
4
+ import {
5
+ CheckpointWithHex,
6
+ ExecutionStatus,
7
+ IForkChoice,
8
+ PayloadStatus,
9
+ ProtoBlock,
10
+ isGloasBlock,
11
+ } from "@lodestar/fork-choice";
5
12
  import {ForkSeq, SLOTS_PER_EPOCH} from "@lodestar/params";
6
13
  import {computeEpochAtSlot, computeStartSlotAtEpoch, getBlobDataRetentionStartEpoch} from "@lodestar/state-transition";
7
14
  import {Epoch, Slot} from "@lodestar/types";
8
- import {Logger, fromAsync, fromHex, prettyPrintIndices, toRootHex} from "@lodestar/utils";
15
+ import {Logger, fromHex, prettyPrintIndices, toRootHex} from "@lodestar/utils";
9
16
  import {IBeaconDb} from "../../../db/index.js";
10
17
  import {BlockArchiveBatchPutBinaryItem, encodeArchivedHeaderEnvelope} from "../../../db/repositories/index.js";
11
18
  import {Metrics} from "../../../metrics/metrics.js";
@@ -49,6 +56,17 @@ async function persistOrphanedBlock(
49
56
  await writeIfNotExist(filepath, bytes);
50
57
  }
51
58
 
59
+ /**
60
+ * Oldest epoch for which data column sidecars are kept
61
+ */
62
+ export function getDataColumnSidecarsMinEpoch(
63
+ config: ChainForkConfig,
64
+ currentEpoch: Epoch,
65
+ archiveDataEpochs?: number
66
+ ): Epoch {
67
+ return Math.min(getBlobDataRetentionStartEpoch(config, currentEpoch), currentEpoch - (archiveDataEpochs ?? 0));
68
+ }
69
+
52
70
  /**
53
71
  * Archives finalized blocks from active bucket to archive bucket.
54
72
  *
@@ -136,23 +154,6 @@ export async function archiveBlocks(
136
154
  logger.verbose("Migrated blobSidecars from hot DB to cold DB", {...logCtx, migratedEntries});
137
155
  }
138
156
 
139
- // Keep the normal LevelDB hot-to-cold flow for legacy columns. New columns are written
140
- // directly to flat files, so this only moves fallback data left by older versions.
141
- if (finalizedPostFulu) {
142
- const migratedSlots = await migrateDataColumnSidecarsFromHotToColdDb(
143
- config,
144
- db,
145
- logger,
146
- finalizedCanonicalBlocks,
147
- currentEpoch
148
- );
149
- logger.verbose("Migrated legacy dataColumnSidecars from hot DB to cold DB", {
150
- ...logCtx,
151
- migratedEntries: migratedSlots.length,
152
- slotRange: prettyPrintIndices(migratedSlots),
153
- });
154
- }
155
-
156
157
  if (finalizedPostGloas) {
157
158
  const migratedSlots = await migrateExecutionPayloadEnvelopesFromHotToColdDb(
158
159
  config,
@@ -169,44 +170,34 @@ export async function archiveBlocks(
169
170
  }
170
171
  }
171
172
 
172
- // deleteNonCanonicalBlocks
173
- // loop through forkchoice single time
173
+ const canonicalRoots = new Set(finalizedCanonicalBlocks.map((block) => block.blockRoot));
174
+ const orphanedBlocks: ProtoBlock[] = [];
175
+ const orphanedPayloads: ProtoBlock[] = [];
174
176
 
175
- const nonCanonicalBlockRoots = finalizedNonCanonicalBlocks.map((summary) => fromHex(summary.blockRoot));
176
- if (nonCanonicalBlockRoots.length > 0) {
177
- if (persistOrphanedBlocks) {
178
- // Persist orphaned blocks to disk before deleting them from hot db
179
- await Promise.all(
180
- nonCanonicalBlockRoots.map(async (root, index) => {
181
- const block = finalizedNonCanonicalBlocks[index];
182
- const blockBytes = await db.block.getBinary(root);
183
- const blockLogCtx = {slot: block.slot, root: block.blockRoot};
184
- if (blockBytes) {
185
- await persistOrphanedBlock(block.slot, block.blockRoot, blockBytes, {
186
- persistOrphanedBlocksDir: persistOrphanedBlocksDir ?? "orphaned_blocks",
187
- });
188
- logger.verbose("Persisted orphaned block", {...logCtx, ...blockLogCtx});
189
- } else {
190
- logger.warn("Tried to persist orphaned block but no block found", {...logCtx, ...blockLogCtx});
191
- }
192
- })
193
- );
177
+ for (const block of finalizedNonCanonicalBlocks) {
178
+ if (block.payloadStatus === PayloadStatus.FULL) {
179
+ orphanedPayloads.push(block);
194
180
  }
181
+ // Every Gloas block gets EMPTY before FULL. If only FULL survives pruning, an earlier archive run
182
+ // already handled the root's block-level data.
183
+ const isBlockNode = !isGloasBlock(block) || block.payloadStatus === PayloadStatus.EMPTY;
184
+ if (isBlockNode && !canonicalRoots.has(block.blockRoot)) {
185
+ orphanedBlocks.push(block);
186
+ }
187
+ }
188
+ const orphanedBlockRoots = orphanedBlocks.map((block) => fromHex(block.blockRoot));
195
189
 
196
- const nonCanonicalSlots = finalizedNonCanonicalBlocks.map((summary) => summary.slot).sort((a, b) => a - b);
197
- const nonCanonicalLogCtx = {
190
+ if (orphanedPayloads.length > 0) {
191
+ const orphanedPayloadRoots = orphanedPayloads.map((block) => fromHex(block.blockRoot));
192
+ const orphanedPayloadLogCtx = {
198
193
  ...logCtx,
199
- count: nonCanonicalBlockRoots.length,
200
- slotRange: prettyPrintIndices(nonCanonicalSlots),
194
+ count: orphanedPayloads.length,
195
+ slotRange: prettyPrintIndices(orphanedPayloads.map((block) => block.slot).sort((a, b) => a - b)),
201
196
  };
202
197
 
203
- const columnItems = finalizedNonCanonicalBlocks
204
- // Gloas EMPTY and FULL variants share a block root. EMPTY has no sidecars, so deleting by its root could
205
- // remove the canonical FULL variant's columns. Pre-Gloas blocks are always FULL.
206
- .filter(
207
- (summary) => config.getForkSeq(summary.slot) >= ForkSeq.fulu && summary.payloadStatus === PayloadStatus.FULL
208
- )
209
- .map((summary) => ({slot: summary.slot, blockRoot: summary.blockRoot}));
198
+ const columnItems = orphanedPayloads
199
+ .filter((block) => config.getForkSeq(block.slot) >= ForkSeq.fulu)
200
+ .map((block) => ({slot: block.slot, blockRoot: block.blockRoot}));
210
201
  if (columnItems.length > 0) {
211
202
  // Delete sidecars first so their block roots remain available to retry cleanup after a failure or crash.
212
203
  await db.dataColumns.deleteMany(columnItems);
@@ -217,20 +208,44 @@ export async function archiveBlocks(
217
208
  });
218
209
  }
219
210
 
220
- await db.block.batchDelete(nonCanonicalBlockRoots);
221
- logger.verbose("Deleted non canonical blocks from hot DB", nonCanonicalLogCtx);
222
-
223
211
  if (finalizedPostDeneb) {
224
- await db.blobSidecars.batchDelete(nonCanonicalBlockRoots);
225
- logger.verbose("Deleted non canonical blobSidecars from hot DB", nonCanonicalLogCtx);
212
+ await db.blobSidecars.batchDelete(orphanedPayloadRoots);
213
+ logger.verbose("Deleted non canonical blobSidecars from hot DB", orphanedPayloadLogCtx);
226
214
  }
227
215
 
228
216
  if (finalizedPostGloas) {
229
- await db.executionPayloadEnvelope.batchDelete(nonCanonicalBlockRoots);
230
- logger.verbose("Deleted non canonical executionPayloadEnvelopes from hot DB", nonCanonicalLogCtx);
217
+ await db.executionPayloadEnvelope.batchDelete(orphanedPayloadRoots);
218
+ logger.verbose("Deleted non canonical executionPayloadEnvelopes from hot DB", orphanedPayloadLogCtx);
231
219
  }
232
220
  }
233
221
 
222
+ if (orphanedBlocks.length > 0) {
223
+ if (persistOrphanedBlocks) {
224
+ // Persist orphaned blocks to disk before deleting them from hot db
225
+ await Promise.all(
226
+ orphanedBlocks.map(async (block) => {
227
+ const blockBytes = await db.block.getBinary(fromHex(block.blockRoot));
228
+ const blockLogCtx = {slot: block.slot, root: block.blockRoot};
229
+ if (blockBytes) {
230
+ await persistOrphanedBlock(block.slot, block.blockRoot, blockBytes, {
231
+ persistOrphanedBlocksDir: persistOrphanedBlocksDir ?? "orphaned_blocks",
232
+ });
233
+ logger.verbose("Persisted orphaned block", {...logCtx, ...blockLogCtx});
234
+ } else {
235
+ logger.debug("Tried to persist orphaned block but no block found", {...logCtx, ...blockLogCtx});
236
+ }
237
+ })
238
+ );
239
+ }
240
+
241
+ await db.block.batchDelete(orphanedBlockRoots);
242
+ logger.verbose("Deleted non canonical blocks from hot DB", {
243
+ ...logCtx,
244
+ count: orphanedBlocks.length,
245
+ slotRange: prettyPrintIndices(orphanedBlocks.map((block) => block.slot).sort((a, b) => a - b)),
246
+ });
247
+ }
248
+
234
249
  // Delete expired blobs
235
250
  // Keep only `[current_epoch - max(MIN_EPOCHS_FOR_BLOB_SIDECARS_REQUESTS, archiveDataEpochs)]`
236
251
  // if archiveDataEpochs set to Infinity do not prune`
@@ -256,10 +271,7 @@ export async function archiveBlocks(
256
271
  // Keep only `[min(compute_blob_data_retention_start_epoch(current_epoch), current_epoch - archiveDataEpochs)]`
257
272
  if (finalizedPostFulu) {
258
273
  if (archiveDataEpochs !== Infinity) {
259
- const dataColumnSidecarsMinEpoch = Math.min(
260
- getBlobDataRetentionStartEpoch(config, currentEpoch),
261
- currentEpoch - (archiveDataEpochs ?? 0)
262
- );
274
+ const dataColumnSidecarsMinEpoch = getDataColumnSidecarsMinEpoch(config, currentEpoch, archiveDataEpochs);
263
275
  if (dataColumnSidecarsMinEpoch >= config.FULU_FORK_EPOCH) {
264
276
  const columnsPruneSlot = computeStartSlotAtEpoch(dataColumnSidecarsMinEpoch);
265
277
  const prunedColumnSlots = await db.dataColumns.pruneBefore(columnsPruneSlot);
@@ -283,9 +295,9 @@ export async function archiveBlocks(
283
295
  }
284
296
  }
285
297
 
286
- // Prunning potential checkpoint data
298
+ // Pruning potential checkpoint data
287
299
  const finalizedCanonicalNonCheckpointBlocks = getNonCheckpointBlocks(finalizedCanonicalBlockRoots);
288
- const nonCheckpointBlockRoots: Uint8Array[] = [...nonCanonicalBlockRoots];
300
+ const nonCheckpointBlockRoots: Uint8Array[] = [...orphanedBlockRoots];
289
301
  for (const block of finalizedCanonicalNonCheckpointBlocks) {
290
302
  nonCheckpointBlockRoots.push(block.root);
291
303
  }
@@ -408,72 +420,6 @@ async function migrateBlobSidecarsFromHotToColdDb(
408
420
  return migratedWrappedBlobSidecars;
409
421
  }
410
422
 
411
- // TODO: This function can be simplified further by reducing layers of promises in a loop
412
- /**
413
- * Post-gloas the data columns of a Gloas block are tied to its execution payload envelope.
414
- * Columns only exist once the FULL variant of the block is in the proto-array. Pre-Gloas
415
- * blocks only have a FULL variant, so the payload-status filter passes them all.
416
- */
417
- async function migrateDataColumnSidecarsFromHotToColdDb(
418
- config: ChainForkConfig,
419
- db: IBeaconDb,
420
- logger: Logger,
421
- canonicalBlocks: ProtoBlock[],
422
- currentEpoch: Epoch
423
- ): Promise<Slot[]> {
424
- const columnBlocks = canonicalBlocks.filter(
425
- (block) => config.getForkSeq(block.slot) < ForkSeq.gloas || block.payloadStatus === PayloadStatus.FULL
426
- );
427
- if (columnBlocks.length === 0) return [];
428
- const blocks: BlockRootSlot[] = columnBlocks.map((block) => ({slot: block.slot, root: fromHex(block.blockRoot)}));
429
-
430
- const migratedSlots: Slot[] = [];
431
- for (let i = 0; i < blocks.length; i += BLOB_SIDECAR_BATCH_SIZE) {
432
- const toIdx = Math.min(i + BLOB_SIDECAR_BATCH_SIZE, blocks.length);
433
- const batch = blocks.slice(i, toIdx);
434
- if (batch.length === 0) break;
435
-
436
- const promises: Promise<void>[] = [];
437
- for (const block of batch) {
438
- const blockEpoch = computeEpochAtSlot(block.slot);
439
- if (
440
- config.getForkSeq(block.slot) < ForkSeq.fulu ||
441
- blockEpoch < getBlobDataRetentionStartEpoch(config, currentEpoch)
442
- ) {
443
- continue;
444
- }
445
-
446
- const dataColumnSidecarBytes = await fromAsync(db.dataColumnSidecar.valuesStreamBinary(block.root));
447
- if (dataColumnSidecarBytes.length === 0) {
448
- logger.debug("DataColumnSidecars in forkchoice but missing in hot db, could be already archived", {
449
- slot: block.slot,
450
- root: toRootHex(block.root),
451
- });
452
- continue;
453
- }
454
- logger.verbose("Migrated legacy dataColumnSidecars for block", {
455
- currentEpoch,
456
- slot: block.slot,
457
- root: toRootHex(block.root),
458
- numSidecars: dataColumnSidecarBytes.length,
459
- });
460
- promises.push(
461
- db.dataColumnSidecarArchive.putManyBinary(
462
- block.slot,
463
- dataColumnSidecarBytes.map((entry) => ({key: entry.id, value: entry.value}))
464
- )
465
- );
466
- migratedSlots.push(block.slot);
467
- }
468
-
469
- await Promise.all(promises);
470
- await db.dataColumnSidecar.deleteMany(batch.map((block) => block.root));
471
- }
472
-
473
- // Ancestor walk is newest to oldest; sort ascending so `prettyPrintIndices` renders cleanly.
474
- return migratedSlots.sort((a, b) => a - b);
475
- }
476
-
477
423
  /**
478
424
  * Post-gloas given a finalized checkpoint at a block root, payload of that block root
479
425
  * is not considered finalized, hence they are archived in the next run.
@@ -21,7 +21,7 @@ import {
21
21
  IBeaconStateView,
22
22
  RootCache,
23
23
  computeEpochAtSlot,
24
- computeTimeAtSlot,
24
+ computeTimeAtSlotMs,
25
25
  getBeaconCommittees,
26
26
  isStatePostAltair,
27
27
  isStatePostBellatrix,
@@ -105,8 +105,9 @@ export async function importBlock(
105
105
  const currentEpoch = computeEpochAtSlot(currentSlot);
106
106
  const blockEpoch = computeEpochAtSlot(blockSlot);
107
107
  const prevFinalizedEpoch = this.forkChoice.getFinalizedCheckpoint().epoch;
108
- const receiveDelaySec =
109
- fullyVerifiedBlock.seenTimestampSec - computeTimeAtSlot(this.config, blockSlot, postState.genesisTime);
108
+ const receiveDelayMs =
109
+ Math.round(fullyVerifiedBlock.seenTimestampSec * 1000) -
110
+ computeTimeAtSlotMs(this.config, blockSlot, postState.genesisTime * 1000);
110
111
  const recvToValLatency = Date.now() / 1000 - (opts.seenTimestampSec ?? Date.now() / 1000);
111
112
  const fork = this.config.getForkSeq(blockSlot);
112
113
 
@@ -148,12 +149,12 @@ export async function importBlock(
148
149
  executionStatus = parentBlock.executionStatus;
149
150
  }
150
151
 
151
- const importDelaySec = this.clock.secFromSlot(blockSlot);
152
+ const importDelayMs = this.clock.msFromSlot(blockSlot);
152
153
  const blockSummary = this.forkChoice.onBlock(
153
154
  block.message,
154
155
  postState,
155
- receiveDelaySec,
156
- importDelaySec,
156
+ receiveDelayMs,
157
+ importDelayMs,
157
158
  currentSlot,
158
159
  executionStatus,
159
160
  dataAvailabilityStatus
@@ -417,7 +418,7 @@ export async function importBlock(
417
418
  // 4) Block meets the criteria of being re-orged out (this is also checked inside the function)
418
419
  const result = this.forkChoice.shouldOverrideForkChoiceUpdate(
419
420
  blockSummary,
420
- this.clock.secFromSlot(currentSlot),
421
+ this.clock.msFromSlot(currentSlot),
421
422
  currentSlot
422
423
  );
423
424
  shouldOverrideFcu = result.shouldOverrideFcu;
@@ -1,3 +1,4 @@
1
+ import {SerializedList} from "@chainsafe/ssz";
1
2
  import {routes} from "@lodestar/api";
2
3
  import {
3
4
  ExecutionStatus,
@@ -206,7 +207,7 @@ export async function importExecutionPayload(
206
207
  }
207
208
  inclusionListTransactions =
208
209
  dependentRoot === null
209
- ? []
210
+ ? SerializedList.empty()
210
211
  : this.inclusionListStore.getInclusionListTransactions(inclusionListSlot, dependentRoot, true);
211
212
  }
212
213
 
@@ -382,6 +383,6 @@ export async function processExecutionPayload(
382
383
  signal: AbortSignal,
383
384
  opts: ImportPayloadOpts = {}
384
385
  ): Promise<void> {
385
- const {dataAvailabilityStatuses} = await verifyPayloadsDataAvailability([payloadInput], signal);
386
+ const {dataAvailabilityStatuses} = await verifyPayloadsDataAvailability(this.config, [payloadInput], signal);
386
387
  await importExecutionPayload.call(this, payloadInput, dataAvailabilityStatuses[0], opts);
387
388
  }