@aztec/sequencer-client 0.0.1-commit.3469e52 → 0.0.1-commit.3895657bc

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 (78) hide show
  1. package/dest/client/sequencer-client.d.ts +23 -7
  2. package/dest/client/sequencer-client.d.ts.map +1 -1
  3. package/dest/client/sequencer-client.js +99 -16
  4. package/dest/config.d.ts +24 -6
  5. package/dest/config.d.ts.map +1 -1
  6. package/dest/config.js +40 -30
  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 +2 -2
  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-metrics.d.ts +1 -1
  31. package/dest/publisher/sequencer-publisher-metrics.d.ts.map +1 -1
  32. package/dest/publisher/sequencer-publisher-metrics.js +12 -4
  33. package/dest/publisher/sequencer-publisher.d.ts +26 -8
  34. package/dest/publisher/sequencer-publisher.d.ts.map +1 -1
  35. package/dest/publisher/sequencer-publisher.js +338 -48
  36. package/dest/sequencer/checkpoint_proposal_job.d.ts +31 -10
  37. package/dest/sequencer/checkpoint_proposal_job.d.ts.map +1 -1
  38. package/dest/sequencer/checkpoint_proposal_job.js +180 -95
  39. package/dest/sequencer/metrics.d.ts +17 -5
  40. package/dest/sequencer/metrics.d.ts.map +1 -1
  41. package/dest/sequencer/metrics.js +111 -30
  42. package/dest/sequencer/sequencer.d.ts +25 -12
  43. package/dest/sequencer/sequencer.d.ts.map +1 -1
  44. package/dest/sequencer/sequencer.js +31 -28
  45. package/dest/sequencer/timetable.d.ts +4 -6
  46. package/dest/sequencer/timetable.d.ts.map +1 -1
  47. package/dest/sequencer/timetable.js +7 -11
  48. package/dest/sequencer/types.d.ts +5 -2
  49. package/dest/sequencer/types.d.ts.map +1 -1
  50. package/dest/test/index.d.ts +3 -5
  51. package/dest/test/index.d.ts.map +1 -1
  52. package/dest/test/mock_checkpoint_builder.d.ts +17 -14
  53. package/dest/test/mock_checkpoint_builder.d.ts.map +1 -1
  54. package/dest/test/mock_checkpoint_builder.js +63 -40
  55. package/dest/test/utils.d.ts +8 -8
  56. package/dest/test/utils.d.ts.map +1 -1
  57. package/dest/test/utils.js +10 -9
  58. package/package.json +28 -28
  59. package/src/client/sequencer-client.ts +135 -18
  60. package/src/config.ts +55 -41
  61. package/src/global_variable_builder/global_builder.ts +3 -3
  62. package/src/publisher/config.ts +121 -43
  63. package/src/publisher/index.ts +3 -0
  64. package/src/publisher/l1_tx_failed_store/factory.ts +32 -0
  65. package/src/publisher/l1_tx_failed_store/failed_tx_store.ts +55 -0
  66. package/src/publisher/l1_tx_failed_store/file_store_failed_tx_store.ts +46 -0
  67. package/src/publisher/l1_tx_failed_store/index.ts +3 -0
  68. package/src/publisher/sequencer-publisher-factory.ts +38 -6
  69. package/src/publisher/sequencer-publisher-metrics.ts +7 -3
  70. package/src/publisher/sequencer-publisher.ts +333 -60
  71. package/src/sequencer/checkpoint_proposal_job.ts +246 -127
  72. package/src/sequencer/metrics.ts +124 -32
  73. package/src/sequencer/sequencer.ts +41 -33
  74. package/src/sequencer/timetable.ts +13 -12
  75. package/src/sequencer/types.ts +4 -1
  76. package/src/test/index.ts +2 -4
  77. package/src/test/mock_checkpoint_builder.ts +90 -62
  78. package/src/test/utils.ts +22 -13
@@ -1,37 +1,47 @@
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
- import { BlockNumber, CheckpointNumber, EpochNumber, SlotNumber } from '@aztec/foundation/branded-types';
2
+ import {
3
+ BlockNumber,
4
+ CheckpointNumber,
5
+ EpochNumber,
6
+ IndexWithinCheckpoint,
7
+ SlotNumber,
8
+ } from '@aztec/foundation/branded-types';
5
9
  import { randomInt } from '@aztec/foundation/crypto/random';
10
+ import {
11
+ flipSignature,
12
+ generateRecoverableSignature,
13
+ generateUnrecoverableSignature,
14
+ } from '@aztec/foundation/crypto/secp256k1-signer';
6
15
  import { Fr } from '@aztec/foundation/curves/bn254';
7
16
  import { EthAddress } from '@aztec/foundation/eth-address';
8
17
  import { Signature } from '@aztec/foundation/eth-signature';
9
18
  import { filter } from '@aztec/foundation/iterator';
10
- import type { Logger } from '@aztec/foundation/log';
19
+ import { type Logger, type LoggerBindings, createLogger } from '@aztec/foundation/log';
11
20
  import { sleep, sleepUntil } from '@aztec/foundation/sleep';
12
21
  import { type DateProvider, Timer } from '@aztec/foundation/timer';
13
- import { type TypedEventEmitter, unfreeze } from '@aztec/foundation/types';
22
+ import { type TypedEventEmitter, isErrorClass, unfreeze } from '@aztec/foundation/types';
14
23
  import type { P2P } from '@aztec/p2p';
