@aztec/archiver 5.0.0-private.20260319 → 5.0.0-rc.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (121) hide show
  1. package/README.md +19 -13
  2. package/dest/archiver.d.ts +71 -15
  3. package/dest/archiver.d.ts.map +1 -1
  4. package/dest/archiver.js +268 -74
  5. package/dest/config.d.ts +7 -3
  6. package/dest/config.d.ts.map +1 -1
  7. package/dest/config.js +39 -16
  8. package/dest/errors.d.ts +44 -10
  9. package/dest/errors.d.ts.map +1 -1
  10. package/dest/errors.js +66 -12
  11. package/dest/factory.d.ts +12 -7
  12. package/dest/factory.d.ts.map +1 -1
  13. package/dest/factory.js +40 -25
  14. package/dest/index.d.ts +11 -3
  15. package/dest/index.d.ts.map +1 -1
  16. package/dest/index.js +10 -2
  17. package/dest/l1/calldata_retriever.d.ts +2 -1
  18. package/dest/l1/calldata_retriever.d.ts.map +1 -1
  19. package/dest/l1/calldata_retriever.js +15 -5
  20. package/dest/l1/data_retrieval.d.ts +19 -10
  21. package/dest/l1/data_retrieval.d.ts.map +1 -1
  22. package/dest/l1/data_retrieval.js +25 -32
  23. package/dest/l1/trace_tx.d.ts +12 -66
  24. package/dest/l1/trace_tx.d.ts.map +1 -1
  25. package/dest/l1/validate_historical_logs.d.ts +23 -0
  26. package/dest/l1/validate_historical_logs.d.ts.map +1 -0
  27. package/dest/l1/validate_historical_logs.js +108 -0
  28. package/dest/modules/contract_data_source_adapter.d.ts +25 -0
  29. package/dest/modules/contract_data_source_adapter.d.ts.map +1 -0
  30. package/dest/modules/contract_data_source_adapter.js +32 -0
  31. package/dest/modules/data_source_base.d.ts +72 -48
  32. package/dest/modules/data_source_base.d.ts.map +1 -1
  33. package/dest/modules/data_source_base.js +266 -143
  34. package/dest/modules/data_store_updater.d.ts +30 -13
  35. package/dest/modules/data_store_updater.d.ts.map +1 -1
  36. package/dest/modules/data_store_updater.js +172 -117
  37. package/dest/modules/instrumentation.d.ts +7 -2
  38. package/dest/modules/instrumentation.d.ts.map +1 -1
  39. package/dest/modules/instrumentation.js +25 -7
  40. package/dest/modules/l1_synchronizer.d.ts +11 -6
  41. package/dest/modules/l1_synchronizer.d.ts.map +1 -1
  42. package/dest/modules/l1_synchronizer.js +437 -217
  43. package/dest/modules/outbox_trees_resolver.d.ts +62 -0
  44. package/dest/modules/outbox_trees_resolver.d.ts.map +1 -0
  45. package/dest/modules/outbox_trees_resolver.js +162 -0
  46. package/dest/modules/validation.d.ts +24 -5
  47. package/dest/modules/validation.d.ts.map +1 -1
  48. package/dest/modules/validation.js +40 -15
  49. package/dest/store/block_store.d.ts +164 -66
  50. package/dest/store/block_store.d.ts.map +1 -1
  51. package/dest/store/block_store.js +638 -233
  52. package/dest/store/contract_class_store.d.ts +17 -4
  53. package/dest/store/contract_class_store.d.ts.map +1 -1
  54. package/dest/store/contract_class_store.js +36 -68
  55. package/dest/store/contract_instance_store.d.ts +28 -1
  56. package/dest/store/contract_instance_store.d.ts.map +1 -1
  57. package/dest/store/contract_instance_store.js +48 -2
  58. package/dest/store/data_stores.d.ts +68 -0
  59. package/dest/store/data_stores.d.ts.map +1 -0
  60. package/dest/store/data_stores.js +54 -0
  61. package/dest/store/function_names_cache.d.ts +17 -0
  62. package/dest/store/function_names_cache.d.ts.map +1 -0
  63. package/dest/store/function_names_cache.js +30 -0
  64. package/dest/store/l2_tips_cache.d.ts +13 -7
  65. package/dest/store/l2_tips_cache.d.ts.map +1 -1
  66. package/dest/store/l2_tips_cache.js +13 -76
  67. package/dest/store/log_store.d.ts +42 -40
  68. package/dest/store/log_store.d.ts.map +1 -1
  69. package/dest/store/log_store.js +257 -480
  70. package/dest/store/log_store_codec.d.ts +78 -0
  71. package/dest/store/log_store_codec.d.ts.map +1 -0
  72. package/dest/store/log_store_codec.js +110 -0
  73. package/dest/store/message_store.d.ts +9 -3
  74. package/dest/store/message_store.d.ts.map +1 -1
  75. package/dest/store/message_store.js +39 -10
  76. package/dest/test/fake_l1_state.d.ts +15 -3
  77. package/dest/test/fake_l1_state.d.ts.map +1 -1
  78. package/dest/test/fake_l1_state.js +80 -18
  79. package/dest/test/mock_l2_block_source.d.ts +48 -50
  80. package/dest/test/mock_l2_block_source.d.ts.map +1 -1
  81. package/dest/test/mock_l2_block_source.js +223 -179
  82. package/dest/test/mock_structs.d.ts +1 -1
  83. package/dest/test/mock_structs.d.ts.map +1 -1
  84. package/dest/test/mock_structs.js +2 -2
  85. package/dest/test/noop_l1_archiver.d.ts +14 -6
  86. package/dest/test/noop_l1_archiver.d.ts.map +1 -1
  87. package/dest/test/noop_l1_archiver.js +25 -9
  88. package/package.json +14 -14
  89. package/src/archiver.ts +353 -80
  90. package/src/config.ts +43 -20
  91. package/src/errors.ts +103 -18
  92. package/src/factory.ts +56 -24
  93. package/src/index.ts +18 -2
  94. package/src/l1/calldata_retriever.ts +16 -5
  95. package/src/l1/data_retrieval.ts +38 -46
  96. package/src/l1/validate_historical_logs.ts +140 -0
  97. package/src/modules/contract_data_source_adapter.ts +46 -0
  98. package/src/modules/data_source_base.ts +340 -189
  99. package/src/modules/data_store_updater.ts +211 -148
  100. package/src/modules/instrumentation.ts +28 -8
  101. package/src/modules/l1_synchronizer.ts +583 -255
  102. package/src/modules/outbox_trees_resolver.ts +199 -0
  103. package/src/modules/validation.ts +81 -21
  104. package/src/store/block_store.ts +792 -285
  105. package/src/store/contract_class_store.ts +43 -103
  106. package/src/store/contract_instance_store.ts +62 -5
  107. package/src/store/data_stores.ts +104 -0
  108. package/src/store/function_names_cache.ts +37 -0
  109. package/src/store/l2_tips_cache.ts +16 -70
  110. package/src/store/log_store.ts +296 -652
  111. package/src/store/log_store_codec.ts +143 -0
  112. package/src/store/message_store.ts +43 -12
  113. package/src/structs/inbox_message.ts +1 -1
  114. package/src/test/fake_l1_state.ts +99 -27
  115. package/src/test/mock_l2_block_source.ts +279 -233
  116. package/src/test/mock_structs.ts +5 -2
  117. package/src/test/noop_l1_archiver.ts +52 -9
  118. package/dest/store/kv_archiver_store.d.ts +0 -367
  119. package/dest/store/kv_archiver_store.d.ts.map +0 -1
  120. package/dest/store/kv_archiver_store.js +0 -481
  121. package/src/store/kv_archiver_store.ts +0 -697
