@aztec/pxe 0.0.1-commit.e558bd1c → 0.0.1-commit.e588bc7e5

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