@aztec/pxe 0.0.1-commit.d3ec352c → 0.0.1-commit.e61ad554

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 (379) hide show
  1. package/dest/bin/check_oracle_version.js +105 -15
  2. package/dest/block_synchronizer/block_synchronizer.d.ts +43 -0
  3. package/dest/block_synchronizer/block_synchronizer.d.ts.map +1 -0
  4. package/dest/block_synchronizer/block_synchronizer.js +147 -0
  5. package/dest/block_synchronizer/index.d.ts +2 -0
  6. package/dest/block_synchronizer/index.d.ts.map +1 -0
  7. package/dest/block_synchronizer/index.js +1 -0
  8. package/dest/config/index.d.ts +6 -4
  9. package/dest/config/index.d.ts.map +1 -1
  10. package/dest/config/index.js +17 -0
  11. package/dest/config/package_info.js +1 -1
  12. package/dest/contract_function_simulator/benchmarked_node.d.ts +9 -0
  13. package/dest/contract_function_simulator/benchmarked_node.d.ts.map +1 -0
  14. package/dest/contract_function_simulator/benchmarked_node.js +77 -0
  15. package/dest/contract_function_simulator/contract_function_simulator.d.ts +42 -14
  16. package/dest/contract_function_simulator/contract_function_simulator.d.ts.map +1 -1
  17. package/dest/contract_function_simulator/contract_function_simulator.js +71 -30
  18. package/dest/contract_function_simulator/execution_note_cache.d.ts +21 -12
  19. package/dest/contract_function_simulator/execution_note_cache.d.ts.map +1 -1
  20. package/dest/contract_function_simulator/execution_note_cache.js +48 -31
  21. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts +1 -1
  22. package/dest/contract_function_simulator/execution_tagging_index_cache.js +1 -1
  23. package/dest/contract_function_simulator/hashed_values_cache.d.ts +2 -2
  24. package/dest/contract_function_simulator/hashed_values_cache.d.ts.map +1 -1
  25. package/dest/contract_function_simulator/index.d.ts +2 -2
  26. package/dest/contract_function_simulator/index.d.ts.map +1 -1
  27. package/dest/contract_function_simulator/index.js +1 -1
  28. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts +5 -4
  29. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts.map +1 -1
  30. package/dest/contract_function_simulator/noir-structs/event_validation_request.js +6 -3
  31. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.d.ts +5 -4
  32. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.d.ts.map +1 -1
  33. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.js +7 -6
  34. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts +2 -2
  35. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts.map +1 -1
  36. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.js +1 -1
  37. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts +3 -3
  38. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts.map +1 -1
  39. package/dest/contract_function_simulator/noir-structs/note_validation_request.js +1 -1
  40. package/dest/contract_function_simulator/noir-structs/utility_context.d.ts +4 -10
  41. package/dest/contract_function_simulator/noir-structs/utility_context.d.ts.map +1 -1
  42. package/dest/contract_function_simulator/noir-structs/utility_context.js +7 -18
  43. package/dest/contract_function_simulator/oracle/interfaces.d.ts +20 -16
  44. package/dest/contract_function_simulator/oracle/interfaces.d.ts.map +1 -1
  45. package/dest/contract_function_simulator/oracle/message_load_oracle_inputs.d.ts +4 -2
  46. package/dest/contract_function_simulator/oracle/message_load_oracle_inputs.d.ts.map +1 -1
  47. package/dest/contract_function_simulator/oracle/message_load_oracle_inputs.js +1 -1
  48. package/dest/contract_function_simulator/oracle/note_packing_utils.d.ts +11 -7
  49. package/dest/contract_function_simulator/oracle/note_packing_utils.d.ts.map +1 -1
  50. package/dest/contract_function_simulator/oracle/note_packing_utils.js +14 -10
  51. package/dest/contract_function_simulator/oracle/oracle.d.ts +10 -8
  52. package/dest/contract_function_simulator/oracle/oracle.d.ts.map +1 -1
  53. package/dest/contract_function_simulator/oracle/oracle.js +58 -36
  54. package/dest/contract_function_simulator/oracle/private_execution.d.ts +2 -28
  55. package/dest/contract_function_simulator/oracle/private_execution.d.ts.map +1 -1
  56. package/dest/contract_function_simulator/oracle/private_execution.js +2 -38
  57. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts +33 -25
  58. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts.map +1 -1
  59. package/dest/contract_function_simulator/oracle/private_execution_oracle.js +41 -45
  60. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts +75 -25
  61. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts.map +1 -1
  62. package/dest/contract_function_simulator/oracle/utility_execution_oracle.js +170 -64
  63. package/dest/contract_function_simulator/pick_notes.d.ts +2 -2
  64. package/dest/contract_function_simulator/pick_notes.d.ts.map +1 -1
  65. package/dest/contract_function_simulator/pick_notes.js +1 -1
  66. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts +4 -4
  67. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts.map +1 -1
  68. package/dest/contract_function_simulator/proxied_contract_data_source.js +23 -5
  69. package/dest/contract_sync/index.d.ts +23 -0
  70. package/dest/contract_sync/index.d.ts.map +1 -0
  71. package/dest/contract_sync/index.js +54 -0
  72. package/dest/debug/pxe_debug_utils.d.ts +31 -0
  73. package/dest/debug/pxe_debug_utils.d.ts.map +1 -0
  74. package/dest/debug/pxe_debug_utils.js +38 -0
  75. package/dest/entrypoints/client/bundle/index.d.ts +1 -2
  76. package/dest/entrypoints/client/bundle/index.d.ts.map +1 -1
  77. package/dest/entrypoints/client/bundle/index.js +0 -1
  78. package/dest/entrypoints/client/bundle/utils.d.ts +1 -1
  79. package/dest/entrypoints/client/bundle/utils.d.ts.map +1 -1
  80. package/dest/entrypoints/client/bundle/utils.js +12 -3
  81. package/dest/entrypoints/client/lazy/index.d.ts +1 -2
  82. package/dest/entrypoints/client/lazy/index.d.ts.map +1 -1
  83. package/dest/entrypoints/client/lazy/index.js +0 -1
  84. package/dest/entrypoints/client/lazy/utils.d.ts +1 -1
  85. package/dest/entrypoints/client/lazy/utils.d.ts.map +1 -1
  86. package/dest/entrypoints/client/lazy/utils.js +12 -3
  87. package/dest/entrypoints/pxe_creation_options.d.ts +5 -2
  88. package/dest/entrypoints/pxe_creation_options.d.ts.map +1 -1
  89. package/dest/entrypoints/server/index.d.ts +4 -2
  90. package/dest/entrypoints/server/index.d.ts.map +1 -1
  91. package/dest/entrypoints/server/index.js +3 -1
  92. package/dest/entrypoints/server/utils.d.ts +1 -1
  93. package/dest/entrypoints/server/utils.d.ts.map +1 -1
  94. package/dest/entrypoints/server/utils.js +12 -8
  95. package/dest/error_enriching.d.ts +4 -4
  96. package/dest/error_enriching.d.ts.map +1 -1
  97. package/dest/error_enriching.js +6 -6
  98. package/dest/events/event_service.d.ts +16 -0
  99. package/dest/events/event_service.d.ts.map +1 -0
  100. package/dest/events/event_service.js +45 -0
  101. package/dest/events/index.d.ts +2 -0
  102. package/dest/events/index.d.ts.map +1 -0
  103. package/dest/events/index.js +1 -0
  104. package/dest/events/private_event_filter_validator.d.ts +9 -0
  105. package/dest/events/private_event_filter_validator.d.ts.map +1 -0
  106. package/dest/events/private_event_filter_validator.js +38 -0
  107. package/dest/job_coordinator/job_coordinator.d.ts +74 -0
  108. package/dest/job_coordinator/job_coordinator.d.ts.map +1 -0
  109. package/dest/job_coordinator/job_coordinator.js +93 -0
  110. package/dest/logs/log_service.d.ts +27 -0
  111. package/dest/logs/log_service.d.ts.map +1 -0
  112. package/dest/logs/log_service.js +128 -0
  113. package/dest/notes/index.d.ts +2 -0
  114. package/dest/notes/index.d.ts.map +1 -0
  115. package/dest/notes/index.js +1 -0
  116. package/dest/notes/note_service.d.ts +49 -0
  117. package/dest/notes/note_service.d.ts.map +1 -0
  118. package/dest/notes/note_service.js +148 -0
  119. package/dest/oracle_version.d.ts +3 -3
  120. package/dest/oracle_version.d.ts.map +1 -1
  121. package/dest/oracle_version.js +4 -3
  122. package/dest/private_kernel/hints/index.d.ts +2 -2
  123. package/dest/private_kernel/hints/index.d.ts.map +1 -1
  124. package/dest/private_kernel/hints/index.js +1 -1
  125. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts +28 -0
  126. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts.map +1 -0
  127. package/dest/private_kernel/hints/{build_private_kernel_reset_private_inputs.js → private_kernel_reset_private_inputs_builder.js} +13 -7
  128. package/dest/private_kernel/private_kernel_execution_prover.d.ts +1 -1
  129. package/dest/private_kernel/private_kernel_execution_prover.d.ts.map +1 -1
  130. package/dest/private_kernel/private_kernel_execution_prover.js +8 -9
  131. package/dest/private_kernel/private_kernel_oracle.d.ts +26 -29
  132. package/dest/private_kernel/private_kernel_oracle.d.ts.map +1 -1
  133. package/dest/private_kernel/private_kernel_oracle.js +90 -2
  134. package/dest/pxe.d.ts +45 -81
  135. package/dest/pxe.d.ts.map +1 -1
  136. package/dest/pxe.js +185 -216
  137. package/dest/storage/address_store/address_store.d.ts +11 -0
  138. package/dest/storage/address_store/address_store.d.ts.map +1 -0
  139. package/dest/storage/{address_data_provider/address_data_provider.js → address_store/address_store.js} +1 -1
  140. package/dest/storage/address_store/index.d.ts +2 -0
  141. package/dest/storage/address_store/index.d.ts.map +1 -0
  142. package/dest/storage/address_store/index.js +1 -0
  143. package/dest/storage/{sync_data_provider/sync_data_provider.d.ts → anchor_block_store/anchor_block_store.d.ts} +2 -4
  144. package/dest/storage/anchor_block_store/anchor_block_store.d.ts.map +1 -0
  145. package/dest/storage/{sync_data_provider/sync_data_provider.js → anchor_block_store/anchor_block_store.js} +2 -9
  146. package/dest/storage/{sync_data_provider → anchor_block_store}/index.d.ts +2 -2
  147. package/dest/storage/anchor_block_store/index.d.ts.map +1 -0
  148. package/dest/storage/anchor_block_store/index.js +1 -0
  149. package/dest/storage/capsule_store/capsule_store.d.ts +72 -0
  150. package/dest/storage/capsule_store/capsule_store.d.ts.map +1 -0
  151. package/dest/storage/capsule_store/capsule_store.js +255 -0
  152. package/dest/storage/capsule_store/index.d.ts +2 -0
  153. package/dest/storage/capsule_store/index.d.ts.map +1 -0
  154. package/dest/storage/capsule_store/index.js +1 -0
  155. package/dest/storage/{contract_data_provider/contract_data_provider.d.ts → contract_store/contract_store.d.ts} +7 -5
  156. package/dest/storage/contract_store/contract_store.d.ts.map +1 -0
  157. package/dest/storage/{contract_data_provider/contract_data_provider.js → contract_store/contract_store.js} +34 -3
  158. package/dest/storage/contract_store/index.d.ts +2 -0
  159. package/dest/storage/contract_store/index.d.ts.map +1 -0
  160. package/dest/storage/contract_store/index.js +1 -0
  161. package/dest/storage/{contract_data_provider → contract_store}/private_functions_tree.d.ts +1 -1
  162. package/dest/storage/contract_store/private_functions_tree.d.ts.map +1 -0
  163. package/dest/storage/{contract_data_provider → contract_store}/private_functions_tree.js +1 -1
  164. package/dest/storage/index.d.ts +8 -8
  165. package/dest/storage/index.d.ts.map +1 -1
  166. package/dest/storage/index.js +7 -7
  167. package/dest/storage/note_store/index.d.ts +3 -0
  168. package/dest/storage/note_store/index.d.ts.map +1 -0
  169. package/dest/storage/note_store/index.js +2 -0
  170. package/dest/storage/note_store/note_store.d.ts +73 -0
  171. package/dest/storage/note_store/note_store.d.ts.map +1 -0
  172. package/dest/storage/note_store/note_store.js +303 -0
  173. package/dest/storage/note_store/stored_note.d.ts +16 -0
  174. package/dest/storage/note_store/stored_note.d.ts.map +1 -0
  175. package/dest/storage/note_store/stored_note.js +43 -0
  176. package/dest/storage/private_event_store/private_event_store.d.ts +91 -0
  177. package/dest/storage/private_event_store/private_event_store.d.ts.map +1 -0
  178. package/dest/storage/private_event_store/private_event_store.js +250 -0
  179. package/dest/storage/private_event_store/stored_private_event.d.ts +23 -0
  180. package/dest/storage/private_event_store/stored_private_event.d.ts.map +1 -0
  181. package/dest/storage/private_event_store/stored_private_event.js +56 -0
  182. package/dest/storage/tagging_store/index.d.ts +4 -0
  183. package/dest/storage/tagging_store/index.d.ts.map +1 -0
  184. package/dest/storage/tagging_store/index.js +3 -0
  185. package/dest/storage/tagging_store/recipient_tagging_store.d.ts +28 -0
  186. package/dest/storage/tagging_store/recipient_tagging_store.d.ts.map +1 -0
  187. package/dest/storage/tagging_store/recipient_tagging_store.js +99 -0
  188. package/dest/storage/tagging_store/sender_address_book_store.d.ts +14 -0
  189. package/dest/storage/tagging_store/sender_address_book_store.d.ts.map +1 -0
  190. package/dest/storage/tagging_store/sender_address_book_store.js +30 -0
  191. package/dest/storage/tagging_store/sender_tagging_store.d.ts +77 -0
  192. package/dest/storage/tagging_store/sender_tagging_store.d.ts.map +1 -0
  193. package/dest/storage/tagging_store/sender_tagging_store.js +278 -0
  194. package/dest/tagging/constants.d.ts +2 -2
  195. package/dest/tagging/constants.d.ts.map +1 -1
  196. package/dest/tagging/constants.js +10 -2
  197. package/dest/tagging/get_all_logs_by_tags.d.ts +24 -0
  198. package/dest/tagging/get_all_logs_by_tags.d.ts.map +1 -0
  199. package/dest/tagging/get_all_logs_by_tags.js +46 -0
  200. package/dest/tagging/index.d.ts +16 -6
  201. package/dest/tagging/index.d.ts.map +1 -1
  202. package/dest/tagging/index.js +15 -5
  203. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts +15 -0
  204. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts.map +1 -0
  205. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.js +99 -0
  206. package/dest/tagging/recipient_sync/utils/find_highest_indexes.d.ts +12 -0
  207. package/dest/tagging/recipient_sync/utils/find_highest_indexes.d.ts.map +1 -0
  208. package/dest/tagging/recipient_sync/utils/find_highest_indexes.js +20 -0
  209. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts +15 -0
  210. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts.map +1 -0
  211. package/dest/tagging/recipient_sync/utils/load_logs_for_range.js +32 -0
  212. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts +21 -0
  213. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts.map +1 -0
  214. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.js +74 -0
  215. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts +11 -0
  216. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts.map +1 -0
  217. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.js +29 -0
  218. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts +21 -0
  219. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts.map +1 -0
  220. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.js +60 -0
  221. package/package.json +18 -18
  222. package/src/bin/check_oracle_version.ts +131 -20
  223. package/src/block_synchronizer/block_synchronizer.ts +174 -0
  224. package/src/block_synchronizer/index.ts +1 -0
  225. package/src/config/index.ts +17 -3
  226. package/src/config/package_info.ts +1 -1
  227. package/src/contract_function_simulator/benchmarked_node.ts +103 -0
  228. package/src/contract_function_simulator/contract_function_simulator.ts +113 -33
  229. package/src/contract_function_simulator/execution_note_cache.ts +51 -29
  230. package/src/contract_function_simulator/execution_tagging_index_cache.ts +1 -1
  231. package/src/contract_function_simulator/hashed_values_cache.ts +1 -1
  232. package/src/contract_function_simulator/index.ts +1 -1
  233. package/src/contract_function_simulator/noir-structs/event_validation_request.ts +6 -2
  234. package/src/contract_function_simulator/noir-structs/log_retrieval_request.ts +6 -5
  235. package/src/contract_function_simulator/noir-structs/log_retrieval_response.ts +1 -1
  236. package/src/contract_function_simulator/noir-structs/note_validation_request.ts +2 -2
  237. package/src/contract_function_simulator/noir-structs/utility_context.ts +6 -25
  238. package/src/contract_function_simulator/oracle/interfaces.ts +25 -15
  239. package/src/contract_function_simulator/oracle/message_load_oracle_inputs.ts +1 -1
  240. package/src/contract_function_simulator/oracle/note_packing_utils.ts +27 -13
  241. package/src/contract_function_simulator/oracle/oracle.ts +74 -45
  242. package/src/contract_function_simulator/oracle/private_execution.ts +2 -69
  243. package/src/contract_function_simulator/oracle/private_execution_oracle.ts +124 -59
  244. package/src/contract_function_simulator/oracle/utility_execution_oracle.ts +259 -81
  245. package/src/contract_function_simulator/pick_notes.ts +1 -1
  246. package/src/contract_function_simulator/proxied_contract_data_source.ts +24 -7
  247. package/src/contract_sync/index.ts +98 -0
  248. package/src/debug/pxe_debug_utils.ts +49 -0
  249. package/src/entrypoints/client/bundle/index.ts +0 -1
  250. package/src/entrypoints/client/bundle/utils.ts +9 -3
  251. package/src/entrypoints/client/lazy/index.ts +0 -1
  252. package/src/entrypoints/client/lazy/utils.ts +9 -4
  253. package/src/entrypoints/pxe_creation_options.ts +4 -1
  254. package/src/entrypoints/server/index.ts +3 -1
  255. package/src/entrypoints/server/utils.ts +12 -16
  256. package/src/error_enriching.ts +7 -15
  257. package/src/events/event_service.ts +73 -0
  258. package/src/events/index.ts +1 -0
  259. package/src/events/private_event_filter_validator.ts +46 -0
  260. package/src/job_coordinator/job_coordinator.ts +149 -0
  261. package/src/logs/log_service.ts +220 -0
  262. package/src/notes/index.ts +1 -0
  263. package/src/notes/note_service.ts +197 -0
  264. package/src/oracle_version.ts +4 -3
  265. package/src/private_kernel/hints/index.ts +1 -1
  266. package/src/private_kernel/hints/{build_private_kernel_reset_private_inputs.ts → private_kernel_reset_private_inputs_builder.ts} +34 -23
  267. package/src/private_kernel/private_kernel_execution_prover.ts +7 -9
  268. package/src/private_kernel/private_kernel_oracle.ts +118 -37
  269. package/src/pxe.ts +257 -280
  270. package/src/storage/{address_data_provider/address_data_provider.ts → address_store/address_store.ts} +1 -1
  271. package/src/storage/address_store/index.ts +1 -0
  272. package/src/storage/{sync_data_provider/sync_data_provider.ts → anchor_block_store/anchor_block_store.ts} +2 -12
  273. package/src/storage/anchor_block_store/index.ts +1 -0
  274. package/src/storage/capsule_store/capsule_store.ts +315 -0
  275. package/src/storage/capsule_store/index.ts +1 -0
  276. package/src/storage/{contract_data_provider/contract_data_provider.ts → contract_store/contract_store.ts} +45 -3
  277. package/src/storage/contract_store/index.ts +1 -0
  278. package/src/storage/{contract_data_provider → contract_store}/private_functions_tree.ts +1 -1
  279. package/src/storage/index.ts +7 -7
  280. package/src/storage/note_store/index.ts +2 -0
  281. package/src/storage/note_store/note_store.ts +381 -0
  282. package/src/storage/note_store/stored_note.ts +48 -0
  283. package/src/storage/private_event_store/private_event_store.ts +363 -0
  284. package/src/storage/private_event_store/stored_private_event.ts +73 -0
  285. package/src/storage/tagging_store/index.ts +3 -0
  286. package/src/storage/tagging_store/recipient_tagging_store.ts +129 -0
  287. package/src/storage/tagging_store/sender_address_book_store.ts +42 -0
  288. package/src/storage/tagging_store/sender_tagging_store.ts +345 -0
  289. package/src/tagging/constants.ts +10 -2
  290. package/src/tagging/get_all_logs_by_tags.ts +68 -0
  291. package/src/tagging/index.ts +18 -5
  292. package/src/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.ts +143 -0
  293. package/src/tagging/recipient_sync/utils/find_highest_indexes.ts +34 -0
  294. package/src/tagging/recipient_sync/utils/load_logs_for_range.ts +49 -0
  295. package/src/tagging/sender_sync/sync_sender_tagging_indexes.ts +99 -0
  296. package/src/tagging/sender_sync/utils/get_status_change_of_pending.ts +36 -0
  297. package/src/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.ts +84 -0
  298. package/dest/contract_function_simulator/execution_data_provider.d.ts +0 -267
  299. package/dest/contract_function_simulator/execution_data_provider.d.ts.map +0 -1
  300. package/dest/contract_function_simulator/execution_data_provider.js +0 -14
  301. package/dest/contract_function_simulator/proxied_node.d.ts +0 -9
  302. package/dest/contract_function_simulator/proxied_node.d.ts.map +0 -1
  303. package/dest/contract_function_simulator/proxied_node.js +0 -27
  304. package/dest/contract_function_simulator/pxe_oracle_interface.d.ts +0 -123
  305. package/dest/contract_function_simulator/pxe_oracle_interface.d.ts.map +0 -1
  306. package/dest/contract_function_simulator/pxe_oracle_interface.js +0 -696
  307. package/dest/private_kernel/hints/build_private_kernel_reset_private_inputs.d.ts +0 -28
  308. package/dest/private_kernel/hints/build_private_kernel_reset_private_inputs.d.ts.map +0 -1
  309. package/dest/private_kernel/private_kernel_oracle_impl.d.ts +0 -45
  310. package/dest/private_kernel/private_kernel_oracle_impl.d.ts.map +0 -1
  311. package/dest/private_kernel/private_kernel_oracle_impl.js +0 -86
  312. package/dest/storage/address_data_provider/address_data_provider.d.ts +0 -11
  313. package/dest/storage/address_data_provider/address_data_provider.d.ts.map +0 -1
  314. package/dest/storage/address_data_provider/index.d.ts +0 -2
  315. package/dest/storage/address_data_provider/index.d.ts.map +0 -1
  316. package/dest/storage/address_data_provider/index.js +0 -1
  317. package/dest/storage/capsule_data_provider/capsule_data_provider.d.ts +0 -25
  318. package/dest/storage/capsule_data_provider/capsule_data_provider.d.ts.map +0 -1
  319. package/dest/storage/capsule_data_provider/capsule_data_provider.js +0 -118
  320. package/dest/storage/capsule_data_provider/index.d.ts +0 -2
  321. package/dest/storage/capsule_data_provider/index.d.ts.map +0 -1
  322. package/dest/storage/capsule_data_provider/index.js +0 -1
  323. package/dest/storage/contract_data_provider/contract_data_provider.d.ts.map +0 -1
  324. package/dest/storage/contract_data_provider/index.d.ts +0 -2
  325. package/dest/storage/contract_data_provider/index.d.ts.map +0 -1
  326. package/dest/storage/contract_data_provider/index.js +0 -1
  327. package/dest/storage/contract_data_provider/private_functions_tree.d.ts.map +0 -1
  328. package/dest/storage/note_data_provider/index.d.ts +0 -3
  329. package/dest/storage/note_data_provider/index.d.ts.map +0 -1
  330. package/dest/storage/note_data_provider/index.js +0 -2
  331. package/dest/storage/note_data_provider/note_data_provider.d.ts +0 -83
  332. package/dest/storage/note_data_provider/note_data_provider.d.ts.map +0 -1
  333. package/dest/storage/note_data_provider/note_data_provider.js +0 -314
  334. package/dest/storage/private_event_data_provider/private_event_data_provider.d.ts +0 -37
  335. package/dest/storage/private_event_data_provider/private_event_data_provider.d.ts.map +0 -1
  336. package/dest/storage/private_event_data_provider/private_event_data_provider.js +0 -105
  337. package/dest/storage/sync_data_provider/index.d.ts.map +0 -1
  338. package/dest/storage/sync_data_provider/index.js +0 -1
  339. package/dest/storage/sync_data_provider/sync_data_provider.d.ts.map +0 -1
  340. package/dest/storage/tagging_data_provider/index.d.ts +0 -2
  341. package/dest/storage/tagging_data_provider/index.d.ts.map +0 -1
  342. package/dest/storage/tagging_data_provider/index.js +0 -1
  343. package/dest/storage/tagging_data_provider/tagging_data_provider.d.ts +0 -40
  344. package/dest/storage/tagging_data_provider/tagging_data_provider.d.ts.map +0 -1
  345. package/dest/storage/tagging_data_provider/tagging_data_provider.js +0 -89
  346. package/dest/synchronizer/index.d.ts +0 -2
  347. package/dest/synchronizer/index.d.ts.map +0 -1
  348. package/dest/synchronizer/index.js +0 -1
  349. package/dest/synchronizer/synchronizer.d.ts +0 -36
  350. package/dest/synchronizer/synchronizer.d.ts.map +0 -1
  351. package/dest/synchronizer/synchronizer.js +0 -102
  352. package/dest/tagging/siloed_tag.d.ts +0 -14
  353. package/dest/tagging/siloed_tag.d.ts.map +0 -1
  354. package/dest/tagging/siloed_tag.js +0 -20
  355. package/dest/tagging/tag.d.ts +0 -12
  356. package/dest/tagging/tag.d.ts.map +0 -1
  357. package/dest/tagging/tag.js +0 -17
  358. package/dest/tagging/utils.d.ts +0 -18
  359. package/dest/tagging/utils.d.ts.map +0 -1
  360. package/dest/tagging/utils.js +0 -24
  361. package/src/contract_function_simulator/execution_data_provider.ts +0 -342
  362. package/src/contract_function_simulator/proxied_node.ts +0 -33
  363. package/src/contract_function_simulator/pxe_oracle_interface.ts +0 -1023
  364. package/src/private_kernel/private_kernel_oracle_impl.ts +0 -132
  365. package/src/storage/address_data_provider/index.ts +0 -1
  366. package/src/storage/capsule_data_provider/capsule_data_provider.ts +0 -147
  367. package/src/storage/capsule_data_provider/index.ts +0 -1
  368. package/src/storage/contract_data_provider/index.ts +0 -1
  369. package/src/storage/note_data_provider/index.ts +0 -2
  370. package/src/storage/note_data_provider/note_data_provider.ts +0 -403
  371. package/src/storage/private_event_data_provider/private_event_data_provider.ts +0 -143
  372. package/src/storage/sync_data_provider/index.ts +0 -1
  373. package/src/storage/tagging_data_provider/index.ts +0 -1
  374. package/src/storage/tagging_data_provider/tagging_data_provider.ts +0 -120
  375. package/src/synchronizer/index.ts +0 -1
  376. package/src/synchronizer/synchronizer.ts +0 -121
  377. package/src/tagging/siloed_tag.ts +0 -22
  378. package/src/tagging/tag.ts +0 -16
  379. package/src/tagging/utils.ts +0 -31
