@aztec/archiver 0.0.1-commit.b33fc05d0 → 0.0.1-commit.b3d3157a

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (121) hide show
  1. package/README.md +19 -11
  2. package/dest/archiver.d.ts +53 -16
  3. package/dest/archiver.d.ts.map +1 -1
  4. package/dest/archiver.js +248 -76
  5. package/dest/config.d.ts +4 -1
  6. package/dest/config.d.ts.map +1 -1
  7. package/dest/config.js +21 -14
  8. package/dest/errors.d.ts +50 -2
  9. package/dest/errors.d.ts.map +1 -1
  10. package/dest/errors.js +74 -2
  11. package/dest/factory.d.ts +13 -7
  12. package/dest/factory.d.ts.map +1 -1
  13. package/dest/factory.js +46 -32
  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 +40 -0
  31. package/dest/modules/data_source_base.d.ts +71 -47
  32. package/dest/modules/data_source_base.d.ts.map +1 -1
  33. package/dest/modules/data_source_base.js +269 -137
  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 +166 -116
  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 +414 -213
  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 +4 -3
  47. package/dest/modules/validation.d.ts.map +1 -1
  48. package/dest/modules/validation.js +6 -6
  49. package/dest/store/block_store.d.ts +165 -66
  50. package/dest/store/block_store.d.ts.map +1 -1
  51. package/dest/store/block_store.js +648 -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 +24 -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 +37 -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 -37
  68. package/dest/store/log_store.d.ts.map +1 -1
  69. package/dest/store/log_store.js +262 -408
  70. package/dest/store/log_store_codec.d.ts +70 -0
  71. package/dest/store/log_store_codec.d.ts.map +1 -0
  72. package/dest/store/log_store_codec.js +101 -0
  73. package/dest/store/message_store.d.ts +11 -1
  74. package/dest/store/message_store.d.ts.map +1 -1
  75. package/dest/store/message_store.js +50 -8
  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 +88 -18
  79. package/dest/test/mock_l1_to_l2_message_source.d.ts +1 -1
  80. package/dest/test/mock_l1_to_l2_message_source.d.ts.map +1 -1
  81. package/dest/test/mock_l1_to_l2_message_source.js +2 -1
  82. package/dest/test/mock_l2_block_source.d.ts +51 -50
  83. package/dest/test/mock_l2_block_source.d.ts.map +1 -1
  84. package/dest/test/mock_l2_block_source.js +244 -181
  85. package/dest/test/noop_l1_archiver.d.ts +10 -6
  86. package/dest/test/noop_l1_archiver.d.ts.map +1 -1
  87. package/dest/test/noop_l1_archiver.js +22 -9
  88. package/package.json +14 -14
  89. package/src/archiver.ts +315 -83
  90. package/src/config.ts +24 -11
  91. package/src/errors.ts +117 -2
  92. package/src/factory.ts +54 -28
  93. package/src/index.ts +18 -2
  94. package/src/l1/calldata_retriever.ts +16 -5
  95. package/src/l1/data_retrieval.ts +36 -45
  96. package/src/l1/validate_historical_logs.ts +140 -0
  97. package/src/modules/contract_data_source_adapter.ts +55 -0
  98. package/src/modules/data_source_base.ts +341 -174
  99. package/src/modules/data_store_updater.ts +201 -147
  100. package/src/modules/instrumentation.ts +28 -8
  101. package/src/modules/l1_synchronizer.ts +549 -254
  102. package/src/modules/outbox_trees_resolver.ts +199 -0
  103. package/src/modules/validation.ts +10 -9
  104. package/src/store/block_store.ts +807 -285
  105. package/src/store/contract_class_store.ts +31 -103
  106. package/src/store/contract_instance_store.ts +51 -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 +301 -559
  111. package/src/store/log_store_codec.ts +132 -0
  112. package/src/store/message_store.ts +59 -9
  113. package/src/structs/inbox_message.ts +1 -1
  114. package/src/test/fake_l1_state.ts +111 -29
  115. package/src/test/mock_l1_to_l2_message_source.ts +1 -0
  116. package/src/test/mock_l2_block_source.ts +299 -232
  117. package/src/test/noop_l1_archiver.ts +42 -9
  118. package/dest/store/kv_archiver_store.d.ts +0 -363
  119. package/dest/store/kv_archiver_store.d.ts.map +0 -1
  120. package/dest/store/kv_archiver_store.js +0 -476
  121. package/src/store/kv_archiver_store.ts +0 -689
