@aztec/pxe 0.0.1-commit.f504929 → 0.0.1-commit.f5a9928

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 (537) hide show
  1. package/dest/bin/check_oracle_version.js +41 -112
  2. package/dest/bin/index.d.ts +2 -0
  3. package/dest/bin/index.d.ts.map +1 -0
  4. package/dest/bin/index.js +1 -0
  5. package/dest/bin/oracle_version_helpers.d.ts +34 -0
  6. package/dest/bin/oracle_version_helpers.d.ts.map +1 -0
  7. package/dest/bin/oracle_version_helpers.js +46 -0
  8. package/dest/block_synchronizer/block_stream_source.d.ts +10 -0
  9. package/dest/block_synchronizer/block_stream_source.d.ts.map +1 -0
  10. package/dest/block_synchronizer/block_stream_source.js +37 -0
  11. package/dest/block_synchronizer/block_synchronizer.d.ts +22 -16
  12. package/dest/block_synchronizer/block_synchronizer.d.ts.map +1 -1
  13. package/dest/block_synchronizer/block_synchronizer.js +71 -28
  14. package/dest/config/index.d.ts +9 -2
  15. package/dest/config/index.d.ts.map +1 -1
  16. package/dest/config/index.js +14 -15
  17. package/dest/config/package_info.js +1 -1
  18. package/dest/contract/contract_class_service.d.ts +24 -0
  19. package/dest/contract/contract_class_service.d.ts.map +1 -0
  20. package/dest/contract/contract_class_service.js +36 -0
  21. package/dest/contract/contract_sync_service.d.ts +48 -0
  22. package/dest/contract/contract_sync_service.d.ts.map +1 -0
  23. package/dest/contract/contract_sync_service.js +119 -0
  24. package/dest/contract/helpers.d.ts +7 -0
  25. package/dest/contract/helpers.d.ts.map +1 -0
  26. package/dest/contract/helpers.js +20 -0
  27. package/dest/contract/skip_sync_contracts.d.ts +11 -0
  28. package/dest/contract/skip_sync_contracts.d.ts.map +1 -0
  29. package/dest/contract/skip_sync_contracts.js +18 -0
  30. package/dest/contract_function_simulator/anchored_contract_data.d.ts +36 -0
  31. package/dest/contract_function_simulator/anchored_contract_data.d.ts.map +1 -0
  32. package/dest/contract_function_simulator/anchored_contract_data.js +54 -0
  33. package/dest/contract_function_simulator/contract_function_simulator.d.ts +30 -25
  34. package/dest/contract_function_simulator/contract_function_simulator.d.ts.map +1 -1
  35. package/dest/contract_function_simulator/contract_function_simulator.js +114 -66
  36. package/dest/contract_function_simulator/ephemeral_array_service.d.ts +28 -0
  37. package/dest/contract_function_simulator/ephemeral_array_service.d.ts.map +1 -0
  38. package/dest/contract_function_simulator/ephemeral_array_service.js +78 -0
  39. package/dest/contract_function_simulator/execution_note_cache.d.ts +4 -10
  40. package/dest/contract_function_simulator/execution_note_cache.d.ts.map +1 -1
  41. package/dest/contract_function_simulator/execution_note_cache.js +10 -29
  42. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts +7 -11
  43. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts.map +1 -1
  44. package/dest/contract_function_simulator/execution_tagging_index_cache.js +19 -15
  45. package/dest/contract_function_simulator/index.d.ts +26 -5
  46. package/dest/contract_function_simulator/index.d.ts.map +1 -1
  47. package/dest/contract_function_simulator/index.js +11 -3
  48. package/dest/contract_function_simulator/noir-structs/bounded_vec.d.ts +29 -0
  49. package/dest/contract_function_simulator/noir-structs/bounded_vec.d.ts.map +1 -0
  50. package/dest/contract_function_simulator/noir-structs/bounded_vec.js +30 -0
  51. package/dest/contract_function_simulator/noir-structs/contract_class_log_data.d.ts +9 -0
  52. package/dest/contract_function_simulator/noir-structs/contract_class_log_data.d.ts.map +1 -0
  53. package/dest/contract_function_simulator/noir-structs/contract_class_log_data.js +1 -0
  54. package/dest/contract_function_simulator/noir-structs/embedded_curve_point.d.ts +7 -0
  55. package/dest/contract_function_simulator/noir-structs/embedded_curve_point.d.ts.map +1 -0
  56. package/dest/contract_function_simulator/noir-structs/embedded_curve_point.js +1 -0
  57. package/dest/contract_function_simulator/noir-structs/ephemeral_array.d.ts +37 -0
  58. package/dest/contract_function_simulator/noir-structs/ephemeral_array.d.ts.map +1 -0
  59. package/dest/contract_function_simulator/noir-structs/ephemeral_array.js +59 -0
  60. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts +3 -4
  61. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts.map +1 -1
  62. package/dest/contract_function_simulator/noir-structs/event_validation_request.js +9 -10
  63. package/dest/contract_function_simulator/noir-structs/fact.d.ts +16 -0
  64. package/dest/contract_function_simulator/noir-structs/fact.d.ts.map +1 -0
  65. package/dest/contract_function_simulator/noir-structs/fact.js +6 -0
  66. package/dest/contract_function_simulator/noir-structs/fact_collection.d.ts +27 -0
  67. package/dest/contract_function_simulator/noir-structs/fact_collection.d.ts.map +1 -0
  68. package/dest/contract_function_simulator/noir-structs/fact_collection.js +31 -0
  69. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.d.ts +19 -10
  70. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.d.ts.map +1 -1
  71. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.js +12 -24
  72. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts +11 -9
  73. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts.map +1 -1
  74. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.js +2 -63
  75. package/dest/contract_function_simulator/noir-structs/note_data.d.ts +27 -0
  76. package/dest/contract_function_simulator/noir-structs/note_data.d.ts.map +1 -0
  77. package/dest/contract_function_simulator/noir-structs/note_data.js +3 -0
  78. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts +3 -5
  79. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts.map +1 -1
  80. package/dest/contract_function_simulator/noir-structs/note_validation_request.js +8 -12
  81. package/dest/contract_function_simulator/noir-structs/option.d.ts +59 -0
  82. package/dest/contract_function_simulator/noir-structs/option.d.ts.map +1 -0
  83. package/dest/contract_function_simulator/noir-structs/option.js +67 -0
  84. package/dest/contract_function_simulator/noir-structs/origin_block.d.ts +11 -0
  85. package/dest/contract_function_simulator/noir-structs/origin_block.d.ts.map +1 -0
  86. package/dest/contract_function_simulator/noir-structs/origin_block.js +5 -0
  87. package/dest/contract_function_simulator/noir-structs/pending_tagged_log.d.ts +11 -0
  88. package/dest/contract_function_simulator/noir-structs/pending_tagged_log.d.ts.map +1 -0
  89. package/dest/contract_function_simulator/noir-structs/pending_tagged_log.js +4 -0
  90. package/dest/contract_function_simulator/noir-structs/provided_secret.d.ts +8 -0
  91. package/dest/contract_function_simulator/noir-structs/provided_secret.d.ts.map +1 -0
  92. package/dest/contract_function_simulator/noir-structs/provided_secret.js +1 -0
  93. package/dest/contract_function_simulator/noir-structs/resolved_tagging_strategy.d.ts +28 -0
  94. package/dest/contract_function_simulator/noir-structs/resolved_tagging_strategy.d.ts.map +1 -0
  95. package/dest/contract_function_simulator/noir-structs/resolved_tagging_strategy.js +50 -0
  96. package/dest/contract_function_simulator/noir-structs/resolved_tx.d.ts +19 -0
  97. package/dest/contract_function_simulator/noir-structs/resolved_tx.d.ts.map +1 -0
  98. package/dest/contract_function_simulator/noir-structs/resolved_tx.js +9 -0
  99. package/dest/contract_function_simulator/noir-structs/tx_effect_data.d.ts +15 -0
  100. package/dest/contract_function_simulator/noir-structs/tx_effect_data.d.ts.map +1 -0
  101. package/dest/contract_function_simulator/noir-structs/tx_effect_data.js +5 -0
  102. package/dest/contract_function_simulator/noir-structs/utility_context.d.ts +6 -11
  103. package/dest/contract_function_simulator/noir-structs/utility_context.d.ts.map +1 -1
  104. package/dest/contract_function_simulator/noir-structs/utility_context.js +1 -20
  105. package/dest/contract_function_simulator/oracle/acir_callback.d.ts +21 -0
  106. package/dest/contract_function_simulator/oracle/acir_callback.d.ts.map +1 -0
  107. package/dest/contract_function_simulator/oracle/acir_callback.js +115 -0
  108. package/dest/contract_function_simulator/oracle/index.d.ts +2 -13
  109. package/dest/contract_function_simulator/oracle/index.d.ts.map +1 -1
  110. package/dest/contract_function_simulator/oracle/index.js +1 -1
  111. package/dest/contract_function_simulator/oracle/interfaces.d.ts +15 -98
  112. package/dest/contract_function_simulator/oracle/interfaces.d.ts.map +1 -1
  113. package/dest/contract_function_simulator/oracle/interfaces.js +2 -2
  114. package/dest/contract_function_simulator/oracle/legacy_oracle_registry.d.ts +39 -0
  115. package/dest/contract_function_simulator/oracle/legacy_oracle_registry.d.ts.map +1 -0
  116. package/dest/contract_function_simulator/oracle/legacy_oracle_registry.js +107 -0
  117. package/dest/contract_function_simulator/oracle/message_load_oracle_inputs.d.ts +3 -14
  118. package/dest/contract_function_simulator/oracle/message_load_oracle_inputs.d.ts.map +1 -1
  119. package/dest/contract_function_simulator/oracle/message_load_oracle_inputs.js +1 -24
  120. package/dest/contract_function_simulator/oracle/note_packing_utils.d.ts +2 -2
  121. package/dest/contract_function_simulator/oracle/note_packing_utils.d.ts.map +1 -1
  122. package/dest/contract_function_simulator/oracle/note_packing_utils.js +2 -2
  123. package/dest/contract_function_simulator/oracle/oracle_registry.d.ts +139 -0
  124. package/dest/contract_function_simulator/oracle/oracle_registry.d.ts.map +1 -0
  125. package/dest/contract_function_simulator/oracle/oracle_registry.js +1016 -0
  126. package/dest/contract_function_simulator/oracle/oracle_type_mappings.d.ts +274 -0
  127. package/dest/contract_function_simulator/oracle/oracle_type_mappings.d.ts.map +1 -0
  128. package/dest/contract_function_simulator/oracle/oracle_type_mappings.js +1243 -0
  129. package/dest/contract_function_simulator/oracle/private_execution.d.ts +1 -1
  130. package/dest/contract_function_simulator/oracle/private_execution.d.ts.map +1 -1
  131. package/dest/contract_function_simulator/oracle/private_execution.js +7 -6
  132. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts +56 -71
  133. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts.map +1 -1
  134. package/dest/contract_function_simulator/oracle/private_execution_oracle.js +200 -99
  135. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts +183 -76
  136. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts.map +1 -1
  137. package/dest/contract_function_simulator/oracle/utility_execution_oracle.js +662 -156
  138. package/dest/contract_function_simulator/pick_notes.d.ts +1 -1
  139. package/dest/contract_function_simulator/pick_notes.d.ts.map +1 -1
  140. package/dest/contract_function_simulator/pick_notes.js +20 -3
  141. package/dest/contract_function_simulator/transient_array_service.d.ts +31 -0
  142. package/dest/contract_function_simulator/transient_array_service.d.ts.map +1 -0
  143. package/dest/contract_function_simulator/transient_array_service.js +62 -0
  144. package/dest/contract_logging.d.ts +9 -4
  145. package/dest/contract_logging.d.ts.map +1 -1
  146. package/dest/contract_logging.js +21 -6
  147. package/dest/debug/pxe_debug_utils.d.ts +4 -9
  148. package/dest/debug/pxe_debug_utils.d.ts.map +1 -1
  149. package/dest/debug/pxe_debug_utils.js +0 -6
  150. package/dest/entrypoints/client/bundle/index.d.ts +2 -2
  151. package/dest/entrypoints/client/bundle/index.d.ts.map +1 -1
  152. package/dest/entrypoints/client/bundle/index.js +1 -1
  153. package/dest/entrypoints/client/bundle/utils.d.ts +2 -2
  154. package/dest/entrypoints/client/bundle/utils.d.ts.map +1 -1
  155. package/dest/entrypoints/client/bundle/utils.js +21 -8
  156. package/dest/entrypoints/client/lazy/index.d.ts +2 -2
  157. package/dest/entrypoints/client/lazy/index.d.ts.map +1 -1
  158. package/dest/entrypoints/client/lazy/index.js +1 -1
  159. package/dest/entrypoints/client/lazy/utils.d.ts +2 -2
  160. package/dest/entrypoints/client/lazy/utils.d.ts.map +1 -1
  161. package/dest/entrypoints/client/lazy/utils.js +21 -8
  162. package/dest/entrypoints/client/store.d.ts +14 -0
  163. package/dest/entrypoints/client/store.d.ts.map +1 -0
  164. package/dest/entrypoints/client/store.js +42 -0
  165. package/dest/entrypoints/pxe_creation_options.d.ts +16 -2
  166. package/dest/entrypoints/pxe_creation_options.d.ts.map +1 -1
  167. package/dest/entrypoints/pxe_creation_options.js +3 -1
  168. package/dest/entrypoints/server/index.d.ts +7 -4
  169. package/dest/entrypoints/server/index.d.ts.map +1 -1
  170. package/dest/entrypoints/server/index.js +5 -3
  171. package/dest/entrypoints/server/store.d.ts +18 -0
  172. package/dest/entrypoints/server/store.d.ts.map +1 -0
  173. package/dest/entrypoints/server/store.js +28 -0
  174. package/dest/entrypoints/server/utils.d.ts +4 -3
  175. package/dest/entrypoints/server/utils.d.ts.map +1 -1
  176. package/dest/entrypoints/server/utils.js +22 -8
  177. package/dest/error_enriching.d.ts +5 -3
  178. package/dest/error_enriching.d.ts.map +1 -1
  179. package/dest/error_enriching.js +15 -12
  180. package/dest/events/event_service.d.ts +21 -5
  181. package/dest/events/event_service.d.ts.map +1 -1
  182. package/dest/events/event_service.js +51 -17
  183. package/dest/events/private_event_filter_validator.d.ts +3 -2
  184. package/dest/events/private_event_filter_validator.d.ts.map +1 -1
  185. package/dest/events/private_event_filter_validator.js +15 -0
  186. package/dest/hooks/authorize_utility_call.d.ts +41 -0
  187. package/dest/hooks/authorize_utility_call.d.ts.map +1 -0
  188. package/dest/hooks/authorize_utility_call.js +4 -0
  189. package/dest/hooks/execution_hooks.d.ts +62 -0
  190. package/dest/hooks/execution_hooks.d.ts.map +1 -0
  191. package/dest/hooks/execution_hooks.js +9 -0
  192. package/dest/hooks/index.d.ts +5 -0
  193. package/dest/hooks/index.d.ts.map +1 -0
  194. package/dest/hooks/index.js +2 -0
  195. package/dest/hooks/resolve_custom_request.d.ts +23 -0
  196. package/dest/hooks/resolve_custom_request.d.ts.map +1 -0
  197. package/dest/hooks/resolve_custom_request.js +3 -0
  198. package/dest/hooks/resolve_tagging_secret_strategy.d.ts +50 -0
  199. package/dest/hooks/resolve_tagging_secret_strategy.d.ts.map +1 -0
  200. package/dest/hooks/resolve_tagging_secret_strategy.js +3 -0
  201. package/dest/logs/log_service.d.ts +21 -11
  202. package/dest/logs/log_service.d.ts.map +1 -1
  203. package/dest/logs/log_service.js +181 -82
  204. package/dest/messages/tx_resolver_service.d.ts +28 -0
  205. package/dest/messages/tx_resolver_service.d.ts.map +1 -0
  206. package/dest/messages/tx_resolver_service.js +62 -0
  207. package/dest/node/benchmarked_node.d.ts +20 -0
  208. package/dest/node/benchmarked_node.d.ts.map +1 -0
  209. package/dest/node/benchmarked_node.js +94 -0
  210. package/dest/node/caching_aztec_node.d.ts +24 -0
  211. package/dest/node/caching_aztec_node.d.ts.map +1 -0
  212. package/dest/node/caching_aztec_node.js +268 -0
  213. package/dest/notes/note_service.d.ts +34 -7
  214. package/dest/notes/note_service.d.ts.map +1 -1
  215. package/dest/notes/note_service.js +82 -57
  216. package/dest/notes_filter.d.ts +2 -3
  217. package/dest/notes_filter.d.ts.map +1 -1
  218. package/dest/oracle_version.d.ts +4 -3
  219. package/dest/oracle_version.d.ts.map +1 -1
  220. package/dest/oracle_version.js +20 -10
  221. package/dest/private_kernel/batch_planner.d.ts +47 -0
  222. package/dest/private_kernel/batch_planner.d.ts.map +1 -0
  223. package/dest/private_kernel/batch_planner.js +104 -0
  224. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts +1 -1
  225. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts.map +1 -1
  226. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.js +10 -5
  227. package/dest/private_kernel/hints/test_utils.d.ts +1 -1
  228. package/dest/private_kernel/hints/test_utils.d.ts.map +1 -1
  229. package/dest/private_kernel/hints/test_utils.js +3 -4
  230. package/dest/private_kernel/private_kernel_execution_prover.d.ts +6 -2
  231. package/dest/private_kernel/private_kernel_execution_prover.d.ts.map +1 -1
  232. package/dest/private_kernel/private_kernel_execution_prover.js +160 -85
  233. package/dest/private_kernel/private_kernel_oracle.d.ts +12 -10
  234. package/dest/private_kernel/private_kernel_oracle.d.ts.map +1 -1
  235. package/dest/private_kernel/private_kernel_oracle.js +40 -26
  236. package/dest/pxe.d.ts +169 -54
  237. package/dest/pxe.d.ts.map +1 -1
  238. package/dest/pxe.js +378 -213
  239. package/dest/storage/address_store/address_store.d.ts +1 -1
  240. package/dest/storage/address_store/address_store.d.ts.map +1 -1
  241. package/dest/storage/address_store/address_store.js +2 -1
  242. package/dest/storage/allowed_scopes.d.ts +6 -0
  243. package/dest/storage/allowed_scopes.d.ts.map +1 -0
  244. package/dest/storage/allowed_scopes.js +7 -0
  245. package/dest/storage/anchor_block_store/anchor_block_store.d.ts +9 -6
  246. package/dest/storage/anchor_block_store/anchor_block_store.d.ts.map +1 -1
  247. package/dest/storage/anchor_block_store/anchor_block_store.js +9 -7
  248. package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.d.ts +42 -0
  249. package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.d.ts.map +1 -0
  250. package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.js +93 -0
  251. package/dest/storage/backwards_compatibility_tests/schema_tests.d.ts +15 -0
  252. package/dest/storage/backwards_compatibility_tests/schema_tests.d.ts.map +1 -0
  253. package/dest/storage/backwards_compatibility_tests/schema_tests.js +671 -0
  254. package/dest/storage/backwards_compatibility_tests/store_spy.d.ts +19 -0
  255. package/dest/storage/backwards_compatibility_tests/store_spy.d.ts.map +1 -0
  256. package/dest/storage/backwards_compatibility_tests/store_spy.js +63 -0
  257. package/dest/storage/capsule_store/capsule_service.d.ts +21 -0
  258. package/dest/storage/capsule_store/capsule_service.d.ts.map +1 -0
  259. package/dest/storage/capsule_store/capsule_service.js +47 -0
  260. package/dest/storage/capsule_store/capsule_store.d.ts +9 -9
  261. package/dest/storage/capsule_store/capsule_store.d.ts.map +1 -1
  262. package/dest/storage/capsule_store/capsule_store.js +37 -29
  263. package/dest/storage/capsule_store/index.d.ts +2 -1
  264. package/dest/storage/capsule_store/index.d.ts.map +1 -1
  265. package/dest/storage/capsule_store/index.js +1 -0
  266. package/dest/storage/contract_store/contract_store.d.ts +27 -24
  267. package/dest/storage/contract_store/contract_store.d.ts.map +1 -1
  268. package/dest/storage/contract_store/contract_store.js +72 -99
  269. package/dest/storage/contract_store/private_functions_tree.d.ts +1 -1
  270. package/dest/storage/contract_store/private_functions_tree.d.ts.map +1 -1
  271. package/dest/storage/contract_store/private_functions_tree.js +2 -1
  272. package/dest/storage/fact_store/fact_service.d.ts +22 -0
  273. package/dest/storage/fact_store/fact_service.d.ts.map +1 -0
  274. package/dest/storage/fact_store/fact_service.js +45 -0
  275. package/dest/storage/fact_store/fact_store.d.ts +95 -0
  276. package/dest/storage/fact_store/fact_store.d.ts.map +1 -0
  277. package/dest/storage/fact_store/fact_store.js +411 -0
  278. package/dest/storage/fact_store/fact_store_keys.d.ts +34 -0
  279. package/dest/storage/fact_store/fact_store_keys.d.ts.map +1 -0
  280. package/dest/storage/fact_store/fact_store_keys.js +50 -0
  281. package/dest/storage/fact_store/index.d.ts +6 -0
  282. package/dest/storage/fact_store/index.d.ts.map +1 -0
  283. package/dest/storage/fact_store/index.js +4 -0
  284. package/dest/storage/fact_store/origin_state.d.ts +59 -0
  285. package/dest/storage/fact_store/origin_state.d.ts.map +1 -0
  286. package/dest/storage/fact_store/origin_state.js +60 -0
  287. package/dest/storage/fact_store/stored_fact.d.ts +32 -0
  288. package/dest/storage/fact_store/stored_fact.d.ts.map +1 -0
  289. package/dest/storage/fact_store/stored_fact.js +64 -0
  290. package/dest/storage/index.d.ts +3 -2
  291. package/dest/storage/index.d.ts.map +1 -1
  292. package/dest/storage/index.js +2 -1
  293. package/dest/storage/metadata.d.ts +2 -2
  294. package/dest/storage/metadata.d.ts.map +1 -1
  295. package/dest/storage/metadata.js +1 -1
  296. package/dest/storage/note_store/note_store.d.ts +42 -33
  297. package/dest/storage/note_store/note_store.d.ts.map +1 -1
  298. package/dest/storage/note_store/note_store.js +202 -172
  299. package/dest/storage/note_store/stored_note.d.ts +3 -8
  300. package/dest/storage/note_store/stored_note.d.ts.map +1 -1
  301. package/dest/storage/note_store/stored_note.js +4 -20
  302. package/dest/storage/open_pxe_stores.d.ts +35 -0
  303. package/dest/storage/open_pxe_stores.d.ts.map +1 -0
  304. package/dest/storage/open_pxe_stores.js +29 -0
  305. package/dest/storage/private_event_store/private_event_store.d.ts +13 -16
  306. package/dest/storage/private_event_store/private_event_store.d.ts.map +1 -1
  307. package/dest/storage/private_event_store/private_event_store.js +48 -45
  308. package/dest/storage/private_event_store/stored_private_event.js +1 -1
  309. package/dest/storage/store_identity.d.ts +35 -0
  310. package/dest/storage/store_identity.d.ts.map +1 -0
  311. package/dest/storage/store_identity.js +44 -0
  312. package/dest/storage/tagging_store/index.d.ts +2 -2
  313. package/dest/storage/tagging_store/index.d.ts.map +1 -1
  314. package/dest/storage/tagging_store/index.js +1 -1
  315. package/dest/storage/tagging_store/recipient_tagging_store.d.ts +6 -6
  316. package/dest/storage/tagging_store/recipient_tagging_store.d.ts.map +1 -1
  317. package/dest/storage/tagging_store/sender_tagging_store.d.ts +63 -31
  318. package/dest/storage/tagging_store/sender_tagging_store.d.ts.map +1 -1
  319. package/dest/storage/tagging_store/sender_tagging_store.js +210 -129
  320. package/dest/storage/tagging_store/tagging_secret_sources_store.d.ts +51 -0
  321. package/dest/storage/tagging_store/tagging_secret_sources_store.d.ts.map +1 -0
  322. package/dest/storage/tagging_store/tagging_secret_sources_store.js +105 -0
  323. package/dest/tagging/constants.d.ts +11 -2
  324. package/dest/tagging/constants.d.ts.map +1 -1
  325. package/dest/tagging/constants.js +38 -10
  326. package/dest/tagging/get_all_logs_by_tags.d.ts +55 -10
  327. package/dest/tagging/get_all_logs_by_tags.d.ts.map +1 -1
  328. package/dest/tagging/get_all_logs_by_tags.js +55 -36
  329. package/dest/tagging/index.d.ts +8 -7
  330. package/dest/tagging/index.d.ts.map +1 -1
  331. package/dest/tagging/index.js +6 -5
  332. package/dest/tagging/persist_sender_tagging_index_ranges.d.ts +29 -0
  333. package/dest/tagging/persist_sender_tagging_index_ranges.d.ts.map +1 -0
  334. package/dest/tagging/persist_sender_tagging_index_ranges.js +42 -0
  335. package/dest/tagging/recipient_sync/sync_tagged_private_logs.d.ts +74 -0
  336. package/dest/tagging/recipient_sync/sync_tagged_private_logs.d.ts.map +1 -0
  337. package/dest/tagging/recipient_sync/sync_tagged_private_logs.js +235 -0
  338. package/dest/tagging/recipient_sync/utils/find_highest_indexes.d.ts +3 -3
  339. package/dest/tagging/recipient_sync/utils/find_highest_indexes.d.ts.map +1 -1
  340. package/dest/tagging/reconcile_tagging_index_ranges.d.ts +36 -0
  341. package/dest/tagging/reconcile_tagging_index_ranges.d.ts.map +1 -0
  342. package/dest/tagging/reconcile_tagging_index_ranges.js +74 -0
  343. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts +8 -6
  344. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts.map +1 -1
  345. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.js +25 -19
  346. package/dest/tagging/sender_sync/utils/classify_pending_txs.d.ts +22 -0
  347. package/dest/tagging/sender_sync/utils/classify_pending_txs.d.ts.map +1 -0
  348. package/dest/tagging/sender_sync/utils/classify_pending_txs.js +62 -0
  349. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts +17 -6
  350. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts.map +1 -1
  351. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.js +46 -31
  352. package/dest/tagging/sender_sync/utils/resolve_pending_txs.d.ts +29 -0
  353. package/dest/tagging/sender_sync/utils/resolve_pending_txs.d.ts.map +1 -0
  354. package/dest/tagging/sender_sync/utils/resolve_pending_txs.js +42 -0
  355. package/dest/tagging/sender_sync/utils/test_utils.d.ts +16 -0
  356. package/dest/tagging/sender_sync/utils/test_utils.d.ts.map +1 -0
  357. package/dest/tagging/sender_sync/utils/test_utils.js +24 -0
  358. package/dest/tagging/testing/tag_query_test_utils.d.ts +6 -0
  359. package/dest/tagging/testing/tag_query_test_utils.d.ts.map +1 -0
  360. package/dest/tagging/testing/tag_query_test_utils.js +10 -0
  361. package/package.json +20 -17
  362. package/src/bin/check_oracle_version.ts +46 -135
  363. package/src/bin/index.ts +1 -0
  364. package/src/bin/oracle_version_helpers.ts +54 -0
  365. package/src/block_synchronizer/block_stream_source.ts +42 -0
  366. package/src/block_synchronizer/block_synchronizer.ts +86 -40
  367. package/src/config/index.ts +16 -9
  368. package/src/config/package_info.ts +1 -1
  369. package/src/contract/contract_class_service.ts +45 -0
  370. package/src/contract/contract_sync_service.ts +179 -0
  371. package/src/contract/helpers.ts +35 -0
  372. package/src/contract/skip_sync_contracts.ts +23 -0
  373. package/src/contract_function_simulator/anchored_contract_data.ts +74 -0
  374. package/src/contract_function_simulator/contract_function_simulator.ts +178 -82
  375. package/src/contract_function_simulator/ephemeral_array_service.ts +110 -0
  376. package/src/contract_function_simulator/execution_note_cache.ts +10 -30
  377. package/src/contract_function_simulator/execution_tagging_index_cache.ts +19 -18
  378. package/src/contract_function_simulator/index.ts +89 -4
  379. package/src/contract_function_simulator/noir-structs/bounded_vec.ts +43 -0
  380. package/src/contract_function_simulator/noir-structs/contract_class_log_data.ts +9 -0
  381. package/src/contract_function_simulator/noir-structs/embedded_curve_point.ts +4 -0
  382. package/src/contract_function_simulator/noir-structs/ephemeral_array.ts +66 -0
  383. package/src/contract_function_simulator/noir-structs/event_validation_request.ts +10 -9
  384. package/src/contract_function_simulator/noir-structs/fact.ts +13 -0
  385. package/src/contract_function_simulator/noir-structs/fact_collection.ts +64 -0
  386. package/src/contract_function_simulator/noir-structs/log_retrieval_request.ts +27 -20
  387. package/src/contract_function_simulator/noir-structs/log_retrieval_response.ts +14 -64
  388. package/src/contract_function_simulator/noir-structs/note_data.ts +27 -0
  389. package/src/contract_function_simulator/noir-structs/note_validation_request.ts +6 -11
  390. package/src/contract_function_simulator/noir-structs/option.ts +75 -0
  391. package/src/contract_function_simulator/noir-structs/origin_block.ts +8 -0
  392. package/src/contract_function_simulator/noir-structs/pending_tagged_log.ts +12 -0
  393. package/src/contract_function_simulator/noir-structs/provided_secret.ts +5 -0
  394. package/src/contract_function_simulator/noir-structs/resolved_tagging_strategy.ts +66 -0
  395. package/src/contract_function_simulator/noir-structs/resolved_tx.ts +19 -0
  396. package/src/contract_function_simulator/noir-structs/tx_effect_data.ts +16 -0
  397. package/src/contract_function_simulator/noir-structs/utility_context.ts +5 -17
  398. package/src/contract_function_simulator/oracle/acir_callback.ts +154 -0
  399. package/src/contract_function_simulator/oracle/index.ts +1 -15
  400. package/src/contract_function_simulator/oracle/interfaces.ts +11 -176
  401. package/src/contract_function_simulator/oracle/legacy_oracle_registry.ts +147 -0
  402. package/src/contract_function_simulator/oracle/message_load_oracle_inputs.ts +6 -21
  403. package/src/contract_function_simulator/oracle/note_packing_utils.ts +3 -3
  404. package/src/contract_function_simulator/oracle/oracle_registry.ts +710 -0
  405. package/src/contract_function_simulator/oracle/oracle_type_mappings.ts +1052 -0
  406. package/src/contract_function_simulator/oracle/private_execution.ts +6 -7
  407. package/src/contract_function_simulator/oracle/private_execution_oracle.ts +249 -132
  408. package/src/contract_function_simulator/oracle/utility_execution_oracle.ts +978 -249
  409. package/src/contract_function_simulator/pick_notes.ts +22 -3
  410. package/src/contract_function_simulator/transient_array_service.ts +91 -0
  411. package/src/contract_logging.ts +18 -5
  412. package/src/debug/pxe_debug_utils.ts +4 -12
  413. package/src/entrypoints/client/bundle/index.ts +1 -1
  414. package/src/entrypoints/client/bundle/utils.ts +26 -8
  415. package/src/entrypoints/client/lazy/index.ts +1 -1
  416. package/src/entrypoints/client/lazy/utils.ts +26 -8
  417. package/src/entrypoints/client/store.ts +54 -0
  418. package/src/entrypoints/pxe_creation_options.ts +21 -1
  419. package/src/entrypoints/server/index.ts +7 -3
  420. package/src/entrypoints/server/store.ts +47 -0
  421. package/src/entrypoints/server/utils.ts +39 -14
  422. package/src/error_enriching.ts +30 -13
  423. package/src/events/event_service.ts +85 -26
  424. package/src/events/private_event_filter_validator.ts +21 -1
  425. package/src/hooks/authorize_utility_call.ts +44 -0
  426. package/src/hooks/execution_hooks.ts +68 -0
  427. package/src/hooks/index.ts +13 -0
  428. package/src/hooks/resolve_custom_request.ts +24 -0
  429. package/src/hooks/resolve_tagging_secret_strategy.ts +60 -0
  430. package/src/logs/log_service.ts +228 -147
  431. package/src/messages/tx_resolver_service.ts +81 -0
  432. package/src/node/benchmarked_node.ts +140 -0
  433. package/src/node/caching_aztec_node.ts +407 -0
  434. package/src/notes/note_service.ts +127 -86
  435. package/src/notes_filter.ts +1 -3
  436. package/src/oracle_version.ts +20 -10
  437. package/src/private_kernel/batch_planner.ts +169 -0
  438. package/src/private_kernel/hints/private_kernel_reset_private_inputs_builder.ts +15 -4
  439. package/src/private_kernel/hints/test_utils.ts +3 -10
  440. package/src/private_kernel/private_kernel_execution_prover.ts +246 -117
  441. package/src/private_kernel/private_kernel_oracle.ts +58 -29
  442. package/src/pxe.ts +595 -245
  443. package/src/storage/address_store/address_store.ts +2 -1
  444. package/src/storage/allowed_scopes.ts +14 -0
  445. package/src/storage/anchor_block_store/anchor_block_store.ts +9 -7
  446. package/src/storage/backwards_compatibility_tests/__snapshots__/AddressStore.json +22 -0
  447. package/src/storage/backwards_compatibility_tests/__snapshots__/AnchorBlockStore.json +3 -0
  448. package/src/storage/backwards_compatibility_tests/__snapshots__/CapsuleStore.json +16 -0
  449. package/src/storage/backwards_compatibility_tests/__snapshots__/ContractStore.json +28 -0
  450. package/src/storage/backwards_compatibility_tests/__snapshots__/FactStore.json +40 -0
  451. package/src/storage/backwards_compatibility_tests/__snapshots__/KeyStore.json +52 -0
  452. package/src/storage/backwards_compatibility_tests/__snapshots__/L2TipsKVStore.json +40 -0
  453. package/src/storage/backwards_compatibility_tests/__snapshots__/NoteStore.json +56 -0
  454. package/src/storage/backwards_compatibility_tests/__snapshots__/PrivateEventStore.json +44 -0
  455. package/src/storage/backwards_compatibility_tests/__snapshots__/RecipientTaggingStore.json +26 -0
  456. package/src/storage/backwards_compatibility_tests/__snapshots__/SenderTaggingStore.json +30 -0
  457. package/src/storage/backwards_compatibility_tests/__snapshots__/TaggingSecretSourcesStore.json +30 -0
  458. package/src/storage/backwards_compatibility_tests/__snapshots__/opened_stores.json +117 -0
  459. package/src/storage/backwards_compatibility_tests/kv_store_snapshot.ts +122 -0
  460. package/src/storage/backwards_compatibility_tests/schema_tests.ts +803 -0
  461. package/src/storage/backwards_compatibility_tests/store_spy.ts +73 -0
  462. package/src/storage/capsule_store/capsule_service.ts +85 -0
  463. package/src/storage/capsule_store/capsule_store.ts +45 -27
  464. package/src/storage/capsule_store/index.ts +1 -0
  465. package/src/storage/contract_store/contract_store.ts +98 -125
  466. package/src/storage/contract_store/private_functions_tree.ts +2 -1
  467. package/src/storage/fact_store/fact_service.ts +69 -0
  468. package/src/storage/fact_store/fact_store.ts +488 -0
  469. package/src/storage/fact_store/fact_store_keys.ts +75 -0
  470. package/src/storage/fact_store/index.ts +15 -0
  471. package/src/storage/fact_store/origin_state.ts +84 -0
  472. package/src/storage/fact_store/stored_fact.ts +80 -0
  473. package/src/storage/index.ts +2 -1
  474. package/src/storage/metadata.ts +1 -1
  475. package/src/storage/note_store/note_store.ts +233 -194
  476. package/src/storage/note_store/stored_note.ts +5 -27
  477. package/src/storage/open_pxe_stores.ts +52 -0
  478. package/src/storage/private_event_store/private_event_store.ts +55 -56
  479. package/src/storage/private_event_store/stored_private_event.ts +1 -1
  480. package/src/storage/store_identity.ts +72 -0
  481. package/src/storage/tagging_store/index.ts +1 -1
  482. package/src/storage/tagging_store/recipient_tagging_store.ts +5 -9
  483. package/src/storage/tagging_store/sender_tagging_store.ts +278 -158
  484. package/src/storage/tagging_store/tagging_secret_sources_store.ts +138 -0
  485. package/src/tagging/constants.ts +42 -10
  486. package/src/tagging/get_all_logs_by_tags.ts +115 -50
  487. package/src/tagging/index.ts +12 -6
  488. package/src/tagging/persist_sender_tagging_index_ranges.ts +57 -0
  489. package/src/tagging/recipient_sync/sync_tagged_private_logs.ts +356 -0
  490. package/src/tagging/recipient_sync/utils/find_highest_indexes.ts +2 -2
  491. package/src/tagging/reconcile_tagging_index_ranges.ts +102 -0
  492. package/src/tagging/sender_sync/sync_sender_tagging_indexes.ts +32 -22
  493. package/src/tagging/sender_sync/utils/classify_pending_txs.ts +92 -0
  494. package/src/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.ts +55 -39
  495. package/src/tagging/sender_sync/utils/resolve_pending_txs.ts +65 -0
  496. package/src/tagging/sender_sync/utils/test_utils.ts +46 -0
  497. package/src/tagging/testing/tag_query_test_utils.ts +11 -0
  498. package/dest/access_scopes.d.ts +0 -9
  499. package/dest/access_scopes.d.ts.map +0 -1
  500. package/dest/access_scopes.js +0 -6
  501. package/dest/contract_function_simulator/benchmarked_node.d.ts +0 -9
  502. package/dest/contract_function_simulator/benchmarked_node.d.ts.map +0 -1
  503. package/dest/contract_function_simulator/benchmarked_node.js +0 -77
  504. package/dest/contract_function_simulator/oracle/oracle.d.ts +0 -60
  505. package/dest/contract_function_simulator/oracle/oracle.d.ts.map +0 -1
  506. package/dest/contract_function_simulator/oracle/oracle.js +0 -411
  507. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts +0 -6
  508. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts.map +0 -1
  509. package/dest/contract_function_simulator/proxied_contract_data_source.js +0 -80
  510. package/dest/contract_sync/contract_sync_service.d.ts +0 -43
  511. package/dest/contract_sync/contract_sync_service.d.ts.map +0 -1
  512. package/dest/contract_sync/contract_sync_service.js +0 -97
  513. package/dest/contract_sync/helpers.d.ts +0 -29
  514. package/dest/contract_sync/helpers.d.ts.map +0 -1
  515. package/dest/contract_sync/helpers.js +0 -55
  516. package/dest/storage/tagging_store/sender_address_book_store.d.ts +0 -14
  517. package/dest/storage/tagging_store/sender_address_book_store.d.ts.map +0 -1
  518. package/dest/storage/tagging_store/sender_address_book_store.js +0 -36
  519. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts +0 -14
  520. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts.map +0 -1
  521. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.js +0 -99
  522. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts +0 -14
  523. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts.map +0 -1
  524. package/dest/tagging/recipient_sync/utils/load_logs_for_range.js +0 -33
  525. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts +0 -11
  526. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts.map +0 -1
  527. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.js +0 -29
  528. package/src/access_scopes.ts +0 -9
  529. package/src/contract_function_simulator/benchmarked_node.ts +0 -103
  530. package/src/contract_function_simulator/oracle/oracle.ts +0 -665
  531. package/src/contract_function_simulator/proxied_contract_data_source.ts +0 -83
  532. package/src/contract_sync/contract_sync_service.ts +0 -152
  533. package/src/contract_sync/helpers.ts +0 -98
  534. package/src/storage/tagging_store/sender_address_book_store.ts +0 -48
  535. package/src/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.ts +0 -140
  536. package/src/tagging/recipient_sync/utils/load_logs_for_range.ts +0 -44
  537. package/src/tagging/sender_sync/utils/get_status_change_of_pending.ts +0 -36
