@aztec/archiver 0.0.1-commit.d3ec352c → 0.0.1-commit.f295ac2

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 (201) hide show
  1. package/README.md +147 -22
  2. package/dest/archiver.d.ts +135 -0
  3. package/dest/archiver.d.ts.map +1 -0
  4. package/dest/archiver.js +769 -0
  5. package/dest/config.d.ts +30 -0
  6. package/dest/config.d.ts.map +1 -0
  7. package/dest/{archiver/config.js → config.js} +21 -5
  8. package/dest/errors.d.ts +36 -0
  9. package/dest/errors.d.ts.map +1 -0
  10. package/dest/errors.js +54 -0
  11. package/dest/factory.d.ts +5 -6
  12. package/dest/factory.d.ts.map +1 -1
  13. package/dest/factory.js +82 -5
  14. package/dest/index.d.ts +10 -4
  15. package/dest/index.d.ts.map +1 -1
  16. package/dest/index.js +8 -3
  17. package/dest/interfaces.d.ts +9 -0
  18. package/dest/interfaces.d.ts.map +1 -0
  19. package/dest/interfaces.js +3 -0
  20. package/dest/l1/bin/retrieve-calldata.d.ts +3 -0
  21. package/dest/l1/bin/retrieve-calldata.d.ts.map +1 -0
  22. package/dest/l1/bin/retrieve-calldata.js +149 -0
  23. package/dest/l1/calldata_retriever.d.ts +112 -0
  24. package/dest/l1/calldata_retriever.d.ts.map +1 -0
  25. package/dest/l1/calldata_retriever.js +471 -0
  26. package/dest/l1/data_retrieval.d.ts +88 -0
  27. package/dest/l1/data_retrieval.d.ts.map +1 -0
  28. package/dest/{archiver → l1}/data_retrieval.js +75 -150
  29. package/dest/l1/debug_tx.d.ts +19 -0
  30. package/dest/l1/debug_tx.d.ts.map +1 -0
  31. package/dest/l1/debug_tx.js +73 -0
  32. package/dest/l1/spire_proposer.d.ts +70 -0
  33. package/dest/l1/spire_proposer.d.ts.map +1 -0
  34. package/dest/l1/spire_proposer.js +157 -0
  35. package/dest/l1/trace_tx.d.ts +97 -0
  36. package/dest/l1/trace_tx.d.ts.map +1 -0
  37. package/dest/l1/trace_tx.js +91 -0
  38. package/dest/l1/types.d.ts +12 -0
  39. package/dest/l1/types.d.ts.map +1 -0
  40. package/dest/l1/types.js +3 -0
  41. package/dest/l1/validate_trace.d.ts +29 -0
  42. package/dest/l1/validate_trace.d.ts.map +1 -0
  43. package/dest/l1/validate_trace.js +150 -0
  44. package/dest/modules/data_source_base.d.ts +85 -0
  45. package/dest/modules/data_source_base.d.ts.map +1 -0
  46. package/dest/modules/data_source_base.js +291 -0
  47. package/dest/modules/data_store_updater.d.ts +69 -0
  48. package/dest/modules/data_store_updater.d.ts.map +1 -0
  49. package/dest/modules/data_store_updater.js +304 -0
  50. package/dest/modules/instrumentation.d.ts +37 -0
  51. package/dest/modules/instrumentation.d.ts.map +1 -0
  52. package/dest/{archiver → modules}/instrumentation.js +22 -59
  53. package/dest/modules/l1_synchronizer.d.ts +75 -0
  54. package/dest/modules/l1_synchronizer.d.ts.map +1 -0
  55. package/dest/modules/l1_synchronizer.js +1113 -0
  56. package/dest/modules/validation.d.ts +17 -0
  57. package/dest/modules/validation.d.ts.map +1 -0
  58. package/dest/{archiver → modules}/validation.js +7 -1
  59. package/dest/store/block_store.d.ts +178 -0
  60. package/dest/store/block_store.d.ts.map +1 -0
  61. package/dest/store/block_store.js +680 -0
  62. package/dest/store/contract_class_store.d.ts +18 -0
  63. package/dest/store/contract_class_store.d.ts.map +1 -0
  64. package/dest/{archiver/kv_archiver_store → store}/contract_class_store.js +2 -2
  65. package/dest/store/contract_instance_store.d.ts +24 -0
  66. package/dest/store/contract_instance_store.d.ts.map +1 -0
  67. package/dest/{archiver/kv_archiver_store → store}/contract_instance_store.js +1 -1
  68. package/dest/store/kv_archiver_store.d.ts +331 -0
  69. package/dest/store/kv_archiver_store.d.ts.map +1 -0
  70. package/dest/store/kv_archiver_store.js +438 -0
  71. package/dest/store/log_store.d.ts +45 -0
  72. package/dest/store/log_store.d.ts.map +1 -0
  73. package/dest/store/log_store.js +422 -0
  74. package/dest/store/message_store.d.ts +40 -0
  75. package/dest/store/message_store.d.ts.map +1 -0
  76. package/dest/{archiver/kv_archiver_store → store}/message_store.js +15 -14
  77. package/dest/{archiver/structs → structs}/data_retrieval.d.ts +1 -1
  78. package/dest/structs/data_retrieval.d.ts.map +1 -0
  79. package/dest/structs/inbox_message.d.ts +15 -0
  80. package/dest/structs/inbox_message.d.ts.map +1 -0
  81. package/dest/{archiver/structs → structs}/inbox_message.js +6 -6
  82. package/dest/structs/published.d.ts +2 -0
  83. package/dest/structs/published.d.ts.map +1 -0
  84. package/dest/test/fake_l1_state.d.ts +190 -0
  85. package/dest/test/fake_l1_state.d.ts.map +1 -0
  86. package/dest/test/fake_l1_state.js +383 -0
  87. package/dest/test/index.d.ts +2 -1
  88. package/dest/test/index.d.ts.map +1 -1
  89. package/dest/test/index.js +1 -0
  90. package/dest/test/mock_archiver.d.ts +5 -6
  91. package/dest/test/mock_archiver.d.ts.map +1 -1
  92. package/dest/test/mock_archiver.js +6 -11
  93. package/dest/test/mock_l1_to_l2_message_source.d.ts +6 -7
  94. package/dest/test/mock_l1_to_l2_message_source.d.ts.map +1 -1
  95. package/dest/test/mock_l1_to_l2_message_source.js +19 -14
  96. package/dest/test/mock_l2_block_source.d.ts +28 -14
  97. package/dest/test/mock_l2_block_source.d.ts.map +1 -1
  98. package/dest/test/mock_l2_block_source.js +160 -52
  99. package/dest/test/mock_structs.d.ts +78 -3
  100. package/dest/test/mock_structs.d.ts.map +1 -1
  101. package/dest/test/mock_structs.js +141 -10
  102. package/package.json +17 -18
  103. package/src/archiver.ts +525 -0
  104. package/src/{archiver/config.ts → config.ts} +28 -12
  105. package/src/errors.ts +90 -0
  106. package/src/factory.ts +118 -6
  107. package/src/index.ts +10 -3
  108. package/src/interfaces.ts +9 -0
  109. package/src/l1/README.md +98 -0
  110. package/src/l1/bin/retrieve-calldata.ts +182 -0
  111. package/src/l1/calldata_retriever.ts +641 -0
  112. package/src/{archiver → l1}/data_retrieval.ts +136 -218
  113. package/src/l1/debug_tx.ts +99 -0
  114. package/src/l1/spire_proposer.ts +160 -0
  115. package/src/l1/trace_tx.ts +128 -0
  116. package/src/l1/types.ts +13 -0
  117. package/src/l1/validate_trace.ts +211 -0
  118. package/src/modules/data_source_base.ts +414 -0
  119. package/src/modules/data_store_updater.ts +419 -0
  120. package/src/{archiver → modules}/instrumentation.ts +24 -59
  121. package/src/modules/l1_synchronizer.ts +931 -0
  122. package/src/{archiver → modules}/validation.ts +11 -6
  123. package/src/store/block_store.ts +919 -0
  124. package/src/{archiver/kv_archiver_store → store}/contract_class_store.ts +2 -2
  125. package/src/{archiver/kv_archiver_store → store}/contract_instance_store.ts +2 -2
  126. package/src/store/kv_archiver_store.ts +622 -0
  127. package/src/store/log_store.ts +552 -0
  128. package/src/{archiver/kv_archiver_store → store}/message_store.ts +21 -18
  129. package/src/{archiver/structs → structs}/inbox_message.ts +7 -8
  130. package/src/{archiver/structs → structs}/published.ts +0 -1
  131. package/src/test/fake_l1_state.ts +599 -0
  132. package/src/test/fixtures/debug_traceTransaction-multicall3.json +88 -0
  133. package/src/test/fixtures/debug_traceTransaction-multiplePropose.json +153 -0
  134. package/src/test/fixtures/debug_traceTransaction-proxied.json +122 -0
  135. package/src/test/fixtures/trace_transaction-multicall3.json +65 -0
  136. package/src/test/fixtures/trace_transaction-multiplePropose.json +319 -0
  137. package/src/test/fixtures/trace_transaction-proxied.json +128 -0
  138. package/src/test/fixtures/trace_transaction-randomRevert.json +216 -0
  139. package/src/test/index.ts +1 -0
  140. package/src/test/mock_archiver.ts +8 -13
  141. package/src/test/mock_l1_to_l2_message_source.ts +16 -15
  142. package/src/test/mock_l2_block_source.ts +184 -64
  143. package/src/test/mock_structs.ts +256 -11
  144. package/dest/archiver/archiver.d.ts +0 -290
  145. package/dest/archiver/archiver.d.ts.map +0 -1
  146. package/dest/archiver/archiver.js +0 -1434
  147. package/dest/archiver/archiver_store.d.ts +0 -256
  148. package/dest/archiver/archiver_store.d.ts.map +0 -1
  149. package/dest/archiver/archiver_store.js +0 -4
  150. package/dest/archiver/archiver_store_test_suite.d.ts +0 -8
  151. package/dest/archiver/archiver_store_test_suite.d.ts.map +0 -1
  152. package/dest/archiver/archiver_store_test_suite.js +0 -1289
  153. package/dest/archiver/config.d.ts +0 -21
  154. package/dest/archiver/config.d.ts.map +0 -1
  155. package/dest/archiver/data_retrieval.d.ts +0 -80
  156. package/dest/archiver/data_retrieval.d.ts.map +0 -1
  157. package/dest/archiver/errors.d.ts +0 -12
  158. package/dest/archiver/errors.d.ts.map +0 -1
  159. package/dest/archiver/errors.js +0 -17
  160. package/dest/archiver/index.d.ts +0 -7
  161. package/dest/archiver/index.d.ts.map +0 -1
  162. package/dest/archiver/index.js +0 -4
  163. package/dest/archiver/instrumentation.d.ts +0 -35
  164. package/dest/archiver/instrumentation.d.ts.map +0 -1
  165. package/dest/archiver/kv_archiver_store/block_store.d.ts +0 -125
  166. package/dest/archiver/kv_archiver_store/block_store.d.ts.map +0 -1
  167. package/dest/archiver/kv_archiver_store/block_store.js +0 -371
  168. package/dest/archiver/kv_archiver_store/contract_class_store.d.ts +0 -18
  169. package/dest/archiver/kv_archiver_store/contract_class_store.d.ts.map +0 -1
  170. package/dest/archiver/kv_archiver_store/contract_instance_store.d.ts +0 -24
  171. package/dest/archiver/kv_archiver_store/contract_instance_store.d.ts.map +0 -1
  172. package/dest/archiver/kv_archiver_store/kv_archiver_store.d.ts +0 -169
  173. package/dest/archiver/kv_archiver_store/kv_archiver_store.d.ts.map +0 -1
  174. package/dest/archiver/kv_archiver_store/kv_archiver_store.js +0 -296
  175. package/dest/archiver/kv_archiver_store/log_store.d.ts +0 -49
  176. package/dest/archiver/kv_archiver_store/log_store.d.ts.map +0 -1
  177. package/dest/archiver/kv_archiver_store/log_store.js +0 -337
  178. package/dest/archiver/kv_archiver_store/message_store.d.ts +0 -39
  179. package/dest/archiver/kv_archiver_store/message_store.d.ts.map +0 -1
  180. package/dest/archiver/structs/data_retrieval.d.ts.map +0 -1
  181. package/dest/archiver/structs/inbox_message.d.ts +0 -15
  182. package/dest/archiver/structs/inbox_message.d.ts.map +0 -1
  183. package/dest/archiver/structs/published.d.ts +0 -3
  184. package/dest/archiver/structs/published.d.ts.map +0 -1
  185. package/dest/archiver/validation.d.ts +0 -17
  186. package/dest/archiver/validation.d.ts.map +0 -1
  187. package/dest/rpc/index.d.ts +0 -9
  188. package/dest/rpc/index.d.ts.map +0 -1
  189. package/dest/rpc/index.js +0 -15
  190. package/src/archiver/archiver.ts +0 -1880
  191. package/src/archiver/archiver_store.ts +0 -310
  192. package/src/archiver/archiver_store_test_suite.ts +0 -1295
  193. package/src/archiver/errors.ts +0 -26
  194. package/src/archiver/index.ts +0 -6
  195. package/src/archiver/kv_archiver_store/block_store.ts +0 -482
  196. package/src/archiver/kv_archiver_store/kv_archiver_store.ts +0 -423
  197. package/src/archiver/kv_archiver_store/log_store.ts +0 -407
  198. package/src/rpc/index.ts +0 -16
  199. /package/dest/{archiver/structs → structs}/data_retrieval.js +0 -0
  200. /package/dest/{archiver/structs → structs}/published.js +0 -0
  201. /package/src/{archiver/structs → structs}/data_retrieval.ts +0 -0
