@aztec/world-state 0.0.1-commit.e6bd8901 → 0.0.1-commit.ec7ac5448

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 (45) hide show
  1. package/dest/instrumentation/instrumentation.d.ts +1 -1
  2. package/dest/instrumentation/instrumentation.d.ts.map +1 -1
  3. package/dest/instrumentation/instrumentation.js +9 -2
  4. package/dest/native/fork_checkpoint.d.ts +7 -1
  5. package/dest/native/fork_checkpoint.d.ts.map +1 -1
  6. package/dest/native/fork_checkpoint.js +15 -3
  7. package/dest/native/merkle_trees_facade.d.ts +5 -5
  8. package/dest/native/merkle_trees_facade.d.ts.map +1 -1
  9. package/dest/native/merkle_trees_facade.js +9 -6
  10. package/dest/native/message.d.ts +14 -5
  11. package/dest/native/message.d.ts.map +1 -1
  12. package/dest/native/native_world_state.d.ts +8 -6
  13. package/dest/native/native_world_state.d.ts.map +1 -1
  14. package/dest/native/native_world_state.js +18 -12
  15. package/dest/native/native_world_state_instance.d.ts +5 -5
  16. package/dest/native/native_world_state_instance.d.ts.map +1 -1
  17. package/dest/native/native_world_state_instance.js +8 -7
  18. package/dest/native/world_state_ops_queue.js +5 -5
  19. package/dest/synchronizer/config.d.ts +3 -3
  20. package/dest/synchronizer/config.d.ts.map +1 -1
  21. package/dest/synchronizer/config.js +6 -3
  22. package/dest/synchronizer/factory.d.ts +6 -5
  23. package/dest/synchronizer/factory.d.ts.map +1 -1
  24. package/dest/synchronizer/factory.js +6 -5
  25. package/dest/synchronizer/server_world_state_synchronizer.d.ts +4 -4
  26. package/dest/synchronizer/server_world_state_synchronizer.d.ts.map +1 -1
  27. package/dest/synchronizer/server_world_state_synchronizer.js +90 -19
  28. package/dest/testing.d.ts +4 -3
  29. package/dest/testing.d.ts.map +1 -1
  30. package/dest/testing.js +10 -6
  31. package/dest/world-state-db/merkle_tree_db.d.ts +1 -10
  32. package/dest/world-state-db/merkle_tree_db.d.ts.map +1 -1
  33. package/package.json +9 -10
  34. package/src/instrumentation/instrumentation.ts +9 -1
  35. package/src/native/fork_checkpoint.ts +19 -3
  36. package/src/native/merkle_trees_facade.ts +14 -7
  37. package/src/native/message.ts +15 -4
  38. package/src/native/native_world_state.ts +20 -14
  39. package/src/native/native_world_state_instance.ts +14 -8
  40. package/src/native/world_state_ops_queue.ts +5 -5
  41. package/src/synchronizer/config.ts +7 -5
  42. package/src/synchronizer/factory.ts +13 -7
  43. package/src/synchronizer/server_world_state_synchronizer.ts +100 -21
  44. package/src/testing.ts +8 -9
  45. package/src/world-state-db/merkle_tree_db.ts +0 -10
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aztec/world-state",
3
- "version": "0.0.1-commit.e6bd8901",
3
+ "version": "0.0.1-commit.ec7ac5448",
4
4
  "type": "module",
5
5
  "exports": {
6
6
  ".": "./dest/index.js",
@@ -64,19 +64,18 @@
64
64
  ]
65
65
  },
