@aztec/pxe 0.0.0-test.0 → 0.0.1-commit.03f7ef2

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 (402) hide show
  1. package/README.md +5 -5
  2. package/dest/bin/check_oracle_version.d.ts +2 -0
  3. package/dest/bin/check_oracle_version.d.ts.map +1 -0
  4. package/dest/bin/check_oracle_version.js +129 -0
  5. package/dest/block_synchronizer/block_synchronizer.d.ts +39 -0
  6. package/dest/block_synchronizer/block_synchronizer.d.ts.map +1 -0
  7. package/dest/{synchronizer/synchronizer.js → block_synchronizer/block_synchronizer.js} +36 -32
  8. package/dest/block_synchronizer/index.d.ts +2 -0
  9. package/dest/block_synchronizer/index.d.ts.map +1 -0
  10. package/dest/block_synchronizer/index.js +1 -0
  11. package/dest/config/index.d.ts +11 -24
  12. package/dest/config/index.d.ts.map +1 -1
  13. package/dest/config/index.js +18 -33
  14. package/dest/config/package_info.d.ts +1 -1
  15. package/dest/config/package_info.js +1 -1
  16. package/dest/contract_function_simulator/contract_function_simulator.d.ts +83 -0
  17. package/dest/contract_function_simulator/contract_function_simulator.d.ts.map +1 -0
  18. package/dest/contract_function_simulator/contract_function_simulator.js +325 -0
  19. package/dest/contract_function_simulator/execution_note_cache.d.ts +95 -0
  20. package/dest/contract_function_simulator/execution_note_cache.d.ts.map +1 -0
  21. package/dest/contract_function_simulator/execution_note_cache.js +191 -0
  22. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts +16 -0
  23. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts.map +1 -0
  24. package/dest/contract_function_simulator/execution_tagging_index_cache.js +26 -0
  25. package/dest/contract_function_simulator/hashed_values_cache.d.ts +28 -0
  26. package/dest/contract_function_simulator/hashed_values_cache.d.ts.map +1 -0
  27. package/dest/contract_function_simulator/hashed_values_cache.js +36 -0
  28. package/dest/contract_function_simulator/index.d.ts +14 -0
  29. package/dest/contract_function_simulator/index.d.ts.map +1 -0
  30. package/dest/contract_function_simulator/index.js +12 -0
  31. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts +20 -0
  32. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts.map +1 -0
  33. package/dest/contract_function_simulator/noir-structs/event_validation_request.js +37 -0
  34. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.d.ts +16 -0
  35. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.d.ts.map +1 -0
  36. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.js +26 -0
  37. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts +17 -0
  38. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts.map +1 -0
  39. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.js +65 -0
  40. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts +24 -0
  41. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts.map +1 -0
  42. package/dest/contract_function_simulator/noir-structs/note_validation_request.js +51 -0
  43. package/dest/contract_function_simulator/noir-structs/utility_context.d.ts +22 -0
  44. package/dest/contract_function_simulator/noir-structs/utility_context.d.ts.map +1 -0
  45. package/dest/contract_function_simulator/noir-structs/utility_context.js +33 -0
  46. package/dest/contract_function_simulator/oracle/index.d.ts +14 -0
  47. package/dest/contract_function_simulator/oracle/index.d.ts.map +1 -0
  48. package/dest/contract_function_simulator/oracle/index.js +2 -0
  49. package/dest/contract_function_simulator/oracle/interfaces.d.ts +103 -0
  50. package/dest/contract_function_simulator/oracle/interfaces.d.ts.map +1 -0
  51. package/dest/contract_function_simulator/oracle/interfaces.js +4 -0
  52. package/dest/contract_function_simulator/oracle/message_load_oracle_inputs.d.ts +17 -0
  53. package/dest/contract_function_simulator/oracle/message_load_oracle_inputs.d.ts.map +1 -0
  54. package/dest/contract_function_simulator/oracle/message_load_oracle_inputs.js +24 -0
  55. package/dest/contract_function_simulator/oracle/note_packing_utils.d.ts +28 -0
  56. package/dest/contract_function_simulator/oracle/note_packing_utils.d.ts.map +1 -0
  57. package/dest/contract_function_simulator/oracle/note_packing_utils.js +54 -0
  58. package/dest/contract_function_simulator/oracle/oracle.d.ts +58 -0
  59. package/dest/contract_function_simulator/oracle/oracle.d.ts.map +1 -0
  60. package/dest/contract_function_simulator/oracle/oracle.js +345 -0
  61. package/dest/contract_function_simulator/oracle/private_execution.d.ts +47 -0
  62. package/dest/contract_function_simulator/oracle/private_execution.d.ts.map +1 -0
  63. package/dest/contract_function_simulator/oracle/private_execution.js +123 -0
  64. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts +240 -0
  65. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts.map +1 -0
  66. package/dest/contract_function_simulator/oracle/private_execution_oracle.js +439 -0
  67. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts +195 -0
  68. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts.map +1 -0
  69. package/dest/contract_function_simulator/oracle/utility_execution_oracle.js +372 -0
  70. package/dest/contract_function_simulator/pick_notes.d.ts +85 -0
  71. package/dest/contract_function_simulator/pick_notes.d.ts.map +1 -0
  72. package/dest/contract_function_simulator/pick_notes.js +51 -0
  73. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts +6 -0
  74. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts.map +1 -0
  75. package/dest/contract_function_simulator/proxied_contract_data_source.js +80 -0
  76. package/dest/contract_function_simulator/proxied_node.d.ts +9 -0
  77. package/dest/contract_function_simulator/proxied_node.d.ts.map +1 -0
  78. package/dest/contract_function_simulator/proxied_node.js +27 -0
  79. package/dest/debug/pxe_debug_utils.d.ts +31 -0
  80. package/dest/debug/pxe_debug_utils.d.ts.map +1 -0
  81. package/dest/debug/pxe_debug_utils.js +37 -0
  82. package/dest/entrypoints/client/bundle/index.d.ts +4 -3
  83. package/dest/entrypoints/client/bundle/index.d.ts.map +1 -1
  84. package/dest/entrypoints/client/bundle/index.js +2 -2
  85. package/dest/entrypoints/client/bundle/utils.d.ts +10 -10
  86. package/dest/entrypoints/client/bundle/utils.d.ts.map +1 -1
  87. package/dest/entrypoints/client/bundle/utils.js +18 -12
  88. package/dest/entrypoints/client/lazy/index.d.ts +4 -3
  89. package/dest/entrypoints/client/lazy/index.d.ts.map +1 -1
  90. package/dest/entrypoints/client/lazy/index.js +2 -2
  91. package/dest/entrypoints/client/lazy/utils.d.ts +9 -9
  92. package/dest/entrypoints/client/lazy/utils.d.ts.map +1 -1
  93. package/dest/entrypoints/client/lazy/utils.js +17 -11
  94. package/dest/entrypoints/pxe_creation_options.d.ts +16 -0
  95. package/dest/entrypoints/pxe_creation_options.d.ts.map +1 -0
  96. package/dest/entrypoints/server/index.d.ts +6 -4
  97. package/dest/entrypoints/server/index.d.ts.map +1 -1
  98. package/dest/entrypoints/server/index.js +4 -3
  99. package/dest/entrypoints/server/utils.d.ts +8 -16
  100. package/dest/entrypoints/server/utils.d.ts.map +1 -1
  101. package/dest/entrypoints/server/utils.js +31 -36
  102. package/dest/error_enriching.d.ts +11 -0
  103. package/dest/error_enriching.d.ts.map +1 -0
  104. package/dest/{pxe_service/error_enriching.js → error_enriching.js} +26 -18
  105. package/dest/events/event_service.d.ts +15 -0
  106. package/dest/events/event_service.d.ts.map +1 -0
  107. package/dest/events/event_service.js +47 -0
  108. package/dest/events/index.d.ts +2 -0
  109. package/dest/events/index.d.ts.map +1 -0
  110. package/dest/events/index.js +1 -0
  111. package/dest/events/private_event_filter_validator.d.ts +9 -0
  112. package/dest/events/private_event_filter_validator.d.ts.map +1 -0
  113. package/dest/events/private_event_filter_validator.js +39 -0
  114. package/dest/logs/log_service.d.ts +43 -0
  115. package/dest/logs/log_service.d.ts.map +1 -0
  116. package/dest/logs/log_service.js +239 -0
  117. package/dest/notes/index.d.ts +2 -0
  118. package/dest/notes/index.d.ts.map +1 -0
  119. package/dest/notes/index.js +1 -0
  120. package/dest/notes/note_service.d.ts +48 -0
  121. package/dest/notes/note_service.d.ts.map +1 -0
  122. package/dest/notes/note_service.js +152 -0
  123. package/dest/oracle_version.d.ts +3 -0
  124. package/dest/oracle_version.d.ts.map +1 -0
  125. package/dest/oracle_version.js +10 -0
  126. package/dest/private_kernel/hints/build_private_kernel_reset_private_inputs.d.ts +28 -0
  127. package/dest/private_kernel/hints/build_private_kernel_reset_private_inputs.d.ts.map +1 -0
  128. package/dest/private_kernel/hints/build_private_kernel_reset_private_inputs.js +271 -0
  129. package/dest/private_kernel/hints/compute_tx_include_by_timestamp.d.ts +4 -0
  130. package/dest/private_kernel/hints/compute_tx_include_by_timestamp.d.ts.map +1 -0
  131. package/dest/private_kernel/hints/compute_tx_include_by_timestamp.js +41 -0
  132. package/dest/private_kernel/hints/index.d.ts +3 -0
  133. package/dest/private_kernel/hints/index.d.ts.map +1 -0
  134. package/dest/{kernel_prover → private_kernel}/hints/index.js +1 -0
  135. package/dest/private_kernel/index.d.ts +3 -0
  136. package/dest/private_kernel/index.d.ts.map +1 -0
  137. package/dest/private_kernel/index.js +2 -0
  138. package/dest/private_kernel/private_kernel_execution_prover.d.ts +44 -0
  139. package/dest/private_kernel/private_kernel_execution_prover.d.ts.map +1 -0
  140. package/dest/private_kernel/private_kernel_execution_prover.js +286 -0
  141. package/dest/private_kernel/private_kernel_oracle.d.ts +63 -0
  142. package/dest/private_kernel/private_kernel_oracle.d.ts.map +1 -0
  143. package/dest/private_kernel/private_kernel_oracle.js +4 -0
  144. package/dest/private_kernel/private_kernel_oracle_impl.d.ts +46 -0
  145. package/dest/private_kernel/private_kernel_oracle_impl.d.ts.map +1 -0
  146. package/dest/{kernel_oracle/index.js → private_kernel/private_kernel_oracle_impl.js} +19 -9
  147. package/dest/public_storage/public_storage_service.d.ts +24 -0
  148. package/dest/public_storage/public_storage_service.d.ts.map +1 -0
  149. package/dest/public_storage/public_storage_service.js +26 -0
  150. package/dest/pxe.d.ts +231 -0
  151. package/dest/pxe.d.ts.map +1 -0
  152. package/dest/pxe.js +756 -0
  153. package/dest/storage/address_data_provider/address_data_provider.d.ts +2 -4
  154. package/dest/storage/address_data_provider/address_data_provider.d.ts.map +1 -1
  155. package/dest/storage/address_data_provider/address_data_provider.js +0 -3
  156. package/dest/storage/address_data_provider/index.d.ts +1 -1
  157. package/dest/storage/anchor_block_data_provider/anchor_block_data_provider.d.ts +9 -0
  158. package/dest/storage/anchor_block_data_provider/anchor_block_data_provider.d.ts.map +1 -0
  159. package/dest/storage/{sync_data_provider/sync_data_provider.js → anchor_block_data_provider/anchor_block_data_provider.js} +2 -12
  160. package/dest/storage/anchor_block_data_provider/index.d.ts +2 -0
  161. package/dest/storage/anchor_block_data_provider/index.d.ts.map +1 -0
  162. package/dest/storage/anchor_block_data_provider/index.js +1 -0
  163. package/dest/storage/capsule_data_provider/capsule_data_provider.d.ts +48 -7
  164. package/dest/storage/capsule_data_provider/capsule_data_provider.d.ts.map +1 -1
  165. package/dest/storage/capsule_data_provider/capsule_data_provider.js +117 -28
  166. package/dest/storage/capsule_data_provider/index.d.ts +1 -1
  167. package/dest/storage/contract_data_provider/contract_data_provider.d.ts +16 -59
  168. package/dest/storage/contract_data_provider/contract_data_provider.d.ts.map +1 -1
  169. package/dest/storage/contract_data_provider/contract_data_provider.js +121 -80
  170. package/dest/storage/contract_data_provider/index.d.ts +1 -2
  171. package/dest/storage/contract_data_provider/index.d.ts.map +1 -1
  172. package/dest/storage/contract_data_provider/index.js +0 -1
  173. package/dest/storage/contract_data_provider/private_functions_tree.d.ts +3 -42
  174. package/dest/storage/contract_data_provider/private_functions_tree.d.ts.map +1 -1
  175. package/dest/storage/contract_data_provider/private_functions_tree.js +10 -62
  176. package/dest/storage/index.d.ts +4 -5
  177. package/dest/storage/index.d.ts.map +1 -1
  178. package/dest/storage/index.js +3 -4
  179. package/dest/storage/metadata.d.ts +2 -0
  180. package/dest/storage/metadata.d.ts.map +1 -0
  181. package/dest/storage/metadata.js +1 -0
  182. package/dest/storage/note_data_provider/index.d.ts +2 -2
  183. package/dest/storage/note_data_provider/index.d.ts.map +1 -1
  184. package/dest/storage/note_data_provider/index.js +1 -1
  185. package/dest/storage/note_data_provider/note_data_provider.d.ts +75 -11
  186. package/dest/storage/note_data_provider/note_data_provider.d.ts.map +1 -1
  187. package/dest/storage/note_data_provider/note_data_provider.js +155 -82
  188. package/dest/storage/private_event_data_provider/private_event_data_provider.d.ts +51 -0
  189. package/dest/storage/private_event_data_provider/private_event_data_provider.d.ts.map +1 -0
  190. package/dest/storage/private_event_data_provider/private_event_data_provider.js +115 -0
  191. package/dest/storage/tagging_data_provider/index.d.ts +3 -2
  192. package/dest/storage/tagging_data_provider/index.d.ts.map +1 -1
  193. package/dest/storage/tagging_data_provider/index.js +2 -1
  194. package/dest/storage/tagging_data_provider/recipient_tagging_data_provider.d.ts +31 -0
  195. package/dest/storage/tagging_data_provider/recipient_tagging_data_provider.d.ts.map +1 -0
  196. package/dest/storage/tagging_data_provider/recipient_tagging_data_provider.js +65 -0
  197. package/dest/storage/tagging_data_provider/sender_tagging_data_provider.d.ts +67 -0
  198. package/dest/storage/tagging_data_provider/sender_tagging_data_provider.d.ts.map +1 -0
  199. package/dest/storage/tagging_data_provider/sender_tagging_data_provider.js +196 -0
  200. package/dest/tagging/constants.d.ts +2 -0
  201. package/dest/tagging/constants.d.ts.map +1 -0
  202. package/dest/tagging/constants.js +3 -0
  203. package/dest/tagging/index.d.ts +5 -0
  204. package/dest/tagging/index.d.ts.map +1 -0
  205. package/dest/tagging/index.js +3 -0
  206. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts +14 -0
  207. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts.map +1 -0
  208. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.js +99 -0
  209. package/dest/tagging/recipient_sync/new_recipient_tagging_data_provider.d.ts +21 -0
  210. package/dest/tagging/recipient_sync/new_recipient_tagging_data_provider.d.ts.map +1 -0
  211. package/dest/tagging/recipient_sync/new_recipient_tagging_data_provider.js +42 -0
  212. package/dest/tagging/recipient_sync/utils/find_highest_indexes.d.ts +12 -0
  213. package/dest/tagging/recipient_sync/utils/find_highest_indexes.d.ts.map +1 -0
  214. package/dest/tagging/recipient_sync/utils/find_highest_indexes.js +20 -0
  215. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts +14 -0
  216. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts.map +1 -0
  217. package/dest/tagging/recipient_sync/utils/load_logs_for_range.js +29 -0
  218. package/dest/tagging/sync/sync_sender_tagging_indexes.d.ts +21 -0
  219. package/dest/tagging/sync/sync_sender_tagging_indexes.d.ts.map +1 -0
  220. package/dest/tagging/sync/sync_sender_tagging_indexes.js +89 -0
  221. package/dest/tagging/sync/utils/get_status_change_of_pending.d.ts +11 -0
  222. package/dest/tagging/sync/utils/get_status_change_of_pending.d.ts.map +1 -0
  223. package/dest/tagging/sync/utils/get_status_change_of_pending.js +32 -0
  224. package/dest/tagging/sync/utils/load_and_store_new_tagging_indexes.d.ts +18 -0
  225. package/dest/tagging/sync/utils/load_and_store_new_tagging_indexes.d.ts.map +1 -0
  226. package/dest/tagging/sync/utils/load_and_store_new_tagging_indexes.js +55 -0
  227. package/dest/tagging/utils.d.ts +18 -0
  228. package/dest/tagging/utils.d.ts.map +1 -0
  229. package/dest/tagging/utils.js +25 -0
  230. package/dest/tree_membership/tree_membership_service.d.ts +52 -0
  231. package/dest/tree_membership/tree_membership_service.d.ts.map +1 -0
  232. package/dest/tree_membership/tree_membership_service.js +84 -0
  233. package/package.json +37 -34
  234. package/src/bin/check_oracle_version.ts +160 -0
  235. package/src/{synchronizer/synchronizer.ts → block_synchronizer/block_synchronizer.ts} +39 -35
  236. package/src/block_synchronizer/index.ts +1 -0
  237. package/src/config/index.ts +27 -55
  238. package/src/config/package_info.ts +1 -1
  239. package/src/contract_function_simulator/contract_function_simulator.ts +618 -0
  240. package/src/contract_function_simulator/execution_note_cache.ts +233 -0
  241. package/src/contract_function_simulator/execution_tagging_index_cache.ts +32 -0
  242. package/src/contract_function_simulator/hashed_values_cache.ts +47 -0
  243. package/src/contract_function_simulator/index.ts +13 -0
  244. package/src/contract_function_simulator/noir-structs/event_validation_request.ts +47 -0
  245. package/src/contract_function_simulator/noir-structs/log_retrieval_request.ts +28 -0
  246. package/src/contract_function_simulator/noir-structs/log_retrieval_response.ts +69 -0
  247. package/src/contract_function_simulator/noir-structs/note_validation_request.ts +64 -0
  248. package/src/contract_function_simulator/noir-structs/utility_context.ts +42 -0
  249. package/src/contract_function_simulator/oracle/index.ts +16 -0
  250. package/src/contract_function_simulator/oracle/interfaces.ts +175 -0
  251. package/src/contract_function_simulator/oracle/message_load_oracle_inputs.ts +23 -0
  252. package/src/contract_function_simulator/oracle/note_packing_utils.ts +68 -0
  253. package/src/contract_function_simulator/oracle/oracle.ts +605 -0
  254. package/src/contract_function_simulator/oracle/private_execution.ts +209 -0
  255. package/src/contract_function_simulator/oracle/private_execution_oracle.ts +704 -0
  256. package/src/contract_function_simulator/oracle/utility_execution_oracle.ts +532 -0
  257. package/src/contract_function_simulator/pick_notes.ts +141 -0
  258. package/src/contract_function_simulator/proxied_contract_data_source.ts +83 -0
  259. package/src/contract_function_simulator/proxied_node.ts +33 -0
  260. package/src/debug/pxe_debug_utils.ts +48 -0
  261. package/src/entrypoints/client/bundle/index.ts +3 -2
  262. package/src/entrypoints/client/bundle/utils.ts +36 -36
  263. package/src/entrypoints/client/lazy/index.ts +3 -2
  264. package/src/entrypoints/client/lazy/utils.ts +36 -31
  265. package/src/entrypoints/pxe_creation_options.ts +12 -0
  266. package/src/entrypoints/server/index.ts +5 -3
  267. package/src/entrypoints/server/utils.ts +59 -51
  268. package/src/{pxe_service/error_enriching.ts → error_enriching.ts} +36 -27
  269. package/src/events/event_service.ts +77 -0
  270. package/src/events/index.ts +1 -0
  271. package/src/events/private_event_filter_validator.ts +48 -0
  272. package/src/logs/log_service.ts +364 -0
  273. package/src/notes/index.ts +1 -0
  274. package/src/notes/note_service.ts +200 -0
  275. package/src/oracle_version.ts +11 -0
  276. package/src/{kernel_prover → private_kernel}/hints/build_private_kernel_reset_private_inputs.ts +159 -147
  277. package/src/private_kernel/hints/compute_tx_include_by_timestamp.ts +58 -0
  278. package/src/{kernel_prover → private_kernel}/hints/index.ts +1 -0
  279. package/src/private_kernel/index.ts +2 -0
  280. package/src/private_kernel/private_kernel_execution_prover.ts +432 -0
  281. package/src/{kernel_prover/proving_data_oracle.ts → private_kernel/private_kernel_oracle.ts} +19 -30
  282. package/src/{kernel_oracle/index.ts → private_kernel/private_kernel_oracle_impl.ts} +33 -17
  283. package/src/public_storage/public_storage_service.ts +33 -0
  284. package/src/pxe.ts +1063 -0
  285. package/src/storage/address_data_provider/address_data_provider.ts +1 -7
  286. package/src/storage/{sync_data_provider/sync_data_provider.ts → anchor_block_data_provider/anchor_block_data_provider.ts} +2 -17
  287. package/src/storage/anchor_block_data_provider/index.ts +1 -0
  288. package/src/storage/capsule_data_provider/capsule_data_provider.ts +130 -31
  289. package/src/storage/contract_data_provider/contract_data_provider.ts +152 -94
  290. package/src/storage/contract_data_provider/index.ts +0 -1
  291. package/src/storage/contract_data_provider/private_functions_tree.ts +12 -76
  292. package/src/storage/index.ts +3 -5
  293. package/src/storage/metadata.ts +1 -0
  294. package/src/storage/note_data_provider/index.ts +1 -1
  295. package/src/storage/note_data_provider/note_data_provider.ts +188 -121
  296. package/src/storage/private_event_data_provider/private_event_data_provider.ts +162 -0
  297. package/src/storage/tagging_data_provider/index.ts +2 -1
  298. package/src/storage/tagging_data_provider/recipient_tagging_data_provider.ts +86 -0
  299. package/src/storage/tagging_data_provider/sender_tagging_data_provider.ts +244 -0
  300. package/src/tagging/constants.ts +3 -0
  301. package/src/tagging/index.ts +4 -0
  302. package/src/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.ts +129 -0
  303. package/src/tagging/recipient_sync/new_recipient_tagging_data_provider.ts +53 -0
  304. package/src/tagging/recipient_sync/utils/find_highest_indexes.ts +34 -0
  305. package/src/tagging/recipient_sync/utils/load_logs_for_range.ts +43 -0
  306. package/src/tagging/sync/sync_sender_tagging_indexes.ts +112 -0
  307. package/src/tagging/sync/utils/get_status_change_of_pending.ts +44 -0
  308. package/src/tagging/sync/utils/load_and_store_new_tagging_indexes.ts +72 -0
  309. package/src/tagging/utils.ts +32 -0
  310. package/src/tree_membership/tree_membership_service.ts +112 -0
  311. package/dest/bin/index.d.ts +0 -3
  312. package/dest/bin/index.d.ts.map +0 -1
  313. package/dest/bin/index.js +0 -28
  314. package/dest/entrypoints/client/pxe_creation_options.d.ts +0 -11
  315. package/dest/entrypoints/client/pxe_creation_options.d.ts.map +0 -1
  316. package/dest/kernel_oracle/index.d.ts +0 -45
  317. package/dest/kernel_oracle/index.d.ts.map +0 -1
  318. package/dest/kernel_prover/hints/build_private_kernel_reset_private_inputs.d.ts +0 -28
  319. package/dest/kernel_prover/hints/build_private_kernel_reset_private_inputs.d.ts.map +0 -1
  320. package/dest/kernel_prover/hints/build_private_kernel_reset_private_inputs.js +0 -270
  321. package/dest/kernel_prover/hints/index.d.ts +0 -2
  322. package/dest/kernel_prover/hints/index.d.ts.map +0 -1
  323. package/dest/kernel_prover/index.d.ts +0 -3
  324. package/dest/kernel_prover/index.d.ts.map +0 -1
  325. package/dest/kernel_prover/index.js +0 -2
  326. package/dest/kernel_prover/kernel_prover.d.ts +0 -38
  327. package/dest/kernel_prover/kernel_prover.d.ts.map +0 -1
  328. package/dest/kernel_prover/kernel_prover.js +0 -217
  329. package/dest/kernel_prover/proving_data_oracle.d.ts +0 -73
  330. package/dest/kernel_prover/proving_data_oracle.d.ts.map +0 -1
  331. package/dest/kernel_prover/proving_data_oracle.js +0 -4
  332. package/dest/note_decryption_utils/add_public_values_to_payload.d.ts +0 -11
  333. package/dest/note_decryption_utils/add_public_values_to_payload.d.ts.map +0 -1
  334. package/dest/note_decryption_utils/add_public_values_to_payload.js +0 -47
  335. package/dest/pxe_http/index.d.ts +0 -2
  336. package/dest/pxe_http/index.d.ts.map +0 -1
  337. package/dest/pxe_http/index.js +0 -1
  338. package/dest/pxe_http/pxe_http_server.d.ts +0 -16
  339. package/dest/pxe_http/pxe_http_server.d.ts.map +0 -1
  340. package/dest/pxe_http/pxe_http_server.js +0 -27
  341. package/dest/pxe_oracle_interface/index.d.ts +0 -159
  342. package/dest/pxe_oracle_interface/index.d.ts.map +0 -1
  343. package/dest/pxe_oracle_interface/index.js +0 -692
  344. package/dest/pxe_oracle_interface/tagging_utils.d.ts +0 -17
  345. package/dest/pxe_oracle_interface/tagging_utils.d.ts.map +0 -1
  346. package/dest/pxe_oracle_interface/tagging_utils.js +0 -23
  347. package/dest/pxe_service/error_enriching.d.ts +0 -11
  348. package/dest/pxe_service/error_enriching.d.ts.map +0 -1
  349. package/dest/pxe_service/index.d.ts +0 -3
  350. package/dest/pxe_service/index.d.ts.map +0 -1
  351. package/dest/pxe_service/index.js +0 -2
  352. package/dest/pxe_service/pxe_service.d.ts +0 -111
  353. package/dest/pxe_service/pxe_service.d.ts.map +0 -1
  354. package/dest/pxe_service/pxe_service.js +0 -664
  355. package/dest/storage/auth_witness_data_provider/auth_witness_data_provider.d.ts +0 -11
  356. package/dest/storage/auth_witness_data_provider/auth_witness_data_provider.d.ts.map +0 -1
  357. package/dest/storage/auth_witness_data_provider/auth_witness_data_provider.js +0 -20
  358. package/dest/storage/auth_witness_data_provider/index.d.ts +0 -2
  359. package/dest/storage/auth_witness_data_provider/index.d.ts.map +0 -1
  360. package/dest/storage/auth_witness_data_provider/index.js +0 -1
  361. package/dest/storage/data_provider.d.ts +0 -4
  362. package/dest/storage/data_provider.d.ts.map +0 -1
  363. package/dest/storage/data_provider.js +0 -1
  364. package/dest/storage/note_data_provider/note_dao.d.ts +0 -106
  365. package/dest/storage/note_data_provider/note_dao.d.ts.map +0 -1
  366. package/dest/storage/note_data_provider/note_dao.js +0 -106
  367. package/dest/storage/sync_data_provider/index.d.ts +0 -2
  368. package/dest/storage/sync_data_provider/index.d.ts.map +0 -1
  369. package/dest/storage/sync_data_provider/index.js +0 -1
  370. package/dest/storage/sync_data_provider/sync_data_provider.d.ts +0 -12
  371. package/dest/storage/sync_data_provider/sync_data_provider.d.ts.map +0 -1
  372. package/dest/storage/tagging_data_provider/tagging_data_provider.d.ts +0 -18
  373. package/dest/storage/tagging_data_provider/tagging_data_provider.d.ts.map +0 -1
  374. package/dest/storage/tagging_data_provider/tagging_data_provider.js +0 -65
  375. package/dest/synchronizer/index.d.ts +0 -2
  376. package/dest/synchronizer/index.d.ts.map +0 -1
  377. package/dest/synchronizer/index.js +0 -1
  378. package/dest/synchronizer/synchronizer.d.ts +0 -37
  379. package/dest/synchronizer/synchronizer.d.ts.map +0 -1
  380. package/dest/test/pxe_test_suite.d.ts +0 -3
  381. package/dest/test/pxe_test_suite.d.ts.map +0 -1
  382. package/dest/test/pxe_test_suite.js +0 -97
  383. package/src/bin/index.ts +0 -38
  384. package/src/entrypoints/client/pxe_creation_options.ts +0 -7
  385. package/src/kernel_prover/index.ts +0 -2
  386. package/src/kernel_prover/kernel_prover.ts +0 -351
  387. package/src/note_decryption_utils/add_public_values_to_payload.ts +0 -64
  388. package/src/pxe_http/index.ts +0 -1
  389. package/src/pxe_http/pxe_http_server.ts +0 -29
  390. package/src/pxe_oracle_interface/index.ts +0 -925
  391. package/src/pxe_oracle_interface/tagging_utils.ts +0 -32
  392. package/src/pxe_service/index.ts +0 -2
  393. package/src/pxe_service/pxe_service.ts +0 -949
  394. package/src/storage/auth_witness_data_provider/auth_witness_data_provider.ts +0 -34
  395. package/src/storage/auth_witness_data_provider/index.ts +0 -1
  396. package/src/storage/data_provider.ts +0 -3
  397. package/src/storage/note_data_provider/note_dao.ts +0 -162
  398. package/src/storage/sync_data_provider/index.ts +0 -1
  399. package/src/storage/tagging_data_provider/tagging_data_provider.ts +0 -92
  400. package/src/synchronizer/index.ts +0 -1
  401. package/src/test/pxe_test_suite.ts +0 -111
  402. /package/dest/entrypoints/{client/pxe_creation_options.js → pxe_creation_options.js} +0 -0