@@ -0,0 +1,304 @@
1
+ import { BlockNumber } from '@aztec/foundation/branded-types';
2
+ import { Fr } from '@aztec/foundation/curves/bn254';
3
+ import { createLogger } from '@aztec/foundation/log';
4
+ import { ContractClassPublishedEvent, PrivateFunctionBroadcastedEvent, UtilityFunctionBroadcastedEvent } from '@aztec/protocol-contracts/class-registry';
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';
8
+ /** Operation type for contract data updates. */ var Operation = /*#__PURE__*/ function(Operation) {
9
+ Operation[Operation["Store"] = 0] = "Store";
10
+ Operation[Operation["Delete"] = 1] = "Delete";
11
+ return Operation;
12
+ }(Operation || {});
13
+ /** Archiver helper module to handle updates to the data store. */ export class ArchiverDataStoreUpdater {
14
+ store;
15
+ log;
16
+ constructor(store){
17
+ this.store = store;
18
+ this.log = createLogger('archiver:store_updater');
19
+ }
20
+ /**
21
+ * Adds blocks to the store with contract class/instance extraction from logs.
22
+ * Extracts ContractClassPublished, ContractInstancePublished, ContractInstanceUpdated events,
23
+ * and individually broadcasted functions from the block logs.
24
+ *
25
+ * @param blocks - The L2 blocks to add.
26
+ * @param pendingChainValidationStatus - Optional validation status to set.
27
+ * @returns True if the operation is successful.
28
+ */ addBlocks(blocks, pendingChainValidationStatus) {
29
+ return this.store.transactionAsync(async ()=>{
30
+ await this.store.addBlocks(blocks);
31
+ const opResults = await Promise.all([
32
+ // Update the pending chain validation status if provided
33
+ pendingChainValidationStatus && this.store.setPendingChainValidationStatus(pendingChainValidationStatus),
34
+ // Add any logs emitted during the retrieved blocks
35
+ this.store.addLogs(blocks),
36
+ // Unroll all logs emitted during the retrieved blocks and extract any contract classes and instances from them
37
+ ...blocks.map((block)=>this.addBlockDataToDB(block))
38
+ ]);
39
+ return opResults.every(Boolean);
40
+ });
41
+ }
42
+ /**
43
+ * Reconciles local blocks with incoming checkpoints from L1.
44
+ * Adds checkpoints to the store with contract class/instance extraction from logs.
45
+ * Prunes any local blocks that conflict with checkpoint data (by comparing archive roots).
46
+ * Extracts ContractClassPublished, ContractInstancePublished, ContractInstanceUpdated events,
47
+ * and individually broadcasted functions from the checkpoint block logs.
48
+ *
49
+ * @param checkpoints - The published checkpoints to add.
50
+ * @param pendingChainValidationStatus - Optional validation status to set.
51
+ * @returns Result with information about any pruned blocks.
52
+ */ setNewCheckpointData(checkpoints, pendingChainValidationStatus) {
53
+ return this.store.transactionAsync(async ()=>{
54
+ // Before adding checkpoints, check for conflicts with local blocks if any
55
+ const { prunedBlocks, lastAlreadyInsertedBlockNumber } = await this.pruneMismatchingLocalBlocks(checkpoints);
56
+ await this.store.addCheckpoints(checkpoints);
57
+ // Filter out blocks that were already inserted via addBlocks() to avoid duplicating logs/contract data
58
+ const newBlocks = checkpoints.flatMap((ch)=>ch.checkpoint.blocks).filter((b)=>lastAlreadyInsertedBlockNumber === undefined || b.number > lastAlreadyInsertedBlockNumber);
59
+ await Promise.all([
60
+ // Update the pending chain validation status if provided
61
+ pendingChainValidationStatus && this.store.setPendingChainValidationStatus(pendingChainValidationStatus),
62
+ // Add any logs emitted during the retrieved blocks
63
+ this.store.addLogs(newBlocks),
64
+ // Unroll all logs emitted during the retrieved blocks and extract any contract classes and instances from them
65
+ ...newBlocks.map((block)=>this.addBlockDataToDB(block))
66
+ ]);
67
+ return {
68
+ prunedBlocks,
69
+ lastAlreadyInsertedBlockNumber
70
+ };
71
+ });
72
+ }
73
+ /**
74
+ * Checks for local proposed blocks that do not match the ones to be checkpointed and prunes them.
75
+ * This method handles multiple checkpoints but returns after pruning the first conflict found.
76
+ * This is correct because pruning from the first conflict point removes all subsequent blocks,
77
+ * and when checkpoints are added afterward, they include all the correct blocks.
78
+ */ async pruneMismatchingLocalBlocks(checkpoints) {
79
+ const [lastCheckpointedBlockNumber, lastBlockNumber] = await Promise.all([
80
+ this.store.getCheckpointedL2BlockNumber(),
81
+ this.store.getLatestBlockNumber()
82
+ ]);
83
+ // Exit early if there are no local uncheckpointed blocks
84
+ if (lastBlockNumber === lastCheckpointedBlockNumber) {
85
+ return {
86
+ prunedBlocks: undefined,
87
+ lastAlreadyInsertedBlockNumber: undefined
88
+ };
89
+ }
90
+ // Get all uncheckpointed local blocks
91
+ const uncheckpointedLocalBlocks = await this.store.getBlocks(BlockNumber.add(lastCheckpointedBlockNumber, 1), lastBlockNumber - lastCheckpointedBlockNumber);
92
+ let lastAlreadyInsertedBlockNumber;
93
+ for (const publishedCheckpoint of checkpoints){
94
+ const checkpointBlocks = publishedCheckpoint.checkpoint.blocks;
95
+ const slot = publishedCheckpoint.checkpoint.slot;
96
+ const localBlocksInSlot = uncheckpointedLocalBlocks.filter((b)=>b.slot === slot);
97
+ if (checkpointBlocks.length === 0) {
98
+ this.log.warn(`Checkpoint ${publishedCheckpoint.checkpoint.number} for slot ${slot} has no blocks`);
99
+ continue;
100
+ }
101
+ // Find the first checkpoint block that conflicts with an existing local block and prune local afterwards
102
+ for (const checkpointBlock of checkpointBlocks){
103
+ const blockNumber = checkpointBlock.number;
104
+ const existingBlock = localBlocksInSlot.find((b)=>b.number === blockNumber);
105
+ const blockInfos = {
106
+ existingBlock: existingBlock?.toBlockInfo(),
107
+ checkpointBlock: checkpointBlock.toBlockInfo()
108
+ };
109
+ if (!existingBlock) {
110
+ this.log.verbose(`No local block found for checkpointed block number ${blockNumber}`, blockInfos);
111
+ } else if (existingBlock.archive.root.equals(checkpointBlock.archive.root)) {
112
+ this.log.verbose(`Block number ${blockNumber} already inserted and matches checkpoint`, blockInfos);
113
+ lastAlreadyInsertedBlockNumber = blockNumber;
114
+ } else {
115
+ this.log.warn(`Conflict detected at block ${blockNumber} between checkpointed and local block`, blockInfos);
116
+ const prunedBlocks = await this.removeBlocksAfter(BlockNumber(blockNumber - 1));
117
+ return {
118
+ prunedBlocks,
119
+ lastAlreadyInsertedBlockNumber
120
+ };
121
+ }
122
+ }
123
+ // If local has more blocks than the checkpoint (e.g., local has [2,3,4] but checkpoint has [2,3]),
124
+ // we need to prune the extra local blocks so they match what was checkpointed
125
+ const lastCheckpointBlockNumber = checkpointBlocks.at(-1).number;
126
+ const lastLocalBlockNumber = localBlocksInSlot.at(-1)?.number;
127
+ if (lastLocalBlockNumber !== undefined && lastLocalBlockNumber > lastCheckpointBlockNumber) {
128
+ this.log.warn(`Local chain for slot ${slot} ends at block ${lastLocalBlockNumber} but checkpoint ends at ${lastCheckpointBlockNumber}. Pruning blocks after block ${lastCheckpointBlockNumber}.`);
129
+ const prunedBlocks = await this.removeBlocksAfter(lastCheckpointBlockNumber);
130
+ return {
131
+ prunedBlocks,
132
+ lastAlreadyInsertedBlockNumber
133
+ };
134
+ }
135
+ }
136
+ return {
137
+ prunedBlocks: undefined,
138
+ lastAlreadyInsertedBlockNumber
139
+ };
140
+ }
141
+ /**
142
+ * Removes all blocks strictly after the specified block number and cleans up associated contract data.
143
+ * This handles removal of provisionally added blocks along with their contract classes/instances.
144
+ *
145
+ * @param blockNumber - Remove all blocks with number greater than this.
146
+ * @returns The removed blocks.
147
+ */ removeBlocksAfter(blockNumber) {
148
+ return this.store.transactionAsync(async ()=>{
149
+ // First get the blocks to be removed so we can clean up contract data
150
+ const removedBlocks = await this.store.removeBlocksAfter(blockNumber);
151
+ // Clean up contract data and logs for the removed blocks
152
+ await Promise.all([
153
+ this.store.deleteLogs(removedBlocks),
154
+ ...removedBlocks.map((block)=>this.removeBlockDataFromDB(block))
155
+ ]);
156
+ return removedBlocks;
157
+ });
158
+ }
159
+ /**
160
+ * Unwinds checkpoints from the store with reverse contract extraction.
161
+ * Deletes ContractClassPublished, ContractInstancePublished, ContractInstanceUpdated data
162
+ * that was stored for the unwound checkpoints.
163
+ *
164
+ * @param from - The checkpoint number to unwind from (must be the current tip).
165
+ * @param checkpointsToUnwind - The number of checkpoints to unwind.
166
+ * @returns True if the operation is successful.
167
+ */ async unwindCheckpoints(from, checkpointsToUnwind) {
168
+ if (checkpointsToUnwind <= 0) {
169
+ throw new Error(`Cannot unwind ${checkpointsToUnwind} blocks`);
170
+ }
171
+ const last = await this.store.getSynchedCheckpointNumber();
172
+ if (from != last) {
173
+ throw new Error(`Cannot unwind checkpoints from checkpoint ${from} when the last checkpoint is ${last}`);
174
+ }
175
+ const blocks = [];
176
+ const lastCheckpointNumber = from + checkpointsToUnwind - 1;
177
+ for(let checkpointNumber = from; checkpointNumber <= lastCheckpointNumber; checkpointNumber++){
178
+ const blocksForCheckpoint = await this.store.getBlocksForCheckpoint(checkpointNumber);
179
+ if (!blocksForCheckpoint) {
180
+ continue;
181
+ }
182
+ blocks.push(...blocksForCheckpoint);
183
+ }
184
+ const opResults = await Promise.all([
185
+ // Prune rolls back to the last proven block, which is by definition valid
186
+ this.store.setPendingChainValidationStatus({
187
+ valid: true
188
+ }),
189
+ // Remove contract data for all blocks being unwound
190
+ ...blocks.map((block)=>this.removeBlockDataFromDB(block)),
191
+ this.store.deleteLogs(blocks),
192
+ this.store.unwindCheckpoints(from, checkpointsToUnwind)
193
+ ]);
194
+ return opResults.every(Boolean);
195
+ }
196
+ /** Extracts and stores contract data from a single block. */ addBlockDataToDB(block) {
197
+ return this.editContractBlockData(block, 0);
198
+ }
199
+ /** Removes contract data associated with a block. */ removeBlockDataFromDB(block) {
200
+ return this.editContractBlockData(block, 1);
201
+ }
202
+ /** Adds or remove contract data associated with a block. */ async editContractBlockData(block, operation) {
203
+ const contractClassLogs = block.body.txEffects.flatMap((txEffect)=>txEffect.contractClassLogs);
204
+ const privateLogs = block.body.txEffects.flatMap((txEffect)=>txEffect.privateLogs);
205
+ const publicLogs = block.body.txEffects.flatMap((txEffect)=>txEffect.publicLogs);
206
+ return (await Promise.all([
207
+ this.updatePublishedContractClasses(contractClassLogs, block.number, operation),
208
+ this.updateDeployedContractInstances(privateLogs, block.number, operation),
209
+ this.updateUpdatedContractInstances(publicLogs, block.header.globalVariables.timestamp, operation),
210
+ operation === 0 ? this.storeBroadcastedIndividualFunctions(contractClassLogs, block.number) : Promise.resolve(true)
211
+ ])).every(Boolean);
212
+ }
213
+ /**
214
+ * Extracts and stores contract classes out of ContractClassPublished events emitted by the class registry contract.
215
+ */ async updatePublishedContractClasses(allLogs, blockNum, operation) {
216
+ const contractClassPublishedEvents = allLogs.filter((log)=>ContractClassPublishedEvent.isContractClassPublishedEvent(log)).map((log)=>ContractClassPublishedEvent.fromLog(log));
217
+ const contractClasses = await Promise.all(contractClassPublishedEvents.map((e)=>e.toContractClassPublic()));
218
+ if (contractClasses.length > 0) {
219
+ contractClasses.forEach((c)=>this.log.verbose(`${Operation[operation]} contract class ${c.id.toString()}`));
220
+ if (operation == 0) {
221
+ // TODO: Will probably want to create some worker threads to compute these bytecode commitments as they are expensive
222
+ const commitments = await Promise.all(contractClasses.map((c)=>computePublicBytecodeCommitment(c.packedBytecode)));
223
+ return await this.store.addContractClasses(contractClasses, commitments, blockNum);
224
+ } else if (operation == 1) {
225
+ return await this.store.deleteContractClasses(contractClasses, blockNum);
226
+ }
227
+ }
228
+ return true;
229
+ }
230
+ /**
231
+ * Extracts and stores contract instances out of ContractInstancePublished events emitted by the canonical deployer contract.
232
+ */ async updateDeployedContractInstances(allLogs, blockNum, operation) {
233
+ const contractInstances = allLogs.filter((log)=>ContractInstancePublishedEvent.isContractInstancePublishedEvent(log)).map((log)=>ContractInstancePublishedEvent.fromLog(log)).map((e)=>e.toContractInstance());
234
+ if (contractInstances.length > 0) {
235
+ contractInstances.forEach((c)=>this.log.verbose(`${Operation[operation]} contract instance at ${c.address.toString()}`));
236
+ if (operation == 0) {
237
+ return await this.store.addContractInstances(contractInstances, blockNum);
238
+ } else if (operation == 1) {
239
+ return await this.store.deleteContractInstances(contractInstances, blockNum);
240
+ }
241
+ }
242
+ return true;
243
+ }
244
+ /**
245
+ * Extracts and stores contract instance updates out of ContractInstanceUpdated events.
246
+ */ async updateUpdatedContractInstances(allLogs, timestamp, operation) {
247
+ const contractUpdates = allLogs.filter((log)=>ContractInstanceUpdatedEvent.isContractInstanceUpdatedEvent(log)).map((log)=>ContractInstanceUpdatedEvent.fromLog(log)).map((e)=>e.toContractInstanceUpdate());
248
+ if (contractUpdates.length > 0) {
249
+ contractUpdates.forEach((c)=>this.log.verbose(`${Operation[operation]} contract instance update at ${c.address.toString()}`));
250
+ if (operation == 0) {
251
+ return await this.store.addContractInstanceUpdates(contractUpdates, timestamp);
252
+ } else if (operation == 1) {
253
+ return await this.store.deleteContractInstanceUpdates(contractUpdates, timestamp);
254
+ }
255
+ }
256
+ return true;
257
+ }
258
+ /**
259
+ * Stores the functions that were broadcasted individually.
260
+ *
261
+ * @dev Beware that there is not a delete variant of this, since they are added to contract classes
262
+ * and will be deleted as part of the class if needed.
263
+ */ async storeBroadcastedIndividualFunctions(allLogs, _blockNum) {
264
+ // Filter out private and utility function broadcast events
265
+ const privateFnEvents = allLogs.filter((log)=>PrivateFunctionBroadcastedEvent.isPrivateFunctionBroadcastedEvent(log)).map((log)=>PrivateFunctionBroadcastedEvent.fromLog(log));
266
+ const utilityFnEvents = allLogs.filter((log)=>UtilityFunctionBroadcastedEvent.isUtilityFunctionBroadcastedEvent(log)).map((log)=>UtilityFunctionBroadcastedEvent.fromLog(log));
267
+ // Group all events by contract class id
268
+ for (const [classIdString, classEvents] of Object.entries(groupBy([
269
+ ...privateFnEvents,
270
+ ...utilityFnEvents
271
+ ], (e)=>e.contractClassId.toString()))){
272
+ const contractClassId = Fr.fromHexString(classIdString);
273
+ const contractClass = await this.store.getContractClass(contractClassId);
274
+ if (!contractClass) {
275
+ this.log.warn(`Skipping broadcasted functions as contract class ${contractClassId.toString()} was not found`);
276
+ continue;
277
+ }
278
+ // Split private and utility functions, and filter out invalid ones
279
+ const allFns = classEvents.map((e)=>e.toFunctionWithMembershipProof());
280
+ const privateFns = allFns.filter((fn)=>'utilityFunctionsTreeRoot' in fn);
281
+ const utilityFns = allFns.filter((fn)=>'privateFunctionsArtifactTreeRoot' in fn);
282
+ const privateFunctionsWithValidity = await Promise.all(privateFns.map(async (fn)=>({
283
+ fn,
284
+ valid: await isValidPrivateFunctionMembershipProof(fn, contractClass)
285
+ })));
286
+ const validPrivateFns = privateFunctionsWithValidity.filter(({ valid })=>valid).map(({ fn })=>fn);
287
+ const utilityFunctionsWithValidity = await Promise.all(utilityFns.map(async (fn)=>({
288
+ fn,
289
+ valid: await isValidUtilityFunctionMembershipProof(fn, contractClass)
290
+ })));
291
+ const validUtilityFns = utilityFunctionsWithValidity.filter(({ valid })=>valid).map(({ fn })=>fn);
292
+ const validFnCount = validPrivateFns.length + validUtilityFns.length;
293
+ if (validFnCount !== allFns.length) {
294
+ this.log.warn(`Skipping ${allFns.length - validFnCount} invalid functions`);
295
+ }
296
+ // Store the functions in the contract class in a single operation
297
+ if (validFnCount > 0) {
298
+ this.log.verbose(`Storing ${validFnCount} functions for contract class ${contractClassId.toString()}`);
299
+ }
300
+ return await this.store.addFunctions(contractClassId, validPrivateFns, validUtilityFns);
301
+ }
302
+ return true;
303
+ }
304
+ }
@@ -0,0 +1,37 @@
1
+ import type { L2BlockNew } from '@aztec/stdlib/block';
2
+ import { type LmdbStatsCallback, type TelemetryClient, type Tracer } from '@aztec/telemetry-client';
3
+ export declare class ArchiverInstrumentation {
4
+ private telemetry;
5
+ readonly tracer: Tracer;
6
+ private blockHeight;
7
+ private txCount;
8
+ private l1BlockHeight;
9
+ private proofsSubmittedDelay;
10
+ private proofsSubmittedCount;
11
+ private dbMetrics;
12
+ private pruneDuration;
13
+ private pruneCount;
14
+ private syncDurationPerBlock;
15
+ private syncBlockCount;
16
+ private manaPerBlock;
17
+ private txsPerBlock;
18
+ private syncDurationPerMessage;
19
+ private syncMessageCount;
20
+ private blockProposalTxTargetCount;
21
+ private log;
22
+ private constructor();
23
+ static new(telemetry: TelemetryClient, lmdbStats?: LmdbStatsCallback): Promise<ArchiverInstrumentation>;
24
+ isEnabled(): boolean;
25
+ processNewBlocks(syncTimePerBlock: number, blocks: L2BlockNew[]): void;
26
+ processNewMessages(count: number, syncPerMessageMs: number): void;
27
+ processPrune(duration: number): void;
28
+ updateLastProvenBlock(blockNumber: number): void;
29
+ processProofsVerified(logs: {
30
+ proverId: string;
31
+ l2BlockNumber: bigint;
32
+ delay: bigint;
33
+ }[]): void;
34
+ updateL1BlockHeight(blockNumber: bigint): void;
35
+ recordBlockProposalTxTarget(target: string, usedTrace: boolean): void;
36
+ }
37
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5zdHJ1bWVudGF0aW9uLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbW9kdWxlcy9pbnN0cnVtZW50YXRpb24udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxLQUFLLEVBQUUsVUFBVSxFQUFFLE1BQU0scUJBQXFCLENBQUM7QUFDdEQsT0FBTyxFQUtMLEtBQUssaUJBQWlCLEVBRXRCLEtBQUssZUFBZSxFQUNwQixLQUFLLE1BQU0sRUFFWixNQUFNLHlCQUF5QixDQUFDO0FBRWpDLHFCQUFhLHVCQUF1QjtJQTBCaEMsT0FBTyxDQUFDLFNBQVM7SUF6Qm5CLFNBQWdCLE1BQU0sRUFBRSxNQUFNLENBQUM7SUFFL0IsT0FBTyxDQUFDLFdBQVcsQ0FBUTtJQUMzQixPQUFPLENBQUMsT0FBTyxDQUFnQjtJQUMvQixPQUFPLENBQUMsYUFBYSxDQUFRO0lBQzdCLE9BQU8sQ0FBQyxvQkFBb0IsQ0FBWTtJQUN4QyxPQUFPLENBQUMsb0JBQW9CLENBQWdCO0lBQzVDLE9BQU8sQ0FBQyxTQUFTLENBQWM7SUFFL0IsT0FBTyxDQUFDLGFBQWEsQ0FBWTtJQUNqQyxPQUFPLENBQUMsVUFBVSxDQUFnQjtJQUVsQyxPQUFPLENBQUMsb0JBQW9CLENBQVk7SUFDeEMsT0FBTyxDQUFDLGNBQWMsQ0FBZ0I7SUFDdEMsT0FBTyxDQUFDLFlBQVksQ0FBWTtJQUNoQyxPQUFPLENBQUMsV0FBVyxDQUFZO0lBRS9CLE9BQU8sQ0FBQyxzQkFBc0IsQ0FBWTtJQUMxQyxPQUFPLENBQUMsZ0JBQWdCLENBQWdCO0lBRXhDLE9BQU8sQ0FBQywwQkFBMEIsQ0FBZ0I7SUFFbEQsT0FBTyxDQUFDLEdBQUcsQ0FBNEM7SUFFdkQsT0FBTyxlQTBDTjtJQUVELE9BQW9CLEdBQUcsQ0FBQyxTQUFTLEVBQUUsZUFBZSxFQUFFLFNBQVMsQ0FBQyxFQUFFLGlCQUFpQixvQ0FVaEY7SUFFTSxTQUFTLElBQUksT0FBTyxDQUUxQjtJQUVNLGdCQUFnQixDQUFDLGdCQUFnQixFQUFFLE1BQU0sRUFBRSxNQUFNLEVBQUUsVUFBVSxFQUFFLFFBVXJFO0lBRU0sa0JBQWtCLENBQUMsS0FBSyxFQUFFLE1BQU0sRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLFFBTWhFO0lBRU0sWUFBWSxDQUFDLFFBQVEsRUFBRSxNQUFNLFFBR25DO0lBRU0scUJBQXFCLENBQUMsV0FBVyxFQUFFLE1BQU0sUUFFL0M7SUFFTSxxQkFBcUIsQ0FBQyxJQUFJLEVBQUU7UUFBRSxRQUFRLEVBQUUsTUFBTSxDQUFDO1FBQUMsYUFBYSxFQUFFLE1BQU0sQ0FBQztRQUFDLEtBQUssRUFBRSxNQUFNLENBQUE7S0FBRSxFQUFFLFFBVzlGO0lBRU0sbUJBQW1CLENBQUMsV0FBVyxFQUFFLE1BQU0sUUFFN0M7SUFFTSwyQkFBMkIsQ0FBQyxNQUFNLEVBQUUsTUFBTSxFQUFFLFNBQVMsRUFBRSxPQUFPLFFBS3BFO0NBQ0YifQ==
@@ -0,0 +1 @@
1
+ {"version":3,"file":"instrumentation.d.ts","sourceRoot":"","sources":["../../src/modules/instrumentation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAKL,KAAK,iBAAiB,EAEtB,KAAK,eAAe,EACpB,KAAK,MAAM,EAEZ,MAAM,yBAAyB,CAAC;AAEjC,qBAAa,uBAAuB;IA0BhC,OAAO,CAAC,SAAS;IAzBnB,SAAgB,MAAM,EAAE,MAAM,CAAC;IAE/B,OAAO,CAAC,WAAW,CAAQ;IAC3B,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,GAAG,CAA4C;IAEvD,OAAO,eA0CN;IAED,OAAoB,GAAG,CAAC,SAAS,EAAE,eAAe,EAAE,SAAS,CAAC,EAAE,iBAAiB,oCAUhF;IAEM,SAAS,IAAI,OAAO,CAE1B;IAEM,gBAAgB,CAAC,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,QAUrE;IAEM,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,QAMhE;IAEM,YAAY,CAAC,QAAQ,EAAE,MAAM,QAGnC;IAEM,qBAAqB,CAAC,WAAW,EAAE,MAAM,QAE/C;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;CACF"}
@@ -1,5 +1,5 @@
1
1
  import { createLogger } from '@aztec/foundation/log';
2
- import { Attributes, LmdbMetrics, Metrics, ValueType } from '@aztec/telemetry-client';
2
+ import { Attributes, LmdbMetrics, Metrics } from '@aztec/telemetry-client';
3
3
  export class ArchiverInstrumentation {
4
4
  telemetry;
5
5
  tracer;
@@ -17,70 +17,27 @@ export class ArchiverInstrumentation {
17
17
  txsPerBlock;
18
18
  syncDurationPerMessage;
19
19
  syncMessageCount;
20
+ blockProposalTxTargetCount;
20
21
  log;
21
22
  constructor(telemetry, lmdbStats){
22
23
  this.telemetry = telemetry;
23
24
  this.log = createLogger('archiver:instrumentation');
24
25
  this.tracer = telemetry.getTracer('Archiver');
25
26
  const meter = telemetry.getMeter('Archiver');
26
- this.blockHeight = meter.createGauge(Metrics.ARCHIVER_BLOCK_HEIGHT, {
27
- description: 'The height of the latest block processed by the archiver',
28
- valueType: ValueType.INT
29
- });
30
- this.l1BlockHeight = meter.createGauge(Metrics.ARCHIVER_L1_BLOCK_HEIGHT, {
31
- description: 'The height of the latest L1 block processed by the archiver',
32
- valueType: ValueType.INT
33
- });
34
- this.txCount = meter.createUpDownCounter(Metrics.ARCHIVER_TOTAL_TXS, {
35
- description: 'The total number of transactions',
36
- valueType: ValueType.INT
37
- });
38
- this.proofsSubmittedCount = meter.createUpDownCounter(Metrics.ARCHIVER_ROLLUP_PROOF_COUNT, {
39
- description: 'Number of proofs submitted',
40
- valueType: ValueType.INT
41
- });
42
- this.proofsSubmittedDelay = meter.createHistogram(Metrics.ARCHIVER_ROLLUP_PROOF_DELAY, {
43
- unit: 'ms',
44
- description: 'Time after a block is submitted until its proof is published',
45
- valueType: ValueType.INT
46
- });
47
- this.syncDurationPerBlock = meter.createHistogram(Metrics.ARCHIVER_SYNC_PER_BLOCK, {
48
- unit: 'ms',
49
- description: 'Duration to sync a block',
50
- valueType: ValueType.INT
51
- });
52
- this.syncBlockCount = meter.createUpDownCounter(Metrics.ARCHIVER_SYNC_BLOCK_COUNT, {
53
- description: 'Number of blocks synced from L1',
54
- valueType: ValueType.INT
55
- });
56
- this.manaPerBlock = meter.createHistogram(Metrics.ARCHIVER_MANA_PER_BLOCK, {
57
- description: 'The mana consumed by blocks',
58
- valueType: ValueType.DOUBLE,
59
- unit: 'Mmana'
60
- });
61
- this.txsPerBlock = meter.createHistogram(Metrics.ARCHIVER_TXS_PER_BLOCK, {
62
- description: 'The block tx count',
63
- valueType: ValueType.INT,
64
- unit: 'tx'
65
- });
66
- this.syncDurationPerMessage = meter.createHistogram(Metrics.ARCHIVER_SYNC_PER_MESSAGE, {
67
- unit: 'ms',
68
- description: 'Duration to sync a message',
69
- valueType: ValueType.INT
70
- });
71
- this.syncMessageCount = meter.createUpDownCounter(Metrics.ARCHIVER_SYNC_MESSAGE_COUNT, {
72
- description: 'Number of L1 to L2 messages synced',
73
- valueType: ValueType.INT
74
- });
75
- this.pruneDuration = meter.createHistogram(Metrics.ARCHIVER_PRUNE_DURATION, {
76
- unit: 'ms',
77
- description: 'Duration to sync a message',
78
- valueType: ValueType.INT
79
- });
80
- this.pruneCount = meter.createUpDownCounter(Metrics.ARCHIVER_PRUNE_COUNT, {
81
- description: 'Number of prunes detected',
82
- valueType: ValueType.INT
83
- });
27
+ this.blockHeight = meter.createGauge(Metrics.ARCHIVER_BLOCK_HEIGHT);
28
+ this.l1BlockHeight = meter.createGauge(Metrics.ARCHIVER_L1_BLOCK_HEIGHT);
29
+ this.txCount = meter.createUpDownCounter(Metrics.ARCHIVER_TOTAL_TXS);
30
+ this.proofsSubmittedCount = meter.createUpDownCounter(Metrics.ARCHIVER_ROLLUP_PROOF_COUNT);
31
+ this.proofsSubmittedDelay = meter.createHistogram(Metrics.ARCHIVER_ROLLUP_PROOF_DELAY);
32
+ this.syncDurationPerBlock = meter.createHistogram(Metrics.ARCHIVER_SYNC_PER_BLOCK);
33
+ this.syncBlockCount = meter.createUpDownCounter(Metrics.ARCHIVER_SYNC_BLOCK_COUNT);
34
+ this.manaPerBlock = meter.createHistogram(Metrics.ARCHIVER_MANA_PER_BLOCK);
35
+ this.txsPerBlock = meter.createHistogram(Metrics.ARCHIVER_TXS_PER_BLOCK);
36
+ this.syncDurationPerMessage = meter.createHistogram(Metrics.ARCHIVER_SYNC_PER_MESSAGE);
37
+ this.syncMessageCount = meter.createUpDownCounter(Metrics.ARCHIVER_SYNC_MESSAGE_COUNT);
38
+ this.pruneDuration = meter.createHistogram(Metrics.ARCHIVER_PRUNE_DURATION);
39
+ this.pruneCount = meter.createUpDownCounter(Metrics.ARCHIVER_PRUNE_COUNT);
40
+ this.blockProposalTxTargetCount = meter.createUpDownCounter(Metrics.ARCHIVER_BLOCK_PROPOSAL_TX_TARGET_COUNT);
84
41
  this.dbMetrics = new LmdbMetrics(meter, {
85
42
  [Attributes.DB_DATA_TYPE]: 'archiver'
86
43
  }, lmdbStats);
@@ -137,4 +94,10 @@ export class ArchiverInstrumentation {
137
94
  updateL1BlockHeight(blockNumber) {
138
95
  this.l1BlockHeight.record(Number(blockNumber));
139
96
  }
97
+ recordBlockProposalTxTarget(target, usedTrace) {
98
+ this.blockProposalTxTargetCount.add(1, {
99
+ [Attributes.L1_BLOCK_PROPOSAL_TX_TARGET]: target.toLowerCase(),
100
+ [Attributes.L1_BLOCK_PROPOSAL_USED_TRACE]: usedTrace
101
+ });
102
+ }
140
103
  }
@@ -0,0 +1,75 @@
1
+ import type { BlobClientInterface } from '@aztec/blob-client/client';
2
+ import { EpochCache } from '@aztec/epoch-cache';
3
+ import { InboxContract, RollupContract } from '@aztec/ethereum/contracts';
4
+ import type { L1ContractAddresses } from '@aztec/ethereum/l1-contract-addresses';
5
+ import type { ViemPublicClient, ViemPublicDebugClient } from '@aztec/ethereum/types';
6
+ import { Buffer32 } from '@aztec/foundation/buffer';
7
+ import { Fr } from '@aztec/foundation/curves/bn254';
8
+ import { EthAddress } from '@aztec/foundation/eth-address';
9
+ import { type Logger } from '@aztec/foundation/log';
10
+ import { DateProvider } from '@aztec/foundation/timer';
11
+ import { type ArchiverEmitter } from '@aztec/stdlib/block';
12
+ import { type L1RollupConstants } from '@aztec/stdlib/epoch-helpers';
13
+ import { type Traceable, type Tracer } from '@aztec/telemetry-client';
14
+ import type { KVArchiverDataStore } from '../store/kv_archiver_store.js';
15
+ import type { ArchiverInstrumentation } from './instrumentation.js';
16
+ /**
17
+ * Handles L1 synchronization for the archiver.
18
+ * Responsible for fetching checkpoints, L1→L2 messages, and handling L1 reorgs.
19
+ */
20
+ export declare class ArchiverL1Synchronizer implements Traceable {
21
+ private readonly publicClient;
22
+ private readonly debugClient;
23
+ private readonly rollup;
24
+ private readonly inbox;
25
+ private readonly l1Addresses;
26
+ private readonly store;
27
+ private config;
28
+ private readonly blobClient;
29
+ private readonly epochCache;
30
+ private readonly dateProvider;
31
+ private readonly instrumentation;
32
+ private readonly l1Constants;
33
+ private readonly events;
34
+ private readonly log;
35
+ private l1BlockNumber;
36
+ private l1BlockHash;
37
+ private l1Timestamp;
38
+ private readonly updater;
39
+ readonly tracer: Tracer;
40
+ constructor(publicClient: ViemPublicClient, debugClient: ViemPublicDebugClient, rollup: RollupContract, inbox: InboxContract, l1Addresses: Pick<L1ContractAddresses, 'registryAddress' | 'governanceProposerAddress' | 'slashFactoryAddress'> & {
41
+ slashingProposerAddress: EthAddress;
42
+ }, store: KVArchiverDataStore, config: {
43
+ batchSize: number;
44
+ skipValidateCheckpointAttestations?: boolean;
45
+ maxAllowedEthClientDriftSeconds: number;
46
+ }, blobClient: BlobClientInterface, epochCache: EpochCache, dateProvider: DateProvider, instrumentation: ArchiverInstrumentation, l1Constants: L1RollupConstants & {
47
+ l1StartBlockHash: Buffer32;
48
+ genesisArchiveRoot: Fr;
49
+ }, events: ArchiverEmitter, tracer: Tracer, log?: Logger);
50
+ /** Sets new config */
51
+ setConfig(newConfig: {
52
+ batchSize: number;
53
+ skipValidateCheckpointAttestations?: boolean;
54
+ maxAllowedEthClientDriftSeconds: number;
55
+ }): void;
56
+ /** Returns the last L1 block number that was synced. */
57
+ getL1BlockNumber(): bigint | undefined;
58
+ /** Returns the last L1 timestamp that was synced. */
59
+ getL1Timestamp(): bigint | undefined;
60
+ /** Checks that the ethereum node we are connected to has a latest timestamp no more than the allowed drift. Throw if not. */
61
+ testEthereumNodeSynced(): Promise<void>;
62
+ syncFromL1(initialSyncComplete: boolean): Promise<void>;
63
+ private pruneUncheckpointedBlocks;
64
+ private canPrune;
65
+ private handleEpochPrune;
66
+ private nextRange;
67
+ private handleL1ToL2Messages;
68
+ private retrieveL1ToL2Message;
69
+ private rollbackL1ToL2Messages;
70
+ private getL1BlockHash;
71
+ private handleCheckpoints;
72
+ private checkForNewCheckpointsBeforeL1SyncPoint;
73
+ private getCheckpointHeader;
74
+ }
75
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibDFfc3luY2hyb25pemVyLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbW9kdWxlcy9sMV9zeW5jaHJvbml6ZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSwyQkFBMkIsQ0FBQztBQUNyRSxPQUFPLEVBQUUsVUFBVSxFQUFFLE1BQU0sb0JBQW9CLENBQUM7QUFDaEQsT0FBTyxFQUFFLGFBQWEsRUFBRSxjQUFjLEVBQUUsTUFBTSwyQkFBMkIsQ0FBQztBQUMxRSxPQUFPLEtBQUssRUFBRSxtQkFBbUIsRUFBRSxNQUFNLHVDQUF1QyxDQUFDO0FBRWpGLE9BQU8sS0FBSyxFQUFFLGdCQUFnQixFQUFFLHFCQUFxQixFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFHckYsT0FBTyxFQUFFLFFBQVEsRUFBRSxNQUFNLDBCQUEwQixDQUFDO0FBRXBELE9BQU8sRUFBRSxFQUFFLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUNwRCxPQUFPLEVBQUUsVUFBVSxFQUFFLE1BQU0sK0JBQStCLENBQUM7QUFDM0QsT0FBTyxFQUFFLEtBQUssTUFBTSxFQUFnQixNQUFNLHVCQUF1QixDQUFDO0FBRWxFLE9BQU8sRUFBRSxZQUFZLEVBQWtCLE1BQU0seUJBQXlCLENBQUM7QUFFdkUsT0FBTyxFQUFFLEtBQUssZUFBZSxFQUFzRCxNQUFNLHFCQUFxQixDQUFDO0FBRS9HLE9BQU8sRUFBRSxLQUFLLGlCQUFpQixFQUFzQyxNQUFNLDZCQUE2QixDQUFDO0FBRXpHLE9BQU8sRUFBRSxLQUFLLFNBQVMsRUFBRSxLQUFLLE1BQU0sRUFBeUIsTUFBTSx5QkFBeUIsQ0FBQztBQVM3RixPQUFPLEtBQUssRUFBRSxtQkFBbUIsRUFBRSxNQUFNLCtCQUErQixDQUFDO0FBR3pFLE9BQU8sS0FBSyxFQUFFLHVCQUF1QixFQUFFLE1BQU0sc0JBQXNCLENBQUM7QUFhcEU7OztHQUdHO0FBQ0gscUJBQWEs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
@@ -0,0 +1 @@
1
+ {"version":3,"file":"l1_synchronizer.d.ts","sourceRoot":"","sources":["../../src/modules/l1_synchronizer.ts"],"names":[],"mappings":"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"}