@@ -1,10 +1,38 @@
1
- // This window has to be as large as the largest expected number of logs emitted in a tx for a given directional app
2
- // tagging secret. If we get more tag indexes consumed than this window, an error is thrown in `PXE::proveTx` function.
3
- // This is set to a larger value than MAX_PRIVATE_LOGS_PER_TX (currently 64) because there could be more than
4
- // MAX_PRIVATE_LOGS_PER_TX indexes consumed in case the logs are squashed. This happens when the log contains a note
5
- // and the note is nullified in the same tx.
6
- //
7
- // Having a large window significantly slowed down `e2e_l1_with_wall_time` test as there we perform sync for more than
8
- // 1000 secrets. For this reason we set it to a relatively low value of 20. 20 should be sufficient for all the use
9
- // cases.
10
- export const UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN = 20;
1
+ import { MAX_PRIVATE_LOGS_PER_TX } from '@aztec/constants';
2
+ // This window bounds how far a sender's next tag index for a directional app tagging secret can run ahead of that
3
+ // secret's highest finalized index before `PXE::proveTx` throws.
4
+ //
5
+ // MAX_PRIVATE_LOGS_PER_TX is a floor for ordinary transaction patterns: the private kernel accumulates every
6
+ // surviving private log into a single tx-wide array of exactly this size, so a fresh secret's very first
7
+ // ordinary tx can consume that many indexes before anything is finalized.
8
+ //
9
+ // The +20 on top is headroom for multiple pending ordinary txs to the same counterparty stacking up
10
+ // before the first one is observed as mined. Only a run of near-MAX_PRIVATE_LOGS_PER_TX txs back-to-back would
11
+ // exhaust this; ordinary transfers use far fewer logs per tx, so the same margin covers many more of those. Keep the
12
+ // margin additive rather than another multiple of the floor. A larger window also makes recipient-side sync more
13
+ // expensive, since discovery has to probe ahead of the last finalized index for every active secret.
14
+ //
15
+ // TODO(F-783): MAX_PRIVATE_LOGS_PER_TX is not a hard ceiling in general — a tx that creates and nullifies (squashes)
16
+ // many notes/logs to the same secret can drive that secret's raw tag index arbitrarily higher, since indexes are
17
+ // reserved at log emission time, before squashing is decided, and the kernel's reset/squash loop is not bounded by
18
+ // MAX_PRIVATE_LOGS_PER_TX. No fixed window value closes that gap.
19
+ export const UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN = MAX_PRIVATE_LOGS_PER_TX + 20;
20
+ /**
21
+ * Exclusive upper bound of the tag indexes that can exist for a secret whose highest finalized index is
22
+ * `finalizedIndex` (undefined when nothing is finalized yet). The sender store refuses pending indexes at or past it,
23
+ * and both sender and recipient sync scan exactly up to it. Every absolute window bound must come from this helper:
24
+ * a site with a wider or narrower bound lets a tx land at an index the syncs never scan, so two stores sharing the
25
+ * secret could later pick a colliding index.
26
+ */ export function unfinalizedTaggingIndexesWindowEnd(finalizedIndex) {
27
+ const windowStart = finalizedIndex === undefined ? 0 : finalizedIndex + 1;
28
+ return windowStart + UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN;
29
+ }
30
+ // The number of tags probed per constrained secret in the first round.
31
+ //
32
+ // The probe doubles each round (2, 4, 8, ..., capped at UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN) while every probed
33
+ // index is a hit, stopping at the first missing tag. Constrained delivery is gapless, so a single missing tag proves
34
+ // the stream has ended: at steady state this turns a full WINDOW_LEN probe into two tags. A secret K logs behind
35
+ // catches up in ~log2(K) round-trips while the probe is still doubling (2, 4, 8, 16, 32), but once it saturates the cap
36
+ // and advances WINDOW_LEN tags per round, deeper catch-up is linear at ~K/WINDOW_LEN rounds. Either way it beats both
37
+ // the full window every round and one round per log.
38
+ export const INITIAL_CONSTRAINED_PROBE_LEN = 2;
@@ -1,24 +1,69 @@
1
+ import { BlockNumber } from '@aztec/foundation/branded-types';
1
2
  import type { AztecAddress } from '@aztec/stdlib/aztec-address';
