@aztec/aztec-node 0.0.1-commit.9b94fc1 → 0.0.1-commit.a072138

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.
@@ -1,26 +1,16 @@
1
1
  import { Archiver, createArchiver } from '@aztec/archiver';
2
2
  import { BBCircuitVerifier, QueuedIVCVerifier, TestCircuitVerifier } from '@aztec/bb-prover';
3
- import { type BlobSinkClientInterface, createBlobSinkClient } from '@aztec/blob-sink/client';
4
- import {
5
- ARCHIVE_HEIGHT,
6
- INITIAL_L2_BLOCK_NUM,
7
- type L1_TO_L2_MSG_TREE_HEIGHT,
8
- type NOTE_HASH_TREE_HEIGHT,
9
- type NULLIFIER_TREE_HEIGHT,
10
- type PUBLIC_DATA_TREE_HEIGHT,
11
- } from '@aztec/constants';
3
+ import { type BlobClientInterface, createBlobClientWithFileStores } from '@aztec/blob-client/client';
4
+ import { ARCHIVE_HEIGHT, type L1_TO_L2_MSG_TREE_HEIGHT, type NOTE_HASH_TREE_HEIGHT } from '@aztec/constants';
12
5
  import { EpochCache, type EpochCacheInterface } from '@aztec/epoch-cache';
13
- import {
14
- type L1ContractAddresses,
15
- RegistryContract,
16
- RollupContract,
17
- createEthereumChain,
18
- getPublicClient,
19
- } from '@aztec/ethereum';
20
- import { SlotNumber } from '@aztec/foundation/branded-types';
6
+ import { createEthereumChain } from '@aztec/ethereum/chain';
7
+ import { getPublicClient } from '@aztec/ethereum/client';
8
+ import { RegistryContract, RollupContract } from '@aztec/ethereum/contracts';
9
+ import type { L1ContractAddresses } from '@aztec/ethereum/l1-contract-addresses';
10
+ import { BlockNumber, CheckpointNumber, EpochNumber, SlotNumber } from '@aztec/foundation/branded-types';
21
11
  import { compactArray, pick } from '@aztec/foundation/collection';
12
+ import { Fr } from '@aztec/foundation/curves/bn254';
22
13
  import { EthAddress } from '@aztec/foundation/eth-address';
23
- import { Fr } from '@aztec/foundation/fields';
24
14
  import { BadRequestError } from '@aztec/foundation/json-rpc';
25
15
  import { type Logger, createLogger } from '@aztec/foundation/log';
26
16
  import { count } from '@aztec/foundation/string';
@@ -28,16 +18,13 @@ import { DateProvider, Timer } from '@aztec/foundation/timer';
28
18
  import { MembershipWitness, SiblingPath } from '@aztec/foundation/trees';
29
19
  import { KeystoreManager, loadKeystores, mergeKeystores } from '@aztec/node-keystore';
30
20
  import { trySnapshotSync, uploadSnapshot } from '@aztec/node-lib/actions';
31
- import { createL1TxUtilsWithBlobsFromEthSigner } from '@aztec/node-lib/factories';
21
+ import {
22
+ createForwarderL1TxUtilsFromEthSigner,
23
+ createL1TxUtilsWithBlobsFromEthSigner,
24
+ } from '@aztec/node-lib/factories';
32
25
  import { type P2P, type P2PClientDeps, createP2PClient, getDefaultAllowedSetupFunctions } from '@aztec/p2p';
33
26
  import { ProtocolContractAddress } from '@aztec/protocol-contracts';
34
- import {
35
- BlockBuilder,
36
- GlobalVariableBuilder,
37
- SequencerClient,
38
- type SequencerPublisher,
39
- createValidatorForAcceptingTxs,
40
- } from '@aztec/sequencer-client';
27
+ import { GlobalVariableBuilder, SequencerClient, type SequencerPublisher } from '@aztec/sequencer-client';
41
28
  import { PublicProcessorFactory } from '@aztec/simulator/server';
