@aztec/sequencer-client 0.0.1-commit.358457c → 0.0.1-commit.381b1a9

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 (55) hide show
  1. package/dest/client/sequencer-client.d.ts +12 -1
  2. package/dest/client/sequencer-client.d.ts.map +1 -1
  3. package/dest/client/sequencer-client.js +85 -13
  4. package/dest/config.d.ts +23 -4
  5. package/dest/config.d.ts.map +1 -1
  6. package/dest/config.js +23 -16
  7. package/dest/publisher/config.d.ts +1 -5
  8. package/dest/publisher/config.d.ts.map +1 -1
  9. package/dest/publisher/config.js +1 -6
  10. package/dest/publisher/index.d.ts +1 -2
  11. package/dest/publisher/index.d.ts.map +1 -1
  12. package/dest/publisher/sequencer-publisher.d.ts +2 -8
  13. package/dest/publisher/sequencer-publisher.d.ts.map +1 -1
  14. package/dest/publisher/sequencer-publisher.js +8 -217
  15. package/dest/sequencer/checkpoint_proposal_job.d.ts +2 -4
  16. package/dest/sequencer/checkpoint_proposal_job.d.ts.map +1 -1
  17. package/dest/sequencer/checkpoint_proposal_job.js +60 -44
  18. package/dest/sequencer/sequencer.d.ts +10 -7
  19. package/dest/sequencer/sequencer.d.ts.map +1 -1
  20. package/dest/sequencer/sequencer.js +12 -14
  21. package/dest/sequencer/timetable.d.ts +4 -3
  22. package/dest/sequencer/timetable.d.ts.map +1 -1
  23. package/dest/sequencer/timetable.js +6 -7
  24. package/dest/sequencer/types.d.ts +2 -2
  25. package/dest/sequencer/types.d.ts.map +1 -1
  26. package/dest/test/mock_checkpoint_builder.d.ts +10 -8
  27. package/dest/test/mock_checkpoint_builder.d.ts.map +1 -1
  28. package/dest/test/mock_checkpoint_builder.js +41 -30
  29. package/package.json +28 -28
  30. package/src/client/sequencer-client.ts +111 -12
  31. package/src/config.ts +28 -19
  32. package/src/publisher/config.ts +0 -9
  33. package/src/publisher/index.ts +0 -3
  34. package/src/publisher/sequencer-publisher.ts +8 -178
  35. package/src/sequencer/checkpoint_proposal_job.ts +90 -55
  36. package/src/sequencer/sequencer.ts +13 -15
  37. package/src/sequencer/timetable.ts +7 -7
  38. package/src/sequencer/types.ts +1 -1
  39. package/src/test/mock_checkpoint_builder.ts +52 -47
  40. package/dest/publisher/l1_tx_failed_store/factory.d.ts +0 -11
  41. package/dest/publisher/l1_tx_failed_store/factory.d.ts.map +0 -1
  42. package/dest/publisher/l1_tx_failed_store/factory.js +0 -22
  43. package/dest/publisher/l1_tx_failed_store/failed_tx_store.d.ts +0 -59
  44. package/dest/publisher/l1_tx_failed_store/failed_tx_store.d.ts.map +0 -1
  45. package/dest/publisher/l1_tx_failed_store/failed_tx_store.js +0 -1
  46. package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.d.ts +0 -15
  47. package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.d.ts.map +0 -1
  48. package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.js +0 -34
  49. package/dest/publisher/l1_tx_failed_store/index.d.ts +0 -4
  50. package/dest/publisher/l1_tx_failed_store/index.d.ts.map +0 -1
  51. package/dest/publisher/l1_tx_failed_store/index.js +0 -2
  52. package/src/publisher/l1_tx_failed_store/factory.ts +0 -32
  53. package/src/publisher/l1_tx_failed_store/failed_tx_store.ts +0 -55
  54. package/src/publisher/l1_tx_failed_store/file_store_failed_tx_store.ts +0 -46
  55. package/src/publisher/l1_tx_failed_store/index.ts +0 -3
@@ -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,11 +30,11 @@ import {
27
30
  type L2BlockSource,
28
31
  MaliciousCommitteeAttestationsAndSigners,
29
32
  } from '@aztec/stdlib/block';
30
- import type { Checkpoint } from '@aztec/stdlib/checkpoint';
33
+ import { type Checkpoint, validateCheckpoint } from '@aztec/stdlib/checkpoint';
31
34
  import { getSlotStartBuildTimestamp } from '@aztec/stdlib/epoch-helpers';
32
35
  import { Gas } from '@aztec/stdlib/gas';
