@aztec/archiver 0.0.1-commit.fffb133c → 0.0.1-dev

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 (100) hide show
  1. package/dest/archiver.d.ts +9 -5
  2. package/dest/archiver.d.ts.map +1 -1
  3. package/dest/archiver.js +87 -111
  4. package/dest/errors.d.ts +7 -9
  5. package/dest/errors.d.ts.map +1 -1
  6. package/dest/errors.js +9 -14
  7. package/dest/factory.d.ts +4 -3
  8. package/dest/factory.d.ts.map +1 -1
  9. package/dest/factory.js +32 -26
  10. package/dest/index.d.ts +2 -1
  11. package/dest/index.d.ts.map +1 -1
  12. package/dest/index.js +1 -0
  13. package/dest/l1/bin/retrieve-calldata.js +36 -33
  14. package/dest/l1/calldata_retriever.d.ts +73 -50
  15. package/dest/l1/calldata_retriever.d.ts.map +1 -1
  16. package/dest/l1/calldata_retriever.js +190 -259
  17. package/dest/l1/data_retrieval.d.ts +4 -7
  18. package/dest/l1/data_retrieval.d.ts.map +1 -1
  19. package/dest/l1/data_retrieval.js +10 -14
  20. package/dest/l1/spire_proposer.d.ts +5 -5
  21. package/dest/l1/spire_proposer.d.ts.map +1 -1
  22. package/dest/l1/spire_proposer.js +9 -17
  23. package/dest/l1/validate_trace.d.ts +6 -3
  24. package/dest/l1/validate_trace.d.ts.map +1 -1
  25. package/dest/l1/validate_trace.js +13 -9
  26. package/dest/modules/data_source_base.d.ts +13 -8
  27. package/dest/modules/data_source_base.d.ts.map +1 -1
  28. package/dest/modules/data_source_base.js +29 -73
  29. package/dest/modules/data_store_updater.d.ts +22 -7
  30. package/dest/modules/data_store_updater.d.ts.map +1 -1
  31. package/dest/modules/data_store_updater.js +114 -40
  32. package/dest/modules/instrumentation.d.ts +4 -2
  33. package/dest/modules/instrumentation.d.ts.map +1 -1
  34. package/dest/modules/instrumentation.js +26 -12
  35. package/dest/modules/l1_synchronizer.d.ts +5 -8
  36. package/dest/modules/l1_synchronizer.d.ts.map +1 -1
  37. package/dest/modules/l1_synchronizer.js +42 -13
  38. package/dest/store/block_store.d.ts +38 -29
  39. package/dest/store/block_store.d.ts.map +1 -1
  40. package/dest/store/block_store.js +294 -85
  41. package/dest/store/contract_class_store.d.ts +1 -1
  42. package/dest/store/contract_class_store.d.ts.map +1 -1
  43. package/dest/store/contract_class_store.js +27 -7
  44. package/dest/store/contract_instance_store.d.ts +1 -1
  45. package/dest/store/contract_instance_store.d.ts.map +1 -1
  46. package/dest/store/contract_instance_store.js +17 -2
  47. package/dest/store/kv_archiver_store.d.ts +40 -18
  48. package/dest/store/kv_archiver_store.d.ts.map +1 -1
  49. package/dest/store/kv_archiver_store.js +44 -16
  50. package/dest/store/l2_tips_cache.d.ts +18 -0
  51. package/dest/store/l2_tips_cache.d.ts.map +1 -0
  52. package/dest/store/l2_tips_cache.js +20 -0
  53. package/dest/store/log_store.d.ts +1 -1
  54. package/dest/store/log_store.d.ts.map +1 -1
  55. package/dest/store/log_store.js +125 -56
  56. package/dest/store/message_store.js +1 -1
  57. package/dest/test/fake_l1_state.d.ts +20 -1
  58. package/dest/test/fake_l1_state.d.ts.map +1 -1
  59. package/dest/test/fake_l1_state.js +97 -20
  60. package/dest/test/index.js +3 -1
  61. package/dest/test/mock_archiver.d.ts +1 -1
  62. package/dest/test/mock_archiver.d.ts.map +1 -1
  63. package/dest/test/mock_archiver.js +3 -2
  64. package/dest/test/mock_l2_block_source.d.ts +25 -9
  65. package/dest/test/mock_l2_block_source.d.ts.map +1 -1
  66. package/dest/test/mock_l2_block_source.js +133 -87
  67. package/dest/test/mock_structs.d.ts +6 -2
  68. package/dest/test/mock_structs.d.ts.map +1 -1
  69. package/dest/test/mock_structs.js +20 -6
  70. package/dest/test/noop_l1_archiver.d.ts +26 -0
  71. package/dest/test/noop_l1_archiver.d.ts.map +1 -0
  72. package/dest/test/noop_l1_archiver.js +72 -0
  73. package/package.json +14 -13
  74. package/src/archiver.ts +110 -132
  75. package/src/errors.ts +10 -24
  76. package/src/factory.ts +47 -23
  77. package/src/index.ts +1 -0
  78. package/src/l1/README.md +25 -68
  79. package/src/l1/bin/retrieve-calldata.ts +46 -39
  80. package/src/l1/calldata_retriever.ts +249 -379
  81. package/src/l1/data_retrieval.ts +7 -17
  82. package/src/l1/spire_proposer.ts +7 -15
  83. package/src/l1/validate_trace.ts +24 -6
  84. package/src/modules/data_source_base.ts +59 -98
  85. package/src/modules/data_store_updater.ts +124 -43
  86. package/src/modules/instrumentation.ts +24 -12
  87. package/src/modules/l1_synchronizer.ts +49 -17
  88. package/src/store/block_store.ts +359 -115
  89. package/src/store/contract_class_store.ts +27 -7
  90. package/src/store/contract_instance_store.ts +19 -5
  91. package/src/store/kv_archiver_store.ts +71 -25
  92. package/src/store/l2_tips_cache.ts +27 -0
  93. package/src/store/log_store.ts +186 -57
  94. package/src/store/message_store.ts +1 -1
  95. package/src/test/fake_l1_state.ts +125 -21
  96. package/src/test/index.ts +3 -0
  97. package/src/test/mock_archiver.ts +3 -2
  98. package/src/test/mock_l2_block_source.ts +179 -87
  99. package/src/test/mock_structs.ts +42 -12
  100. package/src/test/noop_l1_archiver.ts +115 -0
