@lodestar/beacon-node 1.51.0-dev.4157a0dec4 → 1.51.0-dev.41efb1b1d9

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 (456) 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 +29 -34
  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/beacon/pool/index.d.ts.map +1 -1
  12. package/lib/api/impl/beacon/pool/index.js +5 -2
  13. package/lib/api/impl/beacon/pool/index.js.map +1 -1
  14. package/lib/api/impl/beacon/state/index.d.ts.map +1 -1
  15. package/lib/api/impl/beacon/state/index.js +8 -2
  16. package/lib/api/impl/beacon/state/index.js.map +1 -1
  17. package/lib/api/impl/beacon/state/utils.d.ts +3 -2
  18. package/lib/api/impl/beacon/state/utils.d.ts.map +1 -1
  19. package/lib/api/impl/beacon/state/utils.js +17 -9
  20. package/lib/api/impl/beacon/state/utils.js.map +1 -1
  21. package/lib/api/impl/debug/index.d.ts.map +1 -1
  22. package/lib/api/impl/debug/index.js +3 -0
  23. package/lib/api/impl/debug/index.js.map +1 -1
  24. package/lib/api/impl/validator/index.d.ts +6 -0
  25. package/lib/api/impl/validator/index.d.ts.map +1 -1
  26. package/lib/api/impl/validator/index.js +143 -35
  27. package/lib/api/impl/validator/index.js.map +1 -1
  28. package/lib/api/options.d.ts +2 -0
  29. package/lib/api/options.d.ts.map +1 -1
  30. package/lib/api/options.js +1 -0
  31. package/lib/api/options.js.map +1 -1
  32. package/lib/chain/GetBlobsTracker.d.ts +11 -0
  33. package/lib/chain/GetBlobsTracker.d.ts.map +1 -1
  34. package/lib/chain/GetBlobsTracker.js +85 -27
  35. package/lib/chain/GetBlobsTracker.js.map +1 -1
  36. package/lib/chain/archiveStore/archiveStore.d.ts.map +1 -1
  37. package/lib/chain/archiveStore/archiveStore.js +1 -0
  38. package/lib/chain/archiveStore/archiveStore.js.map +1 -1
  39. package/lib/chain/archiveStore/utils/archiveBlocks.d.ts +4 -0
  40. package/lib/chain/archiveStore/utils/archiveBlocks.d.ts.map +1 -1
  41. package/lib/chain/archiveStore/utils/archiveBlocks.js +61 -97
  42. package/lib/chain/archiveStore/utils/archiveBlocks.js.map +1 -1
  43. package/lib/chain/blocks/importBlock.d.ts.map +1 -1
  44. package/lib/chain/blocks/importBlock.js +9 -7
  45. package/lib/chain/blocks/importBlock.js.map +1 -1
  46. package/lib/chain/blocks/importExecutionPayload.d.ts +6 -11
  47. package/lib/chain/blocks/importExecutionPayload.d.ts.map +1 -1
  48. package/lib/chain/blocks/importExecutionPayload.js +58 -17
  49. package/lib/chain/blocks/importExecutionPayload.js.map +1 -1
  50. package/lib/chain/blocks/index.js +2 -2
  51. package/lib/chain/blocks/index.js.map +1 -1
  52. package/lib/chain/blocks/payloadEnvelopeProcessor.d.ts +12 -9
  53. package/lib/chain/blocks/payloadEnvelopeProcessor.d.ts.map +1 -1
  54. package/lib/chain/blocks/payloadEnvelopeProcessor.js +24 -19
  55. package/lib/chain/blocks/payloadEnvelopeProcessor.js.map +1 -1
  56. package/lib/chain/blocks/types.d.ts +8 -1
  57. package/lib/chain/blocks/types.d.ts.map +1 -1
  58. package/lib/chain/blocks/types.js +5 -0
  59. package/lib/chain/blocks/types.js.map +1 -1
  60. package/lib/chain/blocks/verifyBlock.d.ts.map +1 -1
  61. package/lib/chain/blocks/verifyBlock.js +18 -7
  62. package/lib/chain/blocks/verifyBlock.js.map +1 -1
  63. package/lib/chain/blocks/verifyBlocksDataAvailability.d.ts.map +1 -1
  64. package/lib/chain/blocks/verifyBlocksDataAvailability.js +8 -1
  65. package/lib/chain/blocks/verifyBlocksDataAvailability.js.map +1 -1
  66. package/lib/chain/blocks/verifyBlocksSignatures.d.ts.map +1 -1
  67. package/lib/chain/blocks/verifyBlocksSignatures.js +7 -5
  68. package/lib/chain/blocks/verifyBlocksSignatures.js.map +1 -1
  69. package/lib/chain/blocks/verifyPayloadsDataAvailability.d.ts +3 -3
  70. package/lib/chain/blocks/verifyPayloadsDataAvailability.d.ts.map +1 -1
  71. package/lib/chain/blocks/verifyPayloadsDataAvailability.js +11 -6
  72. package/lib/chain/blocks/verifyPayloadsDataAvailability.js.map +1 -1
  73. package/lib/chain/bls/interface.d.ts +2 -0
  74. package/lib/chain/bls/interface.d.ts.map +1 -1
  75. package/lib/chain/bls/multithread/index.d.ts.map +1 -1
  76. package/lib/chain/bls/multithread/index.js +13 -11
  77. package/lib/chain/bls/multithread/index.js.map +1 -1
  78. package/lib/chain/bls/multithread/types.d.ts +1 -1
  79. package/lib/chain/bls/multithread/types.d.ts.map +1 -1
  80. package/lib/chain/bls/multithread/worker.js +1 -1
  81. package/lib/chain/bls/multithread/worker.js.map +1 -1
  82. package/lib/chain/bls/singleThread.js +1 -1
  83. package/lib/chain/bls/singleThread.js.map +1 -1
  84. package/lib/chain/bls/utils.js +1 -1
  85. package/lib/chain/bls/utils.js.map +1 -1
  86. package/lib/chain/chain.d.ts +3 -2
  87. package/lib/chain/chain.d.ts.map +1 -1
  88. package/lib/chain/chain.js +8 -5
  89. package/lib/chain/chain.js.map +1 -1
  90. package/lib/chain/errors/blockError.d.ts +1 -1
  91. package/lib/chain/errors/blockError.d.ts.map +1 -1
  92. package/lib/chain/errors/blockError.js +1 -1
  93. package/lib/chain/errors/blockError.js.map +1 -1
  94. package/lib/chain/errors/executionPayloadBid.d.ts +11 -1
  95. package/lib/chain/errors/executionPayloadBid.d.ts.map +1 -1
  96. package/lib/chain/errors/executionPayloadBid.js +2 -0
  97. package/lib/chain/errors/executionPayloadBid.js.map +1 -1
  98. package/lib/chain/errors/inclusionList.d.ts +60 -0
  99. package/lib/chain/errors/inclusionList.d.ts.map +1 -0
  100. package/lib/chain/errors/inclusionList.js +19 -0
  101. package/lib/chain/errors/inclusionList.js.map +1 -0
  102. package/lib/chain/errors/index.d.ts +1 -0
  103. package/lib/chain/errors/index.d.ts.map +1 -1
  104. package/lib/chain/errors/index.js +1 -0
  105. package/lib/chain/errors/index.js.map +1 -1
  106. package/lib/chain/interface.d.ts +4 -4
  107. package/lib/chain/interface.d.ts.map +1 -1
  108. package/lib/chain/interface.js.map +1 -1
  109. package/lib/chain/opPools/aggregatedAttestationPool.d.ts.map +1 -1
  110. package/lib/chain/opPools/aggregatedAttestationPool.js +23 -10
  111. package/lib/chain/opPools/aggregatedAttestationPool.js.map +1 -1
  112. package/lib/chain/opPools/attestationPool.d.ts +1 -1
  113. package/lib/chain/opPools/attestationPool.d.ts.map +1 -1
  114. package/lib/chain/opPools/attestationPool.js +15 -4
  115. package/lib/chain/opPools/attestationPool.js.map +1 -1
  116. package/lib/chain/opPools/inclusionListStore.d.ts +63 -0
  117. package/lib/chain/opPools/inclusionListStore.d.ts.map +1 -0
  118. package/lib/chain/opPools/inclusionListStore.js +171 -0
  119. package/lib/chain/opPools/inclusionListStore.js.map +1 -0
  120. package/lib/chain/opPools/index.d.ts +1 -0
  121. package/lib/chain/opPools/index.d.ts.map +1 -1
  122. package/lib/chain/opPools/index.js +1 -0
  123. package/lib/chain/opPools/index.js.map +1 -1
  124. package/lib/chain/opPools/payloadAttestationPool.d.ts.map +1 -1
  125. package/lib/chain/opPools/payloadAttestationPool.js +17 -7
  126. package/lib/chain/opPools/payloadAttestationPool.js.map +1 -1
  127. package/lib/chain/opPools/syncCommitteeMessagePool.d.ts.map +1 -1
  128. package/lib/chain/opPools/syncCommitteeMessagePool.js +9 -3
  129. package/lib/chain/opPools/syncCommitteeMessagePool.js.map +1 -1
  130. package/lib/chain/opPools/syncContributionAndProofPool.d.ts.map +1 -1
  131. package/lib/chain/opPools/syncContributionAndProofPool.js +11 -3
  132. package/lib/chain/opPools/syncContributionAndProofPool.js.map +1 -1
  133. package/lib/chain/opPools/utils.d.ts +1 -1
  134. package/lib/chain/opPools/utils.d.ts.map +1 -1
  135. package/lib/chain/opPools/utils.js +1 -1
  136. package/lib/chain/opPools/utils.js.map +1 -1
  137. package/lib/chain/options.d.ts +0 -1
  138. package/lib/chain/options.d.ts.map +1 -1
  139. package/lib/chain/options.js +0 -1
  140. package/lib/chain/options.js.map +1 -1
  141. package/lib/chain/produceBlock/produceBlockBody.d.ts +3 -1
  142. package/lib/chain/produceBlock/produceBlockBody.d.ts.map +1 -1
  143. package/lib/chain/produceBlock/produceBlockBody.js +30 -10
  144. package/lib/chain/produceBlock/produceBlockBody.js.map +1 -1
  145. package/lib/chain/regen/interface.d.ts +1 -1
  146. package/lib/chain/regen/interface.d.ts.map +1 -1
  147. package/lib/chain/regen/interface.js +1 -1
  148. package/lib/chain/regen/interface.js.map +1 -1
  149. package/lib/chain/validation/executionPayloadBid.d.ts +0 -15
  150. package/lib/chain/validation/executionPayloadBid.d.ts.map +1 -1
  151. package/lib/chain/validation/executionPayloadBid.js +37 -158
  152. package/lib/chain/validation/executionPayloadBid.js.map +1 -1
  153. package/lib/chain/validation/inclusionList.d.ts +14 -0
  154. package/lib/chain/validation/inclusionList.d.ts.map +1 -0
  155. package/lib/chain/validation/inclusionList.js +150 -0
  156. package/lib/chain/validation/inclusionList.js.map +1 -0
  157. package/lib/chain/validation/index.d.ts +1 -0
  158. package/lib/chain/validation/index.d.ts.map +1 -1
  159. package/lib/chain/validation/index.js +1 -0
  160. package/lib/chain/validation/index.js.map +1 -1
  161. package/lib/db/beacon.d.ts +7 -0
  162. package/lib/db/beacon.d.ts.map +1 -1
  163. package/lib/db/beacon.js +34 -0
  164. package/lib/db/beacon.js.map +1 -1
  165. package/lib/db/dataColumnStore.d.ts +1 -1
  166. package/lib/db/dataColumnStore.d.ts.map +1 -1
  167. package/lib/db/dataColumnStore.js +1 -4
  168. package/lib/db/dataColumnStore.js.map +1 -1
  169. package/lib/db/flatFileStore/flatFileStore.js +5 -5
  170. package/lib/db/flatFileStore/flatFileStore.js.map +1 -1
  171. package/lib/db/flatFileStore/slotIndex.d.ts.map +1 -1
  172. package/lib/db/flatFileStore/slotIndex.js +2 -2
  173. package/lib/db/flatFileStore/slotIndex.js.map +1 -1
  174. package/lib/db/interface.d.ts +1 -0
  175. package/lib/db/interface.d.ts.map +1 -1
  176. package/lib/db/repositories/dataColumnSidecarArchive.d.ts +6 -0
  177. package/lib/db/repositories/dataColumnSidecarArchive.d.ts.map +1 -1
  178. package/lib/db/repositories/dataColumnSidecarArchive.js +19 -0
  179. package/lib/db/repositories/dataColumnSidecarArchive.js.map +1 -1
  180. package/lib/execution/builder/apiClient.d.ts +14 -8
  181. package/lib/execution/builder/apiClient.d.ts.map +1 -1
  182. package/lib/execution/builder/apiClient.js +12 -10
  183. package/lib/execution/builder/apiClient.js.map +1 -1
  184. package/lib/execution/builder/http.d.ts +2 -0
  185. package/lib/execution/builder/http.d.ts.map +1 -1
  186. package/lib/execution/builder/http.js +2 -0
  187. package/lib/execution/builder/http.js.map +1 -1
  188. package/lib/execution/builder/validateBid.d.ts.map +1 -1
  189. package/lib/execution/builder/validateBid.js +14 -1
  190. package/lib/execution/builder/validateBid.js.map +1 -1
  191. package/lib/execution/engine/blobVersionedHashes.d.ts +1 -1
  192. package/lib/execution/engine/blobVersionedHashes.d.ts.map +1 -1
  193. package/lib/execution/engine/blobVersionedHashes.js.map +1 -1
  194. package/lib/execution/engine/disabled.d.ts +1 -0
  195. package/lib/execution/engine/disabled.d.ts.map +1 -1
  196. package/lib/execution/engine/disabled.js +3 -0
  197. package/lib/execution/engine/disabled.js.map +1 -1
  198. package/lib/execution/engine/http.d.ts +8 -2
  199. package/lib/execution/engine/http.d.ts.map +1 -1
  200. package/lib/execution/engine/http.js +27 -4
  201. package/lib/execution/engine/http.js.map +1 -1
  202. package/lib/execution/engine/index.d.ts +1 -1
  203. package/lib/execution/engine/index.d.ts.map +1 -1
  204. package/lib/execution/engine/index.js +1 -1
  205. package/lib/execution/engine/index.js.map +1 -1
  206. package/lib/execution/engine/interface.d.ts +12 -3
  207. package/lib/execution/engine/interface.d.ts.map +1 -1
  208. package/lib/execution/engine/interface.js.map +1 -1
  209. package/lib/execution/engine/jsonRpcTransport.d.ts +3 -2
  210. package/lib/execution/engine/jsonRpcTransport.d.ts.map +1 -1
  211. package/lib/execution/engine/jsonRpcTransport.js +33 -9
  212. package/lib/execution/engine/jsonRpcTransport.js.map +1 -1
  213. package/lib/execution/engine/mock.d.ts +1 -0
  214. package/lib/execution/engine/mock.d.ts.map +1 -1
  215. package/lib/execution/engine/mock.js +31 -7
  216. package/lib/execution/engine/mock.js.map +1 -1
  217. package/lib/execution/engine/payloadIdCache.d.ts +5 -3
  218. package/lib/execution/engine/payloadIdCache.d.ts.map +1 -1
  219. package/lib/execution/engine/payloadIdCache.js +15 -4
  220. package/lib/execution/engine/payloadIdCache.js.map +1 -1
  221. package/lib/execution/engine/restTransport.d.ts +2 -1
  222. package/lib/execution/engine/restTransport.d.ts.map +1 -1
  223. package/lib/execution/engine/restTransport.js +3 -0
  224. package/lib/execution/engine/restTransport.js.map +1 -1
  225. package/lib/execution/engine/sszTypes.d.ts +38 -38
  226. package/lib/execution/engine/transport.d.ts +5 -2
  227. package/lib/execution/engine/transport.d.ts.map +1 -1
  228. package/lib/execution/engine/types.d.ts +25 -1
  229. package/lib/execution/engine/types.d.ts.map +1 -1
  230. package/lib/execution/engine/types.js +19 -6
  231. package/lib/execution/engine/types.js.map +1 -1
  232. package/lib/execution/engine/utils.d.ts.map +1 -1
  233. package/lib/execution/engine/utils.js +3 -2
  234. package/lib/execution/engine/utils.js.map +1 -1
  235. package/lib/index.d.ts +1 -0
  236. package/lib/index.d.ts.map +1 -1
  237. package/lib/index.js +2 -0
  238. package/lib/index.js.map +1 -1
  239. package/lib/metrics/metrics/beacon.d.ts +16 -0
  240. package/lib/metrics/metrics/beacon.d.ts.map +1 -1
  241. package/lib/metrics/metrics/beacon.js +35 -0
  242. package/lib/metrics/metrics/beacon.js.map +1 -1
  243. package/lib/metrics/metrics/lodestar.d.ts +16 -0
  244. package/lib/metrics/metrics/lodestar.d.ts.map +1 -1
  245. package/lib/metrics/metrics/lodestar.js +35 -0
  246. package/lib/metrics/metrics/lodestar.js.map +1 -1
  247. package/lib/metrics/server/http.js +5 -5
  248. package/lib/metrics/server/http.js.map +1 -1
  249. package/lib/monitoring/service.js +1 -1
  250. package/lib/monitoring/service.js.map +1 -1
  251. package/lib/network/core/networkCore.d.ts +2 -0
  252. package/lib/network/core/networkCore.d.ts.map +1 -1
  253. package/lib/network/core/networkCore.js +3 -0
  254. package/lib/network/core/networkCore.js.map +1 -1
  255. package/lib/network/core/networkCoreWorker.js +1 -0
  256. package/lib/network/core/networkCoreWorker.js.map +1 -1
  257. package/lib/network/core/networkCoreWorkerHandler.d.ts +2 -0
  258. package/lib/network/core/networkCoreWorkerHandler.d.ts.map +1 -1
  259. package/lib/network/core/networkCoreWorkerHandler.js +3 -0
  260. package/lib/network/core/networkCoreWorkerHandler.js.map +1 -1
  261. package/lib/network/core/types.d.ts +2 -0
  262. package/lib/network/core/types.d.ts.map +1 -1
  263. package/lib/network/gossip/interface.d.ts +8 -2
  264. package/lib/network/gossip/interface.d.ts.map +1 -1
  265. package/lib/network/gossip/interface.js +1 -0
  266. package/lib/network/gossip/interface.js.map +1 -1
  267. package/lib/network/gossip/topic.d.ts +13 -5
  268. package/lib/network/gossip/topic.d.ts.map +1 -1
  269. package/lib/network/gossip/topic.js +13 -1
  270. package/lib/network/gossip/topic.js.map +1 -1
  271. package/lib/network/interface.d.ts +4 -1
  272. package/lib/network/interface.d.ts.map +1 -1
  273. package/lib/network/libp2p/index.d.ts.map +1 -1
  274. package/lib/network/libp2p/index.js +5 -1
  275. package/lib/network/libp2p/index.js.map +1 -1
  276. package/lib/network/network.d.ts +4 -1
  277. package/lib/network/network.d.ts.map +1 -1
  278. package/lib/network/network.js +11 -1
  279. package/lib/network/network.js.map +1 -1
  280. package/lib/network/options.d.ts +2 -0
  281. package/lib/network/options.d.ts.map +1 -1
  282. package/lib/network/options.js.map +1 -1
  283. package/lib/network/peers/peerManager.d.ts +2 -1
  284. package/lib/network/peers/peerManager.d.ts.map +1 -1
  285. package/lib/network/peers/peerManager.js.map +1 -1
  286. package/lib/network/peers/utils/assertPeerRelevance.d.ts +9 -1
  287. package/lib/network/peers/utils/assertPeerRelevance.d.ts.map +1 -1
  288. package/lib/network/peers/utils/assertPeerRelevance.js +32 -21
  289. package/lib/network/peers/utils/assertPeerRelevance.js.map +1 -1
  290. package/lib/network/peers/utils/enrSubnetsDeserialize.d.ts.map +1 -1
  291. package/lib/network/peers/utils/enrSubnetsDeserialize.js +5 -2
  292. package/lib/network/peers/utils/enrSubnetsDeserialize.js.map +1 -1
  293. package/lib/network/processor/gossipHandlers.d.ts.map +1 -1
  294. package/lib/network/processor/gossipHandlers.js +95 -37
  295. package/lib/network/processor/gossipHandlers.js.map +1 -1
  296. package/lib/network/processor/gossipQueues/index.d.ts.map +1 -1
  297. package/lib/network/processor/gossipQueues/index.js +6 -0
  298. package/lib/network/processor/gossipQueues/index.js.map +1 -1
  299. package/lib/network/processor/gossipValidatorFn.d.ts.map +1 -1
  300. package/lib/network/processor/gossipValidatorFn.js +5 -1
  301. package/lib/network/processor/gossipValidatorFn.js.map +1 -1
  302. package/lib/network/processor/index.d.ts +5 -0
  303. package/lib/network/processor/index.d.ts.map +1 -1
  304. package/lib/network/processor/index.js +37 -26
  305. package/lib/network/processor/index.js.map +1 -1
  306. package/lib/network/reqresp/ReqRespBeaconNode.d.ts.map +1 -1
  307. package/lib/network/reqresp/ReqRespBeaconNode.js +6 -0
  308. package/lib/network/reqresp/ReqRespBeaconNode.js.map +1 -1
  309. package/lib/network/reqresp/handlers/inclusionListsByIndices.d.ts +10 -0
  310. package/lib/network/reqresp/handlers/inclusionListsByIndices.d.ts.map +1 -0
  311. package/lib/network/reqresp/handlers/inclusionListsByIndices.js +30 -0
  312. package/lib/network/reqresp/handlers/inclusionListsByIndices.js.map +1 -0
  313. package/lib/network/reqresp/handlers/index.d.ts.map +1 -1
  314. package/lib/network/reqresp/handlers/index.js +5 -0
  315. package/lib/network/reqresp/handlers/index.js.map +1 -1
  316. package/lib/network/reqresp/protocols.d.ts +1 -0
  317. package/lib/network/reqresp/protocols.d.ts.map +1 -1
  318. package/lib/network/reqresp/protocols.js +5 -0
  319. package/lib/network/reqresp/protocols.js.map +1 -1
  320. package/lib/network/reqresp/rateLimit.d.ts.map +1 -1
  321. package/lib/network/reqresp/rateLimit.js +4 -0
  322. package/lib/network/reqresp/rateLimit.js.map +1 -1
  323. package/lib/network/reqresp/types.d.ts +5 -2
  324. package/lib/network/reqresp/types.d.ts.map +1 -1
  325. package/lib/network/reqresp/types.js +3 -0
  326. package/lib/network/reqresp/types.js.map +1 -1
  327. package/lib/node/nodejs.d.ts +3 -1
  328. package/lib/node/nodejs.d.ts.map +1 -1
  329. package/lib/node/nodejs.js +47 -21
  330. package/lib/node/nodejs.js.map +1 -1
  331. package/lib/node/options.d.ts +3 -1
  332. package/lib/node/options.d.ts.map +1 -1
  333. package/lib/node/options.js +4 -2
  334. package/lib/node/options.js.map +1 -1
  335. package/lib/sync/interface.d.ts.map +1 -1
  336. package/lib/sync/interface.js.map +1 -1
  337. package/lib/sync/sync.d.ts +7 -0
  338. package/lib/sync/sync.d.ts.map +1 -1
  339. package/lib/sync/sync.js +61 -3
  340. package/lib/sync/sync.js.map +1 -1
  341. package/lib/sync/unknownBlock.d.ts.map +1 -1
  342. package/lib/sync/unknownBlock.js +42 -18
  343. package/lib/sync/unknownBlock.js.map +1 -1
  344. package/lib/util/file.d.ts.map +1 -1
  345. package/lib/util/file.js +8 -9
  346. package/lib/util/file.js.map +1 -1
  347. package/lib/util/queue/itemQueue.js +1 -1
  348. package/lib/util/queue/itemQueue.js.map +1 -1
  349. package/lib/util/sszBytes.js +2 -2
  350. package/lib/util/sszBytes.js.map +1 -1
  351. package/package.json +31 -32
  352. package/src/api/impl/api.ts +1 -1
  353. package/src/api/impl/beacon/blocks/index.ts +57 -62
  354. package/src/api/impl/beacon/index.ts +3 -1
  355. package/src/api/impl/beacon/pool/index.ts +5 -1
  356. package/src/api/impl/beacon/state/index.ts +10 -1
  357. package/src/api/impl/beacon/state/utils.ts +20 -10
  358. package/src/api/impl/debug/index.ts +4 -0
  359. package/src/api/impl/validator/index.ts +178 -39
  360. package/src/api/options.ts +3 -0
  361. package/src/chain/GetBlobsTracker.ts +97 -38
  362. package/src/chain/archiveStore/archiveStore.ts +1 -0
  363. package/src/chain/archiveStore/utils/archiveBlocks.ts +76 -130
  364. package/src/chain/blocks/importBlock.ts +11 -14
  365. package/src/chain/blocks/importExecutionPayload.ts +81 -23
  366. package/src/chain/blocks/index.ts +6 -2
  367. package/src/chain/blocks/payloadEnvelopeProcessor.ts +35 -24
  368. package/src/chain/blocks/types.ts +9 -1
  369. package/src/chain/blocks/verifyBlock.ts +31 -16
  370. package/src/chain/blocks/verifyBlocksDataAvailability.ts +10 -1
  371. package/src/chain/blocks/verifyBlocksSignatures.ts +7 -5
  372. package/src/chain/blocks/verifyPayloadsDataAvailability.ts +14 -6
  373. package/src/chain/bls/interface.ts +2 -0
  374. package/src/chain/bls/multithread/index.ts +14 -10
  375. package/src/chain/bls/multithread/types.ts +1 -1
  376. package/src/chain/bls/multithread/worker.ts +1 -5
  377. package/src/chain/bls/singleThread.ts +1 -1
  378. package/src/chain/bls/utils.ts +1 -1
  379. package/src/chain/chain.ts +9 -5
  380. package/src/chain/errors/blockError.ts +1 -1
  381. package/src/chain/errors/executionPayloadBid.ts +12 -0
  382. package/src/chain/errors/inclusionList.ts +38 -0
  383. package/src/chain/errors/index.ts +1 -0
  384. package/src/chain/interface.ts +4 -3
  385. package/src/chain/opPools/aggregatedAttestationPool.ts +25 -9
  386. package/src/chain/opPools/attestationPool.ts +16 -4
  387. package/src/chain/opPools/inclusionListStore.ts +208 -0
  388. package/src/chain/opPools/index.ts +1 -0
  389. package/src/chain/opPools/payloadAttestationPool.ts +18 -7
  390. package/src/chain/opPools/syncCommitteeMessagePool.ts +10 -3
  391. package/src/chain/opPools/syncContributionAndProofPool.ts +13 -3
  392. package/src/chain/opPools/utils.ts +1 -1
  393. package/src/chain/options.ts +0 -2
  394. package/src/chain/produceBlock/produceBlockBody.ts +60 -19
  395. package/src/chain/regen/interface.ts +1 -1
  396. package/src/chain/validation/executionPayloadBid.ts +54 -183
  397. package/src/chain/validation/inclusionList.ts +192 -0
  398. package/src/chain/validation/index.ts +1 -0
  399. package/src/db/beacon.ts +44 -0
  400. package/src/db/dataColumnStore.ts +2 -4
  401. package/src/db/flatFileStore/flatFileStore.ts +7 -7
  402. package/src/db/flatFileStore/slotIndex.ts +4 -3
  403. package/src/db/interface.ts +2 -0
  404. package/src/db/repositories/dataColumnSidecarArchive.ts +20 -0
  405. package/src/execution/builder/apiClient.ts +16 -13
  406. package/src/execution/builder/http.ts +4 -0
  407. package/src/execution/builder/validateBid.ts +23 -2
  408. package/src/execution/engine/blobVersionedHashes.ts +1 -1
  409. package/src/execution/engine/disabled.ts +4 -0
  410. package/src/execution/engine/http.ts +40 -5
  411. package/src/execution/engine/index.ts +1 -1
  412. package/src/execution/engine/interface.ts +28 -4
  413. package/src/execution/engine/jsonRpcTransport.ts +46 -9
  414. package/src/execution/engine/mock.ts +32 -7
  415. package/src/execution/engine/payloadIdCache.ts +24 -6
  416. package/src/execution/engine/restTransport.ts +15 -1
  417. package/src/execution/engine/transport.ts +7 -2
  418. package/src/execution/engine/types.ts +44 -7
  419. package/src/execution/engine/utils.ts +4 -2
  420. package/src/index.ts +2 -0
  421. package/src/metrics/metrics/beacon.ts +37 -0
  422. package/src/metrics/metrics/lodestar.ts +36 -0
  423. package/src/metrics/server/http.ts +5 -5
  424. package/src/monitoring/service.ts +1 -1
  425. package/src/network/core/networkCore.ts +5 -0
  426. package/src/network/core/networkCoreWorker.ts +1 -0
  427. package/src/network/core/networkCoreWorkerHandler.ts +4 -0
  428. package/src/network/core/types.ts +2 -0
  429. package/src/network/gossip/interface.ts +5 -0
  430. package/src/network/gossip/topic.ts +14 -0
  431. package/src/network/interface.ts +4 -0
  432. package/src/network/libp2p/index.ts +5 -1
  433. package/src/network/network.ts +19 -1
  434. package/src/network/options.ts +2 -0
  435. package/src/network/peers/peerManager.ts +1 -1
  436. package/src/network/peers/utils/assertPeerRelevance.ts +39 -23
  437. package/src/network/peers/utils/enrSubnetsDeserialize.ts +5 -2
  438. package/src/network/processor/gossipHandlers.ts +116 -40
  439. package/src/network/processor/gossipQueues/index.ts +6 -0
  440. package/src/network/processor/gossipValidatorFn.ts +5 -0
  441. package/src/network/processor/index.ts +33 -24
  442. package/src/network/processor/types.ts +1 -1
  443. package/src/network/reqresp/ReqRespBeaconNode.ts +7 -0
  444. package/src/network/reqresp/handlers/inclusionListsByIndices.ts +44 -0
  445. package/src/network/reqresp/handlers/index.ts +5 -0
  446. package/src/network/reqresp/protocols.ts +6 -0
  447. package/src/network/reqresp/rateLimit.ts +4 -0
  448. package/src/network/reqresp/types.ts +6 -0
  449. package/src/node/nodejs.ts +58 -22
  450. package/src/node/options.ts +9 -6
  451. package/src/sync/interface.ts +1 -0
  452. package/src/sync/sync.ts +65 -4
  453. package/src/sync/unknownBlock.ts +47 -28
  454. package/src/util/file.ts +8 -9
  455. package/src/util/queue/itemQueue.ts +1 -1
  456. package/src/util/sszBytes.ts +2 -2
