@aztec/sequencer-client 0.0.1-commit.d431d1c → 0.0.1-commit.d58ff9d0

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 (133) hide show
  1. package/README.md +281 -21
  2. package/dest/client/sequencer-client.d.ts +34 -11
  3. package/dest/client/sequencer-client.d.ts.map +1 -1
  4. package/dest/client/sequencer-client.js +77 -39
  5. package/dest/config.d.ts +32 -6
  6. package/dest/config.d.ts.map +1 -1
  7. package/dest/config.js +94 -48
  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 +13 -28
  15. package/dest/global_variable_builder/global_builder.d.ts.map +1 -1
  16. package/dest/global_variable_builder/global_builder.js +9 -66
  17. package/dest/global_variable_builder/index.d.ts +4 -2
  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 +51 -17
  21. package/dest/publisher/config.d.ts.map +1 -1
  22. package/dest/publisher/config.js +131 -42
  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 +11 -5
  44. package/dest/publisher/sequencer-publisher-factory.d.ts.map +1 -1
  45. package/dest/publisher/sequencer-publisher-factory.js +27 -3
  46. package/dest/publisher/sequencer-publisher-metrics.d.ts +1 -1
  47. package/dest/publisher/sequencer-publisher-metrics.d.ts.map +1 -1
  48. package/dest/publisher/sequencer-publisher-metrics.js +12 -4
  49. package/dest/publisher/sequencer-publisher.d.ts +122 -68
  50. package/dest/publisher/sequencer-publisher.d.ts.map +1 -1
  51. package/dest/publisher/sequencer-publisher.js +750 -364
  52. package/dest/publisher/write_json.d.ts +11 -0
  53. package/dest/publisher/write_json.d.ts.map +1 -0
  54. package/dest/publisher/write_json.js +57 -0
  55. package/dest/sequencer/automine/automine_factory.d.ts +56 -0
  56. package/dest/sequencer/automine/automine_factory.d.ts.map +1 -0
  57. package/dest/sequencer/automine/automine_factory.js +85 -0
  58. package/dest/sequencer/automine/automine_sequencer.d.ts +189 -0
  59. package/dest/sequencer/automine/automine_sequencer.d.ts.map +1 -0
  60. package/dest/sequencer/automine/automine_sequencer.js +690 -0
  61. package/dest/sequencer/automine/index.d.ts +3 -0
  62. package/dest/sequencer/automine/index.d.ts.map +1 -0
  63. package/dest/sequencer/automine/index.js +2 -0
  64. package/dest/sequencer/checkpoint_proposal_job.d.ts +101 -22
  65. package/dest/sequencer/checkpoint_proposal_job.d.ts.map +1 -1
  66. package/dest/sequencer/checkpoint_proposal_job.js +922 -280
  67. package/dest/sequencer/checkpoint_proposal_job_metrics.d.ts +34 -0
  68. package/dest/sequencer/checkpoint_proposal_job_metrics.d.ts.map +1 -0
  69. package/dest/sequencer/checkpoint_proposal_job_metrics.js +72 -0
  70. package/dest/sequencer/checkpoint_voter.d.ts +1 -2
  71. package/dest/sequencer/checkpoint_voter.d.ts.map +1 -1
  72. package/dest/sequencer/checkpoint_voter.js +2 -5
  73. package/dest/sequencer/events.d.ts +62 -5
  74. package/dest/sequencer/events.d.ts.map +1 -1
  75. package/dest/sequencer/metrics.d.ts +23 -8
  76. package/dest/sequencer/metrics.d.ts.map +1 -1
  77. package/dest/sequencer/metrics.js +142 -36
  78. package/dest/sequencer/requests_tracker.d.ts +22 -0
  79. package/dest/sequencer/requests_tracker.d.ts.map +1 -0
  80. package/dest/sequencer/requests_tracker.js +33 -0
  81. package/dest/sequencer/sequencer.d.ts +181 -44
  82. package/dest/sequencer/sequencer.d.ts.map +1 -1
  83. package/dest/sequencer/sequencer.js +614 -216
  84. package/dest/sequencer/types.d.ts +2 -2
  85. package/dest/sequencer/types.d.ts.map +1 -1
  86. package/dest/test/index.d.ts +5 -7
  87. package/dest/test/index.d.ts.map +1 -1
  88. package/dest/test/mock_checkpoint_builder.d.ts +18 -15
  89. package/dest/test/mock_checkpoint_builder.d.ts.map +1 -1
  90. package/dest/test/mock_checkpoint_builder.js +63 -40
  91. package/dest/test/utils.d.ts +22 -8
  92. package/dest/test/utils.d.ts.map +1 -1
  93. package/dest/test/utils.js +33 -14
  94. package/package.json +30 -29
  95. package/src/client/sequencer-client.ts +110 -47
  96. package/src/config.ts +121 -58
  97. package/src/global_variable_builder/README.md +44 -0
  98. package/src/global_variable_builder/fee_predictor.ts +182 -0
  99. package/src/global_variable_builder/fee_provider.ts +97 -0
  100. package/src/global_variable_builder/global_builder.ts +20 -89
  101. package/src/global_variable_builder/index.ts +3 -1
  102. package/src/publisher/config.ts +173 -40
  103. package/src/publisher/index.ts +3 -0
  104. package/src/publisher/l1_to_l2_messaging.ts +85 -0
  105. package/src/publisher/l1_tx_failed_store/factory.ts +32 -0
  106. package/src/publisher/l1_tx_failed_store/failed_tx_store.ts +164 -0
  107. package/src/publisher/l1_tx_failed_store/file_store_failed_tx_store.ts +47 -0
  108. package/src/publisher/l1_tx_failed_store/index.ts +3 -0
  109. package/src/publisher/sequencer-bundle-simulator.ts +254 -0
  110. package/src/publisher/sequencer-publisher-factory.ts +38 -9
  111. package/src/publisher/sequencer-publisher-metrics.ts +7 -3
  112. package/src/publisher/sequencer-publisher.ts +854 -461
  113. package/src/publisher/write_json.ts +78 -0
  114. package/src/sequencer/README.md +162 -450
  115. package/src/sequencer/automine/README.md +60 -0
  116. package/src/sequencer/automine/automine_factory.ts +152 -0
  117. package/src/sequencer/automine/automine_sequencer.ts +796 -0
  118. package/src/sequencer/automine/index.ts +6 -0
  119. package/src/sequencer/checkpoint_proposal_job.ts +1139 -328
  120. package/src/sequencer/checkpoint_proposal_job_metrics.ts +128 -0
  121. package/src/sequencer/checkpoint_voter.ts +1 -12
  122. package/src/sequencer/events.ts +66 -5
  123. package/src/sequencer/metrics.ts +164 -39
  124. package/src/sequencer/requests_tracker.ts +43 -0
  125. package/src/sequencer/sequencer.ts +729 -242
  126. package/src/sequencer/types.ts +1 -1
  127. package/src/test/index.ts +4 -6
  128. package/src/test/mock_checkpoint_builder.ts +93 -65
  129. package/src/test/utils.ts +81 -21
  130. package/dest/sequencer/timetable.d.ts +0 -90
  131. package/dest/sequencer/timetable.d.ts.map +0 -1
  132. package/dest/sequencer/timetable.js +0 -226
  133. package/src/sequencer/timetable.ts +0 -282
