@aztec/pxe 0.0.1-commit.9372f48 → 0.0.1-commit.967fc6998

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 (165) 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/config/package_info.js +1 -1
  8. package/dest/contract_function_simulator/contract_function_simulator.d.ts +54 -28
  9. package/dest/contract_function_simulator/contract_function_simulator.d.ts.map +1 -1
  10. package/dest/contract_function_simulator/contract_function_simulator.js +174 -68
  11. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts +5 -5
  12. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts.map +1 -1
  13. package/dest/contract_function_simulator/execution_tagging_index_cache.js +3 -3
  14. package/dest/contract_function_simulator/noir-structs/event_validation_request.js +1 -1
  15. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts +2 -2
  16. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts.map +1 -1
  17. package/dest/contract_function_simulator/noir-structs/note_validation_request.js +1 -1
  18. package/dest/contract_function_simulator/oracle/interfaces.d.ts +3 -3
  19. package/dest/contract_function_simulator/oracle/interfaces.d.ts.map +1 -1
  20. package/dest/contract_function_simulator/oracle/oracle.d.ts +3 -3
  21. package/dest/contract_function_simulator/oracle/oracle.d.ts.map +1 -1
  22. package/dest/contract_function_simulator/oracle/oracle.js +23 -11
  23. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts +36 -35
  24. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts.map +1 -1
  25. package/dest/contract_function_simulator/oracle/private_execution_oracle.js +73 -28
  26. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts +35 -15
  27. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts.map +1 -1
  28. package/dest/contract_function_simulator/oracle/utility_execution_oracle.js +63 -46
  29. package/dest/contract_logging.d.ts +22 -0
  30. package/dest/contract_logging.d.ts.map +1 -0
  31. package/dest/contract_logging.js +23 -0
  32. package/dest/contract_sync/contract_sync_service.d.ts +43 -0
  33. package/dest/contract_sync/contract_sync_service.d.ts.map +1 -0
  34. package/dest/contract_sync/contract_sync_service.js +97 -0
  35. package/dest/contract_sync/helpers.d.ts +29 -0
  36. package/dest/contract_sync/helpers.d.ts.map +1 -0
  37. package/dest/contract_sync/{index.js → helpers.js} +13 -12
  38. package/dest/debug/pxe_debug_utils.d.ts +14 -10
  39. package/dest/debug/pxe_debug_utils.d.ts.map +1 -1
  40. package/dest/debug/pxe_debug_utils.js +16 -15
  41. package/dest/entrypoints/client/bundle/index.d.ts +4 -1
  42. package/dest/entrypoints/client/bundle/index.d.ts.map +1 -1
  43. package/dest/entrypoints/client/bundle/index.js +3 -0
  44. package/dest/entrypoints/client/bundle/utils.d.ts +1 -1
  45. package/dest/entrypoints/client/bundle/utils.d.ts.map +1 -1
  46. package/dest/entrypoints/client/bundle/utils.js +9 -1
  47. package/dest/entrypoints/client/lazy/index.d.ts +4 -1
  48. package/dest/entrypoints/client/lazy/index.d.ts.map +1 -1
  49. package/dest/entrypoints/client/lazy/index.js +3 -0
  50. package/dest/entrypoints/client/lazy/utils.d.ts +1 -1
  51. package/dest/entrypoints/client/lazy/utils.d.ts.map +1 -1
  52. package/dest/entrypoints/client/lazy/utils.js +9 -1
  53. package/dest/entrypoints/server/index.d.ts +4 -2
  54. package/dest/entrypoints/server/index.d.ts.map +1 -1
  55. package/dest/entrypoints/server/index.js +3 -1
  56. package/dest/entrypoints/server/utils.js +9 -1
  57. package/dest/logs/log_service.d.ts +3 -2
  58. package/dest/logs/log_service.d.ts.map +1 -1
  59. package/dest/logs/log_service.js +11 -18
  60. package/dest/notes/note_service.d.ts +4 -3
  61. package/dest/notes/note_service.d.ts.map +1 -1
  62. package/dest/notes/note_service.js +3 -2
  63. package/dest/notes_filter.d.ts +25 -0
  64. package/dest/notes_filter.d.ts.map +1 -0
  65. package/dest/notes_filter.js +4 -0
  66. package/dest/oracle_version.d.ts +2 -2
  67. package/dest/oracle_version.js +2 -2
  68. package/dest/private_kernel/hints/compute_tx_expiration_timestamp.d.ts +4 -0
  69. package/dest/private_kernel/hints/compute_tx_expiration_timestamp.d.ts.map +1 -0
  70. package/dest/private_kernel/hints/{compute_tx_include_by_timestamp.js → compute_tx_expiration_timestamp.js} +12 -12
  71. package/dest/private_kernel/hints/index.d.ts +1 -1
  72. package/dest/private_kernel/hints/index.js +1 -1
  73. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts +4 -3
  74. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts.map +1 -1
  75. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.js +129 -68
  76. package/dest/private_kernel/hints/test_utils.d.ts +122 -0
  77. package/dest/private_kernel/hints/test_utils.d.ts.map +1 -0
  78. package/dest/private_kernel/hints/test_utils.js +203 -0
  79. package/dest/private_kernel/private_kernel_execution_prover.d.ts +1 -1
  80. package/dest/private_kernel/private_kernel_execution_prover.d.ts.map +1 -1
  81. package/dest/private_kernel/private_kernel_execution_prover.js +19 -11
  82. package/dest/private_kernel/private_kernel_oracle.d.ts +6 -2
  83. package/dest/private_kernel/private_kernel_oracle.d.ts.map +1 -1
  84. package/dest/private_kernel/private_kernel_oracle.js +7 -3
  85. package/dest/pxe.d.ts +71 -24
  86. package/dest/pxe.d.ts.map +1 -1
  87. package/dest/pxe.js +100 -64
  88. package/dest/storage/contract_store/contract_store.d.ts +42 -15
  89. package/dest/storage/contract_store/contract_store.d.ts.map +1 -1
  90. package/dest/storage/contract_store/contract_store.js +145 -69
  91. package/dest/storage/note_store/note_store.d.ts +3 -3
  92. package/dest/storage/note_store/note_store.d.ts.map +1 -1
  93. package/dest/storage/note_store/note_store.js +6 -4
  94. package/dest/storage/tagging_store/recipient_tagging_store.d.ts +6 -6
  95. package/dest/storage/tagging_store/recipient_tagging_store.d.ts.map +1 -1
  96. package/dest/storage/tagging_store/sender_tagging_store.d.ts +5 -5
  97. package/dest/storage/tagging_store/sender_tagging_store.d.ts.map +1 -1
  98. package/dest/storage/tagging_store/sender_tagging_store.js +4 -4
  99. package/dest/tagging/get_all_logs_by_tags.d.ts +1 -1
  100. package/dest/tagging/get_all_logs_by_tags.d.ts.map +1 -1
  101. package/dest/tagging/get_all_logs_by_tags.js +17 -3
  102. package/dest/tagging/index.d.ts +2 -2
  103. package/dest/tagging/index.d.ts.map +1 -1
  104. package/dest/tagging/index.js +1 -1
  105. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts +4 -5
  106. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts.map +1 -1
  107. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.js +7 -7
  108. package/dest/tagging/recipient_sync/utils/find_highest_indexes.js +2 -2
  109. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts +6 -7
  110. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts.map +1 -1
  111. package/dest/tagging/recipient_sync/utils/load_logs_for_range.js +12 -11
  112. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts +4 -8
  113. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts.map +1 -1
  114. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.js +3 -6
  115. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts +4 -7
  116. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts.map +1 -1
  117. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.js +14 -15
  118. package/package.json +25 -16
  119. package/src/access_scopes.ts +9 -0
  120. package/src/block_synchronizer/block_synchronizer.ts +6 -0
  121. package/src/config/package_info.ts +1 -1
  122. package/src/contract_function_simulator/contract_function_simulator.ts +323 -128
  123. package/src/contract_function_simulator/execution_tagging_index_cache.ts +5 -5
  124. package/src/contract_function_simulator/noir-structs/event_validation_request.ts +1 -1
  125. package/src/contract_function_simulator/noir-structs/note_validation_request.ts +1 -1
  126. package/src/contract_function_simulator/oracle/interfaces.ts +2 -2
  127. package/src/contract_function_simulator/oracle/oracle.ts +14 -7
  128. package/src/contract_function_simulator/oracle/private_execution_oracle.ts +99 -105
  129. package/src/contract_function_simulator/oracle/utility_execution_oracle.ts +108 -45
  130. package/src/contract_logging.ts +39 -0
  131. package/src/contract_sync/contract_sync_service.ts +152 -0
  132. package/src/contract_sync/{index.ts → helpers.ts} +21 -21
  133. package/src/debug/pxe_debug_utils.ts +48 -18
  134. package/src/entrypoints/client/bundle/index.ts +3 -0
  135. package/src/entrypoints/client/bundle/utils.ts +9 -1
  136. package/src/entrypoints/client/lazy/index.ts +3 -0
  137. package/src/entrypoints/client/lazy/utils.ts +9 -1
  138. package/src/entrypoints/server/index.ts +3 -1
  139. package/src/entrypoints/server/utils.ts +7 -7
  140. package/src/logs/log_service.ts +18 -25
  141. package/src/notes/note_service.ts +4 -3
  142. package/src/notes_filter.ts +26 -0
  143. package/src/oracle_version.ts +2 -2
  144. package/src/private_kernel/hints/{compute_tx_include_by_timestamp.ts → compute_tx_expiration_timestamp.ts} +13 -13
  145. package/src/private_kernel/hints/index.ts +1 -1
  146. package/src/private_kernel/hints/private_kernel_reset_private_inputs_builder.ts +164 -117
  147. package/src/private_kernel/hints/test_utils.ts +325 -0
  148. package/src/private_kernel/private_kernel_execution_prover.ts +19 -12
  149. package/src/private_kernel/private_kernel_oracle.ts +7 -7
  150. package/src/pxe.ts +184 -113
  151. package/src/storage/contract_store/contract_store.ts +174 -75
  152. package/src/storage/note_store/note_store.ts +12 -5
  153. package/src/storage/tagging_store/recipient_tagging_store.ts +9 -5
  154. package/src/storage/tagging_store/sender_tagging_store.ts +8 -8
  155. package/src/tagging/get_all_logs_by_tags.ts +28 -4
  156. package/src/tagging/index.ts +1 -1
  157. package/src/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.ts +7 -10
  158. package/src/tagging/recipient_sync/utils/find_highest_indexes.ts +2 -2
  159. package/src/tagging/recipient_sync/utils/load_logs_for_range.ts +10 -15
  160. package/src/tagging/sender_sync/sync_sender_tagging_indexes.ts +4 -9
  161. package/src/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.ts +11 -20
  162. package/dest/contract_sync/index.d.ts +0 -23
  163. package/dest/contract_sync/index.d.ts.map +0 -1
  164. package/dest/private_kernel/hints/compute_tx_include_by_timestamp.d.ts +0 -4
  165. package/dest/private_kernel/hints/compute_tx_include_by_timestamp.d.ts.map +0 -1
