@aztec/aztec-node 0.0.1-commit.24de95ac → 0.0.1-commit.2606882

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 (44) hide show
  1. package/dest/aztec-node/block_response_helpers.d.ts +25 -0
  2. package/dest/aztec-node/block_response_helpers.d.ts.map +1 -0
  3. package/dest/aztec-node/block_response_helpers.js +112 -0
  4. package/dest/aztec-node/config.d.ts +17 -8
  5. package/dest/aztec-node/config.d.ts.map +1 -1
  6. package/dest/aztec-node/config.js +22 -8
  7. package/dest/aztec-node/node_metrics.d.ts +1 -1
  8. package/dest/aztec-node/node_metrics.d.ts.map +1 -1
  9. package/dest/aztec-node/node_metrics.js +9 -16
  10. package/dest/aztec-node/public_data_overrides.d.ts +13 -0
  11. package/dest/aztec-node/public_data_overrides.d.ts.map +1 -0
  12. package/dest/aztec-node/public_data_overrides.js +21 -0
  13. package/dest/aztec-node/server.d.ts +109 -199
  14. package/dest/aztec-node/server.d.ts.map +1 -1
  15. package/dest/aztec-node/server.js +1602 -506
  16. package/dest/bin/index.d.ts +1 -1
  17. package/dest/index.d.ts +1 -1
  18. package/dest/sentinel/config.d.ts +3 -2
  19. package/dest/sentinel/config.d.ts.map +1 -1
  20. package/dest/sentinel/config.js +15 -5
  21. package/dest/sentinel/factory.d.ts +5 -3
  22. package/dest/sentinel/factory.d.ts.map +1 -1
  23. package/dest/sentinel/factory.js +5 -5
  24. package/dest/sentinel/index.d.ts +1 -1
  25. package/dest/sentinel/sentinel.d.ts +151 -25
  26. package/dest/sentinel/sentinel.d.ts.map +1 -1
  27. package/dest/sentinel/sentinel.js +290 -110
  28. package/dest/sentinel/store.d.ts +11 -10
  29. package/dest/sentinel/store.d.ts.map +1 -1
  30. package/dest/sentinel/store.js +36 -23
  31. package/dest/test/index.d.ts +3 -3
  32. package/dest/test/index.d.ts.map +1 -1
  33. package/package.json +31 -28
  34. package/src/aztec-node/block_response_helpers.ts +161 -0
  35. package/src/aztec-node/config.ts +45 -21
  36. package/src/aztec-node/node_metrics.ts +6 -17
  37. package/src/aztec-node/public_data_overrides.ts +35 -0
  38. package/src/aztec-node/server.ts +1385 -640
  39. package/src/sentinel/README.md +103 -0
  40. package/src/sentinel/config.ts +18 -6
  41. package/src/sentinel/factory.ts +9 -11
  42. package/src/sentinel/sentinel.ts +375 -136
  43. package/src/sentinel/store.ts +43 -34
  44. package/src/test/index.ts +2 -2
@@ -1,49 +1,500 @@
1
- function _ts_decorate(decorators, target, key, desc) {
2
- var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
3
- if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
4
- else for(var i = decorators.length - 1; i >= 0; i--)if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
5
- return c > 3 && r && Object.defineProperty(target, key, r), r;
1
+ function _ts_add_disposable_resource(env, value, async) {
2
+ if (value !== null && value !== void 0) {
3
+ if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected.");
4
+ var dispose, inner;
5
+ if (async) {
6
+ if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined.");
7
+ dispose = value[Symbol.asyncDispose];
8
+ }
9
+ if (dispose === void 0) {
10
+ if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined.");
11
+ dispose = value[Symbol.dispose];
12
+ if (async) inner = dispose;
13
+ }
14
+ if (typeof dispose !== "function") throw new TypeError("Object not disposable.");
15
+ if (inner) dispose = function() {
16
+ try {
17
+ inner.call(this);
18
+ } catch (e) {
19
+ return Promise.reject(e);
20
+ }
21
+ };
22
+ env.stack.push({
23
+ value: value,
24
+ dispose: dispose,
25
+ async: async
26
+ });
27
+ } else if (async) {
28
+ env.stack.push({
29
+ async: true
30
+ });
31
+ }
32
+ return value;
6
33
  }
7
- import { createArchiver } from '@aztec/archiver';
8
- import { BBCircuitVerifier, QueuedIVCVerifier, TestCircuitVerifier } from '@aztec/bb-prover';
9
- import { createBlobSinkClient } from '@aztec/blob-sink/client';
10
- import { INITIAL_L2_BLOCK_NUM } from '@aztec/constants';
34
+ function _ts_dispose_resources(env) {
35
+ var _SuppressedError = typeof SuppressedError === "function" ? SuppressedError : function(error, suppressed, message) {
36
+ var e = new Error(message);
37
+ return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
38
+ };
39
+ return (_ts_dispose_resources = function _ts_dispose_resources(env) {
40
+ function fail(e) {
41
+ env.error = env.hasError ? new _SuppressedError(e, env.error, "An error was suppressed during disposal.") : e;
42
+ env.hasError = true;
43
+ }
44
+ var r, s = 0;
45
+ function next() {
46
+ while(r = env.stack.pop()){
47
+ try {
48
+ if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);
49
+ if (r.dispose) {
50
+ var result = r.dispose.call(r.value);
51
+ if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) {
52
+ fail(e);
53
+ return next();
54
+ });
55
+ } else s |= 1;
56
+ } catch (e) {
57
+ fail(e);
58
+ }
59
+ }
60
+ if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();
61
+ if (env.hasError) throw env.error;
62
+ }
63
+ return next();
64
+ })(env);
65
+ }
66
+ function applyDecs2203RFactory() {
67
+ function createAddInitializerMethod(initializers, decoratorFinishedRef) {
68
+ return function addInitializer(initializer) {
69
+ assertNotFinished(decoratorFinishedRef, "addInitializer");
70
+ assertCallable(initializer, "An initializer");
71
+ initializers.push(initializer);
72
+ };
73
+ }
74
+ function memberDec(dec, name, desc, initializers, kind, isStatic, isPrivate, metadata, value) {
75
+ var kindStr;
76
+ switch(kind){
77
+ case 1:
78
+ kindStr = "accessor";
79
+ break;
80
+ case 2:
81
+ kindStr = "method";
82
+ break;
83
+ case 3:
84
+ kindStr = "getter";
85
+ break;
86
+ case 4:
87
+ kindStr = "setter";
88
+ break;
89
+ default:
90
+ kindStr = "field";
91
+ }
92
+ var ctx = {
93
+ kind: kindStr,
94
+ name: isPrivate ? "#" + name : name,
95
+ static: isStatic,
96
+ private: isPrivate,
97
+ metadata: metadata
98
+ };
99
+ var decoratorFinishedRef = {
100
+ v: false
101
+ };
102
+ ctx.addInitializer = createAddInitializerMethod(initializers, decoratorFinishedRef);
103
+ var get, set;
104
+ if (kind === 0) {
105
+ if (isPrivate) {
106
+ get = desc.get;
107
+ set = desc.set;
108
+ } else {
109
+ get = function() {
110
+ return this[name];
111
+ };
112
+ set = function(v) {
113
+ this[name] = v;
114
+ };
115
+ }
116
+ } else if (kind === 2) {
117
+ get = function() {
118
+ return desc.value;
119
+ };
120
+ } else {
121
+ if (kind === 1 || kind === 3) {
122
+ get = function() {
123
+ return desc.get.call(this);
124
+ };
125
+ }
126
+ if (kind === 1 || kind === 4) {
127
+ set = function(v) {
128
+ desc.set.call(this, v);
129
+ };
130
+ }
131
+ }
132
+ ctx.access = get && set ? {
133
+ get: get,
134
+ set: set
135
+ } : get ? {
136
+ get: get
137
+ } : {
138
+ set: set
139
+ };
140
+ try {
141
+ return dec(value, ctx);
142
+ } finally{
143
+ decoratorFinishedRef.v = true;
144
+ }
145
+ }
146
+ function assertNotFinished(decoratorFinishedRef, fnName) {
147
+ if (decoratorFinishedRef.v) {
148
+ throw new Error("attempted to call " + fnName + " after decoration was finished");
149
+ }
150
+ }
151
+ function assertCallable(fn, hint) {
152
+ if (typeof fn !== "function") {
153
+ throw new TypeError(hint + " must be a function");
154
+ }
155
+ }
156
+ function assertValidReturnValue(kind, value) {
157
+ var type = typeof value;
158
+ if (kind === 1) {
159
+ if (type !== "object" || value === null) {
160
+ throw new TypeError("accessor decorators must return an object with get, set, or init properties or void 0");
161
+ }
162
+ if (value.get !== undefined) {
163
+ assertCallable(value.get, "accessor.get");
164
+ }
165
+ if (value.set !== undefined) {
166
+ assertCallable(value.set, "accessor.set");
167
+ }
168
+ if (value.init !== undefined) {
169
+ assertCallable(value.init, "accessor.init");
170
+ }
171
+ } else if (type !== "function") {
172
+ var hint;
173
+ if (kind === 0) {
174
+ hint = "field";
175
+ } else if (kind === 10) {
176
+ hint = "class";
177
+ } else {
178
+ hint = "method";
179
+ }
180
+ throw new TypeError(hint + " decorators must return a function or void 0");
181
+ }
182
+ }
183
+ function applyMemberDec(ret, base, decInfo, name, kind, isStatic, isPrivate, initializers, metadata) {
184
+ var decs = decInfo[0];
185
+ var desc, init, value;
186
+ if (isPrivate) {
187
+ if (kind === 0 || kind === 1) {
188
+ desc = {
189
+ get: decInfo[3],
190
+ set: decInfo[4]
191
+ };
192
+ } else if (kind === 3) {
193
+ desc = {
194
+ get: decInfo[3]
195
+ };
196
+ } else if (kind === 4) {
197
+ desc = {
198
+ set: decInfo[3]
199
+ };
200
+ } else {
201
+ desc = {
202
+ value: decInfo[3]
203
+ };
204
+ }
205
+ } else if (kind !== 0) {
206
+ desc = Object.getOwnPropertyDescriptor(base, name);
207
+ }
208
+ if (kind === 1) {
209
+ value = {
210
+ get: desc.get,
211
+ set: desc.set
212
+ };
213
+ } else if (kind === 2) {
214
+ value = desc.value;
215
+ } else if (kind === 3) {
216
+ value = desc.get;
217
+ } else if (kind === 4) {
218
+ value = desc.set;
219
+ }
220
+ var newValue, get, set;
221
+ if (typeof decs === "function") {
222
+ newValue = memberDec(decs, name, desc, initializers, kind, isStatic, isPrivate, metadata, value);
223
+ if (newValue !== void 0) {
224
+ assertValidReturnValue(kind, newValue);
225
+ if (kind === 0) {
226
+ init = newValue;
227
+ } else if (kind === 1) {
228
+ init = newValue.init;
229
+ get = newValue.get || value.get;
230
+ set = newValue.set || value.set;
231
+ value = {
232
+ get: get,
233
+ set: set
234
+ };
235
+ } else {
236
+ value = newValue;
237
+ }
238
+ }
239
+ } else {
240
+ for(var i = decs.length - 1; i >= 0; i--){
241
+ var dec = decs[i];
242
+ newValue = memberDec(dec, name, desc, initializers, kind, isStatic, isPrivate, metadata, value);
243
+ if (newValue !== void 0) {
244
+ assertValidReturnValue(kind, newValue);
245
+ var newInit;
246
+ if (kind === 0) {
247
+ newInit = newValue;
248
+ } else if (kind === 1) {
249
+ newInit = newValue.init;
250
+ get = newValue.get || value.get;
251
+ set = newValue.set || value.set;
252
+ value = {
253
+ get: get,
254
+ set: set
255
+ };
256
+ } else {
257
+ value = newValue;
258
+ }
259
+ if (newInit !== void 0) {
260
+ if (init === void 0) {
261
+ init = newInit;
262
+ } else if (typeof init === "function") {
263
+ init = [
264
+ init,
265
+ newInit
266
+ ];
267
+ } else {
268
+ init.push(newInit);
269
+ }
270
+ }
271
+ }
272
+ }
273
+ }
274
+ if (kind === 0 || kind === 1) {
275
+ if (init === void 0) {
276
+ init = function(instance, init) {
277
+ return init;
278
+ };
279
+ } else if (typeof init !== "function") {
280
+ var ownInitializers = init;
281
+ init = function(instance, init) {
282
+ var value = init;
283
+ for(var i = 0; i < ownInitializers.length; i++){
284
+ value = ownInitializers[i].call(instance, value);
285
+ }
286
+ return value;
287
+ };
288
+ } else {
289
+ var originalInitializer = init;
290
+ init = function(instance, init) {
291
+ return originalInitializer.call(instance, init);
292
+ };
293
+ }
294
+ ret.push(init);
295
+ }
296
+ if (kind !== 0) {
297
+ if (kind === 1) {
298
+ desc.get = value.get;
299
+ desc.set = value.set;
300
+ } else if (kind === 2) {
301
+ desc.value = value;
302
+ } else if (kind === 3) {
303
+ desc.get = value;
304
+ } else if (kind === 4) {
305
+ desc.set = value;
306
+ }
307
+ if (isPrivate) {
308
+ if (kind === 1) {
309
+ ret.push(function(instance, args) {
310
+ return value.get.call(instance, args);
311
+ });
312
+ ret.push(function(instance, args) {
313
+ return value.set.call(instance, args);
314
+ });
315
+ } else if (kind === 2) {
316
+ ret.push(value);
317
+ } else {
318
+ ret.push(function(instance, args) {
319
+ return value.call(instance, args);
320
+ });
321
+ }
322
+ } else {
323
+ Object.defineProperty(base, name, desc);
324
+ }
325
+ }
326
+ }
327
+ function applyMemberDecs(Class, decInfos, metadata) {
328
+ var ret = [];
329
+ var protoInitializers;
330
+ var staticInitializers;
331
+ var existingProtoNonFields = new Map();
332
+ var existingStaticNonFields = new Map();
333
+ for(var i = 0; i < decInfos.length; i++){
334
+ var decInfo = decInfos[i];
335
+ if (!Array.isArray(decInfo)) continue;
336
+ var kind = decInfo[1];
337
+ var name = decInfo[2];
338
+ var isPrivate = decInfo.length > 3;
339
+ var isStatic = kind >= 5;
340
+ var base;
341
+ var initializers;
342
+ if (isStatic) {
343
+ base = Class;
344
+ kind = kind - 5;
345
+ staticInitializers = staticInitializers || [];
346
+ initializers = staticInitializers;
347
+ } else {
348
+ base = Class.prototype;
349
+ protoInitializers = protoInitializers || [];
350
+ initializers = protoInitializers;
351
+ }
352
+ if (kind !== 0 && !isPrivate) {
353
+ var existingNonFields = isStatic ? existingStaticNonFields : existingProtoNonFields;
354
+ var existingKind = existingNonFields.get(name) || 0;
355
+ if (existingKind === true || existingKind === 3 && kind !== 4 || existingKind === 4 && kind !== 3) {
356
+ throw new Error("Attempted to decorate a public method/accessor that has the same name as a previously decorated public method/accessor. This is not currently supported by the decorators plugin. Property name was: " + name);
357
+ } else if (!existingKind && kind > 2) {
358
+ existingNonFields.set(name, kind);
359
+ } else {
360
+ existingNonFields.set(name, true);
361
+ }
362
+ }
363
+ applyMemberDec(ret, base, decInfo, name, kind, isStatic, isPrivate, initializers, metadata);
364
+ }
365
+ pushInitializers(ret, protoInitializers);
366
+ pushInitializers(ret, staticInitializers);
367
+ return ret;
368
+ }
369
+ function pushInitializers(ret, initializers) {
370
+ if (initializers) {
371
+ ret.push(function(instance) {
372
+ for(var i = 0; i < initializers.length; i++){
373
+ initializers[i].call(instance);
374
+ }
375
+ return instance;
376
+ });
377
+ }
378
+ }
379
+ function applyClassDecs(targetClass, classDecs, metadata) {
380
+ if (classDecs.length > 0) {
381
+ var initializers = [];
382
+ var newClass = targetClass;
383
+ var name = targetClass.name;
384
+ for(var i = classDecs.length - 1; i >= 0; i--){
385
+ var decoratorFinishedRef = {
386
+ v: false
387
+ };
388
+ try {
389
+ var nextNewClass = classDecs[i](newClass, {
390
+ kind: "class",
391
+ name: name,
392
+ addInitializer: createAddInitializerMethod(initializers, decoratorFinishedRef),
393
+ metadata
394
+ });
395
+ } finally{
396
+ decoratorFinishedRef.v = true;
397
+ }
398
+ if (nextNewClass !== undefined) {
399
+ assertValidReturnValue(10, nextNewClass);
400
+ newClass = nextNewClass;
401
+ }
402
+ }
403
+ return [
404
+ defineMetadata(newClass, metadata),
405
+ function() {
406
+ for(var i = 0; i < initializers.length; i++){
407
+ initializers[i].call(newClass);
408
+ }
409
+ }
410
+ ];
411
+ }
412
+ }
413
+ function defineMetadata(Class, metadata) {
414
+ return Object.defineProperty(Class, Symbol.metadata || Symbol.for("Symbol.metadata"), {
415
+ configurable: true,
416
+ enumerable: true,
417
+ value: metadata
418
+ });
419
+ }
420
+ return function applyDecs2203R(targetClass, memberDecs, classDecs, parentClass) {
421
+ if (parentClass !== void 0) {
422
+ var parentMetadata = parentClass[Symbol.metadata || Symbol.for("Symbol.metadata")];
423
+ }
424
+ var metadata = Object.create(parentMetadata === void 0 ? null : parentMetadata);
425
+ var e = applyMemberDecs(targetClass, memberDecs, metadata);
426
+ if (!classDecs.length) defineMetadata(targetClass, metadata);
427
+ return {
428
+ e: e,
429
+ get c () {
430
+ return applyClassDecs(targetClass, classDecs, metadata);
431
+ }
432
+ };
433
+ };
434
+ }
435
+ function _apply_decs_2203_r(targetClass, memberDecs, classDecs, parentClass) {
436
+ return (_apply_decs_2203_r = applyDecs2203RFactory())(targetClass, memberDecs, classDecs, parentClass);
437
+ }
438
+ var _dec, _initProto;
439
+ import { L1ToL2MessagesNotReadyError, createArchiver } from '@aztec/archiver';
440
+ import { BBCircuitVerifier, BatchChonkVerifier, QueuedIVCVerifier } from '@aztec/bb-prover';
441
+ import { TestCircuitVerifier } from '@aztec/bb-prover/test';
442
+ import { createBlobClientWithFileStores } from '@aztec/blob-client/client';
443
+ import { Blob } from '@aztec/blob-lib';
11
444
  import { EpochCache } from '@aztec/epoch-cache';