@@ -18,6 +18,7 @@ import {
18
18
  isForkPostElectra,
19
19
  isForkPostFulu,
20
20
  isForkPostGloas,
21
+ isForkPostHeze,
21
22
  } from "@lodestar/params";
22
23
  import {
23
24
  DataAvailabilityStatus,
@@ -28,6 +29,7 @@ import {
28
29
  computeStartSlotAtEpoch,
29
30
  computeTimeAtSlot,
30
31
  getCurrentSlot,
32
+ getInclusionListCommittee,
31
33
  isStatePostAltair,
32
34
  isStatePostGloas,
33
35
  proposerShufflingDecisionRoot,
@@ -68,6 +70,7 @@ import {
68
70
  } from "@lodestar/utils";
69
71
  import {MAX_BUILDER_BOOST_FACTOR} from "@lodestar/validator";
70
72
  import {BlockInputSource} from "../../../chain/blocks/blockInput/types.js";
73
+ import {InclusionListSource} from "../../../chain/blocks/types.js";
71
74
  import {
72
75
  AttestationError,
73
76
  AttestationErrorCode,
@@ -83,11 +86,15 @@ import {PREPARE_NEXT_SLOT_BPS} from "../../../chain/prepareNextSlot.js";
83
86
  import {BlockType, ProduceFullDeneb, ProduceFullGloas} from "../../../chain/produceBlock/index.js";
84
87
  import {RegenCaller} from "../../../chain/regen/index.js";
85
88
  import {CheckpointHex} from "../../../chain/stateCache/types.js";
86
- import {validateApiAggregateAndProof} from "../../../chain/validation/index.js";
89
+ import {
90
+ InclusionListValidationResult,
91
+ validateApiAggregateAndProof,
92
+ validateGossipInclusionList,
93
+ } from "../../../chain/validation/index.js";
87
94
  import {validateGossipProposerPreferences} from "../../../chain/validation/proposerPreferences.js";
88
95
  import {validateSyncCommitteeGossipContributionAndProof} from "../../../chain/validation/syncCommitteeContributionAndProof.js";
89
96
  import {ZERO_HASH} from "../../../constants/index.js";
90
- import {BUILDER_BID_DEADLINE_MS, BuilderApiBid, decodeBuilderUrl} from "../../../execution/builder/apiClient.js";
97
+ import {BuilderApiBid, decodeBuilderUrl} from "../../../execution/builder/apiClient.js";
91
98
  import {BuilderStatus, NoBidReceived} from "../../../execution/builder/http.js";
92
99
  import {getBuilderBidTotalGwei, validateBuilderApiExecutionPayloadBid} from "../../../execution/builder/validateBid.js";
93
100
  import {validateGossipFnRetryUnknownRoot} from "../../../network/processor/gossipHandlers.js";
@@ -116,10 +123,14 @@ import {
116
123
  * A cutoff of 1667 BPS (2 seconds for 12s slots) gives enough time and if there are unexpected delays
117
124
  * it ensures we publish in time as proposals after the attestation deadline will likely be orphaned
118
125
  * due to proposer boost reorg.
119
- *
120
- * TODO GLOAS: re-evaluate cutoff timing due to attestation deadline changes in gloas
121
126
  */
122
127
  const BLOCK_PRODUCTION_RACE_CUTOFF_BPS = 1667;
128
+ /**
129
+ * Post-gloas cutoff, kept at 1667 BPS (2 seconds for 12s slots) for now.
130
+ *
131
+ * TODO GLOAS: revisit, the block propagates faster as it only commits to a bid and the attestation deadline changed
132
+ */
133
+ export const BLOCK_PRODUCTION_RACE_CUTOFF_GLOAS_BPS = 1667;
123
134
  /** Rejection message of the bid block branch when there is no viable bid to commit to */
124
135
  const NO_BID_AVAILABLE = "No builder bid available";
125
136
 
@@ -247,13 +258,13 @@ export function getValidatorApi(
247
258
  genesisBlockRoot = state.computeAnchorCheckpoint().checkpoint.root;
248
259
  } else if (state.slot < SLOTS_PER_HISTORICAL_ROOT) {
249
260
  genesisBlockRoot = state.getBlockRootAtSlot(GENESIS_SLOT);
250
- }
251
-
252
- const blockRes = await chain.getCanonicalBlockAtSlot(GENESIS_SLOT);
253
- if (blockRes) {
254
- genesisBlockRoot = config
255
- .getForkTypes(blockRes.block.message.slot)
256
- .SignedBeaconBlock.hashTreeRoot(blockRes.block);
261
+ } else {
262
+ const blockRes = await chain.getCanonicalBlockAtSlot(GENESIS_SLOT);
263
+ if (blockRes) {
264
+ genesisBlockRoot = config
265
+ .getForkTypes(blockRes.block.message.slot)
266
+ .BeaconBlock.hashTreeRoot(blockRes.block.message);
267
+ }
257
268
  }
258
269
  }
259
270
 
@@ -998,33 +1009,50 @@ export function getValidatorApi(
998
1009
  (!circuitBreakerActive &&
999
1010
  chain.executionPayloadBidPool.getBestBid(slot, bidParentBlockHash, parentBlockRootHex) !== null);
1000
1011
 
1001
- // Select the p2p bid once builders had time to bid up, matching the deadline advertised
1002
- // on builder API bid requests, unless the circuit breaker is active
1003
- const p2pBidPromise: Promise<PooledExecutionPayloadBid | null> = circuitBreakerActive
1004
- ? Promise.resolve(null)
1005
- : sleep(Math.max(0, BUILDER_BID_DEADLINE_MS - chain.clock.msFromSlot(slot))).then(() => {
1006
- const p2pBid = chain.executionPayloadBidPool.getBestBid(slot, bidParentBlockHash, parentBlockRootHex);
1007
- // Discard p2p bids below the proposer's configured floor on the total payment.
1008
- // A p2p bid's total is just its value since gossip validation enforces executionPayment=0.
1009
- if (p2pBid !== null && BigInt(p2pBid.signedBid.message.value) < builderConfig.minBid) {
1010
- logger.info("Best p2p bid below configured minimum", {
1011
- slot,
1012
- bidValue: prettyGweiToEth(p2pBid.signedBid.message.value),
1013
- minBid: prettyGweiToEth(builderConfig.minBid),
1014
- });
1015
- return null;
1016
- }
1017
- return p2pBid;
1018
- });
1012
+ // Calculate cutoff time based on start of the slot, ensures a slow local payload build does
1013
+ // not delay the proposal when a builder bid block is available (and vice versa)
1014
+ const cutoffMs = Math.max(
1015
+ 0,
1016
+ config.getSlotComponentDurationMs(fork, BLOCK_PRODUCTION_RACE_CUTOFF_GLOAS_BPS) - chain.clock.msFromSlot(slot)
1017
+ );
1018
+
1019
+ // Give p2p bids the same time to bid up as granted to builder API bid requests via the advertised
1020
+ // deadline, the pool is read once the deadline passed and the bid requests settled. A late request
1021
+ // does not wait past the race cutoff, a pooled bid is still the fastest fallback if the local block fails
1022
+ const bidDeadlinePromise = circuitBreakerActive
1023
+ ? Promise.resolve()
1024
+ : sleep(Math.min(chain.builderApiClient.bidDeadline, cutoffMs));
1019
1025
 
1020
1026
  // Candidates are ranked by their boosted counted total payment, the p2p bid is governed
1021
1027
  // by the top-level factors and each builder API bid by its own entry. Ties prefer the
1022
1028
  // earliest received builder API bid, so the signed block can be routed back to its
1023
1029
  // builder directly.
1024
1030
  const bestBidPromise: Promise<BidCandidate | null> = (async () => {
1025
- const [builderApiBids, p2pBid] = await Promise.all([builderApiBidsPromise, p2pBidPromise]);
1031
+ // Past the race cutoff a pooled p2p bid is used right away rather than waiting for pending
1032
+ // builder API requests, the local block is selected at the cutoff anyway if it is ready
1033
+ let [builderApiBids] = await Promise.all([
1034
+ Promise.race([builderApiBidsPromise, sleep(cutoffMs).then(() => null)]),
1035
+ bidDeadlinePromise,
1036
+ ]);
1026
1037
  let parentExecutionRequestsPromise: Promise<gloas.ExecutionRequests> | null = null;
1027
1038
 
1039
+ let p2pBid: PooledExecutionPayloadBid | null = circuitBreakerActive
1040
+ ? null
1041
+ : chain.executionPayloadBidPool.getBestBid(slot, bidParentBlockHash, parentBlockRootHex);
1042
+ // Discard p2p bids below the proposer's configured floor on the total payment.
1043
+ // A p2p bid's total is just its value since gossip validation enforces executionPayment=0.
1044
+ if (p2pBid !== null && BigInt(p2pBid.signedBid.message.value) < builderConfig.minBid) {
1045
+ logger.info("Best p2p bid below configured minimum", {
1046
+ slot,
1047
+ bidValue: prettyGweiToEth(p2pBid.signedBid.message.value),
1048
+ minBid: prettyGweiToEth(builderConfig.minBid),
1049
+ });
1050
+ p2pBid = null;
1051
+ }
1052
+ if (builderApiBids === null) {
1053
+ builderApiBids = p2pBid !== null ? [] : await builderApiBidsPromise;
1054
+ }
1055
+
1028
1056
  const candidates = (
1029
1057
  await Promise.all(
1030
1058
  builderApiBids.map(async ({url, entry, signedBid, receivedMs}): Promise<BidCandidate | null> => {
@@ -1111,13 +1139,6 @@ export function getValidatorApi(
1111
1139
  return fn().finally(() => t?.({source}));
1112
1140
  };
1113
1141
 
1114
- // Calculate cutoff time based on start of the slot, ensures a slow local payload build does
1115
- // not delay the proposal when a builder bid block is available (and vice versa)
1116
- const cutoffMs = Math.max(
1117
- 0,
1118
- config.getSlotComponentDurationMs(fork, BLOCK_PRODUCTION_RACE_CUTOFF_BPS) - chain.clock.msFromSlot(slot)
1119
- );
1120
-
1121
1142
  // use abort controller to stop waiting for the bid block if the engine block will be selected
1122
1143
  const controller = new AbortController();
1123
1144
 
@@ -1700,7 +1721,7 @@ export function getValidatorApi(
1700
1721
  }
1701
1722
  }
1702
1723
 
1703
- const dependentRoot = fromHex(state.getShufflingDecisionRoot(epoch)) || (await getGenesisBlockRoot(state));
1724
+ const dependentRoot = fromHex(state.getShufflingDecisionRoot(epoch));
1704
1725
 
1705
1726
  return {
1706
1727
  data: duties,
@@ -1749,7 +1770,10 @@ export function getValidatorApi(
1749
1770
  }
1750
1771
  }
1751
1772
 
1752
- const dependentRoot = fromHex(state.getShufflingDecisionRoot(epoch)) || (await getGenesisBlockRoot(state));
1773
+ // The fork epoch PTC is computed at the fork from effective balances updated at the end of the
1774
+ // last pre-fork epoch, so its dependent root is one epoch later than for other epochs
1775
+ const dependentRootEpoch = epoch === config.GLOAS_FORK_EPOCH ? epoch + 1 : epoch;
1776
+ const dependentRoot = fromHex(state.getShufflingDecisionRoot(dependentRootEpoch));
1753
1777
 
1754
1778
  return {
1755
1779
  data: duties,
@@ -2198,6 +2222,121 @@ export function getValidatorApi(
2198
2222
  }
2199
2223
  },
2200
2224
 
2225
+ async produceInclusionList({slot}) {
2226
+ notWhileSyncing(chain, sync.state);
2227
+
2228
+ if (!isForkPostHeze(chain.config.getForkName(slot))) {
2229
+ throw new ApiError(400, `Producing inclusion list for pre-heze slot: ${slot}`);
2230
+ }
2231
+
2232
+ await waitForSlot(slot); // Must never request for a future slot > currentSlot
2233
+
2234
+ const timer = metrics?.getInclusionListV1RequestsDuration.startTimer();
2235
+ const transactions = await chain.executionEngine.getInclusionList();
2236
+ timer?.();
2237
+ metrics?.getInclusionListV1Requests.inc();
2238
+
2239
+ return {data: transactions, meta: {version: chain.config.getForkName(slot)}};
2240
+ },
2241
+
2242
+ async getInclusionListCommitteeDuties({epoch, indices}) {
2243
+ notWhileSyncing(chain, sync.state);
2244
+
2245
+ if (indices.length === 0) {
2246
+ throw new ApiError(400, "No validator to get inclusion list committee duties");
2247
+ }
2248
+
2249
+ if (!isForkPostHeze(chain.config.getForkName(computeStartSlotAtEpoch(epoch)))) {
2250
+ throw new ApiError(400, `Requesting pre-heze inclusion list committee duties epoch: ${epoch}`);
2251
+ }
2252
+
2253
+ // May request for an epoch that's in the future
2254
+ await waitForNextClosestEpoch();
2255
+
2256
+ if (epoch > chain.clock.currentEpoch + 1) {
2257
+ throw new ApiError(400, "Cannot get duties for epoch more than one ahead");
2258
+ }
2259
+
2260
+ const head = chain.forkChoice.getHead();
2261
+ const state = await chain.getHeadStateAtCurrentEpoch(RegenCaller.getDuties);
2262
+
2263
+ const pubkeys = getPubkeysForIndices(state, indices);
2264
+ const requestedIndices = new Set(indices);
2265
+ const epochStartSlot = computeStartSlotAtEpoch(epoch);
2266
+ const shuffling = state.getShufflingAtEpoch(epoch);
2267
+
2268
+ // Validators set this as `dependent_root` on their inclusion lists
2269
+ const dependentRoot = fromHex(state.getShufflingDecisionRoot(epoch));
2270
+
2271
+ // A validator can be on several slots' committees in an epoch; report the earliest, as for attester duties
2272
+ const dutySlotByValidator = new Map<ValidatorIndex, Slot>();
2273
+ for (let i = 0; i < SLOTS_PER_EPOCH; i++) {
2274
+ const slot = epochStartSlot + i;
2275
+ for (const validatorIndex of getInclusionListCommittee(shuffling, slot).validatorIndices) {
2276
+ if (requestedIndices.has(validatorIndex) && !dutySlotByValidator.has(validatorIndex)) {
2277
+ dutySlotByValidator.set(validatorIndex, slot);
2278
+ }
2279
+ }
2280
+ }
2281
+
2282
+ const duties: routes.validator.InclusionListDuty[] = [];
2283
+ for (let i = 0; i < indices.length; i++) {
2284
+ const validatorIndex = indices[i];
2285
+ const slot = dutySlotByValidator.get(validatorIndex);
2286
+ if (slot !== undefined) {
2287
+ duties.push({pubkey: pubkeys[i], validatorIndex, slot, dependentRoot});
2288
+ }
2289
+ }
2290
+
2291
+ return {
2292
+ data: duties,
2293
+ meta: {
2294
+ dependentRoot: toRootHex(dependentRoot),
2295
+ executionOptimistic: isOptimisticBlock(head),
2296
+ },
2297
+ };
2298
+ },
2299
+
2300
+ async publishInclusionList({signedInclusionList}) {
2301
+ notWhileSyncing(chain, sync.state);
2302
+
2303
+ const {slot} = signedInclusionList.message;
2304
+ if (!isForkPostHeze(chain.config.getForkName(slot))) {
2305
+ throw new ApiError(400, `Publishing pre-heze inclusion list slot: ${slot}`);
2306
+ }
2307
+
2308
+ // Timeliness is judged on receipt, as for gossip, so a list submitted in time stays timely if validation is slow
2309
+ const secFromSlot = chain.clock.secFromSlot(slot, Date.now() / 1000);
2310
+ metrics?.inclusionListsReceived.inc({source: InclusionListSource.api});
2311
+ metrics?.inclusionListTransactionsReceived.inc(
2312
+ {source: InclusionListSource.api},
2313
+ signedInclusionList.message.transactions.length
2314
+ );
2315
+
2316
+ const timer = metrics?.inclusionListsValidationTime.startTimer();
2317
+ let validationResult: InclusionListValidationResult;
2318
+ try {
2319
+ validationResult = await validateGossipInclusionList(chain, signedInclusionList);
2320
+ } finally {
2321
+ timer?.({source: InclusionListSource.api});
2322
+ }
2323
+ const {committeeIndices, totalBytes} = validationResult;
2324
+ metrics?.inclusionListsValid.inc({source: InclusionListSource.api});
2325
+ metrics?.inclusionListsValidSize.inc(totalBytes);
2326
+
2327
+ const isTimely =
2328
+ secFromSlot >= 0 && secFromSlot * 1000 < chain.config.getInclusionListDueMs(chain.config.getForkName(slot));
2329
+ chain.inclusionListStore.process(signedInclusionList, committeeIndices, isTimely);
2330
+
2331
+ chain.emitter.emit(routes.events.EventType.inclusionList, {
2332
+ version: chain.config.getForkName(slot),
2333
+ data: signedInclusionList,
2334
+ });
2335
+
2336
+ await network.publishInclusionList(signedInclusionList);
2337
+ metrics?.inclusionListsPublished.inc();
2338
+ },
2339
+
2201
2340
  async getExecutionPayloadEnvelope({slot, beaconBlockRoot}) {
2202
2341
  const fork = config.getForkName(slot);
2203
2342
 
@@ -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,55 @@ 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
+ // Post-gloas only the bid triggers a request, so every failed attempt re-enters to arm its own retry
163
+ const hadPendingTrigger = this.pendingTriggers.delete(input.blockRootHex);
164
+ if (requestFailed && (hadPendingTrigger || input instanceof PayloadEnvelopeInput)) {
165
+ this.triggerGetBlobs(input);
166
+ }
167
+ }
168
+
169
+ private recordFailedAttempt(blockRootHex: string): void {
170
+ const failed = this.failedAttempts.get(blockRootHex);
171
+ clearTimeout(failed?.retryTimer);
172
+ this.failedAttempts.set(blockRootHex, {count: (failed?.count ?? 0) + 1, lastAttemptMs: Date.now()});
173
+ pruneSetToMax(this.failedAttempts, MAX_TRACKED_BLOCK_ROOTS);
115
174
  }
116
175
  }
@@ -197,6 +197,7 @@ export class ArchiveStore {
197
197
  //
198
198
  // `jobQueue.push()` can throw synchronously (queue aborted / full) or reject asynchronously;
199
199
  // awaiting it inside the deferred callback funnels both failure modes into the one catch.
200
+ // biome-ignore lint/nursery/noMisusedPromises: the callback catches all errors itself
200
201
  callInNextEventLoop(async () => {
201
202
  try {
202
203
  await this.jobQueue.push(finalized);