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

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 (246) hide show
  1. package/dest/bin/check_oracle_version.js +4 -4
  2. package/dest/block_synchronizer/block_stream_source.d.ts +10 -0
  3. package/dest/block_synchronizer/block_stream_source.d.ts.map +1 -0
  4. package/dest/block_synchronizer/block_stream_source.js +37 -0
  5. package/dest/block_synchronizer/block_synchronizer.d.ts +6 -2
  6. package/dest/block_synchronizer/block_synchronizer.d.ts.map +1 -1
  7. package/dest/block_synchronizer/block_synchronizer.js +30 -10
  8. package/dest/config/index.d.ts +2 -2
  9. package/dest/config/index.d.ts.map +1 -1
  10. package/dest/config/index.js +8 -15
  11. package/dest/config/package_info.js +1 -1
  12. package/dest/contract_function_simulator/contract_function_simulator.d.ts +62 -30
  13. package/dest/contract_function_simulator/contract_function_simulator.d.ts.map +1 -1
  14. package/dest/contract_function_simulator/contract_function_simulator.js +206 -76
  15. package/dest/contract_function_simulator/ephemeral_array_service.d.ts +28 -0
  16. package/dest/contract_function_simulator/ephemeral_array_service.d.ts.map +1 -0
  17. package/dest/contract_function_simulator/ephemeral_array_service.js +78 -0
  18. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts +7 -7
  19. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts.map +1 -1
  20. package/dest/contract_function_simulator/execution_tagging_index_cache.js +19 -11
  21. package/dest/contract_function_simulator/index.d.ts +2 -1
  22. package/dest/contract_function_simulator/index.d.ts.map +1 -1
  23. package/dest/contract_function_simulator/index.js +1 -0
  24. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts +4 -6
  25. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts.map +1 -1
  26. package/dest/contract_function_simulator/noir-structs/event_validation_request.js +8 -10
  27. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.d.ts +1 -1
  28. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.js +1 -1
  29. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts +2 -2
  30. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts.map +1 -1
  31. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.js +2 -4
  32. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts +4 -7
  33. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts.map +1 -1
  34. package/dest/contract_function_simulator/noir-structs/note_validation_request.js +6 -11
  35. package/dest/contract_function_simulator/oracle/interfaces.d.ts +63 -45
  36. package/dest/contract_function_simulator/oracle/interfaces.d.ts.map +1 -1
  37. package/dest/contract_function_simulator/oracle/legacy_oracle_mappings.d.ts +9 -0
  38. package/dest/contract_function_simulator/oracle/legacy_oracle_mappings.d.ts.map +1 -0
  39. package/dest/contract_function_simulator/oracle/legacy_oracle_mappings.js +47 -0
  40. package/dest/contract_function_simulator/oracle/oracle.d.ts +76 -44
  41. package/dest/contract_function_simulator/oracle/oracle.d.ts.map +1 -1
  42. package/dest/contract_function_simulator/oracle/oracle.js +289 -97
  43. package/dest/contract_function_simulator/oracle/private_execution.js +5 -3
  44. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts +58 -86
  45. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts.map +1 -1
  46. package/dest/contract_function_simulator/oracle/private_execution_oracle.js +121 -95
  47. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts +124 -64
  48. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts.map +1 -1
  49. package/dest/contract_function_simulator/oracle/utility_execution_oracle.js +356 -126
  50. package/dest/contract_function_simulator/pick_notes.d.ts +1 -1
  51. package/dest/contract_function_simulator/pick_notes.d.ts.map +1 -1
  52. package/dest/contract_function_simulator/pick_notes.js +20 -3
  53. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts +1 -1
  54. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts.map +1 -1
  55. package/dest/contract_function_simulator/proxied_contract_data_source.js +3 -0
  56. package/dest/contract_logging.d.ts +27 -0
  57. package/dest/contract_logging.d.ts.map +1 -0
  58. package/dest/contract_logging.js +38 -0
  59. package/dest/contract_sync/contract_sync_service.d.ts +7 -4
  60. package/dest/contract_sync/contract_sync_service.d.ts.map +1 -1
  61. package/dest/contract_sync/contract_sync_service.js +69 -35
  62. package/dest/contract_sync/helpers.d.ts +2 -2
  63. package/dest/contract_sync/helpers.d.ts.map +1 -1
  64. package/dest/contract_sync/helpers.js +9 -4
  65. package/dest/debug/pxe_debug_utils.d.ts +5 -6
  66. package/dest/debug/pxe_debug_utils.d.ts.map +1 -1
  67. package/dest/debug/pxe_debug_utils.js +4 -7
  68. package/dest/entrypoints/client/bundle/index.d.ts +3 -1
  69. package/dest/entrypoints/client/bundle/index.d.ts.map +1 -1
  70. package/dest/entrypoints/client/bundle/index.js +2 -0
  71. package/dest/entrypoints/client/bundle/utils.d.ts +2 -2
  72. package/dest/entrypoints/client/bundle/utils.d.ts.map +1 -1
  73. package/dest/entrypoints/client/bundle/utils.js +11 -3
  74. package/dest/entrypoints/client/lazy/index.d.ts +3 -1
  75. package/dest/entrypoints/client/lazy/index.d.ts.map +1 -1
  76. package/dest/entrypoints/client/lazy/index.js +2 -0
  77. package/dest/entrypoints/client/lazy/utils.d.ts +2 -2
  78. package/dest/entrypoints/client/lazy/utils.d.ts.map +1 -1
  79. package/dest/entrypoints/client/lazy/utils.js +11 -3
  80. package/dest/entrypoints/pxe_creation_options.d.ts +3 -1
  81. package/dest/entrypoints/pxe_creation_options.d.ts.map +1 -1
  82. package/dest/entrypoints/pxe_creation_options.js +3 -1
  83. package/dest/entrypoints/server/index.d.ts +3 -2
  84. package/dest/entrypoints/server/index.d.ts.map +1 -1
  85. package/dest/entrypoints/server/index.js +2 -1
  86. package/dest/entrypoints/server/utils.d.ts +2 -2
  87. package/dest/entrypoints/server/utils.d.ts.map +1 -1
  88. package/dest/entrypoints/server/utils.js +11 -3
  89. package/dest/events/event_service.d.ts +3 -2
  90. package/dest/events/event_service.d.ts.map +1 -1
  91. package/dest/events/event_service.js +26 -5
  92. package/dest/events/private_event_filter_validator.d.ts +3 -2
  93. package/dest/events/private_event_filter_validator.d.ts.map +1 -1
  94. package/dest/events/private_event_filter_validator.js +15 -0
  95. package/dest/logs/log_service.d.ts +7 -7
  96. package/dest/logs/log_service.d.ts.map +1 -1
  97. package/dest/logs/log_service.js +33 -48
  98. package/dest/messages/message_context_service.d.ts +17 -0
  99. package/dest/messages/message_context_service.d.ts.map +1 -0
  100. package/dest/messages/message_context_service.js +36 -0
  101. package/dest/notes/note_service.d.ts +4 -4
  102. package/dest/notes/note_service.d.ts.map +1 -1
  103. package/dest/notes/note_service.js +17 -7
  104. package/dest/notes_filter.d.ts +24 -0
  105. package/dest/notes_filter.d.ts.map +1 -0
  106. package/dest/notes_filter.js +4 -0
  107. package/dest/oracle_version.d.ts +4 -3
  108. package/dest/oracle_version.d.ts.map +1 -1
  109. package/dest/oracle_version.js +20 -10
  110. package/dest/private_kernel/hints/compute_tx_expiration_timestamp.d.ts +4 -0
  111. package/dest/private_kernel/hints/compute_tx_expiration_timestamp.d.ts.map +1 -0
  112. package/dest/private_kernel/hints/{compute_tx_include_by_timestamp.js → compute_tx_expiration_timestamp.js} +12 -12
  113. package/dest/private_kernel/hints/index.d.ts +1 -1
  114. package/dest/private_kernel/hints/index.js +1 -1
  115. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts +4 -3
  116. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts.map +1 -1
  117. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.js +129 -68
  118. package/dest/private_kernel/hints/test_utils.d.ts +122 -0
  119. package/dest/private_kernel/hints/test_utils.d.ts.map +1 -0
  120. package/dest/private_kernel/hints/test_utils.js +203 -0
  121. package/dest/private_kernel/private_kernel_execution_prover.d.ts +1 -1
  122. package/dest/private_kernel/private_kernel_execution_prover.d.ts.map +1 -1
  123. package/dest/private_kernel/private_kernel_execution_prover.js +18 -13
  124. package/dest/private_kernel/private_kernel_oracle.d.ts +10 -6
  125. package/dest/private_kernel/private_kernel_oracle.d.ts.map +1 -1
  126. package/dest/private_kernel/private_kernel_oracle.js +19 -18
  127. package/dest/pxe.d.ts +84 -24
  128. package/dest/pxe.d.ts.map +1 -1
  129. package/dest/pxe.js +153 -83
  130. package/dest/storage/anchor_block_store/anchor_block_store.js +1 -1
  131. package/dest/storage/capsule_store/capsule_service.d.ts +21 -0
  132. package/dest/storage/capsule_store/capsule_service.d.ts.map +1 -0
  133. package/dest/storage/capsule_store/capsule_service.js +50 -0
  134. package/dest/storage/capsule_store/capsule_store.d.ts +9 -9
  135. package/dest/storage/capsule_store/capsule_store.d.ts.map +1 -1
  136. package/dest/storage/capsule_store/capsule_store.js +36 -28
  137. package/dest/storage/capsule_store/index.d.ts +2 -1
  138. package/dest/storage/capsule_store/index.d.ts.map +1 -1
  139. package/dest/storage/capsule_store/index.js +1 -0
  140. package/dest/storage/contract_store/contract_store.d.ts +42 -15
  141. package/dest/storage/contract_store/contract_store.d.ts.map +1 -1
  142. package/dest/storage/contract_store/contract_store.js +148 -70
  143. package/dest/storage/metadata.d.ts +1 -1
  144. package/dest/storage/metadata.js +1 -1
  145. package/dest/storage/note_store/note_store.d.ts +3 -3
  146. package/dest/storage/note_store/note_store.d.ts.map +1 -1
  147. package/dest/storage/note_store/note_store.js +3 -4
  148. package/dest/storage/private_event_store/private_event_store.d.ts +1 -1
  149. package/dest/storage/private_event_store/private_event_store.d.ts.map +1 -1
  150. package/dest/storage/private_event_store/private_event_store.js +3 -0
  151. package/dest/storage/private_event_store/stored_private_event.js +1 -1
  152. package/dest/storage/tagging_store/recipient_tagging_store.d.ts +6 -6
  153. package/dest/storage/tagging_store/recipient_tagging_store.d.ts.map +1 -1
  154. package/dest/storage/tagging_store/sender_tagging_store.d.ts +29 -28
  155. package/dest/storage/tagging_store/sender_tagging_store.d.ts.map +1 -1
  156. package/dest/storage/tagging_store/sender_tagging_store.js +141 -115
  157. package/dest/tagging/get_all_logs_by_tags.d.ts +1 -1
  158. package/dest/tagging/get_all_logs_by_tags.d.ts.map +1 -1
  159. package/dest/tagging/get_all_logs_by_tags.js +17 -3
  160. package/dest/tagging/index.d.ts +3 -3
  161. package/dest/tagging/index.d.ts.map +1 -1
  162. package/dest/tagging/index.js +1 -1
  163. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts +4 -5
  164. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts.map +1 -1
  165. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.js +8 -22
  166. package/dest/tagging/recipient_sync/utils/find_highest_indexes.js +2 -2
  167. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts +6 -7
  168. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts.map +1 -1
  169. package/dest/tagging/recipient_sync/utils/load_logs_for_range.js +12 -11
  170. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts +4 -8
  171. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts.map +1 -1
  172. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.js +13 -7
  173. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts +4 -3
  174. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts.map +1 -1
  175. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.js +20 -10
  176. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts +5 -7
  177. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts.map +1 -1
  178. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.js +36 -24
  179. package/package.json +16 -16
  180. package/src/bin/check_oracle_version.ts +4 -4
  181. package/src/block_synchronizer/block_stream_source.ts +52 -0
  182. package/src/block_synchronizer/block_synchronizer.ts +33 -11
  183. package/src/config/index.ts +3 -9
  184. package/src/config/package_info.ts +1 -1
  185. package/src/contract_function_simulator/contract_function_simulator.ts +366 -138
  186. package/src/contract_function_simulator/ephemeral_array_service.ts +110 -0
  187. package/src/contract_function_simulator/execution_tagging_index_cache.ts +19 -14
  188. package/src/contract_function_simulator/index.ts +1 -0
  189. package/src/contract_function_simulator/noir-structs/event_validation_request.ts +9 -9
  190. package/src/contract_function_simulator/noir-structs/log_retrieval_request.ts +1 -1
  191. package/src/contract_function_simulator/noir-structs/log_retrieval_response.ts +2 -5
  192. package/src/contract_function_simulator/noir-structs/note_validation_request.ts +4 -10
  193. package/src/contract_function_simulator/oracle/interfaces.ts +91 -53
  194. package/src/contract_function_simulator/oracle/legacy_oracle_mappings.ts +104 -0
  195. package/src/contract_function_simulator/oracle/oracle.ts +378 -140
  196. package/src/contract_function_simulator/oracle/private_execution.ts +4 -4
  197. package/src/contract_function_simulator/oracle/private_execution_oracle.ts +151 -183
  198. package/src/contract_function_simulator/oracle/utility_execution_oracle.ts +598 -156
  199. package/src/contract_function_simulator/pick_notes.ts +22 -3
  200. package/src/contract_function_simulator/proxied_contract_data_source.ts +8 -1
  201. package/src/contract_logging.ts +52 -0
  202. package/src/contract_sync/contract_sync_service.ts +102 -55
  203. package/src/contract_sync/helpers.ts +8 -3
  204. package/src/debug/pxe_debug_utils.ts +11 -14
  205. package/src/entrypoints/client/bundle/index.ts +2 -0
  206. package/src/entrypoints/client/bundle/utils.ts +11 -4
  207. package/src/entrypoints/client/lazy/index.ts +2 -0
  208. package/src/entrypoints/client/lazy/utils.ts +11 -4
  209. package/src/entrypoints/pxe_creation_options.ts +7 -0
  210. package/src/entrypoints/server/index.ts +2 -1
  211. package/src/entrypoints/server/utils.ts +9 -10
  212. package/src/events/event_service.ts +30 -5
  213. package/src/events/private_event_filter_validator.ts +21 -1
  214. package/src/logs/log_service.ts +63 -91
  215. package/src/messages/message_context_service.ts +44 -0
  216. package/src/notes/note_service.ts +19 -8
  217. package/src/notes_filter.ts +24 -0
  218. package/src/oracle_version.ts +20 -10
  219. package/src/private_kernel/hints/{compute_tx_include_by_timestamp.ts → compute_tx_expiration_timestamp.ts} +13 -13
  220. package/src/private_kernel/hints/index.ts +1 -1
  221. package/src/private_kernel/hints/private_kernel_reset_private_inputs_builder.ts +164 -117
  222. package/src/private_kernel/hints/test_utils.ts +325 -0
  223. package/src/private_kernel/private_kernel_execution_prover.ts +18 -16
  224. package/src/private_kernel/private_kernel_oracle.ts +21 -21
  225. package/src/pxe.ts +278 -131
  226. package/src/storage/anchor_block_store/anchor_block_store.ts +1 -1
  227. package/src/storage/capsule_store/capsule_service.ts +90 -0
  228. package/src/storage/capsule_store/capsule_store.ts +44 -26
  229. package/src/storage/capsule_store/index.ts +1 -0
  230. package/src/storage/contract_store/contract_store.ts +181 -80
  231. package/src/storage/metadata.ts +1 -1
  232. package/src/storage/note_store/note_store.ts +5 -5
  233. package/src/storage/private_event_store/private_event_store.ts +4 -0
  234. package/src/storage/private_event_store/stored_private_event.ts +1 -1
  235. package/src/storage/tagging_store/recipient_tagging_store.ts +9 -5
  236. package/src/storage/tagging_store/sender_tagging_store.ts +185 -138
  237. package/src/tagging/get_all_logs_by_tags.ts +28 -4
  238. package/src/tagging/index.ts +2 -2
  239. package/src/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.ts +12 -25
  240. package/src/tagging/recipient_sync/utils/find_highest_indexes.ts +2 -2
  241. package/src/tagging/recipient_sync/utils/load_logs_for_range.ts +10 -15
  242. package/src/tagging/sender_sync/sync_sender_tagging_indexes.ts +23 -10
  243. package/src/tagging/sender_sync/utils/get_status_change_of_pending.ts +26 -11
  244. package/src/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.ts +27 -26
  245. package/dest/private_kernel/hints/compute_tx_include_by_timestamp.d.ts +0 -4
  246. package/dest/private_kernel/hints/compute_tx_include_by_timestamp.d.ts.map +0 -1
