@aztec/pxe 0.0.1-fake-ceab37513c → 0.0.6-commit.a2d1860fe9

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 (442) hide show
  1. package/README.md +5 -5
  2. package/dest/access_scopes.d.ts +9 -0
  3. package/dest/access_scopes.d.ts.map +1 -0
  4. package/dest/access_scopes.js +6 -0
  5. package/dest/bin/check_oracle_version.d.ts +1 -1
  6. package/dest/bin/check_oracle_version.js +110 -10
  7. package/dest/block_synchronizer/block_synchronizer.d.ts +45 -0
  8. package/dest/block_synchronizer/block_synchronizer.d.ts.map +1 -0
  9. package/dest/block_synchronizer/block_synchronizer.js +153 -0
  10. package/dest/block_synchronizer/index.d.ts +2 -0
  11. package/dest/block_synchronizer/index.d.ts.map +1 -0
  12. package/dest/block_synchronizer/index.js +1 -0
  13. package/dest/config/index.d.ts +11 -17
  14. package/dest/config/index.d.ts.map +1 -1
  15. package/dest/config/index.js +27 -16
  16. package/dest/config/package_info.d.ts +1 -1
  17. package/dest/config/package_info.js +1 -1
  18. package/dest/contract_function_simulator/benchmarked_node.d.ts +9 -0
  19. package/dest/contract_function_simulator/benchmarked_node.d.ts.map +1 -0
  20. package/dest/contract_function_simulator/benchmarked_node.js +77 -0
  21. package/dest/contract_function_simulator/contract_function_simulator.d.ts +79 -27
  22. package/dest/contract_function_simulator/contract_function_simulator.d.ts.map +1 -1
  23. package/dest/contract_function_simulator/contract_function_simulator.js +287 -87
  24. package/dest/contract_function_simulator/execution_note_cache.d.ts +26 -15
  25. package/dest/contract_function_simulator/execution_note_cache.d.ts.map +1 -1
  26. package/dest/contract_function_simulator/execution_note_cache.js +65 -37
  27. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts +16 -0
  28. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts.map +1 -0
  29. package/dest/contract_function_simulator/execution_tagging_index_cache.js +26 -0
  30. package/dest/contract_function_simulator/hashed_values_cache.d.ts +2 -2
  31. package/dest/contract_function_simulator/hashed_values_cache.d.ts.map +1 -1
  32. package/dest/contract_function_simulator/index.d.ts +5 -3
  33. package/dest/contract_function_simulator/index.d.ts.map +1 -1
  34. package/dest/contract_function_simulator/index.js +3 -2
  35. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts +5 -4
  36. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts.map +1 -1
  37. package/dest/contract_function_simulator/noir-structs/event_validation_request.js +7 -4
  38. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.d.ts +5 -4
  39. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.d.ts.map +1 -1
  40. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.js +7 -6
  41. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts +3 -3
  42. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts.map +1 -1
  43. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.js +8 -4
  44. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts +7 -4
  45. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts.map +1 -1
  46. package/dest/contract_function_simulator/noir-structs/note_validation_request.js +13 -4
  47. package/dest/contract_function_simulator/noir-structs/utility_context.d.ts +16 -0
  48. package/dest/contract_function_simulator/noir-structs/utility_context.d.ts.map +1 -0
  49. package/dest/contract_function_simulator/noir-structs/utility_context.js +22 -0
  50. package/dest/contract_function_simulator/oracle/index.d.ts +2 -2
  51. package/dest/contract_function_simulator/oracle/index.d.ts.map +1 -1
  52. package/dest/contract_function_simulator/oracle/index.js +1 -1
  53. package/dest/contract_function_simulator/oracle/interfaces.d.ts +107 -0
  54. package/dest/contract_function_simulator/oracle/interfaces.d.ts.map +1 -0
  55. package/dest/contract_function_simulator/oracle/interfaces.js +4 -0
  56. package/dest/contract_function_simulator/oracle/message_load_oracle_inputs.d.ts +2 -2
  57. package/dest/contract_function_simulator/oracle/message_load_oracle_inputs.d.ts.map +1 -1
  58. package/dest/contract_function_simulator/oracle/message_load_oracle_inputs.js +1 -1
  59. package/dest/contract_function_simulator/oracle/note_packing_utils.d.ts +14 -8
  60. package/dest/contract_function_simulator/oracle/note_packing_utils.d.ts.map +1 -1
  61. package/dest/contract_function_simulator/oracle/note_packing_utils.js +16 -11
  62. package/dest/contract_function_simulator/oracle/oracle.d.ts +26 -22
  63. package/dest/contract_function_simulator/oracle/oracle.d.ts.map +1 -1
  64. package/dest/contract_function_simulator/oracle/oracle.js +156 -113
  65. package/dest/contract_function_simulator/oracle/private_execution.d.ts +2 -27
  66. package/dest/contract_function_simulator/oracle/private_execution.d.ts.map +1 -1
  67. package/dest/contract_function_simulator/oracle/private_execution.js +3 -48
  68. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts +72 -52
  69. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts.map +1 -1
  70. package/dest/contract_function_simulator/oracle/private_execution_oracle.js +173 -68
  71. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts +116 -53
  72. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts.map +1 -1
  73. package/dest/contract_function_simulator/oracle/utility_execution_oracle.js +217 -94
  74. package/dest/contract_function_simulator/pick_notes.d.ts +2 -2
  75. package/dest/contract_function_simulator/pick_notes.d.ts.map +1 -1
  76. package/dest/contract_function_simulator/pick_notes.js +1 -1
  77. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts +4 -4
  78. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts.map +1 -1
  79. package/dest/contract_function_simulator/proxied_contract_data_source.js +23 -5
  80. package/dest/contract_logging.d.ts +22 -0
  81. package/dest/contract_logging.d.ts.map +1 -0
  82. package/dest/contract_logging.js +23 -0
  83. package/dest/contract_sync/contract_sync_service.d.ts +43 -0
  84. package/dest/contract_sync/contract_sync_service.d.ts.map +1 -0
  85. package/dest/contract_sync/contract_sync_service.js +97 -0
  86. package/dest/contract_sync/helpers.d.ts +29 -0
  87. package/dest/contract_sync/helpers.d.ts.map +1 -0
  88. package/dest/contract_sync/helpers.js +55 -0
  89. package/dest/debug/pxe_debug_utils.d.ts +45 -0
  90. package/dest/debug/pxe_debug_utils.d.ts.map +1 -0
  91. package/dest/debug/pxe_debug_utils.js +48 -0
  92. package/dest/entrypoints/client/bundle/index.d.ts +7 -3
  93. package/dest/entrypoints/client/bundle/index.d.ts.map +1 -1
  94. package/dest/entrypoints/client/bundle/index.js +5 -2
  95. package/dest/entrypoints/client/bundle/utils.d.ts +9 -9
  96. package/dest/entrypoints/client/bundle/utils.d.ts.map +1 -1
  97. package/dest/entrypoints/client/bundle/utils.js +40 -17
  98. package/dest/entrypoints/client/lazy/index.d.ts +7 -3
  99. package/dest/entrypoints/client/lazy/index.d.ts.map +1 -1
  100. package/dest/entrypoints/client/lazy/index.js +5 -2
  101. package/dest/entrypoints/client/lazy/utils.d.ts +9 -9
  102. package/dest/entrypoints/client/lazy/utils.d.ts.map +1 -1
  103. package/dest/entrypoints/client/lazy/utils.js +40 -17
  104. package/dest/entrypoints/pxe_creation_options.d.ts +7 -3
  105. package/dest/entrypoints/pxe_creation_options.d.ts.map +1 -1
  106. package/dest/entrypoints/server/index.d.ts +9 -3
  107. package/dest/entrypoints/server/index.d.ts.map +1 -1
  108. package/dest/entrypoints/server/index.js +7 -2
  109. package/dest/entrypoints/server/utils.d.ts +5 -24
  110. package/dest/entrypoints/server/utils.d.ts.map +1 -1
  111. package/dest/entrypoints/server/utils.js +42 -51
  112. package/dest/error_enriching.d.ts +11 -0
  113. package/dest/error_enriching.d.ts.map +1 -0
  114. package/dest/{pxe_service/error_enriching.js → error_enriching.js} +9 -6
  115. package/dest/events/event_service.d.ts +15 -0
  116. package/dest/events/event_service.d.ts.map +1 -0
  117. package/dest/events/event_service.js +44 -0
  118. package/dest/events/index.d.ts +2 -0
  119. package/dest/events/index.d.ts.map +1 -0
  120. package/dest/events/index.js +1 -0
  121. package/dest/events/private_event_filter_validator.d.ts +9 -0
  122. package/dest/events/private_event_filter_validator.d.ts.map +1 -0
  123. package/dest/events/private_event_filter_validator.js +38 -0
  124. package/dest/job_coordinator/job_coordinator.d.ts +75 -0
  125. package/dest/job_coordinator/job_coordinator.d.ts.map +1 -0
  126. package/dest/job_coordinator/job_coordinator.js +94 -0
  127. package/dest/logs/log_service.d.ts +29 -0
  128. package/dest/logs/log_service.d.ts.map +1 -0
  129. package/dest/logs/log_service.js +118 -0
  130. package/dest/notes/index.d.ts +2 -0
  131. package/dest/notes/index.d.ts.map +1 -0
  132. package/dest/notes/index.js +1 -0
  133. package/dest/notes/note_service.d.ts +49 -0
  134. package/dest/notes/note_service.d.ts.map +1 -0
  135. package/dest/notes/note_service.js +148 -0
  136. package/dest/notes_filter.d.ts +25 -0
  137. package/dest/notes_filter.d.ts.map +1 -0
  138. package/dest/notes_filter.js +4 -0
  139. package/dest/oracle_version.d.ts +3 -3
  140. package/dest/oracle_version.d.ts.map +1 -1
  141. package/dest/oracle_version.js +4 -3
  142. package/dest/private_kernel/hints/compute_tx_expiration_timestamp.d.ts +4 -0
  143. package/dest/private_kernel/hints/compute_tx_expiration_timestamp.d.ts.map +1 -0
  144. package/dest/private_kernel/hints/compute_tx_expiration_timestamp.js +41 -0
  145. package/dest/private_kernel/hints/index.d.ts +3 -3
  146. package/dest/private_kernel/hints/index.d.ts.map +1 -1
  147. package/dest/private_kernel/hints/index.js +2 -2
  148. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts +28 -0
  149. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts.map +1 -0
  150. package/dest/private_kernel/hints/{build_private_kernel_reset_private_inputs.js → private_kernel_reset_private_inputs_builder.js} +22 -16
  151. package/dest/private_kernel/index.d.ts +1 -1
  152. package/dest/private_kernel/private_kernel_execution_prover.d.ts +11 -3
  153. package/dest/private_kernel/private_kernel_execution_prover.d.ts.map +1 -1
  154. package/dest/private_kernel/private_kernel_execution_prover.js +48 -43
  155. package/dest/private_kernel/private_kernel_oracle.d.ts +26 -25
  156. package/dest/private_kernel/private_kernel_oracle.d.ts.map +1 -1
  157. package/dest/private_kernel/private_kernel_oracle.js +94 -2
  158. package/dest/pxe.d.ts +250 -0
  159. package/dest/pxe.d.ts.map +1 -0
  160. package/dest/pxe.js +774 -0
  161. package/dest/storage/address_store/address_store.d.ts +11 -0
  162. package/dest/storage/address_store/address_store.d.ts.map +1 -0
  163. package/dest/storage/{address_data_provider/address_data_provider.js → address_store/address_store.js} +13 -15
  164. package/dest/storage/address_store/index.d.ts +2 -0
  165. package/dest/storage/address_store/index.d.ts.map +1 -0
  166. package/dest/storage/address_store/index.js +1 -0
  167. package/dest/storage/anchor_block_store/anchor_block_store.d.ts +17 -0
  168. package/dest/storage/anchor_block_store/anchor_block_store.d.ts.map +1 -0
  169. package/dest/storage/{sync_data_provider/sync_data_provider.js → anchor_block_store/anchor_block_store.js} +10 -13
  170. package/dest/storage/anchor_block_store/index.d.ts +2 -0
  171. package/dest/storage/anchor_block_store/index.d.ts.map +1 -0
  172. package/dest/storage/anchor_block_store/index.js +1 -0
  173. package/dest/storage/capsule_store/capsule_store.d.ts +72 -0
  174. package/dest/storage/capsule_store/capsule_store.d.ts.map +1 -0
  175. package/dest/storage/capsule_store/capsule_store.js +253 -0
  176. package/dest/storage/capsule_store/index.d.ts +2 -0
  177. package/dest/storage/capsule_store/index.d.ts.map +1 -0
  178. package/dest/storage/capsule_store/index.js +1 -0
  179. package/dest/storage/contract_store/contract_store.d.ts +93 -0
  180. package/dest/storage/contract_store/contract_store.d.ts.map +1 -0
  181. package/dest/storage/contract_store/contract_store.js +309 -0
  182. package/dest/storage/contract_store/index.d.ts +2 -0
  183. package/dest/storage/contract_store/index.d.ts.map +1 -0
  184. package/dest/storage/contract_store/index.js +1 -0
  185. package/dest/storage/{contract_data_provider → contract_store}/private_functions_tree.d.ts +1 -1
  186. package/dest/storage/contract_store/private_functions_tree.d.ts.map +1 -0
  187. package/dest/storage/{contract_data_provider → contract_store}/private_functions_tree.js +1 -1
  188. package/dest/storage/index.d.ts +8 -9
  189. package/dest/storage/index.d.ts.map +1 -1
  190. package/dest/storage/index.js +7 -8
  191. package/dest/storage/metadata.d.ts +2 -2
  192. package/dest/storage/metadata.js +1 -1
  193. package/dest/storage/note_store/index.d.ts +3 -0
  194. package/dest/storage/note_store/index.d.ts.map +1 -0
  195. package/dest/storage/note_store/index.js +2 -0
  196. package/dest/storage/note_store/note_store.d.ts +83 -0
  197. package/dest/storage/note_store/note_store.d.ts.map +1 -0
  198. package/dest/storage/note_store/note_store.js +343 -0
  199. package/dest/storage/note_store/stored_note.d.ts +16 -0
  200. package/dest/storage/note_store/stored_note.d.ts.map +1 -0
  201. package/dest/storage/note_store/stored_note.js +43 -0
  202. package/dest/storage/private_event_store/private_event_store.d.ts +91 -0
  203. package/dest/storage/private_event_store/private_event_store.d.ts.map +1 -0
  204. package/dest/storage/private_event_store/private_event_store.js +273 -0
  205. package/dest/storage/private_event_store/stored_private_event.d.ts +23 -0
  206. package/dest/storage/private_event_store/stored_private_event.d.ts.map +1 -0
  207. package/dest/storage/private_event_store/stored_private_event.js +56 -0
  208. package/dest/storage/tagging_store/index.d.ts +4 -0
  209. package/dest/storage/tagging_store/index.d.ts.map +1 -0
  210. package/dest/storage/tagging_store/index.js +3 -0
  211. package/dest/storage/tagging_store/recipient_tagging_store.d.ts +28 -0
  212. package/dest/storage/tagging_store/recipient_tagging_store.d.ts.map +1 -0
  213. package/dest/storage/tagging_store/recipient_tagging_store.js +111 -0
  214. package/dest/storage/tagging_store/sender_address_book_store.d.ts +14 -0
  215. package/dest/storage/tagging_store/sender_address_book_store.d.ts.map +1 -0
  216. package/dest/storage/tagging_store/sender_address_book_store.js +36 -0
  217. package/dest/storage/tagging_store/sender_tagging_store.d.ts +77 -0
  218. package/dest/storage/tagging_store/sender_tagging_store.d.ts.map +1 -0
  219. package/dest/storage/tagging_store/sender_tagging_store.js +348 -0
  220. package/dest/tagging/constants.d.ts +2 -0
  221. package/dest/tagging/constants.d.ts.map +1 -0
  222. package/dest/tagging/constants.js +10 -0
  223. package/dest/tagging/get_all_logs_by_tags.d.ts +24 -0
  224. package/dest/tagging/get_all_logs_by_tags.d.ts.map +1 -0
  225. package/dest/tagging/get_all_logs_by_tags.js +60 -0
  226. package/dest/tagging/index.d.ts +17 -0
  227. package/dest/tagging/index.d.ts.map +1 -0
  228. package/dest/tagging/index.js +15 -0
  229. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts +15 -0
  230. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts.map +1 -0
  231. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.js +99 -0
  232. package/dest/tagging/recipient_sync/utils/find_highest_indexes.d.ts +12 -0
  233. package/dest/tagging/recipient_sync/utils/find_highest_indexes.d.ts.map +1 -0
  234. package/dest/tagging/recipient_sync/utils/find_highest_indexes.js +20 -0
  235. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts +15 -0
  236. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts.map +1 -0
  237. package/dest/tagging/recipient_sync/utils/load_logs_for_range.js +32 -0
  238. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts +21 -0
  239. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts.map +1 -0
  240. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.js +74 -0
  241. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts +11 -0
  242. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts.map +1 -0
  243. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.js +29 -0
  244. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts +21 -0
  245. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts.map +1 -0
  246. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.js +60 -0
  247. package/package.json +30 -23
  248. package/src/access_scopes.ts +9 -0
  249. package/src/bin/check_oracle_version.ts +135 -10
  250. package/src/block_synchronizer/block_synchronizer.ts +178 -0
  251. package/src/block_synchronizer/index.ts +1 -0
  252. package/src/config/index.ts +32 -32
  253. package/src/config/package_info.ts +1 -1
  254. package/src/contract_function_simulator/benchmarked_node.ts +103 -0
  255. package/src/contract_function_simulator/contract_function_simulator.ts +505 -140
  256. package/src/contract_function_simulator/execution_note_cache.ts +67 -32
  257. package/src/contract_function_simulator/execution_tagging_index_cache.ts +32 -0
  258. package/src/contract_function_simulator/hashed_values_cache.ts +1 -1
  259. package/src/contract_function_simulator/index.ts +4 -2
  260. package/src/contract_function_simulator/noir-structs/event_validation_request.ts +7 -3
  261. package/src/contract_function_simulator/noir-structs/log_retrieval_request.ts +6 -5
  262. package/src/contract_function_simulator/noir-structs/log_retrieval_response.ts +10 -5
  263. package/src/contract_function_simulator/noir-structs/note_validation_request.ts +15 -3
  264. package/src/contract_function_simulator/noir-structs/utility_context.ts +23 -0
  265. package/src/contract_function_simulator/oracle/index.ts +1 -1
  266. package/src/contract_function_simulator/oracle/interfaces.ts +185 -0
  267. package/src/contract_function_simulator/oracle/message_load_oracle_inputs.ts +1 -1
  268. package/src/contract_function_simulator/oracle/note_packing_utils.ts +30 -14
  269. package/src/contract_function_simulator/oracle/oracle.ts +197 -110
  270. package/src/contract_function_simulator/oracle/private_execution.ts +4 -78
  271. package/src/contract_function_simulator/oracle/private_execution_oracle.ts +248 -122
  272. package/src/contract_function_simulator/oracle/utility_execution_oracle.ts +372 -138
  273. package/src/contract_function_simulator/pick_notes.ts +1 -1
  274. package/src/contract_function_simulator/proxied_contract_data_source.ts +24 -7
  275. package/src/contract_logging.ts +39 -0
  276. package/src/contract_sync/contract_sync_service.ts +152 -0
  277. package/src/contract_sync/helpers.ts +98 -0
  278. package/src/debug/pxe_debug_utils.ts +93 -0
  279. package/src/entrypoints/client/bundle/index.ts +6 -2
  280. package/src/entrypoints/client/bundle/utils.ts +31 -32
  281. package/src/entrypoints/client/lazy/index.ts +6 -2
  282. package/src/entrypoints/client/lazy/utils.ts +31 -32
  283. package/src/entrypoints/pxe_creation_options.ts +6 -2
  284. package/src/entrypoints/server/index.ts +8 -2
  285. package/src/entrypoints/server/utils.ts +39 -91
  286. package/src/{pxe_service/error_enriching.ts → error_enriching.ts} +11 -15
  287. package/src/events/event_service.ts +71 -0
  288. package/src/events/index.ts +1 -0
  289. package/src/events/private_event_filter_validator.ts +46 -0
  290. package/src/job_coordinator/job_coordinator.ts +150 -0
  291. package/src/logs/log_service.ts +208 -0
  292. package/src/notes/index.ts +1 -0
  293. package/src/notes/note_service.ts +196 -0
  294. package/src/notes_filter.ts +26 -0
  295. package/src/oracle_version.ts +4 -3
  296. package/src/private_kernel/hints/{compute_tx_include_by_timestamp.ts → compute_tx_expiration_timestamp.ts} +16 -16
  297. package/src/private_kernel/hints/index.ts +2 -2
  298. package/src/private_kernel/hints/{build_private_kernel_reset_private_inputs.ts → private_kernel_reset_private_inputs_builder.ts} +44 -37
  299. package/src/private_kernel/private_kernel_execution_prover.ts +64 -55
  300. package/src/private_kernel/private_kernel_oracle.ts +118 -37
  301. package/src/pxe.ts +1137 -0
  302. package/src/storage/{address_data_provider/address_data_provider.ts → address_store/address_store.ts} +15 -21
  303. package/src/storage/address_store/index.ts +1 -0
  304. package/src/storage/{sync_data_provider/sync_data_provider.ts → anchor_block_store/anchor_block_store.ts} +10 -17
  305. package/src/storage/anchor_block_store/index.ts +1 -0
  306. package/src/storage/capsule_store/capsule_store.ts +315 -0
  307. package/src/storage/capsule_store/index.ts +1 -0
  308. package/src/storage/contract_store/contract_store.ts +429 -0
  309. package/src/storage/contract_store/index.ts +1 -0
  310. package/src/storage/{contract_data_provider → contract_store}/private_functions_tree.ts +1 -1
  311. package/src/storage/index.ts +7 -8
  312. package/src/storage/metadata.ts +1 -1
  313. package/src/storage/note_store/index.ts +2 -0
  314. package/src/storage/note_store/note_store.ts +418 -0
  315. package/src/storage/note_store/stored_note.ts +48 -0
  316. package/src/storage/private_event_store/private_event_store.ts +384 -0
  317. package/src/storage/private_event_store/stored_private_event.ts +73 -0
  318. package/src/storage/tagging_store/index.ts +3 -0
  319. package/src/storage/tagging_store/recipient_tagging_store.ts +139 -0
  320. package/src/storage/tagging_store/sender_address_book_store.ts +48 -0
  321. package/src/storage/tagging_store/sender_tagging_store.ts +429 -0
  322. package/src/tagging/constants.ts +10 -0
  323. package/src/tagging/get_all_logs_by_tags.ts +92 -0
  324. package/src/tagging/index.ts +19 -0
  325. package/src/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.ts +143 -0
  326. package/src/tagging/recipient_sync/utils/find_highest_indexes.ts +34 -0
  327. package/src/tagging/recipient_sync/utils/load_logs_for_range.ts +49 -0
  328. package/src/tagging/sender_sync/sync_sender_tagging_indexes.ts +99 -0
  329. package/src/tagging/sender_sync/utils/get_status_change_of_pending.ts +36 -0
  330. package/src/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.ts +84 -0
  331. package/dest/bin/index.d.ts +0 -3
  332. package/dest/bin/index.d.ts.map +0 -1
  333. package/dest/bin/index.js +0 -48
  334. package/dest/contract_function_simulator/execution_data_provider.d.ts +0 -285
  335. package/dest/contract_function_simulator/execution_data_provider.d.ts.map +0 -1
  336. package/dest/contract_function_simulator/execution_data_provider.js +0 -14
  337. package/dest/contract_function_simulator/oracle/typed_oracle.d.ts +0 -87
  338. package/dest/contract_function_simulator/oracle/typed_oracle.d.ts.map +0 -1
  339. package/dest/contract_function_simulator/oracle/typed_oracle.js +0 -146
  340. package/dest/contract_function_simulator/proxied_node.d.ts +0 -9
  341. package/dest/contract_function_simulator/proxied_node.d.ts.map +0 -1
  342. package/dest/contract_function_simulator/proxied_node.js +0 -27
  343. package/dest/contract_function_simulator/pxe_oracle_interface.d.ts +0 -158
  344. package/dest/contract_function_simulator/pxe_oracle_interface.d.ts.map +0 -1
  345. package/dest/contract_function_simulator/pxe_oracle_interface.js +0 -701
  346. package/dest/contract_function_simulator/tagging_utils.d.ts +0 -17
  347. package/dest/contract_function_simulator/tagging_utils.d.ts.map +0 -1
  348. package/dest/contract_function_simulator/tagging_utils.js +0 -23
  349. package/dest/private_kernel/hints/build_private_kernel_reset_private_inputs.d.ts +0 -28
  350. package/dest/private_kernel/hints/build_private_kernel_reset_private_inputs.d.ts.map +0 -1
  351. package/dest/private_kernel/hints/compute_tx_include_by_timestamp.d.ts +0 -4
  352. package/dest/private_kernel/hints/compute_tx_include_by_timestamp.d.ts.map +0 -1
  353. package/dest/private_kernel/hints/compute_tx_include_by_timestamp.js +0 -41
  354. package/dest/private_kernel/private_kernel_oracle_impl.d.ts +0 -45
  355. package/dest/private_kernel/private_kernel_oracle_impl.d.ts.map +0 -1
  356. package/dest/private_kernel/private_kernel_oracle_impl.js +0 -86
  357. package/dest/pxe_service/error_enriching.d.ts +0 -11
  358. package/dest/pxe_service/error_enriching.d.ts.map +0 -1
  359. package/dest/pxe_service/index.d.ts +0 -3
  360. package/dest/pxe_service/index.d.ts.map +0 -1
  361. package/dest/pxe_service/index.js +0 -2
  362. package/dest/pxe_service/pxe_service.d.ts +0 -101
  363. package/dest/pxe_service/pxe_service.d.ts.map +0 -1
  364. package/dest/pxe_service/pxe_service.js +0 -791
  365. package/dest/storage/address_data_provider/address_data_provider.d.ts +0 -13
  366. package/dest/storage/address_data_provider/address_data_provider.d.ts.map +0 -1
  367. package/dest/storage/address_data_provider/index.d.ts +0 -2
  368. package/dest/storage/address_data_provider/index.d.ts.map +0 -1
  369. package/dest/storage/address_data_provider/index.js +0 -1
  370. package/dest/storage/capsule_data_provider/capsule_data_provider.d.ts +0 -27
  371. package/dest/storage/capsule_data_provider/capsule_data_provider.d.ts.map +0 -1
  372. package/dest/storage/capsule_data_provider/capsule_data_provider.js +0 -122
  373. package/dest/storage/capsule_data_provider/index.d.ts +0 -2
  374. package/dest/storage/capsule_data_provider/index.d.ts.map +0 -1
  375. package/dest/storage/capsule_data_provider/index.js +0 -1
  376. package/dest/storage/contract_data_provider/contract_data_provider.d.ts +0 -75
  377. package/dest/storage/contract_data_provider/contract_data_provider.d.ts.map +0 -1
  378. package/dest/storage/contract_data_provider/contract_data_provider.js +0 -208
  379. package/dest/storage/contract_data_provider/index.d.ts +0 -2
  380. package/dest/storage/contract_data_provider/index.d.ts.map +0 -1
  381. package/dest/storage/contract_data_provider/index.js +0 -1
  382. package/dest/storage/contract_data_provider/private_functions_tree.d.ts.map +0 -1
  383. package/dest/storage/data_provider.d.ts +0 -4
  384. package/dest/storage/data_provider.d.ts.map +0 -1
  385. package/dest/storage/data_provider.js +0 -1
  386. package/dest/storage/note_data_provider/index.d.ts +0 -3
  387. package/dest/storage/note_data_provider/index.d.ts.map +0 -1
  388. package/dest/storage/note_data_provider/index.js +0 -2
  389. package/dest/storage/note_data_provider/note_dao.d.ts +0 -100
  390. package/dest/storage/note_data_provider/note_dao.d.ts.map +0 -1
  391. package/dest/storage/note_data_provider/note_dao.js +0 -102
  392. package/dest/storage/note_data_provider/note_data_provider.d.ts +0 -20
  393. package/dest/storage/note_data_provider/note_data_provider.d.ts.map +0 -1
  394. package/dest/storage/note_data_provider/note_data_provider.js +0 -260
  395. package/dest/storage/private_event_data_provider/private_event_data_provider.d.ts +0 -37
  396. package/dest/storage/private_event_data_provider/private_event_data_provider.d.ts.map +0 -1
  397. package/dest/storage/private_event_data_provider/private_event_data_provider.js +0 -96
  398. package/dest/storage/sync_data_provider/index.d.ts +0 -2
  399. package/dest/storage/sync_data_provider/index.d.ts.map +0 -1
  400. package/dest/storage/sync_data_provider/index.js +0 -1
  401. package/dest/storage/sync_data_provider/sync_data_provider.d.ts +0 -12
  402. package/dest/storage/sync_data_provider/sync_data_provider.d.ts.map +0 -1
  403. package/dest/storage/tagging_data_provider/index.d.ts +0 -2
  404. package/dest/storage/tagging_data_provider/index.d.ts.map +0 -1
  405. package/dest/storage/tagging_data_provider/index.js +0 -1
  406. package/dest/storage/tagging_data_provider/tagging_data_provider.d.ts +0 -18
  407. package/dest/storage/tagging_data_provider/tagging_data_provider.d.ts.map +0 -1
  408. package/dest/storage/tagging_data_provider/tagging_data_provider.js +0 -82
  409. package/dest/synchronizer/index.d.ts +0 -2
  410. package/dest/synchronizer/index.d.ts.map +0 -1
  411. package/dest/synchronizer/index.js +0 -1
  412. package/dest/synchronizer/synchronizer.d.ts +0 -35
  413. package/dest/synchronizer/synchronizer.d.ts.map +0 -1
  414. package/dest/synchronizer/synchronizer.js +0 -102
  415. package/dest/test/pxe_test_suite.d.ts +0 -3
  416. package/dest/test/pxe_test_suite.d.ts.map +0 -1
  417. package/dest/test/pxe_test_suite.js +0 -97
  418. package/src/bin/index.ts +0 -62
  419. package/src/contract_function_simulator/execution_data_provider.ts +0 -361
  420. package/src/contract_function_simulator/oracle/typed_oracle.ts +0 -289
  421. package/src/contract_function_simulator/proxied_node.ts +0 -33
  422. package/src/contract_function_simulator/pxe_oracle_interface.ts +0 -1020
  423. package/src/contract_function_simulator/tagging_utils.ts +0 -32
  424. package/src/private_kernel/private_kernel_oracle_impl.ts +0 -132
  425. package/src/pxe_service/index.ts +0 -2
  426. package/src/pxe_service/pxe_service.ts +0 -1139
  427. package/src/storage/address_data_provider/index.ts +0 -1
  428. package/src/storage/capsule_data_provider/capsule_data_provider.ts +0 -157
  429. package/src/storage/capsule_data_provider/index.ts +0 -1
  430. package/src/storage/contract_data_provider/contract_data_provider.ts +0 -300
  431. package/src/storage/contract_data_provider/index.ts +0 -1
  432. package/src/storage/data_provider.ts +0 -3
  433. package/src/storage/note_data_provider/index.ts +0 -2
  434. package/src/storage/note_data_provider/note_dao.ts +0 -154
  435. package/src/storage/note_data_provider/note_data_provider.ts +0 -350
  436. package/src/storage/private_event_data_provider/private_event_data_provider.ts +0 -134
  437. package/src/storage/sync_data_provider/index.ts +0 -1
  438. package/src/storage/tagging_data_provider/index.ts +0 -1
  439. package/src/storage/tagging_data_provider/tagging_data_provider.ts +0 -123
  440. package/src/synchronizer/index.ts +0 -1
  441. package/src/synchronizer/synchronizer.ts +0 -121
  442. package/src/test/pxe_test_suite.ts +0 -113
