@aztec/pxe 0.0.1-commit.d431d1c → 0.0.1-commit.d58ff9d0

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 (523) hide show
  1. package/dest/bin/check_oracle_version.js +40 -111
  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 +26 -14
  12. package/dest/block_synchronizer/block_synchronizer.d.ts.map +1 -1
  13. package/dest/block_synchronizer/block_synchronizer.js +128 -26
  14. package/dest/config/index.d.ts +11 -2
  15. package/dest/config/index.d.ts.map +1 -1
  16. package/dest/config/index.js +18 -2
  17. package/dest/config/package_info.js +1 -1
  18. package/dest/contract/contract_class_service.d.ts +31 -0
  19. package/dest/contract/contract_class_service.d.ts.map +1 -0
  20. package/dest/contract/contract_class_service.js +68 -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 +116 -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/aztec_node_read_cache.d.ts +39 -0
  34. package/dest/contract_function_simulator/aztec_node_read_cache.d.ts.map +1 -0
  35. package/dest/contract_function_simulator/aztec_node_read_cache.js +60 -0
  36. package/dest/contract_function_simulator/contract_function_simulator.d.ts +72 -36
  37. package/dest/contract_function_simulator/contract_function_simulator.d.ts.map +1 -1
  38. package/dest/contract_function_simulator/contract_function_simulator.js +265 -98
  39. package/dest/contract_function_simulator/ephemeral_array_service.d.ts +28 -0
  40. package/dest/contract_function_simulator/ephemeral_array_service.d.ts.map +1 -0
  41. package/dest/contract_function_simulator/ephemeral_array_service.js +78 -0
  42. package/dest/contract_function_simulator/execution_note_cache.d.ts +4 -10
  43. package/dest/contract_function_simulator/execution_note_cache.d.ts.map +1 -1
  44. package/dest/contract_function_simulator/execution_note_cache.js +8 -28
  45. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts +7 -11
  46. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts.map +1 -1
  47. package/dest/contract_function_simulator/execution_tagging_index_cache.js +19 -15
  48. package/dest/contract_function_simulator/index.d.ts +26 -5
  49. package/dest/contract_function_simulator/index.d.ts.map +1 -1
  50. package/dest/contract_function_simulator/index.js +11 -3
  51. package/dest/contract_function_simulator/noir-structs/bounded_vec.d.ts +29 -0
  52. package/dest/contract_function_simulator/noir-structs/bounded_vec.d.ts.map +1 -0
  53. package/dest/contract_function_simulator/noir-structs/bounded_vec.js +30 -0
  54. package/dest/contract_function_simulator/noir-structs/contract_class_log_data.d.ts +9 -0
  55. package/dest/contract_function_simulator/noir-structs/contract_class_log_data.d.ts.map +1 -0
  56. package/dest/contract_function_simulator/noir-structs/contract_class_log_data.js +1 -0
  57. package/dest/contract_function_simulator/noir-structs/embedded_curve_point.d.ts +7 -0
  58. package/dest/contract_function_simulator/noir-structs/embedded_curve_point.d.ts.map +1 -0
  59. package/dest/contract_function_simulator/noir-structs/embedded_curve_point.js +1 -0
  60. package/dest/contract_function_simulator/noir-structs/ephemeral_array.d.ts +37 -0
  61. package/dest/contract_function_simulator/noir-structs/ephemeral_array.d.ts.map +1 -0
  62. package/dest/contract_function_simulator/noir-structs/ephemeral_array.js +59 -0
  63. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts +4 -5
  64. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts.map +1 -1
  65. package/dest/contract_function_simulator/noir-structs/event_validation_request.js +10 -11
  66. package/dest/contract_function_simulator/noir-structs/fact.d.ts +16 -0
  67. package/dest/contract_function_simulator/noir-structs/fact.d.ts.map +1 -0
  68. package/dest/contract_function_simulator/noir-structs/fact.js +6 -0
  69. package/dest/contract_function_simulator/noir-structs/fact_collection.d.ts +27 -0
  70. package/dest/contract_function_simulator/noir-structs/fact_collection.d.ts.map +1 -0
  71. package/dest/contract_function_simulator/noir-structs/fact_collection.js +31 -0
  72. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.d.ts +19 -10
  73. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.d.ts.map +1 -1
  74. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.js +12 -24
  75. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts +11 -9
  76. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts.map +1 -1
  77. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.js +2 -63
  78. package/dest/contract_function_simulator/noir-structs/note_data.d.ts +27 -0
  79. package/dest/contract_function_simulator/noir-structs/note_data.d.ts.map +1 -0
  80. package/dest/contract_function_simulator/noir-structs/note_data.js +3 -0
  81. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts +4 -6
  82. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts.map +1 -1
  83. package/dest/contract_function_simulator/noir-structs/note_validation_request.js +9 -13
  84. package/dest/contract_function_simulator/noir-structs/option.d.ts +59 -0
  85. package/dest/contract_function_simulator/noir-structs/option.d.ts.map +1 -0
  86. package/dest/contract_function_simulator/noir-structs/option.js +67 -0
  87. package/dest/contract_function_simulator/noir-structs/origin_block.d.ts +11 -0
  88. package/dest/contract_function_simulator/noir-structs/origin_block.d.ts.map +1 -0
  89. package/dest/contract_function_simulator/noir-structs/origin_block.js +5 -0
  90. package/dest/contract_function_simulator/noir-structs/pending_tagged_log.d.ts +11 -0
  91. package/dest/contract_function_simulator/noir-structs/pending_tagged_log.d.ts.map +1 -0
  92. package/dest/contract_function_simulator/noir-structs/pending_tagged_log.js +4 -0
  93. package/dest/contract_function_simulator/noir-structs/provided_secret.d.ts +8 -0
  94. package/dest/contract_function_simulator/noir-structs/provided_secret.d.ts.map +1 -0
  95. package/dest/contract_function_simulator/noir-structs/provided_secret.js +1 -0
  96. package/dest/contract_function_simulator/noir-structs/resolved_tagging_strategy.d.ts +28 -0
  97. package/dest/contract_function_simulator/noir-structs/resolved_tagging_strategy.d.ts.map +1 -0
  98. package/dest/contract_function_simulator/noir-structs/resolved_tagging_strategy.js +50 -0
  99. package/dest/contract_function_simulator/noir-structs/resolved_tx.d.ts +19 -0
  100. package/dest/contract_function_simulator/noir-structs/resolved_tx.d.ts.map +1 -0
  101. package/dest/contract_function_simulator/noir-structs/resolved_tx.js +9 -0
  102. package/dest/contract_function_simulator/noir-structs/tx_effect_data.d.ts +15 -0
  103. package/dest/contract_function_simulator/noir-structs/tx_effect_data.d.ts.map +1 -0
  104. package/dest/contract_function_simulator/noir-structs/tx_effect_data.js +5 -0
  105. package/dest/contract_function_simulator/noir-structs/utility_context.d.ts +6 -11
  106. package/dest/contract_function_simulator/noir-structs/utility_context.d.ts.map +1 -1
  107. package/dest/contract_function_simulator/noir-structs/utility_context.js +1 -20
  108. package/dest/contract_function_simulator/oracle/acir_callback.d.ts +21 -0
  109. package/dest/contract_function_simulator/oracle/acir_callback.d.ts.map +1 -0
  110. package/dest/contract_function_simulator/oracle/acir_callback.js +115 -0
  111. package/dest/contract_function_simulator/oracle/index.d.ts +2 -13
  112. package/dest/contract_function_simulator/oracle/index.d.ts.map +1 -1
  113. package/dest/contract_function_simulator/oracle/index.js +1 -1
  114. package/dest/contract_function_simulator/oracle/interfaces.d.ts +15 -95
  115. package/dest/contract_function_simulator/oracle/interfaces.d.ts.map +1 -1
  116. package/dest/contract_function_simulator/oracle/interfaces.js +2 -2
  117. package/dest/contract_function_simulator/oracle/legacy_oracle_registry.d.ts +39 -0
  118. package/dest/contract_function_simulator/oracle/legacy_oracle_registry.d.ts.map +1 -0
  119. package/dest/contract_function_simulator/oracle/legacy_oracle_registry.js +107 -0
  120. package/dest/contract_function_simulator/oracle/message_load_oracle_inputs.d.ts +3 -14
  121. package/dest/contract_function_simulator/oracle/message_load_oracle_inputs.d.ts.map +1 -1
  122. package/dest/contract_function_simulator/oracle/message_load_oracle_inputs.js +1 -24
  123. package/dest/contract_function_simulator/oracle/note_packing_utils.d.ts +2 -2
  124. package/dest/contract_function_simulator/oracle/note_packing_utils.d.ts.map +1 -1
  125. package/dest/contract_function_simulator/oracle/note_packing_utils.js +2 -2
  126. package/dest/contract_function_simulator/oracle/oracle_registry.d.ts +139 -0
  127. package/dest/contract_function_simulator/oracle/oracle_registry.d.ts.map +1 -0
  128. package/dest/contract_function_simulator/oracle/oracle_registry.js +1016 -0
  129. package/dest/contract_function_simulator/oracle/oracle_type_mappings.d.ts +274 -0
  130. package/dest/contract_function_simulator/oracle/oracle_type_mappings.d.ts.map +1 -0
  131. package/dest/contract_function_simulator/oracle/oracle_type_mappings.js +1243 -0
  132. package/dest/contract_function_simulator/oracle/private_execution.d.ts +2 -22
  133. package/dest/contract_function_simulator/oracle/private_execution.d.ts.map +1 -1
  134. package/dest/contract_function_simulator/oracle/private_execution.js +7 -43
  135. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts +88 -95
  136. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts.map +1 -1
  137. package/dest/contract_function_simulator/oracle/private_execution_oracle.js +268 -116
  138. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts +215 -86
  139. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts.map +1 -1
  140. package/dest/contract_function_simulator/oracle/utility_execution_oracle.js +625 -204
  141. package/dest/contract_function_simulator/pick_notes.d.ts +1 -1
  142. package/dest/contract_function_simulator/pick_notes.d.ts.map +1 -1
  143. package/dest/contract_function_simulator/pick_notes.js +20 -3
  144. package/dest/contract_function_simulator/transient_array_service.d.ts +31 -0
  145. package/dest/contract_function_simulator/transient_array_service.d.ts.map +1 -0
  146. package/dest/contract_function_simulator/transient_array_service.js +62 -0
  147. package/dest/contract_logging.d.ts +27 -0
  148. package/dest/contract_logging.d.ts.map +1 -0
  149. package/dest/contract_logging.js +38 -0
  150. package/dest/debug/pxe_debug_utils.d.ts +19 -10
  151. package/dest/debug/pxe_debug_utils.d.ts.map +1 -1
  152. package/dest/debug/pxe_debug_utils.js +22 -17
  153. package/dest/entrypoints/client/bundle/index.d.ts +4 -1
  154. package/dest/entrypoints/client/bundle/index.d.ts.map +1 -1
  155. package/dest/entrypoints/client/bundle/index.js +3 -0
  156. package/dest/entrypoints/client/bundle/utils.d.ts +2 -2
  157. package/dest/entrypoints/client/bundle/utils.d.ts.map +1 -1
  158. package/dest/entrypoints/client/bundle/utils.js +45 -12
  159. package/dest/entrypoints/client/lazy/index.d.ts +4 -1
  160. package/dest/entrypoints/client/lazy/index.d.ts.map +1 -1
  161. package/dest/entrypoints/client/lazy/index.js +3 -0
  162. package/dest/entrypoints/client/lazy/utils.d.ts +3 -3
  163. package/dest/entrypoints/client/lazy/utils.d.ts.map +1 -1
  164. package/dest/entrypoints/client/lazy/utils.js +46 -13
  165. package/dest/entrypoints/client/store.d.ts +14 -0
  166. package/dest/entrypoints/client/store.d.ts.map +1 -0
  167. package/dest/entrypoints/client/store.js +42 -0
  168. package/dest/entrypoints/pxe_creation_options.d.ts +18 -3
  169. package/dest/entrypoints/pxe_creation_options.d.ts.map +1 -1
  170. package/dest/entrypoints/pxe_creation_options.js +3 -1
  171. package/dest/entrypoints/server/index.d.ts +8 -2
  172. package/dest/entrypoints/server/index.d.ts.map +1 -1
  173. package/dest/entrypoints/server/index.js +6 -1
  174. package/dest/entrypoints/server/store.d.ts +18 -0
  175. package/dest/entrypoints/server/store.d.ts.map +1 -0
  176. package/dest/entrypoints/server/store.js +28 -0
  177. package/dest/entrypoints/server/utils.d.ts +4 -3
  178. package/dest/entrypoints/server/utils.d.ts.map +1 -1
  179. package/dest/entrypoints/server/utils.js +54 -15
  180. package/dest/error_enriching.d.ts +5 -3
  181. package/dest/error_enriching.d.ts.map +1 -1
  182. package/dest/error_enriching.js +13 -11
  183. package/dest/events/event_service.d.ts +16 -8
  184. package/dest/events/event_service.d.ts.map +1 -1
  185. package/dest/events/event_service.js +46 -14
  186. package/dest/events/private_event_filter_validator.d.ts +3 -2
  187. package/dest/events/private_event_filter_validator.d.ts.map +1 -1
  188. package/dest/events/private_event_filter_validator.js +15 -0
  189. package/dest/hooks/authorize_utility_call.d.ts +41 -0
  190. package/dest/hooks/authorize_utility_call.d.ts.map +1 -0
  191. package/dest/hooks/authorize_utility_call.js +4 -0
  192. package/dest/hooks/execution_hooks.d.ts +62 -0
  193. package/dest/hooks/execution_hooks.d.ts.map +1 -0
  194. package/dest/hooks/execution_hooks.js +9 -0
  195. package/dest/hooks/index.d.ts +5 -0
  196. package/dest/hooks/index.d.ts.map +1 -0
  197. package/dest/hooks/index.js +2 -0
  198. package/dest/hooks/resolve_custom_request.d.ts +23 -0
  199. package/dest/hooks/resolve_custom_request.d.ts.map +1 -0
  200. package/dest/hooks/resolve_custom_request.js +3 -0
  201. package/dest/hooks/resolve_tagging_secret_strategy.d.ts +50 -0
  202. package/dest/hooks/resolve_tagging_secret_strategy.d.ts.map +1 -0
  203. package/dest/hooks/resolve_tagging_secret_strategy.js +3 -0
  204. package/dest/job_coordinator/job_coordinator.d.ts +3 -2
  205. package/dest/job_coordinator/job_coordinator.d.ts.map +1 -1
  206. package/dest/job_coordinator/job_coordinator.js +3 -2
  207. package/dest/logs/log_service.d.ts +17 -13
  208. package/dest/logs/log_service.d.ts.map +1 -1
  209. package/dest/logs/log_service.js +201 -91
  210. package/dest/messages/tx_resolver_service.d.ts +17 -0
  211. package/dest/messages/tx_resolver_service.d.ts.map +1 -0
  212. package/dest/messages/tx_resolver_service.js +60 -0
  213. package/dest/notes/note_service.d.ts +31 -9
  214. package/dest/notes/note_service.d.ts.map +1 -1
  215. package/dest/notes/note_service.js +95 -70
  216. package/dest/notes_filter.d.ts +24 -0
  217. package/dest/notes_filter.d.ts.map +1 -0
  218. package/dest/notes_filter.js +4 -0
  219. package/dest/oracle_version.d.ts +4 -3
  220. package/dest/oracle_version.d.ts.map +1 -1
  221. package/dest/oracle_version.js +20 -9
  222. package/dest/private_kernel/batch_planner.d.ts +47 -0
  223. package/dest/private_kernel/batch_planner.d.ts.map +1 -0
  224. package/dest/private_kernel/batch_planner.js +104 -0
  225. package/dest/private_kernel/hints/compute_tx_expiration_timestamp.d.ts +4 -0
  226. package/dest/private_kernel/hints/compute_tx_expiration_timestamp.d.ts.map +1 -0
  227. package/dest/private_kernel/hints/{compute_tx_include_by_timestamp.js → compute_tx_expiration_timestamp.js} +12 -12
  228. package/dest/private_kernel/hints/index.d.ts +1 -1
  229. package/dest/private_kernel/hints/index.js +1 -1
  230. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts +4 -3
  231. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts.map +1 -1
  232. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.js +135 -70
  233. package/dest/private_kernel/hints/test_utils.d.ts +122 -0
  234. package/dest/private_kernel/hints/test_utils.d.ts.map +1 -0
  235. package/dest/private_kernel/hints/test_utils.js +202 -0
  236. package/dest/private_kernel/private_kernel_execution_prover.d.ts +7 -2
  237. package/dest/private_kernel/private_kernel_execution_prover.d.ts.map +1 -1
  238. package/dest/private_kernel/private_kernel_execution_prover.js +209 -87
  239. package/dest/private_kernel/private_kernel_oracle.d.ts +17 -11
  240. package/dest/private_kernel/private_kernel_oracle.d.ts.map +1 -1
  241. package/dest/private_kernel/private_kernel_oracle.js +47 -29
  242. package/dest/pxe.d.ts +228 -66
  243. package/dest/pxe.d.ts.map +1 -1
  244. package/dest/pxe.js +418 -231
  245. package/dest/storage/address_store/address_store.d.ts +1 -1
  246. package/dest/storage/address_store/address_store.d.ts.map +1 -1
  247. package/dest/storage/address_store/address_store.js +12 -11
  248. package/dest/storage/allowed_scopes.d.ts +6 -0
  249. package/dest/storage/allowed_scopes.d.ts.map +1 -0
  250. package/dest/storage/allowed_scopes.js +7 -0
  251. package/dest/storage/anchor_block_store/anchor_block_store.d.ts +12 -1
  252. package/dest/storage/anchor_block_store/anchor_block_store.d.ts.map +1 -1
  253. package/dest/storage/anchor_block_store/anchor_block_store.js +12 -3
  254. package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.d.ts +42 -0
  255. package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.d.ts.map +1 -0
  256. package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.js +93 -0
  257. package/dest/storage/backwards_compatibility_tests/schema_tests.d.ts +15 -0
  258. package/dest/storage/backwards_compatibility_tests/schema_tests.d.ts.map +1 -0
  259. package/dest/storage/backwards_compatibility_tests/schema_tests.js +671 -0
  260. package/dest/storage/backwards_compatibility_tests/store_spy.d.ts +19 -0
  261. package/dest/storage/backwards_compatibility_tests/store_spy.d.ts.map +1 -0
  262. package/dest/storage/backwards_compatibility_tests/store_spy.js +63 -0
  263. package/dest/storage/capsule_store/capsule_service.d.ts +21 -0
  264. package/dest/storage/capsule_store/capsule_service.d.ts.map +1 -0
  265. package/dest/storage/capsule_store/capsule_service.js +47 -0
  266. package/dest/storage/capsule_store/capsule_store.d.ts +9 -9
  267. package/dest/storage/capsule_store/capsule_store.d.ts.map +1 -1
  268. package/dest/storage/capsule_store/capsule_store.js +42 -36
  269. package/dest/storage/capsule_store/index.d.ts +2 -1
  270. package/dest/storage/capsule_store/index.d.ts.map +1 -1
  271. package/dest/storage/capsule_store/index.js +1 -0
  272. package/dest/storage/contract_store/contract_store.d.ts +63 -34
  273. package/dest/storage/contract_store/contract_store.d.ts.map +1 -1
  274. package/dest/storage/contract_store/contract_store.js +191 -146
  275. package/dest/storage/fact_store/fact_service.d.ts +22 -0
  276. package/dest/storage/fact_store/fact_service.d.ts.map +1 -0
  277. package/dest/storage/fact_store/fact_service.js +45 -0
  278. package/dest/storage/fact_store/fact_store.d.ts +95 -0
  279. package/dest/storage/fact_store/fact_store.d.ts.map +1 -0
  280. package/dest/storage/fact_store/fact_store.js +408 -0
  281. package/dest/storage/fact_store/fact_store_keys.d.ts +34 -0
  282. package/dest/storage/fact_store/fact_store_keys.d.ts.map +1 -0
  283. package/dest/storage/fact_store/fact_store_keys.js +50 -0
  284. package/dest/storage/fact_store/index.d.ts +6 -0
  285. package/dest/storage/fact_store/index.d.ts.map +1 -0
  286. package/dest/storage/fact_store/index.js +4 -0
  287. package/dest/storage/fact_store/origin_state.d.ts +59 -0
  288. package/dest/storage/fact_store/origin_state.d.ts.map +1 -0
  289. package/dest/storage/fact_store/origin_state.js +60 -0
  290. package/dest/storage/fact_store/stored_fact.d.ts +32 -0
  291. package/dest/storage/fact_store/stored_fact.d.ts.map +1 -0
  292. package/dest/storage/fact_store/stored_fact.js +64 -0
  293. package/dest/storage/index.d.ts +3 -2
  294. package/dest/storage/index.d.ts.map +1 -1
  295. package/dest/storage/index.js +2 -1
  296. package/dest/storage/metadata.d.ts +2 -2
  297. package/dest/storage/metadata.d.ts.map +1 -1
  298. package/dest/storage/metadata.js +1 -1
  299. package/dest/storage/note_store/note_store.d.ts +63 -56
  300. package/dest/storage/note_store/note_store.d.ts.map +1 -1
  301. package/dest/storage/note_store/note_store.js +321 -266
  302. package/dest/storage/note_store/stored_note.d.ts +11 -0
  303. package/dest/storage/note_store/stored_note.d.ts.map +1 -0
  304. package/dest/storage/note_store/stored_note.js +27 -0
  305. package/dest/storage/open_pxe_stores.d.ts +35 -0
  306. package/dest/storage/open_pxe_stores.d.ts.map +1 -0
  307. package/dest/storage/open_pxe_stores.js +29 -0
  308. package/dest/storage/private_event_store/private_event_store.d.ts +26 -16
  309. package/dest/storage/private_event_store/private_event_store.d.ts.map +1 -1
  310. package/dest/storage/private_event_store/private_event_store.js +214 -163
  311. package/dest/storage/private_event_store/stored_private_event.d.ts +23 -0
  312. package/dest/storage/private_event_store/stored_private_event.d.ts.map +1 -0
  313. package/dest/storage/private_event_store/stored_private_event.js +56 -0
  314. package/dest/storage/store_identity.d.ts +35 -0
  315. package/dest/storage/store_identity.d.ts.map +1 -0
  316. package/dest/storage/store_identity.js +44 -0
  317. package/dest/storage/tagging_store/index.d.ts +2 -2
  318. package/dest/storage/tagging_store/index.d.ts.map +1 -1
  319. package/dest/storage/tagging_store/index.js +1 -1
  320. package/dest/storage/tagging_store/recipient_tagging_store.d.ts +6 -6
  321. package/dest/storage/tagging_store/recipient_tagging_store.d.ts.map +1 -1
  322. package/dest/storage/tagging_store/recipient_tagging_store.js +31 -19
  323. package/dest/storage/tagging_store/sender_tagging_store.d.ts +45 -28
  324. package/dest/storage/tagging_store/sender_tagging_store.d.ts.map +1 -1
  325. package/dest/storage/tagging_store/sender_tagging_store.js +270 -137
  326. package/dest/storage/tagging_store/tagging_secret_sources_store.d.ts +51 -0
  327. package/dest/storage/tagging_store/tagging_secret_sources_store.d.ts.map +1 -0
  328. package/dest/storage/tagging_store/tagging_secret_sources_store.js +105 -0
  329. package/dest/tagging/constants.d.ts +3 -2
  330. package/dest/tagging/constants.d.ts.map +1 -1
  331. package/dest/tagging/constants.js +28 -10
  332. package/dest/tagging/get_all_logs_by_tags.d.ts +48 -0
  333. package/dest/tagging/get_all_logs_by_tags.d.ts.map +1 -0
  334. package/dest/tagging/get_all_logs_by_tags.js +59 -0
  335. package/dest/tagging/index.d.ts +8 -6
  336. package/dest/tagging/index.d.ts.map +1 -1
  337. package/dest/tagging/index.js +6 -4
  338. package/dest/tagging/persist_sender_tagging_index_ranges.d.ts +29 -0
  339. package/dest/tagging/persist_sender_tagging_index_ranges.d.ts.map +1 -0
  340. package/dest/tagging/persist_sender_tagging_index_ranges.js +42 -0
  341. package/dest/tagging/recipient_sync/sync_tagged_private_logs.d.ts +74 -0
  342. package/dest/tagging/recipient_sync/sync_tagged_private_logs.d.ts.map +1 -0
  343. package/dest/tagging/recipient_sync/sync_tagged_private_logs.js +238 -0
  344. package/dest/tagging/recipient_sync/utils/find_highest_indexes.d.ts +3 -3
  345. package/dest/tagging/recipient_sync/utils/find_highest_indexes.d.ts.map +1 -1
  346. package/dest/tagging/recipient_sync/utils/find_highest_indexes.js +2 -2
  347. package/dest/tagging/reconcile_tagging_index_ranges.d.ts +36 -0
  348. package/dest/tagging/reconcile_tagging_index_ranges.d.ts.map +1 -0
  349. package/dest/tagging/reconcile_tagging_index_ranges.js +74 -0
  350. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts +5 -9
  351. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts.map +1 -1
  352. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.js +32 -14
  353. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts +13 -7
  354. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts.map +1 -1
  355. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.js +44 -16
  356. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts +6 -7
  357. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts.map +1 -1
  358. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.js +46 -27
  359. package/dest/tagging/testing/tag_query_test_utils.d.ts +6 -0
  360. package/dest/tagging/testing/tag_query_test_utils.d.ts.map +1 -0
  361. package/dest/tagging/testing/tag_query_test_utils.js +10 -0
  362. package/package.json +29 -17
  363. package/src/bin/check_oracle_version.ts +46 -134
  364. package/src/bin/index.ts +1 -0
  365. package/src/bin/oracle_version_helpers.ts +54 -0
  366. package/src/block_synchronizer/block_stream_source.ts +42 -0
  367. package/src/block_synchronizer/block_synchronizer.ts +154 -48
  368. package/src/config/index.ts +22 -1
  369. package/src/config/package_info.ts +1 -1
  370. package/src/contract/contract_class_service.ts +83 -0
  371. package/src/contract/contract_sync_service.ts +176 -0
  372. package/src/contract/helpers.ts +35 -0
  373. package/src/contract/skip_sync_contracts.ts +23 -0
  374. package/src/contract_function_simulator/anchored_contract_data.ts +74 -0
  375. package/src/contract_function_simulator/aztec_node_read_cache.ts +89 -0
  376. package/src/contract_function_simulator/contract_function_simulator.ts +463 -162
  377. package/src/contract_function_simulator/ephemeral_array_service.ts +110 -0
  378. package/src/contract_function_simulator/execution_note_cache.ts +8 -29
  379. package/src/contract_function_simulator/execution_tagging_index_cache.ts +19 -18
  380. package/src/contract_function_simulator/index.ts +89 -4
  381. package/src/contract_function_simulator/noir-structs/bounded_vec.ts +43 -0
  382. package/src/contract_function_simulator/noir-structs/contract_class_log_data.ts +9 -0
  383. package/src/contract_function_simulator/noir-structs/embedded_curve_point.ts +4 -0
  384. package/src/contract_function_simulator/noir-structs/ephemeral_array.ts +66 -0
  385. package/src/contract_function_simulator/noir-structs/event_validation_request.ts +11 -10
  386. package/src/contract_function_simulator/noir-structs/fact.ts +13 -0
  387. package/src/contract_function_simulator/noir-structs/fact_collection.ts +64 -0
  388. package/src/contract_function_simulator/noir-structs/log_retrieval_request.ts +27 -20
  389. package/src/contract_function_simulator/noir-structs/log_retrieval_response.ts +14 -64
  390. package/src/contract_function_simulator/noir-structs/note_data.ts +27 -0
  391. package/src/contract_function_simulator/noir-structs/note_validation_request.ts +7 -12
  392. package/src/contract_function_simulator/noir-structs/option.ts +75 -0
  393. package/src/contract_function_simulator/noir-structs/origin_block.ts +8 -0
  394. package/src/contract_function_simulator/noir-structs/pending_tagged_log.ts +12 -0
  395. package/src/contract_function_simulator/noir-structs/provided_secret.ts +5 -0
  396. package/src/contract_function_simulator/noir-structs/resolved_tagging_strategy.ts +66 -0
  397. package/src/contract_function_simulator/noir-structs/resolved_tx.ts +19 -0
  398. package/src/contract_function_simulator/noir-structs/tx_effect_data.ts +16 -0
  399. package/src/contract_function_simulator/noir-structs/utility_context.ts +5 -17
  400. package/src/contract_function_simulator/oracle/acir_callback.ts +154 -0
  401. package/src/contract_function_simulator/oracle/index.ts +1 -15
  402. package/src/contract_function_simulator/oracle/interfaces.ts +11 -167
  403. package/src/contract_function_simulator/oracle/legacy_oracle_registry.ts +147 -0
  404. package/src/contract_function_simulator/oracle/message_load_oracle_inputs.ts +6 -21
  405. package/src/contract_function_simulator/oracle/note_packing_utils.ts +3 -3
  406. package/src/contract_function_simulator/oracle/oracle_registry.ts +710 -0
  407. package/src/contract_function_simulator/oracle/oracle_type_mappings.ts +1052 -0
  408. package/src/contract_function_simulator/oracle/private_execution.ts +7 -67
  409. package/src/contract_function_simulator/oracle/private_execution_oracle.ts +340 -213
  410. package/src/contract_function_simulator/oracle/utility_execution_oracle.ts +966 -275
  411. package/src/contract_function_simulator/pick_notes.ts +22 -3
  412. package/src/contract_function_simulator/transient_array_service.ts +91 -0
  413. package/src/contract_logging.ts +52 -0
  414. package/src/debug/pxe_debug_utils.ts +55 -18
  415. package/src/entrypoints/client/bundle/index.ts +3 -0
  416. package/src/entrypoints/client/bundle/utils.ts +46 -21
  417. package/src/entrypoints/client/lazy/index.ts +3 -0
  418. package/src/entrypoints/client/lazy/utils.ts +48 -22
  419. package/src/entrypoints/client/store.ts +54 -0
  420. package/src/entrypoints/pxe_creation_options.ts +23 -2
  421. package/src/entrypoints/server/index.ts +8 -1
  422. package/src/entrypoints/server/store.ts +47 -0
  423. package/src/entrypoints/server/utils.ts +61 -34
  424. package/src/error_enriching.ts +27 -11
  425. package/src/events/event_service.ts +70 -24
  426. package/src/events/private_event_filter_validator.ts +21 -1
  427. package/src/hooks/authorize_utility_call.ts +44 -0
  428. package/src/hooks/execution_hooks.ts +68 -0
  429. package/src/hooks/index.ts +13 -0
  430. package/src/hooks/resolve_custom_request.ts +24 -0
  431. package/src/hooks/resolve_tagging_secret_strategy.ts +60 -0
  432. package/src/job_coordinator/job_coordinator.ts +4 -3
  433. package/src/logs/log_service.ts +248 -152
  434. package/src/messages/tx_resolver_service.ts +69 -0
  435. package/src/notes/note_service.ts +137 -101
  436. package/src/notes_filter.ts +24 -0
  437. package/src/oracle_version.ts +20 -9
  438. package/src/private_kernel/batch_planner.ts +168 -0
  439. package/src/private_kernel/hints/{compute_tx_include_by_timestamp.ts → compute_tx_expiration_timestamp.ts} +13 -13
  440. package/src/private_kernel/hints/index.ts +1 -1
  441. package/src/private_kernel/hints/private_kernel_reset_private_inputs_builder.ts +176 -119
  442. package/src/private_kernel/hints/test_utils.ts +318 -0
  443. package/src/private_kernel/private_kernel_execution_prover.ts +347 -123
  444. package/src/private_kernel/private_kernel_oracle.ts +65 -36
  445. package/src/pxe.ts +732 -297
  446. package/src/storage/address_store/address_store.ts +15 -15
  447. package/src/storage/allowed_scopes.ts +14 -0
  448. package/src/storage/anchor_block_store/anchor_block_store.ts +12 -2
  449. package/src/storage/backwards_compatibility_tests/__snapshots__/AddressStore.json +22 -0
  450. package/src/storage/backwards_compatibility_tests/__snapshots__/AnchorBlockStore.json +3 -0
  451. package/src/storage/backwards_compatibility_tests/__snapshots__/CapsuleStore.json +16 -0
  452. package/src/storage/backwards_compatibility_tests/__snapshots__/ContractStore.json +28 -0
  453. package/src/storage/backwards_compatibility_tests/__snapshots__/FactStore.json +40 -0
  454. package/src/storage/backwards_compatibility_tests/__snapshots__/KeyStore.json +52 -0
  455. package/src/storage/backwards_compatibility_tests/__snapshots__/L2TipsKVStore.json +40 -0
  456. package/src/storage/backwards_compatibility_tests/__snapshots__/NoteStore.json +56 -0
  457. package/src/storage/backwards_compatibility_tests/__snapshots__/PrivateEventStore.json +44 -0
  458. package/src/storage/backwards_compatibility_tests/__snapshots__/RecipientTaggingStore.json +26 -0
  459. package/src/storage/backwards_compatibility_tests/__snapshots__/SenderTaggingStore.json +30 -0
  460. package/src/storage/backwards_compatibility_tests/__snapshots__/TaggingSecretSourcesStore.json +30 -0
  461. package/src/storage/backwards_compatibility_tests/__snapshots__/opened_stores.json +117 -0
  462. package/src/storage/backwards_compatibility_tests/kv_store_snapshot.ts +122 -0
  463. package/src/storage/backwards_compatibility_tests/schema_tests.ts +803 -0
  464. package/src/storage/backwards_compatibility_tests/store_spy.ts +73 -0
  465. package/src/storage/capsule_store/capsule_service.ts +85 -0
  466. package/src/storage/capsule_store/capsule_store.ts +52 -34
  467. package/src/storage/capsule_store/index.ts +1 -0
  468. package/src/storage/contract_store/contract_store.ts +247 -185
  469. package/src/storage/fact_store/fact_service.ts +69 -0
  470. package/src/storage/fact_store/fact_store.ts +487 -0
  471. package/src/storage/fact_store/fact_store_keys.ts +75 -0
  472. package/src/storage/fact_store/index.ts +15 -0
  473. package/src/storage/fact_store/origin_state.ts +84 -0
  474. package/src/storage/fact_store/stored_fact.ts +80 -0
  475. package/src/storage/index.ts +2 -1
  476. package/src/storage/metadata.ts +1 -1
  477. package/src/storage/note_store/note_store.ts +363 -324
  478. package/src/storage/note_store/stored_note.ts +26 -0
  479. package/src/storage/open_pxe_stores.ts +52 -0
  480. package/src/storage/private_event_store/private_event_store.ts +268 -210
  481. package/src/storage/private_event_store/stored_private_event.ts +73 -0
  482. package/src/storage/store_identity.ts +72 -0
  483. package/src/storage/tagging_store/index.ts +1 -1
  484. package/src/storage/tagging_store/recipient_tagging_store.ts +34 -24
  485. package/src/storage/tagging_store/sender_tagging_store.ts +333 -155
  486. package/src/storage/tagging_store/tagging_secret_sources_store.ts +138 -0
  487. package/src/tagging/constants.ts +30 -10
  488. package/src/tagging/get_all_logs_by_tags.ts +120 -0
  489. package/src/tagging/index.ts +7 -5
  490. package/src/tagging/persist_sender_tagging_index_ranges.ts +57 -0
  491. package/src/tagging/recipient_sync/sync_tagged_private_logs.ts +358 -0
  492. package/src/tagging/recipient_sync/utils/find_highest_indexes.ts +4 -4
  493. package/src/tagging/reconcile_tagging_index_ranges.ts +102 -0
  494. package/src/tagging/sender_sync/sync_sender_tagging_indexes.ts +54 -17
  495. package/src/tagging/sender_sync/utils/get_status_change_of_pending.ts +47 -29
  496. package/src/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.ts +42 -29
  497. package/src/tagging/testing/tag_query_test_utils.ts +11 -0
  498. package/dest/contract_function_simulator/oracle/oracle.d.ts +0 -58
  499. package/dest/contract_function_simulator/oracle/oracle.d.ts.map +0 -1
  500. package/dest/contract_function_simulator/oracle/oracle.js +0 -346
  501. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts +0 -6
  502. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts.map +0 -1
  503. package/dest/contract_function_simulator/proxied_contract_data_source.js +0 -80
  504. package/dest/private_kernel/hints/compute_tx_include_by_timestamp.d.ts +0 -4
  505. package/dest/private_kernel/hints/compute_tx_include_by_timestamp.d.ts.map +0 -1
  506. package/dest/storage/tagging_store/sender_address_book_store.d.ts +0 -14
  507. package/dest/storage/tagging_store/sender_address_book_store.d.ts.map +0 -1
  508. package/dest/storage/tagging_store/sender_address_book_store.js +0 -30
  509. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts +0 -14
  510. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts.map +0 -1
  511. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.js +0 -99
  512. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts +0 -14
  513. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts.map +0 -1
  514. package/dest/tagging/recipient_sync/utils/load_logs_for_range.js +0 -29
  515. package/dest/tree_membership/tree_membership_service.d.ts +0 -50
  516. package/dest/tree_membership/tree_membership_service.d.ts.map +0 -1
  517. package/dest/tree_membership/tree_membership_service.js +0 -75
  518. package/src/contract_function_simulator/oracle/oracle.ts +0 -607
  519. package/src/contract_function_simulator/proxied_contract_data_source.ts +0 -83
  520. package/src/storage/tagging_store/sender_address_book_store.ts +0 -42
  521. package/src/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.ts +0 -133
  522. package/src/tagging/recipient_sync/utils/load_logs_for_range.ts +0 -43
  523. package/src/tree_membership/tree_membership_service.ts +0 -97
