@aztec/pxe 0.0.1-commit.86469d5 → 0.0.1-commit.8655d4a

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 (325) hide show
  1. package/dest/bin/check_oracle_version.d.ts +12 -2
  2. package/dest/bin/check_oracle_version.d.ts.map +1 -1
  3. package/dest/bin/check_oracle_version.js +31 -25
  4. package/dest/bin/index.d.ts +2 -0
  5. package/dest/bin/index.d.ts.map +1 -0
  6. package/dest/bin/index.js +1 -0
  7. package/dest/block_synchronizer/block_stream_source.d.ts +10 -0
  8. package/dest/block_synchronizer/block_stream_source.d.ts.map +1 -0
  9. package/dest/block_synchronizer/block_stream_source.js +62 -0
  10. package/dest/block_synchronizer/block_synchronizer.d.ts +9 -3
  11. package/dest/block_synchronizer/block_synchronizer.d.ts.map +1 -1
  12. package/dest/block_synchronizer/block_synchronizer.js +37 -11
  13. package/dest/config/index.d.ts +8 -2
  14. package/dest/config/index.d.ts.map +1 -1
  15. package/dest/config/index.js +13 -15
  16. package/dest/config/package_info.js +1 -1
  17. package/dest/contract_function_simulator/contract_function_simulator.d.ts +66 -29
  18. package/dest/contract_function_simulator/contract_function_simulator.d.ts.map +1 -1
  19. package/dest/contract_function_simulator/contract_function_simulator.js +216 -75
  20. package/dest/contract_function_simulator/ephemeral_array_service.d.ts +28 -0
  21. package/dest/contract_function_simulator/ephemeral_array_service.d.ts.map +1 -0
  22. package/dest/contract_function_simulator/ephemeral_array_service.js +78 -0
  23. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts +7 -11
  24. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts.map +1 -1
  25. package/dest/contract_function_simulator/execution_tagging_index_cache.js +19 -15
  26. package/dest/contract_function_simulator/index.d.ts +4 -1
  27. package/dest/contract_function_simulator/index.d.ts.map +1 -1
  28. package/dest/contract_function_simulator/index.js +3 -0
  29. package/dest/contract_function_simulator/noir-structs/bounded_vec.d.ts +48 -0
  30. package/dest/contract_function_simulator/noir-structs/bounded_vec.d.ts.map +1 -0
  31. package/dest/contract_function_simulator/noir-structs/bounded_vec.js +45 -0
  32. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts +4 -6
  33. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts.map +1 -1
  34. package/dest/contract_function_simulator/noir-structs/event_validation_request.js +8 -9
  35. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.d.ts +13 -3
  36. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.d.ts.map +1 -1
  37. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.js +35 -4
  38. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts +2 -2
  39. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts.map +1 -1
  40. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.js +2 -4
  41. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts +4 -7
  42. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts.map +1 -1
  43. package/dest/contract_function_simulator/noir-structs/note_validation_request.js +6 -10
  44. package/dest/contract_function_simulator/noir-structs/option.d.ts +61 -0
  45. package/dest/contract_function_simulator/noir-structs/option.d.ts.map +1 -0
  46. package/dest/contract_function_simulator/noir-structs/option.js +62 -0
  47. package/dest/contract_function_simulator/oracle/interfaces.d.ts +67 -51
  48. package/dest/contract_function_simulator/oracle/interfaces.d.ts.map +1 -1
  49. package/dest/contract_function_simulator/oracle/note_packing_utils.d.ts +2 -2
  50. package/dest/contract_function_simulator/oracle/note_packing_utils.d.ts.map +1 -1
  51. package/dest/contract_function_simulator/oracle/note_packing_utils.js +2 -2
  52. package/dest/contract_function_simulator/oracle/oracle.d.ts +74 -45
  53. package/dest/contract_function_simulator/oracle/oracle.d.ts.map +1 -1
  54. package/dest/contract_function_simulator/oracle/oracle.js +471 -275
  55. package/dest/contract_function_simulator/oracle/oracle_registry.d.ts +147 -0
  56. package/dest/contract_function_simulator/oracle/oracle_registry.d.ts.map +1 -0
  57. package/dest/contract_function_simulator/oracle/oracle_registry.js +1199 -0
  58. package/dest/contract_function_simulator/oracle/private_execution.js +5 -3
  59. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts +68 -93
  60. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts.map +1 -1
  61. package/dest/contract_function_simulator/oracle/private_execution_oracle.js +150 -108
  62. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts +138 -73
  63. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts.map +1 -1
  64. package/dest/contract_function_simulator/oracle/utility_execution_oracle.js +433 -154
  65. package/dest/contract_function_simulator/pick_notes.d.ts +1 -1
  66. package/dest/contract_function_simulator/pick_notes.d.ts.map +1 -1
  67. package/dest/contract_function_simulator/pick_notes.js +20 -3
  68. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts +1 -1
  69. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts.map +1 -1
  70. package/dest/contract_function_simulator/proxied_contract_data_source.js +35 -64
  71. package/dest/contract_logging.d.ts +27 -0
  72. package/dest/contract_logging.d.ts.map +1 -0
  73. package/dest/contract_logging.js +38 -0
  74. package/dest/contract_sync/contract_sync_service.d.ts +42 -0
  75. package/dest/contract_sync/contract_sync_service.d.ts.map +1 -0
  76. package/dest/contract_sync/contract_sync_service.js +135 -0
  77. package/dest/contract_sync/helpers.d.ts +27 -0
  78. package/dest/contract_sync/helpers.d.ts.map +1 -0
  79. package/dest/contract_sync/{index.js → helpers.js} +16 -24
  80. package/dest/debug/pxe_debug_utils.d.ts +14 -15
  81. package/dest/debug/pxe_debug_utils.d.ts.map +1 -1
  82. package/dest/debug/pxe_debug_utils.js +16 -21
  83. package/dest/entrypoints/client/bundle/index.d.ts +3 -1
  84. package/dest/entrypoints/client/bundle/index.d.ts.map +1 -1
  85. package/dest/entrypoints/client/bundle/index.js +2 -0
  86. package/dest/entrypoints/client/bundle/utils.d.ts +2 -2
  87. package/dest/entrypoints/client/bundle/utils.d.ts.map +1 -1
  88. package/dest/entrypoints/client/bundle/utils.js +21 -5
  89. package/dest/entrypoints/client/lazy/index.d.ts +3 -1
  90. package/dest/entrypoints/client/lazy/index.d.ts.map +1 -1
  91. package/dest/entrypoints/client/lazy/index.js +2 -0
  92. package/dest/entrypoints/client/lazy/utils.d.ts +2 -2
  93. package/dest/entrypoints/client/lazy/utils.d.ts.map +1 -1
  94. package/dest/entrypoints/client/lazy/utils.js +21 -5
  95. package/dest/entrypoints/pxe_creation_options.d.ts +9 -1
  96. package/dest/entrypoints/pxe_creation_options.d.ts.map +1 -1
  97. package/dest/entrypoints/pxe_creation_options.js +3 -1
  98. package/dest/entrypoints/server/index.d.ts +5 -3
  99. package/dest/entrypoints/server/index.d.ts.map +1 -1
  100. package/dest/entrypoints/server/index.js +4 -2
  101. package/dest/entrypoints/server/utils.d.ts +4 -3
  102. package/dest/entrypoints/server/utils.d.ts.map +1 -1
  103. package/dest/entrypoints/server/utils.js +21 -5
  104. package/dest/events/event_service.d.ts +15 -6
  105. package/dest/events/event_service.d.ts.map +1 -1
  106. package/dest/events/event_service.js +44 -11
  107. package/dest/events/private_event_filter_validator.d.ts +3 -2
  108. package/dest/events/private_event_filter_validator.d.ts.map +1 -1
  109. package/dest/events/private_event_filter_validator.js +15 -0
  110. package/dest/hooks/authorize_utility_call.d.ts +41 -0
  111. package/dest/hooks/authorize_utility_call.d.ts.map +1 -0
  112. package/dest/hooks/authorize_utility_call.js +4 -0
  113. package/dest/hooks/execution_hooks.d.ts +42 -0
  114. package/dest/hooks/execution_hooks.d.ts.map +1 -0
  115. package/dest/hooks/execution_hooks.js +9 -0
  116. package/dest/hooks/index.d.ts +4 -0
  117. package/dest/hooks/index.d.ts.map +1 -0
  118. package/dest/hooks/index.js +1 -0
  119. package/dest/logs/log_service.d.ts +9 -8
  120. package/dest/logs/log_service.d.ts.map +1 -1
  121. package/dest/logs/log_service.js +126 -81
  122. package/dest/messages/message_context_service.d.ts +17 -0
  123. package/dest/messages/message_context_service.d.ts.map +1 -0
  124. package/dest/messages/message_context_service.js +38 -0
  125. package/dest/notes/note_service.d.ts +27 -5
  126. package/dest/notes/note_service.d.ts.map +1 -1
  127. package/dest/notes/note_service.js +83 -58
  128. package/dest/notes_filter.d.ts +24 -0
  129. package/dest/notes_filter.d.ts.map +1 -0
  130. package/dest/notes_filter.js +4 -0
  131. package/dest/oracle_version.d.ts +4 -3
  132. package/dest/oracle_version.d.ts.map +1 -1
  133. package/dest/oracle_version.js +20 -10
  134. package/dest/private_kernel/batch_planner.d.ts +47 -0
  135. package/dest/private_kernel/batch_planner.d.ts.map +1 -0
  136. package/dest/private_kernel/batch_planner.js +104 -0
  137. package/dest/private_kernel/hints/compute_tx_expiration_timestamp.d.ts +4 -0
  138. package/dest/private_kernel/hints/compute_tx_expiration_timestamp.d.ts.map +1 -0
  139. package/dest/private_kernel/hints/{compute_tx_include_by_timestamp.js → compute_tx_expiration_timestamp.js} +12 -12
  140. package/dest/private_kernel/hints/index.d.ts +1 -1
  141. package/dest/private_kernel/hints/index.js +1 -1
  142. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts +4 -3
  143. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts.map +1 -1
  144. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.js +130 -69
  145. package/dest/private_kernel/hints/test_utils.d.ts +122 -0
  146. package/dest/private_kernel/hints/test_utils.d.ts.map +1 -0
  147. package/dest/private_kernel/hints/test_utils.js +202 -0
  148. package/dest/private_kernel/private_kernel_execution_prover.d.ts +6 -2
  149. package/dest/private_kernel/private_kernel_execution_prover.d.ts.map +1 -1
  150. package/dest/private_kernel/private_kernel_execution_prover.js +166 -65
  151. package/dest/private_kernel/private_kernel_oracle.d.ts +15 -11
  152. package/dest/private_kernel/private_kernel_oracle.d.ts.map +1 -1
  153. package/dest/private_kernel/private_kernel_oracle.js +31 -25
  154. package/dest/pxe.d.ts +120 -24
  155. package/dest/pxe.d.ts.map +1 -1
  156. package/dest/pxe.js +231 -134
  157. package/dest/storage/anchor_block_store/anchor_block_store.js +1 -1
  158. package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.d.ts +42 -0
  159. package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.d.ts.map +1 -0
  160. package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.js +93 -0
  161. package/dest/storage/backwards_compatibility_tests/schema_tests.d.ts +15 -0
  162. package/dest/storage/backwards_compatibility_tests/schema_tests.d.ts.map +1 -0
  163. package/dest/storage/backwards_compatibility_tests/schema_tests.js +591 -0
  164. package/dest/storage/backwards_compatibility_tests/store_spy.d.ts +19 -0
  165. package/dest/storage/backwards_compatibility_tests/store_spy.d.ts.map +1 -0
  166. package/dest/storage/backwards_compatibility_tests/store_spy.js +63 -0
  167. package/dest/storage/capsule_store/capsule_service.d.ts +21 -0
  168. package/dest/storage/capsule_store/capsule_service.d.ts.map +1 -0
  169. package/dest/storage/capsule_store/capsule_service.js +50 -0
  170. package/dest/storage/capsule_store/capsule_store.d.ts +9 -9
  171. package/dest/storage/capsule_store/capsule_store.d.ts.map +1 -1
  172. package/dest/storage/capsule_store/capsule_store.js +36 -28
  173. package/dest/storage/capsule_store/index.d.ts +2 -1
  174. package/dest/storage/capsule_store/index.d.ts.map +1 -1
  175. package/dest/storage/capsule_store/index.js +1 -0
  176. package/dest/storage/contract_store/contract_store.d.ts +42 -15
  177. package/dest/storage/contract_store/contract_store.d.ts.map +1 -1
  178. package/dest/storage/contract_store/contract_store.js +146 -87
  179. package/dest/storage/metadata.d.ts +1 -1
  180. package/dest/storage/metadata.js +1 -1
  181. package/dest/storage/note_store/note_store.d.ts +3 -3
  182. package/dest/storage/note_store/note_store.d.ts.map +1 -1
  183. package/dest/storage/note_store/note_store.js +6 -4
  184. package/dest/storage/open_pxe_stores.d.ts +33 -0
  185. package/dest/storage/open_pxe_stores.d.ts.map +1 -0
  186. package/dest/storage/open_pxe_stores.js +27 -0
  187. package/dest/storage/private_event_store/private_event_store.d.ts +1 -1
  188. package/dest/storage/private_event_store/private_event_store.d.ts.map +1 -1
  189. package/dest/storage/private_event_store/private_event_store.js +3 -0
  190. package/dest/storage/private_event_store/stored_private_event.js +1 -1
  191. package/dest/storage/tagging_store/recipient_tagging_store.d.ts +6 -6
  192. package/dest/storage/tagging_store/recipient_tagging_store.d.ts.map +1 -1
  193. package/dest/storage/tagging_store/sender_tagging_store.d.ts +29 -28
  194. package/dest/storage/tagging_store/sender_tagging_store.d.ts.map +1 -1
  195. package/dest/storage/tagging_store/sender_tagging_store.js +141 -115
  196. package/dest/tagging/get_all_logs_by_tags.d.ts +34 -10
  197. package/dest/tagging/get_all_logs_by_tags.d.ts.map +1 -1
  198. package/dest/tagging/get_all_logs_by_tags.js +45 -32
  199. package/dest/tagging/index.d.ts +6 -5
  200. package/dest/tagging/index.d.ts.map +1 -1
  201. package/dest/tagging/index.js +4 -3
  202. package/dest/tagging/persist_sender_tagging_index_ranges.d.ts +29 -0
  203. package/dest/tagging/persist_sender_tagging_index_ranges.d.ts.map +1 -0
  204. package/dest/tagging/persist_sender_tagging_index_ranges.js +42 -0
  205. package/dest/tagging/recipient_sync/sync_tagged_private_logs.d.ts +56 -0
  206. package/dest/tagging/recipient_sync/sync_tagged_private_logs.d.ts.map +1 -0
  207. package/dest/tagging/recipient_sync/sync_tagged_private_logs.js +163 -0
  208. package/dest/tagging/recipient_sync/utils/find_highest_indexes.d.ts +3 -3
  209. package/dest/tagging/recipient_sync/utils/find_highest_indexes.d.ts.map +1 -1
  210. package/dest/tagging/recipient_sync/utils/find_highest_indexes.js +2 -2
  211. package/dest/tagging/reconcile_tagging_index_ranges.d.ts +36 -0
  212. package/dest/tagging/reconcile_tagging_index_ranges.d.ts.map +1 -0
  213. package/dest/tagging/reconcile_tagging_index_ranges.js +74 -0
  214. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts +4 -9
  215. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts.map +1 -1
  216. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.js +30 -14
  217. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts +13 -7
  218. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts.map +1 -1
  219. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.js +41 -10
  220. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts +5 -7
  221. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts.map +1 -1
  222. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.js +37 -25
  223. package/package.json +29 -17
  224. package/src/bin/check_oracle_version.ts +41 -31
  225. package/src/bin/index.ts +1 -0
  226. package/src/block_synchronizer/block_stream_source.ts +81 -0
  227. package/src/block_synchronizer/block_synchronizer.ts +39 -11
  228. package/src/config/index.ts +15 -9
  229. package/src/config/package_info.ts +1 -1
  230. package/src/contract_function_simulator/contract_function_simulator.ts +391 -136
  231. package/src/contract_function_simulator/ephemeral_array_service.ts +110 -0
  232. package/src/contract_function_simulator/execution_tagging_index_cache.ts +19 -18
  233. package/src/contract_function_simulator/index.ts +3 -0
  234. package/src/contract_function_simulator/noir-structs/bounded_vec.ts +55 -0
  235. package/src/contract_function_simulator/noir-structs/event_validation_request.ts +10 -9
  236. package/src/contract_function_simulator/noir-structs/log_retrieval_request.ts +36 -3
  237. package/src/contract_function_simulator/noir-structs/log_retrieval_response.ts +2 -5
  238. package/src/contract_function_simulator/noir-structs/note_validation_request.ts +5 -10
  239. package/src/contract_function_simulator/noir-structs/option.ts +69 -0
  240. package/src/contract_function_simulator/oracle/interfaces.ts +85 -72
  241. package/src/contract_function_simulator/oracle/note_packing_utils.ts +3 -3
  242. package/src/contract_function_simulator/oracle/oracle.ts +563 -482
  243. package/src/contract_function_simulator/oracle/oracle_registry.ts +904 -0
  244. package/src/contract_function_simulator/oracle/private_execution.ts +4 -4
  245. package/src/contract_function_simulator/oracle/private_execution_oracle.ts +184 -205
  246. package/src/contract_function_simulator/oracle/utility_execution_oracle.ts +623 -229
  247. package/src/contract_function_simulator/pick_notes.ts +22 -3
  248. package/src/contract_function_simulator/proxied_contract_data_source.ts +41 -64
  249. package/src/contract_logging.ts +52 -0
  250. package/src/contract_sync/contract_sync_service.ts +189 -0
  251. package/src/contract_sync/{index.ts → helpers.ts} +17 -50
  252. package/src/debug/pxe_debug_utils.ts +47 -25
  253. package/src/entrypoints/client/bundle/index.ts +2 -0
  254. package/src/entrypoints/client/bundle/utils.ts +19 -6
  255. package/src/entrypoints/client/lazy/index.ts +2 -0
  256. package/src/entrypoints/client/lazy/utils.ts +19 -6
  257. package/src/entrypoints/pxe_creation_options.ts +14 -0
  258. package/src/entrypoints/server/index.ts +4 -2
  259. package/src/entrypoints/server/utils.ts +22 -13
  260. package/src/events/event_service.ts +69 -21
  261. package/src/events/private_event_filter_validator.ts +21 -1
  262. package/src/hooks/authorize_utility_call.ts +44 -0
  263. package/src/hooks/execution_hooks.ts +48 -0
  264. package/src/hooks/index.ts +7 -0
  265. package/src/logs/log_service.ts +157 -145
  266. package/src/messages/message_context_service.ts +45 -0
  267. package/src/notes/note_service.ts +120 -85
  268. package/src/notes_filter.ts +24 -0
  269. package/src/oracle_version.ts +20 -10
  270. package/src/private_kernel/batch_planner.ts +169 -0
  271. package/src/private_kernel/hints/{compute_tx_include_by_timestamp.ts → compute_tx_expiration_timestamp.ts} +13 -13
  272. package/src/private_kernel/hints/index.ts +1 -1
  273. package/src/private_kernel/hints/private_kernel_reset_private_inputs_builder.ts +165 -118
  274. package/src/private_kernel/hints/test_utils.ts +318 -0
  275. package/src/private_kernel/private_kernel_execution_prover.ts +254 -89
  276. package/src/private_kernel/private_kernel_oracle.ts +42 -32
  277. package/src/pxe.ts +413 -184
  278. package/src/storage/anchor_block_store/anchor_block_store.ts +1 -1
  279. package/src/storage/backwards_compatibility_tests/__snapshots__/AddressStore.json +22 -0
  280. package/src/storage/backwards_compatibility_tests/__snapshots__/AnchorBlockStore.json +3 -0
  281. package/src/storage/backwards_compatibility_tests/__snapshots__/CapsuleStore.json +16 -0
  282. package/src/storage/backwards_compatibility_tests/__snapshots__/ContractStore.json +28 -0
  283. package/src/storage/backwards_compatibility_tests/__snapshots__/KeyStore.json +52 -0
  284. package/src/storage/backwards_compatibility_tests/__snapshots__/L2TipsKVStore.json +46 -0
  285. package/src/storage/backwards_compatibility_tests/__snapshots__/NoteStore.json +36 -0
  286. package/src/storage/backwards_compatibility_tests/__snapshots__/PrivateEventStore.json +44 -0
  287. package/src/storage/backwards_compatibility_tests/__snapshots__/RecipientTaggingStore.json +18 -0
  288. package/src/storage/backwards_compatibility_tests/__snapshots__/SenderAddressBookStore.json +16 -0
  289. package/src/storage/backwards_compatibility_tests/__snapshots__/SenderTaggingStore.json +22 -0
  290. package/src/storage/backwards_compatibility_tests/__snapshots__/opened_stores.json +97 -0
  291. package/src/storage/backwards_compatibility_tests/kv_store_snapshot.ts +122 -0
  292. package/src/storage/backwards_compatibility_tests/schema_tests.ts +712 -0
  293. package/src/storage/backwards_compatibility_tests/store_spy.ts +73 -0
  294. package/src/storage/capsule_store/capsule_service.ts +90 -0
  295. package/src/storage/capsule_store/capsule_store.ts +44 -26
  296. package/src/storage/capsule_store/index.ts +1 -0
  297. package/src/storage/contract_store/contract_store.ts +182 -104
  298. package/src/storage/metadata.ts +1 -1
  299. package/src/storage/note_store/note_store.ts +9 -5
  300. package/src/storage/open_pxe_stores.ts +49 -0
  301. package/src/storage/private_event_store/private_event_store.ts +4 -0
  302. package/src/storage/private_event_store/stored_private_event.ts +1 -1
  303. package/src/storage/tagging_store/recipient_tagging_store.ts +5 -5
  304. package/src/storage/tagging_store/sender_tagging_store.ts +185 -138
  305. package/src/tagging/get_all_logs_by_tags.ts +87 -35
  306. package/src/tagging/index.ts +5 -4
  307. package/src/tagging/persist_sender_tagging_index_ranges.ts +57 -0
  308. package/src/tagging/recipient_sync/sync_tagged_private_logs.ts +240 -0
  309. package/src/tagging/recipient_sync/utils/find_highest_indexes.ts +4 -4
  310. package/src/tagging/reconcile_tagging_index_ranges.ts +102 -0
  311. package/src/tagging/sender_sync/sync_sender_tagging_indexes.ts +52 -17
  312. package/src/tagging/sender_sync/utils/get_status_change_of_pending.ts +44 -14
  313. package/src/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.ts +27 -27
  314. package/dest/contract_sync/index.d.ts +0 -24
  315. package/dest/contract_sync/index.d.ts.map +0 -1
  316. package/dest/private_kernel/hints/compute_tx_include_by_timestamp.d.ts +0 -4
  317. package/dest/private_kernel/hints/compute_tx_include_by_timestamp.d.ts.map +0 -1
  318. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts +0 -15
  319. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts.map +0 -1
  320. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.js +0 -99
  321. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts +0 -15
  322. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts.map +0 -1
  323. package/dest/tagging/recipient_sync/utils/load_logs_for_range.js +0 -32
  324. package/src/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.ts +0 -143
  325. package/src/tagging/recipient_sync/utils/load_logs_for_range.ts +0 -49
