@aztec/pxe 0.0.1-commit.87a0206 → 0.0.1-commit.88c5703d4

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 (194) 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/config/index.d.ts +2 -2
  5. package/dest/config/index.d.ts.map +1 -1
  6. package/dest/config/index.js +1 -1
  7. package/dest/config/package_info.js +1 -1
  8. package/dest/contract_function_simulator/contract_function_simulator.d.ts +60 -30
  9. package/dest/contract_function_simulator/contract_function_simulator.d.ts.map +1 -1
  10. package/dest/contract_function_simulator/contract_function_simulator.js +183 -72
  11. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts +7 -7
  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 +19 -11
  14. package/dest/contract_function_simulator/index.d.ts +2 -1
  15. package/dest/contract_function_simulator/index.d.ts.map +1 -1
  16. package/dest/contract_function_simulator/index.js +1 -0
  17. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts +2 -3
  18. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts.map +1 -1
  19. package/dest/contract_function_simulator/noir-structs/event_validation_request.js +5 -4
  20. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts +1 -1
  21. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts.map +1 -1
  22. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.js +1 -3
  23. package/dest/contract_function_simulator/noir-structs/message_tx_context.d.ts +16 -0
  24. package/dest/contract_function_simulator/noir-structs/message_tx_context.d.ts.map +1 -0
  25. package/dest/contract_function_simulator/noir-structs/message_tx_context.js +57 -0
  26. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts +2 -4
  27. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts.map +1 -1
  28. package/dest/contract_function_simulator/noir-structs/note_validation_request.js +3 -5
  29. package/dest/contract_function_simulator/oracle/interfaces.d.ts +49 -45
  30. package/dest/contract_function_simulator/oracle/interfaces.d.ts.map +1 -1
  31. package/dest/contract_function_simulator/oracle/legacy_oracle_mappings.d.ts +9 -0
  32. package/dest/contract_function_simulator/oracle/legacy_oracle_mappings.d.ts.map +1 -0
  33. package/dest/contract_function_simulator/oracle/legacy_oracle_mappings.js +52 -0
  34. package/dest/contract_function_simulator/oracle/oracle.d.ts +44 -44
  35. package/dest/contract_function_simulator/oracle/oracle.d.ts.map +1 -1
  36. package/dest/contract_function_simulator/oracle/oracle.js +143 -94
  37. package/dest/contract_function_simulator/oracle/private_execution.js +5 -3
  38. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts +56 -79
  39. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts.map +1 -1
  40. package/dest/contract_function_simulator/oracle/private_execution_oracle.js +99 -84
  41. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts +73 -43
  42. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts.map +1 -1
  43. package/dest/contract_function_simulator/oracle/utility_execution_oracle.js +137 -75
  44. package/dest/contract_logging.d.ts +22 -0
  45. package/dest/contract_logging.d.ts.map +1 -0
  46. package/dest/contract_logging.js +23 -0
  47. package/dest/contract_sync/contract_sync_service.d.ts +4 -2
  48. package/dest/contract_sync/contract_sync_service.d.ts.map +1 -1
  49. package/dest/contract_sync/contract_sync_service.js +34 -19
  50. package/dest/contract_sync/helpers.d.ts +3 -2
  51. package/dest/contract_sync/helpers.d.ts.map +1 -1
  52. package/dest/contract_sync/helpers.js +3 -3
  53. package/dest/debug/pxe_debug_utils.d.ts +5 -4
  54. package/dest/debug/pxe_debug_utils.d.ts.map +1 -1
  55. package/dest/debug/pxe_debug_utils.js +4 -4
  56. package/dest/entrypoints/client/bundle/index.d.ts +4 -1
  57. package/dest/entrypoints/client/bundle/index.d.ts.map +1 -1
  58. package/dest/entrypoints/client/bundle/index.js +3 -0
  59. package/dest/entrypoints/client/bundle/utils.d.ts +1 -1
  60. package/dest/entrypoints/client/bundle/utils.d.ts.map +1 -1
  61. package/dest/entrypoints/client/bundle/utils.js +9 -1
  62. package/dest/entrypoints/client/lazy/index.d.ts +4 -1
  63. package/dest/entrypoints/client/lazy/index.d.ts.map +1 -1
  64. package/dest/entrypoints/client/lazy/index.js +3 -0
  65. package/dest/entrypoints/client/lazy/utils.d.ts +1 -1
  66. package/dest/entrypoints/client/lazy/utils.d.ts.map +1 -1
  67. package/dest/entrypoints/client/lazy/utils.js +9 -1
  68. package/dest/entrypoints/server/index.d.ts +3 -1
  69. package/dest/entrypoints/server/index.d.ts.map +1 -1
  70. package/dest/entrypoints/server/index.js +2 -0
  71. package/dest/entrypoints/server/utils.js +9 -1
  72. package/dest/logs/log_service.d.ts +3 -2
  73. package/dest/logs/log_service.d.ts.map +1 -1
  74. package/dest/logs/log_service.js +9 -14
  75. package/dest/messages/message_context_service.d.ts +17 -0
  76. package/dest/messages/message_context_service.d.ts.map +1 -0
  77. package/dest/messages/message_context_service.js +36 -0
  78. package/dest/notes/note_service.d.ts +4 -3
  79. package/dest/notes/note_service.d.ts.map +1 -1
  80. package/dest/notes/note_service.js +3 -2
  81. package/dest/notes_filter.d.ts +25 -0
  82. package/dest/notes_filter.d.ts.map +1 -0
  83. package/dest/notes_filter.js +4 -0
  84. package/dest/oracle_version.d.ts +2 -2
  85. package/dest/oracle_version.js +3 -3
  86. package/dest/private_kernel/hints/compute_tx_expiration_timestamp.d.ts +4 -0
  87. package/dest/private_kernel/hints/compute_tx_expiration_timestamp.d.ts.map +1 -0
  88. package/dest/private_kernel/hints/{compute_tx_include_by_timestamp.js → compute_tx_expiration_timestamp.js} +12 -12
  89. package/dest/private_kernel/hints/index.d.ts +1 -1
  90. package/dest/private_kernel/hints/index.js +1 -1
  91. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts +4 -3
  92. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts.map +1 -1
  93. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.js +129 -68
  94. package/dest/private_kernel/hints/test_utils.d.ts +122 -0
  95. package/dest/private_kernel/hints/test_utils.d.ts.map +1 -0
  96. package/dest/private_kernel/hints/test_utils.js +203 -0
  97. package/dest/private_kernel/private_kernel_execution_prover.d.ts +1 -1
  98. package/dest/private_kernel/private_kernel_execution_prover.d.ts.map +1 -1
  99. package/dest/private_kernel/private_kernel_execution_prover.js +19 -11
  100. package/dest/private_kernel/private_kernel_oracle.d.ts +6 -2
  101. package/dest/private_kernel/private_kernel_oracle.d.ts.map +1 -1
  102. package/dest/private_kernel/private_kernel_oracle.js +7 -3
  103. package/dest/pxe.d.ts +61 -24
  104. package/dest/pxe.d.ts.map +1 -1
  105. package/dest/pxe.js +91 -65
  106. package/dest/storage/contract_store/contract_store.d.ts +42 -15
  107. package/dest/storage/contract_store/contract_store.d.ts.map +1 -1
  108. package/dest/storage/contract_store/contract_store.js +140 -64
  109. package/dest/storage/metadata.d.ts +1 -1
  110. package/dest/storage/metadata.js +1 -1
  111. package/dest/storage/note_store/note_store.d.ts +3 -3
  112. package/dest/storage/note_store/note_store.d.ts.map +1 -1
  113. package/dest/storage/note_store/note_store.js +3 -4
  114. package/dest/storage/tagging_store/recipient_tagging_store.d.ts +6 -6
  115. package/dest/storage/tagging_store/recipient_tagging_store.d.ts.map +1 -1
  116. package/dest/storage/tagging_store/sender_tagging_store.d.ts +29 -28
  117. package/dest/storage/tagging_store/sender_tagging_store.d.ts.map +1 -1
  118. package/dest/storage/tagging_store/sender_tagging_store.js +141 -115
  119. package/dest/tagging/get_all_logs_by_tags.d.ts +1 -1
  120. package/dest/tagging/get_all_logs_by_tags.d.ts.map +1 -1
  121. package/dest/tagging/get_all_logs_by_tags.js +17 -3
  122. package/dest/tagging/index.d.ts +3 -3
  123. package/dest/tagging/index.d.ts.map +1 -1
  124. package/dest/tagging/index.js +1 -1
  125. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts +4 -5
  126. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts.map +1 -1
  127. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.js +7 -7
  128. package/dest/tagging/recipient_sync/utils/find_highest_indexes.js +2 -2
  129. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts +6 -7
  130. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts.map +1 -1
  131. package/dest/tagging/recipient_sync/utils/load_logs_for_range.js +12 -11
  132. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts +4 -8
  133. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts.map +1 -1
  134. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.js +13 -7
  135. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts +4 -3
  136. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts.map +1 -1
  137. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.js +20 -10
  138. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts +5 -7
  139. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts.map +1 -1
  140. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.js +36 -24
  141. package/package.json +16 -16
  142. package/src/access_scopes.ts +9 -0
  143. package/src/config/index.ts +1 -1
  144. package/src/config/package_info.ts +1 -1
  145. package/src/contract_function_simulator/contract_function_simulator.ts +335 -133
  146. package/src/contract_function_simulator/execution_tagging_index_cache.ts +19 -14
  147. package/src/contract_function_simulator/index.ts +1 -0
  148. package/src/contract_function_simulator/noir-structs/event_validation_request.ts +8 -5
  149. package/src/contract_function_simulator/noir-structs/log_retrieval_response.ts +1 -4
  150. package/src/contract_function_simulator/noir-structs/message_tx_context.ts +55 -0
  151. package/src/contract_function_simulator/noir-structs/note_validation_request.ts +3 -6
  152. package/src/contract_function_simulator/oracle/interfaces.ts +53 -54
  153. package/src/contract_function_simulator/oracle/legacy_oracle_mappings.ts +77 -0
  154. package/src/contract_function_simulator/oracle/oracle.ts +156 -138
  155. package/src/contract_function_simulator/oracle/private_execution.ts +4 -4
  156. package/src/contract_function_simulator/oracle/private_execution_oracle.ts +125 -176
  157. package/src/contract_function_simulator/oracle/utility_execution_oracle.ts +210 -82
  158. package/src/contract_logging.ts +39 -0
  159. package/src/contract_sync/contract_sync_service.ts +49 -26
  160. package/src/contract_sync/helpers.ts +7 -2
  161. package/src/debug/pxe_debug_utils.ts +11 -9
  162. package/src/entrypoints/client/bundle/index.ts +3 -0
  163. package/src/entrypoints/client/bundle/utils.ts +9 -1
  164. package/src/entrypoints/client/lazy/index.ts +3 -0
  165. package/src/entrypoints/client/lazy/utils.ts +9 -1
  166. package/src/entrypoints/server/index.ts +2 -0
  167. package/src/entrypoints/server/utils.ts +7 -7
  168. package/src/logs/log_service.ts +17 -24
  169. package/src/messages/message_context_service.ts +45 -0
  170. package/src/notes/note_service.ts +4 -3
  171. package/src/notes_filter.ts +26 -0
  172. package/src/oracle_version.ts +3 -3
  173. package/src/private_kernel/hints/{compute_tx_include_by_timestamp.ts → compute_tx_expiration_timestamp.ts} +13 -13
  174. package/src/private_kernel/hints/index.ts +1 -1
  175. package/src/private_kernel/hints/private_kernel_reset_private_inputs_builder.ts +164 -117
  176. package/src/private_kernel/hints/test_utils.ts +325 -0
  177. package/src/private_kernel/private_kernel_execution_prover.ts +19 -12
  178. package/src/private_kernel/private_kernel_oracle.ts +7 -7
  179. package/src/pxe.ts +164 -109
  180. package/src/storage/contract_store/contract_store.ts +170 -71
  181. package/src/storage/metadata.ts +1 -1
  182. package/src/storage/note_store/note_store.ts +8 -5
  183. package/src/storage/tagging_store/recipient_tagging_store.ts +9 -5
  184. package/src/storage/tagging_store/sender_tagging_store.ts +185 -138
  185. package/src/tagging/get_all_logs_by_tags.ts +28 -4
  186. package/src/tagging/index.ts +2 -2
  187. package/src/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.ts +7 -10
  188. package/src/tagging/recipient_sync/utils/find_highest_indexes.ts +2 -2
  189. package/src/tagging/recipient_sync/utils/load_logs_for_range.ts +10 -15
  190. package/src/tagging/sender_sync/sync_sender_tagging_indexes.ts +23 -10
  191. package/src/tagging/sender_sync/utils/get_status_change_of_pending.ts +26 -11
  192. package/src/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.ts +27 -26
  193. package/dest/private_kernel/hints/compute_tx_include_by_timestamp.d.ts +0 -4
  194. package/dest/private_kernel/hints/compute_tx_include_by_timestamp.d.ts.map +0 -1