2
3
  import type { BlockHash } from '@aztec/stdlib/block';
3
4
  import type { AztecNode } from '@aztec/stdlib/interfaces/client';
4
- import type { SiloedTag, Tag, TxScopedL2Log } from '@aztec/stdlib/logs';
5
+ import { type LogResult, type SiloedTag, type Tag } from '@aztec/stdlib/logs';
6
+ import type { BlockHeader } from '@aztec/stdlib/tx';
5
7
  /**
6
- * Fetches all private logs for the given tags, automatically paginating through all pages.
8
+ * The block a tag query is anchored to.
9
+ *
10
+ * Both fields come from one header (see {@link logQueryAnchorOf}), which is what keeps the bound and the reorg check
11
+ * talking about the same block.
12
+ */
13
+ export type LogQueryAnchor = {
14
+ /**
15
+ * Hash of the anchor block, naming the chain the query must be answered on: the node throws if that block is gone,
16
+ * which is how a reorg surfaces.
17
+ */
18
+ hash: BlockHash;
19
+ /** Height of the anchor block, bounding the query to blocks at or below it. */
20
+ number: BlockNumber;
21
+ };
22
+ /**
23
+ * The {@link LogQueryAnchor} naming `anchorBlockHeader`: its hash and its height. Callers build it once and reuse
24
+ * it across every query anchored to that block, so the header is hashed only once.
25
+ */
26
+ export declare function logQueryAnchorOf(anchorBlockHeader: BlockHeader): Promise<LogQueryAnchor>;
27
+ /** Optional block-range, effects opt-in, and pagination cap shared by both wrappers. */
28
+ export type GetAllLogsByTagsOptions = {
29
+ /** Lower block bound, inclusive. */
30
+ fromBlock?: BlockNumber;
31
+ /** Upper block bound, exclusive. */
32
+ toBlock?: BlockNumber;
33
+ /**
34
+ * When set, each log also carries `noteHashes` and all `nullifiers` of its tx. Defaults to off — sender
35
+ * sync only needs `txHash`. The recipient-sync/log-service paths flip this on to build `PendingTaggedLog`
36
+ * / `LogRetrievalResponse` from note data.
37
+ */
38
+ includeEffects?: boolean;
39
+ /**
40
+ * Maximum number of logs returned per tag per round-trip. Capped at `MAX_LOGS_PER_TAG` on the node
41
+ * (rejected if higher). Defaults to `MAX_LOGS_PER_TAG`. Mainly useful for tests that need to force
42
+ * pagination at a small page size.
43
+ */
44
+ limitPerTag?: number;
45
+ };
46
+ /**
47
+ * Fetches all private logs for the given tags, automatically paginating per-tag via `afterLog` cursors.
48
+ *
7
49
  * @param aztecNode - The Aztec node to query.
8
50
  * @param tags - The siloed tags to search for.
9
- * @param anchorBlockHash - reference block for the Aztec node query, throws if block is not found there (typically
10
- * because of reorgs).
51
+ * @param anchor - Block the query is anchored to: results stop there, and the call throws if that block is not found
52
+ * (typically because of reorgs).
53
+ * @param options - Optional `fromBlock`/`toBlock` range and `includeEffects` opt-in.
11
54
  * @returns An array of log arrays, one per tag, containing all logs across all pages.
12
55
  */