@@ -1,18 +1,18 @@
1
- import { DirectionalAppTaggingSecret, type PreTag } from '@aztec/stdlib/logs';
1
+ import { ExtendedDirectionalAppTaggingSecret, type PreTag } from '@aztec/stdlib/logs';
2
2
 
3
3
  /**
4
- * A map that stores the tagging index for a given directional app tagging secret.
4
+ * A map that stores the tagging index for a given extended directional app tagging secret.
5
5
  * Note: The directional app tagging secret is unique for a (sender, recipient, contract) tuple while the direction
6
6
  * of sender -> recipient matters.
7
7
  */
8
8
  export class ExecutionTaggingIndexCache {
9
9
  private taggingIndexMap: Map<string, number> = new Map();
10
10
 
11
- public getLastUsedIndex(secret: DirectionalAppTaggingSecret): number | undefined {
11
+ public getLastUsedIndex(secret: ExtendedDirectionalAppTaggingSecret): number | undefined {
12
12
  return this.taggingIndexMap.get(secret.toString());
13
13
  }
14
14
 
15
- public setLastUsedIndex(secret: DirectionalAppTaggingSecret, index: number) {
15
+ public setLastUsedIndex(secret: ExtendedDirectionalAppTaggingSecret, index: number) {
16
16
  const currentValue = this.taggingIndexMap.get(secret.toString());
17
17
  if (currentValue !== undefined && currentValue !== index - 1) {
18
18
  throw new Error(`Invalid tagging index update. Current value: ${currentValue}, new value: ${index}`);
@@ -25,7 +25,7 @@ export class ExecutionTaggingIndexCache {
25
25
  */
26
26
  public getUsedPreTags(): PreTag[] {
27
27
  return Array.from(this.taggingIndexMap.entries()).map(([secret, index]) => ({
28
- secret: DirectionalAppTaggingSecret.fromString(secret),
28
+ extendedSecret: ExtendedDirectionalAppTaggingSecret.fromString(secret),
29
29
  index,
30
30
  }));
31
31
  }
@@ -5,7 +5,7 @@ import { AztecAddress } from '@aztec/stdlib/aztec-address';
5
5
  import { TxHash } from '@aztec/stdlib/tx';
6
6
 
7
7
  // TODO(#14617): should we compute this from constants? This value is aztec-nr specific.
8
- const MAX_EVENT_SERIALIZED_LEN = 12;
8
+ const MAX_EVENT_SERIALIZED_LEN = 10;
9
9
 
10
10
  /**
11
11
  * Intermediate struct used to perform batch event validation by PXE. The `utilityValidateAndStoreEnqueuedNotesAndEvents` oracle
@@ -4,7 +4,7 @@ import { AztecAddress } from '@aztec/stdlib/aztec-address';
4
4
  import { TxHash } from '@aztec/stdlib/tx';
5
5
 
6
6
  // TODO(#14617): should we compute this from constants? This value is aztec-nr specific.
7
- export const MAX_NOTE_PACKED_LEN = 10;
7
+ export const MAX_NOTE_PACKED_LEN = 8;
8
8
 
9
9
  /**
10
10
  * Intermediate struct used to perform batch note validation by PXE. The `utilityValidateAndStoreEnqueuedNotesAndEvents` oracle
@@ -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
  /**
@@ -85,7 +85,7 @@ export interface IUtilityExecutionOracle {
85
85
  nullifier: Fr,
86
86
  ): Promise<NullifierMembershipWitness | undefined>;
87
87
  utilityGetBlockHeader(blockNumber: BlockNumber): Promise<BlockHeader | undefined>;
88
- utilityGetPublicKeysAndPartialAddress(account: AztecAddress): Promise<CompleteAddress>;
88
+ utilityTryGetPublicKeysAndPartialAddress(account: AztecAddress): Promise<CompleteAddress | undefined>;
89
89
  utilityGetAuthWitness(messageHash: Fr): Promise<Fr[] | undefined>;
90
90
  utilityGetNotes(
91
91
  owner: AztecAddress | undefined,
@@ -248,12 +248,19 @@ export class Oracle {
248
248
  return [witness.map(toACVMField)];
249
249
  }
250
250
 
251
- async utilityGetPublicKeysAndPartialAddress([address]: ACVMField[]): Promise<ACVMField[][]> {
251
+ async utilityTryGetPublicKeysAndPartialAddress([address]: ACVMField[]): Promise<(ACVMField | ACVMField[])[]> {
252
252
  const parsedAddress = AztecAddress.fromField(Fr.fromString(address));
253
- const { publicKeys, partialAddress } =
254
- await this.handlerAsUtility().utilityGetPublicKeysAndPartialAddress(parsedAddress);
253
+ const result = await this.handlerAsUtility().utilityTryGetPublicKeysAndPartialAddress(parsedAddress);
255
254
 
256
- return [[...publicKeys.toFields(), partialAddress].map(toACVMField)];
255
+ // We are going to return a Noir Option struct to represent the possibility of null values. Options are a struct
256
+ // with two fields: `some` (a boolean) and `value` (a field array in this case).
257
+ if (result === undefined) {
258
+ // No data was found so we set `some` to 0 and pad `value` with zeros get the correct return size.
259
+ return [toACVMField(0), Array(13).fill(toACVMField(0))];
260
+ } else {
261
+ // Data was found so we set `some` to 1 and return it along with `value`.
262
+ return [toACVMField(1), [...result.publicKeys.toFields(), result.partialAddress].map(toACVMField)];
263
+ }
257
264
  }
258
265
 
259
266
  async utilityGetNotes(
@@ -410,7 +417,7 @@ export class Oracle {
410
417
  return Promise.resolve([]);
411
418
  }
412
419
 
413
- utilityDebugLog(
420
+ async utilityLog(
414
421
  level: ACVMField[],
415
422
  message: ACVMField[],
416
423
  _ignoredFieldsSize: ACVMField[],
@@ -419,8 +426,8 @@ export class Oracle {
419
426
  const levelFr = Fr.fromString(level[0]);
420
427
  const messageStr = message.map(acvmField => String.fromCharCode(Fr.fromString(acvmField).toNumber())).join('');
421
428
  const fieldsFr = fields.map(Fr.fromString);
422
- this.handlerAsMisc().utilityDebugLog(levelFr.toNumber(), messageStr, fieldsFr);
423
- return Promise.resolve([]);
429
+ await this.handlerAsMisc().utilityLog(levelFr.toNumber(), messageStr, fieldsFr);
430
+ return [];
424
431
  }
425
432
 
426
433
  // This function's name is directly hardcoded in `circuit_recorder.ts`. Don't forget to update it there if you
@@ -2,7 +2,6 @@ import { MAX_FR_CALLDATA_TO_ALL_ENQUEUED_CALLS, PRIVATE_CONTEXT_INPUTS_LENGTH }
2
2
  import { Fr } from '@aztec/foundation/curves/bn254';
3
3
  import { createLogger } from '@aztec/foundation/log';
4
4
  import { Timer } from '@aztec/foundation/timer';
5
- import type { KeyStore } from '@aztec/key-store';
6
5
  import { type CircuitSimulator, toACVMWitness } from '@aztec/simulator/client';
7
6
  import {
8
7
  type FunctionAbi,
@@ -12,33 +11,23 @@ import {
12
11
  type NoteSelector,
13
12
  countArgumentsSize,
14
13
  } from '@aztec/stdlib/abi';
15
- import type { AuthWitness } from '@aztec/stdlib/auth-witness';
16
14
  import { AztecAddress } from '@aztec/stdlib/aztec-address';
17
15
  import { siloNullifier } from '@aztec/stdlib/hash';
18
- import type { AztecNode } from '@aztec/stdlib/interfaces/client';
19
16
  import { PrivateContextInputs } from '@aztec/stdlib/kernel';
20
- import { type ContractClassLog, DirectionalAppTaggingSecret, type PreTag } from '@aztec/stdlib/logs';
17
+ import { type ContractClassLog, ExtendedDirectionalAppTaggingSecret, type PreTag } from '@aztec/stdlib/logs';
21
18
  import { Tag } from '@aztec/stdlib/logs';
22
19
  import { Note, type NoteStatus } from '@aztec/stdlib/note';
23
20
  import {
24
- type BlockHeader,
25
21
  CallContext,
26
- Capsule,
27
22
  CountedContractClassLog,
28
23
  NoteAndSlot,
29
24
  PrivateCallExecutionResult,
30
25
  type TxContext,
31
26
  } from '@aztec/stdlib/tx';
32
27
 
33
- import { ensureContractSynced } from '../../contract_sync/index.js';
28
+ import type { AccessScopes } from '../../access_scopes.js';
29
+ import type { ContractSyncService } from '../../contract_sync/contract_sync_service.js';
34
30
  import { NoteService } from '../../notes/note_service.js';
35
- import type { AddressStore } from '../../storage/address_store/address_store.js';
36
- import type { CapsuleStore } from '../../storage/capsule_store/capsule_store.js';
37
- import type { ContractStore } from '../../storage/contract_store/contract_store.js';
38
- import type { NoteStore } from '../../storage/note_store/note_store.js';
39
- import type { PrivateEventStore } from '../../storage/private_event_store/private_event_store.js';
40
- import type { RecipientTaggingStore } from '../../storage/tagging_store/recipient_tagging_store.js';
41
- import type { SenderAddressBookStore } from '../../storage/tagging_store/sender_address_book_store.js';
42
31
  import type { SenderTaggingStore } from '../../storage/tagging_store/sender_tagging_store.js';
43
32
  import { syncSenderTaggingIndexes } from '../../tagging/index.js';
44
33
  import type { ExecutionNoteCache } from '../execution_note_cache.js';
@@ -47,7 +36,25 @@ import type { HashedValuesCache } from '../hashed_values_cache.js';
47
36
  import { pickNotes } from '../pick_notes.js';
48
37
  import type { IPrivateExecutionOracle, NoteData } from './interfaces.js';
49
38
  import { executePrivateFunction } from './private_execution.js';
50
- import { UtilityExecutionOracle } from './utility_execution_oracle.js';
39
+ import { UtilityExecutionOracle, type UtilityExecutionOracleArgs } from './utility_execution_oracle.js';
40
+
41
+ /** Args for PrivateExecutionOracle constructor. */
42
+ export type PrivateExecutionOracleArgs = Omit<UtilityExecutionOracleArgs, 'contractAddress'> & {
43
+ argsHash: Fr;
44
+ txContext: TxContext;
45
+ callContext: CallContext;
46
+ /** Needed to trigger contract synchronization before nested calls */
47
+ utilityExecutor: (call: FunctionCall, scopes: AccessScopes) => Promise<void>;
48
+ executionCache: HashedValuesCache;
49
+ noteCache: ExecutionNoteCache;
50
+ taggingIndexCache: ExecutionTaggingIndexCache;
51
+ senderTaggingStore: SenderTaggingStore;
52
+ contractSyncService: ContractSyncService;
53
+ totalPublicCalldataCount?: number;
54
+ sideEffectCounter?: number;
55
+ senderForTags?: AztecAddress;
56
+ simulator?: CircuitSimulator;
57
+ };
51
58
 
52
59
  /**
53
60
  * The execution oracle for the private part of a transaction.
@@ -69,56 +76,39 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
69
76
  private offchainEffects: { data: Fr[] }[] = [];
70
77
  private nestedExecutionResults: PrivateCallExecutionResult[] = [];
71
78
 
72
- constructor(
73
- private readonly argsHash: Fr,
74
- private readonly txContext: TxContext,
75
- private readonly callContext: CallContext,
76
- /** Header of a block whose state is used during private execution (not the block the transaction is included in). */
77
- protected override readonly anchorBlockHeader: BlockHeader,
78
- /** Needed to trigger contract synchronization before nested calls */
79
- private readonly utilityExecutor: (call: FunctionCall) => Promise<void>,
80
- /** List of transient auth witnesses to be used during this simulation */
81
- authWitnesses: AuthWitness[],
82
- capsules: Capsule[],
83
- private readonly executionCache: HashedValuesCache,
84
- private readonly noteCache: ExecutionNoteCache,
85
- private readonly taggingIndexCache: ExecutionTaggingIndexCache,
86
- contractStore: ContractStore,
87
- noteStore: NoteStore,
88
- keyStore: KeyStore,
89
- addressStore: AddressStore,
90
- aztecNode: AztecNode,
91
- private readonly senderTaggingStore: SenderTaggingStore,
92
- recipientTaggingStore: RecipientTaggingStore,
93
- senderAddressBookStore: SenderAddressBookStore,
94
- capsuleStore: CapsuleStore,
95
- privateEventStore: PrivateEventStore,
96
- jobId: string,
97
- private totalPublicCalldataCount: number = 0,
98
- protected sideEffectCounter: number = 0,
99
- log = createLogger('simulator:client_execution_context'),
100
- scopes?: AztecAddress[],
101
- private senderForTags?: AztecAddress,
102
- private simulator?: CircuitSimulator,
103
- ) {
104
- super(
105
- callContext.contractAddress,
106
- authWitnesses,
107
- capsules,
108
- anchorBlockHeader,
109
- contractStore,
110
- noteStore,
111
- keyStore,
112
- addressStore,
113
- aztecNode,
114
- recipientTaggingStore,
115
- senderAddressBookStore,
116
- capsuleStore,
117
- privateEventStore,
118
- jobId,
119
- log,
120
- scopes,
121
- );
79
+ private readonly argsHash: Fr;
80
+ private readonly txContext: TxContext;
81
+ private readonly callContext: CallContext;
82
+ private readonly utilityExecutor: (call: FunctionCall, scopes: AccessScopes) => Promise<void>;
83
+ private readonly executionCache: HashedValuesCache;
84
+ private readonly noteCache: ExecutionNoteCache;
85
+ private readonly taggingIndexCache: ExecutionTaggingIndexCache;
86
+ private readonly senderTaggingStore: SenderTaggingStore;
87
+ private readonly contractSyncService: ContractSyncService;
88
+ private totalPublicCalldataCount: number;
89
+ protected sideEffectCounter: number;
90
+ private senderForTags?: AztecAddress;
91
+ private readonly simulator?: CircuitSimulator;
92
+
93
+ constructor(args: PrivateExecutionOracleArgs) {
94
+ super({
95
+ ...args,
96
+ contractAddress: args.callContext.contractAddress,
97
+ log: args.log ?? createLogger('simulator:client_execution_context'),
98
+ });
99
+ this.argsHash = args.argsHash;
100
+ this.txContext = args.txContext;
101
+ this.callContext = args.callContext;
102
+ this.utilityExecutor = args.utilityExecutor;
103
+ this.executionCache = args.executionCache;
104
+ this.noteCache = args.noteCache;
105
+ this.taggingIndexCache = args.taggingIndexCache;
106
+ this.senderTaggingStore = args.senderTaggingStore;
107
+ this.contractSyncService = args.contractSyncService;
108
+ this.totalPublicCalldataCount = args.totalPublicCalldataCount ?? 0;
109
+ this.sideEffectCounter = args.sideEffectCounter ?? 0;
110
+ this.senderForTags = args.senderForTags;
111
+ this.simulator = args.simulator;
122
112
  }
123
113
 
124
114
  public getPrivateContextInputs(): PrivateContextInputs {
@@ -226,25 +216,29 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
226
216
  * @returns An app tag to be used in a log.
227
217
  */
228
218
  public async privateGetNextAppTagAsSender(sender: AztecAddress, recipient: AztecAddress): Promise<Tag> {
229
- const secret = await this.#calculateDirectionalAppTaggingSecret(this.contractAddress, sender, recipient);
219
+ const extendedSecret = await this.#calculateExtendedDirectionalAppTaggingSecret(
220
+ this.contractAddress,
221
+ sender,
222
+ recipient,
223
+ );
230
224
 
231
- const index = await this.#getIndexToUseForSecret(secret);
225
+ const index = await this.#getIndexToUseForSecret(extendedSecret);
232
226
  this.log.debug(
233
227
  `Incrementing tagging index for sender: ${sender}, recipient: ${recipient}, contract: ${this.contractAddress} to ${index}`,
234
228
  );
235
- this.taggingIndexCache.setLastUsedIndex(secret, index);
229
+ this.taggingIndexCache.setLastUsedIndex(extendedSecret, index);
236
230
 
237
- return Tag.compute({ secret, index });
231
+ return Tag.compute({ extendedSecret, index });
238
232
  }
239
233
 
240
- async #calculateDirectionalAppTaggingSecret(
234
+ async #calculateExtendedDirectionalAppTaggingSecret(
241
235
  contractAddress: AztecAddress,
242
236
  sender: AztecAddress,
243
237
  recipient: AztecAddress,
244
238
  ) {
245
- const senderCompleteAddress = await this.getCompleteAddress(sender);
239
+ const senderCompleteAddress = await this.getCompleteAddressOrFail(sender);
246
240
  const senderIvsk = await this.keyStore.getMasterIncomingViewingSecretKey(sender);
247
- return DirectionalAppTaggingSecret.compute(
241
+ return ExtendedDirectionalAppTaggingSecret.compute(
248
242
  senderCompleteAddress,
249
243
  senderIvsk,
250
244
  recipient,
@@ -253,7 +247,7 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
253
247
  );
254
248
  }
255
249
 
256
- async #getIndexToUseForSecret(secret: DirectionalAppTaggingSecret): Promise<number> {
250
+ async #getIndexToUseForSecret(secret: ExtendedDirectionalAppTaggingSecret): Promise<number> {
257
251
  // If we have the tagging index in the cache, we use it. If not we obtain it from the execution data provider.
258
252
  const lastUsedIndexInTx = this.taggingIndexCache.getLastUsedIndex(secret);
259
253
 
@@ -265,7 +259,6 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
265
259
  // that'd be wasteful as most tagging secrets are not used in each tx.
266
260
  await syncSenderTaggingIndexes(
267
261
  secret,
268
- this.contractAddress,
269
262
  this.aztecNode,
270
263
  this.senderTaggingStore,
271
264
  await this.anchorBlockHeader.hash(),
@@ -537,13 +530,13 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
537
530
 
538
531
  isStaticCall = isStaticCall || this.callContext.isStaticCall;
539
532
 
540
- await ensureContractSynced(
533
+ await this.contractSyncService.ensureContractSynced(
541
534
  targetContractAddress,
542
535
  functionSelector,
543
536
  this.utilityExecutor,
544
- this.aztecNode,
545
- this.contractStore,
546
537
  this.anchorBlockHeader,
538
+ this.jobId,
539
+ this.scopes,
547
540
  );
548
541
 
549
542
  const targetArtifact = await this.contractStore.getFunctionArtifactWithDebugMetadata(
@@ -555,40 +548,41 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
555
548
 
556
549
  const derivedCallContext = await this.deriveCallContext(targetContractAddress, targetArtifact, isStaticCall);
557
550
 
558
- const privateExecutionOracle = new PrivateExecutionOracle(
551
+ const privateExecutionOracle = new PrivateExecutionOracle({
559
552
  argsHash,
560
- derivedTxContext,
561
- derivedCallContext,
562
- this.anchorBlockHeader,
563
- this.utilityExecutor,
564
- this.authWitnesses,
565
- this.capsules,
566
- this.executionCache,
567
- this.noteCache,
568
- this.taggingIndexCache,
569
- this.contractStore,
570
- this.noteStore,
571
- this.keyStore,
572
- this.addressStore,
573
- this.aztecNode,
574
- this.senderTaggingStore,
575
- this.recipientTaggingStore,
576
- this.senderAddressBookStore,
577
- this.capsuleStore,
578
- this.privateEventStore,
579
- this.jobId,
580
- this.totalPublicCalldataCount,
553
+ txContext: derivedTxContext,
554
+ callContext: derivedCallContext,
555
+ anchorBlockHeader: this.anchorBlockHeader,
556
+ utilityExecutor: this.utilityExecutor,
557
+ authWitnesses: this.authWitnesses,
558
+ capsules: this.capsules,
559
+ executionCache: this.executionCache,
560
+ noteCache: this.noteCache,
561
+ taggingIndexCache: this.taggingIndexCache,
562
+ contractStore: this.contractStore,
563
+ noteStore: this.noteStore,
564
+ keyStore: this.keyStore,
565
+ addressStore: this.addressStore,
566
+ aztecNode: this.aztecNode,
567
+ senderTaggingStore: this.senderTaggingStore,
568
+ recipientTaggingStore: this.recipientTaggingStore,
569
+ senderAddressBookStore: this.senderAddressBookStore,
570
+ capsuleStore: this.capsuleStore,
571
+ privateEventStore: this.privateEventStore,
572
+ contractSyncService: this.contractSyncService,
573
+ jobId: this.jobId,
574
+ totalPublicCalldataCount: this.totalPublicCalldataCount,
581
575
  sideEffectCounter,
582
- this.log,
583
- this.scopes,
584
- this.senderForTags,
585
- this.simulator,
586
- );
576
+ log: this.log,
577
+ scopes: this.scopes,
578
+ senderForTags: this.senderForTags,
579
+ simulator: this.simulator!,
580
+ });
587
581
 
588
582
  const setupTime = simulatorSetupTimer.ms();
589
583
 
590
584
  const childExecutionResult = await executePrivateFunction(
591
- this.simulator,
585
+ this.simulator!,
592
586
  privateExecutionOracle,
593
587
  targetArtifact,
594
588
  targetContractAddress,
@@ -3,7 +3,7 @@ import type { BlockNumber } from '@aztec/foundation/branded-types';
3
3
  import { Aes128 } from '@aztec/foundation/crypto/aes128';
4
4
  import { Fr } from '@aztec/foundation/curves/bn254';
5
5
  import { Point } from '@aztec/foundation/curves/grumpkin';
6
- import { LogLevels, applyStringFormatting, createLogger } from '@aztec/foundation/log';
6
+ import { LogLevels, type Logger, createLogger } from '@aztec/foundation/log';
7
7
  import type { MembershipWitness } from '@aztec/foundation/trees';
8
8
  import type { KeyStore } from '@aztec/key-store';
9
9
  import type { AuthWitness } from '@aztec/stdlib/auth-witness';
@@ -20,6 +20,8 @@ import type { NoteStatus } from '@aztec/stdlib/note';
20
20
  import { MerkleTreeId, type NullifierMembershipWitness, PublicDataWitness } from '@aztec/stdlib/trees';
21
21
  import type { BlockHeader, Capsule } from '@aztec/stdlib/tx';
22
22
 
23
+ import type { AccessScopes } from '../../access_scopes.js';
24
+ import { createContractLogger, logContractMessage } from '../../contract_logging.js';
23
25
  import { EventService } from '../../events/event_service.js';
24
26
  import { LogService } from '../../logs/log_service.js';
25
27
  import { NoteService } from '../../notes/note_service.js';
@@ -40,6 +42,27 @@ import { pickNotes } from '../pick_notes.js';
40
42
  import type { IMiscOracle, IUtilityExecutionOracle, NoteData } from './interfaces.js';
41
43
  import { MessageLoadOracleInputs } from './message_load_oracle_inputs.js';
42
44
 
45
+ /** Args for UtilityExecutionOracle constructor. */
46
+ export type UtilityExecutionOracleArgs = {
47
+ contractAddress: AztecAddress;
48
+ /** List of transient auth witnesses to be used during this simulation */
49
+ authWitnesses: AuthWitness[];
50
+ capsules: Capsule[]; // TODO(#12425): Rename to transientCapsules
51
+ anchorBlockHeader: BlockHeader;
52
+ contractStore: ContractStore;
53
+ noteStore: NoteStore;
54
+ keyStore: KeyStore;
55
+ addressStore: AddressStore;
56
+ aztecNode: AztecNode;
57
+ recipientTaggingStore: RecipientTaggingStore;
58
+ senderAddressBookStore: SenderAddressBookStore;
59
+ capsuleStore: CapsuleStore;
60
+ privateEventStore: PrivateEventStore;
61
+ jobId: string;
62
+ log?: ReturnType<typeof createLogger>;
63
+ scopes: AccessScopes;
64
+ };
65
+
43
66
  /**
44
67
  * The oracle for an execution of utility contract functions.
45
68
  */
@@ -47,27 +70,43 @@ export class UtilityExecutionOracle implements IMiscOracle, IUtilityExecutionOra
47
70
  isMisc = true as const;
48
71
  isUtility = true as const;
49
72
 
50
- private aztecNrDebugLog = createLogger('aztec-nr:debug_log');
51
-
52
- constructor(
53
- protected readonly contractAddress: AztecAddress,
54
- /** List of transient auth witnesses to be used during this simulation */
55
- protected readonly authWitnesses: AuthWitness[],
56
- protected readonly capsules: Capsule[], // TODO(#12425): Rename to transientCapsules
57
- protected readonly anchorBlockHeader: BlockHeader,
58
- protected readonly contractStore: ContractStore,
59
- protected readonly noteStore: NoteStore,
60
- protected readonly keyStore: KeyStore,
61
- protected readonly addressStore: AddressStore,
62
- protected readonly aztecNode: AztecNode,
63
- protected readonly recipientTaggingStore: RecipientTaggingStore,
64
- protected readonly senderAddressBookStore: SenderAddressBookStore,
65
- protected readonly capsuleStore: CapsuleStore,
66
- protected readonly privateEventStore: PrivateEventStore,
67
- protected readonly jobId: string,
68
- protected log = createLogger('simulator:client_view_context'),
69
- protected readonly scopes?: AztecAddress[],
70
- ) {}
73
+ private contractLogger: Logger | undefined;
74
+
75
+ protected readonly contractAddress: AztecAddress;
76
+ protected readonly authWitnesses: AuthWitness[];
77
+ protected readonly capsules: Capsule[];
78
+ protected readonly anchorBlockHeader: BlockHeader;
79
+ protected readonly contractStore: ContractStore;
80
+ protected readonly noteStore: NoteStore;
81
+ protected readonly keyStore: KeyStore;
82
+ protected readonly addressStore: AddressStore;
83
+ protected readonly aztecNode: AztecNode;
84
+ protected readonly recipientTaggingStore: RecipientTaggingStore;
85
+ protected readonly senderAddressBookStore: SenderAddressBookStore;
86
+ protected readonly capsuleStore: CapsuleStore;
87
+ protected readonly privateEventStore: PrivateEventStore;
88
+ protected readonly jobId: string;
89
+ protected log: ReturnType<typeof createLogger>;
90
+ protected readonly scopes: AccessScopes;
91
+
92
+ constructor(args: UtilityExecutionOracleArgs) {
93
+ this.contractAddress = args.contractAddress;
94
+ this.authWitnesses = args.authWitnesses;
95
+ this.capsules = args.capsules;
96
+ this.anchorBlockHeader = args.anchorBlockHeader;
97
+ this.contractStore = args.contractStore;
98
+ this.noteStore = args.noteStore;
99
+ this.keyStore = args.keyStore;
100
+ this.addressStore = args.addressStore;
101
+ this.aztecNode = args.aztecNode;
102
+ this.recipientTaggingStore = args.recipientTaggingStore;
103
+ this.senderAddressBookStore = args.senderAddressBookStore;
104
+ this.capsuleStore = args.capsuleStore;
105
+ this.privateEventStore = args.privateEventStore;
106
+ this.jobId = args.jobId;
107
+ this.log = args.log ?? createLogger('simulator:client_view_context');
108
+ this.scopes = args.scopes;
109
+ }
71
110
 
72
111
  public utilityAssertCompatibleOracleVersion(version: number): void {
73
112
  if (version !== ORACLE_VERSION) {
@@ -88,8 +127,21 @@ export class UtilityExecutionOracle implements IMiscOracle, IUtilityExecutionOra
88
127
  * @param pkMHash - The master public key hash.
89
128
  * @returns A Promise that resolves to nullifier keys.
90
129
  * @throws If the keys are not registered in the key store.
130
+ * @throws If scopes are defined and the account is not in the scopes.
91
131
  */
92
- public utilityGetKeyValidationRequest(pkMHash: Fr): Promise<KeyValidationRequest> {
132
+ public async utilityGetKeyValidationRequest(pkMHash: Fr): Promise<KeyValidationRequest> {
133
+ // If scopes are defined, check that the key belongs to an account in the scopes.
134
+ if (this.scopes !== 'ALL_SCOPES' && this.scopes.length > 0) {
135
+ let hasAccess = false;
136
+ for (let i = 0; i < this.scopes.length && !hasAccess; i++) {
137
+ if (await this.keyStore.accountHasKey(this.scopes[i], pkMHash)) {
138
+ hasAccess = true;
139
+ }
140
+ }
141
+ if (!hasAccess) {
142
+ throw new Error(`Key validation request denied: no scoped account has a key with hash ${pkMHash.toString()}.`);
143
+ }
144
+ }
93
145
  return this.keyStore.getKeyValidationRequest(pkMHash, this.contractAddress);
94
146
  }
95
147
 
@@ -182,14 +234,13 @@ export class UtilityExecutionOracle implements IMiscOracle, IUtilityExecutionOra
182
234
  /**
183
235
  * Retrieve the complete address associated to a given address.
184
236
  * @param account - The account address.
185
- * @returns A complete address associated with the input address.
186
- * @throws An error if the account is not registered in the database.
237
+ * @returns A complete address associated with the input address, or `undefined` if not registered.
187
238
  */
188
- public utilityGetPublicKeysAndPartialAddress(account: AztecAddress): Promise<CompleteAddress> {
189
- return this.getCompleteAddress(account);
239
+ public utilityTryGetPublicKeysAndPartialAddress(account: AztecAddress): Promise<CompleteAddress | undefined> {
240
+ return this.addressStore.getCompleteAddress(account);
190
241
  }
191
242
 
192
- protected async getCompleteAddress(account: AztecAddress): Promise<CompleteAddress> {
243
+ protected async getCompleteAddressOrFail(account: AztecAddress): Promise<CompleteAddress> {
193
244
  const completeAddress = await this.addressStore.getCompleteAddress(account);
194
245
  if (!completeAddress) {
195
246
  throw new Error(
@@ -290,8 +341,13 @@ export class UtilityExecutionOracle implements IMiscOracle, IUtilityExecutionOra
290
341
  * @returns A boolean indicating whether the nullifier exists in the tree or not.
291
342
  */
292
343
  public async utilityCheckNullifierExists(innerNullifier: Fr) {
293
- const nullifier = await siloNullifier(this.contractAddress, innerNullifier!);
294
- const [leafIndex] = await this.aztecNode.findLeavesIndexes('latest', MerkleTreeId.NULLIFIER_TREE, [nullifier]);
344
+ const [nullifier, anchorBlockHash] = await Promise.all([
345
+ siloNullifier(this.contractAddress, innerNullifier!),
346
+ this.anchorBlockHeader.hash(),
347
+ ]);
348
+ const [leafIndex] = await this.aztecNode.findLeavesIndexes(anchorBlockHash, MerkleTreeId.NULLIFIER_TREE, [
349
+ nullifier,
350
+ ]);
295
351
  return leafIndex?.data !== undefined;
296
352
  }
297
353
 
@@ -342,12 +398,28 @@ export class UtilityExecutionOracle implements IMiscOracle, IUtilityExecutionOra
342
398
  return values;
343
399
  }
344
400
 
345
- public utilityDebugLog(level: number, message: string, fields: Fr[]): void {
401
+ /**
402
+ * Returns a per-contract logger whose output is prefixed with `contract_log::<name>(<addrAbbrev>)`.
403
+ */
404
+ async #getContractLogger(): Promise<Logger> {
405
+ if (!this.contractLogger) {
406
+ // Purpose of instanceId is to distinguish logs from different instances of the same component. It makes sense
407
+ // to re-use jobId as instanceId here as executions of different PXE jobs are isolated.
408
+ this.contractLogger = await createContractLogger(
409
+ this.contractAddress,
410
+ addr => this.contractStore.getDebugContractName(addr),
411
+ { instanceId: this.jobId },
412
+ );
413
+ }
414
+ return this.contractLogger;
415
+ }
416
+
417
+ public async utilityLog(level: number, message: string, fields: Fr[]): Promise<void> {
346
418
  if (!LogLevels[level]) {
347
- throw new Error(`Invalid debug log level: ${level}`);
419
+ throw new Error(`Invalid log level: ${level}`);
348
420
  }
349
- const levelName = LogLevels[level];
350
- this.aztecNrDebugLog[levelName](`${applyStringFormatting(message, fields)}`);
421
+ const logger = await this.#getContractLogger();
422
+ logContractMessage(logger, LogLevels[level], message, fields);
351
423
  }
352
424
 
353
425
  public async utilityFetchTaggedLogs(pendingTaggedLogArrayBaseSlot: Fr) {
@@ -363,16 +435,7 @@ export class UtilityExecutionOracle implements IMiscOracle, IUtilityExecutionOra
363
435
  this.log.getBindings(),
364
436
  );
365
437
 
366
- const noteService = new NoteService(this.noteStore, this.aztecNode, this.anchorBlockHeader, this.jobId);
367
-
368
- // It is acceptable to run the following operations in parallel for several reasons:
369
- // 1. syncTaggedLogs does not write to the note store — it only stores the pending tagged logs in a capsule array,
370
- // which is then processed in Noir after this handler returns.
371
- // 2. Even if syncTaggedLogs did write to the note store, it would not cause inconsistent state.
372
- await Promise.all([
373
- logService.syncTaggedLogs(this.contractAddress, pendingTaggedLogArrayBaseSlot, this.scopes),
374
- noteService.syncNoteNullifiers(this.contractAddress),
375
- ]);
438
+ await logService.fetchTaggedLogs(this.contractAddress, pendingTaggedLogArrayBaseSlot, this.scopes);
376
439
  }
377
440
 
378
441
  /**
@@ -544,7 +607,7 @@ export class UtilityExecutionOracle implements IMiscOracle, IUtilityExecutionOra
544
607
 
545
608
  protected async getSharedSecret(address: AztecAddress, ephPk: Point): Promise<Point> {
546
609
  // TODO(#12656): return an app-siloed secret
547
- const recipientCompleteAddress = await this.getCompleteAddress(address);
610
+ const recipientCompleteAddress = await this.getCompleteAddressOrFail(address);
548
611
  const ivskM = await this.keyStore.getMasterSecretKey(
549
612
  recipientCompleteAddress.publicKeys.masterIncomingViewingPublicKey,
550
613
  );