@lodestar/beacon-node 1.43.0-dev.aef3645690 → 1.43.0-dev.b0e1143d06

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 (449) hide show
  1. package/lib/api/impl/beacon/blocks/index.d.ts.map +1 -1
  2. package/lib/api/impl/beacon/blocks/index.js +17 -9
  3. package/lib/api/impl/beacon/blocks/index.js.map +1 -1
  4. package/lib/api/impl/beacon/pool/index.d.ts.map +1 -1
  5. package/lib/api/impl/beacon/pool/index.js +45 -2
  6. package/lib/api/impl/beacon/pool/index.js.map +1 -1
  7. package/lib/api/impl/beacon/state/utils.d.ts +2 -2
  8. package/lib/api/impl/beacon/state/utils.d.ts.map +1 -1
  9. package/lib/api/impl/beacon/state/utils.js.map +1 -1
  10. package/lib/api/impl/debug/index.d.ts.map +1 -1
  11. package/lib/api/impl/debug/index.js +0 -1
  12. package/lib/api/impl/debug/index.js.map +1 -1
  13. package/lib/api/impl/lodestar/index.js +1 -1
  14. package/lib/api/impl/lodestar/index.js.map +1 -1
  15. package/lib/api/impl/validator/index.d.ts.map +1 -1
  16. package/lib/api/impl/validator/index.js +68 -5
  17. package/lib/api/impl/validator/index.js.map +1 -1
  18. package/lib/chain/GetBlobsTracker.d.ts +1 -1
  19. package/lib/chain/GetBlobsTracker.d.ts.map +1 -1
  20. package/lib/chain/GetBlobsTracker.js +1 -2
  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.map +1 -1
  24. package/lib/chain/archiveStore/interface.d.ts +4 -4
  25. package/lib/chain/archiveStore/interface.d.ts.map +1 -1
  26. package/lib/chain/archiveStore/strategies/frequencyStateArchiveStrategy.d.ts +4 -4
  27. package/lib/chain/archiveStore/strategies/frequencyStateArchiveStrategy.d.ts.map +1 -1
  28. package/lib/chain/archiveStore/strategies/frequencyStateArchiveStrategy.js +2 -4
  29. package/lib/chain/archiveStore/strategies/frequencyStateArchiveStrategy.js.map +1 -1
  30. package/lib/chain/archiveStore/utils/archiveBlocks.d.ts +2 -2
  31. package/lib/chain/archiveStore/utils/archiveBlocks.d.ts.map +1 -1
  32. package/lib/chain/archiveStore/utils/archiveBlocks.js +110 -58
  33. package/lib/chain/archiveStore/utils/archiveBlocks.js.map +1 -1
  34. package/lib/chain/blocks/blockInput/blockInput.d.ts +3 -0
  35. package/lib/chain/blocks/blockInput/blockInput.d.ts.map +1 -1
  36. package/lib/chain/blocks/blockInput/blockInput.js +4 -1
  37. package/lib/chain/blocks/blockInput/blockInput.js.map +1 -1
  38. package/lib/chain/blocks/importBlock.d.ts.map +1 -1
  39. package/lib/chain/blocks/importBlock.js +38 -58
  40. package/lib/chain/blocks/importBlock.js.map +1 -1
  41. package/lib/chain/blocks/importExecutionPayload.d.ts +32 -14
  42. package/lib/chain/blocks/importExecutionPayload.d.ts.map +1 -1
  43. package/lib/chain/blocks/importExecutionPayload.js +101 -90
  44. package/lib/chain/blocks/importExecutionPayload.js.map +1 -1
  45. package/lib/chain/blocks/index.d.ts +5 -3
  46. package/lib/chain/blocks/index.d.ts.map +1 -1
  47. package/lib/chain/blocks/index.js +58 -26
  48. package/lib/chain/blocks/index.js.map +1 -1
  49. package/lib/chain/blocks/payloadEnvelopeInput/payloadEnvelopeInput.d.ts +15 -1
  50. package/lib/chain/blocks/payloadEnvelopeInput/payloadEnvelopeInput.d.ts.map +1 -1
  51. package/lib/chain/blocks/payloadEnvelopeInput/payloadEnvelopeInput.js +48 -2
  52. package/lib/chain/blocks/payloadEnvelopeInput/payloadEnvelopeInput.js.map +1 -1
  53. package/lib/chain/blocks/payloadEnvelopeInput/types.d.ts +17 -0
  54. package/lib/chain/blocks/payloadEnvelopeInput/types.d.ts.map +1 -1
  55. package/lib/chain/blocks/payloadEnvelopeProcessor.d.ts +5 -0
  56. package/lib/chain/blocks/payloadEnvelopeProcessor.d.ts.map +1 -1
  57. package/lib/chain/blocks/payloadEnvelopeProcessor.js +7 -5
  58. package/lib/chain/blocks/payloadEnvelopeProcessor.js.map +1 -1
  59. package/lib/chain/blocks/types.d.ts +16 -21
  60. package/lib/chain/blocks/types.d.ts.map +1 -1
  61. package/lib/chain/blocks/utils/chainSegment.d.ts +21 -2
  62. package/lib/chain/blocks/utils/chainSegment.d.ts.map +1 -1
  63. package/lib/chain/blocks/utils/chainSegment.js +92 -12
  64. package/lib/chain/blocks/utils/chainSegment.js.map +1 -1
  65. package/lib/chain/blocks/verifyBlock.d.ts +5 -3
  66. package/lib/chain/blocks/verifyBlock.d.ts.map +1 -1
  67. package/lib/chain/blocks/verifyBlock.js +50 -7
  68. package/lib/chain/blocks/verifyBlock.js.map +1 -1
  69. package/lib/chain/blocks/verifyBlocksExecutionPayloads.d.ts +0 -4
  70. package/lib/chain/blocks/verifyBlocksExecutionPayloads.d.ts.map +1 -1
  71. package/lib/chain/blocks/verifyBlocksExecutionPayloads.js +5 -2
  72. package/lib/chain/blocks/verifyBlocksExecutionPayloads.js.map +1 -1
  73. package/lib/chain/blocks/verifyBlocksSanityChecks.d.ts +2 -1
  74. package/lib/chain/blocks/verifyBlocksSanityChecks.d.ts.map +1 -1
  75. package/lib/chain/blocks/verifyBlocksSanityChecks.js +25 -5
  76. package/lib/chain/blocks/verifyBlocksSanityChecks.js.map +1 -1
  77. package/lib/chain/blocks/verifyExecutionPayloadEnvelope.d.ts +24 -0
  78. package/lib/chain/blocks/verifyExecutionPayloadEnvelope.d.ts.map +1 -0
  79. package/lib/chain/blocks/verifyExecutionPayloadEnvelope.js +80 -0
  80. package/lib/chain/blocks/verifyExecutionPayloadEnvelope.js.map +1 -0
  81. package/lib/chain/blocks/verifyPayloadsDataAvailability.d.ts +14 -0
  82. package/lib/chain/blocks/verifyPayloadsDataAvailability.d.ts.map +1 -0
  83. package/lib/chain/blocks/verifyPayloadsDataAvailability.js +30 -0
  84. package/lib/chain/blocks/verifyPayloadsDataAvailability.js.map +1 -0
  85. package/lib/chain/blocks/writePayloadEnvelopeInputToDb.d.ts +1 -1
  86. package/lib/chain/blocks/writePayloadEnvelopeInputToDb.d.ts.map +1 -1
  87. package/lib/chain/blocks/writePayloadEnvelopeInputToDb.js +2 -11
  88. package/lib/chain/blocks/writePayloadEnvelopeInputToDb.js.map +1 -1
  89. package/lib/chain/chain.d.ts +8 -6
  90. package/lib/chain/chain.d.ts.map +1 -1
  91. package/lib/chain/chain.js +59 -49
  92. package/lib/chain/chain.js.map +1 -1
  93. package/lib/chain/emitter.d.ts +16 -15
  94. package/lib/chain/emitter.d.ts.map +1 -1
  95. package/lib/chain/emitter.js +5 -4
  96. package/lib/chain/emitter.js.map +1 -1
  97. package/lib/chain/errors/attestationError.d.ts +8 -1
  98. package/lib/chain/errors/attestationError.d.ts.map +1 -1
  99. package/lib/chain/errors/attestationError.js +4 -0
  100. package/lib/chain/errors/attestationError.js.map +1 -1
  101. package/lib/chain/errors/blockError.d.ts +8 -1
  102. package/lib/chain/errors/blockError.d.ts.map +1 -1
  103. package/lib/chain/errors/blockError.js +2 -0
  104. package/lib/chain/errors/blockError.js.map +1 -1
  105. package/lib/chain/errors/executionPayloadBid.d.ts +5 -0
  106. package/lib/chain/errors/executionPayloadBid.d.ts.map +1 -1
  107. package/lib/chain/errors/executionPayloadBid.js +1 -0
  108. package/lib/chain/errors/executionPayloadBid.js.map +1 -1
  109. package/lib/chain/errors/executionPayloadEnvelope.d.ts +5 -0
  110. package/lib/chain/errors/executionPayloadEnvelope.d.ts.map +1 -1
  111. package/lib/chain/errors/executionPayloadEnvelope.js +1 -0
  112. package/lib/chain/errors/executionPayloadEnvelope.js.map +1 -1
  113. package/lib/chain/errors/index.d.ts +1 -0
  114. package/lib/chain/errors/index.d.ts.map +1 -1
  115. package/lib/chain/errors/index.js +1 -0
  116. package/lib/chain/errors/index.js.map +1 -1
  117. package/lib/chain/errors/proposerPreferences.d.ts +40 -0
  118. package/lib/chain/errors/proposerPreferences.d.ts.map +1 -0
  119. package/lib/chain/errors/proposerPreferences.js +14 -0
  120. package/lib/chain/errors/proposerPreferences.js.map +1 -0
  121. package/lib/chain/forkChoice/index.d.ts.map +1 -1
  122. package/lib/chain/forkChoice/index.js +11 -15
  123. package/lib/chain/forkChoice/index.js.map +1 -1
  124. package/lib/chain/initState.d.ts.map +1 -1
  125. package/lib/chain/initState.js +6 -1
  126. package/lib/chain/initState.js.map +1 -1
  127. package/lib/chain/interface.d.ts +7 -5
  128. package/lib/chain/interface.d.ts.map +1 -1
  129. package/lib/chain/interface.js.map +1 -1
  130. package/lib/chain/opPools/payloadAttestationPool.d.ts +3 -2
  131. package/lib/chain/opPools/payloadAttestationPool.d.ts.map +1 -1
  132. package/lib/chain/opPools/payloadAttestationPool.js +26 -4
  133. package/lib/chain/opPools/payloadAttestationPool.js.map +1 -1
  134. package/lib/chain/prepareNextSlot.d.ts.map +1 -1
  135. package/lib/chain/prepareNextSlot.js +47 -23
  136. package/lib/chain/prepareNextSlot.js.map +1 -1
  137. package/lib/chain/produceBlock/computeNewStateRoot.d.ts +3 -9
  138. package/lib/chain/produceBlock/computeNewStateRoot.d.ts.map +1 -1
  139. package/lib/chain/produceBlock/computeNewStateRoot.js +5 -32
  140. package/lib/chain/produceBlock/computeNewStateRoot.js.map +1 -1
  141. package/lib/chain/produceBlock/produceBlockBody.d.ts +13 -8
  142. package/lib/chain/produceBlock/produceBlockBody.d.ts.map +1 -1
  143. package/lib/chain/produceBlock/produceBlockBody.js +68 -25
  144. package/lib/chain/produceBlock/produceBlockBody.js.map +1 -1
  145. package/lib/chain/regen/errors.d.ts +1 -11
  146. package/lib/chain/regen/errors.d.ts.map +1 -1
  147. package/lib/chain/regen/errors.js +0 -2
  148. package/lib/chain/regen/errors.js.map +1 -1
  149. package/lib/chain/regen/interface.d.ts +7 -12
  150. package/lib/chain/regen/interface.d.ts.map +1 -1
  151. package/lib/chain/regen/interface.js +1 -0
  152. package/lib/chain/regen/interface.js.map +1 -1
  153. package/lib/chain/regen/queued.d.ts +6 -11
  154. package/lib/chain/regen/queued.d.ts.map +1 -1
  155. package/lib/chain/regen/queued.js +9 -44
  156. package/lib/chain/regen/queued.js.map +1 -1
  157. package/lib/chain/regen/regen.d.ts +0 -5
  158. package/lib/chain/regen/regen.d.ts.map +1 -1
  159. package/lib/chain/regen/regen.js +8 -38
  160. package/lib/chain/regen/regen.js.map +1 -1
  161. package/lib/chain/seenCache/index.d.ts +1 -0
  162. package/lib/chain/seenCache/index.d.ts.map +1 -1
  163. package/lib/chain/seenCache/index.js +1 -0
  164. package/lib/chain/seenCache/index.js.map +1 -1
  165. package/lib/chain/seenCache/seenPayloadEnvelopeInput.d.ts +24 -7
  166. package/lib/chain/seenCache/seenPayloadEnvelopeInput.d.ts.map +1 -1
  167. package/lib/chain/seenCache/seenPayloadEnvelopeInput.js +69 -17
  168. package/lib/chain/seenCache/seenPayloadEnvelopeInput.js.map +1 -1
  169. package/lib/chain/seenCache/seenProposerPreferences.d.ts +16 -0
  170. package/lib/chain/seenCache/seenProposerPreferences.d.ts.map +1 -0
  171. package/lib/chain/seenCache/seenProposerPreferences.js +26 -0
  172. package/lib/chain/seenCache/seenProposerPreferences.js.map +1 -0
  173. package/lib/chain/stateCache/datastore/db.d.ts +5 -4
  174. package/lib/chain/stateCache/datastore/db.d.ts.map +1 -1
  175. package/lib/chain/stateCache/datastore/db.js +10 -32
  176. package/lib/chain/stateCache/datastore/db.js.map +1 -1
  177. package/lib/chain/stateCache/datastore/file.d.ts +1 -1
  178. package/lib/chain/stateCache/datastore/file.d.ts.map +1 -1
  179. package/lib/chain/stateCache/datastore/file.js +5 -5
  180. package/lib/chain/stateCache/datastore/file.js.map +1 -1
  181. package/lib/chain/stateCache/datastore/types.d.ts +1 -1
  182. package/lib/chain/stateCache/datastore/types.d.ts.map +1 -1
  183. package/lib/chain/stateCache/fifoBlockStateCache.d.ts +1 -7
  184. package/lib/chain/stateCache/fifoBlockStateCache.d.ts.map +1 -1
  185. package/lib/chain/stateCache/fifoBlockStateCache.js +0 -8
  186. package/lib/chain/stateCache/fifoBlockStateCache.js.map +1 -1
  187. package/lib/chain/stateCache/persistentCheckpointsCache.d.ts +13 -30
  188. package/lib/chain/stateCache/persistentCheckpointsCache.d.ts.map +1 -1
  189. package/lib/chain/stateCache/persistentCheckpointsCache.js +120 -216
  190. package/lib/chain/stateCache/persistentCheckpointsCache.js.map +1 -1
  191. package/lib/chain/stateCache/types.d.ts +8 -15
  192. package/lib/chain/stateCache/types.d.ts.map +1 -1
  193. package/lib/chain/stateCache/types.js.map +1 -1
  194. package/lib/chain/validation/aggregateAndProof.js +12 -0
  195. package/lib/chain/validation/aggregateAndProof.js.map +1 -1
  196. package/lib/chain/validation/attestation.d.ts.map +1 -1
  197. package/lib/chain/validation/attestation.js +12 -0
  198. package/lib/chain/validation/attestation.js.map +1 -1
  199. package/lib/chain/validation/block.d.ts.map +1 -1
  200. package/lib/chain/validation/block.js +1 -0
  201. package/lib/chain/validation/block.js.map +1 -1
  202. package/lib/chain/validation/executionPayloadBid.d.ts.map +1 -1
  203. package/lib/chain/validation/executionPayloadBid.js +24 -9
  204. package/lib/chain/validation/executionPayloadBid.js.map +1 -1
  205. package/lib/chain/validation/executionPayloadEnvelope.d.ts.map +1 -1
  206. package/lib/chain/validation/executionPayloadEnvelope.js +21 -11
  207. package/lib/chain/validation/executionPayloadEnvelope.js.map +1 -1
  208. package/lib/chain/validation/payloadAttestationMessage.d.ts.map +1 -1
  209. package/lib/chain/validation/payloadAttestationMessage.js +4 -3
  210. package/lib/chain/validation/payloadAttestationMessage.js.map +1 -1
  211. package/lib/chain/validation/proposerPreferences.d.ts +8 -0
  212. package/lib/chain/validation/proposerPreferences.d.ts.map +1 -0
  213. package/lib/chain/validation/proposerPreferences.js +91 -0
  214. package/lib/chain/validation/proposerPreferences.js.map +1 -0
  215. package/lib/db/repositories/executionPayloadEnvelopeArchive.js +1 -1
  216. package/lib/db/repositories/executionPayloadEnvelopeArchive.js.map +1 -1
  217. package/lib/execution/engine/http.d.ts.map +1 -1
  218. package/lib/execution/engine/http.js +21 -14
  219. package/lib/execution/engine/http.js.map +1 -1
  220. package/lib/execution/engine/interface.d.ts +1 -0
  221. package/lib/execution/engine/interface.d.ts.map +1 -1
  222. package/lib/execution/engine/mock.d.ts.map +1 -1
  223. package/lib/execution/engine/mock.js +6 -0
  224. package/lib/execution/engine/mock.js.map +1 -1
  225. package/lib/execution/engine/types.d.ts +20 -0
  226. package/lib/execution/engine/types.d.ts.map +1 -1
  227. package/lib/execution/engine/types.js +18 -0
  228. package/lib/execution/engine/types.js.map +1 -1
  229. package/lib/metrics/metrics/lodestar.d.ts +5 -0
  230. package/lib/metrics/metrics/lodestar.d.ts.map +1 -1
  231. package/lib/metrics/metrics/lodestar.js +9 -0
  232. package/lib/metrics/metrics/lodestar.js.map +1 -1
  233. package/lib/network/gossip/interface.d.ts +7 -1
  234. package/lib/network/gossip/interface.d.ts.map +1 -1
  235. package/lib/network/gossip/interface.js +1 -0
  236. package/lib/network/gossip/interface.js.map +1 -1
  237. package/lib/network/gossip/scoringParameters.d.ts.map +1 -1
  238. package/lib/network/gossip/scoringParameters.js +12 -1
  239. package/lib/network/gossip/scoringParameters.js.map +1 -1
  240. package/lib/network/gossip/topic.d.ts +33 -2
  241. package/lib/network/gossip/topic.d.ts.map +1 -1
  242. package/lib/network/gossip/topic.js +6 -0
  243. package/lib/network/gossip/topic.js.map +1 -1
  244. package/lib/network/interface.d.ts +2 -0
  245. package/lib/network/interface.d.ts.map +1 -1
  246. package/lib/network/network.d.ts +2 -0
  247. package/lib/network/network.d.ts.map +1 -1
  248. package/lib/network/network.js +9 -1
  249. package/lib/network/network.js.map +1 -1
  250. package/lib/network/processor/gossipHandlers.d.ts.map +1 -1
  251. package/lib/network/processor/gossipHandlers.js +91 -23
  252. package/lib/network/processor/gossipHandlers.js.map +1 -1
  253. package/lib/network/processor/gossipQueues/index.d.ts.map +1 -1
  254. package/lib/network/processor/gossipQueues/index.js +5 -0
  255. package/lib/network/processor/gossipQueues/index.js.map +1 -1
  256. package/lib/network/processor/index.d.ts.map +1 -1
  257. package/lib/network/processor/index.js +6 -5
  258. package/lib/network/processor/index.js.map +1 -1
  259. package/lib/network/reqresp/ReqRespBeaconNode.d.ts.map +1 -1
  260. package/lib/network/reqresp/ReqRespBeaconNode.js +1 -1
  261. package/lib/network/reqresp/ReqRespBeaconNode.js.map +1 -1
  262. package/lib/network/reqresp/handlers/beaconBlocksByHead.d.ts +9 -0
  263. package/lib/network/reqresp/handlers/beaconBlocksByHead.d.ts.map +1 -0
  264. package/lib/network/reqresp/handlers/beaconBlocksByHead.js +61 -0
  265. package/lib/network/reqresp/handlers/beaconBlocksByHead.js.map +1 -0
  266. package/lib/network/reqresp/handlers/beaconBlocksByRange.d.ts.map +1 -1
  267. package/lib/network/reqresp/handlers/beaconBlocksByRange.js +14 -6
  268. package/lib/network/reqresp/handlers/beaconBlocksByRange.js.map +1 -1
  269. package/lib/network/reqresp/handlers/blobSidecarsByRange.d.ts.map +1 -1
  270. package/lib/network/reqresp/handlers/blobSidecarsByRange.js +11 -5
  271. package/lib/network/reqresp/handlers/blobSidecarsByRange.js.map +1 -1
  272. package/lib/network/reqresp/handlers/dataColumnSidecarsByRange.d.ts.map +1 -1
  273. package/lib/network/reqresp/handlers/dataColumnSidecarsByRange.js +17 -5
  274. package/lib/network/reqresp/handlers/dataColumnSidecarsByRange.js.map +1 -1
  275. package/lib/network/reqresp/handlers/executionPayloadEnvelopesByRange.d.ts.map +1 -1
  276. package/lib/network/reqresp/handlers/executionPayloadEnvelopesByRange.js +7 -4
  277. package/lib/network/reqresp/handlers/executionPayloadEnvelopesByRange.js.map +1 -1
  278. package/lib/network/reqresp/handlers/index.d.ts.map +1 -1
  279. package/lib/network/reqresp/handlers/index.js +5 -0
  280. package/lib/network/reqresp/handlers/index.js.map +1 -1
  281. package/lib/network/reqresp/interface.d.ts +1 -1
  282. package/lib/network/reqresp/interface.js +1 -1
  283. package/lib/network/reqresp/protocols.d.ts +1 -0
  284. package/lib/network/reqresp/protocols.d.ts.map +1 -1
  285. package/lib/network/reqresp/protocols.js +5 -0
  286. package/lib/network/reqresp/protocols.js.map +1 -1
  287. package/lib/network/reqresp/rateLimit.d.ts.map +1 -1
  288. package/lib/network/reqresp/rateLimit.js +4 -0
  289. package/lib/network/reqresp/rateLimit.js.map +1 -1
  290. package/lib/network/reqresp/score.d.ts.map +1 -1
  291. package/lib/network/reqresp/score.js +1 -0
  292. package/lib/network/reqresp/score.js.map +1 -1
  293. package/lib/network/reqresp/types.d.ts +3 -0
  294. package/lib/network/reqresp/types.d.ts.map +1 -1
  295. package/lib/network/reqresp/types.js +3 -0
  296. package/lib/network/reqresp/types.js.map +1 -1
  297. package/lib/node/nodejs.d.ts.map +1 -1
  298. package/lib/node/nodejs.js +6 -4
  299. package/lib/node/nodejs.js.map +1 -1
  300. package/lib/sync/constants.d.ts +7 -1
  301. package/lib/sync/constants.d.ts.map +1 -1
  302. package/lib/sync/constants.js +7 -4
  303. package/lib/sync/constants.js.map +1 -1
  304. package/lib/sync/range/batch.d.ts +55 -8
  305. package/lib/sync/range/batch.d.ts.map +1 -1
  306. package/lib/sync/range/batch.js +291 -66
  307. package/lib/sync/range/batch.js.map +1 -1
  308. package/lib/sync/range/chain.d.ts +22 -4
  309. package/lib/sync/range/chain.d.ts.map +1 -1
  310. package/lib/sync/range/chain.js +103 -11
  311. package/lib/sync/range/chain.js.map +1 -1
  312. package/lib/sync/range/range.d.ts.map +1 -1
  313. package/lib/sync/range/range.js +71 -11
  314. package/lib/sync/range/range.js.map +1 -1
  315. package/lib/sync/range/utils/peerBalancer.d.ts +2 -1
  316. package/lib/sync/range/utils/peerBalancer.d.ts.map +1 -1
  317. package/lib/sync/range/utils/peerBalancer.js +8 -4
  318. package/lib/sync/range/utils/peerBalancer.js.map +1 -1
  319. package/lib/sync/sync.d.ts.map +1 -1
  320. package/lib/sync/sync.js +13 -0
  321. package/lib/sync/sync.js.map +1 -1
  322. package/lib/sync/types.d.ts +34 -0
  323. package/lib/sync/types.d.ts.map +1 -1
  324. package/lib/sync/types.js +34 -0
  325. package/lib/sync/types.js.map +1 -1
  326. package/lib/sync/unknownBlock.d.ts +29 -1
  327. package/lib/sync/unknownBlock.d.ts.map +1 -1
  328. package/lib/sync/unknownBlock.js +727 -61
  329. package/lib/sync/unknownBlock.js.map +1 -1
  330. package/lib/sync/utils/downloadByRange.d.ts +73 -10
  331. package/lib/sync/utils/downloadByRange.d.ts.map +1 -1
  332. package/lib/sync/utils/downloadByRange.js +213 -26
  333. package/lib/sync/utils/downloadByRange.js.map +1 -1
  334. package/lib/sync/utils/downloadByRoot.d.ts.map +1 -1
  335. package/lib/sync/utils/downloadByRoot.js +16 -2
  336. package/lib/sync/utils/downloadByRoot.js.map +1 -1
  337. package/lib/sync/utils/pendingBlocksTree.d.ts +0 -1
  338. package/lib/sync/utils/pendingBlocksTree.d.ts.map +1 -1
  339. package/lib/sync/utils/pendingBlocksTree.js +0 -9
  340. package/lib/sync/utils/pendingBlocksTree.js.map +1 -1
  341. package/lib/sync/utils/rateLimit.d.ts +2 -0
  342. package/lib/sync/utils/rateLimit.d.ts.map +1 -0
  343. package/lib/sync/utils/rateLimit.js +15 -0
  344. package/lib/sync/utils/rateLimit.js.map +1 -0
  345. package/lib/util/sszBytes.d.ts.map +1 -1
  346. package/lib/util/sszBytes.js +20 -5
  347. package/lib/util/sszBytes.js.map +1 -1
  348. package/package.json +18 -17
  349. package/src/api/impl/beacon/blocks/index.ts +22 -9
  350. package/src/api/impl/beacon/pool/index.ts +83 -1
  351. package/src/api/impl/beacon/state/utils.ts +2 -2
  352. package/src/api/impl/debug/index.ts +0 -1
  353. package/src/api/impl/lodestar/index.ts +1 -1
  354. package/src/api/impl/validator/index.ts +84 -6
  355. package/src/chain/GetBlobsTracker.ts +1 -2
  356. package/src/chain/archiveStore/archiveStore.ts +5 -5
  357. package/src/chain/archiveStore/interface.ts +4 -4
  358. package/src/chain/archiveStore/strategies/frequencyStateArchiveStrategy.ts +6 -8
  359. package/src/chain/archiveStore/utils/archiveBlocks.ts +153 -94
  360. package/src/chain/blocks/blockInput/blockInput.ts +4 -1
  361. package/src/chain/blocks/importBlock.ts +38 -83
  362. package/src/chain/blocks/importExecutionPayload.ts +127 -107
  363. package/src/chain/blocks/index.ts +72 -24
  364. package/src/chain/blocks/payloadEnvelopeInput/payloadEnvelopeInput.ts +64 -3
  365. package/src/chain/blocks/payloadEnvelopeInput/types.ts +18 -0
  366. package/src/chain/blocks/payloadEnvelopeProcessor.ts +7 -6
  367. package/src/chain/blocks/types.ts +16 -26
  368. package/src/chain/blocks/utils/chainSegment.ts +117 -17
  369. package/src/chain/blocks/verifyBlock.ts +70 -9
  370. package/src/chain/blocks/verifyBlocksExecutionPayloads.ts +6 -4
  371. package/src/chain/blocks/verifyBlocksSanityChecks.ts +26 -7
  372. package/src/chain/blocks/verifyExecutionPayloadEnvelope.ts +137 -0
  373. package/src/chain/blocks/verifyPayloadsDataAvailability.ts +41 -0
  374. package/src/chain/blocks/writePayloadEnvelopeInputToDb.ts +9 -18
  375. package/src/chain/chain.ts +79 -71
  376. package/src/chain/emitter.ts +15 -14
  377. package/src/chain/errors/attestationError.ts +6 -1
  378. package/src/chain/errors/blockError.ts +4 -1
  379. package/src/chain/errors/executionPayloadBid.ts +6 -0
  380. package/src/chain/errors/executionPayloadEnvelope.ts +6 -0
  381. package/src/chain/errors/index.ts +1 -0
  382. package/src/chain/errors/proposerPreferences.ts +47 -0
  383. package/src/chain/forkChoice/index.ts +8 -20
  384. package/src/chain/initState.ts +9 -1
  385. package/src/chain/interface.ts +11 -3
  386. package/src/chain/opPools/payloadAttestationPool.ts +29 -8
  387. package/src/chain/prepareNextSlot.ts +55 -24
  388. package/src/chain/produceBlock/computeNewStateRoot.ts +6 -43
  389. package/src/chain/produceBlock/produceBlockBody.ts +91 -27
  390. package/src/chain/regen/errors.ts +1 -6
  391. package/src/chain/regen/interface.ts +7 -12
  392. package/src/chain/regen/queued.ts +14 -55
  393. package/src/chain/regen/regen.ts +10 -43
  394. package/src/chain/seenCache/index.ts +1 -0
  395. package/src/chain/seenCache/seenPayloadEnvelopeInput.ts +89 -21
  396. package/src/chain/seenCache/seenProposerPreferences.ts +32 -0
  397. package/src/chain/stateCache/datastore/db.ts +10 -33
  398. package/src/chain/stateCache/datastore/file.ts +5 -6
  399. package/src/chain/stateCache/datastore/types.ts +2 -3
  400. package/src/chain/stateCache/fifoBlockStateCache.ts +1 -10
  401. package/src/chain/stateCache/persistentCheckpointsCache.ts +139 -247
  402. package/src/chain/stateCache/types.ts +8 -14
  403. package/src/chain/validation/aggregateAndProof.ts +13 -0
  404. package/src/chain/validation/attestation.ts +13 -0
  405. package/src/chain/validation/block.ts +1 -0
  406. package/src/chain/validation/executionPayloadBid.ts +25 -8
  407. package/src/chain/validation/executionPayloadEnvelope.ts +22 -12
  408. package/src/chain/validation/payloadAttestationMessage.ts +5 -3
  409. package/src/chain/validation/proposerPreferences.ts +110 -0
  410. package/src/db/repositories/executionPayloadEnvelopeArchive.ts +1 -1
  411. package/src/execution/engine/http.ts +21 -14
  412. package/src/execution/engine/interface.ts +1 -0
  413. package/src/execution/engine/mock.ts +8 -1
  414. package/src/execution/engine/types.ts +41 -0
  415. package/src/metrics/metrics/lodestar.ts +10 -0
  416. package/src/network/gossip/interface.ts +6 -0
  417. package/src/network/gossip/scoringParameters.ts +14 -1
  418. package/src/network/gossip/topic.ts +6 -0
  419. package/src/network/interface.ts +2 -0
  420. package/src/network/network.ts +24 -1
  421. package/src/network/processor/gossipHandlers.ts +114 -28
  422. package/src/network/processor/gossipQueues/index.ts +5 -0
  423. package/src/network/processor/index.ts +6 -5
  424. package/src/network/reqresp/ReqRespBeaconNode.ts +1 -0
  425. package/src/network/reqresp/handlers/beaconBlocksByHead.ts +91 -0
  426. package/src/network/reqresp/handlers/beaconBlocksByRange.ts +14 -6
  427. package/src/network/reqresp/handlers/blobSidecarsByRange.ts +11 -5
  428. package/src/network/reqresp/handlers/dataColumnSidecarsByRange.ts +17 -5
  429. package/src/network/reqresp/handlers/executionPayloadEnvelopesByRange.ts +7 -4
  430. package/src/network/reqresp/handlers/index.ts +5 -0
  431. package/src/network/reqresp/interface.ts +1 -1
  432. package/src/network/reqresp/protocols.ts +6 -0
  433. package/src/network/reqresp/rateLimit.ts +4 -0
  434. package/src/network/reqresp/score.ts +1 -0
  435. package/src/network/reqresp/types.ts +5 -0
  436. package/src/node/nodejs.ts +6 -4
  437. package/src/sync/constants.ts +8 -4
  438. package/src/sync/range/batch.ts +388 -75
  439. package/src/sync/range/chain.ts +131 -14
  440. package/src/sync/range/range.ts +86 -11
  441. package/src/sync/range/utils/peerBalancer.ts +9 -3
  442. package/src/sync/sync.ts +13 -1
  443. package/src/sync/types.ts +72 -0
  444. package/src/sync/unknownBlock.ts +915 -65
  445. package/src/sync/utils/downloadByRange.ts +386 -39
  446. package/src/sync/utils/downloadByRoot.ts +24 -2
  447. package/src/sync/utils/pendingBlocksTree.ts +0 -15
  448. package/src/sync/utils/rateLimit.ts +16 -0
  449. package/src/util/sszBytes.ts +25 -5
