@lodestar/beacon-node 1.47.0-dev.7a8fd842fc → 1.47.0-dev.7aa8c9c93a

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 (265) hide show
  1. package/lib/api/impl/beacon/blocks/index.d.ts.map +1 -1
  2. package/lib/api/impl/beacon/blocks/index.js +6 -8
  3. package/lib/api/impl/beacon/blocks/index.js.map +1 -1
  4. package/lib/api/impl/beacon/pool/index.d.ts.map +1 -1
  5. package/lib/api/impl/beacon/pool/index.js +12 -1
  6. package/lib/api/impl/beacon/pool/index.js.map +1 -1
  7. package/lib/api/impl/beacon/state/utils.d.ts +2 -1
  8. package/lib/api/impl/beacon/state/utils.d.ts.map +1 -1
  9. package/lib/api/impl/beacon/state/utils.js.map +1 -1
  10. package/lib/api/impl/events/index.d.ts +1 -1
  11. package/lib/api/impl/events/index.d.ts.map +1 -1
  12. package/lib/api/impl/events/index.js +12 -3
  13. package/lib/api/impl/events/index.js.map +1 -1
  14. package/lib/api/impl/validator/index.js +1 -1
  15. package/lib/api/impl/validator/index.js.map +1 -1
  16. package/lib/api/rest/base.d.ts.map +1 -1
  17. package/lib/api/rest/base.js +7 -0
  18. package/lib/api/rest/base.js.map +1 -1
  19. package/lib/chain/archiveStore/historicalState/metrics.d.ts.map +1 -1
  20. package/lib/chain/archiveStore/historicalState/metrics.js +21 -0
  21. package/lib/chain/archiveStore/historicalState/metrics.js.map +1 -1
  22. package/lib/chain/blocks/importBlock.d.ts.map +1 -1
  23. package/lib/chain/blocks/importBlock.js +2 -7
  24. package/lib/chain/blocks/importBlock.js.map +1 -1
  25. package/lib/chain/blocks/importExecutionPayload.d.ts +3 -2
  26. package/lib/chain/blocks/importExecutionPayload.d.ts.map +1 -1
  27. package/lib/chain/blocks/importExecutionPayload.js +11 -9
  28. package/lib/chain/blocks/importExecutionPayload.js.map +1 -1
  29. package/lib/chain/blocks/index.d.ts.map +1 -1
  30. package/lib/chain/blocks/index.js +14 -6
  31. package/lib/chain/blocks/index.js.map +1 -1
  32. package/lib/chain/blocks/payloadEnvelopeInput/payloadEnvelopeInput.d.ts +2 -1
  33. package/lib/chain/blocks/payloadEnvelopeInput/payloadEnvelopeInput.d.ts.map +1 -1
  34. package/lib/chain/blocks/payloadEnvelopeInput/payloadEnvelopeInput.js +6 -2
  35. package/lib/chain/blocks/payloadEnvelopeInput/payloadEnvelopeInput.js.map +1 -1
  36. package/lib/chain/blocks/payloadEnvelopeInput/types.d.ts +14 -5
  37. package/lib/chain/blocks/payloadEnvelopeInput/types.d.ts.map +1 -1
  38. package/lib/chain/blocks/payloadEnvelopeInput/types.js +5 -0
  39. package/lib/chain/blocks/payloadEnvelopeInput/types.js.map +1 -1
  40. package/lib/chain/blocks/verifyBlocksStateTransitionOnly.d.ts.map +1 -1
  41. package/lib/chain/blocks/verifyBlocksStateTransitionOnly.js +22 -12
  42. package/lib/chain/blocks/verifyBlocksStateTransitionOnly.js.map +1 -1
  43. package/lib/chain/blocks/verifyExecutionPayloadEnvelope.d.ts +2 -2
  44. package/lib/chain/blocks/verifyExecutionPayloadEnvelope.d.ts.map +1 -1
  45. package/lib/chain/blocks/verifyExecutionPayloadEnvelope.js +2 -2
  46. package/lib/chain/blocks/verifyExecutionPayloadEnvelope.js.map +1 -1
  47. package/lib/chain/bls/index.d.ts +1 -1
  48. package/lib/chain/bls/index.d.ts.map +1 -1
  49. package/lib/chain/bls/interface.d.ts +5 -5
  50. package/lib/chain/bls/interface.d.ts.map +1 -1
  51. package/lib/chain/bls/multithread/index.d.ts +5 -11
  52. package/lib/chain/bls/multithread/index.d.ts.map +1 -1
  53. package/lib/chain/bls/multithread/index.js +116 -101
  54. package/lib/chain/bls/multithread/index.js.map +1 -1
  55. package/lib/chain/bls/multithread/jobItem.d.ts +5 -19
  56. package/lib/chain/bls/multithread/jobItem.d.ts.map +1 -1
  57. package/lib/chain/bls/multithread/jobItem.js +10 -65
  58. package/lib/chain/bls/multithread/jobItem.js.map +1 -1
  59. package/lib/chain/bls/multithread/types.d.ts +29 -8
  60. package/lib/chain/bls/multithread/types.d.ts.map +1 -1
  61. package/lib/chain/bls/multithread/types.js +12 -0
  62. package/lib/chain/bls/multithread/types.js.map +1 -1
  63. package/lib/chain/bls/multithread/utils.d.ts +4 -0
  64. package/lib/chain/bls/multithread/utils.d.ts.map +1 -1
  65. package/lib/chain/bls/multithread/utils.js +10 -0
  66. package/lib/chain/bls/multithread/utils.js.map +1 -1
  67. package/lib/chain/bls/multithread/worker.js +49 -23
  68. package/lib/chain/bls/multithread/worker.js.map +1 -1
  69. package/lib/chain/bls/singleThread.d.ts +4 -10
  70. package/lib/chain/bls/singleThread.d.ts.map +1 -1
  71. package/lib/chain/bls/singleThread.js +8 -45
  72. package/lib/chain/bls/singleThread.js.map +1 -1
  73. package/lib/chain/bls/utils.d.ts +4 -4
  74. package/lib/chain/bls/utils.d.ts.map +1 -1
  75. package/lib/chain/bls/utils.js +18 -19
  76. package/lib/chain/bls/utils.js.map +1 -1
  77. package/lib/chain/builderCircuitBreaker.d.ts +6 -5
  78. package/lib/chain/builderCircuitBreaker.d.ts.map +1 -1
  79. package/lib/chain/builderCircuitBreaker.js +28 -15
  80. package/lib/chain/builderCircuitBreaker.js.map +1 -1
  81. package/lib/chain/chain.d.ts +2 -1
  82. package/lib/chain/chain.d.ts.map +1 -1
  83. package/lib/chain/chain.js +12 -5
  84. package/lib/chain/chain.js.map +1 -1
  85. package/lib/chain/errors/blockError.d.ts +1 -0
  86. package/lib/chain/errors/blockError.d.ts.map +1 -1
  87. package/lib/chain/errors/blockError.js +6 -1
  88. package/lib/chain/errors/blockError.js.map +1 -1
  89. package/lib/chain/errors/proposerPreferences.d.ts +6 -0
  90. package/lib/chain/errors/proposerPreferences.d.ts.map +1 -1
  91. package/lib/chain/errors/proposerPreferences.js +1 -0
  92. package/lib/chain/errors/proposerPreferences.js.map +1 -1
  93. package/lib/chain/interface.d.ts +2 -1
  94. package/lib/chain/interface.d.ts.map +1 -1
  95. package/lib/chain/interface.js.map +1 -1
  96. package/lib/chain/opPools/aggregatedAttestationPool.js +1 -1
  97. package/lib/chain/opPools/aggregatedAttestationPool.js.map +1 -1
  98. package/lib/chain/opPools/attestationPool.d.ts +1 -1
  99. package/lib/chain/opPools/attestationPool.d.ts.map +1 -1
  100. package/lib/chain/opPools/attestationPool.js +1 -1
  101. package/lib/chain/opPools/attestationPool.js.map +1 -1
  102. package/lib/chain/opPools/payloadAttestationPool.js +3 -3
  103. package/lib/chain/opPools/payloadAttestationPool.js.map +1 -1
  104. package/lib/chain/opPools/syncCommitteeMessagePool.js +1 -1
  105. package/lib/chain/opPools/syncCommitteeMessagePool.js.map +1 -1
  106. package/lib/chain/opPools/syncContributionAndProofPool.js +1 -1
  107. package/lib/chain/opPools/syncContributionAndProofPool.js.map +1 -1
  108. package/lib/chain/opPools/utils.d.ts +1 -1
  109. package/lib/chain/opPools/utils.d.ts.map +1 -1
  110. package/lib/chain/opPools/utils.js +1 -1
  111. package/lib/chain/opPools/utils.js.map +1 -1
  112. package/lib/chain/options.d.ts +1 -1
  113. package/lib/chain/options.d.ts.map +1 -1
  114. package/lib/chain/prepareNextSlot.js +1 -1
  115. package/lib/chain/prepareNextSlot.js.map +1 -1
  116. package/lib/chain/seenCache/seenAttesters.d.ts +9 -5
  117. package/lib/chain/seenCache/seenAttesters.d.ts.map +1 -1
  118. package/lib/chain/seenCache/seenAttesters.js +25 -4
  119. package/lib/chain/seenCache/seenAttesters.js.map +1 -1
  120. package/lib/chain/seenCache/seenPayloadEnvelopeInput.d.ts +30 -1
  121. package/lib/chain/seenCache/seenPayloadEnvelopeInput.d.ts.map +1 -1
  122. package/lib/chain/seenCache/seenPayloadEnvelopeInput.js +123 -13
  123. package/lib/chain/seenCache/seenPayloadEnvelopeInput.js.map +1 -1
  124. package/lib/chain/validation/attestation.d.ts.map +1 -1
  125. package/lib/chain/validation/attestation.js +1 -4
  126. package/lib/chain/validation/attestation.js.map +1 -1
  127. package/lib/chain/validation/attesterSlashing.d.ts.map +1 -1
  128. package/lib/chain/validation/attesterSlashing.js +1 -1
  129. package/lib/chain/validation/attesterSlashing.js.map +1 -1
  130. package/lib/chain/validation/executionPayloadBid.d.ts.map +1 -1
  131. package/lib/chain/validation/executionPayloadBid.js +1 -2
  132. package/lib/chain/validation/executionPayloadBid.js.map +1 -1
  133. package/lib/chain/validation/executionPayloadEnvelope.js +1 -1
  134. package/lib/chain/validation/executionPayloadEnvelope.js.map +1 -1
  135. package/lib/chain/validation/payloadAttestationMessage.d.ts.map +1 -1
  136. package/lib/chain/validation/payloadAttestationMessage.js +5 -14
  137. package/lib/chain/validation/payloadAttestationMessage.js.map +1 -1
  138. package/lib/chain/validation/proposerPreferences.d.ts +1 -1
  139. package/lib/chain/validation/proposerPreferences.d.ts.map +1 -1
  140. package/lib/chain/validation/proposerPreferences.js +13 -4
  141. package/lib/chain/validation/proposerPreferences.js.map +1 -1
  142. package/lib/chain/validation/proposerSlashing.js +1 -1
  143. package/lib/chain/validation/proposerSlashing.js.map +1 -1
  144. package/lib/execution/builder/http.d.ts +10 -7
  145. package/lib/execution/builder/http.d.ts.map +1 -1
  146. package/lib/execution/builder/http.js +11 -8
  147. package/lib/execution/builder/http.js.map +1 -1
  148. package/lib/metrics/metrics/beacon.d.ts +3 -3
  149. package/lib/metrics/metrics/beacon.d.ts.map +1 -1
  150. package/lib/metrics/metrics/beacon.js +9 -9
  151. package/lib/metrics/metrics/beacon.js.map +1 -1
  152. package/lib/metrics/metrics/lodestar.d.ts +55 -20
  153. package/lib/metrics/metrics/lodestar.d.ts.map +1 -1
  154. package/lib/metrics/metrics/lodestar.js +103 -51
  155. package/lib/metrics/metrics/lodestar.js.map +1 -1
  156. package/lib/network/gossip/topic.d.ts +13 -0
  157. package/lib/network/gossip/topic.d.ts.map +1 -1
  158. package/lib/network/gossip/topic.js +37 -0
  159. package/lib/network/gossip/topic.js.map +1 -1
  160. package/lib/network/libp2p/index.d.ts.map +1 -1
  161. package/lib/network/libp2p/index.js +10 -2
  162. package/lib/network/libp2p/index.js.map +1 -1
  163. package/lib/network/network.d.ts.map +1 -1
  164. package/lib/network/network.js +22 -43
  165. package/lib/network/network.js.map +1 -1
  166. package/lib/network/processor/gossipHandlers.d.ts.map +1 -1
  167. package/lib/network/processor/gossipHandlers.js +12 -3
  168. package/lib/network/processor/gossipHandlers.js.map +1 -1
  169. package/lib/network/reqresp/score.d.ts.map +1 -1
  170. package/lib/network/reqresp/score.js +5 -11
  171. package/lib/network/reqresp/score.js.map +1 -1
  172. package/lib/network/util.d.ts +0 -1
  173. package/lib/network/util.d.ts.map +1 -1
  174. package/lib/network/util.js +0 -4
  175. package/lib/network/util.js.map +1 -1
  176. package/lib/node/nodejs.d.ts +2 -1
  177. package/lib/node/nodejs.d.ts.map +1 -1
  178. package/lib/node/nodejs.js.map +1 -1
  179. package/lib/sync/range/batch.d.ts +23 -5
  180. package/lib/sync/range/batch.d.ts.map +1 -1
  181. package/lib/sync/range/batch.js +61 -22
  182. package/lib/sync/range/batch.js.map +1 -1
  183. package/lib/sync/range/chain.d.ts +2 -1
  184. package/lib/sync/range/chain.d.ts.map +1 -1
  185. package/lib/sync/range/chain.js +23 -10
  186. package/lib/sync/range/chain.js.map +1 -1
  187. package/lib/sync/types.d.ts.map +1 -1
  188. package/lib/sync/types.js.map +1 -1
  189. package/lib/sync/unknownBlock.d.ts +9 -0
  190. package/lib/sync/unknownBlock.d.ts.map +1 -1
  191. package/lib/sync/unknownBlock.js +99 -21
  192. package/lib/sync/unknownBlock.js.map +1 -1
  193. package/lib/sync/utils/downloadByRange.d.ts.map +1 -1
  194. package/lib/sync/utils/downloadByRange.js +16 -11
  195. package/lib/sync/utils/downloadByRange.js.map +1 -1
  196. package/lib/sync/utils/downloadByRoot.d.ts.map +1 -1
  197. package/lib/sync/utils/downloadByRoot.js +3 -1
  198. package/lib/sync/utils/downloadByRoot.js.map +1 -1
  199. package/package.json +35 -35
  200. package/src/api/impl/beacon/blocks/index.ts +7 -8
  201. package/src/api/impl/beacon/pool/index.ts +12 -1
  202. package/src/api/impl/beacon/state/utils.ts +2 -1
  203. package/src/api/impl/events/index.ts +12 -4
  204. package/src/api/impl/validator/index.ts +1 -1
  205. package/src/api/rest/base.ts +7 -0
  206. package/src/chain/archiveStore/historicalState/metrics.ts +22 -0
  207. package/src/chain/blocks/importBlock.ts +1 -6
  208. package/src/chain/blocks/importExecutionPayload.ts +12 -11
  209. package/src/chain/blocks/index.ts +18 -6
  210. package/src/chain/blocks/payloadEnvelopeInput/payloadEnvelopeInput.ts +8 -2
  211. package/src/chain/blocks/payloadEnvelopeInput/types.ts +17 -4
  212. package/src/chain/blocks/verifyBlocksStateTransitionOnly.ts +25 -16
  213. package/src/chain/blocks/verifyExecutionPayloadEnvelope.ts +1 -9
  214. package/src/chain/bls/index.ts +1 -1
  215. package/src/chain/bls/interface.ts +7 -3
  216. package/src/chain/bls/multithread/index.ts +148 -120
  217. package/src/chain/bls/multithread/jobItem.ts +12 -82
  218. package/src/chain/bls/multithread/types.ts +33 -8
  219. package/src/chain/bls/multithread/utils.ts +11 -0
  220. package/src/chain/bls/multithread/worker.ts +85 -27
  221. package/src/chain/bls/singleThread.ts +11 -55
  222. package/src/chain/bls/utils.ts +23 -24
  223. package/src/chain/builderCircuitBreaker.ts +31 -17
  224. package/src/chain/chain.ts +13 -6
  225. package/src/chain/errors/blockError.ts +8 -2
  226. package/src/chain/errors/proposerPreferences.ts +7 -0
  227. package/src/chain/interface.ts +2 -1
  228. package/src/chain/opPools/aggregatedAttestationPool.ts +1 -1
  229. package/src/chain/opPools/attestationPool.ts +1 -1
  230. package/src/chain/opPools/payloadAttestationPool.ts +3 -3
  231. package/src/chain/opPools/syncCommitteeMessagePool.ts +1 -1
  232. package/src/chain/opPools/syncContributionAndProofPool.ts +1 -1
  233. package/src/chain/opPools/utils.ts +1 -1
  234. package/src/chain/options.ts +1 -1
  235. package/src/chain/prepareNextSlot.ts +1 -1
  236. package/src/chain/seenCache/seenAttesters.ts +31 -5
  237. package/src/chain/seenCache/seenPayloadEnvelopeInput.ts +145 -14
  238. package/src/chain/validation/attestation.ts +1 -7
  239. package/src/chain/validation/attesterSlashing.ts +1 -8
  240. package/src/chain/validation/executionPayloadBid.ts +1 -2
  241. package/src/chain/validation/executionPayloadEnvelope.ts +0 -1
  242. package/src/chain/validation/payloadAttestationMessage.ts +6 -17
  243. package/src/chain/validation/proposerPreferences.ts +15 -5
  244. package/src/chain/validation/proposerSlashing.ts +1 -1
  245. package/src/execution/builder/http.ts +11 -11
  246. package/src/metrics/metrics/beacon.ts +9 -9
  247. package/src/metrics/metrics/lodestar.ts +113 -54
  248. package/src/network/gossip/topic.ts +38 -0
  249. package/src/network/libp2p/index.ts +11 -2
  250. package/src/network/network.ts +27 -55
  251. package/src/network/processor/gossipHandlers.ts +14 -1
  252. package/src/network/reqresp/score.ts +5 -11
  253. package/src/network/util.ts +0 -5
  254. package/src/node/nodejs.ts +2 -1
  255. package/src/sync/range/batch.ts +83 -28
  256. package/src/sync/range/chain.ts +26 -11
  257. package/src/sync/types.ts +3 -1
  258. package/src/sync/unknownBlock.ts +115 -26
  259. package/src/sync/utils/downloadByRange.ts +21 -12
  260. package/src/sync/utils/downloadByRoot.ts +3 -1
  261. package/lib/chain/bls/maybeBatch.d.ts +0 -12
  262. package/lib/chain/bls/maybeBatch.d.ts.map +0 -1
  263. package/lib/chain/bls/maybeBatch.js +0 -35
  264. package/lib/chain/bls/maybeBatch.js.map +0 -1
  265. package/src/chain/bls/maybeBatch.ts +0 -45