@@ -2,52 +2,59 @@ 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
- import { type CircuitSimulator, toACVMWitness } from '@aztec/simulator/client';
5
+ import { toACVMWitness } from '@aztec/simulator/client';
7
6
  import {
8
7
  type FunctionAbi,
9
8
  type FunctionArtifact,
10
- type FunctionCall,
11
9
  FunctionSelector,
12
10
  type NoteSelector,
13
11
  countArgumentsSize,
14
12
  } from '@aztec/stdlib/abi';
15
- import type { AuthWitness } from '@aztec/stdlib/auth-witness';
16
13
  import { AztecAddress } from '@aztec/stdlib/aztec-address';
17
14
  import { siloNullifier } from '@aztec/stdlib/hash';
18
- import type { AztecNode } from '@aztec/stdlib/interfaces/client';
19
15
  import { PrivateContextInputs } from '@aztec/stdlib/kernel';
20
- import { type ContractClassLog, DirectionalAppTaggingSecret, type PreTag } from '@aztec/stdlib/logs';
21
- import { Tag } from '@aztec/stdlib/logs';
16
+ import {
17
+ AppTaggingSecret,
18
+ AppTaggingSecretKind,
19
+ type ContractClassLog,
20
+ Tag,
21
+ type TaggingIndexRange,
22
+ } from '@aztec/stdlib/logs';
22
23
  import { Note, type NoteStatus } from '@aztec/stdlib/note';