package/src/config.ts CHANGED
@@ -1,12 +1,12 @@
1
1
  import { type BlobClientConfig, blobClientConfigMapping } from '@aztec/blob-client/client/config';
2
2
  import { type L1ContractsConfig, l1ContractsConfigMappings } from '@aztec/ethereum/config';
3
- import { l1ContractAddressesMapping } from '@aztec/ethereum/l1-contract-addresses';
4
3
  import { type L1ReaderConfig, l1ReaderConfigMappings } from '@aztec/ethereum/l1-reader';
5
4
  import {
6
5
  type ConfigMappingsType,
7
6
  booleanConfigHelper,
8
7
  getConfigFromMappings,
9
8
  numberConfigHelper,
9
+ optionalNumberConfigHelper,
10
10
  } from '@aztec/foundation/config';
11
11
  import { type ChainConfig, chainConfigMappings } from '@aztec/stdlib/config';
12
12
  import type { ArchiverSpecificConfig } from '@aztec/stdlib/interfaces/server';
@@ -36,20 +36,19 @@ export const archiverConfigMappings: ConfigMappingsType<ArchiverConfig> = {
36
36
  description: 'The number of L2 blocks the archiver will attempt to download at a time.',
37
37
  ...numberConfigHelper(100),
38
38
  },
39
- maxLogs: {
40
- env: 'ARCHIVER_MAX_LOGS',
41
- description: 'The max number of logs that can be obtained in 1 "getPublicLogs" call.',
42
- ...numberConfigHelper(1_000),
43
- },
44
39
  archiverStoreMapSizeKb: {
45
40
  env: 'ARCHIVER_STORE_MAP_SIZE_KB',
46
- parseEnv: (val: string | undefined) => (val ? +val : undefined),
41
+ ...optionalNumberConfigHelper(),
47
42
  description: 'The maximum possible size of the archiver DB in KB. Overwrites the general dataStoreMapSizeKb.',
48
43
  },
49
44
  skipValidateCheckpointAttestations: {
50
45
  description: 'Skip validating checkpoint attestations (for testing purposes only)',
51
46
  ...booleanConfigHelper(false),
52
47
  },
