@aztec/sequencer-client 0.0.1-commit.6a729f7 → 0.0.1-commit.6b113946b

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 (77) hide show
  1. package/dest/client/sequencer-client.d.ts +12 -7
  2. package/dest/client/sequencer-client.d.ts.map +1 -1
  3. package/dest/client/sequencer-client.js +56 -17
  4. package/dest/config.d.ts +26 -7
  5. package/dest/config.d.ts.map +1 -1
  6. package/dest/config.js +47 -28
  7. package/dest/global_variable_builder/global_builder.d.ts +2 -4
  8. package/dest/global_variable_builder/global_builder.d.ts.map +1 -1
  9. package/dest/global_variable_builder/global_builder.js +5 -4
  10. package/dest/publisher/config.d.ts +35 -17
  11. package/dest/publisher/config.d.ts.map +1 -1
  12. package/dest/publisher/config.js +106 -42
  13. package/dest/publisher/index.d.ts +2 -1
  14. package/dest/publisher/index.d.ts.map +1 -1
  15. package/dest/publisher/l1_tx_failed_store/factory.d.ts +11 -0
  16. package/dest/publisher/l1_tx_failed_store/factory.d.ts.map +1 -0
  17. package/dest/publisher/l1_tx_failed_store/factory.js +22 -0
  18. package/dest/publisher/l1_tx_failed_store/failed_tx_store.d.ts +59 -0
  19. package/dest/publisher/l1_tx_failed_store/failed_tx_store.d.ts.map +1 -0
  20. package/dest/publisher/l1_tx_failed_store/failed_tx_store.js +1 -0
  21. package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.d.ts +15 -0
  22. package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.d.ts.map +1 -0
  23. package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.js +34 -0
  24. package/dest/publisher/l1_tx_failed_store/index.d.ts +4 -0
  25. package/dest/publisher/l1_tx_failed_store/index.d.ts.map +1 -0
  26. package/dest/publisher/l1_tx_failed_store/index.js +2 -0
  27. package/dest/publisher/sequencer-publisher-factory.d.ts +11 -3
  28. package/dest/publisher/sequencer-publisher-factory.d.ts.map +1 -1
  29. package/dest/publisher/sequencer-publisher-factory.js +27 -2
  30. package/dest/publisher/sequencer-publisher.d.ts +30 -9
  31. package/dest/publisher/sequencer-publisher.d.ts.map +1 -1
  32. package/dest/publisher/sequencer-publisher.js +323 -38
  33. package/dest/sequencer/checkpoint_proposal_job.d.ts +19 -7
  34. package/dest/sequencer/checkpoint_proposal_job.d.ts.map +1 -1
  35. package/dest/sequencer/checkpoint_proposal_job.js +259 -162
  36. package/dest/sequencer/events.d.ts +2 -1
  37. package/dest/sequencer/events.d.ts.map +1 -1
  38. package/dest/sequencer/metrics.d.ts +21 -5
  39. package/dest/sequencer/metrics.d.ts.map +1 -1
  40. package/dest/sequencer/metrics.js +97 -15
  41. package/dest/sequencer/sequencer.d.ts +30 -15
  42. package/dest/sequencer/sequencer.d.ts.map +1 -1
  43. package/dest/sequencer/sequencer.js +93 -80
  44. package/dest/sequencer/timetable.d.ts +4 -6
  45. package/dest/sequencer/timetable.d.ts.map +1 -1
  46. package/dest/sequencer/timetable.js +7 -11
  47. package/dest/sequencer/types.d.ts +2 -2
  48. package/dest/sequencer/types.d.ts.map +1 -1
  49. package/dest/test/index.d.ts +3 -5
  50. package/dest/test/index.d.ts.map +1 -1
  51. package/dest/test/mock_checkpoint_builder.d.ts +11 -11
  52. package/dest/test/mock_checkpoint_builder.d.ts.map +1 -1
  53. package/dest/test/mock_checkpoint_builder.js +45 -34
  54. package/dest/test/utils.d.ts +3 -3
  55. package/dest/test/utils.d.ts.map +1 -1
  56. package/dest/test/utils.js +5 -4
  57. package/package.json +27 -28
  58. package/src/client/sequencer-client.ts +77 -18
  59. package/src/config.ts +65 -38
  60. package/src/global_variable_builder/global_builder.ts +4 -3
  61. package/src/publisher/config.ts +121 -43
  62. package/src/publisher/index.ts +3 -0
  63. package/src/publisher/l1_tx_failed_store/factory.ts +32 -0
  64. package/src/publisher/l1_tx_failed_store/failed_tx_store.ts +55 -0
  65. package/src/publisher/l1_tx_failed_store/file_store_failed_tx_store.ts +46 -0
  66. package/src/publisher/l1_tx_failed_store/index.ts +3 -0
  67. package/src/publisher/sequencer-publisher-factory.ts +38 -6
  68. package/src/publisher/sequencer-publisher.ts +327 -52
  69. package/src/sequencer/checkpoint_proposal_job.ts +348 -173
  70. package/src/sequencer/events.ts +1 -1
  71. package/src/sequencer/metrics.ts +106 -18
  72. package/src/sequencer/sequencer.ts +129 -92
  73. package/src/sequencer/timetable.ts +13 -12
  74. package/src/sequencer/types.ts +1 -1
  75. package/src/test/index.ts +2 -4
  76. package/src/test/mock_checkpoint_builder.ts +63 -49
  77. package/src/test/utils.ts +5 -2
@@ -1,5 +1,3 @@
1
- import { NUM_CHECKPOINT_END_MARKER_FIELDS, getNumBlockEndBlobFields } from '@aztec/blob-lib/encoding';
2
- import { BLOBS_PER_CHECKPOINT, FIELDS_PER_BLOB } from '@aztec/constants';
3
1
  import type { EpochCache } from '@aztec/epoch-cache';
