@lodestar/beacon-node 1.35.0-dev.8689cc3545 → 1.35.0-dev.8b45b1e978

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 (863) hide show
  1. package/lib/db/buckets.d.ts +4 -4
  2. package/lib/db/buckets.js +4 -4
  3. package/lib/db/buckets.js.map +1 -1
  4. package/lib/db/repositories/blobSidecars.js +1 -1
  5. package/lib/db/repositories/blobSidecars.js.map +1 -1
  6. package/lib/db/repositories/blobSidecarsArchive.js +1 -1
  7. package/lib/db/repositories/blobSidecarsArchive.js.map +1 -1
  8. package/lib/db/repositories/blockArchiveIndex.d.ts +2 -2
  9. package/lib/db/repositories/dataColumnSidecar.js +1 -1
  10. package/lib/db/repositories/dataColumnSidecar.js.map +1 -1
  11. package/lib/db/repositories/dataColumnSidecarArchive.js +1 -1
  12. package/lib/db/repositories/dataColumnSidecarArchive.js.map +1 -1
  13. package/lib/network/network.js +4 -2
  14. package/lib/network/network.js.map +1 -1
  15. package/lib/util/blobs.js +3 -5
  16. package/lib/util/blobs.js.map +1 -1
  17. package/package.json +20 -18
  18. package/lib/api/impl/api.d.ts.map +0 -1
  19. package/lib/api/impl/beacon/blocks/index.d.ts.map +0 -1
  20. package/lib/api/impl/beacon/blocks/utils.d.ts.map +0 -1
  21. package/lib/api/impl/beacon/index.d.ts.map +0 -1
  22. package/lib/api/impl/beacon/pool/index.d.ts.map +0 -1
  23. package/lib/api/impl/beacon/rewards/index.d.ts.map +0 -1
  24. package/lib/api/impl/beacon/state/index.d.ts.map +0 -1
  25. package/lib/api/impl/beacon/state/utils.d.ts.map +0 -1
  26. package/lib/api/impl/config/constants.d.ts.map +0 -1
  27. package/lib/api/impl/config/index.d.ts.map +0 -1
  28. package/lib/api/impl/debug/index.d.ts.map +0 -1
  29. package/lib/api/impl/errors.d.ts.map +0 -1
  30. package/lib/api/impl/events/index.d.ts.map +0 -1
  31. package/lib/api/impl/index.d.ts.map +0 -1
  32. package/lib/api/impl/lightclient/index.d.ts.map +0 -1
  33. package/lib/api/impl/lodestar/index.d.ts.map +0 -1
  34. package/lib/api/impl/node/index.d.ts.map +0 -1
  35. package/lib/api/impl/node/utils.d.ts.map +0 -1
  36. package/lib/api/impl/proof/index.d.ts.map +0 -1
  37. package/lib/api/impl/types.d.ts.map +0 -1
  38. package/lib/api/impl/utils.d.ts.map +0 -1
  39. package/lib/api/impl/validator/index.d.ts.map +0 -1
  40. package/lib/api/impl/validator/utils.d.ts.map +0 -1
  41. package/lib/api/index.d.ts.map +0 -1
  42. package/lib/api/options.d.ts.map +0 -1
  43. package/lib/api/rest/activeSockets.d.ts.map +0 -1
  44. package/lib/api/rest/base.d.ts.map +0 -1
  45. package/lib/api/rest/index.d.ts.map +0 -1
  46. package/lib/api/rest/swaggerUI.d.ts.map +0 -1
  47. package/lib/bun-wrappers/prometheus-gc-stats.d.ts.map +0 -1
  48. package/lib/chain/ColumnReconstructionTracker.d.ts.map +0 -1
  49. package/lib/chain/GetBlobsTracker.d.ts.map +0 -1
  50. package/lib/chain/archiveStore/archiveStore.d.ts.map +0 -1
  51. package/lib/chain/archiveStore/constants.d.ts.map +0 -1
  52. package/lib/chain/archiveStore/historicalState/getHistoricalState.d.ts.map +0 -1
  53. package/lib/chain/archiveStore/historicalState/historicalStateRegen.d.ts.map +0 -1
  54. package/lib/chain/archiveStore/historicalState/metrics.d.ts.map +0 -1
  55. package/lib/chain/archiveStore/historicalState/types.d.ts.map +0 -1
  56. package/lib/chain/archiveStore/historicalState/worker.d.ts.map +0 -1
  57. package/lib/chain/archiveStore/index.d.ts.map +0 -1
  58. package/lib/chain/archiveStore/interface.d.ts.map +0 -1
  59. package/lib/chain/archiveStore/strategies/frequencyStateArchiveStrategy.d.ts.map +0 -1
  60. package/lib/chain/archiveStore/utils/archiveBlocks.d.ts.map +0 -1
  61. package/lib/chain/archiveStore/utils/pruneHistory.d.ts.map +0 -1
  62. package/lib/chain/archiveStore/utils/updateBackfillRange.d.ts.map +0 -1
  63. package/lib/chain/balancesCache.d.ts.map +0 -1
  64. package/lib/chain/beaconProposerCache.d.ts.map +0 -1
  65. package/lib/chain/blocks/blockInput/blockInput.d.ts.map +0 -1
  66. package/lib/chain/blocks/blockInput/errors.d.ts.map +0 -1
  67. package/lib/chain/blocks/blockInput/index.d.ts.map +0 -1
  68. package/lib/chain/blocks/blockInput/types.d.ts.map +0 -1
  69. package/lib/chain/blocks/blockInput/utils.d.ts.map +0 -1
  70. package/lib/chain/blocks/importBlock.d.ts.map +0 -1
  71. package/lib/chain/blocks/index.d.ts.map +0 -1
  72. package/lib/chain/blocks/types.d.ts.map +0 -1
  73. package/lib/chain/blocks/utils/blowfishBanner.d.ts.map +0 -1
  74. package/lib/chain/blocks/utils/chainSegment.d.ts.map +0 -1
  75. package/lib/chain/blocks/utils/checkpoint.d.ts.map +0 -1
  76. package/lib/chain/blocks/utils/giraffeBanner.d.ts.map +0 -1
  77. package/lib/chain/blocks/utils/ownBanner.d.ts.map +0 -1
  78. package/lib/chain/blocks/utils/pandaMergeTransitionBanner.d.ts.map +0 -1
  79. package/lib/chain/blocks/utils/zebraBanner.d.ts.map +0 -1
  80. package/lib/chain/blocks/verifyBlock.d.ts.map +0 -1
  81. package/lib/chain/blocks/verifyBlocksDataAvailability.d.ts.map +0 -1
  82. package/lib/chain/blocks/verifyBlocksExecutionPayloads.d.ts.map +0 -1
  83. package/lib/chain/blocks/verifyBlocksSanityChecks.d.ts.map +0 -1
  84. package/lib/chain/blocks/verifyBlocksSignatures.d.ts.map +0 -1
  85. package/lib/chain/blocks/verifyBlocksStateTransitionOnly.d.ts.map +0 -1
  86. package/lib/chain/blocks/writeBlockInputToDb.d.ts.map +0 -1
  87. package/lib/chain/bls/index.d.ts.map +0 -1
  88. package/lib/chain/bls/interface.d.ts.map +0 -1
  89. package/lib/chain/bls/maybeBatch.d.ts.map +0 -1
  90. package/lib/chain/bls/multithread/index.d.ts.map +0 -1
  91. package/lib/chain/bls/multithread/jobItem.d.ts.map +0 -1
  92. package/lib/chain/bls/multithread/poolSize.d.ts.map +0 -1
  93. package/lib/chain/bls/multithread/types.d.ts.map +0 -1
  94. package/lib/chain/bls/multithread/utils.d.ts.map +0 -1
  95. package/lib/chain/bls/multithread/worker.d.ts.map +0 -1
  96. package/lib/chain/bls/singleThread.d.ts.map +0 -1
  97. package/lib/chain/bls/utils.d.ts.map +0 -1
  98. package/lib/chain/chain.d.ts.map +0 -1
  99. package/lib/chain/emitter.d.ts.map +0 -1
  100. package/lib/chain/errors/attestationError.d.ts.map +0 -1
  101. package/lib/chain/errors/attesterSlashingError.d.ts.map +0 -1
  102. package/lib/chain/errors/blobSidecarError.d.ts.map +0 -1
  103. package/lib/chain/errors/blockError.d.ts.map +0 -1
  104. package/lib/chain/errors/blsToExecutionChangeError.d.ts.map +0 -1
  105. package/lib/chain/errors/dataColumnSidecarError.d.ts.map +0 -1
  106. package/lib/chain/errors/gossipValidation.d.ts.map +0 -1
  107. package/lib/chain/errors/index.d.ts.map +0 -1
  108. package/lib/chain/errors/lightClientError.d.ts.map +0 -1
  109. package/lib/chain/errors/proposerSlashingError.d.ts.map +0 -1
  110. package/lib/chain/errors/syncCommitteeError.d.ts.map +0 -1
  111. package/lib/chain/errors/voluntaryExitError.d.ts.map +0 -1
  112. package/lib/chain/forkChoice/index.d.ts.map +0 -1
  113. package/lib/chain/genesis/genesis.d.ts.map +0 -1
  114. package/lib/chain/genesis/interface.d.ts.map +0 -1
  115. package/lib/chain/index.d.ts.map +0 -1
  116. package/lib/chain/initState.d.ts.map +0 -1
  117. package/lib/chain/interface.d.ts.map +0 -1
  118. package/lib/chain/lightClient/index.d.ts.map +0 -1
  119. package/lib/chain/lightClient/proofs.d.ts.map +0 -1
  120. package/lib/chain/lightClient/types.d.ts.map +0 -1
  121. package/lib/chain/opPools/aggregatedAttestationPool.d.ts.map +0 -1
  122. package/lib/chain/opPools/attestationPool.d.ts.map +0 -1
  123. package/lib/chain/opPools/index.d.ts.map +0 -1
  124. package/lib/chain/opPools/opPool.d.ts.map +0 -1
  125. package/lib/chain/opPools/syncCommitteeMessagePool.d.ts.map +0 -1
  126. package/lib/chain/opPools/syncContributionAndProofPool.d.ts.map +0 -1
  127. package/lib/chain/opPools/types.d.ts.map +0 -1
  128. package/lib/chain/opPools/utils.d.ts.map +0 -1
  129. package/lib/chain/options.d.ts.map +0 -1
  130. package/lib/chain/prepareNextSlot.d.ts.map +0 -1
  131. package/lib/chain/produceBlock/computeNewStateRoot.d.ts.map +0 -1
  132. package/lib/chain/produceBlock/index.d.ts.map +0 -1
  133. package/lib/chain/produceBlock/produceBlockBody.d.ts.map +0 -1
  134. package/lib/chain/produceBlock/validateBlobsAndKzgCommitments.d.ts.map +0 -1
  135. package/lib/chain/regen/errors.d.ts.map +0 -1
  136. package/lib/chain/regen/index.d.ts.map +0 -1
  137. package/lib/chain/regen/interface.d.ts.map +0 -1
  138. package/lib/chain/regen/queued.d.ts.map +0 -1
  139. package/lib/chain/regen/regen.d.ts.map +0 -1
  140. package/lib/chain/reprocess.d.ts.map +0 -1
  141. package/lib/chain/rewards/attestationsRewards.d.ts.map +0 -1
  142. package/lib/chain/rewards/blockRewards.d.ts.map +0 -1
  143. package/lib/chain/rewards/syncCommitteeRewards.d.ts.map +0 -1
  144. package/lib/chain/seenCache/index.d.ts.map +0 -1
  145. package/lib/chain/seenCache/seenAggregateAndProof.d.ts.map +0 -1
  146. package/lib/chain/seenCache/seenAttestationData.d.ts.map +0 -1
  147. package/lib/chain/seenCache/seenAttesters.d.ts.map +0 -1
  148. package/lib/chain/seenCache/seenBlockAttesters.d.ts.map +0 -1
  149. package/lib/chain/seenCache/seenBlockProposers.d.ts.map +0 -1
  150. package/lib/chain/seenCache/seenCommittee.d.ts.map +0 -1
  151. package/lib/chain/seenCache/seenCommitteeContribution.d.ts.map +0 -1
  152. package/lib/chain/seenCache/seenGossipBlockInput.d.ts.map +0 -1
  153. package/lib/chain/serializeState.d.ts.map +0 -1
  154. package/lib/chain/shufflingCache.d.ts.map +0 -1
  155. package/lib/chain/stateCache/blockStateCacheImpl.d.ts.map +0 -1
  156. package/lib/chain/stateCache/datastore/db.d.ts.map +0 -1
  157. package/lib/chain/stateCache/datastore/file.d.ts.map +0 -1
  158. package/lib/chain/stateCache/datastore/index.d.ts.map +0 -1
  159. package/lib/chain/stateCache/datastore/types.d.ts.map +0 -1
  160. package/lib/chain/stateCache/fifoBlockStateCache.d.ts.map +0 -1
  161. package/lib/chain/stateCache/inMemoryCheckpointsCache.d.ts.map +0 -1
  162. package/lib/chain/stateCache/index.d.ts.map +0 -1
  163. package/lib/chain/stateCache/mapMetrics.d.ts.map +0 -1
  164. package/lib/chain/stateCache/persistentCheckpointsCache.d.ts.map +0 -1
  165. package/lib/chain/stateCache/types.d.ts.map +0 -1
  166. package/lib/chain/validation/aggregateAndProof.d.ts.map +0 -1
  167. package/lib/chain/validation/attestation.d.ts.map +0 -1
  168. package/lib/chain/validation/attesterSlashing.d.ts.map +0 -1
  169. package/lib/chain/validation/blobSidecar.d.ts.map +0 -1
  170. package/lib/chain/validation/block.d.ts.map +0 -1
  171. package/lib/chain/validation/blsToExecutionChange.d.ts.map +0 -1
  172. package/lib/chain/validation/dataColumnSidecar.d.ts.map +0 -1
  173. package/lib/chain/validation/index.d.ts.map +0 -1
  174. package/lib/chain/validation/lightClientFinalityUpdate.d.ts.map +0 -1
  175. package/lib/chain/validation/lightClientOptimisticUpdate.d.ts.map +0 -1
  176. package/lib/chain/validation/proposerSlashing.d.ts.map +0 -1
  177. package/lib/chain/validation/signatureSets/aggregateAndProof.d.ts.map +0 -1
  178. package/lib/chain/validation/signatureSets/contributionAndProof.d.ts.map +0 -1
  179. package/lib/chain/validation/signatureSets/index.d.ts.map +0 -1
  180. package/lib/chain/validation/signatureSets/selectionProof.d.ts.map +0 -1
  181. package/lib/chain/validation/signatureSets/syncCommittee.d.ts.map +0 -1
  182. package/lib/chain/validation/signatureSets/syncCommitteeContribution.d.ts.map +0 -1
  183. package/lib/chain/validation/signatureSets/syncCommitteeSelectionProof.d.ts.map +0 -1
  184. package/lib/chain/validation/syncCommittee.d.ts.map +0 -1
  185. package/lib/chain/validation/syncCommitteeContributionAndProof.d.ts.map +0 -1
  186. package/lib/chain/validation/voluntaryExit.d.ts.map +0 -1
  187. package/lib/chain/validatorMonitor.d.ts.map +0 -1
  188. package/lib/constants/constants.d.ts.map +0 -1
  189. package/lib/constants/index.d.ts.map +0 -1
  190. package/lib/constants/network.d.ts.map +0 -1
  191. package/lib/db/beacon.d.ts.map +0 -1
  192. package/lib/db/buckets.d.ts.map +0 -1
  193. package/lib/db/index.d.ts.map +0 -1
  194. package/lib/db/interface.d.ts.map +0 -1
  195. package/lib/db/options.d.ts.map +0 -1
  196. package/lib/db/repositories/attesterSlashing.d.ts.map +0 -1
  197. package/lib/db/repositories/backfilledRanges.d.ts.map +0 -1
  198. package/lib/db/repositories/blobSidecars.d.ts.map +0 -1
  199. package/lib/db/repositories/blobSidecarsArchive.d.ts.map +0 -1
  200. package/lib/db/repositories/block.d.ts.map +0 -1
  201. package/lib/db/repositories/blockArchive.d.ts.map +0 -1
  202. package/lib/db/repositories/blockArchiveIndex.d.ts.map +0 -1
  203. package/lib/db/repositories/blsToExecutionChange.d.ts.map +0 -1
  204. package/lib/db/repositories/checkpointState.d.ts.map +0 -1
  205. package/lib/db/repositories/dataColumnSidecar.d.ts.map +0 -1
  206. package/lib/db/repositories/dataColumnSidecarArchive.d.ts.map +0 -1
  207. package/lib/db/repositories/depositDataRoot.d.ts.map +0 -1
  208. package/lib/db/repositories/depositEvent.d.ts.map +0 -1
  209. package/lib/db/repositories/eth1Data.d.ts.map +0 -1
  210. package/lib/db/repositories/index.d.ts.map +0 -1
  211. package/lib/db/repositories/lightclientBestUpdate.d.ts.map +0 -1
  212. package/lib/db/repositories/lightclientCheckpointHeader.d.ts.map +0 -1
  213. package/lib/db/repositories/lightclientSyncCommittee.d.ts.map +0 -1
  214. package/lib/db/repositories/lightclientSyncCommitteeWitness.d.ts.map +0 -1
  215. package/lib/db/repositories/proposerSlashing.d.ts.map +0 -1
  216. package/lib/db/repositories/stateArchive.d.ts.map +0 -1
  217. package/lib/db/repositories/stateArchiveIndex.d.ts.map +0 -1
  218. package/lib/db/repositories/voluntaryExit.d.ts.map +0 -1
  219. package/lib/db/single/index.d.ts.map +0 -1
  220. package/lib/db/single/preGenesisState.d.ts.map +0 -1
  221. package/lib/db/single/preGenesisStateLastProcessedBlock.d.ts.map +0 -1
  222. package/lib/eth1/errors.d.ts.map +0 -1
  223. package/lib/eth1/eth1DataCache.d.ts.map +0 -1
  224. package/lib/eth1/eth1DepositDataTracker.d.ts.map +0 -1
  225. package/lib/eth1/eth1DepositsCache.d.ts.map +0 -1
  226. package/lib/eth1/eth1MergeBlockTracker.d.ts.map +0 -1
  227. package/lib/eth1/index.d.ts.map +0 -1
  228. package/lib/eth1/interface.d.ts.map +0 -1
  229. package/lib/eth1/options.d.ts.map +0 -1
  230. package/lib/eth1/provider/eth1Provider.d.ts.map +0 -1
  231. package/lib/eth1/provider/jsonRpcHttpClient.d.ts.map +0 -1
  232. package/lib/eth1/provider/jwt.d.ts.map +0 -1
  233. package/lib/eth1/provider/utils.d.ts.map +0 -1
  234. package/lib/eth1/stream.d.ts.map +0 -1
  235. package/lib/eth1/utils/depositContract.d.ts.map +0 -1
  236. package/lib/eth1/utils/deposits.d.ts.map +0 -1
  237. package/lib/eth1/utils/eth1Data.d.ts.map +0 -1
  238. package/lib/eth1/utils/eth1DepositEvent.d.ts.map +0 -1
  239. package/lib/eth1/utils/eth1Vote.d.ts.map +0 -1
  240. package/lib/eth1/utils/groupDepositEventsByBlock.d.ts.map +0 -1
  241. package/lib/eth1/utils/optimizeNextBlockDiffForGenesis.d.ts.map +0 -1
  242. package/lib/execution/builder/cache.d.ts.map +0 -1
  243. package/lib/execution/builder/http.d.ts.map +0 -1
  244. package/lib/execution/builder/index.d.ts.map +0 -1
  245. package/lib/execution/builder/interface.d.ts.map +0 -1
  246. package/lib/execution/builder/utils.d.ts.map +0 -1
  247. package/lib/execution/engine/disabled.d.ts.map +0 -1
  248. package/lib/execution/engine/http.d.ts.map +0 -1
  249. package/lib/execution/engine/index.d.ts.map +0 -1
  250. package/lib/execution/engine/interface.d.ts.map +0 -1
  251. package/lib/execution/engine/mock.d.ts.map +0 -1
  252. package/lib/execution/engine/payloadIdCache.d.ts.map +0 -1
  253. package/lib/execution/engine/types.d.ts.map +0 -1
  254. package/lib/execution/engine/utils.d.ts.map +0 -1
  255. package/lib/execution/index.d.ts.map +0 -1
  256. package/lib/index.d.ts.map +0 -1
  257. package/lib/metrics/index.d.ts.map +0 -1
  258. package/lib/metrics/metrics/beacon.d.ts.map +0 -1
  259. package/lib/metrics/metrics/lodestar.d.ts.map +0 -1
  260. package/lib/metrics/metrics.d.ts.map +0 -1
  261. package/lib/metrics/nodeJsMetrics.d.ts.map +0 -1
  262. package/lib/metrics/options.d.ts.map +0 -1
  263. package/lib/metrics/server/http.d.ts.map +0 -1
  264. package/lib/metrics/server/index.d.ts.map +0 -1
  265. package/lib/metrics/utils/avgMinMax.d.ts.map +0 -1
  266. package/lib/metrics/utils/gauge.d.ts.map +0 -1
  267. package/lib/metrics/utils/registryMetricCreator.d.ts.map +0 -1
  268. package/lib/monitoring/clientStats.d.ts.map +0 -1
  269. package/lib/monitoring/index.d.ts.map +0 -1
  270. package/lib/monitoring/options.d.ts.map +0 -1
  271. package/lib/monitoring/properties.d.ts.map +0 -1
  272. package/lib/monitoring/service.d.ts.map +0 -1
  273. package/lib/monitoring/system.d.ts.map +0 -1
  274. package/lib/monitoring/types.d.ts.map +0 -1
  275. package/lib/network/core/events.d.ts.map +0 -1
  276. package/lib/network/core/index.d.ts.map +0 -1
  277. package/lib/network/core/metrics.d.ts.map +0 -1
  278. package/lib/network/core/networkCore.d.ts.map +0 -1
  279. package/lib/network/core/networkCoreWorker.d.ts.map +0 -1
  280. package/lib/network/core/networkCoreWorkerHandler.d.ts.map +0 -1
  281. package/lib/network/core/types.d.ts.map +0 -1
  282. package/lib/network/discv5/index.d.ts.map +0 -1
  283. package/lib/network/discv5/types.d.ts.map +0 -1
  284. package/lib/network/discv5/utils.d.ts.map +0 -1
  285. package/lib/network/discv5/worker.d.ts.map +0 -1
  286. package/lib/network/events.d.ts.map +0 -1
  287. package/lib/network/forks.d.ts.map +0 -1
  288. package/lib/network/gossip/constants.d.ts.map +0 -1
  289. package/lib/network/gossip/encoding.d.ts.map +0 -1
  290. package/lib/network/gossip/errors.d.ts.map +0 -1
  291. package/lib/network/gossip/gossipsub.d.ts.map +0 -1
  292. package/lib/network/gossip/index.d.ts.map +0 -1
  293. package/lib/network/gossip/interface.d.ts.map +0 -1
  294. package/lib/network/gossip/metrics.d.ts.map +0 -1
  295. package/lib/network/gossip/scoringParameters.d.ts.map +0 -1
  296. package/lib/network/gossip/topic.d.ts.map +0 -1
  297. package/lib/network/index.d.ts.map +0 -1
  298. package/lib/network/interface.d.ts.map +0 -1
  299. package/lib/network/libp2p/error.d.ts.map +0 -1
  300. package/lib/network/libp2p/index.d.ts.map +0 -1
  301. package/lib/network/metadata.d.ts.map +0 -1
  302. package/lib/network/network.d.ts.map +0 -1
  303. package/lib/network/networkConfig.d.ts.map +0 -1
  304. package/lib/network/options.d.ts.map +0 -1
  305. package/lib/network/peers/client.d.ts.map +0 -1
  306. package/lib/network/peers/datastore.d.ts.map +0 -1
  307. package/lib/network/peers/discover.d.ts.map +0 -1
  308. package/lib/network/peers/index.d.ts.map +0 -1
  309. package/lib/network/peers/peerManager.d.ts.map +0 -1
  310. package/lib/network/peers/peersData.d.ts.map +0 -1
  311. package/lib/network/peers/score/constants.d.ts.map +0 -1
  312. package/lib/network/peers/score/index.d.ts.map +0 -1
  313. package/lib/network/peers/score/interface.d.ts.map +0 -1
  314. package/lib/network/peers/score/score.d.ts.map +0 -1
  315. package/lib/network/peers/score/store.d.ts.map +0 -1
  316. package/lib/network/peers/score/utils.d.ts.map +0 -1
  317. package/lib/network/peers/utils/assertPeerRelevance.d.ts.map +0 -1
  318. package/lib/network/peers/utils/enrSubnetsDeserialize.d.ts.map +0 -1
  319. package/lib/network/peers/utils/getConnectedPeerIds.d.ts.map +0 -1
  320. package/lib/network/peers/utils/index.d.ts.map +0 -1
  321. package/lib/network/peers/utils/prioritizePeers.d.ts.map +0 -1
  322. package/lib/network/peers/utils/subnetMap.d.ts.map +0 -1
  323. package/lib/network/processor/aggregatorTracker.d.ts.map +0 -1
  324. package/lib/network/processor/extractSlotRootFns.d.ts.map +0 -1
  325. package/lib/network/processor/gossipHandlers.d.ts.map +0 -1
  326. package/lib/network/processor/gossipQueues/index.d.ts.map +0 -1
  327. package/lib/network/processor/gossipQueues/indexed.d.ts.map +0 -1
  328. package/lib/network/processor/gossipQueues/linear.d.ts.map +0 -1
  329. package/lib/network/processor/gossipQueues/types.d.ts.map +0 -1
  330. package/lib/network/processor/gossipValidatorFn.d.ts.map +0 -1
  331. package/lib/network/processor/index.d.ts.map +0 -1
  332. package/lib/network/processor/types.d.ts.map +0 -1
  333. package/lib/network/reqresp/ReqRespBeaconNode.d.ts.map +0 -1
  334. package/lib/network/reqresp/handlers/beaconBlocksByRange.d.ts.map +0 -1
  335. package/lib/network/reqresp/handlers/beaconBlocksByRoot.d.ts.map +0 -1
  336. package/lib/network/reqresp/handlers/blobSidecarsByRange.d.ts.map +0 -1
  337. package/lib/network/reqresp/handlers/blobSidecarsByRoot.d.ts.map +0 -1
  338. package/lib/network/reqresp/handlers/dataColumnSidecarsByRange.d.ts.map +0 -1
  339. package/lib/network/reqresp/handlers/dataColumnSidecarsByRoot.d.ts.map +0 -1
  340. package/lib/network/reqresp/handlers/index.d.ts.map +0 -1
  341. package/lib/network/reqresp/handlers/lightClientBootstrap.d.ts.map +0 -1
  342. package/lib/network/reqresp/handlers/lightClientFinalityUpdate.d.ts.map +0 -1
  343. package/lib/network/reqresp/handlers/lightClientOptimisticUpdate.d.ts.map +0 -1
  344. package/lib/network/reqresp/handlers/lightClientUpdatesByRange.d.ts.map +0 -1
  345. package/lib/network/reqresp/index.d.ts.map +0 -1
  346. package/lib/network/reqresp/interface.d.ts.map +0 -1
  347. package/lib/network/reqresp/protocols.d.ts.map +0 -1
  348. package/lib/network/reqresp/rateLimit.d.ts.map +0 -1
  349. package/lib/network/reqresp/score.d.ts.map +0 -1
  350. package/lib/network/reqresp/types.d.ts.map +0 -1
  351. package/lib/network/reqresp/utils/collect.d.ts.map +0 -1
  352. package/lib/network/reqresp/utils/collectSequentialBlocksInRange.d.ts.map +0 -1
  353. package/lib/network/reqresp/utils/dataColumnResponseValidation.d.ts.map +0 -1
  354. package/lib/network/statusCache.d.ts.map +0 -1
  355. package/lib/network/subnets/attnetsService.d.ts.map +0 -1
  356. package/lib/network/subnets/index.d.ts.map +0 -1
  357. package/lib/network/subnets/interface.d.ts.map +0 -1
  358. package/lib/network/subnets/syncnetsService.d.ts.map +0 -1
  359. package/lib/network/subnets/util.d.ts.map +0 -1
  360. package/lib/network/util.d.ts.map +0 -1
  361. package/lib/node/index.d.ts.map +0 -1
  362. package/lib/node/nodejs.d.ts.map +0 -1
  363. package/lib/node/notifier.d.ts.map +0 -1
  364. package/lib/node/options.d.ts.map +0 -1
  365. package/lib/node/utils/interop/deposits.d.ts.map +0 -1
  366. package/lib/node/utils/interop/state.d.ts.map +0 -1
  367. package/lib/node/utils/lightclient.d.ts.map +0 -1
  368. package/lib/node/utils/state.d.ts.map +0 -1
  369. package/lib/sync/backfill/backfill.d.ts.map +0 -1
  370. package/lib/sync/backfill/errors.d.ts.map +0 -1
  371. package/lib/sync/backfill/index.d.ts.map +0 -1
  372. package/lib/sync/backfill/verify.d.ts.map +0 -1
  373. package/lib/sync/constants.d.ts.map +0 -1
  374. package/lib/sync/index.d.ts.map +0 -1
  375. package/lib/sync/interface.d.ts.map +0 -1
  376. package/lib/sync/options.d.ts.map +0 -1
  377. package/lib/sync/range/batch.d.ts.map +0 -1
  378. package/lib/sync/range/chain.d.ts.map +0 -1
  379. package/lib/sync/range/range.d.ts.map +0 -1
  380. package/lib/sync/range/utils/batches.d.ts.map +0 -1
  381. package/lib/sync/range/utils/chainTarget.d.ts.map +0 -1
  382. package/lib/sync/range/utils/hashBlocks.d.ts.map +0 -1
  383. package/lib/sync/range/utils/index.d.ts.map +0 -1
  384. package/lib/sync/range/utils/peerBalancer.d.ts.map +0 -1
  385. package/lib/sync/range/utils/updateChains.d.ts.map +0 -1
  386. package/lib/sync/sync.d.ts.map +0 -1
  387. package/lib/sync/types.d.ts.map +0 -1
  388. package/lib/sync/unknownBlock.d.ts.map +0 -1
  389. package/lib/sync/utils/downloadByRange.d.ts.map +0 -1
  390. package/lib/sync/utils/downloadByRoot.d.ts.map +0 -1
  391. package/lib/sync/utils/pendingBlocksTree.d.ts.map +0 -1
  392. package/lib/sync/utils/remoteSyncType.d.ts.map +0 -1
  393. package/lib/util/address.d.ts.map +0 -1
  394. package/lib/util/array.d.ts.map +0 -1
  395. package/lib/util/asyncIterableToEvents.d.ts.map +0 -1
  396. package/lib/util/binarySearch.d.ts.map +0 -1
  397. package/lib/util/bitArray.d.ts.map +0 -1
  398. package/lib/util/blobs.d.ts.map +0 -1
  399. package/lib/util/bufferPool.d.ts.map +0 -1
  400. package/lib/util/bytes.d.ts.map +0 -1
  401. package/lib/util/chunkify.d.ts.map +0 -1
  402. package/lib/util/clock.d.ts.map +0 -1
  403. package/lib/util/dataColumns.d.ts.map +0 -1
  404. package/lib/util/dependentRoot.d.ts.map +0 -1
  405. package/lib/util/enum.d.ts.map +0 -1
  406. package/lib/util/error.d.ts.map +0 -1
  407. package/lib/util/eventLoop.d.ts.map +0 -1
  408. package/lib/util/execution.d.ts.map +0 -1
  409. package/lib/util/file.d.ts.map +0 -1
  410. package/lib/util/forkChoice.d.ts.map +0 -1
  411. package/lib/util/forkName.d.ts.map +0 -1
  412. package/lib/util/graffiti.d.ts.map +0 -1
  413. package/lib/util/hex.d.ts.map +0 -1
  414. package/lib/util/index.d.ts.map +0 -1
  415. package/lib/util/ip.d.ts.map +0 -1
  416. package/lib/util/itTrigger.d.ts.map +0 -1
  417. package/lib/util/kzg.d.ts.map +0 -1
  418. package/lib/util/map.d.ts.map +0 -1
  419. package/lib/util/metadata.d.ts.map +0 -1
  420. package/lib/util/multifork.d.ts.map +0 -1
  421. package/lib/util/numpy.d.ts.map +0 -1
  422. package/lib/util/peerId.d.ts.map +0 -1
  423. package/lib/util/profile.d.ts.map +0 -1
  424. package/lib/util/promises.d.ts.map +0 -1
  425. package/lib/util/queue/errors.d.ts.map +0 -1
  426. package/lib/util/queue/fnQueue.d.ts.map +0 -1
  427. package/lib/util/queue/index.d.ts.map +0 -1
  428. package/lib/util/queue/itemQueue.d.ts.map +0 -1
  429. package/lib/util/queue/options.d.ts.map +0 -1
  430. package/lib/util/serializedCache.d.ts.map +0 -1
  431. package/lib/util/set.d.ts.map +0 -1
  432. package/lib/util/shuffle.d.ts.map +0 -1
  433. package/lib/util/sortBy.d.ts.map +0 -1
  434. package/lib/util/sszBytes.d.ts.map +0 -1
  435. package/lib/util/strictEvents.d.ts.map +0 -1
  436. package/lib/util/time.d.ts.map +0 -1
  437. package/lib/util/timeSeries.d.ts.map +0 -1
  438. package/lib/util/types.d.ts.map +0 -1
  439. package/lib/util/workerEvents.d.ts.map +0 -1
  440. package/lib/util/wrapError.d.ts.map +0 -1
  441. package/src/api/impl/api.ts +0 -26
  442. package/src/api/impl/beacon/blocks/index.ts +0 -744
  443. package/src/api/impl/beacon/blocks/utils.ts +0 -75
  444. package/src/api/impl/beacon/index.ts +0 -35
  445. package/src/api/impl/beacon/pool/index.ts +0 -314
  446. package/src/api/impl/beacon/rewards/index.ts +0 -30
  447. package/src/api/impl/beacon/state/index.ts +0 -406
  448. package/src/api/impl/beacon/state/utils.ts +0 -189
  449. package/src/api/impl/config/constants.ts +0 -127
  450. package/src/api/impl/config/index.ts +0 -59
  451. package/src/api/impl/debug/index.ts +0 -131
  452. package/src/api/impl/errors.ts +0 -50
  453. package/src/api/impl/events/index.ts +0 -33
  454. package/src/api/impl/index.ts +0 -6
  455. package/src/api/impl/lightclient/index.ts +0 -64
  456. package/src/api/impl/lodestar/index.ts +0 -257
  457. package/src/api/impl/node/index.ts +0 -88
  458. package/src/api/impl/node/utils.ts +0 -51
  459. package/src/api/impl/proof/index.ts +0 -60
  460. package/src/api/impl/types.ts +0 -17
  461. package/src/api/impl/utils.ts +0 -25
  462. package/src/api/impl/validator/index.ts +0 -1538
  463. package/src/api/impl/validator/utils.ts +0 -85
  464. package/src/api/index.ts +0 -2
  465. package/src/api/options.ts +0 -16
  466. package/src/api/rest/activeSockets.ts +0 -109
  467. package/src/api/rest/base.ts +0 -216
  468. package/src/api/rest/index.ts +0 -63
  469. package/src/api/rest/swaggerUI.ts +0 -80
  470. package/src/bun-wrappers/prometheus-gc-stats.ts +0 -7
  471. package/src/chain/ColumnReconstructionTracker.ts +0 -90
  472. package/src/chain/GetBlobsTracker.ts +0 -115
  473. package/src/chain/archiveStore/archiveStore.ts +0 -222
  474. package/src/chain/archiveStore/constants.ts +0 -5
  475. package/src/chain/archiveStore/historicalState/getHistoricalState.ts +0 -116
  476. package/src/chain/archiveStore/historicalState/historicalStateRegen.ts +0 -68
  477. package/src/chain/archiveStore/historicalState/metrics.ts +0 -214
  478. package/src/chain/archiveStore/historicalState/types.ts +0 -41
  479. package/src/chain/archiveStore/historicalState/worker.ts +0 -77
  480. package/src/chain/archiveStore/index.ts +0 -3
  481. package/src/chain/archiveStore/interface.ts +0 -75
  482. package/src/chain/archiveStore/strategies/frequencyStateArchiveStrategy.ts +0 -138
  483. package/src/chain/archiveStore/utils/archiveBlocks.ts +0 -437
  484. package/src/chain/archiveStore/utils/pruneHistory.ts +0 -56
  485. package/src/chain/archiveStore/utils/updateBackfillRange.ts +0 -50
  486. package/src/chain/balancesCache.ts +0 -52
  487. package/src/chain/beaconProposerCache.ts +0 -43
  488. package/src/chain/blocks/blockInput/blockInput.ts +0 -851
  489. package/src/chain/blocks/blockInput/errors.ts +0 -48
  490. package/src/chain/blocks/blockInput/index.ts +0 -4
  491. package/src/chain/blocks/blockInput/types.ts +0 -145
  492. package/src/chain/blocks/blockInput/utils.ts +0 -21
  493. package/src/chain/blocks/importBlock.ts +0 -603
  494. package/src/chain/blocks/index.ts +0 -179
  495. package/src/chain/blocks/types.ts +0 -101
  496. package/src/chain/blocks/utils/blowfishBanner.ts +0 -28
  497. package/src/chain/blocks/utils/chainSegment.ts +0 -29
  498. package/src/chain/blocks/utils/checkpoint.ts +0 -25
  499. package/src/chain/blocks/utils/giraffeBanner.ts +0 -30
  500. package/src/chain/blocks/utils/ownBanner.ts +0 -20
  501. package/src/chain/blocks/utils/pandaMergeTransitionBanner.ts +0 -43
  502. package/src/chain/blocks/utils/zebraBanner.ts +0 -45
  503. package/src/chain/blocks/verifyBlock.ts +0 -242
  504. package/src/chain/blocks/verifyBlocksDataAvailability.ts +0 -34
  505. package/src/chain/blocks/verifyBlocksExecutionPayloads.ts +0 -438
  506. package/src/chain/blocks/verifyBlocksSanityChecks.ts +0 -129
  507. package/src/chain/blocks/verifyBlocksSignatures.ts +0 -105
  508. package/src/chain/blocks/verifyBlocksStateTransitionOnly.ts +0 -114
  509. package/src/chain/blocks/writeBlockInputToDb.ts +0 -128
  510. package/src/chain/bls/index.ts +0 -4
  511. package/src/chain/bls/interface.ts +0 -68
  512. package/src/chain/bls/maybeBatch.ts +0 -45
  513. package/src/chain/bls/multithread/index.ts +0 -582
  514. package/src/chain/bls/multithread/jobItem.ts +0 -119
  515. package/src/chain/bls/multithread/poolSize.ts +0 -16
  516. package/src/chain/bls/multithread/types.ts +0 -38
  517. package/src/chain/bls/multithread/utils.ts +0 -19
  518. package/src/chain/bls/multithread/worker.ts +0 -114
  519. package/src/chain/bls/singleThread.ts +0 -87
  520. package/src/chain/bls/utils.ts +0 -30
  521. package/src/chain/chain.ts +0 -1365
  522. package/src/chain/emitter.ts +0 -113
  523. package/src/chain/errors/attestationError.ts +0 -194
  524. package/src/chain/errors/attesterSlashingError.ts +0 -11
  525. package/src/chain/errors/blobSidecarError.ts +0 -60
  526. package/src/chain/errors/blockError.ts +0 -166
  527. package/src/chain/errors/blsToExecutionChangeError.ts +0 -13
  528. package/src/chain/errors/dataColumnSidecarError.ts +0 -80
  529. package/src/chain/errors/gossipValidation.ts +0 -20
  530. package/src/chain/errors/index.ts +0 -10
  531. package/src/chain/errors/lightClientError.ts +0 -30
  532. package/src/chain/errors/proposerSlashingError.ts +0 -11
  533. package/src/chain/errors/syncCommitteeError.ts +0 -36
  534. package/src/chain/errors/voluntaryExitError.ts +0 -13
  535. package/src/chain/forkChoice/index.ts +0 -112
  536. package/src/chain/genesis/genesis.ts +0 -190
  537. package/src/chain/genesis/interface.ts +0 -14
  538. package/src/chain/index.ts +0 -6
  539. package/src/chain/initState.ts +0 -221
  540. package/src/chain/interface.ts +0 -280
  541. package/src/chain/lightClient/index.ts +0 -764
  542. package/src/chain/lightClient/proofs.ts +0 -85
  543. package/src/chain/lightClient/types.ts +0 -33
  544. package/src/chain/opPools/aggregatedAttestationPool.ts +0 -1063
  545. package/src/chain/opPools/attestationPool.ts +0 -283
  546. package/src/chain/opPools/index.ts +0 -5
  547. package/src/chain/opPools/opPool.ts +0 -462
  548. package/src/chain/opPools/syncCommitteeMessagePool.ts +0 -167
  549. package/src/chain/opPools/syncContributionAndProofPool.ts +0 -240
  550. package/src/chain/opPools/types.ts +0 -35
  551. package/src/chain/opPools/utils.ts +0 -65
  552. package/src/chain/options.ts +0 -138
  553. package/src/chain/prepareNextSlot.ts +0 -277
  554. package/src/chain/produceBlock/computeNewStateRoot.ts +0 -55
  555. package/src/chain/produceBlock/index.ts +0 -2
  556. package/src/chain/produceBlock/produceBlockBody.ts +0 -797
  557. package/src/chain/produceBlock/validateBlobsAndKzgCommitments.ts +0 -54
  558. package/src/chain/regen/errors.ts +0 -30
  559. package/src/chain/regen/index.ts +0 -4
  560. package/src/chain/regen/interface.ts +0 -93
  561. package/src/chain/regen/queued.ts +0 -317
  562. package/src/chain/regen/regen.ts +0 -424
  563. package/src/chain/reprocess.ts +0 -161
  564. package/src/chain/rewards/attestationsRewards.ts +0 -196
  565. package/src/chain/rewards/blockRewards.ts +0 -150
  566. package/src/chain/rewards/syncCommitteeRewards.ts +0 -58
  567. package/src/chain/seenCache/index.ts +0 -5
  568. package/src/chain/seenCache/seenAggregateAndProof.ts +0 -120
  569. package/src/chain/seenCache/seenAttestationData.ts +0 -145
  570. package/src/chain/seenCache/seenAttesters.ts +0 -58
  571. package/src/chain/seenCache/seenBlockAttesters.ts +0 -18
  572. package/src/chain/seenCache/seenBlockProposers.ts +0 -48
  573. package/src/chain/seenCache/seenCommittee.ts +0 -43
  574. package/src/chain/seenCache/seenCommitteeContribution.ts +0 -104
  575. package/src/chain/seenCache/seenGossipBlockInput.ts +0 -373
  576. package/src/chain/serializeState.ts +0 -32
  577. package/src/chain/shufflingCache.ts +0 -238
  578. package/src/chain/stateCache/blockStateCacheImpl.ts +0 -150
  579. package/src/chain/stateCache/datastore/db.ts +0 -36
  580. package/src/chain/stateCache/datastore/file.ts +0 -53
  581. package/src/chain/stateCache/datastore/index.ts +0 -2
  582. package/src/chain/stateCache/datastore/types.ts +0 -13
  583. package/src/chain/stateCache/fifoBlockStateCache.ts +0 -208
  584. package/src/chain/stateCache/inMemoryCheckpointsCache.ts +0 -198
  585. package/src/chain/stateCache/index.ts +0 -3
  586. package/src/chain/stateCache/mapMetrics.ts +0 -52
  587. package/src/chain/stateCache/persistentCheckpointsCache.ts +0 -835
  588. package/src/chain/stateCache/types.ts +0 -86
  589. package/src/chain/validation/aggregateAndProof.ts +0 -258
  590. package/src/chain/validation/attestation.ts +0 -885
  591. package/src/chain/validation/attesterSlashing.ts +0 -61
  592. package/src/chain/validation/blobSidecar.ts +0 -301
  593. package/src/chain/validation/block.ts +0 -188
  594. package/src/chain/validation/blsToExecutionChange.ts +0 -61
  595. package/src/chain/validation/dataColumnSidecar.ts +0 -381
  596. package/src/chain/validation/index.ts +0 -9
  597. package/src/chain/validation/lightClientFinalityUpdate.ts +0 -45
  598. package/src/chain/validation/lightClientOptimisticUpdate.ts +0 -67
  599. package/src/chain/validation/proposerSlashing.ts +0 -54
  600. package/src/chain/validation/signatureSets/aggregateAndProof.ts +0 -38
  601. package/src/chain/validation/signatureSets/contributionAndProof.ts +0 -27
  602. package/src/chain/validation/signatureSets/index.ts +0 -6
  603. package/src/chain/validation/signatureSets/selectionProof.ts +0 -27
  604. package/src/chain/validation/signatureSets/syncCommittee.ts +0 -22
  605. package/src/chain/validation/signatureSets/syncCommitteeContribution.ts +0 -18
  606. package/src/chain/validation/signatureSets/syncCommitteeSelectionProof.ts +0 -27
  607. package/src/chain/validation/syncCommittee.ts +0 -165
  608. package/src/chain/validation/syncCommitteeContributionAndProof.ts +0 -122
  609. package/src/chain/validation/voluntaryExit.ts +0 -58
  610. package/src/chain/validatorMonitor.ts +0 -1299
  611. package/src/constants/constants.ts +0 -15
  612. package/src/constants/index.ts +0 -2
  613. package/src/constants/network.ts +0 -52
  614. package/src/db/beacon.ts +0 -113
  615. package/src/db/buckets.ts +0 -80
  616. package/src/db/index.ts +0 -2
  617. package/src/db/interface.ts +0 -76
  618. package/src/db/options.ts +0 -7
  619. package/src/db/repositories/attesterSlashing.ts +0 -38
  620. package/src/db/repositories/backfilledRanges.ts +0 -29
  621. package/src/db/repositories/blobSidecars.ts +0 -37
  622. package/src/db/repositories/blobSidecarsArchive.ts +0 -28
  623. package/src/db/repositories/block.ts +0 -33
  624. package/src/db/repositories/blockArchive.ts +0 -170
  625. package/src/db/repositories/blockArchiveIndex.ts +0 -45
  626. package/src/db/repositories/blsToExecutionChange.ts +0 -16
  627. package/src/db/repositories/checkpointState.ts +0 -31
  628. package/src/db/repositories/dataColumnSidecar.ts +0 -49
  629. package/src/db/repositories/dataColumnSidecarArchive.ts +0 -56
  630. package/src/db/repositories/depositDataRoot.ts +0 -80
  631. package/src/db/repositories/depositEvent.ts +0 -32
  632. package/src/db/repositories/eth1Data.ts +0 -33
  633. package/src/db/repositories/index.ts +0 -20
  634. package/src/db/repositories/lightclientBestUpdate.ts +0 -41
  635. package/src/db/repositories/lightclientCheckpointHeader.ts +0 -32
  636. package/src/db/repositories/lightclientSyncCommittee.ts +0 -16
  637. package/src/db/repositories/lightclientSyncCommitteeWitness.ts +0 -77
  638. package/src/db/repositories/proposerSlashing.ts +0 -15
  639. package/src/db/repositories/stateArchive.ts +0 -69
  640. package/src/db/repositories/stateArchiveIndex.ts +0 -18
  641. package/src/db/repositories/voluntaryExit.ts +0 -15
  642. package/src/db/single/index.ts +0 -2
  643. package/src/db/single/preGenesisState.ts +0 -37
  644. package/src/db/single/preGenesisStateLastProcessedBlock.ts +0 -34
  645. package/src/eth1/errors.ts +0 -40
  646. package/src/eth1/eth1DataCache.ts +0 -26
  647. package/src/eth1/eth1DepositDataTracker.ts +0 -410
  648. package/src/eth1/eth1DepositsCache.ts +0 -141
  649. package/src/eth1/eth1MergeBlockTracker.ts +0 -328
  650. package/src/eth1/index.ts +0 -157
  651. package/src/eth1/interface.ts +0 -131
  652. package/src/eth1/options.ts +0 -28
  653. package/src/eth1/provider/eth1Provider.ts +0 -229
  654. package/src/eth1/provider/jsonRpcHttpClient.ts +0 -390
  655. package/src/eth1/provider/jwt.ts +0 -36
  656. package/src/eth1/provider/utils.ts +0 -136
  657. package/src/eth1/stream.ts +0 -75
  658. package/src/eth1/utils/depositContract.ts +0 -37
  659. package/src/eth1/utils/deposits.ts +0 -70
  660. package/src/eth1/utils/eth1Data.ts +0 -100
  661. package/src/eth1/utils/eth1DepositEvent.ts +0 -12
  662. package/src/eth1/utils/eth1Vote.ts +0 -142
  663. package/src/eth1/utils/groupDepositEventsByBlock.ts +0 -19
  664. package/src/eth1/utils/optimizeNextBlockDiffForGenesis.ts +0 -18
  665. package/src/execution/builder/cache.ts +0 -39
  666. package/src/execution/builder/http.ts +0 -229
  667. package/src/execution/builder/index.ts +0 -27
  668. package/src/execution/builder/interface.ts +0 -49
  669. package/src/execution/builder/utils.ts +0 -19
  670. package/src/execution/engine/disabled.ts +0 -35
  671. package/src/execution/engine/http.ts +0 -644
  672. package/src/execution/engine/index.ts +0 -63
  673. package/src/execution/engine/interface.ts +0 -199
  674. package/src/execution/engine/mock.ts +0 -493
  675. package/src/execution/engine/payloadIdCache.ts +0 -54
  676. package/src/execution/engine/types.ts +0 -640
  677. package/src/execution/engine/utils.ts +0 -136
  678. package/src/execution/index.ts +0 -4
  679. package/src/index.ts +0 -20
  680. package/src/metrics/index.ts +0 -4
  681. package/src/metrics/metrics/beacon.ts +0 -390
  682. package/src/metrics/metrics/lodestar.ts +0 -1870
  683. package/src/metrics/metrics.ts +0 -43
  684. package/src/metrics/nodeJsMetrics.ts +0 -19
  685. package/src/metrics/options.ts +0 -22
  686. package/src/metrics/server/http.ts +0 -114
  687. package/src/metrics/server/index.ts +0 -1
  688. package/src/metrics/utils/avgMinMax.ts +0 -87
  689. package/src/metrics/utils/gauge.ts +0 -22
  690. package/src/metrics/utils/registryMetricCreator.ts +0 -41
  691. package/src/monitoring/clientStats.ts +0 -297
  692. package/src/monitoring/index.ts +0 -2
  693. package/src/monitoring/options.ts +0 -19
  694. package/src/monitoring/properties.ts +0 -152
  695. package/src/monitoring/service.ts +0 -235
  696. package/src/monitoring/system.ts +0 -146
  697. package/src/monitoring/types.ts +0 -21
  698. package/src/network/core/events.ts +0 -59
  699. package/src/network/core/index.ts +0 -3
  700. package/src/network/core/metrics.ts +0 -304
  701. package/src/network/core/networkCore.ts +0 -599
  702. package/src/network/core/networkCoreWorker.ts +0 -176
  703. package/src/network/core/networkCoreWorkerHandler.ts +0 -284
  704. package/src/network/core/types.ts +0 -119
  705. package/src/network/discv5/index.ts +0 -132
  706. package/src/network/discv5/types.ts +0 -74
  707. package/src/network/discv5/utils.ts +0 -50
  708. package/src/network/discv5/worker.ts +0 -137
  709. package/src/network/events.ts +0 -51
  710. package/src/network/forks.ts +0 -94
  711. package/src/network/gossip/constants.ts +0 -15
  712. package/src/network/gossip/encoding.ts +0 -111
  713. package/src/network/gossip/errors.ts +0 -7
  714. package/src/network/gossip/gossipsub.ts +0 -384
  715. package/src/network/gossip/index.ts +0 -4
  716. package/src/network/gossip/interface.ts +0 -215
  717. package/src/network/gossip/metrics.ts +0 -71
  718. package/src/network/gossip/scoringParameters.ts +0 -333
  719. package/src/network/gossip/topic.ts +0 -332
  720. package/src/network/index.ts +0 -8
  721. package/src/network/interface.ts +0 -134
  722. package/src/network/libp2p/error.ts +0 -55
  723. package/src/network/libp2p/index.ts +0 -153
  724. package/src/network/metadata.ts +0 -162
  725. package/src/network/network.ts +0 -767
  726. package/src/network/networkConfig.ts +0 -12
  727. package/src/network/options.ts +0 -70
  728. package/src/network/peers/client.ts +0 -29
  729. package/src/network/peers/datastore.ts +0 -188
  730. package/src/network/peers/discover.ts +0 -647
  731. package/src/network/peers/index.ts +0 -2
  732. package/src/network/peers/peerManager.ts +0 -899
  733. package/src/network/peers/peersData.ts +0 -65
  734. package/src/network/peers/score/constants.ts +0 -34
  735. package/src/network/peers/score/index.ts +0 -4
  736. package/src/network/peers/score/interface.ts +0 -74
  737. package/src/network/peers/score/score.ts +0 -200
  738. package/src/network/peers/score/store.ts +0 -95
  739. package/src/network/peers/score/utils.ts +0 -37
  740. package/src/network/peers/utils/assertPeerRelevance.ts +0 -99
  741. package/src/network/peers/utils/enrSubnetsDeserialize.ts +0 -27
  742. package/src/network/peers/utils/getConnectedPeerIds.ts +0 -33
  743. package/src/network/peers/utils/index.ts +0 -4
  744. package/src/network/peers/utils/prioritizePeers.ts +0 -627
  745. package/src/network/peers/utils/subnetMap.ts +0 -88
  746. package/src/network/processor/aggregatorTracker.ts +0 -38
  747. package/src/network/processor/extractSlotRootFns.ts +0 -64
  748. package/src/network/processor/gossipHandlers.ts +0 -951
  749. package/src/network/processor/gossipQueues/index.ts +0 -114
  750. package/src/network/processor/gossipQueues/indexed.ts +0 -219
  751. package/src/network/processor/gossipQueues/linear.ts +0 -162
  752. package/src/network/processor/gossipQueues/types.ts +0 -57
  753. package/src/network/processor/gossipValidatorFn.ts +0 -142
  754. package/src/network/processor/index.ts +0 -497
  755. package/src/network/processor/types.ts +0 -27
  756. package/src/network/reqresp/ReqRespBeaconNode.ts +0 -373
  757. package/src/network/reqresp/handlers/beaconBlocksByRange.ts +0 -101
  758. package/src/network/reqresp/handlers/beaconBlocksByRoot.ts +0 -49
  759. package/src/network/reqresp/handlers/blobSidecarsByRange.ts +0 -114
  760. package/src/network/reqresp/handlers/blobSidecarsByRoot.ts +0 -62
  761. package/src/network/reqresp/handlers/dataColumnSidecarsByRange.ts +0 -144
  762. package/src/network/reqresp/handlers/dataColumnSidecarsByRoot.ts +0 -88
  763. package/src/network/reqresp/handlers/index.ts +0 -78
  764. package/src/network/reqresp/handlers/lightClientBootstrap.ts +0 -31
  765. package/src/network/reqresp/handlers/lightClientFinalityUpdate.ts +0 -21
  766. package/src/network/reqresp/handlers/lightClientOptimisticUpdate.ts +0 -21
  767. package/src/network/reqresp/handlers/lightClientUpdatesByRange.ts +0 -39
  768. package/src/network/reqresp/index.ts +0 -2
  769. package/src/network/reqresp/interface.ts +0 -45
  770. package/src/network/reqresp/protocols.ts +0 -146
  771. package/src/network/reqresp/rateLimit.ts +0 -112
  772. package/src/network/reqresp/score.ts +0 -70
  773. package/src/network/reqresp/types.ts +0 -174
  774. package/src/network/reqresp/utils/collect.ts +0 -84
  775. package/src/network/reqresp/utils/collectSequentialBlocksInRange.ts +0 -57
  776. package/src/network/reqresp/utils/dataColumnResponseValidation.ts +0 -99
  777. package/src/network/statusCache.ts +0 -17
  778. package/src/network/subnets/attnetsService.ts +0 -385
  779. package/src/network/subnets/index.ts +0 -2
  780. package/src/network/subnets/interface.ts +0 -66
  781. package/src/network/subnets/syncnetsService.ts +0 -147
  782. package/src/network/subnets/util.ts +0 -63
  783. package/src/network/util.ts +0 -29
  784. package/src/node/index.ts +0 -2
  785. package/src/node/nodejs.ts +0 -349
  786. package/src/node/notifier.ts +0 -206
  787. package/src/node/options.ts +0 -51
  788. package/src/node/utils/interop/deposits.ts +0 -53
  789. package/src/node/utils/interop/state.ts +0 -59
  790. package/src/node/utils/lightclient.ts +0 -7
  791. package/src/node/utils/state.ts +0 -37
  792. package/src/sync/backfill/backfill.ts +0 -893
  793. package/src/sync/backfill/errors.ts +0 -23
  794. package/src/sync/backfill/index.ts +0 -1
  795. package/src/sync/backfill/verify.ts +0 -58
  796. package/src/sync/constants.ts +0 -71
  797. package/src/sync/index.ts +0 -2
  798. package/src/sync/interface.ts +0 -55
  799. package/src/sync/options.ts +0 -45
  800. package/src/sync/range/batch.ts +0 -455
  801. package/src/sync/range/chain.ts +0 -715
  802. package/src/sync/range/range.ts +0 -354
  803. package/src/sync/range/utils/batches.ts +0 -119
  804. package/src/sync/range/utils/chainTarget.ts +0 -62
  805. package/src/sync/range/utils/hashBlocks.ts +0 -27
  806. package/src/sync/range/utils/index.ts +0 -5
  807. package/src/sync/range/utils/peerBalancer.ts +0 -184
  808. package/src/sync/range/utils/updateChains.ts +0 -66
  809. package/src/sync/sync.ts +0 -290
  810. package/src/sync/types.ts +0 -59
  811. package/src/sync/unknownBlock.ts +0 -862
  812. package/src/sync/utils/downloadByRange.ts +0 -808
  813. package/src/sync/utils/downloadByRoot.ts +0 -560
  814. package/src/sync/utils/pendingBlocksTree.ts +0 -97
  815. package/src/sync/utils/remoteSyncType.ts +0 -144
  816. package/src/util/address.ts +0 -3
  817. package/src/util/array.ts +0 -311
  818. package/src/util/asyncIterableToEvents.ts +0 -164
  819. package/src/util/binarySearch.ts +0 -48
  820. package/src/util/bitArray.ts +0 -84
  821. package/src/util/blobs.ts +0 -210
  822. package/src/util/bufferPool.ts +0 -95
  823. package/src/util/bytes.ts +0 -11
  824. package/src/util/chunkify.ts +0 -27
  825. package/src/util/clock.ts +0 -204
  826. package/src/util/dataColumns.ts +0 -415
  827. package/src/util/dependentRoot.ts +0 -47
  828. package/src/util/enum.ts +0 -17
  829. package/src/util/error.ts +0 -56
  830. package/src/util/eventLoop.ts +0 -22
  831. package/src/util/execution.ts +0 -223
  832. package/src/util/file.ts +0 -52
  833. package/src/util/forkChoice.ts +0 -5
  834. package/src/util/forkName.ts +0 -20
  835. package/src/util/graffiti.ts +0 -39
  836. package/src/util/hex.ts +0 -9
  837. package/src/util/index.ts +0 -2
  838. package/src/util/ip.ts +0 -6
  839. package/src/util/itTrigger.ts +0 -49
  840. package/src/util/kzg.ts +0 -3
  841. package/src/util/map.ts +0 -77
  842. package/src/util/metadata.ts +0 -22
  843. package/src/util/multifork.ts +0 -69
  844. package/src/util/numpy.ts +0 -8
  845. package/src/util/peerId.ts +0 -16
  846. package/src/util/profile.ts +0 -54
  847. package/src/util/promises.ts +0 -14
  848. package/src/util/queue/errors.ts +0 -14
  849. package/src/util/queue/fnQueue.ts +0 -16
  850. package/src/util/queue/index.ts +0 -4
  851. package/src/util/queue/itemQueue.ts +0 -128
  852. package/src/util/queue/options.ts +0 -37
  853. package/src/util/serializedCache.ts +0 -20
  854. package/src/util/set.ts +0 -62
  855. package/src/util/shuffle.ts +0 -21
  856. package/src/util/sortBy.ts +0 -19
  857. package/src/util/sszBytes.ts +0 -481
  858. package/src/util/strictEvents.ts +0 -8
  859. package/src/util/time.ts +0 -13
  860. package/src/util/timeSeries.ts +0 -118
  861. package/src/util/types.ts +0 -31
  862. package/src/util/workerEvents.ts +0 -142
  863. package/src/util/wrapError.ts +0 -27
