@aztec/sequencer-client 0.0.1-commit.a89ec08 → 0.0.1-commit.aa0c64f

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 (125) hide show
  1. package/README.md +281 -21
  2. package/dest/client/sequencer-client.d.ts +19 -5
  3. package/dest/client/sequencer-client.d.ts.map +1 -1
  4. package/dest/client/sequencer-client.js +27 -22
  5. package/dest/config.d.ts +9 -2
  6. package/dest/config.d.ts.map +1 -1
  7. package/dest/config.js +55 -25
  8. package/dest/global_variable_builder/fee_predictor.d.ts +37 -0
  9. package/dest/global_variable_builder/fee_predictor.d.ts.map +1 -0
  10. package/dest/global_variable_builder/fee_predictor.js +138 -0
  11. package/dest/global_variable_builder/fee_provider.d.ts +21 -0
  12. package/dest/global_variable_builder/fee_provider.d.ts.map +1 -0
  13. package/dest/global_variable_builder/fee_provider.js +80 -0
  14. package/dest/global_variable_builder/global_builder.d.ts +6 -25
  15. package/dest/global_variable_builder/global_builder.d.ts.map +1 -1
  16. package/dest/global_variable_builder/global_builder.js +7 -65
  17. package/dest/global_variable_builder/index.d.ts +3 -1
  18. package/dest/global_variable_builder/index.d.ts.map +1 -1
  19. package/dest/global_variable_builder/index.js +2 -0
  20. package/dest/publisher/config.d.ts +23 -3
  21. package/dest/publisher/config.d.ts.map +1 -1
  22. package/dest/publisher/config.js +36 -6
  23. package/dest/publisher/index.d.ts +2 -1
  24. package/dest/publisher/index.d.ts.map +1 -1
  25. package/dest/publisher/l1_to_l2_messaging.d.ts +21 -0
  26. package/dest/publisher/l1_to_l2_messaging.d.ts.map +1 -0
  27. package/dest/publisher/l1_to_l2_messaging.js +70 -0
  28. package/dest/publisher/l1_tx_failed_store/factory.d.ts +11 -0
  29. package/dest/publisher/l1_tx_failed_store/factory.d.ts.map +1 -0
  30. package/dest/publisher/l1_tx_failed_store/factory.js +22 -0
  31. package/dest/publisher/l1_tx_failed_store/failed_tx_store.d.ts +98 -0
  32. package/dest/publisher/l1_tx_failed_store/failed_tx_store.d.ts.map +1 -0
  33. package/dest/publisher/l1_tx_failed_store/failed_tx_store.js +68 -0
  34. package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.d.ts +15 -0
  35. package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.d.ts.map +1 -0
  36. package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.js +36 -0
  37. package/dest/publisher/l1_tx_failed_store/index.d.ts +4 -0
  38. package/dest/publisher/l1_tx_failed_store/index.d.ts.map +1 -0
  39. package/dest/publisher/l1_tx_failed_store/index.js +3 -0
  40. package/dest/publisher/sequencer-bundle-simulator.d.ts +96 -0
  41. package/dest/publisher/sequencer-bundle-simulator.d.ts.map +1 -0
  42. package/dest/publisher/sequencer-bundle-simulator.js +198 -0
  43. package/dest/publisher/sequencer-publisher-factory.d.ts +3 -5
  44. package/dest/publisher/sequencer-publisher-factory.d.ts.map +1 -1
  45. package/dest/publisher/sequencer-publisher-factory.js +16 -3
  46. package/dest/publisher/sequencer-publisher.d.ts +105 -66
  47. package/dest/publisher/sequencer-publisher.d.ts.map +1 -1
  48. package/dest/publisher/sequencer-publisher.js +716 -400
  49. package/dest/publisher/write_json.d.ts +11 -0
  50. package/dest/publisher/write_json.d.ts.map +1 -0
  51. package/dest/publisher/write_json.js +57 -0
  52. package/dest/sequencer/automine/automine_factory.d.ts +56 -0
  53. package/dest/sequencer/automine/automine_factory.d.ts.map +1 -0
  54. package/dest/sequencer/automine/automine_factory.js +85 -0
  55. package/dest/sequencer/automine/automine_sequencer.d.ts +189 -0
  56. package/dest/sequencer/automine/automine_sequencer.d.ts.map +1 -0
  57. package/dest/sequencer/automine/automine_sequencer.js +690 -0
  58. package/dest/sequencer/automine/index.d.ts +3 -0
  59. package/dest/sequencer/automine/index.d.ts.map +1 -0
  60. package/dest/sequencer/automine/index.js +2 -0
  61. package/dest/sequencer/checkpoint_proposal_job.d.ts +73 -17
  62. package/dest/sequencer/checkpoint_proposal_job.d.ts.map +1 -1
  63. package/dest/sequencer/checkpoint_proposal_job.js +786 -232
  64. package/dest/sequencer/checkpoint_proposal_job_metrics.d.ts +34 -0
  65. package/dest/sequencer/checkpoint_proposal_job_metrics.d.ts.map +1 -0
  66. package/dest/sequencer/checkpoint_proposal_job_metrics.js +72 -0
  67. package/dest/sequencer/events.d.ts +62 -5
  68. package/dest/sequencer/events.d.ts.map +1 -1
  69. package/dest/sequencer/metrics.d.ts +13 -10
  70. package/dest/sequencer/metrics.d.ts.map +1 -1
  71. package/dest/sequencer/metrics.js +45 -20
  72. package/dest/sequencer/requests_tracker.d.ts +22 -0
  73. package/dest/sequencer/requests_tracker.d.ts.map +1 -0
  74. package/dest/sequencer/requests_tracker.js +33 -0
  75. package/dest/sequencer/sequencer.d.ts +155 -34
  76. package/dest/sequencer/sequencer.d.ts.map +1 -1
  77. package/dest/sequencer/sequencer.js +580 -186
  78. package/dest/sequencer/types.d.ts +2 -2
  79. package/dest/sequencer/types.d.ts.map +1 -1
  80. package/dest/test/index.d.ts +3 -3
  81. package/dest/test/index.d.ts.map +1 -1
  82. package/dest/test/mock_checkpoint_builder.d.ts +1 -1
  83. package/dest/test/mock_checkpoint_builder.d.ts.map +1 -1
  84. package/dest/test/mock_checkpoint_builder.js +0 -2
  85. package/dest/test/utils.d.ts +15 -1
  86. package/dest/test/utils.d.ts.map +1 -1
  87. package/dest/test/utils.js +25 -7
  88. package/package.json +30 -29
  89. package/src/client/sequencer-client.ts +38 -32
  90. package/src/config.ts +64 -22
  91. package/src/global_variable_builder/README.md +44 -0
  92. package/src/global_variable_builder/fee_predictor.ts +182 -0
  93. package/src/global_variable_builder/fee_provider.ts +97 -0
  94. package/src/global_variable_builder/global_builder.ts +12 -80
  95. package/src/global_variable_builder/index.ts +2 -0
  96. package/src/publisher/config.ts +71 -7
  97. package/src/publisher/index.ts +3 -0
  98. package/src/publisher/l1_to_l2_messaging.ts +85 -0
  99. package/src/publisher/l1_tx_failed_store/factory.ts +32 -0
  100. package/src/publisher/l1_tx_failed_store/failed_tx_store.ts +164 -0
  101. package/src/publisher/l1_tx_failed_store/file_store_failed_tx_store.ts +47 -0
  102. package/src/publisher/l1_tx_failed_store/index.ts +3 -0
  103. package/src/publisher/sequencer-bundle-simulator.ts +254 -0
  104. package/src/publisher/sequencer-publisher-factory.ts +18 -6
  105. package/src/publisher/sequencer-publisher.ts +800 -475
  106. package/src/publisher/write_json.ts +78 -0
  107. package/src/sequencer/README.md +162 -450
  108. package/src/sequencer/automine/README.md +60 -0
  109. package/src/sequencer/automine/automine_factory.ts +152 -0
  110. package/src/sequencer/automine/automine_sequencer.ts +796 -0
  111. package/src/sequencer/automine/index.ts +6 -0
  112. package/src/sequencer/checkpoint_proposal_job.ts +922 -246
  113. package/src/sequencer/checkpoint_proposal_job_metrics.ts +128 -0
  114. package/src/sequencer/events.ts +66 -5
  115. package/src/sequencer/metrics.ts +57 -24
  116. package/src/sequencer/requests_tracker.ts +43 -0
  117. package/src/sequencer/sequencer.ts +682 -206
  118. package/src/sequencer/types.ts +1 -1
  119. package/src/test/index.ts +2 -2
  120. package/src/test/mock_checkpoint_builder.ts +0 -2
  121. package/src/test/utils.ts +61 -10
  122. package/dest/sequencer/timetable.d.ts +0 -88
  123. package/dest/sequencer/timetable.d.ts.map +0 -1
  124. package/dest/sequencer/timetable.js +0 -222
  125. package/src/sequencer/timetable.ts +0 -283