@@ -8,16 +8,8 @@ import {
8
8
  ForkChoiceErrorCode,
9
9
  NotReorgedReason,
10
10
  getSafeExecutionBlockHash,
11
- isGloasBlock,
12
11
  } from "@lodestar/fork-choice";
13
- import {
14
- ForkPostAltair,
15
- ForkPostElectra,
16
- ForkPostGloas,
17
- ForkSeq,
18
- MAX_SEED_LOOKAHEAD,
19
- SLOTS_PER_EPOCH,
20
- } from "@lodestar/params";
12
+ import {ForkPostAltair, ForkPostElectra, ForkSeq, MAX_SEED_LOOKAHEAD, SLOTS_PER_EPOCH} from "@lodestar/params";
21
13
  import {
22
14
  IBeaconStateView,
23
15
  RootCache,
@@ -28,17 +20,7 @@ import {
28
20
  isStatePostAltair,
29
21
  isStatePostBellatrix,
30
22
  } from "@lodestar/state-transition";
31
- import {
32
- Attestation,
33
- BeaconBlock,
34
- SignedBeaconBlock,
35
- altair,
36
- capella,
37
- electra,
38
- isGloasBeaconBlock,
39
- phase0,
40
- ssz,
41
- } from "@lodestar/types";
23
+ import {Attestation, BeaconBlock, altair, capella, electra, isGloasBeaconBlock, phase0, ssz} from "@lodestar/types";
42
24
  import {isErrorAborted, toRootHex} from "@lodestar/utils";
43
25
  import {ZERO_HASH_HEX} from "../../constants/index.js";
44
26
  import {callInNextEventLoop} from "../../util/eventLoop.js";
@@ -48,7 +30,7 @@ import type {BeaconChain} from "../chain.js";
48
30
  import {ChainEvent, ReorgEventData} from "../emitter.js";
49
31
  import {ForkchoiceCaller} from "../forkChoice/index.js";
50
32
  import {REPROCESS_MIN_TIME_TO_NEXT_SLOT_SEC} from "../reprocess.js";
51
- import {toCheckpointHexPayload} from "../stateCache/persistentCheckpointsCache.js";
33
+ import {toCheckpointHex} from "../stateCache/persistentCheckpointsCache.js";
52
34
  import {isBlockInputBlobs, isBlockInputColumns} from "./blockInput/blockInput.js";
53
35
  import {AttestationImportOpt, FullyVerifiedBlock, ImportBlockOpts} from "./types.js";
54
36
  import {getCheckpointFromState} from "./utils/checkpoint.js";
@@ -87,8 +69,8 @@ export async function importBlock(
87
69
  fullyVerifiedBlock: FullyVerifiedBlock,
88
70
  opts: ImportBlockOpts
89
71
  ): Promise<void> {
90
- const {blockInput, postBlockState, parentBlockSlot, executionStatus, dataAvailabilityStatus, indexedAttestations} =
91
- fullyVerifiedBlock;
72
+ const {blockInput, postState, parentBlockSlot, dataAvailabilityStatus, indexedAttestations} = fullyVerifiedBlock;
73
+ let {executionStatus} = fullyVerifiedBlock;
92
74
  const block = blockInput.getBlock();
93
75
  const source = blockInput.getBlockSource();
94
76
  const {slot: blockSlot} = block.message;
@@ -99,7 +81,7 @@ export async function importBlock(
99
81
  const blockEpoch = computeEpochAtSlot(blockSlot);
100
82
  const prevFinalizedEpoch = this.forkChoice.getFinalizedCheckpoint().epoch;
101
83
  const blockDelaySec =
102
- fullyVerifiedBlock.seenTimestampSec - computeTimeAtSlot(this.config, blockSlot, postBlockState.genesisTime);
84
+ fullyVerifiedBlock.seenTimestampSec - computeTimeAtSlot(this.config, blockSlot, postState.genesisTime);
103
85
  const recvToValLatency = Date.now() / 1000 - (opts.seenTimestampSec ?? Date.now() / 1000);
104
86
  const fork = this.config.getForkSeq(blockSlot);
105
87
 
@@ -122,57 +104,30 @@ export async function importBlock(
122
104
  // 2. Import block to fork choice
123
105
 
124
106
  // Should compute checkpoint balances before forkchoice.onBlock
125
- this.checkpointBalancesCache.processState(blockRootHex, postBlockState);
107
+ this.checkpointBalancesCache.processState(blockRootHex, postState);
108
+ if (fork >= ForkSeq.gloas) {
109
+ const parentRootHex = toRootHex(block.message.parentRoot);
110
+ const parentBlock = this.forkChoice.getBlockHexDefaultStatus(parentRootHex);
111
+ if (parentBlock === null) {
112
+ throw Error(`Parent block not found in forkChoice, parentRoot=${parentRootHex}`);
113
+ }
114
+ if (parentBlock.executionStatus === ExecutionStatus.Invalid) {
115
+ throw Error(`Parent block has invalid execution status, parentRoot=${parentRootHex}`);
116
+ }
117
+ executionStatus = parentBlock.executionStatus;
118
+ }
126
119
  const blockSummary = this.forkChoice.onBlock(
127
120
  block.message,
128
- postBlockState,
121
+ postState,
129
122
  blockDelaySec,
130
123
  currentSlot,
131
- fork >= ForkSeq.gloas ? ExecutionStatus.PayloadSeparated : executionStatus,
124
+ executionStatus,
132
125
  dataAvailabilityStatus
133
126
  );
134
127
 
135
128
  // This adds the state necessary to process the next block
136
129
  // Some block event handlers require state being in state cache so need to do this before emitting EventType.block
137
- // Pre-Gloas: blockSummary.payloadStatus is always FULL, payloadPresent = true
138
- // Post-Gloas: blockSummary.payloadStatus is always PENDING, so payloadPresent = false (block state only, no payload processing yet)
139
- const payloadPresent = !isGloasBlock(blockSummary);
140
- // processState manages both block state and payload state variants together for memory/disk management
141
- this.regen.processBlockState(blockRootHex, postBlockState);
142
-
143
- // For Gloas blocks, create PayloadEnvelopeInput so it's available for later payload import
144
- if (fork >= ForkSeq.gloas) {
145
- const payloadInput = this.seenPayloadEnvelopeInputCache.add({
146
- blockRootHex,
147
- block: block as SignedBeaconBlock<ForkPostGloas>,
148
- forkName: blockInput.forkName,
149
- sampledColumns: this.custodyConfig.sampledColumns,
150
- custodyColumns: this.custodyConfig.custodyColumns,
151
- timeCreatedSec: fullyVerifiedBlock.seenTimestampSec,
152
- });
153
- this.logger.debug("Created PayloadEnvelopeInput for block", {
154
- slot: blockSlot,
155
- root: blockRootHex,
156
- source: source.source,
157
- ...(opts.seenTimestampSec !== undefined ? {recvToImport: Date.now() / 1000 - opts.seenTimestampSec} : {}),
158
- });
159
-
160
- // Immediately attempt fetch of data columns from execution engine as the bid contains kzg commitments
161
- // which is all the information we need so there is no reason to delay until execution payload arrives
162
- // TODO GLOAS: If we want EL retries after this initial attempt, add an explicit retry policy here
163
- // (for example later in the slot). Do not couple retries to incoming gossip columns.
164
- this.getBlobsTracker.triggerGetBlobs(payloadInput, () => {
165
- // TODO GLOAS: come up with a better mechanism to trigger processExecutionPayload after data becomes available,
166
- // similar to how pre-gloas uses waitForBlockAndAllData with a cutoff timeout and incompleteBlockInput event
167
- this.processExecutionPayload(payloadInput, {validSignature: true}).catch((e) => {
168
- this.logger.debug(
169
- "Error processing execution payload after getBlobs",
170
- {slot: blockSlot, root: blockRootHex},
171
- e as Error
172
- );
173
- });
174
- });
175
- }
130
+ this.regen.processState(blockRootHex, postState);
176
131
 
177
132
  this.metrics?.importBlock.bySource.inc({source: source.source});
178
133
  this.logger.verbose("Added block to forkchoice and state cache", {slot: blockSlot, root: blockRootHex});
@@ -191,7 +146,7 @@ export async function importBlock(
191
146
  (opts.importAttestations !== AttestationImportOpt.Skip && blockEpoch >= currentEpoch - FORK_CHOICE_ATT_EPOCH_LIMIT)
192
147
  ) {
193
148
  const attestations = block.message.body.attestations;
194
- const rootCache = new RootCache(postBlockState);
149
+ const rootCache = new RootCache(postState);
195
150
  const invalidAttestationErrorsByCode = new Map<string, {error: Error; count: number}>();
196
151
 
197
152
  const addAttestation = fork >= ForkSeq.electra ? addAttestationPostElectra : addAttestationPreElectra;
@@ -205,7 +160,7 @@ export async function importBlock(
205
160
  const attDataRoot = toRootHex(ssz.phase0.AttestationData.hashTreeRoot(indexedAttestation.data));
206
161
  addAttestation.call(
207
162
  this,
208
- postBlockState,
163
+ postState,
209
164
  target,
210
165
  attDataRoot,
211
166
  attestation as Attestation<ForkPostElectra>,
@@ -320,7 +275,7 @@ export async function importBlock(
320
275
 
321
276
  if (newHead.blockRoot !== oldHead.blockRoot) {
322
277
  // Set head state as strong reference
323
- this.regen.updateHeadState(newHead, postBlockState);
278
+ this.regen.updateHeadState(newHead, postState);
324
279
 
325
280
  try {
326
281
  this.emitter.emit(routes.events.EventType.head, {
@@ -390,10 +345,10 @@ export async function importBlock(
390
345
  // we want to import block asap so do this in the next event loop
391
346
  callInNextEventLoop(() => {
392
347
  try {
393
- if (isStatePostAltair(postBlockState)) {
348
+ if (isStatePostAltair(postState)) {
394
349
  this.lightClientServer?.onImportBlockHead(
395
350
  block.message as BeaconBlock<ForkPostAltair>,
396
- postBlockState,
351
+ postState,
397
352
  parentBlockSlot
398
353
  );
399
354
  }
@@ -415,11 +370,11 @@ export async function importBlock(
415
370
  // and the block is weak and can potentially be reorged out.
416
371
  let shouldOverrideFcu = false;
417
372
 
418
- if (blockSlot >= currentSlot && isStatePostBellatrix(postBlockState) && postBlockState.isExecutionStateType) {
373
+ if (blockSlot >= currentSlot && isStatePostBellatrix(postState) && postState.isExecutionStateType) {
419
374
  let notOverrideFcuReason = NotReorgedReason.Unknown;
420
375
  const proposalSlot = blockSlot + 1;
421
376
  try {
422
- const proposerIndex = postBlockState.getBeaconProposer(proposalSlot);
377
+ const proposerIndex = postState.getBeaconProposer(proposalSlot);
423
378
  const feeRecipient = this.beaconProposerCache.get(proposerIndex);
424
379
 
425
380
  if (feeRecipient) {
@@ -499,27 +454,27 @@ export async function importBlock(
499
454
  }
500
455
  }
501
456
 
502
- if (!postBlockState.isStateValidatorsNodesPopulated()) {
503
- this.logger.verbose("After importBlock caching postState without SSZ cache", {slot: postBlockState.slot});
457
+ if (!postState.isStateValidatorsNodesPopulated()) {
458
+ this.logger.verbose("After importBlock caching postState without SSZ cache", {slot: postState.slot});
504
459
  }
505
460
 
506
461
  // Cache shufflings when crossing an epoch boundary
507
462
  const parentEpoch = computeEpochAtSlot(parentBlockSlot);
508
463
  if (parentEpoch < blockEpoch) {
509
- this.shufflingCache.processState(postBlockState);
464
+ this.shufflingCache.processState(postState);
510
465
  this.logger.verbose("Processed shuffling for next epoch", {parentEpoch, blockEpoch, slot: blockSlot});
511
466
  }
512
467
 
513
468
  if (blockSlot % SLOTS_PER_EPOCH === 0) {
514
469
  // Cache state to preserve epoch transition work
515
- const checkpointState = postBlockState;
470
+ const checkpointState = postState;
516
471
  const cp = getCheckpointFromState(checkpointState);
517
- this.regen.addCheckpointState(cp, checkpointState, payloadPresent);
472
+ this.regen.addCheckpointState(cp, checkpointState);
518
473
  // consumers should not mutate state ever
519
474
  this.emitter.emit(ChainEvent.checkpoint, cp, checkpointState);
520
475
 
521
476
  // Note: in-lined code from previos handler of ChainEvent.checkpoint
522
- this.logger.verbose("Checkpoint processed", toCheckpointHexPayload(cp, payloadPresent));
477
+ this.logger.verbose("Checkpoint processed", toCheckpointHex(cp));
523
478
 
524
479
  const activeValidatorsCount = checkpointState.activeValidatorCount;
525
480
  this.metrics?.currentActiveValidators.set(activeValidatorsCount);
@@ -537,7 +492,7 @@ export async function importBlock(
537
492
  const justifiedEpoch = justifiedCheckpoint.epoch;
538
493
  const preJustifiedEpoch = parentBlockSummary.justifiedEpoch;
539
494
  if (justifiedEpoch > preJustifiedEpoch) {
540
- this.logger.verbose("Checkpoint justified", toCheckpointHexPayload(justifiedCheckpoint, payloadPresent));
495
+ this.logger.verbose("Checkpoint justified", toCheckpointHex(justifiedCheckpoint));
541
496
  this.metrics?.previousJustifiedEpoch.set(checkpointState.previousJustifiedCheckpoint.epoch);
542
497
  this.metrics?.currentJustifiedEpoch.set(justifiedCheckpoint.epoch);
543
498
  }
@@ -551,7 +506,7 @@ export async function importBlock(
551
506
  state: toRootHex(checkpointState.hashTreeRoot()),
552
507
  executionOptimistic: false,
553
508
  });
554
- this.logger.verbose("Checkpoint finalized", toCheckpointHexPayload(finalizedCheckpoint, payloadPresent));
509
+ this.logger.verbose("Checkpoint finalized", toCheckpointHex(finalizedCheckpoint));
555
510
  this.metrics?.finalizedEpoch.set(finalizedCheckpoint.epoch);
556
511
  }
557
512
  }
@@ -602,11 +557,11 @@ export async function importBlock(
602
557
  this.metrics?.parentBlockDistance.observe(blockSlot - parentBlockSlot);
603
558
  this.metrics?.proposerBalanceDeltaAny.observe(fullyVerifiedBlock.proposerBalanceDelta);
604
559
  this.validatorMonitor?.registerImportedBlock(block.message, fullyVerifiedBlock);
605
- if (isStatePostAltair(fullyVerifiedBlock.postBlockState)) {
560
+ if (isStatePostAltair(fullyVerifiedBlock.postState)) {
606
561
  this.validatorMonitor?.registerSyncAggregateInBlock(
607
562
  blockEpoch,
608
563
  (block as altair.SignedBeaconBlock).message.body.syncAggregate,
609
- fullyVerifiedBlock.postBlockState.currentSyncCommitteeIndexed.validatorIndices
564
+ fullyVerifiedBlock.postState.currentSyncCommitteeIndexed.validatorIndices
610
565
  );
611
566
  }
612
567
 
@@ -1,14 +1,19 @@
1
1
  import {routes} from "@lodestar/api";
2
- import {ExecutionStatus, PayloadExecutionStatus} from "@lodestar/fork-choice";
3
- import {SLOTS_PER_EPOCH} from "@lodestar/params";
4
- import {getExecutionPayloadEnvelopeSignatureSet, isStatePostGloas} from "@lodestar/state-transition";
5
- import {byteArrayEquals, fromHex, toRootHex} from "@lodestar/utils";
2
+ import {ExecutionStatus, PayloadExecutionStatus, getSafeExecutionBlockHash} from "@lodestar/fork-choice";
3
+ import {DataAvailabilityStatus, isStatePostGloas} from "@lodestar/state-transition";
4
+ import {isErrorAborted} from "@lodestar/utils";
5
+ import {ZERO_HASH_HEX} from "../../constants/index.js";
6
6
  import {ExecutionPayloadStatus} from "../../execution/index.js";
7
7
  import {isQueueErrorAborted} from "../../util/queue/index.js";
8
8
  import {BeaconChain} from "../chain.js";
9
9
  import {RegenCaller} from "../regen/interface.js";
10
10
  import {PayloadEnvelopeInput} from "../seenCache/seenPayloadEnvelopeInput.js";
11
11
  import {ImportPayloadOpts} from "./types.js";
12
+ import {
13
+ verifyExecutionPayloadEnvelope,
14
+ verifyExecutionPayloadEnvelopeSignature,
15
+ } from "./verifyExecutionPayloadEnvelope.js";
16
+ import {verifyPayloadsDataAvailability} from "./verifyPayloadsDataAvailability.js";
12
17
 
13
18
  const EVENTSTREAM_EMIT_RECENT_EXECUTION_PAYLOAD_SLOTS = 64;
14
19
 
@@ -16,7 +21,8 @@ export enum PayloadErrorCode {
16
21
  EXECUTION_ENGINE_INVALID = "PAYLOAD_ERROR_EXECUTION_ENGINE_INVALID",
17
22
  EXECUTION_ENGINE_ERROR = "PAYLOAD_ERROR_EXECUTION_ENGINE_ERROR",
18
23
  BLOCK_NOT_IN_FORK_CHOICE = "PAYLOAD_ERROR_BLOCK_NOT_IN_FORK_CHOICE",
19
- STATE_TRANSITION_ERROR = "PAYLOAD_ERROR_STATE_TRANSITION_ERROR",
24
+ MISS_BLOCK_STATE = "PAYLOAD_ERROR_MISS_BLOCK_STATE",
25
+ ENVELOPE_VERIFICATION_ERROR = "PAYLOAD_ERROR_ENVELOPE_VERIFICATION_ERROR",
20
26
  INVALID_SIGNATURE = "PAYLOAD_ERROR_INVALID_SIGNATURE",
21
27
  }
22
28
 
@@ -36,7 +42,11 @@ export type PayloadErrorType =
36
42
  blockRootHex: string;
37
43
  }
38
44
  | {
39
- code: PayloadErrorCode.STATE_TRANSITION_ERROR;
45
+ code: PayloadErrorCode.MISS_BLOCK_STATE;
46
+ blockRootHex: string;
47
+ }
48
+ | {
49
+ code: PayloadErrorCode.ENVELOPE_VERIFICATION_ERROR;
40
50
  message: string;
41
51
  }
42
52
  | {
@@ -56,7 +66,6 @@ function toForkChoiceExecutionStatus(status: ExecutionPayloadStatus): PayloadExe
56
66
  switch (status) {
57
67
  case ExecutionPayloadStatus.VALID:
58
68
  return ExecutionStatus.Valid;
59
- // TODO GLOAS: Handle optimistic import for payload
60
69
  case ExecutionPayloadStatus.SYNCING:
61
70
  case ExecutionPayloadStatus.ACCEPTED:
62
71
  return ExecutionStatus.Syncing;
@@ -68,37 +77,43 @@ function toForkChoiceExecutionStatus(status: ExecutionPayloadStatus): PayloadExe
68
77
  /**
69
78
  * Import an execution payload envelope after all data is available.
70
79
  *
71
- * This function:
72
- * 1. Emits `execution_payload_available` if payload is for current slot
73
- * 2. Gets the ProtoBlock from fork choice
74
- * 3. Applies write-queue backpressure (waitForSpace) early, before verification
75
- * 4. Regenerates the block state
76
- * 5. Runs EL verification (notifyNewPayload) in parallel with signature verification and processExecutionPayloadEnvelope
77
- * 6. Persists verified payload envelope to hot DB
78
- * 7. Updates fork choice
79
- * 8. Caches the post-execution payload state
80
- * 9. Records metrics for column sources
81
- * 10. Emits `execution_payload` for recent enough payloads after successful import
80
+ * The envelope is only verified here, no state mutation. State effects from the payload
81
+ * are applied on the next block via processParentExecutionPayload.
82
+ *
83
+ * The DA wait must have run upstream (range sync awaits DA in `verifyBlocksInEpoch` for the
84
+ * whole segment; gossip / API path uses the `processExecutionPayload` wrapper below).
82
85
  *
86
+ * Steps:
87
+ * 1. Emit `execution_payload_available` event for payload attestation
88
+ * 2. Get the ProtoBlock from fork choice
89
+ * 3. Regenerate state for envelope verification
90
+ * 4. Verify envelope (fields against state, signature, and EL in parallel where possible)
91
+ * 5. Persist verified payload envelope to hot DB (waits for write-queue space for backpressure)
92
+ * 6. Update fork choice (transitions the block's PENDING variant to FULL)
93
+ * 7. Queue notifyForkchoiceUpdate to engine api
94
+ * 8. Record metrics for payload envelope and column sources
95
+ * 9. Emit `execution_payload` event
83
96
  */
84
97
  export async function importExecutionPayload(
85
98
  this: BeaconChain,
86
99
  payloadInput: PayloadEnvelopeInput,
100
+ dataAvailabilityStatus: DataAvailabilityStatus,
87
101
  opts: ImportPayloadOpts = {}
88
102
  ): Promise<void> {
89
103
  const signedEnvelope = payloadInput.getPayloadEnvelope();
90
104
  const envelope = signedEnvelope.message;
105
+ const slot = envelope.payload.slotNumber;
91
106
  const blockRootHex = payloadInput.blockRootHex;
92
107
  const blockHashHex = payloadInput.getBlockHashHex();
93
- const fork = this.config.getForkName(envelope.slot);
108
+ const fork = this.config.getForkName(slot);
94
109
 
95
- // 1. Emit `execution_payload_available` event at the start of import. At this point the payload input
96
- // is already complete, so the payload and required data are available for payload attestation.
97
- // This event is only about availability, not validity of the execution payload, hence we can emit
98
- // it before getting a response from the execution client on whether the payload is valid or not.
99
- if (this.clock.currentSlot - envelope.slot < EVENTSTREAM_EMIT_RECENT_EXECUTION_PAYLOAD_SLOTS) {
110
+ // 1. Emit `execution_payload_available` event at the start of import. At this point the
111
+ // payload input is already complete, so the payload and required data are available for
112
+ // payload attestation. This event only signals availability (not validity), so we can emit
113
+ // it before getting a response from the EL on whether the payload is valid or not.
114
+ if (this.clock.currentSlot - slot < EVENTSTREAM_EMIT_RECENT_EXECUTION_PAYLOAD_SLOTS) {
100
115
  this.emitter.emit(routes.events.EventType.executionPayloadAvailable, {
101
- slot: envelope.slot,
116
+ slot,
102
117
  blockRoot: blockRootHex,
103
118
  });
104
119
  }
@@ -112,78 +127,72 @@ export async function importExecutionPayload(
112
127
  });
113
128
  }
114
129
 
115
- // 3. Apply backpressure from the write queue early, before doing verification work.
116
- // The actual DB write is deferred until after verification succeeds.
117
- await this.unfinalizedPayloadEnvelopeWrites.waitForSpace();
130
+ // 3. Regenerate state for envelope verification
131
+ const blockState = await this.regen
132
+ .getBlockSlotState(protoBlock, protoBlock.slot, {dontTransferCache: true}, RegenCaller.processBlock)
133
+ .catch(() =>
134
+ // only happen at the 1st batch of skipped slot checkpoint sync
135
+ this.regen.getClosestHeadState(protoBlock)
136
+ );
118
137
 
119
- // 4. Get pre-state for processExecutionPayloadEnvelope
120
- // We need the block state (post-block, pre-payload) to process the envelope
121
- const blockState = await this.regen.getBlockSlotState(
122
- protoBlock,
123
- protoBlock.slot,
124
- {dontTransferCache: true},
125
- RegenCaller.processBlock
126
- );
138
+ if (blockState == null) {
139
+ throw new PayloadError({
140
+ code: PayloadErrorCode.MISS_BLOCK_STATE,
141
+ blockRootHex: protoBlock.blockRoot,
142
+ });
143
+ }
127
144
  if (!isStatePostGloas(blockState)) {
128
145
  throw new PayloadError({
129
- code: PayloadErrorCode.STATE_TRANSITION_ERROR,
130
- message: `Expected gloas+ block state for payload import, got fork=${blockState.forkName}`,
146
+ code: PayloadErrorCode.ENVELOPE_VERIFICATION_ERROR,
147
+ message: `Expected gloas+ state for payload import, got fork=${blockState.forkName}`,
148
+ });
149
+ }
150
+
151
+ // 4. Verify envelope fields against state first to fail fast before the EL + BLS work.
152
+ // When validSignature is true, gossip/API has already verified both the signature and the
153
+ // executionRequestsRoot, so we skip those checks here.
154
+ try {
155
+ verifyExecutionPayloadEnvelope(this.config, blockState, envelope, {
156
+ verifyExecutionRequestsRoot: !opts.validSignature,
131
157
  });
158
+ } catch (e) {
159
+ throw new PayloadError(
160
+ {
161
+ code: PayloadErrorCode.ENVELOPE_VERIFICATION_ERROR,
162
+ message: (e as Error).message,
163
+ },
164
+ `Envelope verification error: ${(e as Error).message}`
165
+ );
132
166
  }
133
167
 
134
- // 5. Run verification steps in parallel
135
- // Note: No data availability check needed here - importExecutionPayload is only
136
- // called when payloadInput.isComplete() is true, so all data is already available.
137
- const [execResult, signatureValid, postPayloadResult] = await Promise.all([
168
+ // 4a. Run EL and signature verification in parallel
169
+ const [execResult, signatureValid] = await Promise.all([
138
170
  this.executionEngine.notifyNewPayload(
139
171
  fork,
140
172
  envelope.payload,
141
173
  payloadInput.getVersionedHashes(),
142
- fromHex(protoBlock.parentRoot),
174
+ envelope.parentBeaconBlockRoot,
143
175
  envelope.executionRequests
144
176
  ),
145
177
 
146
178
  opts.validSignature === true
147
179
  ? Promise.resolve(true)
148
- : (async () => {
149
- const signatureSet = getExecutionPayloadEnvelopeSignatureSet(
150
- this.config,
151
- this.pubkeyCache,
152
- blockState,
153
- signedEnvelope,
154
- payloadInput.proposerIndex
155
- );
156
- return this.bls.verifySignatureSets([signatureSet]);
157
- })(),
158
-
159
- // Signature verified separately above.
160
- // State root check is done separately below with better error typing (matching block pipeline pattern).
161
- (async () => {
162
- try {
163
- return {
164
- postPayloadState: blockState.processExecutionPayloadEnvelope(signedEnvelope, {
165
- verifySignature: false,
166
- verifyStateRoot: false,
167
- }),
168
- };
169
- } catch (e) {
170
- throw new PayloadError(
171
- {
172
- code: PayloadErrorCode.STATE_TRANSITION_ERROR,
173
- message: (e as Error).message,
174
- },
175
- `State transition error: ${(e as Error).message}`
176
- );
177
- }
178
- })(),
180
+ : verifyExecutionPayloadEnvelopeSignature(
181
+ this.config,
182
+ blockState,
183
+ this.pubkeyCache,
184
+ signedEnvelope,
185
+ payloadInput.proposerIndex,
186
+ this.bls
187
+ ),
179
188
  ]);
180
189
 
181
- // 5a. Check signature verification result
190
+ // 4b. Check signature verification result
182
191
  if (!signatureValid) {
183
192
  throw new PayloadError({code: PayloadErrorCode.INVALID_SIGNATURE});
184
193
  }
185
194
 
186
- // 5b. Handle EL response
195
+ // 4c. Handle EL response
187
196
  switch (execResult.status) {
188
197
  case ExecutionPayloadStatus.VALID:
189
198
  break;
@@ -209,69 +218,80 @@ export async function importExecutionPayload(
209
218
  });
210
219
  }
211
220
 
212
- // 5c. Verify envelope state root matches post-state
213
- const postPayloadState = postPayloadResult.postPayloadState;
214
- const postPayloadStateRoot = postPayloadState.hashTreeRoot();
215
- if (!byteArrayEquals(envelope.stateRoot, postPayloadStateRoot)) {
216
- throw new PayloadError({
217
- code: PayloadErrorCode.STATE_TRANSITION_ERROR,
218
- message: `Envelope state root mismatch expected=${toRootHex(envelope.stateRoot)} actual=${toRootHex(postPayloadStateRoot)}`,
219
- });
220
- }
221
-
222
- // 6. Persist payload envelope to hot DB (performed asynchronously to avoid blocking)
221
+ // 5. Persist payload envelope to hot DB. Wait for write-queue space here to apply backpressure
222
+ // on the import pipeline during sync, then perform the write asynchronously to avoid blocking.
223
+ await this.unfinalizedPayloadEnvelopeWrites.waitForSpace();
223
224
  this.unfinalizedPayloadEnvelopeWrites.push(payloadInput).catch((e) => {
224
225
  if (!isQueueErrorAborted(e)) {
225
226
  this.logger.error(
226
227
  "Error pushing payload envelope to unfinalized write queue",
227
- {slot: envelope.slot, blockRoot: blockRootHex},
228
+ {slot, blockRoot: blockRootHex},
228
229
  e as Error
229
230
  );
230
231
  }
231
232
  });
232
233
 
233
- // 7. Update fork choice
234
+ // 6. Update fork choice, transitions the block's PENDING variant to FULL
235
+ const execStatus = toForkChoiceExecutionStatus(execResult.status);
234
236
  this.forkChoice.onExecutionPayload(
235
237
  blockRootHex,
236
238
  blockHashHex,
237
239
  envelope.payload.blockNumber,
238
- toRootHex(postPayloadStateRoot),
239
- toForkChoiceExecutionStatus(execResult.status)
240
+ execStatus,
241
+ dataAvailabilityStatus
240
242
  );
241
243
 
242
- // 8. Cache payload state
243
- this.regen.processPayloadState(postPayloadState);
244
- if (postPayloadState.slot % SLOTS_PER_EPOCH === 0) {
245
- const {checkpoint} = postPayloadState.computeAnchorCheckpoint();
246
- this.regen.addCheckpointState(checkpoint, postPayloadState, true);
244
+ // 7. Queue notifyForkchoiceUpdate to engine api
245
+ const head = this.forkChoice.getHead();
246
+ if (!this.opts.disableImportExecutionFcU && blockRootHex === head.blockRoot) {
247
+ const safeBlockHash = getSafeExecutionBlockHash(this.forkChoice);
248
+ const finalizedBlockHash = this.forkChoice.getFinalizedBlock().executionPayloadBlockHash ?? ZERO_HASH_HEX;
249
+ this.executionEngine.notifyForkchoiceUpdate(fork, blockHashHex, safeBlockHash, finalizedBlockHash).catch((e) => {
250
+ if (!isErrorAborted(e) && !isQueueErrorAborted(e)) {
251
+ this.logger.error("Error pushing notifyForkchoiceUpdate()", {blockHashHex, finalizedBlockHash}, e);
252
+ }
253
+ });
247
254
  }
248
255
 
249
- // 9. Record metrics for payload envelope and column sources
256
+ // 8. Record metrics for payload envelope and column sources
250
257
  this.metrics?.importPayload.bySource.inc({source: payloadInput.getPayloadEnvelopeSource().source});
251
258
  for (const {source} of payloadInput.getSampledColumnsWithSource()) {
252
259
  this.metrics?.importPayload.columnsBySource.inc({source});
253
260
  }
254
261
 
255
- const stateRootHex = toRootHex(envelope.stateRoot);
256
-
257
- // 10. Emit event after payload is fully verified and imported to fork choice, only for recent enough payloads
258
- if (this.clock.currentSlot - envelope.slot < EVENTSTREAM_EMIT_RECENT_EXECUTION_PAYLOAD_SLOTS) {
262
+ // 9. Emit event after payload is fully verified and imported to fork choice, only for recent enough payloads
263
+ if (this.clock.currentSlot - slot < EVENTSTREAM_EMIT_RECENT_EXECUTION_PAYLOAD_SLOTS) {
259
264
  this.emitter.emit(routes.events.EventType.executionPayload, {
260
- slot: envelope.slot,
265
+ slot,
261
266
  builderIndex: envelope.builderIndex,
262
267
  blockHash: blockHashHex,
263
268
  blockRoot: blockRootHex,
264
- stateRoot: stateRootHex,
265
- // TODO GLOAS: revisit once we support optimistic import
266
- executionOptimistic: false,
269
+ executionOptimistic: execStatus === ExecutionStatus.Syncing,
267
270
  });
268
271
  }
269
272
 
270
273
  this.logger.verbose("Execution payload imported", {
271
- slot: envelope.slot,
274
+ slot,
272
275
  builderIndex: envelope.builderIndex,
273
276
  blockRoot: blockRootHex,
274
277
  blockHash: blockHashHex,
275
- stateRoot: stateRootHex,
276
278
  });
277
279
  }
280
+
281
+ /**
282
+ * Process an execution payload envelope end-to-end: wait for DA, then import.
283
+ *
284
+ * Used by the PayloadEnvelopeProcessor queue (gossip / API / unknown-payload sync) — i.e.
285
+ * callers that have NOT already awaited DA themselves. Range sync's inline dispatch in
286
+ * processBlocks skips this wrapper and calls `importExecutionPayload` directly, since
287
+ * `verifyBlocksInEpoch` already awaited DA for the segment.
288
+ */
289
+ export async function processExecutionPayload(
290
+ this: BeaconChain,
291
+ payloadInput: PayloadEnvelopeInput,
292
+ signal: AbortSignal,
293
+ opts: ImportPayloadOpts = {}
294
+ ): Promise<void> {
295
+ const {dataAvailabilityStatuses} = await verifyPayloadsDataAvailability([payloadInput], signal);
296
+ await importExecutionPayload.call(this, payloadInput, dataAvailabilityStatuses[0], opts);
297
+ }