@@ -1,63 +1,125 @@
1
- import { Aes128 } from '@aztec/foundation/crypto';
2
- import { Fr, Point } from '@aztec/foundation/fields';
3
- import { applyStringFormatting, createLogger } from '@aztec/foundation/log';
1
+ import type { ARCHIVE_HEIGHT, NOTE_HASH_TREE_HEIGHT } from '@aztec/constants';
2
+ import type { BlockNumber } from '@aztec/foundation/branded-types';
3
+ import { Aes128 } from '@aztec/foundation/crypto/aes128';
4
+ import { Fr } from '@aztec/foundation/curves/bn254';
5
+ import { Point } from '@aztec/foundation/curves/grumpkin';
6
+ import { LogLevels, type Logger, createLogger } from '@aztec/foundation/log';
7
+ import type { MembershipWitness } from '@aztec/foundation/trees';
8
+ import type { KeyStore } from '@aztec/key-store';
4
9
  import type { AuthWitness } from '@aztec/stdlib/auth-witness';
5
10
  import { AztecAddress } from '@aztec/stdlib/aztec-address';
11
+ import { BlockHash } from '@aztec/stdlib/block';
6
12
  import type { CompleteAddress, ContractInstance } from '@aztec/stdlib/contract';
7
13
  import { siloNullifier } from '@aztec/stdlib/hash';
