@aztec/pxe 0.0.1-commit.6d63667d → 0.0.1-commit.7cf39cb55

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 (55) hide show
  1. package/dest/contract_function_simulator/contract_function_simulator.d.ts +51 -28
  2. package/dest/contract_function_simulator/contract_function_simulator.d.ts.map +1 -1
  3. package/dest/contract_function_simulator/contract_function_simulator.js +168 -64
  4. package/dest/contract_function_simulator/oracle/interfaces.d.ts +2 -2
  5. package/dest/contract_function_simulator/oracle/interfaces.d.ts.map +1 -1
  6. package/dest/contract_function_simulator/oracle/oracle.d.ts +2 -2
  7. package/dest/contract_function_simulator/oracle/oracle.d.ts.map +1 -1
  8. package/dest/contract_function_simulator/oracle/oracle.js +3 -3
  9. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts +34 -36
  10. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts.map +1 -1
  11. package/dest/contract_function_simulator/oracle/private_execution_oracle.js +71 -18
  12. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts +30 -11
  13. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts.map +1 -1
  14. package/dest/contract_function_simulator/oracle/utility_execution_oracle.js +53 -32
  15. package/dest/contract_sync/contract_sync_service.d.ts +3 -2
  16. package/dest/contract_sync/contract_sync_service.d.ts.map +1 -1
  17. package/dest/contract_sync/contract_sync_service.js +32 -17
  18. package/dest/debug/pxe_debug_utils.d.ts +2 -4
  19. package/dest/debug/pxe_debug_utils.d.ts.map +1 -1
  20. package/dest/debug/pxe_debug_utils.js +1 -4
  21. package/dest/entrypoints/client/bundle/utils.d.ts +1 -1
  22. package/dest/entrypoints/client/bundle/utils.d.ts.map +1 -1
  23. package/dest/entrypoints/client/bundle/utils.js +9 -1
  24. package/dest/entrypoints/client/lazy/utils.d.ts +1 -1
  25. package/dest/entrypoints/client/lazy/utils.d.ts.map +1 -1
  26. package/dest/entrypoints/client/lazy/utils.js +9 -1
  27. package/dest/entrypoints/server/utils.js +9 -1
  28. package/dest/logs/log_service.d.ts +1 -1
  29. package/dest/logs/log_service.d.ts.map +1 -1
  30. package/dest/logs/log_service.js +4 -9
  31. package/dest/oracle_version.d.ts +2 -2
  32. package/dest/oracle_version.js +2 -2
  33. package/dest/pxe.d.ts +67 -23
  34. package/dest/pxe.d.ts.map +1 -1
  35. package/dest/pxe.js +49 -34
  36. package/dest/storage/contract_store/contract_store.js +5 -5
  37. package/dest/storage/note_store/note_store.d.ts +1 -2
  38. package/dest/storage/note_store/note_store.d.ts.map +1 -1
  39. package/dest/storage/note_store/note_store.js +4 -2
  40. package/package.json +16 -16
  41. package/src/contract_function_simulator/contract_function_simulator.ts +314 -121
  42. package/src/contract_function_simulator/oracle/interfaces.ts +1 -1
  43. package/src/contract_function_simulator/oracle/oracle.ts +3 -3
  44. package/src/contract_function_simulator/oracle/private_execution_oracle.ts +91 -93
  45. package/src/contract_function_simulator/oracle/utility_execution_oracle.ts +94 -31
  46. package/src/contract_sync/contract_sync_service.ts +41 -25
  47. package/src/debug/pxe_debug_utils.ts +4 -8
  48. package/src/entrypoints/client/bundle/utils.ts +9 -1
  49. package/src/entrypoints/client/lazy/utils.ts +9 -1
  50. package/src/entrypoints/server/utils.ts +7 -7
  51. package/src/logs/log_service.ts +4 -13
  52. package/src/oracle_version.ts +2 -2
  53. package/src/pxe.ts +114 -71
  54. package/src/storage/contract_store/contract_store.ts +4 -4
  55. package/src/storage/note_store/note_store.ts +5 -2
@@ -7,18 +7,21 @@ import {
7
7
  FIXED_AVM_STARTUP_L2_GAS,
8
8
  FIXED_DA_GAS,
9
9
  FIXED_L2_GAS,
10
- GeneratorIndex,
11
10
  L2_GAS_PER_CONTRACT_CLASS_LOG,
11
+ L2_GAS_PER_L2_TO_L1_MSG,
12
+ L2_GAS_PER_NOTE_HASH,
13
+ L2_GAS_PER_NULLIFIER,
12
14
  L2_GAS_PER_PRIVATE_LOG,
13
15
  MAX_CONTRACT_CLASS_LOGS_PER_TX,
14
16
  MAX_ENQUEUED_CALLS_PER_TX,
15
17
  MAX_L2_TO_L1_MSGS_PER_TX,
16
18
  MAX_NOTE_HASHES_PER_TX,
19
+ MAX_NOTE_HASH_READ_REQUESTS_PER_TX,
17
20
  MAX_NULLIFIERS_PER_TX,
21
+ MAX_NULLIFIER_READ_REQUESTS_PER_TX,
18
22
  MAX_PRIVATE_LOGS_PER_TX,
19
23
  } from '@aztec/constants';
