@aztec/sequencer-client 0.0.1-commit.18ccd8f0 → 0.0.1-commit.1a421b1a1

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 (73) 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 -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/publisher/config.d.ts +35 -17
  10. package/dest/publisher/config.d.ts.map +1 -1
  11. package/dest/publisher/config.js +106 -42
  12. package/dest/publisher/index.d.ts +2 -1
  13. package/dest/publisher/index.d.ts.map +1 -1
  14. package/dest/publisher/l1_tx_failed_store/factory.d.ts +11 -0
  15. package/dest/publisher/l1_tx_failed_store/factory.d.ts.map +1 -0
  16. package/dest/publisher/l1_tx_failed_store/factory.js +22 -0
  17. package/dest/publisher/l1_tx_failed_store/failed_tx_store.d.ts +59 -0
  18. package/dest/publisher/l1_tx_failed_store/failed_tx_store.d.ts.map +1 -0
  19. package/dest/publisher/l1_tx_failed_store/failed_tx_store.js +1 -0
  20. package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.d.ts +15 -0
  21. package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.d.ts.map +1 -0
  22. package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.js +34 -0
  23. package/dest/publisher/l1_tx_failed_store/index.d.ts +4 -0
  24. package/dest/publisher/l1_tx_failed_store/index.d.ts.map +1 -0
  25. package/dest/publisher/l1_tx_failed_store/index.js +2 -0
  26. package/dest/publisher/sequencer-publisher-factory.d.ts +11 -3
  27. package/dest/publisher/sequencer-publisher-factory.d.ts.map +1 -1
  28. package/dest/publisher/sequencer-publisher-factory.js +27 -2
  29. package/dest/publisher/sequencer-publisher.d.ts +26 -8
  30. package/dest/publisher/sequencer-publisher.d.ts.map +1 -1
  31. package/dest/publisher/sequencer-publisher.js +338 -48
  32. package/dest/sequencer/checkpoint_proposal_job.d.ts +28 -7
  33. package/dest/sequencer/checkpoint_proposal_job.d.ts.map +1 -1
  34. package/dest/sequencer/checkpoint_proposal_job.js +169 -93
  35. package/dest/sequencer/metrics.d.ts +17 -5
  36. package/dest/sequencer/metrics.d.ts.map +1 -1
  37. package/dest/sequencer/metrics.js +86 -15
  38. package/dest/sequencer/sequencer.d.ts +26 -13
  39. package/dest/sequencer/sequencer.d.ts.map +1 -1
  40. package/dest/sequencer/sequencer.js +41 -40
  41. package/dest/sequencer/timetable.d.ts +4 -6
  42. package/dest/sequencer/timetable.d.ts.map +1 -1
  43. package/dest/sequencer/timetable.js +7 -11
  44. package/dest/sequencer/types.d.ts +2 -2
  45. package/dest/sequencer/types.d.ts.map +1 -1
  46. package/dest/test/index.d.ts +3 -5
  47. package/dest/test/index.d.ts.map +1 -1
  48. package/dest/test/mock_checkpoint_builder.d.ts +10 -10
  49. package/dest/test/mock_checkpoint_builder.d.ts.map +1 -1
  50. package/dest/test/mock_checkpoint_builder.js +45 -36
  51. package/dest/test/utils.d.ts +3 -3
  52. package/dest/test/utils.d.ts.map +1 -1
  53. package/dest/test/utils.js +5 -4
  54. package/package.json +28 -28
  55. package/src/client/sequencer-client.ts +135 -18
  56. package/src/config.ts +54 -38
  57. package/src/global_variable_builder/global_builder.ts +1 -1
  58. package/src/publisher/config.ts +121 -43
  59. package/src/publisher/index.ts +3 -0
  60. package/src/publisher/l1_tx_failed_store/factory.ts +32 -0
  61. package/src/publisher/l1_tx_failed_store/failed_tx_store.ts +55 -0
  62. package/src/publisher/l1_tx_failed_store/file_store_failed_tx_store.ts +46 -0
  63. package/src/publisher/l1_tx_failed_store/index.ts +3 -0
  64. package/src/publisher/sequencer-publisher-factory.ts +38 -6
  65. package/src/publisher/sequencer-publisher.ts +333 -60
  66. package/src/sequencer/checkpoint_proposal_job.ts +227 -118
  67. package/src/sequencer/metrics.ts +92 -18
  68. package/src/sequencer/sequencer.ts +52 -46
  69. package/src/sequencer/timetable.ts +13 -12
  70. package/src/sequencer/types.ts +1 -1
  71. package/src/test/index.ts +2 -4
  72. package/src/test/mock_checkpoint_builder.ts +62 -50
  73. package/src/test/utils.ts +5 -2
