@aztec/archiver 3.0.3 → 3.9.9-nightly.20260312

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 (212) hide show
  1. package/README.md +156 -22
  2. package/dest/archiver.d.ts +139 -0
  3. package/dest/archiver.d.ts.map +1 -0
  4. package/dest/archiver.js +734 -0
  5. package/dest/{archiver/config.d.ts → config.d.ts} +11 -3
  6. package/dest/config.d.ts.map +1 -0
  7. package/dest/{archiver/config.js → config.js} +13 -4
  8. package/dest/errors.d.ts +39 -0
  9. package/dest/errors.d.ts.map +1 -0
  10. package/dest/errors.js +57 -0
  11. package/dest/factory.d.ts +9 -7
  12. package/dest/factory.d.ts.map +1 -1
  13. package/dest/factory.js +93 -11
  14. package/dest/index.d.ts +11 -4
  15. package/dest/index.d.ts.map +1 -1
  16. package/dest/index.js +9 -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/{archiver/l1 → l1}/bin/retrieve-calldata.d.ts +1 -1
  21. package/dest/l1/bin/retrieve-calldata.d.ts.map +1 -0
  22. package/dest/{archiver/l1 → l1}/bin/retrieve-calldata.js +38 -33
  23. package/dest/l1/calldata_retriever.d.ts +135 -0
  24. package/dest/l1/calldata_retriever.d.ts.map +1 -0
  25. package/dest/l1/calldata_retriever.js +402 -0
  26. package/dest/l1/data_retrieval.d.ts +85 -0
  27. package/dest/l1/data_retrieval.d.ts.map +1 -0
  28. package/dest/{archiver/l1 → l1}/data_retrieval.js +63 -73
  29. package/dest/{archiver/l1 → l1}/debug_tx.d.ts +1 -1
  30. package/dest/l1/debug_tx.d.ts.map +1 -0
  31. package/dest/{archiver/l1 → l1}/spire_proposer.d.ts +5 -5
  32. package/dest/l1/spire_proposer.d.ts.map +1 -0
  33. package/dest/{archiver/l1 → l1}/spire_proposer.js +9 -17
  34. package/dest/{archiver/l1 → l1}/trace_tx.d.ts +1 -1
  35. package/dest/l1/trace_tx.d.ts.map +1 -0
  36. package/dest/l1/types.d.ts +12 -0
  37. package/dest/l1/types.d.ts.map +1 -0
  38. package/dest/{archiver/l1 → l1}/validate_trace.d.ts +6 -3
  39. package/dest/l1/validate_trace.d.ts.map +1 -0
  40. package/dest/{archiver/l1 → l1}/validate_trace.js +14 -10
  41. package/dest/modules/data_source_base.d.ts +89 -0
  42. package/dest/modules/data_source_base.d.ts.map +1 -0
  43. package/dest/modules/data_source_base.js +216 -0
  44. package/dest/modules/data_store_updater.d.ts +83 -0
  45. package/dest/modules/data_store_updater.d.ts.map +1 -0
  46. package/dest/modules/data_store_updater.js +333 -0
  47. package/dest/modules/instrumentation.d.ts +39 -0
  48. package/dest/modules/instrumentation.d.ts.map +1 -0
  49. package/dest/{archiver → modules}/instrumentation.js +33 -67
  50. package/dest/modules/l1_synchronizer.d.ts +71 -0
  51. package/dest/modules/l1_synchronizer.d.ts.map +1 -0
  52. package/dest/modules/l1_synchronizer.js +1112 -0
  53. package/dest/modules/validation.d.ts +17 -0
  54. package/dest/modules/validation.d.ts.map +1 -0
  55. package/dest/{archiver → modules}/validation.js +7 -1
  56. package/dest/store/block_store.d.ts +196 -0
  57. package/dest/store/block_store.d.ts.map +1 -0
  58. package/dest/store/block_store.js +755 -0
  59. package/dest/store/contract_class_store.d.ts +18 -0
  60. package/dest/store/contract_class_store.d.ts.map +1 -0
  61. package/dest/{archiver/kv_archiver_store → store}/contract_class_store.js +12 -8
  62. package/dest/store/contract_instance_store.d.ts +24 -0
  63. package/dest/store/contract_instance_store.d.ts.map +1 -0
  64. package/dest/{archiver/kv_archiver_store → store}/contract_instance_store.js +1 -1
  65. package/dest/store/kv_archiver_store.d.ts +353 -0
  66. package/dest/store/kv_archiver_store.d.ts.map +1 -0
  67. package/dest/store/kv_archiver_store.js +464 -0
  68. package/dest/store/l2_tips_cache.d.ts +19 -0
  69. package/dest/store/l2_tips_cache.d.ts.map +1 -0
  70. package/dest/store/l2_tips_cache.js +89 -0
  71. package/dest/store/log_store.d.ts +54 -0
  72. package/dest/store/log_store.d.ts.map +1 -0
  73. package/dest/store/log_store.js +456 -0
  74. package/dest/{archiver/kv_archiver_store → store}/message_store.d.ts +1 -1
  75. package/dest/store/message_store.d.ts.map +1 -0
  76. package/dest/{archiver/kv_archiver_store → store}/message_store.js +1 -1
  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/structs/published.d.ts +2 -0
  82. package/dest/structs/published.d.ts.map +1 -0
  83. package/dest/test/fake_l1_state.d.ts +195 -0
  84. package/dest/test/fake_l1_state.d.ts.map +1 -0
  85. package/dest/test/fake_l1_state.js +421 -0
  86. package/dest/test/index.d.ts +2 -1
  87. package/dest/test/index.d.ts.map +1 -1
  88. package/dest/test/index.js +4 -1
  89. package/dest/test/mock_archiver.d.ts +2 -2
  90. package/dest/test/mock_archiver.d.ts.map +1 -1
  91. package/dest/test/mock_archiver.js +3 -3
  92. package/dest/test/mock_l1_to_l2_message_source.d.ts +2 -2
  93. package/dest/test/mock_l1_to_l2_message_source.d.ts.map +1 -1
  94. package/dest/test/mock_l1_to_l2_message_source.js +12 -3
  95. package/dest/test/mock_l2_block_source.d.ts +47 -17
  96. package/dest/test/mock_l2_block_source.d.ts.map +1 -1
  97. package/dest/test/mock_l2_block_source.js +244 -91
  98. package/dest/test/mock_structs.d.ts +81 -3
  99. package/dest/test/mock_structs.d.ts.map +1 -1
  100. package/dest/test/mock_structs.js +152 -7
  101. package/dest/test/noop_l1_archiver.d.ts +26 -0
  102. package/dest/test/noop_l1_archiver.d.ts.map +1 -0
  103. package/dest/test/noop_l1_archiver.js +72 -0
  104. package/package.json +16 -17
  105. package/src/archiver.ts +488 -0
  106. package/src/{archiver/config.ts → config.ts} +20 -5
  107. package/src/errors.ts +88 -0
  108. package/src/factory.ts +142 -11
  109. package/src/index.ts +11 -3
  110. package/src/interfaces.ts +9 -0
  111. package/src/l1/README.md +55 -0
  112. package/src/{archiver/l1 → l1}/bin/retrieve-calldata.ts +46 -34
  113. package/src/l1/calldata_retriever.ts +511 -0
  114. package/src/{archiver/l1 → l1}/data_retrieval.ts +93 -99
  115. package/src/{archiver/l1 → l1}/spire_proposer.ts +7 -15
  116. package/src/{archiver/l1 → l1}/validate_trace.ts +25 -7
  117. package/src/modules/data_source_base.ts +328 -0
  118. package/src/modules/data_store_updater.ts +453 -0
  119. package/src/{archiver → modules}/instrumentation.ts +33 -70
  120. package/src/modules/l1_synchronizer.ts +930 -0
  121. package/src/{archiver → modules}/validation.ts +11 -6
  122. package/src/store/block_store.ts +990 -0
  123. package/src/{archiver/kv_archiver_store → store}/contract_class_store.ts +12 -8
  124. package/src/{archiver/kv_archiver_store → store}/contract_instance_store.ts +1 -1
  125. package/src/store/kv_archiver_store.ts +671 -0
  126. package/src/store/l2_tips_cache.ts +89 -0
  127. package/src/store/log_store.ts +637 -0
  128. package/src/{archiver/kv_archiver_store → store}/message_store.ts +1 -1
  129. package/src/{archiver/structs → structs}/published.ts +0 -1
  130. package/src/test/fake_l1_state.ts +657 -0
  131. package/src/test/index.ts +4 -0
  132. package/src/test/mock_archiver.ts +4 -3
  133. package/src/test/mock_l1_to_l2_message_source.ts +10 -4
  134. package/src/test/mock_l2_block_source.ts +294 -98
  135. package/src/test/mock_structs.ts +283 -8
  136. package/src/test/noop_l1_archiver.ts +115 -0
  137. package/dest/archiver/archiver.d.ts +0 -284
  138. package/dest/archiver/archiver.d.ts.map +0 -1
  139. package/dest/archiver/archiver.js +0 -1454
  140. package/dest/archiver/archiver_store.d.ts +0 -249
  141. package/dest/archiver/archiver_store.d.ts.map +0 -1
  142. package/dest/archiver/archiver_store.js +0 -4
  143. package/dest/archiver/archiver_store_test_suite.d.ts +0 -8
  144. package/dest/archiver/archiver_store_test_suite.d.ts.map +0 -1
  145. package/dest/archiver/archiver_store_test_suite.js +0 -1273
  146. package/dest/archiver/config.d.ts.map +0 -1
  147. package/dest/archiver/errors.d.ts +0 -12
  148. package/dest/archiver/errors.d.ts.map +0 -1
  149. package/dest/archiver/errors.js +0 -17
  150. package/dest/archiver/index.d.ts +0 -7
  151. package/dest/archiver/index.d.ts.map +0 -1
  152. package/dest/archiver/index.js +0 -4
  153. package/dest/archiver/instrumentation.d.ts +0 -37
  154. package/dest/archiver/instrumentation.d.ts.map +0 -1
  155. package/dest/archiver/kv_archiver_store/block_store.d.ts +0 -125
  156. package/dest/archiver/kv_archiver_store/block_store.d.ts.map +0 -1
  157. package/dest/archiver/kv_archiver_store/block_store.js +0 -371
  158. package/dest/archiver/kv_archiver_store/contract_class_store.d.ts +0 -18
  159. package/dest/archiver/kv_archiver_store/contract_class_store.d.ts.map +0 -1
  160. package/dest/archiver/kv_archiver_store/contract_instance_store.d.ts +0 -24
  161. package/dest/archiver/kv_archiver_store/contract_instance_store.d.ts.map +0 -1
  162. package/dest/archiver/kv_archiver_store/kv_archiver_store.d.ts +0 -162
  163. package/dest/archiver/kv_archiver_store/kv_archiver_store.d.ts.map +0 -1
  164. package/dest/archiver/kv_archiver_store/kv_archiver_store.js +0 -288
  165. package/dest/archiver/kv_archiver_store/log_store.d.ts +0 -42
  166. package/dest/archiver/kv_archiver_store/log_store.d.ts.map +0 -1
  167. package/dest/archiver/kv_archiver_store/log_store.js +0 -314
  168. package/dest/archiver/kv_archiver_store/message_store.d.ts.map +0 -1
  169. package/dest/archiver/l1/bin/retrieve-calldata.d.ts.map +0 -1
  170. package/dest/archiver/l1/calldata_retriever.d.ts +0 -98
  171. package/dest/archiver/l1/calldata_retriever.d.ts.map +0 -1
  172. package/dest/archiver/l1/calldata_retriever.js +0 -403
  173. package/dest/archiver/l1/data_retrieval.d.ts +0 -87
  174. package/dest/archiver/l1/data_retrieval.d.ts.map +0 -1
  175. package/dest/archiver/l1/debug_tx.d.ts.map +0 -1
  176. package/dest/archiver/l1/spire_proposer.d.ts.map +0 -1
  177. package/dest/archiver/l1/trace_tx.d.ts.map +0 -1
  178. package/dest/archiver/l1/types.d.ts +0 -12
  179. package/dest/archiver/l1/types.d.ts.map +0 -1
  180. package/dest/archiver/l1/validate_trace.d.ts.map +0 -1
  181. package/dest/archiver/structs/data_retrieval.d.ts.map +0 -1
  182. package/dest/archiver/structs/inbox_message.d.ts +0 -15
  183. package/dest/archiver/structs/inbox_message.d.ts.map +0 -1
  184. package/dest/archiver/structs/published.d.ts +0 -3
  185. package/dest/archiver/structs/published.d.ts.map +0 -1
  186. package/dest/archiver/validation.d.ts +0 -17
  187. package/dest/archiver/validation.d.ts.map +0 -1
  188. package/dest/rpc/index.d.ts +0 -9
  189. package/dest/rpc/index.d.ts.map +0 -1
  190. package/dest/rpc/index.js +0 -15
  191. package/src/archiver/archiver.ts +0 -1906
  192. package/src/archiver/archiver_store.ts +0 -302
  193. package/src/archiver/archiver_store_test_suite.ts +0 -1286
  194. package/src/archiver/errors.ts +0 -26
  195. package/src/archiver/index.ts +0 -6
  196. package/src/archiver/kv_archiver_store/block_store.ts +0 -482
  197. package/src/archiver/kv_archiver_store/kv_archiver_store.ts +0 -413
  198. package/src/archiver/kv_archiver_store/log_store.ts +0 -380
  199. package/src/archiver/l1/README.md +0 -98
  200. package/src/archiver/l1/calldata_retriever.ts +0 -531
  201. package/src/rpc/index.ts +0 -16
  202. /package/dest/{archiver/l1 → l1}/debug_tx.js +0 -0
  203. /package/dest/{archiver/l1 → l1}/trace_tx.js +0 -0
  204. /package/dest/{archiver/l1 → l1}/types.js +0 -0
  205. /package/dest/{archiver/structs → structs}/data_retrieval.js +0 -0
  206. /package/dest/{archiver/structs → structs}/inbox_message.js +0 -0
  207. /package/dest/{archiver/structs → structs}/published.js +0 -0
  208. /package/src/{archiver/l1 → l1}/debug_tx.ts +0 -0
  209. /package/src/{archiver/l1 → l1}/trace_tx.ts +0 -0
  210. /package/src/{archiver/l1 → l1}/types.ts +0 -0
  211. /package/src/{archiver/structs → structs}/data_retrieval.ts +0 -0
  212. /package/src/{archiver/structs → structs}/inbox_message.ts +0 -0