@@ -370,44 +370,53 @@ function applyDecs2203RFactory() {
370
370
  function _apply_decs_2203_r(targetClass, memberDecs, classDecs, parentClass) {
371
371
  return (_apply_decs_2203_r = applyDecs2203RFactory())(targetClass, memberDecs, classDecs, parentClass);
372
372
  }
373
- var _dec, _dec1, _dec2, _initProto;
373
+ var _dec, _dec1, _initProto;
374
374
  import { Blob, getBlobsPerL1Block, getPrefixedEthBlobCommitments } from '@aztec/blob-lib';
375
- import { FeeAssetPriceOracle, MULTI_CALL_3_ADDRESS, Multicall3, RollupContract } from '@aztec/ethereum/contracts';
376
- import { L1FeeAnalyzer } from '@aztec/ethereum/l1-fee-analysis';
377
- import { MAX_L1_TX_LIMIT, WEI_CONST } from '@aztec/ethereum/l1-tx-utils';
378
- import { FormattedViemError, formatViemError, mergeAbis, tryExtractEvent } from '@aztec/ethereum/utils';
379
- import { sumBigint } from '@aztec/foundation/bigint';
380
- import { toHex as toPaddedHex } from '@aztec/foundation/bigint-buffer';
375
+ import { FeeAssetPriceOracle, MULTI_CALL_3_ADDRESS, Multicall3, MulticallForwarderRevertedError, buildSimulationOverridesStateOverride } from '@aztec/ethereum/contracts';
376
+ import { L1FeeAnalyzer, captureWindowBlockFees } from '@aztec/ethereum/l1-fee-analysis';
377
+ import { L1TxTimeoutError, MAX_L1_TX_LIMIT, WEI_CONST } from '@aztec/ethereum/l1-tx-utils';
378
+ import { FormattedViemError, formatViemError, mergeAbis, tryDecodeRevertReason, tryExtractEvent } from '@aztec/ethereum/utils';
381
379
  import { CheckpointNumber, SlotNumber } from '@aztec/foundation/branded-types';
382
380
  import { trimmedBytesLength } from '@aztec/foundation/buffer';
383
381
  import { pick } from '@aztec/foundation/collection';
382
+ import { TimeoutError } from '@aztec/foundation/error';
384
383
  import { EthAddress } from '@aztec/foundation/eth-address';
385
384
  import { Signature } from '@aztec/foundation/eth-signature';
386
385
  import { createLogger } from '@aztec/foundation/log';
387
- import { makeBackoff, retry } from '@aztec/foundation/retry';
386
+ import { InterruptibleSleep } from '@aztec/foundation/sleep';
388
387
  import { bufferToHex } from '@aztec/foundation/string';
389
388
  import { Timer } from '@aztec/foundation/timer';
390
- import { EmpireBaseAbi, ErrorsAbi, RollupAbi } from '@aztec/l1-artifacts';
389
+ import { EmpireBaseAbi, ErrorsAbi, RollupAbi, SlashingProposerAbi } from '@aztec/l1-artifacts';
391
390
  import { encodeSlashConsensusVotes } from '@aztec/slasher';
392
391
  import { CommitteeAttestationsAndSigners } from '@aztec/stdlib/block';
393
- import { getLastL1SlotTimestampForL2Slot, getNextL1SlotTimestamp } from '@aztec/stdlib/epoch-helpers';
392
+ import { getLastL1SlotTimestampForL2Slot, getNextL1SlotTimestamp, getTimestampForSlot } from '@aztec/stdlib/epoch-helpers';
394
393
  import { getTelemetryClient, trackSpan } from '@aztec/telemetry-client';
395
- import { encodeFunctionData, toHex } from 'viem';
394
+ import { encodeFunctionData, keccak256, toHex } from 'viem';
395
+ import { createL1TxFailedStore } from './l1_tx_failed_store/index.js';
396
+ import { SequencerBundleSimulator } from './sequencer-bundle-simulator.js';
396
397
  import { SequencerPublisherMetrics } from './sequencer-publisher-metrics.js';
398
+ /**
399
+ * Returns true if the receipt indicates a successful send AND the expected event was emitted
400
+ * by the target contract. Both pieces are required: an aggregate3 entry that reverted will
401
+ * have receipt.status === 'success' but no event log.
402
+ */ function extractEventSuccess(receipt, opts) {
403
+ if (!receipt || receipt.status !== 'success') {
404
+ return false;
405
+ }
406
+ return !!tryExtractEvent(receipt.logs, opts.address.toString(), opts.abi, opts.eventName);
407
+ }
397
408
  export const Actions = [
398
409
  'invalidate-by-invalid-attestation',
399
410
  'invalidate-by-insufficient-attestations',
411
+ 'prune',
400
412
  'propose',
401
413
  'governance-signal',
402
- 'empire-slashing-signal',
403
- 'create-empire-payload',
404
- 'execute-empire-payload',
405
414
  'vote-offenses',
406
415
  'execute-slash'
407
416
  ];
408
417
  // Sorting for actions such that invalidations go before proposals, and proposals go before votes
409
418
  export const compareActions = (a, b)=>Actions.indexOf(a) - Actions.indexOf(b);
410
- _dec = trackSpan('SequencerPublisher.sendRequests'), _dec1 = trackSpan('SequencerPublisher.validateBlockHeader'), _dec2 = trackSpan('SequencerPublisher.validateCheckpointForSubmission');
419
+ _dec = trackSpan('SequencerPublisher.sendRequests'), _dec1 = trackSpan('SequencerPublisher.validateBlockHeader');
411
420
  export class SequencerPublisher {
412
421
  config;
413
422
  static{
@@ -421,61 +430,64 @@ export class SequencerPublisher {
421
430
  _dec1,
422
431
  2,
423
432
  "validateBlockHeader"
424
- ],
425
- [
426
- _dec2,
427
- 2,
428
- "validateCheckpointForSubmission"
429
433
  ]
430
434
  ], []));
431
435
  }
432
436
  interrupted;
433
437
  metrics;
438
+ bundleSimulator;
434
439
  epochCache;
435
- governanceLog;
436
- slashingLog;
440
+ failedTxStore;
441
+ /**
442
+ * ABI used to decode raw revert payloads from dropped bundle entries when the original
443
+ * request did not carry an abi (e.g. the propose request). Merges every contract the
444
+ * publisher can route to so any of their custom errors decode against it.
445
+ */ revertDecoderAbi;
437
446
  lastActions;
438
- isPayloadEmptyCache;
439
- payloadProposedCache;
440
447
  log;
441
448
  ethereumSlotDuration;
442
449
  aztecSlotDuration;
443
- dateProvider;
450
+ previousL1BlockWaitTimeoutMs;
451
+ previousL1BlockWaitPollIntervalMs;
452
+ /** Date provider for wall-clock time. */ dateProvider;
444
453
  blobClient;
445
- /** Address to use for simulations in fisherman mode (actual proposer's address) */ proposerAddressForSimulation;
454
+ /** Optional callback to obtain a replacement publisher when the current one fails to send. */ getNextPublisher;
446
455
  /** L1 fee analyzer for fisherman mode */ l1FeeAnalyzer;
447
456
  /** Fee asset price oracle for computing price modifiers from Uniswap V4 */ feeAssetPriceOracle;
448
- // A CALL to a cold address is 2700 gas
449
- static MULTICALL_OVERHEAD_GAS_GUESS = 5000n;
450
- // Gas report for VotingWithSigTest shows a max gas of 100k, but we've seen it cost 700k+ in testnet
451
- static VOTE_GAS_GUESS = 800_000n;
457
+ /** Interruptible sleep used by sendRequestsAt to wait until a target timestamp. */ interruptibleSleep;
452
458
  l1TxUtils;
453
459
  rollupContract;
454
460
  govProposerContract;
455
461
  slashingProposerContract;
456
- slashFactoryContract;
457
462
  tracer;
458
463
  requests;
459
464
  constructor(config, deps){
460
465
  this.config = config;
461
466
  this.interrupted = (_initProto(this), false);
462
- this.governanceLog = createLogger('sequencer:publisher:governance');
463
- this.slashingLog = createLogger('sequencer:publisher:slashing');
467
+ this.revertDecoderAbi = mergeAbis([
468
+ RollupAbi,
469
+ SlashingProposerAbi,
470
+ EmpireBaseAbi,
471
+ ErrorsAbi
472
+ ]);
464
473
  this.lastActions = {};
465
- this.isPayloadEmptyCache = new Map();
466
- this.payloadProposedCache = new Set();
474
+ this.interruptibleSleep = new InterruptibleSleep();
467
475
  this.requests = [];
468
476
  this.log = deps.log ?? createLogger('sequencer:publisher');
469
477
  this.ethereumSlotDuration = BigInt(config.ethereumSlotDuration);
470
478
  this.aztecSlotDuration = BigInt(config.aztecSlotDuration);
479
+ this.previousL1BlockWaitTimeoutMs = config.sequencerPublisherPreviousL1BlockWaitTimeoutMs;
480
+ this.previousL1BlockWaitPollIntervalMs = config.sequencerPublisherPreviousL1BlockWaitPollIntervalMs;
471
481
  this.dateProvider = deps.dateProvider;
472
482
  this.epochCache = deps.epochCache;
473
483
  this.lastActions = deps.lastActions;
474
484
  this.blobClient = deps.blobClient;
485
+ this.dateProvider = deps.dateProvider;
475
486
  const telemetry = deps.telemetry ?? getTelemetryClient();
476
487
  this.metrics = deps.metrics ?? new SequencerPublisherMetrics(telemetry, 'SequencerPublisher');
477
488
  this.tracer = telemetry.getTracer('SequencerPublisher');
478
489
  this.l1TxUtils = deps.l1TxUtils;
490
+ this.getNextPublisher = deps.getNextPublisher;
479
491
  this.rollupContract = deps.rollupContract;
480
492
  this.govProposerContract = deps.governanceProposerContract;
481
493
  this.slashingProposerContract = deps.slashingProposerContract;
@@ -484,22 +496,116 @@ export class SequencerPublisher {
484
496
  const newSlashingProposer = await this.rollupContract.getSlashingProposer();
485
497
  this.slashingProposerContract = newSlashingProposer;
486
498
  });
487
- this.slashFactoryContract = deps.slashFactoryContract;
488
499
  // Initialize L1 fee analyzer for fisherman mode
489
500
  if (config.fishermanMode) {
490
- this.l1FeeAnalyzer = new L1FeeAnalyzer(this.l1TxUtils.client, deps.dateProvider, createLogger('sequencer:publisher:fee-analyzer'));
501
+ this.l1FeeAnalyzer = new L1FeeAnalyzer(this.l1TxUtils.client, deps.dateProvider, this.log.createChild('fee-analyzer'));
491
502
  }
492
503
  // Initialize fee asset price oracle
493
- this.feeAssetPriceOracle = new FeeAssetPriceOracle(this.l1TxUtils.client, this.rollupContract, createLogger('sequencer:publisher:price-oracle'));
504
+ this.feeAssetPriceOracle = new FeeAssetPriceOracle(this.l1TxUtils.client, this.rollupContract, this.log.createChild('price-oracle'));
505
+ // Initialize failed L1 tx store (optional, for test networks)
506
+ this.failedTxStore = createL1TxFailedStore(config.l1TxFailedStore, this.log);
507
+ this.bundleSimulator = new SequencerBundleSimulator({
508
+ getL1TxUtils: ()=>this.l1TxUtils,
509
+ rollupContract: this.rollupContract,
510
+ epochCache: this.epochCache,
511
+ log: this.log.createChild('bundle-simulator')
512
+ });
513
+ }
514
+ /**
515
+ * Logs the gas-pricing data of a failed L1 transaction at warn — so underpricing is diagnosable
516
+ * from logs even with no failed-tx store configured — and backs the record up to the store when
517
+ * one is. When captureFeeSummary is true, also records the fee data of the already-mined L1
518
+ * blocks in the target slot's inclusion window.
519
+ */ backupFailedTx(failedTx, opts) {
520
+ const tx = {
521
+ ...failedTx,
522
+ timestamp: Date.now()
523
+ };
524
+ // Fire and forget - don't block on backup
525
+ void (async ()=>{
526
+ try {
527
+ // Prefer a pre-captured summary (shared across a batch of failures in the same slot) so we
528
+ // don't re-read the fee window per record. A capture error must not lose the record itself.
529
+ const feeSummary = opts?.sharedFeeSummary ?? (opts?.captureFeeSummary ? await this.captureFeeEnvironment(opts.targetSlot).catch(()=>undefined) : undefined);
530
+ if (feeSummary) {
531
+ tx.gasInfo = {
532
+ ...tx.gasInfo,
533
+ ...feeSummary
534
+ };
535
+ }
536
+ if (tx.gasInfo) {
537
+ this.log.warn(`Gas pricing data for failed L1 tx (${tx.failureType})`, {
538
+ failureType: tx.failureType,
539
+ actions: tx.context.actions,
540
+ slot: tx.context.slot,
541
+ ...tx.gasInfo,
542
+ ...tx.timing
543
+ });
544
+ }
545
+ const store = await this.failedTxStore;
546
+ if (store) {
547
+ await store.saveFailedTx(tx);
548
+ }
549
+ } catch (err) {
550
+ this.log.warn(`Failed to backup failed L1 tx to store`, err);
551
+ }
552
+ })();
553
+ }
554
+ /**
555
+ * Captures per-block fee data for the L1 blocks in the target slot's inclusion window (the blocks the
556
+ * tx could have landed in) for underpricing diagnostics. Reads only already-mined blocks, so it never
557
+ * waits on the chain. Safe to call off the critical path: the underlying capture never throws, and this
558
+ * returns undefined when there is no target slot or the window is not yet mined (e.g. an early send
559
+ * failure), in which case the record simply carries no window data.
560
+ */ async captureFeeEnvironment(targetL2Slot) {
561
+ if (targetL2Slot === undefined) {
562
+ return undefined;
563
+ }
564
+ const l1Constants = this.epochCache.getL1Constants();
565
+ // The inclusion window is [start of slot N, start of slot N+1): all L1 blocks that can include a tx
566
+ // for this L2 slot. getTimestampForSlot returns seconds, matching block.timestamp.
567
+ const windowStartS = getTimestampForSlot(targetL2Slot, l1Constants);
568
+ const windowEndS = getTimestampForSlot(SlotNumber(Number(targetL2Slot) + 1), l1Constants);
569
+ const windowBlocks = await captureWindowBlockFees(this.l1TxUtils.client, windowStartS, windowEndS);
570
+ if (windowBlocks.length === 0) {
571
+ return undefined;
572
+ }
573
+ return {
574
+ windowBlocks
575
+ };
576
+ }
577
+ /** Computes timing info relative to the L2 slot deadline. */ computeTimingInfo(targetL2Slot) {
578
+ if (targetL2Slot === undefined) {
579
+ return undefined;
580
+ }
581
+ const l1Constants = this.epochCache.getL1Constants();
582
+ const slotDeadlineS = getTimestampForSlot(SlotNumber(Number(targetL2Slot) + 1), l1Constants);
583
+ const slotDeadlineMs = Number(slotDeadlineS) * 1000;
584
+ return {
585
+ targetL2Slot: Number(targetL2Slot),
586
+ slotDeadlineTimestampS: slotDeadlineS,
587
+ msUntilSlotDeadline: slotDeadlineMs - this.dateProvider.now()
588
+ };
589
+ }
590
+ /**
591
+ * Builds an id for a synthetic failure record (send-error/timeout) that has no on-chain tx hash.
592
+ * Includes the failure time so each attempt — including retries of the same slot — is stored as its
593
+ * own record rather than overwriting the previous one.
594
+ */ failureRecordId(actions, targetSlot) {
595
+ return keccak256(toHex(`${actions.join(',')}:${targetSlot ?? ''}:${Date.now()}`));
494
596
  }