33
36
  import {
34
- NoValidTxsError,
37
+ InsufficientValidTxsError,
35
38
  type PublicProcessorLimits,
36
39
  type ResolvedSequencerConfig,
37
40
  type WorldStateSynchronizer,
@@ -262,6 +265,22 @@ export class CheckpointProposalJob implements Traceable {
262
265
  this.setStateFn(SequencerState.ASSEMBLING_CHECKPOINT, this.slot);
263
266
  const checkpoint = await checkpointBuilder.completeCheckpoint();
264
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
+
265
284
  // Record checkpoint-level build metrics
266
285
  this.metrics.recordCheckpointBuild(
267
286
  checkpointBuildTimer.ms(),
@@ -384,9 +403,6 @@ export class CheckpointProposalJob implements Traceable {
384
403
  const txHashesAlreadyIncluded = new Set<string>();
385
404
  const initialBlockNumber = BlockNumber(this.syncedToBlockNumber + 1);
386
405
 
387
- // Remaining blob fields available for blocks (checkpoint end marker already subtracted)
388
- let remainingBlobFields = BLOBS_PER_CHECKPOINT * FIELDS_PER_BLOB - NUM_CHECKPOINT_END_MARKER_FIELDS;
389
-
390
406
  // Last block in the checkpoint will usually be flagged as pending broadcast, so we send it along with the checkpoint proposal
391
407
  let blockPendingBroadcast: { block: L2Block; txs: Tx[] } | undefined = undefined;
392
408
 
@@ -419,7 +435,6 @@ export class CheckpointProposalJob implements Traceable {
419
435
  blockNumber,
420
436
  indexWithinCheckpoint,
421
437
  txHashesAlreadyIncluded,
422
- remainingBlobFields,
423
438
  });
424
439
 
425
440
  // TODO(palla/mbps): Review these conditions. We may want to keep trying in some scenarios.
@@ -445,12 +460,9 @@ export class CheckpointProposalJob implements Traceable {
445
460
  break;
446
461
  }
447
462
 
448
- const { block, usedTxs, remainingBlobFields: newRemainingBlobFields } = buildResult;
463
+ const { block, usedTxs } = buildResult;
449
464
  blocksInCheckpoint.push(block);
450
465
 
451
- // Update remaining blob fields for the next block
452
- remainingBlobFields = newRemainingBlobFields;
453
-
454
466
  // Sync the proposed block to the archiver to make it available
455
467
  // Note that the checkpoint builder uses its own fork so it should not need to wait for this syncing
456
468
  // Eventually we should refactor the checkpoint builder to not need a separate long-lived fork
@@ -518,18 +530,10 @@ export class CheckpointProposalJob implements Traceable {
518
530
  indexWithinCheckpoint: IndexWithinCheckpoint;
519
531
  buildDeadline: Date | undefined;
520
532
  txHashesAlreadyIncluded: Set<string>;
521
- remainingBlobFields: number;
522
533
  },
523
- ): Promise<{ block: L2Block; usedTxs: Tx[]; remainingBlobFields: number } | { error: Error } | undefined> {
524
- const {
525
- blockTimestamp,
526
- forceCreate,
527
- blockNumber,
528
- indexWithinCheckpoint,
529
- buildDeadline,
530
- txHashesAlreadyIncluded,
531
- remainingBlobFields,
532
- } = opts;
534
+ ): Promise<{ block: L2Block; usedTxs: Tx[] } | { error: Error } | undefined> {
535
+ const { blockTimestamp, forceCreate, blockNumber, indexWithinCheckpoint, buildDeadline, txHashesAlreadyIncluded } =
536
+ opts;
533
537
 
534
538
  this.log.verbose(
535
539
  `Preparing block ${blockNumber} index ${indexWithinCheckpoint} at checkpoint ${this.checkpointNumber} for slot ${this.slot}`,
@@ -538,8 +542,7 @@ export class CheckpointProposalJob implements Traceable {
538
542
 
539
543
  try {
540
544
  // Wait until we have enough txs to build the block
541
- const minTxs = this.config.minTxsPerBlock;
542
- const { availableTxs, canStartBuilding } = await this.waitForMinTxs(opts);
545
+ const { availableTxs, canStartBuilding, minTxs } = await this.waitForMinTxs(opts);
543
546
  if (!canStartBuilding) {
544
547
  this.log.warn(
545
548
  `Not enough txs to build block ${blockNumber} at index ${indexWithinCheckpoint} in slot ${this.slot} (got ${availableTxs} txs but needs ${minTxs})`,
@@ -563,19 +566,24 @@ export class CheckpointProposalJob implements Traceable {
563
566
  );
564
567
  this.setStateFn(SequencerState.CREATING_BLOCK, this.slot);
565
568
 
566
- // Calculate blob fields limit for txs (remaining capacity - this block's end overhead)
567
- const blockEndOverhead = getNumBlockEndBlobFields(indexWithinCheckpoint === 0);
568
- const maxBlobFieldsForTxs = remainingBlobFields - blockEndOverhead;
569
-
570
- const blockBuilderOptions: PublicProcessorLimits = {
569
+ // Per-block limits derived at startup by computeBlockLimits(), further capped
570
+ // by remaining checkpoint-level budgets inside CheckpointBuilder before each block is built.
571
+ // minValidTxs is passed into the builder so it can reject the block *before* updating state.
572
+ const minValidTxs = forceCreate ? 0 : (this.config.minValidTxsPerBlock ?? minTxs);
573
+ const blockBuilderOptions: PublicProcessorLimits & { minValidTxs?: number } = {
571
574
  maxTransactions: this.config.maxTxsPerBlock,
572
- maxBlockSize: this.config.maxBlockSizeInBytes,
573
- maxBlockGas: new Gas(this.config.maxDABlockGas, this.config.maxL2BlockGas),
574
- maxBlobFields: maxBlobFieldsForTxs,
575
+ maxBlockGas:
576
+ this.config.maxL2BlockGas !== undefined || this.config.maxDABlockGas !== undefined
577
+ ? new Gas(this.config.maxDABlockGas ?? Infinity, this.config.maxL2BlockGas ?? Infinity)
578
+ : undefined,
575
579
  deadline: buildDeadline,
580
+ isBuildingProposal: true,
581
+ minValidTxs,
576
582
  };
577
583
 
578
- // Actually build the block by executing txs
584
+ // Actually build the block by executing txs. The builder throws InsufficientValidTxsError
585
+ // if the number of successfully processed txs is below minValidTxs, ensuring state is not
586
+ // updated for blocks that will be discarded.
579
587
  const buildResult = await this.buildSingleBlockWithCheckpointBuilder(
580
588
  checkpointBuilder,
581
589
  pendingTxs,
@@ -587,14 +595,16 @@ export class CheckpointProposalJob implements Traceable {
587
595
  // If any txs failed during execution, drop them from the mempool so we don't pick them up again
588
596
  await this.dropFailedTxsFromP2P(buildResult.failedTxs);
589
597
 
590
- // Check if we have created a block with enough txs. If there were invalid txs in the pool, or if execution took
591
- // too long, then we may not get to minTxsPerBlock after executing public functions.
592
- const minValidTxs = this.config.minValidTxsPerBlock ?? minTxs;
593
- const numTxs = buildResult.status === 'no-valid-txs' ? 0 : buildResult.numTxs;
594
- if (buildResult.status === 'no-valid-txs' || (!forceCreate && numTxs < minValidTxs)) {
598
+ if (buildResult.status === 'insufficient-valid-txs') {
595
599
  this.log.warn(
596
600
  `Block ${blockNumber} at index ${indexWithinCheckpoint} on slot ${this.slot} has too few valid txs to be proposed`,
597
- { slot: this.slot, blockNumber, numTxs, indexWithinCheckpoint, minValidTxs, buildResult: buildResult.status },
601
+ {
602
+ slot: this.slot,
603
+ blockNumber,
604
+ numTxs: buildResult.processedCount,
605
+ indexWithinCheckpoint,
606
+ minValidTxs,
607
+ },
598
608
  );
599
609
  this.eventEmitter.emit('block-build-failed', { reason: `Insufficient valid txs`, slot: this.slot });
600
610
  this.metrics.recordBlockProposalFailed('insufficient_valid_txs');
@@ -602,7 +612,7 @@ export class CheckpointProposalJob implements Traceable {
602
612
  }
603
613
 
604
614
  // Block creation succeeded, emit stats and metrics
605
- const { publicGas, block, publicProcessorDuration, usedTxs, usedTxBlobFields, blockBuildDuration } = buildResult;
615
+ const { block, publicProcessorDuration, usedTxs, blockBuildDuration, numTxs } = buildResult;
606
616
 
607
617
  const blockStats = {
608
618
  eventName: 'l2-block-built',
@@ -613,7 +623,7 @@ export class CheckpointProposalJob implements Traceable {
613
623
 
614
624
  const blockHash = await block.hash();
615
625
  const txHashes = block.body.txEffects.map(tx => tx.txHash);
616
- const manaPerSec = publicGas.l2Gas / (blockBuildDuration / 1000);
626
+ const manaPerSec = block.header.totalManaUsed.toNumberUnsafe() / (blockBuildDuration / 1000);
617
627
 
618
628
  this.log.info(
619
629
  `Built block ${block.number} at checkpoint ${this.checkpointNumber} for slot ${this.slot} with ${numTxs} txs`,
@@ -621,9 +631,9 @@ export class CheckpointProposalJob implements Traceable {
621
631
  );
622
632
 
623
633
  this.eventEmitter.emit('block-proposed', { blockNumber: block.number, slot: this.slot });
624
- this.metrics.recordBuiltBlock(blockBuildDuration, publicGas.l2Gas);
634
+ this.metrics.recordBuiltBlock(blockBuildDuration, block.header.totalManaUsed.toNumberUnsafe());
625
635
 
626
- return { block, usedTxs, remainingBlobFields: maxBlobFieldsForTxs - usedTxBlobFields };
636
+ return { block, usedTxs };
627
637
  } catch (err: any) {
628
638
  this.eventEmitter.emit('block-build-failed', { reason: err.message, slot: this.slot });
629
639
  this.log.error(`Error building block`, err, { blockNumber, slot: this.slot });
@@ -633,13 +643,13 @@ export class CheckpointProposalJob implements Traceable {
633
643
  }
634
644
  }
635
645
 
636
- /** Uses the checkpoint builder to build a block, catching specific txs */
646
+ /** Uses the checkpoint builder to build a block, catching InsufficientValidTxsError. */
637
647
  private async buildSingleBlockWithCheckpointBuilder(
638
648
  checkpointBuilder: CheckpointBuilder,
639
649
  pendingTxs: AsyncIterable<Tx>,
640
650
  blockNumber: BlockNumber,
641
651
  blockTimestamp: bigint,
642
- blockBuilderOptions: PublicProcessorLimits,
652
+ blockBuilderOptions: PublicProcessorLimits & { minValidTxs?: number },
643
653
  ) {
644
654
  try {
645
655
  const workTimer = new Timer();
@@ -647,8 +657,12 @@ export class CheckpointProposalJob implements Traceable {
647
657
  const blockBuildDuration = workTimer.ms();
648
658
  return { ...result, blockBuildDuration, status: 'success' as const };
649
659
  } catch (err: unknown) {
650
- if (isErrorClass(err, NoValidTxsError)) {
651
- return { failedTxs: err.failedTxs, status: 'no-valid-txs' as const };
660
+ if (isErrorClass(err, InsufficientValidTxsError)) {
661
+ return {
662
+ failedTxs: err.failedTxs,
663
+ processedCount: err.processedCount,
664
+ status: 'insufficient-valid-txs' as const,
665
+ };
652
666
  }
653
667
  throw err;
654
668
  }
@@ -661,7 +675,7 @@ export class CheckpointProposalJob implements Traceable {
661
675
  blockNumber: BlockNumber;
662
676
  indexWithinCheckpoint: IndexWithinCheckpoint;
663
677
  buildDeadline: Date | undefined;
664
- }): Promise<{ canStartBuilding: boolean; availableTxs: number }> {
678
+ }): Promise<{ canStartBuilding: boolean; availableTxs: number; minTxs: number }> {
665
679
  const { indexWithinCheckpoint, blockNumber, buildDeadline, forceCreate } = opts;
666
680
 
667
681
  // We only allow a block with 0 txs in the first block of the checkpoint
@@ -678,7 +692,7 @@ export class CheckpointProposalJob implements Traceable {
678
692
  // If we're past deadline, or we have no deadline, give up
679
693
  const now = this.dateProvider.nowAsDate();
680
694
  if (startBuildingDeadline === undefined || now >= startBuildingDeadline) {
681
- return { canStartBuilding: false, availableTxs: availableTxs };
695
+ return { canStartBuilding: false, availableTxs, minTxs };
682
696
  }
683
697
 
684
698
  // Wait a bit before checking again
@@ -691,7 +705,7 @@ export class CheckpointProposalJob implements Traceable {
691
705
  availableTxs = await this.p2pClient.getPendingTxCount();
692
706
  }
693
707
 
694
- return { canStartBuilding: true, availableTxs };
708
+ return { canStartBuilding: true, availableTxs, minTxs };
695
709
  }
696
710
 
697
711
  /**
@@ -759,7 +773,12 @@ export class CheckpointProposalJob implements Traceable {
759
773
  const sorted = orderAttestations(trimmed, committee);
760
774
 
761
775
  // Manipulate the attestations if we've been configured to do so
762
- if (this.config.injectFakeAttestation || this.config.shuffleAttestationOrdering) {
776
+ if (
777
+ this.config.injectFakeAttestation ||
778
+ this.config.injectHighSValueAttestation ||
779
+ this.config.injectUnrecoverableSignatureAttestation ||
780
+ this.config.shuffleAttestationOrdering
781
+ ) {
763
782
  return this.manipulateAttestations(proposal.slotNumber, epoch, seed, committee, sorted);
764
783
  }
765
784
 
@@ -788,7 +807,11 @@ export class CheckpointProposalJob implements Traceable {
788
807
  this.epochCache.computeProposerIndex(slotNumber, epoch, seed, BigInt(committee.length)),
789
808
  );
790
809
 
791
- if (this.config.injectFakeAttestation) {
810
+ if (
811
+ this.config.injectFakeAttestation ||
812
+ this.config.injectHighSValueAttestation ||
813
+ this.config.injectUnrecoverableSignatureAttestation
814
+ ) {
792
815
  // Find non-empty attestations that are not from the proposer
793
816
  const nonProposerIndices: number[] = [];
794
817
  for (let i = 0; i < attestations.length; i++) {
@@ -798,8 +821,20 @@ export class CheckpointProposalJob implements Traceable {
798
821
  }
799
822
  if (nonProposerIndices.length > 0) {
800
823
  const targetIndex = nonProposerIndices[randomInt(nonProposerIndices.length)];
801
- this.log.warn(`Injecting fake attestation in checkpoint for slot ${slotNumber} at index ${targetIndex}`);
802
- unfreeze(attestations[targetIndex]).signature = Signature.random();
824
+ if (this.config.injectHighSValueAttestation) {
825
+ this.log.warn(
826
+ `Injecting high-s value attestation in checkpoint for slot ${slotNumber} at index ${targetIndex}`,
827
+ );
828
+ unfreeze(attestations[targetIndex]).signature = flipSignature(attestations[targetIndex].signature);
829
+ } else if (this.config.injectUnrecoverableSignatureAttestation) {
830
+ this.log.warn(
831
+ `Injecting unrecoverable signature attestation in checkpoint for slot ${slotNumber} at index ${targetIndex}`,
832
+ );
833
+ unfreeze(attestations[targetIndex]).signature = generateUnrecoverableSignature();
834
+ } else {
835
+ this.log.warn(`Injecting fake attestation in checkpoint for slot ${slotNumber} at index ${targetIndex}`);
836
+ unfreeze(attestations[targetIndex]).signature = generateRecoverableSignature();
837
+ }
803
838
  }
804
839
  return new CommitteeAttestationsAndSigners(attestations);
805
840
  }
@@ -14,7 +14,7 @@ import type { P2P } from '@aztec/p2p';
14
14
  import type { SlasherClientInterface } from '@aztec/slasher';
15
15
  import type { BlockData, L2BlockSink, L2BlockSource, ValidateCheckpointResult } from '@aztec/stdlib/block';
16
16
  import type { Checkpoint } from '@aztec/stdlib/checkpoint';
17
- import { getSlotAtTimestamp, getSlotStartBuildTimestamp } from '@aztec/stdlib/epoch-helpers';
17
+ import { getSlotStartBuildTimestamp } from '@aztec/stdlib/epoch-helpers';
18
18
  import {
19
19
  type ResolvedSequencerConfig,
20
20
  type SequencerConfig,
@@ -110,7 +110,7 @@ export class Sequencer extends (EventEmitter as new () => TypedEventEmitter<Sequ
110
110
  /** Updates sequencer config by the defined values and updates the timetable */
111
111
  public updateConfig(config: Partial<SequencerConfig>) {
112
112
  const filteredConfig = pickFromSchema(config, SequencerConfigSchema);
113
- this.log.info(`Updated sequencer config`, omit(filteredConfig, 'txPublicSetupAllowList'));
113
+ this.log.info(`Updated sequencer config`, omit(filteredConfig, 'txPublicSetupAllowListExtend'));
114
114
  this.config = merge(this.config, filteredConfig);
115
115
  this.timetable = new SequencerTimetable(
116
116
  {
@@ -281,8 +281,7 @@ export class Sequencer extends (EventEmitter as new () => TypedEventEmitter<Sequ
281
281
 
282
282
  const logCtx = {
283
283
  now,
284
- syncedToL1Ts: syncedTo.l1Timestamp,
285
- syncedToL2Slot: getSlotAtTimestamp(syncedTo.l1Timestamp, this.l1Constants),
284
+ syncedToL2Slot: syncedTo.syncedL2Slot,
286
285
  slot,
287
286
  slotTs: ts,
288
287
  checkpointNumber,
@@ -475,16 +474,15 @@ export class Sequencer extends (EventEmitter as new () => TypedEventEmitter<Sequ
475
474
  * We don't check against the previous block submitted since it may have been reorg'd out.
476
475
  */
477
476
  protected async checkSync(args: { ts: bigint; slot: SlotNumber }): Promise<SequencerSyncCheckResult | undefined> {
478
- // Check that the archiver and dependencies have synced to the previous L1 slot at least
477
+ // Check that the archiver has fully synced the L2 slot before the one we want to propose in.
479
478
  // TODO(#14766): Archiver reports L1 timestamp based on L1 blocks seen, which means that a missed L1 block will
480
479
  // cause the archiver L1 timestamp to fall behind, and cause this sequencer to start processing one L1 slot later.
481
- const l1Timestamp = await this.l2BlockSource.getL1Timestamp();
482
- const { slot, ts } = args;
483
- if (l1Timestamp === undefined || l1Timestamp + BigInt(this.l1Constants.ethereumSlotDuration) < ts) {
480
+ const syncedL2Slot = await this.l2BlockSource.getSyncedL2SlotNumber();
481
+ const { slot } = args;
482
+ if (syncedL2Slot === undefined || syncedL2Slot + 1 < slot) {
484
483
  this.log.debug(`Cannot propose block at next L2 slot ${slot} due to pending sync from L1`, {
485
484
  slot,
486
- ts,
487
- l1Timestamp,
485
+ syncedL2Slot,
488
486
  });
489
487
  return undefined;
490
488
  }
@@ -524,7 +522,7 @@ export class Sequencer extends (EventEmitter as new () => TypedEventEmitter<Sequ
524
522
  checkpointNumber: CheckpointNumber.ZERO,
525
523
  blockNumber: BlockNumber.ZERO,
526
524
  archive,
527
- l1Timestamp,
525
+ syncedL2Slot,
528
526
  pendingChainValidationStatus,
529
527
  };
530
528
  }
@@ -541,7 +539,7 @@ export class Sequencer extends (EventEmitter as new () => TypedEventEmitter<Sequ
541
539
  blockNumber: blockData.header.getBlockNumber(),
542
540
  checkpointNumber: blockData.checkpointNumber,
543
541
  archive: blockData.archive.root,
544
- l1Timestamp,
542
+ syncedL2Slot,
545
543
  pendingChainValidationStatus,
546
544
  };
547
545
  }
@@ -720,7 +718,7 @@ export class Sequencer extends (EventEmitter as new () => TypedEventEmitter<Sequ
720
718
  syncedTo: SequencerSyncCheckResult,
721
719
  currentSlot: SlotNumber,
722
720
  ): Promise<void> {
723
- const { pendingChainValidationStatus, l1Timestamp } = syncedTo;
721
+ const { pendingChainValidationStatus, syncedL2Slot } = syncedTo;
724
722
  if (pendingChainValidationStatus.valid) {
725
723
  return;
726
724
  }
@@ -735,7 +733,7 @@ export class Sequencer extends (EventEmitter as new () => TypedEventEmitter<Sequ
735
733
 
736
734
  const logData = {
737
735
  invalidL1Timestamp: invalidCheckpointTimestamp,
738
- l1Timestamp,
736
+ syncedL2Slot,
739
737
  invalidCheckpoint: pendingChainValidationStatus.checkpoint,
740
738
  secondsBeforeInvalidatingBlockAsCommitteeMember,
741
739
  secondsBeforeInvalidatingBlockAsNonCommitteeMember,
@@ -882,6 +880,6 @@ type SequencerSyncCheckResult = {
882
880
  checkpointNumber: CheckpointNumber;
883
881
  blockNumber: BlockNumber;
884
882
  archive: Fr;
885
- l1Timestamp: bigint;
883
+ syncedL2Slot: SlotNumber;
886
884
  pendingChainValidationStatus: ValidateCheckpointResult;
887
885
  };
@@ -1,4 +1,4 @@
1
- import { createLogger } from '@aztec/aztec.js/log';
1
+ import type { Logger } from '@aztec/foundation/log';
2
2
  import {
3
3
  CHECKPOINT_ASSEMBLE_TIME,
4
4
  CHECKPOINT_INITIALIZATION_TIME,
@@ -80,7 +80,7 @@ export class SequencerTimetable {
80
80
  enforce: boolean;
81
81
  },
82
82
  private readonly metrics?: SequencerMetrics,
83
- private readonly log = createLogger('sequencer:timetable'),
83
+ private readonly log?: Logger,
84
84
  ) {
85
85
  this.ethereumSlotDuration = opts.ethereumSlotDuration;
86
86
  this.aztecSlotDuration = opts.aztecSlotDuration;
@@ -132,7 +132,7 @@ export class SequencerTimetable {
132
132
  const initializeDeadline = this.aztecSlotDuration - minWorkToDo;
133
133
  this.initializeDeadline = initializeDeadline;
134
134
 
135
- this.log.verbose(
135
+ this.log?.info(
136
136
  `Sequencer timetable initialized with ${this.maxNumberOfBlocks} blocks per slot (${this.enforce ? 'enforced' : 'not enforced'})`,
137
137
  {
138
138
  ethereumSlotDuration: this.ethereumSlotDuration,
@@ -206,7 +206,7 @@ export class SequencerTimetable {
206
206
  }
207
207
 
208
208
  this.metrics?.recordStateTransitionBufferMs(Math.floor(bufferSeconds * 1000), newState);
209
- this.log.trace(`Enough time to transition to ${newState}`, { maxAllowedTime, secondsIntoSlot });
209
+ this.log?.trace(`Enough time to transition to ${newState}`, { maxAllowedTime, secondsIntoSlot });
210
210
  }
211
211
 
212
212
  /**
@@ -242,7 +242,7 @@ export class SequencerTimetable {
242
242
  const canStart = available >= this.minExecutionTime;
243
243
  const deadline = secondsIntoSlot + available;
244
244
 
245
- this.log.verbose(
245
+ this.log?.verbose(
246
246
  `${canStart ? 'Can' : 'Cannot'} start single-block checkpoint at ${secondsIntoSlot}s into slot`,
247
247
  { secondsIntoSlot, maxAllowed, available, deadline },
248
248
  );
@@ -262,7 +262,7 @@ export class SequencerTimetable {
262
262
  // Found an available sub-slot! Is this the last one?
263
263
  const isLastBlock = subSlot === this.maxNumberOfBlocks;
264
264
 
265
- this.log.verbose(
265
+ this.log?.verbose(
266
266
  `Can start ${isLastBlock ? 'last block' : 'block'} in sub-slot ${subSlot} with deadline ${deadline}s`,
267
267
  { secondsIntoSlot, deadline, timeUntilDeadline, subSlot, maxBlocks: this.maxNumberOfBlocks },
268
268
  );
@@ -272,7 +272,7 @@ export class SequencerTimetable {
272
272
  }
273
273
 
274
274
  // No sub-slots available with enough time
275
- this.log.verbose(`No time left to start any more blocks`, {
275
+ this.log?.verbose(`No time left to start any more blocks`, {
276
276
  secondsIntoSlot,
277
277
  maxBlocks: this.maxNumberOfBlocks,
278
278
  initializationOffset: this.initializationOffset,
@@ -2,5 +2,5 @@ import type { L1RollupConstants } from '@aztec/stdlib/epoch-helpers';
2
2
 
3
3
  export type SequencerRollupConstants = Pick<
4
4
  L1RollupConstants,
5
- 'ethereumSlotDuration' | 'l1GenesisTime' | 'slotDuration'
5
+ 'ethereumSlotDuration' | 'l1GenesisTime' | 'slotDuration' | 'rollupManaLimit'
6
6
  >;
@@ -1,8 +1,8 @@
1
- import { type BlockNumber, CheckpointNumber } from '@aztec/foundation/branded-types';
1
+ import { type BlockNumber, CheckpointNumber, IndexWithinCheckpoint } from '@aztec/foundation/branded-types';
2
2
  import { Fr } from '@aztec/foundation/curves/bn254';
3
+ import { unfreeze } from '@aztec/foundation/types';
3
4
  import { L2Block } from '@aztec/stdlib/block';
4
5
  import { Checkpoint } from '@aztec/stdlib/checkpoint';
5
- import { Gas } from '@aztec/stdlib/gas';
6
6
  import type {
7
7
  FullNodeBlockBuilderConfig,
8
8
  ICheckpointBlockBuilder,
@@ -32,7 +32,7 @@ export class MockCheckpointBuilder implements ICheckpointBlockBuilder {
32
32
  public buildBlockCalls: Array<{
33
33
  blockNumber: BlockNumber;
34
34
  timestamp: bigint;
35
- opts: PublicProcessorLimits;
35
+ opts: PublicProcessorLimits & { minValidTxs?: number };
36
36
  }> = [];
37
37
  /** Track all consumed transaction hashes across buildBlock calls */
38
38
  public consumedTxHashes: Set<string> = new Set();
@@ -74,7 +74,7 @@ export class MockCheckpointBuilder implements ICheckpointBlockBuilder {
74
74
  pendingTxs: Iterable<Tx> | AsyncIterable<Tx>,
75
75
  blockNumber: BlockNumber,
76
76
  timestamp: bigint,
77
- opts: PublicProcessorLimits,
77
+ opts: PublicProcessorLimits & { minValidTxs?: number },
78
78
  ): Promise<BuildBlockInCheckpointResult> {
79
79
  this.buildBlockCalls.push({ blockNumber, timestamp, opts });
80
80
 
@@ -86,8 +86,10 @@ export class MockCheckpointBuilder implements ICheckpointBlockBuilder {
86
86
  let usedTxs: Tx[];
87
87
 
88
88
  if (this.blockProvider) {
89
- // Dynamic mode: get block from provider
90
- block = this.blockProvider();
89
+ // Dynamic mode: get block from provider, cloning to avoid shared references across multiple buildBlock calls
90
+ block = L2Block.fromBuffer(this.blockProvider().toBuffer());
91
+ block.header.globalVariables.blockNumber = blockNumber;
92
+ await block.header.recomputeHash();
91
93
  usedTxs = [];
92
94
  this.builtBlocks.push(block);
93
95
  } else {
@@ -113,81 +115,79 @@ export class MockCheckpointBuilder implements ICheckpointBlockBuilder {
113
115
 
114
116
  return {
115
117
  block,
116
- publicGas: Gas.empty(),
117
118
  publicProcessorDuration: 0,
118
119
  numTxs: block?.body?.txEffects?.length ?? usedTxs.length,
119
120
  usedTxs,
120
121
  failedTxs: [],
121
- usedTxBlobFields: block?.body?.txEffects?.reduce((sum, tx) => sum + tx.getNumBlobFields(), 0) ?? 0,
122
122
  };
123
123
  }
124
124
 
125
125
  completeCheckpoint(): Promise<Checkpoint> {
126
126
  this.completeCheckpointCalled = true;
127
127
  const allBlocks = this.blockProvider ? this.builtBlocks : this.blocks;
128
- const lastBlock = allBlocks[allBlocks.length - 1];
129
- // Create a CheckpointHeader from the last block's header for testing
130
- const checkpointHeader = this.createCheckpointHeader(lastBlock);
131
- return Promise.resolve(
132
- new Checkpoint(
133
- makeAppendOnlyTreeSnapshot(lastBlock.header.globalVariables.blockNumber + 1),
134
- checkpointHeader,
135
- allBlocks,
136
- this.checkpointNumber,
137
- ),
138
- );
128
+ return this.buildCheckpoint(allBlocks);
139
129
  }
140
130
 
141
131
  getCheckpoint(): Promise<Checkpoint> {
142
132
  this.getCheckpointCalled = true;
143
133
  const builtBlocks = this.blockProvider ? this.builtBlocks : this.blocks.slice(0, this.blockIndex);
144
- const lastBlock = builtBlocks[builtBlocks.length - 1];
145
- if (!lastBlock) {
134
+ if (builtBlocks.length === 0) {
146
135
  throw new Error('No blocks built yet');
147
136
  }
148
- // Create a CheckpointHeader from the last block's header for testing
149
- const checkpointHeader = this.createCheckpointHeader(lastBlock);
150
- return Promise.resolve(
151
- new Checkpoint(
152
- makeAppendOnlyTreeSnapshot(lastBlock.header.globalVariables.blockNumber + 1),
153
- checkpointHeader,
154
- builtBlocks,
155
- this.checkpointNumber,
156
- ),
157
- );
137
+ return this.buildCheckpoint(builtBlocks);
158
138
  }
159
139
 
160
- /**
161
- * Creates a CheckpointHeader from a block's header for testing.
162
- * This is a simplified version that creates a minimal CheckpointHeader.
163
- */
164
- private createCheckpointHeader(block: L2Block): CheckpointHeader {
165
- const header = block.header;
166
- const gv = header.globalVariables;
167
- return CheckpointHeader.empty({
168
- lastArchiveRoot: header.lastArchive.root,
169
- blockHeadersHash: Fr.random(), // Use random for testing
140
+ /** Builds a structurally valid Checkpoint from a list of blocks, fixing up indexes and archive chaining. */
141
+ private async buildCheckpoint(blocks: L2Block[]): Promise<Checkpoint> {
142
+ // Fix up indexWithinCheckpoint and archive chaining so the checkpoint passes structural validation.
143
+ for (let i = 0; i < blocks.length; i++) {
144
+ blocks[i].indexWithinCheckpoint = IndexWithinCheckpoint(i);
145
+ if (i > 0) {
146
+ unfreeze(blocks[i].header).lastArchive = blocks[i - 1].archive;
147
+ await blocks[i].header.recomputeHash();
148
+ }
149
+ }
150
+
151
+ const firstBlock = blocks[0];
152
+ const lastBlock = blocks[blocks.length - 1];
153
+ const gv = firstBlock.header.globalVariables;
154
+
155
+ const checkpointHeader = CheckpointHeader.empty({
156
+ lastArchiveRoot: firstBlock.header.lastArchive.root,
157
+ blockHeadersHash: Fr.random(),
170
158
  slotNumber: gv.slotNumber,
171
159
  timestamp: gv.timestamp,
172
160
  coinbase: gv.coinbase,
173
161
  feeRecipient: gv.feeRecipient,
174
162
  gasFees: gv.gasFees,
175
- totalManaUsed: header.totalManaUsed,
163
+ totalManaUsed: lastBlock.header.totalManaUsed,
176
164
  });
165
+
166
+ return new Checkpoint(
167
+ makeAppendOnlyTreeSnapshot(lastBlock.header.globalVariables.blockNumber + 1),
168
+ checkpointHeader,
169
+ blocks,
170
+ this.checkpointNumber,
171
+ );
177
172
  }
178
173
 
179
- /** Reset for reuse in another test */
180
- reset(): void {
181
- this.blocks = [];
174
+ /** Resets per-checkpoint state (built blocks, consumed txs) while preserving config (blockProvider, seeded blocks). */
175
+ resetCheckpointState(): void {
182
176
  this.builtBlocks = [];
183
- this.usedTxsPerBlock = [];
184
177
  this.blockIndex = 0;
185
- this.buildBlockCalls = [];
186
178
  this.consumedTxHashes.clear();
187
179
  this.completeCheckpointCalled = false;
188
180
  this.getCheckpointCalled = false;
181
+ }
182
+
183
+ /** Reset for reuse in another test */
184
+ reset(): void {
185
+ this.blocks = [];
186
+ this.usedTxsPerBlock = [];
187
+ this.buildBlockCalls = [];
189
188
  this.errorOnBuild = undefined;
190
189
  this.blockProvider = undefined;
190
+ this.resetCheckpointState();
191
191
  }
192
192
  }
193
193
 
@@ -249,6 +249,7 @@ export class MockCheckpointsBuilder implements ICheckpointsBuilder {
249
249
  slotDuration: 24,
250
250
  l1ChainId: 1,
251
251
  rollupVersion: 1,
252
+ rollupManaLimit: 200_000_000,
252
253
  };
253
254
  }
254
255
 
@@ -275,6 +276,8 @@ export class MockCheckpointsBuilder implements ICheckpointsBuilder {
275
276
  if (!this.checkpointBuilder) {
276
277
  // Auto-create a builder if none was set
277
278
  this.checkpointBuilder = new MockCheckpointBuilder(constants, checkpointNumber);
279
+ } else {
280
+ this.checkpointBuilder.resetCheckpointState();
278
281
  }
279
282
 
280
283
  return Promise.resolve(this.checkpointBuilder);
@@ -301,6 +304,8 @@ export class MockCheckpointsBuilder implements ICheckpointsBuilder {
301
304
  if (!this.checkpointBuilder) {
302
305
  // Auto-create a builder if none was set
303
306
  this.checkpointBuilder = new MockCheckpointBuilder(constants, checkpointNumber);
307
+ } else {
308
+ this.checkpointBuilder.resetCheckpointState();
304
309
  }
305
310
 
306
311
  return Promise.resolve(this.checkpointBuilder);
@@ -1,11 +0,0 @@
1
- import { type Logger } from '@aztec/foundation/log';
2
- import type { L1TxFailedStore } from './failed_tx_store.js';
3
- /**
4
- * Creates an L1TxFailedStore from a config string.
5
- * Supports any backend that FileStore supports (GCS, S3, R2, local filesystem).
6
- * @param config - Config string (e.g., 'gs://bucket/path', 's3://bucket/path', 'file:///path'). If undefined, returns undefined.
7
- * @param logger - Optional logger.
8
- * @returns The store instance, or undefined if config is not provided.
9
- */
10
- export declare function createL1TxFailedStore(config: string | undefined, logger?: Logger): Promise<L1TxFailedStore | undefined>;
11
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmFjdG9yeS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL3B1Ymxpc2hlci9sMV90eF9mYWlsZWRfc3RvcmUvZmFjdG9yeS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsS0FBSyxNQUFNLEVBQWdCLE1BQU0sdUJBQXVCLENBQUM7QUFHbEUsT0FBTyxLQUFLLEVBQUUsZUFBZSxFQUFFLE1BQU0sc0JBQXNCLENBQUM7QUFHNUQ7Ozs7OztHQU1HO0FBQ0gsd0JBQXNCLHFCQUFxQixDQUN6QyxNQUFNLEVBQUUsTUFBTSxHQUFHLFNBQVMsRUFDMUIsTUFBTSxHQUFFLE1BQXFELEdBQzVELE9BQU8sQ0FBQyxlQUFlLEdBQUcsU0FBUyxDQUFDLENBZXRDIn0=