66
66
  "dependencies": {
67
- "@aztec/constants": "0.0.1-commit.e6bd8901",
68
- "@aztec/foundation": "0.0.1-commit.e6bd8901",
69
- "@aztec/kv-store": "0.0.1-commit.e6bd8901",
70
- "@aztec/merkle-tree": "0.0.1-commit.e6bd8901",
71
- "@aztec/native": "0.0.1-commit.e6bd8901",
72
- "@aztec/protocol-contracts": "0.0.1-commit.e6bd8901",
73
- "@aztec/stdlib": "0.0.1-commit.e6bd8901",
74
- "@aztec/telemetry-client": "0.0.1-commit.e6bd8901",
67
+ "@aztec/constants": "0.0.1-commit.ec7ac5448",
68
+ "@aztec/foundation": "0.0.1-commit.ec7ac5448",
69
+ "@aztec/kv-store": "0.0.1-commit.ec7ac5448",
70
+ "@aztec/native": "0.0.1-commit.ec7ac5448",
71
+ "@aztec/protocol-contracts": "0.0.1-commit.ec7ac5448",
72
+ "@aztec/stdlib": "0.0.1-commit.ec7ac5448",
73
+ "@aztec/telemetry-client": "0.0.1-commit.ec7ac5448",
75
74
  "tslib": "^2.4.0",
76
75
  "zod": "^3.23.8"
77
76
  },