@@ -1,4 +1,4 @@
1
- import { type BlobSinkConfig } from '@aztec/blob-sink/client/config';
1
+ import { type BlobClientConfig } from '@aztec/blob-client/client/config';
2
2
  import { type L1ContractsConfig } from '@aztec/ethereum/config';
3
3
  import { type L1ReaderConfig } from '@aztec/ethereum/l1-reader';
4
4
  import { type ConfigMappingsType } from '@aztec/foundation/config';
@@ -11,7 +11,7 @@ import type { ArchiverSpecificConfig } from '@aztec/stdlib/interfaces/server';
11
11
  * Results of calls to eth_blockNumber are cached by viem with this cache being updated periodically at the interval specified by viemPollingIntervalMS.
12
12
  * As a result the maximum observed polling time for new blocks will be viemPollingIntervalMS + archiverPollingIntervalMS.
13
13
  */
14
- export type ArchiverConfig = ArchiverSpecificConfig & L1ReaderConfig & L1ContractsConfig & BlobSinkConfig & ChainConfig;
14
+ export type ArchiverConfig = ArchiverSpecificConfig & L1ReaderConfig & L1ContractsConfig & BlobClientConfig & ChainConfig;
15
15
  export declare const archiverConfigMappings: ConfigMappingsType<ArchiverConfig>;