@@ -6,7 +6,7 @@ import { toACVMWitness } from '@aztec/simulator/client';
6
6
  import { FunctionSelector, countArgumentsSize } from '@aztec/stdlib/abi';
7
7
  import { siloNullifier } from '@aztec/stdlib/hash';
8
8
  import { PrivateContextInputs } from '@aztec/stdlib/kernel';
9
- import { DirectionalAppTaggingSecret } from '@aztec/stdlib/logs';
9
+ import { ExtendedDirectionalAppTaggingSecret } from '@aztec/stdlib/logs';
10
10
  import { Tag } from '@aztec/stdlib/logs';
11
11
  import { Note } from '@aztec/stdlib/note';
12
12
  import { CallContext, CountedContractClassLog, NoteAndSlot } from '@aztec/stdlib/tx';
@@ -18,38 +18,50 @@ import { UtilityExecutionOracle } from './utility_execution_oracle.js';
18
18
  /**
19
19
  * The execution oracle for the private part of a transaction.
20
20
  */ export class PrivateExecutionOracle extends UtilityExecutionOracle {
21
+ isPrivate = true;
22
+ /**
23
+ * New notes created during this execution.
24
+ * It's possible that a note in this list has been nullified (in the same or other executions) and doesn't exist in
25
+ * the ExecutionNoteCache and the final proof data. But we still include those notes in the execution result because
26
+ * their commitments are still in the public inputs of this execution.
27
+ * This information is only for references (currently used for tests), and is not used for any sort of constrains.
28
+ * Users can also use this to get a clearer idea of what's happened during a simulation.
29
+ */ newNotes = [];
30
+ noteHashNullifierCounterMap = new Map();
31
+ contractClassLogs = [];
32
+ nestedExecutionResults = [];
21
33
  argsHash;
22
34
  txContext;
23
35
  callContext;
24
- anchorBlockHeader;
25
36
  utilityExecutor;
26
37
  executionCache;
27
38
  noteCache;
28
39
  taggingIndexCache;
29
40
  senderTaggingStore;
30
- contractSyncService;
31
41
  totalPublicCalldataCount;
32
- sideEffectCounter;
33
- senderForTags;
34
- simulator;
35
- isPrivate;
36
- /**
37
- * New notes created during this execution.
38
- * It's possible that a note in this list has been nullified (in the same or other executions) and doesn't exist in
39
- * the ExecutionNoteCache and the final proof data. But we still include those notes in the execution result because
40
- * their commitments are still in the public inputs of this execution.
41
- * This information is only for references (currently used for tests), and is not used for any sort of constrains.
42
- * Users can also use this to get a clearer idea of what's happened during a simulation.
43
- */ newNotes;
44
- noteHashNullifierCounterMap;
45
- contractClassLogs;
46
- offchainEffects;
47
- nestedExecutionResults;
48
- constructor(argsHash, txContext, callContext, /** Header of a block whose state is used during private execution (not the block the transaction is included in). */ anchorBlockHeader, /** Needed to trigger contract synchronization before nested calls */ utilityExecutor, /** List of transient auth witnesses to be used during this simulation */ authWitnesses, capsules, executionCache, noteCache, taggingIndexCache, contractStore, noteStore, keyStore, addressStore, aztecNode, senderTaggingStore, recipientTaggingStore, senderAddressBookStore, capsuleStore, privateEventStore, contractSyncService, jobId, totalPublicCalldataCount = 0, sideEffectCounter = 0, log = createLogger('simulator:client_execution_context'), scopes, senderForTags, simulator){
49
- super(callContext.contractAddress, authWitnesses, capsules, anchorBlockHeader, contractStore, noteStore, keyStore, addressStore, aztecNode, recipientTaggingStore, senderAddressBookStore, capsuleStore, privateEventStore, jobId, log, scopes), this.argsHash = argsHash, this.txContext = txContext, this.callContext = callContext, this.anchorBlockHeader = anchorBlockHeader, this.utilityExecutor = utilityExecutor, this.executionCache = executionCache, this.noteCache = noteCache, this.taggingIndexCache = taggingIndexCache, this.senderTaggingStore = senderTaggingStore, this.contractSyncService = contractSyncService, this.totalPublicCalldataCount = totalPublicCalldataCount, this.sideEffectCounter = sideEffectCounter, this.senderForTags = senderForTags, this.simulator = simulator, this.isPrivate = true, this.newNotes = [], this.noteHashNullifierCounterMap = new Map(), this.contractClassLogs = [], this.offchainEffects = [], this.nestedExecutionResults = [];
42
+ initialSideEffectCounter;
43
+ /** Sender for tags passed in at oracle construction time. Returned by `getSenderForTags` unless overridden. */ defaultSenderForTags;
44
+ /** Per-call sender-for-tags override, set by `setSenderForTags`. Takes precedence over `defaultSenderForTags`. */ currentSenderForTags;
45
+ constructor(args){
46
+ super({
47
+ ...args,
48
+ contractAddress: args.callContext.contractAddress,
49
+ log: args.log ?? createLogger('simulator:client_execution_context')
50
+ });
51
+ this.argsHash = args.argsHash;
52
+ this.txContext = args.txContext;
53
+ this.callContext = args.callContext;
54
+ this.utilityExecutor = args.utilityExecutor;
55
+ this.executionCache = args.executionCache;
56
+ this.noteCache = args.noteCache;
57
+ this.taggingIndexCache = args.taggingIndexCache;
58
+ this.senderTaggingStore = args.senderTaggingStore;
59
+ this.totalPublicCalldataCount = args.totalPublicCalldataCount ?? 0;
60
+ this.initialSideEffectCounter = args.sideEffectCounter ?? 0;
61
+ this.defaultSenderForTags = args.senderForTags;
50
62
  }
51
63
  getPrivateContextInputs() {
52
- return new PrivateContextInputs(this.callContext, this.anchorBlockHeader, this.txContext, this.sideEffectCounter);
64
+ return new PrivateContextInputs(this.callContext, this.anchorBlockHeader, this.txContext, this.initialSideEffectCounter);
53
65
  }
54
66
  // We still need this function until we can get user-defined ordering of structs for fn arguments
55
67
  // TODO When that is sorted out on noir side, we can use instead the utilities in serialize.ts
@@ -87,14 +99,9 @@ import { UtilityExecutionOracle } from './utility_execution_oracle.js';
87
99
  return this.contractClassLogs;
88
100
  }
89
101
  /**
90
- * Return the offchain effects emitted during this execution.
91
- */ getOffchainEffects() {
92
- return this.offchainEffects;
93
- }
94
- /**
95
- * Returns the pre-tags that were used in this execution (and that need to be stored in the db).
96
- */ getUsedPreTags() {
97
- return this.taggingIndexCache.getUsedPreTags();
102
+ * Returns the tagging index ranges that were used in this execution (and that need to be stored in the db).
103
+ */ getUsedTaggingIndexRanges() {
104
+ return this.taggingIndexCache.getUsedTaggingIndexRanges();
98
105
  }
99
106
  /**
100
107
  * Return the nested execution results during this execution.
@@ -108,10 +115,9 @@ import { UtilityExecutionOracle } from './utility_execution_oracle.js';
108
115
  * for a tag in order to emit a log. Constrained tagging should not use this as there is no
109
116
  * guarantee that the recipient knows about the sender, and hence about the shared secret.
110
117
  *
111
- * The value persists through nested calls, meaning all calls down the stack will use the same
112
- * 'senderForTags' value (unless it is replaced).
113
- */ privateGetSenderForTags() {
114
- return Promise.resolve(this.senderForTags);
118
+ * Returns `currentSenderForTags` if set (via `setSenderForTags`), otherwise `defaultSenderForTags`.
119
+ */ getSenderForTags() {
120
+ return Promise.resolve(this.currentSenderForTags ?? this.defaultSenderForTags);
115
121
  }
116
122
  /**
117
123
  * Set the sender for tags.
@@ -120,11 +126,11 @@ import { UtilityExecutionOracle } from './utility_execution_oracle.js';
120
126
  * for a tag in order to emit a log. Constrained tagging should not use this as there is no
121
127
  * guarantee that the recipient knows about the sender, and hence about the shared secret.
122
128
  *
123
- * Account contracts typically set this value before calling other contracts. The value persists
124
- * through nested calls, meaning all calls down the stack will use the same 'senderForTags'
125
- * value (unless it is replaced by another call to this setter).
126
- */ privateSetSenderForTags(senderForTags) {
127
- this.senderForTags = senderForTags;
129
+ * Overrides `defaultSenderForTags` for the remainder of this call. Each oracle instance is
130
+ * independent, so this has no effect on any other call in the execution.
131
+ */ setSenderForTags(senderForTags) {
132
+ this.logger.debug(`Sender for tags switched to ${senderForTags} by contract ${this.contractAddress} (default was ${this.defaultSenderForTags})`);
133
+ this.currentSenderForTags = senderForTags;
128
134
  return Promise.resolve();
129
135
  }
130
136
  /**
@@ -132,20 +138,29 @@ import { UtilityExecutionOracle } from './utility_execution_oracle.js';
132
138
  * @param sender - The address sending the log
133
139
  * @param recipient - The address receiving the log
134
140
  * @returns An app tag to be used in a log.
135
- */ async privateGetNextAppTagAsSender(sender, recipient) {
136
- const secret = await this.#calculateDirectionalAppTaggingSecret(this.contractAddress, sender, recipient);
137
- const index = await this.#getIndexToUseForSecret(secret);
138
- this.log.debug(`Incrementing tagging index for sender: ${sender}, recipient: ${recipient}, contract: ${this.contractAddress} to ${index}`);
139
- this.taggingIndexCache.setLastUsedIndex(secret, index);
141
+ */ async getNextAppTagAsSender(sender, recipient) {
142
+ const extendedSecret = await this.#calculateExtendedDirectionalAppTaggingSecret(this.contractAddress, sender, recipient);
143
+ if (!extendedSecret) {
144
+ // We'd only fail to compute an extended secret if the recipient is an invalid address. To prevent
145
+ // king-of-the-hill attacks, instead of failing we use a random tag. By including a correct-looking tag in the
146
+ // log, the transaction shape is preserved and no privacy is leaked, even if the tag is bogus.
147
+ this.logger.warn(`Computing a tag for invalid recipient ${recipient} - returning a random tag instead`, {
148
+ contractAddress: this.contractAddress
149
+ });
150
+ return Tag.random();
151
+ }
152
+ const index = await this.#getIndexToUseForSecret(extendedSecret);
153
+ this.logger.debug(`Incrementing tagging index for sender: ${sender}, recipient: ${recipient}, contract: ${this.contractAddress} to ${index}`);
154
+ this.taggingIndexCache.setLastUsedIndex(extendedSecret, index);
140
155
  return Tag.compute({
141
- secret,
156
+ extendedSecret,
142
157
  index
143
158
  });
144
159
  }
145
- async #calculateDirectionalAppTaggingSecret(contractAddress, sender, recipient) {
160
+ async #calculateExtendedDirectionalAppTaggingSecret(contractAddress, sender, recipient) {
146
161
  const senderCompleteAddress = await this.getCompleteAddressOrFail(sender);
147
162
  const senderIvsk = await this.keyStore.getMasterIncomingViewingSecretKey(sender);
148
- return DirectionalAppTaggingSecret.compute(senderCompleteAddress, senderIvsk, recipient, contractAddress, recipient);
163
+ return ExtendedDirectionalAppTaggingSecret.compute(senderCompleteAddress, senderIvsk, recipient, contractAddress, recipient);
149
164
  }
150
165
  async #getIndexToUseForSecret(secret) {
151
166
  // If we have the tagging index in the cache, we use it. If not we obtain it from the execution data provider.
@@ -156,7 +171,7 @@ import { UtilityExecutionOracle } from './utility_execution_oracle.js';
156
171
  // This is a tagging secret we've not yet used in this tx, so first sync our store to make sure its indices
157
172
  // are up to date. We do this here because this store is not synced as part of the global sync because
158
173
  // that'd be wasteful as most tagging secrets are not used in each tx.
159
- await syncSenderTaggingIndexes(secret, this.contractAddress, this.aztecNode, this.senderTaggingStore, await this.anchorBlockHeader.hash(), this.jobId);
174
+ await syncSenderTaggingIndexes(secret, this.aztecNode, this.senderTaggingStore, await this.anchorBlockHeader.hash(), this.jobId);
160
175
  const lastUsedIndex = await this.senderTaggingStore.getLastUsedIndex(secret, this.jobId);
161
176
  // If lastUsedIndex is undefined, we've never used this secret, so start from 0
162
177
  // Otherwise, the next index to use is one past the last used index
@@ -167,29 +182,29 @@ import { UtilityExecutionOracle } from './utility_execution_oracle.js';
167
182
  * Store values in the execution cache.
168
183
  * @param values - Values to store.
169
184
  * @returns The hash of the values.
170
- */ privateStoreInExecutionCache(values, hash) {
185
+ */ setHashPreimage(values, hash) {
171
186
  return this.executionCache.store(values, hash);
172
187
  }
173
188
  /**
174
189
  * Gets values from the execution cache.
175
190
  * @param hash - Hash of the values.
176
191
  * @returns The values.
177
- */ privateLoadFromExecutionCache(hash) {
192
+ */ getHashPreimage(hash) {
178
193
  const preimage = this.executionCache.getPreimage(hash);
179
194
  if (!preimage) {
180
195
  throw new Error(`Preimage for hash ${hash.toString()} not found in cache`);
181
196
  }
182
197
  return Promise.resolve(preimage);
183
198
  }
184
- async utilityCheckNullifierExists(innerNullifier) {
199
+ async doesNullifierExist(innerNullifier) {
185
200
  // This oracle must be overridden because while utility execution can only meaningfully check if a nullifier exists
186
201
  // in the synched block, during private execution there's also the possibility of it being pending, i.e. created
187
202
  // in the current transaction.
188
- this.log.debug(`Checking existence of inner nullifier ${innerNullifier}`, {
203
+ this.logger.debug(`Checking existence of inner nullifier ${innerNullifier}`, {
189
204
  contractAddress: this.contractAddress
190
205
  });
191
206
  const nullifier = (await siloNullifier(this.contractAddress, innerNullifier)).toBigInt();
192
- return this.noteCache.getNullifiers(this.contractAddress).has(nullifier) || await super.utilityCheckNullifierExists(innerNullifier);
207
+ return this.noteCache.getNullifiers(this.contractAddress).has(nullifier) || await super.doesNullifierExist(innerNullifier);
193
208
  }
194
209
  /**
195
210
  * Gets some notes for a storage slot.
@@ -211,7 +226,7 @@ import { UtilityExecutionOracle } from './utility_execution_oracle.js';
211
226
  * @param offset - The starting index for pagination.
212
227
  * @param status - The status of notes to fetch.
213
228
  * @returns Array of note data.
214
- */ async utilityGetNotes(owner, storageSlot, numSelects, selectByIndexes, selectByOffsets, selectByLengths, selectValues, selectComparators, sortByIndexes, sortByOffsets, sortByLengths, sortOrder, limit, offset, status) {
229
+ */ async getNotes(owner, storageSlot, numSelects, selectByIndexes, selectByOffsets, selectByLengths, selectValues, selectComparators, sortByIndexes, sortByOffsets, sortByLengths, sortOrder, limit, offset, status) {
215
230
  // Nullified pending notes are already removed from the list.
216
231
  const pendingNotes = this.noteCache.getNotes(this.callContext.contractAddress, owner, storageSlot);
217
232
  const pendingNullifiers = this.noteCache.getNullifiers(this.callContext.contractAddress);
@@ -242,7 +257,7 @@ import { UtilityExecutionOracle } from './utility_execution_oracle.js';
242
257
  limit,
243
258
  offset
244
259
  });
245
- this.log.debug(`Returning ${notes.length} notes for ${this.callContext.contractAddress} at ${storageSlot}: ${notes.map((n)=>`${n.noteNonce.toString()}:[${n.note.items.map((i)=>i.toString()).join(',')}]`).join(', ')}`);
260
+ this.logger.debug(`Returning ${notes.length} notes for ${this.callContext.contractAddress} at ${storageSlot}: ${notes.map((n)=>`${n.noteNonce.toString()}:[${n.note.items.map((i)=>i.toString()).join(',')}]`).join(', ')}`);
246
261
  return notes;
247
262
  }
248
263
  /**
@@ -255,8 +270,8 @@ import { UtilityExecutionOracle } from './utility_execution_oracle.js';
255
270
  * @param noteItems - The items to be included in a Note.
256
271
  * @param noteHash - A hash of the new note.
257
272
  * @returns
258
- */ privateNotifyCreatedNote(owner, storageSlot, randomness, noteTypeId, noteItems, noteHash, counter) {
259
- this.log.debug(`Notified of new note with inner hash ${noteHash}`, {
273
+ */ notifyCreatedNote(owner, storageSlot, randomness, noteTypeId, noteItems, noteHash, counter) {
274
+ this.logger.debug(`Notified of new note with inner hash ${noteHash}`, {
260
275
  contractAddress: this.callContext.contractAddress,
261
276
  storageSlot,
262
277
  randomness,
@@ -287,7 +302,7 @@ import { UtilityExecutionOracle } from './utility_execution_oracle.js';
287
302
  * within the current transaction/execution.
288
303
  * @param innerNullifier - The pending nullifier to add in the list (not yet siloed by contract address).
289
304
  * @param noteHash - A hash of the new note.
290
- */ async privateNotifyNullifiedNote(innerNullifier, noteHash, counter) {
305
+ */ async notifyNullifiedNote(innerNullifier, noteHash, counter) {
291
306
  const nullifiedNoteHashCounter = await this.noteCache.nullifyNote(this.callContext.contractAddress, innerNullifier, noteHash);
292
307
  if (nullifiedNoteHashCounter !== undefined) {
293
308
  this.noteHashNullifierCounterMap.set(nullifiedNoteHashCounter, counter);
@@ -298,19 +313,19 @@ import { UtilityExecutionOracle } from './utility_execution_oracle.js';
298
313
  * within the current transaction/execution.
299
314
  * @param innerNullifier - The pending nullifier to add in the list (not yet siloed by contract address).
300
315
  * @param noteHash - A hash of the new note.
301
- */ privateNotifyCreatedNullifier(innerNullifier) {
302
- this.log.debug(`Notified of new inner nullifier ${innerNullifier}`, {
316
+ */ notifyCreatedNullifier(innerNullifier) {
317
+ this.logger.debug(`Notified of new inner nullifier ${innerNullifier}`, {
303
318
  contractAddress: this.contractAddress
304
319
  });
305
320
  return this.noteCache.nullifierCreated(this.callContext.contractAddress, innerNullifier);
306
321
  }
307
322
  /**
308
- * Check if a nullifier has been emitted in the same transaction, i.e. if privateNotifyCreatedNullifier has been
323
+ * Check if a nullifier has been emitted in the same transaction, i.e. if notifyCreatedNullifier has been
309
324
  * called for this inner nullifier from the contract with the specified address.
310
325
  * @param innerNullifier - The inner nullifier to check.
311
326
  * @param contractAddress - Address of the contract that emitted the nullifier.
312
327
  * @returns A boolean indicating whether the nullifier is pending or not.
313
- */ async privateIsNullifierPending(innerNullifier, contractAddress) {
328
+ */ async isNullifierPending(innerNullifier, contractAddress) {
314
329
  const siloedNullifier = await siloNullifier(contractAddress, innerNullifier);
315
330
  const isNullifierPending = this.noteCache.getNullifiers(contractAddress).has(siloedNullifier.toBigInt());
316
331
  return Promise.resolve(isNullifierPending);
@@ -321,10 +336,10 @@ import { UtilityExecutionOracle } from './utility_execution_oracle.js';
321
336
  * keep the preimage in ts for later.
322
337
  * @param log - The contract class log to be emitted.
323
338
  * @param counter - The contract class log's counter.
324
- */ privateNotifyCreatedContractClassLog(log, counter) {
339
+ */ notifyCreatedContractClassLog(log, counter) {
325
340
  this.contractClassLogs.push(new CountedContractClassLog(log, counter));
326
341
  const text = log.toBuffer().toString('hex');
327
- this.log.verbose(`Emitted log from ContractClassRegistry: "${text.length > 100 ? text.slice(0, 100) + '...' : text}"`);
342
+ this.logger.verbose(`Emitted log from ContractClassRegistry: "${text.length > 100 ? text.slice(0, 100) + '...' : text}"`);
328
343
  }
329
344
  #checkValidStaticCall(childExecutionResult) {
330
345
  if (childExecutionResult.publicInputs.noteHashes.claimedLength > 0 || childExecutionResult.publicInputs.nullifiers.claimedLength > 0 || childExecutionResult.publicInputs.l2ToL1Msgs.claimedLength > 0 || childExecutionResult.publicInputs.privateLogs.claimedLength > 0 || childExecutionResult.publicInputs.contractClassLogsHashes.claimedLength > 0) {
@@ -339,22 +354,55 @@ import { UtilityExecutionOracle } from './utility_execution_oracle.js';
339
354
  * @param sideEffectCounter - The side effect counter at the start of the call.
340
355
  * @param isStaticCall - Whether the call is a static call.
341
356
  * @returns The execution result.
342
- */ async privateCallPrivateFunction(targetContractAddress, functionSelector, argsHash, sideEffectCounter, isStaticCall) {
357
+ */ async callPrivateFunction(targetContractAddress, functionSelector, argsHash, sideEffectCounter, isStaticCall) {
343
358
  if (!this.simulator) {
344
359
  // In practice it is only when creating inline private contexts in a Noir test using TXE that we create an
345
360
  // instance of this class without a simulator.
346
361
  throw new Error('No simulator provided, cannot perform a nested private call');
347
362
  }
348
363
  const simulatorSetupTimer = new Timer();
349
- this.log.debug(`Calling private function ${targetContractAddress}:${functionSelector} from ${this.callContext.contractAddress}`);
364
+ this.logger.debug(`Calling private function ${targetContractAddress}:${functionSelector} from ${this.callContext.contractAddress}`);
350
365
  isStaticCall = isStaticCall || this.callContext.isStaticCall;
351
- await this.contractSyncService.ensureContractSynced(targetContractAddress, functionSelector, this.utilityExecutor, this.anchorBlockHeader, this.jobId);
366
+ await this.contractSyncService.ensureContractSynced(targetContractAddress, functionSelector, this.utilityExecutor, this.anchorBlockHeader, this.jobId, this.scopes);
352
367
  const targetArtifact = await this.contractStore.getFunctionArtifactWithDebugMetadata(targetContractAddress, functionSelector);
353
368
  const derivedTxContext = this.txContext.clone();
354
369
  const derivedCallContext = await this.deriveCallContext(targetContractAddress, targetArtifact, isStaticCall);
355
- const privateExecutionOracle = new PrivateExecutionOracle(argsHash, derivedTxContext, derivedCallContext, this.anchorBlockHeader, this.utilityExecutor, this.authWitnesses, this.capsules, this.executionCache, this.noteCache, this.taggingIndexCache, this.contractStore, this.noteStore, this.keyStore, this.addressStore, this.aztecNode, this.senderTaggingStore, this.recipientTaggingStore, this.senderAddressBookStore, this.capsuleStore, this.privateEventStore, this.contractSyncService, this.jobId, this.totalPublicCalldataCount, sideEffectCounter, this.log, this.scopes, this.senderForTags, this.simulator);
370
+ const privateExecutionOracle = new PrivateExecutionOracle({
371
+ argsHash,
372
+ txContext: derivedTxContext,
373
+ callContext: derivedCallContext,
374
+ anchorBlockHeader: this.anchorBlockHeader,
375
+ utilityExecutor: this.utilityExecutor,
376
+ authWitnesses: this.authWitnesses,
377
+ capsules: this.capsules,
378
+ executionCache: this.executionCache,
379
+ noteCache: this.noteCache,
380
+ taggingIndexCache: this.taggingIndexCache,
381
+ contractStore: this.contractStore,
382
+ noteStore: this.noteStore,
383
+ keyStore: this.keyStore,
384
+ addressStore: this.addressStore,
385
+ aztecNode: this.aztecNode,
386
+ senderTaggingStore: this.senderTaggingStore,
387
+ recipientTaggingStore: this.recipientTaggingStore,
388
+ senderAddressBookStore: this.senderAddressBookStore,
389
+ capsuleService: this.capsuleService,
390
+ privateEventStore: this.privateEventStore,
391
+ messageContextService: this.messageContextService,
392
+ contractSyncService: this.contractSyncService,
393
+ jobId: this.jobId,
394
+ totalPublicCalldataCount: this.totalPublicCalldataCount,
395
+ sideEffectCounter,
396
+ log: this.logger,
397
+ scopes: this.scopes,
398
+ senderForTags: this.defaultSenderForTags,
399
+ simulator: this.simulator,
400
+ l2TipsStore: this.l2TipsStore
401
+ });
356
402
  const setupTime = simulatorSetupTimer.ms();
357
403
  const childExecutionResult = await executePrivateFunction(this.simulator, privateExecutionOracle, targetArtifact, targetContractAddress, functionSelector);
404
+ // Propagate the nested call's calldata count so the parent sees its increments on subsequent enqueues.
405
+ this.totalPublicCalldataCount = privateExecutionOracle.getTotalPublicCalldataCount();
358
406
  if (isStaticCall) {
359
407
  this.#checkValidStaticCall(childExecutionResult);
360
408
  }
@@ -369,7 +417,7 @@ import { UtilityExecutionOracle } from './utility_execution_oracle.js';
369
417
  returnsHash: publicInputs.returnsHash
370
418
  };
371
419
  }
372
- #onNewPublicFunctionCall(calldataHash) {
420
+ /** Validates the calldata preimage exists in the cache and checks cumulative calldata size is within limits. */ assertValidPublicCalldata(calldataHash) {
373
421
  const calldata = this.executionCache.getPreimage(calldataHash);
374
422
  if (!calldata) {
375
423
  throw new Error('Calldata for public call not found in cache');
@@ -378,31 +426,15 @@ import { UtilityExecutionOracle } from './utility_execution_oracle.js';
378
426
  if (this.totalPublicCalldataCount > MAX_FR_CALLDATA_TO_ALL_ENQUEUED_CALLS) {
379
427
  throw new Error(`Too many total args to all enqueued public calls! (> ${MAX_FR_CALLDATA_TO_ALL_ENQUEUED_CALLS})`);
380
428
  }
381
- }
382
- /**
383
- * Verify relevant information when a public function is enqueued.
384
- * @param targetContractAddress - The address of the contract to call.
385
- * @param calldataHash - The hash of the function selector and arguments.
386
- * @param sideEffectCounter - The side effect counter at the start of the call.
387
- * @param isStaticCall - Whether the call is a static call.
388
- */ privateNotifyEnqueuedPublicFunctionCall(_targetContractAddress, calldataHash, _sideEffectCounter, _isStaticCall) {
389
- this.#onNewPublicFunctionCall(calldataHash);
390
429
  return Promise.resolve();
391
430
  }
392
- /**
393
- * Verify relevant information when a public teardown function is set.
394
- * @param targetContractAddress - The address of the contract to call.
395
- * @param argsHash - The arguments hash to pass to the function.
396
- * @param sideEffectCounter - The side effect counter at the start of the call.
397
- * @param isStaticCall - Whether the call is a static call.
398
- */ privateNotifySetPublicTeardownFunctionCall(_targetContractAddress, calldataHash, _sideEffectCounter, _isStaticCall) {
399
- this.#onNewPublicFunctionCall(calldataHash);
400
- return Promise.resolve();
431
+ getTotalPublicCalldataCount() {
432
+ return this.totalPublicCalldataCount;
401
433
  }
402
- privateNotifySetMinRevertibleSideEffectCounter(minRevertibleSideEffectCounter) {
434
+ notifyRevertiblePhaseStart(minRevertibleSideEffectCounter) {
403
435
  return this.noteCache.setMinRevertibleSideEffectCounter(minRevertibleSideEffectCounter);
404
436
  }
405
- privateIsSideEffectCounterRevertible(sideEffectCounter) {
437
+ isExecutionInRevertiblePhase(sideEffectCounter) {
406
438
  return Promise.resolve(this.noteCache.isSideEffectCounterRevertible(sideEffectCounter));
407
439
  }
408
440
  /**
@@ -417,10 +449,4 @@ import { UtilityExecutionOracle } from './utility_execution_oracle.js';
417
449
  getDebugFunctionName() {
418
450
  return this.contractStore.getDebugFunctionName(this.contractAddress, this.callContext.functionSelector);
419
451
  }
420
- utilityEmitOffchainEffect(data) {
421
- this.offchainEffects.push({
422
- data
423
- });
424
- return Promise.resolve();
425
- }
426
452
  }