78
77
  "devDependencies": {
79
- "@aztec/archiver": "0.0.1-commit.e6bd8901",
78
+ "@aztec/archiver": "0.0.1-commit.ec7ac5448",
80
79
  "@jest/globals": "^30.0.0",
81
80
  "@types/jest": "^30.0.0",
82
81
  "@types/node": "^22.15.17",
@@ -7,6 +7,7 @@ import {
7
7
  Metrics,
8
8
  type TelemetryClient,
9
9
  type UpDownCounter,
10
+ createUpDownCounterWithDefault,
10
11
  } from '@aztec/telemetry-client';
11
12
 
12
13
  import {
@@ -63,7 +64,14 @@ export class WorldStateInstrumentation {
63
64
 
64
65
  this.requestHistogram = meter.createHistogram(Metrics.WORLD_STATE_REQUEST_TIME);
65
66
 
66
- this.criticalErrors = meter.createUpDownCounter(Metrics.WORLD_STATE_CRITICAL_ERROR_COUNT);
67
+ this.criticalErrors = createUpDownCounterWithDefault(meter, Metrics.WORLD_STATE_CRITICAL_ERROR_COUNT, {
68
+ [Attributes.ERROR_TYPE]: [
69
+ 'synch_pending_block',
70
+ 'finalize_block',
71
+ 'prune_pending_block',
72
+ 'prune_historical_block',
73
+ ],
74
+ });
67
75
  }
68
76
 
69
77
  private updateTreeStats(treeDbStats: TreeDBStats, treeMeta: TreeMeta, tree: MerkleTreeId) {
@@ -3,11 +3,14 @@ import type { MerkleTreeCheckpointOperations } from '@aztec/stdlib/interfaces/se
3
3
  export class ForkCheckpoint {
4
4
  private completed = false;
5
5
 
6
- private constructor(private readonly fork: MerkleTreeCheckpointOperations) {}
6
+ private constructor(
7
+ private readonly fork: MerkleTreeCheckpointOperations,
8
+ public readonly depth: number,
9
+ ) {}
7
10
 
8
11
  static async new(fork: MerkleTreeCheckpointOperations): Promise<ForkCheckpoint> {
9
- await fork.createCheckpoint();
10
- return new ForkCheckpoint(fork);
12
+ const depth = await fork.createCheckpoint();
13
+ return new ForkCheckpoint(fork, depth);
11
14
  }
12
15
 
13
16
  async commit(): Promise<void> {
@@ -27,4 +30,17 @@ export class ForkCheckpoint {
27
30
  await this.fork.revertCheckpoint();
28
31
  this.completed = true;
29
32
  }
33
+
34
+ /**
35
+ * Reverts this checkpoint and any nested checkpoints created on top of it,
36
+ * leaving the checkpoint depth at the level it was before this checkpoint was created.
37
+ */
38
+ async revertToCheckpoint(): Promise<void> {
39
+ if (this.completed) {
40
+ return;
41
+ }
42
+
43
+ await this.fork.revertAllCheckpointsTo(this.depth - 1);
44
+ this.completed = true;
45
+ }
30
46
  }
@@ -304,7 +304,7 @@ export class MerkleTreesForkFacade extends MerkleTreesFacade implements MerkleTr
304
304
  }
305
305
  }
306
306
 
307
- async [Symbol.dispose](): Promise<void> {
307
+ async [Symbol.asyncDispose](): Promise<void> {
308
308
  if (this.opts.closeDelayMs) {
309
309
  void sleep(this.opts.closeDelayMs)
310
310
  .then(() => this.close())
@@ -319,9 +319,10 @@ export class MerkleTreesForkFacade extends MerkleTreesFacade implements MerkleTr
319
319
  }
320
320
  }
321
321
 
322
- public async createCheckpoint(): Promise<void> {
322
+ public async createCheckpoint(): Promise<number> {
323
323
  assert.notEqual(this.revision.forkId, 0, 'Fork ID must be set');
324
- await this.instance.call(WorldStateMessageType.CREATE_CHECKPOINT, { forkId: this.revision.forkId });
324
+ const resp = await this.instance.call(WorldStateMessageType.CREATE_CHECKPOINT, { forkId: this.revision.forkId });
325
+ return resp.depth;
325
326
  }
326
327
 
327
328
  public async commitCheckpoint(): Promise<void> {
@@ -334,14 +335,20 @@ export class MerkleTreesForkFacade extends MerkleTreesFacade implements MerkleTr
334
335
  await this.instance.call(WorldStateMessageType.REVERT_CHECKPOINT, { forkId: this.revision.forkId });
335
336
  }
336
337
 
337
- public async commitAllCheckpoints(): Promise<void> {
338
+ public async commitAllCheckpointsTo(depth: number): Promise<void> {
338
339
  assert.notEqual(this.revision.forkId, 0, 'Fork ID must be set');
339
- await this.instance.call(WorldStateMessageType.COMMIT_ALL_CHECKPOINTS, { forkId: this.revision.forkId });
340
+ await this.instance.call(WorldStateMessageType.COMMIT_ALL_CHECKPOINTS, {
341
+ forkId: this.revision.forkId,
342
+ depth,
343
+ });
340
344
  }
341
345
 
342
- public async revertAllCheckpoints(): Promise<void> {
346
+ public async revertAllCheckpointsTo(depth: number): Promise<void> {
343
347
  assert.notEqual(this.revision.forkId, 0, 'Fork ID must be set');
344
- await this.instance.call(WorldStateMessageType.REVERT_ALL_CHECKPOINTS, { forkId: this.revision.forkId });
348
+ await this.instance.call(WorldStateMessageType.REVERT_ALL_CHECKPOINTS, {
349
+ forkId: this.revision.forkId,
350
+ depth,
351
+ });
345
352
  }
346
353
  }
347
354
 
@@ -1,6 +1,7 @@
1
1
  import { BlockNumber } from '@aztec/foundation/branded-types';
2
2
  import { Fr } from '@aztec/foundation/curves/bn254';
3
3
  import type { Tuple } from '@aztec/foundation/serialize';
4
+ import type { BlockHash } from '@aztec/stdlib/block';
4
5
  import { AppendOnlyTreeSnapshot, MerkleTreeId } from '@aztec/stdlib/trees';
5
6
  import type { StateReference } from '@aztec/stdlib/tx';
6
7
  import type { UInt32 } from '@aztec/stdlib/types';
@@ -283,6 +284,16 @@ interface WithForkId {
283
284
  forkId: number;
284
285
  }
285
286
 
287
+ interface CreateCheckpointResponse {
288
+ depth: number;
289
+ }
290
+
291
+ /** Request to commit/revert all checkpoints down to a target depth. The resulting depth after the operation equals the given depth. */
292
+ interface CheckpointDepthRequest extends WithForkId {
293
+ /** The target depth after the operation. All checkpoints above this depth are committed/reverted. */
294
+ depth: number;
295
+ }
296
+
286
297
  interface WithWorldStateRevision {
287
298
  revision: WorldStateRevision;
288
299
  }
@@ -412,7 +423,7 @@ interface UpdateArchiveRequest extends WithForkId {
412
423
  interface SyncBlockRequest extends WithCanonicalForkId {
413
424
  blockNumber: BlockNumber;
414
425
  blockStateRef: BlockStateReference;
415
- blockHeaderHash: Fr;
426
+ blockHeaderHash: BlockHash;
416
427
  paddedNoteHashes: readonly SerializedLeafValue[];
417
428
  paddedL1ToL2Messages: readonly SerializedLeafValue[];
418
429
  paddedNullifiers: readonly SerializedLeafValue[];
@@ -486,8 +497,8 @@ export type WorldStateRequest = {
486
497
  [WorldStateMessageType.CREATE_CHECKPOINT]: WithForkId;
487
498
  [WorldStateMessageType.COMMIT_CHECKPOINT]: WithForkId;
488
499
  [WorldStateMessageType.REVERT_CHECKPOINT]: WithForkId;
489
- [WorldStateMessageType.COMMIT_ALL_CHECKPOINTS]: WithForkId;
490
- [WorldStateMessageType.REVERT_ALL_CHECKPOINTS]: WithForkId;
500
+ [WorldStateMessageType.COMMIT_ALL_CHECKPOINTS]: CheckpointDepthRequest;
501
+ [WorldStateMessageType.REVERT_ALL_CHECKPOINTS]: CheckpointDepthRequest;
491
502
 
492
503
  [WorldStateMessageType.COPY_STORES]: CopyStoresRequest;
493
504
 
@@ -528,7 +539,7 @@ export type WorldStateResponse = {
528
539
 
529
540
  [WorldStateMessageType.GET_STATUS]: WorldStateStatusSummary;
530
541
 
531
- [WorldStateMessageType.CREATE_CHECKPOINT]: void;
542
+ [WorldStateMessageType.CREATE_CHECKPOINT]: CreateCheckpointResponse;
532
543
  [WorldStateMessageType.COMMIT_CHECKPOINT]: void;
533
544
  [WorldStateMessageType.REVERT_CHECKPOINT]: void;
534
545
  [WorldStateMessageType.COMMIT_ALL_CHECKPOINTS]: void;
@@ -4,9 +4,9 @@ import { fromEntries, padArrayEnd } from '@aztec/foundation/collection';
4
4
  import { Fr } from '@aztec/foundation/curves/bn254';
5
5
  import { EthAddress } from '@aztec/foundation/eth-address';
6
6
  import { tryRmDir } from '@aztec/foundation/fs';
7
- import { type Logger, createLogger } from '@aztec/foundation/log';
7
+ import { type Logger, type LoggerBindings, createLogger } from '@aztec/foundation/log';
8
8
  import type { L2Block } from '@aztec/stdlib/block';
9
- import { DatabaseVersionManager } from '@aztec/stdlib/database-version';
9
+ import { DatabaseVersionManager } from '@aztec/stdlib/database-version/manager';
10
10
  import type {
11
11
  IndexedTreeId,
12
12
  MerkleTreeReadOperations,
@@ -14,8 +14,8 @@ import type {
14
14
  } from '@aztec/stdlib/interfaces/server';
15
15
  import type { SnapshotDataKeys } from '@aztec/stdlib/snapshots';
16
16
  import { MerkleTreeId, NullifierLeaf, type NullifierLeafPreimage, PublicDataTreeLeaf } from '@aztec/stdlib/trees';
17
- import { BlockHeader, PartialStateReference, StateReference } from '@aztec/stdlib/tx';
18
- import { WorldStateRevision } from '@aztec/stdlib/world-state';
17
+ import { BlockHeader, GlobalVariables, PartialStateReference, StateReference } from '@aztec/stdlib/tx';
18
+ import { EMPTY_GENESIS_DATA, type GenesisData, WorldStateRevision } from '@aztec/stdlib/world-state';
19
19
  import { getTelemetryClient } from '@aztec/telemetry-client';
20
20
 
21
21
  import assert from 'assert/strict';
@@ -52,7 +52,8 @@ export class NativeWorldStateService implements MerkleTreeDatabase {
52
52
  protected constructor(
53
53
  protected instance: NativeWorldState,
54
54
  protected readonly worldStateInstrumentation: WorldStateInstrumentation,
55
- protected readonly log: Logger = createLogger('world-state:database'),
55
+ protected readonly log: Logger,
56
+ private readonly genesis: GenesisData = EMPTY_GENESIS_DATA,
56
57
  private readonly cleanup = () => Promise.resolve(),
57
58
  ) {}
58
59
 
@@ -60,11 +61,12 @@ export class NativeWorldStateService implements MerkleTreeDatabase {
60
61
  rollupAddress: EthAddress,
61
62
  dataDir: string,
62
63
  wsTreeMapSizes: WorldStateTreeMapSizes,
63
- prefilledPublicData: PublicDataTreeLeaf[] = [],
64
+ genesis: GenesisData = EMPTY_GENESIS_DATA,
64
65
  instrumentation = new WorldStateInstrumentation(getTelemetryClient()),
65
- log = createLogger('world-state:database'),
66
+ bindings?: LoggerBindings,
66
67
  cleanup = () => Promise.resolve(),
67
68
  ): Promise<NativeWorldStateService> {
69
+ const log = createLogger('world-state:database', bindings);
68
70
  const worldStateDirectory = join(dataDir, WORLD_STATE_DIR);
69
71
  // Create a version manager to handle versioning
70
72
  const versionManager = new DatabaseVersionManager({
@@ -72,12 +74,12 @@ export class NativeWorldStateService implements MerkleTreeDatabase {
72
74
  rollupAddress,
73
75
  dataDirectory: worldStateDirectory,
74
76
  onOpen: (dir: string) => {
75
- return Promise.resolve(new NativeWorldState(dir, wsTreeMapSizes, prefilledPublicData, instrumentation));
77
+ return Promise.resolve(new NativeWorldState(dir, wsTreeMapSizes, genesis, instrumentation, bindings));
76
78
  },
77
79
  });
78
80
 
79
81
  const [instance] = await versionManager.open();
80
- const worldState = new this(instance, instrumentation, log, cleanup);
82
+ const worldState = new this(instance, instrumentation, log, genesis, cleanup);
81
83
  try {
82
84
  await worldState.init();
83
85
  } catch (e) {
@@ -91,10 +93,11 @@ export class NativeWorldStateService implements MerkleTreeDatabase {
91
93
  static async tmp(
92
94
  rollupAddress = EthAddress.ZERO,
93
95
  cleanupTmpDir = true,
94
- prefilledPublicData: PublicDataTreeLeaf[] = [],
96
+ genesis: GenesisData = EMPTY_GENESIS_DATA,
95
97
  instrumentation = new WorldStateInstrumentation(getTelemetryClient()),
98
+ bindings?: LoggerBindings,
96
99
  ): Promise<NativeWorldStateService> {
97
- const log = createLogger('world-state:database');
100
+ const log = createLogger('world-state:database', bindings);
98
101
  const dataDir = await mkdtemp(join(tmpdir(), 'aztec-world-state-'));
99
102
  const dbMapSizeKb = 10 * 1024 * 1024;
100
103
  const worldStateTreeMapSizes: WorldStateTreeMapSizes = {
@@ -116,7 +119,7 @@ export class NativeWorldStateService implements MerkleTreeDatabase {
116
119
  }
117
120
  };
118
121
 
119
- return this.new(rollupAddress, dataDir, worldStateTreeMapSizes, prefilledPublicData, instrumentation, log, cleanup);
122
+ return this.new(rollupAddress, dataDir, worldStateTreeMapSizes, genesis, instrumentation, bindings, cleanup);
120
123
  }
121
124
 
122
125
  protected async init() {
@@ -135,7 +138,7 @@ export class NativeWorldStateService implements MerkleTreeDatabase {
135
138
 
136
139
  // the initial header _must_ be the first element in the archive tree
137
140
  // if this assertion fails, check that the hashing done in Header in yarn-project matches the initial header hash done in world_state.cpp
138
- const indices = await committed.findLeafIndices(MerkleTreeId.ARCHIVE, [await this.initialHeader.hash()]);
141
+ const indices = await committed.findLeafIndices(MerkleTreeId.ARCHIVE, [(await this.initialHeader.hash()).toFr()]);
139
142
  const initialHeaderIndex = indices[0];
140
143
  assert.strictEqual(initialHeaderIndex, 0n, 'Invalid initial archive state');
141
144
  }
@@ -244,7 +247,10 @@ export class NativeWorldStateService implements MerkleTreeDatabase {
244
247
 
245
248
  private async buildInitialHeader(): Promise<BlockHeader> {
246
249
  const state = await this.getInitialStateReference();
247
- return BlockHeader.empty({ state });
250
+ return BlockHeader.empty({
251
+ state,
252
+ globalVariables: GlobalVariables.empty({ timestamp: this.genesis.genesisTimestamp }),
253
+ });
248
254
  }
249
255
 
250
256
  private sanitizeAndCacheSummaryFromFull(response: WorldStateStatusFull) {
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  ARCHIVE_HEIGHT,
3
- GeneratorIndex,
3
+ DomainSeparator,
4
4
  L1_TO_L2_MSG_TREE_HEIGHT,
5
5
  MAX_NULLIFIERS_PER_TX,
6
6
  MAX_TOTAL_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX,
@@ -8,10 +8,10 @@ import {
8
8
  NULLIFIER_TREE_HEIGHT,
9
9
  PUBLIC_DATA_TREE_HEIGHT,
10
10
  } from '@aztec/constants';
11
- import { type Logger, createLogger } from '@aztec/foundation/log';
11
+ import { type Logger, type LoggerBindings, createLogger } from '@aztec/foundation/log';
12
12
  import { NativeWorldState as BaseNativeWorldState, MsgpackChannel } from '@aztec/native';
13
13
  import { MerkleTreeId } from '@aztec/stdlib/trees';
14
- import type { PublicDataTreeLeaf } from '@aztec/stdlib/trees';
14
+ import { EMPTY_GENESIS_DATA, type GenesisData } from '@aztec/stdlib/world-state';
15
15
 
16
16
  import assert from 'assert';
17
17
  import { cpus } from 'os';
@@ -55,9 +55,10 @@ export class NativeWorldState implements NativeWorldStateInstance {
55
55
  constructor(
56
56
  private readonly dataDir: string,
57
57
  private readonly wsTreeMapSizes: WorldStateTreeMapSizes,
58
- private readonly prefilledPublicData: PublicDataTreeLeaf[] = [],
58
+ private readonly genesis: GenesisData = EMPTY_GENESIS_DATA,
59
59
  private readonly instrumentation: WorldStateInstrumentation,
60
- private readonly log: Logger = createLogger('world-state:database'),
60
+ bindings?: LoggerBindings,
61
+ private readonly log: Logger = createLogger('world-state:database', bindings),
61
62
  ) {
62
63
  const threads = Math.min(cpus().length, MAX_WORLD_STATE_THREADS);
63
64
  log.info(
@@ -65,7 +66,10 @@ export class NativeWorldState implements NativeWorldStateInstance {
65
66
  wsTreeMapSizes,
66
67
  )} and ${threads} threads.`,
67
68
  );
68
- const prefilledPublicDataBufferArray = prefilledPublicData.map(d => [d.slot.toBuffer(), d.value.toBuffer()]);
69
+ const prefilledPublicDataBufferArray = genesis.prefilledPublicData.map(d => [
70
+ d.slot.toBuffer(),
71
+ d.value.toBuffer(),
72
+ ]);
69
73
  const ws = new BaseNativeWorldState(
70
74
  dataDir,
71
75
  {
@@ -80,7 +84,8 @@ export class NativeWorldState implements NativeWorldStateInstance {
80
84
  [MerkleTreeId.PUBLIC_DATA_TREE]: 2 * MAX_TOTAL_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX,
81
85
  },
82
86
  prefilledPublicDataBufferArray,
83
- GeneratorIndex.BLOCK_HASH,
87
+ DomainSeparator.BLOCK_HEADER_HASH,
88
+ Number(genesis.genesisTimestamp),
84
89
  {
85
90
  [MerkleTreeId.NULLIFIER_TREE]: wsTreeMapSizes.nullifierTreeMapSizeKb,
86
91
  [MerkleTreeId.NOTE_HASH_TREE]: wsTreeMapSizes.noteHashTreeMapSizeKb,
@@ -103,8 +108,9 @@ export class NativeWorldState implements NativeWorldStateInstance {
103
108
  return new NativeWorldState(
104
109
  this.dataDir,
105
110
  this.wsTreeMapSizes,
106
- this.prefilledPublicData,
111
+ this.genesis,
107
112
  this.instrumentation,
113
+ this.log.getBindings(),
108
114
  this.log,
109
115
  );
110
116
  }
@@ -96,7 +96,7 @@ export class WorldStateOpsQueue {
96
96
  // then send the request immediately
97
97
  // If a mutating request is in flight then we must wait
98
98
  // If a mutating request is not in flight but something is queued then it must be a mutating request
99
- if (this.inFlightMutatingCount == 0 && this.requests.length == 0) {
99
+ if (this.inFlightMutatingCount === 0 && this.requests.length === 0) {
100
100
  this.sendEnqueuedRequest(op);
101
101
  } else {
102
102
  this.requests.push(op);
@@ -122,7 +122,7 @@ export class WorldStateOpsQueue {
122
122
  --this.inFlightCount;
123
123
 
124
124
  // If there are still requests in flight then do nothing further
125
- if (this.inFlightCount != 0) {
125
+ if (this.inFlightCount !== 0) {
126
126
  return;
127
127
  }
128
128
 
@@ -134,7 +134,7 @@ export class WorldStateOpsQueue {
134
134
  while (this.requests.length > 0) {
135
135
  const next = this.requests[0];
136
136
  if (next.mutating) {
137
- if (this.inFlightCount == 0) {
137
+ if (this.inFlightCount === 0) {
138
138
  // send the mutating request
139
139
  this.requests.shift();
140
140
  this.sendEnqueuedRequest(next);
@@ -149,7 +149,7 @@ export class WorldStateOpsQueue {
149
149
  }
150
150
 
151
151
  // If the queue is empty, there is nothing in flight and we have been told to stop, then resolve the stop promise
152
- if (this.inFlightCount == 0 && this.stopResolve !== undefined) {
152
+ if (this.inFlightCount === 0 && this.stopResolve !== undefined) {
153
153
  this.stopResolve();
154
154
  }
155
155
  }
@@ -182,7 +182,7 @@ export class WorldStateOpsQueue {
182
182
  });
183
183
 
184
184
  // If no outstanding requests then immediately resolve the promise
185
- if (this.requests.length == 0 && this.inFlightCount == 0 && this.stopResolve !== undefined) {
185
+ if (this.requests.length === 0 && this.inFlightCount === 0 && this.stopResolve !== undefined) {
186
186
  this.stopResolve();
187
187
  }
188
188
  return this.stopPromise;
@@ -29,8 +29,8 @@ export interface WorldStateConfig {
29
29
  /** Optional directory for the world state DB, if unspecified will default to the general data directory */
30
30
  worldStateDataDirectory?: string;
31
31
 
32
- /** The number of historic blocks to maintain */
33
- worldStateBlockHistory: number;
32
+ /** The number of historic checkpoints worth of blocks to maintain */
33
+ worldStateCheckpointHistory: number;
34
34
  }
35
35
 
36
36
  export const worldStateConfigMappings: ConfigMappingsType<WorldStateConfig> = {
@@ -84,9 +84,11 @@ export const worldStateConfigMappings: ConfigMappingsType<WorldStateConfig> = {
84
84
  env: 'WS_DATA_DIRECTORY',
85
85
  description: 'Optional directory for the world state database',
86
86
  },
87
- worldStateBlockHistory: {
88
- env: 'WS_NUM_HISTORIC_BLOCKS',
89
- description: 'The number of historic blocks to maintain. Values less than 1 mean all history is maintained',
87
+ worldStateCheckpointHistory: {
88
+ env: 'WS_NUM_HISTORIC_CHECKPOINTS',
89
+ description:
90
+ 'The number of historic checkpoints worth of blocks to maintain. Values less than 1 mean all history is maintained',
91
+ fallback: ['WS_NUM_HISTORIC_BLOCKS'],
90
92
  ...numberConfigHelper(64),
91
93
  },
92
94
  };
@@ -1,7 +1,8 @@
1
- import type { DataStoreConfig } from '@aztec/kv-store/config';
1
+ import type { LoggerBindings } from '@aztec/foundation/log';
2
2
  import type { L2BlockSource } from '@aztec/stdlib/block';
3
+ import type { DataStoreConfig } from '@aztec/stdlib/kv-store';
3
4
  import type { L1ToL2MessageSource } from '@aztec/stdlib/messaging';
4
- import type { PublicDataTreeLeaf } from '@aztec/stdlib/trees';
5
+ import { EMPTY_GENESIS_DATA, type GenesisData } from '@aztec/stdlib/world-state';
5
6
  import { type TelemetryClient, getTelemetryClient } from '@aztec/telemetry-client';
6
7
 
7
8
  import { WorldStateInstrumentation } from '../instrumentation/instrumentation.js';
@@ -20,11 +21,12 @@ export interface WorldStateTreeMapSizes {
20
21
  export async function createWorldStateSynchronizer(
21
22
  config: WorldStateConfig & DataStoreConfig,
22
23
  l2BlockSource: L2BlockSource & L1ToL2MessageSource,
23
- prefilledPublicData: PublicDataTreeLeaf[] = [],
24
+ genesis: GenesisData = EMPTY_GENESIS_DATA,
24
25
  client: TelemetryClient = getTelemetryClient(),
26
+ bindings?: LoggerBindings,
25
27
  ) {
26
28
  const instrumentation = new WorldStateInstrumentation(client);
27
- const merkleTrees = await createWorldState(config, prefilledPublicData, instrumentation);
29
+ const merkleTrees = await createWorldState(config, genesis, instrumentation, bindings);
28
30
  return new ServerWorldStateSynchronizer(merkleTrees, l2BlockSource, config, instrumentation);
29
31
  }
30
32
 
@@ -40,8 +42,9 @@ export async function createWorldState(
40
42
  | 'publicDataTreeMapSizeKb'
41
43
  > &
42
44
  Pick<DataStoreConfig, 'dataDirectory' | 'dataStoreMapSizeKb' | 'l1Contracts'>,
43
- prefilledPublicData: PublicDataTreeLeaf[] = [],
45
+ genesis: GenesisData = EMPTY_GENESIS_DATA,
44
46
  instrumentation: WorldStateInstrumentation = new WorldStateInstrumentation(getTelemetryClient()),
47
+ bindings?: LoggerBindings,
45
48
  ) {
46
49
  const dataDirectory = config.worldStateDataDirectory ?? config.dataDirectory;
47
50
  const dataStoreMapSizeKb = config.worldStateDbMapSizeKb ?? config.dataStoreMapSizeKb;
@@ -63,13 +66,16 @@ export async function createWorldState(
63
66
  config.l1Contracts.rollupAddress,
64
67
  dataDirectory,
65
68
  wsTreeMapSizes,
66
- prefilledPublicData,
69
+ genesis,
67
70
  instrumentation,
71
+ bindings,
68
72
  )
69
73
  : await NativeWorldStateService.tmp(
70
74
  config.l1Contracts.rollupAddress,
71
75
  !['true', '1'].includes(process.env.DEBUG_WORLD_STATE!),
72
- prefilledPublicData,
76
+ genesis,
77
+ instrumentation,
78
+ bindings,
73
79
  );
74
80
 
75
81
  return merkleTrees;