@@ -1,11 +1,13 @@
1
1
  import { SlotNumber } from '@aztec/foundation/branded-types';
2
2
  import { Buffer32 } from '@aztec/foundation/buffer';
3
3
  import { EthAddress } from '@aztec/foundation/eth-address';
4
+ import { DateProvider } from '@aztec/foundation/timer';
4
5
  import { getTelemetryClient } from '@aztec/telemetry-client';
5
6
  import { mock } from 'jest-mock-extended';
6
7
  import { EventEmitter } from 'node:events';
7
8
  import { Archiver } from '../archiver.js';
8
9
  import { ArchiverInstrumentation } from '../modules/instrumentation.js';
10
+ import { L2TipsCache } from '../store/l2_tips_cache.js';
9
11
  /** Noop L1 synchronizer for testing without L1 connectivity. */ class NoopL1Synchronizer {
10
12
  tracer;
11
13
  constructor(tracer){
@@ -30,32 +32,40 @@ import { ArchiverInstrumentation } from '../modules/instrumentation.js';
30
32
  * Uses mock L1 clients and a noop synchronizer, enabling tests that
31
33
  * don't require real Ethereum connectivity.
32
34
  */ export class NoopL1Archiver extends Archiver {
33
- constructor(dataStore, l1Constants, instrumentation){
35
+ constructor(dataStores, l1Constants, instrumentation, initialHeader, initialBlockHash, l2TipsCache, dateProvider = new DateProvider(), configOverrides = {}){
34
36
  // Create mocks for L1 clients
35
37
  const publicClient = mock();
36
38
  const debugClient = mock();
37
39
  const rollup = mock();
40
+ const outbox = mock();
38
41
  const blobClient = mock();
39
42
  // Mock methods called during start()
40
43
  blobClient.testSources.mockResolvedValue();
41
44
  publicClient.getBlockNumber.mockResolvedValue(1n);
42
45
  const events = new EventEmitter();
43
46
  const synchronizer = new NoopL1Synchronizer(instrumentation.tracer);
44
- super(publicClient, debugClient, rollup, {
47
+ super(publicClient, debugClient, rollup, outbox, {
48
+ rollupAddress: EthAddress.ZERO,
45
49
  registryAddress: EthAddress.ZERO,
50
+ inboxAddress: EthAddress.ZERO,
46
51
  governanceProposerAddress: EthAddress.ZERO,
47
- slashFactoryAddress: EthAddress.ZERO,
48
52
  slashingProposerAddress: EthAddress.ZERO
49
- }, dataStore, {
53
+ }, dataStores, {
50
54
  pollingIntervalMs: 1000,
51
55
  batchSize: 100,
52
56
  skipValidateCheckpointAttestations: true,
53
57
  maxAllowedEthClientDriftSeconds: 300,
54
- ethereumAllowNoDebugHosts: true
58
+ ethereumAllowNoDebugHosts: true,
59
+ skipHistoricalLogsCheck: true,
60
+ checkpointProposalSyncGrace: 4,
61
+ orphanPruneNoProposalTolerance: 1,
62
+ skipOrphanProposedBlockPruning: true,
63
+ blockDuration: 2,
64
+ ...configOverrides
55
65
  }, blobClient, instrumentation, {
56
66
  ...l1Constants,
57
67
  l1StartBlockHash: Buffer32.random()
58
- }, synchronizer, events);
68
+ }, synchronizer, events, initialHeader, initialBlockHash, l2TipsCache, dateProvider);
59
69
  }
60
70
  /** Override start to skip L1 validation checks. */ start(_blockUntilSynced) {
61
71
  // Just start the running promise without L1 checks
@@ -66,7 +76,13 @@ import { ArchiverInstrumentation } from '../modules/instrumentation.js';
66
76
  return Promise.resolve(SlotNumber(Number.MAX_SAFE_INTEGER));
67
77
  }
68
78
  }
69
- /** Creates an archiver with mocked L1 connectivity for testing. */ export async function createNoopL1Archiver(dataStore, l1Constants, telemetry = getTelemetryClient()) {
70
- const instrumentation = await ArchiverInstrumentation.new(telemetry, ()=>dataStore.estimateSize());
71
- return new NoopL1Archiver(dataStore, l1Constants, instrumentation);
79
+ /** Creates an archiver with mocked L1 connectivity for testing. */ export async function createNoopL1Archiver(dataStores, l1Constants, telemetry = getTelemetryClient(), initialHeader, dateProvider, configOverrides) {
80
+ const instrumentation = await ArchiverInstrumentation.new(telemetry, ()=>dataStores.db.estimateSize());
81
+ // Mirror the production factory: precompute the dynamic genesis block hash from the injected
82
+ // initial header so `L2TipsCache` reports the correct tip hash at block 0. Without this, the
83
+ // cache falls back to the static `GENESIS_BLOCK_HEADER_HASH`, which only matches deployments
84
+ // with default empty genesis.
85
+ const initialBlockHash = await initialHeader.hash();
86
+ const l2TipsCache = new L2TipsCache(dataStores.blocks, initialBlockHash);
87
+ return new NoopL1Archiver(dataStores, l1Constants, instrumentation, initialHeader, initialBlockHash, l2TipsCache, dateProvider, configOverrides);
72
88
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aztec/archiver",
3
- "version": "5.0.0-private.20260319",
3
+ "version": "5.0.0-rc.2",
4
4
  "type": "module",
5
5
  "exports": {
6
6
  ".": "./dest/index.js",
@@ -65,23 +65,23 @@
65
65
  ]
66
66
  },
67
67
  "dependencies": {
68
- "@aztec/blob-client": "5.0.0-private.20260319",
69
- "@aztec/blob-lib": "5.0.0-private.20260319",
70
- "@aztec/constants": "5.0.0-private.20260319",
71
- "@aztec/epoch-cache": "5.0.0-private.20260319",
72
- "@aztec/ethereum": "5.0.0-private.20260319",
73
- "@aztec/foundation": "5.0.0-private.20260319",
74
- "@aztec/kv-store": "5.0.0-private.20260319",
75
- "@aztec/l1-artifacts": "5.0.0-private.20260319",
76
- "@aztec/noir-protocol-circuits-types": "5.0.0-private.20260319",
77
- "@aztec/protocol-contracts": "5.0.0-private.20260319",
78
- "@aztec/stdlib": "5.0.0-private.20260319",
79
- "@aztec/telemetry-client": "5.0.0-private.20260319",
68
+ "@aztec/blob-client": "5.0.0-rc.2",
69
+ "@aztec/blob-lib": "5.0.0-rc.2",
70
+ "@aztec/constants": "5.0.0-rc.2",
71
+ "@aztec/epoch-cache": "5.0.0-rc.2",
72
+ "@aztec/ethereum": "5.0.0-rc.2",
73
+ "@aztec/foundation": "5.0.0-rc.2",
74
+ "@aztec/kv-store": "5.0.0-rc.2",
75
+ "@aztec/l1-artifacts": "5.0.0-rc.2",
76
+ "@aztec/noir-protocol-circuits-types": "5.0.0-rc.2",
77
+ "@aztec/protocol-contracts": "5.0.0-rc.2",
78
+ "@aztec/stdlib": "5.0.0-rc.2",
79
+ "@aztec/telemetry-client": "5.0.0-rc.2",
80
80
  "lodash.groupby": "^4.6.0",
81
81
  "lodash.omit": "^4.5.0",
82
82
  "tslib": "^2.5.0",
83
83
  "viem": "npm:@aztec/viem@2.38.2",
84
- "zod": "^3.23.8"
84
+ "zod": "^4"
85
85
  },
86
86
  "devDependencies": {
87
87
  "@jest/globals": "^30.0.0",