48
+ skipPromoteProposedCheckpointDuringL1Sync: {
49
+ description: 'Skip promoting proposed checkpoints during L1 sync (for testing purposes only)',
50
+ ...booleanConfigHelper(false),
51
+ },
53
52
  maxAllowedEthClientDriftSeconds: {
54
53
  env: 'MAX_ALLOWED_ETH_CLIENT_DRIFT_SECONDS',
55
54
  description: 'Maximum allowed drift in seconds between the Ethereum client and current time.',
@@ -60,6 +59,21 @@ export const archiverConfigMappings: ConfigMappingsType<ArchiverConfig> = {
60
59
  description: 'Whether to allow starting the archiver without debug/trace method support on Ethereum hosts',
61
60
  ...booleanConfigHelper(true),
62
61
  },
62
+ archiverSkipHistoricalLogsCheck: {
63
+ env: 'ARCHIVER_SKIP_HISTORICAL_LOGS_CHECK',
64
+ description:
65
+ 'Skip the startup check that probes the L1 RPC for historical Rollup contract logs. ' +
66
+ 'Set to true to bypass the check when the connected RPC node is known to prune old logs.',
67
+ ...booleanConfigHelper(false),
68
+ },
69
+ orphanProposedBlockPruneGraceSeconds: {
70
+ env: 'ARCHIVER_ORPHAN_PROPOSED_BLOCK_PRUNE_GRACE_SECONDS',
71
+ description:
72
+ 'Grace period in seconds, measured from the end of a proposed block build slot, after which a ' +
73
+ 'proposed block with no matching proposed checkpoint is pruned as an orphan. Defaults from the ' +
74
+ 'sequencer block duration at the node wiring layer when unset.',
75
+ ...optionalNumberConfigHelper(),
76
+ },
63
77
  ...chainConfigMappings,
64
78
  ...l1ReaderConfigMappings,
65
79
  viemPollingIntervalMS: {
@@ -68,10 +82,6 @@ export const archiverConfigMappings: ConfigMappingsType<ArchiverConfig> = {
68
82
  ...numberConfigHelper(1000),
69
83
  },
70
84
  ...l1ContractsConfigMappings,
71
- l1Contracts: {
72
- description: 'The deployed L1 contract addresses',
73
- nested: l1ContractAddressesMapping,
74
- },
75
85
  };
76
86
 
77
87
  /**
@@ -89,7 +99,10 @@ export function mapArchiverConfig(config: Partial<ArchiverConfig>) {
89
99
  pollingIntervalMs: config.archiverPollingIntervalMS,
90
100
  batchSize: config.archiverBatchSize,
91
101
  skipValidateCheckpointAttestations: config.skipValidateCheckpointAttestations,
102
+ skipPromoteProposedCheckpointDuringL1Sync: config.skipPromoteProposedCheckpointDuringL1Sync,
92
103
  maxAllowedEthClientDriftSeconds: config.maxAllowedEthClientDriftSeconds,
93
104
  ethereumAllowNoDebugHosts: config.ethereumAllowNoDebugHosts,
105
+ skipHistoricalLogsCheck: config.archiverSkipHistoricalLogsCheck,
106
+ orphanProposedBlockPruneGraceSeconds: config.orphanProposedBlockPruneGraceSeconds,
94
107
  };
95
108
  }
package/src/errors.ts CHANGED
@@ -1,14 +1,17 @@
1
+ import type { BlockNumber, CheckpointNumber } from '@aztec/foundation/branded-types';
1
2
  import type { Fr } from '@aztec/foundation/schemas';
2
3
 
3
4
  export class NoBlobBodiesFoundError extends Error {
4
5
  constructor(l2BlockNum: number) {
5
6
  super(`No blob bodies found for block ${l2BlockNum}`);
7
+ this.name = 'NoBlobBodiesFoundError';
6
8
  }
7
9
  }
8
10
 
9
11
  export class BlockNumberNotSequentialError extends Error {
10
12
  constructor(newBlockNumber: number, previous: number | undefined) {
11
13
  super(`Cannot insert new block ${newBlockNumber} given previous block number is ${previous ?? 'undefined'}`);
14
+ this.name = 'BlockNumberNotSequentialError';
12
15
  }
13
16
  }
14
17
 
@@ -22,14 +25,35 @@ export class InitialCheckpointNumberNotSequentialError extends Error {
22
25
  previousCheckpointNumber ?? 'undefined'
23
26
  }`,
24
27
  );
28
+ this.name = 'InitialCheckpointNumberNotSequentialError';
25
29
  }
26
30
  }
27
31
 
28
32
  export class CheckpointNumberNotSequentialError extends Error {
29
- constructor(newCheckpointNumber: number, previous: number | undefined) {
33
+ constructor(
34
+ public readonly newCheckpointNumber: CheckpointNumber,
35
+ public readonly previousCheckpointNumber: CheckpointNumber | undefined,
36
+ source?: 'proposed' | 'confirmed',
37
+ ) {
38
+ const qualifier = source ? `${source} ` : '';
30
39
  super(
31
- `Cannot insert new checkpoint ${newCheckpointNumber} given previous checkpoint number in batch is ${previous ?? 'undefined'}`,
40
+ `Cannot insert new checkpoint ${newCheckpointNumber} given previous ${qualifier}checkpoint number is ${previousCheckpointNumber ?? 'undefined'}`,
32
41
  );
42
+ this.name = 'CheckpointNumberNotSequentialError';
43
+ }
44
+ }
45
+
46
+ /** Thrown when a proposed block carries a checkpoint number that does not follow the latest one. */
47
+ export class BlockCheckpointNumberNotSequentialError extends Error {
48
+ constructor(
49
+ blockNumber: BlockNumber,
50
+ blockCheckpointNumber: CheckpointNumber,
51
+ previous: CheckpointNumber | undefined,
52
+ ) {
53
+ super(
54
+ `Cannot insert new block ${blockNumber} for checkpoint ${blockCheckpointNumber} given previous checkpoint number is ${previous ?? 'undefined'}`,
55
+ );
56
+ this.name = 'BlockCheckpointNumberNotSequentialError';
33
57
  }
34
58
  }
35
59
 
@@ -38,6 +62,7 @@ export class BlockIndexNotSequentialError extends Error {
38
62
  super(
39
63
  `Cannot insert new block at checkpoint index ${newBlockIndex} given previous block index is ${previousBlockIndex ?? 'undefined'}`,
40
64
  );
65
+ this.name = 'BlockIndexNotSequentialError';
41
66
  }
42
67
  }
43
68
 
@@ -51,18 +76,21 @@ export class BlockArchiveNotConsistentError extends Error {
51
76
  super(
52
77
  `Cannot insert new block number ${newBlockNumber} with archive ${newBlockArchive.toString()} previous block number is ${previousBlockNumber ?? 'undefined'}, previous archive is ${previousBlockArchive?.toString() ?? 'undefined'}`,
53
78
  );
79
+ this.name = 'BlockArchiveNotConsistentError';
54
80
  }