13
- export declare function getAllPrivateLogsByTags(aztecNode: AztecNode, tags: SiloedTag[], anchorBlockHash: BlockHash): Promise<TxScopedL2Log[][]>;
56
+ export declare function getAllPrivateLogsByTags<Opts extends GetAllLogsByTagsOptions = GetAllLogsByTagsOptions>(aztecNode: AztecNode, tags: SiloedTag[], anchor: LogQueryAnchor, options?: Opts): Promise<LogResult<Opts>[][]>;
14
57
  /**
15
- * Fetches all public logs for the given tags from a contract, automatically paginating through all pages.
58
+ * Fetches all public logs for the given tags from a contract, automatically paginating per-tag via `afterLog` cursors.
59
+ *
16
60
  * @param aztecNode - The Aztec node to query.
17
61
  * @param contractAddress - The contract address to search logs for.
18
62
  * @param tags - The tags to search for.
19
- * @param anchorBlockHash - reference block for the Aztec node query, throws if block is not found there (typically
20
- * because of reorgs).
63
+ * @param anchor - Block the query is anchored to: results stop there, and the call throws if that block is not found
64
+ * (typically because of reorgs).
65
+ * @param options - Optional `fromBlock`/`toBlock` range and `includeEffects` opt-in.
21
66
  * @returns An array of log arrays, one per tag, containing all logs across all pages.
22
67
  */