@@ -1,8 +1,17 @@
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';
@@ -10,7 +19,7 @@ import { filter } from '@aztec/foundation/iterator';
10
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 {
@@ -21,17 +30,18 @@ import {
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';
@@ -122,7 +132,7 @@ export class CheckpointProposalJob implements Traceable {
122
132
  await Promise.all(votesPromises);
123
133
 
124
134
  if (checkpoint) {
125
- this.metrics.recordBlockProposalSuccess();
135
+ this.metrics.recordCheckpointProposalSuccess();
126
136
  }
127
137
 
128
138
  // Do not post anything to L1 if we are fishermen, but do perform L1 fee analysis
@@ -179,18 +189,21 @@ export class CheckpointProposalJob implements Traceable {
179
189
  const inHash = computeInHashFromL1ToL2Messages(l1ToL2Messages);
180
190
 
181
191
  // Collect the out hashes of all the checkpoints before this one in the same epoch
182
- const previousCheckpoints = (await this.l2BlockSource.getCheckpointsForEpoch(this.epoch)).filter(
183
- c => c.number < this.checkpointNumber,
184
- );
185
- 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();
186
198
 
187
199
  // Create a long-lived forked world state for the checkpoint builder
188
- using fork = await this.worldState.fork(this.syncedToBlockNumber, { closeDelayMs: 12_000 });
200
+ await using fork = await this.worldState.fork(this.syncedToBlockNumber, { closeDelayMs: 12_000 });
189
201
 
190
202
  // Create checkpoint builder for the entire slot
191
203
  const checkpointBuilder = await this.checkpointsBuilder.startCheckpoint(
192
204
  this.checkpointNumber,
193
205
  checkpointGlobalVariables,
206
+ feeAssetPriceModifier,
194
207
  l1ToL2Messages,
195
208
  previousCheckpointOutHashes,
196
209
  fork,
@@ -210,6 +223,7 @@ export class CheckpointProposalJob implements Traceable {
210
223
 
211
224
  let blocksInCheckpoint: L2Block[] = [];
212
225
  let blockPendingBroadcast: { block: L2Block; txs: Tx[] } | undefined = undefined;
226
+ const checkpointBuildTimer = new Timer();
213
227
 
214
228
  try {
215
229
  // Main loop: build blocks for the checkpoint
@@ -225,19 +239,7 @@ export class CheckpointProposalJob implements Traceable {
225
239
  // These errors are expected in HA mode, so we yield and let another HA node handle the slot
226
240
  // The only distinction between the 2 errors is SlashingProtectionError throws when the payload is different,
227
241
  // which is normal for block building (may have picked different txs)
228
- if (err instanceof DutyAlreadySignedError) {
229
- this.log.info(`Checkpoint proposal for slot ${this.slot} already signed by another HA node, yielding`, {
230
- slot: this.slot,
231
- signedByNode: err.signedByNode,
232
- });
233
- return undefined;
234
- }
235
- if (err instanceof SlashingProtectionError) {
236
- this.log.info(`Checkpoint proposal for slot ${this.slot} blocked by slashing protection, yielding`, {
237
- slot: this.slot,
238
- existingMessageHash: err.existingMessageHash,
239
- attemptedMessageHash: err.attemptedMessageHash,
240
- });
242
+ if (this.handleHASigningError(err, 'Block proposal')) {
241
243
  return undefined;
242
244
  }
243
245
  throw err;
@@ -249,11 +251,44 @@ export class CheckpointProposalJob implements Traceable {
249
251
  return undefined;
250
252
  }
251
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
+
252
263
  // Assemble and broadcast the checkpoint proposal, including the last block that was not
253
264
  // broadcasted yet, and wait to collect the committee attestations.
254
265
  this.setStateFn(SequencerState.ASSEMBLING_CHECKPOINT, this.slot);
255
266
  const checkpoint = await checkpointBuilder.completeCheckpoint();
256
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
+
257
292
  // Do not collect attestations nor publish to L1 in fisherman mode
258
293
  if (this.config.fishermanMode) {
259
294
  this.log.info(
@@ -280,6 +315,7 @@ export class CheckpointProposalJob implements Traceable {
280
315
  const proposal = await this.validatorClient.createCheckpointProposal(
281
316
  checkpoint.header,
282
317
  checkpoint.archive.root,
318
+ feeAssetPriceModifier,
283
319
  lastBlock,
284
320
  this.proposer,
285
321
  checkpointProposalOptions,
@@ -306,20 +342,8 @@ export class CheckpointProposalJob implements Traceable {
306
342
  );
307
343
  } catch (err) {
308
344
  // We shouldn't really get here since we yield to another HA node
309
- // as soon as we see these errors when creating block proposals.
310
- if (err instanceof DutyAlreadySignedError) {
311
- this.log.info(`Attestations signature for slot ${this.slot} already signed by another HA node, yielding`, {
312
- slot: this.slot,
313
- signedByNode: err.signedByNode,
314
- });
315
- return undefined;
316
- }
317
- if (err instanceof SlashingProtectionError) {
318
- this.log.info(`Attestations signature for slot ${this.slot} blocked by slashing protection, yielding`, {
319
- slot: this.slot,
320
- existingMessageHash: err.existingMessageHash,
321
- attemptedMessageHash: err.attemptedMessageHash,
322
- });
345
+ // as soon as we see these errors when creating block or checkpoint proposals.
346
+ if (this.handleHASigningError(err, 'Attestations signature')) {
323
347
  return undefined;
324
348
  }
325
349
  throw err;
@@ -330,6 +354,21 @@ export class CheckpointProposalJob implements Traceable {
330
354
  const aztecSlotDuration = this.l1Constants.slotDuration;
331
355
  const slotStartBuildTimestamp = this.getSlotStartBuildTimestamp();
332
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
+
333
372
  await this.publisher.enqueueProposeCheckpoint(checkpoint, attestations, attestationsSignature, {
334
373
  txTimeoutAt,
335
374
  forcePendingCheckpointNumber: this.invalidateCheckpoint?.forcePendingCheckpointNumber,
@@ -364,15 +403,12 @@ export class CheckpointProposalJob implements Traceable {
364
403
  const txHashesAlreadyIncluded = new Set<string>();
365
404
  const initialBlockNumber = BlockNumber(this.syncedToBlockNumber + 1);
366
405
 
367
- // Remaining blob fields available for blocks (checkpoint end marker already subtracted)
368
- let remainingBlobFields = BLOBS_PER_CHECKPOINT * FIELDS_PER_BLOB - NUM_CHECKPOINT_END_MARKER_FIELDS;
369
-
370
406
  // Last block in the checkpoint will usually be flagged as pending broadcast, so we send it along with the checkpoint proposal
371
407
  let blockPendingBroadcast: { block: L2Block; txs: Tx[] } | undefined = undefined;
372
408
 
373
409
  while (true) {
374
410
  const blocksBuilt = blocksInCheckpoint.length;
375
- const indexWithinCheckpoint = blocksBuilt;
411
+ const indexWithinCheckpoint = IndexWithinCheckpoint(blocksBuilt);
376
412
  const blockNumber = BlockNumber(initialBlockNumber + blocksBuilt);
377
413
 
378
414
  const secondsIntoSlot = this.getSecondsIntoSlot();
@@ -399,9 +435,9 @@ export class CheckpointProposalJob implements Traceable {
399
435
  blockNumber,
400
436
  indexWithinCheckpoint,
401
437
  txHashesAlreadyIncluded,
402
- remainingBlobFields,
403
438
  });
404
439
 
440
+ // TODO(palla/mbps): Review these conditions. We may want to keep trying in some scenarios.
405
441
  if (!buildResult && timingInfo.isLastBlock) {
406
442
  // If no block was produced due to not enough txs and this was the last subslot, exit
407
443
  break;
@@ -424,12 +460,9 @@ export class CheckpointProposalJob implements Traceable {
424
460
  break;
425
461
  }
426
462
 
427
- const { block, usedTxs, remainingBlobFields: newRemainingBlobFields } = buildResult;
463
+ const { block, usedTxs } = buildResult;
428
464
  blocksInCheckpoint.push(block);
429
465
 
430
- // Update remaining blob fields for the next block
431
- remainingBlobFields = newRemainingBlobFields;
432
-
433
466
  // Sync the proposed block to the archiver to make it available
434
467
  // Note that the checkpoint builder uses its own fork so it should not need to wait for this syncing
435
468
  // Eventually we should refactor the checkpoint builder to not need a separate long-lived fork
@@ -488,27 +521,19 @@ export class CheckpointProposalJob implements Traceable {
488
521
 
489
522
  /** Builds a single block. Called from the main block building loop. */
490
523
  @trackSpan('CheckpointProposalJob.buildSingleBlock')
491
- private async buildSingleBlock(
524
+ protected async buildSingleBlock(
492
525
  checkpointBuilder: CheckpointBuilder,
493
526
  opts: {
494
527
  forceCreate?: boolean;
495
528
  blockTimestamp: bigint;
496
529
  blockNumber: BlockNumber;
497
- indexWithinCheckpoint: number;
530
+ indexWithinCheckpoint: IndexWithinCheckpoint;
498
531
  buildDeadline: Date | undefined;
499
532
  txHashesAlreadyIncluded: Set<string>;
500
- remainingBlobFields: number;
501
533
  },
502
- ): Promise<{ block: L2Block; usedTxs: Tx[]; remainingBlobFields: number } | { error: Error } | undefined> {
503
- const {
504
- blockTimestamp,
505
- forceCreate,
506
- blockNumber,
507
- indexWithinCheckpoint,
508
- buildDeadline,
509
- txHashesAlreadyIncluded,
510
- remainingBlobFields,
511
- } = opts;
534
+ ): Promise<{ block: L2Block; usedTxs: Tx[] } | { error: Error } | undefined> {
535
+ const { blockTimestamp, forceCreate, blockNumber, indexWithinCheckpoint, buildDeadline, txHashesAlreadyIncluded } =
536
+ opts;
512
537
 
513
538
  this.log.verbose(
514
539
  `Preparing block ${blockNumber} index ${indexWithinCheckpoint} at checkpoint ${this.checkpointNumber} for slot ${this.slot}`,
@@ -517,8 +542,7 @@ export class CheckpointProposalJob implements Traceable {
517
542
 
518
543
  try {
519
544
  // Wait until we have enough txs to build the block
520
- const minTxs = this.config.minTxsPerBlock;
521
- const { availableTxs, canStartBuilding } = await this.waitForMinTxs(opts);
545
+ const { availableTxs, canStartBuilding, minTxs } = await this.waitForMinTxs(opts);
522
546
  if (!canStartBuilding) {
523
547
  this.log.warn(
524
548
  `Not enough txs to build block ${blockNumber} at index ${indexWithinCheckpoint} in slot ${this.slot} (got ${availableTxs} txs but needs ${minTxs})`,
@@ -532,7 +556,7 @@ export class CheckpointProposalJob implements Traceable {
532
556
  // Create iterator to pending txs. We filter out txs already included in previous blocks in the checkpoint
533
557
  // just in case p2p failed to sync the provisional block and didn't get to remove those txs from the mempool yet.
534
558
  const pendingTxs = filter(
535
- this.p2pClient.iteratePendingTxs(),
559
+ this.p2pClient.iterateEligiblePendingTxs(),
536
560
  tx => !txHashesAlreadyIncluded.has(tx.txHash.toString()),
537
561
  );
538
562
 
@@ -542,64 +566,57 @@ export class CheckpointProposalJob implements Traceable {
542
566
  );
543
567
  this.setStateFn(SequencerState.CREATING_BLOCK, this.slot);
544
568
 
545
- // Calculate blob fields limit for txs (remaining capacity - this block's end overhead)
546
- const blockEndOverhead = getNumBlockEndBlobFields(indexWithinCheckpoint === 0);
547
- const maxBlobFieldsForTxs = remainingBlobFields - blockEndOverhead;
548
-
569
+ // Per-block limits derived at startup by computeBlockLimits(), further capped
570
+ // by remaining checkpoint-level budgets inside CheckpointBuilder before each block is built.
549
571
  const blockBuilderOptions: PublicProcessorLimits = {
550
572
  maxTransactions: this.config.maxTxsPerBlock,
551
- maxBlockSize: this.config.maxBlockSizeInBytes,
552
- maxBlockGas: new Gas(this.config.maxDABlockGas, this.config.maxL2BlockGas),
553
- maxBlobFields: maxBlobFieldsForTxs,
573
+ maxBlockGas:
574
+ this.config.maxL2BlockGas !== undefined || this.config.maxDABlockGas !== undefined
575
+ ? new Gas(this.config.maxDABlockGas ?? Infinity, this.config.maxL2BlockGas ?? Infinity)
576
+ : undefined,
554
577
  deadline: buildDeadline,
578
+ isBuildingProposal: true,
555
579
  };
556
580
 
557
581
  // Actually build the block by executing txs
558
- const workTimer = new Timer();
559
- const {
560
- publicGas,
561
- block,
562
- publicProcessorDuration,
563
- numTxs,
564
- blockBuildingTimer,
565
- usedTxs,
566
- failedTxs,
567
- usedTxBlobFields,
568
- } = await checkpointBuilder.buildBlock(pendingTxs, blockNumber, blockTimestamp, blockBuilderOptions);
569
- const blockBuildDuration = workTimer.ms();
582
+ const buildResult = await this.buildSingleBlockWithCheckpointBuilder(
583
+ checkpointBuilder,
584
+ pendingTxs,
585
+ blockNumber,
586
+ blockTimestamp,
587
+ blockBuilderOptions,
588
+ );
570
589
 
571
590
  // If any txs failed during execution, drop them from the mempool so we don't pick them up again
572
- await this.dropFailedTxsFromP2P(failedTxs);
591
+ await this.dropFailedTxsFromP2P(buildResult.failedTxs);
573
592
 
574
593
  // Check if we have created a block with enough txs. If there were invalid txs in the pool, or if execution took
575
594
  // too long, then we may not get to minTxsPerBlock after executing public functions.
576
595
  const minValidTxs = this.config.minValidTxsPerBlock ?? minTxs;
577
- if (!forceCreate && numTxs < minValidTxs) {
596
+ const numTxs = buildResult.status === 'no-valid-txs' ? 0 : buildResult.numTxs;
597
+ if (buildResult.status === 'no-valid-txs' || (!forceCreate && numTxs < minValidTxs)) {
578
598
  this.log.warn(
579
- `Block ${blockNumber} at index ${indexWithinCheckpoint} on slot ${this.slot} has too few valid txs to be proposed (got ${numTxs} but required ${minValidTxs})`,
580
- { slot: this.slot, blockNumber, numTxs, indexWithinCheckpoint },
599
+ `Block ${blockNumber} at index ${indexWithinCheckpoint} on slot ${this.slot} has too few valid txs to be proposed`,
600
+ { slot: this.slot, blockNumber, numTxs, indexWithinCheckpoint, minValidTxs, buildResult: buildResult.status },
581
601
  );
582
- this.eventEmitter.emit('block-tx-count-check-failed', {
583
- minTxs: minValidTxs,
584
- availableTxs: numTxs,
585
- slot: this.slot,
586
- });
602
+ this.eventEmitter.emit('block-build-failed', { reason: `Insufficient valid txs`, slot: this.slot });
587
603
  this.metrics.recordBlockProposalFailed('insufficient_valid_txs');
588
604
  return undefined;
589
605
  }
590
606
 
591
607
  // Block creation succeeded, emit stats and metrics
608
+ const { block, publicProcessorDuration, usedTxs, blockBuildDuration } = buildResult;
609
+
592
610
  const blockStats = {
593
611
  eventName: 'l2-block-built',
594
612
  duration: blockBuildDuration,
595
613
  publicProcessDuration: publicProcessorDuration,
596
- rollupCircuitsDuration: blockBuildingTimer.ms(),
597
614
  ...block.getStats(),
598
615
  } satisfies L2BlockBuiltStats;
599
616
 
600
617
  const blockHash = await block.hash();
601
618
  const txHashes = block.body.txEffects.map(tx => tx.txHash);
602
- const manaPerSec = publicGas.l2Gas / (blockBuildDuration / 1000);
619
+ const manaPerSec = block.header.totalManaUsed.toNumberUnsafe() / (blockBuildDuration / 1000);
603
620
 
604
621
  this.log.info(
605
622
  `Built block ${block.number} at checkpoint ${this.checkpointNumber} for slot ${this.slot} with ${numTxs} txs`,
@@ -607,9 +624,9 @@ export class CheckpointProposalJob implements Traceable {
607
624
  );
608
625
 
609
626
  this.eventEmitter.emit('block-proposed', { blockNumber: block.number, slot: this.slot });
610
- this.metrics.recordBuiltBlock(blockBuildDuration, publicGas.l2Gas);
627
+ this.metrics.recordBuiltBlock(blockBuildDuration, block.header.totalManaUsed.toNumberUnsafe());
611
628
 
612
- return { block, usedTxs, remainingBlobFields: maxBlobFieldsForTxs - usedTxBlobFields };
629
+ return { block, usedTxs };
613
630
  } catch (err: any) {
614
631
  this.eventEmitter.emit('block-build-failed', { reason: err.message, slot: this.slot });
615
632
  this.log.error(`Error building block`, err, { blockNumber, slot: this.slot });
@@ -619,17 +636,40 @@ export class CheckpointProposalJob implements Traceable {
619
636
  }
620
637
  }
621
638
 
639
+ /** Uses the checkpoint builder to build a block, catching specific txs */
640
+ private async buildSingleBlockWithCheckpointBuilder(
641
+ checkpointBuilder: CheckpointBuilder,
642
+ pendingTxs: AsyncIterable<Tx>,
643
+ blockNumber: BlockNumber,
644
+ blockTimestamp: bigint,
645
+ blockBuilderOptions: PublicProcessorLimits,
646
+ ) {
647
+ try {
648
+ const workTimer = new Timer();
649
+ const result = await checkpointBuilder.buildBlock(pendingTxs, blockNumber, blockTimestamp, blockBuilderOptions);
650
+ const blockBuildDuration = workTimer.ms();
651
+ return { ...result, blockBuildDuration, status: 'success' as const };
652
+ } catch (err: unknown) {
653
+ if (isErrorClass(err, NoValidTxsError)) {
654
+ return { failedTxs: err.failedTxs, status: 'no-valid-txs' as const };
655
+ }
656
+ throw err;
657
+ }
658
+ }
659
+
622
660
  /** Waits until minTxs are available on the pool for building a block. */
623
661
  @trackSpan('CheckpointProposalJob.waitForMinTxs')
624
662
  private async waitForMinTxs(opts: {
625
663
  forceCreate?: boolean;
626
664
  blockNumber: BlockNumber;
627
- indexWithinCheckpoint: number;
665
+ indexWithinCheckpoint: IndexWithinCheckpoint;
628
666
  buildDeadline: Date | undefined;
629
- }): Promise<{ canStartBuilding: boolean; availableTxs: number }> {
630
- const minTxs = this.config.minTxsPerBlock;
667
+ }): Promise<{ canStartBuilding: boolean; availableTxs: number; minTxs: number }> {
631
668
  const { indexWithinCheckpoint, blockNumber, buildDeadline, forceCreate } = opts;
632
669
 
670
+ // We only allow a block with 0 txs in the first block of the checkpoint
671
+ const minTxs = indexWithinCheckpoint > 0 && this.config.minTxsPerBlock === 0 ? 1 : this.config.minTxsPerBlock;
672
+
633
673
  // Deadline is undefined if we are not enforcing the timetable, meaning we'll exit immediately when out of time
634
674
  const startBuildingDeadline = buildDeadline
635
675
  ? new Date(buildDeadline.getTime() - this.timetable.minExecutionTime * 1000)
@@ -641,7 +681,7 @@ export class CheckpointProposalJob implements Traceable {
641
681
  // If we're past deadline, or we have no deadline, give up
642
682
  const now = this.dateProvider.nowAsDate();
643
683
  if (startBuildingDeadline === undefined || now >= startBuildingDeadline) {
644
- return { canStartBuilding: false, availableTxs: availableTxs };
684
+ return { canStartBuilding: false, availableTxs, minTxs };
645
685
  }
646
686
 
647
687
  // Wait a bit before checking again
@@ -650,11 +690,11 @@ export class CheckpointProposalJob implements Traceable {
650
690
  `Waiting for enough txs to build block ${blockNumber} at index ${indexWithinCheckpoint} in slot ${this.slot} (have ${availableTxs} but need ${minTxs})`,
651
691
  { blockNumber, slot: this.slot, indexWithinCheckpoint },
652
692
  );
653
- await sleep(TXS_POLLING_MS);
693
+ await this.waitForTxsPollingInterval();
654
694
  availableTxs = await this.p2pClient.getPendingTxCount();
655
695
  }
656
696
 
657
- return { canStartBuilding: true, availableTxs };
697
+ return { canStartBuilding: true, availableTxs, minTxs };
658
698
  }
659
699
 
660
700
  /**
@@ -706,11 +746,28 @@ export class CheckpointProposalJob implements Traceable {
706
746
 
707
747
  collectedAttestationsCount = attestations.length;
708
748
 
749
+ // Trim attestations to minimum required to save L1 calldata gas
750
+ const localAddresses = this.validatorClient.getValidatorAddresses();
751
+ const trimmed = trimAttestations(
752
+ attestations,
753
+ numberOfRequiredAttestations,
754
+ this.attestorAddress,
755
+ localAddresses,
756
+ );
757
+ if (trimmed.length < attestations.length) {
758
+ this.log.debug(`Trimmed attestations from ${attestations.length} to ${trimmed.length} for L1 submission`);
759
+ }
760
+
709
761
  // Rollup contract requires that the signatures are provided in the order of the committee
710
- const sorted = orderAttestations(attestations, committee);
762
+ const sorted = orderAttestations(trimmed, committee);
711
763
 
712
764
  // Manipulate the attestations if we've been configured to do so
713
- if (this.config.injectFakeAttestation || this.config.shuffleAttestationOrdering) {
765
+ if (
766
+ this.config.injectFakeAttestation ||
767
+ this.config.injectHighSValueAttestation ||
768
+ this.config.injectUnrecoverableSignatureAttestation ||
769
+ this.config.shuffleAttestationOrdering
770
+ ) {
714
771
  return this.manipulateAttestations(proposal.slotNumber, epoch, seed, committee, sorted);
715
772
  }
716
773
 
@@ -739,7 +796,11 @@ export class CheckpointProposalJob implements Traceable {
739
796
  this.epochCache.computeProposerIndex(slotNumber, epoch, seed, BigInt(committee.length)),
740
797
  );
741
798
 
742
- if (this.config.injectFakeAttestation) {
799
+ if (
800
+ this.config.injectFakeAttestation ||
801
+ this.config.injectHighSValueAttestation ||
802
+ this.config.injectUnrecoverableSignatureAttestation
803
+ ) {
743
804
  // Find non-empty attestations that are not from the proposer
744
805
  const nonProposerIndices: number[] = [];
745
806
  for (let i = 0; i < attestations.length; i++) {
@@ -749,8 +810,20 @@ export class CheckpointProposalJob implements Traceable {
749
810
  }
750
811
  if (nonProposerIndices.length > 0) {
751
812
  const targetIndex = nonProposerIndices[randomInt(nonProposerIndices.length)];
752
- this.log.warn(`Injecting fake attestation in checkpoint for slot ${slotNumber} at index ${targetIndex}`);
753
- unfreeze(attestations[targetIndex]).signature = Signature.random();
813
+ if (this.config.injectHighSValueAttestation) {
814
+ this.log.warn(
815
+ `Injecting high-s value attestation in checkpoint for slot ${slotNumber} at index ${targetIndex}`,
816
+ );
817
+ unfreeze(attestations[targetIndex]).signature = flipSignature(attestations[targetIndex].signature);
818
+ } else if (this.config.injectUnrecoverableSignatureAttestation) {
819
+ this.log.warn(
820
+ `Injecting unrecoverable signature attestation in checkpoint for slot ${slotNumber} at index ${targetIndex}`,
821
+ );
822
+ unfreeze(attestations[targetIndex]).signature = generateUnrecoverableSignature();
823
+ } else {
824
+ this.log.warn(`Injecting fake attestation in checkpoint for slot ${slotNumber} at index ${targetIndex}`);
825
+ unfreeze(attestations[targetIndex]).signature = generateRecoverableSignature();
826
+ }
754
827
  }
755
828
  return new CommitteeAttestationsAndSigners(attestations);
756
829
  }
@@ -759,11 +832,20 @@ export class CheckpointProposalJob implements Traceable {
759
832
  this.log.warn(`Shuffling attestation ordering in checkpoint for slot ${slotNumber} (proposer #${proposerIndex})`);
760
833
 
761
834
  const shuffled = [...attestations];
762
- const [i, j] = [(proposerIndex + 1) % shuffled.length, (proposerIndex + 2) % shuffled.length];
763
- const valueI = shuffled[i];
764
- const valueJ = shuffled[j];
765
- shuffled[i] = valueJ;
766
- shuffled[j] = valueI;
835
+
836
+ // Find two non-proposer positions that both have non-empty signatures to swap.
837
+ // This ensures the bitmap doesn't change, so the MaliciousCommitteeAttestationsAndSigners
838
+ // signers array stays correctly aligned with L1's committee reconstruction.
839
+ const swappable: number[] = [];
840
+ for (let k = 0; k < shuffled.length; k++) {
841
+ if (!shuffled[k].signature.isEmpty() && k !== proposerIndex) {
842
+ swappable.push(k);
843
+ }
844
+ }
845
+ if (swappable.length >= 2) {
846
+ const [i, j] = [swappable[0], swappable[1]];
847
+ [shuffled[i], shuffled[j]] = [shuffled[j], shuffled[i]];
848
+ }
767
849
 
768
850
  const signers = new CommitteeAttestationsAndSigners(attestations).getSigners();
769
851
  return new MaliciousCommitteeAttestationsAndSigners(shuffled, signers);
@@ -779,7 +861,7 @@ export class CheckpointProposalJob implements Traceable {
779
861
  const failedTxData = failedTxs.map(fail => fail.tx);
780
862
  const failedTxHashes = failedTxData.map(tx => tx.getTxHash());
781
863
  this.log.verbose(`Dropping failed txs ${failedTxHashes.join(', ')}`);
782
- await this.p2pClient.deleteTxs(failedTxHashes);
864
+ await this.p2pClient.handleFailedExecution(failedTxHashes);
783
865
  }
784
866
 
785
867
  /**
@@ -821,12 +903,34 @@ export class CheckpointProposalJob implements Traceable {
821
903
  slot: this.slot,
822
904
  feeAnalysisId: feeAnalysis?.id,
823
905
  });
824
- this.metrics.recordBlockProposalFailed('block_build_failed');
906
+ this.metrics.recordCheckpointProposalFailed('block_build_failed');
825
907
  }
826
908
 
827
909
  this.publisher.clearPendingRequests();
828
910
  }
829
911
 
912
+ /**
913
+ * Helper to handle HA double-signing errors. Returns true if the error was handled (caller should yield).
914
+ */
915
+ private handleHASigningError(err: any, errorContext: string): boolean {
916
+ if (err instanceof DutyAlreadySignedError) {
917
+ this.log.info(`${errorContext} for slot ${this.slot} already signed by another HA node, yielding`, {
918
+ slot: this.slot,
919
+ signedByNode: err.signedByNode,
920
+ });
921
+ return true;
922
+ }
923
+ if (err instanceof SlashingProtectionError) {
924
+ this.log.info(`${errorContext} for slot ${this.slot} blocked by slashing protection, yielding`, {
925
+ slot: this.slot,
926
+ existingMessageHash: err.existingMessageHash,
927
+ attemptedMessageHash: err.attemptedMessageHash,
928
+ });
929
+ return true;
930
+ }
931
+ return false;
932
+ }
933
+
830
934
  /** Waits until a specific time within the current slot */
831
935
  @trackSpan('CheckpointProposalJob.waitUntilTimeInSlot')
832
936
  protected async waitUntilTimeInSlot(targetSecondsIntoSlot: number): Promise<void> {
@@ -835,6 +939,11 @@ export class CheckpointProposalJob implements Traceable {
835
939
  await sleepUntil(new Date(targetTimestamp * 1000), this.dateProvider.nowAsDate());
836
940
  }
837
941
 
942
+ /** Waits the polling interval for transactions. Extracted for test overriding. */
943
+ protected async waitForTxsPollingInterval(): Promise<void> {
944
+ await sleep(TXS_POLLING_MS);
945
+ }
946
+
838
947
  private getSlotStartBuildTimestamp(): number {
839
948
  return getSlotStartBuildTimestamp(this.slot, this.l1Constants);
840
949
  }