42
29
  import {
43
30
  AttestationsBlockWatcher,
@@ -46,16 +33,10 @@ import {
46
33
  type Watcher,
47
34
  createSlasher,
48
35
  } from '@aztec/slasher';
49
- import { PublicSimulatorConfig } from '@aztec/stdlib/avm';
36
+ import { CollectionLimitsConfig, PublicSimulatorConfig } from '@aztec/stdlib/avm';
50
37
  import { AztecAddress } from '@aztec/stdlib/aztec-address';
51
- import {
52
- type InBlock,
53
- type L2Block,
54
- L2BlockHash,
55
- type L2BlockNumber,
56
- type L2BlockSource,
57
- type PublishedL2Block,
58
- } from '@aztec/stdlib/block';
38
+ import { BlockHash, type BlockParameter, type DataInBlock, L2Block, type L2BlockSource } from '@aztec/stdlib/block';
39
+ import type { PublishedCheckpoint } from '@aztec/stdlib/checkpoint';
59
40
  import type {
60
41
  ContractClassPublic,
61
42
  ContractDataSource,
@@ -63,7 +44,7 @@ import type {
63
44
  NodeInfo,
64
45
  ProtocolContractAddresses,
65
46
  } from '@aztec/stdlib/contract';
66
- import type { GasFees } from '@aztec/stdlib/gas';
47
+ import { GasFees } from '@aztec/stdlib/gas';
67
48
  import { computePublicDataTreeLeafSlot } from '@aztec/stdlib/hash';
68
49
  import {
69
50
  type AztecNode,
@@ -82,7 +63,7 @@ import {
82
63
  type WorldStateSynchronizer,
83
64
  tryStop,
84
65
  } from '@aztec/stdlib/interfaces/server';
85
- import type { LogFilter, PrivateLog, TxScopedL2Log } from '@aztec/stdlib/logs';
66
+ import type { LogFilter, SiloedTag, Tag, TxScopedL2Log } from '@aztec/stdlib/logs';
86
67
  import { InboxLeaf, type L1ToL2MessageSource } from '@aztec/stdlib/messaging';
87
68
  import { P2PClientType } from '@aztec/stdlib/p2p';
88
69
  import type { Offense, SlashPayloadRound } from '@aztec/stdlib/slashing';
@@ -110,10 +91,13 @@ import {
110
91
  trackSpan,
111
92
  } from '@aztec/telemetry-client';
112
93
  import {
94
+ FullNodeCheckpointsBuilder as CheckpointsBuilder,
95
+ FullNodeCheckpointsBuilder,
113
96
  NodeKeystoreAdapter,
114
97
  ValidatorClient,
115
98
  createBlockProposalHandler,
116
99
  createValidatorClient,
100
+ createValidatorForAcceptingTxs,
117
101
  } from '@aztec/validator-client';
118
102
  import { createWorldStateSynchronizer } from '@aztec/world-state';
119
103
 
@@ -129,6 +113,7 @@ import { NodeMetrics } from './node_metrics.js';
129
113
  */
130
114
  export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
131
115
  private metrics: NodeMetrics;
116
+ private initialHeaderHashPromise: Promise<BlockHash> | undefined = undefined;
132
117
 
133
118
  // Prevent two snapshot operations to happen simultaneously
134
119
  private isUploadingSnapshot = false;
@@ -155,6 +140,7 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
155
140
  private proofVerifier: ClientProtocolCircuitVerifier,
156
141
  private telemetry: TelemetryClient = getTelemetryClient(),
157
142
  private log = createLogger('node'),
143
+ private blobClient?: BlobClientInterface,
158
144
  ) {
159
145
  this.metrics = new NodeMetrics(telemetry, 'AztecNodeService');
160
146
  this.tracer = telemetry.getTracer('AztecNodeService');
@@ -184,7 +170,6 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
184
170
  logger?: Logger;
185
171
  publisher?: SequencerPublisher;
186
172
  dateProvider?: DateProvider;
187
- blobSinkClient?: BlobSinkClientInterface;
188
173
  p2pClientDeps?: P2PClientDeps<P2PClientType.Full>;
189
174
  } = {},
190
175
  options: {
@@ -197,8 +182,6 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
197
182
  const packageVersion = getPackageVersion() ?? '';
198
183
  const telemetry = deps.telemetry ?? getTelemetryClient();
199
184
  const dateProvider = deps.dateProvider ?? new DateProvider();
200
- const blobSinkClient =
201
- deps.blobSinkClient ?? createBlobSinkClient(config, { logger: createLogger('node:blob-sink:client') });
202
185
  const ethereumChain = createEthereumChain(config.l1RpcUrls, config.l1ChainId);
203
186
 
204
187
  // Build a key store from file if given or from environment otherwise
@@ -238,7 +221,7 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
238
221
 
239
222
  const publicClient = createPublicClient({
240
223
  chain: ethereumChain.chainInfo,
241
- transport: fallback(config.l1RpcUrls.map((url: string) => http(url))),
224
+ transport: fallback(config.l1RpcUrls.map((url: string) => http(url, { batch: false }))),
242
225
  pollingInterval: config.viemPollingIntervalMS,
243
226
  });
244
227
 
@@ -266,6 +249,8 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
266
249
  );
267
250
  }
268
251
 
252
+ const blobClient = await createBlobClientWithFileStores(config, createLogger('node:blob-client:client'));
253
+
269
254
  // attempt snapshot sync if possible
270
255
  await trySnapshotSync(config, log);
271
256
 
@@ -273,7 +258,7 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
273
258
 
274
259
  const archiver = await createArchiver(
275
260
  config,
276
- { blobSinkClient, epochCache, telemetry, dateProvider },
261
+ { blobClient, epochCache, telemetry, dateProvider },
277
262
  { blockUntilSync: !config.skipArchiverInitialSync },
278
263
  );
279
264
 
@@ -284,9 +269,10 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
284
269
  options.prefilledPublicData,
285
270
  telemetry,
286
271
  );
287
- const circuitVerifier = config.realProofs
288
- ? await BBCircuitVerifier.new(config)
289
- : new TestCircuitVerifier(config.proverTestVerificationDelayMs);
272
+ const circuitVerifier =
273
+ config.realProofs || config.debugForceTxProofVerification
274
+ ? await BBCircuitVerifier.new(config)
275
+ : new TestCircuitVerifier(config.proverTestVerificationDelayMs);
290
276
  if (!config.realProofs) {
291
277
  log.warn(`Aztec node is accepting fake proofs`);
292
278
  }
@@ -309,7 +295,8 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
309
295
  // We should really not be modifying the config object
310
296
  config.txPublicSetupAllowList = config.txPublicSetupAllowList ?? (await getDefaultAllowedSetupFunctions());
311
297
 