20
24
  import { arrayNonEmptyLength, padArrayEnd } from '@aztec/foundation/collection';
21
- import { poseidon2HashWithSeparator } from '@aztec/foundation/crypto/poseidon';
22
25
  import { Fr } from '@aztec/foundation/curves/bn254';
23
26
  import { type Logger, createLogger } from '@aztec/foundation/log';
24
27
  import { Timer } from '@aztec/foundation/timer';
@@ -38,25 +41,36 @@ import type { FunctionCall } from '@aztec/stdlib/abi';
38
41
  import { FunctionSelector, FunctionType } from '@aztec/stdlib/abi';
39
42
  import type { AuthWitness } from '@aztec/stdlib/auth-witness';
40
43
  import { AztecAddress } from '@aztec/stdlib/aztec-address';
44
+ import type { BlockParameter } from '@aztec/stdlib/block';
41
45
  import { Gas } from '@aztec/stdlib/gas';
42
46
  import {
43
47
  computeNoteHashNonce,
44
48
  computeProtocolNullifier,
49
+ computeSiloedPrivateLogFirstField,
45
50
  computeUniqueNoteHash,
46
51
  siloNoteHash,
47
52
  siloNullifier,
48
53
  } from '@aztec/stdlib/hash';
49
54
  import type { AztecNode } from '@aztec/stdlib/interfaces/server';
50
55
  import {
56
+ ClaimedLengthArray,
51
57
  PartialPrivateTailPublicInputsForPublic,
52
58
  PartialPrivateTailPublicInputsForRollup,
53
59
  type PrivateExecutionStep,
54
60
  type PrivateKernelExecutionProofOutput,
55
61
  PrivateKernelTailCircuitPublicInputs,
62
+ PrivateLogData,
56
63
  PrivateToPublicAccumulatedData,
57
64
  PrivateToRollupAccumulatedData,
58
65
  PublicCallRequest,
66
+ ReadRequestActionEnum,
59
67
  ScopedLogHash,
68
+ ScopedNoteHash,
69
+ ScopedNullifier,
70
+ ScopedReadRequest,
71
+ buildTransientDataHints,
72
+ getNoteHashReadRequestResetActions,
73
+ getNullifierReadRequestResetActions,
60
74
  } from '@aztec/stdlib/kernel';
61
75
  import { PrivateLog } from '@aztec/stdlib/logs';
62
76
  import { ScopedL2ToL1Message } from '@aztec/stdlib/messaging';
@@ -69,6 +83,7 @@ import {
69
83
  TxConstantData,
70
84
  TxExecutionRequest,
71
85
  collectNested,
86
+ collectNoteHashNullifierCounterMap,
72
87
  getFinalMinRevertibleSideEffectCounter,
73
88
  } from '@aztec/stdlib/tx';
74
89
 
@@ -90,52 +105,89 @@ import { executePrivateFunction } from './oracle/private_execution.js';
90
105
  import { PrivateExecutionOracle } from './oracle/private_execution_oracle.js';
91
106
  import { UtilityExecutionOracle } from './oracle/utility_execution_oracle.js';
92
107
 
108
+ /** Options for ContractFunctionSimulator.run. */
109
+ export type ContractSimulatorRunOpts = {
110
+ /** The address of the contract (should match request.origin). */
111
+ contractAddress: AztecAddress;
112
+ /** The function selector of the entry point. */
113
+ selector: FunctionSelector;
114
+ /** The address calling the function. Can be replaced to simulate a call from another contract or account. */
115
+ msgSender?: AztecAddress;
116
+ /** The block header to use as base state for this run. */
117
+ anchorBlockHeader: BlockHeader;
118
+ /** The address used as a tagging sender when emitting private logs. */
119
+ senderForTags?: AztecAddress;
120
+ /** The accounts whose notes we can access in this call. Defaults to all. */
121
+ scopes?: AztecAddress[];
122
+ /** The job ID for staged writes. */
123
+ jobId: string;
124
+ };
125
+
126
+ /** Args for ContractFunctionSimulator constructor. */
127
+ export type ContractFunctionSimulatorArgs = {
128
+ contractStore: ContractStore;
129
+ noteStore: NoteStore;
130
+ keyStore: KeyStore;
131
+ addressStore: AddressStore;
132
+ aztecNode: AztecNode;
133
+ senderTaggingStore: SenderTaggingStore;
134
+ recipientTaggingStore: RecipientTaggingStore;
135
+ senderAddressBookStore: SenderAddressBookStore;
136
+ capsuleStore: CapsuleStore;
137
+ privateEventStore: PrivateEventStore;
138
+ simulator: CircuitSimulator;
139
+ contractSyncService: ContractSyncService;
140
+ };
141
+
93
142
  /**
94
143
  * The contract function simulator.
95
144
  */
