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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (77) hide show
  1. package/dest/client/sequencer-client.d.ts +12 -7
  2. package/dest/client/sequencer-client.d.ts.map +1 -1
  3. package/dest/client/sequencer-client.js +56 -17
  4. package/dest/config.d.ts +26 -7
  5. package/dest/config.d.ts.map +1 -1
  6. package/dest/config.js +47 -28
  7. package/dest/global_variable_builder/global_builder.d.ts +2 -4
  8. package/dest/global_variable_builder/global_builder.d.ts.map +1 -1
  9. package/dest/global_variable_builder/global_builder.js +5 -4
  10. package/dest/publisher/config.d.ts +35 -17
  11. package/dest/publisher/config.d.ts.map +1 -1
  12. package/dest/publisher/config.js +106 -42
  13. package/dest/publisher/index.d.ts +2 -1
  14. package/dest/publisher/index.d.ts.map +1 -1
  15. package/dest/publisher/l1_tx_failed_store/factory.d.ts +11 -0
  16. package/dest/publisher/l1_tx_failed_store/factory.d.ts.map +1 -0
  17. package/dest/publisher/l1_tx_failed_store/factory.js +22 -0
  18. package/dest/publisher/l1_tx_failed_store/failed_tx_store.d.ts +59 -0
  19. package/dest/publisher/l1_tx_failed_store/failed_tx_store.d.ts.map +1 -0
  20. package/dest/publisher/l1_tx_failed_store/failed_tx_store.js +1 -0
  21. package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.d.ts +15 -0
  22. package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.d.ts.map +1 -0
  23. package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.js +34 -0
  24. package/dest/publisher/l1_tx_failed_store/index.d.ts +4 -0
  25. package/dest/publisher/l1_tx_failed_store/index.d.ts.map +1 -0
  26. package/dest/publisher/l1_tx_failed_store/index.js +2 -0
  27. package/dest/publisher/sequencer-publisher-factory.d.ts +11 -3
  28. package/dest/publisher/sequencer-publisher-factory.d.ts.map +1 -1
  29. package/dest/publisher/sequencer-publisher-factory.js +27 -2
  30. package/dest/publisher/sequencer-publisher.d.ts +30 -9
  31. package/dest/publisher/sequencer-publisher.d.ts.map +1 -1
  32. package/dest/publisher/sequencer-publisher.js +323 -38
  33. package/dest/sequencer/checkpoint_proposal_job.d.ts +19 -7
  34. package/dest/sequencer/checkpoint_proposal_job.d.ts.map +1 -1
  35. package/dest/sequencer/checkpoint_proposal_job.js +259 -162
  36. package/dest/sequencer/events.d.ts +2 -1
  37. package/dest/sequencer/events.d.ts.map +1 -1
  38. package/dest/sequencer/metrics.d.ts +21 -5
  39. package/dest/sequencer/metrics.d.ts.map +1 -1
  40. package/dest/sequencer/metrics.js +97 -15
  41. package/dest/sequencer/sequencer.d.ts +30 -15
  42. package/dest/sequencer/sequencer.d.ts.map +1 -1
  43. package/dest/sequencer/sequencer.js +93 -80
  44. package/dest/sequencer/timetable.d.ts +4 -6
  45. package/dest/sequencer/timetable.d.ts.map +1 -1
  46. package/dest/sequencer/timetable.js +7 -11
  47. package/dest/sequencer/types.d.ts +2 -2
  48. package/dest/sequencer/types.d.ts.map +1 -1
  49. package/dest/test/index.d.ts +3 -5
  50. package/dest/test/index.d.ts.map +1 -1
  51. package/dest/test/mock_checkpoint_builder.d.ts +11 -11
  52. package/dest/test/mock_checkpoint_builder.d.ts.map +1 -1
  53. package/dest/test/mock_checkpoint_builder.js +45 -34
  54. package/dest/test/utils.d.ts +3 -3
  55. package/dest/test/utils.d.ts.map +1 -1
  56. package/dest/test/utils.js +5 -4
  57. package/package.json +27 -28
  58. package/src/client/sequencer-client.ts +77 -18
  59. package/src/config.ts +65 -38
  60. package/src/global_variable_builder/global_builder.ts +4 -3
  61. package/src/publisher/config.ts +121 -43
  62. package/src/publisher/index.ts +3 -0
  63. package/src/publisher/l1_tx_failed_store/factory.ts +32 -0
  64. package/src/publisher/l1_tx_failed_store/failed_tx_store.ts +55 -0
  65. package/src/publisher/l1_tx_failed_store/file_store_failed_tx_store.ts +46 -0
  66. package/src/publisher/l1_tx_failed_store/index.ts +3 -0
  67. package/src/publisher/sequencer-publisher-factory.ts +38 -6
  68. package/src/publisher/sequencer-publisher.ts +327 -52
  69. package/src/sequencer/checkpoint_proposal_job.ts +348 -173
  70. package/src/sequencer/events.ts +1 -1
  71. package/src/sequencer/metrics.ts +106 -18
  72. package/src/sequencer/sequencer.ts +129 -92
  73. package/src/sequencer/timetable.ts +13 -12
  74. package/src/sequencer/types.ts +1 -1
  75. package/src/test/index.ts +2 -4
  76. package/src/test/mock_checkpoint_builder.ts +63 -49
  77. package/src/test/utils.ts +5 -2
@@ -436,22 +436,21 @@ function _apply_decs_2203_r(targetClass, memberDecs, classDecs, parentClass) {
436
436
  return (_apply_decs_2203_r = applyDecs2203RFactory())(targetClass, memberDecs, classDecs, parentClass);
437
437
  }
438
438
  var _dec, _dec1, _dec2, _dec3, _dec4, _dec5, _dec6, _dec7, _initProto;
439
- import { NUM_CHECKPOINT_END_MARKER_FIELDS, getNumBlockEndBlobFields } from '@aztec/blob-lib/encoding';
440
- import { BLOBS_PER_CHECKPOINT, FIELDS_PER_BLOB } from '@aztec/constants';
441
439
  import { BlockNumber, IndexWithinCheckpoint } from '@aztec/foundation/branded-types';
442
440
  import { randomInt } from '@aztec/foundation/crypto/random';
443
- import { Signature } from '@aztec/foundation/eth-signature';
441
+ import { flipSignature, generateRecoverableSignature, generateUnrecoverableSignature } from '@aztec/foundation/crypto/secp256k1-signer';
444
442
  import { filter } from '@aztec/foundation/iterator';
445
443
  import { createLogger } from '@aztec/foundation/log';
446
444
  import { sleep, sleepUntil } from '@aztec/foundation/sleep';
447
445
  import { Timer } from '@aztec/foundation/timer';
448
446
  import { isErrorClass, unfreeze } from '@aztec/foundation/types';
449
447
  import { CommitteeAttestationsAndSigners, MaliciousCommitteeAttestationsAndSigners } from '@aztec/stdlib/block';
450
- import { getSlotStartBuildTimestamp } from '@aztec/stdlib/epoch-helpers';
448
+ import { validateCheckpoint } from '@aztec/stdlib/checkpoint';
449
+ import { getSlotStartBuildTimestamp, getTimestampForSlot } from '@aztec/stdlib/epoch-helpers';
451
450
  import { Gas } from '@aztec/stdlib/gas';
452
- import { NoValidTxsError } from '@aztec/stdlib/interfaces/server';
451
+ import { InsufficientValidTxsError } from '@aztec/stdlib/interfaces/server';
453
452
  import { computeInHashFromL1ToL2Messages } from '@aztec/stdlib/messaging';
