@lodestar/beacon-node 1.43.0-dev.38479366cc → 1.43.0-dev.3bcc6d0ad5

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 (162) hide show
  1. package/lib/api/impl/beacon/blocks/index.d.ts.map +1 -1
  2. package/lib/api/impl/beacon/blocks/index.js +13 -3
  3. package/lib/api/impl/beacon/blocks/index.js.map +1 -1
  4. package/lib/api/impl/beacon/pool/index.d.ts.map +1 -1
  5. package/lib/api/impl/beacon/pool/index.js +45 -2
  6. package/lib/api/impl/beacon/pool/index.js.map +1 -1
  7. package/lib/api/impl/validator/index.d.ts.map +1 -1
  8. package/lib/api/impl/validator/index.js +66 -1
  9. package/lib/api/impl/validator/index.js.map +1 -1
  10. package/lib/chain/blocks/importBlock.d.ts.map +1 -1
  11. package/lib/chain/blocks/importBlock.js +10 -21
  12. package/lib/chain/blocks/importBlock.js.map +1 -1
  13. package/lib/chain/blocks/importExecutionPayload.d.ts +5 -3
  14. package/lib/chain/blocks/importExecutionPayload.d.ts.map +1 -1
  15. package/lib/chain/blocks/importExecutionPayload.js +23 -10
  16. package/lib/chain/blocks/importExecutionPayload.js.map +1 -1
  17. package/lib/chain/blocks/index.d.ts.map +1 -1
  18. package/lib/chain/blocks/index.js +7 -5
  19. package/lib/chain/blocks/index.js.map +1 -1
  20. package/lib/chain/blocks/payloadEnvelopeInput/payloadEnvelopeInput.d.ts +1 -0
  21. package/lib/chain/blocks/payloadEnvelopeInput/payloadEnvelopeInput.d.ts.map +1 -1
  22. package/lib/chain/blocks/payloadEnvelopeInput/payloadEnvelopeInput.js +5 -1
  23. package/lib/chain/blocks/payloadEnvelopeInput/payloadEnvelopeInput.js.map +1 -1
  24. package/lib/chain/blocks/payloadEnvelopeInput/types.d.ts +1 -0
  25. package/lib/chain/blocks/payloadEnvelopeInput/types.d.ts.map +1 -1
  26. package/lib/chain/blocks/verifyBlock.d.ts +2 -1
  27. package/lib/chain/blocks/verifyBlock.d.ts.map +1 -1
  28. package/lib/chain/blocks/verifyBlock.js +26 -7
  29. package/lib/chain/blocks/verifyBlock.js.map +1 -1
  30. package/lib/chain/blocks/verifyPayloadsDataAvailability.d.ts.map +1 -1
  31. package/lib/chain/blocks/verifyPayloadsDataAvailability.js +8 -3
  32. package/lib/chain/blocks/verifyPayloadsDataAvailability.js.map +1 -1
  33. package/lib/chain/chain.d.ts +2 -1
  34. package/lib/chain/chain.d.ts.map +1 -1
  35. package/lib/chain/chain.js +5 -1
  36. package/lib/chain/chain.js.map +1 -1
  37. package/lib/chain/emitter.d.ts +0 -11
  38. package/lib/chain/emitter.d.ts.map +1 -1
  39. package/lib/chain/emitter.js +0 -4
  40. package/lib/chain/emitter.js.map +1 -1
  41. package/lib/chain/errors/index.d.ts +1 -0
  42. package/lib/chain/errors/index.d.ts.map +1 -1
  43. package/lib/chain/errors/index.js +1 -0
  44. package/lib/chain/errors/index.js.map +1 -1
  45. package/lib/chain/errors/proposerPreferences.d.ts +33 -0
  46. package/lib/chain/errors/proposerPreferences.d.ts.map +1 -0
  47. package/lib/chain/errors/proposerPreferences.js +13 -0
  48. package/lib/chain/errors/proposerPreferences.js.map +1 -0
  49. package/lib/chain/interface.d.ts +2 -1
  50. package/lib/chain/interface.d.ts.map +1 -1
  51. package/lib/chain/interface.js.map +1 -1
  52. package/lib/chain/opPools/payloadAttestationPool.d.ts +3 -2
  53. package/lib/chain/opPools/payloadAttestationPool.d.ts.map +1 -1
  54. package/lib/chain/opPools/payloadAttestationPool.js +26 -4
  55. package/lib/chain/opPools/payloadAttestationPool.js.map +1 -1
  56. package/lib/chain/prepareNextSlot.d.ts.map +1 -1
  57. package/lib/chain/prepareNextSlot.js +15 -17
  58. package/lib/chain/prepareNextSlot.js.map +1 -1
  59. package/lib/chain/produceBlock/produceBlockBody.d.ts +11 -3
  60. package/lib/chain/produceBlock/produceBlockBody.d.ts.map +1 -1
  61. package/lib/chain/produceBlock/produceBlockBody.js +33 -22
  62. package/lib/chain/produceBlock/produceBlockBody.js.map +1 -1
  63. package/lib/chain/regen/interface.d.ts +1 -0
  64. package/lib/chain/regen/interface.d.ts.map +1 -1
  65. package/lib/chain/regen/interface.js +1 -0
  66. package/lib/chain/regen/interface.js.map +1 -1
  67. package/lib/chain/seenCache/index.d.ts +1 -0
  68. package/lib/chain/seenCache/index.d.ts.map +1 -1
  69. package/lib/chain/seenCache/index.js +1 -0
  70. package/lib/chain/seenCache/index.js.map +1 -1
  71. package/lib/chain/seenCache/seenPayloadEnvelopeInput.d.ts +8 -2
  72. package/lib/chain/seenCache/seenPayloadEnvelopeInput.d.ts.map +1 -1
  73. package/lib/chain/seenCache/seenPayloadEnvelopeInput.js +20 -4
  74. package/lib/chain/seenCache/seenPayloadEnvelopeInput.js.map +1 -1
  75. package/lib/chain/seenCache/seenProposerPreferences.d.ts +15 -0
  76. package/lib/chain/seenCache/seenProposerPreferences.d.ts.map +1 -0
  77. package/lib/chain/seenCache/seenProposerPreferences.js +25 -0
  78. package/lib/chain/seenCache/seenProposerPreferences.js.map +1 -0
  79. package/lib/chain/validation/proposerPreferences.d.ts +8 -0
  80. package/lib/chain/validation/proposerPreferences.d.ts.map +1 -0
  81. package/lib/chain/validation/proposerPreferences.js +69 -0
  82. package/lib/chain/validation/proposerPreferences.js.map +1 -0
  83. package/lib/network/gossip/interface.d.ts +7 -1
  84. package/lib/network/gossip/interface.d.ts.map +1 -1
  85. package/lib/network/gossip/interface.js +1 -0
  86. package/lib/network/gossip/interface.js.map +1 -1
  87. package/lib/network/gossip/scoringParameters.d.ts.map +1 -1
  88. package/lib/network/gossip/scoringParameters.js +12 -1
  89. package/lib/network/gossip/scoringParameters.js.map +1 -1
  90. package/lib/network/gossip/topic.d.ts +8 -0
  91. package/lib/network/gossip/topic.d.ts.map +1 -1
  92. package/lib/network/gossip/topic.js +6 -0
  93. package/lib/network/gossip/topic.js.map +1 -1
  94. package/lib/network/interface.d.ts +1 -0
  95. package/lib/network/interface.d.ts.map +1 -1
  96. package/lib/network/network.d.ts +1 -0
  97. package/lib/network/network.d.ts.map +1 -1
  98. package/lib/network/network.js +5 -0
  99. package/lib/network/network.js.map +1 -1
  100. package/lib/network/processor/gossipHandlers.d.ts.map +1 -1
  101. package/lib/network/processor/gossipHandlers.js +22 -15
  102. package/lib/network/processor/gossipHandlers.js.map +1 -1
  103. package/lib/network/processor/gossipQueues/index.d.ts.map +1 -1
  104. package/lib/network/processor/gossipQueues/index.js +5 -0
  105. package/lib/network/processor/gossipQueues/index.js.map +1 -1
  106. package/lib/network/processor/index.d.ts.map +1 -1
  107. package/lib/network/processor/index.js +6 -5
  108. package/lib/network/processor/index.js.map +1 -1
  109. package/lib/sync/range/batch.d.ts +11 -0
  110. package/lib/sync/range/batch.d.ts.map +1 -1
  111. package/lib/sync/range/batch.js +29 -4
  112. package/lib/sync/range/batch.js.map +1 -1
  113. package/lib/sync/range/chain.d.ts.map +1 -1
  114. package/lib/sync/range/chain.js +23 -5
  115. package/lib/sync/range/chain.js.map +1 -1
  116. package/lib/sync/unknownBlock.d.ts +0 -2
  117. package/lib/sync/unknownBlock.d.ts.map +1 -1
  118. package/lib/sync/unknownBlock.js +0 -47
  119. package/lib/sync/unknownBlock.js.map +1 -1
  120. package/lib/sync/utils/downloadByRange.d.ts.map +1 -1
  121. package/lib/sync/utils/downloadByRange.js +21 -15
  122. package/lib/sync/utils/downloadByRange.js.map +1 -1
  123. package/lib/sync/utils/downloadByRoot.d.ts.map +1 -1
  124. package/lib/sync/utils/downloadByRoot.js +10 -0
  125. package/lib/sync/utils/downloadByRoot.js.map +1 -1
  126. package/package.json +15 -15
  127. package/src/api/impl/beacon/blocks/index.ts +16 -3
  128. package/src/api/impl/beacon/pool/index.ts +83 -1
  129. package/src/api/impl/validator/index.ts +80 -0
  130. package/src/chain/blocks/importBlock.ts +9 -36
  131. package/src/chain/blocks/importExecutionPayload.ts +31 -10
  132. package/src/chain/blocks/index.ts +14 -6
  133. package/src/chain/blocks/payloadEnvelopeInput/payloadEnvelopeInput.ts +6 -1
  134. package/src/chain/blocks/payloadEnvelopeInput/types.ts +1 -0
  135. package/src/chain/blocks/verifyBlock.ts +39 -9
  136. package/src/chain/blocks/verifyPayloadsDataAvailability.ts +7 -4
  137. package/src/chain/chain.ts +5 -0
  138. package/src/chain/emitter.ts +0 -11
  139. package/src/chain/errors/index.ts +1 -0
  140. package/src/chain/errors/proposerPreferences.ts +39 -0
  141. package/src/chain/interface.ts +2 -0
  142. package/src/chain/opPools/payloadAttestationPool.ts +29 -8
  143. package/src/chain/prepareNextSlot.ts +20 -28
  144. package/src/chain/produceBlock/produceBlockBody.ts +43 -27
  145. package/src/chain/regen/interface.ts +1 -0
  146. package/src/chain/seenCache/index.ts +1 -0
  147. package/src/chain/seenCache/seenPayloadEnvelopeInput.ts +25 -5
  148. package/src/chain/seenCache/seenProposerPreferences.ts +29 -0
  149. package/src/chain/validation/proposerPreferences.ts +91 -0
  150. package/src/network/gossip/interface.ts +6 -0
  151. package/src/network/gossip/scoringParameters.ts +14 -1
  152. package/src/network/gossip/topic.ts +6 -0
  153. package/src/network/interface.ts +1 -0
  154. package/src/network/network.ts +11 -0
  155. package/src/network/processor/gossipHandlers.ts +31 -16
  156. package/src/network/processor/gossipQueues/index.ts +5 -0
  157. package/src/network/processor/index.ts +6 -5
  158. package/src/sync/range/batch.ts +54 -5
  159. package/src/sync/range/chain.ts +25 -5
  160. package/src/sync/unknownBlock.ts +0 -50
  161. package/src/sync/utils/downloadByRange.ts +21 -15
  162. package/src/sync/utils/downloadByRoot.ts +12 -0
