@aztec/archiver 0.0.1-commit.e588bc7e5 → 0.0.1-commit.e5a3663dd

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 (105) hide show
  1. package/dest/archiver.d.ts +19 -11
  2. package/dest/archiver.d.ts.map +1 -1
  3. package/dest/archiver.js +96 -53
  4. package/dest/config.d.ts +3 -1
  5. package/dest/config.d.ts.map +1 -1
  6. package/dest/config.js +14 -3
  7. package/dest/errors.d.ts +32 -5
  8. package/dest/errors.d.ts.map +1 -1
  9. package/dest/errors.js +51 -6
  10. package/dest/factory.d.ts +4 -4
  11. package/dest/factory.d.ts.map +1 -1
  12. package/dest/factory.js +13 -10
  13. package/dest/index.d.ts +10 -3
  14. package/dest/index.d.ts.map +1 -1
  15. package/dest/index.js +9 -2
  16. package/dest/l1/calldata_retriever.d.ts +2 -1
  17. package/dest/l1/calldata_retriever.d.ts.map +1 -1
  18. package/dest/l1/calldata_retriever.js +9 -4
  19. package/dest/l1/data_retrieval.d.ts +18 -9
  20. package/dest/l1/data_retrieval.d.ts.map +1 -1
  21. package/dest/l1/data_retrieval.js +13 -19
  22. package/dest/l1/validate_historical_logs.d.ts +23 -0
  23. package/dest/l1/validate_historical_logs.d.ts.map +1 -0
  24. package/dest/l1/validate_historical_logs.js +108 -0
  25. package/dest/modules/contract_data_source_adapter.d.ts +25 -0
  26. package/dest/modules/contract_data_source_adapter.d.ts.map +1 -0
  27. package/dest/modules/contract_data_source_adapter.js +42 -0
  28. package/dest/modules/data_source_base.d.ts +16 -10
  29. package/dest/modules/data_source_base.d.ts.map +1 -1
  30. package/dest/modules/data_source_base.js +71 -60
  31. package/dest/modules/data_store_updater.d.ts +16 -9
  32. package/dest/modules/data_store_updater.d.ts.map +1 -1
  33. package/dest/modules/data_store_updater.js +52 -40
  34. package/dest/modules/instrumentation.d.ts +7 -2
  35. package/dest/modules/instrumentation.d.ts.map +1 -1
  36. package/dest/modules/instrumentation.js +22 -6
  37. package/dest/modules/l1_synchronizer.d.ts +8 -4
  38. package/dest/modules/l1_synchronizer.d.ts.map +1 -1
  39. package/dest/modules/l1_synchronizer.js +212 -79
  40. package/dest/modules/validation.d.ts +4 -3
  41. package/dest/modules/validation.d.ts.map +1 -1
  42. package/dest/modules/validation.js +4 -4
  43. package/dest/store/block_store.d.ts +60 -21
  44. package/dest/store/block_store.d.ts.map +1 -1
  45. package/dest/store/block_store.js +229 -70
  46. package/dest/store/contract_class_store.d.ts +17 -3
  47. package/dest/store/contract_class_store.d.ts.map +1 -1
  48. package/dest/store/contract_class_store.js +17 -1
  49. package/dest/store/contract_instance_store.d.ts +28 -1
  50. package/dest/store/contract_instance_store.d.ts.map +1 -1
  51. package/dest/store/contract_instance_store.js +31 -0
  52. package/dest/store/data_stores.d.ts +68 -0
  53. package/dest/store/data_stores.d.ts.map +1 -0
  54. package/dest/store/data_stores.js +50 -0
  55. package/dest/store/function_names_cache.d.ts +17 -0
  56. package/dest/store/function_names_cache.d.ts.map +1 -0
  57. package/dest/store/function_names_cache.js +30 -0
  58. package/dest/store/l2_tips_cache.d.ts +1 -1
  59. package/dest/store/l2_tips_cache.d.ts.map +1 -1
  60. package/dest/store/l2_tips_cache.js +3 -3
  61. package/dest/store/log_store.d.ts +1 -1
  62. package/dest/store/log_store.d.ts.map +1 -1
  63. package/dest/store/log_store.js +2 -4
  64. package/dest/store/message_store.d.ts +9 -3
  65. package/dest/store/message_store.d.ts.map +1 -1
  66. package/dest/store/message_store.js +31 -1
  67. package/dest/test/fake_l1_state.d.ts +14 -3
  68. package/dest/test/fake_l1_state.d.ts.map +1 -1
  69. package/dest/test/fake_l1_state.js +55 -15
  70. package/dest/test/mock_l2_block_source.d.ts +12 -3
  71. package/dest/test/mock_l2_block_source.d.ts.map +1 -1
  72. package/dest/test/mock_l2_block_source.js +24 -2
  73. package/dest/test/noop_l1_archiver.d.ts +4 -4
  74. package/dest/test/noop_l1_archiver.d.ts.map +1 -1
  75. package/dest/test/noop_l1_archiver.js +9 -7
  76. package/package.json +13 -13
  77. package/src/archiver.ts +113 -52
  78. package/src/config.ts +15 -1
  79. package/src/errors.ts +75 -8
  80. package/src/factory.ts +11 -10
  81. package/src/index.ts +17 -2
  82. package/src/l1/calldata_retriever.ts +15 -4
  83. package/src/l1/data_retrieval.ts +30 -35
  84. package/src/l1/validate_historical_logs.ts +140 -0
  85. package/src/modules/contract_data_source_adapter.ts +59 -0
  86. package/src/modules/data_source_base.ts +75 -57
  87. package/src/modules/data_store_updater.ts +71 -39
  88. package/src/modules/instrumentation.ts +27 -7
  89. package/src/modules/l1_synchronizer.ts +301 -83
  90. package/src/modules/validation.ts +8 -7
  91. package/src/store/block_store.ts +264 -77
  92. package/src/store/contract_class_store.ts +28 -2
  93. package/src/store/contract_instance_store.ts +43 -0
  94. package/src/store/data_stores.ts +108 -0
  95. package/src/store/function_names_cache.ts +37 -0
  96. package/src/store/l2_tips_cache.ts +9 -3
  97. package/src/store/log_store.ts +2 -5
  98. package/src/store/message_store.ts +35 -2
  99. package/src/test/fake_l1_state.ts +62 -24
  100. package/src/test/mock_l2_block_source.ts +23 -2
  101. package/src/test/noop_l1_archiver.ts +9 -7
  102. package/dest/store/kv_archiver_store.d.ts +0 -377
  103. package/dest/store/kv_archiver_store.d.ts.map +0 -1
  104. package/dest/store/kv_archiver_store.js +0 -494
  105. package/src/store/kv_archiver_store.ts +0 -713
@@ -371,22 +371,26 @@ function _apply_decs_2203_r(targetClass, memberDecs, classDecs, parentClass) {
371
371
  return (_apply_decs_2203_r = applyDecs2203RFactory())(targetClass, memberDecs, classDecs, parentClass);
372
372
  }
373
373
  var _dec, _dec1, _dec2, _dec3, _initProto;