16
16
  /**
17
17
  * Returns the archiver configuration from the environment variables.
@@ -19,4 +19,12 @@ export declare const archiverConfigMappings: ConfigMappingsType<ArchiverConfig>;
19
19
  * @returns The archiver configuration.
20
20
  */
21
21
  export declare function getArchiverConfigFromEnv(): ArchiverConfig;
22
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlnLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvYXJjaGl2ZXIvY29uZmlnLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxLQUFLLGNBQWMsRUFBeUIsTUFBTSxnQ0FBZ0MsQ0FBQztBQUM1RixPQUFPLEVBQUUsS0FBSyxpQkFBaUIsRUFBNkIsTUFBTSx3QkFBd0IsQ0FBQztBQUUzRixPQUFPLEVBQUUsS0FBSyxjQUFjLEVBQTBCLE1BQU0sMkJBQTJCLENBQUM7QUFDeEYsT0FBTyxFQUNMLEtBQUssa0JBQWtCLEVBSXhCLE1BQU0sMEJBQTBCLENBQUM7QUFDbEMsT0FBTyxFQUFFLEtBQUssV0FBVyxFQUF1QixNQUFNLHNCQUFzQixDQUFDO0FBQzdFLE9BQU8sS0FBSyxFQUFFLHNCQUFzQixFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFFOUU7Ozs7OztHQU1HO0FBQ0gsTUFBTSxNQUFNLGNBQWMsR0FBRyxzQkFBc0IsR0FBRyxjQUFjLEdBQUcsaUJBQWlCLEdBQUcsY0FBYyxHQUFHLFdBQVcsQ0FBQztBQUV4SCxlQUFPLE1BQU0sc0JBQXNCLEVBQUUsa0JBQWtCLENBQUMsY0FBYyxDQWdEckUsQ0FBQztBQUVGOzs7O0dBSUc7QUFDSCx3QkFBZ0Isd0JBQXdCLElBQUksY0FBYyxDQUV6RCJ9
22
+ /** Extracts the archiver-specific configuration from the full ArchiverConfig */
23
+ export declare function mapArchiverConfig(config: Partial<ArchiverConfig>): {
24
+ pollingIntervalMs: number | undefined;
25
+ batchSize: number | undefined;
26
+ skipValidateCheckpointAttestations: boolean | undefined;
27
+ maxAllowedEthClientDriftSeconds: number | undefined;
28
+ ethereumAllowNoDebugHosts: boolean | undefined;
29
+ };
30
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlnLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvY29uZmlnLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxLQUFLLGdCQUFnQixFQUEyQixNQUFNLGtDQUFrQyxDQUFDO0FBQ2xHLE9BQU8sRUFBRSxLQUFLLGlCQUFpQixFQUE2QixNQUFNLHdCQUF3QixDQUFDO0FBRTNGLE9BQU8sRUFBRSxLQUFLLGNBQWMsRUFBMEIsTUFBTSwyQkFBMkIsQ0FBQztBQUN4RixPQUFPLEVBQ0wsS0FBSyxrQkFBa0IsRUFJeEIsTUFBTSwwQkFBMEIsQ0FBQztBQUNsQyxPQUFPLEVBQUUsS0FBSyxXQUFXLEVBQXVCLE1BQU0sc0JBQXNCLENBQUM7QUFDN0UsT0FBTyxLQUFLLEVBQUUsc0JBQXNCLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUU5RTs7Ozs7O0dBTUc7QUFDSCxNQUFNLE1BQU0sY0FBYyxHQUFHLHNCQUFzQixHQUNqRCxjQUFjLEdBQ2QsaUJBQWlCLEdBQ2pCLGdCQUFnQixHQUNoQixXQUFXLENBQUM7QUFFZCxlQUFPLE1BQU0sc0JBQXNCLEVBQUUsa0JBQWtCLENBQUMsY0FBYyxDQWdEckUsQ0FBQztBQUVGOzs7O0dBSUc7QUFDSCx3QkFBZ0Isd0JBQXdCLElBQUksY0FBYyxDQUV6RDtBQUVELGdGQUFnRjtBQUNoRix3QkFBZ0IsaUJBQWlCLENBQUMsTUFBTSxFQUFFLE9BQU8sQ0FBQyxjQUFjLENBQUM7Ozs7OztFQVFoRSJ9
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAA2B,MAAM,kCAAkC,CAAC;AAClG,OAAO,EAAE,KAAK,iBAAiB,EAA6B,MAAM,wBAAwB,CAAC;AAE3F,OAAO,EAAE,KAAK,cAAc,EAA0B,MAAM,2BAA2B,CAAC;AACxF,OAAO,EACL,KAAK,kBAAkB,EAIxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,KAAK,WAAW,EAAuB,MAAM,sBAAsB,CAAC;AAC7E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAE9E;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,sBAAsB,GACjD,cAAc,GACd,iBAAiB,GACjB,gBAAgB,GAChB,WAAW,CAAC;AAEd,eAAO,MAAM,sBAAsB,EAAE,kBAAkB,CAAC,cAAc,CAgDrE,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,cAAc,CAEzD;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC;;;;;;EAQhE"}
@@ -1,11 +1,11 @@
1
- import { blobSinkConfigMapping } from '@aztec/blob-sink/client/config';
1
+ import { blobClientConfigMapping } from '@aztec/blob-client/client/config';
2
2
  import { l1ContractsConfigMappings } from '@aztec/ethereum/config';
3
3
  import { l1ContractAddressesMapping } from '@aztec/ethereum/l1-contract-addresses';
4
4
  import { l1ReaderConfigMappings } from '@aztec/ethereum/l1-reader';
5
5
  import { booleanConfigHelper, getConfigFromMappings, numberConfigHelper } from '@aztec/foundation/config';
6
6
  import { chainConfigMappings } from '@aztec/stdlib/config';