55
81
  }
56
82
 
57
83
  export class CheckpointNotFoundError extends Error {
58
84
  constructor(checkpointNumber: number) {
59
85
  super(`Failed to find expected checkpoint number ${checkpointNumber}`);
86
+ this.name = 'CheckpointNotFoundError';
60
87
  }
61
88
  }
62
89
 
63
90
  export class BlockNotFoundError extends Error {
64
91
  constructor(blockNumber: number) {
65
92
  super(`Failed to find expected block number ${blockNumber}`);
93
+ this.name = 'BlockNotFoundError';
66
94
  }
67
95
  }
68
96
 
@@ -74,6 +102,93 @@ export class BlockAlreadyCheckpointedError extends Error {
74
102
  }
75
103
  }
76
104
 
105
+ /** Thrown when L1 to L2 messages are requested for a checkpoint whose message tree hasn't been sealed yet. */
106
+ export class L1ToL2MessagesNotReadyError extends Error {
107
+ constructor(
108
+ public readonly checkpointNumber: number,
109
+ public readonly inboxTreeInProgress: bigint,
110
+ ) {
111
+ super(
112
+ `Cannot get L1 to L2 messages for checkpoint ${checkpointNumber}: ` +
113
+ `inbox tree in progress is ${inboxTreeInProgress}, messages not yet sealed`,
114
+ );
115
+ this.name = 'L1ToL2MessagesNotReadyError';
116
+ }
117
+ }
118
+
119
+ /** Thrown when a proposed checkpoint number is stale (already processed). */
120
+ export class ProposedCheckpointStaleError extends Error {
121
+ constructor(
122
+ public readonly proposedCheckpointNumber: number,
123
+ public readonly currentProposedNumber: number,
124
+ ) {
125
+ super(`Stale proposed checkpoint ${proposedCheckpointNumber}: current proposed is ${currentProposedNumber}`);
126
+ this.name = 'ProposedCheckpointStaleError';
127
+ }
128
+ }
129
+
130
+ /** Thrown when a proposed checkpoint number is not the expected latestTip + 1. */
131
+ export class ProposedCheckpointNotSequentialError extends Error {
132
+ constructor(
133
+ public readonly proposedCheckpointNumber: number,
134
+ public readonly latestTipNumber: number,
135
+ ) {
136
+ super(
137
+ `Proposed checkpoint ${proposedCheckpointNumber} is not sequential: expected ${latestTipNumber + 1} (latest tip + 1, where tip is highest of confirmed or pending)`,
138
+ );
139
+ this.name = 'ProposedCheckpointNotSequentialError';
140
+ }
141
+ }
142
+
143
+ /** Thrown when a proposed checkpoint or block L2 slot has already expired on L1. */
144
+ export class BlockOrCheckpointSlotExpiredError extends Error {
145
+ constructor(
146
+ public readonly slot: number,
147
+ public readonly nextSlotStart: bigint,
148
+ public readonly l1TimestampSynced: bigint | undefined,
149
+ ) {
150
+ super(
151
+ `Checkpoint or block for slot ${slot} is expired: L1 synced to ${l1TimestampSynced} which is past the next slot start ${nextSlotStart}. ` +
152
+ `If the checkpoint still lands via a late L1 tx, the archiver will pick it up via normal L1-sync (not the pending-queue shortcut).`,
153
+ );
154
+ this.name = 'BlockOrCheckpointSlotExpiredError';
155
+ }
156
+ }
157
+
158
+ /** Thrown when attempting to promote a proposed checkpoint but no proposed checkpoint exists in the store. */
159
+ export class NoProposedCheckpointToPromoteError extends Error {
160
+ constructor() {
161
+ super('Cannot promote proposed checkpoint: no proposed checkpoint exists');
162
+ this.name = 'NoProposedCheckpointToPromoteError';
163
+ }
164
+ }
165
+
166
+ /** Thrown when the archive root of the proposed checkpoint does not match the expected one. */
167
+ export class ProposedCheckpointArchiveRootMismatchError extends Error {
168
+ constructor(
169
+ public readonly expectedArchiveRoot: Fr,
170
+ public readonly actualArchiveRoot: Fr,
171
+ ) {
172
+ super(
173
+ `Cannot promote proposed checkpoint: archive root mismatch (expected ${expectedArchiveRoot}, got ${actualArchiveRoot})`,
174
+ );
175
+ this.name = 'ProposedCheckpointArchiveRootMismatchError';
176
+ }
177
+ }
178
+
179
+ /** Thrown when the proposed checkpoint does not directly follow the latest confirmed checkpoint. */
180
+ export class ProposedCheckpointPromotionNotSequentialError extends Error {
181
+ constructor(
182
+ public readonly proposedCheckpointNumber: number,
183
+ public readonly latestCheckpointNumber: number,
184
+ ) {
185
+ super(
186
+ `Cannot promote proposed checkpoint: not sequential (latest ${latestCheckpointNumber}, proposed ${proposedCheckpointNumber})`,
187
+ );
188
+ this.name = 'ProposedCheckpointPromotionNotSequentialError';
189
+ }
190
+ }
191
+
77
192
  /** Thrown when a proposed block conflicts with an already checkpointed block (different content). */