@@ -14,6 +14,7 @@ import { CommitteeAttestation, CommitteeAttestationsAndSigners, L2Block } from '
14
14
  import { Checkpoint } from '@aztec/stdlib/checkpoint';
15
15
  import { getSlotAtTimestamp } from '@aztec/stdlib/epoch-helpers';
16
16
  import { InboxLeaf } from '@aztec/stdlib/messaging';
17
+ import { ConsensusPayload, SignatureDomainSeparator } from '@aztec/stdlib/p2p';
17
18
  import {
18
19
  makeAndSignCommitteeAttestationsAndSigners,
19
20
  makeCheckpointAttestationFromCheckpoint,
@@ -22,7 +23,16 @@ import {
22
23
  import { AppendOnlyTreeSnapshot } from '@aztec/stdlib/trees';
23
24
 
24
25
  import { type MockProxy, mock } from 'jest-mock-extended';
25
- import { type FormattedBlock, type Transaction, encodeFunctionData, multicall3Abi, toHex } from 'viem';
26
+ import {
27
+ type AbiParameter,
28
+ type FormattedBlock,
29
+ type Transaction,
30
+ encodeAbiParameters,
31
+ encodeFunctionData,
32
+ keccak256,
33
+ multicall3Abi,
34
+ toHex,
35
+ } from 'viem';
26
36
 
27
37
  import { updateRollingHash } from '../structs/inbox_message.js';
28
38
 
@@ -87,6 +97,10 @@ type CheckpointData = {
87
97
  blobHashes: `0x${string}`[];
88
98
  blobs: Blob[];
89
99
  signers: Secp256k1Signer[];
100
+ /** Hash of the packed attestations, matching what the L1 event emits. */
101
+ attestationsHash: Buffer32;
102
+ /** Payload digest, matching what the L1 event emits. */
103
+ payloadDigest: Buffer32;
90
104
  /** If true, archiveAt will ignore it */
91
105
  pruned?: boolean;
92
106
  };
@@ -131,12 +145,17 @@ export class FakeL1State {
131
145
  private provenCheckpointNumber: CheckpointNumber = CheckpointNumber(0);
132
146
  private targetCommitteeSize: number = 0;
133
147
  private version: bigint = 1n;
148
+ private canPruneResult: boolean = false;
134
149
 
135
150
  // Computed from checkpoints based on L1 block visibility
136
151
  private pendingCheckpointNumber: CheckpointNumber = CheckpointNumber(0);
137
152
 
153
+ // The L1 block number reported as "finalized" (defaults to the start block)
154
+ private finalizedL1BlockNumber: bigint;
155
+
138
156
  constructor(private readonly config: FakeL1StateConfig) {
139
157
  this.l1BlockNumber = config.l1StartBlock;
158
+ this.finalizedL1BlockNumber = config.l1StartBlock;
140
159
  this.lastArchive = new AppendOnlyTreeSnapshot(config.genesisArchiveRoot, 1);
141
160
  }
142
161
 
@@ -193,10 +212,10 @@ export class FakeL1State {
193
212
  // Store the messages internally so they match the checkpoint's inHash
194
213
  this.addMessages(checkpointNumber, messagesL1BlockNumber, messages);
195
214
 
196
- // Create the transaction and blobs
197
- const tx = this.makeRollupTx(checkpoint, signers);
198
- const blobHashes = this.makeVersionedBlobHashes(checkpoint);
199
- const blobs = this.makeBlobsFromCheckpoint(checkpoint);
215
+ // Create the transaction, blobs, and event hashes
216
+ const { tx, attestationsHash, payloadDigest } = await this.makeRollupTx(checkpoint, signers);
217
+ const blobHashes = await this.makeVersionedBlobHashes(checkpoint);
218
+ const blobs = await this.makeBlobsFromCheckpoint(checkpoint);
200
219
 
201
220
  // Store the checkpoint data
202
221
  this.checkpoints.push({
@@ -207,6 +226,8 @@ export class FakeL1State {
207
226
  blobHashes,
208
227
  blobs,
209
228
  signers,
229
+ attestationsHash,
230
+ payloadDigest,
210
231
  });
211
232
 
212
233
  // Update last archive for auto-chaining
@@ -266,16 +287,40 @@ export class FakeL1State {
266
287
  this.updatePendingCheckpointNumber();
267
288
  }
268
289
 
290
+ /** Sets the L1 block number that will be reported as "finalized". */
291
+ setFinalizedL1BlockNumber(blockNumber: bigint): void {
292
+ this.finalizedL1BlockNumber = blockNumber;
293
+ }
294
+
269
295
  /** Marks a checkpoint as proven. Updates provenCheckpointNumber. */
270
296
  markCheckpointAsProven(checkpointNumber: CheckpointNumber): void {
271
297
  this.provenCheckpointNumber = checkpointNumber;
272
298
  }
273
299
 
300
+ /**
301
+ * Simulates what `rollup.getProvenCheckpointNumber({ blockNumber: atL1Block })` would return.
302
+ */
303
+ getProvenCheckpointNumberAtL1Block(atL1Block: bigint): CheckpointNumber {
304
+ if (this.provenCheckpointNumber === 0) {
305
+ return CheckpointNumber(0);
306
+ }
307
+ const checkpoint = this.checkpoints.find(cp => cp.checkpointNumber === this.provenCheckpointNumber);
308
+ if (checkpoint && checkpoint.l1BlockNumber <= atL1Block) {
309
+ return this.provenCheckpointNumber;
310
+ }
311
+ return CheckpointNumber(0);
312
+ }
313
+
274
314
  /** Sets the target committee size for attestation validation. */
275
315
  setTargetCommitteeSize(size: number): void {
276
316
  this.targetCommitteeSize = size;
277
317
  }
278
318
 
319
+ /** Sets whether the rollup contract would allow pruning at the next block. */
320
+ setCanPrune(value: boolean): void {
321
+ this.canPruneResult = value;
322
+ }
323
+
279
324
  /**
280
325
  * Removes all entries for a checkpoint number (simulates L1 reorg or prune).
281
326
  * Note: Does NOT remove messages for this checkpoint (use numL1ToL2Messages: 0 when re-adding).
@@ -286,6 +331,21 @@ export class FakeL1State {
286
331
  this.updatePendingCheckpointNumber();
287
332
  }
288
333
 
334
+ /**
335
+ * Moves a checkpoint to a different L1 block number (simulates L1 reorg that
336
+ * re-includes the same checkpoint transaction in a different block).
337
+ * The checkpoint content stays the same — only the L1 metadata changes.
338
+ * Auto-updates pending status.
339
+ */
340
+ moveCheckpointToL1Block(checkpointNumber: CheckpointNumber, newL1BlockNumber: bigint): void {
341
+ for (const cpData of this.checkpoints) {
342
+ if (cpData.checkpointNumber === checkpointNumber) {
343
+ cpData.l1BlockNumber = newL1BlockNumber;
344
+ }
345
+ }
346
+ this.updatePendingCheckpointNumber();
347
+ }
348
+
289
349
  /**
290
350
  * Removes messages after a given total index (simulates L1 reorg).
291
351
  * Auto-updates rolling hash.
@@ -384,6 +444,13 @@ export class FakeL1State {
384
444
  });
385
445
  });
386
446
 
447
+ mockRollup.getProvenCheckpointNumber.mockImplementation((options?: { blockNumber?: bigint }) => {
448
+ const atBlock = options?.blockNumber ?? this.l1BlockNumber;
449
+ return Promise.resolve(this.getProvenCheckpointNumberAtL1Block(atBlock));
450
+ });
451
+
452
+ mockRollup.canPruneAtTime.mockImplementation(() => Promise.resolve(this.canPruneResult));
453
+
387
454
  // Mock the wrapper method for fetching checkpoint events
388
455
  mockRollup.getCheckpointProposedEvents.mockImplementation((fromBlock: bigint, toBlock: bigint) =>
389
456
  Promise.resolve(this.getCheckpointProposedLogs(fromBlock, toBlock)),
@@ -425,10 +492,13 @@ export class FakeL1State {
425
492
  publicClient.getChainId.mockResolvedValue(1);
426
493
  publicClient.getBlockNumber.mockImplementation(() => Promise.resolve(this.l1BlockNumber));
427
494
 
428
- // Use async function pattern that existing test uses for getBlock
429
-
430
- publicClient.getBlock.mockImplementation((async (args: { blockNumber?: bigint } = {}) => {
431
- const blockNum = args.blockNumber ?? (await publicClient.getBlockNumber());
495
+ publicClient.getBlock.mockImplementation((async (args: { blockNumber?: bigint; blockTag?: string } = {}) => {
496
+ let blockNum: bigint;
497
+ if (args.blockTag === 'finalized') {
498
+ blockNum = this.finalizedL1BlockNumber;
499
+ } else {
500
+ blockNum = args.blockNumber ?? (await publicClient.getBlockNumber());
501
+ }
432
502
  return {
433
503
  number: blockNum,
434
504
  timestamp: BigInt(blockNum) * BigInt(this.config.ethereumSlotDuration) + this.config.l1GenesisTime,
@@ -502,10 +572,8 @@ export class FakeL1State {
502
572
  checkpointNumber: cpData.checkpointNumber,
503
573
  archive: cpData.checkpoint.archive.root,
504
574
  versionedBlobHashes: cpData.blobHashes.map(h => Buffer.from(h.slice(2), 'hex')),
505
- // These are intentionally undefined to skip hash validation in the archiver
506
- // (validation is skipped when these fields are falsy)
507
- payloadDigest: undefined,
508
- attestationsHash: undefined,
575
+ attestationsHash: cpData.attestationsHash,
576
+ payloadDigest: cpData.payloadDigest,
509
577
  },
510
578
  }));
511
579
  }
@@ -531,14 +599,17 @@ export class FakeL1State {
531
599
  }));
532
600
  }
533
601
 
534
- private makeRollupTx(checkpoint: Checkpoint, signers: Secp256k1Signer[]): Transaction {
602
+ private async makeRollupTx(
603
+ checkpoint: Checkpoint,
604
+ signers: Secp256k1Signer[],
605
+ ): Promise<{ tx: Transaction; attestationsHash: Buffer32; payloadDigest: Buffer32 }> {
535
606
  const attestations = signers
536
607
  .map(signer => makeCheckpointAttestationFromCheckpoint(checkpoint, signer))
537
608
  .map(attestation => CommitteeAttestation.fromSignature(attestation.signature))
538
609
  .map(committeeAttestation => committeeAttestation.toViem());
539
610
 
540
611
  const header = checkpoint.header.toViem();
541
- const blobInput = getPrefixedEthBlobCommitments(getBlobsPerL1Block(checkpoint.toBlobFields()));
612
+ const blobInput = getPrefixedEthBlobCommitments(await getBlobsPerL1Block(checkpoint.toBlobFields()));
542
613
  const archive = toHex(checkpoint.archive.root.toBuffer());
543
614
  const attestationsAndSigners = new CommitteeAttestationsAndSigners(
544
615
  attestations.map(attestation => CommitteeAttestation.fromViem(attestation)),
@@ -549,6 +620,8 @@ export class FakeL1State {
549
620
  signers[0],
550
621
  );
551
622
 
623
+ const packedAttestations = attestationsAndSigners.getPackedAttestations();
624
+
552
625
  const rollupInput = encodeFunctionData({
553
626
  abi: RollupAbi,
554
627
  functionName: 'propose',
@@ -558,7 +631,7 @@ export class FakeL1State {
558
631
  archive,
559
632
  oracleInput: { feeAssetPriceModifier: 0n },
560
633
  },
561
- attestationsAndSigners.getPackedAttestations(),
634
+ packedAttestations,
562
635
  attestationsAndSigners.getSigners().map(signer => signer.toString()),
563
636
  attestationsAndSignersSignature.toViemSignature(),
564
637
  blobInput,
@@ -579,21 +652,52 @@ export class FakeL1State {
579
652
  ],
580
653
  });
581
654
 
582
- return {
655
+ // Compute attestationsHash (same logic as CalldataRetriever)
656
+ const attestationsHash = Buffer32.fromString(
657
+ keccak256(encodeAbiParameters([this.getCommitteeAttestationsStructDef()], [packedAttestations])),
658
+ );
659
+
660
+ // Compute payloadDigest (same logic as CalldataRetriever)
661
+ const consensusPayload = ConsensusPayload.fromCheckpoint(checkpoint);
662
+ const payloadToSign = consensusPayload.getPayloadToSign(SignatureDomainSeparator.checkpointAttestation);
663
+ const payloadDigest = Buffer32.fromString(keccak256(payloadToSign));
664
+
665
+ const tx = {
583
666
  input: multiCallInput,
584
667
  hash: archive,
585
668
  blockHash: archive,
586
669
  to: MULTI_CALL_3_ADDRESS as `0x${string}`,
587
670
  } as Transaction<bigint, number>;
671
+
672
+ return { tx, attestationsHash, payloadDigest };
673
+ }
674
+
675
+ /** Extracts the CommitteeAttestations struct definition from RollupAbi for hash computation. */
676
+ private getCommitteeAttestationsStructDef(): AbiParameter {
677
+ const proposeFunction = RollupAbi.find(item => item.type === 'function' && item.name === 'propose') as
678
+ | { type: 'function'; name: string; inputs: readonly AbiParameter[] }
679
+ | undefined;
680
+
681
+ if (!proposeFunction) {
682
+ throw new Error('propose function not found in RollupAbi');
683
+ }
684
+
685
+ const attestationsParam = proposeFunction.inputs.find(param => param.name === '_attestations');
686
+ if (!attestationsParam) {
687
+ throw new Error('_attestations parameter not found in propose function');
688
+ }
689
+
690
+ const tupleParam = attestationsParam as unknown as { type: 'tuple'; components?: readonly AbiParameter[] };
691
+ return { type: 'tuple', components: tupleParam.components || [] } as AbiParameter;
588
692
  }
589
693
 
590
- private makeVersionedBlobHashes(checkpoint: Checkpoint): `0x${string}`[] {
591
- return getBlobsPerL1Block(checkpoint.toBlobFields()).map(
694
+ private async makeVersionedBlobHashes(checkpoint: Checkpoint): Promise<`0x${string}`[]> {
695
+ return (await getBlobsPerL1Block(checkpoint.toBlobFields())).map(
592
696
  b => `0x${b.getEthVersionedBlobHash().toString('hex')}` as `0x${string}`,
593
697
  );
594
698
  }
595
699
 
596
- private makeBlobsFromCheckpoint(checkpoint: Checkpoint): Blob[] {
597
- return getBlobsPerL1Block(checkpoint.toBlobFields());
700
+ private async makeBlobsFromCheckpoint(checkpoint: Checkpoint): Promise<Blob[]> {
701
+ return await getBlobsPerL1Block(checkpoint.toBlobFields());
598
702
  }
599
703
  }
package/src/test/index.ts CHANGED
@@ -2,3 +2,6 @@ export * from './mock_structs.js';
2
2
  export * from './mock_l2_block_source.js';
3
3
  export * from './mock_l1_to_l2_message_source.js';
4
4
  export * from './mock_archiver.js';
5
+ // NOTE: noop_l1_archiver.js is intentionally NOT exported here because it imports
6
+ // jest-mock-extended, which depends on @jest/globals and can only run inside Jest.
7
+ // Import it directly: import { NoopL1Archiver } from '@aztec/archiver/test/noop-l1';
@@ -56,8 +56,9 @@ export class MockPrefilledArchiver extends MockArchiver {
56
56
  }
57
57
 
58
58
  const fromBlock = this.l2Blocks.length;
59
- // TODO: Add L2 blocks and checkpoints separately once archiver has the apis for that.
60
- this.addProposedBlocks(this.prefilled.slice(fromBlock, fromBlock + numBlocks).flatMap(c => c.blocks));
59
+ const checkpointsToAdd = this.prefilled.slice(fromBlock, fromBlock + numBlocks);
60
+ this.addProposedBlocks(checkpointsToAdd.flatMap(c => c.blocks));
61
+ this.checkpointList.push(...checkpointsToAdd);
61
62
  return Promise.resolve();
62
63
  }
63
64
  }