@aztec/archiver 0.0.1-commit.42ee6df9b → 0.0.1-commit.431c48d

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 (124) hide show
  1. package/README.md +7 -7
  2. package/dest/archiver.d.ts +70 -15
  3. package/dest/archiver.d.ts.map +1 -1
  4. package/dest/archiver.js +273 -71
  5. package/dest/config.d.ts +7 -3
  6. package/dest/config.d.ts.map +1 -1
  7. package/dest/config.js +44 -16
  8. package/dest/errors.d.ts +35 -13
  9. package/dest/errors.d.ts.map +1 -1
  10. package/dest/errors.js +54 -16
  11. package/dest/factory.d.ts +18 -6
  12. package/dest/factory.d.ts.map +1 -1
  13. package/dest/factory.js +66 -21
  14. package/dest/index.d.ts +11 -3
  15. package/dest/index.d.ts.map +1 -1
  16. package/dest/index.js +10 -2
  17. package/dest/l1/calldata_retriever.d.ts +9 -1
  18. package/dest/l1/calldata_retriever.d.ts.map +1 -1
  19. package/dest/l1/calldata_retriever.js +20 -10
  20. package/dest/l1/data_retrieval.d.ts +24 -10
  21. package/dest/l1/data_retrieval.d.ts.map +1 -1
  22. package/dest/l1/data_retrieval.js +13 -19
  23. package/dest/l1/trace_tx.d.ts +12 -66
  24. package/dest/l1/trace_tx.d.ts.map +1 -1
  25. package/dest/l1/validate_historical_logs.d.ts +23 -0
  26. package/dest/l1/validate_historical_logs.d.ts.map +1 -0
  27. package/dest/l1/validate_historical_logs.js +108 -0
  28. package/dest/modules/contract_data_source_adapter.d.ts +25 -0
  29. package/dest/modules/contract_data_source_adapter.d.ts.map +1 -0
  30. package/dest/modules/contract_data_source_adapter.js +32 -0
  31. package/dest/modules/data_source_base.d.ts +71 -50
  32. package/dest/modules/data_source_base.d.ts.map +1 -1
  33. package/dest/modules/data_source_base.js +250 -150
  34. package/dest/modules/data_store_updater.d.ts +28 -9
  35. package/dest/modules/data_store_updater.d.ts.map +1 -1
  36. package/dest/modules/data_store_updater.js +129 -64
  37. package/dest/modules/instrumentation.d.ts +15 -2
  38. package/dest/modules/instrumentation.d.ts.map +1 -1
  39. package/dest/modules/instrumentation.js +48 -9
  40. package/dest/modules/l1_synchronizer.d.ts +11 -7
  41. package/dest/modules/l1_synchronizer.d.ts.map +1 -1
  42. package/dest/modules/l1_synchronizer.js +347 -118
  43. package/dest/modules/outbox_trees_resolver.d.ts +64 -0
  44. package/dest/modules/outbox_trees_resolver.d.ts.map +1 -0
  45. package/dest/modules/outbox_trees_resolver.js +184 -0
  46. package/dest/modules/validation.d.ts +30 -7
  47. package/dest/modules/validation.d.ts.map +1 -1
  48. package/dest/modules/validation.js +33 -15
  49. package/dest/store/block_store.d.ts +169 -94
  50. package/dest/store/block_store.d.ts.map +1 -1
  51. package/dest/store/block_store.js +618 -270
  52. package/dest/store/contract_class_store.d.ts +17 -3
  53. package/dest/store/contract_class_store.d.ts.map +1 -1
  54. package/dest/store/contract_class_store.js +36 -2
  55. package/dest/store/contract_instance_store.d.ts +28 -1
  56. package/dest/store/contract_instance_store.d.ts.map +1 -1
  57. package/dest/store/contract_instance_store.js +53 -5
  58. package/dest/store/data_stores.d.ts +68 -0
  59. package/dest/store/data_stores.d.ts.map +1 -0
  60. package/dest/store/data_stores.js +54 -0
  61. package/dest/store/function_names_cache.d.ts +17 -0
  62. package/dest/store/function_names_cache.d.ts.map +1 -0
  63. package/dest/store/function_names_cache.js +30 -0
  64. package/dest/store/l2_tips_cache.d.ts +13 -8
  65. package/dest/store/l2_tips_cache.d.ts.map +1 -1
  66. package/dest/store/l2_tips_cache.js +13 -96
  67. package/dest/store/log_store.d.ts +42 -40
  68. package/dest/store/log_store.d.ts.map +1 -1
  69. package/dest/store/log_store.js +257 -480
  70. package/dest/store/log_store_codec.d.ts +78 -0
  71. package/dest/store/log_store_codec.d.ts.map +1 -0
  72. package/dest/store/log_store_codec.js +110 -0
  73. package/dest/store/message_store.d.ts +9 -3
  74. package/dest/store/message_store.d.ts.map +1 -1
  75. package/dest/store/message_store.js +31 -1
  76. package/dest/test/fake_l1_state.d.ts +14 -3
  77. package/dest/test/fake_l1_state.d.ts.map +1 -1
  78. package/dest/test/fake_l1_state.js +58 -18
  79. package/dest/test/mock_l1_to_l2_message_source.d.ts +1 -1
  80. package/dest/test/mock_l1_to_l2_message_source.d.ts.map +1 -1
  81. package/dest/test/mock_l1_to_l2_message_source.js +1 -2
  82. package/dest/test/mock_l2_block_source.d.ts +47 -54
  83. package/dest/test/mock_l2_block_source.d.ts.map +1 -1
  84. package/dest/test/mock_l2_block_source.js +229 -205
  85. package/dest/test/mock_structs.d.ts +1 -1
  86. package/dest/test/mock_structs.d.ts.map +1 -1
  87. package/dest/test/mock_structs.js +2 -2
  88. package/dest/test/noop_l1_archiver.d.ts +14 -6
  89. package/dest/test/noop_l1_archiver.d.ts.map +1 -1
  90. package/dest/test/noop_l1_archiver.js +26 -10
  91. package/package.json +15 -14
  92. package/src/archiver.ts +355 -77
  93. package/src/config.ts +51 -20
  94. package/src/errors.ts +80 -23
  95. package/src/factory.ts +80 -19
  96. package/src/index.ts +18 -2
  97. package/src/l1/calldata_retriever.ts +27 -10
  98. package/src/l1/data_retrieval.ts +38 -36
  99. package/src/l1/validate_historical_logs.ts +140 -0
  100. package/src/modules/contract_data_source_adapter.ts +46 -0
  101. package/src/modules/data_source_base.ts +319 -200
  102. package/src/modules/data_store_updater.ts +156 -65
  103. package/src/modules/instrumentation.ts +43 -10
  104. package/src/modules/l1_synchronizer.ts +499 -136
  105. package/src/modules/outbox_trees_resolver.ts +220 -0
  106. package/src/modules/validation.ts +78 -21
  107. package/src/store/block_store.ts +741 -333
  108. package/src/store/contract_class_store.ts +47 -3
  109. package/src/store/contract_instance_store.ts +67 -7
  110. package/src/store/data_stores.ts +104 -0
  111. package/src/store/function_names_cache.ts +37 -0
  112. package/src/store/l2_tips_cache.ts +16 -109
  113. package/src/store/log_store.ts +296 -652
  114. package/src/store/log_store_codec.ts +143 -0
  115. package/src/store/message_store.ts +35 -2
  116. package/src/test/fake_l1_state.ts +65 -27
  117. package/src/test/mock_l1_to_l2_message_source.ts +0 -1
  118. package/src/test/mock_l2_block_source.ts +276 -258
  119. package/src/test/mock_structs.ts +5 -2
  120. package/src/test/noop_l1_archiver.ts +54 -11
  121. package/dest/store/kv_archiver_store.d.ts +0 -377
  122. package/dest/store/kv_archiver_store.d.ts.map +0 -1
  123. package/dest/store/kv_archiver_store.js +0 -494
  124. package/src/store/kv_archiver_store.ts +0 -713