@@ -1,1299 +0,0 @@
1
- import {ChainConfig, ChainForkConfig} from "@lodestar/config";
2
- import {ForkSeq, INTERVALS_PER_SLOT, MIN_ATTESTATION_INCLUSION_DELAY, SLOTS_PER_EPOCH} from "@lodestar/params";
3
- import {
4
- CachedBeaconStateAllForks,
5
- CachedBeaconStateAltair,
6
- ParticipationFlags,
7
- computeEpochAtSlot,
8
- computeStartSlotAtEpoch,
9
- getBlockRootAtSlot,
10
- getCurrentSlot,
11
- parseAttesterFlags,
12
- parseParticipationFlags,
13
- } from "@lodestar/state-transition";
14
- import {
15
- BeaconBlock,
16
- Epoch,
17
- IndexedAttestation,
18
- RootHex,
19
- SignedAggregateAndProof,
20
- Slot,
21
- SubnetID,
22
- ValidatorIndex,
23
- altair,
24
- deneb,
25
- } from "@lodestar/types";
26
- import {LogData, LogHandler, LogLevel, Logger, MapDef, MapDefMax, toRootHex} from "@lodestar/utils";
27
- import {GENESIS_SLOT} from "../constants/constants.js";
28
- import {RegistryMetricCreator} from "../metrics/index.js";
29
-
30
- /** The validator monitor collects per-epoch data about each monitored validator.
31
- * Historical data will be kept around for `HISTORIC_EPOCHS` before it is pruned.
32
- */
33
- const MAX_CACHED_EPOCHS = 4;
34
-
35
- const MAX_CACHED_DISTINCT_TARGETS = 4;
36
-
37
- const INTERVALS_LATE_ATTESTATION_SUBMISSION = 1.5;
38
- const INTERVALS_LATE_BLOCK_SUBMISSION = 0.75;
39
-
40
- const RETAIN_REGISTERED_VALIDATORS_MS = 1 * 3600 * 1000; // 1 hour
41
-
42
- type Seconds = number;
43
- export enum OpSource {
44
- api = "api",
45
- gossip = "gossip",
46
- }
47
-
48
- export type ValidatorMonitor = {
49
- registerLocalValidator(index: number): void;
50
- registerLocalValidatorInSyncCommittee(index: number, untilEpoch: Epoch): void;
51
- registerValidatorStatuses(
52
- currentEpoch: Epoch,
53
- inclusionDelays: number[],
54
- flags: number[],
55
- isActiveCurrEpoch: boolean[],
56
- isActivePrevEpoch: boolean[],
57
- balances?: number[]
58
- ): void;
59
- registerBeaconBlock(src: OpSource, delaySec: Seconds, block: BeaconBlock): void;
60
- registerBlobSidecar(src: OpSource, seenTimestampSec: Seconds, blob: deneb.BlobSidecar): void;
61
- registerImportedBlock(block: BeaconBlock, data: {proposerBalanceDelta: number}): void;
62
- onPoolSubmitUnaggregatedAttestation(
63
- seenTimestampSec: number,
64
- indexedAttestation: IndexedAttestation,
65
- subnet: SubnetID,
66
- sentPeers: number
67
- ): void;
68
- onPoolSubmitAggregatedAttestation(
69
- seenTimestampSec: number,
70
- indexedAttestation: IndexedAttestation,
71
- sentPeers: number
72
- ): void;
73
- registerGossipUnaggregatedAttestation(seenTimestampSec: Seconds, indexedAttestation: IndexedAttestation): void;
74
- registerGossipAggregatedAttestation(
75
- seenTimestampSec: Seconds,
76
- signedAggregateAndProof: SignedAggregateAndProof,
77
- indexedAttestation: IndexedAttestation
78
- ): void;
79
- registerAttestationInBlock(
80
- indexedAttestation: IndexedAttestation,
81
- parentSlot: Slot,
82
- correctHead: boolean,
83
- missedSlotVote: boolean,
84
- inclusionBlockRoot: RootHex,
85
- inclusionBlockSlot: Slot
86
- ): void;
87
- registerGossipSyncContributionAndProof(
88
- syncContributionAndProof: altair.ContributionAndProof,
89
- syncCommitteeParticipantIndices: ValidatorIndex[]
90
- ): void;
91
- registerSyncAggregateInBlock(
92
- epoch: Epoch,
93
- syncAggregate: altair.SyncAggregate,
94
- syncCommitteeIndices: Uint32Array
95
- ): void;
96
- onceEveryEndOfEpoch(state: CachedBeaconStateAllForks): void;
97
- scrapeMetrics(slotClock: Slot): void;
98
- };
99
-
100
- export type ValidatorMonitorOpts = {
101
- /** Log validator monitor events as info */
102
- validatorMonitorLogs?: boolean;
103
- };
104
-
105
- export const defaultValidatorMonitorOpts: ValidatorMonitorOpts = {
106
- validatorMonitorLogs: false,
107
- };
108
-
109
- /** Information required to reward some validator during the current and previous epoch. */
110
- type ValidatorStatus = {
111
- /** True if the validator has been slashed, ever. */
112
- isSlashed: boolean;
113
- /** True if the validator was active in the state's _current_ epoch. */
114
- isActiveInCurrentEpoch: boolean;
115
- /** True if the validator was active in the state's _previous_ epoch. */
116
- isActiveInPreviousEpoch: boolean;
117
- /** The validator's effective balance in the _current_ epoch. */
118
- currentEpochEffectiveBalance: number;
119
-
120
- /** True if the validator had an attestation included in the _previous_ epoch. */
121
- isPrevSourceAttester: boolean;
122
- /** True if the validator's beacon block root attestation for the first slot of the _previous_
123
- epoch matches the block root known to the state. */
124
- isPrevTargetAttester: boolean;
125
- /** True if the validator's beacon block root attestation in the _previous_ epoch at the
126
- attestation's slot (`attestation_data.slot`) matches the block root known to the state. */
127
- isPrevHeadAttester: boolean;
128
-
129
- /** True if the validator had an attestation included in the _current_ epoch. */
130
- isCurrSourceAttester: boolean;
131
- /** True if the validator's beacon block root attestation for the first slot of the _current_
132
- epoch matches the block root known to the state. */
133
- isCurrTargetAttester: boolean;
134
- /** True if the validator's beacon block root attestation in the _current_ epoch at the
135
- attestation's slot (`attestation_data.slot`) matches the block root known to the state. */
136
- isCurrHeadAttester: boolean;
137
-
138
- /** The distance between the attestation slot and the slot that attestation was included in a block. */
139
- inclusionDistance: number;
140
- };
141
-
142
- function statusToSummary(
143
- inclusionDelay: number,
144
- flag: number,
145
- isActiveInCurrentEpoch: boolean,
146
- isActiveInPreviousEpoch: boolean
147
- ): ValidatorStatus {
148
- const flags = parseAttesterFlags(flag);
149
- return {
150
- isSlashed: flags.unslashed,
151
- isActiveInCurrentEpoch,
152
- isActiveInPreviousEpoch,
153
- // TODO: Implement
154
- currentEpochEffectiveBalance: 0,
155
-
156
- isPrevSourceAttester: flags.prevSourceAttester,
157
- isPrevTargetAttester: flags.prevTargetAttester,
158
- isPrevHeadAttester: flags.prevHeadAttester,
159
- isCurrSourceAttester: flags.currSourceAttester,
160
- isCurrTargetAttester: flags.currTargetAttester,
161
- isCurrHeadAttester: flags.currHeadAttester,
162
- inclusionDistance: inclusionDelay,
163
- };
164
- }
165
-
166
- /** Contains data pertaining to one validator for one epoch. */
167
- type EpochSummary = {
168
- // Attestations with a target in the current epoch.
169
- /** The number of attestations seen. */
170
- attestations: number;
171
- /** The delay between when the attestation should have been produced and when it was observed. */
172
- attestationMinDelay: Seconds | null;
173
- /** The number of times a validators attestation was seen in an aggregate. */
174
- attestationAggregateInclusions: number;
175
- /** The number of times a validators attestation was seen in a block. */
176
- attestationBlockInclusions: number;
177
- /** The minimum observed inclusion distance for an attestation for this epoch.. */
178
- attestationMinBlockInclusionDistance: Slot | null;
179
- /** The attestation contains the correct head or not */
180
- attestationCorrectHead: boolean | null;
181
- // Blocks with a slot in the current epoch.
182
- /** The number of blocks observed. */
183
- blocks: number;
184
- /** The delay between when the block should have been produced and when it was observed. */
185
- blockMinDelay: Seconds | null;
186
- // Aggregates with a target in the current epoch
187
- /** The number of signed aggregate and proofs observed. */
188
- aggregates: number;
189
- /** The delay between when the aggregate should have been produced and when it was observed. */
190
- aggregateMinDelay: Seconds | null;
191
- /** Count of times validator expected in sync aggregate participated */
192
- syncCommitteeHits: number;
193
- /** Count of times validator expected in sync aggregate failed to participate */
194
- syncCommitteeMisses: number;
195
- /** Number of times a validator's sync signature was seen in an aggregate */
196
- syncSignatureAggregateInclusions: number;
197
- /** Submitted proposals from this validator at this epoch */
198
- blockProposals: BlockProposals[];
199
- };
200
-
201
- type BlockProposals = {
202
- blockRoot: RootHex;
203
- blockSlot: Slot;
204
- poolSubmitDelaySec: number | null;
205
- successfullyImported: boolean;
206
- };
207
-
208
- function getEpochSummary(validator: MonitoredValidator, epoch: Epoch): EpochSummary {
209
- let summary = validator.summaries.get(epoch);
210
- if (!summary) {
211
- summary = {
212
- attestations: 0,
213
- attestationMinDelay: null,
214
- attestationAggregateInclusions: 0,
215
- attestationBlockInclusions: 0,
216
- attestationMinBlockInclusionDistance: null,
217
- blocks: 0,
218
- blockMinDelay: null,
219
- aggregates: 0,
220
- aggregateMinDelay: null,
221
- attestationCorrectHead: null,
222
- syncCommitteeHits: 0,
223
- syncCommitteeMisses: 0,
224
- syncSignatureAggregateInclusions: 0,
225
- blockProposals: [],
226
- };
227
- validator.summaries.set(epoch, summary);
228
- }
229
-
230
- // Prune
231
- const toPrune = validator.summaries.size - MAX_CACHED_EPOCHS;
232
- if (toPrune > 0) {
233
- let pruned = 0;
234
- for (const idx of validator.summaries.keys()) {
235
- validator.summaries.delete(idx);
236
- if (++pruned >= toPrune) break;
237
- }
238
- }
239
-
240
- return summary;
241
- }
242
-
243
- // To uniquely identify an attestation:
244
- // `index=$validator_index target=$target_epoch:$target_root
245
- type AttestationSummary = {
246
- poolSubmitDelayMinSec: number | null;
247
- poolSubmitSentPeers: number | null;
248
- aggregateInclusionDelaysSec: number[];
249
- blockInclusions: AttestationBlockInclusion[];
250
- };
251
-
252
- type AttestationBlockInclusion = {
253
- blockRoot: RootHex;
254
- blockSlot: Slot;
255
- votedCorrectHeadRoot: boolean;
256
- votedForMissedSlot: boolean;
257
- attestationSlot: Slot;
258
- };
259
-
260
- /** `$target_epoch:$target_root` */
261
- type TargetRoot = string;
262
-
263
- /// A validator that is being monitored by the `ValidatorMonitor`. */
264
- type MonitoredValidator = {
265
- /// A history of the validator over time. */
266
- summaries: Map<Epoch, EpochSummary>;
267
- inSyncCommitteeUntilEpoch: number;
268
- // Unless the validator slashes itself, there MUST be one attestation per target checkpoint
269
- attestations: MapDefMax<Epoch, MapDefMax<TargetRoot, AttestationSummary>>;
270
- lastRegisteredTimeMs: number;
271
- };
272
-
273
- export function createValidatorMonitor(
274
- metricsRegister: RegistryMetricCreator | null,
275
- config: ChainForkConfig,
276
- genesisTime: number,
277
- logger: Logger,
278
- opts: ValidatorMonitorOpts
279
- ): ValidatorMonitor {
280
- const logLevel = opts.validatorMonitorLogs ? LogLevel.info : LogLevel.debug;
281
- const log: LogHandler = (message: string, context?: LogData) => {
282
- logger[logLevel](message, context);
283
- };
284
-
285
- /** The validators that require additional monitoring. */
286
- const validators = new MapDef<ValidatorIndex, MonitoredValidator>(() => ({
287
- summaries: new Map<Epoch, EpochSummary>(),
288
- inSyncCommitteeUntilEpoch: -1,
289
- attestations: new MapDefMax(
290
- () =>
291
- new MapDefMax(
292
- () => ({
293
- poolSubmitDelayMinSec: null,
294
- poolSubmitSentPeers: null,
295
- aggregateInclusionDelaysSec: [],
296
- blockInclusions: [],
297
- }),
298
- MAX_CACHED_DISTINCT_TARGETS
299
- ),
300
- MAX_CACHED_EPOCHS
301
- ),
302
- lastRegisteredTimeMs: 0,
303
- }));
304
-
305
- let lastRegisteredStatusEpoch = -1;
306
-
307
- const validatorMonitorMetrics = metricsRegister ? createValidatorMonitorMetrics(metricsRegister) : null;
308
-
309
- const validatorMonitor: ValidatorMonitor = {
310
- registerLocalValidator(index) {
311
- validators.getOrDefault(index).lastRegisteredTimeMs = Date.now();
312
- },
313
-
314
- registerLocalValidatorInSyncCommittee(index, untilEpoch) {
315
- const validator = validators.get(index);
316
- if (validator) {
317
- validator.inSyncCommitteeUntilEpoch = Math.max(untilEpoch, validator.inSyncCommitteeUntilEpoch ?? -1);
318
- }
319
- },
320
-
321
- registerValidatorStatuses(currentEpoch, inclusionDelays, flags, isActiveCurrEpoch, isActiveInPrevEpoch, balances) {
322
- // Prevent registering status for the same epoch twice. processEpoch() may be ran more than once for the same epoch.
323
- if (currentEpoch <= lastRegisteredStatusEpoch) {
324
- return;
325
- }
326
- lastRegisteredStatusEpoch = currentEpoch;
327
- const previousEpoch = currentEpoch - 1;
328
-
329
- // There won't be any validator activity in epoch -1
330
- if (previousEpoch === -1) {
331
- return;
332
- }
333
-
334
- for (const [index, monitoredValidator] of validators.entries()) {
335
- // We subtract two from the state of the epoch that generated these summaries.
336
- //
337
- // - One to account for it being the previous epoch.
338
- // - One to account for the state advancing an epoch whilst generating the validator
339
- // statuses.
340
- const summary = statusToSummary(
341
- inclusionDelays[index],
342
- flags[index],
343
- isActiveCurrEpoch[index],
344
- isActiveInPrevEpoch[index]
345
- );
346
-
347
- if (summary.isPrevSourceAttester) {
348
- validatorMonitorMetrics?.prevEpochOnChainSourceAttesterHit.inc();
349
- } else {
350
- validatorMonitorMetrics?.prevEpochOnChainSourceAttesterMiss.inc();
351
- }
352
- if (summary.isPrevHeadAttester) {
353
- validatorMonitorMetrics?.prevEpochOnChainHeadAttesterHit.inc();
354
- } else {
355
- validatorMonitorMetrics?.prevEpochOnChainHeadAttesterMiss.inc();
356
- }
357
- if (summary.isPrevTargetAttester) {
358
- validatorMonitorMetrics?.prevEpochOnChainTargetAttesterHit.inc();
359
- } else {
360
- validatorMonitorMetrics?.prevEpochOnChainTargetAttesterMiss.inc();
361
- }
362
-
363
- const prevEpochSummary = monitoredValidator.summaries.get(previousEpoch);
364
- const attestationCorrectHead = prevEpochSummary?.attestationCorrectHead;
365
- if (attestationCorrectHead !== null && attestationCorrectHead !== undefined) {
366
- if (attestationCorrectHead) {
367
- validatorMonitorMetrics?.prevOnChainAttesterCorrectHead.inc();
368
- } else {
369
- validatorMonitorMetrics?.prevOnChainAttesterIncorrectHead.inc();
370
- }
371
- }
372
-
373
- const attestationMinBlockInclusionDistance = prevEpochSummary?.attestationMinBlockInclusionDistance;
374
- const inclusionDistance =
375
- attestationMinBlockInclusionDistance != null && attestationMinBlockInclusionDistance > 0
376
- ? // altair, attestation is not missed
377
- attestationMinBlockInclusionDistance
378
- : summary.inclusionDistance
379
- ? // phase0, this is from the state transition
380
- summary.inclusionDistance
381
- : null;
382
-
383
- if (inclusionDistance !== null) {
384
- validatorMonitorMetrics?.prevEpochOnChainInclusionDistance.observe(inclusionDistance);
385
- validatorMonitorMetrics?.prevEpochOnChainAttesterHit.inc();
386
- } else {
387
- validatorMonitorMetrics?.prevEpochOnChainAttesterMiss.inc();
388
- }
389
-
390
- const balance = balances?.[index];
391
- if (balance !== undefined) {
392
- validatorMonitorMetrics?.prevEpochOnChainBalance.set({index}, balance);
393
- }
394
-
395
- if (!summary.isPrevSourceAttester || !summary.isPrevTargetAttester || !summary.isPrevHeadAttester) {
396
- log("Failed attestation in previous epoch", {
397
- validator: index,
398
- prevEpoch: currentEpoch - 1,
399
- isPrevSourceAttester: summary.isPrevSourceAttester,
400
- isPrevHeadAttester: summary.isPrevHeadAttester,
401
- isPrevTargetAttester: summary.isPrevTargetAttester,
402
- // inclusionDistance is not available in summary since altair
403
- inclusionDistance,
404
- });
405
- }
406
- }
407
- },
408
-
409
- registerBeaconBlock(src, delaySec, block) {
410
- const validator = validators.get(block.proposerIndex);
411
- // Returns the delay between the start of `block.slot` and `seenTimestamp`.
412
- if (validator) {
413
- validatorMonitorMetrics?.beaconBlockTotal.inc({src});
414
- validatorMonitorMetrics?.beaconBlockDelaySeconds.observe({src}, delaySec);
415
-
416
- const summary = getEpochSummary(validator, computeEpochAtSlot(block.slot));
417
- summary.blockProposals.push({
418
- blockRoot: toRootHex(config.getForkTypes(block.slot).BeaconBlock.hashTreeRoot(block)),
419
- blockSlot: block.slot,
420
- poolSubmitDelaySec: delaySec,
421
- successfullyImported: false,
422
- });
423
- }
424
- },
425
-
426
- registerBlobSidecar(_src, _seenTimestampSec, _blob) {
427
- //TODO: freetheblobs
428
- },
429
-
430
- registerImportedBlock(block, {proposerBalanceDelta}) {
431
- const validator = validators.get(block.proposerIndex);
432
- if (validator) {
433
- validatorMonitorMetrics?.proposerBalanceDeltaKnown.observe(proposerBalanceDelta);
434
-
435
- // There should be alredy a summary for the block. Could be missing when using one VC multiple BNs
436
- const summary = getEpochSummary(validator, computeEpochAtSlot(block.slot));
437
- const proposal = summary.blockProposals.find((p) => p.blockSlot === block.slot);
438
- if (proposal) {
439
- proposal.successfullyImported = true;
440
- } else {
441
- summary.blockProposals.push({
442
- blockRoot: toRootHex(config.getForkTypes(block.slot).BeaconBlock.hashTreeRoot(block)),
443
- blockSlot: block.slot,
444
- poolSubmitDelaySec: null,
445
- successfullyImported: true,
446
- });
447
- }
448
- }
449
- },
450
-
451
- onPoolSubmitUnaggregatedAttestation(seenTimestampSec, indexedAttestation, subnet, sentPeers) {
452
- const data = indexedAttestation.data;
453
- // Returns the duration between when the attestation `data` could be produced (1/3rd through the slot) and `seenTimestamp`.
454
- const delaySec = seenTimestampSec - (genesisTime + (data.slot + 1 / 3) * config.SECONDS_PER_SLOT);
455
- for (const index of indexedAttestation.attestingIndices) {
456
- const validator = validators.get(index);
457
- if (validator) {
458
- validatorMonitorMetrics?.unaggregatedAttestationSubmittedSentPeers.observe(sentPeers);
459
- validatorMonitorMetrics?.unaggregatedAttestationDelaySeconds.observe({src: OpSource.api}, delaySec);
460
- log("Published unaggregated attestation", {
461
- validator: index,
462
- slot: data.slot,
463
- committeeIndex: data.index,
464
- subnet,
465
- sentPeers,
466
- delaySec: delaySec.toFixed(4),
467
- });
468
-
469
- const attestationSummary = validator.attestations
470
- .getOrDefault(indexedAttestation.data.target.epoch)
471
- .getOrDefault(toRootHex(indexedAttestation.data.target.root));
472
- if (
473
- attestationSummary.poolSubmitDelayMinSec === null ||
474
- attestationSummary.poolSubmitDelayMinSec > delaySec
475
- ) {
476
- attestationSummary.poolSubmitDelayMinSec = delaySec;
477
- }
478
- }
479
- }
480
- },
481
-
482
- registerGossipUnaggregatedAttestation(seenTimestampSec, indexedAttestation) {
483
- const src = OpSource.gossip;
484
- const data = indexedAttestation.data;
485
- const epoch = computeEpochAtSlot(data.slot);
486
- // Returns the duration between when the attestation `data` could be produced (1/3rd through the slot) and `seenTimestamp`.
487
- const delaySec = seenTimestampSec - (genesisTime + (data.slot + 1 / 3) * config.SECONDS_PER_SLOT);
488
-
489
- for (const index of indexedAttestation.attestingIndices) {
490
- const validator = validators.get(index);
491
- if (validator) {
492
- validatorMonitorMetrics?.unaggregatedAttestationTotal.inc({src});
493
- validatorMonitorMetrics?.unaggregatedAttestationDelaySeconds.observe({src}, delaySec);
494
- const summary = getEpochSummary(validator, epoch);
495
- summary.attestations += 1;
496
- summary.attestationMinDelay = Math.min(delaySec, summary.attestationMinDelay ?? Infinity);
497
- }
498
- }
499
- },
500
-
501
- onPoolSubmitAggregatedAttestation(seenTimestampSec, indexedAttestation, sentPeers) {
502
- const data = indexedAttestation.data;
503
- // Returns the duration between when a `AggregateAndproof` with `data` could be produced (2/3rd through the slot) and `seenTimestamp`.
504
- const delaySec = seenTimestampSec - (genesisTime + (data.slot + 2 / 3) * config.SECONDS_PER_SLOT);
505
-
506
- for (const index of indexedAttestation.attestingIndices) {
507
- const validator = validators.get(index);
508
- if (validator) {
509
- validatorMonitorMetrics?.aggregatedAttestationDelaySeconds.observe({src: OpSource.api}, delaySec);
510
- log("Published aggregated attestation", {
511
- validator: index,
512
- slot: data.slot,
513
- committeeIndex: data.index,
514
- sentPeers,
515
- delaySec: delaySec.toFixed(4),
516
- });
517
-
518
- validator.attestations
519
- .getOrDefault(indexedAttestation.data.target.epoch)
520
- .getOrDefault(toRootHex(indexedAttestation.data.target.root))
521
- .aggregateInclusionDelaysSec.push(delaySec);
522
- }
523
- }
524
- },
525
-
526
- registerGossipAggregatedAttestation(seenTimestampSec, signedAggregateAndProof, indexedAttestation) {
527
- const src = OpSource.gossip;
528
- const data = indexedAttestation.data;
529
- const epoch = computeEpochAtSlot(data.slot);
530
- // Returns the duration between when a `AggregateAndProof` with `data` could be produced (2/3rd through the slot) and `seenTimestamp`.
531
- const delaySec = seenTimestampSec - (genesisTime + (data.slot + 2 / 3) * config.SECONDS_PER_SLOT);
532
-
533
- const aggregatorIndex = signedAggregateAndProof.message.aggregatorIndex;
534
- const validatorAggregator = validators.get(aggregatorIndex);
535
- if (validatorAggregator) {
536
- validatorMonitorMetrics?.aggregatedAttestationTotal.inc({src});
537
- validatorMonitorMetrics?.aggregatedAttestationDelaySeconds.observe({src}, delaySec);
538
- const summary = getEpochSummary(validatorAggregator, epoch);
539
- summary.aggregates += 1;
540
- summary.aggregateMinDelay = Math.min(delaySec, summary.aggregateMinDelay ?? Infinity);
541
- }
542
-
543
- for (const index of indexedAttestation.attestingIndices) {
544
- const validator = validators.get(index);
545
- if (validator) {
546
- validatorMonitorMetrics?.attestationInAggregateTotal.inc({src});
547
- validatorMonitorMetrics?.attestationInAggregateDelaySeconds.observe({src}, delaySec);
548
- const summary = getEpochSummary(validator, epoch);
549
- summary.attestationAggregateInclusions += 1;
550
- log("Attestation is included in aggregate", {
551
- validator: index,
552
- slot: data.slot,
553
- committeeIndex: data.index,
554
- aggregatorIndex,
555
- });
556
-
557
- validator.attestations
558
- .getOrDefault(indexedAttestation.data.target.epoch)
559
- .getOrDefault(toRootHex(indexedAttestation.data.target.root))
560
- .aggregateInclusionDelaysSec.push(delaySec);
561
- }
562
- }
563
- },
564
-
565
- // Register that the `indexed_attestation` was included in a *valid* `BeaconBlock`.
566
- registerAttestationInBlock(
567
- indexedAttestation,
568
- parentSlot,
569
- correctHead,
570
- missedSlotVote,
571
- inclusionBlockRoot,
572
- inclusionBlockSlot
573
- ): void {
574
- const data = indexedAttestation.data;
575
- // optimal inclusion distance, not to count skipped slots between data.slot and blockSlot
576
- const inclusionDistance = Math.max(parentSlot - data.slot, 0) + 1;
577
- const delay = inclusionDistance - MIN_ATTESTATION_INCLUSION_DELAY;
578
- const epoch = computeEpochAtSlot(data.slot);
579
- const participants = indexedAttestation.attestingIndices.length;
580
-
581
- for (const index of indexedAttestation.attestingIndices) {
582
- const validator = validators.get(index);
583
- if (validator) {
584
- validatorMonitorMetrics?.attestationInBlockTotal.inc();
585
- validatorMonitorMetrics?.attestationInBlockDelaySlots.observe(delay);
586
- validatorMonitorMetrics?.attestationInBlockParticipants.observe(participants);
587
-
588
- const summary = getEpochSummary(validator, epoch);
589
- summary.attestationBlockInclusions += 1;
590
- if (summary.attestationMinBlockInclusionDistance !== null) {
591
- summary.attestationMinBlockInclusionDistance = Math.min(
592
- summary.attestationMinBlockInclusionDistance,
593
- inclusionDistance
594
- );
595
- } else {
596
- summary.attestationMinBlockInclusionDistance = inclusionDistance;
597
- }
598
-
599
- summary.attestationCorrectHead = correctHead;
600
-
601
- validator.attestations
602
- .getOrDefault(indexedAttestation.data.target.epoch)
603
- .getOrDefault(toRootHex(indexedAttestation.data.target.root))
604
- .blockInclusions.push({
605
- blockRoot: inclusionBlockRoot,
606
- blockSlot: inclusionBlockSlot,
607
- votedCorrectHeadRoot: correctHead,
608
- votedForMissedSlot: missedSlotVote,
609
- attestationSlot: indexedAttestation.data.slot,
610
- });
611
-
612
- log("Attestation is included in block", {
613
- validator: index,
614
- slot: data.slot,
615
- committeeIndex: data.index,
616
- inclusionDistance,
617
- correctHead,
618
- participants,
619
- });
620
- }
621
- }
622
- },
623
-
624
- registerGossipSyncContributionAndProof(syncContributionAndProof, syncCommitteeParticipantIndices) {
625
- const epoch = computeEpochAtSlot(syncContributionAndProof.contribution.slot);
626
-
627
- for (const index of syncCommitteeParticipantIndices) {
628
- const validator = validators.get(index);
629
- if (validator) {
630
- validatorMonitorMetrics?.syncSignatureInAggregateTotal.inc();
631
-
632
- const summary = getEpochSummary(validator, epoch);
633
- summary.syncSignatureAggregateInclusions += 1;
634
- }
635
- }
636
- },
637
-
638
- registerSyncAggregateInBlock(epoch, syncAggregate, syncCommitteeIndices) {
639
- for (let i = 0; i < syncCommitteeIndices.length; i++) {
640
- const validator = validators.get(syncCommitteeIndices[i]);
641
- if (validator) {
642
- const summary = getEpochSummary(validator, epoch);
643
- if (syncAggregate.syncCommitteeBits.get(i)) {
644
- summary.syncCommitteeHits++;
645
- } else {
646
- summary.syncCommitteeMisses++;
647
- }
648
- }
649
- }
650
- },
651
-
652
- // Validator monitor tracks performance of validators in healthy network conditions.
653
- // It does not attempt to track correctly duties on forking conditions deeper than 1 epoch.
654
- // To guard against short re-orgs it will track the status of epoch N at the end of epoch N+1.
655
- // This function **SHOULD** be called at the last slot of an epoch to have max possible information.
656
- onceEveryEndOfEpoch(headState) {
657
- if (headState.slot <= GENESIS_SLOT) {
658
- // Before genesis, there won't be any validator activity
659
- return;
660
- }
661
-
662
- // Prune validators not seen in a while
663
- for (const [index, validator] of validators.entries()) {
664
- if (Date.now() - validator.lastRegisteredTimeMs > RETAIN_REGISTERED_VALIDATORS_MS) {
665
- validators.delete(index);
666
- }
667
- }
668
-
669
- // Compute summaries of previous epoch attestation performance
670
- const prevEpoch = computeEpochAtSlot(headState.slot) - 1;
671
-
672
- // During the end of first epoch, the prev epoch with be -1
673
- // Skip this as there is no attestation and block proposal summary in epoch -1
674
- if (prevEpoch === -1) {
675
- return;
676
- }
677
-
678
- const rootCache = new RootHexCache(headState);
679
-
680
- if (config.getForkSeq(headState.slot) >= ForkSeq.altair) {
681
- const {previousEpochParticipation} = headState as CachedBeaconStateAltair;
682
- const prevEpochStartSlot = computeStartSlotAtEpoch(prevEpoch);
683
- const prevEpochTargetRoot = toRootHex(getBlockRootAtSlot(headState, prevEpochStartSlot));
684
-
685
- // Check attestation performance
686
- for (const [index, validator] of validators.entries()) {
687
- const flags = parseParticipationFlags(previousEpochParticipation.get(index));
688
- const attestationSummary = validator.attestations.get(prevEpoch)?.get(prevEpochTargetRoot);
689
- const summary = renderAttestationSummary(config, rootCache, attestationSummary, flags);
690
- validatorMonitorMetrics?.prevEpochAttestationSummary.inc({summary});
691
- log("Previous epoch attestation", {
692
- validator: index,
693
- epoch: prevEpoch,
694
- summary,
695
- });
696
- }
697
- }
698
-
699
- if (headState.epochCtx.proposersPrevEpoch !== null) {
700
- // proposersPrevEpoch is null on the first epoch of `headState` being generated
701
- for (const [slotIndex, validatorIndex] of headState.epochCtx.proposersPrevEpoch.entries()) {
702
- const validator = validators.get(validatorIndex);
703
- if (validator) {
704
- // If expected proposer is a tracked validator
705
- const epochSummary = validator.summaries.get(prevEpoch);
706
- const proposalSlot = SLOTS_PER_EPOCH * prevEpoch + slotIndex;
707
- const summary = renderBlockProposalSummary(config, rootCache, epochSummary, proposalSlot);
708
- validatorMonitorMetrics?.prevEpochBlockProposalSummary.inc({summary});
709
- log("Previous epoch block proposal", {
710
- validator: validatorIndex,
711
- slot: proposalSlot,
712
- epoch: prevEpoch,
713
- summary,
714
- });
715
- }
716
- }
717
- }
718
- },
719
-
720
- /**
721
- * Scrape `self` for metrics.
722
- * Should be called whenever Prometheus is scraping.
723
- */
724
- scrapeMetrics(slotClock) {
725
- validatorMonitorMetrics?.validatorsConnected.set(validators.size);
726
-
727
- const epoch = computeEpochAtSlot(slotClock);
728
- const slotInEpoch = slotClock % SLOTS_PER_EPOCH;
729
-
730
- // Only start to report on the current epoch once we've progressed past the point where
731
- // all attestation should be included in a block.
732
- //
733
- // This allows us to set alarms on Grafana to detect when an attestation has been
734
- // missed. If we didn't delay beyond the attestation inclusion period then we could
735
- // expect some occasional false-positives on attestation misses.
736
- //
737
- // I have chosen 3 as an arbitrary number where we *probably* shouldn't see that many
738
- // skip slots on mainnet.
739
- const previousEpoch = slotInEpoch > MIN_ATTESTATION_INCLUSION_DELAY + 3 ? epoch - 1 : epoch - 2;
740
-
741
- // reset() to mimic the behaviour of an aggregated .set({index})
742
- validatorMonitorMetrics?.prevEpochAttestations.reset();
743
- validatorMonitorMetrics?.prevEpochAttestationsMinDelaySeconds.reset();
744
- validatorMonitorMetrics?.prevEpochAttestationAggregateInclusions.reset();
745
- validatorMonitorMetrics?.prevEpochAttestationBlockInclusions.reset();
746
- validatorMonitorMetrics?.prevEpochAttestationBlockMinInclusionDistance.reset();
747
- validatorMonitorMetrics?.prevEpochSyncSignatureAggregateInclusions.reset();
748
-
749
- let validatorsInSyncCommittee = 0;
750
- let prevEpochSyncCommitteeHits = 0;
751
- let prevEpochSyncCommitteeMisses = 0;
752
-
753
- for (const validator of validators.values()) {
754
- // Participation in sync committee
755
- const validatorInSyncCommittee = validator.inSyncCommitteeUntilEpoch >= epoch;
756
- if (validatorInSyncCommittee) {
757
- validatorsInSyncCommittee++;
758
- }
759
-
760
- // Prev-epoch summary
761
- const summary = validator.summaries.get(previousEpoch);
762
- if (!summary) {
763
- continue;
764
- }
765
-
766
- // Attestations
767
- validatorMonitorMetrics?.prevEpochAttestations.observe(summary.attestations);
768
- if (summary.attestationMinDelay !== null)
769
- validatorMonitorMetrics?.prevEpochAttestationsMinDelaySeconds.observe(summary.attestationMinDelay);
770
- validatorMonitorMetrics?.prevEpochAttestationAggregateInclusions.observe(
771
- summary.attestationAggregateInclusions
772
- );
773
- validatorMonitorMetrics?.prevEpochAttestationBlockInclusions.observe(summary.attestationBlockInclusions);
774
- if (summary.attestationMinBlockInclusionDistance !== null) {
775
- validatorMonitorMetrics?.prevEpochAttestationBlockMinInclusionDistance.observe(
776
- summary.attestationMinBlockInclusionDistance
777
- );
778
- }
779
-
780
- // Blocks
781
- validatorMonitorMetrics?.prevEpochBeaconBlocks.observe(summary.blocks);
782
- if (summary.blockMinDelay !== null)
783
- validatorMonitorMetrics?.prevEpochBeaconBlocksMinDelaySeconds.observe(summary.blockMinDelay);
784
-
785
- // Aggregates
786
- validatorMonitorMetrics?.prevEpochAggregatesTotal.observe(summary.aggregates);
787
- if (summary.aggregateMinDelay !== null)
788
- validatorMonitorMetrics?.prevEpochAggregatesMinDelaySeconds.observe(summary.aggregateMinDelay);
789
-
790
- // Sync committee
791
- prevEpochSyncCommitteeHits += summary.syncCommitteeHits;
792
- prevEpochSyncCommitteeMisses += summary.syncCommitteeMisses;
793
-
794
- // Only observe if included in sync committee to prevent distorting metrics
795
- if (validatorInSyncCommittee) {
796
- validatorMonitorMetrics?.prevEpochSyncSignatureAggregateInclusions.observe(
797
- summary.syncSignatureAggregateInclusions
798
- );
799
- }
800
- }
801
-
802
- validatorMonitorMetrics?.validatorsInSyncCommittee.set(validatorsInSyncCommittee);
803
- validatorMonitorMetrics?.prevEpochSyncCommitteeHits.set(prevEpochSyncCommitteeHits);
804
- validatorMonitorMetrics?.prevEpochSyncCommitteeMisses.set(prevEpochSyncCommitteeMisses);
805
- },
806
- };
807
-
808
- // Register a single collect() function to run all validatorMonitor metrics
809
- validatorMonitorMetrics?.validatorsConnected.addCollect(() => {
810
- const clockSlot = getCurrentSlot(config, genesisTime);
811
- validatorMonitor.scrapeMetrics(clockSlot);
812
- });
813
-
814
- return validatorMonitor;
815
- }
816
-
817
- /**
818
- * Best guess to automatically debug why validators do not achieve expected rewards.
819
- * Tries to answer common questions such as:
820
- * - Did the validator submit the attestation to this block?
821
- * - Was the attestation seen in an aggregate?
822
- * - Was the attestation seen in a block?
823
- */
824
- function renderAttestationSummary(
825
- config: ChainConfig,
826
- rootCache: RootHexCache,
827
- summary: AttestationSummary | undefined,
828
- flags: ParticipationFlags
829
- ): string {
830
- // Reference https://github.com/ethereum/consensus-specs/blob/dev/specs/altair/beacon-chain.md#get_attestation_participation_flag_indices
831
- //
832
- // is_matching_source = data.source == justified_checkpoint
833
- // is_matching_target = is_matching_source and data.target.root == get_block_root(state, data.target.epoch)
834
- // is_matching_head = is_matching_target and data.beacon_block_root == get_block_root_at_slot(state, data.slot)
835
- //
836
- // is_matching_source MUST be true for the attestation to be included in a block
837
- //
838
- // timely_source = is_matching_source and inclusion_delay <= integer_squareroot(SLOTS_PER_EPOCH):
839
- // timely_target = is_matching_target and inclusion_delay <= SLOTS_PER_EPOCH:
840
- // timely_head = is_matching_head and inclusion_delay == MIN_ATTESTATION_INCLUSION_DELAY:
841
-
842
- if (flags.timelyHead) {
843
- // NOTE: If timelyHead everything else MUST be true also
844
- return "timely_head";
845
- }
846
-
847
- //
848
- if (flags.timelyTarget) {
849
- // timelyHead == false, means at least one is true
850
- // - attestation voted incorrect head
851
- // - attestation was included late
852
-
853
- // Note: the same attestation can be included in multiple blocks. For example, block with parent A at slot N can
854
- // include the attestation. Then block as slot N+1 re-orgs slot N setting as parent A and includes the attestations
855
- // from block at slot N.
856
- //
857
- // TODO: Track block inclusions, and then check which ones are canonical
858
-
859
- if (!summary) {
860
- // In normal conditions should never happen, validator is expected to submit an attestation to the tracking node.
861
- // If the validator is using multiple beacon nodes as fallback, this condition may be triggered.
862
- return "unexpected_timely_target_without_summary";
863
- }
864
-
865
- const canonicalBlockInclusion = summary.blockInclusions.find((block) => isCanonical(rootCache, block));
866
- if (!canonicalBlockInclusion) {
867
- // Should never happen, because for a state to exist that registers a validator's participation this specific
868
- // beacon node must have imported a block with the attestation that caused the change in participation.
869
- return "unexpected_timely_target_without_canonical_inclusion";
870
- }
871
-
872
- const {votedCorrectHeadRoot, blockSlot, attestationSlot} = canonicalBlockInclusion;
873
- const inclusionDistance = Math.max(blockSlot - attestationSlot - MIN_ATTESTATION_INCLUSION_DELAY, 0);
874
-
875
- if (votedCorrectHeadRoot && inclusionDistance === 0) {
876
- // Should never happen, in this case timelyHead must be true
877
- return "unexpected_timely_head_as_timely_target";
878
- }
879
-
880
- // Why is the distance > 0?
881
- // - Block that should have included the attestation was missed
882
- // - Attestation was not included in any aggregate
883
- // - Attestation was sent late
884
-
885
- // Why is the head vote wrong?
886
- // - We processed a block late and voted for the parent
887
- // - We voted for a block that latter was missed
888
- // - We voted for a block that was re-org for another chain
889
-
890
- let out = "timely_target";
891
-
892
- if (!votedCorrectHeadRoot) {
893
- out += "_" + whyIsHeadVoteWrong(rootCache, canonicalBlockInclusion);
894
- }
895
-
896
- if (inclusionDistance > 0) {
897
- out += "_" + whyIsDistanceNotOk(rootCache, canonicalBlockInclusion, summary);
898
- }
899
-
900
- return out;
901
- }
902
-
903
- //
904
- if (flags.timelySource) {
905
- // timelyTarget == false && timelySource == true means that
906
- // - attestation voted the wrong target but distance is <= integer_squareroot(SLOTS_PER_EPOCH)
907
- return "wrong_target_timely_source";
908
- }
909
-
910
- //
911
- // timelySource == false, either:
912
- // - attestation was not included in the block
913
- // - included in block with wrong target (very unlikely)
914
- // - included in block with distance > SLOTS_PER_EPOCH (very unlikely)
915
-
916
- // Validator failed to submit an attestation for this epoch, validator client is probably offline
917
- if (!summary || summary.poolSubmitDelayMinSec === null) {
918
- return "no_submission";
919
- }
920
-
921
- const canonicalBlockInclusion = summary.blockInclusions.find((block) => isCanonical(rootCache, block));
922
- if (canonicalBlockInclusion) {
923
- // Canonical block inclusion with no participation flags set means wrong target + late source
924
- return "wrong_target_late_source";
925
- }
926
-
927
- const submittedLate =
928
- summary.poolSubmitDelayMinSec >
929
- (INTERVALS_LATE_ATTESTATION_SUBMISSION * config.SECONDS_PER_SLOT) / INTERVALS_PER_SLOT;
930
-
931
- const aggregateInclusion = summary.aggregateInclusionDelaysSec.length > 0;
932
-
933
- if (submittedLate && aggregateInclusion) {
934
- return "late_submit";
935
- }
936
- if (submittedLate && !aggregateInclusion) {
937
- return "late_submit_no_aggregate_inclusion";
938
- }
939
-
940
- if (!submittedLate && aggregateInclusion) {
941
- // TODO: Why was it missed then?
942
- if (summary.blockInclusions.length) {
943
- return "block_inclusion_but_orphan";
944
- }
945
- return "aggregate_inclusion_but_missed";
946
- // } else if (!submittedLate && !aggregateInclusion) {
947
- }
948
- // Did the node had enough peers?
949
- if (summary.poolSubmitSentPeers === 0) {
950
- return "sent_to_zero_peers";
951
- }
952
- return "no_aggregate_inclusion";
953
- }
954
-
955
- function whyIsHeadVoteWrong(rootCache: RootHexCache, canonicalBlockInclusion: AttestationBlockInclusion): string {
956
- const {votedForMissedSlot, attestationSlot} = canonicalBlockInclusion;
957
- const canonicalAttestationSlotMissed = isMissedSlot(rootCache, attestationSlot);
958
-
959
- // __A_______C
960
- // \_B1
961
- // ^^ attestation slot
962
- //
963
- // We vote for B1, but the next proposer skips our voted block.
964
- // This scenario happens sometimes when blocks are published late
965
-
966
- // __A____________E
967
- // \_B1__C__D
968
- // ^^ attestation slot
969
- //
970
- // We vote for B1, and due to some issue a longer reorg happens orphaning our vote.
971
- // This scenario is considered in the above
972
- if (!votedForMissedSlot && canonicalAttestationSlotMissed) {
973
- // TODO: Did the block arrive late?
974
- return "vote_orphaned";
975
- }
976
-
977
- // __A__B1___C
978
- // \_(A)
979
- // ^^ attestation slot
980
- //
981
- // We vote for A assuming skip block, next proposer's view differs
982
- // This scenario happens sometimes when blocks are published late
983
- if (votedForMissedSlot && !canonicalAttestationSlotMissed) {
984
- // TODO: Did the block arrive late?
985
- return "wrong_skip_vote";
986
- }
987
-
988
- // __A__B2___C
989
- // \_B1
990
- // ^^ attestation slot
991
- //
992
- // We vote for B1, but the next proposer continues the chain on a competing block
993
- // This scenario is unlikely to happen in short re-orgs given no slashings, won't consider.
994
- //
995
- // __A____B_______C
996
- // \ \_(B)
997
- // \_(A)_(A)
998
- //
999
- // Vote for different heads on skipped slot
1000
- return "wrong_head_vote";
1001
- }
1002
-
1003
- function whyIsDistanceNotOk(
1004
- rootCache: RootHexCache,
1005
- canonicalBlockInclusion: AttestationBlockInclusion,
1006
- summary: AttestationSummary
1007
- ): string {
1008
- // If the attestation is not included in any aggregate it's likely because it was sent late.
1009
- if (summary.aggregateInclusionDelaysSec.length === 0) {
1010
- return "no_aggregate_inclusion";
1011
- }
1012
-
1013
- // If the next slot of an attestation is missed, distance will be > 0 even if everything else was timely
1014
- if (isMissedSlot(rootCache, canonicalBlockInclusion.attestationSlot + 1)) {
1015
- return "next_slot_missed";
1016
- }
1017
-
1018
- //
1019
- return "late_unknown";
1020
- }
1021
-
1022
- /** Returns true if the state's root record includes `block` */
1023
- function isCanonical(rootCache: RootHexCache, block: AttestationBlockInclusion): boolean {
1024
- return rootCache.getBlockRootAtSlot(block.blockSlot) === block.blockRoot;
1025
- }
1026
-
1027
- /** Returns true if root at slot is the same at slot - 1 == there was no new block at slot */
1028
- function isMissedSlot(rootCache: RootHexCache, slot: Slot): boolean {
1029
- return slot > 0 && rootCache.getBlockRootAtSlot(slot) === rootCache.getBlockRootAtSlot(slot - 1);
1030
- }
1031
-
1032
- function renderBlockProposalSummary(
1033
- config: ChainConfig,
1034
- rootCache: RootHexCache,
1035
- summary: EpochSummary | undefined,
1036
- proposalSlot: Slot
1037
- ): string {
1038
- const proposal = summary?.blockProposals.find((proposal) => proposal.blockSlot === proposalSlot);
1039
- if (!proposal) {
1040
- return "not_submitted";
1041
- }
1042
-
1043
- if (rootCache.getBlockRootAtSlot(proposalSlot) === proposal.blockRoot) {
1044
- // Canonical state includes our block
1045
- return "canonical";
1046
- }
1047
-
1048
- let out = "orphaned";
1049
-
1050
- if (isMissedSlot(rootCache, proposalSlot)) {
1051
- out += "_missed";
1052
- }
1053
-
1054
- if (
1055
- proposal.poolSubmitDelaySec !== null &&
1056
- proposal.poolSubmitDelaySec > (INTERVALS_LATE_BLOCK_SUBMISSION * config.SECONDS_PER_SLOT) / INTERVALS_PER_SLOT
1057
- ) {
1058
- out += "_late";
1059
- }
1060
-
1061
- return out;
1062
- }
1063
-
1064
- /**
1065
- * Cache to prevent accessing the state tree to fetch block roots repeteadly.
1066
- * In normal network conditions the same root is read multiple times, specially the target.
1067
- */
1068
- export class RootHexCache {
1069
- private readonly blockRootSlotCache = new Map<Slot, RootHex>();
1070
-
1071
- constructor(private readonly state: CachedBeaconStateAllForks) {}
1072
-
1073
- getBlockRootAtSlot(slot: Slot): RootHex {
1074
- let root = this.blockRootSlotCache.get(slot);
1075
- if (!root) {
1076
- root = toRootHex(getBlockRootAtSlot(this.state, slot));
1077
- this.blockRootSlotCache.set(slot, root);
1078
- }
1079
- return root;
1080
- }
1081
- }
1082
-
1083
- function createValidatorMonitorMetrics(register: RegistryMetricCreator) {
1084
- return {
1085
- validatorsConnected: register.gauge({
1086
- name: "validator_monitor_validators",
1087
- help: "Count of validators that are specifically monitored by this beacon node",
1088
- }),
1089
-
1090
- validatorsInSyncCommittee: register.gauge({
1091
- name: "validator_monitor_validators_in_sync_committee",
1092
- help: "Count of validators monitored by this beacon node that are part of sync committee",
1093
- }),
1094
-
1095
- // Validator Monitor Metrics (per-epoch summaries)
1096
- // Only track prevEpochOnChainBalance per index
1097
- prevEpochOnChainBalance: register.gauge<{index: number}>({
1098
- name: "validator_monitor_prev_epoch_on_chain_balance",
1099
- help: "Balance of validator after an epoch",
1100
- labelNames: ["index"],
1101
- }),
1102
- prevEpochOnChainAttesterHit: register.gauge({
1103
- name: "validator_monitor_prev_epoch_on_chain_attester_hit_total",
1104
- help: "Incremented if validator's submitted attestation is included in some blocks",
1105
- }),
1106
- prevEpochOnChainAttesterMiss: register.gauge({
1107
- name: "validator_monitor_prev_epoch_on_chain_attester_miss_total",
1108
- help: "Incremented if validator's submitted attestation is not included in any blocks",
1109
- }),
1110
- prevEpochOnChainSourceAttesterHit: register.gauge({
1111
- name: "validator_monitor_prev_epoch_on_chain_source_attester_hit_total",
1112
- help: "Incremented if the validator is flagged as a previous epoch source attester during per epoch processing",
1113
- }),
1114
- prevEpochOnChainSourceAttesterMiss: register.gauge({
1115
- name: "validator_monitor_prev_epoch_on_chain_source_attester_miss_total",
1116
- help: "Incremented if the validator is not flagged as a previous epoch source attester during per epoch processing",
1117
- }),
1118
- prevEpochOnChainHeadAttesterHit: register.gauge({
1119
- name: "validator_monitor_prev_epoch_on_chain_head_attester_hit_total",
1120
- help: "Incremented if the validator is flagged as a previous epoch head attester during per epoch processing",
1121
- }),
1122
- prevEpochOnChainHeadAttesterMiss: register.gauge({
1123
- name: "validator_monitor_prev_epoch_on_chain_head_attester_miss_total",
1124
- help: "Incremented if the validator is not flagged as a previous epoch head attester during per epoch processing",
1125
- }),
1126
- prevOnChainAttesterCorrectHead: register.gauge({
1127
- name: "validator_monitor_prev_epoch_on_chain_attester_correct_head_total",
1128
- help: "Total count of times a validator votes correct head",
1129
- }),
1130
- prevOnChainAttesterIncorrectHead: register.gauge({
1131
- name: "validator_monitor_prev_epoch_on_chain_attester_incorrect_head_total",
1132
- help: "Total count of times a validator votes incorrect head",
1133
- }),
1134
- prevEpochOnChainTargetAttesterHit: register.gauge({
1135
- name: "validator_monitor_prev_epoch_on_chain_target_attester_hit_total",
1136
- help: "Incremented if the validator is flagged as a previous epoch target attester during per epoch processing",
1137
- }),
1138
- prevEpochOnChainTargetAttesterMiss: register.gauge({
1139
- name: "validator_monitor_prev_epoch_on_chain_target_attester_miss_total",
1140
- help: "Incremented if the validator is not flagged as a previous epoch target attester during per epoch processing",
1141
- }),
1142
- prevEpochOnChainInclusionDistance: register.histogram({
1143
- name: "validator_monitor_prev_epoch_on_chain_inclusion_distance",
1144
- help: "The attestation inclusion distance calculated during per epoch processing",
1145
- // min inclusion distance is 1, usual values are 1,2,3 max is 32 (1 epoch)
1146
- buckets: [1, 2, 3, 5, 10, 32],
1147
- }),
1148
- prevEpochAttestations: register.histogram({
1149
- name: "validator_monitor_prev_epoch_attestations",
1150
- help: "The number of unagg. attestations seen in the previous epoch",
1151
- buckets: [0, 1, 2, 3],
1152
- }),
1153
- prevEpochAttestationsMinDelaySeconds: register.histogram({
1154
- name: "validator_monitor_prev_epoch_attestations_min_delay_seconds",
1155
- help: "The min delay between when the validator should send the attestation and when it was received",
1156
- buckets: [0.1, 0.25, 0.5, 1, 2, 5, 10],
1157
- }),
1158
- prevEpochAttestationAggregateInclusions: register.histogram({
1159
- name: "validator_monitor_prev_epoch_attestation_aggregate_inclusions",
1160
- help: "The count of times an attestation was seen inside an aggregate",
1161
- buckets: [0, 1, 2, 3, 5, 10],
1162
- }),
1163
- prevEpochAttestationBlockInclusions: register.histogram({
1164
- name: "validator_monitor_prev_epoch_attestation_block_inclusions",
1165
- help: "The count of times an attestation was seen inside a block",
1166
- buckets: [0, 1, 2, 3, 5],
1167
- }),
1168
- prevEpochAttestationBlockMinInclusionDistance: register.histogram({
1169
- name: "validator_monitor_prev_epoch_attestation_block_min_inclusion_distance",
1170
- help: "The minimum inclusion distance observed for the inclusion of an attestation in a block",
1171
- buckets: [1, 2, 3, 5, 10, 32],
1172
- }),
1173
- prevEpochBeaconBlocks: register.histogram({
1174
- name: "validator_monitor_prev_epoch_beacon_blocks",
1175
- help: "The number of beacon_blocks seen in the previous epoch",
1176
- buckets: [0, 1, 2, 3, 5, 10],
1177
- }),
1178
- prevEpochBeaconBlocksMinDelaySeconds: register.histogram({
1179
- name: "validator_monitor_prev_epoch_beacon_blocks_min_delay_seconds",
1180
- help: "The min delay between when the validator should send the block and when it was received",
1181
- buckets: [0.1, 0.25, 0.5, 1, 2, 5, 10],
1182
- }),
1183
- prevEpochAggregatesTotal: register.histogram({
1184
- name: "validator_monitor_prev_epoch_aggregates",
1185
- help: "The number of aggregates seen in the previous epoch",
1186
- buckets: [0, 1, 2, 3, 5, 10],
1187
- }),
1188
- prevEpochAggregatesMinDelaySeconds: register.histogram({
1189
- name: "validator_monitor_prev_epoch_aggregates_min_delay_seconds",
1190
- help: "The min delay between when the validator should send the aggregate and when it was received",
1191
- buckets: [0.1, 0.25, 0.5, 1, 2, 5, 10],
1192
- }),
1193
- prevEpochSyncCommitteeHits: register.gauge({
1194
- name: "validator_monitor_prev_epoch_sync_committee_hits",
1195
- help: "Count of times in prev epoch connected validators participated in imported block's syncAggregate",
1196
- }),
1197
- prevEpochSyncCommitteeMisses: register.gauge({
1198
- name: "validator_monitor_prev_epoch_sync_committee_misses",
1199
- help: "Count of times in prev epoch connected validators fail to participate in imported block's syncAggregate",
1200
- }),
1201
- prevEpochSyncSignatureAggregateInclusions: register.histogram({
1202
- name: "validator_monitor_prev_epoch_sync_signature_aggregate_inclusions",
1203
- help: "The count of times a sync signature was seen inside an aggregate",
1204
- buckets: [0, 1, 2, 3, 5, 10],
1205
- }),
1206
- prevEpochAttestationSummary: register.gauge<{summary: string}>({
1207
- name: "validator_monitor_prev_epoch_attestation_summary",
1208
- help: "Best guess of the node of the result of previous epoch validators attestation actions and causality",
1209
- labelNames: ["summary"],
1210
- }),
1211
- prevEpochBlockProposalSummary: register.gauge<{summary: string}>({
1212
- name: "validator_monitor_prev_epoch_block_proposal_summary",
1213
- help: "Best guess of the node of the result of previous epoch validators block proposal actions and causality",
1214
- labelNames: ["summary"],
1215
- }),
1216
-
1217
- // Validator Monitor Metrics (real-time)
1218
-
1219
- unaggregatedAttestationTotal: register.gauge<{src: OpSource}>({
1220
- name: "validator_monitor_unaggregated_attestation_total",
1221
- help: "Number of unaggregated attestations seen",
1222
- labelNames: ["src"],
1223
- }),
1224
- unaggregatedAttestationDelaySeconds: register.histogram<{src: OpSource}>({
1225
- name: "validator_monitor_unaggregated_attestation_delay_seconds",
1226
- help: "The delay between when the validator should send the attestation and when it was received",
1227
- labelNames: ["src"],
1228
- buckets: [0.1, 0.25, 0.5, 1, 2, 5, 10],
1229
- }),
1230
- unaggregatedAttestationSubmittedSentPeers: register.histogram({
1231
- name: "validator_monitor_unaggregated_attestation_submitted_sent_peers_count",
1232
- help: "Number of peers that an unaggregated attestation sent to",
1233
- // as of Apr 2022, most of the time we sent to >30 peers per attestations
1234
- // these bucket values just base on that fact to get equal range
1235
- // refine if we want more reasonable values
1236
- buckets: [0, 10, 20, 30],
1237
- }),
1238
- aggregatedAttestationTotal: register.gauge<{src: OpSource}>({
1239
- name: "validator_monitor_aggregated_attestation_total",
1240
- help: "Number of aggregated attestations seen",
1241
- labelNames: ["src"],
1242
- }),
1243
- aggregatedAttestationDelaySeconds: register.histogram<{src: OpSource}>({
1244
- name: "validator_monitor_aggregated_attestation_delay_seconds",
1245
- help: "The delay between then the validator should send the aggregate and when it was received",
1246
- labelNames: ["src"],
1247
- buckets: [0.1, 0.25, 0.5, 1, 2, 5, 10],
1248
- }),
1249
- attestationInAggregateTotal: register.gauge<{src: OpSource}>({
1250
- name: "validator_monitor_attestation_in_aggregate_total",
1251
- help: "Number of times an attestation has been seen in an aggregate",
1252
- labelNames: ["src"],
1253
- }),
1254
- attestationInAggregateDelaySeconds: register.histogram<{src: OpSource}>({
1255
- name: "validator_monitor_attestation_in_aggregate_delay_seconds",
1256
- help: "The delay between when the validator should send the aggregate and when it was received",
1257
- labelNames: ["src"],
1258
- buckets: [0.1, 0.25, 0.5, 1, 2, 5, 10],
1259
- }),
1260
- attestationInBlockTotal: register.gauge({
1261
- name: "validator_monitor_attestation_in_block_total",
1262
- help: "Number of times an attestation has been seen in a block",
1263
- }),
1264
- attestationInBlockDelaySlots: register.histogram({
1265
- name: "validator_monitor_attestation_in_block_delay_slots",
1266
- help: "The excess slots (beyond the minimum delay) between the attestation slot and the block slot",
1267
- buckets: [0.1, 0.25, 0.5, 1, 2, 5, 10],
1268
- }),
1269
- attestationInBlockParticipants: register.histogram({
1270
- name: "validator_monitor_attestation_in_block_participants",
1271
- help: "The total participants in attestations of monitored validators included in blocks",
1272
- buckets: [1, 5, 20, 50, 100, 200],
1273
- }),
1274
- syncSignatureInAggregateTotal: register.gauge({
1275
- name: "validator_monitor_sync_signature_in_aggregate_total",
1276
- help: "Number of times a sync signature has been seen in an aggregate",
1277
- }),
1278
- beaconBlockTotal: register.gauge<{src: OpSource}>({
1279
- name: "validator_monitor_beacon_block_total",
1280
- help: "Total number of beacon blocks seen",
1281
- labelNames: ["src"],
1282
- }),
1283
- beaconBlockDelaySeconds: register.histogram<{src: OpSource}>({
1284
- name: "validator_monitor_beacon_block_delay_seconds",
1285
- help: "The delay between when the validator should send the block and when it was received",
1286
- labelNames: ["src"],
1287
- // we also want other nodes to received our published before 4s so add bucket 3 and 3.5
1288
- buckets: [0.1, 0.25, 0.5, 1, 2, 3, 4, 6, 10],
1289
- }),
1290
-
1291
- // Only for known
1292
- proposerBalanceDeltaKnown: register.histogram({
1293
- name: "validator_monitor_proposer_balance_delta_known_gwei",
1294
- help: "Balance delta of known block proposer after importing a valid block",
1295
- // Jul22 mainnet block reward is consistently between 29,000,000-28,000,000 GWei
1296
- buckets: [10_000, 100_000, 1e6, 10e6, 20e6, 50e6, 100e6, 1000e6],
1297
- }),
1298
- };
1299
- }