@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
@@ -0,0 +1,65 @@
1
+ import { toArray } from '@aztec/foundation/iterable';
2
+ import { AztecAddress } from '@aztec/stdlib/aztec-address';
3
+ /**
4
+ * Data provider of tagging data used when syncing the logs as a recipient. The sender counterpart of this class is
5
+ * called SenderTaggingDataProvider. We have the providers separate for the sender and recipient because
6
+ * the algorithms are completely disjoint and there is not data reuse between the 2.
7
+ */ export class RecipientTaggingDataProvider {
8
+ #store;
9
+ #addressBook;
10
+ // Stores the last used index for each directional app tagging secret.
11
+ #lastUsedIndexes;
12
+ constructor(store){
13
+ this.#store = store;
14
+ this.#addressBook = this.#store.openMap('address_book');
15
+ this.#lastUsedIndexes = this.#store.openMap('last_used_indexes');
16
+ }
17
+ /**
18
+ * Sets the last used indexes when looking for logs.
19
+ * @param preTags - The pre-tags containing the directional app tagging secrets and the indexes that are to be
20
+ * updated in the db.
21
+ * @throws If any two pre-tags contain the same directional app tagging secret
22
+ */ setLastUsedIndexes(preTags) {
23
+ // Non-unique secrets would indicate a bug in the caller function.
24
+ const secretsSet = new Set(preTags.map((preTag)=>preTag.secret.toString()));
25
+ if (secretsSet.size !== preTags.length) {
26
+ throw new Error(`Duplicate secrets found when setting last used indexes`);
27
+ }
28
+ return Promise.all(preTags.map(({ secret, index })=>this.#lastUsedIndexes.set(secret.toString(), index)));
29
+ }
30
+ /**
31
+ * Returns the last used indexes when looking for logs.
32
+ * @param secrets - The directional app tagging secrets to obtain the indexes for.
33
+ * @returns The last used indexes for the given directional app tagging secrets, or undefined if have never yet found
34
+ * a log for a given secret.
35
+ */ getLastUsedIndexes(secrets) {
36
+ return Promise.all(secrets.map((secret)=>this.#lastUsedIndexes.getAsync(secret.toString())));
37
+ }
38
+ resetNoteSyncData() {
39
+ return this.#store.transactionAsync(async ()=>{
40
+ const keys = await toArray(this.#lastUsedIndexes.keysAsync());
41
+ await Promise.all(keys.map((secret)=>this.#lastUsedIndexes.delete(secret)));
42
+ });
43
+ }
44
+ // It might seem weird that the following 3 methods are in RecipientTaggingDataProvider and not
45
+ // in SenderTaggingDataProvider but that is because this data is truly only used for the purposes of syncing logs
46
+ // as a recipient. When sending logs or when syncing sender tagging indexes we only receive directional app tagging
47
+ // secret from Aztec.nr via an oracle and we don't need to access sender addresses.
48
+ async addSenderAddress(address) {
49
+ if (await this.#addressBook.hasAsync(address.toString())) {
50
+ return false;
51
+ }
52
+ await this.#addressBook.set(address.toString(), true);
53
+ return true;
54
+ }
55
+ async getSenderAddresses() {
56
+ return (await toArray(this.#addressBook.keysAsync())).map(AztecAddress.fromString);
57
+ }
58
+ async removeSenderAddress(address) {
59
+ if (!await this.#addressBook.hasAsync(address.toString())) {
60
+ return false;
61
+ }
62
+ await this.#addressBook.delete(address.toString());
63
+ return true;
64
+ }
65
+ }
@@ -0,0 +1,67 @@
1
+ import type { AztecAsyncKVStore } from '@aztec/kv-store';
2
+ import type { DirectionalAppTaggingSecret, PreTag } from '@aztec/stdlib/logs';
3
+ import { TxHash } from '@aztec/stdlib/tx';
4
+ /**
5
+ * Data provider of tagging data used when syncing the sender tagging indexes. The recipient counterpart of this class
6
+ * is called RecipientTaggingDataProvider. 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 two.
8
+ */
9
+ export declare class SenderTaggingDataProvider {
10
+ #private;
11
+ constructor(store: AztecAsyncKVStore);
12
+ /**
13
+ * Stores pending indexes.
14
+ * @remarks Ignores the index if the same preTag + txHash combination already exists in the db with the same index.
15
+ * This is expected to happen because whenever we start sync we start from the last finalized index and we can have
16
+ * pending indexes already stored from previous syncs.
17
+ * @param preTags - The pre-tags containing the directional app tagging secrets and the indexes that are to be
18
+ * stored in the db.
19
+ * @param txHash - The tx in which the pretags were used in private logs.
20
+ * @throws If any two pre-tags contain the same directional app tagging secret. This is enforced because we care
21
+ * only about the highest index for a given secret that was used in the tx. Hence this check is a good way to catch
22
+ * bugs.
23
+ * @throws If the newly stored pending index is further than window length from the highest finalized index for the
24
+ * same secret. This is enforced in order to give a guarantee to a recipient that he doesn't need to look further than
25
+ * window length ahead of the highest finalized index.
26
+ * @throws If a secret + txHash pair already exists in the db with a different index value. It should never happen
27
+ * that we would attempt to store a different index for a given secret-txHash pair because we always store just the
28
+ * highest index for a given secret-txHash pair. Hence this is a good way to catch bugs.
29
+ * @throws If the newly stored pending index is lower than or equal to the last finalized index for the same secret.
30
+ * This is enforced because this should never happen if the syncing is done correctly as we look for logs from higher
31
+ * indexes than finalized ones.
32
+ */
33
+ storePendingIndexes(preTags: PreTag[], txHash: TxHash): Promise<void>;
34
+ /**
35
+ * Returns the transaction hashes of all pending transactions that contain indexes within a specified range
36
+ * for a given directional app tagging secret.
37
+ * @param secret - The directional app tagging secret to query pending indexes for.
38
+ * @param startIndex - The lower bound of the index range (inclusive).
39
+ * @param endIndex - The upper bound of the index range (exclusive).
40
+ * @returns An array of unique transaction hashes for pending transactions that contain indexes in the range
41
+ * [startIndex, endIndex). Returns an empty array if no pending indexes exist in the range.
42
+ */
43
+ getTxHashesOfPendingIndexes(secret: DirectionalAppTaggingSecret, startIndex: number, endIndex: number): Promise<TxHash[]>;
44
+ /**
45
+ * Returns the last (highest) finalized index for a given secret.
46
+ * @param secret - The secret to get the last finalized index for.
47
+ * @returns The last (highest) finalized index for the given secret.
48
+ */
49
+ getLastFinalizedIndex(secret: DirectionalAppTaggingSecret): Promise<number | undefined>;
50
+ /**
51
+ * Returns the last used index for a given directional app tagging secret, considering both finalized and pending
52
+ * indexes.
53
+ * @param secret - The directional app tagging secret to query the last used index for.
54
+ * @returns The last used index.
55
+ */
56
+ getLastUsedIndex(secret: DirectionalAppTaggingSecret): Promise<number | undefined>;
57
+ /**
58
+ * Drops all pending indexes corresponding to the given transaction hashes.
59
+ */
60
+ dropPendingIndexes(txHashes: TxHash[]): Promise<void>;
61
+ /**
62
+ * Updates pending indexes corresponding to the given transaction hashes to be finalized and prunes any lower pending
63
+ * indexes.
64
+ */
65
+ finalizePendingIndexes(txHashes: TxHash[]): Promise<void>;
66
+ }
67
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2VuZGVyX3RhZ2dpbmdfZGF0YV9wcm92aWRlci5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL3N0b3JhZ2UvdGFnZ2luZ19kYXRhX3Byb3ZpZGVyL3NlbmRlcl90YWdnaW5nX2RhdGFfcHJvdmlkZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxLQUFLLEVBQUUsaUJBQWlCLEVBQWlCLE1BQU0saUJBQWlCLENBQUM7QUFDeEUsT0FBTyxLQUFLLEVBQUUsMkJBQTJCLEVBQUUsTUFBTSxFQUFFLE1BQU0sb0JBQW9CLENBQUM7QUFDOUUsT0FBTyxFQUFFLE1BQU0sRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBSTFDOzs7O0dBSUc7QUFDSCxxQkFBYSx5QkFBeUI7O0lBa0JwQyxZQUFZLEtBQUssRUFBRSxpQkFBaUIsRUFLbkM7SUFFRDs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7T0FvQkc7SUFDRyxtQkFBbUIsQ0FBQyxPQUFPLEVBQUUsTUFBTSxFQUFFLEVBQUUsTUFBTSxFQUFFLE1BQU0saUJBaUQxRDtJQUVEOzs7Ozs7OztPQVFHO0lBQ0csMkJBQTJCLENBQy9CLE1BQU0sRUFBRSwyQkFBMkIsRUFDbkMsVUFBVSxFQUFFLE1BQU0sRUFDbEIsUUFBUSxFQUFFLE1BQU0sR0FDZixPQUFPLENBQUMsTUFBTSxFQUFFLENBQUMsQ0FNbkI7SUFFRDs7OztPQUlHO0lBQ0gscUJBQXFCLENBQUMsTUFBTSxFQUFFLDJCQUEyQixHQUFHLE9BQU8sQ0FBQyxNQUFNLEdBQUcsU0FBUyxDQUFDLENBRXRGO0lBRUQ7Ozs7O09BS0c7SUFDRyxnQkFBZ0IsQ0FBQyxNQUFNLEVBQUUsMkJBQTJCLEdBQUcsT0FBTyxDQUFDLE1BQU0sR0FBRyxTQUFTLENBQUMsQ0FZdkY7SUFFRDs7T0FFRztJQUNHLGtCQUFrQixDQUFDLFFBQVEsRUFBRSxNQUFNLEVBQUUsaUJBcUIxQztJQUVEOzs7T0FHRztJQUNHLHNCQUFzQixDQUFDLFFBQVEsRUFBRSxNQUFNLEVBQUUsaUJBcUQ5QztDQUNGIn0=
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sender_tagging_data_provider.d.ts","sourceRoot":"","sources":["../../../src/storage/tagging_data_provider/sender_tagging_data_provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,iBAAiB,CAAC;AACxE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAI1C;;;;GAIG;AACH,qBAAa,yBAAyB;;IAkBpC,YAAY,KAAK,EAAE,iBAAiB,EAKnC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,iBAiD1D;IAED;;;;;;;;OAQG;IACG,2BAA2B,CAC/B,MAAM,EAAE,2BAA2B,EACnC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,EAAE,CAAC,CAMnB;IAED;;;;OAIG;IACH,qBAAqB,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAEtF;IAED;;;;;OAKG;IACG,gBAAgB,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAYvF;IAED;;OAEG;IACG,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,iBAqB1C;IAED;;;OAGG;IACG,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,iBAqD9C;CACF"}
@@ -0,0 +1,196 @@
1
+ import { toArray } from '@aztec/foundation/iterable';
2
+ import { TxHash } from '@aztec/stdlib/tx';
3
+ import { UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN } from '../../tagging/sync/sync_sender_tagging_indexes.js';
4
+ /**
5
+ * Data provider of tagging data used when syncing the sender tagging indexes. The recipient counterpart of this class
6
+ * is called RecipientTaggingDataProvider. 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 two.
8
+ */ export class SenderTaggingDataProvider {
9
+ #store;
10
+ // Stores the pending indexes for each directional app tagging secret. Pending here means that the tx that contained
11
+ // the private logs with tags corresponding to these indexes has not been finalized yet.
12
+ //
13
+ // We don't store just the highest index because if their transaction is dropped we'd then need the information about
14
+ // the lower pending indexes. For each secret-tx pair however we only store the largest index used in that tx, since
15
+ // the smaller ones are irrelevant due to tx atomicity.
16
+ //
17
+ // TODO(#17615): This assumes no logs are used in the non-revertible phase.
18
+ #pendingIndexes;
19
+ // Stores the last (highest) finalized index for each directional app tagging secret. We care only about the last
20
+ // index because unlike the pending indexes, it will never happen that a finalized index would be removed and hence
21
+ // we don't need to store the history.
22
+ #lastFinalizedIndexes;
23
+ constructor(store){
24
+ this.#store = store;
25
+ this.#pendingIndexes = this.#store.openMap('pending_indexes');
26
+ this.#lastFinalizedIndexes = this.#store.openMap('last_finalized_indexes');
27
+ }
28
+ /**
29
+ * Stores pending indexes.
30
+ * @remarks Ignores the index if the same preTag + txHash combination already exists in the db with the same index.
31
+ * This is expected to happen because whenever we start sync we start from the last finalized index and we can have
32
+ * pending indexes already stored from previous syncs.
33
+ * @param preTags - The pre-tags containing the directional app tagging secrets and the indexes that are to be
34
+ * stored in the db.
35
+ * @param txHash - The tx in which the pretags were used in private logs.
36
+ * @throws If any two pre-tags contain the same directional app tagging secret. This is enforced because we care
37
+ * only about the highest index for a given secret that was used in the tx. Hence this check is a good way to catch
38
+ * bugs.
39
+ * @throws If the newly stored pending index is further than window length from the highest finalized index for the
40
+ * same secret. This is enforced in order to give a guarantee to a recipient that he doesn't need to look further than
41
+ * window length ahead of the highest finalized index.
42
+ * @throws If a secret + txHash pair already exists in the db with a different index value. It should never happen
43
+ * that we would attempt to store a different index for a given secret-txHash pair because we always store just the
44
+ * highest index for a given secret-txHash pair. Hence this is a good way to catch bugs.
45
+ * @throws If the newly stored pending index is lower than or equal to the last finalized index for the same secret.
46
+ * This is enforced because this should never happen if the syncing is done correctly as we look for logs from higher
47
+ * indexes than finalized ones.
48
+ */ async storePendingIndexes(preTags, txHash) {
49
+ // The secrets in pre-tags should be unique because we always store just the highest index per given secret-txHash
50
+ // pair. Below we check that this is the case.
51
+ const secretsSet = new Set(preTags.map((preTag)=>preTag.secret.toString()));
52
+ if (secretsSet.size !== preTags.length) {
53
+ throw new Error(`Duplicate secrets found when storing pending indexes`);
54
+ }
55
+ for (const { secret, index } of preTags){
56
+ // First we check that for any secret the highest used index in tx is not further than window length from
57
+ // the highest finalized index.
58
+ const finalizedIndex = await this.getLastFinalizedIndex(secret) ?? 0;
59
+ if (index > finalizedIndex + UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN) {
60
+ throw new Error(`Highest used index ${index} is further than window length from the highest finalized index ${finalizedIndex}.
61
+ Tagging window length ${UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN} is configured too low. Contact the Aztec team
62
+ to increase it!`);
63
+ }
64
+ // Throw if the new pending index is lower than or equal to the last finalized index
65
+ const secretStr = secret.toString();
66
+ const lastFinalizedIndex = await this.#lastFinalizedIndexes.getAsync(secretStr);
67
+ if (lastFinalizedIndex !== undefined && index <= lastFinalizedIndex) {
68
+ throw new Error(`Cannot store pending index ${index} for secret ${secretStr}: ` + `it is lower than or equal to the last finalized index ${lastFinalizedIndex}`);
69
+ }
70
+ // Check if this secret + txHash combination already exists
71
+ const txHashStr = txHash.toString();
72
+ const existingForSecret = await this.#pendingIndexes.getAsync(secretStr) ?? [];
73
+ const existingForSecretAndTx = existingForSecret.find((entry)=>entry.txHash === txHashStr);
74
+ if (existingForSecretAndTx) {
75
+ // If it exists with a different index, throw an error
76
+ if (existingForSecretAndTx.index !== index) {
77
+ throw new Error(`Cannot store index ${index} for secret ${secretStr} and txHash ${txHashStr}: ` + `a different index ${existingForSecretAndTx.index} already exists for this secret-txHash pair`);
78
+ }
79
+ // If it exists with the same index, ignore the update (no-op)
80
+ } else {
81
+ // If it doesn't exist, add it
82
+ await this.#pendingIndexes.set(secretStr, [
83
+ ...existingForSecret,
84
+ {
85
+ index,
86
+ txHash: txHashStr
87
+ }
88
+ ]);
89
+ }
90
+ }
91
+ }
92
+ /**
93
+ * Returns the transaction hashes of all pending transactions that contain indexes within a specified range
94
+ * for a given directional app tagging secret.
95
+ * @param secret - The directional app tagging secret to query pending indexes for.
96
+ * @param startIndex - The lower bound of the index range (inclusive).
97
+ * @param endIndex - The upper bound of the index range (exclusive).
98
+ * @returns An array of unique transaction hashes for pending transactions that contain indexes in the range
99
+ * [startIndex, endIndex). Returns an empty array if no pending indexes exist in the range.
100
+ */ async getTxHashesOfPendingIndexes(secret, startIndex, endIndex) {
101
+ const existing = await this.#pendingIndexes.getAsync(secret.toString()) ?? [];
102
+ const txHashes = existing.filter((entry)=>entry.index >= startIndex && entry.index < endIndex).map((entry)=>entry.txHash);
103
+ return Array.from(new Set(txHashes)).map(TxHash.fromString);
104
+ }
105
+ /**
106
+ * Returns the last (highest) finalized index for a given secret.
107
+ * @param secret - The secret to get the last finalized index for.
108
+ * @returns The last (highest) finalized index for the given secret.
109
+ */ getLastFinalizedIndex(secret) {
110
+ return this.#lastFinalizedIndexes.getAsync(secret.toString());
111
+ }
112
+ /**
113
+ * Returns the last used index for a given directional app tagging secret, considering both finalized and pending
114
+ * indexes.
115
+ * @param secret - The directional app tagging secret to query the last used index for.
116
+ * @returns The last used index.
117
+ */ async getLastUsedIndex(secret) {
118
+ const secretStr = secret.toString();
119
+ const pendingTxScopedIndexes = await this.#pendingIndexes.getAsync(secretStr) ?? [];
120
+ const pendingIndexes = pendingTxScopedIndexes.map((entry)=>entry.index);
121
+ if (pendingTxScopedIndexes.length === 0) {
122
+ return this.#lastFinalizedIndexes.getAsync(secretStr);
123
+ }
124
+ // As the last used index we return the highest one from the pending indexes. Note that this value will be always
125
+ // higher than the last finalized index because we prune lower pending indexes when a tx is finalized.
126
+ return Math.max(...pendingIndexes);
127
+ }
128
+ /**
129
+ * Drops all pending indexes corresponding to the given transaction hashes.
130
+ */ async dropPendingIndexes(txHashes) {
131
+ if (txHashes.length === 0) {
132
+ return;
133
+ }
134
+ const txHashStrs = new Set(txHashes.map((txHash)=>txHash.toString()));
135
+ const allSecrets = await toArray(this.#pendingIndexes.keysAsync());
136
+ for (const secret of allSecrets){
137
+ const pendingData = await this.#pendingIndexes.getAsync(secret);
138
+ if (pendingData) {
139
+ const filtered = pendingData.filter((item)=>!txHashStrs.has(item.txHash));
140
+ if (filtered.length === 0) {
141
+ await this.#pendingIndexes.delete(secret);
142
+ } else if (filtered.length !== pendingData.length) {
143
+ // Some items were filtered out, so update the pending data
144
+ await this.#pendingIndexes.set(secret, filtered);
145
+ }
146
+ // else: No items were filtered out (txHashes not found for this secret) --> no-op
147
+ }
148
+ }
149
+ }
150
+ /**
151
+ * Updates pending indexes corresponding to the given transaction hashes to be finalized and prunes any lower pending
152
+ * indexes.
153
+ */ async finalizePendingIndexes(txHashes) {
154
+ if (txHashes.length === 0) {
155
+ return;
156
+ }
157
+ for (const txHash of txHashes){
158
+ const txHashStr = txHash.toString();
159
+ const allSecrets = await toArray(this.#pendingIndexes.keysAsync());
160
+ for (const secret of allSecrets){
161
+ const pendingData = await this.#pendingIndexes.getAsync(secret);
162
+ if (!pendingData) {
163
+ continue;
164
+ }
165
+ const matchingIndexes = pendingData.filter((item)=>item.txHash === txHashStr).map((item)=>item.index);
166
+ if (matchingIndexes.length === 0) {
167
+ continue;
168
+ }
169
+ if (matchingIndexes.length > 1) {
170
+ // We should always just store the highest pending index for a given tx hash and secret because the lower
171
+ // values are irrelevant.
172
+ throw new Error(`Multiple pending indexes found for tx hash ${txHashStr} and secret ${secret}`);
173
+ }
174
+ let lastFinalized = await this.#lastFinalizedIndexes.getAsync(secret);
175
+ const newFinalized = matchingIndexes[0];
176
+ if (newFinalized < (lastFinalized ?? 0)) {
177
+ // This should never happen because when last finalized index was finalized we should have pruned the lower
178
+ // pending indexes.
179
+ throw new Error(`New finalized index ${newFinalized} is smaller than the current last finalized index ${lastFinalized}`);
180
+ }
181
+ await this.#lastFinalizedIndexes.set(secret, newFinalized);
182
+ lastFinalized = newFinalized;
183
+ // When we add pending indexes, we ensure they are higher than the last finalized index. However, because we
184
+ // cannot control the order in which transactions are finalized, there may be pending indexes that are now
185
+ // obsolete because they are lower than the most recently finalized index. For this reason, we prune these
186
+ // outdated pending indexes.
187
+ const remainingItemsOfHigherIndex = pendingData.filter((item)=>item.index > (lastFinalized ?? 0));
188
+ if (remainingItemsOfHigherIndex.length === 0) {
189
+ await this.#pendingIndexes.delete(secret);
190
+ } else {
191
+ await this.#pendingIndexes.set(secret, remainingItemsOfHigherIndex);
192
+ }
193
+ }
194
+ }
195
+ }
196
+ }
@@ -0,0 +1,2 @@
1
+ export declare const WINDOW_HALF_SIZE = 10;
2
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uc3RhbnRzLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdGFnZ2luZy9jb25zdGFudHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEsZUFBTyxNQUFNLGdCQUFnQixLQUFLLENBQUMifQ==
@@ -0,0 +1 @@
1
+ {"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/tagging/constants.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,KAAK,CAAC"}
@@ -0,0 +1,3 @@
1
+ // Half the size of the window we slide over the tagging indexes.
2
+ // TODO(#17775): Move this to the recipient log sync function once it's implemented in this directory.
3
+ export const WINDOW_HALF_SIZE = 10;
@@ -0,0 +1,5 @@
1
+ export * from './constants.js';
2
+ export * from './utils.js';
3
+ export { DirectionalAppTaggingSecret, Tag, SiloedTag } from '@aztec/stdlib/logs';
4
+ export { type PreTag } from '@aztec/stdlib/logs';
5
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90YWdnaW5nL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGNBQWMsZ0JBQWdCLENBQUM7QUFDL0IsY0FBYyxZQUFZLENBQUM7QUFDM0IsT0FBTyxFQUFFLDJCQUEyQixFQUFFLEdBQUcsRUFBRSxTQUFTLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUNqRixPQUFPLEVBQUUsS0FBSyxNQUFNLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQyJ9
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tagging/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,2BAA2B,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACjF,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC"}
@@ -0,0 +1,3 @@
1
+ export * from './constants.js';
2
+ export * from './utils.js';
3
+ export { DirectionalAppTaggingSecret, Tag, SiloedTag } from '@aztec/stdlib/logs';
@@ -0,0 +1,14 @@
1
+ import type { BlockNumber } from '@aztec/foundation/branded-types';
2
+ import type { AztecAddress } from '@aztec/stdlib/aztec-address';
3
+ import type { AztecNode } from '@aztec/stdlib/interfaces/client';
4
+ import type { DirectionalAppTaggingSecret, TxScopedL2Log } from '@aztec/stdlib/logs';
5
+ import type { NewRecipientTaggingDataProvider } from './new_recipient_tagging_data_provider.js';
6
+ /**
7
+ * Loads private logs for `app` and sender-recipient pair defined by `secret` and updates the highest aged and
8
+ * finalized indexes in the db. At most load logs from blocks up to and including `anchorBlockNumber`.
9
+ *
10
+ * @dev This function can be safely executed "in parallel" for other sender-recipient pairs because the data in
11
+ * in the tagging data provider is indexed by the secret and hence completely disjoint.
12
+ */
13
+ export declare function loadPrivateLogsForSenderRecipientPair(secret: DirectionalAppTaggingSecret, app: AztecAddress, aztecNode: AztecNode, taggingDataProvider: NewRecipientTaggingDataProvider, anchorBlockNumber: BlockNumber): Promise<TxScopedL2Log[]>;
14
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9hZF9wcml2YXRlX2xvZ3NfZm9yX3NlbmRlcl9yZWNpcGllbnRfcGFpci5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL3RhZ2dpbmcvcmVjaXBpZW50X3N5bmMvbG9hZF9wcml2YXRlX2xvZ3NfZm9yX3NlbmRlcl9yZWNpcGllbnRfcGFpci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxXQUFXLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUNuRSxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUNoRSxPQUFPLEtBQUssRUFBRSxTQUFTLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUNqRSxPQUFPLEtBQUssRUFBRSwyQkFBMkIsRUFBRSxhQUFhLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUdyRixPQUFPLEtBQUssRUFBRSwrQkFBK0IsRUFBRSxNQUFNLDBDQUEwQyxDQUFDO0FBSWhHOzs7Ozs7R0FNRztBQUNILHdCQUFzQixxQ0FBcUMsQ0FDekQsTUFBTSxFQUFFLDJCQUEyQixFQUNuQyxHQUFHLEVBQUUsWUFBWSxFQUNqQixTQUFTLEVBQUUsU0FBUyxFQUNwQixtQkFBbUIsRUFBRSwrQkFBK0IsRUFDcEQsaUJBQWlCLEVBQUUsV0FBVyxHQUM3QixPQUFPLENBQUMsYUFBYSxFQUFFLENBQUMsQ0F5RzFCIn0=
@@ -0,0 +1 @@
1
+ {"version":3,"file":"load_private_logs_for_sender_recipient_pair.d.ts","sourceRoot":"","sources":["../../../src/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,KAAK,EAAE,2BAA2B,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGrF,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,0CAA0C,CAAC;AAIhG;;;;;;GAMG;AACH,wBAAsB,qCAAqC,CACzD,MAAM,EAAE,2BAA2B,EACnC,GAAG,EAAE,YAAY,EACjB,SAAS,EAAE,SAAS,EACpB,mBAAmB,EAAE,+BAA+B,EACpD,iBAAiB,EAAE,WAAW,GAC7B,OAAO,CAAC,aAAa,EAAE,CAAC,CAyG1B"}
@@ -0,0 +1,99 @@
1
+ import { UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN } from '../sync/sync_sender_tagging_indexes.js';
2
+ import { findHighestIndexes } from './utils/find_highest_indexes.js';
3
+ import { loadLogsForRange } from './utils/load_logs_for_range.js';
4
+ /**
5
+ * Loads private logs for `app` and sender-recipient pair defined by `secret` and updates the highest aged and
6
+ * finalized indexes in the db. At most load logs from blocks up to and including `anchorBlockNumber`.
7
+ *
8
+ * @dev This function can be safely executed "in parallel" for other sender-recipient pairs because the data in
9
+ * in the tagging data provider is indexed by the secret and hence completely disjoint.
10
+ */ export async function loadPrivateLogsForSenderRecipientPair(secret, app, aztecNode, taggingDataProvider, anchorBlockNumber) {
11
+ // # Explanation of how the algorithm works
12
+ // When we perform the sync we will look at logs that correspond to the tagging index range
13
+ // (highestAgedIndex, highestFinalizedIndex + WINDOW_LEN]
14
+ //
15
+ // highestAgedIndex is the highest index that was used in a tx that is included in a block at least
16
+ // `MAX_INCLUDE_BY_TIMESTAMP_DURATION` seconds ago.
17
+ // highestFinalizedIndex is the highest index that was used in a tx that is included in a finalized block.
18
+ //
19
+ // "(" denotes an open end of the range - the index is not included in the range.
20
+ // "]" denotes a closed end of the range - the index is included in the range.
21
+ //
22
+ // ## Explanation of highestAgedIndex
23
+ //
24
+ // highestAgedIndex is chosen such that for all tagging indexes `i <= highestAgedIndex` we know that no new logs can
25
+ // ever appear.
26
+ //
27
+ // This relies on the "maximum inclusion timestamp" rule enforced by the kernel and rollup circuits:
28
+ // - a transaction's maximum inclusion timestamp is at most `MAX_INCLUDE_BY_TIMESTAMP_DURATION` seconds after
29
+ // the timestamp of its anchor block; and
30
+ // - a rollup only includes transactions whose inclusion timestamp is >= the L2 block's timestamp.
31
+ //
32
+ // Suppose some device used index `I` in a transaction anchored to block `B_N` at time `N`, and that block is now at
33
+ // least `MAX_INCLUDE_BY_TIMESTAMP_DURATION` seconds in the past. Then there is no possibility of any *other* device
34
+ // trying to use an index <= `I` while anchoring to a *newer* block than `B_N` because if we were anchoring to
35
+ // a newer block than `B_N` then we would already have seen the log with index `I` and hence the device would have
36
+ // chosen a larger index.
37
+ // If that *other* device would anchor to a block older than `B_N` then that tx could never be included in a block
38
+ // because it would already have been expired.
39
+ //
40
+ // Therefore, once we see that index `I` has been used in a block that is at least `MAX_INCLUDE_BY_TIMESTAMP_DURATION`
41
+ // seconds old, we can safely stop syncing logs for all indexes <= `I` and set highestAgedIndex = `I`.
42
+ //
43
+ // ## Explanation of the upper bound `highestFinalizedIndex + WINDOW_LEN`
44
+ //
45
+ // When a sender chooses a tagging index, they will select an index that is at most `WINDOW_LEN` greater than
46
+ // the highest finalized index. If that index was already used, they will throw an error. For this reason we
47
+ // don't have to look further than `highestFinalizedIndex + WINDOW_LEN`.
48
+ let finalizedBlockNumber, currentTimestamp;
49
+ {
50
+ const [l2Tips, latestBlockHeader] = await Promise.all([
51
+ aztecNode.getL2Tips(),
52
+ aztecNode.getBlockHeader('latest')
53
+ ]);
54
+ if (!latestBlockHeader) {
55
+ throw new Error('Node failed to return latest block header when syncing logs');
56
+ }
57
+ [finalizedBlockNumber, currentTimestamp] = [
58
+ l2Tips.finalized.number,
59
+ latestBlockHeader.globalVariables.timestamp
60
+ ];
61
+ }
62
+ let start, end;
63
+ {
64
+ const currentHighestAgedIndex = await taggingDataProvider.getHighestAgedIndex(secret);
65
+ const currentHighestFinalizedIndex = await taggingDataProvider.getHighestFinalizedIndex(secret);
66
+ // We don't want to include the highest aged index so we start from `currentHighestAgedIndex + 1` (or 0 if not set)
67
+ start = currentHighestAgedIndex === undefined ? 0 : currentHighestAgedIndex + 1;
68
+ // The highest index a sender can choose is "highest finalized index + window length" but given that
69
+ // `loadLogsForRange` expects an exclusive `end` we add 1.
70
+ end = (currentHighestFinalizedIndex ?? 0) + UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN + 1;
71
+ }
72
+ const logs = [];
73
+ while(true){
74
+ // Get private logs with their block timestamps and corresponding tagging indexes
75
+ const privateLogsWithIndexes = await loadLogsForRange(secret, app, aztecNode, start, end, anchorBlockNumber);
76
+ if (privateLogsWithIndexes.length === 0) {
77
+ break;
78
+ }
79
+ logs.push(...privateLogsWithIndexes.map(({ log })=>log));
80
+ const { highestAgedIndex, highestFinalizedIndex } = findHighestIndexes(privateLogsWithIndexes, currentTimestamp, finalizedBlockNumber);
81
+ // Store updates in data provider and update local variables
82
+ if (highestAgedIndex !== undefined) {
83
+ await taggingDataProvider.updateHighestAgedIndex(secret, highestAgedIndex);
84
+ }
85
+ if (highestFinalizedIndex === undefined) {
86
+ break;
87
+ }
88
+ if (highestAgedIndex !== undefined && highestAgedIndex > highestFinalizedIndex) {
89
+ // This is just a sanity check as this should never happen.
90
+ throw new Error('Highest aged index lower than highest finalized index invariant violated');
91
+ }
92
+ await taggingDataProvider.updateHighestFinalizedIndex(secret, highestFinalizedIndex);
93
+ // For the next iteration we want to look only at indexes for which we have not attempted to load logs yet while
94
+ // ensuring that we do not look further than WINDOW_LEN ahead of the highest finalized index.
95
+ start = end;
96
+ end = highestFinalizedIndex + UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN + 1; // `end` is exclusive so we add 1.
97
+ }
98
+ return logs;
99
+ }
@@ -0,0 +1,21 @@
1
+ import type { AztecAsyncKVStore } from '@aztec/kv-store';
2
+ import type { DirectionalAppTaggingSecret } from '@aztec/stdlib/logs';
3
+ /**
4
+ * Data provider of tagging data used when syncing the logs as a recipient. The sender counterpart of this class
5
+ * is called SenderTaggingDataProvider. We have the providers separate for the sender and recipient because
6
+ * the algorithms are completely disjoint and there is not data reuse between the two.
7
+ *
8
+ * @dev Chain reorgs do not need to be handled here because both the finalized and aged indexes refer to finalized
9
+ * blocks, which by definition cannot be affected by reorgs.
10
+ *
11
+ * TODO(benesjan): Rename as to RecipientTaggingDataProvider and relocate once the old tagging sync is purged.
12
+ */
13
+ export declare class NewRecipientTaggingDataProvider {
14
+ #private;
15
+ constructor(store: AztecAsyncKVStore);
16
+ getHighestAgedIndex(secret: DirectionalAppTaggingSecret): Promise<number | undefined>;
17
+ updateHighestAgedIndex(secret: DirectionalAppTaggingSecret, index: number): Promise<void>;
18
+ getHighestFinalizedIndex(secret: DirectionalAppTaggingSecret): Promise<number | undefined>;
19
+ updateHighestFinalizedIndex(secret: DirectionalAppTaggingSecret, index: number): Promise<void>;
20
+ }
21
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibmV3X3JlY2lwaWVudF90YWdnaW5nX2RhdGFfcHJvdmlkZXIuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy90YWdnaW5nL3JlY2lwaWVudF9zeW5jL25ld19yZWNpcGllbnRfdGFnZ2luZ19kYXRhX3Byb3ZpZGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLGlCQUFpQixFQUFpQixNQUFNLGlCQUFpQixDQUFDO0FBQ3hFLE9BQU8sS0FBSyxFQUFFLDJCQUEyQixFQUFFLE1BQU0sb0JBQW9CLENBQUM7QUFFdEU7Ozs7Ozs7OztHQVNHO0FBQ0gscUJBQWEsK0JBQStCOztJQU0xQyxZQUFZLEtBQUssRUFBRSxpQkFBaUIsRUFLbkM7SUFFRCxtQkFBbUIsQ0FBQyxNQUFNLEVBQUUsMkJBQTJCLEdBQUcsT0FBTyxDQUFDLE1BQU0sR0FBRyxTQUFTLENBQUMsQ0FFcEY7SUFFSyxzQkFBc0IsQ0FBQyxNQUFNLEVBQUUsMkJBQTJCLEVBQUUsS0FBSyxFQUFFLE1BQU0sR0FBRyxPQUFPLENBQUMsSUFBSSxDQUFDLENBTzlGO0lBRUQsd0JBQXdCLENBQUMsTUFBTSxFQUFFLDJCQUEyQixHQUFHLE9BQU8sQ0FBQyxNQUFNLEdBQUcsU0FBUyxDQUFDLENBRXpGO0lBRUssMkJBQTJCLENBQUMsTUFBTSxFQUFFLDJCQUEyQixFQUFFLEtBQUssRUFBRSxNQUFNLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQVFuRztDQUNGIn0=
@@ -0,0 +1 @@
1
+ {"version":3,"file":"new_recipient_tagging_data_provider.d.ts","sourceRoot":"","sources":["../../../src/tagging/recipient_sync/new_recipient_tagging_data_provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,iBAAiB,CAAC;AACxE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AAEtE;;;;;;;;;GASG;AACH,qBAAa,+BAA+B;;IAM1C,YAAY,KAAK,EAAE,iBAAiB,EAKnC;IAED,mBAAmB,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAEpF;IAEK,sBAAsB,CAAC,MAAM,EAAE,2BAA2B,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAO9F;IAED,wBAAwB,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAEzF;IAEK,2BAA2B,CAAC,MAAM,EAAE,2BAA2B,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQnG;CACF"}
@@ -0,0 +1,42 @@
1
+ /**
2
+ * Data provider of tagging data used when syncing the logs as a recipient. The sender counterpart of this class
3
+ * is called SenderTaggingDataProvider. We have the providers separate for the sender and recipient because
4
+ * the algorithms are completely disjoint and there is not data reuse between the two.
5
+ *
6
+ * @dev Chain reorgs do not need to be handled here because both the finalized and aged indexes refer to finalized
7
+ * blocks, which by definition cannot be affected by reorgs.
8
+ *
9
+ * TODO(benesjan): Rename as to RecipientTaggingDataProvider and relocate once the old tagging sync is purged.
10
+ */ export class NewRecipientTaggingDataProvider {
11
+ #store;
12
+ #highestAgedIndex;
13
+ #highestFinalizedIndex;
14
+ constructor(store){
15
+ this.#store = store;
16
+ this.#highestAgedIndex = this.#store.openMap('highest_aged_index');
17
+ this.#highestFinalizedIndex = this.#store.openMap('highest_finalized_index');
18
+ }
19
+ getHighestAgedIndex(secret) {
20
+ return this.#highestAgedIndex.getAsync(secret.toString());
21
+ }
22
+ async updateHighestAgedIndex(secret, index) {
23
+ const currentIndex = await this.#highestAgedIndex.getAsync(secret.toString());
24
+ if (currentIndex !== undefined && index <= currentIndex) {
25
+ // Log sync should never set a lower highest aged index.
26
+ throw new Error(`New highest aged index (${index}) must be higher than the current one (${currentIndex})`);
27
+ }
28
+ await this.#highestAgedIndex.set(secret.toString(), index);
29
+ }
30
+ getHighestFinalizedIndex(secret) {
31
+ return this.#highestFinalizedIndex.getAsync(secret.toString());
32
+ }
33
+ async updateHighestFinalizedIndex(secret, index) {
34
+ const currentIndex = await this.#highestFinalizedIndex.getAsync(secret.toString());
35
+ if (currentIndex !== undefined && index < currentIndex) {
36
+ // Log sync should never set a lower highest finalized index but it can happen that it would try to set the same
37
+ // one because we are loading logs from highest aged index + 1 and not from the highest finalized index.
38
+ throw new Error(`New highest finalized index (${index}) must be higher than the current one (${currentIndex})`);
39
+ }
40
+ await this.#highestFinalizedIndex.set(secret.toString(), index);
41
+ }
42
+ }
@@ -0,0 +1,12 @@
1
+ import type { TxScopedL2Log } from '@aztec/stdlib/logs';
2
+ /**
3
+ * Finds the highest aged and the highest finalized tagging indexes.
4
+ */
5
+ export declare function findHighestIndexes(privateLogsWithIndexes: Array<{
6
+ log: TxScopedL2Log;
7
+ taggingIndex: number;
8
+ }>, currentTimestamp: bigint, finalizedBlockNumber: number): {
9
+ highestAgedIndex: number | undefined;
10
+ highestFinalizedIndex: number | undefined;
11
+ };
12
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmluZF9oaWdoZXN0X2luZGV4ZXMuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy90YWdnaW5nL3JlY2lwaWVudF9zeW5jL3V0aWxzL2ZpbmRfaGlnaGVzdF9pbmRleGVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUNBLE9BQU8sS0FBSyxFQUFFLGFBQWEsRUFBRSxNQUFNLG9CQUFvQixDQUFDO0FBRXhEOztHQUVHO0FBQ0gsd0JBQWdCLGtCQUFrQixDQUNoQyxzQkFBc0IsRUFBRSxLQUFLLENBQUM7SUFBRSxHQUFHLEVBQUUsYUFBYSxDQUFDO0lBQUMsWUFBWSxFQUFFLE1BQU0sQ0FBQTtDQUFFLENBQUMsRUFDM0UsZ0JBQWdCLEVBQUUsTUFBTSxFQUN4QixvQkFBb0IsRUFBRSxNQUFNLEdBQzNCO0lBQUUsZ0JBQWdCLEVBQUUsTUFBTSxHQUFHLFNBQVMsQ0FBQztJQUFDLHFCQUFxQixFQUFFLE1BQU0sR0FBRyxTQUFTLENBQUE7Q0FBRSxDQXVCckYifQ==
@@ -0,0 +1 @@
1
+ {"version":3,"file":"find_highest_indexes.d.ts","sourceRoot":"","sources":["../../../../src/tagging/recipient_sync/utils/find_highest_indexes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,sBAAsB,EAAE,KAAK,CAAC;IAAE,GAAG,EAAE,aAAa,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,EAC3E,gBAAgB,EAAE,MAAM,EACxB,oBAAoB,EAAE,MAAM,GAC3B;IAAE,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,qBAAqB,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAuBrF"}
@@ -0,0 +1,20 @@
1
+ import { MAX_INCLUDE_BY_TIMESTAMP_DURATION } from '@aztec/constants';
2
+ /**
3
+ * Finds the highest aged and the highest finalized tagging indexes.
4
+ */ export function findHighestIndexes(privateLogsWithIndexes, currentTimestamp, finalizedBlockNumber) {
5
+ let highestAgedIndex = undefined;
6
+ let highestFinalizedIndex = undefined;
7
+ for (const { log, taggingIndex } of privateLogsWithIndexes){
8
+ const ageInSeconds = currentTimestamp - log.blockTimestamp;
9
+ if (ageInSeconds >= BigInt(MAX_INCLUDE_BY_TIMESTAMP_DURATION) && (highestAgedIndex === undefined || taggingIndex > highestAgedIndex)) {
10
+ highestAgedIndex = taggingIndex;
11
+ }
12
+ if (log.blockNumber <= finalizedBlockNumber && (highestFinalizedIndex === undefined || taggingIndex > highestFinalizedIndex)) {
13
+ highestFinalizedIndex = taggingIndex;
14
+ }
15
+ }
16
+ return {
17
+ highestAgedIndex,
18
+ highestFinalizedIndex
19
+ };
20
+ }
@@ -0,0 +1,14 @@
1
+ import type { BlockNumber } from '@aztec/foundation/branded-types';
2
+ import type { AztecAddress } from '@aztec/stdlib/aztec-address';
3
+ import type { AztecNode } from '@aztec/stdlib/interfaces/client';
4
+ import type { DirectionalAppTaggingSecret, TxScopedL2Log } from '@aztec/stdlib/logs';
5
+ /**
6
+ * Gets private logs with their corresponding block timestamps and tagging indexes for the given index range, `app` and
7
+ * `secret`. At most load logs from blocks up to and including `anchorBlockNumber`. `start` is inclusive and `end` is
8
+ * exclusive.
9
+ */
10
+ export declare function loadLogsForRange(secret: DirectionalAppTaggingSecret, app: AztecAddress, aztecNode: AztecNode, start: number, end: number, anchorBlockNumber: BlockNumber): Promise<Array<{
11
+ log: TxScopedL2Log;
12
+ taggingIndex: number;
13
+ }>>;
14
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9hZF9sb2dzX2Zvcl9yYW5nZS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL3RhZ2dpbmcvcmVjaXBpZW50X3N5bmMvdXRpbHMvbG9hZF9sb2dzX2Zvcl9yYW5nZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxXQUFXLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUNuRSxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUNoRSxPQUFPLEtBQUssRUFBRSxTQUFTLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUNqRSxPQUFPLEtBQUssRUFBRSwyQkFBMkIsRUFBVSxhQUFhLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUc3Rjs7OztHQUlHO0FBQ0gsd0JBQXNCLGdCQUFnQixDQUNwQyxNQUFNLEVBQUUsMkJBQTJCLEVBQ25DLEdBQUcsRUFBRSxZQUFZLEVBQ2pCLFNBQVMsRUFBRSxTQUFTLEVBQ3BCLEtBQUssRUFBRSxNQUFNLEVBQ2IsR0FBRyxFQUFFLE1BQU0sRUFDWCxpQkFBaUIsRUFBRSxXQUFXLEdBQzdCLE9BQU8sQ0FBQyxLQUFLLENBQUM7SUFBRSxHQUFHLEVBQUUsYUFBYSxDQUFDO0lBQUMsWUFBWSxFQUFFLE1BQU0sQ0FBQTtDQUFFLENBQUMsQ0FBQyxDQXdCOUQifQ==
@@ -0,0 +1 @@
1
+ {"version":3,"file":"load_logs_for_range.d.ts","sourceRoot":"","sources":["../../../../src/tagging/recipient_sync/utils/load_logs_for_range.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,KAAK,EAAE,2BAA2B,EAAU,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAG7F;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,2BAA2B,EACnC,GAAG,EAAE,YAAY,EACjB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,iBAAiB,EAAE,WAAW,GAC7B,OAAO,CAAC,KAAK,CAAC;IAAE,GAAG,EAAE,aAAa,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAwB9D"}