454
- import { orderAttestations } from '@aztec/stdlib/p2p';
453
+ import { orderAttestations, trimAttestations } from '@aztec/stdlib/p2p';
455
454
  import { AttestationTimeoutError } from '@aztec/stdlib/validators';
456
455
  import { Attributes, trackSpan } from '@aztec/telemetry-client';
457
456
  import { DutyAlreadySignedError, SlashingProtectionError } from '@aztec/validator-ha-signer/errors';
@@ -463,7 +462,7 @@ _dec = trackSpan('CheckpointProposalJob.execute'), _dec1 = trackSpan('Checkpoint
463
462
  return {
464
463
  // nullish operator needed for tests
465
464
  [Attributes.COINBASE]: this.validatorClient.getCoinbaseForAttestor(this.attestorAddress)?.toString(),
466
- [Attributes.SLOT_NUMBER]: this.slot
465
+ [Attributes.SLOT_NUMBER]: this.targetSlot
467
466
  };
468
467
  }), _dec2 = trackSpan('CheckpointProposalJob.buildBlocksForCheckpoint'), _dec3 = trackSpan('CheckpointProposalJob.waitUntilNextSubslot'), _dec4 = trackSpan('CheckpointProposalJob.buildSingleBlock'), _dec5 = trackSpan('CheckpointProposalJob.waitForMinTxs'), _dec6 = trackSpan('CheckpointProposalJob.waitForAttestations'), _dec7 = trackSpan('CheckpointProposalJob.waitUntilTimeInSlot');
469
468
  /**
@@ -472,8 +471,10 @@ _dec = trackSpan('CheckpointProposalJob.execute'), _dec1 = trackSpan('Checkpoint
472
471
  * as well as enqueueing votes for slashing and governance proposals. This class is created from
473
472
  * the Sequencer once the check for being the proposer for the slot has succeeded.
474
473
  */ export class CheckpointProposalJob {
475
- epoch;
476
- slot;
474
+ slotNow;
475
+ targetSlot;
476
+ epochNow;
477
+ targetEpoch;
477
478
  checkpointNumber;
478
479
  syncedToBlockNumber;
479
480
  proposer;
@@ -543,10 +544,12 @@ _dec = trackSpan('CheckpointProposalJob.execute'), _dec1 = trackSpan('Checkpoint
543
544
  ], []));
544
545
  }
545
546
  log;