@@ -371,35 +371,39 @@ 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
- import { validateCheckpointAttestations } from './validation.js';
396
+ import { validateCheckpointAttestationsFromCalldata } from './validation.js';
393
397
  _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpochPrune'), _dec2 = trackSpan('Archiver.handleL1ToL2Messages'), _dec3 = trackSpan('Archiver.handleCheckpoints');
394
398
  /**
395
399
  * Handles L1 synchronization for the archiver.
396
- * Responsible for fetching checkpoints, L1L2 messages, and handling L1 reorgs.
400
+ * Responsible for fetching checkpoints, L1 to L2 messages, and handling L1 reorgs.
397
401
  */ export class ArchiverL1Synchronizer {
398
402
  publicClient;
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) {
@@ -480,6 +490,7 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
480
490
  }
481
491
  }
482
492
  async syncFromL1(initialSyncComplete) {
493
+ const blocksAdded = [];
483
494
  // In between the various calls to L1, the block number can move meaning some of the following
484
495
  // calls will return data for blocks that were not present during earlier calls. To combat this
485
496
  // we ensure that all data retrieval methods only retrieve data up to the currentBlockNumber
@@ -496,33 +507,41 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
496
507
  };
497
508
  if (this.l1BlockHash && currentL1BlockHash.equals(this.l1BlockHash)) {
498
509
  this.log.trace(`No new L1 blocks since last sync at L1 block ${this.l1BlockNumber}`);
499
- return;
510
+ return blocksAdded;
500
511
  }
501
- // Warn if the latest L1 block timestamp is too old
512
+ // Log at error if the latest L1 block timestamp is too old
502
513
  const maxAllowedDelay = this.config.maxAllowedEthClientDriftSeconds;
503
514
  const now = this.dateProvider.nowInSeconds();
504
515
  if (maxAllowedDelay > 0 && Number(currentL1Timestamp) <= now - maxAllowedDelay) {
505
- this.log.warn(`Latest L1 block ${currentL1BlockNumber} timestamp ${currentL1Timestamp} is too old. Make sure your Ethereum node is synced.`, {
516
+ this.log.error(`Latest L1 block ${currentL1BlockNumber} timestamp ${currentL1Timestamp} is too old. Make sure your Ethereum node is synced.`, {
506
517
  currentL1BlockNumber,
507
518
  currentL1Timestamp,
508
519
  now,
509
520
  maxAllowedDelay
510
521
  });
511
522
  }
523
+ // Query finalized block on L1
524
+ const rawFinalizedL1Block = await getFinalizedL1Block(this.publicClient);
525
+ const finalizedL1Block = rawFinalizedL1Block && {
526
+ l1BlockNumber: rawFinalizedL1Block.number,
527
+ l1BlockHash: Buffer32.fromString(rawFinalizedL1Block.hash)
528
+ };
512
529
  // Load sync point for blocks defaulting to start block
513
- const { blocksSynchedTo = this.l1Constants.l1StartBlock } = await this.store.getSynchPoint();
530
+ const { blocksSynchedTo = this.l1Constants.l1StartBlock } = await getArchiverSynchPoint(this.stores);
514
531
  this.log.debug(`Starting new archiver sync iteration`, {
515
532
  blocksSynchedTo,
516
- currentL1BlockData
533
+ currentL1BlockData,
534
+ finalizedL1Block
517
535
  });
518
536
  // 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
537
  // 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
538
  // 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);
539
+ await retryTimes(()=>this.handleL1ToL2Messages(currentL1BlockData, finalizedL1Block), 'Handling L1 to L2 messages', 3, 0.1);
522
540
  if (currentL1BlockNumber > blocksSynchedTo) {
523
541
  // First we retrieve new checkpoints and L2 blocks and store them in the DB. This will also update the
524
542
  // pending chain validation status, proven checkpoint number, and synched L1 block number.
525
543
  const rollupStatus = await this.handleCheckpoints(blocksSynchedTo, currentL1BlockNumber, initialSyncComplete);
544
+ blocksAdded.push(...rollupStatus.blocksAdded);
526
545
  // Then we try pruning uncheckpointed blocks if a new slot was mined without checkpoints
527
546
  await this.pruneUncheckpointedBlocks(currentL1Timestamp);
528
547
  // Then we prune the current epoch if it'd reorg on next submission.
@@ -531,23 +550,16 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
531
550
  // the chain locally before we start unwinding stuff. This can be optimized by figuring out
532
551
  // up to which point we're pruning, and then requesting checkpoints up to that point only.
533
552
  const { rollupCanPrune } = await this.handleEpochPrune(rollupStatus.provenCheckpointNumber, currentL1BlockNumber, currentL1Timestamp);
534
- // If the last checkpoint we processed had an invalid attestation, we manually advance the L1 syncpoint
535
- // past it, since otherwise we'll keep downloading it and reprocessing it on every iteration until
536
- // we get a valid checkpoint to advance the syncpoint.
537
- if (!rollupStatus.validationResult?.valid && rollupStatus.lastL1BlockWithCheckpoint !== undefined) {
538
- await this.store.setCheckpointSynchedL1BlockNumber(rollupStatus.lastL1BlockWithCheckpoint);
539
- }
540
553
  // And lastly we check if we are missing any checkpoints behind us due to a possible L1 reorg.
541
554
  // We only do this if rollup cant prune on the next submission. Otherwise we will end up
542
- // re-syncing the checkpoints we have just unwound above. We also dont do this if the last checkpoint is invalid,
543
- // since the archiver will rightfully refuse to sync up to it.
544
- if (!rollupCanPrune && rollupStatus.validationResult?.valid) {
555
+ // re-syncing the checkpoints we have just unwound above.
556
+ if (!rollupCanPrune) {
545
557
  await this.checkForNewCheckpointsBeforeL1SyncPoint(rollupStatus, blocksSynchedTo, currentL1BlockNumber);
546
558
  }
547
559
  this.instrumentation.updateL1BlockHeight(currentL1BlockNumber);
548
560
  }
549
561
  // Update the finalized L2 checkpoint based on L1 finality.
550
- await this.updateFinalizedCheckpoint();
562
+ await this.updateFinalizedCheckpoint(finalizedL1Block);
551
563
  // After syncing has completed, update the current l1 block number and timestamp,
552
564
  // otherwise we risk announcing to the world that we've synced to a given point,
553
565
  // but the corresponding blocks have not been processed (see #12631).
@@ -560,18 +572,19 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
560
572
  l1TimestampAtStart: currentL1Timestamp,
561
573
  l1BlockNumberAtEnd
562
574
  });
575
+ return blocksAdded;
563
576
  }