@@ -49,7 +49,7 @@ import {
49
49
  ssz,
50
50
  } from "@lodestar/types";
51
51
  import {Logger, byteArrayEquals, fromHex, sleep, toHex, toPubkeyHex, toRootHex} from "@lodestar/utils";
52
- import {ZERO_HASH, ZERO_HASH_HEX} from "../../constants/index.js";
52
+ import {ZERO_HASH_HEX} from "../../constants/index.js";
53
53
  import {numToQuantity} from "../../execution/engine/utils.js";
54
54
  import {
55
55
  IExecutionBuilder,
@@ -214,19 +214,19 @@ export async function produceBlockBody<T extends BlockType>(
214
214
  });
215
215
 
216
216
  // Get execution payload from EL
217
+ let parentBlockHash: Bytes32;
218
+ let parentExecutionRequests: electra.ExecutionRequests;
219
+ // Apply parent payload once here as it's reused by EL prep and voluntary exit filtering below
220
+ let stateAfterParentPayload: IBeaconStateViewBellatrix = currentState;
217
221
  const isExtendingPayload = this.forkChoice.shouldExtendPayload(toRootHex(parentBlockRoot));
218
- let parentBlockHash = isExtendingPayload
219
- ? currentState.latestExecutionPayloadBid.blockHash
220
- : currentState.latestExecutionPayloadBid.parentBlockHash;
221
- // At gloas genesis the committed bid has no prior EL block to reference
222
- // (`bid.parentBlockHash` is zero). Fall back to `bid.blockHash` (= eth1 genesis hash) so the
223
- // FCU to the EL carries a valid head. Post-genesis bids always reference a non-zero parent.
224
- if (isStatePostGloas(currentState) && byteArrayEquals(parentBlockHash, ZERO_HASH)) {
222
+ if (isExtendingPayload) {
225
223
  parentBlockHash = currentState.latestExecutionPayloadBid.blockHash;
224
+ parentExecutionRequests = await this.getParentExecutionRequests(parentBlock.slot, parentBlock.blockRoot);
225
+ stateAfterParentPayload = currentState.withParentPayloadApplied(parentExecutionRequests);
226
+ } else {
227
+ parentBlockHash = currentState.latestExecutionPayloadBid.parentBlockHash;
228
+ parentExecutionRequests = ssz.electra.ExecutionRequests.defaultValue();
226
229
  }
227
- const parentExecutionRequests = isExtendingPayload
228
- ? await this.getParentExecutionRequests(parentBlock.slot, parentBlock.blockRoot)
229
- : ssz.electra.ExecutionRequests.defaultValue();
230
230
  const prepareRes = await prepareExecutionPayload(
231
231
  this,
232
232
  this.logger,
@@ -235,9 +235,8 @@ export async function produceBlockBody<T extends BlockType>(
235
235
  parentBlockHash,
236
236
  safeBlockHash,
237
237
  finalizedBlockHash ?? ZERO_HASH_HEX,
238
- currentState,
239
- feeRecipient,
240
- parentExecutionRequests
238
+ stateAfterParentPayload,
239
+ feeRecipient
241
240
  );
242
241
 
243
242
  const {prepType, payloadId} = prepareRes;
@@ -291,9 +290,19 @@ export async function produceBlockBody<T extends BlockType>(
291
290
  const commonBlockBody = await commonBlockBodyPromise;
292
291
  const gloasBody = Object.assign({}, commonBlockBody) as gloas.BeaconBlockBody;
293
292
  gloasBody.signedExecutionPayloadBid = signedBid;
294
- // TODO GLOAS: Get payload attestations from pool for previous slot
295
- gloasBody.payloadAttestations = [];
293
+ gloasBody.payloadAttestations = this.payloadAttestationPool.getPayloadAttestationsForBlock(
294
+ parentBlock.blockRoot,
295
+ blockSlot - 1
296
+ );
296
297
  gloasBody.parentExecutionRequests = parentExecutionRequests;
298
+ // Drop voluntary exits that parent_execution_requests have invalidated (e.g. a withdrawal
299
+ // request initiating an exit on the same validator). Op pool selected against the unapplied
300
+ // state, so re-validate against the post-apply state to avoid producing an invalid block.
301
+ if (isExtendingPayload && commonBlockBody.voluntaryExits.length > 0) {
302
+ gloasBody.voluntaryExits = commonBlockBody.voluntaryExits.filter((signedVoluntaryExit) =>
303
+ stateAfterParentPayload.isValidVoluntaryExit(signedVoluntaryExit, false)
304
+ );
305
+ }
297
306
  blockBody = gloasBody as AssembledBodyType<T>;
298
307
 
299
308
  // Store execution payload data required to construct execution payload envelope later
@@ -629,9 +638,12 @@ export async function prepareExecutionPayload(
629
638
  parentBlockHash: Bytes32,
630
639
  safeBlockHash: RootHex,
631
640
  finalizedBlockHash: RootHex,
641
+ /**
642
+ * Post-gloas, when extending a full parent, callers must apply
643
+ * parent execution payload first (see `withParentPayloadApplied`).
644
+ */
632
645
  state: IBeaconStateViewBellatrix,
633
- suggestedFeeRecipient: string,
634
- parentExecutionRequests?: electra.ExecutionRequests
646
+ suggestedFeeRecipient: string
635
647
  ): Promise<{prepType: PayloadPreparationType; payloadId: PayloadId}> {
636
648
  const timestamp = computeTimeAtSlot(chain.config, state.slot, state.genesisTime);
637
649
  const prevRandao = state.getRandaoMix(state.epoch);
@@ -668,7 +680,6 @@ export async function prepareExecutionPayload(
668
680
  parentBlockRoot,
669
681
  parentBlockHash,
670
682
  feeRecipient: suggestedFeeRecipient,
671
- parentExecutionRequests,
672
683
  });
673
684
 
674
685
  payloadId = await chain.executionEngine.notifyForkchoiceUpdate(
@@ -727,14 +738,16 @@ export function getPayloadAttributesForSSE(
727
738
  parentBlockRoot,
728
739
  parentBlockHash,
729
740
  feeRecipient,
730
- parentExecutionRequests,
731
741
  }: {
742
+ /**
743
+ * Post-gloas, when extending a full parent, callers must apply
744
+ * parent execution payload first (see `withParentPayloadApplied`).
745
+ */
732
746
  prepareState: IBeaconStateViewBellatrix;
733
747
  prepareSlot: Slot;
734
748
  parentBlockRoot: Root;
735
749
  parentBlockHash: Bytes32;
736
750
  feeRecipient: string;
737
- parentExecutionRequests?: electra.ExecutionRequests;
738
751
  }
739
752
  ): SSEPayloadAttributes {
740
753
  const payloadAttributes = preparePayloadAttributes(fork, chain, {
@@ -743,7 +756,6 @@ export function getPayloadAttributesForSSE(
743
756
  parentBlockRoot,
744
757
  parentBlockHash,
745
758
  feeRecipient,
746
- parentExecutionRequests,
747
759
  });
748
760
 
749
761
  let parentBlockNumber: number;
@@ -782,14 +794,16 @@ function preparePayloadAttributes(
782
794
  parentBlockRoot,
783
795
  parentBlockHash,
784
796
  feeRecipient,
785
- parentExecutionRequests,
786
797
  }: {
798
+ /**
799
+ * Post-gloas, when extending a full parent, callers must apply
800
+ * parent execution payload first (see `withParentPayloadApplied`).
801
+ */
787
802
  prepareState: IBeaconStateViewBellatrix;
788
803
  prepareSlot: Slot;
789
804
  parentBlockRoot: Root;
790
805
  parentBlockHash: Bytes32;
791
806
  feeRecipient: string;
792
- parentExecutionRequests?: electra.ExecutionRequests;
793
807
  }
794
808
  ): SSEPayloadAttributes["payloadAttributes"] {
795
809
  const timestamp = computeTimeAtSlot(chain.config, prepareSlot, prepareState.genesisTime);
@@ -808,11 +822,13 @@ function preparePayloadAttributes(
808
822
  if (isStatePostGloas(prepareState)) {
809
823
  const isExtendingPayload = byteArrayEquals(parentBlockHash, prepareState.latestExecutionPayloadBid.blockHash);
810
824
  if (isExtendingPayload) {
811
- if (parentExecutionRequests === undefined) {
812
- throw new Error("parentExecutionRequests required when extending full parent");
825
+ // applyParentExecutionPayload sets latestBlockHash = parentBid.blockHash, so a mismatch
826
+ // here means the caller did not apply parent payload to prepareState
827
+ if (!byteArrayEquals(prepareState.latestBlockHash, prepareState.latestExecutionPayloadBid.blockHash)) {
828
+ throw new Error("Expected state with parent execution payload applied for withdrawals");
813
829
  }
814
830
  (payloadAttributes as capella.SSEPayloadAttributes["payloadAttributes"]).withdrawals =
815
- prepareState.getExpectedWithdrawalsForFullParent(parentExecutionRequests);
831
+ prepareState.getExpectedWithdrawals().expectedWithdrawals;
816
832
  } else {
817
833
  // When the parent block is empty, state.payloadExpectedWithdrawals holds a batch
818
834
  // already deducted from CL balances but never credited on the EL (the envelope
@@ -21,6 +21,7 @@ export enum RegenCaller {
21
21
  validateGossipAttestation = "validateGossipAttestation",
22
22
  validateGossipVoluntaryExit = "validateGossipVoluntaryExit",
23
23
  validateGossipExecutionPayloadBid = "validateGossipExecutionPayloadBid",
24
+ validateGossipProposerPreferences = "validateGossipProposerPreferences",
24
25
  onForkChoiceFinalized = "onForkChoiceFinalized",
25
26
  restApi = "restApi",
26
27
  }
@@ -5,3 +5,4 @@ export {SeenContributionAndProof} from "./seenCommitteeContribution.js";
5
5
  export {SeenExecutionPayloadBids} from "./seenExecutionPayloadBids.js";
6
6
  export {SeenBlockInput} from "./seenGossipBlockInput.js";
7
7
  export {PayloadEnvelopeInput, SeenPayloadEnvelopeInput} from "./seenPayloadEnvelopeInput.js";
8
+ export {SeenProposerPreferences} from "./seenProposerPreferences.js";
@@ -1,9 +1,12 @@
1
+ import {ChainForkConfig} from "@lodestar/config";
1
2
  import {CheckpointWithHex} from "@lodestar/fork-choice";
2
3
  import {computeStartSlotAtEpoch} from "@lodestar/state-transition";
3
4
  import {RootHex, Slot} from "@lodestar/types";
4
5
  import {Logger} from "@lodestar/utils";
5
6
  import {Metrics} from "../../metrics/metrics.js";
7
+ import {IClock} from "../../util/clock.js";
6
8
  import {SerializedCache} from "../../util/serializedCache.js";
9
+ import {isDaOutOfRange} from "../blocks/blockInput/index.js";
7
10
  import {CreateFromBlockProps, PayloadEnvelopeInput} from "../blocks/payloadEnvelopeInput/index.js";
8
11
  import {ChainEvent, ChainEventEmitter} from "../emitter.js";
9
12
 
@@ -11,6 +14,8 @@ export type {PayloadEnvelopeInputState} from "../blocks/payloadEnvelopeInput/ind
11
14
  export {PayloadEnvelopeInput} from "../blocks/payloadEnvelopeInput/index.js";
12
15
 
13
16
  export type SeenPayloadEnvelopeInputModules = {
17
+ config: ChainForkConfig;
18
+ clock: IClock;
14
19
  chainEvents: ChainEventEmitter;
15
20
  signal: AbortSignal;
16
21
  serializedCache: SerializedCache;
@@ -32,6 +37,8 @@ export type SeenPayloadEnvelopeInputModules = {
32
37
  * ticks; subsequent ticks settle it back.
33
38
  */
34
39
  export class SeenPayloadEnvelopeInput {
40
+ private readonly config: ChainForkConfig;
41
+ private readonly clock: IClock;
35
42
  private readonly chainEvents: ChainEventEmitter;
36
43
  private readonly signal: AbortSignal;
37
44
  private readonly serializedCache: SerializedCache;
@@ -39,7 +46,9 @@ export class SeenPayloadEnvelopeInput {
39
46
  private readonly logger?: Logger;
40
47
  private payloadInputs = new Map<RootHex, PayloadEnvelopeInput>();
41
48
 
42
- constructor({chainEvents, signal, serializedCache, metrics, logger}: SeenPayloadEnvelopeInputModules) {
49
+ constructor({config, clock, chainEvents, signal, serializedCache, metrics, logger}: SeenPayloadEnvelopeInputModules) {
50
+ this.config = config;
51
+ this.clock = clock;
43
52
  this.chainEvents = chainEvents;
44
53
  this.signal = signal;
45
54
  this.serializedCache = serializedCache;
@@ -68,13 +77,24 @@ export class SeenPayloadEnvelopeInput {
68
77
  this.pruneBelow(computeStartSlotAtEpoch(checkpoint.epoch));
69
78
  };
70
79
 
71
- add(props: CreateFromBlockProps): PayloadEnvelopeInput {
72
- if (this.payloadInputs.has(props.blockRootHex)) {
73
- throw new Error(`PayloadEnvelopeInput already exists for block ${props.blockRootHex}`);
80
+ add(props: Omit<CreateFromBlockProps, "daOutOfRange">): PayloadEnvelopeInput {
81
+ const existing = this.payloadInputs.get(props.blockRootHex);
82
+ if (existing !== undefined) {
83
+ this.logger?.verbose("SeenPayloadEnvelopeInput.add reused existing entry", {
84
+ slot: existing.slot,
85
+ root: props.blockRootHex,
86
+ });
87
+ return existing;
74
88
  }
75
- const input = PayloadEnvelopeInput.createFromBlock(props);
89
+ const daOutOfRange = isDaOutOfRange(this.config, props.forkName, props.block.message.slot, this.clock.currentEpoch);
90
+ const input = PayloadEnvelopeInput.createFromBlock({...props, daOutOfRange});
76
91
  this.payloadInputs.set(props.blockRootHex, input);
77
92
  this.metrics?.seenCache.payloadEnvelopeInput.created.inc();
93
+ this.logger?.verbose("SeenPayloadEnvelopeInput.add created new entry", {
94
+ slot: input.slot,
95
+ root: props.blockRootHex,
96
+ daOutOfRange,
97
+ });
78
98
  return input;
79
99
  }
80
100
 
@@ -0,0 +1,29 @@
1
+ import {Slot, ValidatorIndex} from "@lodestar/types";
2
+ import {MapDef} from "@lodestar/utils";
3
+
4
+ /**
5
+ * Tracks signed proposer preferences we've already seen per (proposal_slot, validator_index).
6
+ */
7
+ export class SeenProposerPreferences {
8
+ private readonly validatorIndexesBySlot = new MapDef<Slot, Set<ValidatorIndex>>(() => new Set<ValidatorIndex>());
9
+
10
+ isKnown(proposalSlot: Slot, validatorIndex: ValidatorIndex): boolean {
11
+ return this.validatorIndexesBySlot.get(proposalSlot)?.has(validatorIndex) === true;
12
+ }
13
+
14
+ add(proposalSlot: Slot, validatorIndex: ValidatorIndex): void {
15
+ this.validatorIndexesBySlot.getOrDefault(proposalSlot).add(validatorIndex);
16
+ }
17
+
18
+ /**
19
+ * Entries are only load-bearing while `proposal_slot > state.slot`. Once the slot has passed the
20
+ * `[IGNORE] proposal_slot > state.slot` gossip rule takes over, so drop them on each slot tick.
21
+ */
22
+ prune(currentSlot: Slot): void {
23
+ for (const slot of this.validatorIndexesBySlot.keys()) {
24
+ if (slot < currentSlot) {
25
+ this.validatorIndexesBySlot.delete(slot);
26
+ }
27
+ }
28
+ }
29
+ }
@@ -0,0 +1,91 @@
1
+ import {SLOTS_PER_EPOCH} from "@lodestar/params";
2
+ import {
3
+ computeEpochAtSlot,
4
+ createSingleSignatureSetFromComponents,
5
+ getProposerPreferencesSigningRoot,
6
+ isStatePostGloas,
7
+ } from "@lodestar/state-transition";
8
+ import {gloas} from "@lodestar/types";
9
+ import {GossipAction, ProposerPreferencesError, ProposerPreferencesErrorCode} from "../errors/index.js";
10
+ import {IBeaconChain} from "../index.js";
11
+ import {RegenCaller} from "../regen/index.js";
12
+
13
+ /**
14
+ * Validates a gossiped `SignedProposerPreferences` per
15
+ * https://github.com/ethereum/consensus-specs/blob/master/specs/gloas/p2p-interface.md#proposer_preferences
16
+ */
17
+ export async function validateGossipProposerPreferences(
18
+ chain: IBeaconChain,
19
+ signedProposerPreferences: gloas.SignedProposerPreferences
20
+ ): Promise<void> {
21
+ const preferences = signedProposerPreferences.message;
22
+ const {proposalSlot, validatorIndex} = preferences;
23
+ const proposalEpoch = computeEpochAtSlot(proposalSlot);
24
+
25
+ // [IGNORE] `preferences.proposal_slot` is in the current or next epoch.
26
+ const currentEpoch = chain.clock.currentEpoch;
27
+ if (proposalEpoch < currentEpoch || proposalEpoch > currentEpoch + 1) {
28
+ throw new ProposerPreferencesError(GossipAction.IGNORE, {
29
+ code: ProposerPreferencesErrorCode.INVALID_EPOCH,
30
+ proposalSlot,
31
+ currentEpoch,
32
+ });
33
+ }
34
+
35
+ // [IGNORE] `preferences.proposal_slot` has not already passed.
36
+ const currentSlot = chain.clock.currentSlot;
37
+ if (proposalSlot <= currentSlot) {
38
+ throw new ProposerPreferencesError(GossipAction.IGNORE, {
39
+ code: ProposerPreferencesErrorCode.PROPOSAL_SLOT_PASSED,
40
+ proposalSlot,
41
+ currentSlot,
42
+ });
43
+ }
44
+
45
+ const state = await chain.getHeadStateAtCurrentEpoch(RegenCaller.validateGossipProposerPreferences);
46
+ if (!isStatePostGloas(state)) {
47
+ throw new Error(`Expected gloas+ state for proposer preferences validation, got fork=${state.forkName}`);
48
+ }
49
+
50
+ // [REJECT] `preferences.validator_index` is present at the correct slot in the current or next
51
+ // epoch's portion of `state.proposer_lookahead` — i.e. `is_valid_proposal_slot(state, preferences)`
52
+ // returns True.
53
+ const epochOffset = proposalEpoch - state.epoch;
54
+ const proposers = epochOffset === 0 ? state.currentProposers : state.nextProposers;
55
+ const expectedProposer = proposers[proposalSlot % SLOTS_PER_EPOCH];
56
+ if (epochOffset < 0 || epochOffset > 1 || expectedProposer !== validatorIndex) {
57
+ throw new ProposerPreferencesError(GossipAction.REJECT, {
58
+ code: ProposerPreferencesErrorCode.INVALID_PROPOSER,
59
+ proposalSlot,
60
+ validatorIndex,
61
+ });
62
+ }
63
+
64
+ // [IGNORE] The `signed_proposer_preferences` is the first valid message received from the validator
65
+ // with index `preferences.validator_index` and the given slot `preferences.proposal_slot`.
66
+ if (chain.seenProposerPreferences.isKnown(proposalSlot, validatorIndex)) {
67
+ throw new ProposerPreferencesError(GossipAction.IGNORE, {
68
+ code: ProposerPreferencesErrorCode.ALREADY_KNOWN,
69
+ proposalSlot,
70
+ validatorIndex,
71
+ });
72
+ }
73
+
74
+ // [REJECT] `signed_proposer_preferences.signature` is valid with respect to the validator's public key.
75
+ const signatureSet = createSingleSignatureSetFromComponents(
76
+ chain.pubkeyCache.getOrThrow(validatorIndex),
77
+ getProposerPreferencesSigningRoot(chain.config, preferences),
78
+ signedProposerPreferences.signature
79
+ );
80
+
81
+ if (!(await chain.bls.verifySignatureSets([signatureSet], {batchable: true}))) {
82
+ throw new ProposerPreferencesError(GossipAction.REJECT, {
83
+ code: ProposerPreferencesErrorCode.INVALID_SIGNATURE,
84
+ proposalSlot,
85
+ validatorIndex,
86
+ });
87
+ }
88
+
89
+ // Valid
90
+ chain.seenProposerPreferences.add(proposalSlot, validatorIndex);
91
+ }
@@ -41,6 +41,7 @@ export enum GossipType {
41
41
  execution_payload = "execution_payload",
42
42
  payload_attestation_message = "payload_attestation_message",
43
43
  execution_payload_bid = "execution_payload_bid",
44
+ proposer_preferences = "proposer_preferences",
44
45
  }
45
46
 
46
47
  export type SequentialGossipType = Exclude<GossipType, GossipType.beacon_attestation>;
@@ -78,6 +79,7 @@ export type GossipTopicTypeMap = {
78
79
  [GossipType.execution_payload]: {type: GossipType.execution_payload};
79
80
  [GossipType.payload_attestation_message]: {type: GossipType.payload_attestation_message};
80
81
  [GossipType.execution_payload_bid]: {type: GossipType.execution_payload_bid};
82
+ [GossipType.proposer_preferences]: {type: GossipType.proposer_preferences};
81
83
  };
82
84
 
83
85
  export type GossipTopicMap = {
@@ -110,6 +112,7 @@ export type GossipTypeMap = {
110
112
  [GossipType.execution_payload]: gloas.SignedExecutionPayloadEnvelope;
111
113
  [GossipType.payload_attestation_message]: gloas.PayloadAttestationMessage;
112
114
  [GossipType.execution_payload_bid]: gloas.SignedExecutionPayloadBid;
115
+ [GossipType.proposer_preferences]: gloas.SignedProposerPreferences;
113
116
  };
114
117
 
115
118
  export type GossipFnByType = {
@@ -141,6 +144,9 @@ export type GossipFnByType = {
141
144
  payloadAttestationMessage: gloas.PayloadAttestationMessage
142
145
  ) => Promise<void> | void;
143
146
  [GossipType.execution_payload_bid]: (executionPayloadBid: gloas.SignedExecutionPayloadBid) => Promise<void> | void;
147
+ [GossipType.proposer_preferences]: (
148
+ signedProposerPreferences: gloas.SignedProposerPreferences
149
+ ) => Promise<void> | void;
144
150
  };
145
151
 
146
152
  export type GossipFn = GossipFnByType[keyof GossipFnByType];
@@ -27,6 +27,7 @@ const BLS_TO_EXECUTION_CHANGE_WEIGHT = 0.05;
27
27
  const EXECUTION_PAYLOAD_WEIGHT = 0.5;
28
28
  const PAYLOAD_ATTESTATION_WEIGHT = 0.05;
29
29
  const EXECUTION_PAYLOAD_BID_WEIGHT = 0.05;
30
+ const PROPOSER_PREFERENCES_WEIGHT = 0.05;
30
31
 
31
32
  const beaconAttestationSubnetWeight = 1 / ATTESTATION_SUBNET_COUNT;
32
33
  const maxPositiveScore =
@@ -40,7 +41,8 @@ const maxPositiveScore =
40
41
  BLS_TO_EXECUTION_CHANGE_WEIGHT +
41
42
  EXECUTION_PAYLOAD_WEIGHT +
42
43
  PAYLOAD_ATTESTATION_WEIGHT +
43
- EXECUTION_PAYLOAD_BID_WEIGHT);
44
+ EXECUTION_PAYLOAD_BID_WEIGHT +
45
+ PROPOSER_PREFERENCES_WEIGHT);
44
46
 
45
47
  /**
46
48
  * The following params is implemented by Lighthouse at
@@ -198,6 +200,17 @@ function getAllTopicsScoreParams(
198
200
  expectedMessageRate: 1024, // TODO GLOAS: Need an estimate for this
199
201
  firstMessageDecayTime: epochDurationMs * 100,
200
202
  });
203
+ topicsParams[
204
+ stringifyGossipTopic(config, {
205
+ type: GossipType.proposer_preferences,
206
+ boundary,
207
+ })
208
+ ] = getTopicScoreParams(config, precomputedParams, {
209
+ topicWeight: PROPOSER_PREFERENCES_WEIGHT,
210
+ // Upper bound ~64 messages per epoch: one per proposer across the current + next epoch.
211
+ expectedMessageRate: 64 / SLOTS_PER_EPOCH,
212
+ firstMessageDecayTime: epochDurationMs * 100,
213
+ });
201
214
 
202
215
  // other topics
203
216
  topicsParams[
@@ -73,6 +73,7 @@ function stringifyGossipTopicType(topic: GossipTopic): string {
73
73
  case GossipType.execution_payload:
74
74
  case GossipType.payload_attestation_message:
75
75
  case GossipType.execution_payload_bid:
76
+ case GossipType.proposer_preferences:
76
77
  return topic.type;
77
78
  case GossipType.beacon_attestation:
78
79
  case GossipType.sync_committee:
@@ -124,6 +125,8 @@ export function getGossipSSZType(topic: GossipTopic) {
124
125
  return ssz.gloas.PayloadAttestationMessage;
125
126
  case GossipType.execution_payload_bid:
126
127
  return ssz.gloas.SignedExecutionPayloadBid;
128
+ case GossipType.proposer_preferences:
129
+ return ssz.gloas.SignedProposerPreferences;
127
130
  }
128
131
  }
129
132
 
@@ -203,6 +206,7 @@ export function parseGossipTopic(forkDigestContext: ForkDigestContext, topicStr:
203
206
  case GossipType.execution_payload:
204
207
  case GossipType.payload_attestation_message:
205
208
  case GossipType.execution_payload_bid:
209
+ case GossipType.proposer_preferences:
206
210
  return {type: gossipTypeStr, boundary, encoding};
207
211
  }
208
212
 
@@ -257,6 +261,7 @@ export function getCoreTopicsAtFork(
257
261
  topics.push({type: GossipType.execution_payload});
258
262
  topics.push({type: GossipType.payload_attestation_message});
259
263
  topics.push({type: GossipType.execution_payload_bid});
264
+ topics.push({type: GossipType.proposer_preferences});
260
265
  }
261
266
 
262
267
  // After fulu also track data_column_sidecar_{index}
@@ -351,4 +356,5 @@ export const gossipTopicIgnoreDuplicatePublishError: Record<GossipType, boolean>
351
356
  [GossipType.execution_payload]: true,
352
357
  [GossipType.payload_attestation_message]: true,
353
358
  [GossipType.execution_payload_bid]: true,
359
+ [GossipType.proposer_preferences]: true,
354
360
  };
@@ -112,6 +112,7 @@ export interface INetwork extends INetworkCorePublic {
112
112
  publishLightClientFinalityUpdate(update: LightClientFinalityUpdate): Promise<number>;
113
113
  publishLightClientOptimisticUpdate(update: LightClientOptimisticUpdate): Promise<number>;
114
114
  publishSignedExecutionPayloadEnvelope(signedEnvelope: gloas.SignedExecutionPayloadEnvelope): Promise<number>;
115
+ publishPayloadAttestationMessage(payloadAttestationMessage: gloas.PayloadAttestationMessage): Promise<number>;
115
116
 
116
117
  // Debug
117
118
  dumpGossipQueue(gossipType: GossipType): Promise<PendingGossipsubMessage[]>;
@@ -515,6 +515,17 @@ export class Network implements INetwork {
515
515
  );
516
516
  }
517
517
 
518
+ async publishPayloadAttestationMessage(payloadAttestationMessage: gloas.PayloadAttestationMessage): Promise<number> {
519
+ const epoch = computeEpochAtSlot(payloadAttestationMessage.data.slot);
520
+ const boundary = this.config.getForkBoundaryAtEpoch(epoch);
521
+
522
+ return this.publishGossip<GossipType.payload_attestation_message>(
523
+ {type: GossipType.payload_attestation_message, boundary},
524
+ payloadAttestationMessage,
525
+ {ignoreDuplicatePublishError: true}
526
+ );
527
+ }
528
+
518
529
  private async publishGossip<K extends GossipType>(
519
530
  topic: GossipTopicMap[K],
520
531
  object: GossipTypeMap[K],
@@ -52,6 +52,8 @@ import {
52
52
  ExecutionPayloadEnvelopeErrorCode,
53
53
  GossipAction,
54
54
  GossipActionError,
55
+ PayloadAttestationError,
56
+ PayloadAttestationErrorCode,
55
57
  SyncCommitteeError,
56
58
  } from "../../chain/errors/index.js";
57
59
  import {IBeaconChain} from "../../chain/interface.js";
@@ -79,6 +81,7 @@ import {
79
81
  import {validateLightClientFinalityUpdate} from "../../chain/validation/lightClientFinalityUpdate.js";
80
82
  import {validateLightClientOptimisticUpdate} from "../../chain/validation/lightClientOptimisticUpdate.js";
81
83
  import {validateGossipPayloadAttestationMessage} from "../../chain/validation/payloadAttestationMessage.js";
84
+ import {validateGossipProposerPreferences} from "../../chain/validation/proposerPreferences.js";
82
85
  import {OpSource} from "../../chain/validatorMonitor.js";
83
86
  import {Metrics} from "../../metrics/index.js";
84
87
  import {kzgCommitmentToVersionedHash} from "../../util/blobs.js";
@@ -182,6 +185,18 @@ function getSequentialHandlers(modules: ValidatorFnsModules, options: GossipHand
182
185
  });
183
186
  try {
184
187
  await validateGossipBlock(config, chain, signedBlock, fork);
188
+
189
+ if (isForkPostGloas(fork)) {
190
+ chain.seenPayloadEnvelopeInputCache.add({
191
+ blockRootHex,
192
+ block: signedBlock as SignedBeaconBlock<ForkPostGloas>,
193
+ forkName: fork,
194
+ sampledColumns: chain.custodyConfig.sampledColumns,
195
+ custodyColumns: chain.custodyConfig.custodyColumns,
196
+ timeCreatedSec: seenTimestampSec,
197
+ });
198
+ }
199
+
185
200
  const blockInputMeta = blockInput.getLogMeta();
186
201
 
187
202
  const recvToValidation = Date.now() / 1000 - seenTimestampSec;
@@ -1060,10 +1075,8 @@ function getSequentialHandlers(modules: ValidatorFnsModules, options: GossipHand
1060
1075
  const signedEnvelope = sszDeserialize(topic, serializedData);
1061
1076
  const envelope = signedEnvelope.message;
1062
1077
 
1063
- // TODO GLOAS: consider optimistically create PayloadEnvelopeInput here similar to how we do that for beacon_block
1064
- // so that UnknownBlockSync can handle backward sync
1065
- // the problem now is we cannot create a PayloadEnvelopeInput without the beacon block being known, we need at least the proposer index
1066
- // we can achieve that by looking into the EpochCache
1078
+ // unlike BlockInput, we send the envelope into UnknownBlockInput sync
1079
+ // inside the sync it'll reconcile into PayloadEnvelopeInput and share the same cache with gossip
1067
1080
  try {
1068
1081
  await validateGossipExecutionPayloadEnvelope(chain, signedEnvelope);
1069
1082
  } catch (e) {
@@ -1071,14 +1084,6 @@ function getSequentialHandlers(modules: ValidatorFnsModules, options: GossipHand
1071
1084
  const {beaconBlockRoot} = signedEnvelope.message;
1072
1085
  const slot = signedEnvelope.message.payload.slotNumber;
1073
1086
  logger.debug("Gossip envelope has error", {slot, root: toRootHex(beaconBlockRoot), code: e.type.code});
1074
- if (e.type.code === ExecutionPayloadEnvelopeErrorCode.BLOCK_ROOT_UNKNOWN) {
1075
- // TODO GLOAS: UnknownBlockSync to handle this
1076
- chain.emitter.emit(ChainEvent.envelopeUnknownBlock, {
1077
- envelope: signedEnvelope,
1078
- peer: peerIdStr,
1079
- source: BlockInputSource.gossip,
1080
- });
1081
- }
1082
1087
 
1083
1088
  if (e.action === GossipAction.REJECT) {
1084
1089
  chain.persistInvalidSszValue(
@@ -1173,6 +1178,14 @@ function getSequentialHandlers(modules: ValidatorFnsModules, options: GossipHand
1173
1178
  data: executionPayloadBid,
1174
1179
  });
1175
1180
  },
1181
+ [GossipType.proposer_preferences]: async ({
1182
+ gossipData,
1183
+ topic,
1184
+ }: GossipHandlerParamGeneric<GossipType.proposer_preferences>) => {
1185
+ const {serializedData} = gossipData;
1186
+ const signedProposerPreferences = sszDeserialize(topic, serializedData);
1187
+ await validateGossipProposerPreferences(chain, signedProposerPreferences);
1188
+ },
1176
1189
  };
1177
1190
  }
1178
1191
 
@@ -1295,10 +1308,12 @@ export async function validateGossipFnRetryUnknownRoot<T>(
1295
1308
  try {
1296
1309
  return await fn();
1297
1310
  } catch (e) {
1298
- if (
1299
- e instanceof AttestationError &&
1300
- e.type.code === AttestationErrorCode.UNKNOWN_OR_PREFINALIZED_BEACON_BLOCK_ROOT
1301
- ) {
1311
+ const isUnknownAttestationRoot =
1312
+ e instanceof AttestationError && e.type.code === AttestationErrorCode.UNKNOWN_OR_PREFINALIZED_BEACON_BLOCK_ROOT;
1313
+ const isUnknownPayloadAttestationRoot =
1314
+ e instanceof PayloadAttestationError && e.type.code === PayloadAttestationErrorCode.UNKNOWN_BLOCK_ROOT;
1315
+
1316
+ if (isUnknownAttestationRoot || isUnknownPayloadAttestationRoot) {
1302
1317
  if (unknownBlockRootRetries === 0) {
1303
1318
  // Trigger unknown block root search here
1304
1319
  const rootHex = toRootHex(blockRoot);
@@ -83,6 +83,11 @@ const linearGossipQueueOpts: {
83
83
  type: QueueType.FIFO,
84
84
  dropOpts: {type: DropType.count, count: 1},
85
85
  },
86
+ [GossipType.proposer_preferences]: {
87
+ maxLength: 1024,
88
+ type: QueueType.FIFO,
89
+ dropOpts: {type: DropType.count, count: 1},
90
+ },
86
91
  };
87
92
 
88
93
  const indexedGossipQueueOpts: {
@@ -76,6 +76,7 @@ type WorkOpts = {
76
76
  */
77
77
  const executeGossipWorkOrderObj: Record<GossipType, WorkOpts> = {
78
78
  [GossipType.beacon_block]: {bypassQueue: true},
79
+ [GossipType.execution_payload]: {bypassQueue: true},
79
80
  [GossipType.blob_sidecar]: {bypassQueue: true},
80
81
  [GossipType.data_column_sidecar]: {bypassQueue: true},
81
82
  [GossipType.beacon_aggregate_and_proof]: {},
@@ -88,9 +89,9 @@ const executeGossipWorkOrderObj: Record<GossipType, WorkOpts> = {
88
89
  [GossipType.sync_committee]: {},
89
90
  [GossipType.light_client_finality_update]: {},
90
91
  [GossipType.light_client_optimistic_update]: {},
91
- [GossipType.execution_payload]: {bypassQueue: true},
92
92
  [GossipType.payload_attestation_message]: {},
93
93
  [GossipType.execution_payload_bid]: {},
94
+ [GossipType.proposer_preferences]: {},
94
95
  };
95
96
  const executeGossipWorkOrder = Object.keys(executeGossipWorkOrderObj) as (keyof typeof executeGossipWorkOrderObj)[];
96
97
 
@@ -443,8 +444,7 @@ export class NetworkProcessor {
443
444
  }
444
445
  case GossipType.execution_payload: {
445
446
  // extractBlockSlotRootFn does not return a root for this topic.
446
- // Extract beacon_block_root directly and proactively trigger block sync if missing.
447
- // Do NOT await the block — the handler runs immediately; BlockInputSync handles recovery.
447
+ // Extract beacon_block_root directly
448
448
  const blockRoot = getBeaconBlockRootFromExecutionPayloadEnvelopeSerialized(message.msg.data);
449
449
  if (blockRoot && !this.chain.forkChoice.hasBlockHexUnsafe(blockRoot)) {
450
450
  this.searchUnknownBlock(
@@ -452,9 +452,10 @@ export class NetworkProcessor {
452
452
  BlockInputSource.network_processor,
453
453
  message.propagationSource.toString()
454
454
  );
455
+ // We always want to await the block
456
+ // This allows us to properly forward the payload envelope
457
+ preprocessResult = {action: PreprocessAction.AwaitBlock, root: blockRoot};
455
458
  }
456
- // do not await the block, we want UnknownBlockSync to handle it.
457
- preprocessResult = {action: PreprocessAction.PushToQueue};
458
459
  break;
459
460
  }
460
461
  case GossipType.execution_payload_bid: {