@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
@@ -0,0 +1,407 @@
1
+ import { Fr } from '@aztec/foundation/curves/bn254';
2
+ import { allToCompletion } from '@aztec/foundation/promise';
3
+ import type { AztecAddress } from '@aztec/stdlib/aztec-address';
4
+ import { BlockHash, type BlockParameter, type DataInBlock } from '@aztec/stdlib/block';
5
+ import type { BlockIncludeOptions } from '@aztec/stdlib/interfaces/client';
6
+ import type { AztecNode } from '@aztec/stdlib/interfaces/server';
7
+ import type {
8
+ LogResult,
9
+ LogsQueryBase,
10
+ PrivateLogsQuery,
11
+ PublicLogsQuery,
12
+ SiloedTag,
13
+ Tag,
14
+ TagQuery,
15
+ } from '@aztec/stdlib/logs';
16
+ import type { MerkleTreeId } from '@aztec/stdlib/trees';
17
+
18
+ import { type BenchmarkedAztecNode, withRecording } from './benchmarked_node.js';
19
+
20
+ /**
21
+ * An {@link AztecNode} wrapper that serves repeated reads from a cache it owns.
22
+ */
23
+ export interface CachingAztecNode extends BenchmarkedAztecNode {
24
+ /** Clears the read cache. The owner calls this periodically to bound memory. Cached entries never go stale. */
25
+ wipeCache(): void;
26
+ }
27
+
28
+ /**
29
+ * Wraps `node`, serving repeated reads from a cache the wrapper owns. Consumers share cached reads by sharing the
30
+ * wrapper.
31
+ *
32
+ * Only hash-pinned reads are cached. A block hash names immutable content, so the same call can never correctly answer
33
+ * differently, and even an `undefined` witness or leaf index is kept as a non-membership fact. That makes the wrapper
34
+ * safe for any consumer, whatever its anchor block. Uncached methods, and reads that name a block any other way (see
35
+ * {@link hashReferenceOf}), pass straight through. A few entries below opt out even when hash-pinned, where the answer
36
+ * can still change, and the tag queries opt in only once the request also stops short of blocks yet to be produced
37
+ * (see {@link hasImmutableAnswer}).
38
+ *
39
+ * Wiping (see {@link CachingAztecNode.wipeCache}) bounds memory. Correctness does not depend on it.
40
+ */
41
+ export function withCache(node: AztecNode): CachingAztecNode {
42
+ const cache = new AztecNodeCache();
43
+ // The recording wrapper sits below the cache, so a recording sees only the reads the node answered: a read served
44
+ // from the cache appears nowhere in it. Every read below goes to `source` rather than to `node`, and
45
+ // `startRecording` passes through this wrapper untouched.
46
+ const source = withRecording(node);
47
+
48
+ /** Runs `read` through `cache` when `block` pins a chain position by hash. Everything else goes to the node. */
49
+ const readCachedIfBlockIsHashPinned = <T>(
50
+ block: BlockParameter | undefined,
51
+ key: (blockHash: string) => string,
52
+ read: () => Promise<T>,
53
+ options?: { shouldCache?: (value: T) => boolean },
54
+ ): Promise<T> => {
55
+ const blockHash = hashReferenceOf(block);
56
+ return blockHash === undefined ? read() : cache.fetch(key(blockHash.toString()), read, options);
57
+ };
58
+
59
+ const cachedReads: { [K in keyof AztecNode]?: (...args: Parameters<AztecNode[K]>) => ReturnType<AztecNode[K]> } = {
60
+ getBlock: (block: BlockParameter, options?: BlockIncludeOptions) => {
61
+ if (options?.includeL1PublishInfo || options?.includeAttestations) {
62
+ // These payloads keep changing after a block is fixed (its L1 publication status, its incoming committee
63
+ // attestations), so a repeat can correctly differ; read straight from the node.
64
+ return source.getBlock(block, options);
65
+ }
66
+ return readCachedIfBlockIsHashPinned(
67
+ block,
68
+ blockHash => `block:${blockHash}:${keyPart(options)}`,
69
+ () => source.getBlock(block, options),
70
+ {
71
+ // PXE only asks for pinned blocks it has already observed, so an undefined answer means the node has not
72
+ // served the block yet, not that it never will.
73
+ shouldCache: response => response !== undefined,
74
+ },
75
+ );
76
+ },
77
+
78
+ getContract: (address: AztecAddress, referenceBlock?: BlockParameter) =>
79
+ readCachedIfBlockIsHashPinned(
80
+ referenceBlock,
81
+ blockHash => `contract:${blockHash}:${address.toString()}`,
82
+ () => source.getContract(address, referenceBlock),
83
+ ),
84
+
85
+ getBlockHashMembershipWitness: (referenceBlock: BlockParameter, blockHash: BlockHash) =>
86
+ readCachedIfBlockIsHashPinned(
87
+ referenceBlock,
88
+ referenceHash => `block-hash-membership-witness:${referenceHash}:${blockHash.toString()}`,
89
+ () => source.getBlockHashMembershipWitness(referenceBlock, blockHash),
90
+ ),
91
+
92
+ getPublicDataWitness: (referenceBlock: BlockParameter, leafSlot: Fr) =>
93
+ readCachedIfBlockIsHashPinned(
94
+ referenceBlock,
95
+ blockHash => `public-data-witness:${blockHash}:${leafSlot.toString()}`,
96
+ () => source.getPublicDataWitness(referenceBlock, leafSlot),
97
+ ),
98
+
99
+ getNoteHashMembershipWitness: (referenceBlock: BlockParameter, noteHash: Fr) =>
100
+ readCachedIfBlockIsHashPinned(
101
+ referenceBlock,
102
+ blockHash => `note-hash-membership-witness:${blockHash}:${noteHash.toString()}`,
103
+ () => source.getNoteHashMembershipWitness(referenceBlock, noteHash),
104
+ ),
105
+
106
+ getNullifierMembershipWitness: (referenceBlock: BlockParameter, nullifier: Fr) =>
107
+ readCachedIfBlockIsHashPinned(
108
+ referenceBlock,
109
+ blockHash => `nullifier-membership-witness:${blockHash}:${nullifier.toString()}`,
110
+ () => source.getNullifierMembershipWitness(referenceBlock, nullifier),
111
+ ),
112
+
113
+ getLowNullifierMembershipWitness: (referenceBlock: BlockParameter, nullifier: Fr) =>
114
+ readCachedIfBlockIsHashPinned(
115
+ referenceBlock,
116
+ blockHash => `low-nullifier-membership-witness:${blockHash}:${nullifier.toString()}`,
117
+ () => source.getLowNullifierMembershipWitness(referenceBlock, nullifier),
118
+ ),
119
+
120
+ getL1ToL2MessageMembershipWitness: (referenceBlock: BlockParameter, l1ToL2Message: Fr) =>
121
+ readCachedIfBlockIsHashPinned(
122
+ referenceBlock,
123
+ blockHash => `l1-to-l2-message-membership-witness:${blockHash}:${l1ToL2Message.toString()}`,
124
+ () => source.getL1ToL2MessageMembershipWitness(referenceBlock, l1ToL2Message),
125
+ ),
126
+
127
+ getPublicStorageAt: (referenceBlock: BlockParameter, contractAddress: AztecAddress, storageSlot: Fr) =>
128
+ readCachedIfBlockIsHashPinned(
129
+ referenceBlock,
130
+ blockHash => `public-storage:${blockHash}:${contractAddress.toString()}:${storageSlot.toString()}`,
131
+ () => source.getPublicStorageAt(referenceBlock, contractAddress, storageSlot),
132
+ ),
133
+
134
+ findLeavesIndexes: (referenceBlock: BlockParameter, treeId: MerkleTreeId, leafValues: Fr[]) => {
135
+ // Cached per leaf: only leaves without a cached result are fetched, in a single batched node call. The per-leaf
136
+ // keys don't fit single-key readCachedIfBlockIsHashPinned, so the hash gate is inline.
137
+ const referenceHash = hashReferenceOf(referenceBlock);
138
+ if (referenceHash === undefined) {
139
+ return source.findLeavesIndexes(referenceBlock, treeId, leafValues);
140
+ }
141
+ return readBatchedPerKey<DataInBlock<bigint> | undefined>(
142
+ cache,
143
+ leafValues.map(leaf => `leaf-index:${referenceHash.toString()}:${treeId}:${leaf.toString()}`),
144
+ missing =>
145
+ source.findLeavesIndexes(
146
+ referenceBlock,
147
+ treeId,
148
+ missing.map(i => leafValues[i]),
149
+ ),
150
+ { method: 'findLeavesIndexes', requested: 'leaves' },
151
+ );
152
+ },
153
+
154
+ getPrivateLogsByTags: (query: PrivateLogsQuery) => {
155
+ if (!hasImmutableAnswer(query)) {
156
+ return source.getPrivateLogsByTags(query);
157
+ }
158
+ const keyPrefix = `private-logs:${privateLogsQueryKey(query)}`;
159
+ return readBatchedPerKey<LogResult[]>(
160
+ cache,
161
+ query.tags.map(tag => `${keyPrefix}:${tagQueryKey(tag)}`),
162
+ missing => source.getPrivateLogsByTags({ ...query, tags: missing.map(i => query.tags[i]) }),
163
+ { method: 'getPrivateLogsByTags', requested: 'tags' },
164
+ );
165
+ },
166
+
167
+ getPublicLogsByTags: (query: PublicLogsQuery) => {
168
+ if (!hasImmutableAnswer(query)) {
169
+ return source.getPublicLogsByTags(query);
170
+ }
171
+ const keyPrefix = `public-logs:${publicLogsQueryKey(query)}`;
172
+ return readBatchedPerKey<LogResult[]>(
173
+ cache,
174
+ query.tags.map(tag => `${keyPrefix}:${tagQueryKey(tag)}`),
175
+ missing => source.getPublicLogsByTags({ ...query, tags: missing.map(i => query.tags[i]) }),
176
+ { method: 'getPublicLogsByTags', requested: 'tags' },
177
+ );
178
+ },
179
+ };
180
+
181
+ return new Proxy(source, {
182
+ get(target, prop) {
183
+ if (prop === 'wipeCache') {
184
+ return () => cache.wipe();
185
+ }
186
+ if (Object.hasOwn(cachedReads, prop)) {
187
+ return cachedReads[prop as keyof AztecNode];
188
+ }
189
+ const value = Reflect.get(target, prop);
190
+ return typeof value === 'function' ? value.bind(target) : value;
191
+ },
192
+ }) as CachingAztecNode;
193
+ }
194
+
195
+ /**
196
+ * Store of node read promises keyed by method and arguments.
197
+ *
198
+ * Holds no node reference of its own: it only memoizes promises handed to it by the {@link withCache} wrapper that
199
+ * owns it. Rejected promises are evicted so callers can retry. A settled value is kept unless the caller's
200
+ * `shouldCache` turns it away.
201
+ */
202
+ class AztecNodeCache {
203
+ private readonly cache = new Map<string, Promise<unknown>>();
204
+
205
+ /**
206
+ * Returns the cached promise for `key`, or runs `read` and caches the in-flight promise.
207
+ *
208
+ * `shouldCache` runs once the promise settles and answers whether its value is kept. Every settled value is kept by
209
+ * default. Callers waiting on a value that is then turned away still share the one in-flight read, so declining to
210
+ * keep a value costs nothing on concurrent reads.
211
+ */
212
+ public fetch<T>(
213
+ key: string,
214
+ read: () => Promise<T>,
215
+ { shouldCache }: { shouldCache?: (value: T) => boolean } = {},
216
+ ): Promise<T> {
217
+ return this.#get<T>(key) ?? this.#set(key, read(), shouldCache);
218
+ }
219
+
220
+ /**
221
+ * The cached promise for each of `keys`, `undefined` where there is none. For callers that batch their own misses
222
+ * rather than reading one key.
223
+ */
224
+ public peekAll<T>(keys: string[]): (Promise<T> | undefined)[] {
225
+ return keys.map(key => this.#get<T>(key));
226
+ }
227
+
228
+ /**
229
+ * Clears the store.
230
+ */
231
+ public wipe(): void {
232
+ this.cache.clear();
233
+ }
234
+
235
+ #get<T>(key: string): Promise<T> | undefined {
236
+ return this.cache.get(key) as Promise<T> | undefined;
237
+ }
238
+
239
+ #set<T>(key: string, promise: Promise<T>, shouldCache?: (value: T) => boolean): Promise<T> {
240
+ const evict = () => {
241
+ if (this.cache.get(key) === promise) {
242
+ this.cache.delete(key);
243
+ }
244
+ };
245
+ // A rejected read is evicted so callers can retry; a `shouldCache` that throws is treated the same way. The
246
+ // trailing catch keeps a throwing predicate from surfacing as an unhandled rejection on this detached promise.
247
+ promise
248
+ .then(value => {
249
+ if (shouldCache && !shouldCache(value)) {
250
+ evict();
251
+ }
252
+ }, evict)
253
+ .catch(evict);
254
+ this.cache.set(key, promise);
255
+ return promise;
256
+ }
257
+ }
258
+
259
+ /**
260
+ * The block hash `block` pins to (a `BlockHash` or `{ hash }` reference), or `undefined` for every other way of naming
261
+ * a block.
262
+ *
263
+ * A number or a tag names a moving chain position, as does naming no block at all: a reorg can put a different block
264
+ * at the same number, and tags follow the growing chain. An `{ archive }` root is different, since it commits to every
265
+ * block hash up to its own block and so pins content as tightly as a hash. It stays uncached because no PXE read uses
266
+ * one: keeping an `undefined` answer as a non-membership fact is only sound because PXE pins blocks it has already
267
+ * seen, and that holds for the references PXE actually builds.
268
+ */
269
+ function hashReferenceOf(block: BlockParameter | undefined): BlockHash | undefined {
270
+ if (block instanceof BlockHash) {
271
+ return block;
272
+ }
273
+ if (typeof block === 'object' && block !== null && 'hash' in block) {
274
+ return block.hash;
275
+ }
276
+ return undefined;
277
+ }
278
+
279
+ /**
280
+ * Answers one result per entry of `keys`, taking whatever the cache already holds and fetching the rest in a single
281
+ * batched call. Each fetched result is cached under its own key, so a later call that overlaps this one fetches only
282
+ * the entries it has not seen, and a key repeated within `keys` is asked of the node once.
283
+ *
284
+ * `fetchMissing` receives the indexes still missing, in order, and must answer one result per requested index.
285
+ * `shortResponse` names the method and what it requests, for the error raised when it does not.
286
+ */
287
+ function readBatchedPerKey<T>(
288
+ cache: AztecNodeCache,
289
+ keys: string[],
290
+ fetchMissing: (missingIndexes: number[]) => Promise<T[]>,
291
+ shortResponse: { method: string; requested: string },
292
+ ): Promise<T[]> {
293
+ const cached = cache.peekAll<T>(keys);
294
+
295
+ // One request per missing key rather than per missing position, so a key repeated in `keys` seeds a single entry
296
+ // that every position carrying it then reads.
297
+ const requestIndexByKey = new Map<string, number>();
298
+ cached.forEach((result, index) => {
299
+ if (result === undefined && !requestIndexByKey.has(keys[index])) {
300
+ requestIndexByKey.set(keys[index], index);
301
+ }
302
+ });
303
+
304
+ const fetchedByKey = new Map<string, Promise<T>>();
305
+ if (requestIndexByKey.size > 0) {
306
+ const requestedIndexes = [...requestIndexByKey.values()];
307
+ const batch = fetchMissing(requestedIndexes).then(fetched => {
308
+ if (fetched.length !== requestedIndexes.length) {
309
+ // Each entry is filled from the batch response by position. If the node returned fewer results than we asked
310
+ // for, the positions past the end would read undefined, which the cache keeps as a genuine answer, so a
311
+ // truncated response would be cached as fact. Rejecting the whole batch evicts those entries instead, so a
312
+ // retry re-fetches every one of them.
313
+ throw new Error(
314
+ `${shortResponse.method} returned ${fetched.length} results for ${requestedIndexes.length} requested ` +
315
+ `${shortResponse.requested}`,
316
+ );
317
+ }
318
+ return fetched;
319
+ });
320
+ [...requestIndexByKey.keys()].forEach((key, batchIndex) => {
321
+ fetchedByKey.set(
322
+ key,
323
+ cache.fetch(key, () => batch.then(fetched => fetched[batchIndex])),
324
+ );
325
+ });
326
+ }
327
+
328
+ // Every position is answered: a cache hit, or the entry its key's request seeded just above.
329
+ return allToCompletion(keys.map((key, index) => cached[index] ?? fetchedByKey.get(key)!));
330
+ }
331
+
332
+ /**
333
+ * Whether a tag query's answer can no longer change, and so can be cached.
334
+ *
335
+ * Two things would let it change, and the query has to rule out both. `referenceBlock` names the chain the answer
336
+ * belongs to, so the call fails once that block is gone rather than answering from a chain that reorged. `toBlock`
337
+ * stops the query below the tip, so blocks yet to be produced cannot add logs to the answer. Where the query starts
338
+ * does not matter: an open lower end reaches only blocks that are already behind it, which no longer move. PXE's tag
339
+ * queries get both from the `getAll*LogsByTags` helpers, which take them from the anchor block the query is pinned to.
340
+ */
341
+ function hasImmutableAnswer(query: LogsQueryBase): boolean {
342
+ return query.referenceBlock !== undefined && query.toBlock !== undefined;
343
+ }
344
+
345
+ /** Cache-key segment for the parts of a private tag query that every tag in it shares. */
346
+ function privateLogsQueryKey(query: PrivateLogsQuery): string {
347
+ const parts: QueryKeyParts<PrivateLogsQuery> = { ...sharedQueryKeyParts(query) };
348
+ return Object.values(parts).map(keyPart).join(':');
349
+ }
350
+
351
+ /** Cache-key segment for the parts of a public tag query that every tag in it shares. */
352
+ function publicLogsQueryKey(query: PublicLogsQuery): string {
353
+ const parts: QueryKeyParts<PublicLogsQuery> = {
354
+ ...sharedQueryKeyParts(query),
355
+ contractAddress: query.contractAddress,
356
+ };
357
+ return Object.values(parts).map(keyPart).join(':');
358
+ }
359
+
360
+ /**
361
+ * The fields of a query that a key has to cover, which is all of them but `tags`: each tag is keyed on its own by
362
+ * {@link tagQueryKey}.
363
+ *
364
+ * The key builders are total over this type, so a field added to a query fails to compile there rather than silently
365
+ * being left out of the key and colliding with a query that differs only in it.
366
+ */
367
+ type QueryKeyParts<T extends LogsQueryBase> = { [K in keyof Required<Omit<T, 'tags'>>]: unknown };
368
+
369
+ /** The key parts {@link PrivateLogsQuery} and {@link PublicLogsQuery} have in common. */
370
+ function sharedQueryKeyParts(query: LogsQueryBase): QueryKeyParts<LogsQueryBase> {
371
+ return {
372
+ referenceBlock: query.referenceBlock,
373
+ fromBlock: query.fromBlock,
374
+ toBlock: query.toBlock,
375
+ txHash: query.txHash,
376
+ includeEffects: query.includeEffects,
377
+ limitPerTag: query.limitPerTag,
378
+ };
379
+ }
380
+
381
+ /**
382
+ * Cache-key segment for one tag entry, covering the pagination cursor as well as the tag: each page of a tag's stream
383
+ * is a read of its own, and a repeated query asks for the same pages in the same order.
384
+ */
385
+ function tagQueryKey(entry: TagQuery<Tag | SiloedTag>): string {
386
+ return 'tag' in entry ? `${keyPart(entry.tag)}@${keyPart(entry.afterLog)}` : keyPart(entry);
387
+ }
388
+
389
+ /**
390
+ * Renders a call argument as a stable cache-key segment, via its own `toString` when it has one, else as JSON.
391
+ *
392
+ * Example: the options object `{ includeTransactions: true }` renders as `'{"includeTransactions":true}'`, and an
393
+ * absent optional argument as `'undefined'`.
394
+ */
395
+ function keyPart(value: unknown): string {
396
+ if (['string', 'number', 'bigint', 'boolean'].includes(typeof value)) {
397
+ return String(value);
398
+ }
399
+ if (value && typeof value === 'object') {
400
+ const toString = (value as { toString?: () => string }).toString;
401
+ if (toString && toString !== Object.prototype.toString) {
402
+ return toString.call(value);
403
+ }
404
+ return JSON.stringify(value, (_key, nested) => (typeof nested === 'bigint' ? nested.toString() : nested));
405
+ }
406
+ return String(value);
407
+ }
@@ -1,13 +1,15 @@
1
+ import { chunk } from '@aztec/foundation/collection';
1
2
  import { Fr } from '@aztec/foundation/curves/bn254';