546
- constructor(epoch, slot, checkpointNumber, syncedToBlockNumber, // TODO(palla/mbps): Can we remove the proposer in favor of attestorAddress? Need to check fisherman-node flows.
547
+ constructor(slotNow, targetSlot, epochNow, targetEpoch, checkpointNumber, syncedToBlockNumber, // TODO(palla/mbps): Can we remove the proposer in favor of attestorAddress? Need to check fisherman-node flows.
547
548
  proposer, publisher, attestorAddress, invalidateCheckpoint, validatorClient, globalsBuilder, p2pClient, worldState, l1ToL2MessageSource, l2BlockSource, checkpointsBuilder, blockSink, l1Constants, config, timetable, slasherClient, epochCache, dateProvider, metrics, eventEmitter, setStateFn, tracer, bindings){
548
- this.epoch = epoch;
549
- this.slot = slot;
549
+ this.slotNow = slotNow;
550
+ this.targetSlot = targetSlot;
551
+ this.epochNow = epochNow;
552
+ this.targetEpoch = targetEpoch;
550
553
  this.checkpointNumber = checkpointNumber;
551
554
  this.syncedToBlockNumber = syncedToBlockNumber;
552
555
  this.proposer = proposer;
@@ -574,9 +577,15 @@ _dec = trackSpan('CheckpointProposalJob.execute'), _dec1 = trackSpan('Checkpoint
574
577
  _initProto(this);
575
578
  this.log = createLogger('sequencer:checkpoint-proposal', {
576
579
  ...bindings,
577
- instanceId: `slot-${slot}`
580
+ instanceId: `slot-${this.slotNow}`
578
581
  });
579
582
  }
583
+ /** The wall-clock slot during which the proposer builds. */ get slot() {
584
+ return this.slotNow;
585
+ }
586
+ /** The wall-clock epoch. */ get epoch() {
587
+ return this.epochNow;
588
+ }
580
589
  /**
581
590
  * Executes the checkpoint proposal job.
582
591
  * Returns the published checkpoint if successful, undefined otherwise.
@@ -584,19 +593,37 @@ _dec = trackSpan('CheckpointProposalJob.execute'), _dec1 = trackSpan('Checkpoint
584
593
  // Enqueue governance and slashing votes (returns promises that will be awaited later)
585
594
  // In fisherman mode, we simulate slashing but don't actually publish to L1
586
595
  // These are constant for the whole slot, so we only enqueue them once
587
- const votesPromises = new CheckpointVoter(this.slot, this.publisher, this.attestorAddress, this.validatorClient, this.slasherClient, this.l1Constants, this.config, this.metrics, this.log).enqueueVotes();
596
+ const votesPromises = new CheckpointVoter(this.targetSlot, this.publisher, this.attestorAddress, this.validatorClient, this.slasherClient, this.l1Constants, this.config, this.metrics, this.log).enqueueVotes();
588
597
  // Build and propose the checkpoint. This will enqueue the request on the publisher if a checkpoint is built.
589
598
  const checkpoint = await this.proposeCheckpoint();
590
599
  // Wait until the voting promises have resolved, so all requests are enqueued (not sent)
591
600
  await Promise.all(votesPromises);
592
601
  if (checkpoint) {
593
- this.metrics.recordBlockProposalSuccess();
602
+ this.metrics.recordCheckpointProposalSuccess();
594
603
  }
595
604
  // Do not post anything to L1 if we are fishermen, but do perform L1 fee analysis
596
605
  if (this.config.fishermanMode) {
597
606
  await this.handleCheckpointEndAsFisherman(checkpoint);
598
607
  return;
599
608
  }
609
+ // If pipelining, wait until the submission slot so L1 recognizes the pipelined proposer
610
+ if (this.epochCache.isProposerPipeliningEnabled()) {
611
+ const submissionSlotTimestamp = getTimestampForSlot(this.targetSlot, this.l1Constants) - BigInt(this.l1Constants.ethereumSlotDuration);
612
+ this.log.info(`Waiting until submission slot ${this.targetSlot} for L1 submission`, {
613
+ slot: this.slot,
614
+ submissionSlot: this.targetSlot,
615
+ submissionSlotTimestamp
616
+ });
617
+ await sleepUntil(new Date(Number(submissionSlotTimestamp) * 1000), this.dateProvider.nowAsDate());
618
+ // After waking, verify the parent checkpoint wasn't pruned during the sleep.
619
+ // We check L1's pending tip directly instead of canProposeAt, which also validates the proposer
620
+ // identity and would fail because the timestamp resolves to a different slot's proposer.
621
+ const l1Tips = await this.publisher.rollupContract.getTips();
622
+ if (l1Tips.pending < this.checkpointNumber - 1) {
623
+ this.log.warn(`Parent checkpoint was pruned during pipelining sleep (L1 pending=${l1Tips.pending}, expected>=${this.checkpointNumber - 1}), skipping L1 submission for checkpoint ${this.checkpointNumber}`);
624
+ return undefined;
625
+ }
626
+ }
600
627
  // Then send everything to L1
601
628
  const l1Response = await this.publisher.sendRequests();
602
629
  const proposedAction = l1Response?.successfulActions.find((a)=>a === 'propose');
@@ -628,25 +655,33 @@ _dec = trackSpan('CheckpointProposalJob.execute'), _dec1 = trackSpan('Checkpoint
628
655
  const coinbase = this.validatorClient.getCoinbaseForAttestor(this.attestorAddress);
629
656
  const feeRecipient = this.validatorClient.getFeeRecipientForAttestor(this.attestorAddress);
630
657
  // Start the checkpoint
631
- this.setStateFn(SequencerState.INITIALIZING_CHECKPOINT, this.slot);
632
- this.metrics.incOpenSlot(this.slot, this.proposer?.toString() ?? 'unknown');
658
+ this.setStateFn(SequencerState.INITIALIZING_CHECKPOINT, this.targetSlot);
659
+ this.log.info(`Starting checkpoint proposal`, {
660
+ buildSlot: this.slot,
661
+ submissionSlot: this.targetSlot,
662
+ pipelining: this.epochCache.isProposerPipeliningEnabled(),
663
+ proposer: this.proposer?.toString(),
664
+ coinbase: coinbase.toString()
665
+ });
666
+ this.metrics.incOpenSlot(this.targetSlot, this.proposer?.toString() ?? 'unknown');
633
667
  // Enqueues checkpoint invalidation (constant for the whole slot)
634
668
  if (this.invalidateCheckpoint && !this.config.skipInvalidateBlockAsProposer) {
635
669
  this.publisher.enqueueInvalidateCheckpoint(this.invalidateCheckpoint);
636
670
  }
637
671
  // Create checkpoint builder for the slot
638
- const checkpointGlobalVariables = await this.globalsBuilder.buildCheckpointGlobalVariables(coinbase, feeRecipient, this.slot);
672
+ const checkpointGlobalVariables = await this.globalsBuilder.buildCheckpointGlobalVariables(coinbase, feeRecipient, this.targetSlot);
639
673
  // Collect L1 to L2 messages for the checkpoint and compute their hash
640
674
  const l1ToL2Messages = await this.l1ToL2MessageSource.getL1ToL2Messages(this.checkpointNumber);
641
675
  const inHash = computeInHashFromL1ToL2Messages(l1ToL2Messages);
642
676
  // Collect the out hashes of all the checkpoints before this one in the same epoch
643
- const previousCheckpoints = (await this.l2BlockSource.getCheckpointsForEpoch(this.epoch)).filter((c)=>c.number < this.checkpointNumber);
644
- const previousCheckpointOutHashes = previousCheckpoints.map((c)=>c.getCheckpointOutHash());
677
+ const previousCheckpointOutHashes = (await this.l2BlockSource.getCheckpointsDataForEpoch(this.targetEpoch)).filter((c)=>c.checkpointNumber < this.checkpointNumber).map((c)=>c.checkpointOutHash);
678
+ // Get the fee asset price modifier from the oracle
679
+ const feeAssetPriceModifier = await this.publisher.getFeeAssetPriceModifier();
645
680
  const fork = _ts_add_disposable_resource(env, await this.worldState.fork(this.syncedToBlockNumber, {
646
681
  closeDelayMs: 12_000
647
- }), false);
682
+ }), true);
648
683
  // Create checkpoint builder for the entire slot
649
- const checkpointBuilder = await this.checkpointsBuilder.startCheckpoint(this.checkpointNumber, checkpointGlobalVariables, l1ToL2Messages, previousCheckpointOutHashes, fork, this.log.getBindings());
684
+ const checkpointBuilder = await this.checkpointsBuilder.startCheckpoint(this.checkpointNumber, checkpointGlobalVariables, feeAssetPriceModifier, l1ToL2Messages, previousCheckpointOutHashes, fork, this.log.getBindings());
650
685
  // Options for the validator client when creating block and checkpoint proposals
651
686
  const blockProposalOptions = {
652
687
  publishFullTxs: !!this.config.publishTxsWithProposals,
@@ -658,6 +693,7 @@ _dec = trackSpan('CheckpointProposalJob.execute'), _dec1 = trackSpan('Checkpoint
658
693
  };
659
694
  let blocksInCheckpoint = [];
660
695
  let blockPendingBroadcast = undefined;
696
+ const checkpointBuildTimer = new Timer();
661
697
  try {
662
698
  // Main loop: build blocks for the checkpoint
663
699
  const result = await this.buildBlocksForCheckpoint(checkpointBuilder, checkpointGlobalVariables.timestamp, inHash, blockProposalOptions);
@@ -667,40 +703,55 @@ _dec = trackSpan('CheckpointProposalJob.execute'), _dec1 = trackSpan('Checkpoint
667
703
  // These errors are expected in HA mode, so we yield and let another HA node handle the slot
668
704
  // The only distinction between the 2 errors is SlashingProtectionError throws when the payload is different,
669
705
  // which is normal for block building (may have picked different txs)
670
- if (err instanceof DutyAlreadySignedError) {
671
- this.log.info(`Checkpoint proposal for slot ${this.slot} already signed by another HA node, yielding`, {
672
- slot: this.slot,
673
- signedByNode: err.signedByNode
674
- });
675
- return undefined;
676
- }
677
- if (err instanceof SlashingProtectionError) {
678
- this.log.info(`Checkpoint proposal for slot ${this.slot} blocked by slashing protection, yielding`, {
679
- slot: this.slot,
680
- existingMessageHash: err.existingMessageHash,
681
- attemptedMessageHash: err.attemptedMessageHash
682
- });
706
+ if (this.handleHASigningError(err, 'Block proposal')) {
683
707
  return undefined;
684
708
  }
685
709
  throw err;
686
710
  }
687
711
  if (blocksInCheckpoint.length === 0) {
688
- this.log.warn(`No blocks were built for slot ${this.slot}`, {
689
- slot: this.slot
712
+ this.log.warn(`No blocks were built for slot ${this.targetSlot}`, {
713
+ slot: this.targetSlot
690
714
  });
691
715
  this.eventEmitter.emit('checkpoint-empty', {
692
- slot: this.slot
716
+ slot: this.targetSlot
717
+ });
718
+ return undefined;
719
+ }
720
+ const minBlocksForCheckpoint = this.config.minBlocksForCheckpoint;
721
+ if (minBlocksForCheckpoint !== undefined && blocksInCheckpoint.length < minBlocksForCheckpoint) {
722
+ this.log.warn(`Checkpoint has fewer blocks than minimum (${blocksInCheckpoint.length} < ${minBlocksForCheckpoint}), skipping proposal`, {
723
+ slot: this.targetSlot,
724
+ blocksBuilt: blocksInCheckpoint.length,
725
+ minBlocksForCheckpoint
693
726
  });
694
727
  return undefined;
695
728
  }
696
729
  // Assemble and broadcast the checkpoint proposal, including the last block that was not
697
730
  // broadcasted yet, and wait to collect the committee attestations.
698
- this.setStateFn(SequencerState.ASSEMBLING_CHECKPOINT, this.slot);
731
+ this.setStateFn(SequencerState.ASSEMBLING_CHECKPOINT, this.targetSlot);
699
732
  const checkpoint = await checkpointBuilder.completeCheckpoint();
733
+ // Final validation: per-block limits are only checked if the operator set them explicitly.
734
+ // Otherwise, checkpoint-level budgets were already enforced by the redistribution logic.
735
+ try {
736
+ validateCheckpoint(checkpoint, {
737
+ rollupManaLimit: this.l1Constants.rollupManaLimit,
738
+ maxL2BlockGas: this.config.maxL2BlockGas,
739
+ maxDABlockGas: this.config.maxDABlockGas,
740
+ maxTxsPerBlock: this.config.maxTxsPerBlock,
741
+ maxTxsPerCheckpoint: this.config.maxTxsPerCheckpoint
742
+ });
743
+ } catch (err) {
744
+ this.log.error(`Built an invalid checkpoint at slot ${this.slot} (skipping proposal)`, err, {
745
+ checkpoint: checkpoint.header.toInspect()
746
+ });
747
+ return undefined;
748
+ }
749
+ // Record checkpoint-level build metrics
750
+ this.metrics.recordCheckpointBuild(checkpointBuildTimer.ms(), blocksInCheckpoint.length, checkpoint.getStats().txCount, Number(checkpoint.header.totalManaUsed.toBigInt()));
700
751
  // Do not collect attestations nor publish to L1 in fisherman mode
701
752
  if (this.config.fishermanMode) {
702
- this.log.info(`Built checkpoint for slot ${this.slot} with ${blocksInCheckpoint.length} blocks. ` + `Skipping proposal in fisherman mode.`, {
703
- slot: this.slot,
753
+ this.log.info(`Built checkpoint for slot ${this.targetSlot} with ${blocksInCheckpoint.length} blocks. ` + `Skipping proposal in fisherman mode.`, {
754
+ slot: this.targetSlot,
704
755
  checkpoint: checkpoint.header.toInspect(),
705
756
  blocksBuilt: blocksInCheckpoint.length
706
757
  });
@@ -714,10 +765,10 @@ _dec = trackSpan('CheckpointProposalJob.execute'), _dec1 = trackSpan('Checkpoint
714
765
  txs: blockPendingBroadcast.txs
715
766
  };
716
767
  // Create the checkpoint proposal and broadcast it
717
- const proposal = await this.validatorClient.createCheckpointProposal(checkpoint.header, checkpoint.archive.root, lastBlock, this.proposer, checkpointProposalOptions);
768
+ const proposal = await this.validatorClient.createCheckpointProposal(checkpoint.header, checkpoint.archive.root, feeAssetPriceModifier, lastBlock, this.proposer, checkpointProposalOptions);
718
769
  const blockProposedAt = this.dateProvider.now();
719
770
  await this.p2pClient.broadcastCheckpointProposal(proposal);
720
- this.setStateFn(SequencerState.COLLECTING_ATTESTATIONS, this.slot);
771
+ this.setStateFn(SequencerState.COLLECTING_ATTESTATIONS, this.targetSlot);
721
772
  const attestations = await this.waitForAttestations(proposal);
722
773
  const blockAttestedAt = this.dateProvider.now();
723
774
  this.metrics.recordCheckpointAttestationDelay(blockAttestedAt - blockProposedAt);
@@ -725,32 +776,28 @@ _dec = trackSpan('CheckpointProposalJob.execute'), _dec1 = trackSpan('Checkpoint
725
776
  const signer = this.proposer ?? this.publisher.getSenderAddress();
726
777
  let attestationsSignature;
727
778
  try {
728
- attestationsSignature = await this.validatorClient.signAttestationsAndSigners(attestations, signer, this.slot, this.checkpointNumber);
779
+ attestationsSignature = await this.validatorClient.signAttestationsAndSigners(attestations, signer, this.targetSlot, this.checkpointNumber);
729
780
  } catch (err) {
730
781
  // We shouldn't really get here since we yield to another HA node
731
- // as soon as we see these errors when creating block proposals.
732
- if (err instanceof DutyAlreadySignedError) {
733
- this.log.info(`Attestations signature for slot ${this.slot} already signed by another HA node, yielding`, {
734
- slot: this.slot,
735
- signedByNode: err.signedByNode
736
- });
737
- return undefined;
738
- }
739
- if (err instanceof SlashingProtectionError) {
740
- this.log.info(`Attestations signature for slot ${this.slot} blocked by slashing protection, yielding`, {
741
- slot: this.slot,
742
- existingMessageHash: err.existingMessageHash,
743
- attemptedMessageHash: err.attemptedMessageHash
744
- });
782
+ // as soon as we see these errors when creating block or checkpoint proposals.
783
+ if (this.handleHASigningError(err, 'Attestations signature')) {
745
784
  return undefined;
746
785
  }
747
786
  throw err;
748
787
  }
749
788
  // Enqueue publishing the checkpoint to L1
750
- this.setStateFn(SequencerState.PUBLISHING_CHECKPOINT, this.slot);
789
+ this.setStateFn(SequencerState.PUBLISHING_CHECKPOINT, this.targetSlot);
751
790
  const aztecSlotDuration = this.l1Constants.slotDuration;
752
- const slotStartBuildTimestamp = this.getSlotStartBuildTimestamp();
753
- const txTimeoutAt = new Date((slotStartBuildTimestamp + aztecSlotDuration) * 1000);
791
+ const submissionSlotStart = Number(getTimestampForSlot(this.targetSlot, this.l1Constants));
792
+ const txTimeoutAt = new Date((submissionSlotStart + aztecSlotDuration) * 1000);
793
+ // If we have been configured to potentially skip publishing checkpoint then roll the dice here
794
+ if (this.config.skipPublishingCheckpointsPercent !== undefined && this.config.skipPublishingCheckpointsPercent > 0) {
795
+ const result = Math.max(0, randomInt(100));
796
+ if (result < this.config.skipPublishingCheckpointsPercent) {
797
+ this.log.warn(`Skipping publishing proposal for checkpoint ${checkpoint.number}. Configured percentage: ${this.config.skipPublishingCheckpointsPercent}, generated value: ${result}`);
798
+ return checkpoint;
799
+ }
800
+ }
754
801
  await this.publisher.enqueueProposeCheckpoint(checkpoint, attestations, attestationsSignature, {
755
802
  txTimeoutAt,
756
803
  forcePendingCheckpointNumber: this.invalidateCheckpoint?.forcePendingCheckpointNumber
@@ -760,7 +807,8 @@ _dec = trackSpan('CheckpointProposalJob.execute'), _dec1 = trackSpan('Checkpoint
760
807
  env.error = e;
761
808
  env.hasError = true;
762
809
  } finally{
763
- _ts_dispose_resources(env);
810
+ const result = _ts_dispose_resources(env);
811
+ if (result) await result;
764
812
  }
765
813
  } catch (err) {
766
814
  if (err && (err instanceof DutyAlreadySignedError || err instanceof SlashingProtectionError)) {
@@ -777,8 +825,6 @@ _dec = trackSpan('CheckpointProposalJob.execute'), _dec1 = trackSpan('Checkpoint
777
825
  const blocksInCheckpoint = [];
778
826
  const txHashesAlreadyIncluded = new Set();
779
827
  const initialBlockNumber = BlockNumber(this.syncedToBlockNumber + 1);
780
- // Remaining blob fields available for blocks (checkpoint end marker already subtracted)
781
- let remainingBlobFields = BLOBS_PER_CHECKPOINT * FIELDS_PER_BLOB - NUM_CHECKPOINT_END_MARKER_FIELDS;
782
828
  // Last block in the checkpoint will usually be flagged as pending broadcast, so we send it along with the checkpoint proposal
783
829
  let blockPendingBroadcast = undefined;
784
830
  while(true){
@@ -789,7 +835,7 @@ _dec = trackSpan('CheckpointProposalJob.execute'), _dec1 = trackSpan('Checkpoint
789
835
  const timingInfo = this.timetable.canStartNextBlock(secondsIntoSlot);
790
836
  if (!timingInfo.canStart) {
791
837
  this.log.debug(`Not enough time left in slot to start another block`, {
792
- slot: this.slot,
838
+ slot: this.targetSlot,
793
839
  blocksBuilt,
794
840
  secondsIntoSlot
795
841
  });
@@ -804,8 +850,7 @@ _dec = trackSpan('CheckpointProposalJob.execute'), _dec1 = trackSpan('Checkpoint
804
850
  buildDeadline: timingInfo.deadline ? new Date((this.getSlotStartBuildTimestamp() + timingInfo.deadline) * 1000) : undefined,
805
851
  blockNumber,
806
852
  indexWithinCheckpoint,
807
- txHashesAlreadyIncluded,
808
- remainingBlobFields
853
+ txHashesAlreadyIncluded
809
854
  });
810
855
  // TODO(palla/mbps): Review these conditions. We may want to keep trying in some scenarios.
811
856
  if (!buildResult && timingInfo.isLastBlock) {
@@ -819,33 +864,23 @@ _dec = trackSpan('CheckpointProposalJob.execute'), _dec1 = trackSpan('Checkpoint
819
864
  } else if ('error' in buildResult) {
820
865
  // If there was an error building the block, just exit the loop and give up the rest of the slot
821
866
  if (!(buildResult.error instanceof SequencerInterruptedError)) {
822
- this.log.warn(`Halting block building for slot ${this.slot}`, {
823
- slot: this.slot,
867
+ this.log.warn(`Halting block building for slot ${this.targetSlot}`, {
868
+ slot: this.targetSlot,
824
869
  blocksBuilt,
825
870
  error: buildResult.error
826
871
  });
827
872
  }
828
873
  break;
829
874
  }
830
- const { block, usedTxs, remainingBlobFields: newRemainingBlobFields } = buildResult;
875
+ const { block, usedTxs } = buildResult;
831
876
  blocksInCheckpoint.push(block);
832
- // Update remaining blob fields for the next block
833
- remainingBlobFields = newRemainingBlobFields;
834
- // Sync the proposed block to the archiver to make it available
835
- // Note that the checkpoint builder uses its own fork so it should not need to wait for this syncing
836
- // Eventually we should refactor the checkpoint builder to not need a separate long-lived fork
837
- // Fire and forget - don't block the critical path, but log errors
838
- this.syncProposedBlockToArchiver(block).catch((err)=>{
839
- this.log.error(`Failed to sync proposed block ${block.number} to archiver`, {
840
- blockNumber: block.number,
841
- err
842
- });
843
- });
844
877
  usedTxs.forEach((tx)=>txHashesAlreadyIncluded.add(tx.txHash.toString()));
845
- // If this is the last block, exit the loop now so we start collecting attestations
878
+ // If this is the last block, sync it to the archiver and exit the loop
879
+ // so we can build the checkpoint and start collecting attestations.
846
880
  if (timingInfo.isLastBlock) {
847
- this.log.verbose(`Completed final block ${blockNumber} for slot ${this.slot}`, {
848
- slot: this.slot,
881
+ await this.syncProposedBlockToArchiver(block);
882
+ this.log.verbose(`Completed final block ${blockNumber} for slot ${this.targetSlot}`, {
883
+ slot: this.targetSlot,
849
884
  blockNumber,
850
885
  blocksBuilt
851
886
  });
@@ -855,17 +890,22 @@ _dec = trackSpan('CheckpointProposalJob.execute'), _dec1 = trackSpan('Checkpoint
855
890
  };
856
891
  break;
857
892
  }
858
- // For non-last blocks, broadcast the block proposal (unless we're in fisherman mode)
859
- // If the block is the last one, we'll broadcast it along with the checkpoint at the end of the loop
860
- if (!this.config.fishermanMode) {
861
- const proposal = await this.validatorClient.createBlockProposal(block.header, block.indexWithinCheckpoint, inHash, block.archive.root, usedTxs, this.proposer, blockProposalOptions);
862
- await this.p2pClient.broadcastProposal(proposal);
863
- }
893
+ // Broadcast the block proposal (unless we're in fisherman mode) unless the block is the last one,
894
+ // in which case we'll broadcast it along with the checkpoint at the end of the loop.
895
+ // Note that we only send the block to the archiver if we manage to create the proposal, so if there's
896
+ // a HA error we don't pollute our archiver with a block that won't make it to the chain.
897
+ const proposal = await this.createBlockProposal(block, inHash, usedTxs, blockProposalOptions);
898
+ // Sync the proposed block to the archiver to make it available, only after we've managed to sign the proposal.
899
+ // We wait for the sync to succeed, as this helps catch consistency errors, even if it means we lose some time for block-building.
900
+ // If this throws, we abort the entire checkpoint.
901
+ await this.syncProposedBlockToArchiver(block);
902
+ // Once we have a signed proposal and the archiver agreed with our proposed block, then we broadcast it.
903
+ proposal && await this.p2pClient.broadcastProposal(proposal);
864
904
  // Wait until the next block's start time
865
905
  await this.waitUntilNextSubslot(timingInfo.deadline);
866
906
  }
867
- this.log.verbose(`Block building loop completed for slot ${this.slot}`, {
868
- slot: this.slot,
907
+ this.log.verbose(`Block building loop completed for slot ${this.targetSlot}`, {
908
+ slot: this.targetSlot,
869
909
  blocksBuilt: blocksInCheckpoint.length
870
910
  });
871
911
  return {
@@ -873,82 +913,88 @@ _dec = trackSpan('CheckpointProposalJob.execute'), _dec1 = trackSpan('Checkpoint
873
913
  blockPendingBroadcast
874
914
  };
875
915
  }
916
+ /** Creates a block proposal for a given block via the validator client (unless in fisherman mode) */ createBlockProposal(block, inHash, usedTxs, blockProposalOptions) {
917
+ if (this.config.fishermanMode) {
918
+ this.log.info(`Skipping block proposal for block ${block.number} in fisherman mode`);
919
+ return Promise.resolve(undefined);
920
+ }
921
+ return this.validatorClient.createBlockProposal(block.header, block.indexWithinCheckpoint, inHash, block.archive.root, usedTxs, this.proposer, blockProposalOptions);
922
+ }
876
923
  /** Sleeps until it is time to produce the next block in the slot */ async waitUntilNextSubslot(nextSubslotStart) {
877
- this.setStateFn(SequencerState.WAITING_UNTIL_NEXT_BLOCK, this.slot);
924
+ this.setStateFn(SequencerState.WAITING_UNTIL_NEXT_BLOCK, this.targetSlot);
878
925
  this.log.verbose(`Waiting until time for the next block at ${nextSubslotStart}s into slot`, {
879
- slot: this.slot
926
+ slot: this.targetSlot
880
927
  });
881
928
  await this.waitUntilTimeInSlot(nextSubslotStart);
882
929
  }
883
930
  /** Builds a single block. Called from the main block building loop. */ async buildSingleBlock(checkpointBuilder, opts) {
884
- const { blockTimestamp, forceCreate, blockNumber, indexWithinCheckpoint, buildDeadline, txHashesAlreadyIncluded, remainingBlobFields } = opts;
885
- this.log.verbose(`Preparing block ${blockNumber} index ${indexWithinCheckpoint} at checkpoint ${this.checkpointNumber} for slot ${this.slot}`, {
931
+ const { blockTimestamp, forceCreate, blockNumber, indexWithinCheckpoint, buildDeadline, txHashesAlreadyIncluded } = opts;
932
+ this.log.verbose(`Preparing block ${blockNumber} index ${indexWithinCheckpoint} at checkpoint ${this.checkpointNumber} for slot ${this.targetSlot}`, {
886
933
  ...checkpointBuilder.getConstantData(),
887
934
  ...opts
888
935
  });
889
936
  try {
890
937
  // Wait until we have enough txs to build the block
891
- const minTxs = this.config.minTxsPerBlock;
892
- const { availableTxs, canStartBuilding } = await this.waitForMinTxs(opts);
938
+ const { availableTxs, canStartBuilding, minTxs } = await this.waitForMinTxs(opts);
893
939
  if (!canStartBuilding) {
894
- this.log.warn(`Not enough txs to build block ${blockNumber} at index ${indexWithinCheckpoint} in slot ${this.slot} (got ${availableTxs} txs but needs ${minTxs})`, {
940
+ this.log.warn(`Not enough txs to build block ${blockNumber} at index ${indexWithinCheckpoint} in slot ${this.targetSlot} (got ${availableTxs} txs but needs ${minTxs})`, {
895
941
  blockNumber,
896
- slot: this.slot,
942
+ slot: this.targetSlot,
897
943
  indexWithinCheckpoint
898
944
  });
899
945
  this.eventEmitter.emit('block-tx-count-check-failed', {
900
946
  minTxs,
901
947
  availableTxs,
902
- slot: this.slot
948
+ slot: this.targetSlot
903
949
  });
904
950
  this.metrics.recordBlockProposalFailed('insufficient_txs');
905
951
  return undefined;
906
952
  }
907
953
  // Create iterator to pending txs. We filter out txs already included in previous blocks in the checkpoint
908
954
  // just in case p2p failed to sync the provisional block and didn't get to remove those txs from the mempool yet.
909
- const pendingTxs = filter(this.p2pClient.iteratePendingTxs(), (tx)=>!txHashesAlreadyIncluded.has(tx.txHash.toString()));
910
- this.log.debug(`Building block ${blockNumber} at index ${indexWithinCheckpoint} for slot ${this.slot} with ${availableTxs} available txs`, {
911
- slot: this.slot,
955
+ const pendingTxs = filter(this.p2pClient.iterateEligiblePendingTxs(), (tx)=>!txHashesAlreadyIncluded.has(tx.txHash.toString()));
956
+ this.log.debug(`Building block ${blockNumber} at index ${indexWithinCheckpoint} for slot ${this.targetSlot} with ${availableTxs} available txs`, {
957
+ slot: this.targetSlot,
912
958
  blockNumber,
913
959
  indexWithinCheckpoint
914
960
  });
915
- this.setStateFn(SequencerState.CREATING_BLOCK, this.slot);
916
- // Calculate blob fields limit for txs (remaining capacity - this block's end overhead)
917
- const blockEndOverhead = getNumBlockEndBlobFields(indexWithinCheckpoint === 0);
918
- const maxBlobFieldsForTxs = remainingBlobFields - blockEndOverhead;
961
+ this.setStateFn(SequencerState.CREATING_BLOCK, this.targetSlot);
962
+ // Per-block limits are operator overrides (from SEQ_MAX_L2_BLOCK_GAS etc.) further capped
963
+ // by remaining checkpoint-level budgets inside CheckpointBuilder before each block is built.
964
+ // minValidTxs is passed into the builder so it can reject the block *before* updating state.
965
+ const minValidTxs = forceCreate ? 0 : this.config.minValidTxsPerBlock ?? minTxs;
919
966
  const blockBuilderOptions = {
920
967
  maxTransactions: this.config.maxTxsPerBlock,
921
- maxBlockSize: this.config.maxBlockSizeInBytes,
922
- maxBlockGas: new Gas(this.config.maxDABlockGas, this.config.maxL2BlockGas),
923
- maxBlobFields: maxBlobFieldsForTxs,
924
- deadline: buildDeadline
968
+ maxBlockGas: this.config.maxL2BlockGas !== undefined || this.config.maxDABlockGas !== undefined ? new Gas(this.config.maxDABlockGas ?? Infinity, this.config.maxL2BlockGas ?? Infinity) : undefined,
969
+ deadline: buildDeadline,
970
+ isBuildingProposal: true,
971
+ minValidTxs,
972
+ maxBlocksPerCheckpoint: this.timetable.maxNumberOfBlocks,
973
+ perBlockAllocationMultiplier: this.config.perBlockAllocationMultiplier
925
974
  };
926
- // Actually build the block by executing txs
975
+ // Actually build the block by executing txs. The builder throws InsufficientValidTxsError
976
+ // if the number of successfully processed txs is below minValidTxs, ensuring state is not
977
+ // updated for blocks that will be discarded.
927
978
  const buildResult = await this.buildSingleBlockWithCheckpointBuilder(checkpointBuilder, pendingTxs, blockNumber, blockTimestamp, blockBuilderOptions);
928
979
  // If any txs failed during execution, drop them from the mempool so we don't pick them up again
929
980
  await this.dropFailedTxsFromP2P(buildResult.failedTxs);
930
- // Check if we have created a block with enough txs. If there were invalid txs in the pool, or if execution took
931
- // too long, then we may not get to minTxsPerBlock after executing public functions.
932
- const minValidTxs = this.config.minValidTxsPerBlock ?? minTxs;
933
- const numTxs = buildResult.status === 'no-valid-txs' ? 0 : buildResult.numTxs;
934
- if (buildResult.status === 'no-valid-txs' || !forceCreate && numTxs < minValidTxs) {
935
- this.log.warn(`Block ${blockNumber} at index ${indexWithinCheckpoint} on slot ${this.slot} has too few valid txs to be proposed`, {
936
- slot: this.slot,
981
+ if (buildResult.status === 'insufficient-valid-txs') {
982
+ this.log.warn(`Block ${blockNumber} at index ${indexWithinCheckpoint} on slot ${this.targetSlot} has too few valid txs to be proposed`, {
983
+ slot: this.targetSlot,
937
984
  blockNumber,
938
- numTxs,
985
+ numTxs: buildResult.processedCount,
939
986
  indexWithinCheckpoint,
940
- minValidTxs,
941
- buildResult: buildResult.status
987
+ minValidTxs
942
988
  });
943
989
  this.eventEmitter.emit('block-build-failed', {
944
990
  reason: `Insufficient valid txs`,
945
- slot: this.slot
991
+ slot: this.targetSlot
946
992
  });
947
993
  this.metrics.recordBlockProposalFailed('insufficient_valid_txs');
948
994
  return undefined;
949
995
  }
950
996
  // Block creation succeeded, emit stats and metrics
951
- const { publicGas, block, publicProcessorDuration, usedTxs, usedTxBlobFields, blockBuildDuration } = buildResult;
997
+ const { block, publicProcessorDuration, usedTxs, blockBuildDuration, numTxs } = buildResult;
952
998
  const blockStats = {
953
999
  eventName: 'l2-block-built',
954
1000
  duration: blockBuildDuration,
@@ -957,8 +1003,8 @@ _dec = trackSpan('CheckpointProposalJob.execute'), _dec1 = trackSpan('Checkpoint
957
1003
  };
958
1004
  const blockHash = await block.hash();
959
1005
  const txHashes = block.body.txEffects.map((tx)=>tx.txHash);
960
- const manaPerSec = publicGas.l2Gas / (blockBuildDuration / 1000);
961
- this.log.info(`Built block ${block.number} at checkpoint ${this.checkpointNumber} for slot ${this.slot} with ${numTxs} txs`, {
1006
+ const manaPerSec = block.header.totalManaUsed.toNumberUnsafe() / (blockBuildDuration / 1000);
1007
+ this.log.info(`Built block ${block.number} at checkpoint ${this.checkpointNumber} for slot ${this.targetSlot} with ${numTxs} txs`, {
962
1008
  blockHash,
963
1009
  txHashes,
964
1010
  manaPerSec,
@@ -966,22 +1012,22 @@ _dec = trackSpan('CheckpointProposalJob.execute'), _dec1 = trackSpan('Checkpoint
966
1012
  });
967
1013
  this.eventEmitter.emit('block-proposed', {
968
1014
  blockNumber: block.number,
969
- slot: this.slot
1015
+ slot: this.targetSlot,
1016
+ buildSlot: this.slotNow
970
1017
  });
971
- this.metrics.recordBuiltBlock(blockBuildDuration, publicGas.l2Gas);
1018
+ this.metrics.recordBuiltBlock(blockBuildDuration, block.header.totalManaUsed.toNumberUnsafe());
972
1019
  return {
973
1020
  block,
974
- usedTxs,
975
- remainingBlobFields: maxBlobFieldsForTxs - usedTxBlobFields
1021
+ usedTxs
976
1022
  };
977
1023
  } catch (err) {
978
1024
  this.eventEmitter.emit('block-build-failed', {
979
1025
  reason: err.message,
980
- slot: this.slot
1026
+ slot: this.targetSlot
981
1027
  });
982
1028
  this.log.error(`Error building block`, err, {
983
1029
  blockNumber,
984
- slot: this.slot
1030
+ slot: this.targetSlot
985
1031
  });
986
1032
  this.metrics.recordBlockProposalFailed(err.name || 'unknown_error');
987
1033
  this.metrics.recordFailedBlock();
@@ -990,7 +1036,7 @@ _dec = trackSpan('CheckpointProposalJob.execute'), _dec1 = trackSpan('Checkpoint
990
1036
  };
991
1037
  }
992
1038
  }
993
- /** Uses the checkpoint builder to build a block, catching specific txs */ async buildSingleBlockWithCheckpointBuilder(checkpointBuilder, pendingTxs, blockNumber, blockTimestamp, blockBuilderOptions) {
1039
+ /** Uses the checkpoint builder to build a block, catching InsufficientValidTxsError. */ async buildSingleBlockWithCheckpointBuilder(checkpointBuilder, pendingTxs, blockNumber, blockTimestamp, blockBuilderOptions) {
994
1040
  try {
995
1041
  const workTimer = new Timer();
996
1042
  const result = await checkpointBuilder.buildBlock(pendingTxs, blockNumber, blockTimestamp, blockBuilderOptions);
@@ -1001,10 +1047,11 @@ _dec = trackSpan('CheckpointProposalJob.execute'), _dec1 = trackSpan('Checkpoint
1001
1047
  status: 'success'
1002
1048
  };
1003
1049
  } catch (err) {
1004
- if (isErrorClass(err, NoValidTxsError)) {
1050
+ if (isErrorClass(err, InsufficientValidTxsError)) {
1005
1051
  return {
1006
1052
  failedTxs: err.failedTxs,
1007
- status: 'no-valid-txs'
1053
+ processedCount: err.processedCount,
1054
+ status: 'insufficient-valid-txs'
1008
1055
  };
1009
1056
  }
1010
1057
  throw err;
@@ -1023,22 +1070,24 @@ _dec = trackSpan('CheckpointProposalJob.execute'), _dec1 = trackSpan('Checkpoint
1023
1070
  if (startBuildingDeadline === undefined || now >= startBuildingDeadline) {
1024
1071
  return {
1025
1072
  canStartBuilding: false,
1026
- availableTxs: availableTxs
1073
+ availableTxs,
1074
+ minTxs
1027
1075
  };
1028
1076
  }
1029
1077
  // Wait a bit before checking again
1030
- this.setStateFn(SequencerState.WAITING_FOR_TXS, this.slot);
1031
- this.log.verbose(`Waiting for enough txs to build block ${blockNumber} at index ${indexWithinCheckpoint} in slot ${this.slot} (have ${availableTxs} but need ${minTxs})`, {
1078
+ this.setStateFn(SequencerState.WAITING_FOR_TXS, this.targetSlot);
1079
+ this.log.verbose(`Waiting for enough txs to build block ${blockNumber} at index ${indexWithinCheckpoint} in slot ${this.targetSlot} (have ${availableTxs} but need ${minTxs})`, {
1032
1080
  blockNumber,
1033
- slot: this.slot,
1081
+ slot: this.targetSlot,
1034
1082
  indexWithinCheckpoint
1035
1083
  });
1036
- await sleep(TXS_POLLING_MS);
1084
+ await this.waitForTxsPollingInterval();
1037
1085
  availableTxs = await this.p2pClient.getPendingTxCount();
1038
1086
  }
1039
1087
  return {
1040
1088
  canStartBuilding: true,
1041
- availableTxs
1089
+ availableTxs,
1090
+ minTxs
1042
1091
  };
1043
1092
  }
1044
1093
  /**
@@ -1075,10 +1124,16 @@ _dec = trackSpan('CheckpointProposalJob.execute'), _dec1 = trackSpan('Checkpoint
1075
1124
  try {
1076
1125
  const attestations = await this.validatorClient.collectAttestations(proposal, numberOfRequiredAttestations, attestationDeadline);
1077
1126
  collectedAttestationsCount = attestations.length;
1127
+ // Trim attestations to minimum required to save L1 calldata gas
1128
+ const localAddresses = this.validatorClient.getValidatorAddresses();
1129
+ const trimmed = trimAttestations(attestations, numberOfRequiredAttestations, this.attestorAddress, localAddresses);
1130
+ if (trimmed.length < attestations.length) {
1131
+ this.log.debug(`Trimmed attestations from ${attestations.length} to ${trimmed.length} for L1 submission`);
1132
+ }
1078
1133
  // Rollup contract requires that the signatures are provided in the order of the committee
1079
- const sorted = orderAttestations(attestations, committee);
1134
+ const sorted = orderAttestations(trimmed, committee);
1080
1135
  // Manipulate the attestations if we've been configured to do so
1081
- if (this.config.injectFakeAttestation || this.config.shuffleAttestationOrdering) {
1136
+ if (this.config.injectFakeAttestation || this.config.injectHighSValueAttestation || this.config.injectUnrecoverableSignatureAttestation || this.config.shuffleAttestationOrdering) {
1082
1137
  return this.manipulateAttestations(proposal.slotNumber, epoch, seed, committee, sorted);
1083
1138
  }
1084
1139
  return new CommitteeAttestationsAndSigners(sorted);
@@ -1095,7 +1150,7 @@ _dec = trackSpan('CheckpointProposalJob.execute'), _dec1 = trackSpan('Checkpoint
1095
1150
  // Compute the proposer index in the committee, since we dont want to tweak it.
1096
1151
  // Otherwise, the L1 rollup contract will reject the block outright.
1097
1152
  const proposerIndex = Number(this.epochCache.computeProposerIndex(slotNumber, epoch, seed, BigInt(committee.length)));
1098
- if (this.config.injectFakeAttestation) {
1153
+ if (this.config.injectFakeAttestation || this.config.injectHighSValueAttestation || this.config.injectUnrecoverableSignatureAttestation) {
1099
1154
  // Find non-empty attestations that are not from the proposer
1100
1155
  const nonProposerIndices = [];
1101
1156
  for(let i = 0; i < attestations.length; i++){
@@ -1105,8 +1160,16 @@ _dec = trackSpan('CheckpointProposalJob.execute'), _dec1 = trackSpan('Checkpoint
1105
1160
  }
1106
1161
  if (nonProposerIndices.length > 0) {
1107
1162
  const targetIndex = nonProposerIndices[randomInt(nonProposerIndices.length)];
1108
- this.log.warn(`Injecting fake attestation in checkpoint for slot ${slotNumber} at index ${targetIndex}`);
1109
- unfreeze(attestations[targetIndex]).signature = Signature.random();
1163
+ if (this.config.injectHighSValueAttestation) {
1164
+ this.log.warn(`Injecting high-s value attestation in checkpoint for slot ${slotNumber} at index ${targetIndex}`);
1165
+ unfreeze(attestations[targetIndex]).signature = flipSignature(attestations[targetIndex].signature);
1166
+ } else if (this.config.injectUnrecoverableSignatureAttestation) {
1167
+ this.log.warn(`Injecting unrecoverable signature attestation in checkpoint for slot ${slotNumber} at index ${targetIndex}`);
1168
+ unfreeze(attestations[targetIndex]).signature = generateUnrecoverableSignature();
1169
+ } else {
1170
+ this.log.warn(`Injecting fake attestation in checkpoint for slot ${slotNumber} at index ${targetIndex}`);
1171
+ unfreeze(attestations[targetIndex]).signature = generateRecoverableSignature();
1172
+ }
1110
1173
  }
1111
1174
  return new CommitteeAttestationsAndSigners(attestations);
1112
1175
  }
@@ -1115,14 +1178,25 @@ _dec = trackSpan('CheckpointProposalJob.execute'), _dec1 = trackSpan('Checkpoint
1115
1178
  const shuffled = [
1116
1179
  ...attestations
1117
1180
  ];
1118
- const [i, j] = [
1119
- (proposerIndex + 1) % shuffled.length,
1120
- (proposerIndex + 2) % shuffled.length
1121
- ];
1122
- const valueI = shuffled[i];
1123
- const valueJ = shuffled[j];
1124
- shuffled[i] = valueJ;
1125
- shuffled[j] = valueI;
1181
+ // Find two non-proposer positions that both have non-empty signatures to swap.
1182
+ // This ensures the bitmap doesn't change, so the MaliciousCommitteeAttestationsAndSigners
1183
+ // signers array stays correctly aligned with L1's committee reconstruction.
1184
+ const swappable = [];
1185
+ for(let k = 0; k < shuffled.length; k++){
1186
+ if (!shuffled[k].signature.isEmpty() && k !== proposerIndex) {
1187
+ swappable.push(k);
1188
+ }
1189
+ }
1190
+ if (swappable.length >= 2) {
1191
+ const [i, j] = [
1192
+ swappable[0],
1193
+ swappable[1]
1194
+ ];
1195
+ [shuffled[i], shuffled[j]] = [
1196
+ shuffled[j],
1197
+ shuffled[i]
1198
+ ];
1199
+ }
1126
1200
  const signers = new CommitteeAttestationsAndSigners(attestations).getSigners();
1127
1201
  return new MaliciousCommitteeAttestationsAndSigners(shuffled, signers);
1128
1202
  }
@@ -1135,7 +1209,7 @@ _dec = trackSpan('CheckpointProposalJob.execute'), _dec1 = trackSpan('Checkpoint
1135
1209
  const failedTxData = failedTxs.map((fail)=>fail.tx);
1136
1210
  const failedTxHashes = failedTxData.map((tx)=>tx.getTxHash());
1137
1211
  this.log.verbose(`Dropping failed txs ${failedTxHashes.join(', ')}`);
1138
- await this.p2pClient.deleteTxs(failedTxHashes);
1212
+ await this.p2pClient.handleFailedExecution(failedTxHashes);
1139
1213
  }
1140
1214
  /**
1141
1215
  * Adds the proposed block to the archiver so it's available via P2P.
@@ -1158,27 +1232,50 @@ _dec = trackSpan('CheckpointProposalJob.execute'), _dec1 = trackSpan('Checkpoint
1158
1232
  /** Runs fee analysis and logs checkpoint outcome as fisherman */ async handleCheckpointEndAsFisherman(checkpoint) {
1159
1233
  // Perform L1 fee analysis before clearing requests
1160
1234
  // The callback is invoked asynchronously after the next block is mined
1161
- const feeAnalysis = await this.publisher.analyzeL1Fees(this.slot, (analysis)=>this.metrics.recordFishermanFeeAnalysis(analysis));
1235
+ const feeAnalysis = await this.publisher.analyzeL1Fees(this.targetSlot, (analysis)=>this.metrics.recordFishermanFeeAnalysis(analysis));
1162
1236
  if (checkpoint) {
1163
- this.log.info(`Validation checkpoint building SUCCEEDED for slot ${this.slot}`, {
1237
+ this.log.info(`Validation checkpoint building SUCCEEDED for slot ${this.targetSlot}`, {
1164
1238
  ...checkpoint.toCheckpointInfo(),
1165
1239
  ...checkpoint.getStats(),
1166
1240
  feeAnalysisId: feeAnalysis?.id
1167
1241
  });
1168
1242
  } else {
1169
- this.log.warn(`Validation block building FAILED for slot ${this.slot}`, {
1170
- slot: this.slot,
1243
+ this.log.warn(`Validation block building FAILED for slot ${this.targetSlot}`, {
1244
+ slot: this.targetSlot,
1171
1245
  feeAnalysisId: feeAnalysis?.id
1172
1246
  });
1173
- this.metrics.recordBlockProposalFailed('block_build_failed');
1247
+ this.metrics.recordCheckpointProposalFailed('block_build_failed');
1174
1248
  }
1175
1249
  this.publisher.clearPendingRequests();
1176
1250
  }
1251
+ /**
1252
+ * Helper to handle HA double-signing errors. Returns true if the error was handled (caller should yield).
1253
+ */ handleHASigningError(err, errorContext) {
1254
+ if (err instanceof DutyAlreadySignedError) {
1255
+ this.log.info(`${errorContext} for slot ${this.targetSlot} already signed by another HA node, yielding`, {
1256
+ slot: this.targetSlot,
1257
+ signedByNode: err.signedByNode
1258
+ });
1259
+ return true;
1260
+ }
1261
+ if (err instanceof SlashingProtectionError) {
1262
+ this.log.info(`${errorContext} for slot ${this.targetSlot} blocked by slashing protection, yielding`, {
1263
+ slot: this.targetSlot,
1264
+ existingMessageHash: err.existingMessageHash,
1265
+ attemptedMessageHash: err.attemptedMessageHash
1266
+ });
1267
+ return true;
1268
+ }
1269
+ return false;
1270
+ }
1177
1271
  /** Waits until a specific time within the current slot */ async waitUntilTimeInSlot(targetSecondsIntoSlot) {
1178
1272
  const slotStartTimestamp = this.getSlotStartBuildTimestamp();
1179
1273
  const targetTimestamp = slotStartTimestamp + targetSecondsIntoSlot;
1180
1274
  await sleepUntil(new Date(targetTimestamp * 1000), this.dateProvider.nowAsDate());
1181
1275
  }
1276
+ /** Waits the polling interval for transactions. Extracted for test overriding. */ async waitForTxsPollingInterval() {
1277
+ await sleep(TXS_POLLING_MS);
1278
+ }
1182
1279
  getSlotStartBuildTimestamp() {
1183
1280
  return getSlotStartBuildTimestamp(this.slot, this.l1Constants);
1184
1281
  }