14
+ import type { AztecNode } from '@aztec/stdlib/interfaces/server';
8
15
  import type { KeyValidationRequest } from '@aztec/stdlib/kernel';
9
- import { IndexedTaggingSecret } from '@aztec/stdlib/logs';
16
+ import { computeAddressSecret } from '@aztec/stdlib/keys';
17
+ import { deriveEcdhSharedSecret } from '@aztec/stdlib/logs';
18
+ import { getNonNullifiedL1ToL2MessageWitness } from '@aztec/stdlib/messaging';
10
19
  import type { NoteStatus } from '@aztec/stdlib/note';
11
- import { type MerkleTreeId, type NullifierMembershipWitness, PublicDataWitness } from '@aztec/stdlib/trees';
20
+ import { MerkleTreeId, type NullifierMembershipWitness, PublicDataWitness } from '@aztec/stdlib/trees';
12
21
  import type { BlockHeader, Capsule } from '@aztec/stdlib/tx';
13
- import type { UInt64 } from '@aztec/stdlib/types';
14
22
 
15
- import type { ExecutionDataProvider } from '../execution_data_provider.js';
23
+ import type { AccessScopes } from '../../access_scopes.js';
24
+ import { createContractLogger, logContractMessage } from '../../contract_logging.js';
25
+ import { EventService } from '../../events/event_service.js';
26
+ import { LogService } from '../../logs/log_service.js';
27
+ import { NoteService } from '../../notes/note_service.js';
28
+ import { ORACLE_VERSION } from '../../oracle_version.js';
29
+ import type { AddressStore } from '../../storage/address_store/address_store.js';
30
+ import type { CapsuleStore } from '../../storage/capsule_store/capsule_store.js';
31
+ import type { ContractStore } from '../../storage/contract_store/contract_store.js';
32
+ import type { NoteStore } from '../../storage/note_store/note_store.js';
33
+ import type { PrivateEventStore } from '../../storage/private_event_store/private_event_store.js';
34
+ import type { RecipientTaggingStore } from '../../storage/tagging_store/recipient_tagging_store.js';
35
+ import type { SenderAddressBookStore } from '../../storage/tagging_store/sender_address_book_store.js';
36
+ import { EventValidationRequest } from '../noir-structs/event_validation_request.js';
37
+ import { LogRetrievalRequest } from '../noir-structs/log_retrieval_request.js';
38
+ import { LogRetrievalResponse } from '../noir-structs/log_retrieval_response.js';
39
+ import { NoteValidationRequest } from '../noir-structs/note_validation_request.js';
40
+ import { UtilityContext } from '../noir-structs/utility_context.js';
16
41
  import { pickNotes } from '../pick_notes.js';