@@ -1,4 +1,4 @@
1
- import {Signature, aggregateSignatures} from "@chainsafe/blst";
1
+ import {Signature, aggregateSignatures} from "@chainsafe/lodestar-z/blst";
2
2
  import {BitArray} from "@chainsafe/ssz";
3
3
  import {ChainForkConfig} from "@lodestar/config";
4
4
  import {MAX_COMMITTEES_PER_SLOT, MAX_PAYLOAD_ATTESTATIONS, PTC_SIZE} from "@lodestar/params";
@@ -178,8 +178,8 @@ function aggregateMessageInto(
178
178
  validatorCommitteeIndices: number[],
179
179
  aggregate: AggregateFast
180
180
  ): InsertOutcome {
181
- // Gossip dedup via `seenPayloadAttesters` is keyed by (epoch, validatorIndex), so the same
182
- // validator's message is never processed twice all of its bits are set together or none.
181
+ // Gossip dedup via `seenPayloadAttesters` is keyed by (slot, validatorIndex), so the same
182
+ // validator's message is never processed twice for this aggregate's slot. All of its bits are set together or none.
183
183
  // Checking the first index is sufficient.
184
184
  if (aggregate.aggregationBits.get(validatorCommitteeIndices[0]) === true) {
185
185
  return InsertOutcome.AlreadyKnown;
@@ -1,4 +1,4 @@
1
- import {Signature, aggregateSignatures} from "@chainsafe/blst";
1
+ import {Signature, aggregateSignatures} from "@chainsafe/lodestar-z/blst";
2
2
  import {BitArray} from "@chainsafe/ssz";
3
3
  import {ChainForkConfig} from "@lodestar/config";
4
4
  import {SYNC_COMMITTEE_SIZE, SYNC_COMMITTEE_SUBNET_COUNT} from "@lodestar/params";
@@ -1,4 +1,4 @@
1
- import {Signature, aggregateSignatures} from "@chainsafe/blst";
1
+ import {Signature, aggregateSignatures} from "@chainsafe/lodestar-z/blst";
2
2
  import {BitArray} from "@chainsafe/ssz";
3
3
  import {ChainForkConfig} from "@lodestar/config";
4
4
  import {SYNC_COMMITTEE_SIZE, SYNC_COMMITTEE_SUBNET_SIZE} from "@lodestar/params";
@@ -1,4 +1,4 @@
1
- import {Signature} from "@chainsafe/blst";
1
+ import {Signature} from "@chainsafe/lodestar-z/blst";
2
2
  import {BLS_WITHDRAWAL_PREFIX} from "@lodestar/params";
3
3
  import {IBeaconStateView} from "@lodestar/state-transition";
4
4
  import {Slot, capella} from "@lodestar/types";
@@ -53,7 +53,7 @@ export type IChainOptions = BlockProcessOpts &
53
53
  nativeStateView?: boolean;
54
54
  /** Builder circuit breaker fault inspection window in slots */
55
55
  faultInspectionWindow?: number;
56
- /** Allowed unrevealed payloads within the fault inspection window */
56
+ /** Canonical EMPTY blocks allowed per `faultInspectionWindow` observed blocks */
57
57
  allowedFaults?: number;
58
58
  };
59
59
 
@@ -169,7 +169,7 @@ export class PrepareNextSlotScheduler {
169
169
  }
170
170
 
171
171
  if (isForkPostGloas(fork)) {
172
- this.chain.builderCircuitBreaker.update(clockSlot);
172
+ this.chain.builderCircuitBreaker.update(clockSlot, updatedHead);
173
173
  } else {
174
174
  // Update the builder status, if enabled shoot an api call to check status
175
175
  this.chain.updateBuilderStatus(clockSlot);
@@ -1,4 +1,5 @@
1
- import {Epoch, ValidatorIndex} from "@lodestar/types";
1
+ import {computeEpochAtSlot} from "@lodestar/state-transition";
2
+ import {Epoch, Slot, ValidatorIndex} from "@lodestar/types";
2
3
  import {MapDef} from "@lodestar/utils";
3
4
 
4
5
  // How many *non future* epochs we intend to keep for SeenAttesters.
@@ -57,7 +58,32 @@ export class SeenAttesters {
57
58
  */
58
59
  export class SeenAggregators extends SeenAttesters {}
59
60
 
60
- /**
61
- * Keeps a cache to filter payload attestations from the same attesters in the same epoch
62
- */
63
- export class SeenPayloadAttesters extends SeenAttesters {}
61
+ /** Keeps a cache to filter payload attestations from the same validator in the same slot. */
62
+ export class SeenPayloadAttesters {
63
+ private readonly validatorIndexesBySlot = new MapDef<Slot, Set<ValidatorIndex>>(() => new Set<ValidatorIndex>());
64
+ private readonly validatorIndexesByEpoch = new SeenAttesters();
65
+
66
+ isKnown(slot: Slot, validatorIndex: ValidatorIndex): boolean {
67
+ return this.validatorIndexesBySlot.get(slot)?.has(validatorIndex) === true;
68
+ }
69
+
70
+ add(slot: Slot, validatorIndex: ValidatorIndex): void {
71
+ const epoch = computeEpochAtSlot(slot);
72
+ this.validatorIndexesByEpoch.add(epoch, validatorIndex);
73
+ this.validatorIndexesBySlot.getOrDefault(slot).add(validatorIndex);
74
+ }
75
+
76
+ seenAtEpoch(epoch: Epoch, validatorIndex: ValidatorIndex): boolean {
77
+ return this.validatorIndexesByEpoch.isKnown(epoch, validatorIndex);
78
+ }
79
+
80
+ prune(currentEpoch: Epoch): void {
81
+ const lowestPermissibleEpoch = Math.max(currentEpoch - EPOCH_LOOKBACK_LIMIT, 0);
82
+ for (const slot of this.validatorIndexesBySlot.keys()) {
83
+ if (computeEpochAtSlot(slot) < lowestPermissibleEpoch) {
84
+ this.validatorIndexesBySlot.delete(slot);
85
+ }
86
+ }
87
+ this.validatorIndexesByEpoch.prune(currentEpoch);
88
+ }
89
+ }
@@ -1,18 +1,32 @@
1
1
  import {ChainForkConfig} from "@lodestar/config";
2
2
  import {CheckpointWithHex, IForkChoice, PayloadStatus, ProtoBlock} from "@lodestar/fork-choice";
3
+ import {ForkPostGloas, SLOTS_PER_EPOCH, isForkPostGloas} from "@lodestar/params";
3
4
  import {computeStartSlotAtEpoch} from "@lodestar/state-transition";
4
- import {RootHex} from "@lodestar/types";
5
- import {Logger} from "@lodestar/utils";
5
+ import {RootHex, SignedBeaconBlock} from "@lodestar/types";
6
+ import {Logger, fromHex} from "@lodestar/utils";
7
+ import {IBeaconDb} from "../../db/index.js";
6
8
  import {Metrics} from "../../metrics/metrics.js";
9
+ import {MAX_LOOK_AHEAD_EPOCHS} from "../../sync/constants.js";
7
10
  import {IClock} from "../../util/clock.js";
11
+ import {CustodyConfig} from "../../util/dataColumns.js";
8
12
  import {SerializedCache} from "../../util/serializedCache.js";
9
13
  import {isDaOutOfRange} from "../blocks/blockInput/index.js";
10
- import {CreateFromBidProps, CreateFromBlockProps, PayloadEnvelopeInput} from "../blocks/payloadEnvelopeInput/index.js";
14
+ import {
15
+ CreateFromBidProps,
16
+ CreateFromBlockProps,
17
+ PayloadEnvelopeInput,
18
+ PayloadEnvelopeInputPruneReason,
19
+ PayloadEnvelopeInputSource,
20
+ } from "../blocks/payloadEnvelopeInput/index.js";
11
21
  import {ChainEvent, ChainEventEmitter} from "../emitter.js";
22
+ import {SeenBlockInput} from "./seenGossipBlockInput.js";
12
23
 
13
24
  export type {PayloadEnvelopeInputState} from "../blocks/payloadEnvelopeInput/index.js";
14
25
  export {PayloadEnvelopeInput} from "../blocks/payloadEnvelopeInput/index.js";
15
26
 
27
+ // Bound this cache by this max size, this is the same to SeenBlockInput
28
+ const MAX_PAYLOAD_ENVELOPE_INPUT_CACHE_SIZE = (MAX_LOOK_AHEAD_EPOCHS + 1) * SLOTS_PER_EPOCH;
29
+
16
30
  export type SeenPayloadEnvelopeInputModules = {
17
31
  config: ChainForkConfig;
18
32
  clock: IClock;
@@ -20,6 +34,9 @@ export type SeenPayloadEnvelopeInputModules = {
20
34
  chainEvents: ChainEventEmitter;
21
35
  signal: AbortSignal;
22
36
  serializedCache: SerializedCache;
37
+ db: IBeaconDb;
38
+ seenBlockInputCache: SeenBlockInput;
39
+ custodyConfig: CustodyConfig;
23
40
  metrics: Metrics | null;
24
41
  logger?: Logger;
25
42
  };
@@ -40,9 +57,14 @@ export class SeenPayloadEnvelopeInput {
40
57
  private readonly chainEvents: ChainEventEmitter;
41
58
  private readonly signal: AbortSignal;
42
59
  private readonly serializedCache: SerializedCache;
60
+ private readonly db: IBeaconDb;
61
+ private readonly seenBlockInputCache: SeenBlockInput;
62
+ private readonly custodyConfig: CustodyConfig;
43
63
  private readonly metrics: Metrics | null;
44
64
  private readonly logger?: Logger;
45
65
  private payloadInputs = new Map<RootHex, PayloadEnvelopeInput>();
66
+ // Dedup concurrent DB reloads of the same root so callers share one reconstructed object.
67
+ private readonly reloading = new Map<RootHex, Promise<PayloadEnvelopeInput | undefined>>();
46
68
 
47
69
  constructor({
48
70
  config,
@@ -51,6 +73,9 @@ export class SeenPayloadEnvelopeInput {
51
73
  chainEvents,
52
74
  signal,
53
75
  serializedCache,
76
+ db,
77
+ seenBlockInputCache,
78
+ custodyConfig,
54
79
  metrics,
55
80
  logger,
56
81
  }: SeenPayloadEnvelopeInputModules) {
@@ -60,6 +85,9 @@ export class SeenPayloadEnvelopeInput {
60
85
  this.chainEvents = chainEvents;
61
86
  this.signal = signal;
62
87
  this.serializedCache = serializedCache;
88
+ this.db = db;
89
+ this.seenBlockInputCache = seenBlockInputCache;
90
+ this.custodyConfig = custodyConfig;
63
91
  this.metrics = metrics;
64
92
  this.logger = logger;
65
93
 
@@ -86,7 +114,7 @@ export class SeenPayloadEnvelopeInput {
86
114
  let deletedCount = 0;
87
115
  for (const [, input] of this.payloadInputs) {
88
116
  if (input.slot < finalizedSlot) {
89
- this.evictPayloadInput(input);
117
+ this.evictPayloadInput(input, "finalized");
90
118
  deletedCount++;
91
119
  }
92
120
  }
@@ -110,12 +138,13 @@ export class SeenPayloadEnvelopeInput {
110
138
  const daOutOfRange = isDaOutOfRange(this.config, props.forkName, props.block.message.slot, this.clock.currentEpoch);
111
139
  const input = PayloadEnvelopeInput.createFromBlock({...props, daOutOfRange});
112
140
  this.payloadInputs.set(props.blockRootHex, input);
113
- this.metrics?.seenCache.payloadEnvelopeInput.created.inc();
141
+ this.metrics?.seenCache.payloadEnvelopeInput.created.inc({source: props.source});
114
142
  this.logger?.verbose("SeenPayloadEnvelopeInput.add created new entry", {
115
143
  slot: input.slot,
116
144
  root: props.blockRootHex,
117
145
  daOutOfRange,
118
146
  });
147
+ this.pruneToMaxSize();
119
148
  return input;
120
149
  }
121
150
 
@@ -131,12 +160,13 @@ export class SeenPayloadEnvelopeInput {
131
160
  const daOutOfRange = isDaOutOfRange(this.config, props.forkName, props.slot, this.clock.currentEpoch);
132
161
  const input = PayloadEnvelopeInput.createFromBid({...props, daOutOfRange});
133
162
  this.payloadInputs.set(props.blockRootHex, input);
134
- this.metrics?.seenCache.payloadEnvelopeInput.created.inc();
163
+ this.metrics?.seenCache.payloadEnvelopeInput.created.inc({source: props.source});
135
164
  this.logger?.verbose("SeenPayloadEnvelopeInput.addFromBid created new entry", {
136
165
  slot: input.slot,
137
166
  root: props.blockRootHex,
138
167
  daOutOfRange,
139
168
  });
169
+ this.pruneToMaxSize();
140
170
  return input;
141
171
  }
142
172
 
@@ -144,6 +174,80 @@ export class SeenPayloadEnvelopeInput {
144
174
  return this.payloadInputs.get(blockRootHex);
145
175
  }
146
176
 
177
+ /**
178
+ * Like `get()`, but on a cache miss reconstruct the shell (bid + versionedHashes) from the block
179
+ * in `seenBlockInputCache` or the hot DB.
180
+ * This api is meant for BlockInputSync when a late/weird payloads for old blocks
181
+ *
182
+ * NOTE: the reconstructed entry is always EMPTY even when the block is actually FULL (its
183
+ * payload envelope + columns persisted in the DB). The consumer should consult fork choice if it needs to.
184
+ */
185
+ async getOrReload(blockRootHex: RootHex): Promise<PayloadEnvelopeInput | undefined> {
186
+ const existing = this.payloadInputs.get(blockRootHex);
187
+ if (existing !== undefined) {
188
+ return existing;
189
+ }
190
+
191
+ // Without this dedup, two concurrent misses each db.block.get + createFromBlock a DIFFERENT shell
192
+ // for the same root; processPayloadEnvelopeJob's WeakMap (keyed by object) can't dedup the import.
193
+ const inflight = this.reloading.get(blockRootHex);
194
+ if (inflight !== undefined) {
195
+ return inflight;
196
+ }
197
+ const promise = this.reloadFromDb(blockRootHex);
198
+ this.reloading.set(blockRootHex, promise);
199
+ try {
200
+ return await promise;
201
+ } finally {
202
+ this.reloading.delete(blockRootHex);
203
+ }
204
+ }
205
+
206
+ private async reloadFromDb(blockRootHex: RootHex): Promise<PayloadEnvelopeInput | undefined> {
207
+ // Only recover unfinalized, fork-choice-known blocks. Do not read the finalized archive. The gate
208
+ // also filters out un-imported blocks that may sit in seenBlockInputCache before validation.
209
+ if (!this.forkChoice.hasBlockHex(blockRootHex)) {
210
+ return undefined;
211
+ }
212
+
213
+ // In-memory first: persistBlockInput writes db.block THEN prunes seenBlockInputCache, so a
214
+ // just-imported block whose async write (unfinalizedBlockWrites) has not flushed yet is still here;
215
+ // older blocks (already pruned from the cache) fall through to the hot db.
216
+ const cachedBlockInput = this.seenBlockInputCache.get(blockRootHex);
217
+ const block = cachedBlockInput?.hasBlock()
218
+ ? cachedBlockInput.getBlock()
219
+ : await this.db.block.get(fromHex(blockRootHex));
220
+ if (block == null) {
221
+ return undefined;
222
+ }
223
+
224
+ const forkName = this.config.getForkName(block.message.slot);
225
+ if (!isForkPostGloas(forkName)) {
226
+ return undefined;
227
+ }
228
+
229
+ const daOutOfRange = isDaOutOfRange(this.config, forkName, block.message.slot, this.clock.currentEpoch);
230
+ const input = PayloadEnvelopeInput.createFromBlock({
231
+ blockRootHex,
232
+ block: block as SignedBeaconBlock<ForkPostGloas>,
233
+ forkName,
234
+ sampledColumns: this.custodyConfig.sampledColumns,
235
+ custodyColumns: this.custodyConfig.custodyColumns,
236
+ seenTimestampSec: Date.now() / 1000,
237
+ source: PayloadEnvelopeInputSource.reload,
238
+ daOutOfRange,
239
+ });
240
+ this.payloadInputs.set(blockRootHex, input);
241
+ this.metrics?.seenCache.payloadEnvelopeInput.created.inc({source: PayloadEnvelopeInputSource.reload});
242
+ this.logger?.verbose("SeenPayloadEnvelopeInput.getOrReload reconstructed entry from db", {
243
+ slot: input.slot,
244
+ root: blockRootHex,
245
+ });
246
+ // Set above (entry is at the back of the insertion order), so the cap never evicts what we just reloaded.
247
+ this.pruneToMaxSize();
248
+ return input;
249
+ }
250
+
147
251
  hasPayload(blockRootHex: RootHex): boolean {
148
252
  return this.payloadInputs.get(blockRootHex)?.hasPayloadEnvelope() ?? false;
149
253
  }
@@ -155,8 +259,7 @@ export class SeenPayloadEnvelopeInput {
155
259
  prune(blockRootHex: RootHex): void {
156
260
  const input = this.payloadInputs.get(blockRootHex);
157
261
  if (input) {
158
- this.evictPayloadInput(input);
159
- this.logger?.verbose("SeenPayloadEnvelopeInput.prune deleted", {slot: input.slot, root: blockRootHex});
262
+ this.evictPayloadInput(input, "prune");
160
263
  }
161
264
  }
162
265
 
@@ -170,17 +273,45 @@ export class SeenPayloadEnvelopeInput {
170
273
  // ...and don't evict while columns are still being gathered: writeDataColumnsToDb awaits the
171
274
  // same hasComputedAllData() before persisting. Such entries are pruned by a later call.
172
275
  if (input?.hasComputedAllData()) {
173
- this.evictPayloadInput(input);
174
- this.logger?.verbose("SeenPayloadEnvelopeInput.pruneBelowParent deleted", {
175
- slot: block.slot,
176
- root: block.blockRoot,
177
- });
276
+ this.evictPayloadInput(input, "belowParent");
178
277
  }
179
278
  }
180
279
  }
181
280
  }
182
281
 
183
- private evictPayloadInput(payloadInput: PayloadEnvelopeInput): void {
282
+ /**
283
+ * Backstop cap for entries pruneBelowParent/pruneFinalized can't reach (non-canonical forks,
284
+ * EMPTY/PENDING entries). Evicts by INSERTION ORDER — the Map iterates oldest-inserted first — so a
285
+ * just-reloaded old-slot entry (set at the back) survives while genuinely stale forks/shells are shed.
286
+ * Runs after every single insert, so it evicts ~1 per call. Safe because the shared cache is
287
+ * non-load-bearing: range sync reads its batch map, gossip/BlockInputSync recover via getOrReload,
288
+ * and any evicted heavy data is already in the db.
289
+ */
290
+ private pruneToMaxSize(): void {
291
+ let evicted = 0;
292
+ for (const input of this.payloadInputs.values()) {
293
+ if (this.payloadInputs.size <= MAX_PAYLOAD_ENVELOPE_INPUT_CACHE_SIZE) {
294
+ break;
295
+ }
296
+ this.evictPayloadInput(input, "cap");
297
+ evicted++;
298
+ }
299
+ if (evicted > 0) {
300
+ this.logger?.debug("SeenPayloadEnvelopeInput.pruneToMaxSize evicted", {
301
+ evicted,
302
+ size: this.payloadInputs.size,
303
+ max: MAX_PAYLOAD_ENVELOPE_INPUT_CACHE_SIZE,
304
+ });
305
+ }
306
+ }
307
+
308
+ private evictPayloadInput(payloadInput: PayloadEnvelopeInput, reason: PayloadEnvelopeInputPruneReason): void {
309
+ this.metrics?.seenCache.payloadEnvelopeInput.pruned.inc({reason});
310
+ this.logger?.debug("SeenPayloadEnvelopeInput evicted", {
311
+ slot: payloadInput.slot,
312
+ root: payloadInput.blockRootHex,
313
+ reason,
314
+ });
184
315
  this.serializedCache.delete(payloadInput.getSerializedCacheKeys());
185
316
  this.payloadInputs.delete(payloadInput.blockRootHex);
186
317
  }
@@ -142,13 +142,7 @@ export async function validateGossipAttestationsSameAttData(
142
142
  const batchableBls = signatureSets.length >= chain.opts.minSameMessageSignatureSetsToBatch;
143
143
  if (batchableBls) {
144
144
  // all signature sets should have same signing root since we filtered in network processor
145
- signatureValids = await chain.bls.verifySignatureSetsSameMessage(
146
- signatureSets.map((set) => {
147
- const publicKey = chain.pubkeyCache.getOrThrow(set.index);
148
- return {publicKey, signature: set.signature};
149
- }),
150
- signatureSets[0].signingRoot
151
- );
145
+ signatureValids = await chain.bls.verifySignatureSetsSameMessage(signatureSets, signatureSets[0].signingRoot);
152
146
  } else {
153
147
  // don't want to block the main thread if there are too few signatures
154
148
  signatureValids = await Promise.all(
@@ -44,14 +44,7 @@ export async function validateAttesterSlashing(
44
44
  // [REJECT] All of the conditions within process_attester_slashing pass validation.
45
45
  try {
46
46
  // verifySignature = false, verified in batch below
47
- assertValidAttesterSlashing(
48
- chain.config,
49
- chain.pubkeyCache,
50
- state.slot,
51
- state.validatorCount,
52
- attesterSlashing,
53
- false
54
- );
47
+ assertValidAttesterSlashing(chain.config, state.slot, state.validatorCount, attesterSlashing, false);
55
48
  } catch (e) {
56
49
  throw new AttesterSlashingError(GossipAction.REJECT, {
57
50
  code: AttesterSlashingErrorCode.INVALID,
@@ -1,4 +1,3 @@
1
- import {PublicKey} from "@chainsafe/blst";
2
1
  import {IForkChoice, ProtoBlock} from "@lodestar/fork-choice";
3
2
  import {PAYLOAD_BUILDER_VERSION} from "@lodestar/params";
4
3
  import {
@@ -345,7 +344,7 @@ async function validateExecutionPayloadBid(
345
344
 
346
345
  // [REJECT] `signed_execution_payload_bid.signature` is valid with respect to the `bid.builder_index`.
347
346
  const signatureSet = createSingleSignatureSetFromComponents(
348
- PublicKey.fromBytes(builder.pubkey),
347
+ builder.pubkey,
349
348
  getExecutionPayloadBidSigningRoot(chain.config, bid),
350
349
  signedExecutionPayloadBid.signature
351
350
  );
@@ -170,7 +170,6 @@ async function validateExecutionPayloadEnvelope(
170
170
  // by `verify_execution_payload_envelope_signature`.
171
171
  const signatureSet = getExecutionPayloadEnvelopeSignatureSet(
172
172
  chain.config,
173
- chain.pubkeyCache,
174
173
  blockState,
175
174
  executionPayloadEnvelope,
176
175
  payloadInput.proposerIndex
@@ -1,6 +1,5 @@
1
1
  import {
2
- computeEpochAtSlot,
3
- createSingleSignatureSetFromComponents,
2
+ createIndexedSignatureSetFromComponents,
4
3
  getPayloadAttestationDataSigningRoot,
5
4
  isStatePostGloas,
6
5
  } from "@lodestar/state-transition";
@@ -36,7 +35,6 @@ async function validatePayloadAttestationMessage(
36
35
  prioritizeBls = false
37
36
  ): Promise<PayloadAttestationValidationResult> {
38
37
  const {data, validatorIndex} = payloadAttestationMessage;
39
- const epoch = computeEpochAtSlot(data.slot);
40
38
 
41
39
  // [IGNORE] The message's slot is for the current slot (with a `MAXIMUM_GOSSIP_CLOCK_DISPARITY` allowance), i.e. `data.slot == current_slot`.
42
40
  if (!chain.clock.isCurrentSlotGivenGossipDisparity(data.slot)) {
@@ -48,9 +46,8 @@ async function validatePayloadAttestationMessage(
48
46
  }
49
47
 
50
48
  // [IGNORE] The `payload_attestation_message` is the first valid message received
51
- // from the validator with index `payload_attestation_message.validator_index`.
52
- // A single validator can participate PTC at most once per epoch
53
- if (chain.seenPayloadAttesters.isKnown(epoch, validatorIndex)) {
49
+ // for the slot from the validator with index `payload_attestation_message.validator_index`.
50
+ if (chain.seenPayloadAttesters.isKnown(data.slot, validatorIndex)) {
54
51
  throw new PayloadAttestationError(GossipAction.IGNORE, {
55
52
  code: PayloadAttestationErrorCode.PAYLOAD_ATTESTATION_ALREADY_KNOWN,
56
53
  validatorIndex,
@@ -114,16 +111,8 @@ async function validatePayloadAttestationMessage(
114
111
  }
115
112
 
116
113
  // [REJECT] `payload_attestation_message.signature` is valid with respect to the validator's public key.
117
- const validatorPubkey = chain.pubkeyCache.get(validatorIndex);
118
- if (!validatorPubkey) {
119
- throw new PayloadAttestationError(GossipAction.REJECT, {
120
- code: PayloadAttestationErrorCode.INVALID_ATTESTER,
121
- attesterIndex: validatorIndex,
122
- });
123
- }
124
-
125
- const signatureSet = createSingleSignatureSetFromComponents(
126
- validatorPubkey,
114
+ const signatureSet = createIndexedSignatureSetFromComponents(
115
+ validatorIndex,
127
116
  getPayloadAttestationDataSigningRoot(chain.config, data),
128
117
  payloadAttestationMessage.signature
129
118
  );
@@ -135,7 +124,7 @@ async function validatePayloadAttestationMessage(
135
124
  }
136
125
 
137
126
  // Valid
138
- chain.seenPayloadAttesters.add(epoch, validatorIndex);
127
+ chain.seenPayloadAttesters.add(data.slot, validatorIndex);
139
128
 
140
129
  return {
141
130
  attDataRootHex: toRootHex(ssz.gloas.PayloadAttestationData.hashTreeRoot(data)),
@@ -1,9 +1,9 @@
1
1
  import {IForkChoice, ProtoBlock} from "@lodestar/fork-choice";
2
- import {GENESIS_EPOCH, GENESIS_SLOT, MIN_SEED_LOOKAHEAD, SLOTS_PER_EPOCH} from "@lodestar/params";
2
+ import {GENESIS_EPOCH, GENESIS_SLOT, MIN_SEED_LOOKAHEAD, SLOTS_PER_EPOCH, isForkPostGloas} from "@lodestar/params";
3
3
  import {
4
4
  computeEpochAtSlot,
5
5
  computeStartSlotAtEpoch,
6
- createSingleSignatureSetFromComponents,
6
+ createIndexedSignatureSetFromComponents,
7
7
  getProposerPreferencesSigningRoot,
8
8
  } from "@lodestar/state-transition";
9
9
  import {Epoch, Slot, ValidatorIndex, gloas} from "@lodestar/types";
@@ -13,7 +13,7 @@ import {IBeaconChain} from "../index.js";
13
13
 
14
14
  /**
15
15
  * Validates a gossiped `SignedProposerPreferences` per
16
- * https://github.com/ethereum/consensus-specs/blob/v1.7.0-alpha.13/specs/gloas/p2p-interface.md#new-proposer_preferences
16
+ * https://github.com/ethereum/consensus-specs/blob/v1.7.0-alpha.14/specs/gloas/p2p-interface.md#new-proposer_preferences
17
17
  */
18
18
  export async function validateGossipProposerPreferences(
19
19
  chain: IBeaconChain,
@@ -24,6 +24,16 @@ export async function validateGossipProposerPreferences(
24
24
  const dependentRootHex = toRootHex(dependentRoot);
25
25
  const proposalEpoch = computeEpochAtSlot(proposalSlot);
26
26
 
27
+ // [IGNORE] The proposal epoch is after the Gloas upgrade
28
+ const proposalFork = chain.config.getForkName(proposalSlot);
29
+ if (!isForkPostGloas(proposalFork)) {
30
+ throw new ProposerPreferencesError(GossipAction.IGNORE, {
31
+ code: ProposerPreferencesErrorCode.PRE_GLOAS_PROPOSAL_SLOT,
32
+ proposalSlot,
33
+ proposalFork,
34
+ });
35
+ }
36
+
27
37
  // [IGNORE] `preferences.proposal_slot` is within the proposer lookahead,
28
38
  // allowing for `MAXIMUM_GOSSIP_CLOCK_DISPARITY`.
29
39
  const currentEpoch = computeEpochAtSlot(chain.clock.currentSlotWithGossipDisparity);
@@ -129,8 +139,8 @@ export async function validateGossipProposerPreferences(
129
139
  }
130
140
 
131
141
  // [REJECT] `signed_proposer_preferences.signature` is valid with respect to the validator's public key.
132
- const signatureSet = createSingleSignatureSetFromComponents(
133
- chain.pubkeyCache.getOrThrow(validatorIndex),
142
+ const signatureSet = createIndexedSignatureSetFromComponents(
143
+ validatorIndex,
134
144
  getProposerPreferencesSigningRoot(chain.config, preferences),
135
145
  signedProposerPreferences.signature
136
146
  );
@@ -37,7 +37,7 @@ async function validateProposerSlashing(
37
37
  try {
38
38
  const proposer = state.getValidator(proposerSlashing.signedHeader1.message.proposerIndex);
39
39
  // verifySignature = false, verified in batch below
40
- assertValidProposerSlashing(chain.config, chain.pubkeyCache, state.slot, proposerSlashing, proposer, false);
40
+ assertValidProposerSlashing(chain.config, state.slot, proposerSlashing, proposer, false);
41
41
  } catch (e) {
42
42
  throw new ProposerSlashingError(GossipAction.REJECT, {
43
43
  code: ProposerSlashingErrorCode.INVALID,
@@ -71,15 +71,18 @@ export class NoBidReceived extends Error {
71
71
  }
72
72
 
73
73
  /**
74
- * Beacon clients select randomized values from the following ranges when initializing
75
- * the circuit breaker (so at boot time and once for each unique boot).
74
+ * Default circuit breaker parameters:
76
75
  *
77
- * ALLOWED_FAULTS: between 1 and SLOTS_PER_EPOCH // 4
78
- * FAULT_INSPECTION_WINDOW: between SLOTS_PER_EPOCH and 2 * SLOTS_PER_EPOCH
76
+ * SLOTS_PER_EPOCH <= FAULT_INSPECTION_WINDOW < 2 * SLOTS_PER_EPOCH (randomized at initialization)
77
+ * ALLOWED_FAULTS: FAULT_INSPECTION_WINDOW // 4
79
78
  *
80
- * The values are randomized per node so builders cannot predict when a given proposer will
81
- * fall back to local blocks. With fixed thresholds a builder could withhold payloads right up
82
- * to the limit without ever tripping the breaker.
79
+ * e.g. on mainnet SLOTS_PER_EPOCH is 32, so FAULT_INSPECTION_WINDOW is between 32 and 63,
80
+ * and a window of 40 results in ALLOWED_FAULTS = 10.
81
+ *
82
+ * The randomized default window keeps the exact slots under inspection unpredictable per node,
83
+ * so a builder cannot tell when past faults age out of a given proposer's window and time
84
+ * withholding around trip or recovery points. Explicitly configured windows are clamped to at
85
+ * least SLOTS_PER_EPOCH, and configured allowedFaults is capped at the default ~25% budget.
83
86
  */
84
87
  export function getFaultInspectionParams(opts: {faultInspectionWindow?: number; allowedFaults?: number}): {
85
88
  faultInspectionWindow: number;
@@ -90,10 +93,7 @@ export function getFaultInspectionParams(opts: {faultInspectionWindow?: number;
90
93
  SLOTS_PER_EPOCH
91
94
  );
92
95
  // allowedFaults should be < faultInspectionWindow, limiting them to faultInspectionWindow/4
93
- const allowedFaults = Math.min(
94
- opts.allowedFaults ?? Math.floor(faultInspectionWindow / 4),
95
- Math.floor(faultInspectionWindow / 4)
96
- );
96
+ const allowedFaults = Math.min(opts.allowedFaults ?? Infinity, Math.floor(faultInspectionWindow / 4));
97
97
  return {faultInspectionWindow, allowedFaults};
98
98
  }
99
99
 
@@ -143,17 +143,17 @@ export function createBeaconMetrics(register: RegistryMetricCreator) {
143
143
  name: "beacon_builder_circuit_breaker_active",
144
144
  help: "Whether the builder circuit breaker is active (1) causing builder bids to be ignored",
145
145
  }),
146
- faults: register.gauge({
147
- name: "beacon_builder_circuit_breaker_faults",
148
- help: "Count of blocks with unrevealed payloads in the fault inspection window",
146
+ canonicalBlocks: register.gauge({
147
+ name: "beacon_builder_circuit_breaker_canonical_blocks",
148
+ help: "Count of canonical FULL and EMPTY blocks in the fault inspection window",
149
149
  }),
150
- blocksPresent: register.gauge({
151
- name: "beacon_builder_circuit_breaker_blocks_present",
152
- help: "Count of blocks present in the fault inspection window",
150
+ fullBlocks: register.gauge({
151
+ name: "beacon_builder_circuit_breaker_full_blocks",
152
+ help: "Count of canonical FULL blocks in the fault inspection window",
153
153
  }),
154
- payloadsRevealed: register.gauge({
155
- name: "beacon_builder_circuit_breaker_payloads_revealed",
156
- help: "Count of blocks with revealed payloads in the fault inspection window",
154
+ emptyBlocks: register.gauge({
155
+ name: "beacon_builder_circuit_breaker_empty_blocks",
156
+ help: "Count of canonical EMPTY blocks in the fault inspection window",
157
157
  }),
158
158
  },
159
159