23
24
  import {
24
- type BlockHeader,
25
25
  CallContext,
26
- Capsule,
27
26
  CountedContractClassLog,
28
27
  NoteAndSlot,
29
28
  PrivateCallExecutionResult,
30
29
  type TxContext,
31
30
  } from '@aztec/stdlib/tx';
32
31
 
33
- import { ensureContractSynced } from '../../contract_sync/index.js';
34
32
  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
33
  import type { SenderTaggingStore } from '../../storage/tagging_store/sender_tagging_store.js';
43
34
  import { syncSenderTaggingIndexes } from '../../tagging/index.js';
44
35
  import type { ExecutionNoteCache } from '../execution_note_cache.js';
45
36
  import { ExecutionTaggingIndexCache } from '../execution_tagging_index_cache.js';
46
37
  import type { HashedValuesCache } from '../hashed_values_cache.js';
38
+ import { BoundedVec } from '../noir-structs/bounded_vec.js';
39
+ import { Option } from '../noir-structs/option.js';
47
40
  import { pickNotes } from '../pick_notes.js';
48
41
  import type { IPrivateExecutionOracle, NoteData } from './interfaces.js';
49
42
  import { executePrivateFunction } from './private_execution.js';
50
- import { UtilityExecutionOracle } from './utility_execution_oracle.js';
43
+ import { UtilityExecutionOracle, type UtilityExecutionOracleArgs } from './utility_execution_oracle.js';
44
+
45
+ /** Args for PrivateExecutionOracle constructor. */
46
+ export type PrivateExecutionOracleArgs = Omit<UtilityExecutionOracleArgs, 'contractAddress'> & {
47
+ argsHash: Fr;
48
+ txContext: TxContext;
49
+ callContext: CallContext;
50
+ executionCache: HashedValuesCache;
51
+ noteCache: ExecutionNoteCache;
52
+ taggingIndexCache: ExecutionTaggingIndexCache;
53
+ senderTaggingStore: SenderTaggingStore;
54
+ totalPublicCalldataCount?: number;
55
+ sideEffectCounter?: number;
56
+ senderForTags?: AztecAddress;
57
+ };
51
58
 