@@ -1 +1 @@
1
- {"version":3,"file":"note_data_provider.d.ts","sourceRoot":"","sources":["../../../src/storage/note_data_provider/note_data_provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,KAAK,EAAE,iBAAiB,EAAqC,MAAM,iBAAiB,CAAC;AAC5F,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAElE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,qBAAa,gBAAiB,YAAW,YAAY;;IAsBnD,OAAO;WAsBa,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAWlE,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAmBtD,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,KAAK,GAAE,YAAgC,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBjF,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB9C,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkD3F,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAkGvD,oBAAoB,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,mBAAmB,EAAE,KAAK,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IA6DzF,OAAO;CAGd"}
1
+ {"version":3,"file":"note_data_provider.d.ts","sourceRoot":"","sources":["../../../src/storage/note_data_provider/note_data_provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AAEzD,OAAO,KAAK,EAAE,iBAAiB,EAAqC,MAAM,iBAAiB,CAAC;AAC5F,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C;;;;;IAKI;AACJ,qBAAa,gBAAgB;;IAiB3B,OAAO,eAgBN;IAED;;;;;;;;OAQG;IACH,OAAoB,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAO9E;IAED;;;;;;;;OAQG;IACU,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAY3D;IAED;;;;;;;;;OASG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB7D;IAED;;;;;;;;;OASG;IACU,0BAA0B,CAAC,WAAW,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGtG;IAuFD;;;;;;;;;;;OAWG;IACG,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAwGtD;IAED;;;;;;;;;;OAUG;IACH,eAAe,CAAC,UAAU,EAAE,WAAW,CAAC,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CA8DjE;CACF"}
@@ -2,8 +2,13 @@ import { toBufferBE } from '@aztec/foundation/bigint-buffer';
2
2
  import { toArray } from '@aztec/foundation/iterable';
3
3
  import { AztecAddress } from '@aztec/stdlib/aztec-address';
4
4
  import { NoteStatus } from '@aztec/stdlib/note';
5
- import { NoteDao } from './note_dao.js';
6
- export class NoteDataProvider {
5
+ import { NoteDao } from '@aztec/stdlib/note';
6
+ /**
7
+ * NoteDataProvider manages the storage and retrieval of notes.
8
+ *
9
+ * Notes can be active or nullified. This class processes new notes, nullifications,
10
+ * and performs rollback handling in the case of a reorg.
11
+ **/ export class NoteDataProvider {
7
12
  #store;
8
13
  #notes;
9
14
  #nullifiedNotes;
@@ -12,15 +17,11 @@ export class NoteDataProvider {
12
17
  #nullifiedNotesToScope;
13
18
  #nullifiedNotesByContract;
14
19
  #nullifiedNotesByStorageSlot;
15
- #nullifiedNotesByTxHash;
16
- #nullifiedNotesByAddressPoint;
17
20
  #nullifiedNotesByNullifier;
18
21
  #scopes;
19
22
  #notesToScope;
20
23
  #notesByContractAndScope;
21
24
  #notesByStorageSlotAndScope;
22
- #notesByTxHashAndScope;
23
- #notesByAddressPointAndScope;
24
25
  constructor(store){
25
26
  this.#store = store;
26
27
  this.#notes = store.openMap('notes');
@@ -30,27 +31,37 @@ export class NoteDataProvider {
30
31
  this.#nullifiedNotesToScope = store.openMultiMap('nullified_notes_to_scope');
31
32
  this.#nullifiedNotesByContract = store.openMultiMap('nullified_notes_by_contract');
32
33
  this.#nullifiedNotesByStorageSlot = store.openMultiMap('nullified_notes_by_storage_slot');
33
- this.#nullifiedNotesByTxHash = store.openMultiMap('nullified_notes_by_tx_hash');
34
- this.#nullifiedNotesByAddressPoint = store.openMultiMap('nullified_notes_by_address_point');
35
34
  this.#nullifiedNotesByNullifier = store.openMap('nullified_notes_by_nullifier');
36
35
  this.#scopes = store.openMap('scopes');
37
36
  this.#notesToScope = store.openMultiMap('notes_to_scope');
38
37
  this.#notesByContractAndScope = new Map();
39
38
  this.#notesByStorageSlotAndScope = new Map();
40
- this.#notesByTxHashAndScope = new Map();
41
- this.#notesByAddressPointAndScope = new Map();
42
39
  }
43
- static async create(store) {
40
+ /**
41
+ * Creates and initializes a new NoteDataProvider instance.
42
+ *
43
+ * This factory method creates a NoteDataProvider and restores any existing
44
+ * scope-specific indexes from the database.
45
+ *
46
+ * @param store - The key-value store to use for persistence
47
+ * @returns Promise resolving to a fully initialized NoteDataProvider instance
48
+ */ static async create(store) {
44
49
  const pxeDB = new NoteDataProvider(store);
45
50
  for await (const scope of pxeDB.#scopes.keysAsync()){
46
51
  pxeDB.#notesByContractAndScope.set(scope, store.openMultiMap(`${scope}:notes_by_contract`));
47
52
  pxeDB.#notesByStorageSlotAndScope.set(scope, store.openMultiMap(`${scope}:notes_by_storage_slot`));
48
- pxeDB.#notesByTxHashAndScope.set(scope, store.openMultiMap(`${scope}:notes_by_tx_hash`));
49
- pxeDB.#notesByAddressPointAndScope.set(scope, store.openMultiMap(`${scope}:notes_by_address_point`));
50
53
  }
51
54
  return pxeDB;
52
55
  }
53
- async addScope(scope) {
56
+ /**
57
+ * Adds a new scope to the note data provider.
58
+ *
59
+ * Scopes provide privacy isolation by creating separate indexes for each user.
60
+ * Each scope gets its own set of indexes for efficient note retrieval by various criteria.
61
+ *
62
+ * @param scope - The AztecAddress representing the scope/user to add
63
+ * @returns Promise resolving to true if scope was added, false if it already existed
64
+ */ async addScope(scope) {
54
65
  const scopeString = scope.toString();
55
66
  if (await this.#scopes.hasAsync(scopeString)) {
56
67
  return false;
@@ -58,32 +69,53 @@ export class NoteDataProvider {
58
69
  await this.#scopes.set(scopeString, true);
59
70
  this.#notesByContractAndScope.set(scopeString, this.#store.openMultiMap(`${scopeString}:notes_by_contract`));
60
71
  this.#notesByStorageSlotAndScope.set(scopeString, this.#store.openMultiMap(`${scopeString}:notes_by_storage_slot`));
61
- this.#notesByTxHashAndScope.set(scopeString, this.#store.openMultiMap(`${scopeString}:notes_by_tx_hash`));
62
- this.#notesByAddressPointAndScope.set(scopeString, this.#store.openMultiMap(`${scopeString}:notes_by_address_point`));
63
72
  return true;
64
73
  }
65
- async addNotes(notes, scope = AztecAddress.ZERO) {
66
- if (!await this.#scopes.hasAsync(scope.toString())) {
67
- await this.addScope(scope);
68
- }
74
+ /**
75
+ * Adds multiple notes to the data provider under the specified scope.
76
+ *
77
+ * Notes are stored using their index from the notes hash tree as the key, which provides
78
+ * uniqueness and maintains creation order. Each note is indexed by multiple criteria
79
+ * for efficient retrieval.
80
+ *
81
+ * @param notes - Notes to store
82
+ * @param scope - The scope (user/account) under which to store the notes
83
+ */ addNotes(notes, scope) {
69
84
  return this.#store.transactionAsync(async ()=>{
85
+ if (!await this.#scopes.hasAsync(scope.toString())) {
86
+ await this.addScope(scope);
87
+ }
70
88
  for (const dao of notes){
71
- // store notes by their index in the notes hash tree
72
- // this provides the uniqueness we need to store individual notes
73
- // and should also return notes in the order that they were created.
74
- // Had we stored them by their nullifier, they would be returned in random order
75
89
  const noteIndex = toBufferBE(dao.index, 32).toString('hex');
76
90
  await this.#notes.set(noteIndex, dao.toBuffer());
77
91
  await this.#notesToScope.set(noteIndex, scope.toString());
78
92
  await this.#nullifierToNoteId.set(dao.siloedNullifier.toString(), noteIndex);
79
93
  await this.#notesByContractAndScope.get(scope.toString()).set(dao.contractAddress.toString(), noteIndex);
80
94
  await this.#notesByStorageSlotAndScope.get(scope.toString()).set(dao.storageSlot.toString(), noteIndex);
81
- await this.#notesByTxHashAndScope.get(scope.toString()).set(dao.txHash.toString(), noteIndex);
82
- await this.#notesByAddressPointAndScope.get(scope.toString()).set(dao.addressPoint.toString(), noteIndex);
83
95
  }
84
96
  });
85
97
  }
86
- removeNotesAfter(blockNumber) {
98
+ /**
99
+ * Synchronizes notes and nullifiers to a specific block number.
100
+ *
101
+ * This method ensures that the state of notes and nullifiers is consistent with the
102
+ * specified block number. It restores any notes that were nullified after the given block
103
+ * and deletes any active notes created after that block.
104
+ *
105
+ * @param blockNumber - The new chain tip after a reorg
106
+ * @param synchedBlockNumber - The block number up to which PXE managed to sync before the reorg happened.
107
+ */ async rollbackNotesAndNullifiers(blockNumber, synchedBlockNumber) {
108
+ await this.#rewindNullifiersAfterBlock(blockNumber, synchedBlockNumber);
109
+ await this.#deleteActiveNotesAfterBlock(blockNumber);
110
+ }
111
+ /**
112
+ * Deletes (removes) all active notes created after the specified block number.
113
+ *
114
+ * Permanently delete notes from the active notes store, e.g. during a reorg.
115
+ * Note: This only affects #notes (active notes), not #nullifiedNotes.
116
+ *
117
+ * @param blockNumber - Notes created after this block number will be deleted
118
+ */ #deleteActiveNotesAfterBlock(blockNumber) {
87
119
  return this.#store.transactionAsync(async ()=>{
88
120
  const notes = await toArray(this.#notes.valuesAsync());
89
121
  for (const note of notes){
@@ -95,8 +127,6 @@ export class NoteDataProvider {
95
127
  await this.#nullifierToNoteId.delete(noteDao.siloedNullifier.toString());
96
128
  const scopes = await toArray(this.#scopes.keysAsync());
97
129
  for (const scope of scopes){
98
- await this.#notesByAddressPointAndScope.get(scope).deleteValue(noteDao.addressPoint.toString(), noteIndex);
99
- await this.#notesByTxHashAndScope.get(scope).deleteValue(noteDao.txHash.toString(), noteIndex);
100
130
  await this.#notesByContractAndScope.get(scope).deleteValue(noteDao.contractAddress.toString(), noteIndex);
101
131
  await this.#notesByStorageSlotAndScope.get(scope).deleteValue(noteDao.storageSlot.toString(), noteIndex);
102
132
  }
@@ -104,33 +134,39 @@ export class NoteDataProvider {
104
134
  }
105
135
  });
106
136
  }
107
- async unnullifyNotesAfter(blockNumber, synchedBlockNumber) {
108
- const nullifiersToUndo = [];
109
- const currentBlockNumber = blockNumber + 1;
110
- const maxBlockNumber = synchedBlockNumber ?? currentBlockNumber;
111
- for(let i = currentBlockNumber; i <= maxBlockNumber; i++){
112
- nullifiersToUndo.push(...await toArray(this.#nullifiersByBlockNumber.getValuesAsync(i)));
113
- }
114
- const notesIndexesToReinsert = await Promise.all(nullifiersToUndo.map((nullifier)=>this.#nullifiedNotesByNullifier.getAsync(nullifier)));
115
- const notNullNoteIndexes = notesIndexesToReinsert.filter((noteIndex)=>noteIndex != undefined);
116
- const nullifiedNoteBuffers = await Promise.all(notNullNoteIndexes.map((noteIndex)=>this.#nullifiedNotes.getAsync(noteIndex)));
117
- const noteDaos = nullifiedNoteBuffers.filter((buffer)=>buffer != undefined).map((buffer)=>NoteDao.fromBuffer(buffer));
137
+ /**
138
+ * Rewinds nullifications after a given block number.
139
+ *
140
+ * This operation "unnullifies" notes, rolling back nullifications that occurred
141
+ * in orphaned blocks, e.g. during a reorg. The notes are restored to the
142
+ * active notes store and removed from the nullified store.
143
+ *
144
+ * @param blockNumber - Revert nullifications that occurred after this block
145
+ * @param synchedBlockNumber - Upper bound for the block range to process
146
+ */ async #rewindNullifiersAfterBlock(blockNumber, synchedBlockNumber) {
118
147
  await this.#store.transactionAsync(async ()=>{
148
+ const nullifiersToUndo = [];
149
+ const currentBlockNumber = blockNumber + 1;
150
+ for(let i = currentBlockNumber; i <= synchedBlockNumber; i++){
151
+ nullifiersToUndo.push(...await toArray(this.#nullifiersByBlockNumber.getValuesAsync(i)));
152
+ }
153
+ const notesIndexesToReinsert = await Promise.all(nullifiersToUndo.map((nullifier)=>this.#nullifiedNotesByNullifier.getAsync(nullifier)));
154
+ const notNullNoteIndexes = notesIndexesToReinsert.filter((noteIndex)=>noteIndex != undefined);
155
+ const nullifiedNoteBuffers = await Promise.all(notNullNoteIndexes.map((noteIndex)=>this.#nullifiedNotes.getAsync(noteIndex)));
156
+ const noteDaos = nullifiedNoteBuffers.filter((buffer)=>buffer != undefined).map((buffer)=>NoteDao.fromBuffer(buffer));
119
157
  for (const dao of noteDaos){
120
158
  const noteIndex = toBufferBE(dao.index, 32).toString('hex');
121
159
  await this.#notes.set(noteIndex, dao.toBuffer());
122
160
  await this.#nullifierToNoteId.set(dao.siloedNullifier.toString(), noteIndex);
123
- let scopes = await toArray(this.#nullifiedNotesToScope.getValuesAsync(noteIndex)) ?? [];
161
+ const scopes = await toArray(this.#nullifiedNotesToScope.getValuesAsync(noteIndex));
124
162
  if (scopes.length === 0) {
125
- scopes = [
126
- new AztecAddress(dao.addressPoint.x).toString()
127
- ];
163
+ // We should never run into this error because notes always have a scope assigned to them - either on initial
164
+ // insertion via `addNotes` or when removing their nullifiers.
165
+ throw new Error(`No scopes found for nullified note with index ${noteIndex}`);
128
166
  }
129
167
  for (const scope of scopes){
130
168
  await this.#notesByContractAndScope.get(scope.toString()).set(dao.contractAddress.toString(), noteIndex);
131
169
  await this.#notesByStorageSlotAndScope.get(scope.toString()).set(dao.storageSlot.toString(), noteIndex);
132
- await this.#notesByTxHashAndScope.get(scope.toString()).set(dao.txHash.toString(), noteIndex);
133
- await this.#notesByAddressPointAndScope.get(scope.toString()).set(dao.addressPoint.toString(), noteIndex);
134
170
  await this.#notesToScope.set(noteIndex, scope);
135
171
  }
136
172
  await this.#nullifiedNotes.delete(noteIndex);
@@ -138,34 +174,58 @@ export class NoteDataProvider {
138
174
  await this.#nullifiersByBlockNumber.deleteValue(dao.l2BlockNumber, dao.siloedNullifier.toString());
139
175
  await this.#nullifiedNotesByContract.deleteValue(dao.contractAddress.toString(), noteIndex);
140
176
  await this.#nullifiedNotesByStorageSlot.deleteValue(dao.storageSlot.toString(), noteIndex);
141
- await this.#nullifiedNotesByTxHash.deleteValue(dao.txHash.toString(), noteIndex);
142
- await this.#nullifiedNotesByAddressPoint.deleteValue(dao.addressPoint.toString(), noteIndex);
143
177
  await this.#nullifiedNotesByNullifier.delete(dao.siloedNullifier.toString());
144
178
  }
145
179
  });
146
180
  }
147
- async getNotes(filter) {
148
- const publicKey = filter.owner ? await filter.owner.toAddressPoint() : undefined;
181
+ /**
182
+ * Retrieves notes based on the provided filter criteria.
183
+ *
184
+ * This method queries both active and optionally nullified notes based on the filter
185
+ * parameters.
186
+ *
187
+ * @param filter - Filter criteria including contractAddress (required), and optional
188
+ * owner, storageSlot, status, scopes, and siloedNullifier.
189
+ * @returns Filtered and deduplicated notes (a note might be present in multiple scopes - we ensure it is only
190
+ * returned once if this is the case)
191
+ * @throws If filtering by an empty scopes array. Scopes have to be set to undefined or to a non-empty array.
192
+ */ async getNotes(filter) {
149
193
  filter.status = filter.status ?? NoteStatus.ACTIVE;
194
+ // throw early if scopes is an empty array
195
+ if (filter.scopes !== undefined && filter.scopes.length === 0) {
196
+ throw new Error('Trying to get notes with an empty scopes array. Scopes have to be set to undefined if intending on not filtering by scopes.');
197
+ }
150
198
  const candidateNoteSources = [];
151
199
  filter.scopes ??= (await toArray(this.#scopes.keysAsync())).map((addressString)=>AztecAddress.fromString(addressString));
152
200
  const activeNoteIdsPerScope = [];
153
201
  for (const scope of new Set(filter.scopes)){
154
202
  const formattedScopeString = scope.toString();
155
203
  if (!await this.#scopes.hasAsync(formattedScopeString)) {
156
- throw new Error('Trying to get incoming notes of an scope that is not in the PXE database');
204
+ throw new Error('Trying to get incoming notes of a scope that is not in the PXE database');
157
205
  }
158
- activeNoteIdsPerScope.push(publicKey ? await toArray(this.#notesByAddressPointAndScope.get(formattedScopeString).getValuesAsync(publicKey.toString())) : filter.txHash ? await toArray(this.#notesByTxHashAndScope.get(formattedScopeString).getValuesAsync(filter.txHash.toString())) : filter.contractAddress ? await toArray(this.#notesByContractAndScope.get(formattedScopeString).getValuesAsync(filter.contractAddress.toString())) : filter.storageSlot ? await toArray(this.#notesByStorageSlotAndScope.get(formattedScopeString).getValuesAsync(filter.storageSlot.toString())) : await toArray(this.#notesByAddressPointAndScope.get(formattedScopeString).valuesAsync()));
206
+ activeNoteIdsPerScope.push(filter.storageSlot ? await toArray(this.#notesByStorageSlotAndScope.get(formattedScopeString).getValuesAsync(filter.storageSlot.toString())) : await toArray(this.#notesByContractAndScope.get(formattedScopeString).getValuesAsync(filter.contractAddress.toString())));
159
207
  }
160
208
  candidateNoteSources.push({
161
209
  ids: new Set(activeNoteIdsPerScope.flat()),
162
210
  notes: this.#notes
163
211
  });
164
- if (filter.status == NoteStatus.ACTIVE_OR_NULLIFIED) {
165
- candidateNoteSources.push({
166
- ids: publicKey ? await toArray(this.#nullifiedNotesByAddressPoint.getValuesAsync(publicKey.toString())) : filter.txHash ? await toArray(this.#nullifiedNotesByTxHash.getValuesAsync(filter.txHash.toString())) : filter.contractAddress ? await toArray(this.#nullifiedNotesByContract.getValuesAsync(filter.contractAddress.toString())) : filter.storageSlot ? await toArray(this.#nullifiedNotesByStorageSlot.getValuesAsync(filter.storageSlot.toString())) : await toArray(this.#nullifiedNotes.keysAsync()),
167
- notes: this.#nullifiedNotes
168
- });
212
+ // If status is ACTIVE_OR_NULLIFIED we add nullified notes as candidates on top of the default active ones.
213
+ if (filter.status === NoteStatus.ACTIVE_OR_NULLIFIED) {
214
+ const nullifiedIds = filter.storageSlot ? await toArray(this.#nullifiedNotesByStorageSlot.getValuesAsync(filter.storageSlot.toString())) : await toArray(this.#nullifiedNotesByContract.getValuesAsync(filter.contractAddress.toString()));
215
+ const setOfScopes = new Set(filter.scopes.map((s)=>s.toString()));
216
+ const filteredNullifiedIds = new Set();
217
+ for (const noteId of nullifiedIds){
218
+ const scopeList = await toArray(this.#nullifiedNotesToScope.getValuesAsync(noteId));
219
+ if (scopeList.some((scope)=>setOfScopes.has(scope))) {
220
+ filteredNullifiedIds.add(noteId);
221
+ }
222
+ }
223
+ if (filteredNullifiedIds.size > 0) {
224
+ candidateNoteSources.push({
225
+ ids: filteredNullifiedIds,
226
+ notes: this.#nullifiedNotes
227
+ });
228
+ }
169
229
  }
170
230
  const result = [];
171
231
  for (const { ids, notes } of candidateNoteSources){
@@ -175,27 +235,41 @@ export class NoteDataProvider {
175
235
  continue;
176
236
  }
177
237
  const note = NoteDao.fromBuffer(serializedNote);
178
- if (filter.contractAddress && !note.contractAddress.equals(filter.contractAddress)) {
238
+ if (!note.contractAddress.equals(filter.contractAddress)) {
179
239
  continue;
180
240
  }
181
- if (filter.txHash && !note.txHash.equals(filter.txHash)) {
241
+ if (filter.owner && !note.owner.equals(filter.owner)) {
182
242
  continue;
183
243
  }
184
244
  if (filter.storageSlot && !note.storageSlot.equals(filter.storageSlot)) {
185
245
  continue;
186
246
  }
187
- if (publicKey && !note.addressPoint.equals(publicKey)) {
188
- continue;
189
- }
190
247
  if (filter.siloedNullifier && !note.siloedNullifier.equals(filter.siloedNullifier)) {
191
248
  continue;
192
249
  }
193
250
  result.push(note);
194
251
  }
195
252
  }
196
- return result;
253
+ // A note might be present in multiple scopes - we ensure it is only returned once
254
+ const deduplicated = [];
255
+ for (const note of result){
256
+ if (!deduplicated.some((existing)=>existing.equals(note))) {
257
+ deduplicated.push(note);
258
+ }
259
+ }
260
+ return deduplicated;
197
261
  }
198
- removeNullifiedNotes(nullifiers, accountAddressPoint) {
262
+ /**
263
+ * Transitions notes from "active" to "nullified" state.
264
+ *
265
+ * This operation processes a batch of nullifiers to mark the corresponding notes
266
+ * as spent/nullified. The operation is atomic - if any nullifier is not found,
267
+ * the entire operation fails and no notes are modified.
268
+ *
269
+ * @param nullifiers - Array of nullifiers with their block numbers to process
270
+ * @returns Promise resolving to array of nullified NoteDao objects
271
+ * @throws Error if any nullifier is not found in the active notes
272
+ */ applyNullifiers(nullifiers) {
199
273
  if (nullifiers.length === 0) {
200
274
  return Promise.resolve([]);
201
275
  }
@@ -203,47 +277,46 @@ export class NoteDataProvider {
203
277
  const nullifiedNotes = [];
204
278
  for (const blockScopedNullifier of nullifiers){
205
279
  const { data: nullifier, l2BlockNumber: blockNumber } = blockScopedNullifier;
206
- const noteIndex = await this.#nullifierToNoteId.getAsync(nullifier.toString());
280
+ const nullifierKey = nullifier.toString();
281
+ const noteIndex = await this.#nullifierToNoteId.getAsync(nullifierKey);
207
282
  if (!noteIndex) {
208
- continue;
283
+ // Check if already nullified?
284
+ const alreadyNullified = await this.#nullifiedNotesByNullifier.getAsync(nullifierKey);
285
+ if (alreadyNullified) {
286
+ throw new Error(`Nullifier already applied in applyNullifiers`);
287
+ }
288
+ throw new Error('Nullifier not found in applyNullifiers');
209
289
  }
210
290
  const noteBuffer = noteIndex ? await this.#notes.getAsync(noteIndex) : undefined;
211
291
  if (!noteBuffer) {
212
- continue;
292
+ throw new Error('Note not found in applyNullifiers');
213
293
  }
214
- const noteScopes = await toArray(this.#notesToScope.getValuesAsync(noteIndex)) ?? [];
215
- const note = NoteDao.fromBuffer(noteBuffer);
216
- if (!note.addressPoint.equals(accountAddressPoint)) {
217
- continue;
294
+ const noteScopes = await toArray(this.#notesToScope.getValuesAsync(noteIndex));
295
+ if (noteScopes.length === 0) {
296
+ // We should never run into this error because notes always have a scope assigned to them - either on initial
297
+ // insertion via `addNotes` or when removing their nullifiers.
298
+ throw new Error('Note scopes are missing in applyNullifiers');
218
299
  }
300
+ const note = NoteDao.fromBuffer(noteBuffer);
219
301
  nullifiedNotes.push(note);
220
302
  await this.#notes.delete(noteIndex);
221
303
  await this.#notesToScope.delete(noteIndex);
222
304
  const scopes = await toArray(this.#scopes.keysAsync());
223
305
  for (const scope of scopes){
224
- await this.#notesByAddressPointAndScope.get(scope).deleteValue(accountAddressPoint.toString(), noteIndex);
225
- await this.#notesByTxHashAndScope.get(scope).deleteValue(note.txHash.toString(), noteIndex);
226
306
  await this.#notesByContractAndScope.get(scope).deleteValue(note.contractAddress.toString(), noteIndex);
227
307
  await this.#notesByStorageSlotAndScope.get(scope).deleteValue(note.storageSlot.toString(), noteIndex);
228
308
  }
229
- if (noteScopes !== undefined) {
230
- for (const scope of noteScopes){
231
- await this.#nullifiedNotesToScope.set(noteIndex, scope);
232
- }
309
+ for (const scope of noteScopes){
310
+ await this.#nullifiedNotesToScope.set(noteIndex, scope);
233
311
  }
234
312
  await this.#nullifiedNotes.set(noteIndex, note.toBuffer());
235
313
  await this.#nullifiersByBlockNumber.set(blockNumber, nullifier.toString());
236
314
  await this.#nullifiedNotesByContract.set(note.contractAddress.toString(), noteIndex);
237
315
  await this.#nullifiedNotesByStorageSlot.set(note.storageSlot.toString(), noteIndex);
238
- await this.#nullifiedNotesByTxHash.set(note.txHash.toString(), noteIndex);
239
- await this.#nullifiedNotesByAddressPoint.set(note.addressPoint.toString(), noteIndex);
240
316
  await this.#nullifiedNotesByNullifier.set(nullifier.toString(), noteIndex);
241
317
  await this.#nullifierToNoteId.delete(nullifier.toString());
242
318
  }
243
319
  return nullifiedNotes;
244
320
  });
245
321
  }
246
- async getSize() {
247
- return (await this.getNotes({})).reduce((sum, note)=>sum + note.getSize(), 0);
248
- }
249
322
  }
@@ -0,0 +1,51 @@
1
+ import { Fr } from '@aztec/foundation/curves/bn254';
2
+ import type { AztecAsyncKVStore } from '@aztec/kv-store';
3
+ import type { EventSelector } from '@aztec/stdlib/abi';
4
+ import type { AztecAddress } from '@aztec/stdlib/aztec-address';
5
+ import { type InTx, TxHash } from '@aztec/stdlib/tx';
6
+ import type { PackedPrivateEvent } from '../../pxe.js';
7
+ export type PrivateEventDataProviderFilter = {
8
+ contractAddress: AztecAddress;
9
+ fromBlock: number;
10
+ toBlock: number;
11
+ scopes: AztecAddress[];
12
+ txHash?: TxHash;
13
+ };
14
+ type PrivateEventMetadata = InTx & {
15
+ contractAddress: AztecAddress;
16
+ scope: AztecAddress;
17
+ };
18
+ /**
19
+ * Stores decrypted private event logs.
20
+ */
21
+ export declare class PrivateEventDataProvider {
22
+ #private;
23
+ logger: import("@aztec/foundation/log").Logger;
24
+ constructor(store: AztecAsyncKVStore);
25
+ /**
26
+ * Store a private event log.
27
+ * @param eventSelector - The event selector of the event.
28
+ * @param msgContent - The content of the event.
29
+ * @param eventCommitmentIndex - The index of the event commitment in the nullifier tree.
30
+ * @param metadata
31
+ * contractAddress - The address of the contract that emitted the event.
32
+ * scope - The address to which the event is scoped.
33
+ * txHash - The transaction hash of the event log.
34
+ * blockNumber - The block number in which the event was emitted.
35
+ */
36
+ storePrivateEventLog(eventSelector: EventSelector, msgContent: Fr[], eventCommitmentIndex: number, metadata: PrivateEventMetadata): Promise<void>;
37
+ /**
38
+ * Returns the private events given search parameters.
39
+ * @param eventSelector - The event selector to filter by.
40
+ * @param filter - Filtering criteria:
41
+ * contractAddress: The address of the contract to get events from.
42
+ * fromBlock: The block number to search from (inclusive).
43
+ * toBlock: The block number to search upto (exclusive).
44
+ * scope: - The addresses that decrypted the logs.
45
+ * @returns - The event log contents, augmented with metadata about
46
+ * the transaction and block it the event was included in .
47
+ */
48
+ getPrivateEvents(eventSelector: EventSelector, filter: PrivateEventDataProviderFilter): Promise<PackedPrivateEvent[]>;
49
+ }
50
+ export {};
51
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJpdmF0ZV9ldmVudF9kYXRhX3Byb3ZpZGVyLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvc3RvcmFnZS9wcml2YXRlX2V2ZW50X2RhdGFfcHJvdmlkZXIvcHJpdmF0ZV9ldmVudF9kYXRhX3Byb3ZpZGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUNBLE9BQU8sRUFBRSxFQUFFLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUdwRCxPQUFPLEtBQUssRUFBbUIsaUJBQWlCLEVBQWlCLE1BQU0saUJBQWlCLENBQUM7QUFDekYsT0FBTyxLQUFLLEVBQUUsYUFBYSxFQUFFLE1BQU0sbUJBQW1CLENBQUM7QUFDdkQsT0FBTyxLQUFLLEVBQUUsWUFBWSxFQUFFLE1BQU0sNkJBQTZCLENBQUM7QUFFaEUsT0FBTyxFQUFFLEtBQUssSUFBSSxFQUFFLE1BQU0sRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBRXJELE9BQU8sS0FBSyxFQUFFLGtCQUFrQixFQUFFLE1BQU0sY0FBYyxDQUFDO0FBRXZELE1BQU0sTUFBTSw4QkFBOEIsR0FBRztJQUMzQyxlQUFlLEVBQUUsWUFBWSxDQUFDO0lBQzlCLFNBQVMsRUFBRSxNQUFNLENBQUM7SUFDbEIsT0FBTyxFQUFFLE1BQU0sQ0FBQztJQUNoQixNQUFNLEVBQUUsWUFBWSxFQUFFLENBQUM7SUFDdkIsTUFBTSxDQUFDLEVBQUUsTUFBTSxDQUFDO0NBQ2pCLENBQUM7QUFVRixLQUFLLG9CQUFvQixHQUFHLElBQUksR0FBRztJQUNqQyxlQUFlLEVBQUUsWUFBWSxDQUFDO0lBQzlCLEtBQUssRUFBRSxZQUFZLENBQUM7Q0FDckIsQ0FBQztBQUVGOztHQUVHO0FBQ0gscUJBQWEsd0JBQXdCOztJQVNuQyxNQUFNLHlDQUErQztJQUVyRCxZQUFZLEtBQUssRUFBRSxpQkFBaUIsRUFLbkM7SUFNRDs7Ozs7Ozs7OztPQVVHO0lBQ0gsb0JBQW9CLENBQ2xCLGFBQWEsRUFBRSxhQUFhLEVBQzVCLFVBQVUsRUFBRSxFQUFFLEVBQUUsRUFDaEIsb0JBQW9CLEVBQUUsTUFBTSxFQUM1QixRQUFRLEVBQUUsb0JBQW9CLEdBQzdCLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0E4QmY7SUFFRDs7Ozs7Ozs7OztPQVVHO0lBQ1UsZ0JBQWdCLENBQzNCLGFBQWEsRUFBRSxhQUFhLEVBQzVCLE1BQU0sRUFBRSw4QkFBOEIsR0FDckMsT0FBTyxDQUFDLGtCQUFrQixFQUFFLENBQUMsQ0F3Qy9CO0NBQ0YifQ==
@@ -0,0 +1 @@
1
+ {"version":3,"file":"private_event_data_provider.d.ts","sourceRoot":"","sources":["../../../src/storage/private_event_data_provider/private_event_data_provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AAGpD,OAAO,KAAK,EAAmB,iBAAiB,EAAiB,MAAM,iBAAiB,CAAC;AACzF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEhE,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,MAAM,MAAM,8BAA8B,GAAG;IAC3C,eAAe,EAAE,YAAY,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAUF,KAAK,oBAAoB,GAAG,IAAI,GAAG;IACjC,eAAe,EAAE,YAAY,CAAC;IAC9B,KAAK,EAAE,YAAY,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,qBAAa,wBAAwB;;IASnC,MAAM,yCAA+C;IAErD,YAAY,KAAK,EAAE,iBAAiB,EAKnC;IAMD;;;;;;;;;;OAUG;IACH,oBAAoB,CAClB,aAAa,EAAE,aAAa,EAC5B,UAAU,EAAE,EAAE,EAAE,EAChB,oBAAoB,EAAE,MAAM,EAC5B,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,IAAI,CAAC,CA8Bf;IAED;;;;;;;;;;OAUG;IACU,gBAAgB,CAC3B,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,8BAA8B,GACrC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAwC/B;CACF"}
@@ -0,0 +1,115 @@
1
+ import { BlockNumber } from '@aztec/foundation/branded-types';
2
+ import { Fr } from '@aztec/foundation/curves/bn254';
3
+ import { createLogger } from '@aztec/foundation/log';
4
+ import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize';
5
+ import { L2BlockHash } from '@aztec/stdlib/block';
6
+ import { TxHash } from '@aztec/stdlib/tx';
7
+ /**
8
+ * Stores decrypted private event logs.
9
+ */ export class PrivateEventDataProvider {
10
+ #store;
11
+ /** Array storing the actual private event log entries containing the log content and block number */ #eventLogs;
12
+ /** Map from contract_address_scope_eventSelector to array of indices into #eventLogs for efficient lookup */ #eventLogIndex;
13
+ /** Map from eventCommitmentIndex to boolean indicating if log has been seen. */ #seenLogs;
14
+ logger = createLogger('private_event_data_provider');
15
+ constructor(store){
16
+ this.#store = store;
17
+ this.#eventLogs = this.#store.openArray('private_event_logs');
18
+ this.#eventLogIndex = this.#store.openMap('private_event_log_index');
19
+ this.#seenLogs = this.#store.openMap('seen_logs');
20
+ }
21
+ #keyFor(contractAddress, scope, eventSelector) {
22
+ return `${contractAddress.toString()}_${scope.toString()}_${eventSelector.toString()}`;
23
+ }
24
+ /**
25
+ * Store a private event log.
26
+ * @param eventSelector - The event selector of the event.
27
+ * @param msgContent - The content of the event.
28
+ * @param eventCommitmentIndex - The index of the event commitment in the nullifier tree.
29
+ * @param metadata
30
+ * contractAddress - The address of the contract that emitted the event.
31
+ * scope - The address to which the event is scoped.
32
+ * txHash - The transaction hash of the event log.
33
+ * blockNumber - The block number in which the event was emitted.
34
+ */ storePrivateEventLog(eventSelector, msgContent, eventCommitmentIndex, metadata) {
35
+ const { contractAddress, scope, txHash, l2BlockNumber, l2BlockHash } = metadata;
36
+ return this.#store.transactionAsync(async ()=>{
37
+ const key = this.#keyFor(contractAddress, scope, eventSelector);
38
+ // Check if this exact log has already been stored using eventCommitmentIndex as unique identifier
39
+ const hasBeenSeen = await this.#seenLogs.getAsync(eventCommitmentIndex);
40
+ if (hasBeenSeen) {
41
+ this.logger.verbose('Ignoring duplicate event log', {
42
+ txHash: txHash.toString(),
43
+ eventCommitmentIndex
44
+ });
45
+ return;
46
+ }
47
+ this.logger.verbose('storing private event log', {
48
+ contractAddress,
49
+ scope,
50
+ msgContent,
51
+ l2BlockNumber
52
+ });
53
+ const index = await this.#eventLogs.lengthAsync();
54
+ await this.#eventLogs.push({
55
+ msgContent: serializeToBuffer(msgContent),
56
+ l2BlockNumber,
57
+ l2BlockHash: l2BlockHash.toBuffer(),
58
+ eventCommitmentIndex,
59
+ txHash: txHash.toBuffer()
60
+ });
61
+ const existingIndices = await this.#eventLogIndex.getAsync(key) || [];
62
+ await this.#eventLogIndex.set(key, [
63
+ ...existingIndices,
64
+ index
65
+ ]);
66
+ // Mark this log as seen using eventCommitmentIndex
67
+ await this.#seenLogs.set(eventCommitmentIndex, true);
68
+ });
69
+ }
70
+ /**
71
+ * Returns the private events given search parameters.
72
+ * @param eventSelector - The event selector to filter by.
73
+ * @param filter - Filtering criteria:
74
+ * contractAddress: The address of the contract to get events from.
75
+ * fromBlock: The block number to search from (inclusive).
76
+ * toBlock: The block number to search upto (exclusive).
77
+ * scope: - The addresses that decrypted the logs.
78
+ * @returns - The event log contents, augmented with metadata about
79
+ * the transaction and block it the event was included in .
80
+ */ async getPrivateEvents(eventSelector, filter) {
81
+ const events = [];
82
+ for (const scope of filter.scopes){
83
+ const key = this.#keyFor(filter.contractAddress, scope, eventSelector);
84
+ const indices = await this.#eventLogIndex.getAsync(key) || [];
85
+ for (const index of indices){
86
+ const entry = await this.#eventLogs.atAsync(index);
87
+ if (!entry || entry.l2BlockNumber < filter.fromBlock || entry.l2BlockNumber >= filter.toBlock) {
88
+ continue;
89
+ }
90
+ // Convert buffer back to Fr array
91
+ const reader = BufferReader.asReader(entry.msgContent);
92
+ const numFields = entry.msgContent.length / Fr.SIZE_IN_BYTES;
93
+ const msgContent = reader.readArray(numFields, Fr);
94
+ const txHash = TxHash.fromBuffer(entry.txHash);
95
+ const l2BlockHash = L2BlockHash.fromBuffer(entry.l2BlockHash);
96
+ if (filter.txHash && !txHash.equals(filter.txHash)) {
97
+ continue;
98
+ }
99
+ events.push({
100
+ eventCommitmentIndex: entry.eventCommitmentIndex,
101
+ event: {
102
+ packedEvent: msgContent,
103
+ l2BlockNumber: BlockNumber(entry.l2BlockNumber),
104
+ txHash,
105
+ l2BlockHash,
106
+ eventSelector
107
+ }
108
+ });
109
+ }
110
+ }
111
+ // Sort by eventCommitmentIndex only
112
+ events.sort((a, b)=>a.eventCommitmentIndex - b.eventCommitmentIndex);
113
+ return events.map((ev)=>ev.event);
114
+ }
115
+ }
@@ -1,2 +1,3 @@
1
- export { TaggingDataProvider } from './tagging_data_provider.js';
2
- //# sourceMappingURL=index.d.ts.map
1
+ export { SenderTaggingDataProvider } from './sender_tagging_data_provider.js';
2
+ export { RecipientTaggingDataProvider } from './recipient_tagging_data_provider.js';
3
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9zdG9yYWdlL3RhZ2dpbmdfZGF0YV9wcm92aWRlci9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUseUJBQXlCLEVBQUUsTUFBTSxtQ0FBbUMsQ0FBQztBQUM5RSxPQUFPLEVBQUUsNEJBQTRCLEVBQUUsTUFBTSxzQ0FBc0MsQ0FBQyJ9
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/tagging_data_provider/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/tagging_data_provider/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAC"}
@@ -1 +1,2 @@
1
- export { TaggingDataProvider } from './tagging_data_provider.js';
1
+ export { SenderTaggingDataProvider } from './sender_tagging_data_provider.js';
2
+ export { RecipientTaggingDataProvider } from './recipient_tagging_data_provider.js';
@@ -0,0 +1,31 @@
1
+ import type { AztecAsyncKVStore } from '@aztec/kv-store';
2
+ import { AztecAddress } from '@aztec/stdlib/aztec-address';
3
+ import type { DirectionalAppTaggingSecret, PreTag } from '@aztec/stdlib/logs';
4
+ /**
5
+ * Data provider of tagging data used when syncing the logs as a recipient. The sender counterpart of this class is
6
+ * called SenderTaggingDataProvider. We have the providers separate for the sender and recipient because
7
+ * the algorithms are completely disjoint and there is not data reuse between the 2.
8
+ */
9
+ export declare class RecipientTaggingDataProvider {
10
+ #private;
11
+ constructor(store: AztecAsyncKVStore);
12
+ /**
13
+ * Sets the last used indexes when looking for logs.
14
+ * @param preTags - The pre-tags containing the directional app tagging secrets and the indexes that are to be
15
+ * updated in the db.
16
+ * @throws If any two pre-tags contain the same directional app tagging secret
17
+ */
18
+ setLastUsedIndexes(preTags: PreTag[]): Promise<void[]>;
19
+ /**
20
+ * Returns the last used indexes when looking for logs.
21
+ * @param secrets - The directional app tagging secrets to obtain the indexes for.
22
+ * @returns The last used indexes for the given directional app tagging secrets, or undefined if have never yet found
23
+ * a log for a given secret.
24
+ */
25
+ getLastUsedIndexes(secrets: DirectionalAppTaggingSecret[]): Promise<(number | undefined)[]>;
26
+ resetNoteSyncData(): Promise<void>;
27
+ addSenderAddress(address: AztecAddress): Promise<boolean>;
28
+ getSenderAddresses(): Promise<AztecAddress[]>;
29
+ removeSenderAddress(address: AztecAddress): Promise<boolean>;
30
+ }
31
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVjaXBpZW50X3RhZ2dpbmdfZGF0YV9wcm92aWRlci5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL3N0b3JhZ2UvdGFnZ2luZ19kYXRhX3Byb3ZpZGVyL3JlY2lwaWVudF90YWdnaW5nX2RhdGFfcHJvdmlkZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxLQUFLLEVBQUUsaUJBQWlCLEVBQWlCLE1BQU0saUJBQWlCLENBQUM7QUFDeEUsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLDZCQUE2QixDQUFDO0FBQzNELE9BQU8sS0FBSyxFQUFFLDJCQUEyQixFQUFFLE1BQU0sRUFBRSxNQUFNLG9CQUFvQixDQUFDO0FBRTlFOzs7O0dBSUc7QUFDSCxxQkFBYSw0QkFBNEI7O0lBT3ZDLFlBQVksS0FBSyxFQUFFLGlCQUFpQixFQUtuQztJQUVEOzs7OztPQUtHO0lBQ0gsa0JBQWtCLENBQUMsT0FBTyxFQUFFLE1BQU0sRUFBRSxtQkFRbkM7SUFFRDs7Ozs7T0FLRztJQUNILGtCQUFrQixDQUFDLE9BQU8sRUFBRSwyQkFBMkIsRUFBRSxHQUFHLE9BQU8sQ0FBQyxDQUFDLE1BQU0sR0FBRyxTQUFTLENBQUMsRUFBRSxDQUFDLENBRTFGO0lBRUQsaUJBQWlCLElBQUksT0FBTyxDQUFDLElBQUksQ0FBQyxDQUtqQztJQU9LLGdCQUFnQixDQUFDLE9BQU8sRUFBRSxZQUFZLEdBQUcsT0FBTyxDQUFDLE9BQU8sQ0FBQyxDQVE5RDtJQUVLLGtCQUFrQixJQUFJLE9BQU8sQ0FBQyxZQUFZLEVBQUUsQ0FBQyxDQUVsRDtJQUVLLG1CQUFtQixDQUFDLE9BQU8sRUFBRSxZQUFZLEdBQUcsT0FBTyxDQUFDLE9BQU8sQ0FBQyxDQVFqRTtDQUNGIn0=
@@ -0,0 +1 @@
1
+ {"version":3,"file":"recipient_tagging_data_provider.d.ts","sourceRoot":"","sources":["../../../src/storage/tagging_data_provider/recipient_tagging_data_provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE9E;;;;GAIG;AACH,qBAAa,4BAA4B;;IAOvC,YAAY,KAAK,EAAE,iBAAiB,EAKnC;IAED;;;;;OAKG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,mBAQnC;IAED;;;;;OAKG;IACH,kBAAkB,CAAC,OAAO,EAAE,2BAA2B,EAAE,GAAG,OAAO,CAAC,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC,CAE1F;IAED,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAKjC;IAOK,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ9D;IAEK,kBAAkB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAElD;IAEK,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAQjE;CACF"}