564
- /** Query L1 for its finalized block and update the finalized checkpoint accordingly. */ async updateFinalizedCheckpoint() {
577
+ /** Updates the finalized checkpoint using the pre-fetched finalized L1 block from the current sync iteration. */ async updateFinalizedCheckpoint(finalizedL1Block) {
565
578
  try {
566
- const finalizedL1Block = await this.publicClient.getBlock({
567
- blockTag: 'finalized',
568
- includeTransactions: false
569
- });
570
- const finalizedL1BlockNumber = finalizedL1Block.number;
579
+ if (!finalizedL1Block) {
580
+ this.log.trace(`Skipping finalized checkpoint update: L1 has no finalized block yet.`);
581
+ return;
582
+ }
583
+ const finalizedL1BlockNumber = finalizedL1Block.l1BlockNumber;
571
584
  const finalizedCheckpointNumber = await this.rollup.getProvenCheckpointNumber({
572
585
  blockNumber: finalizedL1BlockNumber
573
586
  });
574
- const localFinalizedCheckpointNumber = await this.store.getFinalizedCheckpointNumber();
587
+ const localFinalizedCheckpointNumber = await this.stores.blocks.getFinalizedCheckpointNumber();
575
588
  if (localFinalizedCheckpointNumber !== finalizedCheckpointNumber) {
576
589
  await this.updater.setFinalizedCheckpointNumber(finalizedCheckpointNumber);
577
590
  this.log.info(`Updated finalized chain to checkpoint ${finalizedCheckpointNumber}`, {
@@ -588,8 +601,8 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
588
601
  }
589
602
  /** Prune all proposed local blocks that should have been checkpointed by now. */ async pruneUncheckpointedBlocks(currentL1Timestamp) {
590
603
  const [lastCheckpointedBlockNumber, lastProposedBlockNumber] = await Promise.all([
591
- this.store.getCheckpointedL2BlockNumber(),
592
- this.store.getLatestBlockNumber()
604
+ this.stores.blocks.getCheckpointedL2BlockNumber(),
605
+ this.stores.blocks.getLatestL2BlockNumber()
593
606
  ]);
594
607
  // If there are no uncheckpointed blocks, we got nothing to do
595
608
  if (lastProposedBlockNumber === lastCheckpointedBlockNumber) {
@@ -600,19 +613,22 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
600
613
  const slotAtNextL1Block = getSlotAtNextL1Block(currentL1Timestamp, this.l1Constants);
601
614
  const firstUncheckpointedBlockNumber = BlockNumber(lastCheckpointedBlockNumber + 1);
602
615
  // What's the slot of the first uncheckpointed block?
603
- const [firstUncheckpointedBlockHeader] = await this.store.getBlockHeaders(firstUncheckpointedBlockNumber, 1);
604
- const firstUncheckpointedBlockSlot = firstUncheckpointedBlockHeader?.getSlot();
616
+ const firstUncheckpointedBlockData = await this.stores.blocks.getBlockData({
617
+ number: firstUncheckpointedBlockNumber
618
+ });
619
+ const firstUncheckpointedBlockSlot = firstUncheckpointedBlockData?.header.getSlot();
605
620
  if (firstUncheckpointedBlockSlot === undefined || firstUncheckpointedBlockSlot >= slotAtNextL1Block) {
606
621
  return;
607
622
  }
608
623
  // Prune provisional blocks from slots that have ended without being checkpointed.
609
624
  // This also clears any proposed checkpoint whose blocks are being pruned.
610
625
  this.log.warn(`Pruning blocks after block ${lastCheckpointedBlockNumber} due to slot ${firstUncheckpointedBlockSlot} not being checkpointed`, {
611
- firstUncheckpointedBlockHeader: firstUncheckpointedBlockHeader.toInspect(),
626
+ firstUncheckpointedBlockHeader: firstUncheckpointedBlockData?.header.toInspect(),
612
627
  slotAtNextL1Block
613
628
  });
614
629
  const prunedBlocks = await this.updater.removeUncheckpointedBlocksAfter(lastCheckpointedBlockNumber);
615
630
  if (prunedBlocks.length > 0) {
631
+ this.instrumentation.recordPrune('uncheckpointed');
616
632
  this.events.emit(L2BlockSourceEvents.L2PruneUncheckpointed, {
617
633
  type: L2BlockSourceEvents.L2PruneUncheckpointed,
618
634
  slotNumber: firstUncheckpointedBlockSlot,
@@ -636,7 +652,7 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
636
652
  }
637
653
  /** Checks if there'd be a reorg for the next checkpoint submission and start pruning now. */ async handleEpochPrune(provenCheckpointNumber, currentL1BlockNumber, currentL1Timestamp) {
638
654
  const rollupCanPrune = await this.canPrune(currentL1BlockNumber, currentL1Timestamp);
639
- const localPendingCheckpointNumber = await this.store.getSynchedCheckpointNumber();
655
+ const localPendingCheckpointNumber = await this.stores.blocks.getLatestCheckpointNumber();
640
656
  const canPrune = localPendingCheckpointNumber > provenCheckpointNumber && rollupCanPrune;
641
657
  if (canPrune) {
642
658
  const timer = new Timer();
@@ -654,8 +670,8 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
654
670
  const indices = Array.from({
655
671
  length: checkpointsToUnwind
656
672
  }, (_, 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();
673
+ const checkpoints = (await asyncPool(BATCH_SIZE, indices, (idx)=>this.stores.blocks.getCheckpointData(idx))).filter(isDefined);
674
+ const newBlocks = (await asyncPool(BATCH_SIZE, checkpoints, (cp)=>this.stores.blocks.getBlocksForCheckpoint(CheckpointNumber(cp.checkpointNumber)))).filter(isDefined).flat();
659
675
  // Emit an event for listening services to react to the chain prune
660
676
  this.events.emit(L2BlockSourceEvents.L2PruneUnproven, {
661
677
  type: L2BlockSourceEvents.L2PruneUnproven,
@@ -664,11 +680,11 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
664
680
  });
665
681
  this.log.debug(`L2 prune from ${provenCheckpointNumber + 1} to ${localPendingCheckpointNumber} will occur on next checkpoint submission.`);
666
682
  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()}.`);
683
+ 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
684
  this.instrumentation.processPrune(timer.ms());
669
685
  // TODO(palla/reorg): Do we need to set the block synched L1 block number here?
670
686
  // Seems like the next iteration should handle this.
671
- // await this.store.setCheckpointSynchedL1BlockNumber(currentL1BlockNumber);
687
+ // await this.stores.blocks.setSynchedL1BlockNumber(currentL1BlockNumber);
672
688
  }
673
689
  return {
674
690
  rollupCanPrune
@@ -689,12 +705,12 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
689
705
  nextEnd
690
706
  ];
691
707
  }
692
- async handleL1ToL2Messages(currentL1Block) {
708
+ async handleL1ToL2Messages(currentL1Block, finalizedL1Block) {
693
709
  // Load the syncpoint, which may have been updated in a previous iteration
694
710
  const { messagesSynchedTo = {
695
711
  l1BlockNumber: this.l1Constants.l1StartBlock,
696
712
  l1BlockHash: this.l1Constants.l1StartBlockHash
697
- } } = await this.store.getSynchPoint();
713
+ } } = await getArchiverSynchPoint(this.stores);
698
714
  // Nothing to do if L1 block number has not moved forward
699
715
  const currentL1BlockNumber = currentL1Block.l1BlockNumber;
700
716
  if (currentL1BlockNumber <= messagesSynchedTo.l1BlockNumber) {
@@ -704,10 +720,10 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
704
720
  const remoteMessagesState = await this.inbox.getState({
705
721
  blockNumber: currentL1BlockNumber
706
722
  });
707
- const localLastMessage = await this.store.getLastL1ToL2Message();
723
+ const localLastMessage = await this.stores.messages.getLastMessage();
708
724
  if (await this.localStateMatches(localLastMessage, remoteMessagesState)) {
709
725
  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);
726
+ await this.stores.messages.setMessageSyncState(currentL1Block, remoteMessagesState.treeInProgress, finalizedL1Block);
711
727
  return true;
712
728
  }
713
729
  // If not, then we are out of sync. Most likely there are new messages on the inbox, so we try retrieving them.
@@ -721,7 +737,7 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
721
737
  this.log.warn(`Failed to store L1 to L2 messages retrieved from L1: ${error.message}. Rolling back syncpoint to retry.`, {
722
738
  inboxMessage: error.inboxMessage
723
739
  });
724
- await this.rollbackL1ToL2Messages(remoteMessagesState.treeInProgress);
740
+ await this.rollbackL1ToL2Messages(remoteMessagesState);
725
741
  return false;
726
742
  }
727
743
  throw error;
@@ -729,21 +745,21 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
729
745
  // Note that, if there are no new messages to insert, but there was an L1 reorg that pruned out last messages,
730
746
  // we'd notice by comparing our local state with the remote one again, and seeing they don't match even after
731
747
  // our sync attempt. In this case, we also rollback our syncpoint, and trigger a retry.
732
- const localLastMessageAfterSync = await this.store.getLastL1ToL2Message();
748
+ const localLastMessageAfterSync = await this.stores.messages.getLastMessage();
733
749
  if (!await this.localStateMatches(localLastMessageAfterSync, remoteMessagesState)) {
734
750
  this.log.warn(`Local L1 to L2 messages state does not match remote after sync attempt. Rolling back syncpoint to retry.`, {
735
751
  localLastMessageAfterSync,
736
752
  remoteMessagesState
737
753
  });
738
- await this.rollbackL1ToL2Messages(remoteMessagesState.treeInProgress);
754
+ await this.rollbackL1ToL2Messages(remoteMessagesState);
739
755
  return false;
740
756
  }
741
757
  // Advance the syncpoint after a successful sync
742
- await this.store.setMessageSyncState(currentL1Block, remoteMessagesState.treeInProgress);
758
+ await this.stores.messages.setMessageSyncState(currentL1Block, remoteMessagesState.treeInProgress, finalizedL1Block);
743
759
  return true;
744
760
  }
745
761
  /** Checks if the local rolling hash and message count matches the remote state */ async localStateMatches(localLastMessage, remoteState) {
746
- const localMessageCount = await this.store.getTotalL1ToL2MessageCount();
762
+ const localMessageCount = await this.stores.messages.getTotalL1ToL2MessageCount();
747
763
  this.log.trace(`Comparing local and remote inbox state`, {
748
764
  localMessageCount,
749
765
  localLastMessage,
@@ -761,7 +777,7 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
761
777
  this.log.trace(`Retrieving L1 to L2 messages in L1 blocks ${searchStartBlock}-${searchEndBlock}`);
762
778
  const messages = await retrieveL1ToL2Messages(this.inbox, searchStartBlock, searchEndBlock);
763
779
  const timer = new Timer();
764
- await this.store.addL1ToL2Messages(messages);
780
+ await this.stores.messages.addL1ToL2Messages(messages);
765
781
  const perMsg = timer.ms() / messages.length;
766
782
  this.instrumentation.processNewMessages(messages.length, perMsg);
767
783
  for (const msg of messages){
@@ -783,23 +799,47 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
783
799
  /**
784
800
  * 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
801
  * 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.
802
+ */ async rollbackL1ToL2Messages(remoteMessagesState) {
803
+ const { treeInProgress: remoteTreeInProgress, messagesRollingHash: remoteRollingHash } = remoteMessagesState;
804
+ const messagesFinalizedL1Block = await this.stores.messages.getMessagesFinalizedL1Block();
805
+ const finalizedL1BlockNumber = messagesFinalizedL1Block?.l1BlockNumber;
806
+ // Slowly go back through our messages until we find the last common message. We could query the logs in
807
+ // batch as an optimization, but the depth of the reorg should not be deep, and this is a very rare case,
808
+ // so it's fine to query one log at a time.
790
809
  let commonMsg;
791
810
  let messagesToDelete = 0;
792
811
  this.log.verbose(`Searching most recent common L1 to L2 message`);
793
- for await (const localMsg of this.store.iterateL1ToL2Messages({
812
+ for await (const localMsg of this.stores.messages.iterateL1ToL2Messages({
794
813
  reverse: true
795
814
  })){
796
- const remoteMsg = await retrieveL1ToL2Message(this.inbox, localMsg);
797
815
  const logCtx = {
798
- remoteMsg,
799
- localMsg: localMsg
816
+ remoteMsg: undefined,
817
+ localMsg,
818
+ remoteMessagesState
800
819
  };
820
+ // First check if the local message rolling hash matches the current rolling hash of the inbox contract,
821
+ // which means we just need to rollback some local messages and we should be back in sync. This means there
822
+ // was an L1 reorg that removed some of the messages we had, but no new messages were added compared.
823
+ if (localMsg.rollingHash.equals(remoteRollingHash)) {
824
+ this.log.info(`Found common L1 to L2 message at index ${localMsg.index} on L1 block ${localMsg.l1BlockNumber} matching current remote state`, logCtx);
825
+ commonMsg = localMsg;
826
+ break;
827
+ }
828
+ // Messages at or below the finalized L1 block cannot have been reorged — accept as common without querying L1.
829
+ if (finalizedL1BlockNumber !== undefined && localMsg.l1BlockNumber <= finalizedL1BlockNumber) {
830
+ this.log.info(`Found common L1 to L2 message at finalized L1 block ${localMsg.l1BlockNumber}`, logCtx);
831
+ commonMsg = localMsg;
832
+ break;
833
+ }
834
+ // If there's no match with the current remote state, check if the message exists on the inbox contract at all
835
+ // by looking at the inbox events. If the L1 reorg *added* new messages in addition to deleting existing ones,
836
+ // then the current remote state's rolling hash will not match anything we have locally, so we need to check existence
837
+ // of individual messages via logs. Note we use logs and not historical queries so we don't have to depend on
838
+ // an archival rpc node, since the message could be from a long time ago if we're catching up with syncing.
839
+ const remoteMsg = await retrieveL1ToL2Message(this.inbox, localMsg);
840
+ logCtx.remoteMsg = remoteMsg;
801
841
  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);
842
+ this.log.info(`Found most recent common L1 to L2 message at index ${localMsg.index} on L1 block ${localMsg.l1BlockNumber}`, logCtx);
803
843
  commonMsg = remoteMsg;
804
844
  break;
805
845
  } else if (remoteMsg) {
@@ -815,19 +855,24 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
815
855
  if (messagesToDelete > 0) {
816
856
  const lastGoodIndex = commonMsg?.index;
817
857
  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);
858
+ await this.stores.messages.removeL1ToL2Messages(lastGoodIndex !== undefined ? lastGoodIndex + 1n : 0n);
819
859
  }
820
860
  // Update the syncpoint so the loop below reprocesses the changed messages. We go to the block before
821
861
  // 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);
862
+ // after the last common message. Cap at the finalized L1 block: messages at or below finalized cannot
863
+ // have been reorged, so there is no need to walk back any further than that.
864
+ const syncPointL1BlockNumber = maxBigint(...compactArray([
865
+ commonMsg ? commonMsg.l1BlockNumber - 1n : undefined,
866
+ finalizedL1BlockNumber,
867
+ this.l1Constants.l1StartBlock
868
+ ]));
869
+ const syncPointL1BlockHash = syncPointL1BlockNumber === finalizedL1BlockNumber ? messagesFinalizedL1Block.l1BlockHash : await this.getL1BlockHash(syncPointL1BlockNumber);
825
870
  const messagesSyncPoint = {
826
871
  l1BlockNumber: syncPointL1BlockNumber,
827
872
  l1BlockHash: syncPointL1BlockHash
828
873
  };
829
- await this.store.setMessageSyncState(messagesSyncPoint, remoteTreeInProgress);
830
- this.log.verbose(`Updated messages syncpoint to L1 block ${syncPointL1BlockNumber}`, {
874
+ await this.stores.messages.setMessageSyncState(messagesSyncPoint, remoteTreeInProgress);
875
+ this.log.verbose(`Updated messages syncpoint to L1 block ${messagesSyncPoint.l1BlockNumber}`, {
831
876
  ...messagesSyncPoint,
832
877
  remoteTreeInProgress
833
878
  });
@@ -844,8 +889,9 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
844
889
  return Buffer32.fromString(block.hash);
845
890
  }
846
891
  async handleCheckpoints(blocksSynchedTo, currentL1BlockNumber, initialSyncComplete) {
847
- const localPendingCheckpointNumber = await this.store.getSynchedCheckpointNumber();
848
- const initialValidationResult = await this.store.getPendingChainValidationStatus();
892
+ const blocksAdded = [];
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
  }));
@@ -854,7 +900,8 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
854
900
  provenArchive: provenArchive.toString(),
855
901
  pendingCheckpointNumber,
856
902
  pendingArchive: pendingArchive.toString(),
857
- validationResult: initialValidationResult
903
+ validationResult: initialValidationResult,
904
+ blocksAdded
858
905
  };
859
906
  this.log.trace(`Retrieved rollup status at current L1 block ${currentL1BlockNumber}.`, {
860
907
  localPendingCheckpointNumber,
@@ -868,7 +915,7 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
868
915
  // we need to set it to zero. This is an edge case because we dont have a checkpoint zero (initial checkpoint is one),
869
916
  // so localCheckpointForDestinationProvenCheckpointNumber would not be found below.
870
917
  if (provenCheckpointNumber === 0) {
871
- const localProvenCheckpointNumber = await this.store.getProvenCheckpointNumber();
918
+ const localProvenCheckpointNumber = await this.stores.blocks.getProvenCheckpointNumber();
872
919
  if (localProvenCheckpointNumber !== provenCheckpointNumber) {
873
920
  await this.updater.setProvenCheckpointNumber(provenCheckpointNumber);
874
921
  this.log.info(`Rolled back proven chain to checkpoint ${provenCheckpointNumber}`, {
@@ -876,16 +923,16 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
876
923
  });
877
924
  }
878
925
  }
879
- const localCheckpointForDestinationProvenCheckpointNumber = await this.store.getCheckpointData(provenCheckpointNumber);
926
+ const localCheckpointForDestinationProvenCheckpointNumber = await this.stores.blocks.getCheckpointData(provenCheckpointNumber);
880
927
  // 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
928
  // 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();
929
+ const synched = await this.stores.blocks.getLatestCheckpointNumber();
883
930
  if (localCheckpointForDestinationProvenCheckpointNumber && synched < localCheckpointForDestinationProvenCheckpointNumber.checkpointNumber) {
884
931
  this.log.error(`Hit local checkpoint greater than last synched checkpoint: ${localCheckpointForDestinationProvenCheckpointNumber.checkpointNumber} > ${synched}`);
885
932
  }
886
933
  this.log.trace(`Local checkpoint for remote proven checkpoint ${provenCheckpointNumber} is ${localCheckpointForDestinationProvenCheckpointNumber?.archive.root.toString() ?? 'undefined'}`);
887
934
  if (localCheckpointForDestinationProvenCheckpointNumber && provenArchive.equals(localCheckpointForDestinationProvenCheckpointNumber.archive.root)) {
888
- const localProvenCheckpointNumber = await this.store.getProvenCheckpointNumber();
935
+ const localProvenCheckpointNumber = await this.stores.blocks.getProvenCheckpointNumber();
889
936
  if (localProvenCheckpointNumber !== provenCheckpointNumber) {
890
937
  await this.updater.setProvenCheckpointNumber(provenCheckpointNumber);
891
938
  this.log.info(`Updated proven chain to checkpoint ${provenCheckpointNumber}`, {
@@ -910,7 +957,7 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
910
957
  // If we have 0 checkpoints locally and there are no checkpoints onchain there is nothing to do.
911
958
  const noCheckpoints = localPendingCheckpointNumber === 0 && pendingCheckpointNumber === 0;
912
959
  if (noCheckpoints) {
913
- await this.store.setCheckpointSynchedL1BlockNumber(currentL1BlockNumber);
960
+ await this.stores.blocks.setSynchedL1BlockNumber(currentL1BlockNumber);
914
961
  this.log.debug(`No checkpoints to retrieve from ${blocksSynchedTo + 1n} to ${currentL1BlockNumber}, no checkpoints on chain`);
915
962
  return rollupStatus;
916
963
  }
@@ -918,7 +965,7 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
918
965
  // Related to the L2 reorgs of the pending chain. We are only interested in actually addressing a reorg if there
919
966
  // are any state that could be impacted by it. If we have no checkpoints, there is no impact.
920
967
  if (localPendingCheckpointNumber > 0) {
921
- const localPendingCheckpoint = await this.store.getCheckpointData(localPendingCheckpointNumber);
968
+ const localPendingCheckpoint = await this.stores.blocks.getCheckpointData(localPendingCheckpointNumber);
922
969
  if (localPendingCheckpoint === undefined) {
923
970
  throw new Error(`Missing checkpoint ${localPendingCheckpointNumber}`);
924
971
  }
@@ -932,7 +979,7 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
932
979
  // However, in the re-org scenario, our L1 node is temporarily lying to us and we end up potentially missing checkpoints.
933
980
  // We must only set this block number based on actually retrieved logs.
934
981
  // TODO(#8621): Tackle this properly when we handle L1 Re-orgs.
935
- // await this.store.setCheckpointSynchedL1BlockNumber(currentL1BlockNumber);
982
+ // await this.stores.blocks.setSynchedL1BlockNumber(currentL1BlockNumber);
936
983
  this.log.debug(`No checkpoints to retrieve from ${blocksSynchedTo + 1n} to ${currentL1BlockNumber}`);
937
984
  return rollupStatus;
938
985
  }
@@ -949,7 +996,7 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
949
996
  });
950
997
  let tipAfterUnwind = localPendingCheckpointNumber;
951
998
  while(true){
952
- const candidateCheckpoint = await this.store.getCheckpointData(tipAfterUnwind);
999
+ const candidateCheckpoint = await this.stores.blocks.getCheckpointData(tipAfterUnwind);
953
1000
  if (candidateCheckpoint === undefined) {
954
1001
  break;
955
1002
  }
@@ -965,7 +1012,10 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
965
1012
  }
966
1013
  const checkpointsToRemove = localPendingCheckpointNumber - tipAfterUnwind;
967
1014
  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()}.`);
1015
+ if (checkpointsToRemove > 0) {
1016
+ this.instrumentation.recordPrune('l1_mismatch');
1017
+ }
1018
+ 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
1019
  }
970
1020
  }
971
1021
  // Retrieve checkpoints in batches. Each batch is estimated to accommodate up to 'blockBatchSize' L1 blocks,
@@ -973,41 +1023,64 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
973
1023
  let searchStartBlock = blocksSynchedTo;
974
1024
  let searchEndBlock = blocksSynchedTo;
975
1025
  let lastRetrievedCheckpoint;
976
- let lastL1BlockWithCheckpoint = undefined;
1026
+ let lastSeenCheckpoint;
977
1027
  do {
978
1028
  [searchStartBlock, searchEndBlock] = this.nextRange(searchEndBlock, currentL1BlockNumber);
979
1029
  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) {
1030
+ // First fetch calldata only, no blobs yet, since we may be able to just get that data out of the proposed chain
1031
+ const calldataCheckpoints = await execInSpan(this.tracer, 'Archiver.retrieveCheckpointCalldataFromRollup', ()=>retrieveCheckpointCalldataFromRollup(this.rollup, this.publicClient, this.debugClient, searchStartBlock, searchEndBlock, this.instrumentation, this.log));
1032
+ if (calldataCheckpoints.length === 0) {
983
1033
  // We are not calling `setBlockSynchedL1BlockNumber` because it may cause sync issues if based off infura.
984
1034
  // See further details in earlier comments.
985
1035
  this.log.trace(`Retrieved no new checkpoints from L1 block ${searchStartBlock} to ${searchEndBlock}`);
986
1036
  continue;
987
1037
  }
988
- this.log.debug(`Retrieved ${retrievedCheckpoints.length} new checkpoints between L1 blocks ${searchStartBlock} and ${searchEndBlock}`, {
989
- lastProcessedCheckpoint: retrievedCheckpoints[retrievedCheckpoints.length - 1].l1,
1038
+ this.log.debug(`Retrieved ${calldataCheckpoints.length} new checkpoint calldata between L1 blocks ${searchStartBlock} and ${searchEndBlock}`, {
1039
+ lastProcessedCheckpoint: calldataCheckpoints[calldataCheckpoints.length - 1].l1,
990
1040
  searchStartBlock,
991
1041
  searchEndBlock
992
1042
  });
993
- const publishedCheckpoints = await Promise.all(retrievedCheckpoints.map((b)=>retrievedToPublishedCheckpoint(b)));
994
- const validCheckpoints = [];
995
- for (const published of publishedCheckpoints){
1043
+ // Check if the last checkpoint matches a local pending entry (so we can skip blob fetch).
1044
+ // We only check the last one; if it matches, the blob fetch is skipped for that entry.
1045
+ // TODO(palla/pipelining): We may have more than a single checkpoint to promote
1046
+ const lastCalldataCheckpoint = calldataCheckpoints[calldataCheckpoints.length - 1];
1047
+ const promoteResult = await this.tryBuildPublishedCheckpointFromProposed(lastCalldataCheckpoint);
1048
+ const checkpointToPromote = promoteResult && !('diverged' in promoteResult) ? promoteResult : undefined;
1049
+ const evictProposedFrom = promoteResult && 'diverged' in promoteResult ? promoteResult.fromCheckpointNumber : undefined;
1050
+ // Validate attestations from CALLDATA before fetching any blobs. A checkpoint with invalid
1051
+ // attestations (or one descending from a rejected ancestor) is rejected here without fetching its
1052
+ // blobs, so a malformed blob does not throw during decode before the rejection path runs and
1053
+ // stall sync. The signed consensus payload (header, archive root, fee asset price
1054
+ // modifier) is fully available from calldata.
1055
+ const checkpointsToIngest = [];
1056
+ for (const calldataCheckpoint of calldataCheckpoints){
1057
+ // Check the attestations uploaded by the publisher to L1 are correct.
1058
+ // Rollup contract does not validate attestations to save on gas, so this
1059
+ // falls on the nodes to verify offchain and skip those checkpoints.
996
1060
  const validationResult = this.config.skipValidateCheckpointAttestations ? {
997
1061
  valid: true
998
- } : await validateCheckpointAttestations(published, this.epochCache, this.l1Constants, this.log);
999
- // Only update the validation result if it has changed, so we can keep track of the first invalid checkpoint
1062
+ } : await validateCheckpointAttestationsFromCalldata(calldataCheckpoint, this.epochCache, this.l1Constants, this.getSignatureContext(), this.log);
1063
+ // Also skip the checkpoint if it builds on a previously-rejected ancestor. Without
1064
+ // this, addCheckpoints would throw InitialCheckpointNumberNotSequentialError when the
1065
+ // ancestor was skipped earlier (e.g. due to invalid attestations), the catch handler
1066
+ // would roll back the L1 sync point, and the next iteration would re-fetch and re-throw.
1067
+ const rejectedAncestor = await this.stores.blocks.getRejectedCheckpointByArchiveRoot(calldataCheckpoint.header.lastArchiveRoot);
1068
+ // Update the validation result if it has changed, so we can keep track of the first invalid checkpoint
1000
1069
  // in case there is a sequence of more than one invalid checkpoint, as we need to invalidate the first one.
1001
1070
  // There is an exception though: if a checkpoint is invalidated and replaced with another invalid checkpoint,
1002
1071
  // we need to update the validation result, since we need to be able to invalidate the new one.
1003
1072
  // See test 'chain progresses if an invalid checkpoint is invalidated with an invalid one' for more info.
1004
- if (rollupStatus.validationResult?.valid !== validationResult.valid || !rollupStatus.validationResult.valid && !validationResult.valid && rollupStatus.validationResult.checkpoint.checkpointNumber === validationResult.checkpoint.checkpointNumber) {
1073
+ // Do not update the validation result if there is a rejected ancestor, since in that case we want to keep the
1074
+ // original invalidation, as the new checkpoint is extending from a previous invalid one.
1075
+ const validStatusChanged = rollupStatus.validationResult?.valid !== validationResult.valid;
1076
+ const invalidStatusWithSameCheckpointNumber = !validationResult.valid && rollupStatus.validationResult && !rollupStatus.validationResult.valid && rollupStatus.validationResult.checkpoint.checkpointNumber === validationResult.checkpoint.checkpointNumber;
1077
+ if (!rejectedAncestor && (validStatusChanged || invalidStatusWithSameCheckpointNumber)) {
1005
1078
  rollupStatus.validationResult = validationResult;
1006
1079
  }
1007
1080
  if (!validationResult.valid) {
1008
- this.log.warn(`Skipping checkpoint ${published.checkpoint.number} due to invalid attestations`, {
1009
- checkpointHash: published.checkpoint.hash(),
1010
- l1BlockNumber: published.l1.blockNumber,
1081
+ this.log.warn(`Skipping checkpoint ${calldataCheckpoint.checkpointNumber} due to invalid attestations`, {
1082
+ checkpointNumber: calldataCheckpoint.checkpointNumber,
1083
+ l1BlockNumber: calldataCheckpoint.l1.blockNumber,
1011
1084
  ...pick(validationResult, 'reason')
1012
1085
  });
1013
1086
  // Emit event for invalid checkpoint detection
@@ -1015,12 +1088,80 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
1015
1088
  type: L2BlockSourceEvents.InvalidAttestationsCheckpointDetected,
1016
1089
  validationResult
1017
1090
  });
1091
+ // Persist a rejected-ancestor entry so any later checkpoint that builds on this one
1092
+ // is detected and skipped (rather than tripping the addCheckpoints consecutive-number
1093
+ // check and causing the sync point to roll back in a loop).
1094
+ await this.stores.blocks.addRejectedCheckpoint({
1095
+ checkpointNumber: calldataCheckpoint.checkpointNumber,
1096
+ archiveRoot: calldataCheckpoint.archiveRoot,
1097
+ parentArchiveRoot: calldataCheckpoint.header.lastArchiveRoot,
1098
+ slotNumber: calldataCheckpoint.header.slotNumber,
1099
+ l1: calldataCheckpoint.l1,
1100
+ reason: 'invalid-attestations'
1101
+ });
1102
+ continue;
1103
+ }
1104
+ if (rejectedAncestor) {
1105
+ const descendantInfo = {
1106
+ archive: calldataCheckpoint.archiveRoot,
1107
+ lastArchive: calldataCheckpoint.header.lastArchiveRoot,
1108
+ slotNumber: calldataCheckpoint.header.slotNumber,
1109
+ checkpointNumber: calldataCheckpoint.checkpointNumber,
1110
+ timestamp: calldataCheckpoint.header.timestamp
1111
+ };
1112
+ this.log.warn(`Skipping checkpoint ${calldataCheckpoint.checkpointNumber} as it is a descendant of ` + `rejected checkpoint ${rejectedAncestor.checkpointNumber} (${rejectedAncestor.reason})`, {
1113
+ checkpointNumber: calldataCheckpoint.checkpointNumber,
1114
+ l1BlockNumber: calldataCheckpoint.l1.blockNumber,
1115
+ l1BlockHash: calldataCheckpoint.l1.blockHash,
1116
+ ancestorCheckpointNumber: rejectedAncestor.checkpointNumber,
1117
+ ancestorArchiveRoot: rejectedAncestor.archiveRoot.toString(),
1118
+ ancestorReason: rejectedAncestor.reason
1119
+ });
1120
+ this.events.emit(L2BlockSourceEvents.DescendentOfInvalidAttestationsCheckpointDetected, {
1121
+ type: L2BlockSourceEvents.DescendentOfInvalidAttestationsCheckpointDetected,
1122
+ checkpoint: descendantInfo,
1123
+ ancestorArchiveRoot: rejectedAncestor.archiveRoot,
1124
+ ancestorCheckpointNumber: rejectedAncestor.checkpointNumber
1125
+ });
1126
+ // Persist this chainpoint as rejected as well, so we can construct a chain of
1127
+ // skipped checkpoints starting from the first one with invalid attestations.
1128
+ await this.stores.blocks.addRejectedCheckpoint({
1129
+ checkpointNumber: calldataCheckpoint.checkpointNumber,
1130
+ archiveRoot: calldataCheckpoint.archiveRoot,
1131
+ parentArchiveRoot: calldataCheckpoint.header.lastArchiveRoot,
1132
+ slotNumber: calldataCheckpoint.header.slotNumber,
1133
+ l1: calldataCheckpoint.l1,
1134
+ reason: 'descends-from-invalid-attestations'
1135
+ });
1018
1136
  continue;
1019
1137
  }
1138
+ checkpointsToIngest.push(calldataCheckpoint);
1139
+ }
1140
+ // Fetch blobs in parallel only for the surviving (attestation-valid, non-descendant) checkpoints,
1141
+ // then build the full published checkpoints. The last calldata checkpoint may be promotable from a
1142
+ // local proposed block (checkpointToPromote), in which case it carries no blob to fetch. A missing or
1143
+ // undecodable blob throws and propagates, rolling back the L1 sync point so the fetch is retried.
1144
+ const toFetchBlobs = checkpointToPromote ? checkpointsToIngest.filter((c)=>c.checkpointNumber !== checkpointToPromote.checkpoint.number) : checkpointsToIngest;
1145
+ const blobFetched = await asyncPool(10, toFetchBlobs, async (checkpoint)=>retrievedToPublishedCheckpoint({
1146
+ ...checkpoint,
1147
+ checkpointBlobData: await getCheckpointBlobDataFromBlobs(this.blobClient, checkpoint.l1.blockHash, checkpoint.blobHashes, checkpoint.checkpointNumber, this.log, !initialSyncComplete, checkpoint.parentBeaconBlockRoot, checkpoint.l1.timestamp)
1148
+ }));
1149
+ // Index the built checkpoints by number so we can ingest them in calldata order, slotting in the
1150
+ // promoted checkpoint (built from a local proposed block rather than blobs).
1151
+ const publishedByNumber = new Map(blobFetched.map((published)=>[
1152
+ published.checkpoint.number,
1153
+ published
1154
+ ]));
1155
+ if (checkpointToPromote) {
1156
+ publishedByNumber.set(checkpointToPromote.checkpoint.number, checkpointToPromote);
1157
+ }
1158
+ const validCheckpoints = [];
1159
+ for (const calldataCheckpoint of checkpointsToIngest){
1160
+ const published = publishedByNumber.get(calldataCheckpoint.checkpointNumber);
1020
1161
  // Check the inHash of the checkpoint against the l1->l2 messages.
1021
1162
  // The messages should've been synced up to the currentL1BlockNumber and must be available for the published
1022
1163
  // checkpoints we just retrieved.
1023
- const l1ToL2Messages = await this.store.getL1ToL2Messages(published.checkpoint.number);
1164
+ const l1ToL2Messages = await this.stores.messages.getL1ToL2Messages(published.checkpoint.number);
1024
1165
  const computedInHash = computeInHashFromL1ToL2Messages(l1ToL2Messages);
1025
1166
  const publishedInHash = published.checkpoint.header.inHash;
1026
1167
  if (!computedInHash.equals(publishedInHash)) {
@@ -1050,8 +1191,21 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
1050
1191
  }
1051
1192
  try {
1052
1193
  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));
1194
+ // Split valid checkpoints: the promoted one (if any) is persisted via the proposed-promotion path,
1195
+ // the rest via addCheckpoints. Both paths run within the same store transaction for atomicity.
1196
+ const [[maybeValidCheckpointToPromote], checkpointsToAdd] = partition(validCheckpoints, (c)=>c.checkpoint.number === checkpointToPromote?.checkpoint.number);
1197
+ const [processDuration, result] = await elapsed(()=>execInSpan(this.tracer, 'Archiver.addCheckpoints', ()=>this.updater.addCheckpoints(checkpointsToAdd, updatedValidationResult, maybeValidCheckpointToPromote && {
1198
+ l1: lastCalldataCheckpoint.l1,
1199
+ attestations: lastCalldataCheckpoint.attestations,
1200
+ checkpoint: maybeValidCheckpointToPromote
1201
+ }, evictProposedFrom)));
1202
+ if (validCheckpoints.length > 0) {
1203
+ this.instrumentation.processNewCheckpointedBlocks(processDuration / validCheckpoints.length, validCheckpoints.flatMap((c)=>c.checkpoint.blocks));
1204
+ }
1205
+ // Record blocks newly fetched from L1 checkpoint payloads as added. The promoted checkpoint (if any) is
1206
+ // excluded: its blocks were already in local archiver storage (added via the proposed-block path) so the
1207
+ // block stream does not need them re-downloaded.
1208
+ blocksAdded.push(...checkpointsToAdd.flatMap((c)=>c.checkpoint.blocks));
1055
1209
  // If blocks were pruned due to conflict with L1 checkpoints, emit event
1056
1210
  if (result.prunedBlocks && result.prunedBlocks.length > 0) {
1057
1211
  const prunedCheckpointNumber = result.prunedBlocks[0].checkpointNumber;
@@ -1061,6 +1215,7 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
1061
1215
  prunedSlotNumber,
1062
1216
  prunedCheckpointNumber
1063
1217
  });
1218
+ this.instrumentation.recordPrune('l1_conflict');
1064
1219
  // Emit event for listening services to react to the prune.
1065
1220
  // Note: slotNumber comes from the first pruned block. If pruned blocks theoretically spanned multiple slots,
1066
1221
  // only one slot number would be reported (though in practice all blocks in a checkpoint span a single slot).
@@ -1073,11 +1228,15 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
1073
1228
  } catch (err) {
1074
1229
  if (err instanceof InitialCheckpointNumberNotSequentialError) {
1075
1230
  const { previousCheckpointNumber, newCheckpointNumber } = err;
1076
- const previousCheckpoint = previousCheckpointNumber ? await this.store.getCheckpointData(CheckpointNumber(previousCheckpointNumber)) : undefined;
1077
- const updatedL1SyncPoint = previousCheckpoint?.l1.blockNumber ?? this.l1Constants.l1StartBlock;
1078
- await this.store.setCheckpointSynchedL1BlockNumber(updatedL1SyncPoint);
1231
+ const previousCheckpoint = previousCheckpointNumber ? await this.stores.blocks.getCheckpointData(CheckpointNumber(previousCheckpointNumber)) : undefined;
1232
+ const lastFinalizedCheckpoint = await this.stores.blocks.getCheckpointData(await this.stores.blocks.getFinalizedCheckpointNumber());
1233
+ const updatedL1SyncPoint = previousCheckpoint?.l1.blockNumber ?? lastFinalizedCheckpoint?.l1.blockNumber ?? this.l1Constants.l1StartBlock;
1234
+ await this.stores.blocks.setSynchedL1BlockNumber(updatedL1SyncPoint);
1079
1235
  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
1236
  previousCheckpointNumber,
1237
+ previousCheckpoint: previousCheckpoint?.header.toInspect(),
1238
+ lastFinalizedCheckpoint: lastFinalizedCheckpoint?.header.toInspect(),
1239
+ l1StartBlock: this.l1Constants.l1StartBlock,
1081
1240
  newCheckpointNumber,
1082
1241
  updatedL1SyncPoint
1083
1242
  });
@@ -1096,45 +1255,115 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
1096
1255
  });
1097
1256
  }
1098
1257
  lastRetrievedCheckpoint = validCheckpoints.at(-1) ?? lastRetrievedCheckpoint;
1099
- lastL1BlockWithCheckpoint = retrievedCheckpoints.at(-1)?.l1.blockNumber ?? lastL1BlockWithCheckpoint;
1258
+ // The last checkpoint seen on L1 this batch (valid or rejected), tracked from calldata since
1259
+ // rejected checkpoints are no longer built into PublishedCheckpoints.
1260
+ lastSeenCheckpoint = lastCalldataCheckpoint;
1100
1261
  }while (searchEndBlock < currentL1BlockNumber)
1101
1262
  // Important that we update AFTER inserting the blocks.
1102
1263
  await updateProvenCheckpoint();
1103
1264
  return {
1104
1265
  ...rollupStatus,
1105
1266
  lastRetrievedCheckpoint,
1106
- lastL1BlockWithCheckpoint
1267
+ lastSeenCheckpoint
1107
1268
  };
1108
1269
  }
1270
+ /**
1271
+ * Checks if a specific checkpoint matches a local pending entry, and if so, loads local data to build
1272
+ * a synthetic published checkpoint (skipping blob fetch).
1273
+ *
1274
+ * Returns { diverged: true, fromCheckpointNumber } when the L1 checkpoint does NOT match local pending
1275
+ * data for that number, so the caller can evict the entire pending suffix >= fromCheckpointNumber
1276
+ * (those entries chain off the now-invalid local state) within the same addCheckpoints transaction.
1277
+ */ async tryBuildPublishedCheckpointFromProposed(calldataCheckpoint) {
1278
+ if (this.config.skipPromoteProposedCheckpointDuringL1Sync || !calldataCheckpoint) {
1279
+ return undefined;
1280
+ }
1281
+ // Look up the specific pending entry for the checkpoint being mined, not just the tip
1282
+ const proposed = await this.stores.blocks.getProposedCheckpointByNumber(calldataCheckpoint.checkpointNumber);
1283
+ if (!proposed) {
1284
+ return undefined;
1285
+ }
1286
+ if (!proposed.header.equals(calldataCheckpoint.header) || !proposed.archive.root.equals(calldataCheckpoint.archiveRoot)) {
1287
+ this.log.warn(`Local proposed checkpoint ${proposed.checkpointNumber} does not match checkpoint retrieved from L1, overriding with L1 data`, {
1288
+ proposedCheckpointNumber: proposed.checkpointNumber,
1289
+ proposedHeader: proposed.header.toInspect(),
1290
+ proposedArchiveRoot: proposed.archive.root.toString(),
1291
+ calldataCheckpointNumber: calldataCheckpoint.checkpointNumber,
1292
+ calldataHeader: calldataCheckpoint.header.toInspect(),
1293
+ calldataArchiveRoot: calldataCheckpoint.archiveRoot.toString()
1294
+ });
1295
+ // Both the locally-proposed checkpoint and the L1-confirmed one are signed by the
1296
+ // slot proposer; emit a divergence event so the slasher can attribute equivocation.
1297
+ // Only emit when the slots match — uncheckpointed entries are pruned above so this
1298
+ // should always hold, but guard defensively to avoid mis-attributing a slash.
1299
+ if (proposed.header.slotNumber === calldataCheckpoint.header.slotNumber) {
1300
+ this.events.emit(L2BlockSourceEvents.CheckpointEquivocationDetected, {
1301
+ type: L2BlockSourceEvents.CheckpointEquivocationDetected,
1302
+ slotNumber: calldataCheckpoint.header.slotNumber,
1303
+ checkpointNumber: calldataCheckpoint.checkpointNumber,
1304
+ l1ArchiveRoot: calldataCheckpoint.archiveRoot,
1305
+ proposedArchiveRoot: proposed.archive.root
1306
+ });
1307
+ }
1308
+ // Return a divergence signal so the caller can evict pending >= this number
1309
+ return {
1310
+ diverged: true,
1311
+ fromCheckpointNumber: proposed.checkpointNumber
1312
+ };
1313
+ }
1314
+ this.log.debug(`Building published checkpoint from proposed ${calldataCheckpoint.checkpointNumber} (skipping blob fetch)`, {
1315
+ proposedHeader: proposed.header.toInspect(),
1316
+ proposedArchiveRoot: proposed.archive.root.toString()
1317
+ });
1318
+ const blocks = await this.stores.blocks.getBlocks({
1319
+ from: BlockNumber(proposed.startBlock),
1320
+ limit: proposed.blockCount
1321
+ });
1322
+ if (blocks.length !== proposed.blockCount) {
1323
+ this.log.warn(`Local proposed checkpoint ${proposed.checkpointNumber} has wrong block count (expected ${proposed.blockCount} blocks starting at ${proposed.startBlock} but got ${blocks.length})`, {
1324
+ proposedCheckpointNumber: proposed.checkpointNumber,
1325
+ proposedStartBlock: proposed.startBlock,
1326
+ proposedBlockCount: proposed.blockCount,
1327
+ retrievedBlocks: blocks.map((b)=>b.number)
1328
+ });
1329
+ return undefined;
1330
+ }
1331
+ const checkpoint = Checkpoint.from({
1332
+ archive: proposed.archive,
1333
+ header: proposed.header,
1334
+ blocks,
1335
+ number: proposed.checkpointNumber,
1336
+ feeAssetPriceModifier: proposed.feeAssetPriceModifier
1337
+ });
1338
+ const promotedCheckpoint = PublishedCheckpoint.from({
1339
+ checkpoint,
1340
+ l1: calldataCheckpoint.l1,
1341
+ attestations: calldataCheckpoint.attestations
1342
+ });
1343
+ this.instrumentation.processCheckpointPromoted();
1344
+ return promotedCheckpoint;
1345
+ }
1109
1346
  async checkForNewCheckpointsBeforeL1SyncPoint(status, blocksSynchedTo, currentL1BlockNumber) {
1110
- const { lastRetrievedCheckpoint, pendingCheckpointNumber } = status;
1111
- // Compare the last checkpoint we have (either retrieved in this round or loaded from store) with what the
1112
- // rollup contract told us was the latest one (pinned at the currentL1BlockNumber).
1113
- const latestLocalCheckpointNumber = lastRetrievedCheckpoint?.checkpoint.number ?? await this.store.getSynchedCheckpointNumber();
1347
+ const { lastSeenCheckpoint, pendingCheckpointNumber } = status;
1348
+ // Compare the last checkpoint (valid or not) we have (either retrieved in this round or loaded from store)
1349
+ // with what the rollup contract told us was the latest one (pinned at the currentL1BlockNumber).
1350
+ const latestLocalCheckpointNumber = lastSeenCheckpoint?.checkpointNumber ?? CheckpointNumber.max(await this.stores.blocks.getLatestCheckpointNumber(), await this.stores.blocks.getLatestRejectedCheckpointNumber()) ?? CheckpointNumber.ZERO;
1114
1351
  if (latestLocalCheckpointNumber < pendingCheckpointNumber) {
1115
1352
  // Here we have consumed all logs until the `currentL1Block` we pinned at the beginning of the archiver loop,
1116
1353
  // but still haven't reached the pending checkpoint according to the call to the rollup contract.
1117
1354
  // We suspect an L1 reorg that added checkpoints *behind* us. If that is the case, it must have happened between
1118
1355
  // the last checkpoint we saw and the current one, so we reset the last synched L1 block number. In the edge case
1119
1356
  // we don't have one, we go back 2 L1 epochs, which is the deepest possible reorg (assuming Casper is working).
1120
- let latestLocalCheckpointArchive = undefined;
1121
- let targetL1BlockNumber = maxBigint(currentL1BlockNumber - 64n, 0n);
1122
- if (lastRetrievedCheckpoint) {
1123
- latestLocalCheckpointArchive = lastRetrievedCheckpoint.checkpoint.archive.root.toString();
1124
- targetL1BlockNumber = lastRetrievedCheckpoint.l1.blockNumber;
1125
- } else if (latestLocalCheckpointNumber > 0) {
1126
- const checkpoint = await this.store.getRangeOfCheckpoints(latestLocalCheckpointNumber, 1).then(([c])=>c);
1127
- latestLocalCheckpointArchive = checkpoint.archive.root.toString();
1128
- targetL1BlockNumber = checkpoint.l1.blockNumber;
1129
- }
1357
+ const latestLocalCheckpoint = lastSeenCheckpoint ?? await this.stores.blocks.getCheckpointData(latestLocalCheckpointNumber) ?? await this.stores.blocks.getRejectedCheckpointByNumber(latestLocalCheckpointNumber);
1358
+ const targetL1BlockNumber = latestLocalCheckpoint?.l1.blockNumber ?? maxBigint(currentL1BlockNumber - 64n, this.l1Constants.l1StartBlock, 0n);
1130
1359
  this.log.warn(`Failed to reach checkpoint ${pendingCheckpointNumber} at ${currentL1BlockNumber} (latest is ${latestLocalCheckpointNumber}). ` + `Rolling back last synched L1 block number to ${targetL1BlockNumber}.`, {
1131
1360
  latestLocalCheckpointNumber,
1132
- latestLocalCheckpointArchive,
1361
+ latestLocalCheckpointL1: latestLocalCheckpoint?.l1,
1133
1362
  blocksSynchedTo,
1134
1363
  currentL1BlockNumber,
1135
1364
  ...status
1136
1365
  });
1137
- await this.store.setCheckpointSynchedL1BlockNumber(targetL1BlockNumber);
1366
+ await this.stores.blocks.setSynchedL1BlockNumber(targetL1BlockNumber);
1138
1367
  } else {
1139
1368
  this.log.trace(`No new checkpoints behind L1 sync point to retrieve.`, {
1140
1369
  latestLocalCheckpointNumber,
@@ -1143,7 +1372,7 @@ _dec = trackSpan('Archiver.syncFromL1'), _dec1 = trackSpan('Archiver.handleEpoch
1143
1372
  }
1144
1373
  }
1145
1374
  async getCheckpointHeader(number) {
1146
- const checkpoint = await this.store.getCheckpointData(number);
1375
+ const checkpoint = await this.stores.blocks.getCheckpointData(number);
1147
1376
  if (!checkpoint) {
1148
1377
  return undefined;
1149
1378
  }