52
59
  /**
53
60
  * The execution oracle for the private part of a transaction.
@@ -66,63 +73,45 @@ 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
- jobId: string,
97
- private totalPublicCalldataCount: number = 0,
98
- protected sideEffectCounter: number = 0,
99
- log = createLogger('simulator:client_execution_context'),
100
- scopes?: AztecAddress[],
101
- private senderForTags?: AztecAddress,
102
- private simulator?: CircuitSimulator,
103
- ) {
104
- super(
105
- callContext.contractAddress,
106
- authWitnesses,
107
- capsules,
108
- anchorBlockHeader,
109
- contractStore,
110
- noteStore,
111
- keyStore,
112
- addressStore,
113
- aztecNode,
114
- recipientTaggingStore,
115
- senderAddressBookStore,
116
- capsuleStore,
117
- privateEventStore,
118
- jobId,
119
- log,
120
- scopes,
121
- );
78
+ private readonly argsHash: Fr;
79
+ private readonly txContext: TxContext;
80
+ private readonly callContext: CallContext;
81
+ private readonly executionCache: HashedValuesCache;
82
+ private readonly noteCache: ExecutionNoteCache;
83
+ private readonly taggingIndexCache: ExecutionTaggingIndexCache;
84
+ private readonly senderTaggingStore: SenderTaggingStore;
85
+ private totalPublicCalldataCount: number;
86
+ private readonly initialSideEffectCounter: number;
87
+ /** Sender for tags passed in at oracle construction time. Returned by `getSenderForTags`. */
88
+ private readonly defaultSenderForTags: AztecAddress | undefined;
89
+
90
+ constructor(args: PrivateExecutionOracleArgs) {
91
+ super({
92
+ ...args,
93
+ contractAddress: args.callContext.contractAddress,
94
+ log: args.log ?? createLogger('simulator:client_execution_context'),
95
+ });
96
+ this.argsHash = args.argsHash;
97
+ this.txContext = args.txContext;
98
+ this.callContext = args.callContext;
99
+ this.executionCache = args.executionCache;
100
+ this.noteCache = args.noteCache;
101
+ this.taggingIndexCache = args.taggingIndexCache;
102
+ this.senderTaggingStore = args.senderTaggingStore;
103
+ this.totalPublicCalldataCount = args.totalPublicCalldataCount ?? 0;
104
+ this.initialSideEffectCounter = args.sideEffectCounter ?? 0;
105
+ this.defaultSenderForTags = args.senderForTags;
122
106
  }