17
- import { type NoteData, TypedOracle } from './typed_oracle.js';
42
+ import type { IMiscOracle, IUtilityExecutionOracle, NoteData } from './interfaces.js';
43
+ import { MessageLoadOracleInputs } from './message_load_oracle_inputs.js';
44
+
45
+ /** Args for UtilityExecutionOracle constructor. */
46
+ export type UtilityExecutionOracleArgs = {
47
+ contractAddress: AztecAddress;
48
+ /** List of transient auth witnesses to be used during this simulation */
49
+ authWitnesses: AuthWitness[];
50
+ capsules: Capsule[]; // TODO(#12425): Rename to transientCapsules
51
+ anchorBlockHeader: BlockHeader;
52
+ contractStore: ContractStore;
53
+ noteStore: NoteStore;
54
+ keyStore: KeyStore;
55
+ addressStore: AddressStore;
56
+ aztecNode: AztecNode;
57
+ recipientTaggingStore: RecipientTaggingStore;
58
+ senderAddressBookStore: SenderAddressBookStore;
59
+ capsuleStore: CapsuleStore;
60
+ privateEventStore: PrivateEventStore;
61
+ jobId: string;
62
+ log?: ReturnType<typeof createLogger>;
63
+ scopes: AccessScopes;
64
+ };
18
65
 