7
7
  export const archiverConfigMappings = {
8
- ...blobSinkConfigMapping,
8
+ ...blobClientConfigMapping,
9
9
  archiverPollingIntervalMS: {
10
10
  env: 'ARCHIVER_POLLING_INTERVAL_MS',
11
11
  description: 'The polling interval in ms for retrieving new L2 blocks and encrypted logs.',
@@ -26,8 +26,8 @@ export const archiverConfigMappings = {
26
26
  parseEnv: (val)=>val ? +val : undefined,
27
27
  description: 'The maximum possible size of the archiver DB in KB. Overwrites the general dataStoreMapSizeKb.'
28
28
  },
29
- skipValidateBlockAttestations: {
30
- description: 'Whether to skip validating block attestations (use only for testing).',
29
+ skipValidateCheckpointAttestations: {
30
+ description: 'Skip validating checkpoint attestations (for testing purposes only)',
31
31
  ...booleanConfigHelper(false)
32
32
  },
33
33
  maxAllowedEthClientDriftSeconds: {
@@ -60,3 +60,12 @@ export const archiverConfigMappings = {
60
60
  */ export function getArchiverConfigFromEnv() {
61
61
  return getConfigFromMappings(archiverConfigMappings);
62
62
  }
63
+ /** Extracts the archiver-specific configuration from the full ArchiverConfig */ export function mapArchiverConfig(config) {
64
+ return {
65
+ pollingIntervalMs: config.archiverPollingIntervalMS,
66
+ batchSize: config.archiverBatchSize,
67
+ skipValidateCheckpointAttestations: config.skipValidateCheckpointAttestations,
68
+ maxAllowedEthClientDriftSeconds: config.maxAllowedEthClientDriftSeconds,
69
+ ethereumAllowNoDebugHosts: config.ethereumAllowNoDebugHosts
70
+ };
71
+ }
@@ -0,0 +1,39 @@
1
+ import type { Fr } from '@aztec/foundation/schemas';
2
+ export declare class NoBlobBodiesFoundError extends Error {
3
+ constructor(l2BlockNum: number);
4
+ }
5
+ export declare class BlockNumberNotSequentialError extends Error {
6
+ constructor(newBlockNumber: number, previous: number | undefined);
7
+ }
8
+ export declare class InitialCheckpointNumberNotSequentialError extends Error {
9
+ readonly newCheckpointNumber: number;
10
+ readonly previousCheckpointNumber: number | undefined;
11
+ constructor(newCheckpointNumber: number, previousCheckpointNumber: number | undefined);
12
+ }
13
+ export declare class CheckpointNumberNotSequentialError extends Error {
14
+ constructor(newCheckpointNumber: number, previous: number | undefined);
15
+ }
16
+ export declare class BlockIndexNotSequentialError extends Error {
17
+ constructor(newBlockIndex: number, previousBlockIndex: number | undefined);
18
+ }
19
+ export declare class BlockArchiveNotConsistentError extends Error {
20
+ constructor(newBlockNumber: number, previousBlockNumber: number | undefined, newBlockArchive: Fr, previousBlockArchive: Fr);
21
+ }
22
+ export declare class CheckpointNotFoundError extends Error {
23
+ constructor(checkpointNumber: number);
24
+ }
25
+ export declare class BlockNotFoundError extends Error {
26
+ constructor(blockNumber: number);
27
+ }
28
+ /** Thrown when a proposed block matches a block that was already checkpointed. This is expected for late proposals. */
29
+ export declare class BlockAlreadyCheckpointedError extends Error {
30
+ readonly blockNumber: number;
31
+ constructor(blockNumber: number);
32
+ }
33
+ /** Thrown when a proposed block conflicts with an already checkpointed block (different content). */
34
+ export declare class CannotOverwriteCheckpointedBlockError extends Error {
35
+ readonly blockNumber: number;
36
+ readonly lastCheckpointedBlock: number;
37
+ constructor(blockNumber: number, lastCheckpointedBlock: number);
38
+ }
39
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXJyb3JzLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvZXJyb3JzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLEVBQUUsRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBRXBELHFCQUFhLHNCQUF1QixTQUFRLEtBQUs7SUFDL0MsWUFBWSxVQUFVLEVBQUUsTUFBTSxFQUU3QjtDQUNGO0FBRUQscUJBQWEsNkJBQThCLFNBQVEsS0FBSztJQUN0RCxZQUFZLGNBQWMsRUFBRSxNQUFNLEVBQUUsUUFBUSxFQUFFLE1BQU0sR0FBRyxTQUFTLEVBRS9EO0NBQ0Y7QUFFRCxxQkFBYSx5Q0FBMEMsU0FBUSxLQUFLO2FBRWhELG1CQUFtQixFQUFFLE1BQU07YUFDM0Isd0JBQXdCLEVBQUUsTUFBTSxHQUFHLFNBQVM7SUFGOUQsWUFDa0IsbUJBQW1CLEVBQUUsTUFBTSxFQUMzQix3QkFBd0IsRUFBRSxNQUFNLEdBQUcsU0FBUyxFQU83RDtDQUNGO0FBRUQscUJBQWEsa0NBQW1DLFNBQVEsS0FBSztJQUMzRCxZQUFZLG1CQUFtQixFQUFFLE1BQU0sRUFBRSxRQUFRLEVBQUUsTUFBTSxHQUFHLFNBQVMsRUFJcEU7Q0FDRjtBQUVELHFCQUFhLDRCQUE2QixTQUFRLEtBQUs7SUFDckQsWUFBWSxhQUFhLEVBQUUsTUFBTSxFQUFFLGtCQUFrQixFQUFFLE1BQU0sR0FBRyxTQUFTLEVBSXhFO0NBQ0Y7QUFFRCxxQkFBYSw4QkFBK0IsU0FBUSxLQUFLO0lBQ3ZELFlBQ0UsY0FBYyxFQUFFLE1BQU0sRUFDdEIsbUJBQW1CLEVBQUUsTUFBTSxHQUFHLFNBQVMsRUFDdkMsZUFBZSxFQUFFLEVBQUUsRUFDbkIsb0JBQW9CLEVBQUUsRUFBRSxFQUt6QjtDQUNGO0FBRUQscUJBQWEsdUJBQXdCLFNBQVEsS0FBSztJQUNoRCxZQUFZLGdCQUFnQixFQUFFLE1BQU0sRUFFbkM7Q0FDRjtBQUVELHFCQUFhLGtCQUFtQixTQUFRLEtBQUs7SUFDM0MsWUFBWSxXQUFXLEVBQUUsTUFBTSxFQUU5QjtDQUNGO0FBRUQsdUhBQXVIO0FBQ3ZILHFCQUFhLDZCQUE4QixTQUFRLEtBQUs7YUFDMUIsV0FBVyxFQUFFLE1BQU07SUFBL0MsWUFBNEIsV0FBVyxFQUFFLE1BQU0sRUFHOUM7Q0FDRjtBQUVELHFHQUFxRztBQUNyRyxxQkFBYSxxQ0FBc0MsU0FBUSxLQUFLO2FBRTVDLFdBQVcsRUFBRSxNQUFNO2FBQ25CLHFCQUFxQixFQUFFLE1BQU07SUFGL0MsWUFDa0IsV0FBVyxFQUFFLE1BQU0sRUFDbkIscUJBQXFCLEVBQUUsTUFBTSxFQU05QztDQUNGIn0=
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,2BAA2B,CAAC;AAEpD,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,YAAY,UAAU,EAAE,MAAM,EAE7B;CACF;AAED,qBAAa,6BAA8B,SAAQ,KAAK;IACtD,YAAY,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,EAE/D;CACF;AAED,qBAAa,yCAA0C,SAAQ,KAAK;aAEhD,mBAAmB,EAAE,MAAM;aAC3B,wBAAwB,EAAE,MAAM,GAAG,SAAS;IAF9D,YACkB,mBAAmB,EAAE,MAAM,EAC3B,wBAAwB,EAAE,MAAM,GAAG,SAAS,EAO7D;CACF;AAED,qBAAa,kCAAmC,SAAQ,KAAK;IAC3D,YAAY,mBAAmB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,EAIpE;CACF;AAED,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,YAAY,aAAa,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,SAAS,EAIxE;CACF;AAED,qBAAa,8BAA+B,SAAQ,KAAK;IACvD,YACE,cAAc,EAAE,MAAM,EACtB,mBAAmB,EAAE,MAAM,GAAG,SAAS,EACvC,eAAe,EAAE,EAAE,EACnB,oBAAoB,EAAE,EAAE,EAKzB;CACF;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,YAAY,gBAAgB,EAAE,MAAM,EAEnC;CACF;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,WAAW,EAAE,MAAM,EAE9B;CACF;AAED,uHAAuH;AACvH,qBAAa,6BAA8B,SAAQ,KAAK;aAC1B,WAAW,EAAE,MAAM;IAA/C,YAA4B,WAAW,EAAE,MAAM,EAG9C;CACF;AAED,qGAAqG;AACrG,qBAAa,qCAAsC,SAAQ,KAAK;aAE5C,WAAW,EAAE,MAAM;aACnB,qBAAqB,EAAE,MAAM;IAF/C,YACkB,WAAW,EAAE,MAAM,EACnB,qBAAqB,EAAE,MAAM,EAM9C;CACF"}
package/dest/errors.js ADDED
@@ -0,0 +1,57 @@
1
+ export class NoBlobBodiesFoundError extends Error {
2
+ constructor(l2BlockNum){
3
+ super(`No blob bodies found for block ${l2BlockNum}`);
4
+ }
5
+ }
6
+ export class BlockNumberNotSequentialError extends Error {
7
+ constructor(newBlockNumber, previous){
8
+ super(`Cannot insert new block ${newBlockNumber} given previous block number is ${previous ?? 'undefined'}`);
9
+ }
10
+ }
11
+ export class InitialCheckpointNumberNotSequentialError extends Error {
12
+ newCheckpointNumber;
13
+ previousCheckpointNumber;
14
+ constructor(newCheckpointNumber, previousCheckpointNumber){
15
+ super(`Cannot insert new checkpoint ${newCheckpointNumber} given previous checkpoint number in store is ${previousCheckpointNumber ?? 'undefined'}`), this.newCheckpointNumber = newCheckpointNumber, this.previousCheckpointNumber = previousCheckpointNumber;
16
+ }
17
+ }
18
+ export class CheckpointNumberNotSequentialError extends Error {
19
+ constructor(newCheckpointNumber, previous){
20
+ super(`Cannot insert new checkpoint ${newCheckpointNumber} given previous checkpoint number in batch is ${previous ?? 'undefined'}`);
21
+ }
22
+ }
23
+ export class BlockIndexNotSequentialError extends Error {
24
+ constructor(newBlockIndex, previousBlockIndex){
25
+ super(`Cannot insert new block at checkpoint index ${newBlockIndex} given previous block index is ${previousBlockIndex ?? 'undefined'}`);
26
+ }
27
+ }
28
+ export class BlockArchiveNotConsistentError extends Error {
29
+ constructor(newBlockNumber, previousBlockNumber, newBlockArchive, previousBlockArchive){
30
+ super(`Cannot insert new block number ${newBlockNumber} with archive ${newBlockArchive.toString()} previous block number is ${previousBlockNumber ?? 'undefined'}, previous archive is ${previousBlockArchive?.toString() ?? 'undefined'}`);
31
+ }
32
+ }
33
+ export class CheckpointNotFoundError extends Error {
34
+ constructor(checkpointNumber){
35
+ super(`Failed to find expected checkpoint number ${checkpointNumber}`);
36
+ }
37
+ }
38
+ export class BlockNotFoundError extends Error {
39
+ constructor(blockNumber){
40
+ super(`Failed to find expected block number ${blockNumber}`);
41
+ }
42
+ }
43
+ /** Thrown when a proposed block matches a block that was already checkpointed. This is expected for late proposals. */ export class BlockAlreadyCheckpointedError extends Error {
44
+ blockNumber;
45
+ constructor(blockNumber){
46
+ super(`Block ${blockNumber} has already been checkpointed with the same content`), this.blockNumber = blockNumber;
47
+ this.name = 'BlockAlreadyCheckpointedError';
48
+ }
49
+ }
50
+ /** Thrown when a proposed block conflicts with an already checkpointed block (different content). */ export class CannotOverwriteCheckpointedBlockError extends Error {
51
+ blockNumber;
52
+ lastCheckpointedBlock;
53
+ constructor(blockNumber, lastCheckpointedBlock){
54
+ super(`Cannot add block ${blockNumber}: would overwrite checkpointed data (checkpointed up to block ${lastCheckpointedBlock})`), this.blockNumber = blockNumber, this.lastCheckpointedBlock = lastCheckpointedBlock;
55
+ this.name = 'CannotOverwriteCheckpointedBlockError';
56
+ }
57
+ }
package/dest/factory.d.ts CHANGED
@@ -1,19 +1,21 @@
1
1
  import type { DataStoreConfig } from '@aztec/kv-store/config';
2
- import { Archiver, type ArchiverDeps } from './archiver/archiver.js';
3
- import type { ArchiverConfig } from './archiver/config.js';
4
- import { KVArchiverDataStore } from './archiver/kv_archiver_store/kv_archiver_store.js';
2
+ import type { L1RollupConstants } from '@aztec/stdlib/epoch-helpers';
3
+ import { Archiver, type ArchiverDeps } from './archiver.js';
4
+ import { type ArchiverConfig } from './config.js';
5
+ import { KVArchiverDataStore } from './store/kv_archiver_store.js';
5
6
  export declare const ARCHIVER_STORE_NAME = "archiver";
6
7
  /** Creates an archiver store. */
7
- export declare function createArchiverStore(userConfig: Pick<ArchiverConfig, 'archiverStoreMapSizeKb' | 'maxLogs'> & DataStoreConfig): Promise<KVArchiverDataStore>;
8
+ export declare function createArchiverStore(userConfig: Pick<ArchiverConfig, 'archiverStoreMapSizeKb' | 'maxLogs'> & DataStoreConfig, l1Constants: Pick<L1RollupConstants, 'epochDuration'>): Promise<KVArchiverDataStore>;
8
9
  /**
9
10
  * Creates a local archiver.
10
11
  * @param config - The archiver configuration.
11
- * @param blobSinkClient - The blob sink client.
12
+ * @param deps - The archiver dependencies (blobClient, epochCache, dateProvider, telemetry).
12
13
  * @param opts - The options.
13
- * @param telemetry - The telemetry client.
14
14
  * @returns The local archiver.
15
15
  */
16
16
  export declare function createArchiver(config: ArchiverConfig & DataStoreConfig, deps: ArchiverDeps, opts?: {
17
17
  blockUntilSync: boolean;
18
18
  }): Promise<Archiver>;
19
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmFjdG9yeS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2ZhY3RvcnkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEsT0FBTyxLQUFLLEVBQUUsZUFBZSxFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFPOUQsT0FBTyxFQUFFLFFBQVEsRUFBRSxLQUFLLFlBQVksRUFBRSxNQUFNLHdCQUF3QixDQUFDO0FBQ3JFLE9BQU8sS0FBSyxFQUFFLGNBQWMsRUFBRSxNQUFNLHNCQUFzQixDQUFDO0FBQzNELE9BQU8sRUFBdUIsbUJBQW1CLEVBQUUsTUFBTSxtREFBbUQsQ0FBQztBQUU3RyxlQUFPLE1BQU0sbUJBQW1CLGFBQWEsQ0FBQztBQUU5QyxpQ0FBaUM7QUFDakMsd0JBQXNCLG1CQUFtQixDQUN2QyxVQUFVLEVBQUUsSUFBSSxDQUFDLGNBQWMsRUFBRSx3QkFBd0IsR0FBRyxTQUFTLENBQUMsR0FBRyxlQUFlLGdDQVF6RjtBQUVEOzs7Ozs7O0dBT0c7QUFDSCx3QkFBc0IsY0FBYyxDQUNsQyxNQUFNLEVBQUUsY0FBYyxHQUFHLGVBQWUsRUFDeEMsSUFBSSxFQUFFLFlBQVksRUFDbEIsSUFBSSxHQUFFO0lBQUUsY0FBYyxFQUFFLE9BQU8sQ0FBQTtDQUE2QixHQUMzRCxPQUFPLENBQUMsUUFBUSxDQUFDLENBSW5CIn0=
19
+ /** Registers protocol contracts in the archiver store. */
20
+ export declare function registerProtocolContracts(store: KVArchiverDataStore): Promise<void>;
21
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmFjdG9yeS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2ZhY3RvcnkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBU0EsT0FBTyxLQUFLLEVBQUUsZUFBZSxFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFPOUQsT0FBTyxLQUFLLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQU1yRSxPQUFPLEVBQUUsUUFBUSxFQUFFLEtBQUssWUFBWSxFQUFFLE1BQU0sZUFBZSxDQUFDO0FBQzVELE9BQU8sRUFBRSxLQUFLLGNBQWMsRUFBcUIsTUFBTSxhQUFhLENBQUM7QUFHckUsT0FBTyxFQUF1QixtQkFBbUIsRUFBRSxNQUFNLDhCQUE4QixDQUFDO0FBR3hGLGVBQU8sTUFBTSxtQkFBbUIsYUFBYSxDQUFDO0FBRTlDLGlDQUFpQztBQUNqQyx3QkFBc0IsbUJBQW1CLENBQ3ZDLFVBQVUsRUFBRSxJQUFJLENBQUMsY0FBYyxFQUFFLHdCQUF3QixHQUFHLFNBQVMsQ0FBQyxHQUFHLGVBQWUsRUFDeEYsV0FBVyxFQUFFLElBQUksQ0FBQyxpQkFBaUIsRUFBRSxlQUFlLENBQUMsZ0NBUXREO0FBRUQ7Ozs7OztHQU1HO0FBQ0gsd0JBQXNCLGNBQWMsQ0FDbEMsTUFBTSxFQUFFLGNBQWMsR0FBRyxlQUFlLEVBQ3hDLElBQUksRUFBRSxZQUFZLEVBQ2xCLElBQUksR0FBRTtJQUFFLGNBQWMsRUFBRSxPQUFPLENBQUE7Q0FBNkIsR0FDM0QsT0FBTyxDQUFDLFFBQVEsQ0FBQyxDQXNIbkI7QUFFRCwwREFBMEQ7QUFDMUQsd0JBQXNCLHlCQUF5QixDQUFDLEtBQUssRUFBRSxtQkFBbUIsaUJBb0J6RSJ9
@@ -1 +1 @@
1
- {"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAO9D,OAAO,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAuB,mBAAmB,EAAE,MAAM,mDAAmD,CAAC;AAE7G,eAAO,MAAM,mBAAmB,aAAa,CAAC;AAE9C,iCAAiC;AACjC,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,IAAI,CAAC,cAAc,EAAE,wBAAwB,GAAG,SAAS,CAAC,GAAG,eAAe,gCAQzF;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,GAAG,eAAe,EACxC,IAAI,EAAE,YAAY,EAClB,IAAI,GAAE;IAAE,cAAc,EAAE,OAAO,CAAA;CAA6B,GAC3D,OAAO,CAAC,QAAQ,CAAC,CAInB"}
1
+ {"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAO9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAMrE,OAAO,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,KAAK,cAAc,EAAqB,MAAM,aAAa,CAAC;AAGrE,OAAO,EAAuB,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAGxF,eAAO,MAAM,mBAAmB,aAAa,CAAC;AAE9C,iCAAiC;AACjC,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,IAAI,CAAC,cAAc,EAAE,wBAAwB,GAAG,SAAS,CAAC,GAAG,eAAe,EACxF,WAAW,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,CAAC,gCAQtD;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,GAAG,eAAe,EACxC,IAAI,EAAE,YAAY,EAClB,IAAI,GAAE;IAAE,cAAc,EAAE,OAAO,CAAA;CAA6B,GAC3D,OAAO,CAAC,QAAQ,CAAC,CAsHnB;AAED,0DAA0D;AAC1D,wBAAsB,yBAAyB,CAAC,KAAK,EAAE,mBAAmB,iBAoBzE"}
package/dest/factory.js CHANGED
@@ -1,36 +1,118 @@
1
+ import { EpochCache } from '@aztec/epoch-cache';
2
+ import { createEthereumChain } from '@aztec/ethereum/chain';
3
+ import { InboxContract, RollupContract } from '@aztec/ethereum/contracts';
1
4
  import { BlockNumber } from '@aztec/foundation/branded-types';
2
- import { createLogger } from '@aztec/foundation/log';
5
+ import { Buffer32 } from '@aztec/foundation/buffer';
6
+ import { merge } from '@aztec/foundation/collection';
7
+ import { Fr } from '@aztec/foundation/curves/bn254';
8
+ import { DateProvider } from '@aztec/foundation/timer';
3
9
  import { createStore } from '@aztec/kv-store/lmdb-v2';
4
10
  import { protocolContractNames } from '@aztec/protocol-contracts';
5
11
  import { BundledProtocolContractsProvider } from '@aztec/protocol-contracts/providers/bundle';
6
12
  import { FunctionType, decodeFunctionSignature } from '@aztec/stdlib/abi';
7
13
  import { computePublicBytecodeCommitment } from '@aztec/stdlib/contract';
8
- import { Archiver } from './archiver/archiver.js';
9
- import { ARCHIVER_DB_VERSION, KVArchiverDataStore } from './archiver/kv_archiver_store/kv_archiver_store.js';
14
+ import { getTelemetryClient } from '@aztec/telemetry-client';
15
+ import { EventEmitter } from 'events';
16
+ import { createPublicClient, fallback, http } from 'viem';
17
+ import { Archiver } from './archiver.js';
18
+ import { mapArchiverConfig } from './config.js';
19
+ import { ArchiverInstrumentation } from './modules/instrumentation.js';
20
+ import { ArchiverL1Synchronizer } from './modules/l1_synchronizer.js';
21
+ import { ARCHIVER_DB_VERSION, KVArchiverDataStore } from './store/kv_archiver_store.js';
22
+ import { L2TipsCache } from './store/l2_tips_cache.js';
10
23
  export const ARCHIVER_STORE_NAME = 'archiver';
11
- /** Creates an archiver store. */ export async function createArchiverStore(userConfig) {
24
+ /** Creates an archiver store. */ export async function createArchiverStore(userConfig, l1Constants) {
12
25
  const config = {
13
26
  ...userConfig,
14
27
  dataStoreMapSizeKb: userConfig.archiverStoreMapSizeKb ?? userConfig.dataStoreMapSizeKb
15
28
  };
16
- const store = await createStore(ARCHIVER_STORE_NAME, ARCHIVER_DB_VERSION, config, createLogger('archiver:lmdb'));
17
- return new KVArchiverDataStore(store, config.maxLogs);
29
+ const store = await createStore(ARCHIVER_STORE_NAME, ARCHIVER_DB_VERSION, config);
30
+ return new KVArchiverDataStore(store, config.maxLogs, l1Constants);
18
31
  }
19
32
  /**
20
33
  * Creates a local archiver.
21
34
  * @param config - The archiver configuration.
22
- * @param blobSinkClient - The blob sink client.
35
+ * @param deps - The archiver dependencies (blobClient, epochCache, dateProvider, telemetry).
23
36
  * @param opts - The options.
24
- * @param telemetry - The telemetry client.
25
37
  * @returns The local archiver.
26
38
  */ export async function createArchiver(config, deps, opts = {
27
39
  blockUntilSync: true
28
40
  }) {
29
- const archiverStore = await createArchiverStore(config);
41
+ const archiverStore = await createArchiverStore(config, {
42
+ epochDuration: config.aztecEpochDuration
43
+ });
30
44
  await registerProtocolContracts(archiverStore);
31
- return Archiver.createAndSync(config, archiverStore, deps, opts.blockUntilSync);
45
+ // Create Ethereum clients
46
+ const chain = createEthereumChain(config.l1RpcUrls, config.l1ChainId);
47
+ const publicClient = createPublicClient({
48
+ chain: chain.chainInfo,
49
+ transport: fallback(config.l1RpcUrls.map((url)=>http(url, {
50
+ batch: false
51
+ }))),
52
+ pollingInterval: config.viemPollingIntervalMS
53
+ });
54
+ // Create debug client using debug RPC URLs if available, otherwise fall back to regular RPC URLs
55
+ const debugRpcUrls = config.l1DebugRpcUrls.length > 0 ? config.l1DebugRpcUrls : config.l1RpcUrls;
56
+ const debugClient = createPublicClient({
57
+ chain: chain.chainInfo,
58
+ transport: fallback(debugRpcUrls.map((url)=>http(url, {
59
+ batch: false
60
+ }))),
61
+ pollingInterval: config.viemPollingIntervalMS
62
+ });
63
+ // Create L1 contract instances
64
+ const rollup = new RollupContract(publicClient, config.l1Contracts.rollupAddress);
65
+ const inbox = new InboxContract(publicClient, config.l1Contracts.inboxAddress);
66
+ // Fetch L1 constants from rollup contract
67
+ const [l1StartBlock, l1GenesisTime, proofSubmissionEpochs, genesisArchiveRoot, slashingProposerAddress, targetCommitteeSize, rollupManaLimit] = await Promise.all([
68
+ rollup.getL1StartBlock(),
69
+ rollup.getL1GenesisTime(),
70
+ rollup.getProofSubmissionEpochs(),
71
+ rollup.getGenesisArchiveTreeRoot(),
72
+ rollup.getSlashingProposerAddress(),
73
+ rollup.getTargetCommitteeSize(),
74
+ rollup.getManaLimit()
75
+ ]);
76
+ const l1StartBlockHash = await publicClient.getBlock({
77
+ blockNumber: l1StartBlock,
78
+ includeTransactions: false
79
+ }).then((block)=>Buffer32.fromString(block.hash));
80
+ const { aztecEpochDuration: epochDuration, aztecSlotDuration: slotDuration, ethereumSlotDuration } = config;
81
+ const l1Constants = {
82
+ l1StartBlockHash,
83
+ l1StartBlock,
84
+ l1GenesisTime,
85
+ epochDuration,
86
+ slotDuration,
87
+ ethereumSlotDuration,
88
+ proofSubmissionEpochs: Number(proofSubmissionEpochs),
89
+ targetCommitteeSize,
90
+ genesisArchiveRoot: Fr.fromString(genesisArchiveRoot.toString()),
91
+ rollupManaLimit: Number(rollupManaLimit)
92
+ };
93
+ const archiverConfig = merge({
94
+ pollingIntervalMs: 10_000,
95
+ batchSize: 100,
96
+ maxAllowedEthClientDriftSeconds: 300,
97
+ ethereumAllowNoDebugHosts: false
98
+ }, mapArchiverConfig(config));
99
+ const epochCache = deps.epochCache ?? await EpochCache.create(config.l1Contracts.rollupAddress, config, deps);
100
+ const telemetry = deps.telemetry ?? getTelemetryClient();
101
+ const instrumentation = await ArchiverInstrumentation.new(telemetry, ()=>archiverStore.estimateSize());
102
+ // Create the event emitter that will be shared by archiver and synchronizer
103
+ const events = new EventEmitter();
104
+ // Create L2 tips cache shared by archiver and synchronizer
105
+ const l2TipsCache = new L2TipsCache(archiverStore.blockStore);
106
+ // Create the L1 synchronizer
107
+ const synchronizer = new ArchiverL1Synchronizer(publicClient, debugClient, rollup, inbox, archiverStore, archiverConfig, deps.blobClient, epochCache, deps.dateProvider ?? new DateProvider(), instrumentation, l1Constants, events, instrumentation.tracer, l2TipsCache, undefined);
108
+ const archiver = new Archiver(publicClient, debugClient, rollup, {
109
+ ...config.l1Contracts,
110
+ slashingProposerAddress
111
+ }, archiverStore, archiverConfig, deps.blobClient, instrumentation, l1Constants, synchronizer, events, l2TipsCache);
112
+ await archiver.start(opts.blockUntilSync);
113
+ return archiver;
32
114
  }
33
- async function registerProtocolContracts(store) {
115
+ /** Registers protocol contracts in the archiver store. */ export async function registerProtocolContracts(store) {
34
116
  const blockNumber = 0;
35
117
  for (const name of protocolContractNames){
36
118
  const provider = new BundledProtocolContractsProvider();
package/dest/index.d.ts CHANGED
@@ -1,5 +1,12 @@
1
- export * from './archiver/index.js';
2
1
  export * from './factory.js';
3
- export * from './rpc/index.js';
4
- export { retrieveCheckpointsFromRollup, retrieveL2ProofVerifiedEvents } from './archiver/l1/data_retrieval.js';
5
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLHFCQUFxQixDQUFDO0FBQ3BDLGNBQWMsY0FBYyxDQUFDO0FBQzdCLGNBQWMsZ0JBQWdCLENBQUM7QUFFL0IsT0FBTyxFQUFFLDZCQUE2QixFQUFFLDZCQUE2QixFQUFFLE1BQU0saUNBQWlDLENBQUMifQ==
2
+ export * from './interfaces.js';
3
+ export * from './archiver.js';
4
+ export * from './modules/data_source_base.js';
5
+ export * from './modules/data_store_updater.js';
6
+ export * from './config.js';
7
+ export { type L1PublishedData } from './structs/published.js';
8
+ export { KVArchiverDataStore, ARCHIVER_DB_VERSION } from './store/kv_archiver_store.js';
9
+ export { ContractInstanceStore } from './store/contract_instance_store.js';
10
+ export { L2TipsCache } from './store/l2_tips_cache.js';
11
+ export { retrieveCheckpointsFromRollup, retrieveL2ProofVerifiedEvents } from './l1/data_retrieval.js';
12
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLGNBQWMsQ0FBQztBQUM3QixjQUFjLGlCQUFpQixDQUFDO0FBQ2hDLGNBQWMsZUFBZSxDQUFDO0FBQzlCLGNBQWMsK0JBQStCLENBQUM7QUFDOUMsY0FBYyxpQ0FBaUMsQ0FBQztBQUNoRCxjQUFjLGFBQWEsQ0FBQztBQUU1QixPQUFPLEVBQUUsS0FBSyxlQUFlLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUM5RCxPQUFPLEVBQUUsbUJBQW1CLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSw4QkFBOEIsQ0FBQztBQUN4RixPQUFPLEVBQUUscUJBQXFCLEVBQUUsTUFBTSxvQ0FBb0MsQ0FBQztBQUMzRSxPQUFPLEVBQUUsV0FBVyxFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUFFdkQsT0FBTyxFQUFFLDZCQUE2QixFQUFFLDZCQUE2QixFQUFFLE1BQU0sd0JBQXdCLENBQUMifQ==
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAE/B,OAAO,EAAE,6BAA6B,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,aAAa,CAAC;AAE5B,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACxF,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,OAAO,EAAE,6BAA6B,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC"}
package/dest/index.js CHANGED
@@ -1,4 +1,10 @@
1
- export * from './archiver/index.js';
2
1
  export * from './factory.js';
3
- export * from './rpc/index.js';
4
- export { retrieveCheckpointsFromRollup, retrieveL2ProofVerifiedEvents } from './archiver/l1/data_retrieval.js';
2
+ export * from './interfaces.js';
3
+ export * from './archiver.js';
4
+ export * from './modules/data_source_base.js';
5
+ export * from './modules/data_store_updater.js';
6
+ export * from './config.js';
7
+ export { KVArchiverDataStore, ARCHIVER_DB_VERSION } from './store/kv_archiver_store.js';
8
+ export { ContractInstanceStore } from './store/contract_instance_store.js';
9
+ export { L2TipsCache } from './store/l2_tips_cache.js';
10
+ export { retrieveCheckpointsFromRollup, retrieveL2ProofVerifiedEvents } from './l1/data_retrieval.js';
@@ -0,0 +1,9 @@
1
+ import type { L2BlockSource } from '@aztec/stdlib/block';
2
+ import type { ContractDataSource } from '@aztec/stdlib/contract';
3
+ import type { L2LogsSource } from '@aztec/stdlib/interfaces/server';
4
+ import type { L1ToL2MessageSource } from '@aztec/stdlib/messaging';
5
+ /**
6
+ * Helper interface to combine all sources this archiver implementation provides.
7
+ */
8
+ export type ArchiverDataSource = L2BlockSource & L2LogsSource & ContractDataSource & L1ToL2MessageSource;
9
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlcy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2ludGVyZmFjZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsYUFBYSxFQUFFLE1BQU0scUJBQXFCLENBQUM7QUFDekQsT0FBTyxLQUFLLEVBQUUsa0JBQWtCLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUNqRSxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUNwRSxPQUFPLEtBQUssRUFBRSxtQkFBbUIsRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBRW5FOztHQUVHO0FBQ0gsTUFBTSxNQUFNLGtCQUFrQixHQUFHLGFBQWEsR0FBRyxZQUFZLEdBQUcsa0JBQWtCLEdBQUcsbUJBQW1CLENBQUMifQ==
@@ -0,0 +1 @@
1
+ {"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG,YAAY,GAAG,kBAAkB,GAAG,mBAAmB,CAAC"}
@@ -0,0 +1,3 @@
1
+ /**
2
+ * Helper interface to combine all sources this archiver implementation provides.
3
+ */ export { };
@@ -1,3 +1,3 @@
1
1
  #!/usr/bin/env node
2
2
  export {};
3
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmV0cmlldmUtY2FsbGRhdGEuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9hcmNoaXZlci9sMS9iaW4vcmV0cmlldmUtY2FsbGRhdGEudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiJ9
3
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmV0cmlldmUtY2FsbGRhdGEuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9sMS9iaW4vcmV0cmlldmUtY2FsbGRhdGEudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiJ9
@@ -0,0 +1 @@
1
+ {"version":3,"file":"retrieve-calldata.d.ts","sourceRoot":"","sources":["../../../src/l1/bin/retrieve-calldata.ts"],"names":[],"mappings":""}
@@ -2,7 +2,8 @@
2
2
  import { CheckpointNumber } from '@aztec/foundation/branded-types';
3
3
  import { EthAddress } from '@aztec/foundation/eth-address';
4
4
  import { createLogger } from '@aztec/foundation/log';
5
- import { createPublicClient, http } from 'viem';
5
+ import { RollupAbi } from '@aztec/l1-artifacts/RollupAbi';
6
+ import { createPublicClient, decodeEventLog, getAbiItem, http, toEventSelector } from 'viem';
6
7
  import { mainnet } from 'viem/chains';
7
8
  import { CalldataRetriever } from '../calldata_retriever.js';
8
9
  const logger = createLogger('archiver:calldata-test');
@@ -61,7 +62,9 @@ async function main() {
61
62
  // Create viem public client
62
63
  const publicClient = createPublicClient({
63
64
  chain: mainnet,
64
- transport: http(rpcUrl)
65
+ transport: http(rpcUrl, {
66
+ batch: false
67
+ })
65
68
  });
66
69
  logger.info('Fetching transaction...');
67
70
  const tx = await publicClient.getTransaction({
@@ -71,49 +74,51 @@ async function main() {
71
74
  throw new Error(`Transaction ${txHash} not found`);
72
75
  }
73
76
  logger.info(`Transaction found in block ${tx.blockNumber}`);
74
- // For simplicity, use zero addresses for optional contract addresses
75
- // In production, these would be fetched from the rollup contract or configuration
76
- const slashingProposerAddress = EthAddress.ZERO;
77
- const governanceProposerAddress = EthAddress.ZERO;
78
- const slashFactoryAddress = undefined;
79
- logger.info('Using zero addresses for governance/slashing (can be configured if needed)');
80
77
  // Create CalldataRetriever
81
- const retriever = new CalldataRetriever(publicClient, publicClient, targetCommitteeSize, undefined, logger, {
82
- rollupAddress,
83
- governanceProposerAddress,
84
- slashingProposerAddress,
85
- slashFactoryAddress
86
- });
87
- // Extract L2 block number from transaction logs
88
- logger.info('Decoding transaction to extract L2 block number...');
78
+ const retriever = new CalldataRetriever(publicClient, publicClient, targetCommitteeSize, undefined, logger, rollupAddress);
79
+ // Extract checkpoint number and hashes from transaction logs
80
+ logger.info('Decoding transaction to extract checkpoint number and hashes...');
89
81
  const receipt = await publicClient.getTransactionReceipt({
90
82
  hash: txHash
91
83
  });
92
- const l2BlockProposedEvent = receipt.logs.find((log)=>{
84
+ // Look for CheckpointProposed event
85
+ const checkpointProposedEventAbi = getAbiItem({
86
+ abi: RollupAbi,
87
+ name: 'CheckpointProposed'
88
+ });
89
+ const checkpointProposedLog = receipt.logs.find((log)=>{
93
90
  try {
94
- // Try to match the L2BlockProposed event
95
- return log.address.toLowerCase() === rollupAddress.toString().toLowerCase() && log.topics[0] === '0x2f1d0e696fa5186494a2f2f89a0e0bcbb15d607f6c5eac4637e07e1e5e7d3c00' // L2BlockProposed event signature
96
- ;
91
+ return log.address.toLowerCase() === rollupAddress.toString().toLowerCase() && log.topics[0] === toEventSelector(checkpointProposedEventAbi);
97
92
  } catch {
98
93
  return false;
99
94
  }
100
95
  });
101
- let l2BlockNumber;
102
- if (l2BlockProposedEvent && l2BlockProposedEvent.topics[1]) {
103
- // L2 block number is typically the first indexed parameter
104
- l2BlockNumber = Number(BigInt(l2BlockProposedEvent.topics[1]));
105
- logger.info(`L2 Block Number (from event): ${l2BlockNumber}`);
106
- } else {
107
- // Fallback: try to extract from transaction data or use a default
108
- logger.warn('Could not extract L2 block number from event, using block number as fallback');
109
- l2BlockNumber = Number(tx.blockNumber);
96
+ if (!checkpointProposedLog || checkpointProposedLog.topics[1] === undefined) {
97
+ throw new Error(`Checkpoint proposed event not found`);
98
+ }
99
+ const checkpointNumber = CheckpointNumber.fromBigInt(BigInt(checkpointProposedLog.topics[1]));
100
+ // Decode the full event to extract attestationsHash and payloadDigest
101
+ const decodedEvent = decodeEventLog({
102
+ abi: RollupAbi,
103
+ data: checkpointProposedLog.data,
104
+ topics: checkpointProposedLog.topics
105
+ });
106
+ const eventArgs = decodedEvent.args;
107
+ if (!eventArgs.attestationsHash || !eventArgs.payloadDigest) {
108
+ throw new Error(`CheckpointProposed event missing attestationsHash or payloadDigest`);
110
109
  }
110
+ const expectedHashes = {
111
+ attestationsHash: eventArgs.attestationsHash,
112
+ payloadDigest: eventArgs.payloadDigest
113
+ };
114
+ logger.info(`Checkpoint Number: ${checkpointNumber}`);
115
+ logger.info(`Attestations Hash: ${expectedHashes.attestationsHash}`);
116
+ logger.info(`Payload Digest: ${expectedHashes.payloadDigest}`);
111
117
  logger.info('');
112
- logger.info('Retrieving block header from rollup transaction...');
118
+ logger.info('Retrieving checkpoint from rollup transaction...');
113
119
  logger.info('');
114
- // For this script, we don't have blob hashes, so pass empty array
115
- const result = await retriever.getCheckpointFromRollupTx(txHash, [], CheckpointNumber(l2BlockNumber));
116
- logger.info(' Successfully retrieved block header!');
120
+ const result = await retriever.getCheckpointFromRollupTx(txHash, [], checkpointNumber, expectedHashes);
121
+ logger.info(' Successfully retrieved block header!');
117
122
  logger.info('');
118
123
  logger.info('Block Header Details:');
119
124
  logger.info('====================');