@@ -370,41 +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 { MULTI_CALL_3_ADDRESS, Multicall3, RollupContract } from '@aztec/ethereum/contracts';
376
- import { L1FeeAnalyzer } from '@aztec/ethereum/l1-fee-analysis';
377
- import { WEI_CONST } from '@aztec/ethereum/l1-tx-utils';
378
- import { FormattedViemError, formatViemError, 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';
380
+ import { trimmedBytesLength } from '@aztec/foundation/buffer';
382
381
  import { pick } from '@aztec/foundation/collection';
382
+ import { TimeoutError } from '@aztec/foundation/error';
383
383
  import { EthAddress } from '@aztec/foundation/eth-address';
384
384
  import { Signature } from '@aztec/foundation/eth-signature';
385
385
  import { createLogger } from '@aztec/foundation/log';
386
+ import { InterruptibleSleep } from '@aztec/foundation/sleep';
386
387
  import { bufferToHex } from '@aztec/foundation/string';
387
388
  import { Timer } from '@aztec/foundation/timer';
388
- import { EmpireBaseAbi, ErrorsAbi, RollupAbi } from '@aztec/l1-artifacts';
389
+ import { EmpireBaseAbi, ErrorsAbi, RollupAbi, SlashingProposerAbi } from '@aztec/l1-artifacts';
389
390
  import { encodeSlashConsensusVotes } from '@aztec/slasher';
390
391
  import { CommitteeAttestationsAndSigners } from '@aztec/stdlib/block';
392
+ import { getLastL1SlotTimestampForL2Slot, getNextL1SlotTimestamp, getTimestampForSlot } from '@aztec/stdlib/epoch-helpers';
391
393
  import { getTelemetryClient, trackSpan } from '@aztec/telemetry-client';
392
- 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';
393
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
+ }
394
408
  export const Actions = [
395
409
  'invalidate-by-invalid-attestation',
396
410
  'invalidate-by-insufficient-attestations',
411
+ 'prune',
397
412
  'propose',
398
413
  'governance-signal',
399
- 'empire-slashing-signal',
400
- 'create-empire-payload',
401
- 'execute-empire-payload',
402
414
  'vote-offenses',
403
415
  'execute-slash'
404
416
  ];
405
417
  // Sorting for actions such that invalidations go before proposals, and proposals go before votes
406
418
  export const compareActions = (a, b)=>Actions.indexOf(a) - Actions.indexOf(b);
407
- _dec = trackSpan('SequencerPublisher.sendRequests'), _dec1 = trackSpan('SequencerPublisher.validateBlockHeader'), _dec2 = trackSpan('SequencerPublisher.validateCheckpointForSubmission');
419
+ _dec = trackSpan('SequencerPublisher.sendRequests'), _dec1 = trackSpan('SequencerPublisher.validateBlockHeader');
408
420
  export class SequencerPublisher {
409
421
  config;
410
422
  static{
@@ -418,58 +430,64 @@ export class SequencerPublisher {
418
430
  _dec1,
419
431
  2,
420
432
  "validateBlockHeader"
421
- ],
422
- [
423
- _dec2,
424
- 2,
425
- "validateCheckpointForSubmission"
426
433
  ]
427
434
  ], []));
428
435
  }
429
436
  interrupted;
430
437
  metrics;
438
+ bundleSimulator;
431
439
  epochCache;
432
- governanceLog;
433
- 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;
434
446
  lastActions;
435
- isPayloadEmptyCache;
436
447
  log;
437
448
  ethereumSlotDuration;
449
+ aztecSlotDuration;
450
+ previousL1BlockWaitTimeoutMs;
451
+ previousL1BlockWaitPollIntervalMs;
452
+ /** Date provider for wall-clock time. */ dateProvider;
438
453
  blobClient;
439
- /** 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;
440
455
  /** L1 fee analyzer for fisherman mode */ l1FeeAnalyzer;
441
- // @note - with blobs, the below estimate seems too large.
442
- // Total used for full block from int_l1_pub e2e test: 1m (of which 86k is 1x blob)
443
- // Total used for emptier block from above test: 429k (of which 84k is 1x blob)
444
- static PROPOSE_GAS_GUESS = 12_000_000n;
445
- // A CALL to a cold address is 2700 gas
446
- static MULTICALL_OVERHEAD_GAS_GUESS = 5000n;
447
- // Gas report for VotingWithSigTest shows a max gas of 100k, but we've seen it cost 700k+ in testnet
448
- static VOTE_GAS_GUESS = 800_000n;
456
+ /** Fee asset price oracle for computing price modifiers from Uniswap V4 */ feeAssetPriceOracle;
457
+ /** Interruptible sleep used by sendRequestsAt to wait until a target timestamp. */ interruptibleSleep;
449
458
  l1TxUtils;
450
459
  rollupContract;
451
460
  govProposerContract;
452
461
  slashingProposerContract;
453
- slashFactoryContract;
454
462
  tracer;
455
463
  requests;
456
464
  constructor(config, deps){
457
465
  this.config = config;
458
466
  this.interrupted = (_initProto(this), false);
459
- this.governanceLog = createLogger('sequencer:publisher:governance');
460
- this.slashingLog = createLogger('sequencer:publisher:slashing');
467
+ this.revertDecoderAbi = mergeAbis([
468
+ RollupAbi,
469
+ SlashingProposerAbi,
470
+ EmpireBaseAbi,
471
+ ErrorsAbi
472
+ ]);
461
473
  this.lastActions = {};
462
- this.isPayloadEmptyCache = new Map();
474
+ this.interruptibleSleep = new InterruptibleSleep();
463
475
  this.requests = [];
464
476
  this.log = deps.log ?? createLogger('sequencer:publisher');
465
477
  this.ethereumSlotDuration = BigInt(config.ethereumSlotDuration);
478
+ this.aztecSlotDuration = BigInt(config.aztecSlotDuration);
479
+ this.previousL1BlockWaitTimeoutMs = config.sequencerPublisherPreviousL1BlockWaitTimeoutMs;
480
+ this.previousL1BlockWaitPollIntervalMs = config.sequencerPublisherPreviousL1BlockWaitPollIntervalMs;
481
+ this.dateProvider = deps.dateProvider;
466
482
  this.epochCache = deps.epochCache;
467
483
  this.lastActions = deps.lastActions;
468
484
  this.blobClient = deps.blobClient;
485
+ this.dateProvider = deps.dateProvider;
469
486
  const telemetry = deps.telemetry ?? getTelemetryClient();
470
487
  this.metrics = deps.metrics ?? new SequencerPublisherMetrics(telemetry, 'SequencerPublisher');
471
488
  this.tracer = telemetry.getTracer('SequencerPublisher');
472
489
  this.l1TxUtils = deps.l1TxUtils;
490
+ this.getNextPublisher = deps.getNextPublisher;
473
491
  this.rollupContract = deps.rollupContract;
474
492
  this.govProposerContract = deps.governanceProposerContract;
475
493
  this.slashingProposerContract = deps.slashingProposerContract;
@@ -478,15 +496,117 @@ export class SequencerPublisher {
478
496
  const newSlashingProposer = await this.rollupContract.getSlashingProposer();
479
497
  this.slashingProposerContract = newSlashingProposer;
480
498
  });