19
66
  /**
20
67
  * The oracle for an execution of utility contract functions.
21
68
  */
22
- export class UtilityExecutionOracle extends TypedOracle {
23
- constructor(
24
- protected readonly contractAddress: AztecAddress,
25
- /** List of transient auth witnesses to be used during this simulation */
26
- protected readonly authWitnesses: AuthWitness[],
27
- protected readonly capsules: Capsule[], // TODO(#12425): Rename to transientCapsules
28
- protected readonly executionDataProvider: ExecutionDataProvider,
29
- protected log = createLogger('simulator:client_view_context'),
30
- protected readonly scopes?: AztecAddress[],
31
- ) {
32
- super();
33
- }
34
-
35
- public override utilityAssertCompatibleOracleVersion(version: number): void {
36
- this.executionDataProvider.assertCompatibleOracleVersion(version);
69
+ export class UtilityExecutionOracle implements IMiscOracle, IUtilityExecutionOracle {
70
+ isMisc = true as const;
71
+ isUtility = true as const;
72
+
73
+ private contractLogger: Logger | undefined;
74
+
75
+ protected readonly contractAddress: AztecAddress;
76
+ protected readonly authWitnesses: AuthWitness[];
77
+ protected readonly capsules: Capsule[];
78
+ protected readonly anchorBlockHeader: BlockHeader;
79
+ protected readonly contractStore: ContractStore;
80
+ protected readonly noteStore: NoteStore;
81
+ protected readonly keyStore: KeyStore;
82
+ protected readonly addressStore: AddressStore;
83
+ protected readonly aztecNode: AztecNode;
84
+ protected readonly recipientTaggingStore: RecipientTaggingStore;
85
+ protected readonly senderAddressBookStore: SenderAddressBookStore;
86
+ protected readonly capsuleStore: CapsuleStore;
87
+ protected readonly privateEventStore: PrivateEventStore;
88
+ protected readonly jobId: string;
89
+ protected log: ReturnType<typeof createLogger>;
90
+ protected readonly scopes: AccessScopes;
91
+
92
+ constructor(args: UtilityExecutionOracleArgs) {
93
+ this.contractAddress = args.contractAddress;
94
+ this.authWitnesses = args.authWitnesses;
95
+ this.capsules = args.capsules;
96
+ this.anchorBlockHeader = args.anchorBlockHeader;
97
+ this.contractStore = args.contractStore;
98
+ this.noteStore = args.noteStore;
99
+ this.keyStore = args.keyStore;
100
+ this.addressStore = args.addressStore;
101
+ this.aztecNode = args.aztecNode;
102
+ this.recipientTaggingStore = args.recipientTaggingStore;
103
+ this.senderAddressBookStore = args.senderAddressBookStore;
104
+ this.capsuleStore = args.capsuleStore;
105
+ this.privateEventStore = args.privateEventStore;
106
+ this.jobId = args.jobId;
107
+ this.log = args.log ?? createLogger('simulator:client_view_context');
108
+ this.scopes = args.scopes;
109
+ }
110
+
111
+ public utilityAssertCompatibleOracleVersion(version: number): void {
112
+ if (version !== ORACLE_VERSION) {
113
+ throw new Error(`Incompatible oracle version. Expected version ${ORACLE_VERSION}, got ${version}.`);
114
+ }
37
115
  }
38
116
 
39
- public override utilityGetRandomField(): Fr {
117
+ public utilityGetRandomField(): Fr {
40
118
  return Fr.random();
41
119
  }
42
120
 
43
- public override utilityGetBlockNumber(): Promise<number> {
44
- return this.executionDataProvider.getBlockNumber();
45
- }
46
-
47
- public override utilityGetTimestamp(): Promise<UInt64> {
48
- return this.executionDataProvider.getTimestamp();
49
- }
50
-
51
- public override utilityGetContractAddress(): Promise<AztecAddress> {
52
- return Promise.resolve(this.contractAddress);
53
- }
54
-
55
- public override utilityGetChainId(): Promise<Fr> {
56
- return Promise.resolve(this.executionDataProvider.getChainId().then(id => new Fr(id)));
57
- }
58
-
59
- public override utilityGetVersion(): Promise<Fr> {
60
- return Promise.resolve(this.executionDataProvider.getVersion().then(v => new Fr(v)));
121
+ public utilityGetUtilityContext(): UtilityContext {
122
+ return new UtilityContext(this.anchorBlockHeader, this.contractAddress);
61
123
  }
62
124
 
63
125
  /**
@@ -65,62 +127,93 @@ export class UtilityExecutionOracle extends TypedOracle {
65
127
  * @param pkMHash - The master public key hash.
66
128
  * @returns A Promise that resolves to nullifier keys.
67
129
  * @throws If the keys are not registered in the key store.
130
+ * @throws If scopes are defined and the account is not in the scopes.
68
131
  */
69
- public override utilityGetKeyValidationRequest(pkMHash: Fr): Promise<KeyValidationRequest> {
70
- return this.executionDataProvider.getKeyValidationRequest(pkMHash, this.contractAddress);
132
+ public async utilityGetKeyValidationRequest(pkMHash: Fr): Promise<KeyValidationRequest> {
133
+ // If scopes are defined, check that the key belongs to an account in the scopes.
134
+ if (this.scopes !== 'ALL_SCOPES' && this.scopes.length > 0) {
135
+ let hasAccess = false;
136
+ for (let i = 0; i < this.scopes.length && !hasAccess; i++) {
137
+ if (await this.keyStore.accountHasKey(this.scopes[i], pkMHash)) {
138
+ hasAccess = true;
139
+ }
140
+ }
141
+ if (!hasAccess) {
142
+ throw new Error(`Key validation request denied: no scoped account has a key with hash ${pkMHash.toString()}.`);
143
+ }
144
+ }
145
+ return this.keyStore.getKeyValidationRequest(pkMHash, this.contractAddress);
71
146
  }
72
147
 
73
148
  /**
74
- * Fetches the index and sibling path of a leaf at a given block from a given tree.
75
- * @param blockNumber - The block number at which to get the membership witness.
76
- * @param treeId - Id of the tree to get the sibling path from.
77
- * @param leafValue - The leaf value
78
- * @returns The index and sibling path concatenated [index, sibling_path]
149
+ * Fetches the index and sibling path of a leaf at a given block from the note hash tree.
150
+ * @param anchorBlockHash - The hash of a block that contains the note hash tree root in which to find the membership
151
+ * witness.
152
+ * @param noteHash - The note hash to find in the note hash tree.
153
+ * @returns The membership witness containing the leaf index and sibling path
79
154
  */
80
- public override utilityGetMembershipWitness(blockNumber: number, treeId: MerkleTreeId, leafValue: Fr): Promise<Fr[]> {
81
- return this.executionDataProvider.getMembershipWitness(blockNumber, treeId, leafValue);
155
+ public utilityGetNoteHashMembershipWitness(
156
+ anchorBlockHash: BlockHash,
157
+ noteHash: Fr,
158
+ ): Promise<MembershipWitness<typeof NOTE_HASH_TREE_HEIGHT> | undefined> {
159
+ return this.aztecNode.getNoteHashMembershipWitness(anchorBlockHash, noteHash);
160
+ }
161
+
162
+ /**
163
+ * Fetches the index and sibling path of a block hash in the archive tree.
164
+ *
165
+ * Block hashes are the leaves of the archive tree. Each time a new block is added to the chain,
166
+ * its block hash is appended as a new leaf to the archive tree.
167
+ *
168
+ * @param anchorBlockHash - The hash of a block that contains the archive tree root in which to find the membership
169
+ * witness.
170
+ * @param blockHash - The block hash to find in the archive tree.
171
+ * @returns The membership witness containing the leaf index and sibling path
172
+ */
173
+ public utilityGetBlockHashMembershipWitness(
174
+ anchorBlockHash: BlockHash,
175
+ blockHash: BlockHash,
176
+ ): Promise<MembershipWitness<typeof ARCHIVE_HEIGHT> | undefined> {
177
+ return this.aztecNode.getBlockHashMembershipWitness(anchorBlockHash, blockHash);
82
178
  }
83
179
 
84
180
  /**
85
181
  * Returns a nullifier membership witness for a given nullifier at a given block.
86
- * @param blockNumber - The block number at which to get the index.
182
+ * @param blockHash - The block hash at which to get the index.
87
183
  * @param nullifier - Nullifier we try to find witness for.
88
184
  * @returns The nullifier membership witness (if found).
89
185
  */
90
- public override async utilityGetNullifierMembershipWitness(
91
- blockNumber: number,
186
+ public utilityGetNullifierMembershipWitness(
187
+ blockHash: BlockHash,
92
188
  nullifier: Fr,
93
189
  ): Promise<NullifierMembershipWitness | undefined> {
94
- return await this.executionDataProvider.getNullifierMembershipWitness(blockNumber, nullifier);
190
+ return this.aztecNode.getNullifierMembershipWitness(blockHash, nullifier);
95
191
  }
96
192
 
97
193
  /**
98
194
  * Returns a low nullifier membership witness for a given nullifier at a given block.
99
- * @param blockNumber - The block number at which to get the index.
195
+ * @param blockHash - The block hash at which to get the index.
100
196
  * @param nullifier - Nullifier we try to find the low nullifier witness for.
101
197
  * @returns The low nullifier membership witness (if found).
102
198
  * @remarks Low nullifier witness can be used to perform a nullifier non-inclusion proof by leveraging the "linked
103
199
  * list structure" of leaves and proving that a lower nullifier is pointing to a bigger next value than the nullifier
104
200
  * we are trying to prove non-inclusion for.
105
201
  */
106
- public override async utilityGetLowNullifierMembershipWitness(
107
- blockNumber: number,
202
+ public utilityGetLowNullifierMembershipWitness(
203
+ blockHash: BlockHash,
108
204
  nullifier: Fr,
109
205
  ): Promise<NullifierMembershipWitness | undefined> {
110
- return await this.executionDataProvider.getLowNullifierMembershipWitness(blockNumber, nullifier);
206
+ return this.aztecNode.getLowNullifierMembershipWitness(blockHash, nullifier);
111
207
  }
112
208
 
113
209
  /**
114
210
  * Returns a public data tree witness for a given leaf slot at a given block.
115
- * @param blockNumber - The block number at which to get the index.
211
+ * @param blockHash - The block hash at which to get the index.
116
212
  * @param leafSlot - The slot of the public data tree to get the witness for.
117
213
  * @returns - The witness
118
214
  */
119
- public override async utilityGetPublicDataWitness(
120
- blockNumber: number,
121
- leafSlot: Fr,
122
- ): Promise<PublicDataWitness | undefined> {
123
- return await this.executionDataProvider.getPublicDataWitness(blockNumber, leafSlot);
215
+ public utilityGetPublicDataWitness(blockHash: BlockHash, leafSlot: Fr): Promise<PublicDataWitness | undefined> {
216
+ return this.aztecNode.getPublicDataWitness(blockHash, leafSlot);
124
217
  }
125
218
 
126
219
  /**
@@ -128,22 +221,34 @@ export class UtilityExecutionOracle extends TypedOracle {
128
221
  * @param blockNumber - The number of a block of which to get the block header.
129
222
  * @returns Block extracted from a block with block number `blockNumber`.
130
223
  */
131
- public override async utilityGetBlockHeader(blockNumber: number): Promise<BlockHeader | undefined> {
132
- const block = await this.executionDataProvider.getBlock(blockNumber);
133
- if (!block) {
134
- return undefined;
224
+ public async utilityGetBlockHeader(blockNumber: BlockNumber): Promise<BlockHeader | undefined> {
225
+ const anchorBlockNumber = this.anchorBlockHeader.getBlockNumber();
226
+ if (blockNumber > anchorBlockNumber) {
227
+ throw new Error(`Block number ${blockNumber} is higher than current block ${anchorBlockNumber}`);
135
228
  }
136
- return block.header;
229
+
230
+ const block = await this.aztecNode.getBlock(blockNumber);
231
+ return block?.header;
137
232
  }
138
233
 
139
234
  /**
140
235
  * Retrieve the complete address associated to a given address.
141
236
  * @param account - The account address.
142
- * @returns A complete address associated with the input address.
143
- * @throws An error if the account is not registered in the database.
237
+ * @returns A complete address associated with the input address, or `undefined` if not registered.
144
238
  */
145
- public override utilityGetCompleteAddress(account: AztecAddress): Promise<CompleteAddress> {
146
- return this.executionDataProvider.getCompleteAddress(account);
239
+ public utilityTryGetPublicKeysAndPartialAddress(account: AztecAddress): Promise<CompleteAddress | undefined> {
240
+ return this.addressStore.getCompleteAddress(account);
241
+ }
242
+
243
+ protected async getCompleteAddressOrFail(account: AztecAddress): Promise<CompleteAddress> {
244
+ const completeAddress = await this.addressStore.getCompleteAddress(account);
245
+ if (!completeAddress) {
246
+ throw new Error(
247
+ `No public key registered for address ${account}.
248
+ Register it by calling pxe.addAccount(...).\nSee docs for context: https://docs.aztec.network/developers/resources/debugging/aztecnr-errors#simulation-error-no-public-key-registered-for-address-0x0-register-it-by-calling-pxeregisterrecipient-or-pxeregisteraccount`,
249
+ );
250
+ }
251
+ return completeAddress;
147
252
  }
148
253
 
149
254
  /**
@@ -151,8 +256,16 @@ export class UtilityExecutionOracle extends TypedOracle {
151
256
  * @param address - Address.
152
257
  * @returns A contract instance.
153
258
  */
154
- public override utilityGetContractInstance(address: AztecAddress): Promise<ContractInstance> {
155
- return this.executionDataProvider.getContractInstance(address);
259
+ public utilityGetContractInstance(address: AztecAddress): Promise<ContractInstance> {
260
+ return this.getContractInstance(address);
261
+ }
262
+
263
+ protected async getContractInstance(address: AztecAddress): Promise<ContractInstance> {
264
+ const instance = await this.contractStore.getContractInstance(address);
265
+ if (!instance) {
266
+ throw new Error(`No contract instance found for address ${address.toString()}`);
267
+ }
268
+ return instance;
156
269
  }
157
270
 
158
271
  /**
@@ -161,7 +274,7 @@ export class UtilityExecutionOracle extends TypedOracle {
161
274
  * @param messageHash - Hash of the message to authenticate.
162
275
  * @returns Authentication witness for the requested message hash.
163
276
  */
164
- public override utilityGetAuthWitness(messageHash: Fr): Promise<Fr[] | undefined> {
277
+ public utilityGetAuthWitness(messageHash: Fr): Promise<Fr[] | undefined> {
165
278
  return Promise.resolve(this.authWitnesses.find(w => w.requestHash.equals(messageHash))?.witness);
166
279
  }
167
280
 
@@ -174,6 +287,7 @@ export class UtilityExecutionOracle extends TypedOracle {
174
287
  * Real notes coming from DB will have a leafIndex which
175
288
  * represents their index in the note hash tree.
176
289
  *
290
+ * @param owner - The owner of the notes. If undefined, returns notes for all owners.
177
291
  * @param storageSlot - The storage slot.
178
292
  * @param numSelects - The number of valid selects in selectBy and selectValues.
179
293
  * @param selectBy - An array of indices of the fields to selects.
@@ -186,7 +300,8 @@ export class UtilityExecutionOracle extends TypedOracle {
186
300
  * @param status - The status of notes to fetch.
187
301
  * @returns Array of note data.
188
302
  */
189
- public override async utilityGetNotes(
303
+ public async utilityGetNotes(
304
+ owner: AztecAddress | undefined,
190
305
  storageSlot: Fr,
191
306
  numSelects: number,
192
307
  selectByIndexes: number[],
@@ -202,7 +317,9 @@ export class UtilityExecutionOracle extends TypedOracle {
202
317
  offset: number,
203
318
  status: NoteStatus,
204
319
  ): Promise<NoteData[]> {
205
- const dbNotes = await this.executionDataProvider.getNotes(this.contractAddress, storageSlot, status, this.scopes);
320
+ const noteService = new NoteService(this.noteStore, this.aztecNode, this.anchorBlockHeader, this.jobId);
321
+
322
+ const dbNotes = await noteService.getNotes(this.contractAddress, owner, storageSlot, status, this.scopes);
206
323
  return pickNotes<NoteData>(dbNotes, {
207
324
  selects: selectByIndexes.slice(0, numSelects).map((index, i) => ({
208
325
  selector: { index, offset: selectByOffsets[i], length: selectByLengths[i] },
@@ -223,93 +340,171 @@ export class UtilityExecutionOracle extends TypedOracle {
223
340
  * @param innerNullifier - The inner nullifier.
224
341
  * @returns A boolean indicating whether the nullifier exists in the tree or not.
225
342
  */
226
- public override async utilityCheckNullifierExists(innerNullifier: Fr) {
227
- const nullifier = await siloNullifier(this.contractAddress, innerNullifier!);
228
- const index = await this.executionDataProvider.getNullifierIndex(nullifier);
229
- return index !== undefined;
343
+ public async utilityCheckNullifierExists(innerNullifier: Fr) {
344
+ const [nullifier, anchorBlockHash] = await Promise.all([
345
+ siloNullifier(this.contractAddress, innerNullifier!),
346
+ this.anchorBlockHeader.hash(),
347
+ ]);
348
+ const [leafIndex] = await this.aztecNode.findLeavesIndexes(anchorBlockHash, MerkleTreeId.NULLIFIER_TREE, [
349
+ nullifier,
350
+ ]);
351
+ return leafIndex?.data !== undefined;
230
352
  }
231
353
 
232
354
  /**
233
- * Fetches a message from the executionDataProvider, given its key.
355
+ * Fetches a message from the executionStore, given its key.
234
356
  * @param contractAddress - Address of a contract by which the message was emitted.
235
357
  * @param messageHash - Hash of the message.
236
358
  * @param secret - Secret used to compute a nullifier.
237
359
  * @dev Contract address and secret are only used to compute the nullifier to get non-nullified messages
238
360
  * @returns The l1 to l2 membership witness (index of message in the tree and sibling path).
239
361
  */
240
- public override async utilityGetL1ToL2MembershipWitness(contractAddress: AztecAddress, messageHash: Fr, secret: Fr) {
241
- return await this.executionDataProvider.getL1ToL2MembershipWitness(contractAddress, messageHash, secret);
362
+ public async utilityGetL1ToL2MembershipWitness(contractAddress: AztecAddress, messageHash: Fr, secret: Fr) {
363
+ const [messageIndex, siblingPath] = await getNonNullifiedL1ToL2MessageWitness(
364
+ this.aztecNode,
365
+ contractAddress,
366
+ messageHash,
367
+ secret,
368
+ );
369
+
370
+ return new MessageLoadOracleInputs(messageIndex, siblingPath);
242
371
  }
243
372
 
244
373
  /**
245
374
  * Read the public storage data.
375
+ * @param blockHash - The block hash to read storage at.
246
376
  * @param contractAddress - The address to read storage from.
247
377
  * @param startStorageSlot - The starting storage slot.
248
- * @param blockNumber - The block number to read storage at.
249
378
  * @param numberOfElements - Number of elements to read from the starting storage slot.
250
379
  */
251
- public override async utilityStorageRead(
380
+ public async utilityStorageRead(
381
+ blockHash: BlockHash,
252
382
  contractAddress: AztecAddress,
253
383
  startStorageSlot: Fr,
254
- blockNumber: number,
255
384
  numberOfElements: number,
256
385
  ) {
257
- const values = [];
258
- for (let i = 0n; i < numberOfElements; i++) {
259
- const storageSlot = new Fr(startStorageSlot.value + i);
260
- const value = await this.executionDataProvider.getPublicStorageAt(blockNumber, contractAddress, storageSlot);
386
+ const slots = Array(numberOfElements)
387
+ .fill(0)
388
+ .map((_, i) => new Fr(startStorageSlot.value + BigInt(i)));
261
389
 
262
- this.log.debug(
263
- `Oracle storage read: slot=${storageSlot.toString()} address-${contractAddress.toString()} value=${value}`,
264
- );
265
- values.push(value);
266
- }
267
- return values;
268
- }
390
+ const values = await Promise.all(
391
+ slots.map(storageSlot => this.aztecNode.getPublicStorageAt(blockHash, contractAddress, storageSlot)),
392
+ );
269
393
 
270
- public override utilityDebugLog(message: string, fields: Fr[]): void {
271
- this.log.verbose(`${applyStringFormatting(message, fields)}`, { module: `${this.log.module}:debug_log` });
394
+ this.log.debug(
395
+ `Oracle storage read: slots=[${slots.map(slot => slot.toString()).join(', ')}] address=${contractAddress.toString()} values=[${values.join(', ')}]`,
396
+ );
397
+
398
+ return values;
272
399
  }
273
400
 
274
401
  /**
275
- * Returns the tagging secret for a given sender and recipient pair, siloed to the current contract address.
276
- * Includes the next index to be used used for tagging with this secret.
277
- * For this to work, the ivsk_m of the sender must be known.
278
- * @param sender - The address sending the note
279
- * @param recipient - The address receiving the note
280
- * @returns A tagging secret that can be used to tag notes.
402
+ * Returns a per-contract logger whose output is prefixed with `contract_log::<name>(<addrAbbrev>)`.
281
403
  */
282
- public override async utilityGetIndexedTaggingSecretAsSender(
283
- sender: AztecAddress,
284
- recipient: AztecAddress,
285
- ): Promise<IndexedTaggingSecret> {
286
- return await this.executionDataProvider.getIndexedTaggingSecretAsSender(this.contractAddress, sender, recipient);
404
+ async #getContractLogger(): Promise<Logger> {
405
+ if (!this.contractLogger) {
406
+ // Purpose of instanceId is to distinguish logs from different instances of the same component. It makes sense
407
+ // to re-use jobId as instanceId here as executions of different PXE jobs are isolated.
408
+ this.contractLogger = await createContractLogger(
409
+ this.contractAddress,
410
+ addr => this.contractStore.getDebugContractName(addr),
411
+ { instanceId: this.jobId },
412
+ );
413
+ }
414
+ return this.contractLogger;
287
415
  }
288
416
 
289
- public override async utilityFetchTaggedLogs(pendingTaggedLogArrayBaseSlot: Fr) {
290
- await this.executionDataProvider.syncTaggedLogs(this.contractAddress, pendingTaggedLogArrayBaseSlot, this.scopes);
417
+ public async utilityLog(level: number, message: string, fields: Fr[]): Promise<void> {
418
+ if (!LogLevels[level]) {
419
+ throw new Error(`Invalid log level: ${level}`);
420
+ }
421
+ const logger = await this.#getContractLogger();
422
+ logContractMessage(logger, LogLevels[level], message, fields);
423
+ }
424
+
425
+ public async utilityFetchTaggedLogs(pendingTaggedLogArrayBaseSlot: Fr) {
426
+ const logService = new LogService(
427
+ this.aztecNode,
428
+ this.anchorBlockHeader,
429
+ this.keyStore,
430
+ this.capsuleStore,
431
+ this.recipientTaggingStore,
432
+ this.senderAddressBookStore,
433
+ this.addressStore,
434
+ this.jobId,
435
+ this.log.getBindings(),
436
+ );
291
437
 
292
- await this.executionDataProvider.removeNullifiedNotes(this.contractAddress);
438
+ await logService.fetchTaggedLogs(this.contractAddress, pendingTaggedLogArrayBaseSlot, this.scopes);
293
439
  }
294
440
 
295
- public override async utilityValidateEnqueuedNotesAndEvents(
441
+ /**
442
+ * Validates all note and event validation requests enqueued via `enqueue_note_for_validation` and
443
+ * `enqueue_event_for_validation`, inserting them into the note database and event store respectively, making them
444
+ * queryable via `get_notes` and `getPrivateEvents`.
445
+ *
446
+ * This automatically clears both validation request queues, so no further work needs to be done by the caller.
447
+ * @param contractAddress - The address of the contract that the logs are tagged for.
448
+ * @param noteValidationRequestsArrayBaseSlot - The base slot of capsule array containing note validation requests.
449
+ * @param eventValidationRequestsArrayBaseSlot - The base slot of capsule array containing event validation requests.
450
+ */
451
+ public async utilityValidateAndStoreEnqueuedNotesAndEvents(
296
452
  contractAddress: AztecAddress,
297
453
  noteValidationRequestsArrayBaseSlot: Fr,
298
454
  eventValidationRequestsArrayBaseSlot: Fr,
299
455
  ) {
300
- // TODO(#10727): allow other contracts to deliver notes
456
+ // TODO(#10727): allow other contracts to store notes
301
457
  if (!this.contractAddress.equals(contractAddress)) {
302
458
  throw new Error(`Got a note validation request from ${contractAddress}, expected ${this.contractAddress}`);
303
459
  }
304
460
 
305
- await this.executionDataProvider.validateEnqueuedNotesAndEvents(
306
- contractAddress,
307
- noteValidationRequestsArrayBaseSlot,
308
- eventValidationRequestsArrayBaseSlot,
461
+ // We read all note and event validation requests and process them all concurrently. This makes the process much
462
+ // faster as we don't need to wait for the network round-trip.
463
+ const noteValidationRequests = (
464
+ await this.capsuleStore.readCapsuleArray(contractAddress, noteValidationRequestsArrayBaseSlot, this.jobId)
465
+ ).map(NoteValidationRequest.fromFields);
466
+
467
+ const eventValidationRequests = (
468
+ await this.capsuleStore.readCapsuleArray(contractAddress, eventValidationRequestsArrayBaseSlot, this.jobId)
469
+ ).map(EventValidationRequest.fromFields);
470
+
471
+ const noteService = new NoteService(this.noteStore, this.aztecNode, this.anchorBlockHeader, this.jobId);
472
+ const noteStorePromises = noteValidationRequests.map(request =>
473
+ noteService.validateAndStoreNote(
474
+ request.contractAddress,
475
+ request.owner,
476
+ request.storageSlot,
477
+ request.randomness,
478
+ request.noteNonce,
479
+ request.content,
480
+ request.noteHash,
481
+ request.nullifier,
482
+ request.txHash,
483
+ request.recipient,
484
+ ),
309
485
  );
486
+
487
+ const eventService = new EventService(this.anchorBlockHeader, this.aztecNode, this.privateEventStore, this.jobId);
488
+ const eventStorePromises = eventValidationRequests.map(request =>
489
+ eventService.validateAndStoreEvent(
490
+ request.contractAddress,
491
+ request.eventTypeId,
492
+ request.randomness,
493
+ request.serializedEvent,
494
+ request.eventCommitment,
495
+ request.txHash,
496
+ request.recipient,
497
+ ),
498
+ );
499
+
500
+ await Promise.all([...noteStorePromises, ...eventStorePromises]);
501
+
502
+ // Requests are cleared once we're done.
503
+ await this.capsuleStore.setCapsuleArray(contractAddress, noteValidationRequestsArrayBaseSlot, [], this.jobId);
504
+ await this.capsuleStore.setCapsuleArray(contractAddress, eventValidationRequestsArrayBaseSlot, [], this.jobId);
310
505
  }
311
506
 
312
- public override async utilityBulkRetrieveLogs(
507
+ public async utilityBulkRetrieveLogs(
313
508
  contractAddress: AztecAddress,
314
509
  logRetrievalRequestsArrayBaseSlot: Fr,
315
510
  logRetrievalResponsesArrayBaseSlot: Fr,
@@ -319,22 +514,48 @@ export class UtilityExecutionOracle extends TypedOracle {
319
514
  throw new Error(`Got a note validation request from ${contractAddress}, expected ${this.contractAddress}`);
320
515
  }
321
516
 
322
- await this.executionDataProvider.bulkRetrieveLogs(
517
+ // We read all log retrieval requests and process them all concurrently. This makes the process much faster as we
518
+ // don't need to wait for the network round-trip.
519
+ const logRetrievalRequests = (
520
+ await this.capsuleStore.readCapsuleArray(contractAddress, logRetrievalRequestsArrayBaseSlot, this.jobId)
521
+ ).map(LogRetrievalRequest.fromFields);
522
+
523
+ const logService = new LogService(
524
+ this.aztecNode,
525
+ this.anchorBlockHeader,
526
+ this.keyStore,
527
+ this.capsuleStore,
528
+ this.recipientTaggingStore,
529
+ this.senderAddressBookStore,
530
+ this.addressStore,
531
+ this.jobId,
532
+ this.log.getBindings(),
533
+ );
534
+
535
+ const maybeLogRetrievalResponses = await logService.bulkRetrieveLogs(logRetrievalRequests);
536
+
537
+ // Requests are cleared once we're done.
538
+ await this.capsuleStore.setCapsuleArray(contractAddress, logRetrievalRequestsArrayBaseSlot, [], this.jobId);
539
+
540
+ // The responses are stored as Option<LogRetrievalResponse> in a second CapsuleArray.
541
+ await this.capsuleStore.setCapsuleArray(
323
542
  contractAddress,
324
- logRetrievalRequestsArrayBaseSlot,
325
543
  logRetrievalResponsesArrayBaseSlot,
544
+ maybeLogRetrievalResponses.map(LogRetrievalResponse.toSerializedOption),
545
+ this.jobId,
326
546
  );
327
547
  }
328
548
 
329
- public override utilityStoreCapsule(contractAddress: AztecAddress, slot: Fr, capsule: Fr[]): Promise<void> {
549
+ public utilityStoreCapsule(contractAddress: AztecAddress, slot: Fr, capsule: Fr[]): Promise<void> {
330
550
  if (!contractAddress.equals(this.contractAddress)) {
331
551
  // TODO(#10727): instead of this check that this.contractAddress is allowed to access the external DB
332
552
  throw new Error(`Contract ${contractAddress} is not allowed to access ${this.contractAddress}'s PXE DB`);
333
553
  }
334
- return this.executionDataProvider.storeCapsule(this.contractAddress, slot, capsule);
554
+ this.capsuleStore.storeCapsule(this.contractAddress, slot, capsule, this.jobId);
555
+ return Promise.resolve();
335
556
  }
336
557
 
337
- public override async utilityLoadCapsule(contractAddress: AztecAddress, slot: Fr): Promise<Fr[] | null> {
558
+ public async utilityLoadCapsule(contractAddress: AztecAddress, slot: Fr): Promise<Fr[] | null> {
338
559
  if (!contractAddress.equals(this.contractAddress)) {
339
560
  // TODO(#10727): instead of this check that this.contractAddress is allowed to access the external DB
340
561
  throw new Error(`Contract ${contractAddress} is not allowed to access ${this.contractAddress}'s PXE DB`);
@@ -342,19 +563,20 @@ export class UtilityExecutionOracle extends TypedOracle {
342
563
  return (
343
564
  // TODO(#12425): On the following line, the pertinent capsule gets overshadowed by the transient one. Tackle this.
344
565
  this.capsules.find(c => c.contractAddress.equals(contractAddress) && c.storageSlot.equals(slot))?.data ??
345
- (await this.executionDataProvider.loadCapsule(this.contractAddress, slot))
566
+ (await this.capsuleStore.loadCapsule(this.contractAddress, slot, this.jobId))
346
567
  );
347
568
  }
348
569
 
349
- public override utilityDeleteCapsule(contractAddress: AztecAddress, slot: Fr): Promise<void> {
570
+ public utilityDeleteCapsule(contractAddress: AztecAddress, slot: Fr): Promise<void> {
350
571
  if (!contractAddress.equals(this.contractAddress)) {
351
572
  // TODO(#10727): instead of this check that this.contractAddress is allowed to access the external DB
352
573
  throw new Error(`Contract ${contractAddress} is not allowed to access ${this.contractAddress}'s PXE DB`);
353
574
  }
354
- return this.executionDataProvider.deleteCapsule(this.contractAddress, slot);
575
+ this.capsuleStore.deleteCapsule(this.contractAddress, slot, this.jobId);
576
+ return Promise.resolve();
355
577
  }
356
578
 
357
- public override utilityCopyCapsule(
579
+ public utilityCopyCapsule(
358
580
  contractAddress: AztecAddress,
359
581
  srcSlot: Fr,
360
582
  dstSlot: Fr,
@@ -364,20 +586,32 @@ export class UtilityExecutionOracle extends TypedOracle {
364
586
  // TODO(#10727): instead of this check that this.contractAddress is allowed to access the external DB
365
587
  throw new Error(`Contract ${contractAddress} is not allowed to access ${this.contractAddress}'s PXE DB`);
366
588
  }
367
- return this.executionDataProvider.copyCapsule(this.contractAddress, srcSlot, dstSlot, numEntries);
589
+ return this.capsuleStore.copyCapsule(this.contractAddress, srcSlot, dstSlot, numEntries, this.jobId);
368
590
  }
369
591
 
370
592
  // TODO(#11849): consider replacing this oracle with a pure Noir implementation of aes decryption.
371
- public override utilityAes128Decrypt(ciphertext: Buffer, iv: Buffer, symKey: Buffer): Promise<Buffer> {
593
+ public utilityAes128Decrypt(ciphertext: Buffer, iv: Buffer, symKey: Buffer): Promise<Buffer> {
372
594
  const aes128 = new Aes128();
373
595
  return aes128.decryptBufferCBC(ciphertext, iv, symKey);
374
596
  }
375
597
 
376
- public override utilityGetSharedSecret(address: AztecAddress, ephPk: Point): Promise<Point> {
377
- return this.executionDataProvider.getSharedSecret(address, ephPk);
598
+ /**
599
+ * Retrieves the shared secret for a given address and ephemeral public key.
600
+ * @param address - The address to get the secret for.
601
+ * @param ephPk - The ephemeral public key to get the secret for.
602
+ * @returns The secret for the given address.
603
+ */
604
+ public utilityGetSharedSecret(address: AztecAddress, ephPk: Point): Promise<Point> {
605
+ return this.getSharedSecret(address, ephPk);
378
606
  }
379
607
 
380
- public override utilityEmitOffchainEffect(_data: Fr[]): Promise<void> {
381
- return Promise.reject(new Error('Cannot emit offchain effects from a utility function'));
608
+ protected async getSharedSecret(address: AztecAddress, ephPk: Point): Promise<Point> {
609
+ // TODO(#12656): return an app-siloed secret
610
+ const recipientCompleteAddress = await this.getCompleteAddressOrFail(address);
611
+ const ivskM = await this.keyStore.getMasterSecretKey(
612
+ recipientCompleteAddress.publicKeys.masterIncomingViewingPublicKey,
613
+ );
614
+ const addressSecret = await computeAddressSecret(await recipientCompleteAddress.getPreaddress(), ivskM);
615
+ return deriveEcdhSharedSecret(addressSecret, ephPk);
382
616
  }
383
617
  }