@@ -0,0 +1,358 @@
1
+ import { BlockNumber } from '@aztec/foundation/branded-types';
2
+ import { isDefined } from '@aztec/foundation/types';
3
+ import type { BlockHash } from '@aztec/stdlib/block';
4
+ import type { AztecNode } from '@aztec/stdlib/interfaces/client';
5
+ import type { AppTaggingSecret, LogResult } from '@aztec/stdlib/logs';
6
+ import { AppTaggingSecretKind, SiloedTag } from '@aztec/stdlib/logs';
7
+ import type { BlockHeader } from '@aztec/stdlib/tx';
8
+
9
+ import type { RecipientTaggingStore } from '../../storage/tagging_store/recipient_tagging_store.js';
10
+ import { INITIAL_CONSTRAINED_PROBE_LEN, UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN } from '../constants.js';
11
+ import { getAllPrivateLogsByTags } from '../get_all_logs_by_tags.js';
12
+ import { findHighestIndexes } from './utils/find_highest_indexes.js';
13
+
14
+ /**
15
+ * Fetches and syncs tagged private logs for multiple sender-recipient pairs, batching tag queries across all secrets
16
+ * into shared RPC calls. Handles both constrained and unconstrained secrets, which differ in their scan strategy
17
+ * but share the same batching infrastructure.
18
+ *
19
+ * # Unconstrained secrets
20
+ *
21
+ * For each unconstrained secret we sync logs that correspond to the tagging index range
22
+ * (highestAgedIndex, highestFinalizedIndex + WINDOW_LEN]
23
+ *
24
+ * highestAgedIndex is the highest index that was used in a tx that is included in a block at least
25
+ * `MAX_TX_LIFETIME` seconds ago.
26
+ * highestFinalizedIndex is the highest index that was used in a tx that is included in a finalized block.
27
+ *
28
+ * "(" denotes an open end of the range - the index is not included in the range.
29
+ * "]" denotes a closed end of the range - the index is included in the range.
30
+ *
31
+ * ## Explanation of highestAgedIndex
32
+ *
33
+ * highestAgedIndex is chosen such that for all tagging indexes `i <= highestAgedIndex` we know that no new logs can
34
+ * ever appear.
35
+ *
36
+ * This relies on the "maximum inclusion timestamp" rule enforced by the kernel and rollup circuits:
37
+ * - a transaction's maximum inclusion timestamp is at most `MAX_TX_LIFETIME` seconds after
38
+ * the timestamp of its anchor block; and
39
+ * - a rollup only includes transactions whose inclusion timestamp is >= the L2 block's timestamp.
40
+ *
41
+ * Suppose some device used index `I` in a transaction anchored to block `B_N` at time `N`, and that block is now at
42
+ * least `MAX_TX_LIFETIME` seconds in the past. Then there is no possibility of any *other* device
43
+ * trying to use an index <= `I` while anchoring to a *newer* block than `B_N` because if we were anchoring to
44
+ * a newer block than `B_N` then we would already have seen the log with index `I` and hence the device would have
45
+ * chosen a larger index.
46
+ * If that *other* device would anchor to a block older than `B_N` then that tx could never be included in a block
47
+ * because it would already have been expired.
48
+ *
49
+ * Therefore, once we see that index `I` has been used in a block that is at least `MAX_TX_LIFETIME`
50
+ * seconds old, we can safely stop syncing logs for all indexes <= `I` and set highestAgedIndex = `I`.
51
+ *
52
+ * ## Explanation of the upper bound `highestFinalizedIndex + WINDOW_LEN`
53
+ *
54
+ * When a sender chooses a tagging index, they will select an index that is at most `WINDOW_LEN` greater than
55
+ * the highest finalized index. If that index was already used, they will throw an error. For this reason we
56
+ * don't have to look further than `highestFinalizedIndex + WINDOW_LEN`.
57
+ *
58
+ * # Constrained secrets
59
+ *
60
+ * Constrained delivery enforces a contiguous index sequence (each send proves the predecessor's nullifier,
61
+ * chaining back to the handshake), so there is only one sender and indexes are sequential. This means:
62
+ * - The lower bound is `highestFinalizedIndex + 1`. The `highestAgedIndex` mechanism is unnecessary because
63
+ * the nullifier chain prevents out-of-order index usage: no device can fill in a lower index after a higher
64
+ * one is already on-chain.
65
+ * - Because the sequence is gapless, the scan stops at the first missing index: that gap proves the sequence has
66
+ * ended and no further logs exist. We exploit this with a doubling first-miss probe (see
67
+ * `INITIAL_CONSTRAINED_PROBE_LEN` in ../constants.ts), so a
68
+ * steady-state sync with no new logs costs two tags instead of the whole window. The probe length is in-memory
69
+ * state scoped to one sync call, so every sync restarts at the initial probe.
70
+ * - The upper bound is the same as unconstrained: `highestFinalizedIndex + WINDOW_LEN`. Advancing the probe is
71
+ * decoupled from persisting the finalized index, so unfinalized logs at the top of the run are still fetched
72
+ * while only the finalized prefix is persisted.
73
+ *
74
+ * # Batching across secrets
75
+ *
76
+ * Instead of running one RPC call per secret, we merge tags from all pending secrets (both constrained and
77
+ * unconstrained) into a single flat array, make one batched `getAllPrivateLogsByTags` call (which internally
78
+ * chunks at MAX_RPC_LEN), then split results back per secret using tracked offsets. Only secrets whose window
79
+ * advanced are kept for the next iteration.
80
+ */
81
+ export async function syncTaggedPrivateLogs(
82
+ secrets: AppTaggingSecret[],
83
+ aztecNode: AztecNode,
84
+ taggingStore: RecipientTaggingStore,
85
+ anchorBlockHeader: BlockHeader,
86
+ finalizedBlockNumber: BlockNumber,
87
+ jobId: string,
88
+ ): Promise<LogResult[]> {
89
+ if (secrets.length === 0) {
90
+ return [];
91
+ }
92
+
93
+ const anchorBlockNumber = anchorBlockHeader.getBlockNumber();
94
+ const anchorBlockHash = await anchorBlockHeader.hash();
95
+ const currentTimestamp = anchorBlockHeader.globalVariables.timestamp;
96
+
97
+ // Read stored indexes from the db and compute the initial [start, end) range for each secret
98
+ let pending = await getIndexRangesForSecrets(secrets, taggingStore, jobId);
99
+ const allLogs: LogResult[] = [];
100
+
101
+ while (pending.length > 0) {
102
+ // Compute tags for all pending secrets and fetch logs in batched RPC calls
103
+ const logsPerSecret = await fetchLogsForSecrets(pending, aztecNode, anchorBlockNumber, anchorBlockHash);
104
+
105
+ const nextRound = await Promise.all(
106
+ pending.map(async (pendingSecret, i) => {
107
+ const logsFoundWithSecret = logsPerSecret[i];
108
+ if (logsFoundWithSecret.length === 0) {
109
+ // No logs found, no need to update indexes or advance window.
110
+ return undefined;
111
+ }
112
+
113
+ allLogs.push(...logsFoundWithSecret.map(({ log }) => log));
114
+
115
+ // Persist new indexes. If the finalized index moved forward, the window advances
116
+ // and we need another round for this secret.
117
+ return pendingSecret.kind === AppTaggingSecretKind.CONSTRAINED
118
+ ? await processConstrainedResults(
119
+ pendingSecret,
120
+ logsFoundWithSecret,
121
+ taggingStore,
122
+ currentTimestamp,
123
+ finalizedBlockNumber,
124
+ jobId,
125
+ )
126
+ : await processUnconstrainedResults(
127
+ pendingSecret,
128
+ logsFoundWithSecret,
129
+ taggingStore,
130
+ currentTimestamp,
131
+ finalizedBlockNumber,
132
+ jobId,
133
+ );
134
+ }),
135
+ );
136
+
137
+ pending = nextRound.filter(isDefined);
138
+ }
139
+
140
+ return allLogs;
141
+ }
142
+
143
+ /** Reads stored indexes for each secret and computes the initial index range to query. */
144
+ function getIndexRangesForSecrets(
145
+ secrets: AppTaggingSecret[],
146
+ taggingStore: RecipientTaggingStore,
147
+ jobId: string,
148
+ ): Promise<PendingSecret[]> {
149
+ return Promise.all(
150
+ secrets.map(async (secret): Promise<PendingSecret> => {
151
+ const currentHighestFinalizedIndex = await taggingStore.getHighestFinalizedIndex(secret, jobId);
152
+ const boundEnd = (currentHighestFinalizedIndex ?? 0) + UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN + 1;
153
+
154
+ if (secret.kind === AppTaggingSecretKind.CONSTRAINED) {
155
+ // Constrained streams are gapless and resume at the finalized index, so probe a small initial window and stop
156
+ // at the first missing tag instead of always fetching the full window. The probe grows each round up to the
157
+ // window cap.
158
+ const start = currentHighestFinalizedIndex === undefined ? 0 : currentHighestFinalizedIndex + 1;
159
+ return {
160
+ kind: AppTaggingSecretKind.CONSTRAINED,
161
+ secret,
162
+ start,
163
+ end: Math.min(boundEnd, start + INITIAL_CONSTRAINED_PROBE_LEN),
164
+ boundEnd,
165
+ probeLen: INITIAL_CONSTRAINED_PROBE_LEN,
166
+ };
167
+ }
168
+
169
+ // Unconstrained secrets can have gaps, so they scan the whole window starting past the highest aged index.
170
+ const highestAgedIndex = await taggingStore.getHighestAgedIndex(secret, jobId);
171
+ const start = highestAgedIndex === undefined ? 0 : highestAgedIndex + 1;
172
+ return { kind: AppTaggingSecretKind.UNCONSTRAINED, secret, start, end: boundEnd };
173
+ }),
174
+ );
175
+ }
176
+
177
+ /**
178
+ * Computes siloed tags for all pending secrets' index ranges, fetches logs in one batched RPC call,
179
+ * and returns the results grouped back per secret.
180
+ */
181
+ async function fetchLogsForSecrets(
182
+ pending: PendingSecret[],
183
+ aztecNode: AztecNode,
184
+ anchorBlockNumber: BlockNumber,
185
+ anchorBlockHash: BlockHash,
186
+ ): Promise<LogWithIndex[][]> {
187
+ // Determine the index range for each secret
188
+ const indexesPerSecret = pending.map(({ start, end }) => Array.from({ length: end - start }, (_, i) => start + i));
189
+
190
+ // Compute siloed tags for all indexes
191
+ const tagsPerSecret = await Promise.all(
192
+ pending.map(({ secret }, i) =>
193
+ Promise.all(indexesPerSecret[i].map(index => SiloedTag.compute({ extendedSecret: secret, index }))),
194
+ ),
195
+ );
196
+
197
+ const allTags = tagsPerSecret.flat();
198
+
199
+ // getAllPrivateLogsByTags handles MAX_RPC_LEN chunking internally. Recipient sync builds `PendingTaggedLog` from
200
+ // each log's note hashes and first nullifier, so we opt into effects. The `toBlock` cap (anchor block + 1,
201
+ // exclusive) tells the node to skip any logs in blocks past the anchor — the same guard previously enforced
202
+ // by an in-memory filter on the response.
203
+ const allResults = await getAllPrivateLogsByTags(aztecNode, allTags, anchorBlockHash, {
204
+ includeEffects: true,
205
+ toBlock: BlockNumber(anchorBlockNumber + 1),
206
+ });
207
+
208
+ // Split flat results back per secret using the known lengths
209
+ const logsPerSecret: LogWithIndex[][] = [];
210
+ let offset = 0;
211
+ for (const indexes of indexesPerSecret) {
212
+ const logsForSecret: LogWithIndex[] = [];
213
+ for (let i = 0; i < indexes.length; i++) {
214
+ for (const log of allResults[offset + i]) {
215
+ logsForSecret.push({ log, taggingIndex: indexes[i] });
216
+ }
217
+ }
218
+ logsPerSecret.push(logsForSecret);
219
+ offset += indexes.length;
220
+ }
221
+
222
+ return logsPerSecret;
223
+ }
224
+
225
+ /**
226
+ * Processes fetched logs for a constrained secret: persists the finalized index and advances the probe. See the
227
+ * "# Constrained secrets" section above for why the scan stops at the first missing index. Only `highestFinalizedIndex`
228
+ * is tracked (no aged index).
229
+ */
230
+ async function processConstrainedResults(
231
+ pending: PendingConstrained,
232
+ logsWithIndexes: LogWithIndex[],
233
+ taggingStore: RecipientTaggingStore,
234
+ currentTimestamp: bigint,
235
+ finalizedBlockNumber: BlockNumber,
236
+ jobId: string,
237
+ ): Promise<PendingSecret | undefined> {
238
+ // Find where the contiguous run of indexes ends; all logs in the batch fall within this prefix.
239
+ const indexesWithLogs = new Set(logsWithIndexes.map(l => l.taggingIndex));
240
+ let firstMissingIndex = pending.start;
241
+ while (firstMissingIndex < pending.end && indexesWithLogs.has(firstMissingIndex)) {
242
+ firstMissingIndex++;
243
+ }
244
+
245
+ // Persist the highest finalized index found. The nullifier for a constrained-delivery log is emitted in the same
246
+ // transaction, guaranteeing the log cannot disappear once included, so we persist even when a gap stops the scan.
247
+ // This lets the next sync round skip already-finalized indexes.
248
+ const { highestFinalizedIndex } = findHighestIndexes(logsWithIndexes, currentTimestamp, finalizedBlockNumber);
249
+ if (highestFinalizedIndex !== undefined) {
250
+ await taggingStore.updateHighestFinalizedIndex(pending.secret, highestFinalizedIndex, jobId);
251
+ }
252
+
253
+ // Advancing the probe is decoupled from persisting the finalized index: keep scanning as long as the probe was
254
+ // entirely hits (no gap) and there is room before the protocol bound, even if none of those hits is finalized yet.
255
+ // Gating this on finalization would drop logs in unfinalized blocks, which sit at the top of the contiguous run.
256
+ // The bound re-anchors to any finalized index found this round.
257
+ const probeFullyConsumed = firstMissingIndex >= pending.end;
258
+ const boundEnd =
259
+ highestFinalizedIndex !== undefined
260
+ ? Math.max(pending.boundEnd, highestFinalizedIndex + UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN + 1)
261
+ : pending.boundEnd;
262
+
263
+ // Double the probe each round, capped at the window (see INITIAL_CONSTRAINED_PROBE_LEN in ../constants.ts).
264
+ // The queried range is already bounded by boundEnd (a probe can never reach
265
+ // more than WINDOW_LEN past the finalized frontier); this cap just keeps the stored length from growing unbounded
266
+ // once the probe saturates the window.
267
+ const nextProbeLen = Math.min(pending.probeLen * 2, UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN);
268
+
269
+ if (probeFullyConsumed && pending.end < boundEnd) {
270
+ return {
271
+ kind: AppTaggingSecretKind.CONSTRAINED,
272
+ secret: pending.secret,
273
+ start: pending.end,
274
+ end: Math.min(boundEnd, pending.end + nextProbeLen),
275
+ boundEnd,
276
+ probeLen: nextProbeLen,
277
+ };
278
+ }
279
+
280
+ return undefined;
281
+ }
282
+
283
+ /**
284
+ * Processes a single unconstrained secret's fetched logs: updates stored indexes and returns a new PendingSecret
285
+ * if the window needs to advance, or undefined if this secret is done.
286
+ */
287
+ async function processUnconstrainedResults(
288
+ pending: PendingUnconstrained,
289
+ logsWithIndexes: LogWithIndex[],
290
+ taggingStore: RecipientTaggingStore,
291
+ currentTimestamp: bigint,
292
+ finalizedBlockNumber: BlockNumber,
293
+ jobId: string,
294
+ ): Promise<PendingSecret | undefined> {
295
+ const { highestAgedIndex, highestFinalizedIndex } = findHighestIndexes(
296
+ logsWithIndexes,
297
+ currentTimestamp,
298
+ finalizedBlockNumber,
299
+ );
300
+
301
+ // Store updates in data provider and update local variables
302
+ if (highestAgedIndex !== undefined) {
303
+ await taggingStore.updateHighestAgedIndex(pending.secret, highestAgedIndex, jobId);
304
+ }
305
+
306
+ if (highestFinalizedIndex === undefined) {
307
+ // We have not found a new highest finalized index, so there is no need to move the window forward.
308
+ return undefined;
309
+ }
310
+
311
+ if (highestAgedIndex !== undefined && highestAgedIndex > highestFinalizedIndex) {
312
+ // This is just a sanity check as this should never happen.
313
+ throw new Error(
314
+ `Highest aged index (${highestAgedIndex}) must not exceed highest finalized index (${highestFinalizedIndex})`,
315
+ );
316
+ }
317
+
318
+ await taggingStore.updateHighestFinalizedIndex(pending.secret, highestFinalizedIndex, jobId);
319
+
320
+ // For the next iteration we want to look only at indexes for which we have not yet fetched logs while
321
+ // ensuring that we do not look further than WINDOW_LEN ahead of the highest finalized index.
322
+ const end = highestFinalizedIndex + UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN + 1;
323
+ return {
324
+ kind: AppTaggingSecretKind.UNCONSTRAINED,
325
+ secret: pending.secret,
326
+ start: pending.end,
327
+ end,
328
+ };
329
+ }
330
+
331
+ /** Working scan state common to both secret kinds: the half-open [start, end) tag-index range to query this round. */
332
+ type PendingSecretBase = {
333
+ secret: AppTaggingSecret;
334
+ start: number;
335
+ end: number;
336
+ };
337
+
338
+ /** Constrained scan state, carrying the doubling-probe bookkeeping that only the gapless constrained scan uses. */
339
+ type PendingConstrained = PendingSecretBase & {
340
+ kind: typeof AppTaggingSecretKind.CONSTRAINED;
341
+ // Exclusive upper bound on the indexes this secret may probe this sync (highest finalized index + WINDOW_LEN + 1, the
342
+ // protocol bound on how far ahead of finalized a log can sit). `end` grows toward it each round.
343
+ boundEnd: number;
344
+ // Intended probe length for the round that produced `end`. The queried span can be smaller when boundEnd caps it.
345
+ probeLen: number;
346
+ };
347
+
348
+ /** Unconstrained scan state: a plain window with no probe bookkeeping, since the scan always covers the full window. */
349
+ type PendingUnconstrained = PendingSecretBase & {
350
+ kind: typeof AppTaggingSecretKind.UNCONSTRAINED;
351
+ };
352
+
353
+ type PendingSecret = PendingConstrained | PendingUnconstrained;
354
+
355
+ type LogWithIndex = {
356
+ log: LogResult;
357
+ taggingIndex: number;
358
+ };
@@ -1,11 +1,11 @@
1
- import { MAX_INCLUDE_BY_TIMESTAMP_DURATION } from '@aztec/constants';
2
- import type { TxScopedL2Log } from '@aztec/stdlib/logs';
1
+ import { MAX_TX_LIFETIME } from '@aztec/constants';
2
+ import type { LogResult } from '@aztec/stdlib/logs';
3
3
 