481
- this.slashFactoryContract = deps.slashFactoryContract;
482
499
  // Initialize L1 fee analyzer for fisherman mode
483
500
  if (config.fishermanMode) {
484
- 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'));
502
+ }
503
+ // Initialize fee asset 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;
485
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()}`));
486
596
  }
487
597
  getRollupContract() {
488
598
  return this.rollupContract;
489
599
  }
600
+ /**
601
+ * Gets the fee asset price modifier from the oracle.
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);
609
+ }
490
610
  getSenderAddress() {
491
611
  return this.l1TxUtils.getSenderAddress();
492
612
  }
@@ -495,17 +615,11 @@ export class SequencerPublisher {
495
615
  */ getL1FeeAnalyzer() {
496
616
  return this.l1FeeAnalyzer;
497
617
  }
498
- /**
499
- * Sets the proposer address to use for simulations in fisherman mode.
500
- * @param proposerAddress - The actual proposer's address to use for balance lookups in simulations
501
- */ setProposerAddressForSimulation(proposerAddress) {
502
- this.proposerAddressForSimulation = proposerAddress;
503
- }
504
618
  addRequest(request) {
505
619
  this.requests.push(request);
506
620
  }
507
621
  getCurrentL2Slot() {
508
- return this.epochCache.getEpochAndSlotNow().slot;
622
+ return this.epochCache.getSlotNow();
509
623
  }
510
624
  /**
511
625
  * Clears all pending requests without sending them.
@@ -544,7 +658,7 @@ export class SequencerPublisher {
544
658
  // Get the transaction requests
545
659
  const l1Requests = requestsToAnalyze.map((r)=>r.request);
546
660
  // Start the analysis
547
- const analysisId = await this.l1FeeAnalyzer.startAnalysis(l2SlotNumber, gasLimit > 0n ? gasLimit : SequencerPublisher.PROPOSE_GAS_GUESS, l1Requests, blobConfig, onComplete);
661
+ const analysisId = await this.l1FeeAnalyzer.startAnalysis(l2SlotNumber, gasLimit > 0n ? gasLimit : MAX_L1_TX_LIMIT, l1Requests, blobConfig, onComplete);
548
662
  this.log.info('Started L1 fee analysis', {
549
663
  analysisId,
550
664
  l2SlotNumber: l2SlotNumber.toString(),
@@ -558,11 +672,15 @@ export class SequencerPublisher {
558
672
  }
559
673
  /**
560
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.
561
679
  * @returns one of:
562
680
  * - A receipt and stats if the tx succeeded
563
681
  * - a receipt and errorMsg if it failed on L1
564
682
  * - undefined if no valid requests are found OR the tx failed to send.
565
- */ async sendRequests() {
683
+ */ async sendRequests(targetSlot) {
566
684
  const requestsToProcess = [
567
685
  ...this.requests
568
686
  ];
@@ -570,10 +688,9 @@ export class SequencerPublisher {
570
688
  if (this.interrupted || requestsToProcess.length === 0) {
571
689
  return undefined;
572
690
  }
573
- const currentL2Slot = this.getCurrentL2Slot();
691
+ const currentL2Slot = targetSlot ?? this.getCurrentL2Slot();
574
692
  this.log.debug(`Sending requests on L2 slot ${currentL2Slot}`);
575
693
  const validRequests = requestsToProcess.filter((request)=>request.lastValidL2Slot >= currentL2Slot);
576
- const validActions = validRequests.map((x)=>x.action);
577
694
  const expiredActions = requestsToProcess.filter((request)=>request.lastValidL2Slot < currentL2Slot).map((x)=>x.action);
578
695
  if (validRequests.length !== requestsToProcess.length) {
579
696
  this.log.warn(`Some requests were expired for slot ${currentL2Slot}`, {
@@ -591,44 +708,98 @@ export class SequencerPublisher {
591
708
  this.log.debug(`No valid requests to send`);
592
709
  return undefined;
593
710
  }
594
- // @note - we can only have one blob config per bundle
595
- // find requests with gas and blob configs
596
- // See https://github.com/AztecProtocol/aztec-packages/issues/11513
597
- const gasConfigs = requestsToProcess.filter((request)=>request.gasConfig).map((request)=>request.gasConfig);
598
- const blobConfigs = requestsToProcess.filter((request)=>request.blobConfig).map((request)=>request.blobConfig);
599
- if (blobConfigs.length > 1) {
600
- throw new Error('Multiple blob configs found');
601
- }
602
- const blobConfig = blobConfigs[0];
603
- // Merge gasConfigs. Yields the sum of gasLimits, and the earliest txTimeoutAt, or undefined if no gasConfig sets them.
604
- const gasLimits = gasConfigs.map((g)=>g?.gasLimit).filter((g)=>g !== undefined);
605
- const gasLimit = gasLimits.length > 0 ? sumBigint(gasLimits) : undefined; // sum
711
+ // Collect earliest txTimeoutAt across all requests.
712
+ const gasConfigs = validRequests.filter((request)=>request.gasConfig).map((request)=>request.gasConfig);
606
713
  const txTimeoutAts = gasConfigs.map((g)=>g?.txTimeoutAt).filter((g)=>g !== undefined);
607
- const txTimeoutAt = txTimeoutAts.length > 0 ? new Date(Math.min(...txTimeoutAts.map((g)=>g.getTime()))) : undefined; // earliest
608
- const txConfig = {
609
- gasLimit,
610
- txTimeoutAt
611
- };
714
+ const txTimeoutAt = txTimeoutAts.length > 0 ? new Date(Math.min(...txTimeoutAts.map((g)=>g.getTime()))) : undefined;
612
715
  // Sort the requests so that proposals always go first
613
716
  // This ensures the committee gets precomputed correctly
614
717
  validRequests.sort((a, b)=>compareActions(a.action, b.action));
615
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
+ };
616
739
  this.log.debug('Forwarding transactions', {
617
- validRequests: validRequests.map((request)=>request.action),
740
+ requests: requests.map((request)=>request.action),
618
741
  txConfig
619
742
  });
620
- const result = await Multicall3.forward(validRequests.map((request)=>request.request), this.l1TxUtils, txConfig, blobConfig, this.rollupContract.address, this.log);
621
- 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
+ ];
622
752
  return {
623
753
  result,
624
754
  expiredActions,
625
- sentActions: validActions,
755
+ sentActions: requests.map((x)=>x.action),
626
756
  successfulActions,
627
- failedActions
757
+ failedActions: allFailedActions
628
758
  };
629
759
  } catch (err) {
630
760
  const viemError = formatViemError(err);
631
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
+ }
632
803
  return undefined;
633
804
  } finally{
634
805
  try {
@@ -638,49 +809,302 @@ export class SequencerPublisher {
638
809
  }
639
810
  }
640
811
  }
641
- callbackBundledTransactions(requests, result) {
642
- const actionsListStr = requests.map((r)=>r.action).join(', ');
643
- if (result instanceof FormattedViemError) {
644
- this.log.error(`Failed to publish bundled transactions (${actionsListStr})`, result);
645
- return {
646
- failedActions: requests.map((r)=>r.action)
647
- };
648
- } else {
649
- this.log.verbose(`Published bundled transactions (${actionsListStr})`, {
650
- result,
651
- requests
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
652
820
  });
653
- const successfulActions = [];
654
- const failedActions = [];
655
- for (const request of requests){
656
- if (request.checkSuccess(request.request, result)) {
657
- successfulActions.push(request.action);
658
- } else {
659
- 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;
660
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;
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;
661
916
  }
662
- return {
663
- successfulActions,
664
- failedActions
665
- };
666
917
  }
667
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
+ }
668
1000
  /**
669
- * @notice Will call `canProposeAtNextEthBlock` to make sure that it is possible to propose
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);
1056
+ }
1057
+ }
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
+ }
1088
+ /**
1089
+ * @notice Will call `canProposeAt` to make sure that it is possible to propose
670
1090
  * @param tipArchive - The archive to check
671
1091
  * @returns The slot and block number if it is possible to propose, undefined otherwise
672
- */ canProposeAtNextEthBlock(tipArchive, msgSender, opts = {}) {
1092
+ */ async canProposeAt(tipArchive, msgSender, simulationOverridesPlan) {
673
1093
  // TODO: #14291 - should loop through multiple keys to check if any of them can propose
674
- 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 = [
675
1099
  'SlotAlreadyInChain',
676
1100
  'InvalidProposer',
677
1101
  'InvalidArchive'
678
1102
  ];
679
- return this.rollupContract.canProposeAtNextEthBlock(tipArchive.toBuffer(), msgSender.toString(), Number(this.ethereumSlotDuration), {
680
- forcePendingCheckpointNumber: opts.forcePendingCheckpointNumber
681
- }).catch((err)=>{
682
- if (err instanceof FormattedViemError && ignoredErrors.find((e)=>err.message.includes(e))) {
683
- this.log.warn(`Failed canProposeAtTime check with ${ignoredErrors.find((e)=>err.message.includes(e))}`, {
1103
+ const slotOffset = this.aztecSlotDuration;
1104
+ const nextL1SlotTs = this.getNextL1SlotTimestamp() + slotOffset;
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))}`, {
684
1108
  error: err.message
685
1109
  });