374
+ import { getFinalizedL1Block } from '@aztec/ethereum/queries';
374
375
  import { asyncPool } from '@aztec/foundation/async-pool';
375
376
  import { maxBigint } from '@aztec/foundation/bigint';
376
377
  import { BlockNumber, CheckpointNumber } from '@aztec/foundation/branded-types';
377
378
  import { Buffer16, Buffer32 } from '@aztec/foundation/buffer';
378
- import { pick } from '@aztec/foundation/collection';
379
+ import { compactArray, partition, pick } from '@aztec/foundation/collection';
380
+ import { EthAddress } from '@aztec/foundation/eth-address';
379
381
  import { createLogger } from '@aztec/foundation/log';
380
382
  import { retryTimes } from '@aztec/foundation/retry';
381
383
  import { count } from '@aztec/foundation/string';
382
384
  import { Timer, elapsed } from '@aztec/foundation/timer';
383
385
  import { isDefined, isErrorClass } from '@aztec/foundation/types';
384
386
  import { L2BlockSourceEvents } from '@aztec/stdlib/block';
387
+ import { Checkpoint, PublishedCheckpoint } from '@aztec/stdlib/checkpoint';
385
388
  import { getEpochAtSlot, getSlotAtNextL1Block } from '@aztec/stdlib/epoch-helpers';
386
389
  import { computeInHashFromL1ToL2Messages } from '@aztec/stdlib/messaging';
387
390
  import { execInSpan, trackSpan } from '@aztec/telemetry-client';
388
391
  import { InitialCheckpointNumberNotSequentialError } from '../errors.js';
389
- import { retrieveCheckpointsFromRollup, retrieveL1ToL2Message, retrieveL1ToL2Messages, retrievedToPublishedCheckpoint } from '../l1/data_retrieval.js';
392
+ import { getCheckpointBlobDataFromBlobs, retrieveCheckpointCalldataFromRollup, retrieveL1ToL2Message, retrieveL1ToL2Messages, retrievedToPublishedCheckpoint } from '../l1/data_retrieval.js';
393
+ import { getArchiverSynchPoint } from '../store/data_stores.js';
390
394
  import { MessageStoreError } from '../store/message_store.js';
391
395
  import { ArchiverDataStoreUpdater } from './data_store_updater.js';
392
396
  import { validateCheckpointAttestations } from './validation.js';
@@ -399,7 +403,7 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
399
403
  debugClient;
400
404
  rollup;
401
405
  inbox;
402
- store;
406
+ stores;
403
407
  config;
404
408
  blobClient;
405
409
  epochCache;
@@ -437,12 +441,12 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
437
441
  l1Timestamp;
438
442
  updater;
439
443
  tracer;
440
- constructor(publicClient, debugClient, rollup, inbox, store, config, blobClient, epochCache, dateProvider, instrumentation, l1Constants, events, tracer, l2TipsCache, log = createLogger('archiver:l1-sync')){
444
+ constructor(publicClient, debugClient, rollup, inbox, stores, config, blobClient, epochCache, dateProvider, instrumentation, l1Constants, events, tracer, l2TipsCache, log = createLogger('archiver:l1-sync')){
441
445
  this.publicClient = publicClient;
442
446
  this.debugClient = debugClient;
443
447
  this.rollup = rollup;
444
448
  this.inbox = inbox;
445
- this.store = store;
449
+ this.stores = stores;
446
450
  this.config = config;
447
451
  this.blobClient = blobClient;
448
452
  this.epochCache = epochCache;
@@ -452,7 +456,7 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
452
456
  this.events = events;
453
457
  this.log = log;
454
458
  _initProto(this);
455
- this.updater = new ArchiverDataStoreUpdater(this.store, l2TipsCache, {
459
+ this.updater = new ArchiverDataStoreUpdater(this.stores, l2TipsCache, {
456
460
  rollupManaLimit: l1Constants.rollupManaLimit
457
461
  });
458
462
  this.tracer = tracer;
@@ -466,6 +470,12 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
466
470
  /** Returns the last L1 timestamp that was synced. */ getL1Timestamp() {
467
471
  return this.l1Timestamp;
468
472
  }
473
+ getSignatureContext() {
474
+ return {
475
+ chainId: this.publicClient.chain.id,
476
+ rollupAddress: EthAddress.fromString(this.rollup.address)
477
+ };
478
+ }
469
479
  /** Checks that the ethereum node we are connected to has a latest timestamp no more than the allowed drift. Throw if not. */ async testEthereumNodeSynced() {
470
480
  const maxAllowedDelay = this.config.maxAllowedEthClientDriftSeconds;
471
481
  if (maxAllowedDelay === 0) {
@@ -509,16 +519,23 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
509
519
  maxAllowedDelay
510
520
  });
511
521
  }
522
+ // Query finalized block on L1
523
+ const rawFinalizedL1Block = await getFinalizedL1Block(this.publicClient);
524
+ const finalizedL1Block = rawFinalizedL1Block && {
525
+ l1BlockNumber: rawFinalizedL1Block.number,
526
+ l1BlockHash: Buffer32.fromString(rawFinalizedL1Block.hash)
527
+ };
512
528
  // Load sync point for blocks defaulting to start block
513
- const { blocksSynchedTo = this.l1Constants.l1StartBlock } = await this.store.getSynchPoint();
529
+ const { blocksSynchedTo = this.l1Constants.l1StartBlock } = await getArchiverSynchPoint(this.stores);
514
530
  this.log.debug(`Starting new archiver sync iteration`, {
515
531
  blocksSynchedTo,
516
- currentL1BlockData
532
+ currentL1BlockData,
533
+ finalizedL1Block
517
534
  });
518
535
  // Sync L1 to L2 messages. We retry this a few times since there are error conditions that reset the sync point, requiring a new iteration.
519
536
  // Note that we cannot just wait for the l1 synchronizer to loop again, since the synchronizer would report as synced up to the current L1
520
537
  // block, when that wouldn't be the case, since L1 to L2 messages would need another iteration.
521
- await retryTimes(()=>this.handleL1ToL2Messages(currentL1BlockData), 'Handling L1 to L2 messages', 3, 0.1);
538
+ await retryTimes(()=>this.handleL1ToL2Messages(currentL1BlockData, finalizedL1Block), 'Handling L1 to L2 messages', 3, 0.1);
522
539
  if (currentL1BlockNumber > blocksSynchedTo) {
523
540
  // First we retrieve new checkpoints and L2 blocks and store them in the DB. This will also update the
524
541
  // pending chain validation status, proven checkpoint number, and synched L1 block number.
@@ -535,7 +552,7 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
535
552
  // past it, since otherwise we'll keep downloading it and reprocessing it on every iteration until
536
553
  // we get a valid checkpoint to advance the syncpoint.
537
554
  if (!rollupStatus.validationResult?.valid && rollupStatus.lastL1BlockWithCheckpoint !== undefined) {
538
- await this.store.setCheckpointSynchedL1BlockNumber(rollupStatus.lastL1BlockWithCheckpoint);
555
+ await this.stores.blocks.setSynchedL1BlockNumber(rollupStatus.lastL1BlockWithCheckpoint);
539
556
  }
540
557
  // And lastly we check if we are missing any checkpoints behind us due to a possible L1 reorg.
541
558
  // We only do this if rollup cant prune on the next submission. Otherwise we will end up
@@ -547,7 +564,7 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
547
564
  this.instrumentation.updateL1BlockHeight(currentL1BlockNumber);
548
565
  }
549
566
  // Update the finalized L2 checkpoint based on L1 finality.
550
- await this.updateFinalizedCheckpoint();
567
+ await this.updateFinalizedCheckpoint(finalizedL1Block);
551
568
  // After syncing has completed, update the current l1 block number and timestamp,
552
569
  // otherwise we risk announcing to the world that we've synced to a given point,
553
570
  // but the corresponding blocks have not been processed (see #12631).
@@ -561,17 +578,17 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
561
578
  l1BlockNumberAtEnd
562
579
  });
563
580
  }