312
- const blockBuilder = new BlockBuilder(
298
+ // Create FullNodeCheckpointsBuilder for validator and non-validator block proposal handling
299
+ const validatorCheckpointsBuilder = new FullNodeCheckpointsBuilder(
313
300
  { ...config, l1GenesisTime, slotDuration: Number(slotDuration) },
314
301
  worldStateSynchronizer,
315
302
  archiver,
@@ -321,15 +308,17 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
321
308
  const watchers: Watcher[] = [];
322
309
 
323
310
  // Create validator client if required
324
- const validatorClient = createValidatorClient(config, {
311
+ const validatorClient = await createValidatorClient(config, {
312
+ checkpointsBuilder: validatorCheckpointsBuilder,
313
+ worldState: worldStateSynchronizer,
325
314
  p2pClient,
326
315
  telemetry,
327
316
  dateProvider,
328
317
  epochCache,
329
- blockBuilder,
330
318
  blockSource: archiver,
331
319
  l1ToL2MessageSource: archiver,
332
320
  keyStoreManager,
321
+ blobClient,
333
322
  });
334
323
 
335
324
  // If we have a validator client, register it as a source of offenses for the slasher,
@@ -347,7 +336,8 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
347
336
  if (!validatorClient && config.alwaysReexecuteBlockProposals) {
348
337
  log.info('Setting up block proposal reexecution for monitoring');
349
338
  createBlockProposalHandler(config, {
350
- blockBuilder,
339
+ checkpointsBuilder: validatorCheckpointsBuilder,
340
+ worldState: worldStateSynchronizer,
351
341
  epochCache,
352
342
  blockSource: archiver,
353
343
  l1ToL2MessageSource: archiver,
@@ -375,7 +365,7 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
375
365
  archiver,
376
366
  epochCache,
377
367
  p2pClient.getTxProvider(),
378
- blockBuilder,
368
+ validatorCheckpointsBuilder,
379
369
  config,
380
370
  );
381
371
  watchers.push(epochPruneWatcher);
@@ -403,7 +393,7 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
403
393
  // Validator enabled, create/start relevant service
404
394
  let sequencer: SequencerClient | undefined;
405
395
  let slasherClient: SlasherClientInterface | undefined;
406
- if (!config.disableValidator) {
396
+ if (!config.disableValidator && validatorClient) {
407
397
  // We create a slasher only if we have a sequencer, since all slashing actions go through the sequencer publisher
408
398
  // as they are executed when the node is selected as proposer.
409
399
  const validatorAddresses = keyStoreManager
@@ -422,14 +412,30 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
422
412
  );
423
413
  await slasherClient.start();
424
414
 
425
- const l1TxUtils = await createL1TxUtilsWithBlobsFromEthSigner(
426
- publicClient,
427
- keyStoreManager!.createAllValidatorPublisherSigners(),
428
- { ...config, scope: 'sequencer' },
429
- { telemetry, logger: log.createChild('l1-tx-utils'), dateProvider },
430
- );
415
+ const l1TxUtils = config.publisherForwarderAddress
416
+ ? await createForwarderL1TxUtilsFromEthSigner(
417
+ publicClient,
418
+ keyStoreManager!.createAllValidatorPublisherSigners(),
419
+ config.publisherForwarderAddress,
420
+ { ...config, scope: 'sequencer' },
421
+ { telemetry, logger: log.createChild('l1-tx-utils'), dateProvider },
422
+ )
423
+ : await createL1TxUtilsWithBlobsFromEthSigner(
424
+ publicClient,
425
+ keyStoreManager!.createAllValidatorPublisherSigners(),
426
+ { ...config, scope: 'sequencer' },
427
+ { telemetry, logger: log.createChild('l1-tx-utils'), dateProvider },
428
+ );
431
429
 
432
430
  // Create and start the sequencer client
431
+ const checkpointsBuilder = new CheckpointsBuilder(
432
+ { ...config, l1GenesisTime, slotDuration: Number(slotDuration) },
433
+ worldStateSynchronizer,
434
+ archiver,
435
+ dateProvider,
436
+ telemetry,
437
+ );
438
+
433
439
  sequencer = await SequencerClient.new(config, {
434
440
  ...deps,
435
441
  epochCache,
@@ -438,12 +444,12 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
438
444
  p2pClient,
439
445
  worldStateSynchronizer,
440
446
  slasherClient,
441
- blockBuilder,
447
+ checkpointsBuilder,
442
448
  l2BlockSource: archiver,
443
449
  l1ToL2MessageSource: archiver,
444
450
  telemetry,
445
451
  dateProvider,
446
- blobSinkClient,
452
+ blobClient,
447
453
  nodeKeyStore: keyStoreManager!,
448
454
  });
449
455
  }
@@ -455,6 +461,13 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
455
461
  log.warn(`Sequencer created but not started`);
456
462
  }
457
463
 
464
+ const globalVariableBuilder = new GlobalVariableBuilder({
465
+ ...config,
466
+ rollupVersion: BigInt(config.rollupVersion),
467
+ l1GenesisTime,
468
+ slotDuration: Number(slotDuration),
469
+ });
470
+
458
471
  return new AztecNodeService(
459
472
  config,
460
473
  p2pClient,
@@ -469,12 +482,13 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
469
482
  epochPruneWatcher,
470
483
  ethereumChain.chainInfo.id,
471
484
  config.rollupVersion,
472
- new GlobalVariableBuilder(config),
485
+ globalVariableBuilder,
473
486
  epochCache,
474
487
  packageVersion,
475
488
  proofVerifier,
476
489
  telemetry,
477
490
  log,
491
+ blobClient,
478
492
  );
479
493
  }
480
494
 
@@ -545,13 +559,19 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
545
559
  }
546
560
 
547
561
  /**
548
- * Get a block specified by its number.
549
- * @param number - The block number being requested.
562
+ * Get a block specified by its block number, block hash, or 'latest'.
563
+ * @param block - The block parameter (block number, block hash, or 'latest').
550
564
  * @returns The requested block.
551
565
  */
552
- public async getBlock(number: L2BlockNumber): Promise<L2Block | undefined> {
553
- const blockNumber = number === 'latest' ? await this.getBlockNumber() : number;
554
- return await this.blockSource.getBlock(blockNumber);
566
+ public async getBlock(block: BlockParameter): Promise<L2Block | undefined> {
567
+ if (BlockHash.isBlockHash(block)) {
568
+ return this.getBlockByHash(block);
569
+ }
570
+ const blockNumber = block === 'latest' ? await this.getBlockNumber() : (block as BlockNumber);
571
+ if (blockNumber === BlockNumber.ZERO) {
572
+ return this.buildInitialBlock();
573
+ }
574
+ return await this.blockSource.getL2Block(blockNumber);
555
575
  }
556
576
 
557
577
  /**
@@ -559,9 +579,17 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
559
579
  * @param blockHash - The block hash being requested.
560
580
  * @returns The requested block.
561
581
  */
562
- public async getBlockByHash(blockHash: Fr): Promise<L2Block | undefined> {
563
- const publishedBlock = await this.blockSource.getPublishedBlockByHash(blockHash);
564
- return publishedBlock?.block;
582
+ public async getBlockByHash(blockHash: BlockHash): Promise<L2Block | undefined> {
583
+ const initialBlockHash = await this.#getInitialHeaderHash();
584
+ if (blockHash.equals(initialBlockHash)) {
585
+ return this.buildInitialBlock();
586
+ }
587
+ return await this.blockSource.getL2BlockByHash(blockHash);
588
+ }
589
+
590
+ private buildInitialBlock(): L2Block {
591
+ const initialHeader = this.worldStateSynchronizer.getCommitted().getInitialHeader();
592
+ return L2Block.empty(initialHeader);
565
593
  }
566
594
 
567
595
  /**
@@ -570,8 +598,7 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
570
598
  * @returns The requested block.
571
599
  */
572
600
  public async getBlockByArchive(archive: Fr): Promise<L2Block | undefined> {
573
- const publishedBlock = await this.blockSource.getPublishedBlockByArchive(archive);
574
- return publishedBlock?.block;
601
+ return await this.blockSource.getL2BlockByArchive(archive);
575
602
  }
576
603
 
577
604
  /**
@@ -580,34 +607,50 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
580
607
  * @param limit - The maximum number of blocks to obtain.
581
608
  * @returns The blocks requested.
582
609
  */
583
- public async getBlocks(from: number, limit: number): Promise<L2Block[]> {
584
- return (await this.blockSource.getBlocks(from, limit)) ?? [];
610
+ public async getBlocks(from: BlockNumber, limit: number): Promise<L2Block[]> {
611
+ return (await this.blockSource.getBlocks(from, BlockNumber(limit))) ?? [];
612
+ }
613
+
614
+ public async getCheckpoints(from: CheckpointNumber, limit: number): Promise<PublishedCheckpoint[]> {
615
+ return (await this.blockSource.getCheckpoints(from, limit)) ?? [];
585
616
  }
586
617
 
587
- public async getPublishedBlocks(from: number, limit: number): Promise<PublishedL2Block[]> {
588
- return (await this.blockSource.getPublishedBlocks(from, limit)) ?? [];
618
+ public async getCheckpointedBlocks(from: BlockNumber, limit: number) {
619
+ return (await this.blockSource.getCheckpointedBlocks(from, limit)) ?? [];
589
620
  }
590
621
 
591
622
  /**
592
- * Method to fetch the current base fees.
593
- * @returns The current base fees.
623
+ * Method to fetch the current min L2 fees.
624
+ * @returns The current min L2 fees.
594
625
  */
595
- public async getCurrentBaseFees(): Promise<GasFees> {
596
- return await this.globalVariableBuilder.getCurrentBaseFees();
626
+ public async getCurrentMinFees(): Promise<GasFees> {
627
+ return await this.globalVariableBuilder.getCurrentMinFees();
628
+ }
629
+
630
+ public async getMaxPriorityFees(): Promise<GasFees> {
631
+ for await (const tx of this.p2pClient.iteratePendingTxs()) {
632
+ return tx.getGasSettings().maxPriorityFeesPerGas;
633
+ }
634
+
635
+ return GasFees.from({ feePerDaGas: 0n, feePerL2Gas: 0n });
597
636
  }
598
637
 
599
638
  /**
600
639
  * Method to fetch the latest block number synchronized by the node.
601
640
  * @returns The block number.
602
641
  */
603
- public async getBlockNumber(): Promise<number> {
642
+ public async getBlockNumber(): Promise<BlockNumber> {
604
643
  return await this.blockSource.getBlockNumber();
605
644
  }
606
645
 
607
- public async getProvenBlockNumber(): Promise<number> {
646
+ public async getProvenBlockNumber(): Promise<BlockNumber> {
608
647
  return await this.blockSource.getProvenBlockNumber();
609
648
  }
610
649
 
650
+ public async getCheckpointedBlockNumber(): Promise<BlockNumber> {
651
+ return await this.blockSource.getCheckpointedL2BlockNumber();
652
+ }
653
+
611
654
  /**
612
655
  * Method to fetch the version of the package.
613
656
  * @returns The node package version
@@ -640,25 +683,43 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
640
683
  return this.contractDataSource.getContract(address);
641
684
  }
642
685
 
643
- /**
644
- * Retrieves all private logs from up to `limit` blocks, starting from the block number `from`.
645
- * @param from - The block number from which to begin retrieving logs.
646
- * @param limit - The maximum number of blocks to retrieve logs from.
647
- * @returns An array of private logs from the specified range of blocks.
648
- */
649
- public getPrivateLogs(from: number, limit: number): Promise<PrivateLog[]> {
650
- return this.logsSource.getPrivateLogs(from, limit);
651
- }
652
-
653
- /**
654
- * Gets all logs that match any of the received tags (i.e. logs with their first field equal to a tag).
655
- * @param tags - The tags to filter the logs by.
656
- * @param logsPerTag - The maximum number of logs to return for each tag. By default no limit is set
657
- * @returns For each received tag, an array of matching logs is returned. An empty array implies no logs match
658
- * that tag.
659
- */
660
- public getLogsByTags(tags: Fr[], logsPerTag?: number): Promise<TxScopedL2Log[][]> {
661
- return this.logsSource.getLogsByTags(tags, logsPerTag);
686
+ public async getPrivateLogsByTags(
687
+ tags: SiloedTag[],
688
+ page?: number,
689
+ referenceBlock?: BlockHash,
690
+ ): Promise<TxScopedL2Log[][]> {
691
+ if (referenceBlock) {
692
+ const initialBlockHash = await this.#getInitialHeaderHash();
693
+ if (!referenceBlock.equals(initialBlockHash)) {
694
+ const header = await this.blockSource.getBlockHeaderByHash(referenceBlock);
695
+ if (!header) {
696
+ throw new Error(
697
+ `Block ${referenceBlock.toString()} not found in the node. This might indicate a reorg has occurred.`,
698
+ );
699
+ }
700
+ }
701
+ }
702
+ return this.logsSource.getPrivateLogsByTags(tags, page);
703
+ }
704
+
705
+ public async getPublicLogsByTagsFromContract(
706
+ contractAddress: AztecAddress,
707
+ tags: Tag[],
708
+ page?: number,
709
+ referenceBlock?: BlockHash,
710
+ ): Promise<TxScopedL2Log[][]> {
711
+ if (referenceBlock) {
712
+ const initialBlockHash = await this.#getInitialHeaderHash();
713
+ if (!referenceBlock.equals(initialBlockHash)) {
714
+ const header = await this.blockSource.getBlockHeaderByHash(referenceBlock);
715
+ if (!header) {
716
+ throw new Error(
717
+ `Block ${referenceBlock.toString()} not found in the node. This might indicate a reorg has occurred.`,
718
+ );
719
+ }
720
+ }
721
+ }
722
+ return this.logsSource.getPublicLogsByTagsFromContract(contractAddress, tags, page);
662
723
  }
663
724
 
664
725
  /**
@@ -705,21 +766,26 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
705
766
  }
706
767
 
707
768
  public async getTxReceipt(txHash: TxHash): Promise<TxReceipt> {
708
- let txReceipt = new TxReceipt(txHash, TxStatus.DROPPED, 'Tx dropped by P2P node.');
709
-
710
- // We first check if the tx is in pending (instead of first checking if it is mined) because if we first check
711
- // for mined and then for pending there could be a race condition where the tx is mined between the two checks
712
- // and we would incorrectly return a TxReceipt with status DROPPED
713
- if ((await this.p2pClient.getTxStatus(txHash)) === 'pending') {
714
- txReceipt = new TxReceipt(txHash, TxStatus.PENDING, '');
715
- }
769
+ // Check the tx pool status first. If the tx is known to the pool (pending or mined), we'll use that
770
+ // as a fallback if we don't find a settled receipt in the archiver.
771
+ const txPoolStatus = await this.p2pClient.getTxStatus(txHash);
772
+ const isKnownToPool = txPoolStatus === 'pending' || txPoolStatus === 'mined';
716
773
 
774
+ // Then get the actual tx from the archiver, which tracks every tx in a mined block.
717
775
  const settledTxReceipt = await this.blockSource.getSettledTxReceipt(txHash);
776
+
718
777
  if (settledTxReceipt) {
719
- txReceipt = settledTxReceipt;
778
+ // If the archiver has the receipt then return it.
779
+ return settledTxReceipt;
780
+ } else if (isKnownToPool) {
781
+ // If the tx is in the pool but not in the archiver, it's pending.
782
+ // This handles race conditions between archiver and p2p, where the archiver
783
+ // has pruned the block in which a tx was mined, but p2p has not caught up yet.
784
+ return new TxReceipt(txHash, TxStatus.PENDING, undefined, undefined);
785
+ } else {
786
+ // Otherwise, if we don't know the tx, we consider it dropped.
787
+ return new TxReceipt(txHash, TxStatus.DROPPED, undefined, 'Tx dropped by P2P node');
720
788
  }
721
-
722
- return txReceipt;
723
789
  }
724
790
 
725
791
  public getTxEffect(txHash: TxHash): Promise<IndexedTxEffect | undefined> {
@@ -739,10 +805,19 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
739
805
  await tryStop(this.p2pClient);
740
806
  await tryStop(this.worldStateSynchronizer);
741
807
  await tryStop(this.blockSource);
808
+ await tryStop(this.blobClient);
742
809
  await tryStop(this.telemetry);
743
810
  this.log.info(`Stopped Aztec Node`);
744
811
  }
745
812
 
813
+ /**
814
+ * Returns the blob client used by this node.
815
+ * @internal - Exposed for testing purposes only.
816
+ */
817
+ public getBlobClient(): BlobClientInterface | undefined {
818
+ return this.blobClient;
819
+ }
820
+
746
821
  /**
747
822
  * Method to retrieve pending txs.
748
823
  * @param limit - The number of items to returns
@@ -775,20 +850,12 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
775
850
  return compactArray(await Promise.all(txHashes.map(txHash => this.getTxByHash(txHash))));
776
851
  }
777
852
 
778
- /**
779
- * Find the indexes of the given leaves in the given tree along with a block metadata pointing to the block in which
780
- * the leaves were inserted.
781
- * @param blockNumber - The block number at which to get the data or 'latest' for latest data.
782
- * @param treeId - The tree to search in.
783
- * @param leafValues - The values to search for.
784
- * @returns The indices of leaves and the block metadata of a block in which the leaves were inserted.
785
- */
786
853
  public async findLeavesIndexes(
787
- blockNumber: L2BlockNumber,
854
+ referenceBlock: BlockParameter,
788
855
  treeId: MerkleTreeId,
789
856
  leafValues: Fr[],
790
- ): Promise<(InBlock<bigint> | undefined)[]> {
791
- const committedDb = await this.#getWorldState(blockNumber);
857
+ ): Promise<(DataInBlock<bigint> | undefined)[]> {
858
+ const committedDb = await this.#getWorldState(referenceBlock);
792
859
  const maybeIndices = await committedDb.findLeafIndices(
793
860
  treeId,
794
861
  leafValues.map(x => x.toBuffer()),
@@ -813,7 +880,7 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
813
880
  // (note that block number corresponds to the leaf index in the archive tree).
814
881
  const blockHashes = await Promise.all(
815
882
  uniqueBlockNumbers.map(blockNumber => {
816
- return committedDb.getLeafValue(MerkleTreeId.ARCHIVE, blockNumber!);
883
+ return committedDb.getLeafValue(MerkleTreeId.ARCHIVE, BigInt(blockNumber));
817
884
  }),
818
885
  );
819
886
 
@@ -824,7 +891,7 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
824
891
  }
825
892
  }
826
893
 
827
- // Create InBlock objects by combining indices, blockNumbers and blockHashes and return them.
894
+ // Create DataInBlock objects by combining indices, blockNumbers and blockHashes and return them.
828
895
  return maybeIndices.map((index, i) => {
829
896
  if (index === undefined) {
830
897
  return undefined;
@@ -839,57 +906,29 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
839
906
  return undefined;
840
907
  }
841
908
  return {
842
- l2BlockNumber: Number(blockNumber),
843
- l2BlockHash: L2BlockHash.fromField(blockHash),
909
+ l2BlockNumber: BlockNumber(Number(blockNumber)),
910
+ l2BlockHash: new BlockHash(blockHash),
844
911
  data: index,
845
912
  };
846
913
  });
847
914
  }
848
915
 
849
- /**
850
- * Returns a sibling path for the given index in the nullifier tree.
851
- * @param blockNumber - The block number at which to get the data.
852
- * @param leafIndex - The index of the leaf for which the sibling path is required.
853
- * @returns The sibling path for the leaf index.
854
- */
855
- public async getNullifierSiblingPath(
856
- blockNumber: L2BlockNumber,
857
- leafIndex: bigint,
858
- ): Promise<SiblingPath<typeof NULLIFIER_TREE_HEIGHT>> {
859
- const committedDb = await this.#getWorldState(blockNumber);
860
- return committedDb.getSiblingPath(MerkleTreeId.NULLIFIER_TREE, leafIndex);
861
- }
862
-
863
- /**
864
- * Returns a sibling path for the given index in the data tree.
865
- * @param blockNumber - The block number at which to get the data.
866
- * @param leafIndex - The index of the leaf for which the sibling path is required.
867
- * @returns The sibling path for the leaf index.
868
- */
869
- public async getNoteHashSiblingPath(
870
- blockNumber: L2BlockNumber,
871
- leafIndex: bigint,
872
- ): Promise<SiblingPath<typeof NOTE_HASH_TREE_HEIGHT>> {
873
- const committedDb = await this.#getWorldState(blockNumber);
874
- return committedDb.getSiblingPath(MerkleTreeId.NOTE_HASH_TREE, leafIndex);
875
- }
876
-
877
- public async getArchiveMembershipWitness(
878
- blockNumber: L2BlockNumber,
879
- archive: Fr,
916
+ public async getBlockHashMembershipWitness(
917
+ referenceBlock: BlockParameter,
918
+ blockHash: BlockHash,
880
919
  ): Promise<MembershipWitness<typeof ARCHIVE_HEIGHT> | undefined> {
881
- const committedDb = await this.#getWorldState(blockNumber);
882
- const [pathAndIndex] = await committedDb.findSiblingPaths<MerkleTreeId.ARCHIVE>(MerkleTreeId.ARCHIVE, [archive]);
920
+ const committedDb = await this.#getWorldState(referenceBlock);
921
+ const [pathAndIndex] = await committedDb.findSiblingPaths<MerkleTreeId.ARCHIVE>(MerkleTreeId.ARCHIVE, [blockHash]);
883
922
  return pathAndIndex === undefined
884
923
  ? undefined
885
924
  : MembershipWitness.fromSiblingPath(pathAndIndex.index, pathAndIndex.path);
886
925
  }
887
926
 
888
927
  public async getNoteHashMembershipWitness(
889
- blockNumber: L2BlockNumber,
928
+ referenceBlock: BlockParameter,
890
929
  noteHash: Fr,
891
930
  ): Promise<MembershipWitness<typeof NOTE_HASH_TREE_HEIGHT> | undefined> {
892
- const committedDb = await this.#getWorldState(blockNumber);
931
+ const committedDb = await this.#getWorldState(referenceBlock);
893
932
  const [pathAndIndex] = await committedDb.findSiblingPaths<MerkleTreeId.NOTE_HASH_TREE>(
894
933
  MerkleTreeId.NOTE_HASH_TREE,
895
934
  [noteHash],
@@ -899,17 +938,11 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
899
938
  : MembershipWitness.fromSiblingPath(pathAndIndex.index, pathAndIndex.path);
900
939
  }
901
940
 
902
- /**
903
- * Returns the index and a sibling path for a leaf in the committed l1 to l2 data tree.
904
- * @param blockNumber - The block number at which to get the data.
905
- * @param l1ToL2Message - The l1ToL2Message to get the index / sibling path for.
906
- * @returns A tuple of the index and the sibling path of the L1ToL2Message (undefined if not found).
907
- */
908
941
  public async getL1ToL2MessageMembershipWitness(
909
- blockNumber: L2BlockNumber,
942
+ referenceBlock: BlockParameter,
910
943
  l1ToL2Message: Fr,
911
944
  ): Promise<[bigint, SiblingPath<typeof L1_TO_L2_MSG_TREE_HEIGHT>] | undefined> {
912
- const db = await this.#getWorldState(blockNumber);
945
+ const db = await this.#getWorldState(referenceBlock);
913
946
  const [witness] = await db.findSiblingPaths(MerkleTreeId.L1_TO_L2_MESSAGE_TREE, [l1ToL2Message]);
914
947
  if (!witness) {
915
948
  return undefined;
@@ -919,9 +952,11 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
919
952
  return [witness.index, witness.path];
920
953
  }
921
954
 
922
- public async getL1ToL2MessageBlock(l1ToL2Message: Fr): Promise<number | undefined> {
955
+ public async getL1ToL2MessageBlock(l1ToL2Message: Fr): Promise<BlockNumber | undefined> {
923
956
  const messageIndex = await this.l1ToL2MessageSource.getL1ToL2MessageIndex(l1ToL2Message);
924
- return messageIndex ? InboxLeaf.l2BlockFromIndex(messageIndex) : undefined;
957
+ return messageIndex
958
+ ? BlockNumber.fromCheckpointNumber(InboxLeaf.checkpointNumberFromIndex(messageIndex))
959
+ : undefined;
925
960
  }
926
961
 
927
962
  /**
@@ -935,54 +970,36 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
935
970
  }
936
971
 
937
972
  /**
938
- * Returns all the L2 to L1 messages in a block.
939
- * @param blockNumber - The block number at which to get the data.
940
- * @returns The L2 to L1 messages (undefined if the block number is not found).
941
- */
942
- public async getL2ToL1Messages(blockNumber: L2BlockNumber): Promise<Fr[][] | undefined> {
943
- const block = await this.blockSource.getBlock(blockNumber === 'latest' ? await this.getBlockNumber() : blockNumber);
944
- return block?.body.txEffects.map(txEffect => txEffect.l2ToL1Msgs);
945
- }
946
-
947
- /**
948
- * Returns a sibling path for a leaf in the committed blocks tree.
949
- * @param blockNumber - The block number at which to get the data.
950
- * @param leafIndex - Index of the leaf in the tree.
951
- * @returns The sibling path.
973
+ * Returns all the L2 to L1 messages in an epoch.
974
+ * @param epoch - The epoch at which to get the data.
975
+ * @returns The L2 to L1 messages (empty array if the epoch is not found).
952
976
  */
953
- public async getArchiveSiblingPath(
954
- blockNumber: L2BlockNumber,
955
- leafIndex: bigint,
956
- ): Promise<SiblingPath<typeof ARCHIVE_HEIGHT>> {
957
- const committedDb = await this.#getWorldState(blockNumber);
958
- return committedDb.getSiblingPath(MerkleTreeId.ARCHIVE, leafIndex);
959
- }
960
-
961
- /**
962
- * Returns a sibling path for a leaf in the committed public data tree.
963
- * @param blockNumber - The block number at which to get the data.
964
- * @param leafIndex - Index of the leaf in the tree.
965
- * @returns The sibling path.
966
- */
967
- public async getPublicDataSiblingPath(
968
- blockNumber: L2BlockNumber,
969
- leafIndex: bigint,
970
- ): Promise<SiblingPath<typeof PUBLIC_DATA_TREE_HEIGHT>> {
971
- const committedDb = await this.#getWorldState(blockNumber);
972
- return committedDb.getSiblingPath(MerkleTreeId.PUBLIC_DATA_TREE, leafIndex);
977
+ public async getL2ToL1Messages(epoch: EpochNumber): Promise<Fr[][][][]> {
978
+ // Assumes `getCheckpointedBlocksForEpoch` returns blocks in ascending order of block number.
979
+ const checkpointedBlocks = await this.blockSource.getCheckpointedBlocksForEpoch(epoch);
980
+ const blocksInCheckpoints: L2Block[][] = [];
981
+ let previousSlotNumber = SlotNumber.ZERO;
982
+ let checkpointIndex = -1;
983
+ for (const checkpointedBlock of checkpointedBlocks) {
984
+ const block = checkpointedBlock.block;
985
+ const slotNumber = block.header.globalVariables.slotNumber;
986
+ if (slotNumber !== previousSlotNumber) {
987
+ checkpointIndex++;
988
+ blocksInCheckpoints.push([]);
989
+ previousSlotNumber = slotNumber;
990
+ }
991
+ blocksInCheckpoints[checkpointIndex].push(block);
992
+ }
993
+ return blocksInCheckpoints.map(blocks =>
994
+ blocks.map(block => block.body.txEffects.map(txEffect => txEffect.l2ToL1Msgs)),
995
+ );
973
996
  }
974
997
 
975
- /**
976
- * Returns a nullifier membership witness for a given nullifier at a given block.
977
- * @param blockNumber - The block number at which to get the index.
978
- * @param nullifier - Nullifier we try to find witness for.
979
- * @returns The nullifier membership witness (if found).
980
- */
981
998
  public async getNullifierMembershipWitness(
982
- blockNumber: L2BlockNumber,
999
+ referenceBlock: BlockParameter,
983
1000
  nullifier: Fr,
984
1001
  ): Promise<NullifierMembershipWitness | undefined> {
985
- const db = await this.#getWorldState(blockNumber);
1002
+ const db = await this.#getWorldState(referenceBlock);
986
1003
  const [witness] = await db.findSiblingPaths(MerkleTreeId.NULLIFIER_TREE, [nullifier.toBuffer()]);
987
1004
  if (!witness) {
988
1005
  return undefined;
@@ -999,7 +1016,8 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
999
1016
 
1000
1017
  /**
1001
1018
  * Returns a low nullifier membership witness for a given nullifier at a given block.
1002
- * @param blockNumber - The block number at which to get the index.
1019
+ * @param referenceBlock - The block parameter (block number, block hash, or 'latest') at which to get the data
1020
+ * (which contains the root of the nullifier tree in which we are searching for the nullifier).
1003
1021
  * @param nullifier - Nullifier we try to find the low nullifier witness for.
1004
1022
  * @returns The low nullifier membership witness (if found).
1005
1023
  * @remarks Low nullifier witness can be used to perform a nullifier non-inclusion proof by leveraging the "linked
@@ -1012,10 +1030,10 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
1012
1030
  * TODO: This is a confusing behavior and we should eventually address that.
1013
1031
  */
1014
1032
  public async getLowNullifierMembershipWitness(
1015
- blockNumber: L2BlockNumber,
1033
+ referenceBlock: BlockParameter,
1016
1034
  nullifier: Fr,
1017
1035
  ): Promise<NullifierMembershipWitness | undefined> {
1018
- const committedDb = await this.#getWorldState(blockNumber);
1036
+ const committedDb = await this.#getWorldState(referenceBlock);
1019
1037
  const findResult = await committedDb.getPreviousValueIndex(MerkleTreeId.NULLIFIER_TREE, nullifier.toBigInt());
1020
1038
  if (!findResult) {
1021
1039
  return undefined;
@@ -1030,8 +1048,8 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
1030
1048
  return new NullifierMembershipWitness(BigInt(index), preimageData as NullifierLeafPreimage, siblingPath);
1031
1049
  }
1032
1050
 
1033
- async getPublicDataWitness(blockNumber: L2BlockNumber, leafSlot: Fr): Promise<PublicDataWitness | undefined> {
1034
- const committedDb = await this.#getWorldState(blockNumber);
1051
+ async getPublicDataWitness(referenceBlock: BlockParameter, leafSlot: Fr): Promise<PublicDataWitness | undefined> {
1052
+ const committedDb = await this.#getWorldState(referenceBlock);
1035
1053
  const lowLeafResult = await committedDb.getPreviousValueIndex(MerkleTreeId.PUBLIC_DATA_TREE, leafSlot.toBigInt());
1036
1054
  if (!lowLeafResult) {
1037
1055
  return undefined;
@@ -1045,19 +1063,8 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
1045
1063
  }
1046
1064
  }
1047
1065
 
1048
- /**
1049
- * Gets the storage value at the given contract storage slot.
1050
- *
1051
- * @remarks The storage slot here refers to the slot as it is defined in Noir not the index in the merkle tree.
1052
- * Aztec's version of `eth_getStorageAt`.
1053
- *
1054
- * @param contract - Address of the contract to query.
1055
- * @param slot - Slot to query.
1056
- * @param blockNumber - The block number at which to get the data or 'latest'.
1057
- * @returns Storage value at the given contract slot.
1058
- */
1059
- public async getPublicStorageAt(blockNumber: L2BlockNumber, contract: AztecAddress, slot: Fr): Promise<Fr> {
1060
- const committedDb = await this.#getWorldState(blockNumber);
1066
+ public async getPublicStorageAt(referenceBlock: BlockParameter, contract: AztecAddress, slot: Fr): Promise<Fr> {
1067
+ const committedDb = await this.#getWorldState(referenceBlock);
1061
1068
  const leafSlot = await computePublicDataTreeLeafSlot(contract, slot);
1062
1069
 
1063
1070
  const lowLeafResult = await committedDb.getPreviousValueIndex(MerkleTreeId.PUBLIC_DATA_TREE, leafSlot.toBigInt());
@@ -1071,23 +1078,22 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
1071
1078
  return preimage.leaf.value;
1072
1079
  }
1073
1080
 
1074
- /**
1075
- * Returns the currently committed block header, or the initial header if no blocks have been produced.
1076
- * @returns The current committed block header.
1077
- */
1078
- public async getBlockHeader(blockNumber: L2BlockNumber = 'latest'): Promise<BlockHeader | undefined> {
1079
- return blockNumber === 0 || (blockNumber === 'latest' && (await this.blockSource.getBlockNumber()) === 0)
1080
- ? this.worldStateSynchronizer.getCommitted().getInitialHeader()
1081
- : this.blockSource.getBlockHeader(blockNumber);
1082
- }
1083
-
1084
- /**
1085
- * Get a block header specified by its hash.
1086
- * @param blockHash - The block hash being requested.
1087
- * @returns The requested block header.
1088
- */
1089
- public async getBlockHeaderByHash(blockHash: Fr): Promise<BlockHeader | undefined> {
1090
- return await this.blockSource.getBlockHeaderByHash(blockHash);
1081
+ public async getBlockHeader(block: BlockParameter = 'latest'): Promise<BlockHeader | undefined> {
1082
+ if (BlockHash.isBlockHash(block)) {
1083
+ const initialBlockHash = await this.#getInitialHeaderHash();
1084
+ if (block.equals(initialBlockHash)) {
1085
+ // Block source doesn't handle initial header so we need to handle the case separately.
1086
+ return this.worldStateSynchronizer.getCommitted().getInitialHeader();
1087
+ }
1088
+ return this.blockSource.getBlockHeaderByHash(block);
1089
+ } else {
1090
+ // Block source doesn't handle initial header so we need to handle the case separately.
1091
+ const blockNumber = block === 'latest' ? await this.getBlockNumber() : (block as BlockNumber);
1092
+ if (blockNumber === BlockNumber.ZERO) {
1093
+ return this.worldStateSynchronizer.getCommitted().getInitialHeader();
1094
+ }
1095
+ return this.blockSource.getBlockHeader(block);
1096
+ }
1091
1097
  }
1092
1098
 
1093
1099
  /**
@@ -1122,7 +1128,7 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
1122
1128
  }
1123
1129
 
1124
1130
  const txHash = tx.getTxHash();
1125
- const blockNumber = (await this.blockSource.getBlockNumber()) + 1;
1131
+ const blockNumber = BlockNumber((await this.blockSource.getBlockNumber()) + 1);
1126
1132
 
1127
1133
  // If sequencer is not initialized, we just set these values to zero for simulation.
1128
1134
  const coinbase = EthAddress.ZERO;
@@ -1137,6 +1143,7 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
1137
1143
  this.contractDataSource,
1138
1144
  new DateProvider(),
1139
1145
  this.telemetry,
1146
+ this.log.getBindings(),
1140
1147
  );
1141
1148
 
1142
1149
  this.log.verbose(`Simulating public calls for tx ${txHash}`, {
@@ -1152,8 +1159,10 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
1152
1159
  collectDebugLogs: true,
1153
1160
  collectHints: false,
1154
1161
  collectCallMetadata: true,
1155
- maxDebugLogMemoryReads: this.config.rpcSimulatePublicMaxDebugLogMemoryReads,
1156
1162
  collectStatistics: false,
1163
+ collectionLimits: CollectionLimitsConfig.from({
1164
+ maxDebugLogMemoryReads: this.config.rpcSimulatePublicMaxDebugLogMemoryReads,
1165
+ }),
1157
1166
  });
1158
1167
  const processor = publicProcessorFactory.create(merkleTreeFork, newGlobalVariables, config);
1159
1168
 
@@ -1187,17 +1196,23 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
1187
1196
 
1188
1197
  // We accept transactions if they are not expired by the next slot (checked based on the IncludeByTimestamp field)
1189
1198
  const { ts: nextSlotTimestamp } = this.epochCache.getEpochAndSlotInNextL1Slot();
1190
- const blockNumber = (await this.blockSource.getBlockNumber()) + 1;
1191
- const validator = createValidatorForAcceptingTxs(db, this.contractDataSource, verifier, {
1192
- timestamp: nextSlotTimestamp,
1193
- blockNumber,
1194
- l1ChainId: this.l1ChainId,
1195
- rollupVersion: this.version,
1196
- setupAllowList: this.config.txPublicSetupAllowList ?? (await getDefaultAllowedSetupFunctions()),
1197
- gasFees: await this.getCurrentBaseFees(),
1198
- skipFeeEnforcement,
1199
- txsPermitted: !this.config.disableTransactions,
1200
- });
1199
+ const blockNumber = BlockNumber((await this.blockSource.getBlockNumber()) + 1);
1200
+ const validator = createValidatorForAcceptingTxs(
1201
+ db,
1202
+ this.contractDataSource,
1203
+ verifier,
1204
+ {
1205
+ timestamp: nextSlotTimestamp,
1206
+ blockNumber,
1207
+ l1ChainId: this.l1ChainId,
1208
+ rollupVersion: this.version,
1209
+ setupAllowList: this.config.txPublicSetupAllowList ?? (await getDefaultAllowedSetupFunctions()),
1210
+ gasFees: await this.getCurrentMinFees(),
1211
+ skipFeeEnforcement,
1212
+ txsPermitted: !this.config.disableTransactions,
1213
+ },
1214
+ this.log.getBindings(),
1215
+ );
1201
1216
 
1202
1217
  return await validator.validateTx(tx);
1203
1218
  }
@@ -1266,7 +1281,7 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
1266
1281
  }
1267
1282
 
1268
1283
  // And it has an L2 block hash
1269
- const l2BlockHash = await archiver.getL2Tips().then(tips => tips.latest.hash);
1284
+ const l2BlockHash = await archiver.getL2Tips().then(tips => tips.proposed.hash);
1270
1285
  if (!l2BlockHash) {
1271
1286
  this.metrics.recordSnapshotError();
1272
1287
  throw new Error(`Archiver has no latest L2 block hash downloaded. Cannot start snapshot.`);
@@ -1294,13 +1309,13 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
1294
1309
  return Promise.resolve();
1295
1310
  }
1296
1311
 
1297
- public async rollbackTo(targetBlock: number, force?: boolean): Promise<void> {
1312
+ public async rollbackTo(targetBlock: BlockNumber, force?: boolean): Promise<void> {
1298
1313
  const archiver = this.blockSource as Archiver;
1299
1314
  if (!('rollbackTo' in archiver)) {
1300
1315
  throw new Error('Archiver implementation does not support rollbacks.');
1301
1316
  }
1302
1317
 
1303
- const finalizedBlock = await archiver.getL2Tips().then(tips => tips.finalized.number);
1318
+ const finalizedBlock = await archiver.getL2Tips().then(tips => tips.finalized.block.number);
1304
1319
  if (targetBlock < finalizedBlock) {
1305
1320
  if (force) {
1306
1321
  this.log.warn(`Clearing world state database to allow rolling back behind finalized block ${finalizedBlock}`);
@@ -1361,17 +1376,20 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
1361
1376
  }
1362
1377
  }
1363
1378
 
1379
+ #getInitialHeaderHash(): Promise<BlockHash> {
1380
+ if (!this.initialHeaderHashPromise) {
1381
+ this.initialHeaderHashPromise = this.worldStateSynchronizer.getCommitted().getInitialHeader().hash();
1382
+ }
1383
+ return this.initialHeaderHashPromise;
1384
+ }
1385
+
1364
1386
  /**
1365
1387
  * Returns an instance of MerkleTreeOperations having first ensured the world state is fully synched
1366
- * @param blockNumber - The block number at which to get the data.
1388
+ * @param block - The block parameter (block number, block hash, or 'latest') at which to get the data.
1367
1389
  * @returns An instance of a committed MerkleTreeOperations
1368
1390
  */
1369
- async #getWorldState(blockNumber: L2BlockNumber) {
1370
- if (typeof blockNumber === 'number' && blockNumber < INITIAL_L2_BLOCK_NUM - 1) {
1371
- throw new Error('Invalid block number to get world state for: ' + blockNumber);
1372
- }
1373
-
1374
- let blockSyncedTo: number = 0;
1391
+ async #getWorldState(block: BlockParameter) {
1392
+ let blockSyncedTo: BlockNumber = BlockNumber.ZERO;
1375
1393
  try {
1376
1394
  // Attempt to sync the world state if necessary
1377
1395
  blockSyncedTo = await this.#syncWorldState();
@@ -1379,15 +1397,39 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
1379
1397
  this.log.error(`Error getting world state: ${err}`);
1380
1398
  }
1381
1399
 
1382
- // using a snapshot could be less efficient than using the committed db
1383
- if (blockNumber === 'latest' /*|| blockNumber === blockSyncedTo*/) {
1384
- this.log.debug(`Using committed db for block ${blockNumber}, world state synced upto ${blockSyncedTo}`);
1400
+ if (block === 'latest') {
1401
+ this.log.debug(`Using committed db for block 'latest', world state synced upto ${blockSyncedTo}`);
1385
1402
  return this.worldStateSynchronizer.getCommitted();
1386
- } else if (blockNumber <= blockSyncedTo) {
1403
+ }
1404
+
1405
+ if (BlockHash.isBlockHash(block)) {
1406
+ const initialBlockHash = await this.#getInitialHeaderHash();
1407
+ if (block.equals(initialBlockHash)) {
1408
+ // Block source doesn't handle initial header so we need to handle the case separately.
1409
+ return this.worldStateSynchronizer.getSnapshot(BlockNumber.ZERO);
1410
+ }
1411
+
1412
+ const header = await this.blockSource.getBlockHeaderByHash(block);
1413
+ if (!header) {
1414
+ throw new Error(
1415
+ `Block hash ${block.toString()} not found when querying world state. If the node API has been queried with anchor block hash possibly a reorg has occurred.`,
1416
+ );
1417
+ }
1418
+ const blockNumber = header.getBlockNumber();
1419
+ this.log.debug(`Using snapshot for block ${blockNumber}, world state synced upto ${blockSyncedTo}`);
1420
+ return this.worldStateSynchronizer.getSnapshot(blockNumber);
1421
+ }
1422
+
1423
+ // Block number provided
1424
+ {
1425
+ const blockNumber = block as BlockNumber;
1426
+
1427
+ if (blockNumber > blockSyncedTo) {
1428
+ throw new Error(`Queried block ${block} not yet synced by the node (node is synced upto ${blockSyncedTo}).`);
1429
+ }
1430
+
1387
1431
  this.log.debug(`Using snapshot for block ${blockNumber}, world state synced upto ${blockSyncedTo}`);
1388
1432
  return this.worldStateSynchronizer.getSnapshot(blockNumber);
1389
- } else {
1390
- throw new Error(`Block ${blockNumber} not yet synced`);
1391
1433
  }
1392
1434
  }
1393
1435
 
@@ -1395,8 +1437,8 @@ export class AztecNodeService implements AztecNode, AztecNodeAdmin, Traceable {
1395
1437
  * Ensure we fully sync the world state
1396
1438
  * @returns A promise that fulfils once the world state is synced
1397
1439
  */
1398
- async #syncWorldState(): Promise<number> {
1440
+ async #syncWorldState(): Promise<BlockNumber> {
1399
1441
  const blockSourceHeight = await this.blockSource.getBlockNumber();
1400
- return this.worldStateSynchronizer.syncImmediate(blockSourceHeight);
1442
+ return await this.worldStateSynchronizer.syncImmediate(blockSourceHeight);
1401
1443
  }
1402
1444
  }