@aztec/pxe 0.0.1-commit.8afd444 → 0.0.1-commit.8f9871590

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