@@ -76,12 +76,12 @@ export async function executePrivateFunction(
76
76
 
77
77
  const contractClassLogs = privateExecutionOracle.getContractClassLogs();
78
78
 
79
- const rawReturnValues = await privateExecutionOracle.privateLoadFromExecutionCache(publicInputs.returnsHash);
79
+ const rawReturnValues = await privateExecutionOracle.loadFromExecutionCache(publicInputs.returnsHash);
80
80
 
81
81
  const newNotes = privateExecutionOracle.getNewNotes();
82
82
  const noteHashNullifierCounterMap = privateExecutionOracle.getNoteHashNullifierCounterMap();
83
83
  const offchainEffects = privateExecutionOracle.getOffchainEffects();
84
- const preTags = privateExecutionOracle.getUsedPreTags();
84
+ const taggingIndexRanges = privateExecutionOracle.getUsedTaggingIndexRanges();
85
85
  const nestedExecutionResults = privateExecutionOracle.getNestedExecutionResults();
86
86
 
87
87
  let timerSubtractionList = nestedExecutionResults;
@@ -103,8 +103,8 @@ export async function executePrivateFunction(
103
103
  newNotes,
104
104
  noteHashNullifierCounterMap,
105
105
  rawReturnValues,
106
- offchainEffects,
107
- preTags,
106
+ offchainEffects.map(e => ({ data: e.data })),
107
+ taggingIndexRanges,
108
108
  nestedExecutionResults,
109
109
  contractClassLogs,
110
110
  {
@@ -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 TaggingIndexRange } 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
 
28
+ import type { AccessScopes } from '../../access_scopes.js';
33
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.
@@ -66,60 +73,41 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
66
73
  private newNotes: NoteAndSlot[] = [];
67
74
  private noteHashNullifierCounterMap: Map<number, number> = new Map();
68
75
  private contractClassLogs: CountedContractClassLog[] = [];
69
- private offchainEffects: { data: Fr[] }[] = [];
70
76
  private nestedExecutionResults: PrivateCallExecutionResult[] = [];
71
77
 
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
- private readonly contractSyncService: ContractSyncService,
97
- jobId: string,
98
- private totalPublicCalldataCount: number = 0,
99
- protected sideEffectCounter: number = 0,
100
- log = createLogger('simulator:client_execution_context'),
101
- scopes?: AztecAddress[],
102
- private senderForTags?: AztecAddress,
103
- private simulator?: CircuitSimulator,
104
- ) {
105
- super(
106
- callContext.contractAddress,
107
- authWitnesses,
108
- capsules,
109
- anchorBlockHeader,
110
- contractStore,
111
- noteStore,
112
- keyStore,
113
- addressStore,
114
- aztecNode,
115
- recipientTaggingStore,
116
- senderAddressBookStore,
117
- capsuleStore,
118
- privateEventStore,
119
- jobId,
120
- log,
121
- scopes,
122
- );
78
+ private readonly argsHash: Fr;
79
+ private readonly txContext: TxContext;
80
+ private readonly callContext: CallContext;
81
+ private readonly utilityExecutor: (call: FunctionCall, scopes: AccessScopes) => Promise<void>;
82
+ private readonly executionCache: HashedValuesCache;
83
+ private readonly noteCache: ExecutionNoteCache;
84
+ private readonly taggingIndexCache: ExecutionTaggingIndexCache;
85
+ private readonly senderTaggingStore: SenderTaggingStore;
86
+ private readonly contractSyncService: ContractSyncService;
87
+ private totalPublicCalldataCount: number;
88
+ protected sideEffectCounter: number;
89
+ private senderForTags?: AztecAddress;
90
+ private readonly simulator?: CircuitSimulator;
91
+
92
+ constructor(args: PrivateExecutionOracleArgs) {
93
+ super({
94
+ ...args,
95
+ contractAddress: args.callContext.contractAddress,
96
+ log: args.log ?? createLogger('simulator:client_execution_context'),
97
+ });
98
+ this.argsHash = args.argsHash;
99
+ this.txContext = args.txContext;
100
+ this.callContext = args.callContext;
101
+ this.utilityExecutor = args.utilityExecutor;
102
+ this.executionCache = args.executionCache;
103
+ this.noteCache = args.noteCache;
104
+ this.taggingIndexCache = args.taggingIndexCache;
105
+ this.senderTaggingStore = args.senderTaggingStore;
106
+ this.contractSyncService = args.contractSyncService;
107
+ this.totalPublicCalldataCount = args.totalPublicCalldataCount ?? 0;
108
+ this.sideEffectCounter = args.sideEffectCounter ?? 0;
109
+ this.senderForTags = args.senderForTags;
110
+ this.simulator = args.simulator;
123
111
  }
124
112
 
125
113
  public getPrivateContextInputs(): PrivateContextInputs {
@@ -170,17 +158,10 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
170
158
  }
171
159
 
172
160
  /**
173
- * Return the offchain effects emitted during this execution.
174
- */
175
- public getOffchainEffects() {
176
- return this.offchainEffects;
177
- }
178
-
179
- /**
180
- * Returns the pre-tags that were used in this execution (and that need to be stored in the db).
161
+ * Returns the tagging index ranges that were used in this execution (and that need to be stored in the db).
181
162
  */
182
- public getUsedPreTags(): PreTag[] {
183
- return this.taggingIndexCache.getUsedPreTags();
163
+ public getUsedTaggingIndexRanges(): TaggingIndexRange[] {
164
+ return this.taggingIndexCache.getUsedTaggingIndexRanges();
184
165
  }
185
166
 
186
167
  /**
@@ -200,7 +181,7 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
200
181
  * The value persists through nested calls, meaning all calls down the stack will use the same
201
182
  * 'senderForTags' value (unless it is replaced).
202
183
  */
203
- public privateGetSenderForTags(): Promise<AztecAddress | undefined> {
184
+ public getSenderForTags(): Promise<AztecAddress | undefined> {
204
185
  return Promise.resolve(this.senderForTags);
205
186
  }
206
187
 
@@ -215,7 +196,7 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
215
196
  * through nested calls, meaning all calls down the stack will use the same 'senderForTags'
216
197
  * value (unless it is replaced by another call to this setter).
217
198
  */
218
- public privateSetSenderForTags(senderForTags: AztecAddress): Promise<void> {
199
+ public setSenderForTags(senderForTags: AztecAddress): Promise<void> {
219
200
  this.senderForTags = senderForTags;
220
201
  return Promise.resolve();
221
202
  }
@@ -226,26 +207,30 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
226
207
  * @param recipient - The address receiving the log
227
208
  * @returns An app tag to be used in a log.
228
209
  */
229
- public async privateGetNextAppTagAsSender(sender: AztecAddress, recipient: AztecAddress): Promise<Tag> {
230
- const secret = await this.#calculateDirectionalAppTaggingSecret(this.contractAddress, sender, recipient);
210
+ public async getNextAppTagAsSender(sender: AztecAddress, recipient: AztecAddress): Promise<Tag> {
211
+ const extendedSecret = await this.#calculateExtendedDirectionalAppTaggingSecret(
212
+ this.contractAddress,
213
+ sender,
214
+ recipient,
215
+ );
231
216
 
232
- const index = await this.#getIndexToUseForSecret(secret);
233
- this.log.debug(
217
+ const index = await this.#getIndexToUseForSecret(extendedSecret);
218
+ this.logger.debug(
234
219
  `Incrementing tagging index for sender: ${sender}, recipient: ${recipient}, contract: ${this.contractAddress} to ${index}`,
235
220
  );
236
- this.taggingIndexCache.setLastUsedIndex(secret, index);
221
+ this.taggingIndexCache.setLastUsedIndex(extendedSecret, index);
237
222
 
238
- return Tag.compute({ secret, index });
223
+ return Tag.compute({ extendedSecret, index });
239
224
  }
240
225
 
241
- async #calculateDirectionalAppTaggingSecret(
226
+ async #calculateExtendedDirectionalAppTaggingSecret(
242
227
  contractAddress: AztecAddress,
243
228
  sender: AztecAddress,
244
229
  recipient: AztecAddress,
245
230
  ) {
246
231
  const senderCompleteAddress = await this.getCompleteAddressOrFail(sender);
247
232
  const senderIvsk = await this.keyStore.getMasterIncomingViewingSecretKey(sender);
248
- return DirectionalAppTaggingSecret.compute(
233
+ return ExtendedDirectionalAppTaggingSecret.compute(
249
234
  senderCompleteAddress,
250
235
  senderIvsk,
251
236
  recipient,
@@ -254,7 +239,7 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
254
239
  );
255
240
  }
256
241
 
257
- async #getIndexToUseForSecret(secret: DirectionalAppTaggingSecret): Promise<number> {
242
+ async #getIndexToUseForSecret(secret: ExtendedDirectionalAppTaggingSecret): Promise<number> {
258
243
  // If we have the tagging index in the cache, we use it. If not we obtain it from the execution data provider.
259
244
  const lastUsedIndexInTx = this.taggingIndexCache.getLastUsedIndex(secret);
260
245
 
@@ -266,7 +251,6 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
266
251
  // that'd be wasteful as most tagging secrets are not used in each tx.
267
252
  await syncSenderTaggingIndexes(
268
253
  secret,
269
- this.contractAddress,
270
254
  this.aztecNode,
271
255
  this.senderTaggingStore,
272
256
  await this.anchorBlockHeader.hash(),
@@ -285,7 +269,7 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
285
269
  * @param values - Values to store.
286
270
  * @returns The hash of the values.
287
271
  */
288
- public privateStoreInExecutionCache(values: Fr[], hash: Fr) {
272
+ public storeInExecutionCache(values: Fr[], hash: Fr) {
289
273
  return this.executionCache.store(values, hash);
290
274
  }
291
275
 
@@ -294,7 +278,7 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
294
278
  * @param hash - Hash of the values.
295
279
  * @returns The values.
296
280
  */
297
- public privateLoadFromExecutionCache(hash: Fr): Promise<Fr[]> {
281
+ public loadFromExecutionCache(hash: Fr): Promise<Fr[]> {
298
282
  const preimage = this.executionCache.getPreimage(hash);
299
283
  if (!preimage) {
300
284
  throw new Error(`Preimage for hash ${hash.toString()} not found in cache`);
@@ -302,12 +286,12 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
302
286
  return Promise.resolve(preimage);
303
287
  }
304
288
 
305
- override async utilityCheckNullifierExists(innerNullifier: Fr): Promise<boolean> {
289
+ override async checkNullifierExists(innerNullifier: Fr): Promise<boolean> {
306
290
  // This oracle must be overridden because while utility execution can only meaningfully check if a nullifier exists
307
291
  // in the synched block, during private execution there's also the possibility of it being pending, i.e. created
308
292
  // in the current transaction.
309
293
 
310
- this.log.debug(`Checking existence of inner nullifier ${innerNullifier}`, {
294
+ this.logger.debug(`Checking existence of inner nullifier ${innerNullifier}`, {
311
295
  contractAddress: this.contractAddress,
312
296
  });
313
297
 
@@ -315,7 +299,7 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
315
299
 
316
300
  return (
317
301
  this.noteCache.getNullifiers(this.contractAddress).has(nullifier) ||
318
- (await super.utilityCheckNullifierExists(innerNullifier))
302
+ (await super.checkNullifierExists(innerNullifier))
319
303
  );
320
304
  }
321
305
 
@@ -340,7 +324,7 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
340
324
  * @param status - The status of notes to fetch.
341
325
  * @returns Array of note data.
342
326
  */
343
- public override async utilityGetNotes(
327
+ public override async getNotes(
344
328
  owner: AztecAddress | undefined,
345
329
  storageSlot: Fr,
346
330
  numSelects: number,
@@ -386,7 +370,7 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
386
370
  offset,
387
371
  });
388
372
 
389
- this.log.debug(
373
+ this.logger.debug(
390
374
  `Returning ${notes.length} notes for ${this.callContext.contractAddress} at ${storageSlot}: ${notes
391
375
  .map(n => `${n.noteNonce.toString()}:[${n.note.items.map(i => i.toString()).join(',')}]`)
392
376
  .join(', ')}`,
@@ -406,7 +390,7 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
406
390
  * @param noteHash - A hash of the new note.
407
391
  * @returns
408
392
  */
409
- public privateNotifyCreatedNote(
393
+ public notifyCreatedNote(
410
394
  owner: AztecAddress,
411
395
  storageSlot: Fr,
412
396
  randomness: Fr,
@@ -415,7 +399,7 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
415
399
  noteHash: Fr,
416
400
  counter: number,
417
401
  ) {
418
- this.log.debug(`Notified of new note with inner hash ${noteHash}`, {
402
+ this.logger.debug(`Notified of new note with inner hash ${noteHash}`, {
419
403
  contractAddress: this.callContext.contractAddress,
420
404
  storageSlot,
421
405
  randomness,
@@ -447,7 +431,7 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
447
431
  * @param innerNullifier - The pending nullifier to add in the list (not yet siloed by contract address).
448
432
  * @param noteHash - A hash of the new note.
449
433
  */
450
- public async privateNotifyNullifiedNote(innerNullifier: Fr, noteHash: Fr, counter: number) {
434
+ public async notifyNullifiedNote(innerNullifier: Fr, noteHash: Fr, counter: number) {
451
435
  const nullifiedNoteHashCounter = await this.noteCache.nullifyNote(
452
436
  this.callContext.contractAddress,
453
437
  innerNullifier,
@@ -464,19 +448,19 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
464
448
  * @param innerNullifier - The pending nullifier to add in the list (not yet siloed by contract address).
465
449
  * @param noteHash - A hash of the new note.
466
450
  */
467
- public privateNotifyCreatedNullifier(innerNullifier: Fr) {
468
- this.log.debug(`Notified of new inner nullifier ${innerNullifier}`, { contractAddress: this.contractAddress });
451
+ public notifyCreatedNullifier(innerNullifier: Fr) {
452
+ this.logger.debug(`Notified of new inner nullifier ${innerNullifier}`, { contractAddress: this.contractAddress });
469
453
  return this.noteCache.nullifierCreated(this.callContext.contractAddress, innerNullifier);
470
454
  }
471
455
 
472
456
  /**
473
- * Check if a nullifier has been emitted in the same transaction, i.e. if privateNotifyCreatedNullifier has been
457
+ * Check if a nullifier has been emitted in the same transaction, i.e. if notifyCreatedNullifier has been
474
458
  * called for this inner nullifier from the contract with the specified address.
475
459
  * @param innerNullifier - The inner nullifier to check.
476
460
  * @param contractAddress - Address of the contract that emitted the nullifier.
477
461
  * @returns A boolean indicating whether the nullifier is pending or not.
478
462
  */
479
- public async privateIsNullifierPending(innerNullifier: Fr, contractAddress: AztecAddress): Promise<boolean> {
463
+ public async isNullifierPending(innerNullifier: Fr, contractAddress: AztecAddress): Promise<boolean> {
480
464
  const siloedNullifier = await siloNullifier(contractAddress, innerNullifier);
481
465
  const isNullifierPending = this.noteCache.getNullifiers(contractAddress).has(siloedNullifier.toBigInt());
482
466
  return Promise.resolve(isNullifierPending);
@@ -489,10 +473,10 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
489
473
  * @param log - The contract class log to be emitted.
490
474
  * @param counter - The contract class log's counter.
491
475
  */
492
- public privateNotifyCreatedContractClassLog(log: ContractClassLog, counter: number) {
476
+ public notifyCreatedContractClassLog(log: ContractClassLog, counter: number) {
493
477
  this.contractClassLogs.push(new CountedContractClassLog(log, counter));
494
478
  const text = log.toBuffer().toString('hex');
495
- this.log.verbose(
479
+ this.logger.verbose(
496
480
  `Emitted log from ContractClassRegistry: "${text.length > 100 ? text.slice(0, 100) + '...' : text}"`,
497
481
  );
498
482
  }
@@ -518,7 +502,7 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
518
502
  * @param isStaticCall - Whether the call is a static call.
519
503
  * @returns The execution result.
520
504
  */
521
- async privateCallPrivateFunction(
505
+ async callPrivateFunction(
522
506
  targetContractAddress: AztecAddress,
523
507
  functionSelector: FunctionSelector,
524
508
  argsHash: Fr,
@@ -532,7 +516,7 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
532
516
  }
533
517
 
534
518
  const simulatorSetupTimer = new Timer();
535
- this.log.debug(
519
+ this.logger.debug(
536
520
  `Calling private function ${targetContractAddress}:${functionSelector} from ${this.callContext.contractAddress}`,
537
521
  );
538
522
 
@@ -544,6 +528,7 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
544
528
  this.utilityExecutor,
545
529
  this.anchorBlockHeader,
546
530
  this.jobId,
531
+ this.scopes,
547
532
  );
548
533
 
549
534
  const targetArtifact = await this.contractStore.getFunctionArtifactWithDebugMetadata(
@@ -555,41 +540,42 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
555
540
 
556
541
  const derivedCallContext = await this.deriveCallContext(targetContractAddress, targetArtifact, isStaticCall);
557
542
 
558
- const privateExecutionOracle = new PrivateExecutionOracle(
543
+ const privateExecutionOracle = new PrivateExecutionOracle({
559
544
  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.contractSyncService,
580
- this.jobId,
581
- this.totalPublicCalldataCount,
545
+ txContext: derivedTxContext,
546
+ callContext: derivedCallContext,
547
+ anchorBlockHeader: this.anchorBlockHeader,
548
+ utilityExecutor: this.utilityExecutor,
549
+ authWitnesses: this.authWitnesses,
550
+ capsules: this.capsules,
551
+ executionCache: this.executionCache,
552
+ noteCache: this.noteCache,
553
+ taggingIndexCache: this.taggingIndexCache,
554
+ contractStore: this.contractStore,
555
+ noteStore: this.noteStore,
556
+ keyStore: this.keyStore,
557
+ addressStore: this.addressStore,
558
+ aztecNode: this.aztecNode,
559
+ senderTaggingStore: this.senderTaggingStore,
560
+ recipientTaggingStore: this.recipientTaggingStore,
561
+ senderAddressBookStore: this.senderAddressBookStore,
562
+ capsuleStore: this.capsuleStore,
563
+ privateEventStore: this.privateEventStore,
564
+ messageContextService: this.messageContextService,
565
+ contractSyncService: this.contractSyncService,
566
+ jobId: this.jobId,
567
+ totalPublicCalldataCount: this.totalPublicCalldataCount,
582
568
  sideEffectCounter,
583
- this.log,
584
- this.scopes,
585
- this.senderForTags,
586
- this.simulator,
587
- );
569
+ log: this.logger,
570
+ scopes: this.scopes,
571
+ senderForTags: this.senderForTags,
572
+ simulator: this.simulator!,
573
+ });
588
574
 
589
575
  const setupTime = simulatorSetupTimer.ms();
590
576
 
591
577
  const childExecutionResult = await executePrivateFunction(
592
- this.simulator,
578
+ this.simulator!,
593
579
  privateExecutionOracle,
594
580
  targetArtifact,
595
581
  targetContractAddress,
@@ -615,7 +601,8 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
615
601
  };
616
602
  }
617
603
 
618
- #onNewPublicFunctionCall(calldataHash: Fr) {
604
+ /** Validates the calldata preimage exists in the cache and checks cumulative calldata size is within limits. */
605
+ public validatePublicCalldata(calldataHash: Fr) {
619
606
  const calldata = this.executionCache.getPreimage(calldataHash);
620
607
  if (!calldata) {
621
608
  throw new Error('Calldata for public call not found in cache');
@@ -625,47 +612,14 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
625
612
  if (this.totalPublicCalldataCount > MAX_FR_CALLDATA_TO_ALL_ENQUEUED_CALLS) {
626
613
  throw new Error(`Too many total args to all enqueued public calls! (> ${MAX_FR_CALLDATA_TO_ALL_ENQUEUED_CALLS})`);
627
614
  }
628
- }
629
-
630
- /**
631
- * Verify relevant information when a public function is enqueued.
632
- * @param targetContractAddress - The address of the contract to call.
633
- * @param calldataHash - The hash of the function selector and arguments.
634
- * @param sideEffectCounter - The side effect counter at the start of the call.
635
- * @param isStaticCall - Whether the call is a static call.
636
- */
637
- public privateNotifyEnqueuedPublicFunctionCall(
638
- _targetContractAddress: AztecAddress,
639
- calldataHash: Fr,
640
- _sideEffectCounter: number,
641
- _isStaticCall: boolean,
642
- ) {
643
- this.#onNewPublicFunctionCall(calldataHash);
644
615
  return Promise.resolve();
645
616
  }
646
617
 
647
- /**
648
- * Verify relevant information when a public teardown function is set.
649
- * @param targetContractAddress - The address of the contract to call.
650
- * @param argsHash - The arguments hash to pass to the function.
651
- * @param sideEffectCounter - The side effect counter at the start of the call.
652
- * @param isStaticCall - Whether the call is a static call.
653
- */
654
- public privateNotifySetPublicTeardownFunctionCall(
655
- _targetContractAddress: AztecAddress,
656
- calldataHash: Fr,
657
- _sideEffectCounter: number,
658
- _isStaticCall: boolean,
659
- ) {
660
- this.#onNewPublicFunctionCall(calldataHash);
661
- return Promise.resolve();
662
- }
663
-
664
- public privateNotifySetMinRevertibleSideEffectCounter(minRevertibleSideEffectCounter: number): Promise<void> {
618
+ public notifyRevertiblePhaseStart(minRevertibleSideEffectCounter: number): Promise<void> {
665
619
  return this.noteCache.setMinRevertibleSideEffectCounter(minRevertibleSideEffectCounter);
666
620
  }
667
621
 
668
- public privateIsSideEffectCounterRevertible(sideEffectCounter: number): Promise<boolean> {
622
+ public inRevertiblePhase(sideEffectCounter: number): Promise<boolean> {
669
623
  return Promise.resolve(this.noteCache.isSideEffectCounterRevertible(sideEffectCounter));
670
624
  }
671
625
 
@@ -692,9 +646,4 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
692
646
  public getDebugFunctionName() {
693
647
  return this.contractStore.getDebugFunctionName(this.contractAddress, this.callContext.functionSelector);
694
648
  }
695
-
696
- public utilityEmitOffchainEffect(data: Fr[]): Promise<void> {
697
- this.offchainEffects.push({ data });
698
- return Promise.resolve();
699
- }
700
649
  }