@aztec/archiver 0.0.1-commit.96dac018d → 0.0.1-commit.993d240

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 (121) hide show
  1. package/README.md +19 -11
  2. package/dest/archiver.d.ts +36 -17
  3. package/dest/archiver.d.ts.map +1 -1
  4. package/dest/archiver.js +257 -75
  5. package/dest/config.d.ts +6 -3
  6. package/dest/config.d.ts.map +1 -1
  7. package/dest/config.js +23 -15
  8. package/dest/errors.d.ts +55 -9
  9. package/dest/errors.d.ts.map +1 -1
  10. package/dest/errors.js +81 -14
  11. package/dest/factory.d.ts +13 -9
  12. package/dest/factory.d.ts.map +1 -1
  13. package/dest/factory.js +47 -35
  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 +2 -1
  18. package/dest/l1/calldata_retriever.d.ts.map +1 -1
  19. package/dest/l1/calldata_retriever.js +15 -5
  20. package/dest/l1/data_retrieval.d.ts +24 -12
  21. package/dest/l1/data_retrieval.d.ts.map +1 -1
  22. package/dest/l1/data_retrieval.js +36 -37
  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 +40 -0
  31. package/dest/modules/data_source_base.d.ts +70 -46
  32. package/dest/modules/data_source_base.d.ts.map +1 -1
  33. package/dest/modules/data_source_base.js +270 -135
  34. package/dest/modules/data_store_updater.d.ts +42 -17
  35. package/dest/modules/data_store_updater.d.ts.map +1 -1
  36. package/dest/modules/data_store_updater.js +191 -122
  37. package/dest/modules/instrumentation.d.ts +7 -2
  38. package/dest/modules/instrumentation.d.ts.map +1 -1
  39. package/dest/modules/instrumentation.js +25 -7
  40. package/dest/modules/l1_synchronizer.d.ts +12 -6
  41. package/dest/modules/l1_synchronizer.d.ts.map +1 -1
  42. package/dest/modules/l1_synchronizer.js +432 -205
  43. package/dest/modules/validation.d.ts +4 -3
  44. package/dest/modules/validation.d.ts.map +1 -1
  45. package/dest/modules/validation.js +6 -6
  46. package/dest/store/block_store.d.ts +174 -70
  47. package/dest/store/block_store.d.ts.map +1 -1
  48. package/dest/store/block_store.js +696 -250
  49. package/dest/store/contract_class_store.d.ts +17 -4
  50. package/dest/store/contract_class_store.d.ts.map +1 -1
  51. package/dest/store/contract_class_store.js +24 -68
  52. package/dest/store/contract_instance_store.d.ts +28 -1
  53. package/dest/store/contract_instance_store.d.ts.map +1 -1
  54. package/dest/store/contract_instance_store.js +37 -2
  55. package/dest/store/data_stores.d.ts +68 -0
  56. package/dest/store/data_stores.d.ts.map +1 -0
  57. package/dest/store/data_stores.js +54 -0
  58. package/dest/store/function_names_cache.d.ts +17 -0
  59. package/dest/store/function_names_cache.d.ts.map +1 -0
  60. package/dest/store/function_names_cache.js +30 -0
  61. package/dest/store/l2_tips_cache.d.ts +13 -7
  62. package/dest/store/l2_tips_cache.d.ts.map +1 -1
  63. package/dest/store/l2_tips_cache.js +13 -76
  64. package/dest/store/log_store.d.ts +42 -37
  65. package/dest/store/log_store.d.ts.map +1 -1
  66. package/dest/store/log_store.js +262 -408
  67. package/dest/store/log_store_codec.d.ts +70 -0
  68. package/dest/store/log_store_codec.d.ts.map +1 -0
  69. package/dest/store/log_store_codec.js +101 -0
  70. package/dest/store/message_store.d.ts +11 -1
  71. package/dest/store/message_store.d.ts.map +1 -1
  72. package/dest/store/message_store.js +51 -9
  73. package/dest/test/fake_l1_state.d.ts +20 -1
  74. package/dest/test/fake_l1_state.d.ts.map +1 -1
  75. package/dest/test/fake_l1_state.js +114 -18
  76. package/dest/test/mock_l1_to_l2_message_source.d.ts +1 -1
  77. package/dest/test/mock_l1_to_l2_message_source.d.ts.map +1 -1
  78. package/dest/test/mock_l1_to_l2_message_source.js +2 -1
  79. package/dest/test/mock_l2_block_source.d.ts +52 -46
  80. package/dest/test/mock_l2_block_source.d.ts.map +1 -1
  81. package/dest/test/mock_l2_block_source.js +246 -170
  82. package/dest/test/mock_structs.d.ts +4 -1
  83. package/dest/test/mock_structs.d.ts.map +1 -1
  84. package/dest/test/mock_structs.js +13 -1
  85. package/dest/test/noop_l1_archiver.d.ts +12 -6
  86. package/dest/test/noop_l1_archiver.d.ts.map +1 -1
  87. package/dest/test/noop_l1_archiver.js +26 -9
  88. package/package.json +14 -14
  89. package/src/archiver.ts +313 -75
  90. package/src/config.ts +32 -12
  91. package/src/errors.ts +122 -21
  92. package/src/factory.ts +54 -29
  93. package/src/index.ts +18 -2
  94. package/src/l1/calldata_retriever.ts +16 -5
  95. package/src/l1/data_retrieval.ts +52 -53
  96. package/src/l1/validate_historical_logs.ts +140 -0
  97. package/src/modules/contract_data_source_adapter.ts +55 -0
  98. package/src/modules/data_source_base.ts +336 -171
  99. package/src/modules/data_store_updater.ts +224 -154
  100. package/src/modules/instrumentation.ts +28 -8
  101. package/src/modules/l1_synchronizer.ts +572 -248
  102. package/src/modules/validation.ts +10 -9
  103. package/src/store/block_store.ts +865 -290
  104. package/src/store/contract_class_store.ts +31 -103
  105. package/src/store/contract_instance_store.ts +51 -5
  106. package/src/store/data_stores.ts +104 -0
  107. package/src/store/function_names_cache.ts +37 -0
  108. package/src/store/l2_tips_cache.ts +16 -70
  109. package/src/store/log_store.ts +301 -559
  110. package/src/store/log_store_codec.ts +132 -0
  111. package/src/store/message_store.ts +60 -10
  112. package/src/structs/inbox_message.ts +1 -1
  113. package/src/test/fake_l1_state.ts +142 -29
  114. package/src/test/mock_l1_to_l2_message_source.ts +1 -0
  115. package/src/test/mock_l2_block_source.ts +309 -205
  116. package/src/test/mock_structs.ts +20 -6
  117. package/src/test/noop_l1_archiver.ts +39 -9
  118. package/dest/store/kv_archiver_store.d.ts +0 -354
  119. package/dest/store/kv_archiver_store.d.ts.map +0 -1
  120. package/dest/store/kv_archiver_store.js +0 -464
  121. package/src/store/kv_archiver_store.ts +0 -671
@@ -1,91 +1,125 @@
1
1
  import { BlockNumber } from '@aztec/foundation/branded-types';
2
- import { Fr } from '@aztec/foundation/curves/bn254';
2
+ import { filterAsync } from '@aztec/foundation/collection';
3
3
  import { createLogger } from '@aztec/foundation/log';
4
- import { ContractClassPublishedEvent, PrivateFunctionBroadcastedEvent, UtilityFunctionBroadcastedEvent } from '@aztec/protocol-contracts/class-registry';
4
+ import { ContractClassPublishedEvent } from '@aztec/protocol-contracts/class-registry';
5
5
  import { ContractInstancePublishedEvent, ContractInstanceUpdatedEvent } from '@aztec/protocol-contracts/instance-registry';