15
24
  import type { SlasherClientInterface } from '@aztec/slasher';
16
25
  import {
17
26
  CommitteeAttestation,
18
27
  CommitteeAttestationsAndSigners,
19
- L2BlockNew,
28
+ L2Block,
20
29
  type L2BlockSink,
21
30
  type L2BlockSource,
22
31
  MaliciousCommitteeAttestationsAndSigners,
23
32
  } from '@aztec/stdlib/block';
24
- import type { Checkpoint } from '@aztec/stdlib/checkpoint';
33
+ import { type Checkpoint, validateCheckpoint } from '@aztec/stdlib/checkpoint';
25
34
  import { getSlotStartBuildTimestamp } from '@aztec/stdlib/epoch-helpers';
26
35
  import { Gas } from '@aztec/stdlib/gas';
27
- import type {
28
- PublicProcessorLimits,
29
- ResolvedSequencerConfig,
30
- WorldStateSynchronizer,
36
+ import {
37
+ NoValidTxsError,
38
+ type PublicProcessorLimits,
39
+ type ResolvedSequencerConfig,
40
+ type WorldStateSynchronizer,
31
41
  } from '@aztec/stdlib/interfaces/server';
32
42
  import { type L1ToL2MessageSource, computeInHashFromL1ToL2Messages } from '@aztec/stdlib/messaging';
33
43
  import type { BlockProposalOptions, CheckpointProposal, CheckpointProposalOptions } from '@aztec/stdlib/p2p';
34
- import { orderAttestations } from '@aztec/stdlib/p2p';
44
+ import { orderAttestations, trimAttestations } from '@aztec/stdlib/p2p';
35
45
  import type { L2BlockBuiltStats } from '@aztec/stdlib/stats';
36
46
  import { type FailedTx, Tx } from '@aztec/stdlib/tx';
37
47
  import { AttestationTimeoutError } from '@aztec/stdlib/validators';
@@ -59,6 +69,8 @@ const TXS_POLLING_MS = 500;
59
69
  * the Sequencer once the check for being the proposer for the slot has succeeded.
60
70
  */
61
71
  export class CheckpointProposalJob implements Traceable {
72
+ protected readonly log: Logger;
73
+
62
74
  constructor(
63
75
  private readonly epoch: EpochNumber,
64
76
  private readonly slot: SlotNumber,
@@ -86,9 +98,11 @@ export class CheckpointProposalJob implements Traceable {
86
98
  private readonly metrics: SequencerMetrics,
87
99
  private readonly eventEmitter: TypedEventEmitter<SequencerEvents>,
88
100
  private readonly setStateFn: (state: SequencerState, slot?: SlotNumber) => void,
89
- protected readonly log: Logger,
90
101
  public readonly tracer: Tracer,
91
- ) {}
102
+ bindings?: LoggerBindings,
103
+ ) {
104
+ this.log = createLogger('sequencer:checkpoint-proposal', { ...bindings, instanceId: `slot-${slot}` });
105
+ }
92
106
 
93
107
  /**
94
108
  * Executes the checkpoint proposal job.
@@ -118,7 +132,7 @@ export class CheckpointProposalJob implements Traceable {
118
132
  await Promise.all(votesPromises);
119
133
 
120
134
  if (checkpoint) {
121
- this.metrics.recordBlockProposalSuccess();
135
+ this.metrics.recordCheckpointProposalSuccess();
122
136
  }
123
137
 
124
138
  // Do not post anything to L1 if we are fishermen, but do perform L1 fee analysis
@@ -175,21 +189,25 @@ export class CheckpointProposalJob implements Traceable {
175
189
  const inHash = computeInHashFromL1ToL2Messages(l1ToL2Messages);
176
190
 
177
191
  // Collect the out hashes of all the checkpoints before this one in the same epoch
178
- const previousCheckpoints = (await this.l2BlockSource.getCheckpointsForEpoch(this.epoch)).filter(
179
- c => c.number < this.checkpointNumber,
180
- );
181
- const previousCheckpointOutHashes = previousCheckpoints.map(c => c.getCheckpointOutHash());
192
+ const previousCheckpointOutHashes = (await this.l2BlockSource.getCheckpointsDataForEpoch(this.epoch))
193
+ .filter(c => c.checkpointNumber < this.checkpointNumber)
194
+ .map(c => c.checkpointOutHash);
195
+
196
+ // Get the fee asset price modifier from the oracle
197
+ const feeAssetPriceModifier = await this.publisher.getFeeAssetPriceModifier();
182
198
 
183
199
  // Create a long-lived forked world state for the checkpoint builder
184
- using fork = await this.worldState.fork(this.syncedToBlockNumber, { closeDelayMs: 12_000 });
200
+ await using fork = await this.worldState.fork(this.syncedToBlockNumber, { closeDelayMs: 12_000 });
185
201
 
186
202
  // Create checkpoint builder for the entire slot
187
203
  const checkpointBuilder = await this.checkpointsBuilder.startCheckpoint(
188
204
  this.checkpointNumber,
189
205
  checkpointGlobalVariables,
206
+ feeAssetPriceModifier,
190
207
  l1ToL2Messages,
191
208
  previousCheckpointOutHashes,
192
209
  fork,
210
+ this.log.getBindings(),
193
211
  );
194
212
 
195
213
  // Options for the validator client when creating block and checkpoint proposals
@@ -203,8 +221,9 @@ export class CheckpointProposalJob implements Traceable {
203
221
  broadcastInvalidCheckpointProposal: this.config.broadcastInvalidBlockProposal,
204
222
  };
205
223
 
206
- let blocksInCheckpoint: L2BlockNew[] = [];
207
- let blockPendingBroadcast: { block: L2BlockNew; txs: Tx[] } | undefined = undefined;
224
+ let blocksInCheckpoint: L2Block[] = [];
225
+ let blockPendingBroadcast: { block: L2Block; txs: Tx[] } | undefined = undefined;
226
+ const checkpointBuildTimer = new Timer();
208
227
 
209
228
  try {
210
229
  // Main loop: build blocks for the checkpoint
@@ -220,19 +239,7 @@ export class CheckpointProposalJob implements Traceable {
220
239
  // These errors are expected in HA mode, so we yield and let another HA node handle the slot
221
240
  // The only distinction between the 2 errors is SlashingProtectionError throws when the payload is different,
222
241
  // which is normal for block building (may have picked different txs)
223
- if (err instanceof DutyAlreadySignedError) {
224
- this.log.info(`Checkpoint proposal for slot ${this.slot} already signed by another HA node, yielding`, {
225
- slot: this.slot,
226
- signedByNode: err.signedByNode,
227
- });
228
- return undefined;
229
- }
230
- if (err instanceof SlashingProtectionError) {
231
- this.log.info(`Checkpoint proposal for slot ${this.slot} blocked by slashing protection, yielding`, {
232
- slot: this.slot,
233
- existingMessageHash: err.existingMessageHash,
234
- attemptedMessageHash: err.attemptedMessageHash,
235
- });
242
+ if (this.handleHASigningError(err, 'Block proposal')) {
236
243
  return undefined;
237
244
  }
238
245
  throw err;
@@ -244,11 +251,44 @@ export class CheckpointProposalJob implements Traceable {
244
251
  return undefined;
245
252
  }
246
253
 
254
+ const minBlocksForCheckpoint = this.config.minBlocksForCheckpoint;
255
+ if (minBlocksForCheckpoint !== undefined && blocksInCheckpoint.length < minBlocksForCheckpoint) {
256
+ this.log.warn(
257
+ `Checkpoint has fewer blocks than minimum (${blocksInCheckpoint.length} < ${minBlocksForCheckpoint}), skipping proposal`,
258
+ { slot: this.slot, blocksBuilt: blocksInCheckpoint.length, minBlocksForCheckpoint },
259
+ );
260
+ return undefined;
261
+ }
262
+
247
263
  // Assemble and broadcast the checkpoint proposal, including the last block that was not
248
264
  // broadcasted yet, and wait to collect the committee attestations.
249
265
  this.setStateFn(SequencerState.ASSEMBLING_CHECKPOINT, this.slot);
250
266
  const checkpoint = await checkpointBuilder.completeCheckpoint();
251
267
 
268
+ // Final validation round for the checkpoint before we propose it, just for safety
269
+ try {
270
+ validateCheckpoint(checkpoint, {
271
+ rollupManaLimit: this.l1Constants.rollupManaLimit,
272
+ maxL2BlockGas: this.config.maxL2BlockGas,
273
+ maxDABlockGas: this.config.maxDABlockGas,
274
+ maxTxsPerBlock: this.config.maxTxsPerBlock,
275
+ maxTxsPerCheckpoint: this.config.maxTxsPerCheckpoint,
276
+ });
277
+ } catch (err) {
278
+ this.log.error(`Built an invalid checkpoint at slot ${this.slot} (skipping proposal)`, err, {
279
+ checkpoint: checkpoint.header.toInspect(),
280
+ });
281
+ return undefined;
282
+ }
283
+
284
+ // Record checkpoint-level build metrics
285
+ this.metrics.recordCheckpointBuild(
286
+ checkpointBuildTimer.ms(),
287
+ blocksInCheckpoint.length,
288
+ checkpoint.getStats().txCount,
289
+ Number(checkpoint.header.totalManaUsed.toBigInt()),
290
+ );
291
+
252
292
  // Do not collect attestations nor publish to L1 in fisherman mode
253
293
  if (this.config.fishermanMode) {
254
294
  this.log.info(
@@ -275,6 +315,7 @@ export class CheckpointProposalJob implements Traceable {
275
315
  const proposal = await this.validatorClient.createCheckpointProposal(
276
316
  checkpoint.header,
277
317
  checkpoint.archive.root,
318
+ feeAssetPriceModifier,
278
319
  lastBlock,
279
320
  this.proposer,
280
321
  checkpointProposalOptions,
@@ -301,20 +342,8 @@ export class CheckpointProposalJob implements Traceable {
301
342
  );
302
343
  } catch (err) {
303
344
  // We shouldn't really get here since we yield to another HA node
304
- // as soon as we see these errors when creating block proposals.
305
- if (err instanceof DutyAlreadySignedError) {
306
- this.log.info(`Attestations signature for slot ${this.slot} already signed by another HA node, yielding`, {
307
- slot: this.slot,
308
- signedByNode: err.signedByNode,
309
- });
310
- return undefined;
311
- }
312
- if (err instanceof SlashingProtectionError) {
313
- this.log.info(`Attestations signature for slot ${this.slot} blocked by slashing protection, yielding`, {
314
- slot: this.slot,
315
- existingMessageHash: err.existingMessageHash,
316
- attemptedMessageHash: err.attemptedMessageHash,
317
- });
345
+ // as soon as we see these errors when creating block or checkpoint proposals.
346
+ if (this.handleHASigningError(err, 'Attestations signature')) {
318
347
  return undefined;
319
348
  }
320
349
  throw err;
@@ -325,6 +354,21 @@ export class CheckpointProposalJob implements Traceable {
325
354
  const aztecSlotDuration = this.l1Constants.slotDuration;
326
355
  const slotStartBuildTimestamp = this.getSlotStartBuildTimestamp();
327
356
  const txTimeoutAt = new Date((slotStartBuildTimestamp + aztecSlotDuration) * 1000);
357
+
358
+ // If we have been configured to potentially skip publishing checkpoint then roll the dice here
359
+ if (
360
+ this.config.skipPublishingCheckpointsPercent !== undefined &&
361
+ this.config.skipPublishingCheckpointsPercent > 0
362
+ ) {
363
+ const result = Math.max(0, randomInt(100));
364
+ if (result < this.config.skipPublishingCheckpointsPercent) {
365
+ this.log.warn(
366
+ `Skipping publishing proposal for checkpoint ${checkpoint.number}. Configured percentage: ${this.config.skipPublishingCheckpointsPercent}, generated value: ${result}`,
367
+ );
368
+ return checkpoint;
369
+ }
370
+ }
371
+
328
372
  await this.publisher.enqueueProposeCheckpoint(checkpoint, attestations, attestationsSignature, {
329
373
  txTimeoutAt,
330
374
  forcePendingCheckpointNumber: this.invalidateCheckpoint?.forcePendingCheckpointNumber,
@@ -352,22 +396,19 @@ export class CheckpointProposalJob implements Traceable {
352
396
  inHash: Fr,
353
397
  blockProposalOptions: BlockProposalOptions,
354
398
  ): Promise<{
355
- blocksInCheckpoint: L2BlockNew[];
356
- blockPendingBroadcast: { block: L2BlockNew; txs: Tx[] } | undefined;
399
+ blocksInCheckpoint: L2Block[];
400
+ blockPendingBroadcast: { block: L2Block; txs: Tx[] } | undefined;
357
401
  }> {
358
- const blocksInCheckpoint: L2BlockNew[] = [];
402
+ const blocksInCheckpoint: L2Block[] = [];
359
403
  const txHashesAlreadyIncluded = new Set<string>();
360
404
  const initialBlockNumber = BlockNumber(this.syncedToBlockNumber + 1);
361
405
 
362
- // Remaining blob fields available for blocks (checkpoint end marker already subtracted)
363
- let remainingBlobFields = BLOBS_PER_CHECKPOINT * FIELDS_PER_BLOB - NUM_CHECKPOINT_END_MARKER_FIELDS;
364
-
365
406
  // Last block in the checkpoint will usually be flagged as pending broadcast, so we send it along with the checkpoint proposal
366
- let blockPendingBroadcast: { block: L2BlockNew; txs: Tx[] } | undefined = undefined;
407
+ let blockPendingBroadcast: { block: L2Block; txs: Tx[] } | undefined = undefined;
367
408
 
368
409
  while (true) {
369
410
  const blocksBuilt = blocksInCheckpoint.length;
370
- const indexWithinCheckpoint = blocksBuilt;
411
+ const indexWithinCheckpoint = IndexWithinCheckpoint(blocksBuilt);
371
412
  const blockNumber = BlockNumber(initialBlockNumber + blocksBuilt);
372
413
 
373
414
  const secondsIntoSlot = this.getSecondsIntoSlot();
@@ -394,9 +435,9 @@ export class CheckpointProposalJob implements Traceable {
394
435
  blockNumber,
395
436
  indexWithinCheckpoint,
396
437
  txHashesAlreadyIncluded,
397
- remainingBlobFields,
398
438
  });
399
439
 
440
+ // TODO(palla/mbps): Review these conditions. We may want to keep trying in some scenarios.
400
441
  if (!buildResult && timingInfo.isLastBlock) {
401
442
  // If no block was produced due to not enough txs and this was the last subslot, exit
402
443
  break;
@@ -419,16 +460,18 @@ export class CheckpointProposalJob implements Traceable {
419
460
  break;
420
461
  }
421
462
 
422
- const { block, usedTxs, remainingBlobFields: newRemainingBlobFields } = buildResult;
463
+ const { block, usedTxs } = buildResult;
423
464
  blocksInCheckpoint.push(block);
424
465
 
425
- // Update remaining blob fields for the next block
426
- remainingBlobFields = newRemainingBlobFields;
427
-
428
466
  // Sync the proposed block to the archiver to make it available
429
467
  // Note that the checkpoint builder uses its own fork so it should not need to wait for this syncing
430
468
  // Eventually we should refactor the checkpoint builder to not need a separate long-lived fork
431
- await this.syncProposedBlockToArchiver(block);
469
+ // Fire and forget - don't block the critical path, but log errors
470
+ this.syncProposedBlockToArchiver(block).catch(err => {
471
+ this.log.error(`Failed to sync proposed block ${block.number} to archiver`, { blockNumber: block.number, err });
472
+ });
473
+
474
+ usedTxs.forEach(tx => txHashesAlreadyIncluded.add(tx.txHash.toString()));
432
475
 
433
476
  // If this is the last block, exit the loop now so we start collecting attestations
434
477
  if (timingInfo.isLastBlock) {
@@ -478,27 +521,19 @@ export class CheckpointProposalJob implements Traceable {
478
521
 
479
522
  /** Builds a single block. Called from the main block building loop. */
480
523
  @trackSpan('CheckpointProposalJob.buildSingleBlock')
481
- private async buildSingleBlock(
524
+ protected async buildSingleBlock(
482
525
  checkpointBuilder: CheckpointBuilder,
483
526
  opts: {
484
527
  forceCreate?: boolean;
485
528
  blockTimestamp: bigint;
486
529
  blockNumber: BlockNumber;
487
- indexWithinCheckpoint: number;
530
+ indexWithinCheckpoint: IndexWithinCheckpoint;
488
531
  buildDeadline: Date | undefined;
489
532
  txHashesAlreadyIncluded: Set<string>;
490
- remainingBlobFields: number;
491
533
  },
492
- ): Promise<{ block: L2BlockNew; usedTxs: Tx[]; remainingBlobFields: number } | { error: Error } | undefined> {
493
- const {
494
- blockTimestamp,
495
- forceCreate,
496
- blockNumber,
497
- indexWithinCheckpoint,
498
- buildDeadline,
499
- txHashesAlreadyIncluded,
500
- remainingBlobFields,
501
- } = opts;
534
+ ): Promise<{ block: L2Block; usedTxs: Tx[] } | { error: Error } | undefined> {
535
+ const { blockTimestamp, forceCreate, blockNumber, indexWithinCheckpoint, buildDeadline, txHashesAlreadyIncluded } =
536
+ opts;
502
537
 
503
538
  this.log.verbose(
504
539
  `Preparing block ${blockNumber} index ${indexWithinCheckpoint} at checkpoint ${this.checkpointNumber} for slot ${this.slot}`,
@@ -522,7 +557,7 @@ export class CheckpointProposalJob implements Traceable {
522
557
  // Create iterator to pending txs. We filter out txs already included in previous blocks in the checkpoint
523
558
  // just in case p2p failed to sync the provisional block and didn't get to remove those txs from the mempool yet.
524
559
  const pendingTxs = filter(
525
- this.p2pClient.iteratePendingTxs(),
560
+ this.p2pClient.iterateEligiblePendingTxs(),
526
561
  tx => !txHashesAlreadyIncluded.has(tx.txHash.toString()),
527
562
  );
528
563
 
@@ -532,64 +567,57 @@ export class CheckpointProposalJob implements Traceable {
532
567
  );
533
568
  this.setStateFn(SequencerState.CREATING_BLOCK, this.slot);
534
569
 
535
- // Calculate blob fields limit for txs (remaining capacity - this block's end overhead)
536
- const blockEndOverhead = getNumBlockEndBlobFields(indexWithinCheckpoint === 0);
537
- const maxBlobFieldsForTxs = remainingBlobFields - blockEndOverhead;
538
-
570
+ // Per-block limits derived at startup by computeBlockLimits(), further capped
571
+ // by remaining checkpoint-level budgets inside CheckpointBuilder before each block is built.
539
572
  const blockBuilderOptions: PublicProcessorLimits = {
540
573
  maxTransactions: this.config.maxTxsPerBlock,
541
- maxBlockSize: this.config.maxBlockSizeInBytes,
542
- maxBlockGas: new Gas(this.config.maxDABlockGas, this.config.maxL2BlockGas),
543
- maxBlobFields: maxBlobFieldsForTxs,
574
+ maxBlockGas:
575
+ this.config.maxL2BlockGas !== undefined || this.config.maxDABlockGas !== undefined
576
+ ? new Gas(this.config.maxDABlockGas ?? Infinity, this.config.maxL2BlockGas ?? Infinity)
577
+ : undefined,
544
578
  deadline: buildDeadline,
579
+ isBuildingProposal: true,
545
580
  };
546
581
 
547
582
  // Actually build the block by executing txs
548
- const workTimer = new Timer();
549
- const {
550
- publicGas,
551
- block,
552
- publicProcessorDuration,
553
- numTxs,
554
- blockBuildingTimer,
555
- usedTxs,
556
- failedTxs,
557
- usedTxBlobFields,
558
- } = await checkpointBuilder.buildBlock(pendingTxs, blockNumber, blockTimestamp, blockBuilderOptions);
559
- const blockBuildDuration = workTimer.ms();
583
+ const buildResult = await this.buildSingleBlockWithCheckpointBuilder(
584
+ checkpointBuilder,
585
+ pendingTxs,
586
+ blockNumber,
587
+ blockTimestamp,
588
+ blockBuilderOptions,
589
+ );
560
590
 
561
591
  // If any txs failed during execution, drop them from the mempool so we don't pick them up again
562
- await this.dropFailedTxsFromP2P(failedTxs);
592
+ await this.dropFailedTxsFromP2P(buildResult.failedTxs);
563
593
 
564
594
  // Check if we have created a block with enough txs. If there were invalid txs in the pool, or if execution took
565
595
  // too long, then we may not get to minTxsPerBlock after executing public functions.
566
596
  const minValidTxs = this.config.minValidTxsPerBlock ?? minTxs;
567
- if (!forceCreate && numTxs < minValidTxs) {
597
+ const numTxs = buildResult.status === 'no-valid-txs' ? 0 : buildResult.numTxs;
598
+ if (buildResult.status === 'no-valid-txs' || (!forceCreate && numTxs < minValidTxs)) {
568
599
  this.log.warn(
569
- `Block ${blockNumber} at index ${indexWithinCheckpoint} on slot ${this.slot} has too few valid txs to be proposed (got ${numTxs} but required ${minValidTxs})`,
570
- { slot: this.slot, blockNumber, numTxs, indexWithinCheckpoint },
600
+ `Block ${blockNumber} at index ${indexWithinCheckpoint} on slot ${this.slot} has too few valid txs to be proposed`,
601
+ { slot: this.slot, blockNumber, numTxs, indexWithinCheckpoint, minValidTxs, buildResult: buildResult.status },
571
602
  );
572
- this.eventEmitter.emit('block-tx-count-check-failed', {
573
- minTxs: minValidTxs,
574
- availableTxs: numTxs,
575
- slot: this.slot,
576
- });
603
+ this.eventEmitter.emit('block-build-failed', { reason: `Insufficient valid txs`, slot: this.slot });
577
604
  this.metrics.recordBlockProposalFailed('insufficient_valid_txs');
578
605
  return undefined;
579
606
  }
580
607
 
581
608
  // Block creation succeeded, emit stats and metrics
609
+ const { block, publicProcessorDuration, usedTxs, blockBuildDuration } = buildResult;
610
+
582
611
  const blockStats = {
583
612
  eventName: 'l2-block-built',
584
613
  duration: blockBuildDuration,
585
614
  publicProcessDuration: publicProcessorDuration,
586
- rollupCircuitsDuration: blockBuildingTimer.ms(),
587
615
  ...block.getStats(),
588
616
  } satisfies L2BlockBuiltStats;
589
617
 
590
618
  const blockHash = await block.hash();
591
619
  const txHashes = block.body.txEffects.map(tx => tx.txHash);
592
- const manaPerSec = publicGas.l2Gas / (blockBuildDuration / 1000);
620
+ const manaPerSec = block.header.totalManaUsed.toNumberUnsafe() / (blockBuildDuration / 1000);
593
621
 
594
622
  this.log.info(
595
623
  `Built block ${block.number} at checkpoint ${this.checkpointNumber} for slot ${this.slot} with ${numTxs} txs`,
@@ -597,9 +625,9 @@ export class CheckpointProposalJob implements Traceable {
597
625
  );
598
626
 
599
627
  this.eventEmitter.emit('block-proposed', { blockNumber: block.number, slot: this.slot });
600
- this.metrics.recordBuiltBlock(blockBuildDuration, publicGas.l2Gas);
628
+ this.metrics.recordBuiltBlock(blockBuildDuration, block.header.totalManaUsed.toNumberUnsafe());
601
629
 
602
- return { block, usedTxs, remainingBlobFields: maxBlobFieldsForTxs - usedTxBlobFields };
630
+ return { block, usedTxs };
603
631
  } catch (err: any) {
604
632
  this.eventEmitter.emit('block-build-failed', { reason: err.message, slot: this.slot });
605
633
  this.log.error(`Error building block`, err, { blockNumber, slot: this.slot });
@@ -609,17 +637,40 @@ export class CheckpointProposalJob implements Traceable {
609
637
  }
610
638
  }
611
639
 
640
+ /** Uses the checkpoint builder to build a block, catching specific txs */
641
+ private async buildSingleBlockWithCheckpointBuilder(
642
+ checkpointBuilder: CheckpointBuilder,
643
+ pendingTxs: AsyncIterable<Tx>,
644
+ blockNumber: BlockNumber,
645
+ blockTimestamp: bigint,
646
+ blockBuilderOptions: PublicProcessorLimits,
647
+ ) {
648
+ try {
649
+ const workTimer = new Timer();
650
+ const result = await checkpointBuilder.buildBlock(pendingTxs, blockNumber, blockTimestamp, blockBuilderOptions);
651
+ const blockBuildDuration = workTimer.ms();
652
+ return { ...result, blockBuildDuration, status: 'success' as const };
653
+ } catch (err: unknown) {
654
+ if (isErrorClass(err, NoValidTxsError)) {
655
+ return { failedTxs: err.failedTxs, status: 'no-valid-txs' as const };
656
+ }
657
+ throw err;
658
+ }
659
+ }
660
+
612
661
  /** Waits until minTxs are available on the pool for building a block. */
613
662
  @trackSpan('CheckpointProposalJob.waitForMinTxs')
614
663
  private async waitForMinTxs(opts: {
615
664
  forceCreate?: boolean;
616
665
  blockNumber: BlockNumber;
617
- indexWithinCheckpoint: number;
666
+ indexWithinCheckpoint: IndexWithinCheckpoint;
618
667
  buildDeadline: Date | undefined;
619
668
  }): Promise<{ canStartBuilding: boolean; availableTxs: number }> {
620
- const minTxs = this.config.minTxsPerBlock;
621
669
  const { indexWithinCheckpoint, blockNumber, buildDeadline, forceCreate } = opts;
622
670
 
671
+ // We only allow a block with 0 txs in the first block of the checkpoint
672
+ const minTxs = indexWithinCheckpoint > 0 && this.config.minTxsPerBlock === 0 ? 1 : this.config.minTxsPerBlock;
673
+
623
674
  // Deadline is undefined if we are not enforcing the timetable, meaning we'll exit immediately when out of time
624
675
  const startBuildingDeadline = buildDeadline
625
676
  ? new Date(buildDeadline.getTime() - this.timetable.minExecutionTime * 1000)
@@ -640,7 +691,7 @@ export class CheckpointProposalJob implements Traceable {
640
691
  `Waiting for enough txs to build block ${blockNumber} at index ${indexWithinCheckpoint} in slot ${this.slot} (have ${availableTxs} but need ${minTxs})`,
641
692
  { blockNumber, slot: this.slot, indexWithinCheckpoint },
642
693
  );
643
- await sleep(TXS_POLLING_MS);
694
+ await this.waitForTxsPollingInterval();
644
695
  availableTxs = await this.p2pClient.getPendingTxCount();
645
696
  }
646
697
 
@@ -681,7 +732,7 @@ export class CheckpointProposalJob implements Traceable {
681
732
  const attestationTimeAllowed = this.config.enforceTimeTable
682
733
  ? this.timetable.getMaxAllowedTime(SequencerState.PUBLISHING_CHECKPOINT)!
683
734
  : this.l1Constants.slotDuration;
684
- const attestationDeadline = new Date(this.dateProvider.now() + attestationTimeAllowed * 1000);
735
+ const attestationDeadline = new Date((this.getSlotStartBuildTimestamp() + attestationTimeAllowed) * 1000);
685
736
 
686
737
  this.metrics.recordRequiredAttestations(numberOfRequiredAttestations, attestationTimeAllowed);
687
738
 
@@ -696,11 +747,28 @@ export class CheckpointProposalJob implements Traceable {
696
747
 
697
748
  collectedAttestationsCount = attestations.length;
698
749
 
750
+ // Trim attestations to minimum required to save L1 calldata gas
751
+ const localAddresses = this.validatorClient.getValidatorAddresses();
752
+ const trimmed = trimAttestations(
753
+ attestations,
754
+ numberOfRequiredAttestations,
755
+ this.attestorAddress,
756
+ localAddresses,
757
+ );
758
+ if (trimmed.length < attestations.length) {
759
+ this.log.debug(`Trimmed attestations from ${attestations.length} to ${trimmed.length} for L1 submission`);
760
+ }
761
+
699
762
  // Rollup contract requires that the signatures are provided in the order of the committee
700
- const sorted = orderAttestations(attestations, committee);
763
+ const sorted = orderAttestations(trimmed, committee);
701
764
 
702
765
  // Manipulate the attestations if we've been configured to do so
703
- if (this.config.injectFakeAttestation || this.config.shuffleAttestationOrdering) {
766
+ if (
767
+ this.config.injectFakeAttestation ||
768
+ this.config.injectHighSValueAttestation ||
769
+ this.config.injectUnrecoverableSignatureAttestation ||
770
+ this.config.shuffleAttestationOrdering
771
+ ) {
704
772
  return this.manipulateAttestations(proposal.slotNumber, epoch, seed, committee, sorted);
705
773
  }
706
774
 
@@ -729,7 +797,11 @@ export class CheckpointProposalJob implements Traceable {
729
797
  this.epochCache.computeProposerIndex(slotNumber, epoch, seed, BigInt(committee.length)),
730
798
  );
731
799
 
732
- if (this.config.injectFakeAttestation) {
800
+ if (
801
+ this.config.injectFakeAttestation ||
802
+ this.config.injectHighSValueAttestation ||
803
+ this.config.injectUnrecoverableSignatureAttestation
804
+ ) {
733
805
  // Find non-empty attestations that are not from the proposer
734
806
  const nonProposerIndices: number[] = [];
735
807
  for (let i = 0; i < attestations.length; i++) {
@@ -739,8 +811,20 @@ export class CheckpointProposalJob implements Traceable {
739
811
  }
740
812
  if (nonProposerIndices.length > 0) {
741
813
  const targetIndex = nonProposerIndices[randomInt(nonProposerIndices.length)];
742
- this.log.warn(`Injecting fake attestation in checkpoint for slot ${slotNumber} at index ${targetIndex}`);
743
- unfreeze(attestations[targetIndex]).signature = Signature.random();
814
+ if (this.config.injectHighSValueAttestation) {
815
+ this.log.warn(
816
+ `Injecting high-s value attestation in checkpoint for slot ${slotNumber} at index ${targetIndex}`,
817
+ );
818
+ unfreeze(attestations[targetIndex]).signature = flipSignature(attestations[targetIndex].signature);
819
+ } else if (this.config.injectUnrecoverableSignatureAttestation) {
820
+ this.log.warn(
821
+ `Injecting unrecoverable signature attestation in checkpoint for slot ${slotNumber} at index ${targetIndex}`,
822
+ );
823
+ unfreeze(attestations[targetIndex]).signature = generateUnrecoverableSignature();
824
+ } else {
825
+ this.log.warn(`Injecting fake attestation in checkpoint for slot ${slotNumber} at index ${targetIndex}`);
826
+ unfreeze(attestations[targetIndex]).signature = generateRecoverableSignature();
827
+ }
744
828
  }
745
829
  return new CommitteeAttestationsAndSigners(attestations);
746
830
  }
@@ -749,11 +833,20 @@ export class CheckpointProposalJob implements Traceable {
749
833
  this.log.warn(`Shuffling attestation ordering in checkpoint for slot ${slotNumber} (proposer #${proposerIndex})`);
750
834
 
751
835
  const shuffled = [...attestations];
752
- const [i, j] = [(proposerIndex + 1) % shuffled.length, (proposerIndex + 2) % shuffled.length];
753
- const valueI = shuffled[i];
754
- const valueJ = shuffled[j];
755
- shuffled[i] = valueJ;
756
- shuffled[j] = valueI;
836
+
837
+ // Find two non-proposer positions that both have non-empty signatures to swap.
838
+ // This ensures the bitmap doesn't change, so the MaliciousCommitteeAttestationsAndSigners
839
+ // signers array stays correctly aligned with L1's committee reconstruction.
840
+ const swappable: number[] = [];
841
+ for (let k = 0; k < shuffled.length; k++) {
842
+ if (!shuffled[k].signature.isEmpty() && k !== proposerIndex) {
843
+ swappable.push(k);
844
+ }
845
+ }
846
+ if (swappable.length >= 2) {
847
+ const [i, j] = [swappable[0], swappable[1]];
848
+ [shuffled[i], shuffled[j]] = [shuffled[j], shuffled[i]];
849
+ }
757
850
 
758
851
  const signers = new CommitteeAttestationsAndSigners(attestations).getSigners();
759
852
  return new MaliciousCommitteeAttestationsAndSigners(shuffled, signers);
@@ -769,7 +862,7 @@ export class CheckpointProposalJob implements Traceable {
769
862
  const failedTxData = failedTxs.map(fail => fail.tx);
770
863
  const failedTxHashes = failedTxData.map(tx => tx.getTxHash());
771
864
  this.log.verbose(`Dropping failed txs ${failedTxHashes.join(', ')}`);
772
- await this.p2pClient.deleteTxs(failedTxHashes);
865
+ await this.p2pClient.handleFailedExecution(failedTxHashes);
773
866
  }
774
867
 
775
868
  /**
@@ -777,8 +870,7 @@ export class CheckpointProposalJob implements Traceable {
777
870
  * Gossip doesn't echo messages back to the sender, so the proposer's archiver/world-state
778
871
  * would never receive its own block without this explicit sync.
779
872
  */
780
- private async syncProposedBlockToArchiver(block: L2BlockNew): Promise<void> {
781
- // TODO(palla/mbps): Change default to false once block sync is stable.
873
+ private async syncProposedBlockToArchiver(block: L2Block): Promise<void> {
782
874
  if (this.config.skipPushProposedBlocksToArchiver !== false) {
783
875
  this.log.warn(`Skipping push of proposed block ${block.number} to archiver`, {
784
876
  blockNumber: block.number,
@@ -812,12 +904,34 @@ export class CheckpointProposalJob implements Traceable {
812
904
  slot: this.slot,
813
905
  feeAnalysisId: feeAnalysis?.id,
814
906
  });
815
- this.metrics.recordBlockProposalFailed('block_build_failed');
907
+ this.metrics.recordCheckpointProposalFailed('block_build_failed');
816
908
  }
817
909
 
818
910
  this.publisher.clearPendingRequests();
819
911
  }
820
912
 
913
+ /**
914
+ * Helper to handle HA double-signing errors. Returns true if the error was handled (caller should yield).
915
+ */
916
+ private handleHASigningError(err: any, errorContext: string): boolean {
917
+ if (err instanceof DutyAlreadySignedError) {
918
+ this.log.info(`${errorContext} for slot ${this.slot} already signed by another HA node, yielding`, {
919
+ slot: this.slot,
920
+ signedByNode: err.signedByNode,
921
+ });
922
+ return true;
923
+ }
924
+ if (err instanceof SlashingProtectionError) {
925
+ this.log.info(`${errorContext} for slot ${this.slot} blocked by slashing protection, yielding`, {
926
+ slot: this.slot,
927
+ existingMessageHash: err.existingMessageHash,
928
+ attemptedMessageHash: err.attemptedMessageHash,
929
+ });
930
+ return true;
931
+ }
932
+ return false;
933
+ }
934
+
821
935
  /** Waits until a specific time within the current slot */
822
936
  @trackSpan('CheckpointProposalJob.waitUntilTimeInSlot')
823
937
  protected async waitUntilTimeInSlot(targetSecondsIntoSlot: number): Promise<void> {
@@ -826,6 +940,11 @@ export class CheckpointProposalJob implements Traceable {
826
940
  await sleepUntil(new Date(targetTimestamp * 1000), this.dateProvider.nowAsDate());
827
941
  }
828
942
 
943
+ /** Waits the polling interval for transactions. Extracted for test overriding. */
944
+ protected async waitForTxsPollingInterval(): Promise<void> {
945
+ await sleep(TXS_POLLING_MS);
946
+ }
947
+
829
948
  private getSlotStartBuildTimestamp(): number {
830
949
  return getSlotStartBuildTimestamp(this.slot, this.l1Constants);
831
950
  }