495
597
  getRollupContract() {
496
598
  return this.rollupContract;
497
599
  }
498
600
  /**
499
601
  * Gets the fee asset price modifier from the oracle.
500
- * Returns 0n if the oracle query fails.
501
- */ getFeeAssetPriceModifier() {
502
- return this.feeAssetPriceOracle.computePriceModifier();
602
+ *
603
+ * @param predictedParentEthPerFeeAssetE12 - Optional predicted parent eth-per-fee-asset (E12).
604
+ * Pipelined proposers should pass the value from the predicted parent fee header so the
605
+ * modifier matches the parent L1 will use when applying it.
606
+ * @returns The fee asset price modifier in basis points, or 0n if the oracle query fails.
607
+ */ getFeeAssetPriceModifier(predictedParentEthPerFeeAssetE12) {
608
+ return this.feeAssetPriceOracle.computePriceModifier(predictedParentEthPerFeeAssetE12);
503
609
  }
504
610
  getSenderAddress() {
505
611
  return this.l1TxUtils.getSenderAddress();
@@ -509,17 +615,11 @@ export class SequencerPublisher {
509
615
  */ getL1FeeAnalyzer() {
510
616
  return this.l1FeeAnalyzer;
511
617
  }
512
- /**
513
- * Sets the proposer address to use for simulations in fisherman mode.
514
- * @param proposerAddress - The actual proposer's address to use for balance lookups in simulations
515
- */ setProposerAddressForSimulation(proposerAddress) {
516
- this.proposerAddressForSimulation = proposerAddress;
517
- }
518
618
  addRequest(request) {
519
619
  this.requests.push(request);
520
620
  }
521
621
  getCurrentL2Slot() {
522
- return this.epochCache.getEpochAndSlotNow().slot;
622
+ return this.epochCache.getSlotNow();
523
623
  }
524
624
  /**
525
625
  * Clears all pending requests without sending them.
@@ -572,11 +672,15 @@ export class SequencerPublisher {
572
672
  }
573
673
  /**
574
674
  * Sends all requests that are still valid.
675
+ * @param targetSlot - The target L2 slot for this send. When provided (the production path, via
676
+ * sendRequestsAt), it is threaded into bundleSimulate so the block.timestamp override matches
677
+ * the slot the propose is built for. When omitted, falls back to getCurrentL2Slot() for the
678
+ * AutomineSequencer, which publishes synchronously within the current slot.
575
679
  * @returns one of:
576
680
  * - A receipt and stats if the tx succeeded
577
681
  * - a receipt and errorMsg if it failed on L1
578
682
  * - undefined if no valid requests are found OR the tx failed to send.
579
- */ async sendRequests() {
683
+ */ async sendRequests(targetSlot) {
580
684
  const requestsToProcess = [
581
685
  ...this.requests
582
686
  ];
@@ -584,10 +688,9 @@ export class SequencerPublisher {
584
688
  if (this.interrupted || requestsToProcess.length === 0) {
585
689
  return undefined;
586
690
  }
587
- const currentL2Slot = this.getCurrentL2Slot();
691
+ const currentL2Slot = targetSlot ?? this.getCurrentL2Slot();
588
692
  this.log.debug(`Sending requests on L2 slot ${currentL2Slot}`);
589
693
  const validRequests = requestsToProcess.filter((request)=>request.lastValidL2Slot >= currentL2Slot);
590
- const validActions = validRequests.map((x)=>x.action);
591
694
  const expiredActions = requestsToProcess.filter((request)=>request.lastValidL2Slot < currentL2Slot).map((x)=>x.action);
592
695
  if (validRequests.length !== requestsToProcess.length) {
593
696
  this.log.warn(`Some requests were expired for slot ${currentL2Slot}`, {
@@ -605,53 +708,98 @@ export class SequencerPublisher {
605
708
  this.log.debug(`No valid requests to send`);
606
709
  return undefined;
607
710
  }
608
- // @note - we can only have one blob config per bundle
609
- // find requests with gas and blob configs
610
- // See https://github.com/AztecProtocol/aztec-packages/issues/11513
711
+ // Collect earliest txTimeoutAt across all requests.
611
712
  const gasConfigs = validRequests.filter((request)=>request.gasConfig).map((request)=>request.gasConfig);
612
- const blobConfigs = validRequests.filter((request)=>request.blobConfig).map((request)=>request.blobConfig);
613
- if (blobConfigs.length > 1) {
614
- throw new Error('Multiple blob configs found');
615
- }
616
- const blobConfig = blobConfigs[0];
617
- // Merge gasConfigs. Yields the sum of gasLimits, and the earliest txTimeoutAt, or undefined if no gasConfig sets them.
618
- const gasLimits = gasConfigs.map((g)=>g?.gasLimit).filter((g)=>g !== undefined);
619
- let gasLimit = gasLimits.length > 0 ? sumBigint(gasLimits) : undefined; // sum
620
- // Cap at L1 block gas limit so the node accepts the tx ("gas limit too high" otherwise).
621
- const maxGas = MAX_L1_TX_LIMIT;
622
- if (gasLimit !== undefined && gasLimit > maxGas) {
623
- this.log.debug('Capping bundled tx gas limit to L1 max', {
624
- requested: gasLimit,
625
- capped: maxGas
626
- });
627
- gasLimit = maxGas;
628
- }
629
713
  const txTimeoutAts = gasConfigs.map((g)=>g?.txTimeoutAt).filter((g)=>g !== undefined);
630
- const txTimeoutAt = txTimeoutAts.length > 0 ? new Date(Math.min(...txTimeoutAts.map((g)=>g.getTime()))) : undefined; // earliest
631
- const txConfig = {
632
- gasLimit,
633
- txTimeoutAt
634
- };
714
+ const txTimeoutAt = txTimeoutAts.length > 0 ? new Date(Math.min(...txTimeoutAts.map((g)=>g.getTime()))) : undefined;
635
715
  // Sort the requests so that proposals always go first
636
716
  // This ensures the committee gets precomputed correctly
637
717
  validRequests.sort((a, b)=>compareActions(a.action, b.action));
638
718
  try {
719
+ // Bundle-level eth_simulateV1: filters out entries that revert and derives the gasLimit.
720
+ const bundleResult = await this.bundleSimulator.simulate(validRequests, currentL2Slot);
721
+ if (bundleResult.kind === 'aborted') {
722
+ this.logDroppedInSim(bundleResult.droppedRequests);
723
+ void this.backupDroppedInSim(bundleResult.droppedRequests, currentL2Slot).catch((err)=>this.log.error(`Failed to backup requests dropped in simulation`, err));
724
+ return undefined;
725
+ }
726
+ const { requests, droppedRequests, gasLimit } = bundleResult.kind === 'fallback' ? {
727
+ requests: bundleResult.requests,
728
+ droppedRequests: bundleResult.droppedRequests,
729
+ gasLimit: MAX_L1_TX_LIMIT
730
+ } : bundleResult;
731
+ this.logDroppedInSim(droppedRequests);
732
+ // Compute blobConfig from survivors (not original validRequests) so that if the propose
733
+ // entry was dropped by bundleSimulate we don't attach a blob-typed config to a non-blob tx.
734
+ const [blobConfig] = requests.filter((r)=>r.blobConfig).map((r)=>r.blobConfig);
735
+ const txConfig = {
736
+ gasLimit,
737
+ txTimeoutAt
738
+ };
639
739
  this.log.debug('Forwarding transactions', {
640
- validRequests: validRequests.map((request)=>request.action),
740
+ requests: requests.map((request)=>request.action),
641
741
  txConfig
642
742
  });
643
- const result = await Multicall3.forward(validRequests.map((request)=>request.request), this.l1TxUtils, txConfig, blobConfig, this.rollupContract.address, this.log);
644
- const { successfulActions = [], failedActions = [] } = this.callbackBundledTransactions(validRequests, result);
743
+ const result = await this.forwardWithPublisherRotation(requests, txConfig, blobConfig, currentL2Slot);
744
+ if (result === undefined) {
745
+ return undefined;
746
+ }
747
+ const { successfulActions = [], failedActions = [] } = this.callbackBundledTransactions(requests, result);
748
+ const allFailedActions = [
749
+ ...failedActions,
750
+ ...droppedRequests.map((d)=>d.request.action)
751
+ ];
645
752
  return {
646
753
  result,
647
754
  expiredActions,
648
- sentActions: validActions,
755
+ sentActions: requests.map((x)=>x.action),
649
756
  successfulActions,
650
- failedActions
757
+ failedActions: allFailedActions
651
758
  };
652
759
  } catch (err) {
653
760
  const viemError = formatViemError(err);
654
761
  this.log.error(`Failed to publish bundled transactions`, viemError);
762
+ if (err instanceof TimeoutError) {
763
+ const timeoutState = err instanceof L1TxTimeoutError ? err.txState : undefined;
764
+ void (async ()=>{
765
+ // The RPC is likely degraded right after a timeout, so back up without the block number
766
+ // rather than leaking an unhandled rejection.
767
+ const l1BlockNumber = await this.l1TxUtils.getBlockNumber().catch(()=>0n);
768
+ this.backupFailedTx({
769
+ id: this.failureRecordId(validRequests.map((r)=>r.action), currentL2Slot),
770
+ failureType: 'timeout',
771
+ request: {
772
+ to: MULTI_CALL_3_ADDRESS,
773
+ data: '0x'
774
+ },
775
+ l1BlockNumber,
776
+ error: {
777
+ message: viemError.message,
778
+ name: 'TimeoutError'
779
+ },
780
+ context: {
781
+ actions: validRequests.map((r)=>r.action),
782
+ requests: validRequests.filter((r)=>r.request.to !== null).map((r)=>({
783
+ action: r.action,
784
+ to: r.request.to,
785
+ data: r.request.data
786
+ })),
787
+ sender: this.getSenderAddress().toString(),
788
+ slot: Number(currentL2Slot)
789
+ },
790
+ timing: this.computeTimingInfo(currentL2Slot),
791
+ gasInfo: timeoutState ? {
792
+ sentGasPriceLadder: timeoutState.gasPriceHistory,
793
+ attempts: timeoutState.attempts,
794
+ gasLimit: timeoutState.gasLimit,
795
+ nonce: timeoutState.nonce
796
+ } : undefined
797
+ }, {
798
+ captureFeeSummary: true,
799
+ targetSlot: currentL2Slot
800
+ });
801
+ })();
802
+ }
655
803
  return undefined;
656
804
  } finally{
657
805
  try {
@@ -661,61 +809,302 @@ export class SequencerPublisher {
661
809
  }
662
810
  }
663
811
  }
664
- callbackBundledTransactions(requests, result) {
665
- const actionsListStr = requests.map((r)=>r.action).join(', ');
666
- if (result instanceof FormattedViemError) {
667
- this.log.error(`Failed to publish bundled transactions (${actionsListStr})`, result);
668
- return {
669
- failedActions: requests.map((r)=>r.action)
670
- };
671
- } else {
672
- this.log.verbose(`Published bundled transactions (${actionsListStr})`, {
673
- result,
674
- requests: requests.map((r)=>({
675
- ...r,
676
- // Avoid logging large blob data
677
- blobConfig: r.blobConfig ? {
678
- ...r.blobConfig,
679
- blobs: r.blobConfig.blobs.map((b)=>({
680
- size: trimmedBytesLength(b)
681
- }))
682
- } : undefined
683
- }))
812
+ /** Logs entries dropped by bundle simulation as warnings on the publisher's logger. */ logDroppedInSim(dropped) {
813
+ for (const drop of dropped){
814
+ const revertReasonDecoded = drop.revertReason ?? tryDecodeRevertReason(drop.returnData, this.revertDecoderAbi);
815
+ this.log.warn('Bundle entry dropped: action reverted in sim', {
816
+ action: drop.request.action,
817
+ revertReason: revertReasonDecoded ?? drop.returnData,
818
+ revertReasonDecoded,
819
+ returnData: drop.returnData
684
820
  });
685
- const successfulActions = [];
686
- const failedActions = [];
687
- for (const request of requests){
688
- if (request.checkSuccess(request.request, result)) {
689
- successfulActions.push(request.action);
690
- } else {
691
- failedActions.push(request.action);
821
+ }
822
+ }
823
+ /** Backs up entries dropped by bundle simulation, one record per dropped action. */ async backupDroppedInSim(dropped, targetSlot) {
824
+ if (dropped.length === 0) {
825
+ return;
826
+ }
827
+ // Invoked as `void backupDroppedInSim(...)` on the publish path, so it must not throw.
828
+ try {
829
+ const l1BlockNumber = await this.l1TxUtils.getBlockNumber();
830
+ // Every dropped entry failed in the same slot against the same L1 fee conditions, so capture
831
+ // the fee environment once and share it rather than re-reading the window per entry.
832
+ const sharedFeeSummary = await this.captureFeeEnvironment(targetSlot).catch(()=>undefined);
833
+ const timing = this.computeTimingInfo(targetSlot);
834
+ for (const { request: req } of dropped){
835
+ this.backupFailedTx({
836
+ id: keccak256(req.request.data),
837
+ failureType: 'simulation',
838
+ request: {
839
+ to: req.request.to,
840
+ data: req.request.data
841
+ },
842
+ l1BlockNumber,
843
+ error: {
844
+ message: 'Bundle entry dropped: action reverted in sim'
845
+ },
846
+ context: {
847
+ actions: [
848
+ req.action
849
+ ],
850
+ sender: this.getSenderAddress().toString(),
851
+ slot: targetSlot !== undefined ? Number(targetSlot) : undefined
852
+ },
853
+ timing
854
+ }, {
855
+ sharedFeeSummary
856
+ });
857
+ }
858
+ } catch (err) {
859
+ this.log.warn(`Failed to back up dropped-in-sim entries`, err);
860
+ }
861
+ }
862
+ /**
863
+ * Forwards transactions via Multicall3, rotating to the next available publisher if a send
864
+ * failure occurs (i.e. the tx never reached the chain).
865
+ * On-chain reverts and simulation errors are returned as-is without rotation.
866
+ */ async forwardWithPublisherRotation(validRequests, txConfig, blobConfig, targetSlot) {
867
+ if (!txConfig?.gasLimit) {
868
+ throw new Error('gasLimit is required for bundled transactions');
869
+ }
870
+ const txConfigWithGasLimit = txConfig;
871
+ const triedAddresses = [];
872
+ let currentPublisher = this.l1TxUtils;
873
+ while(true){
874
+ if (txConfig.txTimeoutAt && new Date() > txConfig.txTimeoutAt) {
875
+ this.log.warn(`Tx timeout (${txConfig.txTimeoutAt.toISOString()}) elapsed; stopping publisher rotation`, {
876
+ triedAddresses: triedAddresses.map((a)=>a.toString())
877
+ });
878
+ return undefined;
879
+ }
880
+ triedAddresses.push(currentPublisher.getSenderAddress());
881
+ try {
882
+ const result = await Multicall3.forward(validRequests.map((r)=>r.request), currentPublisher, txConfigWithGasLimit, blobConfig, {
883
+ gasLimitRequired: true
884
+ });
885
+ this.l1TxUtils = currentPublisher;
886
+ return result;
887
+ } catch (err) {
888
+ if (err instanceof TimeoutError) {
889
+ throw err;
890
+ }
891
+ if (err instanceof MulticallForwarderRevertedError) {
892
+ this.log.error('Forwarder transaction reverted on-chain; not rotating publisher', err, {
893
+ transactionHash: err.receipt.transactionHash
894
+ });
895
+ this.backupRevertFailure(validRequests, err, currentPublisher, targetSlot);
896
+ return undefined;
897
+ }
898
+ const viemError = formatViemError(err);
899
+ if (!this.getNextPublisher) {
900
+ this.log.error('Failed to publish bundled transactions', viemError);
901
+ this.backupSendFailure(validRequests, viemError, currentPublisher, targetSlot);
902
+ return undefined;
692
903
  }
904
+ this.log.warn(`Publisher ${currentPublisher.getSenderAddress()} failed to send, rotating to next publisher`, viemError);
905
+ const nextPublisher = await this.getNextPublisher([
906
+ ...triedAddresses
907
+ ]);
908
+ if (!nextPublisher) {
909
+ this.log.error(`All available publishers exhausted (tried ${triedAddresses.length}), failed to publish bundled transactions`, viemError, {
910
+ triedAddresses: triedAddresses.map((a)=>a.toString())
911
+ });
912
+ this.backupSendFailure(validRequests, viemError, currentPublisher, targetSlot);
913
+ return undefined;
914
+ }
915
+ currentPublisher = nextPublisher;
916
+ }
917
+ }
918
+ }
919
+ /** Backs up an on-chain revert failure to the failed tx store. */ backupRevertFailure(requests, err, publisher, targetSlot) {
920
+ this.backupFailedTx({
921
+ id: err.receipt.transactionHash,
922
+ failureType: 'revert',
923
+ request: {
924
+ to: MULTI_CALL_3_ADDRESS,
925
+ data: '0x'
926
+ },
927
+ l1BlockNumber: err.receipt.blockNumber,
928
+ receipt: {
929
+ transactionHash: err.receipt.transactionHash,
930
+ blockNumber: err.receipt.blockNumber,
931
+ gasUsed: err.receipt.gasUsed,
932
+ status: 'reverted'
933
+ },
934
+ error: {
935
+ message: err.message,
936
+ name: err.name
937
+ },
938
+ context: {
939
+ actions: requests.map((r)=>r.action),
940
+ requests: requests.filter((r)=>r.request.to !== null).map((r)=>({
941
+ action: r.action,
942
+ to: r.request.to,
943
+ data: r.request.data
944
+ })),
945
+ sender: publisher.getSenderAddress().toString(),
946
+ slot: targetSlot !== undefined ? Number(targetSlot) : undefined
947
+ },
948
+ gasInfo: err.txState ? {
949
+ sentGasPrice: err.txState.gasPrice,
950
+ gasLimit: err.txState.gasLimit,
951
+ nonce: err.txState.nonce
952
+ } : undefined,
953
+ timing: this.computeTimingInfo(targetSlot)
954
+ }, {
955
+ captureFeeSummary: true,
956
+ targetSlot
957
+ });
958
+ }
959
+ /** Backs up a send failure (tx never reached chain) to the failed tx store. */ backupSendFailure(requests, error, publisher, targetSlot) {
960
+ // If we can't get the block number, still back up without it.
961
+ void this.l1TxUtils.getBlockNumber().catch(()=>0n).then((l1BlockNumber)=>{
962
+ this.backupFailedTx({
963
+ id: this.failureRecordId(requests.map((r)=>r.action), targetSlot),
964
+ failureType: 'send-error',
965
+ request: {
966
+ to: MULTI_CALL_3_ADDRESS,
967
+ data: '0x'
968
+ },
969
+ l1BlockNumber,
970
+ error: {
971
+ message: error.message,
972
+ name: 'name' in error ? error.name : undefined
973
+ },
974
+ context: {
975
+ actions: requests.map((r)=>r.action),
976
+ requests: requests.filter((r)=>r.request.to !== null).map((r)=>({
977
+ action: r.action,
978
+ to: r.request.to,
979
+ data: r.request.data
980
+ })),
981
+ sender: publisher.getSenderAddress().toString(),
982
+ slot: targetSlot !== undefined ? Number(targetSlot) : undefined
983
+ },
984
+ timing: this.computeTimingInfo(targetSlot)
985
+ }, {
986
+ captureFeeSummary: true,
987
+ targetSlot
988
+ });
989
+ });
990
+ }
991
+ /*
992
+ * Schedules sending all enqueued requests at (or after) the start of the given L2 slot.
993
+ */ async sendRequestsAt(targetSlot) {
994
+ await this.waitForTargetSlot(targetSlot);
995
+ if (this.interrupted) {
996
+ return undefined;
997
+ }
998
+ return this.sendRequests(targetSlot);
999
+ }
1000
+ /**
1001
+ * Sleeps until one L1 slot before the L2 slot boundary, and then waits for that L1 block
1002
+ * to be mined, so we don't risk being included in it. If that block never gets mined after
1003
+ * a timeout, we assume it got skipped on L1, so we send the tx anyway.
1004
+ */ async waitForTargetSlot(targetSlot) {
1005
+ const l1Constants = this.epochCache.getL1Constants();
1006
+ const nowInSeconds = this.dateProvider.nowInSeconds();
1007
+ const startOfTargetSlotTs = getTimestampForSlot(targetSlot, l1Constants);
1008
+ const previousL1BlockTs = startOfTargetSlotTs - this.ethereumSlotDuration;
1009
+ const waitDeadlineTs = previousL1BlockTs + BigInt(this.previousL1BlockWaitTimeoutMs / 1000);
1010
+ const logCtx = {
1011
+ targetSlot,
1012
+ startOfTargetSlotTs,
1013
+ nowInSeconds,
1014
+ previousL1BlockTs,
1015
+ waitDeadlineTs
1016
+ };
1017
+ // Check if we are already past time
1018
+ if (nowInSeconds >= startOfTargetSlotTs) {
1019
+ this.log.verbose(`Target slot ${targetSlot} already started, sending requests immediately`, logCtx);
1020
+ return;
1021
+ }
1022
+ // Otherwise we wait
1023
+ this.log.debug(`Waiting for slot ${targetSlot} before sending requests`, logCtx);
1024
+ // Wait until previous L1 block timestamp first
1025
+ const sleepMs = (Number(previousL1BlockTs) - nowInSeconds) * 1000;
1026
+ if (sleepMs > 0 && !this.interrupted) {
1027
+ this.log.trace(`Sleeping ${sleepMs}ms before waiting for previous L1 block`, logCtx);
1028
+ await this.interruptibleSleep.sleep(sleepMs);
1029
+ }
1030
+ // Then loop until we see the previous L1 block, so we know that we cannot be included in it.
1031
+ // We time out after a while, once we are sure that that block is skipped in L1.
1032
+ while(!this.interrupted){
1033
+ try {
1034
+ const nowInSeconds = this.dateProvider.nowInSeconds();
1035
+ logCtx.nowInSeconds = nowInSeconds;
1036
+ if (nowInSeconds >= waitDeadlineTs) {
1037
+ this.log.warn(`Timed out waiting for previous L1 block before sending requests, proceeding`, logCtx);
1038
+ return;
1039
+ }
1040
+ const latestBlockTs = await this.l1TxUtils.getBlock().then((b)=>b.timestamp);
1041
+ if (latestBlockTs >= previousL1BlockTs) {
1042
+ this.log.debug(`Previous L1 block mined, proceeding to send requests`, {
1043
+ ...logCtx,
1044
+ latestBlockTs
1045
+ });
1046
+ return;
1047
+ }
1048
+ this.log.trace(`Previous L1 block not mined yet, continuing to wait`, {
1049
+ ...logCtx,
1050
+ latestBlockTs
1051
+ });
1052
+ } catch (err) {
1053
+ this.log.error(`Error while waiting for previous L1 block before sending requests; retrying`, err, logCtx);
1054
+ } finally{
1055
+ await this.interruptibleSleep.sleep(this.previousL1BlockWaitPollIntervalMs);
693
1056
  }
694
- return {
695
- successfulActions,
696
- failedActions
697
- };
698
1057
  }
699
1058
  }
1059
+ callbackBundledTransactions(requests, result) {
1060
+ const actionsListStr = requests.map((r)=>r.action).join(', ');
1061
+ this.log.verbose(`Published bundled transactions (${actionsListStr})`, {
1062
+ result,
1063
+ requests: requests.map((r)=>({
1064
+ ...r,
1065
+ // Avoid logging large blob data
1066
+ blobConfig: r.blobConfig ? {
1067
+ ...r.blobConfig,
1068
+ blobs: r.blobConfig.blobs.map((b)=>({
1069
+ size: trimmedBytesLength(b)
1070
+ }))
1071
+ } : undefined
1072
+ }))
1073
+ });
1074
+ const successfulActions = [];
1075
+ const failedActions = [];
1076
+ for (const request of requests){
1077
+ if (request.checkSuccess(request.request, result)) {
1078
+ successfulActions.push(request.action);
1079
+ } else {
1080
+ failedActions.push(request.action);
1081
+ }
1082
+ }
1083
+ return {
1084
+ successfulActions,
1085
+ failedActions
1086
+ };
1087
+ }
700
1088
  /**
701
1089
  * @notice Will call `canProposeAt` to make sure that it is possible to propose
702
1090
  * @param tipArchive - The archive to check
703
1091
  * @returns The slot and block number if it is possible to propose, undefined otherwise
704
- */ canProposeAt(tipArchive, msgSender, opts = {}) {
1092
+ */ async canProposeAt(tipArchive, msgSender, simulationOverridesPlan) {
705
1093
  // TODO: #14291 - should loop through multiple keys to check if any of them can propose
706
- const ignoredErrors = [
1094
+ // These errors are expected when we cannot actually propose right now — usually because our
1095
+ // local view of the chain is ahead of L1 (proposed parent hasn't landed yet, or someone
1096
+ // else has just landed the slot, or the archive override doesn't match). We log a warn and
1097
+ // skip the proposal; we do NOT treat these as bugs.
1098
+ const expectedErrors = [
707
1099
  'SlotAlreadyInChain',
708
1100
  'InvalidProposer',
709
1101
  'InvalidArchive'
710
1102
  ];
711
- const pipelined = opts.pipelined ?? false;
712
- const slotOffset = pipelined ? this.aztecSlotDuration : 0n;
1103
+ const slotOffset = this.aztecSlotDuration;
713
1104
  const nextL1SlotTs = this.getNextL1SlotTimestamp() + slotOffset;
714
- return this.rollupContract.canProposeAt(tipArchive.toBuffer(), msgSender.toString(), nextL1SlotTs, {
715
- forcePendingCheckpointNumber: opts.forcePendingCheckpointNumber
716
- }).catch((err)=>{
717
- if (err instanceof FormattedViemError && ignoredErrors.find((e)=>err.message.includes(e))) {
718
- this.log.warn(`Failed canProposeAtTime check with ${ignoredErrors.find((e)=>err.message.includes(e))}`, {
1105
+ return this.rollupContract.canProposeAt(tipArchive.toBuffer(), msgSender.toString(), nextL1SlotTs, await buildSimulationOverridesStateOverride(this.rollupContract, simulationOverridesPlan)).catch((err)=>{
1106
+ if (err instanceof FormattedViemError && expectedErrors.find((e)=>err.message.includes(e))) {
1107
+ this.log.warn(`Failed canProposeAtTime check with ${expectedErrors.find((e)=>err.message.includes(e))}`, {
719
1108
  error: err.message
720
1109
  });
721
1110
  } else {
@@ -729,22 +1118,23 @@ export class SequencerPublisher {
729
1118
  * @dev This is a convenience function that can be used by the sequencer to validate a "partial" header.
730
1119
  * It will throw if the block header is invalid.
731
1120
  * @param header - The block header to validate
732
- */ async validateBlockHeader(header, opts) {
1121
+ */ async validateBlockHeader(header, simulationOverridesPlan) {
733
1122
  const flags = {
734
1123
  ignoreDA: true,
735
1124
  ignoreSignatures: true
736
1125
  };
737
1126
  const args = [
738
1127
  header.toViem(),
739
- CommitteeAttestationsAndSigners.empty().getPackedAttestations(),
1128
+ CommitteeAttestationsAndSigners.packAttestations([]),
740
1129
  [],
741
1130
  Signature.empty().toViemSignature(),
742
1131
  `0x${'0'.repeat(64)}`,
743
1132
  header.blobsHash.toString(),
744
1133
  flags
745
1134
  ];
746
- const ts = this.getSimulationTimestamp(header.slotNumber);
747
- const stateOverrides = await this.rollupContract.makePendingCheckpointNumberOverride(opts?.forcePendingCheckpointNumber);
1135
+ const l1Constants = this.epochCache.getL1Constants();
1136
+ const ts = getLastL1SlotTimestampForL2Slot(header.slotNumber, l1Constants);
1137
+ const stateOverrides = await buildSimulationOverridesStateOverride(this.rollupContract, simulationOverridesPlan);
748
1138
  let balance = 0n;
749
1139
  if (this.config.fishermanMode) {
750
1140
  // In fisherman mode, we can't know where the proposer is publishing from
@@ -796,6 +1186,7 @@ export class SequencerPublisher {
796
1186
  ...logData,
797
1187
  request
798
1188
  });
1189
+ const l1BlockNumber = await this.l1TxUtils.getBlockNumber();
799
1190
  try {
800
1191
  const { gasUsed } = await this.l1TxUtils.simulate(request, undefined, undefined, mergeAbis([
801
1192
  request.abi ?? [],
@@ -811,6 +1202,7 @@ export class SequencerPublisher {
811
1202
  gasUsed,
812
1203
  checkpointNumber,
813
1204
  forcePendingCheckpointNumber: CheckpointNumber(checkpointNumber - 1),
1205
+ lastArchive: validationResult.checkpoint.lastArchive,
814
1206
  reason
815
1207
  };
816
1208
  } catch (err) {
@@ -823,8 +1215,8 @@ export class SequencerPublisher {
823
1215
  request,
824
1216
  error: viemError.message
825
1217
  });
826
- const latestPendingCheckpointNumber = await this.rollupContract.getCheckpointNumber();
827
- if (latestPendingCheckpointNumber < checkpointNumber) {
1218
+ const latestProposedCheckpointNumber = await this.rollupContract.getCheckpointNumber();
1219
+ if (latestProposedCheckpointNumber < checkpointNumber) {
828
1220
  this.log.verbose(`Checkpoint ${checkpointNumber} has already been invalidated`, {
829
1221
  ...logData
830
1222
  });
@@ -838,6 +1230,31 @@ export class SequencerPublisher {
838
1230
  }
839
1231
  // Otherwise, throw. We cannot build the next checkpoint if we cannot invalidate the previous one.
840
1232
  this.log.error(`Simulation for invalidate checkpoint ${checkpointNumber} failed`, viemError, logData);
1233
+ this.backupFailedTx({
1234
+ id: keccak256(request.data),
1235
+ failureType: 'simulation',
1236
+ request: {
1237
+ to: request.to,
1238
+ data: request.data,
1239
+ value: request.value
1240
+ },
1241
+ l1BlockNumber,
1242
+ error: {
1243
+ message: viemError.message,
1244
+ name: viemError.name
1245
+ },
1246
+ context: {
1247
+ actions: [
1248
+ `invalidate-${reason}`
1249
+ ],
1250
+ checkpointNumber,
1251
+ sender: this.getSenderAddress().toString()
1252
+ },
1253
+ timing: this.computeTimingInfo(this.getCurrentL2Slot())
1254
+ }, {
1255
+ captureFeeSummary: true,
1256
+ targetSlot: this.getCurrentL2Slot()
1257
+ });
841
1258
  throw new Error(`Failed to simulate invalidate checkpoint ${checkpointNumber}`, {
842
1259
  cause: viemError
843
1260
  });
@@ -853,7 +1270,11 @@ export class SequencerPublisher {
853
1270
  reason
854
1271
  };
855
1272
  this.log.debug(`Building invalidate checkpoint ${checkpoint.checkpointNumber} request`, logData);
856
- const attestationsAndSigners = new CommitteeAttestationsAndSigners(validationResult.attestations).getPackedAttestations();
1273
+ // Use the exact packed tuple posted to L1 verbatim. A repack via `packAttestations` is not a
1274
+ // byte-faithful inverse of `fromPacked` (a canonicalized yParity byte or an all-zero signature slot
1275
+ // round-trips differently), so it would diverge from the stored `attestationsHash` and revert the
1276
+ // invalidation.
1277
+ const attestationsAndSigners = validationResult.verbatimAttestations;
857
1278
  if (reason === 'invalid-attestation') {
858
1279
  return this.rollupContract.buildInvalidateBadAttestationRequest(checkpoint.checkpointNumber, attestationsAndSigners, committee, validationResult.invalidIndex);
859
1280
  } else if (reason === 'insufficient-attestations') {
@@ -863,25 +1284,6 @@ export class SequencerPublisher {
863
1284
  throw new Error(`Unknown reason for invalidation`);
864
1285
  }
865
1286
  }
866
- /** Simulates `propose` to make sure that the checkpoint is valid for submission */ async validateCheckpointForSubmission(checkpoint, attestationsAndSigners, attestationsAndSignersSignature, options) {
867
- const blobFields = checkpoint.toBlobFields();
868
- const blobs = await getBlobsPerL1Block(blobFields);
869
- const blobInput = getPrefixedEthBlobCommitments(blobs);
870
- const args = [
871
- {
872
- header: checkpoint.header.toViem(),
873
- archive: toHex(checkpoint.archive.root.toBuffer()),
874
- oracleInput: {
875
- feeAssetPriceModifier: checkpoint.feeAssetPriceModifier
876
- }
877
- },
878
- attestationsAndSigners.getPackedAttestations(),
879
- attestationsAndSigners.getSigners().map((signer)=>signer.toString()),
880
- attestationsAndSignersSignature.toViemSignature(),
881
- blobInput
882
- ];
883
- await this.simulateProposeTx(args, options);
884
- }
885
1287
  async enqueueCastSignalHelper(slotNumber, signalType, payload, base, signerAddress, signer) {
886
1288
  if (this.lastActions[signalType] && this.lastActions[signalType] === slotNumber) {
887
1289
  this.log.debug(`Skipping duplicate vote cast signal ${signalType} for slot ${slotNumber}`);
@@ -902,30 +1304,26 @@ export class SequencerPublisher {
902
1304
  if (roundInfo.lastSignalSlot >= slotNumber) {
903
1305
  return false;
904
1306
  }
905
- if (await this.isPayloadEmpty(payload)) {
1307
+ if (await base.isPayloadEmpty(payload)) {
906
1308
  this.log.warn(`Skipping vote cast for payload with empty code`);
907
1309
  return false;
908
1310
  }
909
- // Check if payload was already submitted to governance
910
- const cacheKey = payload.toString();
911
- if (!this.payloadProposedCache.has(cacheKey)) {
912
- try {
913
- const l1StartBlock = await this.rollupContract.getL1StartBlock();
914
- const proposed = await retry(()=>base.hasPayloadBeenProposed(payload.toString(), l1StartBlock), 'Check if payload was proposed', makeBackoff([
915
- 0,
916
- 1,
917
- 2
918
- ]), this.log, true);
919
- if (proposed) {
920
- this.payloadProposedCache.add(cacheKey);
921
- }
922
- } catch (err) {
923
- this.log.warn(`Failed to check if payload ${payload} was proposed after retries, skipping signal`, err);
924
- return false;
925
- }
1311
+ // Skip signaling if there is already a live (non-terminal) Governance proposal for this
1312
+ // payload. This is intentionally not cached: a previously-live proposal may transition to
1313
+ // a terminal state (Dropped/Rejected/Expired/Executed), at which point we may want to re-signal
1314
+ // the same payload in a future round.
1315
+ let proposed = false;
1316
+ try {
1317
+ proposed = await base.hasActiveProposalWithPayload(payload.toString());
1318
+ } catch (err) {
1319
+ // We deliberately swallow the error and proceed to signal. Failing closed (skipping the
1320
+ // signal) on transient RPC errors would let a flaky L1 endpoint silence governance
1321
+ // participation entirely; failing open at worst produces a duplicate signal that the
1322
+ // contract will simply count alongside others in the round.
1323
+ this.log.error(`Failed to check if payload ${payload} was already proposed (signalling anyway)`, err);
926
1324
  }
927
- if (this.payloadProposedCache.has(cacheKey)) {
928
- this.log.info(`Payload ${payload} was already proposed to governance, stopping signals`);
1325
+ if (proposed) {
1326
+ this.log.info(`Payload ${payload} has a live governance proposal, stopping signals`);
929
1327
  return false;
930
1328
  }
931
1329
  const cachedLastVote = this.lastActions[signalType];
@@ -938,34 +1336,17 @@ export class SequencerPublisher {
938
1336
  signer: this.l1TxUtils.client.account?.address,
939
1337
  lastValidL2Slot: slotNumber
940
1338
  });
941
- const timestamp = this.getSimulationTimestamp(slotNumber);
942
- try {
943
- await this.l1TxUtils.simulate(request, {
944
- time: timestamp
945
- }, [], mergeAbis([
946
- request.abi ?? [],
947
- ErrorsAbi
948
- ]));
949
- this.log.debug(`Simulation for ${action} at slot ${slotNumber} succeeded`, {
950
- request
951
- });
952
- } catch (err) {
953
- const viemError = formatViemError(err);
954
- this.log.error(`Failed simulation for ${action} at slot ${slotNumber} (enqueuing the action anyway)`, viemError, {
955
- simulationTimestamp: timestamp
956
- });
957
- // Yes, we enqueue the request anyway, in case there was a bug with the simulation itself
958
- }
959
1339
  // TODO(palla/slash): All votes (governance and slashing) should txTimeoutAt at the end of the slot.
960
1340
  this.addRequest({
961
- gasConfig: {
962
- gasLimit: SequencerPublisher.VOTE_GAS_GUESS
963
- },
964
1341
  action,
965
1342
  request,
966
1343
  lastValidL2Slot: slotNumber,
967
1344
  checkSuccess: (_request, result)=>{
968
- const success = result && result.receipt && result.receipt.status === 'success' && tryExtractEvent(result.receipt.logs, base.address.toString(), EmpireBaseAbi, 'SignalCast');
1345
+ const success = result && extractEventSuccess(result.receipt, {
1346
+ address: base.address.toString(),
1347
+ abi: EmpireBaseAbi,
1348
+ eventName: 'SignalCast'
1349
+ });
969
1350
  const logData = {
970
1351
  ...result,
971
1352
  slotNumber,
@@ -984,16 +1365,6 @@ export class SequencerPublisher {
984
1365
  });
985
1366
  return true;
986
1367
  }
987
- async isPayloadEmpty(payload) {
988
- const key = payload.toString();
989
- const cached = this.isPayloadEmptyCache.get(key);
990
- if (cached) {
991
- return cached;
992
- }
993
- const isEmpty = !await this.l1TxUtils.getCode(payload);
994
- this.isPayloadEmptyCache.set(key, isEmpty);
995
- return isEmpty;
996
- }
997
1368
  /**
998
1369
  * Enqueues a governance castSignal transaction to cast a signal for a given slot number.
999
1370
  * @param slotNumber - The slot number to cast a signal for.
@@ -1001,6 +1372,56 @@ export class SequencerPublisher {
1001
1372
  */ enqueueGovernanceCastSignal(governancePayload, slotNumber, signerAddress, signer) {
1002
1373
  return this.enqueueCastSignalHelper(slotNumber, 'governance-signal', governancePayload, this.govProposerContract, signerAddress, signer);
1003
1374
  }
1375
+ /**
1376
+ * Enqueues a `prune()` transaction if the rollup is prunable at the given slot's L1 timestamp.
1377
+ * `prune()` is permissionless and idempotent — if the chain is no longer prunable by send time the
1378
+ * bundle simulation usually drops the entry; on a node without `eth_simulateV1` the bundle is sent
1379
+ * as-is and the prune reverts `Rollup__NothingToPrune` inside `aggregate3(allowFailure: true)`
1380
+ * (a failed action, never a whole-tx revert). Used by the failed-sync fallback so a stuck pending
1381
+ * chain (e.g. bad data blocking sync) can be wound back to recover.
1382
+ * @returns true if a prune request was enqueued, false otherwise.
1383
+ */ async enqueuePruneIfPrunable(slotNumber) {
1384
+ if (this.lastActions['prune'] === slotNumber) {
1385
+ this.log.debug(`Skipping duplicate prune for slot ${slotNumber}`, {
1386
+ slotNumber
1387
+ });
1388
+ return false;
1389
+ }
1390
+ // Use the SAME timestamp the bundle simulator overrides block.timestamp with at send time
1391
+ // (sequencer-bundle-simulator.ts) so this upfront check and the send-time sim agree. Slot-start
1392
+ // and last-L1-slot both fall within the same L2 slot (and epoch, which is what `canPruneAtTime`
1393
+ // derives), so they agree today; matching the simulator keeps it robust if the contract ever uses
1394
+ // the timestamp more granularly.
1395
+ const ts = getLastL1SlotTimestampForL2Slot(slotNumber, this.epochCache.getL1Constants());
1396
+ const canPrune = await this.rollupContract.canPruneAtTime(ts).catch((err)=>{
1397
+ this.log.error(`Failed to check canPruneAtTime for slot ${slotNumber}`, err, {
1398
+ slotNumber
1399
+ });
1400
+ return false;
1401
+ });
1402
+ if (!canPrune) {
1403
+ this.log.debug(`Rollup not prunable at slot ${slotNumber}`, {
1404
+ slotNumber
1405
+ });
1406
+ return false;
1407
+ }
1408
+ const request = {
1409
+ to: this.rollupContract.address,
1410
+ data: encodeFunctionData({
1411
+ abi: RollupAbi,
1412
+ functionName: 'prune',
1413
+ args: []
1414
+ })
1415
+ };
1416
+ this.log.info(`Enqueuing rollup prune for slot ${slotNumber}`, {
1417
+ slotNumber
1418
+ });
1419
+ return this.enqueueRequest('prune', request, {
1420
+ address: this.rollupContract.address,
1421
+ abi: RollupAbi,
1422
+ eventName: 'PrunedPending'
1423
+ }, slotNumber);
1424
+ }
1004
1425
  /** Enqueues all slashing actions as returned by the slasher client. */ async enqueueSlashingActions(actions, slotNumber, signerAddress, signer) {
1005
1426
  if (actions.length === 0) {
1006
1427
  this.log.debug(`No slashing actions to enqueue for slot ${slotNumber}`);
@@ -1008,43 +1429,6 @@ export class SequencerPublisher {
1008
1429
  }
1009
1430
  for (const action of actions){
1010
1431
  switch(action.type){
1011
- case 'vote-empire-payload':
1012
- {
1013
- if (this.slashingProposerContract?.type !== 'empire') {
1014
- this.log.error('Cannot vote for empire payload on non-empire slashing contract');
1015
- break;
1016
- }
1017
- this.log.debug(`Enqueuing slashing vote for payload ${action.payload} at slot ${slotNumber}`, {
1018
- signerAddress
1019
- });
1020
- await this.enqueueCastSignalHelper(slotNumber, 'empire-slashing-signal', action.payload, this.slashingProposerContract, signerAddress, signer);
1021
- break;
1022
- }
1023
- case 'create-empire-payload':
1024
- {
1025
- this.log.debug(`Enqueuing slashing create payload at slot ${slotNumber}`, {
1026
- slotNumber,
1027
- signerAddress
1028
- });
1029
- const request = this.slashFactoryContract.buildCreatePayloadRequest(action.data);
1030
- await this.simulateAndEnqueueRequest('create-empire-payload', request, (receipt)=>!!this.slashFactoryContract.tryExtractSlashPayloadCreatedEvent(receipt.logs), slotNumber);
1031
- break;
1032
- }
1033
- case 'execute-empire-payload':
1034
- {
1035
- this.log.debug(`Enqueuing slashing execute payload at slot ${slotNumber}`, {
1036
- slotNumber,
1037
- signerAddress
1038
- });
1039
- if (this.slashingProposerContract?.type !== 'empire') {
1040
- this.log.error('Cannot execute slashing payload on non-empire slashing contract');
1041
- return false;
1042
- }
1043
- const empireSlashingProposer = this.slashingProposerContract;
1044
- const request = empireSlashingProposer.buildExecuteRoundRequest(action.round);
1045
- await this.simulateAndEnqueueRequest('execute-empire-payload', request, (receipt)=>!!empireSlashingProposer.tryExtractPayloadSubmittedEvent(receipt.logs), slotNumber);
1046
- break;
1047
- }
1048
1432
  case 'vote-offenses':
1049
1433
  {
1050
1434
  this.log.debug(`Enqueuing slashing vote for ${action.votes.length} votes at slot ${slotNumber}`, {
@@ -1053,14 +1437,17 @@ export class SequencerPublisher {
1053
1437
  votesCount: action.votes.length,
1054
1438
  signerAddress
1055
1439
  });
1056
- if (this.slashingProposerContract?.type !== 'tally') {
1057
- this.log.error('Cannot vote for slashing offenses on non-tally slashing contract');
1440
+ if (!this.slashingProposerContract) {
1441
+ this.log.error('No slashing proposer contract available');
1058
1442
  return false;
1059
1443
  }
1060
- const tallySlashingProposer = this.slashingProposerContract;
1061
1444
  const votes = bufferToHex(encodeSlashConsensusVotes(action.votes));
1062
- const request = await tallySlashingProposer.buildVoteRequestFromSigner(votes, slotNumber, signer);
1063
- await this.simulateAndEnqueueRequest('vote-offenses', request, (receipt)=>!!tallySlashingProposer.tryExtractVoteCastEvent(receipt.logs), slotNumber);
1445
+ const request = await this.slashingProposerContract.buildVoteRequestFromSigner(votes, slotNumber, signer);
1446
+ this.enqueueRequest('vote-offenses', request, {
1447
+ address: this.slashingProposerContract.address.toString(),
1448
+ abi: SlashingProposerAbi,
1449
+ eventName: 'VoteCast'
1450
+ }, slotNumber);
1064
1451
  break;
1065
1452
  }
1066
1453
  case 'execute-slash':
@@ -1070,13 +1457,16 @@ export class SequencerPublisher {
1070
1457
  round: action.round,
1071
1458
  signerAddress
1072
1459
  });
1073
- if (this.slashingProposerContract?.type !== 'tally') {
1074
- this.log.error('Cannot execute slashing offenses on non-tally slashing contract');
1460
+ if (!this.slashingProposerContract) {
1461
+ this.log.error('No slashing proposer contract available');
1075
1462
  return false;
1076
1463
  }
1077
- const tallySlashingProposer = this.slashingProposerContract;
1078
- const request = tallySlashingProposer.buildExecuteRoundRequest(action.round, action.committees);
1079
- await this.simulateAndEnqueueRequest('execute-slash', request, (receipt)=>!!tallySlashingProposer.tryExtractRoundExecutedEvent(receipt.logs), slotNumber);
1464
+ const executeRequest = this.slashingProposerContract.buildExecuteRoundRequest(action.round, action.committees);
1465
+ this.enqueueRequest('execute-slash', executeRequest, {
1466
+ address: this.slashingProposerContract.address.toString(),
1467
+ abi: SlashingProposerAbi,
1468
+ eventName: 'RoundExecuted'
1469
+ }, slotNumber);
1080
1470
  break;
1081
1471
  }
1082
1472
  default:
@@ -1088,7 +1478,7 @@ export class SequencerPublisher {
1088
1478
  }
1089
1479
  return true;
1090
1480
  }
1091
- /** Simulates and enqueues a proposal for a checkpoint on L1 */ async enqueueProposeCheckpoint(checkpoint, attestationsAndSigners, attestationsAndSignersSignature, opts = {}) {
1481
+ /** Enqueues a proposal for a checkpoint on L1 */ async enqueueProposeCheckpoint(checkpoint, attestationsAndSigners, attestationsAndSignersSignature, opts = {}) {
1092
1482
  const checkpointHeader = checkpoint.header;
1093
1483
  const blobFields = checkpoint.toBlobFields();
1094
1484
  const blobs = await getBlobsPerL1Block(blobFields);
@@ -1100,51 +1490,38 @@ export class SequencerPublisher {
1100
1490
  attestationsAndSignersSignature,
1101
1491
  feeAssetPriceModifier: checkpoint.feeAssetPriceModifier
1102
1492
  };
1103
- try {
1104
- // @note This will make sure that we are passing the checks for our header ASSUMING that the data is also made available
1105
- // This means that we can avoid the simulation issues in later checks.
1106
- // By simulation issue, I mean the fact that the block.timestamp is equal to the last block, not the next, which
1107
- // make time consistency checks break.
1108
- // TODO(palla): Check whether we're validating twice, once here and once within addProposeTx, since we call simulateProposeTx in both places.
1109
- await this.validateCheckpointForSubmission(checkpoint, attestationsAndSigners, attestationsAndSignersSignature, opts);
1110
- } catch (err) {
1111
- this.log.error(`Checkpoint validation failed. ${err instanceof Error ? err.message : 'No error message'}`, err, {
1112
- ...checkpoint.getStats(),
1113
- slotNumber: checkpoint.header.slotNumber,
1114
- forcePendingCheckpointNumber: opts.forcePendingCheckpointNumber
1115
- });
1116
- throw err;
1117
- }
1118
1493
  this.log.verbose(`Enqueuing checkpoint propose transaction`, {
1119
1494
  ...checkpoint.toCheckpointInfo(),
1120
- ...opts
1495
+ txTimeoutAt: opts.txTimeoutAt
1496
+ });
1497
+ await this.addProposeTx(checkpoint, proposeTxArgs, {
1498
+ txTimeoutAt: opts.txTimeoutAt
1121
1499
  });
1122
- await this.addProposeTx(checkpoint, proposeTxArgs, opts);
1123
1500
  }
1124
1501
  enqueueInvalidateCheckpoint(request, opts = {}) {
1125
1502
  if (!request) {
1126
1503
  return;
1127
1504
  }
1128
- // We issued the simulation against the rollup contract, so we need to account for the overhead of the multicall3
1129
- const gasLimit = this.l1TxUtils.bumpGasLimit(BigInt(Math.ceil(Number(request.gasUsed) * 64 / 63)));
1130
1505
  const { gasUsed, checkpointNumber } = request;
1131
1506
  const logData = {
1132
1507
  gasUsed,
1133
1508
  checkpointNumber,
1134
- gasLimit,
1135
1509
  opts
1136
1510
  };
1137
1511
  this.log.verbose(`Enqueuing invalidate checkpoint request`, logData);
1138
1512
  this.addRequest({
1139
1513
  action: `invalidate-by-${request.reason}`,
1140
1514
  request: request.request,
1141
- gasConfig: {
1142
- gasLimit,
1515
+ gasConfig: opts.txTimeoutAt ? {
1143
1516
  txTimeoutAt: opts.txTimeoutAt
1144
- },
1517
+ } : undefined,
1145
1518
  lastValidL2Slot: SlotNumber(this.getCurrentL2Slot() + 2),
1146
1519
  checkSuccess: (_req, result)=>{
1147
- const success = result && result.receipt && result.receipt.status === 'success' && tryExtractEvent(result.receipt.logs, this.rollupContract.address, RollupAbi, 'CheckpointInvalidated');
1520
+ const success = result && extractEventSuccess(result.receipt, {
1521
+ address: this.rollupContract.address,
1522
+ abi: RollupAbi,
1523
+ eventName: 'CheckpointInvalidated'
1524
+ });
1148
1525
  if (!success) {
1149
1526
  this.log.warn(`Invalidate checkpoint ${request.checkpointNumber} failed`, {
1150
1527
  ...result,
@@ -1160,68 +1537,36 @@ export class SequencerPublisher {
1160
1537
  }
1161
1538
  });
1162
1539
  }
1163
- async simulateAndEnqueueRequest(action, request, checkSuccess, slotNumber) {
1164
- const timestamp = this.getSimulationTimestamp(slotNumber);
1165
- const logData = {
1166
- slotNumber,
1167
- timestamp,
1168
- gasLimit: undefined
1169
- };
1540
+ /**
1541
+ * Dedup-checked enqueue helper for actions that are simulated at bundle-send time rather
1542
+ * than at enqueue time. Validates the (action, slot) dedup key, sets `lastActions`, and
1543
+ * enqueues without a gasLimit so the bundle simulate sets the only gasLimit that matters.
1544
+ */ enqueueRequest(action, request, eventOpts, slotNumber) {
1170
1545
  if (this.lastActions[action] && this.lastActions[action] === slotNumber) {
1171
1546
  this.log.debug(`Skipping duplicate action ${action} for slot ${slotNumber}`);
1172
1547
  return false;
1173
1548
  }
1174
1549
  const cachedLastActionSlot = this.lastActions[action];
1175
1550
  this.lastActions[action] = slotNumber;
1176
- this.log.debug(`Simulating ${action} for slot ${slotNumber}`, logData);
1177
- let gasUsed;
1178
- const simulateAbi = mergeAbis([
1179
- request.abi ?? [],
1180
- ErrorsAbi
1181
- ]);
1182
- try {
1183
- ({ gasUsed } = await this.l1TxUtils.simulate(request, {
1184
- time: timestamp
1185
- }, [], simulateAbi));
1186
- this.log.verbose(`Simulation for ${action} succeeded`, {
1187
- ...logData,
1188
- request,
1189
- gasUsed
1190
- });
1191
- } catch (err) {
1192
- const viemError = formatViemError(err, simulateAbi);
1193
- this.log.error(`Simulation for ${action} at ${slotNumber} failed`, viemError, logData);
1194
- return false;
1195
- }
1196
- // We issued the simulation against the rollup contract, so we need to account for the overhead of the multicall3
1197
- const gasLimit = this.l1TxUtils.bumpGasLimit(BigInt(Math.ceil(Number(gasUsed) * 64 / 63)));
1198
- logData.gasLimit = gasLimit;
1199
- // Store the ABI used for simulation on the request so Multicall3.forward can decode errors
1200
- // when the tx is sent and a revert is diagnosed via simulation.
1201
- const requestWithAbi = {
1202
- ...request,
1203
- abi: simulateAbi
1204
- };
1205
- this.log.debug(`Enqueuing ${action}`, logData);
1551
+ this.log.debug(`Enqueuing ${action}`, {
1552
+ slotNumber
1553
+ });
1206
1554
  this.addRequest({
1207
1555
  action,
1208
- request: requestWithAbi,
1209
- gasConfig: {
1210
- gasLimit
1211
- },
1556
+ request,
1212
1557
  lastValidL2Slot: slotNumber,
1213
- checkSuccess: (_req, result)=>{
1214
- const success = result && result.receipt && result.receipt.status === 'success' && checkSuccess(result.receipt);
1558
+ checkSuccess: (_request, result)=>{
1559
+ const success = result && extractEventSuccess(result.receipt, eventOpts);
1215
1560
  if (!success) {
1216
1561
  this.log.warn(`Action ${action} at ${slotNumber} failed`, {
1217
1562
  ...result,
1218
- ...logData
1563
+ slotNumber
1219
1564
  });
1220
1565
  this.lastActions[action] = cachedLastActionSlot;
1221
1566
  } else {
1222
1567
  this.log.info(`Action ${action} at ${slotNumber} succeeded`, {
1223
1568
  ...result,
1224
- ...logData
1569
+ slotNumber
1225
1570
  });
1226
1571
  }
1227
1572
  return !!success;
@@ -1236,13 +1581,14 @@ export class SequencerPublisher {
1236
1581
  * A call to `restart` is required before you can continue publishing.
1237
1582
  */ interrupt() {
1238
1583
  this.interrupted = true;
1584
+ this.interruptibleSleep.interrupt();
1239
1585
  this.l1TxUtils.interrupt();
1240
1586
  }
1241
1587
  /** Restarts the publisher after calling `interrupt`. */ restart() {
1242
1588
  this.interrupted = false;
1243
1589
  this.l1TxUtils.restart();
1244
1590
  }
1245
- async prepareProposeTx(encodedData, options) {
1591
+ async prepareProposeTx(encodedData) {
1246
1592
  const kzg = Blob.getViemKzgInstance();
1247
1593
  const blobInput = getPrefixedEthBlobCommitments(encodedData.blobs);
1248
1594
  this.log.debug('Validating blob input', {
@@ -1256,7 +1602,11 @@ export class SequencerPublisher {
1256
1602
  blobEvaluationGas = BigInt(encodedData.blobs.length) * 21_000n;
1257
1603
  this.log.debug(`Using fixed blob evaluation gas estimate in fisherman mode: ${blobEvaluationGas}`);
1258
1604
  } else {
1259
- // Normal mode - use estimateGas with blob inputs
1605
+ // We call validateBlobs via estimateGas with real blob+kzg sidecars as a consistency check
1606
+ // that our locally-built blob commitments match the blob data. The bundle simulate at send
1607
+ // time uses eth_simulateV1, which cannot carry blob inputs, so the rollup's on-chain blob
1608
+ // check is forced off there — making this the only pre-flight detector of a commitment/data
1609
+ // mismatch. The returned gas estimate is stashed on the request for the bundle path to read.
1260
1610
  blobEvaluationGas = await this.l1TxUtils.estimateGas(this.getSenderAddress().toString(), {
1261
1611
  to: this.rollupContract.address,
1262
1612
  data: encodeFunctionData({
@@ -1269,10 +1619,42 @@ export class SequencerPublisher {
1269
1619
  }, {}, {
1270
1620
  blobs: encodedData.blobs.map((b)=>b.data),
1271
1621
  kzg
1272
- }).catch((err)=>{
1273
- const { message, metaMessages } = formatViemError(err);
1274
- this.log.error(`Failed to validate blobs`, message, {
1275
- metaMessages
1622
+ }).catch(async (err)=>{
1623
+ const viemError = formatViemError(err);
1624
+ this.log.error(`Failed to validate blobs`, viemError.message, {
1625
+ metaMessages: viemError.metaMessages
1626
+ });
1627
+ const validateBlobsData = encodeFunctionData({
1628
+ abi: RollupAbi,
1629
+ functionName: 'validateBlobs',
1630
+ args: [
1631
+ blobInput
1632
+ ]
1633
+ });
1634
+ const l1BlockNumber = await this.l1TxUtils.getBlockNumber();
1635
+ this.backupFailedTx({
1636
+ id: keccak256(validateBlobsData),
1637
+ failureType: 'simulation',
1638
+ request: {
1639
+ to: this.rollupContract.address,
1640
+ data: validateBlobsData
1641
+ },
1642
+ blobData: encodedData.blobs.map((b)=>toHex(b.data)),
1643
+ l1BlockNumber,
1644
+ error: {
1645
+ message: viemError.message,
1646
+ name: viemError.name
1647
+ },
1648
+ context: {
1649
+ actions: [
1650
+ 'validate-blobs'
1651
+ ],
1652
+ sender: this.getSenderAddress().toString()
1653
+ },
1654
+ timing: this.computeTimingInfo(this.getCurrentL2Slot())
1655
+ }, {
1656
+ captureFeeSummary: true,
1657
+ targetSlot: this.getCurrentL2Slot()
1276
1658
  });
1277
1659
  throw new Error('Failed to validate blobs');
1278
1660
  });
@@ -1291,89 +1673,23 @@ export class SequencerPublisher {
1291
1673
  encodedData.attestationsAndSignersSignature.toViemSignature(),
1292
1674
  blobInput
1293
1675
  ];
1294
- const { rollupData, simulationResult } = await this.simulateProposeTx(args, options);
1295
- return {
1296
- args,
1297
- blobEvaluationGas,
1298
- rollupData,
1299
- simulationResult
1300
- };
1301
- }
1302
- /**
1303
- * Simulates the propose tx with eth_simulateV1
1304
- * @param args - The propose tx args
1305
- * @returns The simulation result
1306
- */ async simulateProposeTx(args, options) {
1307
1676
  const rollupData = encodeFunctionData({
1308
1677
  abi: RollupAbi,
1309
1678
  functionName: 'propose',
1310
1679
  args
1311
1680
  });
1312
- // override the pending checkpoint number if requested
1313
- const forcePendingCheckpointNumberStateDiff = (options.forcePendingCheckpointNumber !== undefined ? await this.rollupContract.makePendingCheckpointNumberOverride(options.forcePendingCheckpointNumber) : []).flatMap((override)=>override.stateDiff ?? []);
1314
- const stateOverrides = [
1315
- {
1316
- address: this.rollupContract.address,
1317
- // @note we override checkBlob to false since blobs are not part simulate()
1318
- stateDiff: [
1319
- {
1320
- slot: toPaddedHex(RollupContract.checkBlobStorageSlot, true),
1321
- value: toPaddedHex(0n, true)
1322
- },
1323
- ...forcePendingCheckpointNumberStateDiff
1324
- ]
1325
- }
1326
- ];
1327
- // In fisherman mode, simulate as the proposer but with sufficient balance
1328
- if (this.proposerAddressForSimulation) {
1329
- stateOverrides.push({
1330
- address: this.proposerAddressForSimulation.toString(),
1331
- balance: 10n * WEI_CONST * WEI_CONST
1332
- });
1333
- }
1334
- const simTs = this.getSimulationTimestamp(SlotNumber.fromBigInt(args[0].header.slotNumber));
1335
- const simulationResult = await this.l1TxUtils.simulate({
1336
- to: this.rollupContract.address,
1337
- data: rollupData,
1338
- gas: MAX_L1_TX_LIMIT,
1339
- ...this.proposerAddressForSimulation && {
1340
- from: this.proposerAddressForSimulation.toString()
1341
- }
1342
- }, {
1343
- time: simTs,
1344
- // @note reth should have a 30m gas limit per block but throws errors that this tx is beyond limit so we increase here
1345
- gasLimit: MAX_L1_TX_LIMIT * 2n
1346
- }, stateOverrides, RollupAbi, {
1347
- // @note fallback gas estimate to use if the node doesn't support simulation API
1348
- fallbackGasEstimate: MAX_L1_TX_LIMIT
1349
- }).catch((err)=>{
1350
- // In fisherman mode, we expect ValidatorSelection__MissingProposerSignature since fisherman doesn't have proposer signature
1351
- const viemError = formatViemError(err);
1352
- if (this.config.fishermanMode && viemError.message?.includes('ValidatorSelection__MissingProposerSignature')) {
1353
- this.log.debug(`Ignoring expected ValidatorSelection__MissingProposerSignature error in fisherman mode`);
1354
- // Return a minimal simulation result with the fallback gas estimate
1355
- return {
1356
- gasUsed: MAX_L1_TX_LIMIT,
1357
- logs: []
1358
- };
1359
- }
1360
- this.log.error(`Failed to simulate propose tx`, viemError, {
1361
- simulationTimestamp: simTs
1362
- });
1363
- throw err;
1364
- });
1365
1681
  return {
1366
- rollupData,
1367
- simulationResult
1682
+ args,
1683
+ blobEvaluationGas,
1684
+ rollupData
1368
1685
  };
1369
1686
  }
1370
1687
  async addProposeTx(checkpoint, encodedData, opts = {}) {
1371
1688
  const slot = checkpoint.header.slotNumber;
1372
1689
  const timer = new Timer();
1373
1690
  const kzg = Blob.getViemKzgInstance();
1374
- const { rollupData, simulationResult, blobEvaluationGas } = await this.prepareProposeTx(encodedData, opts);
1691
+ const { rollupData, blobEvaluationGas } = await this.prepareProposeTx(encodedData);
1375
1692
  const startBlock = await this.l1TxUtils.getBlockNumber();
1376
- const gasLimit = this.l1TxUtils.bumpGasLimit(BigInt(Math.ceil(Number(simulationResult.gasUsed) * 64 / 63)) + blobEvaluationGas + SequencerPublisher.MULTICALL_OVERHEAD_GAS_GUESS);
1377
1693
  // Send the blobs to the blob client preemptively. This helps in tests where the sequencer mistakingly thinks that the propose
1378
1694
  // tx fails but it does get mined. We make sure that the blobs are sent to the blob client regardless of the tx outcome.
1379
1695
  void Promise.resolve().then(()=>this.blobClient.sendBlobsToFilestore(encodedData.blobs).catch((_err)=>{
@@ -1387,9 +1703,10 @@ export class SequencerPublisher {
1387
1703
  },
1388
1704
  lastValidL2Slot: checkpoint.header.slotNumber,
1389
1705
  gasConfig: {
1390
- ...opts,
1391
- gasLimit
1706
+ txTimeoutAt: opts.txTimeoutAt,
1707
+ gasLimit: undefined
1392
1708
  },
1709
+ blobEvaluationGas,
1393
1710
  blobConfig: {
1394
1711
  blobs: encodedData.blobs.map((b)=>b.data),
1395
1712
  kzg
@@ -1399,7 +1716,11 @@ export class SequencerPublisher {
1399
1716
  return false;
1400
1717
  }
1401
1718
  const { receipt, stats, errorMsg } = result;
1402
- const success = receipt && receipt.status === 'success' && tryExtractEvent(receipt.logs, this.rollupContract.address, RollupAbi, 'CheckpointProposed');
1719
+ const success = extractEventSuccess(receipt, {
1720
+ address: this.rollupContract.address,
1721
+ abi: RollupAbi,
1722
+ eventName: 'CheckpointProposed'
1723
+ });
1403
1724
  if (success) {
1404
1725
  const endBlock = receipt.blockNumber;
1405
1726
  const inclusionBlocks = Number(endBlock - startBlock);
@@ -1436,11 +1757,6 @@ export class SequencerPublisher {
1436
1757
  }
1437
1758
  });
1438
1759
  }
1439
- /** Returns the timestamp of the last L1 slot within a given L2 slot. Used as the simulation timestamp
1440
- * for eth_simulateV1 calls, since it's guaranteed to be greater than any L1 block produced during the slot. */ getSimulationTimestamp(slot) {
1441
- const l1Constants = this.epochCache.getL1Constants();
1442
- return getLastL1SlotTimestampForL2Slot(slot, l1Constants);
1443
- }
1444
1760
  /** Returns the timestamp of the next L1 slot boundary after now. */ getNextL1SlotTimestamp() {
1445
1761
  const l1Constants = this.epochCache.getL1Constants();
1446
1762
  return getNextL1SlotTimestamp(this.dateProvider.nowInSeconds(), l1Constants);