23
- export declare function getAllPublicLogsByTagsFromContract(aztecNode: AztecNode, contractAddress: AztecAddress, tags: Tag[], anchorBlockHash: BlockHash): Promise<TxScopedL2Log[][]>;
24
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZ2V0X2FsbF9sb2dzX2J5X3RhZ3MuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90YWdnaW5nL2dldF9hbGxfbG9nc19ieV90YWdzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLFlBQVksRUFBRSxNQUFNLDZCQUE2QixDQUFDO0FBQ2hFLE9BQU8sS0FBSyxFQUFFLFNBQVMsRUFBRSxNQUFNLHFCQUFxQixDQUFDO0FBRXJELE9BQU8sS0FBSyxFQUFFLFNBQVMsRUFBRSxNQUFNLGlDQUFpQyxDQUFDO0FBQ2pFLE9BQU8sS0FBSyxFQUFFLFNBQVMsRUFBRSxHQUFHLEVBQUUsYUFBYSxFQUFFLE1BQU0sb0JBQW9CLENBQUM7QUFpRHhFOzs7Ozs7O0dBT0c7QUFDSCx3QkFBZ0IsdUJBQXVCLENBQ3JDLFNBQVMsRUFBRSxTQUFTLEVBQ3BCLElBQUksRUFBRSxTQUFTLEVBQUUsRUFDakIsZUFBZSxFQUFFLFNBQVMsR0FDekIsT0FBTyxDQUFDLGFBQWEsRUFBRSxFQUFFLENBQUMsQ0FJNUI7QUFFRDs7Ozs7Ozs7R0FRRztBQUNILHdCQUFnQixrQ0FBa0MsQ0FDaEQsU0FBUyxFQUFFLFNBQVMsRUFDcEIsZUFBZSxFQUFFLFlBQVksRUFDN0IsSUFBSSxFQUFFLEdBQUcsRUFBRSxFQUNYLGVBQWUsRUFBRSxTQUFTLEdBQ3pCLE9BQU8sQ0FBQyxhQUFhLEVBQUUsRUFBRSxDQUFDLENBTTVCIn0=
68
+ export declare function getAllPublicLogsByTagsFromContract<Opts extends GetAllLogsByTagsOptions = GetAllLogsByTagsOptions>(aztecNode: AztecNode, contractAddress: AztecAddress, tags: Tag[], anchor: LogQueryAnchor, options?: Opts): Promise<LogResult<Opts>[][]>;
69
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZ2V0X2FsbF9sb2dzX2J5X3RhZ3MuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90YWdnaW5nL2dldF9hbGxfbG9nc19ieV90YWdzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxXQUFXLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUU5RCxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUNoRSxPQUFPLEtBQUssRUFBRSxTQUFTLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUVyRCxPQUFPLEtBQUssRUFBRSxTQUFTLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUNqRSxPQUFPLEVBRUwsS0FBSyxTQUFTLEVBQ2QsS0FBSyxTQUFTLEVBQ2QsS0FBSyxHQUFHLEVBR1QsTUFBTSxvQkFBb0IsQ0FBQztBQUM1QixPQUFPLEtBQUssRUFBRSxXQUFXLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUVwRDs7Ozs7R0FLRztBQUNILE1BQU0sTUFBTSxjQUFjLEdBQUc7SUFDM0I7OztPQUdHO0lBQ0gsSUFBSSxFQUFFLFNBQVMsQ0FBQztJQUNoQiwrRUFBK0U7SUFDL0UsTUFBTSxFQUFFLFdBQVcsQ0FBQztDQUNyQixDQUFDO0FBRUY7OztHQUdHO0FBQ0gsd0JBQXNCLGdCQUFnQixDQUFDLGlCQUFpQixFQUFFLFdBQVcsR0FBRyxPQUFPLENBQUMsY0FBYyxDQUFDLENBRTlGO0FBRUQsd0ZBQXdGO0FBQ3hGLE1BQU0sTUFBTSx1QkFBdUIsR0FBRztJQUNwQyxvQ0FBb0M7SUFDcEMsU0FBUyxDQUFDLEVBQUUsV0FBVyxDQUFDO0lBQ3hCLG9DQUFvQztJQUNwQyxPQUFPLENBQUMsRUFBRSxXQUFXLENBQUM7SUFDdEI7Ozs7T0FJRztJQUNILGNBQWMsQ0FBQyxFQUFFLE9BQU8sQ0FBQztJQUN6Qjs7OztPQUlHO0lBQ0gsV0FBVyxDQUFDLEVBQUUsTUFBTSxDQUFDO0NBQ3RCLENBQUM7QUEwQkY7Ozs7Ozs7OztHQVNHO0FBQ0gsd0JBQWdCLHVCQUF1QixDQUFDLElBQUksU0FBUyx1QkFBdUIsR0FBRyx1QkFBdUIsRUFDcEcsU0FBUyxFQUFFLFNBQVMsRUFDcEIsSUFBSSxFQUFFLFNBQVMsRUFBRSxFQUNqQixNQUFNLEVBQUUsY0FBYyxFQUN0QixPQUFPLEdBQUUsSUFBaUIsR0FDekIsT0FBTyxDQUFDLFNBQVMsQ0FBQyxJQUFJLENBQUMsRUFBRSxFQUFFLENBQUMsQ0FhOUI7QUFFRDs7Ozs7Ozs7OztHQVVHO0FBQ0gsd0JBQWdCLGtDQUFrQyxDQUFDLElBQUksU0FBUyx1QkFBdUIsR0FBRyx1QkFBdUIsRUFDL0csU0FBUyxFQUFFLFNBQVMsRUFDcEIsZUFBZSxFQUFFLFlBQVksRUFDN0IsSUFBSSxFQUFFLEdBQUcsRUFBRSxFQUNYLE1BQU0sRUFBRSxjQUFjLEVBQ3RCLE9BQU8sR0FBRSxJQUFpQixHQUN6QixPQUFPLENBQUMsU0FBUyxDQUFDLElBQUksQ0FBQyxFQUFFLEVBQUUsQ0FBQyxDQWM5QiJ9
@@ -1 +1 @@
1
- {"version":3,"file":"get_all_logs_by_tags.d.ts","sourceRoot":"","sources":["../../src/tagging/get_all_logs_by_tags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAiDxE;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,SAAS,EAAE,EACjB,eAAe,EAAE,SAAS,GACzB,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAI5B;AAED;;;;;;;;GAQG;AACH,wBAAgB,kCAAkC,CAChD,SAAS,EAAE,SAAS,EACpB,eAAe,EAAE,YAAY,EAC7B,IAAI,EAAE,GAAG,EAAE,EACX,eAAe,EAAE,SAAS,GACzB,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAM5B"}
1
+ {"version":3,"file":"get_all_logs_by_tags.d.ts","sourceRoot":"","sources":["../../src/tagging/get_all_logs_by_tags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAE9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,GAAG,EAGT,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B;;;OAGG;IACH,IAAI,EAAE,SAAS,CAAC;IAChB,+EAA+E;IAC/E,MAAM,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,iBAAiB,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CAE9F;AAED,wFAAwF;AACxF,MAAM,MAAM,uBAAuB,GAAG;IACpC,oCAAoC;IACpC,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,oCAAoC;IACpC,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AA0BF;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,SAAS,uBAAuB,GAAG,uBAAuB,EACpG,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,SAAS,EAAE,EACjB,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,IAAiB,GACzB,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAa9B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kCAAkC,CAAC,IAAI,SAAS,uBAAuB,GAAG,uBAAuB,EAC/G,SAAS,EAAE,SAAS,EACpB,eAAe,EAAE,YAAY,EAC7B,IAAI,EAAE,GAAG,EAAE,EACX,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,IAAiB,GACzB,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAc9B"}
@@ -1,32 +1,23 @@
1
- import { MAX_LOGS_PER_TAG, MAX_RPC_LEN } from '@aztec/stdlib/interfaces/api-limit';
1
+ import { BlockNumber } from '@aztec/foundation/branded-types';
2
+ import { allToCompletion } from '@aztec/foundation/promise';
3
+ import { MAX_RPC_LEN } from '@aztec/stdlib/interfaces/api-limit';
4
+ import { queryAllPrivateLogsByTags, queryAllPublicLogsByTags } from '@aztec/stdlib/logs';
2
5
  /**
3
- * Generic pagination helper that fetches all pages of results.
4
- * @param numTags - The number of tags being queried (determines result array size).
5
- * @param fetchPage - Function that fetches a single page of results given a page number.
6
- * @returns An array of arrays, one per tag, containing all results across all pages.
7
- */ async function getAllPages(numTags, fetchPage) {
8
- const allResultsPerTag = Array.from({
9
- length: numTags
10
- }, ()=>[]);
11
- let page = 0;
12
- let hasMore = true;
13
- while(hasMore){
14
- const resultsPage = await fetchPage(page);
15
- hasMore = false;
16
- for(let i = 0; i < resultsPage.length; i++){
17
- allResultsPerTag[i].push(...resultsPage[i]);
18
- if (resultsPage[i].length === MAX_LOGS_PER_TAG) {
19
- hasMore = true;
20
- }
21
- }
22
- page++;
23
- }
24
- return allResultsPerTag;
6
+ * The {@link LogQueryAnchor} naming `anchorBlockHeader`: its hash and its height. Callers build it once and reuse
7
+ * it across every query anchored to that block, so the header is hashed only once.
8
+ */ export async function logQueryAnchorOf(anchorBlockHeader) {
9
+ return {
10
+ hash: await anchorBlockHeader.hash(),
11
+ number: anchorBlockHeader.getBlockNumber()
12
+ };
25
13
  }
26
14
  /**
27
- * Splits tags into chunks of MAX_RPC_LEN, fetches logs for each chunk using getAllPages, then stitches the results
28
- * back into a single array preserving the original tag order.
15
+ * Splits tags into chunks of MAX_RPC_LEN, paginates each chunk via the stdlib per-tag cursor helper,
16
+ * then stitches the results back into a single array preserving the original tag order.
29
17
  */ async function getAllPagesInBatches(tags, fetchAllPagesForBatch) {
18
+ if (tags.length === 0) {
19
+ return [];
20
+ }
30
21
  if (tags.length <= MAX_RPC_LEN) {
31
22
  return fetchAllPagesForBatch(tags);
32
23
  }
@@ -34,27 +25,55 @@ import { MAX_LOGS_PER_TAG, MAX_RPC_LEN } from '@aztec/stdlib/interfaces/api-limi
34
25
  for(let i = 0; i < tags.length; i += MAX_RPC_LEN){
35
26
  batches.push(tags.slice(i, i + MAX_RPC_LEN));
36
27
  }
37
- const batchResults = await Promise.all(batches.map(fetchAllPagesForBatch));
28
+ const batchResults = await allToCompletion(batches.map(fetchAllPagesForBatch));
38
29
  return batchResults.flat();
39
30
  }
40
31
  /**
41
- * Fetches all private logs for the given tags, automatically paginating through all pages.
32
+ * Fetches all private logs for the given tags, automatically paginating per-tag via `afterLog` cursors.
33
+ *
42
34
  * @param aztecNode - The Aztec node to query.
43
35
  * @param tags - The siloed tags to search for.
44
- * @param anchorBlockHash - reference block for the Aztec node query, throws if block is not found there (typically
45
- * because of reorgs).
36
+ * @param anchor - Block the query is anchored to: results stop there, and the call throws if that block is not found
37
+ * (typically because of reorgs).
38
+ * @param options - Optional `fromBlock`/`toBlock` range and `includeEffects` opt-in.
46
39
  * @returns An array of log arrays, one per tag, containing all logs across all pages.
47
- */ export function getAllPrivateLogsByTags(aztecNode, tags, anchorBlockHash) {
48
- return getAllPagesInBatches(tags, (batch)=>getAllPages(batch.length, (page)=>aztecNode.getPrivateLogsByTags(batch, page, anchorBlockHash)));
40
+ */ export function getAllPrivateLogsByTags(aztecNode, tags, anchor, options = {}) {
41
+ return getAllPagesInBatches(tags, (batch)=>queryAllPrivateLogsByTags(aztecNode, {
42
+ tags: batch,
43
+ referenceBlock: anchor.hash,
44
+ fromBlock: options.fromBlock,
45
+ toBlock: exclusiveUpperBound(anchor, options.toBlock),
46
+ includeEffects: options.includeEffects ?? false,
47
+ limitPerTag: options.limitPerTag
48
+ }));
49
49
  }
50
50
  /**
51
- * Fetches all public logs for the given tags from a contract, automatically paginating through all pages.
51
+ * Fetches all public logs for the given tags from a contract, automatically paginating per-tag via `afterLog` cursors.
52
+ *
52
53
  * @param aztecNode - The Aztec node to query.
53
54
  * @param contractAddress - The contract address to search logs for.
54
55
  * @param tags - The tags to search for.
55
- * @param anchorBlockHash - reference block for the Aztec node query, throws if block is not found there (typically
56
- * because of reorgs).
56
+ * @param anchor - Block the query is anchored to: results stop there, and the call throws if that block is not found
57
+ * (typically because of reorgs).
58
+ * @param options - Optional `fromBlock`/`toBlock` range and `includeEffects` opt-in.
57
59
  * @returns An array of log arrays, one per tag, containing all logs across all pages.
58
- */ export function getAllPublicLogsByTagsFromContract(aztecNode, contractAddress, tags, anchorBlockHash) {
59
- return getAllPagesInBatches(tags, (batch)=>getAllPages(batch.length, (page)=>aztecNode.getPublicLogsByTagsFromContract(contractAddress, batch, page, anchorBlockHash)));
60
+ */ export function getAllPublicLogsByTagsFromContract(aztecNode, contractAddress, tags, anchor, options = {}) {
61
+ return getAllPagesInBatches(tags, (batch)=>queryAllPublicLogsByTags(aztecNode, {
62
+ contractAddress,
63
+ tags: batch,
64
+ referenceBlock: anchor.hash,
65
+ fromBlock: options.fromBlock,
66
+ toBlock: exclusiveUpperBound(anchor, options.toBlock),
67
+ includeEffects: options.includeEffects ?? false,
68
+ limitPerTag: options.limitPerTag
69
+ }));
70
+ }
71
+ /**
72
+ * Exclusive upper block bound for a query anchored at `anchor`: one past the anchor block, or the caller's own
73
+ * `toBlock` when that is tighter.
74
+ *
75
+ * The bound is spelled out in the request rather than left implicit in `referenceBlock`, so the request itself
76
+ * names a fixed block range that no later block can widen.
77
+ */ function exclusiveUpperBound(anchor, toBlock) {
78
+ return BlockNumber(Math.min(toBlock ?? Infinity, anchor.number + 1));
60
79
  }
@@ -4,14 +4,15 @@
4
4
  * The objective of the sender sync algorithm is to determine which tags have already been used by a sender, thereby
5
5
  * deciding which tag should be used next.
6
6
  *
7
- * The objective of the recipient sync algorithm is to load and process the corresponding logs.
7
+ * The objective of the recipient sync algorithm is to fetch and sync the corresponding logs.
8
8
  *
9
9
  * @module tagging
10
10
  */
11
- export { loadPrivateLogsForSenderRecipientPair } from './recipient_sync/load_private_logs_for_sender_recipient_pair.js';
11
+ export { syncTaggedPrivateLogs } from './recipient_sync/sync_tagged_private_logs.js';
12
12
  export { syncSenderTaggingIndexes } from './sender_sync/sync_sender_tagging_indexes.js';
13
- export { UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN } from './constants.js';
14
- export { getAllPrivateLogsByTags, getAllPublicLogsByTagsFromContract } from './get_all_logs_by_tags.js';
15
- export { ExtendedDirectionalAppTaggingSecret, Tag, SiloedTag } from '@aztec/stdlib/logs';
16
- export { type PreTag } from '@aztec/stdlib/logs';
17
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90YWdnaW5nL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7Ozs7Ozs7R0FTRztBQUVILE9BQU8sRUFBRSxxQ0FBcUMsRUFBRSxNQUFNLGlFQUFpRSxDQUFDO0FBQ3hILE9BQU8sRUFBRSx3QkFBd0IsRUFBRSxNQUFNLDhDQUE4QyxDQUFDO0FBQ3hGLE9BQU8sRUFBRSxzQ0FBc0MsRUFBRSxNQUFNLGdCQUFnQixDQUFDO0FBQ3hFLE9BQU8sRUFBRSx1QkFBdUIsRUFBRSxrQ0FBa0MsRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBR3hHLE9BQU8sRUFBRSxtQ0FBbUMsRUFBRSxHQUFHLEVBQUUsU0FBUyxFQUFFLE1BQU0sb0JBQW9CLENBQUM7QUFDekYsT0FBTyxFQUFFLEtBQUssTUFBTSxFQUFFLE1BQU0sb0JBQW9CLENBQUMifQ==
13
+ export { persistSenderTaggingIndexRangesForTx } from './persist_sender_tagging_index_ranges.js';
14
+ export { UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN, INITIAL_CONSTRAINED_PROBE_LEN } from './constants.js';
15
+ export { type LogQueryAnchor, getAllPrivateLogsByTags, getAllPublicLogsByTagsFromContract, logQueryAnchorOf, } from './get_all_logs_by_tags.js';
16
+ export { AppTaggingSecret, Tag, SiloedTag } from '@aztec/stdlib/logs';
17
+ export { type PreTag, type TaggingIndexRange } from '@aztec/stdlib/logs';
18
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90YWdnaW5nL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7Ozs7Ozs7R0FTRztBQUVILE9BQU8sRUFBRSxxQkFBcUIsRUFBRSxNQUFNLDhDQUE4QyxDQUFDO0FBQ3JGLE9BQU8sRUFBRSx3QkFBd0IsRUFBRSxNQUFNLDhDQUE4QyxDQUFDO0FBQ3hGLE9BQU8sRUFBRSxvQ0FBb0MsRUFBRSxNQUFNLDBDQUEwQyxDQUFDO0FBQ2hHLE9BQU8sRUFBRSxzQ0FBc0MsRUFBRSw2QkFBNkIsRUFBRSxNQUFNLGdCQUFnQixDQUFDO0FBQ3ZHLE9BQU8sRUFDTCxLQUFLLGNBQWMsRUFDbkIsdUJBQXVCLEVBQ3ZCLGtDQUFrQyxFQUNsQyxnQkFBZ0IsR0FDakIsTUFBTSwyQkFBMkIsQ0FBQztBQUduQyxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsR0FBRyxFQUFFLFNBQVMsRUFBRSxNQUFNLG9CQUFvQixDQUFDO0FBQ3RFLE9BQU8sRUFBRSxLQUFLLE1BQU0sRUFBRSxLQUFLLGlCQUFpQixFQUFFLE1BQU0sb0JBQW9CLENBQUMifQ==
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tagging/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,qCAAqC,EAAE,MAAM,iEAAiE,CAAC;AACxH,OAAO,EAAE,wBAAwB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,EAAE,sCAAsC,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,kCAAkC,EAAE,MAAM,2BAA2B,CAAC;AAGxG,OAAO,EAAE,mCAAmC,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACzF,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tagging/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,8CAA8C,CAAC;AACrF,OAAO,EAAE,wBAAwB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,EAAE,oCAAoC,EAAE,MAAM,0CAA0C,CAAC;AAChG,OAAO,EAAE,sCAAsC,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAC;AACvG,OAAO,EACL,KAAK,cAAc,EACnB,uBAAuB,EACvB,kCAAkC,EAClC,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,gBAAgB,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}
@@ -4,12 +4,13 @@
4
4
  * The objective of the sender sync algorithm is to determine which tags have already been used by a sender, thereby
5
5
  * deciding which tag should be used next.
6
6
  *
7
- * The objective of the recipient sync algorithm is to load and process the corresponding logs.
7
+ * The objective of the recipient sync algorithm is to fetch and sync the corresponding logs.
8
8
  *
9
9
  * @module tagging
10
- */ export { loadPrivateLogsForSenderRecipientPair } from './recipient_sync/load_private_logs_for_sender_recipient_pair.js';
10
+ */ export { syncTaggedPrivateLogs } from './recipient_sync/sync_tagged_private_logs.js';
11
11
  export { syncSenderTaggingIndexes } from './sender_sync/sync_sender_tagging_indexes.js';
12
- export { UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN } from './constants.js';
13
- export { getAllPrivateLogsByTags, getAllPublicLogsByTagsFromContract } from './get_all_logs_by_tags.js';
12
+ export { persistSenderTaggingIndexRangesForTx } from './persist_sender_tagging_index_ranges.js';
13
+ export { UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN, INITIAL_CONSTRAINED_PROBE_LEN } from './constants.js';
14
+ export { getAllPrivateLogsByTags, getAllPublicLogsByTagsFromContract, logQueryAnchorOf } from './get_all_logs_by_tags.js';
14
15
  // Re-export tagging-related types from stdlib
15
- export { ExtendedDirectionalAppTaggingSecret, Tag, SiloedTag } from '@aztec/stdlib/logs';
16
+ export { AppTaggingSecret, Tag, SiloedTag } from '@aztec/stdlib/logs';
@@ -0,0 +1,29 @@
1
+ import type { Logger } from '@aztec/foundation/log';
2
+ import type { PrivateKernelTailCircuitPublicInputs } from '@aztec/stdlib/kernel';
3
+ import type { TaggingIndexRange } from '@aztec/stdlib/logs';
4
+ import type { TxHash } from '@aztec/stdlib/tx';
5
+ import type { SenderTaggingStore } from '../storage/tagging_store/sender_tagging_store.js';
6
+ /**
7
+ * Persists the tagging index ranges that a tx used as a sender, after reconciling them against the kernel's surviving
8
+ * private logs.
9
+ *
10
+ * The tagging index cache reserves an index for every log emission attempted during private execution, but the kernel
11
+ * may then squash some of those logs (e.g. when a note is created and nullified within the same tx). This function
12
+ * shrinks the recorded ranges to match the actual on-chain footprint before writing them, so that what we persist is
13
+ * consistent with what the network will see.
14
+ *
15
+ * @remarks Storing the recorded ranges in the DB may not be seen as necessary because we sync from chain before sending
16
+ * new logs, but the sync can only see logs already included in blocks. If we sent another transaction before this one
17
+ * was included from the same PXE, and that transaction contained a log with a tag derived from the same secret, we
18
+ * would reuse the tag and the transactions would be linked. Persisting in the DB prevents that linkage.
19
+ *
20
+ * @param store - The sender tagging store.
21
+ * @param recordedRanges - The tagging index ranges as recorded during private execution (pre-squash).
22
+ * @param publicInputs - The final kernel public inputs, used to determine which private logs survived squashing.
23
+ * @param getTxHash - Lazy accessor for the tx hash. Called only when there is something to persist, since computing
24
+ * the tx hash is expensive.
25
+ * @param jobId - Job context for staged writes to the store. See `JobCoordinator` for more details.
26
+ * @param log - Logger.
27
+ */
28
+ export declare function persistSenderTaggingIndexRangesForTx(store: SenderTaggingStore, recordedRanges: TaggingIndexRange[], publicInputs: PrivateKernelTailCircuitPublicInputs, getTxHash: () => Promise<TxHash>, jobId: string, log: Logger): Promise<void>;
29
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGVyc2lzdF9zZW5kZXJfdGFnZ2luZ19pbmRleF9yYW5nZXMuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90YWdnaW5nL3BlcnNpc3Rfc2VuZGVyX3RhZ2dpbmdfaW5kZXhfcmFuZ2VzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLE1BQU0sRUFBRSxNQUFNLHVCQUF1QixDQUFDO0FBQ3BELE9BQU8sS0FBSyxFQUFFLG9DQUFvQyxFQUFFLE1BQU0sc0JBQXNCLENBQUM7QUFDakYsT0FBTyxLQUFLLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUM1RCxPQUFPLEtBQUssRUFBRSxNQUFNLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUUvQyxPQUFPLEtBQUssRUFBRSxrQkFBa0IsRUFBRSxNQUFNLGtEQUFrRCxDQUFDO0FBRzNGOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0FxQkc7QUFDSCx3QkFBc0Isb0NBQW9DLENBQ3hELEtBQUssRUFBRSxrQkFBa0IsRUFDekIsY0FBYyxFQUFFLGlCQUFpQixFQUFFLEVBQ25DLFlBQVksRUFBRSxvQ0FBb0MsRUFDbEQsU0FBUyxFQUFFLE1BQU0sT0FBTyxDQUFDLE1BQU0sQ0FBQyxFQUNoQyxLQUFLLEVBQUUsTUFBTSxFQUNiLEdBQUcsRUFBRSxNQUFNLEdBQ1YsT0FBTyxDQUFDLElBQUksQ0FBQyxDQW1CZiJ9
@@ -0,0 +1 @@
1
+ {"version":3,"file":"persist_sender_tagging_index_ranges.d.ts","sourceRoot":"","sources":["../../src/tagging/persist_sender_tagging_index_ranges.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,oCAAoC,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kDAAkD,CAAC;AAG3F;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,oCAAoC,CACxD,KAAK,EAAE,kBAAkB,EACzB,cAAc,EAAE,iBAAiB,EAAE,EACnC,YAAY,EAAE,oCAAoC,EAClD,SAAS,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,EAChC,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAmBf"}
@@ -0,0 +1,42 @@
1
+ import { reconcileTaggingIndexRangesAgainstSurvivingTags } from './reconcile_tagging_index_ranges.js';
2
+ /**
3
+ * Persists the tagging index ranges that a tx used as a sender, after reconciling them against the kernel's surviving
4
+ * private logs.
5
+ *
6
+ * The tagging index cache reserves an index for every log emission attempted during private execution, but the kernel
7
+ * may then squash some of those logs (e.g. when a note is created and nullified within the same tx). This function
8
+ * shrinks the recorded ranges to match the actual on-chain footprint before writing them, so that what we persist is
9
+ * consistent with what the network will see.
10
+ *
11
+ * @remarks Storing the recorded ranges in the DB may not be seen as necessary because we sync from chain before sending
12
+ * new logs, but the sync can only see logs already included in blocks. If we sent another transaction before this one
13
+ * was included from the same PXE, and that transaction contained a log with a tag derived from the same secret, we
14
+ * would reuse the tag and the transactions would be linked. Persisting in the DB prevents that linkage.
15
+ *
16
+ * @param store - The sender tagging store.
17
+ * @param recordedRanges - The tagging index ranges as recorded during private execution (pre-squash).
18
+ * @param publicInputs - The final kernel public inputs, used to determine which private logs survived squashing.
19
+ * @param getTxHash - Lazy accessor for the tx hash. Called only when there is something to persist, since computing
20
+ * the tx hash is expensive.
21
+ * @param jobId - Job context for staged writes to the store. See `JobCoordinator` for more details.
22
+ * @param log - Logger.
23
+ */ export async function persistSenderTaggingIndexRangesForTx(store, recordedRanges, publicInputs, getTxHash, jobId, log) {
24
+ if (recordedRanges.length === 0) {
25
+ log.debug(`No tagging index ranges used in the tx`);
26
+ return;
27
+ }
28
+ const survivingTags = new Set(publicInputs.getNonEmptyPrivateLogs().map((privateLog)=>privateLog.fields[0].toString()));
29
+ const reconciledRanges = await reconcileTaggingIndexRangesAgainstSurvivingTags(recordedRanges, survivingTags);
30
+ if (reconciledRanges.length === 0) {
31
+ log.debug(`All tagging index ranges used in the tx were squashed by the kernel`, {
32
+ recordedRanges
33
+ });
34
+ return;
35
+ }
36
+ const txHash = await getTxHash();
37
+ await store.storePendingIndexes(reconciledRanges, txHash, jobId);
38
+ log.debug(`Stored used tagging index ranges as sender for the tx`, {
39
+ recordedRanges,
40
+ reconciledRanges
41
+ });
42
+ }
@@ -0,0 +1,74 @@
1
+ import type { BlockNumber } from '@aztec/foundation/branded-types';
2
+ import type { AztecNode } from '@aztec/stdlib/interfaces/client';
3
+ import type { AppTaggingSecret, LogResult } from '@aztec/stdlib/logs';
4
+ import type { BlockHeader } from '@aztec/stdlib/tx';
5
+ import type { RecipientTaggingStore } from '../../storage/tagging_store/recipient_tagging_store.js';
6
+ /**
7
+ * Fetches and syncs tagged private logs for multiple sender-recipient pairs, batching tag queries across all secrets
8
+ * into shared RPC calls. Handles both constrained and unconstrained secrets, which differ in their scan strategy
9
+ * but share the same batching infrastructure.
10
+ *
11
+ * # Unconstrained secrets
12
+ *
13
+ * For each unconstrained secret we sync logs that correspond to the tagging index range
14
+ * (highestAgedIndex, highestFinalizedIndex + WINDOW_LEN]
15
+ *
16
+ * highestAgedIndex is the highest index that was used in a tx that is included in a block at least
17
+ * `MAX_TX_LIFETIME` seconds ago.
18
+ * highestFinalizedIndex is the highest index that was used in a tx that is included in a finalized block.
19
+ *
20
+ * "(" denotes an open end of the range - the index is not included in the range.
21
+ * "]" denotes a closed end of the range - the index is included in the range.
22
+ *
23
+ * ## Explanation of highestAgedIndex
24
+ *
25
+ * highestAgedIndex is chosen such that for all tagging indexes `i <= highestAgedIndex` we know that no new logs can
26
+ * ever appear.
27
+ *
28
+ * This relies on the "maximum inclusion timestamp" rule enforced by the kernel and rollup circuits:
29
+ * - a transaction's maximum inclusion timestamp is at most `MAX_TX_LIFETIME` seconds after
30
+ * the timestamp of its anchor block; and
31
+ * - a rollup only includes transactions whose inclusion timestamp is >= the L2 block's timestamp.
32
+ *
33
+ * Suppose some device used index `I` in a transaction anchored to block `B_N` at time `N`, and that block is now at
34
+ * least `MAX_TX_LIFETIME` seconds in the past. Then there is no possibility of any *other* device
35
+ * trying to use an index <= `I` while anchoring to a *newer* block than `B_N` because if we were anchoring to
36
+ * a newer block than `B_N` then we would already have seen the log with index `I` and hence the device would have
37
+ * chosen a larger index.
38
+ * If that *other* device would anchor to a block older than `B_N` then that tx could never be included in a block
39
+ * because it would already have been expired.
40
+ *
41
+ * Therefore, once we see that index `I` has been used in a block that is at least `MAX_TX_LIFETIME`
42
+ * seconds old, we can safely stop syncing logs for all indexes <= `I` and set highestAgedIndex = `I`.
43
+ *
44
+ * ## Explanation of the upper bound `highestFinalizedIndex + WINDOW_LEN`
45
+ *
46
+ * When a sender chooses a tagging index, they will select an index that is at most `WINDOW_LEN` greater than
47
+ * the highest finalized index. If that index was already used, they will throw an error. For this reason we
48
+ * don't have to look further than `highestFinalizedIndex + WINDOW_LEN`.
49
+ *
50
+ * # Constrained secrets
51
+ *
52
+ * Constrained delivery enforces a contiguous index sequence (each send proves the predecessor's nullifier,
53
+ * chaining back to the handshake), so there is only one sender and indexes are sequential. This means:
54
+ * - The lower bound is `highestFinalizedIndex + 1`. The `highestAgedIndex` mechanism is unnecessary because
55
+ * the nullifier chain prevents out-of-order index usage: no device can fill in a lower index after a higher
56
+ * one is already on-chain.
57
+ * - Because the sequence is gapless, the scan stops at the first missing index: that gap proves the sequence has
58
+ * ended and no further logs exist. We exploit this with a doubling first-miss probe (see
59
+ * `INITIAL_CONSTRAINED_PROBE_LEN` in ../constants.ts), so a
60
+ * steady-state sync with no new logs costs two tags instead of the whole window. The probe length is in-memory
61
+ * state scoped to one sync call, so every sync restarts at the initial probe.
62
+ * - The upper bound is the same as unconstrained: `highestFinalizedIndex + WINDOW_LEN`. Advancing the probe is
63
+ * decoupled from persisting the finalized index, so unfinalized logs at the top of the run are still fetched
64
+ * while only the finalized prefix is persisted.
65
+ *
66
+ * # Batching across secrets
67
+ *
68
+ * Instead of running one RPC call per secret, we merge tags from all pending secrets (both constrained and
69
+ * unconstrained) into a single flat array, make one batched `getAllPrivateLogsByTags` call (which internally
70
+ * chunks at MAX_RPC_LEN), then split results back per secret using tracked offsets. Only secrets whose window
71
+ * advanced are kept for the next iteration.
72
+ */
73
+ export declare function syncTaggedPrivateLogs(secrets: AppTaggingSecret[], aztecNode: AztecNode, taggingStore: RecipientTaggingStore, anchorBlockHeader: BlockHeader, finalizedBlockNumber: BlockNumber, jobId: string): Promise<LogResult[]>;
74
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3luY190YWdnZWRfcHJpdmF0ZV9sb2dzLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvdGFnZ2luZy9yZWNpcGllbnRfc3luYy9zeW5jX3RhZ2dlZF9wcml2YXRlX2xvZ3MudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsV0FBVyxFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFHbkUsT0FBTyxLQUFLLEVBQUUsU0FBUyxFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFDakUsT0FBTyxLQUFLLEVBQUUsZ0JBQWdCLEVBQUUsU0FBUyxFQUFFLE1BQU0sb0JBQW9CLENBQUM7QUFFdEUsT0FBTyxLQUFLLEVBQUUsV0FBVyxFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFFcEQsT0FBTyxLQUFLLEVBQUUscUJBQXFCLEVBQUUsTUFBTSx3REFBd0QsQ0FBQztBQVNwRzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBa0VHO0FBQ0gsd0JBQXNCLHFCQUFxQixDQUN6QyxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsRUFDM0IsU0FBUyxFQUFFLFNBQVMsRUFDcEIsWUFBWSxFQUFFLHFCQUFxQixFQUNuQyxpQkFBaUIsRUFBRSxXQUFXLEVBQzlCLG9CQUFvQixFQUFFLFdBQVcsRUFDakMsS0FBSyxFQUFFLE1BQU0sR0FDWixPQUFPLENBQUMsU0FBUyxFQUFFLENBQUMsQ0FvRHRCIn0=
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sync_tagged_private_logs.d.ts","sourceRoot":"","sources":["../../../src/tagging/recipient_sync/sync_tagged_private_logs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAGnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wDAAwD,CAAC;AASpG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkEG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,gBAAgB,EAAE,EAC3B,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,qBAAqB,EACnC,iBAAiB,EAAE,WAAW,EAC9B,oBAAoB,EAAE,WAAW,EACjC,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,SAAS,EAAE,CAAC,CAoDtB"}