12
- import { RegistryContract, RollupContract, createEthereumChain, getPublicClient } from '@aztec/ethereum';
13
- import { compactArray, pick } from '@aztec/foundation/collection';
445
+ import { createEthereumChain } from '@aztec/ethereum/chain';
446
+ import { getPublicClient, makeL1HttpTransport } from '@aztec/ethereum/client';
447
+ import { RegistryContract, RollupContract } from '@aztec/ethereum/contracts';
448
+ import { pickL1ContractAddresses } from '@aztec/ethereum/l1-contract-addresses';
449
+ import { BlockNumber, CheckpointNumber } from '@aztec/foundation/branded-types';
450
+ import { chunkBy, compactArray, pick, unique } from '@aztec/foundation/collection';
451
+ import { Fr } from '@aztec/foundation/curves/bn254';
14
452
  import { EthAddress } from '@aztec/foundation/eth-address';
15
- import { Fr } from '@aztec/foundation/fields';
16
453
  import { BadRequestError } from '@aztec/foundation/json-rpc';
17
454
  import { createLogger } from '@aztec/foundation/log';
18
- import { SerialQueue } from '@aztec/foundation/queue';
455
+ import { retryUntil } from '@aztec/foundation/retry';
19
456
  import { count } from '@aztec/foundation/string';
20
457
  import { DateProvider, Timer } from '@aztec/foundation/timer';
21
458
  import { MembershipWitness } from '@aztec/foundation/trees';
459
+ import { isErrorClass } from '@aztec/foundation/types';
22
460
  import { KeystoreManager, loadKeystores, mergeKeystores } from '@aztec/node-keystore';
23
461
  import { trySnapshotSync, uploadSnapshot } from '@aztec/node-lib/actions';
24
- import { createL1TxUtilsWithBlobsFromEthSigner } from '@aztec/node-lib/factories';
25
- import { createP2PClient, getDefaultAllowedSetupFunctions } from '@aztec/p2p';
462
+ import { createForwarderL1TxUtilsFromSigners, createL1TxUtilsFromSigners } from '@aztec/node-lib/factories';
463
+ import { createP2PClient, createTxValidatorForAcceptingTxsOverRPC, getDefaultAllowedSetupFunctions } from '@aztec/p2p';
26
464
  import { ProtocolContractAddress } from '@aztec/protocol-contracts';
27
- import { BlockBuilder, GlobalVariableBuilder, SequencerClient, createValidatorForAcceptingTxs } from '@aztec/sequencer-client';
28
- import { PublicProcessorFactory } from '@aztec/simulator/server';
29
- import { AttestationsBlockWatcher, EpochPruneWatcher, createSlasher } from '@aztec/slasher';
465
+ import { createProverNode } from '@aztec/prover-node';
466
+ import { createKeyStoreForProver } from '@aztec/prover-node/config';
467
+ import { FeeProviderImpl, GlobalVariableBuilder, SequencerClient, createAutomineSequencer } from '@aztec/sequencer-client';
468
+ import { PublicContractsDB, PublicProcessorFactory } from '@aztec/simulator/server';
469
+ import { AttestationsBlockWatcher, AttestedInvalidProposalWatcher, BroadcastedInvalidCheckpointProposalWatcher, CheckpointEquivocationWatcher, DataWithholdingWatcher, createSlasher } from '@aztec/slasher';
470
+ import { STANDARD_MULTI_CALL_ENTRYPOINT_ADDRESS } from '@aztec/standard-contracts/multi-call-entrypoint';
471
+ import { CollectionLimitsConfig, PublicSimulatorConfig } from '@aztec/stdlib/avm';
30
472
  import { AztecAddress } from '@aztec/stdlib/aztec-address';
31
- import { L2BlockHash } from '@aztec/stdlib/block';
473
+ import { BlockHash, BlockTag, inspectBlockParameter } from '@aztec/stdlib/block';
474
+ import { CheckpointReexecutionTracker } from '@aztec/stdlib/checkpoint';
475
+ import { getEpochAtSlot } from '@aztec/stdlib/epoch-helpers';
476
+ import { GasFees } from '@aztec/stdlib/gas';
32
477
  import { computePublicDataTreeLeafSlot } from '@aztec/stdlib/hash';
33
478
  import { AztecNodeAdminConfigSchema } from '@aztec/stdlib/interfaces/client';
34
479
  import { tryStop } from '@aztec/stdlib/interfaces/server';
35
- import { InboxLeaf } from '@aztec/stdlib/messaging';
36
- import { P2PClientType } from '@aztec/stdlib/p2p';
480
+ import { InMemoryDebugLogStore, NullDebugLogStore } from '@aztec/stdlib/logs';
481
+ import { InboxLeaf, appendL1ToL2MessagesToTree } from '@aztec/stdlib/messaging';
482
+ import { MIN_EXECUTION_TIME } from '@aztec/stdlib/timetable';
37
483
  import { MerkleTreeId, NullifierMembershipWitness, PublicDataWitness } from '@aztec/stdlib/trees';
38
- import { PublicSimulationOutput, TxReceipt, TxStatus } from '@aztec/stdlib/tx';
484
+ import { DroppedTxReceipt, MinedTxReceipt, PendingTxReceipt, PublicSimulationOutput, TxStatus } from '@aztec/stdlib/tx';
39
485
  import { getPackageVersion } from '@aztec/stdlib/update-checker';
40
486
  import { Attributes, getTelemetryClient, trackSpan } from '@aztec/telemetry-client';
41
- import { NodeKeystoreAdapter, ValidatorClient, createBlockProposalHandler, createValidatorClient } from '@aztec/validator-client';
42
- import { createWorldStateSynchronizer } from '@aztec/world-state';
43
- import { createPublicClient, fallback, http } from 'viem';
487
+ import { FullNodeCheckpointsBuilder as CheckpointsBuilder, FullNodeCheckpointsBuilder, NodeKeystoreAdapter, ValidatorClient, createProposalHandler, createValidatorClient } from '@aztec/validator-client';
488
+ import { createWorldState, createWorldStateSynchronizer } from '@aztec/world-state';
489
+ import { createPublicClient } from 'viem';
44
490
  import { createSentinel } from '../sentinel/factory.js';
491
+ import { blockResponseFromBlockData, blockResponseFromL2Block, checkpointResponseFromCheckpointData, checkpointResponseFromPublishedCheckpoint, projectProposedToCheckpointResponse } from './block_response_helpers.js';
45
492
  import { createKeyStoreForValidator } from './config.js';
46
493
  import { NodeMetrics } from './node_metrics.js';