96
145
  export class ContractFunctionSimulator {
97
- private log: Logger;
98
-
99
- constructor(
100
- private contractStore: ContractStore,
101
- private noteStore: NoteStore,
102
- private keyStore: KeyStore,
103
- private addressStore: AddressStore,
104
- private aztecNode: AztecNode,
105
- private senderTaggingStore: SenderTaggingStore,
106
- private recipientTaggingStore: RecipientTaggingStore,
107
- private senderAddressBookStore: SenderAddressBookStore,
108
- private capsuleStore: CapsuleStore,
109
- private privateEventStore: PrivateEventStore,
110
- private simulator: CircuitSimulator,
111
- private contractSyncService: ContractSyncService,
112
- ) {
146
+ private readonly log: Logger;
147
+ private readonly contractStore: ContractStore;
148
+ private readonly noteStore: NoteStore;
149
+ private readonly keyStore: KeyStore;
150
+ private readonly addressStore: AddressStore;
151
+ private readonly aztecNode: AztecNode;
152
+ private readonly senderTaggingStore: SenderTaggingStore;
153
+ private readonly recipientTaggingStore: RecipientTaggingStore;
154
+ private readonly senderAddressBookStore: SenderAddressBookStore;
155
+ private readonly capsuleStore: CapsuleStore;
156
+ private readonly privateEventStore: PrivateEventStore;
157
+ private readonly simulator: CircuitSimulator;
158
+ private readonly contractSyncService: ContractSyncService;
159
+
160
+ constructor(args: ContractFunctionSimulatorArgs) {
161
+ this.contractStore = args.contractStore;
162
+ this.noteStore = args.noteStore;
163
+ this.keyStore = args.keyStore;
164
+ this.addressStore = args.addressStore;
165
+ this.aztecNode = args.aztecNode;
166
+ this.senderTaggingStore = args.senderTaggingStore;
167
+ this.recipientTaggingStore = args.recipientTaggingStore;
168
+ this.senderAddressBookStore = args.senderAddressBookStore;
169
+ this.capsuleStore = args.capsuleStore;
170
+ this.privateEventStore = args.privateEventStore;
171
+ this.simulator = args.simulator;
172
+ this.contractSyncService = args.contractSyncService;
113
173
  this.log = createLogger('simulator');
114
174
  }
115
175
 
116
176
  /**
117
177
  * Runs a private function.
118
178
  * @param request - The transaction request.
119
- * @param entryPointArtifact - The artifact of the entry point function.
120
- * @param contractAddress - The address of the contract (should match request.origin)
121
- * @param msgSender - The address calling the function. This can be replaced to simulate a call from another contract
122
- * or a specific account.
123
- * @param anchorBlockHeader - The block header to use as base state for this run.
124
- * @param senderForTags - The address that is used as a tagging sender when emitting private logs. Returned from
125
- * the `privateGetSenderForTags` oracle.
126
- * @param scopes - The accounts whose notes we can access in this call. Currently optional and will default to all.
127
- * @param jobId - The job ID for staged writes.
128
- * @returns The result of the execution.
129
179
  */
130
180
  public async run(
131
181
  request: TxExecutionRequest,
132
- contractAddress: AztecAddress,
133
- selector: FunctionSelector,
134
- msgSender = AztecAddress.fromField(Fr.MAX_FIELD_VALUE),
135
- anchorBlockHeader: BlockHeader,
136
- senderForTags: AztecAddress | undefined,
137
- scopes: AztecAddress[] | undefined,
138
- jobId: string,
182
+ {
183
+ contractAddress,
184
+ selector,
185
+ msgSender = AztecAddress.fromField(Fr.MAX_FIELD_VALUE),
186
+ anchorBlockHeader,
187
+ senderForTags,
188
+ scopes,
189
+ jobId,
190
+ }: ContractSimulatorRunOpts,
139
191
  ): Promise<PrivateExecutionResult> {
140
192
  const simulatorSetupTimer = new Timer();
141
193
 
@@ -165,38 +217,37 @@ export class ContractFunctionSimulator {
165
217
  const noteCache = new ExecutionNoteCache(protocolNullifier);
166
218
  const taggingIndexCache = new ExecutionTaggingIndexCache();
167
219
 
168
- const privateExecutionOracle = new PrivateExecutionOracle(
169
- request.firstCallArgsHash,
170
- request.txContext,
220
+ const privateExecutionOracle = new PrivateExecutionOracle({
221
+ argsHash: request.firstCallArgsHash,
222
+ txContext: request.txContext,
171
223
  callContext,
172
224
  anchorBlockHeader,
173
- async call => {
174
- await this.runUtility(call, [], anchorBlockHeader, scopes, jobId);
225
+ utilityExecutor: async (call, execScopes) => {
226
+ await this.runUtility(call, [], anchorBlockHeader, execScopes, jobId);
175
227
  },
176
- request.authWitnesses,
177
- request.capsules,
178
- HashedValuesCache.create(request.argsOfCalls),
228
+ authWitnesses: request.authWitnesses,
229
+ capsules: request.capsules,
230
+ executionCache: HashedValuesCache.create(request.argsOfCalls),
179
231
  noteCache,
180
232
  taggingIndexCache,
181
- this.contractStore,
182
- this.noteStore,
183
- this.keyStore,
184
- this.addressStore,
185
- this.aztecNode,
186
- this.senderTaggingStore,
187
- this.recipientTaggingStore,
188
- this.senderAddressBookStore,
189
- this.capsuleStore,
190
- this.privateEventStore,
191
- this.contractSyncService,
233
+ contractStore: this.contractStore,
234
+ noteStore: this.noteStore,
235
+ keyStore: this.keyStore,
236
+ addressStore: this.addressStore,
237
+ aztecNode: this.aztecNode,
238
+ senderTaggingStore: this.senderTaggingStore,
239
+ recipientTaggingStore: this.recipientTaggingStore,
240
+ senderAddressBookStore: this.senderAddressBookStore,
241
+ capsuleStore: this.capsuleStore,
242
+ privateEventStore: this.privateEventStore,
243
+ contractSyncService: this.contractSyncService,
192
244
  jobId,
193
- 0, // totalPublicArgsCount
194
- startSideEffectCounter,
195
- undefined, // log
245
+ totalPublicCalldataCount: 0,
246
+ sideEffectCounter: startSideEffectCounter,
196
247
  scopes,
197
248
  senderForTags,
198
- this.simulator,
199
- );
249
+ simulator: this.simulator,
250
+ });
200
251
 
201
252
  const setupTime = simulatorSetupTimer.ms();
202
253
 
@@ -269,24 +320,23 @@ export class ContractFunctionSimulator {
269
320
  throw new Error(`Cannot run ${entryPointArtifact.functionType} function as utility`);
270
321
  }
271
322
 
272
- const oracle = new UtilityExecutionOracle(
273
- call.to,
274
- authwits,
275
- [],
323
+ const oracle = new UtilityExecutionOracle({
324
+ contractAddress: call.to,
325
+ authWitnesses: authwits,
326
+ capsules: [],
276
327
  anchorBlockHeader,
277
- this.contractStore,
278
- this.noteStore,
279
- this.keyStore,
280
- this.addressStore,
281
- this.aztecNode,
282
- this.recipientTaggingStore,
283
- this.senderAddressBookStore,
284
- this.capsuleStore,
285
- this.privateEventStore,
328
+ contractStore: this.contractStore,
329
+ noteStore: this.noteStore,
330
+ keyStore: this.keyStore,
331
+ addressStore: this.addressStore,
332
+ aztecNode: this.aztecNode,
333
+ recipientTaggingStore: this.recipientTaggingStore,
334
+ senderAddressBookStore: this.senderAddressBookStore,
335
+ capsuleStore: this.capsuleStore,
336
+ privateEventStore: this.privateEventStore,
286
337
  jobId,
287
- undefined,
288
338
  scopes,
289
- );
339
+ });
290
340
 
291
341
  try {
292
342
  this.log.verbose(`Executing utility function ${entryPointArtifact.name}`, {
@@ -352,24 +402,33 @@ class OrderedSideEffect<T> {
352
402
  * (allowing state overrides) and is much faster, while still generating a valid
353
403
  * output that can be sent to the node for public simulation
354
404
  * @param privateExecutionResult - The result of the private execution.
355
- * @param contractStore - A provider for contract data in order to get function names and debug info.
405
+ * @param debugFunctionNameGetter - A provider for contract data in order to get function names and debug info.
406
+ * @param node - AztecNode for verifying settled read requests against the note hash and nullifier trees.
356
407
  * @param minRevertibleSideEffectCounterOverride - Optional override for the min revertible side effect counter.
357
408
  * Used by TXE to simulate account contract behavior (setting the counter before app execution).
358
409
  * @returns The simulated proving result.
359
410
  */
360
411
  export async function generateSimulatedProvingResult(
361
412
  privateExecutionResult: PrivateExecutionResult,
362
- contractStore: ContractStore,
413
+ debugFunctionNameGetter: (contractAddress: AztecAddress, functionSelector: FunctionSelector) => Promise<string>,
414
+ node: AztecNode,
363
415
  minRevertibleSideEffectCounterOverride?: number,
364
416
  ): Promise<PrivateKernelExecutionProofOutput<PrivateKernelTailCircuitPublicInputs>> {
365
- const siloedNoteHashes: OrderedSideEffect<Fr>[] = [];
366
- const nullifiers: OrderedSideEffect<Fr>[] = [];
367
- const taggedPrivateLogs: OrderedSideEffect<PrivateLog>[] = [];
417
+ const taggedPrivateLogs: OrderedSideEffect<PrivateLogData>[] = [];
368
418
  const l2ToL1Messages: OrderedSideEffect<ScopedL2ToL1Message>[] = [];
369
419
  const contractClassLogsHashes: OrderedSideEffect<ScopedLogHash>[] = [];
370
420
  const publicCallRequests: OrderedSideEffect<PublicCallRequest>[] = [];
371
421
  const executionSteps: PrivateExecutionStep[] = [];
372
422
 
423
+ // Unsiloed scoped arrays — used for squashing, read request verification,
424
+ // and siloed at the end only for the surviving items
425
+ const scopedNoteHashes: ScopedNoteHash[] = [];
426
+ const scopedNullifiers: ScopedNullifier[] = [];
427
+
428
+ // Read requests for verification
429
+ const noteHashReadRequests: ScopedReadRequest[] = [];
430
+ const nullifierReadRequests: ScopedReadRequest[] = [];
431
+
373
432
  let publicTeardownCallRequest;
374
433
 
375
434
  const executions = [privateExecutionResult.entrypoint];
@@ -380,38 +439,25 @@ export async function generateSimulatedProvingResult(
380
439
 
381
440
  const { contractAddress } = execution.publicInputs.callContext;
382
441
 
383
- const noteHashesFromExecution = await Promise.all(
384
- execution.publicInputs.noteHashes
385
- .getActiveItems()
386
- .filter(noteHash => !noteHash.isEmpty())
387
- .map(
388
- async noteHash =>
389
- new OrderedSideEffect(await siloNoteHash(contractAddress, noteHash.value), noteHash.counter),
390
- ),
391
- );
392
-
393
- const nullifiersFromExecution = await Promise.all(
394
- execution.publicInputs.nullifiers
442
+ scopedNoteHashes.push(
443
+ ...execution.publicInputs.noteHashes
395
444
  .getActiveItems()
396
- .map(
397
- async nullifier =>
398
- new OrderedSideEffect(await siloNullifier(contractAddress, nullifier.value), nullifier.counter),
399
- ),
445
+ .filter(nh => !nh.isEmpty())
446
+ .map(nh => nh.scope(contractAddress)),
400
447
  );
448
+ scopedNullifiers.push(...execution.publicInputs.nullifiers.getActiveItems().map(n => n.scope(contractAddress)));
401
449
 
402
- const privateLogsFromExecution = await Promise.all(
403
- execution.publicInputs.privateLogs.getActiveItems().map(async metadata => {
404
- metadata.log.fields[0] = await poseidon2HashWithSeparator(
405
- [contractAddress, metadata.log.fields[0]],
406
- GeneratorIndex.PRIVATE_LOG_FIRST_FIELD,
407
- );
408
- return new OrderedSideEffect(metadata.log, metadata.counter);
409
- }),
450
+ taggedPrivateLogs.push(
451
+ ...(await Promise.all(
452
+ execution.publicInputs.privateLogs.getActiveItems().map(async metadata => {
453
+ metadata.log.fields[0] = await computeSiloedPrivateLogFirstField(contractAddress, metadata.log.fields[0]);
454
+ return new OrderedSideEffect(metadata, metadata.counter);
455
+ }),
456
+ )),
410
457
  );
411
458
 
412
- siloedNoteHashes.push(...noteHashesFromExecution);
413
- taggedPrivateLogs.push(...privateLogsFromExecution);
414
- nullifiers.push(...nullifiersFromExecution);
459
+ noteHashReadRequests.push(...execution.publicInputs.noteHashReadRequests.getActiveItems());
460
+ nullifierReadRequests.push(...execution.publicInputs.nullifierReadRequests.getActiveItems());
415
461
  l2ToL1Messages.push(
416
462
  ...execution.publicInputs.l2ToL1Msgs
417
463
  .getActiveItems()
@@ -440,7 +486,7 @@ export async function generateSimulatedProvingResult(
440
486
  : execution.publicInputs.publicTeardownCallRequest;
441
487
 
442
488
  executionSteps.push({
443
- functionName: await contractStore.getDebugFunctionName(
489
+ functionName: await debugFunctionNameGetter(
444
490
  execution.publicInputs.callContext.contractAddress,
445
491
  execution.publicInputs.callContext.functionSelector,
446
492
  ),
@@ -451,6 +497,47 @@ export async function generateSimulatedProvingResult(
451
497
  });
452
498
  }
453
499
 
500
+ const noteHashNullifierCounterMap = collectNoteHashNullifierCounterMap(privateExecutionResult);
501
+ const minRevertibleSideEffectCounter =
502
+ minRevertibleSideEffectCounterOverride ?? getFinalMinRevertibleSideEffectCounter(privateExecutionResult);
503
+
504
+ const scopedNoteHashesCLA = new ClaimedLengthArray<ScopedNoteHash, typeof MAX_NOTE_HASHES_PER_TX>(
505
+ padArrayEnd(scopedNoteHashes, ScopedNoteHash.empty(), MAX_NOTE_HASHES_PER_TX),
506
+ scopedNoteHashes.length,
507
+ );
508
+ const scopedNullifiersCLA = new ClaimedLengthArray<ScopedNullifier, typeof MAX_NULLIFIERS_PER_TX>(
509
+ padArrayEnd(scopedNullifiers, ScopedNullifier.empty(), MAX_NULLIFIERS_PER_TX),
510
+ scopedNullifiers.length,
511
+ );
512
+
513
+ const { filteredNoteHashes, filteredNullifiers, filteredPrivateLogs } = squashTransientSideEffects(
514
+ taggedPrivateLogs,
515
+ scopedNoteHashesCLA,
516
+ scopedNullifiersCLA,
517
+ noteHashNullifierCounterMap,
518
+ minRevertibleSideEffectCounter,
519
+ );
520
+
521
+ await verifyReadRequests(
522
+ node,
523
+ await privateExecutionResult.entrypoint.publicInputs.anchorBlockHeader.hash(),
524
+ noteHashReadRequests,
525
+ nullifierReadRequests,
526
+ scopedNoteHashesCLA,
527
+ scopedNullifiersCLA,
528
+ );
529
+
530
+ const siloedNoteHashes = await Promise.all(
531
+ filteredNoteHashes
532
+ .sort((a, b) => a.counter - b.counter)
533
+ .map(async nh => new OrderedSideEffect(await siloNoteHash(nh.contractAddress, nh.value), nh.counter)),
534
+ );
535
+ const siloedNullifiers = await Promise.all(
536
+ filteredNullifiers
537
+ .sort((a, b) => a.counter - b.counter)
538
+ .map(async n => new OrderedSideEffect(await siloNullifier(n.contractAddress, n.value), n.counter)),
539
+ );
540
+
454
541
  const constantData = new TxConstantData(
455
542
  privateExecutionResult.entrypoint.publicInputs.anchorBlockHeader,
456
543
  privateExecutionResult.entrypoint.publicInputs.txContext,
@@ -467,11 +554,9 @@ export async function generateSimulatedProvingResult(
467
554
  const getEffect = <T>(orderedSideEffect: OrderedSideEffect<T>) => orderedSideEffect.sideEffect;
468
555
 
469
556
  const isPrivateOnlyTx = privateExecutionResult.publicFunctionCalldata.length === 0;
470
- const minRevertibleSideEffectCounter =
471
- minRevertibleSideEffectCounterOverride ?? getFinalMinRevertibleSideEffectCounter(privateExecutionResult);
472
557
 
473
558
  const [nonRevertibleNullifiers, revertibleNullifiers] = splitOrderedSideEffects(
474
- nullifiers.sort(sortByCounter),
559
+ siloedNullifiers,
475
560
  minRevertibleSideEffectCounter,
476
561
  );
477
562
  const nonceGenerator = privateExecutionResult.firstNullifier;
@@ -485,7 +570,7 @@ export async function generateSimulatedProvingResult(
485
570
  // We must make the note hashes unique by using the
486
571
  // nonce generator and their index in the tx.
487
572
  const uniqueNoteHashes = await Promise.all(
488
- siloedNoteHashes.sort(sortByCounter).map(async (orderedSideEffect, i) => {
573
+ siloedNoteHashes.map(async (orderedSideEffect, i) => {
489
574
  const siloedNoteHash = orderedSideEffect.sideEffect;
490
575
  const nonce = await computeNoteHashNonce(nonceGenerator, i);
491
576
  const uniqueNoteHash = await computeUniqueNoteHash(nonce, siloedNoteHash);
@@ -500,18 +585,18 @@ export async function generateSimulatedProvingResult(
500
585
  ScopedL2ToL1Message.empty(),
501
586
  MAX_L2_TO_L1_MSGS_PER_TX,
502
587
  ),
503
- padArrayEnd(taggedPrivateLogs.sort(sortByCounter).map(getEffect), PrivateLog.empty(), MAX_PRIVATE_LOGS_PER_TX),
588
+ padArrayEnd(filteredPrivateLogs.sort(sortByCounter).map(getEffect), PrivateLog.empty(), MAX_PRIVATE_LOGS_PER_TX),
504
589
  padArrayEnd(
505
590
  contractClassLogsHashes.sort(sortByCounter).map(getEffect),
506
591
  ScopedLogHash.empty(),
507
592
  MAX_CONTRACT_CLASS_LOGS_PER_TX,
508
593
  ),
509
594
  );
510
- gasUsed = meterGasUsed(accumulatedDataForRollup);
595
+ gasUsed = meterGasUsed(accumulatedDataForRollup, isPrivateOnlyTx);
511
596
  inputsForRollup = new PartialPrivateTailPublicInputsForRollup(accumulatedDataForRollup);
512
597
  } else {
513
598
  const [nonRevertibleNoteHashes, revertibleNoteHashes] = splitOrderedSideEffects(
514
- siloedNoteHashes.sort(sortByCounter),
599
+ siloedNoteHashes,
515
600
  minRevertibleSideEffectCounter,
516
601
  );
517
602
  const nonRevertibleUniqueNoteHashes = await Promise.all(
@@ -525,7 +610,7 @@ export async function generateSimulatedProvingResult(
525
610
  minRevertibleSideEffectCounter,
526
611
  );
527
612
  const [nonRevertibleTaggedPrivateLogs, revertibleTaggedPrivateLogs] = splitOrderedSideEffects(
528
- taggedPrivateLogs,
613
+ filteredPrivateLogs,
529
614
  minRevertibleSideEffectCounter,
530
615
  );
531
616
  const [nonRevertibleContractClassLogHashes, revertibleContractClassLogHashes] = splitOrderedSideEffects(
@@ -554,9 +639,9 @@ export async function generateSimulatedProvingResult(
554
639
  padArrayEnd(revertibleContractClassLogHashes, ScopedLogHash.empty(), MAX_CONTRACT_CLASS_LOGS_PER_TX),
555
640
  padArrayEnd(revertiblePublicCallRequests, PublicCallRequest.empty(), MAX_ENQUEUED_CALLS_PER_TX),
556
641
  );
557
- gasUsed = meterGasUsed(revertibleData).add(meterGasUsed(nonRevertibleData));
642
+ gasUsed = meterGasUsed(revertibleData, isPrivateOnlyTx).add(meterGasUsed(nonRevertibleData, isPrivateOnlyTx));
558
643
  if (publicTeardownCallRequest) {
559
- gasUsed.add(privateExecutionResult.entrypoint.publicInputs.txContext.gasSettings.teardownGasLimits);
644
+ gasUsed = gasUsed.add(privateExecutionResult.entrypoint.publicInputs.txContext.gasSettings.teardownGasLimits);
560
645
  }
561
646
 
562
647
  inputsForPublic = new PartialPrivateTailPublicInputsForPublic(
@@ -582,6 +667,111 @@ export async function generateSimulatedProvingResult(
582
667
  };
583
668
  }
584
669
 
670
+ /**
671
+ * Squashes transient note hashes and nullifiers, mimicking the behavior
672
+ * of the reset kernels. Returns the filtered (surviving) scoped items and private logs.
673
+ */
674
+ function squashTransientSideEffects(
675
+ taggedPrivateLogs: OrderedSideEffect<PrivateLogData>[],
676
+ scopedNoteHashesCLA: ClaimedLengthArray<ScopedNoteHash, typeof MAX_NOTE_HASHES_PER_TX>,
677
+ scopedNullifiersCLA: ClaimedLengthArray<ScopedNullifier, typeof MAX_NULLIFIERS_PER_TX>,
678
+ noteHashNullifierCounterMap: Map<number, number>,
679
+ minRevertibleSideEffectCounter: number,
680
+ ) {
681
+ const { numTransientData, hints: transientDataHints } = buildTransientDataHints(
682
+ scopedNoteHashesCLA,
683
+ scopedNullifiersCLA,
684
+ /*futureNoteHashReads=*/ [],
685
+ /*futureNullifierReads=*/ [],
686
+ noteHashNullifierCounterMap,
687
+ minRevertibleSideEffectCounter,
688
+ );
689
+
690
+ const squashedNoteHashCounters = new Set<number>();
691
+ const squashedNullifierCounters = new Set<number>();
692
+ for (let i = 0; i < numTransientData; i++) {
693
+ const hint = transientDataHints[i];
694
+ squashedNoteHashCounters.add(scopedNoteHashesCLA.array[hint.noteHashIndex].counter);
695
+ squashedNullifierCounters.add(scopedNullifiersCLA.array[hint.nullifierIndex].counter);
696
+ }
697
+
698
+ return {
699
+ filteredNoteHashes: scopedNoteHashesCLA.getActiveItems().filter(nh => !squashedNoteHashCounters.has(nh.counter)),
700
+ filteredNullifiers: scopedNullifiersCLA.getActiveItems().filter(n => !squashedNullifierCounters.has(n.counter)),
701
+ filteredPrivateLogs: taggedPrivateLogs
702
+ .filter(item => !squashedNoteHashCounters.has(item.sideEffect.noteHashCounter))
703
+ .map(item => new OrderedSideEffect(item.sideEffect.log, item.counter)),
704
+ };
705
+ }
706
+
707
+ /**
708
+ * Verifies settled read requests by checking membership in the note hash and nullifier trees
709
+ * at the tx's anchor block, mimicking the behavior of the kernels
710
+ */
711
+ async function verifyReadRequests(
712
+ node: Pick<AztecNode, 'getNoteHashMembershipWitness' | 'getNullifierMembershipWitness'>,
713
+ anchorBlockHash: BlockParameter,
714
+ noteHashReadRequests: ScopedReadRequest[],
715
+ nullifierReadRequests: ScopedReadRequest[],
716
+ scopedNoteHashesCLA: ClaimedLengthArray<ScopedNoteHash, typeof MAX_NOTE_HASHES_PER_TX>,
717
+ scopedNullifiersCLA: ClaimedLengthArray<ScopedNullifier, typeof MAX_NULLIFIERS_PER_TX>,
718
+ ) {
719
+ const noteHashReadRequestsCLA = new ClaimedLengthArray<ScopedReadRequest, typeof MAX_NOTE_HASH_READ_REQUESTS_PER_TX>(
720
+ padArrayEnd(noteHashReadRequests, ScopedReadRequest.empty(), MAX_NOTE_HASH_READ_REQUESTS_PER_TX),
721
+ noteHashReadRequests.length,
722
+ );
723
+ const nullifierReadRequestsCLA = new ClaimedLengthArray<ScopedReadRequest, typeof MAX_NULLIFIER_READ_REQUESTS_PER_TX>(
724
+ padArrayEnd(nullifierReadRequests, ScopedReadRequest.empty(), MAX_NULLIFIER_READ_REQUESTS_PER_TX),
725
+ nullifierReadRequests.length,
726
+ );
727
+
728
+ const noteHashResetActions = getNoteHashReadRequestResetActions(
729
+ noteHashReadRequestsCLA,
730
+ scopedNoteHashesCLA,
731
+ /*futureNoteHashes=*/ [],
732
+ );
733
+ const nullifierResetActions = getNullifierReadRequestResetActions(
734
+ nullifierReadRequestsCLA,
735
+ scopedNullifiersCLA,
736
+ /*futureNullifiers=*/ [],
737
+ );
738
+
739
+ const settledNoteHashReads: { index: number; value: Fr }[] = [];
740
+ for (let i = 0; i < noteHashResetActions.actions.length; i++) {
741
+ if (noteHashResetActions.actions[i] === ReadRequestActionEnum.READ_AS_SETTLED) {
742
+ settledNoteHashReads.push({ index: i, value: noteHashReadRequests[i].value });
743
+ }
744
+ }
745
+
746
+ const settledNullifierReads: { index: number; value: Fr }[] = [];
747
+ for (let i = 0; i < nullifierResetActions.actions.length; i++) {
748
+ if (nullifierResetActions.actions[i] === ReadRequestActionEnum.READ_AS_SETTLED) {
749
+ settledNullifierReads.push({ index: i, value: nullifierReadRequests[i].value });
750
+ }
751
+ }
752
+
753
+ const [noteHashWitnesses, nullifierWitnesses] = await Promise.all([
754
+ Promise.all(settledNoteHashReads.map(({ value }) => node.getNoteHashMembershipWitness(anchorBlockHash, value))),
755
+ Promise.all(settledNullifierReads.map(({ value }) => node.getNullifierMembershipWitness(anchorBlockHash, value))),
756
+ ]);
757
+
758
+ for (let i = 0; i < settledNoteHashReads.length; i++) {
759
+ if (!noteHashWitnesses[i]) {
760
+ throw new Error(
761
+ `Note hash read request at index ${settledNoteHashReads[i].index} is reading an unknown note hash: ${settledNoteHashReads[i].value}`,
762
+ );
763
+ }
764
+ }
765
+
766
+ for (let i = 0; i < settledNullifierReads.length; i++) {
767
+ if (!nullifierWitnesses[i]) {
768
+ throw new Error(
769
+ `Nullifier read request at index ${settledNullifierReads[i].index} is reading an unknown nullifier: ${settledNullifierReads[i].value}`,
770
+ );
771
+ }
772
+ }
773
+ }
774
+
585
775
  function splitOrderedSideEffects<T>(effects: OrderedSideEffect<T>[], minRevertibleSideEffectCounter: number) {
586
776
  const revertibleSideEffects: T[] = [];
587
777
  const nonRevertibleSideEffects: T[] = [];
@@ -595,21 +785,24 @@ function splitOrderedSideEffects<T>(effects: OrderedSideEffect<T>[], minRevertib
595
785
  return [nonRevertibleSideEffects, revertibleSideEffects];
596
786
  }
597
787
 
598
- function meterGasUsed(data: PrivateToRollupAccumulatedData | PrivateToPublicAccumulatedData) {
788
+ function meterGasUsed(data: PrivateToRollupAccumulatedData | PrivateToPublicAccumulatedData, isPrivateOnlyTx: boolean) {
599
789
  let meteredDAFields = 0;
600
790
  let meteredL2Gas = 0;
601
791
 
602
792
  const numNoteHashes = arrayNonEmptyLength(data.noteHashes, hash => hash.isEmpty());
603
793
  meteredDAFields += numNoteHashes;
604
- meteredL2Gas += numNoteHashes * AVM_EMITNOTEHASH_BASE_L2_GAS;
794
+ const noteHashBaseGas = isPrivateOnlyTx ? L2_GAS_PER_NOTE_HASH : AVM_EMITNOTEHASH_BASE_L2_GAS;
795
+ meteredL2Gas += numNoteHashes * noteHashBaseGas;
605
796
 
606
797
  const numNullifiers = arrayNonEmptyLength(data.nullifiers, nullifier => nullifier.isEmpty());
607
798
  meteredDAFields += numNullifiers;
608
- meteredL2Gas += numNullifiers * AVM_EMITNULLIFIER_BASE_L2_GAS;
799
+ const nullifierBaseGas = isPrivateOnlyTx ? L2_GAS_PER_NULLIFIER : AVM_EMITNULLIFIER_BASE_L2_GAS;
800
+ meteredL2Gas += numNullifiers * nullifierBaseGas;
609
801
 
610
802
  const numL2toL1Messages = arrayNonEmptyLength(data.l2ToL1Msgs, msg => msg.isEmpty());
611
803
  meteredDAFields += numL2toL1Messages;
612
- meteredL2Gas += numL2toL1Messages * AVM_SENDL2TOL1MSG_BASE_L2_GAS;
804
+ const l2ToL1MessageBaseGas = isPrivateOnlyTx ? L2_GAS_PER_L2_TO_L1_MSG : AVM_SENDL2TOL1MSG_BASE_L2_GAS;
805
+ meteredL2Gas += numL2toL1Messages * l2ToL1MessageBaseGas;
613
806
 
614
807
  const numPrivatelogs = arrayNonEmptyLength(data.privateLogs, log => log.isEmpty());
615
808
  // Every private log emits its length as an additional field
@@ -54,7 +54,7 @@ export interface IMiscOracle {
54
54
 
55
55
  utilityGetRandomField(): Fr;
56
56
  utilityAssertCompatibleOracleVersion(version: number): void;
57
- utilityDebugLog(level: number, message: string, fields: Fr[]): void;
57
+ utilityLog(level: number, message: string, fields: Fr[]): Promise<void>;
58
58
  }
59
59
 
60
60
  /**
@@ -417,7 +417,7 @@ export class Oracle {
417
417
  return Promise.resolve([]);
418
418
  }
419
419
 
420
- utilityDebugLog(
420
+ async utilityLog(
421
421
  level: ACVMField[],
422
422
  message: ACVMField[],
423
423
  _ignoredFieldsSize: ACVMField[],
@@ -426,8 +426,8 @@ export class Oracle {
426
426
  const levelFr = Fr.fromString(level[0]);
427
427
  const messageStr = message.map(acvmField => String.fromCharCode(Fr.fromString(acvmField).toNumber())).join('');
428
428
  const fieldsFr = fields.map(Fr.fromString);
429
- this.handlerAsMisc().utilityDebugLog(levelFr.toNumber(), messageStr, fieldsFr);
430
- return Promise.resolve([]);
429
+ await this.handlerAsMisc().utilityLog(levelFr.toNumber(), messageStr, fieldsFr);
430
+ return [];
431
431
  }
432
432
 
433
433
  // This function's name is directly hardcoded in `circuit_recorder.ts`. Don't forget to update it there if you