78
193
  export class CannotOverwriteCheckpointedBlockError extends Error {
79
194
  constructor(
package/src/factory.ts CHANGED
@@ -1,6 +1,8 @@
1
1
  import { EpochCache } from '@aztec/epoch-cache';
2
2
  import { createEthereumChain } from '@aztec/ethereum/chain';
3
- import { InboxContract, RollupContract } from '@aztec/ethereum/contracts';
3
+ import { makeL1HttpTransport } from '@aztec/ethereum/client';
4
+ import { InboxContract, OutboxContract, RollupContract } from '@aztec/ethereum/contracts';
5
+ import { pickL1ContractAddresses } from '@aztec/ethereum/l1-contract-addresses';
4
6
  import type { ViemPublicDebugClient } from '@aztec/ethereum/types';
5
7
  import { BlockNumber } from '@aztec/foundation/branded-types';
6
8
  import { Buffer32 } from '@aztec/foundation/buffer';
@@ -11,33 +13,36 @@ import { createStore } from '@aztec/kv-store/lmdb-v2';
11
13
  import { protocolContractNames } from '@aztec/protocol-contracts';
12
14
  import { BundledProtocolContractsProvider } from '@aztec/protocol-contracts/providers/bundle';
13
15
  import { FunctionType, decodeFunctionSignature } from '@aztec/stdlib/abi';
14
- import type { ArchiverEmitter } from '@aztec/stdlib/block';
15
- import { type ContractClassPublic, computePublicBytecodeCommitment } from '@aztec/stdlib/contract';
16
+ import type { ArchiverEmitter, BlockHash } from '@aztec/stdlib/block';
17
+ import { type ContractClassPublicWithCommitment, computePublicBytecodeCommitment } from '@aztec/stdlib/contract';
16
18
  import type { DataStoreConfig } from '@aztec/stdlib/kv-store';
19
+ import { MIN_EXECUTION_TIME } from '@aztec/stdlib/timetable';
20
+ import type { BlockHeader } from '@aztec/stdlib/tx';
17
21
  import { getTelemetryClient } from '@aztec/telemetry-client';
18
22
 
19
23
  import { EventEmitter } from 'events';
20
- import { createPublicClient, fallback, http } from 'viem';
24
+ import { createPublicClient } from 'viem';
21
25
 
22
26
  import { Archiver, type ArchiverDeps } from './archiver.js';
23
27
  import { type ArchiverConfig, mapArchiverConfig } from './config.js';
24
28
  import { ArchiverInstrumentation } from './modules/instrumentation.js';
25
29
  import { ArchiverL1Synchronizer } from './modules/l1_synchronizer.js';
26
- import { ARCHIVER_DB_VERSION, KVArchiverDataStore } from './store/kv_archiver_store.js';
30
+ import { ARCHIVER_DB_VERSION, type ArchiverDataStores, createArchiverDataStores } from './store/data_stores.js';
27
31
  import { L2TipsCache } from './store/l2_tips_cache.js';
28
32
 
29
33
  export const ARCHIVER_STORE_NAME = 'archiver';
30
34
 
31
35
  /** Creates an archiver store. */
32
36
  export async function createArchiverStore(
33
- userConfig: Pick<ArchiverConfig, 'archiverStoreMapSizeKb' | 'maxLogs'> & DataStoreConfig,
34
- ) {
37
+ userConfig: Pick<ArchiverConfig, 'archiverStoreMapSizeKb'> & DataStoreConfig,
38
+ genesisBlockHash: BlockHash,
39
+ ): Promise<ArchiverDataStores> {
35
40
  const config = {
36
41
  ...userConfig,
37
42
  dataStoreMapSizeKb: userConfig.archiverStoreMapSizeKb ?? userConfig.dataStoreMapSizeKb,
38
43
  };
39
44
  const store = await createStore(ARCHIVER_STORE_NAME, ARCHIVER_DB_VERSION, config);
40
- return new KVArchiverDataStore(store, config.maxLogs);
45
+ return createArchiverDataStores(store, genesisBlockHash);
41
46
  }
42
47
 
43
48
  /**
@@ -45,21 +50,27 @@ export async function createArchiverStore(
45
50
  * @param config - The archiver configuration.
46
51
  * @param deps - The archiver dependencies (blobClient, epochCache, dateProvider, telemetry).
47
52
  * @param opts - The options.
53
+ * @param initialHeader - The genesis block header from world-state, used to answer block-0 queries.
54
+ * @param initialBlockHash - Precomputed hash of `initialHeader`. Hoisted to the caller so the archiver
55
+ * can expose `getGenesisBlockHash()` synchronously.
48
56
  * @returns The local archiver.
49
57
  */
50
58
  export async function createArchiver(
51
59
  config: ArchiverConfig & DataStoreConfig,
52
60
  deps: ArchiverDeps,
53
- opts: { blockUntilSync: boolean } = { blockUntilSync: true },
61
+ opts: { blockUntilSync: boolean; enableOrphanProposedBlockPruning?: boolean } = { blockUntilSync: true },
62
+ initialHeader: BlockHeader,
63
+ initialBlockHash: BlockHash,
54
64
  ): Promise<Archiver> {
55
- const archiverStore = await createArchiverStore(config);
65
+ const archiverStore = await createArchiverStore(config, initialBlockHash);
56
66
  await registerProtocolContracts(archiverStore);
57
67
 
58
68
  // Create Ethereum clients
59
69
  const chain = createEthereumChain(config.l1RpcUrls, config.l1ChainId);
70
+ const httpTimeout = config.l1HttpTimeoutMS;
60
71
  const publicClient = createPublicClient({
61
72
  chain: chain.chainInfo,
62
- transport: fallback(config.l1RpcUrls.map(url => http(url, { batch: false }))),
73
+ transport: makeL1HttpTransport(config.l1RpcUrls, { timeout: httpTimeout }),
63
74
  pollingInterval: config.viemPollingIntervalMS,
64
75
  });
65
76
 
@@ -67,13 +78,14 @@ export async function createArchiver(
67
78
  const debugRpcUrls = config.l1DebugRpcUrls.length > 0 ? config.l1DebugRpcUrls : config.l1RpcUrls;
68
79
  const debugClient = createPublicClient({
69
80
  chain: chain.chainInfo,
70
- transport: fallback(debugRpcUrls.map(url => http(url, { batch: false }))),
81
+ transport: makeL1HttpTransport(debugRpcUrls, { timeout: httpTimeout }),
71
82
  pollingInterval: config.viemPollingIntervalMS,
72
83
  }) as ViemPublicDebugClient;
73
84
 
74
85
  // Create L1 contract instances
75
- const rollup = new RollupContract(publicClient, config.l1Contracts.rollupAddress);
76
- const inbox = new InboxContract(publicClient, config.l1Contracts.inboxAddress);
86
+ const rollup = new RollupContract(publicClient, config.rollupAddress);
87
+ const inbox = new InboxContract(publicClient, config.inboxAddress);
88
+ const outbox = new OutboxContract(publicClient, config.outboxAddress);
77
89
 
78
90
  // Fetch L1 constants from rollup contract
79
91
  const [
@@ -119,19 +131,24 @@ export async function createArchiver(
119
131
  batchSize: 100,
120
132
  maxAllowedEthClientDriftSeconds: 300,
121
133
  ethereumAllowNoDebugHosts: false,
134
+ skipHistoricalLogsCheck: false,
135
+ orphanProposedBlockPruneGraceSeconds: MIN_EXECUTION_TIME,
136
+ enableOrphanProposedBlockPruning: opts.enableOrphanProposedBlockPruning ?? true,
122
137
  },
123
138
  mapArchiverConfig(config),
124
139
  );
125
140
 
126
- const epochCache = deps.epochCache ?? (await EpochCache.create(config.l1Contracts.rollupAddress, config, deps));
141
+ const epochCache = deps.epochCache ?? (await EpochCache.create(config.rollupAddress, config, deps));
127
142
  const telemetry = deps.telemetry ?? getTelemetryClient();
128
- const instrumentation = await ArchiverInstrumentation.new(telemetry, () => archiverStore.estimateSize());
143
+ const instrumentation = await ArchiverInstrumentation.new(telemetry, () => archiverStore.db.estimateSize());
129
144
 
130
145
  // Create the event emitter that will be shared by archiver and synchronizer
131
146
  const events = new EventEmitter() as ArchiverEmitter;
132
147
 
133
- // Create L2 tips cache shared by archiver and synchronizer
134
- const l2TipsCache = new L2TipsCache(archiverStore.blockStore);
148
+ // Create L2 tips cache shared by archiver and synchronizer. The genesis block hash is dynamic —
149
+ // it depends on the injected initial header (genesisTimestamp + prefilled state). Hoisted to the
150
+ // caller so we can pass the same value to the archiver and expose it via `getGenesisBlockHash()`.
151
+ const l2TipsCache = new L2TipsCache(archiverStore.blocks, initialBlockHash);
135
152
 
136
153
  // Create the L1 synchronizer
137
154
  const synchronizer = new ArchiverL1Synchronizer(
@@ -156,7 +173,8 @@ export async function createArchiver(
156
173
  publicClient,
157
174
  debugClient,
158
175
  rollup,
159
- { ...config.l1Contracts, slashingProposerAddress },
176
+ outbox,
177
+ { ...pickL1ContractAddresses(config), slashingProposerAddress },
160
178
  archiverStore,
161
179
  archiverConfig,
162
180
  deps.blobClient,
@@ -164,32 +182,40 @@ export async function createArchiver(
164
182
  l1Constants,
165
183
  synchronizer,
166
184
  events,
185
+ initialHeader,
186
+ initialBlockHash,
167
187
  l2TipsCache,
188
+ deps.dateProvider ?? new DateProvider(),
168
189
  );
169
190
 
170
191
  await archiver.start(opts.blockUntilSync);
171
192
  return archiver;
172
193
  }
173
194
 
174
- /** Registers protocol contracts in the archiver store. */
175
- export async function registerProtocolContracts(store: KVArchiverDataStore) {
195
+ /** Registers protocol contracts in the archiver store. Idempotent — skips contracts that already exist (e.g. on node restart). */
196
+ export async function registerProtocolContracts(stores: ArchiverDataStores) {
176
197
  const blockNumber = 0;
177
198
  for (const name of protocolContractNames) {
178
199
  const provider = new BundledProtocolContractsProvider();
179
200
  const contract = await provider.getProtocolContractArtifact(name);
180
- const contractClassPublic: ContractClassPublic = {
201
+
202
+ // Skip if already registered (happens on node restart with a persisted store).
203
+ if (await stores.contractClasses.getContractClass(contract.contractClass.id)) {
204
+ continue;
205
+ }
206
+
207
+ const publicBytecodeCommitment = await computePublicBytecodeCommitment(contract.contractClass.packedBytecode);
208
+ const contractClassPublic: ContractClassPublicWithCommitment = {
181
209
  ...contract.contractClass,
182
- privateFunctions: [],
183
- utilityFunctions: [],
210
+ publicBytecodeCommitment,
184
211
  };
185
212
 
186
213
  const publicFunctionSignatures = contract.artifact.functions
187
214
  .filter(fn => fn.functionType === FunctionType.PUBLIC)
188
215
  .map(fn => decodeFunctionSignature(fn.name, fn.parameters));
189
216
 
190
- await store.registerContractFunctionSignatures(publicFunctionSignatures);
191
- const bytecodeCommitment = await computePublicBytecodeCommitment(contractClassPublic.packedBytecode);
192
- await store.addContractClasses([contractClassPublic], [bytecodeCommitment], BlockNumber(blockNumber));
193
- await store.addContractInstances([contract.instance], BlockNumber(blockNumber));
217
+ await stores.functionNames.register(publicFunctionSignatures);
218
+ await stores.contractClasses.addContractClasses([contractClassPublic], BlockNumber(blockNumber));
219
+ await stores.contractInstances.addContractInstances([contract.instance], BlockNumber(blockNumber));
194
220
  }
195
221
  }
package/src/index.ts CHANGED
@@ -4,10 +4,26 @@ export * from './archiver.js';
4
4
  export * from './modules/data_source_base.js';
5
5
  export * from './modules/data_store_updater.js';
6
6
  export * from './config.js';
7
+ export * from './errors.js';
7
8
 
8
9
  export { type L1PublishedData } from './structs/published.js';
9
- export { KVArchiverDataStore, ARCHIVER_DB_VERSION } from './store/kv_archiver_store.js';
10
+ export {
11
+ ARCHIVER_DB_VERSION,
12
+ type ArchiverDataStores,
13
+ type ArchiverL1SynchPoint,
14
+ backupArchiverDataStores,
15
+ createArchiverDataStores,
16
+ createContractDataSource,
17
+ getArchiverSynchPoint,
18
+ } from './store/data_stores.js';
19
+ export { FunctionNamesCache } from './store/function_names_cache.js';
20
+ export { ArchiverContractDataSourceAdapter } from './modules/contract_data_source_adapter.js';
21
+ export { BlockStore } from './store/block_store.js';
22
+ export { LogStore } from './store/log_store.js';
23
+ export { MessageStore } from './store/message_store.js';
24
+ export { ContractClassStore } from './store/contract_class_store.js';
10
25
  export { ContractInstanceStore } from './store/contract_instance_store.js';
11
26
  export { L2TipsCache } from './store/l2_tips_cache.js';
12
27
 
13
- export { retrieveCheckpointsFromRollup, retrieveL2ProofVerifiedEvents } from './l1/data_retrieval.js';
28
+ export { retrieveL2ProofVerifiedEvents } from './l1/data_retrieval.js';
29
+ export { CalldataRetriever } from './l1/calldata_retriever.js';
@@ -1,12 +1,13 @@
1
1
  import { MULTI_CALL_3_ADDRESS, type ViemCommitteeAttestations, type ViemHeader } from '@aztec/ethereum/contracts';
2
2
  import type { ViemPublicClient, ViemPublicDebugClient } from '@aztec/ethereum/types';
3
3
  import { CheckpointNumber } from '@aztec/foundation/branded-types';
4
+ import { LruSet } from '@aztec/foundation/collection';
4
5
  import { Fr } from '@aztec/foundation/curves/bn254';
5
6
  import { EthAddress } from '@aztec/foundation/eth-address';
6
7
  import type { Logger } from '@aztec/foundation/log';
7
8
  import { RollupAbi } from '@aztec/l1-artifacts';
8
9
  import { CommitteeAttestation } from '@aztec/stdlib/block';
9
- import { ConsensusPayload, SignatureDomainSeparator } from '@aztec/stdlib/p2p';
10
+ import { computeCheckpointPayloadDigest } from '@aztec/stdlib/checkpoint';
10
11
  import { CheckpointHeader } from '@aztec/stdlib/rollup';
11
12
 
12
13
  import {
@@ -44,7 +45,7 @@ type CheckpointData = {
44
45
  */
45
46
  export class CalldataRetriever {
46
47
  /** Tx hashes we've already logged for trace+debug failure (log once per tx per process). */
47
- private static readonly traceFailureWarnedTxHashes = new Set<string>();
48
+ private static readonly traceFailureWarnedTxHashes = new LruSet<string>(1000);
48
49
 
49
50
  /** Clears the trace-failure warned set. For testing only. */
50
51
  static resetTraceFailureWarnedForTesting(): void {
@@ -60,6 +61,13 @@ export class CalldataRetriever {
60
61
  private readonly rollupAddress: EthAddress,
61
62
  ) {}
62
63
 
64
+ private getSignatureContext() {
65
+ return {
66
+ chainId: this.publicClient.chain.id,
67
+ rollupAddress: this.rollupAddress,
68
+ };
69
+ }
70
+
63
71
  /**
64
72
  * Gets checkpoint header and metadata from the calldata of an L1 transaction.
65
73
  * Tries multicall3 decoding, falls back to trace-based extraction.
@@ -465,9 +473,12 @@ export class CalldataRetriever {
465
473
 
466
474
  /** Computes the keccak256 payload digest from the checkpoint header, archive root, and fee asset price modifier. */
467
475
  private computePayloadDigest(header: CheckpointHeader, archiveRoot: Fr, feeAssetPriceModifier: bigint): Hex {
468
- const consensusPayload = new ConsensusPayload(header, archiveRoot, feeAssetPriceModifier);
469
- const payloadToSign = consensusPayload.getPayloadToSign(SignatureDomainSeparator.checkpointAttestation);
470
- return keccak256(payloadToSign);
476
+ return computeCheckpointPayloadDigest({
477
+ header,
478
+ archiveRoot,
479
+ feeAssetPriceModifier,
480
+ signatureContext: this.getSignatureContext(),
481
+ }).toString();
471
482
  }
472
483
 
473
484
  /**