494
+ import { applyPublicDataOverrides } from './public_data_overrides.js';
495
+ _dec = trackSpan('AztecNodeService.simulatePublicCalls', (tx)=>({
496
+ [Attributes.TX_HASH]: tx.getTxHash().toString()
497
+ }));
47
498
  /**
48
499
  * The aztec node.
49
500
  */ export class AztecNodeService {
@@ -55,24 +506,41 @@ import { NodeMetrics } from './node_metrics.js';
55
506
  l1ToL2MessageSource;
56
507
  worldStateSynchronizer;
57
508
  sequencer;
509
+ proverNode;
58
510
  slasherClient;
59
511
  validatorsSentinel;
60
- epochPruneWatcher;
512
+ stopStartedWatchers;
61
513
  l1ChainId;
62
514
  version;
63
515
  globalVariableBuilder;
516
+ feeProvider;
64
517
  epochCache;
65
518
  packageVersion;
66
- proofVerifier;
519
+ peerProofVerifier;
520
+ rpcProofVerifier;
67
521
  telemetry;
68
522
  log;
523
+ blobClient;
524
+ validatorClient;
525
+ keyStoreManager;
526
+ debugLogStore;
527
+ automineSequencer;
528
+ static{
529
+ ({ e: [_initProto] } = _apply_decs_2203_r(this, [
530
+ [
531
+ _dec,
532
+ 2,
533
+ "simulatePublicCalls"
534
+ ]
535
+ ], []));
536
+ }
69
537
  metrics;
70
538
  // Prevent two snapshot operations to happen simultaneously
71
539
  isUploadingSnapshot;
72
- // Serial queue to ensure that we only send one tx at a time
73
- txQueue;
540
+ // Saved minTxsPerBlock used by `pauseSequencer` to restore production-sequencer config on resume.
541
+ sequencerPausedMinTxsPerBlock;
74
542
  tracer;
75
- constructor(config, p2pClient, blockSource, logsSource, contractDataSource, l1ToL2MessageSource, worldStateSynchronizer, sequencer, slasherClient, validatorsSentinel, epochPruneWatcher, l1ChainId, version, globalVariableBuilder, epochCache, packageVersion, proofVerifier, telemetry = getTelemetryClient(), log = createLogger('node')){
543
+ constructor(config, p2pClient, blockSource, logsSource, contractDataSource, l1ToL2MessageSource, worldStateSynchronizer, sequencer, proverNode, slasherClient, validatorsSentinel, stopStartedWatchers, l1ChainId, version, globalVariableBuilder, feeProvider, epochCache, packageVersion, peerProofVerifier, rpcProofVerifier, telemetry = getTelemetryClient(), log = createLogger('node'), blobClient, validatorClient, keyStoreManager, debugLogStore = new NullDebugLogStore(), automineSequencer){
76
544
  this.config = config;
77
545
  this.p2pClient = p2pClient;
78
546
  this.blockSource = blockSource;
@@ -81,31 +549,280 @@ import { NodeMetrics } from './node_metrics.js';
81
549
  this.l1ToL2MessageSource = l1ToL2MessageSource;
82
550
  this.worldStateSynchronizer = worldStateSynchronizer;
83
551
  this.sequencer = sequencer;
552
+ this.proverNode = proverNode;
84
553
  this.slasherClient = slasherClient;
85
554
  this.validatorsSentinel = validatorsSentinel;
86
- this.epochPruneWatcher = epochPruneWatcher;
555
+ this.stopStartedWatchers = stopStartedWatchers;
87
556
  this.l1ChainId = l1ChainId;
88
557
  this.version = version;
89
558
  this.globalVariableBuilder = globalVariableBuilder;
559
+ this.feeProvider = feeProvider;
90
560
  this.epochCache = epochCache;
91
561
  this.packageVersion = packageVersion;
92
- this.proofVerifier = proofVerifier;
562
+ this.peerProofVerifier = peerProofVerifier;
563
+ this.rpcProofVerifier = rpcProofVerifier;
93
564
  this.telemetry = telemetry;
94
565
  this.log = log;
95
- this.isUploadingSnapshot = false;
96
- this.txQueue = new SerialQueue();
566
+ this.blobClient = blobClient;
567
+ this.validatorClient = validatorClient;
568
+ this.keyStoreManager = keyStoreManager;
569
+ this.debugLogStore = debugLogStore;
570
+ this.automineSequencer = automineSequencer;
571
+ this.isUploadingSnapshot = (_initProto(this), false);
97
572
  this.metrics = new NodeMetrics(telemetry, 'AztecNodeService');
98
573
  this.tracer = telemetry.getTracer('AztecNodeService');
99
- this.txQueue.start();
100
574
  this.log.info(`Aztec Node version: ${this.packageVersion}`);
101
- this.log.info(`Aztec Node started on chain 0x${l1ChainId.toString(16)}`, config.l1Contracts);
575
+ this.log.info(`Aztec Node started on chain 0x${l1ChainId.toString(16)}`, pickL1ContractAddresses(config));
576
+ // A defensive check that protects us against introducing a bug in the complex `createAndSync` function. We must
577
+ // never have debugLogStore enabled when not in test mode because then we would be accumulating debug logs in
578
+ // memory which could be a DoS vector on the sequencer (since no fees are paid for debug logs).
579
+ if (debugLogStore.isEnabled && config.realProofs) {
580
+ throw new Error('debugLogStore should never be enabled when realProofs are set');
581
+ }
582
+ }
583
+ /** @internal Exposed for testing — returns the RPC proof verifier. */ getProofVerifier() {
584
+ return this.rpcProofVerifier;
102
585
  }
103
586
  async getWorldStateSyncStatus() {
104
587
  const status = await this.worldStateSynchronizer.status();
105
588
  return status.syncSummary;
106
589
  }
107
- getL2Tips() {
108
- return this.blockSource.getL2Tips();
590
+ async getChainTips() {
591
+ const { proposed, checkpointed, proven, finalized } = await this.blockSource.getL2Tips();
592
+ return {
593
+ proposed,
594
+ checkpointed,
595
+ proven,
596
+ finalized
597
+ };
598
+ }
599
+ getCheckpointsData(query) {
600
+ return this.blockSource.getCheckpointsData(query);
601
+ }
602
+ async getBlockNumber(tip) {
603
+ if (tip === undefined || tip === 'proposed') {
604
+ return this.blockSource.getBlockNumber();
605
+ }
606
+ return await this.blockSource.getBlockNumber({
607
+ tag: tip
608
+ }) ?? BlockNumber.ZERO;
609
+ }
610
+ async getCheckpointNumber(tip) {
611
+ const tips = await this.blockSource.getL2Tips();
612
+ switch(tip){
613
+ case undefined:
614
+ case 'checkpointed':
615
+ return tips.checkpointed.checkpoint.number;
616
+ case 'proposed':
617
+ return tips.proposedCheckpoint.checkpoint.number;
618
+ case 'proven':
619
+ return tips.proven.checkpoint.number;
620
+ case 'finalized':
621
+ return tips.finalized.checkpoint.number;
622
+ }
623
+ }
624
+ isChainTip(value) {
625
+ return value === 'proposed' || value === 'checkpointed' || value === 'proven' || value === 'finalized';
626
+ }
627
+ /**
628
+ * Normalizes a {@link BlockParameter} (which may be a bare value) into a
629
+ * {@link NormalizedBlockParameter} object form. Performs no chain-tip resolution — tag
630
+ * lookups are deferred to the underlying block source.
631
+ */ normalizeBlockParameter(param) {
632
+ if (BlockHash.isBlockHash(param)) {
633
+ return {
634
+ hash: param
635
+ };
636
+ }
637
+ if (typeof param === 'number') {
638
+ return {
639
+ number: param
640
+ };
641
+ }
642
+ if (typeof param === 'string') {
643
+ if (this.isBlockTag(param)) {
644
+ return {
645
+ tag: param === 'latest' ? 'proposed' : param
646
+ };
647
+ }
648
+ throw new BadRequestError(`Invalid BlockParameter tag: ${param}`);
649
+ }
650
+ if (typeof param === 'object' && param !== null) {
651
+ if ('number' in param) {
652
+ return {
653
+ number: param.number
654
+ };
655
+ }
656
+ if ('hash' in param) {
657
+ return {
658
+ hash: param.hash
659
+ };
660
+ }
661
+ if ('archive' in param) {
662
+ return {
663
+ archive: param.archive
664
+ };
665
+ }
666
+ if ('tag' in param) {
667
+ if (this.isBlockTag(param.tag)) {
668
+ return {
669
+ tag: param.tag
670
+ };
671
+ }
672
+ throw new BadRequestError(`Invalid BlockParameter tag: ${param.tag}`);
673
+ }
674
+ }
675
+ throw new BadRequestError(`Invalid BlockParameter: ${JSON.stringify(param)}`);
676
+ }
677
+ isBlockTag(value) {
678
+ return BlockTag.includes(value);
679
+ }
680
+ /**
681
+ * Resolves a {@link CheckpointParameter} into a concrete `{ number }` or `{ slot }` query.
682
+ *
683
+ * Tag-based parameters (`'proposed'`, `'checkpointed'`, `'proven'`, `'finalized'`) are
684
+ * translated up-front to the corresponding tip's checkpoint number via {@link L2BlockSource.getL2Tips}.
685
+ * After resolution the unified {@link getCheckpoint} flow can perform a single
686
+ * confirmed→proposed lookup against either store.
687
+ */ async resolveCheckpointParameter(param) {
688
+ if (typeof param === 'number') {
689
+ return {
690
+ number: param
691
+ };
692
+ }
693
+ if (this.isChainTip(param)) {
694
+ const tips = await this.blockSource.getL2Tips();
695
+ switch(param){
696
+ case 'proposed':
697
+ return {
698
+ number: tips.proposedCheckpoint.checkpoint.number
699
+ };
700
+ case 'checkpointed':
701
+ return {
702
+ number: tips.checkpointed.checkpoint.number
703
+ };
704
+ case 'proven':
705
+ return {
706
+ number: tips.proven.checkpoint.number
707
+ };
708
+ case 'finalized':
709
+ return {
710
+ number: tips.finalized.checkpoint.number
711
+ };
712
+ }
713
+ }
714
+ if (typeof param === 'object' && param !== null) {
715
+ if ('number' in param) {
716
+ return {
717
+ number: param.number
718
+ };
719
+ }
720
+ if ('slot' in param) {
721
+ return {
722
+ slot: param.slot
723
+ };
724
+ }
725
+ }
726
+ throw new BadRequestError(`Invalid CheckpointParameter: ${JSON.stringify(param)}`);
727
+ }
728
+ /** Fetches checkpoint-level L1 and attestation data for use as block response context. */ async #getCheckpointContext(checkpointNumber) {
729
+ const checkpoint = await this.blockSource.getCheckpointData({
730
+ number: checkpointNumber
731
+ });
732
+ if (!checkpoint) {
733
+ return undefined;
734
+ }
735
+ return {
736
+ l1: checkpoint.l1,
737
+ attestations: checkpoint.attestations
738
+ };
739
+ }
740
+ async getBlock(param, options = {}) {
741
+ const query = this.normalizeBlockParameter(param);
742
+ const wantTxs = !!options.includeTransactions;
743
+ const wantContext = !!options.includeL1PublishInfo || !!options.includeAttestations;
744
+ if (wantTxs) {
745
+ const block = await this.blockSource.getBlock(query);
746
+ if (!block) {
747
+ return undefined;
748
+ }
749
+ const ctx = wantContext ? await this.#getCheckpointContext(block.checkpointNumber) : undefined;
750
+ return await blockResponseFromL2Block(block, options, ctx);
751
+ }
752
+ const data = await this.blockSource.getBlockData(query);
753
+ if (!data) {
754
+ return undefined;
755
+ }
756
+ const ctx = wantContext ? await this.#getCheckpointContext(data.checkpointNumber) : undefined;
757
+ return blockResponseFromBlockData(data, options, ctx);
758
+ }
759
+ getBlockData(param) {
760
+ const query = this.normalizeBlockParameter(param);
761
+ return this.blockSource.getBlockData(query);
762
+ }
763
+ async getBlocks(from, limit, options = {}) {
764
+ const wantTxs = !!options.includeTransactions;
765
+ const wantContext = !!options.includeL1PublishInfo || !!options.includeAttestations;
766
+ const onlyCheckpointed = !!options.onlyCheckpointed;
767
+ if (wantTxs) {
768
+ const blocks = await this.blockSource.getBlocks({
769
+ from,
770
+ limit,
771
+ onlyCheckpointed
772
+ });
773
+ const ctxByCheckpoint = await this.#getCheckpointContextsForBlocks(wantContext ? blocks : []);
774
+ return await Promise.all(blocks.map((block)=>blockResponseFromL2Block(block, options, ctxByCheckpoint.get(block.checkpointNumber))));
775
+ }
776
+ const dataItems = await this.blockSource.getBlocksData({
777
+ from,
778
+ limit,
779
+ onlyCheckpointed
780
+ });
781
+ const ctxByCheckpoint = await this.#getCheckpointContextsForBlocks(wantContext ? dataItems : []);
782
+ return await Promise.all(dataItems.map((data)=>blockResponseFromBlockData(data, options, ctxByCheckpoint.get(data.checkpointNumber))));
783
+ }
784
+ /** Fetches checkpoint context for a set of blocks, deduplicating shared checkpoints. */ async #getCheckpointContextsForBlocks(blocks) {
785
+ const unique = Array.from(new Set(blocks.map((b)=>b.checkpointNumber)));
786
+ const entries = await Promise.all(unique.map(async (n)=>[
787
+ n,
788
+ await this.#getCheckpointContext(n)
789
+ ]));
790
+ return new Map(entries);
791
+ }
792
+ async getCheckpoint(param, options = {}) {
793
+ const query = await this.resolveCheckpointParameter(param);
794
+ // Try the confirmed store first.
795
+ const confirmed = options.includeBlocks ? await this.blockSource.getCheckpoint(query) : await this.blockSource.getCheckpointData(query);
796
+ if (confirmed) {
797
+ return await (options.includeBlocks ? checkpointResponseFromPublishedCheckpoint(confirmed, options) : checkpointResponseFromCheckpointData(confirmed, options));
798
+ }
799
+ // Fall back to the proposed store.
800
+ const proposed = await this.blockSource.getProposedCheckpointData(query);
801
+ if (proposed) {
802
+ if (options.includeAttestations || options.includeL1PublishInfo) {
803
+ throw new BadRequestError(`Options includeL1PublishInfo or includeAttestations cannot be satisfied for a proposed checkpoint`);
804
+ }
805
+ const blocks = options.includeBlocks ? await this.blockSource.getBlocks({
806
+ from: proposed.startBlock,
807
+ limit: proposed.blockCount
808
+ }) : undefined;
809
+ return await projectProposedToCheckpointResponse(proposed, options, blocks);
810
+ }
811
+ return undefined;
812
+ }
813
+ async getCheckpoints(from, limit, options = {}) {
814
+ if (options.includeBlocks) {
815
+ const checkpoints = await this.blockSource.getCheckpoints({
816
+ from,
817
+ limit
818
+ });
819
+ return await Promise.all(checkpoints.map((cp)=>checkpointResponseFromPublishedCheckpoint(cp, options)));
820
+ }
821
+ const datas = await this.blockSource.getCheckpointsData({
822
+ from,
823
+ limit
824
+ });
825
+ return datas.map((d)=>checkpointResponseFromCheckpointData(d, options));
109
826
  }
110
827
  /**
111
828
  * initializes the Aztec Node, wait for component to sync.
@@ -116,23 +833,31 @@ import { NodeMetrics } from './node_metrics.js';
116
833
  ...inputConfig
117
834
  }; // Copy the config so we dont mutate the input object
118
835
  const log = deps.logger ?? createLogger('node');
119
- const packageVersion = getPackageVersion() ?? '';
836
+ const packageVersion = getPackageVersion();
120
837
  const telemetry = deps.telemetry ?? getTelemetryClient();
121
838
  const dateProvider = deps.dateProvider ?? new DateProvider();
122
- const blobSinkClient = deps.blobSinkClient ?? createBlobSinkClient(config, {
123
- logger: createLogger('node:blob-sink:client')
124
- });
125
839
  const ethereumChain = createEthereumChain(config.l1RpcUrls, config.l1ChainId);
126
- // Build a key store from file if given or from environment otherwise
840
+ // Build a key store from file if given or from environment otherwise.
841
+ // We keep the raw KeyStore available so we can merge with prover keys if enableProverNode is set.
127
842
  let keyStoreManager;
128
843
  const keyStoreProvided = config.keyStoreDirectory !== undefined && config.keyStoreDirectory.length > 0;
129
844
  if (keyStoreProvided) {
130
845
  const keyStores = loadKeystores(config.keyStoreDirectory);
131
846
  keyStoreManager = new KeystoreManager(mergeKeystores(keyStores));
132
847
  } else {
133
- const keyStore = createKeyStoreForValidator(config);
134
- if (keyStore) {
135
- keyStoreManager = new KeystoreManager(keyStore);
848
+ const rawKeyStores = [];
849
+ const validatorKeyStore = createKeyStoreForValidator(config);
850
+ if (validatorKeyStore) {
851
+ rawKeyStores.push(validatorKeyStore);
852
+ }
853
+ if (config.enableProverNode) {
854
+ const proverKeyStore = createKeyStoreForProver(config);
855
+ if (proverKeyStore) {
856
+ rawKeyStores.push(proverKeyStore);
857
+ }
858
+ }
859
+ if (rawKeyStores.length > 0) {
860
+ keyStoreManager = new KeystoreManager(rawKeyStores.length === 1 ? rawKeyStores[0] : mergeKeystores(rawKeyStores));
136
861
  }
137
862
  }
138
863
  await keyStoreManager?.validateSigners();
@@ -141,8 +866,8 @@ import { NodeMetrics } from './node_metrics.js';
141
866
  if (keyStoreManager === undefined) {
142
867
  throw new Error('Failed to create key store, a requirement for running a validator');
143
868
  }
144
- if (!keyStoreProvided) {
145
- log.warn('KEY STORE CREATED FROM ENVIRONMENT, IT IS RECOMMENDED TO USE A FILE-BASED KEY STORE IN PRODUCTION ENVIRONMENTS');
869
+ if (!keyStoreProvided && process.env.NODE_ENV !== 'test') {
870
+ log.warn("Keystore created from env: it's recommended to use a file-based key store for production");
146
871
  }
147
872
  ValidatorClient.validateKeyStoreConfiguration(keyStoreManager, log);
148
873
  }
@@ -152,159 +877,359 @@ import { NodeMetrics } from './node_metrics.js';
152
877
  }
153
878
  const publicClient = createPublicClient({
154
879
  chain: ethereumChain.chainInfo,
155
- transport: fallback(config.l1RpcUrls.map((url)=>http(url))),
880
+ transport: makeL1HttpTransport(config.l1RpcUrls, {
881
+ timeout: config.l1HttpTimeoutMS
882
+ }),
156
883
  pollingInterval: config.viemPollingIntervalMS
157
884
  });
158
- const l1ContractsAddresses = await RegistryContract.collectAddresses(publicClient, config.l1Contracts.registryAddress, config.rollupVersion ?? 'canonical');
159
- // Overwrite the passed in vars.
160
- config.l1Contracts = {
161
- ...config.l1Contracts,
162
- ...l1ContractsAddresses
163
- };
164
- const rollupContract = new RollupContract(publicClient, config.l1Contracts.rollupAddress.toString());
165
- const [l1GenesisTime, slotDuration, rollupVersionFromRollup] = await Promise.all([
885
+ const l1ContractsAddresses = await RegistryContract.collectAddresses(publicClient, config.registryAddress, config.rollupVersion ?? 'canonical');
886
+ Object.assign(config, l1ContractsAddresses);
887
+ const rollupContract = new RollupContract(publicClient, config.rollupAddress.toString());
888
+ const [l1GenesisTime, slotDuration, rollupVersionFromRollup, rollupManaLimit] = await Promise.all([
166
889
  rollupContract.getL1GenesisTime(),
167
890
  rollupContract.getSlotDuration(),
168
- rollupContract.getVersion()
891
+ rollupContract.getVersion(),
892
+ rollupContract.getManaLimit().then(Number)
169
893
  ]);
170
894
  config.rollupVersion ??= Number(rollupVersionFromRollup);
171
895
  if (config.rollupVersion !== Number(rollupVersionFromRollup)) {
172
896
  log.warn(`Registry looked up and returned a rollup with version (${config.rollupVersion}), but this does not match with version detected from the rollup directly: (${rollupVersionFromRollup}).`);
173
897
  }
898
+ const blobClient = await createBlobClientWithFileStores(config, log.createChild('blob-client'));
174
899
  // attempt snapshot sync if possible
175
900
  await trySnapshotSync(config, log);
176
- const epochCache = await EpochCache.create(config.l1Contracts.rollupAddress, config, {
177
- dateProvider
178
- });
179
- const archiver = await createArchiver(config, {
180
- blobSinkClient,
181
- epochCache,
182
- telemetry,
901
+ const epochCache = await EpochCache.create(config.rollupAddress, config, {
183
902
  dateProvider
184
- }, {
185
- blockUntilSync: !config.skipArchiverInitialSync
186
903
  });
187
- // now create the merkle trees and the world state synchronizer
188
- const worldStateSynchronizer = await createWorldStateSynchronizer(config, archiver, options.prefilledPublicData, telemetry);
189
- const circuitVerifier = config.realProofs ? await BBCircuitVerifier.new(config) : new TestCircuitVerifier();
190
- if (!config.realProofs) {
191
- log.warn(`Aztec node is accepting fake proofs`);
192
- }
193
- const proofVerifier = new QueuedIVCVerifier(config, circuitVerifier);
194
- // create the tx pool and the p2p client, which will need the l2 block source
195
- const p2pClient = await createP2PClient(P2PClientType.Full, config, archiver, proofVerifier, worldStateSynchronizer, epochCache, packageVersion, dateProvider, telemetry, deps.p2pClientDeps);
196
- // We should really not be modifying the config object
197
- config.txPublicSetupAllowList = config.txPublicSetupAllowList ?? await getDefaultAllowedSetupFunctions();
198
- const blockBuilder = new BlockBuilder({
199
- ...config,
200
- l1GenesisTime,
201
- slotDuration: Number(slotDuration)
202
- }, worldStateSynchronizer, archiver, dateProvider, telemetry);
203
- // We'll accumulate sentinel watchers here
204
- const watchers = [];
205
- // Create validator client if required
206
- const validatorClient = createValidatorClient(config, {
207
- p2pClient,
208
- telemetry,
209
- dateProvider,
210
- epochCache,
211
- blockBuilder,
212
- blockSource: archiver,
213
- l1ToL2MessageSource: archiver,
214
- keyStoreManager
215
- });
216
- // If we have a validator client, register it as a source of offenses for the slasher,
217
- // and have it register callbacks on the p2p client *before* we start it, otherwise messages
218
- // like attestations or auths will fail.
219
- if (validatorClient) {
220
- watchers.push(validatorClient);
221
- if (!options.dontStartSequencer) {
222
- await validatorClient.registerHandlers();
223
- }
224
- }
225
- // If there's no validator client but alwaysReexecuteBlockProposals is enabled,
226
- // create a BlockProposalHandler to reexecute block proposals for monitoring
227
- if (!validatorClient && config.alwaysReexecuteBlockProposals) {
228
- log.info('Setting up block proposal reexecution for monitoring');
229
- createBlockProposalHandler(config, {
230
- blockBuilder,
904
+ // Track started resources so we can clean up on partial failure during node creation.
905
+ const started = [];
906
+ try {
907
+ // Default the orphan-prune grace window from the block build duration when unset, so the archiver
908
+ // waits roughly one build slot for a proposed checkpoint to arrive before pruning a block-only tip.
909
+ config.orphanProposedBlockPruneGraceSeconds ??= config.blockDurationMs !== undefined ? Math.ceil(config.blockDurationMs / 1000) : MIN_EXECUTION_TIME;
910
+ // Create world-state first so we can retrieve the initial header before constructing the archiver.
911
+ const nativeWs = await createWorldState(config, options.genesis);
912
+ const initialHeader = nativeWs.getInitialHeader();
913
+ const initialBlockHash = await initialHeader.hash();
914
+ const archiver = await createArchiver(config, {
915
+ blobClient,
231
916
  epochCache,
232
- blockSource: archiver,
233
- l1ToL2MessageSource: archiver,
234
- p2pClient,
235
- dateProvider,
236
- telemetry
237
- }).registerForReexecution(p2pClient);
238
- }
239
- // Start world state and wait for it to sync to the archiver.
240
- await worldStateSynchronizer.start();
241
- // Start p2p. Note that it depends on world state to be running.
242
- await p2pClient.start();
243
- const validatorsSentinel = await createSentinel(epochCache, archiver, p2pClient, config);
244
- if (validatorsSentinel && config.slashInactivityPenalty > 0n) {
245
- watchers.push(validatorsSentinel);
246
- }
247
- let epochPruneWatcher;
248
- if (config.slashPrunePenalty > 0n || config.slashDataWithholdingPenalty > 0n) {
249
- epochPruneWatcher = new EpochPruneWatcher(archiver, archiver, epochCache, p2pClient.getTxProvider(), blockBuilder, config);
250
- watchers.push(epochPruneWatcher);
251
- }
252
- // We assume we want to slash for invalid attestations unless all max penalties are set to 0
253
- let attestationsBlockWatcher;
254
- if (config.slashProposeInvalidAttestationsPenalty > 0n || config.slashAttestDescendantOfInvalidPenalty > 0n) {
255
- attestationsBlockWatcher = new AttestationsBlockWatcher(archiver, epochCache, config);
256
- watchers.push(attestationsBlockWatcher);
257
- }
258
- // Start p2p-related services once the archiver has completed sync
259
- void archiver.waitForInitialSync().then(async ()=>{
260
- await p2pClient.start();
261
- await validatorsSentinel?.start();
262
- await epochPruneWatcher?.start();
263
- await attestationsBlockWatcher?.start();
264
- log.info(`All p2p services started`);
265
- }).catch((err)=>log.error('Failed to start p2p services after archiver sync', err));
266
- // Validator enabled, create/start relevant service
267
- let sequencer;
268
- let slasherClient;
269
- if (!config.disableValidator) {
270
- // We create a slasher only if we have a sequencer, since all slashing actions go through the sequencer publisher
271
- // as they are executed when the node is selected as proposer.
272
- const validatorAddresses = keyStoreManager ? NodeKeystoreAdapter.fromKeyStoreManager(keyStoreManager).getAddresses() : [];
273
- slasherClient = await createSlasher(config, config.l1Contracts, getPublicClient(config), watchers, dateProvider, epochCache, validatorAddresses, undefined);
274
- await slasherClient.start();
275
- const l1TxUtils = await createL1TxUtilsWithBlobsFromEthSigner(publicClient, keyStoreManager.createAllValidatorPublisherSigners(), {
276
- ...config,
277
- scope: 'sequencer'
278
- }, {
279
917
  telemetry,
280
- logger: log.createChild('l1-tx-utils'),
281
918
  dateProvider
919
+ }, {
920
+ blockUntilSync: !config.skipArchiverInitialSync,
921
+ // The non-pipelined automine sequencer publishes each checkpoint in-slot, so it never
922
+ // leaves orphan proposed blocks; pruning would race its local push. See pruneOrphanProposedBlocks.
923
+ enableOrphanProposedBlockPruning: !config.useAutomineSequencer
924
+ }, initialHeader, initialBlockHash);
925
+ started.push(archiver);
926
+ // The synchronizer takes ownership of the native world-state from here
927
+ const worldStateSynchronizer = await createWorldStateSynchronizer(config, archiver, nativeWs, telemetry);
928
+ started.push(worldStateSynchronizer);
929
+ const useRealVerifiers = config.realProofs || config.debugForceTxProofVerification;
930
+ let peerProofVerifier;
931
+ let rpcProofVerifier;
932
+ if (useRealVerifiers) {
933
+ peerProofVerifier = await BatchChonkVerifier.new(config, config.bbChonkVerifyMaxBatch, 'peer');
934
+ const rpcVerifier = await BBCircuitVerifier.new(config);
935
+ rpcProofVerifier = new QueuedIVCVerifier(rpcVerifier, config.numConcurrentIVCVerifiers);
936
+ } else {
937
+ peerProofVerifier = new TestCircuitVerifier(config.proverTestVerificationDelayMs);
938
+ rpcProofVerifier = new TestCircuitVerifier(config.proverTestVerificationDelayMs);
939
+ }
940
+ started.push(peerProofVerifier, rpcProofVerifier);
941
+ let debugLogStore;
942
+ if (!config.realProofs) {
943
+ log.warn(`Aztec node is accepting fake proofs`);
944
+ debugLogStore = new InMemoryDebugLogStore();
945
+ log.info('Aztec node started in test mode (realProofs set to false) hence debug logs from public functions will be collected and served');
946
+ } else {
947
+ debugLogStore = new NullDebugLogStore();
948
+ }
949
+ const globalVariableBuilderConfig = {
950
+ rollupAddress: config.rollupAddress,
951
+ ethereumSlotDuration: config.ethereumSlotDuration,
952
+ rollupVersion: BigInt(config.rollupVersion),
953
+ l1GenesisTime,
954
+ slotDuration: Number(slotDuration)
955
+ };
956
+ const globalVariableBuilder = new GlobalVariableBuilder(dateProvider, publicClient, globalVariableBuilderConfig);
957
+ const feeProvider = new FeeProviderImpl(dateProvider, publicClient, globalVariableBuilderConfig);
958
+ const proverOnly = config.enableProverNode && config.disableValidator;
959
+ if (proverOnly) {
960
+ log.info('Starting in prover-only mode: skipping validator, sequencer, sentinel, and slasher subsystems');
961
+ }
962
+ // create the tx pool and the p2p client, which will need the l2 block source
963
+ const p2pClient = await createP2PClient(config, archiver, peerProofVerifier, worldStateSynchronizer, epochCache, feeProvider, packageVersion, dateProvider, telemetry, deps.p2pClientDeps, initialBlockHash);
964
+ started.push(p2pClient);
965
+ // We'll accumulate sentinel watchers here
966
+ const watchers = [];
967
+ // Create FullNodeCheckpointsBuilder for block proposal handling and tx validation.
968
+ // Override maxTxsPerCheckpoint with the validator-specific limit if set.
969
+ const validatorCheckpointsBuilder = new FullNodeCheckpointsBuilder({
970
+ ...config,
971
+ l1GenesisTime,
972
+ slotDuration: Number(slotDuration),
973
+ rollupManaLimit,
974
+ maxTxsPerCheckpoint: config.validateMaxTxsPerCheckpoint
975
+ }, worldStateSynchronizer, archiver, dateProvider, telemetry);
976
+ let validatorClient;
977
+ // Tracks successful checkpoint re-execution by a checkpoint proposal handler.
978
+ const reexecutionTracker = new CheckpointReexecutionTracker();
979
+ if (!config.disableValidator) {
980
+ // Create validator client if required
981
+ validatorClient = await createValidatorClient(config, {
982
+ checkpointsBuilder: validatorCheckpointsBuilder,
983
+ worldState: worldStateSynchronizer,
984
+ p2pClient,
985
+ telemetry,
986
+ dateProvider,
987
+ epochCache,
988
+ blockSource: archiver,
989
+ l1ToL2MessageSource: archiver,
990
+ keyStoreManager,
991
+ blobClient,
992
+ reexecutionTracker,
993
+ slashingProtectionDb: deps.slashingProtectionDb
994
+ });
995
+ // If we have a validator client, register it as a source of offenses for the slasher,
996
+ // and have it register callbacks on the p2p client *before* we start it, otherwise messages
997
+ // like attestations or auths will fail.
998
+ if (validatorClient) {
999
+ watchers.push(validatorClient);
1000
+ const vc = validatorClient;
1001
+ const getValidatorAddresses = ()=>vc.getValidatorAddresses().map((a)=>a.toString());
1002
+ validatorClient.getProposalHandler().register(p2pClient, true, archiver, getValidatorAddresses);
1003
+ if (!options.dontStartSequencer) {
1004
+ await validatorClient.registerHandlers();
1005
+ }
1006
+ }
1007
+ }
1008
+ // If there's no validator client, create a ProposalHandler to handle block and checkpoint proposals
1009
+ // for monitoring or reexecution. Reexecution (default) allows us to follow the pending chain,
1010
+ // while non-reexecution is used for validating the proposals and collecting their txs.
1011
+ // Checkpoint proposals rebuild blobs if the blob client can upload blobs.
1012
+ if (!validatorClient) {
1013
+ const reexecute = !!config.alwaysReexecuteBlockProposals;
1014
+ log.info(`Setting up proposal handler` + (reexecute ? ' with reexecution of proposals' : ''));
1015
+ createProposalHandler(config, {
1016
+ checkpointsBuilder: validatorCheckpointsBuilder,
1017
+ worldState: worldStateSynchronizer,
1018
+ epochCache,
1019
+ blockSource: archiver,
1020
+ l1ToL2MessageSource: archiver,
1021
+ p2pClient,
1022
+ blobClient,
1023
+ dateProvider,
1024
+ telemetry,
1025
+ reexecutionTracker
1026
+ }).register(p2pClient, reexecute, archiver);
1027
+ }
1028
+ // Start world state and wait for it to sync to the archiver.
1029
+ await worldStateSynchronizer.start();
1030
+ // Start p2p. Note that it depends on world state to be running.
1031
+ await p2pClient.start();
1032
+ let validatorsSentinel;
1033
+ let dataWithholdingWatcher;
1034
+ let attestationsBlockWatcher;
1035
+ let attestedInvalidProposalWatcher;
1036
+ let broadcastedInvalidCheckpointProposalWatcher;
1037
+ let checkpointEquivocationWatcher;
1038
+ if (!proverOnly) {
1039
+ validatorsSentinel = await createSentinel(epochCache, archiver, p2pClient, reexecutionTracker, config);
1040
+ if (validatorsSentinel) {
1041
+ watchers.push(validatorsSentinel);
1042
+ }
1043
+ dataWithholdingWatcher = new DataWithholdingWatcher(epochCache, archiver, p2pClient.getTxProvider(), p2pClient, reexecutionTracker, {
1044
+ chainId: config.l1ChainId,
1045
+ rollupAddress: config.rollupAddress
1046
+ }, config);
1047
+ watchers.push(dataWithholdingWatcher);
1048
+ broadcastedInvalidCheckpointProposalWatcher = new BroadcastedInvalidCheckpointProposalWatcher(p2pClient, archiver, epochCache, config);
1049
+ watchers.push(broadcastedInvalidCheckpointProposalWatcher);
1050
+ if (validatorClient) {
1051
+ attestedInvalidProposalWatcher = new AttestedInvalidProposalWatcher(p2pClient, validatorClient, archiver, epochCache, config, {
1052
+ log: log.createChild('attested-invalid-proposal-watcher')
1053
+ });
1054
+ watchers.push(attestedInvalidProposalWatcher);
1055
+ }
1056
+ checkpointEquivocationWatcher = new CheckpointEquivocationWatcher(archiver, epochCache, config);
1057
+ watchers.push(checkpointEquivocationWatcher);
1058
+ attestationsBlockWatcher = new AttestationsBlockWatcher(archiver, epochCache, config, log.getBindings());
1059
+ watchers.push(attestationsBlockWatcher);
1060
+ }
1061
+ const watchersToStart = compactArray([
1062
+ validatorsSentinel,
1063
+ dataWithholdingWatcher,
1064
+ attestationsBlockWatcher,
1065
+ broadcastedInvalidCheckpointProposalWatcher,
1066
+ attestedInvalidProposalWatcher,
1067
+ checkpointEquivocationWatcher
1068
+ ]);
1069
+ const startedWatchers = [];
1070
+ const stopStartedWatchers = async ()=>{
1071
+ for (const watcher of startedWatchers){
1072
+ await tryStop(watcher);
1073
+ }
1074
+ };
1075
+ // Start p2p-related services once the archiver has completed sync
1076
+ void archiver.waitForInitialSync().then(async ()=>{
1077
+ for (const watcher of watchersToStart){
1078
+ await watcher.start();
1079
+ startedWatchers.push(watcher);
1080
+ }
1081
+ log.info(`All p2p services started`);
1082
+ }).catch((err)=>log.error('Failed to start p2p services after archiver sync', err));
1083
+ started.push({
1084
+ stop: stopStartedWatchers
282
1085
  });
283
- // Create and start the sequencer client
284
- sequencer = await SequencerClient.new(config, {
285
- ...deps,
286
- epochCache,
287
- l1TxUtils,
288
- validatorClient,
289
- p2pClient,
290
- worldStateSynchronizer,
291
- slasherClient,
292
- blockBuilder,
293
- l2BlockSource: archiver,
294
- l1ToL2MessageSource: archiver,
295
- telemetry,
296
- dateProvider,
297
- blobSinkClient,
298
- nodeKeyStore: keyStoreManager
299
- });
300
- }
301
- if (!options.dontStartSequencer && sequencer) {
302
- await sequencer.start();
303
- log.verbose(`Sequencer started`);
304
- } else if (sequencer) {
305
- log.warn(`Sequencer created but not started`);
1086
+ // Validator enabled, create/start relevant service
1087
+ let sequencer;
1088
+ let automineSequencer;
1089
+ let slasherClient;
1090
+ if (!config.disableValidator && validatorClient) {
1091
+ // We create a slasher only if we have a sequencer, since all slashing actions go through the sequencer publisher
1092
+ // as they are executed when the node is selected as proposer.
1093
+ const validatorAddresses = keyStoreManager ? NodeKeystoreAdapter.fromKeyStoreManager(keyStoreManager).getAddresses() : [];
1094
+ slasherClient = await createSlasher(config, pickL1ContractAddresses(config), getPublicClient(config), watchers, dateProvider, epochCache, validatorAddresses, undefined);
1095
+ await slasherClient.start();
1096
+ started.push(slasherClient);
1097
+ const l1TxUtils = config.sequencerPublisherForwarderAddress ? await createForwarderL1TxUtilsFromSigners(publicClient, keyStoreManager.createAllValidatorPublisherSigners(), config.sequencerPublisherForwarderAddress, {
1098
+ ...config,
1099
+ scope: 'sequencer'
1100
+ }, {
1101
+ telemetry,
1102
+ logger: log.createChild('l1-tx-utils'),
1103
+ dateProvider,
1104
+ kzg: Blob.getViemKzgInstance()
1105
+ }) : await createL1TxUtilsFromSigners(publicClient, keyStoreManager.createAllValidatorPublisherSigners(), {
1106
+ ...config,
1107
+ scope: 'sequencer'
1108
+ }, {
1109
+ telemetry,
1110
+ logger: log.createChild('l1-tx-utils'),
1111
+ dateProvider,
1112
+ kzg: Blob.getViemKzgInstance()
1113
+ });
1114
+ // Create a funder L1TxUtils from the keystore funding account (if configured)
1115
+ const fundingSigner = keyStoreManager?.createFundingSigner();
1116
+ let funderL1TxUtils;
1117
+ if (fundingSigner) {
1118
+ const [funder] = await createL1TxUtilsFromSigners(publicClient, [
1119
+ fundingSigner
1120
+ ], {
1121
+ ...config,
1122
+ scope: 'sequencer'
1123
+ }, {
1124
+ telemetry,
1125
+ logger: log.createChild('l1-tx-utils:funder'),
1126
+ dateProvider
1127
+ });
1128
+ funderL1TxUtils = funder;
1129
+ }
1130
+ // Create and start the sequencer client
1131
+ const checkpointsBuilder = new CheckpointsBuilder({
1132
+ ...config,
1133
+ l1GenesisTime,
1134
+ slotDuration: Number(slotDuration),
1135
+ rollupManaLimit
1136
+ }, worldStateSynchronizer, archiver, dateProvider, telemetry, debugLogStore);
1137
+ if (config.useAutomineSequencer) {
1138
+ // Test-only path: deterministic, queue-driven sequencer for non-block-building e2e tests.
1139
+ // See `AUTOMINE_E2E_OPTS` in `end-to-end/src/fixtures/fixtures.ts`.
1140
+ automineSequencer = await createAutomineSequencer({
1141
+ config,
1142
+ l1TxUtils,
1143
+ funderL1TxUtils,
1144
+ publicClient,
1145
+ rollupContract,
1146
+ epochCache,
1147
+ blobClient,
1148
+ telemetry,
1149
+ dateProvider,
1150
+ keyStoreManager: keyStoreManager,
1151
+ validatorClient,
1152
+ checkpointsBuilder,
1153
+ globalVariableBuilder,
1154
+ worldStateSynchronizer,
1155
+ archiver,
1156
+ p2pClient,
1157
+ l1Constants: {
1158
+ l1GenesisTime,
1159
+ slotDuration: Number(slotDuration),
1160
+ ethereumSlotDuration: config.ethereumSlotDuration,
1161
+ rollupManaLimit
1162
+ },
1163
+ log
1164
+ });
1165
+ } else {
1166
+ sequencer = await SequencerClient.new(config, {
1167
+ ...deps,
1168
+ epochCache,
1169
+ l1TxUtils,
1170
+ funderL1TxUtils,
1171
+ validatorClient,
1172
+ p2pClient,
1173
+ worldStateSynchronizer,
1174
+ slasherClient,
1175
+ checkpointsBuilder,
1176
+ l2BlockSource: archiver,
1177
+ l1ToL2MessageSource: archiver,
1178
+ telemetry,
1179
+ dateProvider,
1180
+ blobClient,
1181
+ nodeKeyStore: keyStoreManager,
1182
+ globalVariableBuilder
1183
+ });
1184
+ }
1185
+ }
1186
+ if (!options.dontStartSequencer && sequencer) {
1187
+ await sequencer.start();
1188
+ started.push(sequencer);
1189
+ log.verbose(`Sequencer started`);
1190
+ } else if (sequencer) {
1191
+ log.warn(`Sequencer created but not started`);
1192
+ }
1193
+ if (!options.dontStartSequencer && automineSequencer) {
1194
+ await automineSequencer.start();
1195
+ started.push({
1196
+ stop: ()=>automineSequencer.stop()
1197
+ });
1198
+ log.verbose(`AutomineSequencer started`);
1199
+ } else if (automineSequencer) {
1200
+ log.warn(`AutomineSequencer created but not started`);
1201
+ }
1202
+ // Create prover node subsystem if enabled
1203
+ let proverNode;
1204
+ if (config.enableProverNode) {
1205
+ proverNode = await createProverNode(config, {
1206
+ ...deps.proverNodeDeps,
1207
+ telemetry,
1208
+ dateProvider,
1209
+ archiver,
1210
+ worldStateSynchronizer,
1211
+ p2pClient,
1212
+ epochCache,
1213
+ blobClient,
1214
+ keyStoreManager
1215
+ });
1216
+ if (!options.dontStartProverNode) {
1217
+ await proverNode.start();
1218
+ started.push(proverNode);
1219
+ log.info(`Prover node subsystem started`);
1220
+ } else {
1221
+ log.info(`Prover node subsystem created but not started`);
1222
+ }
1223
+ }
1224
+ const node = new AztecNodeService(config, p2pClient, archiver, archiver, archiver, archiver, worldStateSynchronizer, sequencer, proverNode, slasherClient, validatorsSentinel, stopStartedWatchers, ethereumChain.chainInfo.id, config.rollupVersion, globalVariableBuilder, feeProvider, epochCache, packageVersion, peerProofVerifier, rpcProofVerifier, telemetry, log, blobClient, validatorClient, keyStoreManager, debugLogStore, automineSequencer);
1225
+ return node;
1226
+ } catch (err) {
1227
+ log.error('Failed during node creation, stopping started resources', err);
1228
+ for (const resource of started.reverse()){
1229
+ await tryStop(resource);
1230
+ }
1231
+ throw err;
306
1232
  }
307
- return new AztecNodeService(config, p2pClient, archiver, archiver, archiver, archiver, worldStateSynchronizer, sequencer, slasherClient, validatorsSentinel, epochPruneWatcher, ethereumChain.chainInfo.id, config.rollupVersion, new GlobalVariableBuilder(config), epochCache, packageVersion, proofVerifier, telemetry, log);
308
1233
  }
309
1234
  /**
310
1235
  * Returns the sequencer client instance.
@@ -312,6 +1237,12 @@ import { NodeMetrics } from './node_metrics.js';
312
1237
  */ getSequencer() {
313
1238
  return this.sequencer;
314
1239
  }
1240
+ /** Test-only: returns the AutomineSequencer when wired via `useAutomineSequencer`. */ getAutomineSequencer() {
1241
+ return this.automineSequencer;
1242
+ }
1243
+ /** Returns the prover node subsystem, if enabled. */ getProverNode() {
1244
+ return this.proverNode;
1245
+ }
315
1246
  getBlockSource() {
316
1247
  return this.blockSource;
317
1248
  }
@@ -325,13 +1256,16 @@ import { NodeMetrics } from './node_metrics.js';
325
1256
  * Method to return the currently deployed L1 contract addresses.
326
1257
  * @returns - The currently deployed L1 contract addresses.
327
1258
  */ getL1ContractAddresses() {
328
- return Promise.resolve(this.config.l1Contracts);
1259
+ return Promise.resolve(pickL1ContractAddresses(this.config));
329
1260
  }
330
1261
  getEncodedEnr() {
331
1262
  return Promise.resolve(this.p2pClient.getEnr()?.encodeTxt());
332
1263
  }
333
1264
  async getAllowedPublicSetup() {
334
- return this.config.txPublicSetupAllowList ?? await getDefaultAllowedSetupFunctions();
1265
+ return [
1266
+ ...await getDefaultAllowedSetupFunctions(),
1267
+ ...this.config.txPublicSetupAllowListExtend ?? []
1268
+ ];
335
1269
  }
336
1270
  /**
337
1271
  * Method to determine if the node is ready to accept transactions.
@@ -354,59 +1288,25 @@ import { NodeMetrics } from './node_metrics.js';
354
1288
  rollupVersion,
355
1289
  enr,
356
1290
  l1ContractAddresses: contractAddresses,
357
- protocolContractAddresses: protocolContractAddresses
1291
+ protocolContractAddresses: protocolContractAddresses,
1292
+ realProofs: !!this.config.realProofs
358
1293
  };
359
1294
  return nodeInfo;
360
1295
  }
361
- /**
362
- * Get a block specified by its number.
363
- * @param number - The block number being requested.
364
- * @returns The requested block.
365
- */ async getBlock(number) {
366
- const blockNumber = number === 'latest' ? await this.getBlockNumber() : number;
367
- return await this.blockSource.getBlock(blockNumber);
1296
+ async getCurrentMinFees() {
1297
+ return await this.feeProvider.getCurrentMinFees();
368
1298
  }
369
- /**
370
- * Get a block specified by its hash.
371
- * @param blockHash - The block hash being requested.
372
- * @returns The requested block.
373
- */ async getBlockByHash(blockHash) {
374
- const publishedBlock = await this.blockSource.getPublishedBlockByHash(blockHash);
375
- return publishedBlock?.block;
1299
+ /** Returns predicted min fees for the current slot and next N slots. */ async getPredictedMinFees(manaUsage) {
1300
+ return await this.feeProvider.getPredictedMinFees(manaUsage);
376
1301
  }
377
- /**
378
- * Get a block specified by its archive root.
379
- * @param archive - The archive root being requested.
380
- * @returns The requested block.
381
- */ async getBlockByArchive(archive) {
382
- const publishedBlock = await this.blockSource.getPublishedBlockByArchive(archive);
383
- return publishedBlock?.block;
384
- }
385
- /**
386
- * Method to request blocks. Will attempt to return all requested blocks but will return only those available.
387
- * @param from - The start of the range of blocks to return.
388
- * @param limit - The maximum number of blocks to obtain.
389
- * @returns The blocks requested.
390
- */ async getBlocks(from, limit) {
391
- return await this.blockSource.getBlocks(from, limit) ?? [];
392
- }
393
- async getPublishedBlocks(from, limit) {
394
- return await this.blockSource.getPublishedBlocks(from, limit) ?? [];
395
- }
396
- /**
397
- * Method to fetch the current base fees.
398
- * @returns The current base fees.
399
- */ async getCurrentBaseFees() {
400
- return await this.globalVariableBuilder.getCurrentBaseFees();
401
- }
402
- /**
403
- * Method to fetch the latest block number synchronized by the node.
404
- * @returns The block number.
405
- */ async getBlockNumber() {
406
- return await this.blockSource.getBlockNumber();
407
- }
408
- async getProvenBlockNumber() {
409
- return await this.blockSource.getProvenBlockNumber();
1302
+ async getMaxPriorityFees() {
1303
+ for await (const tx of this.p2pClient.iteratePendingTxs()){
1304
+ return tx.getGasSettings().maxPriorityFeesPerGas;
1305
+ }
1306
+ return GasFees.from({
1307
+ feePerDaGas: 0n,
1308
+ feePerL2Gas: 0n
1309
+ });
410
1310
  }
411
1311
  /**
412
1312
  * Method to fetch the version of the package.
@@ -432,42 +1332,17 @@ import { NodeMetrics } from './node_metrics.js';
432
1332
  getContract(address) {
433
1333
  return this.contractDataSource.getContract(address);
434
1334
  }
435
- /**
436
- * Retrieves all private logs from up to `limit` blocks, starting from the block number `from`.
437
- * @param from - The block number from which to begin retrieving logs.
438
- * @param limit - The maximum number of blocks to retrieve logs from.
439
- * @returns An array of private logs from the specified range of blocks.
440
- */ getPrivateLogs(from, limit) {
441
- return this.logsSource.getPrivateLogs(from, limit);
442
- }
443
- /**
444
- * Gets all logs that match any of the received tags (i.e. logs with their first field equal to a tag).
445
- * @param tags - The tags to filter the logs by.
446
- * @param logsPerTag - The maximum number of logs to return for each tag. By default no limit is set
447
- * @returns For each received tag, an array of matching logs is returned. An empty array implies no logs match
448
- * that tag.
449
- */ getLogsByTags(tags, logsPerTag) {
450
- return this.logsSource.getLogsByTags(tags, logsPerTag);
451
- }
452
- /**
453
- * Gets public logs based on the provided filter.
454
- * @param filter - The filter to apply to the logs.
455
- * @returns The requested logs.
456
- */ getPublicLogs(filter) {
457
- return this.logsSource.getPublicLogs(filter);
1335
+ getPrivateLogsByTags(query) {
1336
+ return this.logsSource.getPrivateLogsByTags(query);
458
1337
  }
459
- /**
460
- * Gets contract class logs based on the provided filter.
461
- * @param filter - The filter to apply to the logs.
462
- * @returns The requested logs.
463
- */ getContractClassLogs(filter) {
464
- return this.logsSource.getContractClassLogs(filter);
1338
+ getPublicLogsByTags(query) {
1339
+ return this.logsSource.getPublicLogsByTags(query);
465
1340
  }
466
1341
  /**
467
1342
  * Method to submit a transaction to the p2p pool.
468
1343
  * @param tx - The transaction to be submitted.
469
1344
  */ async sendTx(tx) {
470
- await this.txQueue.put(()=>this.#sendTx(tx));
1345
+ await this.#sendTx(tx);
471
1346
  }
472
1347
  async #sendTx(tx) {
473
1348
  const timer = new Timer();
@@ -481,25 +1356,73 @@ import { NodeMetrics } from './node_metrics.js';
481
1356
  });
482
1357
  throw new Error(`Invalid tx: ${reason}`);
483
1358
  }
484
- await this.p2pClient.sendTx(tx);
485
- this.metrics.receivedTx(timer.ms(), true);
486
- this.log.info(`Received tx ${txHash}`, {
1359
+ try {
1360
+ await this.p2pClient.sendTx(tx);
1361
+ } catch (err) {
1362
+ this.metrics.receivedTx(timer.ms(), false);
1363
+ this.log.warn(`Mempool rejected tx ${txHash}: ${err.message}`, {
1364
+ txHash
1365
+ });
1366
+ throw err;
1367
+ }
1368
+ const duration = timer.ms();
1369
+ this.metrics.receivedTx(duration, true);
1370
+ this.log.info(`Received tx ${txHash} in ${duration}ms`, {
487
1371
  txHash
488
1372
  });
489
1373
  }
490
- async getTxReceipt(txHash) {
491
- let txReceipt = new TxReceipt(txHash, TxStatus.DROPPED, 'Tx dropped by P2P node.');
492
- // We first check if the tx is in pending (instead of first checking if it is mined) because if we first check
493
- // for mined and then for pending there could be a race condition where the tx is mined between the two checks
494
- // and we would incorrectly return a TxReceipt with status DROPPED
495
- if (await this.p2pClient.getTxStatus(txHash) === 'pending') {
496
- txReceipt = new TxReceipt(txHash, TxStatus.PENDING, '');
1374
+ async getTxReceipt(txHash, options) {
1375
+ // Check the tx pool status first. If the tx is known to the pool (pending or mined), we'll use that
1376
+ // as a fallback if we don't find a mined tx effect in the archiver.
1377
+ const txPoolStatus = await this.p2pClient.getTxStatus(txHash);
1378
+ const isKnownToPool = txPoolStatus === 'pending' || txPoolStatus === 'mined';
1379
+ // Then get the raw tx effect from the archiver, which tracks every tx in a mined block.
1380
+ const indexed = await this.blockSource.getTxEffect(txHash);
1381
+ let receipt;
1382
+ if (indexed) {
1383
+ receipt = await this.#assembleMinedReceipt(indexed, options);
1384
+ } else if (isKnownToPool) {
1385
+ // If the tx is in the pool but not in the archiver, it's pending.
1386
+ // This handles race conditions between archiver and p2p, where the archiver
1387
+ // has pruned the block in which a tx was mined, but p2p has not caught up yet.
1388
+ let tx;
1389
+ if (options?.includePendingTx) {
1390
+ // The tx may have left the pool since we checked its status (mined or dropped); in that case we
1391
+ // leave `tx` unset and still return a pending receipt.
1392
+ const pendingTx = await this.p2pClient.getTxByHashFromPool(txHash);
1393
+ tx = pendingTx && !options.includeProof ? pendingTx.withoutProof() : pendingTx;
1394
+ }
1395
+ receipt = new PendingTxReceipt(txHash, tx);
1396
+ } else {
1397
+ // Otherwise, if we don't know the tx, we consider it dropped.
1398
+ receipt = new DroppedTxReceipt(txHash, 'Tx dropped by P2P node');
497
1399
  }
498
- const settledTxReceipt = await this.blockSource.getSettledTxReceipt(txHash);
499
- if (settledTxReceipt) {
500
- txReceipt = settledTxReceipt;
1400
+ this.debugLogStore.decorateReceiptWithLogs(txHash.toString(), receipt);
1401
+ return receipt;
1402
+ }
1403
+ /**
1404
+ * Assembles a {@link MinedTxReceipt} from a raw {@link IndexedTxEffect}, deriving the finalization status from the
1405
+ * cached L2 tips and the epoch from the block's slot number.
1406
+ */ async #assembleMinedReceipt(indexed, options) {
1407
+ const blockNumber = indexed.l2BlockNumber;
1408
+ const [tips, l1Constants] = await Promise.all([
1409
+ this.blockSource.getL2Tips(),
1410
+ this.blockSource.getL1Constants()
1411
+ ]);
1412
+ const status = this.#deriveMinedStatus(blockNumber, tips);
1413
+ const epochNumber = getEpochAtSlot(indexed.slotNumber, l1Constants);
1414
+ return new MinedTxReceipt(indexed.data.txHash, status, MinedTxReceipt.executionResultFromRevertCode(indexed.data.revertCode), indexed.data.transactionFee.toBigInt(), indexed.l2BlockHash, blockNumber, indexed.slotNumber, indexed.txIndexInBlock, epochNumber, options?.includeTxEffect ? indexed.data : undefined, /*debugLogs=*/ undefined);
1415
+ }
1416
+ #deriveMinedStatus(blockNumber, tips) {
1417
+ if (blockNumber <= tips.finalized.block.number) {
1418
+ return TxStatus.FINALIZED;
1419
+ } else if (blockNumber <= tips.proven.block.number) {
1420
+ return TxStatus.PROVEN;
1421
+ } else if (blockNumber <= tips.checkpointed.block.number) {
1422
+ return TxStatus.CHECKPOINTED;
1423
+ } else {
1424
+ return TxStatus.PROPOSED;
501
1425
  }
502
- return txReceipt;
503
1426
  }
504
1427
  getTxEffect(txHash) {
505
1428
  return this.blockSource.getTxEffect(txHash);
@@ -508,19 +1431,29 @@ import { NodeMetrics } from './node_metrics.js';
508
1431
  * Method to stop the aztec node.
509
1432
  */ async stop() {
510
1433
  this.log.info(`Stopping Aztec Node`);
511
- await this.txQueue.end();
512
- await tryStop(this.validatorsSentinel);
513
- await tryStop(this.epochPruneWatcher);
1434
+ await this.stopStartedWatchers();
514
1435
  await tryStop(this.slasherClient);
515
- await tryStop(this.proofVerifier);
1436
+ await Promise.all([
1437
+ tryStop(this.peerProofVerifier),
1438
+ tryStop(this.rpcProofVerifier)
1439
+ ]);
516
1440
  await tryStop(this.sequencer);
1441
+ await tryStop(this.automineSequencer);
1442
+ await tryStop(this.proverNode);
517
1443
  await tryStop(this.p2pClient);
518
1444
  await tryStop(this.worldStateSynchronizer);
519
1445
  await tryStop(this.blockSource);
1446
+ await tryStop(this.blobClient);
520
1447
  await tryStop(this.telemetry);
521
1448
  this.log.info(`Stopped Aztec Node`);
522
1449
  }
523
1450
  /**
1451
+ * Returns the blob client used by this node.
1452
+ * @internal - Exposed for testing purposes only.
1453
+ */ getBlobClient() {
1454
+ return this.blobClient;
1455
+ }
1456
+ /**
524
1457
  * Method to retrieve pending txs.
525
1458
  * @param limit - The number of items to returns
526
1459
  * @param after - The last known pending tx. Used for pagination
@@ -545,101 +1478,83 @@ import { NodeMetrics } from './node_metrics.js';
545
1478
  */ async getTxsByHash(txHashes) {
546
1479
  return compactArray(await Promise.all(txHashes.map((txHash)=>this.getTxByHash(txHash))));
547
1480
  }
548
- /**
549
- * Find the indexes of the given leaves in the given tree along with a block metadata pointing to the block in which
550
- * the leaves were inserted.
551
- * @param blockNumber - The block number at which to get the data or 'latest' for latest data.
552
- * @param treeId - The tree to search in.
553
- * @param leafValues - The values to search for.
554
- * @returns The indices of leaves and the block metadata of a block in which the leaves were inserted.
555
- */ async findLeavesIndexes(blockNumber, treeId, leafValues) {
556
- const committedDb = await this.#getWorldState(blockNumber);
1481
+ async findLeavesIndexes(referenceBlock, treeId, leafValues) {
1482
+ const committedDb = await this.getWorldState(referenceBlock);
557
1483
  const maybeIndices = await committedDb.findLeafIndices(treeId, leafValues.map((x)=>x.toBuffer()));
558
- // We filter out undefined values
559
- const indices = maybeIndices.filter((x)=>x !== undefined);
560
- // Now we find the block numbers for the indices
561
- const blockNumbers = await committedDb.getBlockNumbersForLeafIndices(treeId, indices);
562
- // If any of the block numbers are undefined, we throw an error.
563
- for(let i = 0; i < indices.length; i++){
564
- if (blockNumbers[i] === undefined) {
565
- throw new Error(`Block number is undefined for leaf index ${indices[i]} in tree ${MerkleTreeId[treeId]}`);
1484
+ // Filter out undefined values to query block numbers only for found leaves
1485
+ const definedIndices = maybeIndices.filter((x)=>x !== undefined);
1486
+ // Now we find the block numbers for the defined indices
1487
+ const blockNumbers = await committedDb.getBlockNumbersForLeafIndices(treeId, definedIndices);
1488
+ // Build a map from leaf index to block number
1489
+ const indexToBlockNumber = new Map();
1490
+ for(let i = 0; i < definedIndices.length; i++){
1491
+ const blockNumber = blockNumbers[i];
1492
+ if (blockNumber === undefined) {
1493
+ throw new Error(`Block number is undefined for leaf index ${definedIndices[i]} in tree ${MerkleTreeId[treeId]}`);
566
1494
  }
1495
+ indexToBlockNumber.set(definedIndices[i], blockNumber);
567
1496
  }
568
1497
  // Get unique block numbers in order to optimize num calls to getLeafValue function.
569
1498
  const uniqueBlockNumbers = [
570
- ...new Set(blockNumbers.filter((x)=>x !== undefined))
1499
+ ...new Set(indexToBlockNumber.values())
571
1500
  ];
572
- // Now we obtain the block hashes from the archive tree by calling await `committedDb.getLeafValue(treeId, index)`
573
- // (note that block number corresponds to the leaf index in the archive tree).
1501
+ // Now we obtain the block hashes from the archive tree (block number = leaf index in archive tree).
574
1502
  const blockHashes = await Promise.all(uniqueBlockNumbers.map((blockNumber)=>{
575
- return committedDb.getLeafValue(MerkleTreeId.ARCHIVE, blockNumber);
1503
+ return committedDb.getLeafValue(MerkleTreeId.ARCHIVE, BigInt(blockNumber));
576
1504
  }));
577
- // If any of the block hashes are undefined, we throw an error.
1505
+ // Build a map from block number to block hash
1506
+ const blockNumberToHash = new Map();
578
1507
  for(let i = 0; i < uniqueBlockNumbers.length; i++){
579
- if (blockHashes[i] === undefined) {
1508
+ const blockHash = blockHashes[i];
1509
+ if (blockHash === undefined) {
580
1510
  throw new Error(`Block hash is undefined for block number ${uniqueBlockNumbers[i]}`);
581
1511
  }
1512
+ blockNumberToHash.set(uniqueBlockNumbers[i], blockHash);
582
1513
  }
583
- // Create InBlock objects by combining indices, blockNumbers and blockHashes and return them.
584
- return maybeIndices.map((index, i)=>{
1514
+ // Create DataInBlock objects by combining indices, blockNumbers and blockHashes and return them.
1515
+ return maybeIndices.map((index)=>{
585
1516
  if (index === undefined) {
586
1517
  return undefined;
587
1518
  }
588
- const blockNumber = blockNumbers[i];
1519
+ const blockNumber = indexToBlockNumber.get(index);
589
1520
  if (blockNumber === undefined) {
590
- return undefined;
1521
+ throw new Error(`Block number not found for leaf index ${index} in tree ${MerkleTreeId[treeId]}`);
591
1522
  }
592
- const blockHashIndex = uniqueBlockNumbers.indexOf(blockNumber);
593
- const blockHash = blockHashes[blockHashIndex];
594
- if (!blockHash) {
595
- return undefined;
1523
+ const l2BlockHash = blockNumberToHash.get(blockNumber);
1524
+ if (l2BlockHash === undefined) {
1525
+ throw new Error(`Block hash not found for block number ${blockNumber}`);
596
1526
  }
597
1527
  return {
598
- l2BlockNumber: Number(blockNumber),
599
- l2BlockHash: L2BlockHash.fromField(blockHash),
1528
+ l2BlockNumber: blockNumber,
1529
+ l2BlockHash,
600
1530
  data: index
601
1531
  };
602
1532
  });
603
1533
  }
604
- /**
605
- * Returns a sibling path for the given index in the nullifier tree.
606
- * @param blockNumber - The block number at which to get the data.
607
- * @param leafIndex - The index of the leaf for which the sibling path is required.
608
- * @returns The sibling path for the leaf index.
609
- */ async getNullifierSiblingPath(blockNumber, leafIndex) {
610
- const committedDb = await this.#getWorldState(blockNumber);
611
- return committedDb.getSiblingPath(MerkleTreeId.NULLIFIER_TREE, leafIndex);
612
- }
613
- /**
614
- * Returns a sibling path for the given index in the data tree.
615
- * @param blockNumber - The block number at which to get the data.
616
- * @param leafIndex - The index of the leaf for which the sibling path is required.
617
- * @returns The sibling path for the leaf index.
618
- */ async getNoteHashSiblingPath(blockNumber, leafIndex) {
619
- const committedDb = await this.#getWorldState(blockNumber);
620
- return committedDb.getSiblingPath(MerkleTreeId.NOTE_HASH_TREE, leafIndex);
621
- }
622
- async getArchiveMembershipWitness(blockNumber, archive) {
623
- const committedDb = await this.#getWorldState(blockNumber);
1534
+ async getBlockHashMembershipWitness(referenceBlock, blockHash) {
1535
+ // The Noir circuit checks the archive membership proof against `anchor_block_header.last_archive.root`,
1536
+ // which is the archive tree root BEFORE the anchor block was added (i.e. the state after block N-1).
1537
+ // So we need the world state at block N-1, not block N, to produce a sibling path matching that root.
1538
+ const referenceBlockNumber = await this.resolveBlockNumber(referenceBlock);
1539
+ if (referenceBlockNumber === BlockNumber.ZERO) {
1540
+ // Block 0 (the initial block) has an empty archive, so no membership witness can exist.
1541
+ return undefined;
1542
+ }
1543
+ const committedDb = await this.getWorldState(BlockNumber(referenceBlockNumber - 1));
624
1544
  const [pathAndIndex] = await committedDb.findSiblingPaths(MerkleTreeId.ARCHIVE, [
625
- archive
1545
+ blockHash
626
1546
  ]);
627
1547
  return pathAndIndex === undefined ? undefined : MembershipWitness.fromSiblingPath(pathAndIndex.index, pathAndIndex.path);
628
1548
  }
629
- async getNoteHashMembershipWitness(blockNumber, noteHash) {
630
- const committedDb = await this.#getWorldState(blockNumber);
1549
+ async getNoteHashMembershipWitness(referenceBlock, noteHash) {
1550
+ const committedDb = await this.getWorldState(referenceBlock);
631
1551
  const [pathAndIndex] = await committedDb.findSiblingPaths(MerkleTreeId.NOTE_HASH_TREE, [
632
1552
  noteHash
633
1553
  ]);
634
1554
  return pathAndIndex === undefined ? undefined : MembershipWitness.fromSiblingPath(pathAndIndex.index, pathAndIndex.path);
635
1555
  }
636
- /**
637
- * Returns the index and a sibling path for a leaf in the committed l1 to l2 data tree.
638
- * @param blockNumber - The block number at which to get the data.
639
- * @param l1ToL2Message - The l1ToL2Message to get the index / sibling path for.
640
- * @returns A tuple of the index and the sibling path of the L1ToL2Message (undefined if not found).
641
- */ async getL1ToL2MessageMembershipWitness(blockNumber, l1ToL2Message) {
642
- const db = await this.#getWorldState(blockNumber);
1556
+ async getL1ToL2MessageMembershipWitness(referenceBlock, l1ToL2Message) {
1557
+ const db = await this.getWorldState(referenceBlock);
643
1558
  const [witness] = await db.findSiblingPaths(MerkleTreeId.L1_TO_L2_MESSAGE_TREE, [
644
1559
  l1ToL2Message
645
1560
  ]);
@@ -652,51 +1567,33 @@ import { NodeMetrics } from './node_metrics.js';
652
1567
  witness.path
653
1568
  ];
654
1569
  }
655
- async getL1ToL2MessageBlock(l1ToL2Message) {
1570
+ async getL1ToL2MessageCheckpoint(l1ToL2Message) {
656
1571
  const messageIndex = await this.l1ToL2MessageSource.getL1ToL2MessageIndex(l1ToL2Message);
657
- return messageIndex ? InboxLeaf.l2BlockFromIndex(messageIndex) : undefined;
1572
+ return messageIndex !== undefined ? InboxLeaf.checkpointNumberFromIndex(messageIndex) : undefined;
658
1573
  }
659
1574
  /**
660
- * Returns whether an L1 to L2 message is synced by archiver and if it's ready to be included in a block.
661
- * @param l1ToL2Message - The L1 to L2 message to check.
662
- * @returns Whether the message is synced and ready to be included in a block.
663
- */ async isL1ToL2MessageSynced(l1ToL2Message) {
664
- const messageIndex = await this.l1ToL2MessageSource.getL1ToL2MessageIndex(l1ToL2Message);
665
- return messageIndex !== undefined;
666
- }
667
- /**
668
- * Returns all the L2 to L1 messages in a block.
669
- * @param blockNumber - The block number at which to get the data.
670
- * @returns The L2 to L1 messages (undefined if the block number is not found).
671
- */ async getL2ToL1Messages(blockNumber) {
672
- const block = await this.blockSource.getBlock(blockNumber === 'latest' ? await this.getBlockNumber() : blockNumber);
673
- return block?.body.txEffects.map((txEffect)=>txEffect.l2ToL1Msgs);
674
- }
675
- /**
676
- * Returns a sibling path for a leaf in the committed blocks tree.
677
- * @param blockNumber - The block number at which to get the data.
678
- * @param leafIndex - Index of the leaf in the tree.
679
- * @returns The sibling path.
680
- */ async getArchiveSiblingPath(blockNumber, leafIndex) {
681
- const committedDb = await this.#getWorldState(blockNumber);
682
- return committedDb.getSiblingPath(MerkleTreeId.ARCHIVE, leafIndex);
1575
+ * Returns all the L2 to L1 messages in an epoch.
1576
+ *
1577
+ * @deprecated Use {@link getL2ToL1MembershipWitness} to get an L2-to-L1 message witness directly.
1578
+ *
1579
+ * @param epoch - The epoch at which to get the data.
1580
+ * @returns The L2 to L1 messages (empty array if the epoch is not found).
1581
+ */ async getL2ToL1Messages(epoch) {
1582
+ const blocks = await this.blockSource.getBlocks({
1583
+ epoch,
1584
+ onlyCheckpointed: true
1585
+ });
1586
+ const blocksInCheckpoints = chunkBy(blocks, (block)=>block.header.globalVariables.slotNumber);
1587
+ return blocksInCheckpoints.map((slotBlocks)=>slotBlocks.map((block)=>block.body.txEffects.map((txEffect)=>txEffect.l2ToL1Msgs)));
683
1588
  }
684
1589
  /**
685
- * Returns a sibling path for a leaf in the committed public data tree.
686
- * @param blockNumber - The block number at which to get the data.
687
- * @param leafIndex - Index of the leaf in the tree.
688
- * @returns The sibling path.
689
- */ async getPublicDataSiblingPath(blockNumber, leafIndex) {
690
- const committedDb = await this.#getWorldState(blockNumber);
691
- return committedDb.getSiblingPath(MerkleTreeId.PUBLIC_DATA_TREE, leafIndex);
1590
+ * Returns the L2-to-L1 membership witness for a message in `txHash`. Passthrough to the
1591
+ * archiver's locally-cached resolver — see {@link Archiver.getL2ToL1MembershipWitness}.
1592
+ */ getL2ToL1MembershipWitness(txHash, message, messageIndexInTx) {
1593
+ return this.blockSource.getL2ToL1MembershipWitness(txHash, message, messageIndexInTx);
692
1594
  }
693
- /**
694
- * Returns a nullifier membership witness for a given nullifier at a given block.
695
- * @param blockNumber - The block number at which to get the index.
696
- * @param nullifier - Nullifier we try to find witness for.
697
- * @returns The nullifier membership witness (if found).
698
- */ async getNullifierMembershipWitness(blockNumber, nullifier) {
699
- const db = await this.#getWorldState(blockNumber);
1595
+ async getNullifierMembershipWitness(referenceBlock, nullifier) {
1596
+ const db = await this.getWorldState(referenceBlock);
700
1597
  const [witness] = await db.findSiblingPaths(MerkleTreeId.NULLIFIER_TREE, [
701
1598
  nullifier.toBuffer()
702
1599
  ]);
@@ -710,35 +1607,22 @@ import { NodeMetrics } from './node_metrics.js';
710
1607
  }
711
1608
  return new NullifierMembershipWitness(index, leafPreimage, path);
712
1609
  }
713
- /**
714
- * Returns a low nullifier membership witness for a given nullifier at a given block.
715
- * @param blockNumber - The block number at which to get the index.
716
- * @param nullifier - Nullifier we try to find the low nullifier witness for.
717
- * @returns The low nullifier membership witness (if found).
718
- * @remarks Low nullifier witness can be used to perform a nullifier non-inclusion proof by leveraging the "linked
719
- * list structure" of leaves and proving that a lower nullifier is pointing to a bigger next value than the nullifier
720
- * we are trying to prove non-inclusion for.
721
- *
722
- * Note: This function returns the membership witness of the nullifier itself and not the low nullifier when
723
- * the nullifier already exists in the tree. This is because the `getPreviousValueIndex` function returns the
724
- * index of the nullifier itself when it already exists in the tree.
725
- * TODO: This is a confusing behavior and we should eventually address that.
726
- */ async getLowNullifierMembershipWitness(blockNumber, nullifier) {
727
- const committedDb = await this.#getWorldState(blockNumber);
1610
+ async getLowNullifierMembershipWitness(referenceBlock, nullifier) {
1611
+ const committedDb = await this.getWorldState(referenceBlock);
728
1612
  const findResult = await committedDb.getPreviousValueIndex(MerkleTreeId.NULLIFIER_TREE, nullifier.toBigInt());
729
1613
  if (!findResult) {
730
1614
  return undefined;
731
1615
  }
732
1616
  const { index, alreadyPresent } = findResult;
733
1617
  if (alreadyPresent) {
734
- this.log.warn(`Nullifier ${nullifier.toBigInt()} already exists in the tree`);
1618
+ throw new Error(`Cannot prove nullifier non-inclusion: nullifier ${nullifier.toBigInt()} already exists in the tree`);
735
1619
  }
736
1620
  const preimageData = await committedDb.getLeafPreimage(MerkleTreeId.NULLIFIER_TREE, index);
737
1621
  const siblingPath = await committedDb.getSiblingPath(MerkleTreeId.NULLIFIER_TREE, BigInt(index));
738
1622
  return new NullifierMembershipWitness(BigInt(index), preimageData, siblingPath);
739
1623
  }
740
- async getPublicDataWitness(blockNumber, leafSlot) {
741
- const committedDb = await this.#getWorldState(blockNumber);
1624
+ async getPublicDataWitness(referenceBlock, leafSlot) {
1625
+ const committedDb = await this.getWorldState(referenceBlock);
742
1626
  const lowLeafResult = await committedDb.getPreviousValueIndex(MerkleTreeId.PUBLIC_DATA_TREE, leafSlot.toBigInt());
743
1627
  if (!lowLeafResult) {
744
1628
  return undefined;
@@ -748,18 +1632,8 @@ import { NodeMetrics } from './node_metrics.js';
748
1632
  return new PublicDataWitness(lowLeafResult.index, preimage, path);
749
1633
  }
750
1634
  }
751
- /**
752
- * Gets the storage value at the given contract storage slot.
753
- *
754
- * @remarks The storage slot here refers to the slot as it is defined in Noir not the index in the merkle tree.
755
- * Aztec's version of `eth_getStorageAt`.
756
- *
757
- * @param contract - Address of the contract to query.
758
- * @param slot - Slot to query.
759
- * @param blockNumber - The block number at which to get the data or 'latest'.
760
- * @returns Storage value at the given contract slot.
761
- */ async getPublicStorageAt(blockNumber, contract, slot) {
762
- const committedDb = await this.#getWorldState(blockNumber);
1635
+ async getPublicStorageAt(referenceBlock, contract, slot) {
1636
+ const committedDb = await this.getWorldState(referenceBlock);
763
1637
  const leafSlot = await computePublicDataTreeLeafSlot(contract, slot);
764
1638
  const lowLeafResult = await committedDb.getPreviousValueIndex(MerkleTreeId.PUBLIC_DATA_TREE, leafSlot.toBigInt());
765
1639
  if (!lowLeafResult || !lowLeafResult.alreadyPresent) {
@@ -769,57 +1643,78 @@ import { NodeMetrics } from './node_metrics.js';
769
1643
  return preimage.leaf.value;
770
1644
  }
771
1645
  /**
772
- * Returns the currently committed block header, or the initial header if no blocks have been produced.
773
- * @returns The current committed block header.
774
- */ async getBlockHeader(blockNumber = 'latest') {
775
- return blockNumber === 0 || blockNumber === 'latest' && await this.blockSource.getBlockNumber() === 0 ? this.worldStateSynchronizer.getCommitted().getInitialHeader() : this.blockSource.getBlockHeader(blockNumber);
776
- }
777
- /**
778
- * Get a block header specified by its hash.
779
- * @param blockHash - The block hash being requested.
780
- * @returns The requested block header.
781
- */ async getBlockHeaderByHash(blockHash) {
782
- return await this.blockSource.getBlockHeaderByHash(blockHash);
783
- }
784
- /**
785
- * Get a block header specified by its archive root.
786
- * @param archive - The archive root being requested.
787
- * @returns The requested block header.
788
- */ async getBlockHeaderByArchive(archive) {
789
- return await this.blockSource.getBlockHeaderByArchive(archive);
790
- }
791
- /**
792
1646
  * Simulates the public part of a transaction with the current state.
793
1647
  * @param tx - The transaction to simulate.
794
- **/ async simulatePublicCalls(tx, skipFeeEnforcement = false) {
795
- // Check total gas limit for simulation
796
- const gasSettings = tx.data.constants.txContext.gasSettings;
797
- const txGasLimit = gasSettings.gasLimits.l2Gas;
798
- const teardownGasLimit = gasSettings.teardownGasLimits.l2Gas;
799
- if (txGasLimit + teardownGasLimit > this.config.rpcSimulatePublicMaxGasLimit) {
800
- throw new BadRequestError(`Transaction total gas limit ${txGasLimit + teardownGasLimit} (${txGasLimit} + ${teardownGasLimit}) exceeds maximum gas limit ${this.config.rpcSimulatePublicMaxGasLimit} for simulation`);
801
- }
802
- const txHash = tx.getTxHash();
803
- const blockNumber = await this.blockSource.getBlockNumber() + 1;
804
- // If sequencer is not initialized, we just set these values to zero for simulation.
805
- const coinbase = EthAddress.ZERO;
806
- const feeRecipient = AztecAddress.ZERO;
807
- const newGlobalVariables = await this.globalVariableBuilder.buildGlobalVariables(blockNumber, coinbase, feeRecipient);
808
- const publicProcessorFactory = new PublicProcessorFactory(this.contractDataSource, new DateProvider(), this.telemetry);
809
- this.log.verbose(`Simulating public calls for tx ${txHash}`, {
810
- globalVariables: newGlobalVariables.toInspect(),
811
- txHash,
812
- blockNumber
813
- });
814
- const merkleTreeFork = await this.worldStateSynchronizer.fork();
1648
+ * @param skipFeeEnforcement - If true, fee enforcement is skipped.
1649
+ * @param overrides - Optional pre-simulation overrides applied to the ephemeral fork and contract DB.
1650
+ **/ async simulatePublicCalls(tx, skipFeeEnforcement = false, overrides) {
1651
+ const env = {
1652
+ stack: [],
1653
+ error: void 0,
1654
+ hasError: false
1655
+ };
815
1656
  try {
816
- const processor = publicProcessorFactory.create(merkleTreeFork, newGlobalVariables, {
1657
+ // Check total gas limit for simulation
1658
+ const gasSettings = tx.data.constants.txContext.gasSettings;
1659
+ const txGasLimit = gasSettings.gasLimits.l2Gas;
1660
+ const teardownGasLimit = gasSettings.teardownGasLimits.l2Gas;
1661
+ if (txGasLimit + teardownGasLimit > this.config.rpcSimulatePublicMaxGasLimit) {
1662
+ throw new BadRequestError(`Transaction total gas limit ${txGasLimit + teardownGasLimit} (${txGasLimit} + ${teardownGasLimit}) exceeds maximum gas limit ${this.config.rpcSimulatePublicMaxGasLimit} for simulation`);
1663
+ }
1664
+ const txHash = tx.getTxHash();
1665
+ const l2Tips = await this.blockSource.getL2Tips();
1666
+ const latestBlockNumber = l2Tips.proposed.number;
1667
+ const blockNumber = BlockNumber.add(latestBlockNumber, 1);
1668
+ // If sequencer is not initialized, we just set these values to zero for simulation.
1669
+ const coinbase = EthAddress.ZERO;
1670
+ const feeRecipient = AztecAddress.ZERO;
1671
+ const newGlobalVariables = await this.globalVariableBuilder.buildGlobalVariables(blockNumber, coinbase, feeRecipient);
1672
+ const publicProcessorFactory = new PublicProcessorFactory(this.contractDataSource, new DateProvider(), this.telemetry, this.log.getBindings());
1673
+ this.log.verbose(`Simulating public calls for tx ${txHash}`, {
1674
+ globalVariables: newGlobalVariables.toInspect(),
1675
+ txHash,
1676
+ blockNumber
1677
+ });
1678
+ // Ensure world-state has caught up with the latest block we loaded from the archiver
1679
+ await this.worldStateSynchronizer.syncImmediate(latestBlockNumber);
1680
+ // If we detect the next block would start a new checkpoint, then insert L1-to-L2 messages into
1681
+ // the world state tree so simulation can take them into account. We detect if the next block would
1682
+ // start a new checkpoint by checking if the proposed checkpoint's block number matches the latest block number,
1683
+ // which means the next block would be the first block of the next checkpoint.
1684
+ const targetCheckpoint = CheckpointNumber((l2Tips.proposedCheckpoint.checkpoint.number ?? CheckpointNumber.ZERO) + 1);
1685
+ const nextCheckpointMessages = l2Tips.proposedCheckpoint.block.number === l2Tips.proposed.number ? await this.l1ToL2MessageSource.getL1ToL2Messages(targetCheckpoint).catch((err)=>{
1686
+ if (isErrorClass(err, L1ToL2MessagesNotReadyError)) {
1687
+ this.log.warn(`L1-to-L2 messages for checkpoint ${targetCheckpoint} are not ready yet (simulating without them)`);
1688
+ } else {
1689
+ this.log.error(`Failed to get L1-to-L2 messages for checkpoint ${targetCheckpoint} (simulating without them)`, err);
1690
+ }
1691
+ return undefined;
1692
+ }) : undefined;
1693
+ const merkleTreeFork = _ts_add_disposable_resource(env, await this.worldStateSynchronizer.fork(latestBlockNumber), true);
1694
+ if (nextCheckpointMessages !== undefined) {
1695
+ this.log.debug(`Appending ${nextCheckpointMessages.length} L1-to-L2 messages to the world state tree for the next checkpoint`, {
1696
+ checkpointNumber: l2Tips.proposedCheckpoint.checkpoint.number + 1
1697
+ });
1698
+ await appendL1ToL2MessagesToTree(merkleTreeFork, nextCheckpointMessages);
1699
+ }
1700
+ await applyPublicDataOverrides(merkleTreeFork, overrides?.publicStorage);
1701
+ const config = PublicSimulatorConfig.from({
817
1702
  skipFeeEnforcement,
818
- clientInitiatedSimulation: true,
819
- maxDebugLogMemoryReads: this.config.rpcSimulatePublicMaxDebugLogMemoryReads
1703
+ collectDebugLogs: true,
1704
+ collectHints: false,
1705
+ collectCallMetadata: true,
1706
+ collectStatistics: false,
1707
+ collectionLimits: CollectionLimitsConfig.from({
1708
+ maxDebugLogMemoryReads: this.config.rpcSimulatePublicMaxDebugLogMemoryReads
1709
+ })
820
1710
  });
1711
+ const contractsDB = new PublicContractsDB(this.contractDataSource, this.log.getBindings());
1712
+ if (overrides?.contracts) {
1713
+ contractsDB.addContracts(Object.values(overrides.contracts).map(({ instance })=>instance));
1714
+ }
1715
+ const processor = publicProcessorFactory.create(merkleTreeFork, newGlobalVariables, config, contractsDB);
821
1716
  // REFACTOR: Consider merging ProcessReturnValues into ProcessedTx
822
- const [processedTxs, failedTxs, _usedTxs, returns] = await processor.process([
1717
+ const [processedTxs, failedTxs, _usedTxs, returns, debugLogs] = await processor.process([
823
1718
  tx
824
1719
  ]);
825
1720
  // REFACTOR: Consider returning the error rather than throwing
@@ -830,27 +1725,38 @@ import { NodeMetrics } from './node_metrics.js';
830
1725
  throw failedTxs[0].error;
831
1726
  }
832
1727
  const [processedTx] = processedTxs;
833
- return new PublicSimulationOutput(processedTx.revertReason, processedTx.globalVariables, processedTx.txEffect, returns, processedTx.gasUsed);
1728
+ return new PublicSimulationOutput(processedTx.revertReason, processedTx.globalVariables, processedTx.txEffect, returns, processedTx.gasUsed, debugLogs);
1729
+ } catch (e) {
1730
+ env.error = e;
1731
+ env.hasError = true;
834
1732
  } finally{
835
- await merkleTreeFork.close();
1733
+ const result = _ts_dispose_resources(env);
1734
+ if (result) await result;
836
1735
  }
837
1736
  }
838
1737
  async isValidTx(tx, { isSimulation, skipFeeEnforcement } = {}) {
839
1738
  const db = this.worldStateSynchronizer.getCommitted();
840
- const verifier = isSimulation ? undefined : this.proofVerifier;
841
- // We accept transactions if they are not expired by the next slot (checked based on the IncludeByTimestamp field)
1739
+ const verifier = isSimulation ? undefined : this.rpcProofVerifier;
1740
+ // We accept transactions if they are not expired by the next slot (checked based on the ExpirationTimestamp field)
842
1741
  const { ts: nextSlotTimestamp } = this.epochCache.getEpochAndSlotInNextL1Slot();
843
- const blockNumber = await this.blockSource.getBlockNumber() + 1;
844
- const validator = createValidatorForAcceptingTxs(db, this.contractDataSource, verifier, {
1742
+ const blockNumber = BlockNumber(await this.blockSource.getBlockNumber() + 1);
1743
+ const l1Constants = await this.blockSource.getL1Constants();
1744
+ const validator = createTxValidatorForAcceptingTxsOverRPC(db, this.contractDataSource, verifier, {
845
1745
  timestamp: nextSlotTimestamp,
846
1746
  blockNumber,
847
1747
  l1ChainId: this.l1ChainId,
848
1748
  rollupVersion: this.version,
849
- setupAllowList: this.config.txPublicSetupAllowList ?? await getDefaultAllowedSetupFunctions(),
850
- gasFees: await this.getCurrentBaseFees(),
1749
+ setupAllowList: [
1750
+ ...await getDefaultAllowedSetupFunctions(),
1751
+ ...this.config.txPublicSetupAllowListExtend ?? []
1752
+ ],
1753
+ gasFees: await this.getCurrentMinFees(),
851
1754
  skipFeeEnforcement,
852
- txsPermitted: !this.config.disableTransactions
853
- });
1755
+ txsPermitted: !this.config.disableTransactions,
1756
+ rollupManaLimit: l1Constants.rollupManaLimit,
1757
+ maxBlockL2Gas: this.config.validateMaxL2BlockGas,
1758
+ maxBlockDAGas: this.config.validateMaxDABlockGas
1759
+ }, this.log.getBindings());
854
1760
  return await validator.validateTx(tx);
855
1761
  }
856
1762
  getConfig() {
@@ -863,7 +1769,20 @@ import { NodeMetrics } from './node_metrics.js';
863
1769
  ...this.config,
864
1770
  ...config
865
1771
  };
866
- this.sequencer?.updateConfig(config);
1772
+ // If the sequencer is currently paused via pauseSequencer(), record the caller's desired
1773
+ // minTxsPerBlock as the restore value (so resumeSequencer applies it) and keep the freeze
1774
+ // (MAX_SAFE_INTEGER) applied to the underlying sequencer. Without this guard, forwarding
1775
+ // the new minTxsPerBlock to the sequencer would silently unpause block production while
1776
+ // pauseSequencer() still considers it paused.
1777
+ const sequencerUpdate = {
1778
+ ...config
1779
+ };
1780
+ if (this.sequencerPausedMinTxsPerBlock !== undefined && sequencerUpdate.minTxsPerBlock !== undefined) {
1781
+ this.sequencerPausedMinTxsPerBlock = sequencerUpdate.minTxsPerBlock;
1782
+ delete sequencerUpdate.minTxsPerBlock;
1783
+ }
1784
+ this.sequencer?.updateConfig(sequencerUpdate);
1785
+ this.automineSequencer?.updateConfig(sequencerUpdate);
867
1786
  this.slasherClient?.updateConfig(config);
868
1787
  this.validatorsSentinel?.updateConfig(config);
869
1788
  await this.p2pClient.updateP2PConfig(config);
@@ -872,7 +1791,18 @@ import { NodeMetrics } from './node_metrics.js';
872
1791
  archiver.updateConfig(config);
873
1792
  }
874
1793
  if (newConfig.realProofs !== this.config.realProofs) {
875
- this.proofVerifier = config.realProofs ? await BBCircuitVerifier.new(newConfig) : new TestCircuitVerifier();
1794
+ await Promise.all([
1795
+ tryStop(this.peerProofVerifier),
1796
+ tryStop(this.rpcProofVerifier)
1797
+ ]);
1798
+ if (newConfig.realProofs) {
1799
+ this.peerProofVerifier = await BatchChonkVerifier.new(newConfig, newConfig.bbChonkVerifyMaxBatch, 'peer');
1800
+ const rpcVerifier = await BBCircuitVerifier.new(newConfig);
1801
+ this.rpcProofVerifier = new QueuedIVCVerifier(rpcVerifier, newConfig.numConcurrentIVCVerifiers);
1802
+ } else {
1803
+ this.peerProofVerifier = new TestCircuitVerifier();
1804
+ this.rpcProofVerifier = new TestCircuitVerifier();
1805
+ }
876
1806
  }
877
1807
  this.config = newConfig;
878
1808
  }
@@ -881,7 +1811,7 @@ import { NodeMetrics } from './node_metrics.js';
881
1811
  classRegistry: ProtocolContractAddress.ContractClassRegistry,
882
1812
  feeJuice: ProtocolContractAddress.FeeJuice,
883
1813
  instanceRegistry: ProtocolContractAddress.ContractInstanceRegistry,
884
- multiCallEntrypoint: ProtocolContractAddress.MultiCallEntrypoint
1814
+ multiCallEntrypoint: STANDARD_MULTI_CALL_ENTRYPOINT_ADDRESS
885
1815
  });
886
1816
  }
887
1817
  registerContractFunctionSignatures(signatures) {
@@ -910,7 +1840,7 @@ import { NodeMetrics } from './node_metrics.js';
910
1840
  throw new Error(`Archiver initial sync not complete. Cannot start snapshot.`);
911
1841
  }
912
1842
  // And it has an L2 block hash
913
- const l2BlockHash = await archiver.getL2Tips().then((tips)=>tips.latest.hash);
1843
+ const l2BlockHash = await archiver.getL2Tips().then((tips)=>tips.proposed.hash);
914
1844
  if (!l2BlockHash) {
915
1845
  this.metrics.recordSnapshotError();
916
1846
  throw new Error(`Archiver has no latest L2 block hash downloaded. Cannot start snapshot.`);
@@ -932,12 +1862,12 @@ import { NodeMetrics } from './node_metrics.js';
932
1862
  });
933
1863
  return Promise.resolve();
934
1864
  }
935
- async rollbackTo(targetBlock, force) {
1865
+ async rollbackTo(targetBlock, force, resumeSync = true) {
936
1866
  const archiver = this.blockSource;
937
1867
  if (!('rollbackTo' in archiver)) {
938
1868
  throw new Error('Archiver implementation does not support rollbacks.');
939
1869
  }
940
- const finalizedBlock = await archiver.getL2Tips().then((tips)=>tips.finalized.number);
1870
+ const finalizedBlock = await archiver.getL2Tips().then((tips)=>tips.finalized.block.number);
941
1871
  if (targetBlock < finalizedBlock) {
942
1872
  if (force) {
943
1873
  this.log.warn(`Clearing world state database to allow rolling back behind finalized block ${finalizedBlock}`);
@@ -960,9 +1890,13 @@ import { NodeMetrics } from './node_metrics.js';
960
1890
  this.log.error(`Error during rollback`, err);
961
1891
  throw err;
962
1892
  } finally{
963
- this.log.info(`Resuming world state and archiver sync.`);
964
- this.worldStateSynchronizer.resumeSync();
965
- archiver.resume();
1893
+ if (resumeSync) {
1894
+ this.log.info(`Resuming world state and archiver sync.`);
1895
+ this.worldStateSynchronizer.resumeSync();
1896
+ archiver.resume();
1897
+ } else {
1898
+ this.log.info(`Sync left paused after rollback (resumeSync=false).`);
1899
+ }
966
1900
  }
967
1901
  }
968
1902
  async pauseSync() {
@@ -976,58 +1910,220 @@ import { NodeMetrics } from './node_metrics.js';
976
1910
  this.blockSource.resume();
977
1911
  return Promise.resolve();
978
1912
  }
979
- getSlashPayloads() {
980
- if (!this.slasherClient) {
981
- throw new Error(`Slasher client not enabled`);
1913
+ pauseSequencer() {
1914
+ if (this.automineSequencer) {
1915
+ this.automineSequencer.pause();
1916
+ return Promise.resolve();
982
1917
  }
983
- return this.slasherClient.getSlashPayloads();
1918
+ if (this.sequencer) {
1919
+ if (this.sequencerPausedMinTxsPerBlock === undefined) {
1920
+ this.sequencerPausedMinTxsPerBlock = this.sequencer.getSequencer().getConfig().minTxsPerBlock ?? 0;
1921
+ this.sequencer.updateConfig({
1922
+ minTxsPerBlock: Number.MAX_SAFE_INTEGER
1923
+ });
1924
+ this.log.info(`Sequencer paused (minTxsPerBlock set to MAX_SAFE_INTEGER)`, {
1925
+ previousMinTxsPerBlock: this.sequencerPausedMinTxsPerBlock
1926
+ });
1927
+ }
1928
+ return Promise.resolve();
1929
+ }
1930
+ throw new BadRequestError('Cannot pause sequencer: no sequencer is running');
1931
+ }
1932
+ resumeSequencer() {
1933
+ if (this.automineSequencer) {
1934
+ this.automineSequencer.resume();
1935
+ return Promise.resolve();
1936
+ }
1937
+ if (this.sequencer) {
1938
+ if (this.sequencerPausedMinTxsPerBlock !== undefined) {
1939
+ const restored = this.sequencerPausedMinTxsPerBlock;
1940
+ this.sequencerPausedMinTxsPerBlock = undefined;
1941
+ this.sequencer.updateConfig({
1942
+ minTxsPerBlock: restored
1943
+ });
1944
+ this.log.info(`Sequencer resumed (minTxsPerBlock restored)`, {
1945
+ minTxsPerBlock: restored
1946
+ });
1947
+ }
1948
+ return Promise.resolve();
1949
+ }
1950
+ throw new BadRequestError('Cannot resume sequencer: no sequencer is running');
984
1951
  }
985
1952
  getSlashOffenses(round) {
986
1953
  if (!this.slasherClient) {
987
1954
  throw new Error(`Slasher client not enabled`);
988
1955
  }
989
1956
  if (round === 'all') {
990
- return this.slasherClient.getPendingOffenses();
1957
+ return this.slasherClient.getOffenses();
991
1958
  } else {
992
1959
  return this.slasherClient.gatherOffensesForRound(round === 'current' ? undefined : BigInt(round));
993
1960
  }
994
1961
  }
1962
+ async reloadKeystore() {
1963
+ if (!this.config.keyStoreDirectory?.length) {
1964
+ throw new BadRequestError('Cannot reload keystore: node is not using a file-based keystore. ' + 'Set KEY_STORE_DIRECTORY to use file-based keystores.');
1965
+ }
1966
+ if (!this.validatorClient) {
1967
+ throw new BadRequestError('Cannot reload keystore: validator is not enabled.');
1968
+ }
1969
+ this.log.info('Reloading keystore from disk');
1970
+ // Re-read and validate keystore files
1971
+ const keyStores = loadKeystores(this.config.keyStoreDirectory);
1972
+ const newManager = new KeystoreManager(mergeKeystores(keyStores));
1973
+ await newManager.validateSigners();
1974
+ ValidatorClient.validateKeyStoreConfiguration(newManager, this.log);
1975
+ // Validate that every validator's publisher keys overlap with the L1 signers
1976
+ // that were initialized at startup. Publishers cannot be hot-reloaded, so a
1977
+ // validator with a publisher key that doesn't match any existing L1 signer
1978
+ // would silently fail on every proposer slot.
1979
+ if (this.keyStoreManager && this.sequencer) {
1980
+ const oldAdapter = NodeKeystoreAdapter.fromKeyStoreManager(this.keyStoreManager);
1981
+ const availablePublishers = new Set(oldAdapter.getAttesterAddresses().flatMap((a)=>oldAdapter.getPublisherAddresses(a).map((p)=>p.toString().toLowerCase())));
1982
+ const newAdapter = NodeKeystoreAdapter.fromKeyStoreManager(newManager);
1983
+ for (const attester of newAdapter.getAttesterAddresses()){
1984
+ const pubs = newAdapter.getPublisherAddresses(attester);
1985
+ if (pubs.length > 0 && !pubs.some((p)=>availablePublishers.has(p.toString().toLowerCase()))) {
1986
+ throw new BadRequestError(`Cannot reload keystore: validator ${attester} has publisher keys ` + `[${pubs.map((p)=>p.toString()).join(', ')}] but none match the L1 signers initialized at startup ` + `[${[
1987
+ ...availablePublishers
1988
+ ].join(', ')}]. Publishers cannot be hot-reloaded — ` + `use an existing publisher key or restart the node.`);
1989
+ }
1990
+ }
1991
+ }
1992
+ // Build adapters for old and new keystores to compute diff
1993
+ const newAdapter = NodeKeystoreAdapter.fromKeyStoreManager(newManager);
1994
+ const newAddresses = newAdapter.getAttesterAddresses();
1995
+ const oldAddresses = this.keyStoreManager ? NodeKeystoreAdapter.fromKeyStoreManager(this.keyStoreManager).getAttesterAddresses() : [];
1996
+ const oldSet = new Set(oldAddresses.map((a)=>a.toString()));
1997
+ const newSet = new Set(newAddresses.map((a)=>a.toString()));
1998
+ const added = newAddresses.filter((a)=>!oldSet.has(a.toString()));
1999
+ const removed = oldAddresses.filter((a)=>!newSet.has(a.toString()));
2000
+ if (added.length > 0) {
2001
+ this.log.info(`Keystore reload: adding attester keys: ${added.map((a)=>a.toString()).join(', ')}`);
2002
+ }
2003
+ if (removed.length > 0) {
2004
+ this.log.info(`Keystore reload: removing attester keys: ${removed.map((a)=>a.toString()).join(', ')}`);
2005
+ }
2006
+ if (added.length === 0 && removed.length === 0) {
2007
+ this.log.info('Keystore reload: attester keys unchanged');
2008
+ }
2009
+ // Update the validator client (coinbase, feeRecipient, attester keys)
2010
+ this.validatorClient.reloadKeystore(newManager);
2011
+ // Update the publisher factory's keystore so newly-added validators
2012
+ // can be matched to existing publisher keys when proposing blocks.
2013
+ if (this.sequencer) {
2014
+ this.sequencer.updatePublisherNodeKeyStore(newAdapter);
2015
+ }
2016
+ // Update slasher's "don't-slash-self" list with new validator addresses
2017
+ if (this.slasherClient && !this.config.slashSelfAllowed) {
2018
+ const slashValidatorsNever = unique([
2019
+ ...this.config.slashValidatorsNever ?? [],
2020
+ ...newAddresses
2021
+ ].map((a)=>a.toString())).map(EthAddress.fromString);
2022
+ this.slasherClient.updateConfig({
2023
+ slashValidatorsNever
2024
+ });
2025
+ }
2026
+ this.keyStoreManager = newManager;
2027
+ this.log.info('Keystore reloaded: coinbase, feeRecipient, and attester keys updated');
2028
+ }
2029
+ async mineBlock() {
2030
+ if (this.automineSequencer) {
2031
+ await this.automineSequencer.buildEmptyBlock();
2032
+ return;
2033
+ }
2034
+ if (!this.sequencer) {
2035
+ throw new BadRequestError('Cannot mine block: no sequencer is running');
2036
+ }
2037
+ const currentBlockNumber = await this.getBlockNumber();
2038
+ // Use slot duration + 50% buffer as the timeout so this works on running networks too
2039
+ const { slotDuration } = await this.blockSource.getL1Constants();
2040
+ const timeoutSeconds = Math.ceil(slotDuration * 1.5);
2041
+ // Temporarily set minTxsPerBlock to 0 so the sequencer produces a block even with no txs
2042
+ const originalMinTxsPerBlock = this.sequencer.getSequencer().getConfig().minTxsPerBlock;
2043
+ this.sequencer.updateConfig({
2044
+ minTxsPerBlock: 0
2045
+ });
2046
+ try {
2047
+ // Trigger the sequencer to produce a block immediately
2048
+ void this.sequencer.trigger();
2049
+ // Wait for the new L2 block to appear
2050
+ await retryUntil(async ()=>{
2051
+ const newBlockNumber = await this.getBlockNumber();
2052
+ return newBlockNumber > currentBlockNumber ? true : undefined;
2053
+ }, 'mineBlock', timeoutSeconds, 0.1);
2054
+ } finally{
2055
+ this.sequencer.updateConfig({
2056
+ minTxsPerBlock: originalMinTxsPerBlock
2057
+ });
2058
+ }
2059
+ }
995
2060
  /**
996
2061
  * Returns an instance of MerkleTreeOperations having first ensured the world state is fully synched
997
- * @param blockNumber - The block number at which to get the data.
2062
+ * @param block - The block parameter (block number, block hash, or 'latest') at which to get the data.
998
2063
  * @returns An instance of a committed MerkleTreeOperations
999
- */ async #getWorldState(blockNumber) {
1000
- if (typeof blockNumber === 'number' && blockNumber < INITIAL_L2_BLOCK_NUM - 1) {
1001
- throw new Error('Invalid block number to get world state for: ' + blockNumber);
1002
- }
1003
- let blockSyncedTo = 0;
2064
+ */ async getWorldState(block) {
2065
+ const query = this.normalizeBlockParameter(block);
2066
+ // When the request anchors on a specific block hash, resolve it against the archiver up front and
2067
+ // drive the world-state sync to that exact block number and hash. Resolving against the archiver
2068
+ // first fails fast with a clear reorg error if the hash is unknown, and passing the hash to the
2069
+ // synchronizer makes the sync reorg-aware: it barriers until the archive-tree commit for that block
2070
+ // has landed and verifies it matches the requested fork, instead of syncing to bare latest height
2071
+ // and then racing the snapshot read below against an in-flight archive-tree write.
2072
+ const requestedHash = 'hash' in query ? query.hash : undefined;
2073
+ const anchorBlockNumber = requestedHash !== undefined ? await this.resolveBlockNumber(query) : undefined;
2074
+ let blockSyncedTo = BlockNumber.ZERO;
1004
2075
  try {
1005
2076
  // Attempt to sync the world state if necessary
1006
- blockSyncedTo = await this.#syncWorldState();
2077
+ blockSyncedTo = await this.#syncWorldState(anchorBlockNumber, requestedHash);
1007
2078
  } catch (err) {
1008
2079
  this.log.error(`Error getting world state: ${err}`);
1009
2080
  }
1010
- // using a snapshot could be less efficient than using the committed db
1011
- if (blockNumber === 'latest' /*|| blockNumber === blockSyncedTo*/ ) {
1012
- this.log.debug(`Using committed db for block ${blockNumber}, world state synced upto ${blockSyncedTo}`);
2081
+ if ('tag' in query && query.tag === 'proposed') {
2082
+ this.log.debug(`Using committed db for latest block, world state synced upto ${blockSyncedTo}`);
1013
2083
  return this.worldStateSynchronizer.getCommitted();
1014
- } else if (blockNumber <= blockSyncedTo) {
1015
- this.log.debug(`Using snapshot for block ${blockNumber}, world state synced upto ${blockSyncedTo}`);
1016
- return this.worldStateSynchronizer.getSnapshot(blockNumber);
1017
- } else {
1018
- throw new Error(`Block ${blockNumber} not yet synced`);
1019
2084
  }
2085
+ const blockNumber = anchorBlockNumber ?? await this.resolveBlockNumber(query);
2086
+ // Check it's within world state sync range
2087
+ if (blockNumber > blockSyncedTo) {
2088
+ throw new Error(`Queried block ${inspectBlockParameter(block)} not yet synced by the node (node is synced upto ${blockSyncedTo}).`);
2089
+ }
2090
+ this.log.debug(`Using snapshot for block ${blockNumber}, world state synced upto ${blockSyncedTo}`);
2091
+ const snapshot = this.worldStateSynchronizer.getSnapshot(blockNumber);
2092
+ // Double-check world-state synced to the same block hash as was requested.
2093
+ // Block 0 is skipped: the snapshot returned by `getSnapshot(0)` is the *pre*-genesis archive
2094
+ // (size 0), so leaf 0 is not yet inserted from that snapshot's view even though block 0's hash
2095
+ // does live at archive index 0 in the committed tree. The genesis hash is already validated by
2096
+ // the archiver when it resolves the hash query to block number 0.
2097
+ if (requestedHash !== undefined && blockNumber !== BlockNumber.ZERO) {
2098
+ const blockHash = await snapshot.getLeafValue(MerkleTreeId.ARCHIVE, BigInt(blockNumber));
2099
+ if (!blockHash || !requestedHash.equals(blockHash)) {
2100
+ throw new Error(`Block hash ${requestedHash.toString()} not found in world state at block number ${blockNumber} (world state has ${blockHash?.toString() ?? 'no hash'} at that index, genesis header hash is ${this.blockSource.getGenesisBlockHash().toString()}). If the node API has been queried with anchor block hash possibly a reorg has occurred.`);
2101
+ }
2102
+ }
2103
+ return snapshot;
2104
+ }
2105
+ /** Resolves any {@link BlockParameter} variant to a concrete block number. */ async resolveBlockNumber(block) {
2106
+ const query = this.normalizeBlockParameter(block);
2107
+ const blockNumber = await this.blockSource.getBlockNumber(query);
2108
+ if (blockNumber === undefined) {
2109
+ if ('hash' in query) {
2110
+ throw new Error(`Block hash ${query.hash.toString()} not found when querying world state. If the node API has been queried with anchor block hash possibly a reorg has occurred.`);
2111
+ }
2112
+ if ('archive' in query) {
2113
+ throw new Error(`Block with archive ${query.archive.toString()} not found.`);
2114
+ }
2115
+ throw new Error(`Block not found for ${inspectBlockParameter(block)}.`);
2116
+ }
2117
+ return blockNumber;
1020
2118
  }
1021
2119
  /**
1022
- * Ensure we fully sync the world state
2120
+ * Ensure the world state is synced.
2121
+ * @param targetBlockNumber - Block to sync up to. Defaults to the latest block known to the archiver.
2122
+ * @param blockHash - If provided, the synchronizer verifies the block at `targetBlockNumber` matches this
2123
+ * hash, resyncing (and so detecting reorgs) if it does not yet match or has been reorged away.
1023
2124
  * @returns A promise that fulfils once the world state is synced
1024
- */ async #syncWorldState() {
1025
- const blockSourceHeight = await this.blockSource.getBlockNumber();
1026
- return this.worldStateSynchronizer.syncImmediate(blockSourceHeight);
2125
+ */ async #syncWorldState(targetBlockNumber, blockHash) {
2126
+ const target = targetBlockNumber ?? await this.blockSource.getBlockNumber();
2127
+ return await this.worldStateSynchronizer.syncImmediate(target, blockHash);
1027
2128
  }
1028
2129
  }
1029
- _ts_decorate([
1030
- trackSpan('AztecNodeService.simulatePublicCalls', (tx)=>({
1031
- [Attributes.TX_HASH]: tx.getTxHash().toString()
1032
- }))
1033
- ], AztecNodeService.prototype, "simulatePublicCalls", null);