686
1110
  } else {
@@ -694,22 +1118,23 @@ export class SequencerPublisher {
694
1118
  * @dev This is a convenience function that can be used by the sequencer to validate a "partial" header.
695
1119
  * It will throw if the block header is invalid.
696
1120
  * @param header - The block header to validate
697
- */ async validateBlockHeader(header, opts) {
1121
+ */ async validateBlockHeader(header, simulationOverridesPlan) {
698
1122
  const flags = {
699
1123
  ignoreDA: true,
700
1124
  ignoreSignatures: true
701
1125
  };
702
1126
  const args = [
703
1127
  header.toViem(),
704
- CommitteeAttestationsAndSigners.empty().getPackedAttestations(),
1128
+ CommitteeAttestationsAndSigners.packAttestations([]),
705
1129
  [],
706
1130
  Signature.empty().toViemSignature(),
707
1131
  `0x${'0'.repeat(64)}`,
708
1132
  header.blobsHash.toString(),
709
1133
  flags
710
1134
  ];
711
- const ts = BigInt((await this.l1TxUtils.getBlock()).timestamp + this.ethereumSlotDuration);
712
- 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);
713
1138
  let balance = 0n;
714
1139
  if (this.config.fishermanMode) {
715
1140
  // In fisherman mode, we can't know where the proposer is publishing from
@@ -731,7 +1156,7 @@ export class SequencerPublisher {
731
1156
  }),
732
1157
  from: MULTI_CALL_3_ADDRESS
733
1158
  }, {
734
- time: ts + 1n
1159
+ time: ts
735
1160
  }, stateOverrides);
736
1161
  this.log.debug(`Simulated validateHeader`);
737
1162
  }
@@ -761,8 +1186,12 @@ export class SequencerPublisher {
761
1186
  ...logData,
762
1187
  request
763
1188
  });