123
107
 
124
108
  public getPrivateContextInputs(): PrivateContextInputs {
125
- return new PrivateContextInputs(this.callContext, this.anchorBlockHeader, this.txContext, this.sideEffectCounter);
109
+ return new PrivateContextInputs(
110
+ this.callContext,
111
+ this.anchorBlockHeader,
112
+ this.txContext,
113
+ this.initialSideEffectCounter,
114
+ );
126
115
  }
127
116
 
128
117
  // We still need this function until we can get user-defined ordering of structs for fn arguments
@@ -169,17 +158,10 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
169
158
  }
170
159
 
171
160
  /**
172
- * Return the offchain effects emitted during this execution.
161
+ * Returns the tagging index ranges that were used in this execution (and that need to be stored in the db).
173
162
  */
174
- public getOffchainEffects() {
175
- return this.offchainEffects;
176
- }
177
-
178
- /**
179
- * Returns the pre-tags that were used in this execution (and that need to be stored in the db).
180
- */
181
- public getUsedPreTags(): PreTag[] {
182
- return this.taggingIndexCache.getUsedPreTags();
163
+ public getUsedTaggingIndexRanges(): TaggingIndexRange[] {
164
+ return this.taggingIndexCache.getUsedTaggingIndexRanges();
183
165
  }
184
166
 
185
167
  /**
@@ -196,55 +178,75 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
196
178
  * for a tag in order to emit a log. Constrained tagging should not use this as there is no
197
179
  * guarantee that the recipient knows about the sender, and hence about the shared secret.
198
180
  *
199
- * The value persists through nested calls, meaning all calls down the stack will use the same
200
- * 'senderForTags' value (unless it is replaced).
181
+ * Returns the wallet-supplied default sender for tags, or `None` if no default was provided.
201
182
  */
202
- public privateGetSenderForTags(): Promise<AztecAddress | undefined> {
203
- return Promise.resolve(this.senderForTags);
183
+ public getSenderForTags(): Promise<Option<AztecAddress>> {
184
+ return Promise.resolve(
185
+ this.defaultSenderForTags ? Option.some(this.defaultSenderForTags) : Option.none(AztecAddress.ZERO),
186
+ );
204
187
  }
205
188
 
206
189
  /**
207
- * Set the sender for tags.
190
+ * Returns the next app tag for a given sender and recipient pair (unconstrained delivery).
208
191
  *
209
- * This unconstrained value is used as the sender when computing an unconstrained shared secret
210
- * for a tag in order to emit a log. Constrained tagging should not use this as there is no
211
- * guarantee that the recipient knows about the sender, and hence about the shared secret.
192
+ * The simulator computes the directional tagging secret (derived via ECDH from `(sender, recipient, contract)`),
193
+ * as well as the full siloed tag, and hands the opaque value back to the caller.
212
194
  *
213
- * Account contracts typically set this value before calling other contracts. The value persists
214
- * through nested calls, meaning all calls down the stack will use the same 'senderForTags'
215
- * value (unless it is replaced by another call to this setter).
216
- */
217
- public privateSetSenderForTags(senderForTags: AztecAddress): Promise<void> {
218
- this.senderForTags = senderForTags;
219
- return Promise.resolve();
220
- }
221
-
222
- /**
223
- * Returns the next app tag for a given sender and recipient pair.
224
195
  * @param sender - The address sending the log
225
196
  * @param recipient - The address receiving the log
226
197
  * @returns An app tag to be used in a log.
227
198
  */
228
- public async privateGetNextAppTagAsSender(sender: AztecAddress, recipient: AztecAddress): Promise<Tag> {
229
- const secret = await this.#calculateDirectionalAppTaggingSecret(this.contractAddress, sender, recipient);
199
+ public async getNextAppTagAsSender(sender: AztecAddress, recipient: AztecAddress): Promise<Tag> {
200
+ const extendedSecret = await this.#calculateAppTaggingSecret(this.contractAddress, sender, recipient);
201
+
202
+ if (!extendedSecret) {
203
+ // We'd only fail to compute an extended secret if the recipient is an invalid address. To prevent
204
+ // king-of-the-hill attacks, instead of failing we use a random tag. By including a correct-looking tag in the
205
+ // log, the transaction shape is preserved and no privacy is leaked, even if the tag is bogus.
206
+ this.logger.warn(`Computing a tag for invalid recipient ${recipient} - returning a random tag instead`, {
207
+ contractAddress: this.contractAddress,
208
+ });
209
+ return Tag.random();
210
+ }
230
211
 
231
- const index = await this.#getIndexToUseForSecret(secret);
232
- this.log.debug(
212
+ const index = await this.#reserveNextIndexForSecret(extendedSecret);
213
+ this.logger.debug(
233
214
  `Incrementing tagging index for sender: ${sender}, recipient: ${recipient}, contract: ${this.contractAddress} to ${index}`,
234
215
  );
235
- this.taggingIndexCache.setLastUsedIndex(secret, index);
236
216
 
237
- return Tag.compute({ secret, index });
217
+ return Tag.compute({ extendedSecret, index });
238
218
  }
239
219
 
240
- async #calculateDirectionalAppTaggingSecret(
241
- contractAddress: AztecAddress,
242
- sender: AztecAddress,
243
- recipient: AztecAddress,
244
- ) {
245
- const senderCompleteAddress = await this.getCompleteAddress(sender);
220
+ /**
221
+ * Returns the next sender-side index for a constrained-delivery app-siloed shared secret.
222
+ *
223
+ * Unlike the unconstrained variant, the simulator does not compute the secret: it was supplied by the calling contract
224
+ * (which retrieved it from an onchain handshake registry). The simulator only acts as a per-secret index counter.
225
+ * The caller computes the onchain tag itself.
226
+ *
227
+ * @param appSiloedSecret - The app-siloed shared secret retrieved from the handshake registry by the caller.
228
+ * @returns The next index to use for this secret.
229
+ */
230
+ public async getNextConstrainedTaggingIndex(appSiloedSecret: Fr): Promise<number> {
231
+ const secret = new AppTaggingSecret(appSiloedSecret, this.contractAddress, AppTaggingSecretKind.CONSTRAINED);
232
+ const index = await this.#reserveNextIndexForSecret(secret);
233
+ this.logger.debug(
234
+ `Incrementing tagging index for constrained-delivery secret in contract ${this.contractAddress} to ${index}`,
235
+ );
236
+ return index;
237
+ }
238
+
239
+ /** Resolves the next index for a given tagging secret, syncing from chain if it is missing from the in-tx cache. */
240
+ async #reserveNextIndexForSecret(secret: AppTaggingSecret): Promise<number> {
241
+ const index = await this.#getIndexToUseForSecret(secret);
242
+ this.taggingIndexCache.setLastUsedIndex(secret, index);
243
+ return index;
244
+ }
245
+
246
+ async #calculateAppTaggingSecret(contractAddress: AztecAddress, sender: AztecAddress, recipient: AztecAddress) {
247
+ const senderCompleteAddress = await this.getCompleteAddressOrFail(sender);
246
248
  const senderIvsk = await this.keyStore.getMasterIncomingViewingSecretKey(sender);
247
- return DirectionalAppTaggingSecret.compute(
249
+ return AppTaggingSecret.computeUnconstrained(
248
250
  senderCompleteAddress,
249
251
  senderIvsk,
250
252
  recipient,
@@ -253,7 +255,7 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
253
255
  );
254
256
  }
255
257
 
256
- async #getIndexToUseForSecret(secret: DirectionalAppTaggingSecret): Promise<number> {
258
+ async #getIndexToUseForSecret(secret: AppTaggingSecret): Promise<number> {
257
259
  // If we have the tagging index in the cache, we use it. If not we obtain it from the execution data provider.
258
260
  const lastUsedIndexInTx = this.taggingIndexCache.getLastUsedIndex(secret);
259
261
 
@@ -265,7 +267,6 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
265
267
  // that'd be wasteful as most tagging secrets are not used in each tx.
266
268
  await syncSenderTaggingIndexes(
267
269
  secret,
268
- this.contractAddress,
269
270
  this.aztecNode,
270
271
  this.senderTaggingStore,
271
272
  await this.anchorBlockHeader.hash(),
@@ -284,7 +285,7 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
284
285
  * @param values - Values to store.
285
286
  * @returns The hash of the values.
286
287
  */
287
- public privateStoreInExecutionCache(values: Fr[], hash: Fr) {
288
+ public setHashPreimage(values: Fr[], hash: Fr) {
288
289
  return this.executionCache.store(values, hash);
289
290
  }
290
291
 
@@ -293,7 +294,7 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
293
294
  * @param hash - Hash of the values.
294
295
  * @returns The values.
295
296
  */
296
- public privateLoadFromExecutionCache(hash: Fr): Promise<Fr[]> {
297
+ public getHashPreimage(hash: Fr): Promise<Fr[]> {
297
298
  const preimage = this.executionCache.getPreimage(hash);
298
299
  if (!preimage) {
299
300
  throw new Error(`Preimage for hash ${hash.toString()} not found in cache`);
@@ -301,12 +302,12 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
301
302
  return Promise.resolve(preimage);
302
303
  }
303
304
 
304
- override async utilityCheckNullifierExists(innerNullifier: Fr): Promise<boolean> {
305
+ override async doesNullifierExist(innerNullifier: Fr): Promise<boolean> {
305
306
  // This oracle must be overridden because while utility execution can only meaningfully check if a nullifier exists
306
307
  // in the synched block, during private execution there's also the possibility of it being pending, i.e. created
307
308
  // in the current transaction.
308
309
 
309
- this.log.debug(`Checking existence of inner nullifier ${innerNullifier}`, {
310
+ this.logger.debug(`Checking existence of inner nullifier ${innerNullifier}`, {
310
311
  contractAddress: this.contractAddress,
311
312
  });
312
313
 
@@ -314,7 +315,7 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
314
315
 
315
316
  return (
316
317
  this.noteCache.getNullifiers(this.contractAddress).has(nullifier) ||
317
- (await super.utilityCheckNullifierExists(innerNullifier))
318
+ (await super.doesNullifierExist(innerNullifier))
318
319
  );
319
320
  }
320
321
 
@@ -339,8 +340,8 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
339
340
  * @param status - The status of notes to fetch.
340
341
  * @returns Array of note data.
341
342
  */
342
- public override async utilityGetNotes(
343
- owner: AztecAddress | undefined,
343
+ public override async getNotes(
344
+ owner: Option<AztecAddress>,
344
345
  storageSlot: Fr,
345
346
  numSelects: number,
346
347
  selectByIndexes: number[],
@@ -355,16 +356,18 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
355
356
  limit: number,
356
357
  offset: number,
357
358
  status: NoteStatus,
358
- ): Promise<NoteData[]> {
359
+ maxNotes: number,
360
+ packedHintedNoteLength: number,
361
+ ): Promise<BoundedVec<NoteData>> {
359
362
  // Nullified pending notes are already removed from the list.
360
- const pendingNotes = this.noteCache.getNotes(this.callContext.contractAddress, owner, storageSlot);
363
+ const pendingNotes = this.noteCache.getNotes(this.callContext.contractAddress, owner.value, storageSlot);
361
364
 
362
365
  const pendingNullifiers = this.noteCache.getNullifiers(this.callContext.contractAddress);
363
366
 
364
367
  const noteService = new NoteService(this.noteStore, this.aztecNode, this.anchorBlockHeader, this.jobId);
365
368
  const dbNotes = await noteService.getNotes(
366
369
  this.callContext.contractAddress,
367
- owner,
370
+ owner.value,
368
371
  storageSlot,
369
372
  status,
370
373
  this.scopes,
@@ -385,13 +388,13 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
385
388
  offset,
386
389
  });
387
390
 
388
- this.log.debug(
391
+ this.logger.debug(
389
392
  `Returning ${notes.length} notes for ${this.callContext.contractAddress} at ${storageSlot}: ${notes
390
393
  .map(n => `${n.noteNonce.toString()}:[${n.note.items.map(i => i.toString()).join(',')}]`)
391
394
  .join(', ')}`,
392
395
  );
393
396
 
394
- return notes;
397
+ return BoundedVec.from({ data: notes, maxLength: maxNotes, elementSize: packedHintedNoteLength });
395
398
  }
396
399
 
397
400
  /**
@@ -405,7 +408,7 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
405
408
  * @param noteHash - A hash of the new note.
406
409
  * @returns
407
410
  */
408
- public privateNotifyCreatedNote(
411
+ public notifyCreatedNote(
409
412
  owner: AztecAddress,
410
413
  storageSlot: Fr,
411
414
  randomness: Fr,
@@ -414,7 +417,7 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
414
417
  noteHash: Fr,
415
418
  counter: number,
416
419
  ) {
417
- this.log.debug(`Notified of new note with inner hash ${noteHash}`, {
420
+ this.logger.debug(`Notified of new note with inner hash ${noteHash}`, {
418
421
  contractAddress: this.callContext.contractAddress,
419
422
  storageSlot,
420
423
  randomness,
@@ -446,7 +449,7 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
446
449
  * @param innerNullifier - The pending nullifier to add in the list (not yet siloed by contract address).
447
450
  * @param noteHash - A hash of the new note.
448
451
  */
449
- public async privateNotifyNullifiedNote(innerNullifier: Fr, noteHash: Fr, counter: number) {
452
+ public async notifyNullifiedNote(innerNullifier: Fr, noteHash: Fr, counter: number) {
450
453
  const nullifiedNoteHashCounter = await this.noteCache.nullifyNote(
451
454
  this.callContext.contractAddress,
452
455
  innerNullifier,
@@ -463,19 +466,19 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
463
466
  * @param innerNullifier - The pending nullifier to add in the list (not yet siloed by contract address).
464
467
  * @param noteHash - A hash of the new note.
465
468
  */
466
- public privateNotifyCreatedNullifier(innerNullifier: Fr) {
467
- this.log.debug(`Notified of new inner nullifier ${innerNullifier}`, { contractAddress: this.contractAddress });
469
+ public notifyCreatedNullifier(innerNullifier: Fr) {
470
+ this.logger.debug(`Notified of new inner nullifier ${innerNullifier}`, { contractAddress: this.contractAddress });
468
471
  return this.noteCache.nullifierCreated(this.callContext.contractAddress, innerNullifier);
469
472
  }
470
473
 
471
474
  /**
472
- * Check if a nullifier has been emitted in the same transaction, i.e. if privateNotifyCreatedNullifier has been
475
+ * Check if a nullifier has been emitted in the same transaction, i.e. if notifyCreatedNullifier has been
473
476
  * called for this inner nullifier from the contract with the specified address.
474
477
  * @param innerNullifier - The inner nullifier to check.
475
478
  * @param contractAddress - Address of the contract that emitted the nullifier.
476
479
  * @returns A boolean indicating whether the nullifier is pending or not.
477
480
  */
478
- public async privateIsNullifierPending(innerNullifier: Fr, contractAddress: AztecAddress): Promise<boolean> {
481
+ public async isNullifierPending(innerNullifier: Fr, contractAddress: AztecAddress): Promise<boolean> {
479
482
  const siloedNullifier = await siloNullifier(contractAddress, innerNullifier);
480
483
  const isNullifierPending = this.noteCache.getNullifiers(contractAddress).has(siloedNullifier.toBigInt());
481
484
  return Promise.resolve(isNullifierPending);
@@ -488,10 +491,10 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
488
491
  * @param log - The contract class log to be emitted.
489
492
  * @param counter - The contract class log's counter.
490
493
  */
491
- public privateNotifyCreatedContractClassLog(log: ContractClassLog, counter: number) {
494
+ public notifyCreatedContractClassLog(log: ContractClassLog, counter: number) {
492
495
  this.contractClassLogs.push(new CountedContractClassLog(log, counter));
493
496
  const text = log.toBuffer().toString('hex');
494
- this.log.verbose(
497
+ this.logger.verbose(
495
498
  `Emitted log from ContractClassRegistry: "${text.length > 100 ? text.slice(0, 100) + '...' : text}"`,
496
499
  );
497
500
  }
@@ -517,7 +520,7 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
517
520
  * @param isStaticCall - Whether the call is a static call.
518
521
  * @returns The execution result.
519
522
  */
520
- async privateCallPrivateFunction(
523
+ async callPrivateFunction(
521
524
  targetContractAddress: AztecAddress,
522
525
  functionSelector: FunctionSelector,
523
526
  argsHash: Fr,
@@ -531,21 +534,19 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
531
534
  }
532
535
 
533
536
  const simulatorSetupTimer = new Timer();
534
- this.log.debug(
537
+ this.logger.debug(
535
538
  `Calling private function ${targetContractAddress}:${functionSelector} from ${this.callContext.contractAddress}`,
536
539
  );
537
540
 
538
541
  isStaticCall = isStaticCall || this.callContext.isStaticCall;
539
542
 
540
- await ensureContractSynced(
543
+ await this.contractSyncService.ensureContractSynced(
541
544
  targetContractAddress,
542
545
  functionSelector,
543
546
  this.utilityExecutor,
544
- this.aztecNode,
545
- this.contractStore,
546
- this.noteStore,
547
547
  this.anchorBlockHeader,
548
548
  this.jobId,
549
+ this.scopes,
549
550
  );
550
551
 
551
552
  const targetArtifact = await this.contractStore.getFunctionArtifactWithDebugMetadata(
@@ -557,35 +558,39 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
557
558
 
558
559
  const derivedCallContext = await this.deriveCallContext(targetContractAddress, targetArtifact, isStaticCall);
559
560
 
560
- const privateExecutionOracle = new PrivateExecutionOracle(
561
+ const privateExecutionOracle = new PrivateExecutionOracle({
561
562
  argsHash,
562
- derivedTxContext,
563
- derivedCallContext,
564
- this.anchorBlockHeader,
565
- this.utilityExecutor,
566
- this.authWitnesses,
567
- this.capsules,
568
- this.executionCache,
569
- this.noteCache,
570
- this.taggingIndexCache,
571
- this.contractStore,
572
- this.noteStore,
573
- this.keyStore,
574
- this.addressStore,
575
- this.aztecNode,
576
- this.senderTaggingStore,
577
- this.recipientTaggingStore,
578
- this.senderAddressBookStore,
579
- this.capsuleStore,
580
- this.privateEventStore,
581
- this.jobId,
582
- this.totalPublicCalldataCount,
563
+ txContext: derivedTxContext,
564
+ callContext: derivedCallContext,
565
+ anchorBlockHeader: this.anchorBlockHeader,
566
+ utilityExecutor: this.utilityExecutor,
567
+ authWitnesses: this.authWitnesses,
568
+ capsules: this.capsules,
569
+ executionCache: this.executionCache,
570
+ noteCache: this.noteCache,
571
+ taggingIndexCache: this.taggingIndexCache,
572
+ contractStore: this.contractStore,
573
+ noteStore: this.noteStore,
574
+ keyStore: this.keyStore,
575
+ addressStore: this.addressStore,
576
+ aztecNode: this.aztecNode,
577
+ senderTaggingStore: this.senderTaggingStore,
578
+ recipientTaggingStore: this.recipientTaggingStore,
579
+ senderAddressBookStore: this.senderAddressBookStore,
580
+ capsuleService: this.capsuleService,
581
+ privateEventStore: this.privateEventStore,
582
+ messageContextService: this.messageContextService,
583
+ contractSyncService: this.contractSyncService,
584
+ jobId: this.jobId,
585
+ totalPublicCalldataCount: this.totalPublicCalldataCount,
583
586
  sideEffectCounter,
584
- this.log,
585
- this.scopes,
586
- this.senderForTags,
587
- this.simulator,
588
- );
587
+ log: this.logger,
588
+ scopes: this.scopes,
589
+ senderForTags: this.defaultSenderForTags,
590
+ simulator: this.simulator,
591
+ hooks: this.hooks,
592
+ l2TipsStore: this.l2TipsStore,
593
+ });
589
594
 
590
595
  const setupTime = simulatorSetupTimer.ms();
591
596
 
@@ -597,6 +602,9 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
597
602
  functionSelector,
598
603
  );
599
604
 
605
+ // Propagate the nested call's calldata count so the parent sees its increments on subsequent enqueues.
606
+ this.totalPublicCalldataCount = privateExecutionOracle.getTotalPublicCalldataCount();
607
+
600
608
  if (isStaticCall) {
601
609
  this.#checkValidStaticCall(childExecutionResult);
602
610
  }
@@ -616,7 +624,8 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
616
624
  };
617
625
  }
618
626
 
619
- #onNewPublicFunctionCall(calldataHash: Fr) {
627
+ /** Validates the calldata preimage exists in the cache and checks cumulative calldata size is within limits. */
628
+ public assertValidPublicCalldata(calldataHash: Fr) {
620
629
  const calldata = this.executionCache.getPreimage(calldataHash);
621
630
  if (!calldata) {
622
631
  throw new Error('Calldata for public call not found in cache');
@@ -626,47 +635,18 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
626
635
  if (this.totalPublicCalldataCount > MAX_FR_CALLDATA_TO_ALL_ENQUEUED_CALLS) {
627
636
  throw new Error(`Too many total args to all enqueued public calls! (> ${MAX_FR_CALLDATA_TO_ALL_ENQUEUED_CALLS})`);
628
637
  }
629
- }
630
-
631
- /**
632
- * Verify relevant information when a public function is enqueued.
633
- * @param targetContractAddress - The address of the contract to call.
634
- * @param calldataHash - The hash of the function selector and arguments.
635
- * @param sideEffectCounter - The side effect counter at the start of the call.
636
- * @param isStaticCall - Whether the call is a static call.
637
- */
638
- public privateNotifyEnqueuedPublicFunctionCall(
639
- _targetContractAddress: AztecAddress,
640
- calldataHash: Fr,
641
- _sideEffectCounter: number,
642
- _isStaticCall: boolean,
643
- ) {
644
- this.#onNewPublicFunctionCall(calldataHash);
645
638
  return Promise.resolve();
646
639
  }
647
640
 
648
- /**
649
- * Verify relevant information when a public teardown function is set.
650
- * @param targetContractAddress - The address of the contract to call.
651
- * @param argsHash - The arguments hash to pass to the function.
652
- * @param sideEffectCounter - The side effect counter at the start of the call.
653
- * @param isStaticCall - Whether the call is a static call.
654
- */
655
- public privateNotifySetPublicTeardownFunctionCall(
656
- _targetContractAddress: AztecAddress,
657
- calldataHash: Fr,
658
- _sideEffectCounter: number,
659
- _isStaticCall: boolean,
660
- ) {
661
- this.#onNewPublicFunctionCall(calldataHash);
662
- return Promise.resolve();
641
+ public getTotalPublicCalldataCount(): number {
642
+ return this.totalPublicCalldataCount;
663
643
  }
664
644
 
665
- public privateNotifySetMinRevertibleSideEffectCounter(minRevertibleSideEffectCounter: number): Promise<void> {
645
+ public notifyRevertiblePhaseStart(minRevertibleSideEffectCounter: number): Promise<void> {
666
646
  return this.noteCache.setMinRevertibleSideEffectCounter(minRevertibleSideEffectCounter);
667
647
  }
668
648
 
669
- public privateIsSideEffectCounterRevertible(sideEffectCounter: number): Promise<boolean> {
649
+ public isExecutionInRevertiblePhase(sideEffectCounter: number): Promise<boolean> {
670
650
  return Promise.resolve(this.noteCache.isSideEffectCounterRevertible(sideEffectCounter));
671
651
  }
672
652
 
@@ -694,8 +674,7 @@ export class PrivateExecutionOracle extends UtilityExecutionOracle implements IP
694
674
  return this.contractStore.getDebugFunctionName(this.contractAddress, this.callContext.functionSelector);
695
675
  }
696
676
 
697
- public utilityEmitOffchainEffect(data: Fr[]): Promise<void> {
698
- this.offchainEffects.push({ data });
699
- return Promise.resolve();
677
+ protected override get callerContext() {
678
+ return this.callContext.isStaticCall ? 'private view' : 'private';
700
679
  }
701
680
  }