4
2
  import {
5
3
  BlockNumber,
@@ -9,6 +7,11 @@ import {
9
7
  SlotNumber,
10
8
  } from '@aztec/foundation/branded-types';
11
9
  import { randomInt } from '@aztec/foundation/crypto/random';
10
+ import {
11
+ flipSignature,
12
+ generateRecoverableSignature,
13
+ generateUnrecoverableSignature,
14
+ } from '@aztec/foundation/crypto/secp256k1-signer';
12
15
  import { Fr } from '@aztec/foundation/curves/bn254';
13
16
  import { EthAddress } from '@aztec/foundation/eth-address';
14
17
  import { Signature } from '@aztec/foundation/eth-signature';
@@ -27,18 +30,23 @@ import {
27
30
  type L2BlockSource,
28
31
  MaliciousCommitteeAttestationsAndSigners,
29
32
  } from '@aztec/stdlib/block';
30
- import type { Checkpoint } from '@aztec/stdlib/checkpoint';
31
- import { getSlotStartBuildTimestamp } from '@aztec/stdlib/epoch-helpers';
33
+ import { type Checkpoint, validateCheckpoint } from '@aztec/stdlib/checkpoint';
34
+ import { getSlotStartBuildTimestamp, getTimestampForSlot } from '@aztec/stdlib/epoch-helpers';
32
35
  import { Gas } from '@aztec/stdlib/gas';
33
36
  import {
34
- NoValidTxsError,
35
- type PublicProcessorLimits,
37
+ type BlockBuilderOptions,
38
+ InsufficientValidTxsError,
36
39
  type ResolvedSequencerConfig,
37
40
  type WorldStateSynchronizer,
38
41
  } from '@aztec/stdlib/interfaces/server';
39
42
  import { type L1ToL2MessageSource, computeInHashFromL1ToL2Messages } from '@aztec/stdlib/messaging';
40
- import type { BlockProposalOptions, CheckpointProposal, CheckpointProposalOptions } from '@aztec/stdlib/p2p';
41
- import { orderAttestations } from '@aztec/stdlib/p2p';
43
+ import type {
44
+ BlockProposal,
45
+ BlockProposalOptions,
46
+ CheckpointProposal,
47
+ CheckpointProposalOptions,
48
+ } from '@aztec/stdlib/p2p';
49
+ import { orderAttestations, trimAttestations } from '@aztec/stdlib/p2p';
42
50
  import type { L2BlockBuiltStats } from '@aztec/stdlib/stats';
43
51
  import { type FailedTx, Tx } from '@aztec/stdlib/tx';
44
52
  import { AttestationTimeoutError } from '@aztec/stdlib/validators';
@@ -69,8 +77,10 @@ export class CheckpointProposalJob implements Traceable {
69
77
  protected readonly log: Logger;
70
78
 
71
79
  constructor(
72
- private readonly epoch: EpochNumber,
73
- private readonly slot: SlotNumber,
80
+ private readonly slotNow: SlotNumber,
81
+ private readonly targetSlot: SlotNumber,
82
+ private readonly epochNow: EpochNumber,
83
+ private readonly targetEpoch: EpochNumber,
74
84
  private readonly checkpointNumber: CheckpointNumber,
75
85
  private readonly syncedToBlockNumber: BlockNumber,
76
86
  // TODO(palla/mbps): Can we remove the proposer in favor of attestorAddress? Need to check fisherman-node flows.
@@ -98,7 +108,20 @@ export class CheckpointProposalJob implements Traceable {
98
108
  public readonly tracer: Tracer,
99
109
  bindings?: LoggerBindings,
100
110
  ) {
101
- this.log = createLogger('sequencer:checkpoint-proposal', { ...bindings, instanceId: `slot-${slot}` });
111
+ this.log = createLogger('sequencer:checkpoint-proposal', {
112
+ ...bindings,
113
+ instanceId: `slot-${this.slotNow}`,
114
+ });
115
+ }
116
+
117
+ /** The wall-clock slot during which the proposer builds. */
118
+ private get slot(): SlotNumber {
119
+ return this.slotNow;
120
+ }
121
+
122
+ /** The wall-clock epoch. */
123
+ private get epoch(): EpochNumber {
124
+ return this.epochNow;
102
125
  }
103
126
 
104
127
  /**
@@ -111,7 +134,7 @@ export class CheckpointProposalJob implements Traceable {
111
134
  // In fisherman mode, we simulate slashing but don't actually publish to L1
112
135
  // These are constant for the whole slot, so we only enqueue them once
113
136
  const votesPromises = new CheckpointVoter(
114
- this.slot,
137
+ this.targetSlot,
115
138
  this.publisher,
116
139
  this.attestorAddress,
117
140
  this.validatorClient,
@@ -129,7 +152,7 @@ export class CheckpointProposalJob implements Traceable {
129
152
  await Promise.all(votesPromises);
130
153
 
131
154
  if (checkpoint) {
132
- this.metrics.recordBlockProposalSuccess();
155
+ this.metrics.recordCheckpointProposalSuccess();
133
156
  }
134
157
 
135
158
  // Do not post anything to L1 if we are fishermen, but do perform L1 fee analysis
@@ -138,6 +161,29 @@ export class CheckpointProposalJob implements Traceable {
138
161
  return;
139
162
  }
140
163
 
164
+ // If pipelining, wait until the submission slot so L1 recognizes the pipelined proposer
165
+ if (this.epochCache.isProposerPipeliningEnabled()) {
166
+ const submissionSlotTimestamp =
167
+ getTimestampForSlot(this.targetSlot, this.l1Constants) - BigInt(this.l1Constants.ethereumSlotDuration);
168
+ this.log.info(`Waiting until submission slot ${this.targetSlot} for L1 submission`, {
169
+ slot: this.slot,
170
+ submissionSlot: this.targetSlot,
171
+ submissionSlotTimestamp,
172
+ });
173
+ await sleepUntil(new Date(Number(submissionSlotTimestamp) * 1000), this.dateProvider.nowAsDate());
174
+
175
+ // After waking, verify the parent checkpoint wasn't pruned during the sleep.
176
+ // We check L1's pending tip directly instead of canProposeAt, which also validates the proposer
177
+ // identity and would fail because the timestamp resolves to a different slot's proposer.
178
+ const l1Tips = await this.publisher.rollupContract.getTips();
179
+ if (l1Tips.pending < this.checkpointNumber - 1) {
180
+ this.log.warn(
181
+ `Parent checkpoint was pruned during pipelining sleep (L1 pending=${l1Tips.pending}, expected>=${this.checkpointNumber - 1}), skipping L1 submission for checkpoint ${this.checkpointNumber}`,
182
+ );
183
+ return undefined;
184
+ }
185
+ }
186
+
141
187
  // Then send everything to L1
142
188
  const l1Response = await this.publisher.sendRequests();
143
189
  const proposedAction = l1Response?.successfulActions.find(a => a === 'propose');
@@ -156,7 +202,7 @@ export class CheckpointProposalJob implements Traceable {
156
202
  return {
157
203
  // nullish operator needed for tests
158
204
  [Attributes.COINBASE]: this.validatorClient.getCoinbaseForAttestor(this.attestorAddress)?.toString(),
159
- [Attributes.SLOT_NUMBER]: this.slot,
205
+ [Attributes.SLOT_NUMBER]: this.targetSlot,
160
206
  };
161
207
  })
162
208
  private async proposeCheckpoint(): Promise<Checkpoint | undefined> {
@@ -166,8 +212,15 @@ export class CheckpointProposalJob implements Traceable {
166
212
  const feeRecipient = this.validatorClient.getFeeRecipientForAttestor(this.attestorAddress);
167
213
 
168
214
  // Start the checkpoint
169
- this.setStateFn(SequencerState.INITIALIZING_CHECKPOINT, this.slot);
170
- this.metrics.incOpenSlot(this.slot, this.proposer?.toString() ?? 'unknown');
215
+ this.setStateFn(SequencerState.INITIALIZING_CHECKPOINT, this.targetSlot);
216
+ this.log.info(`Starting checkpoint proposal`, {
217
+ buildSlot: this.slot,
218
+ submissionSlot: this.targetSlot,
219
+ pipelining: this.epochCache.isProposerPipeliningEnabled(),
220
+ proposer: this.proposer?.toString(),
221
+ coinbase: coinbase.toString(),
222
+ });
223
+ this.metrics.incOpenSlot(this.targetSlot, this.proposer?.toString() ?? 'unknown');
171
224
 
172
225
  // Enqueues checkpoint invalidation (constant for the whole slot)
173
226
  if (this.invalidateCheckpoint && !this.config.skipInvalidateBlockAsProposer) {
@@ -178,7 +231,7 @@ export class CheckpointProposalJob implements Traceable {
178
231
  const checkpointGlobalVariables = await this.globalsBuilder.buildCheckpointGlobalVariables(
179
232
  coinbase,
180
233
  feeRecipient,
181
- this.slot,
234
+ this.targetSlot,
182
235
  );
183
236
 
184
237
  // Collect L1 to L2 messages for the checkpoint and compute their hash
@@ -186,18 +239,21 @@ export class CheckpointProposalJob implements Traceable {
186
239
  const inHash = computeInHashFromL1ToL2Messages(l1ToL2Messages);
187
240
 
188
241
  // Collect the out hashes of all the checkpoints before this one in the same epoch
189
- const previousCheckpoints = (await this.l2BlockSource.getCheckpointsForEpoch(this.epoch)).filter(
190
- c => c.number < this.checkpointNumber,
191
- );
192
- const previousCheckpointOutHashes = previousCheckpoints.map(c => c.getCheckpointOutHash());
242
+ const previousCheckpointOutHashes = (await this.l2BlockSource.getCheckpointsDataForEpoch(this.targetEpoch))
243
+ .filter(c => c.checkpointNumber < this.checkpointNumber)
244
+ .map(c => c.checkpointOutHash);
245
+
246
+ // Get the fee asset price modifier from the oracle
247
+ const feeAssetPriceModifier = await this.publisher.getFeeAssetPriceModifier();
193
248
 
194
249
  // Create a long-lived forked world state for the checkpoint builder
195
- using fork = await this.worldState.fork(this.syncedToBlockNumber, { closeDelayMs: 12_000 });
250
+ await using fork = await this.worldState.fork(this.syncedToBlockNumber, { closeDelayMs: 12_000 });
196
251
 
197
252
  // Create checkpoint builder for the entire slot
198
253
  const checkpointBuilder = await this.checkpointsBuilder.startCheckpoint(
199
254
  this.checkpointNumber,
200
255
  checkpointGlobalVariables,
256
+ feeAssetPriceModifier,
201
257
  l1ToL2Messages,
202
258
  previousCheckpointOutHashes,
203
259
  fork,
@@ -217,6 +273,7 @@ export class CheckpointProposalJob implements Traceable {
217
273
 
218
274
  let blocksInCheckpoint: L2Block[] = [];
219
275
  let blockPendingBroadcast: { block: L2Block; txs: Tx[] } | undefined = undefined;
276
+ const checkpointBuildTimer = new Timer();
220
277
 
221
278
  try {
222
279
  // Main loop: build blocks for the checkpoint
@@ -232,42 +289,64 @@ export class CheckpointProposalJob implements Traceable {
232
289
  // These errors are expected in HA mode, so we yield and let another HA node handle the slot
233
290
  // The only distinction between the 2 errors is SlashingProtectionError throws when the payload is different,
234
291
  // which is normal for block building (may have picked different txs)
235
- if (err instanceof DutyAlreadySignedError) {
236
- this.log.info(`Checkpoint proposal for slot ${this.slot} already signed by another HA node, yielding`, {
237
- slot: this.slot,
238
- signedByNode: err.signedByNode,
239
- });
240
- return undefined;
241
- }
242
- if (err instanceof SlashingProtectionError) {
243
- this.log.info(`Checkpoint proposal for slot ${this.slot} blocked by slashing protection, yielding`, {
244
- slot: this.slot,
245
- existingMessageHash: err.existingMessageHash,
246
- attemptedMessageHash: err.attemptedMessageHash,
247
- });
292
+ if (this.handleHASigningError(err, 'Block proposal')) {
248
293
  return undefined;
249
294
  }
250
295
  throw err;
251
296
  }
252
297
 
253
298
  if (blocksInCheckpoint.length === 0) {
254
- this.log.warn(`No blocks were built for slot ${this.slot}`, { slot: this.slot });
255
- this.eventEmitter.emit('checkpoint-empty', { slot: this.slot });
299
+ this.log.warn(`No blocks were built for slot ${this.targetSlot}`, { slot: this.targetSlot });
300
+ this.eventEmitter.emit('checkpoint-empty', { slot: this.targetSlot });
301
+ return undefined;
302
+ }
303
+
304
+ const minBlocksForCheckpoint = this.config.minBlocksForCheckpoint;
305
+ if (minBlocksForCheckpoint !== undefined && blocksInCheckpoint.length < minBlocksForCheckpoint) {
306
+ this.log.warn(
307
+ `Checkpoint has fewer blocks than minimum (${blocksInCheckpoint.length} < ${minBlocksForCheckpoint}), skipping proposal`,
308
+ { slot: this.targetSlot, blocksBuilt: blocksInCheckpoint.length, minBlocksForCheckpoint },
309
+ );
256
310
  return undefined;
257
311
  }
258
312
 
259
313
  // Assemble and broadcast the checkpoint proposal, including the last block that was not
260
314
  // broadcasted yet, and wait to collect the committee attestations.
261
- this.setStateFn(SequencerState.ASSEMBLING_CHECKPOINT, this.slot);
315
+ this.setStateFn(SequencerState.ASSEMBLING_CHECKPOINT, this.targetSlot);
262
316
  const checkpoint = await checkpointBuilder.completeCheckpoint();
263
317
 
318
+ // Final validation: per-block limits are only checked if the operator set them explicitly.
319
+ // Otherwise, checkpoint-level budgets were already enforced by the redistribution logic.
320
+ try {
321
+ validateCheckpoint(checkpoint, {
322
+ rollupManaLimit: this.l1Constants.rollupManaLimit,
323
+ maxL2BlockGas: this.config.maxL2BlockGas,
324
+ maxDABlockGas: this.config.maxDABlockGas,
325
+ maxTxsPerBlock: this.config.maxTxsPerBlock,
326
+ maxTxsPerCheckpoint: this.config.maxTxsPerCheckpoint,
327
+ });
328
+ } catch (err) {
329
+ this.log.error(`Built an invalid checkpoint at slot ${this.slot} (skipping proposal)`, err, {
330
+ checkpoint: checkpoint.header.toInspect(),
331
+ });
332
+ return undefined;
333
+ }
334
+
335
+ // Record checkpoint-level build metrics
336
+ this.metrics.recordCheckpointBuild(
337
+ checkpointBuildTimer.ms(),
338
+ blocksInCheckpoint.length,
339
+ checkpoint.getStats().txCount,
340
+ Number(checkpoint.header.totalManaUsed.toBigInt()),
341
+ );
342
+
264
343
  // Do not collect attestations nor publish to L1 in fisherman mode
265
344
  if (this.config.fishermanMode) {
266
345
  this.log.info(
267
- `Built checkpoint for slot ${this.slot} with ${blocksInCheckpoint.length} blocks. ` +
346
+ `Built checkpoint for slot ${this.targetSlot} with ${blocksInCheckpoint.length} blocks. ` +
268
347
  `Skipping proposal in fisherman mode.`,
269
348
  {
270
- slot: this.slot,
349
+ slot: this.targetSlot,
271
350
  checkpoint: checkpoint.header.toInspect(),
272
351
  blocksBuilt: blocksInCheckpoint.length,
273
352
  },
@@ -287,6 +366,7 @@ export class CheckpointProposalJob implements Traceable {
287
366
  const proposal = await this.validatorClient.createCheckpointProposal(
288
367
  checkpoint.header,
289
368
  checkpoint.archive.root,
369
+ feeAssetPriceModifier,
290
370
  lastBlock,
291
371
  this.proposer,
292
372
  checkpointProposalOptions,
@@ -295,7 +375,7 @@ export class CheckpointProposalJob implements Traceable {
295
375
  const blockProposedAt = this.dateProvider.now();
296
376
  await this.p2pClient.broadcastCheckpointProposal(proposal);
297
377
 
298
- this.setStateFn(SequencerState.COLLECTING_ATTESTATIONS, this.slot);
378
+ this.setStateFn(SequencerState.COLLECTING_ATTESTATIONS, this.targetSlot);
299
379
  const attestations = await this.waitForAttestations(proposal);
300
380
  const blockAttestedAt = this.dateProvider.now();
301
381
 
@@ -308,35 +388,38 @@ export class CheckpointProposalJob implements Traceable {
308
388
  attestationsSignature = await this.validatorClient.signAttestationsAndSigners(
309
389
  attestations,
310
390
  signer,
311
- this.slot,
391
+ this.targetSlot,
312
392
  this.checkpointNumber,
313
393
  );
314
394
  } catch (err) {
315
395
  // We shouldn't really get here since we yield to another HA node
316
- // as soon as we see these errors when creating block proposals.
317
- if (err instanceof DutyAlreadySignedError) {
318
- this.log.info(`Attestations signature for slot ${this.slot} already signed by another HA node, yielding`, {
319
- slot: this.slot,
320
- signedByNode: err.signedByNode,
321
- });
322
- return undefined;
323
- }
324
- if (err instanceof SlashingProtectionError) {
325
- this.log.info(`Attestations signature for slot ${this.slot} blocked by slashing protection, yielding`, {
326
- slot: this.slot,
327
- existingMessageHash: err.existingMessageHash,
328
- attemptedMessageHash: err.attemptedMessageHash,
329
- });
396
+ // as soon as we see these errors when creating block or checkpoint proposals.
397
+ if (this.handleHASigningError(err, 'Attestations signature')) {
330
398
  return undefined;
331
399
  }
332
400
  throw err;
333
401
  }
334
402
 
335
403
  // Enqueue publishing the checkpoint to L1
336
- this.setStateFn(SequencerState.PUBLISHING_CHECKPOINT, this.slot);
404
+ this.setStateFn(SequencerState.PUBLISHING_CHECKPOINT, this.targetSlot);
337
405
  const aztecSlotDuration = this.l1Constants.slotDuration;
338
- const slotStartBuildTimestamp = this.getSlotStartBuildTimestamp();
339
- const txTimeoutAt = new Date((slotStartBuildTimestamp + aztecSlotDuration) * 1000);
406
+ const submissionSlotStart = Number(getTimestampForSlot(this.targetSlot, this.l1Constants));
407
+ const txTimeoutAt = new Date((submissionSlotStart + aztecSlotDuration) * 1000);
408
+
409
+ // If we have been configured to potentially skip publishing checkpoint then roll the dice here
410
+ if (
411
+ this.config.skipPublishingCheckpointsPercent !== undefined &&
412
+ this.config.skipPublishingCheckpointsPercent > 0
413
+ ) {
414
+ const result = Math.max(0, randomInt(100));
415
+ if (result < this.config.skipPublishingCheckpointsPercent) {
416
+ this.log.warn(
417
+ `Skipping publishing proposal for checkpoint ${checkpoint.number}. Configured percentage: ${this.config.skipPublishingCheckpointsPercent}, generated value: ${result}`,
418
+ );
419
+ return checkpoint;
420
+ }
421
+ }
422
+
340
423
  await this.publisher.enqueueProposeCheckpoint(checkpoint, attestations, attestationsSignature, {
341
424
  txTimeoutAt,
342
425
  forcePendingCheckpointNumber: this.invalidateCheckpoint?.forcePendingCheckpointNumber,
@@ -371,9 +454,6 @@ export class CheckpointProposalJob implements Traceable {
371
454
  const txHashesAlreadyIncluded = new Set<string>();
372
455
  const initialBlockNumber = BlockNumber(this.syncedToBlockNumber + 1);
373
456
 
374
- // Remaining blob fields available for blocks (checkpoint end marker already subtracted)
375
- let remainingBlobFields = BLOBS_PER_CHECKPOINT * FIELDS_PER_BLOB - NUM_CHECKPOINT_END_MARKER_FIELDS;
376
-
377
457
  // Last block in the checkpoint will usually be flagged as pending broadcast, so we send it along with the checkpoint proposal
378
458
  let blockPendingBroadcast: { block: L2Block; txs: Tx[] } | undefined = undefined;
379
459
 
@@ -387,7 +467,7 @@ export class CheckpointProposalJob implements Traceable {
387
467
 
388
468
  if (!timingInfo.canStart) {
389
469
  this.log.debug(`Not enough time left in slot to start another block`, {
390
- slot: this.slot,
470
+ slot: this.targetSlot,
391
471
  blocksBuilt,
392
472
  secondsIntoSlot,
393
473
  });
@@ -406,7 +486,6 @@ export class CheckpointProposalJob implements Traceable {
406
486
  blockNumber,
407
487
  indexWithinCheckpoint,
408
488
  txHashesAlreadyIncluded,
409
- remainingBlobFields,
410
489
  });
411
490
 
412
491
  // TODO(palla/mbps): Review these conditions. We may want to keep trying in some scenarios.
@@ -423,8 +502,8 @@ export class CheckpointProposalJob implements Traceable {
423
502
  } else if ('error' in buildResult) {
424
503
  // If there was an error building the block, just exit the loop and give up the rest of the slot
425
504
  if (!(buildResult.error instanceof SequencerInterruptedError)) {
426
- this.log.warn(`Halting block building for slot ${this.slot}`, {
427
- slot: this.slot,
505
+ this.log.warn(`Halting block building for slot ${this.targetSlot}`, {
506
+ slot: this.targetSlot,
428
507
  blocksBuilt,
429
508
  error: buildResult.error,
430
509
  });
@@ -432,26 +511,16 @@ export class CheckpointProposalJob implements Traceable {
432
511
  break;
433
512
  }
434
513
 
435
- const { block, usedTxs, remainingBlobFields: newRemainingBlobFields } = buildResult;
514
+ const { block, usedTxs } = buildResult;
436
515
  blocksInCheckpoint.push(block);
437
-
438
- // Update remaining blob fields for the next block
439
- remainingBlobFields = newRemainingBlobFields;
440
-
441
- // Sync the proposed block to the archiver to make it available
442
- // Note that the checkpoint builder uses its own fork so it should not need to wait for this syncing
443
- // Eventually we should refactor the checkpoint builder to not need a separate long-lived fork
444
- // Fire and forget - don't block the critical path, but log errors
445
- this.syncProposedBlockToArchiver(block).catch(err => {
446
- this.log.error(`Failed to sync proposed block ${block.number} to archiver`, { blockNumber: block.number, err });
447
- });
448
-
449
516
  usedTxs.forEach(tx => txHashesAlreadyIncluded.add(tx.txHash.toString()));
450
517
 
451
- // If this is the last block, exit the loop now so we start collecting attestations
518
+ // If this is the last block, sync it to the archiver and exit the loop
519
+ // so we can build the checkpoint and start collecting attestations.
452
520
  if (timingInfo.isLastBlock) {
453
- this.log.verbose(`Completed final block ${blockNumber} for slot ${this.slot}`, {
454
- slot: this.slot,
521
+ await this.syncProposedBlockToArchiver(block);
522
+ this.log.verbose(`Completed final block ${blockNumber} for slot ${this.targetSlot}`, {
523
+ slot: this.targetSlot,
455
524
  blockNumber,
456
525
  blocksBuilt,
457
526
  });
@@ -459,38 +528,61 @@ export class CheckpointProposalJob implements Traceable {
459
528
  break;
460
529
  }
461
530
 
462
- // For non-last blocks, broadcast the block proposal (unless we're in fisherman mode)
463
- // If the block is the last one, we'll broadcast it along with the checkpoint at the end of the loop
464
- if (!this.config.fishermanMode) {
465
- const proposal = await this.validatorClient.createBlockProposal(
466
- block.header,
467
- block.indexWithinCheckpoint,
468
- inHash,
469
- block.archive.root,
470
- usedTxs,
471
- this.proposer,
472
- blockProposalOptions,
473
- );
474
- await this.p2pClient.broadcastProposal(proposal);
475
- }
531
+ // Broadcast the block proposal (unless we're in fisherman mode) unless the block is the last one,
532
+ // in which case we'll broadcast it along with the checkpoint at the end of the loop.
533
+ // Note that we only send the block to the archiver if we manage to create the proposal, so if there's
534
+ // a HA error we don't pollute our archiver with a block that won't make it to the chain.
535
+ const proposal = await this.createBlockProposal(block, inHash, usedTxs, blockProposalOptions);
536
+
537
+ // Sync the proposed block to the archiver to make it available, only after we've managed to sign the proposal.
538
+ // We wait for the sync to succeed, as this helps catch consistency errors, even if it means we lose some time for block-building.
539
+ // If this throws, we abort the entire checkpoint.
540
+ await this.syncProposedBlockToArchiver(block);
541
+
542
+ // Once we have a signed proposal and the archiver agreed with our proposed block, then we broadcast it.
543
+ proposal && (await this.p2pClient.broadcastProposal(proposal));
476
544
 
477
545
  // Wait until the next block's start time
478
546
  await this.waitUntilNextSubslot(timingInfo.deadline);
479
547
  }
480
548
 
481
- this.log.verbose(`Block building loop completed for slot ${this.slot}`, {
482
- slot: this.slot,
549
+ this.log.verbose(`Block building loop completed for slot ${this.targetSlot}`, {
550
+ slot: this.targetSlot,
483
551
  blocksBuilt: blocksInCheckpoint.length,
484
552
  });
485
553
 
486
554
  return { blocksInCheckpoint, blockPendingBroadcast };
487
555
  }
488
556
 
557
+ /** Creates a block proposal for a given block via the validator client (unless in fisherman mode) */
558
+ private createBlockProposal(
559
+ block: L2Block,
560
+ inHash: Fr,
561
+ usedTxs: Tx[],
562
+ blockProposalOptions: BlockProposalOptions,
563
+ ): Promise<BlockProposal | undefined> {
564
+ if (this.config.fishermanMode) {
565
+ this.log.info(`Skipping block proposal for block ${block.number} in fisherman mode`);
566
+ return Promise.resolve(undefined);
567
+ }
568
+ return this.validatorClient.createBlockProposal(
569
+ block.header,
570
+ block.indexWithinCheckpoint,
571
+ inHash,
572
+ block.archive.root,
573
+ usedTxs,
574
+ this.proposer,
575
+ blockProposalOptions,
576
+ );
577
+ }
578
+
489
579
  /** Sleeps until it is time to produce the next block in the slot */
490
580
  @trackSpan('CheckpointProposalJob.waitUntilNextSubslot')
491
581
  private async waitUntilNextSubslot(nextSubslotStart: number) {
492
- this.setStateFn(SequencerState.WAITING_UNTIL_NEXT_BLOCK, this.slot);
493
- this.log.verbose(`Waiting until time for the next block at ${nextSubslotStart}s into slot`, { slot: this.slot });
582
+ this.setStateFn(SequencerState.WAITING_UNTIL_NEXT_BLOCK, this.targetSlot);
583
+ this.log.verbose(`Waiting until time for the next block at ${nextSubslotStart}s into slot`, {
584
+ slot: this.targetSlot,
585
+ });
494
586
  await this.waitUntilTimeInSlot(nextSubslotStart);
495
587
  }
496
588
 
@@ -505,34 +597,25 @@ export class CheckpointProposalJob implements Traceable {
505
597
  indexWithinCheckpoint: IndexWithinCheckpoint;
506
598
  buildDeadline: Date | undefined;
507
599
  txHashesAlreadyIncluded: Set<string>;
508
- remainingBlobFields: number;
509
600
  },
510
- ): Promise<{ block: L2Block; usedTxs: Tx[]; remainingBlobFields: number } | { error: Error } | undefined> {
511
- const {
512
- blockTimestamp,
513
- forceCreate,
514
- blockNumber,
515
- indexWithinCheckpoint,
516
- buildDeadline,
517
- txHashesAlreadyIncluded,
518
- remainingBlobFields,
519
- } = opts;
601
+ ): Promise<{ block: L2Block; usedTxs: Tx[] } | { error: Error } | undefined> {
602
+ const { blockTimestamp, forceCreate, blockNumber, indexWithinCheckpoint, buildDeadline, txHashesAlreadyIncluded } =
603
+ opts;
520
604
 
521
605
  this.log.verbose(
522
- `Preparing block ${blockNumber} index ${indexWithinCheckpoint} at checkpoint ${this.checkpointNumber} for slot ${this.slot}`,
606
+ `Preparing block ${blockNumber} index ${indexWithinCheckpoint} at checkpoint ${this.checkpointNumber} for slot ${this.targetSlot}`,
523
607
  { ...checkpointBuilder.getConstantData(), ...opts },
524
608
  );
525
609
 
526
610
  try {
527
611
  // Wait until we have enough txs to build the block
528
- const minTxs = this.config.minTxsPerBlock;
529
- const { availableTxs, canStartBuilding } = await this.waitForMinTxs(opts);
612
+ const { availableTxs, canStartBuilding, minTxs } = await this.waitForMinTxs(opts);
530
613
  if (!canStartBuilding) {
531
614
  this.log.warn(
532
- `Not enough txs to build block ${blockNumber} at index ${indexWithinCheckpoint} in slot ${this.slot} (got ${availableTxs} txs but needs ${minTxs})`,
533
- { blockNumber, slot: this.slot, indexWithinCheckpoint },
615
+ `Not enough txs to build block ${blockNumber} at index ${indexWithinCheckpoint} in slot ${this.targetSlot} (got ${availableTxs} txs but needs ${minTxs})`,
616
+ { blockNumber, slot: this.targetSlot, indexWithinCheckpoint },
534
617
  );
535
- this.eventEmitter.emit('block-tx-count-check-failed', { minTxs, availableTxs, slot: this.slot });
618
+ this.eventEmitter.emit('block-tx-count-check-failed', { minTxs, availableTxs, slot: this.targetSlot });
536
619
  this.metrics.recordBlockProposalFailed('insufficient_txs');
537
620
  return undefined;
538
621
  }
@@ -540,29 +623,36 @@ export class CheckpointProposalJob implements Traceable {
540
623
  // Create iterator to pending txs. We filter out txs already included in previous blocks in the checkpoint
541
624
  // just in case p2p failed to sync the provisional block and didn't get to remove those txs from the mempool yet.
542
625
  const pendingTxs = filter(
543
- this.p2pClient.iteratePendingTxs(),
626
+ this.p2pClient.iterateEligiblePendingTxs(),
544
627
  tx => !txHashesAlreadyIncluded.has(tx.txHash.toString()),
545
628
  );
546
629
 
547
630
  this.log.debug(
548
- `Building block ${blockNumber} at index ${indexWithinCheckpoint} for slot ${this.slot} with ${availableTxs} available txs`,
549
- { slot: this.slot, blockNumber, indexWithinCheckpoint },
631
+ `Building block ${blockNumber} at index ${indexWithinCheckpoint} for slot ${this.targetSlot} with ${availableTxs} available txs`,
632
+ { slot: this.targetSlot, blockNumber, indexWithinCheckpoint },
550
633
  );
551
- this.setStateFn(SequencerState.CREATING_BLOCK, this.slot);
634
+ this.setStateFn(SequencerState.CREATING_BLOCK, this.targetSlot);
552
635
 
553
- // Calculate blob fields limit for txs (remaining capacity - this block's end overhead)
554
- const blockEndOverhead = getNumBlockEndBlobFields(indexWithinCheckpoint === 0);
555
- const maxBlobFieldsForTxs = remainingBlobFields - blockEndOverhead;
556
-
557
- const blockBuilderOptions: PublicProcessorLimits = {
636
+ // Per-block limits are operator overrides (from SEQ_MAX_L2_BLOCK_GAS etc.) further capped
637
+ // by remaining checkpoint-level budgets inside CheckpointBuilder before each block is built.
638
+ // minValidTxs is passed into the builder so it can reject the block *before* updating state.
639
+ const minValidTxs = forceCreate ? 0 : (this.config.minValidTxsPerBlock ?? minTxs);
640
+ const blockBuilderOptions: BlockBuilderOptions = {
558
641
  maxTransactions: this.config.maxTxsPerBlock,
559
- maxBlockSize: this.config.maxBlockSizeInBytes,
560
- maxBlockGas: new Gas(this.config.maxDABlockGas, this.config.maxL2BlockGas),
561
- maxBlobFields: maxBlobFieldsForTxs,
642
+ maxBlockGas:
643
+ this.config.maxL2BlockGas !== undefined || this.config.maxDABlockGas !== undefined
644
+ ? new Gas(this.config.maxDABlockGas ?? Infinity, this.config.maxL2BlockGas ?? Infinity)
645
+ : undefined,
562
646
  deadline: buildDeadline,
647
+ isBuildingProposal: true,
648
+ minValidTxs,
649
+ maxBlocksPerCheckpoint: this.timetable.maxNumberOfBlocks,
650
+ perBlockAllocationMultiplier: this.config.perBlockAllocationMultiplier,
563
651
  };
564
652
 
565
- // Actually build the block by executing txs
653
+ // Actually build the block by executing txs. The builder throws InsufficientValidTxsError
654
+ // if the number of successfully processed txs is below minValidTxs, ensuring state is not
655
+ // updated for blocks that will be discarded.
566
656
  const buildResult = await this.buildSingleBlockWithCheckpointBuilder(
567
657
  checkpointBuilder,
568
658
  pendingTxs,
@@ -574,22 +664,27 @@ export class CheckpointProposalJob implements Traceable {
574
664
  // If any txs failed during execution, drop them from the mempool so we don't pick them up again
575
665
  await this.dropFailedTxsFromP2P(buildResult.failedTxs);
576
666
 
577
- // Check if we have created a block with enough txs. If there were invalid txs in the pool, or if execution took
578
- // too long, then we may not get to minTxsPerBlock after executing public functions.
579
- const minValidTxs = this.config.minValidTxsPerBlock ?? minTxs;
580
- const numTxs = buildResult.status === 'no-valid-txs' ? 0 : buildResult.numTxs;
581
- if (buildResult.status === 'no-valid-txs' || (!forceCreate && numTxs < minValidTxs)) {
667
+ if (buildResult.status === 'insufficient-valid-txs') {
582
668
  this.log.warn(
583
- `Block ${blockNumber} at index ${indexWithinCheckpoint} on slot ${this.slot} has too few valid txs to be proposed`,
584
- { slot: this.slot, blockNumber, numTxs, indexWithinCheckpoint, minValidTxs, buildResult: buildResult.status },
669
+ `Block ${blockNumber} at index ${indexWithinCheckpoint} on slot ${this.targetSlot} has too few valid txs to be proposed`,
670
+ {
671
+ slot: this.targetSlot,
672
+ blockNumber,
673
+ numTxs: buildResult.processedCount,
674
+ indexWithinCheckpoint,
675
+ minValidTxs,
676
+ },
585
677
  );
586
- this.eventEmitter.emit('block-build-failed', { reason: `Insufficient valid txs`, slot: this.slot });
678
+ this.eventEmitter.emit('block-build-failed', {
679
+ reason: `Insufficient valid txs`,
680
+ slot: this.targetSlot,
681
+ });
587
682
  this.metrics.recordBlockProposalFailed('insufficient_valid_txs');
588
683
  return undefined;
589
684
  }
590
685
 
591
686
  // Block creation succeeded, emit stats and metrics
592
- const { publicGas, block, publicProcessorDuration, usedTxs, usedTxBlobFields, blockBuildDuration } = buildResult;
687
+ const { block, publicProcessorDuration, usedTxs, blockBuildDuration, numTxs } = buildResult;
593
688
 
594
689
  const blockStats = {
595
690
  eventName: 'l2-block-built',
@@ -600,33 +695,40 @@ export class CheckpointProposalJob implements Traceable {
600
695
 
601
696
  const blockHash = await block.hash();
602
697
  const txHashes = block.body.txEffects.map(tx => tx.txHash);
603
- const manaPerSec = publicGas.l2Gas / (blockBuildDuration / 1000);
698
+ const manaPerSec = block.header.totalManaUsed.toNumberUnsafe() / (blockBuildDuration / 1000);
604
699
 
605
700
  this.log.info(
606
- `Built block ${block.number} at checkpoint ${this.checkpointNumber} for slot ${this.slot} with ${numTxs} txs`,
701
+ `Built block ${block.number} at checkpoint ${this.checkpointNumber} for slot ${this.targetSlot} with ${numTxs} txs`,
607
702
  { blockHash, txHashes, manaPerSec, ...blockStats },
608
703
  );
609
704
 
610
- this.eventEmitter.emit('block-proposed', { blockNumber: block.number, slot: this.slot });
611
- this.metrics.recordBuiltBlock(blockBuildDuration, publicGas.l2Gas);
705
+ this.eventEmitter.emit('block-proposed', {
706
+ blockNumber: block.number,
707
+ slot: this.targetSlot,
708
+ buildSlot: this.slotNow,
709
+ });
710
+ this.metrics.recordBuiltBlock(blockBuildDuration, block.header.totalManaUsed.toNumberUnsafe());
612
711
 
613
- return { block, usedTxs, remainingBlobFields: maxBlobFieldsForTxs - usedTxBlobFields };
712
+ return { block, usedTxs };
614
713
  } catch (err: any) {
615
- this.eventEmitter.emit('block-build-failed', { reason: err.message, slot: this.slot });
616
- this.log.error(`Error building block`, err, { blockNumber, slot: this.slot });
714
+ this.eventEmitter.emit('block-build-failed', {
715
+ reason: err.message,
716
+ slot: this.targetSlot,
717
+ });
718
+ this.log.error(`Error building block`, err, { blockNumber, slot: this.targetSlot });
617
719
  this.metrics.recordBlockProposalFailed(err.name || 'unknown_error');
618
720
  this.metrics.recordFailedBlock();
619
721
  return { error: err };
620
722
  }
621
723
  }
622
724
 
623
- /** Uses the checkpoint builder to build a block, catching specific txs */
725
+ /** Uses the checkpoint builder to build a block, catching InsufficientValidTxsError. */
624
726
  private async buildSingleBlockWithCheckpointBuilder(
625
727
  checkpointBuilder: CheckpointBuilder,
626
728
  pendingTxs: AsyncIterable<Tx>,
627
729
  blockNumber: BlockNumber,
628
730
  blockTimestamp: bigint,
629
- blockBuilderOptions: PublicProcessorLimits,
731
+ blockBuilderOptions: BlockBuilderOptions,
630
732
  ) {
631
733
  try {
632
734
  const workTimer = new Timer();
@@ -634,8 +736,12 @@ export class CheckpointProposalJob implements Traceable {
634
736
  const blockBuildDuration = workTimer.ms();
635
737
  return { ...result, blockBuildDuration, status: 'success' as const };
636
738
  } catch (err: unknown) {
637
- if (isErrorClass(err, NoValidTxsError)) {
638
- return { failedTxs: err.failedTxs, status: 'no-valid-txs' as const };
739
+ if (isErrorClass(err, InsufficientValidTxsError)) {
740
+ return {
741
+ failedTxs: err.failedTxs,
742
+ processedCount: err.processedCount,
743
+ status: 'insufficient-valid-txs' as const,
744
+ };
639
745
  }
640
746
  throw err;
641
747
  }
@@ -648,7 +754,7 @@ export class CheckpointProposalJob implements Traceable {
648
754
  blockNumber: BlockNumber;
649
755
  indexWithinCheckpoint: IndexWithinCheckpoint;
650
756
  buildDeadline: Date | undefined;
651
- }): Promise<{ canStartBuilding: boolean; availableTxs: number }> {
757
+ }): Promise<{ canStartBuilding: boolean; availableTxs: number; minTxs: number }> {
652
758
  const { indexWithinCheckpoint, blockNumber, buildDeadline, forceCreate } = opts;
653
759
 
654
760
  // We only allow a block with 0 txs in the first block of the checkpoint
@@ -665,20 +771,20 @@ export class CheckpointProposalJob implements Traceable {
665
771
  // If we're past deadline, or we have no deadline, give up
666
772
  const now = this.dateProvider.nowAsDate();
667
773
  if (startBuildingDeadline === undefined || now >= startBuildingDeadline) {
668
- return { canStartBuilding: false, availableTxs: availableTxs };
774
+ return { canStartBuilding: false, availableTxs, minTxs };
669
775
  }
670
776
 
671
777
  // Wait a bit before checking again
672
- this.setStateFn(SequencerState.WAITING_FOR_TXS, this.slot);
778
+ this.setStateFn(SequencerState.WAITING_FOR_TXS, this.targetSlot);
673
779
  this.log.verbose(
674
- `Waiting for enough txs to build block ${blockNumber} at index ${indexWithinCheckpoint} in slot ${this.slot} (have ${availableTxs} but need ${minTxs})`,
675
- { blockNumber, slot: this.slot, indexWithinCheckpoint },
780
+ `Waiting for enough txs to build block ${blockNumber} at index ${indexWithinCheckpoint} in slot ${this.targetSlot} (have ${availableTxs} but need ${minTxs})`,
781
+ { blockNumber, slot: this.targetSlot, indexWithinCheckpoint },
676
782
  );
677
- await sleep(TXS_POLLING_MS);
783
+ await this.waitForTxsPollingInterval();
678
784
  availableTxs = await this.p2pClient.getPendingTxCount();
679
785
  }
680
786
 
681
- return { canStartBuilding: true, availableTxs };
787
+ return { canStartBuilding: true, availableTxs, minTxs };
682
788
  }
683
789
 
684
790
  /**
@@ -730,11 +836,28 @@ export class CheckpointProposalJob implements Traceable {
730
836
 
731
837
  collectedAttestationsCount = attestations.length;
732
838
 
839
+ // Trim attestations to minimum required to save L1 calldata gas
840
+ const localAddresses = this.validatorClient.getValidatorAddresses();
841
+ const trimmed = trimAttestations(
842
+ attestations,
843
+ numberOfRequiredAttestations,
844
+ this.attestorAddress,
845
+ localAddresses,
846
+ );
847
+ if (trimmed.length < attestations.length) {
848
+ this.log.debug(`Trimmed attestations from ${attestations.length} to ${trimmed.length} for L1 submission`);
849
+ }
850
+
733
851
  // Rollup contract requires that the signatures are provided in the order of the committee
734
- const sorted = orderAttestations(attestations, committee);
852
+ const sorted = orderAttestations(trimmed, committee);
735
853
 
736
854
  // Manipulate the attestations if we've been configured to do so
737
- if (this.config.injectFakeAttestation || this.config.shuffleAttestationOrdering) {
855
+ if (
856
+ this.config.injectFakeAttestation ||
857
+ this.config.injectHighSValueAttestation ||
858
+ this.config.injectUnrecoverableSignatureAttestation ||
859
+ this.config.shuffleAttestationOrdering
860
+ ) {
738
861
  return this.manipulateAttestations(proposal.slotNumber, epoch, seed, committee, sorted);
739
862
  }
740
863
 
@@ -763,7 +886,11 @@ export class CheckpointProposalJob implements Traceable {
763
886
  this.epochCache.computeProposerIndex(slotNumber, epoch, seed, BigInt(committee.length)),
764
887
  );
765
888
 
766
- if (this.config.injectFakeAttestation) {
889
+ if (
890
+ this.config.injectFakeAttestation ||
891
+ this.config.injectHighSValueAttestation ||
892
+ this.config.injectUnrecoverableSignatureAttestation
893
+ ) {
767
894
  // Find non-empty attestations that are not from the proposer
768
895
  const nonProposerIndices: number[] = [];
769
896
  for (let i = 0; i < attestations.length; i++) {
@@ -773,8 +900,20 @@ export class CheckpointProposalJob implements Traceable {
773
900
  }
774
901
  if (nonProposerIndices.length > 0) {
775
902
  const targetIndex = nonProposerIndices[randomInt(nonProposerIndices.length)];
776
- this.log.warn(`Injecting fake attestation in checkpoint for slot ${slotNumber} at index ${targetIndex}`);
777
- unfreeze(attestations[targetIndex]).signature = Signature.random();
903
+ if (this.config.injectHighSValueAttestation) {
904
+ this.log.warn(
905
+ `Injecting high-s value attestation in checkpoint for slot ${slotNumber} at index ${targetIndex}`,
906
+ );
907
+ unfreeze(attestations[targetIndex]).signature = flipSignature(attestations[targetIndex].signature);
908
+ } else if (this.config.injectUnrecoverableSignatureAttestation) {
909
+ this.log.warn(
910
+ `Injecting unrecoverable signature attestation in checkpoint for slot ${slotNumber} at index ${targetIndex}`,
911
+ );
912
+ unfreeze(attestations[targetIndex]).signature = generateUnrecoverableSignature();
913
+ } else {
914
+ this.log.warn(`Injecting fake attestation in checkpoint for slot ${slotNumber} at index ${targetIndex}`);
915
+ unfreeze(attestations[targetIndex]).signature = generateRecoverableSignature();
916
+ }
778
917
  }
779
918
  return new CommitteeAttestationsAndSigners(attestations);
780
919
  }
@@ -783,11 +922,20 @@ export class CheckpointProposalJob implements Traceable {
783
922
  this.log.warn(`Shuffling attestation ordering in checkpoint for slot ${slotNumber} (proposer #${proposerIndex})`);
784
923
 
785
924
  const shuffled = [...attestations];
786
- const [i, j] = [(proposerIndex + 1) % shuffled.length, (proposerIndex + 2) % shuffled.length];
787
- const valueI = shuffled[i];
788
- const valueJ = shuffled[j];
789
- shuffled[i] = valueJ;
790
- shuffled[j] = valueI;
925
+
926
+ // Find two non-proposer positions that both have non-empty signatures to swap.
927
+ // This ensures the bitmap doesn't change, so the MaliciousCommitteeAttestationsAndSigners
928
+ // signers array stays correctly aligned with L1's committee reconstruction.
929
+ const swappable: number[] = [];
930
+ for (let k = 0; k < shuffled.length; k++) {
931
+ if (!shuffled[k].signature.isEmpty() && k !== proposerIndex) {
932
+ swappable.push(k);
933
+ }
934
+ }
935
+ if (swappable.length >= 2) {
936
+ const [i, j] = [swappable[0], swappable[1]];
937
+ [shuffled[i], shuffled[j]] = [shuffled[j], shuffled[i]];
938
+ }
791
939
 
792
940
  const signers = new CommitteeAttestationsAndSigners(attestations).getSigners();
793
941
  return new MaliciousCommitteeAttestationsAndSigners(shuffled, signers);
@@ -803,7 +951,7 @@ export class CheckpointProposalJob implements Traceable {
803
951
  const failedTxData = failedTxs.map(fail => fail.tx);
804
952
  const failedTxHashes = failedTxData.map(tx => tx.getTxHash());
805
953
  this.log.verbose(`Dropping failed txs ${failedTxHashes.join(', ')}`);
806
- await this.p2pClient.deleteTxs(failedTxHashes);
954
+ await this.p2pClient.handleFailedExecution(failedTxHashes);
807
955
  }
808
956
 
809
957
  /**
@@ -830,27 +978,49 @@ export class CheckpointProposalJob implements Traceable {
830
978
  private async handleCheckpointEndAsFisherman(checkpoint: Checkpoint | undefined) {
831
979
  // Perform L1 fee analysis before clearing requests
832
980
  // The callback is invoked asynchronously after the next block is mined
833
- const feeAnalysis = await this.publisher.analyzeL1Fees(this.slot, analysis =>
981
+ const feeAnalysis = await this.publisher.analyzeL1Fees(this.targetSlot, analysis =>
834
982
  this.metrics.recordFishermanFeeAnalysis(analysis),
835
983
  );
836
984
 
837
985
  if (checkpoint) {
838
- this.log.info(`Validation checkpoint building SUCCEEDED for slot ${this.slot}`, {
986
+ this.log.info(`Validation checkpoint building SUCCEEDED for slot ${this.targetSlot}`, {
839
987
  ...checkpoint.toCheckpointInfo(),
840
988
  ...checkpoint.getStats(),
841
989
  feeAnalysisId: feeAnalysis?.id,
842
990
  });
843
991
  } else {
844
- this.log.warn(`Validation block building FAILED for slot ${this.slot}`, {
845
- slot: this.slot,
992
+ this.log.warn(`Validation block building FAILED for slot ${this.targetSlot}`, {
993
+ slot: this.targetSlot,
846
994
  feeAnalysisId: feeAnalysis?.id,
847
995
  });
848
- this.metrics.recordBlockProposalFailed('block_build_failed');
996
+ this.metrics.recordCheckpointProposalFailed('block_build_failed');
849
997
  }
850
998
 
851
999
  this.publisher.clearPendingRequests();
852
1000
  }
853
1001
 
1002
+ /**
1003
+ * Helper to handle HA double-signing errors. Returns true if the error was handled (caller should yield).
1004
+ */
1005
+ private handleHASigningError(err: any, errorContext: string): boolean {
1006
+ if (err instanceof DutyAlreadySignedError) {
1007
+ this.log.info(`${errorContext} for slot ${this.targetSlot} already signed by another HA node, yielding`, {
1008
+ slot: this.targetSlot,
1009
+ signedByNode: err.signedByNode,
1010
+ });
1011
+ return true;
1012
+ }
1013
+ if (err instanceof SlashingProtectionError) {
1014
+ this.log.info(`${errorContext} for slot ${this.targetSlot} blocked by slashing protection, yielding`, {
1015
+ slot: this.targetSlot,
1016
+ existingMessageHash: err.existingMessageHash,
1017
+ attemptedMessageHash: err.attemptedMessageHash,
1018
+ });
1019
+ return true;
1020
+ }
1021
+ return false;
1022
+ }
1023
+
854
1024
  /** Waits until a specific time within the current slot */
855
1025
  @trackSpan('CheckpointProposalJob.waitUntilTimeInSlot')
856
1026
  protected async waitUntilTimeInSlot(targetSecondsIntoSlot: number): Promise<void> {
@@ -859,6 +1029,11 @@ export class CheckpointProposalJob implements Traceable {
859
1029
  await sleepUntil(new Date(targetTimestamp * 1000), this.dateProvider.nowAsDate());
860
1030
  }
861
1031
 
1032
+ /** Waits the polling interval for transactions. Extracted for test overriding. */
1033
+ protected async waitForTxsPollingInterval(): Promise<void> {
1034
+ await sleep(TXS_POLLING_MS);
1035
+ }
1036
+
862
1037
  private getSlotStartBuildTimestamp(): number {
863
1038
  return getSlotStartBuildTimestamp(this.slot, this.l1Constants);
864
1039
  }