4
4
  /**
5
5
  * Finds the highest aged and the highest finalized tagging indexes.
6
6
  */
7
7
  export function findHighestIndexes(
8
- privateLogsWithIndexes: Array<{ log: TxScopedL2Log; taggingIndex: number }>,
8
+ privateLogsWithIndexes: Array<{ log: LogResult; taggingIndex: number }>,
9
9
  currentTimestamp: bigint,
10
10
  finalizedBlockNumber: number,
11
11
  ): { highestAgedIndex: number | undefined; highestFinalizedIndex: number | undefined } {
@@ -16,7 +16,7 @@ export function findHighestIndexes(
16
16
  const ageInSeconds = currentTimestamp - log.blockTimestamp;
17
17
 
18
18
  if (
19
- ageInSeconds >= BigInt(MAX_INCLUDE_BY_TIMESTAMP_DURATION) &&
19
+ ageInSeconds >= BigInt(MAX_TX_LIFETIME) &&
20
20
  (highestAgedIndex === undefined || taggingIndex > highestAgedIndex)
21
21
  ) {
22
22
  highestAgedIndex = taggingIndex;
@@ -0,0 +1,102 @@
1
+ import { type AppTaggingSecret, SiloedTag, type TaggingIndexRange } from '@aztec/stdlib/logs';
2
+
3
+ /**
4
+ * Reconciles tagging index ranges recorded by the PXE during private execution against the set of siloed tags whose
5
+ * private logs survived to the final kernel output.
6
+ *
7
+ * Each input range is the contiguous `[lowestIndex, highestIndex]` set of indexes that the tagging index cache
8
+ * reserved for a given tagging secret while a tx was being executed. The kernel may then squash some of those logs
9
+ * (e.g. when a note is created and nullified within the same tx, taking its log with it), so the actual on-chain
10
+ * footprint can be a strict subset of what was reserved.
11
+ *
12
+ * For each input range, this function shrinks `[lowestIndex, highestIndex]` so that both bounds correspond to indexes
13
+ * that actually survived, trimming any dropped indices at the front or the back. It is possible that some interior
14
+ * indexes were also dropped, leaving gaps between the lowest and highest indices, but we ignore those and accept the
15
+ * resulting inefficiency rather than complicate the tagging model with one in which transactions may use interleaved
16
+ * indices.
17
+ *
18
+ * Trimming tailing indices (e.g. `highestIndex`) is highly useful as it lets us reuse those indices in future
19
+ * transactions. Trimming indices at the front (e.g. `lowestIndex`) is not as impactful since we will not ever use a
20
+ * tagging index if a larger one exists (same as with gaps), but it does help in both making the consistency check
21
+ * between database and transaction effects cheaper (as there's fewer logs to test) and making the database more
22
+ * accurately reflect reality.
23
+ *
24
+ * Ranges with no surviving indexes are dropped from the output entirely.
25
+ *
26
+ * Example scenario:
27
+ * - used indexes 3 to 7, kerel squashed indexes 3, 5, and 7:
28
+ * - range: [3, 7]
29
+ * - survived: set(3, 5, 7)
30
+ * - output: [4, 6] (trimmed from both ends, gap at 5 is tolerated)
31
+ *
32
+ * @param ranges - The tagging index ranges as recorded during private execution (pre-squash).
33
+ * @param survivingTags - The set of siloed tag values (as strings) of private logs that survived kernel squashing.
34
+ * @returns The reconciled ranges, with bounds tightened to surviving indexes and fully-squashed ranges removed.
35
+ */
36
+ export async function reconcileTaggingIndexRangesAgainstSurvivingTags(
37
+ ranges: TaggingIndexRange[],
38
+ survivingTags: Set<string>,
39
+ ): Promise<TaggingIndexRange[]> {
40
+ const reconciled: TaggingIndexRange[] = [];
41
+
42
+ for (const range of ranges) {
43
+ const newLowestIndex = await findFirstSurvivingIndex(
44
+ range.extendedSecret,
45
+ range.lowestIndex,
46
+ range.highestIndex,
47
+ survivingTags,
48
+ );
49
+ if (newLowestIndex === undefined) {
50
+ // No index in this range corresponds to a surviving log: the entire range was squashed.
51
+ continue;
52
+ }
53
+
54
+ // newLowestIndex is itself a survivor, so the backward scan is guaranteed to find at least that index.
55
+ const newHighestIndex = await findLastSurvivingIndex(
56
+ range.extendedSecret,
57
+ newLowestIndex,
58
+ range.highestIndex,
59
+ survivingTags,
60
+ );
61
+
62
+ reconciled.push({
63
+ extendedSecret: range.extendedSecret,
64
+ lowestIndex: newLowestIndex,
65
+ highestIndex: newHighestIndex!,
66
+ });
67
+ }
68
+
69
+ return reconciled;
70
+ }
71
+
72
+ /** Scans `[start, end]` ascending and returns the first index whose siloed tag is in `survivingTags`. */
73
+ async function findFirstSurvivingIndex(
74
+ secret: AppTaggingSecret,
75
+ start: number,
76
+ end: number,
77
+ survivingTags: Set<string>,
78
+ ): Promise<number | undefined> {
79
+ for (let index = start; index <= end; index++) {
80
+ const tag = await SiloedTag.compute({ extendedSecret: secret, index });
81
+ if (survivingTags.has(tag.value.toString())) {
82
+ return index;
83
+ }
84
+ }
85
+ return undefined;
86
+ }
87
+
88
+ /** Scans `[start, end]` descending and returns the first index whose siloed tag is in `survivingTags`. */
89
+ async function findLastSurvivingIndex(
90
+ secret: AppTaggingSecret,
91
+ start: number,
92
+ end: number,
93
+ survivingTags: Set<string>,
94
+ ): Promise<number | undefined> {
95
+ for (let index = end; index >= start; index--) {
96
+ const tag = await SiloedTag.compute({ extendedSecret: secret, index });
97
+ if (survivingTags.has(tag.value.toString())) {
98
+ return index;
99
+ }
100
+ }
101
+ return undefined;
102
+ }
@@ -1,20 +1,20 @@
1
- import type { AztecAddress } from '@aztec/stdlib/aztec-address';
1
+ import type { BlockHash } from '@aztec/stdlib/block';
2
2
  import type { AztecNode } from '@aztec/stdlib/interfaces/server';
3
- import type { DirectionalAppTaggingSecret } from '@aztec/stdlib/logs';
3
+ import type { AppTaggingSecret } from '@aztec/stdlib/logs';
4
4
 
5
5
  import type { SenderTaggingStore } from '../../storage/tagging_store/sender_tagging_store.js';
6
6
  import { UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN } from '../constants.js';
7
- import { getStatusChangeOfPending } from './utils/get_status_change_of_pending.js';
7
+ import {
8
+ EMPTY_STATUS_CHANGE,
9
+ getStatusChangeOfPending,
10
+ mergeStatusChanges,
11
+ } from './utils/get_status_change_of_pending.js';
8
12
  import { loadAndStoreNewTaggingIndexes } from './utils/load_and_store_new_tagging_indexes.js';
9
13
 
10
14
  /**
11
15
  * Syncs tagging indexes. This function needs to be called whenever a private log is being sent.
12
16
  *
13
- * @param secret - The secret that's unique for (sender, recipient, contract) tuple while the direction of
14
- * sender -> recipient matters.
15
- * @param app - The address of the contract that the logs are tagged for. Needs to be provided because we perform
16
- * second round of siloing in this function which is necessary because kernels do it as well (they silo first field
17
- * of the private log which corresponds to the tag).
17
+ * @param secret - The sender-side tagging `AppTaggingSecret`.
18
18
  * @remarks When syncing the indexes as sender we don't care about the log contents - we only care about the highest
19
19
  * pending and highest finalized indexes as that guides the next index choice when sending a log. The next index choice
20
20
  * is simply the highest pending index plus one (or finalized if pending is undefined).
@@ -22,10 +22,10 @@ import { loadAndStoreNewTaggingIndexes } from './utils/load_and_store_new_taggin
22
22
  * updates its status accordingly.
23
23
  */
24
24
  export async function syncSenderTaggingIndexes(
25
- secret: DirectionalAppTaggingSecret,
26
- app: AztecAddress,
25
+ secret: AppTaggingSecret,
27
26
  aztecNode: AztecNode,
28
27
  taggingStore: SenderTaggingStore,
28
+ anchorBlockHash: BlockHash,
29
29
  jobId: string,
30
30
  ): Promise<void> {
31
31
  // # Explanation of how syncing works
@@ -55,21 +55,58 @@ export async function syncSenderTaggingIndexes(
55
55
  let newFinalizedIndex = undefined;
56
56
 
57
57
  while (true) {
58
- // Load and store indexes for the current window. These indexes may already exist in the database if txs using
59
- // them were previously sent from this PXE. Any duplicates are handled by the tagging data provider.
60
- await loadAndStoreNewTaggingIndexes(secret, app, start, end, aztecNode, taggingStore, jobId);
58
+ // Pending tx hashes already in the store for this window (from prior syncs or txs this PXE itself sent).
59
+ // Reading these before issuing any RPC lets us fetch their receipts in parallel with the logs query below.
60
+ const knownPendingTxHashes = await taggingStore.getTxHashesOfPendingIndexes(secret, start, end, jobId);
61
61
 
62
- // Retrieve all indexes within the current window from storage and update their status accordingly.
63
- const pendingTxHashes = await taggingStore.getTxHashesOfPendingIndexes(secret, start, end, jobId);
64
- if (pendingTxHashes.length === 0) {
62
+ // Fire the logs query and the known-pending receipts query in parallel
63
+ const [, statusOfKnown] = await Promise.all([
64
+ loadAndStoreNewTaggingIndexes(secret, start, end, aztecNode, taggingStore, anchorBlockHash, jobId),
65
+ knownPendingTxHashes.length > 0
66
+ ? getStatusChangeOfPending(knownPendingTxHashes, aztecNode)
67
+ : Promise.resolve(EMPTY_STATUS_CHANGE),
68
+ ]);
69
+
70
+ // Re-read pending tx hashes after the logs query writes any newly-discovered ones to the store.
71
+ const allPendingTxHashes = await taggingStore.getTxHashesOfPendingIndexes(secret, start, end, jobId);
72
+ if (allPendingTxHashes.length === 0) {
65
73
  break;
66
74
  }
67
75
 
68
- const { txHashesToFinalize, txHashesToDrop } = await getStatusChangeOfPending(pendingTxHashes, aztecNode);
76
+ // Receipts for pending tx hashes that the logs query just surfaced still need a sequential follow-up call.
77
+ // `mergePendingIndexes` is idempotent on (secret, txHash), so a re-discovered hash stays classified as known
78
+ // and is not re-fetched here.
79
+ const knownSet = new Set(knownPendingTxHashes.map(h => h.toString()));
80
+ const newPendingTxHashes = allPendingTxHashes.filter(h => !knownSet.has(h.toString()));
81
+
82
+ const statusOfNew =
83
+ newPendingTxHashes.length > 0
84
+ ? await getStatusChangeOfPending(newPendingTxHashes, aztecNode)
85
+ : EMPTY_STATUS_CHANGE;
86
+
87
+ const { txHashesToFinalize, txHashesToDrop, txHashesWithExecutionReverted } = mergeStatusChanges(
88
+ statusOfKnown,
89
+ statusOfNew,
90
+ );
69
91
 
70
92
  await taggingStore.dropPendingIndexes(txHashesToDrop, jobId);
71
93
  await taggingStore.finalizePendingIndexes(txHashesToFinalize, jobId);
72
94
 
95
+ if (txHashesWithExecutionReverted.length > 0) {
96
+ const receipts = await Promise.all(
97
+ txHashesWithExecutionReverted.map(txHash => aztecNode.getTxReceipt(txHash, { includeTxEffect: true })),
98
+ );
99
+ for (const receipt of receipts) {
100
+ if (!receipt.isMined() || !receipt.txEffect) {
101
+ throw new Error(
102
+ 'TxEffect not found for execution-reverted tx. This is either a bug or a reorg has occurred.',
103
+ );
104
+ }
105
+
106
+ await taggingStore.finalizePendingIndexesOfAPartiallyRevertedTx(receipt.txEffect, jobId);
107
+ }
108
+ }
109
+
73
110
  // We check if the finalized index has been updated.
74
111
  newFinalizedIndex = await taggingStore.getLastFinalizedIndex(secret, jobId);
75
112
  if (previousFinalizedIndex !== newFinalizedIndex) {