564
- /** Query L1 for its finalized block and update the finalized checkpoint accordingly. */ async updateFinalizedCheckpoint() {
581
+ /** Updates the finalized checkpoint using the pre-fetched finalized L1 block from the current sync iteration. */ async updateFinalizedCheckpoint(finalizedL1Block) {
565
582
  try {
566
- const finalizedL1Block = await this.publicClient.getBlock({
567
- blockTag: 'finalized',
568
- includeTransactions: false
569
- });
570
- const finalizedL1BlockNumber = finalizedL1Block.number;
583
+ if (!finalizedL1Block) {
584
+ this.log.trace(`Skipping finalized checkpoint update: L1 has no finalized block yet.`);
585
+ return;
586
+ }
587
+ const finalizedL1BlockNumber = finalizedL1Block.l1BlockNumber;
571
588
  const finalizedCheckpointNumber = await this.rollup.getProvenCheckpointNumber({
572
589
  blockNumber: finalizedL1BlockNumber
573
590
  });
574
- const localFinalizedCheckpointNumber = await this.store.getFinalizedCheckpointNumber();
591
+ const localFinalizedCheckpointNumber = await this.stores.blocks.getFinalizedCheckpointNumber();
575
592
  if (localFinalizedCheckpointNumber !== finalizedCheckpointNumber) {
576
593
  await this.updater.setFinalizedCheckpointNumber(finalizedCheckpointNumber);
577
594
  this.log.info(`Updated finalized chain to checkpoint ${finalizedCheckpointNumber}`, {
@@ -588,8 +605,8 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
588
605
  }
589
606
  /** Prune all proposed local blocks that should have been checkpointed by now. */ async pruneUncheckpointedBlocks(currentL1Timestamp) {
590
607
  const [lastCheckpointedBlockNumber, lastProposedBlockNumber] = await Promise.all([
591
- this.store.getCheckpointedL2BlockNumber(),
592
- this.store.getLatestBlockNumber()
608
+ this.stores.blocks.getCheckpointedL2BlockNumber(),
609
+ this.stores.blocks.getLatestL2BlockNumber()
593
610
  ]);
594
611
  // If there are no uncheckpointed blocks, we got nothing to do
595
612
  if (lastProposedBlockNumber === lastCheckpointedBlockNumber) {
@@ -600,7 +617,7 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
600
617
  const slotAtNextL1Block = getSlotAtNextL1Block(currentL1Timestamp, this.l1Constants);
601
618
  const firstUncheckpointedBlockNumber = BlockNumber(lastCheckpointedBlockNumber + 1);
602
619
  // What's the slot of the first uncheckpointed block?
603
- const [firstUncheckpointedBlockHeader] = await this.store.getBlockHeaders(firstUncheckpointedBlockNumber, 1);
620
+ const [firstUncheckpointedBlockHeader] = await this.stores.blocks.getBlockHeaders(firstUncheckpointedBlockNumber, 1);
604
621
  const firstUncheckpointedBlockSlot = firstUncheckpointedBlockHeader?.getSlot();
605
622
  if (firstUncheckpointedBlockSlot === undefined || firstUncheckpointedBlockSlot >= slotAtNextL1Block) {
606
623
  return;
@@ -636,7 +653,7 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
636
653
  }
637
654
  /** Checks if there'd be a reorg for the next checkpoint submission and start pruning now. */ async handleEpochPrune(provenCheckpointNumber, currentL1BlockNumber, currentL1Timestamp) {
638
655
  const rollupCanPrune = await this.canPrune(currentL1BlockNumber, currentL1Timestamp);
639
- const localPendingCheckpointNumber = await this.store.getSynchedCheckpointNumber();
656
+ const localPendingCheckpointNumber = await this.stores.blocks.getLatestCheckpointNumber();
640
657
  const canPrune = localPendingCheckpointNumber > provenCheckpointNumber && rollupCanPrune;
641
658
  if (canPrune) {
642
659
  const timer = new Timer();
@@ -654,8 +671,8 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
654
671
  const indices = Array.from({
655
672
  length: checkpointsToUnwind
656
673
  }, (_, i)=>CheckpointNumber(i + pruneFrom));
657
- const checkpoints = (await asyncPool(BATCH_SIZE, indices, (idx)=>this.store.getCheckpointData(idx))).filter(isDefined);
658
- const newBlocks = (await asyncPool(BATCH_SIZE, checkpoints, (cp)=>this.store.getBlocksForCheckpoint(CheckpointNumber(cp.checkpointNumber)))).filter(isDefined).flat();
674
+ const checkpoints = (await asyncPool(BATCH_SIZE, indices, (idx)=>this.stores.blocks.getCheckpointData(idx))).filter(isDefined);
675
+ const newBlocks = (await asyncPool(BATCH_SIZE, checkpoints, (cp)=>this.stores.blocks.getBlocksForCheckpoint(CheckpointNumber(cp.checkpointNumber)))).filter(isDefined).flat();
659
676
  // Emit an event for listening services to react to the chain prune
660
677
  this.events.emit(L2BlockSourceEvents.L2PruneUnproven, {
661
678
  type: L2BlockSourceEvents.L2PruneUnproven,
@@ -664,11 +681,11 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
664
681
  });
665
682
  this.log.debug(`L2 prune from ${provenCheckpointNumber + 1} to ${localPendingCheckpointNumber} will occur on next checkpoint submission.`);
666
683
  await this.updater.removeCheckpointsAfter(provenCheckpointNumber);
667
- this.log.warn(`Removed ${count(checkpointsToUnwind, 'checkpoint')} after checkpoint ${provenCheckpointNumber} ` + `due to predicted reorg at L1 block ${currentL1BlockNumber}. ` + `Updated latest checkpoint is ${await this.store.getSynchedCheckpointNumber()}.`);
684
+ this.log.warn(`Removed ${count(checkpointsToUnwind, 'checkpoint')} after checkpoint ${provenCheckpointNumber} ` + `due to predicted reorg at L1 block ${currentL1BlockNumber}. ` + `Updated latest checkpoint is ${await this.stores.blocks.getLatestCheckpointNumber()}.`);
668
685
  this.instrumentation.processPrune(timer.ms());
669
686
  // TODO(palla/reorg): Do we need to set the block synched L1 block number here?
670
687
  // Seems like the next iteration should handle this.
671
- // await this.store.setCheckpointSynchedL1BlockNumber(currentL1BlockNumber);
688
+ // await this.stores.blocks.setSynchedL1BlockNumber(currentL1BlockNumber);
672
689
  }
673
690
  return {
674
691
  rollupCanPrune
@@ -689,12 +706,12 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
689
706
  nextEnd
690
707
  ];
691
708
  }
692
- async handleL1ToL2Messages(currentL1Block) {
709
+ async handleL1ToL2Messages(currentL1Block, finalizedL1Block) {
693
710
  // Load the syncpoint, which may have been updated in a previous iteration
694
711
  const { messagesSynchedTo = {
695
712
  l1BlockNumber: this.l1Constants.l1StartBlock,
696
713
  l1BlockHash: this.l1Constants.l1StartBlockHash
697
- } } = await this.store.getSynchPoint();
714
+ } } = await getArchiverSynchPoint(this.stores);
698
715
  // Nothing to do if L1 block number has not moved forward
699
716
  const currentL1BlockNumber = currentL1Block.l1BlockNumber;
700
717
  if (currentL1BlockNumber <= messagesSynchedTo.l1BlockNumber) {
@@ -704,10 +721,10 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
704
721
  const remoteMessagesState = await this.inbox.getState({
705
722
  blockNumber: currentL1BlockNumber
706
723
  });
707
- const localLastMessage = await this.store.getLastL1ToL2Message();
724
+ const localLastMessage = await this.stores.messages.getLastMessage();
708
725
  if (await this.localStateMatches(localLastMessage, remoteMessagesState)) {
709
726
  this.log.trace(`Local L1 to L2 messages are already in sync with remote at L1 block ${currentL1BlockNumber}`);
710
- await this.store.setMessageSyncState(currentL1Block, remoteMessagesState.treeInProgress);
727
+ await this.stores.messages.setMessageSyncState(currentL1Block, remoteMessagesState.treeInProgress, finalizedL1Block);
711
728
  return true;
712
729
  }
713
730
  // If not, then we are out of sync. Most likely there are new messages on the inbox, so we try retrieving them.
@@ -721,7 +738,7 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
721
738
  this.log.warn(`Failed to store L1 to L2 messages retrieved from L1: ${error.message}. Rolling back syncpoint to retry.`, {
722
739
  inboxMessage: error.inboxMessage
723
740
  });
724
- await this.rollbackL1ToL2Messages(remoteMessagesState.treeInProgress);
741
+ await this.rollbackL1ToL2Messages(remoteMessagesState);
725
742
  return false;
726
743
  }
727
744
  throw error;
@@ -729,21 +746,21 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
729
746
  // Note that, if there are no new messages to insert, but there was an L1 reorg that pruned out last messages,
730
747
  // we'd notice by comparing our local state with the remote one again, and seeing they don't match even after
731
748
  // our sync attempt. In this case, we also rollback our syncpoint, and trigger a retry.
732
- const localLastMessageAfterSync = await this.store.getLastL1ToL2Message();
749
+ const localLastMessageAfterSync = await this.stores.messages.getLastMessage();
733
750
  if (!await this.localStateMatches(localLastMessageAfterSync, remoteMessagesState)) {
734
751
  this.log.warn(`Local L1 to L2 messages state does not match remote after sync attempt. Rolling back syncpoint to retry.`, {
735
752
  localLastMessageAfterSync,
736
753
  remoteMessagesState
737
754
  });
738
- await this.rollbackL1ToL2Messages(remoteMessagesState.treeInProgress);
755
+ await this.rollbackL1ToL2Messages(remoteMessagesState);
739
756
  return false;
740
757
  }
741
758
  // Advance the syncpoint after a successful sync
742
- await this.store.setMessageSyncState(currentL1Block, remoteMessagesState.treeInProgress);
759
+ await this.stores.messages.setMessageSyncState(currentL1Block, remoteMessagesState.treeInProgress, finalizedL1Block);
743
760
  return true;
744
761
  }
745
762
  /** Checks if the local rolling hash and message count matches the remote state */ async localStateMatches(localLastMessage, remoteState) {
746
- const localMessageCount = await this.store.getTotalL1ToL2MessageCount();
763
+ const localMessageCount = await this.stores.messages.getTotalL1ToL2MessageCount();
747
764
  this.log.trace(`Comparing local and remote inbox state`, {
748
765
  localMessageCount,
749
766
  localLastMessage,
@@ -761,7 +778,7 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
761
778
  this.log.trace(`Retrieving L1 to L2 messages in L1 blocks ${searchStartBlock}-${searchEndBlock}`);
762
779
  const messages = await retrieveL1ToL2Messages(this.inbox, searchStartBlock, searchEndBlock);
763
780
  const timer = new Timer();
764
- await this.store.addL1ToL2Messages(messages);
781
+ await this.stores.messages.addL1ToL2Messages(messages);
765
782
  const perMsg = timer.ms() / messages.length;
766
783
  this.instrumentation.processNewMessages(messages.length, perMsg);
767
784
  for (const msg of messages){
@@ -783,23 +800,47 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
783
800
  /**
784
801
  * Rolls back local L1 to L2 messages to the last common message with L1, and updates the syncpoint to the L1 block of that message.
785
802
  * If no common message is found, rolls back all messages and sets the syncpoint to the start block.
786
- */ async rollbackL1ToL2Messages(remoteTreeInProgress) {
787
- // Slowly go back through our messages until we find the last common message.
788
- // We could query the logs in batch as an optimization, but the depth of the reorg should not be deep, and this
789
- // is a very rare case, so it's fine to query one log at a time.
803
+ */ async rollbackL1ToL2Messages(remoteMessagesState) {
804
+ const { treeInProgress: remoteTreeInProgress, messagesRollingHash: remoteRollingHash } = remoteMessagesState;
805
+ const messagesFinalizedL1Block = await this.stores.messages.getMessagesFinalizedL1Block();
806
+ const finalizedL1BlockNumber = messagesFinalizedL1Block?.l1BlockNumber;
807
+ // Slowly go back through our messages until we find the last common message. We could query the logs in
808
+ // batch as an optimization, but the depth of the reorg should not be deep, and this is a very rare case,
809
+ // so it's fine to query one log at a time.
790
810
  let commonMsg;
791
811
  let messagesToDelete = 0;
792
812
  this.log.verbose(`Searching most recent common L1 to L2 message`);
793
- for await (const localMsg of this.store.iterateL1ToL2Messages({
813
+ for await (const localMsg of this.stores.messages.iterateL1ToL2Messages({
794
814
  reverse: true
795
815
  })){
796
- const remoteMsg = await retrieveL1ToL2Message(this.inbox, localMsg);
797
816
  const logCtx = {
798
- remoteMsg,
799
- localMsg: localMsg
817
+ remoteMsg: undefined,
818
+ localMsg,
819
+ remoteMessagesState
800
820
  };
821
+ // First check if the local message rolling hash matches the current rolling hash of the inbox contract,
822
+ // which means we just need to rollback some local messages and we should be back in sync. This means there
823
+ // was an L1 reorg that removed some of the messages we had, but no new messages were added compared.
824
+ if (localMsg.rollingHash.equals(remoteRollingHash)) {
825
+ this.log.info(`Found common L1 to L2 message at index ${localMsg.index} on L1 block ${localMsg.l1BlockNumber} matching current remote state`, logCtx);
826
+ commonMsg = localMsg;
827
+ break;
828
+ }
829
+ // Messages at or below the finalized L1 block cannot have been reorged — accept as common without querying L1.
830
+ if (finalizedL1BlockNumber !== undefined && localMsg.l1BlockNumber <= finalizedL1BlockNumber) {
831
+ this.log.info(`Found common L1 to L2 message at finalized L1 block ${localMsg.l1BlockNumber}`, logCtx);
832
+ commonMsg = localMsg;
833
+ break;
834
+ }
835
+ // If there's no match with the current remote state, check if the message exists on the inbox contract at all
836
+ // by looking at the inbox events. If the L1 reorg *added* new messages in addition to deleting existing ones,
837
+ // then the current remote state's rolling hash will not match anything we have locally, so we need to check existence
838
+ // of individual messages via logs. Note we use logs and not historical queries so we don't have to depend on
839
+ // an archival rpc node, since the message could be from a long time ago if we're catching up with syncing.
840
+ const remoteMsg = await retrieveL1ToL2Message(this.inbox, localMsg);
841
+ logCtx.remoteMsg = remoteMsg;
801
842
  if (remoteMsg && remoteMsg.rollingHash.equals(localMsg.rollingHash)) {
802
- this.log.verbose(`Found most recent common L1 to L2 message at index ${localMsg.index} on L1 block ${localMsg.l1BlockNumber}`, logCtx);
843
+ this.log.info(`Found most recent common L1 to L2 message at index ${localMsg.index} on L1 block ${localMsg.l1BlockNumber}`, logCtx);
803
844
  commonMsg = remoteMsg;
804
845
  break;
805
846
  } else if (remoteMsg) {
@@ -815,19 +856,24 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
815
856
  if (messagesToDelete > 0) {
816
857
  const lastGoodIndex = commonMsg?.index;
817
858
  this.log.warn(`Rolling back all local L1 to L2 messages after index ${lastGoodIndex ?? 'initial'}`);
818
- await this.store.removeL1ToL2Messages(lastGoodIndex !== undefined ? lastGoodIndex + 1n : 0n);
859
+ await this.stores.messages.removeL1ToL2Messages(lastGoodIndex !== undefined ? lastGoodIndex + 1n : 0n);
819
860
  }
820
861
  // Update the syncpoint so the loop below reprocesses the changed messages. We go to the block before
821
862
  // the last common one, so we force reprocessing it, in case new messages were added on that same L1 block
822
- // after the last common message.
823
- const syncPointL1BlockNumber = commonMsg ? commonMsg.l1BlockNumber - 1n : this.l1Constants.l1StartBlock;
824
- const syncPointL1BlockHash = await this.getL1BlockHash(syncPointL1BlockNumber);
863
+ // after the last common message. Cap at the finalized L1 block: messages at or below finalized cannot
864
+ // have been reorged, so there is no need to walk back any further than that.
865
+ const syncPointL1BlockNumber = maxBigint(...compactArray([
866
+ commonMsg ? commonMsg.l1BlockNumber - 1n : undefined,
867
+ finalizedL1BlockNumber,
868
+ this.l1Constants.l1StartBlock
869
+ ]));
870
+ const syncPointL1BlockHash = syncPointL1BlockNumber === finalizedL1BlockNumber ? messagesFinalizedL1Block.l1BlockHash : await this.getL1BlockHash(syncPointL1BlockNumber);
825
871
  const messagesSyncPoint = {
826
872
  l1BlockNumber: syncPointL1BlockNumber,
827
873
  l1BlockHash: syncPointL1BlockHash
828
874
  };
829
- await this.store.setMessageSyncState(messagesSyncPoint, remoteTreeInProgress);
830
- this.log.verbose(`Updated messages syncpoint to L1 block ${syncPointL1BlockNumber}`, {
875
+ await this.stores.messages.setMessageSyncState(messagesSyncPoint, remoteTreeInProgress);
876
+ this.log.verbose(`Updated messages syncpoint to L1 block ${messagesSyncPoint.l1BlockNumber}`, {
831
877
  ...messagesSyncPoint,
832
878
  remoteTreeInProgress
833
879
  });
@@ -844,8 +890,8 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
844
890
  return Buffer32.fromString(block.hash);
845
891
  }
846
892
  async handleCheckpoints(blocksSynchedTo, currentL1BlockNumber, initialSyncComplete) {
847
- const localPendingCheckpointNumber = await this.store.getSynchedCheckpointNumber();
848
- const initialValidationResult = await this.store.getPendingChainValidationStatus();
893
+ const localPendingCheckpointNumber = await this.stores.blocks.getLatestCheckpointNumber();
894
+ const initialValidationResult = await this.stores.blocks.getPendingChainValidationStatus();
849
895
  const { provenCheckpointNumber, provenArchive, pendingCheckpointNumber, pendingArchive, archiveOfMyCheckpoint: archiveForLocalPendingCheckpointNumber } = await execInSpan(this.tracer, 'Archiver.getRollupStatus', ()=>this.rollup.status(localPendingCheckpointNumber, {
850
896
  blockNumber: currentL1BlockNumber
851
897
  }));
@@ -868,7 +914,7 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
868
914
  // we need to set it to zero. This is an edge case because we dont have a checkpoint zero (initial checkpoint is one),
869
915
  // so localCheckpointForDestinationProvenCheckpointNumber would not be found below.
870
916
  if (provenCheckpointNumber === 0) {
871
- const localProvenCheckpointNumber = await this.store.getProvenCheckpointNumber();
917
+ const localProvenCheckpointNumber = await this.stores.blocks.getProvenCheckpointNumber();
872
918
  if (localProvenCheckpointNumber !== provenCheckpointNumber) {
873
919
  await this.updater.setProvenCheckpointNumber(provenCheckpointNumber);
874
920
  this.log.info(`Rolled back proven chain to checkpoint ${provenCheckpointNumber}`, {
@@ -876,16 +922,16 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
876
922
  });
877
923
  }
878
924
  }
879
- const localCheckpointForDestinationProvenCheckpointNumber = await this.store.getCheckpointData(provenCheckpointNumber);
925
+ const localCheckpointForDestinationProvenCheckpointNumber = await this.stores.blocks.getCheckpointData(provenCheckpointNumber);
880
926
  // Sanity check. I've hit what seems to be a state where the proven checkpoint is set to a value greater than the latest
881
927
  // synched checkpoint when requesting L2Tips from the archiver. This is the only place where the proven checkpoint is set.
882
- const synched = await this.store.getSynchedCheckpointNumber();
928
+ const synched = await this.stores.blocks.getLatestCheckpointNumber();
883
929
  if (localCheckpointForDestinationProvenCheckpointNumber && synched < localCheckpointForDestinationProvenCheckpointNumber.checkpointNumber) {
884
930
  this.log.error(`Hit local checkpoint greater than last synched checkpoint: ${localCheckpointForDestinationProvenCheckpointNumber.checkpointNumber} > ${synched}`);
885
931
  }
886
932
  this.log.trace(`Local checkpoint for remote proven checkpoint ${provenCheckpointNumber} is ${localCheckpointForDestinationProvenCheckpointNumber?.archive.root.toString() ?? 'undefined'}`);
887
933
  if (localCheckpointForDestinationProvenCheckpointNumber && provenArchive.equals(localCheckpointForDestinationProvenCheckpointNumber.archive.root)) {
888
- const localProvenCheckpointNumber = await this.store.getProvenCheckpointNumber();
934
+ const localProvenCheckpointNumber = await this.stores.blocks.getProvenCheckpointNumber();
889
935
  if (localProvenCheckpointNumber !== provenCheckpointNumber) {
890
936
  await this.updater.setProvenCheckpointNumber(provenCheckpointNumber);
891
937
  this.log.info(`Updated proven chain to checkpoint ${provenCheckpointNumber}`, {
@@ -910,7 +956,7 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
910
956
  // If we have 0 checkpoints locally and there are no checkpoints onchain there is nothing to do.
911
957
  const noCheckpoints = localPendingCheckpointNumber === 0 && pendingCheckpointNumber === 0;
912
958
  if (noCheckpoints) {
913
- await this.store.setCheckpointSynchedL1BlockNumber(currentL1BlockNumber);
959
+ await this.stores.blocks.setSynchedL1BlockNumber(currentL1BlockNumber);
914
960
  this.log.debug(`No checkpoints to retrieve from ${blocksSynchedTo + 1n} to ${currentL1BlockNumber}, no checkpoints on chain`);
915
961
  return rollupStatus;
916
962
  }
@@ -918,7 +964,7 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
918
964
  // Related to the L2 reorgs of the pending chain. We are only interested in actually addressing a reorg if there
919
965
  // are any state that could be impacted by it. If we have no checkpoints, there is no impact.
920
966
  if (localPendingCheckpointNumber > 0) {
921
- const localPendingCheckpoint = await this.store.getCheckpointData(localPendingCheckpointNumber);
967
+ const localPendingCheckpoint = await this.stores.blocks.getCheckpointData(localPendingCheckpointNumber);
922
968
  if (localPendingCheckpoint === undefined) {
923
969
  throw new Error(`Missing checkpoint ${localPendingCheckpointNumber}`);
924
970
  }
@@ -932,7 +978,7 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
932
978
  // However, in the re-org scenario, our L1 node is temporarily lying to us and we end up potentially missing checkpoints.
933
979
  // We must only set this block number based on actually retrieved logs.
934
980
  // TODO(#8621): Tackle this properly when we handle L1 Re-orgs.
935
- // await this.store.setCheckpointSynchedL1BlockNumber(currentL1BlockNumber);
981
+ // await this.stores.blocks.setSynchedL1BlockNumber(currentL1BlockNumber);
936
982
  this.log.debug(`No checkpoints to retrieve from ${blocksSynchedTo + 1n} to ${currentL1BlockNumber}`);
937
983
  return rollupStatus;
938
984
  }
@@ -949,7 +995,7 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
949
995
  });
950
996
  let tipAfterUnwind = localPendingCheckpointNumber;
951
997
  while(true){
952
- const candidateCheckpoint = await this.store.getCheckpointData(tipAfterUnwind);
998
+ const candidateCheckpoint = await this.stores.blocks.getCheckpointData(tipAfterUnwind);
953
999
  if (candidateCheckpoint === undefined) {
954
1000
  break;
955
1001
  }
@@ -965,7 +1011,7 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
965
1011
  }
966
1012
  const checkpointsToRemove = localPendingCheckpointNumber - tipAfterUnwind;
967
1013
  await this.updater.removeCheckpointsAfter(CheckpointNumber(tipAfterUnwind));
968
- this.log.warn(`Removed ${count(checkpointsToRemove, 'checkpoint')} after checkpoint ${tipAfterUnwind} ` + `due to mismatched checkpoint hashes at L1 block ${currentL1BlockNumber}. ` + `Updated L2 latest checkpoint is ${await this.store.getSynchedCheckpointNumber()}.`);
1014
+ this.log.warn(`Removed ${count(checkpointsToRemove, 'checkpoint')} after checkpoint ${tipAfterUnwind} ` + `due to mismatched checkpoint hashes at L1 block ${currentL1BlockNumber}. ` + `Updated L2 latest checkpoint is ${await this.stores.blocks.getLatestCheckpointNumber()}.`);
969
1015
  }
970
1016
  }
971
1017
  // Retrieve checkpoints in batches. Each batch is estimated to accommodate up to 'blockBatchSize' L1 blocks,
@@ -977,25 +1023,43 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
977
1023
  do {
978
1024
  [searchStartBlock, searchEndBlock] = this.nextRange(searchEndBlock, currentL1BlockNumber);
979
1025
  this.log.trace(`Retrieving checkpoints from L1 block ${searchStartBlock} to ${searchEndBlock}`);
980
- // TODO(md): Retrieve from blob client then from consensus client, then from peers
981
- const retrievedCheckpoints = await execInSpan(this.tracer, 'Archiver.retrieveCheckpointsFromRollup', ()=>retrieveCheckpointsFromRollup(this.rollup, this.publicClient, this.debugClient, this.blobClient, searchStartBlock, searchEndBlock, this.instrumentation, this.log, !initialSyncComplete));
982
- if (retrievedCheckpoints.length === 0) {
1026
+ // First fetch calldata only, no blobs yet, since we may be able to just get that data out of the proposed chain
1027
+ const calldataCheckpoints = await execInSpan(this.tracer, 'Archiver.retrieveCheckpointCalldataFromRollup', ()=>retrieveCheckpointCalldataFromRollup(this.rollup, this.publicClient, this.debugClient, searchStartBlock, searchEndBlock, this.instrumentation, this.log));
1028
+ if (calldataCheckpoints.length === 0) {
983
1029
  // We are not calling `setBlockSynchedL1BlockNumber` because it may cause sync issues if based off infura.
984
1030
  // See further details in earlier comments.
985
1031
  this.log.trace(`Retrieved no new checkpoints from L1 block ${searchStartBlock} to ${searchEndBlock}`);
986
1032
  continue;
987
1033
  }
988
- this.log.debug(`Retrieved ${retrievedCheckpoints.length} new checkpoints between L1 blocks ${searchStartBlock} and ${searchEndBlock}`, {
989
- lastProcessedCheckpoint: retrievedCheckpoints[retrievedCheckpoints.length - 1].l1,
1034
+ this.log.debug(`Retrieved ${calldataCheckpoints.length} new checkpoint calldata between L1 blocks ${searchStartBlock} and ${searchEndBlock}`, {
1035
+ lastProcessedCheckpoint: calldataCheckpoints[calldataCheckpoints.length - 1].l1,
990
1036
  searchStartBlock,
991
1037
  searchEndBlock
992
1038
  });
993
- const publishedCheckpoints = await Promise.all(retrievedCheckpoints.map((b)=>retrievedToPublishedCheckpoint(b)));
1039
+ // Check if the last checkpoint matches a local pending entry (so we can skip blob fetch).
1040
+ // We only check the last one; if it matches, the blob fetch is skipped for that entry.
1041
+ // TODO(palla/pipelining): We may have more than a single checkpoint to promote
1042
+ const lastCalldataCheckpoint = calldataCheckpoints[calldataCheckpoints.length - 1];
1043
+ const promoteResult = await this.tryBuildPublishedCheckpointFromProposed(lastCalldataCheckpoint);
1044
+ const checkpointToPromote = promoteResult && !('diverged' in promoteResult) ? promoteResult : undefined;
1045
+ const evictProposedFrom = promoteResult && 'diverged' in promoteResult ? promoteResult.fromCheckpointNumber : undefined;
1046
+ // Then fetch blobs in parallel and build the full published checkpoints
1047
+ const toFetchBlobs = checkpointToPromote ? calldataCheckpoints.slice(0, -1) : calldataCheckpoints;
1048
+ const blobFetched = await asyncPool(10, toFetchBlobs, async (checkpoint)=>retrievedToPublishedCheckpoint({
1049
+ ...checkpoint,
1050
+ checkpointBlobData: await getCheckpointBlobDataFromBlobs(this.blobClient, checkpoint.l1.blockHash, checkpoint.blobHashes, checkpoint.checkpointNumber, this.log, !initialSyncComplete, checkpoint.parentBeaconBlockRoot, checkpoint.l1.timestamp)
1051
+ }));
1052
+ // And add the promoted checkpoint to the list of all checkpoints
1053
+ const publishedCheckpoints = checkpointToPromote ? [
1054
+ ...blobFetched,
1055
+ checkpointToPromote
1056
+ ] : blobFetched;
994
1057
  const validCheckpoints = [];
1058
+ // Now loop through all checkpoints and validate their attestations
995
1059
  for (const published of publishedCheckpoints){
996
1060
  const validationResult = this.config.skipValidateCheckpointAttestations ? {
997
1061
  valid: true
998
- } : await validateCheckpointAttestations(published, this.epochCache, this.l1Constants, this.log);
1062
+ } : await validateCheckpointAttestations(published, this.epochCache, this.l1Constants, this.getSignatureContext(), this.log);
999
1063
  // Only update the validation result if it has changed, so we can keep track of the first invalid checkpoint
1000
1064
  // in case there is a sequence of more than one invalid checkpoint, as we need to invalidate the first one.
1001
1065
  // There is an exception though: if a checkpoint is invalidated and replaced with another invalid checkpoint,
@@ -1020,7 +1084,7 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
1020
1084
  // Check the inHash of the checkpoint against the l1->l2 messages.
1021
1085
  // The messages should've been synced up to the currentL1BlockNumber and must be available for the published
1022
1086
  // checkpoints we just retrieved.
1023
- const l1ToL2Messages = await this.store.getL1ToL2Messages(published.checkpoint.number);
1087
+ const l1ToL2Messages = await this.stores.messages.getL1ToL2Messages(published.checkpoint.number);
1024
1088
  const computedInHash = computeInHashFromL1ToL2Messages(l1ToL2Messages);
1025
1089
  const publishedInHash = published.checkpoint.header.inHash;
1026
1090
  if (!computedInHash.equals(publishedInHash)) {
@@ -1050,8 +1114,17 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
1050
1114
  }
1051
1115
  try {
1052
1116
  const updatedValidationResult = rollupStatus.validationResult === initialValidationResult ? undefined : rollupStatus.validationResult;
1053
- const [processDuration, result] = await elapsed(()=>execInSpan(this.tracer, 'Archiver.addCheckpoints', ()=>this.updater.addCheckpoints(validCheckpoints, updatedValidationResult)));
1054
- this.instrumentation.processNewBlocks(processDuration / validCheckpoints.length, validCheckpoints.flatMap((c)=>c.checkpoint.blocks));
1117
+ // Split valid checkpoints: the promoted one (if any) is persisted via the proposed-promotion path,
1118
+ // the rest via addCheckpoints. Both paths run within the same store transaction for atomicity.
1119
+ const [[maybeValidCheckpointToPromote], checkpointsToAdd] = partition(validCheckpoints, (c)=>c.checkpoint.number === checkpointToPromote?.checkpoint.number);
1120
+ const [processDuration, result] = await elapsed(()=>execInSpan(this.tracer, 'Archiver.addCheckpoints', ()=>this.updater.addCheckpoints(checkpointsToAdd, updatedValidationResult, maybeValidCheckpointToPromote && {
1121
+ l1: lastCalldataCheckpoint.l1,
1122
+ attestations: lastCalldataCheckpoint.attestations,
1123
+ checkpoint: maybeValidCheckpointToPromote
1124
+ }, evictProposedFrom)));
1125
+ if (checkpointsToAdd.length > 0) {
1126
+ this.instrumentation.processNewCheckpointedBlocks(processDuration / checkpointsToAdd.length, checkpointsToAdd.flatMap((c)=>c.checkpoint.blocks));
1127
+ }
1055
1128
  // If blocks were pruned due to conflict with L1 checkpoints, emit event
1056
1129
  if (result.prunedBlocks && result.prunedBlocks.length > 0) {
1057
1130
  const prunedCheckpointNumber = result.prunedBlocks[0].checkpointNumber;
@@ -1073,9 +1146,9 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
1073
1146
  } catch (err) {
1074
1147
  if (err instanceof InitialCheckpointNumberNotSequentialError) {
1075
1148
  const { previousCheckpointNumber, newCheckpointNumber } = err;
1076
- const previousCheckpoint = previousCheckpointNumber ? await this.store.getCheckpointData(CheckpointNumber(previousCheckpointNumber)) : undefined;
1149
+ const previousCheckpoint = previousCheckpointNumber ? await this.stores.blocks.getCheckpointData(CheckpointNumber(previousCheckpointNumber)) : undefined;
1077
1150
  const updatedL1SyncPoint = previousCheckpoint?.l1.blockNumber ?? this.l1Constants.l1StartBlock;
1078
- await this.store.setCheckpointSynchedL1BlockNumber(updatedL1SyncPoint);
1151
+ await this.stores.blocks.setSynchedL1BlockNumber(updatedL1SyncPoint);
1079
1152
  this.log.warn(`Attempting to insert checkpoint ${newCheckpointNumber} with previous block ${previousCheckpointNumber}. Rolling back L1 sync point to ${updatedL1SyncPoint} to try and fetch the missing blocks.`, {
1080
1153
  previousCheckpointNumber,
1081
1154
  newCheckpointNumber,
@@ -1096,7 +1169,7 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
1096
1169
  });
1097
1170
  }
1098
1171
  lastRetrievedCheckpoint = validCheckpoints.at(-1) ?? lastRetrievedCheckpoint;
1099
- lastL1BlockWithCheckpoint = retrievedCheckpoints.at(-1)?.l1.blockNumber ?? lastL1BlockWithCheckpoint;
1172
+ lastL1BlockWithCheckpoint = calldataCheckpoints.at(-1)?.l1.blockNumber ?? lastL1BlockWithCheckpoint;
1100
1173
  }while (searchEndBlock < currentL1BlockNumber)
1101
1174
  // Important that we update AFTER inserting the blocks.
1102
1175
  await updateProvenCheckpoint();
@@ -1106,11 +1179,71 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
1106
1179
  lastL1BlockWithCheckpoint
1107
1180
  };
1108
1181
  }
1182
+ /**
1183
+ * Checks if a specific checkpoint matches a local pending entry, and if so, loads local data to build
1184
+ * a synthetic published checkpoint (skipping blob fetch).
1185
+ *
1186
+ * Returns { diverged: true, fromCheckpointNumber } when the L1 checkpoint does NOT match local pending
1187
+ * data for that number, so the caller can evict the entire pending suffix >= fromCheckpointNumber
1188
+ * (those entries chain off the now-invalid local state) within the same addCheckpoints transaction.
1189
+ */ async tryBuildPublishedCheckpointFromProposed(calldataCheckpoint) {
1190
+ if (this.config.skipPromoteProposedCheckpointDuringL1Sync || !calldataCheckpoint) {
1191
+ return undefined;
1192
+ }
1193
+ // Look up the specific pending entry for the checkpoint being mined, not just the tip
1194
+ const proposed = await this.stores.blocks.getProposedCheckpointByNumber(calldataCheckpoint.checkpointNumber);
1195
+ if (!proposed) {
1196
+ return undefined;
1197
+ }
1198
+ if (!proposed.header.equals(calldataCheckpoint.header) || !proposed.archive.root.equals(calldataCheckpoint.archiveRoot)) {
1199
+ this.log.warn(`Local proposed checkpoint ${proposed.checkpointNumber} does not match checkpoint retrieved from L1, overriding with L1 data`, {
1200
+ proposedCheckpointNumber: proposed.checkpointNumber,
1201
+ proposedHeader: proposed.header.toInspect(),
1202
+ proposedArchiveRoot: proposed.archive.root.toString(),
1203
+ calldataCheckpointNumber: calldataCheckpoint.checkpointNumber,
1204
+ calldataHeader: calldataCheckpoint.header.toInspect(),
1205
+ calldataArchiveRoot: calldataCheckpoint.archiveRoot.toString()
1206
+ });
1207
+ // Return a divergence signal so the caller can evict pending >= this number
1208
+ return {
1209
+ diverged: true,
1210
+ fromCheckpointNumber: proposed.checkpointNumber
1211
+ };
1212
+ }
1213
+ this.log.debug(`Building published checkpoint from proposed ${calldataCheckpoint.checkpointNumber} (skipping blob fetch)`, {
1214
+ proposedHeader: proposed.header.toInspect(),
1215
+ proposedArchiveRoot: proposed.archive.root.toString()
1216
+ });
1217
+ const blocks = await this.stores.blocks.getBlocks(BlockNumber(proposed.startBlock), proposed.blockCount);
1218
+ if (blocks.length !== proposed.blockCount) {
1219
+ this.log.warn(`Local proposed checkpoint ${proposed.checkpointNumber} has wrong block count (expected ${proposed.blockCount} blocks starting at ${proposed.startBlock} but got ${blocks.length})`, {
1220
+ proposedCheckpointNumber: proposed.checkpointNumber,
1221
+ proposedStartBlock: proposed.startBlock,
1222
+ proposedBlockCount: proposed.blockCount,
1223
+ retrievedBlocks: blocks.map((b)=>b.number)
1224
+ });
1225
+ return undefined;
1226
+ }
1227
+ const checkpoint = Checkpoint.from({
1228
+ archive: proposed.archive,
1229
+ header: proposed.header,
1230
+ blocks,
1231
+ number: proposed.checkpointNumber,
1232
+ feeAssetPriceModifier: proposed.feeAssetPriceModifier
1233
+ });
1234
+ const promotedCheckpoint = PublishedCheckpoint.from({
1235
+ checkpoint,
1236
+ l1: calldataCheckpoint.l1,
1237
+ attestations: calldataCheckpoint.attestations
1238
+ });
1239
+ this.instrumentation.processCheckpointPromoted();
1240
+ return promotedCheckpoint;
1241
+ }
1109
1242
  async checkForNewCheckpointsBeforeL1SyncPoint(status, blocksSynchedTo, currentL1BlockNumber) {
1110
1243
  const { lastRetrievedCheckpoint, pendingCheckpointNumber } = status;
1111
1244
  // Compare the last checkpoint we have (either retrieved in this round or loaded from store) with what the
1112
1245
  // rollup contract told us was the latest one (pinned at the currentL1BlockNumber).
1113
- const latestLocalCheckpointNumber = lastRetrievedCheckpoint?.checkpoint.number ?? await this.store.getSynchedCheckpointNumber();
1246
+ const latestLocalCheckpointNumber = lastRetrievedCheckpoint?.checkpoint.number ?? await this.stores.blocks.getLatestCheckpointNumber();
1114
1247
  if (latestLocalCheckpointNumber < pendingCheckpointNumber) {
1115
1248
  // Here we have consumed all logs until the `currentL1Block` we pinned at the beginning of the archiver loop,
1116
1249
  // but still haven't reached the pending checkpoint according to the call to the rollup contract.
@@ -1123,7 +1256,7 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
1123
1256
  latestLocalCheckpointArchive = lastRetrievedCheckpoint.checkpoint.archive.root.toString();
1124
1257
  targetL1BlockNumber = lastRetrievedCheckpoint.l1.blockNumber;
1125
1258
  } else if (latestLocalCheckpointNumber > 0) {
1126
- const checkpoint = await this.store.getRangeOfCheckpoints(latestLocalCheckpointNumber, 1).then(([c])=>c);
1259
+ const checkpoint = await this.stores.blocks.getRangeOfCheckpoints(latestLocalCheckpointNumber, 1).then(([c])=>c);
1127
1260
  latestLocalCheckpointArchive = checkpoint.archive.root.toString();
1128
1261
  targetL1BlockNumber = checkpoint.l1.blockNumber;
1129
1262
  }
@@ -1134,7 +1267,7 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
1134
1267
  currentL1BlockNumber,
1135
1268
  ...status
1136
1269
  });
1137
- await this.store.setCheckpointSynchedL1BlockNumber(targetL1BlockNumber);
1270
+ await this.stores.blocks.setSynchedL1BlockNumber(targetL1BlockNumber);
1138
1271
  } else {
1139
1272
  this.log.trace(`No new checkpoints behind L1 sync point to retrieve.`, {
1140
1273
  latestLocalCheckpointNumber,
@@ -1143,7 +1276,7 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
1143
1276
  }
1144
1277
  }
1145
1278
  async getCheckpointHeader(number) {
1146
- const checkpoint = await this.store.getCheckpointData(number);
1279
+ const checkpoint = await this.stores.blocks.getCheckpointData(number);
1147
1280
  if (!checkpoint) {
1148
1281
  return undefined;
1149
1282
  }