6
- import { computePublicBytecodeCommitment, isValidPrivateFunctionMembershipProof, isValidUtilityFunctionMembershipProof } from '@aztec/stdlib/contract';
7
- import groupBy from 'lodash.groupby';
6
+ import { validateCheckpoint } from '@aztec/stdlib/checkpoint';
7
+ import { computeContractAddressFromInstance, computeContractClassId } from '@aztec/stdlib/contract';
8
8
  /** Operation type for contract data updates. */ var Operation = /*#__PURE__*/ function(Operation) {
9
9
  Operation[Operation["Store"] = 0] = "Store";
10
10
  Operation[Operation["Delete"] = 1] = "Delete";
11
11
  return Operation;
12
12
  }(Operation || {});
13
13
  /** Archiver helper module to handle updates to the data store. */ export class ArchiverDataStoreUpdater {
14
- store;
14
+ stores;
15
15
  l2TipsCache;
16
+ opts;
16
17
  log;
17
- constructor(store, l2TipsCache){
18
- this.store = store;
18
+ constructor(stores, l2TipsCache, opts = {}){
19
+ this.stores = stores;
19
20
  this.l2TipsCache = l2TipsCache;
21
+ this.opts = opts;
20
22
  this.log = createLogger('archiver:store_updater');
21
23
  }
22
24
  /**
23
- * Adds proposed blocks to the store with contract class/instance extraction from logs.
24
- * These are uncheckpointed blocks that have been proposed by the sequencer but not yet included in a checkpoint on L1.
25
- * Extracts ContractClassPublished, ContractInstancePublished, ContractInstanceUpdated events,
26
- * and individually broadcasted functions from the block logs.
25
+ * Adds a proposed block to the store with contract class/instance extraction from logs.
26
+ * This is an uncheckpointed block that has been proposed by the sequencer but not yet included in a checkpoint on L1.
27
+ * Extracts ContractClassPublished, ContractInstancePublished, ContractInstanceUpdated events from the block logs.
27
28
  *
28
- * @param blocks - The proposed L2 blocks to add.
29
+ * @param block - The proposed L2 block to add.
29
30
  * @param pendingChainValidationStatus - Optional validation status to set.
30
31
  * @returns True if the operation is successful.
31
- */ async addProposedBlocks(blocks, pendingChainValidationStatus) {
32
- const result = await this.store.transactionAsync(async ()=>{
33
- await this.store.addProposedBlocks(blocks);
32
+ */ async addProposedBlock(block, pendingChainValidationStatus) {
33
+ const result = await this.stores.db.transactionAsync(async ()=>{
34
+ await this.stores.blocks.addProposedBlock(block);
34
35
  const opResults = await Promise.all([
35
36
  // Update the pending chain validation status if provided
36
- pendingChainValidationStatus && this.store.setPendingChainValidationStatus(pendingChainValidationStatus),
37
- // Add any logs emitted during the retrieved blocks
38
- this.store.addLogs(blocks),
39
- // Unroll all logs emitted during the retrieved blocks and extract any contract classes and instances from them
40
- ...blocks.map((block)=>this.addContractDataToDb(block))
37
+ pendingChainValidationStatus && this.stores.blocks.setPendingChainValidationStatus(pendingChainValidationStatus),
38
+ // Add any logs emitted during the retrieved block
39
+ this.stores.logs.addLogs([
40
+ block
41
+ ]),
42
+ // Unroll all logs emitted during the retrieved block and extract any contract classes and instances from it
43
+ this.addContractDataToDb(block)
41
44
  ]);
42
- await this.l2TipsCache?.refresh();
43
45
  return opResults.every(Boolean);
44
46
  });
47
+ await this.l2TipsCache?.refresh();
45
48
  return result;
46
49
  }
47
50
  /**
48
51
  * Reconciles local blocks with incoming checkpoints from L1.
49
52
  * Adds new checkpoints to the store with contract class/instance extraction from logs.
50
53
  * Prunes any local blocks that conflict with checkpoint data (by comparing archive roots).
51
- * Extracts ContractClassPublished, ContractInstancePublished, ContractInstanceUpdated events,
52
- * and individually broadcasted functions from the checkpoint block logs.
54
+ * Extracts ContractClassPublished, ContractInstancePublished, ContractInstanceUpdated events from the checkpoint block logs.
55
+ * If `promoteProposed` is supplied, the proposed-checkpoint promotion runs inside the same transaction
56
+ * as the added checkpoints so both updates are applied atomically.
53
57
  *
54
- * @param checkpoints - The published checkpoints to add.
58
+ * @param checkpoints - The published checkpoints to add (excluding any being promoted from proposed).
55
59
  * @param pendingChainValidationStatus - Optional validation status to set.
60
+ * @param promoteProposed - Optional promotion of the current proposed checkpoint (fast path when blocks are already local).
56
61
  * @returns Result with information about any pruned blocks.
57
- */ async addCheckpoints(checkpoints, pendingChainValidationStatus) {
58
- const result = await this.store.transactionAsync(async ()=>{
62
+ */ async addCheckpoints(checkpoints, pendingChainValidationStatus, promoteProposed, evictProposedFrom) {
63
+ for (const checkpoint of checkpoints){
64
+ validateCheckpoint(checkpoint.checkpoint, {
65
+ rollupManaLimit: this.opts?.rollupManaLimit
66
+ });
67
+ }
68
+ if (promoteProposed) {
69
+ validateCheckpoint(promoteProposed.checkpoint.checkpoint, {
70
+ rollupManaLimit: this.opts?.rollupManaLimit
71
+ });
72
+ }
73
+ const result = await this.stores.db.transactionAsync(async ()=>{
59
74
  // Before adding checkpoints, check for conflicts with local blocks if any
60
75
  const { prunedBlocks, lastAlreadyInsertedBlockNumber } = await this.pruneMismatchingLocalBlocks(checkpoints);
61
- await this.store.addCheckpoints(checkpoints);
62
- // Filter out blocks that were already inserted via addProposedBlocks() to avoid duplicating logs/contract data
76
+ await this.stores.blocks.addCheckpoints(checkpoints);
77
+ // Filter out blocks that were already inserted via addProposedBlock() to avoid duplicating logs/contract data
63
78
  const newBlocks = checkpoints.flatMap((ch)=>ch.checkpoint.blocks).filter((b)=>lastAlreadyInsertedBlockNumber === undefined || b.number > lastAlreadyInsertedBlockNumber);
64
79
  await Promise.all([
65
80
  // Update the pending chain validation status if provided
66
- pendingChainValidationStatus && this.store.setPendingChainValidationStatus(pendingChainValidationStatus),
81
+ pendingChainValidationStatus && this.stores.blocks.setPendingChainValidationStatus(pendingChainValidationStatus),
67
82
  // Add any logs emitted during the retrieved blocks
68
- this.store.addLogs(newBlocks),
83
+ this.stores.logs.addLogs(newBlocks),
69
84
  // Unroll all logs emitted during the retrieved blocks and extract any contract classes and instances from them
70
- ...newBlocks.map((block)=>this.addContractDataToDb(block))
85
+ ...newBlocks.map((block)=>this.addContractDataToDb(block)),
86
+ // Promote the proposed checkpoint if requested (uses explicit checkpoint number)
87
+ promoteProposed ? this.stores.blocks.promoteProposedToCheckpointed(promoteProposed.checkpoint.checkpoint.number, promoteProposed.l1, promoteProposed.attestations, promoteProposed.checkpoint.checkpoint.archive.root) : undefined,
88
+ // Evict pending checkpoints that diverged from what L1 mined
89
+ evictProposedFrom !== undefined ? this.stores.blocks.evictProposedCheckpointsFrom(evictProposedFrom) : undefined
71
90
  ]);
72
- await this.l2TipsCache?.refresh();
73
91
  return {
74
92
  prunedBlocks,
75
93
  lastAlreadyInsertedBlockNumber
76
94
  };
77
95
  });
96
+ await this.l2TipsCache?.refresh();
97
+ return result;
98
+ }
99
+ async addProposedCheckpoint(proposedCheckpoint) {
100
+ const result = await this.stores.db.transactionAsync(async ()=>{
101
+ await this.stores.blocks.addProposedCheckpoint(proposedCheckpoint);
102
+ });
103
+ await this.l2TipsCache?.refresh();
78
104
  return result;
79
105
  }
80
106
  /**
81
107
  * Checks for local proposed blocks that do not match the ones to be checkpointed and prunes them.
82
- * This method handles multiple checkpoints but returns after pruning the first conflict found.
83
- * This is correct because pruning from the first conflict point removes all subsequent blocks,
84
- * and when checkpoints are added afterward, they include all the correct blocks.
108
+ * Conflict detection is keyed on `blockNumber`: when a local proposed block and an L1
109
+ * checkpointed block share a block number but live at different slots (e.g. a different proposer
110
+ * mined the same block number one slot earlier), we still treat them as a conflict and prune.
111
+ * The trailing per-checkpoint prune that handles "local has extra trailing blocks within the
112
+ * same slot as the published checkpoint" remains scoped by slot to preserve pipelining: local
113
+ * blocks that live at a later slot than the checkpoint being processed represent speculation
114
+ * atop the just-confirmed tip (and may be referenced by a pending proposed checkpoint), so we
115
+ * leave them in place. This method handles multiple checkpoints but returns after pruning the
116
+ * first conflict found. This is correct because pruning from the first conflict point removes
117
+ * all subsequent blocks, and when checkpoints are added afterward, they include all the correct
118
+ * blocks.
85
119
  */ async pruneMismatchingLocalBlocks(checkpoints) {
86
120
  const [lastCheckpointedBlockNumber, lastBlockNumber] = await Promise.all([
87
- this.store.getCheckpointedL2BlockNumber(),
88
- this.store.getLatestBlockNumber()
121
+ this.stores.blocks.getCheckpointedL2BlockNumber(),
122
+ this.stores.blocks.getLatestL2BlockNumber()
89
123
  ]);
90
124
  // Exit early if there are no local uncheckpointed blocks
91
125
  if (lastBlockNumber === lastCheckpointedBlockNumber) {
@@ -95,22 +129,25 @@ import groupBy from 'lodash.groupby';
95
129
  };
96
130
  }
97
131
  // Get all uncheckpointed local blocks
98
- const uncheckpointedLocalBlocks = await this.store.getBlocks(BlockNumber.add(lastCheckpointedBlockNumber, 1), lastBlockNumber - lastCheckpointedBlockNumber);
132
+ const uncheckpointedLocalBlocks = await this.stores.blocks.getBlocksData({
133
+ from: BlockNumber.add(lastCheckpointedBlockNumber, 1),
134
+ limit: lastBlockNumber - lastCheckpointedBlockNumber
135
+ });
99
136
  let lastAlreadyInsertedBlockNumber;
100
137
  for (const publishedCheckpoint of checkpoints){
101
138
  const checkpointBlocks = publishedCheckpoint.checkpoint.blocks;
102
139
  const slot = publishedCheckpoint.checkpoint.slot;
103
- const localBlocksInSlot = uncheckpointedLocalBlocks.filter((b)=>b.slot === slot);
104
140
  if (checkpointBlocks.length === 0) {
105
141
  this.log.warn(`Checkpoint ${publishedCheckpoint.checkpoint.number} for slot ${slot} has no blocks`);
106
142
  continue;
107
143
  }
108
- // Find the first checkpoint block that conflicts with an existing local block and prune local afterwards
144
+ // Find the first checkpoint block that conflicts with an existing local block and prune local afterwards.
145
+ // Conflict detection joins on block number only — same block number at a different slot is still a conflict.
109
146
  for (const checkpointBlock of checkpointBlocks){
110
147
  const blockNumber = checkpointBlock.number;
111
- const existingBlock = localBlocksInSlot.find((b)=>b.number === blockNumber);
148
+ const existingBlock = uncheckpointedLocalBlocks.find((b)=>b.header.getBlockNumber() === blockNumber);
112
149
  const blockInfos = {
113
- existingBlock: existingBlock?.toBlockInfo(),
150
+ existingBlock: existingBlock?.header.toInspect(),
114
151
  checkpointBlock: checkpointBlock.toBlockInfo()
115
152
  };
116
153
  if (!existingBlock) {
@@ -119,21 +156,25 @@ import groupBy from 'lodash.groupby';
119
156
  this.log.verbose(`Block number ${blockNumber} already inserted and matches checkpoint`, blockInfos);
120
157
  lastAlreadyInsertedBlockNumber = blockNumber;
121
158
  } else {
122
- this.log.warn(`Conflict detected at block ${blockNumber} between checkpointed and local block`, blockInfos);
159
+ this.log.info(`Conflict detected at block ${blockNumber} between checkpointed and local block`, blockInfos);
123
160
  const prunedBlocks = await this.removeBlocksAfter(BlockNumber(blockNumber - 1));
161
+ await this.evictProposedCheckpointsForPrunedBlocks(prunedBlocks);
124
162
  return {
125
163
  prunedBlocks,
126
164
  lastAlreadyInsertedBlockNumber
127
165
  };
128
166
  }
129
167
  }
130
- // If local has more blocks than the checkpoint (e.g., local has [2,3,4] but checkpoint has [2,3]),
131
- // we need to prune the extra local blocks so they match what was checkpointed
168
+ // If the sequencer locally proposed extra blocks within this checkpoint's slot (e.g. local has
169
+ // [N, N+1] but L1 confirmed just [N]), prune the extras. Scoped to the checkpoint's slot so we
170
+ // do not throw away speculative blocks at later slots that belong to a pending proposed checkpoint.
132
171
  const lastCheckpointBlockNumber = checkpointBlocks.at(-1).number;
133
- const lastLocalBlockNumber = localBlocksInSlot.at(-1)?.number;
172
+ const localBlocksInSlot = uncheckpointedLocalBlocks.filter((b)=>b.header.getSlot() === slot);
173
+ const lastLocalBlockNumber = localBlocksInSlot.at(-1)?.header.getBlockNumber();
134
174
  if (lastLocalBlockNumber !== undefined && lastLocalBlockNumber > lastCheckpointBlockNumber) {
135
175
  this.log.warn(`Local chain for slot ${slot} ends at block ${lastLocalBlockNumber} but checkpoint ends at ${lastCheckpointBlockNumber}. Pruning blocks after block ${lastCheckpointBlockNumber}.`);
136
176
  const prunedBlocks = await this.removeBlocksAfter(lastCheckpointBlockNumber);
177
+ await this.evictProposedCheckpointsForPrunedBlocks(prunedBlocks);
137
178
  return {
138
179
  prunedBlocks,
139
180
  lastAlreadyInsertedBlockNumber
@@ -154,27 +195,60 @@ import groupBy from 'lodash.groupby';
154
195
  * @returns The removed blocks.
155
196
  * @throws Error if any block to be removed is checkpointed.
156
197
  */ async removeUncheckpointedBlocksAfter(blockNumber) {
157
- const result = await this.store.transactionAsync(async ()=>{
198
+ const result = await this.stores.db.transactionAsync(async ()=>{
158
199
  // Verify we're only removing uncheckpointed blocks
159
- const lastCheckpointedBlockNumber = await this.store.getCheckpointedL2BlockNumber();
200
+ const lastCheckpointedBlockNumber = await this.stores.blocks.getCheckpointedL2BlockNumber();
160
201
  if (blockNumber < lastCheckpointedBlockNumber) {
161
202
  throw new Error(`Cannot remove blocks after ${blockNumber} because checkpointed blocks exist up to ${lastCheckpointedBlockNumber}`);
162
203
  }
163
- const result = await this.removeBlocksAfter(blockNumber);
164
- await this.l2TipsCache?.refresh();
165
- return result;
204
+ const prunedBlocks = await this.removeBlocksAfter(blockNumber);
205
+ await this.evictProposedCheckpointsForPrunedBlocks(prunedBlocks);
206
+ return prunedBlocks;
166
207
  });
208
+ await this.l2TipsCache?.refresh();
167
209
  return result;
168
210
  }
169
211
  /**
212
+ * Removes all blocks without a proposed checkpoint strictly after the specified block number and cleans up associated contract data.
213
+ * This handles removal of provisionally added blocks along with their contract classes/instances.
214
+ * Verifies that each block being removed is not part of a stored checkpoint (proposed or not).
215
+ * This differs from `removeUncheckpointedBlocksAfter` in that it also checks proposed checkpoints.
216
+ *
217
+ * @param blockNumber - Remove all blocks with number greater than this.
218
+ * @returns The removed blocks.
219
+ * @throws Error if any block to be removed is checkpointed.
220
+ */ async removeBlocksWithoutProposedCheckpointAfter(blockNumber) {
221
+ const result = await this.stores.db.transactionAsync(async ()=>{
222
+ // Verify we're only removing uncheckpointed blocks
223
+ const lastCheckpointedBlockNumber = await this.stores.blocks.getProposedCheckpointL2BlockNumber();
224
+ if (blockNumber < lastCheckpointedBlockNumber) {
225
+ throw new Error(`Cannot remove blocks after ${blockNumber} because proposed checkpointed blocks exist up to ${lastCheckpointedBlockNumber}`);
226
+ }
227
+ return await this.removeBlocksAfter(blockNumber);
228
+ });
229
+ await this.l2TipsCache?.refresh();
230
+ return result;
231
+ }
232
+ /**
233
+ * Evicts pending proposed checkpoints that referenced any of the just-pruned blocks. Pruned
234
+ * blocks invalidate all proposed checkpoints from the lowest pruned block's checkpoint number
235
+ * onwards: those checkpoints either reference the pruned blocks directly or chain off them.
236
+ */ async evictProposedCheckpointsForPrunedBlocks(prunedBlocks) {
237
+ if (prunedBlocks.length === 0) {
238
+ return;
239
+ }
240
+ const fromCheckpointNumber = prunedBlocks[0].checkpointNumber;
241
+ await this.stores.blocks.evictProposedCheckpointsFrom(fromCheckpointNumber);
242
+ }
243
+ /**
170
244
  * Removes all blocks strictly after the given block number along with any logs and contract data.
171
245
  * Does not remove their checkpoints.
172
246
  */ async removeBlocksAfter(blockNumber) {
173
247
  // First get the blocks to be removed so we can clean up contract data
174
- const removedBlocks = await this.store.removeBlocksAfter(blockNumber);
248
+ const removedBlocks = await this.stores.blocks.removeBlocksAfter(blockNumber);
175
249
  // Clean up contract data and logs for the removed blocks
176
250
  await Promise.all([
177
- this.store.deleteLogs(removedBlocks),
251
+ this.stores.logs.deleteLogs(removedBlocks),
178
252
  ...removedBlocks.map((block)=>this.removeContractDataFromDb(block))
179
253
  ]);
180
254
  return removedBlocks;
@@ -188,29 +262,39 @@ import groupBy from 'lodash.groupby';
188
262
  * @param checkpointNumber - Remove all checkpoints strictly after this one.
189
263
  * @returns True if the operation is successful.
190
264
  */ async removeCheckpointsAfter(checkpointNumber) {
191
- return await this.store.transactionAsync(async ()=>{
192
- const { blocksRemoved = [] } = await this.store.removeCheckpointsAfter(checkpointNumber);
265
+ const result = await this.stores.db.transactionAsync(async ()=>{
266
+ const { blocksRemoved = [] } = await this.stores.blocks.removeCheckpointsAfter(checkpointNumber);
193
267
  const opResults = await Promise.all([
194
268
  // Prune rolls back to the last proven block, which is by definition valid
195
- this.store.setPendingChainValidationStatus({
269
+ this.stores.blocks.setPendingChainValidationStatus({
196
270
  valid: true
197
271
  }),
198
272
  // Remove contract data for all blocks being removed
199
273
  ...blocksRemoved.map((block)=>this.removeContractDataFromDb(block)),
200
- this.store.deleteLogs(blocksRemoved)
274
+ this.stores.logs.deleteLogs(blocksRemoved)
201
275
  ]);
202
- await this.l2TipsCache?.refresh();
203
276
  return opResults.every(Boolean);
204
277
  });
278
+ await this.l2TipsCache?.refresh();
279
+ return result;
205
280
  }
206
281
  /**
207
282
  * Updates the proven checkpoint number and refreshes the L2 tips cache.
208
283
  * @param checkpointNumber - The checkpoint number to set as proven.
209
284
  */ async setProvenCheckpointNumber(checkpointNumber) {
210
- await this.store.transactionAsync(async ()=>{
211
- await this.store.setProvenCheckpointNumber(checkpointNumber);
212
- await this.l2TipsCache?.refresh();
285
+ await this.stores.db.transactionAsync(async ()=>{
286
+ await this.stores.blocks.setProvenCheckpointNumber(checkpointNumber);
287
+ });
288
+ await this.l2TipsCache?.refresh();
289
+ }
290
+ /**
291
+ * Updates the finalized checkpoint number and refreshes the L2 tips cache.
292
+ * @param checkpointNumber - The checkpoint number to set as finalized.
293
+ */ async setFinalizedCheckpointNumber(checkpointNumber) {
294
+ await this.stores.db.transactionAsync(async ()=>{
295
+ await this.stores.blocks.setFinalizedCheckpointNumber(checkpointNumber);
213
296
  });
297
+ await this.l2TipsCache?.refresh();
214
298
  }
215
299
  /** Extracts and stores contract data from a single block. */ addContractDataToDb(block) {
216
300
  return this.updateContractDataOnDb(block, 0);
@@ -225,37 +309,68 @@ import groupBy from 'lodash.groupby';
225
309
  return (await Promise.all([
226
310
  this.updatePublishedContractClasses(contractClassLogs, block.number, operation),
227
311
  this.updateDeployedContractInstances(privateLogs, block.number, operation),
228
- this.updateUpdatedContractInstances(publicLogs, block.header.globalVariables.timestamp, operation),
229
- operation === 0 ? this.storeBroadcastedIndividualFunctions(contractClassLogs, block.number) : Promise.resolve(true)
312
+ this.updateUpdatedContractInstances(publicLogs, block.header.globalVariables.timestamp, operation)
230
313
  ])).every(Boolean);
231
314
  }
232
315
  /**
233
316
  * Extracts and stores contract classes out of ContractClassPublished events emitted by the class registry contract.
234
317
  */ async updatePublishedContractClasses(allLogs, blockNum, operation) {
235
318
  const contractClassPublishedEvents = allLogs.filter((log)=>ContractClassPublishedEvent.isContractClassPublishedEvent(log)).map((log)=>ContractClassPublishedEvent.fromLog(log));
236
- const contractClasses = await Promise.all(contractClassPublishedEvents.map((e)=>e.toContractClassPublic()));
319
+ if (operation == 1) {
320
+ const contractClasses = contractClassPublishedEvents.map((e)=>e.toContractClassPublic());
321
+ if (contractClasses.length > 0) {
322
+ contractClasses.forEach((c)=>this.log.verbose(`${Operation[operation]} contract class ${c.id.toString()}`));
323
+ return await this.stores.contractClasses.deleteContractClasses(contractClasses, blockNum);
324
+ }
325
+ return true;
326
+ }
327
+ // Compute bytecode commitments and validate class IDs in a single pass.
328
+ const contractClasses = [];
329
+ for (const event of contractClassPublishedEvents){
330
+ const contractClass = await event.toContractClassPublicWithBytecodeCommitment();
331
+ const computedClassId = await computeContractClassId({
332
+ artifactHash: contractClass.artifactHash,
333
+ privateFunctionsRoot: contractClass.privateFunctionsRoot,
334
+ publicBytecodeCommitment: contractClass.publicBytecodeCommitment
335
+ });
336
+ if (!computedClassId.equals(contractClass.id)) {
337
+ this.log.warn(`Skipping contract class with mismatched id at block ${blockNum}. Claimed ${contractClass.id}, computed ${computedClassId}`, {
338
+ blockNum,
339
+ contractClassId: event.contractClassId.toString()
340
+ });
341
+ continue;
342
+ }
343
+ contractClasses.push(contractClass);
344
+ }
237
345
  if (contractClasses.length > 0) {
238
346
  contractClasses.forEach((c)=>this.log.verbose(`${Operation[operation]} contract class ${c.id.toString()}`));
239
- if (operation == 0) {
240
- // TODO: Will probably want to create some worker threads to compute these bytecode commitments as they are expensive
241
- const commitments = await Promise.all(contractClasses.map((c)=>computePublicBytecodeCommitment(c.packedBytecode)));
242
- return await this.store.addContractClasses(contractClasses, commitments, blockNum);
243
- } else if (operation == 1) {
244
- return await this.store.deleteContractClasses(contractClasses, blockNum);
245
- }
347
+ return await this.stores.contractClasses.addContractClasses(contractClasses, blockNum);
246
348
  }
247
349
  return true;
248
350
  }
249
351
  /**
250
352
  * Extracts and stores contract instances out of ContractInstancePublished events emitted by the canonical deployer contract.
251
353
  */ async updateDeployedContractInstances(allLogs, blockNum, operation) {
252
- const contractInstances = allLogs.filter((log)=>ContractInstancePublishedEvent.isContractInstancePublishedEvent(log)).map((log)=>ContractInstancePublishedEvent.fromLog(log)).map((e)=>e.toContractInstance());
354
+ const allInstances = allLogs.filter((log)=>ContractInstancePublishedEvent.isContractInstancePublishedEvent(log)).map((log)=>ContractInstancePublishedEvent.fromLog(log)).map((e)=>e.toContractInstance());
355
+ // Verify that each instance's address matches the one derived from its fields if we're adding
356
+ const contractInstances = operation === 1 ? allInstances : await filterAsync(allInstances, async (instance)=>{
357
+ const computedAddress = await computeContractAddressFromInstance(instance);
358
+ if (!computedAddress.equals(instance.address)) {
359
+ this.log.warn(`Found contract instance with mismatched address at block ${blockNum}. Claimed ${instance.address} but computed ${computedAddress}.`, {
360
+ instanceAddress: instance.address.toString(),
361
+ computedAddress: computedAddress.toString(),
362
+ blockNum
363
+ });
364
+ return false;
365
+ }
366
+ return true;
367
+ });
253
368
  if (contractInstances.length > 0) {
254
369
  contractInstances.forEach((c)=>this.log.verbose(`${Operation[operation]} contract instance at ${c.address.toString()}`));
255
370
  if (operation == 0) {
256
- return await this.store.addContractInstances(contractInstances, blockNum);
371
+ return await this.stores.contractInstances.addContractInstances(contractInstances, blockNum);
257
372
  } else if (operation == 1) {
258
- return await this.store.deleteContractInstances(contractInstances, blockNum);
373
+ return await this.stores.contractInstances.deleteContractInstances(contractInstances);
259
374
  }
260
375
  }
261
376
  return true;
@@ -267,56 +382,10 @@ import groupBy from 'lodash.groupby';
267
382
  if (contractUpdates.length > 0) {
268
383
  contractUpdates.forEach((c)=>this.log.verbose(`${Operation[operation]} contract instance update at ${c.address.toString()}`));
269
384
  if (operation == 0) {
270
- return await this.store.addContractInstanceUpdates(contractUpdates, timestamp);
385
+ return await this.stores.contractInstances.addContractInstanceUpdates(contractUpdates, timestamp);
271
386
  } else if (operation == 1) {
272
- return await this.store.deleteContractInstanceUpdates(contractUpdates, timestamp);
273
- }
274
- }
275
- return true;
276
- }
277
- /**
278
- * Stores the functions that were broadcasted individually.
279
- *
280
- * @dev Beware that there is not a delete variant of this, since they are added to contract classes
281
- * and will be deleted as part of the class if needed.
282
- */ async storeBroadcastedIndividualFunctions(allLogs, _blockNum) {
283
- // Filter out private and utility function broadcast events
284
- const privateFnEvents = allLogs.filter((log)=>PrivateFunctionBroadcastedEvent.isPrivateFunctionBroadcastedEvent(log)).map((log)=>PrivateFunctionBroadcastedEvent.fromLog(log));
285
- const utilityFnEvents = allLogs.filter((log)=>UtilityFunctionBroadcastedEvent.isUtilityFunctionBroadcastedEvent(log)).map((log)=>UtilityFunctionBroadcastedEvent.fromLog(log));
286
- // Group all events by contract class id
287
- for (const [classIdString, classEvents] of Object.entries(groupBy([
288
- ...privateFnEvents,
289
- ...utilityFnEvents
290
- ], (e)=>e.contractClassId.toString()))){
291
- const contractClassId = Fr.fromHexString(classIdString);
292
- const contractClass = await this.store.getContractClass(contractClassId);
293
- if (!contractClass) {
294
- this.log.warn(`Skipping broadcasted functions as contract class ${contractClassId.toString()} was not found`);
295
- continue;
296
- }
297
- // Split private and utility functions, and filter out invalid ones
298
- const allFns = classEvents.map((e)=>e.toFunctionWithMembershipProof());
299
- const privateFns = allFns.filter((fn)=>'utilityFunctionsTreeRoot' in fn);
300
- const utilityFns = allFns.filter((fn)=>'privateFunctionsArtifactTreeRoot' in fn);
301
- const privateFunctionsWithValidity = await Promise.all(privateFns.map(async (fn)=>({
302
- fn,
303
- valid: await isValidPrivateFunctionMembershipProof(fn, contractClass)
304
- })));
305
- const validPrivateFns = privateFunctionsWithValidity.filter(({ valid })=>valid).map(({ fn })=>fn);
306
- const utilityFunctionsWithValidity = await Promise.all(utilityFns.map(async (fn)=>({
307
- fn,
308
- valid: await isValidUtilityFunctionMembershipProof(fn, contractClass)
309
- })));
310
- const validUtilityFns = utilityFunctionsWithValidity.filter(({ valid })=>valid).map(({ fn })=>fn);
311
- const validFnCount = validPrivateFns.length + validUtilityFns.length;
312
- if (validFnCount !== allFns.length) {
313
- this.log.warn(`Skipping ${allFns.length - validFnCount} invalid functions`);
314
- }
315
- // Store the functions in the contract class in a single operation
316
- if (validFnCount > 0) {
317
- this.log.verbose(`Storing ${validFnCount} functions for contract class ${contractClassId.toString()}`);
387
+ return await this.stores.contractInstances.deleteContractInstanceUpdates(contractUpdates, timestamp);
318
388
  }
319
- return await this.store.addFunctions(contractClassId, validPrivateFns, validUtilityFns);
320
389
  }
321
390
  return true;
322
391
  }
@@ -16,6 +16,7 @@ export declare class ArchiverInstrumentation {
16
16
  private pruneDuration;
17
17
  private pruneCount;
18
18
  private syncDurationPerBlock;
19
+ private syncDurationPerCheckpoint;
19
20
  private syncBlockCount;
20
21
  private manaPerBlock;
21
22
  private txsPerBlock;
@@ -23,11 +24,13 @@ export declare class ArchiverInstrumentation {
23
24
  private syncMessageCount;
24
25
  private blockProposalTxTargetCount;
25
26
  private checkpointL1InclusionDelay;
27
+ private checkpointPromotedCount;
26
28
  private log;
27
29
  private constructor();
28
30
  static new(telemetry: TelemetryClient, lmdbStats?: LmdbStatsCallback): Promise<ArchiverInstrumentation>;
29
31
  isEnabled(): boolean;
30
- processNewBlocks(syncTimePerBlock: number, blocks: L2Block[]): void;
32
+ processNewProposedBlock(syncTimePerBlock: number, block: L2Block): void;
33
+ processNewCheckpointedBlocks(syncTimePerCheckpoint: number, blocks: L2Block[]): void;
31
34
  processNewMessages(count: number, syncPerMessageMs: number): void;
32
35
  processPrune(duration: number): void;
33
36
  updateLastProvenCheckpoint(checkpoint: CheckpointData): void;
@@ -38,6 +41,8 @@ export declare class ArchiverInstrumentation {
38
41
  }[]): void;
39
42
  updateL1BlockHeight(blockNumber: bigint): void;
40
43
  recordBlockProposalTxTarget(target: string, usedTrace: boolean): void;
44
+ /** Records a checkpoint promoted from proposed (blob fetch skipped). */
45
+ processCheckpointPromoted(): void;
41
46
  /**
42
47
  * Records L1 inclusion timing for a checkpoint observed on L1 (seconds into the L2 slot).
43
48
  */
@@ -47,4 +52,4 @@ export declare class ArchiverInstrumentation {
47
52
  l1Constants: Pick<L1RollupConstants, 'l1GenesisTime' | 'slotDuration'>;
48
53
  }): void;
49
54
  }
50
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5zdHJ1bWVudGF0aW9uLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbW9kdWxlcy9pbnN0cnVtZW50YXRpb24udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsVUFBVSxFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFFbEUsT0FBTyxLQUFLLEVBQUUsT0FBTyxFQUFFLE1BQU0scUJBQXFCLENBQUM7QUFDbkQsT0FBTyxLQUFLLEVBQUUsY0FBYyxFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUFDL0QsT0FBTyxLQUFLLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUVyRSxPQUFPLEVBS0wsS0FBSyxpQkFBaUIsRUFFdEIsS0FBSyxlQUFlLEVBQ3BCLEtBQUssTUFBTSxFQUdaLE1BQU0seUJBQXlCLENBQUM7QUFFakMscUJBQWEsdUJBQXVCO0lBNkJoQyxPQUFPLENBQUMsU0FBUztJQTVCbkIsU0FBZ0IsTUFBTSxFQUFFLE1BQU0sQ0FBQztJQUUvQixPQUFPLENBQUMsV0FBVyxDQUFRO0lBQzNCLE9BQU8sQ0FBQyxnQkFBZ0IsQ0FBUTtJQUNoQyxPQUFPLENBQUMsT0FBTyxDQUFnQjtJQUMvQixPQUFPLENBQUMsYUFBYSxDQUFRO0lBQzdCLE9BQU8sQ0FBQyxvQkFBb0IsQ0FBWTtJQUN4QyxPQUFPLENBQUMsb0JBQW9CLENBQWdCO0lBQzVDLE9BQU8sQ0FBQyxTQUFTLENBQWM7SUFFL0IsT0FBTyxDQUFDLGFBQWEsQ0FBWTtJQUNqQyxPQUFPLENBQUMsVUFBVSxDQUFnQjtJQUVsQyxPQUFPLENBQUMsb0JBQW9CLENBQVk7SUFDeEMsT0FBTyxDQUFDLGNBQWMsQ0FBZ0I7SUFDdEMsT0FBTyxDQUFDLFlBQVksQ0FBWTtJQUNoQyxPQUFPLENBQUMsV0FBVyxDQUFZO0lBRS9CLE9BQU8sQ0FBQyxzQkFBc0IsQ0FBWTtJQUMxQyxPQUFPLENBQUMsZ0JBQWdCLENBQWdCO0lBRXhDLE9BQU8sQ0FBQywwQkFBMEIsQ0FBZ0I7SUFFbEQsT0FBTyxDQUFDLDBCQUEwQixDQUFZO0lBRTlDLE9BQU8sQ0FBQyxHQUFHLENBQTRDO0lBRXZELE9BQU8sZUFzRE47SUFFRCxPQUFvQixHQUFHLENBQUMsU0FBUyxFQUFFLGVBQWUsRUFBRSxTQUFTLENBQUMsRUFBRSxpQkFBaUIsb0NBTWhGO0lBRU0sU0FBUyxJQUFJLE9BQU8sQ0FFMUI7SUFFTSxnQkFBZ0IsQ0FBQyxnQkFBZ0IsRUFBRSxNQUFNLEVBQUUsTUFBTSxFQUFFLE9BQU8sRUFBRSxRQVdsRTtJQUVNLGtCQUFrQixDQUFDLEtBQUssRUFBRSxNQUFNLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxRQU1oRTtJQUVNLFlBQVksQ0FBQyxRQUFRLEVBQUUsTUFBTSxRQUduQztJQUVNLDBCQUEwQixDQUFDLFVBQVUsRUFBRSxjQUFjLFFBSTNEO0lBRU0scUJBQXFCLENBQUMsSUFBSSxFQUFFO1FBQUUsUUFBUSxFQUFFLE1BQU0sQ0FBQztRQUFDLGFBQWEsRUFBRSxNQUFNLENBQUM7UUFBQyxLQUFLLEVBQUUsTUFBTSxDQUFBO0tBQUUsRUFBRSxRQVc5RjtJQUVNLG1CQUFtQixDQUFDLFdBQVcsRUFBRSxNQUFNLFFBRTdDO0lBRU0sMkJBQTJCLENBQUMsTUFBTSxFQUFFLE1BQU0sRUFBRSxTQUFTLEVBQUUsT0FBTyxRQUtwRTtJQUVEOztPQUVHO0lBQ0kseUJBQXlCLENBQUMsSUFBSSxFQUFFO1FBQ3JDLFVBQVUsRUFBRSxVQUFVLENBQUM7UUFDdkIsV0FBVyxFQUFFLE1BQU0sQ0FBQztRQUNwQixXQUFXLEVBQUUsSUFBSSxDQUFDLGlCQUFpQixFQUFFLGVBQWUsR0FBRyxjQUFjLENBQUMsQ0FBQztLQUN4RSxHQUFHLElBQUksQ0FJUDtDQUNGIn0=
55
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5zdHJ1bWVudGF0aW9uLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbW9kdWxlcy9pbnN0cnVtZW50YXRpb24udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsVUFBVSxFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFFbEUsT0FBTyxLQUFLLEVBQUUsT0FBTyxFQUFFLE1BQU0scUJBQXFCLENBQUM7QUFDbkQsT0FBTyxLQUFLLEVBQUUsY0FBYyxFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUFDL0QsT0FBTyxLQUFLLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUVyRSxPQUFPLEVBS0wsS0FBSyxpQkFBaUIsRUFFdEIsS0FBSyxlQUFlLEVBQ3BCLEtBQUssTUFBTSxFQUdaLE1BQU0seUJBQXlCLENBQUM7QUFFakMscUJBQWEsdUJBQXVCO0lBK0JoQyxPQUFPLENBQUMsU0FBUztJQTlCbkIsU0FBZ0IsTUFBTSxFQUFFLE1BQU0sQ0FBQztJQUUvQixPQUFPLENBQUMsV0FBVyxDQUFRO0lBQzNCLE9BQU8sQ0FBQyxnQkFBZ0IsQ0FBUTtJQUNoQyxPQUFPLENBQUMsT0FBTyxDQUFnQjtJQUMvQixPQUFPLENBQUMsYUFBYSxDQUFRO0lBQzdCLE9BQU8sQ0FBQyxvQkFBb0IsQ0FBWTtJQUN4QyxPQUFPLENBQUMsb0JBQW9CLENBQWdCO0lBQzVDLE9BQU8sQ0FBQyxTQUFTLENBQWM7SUFFL0IsT0FBTyxDQUFDLGFBQWEsQ0FBWTtJQUNqQyxPQUFPLENBQUMsVUFBVSxDQUFnQjtJQUVsQyxPQUFPLENBQUMsb0JBQW9CLENBQVk7SUFDeEMsT0FBTyxDQUFDLHlCQUF5QixDQUFZO0lBQzdDLE9BQU8sQ0FBQyxjQUFjLENBQWdCO0lBQ3RDLE9BQU8sQ0FBQyxZQUFZLENBQVk7SUFDaEMsT0FBTyxDQUFDLFdBQVcsQ0FBWTtJQUUvQixPQUFPLENBQUMsc0JBQXNCLENBQVk7SUFDMUMsT0FBTyxDQUFDLGdCQUFnQixDQUFnQjtJQUV4QyxPQUFPLENBQUMsMEJBQTBCLENBQWdCO0lBRWxELE9BQU8sQ0FBQywwQkFBMEIsQ0FBWTtJQUM5QyxPQUFPLENBQUMsdUJBQXVCLENBQWdCO0lBRS9DLE9BQU8sQ0FBQyxHQUFHLENBQTRDO0lBRXZELE9BQU8sZUEwRE47SUFFRCxPQUFvQixHQUFHLENBQUMsU0FBUyxFQUFFLGVBQWUsRUFBRSxTQUFTLENBQUMsRUFBRSxpQkFBaUIsb0NBTWhGO0lBRU0sU0FBUyxJQUFJLE9BQU8sQ0FFMUI7SUFFTSx1QkFBdUIsQ0FBQyxnQkFBZ0IsRUFBRSxNQUFNLEVBQUUsS0FBSyxFQUFFLE9BQU8sUUFTdEU7SUFFTSw0QkFBNEIsQ0FBQyxxQkFBcUIsRUFBRSxNQUFNLEVBQUUsTUFBTSxFQUFFLE9BQU8sRUFBRSxRQVNuRjtJQUVNLGtCQUFrQixDQUFDLEtBQUssRUFBRSxNQUFNLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxRQU1oRTtJQUVNLFlBQVksQ0FBQyxRQUFRLEVBQUUsTUFBTSxRQUduQztJQUVNLDBCQUEwQixDQUFDLFVBQVUsRUFBRSxjQUFjLFFBSTNEO0lBRU0scUJBQXFCLENBQUMsSUFBSSxFQUFFO1FBQUUsUUFBUSxFQUFFLE1BQU0sQ0FBQztRQUFDLGFBQWEsRUFBRSxNQUFNLENBQUM7UUFBQyxLQUFLLEVBQUUsTUFBTSxDQUFBO0tBQUUsRUFBRSxRQVc5RjtJQUVNLG1CQUFtQixDQUFDLFdBQVcsRUFBRSxNQUFNLFFBRTdDO0lBRU0sMkJBQTJCLENBQUMsTUFBTSxFQUFFLE1BQU0sRUFBRSxTQUFTLEVBQUUsT0FBTyxRQUtwRTtJQUVELHdFQUF3RTtJQUNqRSx5QkFBeUIsU0FFL0I7SUFFRDs7T0FFRztJQUNJLHlCQUF5QixDQUFDLElBQUksRUFBRTtRQUNyQyxVQUFVLEVBQUUsVUFBVSxDQUFDO1FBQ3ZCLFdBQVcsRUFBRSxNQUFNLENBQUM7UUFDcEIsV0FBVyxFQUFFLElBQUksQ0FBQyxpQkFBaUIsRUFBRSxlQUFlLEdBQUcsY0FBYyxDQUFDLENBQUM7S0FDeEUsR0FBRyxJQUFJLENBSVA7Q0FDRiJ9
@@ -1 +1 @@
1
- {"version":3,"file":"instrumentation.d.ts","sourceRoot":"","sources":["../../src/modules/instrumentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAElE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE,OAAO,EAKL,KAAK,iBAAiB,EAEtB,KAAK,eAAe,EACpB,KAAK,MAAM,EAGZ,MAAM,yBAAyB,CAAC;AAEjC,qBAAa,uBAAuB;IA6BhC,OAAO,CAAC,SAAS;IA5BnB,SAAgB,MAAM,EAAE,MAAM,CAAC;IAE/B,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,gBAAgB,CAAQ;IAChC,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,oBAAoB,CAAY;IACxC,OAAO,CAAC,oBAAoB,CAAgB;IAC5C,OAAO,CAAC,SAAS,CAAc;IAE/B,OAAO,CAAC,aAAa,CAAY;IACjC,OAAO,CAAC,UAAU,CAAgB;IAElC,OAAO,CAAC,oBAAoB,CAAY;IACxC,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,YAAY,CAAY;IAChC,OAAO,CAAC,WAAW,CAAY;IAE/B,OAAO,CAAC,sBAAsB,CAAY;IAC1C,OAAO,CAAC,gBAAgB,CAAgB;IAExC,OAAO,CAAC,0BAA0B,CAAgB;IAElD,OAAO,CAAC,0BAA0B,CAAY;IAE9C,OAAO,CAAC,GAAG,CAA4C;IAEvD,OAAO,eAsDN;IAED,OAAoB,GAAG,CAAC,SAAS,EAAE,eAAe,EAAE,SAAS,CAAC,EAAE,iBAAiB,oCAMhF;IAEM,SAAS,IAAI,OAAO,CAE1B;IAEM,gBAAgB,CAAC,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAWlE;IAEM,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,QAMhE;IAEM,YAAY,CAAC,QAAQ,EAAE,MAAM,QAGnC;IAEM,0BAA0B,CAAC,UAAU,EAAE,cAAc,QAI3D;IAEM,qBAAqB,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,QAW9F;IAEM,mBAAmB,CAAC,WAAW,EAAE,MAAM,QAE7C;IAEM,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,QAKpE;IAED;;OAEG;IACI,yBAAyB,CAAC,IAAI,EAAE;QACrC,UAAU,EAAE,UAAU,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,GAAG,cAAc,CAAC,CAAC;KACxE,GAAG,IAAI,CAIP;CACF"}
1
+ {"version":3,"file":"instrumentation.d.ts","sourceRoot":"","sources":["../../src/modules/instrumentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAElE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE,OAAO,EAKL,KAAK,iBAAiB,EAEtB,KAAK,eAAe,EACpB,KAAK,MAAM,EAGZ,MAAM,yBAAyB,CAAC;AAEjC,qBAAa,uBAAuB;IA+BhC,OAAO,CAAC,SAAS;IA9BnB,SAAgB,MAAM,EAAE,MAAM,CAAC;IAE/B,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,gBAAgB,CAAQ;IAChC,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,oBAAoB,CAAY;IACxC,OAAO,CAAC,oBAAoB,CAAgB;IAC5C,OAAO,CAAC,SAAS,CAAc;IAE/B,OAAO,CAAC,aAAa,CAAY;IACjC,OAAO,CAAC,UAAU,CAAgB;IAElC,OAAO,CAAC,oBAAoB,CAAY;IACxC,OAAO,CAAC,yBAAyB,CAAY;IAC7C,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,YAAY,CAAY;IAChC,OAAO,CAAC,WAAW,CAAY;IAE/B,OAAO,CAAC,sBAAsB,CAAY;IAC1C,OAAO,CAAC,gBAAgB,CAAgB;IAExC,OAAO,CAAC,0BAA0B,CAAgB;IAElD,OAAO,CAAC,0BAA0B,CAAY;IAC9C,OAAO,CAAC,uBAAuB,CAAgB;IAE/C,OAAO,CAAC,GAAG,CAA4C;IAEvD,OAAO,eA0DN;IAED,OAAoB,GAAG,CAAC,SAAS,EAAE,eAAe,EAAE,SAAS,CAAC,EAAE,iBAAiB,oCAMhF;IAEM,SAAS,IAAI,OAAO,CAE1B;IAEM,uBAAuB,CAAC,gBAAgB,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,QAStE;IAEM,4BAA4B,CAAC,qBAAqB,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QASnF;IAEM,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,QAMhE;IAEM,YAAY,CAAC,QAAQ,EAAE,MAAM,QAGnC;IAEM,0BAA0B,CAAC,UAAU,EAAE,cAAc,QAI3D;IAEM,qBAAqB,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,QAW9F;IAEM,mBAAmB,CAAC,WAAW,EAAE,MAAM,QAE7C;IAEM,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,QAKpE;IAED,wEAAwE;IACjE,yBAAyB,SAE/B;IAED;;OAEG;IACI,yBAAyB,CAAC,IAAI,EAAE;QACrC,UAAU,EAAE,UAAU,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,GAAG,cAAc,CAAC,CAAC;KACxE,GAAG,IAAI,CAIP;CACF"}
@@ -14,6 +14,7 @@ export class ArchiverInstrumentation {
14
14
  pruneDuration;
15
15
  pruneCount;
16
16
  syncDurationPerBlock;
17
+ syncDurationPerCheckpoint;
17
18
  syncBlockCount;
18
19
  manaPerBlock;
19
20
  txsPerBlock;
@@ -21,6 +22,7 @@ export class ArchiverInstrumentation {
21
22
  syncMessageCount;
22
23
  blockProposalTxTargetCount;
23
24
  checkpointL1InclusionDelay;
25
+ checkpointPromotedCount;
24
26
  log;
25
27
  constructor(telemetry, lmdbStats){
26
28
  this.telemetry = telemetry;
@@ -39,6 +41,7 @@ export class ArchiverInstrumentation {
39
41
  });
40
42
  this.proofsSubmittedDelay = meter.createHistogram(Metrics.ARCHIVER_ROLLUP_PROOF_DELAY);
41
43
  this.syncDurationPerBlock = meter.createHistogram(Metrics.ARCHIVER_SYNC_PER_BLOCK);
44
+ this.syncDurationPerCheckpoint = meter.createHistogram(Metrics.ARCHIVER_SYNC_PER_CHECKPOINT);
42
45
  this.syncBlockCount = createUpDownCounterWithDefault(meter, Metrics.ARCHIVER_SYNC_BLOCK_COUNT);
43
46
  this.manaPerBlock = meter.createHistogram(Metrics.ARCHIVER_MANA_PER_BLOCK);
44
47
  this.txsPerBlock = meter.createHistogram(Metrics.ARCHIVER_TXS_PER_BLOCK);
@@ -53,6 +56,7 @@ export class ArchiverInstrumentation {
53
56
  ]
54
57
  });
55
58
  this.checkpointL1InclusionDelay = meter.createHistogram(Metrics.ARCHIVER_CHECKPOINT_L1_INCLUSION_DELAY);
59
+ this.checkpointPromotedCount = createUpDownCounterWithDefault(meter, Metrics.ARCHIVER_CHECKPOINT_PROMOTED_COUNT);
56
60
  this.dbMetrics = new LmdbMetrics(meter, {
57
61
  [Attributes.DB_DATA_TYPE]: 'archiver'
58
62
  }, lmdbStats);
@@ -65,16 +69,27 @@ export class ArchiverInstrumentation {
65
69
  isEnabled() {
66
70
  return this.telemetry.isEnabled();
67
71
  }
68
- processNewBlocks(syncTimePerBlock, blocks) {
72
+ processNewProposedBlock(syncTimePerBlock, block) {
73
+ const attrs = {
74
+ [Attributes.STATUS]: 'proposed'
75
+ };
76
+ this.blockHeight.record(block.number, attrs);
69
77
  this.syncDurationPerBlock.record(Math.ceil(syncTimePerBlock));
70
- this.blockHeight.record(Math.max(...blocks.map((b)=>b.number)));
78
+ // Per block metrics
79
+ this.txCount.add(block.body.txEffects.length);
80
+ this.txsPerBlock.record(block.body.txEffects.length);
81
+ this.manaPerBlock.record(block.header.totalManaUsed.toNumber() / 1e6);
82
+ }
83
+ processNewCheckpointedBlocks(syncTimePerCheckpoint, blocks) {
84
+ if (blocks.length === 0) {
85
+ return;
86
+ }
87
+ this.syncDurationPerCheckpoint.record(Math.ceil(syncTimePerCheckpoint));
88
+ this.blockHeight.record(Math.max(...blocks.map((b)=>b.number)), {
89
+ [Attributes.STATUS]: 'checkpointed'
90
+ });
71
91
  this.checkpointHeight.record(Math.max(...blocks.map((b)=>b.checkpointNumber)));
72
92
  this.syncBlockCount.add(blocks.length);
73
- for (const block of blocks){
74
- this.txCount.add(block.body.txEffects.length);
75
- this.txsPerBlock.record(block.body.txEffects.length);
76
- this.manaPerBlock.record(block.header.totalManaUsed.toNumber() / 1e6);
77
- }
78
93
  }
79
94
  processNewMessages(count, syncPerMessageMs) {
80
95
  if (count === 0) {
@@ -117,6 +132,9 @@ export class ArchiverInstrumentation {
117
132
  [Attributes.L1_BLOCK_PROPOSAL_USED_TRACE]: usedTrace
118
133
  });
119
134
  }
135
+ /** Records a checkpoint promoted from proposed (blob fetch skipped). */ processCheckpointPromoted() {
136
+ this.checkpointPromotedCount.add(1);
137
+ }
120
138
  /**
121
139
  * Records L1 inclusion timing for a checkpoint observed on L1 (seconds into the L2 slot).
122
140
  */ processCheckpointL1Timing(data) {