3
+ import { allToCompletion } from '@aztec/foundation/promise';
2
4
  import type { AztecAddress } from '@aztec/stdlib/aztec-address';
3
- import type { DataInBlock } from '@aztec/stdlib/block';
5
+ import { BlockHash, type DataInBlock, type InBlock } from '@aztec/stdlib/block';
4
6
  import { computeUniqueNoteHash, siloNoteHash, siloNullifier } from '@aztec/stdlib/hash';
5
7
  import { type AztecNode, MAX_RPC_LEN } from '@aztec/stdlib/interfaces/client';
6
8
  import { Note, NoteDao, NoteStatus } from '@aztec/stdlib/note';
7
9
  import { MerkleTreeId } from '@aztec/stdlib/trees';
8
- import type { BlockHeader, TxHash } from '@aztec/stdlib/tx';
10
+ import type { BlockHeader } from '@aztec/stdlib/tx';
9
11
 
10
- import type { AccessScopes } from '../access_scopes.js';
12
+ import type { NoteValidationRequest } from '../contract_function_simulator/noir-structs/note_validation_request.js';
11
13
  import type { NoteStore } from '../storage/note_store/note_store.js';
12
14
 
13
15
  export class NoteService {
@@ -25,14 +27,14 @@ export class NoteService {
25
27
  *
26
28
  * @param owner - The owner of the notes. If undefined, returns notes for all known owners.
27
29
  * @param status - The status of notes to fetch.
28
- * @param scopes - The accounts whose notes we can access in this call. Currently optional and will default to all.
30
+ * @param scopes - The accounts whose notes we can access in this call. An empty list matches no notes.
29
31
  */
30
32
  public async getNotes(
31
33
  contractAddress: AztecAddress,
32
34
  owner: AztecAddress | undefined,
33
35
  storageSlot: Fr,
34
36
  status: NoteStatus,
35
- scopes: AccessScopes,
37
+ scopes: AztecAddress[],
36
38
  ) {
37
39
  const noteDaos = await this.noteStore.getNotes(
38
40
  {
@@ -71,7 +73,7 @@ export class NoteService {
71
73
  *
72
74
  * @param contractAddress - The contract whose notes should be checked and nullified.
73
75
  */
74
- public async syncNoteNullifiers(contractAddress: AztecAddress, scopes: AccessScopes): Promise<void> {
76
+ public async syncNoteNullifiers(contractAddress: AztecAddress, scopes: AztecAddress[]): Promise<void> {
75
77
  const anchorBlockHash = await this.anchorBlockHeader.hash();
76
78
 
77
79
  const contractNotes = await this.noteStore.getNotes({ contractAddress, scopes }, this.jobId);
@@ -81,24 +83,7 @@ export class NoteService {
81
83
  }
82
84
 
83
85
  const nullifiersToCheck = contractNotes.map(note => note.siloedNullifier);
84
- const nullifierBatches = nullifiersToCheck.reduce(
85
- (acc, nullifier) => {
86
- if (acc[acc.length - 1].length < MAX_RPC_LEN) {
87
- acc[acc.length - 1].push(nullifier);
88
- } else {
89
- acc.push([nullifier]);
90
- }
91
- return acc;
92
- },
93
- [[]] as Fr[][],
94
- );
95
- const nullifierIndexes = (
96
- await Promise.all(
97
- nullifierBatches.map(batch =>
98
- this.aztecNode.findLeavesIndexes(anchorBlockHash, MerkleTreeId.NULLIFIER_TREE, batch),
99
- ),
100
- )
101
- ).flat();
86
+ const nullifierIndexes = await this.#findNullifierIndexes(anchorBlockHash, nullifiersToCheck);
102
87
 
103
88
  const foundNullifiers = nullifiersToCheck
104
89
  .map((nullifier, i) => {
@@ -111,30 +96,34 @@ export class NoteService {
111
96
  await this.noteStore.applyNullifiers(foundNullifiers, this.jobId);
112
97
  }
113
98
 
114
- public async validateAndStoreNote(
115
- contractAddress: AztecAddress,
116
- owner: AztecAddress,
117
- storageSlot: Fr,
118
- randomness: Fr,
119
- noteNonce: Fr,
120
- content: Fr[],
121
- noteHash: Fr,
122
- nullifier: Fr,
123
- txHash: TxHash,
124
- recipient: AztecAddress,
99
+ /**
100
+ * Validates and stores a batch of notes against the pre-fetched onchain context of their txs.
101
+ *
102
+ * For each request we must verify that:
103
+ * - the note actually exists in the corresponding tx effect (and thus in the note hash tree), and
104
+ * - the note has not already been nullified.
105
+ *
106
+ * Failing to do either would result in circuits getting either non-existent notes and failing to produce inclusion
107
+ * proofs for them, or getting nullified notes and producing duplicate nullifiers, both of which are catastrophic
108
+ * failure modes.
109
+ *
110
+ * Note that adding a note and removing it is *not* equivalent to never adding it in the first place. A nullifier
111
+ * emitted in a block that comes after note creation might result in the note being de-nullified by a chain reorg,
112
+ * so we must store both the note hash and nullifier block information.
113
+ *
114
+ * @param requests - The notes to validate and store.
115
+ * @param scope - The scope under which the notes are being stored.
116
+ * @param validationTxData - The onchain context of each request's tx, keyed by `TxHash.toString()`. Must contain
117
+ * entries for every request's txHash; missing entries are treated as a node bug and cause an error.
118
+ */
119
+ public async validateAndStoreNotes(
120
+ requests: NoteValidationRequest[],
121
+ scope: AztecAddress,
122
+ validationTxData: ReadonlyMap<string, NoteValidationTxData>,
125
123
  ): Promise<void> {
126
- // We are going to store the new note in the NoteStore, which will let us later return it via `getNotes`.
127
- // There's two things we need to check before we do this however:
128
- // - we must make sure the note does actually exist in the note hash tree
129
- // - we need to check if the note has already been nullified
130
- //
131
- // Failing to do either of the above would result in circuits getting either non-existent notes and failing to
132
- // produce inclusion proofs for them, or getting nullified notes and producing duplicate nullifiers, both of which
133
- // are catastrophic failure modes.
134
- //
135
- // Note that adding a note and removing it is *not* equivalent to never adding it in the first place. A nullifier
136
- // emitted in a block that comes after note creation might result in the note being de-nullified by a chain reorg,
137
- // so we must store both the note hash and nullifier block information.
124
+ if (requests.length === 0) {
125
+ return;
126
+ }
138
127
 
139
128
  // We avoid making node queries at 'latest' since we don't want to process notes or nullifiers that only exist ahead
140
129
  // in time of the locally synced state.
@@ -147,50 +136,102 @@ export class NoteService {
147
136
 
148
137
  // By computing siloed and unique note hashes ourselves we prevent contracts from interfering with the note storage
149
138
  // of other contracts, which would constitute a security breach.
150
- const uniqueNoteHash = await computeUniqueNoteHash(noteNonce, await siloNoteHash(contractAddress, noteHash));
151
- const siloedNullifier = await siloNullifier(contractAddress, nullifier);
152
-
153
- const [txEffect, [nullifierIndex]] = await Promise.all([
154
- this.aztecNode.getTxEffect(txHash),
155
- this.aztecNode.findLeavesIndexes(anchorBlockHash, MerkleTreeId.NULLIFIER_TREE, [siloedNullifier]),
156
- ]);
157
- if (!txEffect) {
158
- throw new Error(`Could not find tx effect for tx hash ${txHash}`);
159
- }
139
+ const computed = await allToCompletion(
140
+ requests.map(async ({ contractAddress, noteHash, nullifier, noteNonce }) => {
141
+ const [siloedNoteHash, siloedNullifier] = await allToCompletion([
142
+ siloNoteHash(contractAddress, noteHash),
143
+ siloNullifier(contractAddress, nullifier),
144
+ ]);
145
+ const uniqueNoteHash = await computeUniqueNoteHash(noteNonce, siloedNoteHash);
146
+ return { uniqueNoteHash, siloedNullifier };
147
+ }),
148
+ );
160
149
 
161
- if (txEffect.l2BlockNumber > anchorBlockNumber) {
162
- throw new Error(`Could not find tx effect for tx hash ${txHash} as of block number ${anchorBlockNumber}`);
163
- }
150
+ const nullifierIndexes = await this.#findNullifierIndexes(
151
+ anchorBlockHash,
152
+ computed.map(c => c.siloedNullifier),
153
+ );
164
154
 
165
- // Find the index of the note hash in the noteHashes array to determine note ordering within the tx
166
- const noteIndexInTx = txEffect.data.noteHashes.findIndex(nh => nh.equals(uniqueNoteHash));
167
- if (noteIndexInTx === -1) {
168
- throw new Error(`Note hash ${noteHash} (uniqued as ${uniqueNoteHash}) is not present in tx ${txHash}`);
169
- }
155
+ const noteDaos: NoteDao[] = [];
156
+ const foundNullifiers: DataInBlock<Fr>[] = [];
157
+
158
+ for (let i = 0; i < requests.length; i++) {
159
+ const { contractAddress, owner, storageSlot, randomness, noteNonce, content, noteHash, txHash } = requests[i];
160
+ const { uniqueNoteHash, siloedNullifier } = computed[i];
161
+ const nullifierIndex = nullifierIndexes[i];
162
+
163
+ const txData = validationTxData.get(txHash.toString());
164
+ if (!txData) {
165
+ // We error out instead of just logging a warning and skipping the note because this would indicate a bug. This
166
+ // is because the node has already served info about this tx either when obtaining the log (LogResult carries
167
+ // the tx info) or when getting metadata for the offchain message (before the message got passed to
168
+ // `process_log`).
169
+ throw new Error(`Could not find tx effect for tx hash ${txHash} when processing a note.`);
170
+ }
171
+
172
+ if (txData.l2BlockNumber > anchorBlockNumber) {
173
+ // If the message was delivered onchain, this would indicate a bug: log sync should never load logs from blocks
174
+ // newer than the anchor block. If the note came via an offchain message, it would likely also be a bug, since
175
+ // we sync a new anchor block before calling `process_message`. For this not to be a bug, the message would
176
+ // need to come from a newer block than the anchor served by the node, implying the node isn't properly synced.
177
+ // We therefore error out here rather than assuming the offchain message was constructed by a malicious
178
+ // sender with the intention of bricking recipient's PXE (if we assumed that we would just ignore the message).
179
+ throw new Error(
180
+ `Obtained a newer tx effect for ${txHash} for a note validation request than the anchor block ${anchorBlockNumber}. This is a bug as we should not ever be processing a note from a newer block than the anchor block.`,
181
+ );
182
+ }
183
+
184
+ // Find the index of the note hash in the noteHashes array to determine note ordering within the tx
185
+ const noteIndexInTx = txData.noteHashes.findIndex(nh => nh.equals(uniqueNoteHash));
186
+ if (noteIndexInTx === -1) {
187
+ // Similar to the comment above - we error out as this would indicate a bug in nonce discovery.
188
+ throw new Error(`Note hash ${noteHash} (uniqued as ${uniqueNoteHash}) is not present in tx ${txHash}`);
189
+ }
190
+
191
+ noteDaos.push(
192
+ new NoteDao(
193
+ new Note(content),
194
+ contractAddress,
195
+ owner,
196
+ storageSlot,
197
+ randomness,
198
+ noteNonce,
199
+ noteHash,
200
+ siloedNullifier,
201
+ txHash,
202
+ txData.l2BlockNumber,
203
+ txData.l2BlockHash.toString(),
204
+ txData.txIndexInBlock,
205
+ noteIndexInTx,
206
+ ),
207
+ );
170
208
 
171
- const noteDao = new NoteDao(
172
- new Note(content),
173
- contractAddress,
174
- owner,
175
- storageSlot,
176
- randomness,
177
- noteNonce,
178
- noteHash,
179
- siloedNullifier,
180
- txHash,
181
- txEffect.l2BlockNumber,
182
- txEffect.l2BlockHash.toString(),
183
- txEffect.txIndexInBlock,
184
- noteIndexInTx,
185
- );
209
+ if (nullifierIndex !== undefined) {
210
+ // We found a nullifier index which implies that the note has already been nullified.
211
+ const { data: _, ...blockHashAndNum } = nullifierIndex;
212
+ foundNullifiers.push({ data: siloedNullifier, ...blockHashAndNum });
213
+ }
214
+ }
186
215
 
187
- // The note was found by `recipient`, so we use that as the scope when storing the note.
188
- await this.noteStore.addNotes([noteDao], recipient, this.jobId);
216
+ await this.noteStore.addNotes(noteDaos, scope, this.jobId);
189
217
 
190
- if (nullifierIndex !== undefined) {
191
- // We found nullifier index which implies that the note has already been nullified.
192
- const { data: _, ...blockHashAndNum } = nullifierIndex;
193
- await this.noteStore.applyNullifiers([{ data: siloedNullifier, ...blockHashAndNum }], this.jobId);
218
+ if (foundNullifiers.length > 0) {
219
+ await this.noteStore.applyNullifiers(foundNullifiers, this.jobId);
194
220
  }
195
221
  }
222
+
223
+ async #findNullifierIndexes(anchorBlockHash: BlockHash, siloedNullifiers: Fr[]) {
224
+ const batches = chunk(siloedNullifiers, MAX_RPC_LEN);
225
+ return (
226
+ await allToCompletion(
227
+ batches.map(batch => this.aztecNode.findLeavesIndexes(anchorBlockHash, MerkleTreeId.NULLIFIER_TREE, batch)),
228
+ )
229
+ ).flat();
230
+ }
196
231
  }
232
+
233
+ /** The onchain context of the tx a note validation request points at: where it was mined and its note hashes. */
234
+ export type NoteValidationTxData = InBlock & {
235
+ noteHashes: Fr[];
236
+ txIndexInBlock: number;
237
+ };