1189
+ const l1BlockNumber = await this.l1TxUtils.getBlockNumber();
764
1190
  try {
765
- const { gasUsed } = await this.l1TxUtils.simulate(request, undefined, undefined, ErrorsAbi);
1191
+ const { gasUsed } = await this.l1TxUtils.simulate(request, undefined, undefined, mergeAbis([
1192
+ request.abi ?? [],
1193
+ ErrorsAbi
1194
+ ]));
766
1195
  this.log.verbose(`Simulation for invalidate checkpoint ${checkpointNumber} succeeded`, {
767
1196
  ...logData,
768
1197
  request,
@@ -773,20 +1202,21 @@ export class SequencerPublisher {
773
1202
  gasUsed,
774
1203
  checkpointNumber,
775
1204
  forcePendingCheckpointNumber: CheckpointNumber(checkpointNumber - 1),
1205
+ lastArchive: validationResult.checkpoint.lastArchive,
776
1206
  reason
777
1207
  };
778
1208
  } catch (err) {
779
1209
  const viemError = formatViemError(err);
780
1210
  // If the error is due to the checkpoint not being in the pending chain, and it was indeed removed by someone else,
781
1211
  // we can safely ignore it and return undefined so we go ahead with checkpoint building.
782
- if (viemError.message?.includes('Rollup__BlockNotInPendingChain')) {
1212
+ if (viemError.message?.includes('Rollup__CheckpointNotInPendingChain')) {
783
1213
  this.log.verbose(`Simulation for invalidate checkpoint ${checkpointNumber} failed due to checkpoint not being in pending chain`, {
784
1214
  ...logData,
785
1215
  request,
786
1216
  error: viemError.message
787
1217
  });
788
- const latestPendingCheckpointNumber = await this.rollupContract.getCheckpointNumber();
789
- if (latestPendingCheckpointNumber < checkpointNumber) {
1218
+ const latestProposedCheckpointNumber = await this.rollupContract.getCheckpointNumber();
1219
+ if (latestProposedCheckpointNumber < checkpointNumber) {
790
1220
  this.log.verbose(`Checkpoint ${checkpointNumber} has already been invalidated`, {
791
1221
  ...logData
792
1222
  });
@@ -800,6 +1230,31 @@ export class SequencerPublisher {
800
1230
  }
801
1231
  // Otherwise, throw. We cannot build the next checkpoint if we cannot invalidate the previous one.
802
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
+ });
803
1258
  throw new Error(`Failed to simulate invalidate checkpoint ${checkpointNumber}`, {
804
1259
  cause: viemError
805
1260
  });
@@ -815,7 +1270,11 @@ export class SequencerPublisher {
815
1270
  reason
816
1271
  };
817
1272
  this.log.debug(`Building invalidate checkpoint ${checkpoint.checkpointNumber} request`, logData);
818
- 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;
819
1278
  if (reason === 'invalid-attestation') {
820
1279
  return this.rollupContract.buildInvalidateBadAttestationRequest(checkpoint.checkpointNumber, attestationsAndSigners, committee, validationResult.invalidIndex);
821
1280
  } else if (reason === 'insufficient-attestations') {
@@ -825,42 +1284,7 @@ export class SequencerPublisher {
825
1284
  throw new Error(`Unknown reason for invalidation`);
826
1285
  }
827
1286
  }
828
- /** Simulates `propose` to make sure that the checkpoint is valid for submission */ async validateCheckpointForSubmission(checkpoint, attestationsAndSigners, attestationsAndSignersSignature, options) {
829
- const ts = BigInt((await this.l1TxUtils.getBlock()).timestamp + this.ethereumSlotDuration);
830
- // TODO(palla/mbps): This should not be needed, there's no flow where we propose with zero attestations. Or is there?
831
- // If we have no attestations, we still need to provide the empty attestations
832
- // so that the committee is recalculated correctly
833
- // const ignoreSignatures = attestationsAndSigners.attestations.length === 0;
834
- // if (ignoreSignatures) {
835
- // const { committee } = await this.epochCache.getCommittee(block.header.globalVariables.slotNumber);
836
- // if (!committee) {
837
- // this.log.warn(`No committee found for slot ${block.header.globalVariables.slotNumber}`);
838
- // throw new Error(`No committee found for slot ${block.header.globalVariables.slotNumber}`);
839
- // }
840
- // attestationsAndSigners.attestations = committee.map(committeeMember =>
841
- // CommitteeAttestation.fromAddress(committeeMember),
842
- // );
843
- // }
844
- const blobFields = checkpoint.toBlobFields();
845
- const blobs = getBlobsPerL1Block(blobFields);
846
- const blobInput = getPrefixedEthBlobCommitments(blobs);
847
- const args = [
848
- {
849
- header: checkpoint.header.toViem(),
850
- archive: toHex(checkpoint.archive.root.toBuffer()),
851
- oracleInput: {
852
- feeAssetPriceModifier: 0n
853
- }
854
- },
855
- attestationsAndSigners.getPackedAttestations(),
856
- attestationsAndSigners.getSigners().map((signer)=>signer.toString()),
857
- attestationsAndSignersSignature.toViemSignature(),
858
- blobInput
859
- ];
860
- await this.simulateProposeTx(args, ts, options);
861
- return ts;
862
- }
863
- async enqueueCastSignalHelper(slotNumber, timestamp, signalType, payload, base, signerAddress, signer) {
1287
+ async enqueueCastSignalHelper(slotNumber, signalType, payload, base, signerAddress, signer) {
864
1288
  if (this.lastActions[signalType] && this.lastActions[signalType] === slotNumber) {
865
1289
  this.log.debug(`Skipping duplicate vote cast signal ${signalType} for slot ${slotNumber}`);
866
1290
  return false;
@@ -880,10 +1304,28 @@ export class SequencerPublisher {
880
1304
  if (roundInfo.lastSignalSlot >= slotNumber) {
881
1305
  return false;
882
1306
  }
883
- if (await this.isPayloadEmpty(payload)) {
1307
+ if (await base.isPayloadEmpty(payload)) {
884
1308
  this.log.warn(`Skipping vote cast for payload with empty code`);
885
1309
  return false;
886
1310
  }
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);
1324
+ }
1325
+ if (proposed) {
1326
+ this.log.info(`Payload ${payload} has a live governance proposal, stopping signals`);
1327
+ return false;
1328
+ }
887
1329
  const cachedLastVote = this.lastActions[signalType];
888
1330
  this.lastActions[signalType] = slotNumber;
889
1331
  const action = signalType;
@@ -894,27 +1336,17 @@ export class SequencerPublisher {
894
1336
  signer: this.l1TxUtils.client.account?.address,
895
1337
  lastValidL2Slot: slotNumber
896
1338
  });
897
- try {
898
- await this.l1TxUtils.simulate(request, {
899
- time: timestamp
900
- }, [], ErrorsAbi);
901
- this.log.debug(`Simulation for ${action} at slot ${slotNumber} succeeded`, {
902
- request
903
- });
904
- } catch (err) {
905
- this.log.error(`Failed simulation for ${action} at slot ${slotNumber} (enqueuing the action anyway)`, err);
906
- // Yes, we enqueue the request anyway, in case there was a bug with the simulation itself
907
- }
908
1339
  // TODO(palla/slash): All votes (governance and slashing) should txTimeoutAt at the end of the slot.
909
1340
  this.addRequest({
910
- gasConfig: {
911
- gasLimit: SequencerPublisher.VOTE_GAS_GUESS
912
- },
913
1341
  action,
914
1342
  request,
915
1343
  lastValidL2Slot: slotNumber,
916
1344
  checkSuccess: (_request, result)=>{
917
- 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
+ });
918
1350
  const logData = {
919
1351
  ...result,
920
1352
  slotNumber,
@@ -933,68 +1365,70 @@ export class SequencerPublisher {
933
1365
  });
934
1366
  return true;
935
1367
  }
936
- async isPayloadEmpty(payload) {
937
- const key = payload.toString();
938
- const cached = this.isPayloadEmptyCache.get(key);
939
- if (cached) {
940
- return cached;
941
- }
942
- const isEmpty = !await this.l1TxUtils.getCode(payload);
943
- this.isPayloadEmptyCache.set(key, isEmpty);
944
- return isEmpty;
945
- }
946
1368
  /**
947
1369
  * Enqueues a governance castSignal transaction to cast a signal for a given slot number.
948
1370
  * @param slotNumber - The slot number to cast a signal for.
949
- * @param timestamp - The timestamp of the slot to cast a signal for.
950
1371
  * @returns True if the signal was successfully enqueued, false otherwise.
951
- */ enqueueGovernanceCastSignal(governancePayload, slotNumber, timestamp, signerAddress, signer) {
952
- return this.enqueueCastSignalHelper(slotNumber, timestamp, 'governance-signal', governancePayload, this.govProposerContract, signerAddress, signer);
1372
+ */ enqueueGovernanceCastSignal(governancePayload, slotNumber, signerAddress, signer) {
1373
+ return this.enqueueCastSignalHelper(slotNumber, 'governance-signal', governancePayload, this.govProposerContract, signerAddress, signer);
953
1374
  }
954
- /** Enqueues all slashing actions as returned by the slasher client. */ async enqueueSlashingActions(actions, slotNumber, timestamp, signerAddress, signer) {
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
+ }
1425
+ /** Enqueues all slashing actions as returned by the slasher client. */ async enqueueSlashingActions(actions, slotNumber, signerAddress, signer) {
955
1426
  if (actions.length === 0) {
956
1427
  this.log.debug(`No slashing actions to enqueue for slot ${slotNumber}`);
957
1428
  return false;
958
1429
  }
959
1430
  for (const action of actions){
960
1431
  switch(action.type){
961
- case 'vote-empire-payload':
962
- {
963
- if (this.slashingProposerContract?.type !== 'empire') {
964
- this.log.error('Cannot vote for empire payload on non-empire slashing contract');
965
- break;
966
- }
967
- this.log.debug(`Enqueuing slashing vote for payload ${action.payload} at slot ${slotNumber}`, {
968
- signerAddress
969
- });
970
- await this.enqueueCastSignalHelper(slotNumber, timestamp, 'empire-slashing-signal', action.payload, this.slashingProposerContract, signerAddress, signer);
971
- break;
972
- }
973
- case 'create-empire-payload':
974
- {
975
- this.log.debug(`Enqueuing slashing create payload at slot ${slotNumber}`, {
976
- slotNumber,
977
- signerAddress
978
- });
979
- const request = this.slashFactoryContract.buildCreatePayloadRequest(action.data);
980
- await this.simulateAndEnqueueRequest('create-empire-payload', request, (receipt)=>!!this.slashFactoryContract.tryExtractSlashPayloadCreatedEvent(receipt.logs), slotNumber, timestamp);
981
- break;
982
- }
983
- case 'execute-empire-payload':
984
- {
985
- this.log.debug(`Enqueuing slashing execute payload at slot ${slotNumber}`, {
986
- slotNumber,
987
- signerAddress
988
- });
989
- if (this.slashingProposerContract?.type !== 'empire') {
990
- this.log.error('Cannot execute slashing payload on non-empire slashing contract');
991
- return false;
992
- }
993
- const empireSlashingProposer = this.slashingProposerContract;
994
- const request = empireSlashingProposer.buildExecuteRoundRequest(action.round);
995
- await this.simulateAndEnqueueRequest('execute-empire-payload', request, (receipt)=>!!empireSlashingProposer.tryExtractPayloadSubmittedEvent(receipt.logs), slotNumber, timestamp);
996
- break;
997
- }
998
1432
  case 'vote-offenses':
999
1433
  {
1000
1434
  this.log.debug(`Enqueuing slashing vote for ${action.votes.length} votes at slot ${slotNumber}`, {
@@ -1003,14 +1437,17 @@ export class SequencerPublisher {
1003
1437
  votesCount: action.votes.length,
1004
1438
  signerAddress
1005
1439
  });
1006
- if (this.slashingProposerContract?.type !== 'tally') {
1007
- 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');
1008
1442
  return false;
1009
1443
  }
1010
- const tallySlashingProposer = this.slashingProposerContract;
1011
1444
  const votes = bufferToHex(encodeSlashConsensusVotes(action.votes));
1012
- const request = await tallySlashingProposer.buildVoteRequestFromSigner(votes, slotNumber, signer);
1013
- await this.simulateAndEnqueueRequest('vote-offenses', request, (receipt)=>!!tallySlashingProposer.tryExtractVoteCastEvent(receipt.logs), slotNumber, timestamp);
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);
1014
1451
  break;
1015
1452
  }
1016
1453
  case 'execute-slash':
@@ -1020,13 +1457,16 @@ export class SequencerPublisher {
1020
1457
  round: action.round,
1021
1458
  signerAddress
1022
1459
  });
1023
- if (this.slashingProposerContract?.type !== 'tally') {
1024
- 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');
1025
1462
  return false;
1026
1463
  }
1027
- const tallySlashingProposer = this.slashingProposerContract;
1028
- const request = tallySlashingProposer.buildExecuteRoundRequest(action.round, action.committees);
1029
- await this.simulateAndEnqueueRequest('execute-slash', request, (receipt)=>!!tallySlashingProposer.tryExtractRoundExecutedEvent(receipt.logs), slotNumber, timestamp);
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);
1030
1470
  break;
1031
1471
  }
1032
1472
  default:
@@ -1038,63 +1478,50 @@ export class SequencerPublisher {
1038
1478
  }
1039
1479
  return true;
1040
1480
  }
1041
- /** 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 = {}) {
1042
1482
  const checkpointHeader = checkpoint.header;
1043
1483
  const blobFields = checkpoint.toBlobFields();
1044
- const blobs = getBlobsPerL1Block(blobFields);
1484
+ const blobs = await getBlobsPerL1Block(blobFields);
1045
1485
  const proposeTxArgs = {
1046
1486
  header: checkpointHeader,
1047
1487
  archive: checkpoint.archive.root.toBuffer(),
1048
1488
  blobs,
1049
1489
  attestationsAndSigners,
1050
- attestationsAndSignersSignature
1490
+ attestationsAndSignersSignature,
1491
+ feeAssetPriceModifier: checkpoint.feeAssetPriceModifier
1051
1492
  };
1052
- let ts;
1053
- try {
1054
- // @note This will make sure that we are passing the checks for our header ASSUMING that the data is also made available
1055
- // This means that we can avoid the simulation issues in later checks.
1056
- // By simulation issue, I mean the fact that the block.timestamp is equal to the last block, not the next, which
1057
- // make time consistency checks break.
1058
- // TODO(palla): Check whether we're validating twice, once here and once within addProposeTx, since we call simulateProposeTx in both places.
1059
- ts = await this.validateCheckpointForSubmission(checkpoint, attestationsAndSigners, attestationsAndSignersSignature, opts);
1060
- } catch (err) {
1061
- this.log.error(`Checkpoint validation failed. ${err instanceof Error ? err.message : 'No error message'}`, err, {
1062
- ...checkpoint.getStats(),
1063
- slotNumber: checkpoint.header.slotNumber,
1064
- forcePendingCheckpointNumber: opts.forcePendingCheckpointNumber
1065
- });
1066
- throw err;
1067
- }
1068
1493
  this.log.verbose(`Enqueuing checkpoint propose transaction`, {
1069
1494
  ...checkpoint.toCheckpointInfo(),
1070
- ...opts
1495
+ txTimeoutAt: opts.txTimeoutAt
1496
+ });
1497
+ await this.addProposeTx(checkpoint, proposeTxArgs, {
1498
+ txTimeoutAt: opts.txTimeoutAt
1071
1499
  });
1072
- await this.addProposeTx(checkpoint, proposeTxArgs, opts, ts);
1073
1500
  }
1074
1501
  enqueueInvalidateCheckpoint(request, opts = {}) {
1075
1502
  if (!request) {
1076
1503
  return;
1077
1504
  }
1078
- // We issued the simulation against the rollup contract, so we need to account for the overhead of the multicall3
1079
- const gasLimit = this.l1TxUtils.bumpGasLimit(BigInt(Math.ceil(Number(request.gasUsed) * 64 / 63)));
1080
1505
  const { gasUsed, checkpointNumber } = request;
1081
1506
  const logData = {
1082
1507
  gasUsed,
1083
1508
  checkpointNumber,
1084
- gasLimit,
1085
1509
  opts
1086
1510
  };
1087
1511
  this.log.verbose(`Enqueuing invalidate checkpoint request`, logData);
1088
1512
  this.addRequest({
1089
1513
  action: `invalidate-by-${request.reason}`,
1090
1514
  request: request.request,
1091
- gasConfig: {
1092
- gasLimit,
1515
+ gasConfig: opts.txTimeoutAt ? {
1093
1516
  txTimeoutAt: opts.txTimeoutAt
1094
- },
1517
+ } : undefined,
1095
1518
  lastValidL2Slot: SlotNumber(this.getCurrentL2Slot() + 2),
1096
1519
  checkSuccess: (_req, result)=>{
1097
- 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
+ });
1098
1525
  if (!success) {
1099
1526
  this.log.warn(`Invalidate checkpoint ${request.checkpointNumber} failed`, {
1100
1527
  ...result,
@@ -1110,57 +1537,36 @@ export class SequencerPublisher {
1110
1537
  }
1111
1538
  });
1112
1539
  }
1113
- async simulateAndEnqueueRequest(action, request, checkSuccess, slotNumber, timestamp) {
1114
- const logData = {
1115
- slotNumber,
1116
- timestamp,
1117
- gasLimit: undefined
1118
- };
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) {
1119
1545
  if (this.lastActions[action] && this.lastActions[action] === slotNumber) {
1120
1546
  this.log.debug(`Skipping duplicate action ${action} for slot ${slotNumber}`);
1121
1547
  return false;
1122
1548
  }
1123
1549
  const cachedLastActionSlot = this.lastActions[action];
1124
1550
  this.lastActions[action] = slotNumber;
1125
- this.log.debug(`Simulating ${action} for slot ${slotNumber}`, logData);
1126
- let gasUsed;
1127
- try {
1128
- ({ gasUsed } = await this.l1TxUtils.simulate(request, {
1129
- time: timestamp
1130
- }, [], ErrorsAbi)); // TODO(palla/slash): Check the timestamp logic
1131
- this.log.verbose(`Simulation for ${action} succeeded`, {
1132
- ...logData,
1133
- request,
1134
- gasUsed
1135
- });
1136
- } catch (err) {
1137
- const viemError = formatViemError(err);
1138
- this.log.error(`Simulation for ${action} at ${slotNumber} failed`, viemError, logData);
1139
- return false;
1140
- }
1141
- // We issued the simulation against the rollup contract, so we need to account for the overhead of the multicall3
1142
- const gasLimit = this.l1TxUtils.bumpGasLimit(BigInt(Math.ceil(Number(gasUsed) * 64 / 63)));
1143
- logData.gasLimit = gasLimit;
1144
- this.log.debug(`Enqueuing ${action}`, logData);
1551
+ this.log.debug(`Enqueuing ${action}`, {
1552
+ slotNumber
1553
+ });
1145
1554
  this.addRequest({
1146
1555
  action,
1147
1556
  request,
1148
- gasConfig: {
1149
- gasLimit
1150
- },
1151
1557
  lastValidL2Slot: slotNumber,
1152
- checkSuccess: (_req, result)=>{
1153
- const success = result && result.receipt && result.receipt.status === 'success' && checkSuccess(result.receipt);
1558
+ checkSuccess: (_request, result)=>{
1559
+ const success = result && extractEventSuccess(result.receipt, eventOpts);
1154
1560
  if (!success) {
1155
1561
  this.log.warn(`Action ${action} at ${slotNumber} failed`, {
1156
1562
  ...result,
1157
- ...logData
1563
+ slotNumber
1158
1564
  });
1159
1565
  this.lastActions[action] = cachedLastActionSlot;
1160
1566
  } else {
1161
1567
  this.log.info(`Action ${action} at ${slotNumber} succeeded`, {
1162
1568
  ...result,
1163
- ...logData
1569
+ slotNumber
1164
1570
  });
1165
1571
  }
1166
1572
  return !!success;
@@ -1175,13 +1581,14 @@ export class SequencerPublisher {
1175
1581
  * A call to `restart` is required before you can continue publishing.
1176
1582
  */ interrupt() {
1177
1583
  this.interrupted = true;
1584
+ this.interruptibleSleep.interrupt();
1178
1585
  this.l1TxUtils.interrupt();
1179
1586
  }
1180
1587
  /** Restarts the publisher after calling `interrupt`. */ restart() {
1181
1588
  this.interrupted = false;
1182
1589
  this.l1TxUtils.restart();
1183
1590
  }
1184
- async prepareProposeTx(encodedData, timestamp, options) {
1591
+ async prepareProposeTx(encodedData) {
1185
1592
  const kzg = Blob.getViemKzgInstance();
1186
1593
  const blobInput = getPrefixedEthBlobCommitments(encodedData.blobs);
1187
1594
  this.log.debug('Validating blob input', {
@@ -1195,7 +1602,11 @@ export class SequencerPublisher {
1195
1602
  blobEvaluationGas = BigInt(encodedData.blobs.length) * 21_000n;
1196
1603
  this.log.debug(`Using fixed blob evaluation gas estimate in fisherman mode: ${blobEvaluationGas}`);
1197
1604
  } else {
1198
- // 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.
1199
1610
  blobEvaluationGas = await this.l1TxUtils.estimateGas(this.getSenderAddress().toString(), {
1200
1611
  to: this.rollupContract.address,
1201
1612
  data: encodeFunctionData({
@@ -1208,10 +1619,42 @@ export class SequencerPublisher {
1208
1619
  }, {}, {
1209
1620
  blobs: encodedData.blobs.map((b)=>b.data),
1210
1621
  kzg
1211
- }).catch((err)=>{
1212
- const { message, metaMessages } = formatViemError(err);
1213
- this.log.error(`Failed to validate blobs`, message, {
1214
- 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()
1215
1658
  });
1216
1659
  throw new Error('Failed to validate blobs');
1217
1660
  });
@@ -1222,8 +1665,7 @@ export class SequencerPublisher {
1222
1665
  header: encodedData.header.toViem(),
1223
1666
  archive: toHex(encodedData.archive),
1224
1667
  oracleInput: {
1225
- // We are currently not modifying these. See #9963
1226
- feeAssetPriceModifier: 0n
1668
+ feeAssetPriceModifier: encodedData.feeAssetPriceModifier
1227
1669
  }
1228
1670
  },
1229
1671
  encodedData.attestationsAndSigners.getPackedAttestations(),
@@ -1231,88 +1673,23 @@ export class SequencerPublisher {
1231
1673
  encodedData.attestationsAndSignersSignature.toViemSignature(),
1232
1674
  blobInput
1233
1675
  ];
1234
- const { rollupData, simulationResult } = await this.simulateProposeTx(args, timestamp, options);
1235
- return {
1236
- args,
1237
- blobEvaluationGas,
1238
- rollupData,
1239
- simulationResult
1240
- };
1241
- }
1242
- /**
1243
- * Simulates the propose tx with eth_simulateV1
1244
- * @param args - The propose tx args
1245
- * @param timestamp - The timestamp to simulate proposal at
1246
- * @returns The simulation result
1247
- */ async simulateProposeTx(args, timestamp, options) {
1248
1676
  const rollupData = encodeFunctionData({
1249
1677
  abi: RollupAbi,
1250
1678
  functionName: 'propose',
1251
1679
  args
1252
1680
  });
1253
- // override the pending checkpoint number if requested
1254
- const forcePendingCheckpointNumberStateDiff = (options.forcePendingCheckpointNumber !== undefined ? await this.rollupContract.makePendingCheckpointNumberOverride(options.forcePendingCheckpointNumber) : []).flatMap((override)=>override.stateDiff ?? []);
1255
- const stateOverrides = [
1256
- {
1257
- address: this.rollupContract.address,
1258
- // @note we override checkBlob to false since blobs are not part simulate()
1259
- stateDiff: [
1260
- {
1261
- slot: toPaddedHex(RollupContract.checkBlobStorageSlot, true),
1262
- value: toPaddedHex(0n, true)
1263
- },
1264
- ...forcePendingCheckpointNumberStateDiff
1265
- ]
1266
- }
1267
- ];
1268
- // In fisherman mode, simulate as the proposer but with sufficient balance
1269
- if (this.proposerAddressForSimulation) {
1270
- stateOverrides.push({
1271
- address: this.proposerAddressForSimulation.toString(),
1272
- balance: 10n * WEI_CONST * WEI_CONST
1273
- });
1274
- }
1275
- const simulationResult = await this.l1TxUtils.simulate({
1276
- to: this.rollupContract.address,
1277
- data: rollupData,
1278
- gas: SequencerPublisher.PROPOSE_GAS_GUESS,
1279
- ...this.proposerAddressForSimulation && {
1280
- from: this.proposerAddressForSimulation.toString()
1281
- }
1282
- }, {
1283
- // @note we add 1n to the timestamp because geth implementation doesn't like simulation timestamp to be equal to the current block timestamp
1284
- time: timestamp + 1n,
1285
- // @note reth should have a 30m gas limit per block but throws errors that this tx is beyond limit so we increase here
1286
- gasLimit: SequencerPublisher.PROPOSE_GAS_GUESS * 2n
1287
- }, stateOverrides, RollupAbi, {
1288
- // @note fallback gas estimate to use if the node doesn't support simulation API
1289
- fallbackGasEstimate: SequencerPublisher.PROPOSE_GAS_GUESS
1290
- }).catch((err)=>{
1291
- // In fisherman mode, we expect ValidatorSelection__MissingProposerSignature since fisherman doesn't have proposer signature
1292
- const viemError = formatViemError(err);
1293
- if (this.config.fishermanMode && viemError.message?.includes('ValidatorSelection__MissingProposerSignature')) {
1294
- this.log.debug(`Ignoring expected ValidatorSelection__MissingProposerSignature error in fisherman mode`);
1295
- // Return a minimal simulation result with the fallback gas estimate
1296
- return {
1297
- gasUsed: SequencerPublisher.PROPOSE_GAS_GUESS,
1298
- logs: []
1299
- };
1300
- }
1301
- this.log.error(`Failed to simulate propose tx`, viemError);
1302
- throw err;
1303
- });
1304
1681
  return {
1305
- rollupData,
1306
- simulationResult
1682
+ args,
1683
+ blobEvaluationGas,
1684
+ rollupData
1307
1685
  };
1308
1686
  }
1309
- async addProposeTx(checkpoint, encodedData, opts = {}, timestamp) {
1687
+ async addProposeTx(checkpoint, encodedData, opts = {}) {
1310
1688
  const slot = checkpoint.header.slotNumber;
1311
1689
  const timer = new Timer();
1312
1690
  const kzg = Blob.getViemKzgInstance();
1313
- const { rollupData, simulationResult, blobEvaluationGas } = await this.prepareProposeTx(encodedData, timestamp, opts);
1691
+ const { rollupData, blobEvaluationGas } = await this.prepareProposeTx(encodedData);
1314
1692
  const startBlock = await this.l1TxUtils.getBlockNumber();
1315
- const gasLimit = this.l1TxUtils.bumpGasLimit(BigInt(Math.ceil(Number(simulationResult.gasUsed) * 64 / 63)) + blobEvaluationGas + SequencerPublisher.MULTICALL_OVERHEAD_GAS_GUESS);
1316
1693
  // Send the blobs to the blob client preemptively. This helps in tests where the sequencer mistakingly thinks that the propose
1317
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.
1318
1695
  void Promise.resolve().then(()=>this.blobClient.sendBlobsToFilestore(encodedData.blobs).catch((_err)=>{
@@ -1326,9 +1703,10 @@ export class SequencerPublisher {
1326
1703
  },
1327
1704
  lastValidL2Slot: checkpoint.header.slotNumber,
1328
1705
  gasConfig: {
1329
- ...opts,
1330
- gasLimit
1706
+ txTimeoutAt: opts.txTimeoutAt,
1707
+ gasLimit: undefined
1331
1708
  },
1709
+ blobEvaluationGas,
1332
1710
  blobConfig: {
1333
1711
  blobs: encodedData.blobs.map((b)=>b.data),
1334
1712
  kzg
@@ -1338,7 +1716,11 @@ export class SequencerPublisher {
1338
1716
  return false;
1339
1717
  }
1340
1718
  const { receipt, stats, errorMsg } = result;
1341
- 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
+ });
1342
1724
  if (success) {
1343
1725
  const endBlock = receipt.blockNumber;
1344
1726
  const inclusionBlocks = Number(endBlock - startBlock);
@@ -1375,4 +1757,8 @@ export class SequencerPublisher {
1375
1757
  }
1376
1758
  });
1377
1759
  }
1760
+ /** Returns the timestamp of the next L1 slot boundary after now. */ getNextL1SlotTimestamp() {
1761
+ const l1Constants = this.epochCache.getL1Constants();
1762
+ return getNextL1SlotTimestamp(this.dateProvider.nowInSeconds(), l1Constants);
1763
+ }
1378
1764
  }