@@ -1,403 +0,0 @@
1
- import { toBufferBE } from '@aztec/foundation/bigint-buffer';
2
- import type { Fr } from '@aztec/foundation/fields';
3
- import { toArray } from '@aztec/foundation/iterable';
4
- import type { AztecAsyncKVStore, AztecAsyncMap, AztecAsyncMultiMap } from '@aztec/kv-store';
5
- import { AztecAddress } from '@aztec/stdlib/aztec-address';
6
- import type { DataInBlock } from '@aztec/stdlib/block';
7
- import { NoteStatus, type NotesFilter } from '@aztec/stdlib/note';
8
- import { NoteDao } from '@aztec/stdlib/note';
9
-
10
- /**
11
- * NoteDataProvider manages the storage and retrieval of notes.
12
- *
13
- * Notes can be active or nullified. This class processes new notes, nullifications,
14
- * and performs rollback handling in the case of a reorg.
15
- **/
16
- export class NoteDataProvider {
17
- #store: AztecAsyncKVStore;
18
- #notes: AztecAsyncMap<string, Buffer>;
19
- #nullifiedNotes: AztecAsyncMap<string, Buffer>;
20
- #nullifierToNoteId: AztecAsyncMap<string, string>;
21
- #nullifiersByBlockNumber: AztecAsyncMultiMap<number, string>;
22
-
23
- #nullifiedNotesToScope: AztecAsyncMultiMap<string, string>;
24
- #nullifiedNotesByContract: AztecAsyncMultiMap<string, string>;
25
- #nullifiedNotesByStorageSlot: AztecAsyncMultiMap<string, string>;
26
- #nullifiedNotesByNullifier: AztecAsyncMap<string, string>;
27
-
28
- #scopes: AztecAsyncMap<string, true>;
29
- #notesToScope: AztecAsyncMultiMap<string, string>;
30
- #notesByContractAndScope: Map<string, AztecAsyncMultiMap<string, string>>;
31
- #notesByStorageSlotAndScope: Map<string, AztecAsyncMultiMap<string, string>>;
32
-
33
- private constructor(store: AztecAsyncKVStore) {
34
- this.#store = store;
35
- this.#notes = store.openMap('notes');
36
- this.#nullifiedNotes = store.openMap('nullified_notes');
37
- this.#nullifierToNoteId = store.openMap('nullifier_to_note');
38
- this.#nullifiersByBlockNumber = store.openMultiMap('nullifier_to_block_number');
39
-
40
- this.#nullifiedNotesToScope = store.openMultiMap('nullified_notes_to_scope');
41
- this.#nullifiedNotesByContract = store.openMultiMap('nullified_notes_by_contract');
42
- this.#nullifiedNotesByStorageSlot = store.openMultiMap('nullified_notes_by_storage_slot');
43
- this.#nullifiedNotesByNullifier = store.openMap('nullified_notes_by_nullifier');
44
-
45
- this.#scopes = store.openMap('scopes');
46
- this.#notesToScope = store.openMultiMap('notes_to_scope');
47
- this.#notesByContractAndScope = new Map<string, AztecAsyncMultiMap<string, string>>();
48
- this.#notesByStorageSlotAndScope = new Map<string, AztecAsyncMultiMap<string, string>>();
49
- }
50
-
51
- /**
52
- * Creates and initializes a new NoteDataProvider instance.
53
- *
54
- * This factory method creates a NoteDataProvider and restores any existing
55
- * scope-specific indexes from the database.
56
- *
57
- * @param store - The key-value store to use for persistence
58
- * @returns Promise resolving to a fully initialized NoteDataProvider instance
59
- */
60
- public static async create(store: AztecAsyncKVStore): Promise<NoteDataProvider> {
61
- const pxeDB = new NoteDataProvider(store);
62
- for await (const scope of pxeDB.#scopes.keysAsync()) {
63
- pxeDB.#notesByContractAndScope.set(scope, store.openMultiMap(`${scope}:notes_by_contract`));
64
- pxeDB.#notesByStorageSlotAndScope.set(scope, store.openMultiMap(`${scope}:notes_by_storage_slot`));
65
- }
66
- return pxeDB;
67
- }
68
-
69
- /**
70
- * Adds a new scope to the note data provider.
71
- *
72
- * Scopes provide privacy isolation by creating separate indexes for each user.
73
- * Each scope gets its own set of indexes for efficient note retrieval by various criteria.
74
- *
75
- * @param scope - The AztecAddress representing the scope/user to add
76
- * @returns Promise resolving to true if scope was added, false if it already existed
77
- */
78
- public async addScope(scope: AztecAddress): Promise<boolean> {
79
- const scopeString = scope.toString();
80
-
81
- if (await this.#scopes.hasAsync(scopeString)) {
82
- return false;
83
- }
84
-
85
- await this.#scopes.set(scopeString, true);
86
- this.#notesByContractAndScope.set(scopeString, this.#store.openMultiMap(`${scopeString}:notes_by_contract`));
87
- this.#notesByStorageSlotAndScope.set(scopeString, this.#store.openMultiMap(`${scopeString}:notes_by_storage_slot`));
88
-
89
- return true;
90
- }
91
-
92
- /**
93
- * Adds multiple notes to the data provider under the specified scope.
94
- *
95
- * Notes are stored using their index from the notes hash tree as the key, which provides
96
- * uniqueness and maintains creation order. Each note is indexed by multiple criteria
97
- * for efficient retrieval.
98
- *
99
- * @param notes - Notes to store
100
- * @param scope - The scope (user/account) under which to store the notes
101
- */
102
- addNotes(notes: NoteDao[], scope: AztecAddress): Promise<void> {
103
- return this.#store.transactionAsync(async () => {
104
- if (!(await this.#scopes.hasAsync(scope.toString()))) {
105
- await this.addScope(scope);
106
- }
107
-
108
- for (const dao of notes) {
109
- const noteIndex = toBufferBE(dao.index, 32).toString('hex');
110
- await this.#notes.set(noteIndex, dao.toBuffer());
111
- await this.#notesToScope.set(noteIndex, scope.toString());
112
- await this.#nullifierToNoteId.set(dao.siloedNullifier.toString(), noteIndex);
113
-
114
- await this.#notesByContractAndScope.get(scope.toString())!.set(dao.contractAddress.toString(), noteIndex);
115
- await this.#notesByStorageSlotAndScope.get(scope.toString())!.set(dao.storageSlot.toString(), noteIndex);
116
- }
117
- });
118
- }
119
-
120
- /**
121
- * Synchronizes notes and nullifiers to a specific block number.
122
- *
123
- * This method ensures that the state of notes and nullifiers is consistent with the
124
- * specified block number. It restores any notes that were nullified after the given block
125
- * and deletes any active notes created after that block.
126
- *
127
- * @param blockNumber - The new chain tip after a reorg
128
- * @param synchedBlockNumber - The block number up to which PXE managed to sync before the reorg happened.
129
- */
130
- public async rollbackNotesAndNullifiers(blockNumber: number, synchedBlockNumber: number): Promise<void> {
131
- await this.#rewindNullifiersAfterBlock(blockNumber, synchedBlockNumber);
132
- await this.#deleteActiveNotesAfterBlock(blockNumber);
133
- }
134
-
135
- /**
136
- * Deletes (removes) all active notes created after the specified block number.
137
- *
138
- * Permanently delete notes from the active notes store, e.g. during a reorg.
139
- * Note: This only affects #notes (active notes), not #nullifiedNotes.
140
- *
141
- * @param blockNumber - Notes created after this block number will be deleted
142
- */
143
- #deleteActiveNotesAfterBlock(blockNumber: number): Promise<void> {
144
- return this.#store.transactionAsync(async () => {
145
- const notes = await toArray(this.#notes.valuesAsync());
146
- for (const note of notes) {
147
- const noteDao = NoteDao.fromBuffer(note);
148
- if (noteDao.l2BlockNumber > blockNumber) {
149
- const noteIndex = toBufferBE(noteDao.index, 32).toString('hex');
150
- await this.#notes.delete(noteIndex);
151
- await this.#notesToScope.delete(noteIndex);
152
- await this.#nullifierToNoteId.delete(noteDao.siloedNullifier.toString());
153
- const scopes = await toArray(this.#scopes.keysAsync());
154
- for (const scope of scopes) {
155
- await this.#notesByContractAndScope.get(scope)!.deleteValue(noteDao.contractAddress.toString(), noteIndex);
156
- await this.#notesByStorageSlotAndScope.get(scope)!.deleteValue(noteDao.storageSlot.toString(), noteIndex);
157
- }
158
- }
159
- }
160
- });
161
- }
162
-
163
- /**
164
- * Rewinds nullifications after a given block number.
165
- *
166
- * This operation "unnullifies" notes, rolling back nullifications that occurred
167
- * in orphaned blocks, e.g. during a reorg. The notes are restored to the
168
- * active notes store and removed from the nullified store.
169
- *
170
- * @param blockNumber - Revert nullifications that occurred after this block
171
- * @param synchedBlockNumber - Upper bound for the block range to process
172
- */
173
- async #rewindNullifiersAfterBlock(blockNumber: number, synchedBlockNumber: number): Promise<void> {
174
- await this.#store.transactionAsync(async () => {
175
- const nullifiersToUndo: string[] = [];
176
- const currentBlockNumber = blockNumber + 1;
177
- for (let i = currentBlockNumber; i <= synchedBlockNumber; i++) {
178
- nullifiersToUndo.push(...(await toArray(this.#nullifiersByBlockNumber.getValuesAsync(i))));
179
- }
180
- const notesIndexesToReinsert = await Promise.all(
181
- nullifiersToUndo.map(nullifier => this.#nullifiedNotesByNullifier.getAsync(nullifier)),
182
- );
183
- const notNullNoteIndexes = notesIndexesToReinsert.filter(noteIndex => noteIndex != undefined);
184
- const nullifiedNoteBuffers = await Promise.all(
185
- notNullNoteIndexes.map(noteIndex => this.#nullifiedNotes.getAsync(noteIndex!)),
186
- );
187
- const noteDaos = nullifiedNoteBuffers
188
- .filter(buffer => buffer != undefined)
189
- .map(buffer => NoteDao.fromBuffer(buffer!));
190
-
191
- for (const dao of noteDaos) {
192
- const noteIndex = toBufferBE(dao.index, 32).toString('hex');
193
- await this.#notes.set(noteIndex, dao.toBuffer());
194
- await this.#nullifierToNoteId.set(dao.siloedNullifier.toString(), noteIndex);
195
-
196
- const scopes = await toArray(this.#nullifiedNotesToScope.getValuesAsync(noteIndex));
197
-
198
- if (scopes.length === 0) {
199
- // We should never run into this error because notes always have a scope assigned to them - either on initial
200
- // insertion via `addNotes` or when removing their nullifiers.
201
- throw new Error(`No scopes found for nullified note with index ${noteIndex}`);
202
- }
203
-
204
- for (const scope of scopes) {
205
- await this.#notesByContractAndScope.get(scope.toString())!.set(dao.contractAddress.toString(), noteIndex);
206
- await this.#notesByStorageSlotAndScope.get(scope.toString())!.set(dao.storageSlot.toString(), noteIndex);
207
- await this.#notesToScope.set(noteIndex, scope);
208
- }
209
-
210
- await this.#nullifiedNotes.delete(noteIndex);
211
- await this.#nullifiedNotesToScope.delete(noteIndex);
212
- await this.#nullifiersByBlockNumber.deleteValue(dao.l2BlockNumber, dao.siloedNullifier.toString());
213
- await this.#nullifiedNotesByContract.deleteValue(dao.contractAddress.toString(), noteIndex);
214
- await this.#nullifiedNotesByStorageSlot.deleteValue(dao.storageSlot.toString(), noteIndex);
215
- await this.#nullifiedNotesByNullifier.delete(dao.siloedNullifier.toString());
216
- }
217
- });
218
- }
219
-
220
- /**
221
- * Retrieves notes based on the provided filter criteria.
222
- *
223
- * This method queries both active and optionally nullified notes based on the filter
224
- * parameters.
225
- *
226
- * @param filter - Filter criteria including contractAddress (required), and optional
227
- * owner, storageSlot, status, scopes, and siloedNullifier.
228
- * @returns Promise resolving to array of NoteDao objects matching the filter
229
- * @throws If filtering by an empty scopes array. Scopes have to be set to undefined or to a non-empty array.
230
- */
231
- async getNotes(filter: NotesFilter): Promise<NoteDao[]> {
232
- filter.status = filter.status ?? NoteStatus.ACTIVE;
233
-
234
- // throw early if scopes is an empty array
235
- if (filter.scopes !== undefined && filter.scopes.length === 0) {
236
- throw new Error(
237
- 'Trying to get notes with an empty scopes array. Scopes have to be set to undefined if intending on not filtering by scopes.',
238
- );
239
- }
240
-
241
- const candidateNoteSources = [];
242
-
243
- filter.scopes ??= (await toArray(this.#scopes.keysAsync())).map(addressString =>
244
- AztecAddress.fromString(addressString),
245
- );
246
-
247
- const activeNoteIdsPerScope: string[][] = [];
248
-
249
- for (const scope of new Set(filter.scopes)) {
250
- const formattedScopeString = scope.toString();
251
- if (!(await this.#scopes.hasAsync(formattedScopeString))) {
252
- throw new Error('Trying to get incoming notes of a scope that is not in the PXE database');
253
- }
254
-
255
- activeNoteIdsPerScope.push(
256
- filter.storageSlot
257
- ? await toArray(
258
- this.#notesByStorageSlotAndScope.get(formattedScopeString)!.getValuesAsync(filter.storageSlot.toString()),
259
- )
260
- : await toArray(
261
- this.#notesByContractAndScope
262
- .get(formattedScopeString)!
263
- .getValuesAsync(filter.contractAddress.toString()),
264
- ),
265
- );
266
- }
267
-
268
- candidateNoteSources.push({
269
- ids: new Set(activeNoteIdsPerScope.flat()),
270
- notes: this.#notes,
271
- });
272
-
273
- // If status is ACTIVE_OR_NULLIFIED we add nullified notes as candidates on top of the default active ones.
274
- if (filter.status === NoteStatus.ACTIVE_OR_NULLIFIED) {
275
- const nullifiedIds = filter.storageSlot
276
- ? await toArray(this.#nullifiedNotesByStorageSlot.getValuesAsync(filter.storageSlot.toString()))
277
- : await toArray(this.#nullifiedNotesByContract.getValuesAsync(filter.contractAddress.toString()));
278
-
279
- const setOfScopes = new Set(filter.scopes.map(s => s.toString() as string));
280
- const filteredNullifiedIds = new Set<string>();
281
-
282
- for (const noteId of nullifiedIds) {
283
- const scopeList = await toArray(this.#nullifiedNotesToScope.getValuesAsync(noteId));
284
- if (scopeList.some(scope => setOfScopes.has(scope))) {
285
- filteredNullifiedIds.add(noteId);
286
- }
287
- }
288
-
289
- if (filteredNullifiedIds.size > 0) {
290
- candidateNoteSources.push({
291
- ids: filteredNullifiedIds,
292
- notes: this.#nullifiedNotes,
293
- });
294
- }
295
- }
296
-
297
- const result: NoteDao[] = [];
298
- for (const { ids, notes } of candidateNoteSources) {
299
- for (const id of ids) {
300
- const serializedNote = await notes.getAsync(id);
301
- if (!serializedNote) {
302
- continue;
303
- }
304
-
305
- const note = NoteDao.fromBuffer(serializedNote);
306
- if (!note.contractAddress.equals(filter.contractAddress)) {
307
- continue;
308
- }
309
-
310
- if (filter.owner && !note.owner.equals(filter.owner)) {
311
- continue;
312
- }
313
-
314
- if (filter.storageSlot && !note.storageSlot.equals(filter.storageSlot!)) {
315
- continue;
316
- }
317
-
318
- if (filter.siloedNullifier && !note.siloedNullifier.equals(filter.siloedNullifier)) {
319
- continue;
320
- }
321
-
322
- result.push(note);
323
- }
324
- }
325
-
326
- return result;
327
- }
328
-
329
- /**
330
- * Transitions notes from "active" to "nullified" state.
331
- *
332
- * This operation processes a batch of nullifiers to mark the corresponding notes
333
- * as spent/nullified. The operation is atomic - if any nullifier is not found,
334
- * the entire operation fails and no notes are modified.
335
- *
336
- * @param nullifiers - Array of nullifiers with their block numbers to process
337
- * @returns Promise resolving to array of nullified NoteDao objects
338
- * @throws Error if any nullifier is not found in the active notes
339
- */
340
- applyNullifiers(nullifiers: DataInBlock<Fr>[]): Promise<NoteDao[]> {
341
- if (nullifiers.length === 0) {
342
- return Promise.resolve([]);
343
- }
344
-
345
- return this.#store.transactionAsync(async () => {
346
- const nullifiedNotes: NoteDao[] = [];
347
-
348
- for (const blockScopedNullifier of nullifiers) {
349
- const { data: nullifier, l2BlockNumber: blockNumber } = blockScopedNullifier;
350
- const nullifierKey = nullifier.toString();
351
-
352
- const noteIndex = await this.#nullifierToNoteId.getAsync(nullifierKey);
353
- if (!noteIndex) {
354
- // Check if already nullified?
355
- const alreadyNullified = await this.#nullifiedNotesByNullifier.getAsync(nullifierKey);
356
- if (alreadyNullified) {
357
- throw new Error(`Nullifier already applied in applyNullifiers`);
358
- }
359
- throw new Error('Nullifier not found in applyNullifiers');
360
- }
361
-
362
- const noteBuffer = noteIndex ? await this.#notes.getAsync(noteIndex) : undefined;
363
-
364
- if (!noteBuffer) {
365
- throw new Error('Note not found in applyNullifiers');
366
- }
367
-
368
- const noteScopes = await toArray(this.#notesToScope.getValuesAsync(noteIndex));
369
- if (noteScopes.length === 0) {
370
- // We should never run into this error because notes always have a scope assigned to them - either on initial
371
- // insertion via `addNotes` or when removing their nullifiers.
372
- throw new Error('Note scopes are missing in applyNullifiers');
373
- }
374
-
375
- const note = NoteDao.fromBuffer(noteBuffer);
376
-
377
- nullifiedNotes.push(note);
378
-
379
- await this.#notes.delete(noteIndex);
380
- await this.#notesToScope.delete(noteIndex);
381
-
382
- const scopes = await toArray(this.#scopes.keysAsync());
383
-
384
- for (const scope of scopes) {
385
- await this.#notesByContractAndScope.get(scope)!.deleteValue(note.contractAddress.toString(), noteIndex);
386
- await this.#notesByStorageSlotAndScope.get(scope)!.deleteValue(note.storageSlot.toString(), noteIndex);
387
- }
388
-
389
- for (const scope of noteScopes) {
390
- await this.#nullifiedNotesToScope.set(noteIndex, scope);
391
- }
392
- await this.#nullifiedNotes.set(noteIndex, note.toBuffer());
393
- await this.#nullifiersByBlockNumber.set(blockNumber, nullifier.toString());
394
- await this.#nullifiedNotesByContract.set(note.contractAddress.toString(), noteIndex);
395
- await this.#nullifiedNotesByStorageSlot.set(note.storageSlot.toString(), noteIndex);
396
- await this.#nullifiedNotesByNullifier.set(nullifier.toString(), noteIndex);
397
-
398
- await this.#nullifierToNoteId.delete(nullifier.toString());
399
- }
400
- return nullifiedNotes;
401
- });
402
- }
403
- }
@@ -1,143 +0,0 @@
1
- import { Fr } from '@aztec/foundation/fields';
2
- import { createLogger } from '@aztec/foundation/log';
3
- import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize';
4
- import type { AztecAsyncArray, AztecAsyncKVStore, AztecAsyncMap } from '@aztec/kv-store';
5
- import type { EventSelector } from '@aztec/stdlib/abi';
6
- import type { AztecAddress } from '@aztec/stdlib/aztec-address';
7
- import { L2BlockHash } from '@aztec/stdlib/block';
8
- import { TxHash } from '@aztec/stdlib/tx';
9
-
10
- import type { PrivateEvent } from '../../pxe.js';
11
-
12
- interface PrivateEventEntry {
13
- msgContent: Buffer;
14
- blockNumber: number;
15
- blockHash: Buffer;
16
- eventCommitmentIndex: number;
17
- txHash: Buffer;
18
- }
19
-
20
- /**
21
- * Stores decrypted private event logs.
22
- */
23
- export class PrivateEventDataProvider {
24
- #store: AztecAsyncKVStore;
25
- /** Array storing the actual private event log entries containing the log content and block number */
26
- #eventLogs: AztecAsyncArray<PrivateEventEntry>;
27
- /** Map from contract_address_recipient_eventSelector to array of indices into #eventLogs for efficient lookup */
28
- #eventLogIndex: AztecAsyncMap<string, number[]>;
29
- /** Map from eventCommitmentIndex to boolean indicating if log has been seen. */
30
- #seenLogs: AztecAsyncMap<number, boolean>;
31
-
32
- logger = createLogger('private_event_data_provider');
33
-
34
- constructor(store: AztecAsyncKVStore) {
35
- this.#store = store;
36
- this.#eventLogs = this.#store.openArray('private_event_logs');
37
- this.#eventLogIndex = this.#store.openMap('private_event_log_index');
38
- this.#seenLogs = this.#store.openMap('seen_logs');
39
- }
40
-
41
- /**
42
- * Store a private event log.
43
- * @param contractAddress - The address of the contract that emitted the event.
44
- * @param recipient - The recipient of the event.
45
- * @param eventSelector - The event selector of the event.
46
- * @param msgContent - The content of the event.
47
- * @param txHash - The transaction hash of the event log.
48
- * @param eventCommitmentIndex - The index of the event commitment in the nullifier tree.
49
- * @param blockNumber - The block number in which the event was emitted.
50
- */
51
- storePrivateEventLog(
52
- contractAddress: AztecAddress,
53
- recipient: AztecAddress,
54
- eventSelector: EventSelector,
55
- msgContent: Fr[],
56
- txHash: TxHash,
57
- eventCommitmentIndex: number,
58
- blockNumber: number,
59
- blockHash: L2BlockHash,
60
- ): Promise<void> {
61
- return this.#store.transactionAsync(async () => {
62
- const key = `${contractAddress.toString()}_${recipient.toString()}_${eventSelector.toString()}`;
63
-
64
- // Check if this exact log has already been stored using eventCommitmentIndex as unique identifier
65
- const hasBeenSeen = await this.#seenLogs.getAsync(eventCommitmentIndex);
66
- if (hasBeenSeen) {
67
- this.logger.verbose('Ignoring duplicate event log', { txHash: txHash.toString(), eventCommitmentIndex });
68
- return;
69
- }
70
-
71
- this.logger.verbose('storing private event log', { contractAddress, recipient, msgContent, blockNumber });
72
-
73
- const index = await this.#eventLogs.lengthAsync();
74
- await this.#eventLogs.push({
75
- msgContent: serializeToBuffer(msgContent),
76
- blockNumber,
77
- blockHash: blockHash.toBuffer(),
78
- eventCommitmentIndex,
79
- txHash: txHash.toBuffer(),
80
- });
81
-
82
- const existingIndices = (await this.#eventLogIndex.getAsync(key)) || [];
83
- await this.#eventLogIndex.set(key, [...existingIndices, index]);
84
-
85
- // Mark this log as seen using eventCommitmentIndex
86
- await this.#seenLogs.set(eventCommitmentIndex, true);
87
- });
88
- }
89
-
90
- /**
91
- * Returns the private events given search parameters.
92
- * @param contractAddress - The address of the contract to get events from.
93
- * @param from - The block number to search from.
94
- * @param numBlocks - The amount of blocks to search.
95
- * @param recipients - The addresses that decrypted the logs.
96
- * @param eventSelector - The event selector to filter by.
97
- * @returns - The event log contents.
98
- */
99
- public async getPrivateEvents(
100
- contractAddress: AztecAddress,
101
- from: number,
102
- numBlocks: number,
103
- recipients: AztecAddress[],
104
- eventSelector: EventSelector,
105
- ): Promise<PrivateEvent[]> {
106
- const events: Array<{ eventCommitmentIndex: number; event: PrivateEvent }> = [];
107
-
108
- for (const recipient of recipients) {
109
- const key = `${contractAddress.toString()}_${recipient.toString()}_${eventSelector.toString()}`;
110
- const indices = (await this.#eventLogIndex.getAsync(key)) || [];
111
-
112
- for (const index of indices) {
113
- const entry = await this.#eventLogs.atAsync(index);
114
- if (!entry || entry.blockNumber < from || entry.blockNumber >= from + numBlocks) {
115
- continue;
116
- }
117
-
118
- // Convert buffer back to Fr array
119
- const reader = BufferReader.asReader(entry.msgContent);
120
- const numFields = entry.msgContent.length / Fr.SIZE_IN_BYTES;
121
- const msgContent = reader.readArray(numFields, Fr);
122
- const txHash = TxHash.fromBuffer(entry.txHash);
123
- const blockHash = L2BlockHash.fromBuffer(entry.blockHash);
124
-
125
- events.push({
126
- eventCommitmentIndex: entry.eventCommitmentIndex,
127
- event: {
128
- packedEvent: msgContent,
129
- blockNumber: entry.blockNumber,
130
- recipient,
131
- txHash,
132
- blockHash,
133
- eventSelector,
134
- },
135
- });
136
- }
137
- }
138
-
139
- // Sort by eventCommitmentIndex only
140
- events.sort((a, b) => a.eventCommitmentIndex - b.eventCommitmentIndex);
141
- return events.map(ev => ev.event);
142
- }
143
- }
@@ -1 +0,0 @@
1
- export { SyncDataProvider } from './sync_data_provider.js';
@@ -1 +0,0 @@
1
- export { TaggingDataProvider } from './tagging_data_provider.js';
@@ -1,120 +0,0 @@
1
- import { toArray } from '@aztec/foundation/iterable';
2
- import type { AztecAsyncKVStore, AztecAsyncMap } from '@aztec/kv-store';
3
- import { AztecAddress } from '@aztec/stdlib/aztec-address';
4
- import type { DirectionalAppTaggingSecret, PreTag } from '@aztec/stdlib/logs';
5
-
6
- export class TaggingDataProvider {
7
- #store: AztecAsyncKVStore;
8
- #addressBook: AztecAsyncMap<string, true>;
9
-
10
- // Stores the last used index for each directional app tagging secret. Taking into account whether we are
11
- // requesting the index as a sender or as a recipient because the sender and recipient can be in the same PXE.
12
- #lastUsedIndexesAsSenders: AztecAsyncMap<string, number>;
13
- #lastUsedIndexesAsRecipients: AztecAsyncMap<string, number>;
14
-
15
- constructor(store: AztecAsyncKVStore) {
16
- this.#store = store;
17
-
18
- this.#addressBook = this.#store.openMap('address_book');
19
-
20
- this.#lastUsedIndexesAsSenders = this.#store.openMap('last_used_indexes_as_senders');
21
- this.#lastUsedIndexesAsRecipients = this.#store.openMap('last_used_indexes_as_recipients');
22
- }
23
-
24
- /**
25
- * Sets the last used indexes when sending a log.
26
- * @param preTags - The pre tags containing the directional app tagging secrets and the indexes that are to be
27
- * updated in the db.
28
- * @throws If any two pre tags contain the same directional app tagging secret
29
- */
30
- setLastUsedIndexesAsSender(preTags: PreTag[]) {
31
- this.#assertUniqueSecrets(preTags, 'sender');
32
-
33
- return Promise.all(
34
- preTags.map(({ secret, index }) => this.#lastUsedIndexesAsSenders.set(secret.toString(), index)),
35
- );
36
- }
37
-
38
- /**
39
- * Sets the last used indexes when looking for logs.
40
- * @param preTags - The pre tags containing the directional app tagging secrets and the indexes that are to be
41
- * updated in the db.
42
- * @throws If any two pre tags contain the same directional app tagging secret
43
- */
44
- setLastUsedIndexesAsRecipient(preTags: PreTag[]) {
45
- this.#assertUniqueSecrets(preTags, 'recipient');
46
-
47
- return Promise.all(
48
- preTags.map(({ secret, index }) => this.#lastUsedIndexesAsRecipients.set(secret.toString(), index)),
49
- );
50
- }
51
-
52
- // It should never happen that we would receive any two pre tags on the input containing the same directional app
53
- // tagging secret as everywhere we always just apply the largest index. Hence this check is a good way to catch
54
- // bugs.
55
- #assertUniqueSecrets(preTags: PreTag[], role: 'sender' | 'recipient'): void {
56
- const secretStrings = preTags.map(({ secret }) => secret.toString());
57
- const uniqueSecrets = new Set(secretStrings);
58
- if (uniqueSecrets.size !== secretStrings.length) {
59
- throw new Error(`Duplicate secrets found when setting last used indexes as ${role}`);
60
- }
61
- }
62
-
63
- /**
64
- * Returns the last used index when sending a log with a given secret.
65
- * @param secret - The directional app tagging secret.
66
- * @returns The last used index for the given directional app tagging secret, or undefined if not found.
67
- */
68
- async getLastUsedIndexesAsSender(secret: DirectionalAppTaggingSecret): Promise<number | undefined> {
69
- return await this.#lastUsedIndexesAsSenders.getAsync(secret.toString());
70
- }
71
-
72
- /**
73
- * Returns the last used indexes when looking for logs as a recipient.
74
- * @param secrets - The directional app tagging secrets to obtain the indexes for.
75
- * @returns The last used indexes for the given directional app tagging secrets, or undefined if have never yet found
76
- * a log for a given secret.
77
- */
78
- getLastUsedIndexesAsRecipient(secrets: DirectionalAppTaggingSecret[]): Promise<(number | undefined)[]> {
79
- return Promise.all(secrets.map(secret => this.#lastUsedIndexesAsRecipients.getAsync(secret.toString())));
80
- }
81
-
82
- resetNoteSyncData(): Promise<void> {
83
- return this.#store.transactionAsync(async () => {
84
- const keysForSenders = await toArray(this.#lastUsedIndexesAsSenders.keysAsync());
85
- await Promise.all(keysForSenders.map(secret => this.#lastUsedIndexesAsSenders.delete(secret)));
86
- const keysForRecipients = await toArray(this.#lastUsedIndexesAsRecipients.keysAsync());
87
- await Promise.all(keysForRecipients.map(secret => this.#lastUsedIndexesAsRecipients.delete(secret)));
88
- });
89
- }
90
-
91
- async addSenderAddress(address: AztecAddress): Promise<boolean> {
92
- if (await this.#addressBook.hasAsync(address.toString())) {
93
- return false;
94
- }
95
-
96
- await this.#addressBook.set(address.toString(), true);
97
-
98
- return true;
99
- }
100
-
101
- async getSenderAddresses(): Promise<AztecAddress[]> {
102
- return (await toArray(this.#addressBook.keysAsync())).map(AztecAddress.fromString);
103
- }
104
-
105
- async removeSenderAddress(address: AztecAddress): Promise<boolean> {
106
- if (!(await this.#addressBook.hasAsync(address.toString()))) {
107
- return false;
108
- }
109
-
110
- await this.#addressBook.delete(address.toString());
111
-
112
- return true;
113
- }
114
-
115
- async getSize() {
116
- const addressesCount = (await toArray(this.#addressBook.keysAsync())).length;
117
- // All keys are addresses
118
- return 3 * addressesCount * AztecAddress.SIZE_IN_BYTES;
119
- }
120
- }
@@ -1 +0,0 @@
1
- export * from './synchronizer.js';