@aztec/pxe 0.0.1-commit.42ee6df9b → 0.0.1-commit.431c48d

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 (538) 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 +65 -28
  14. package/dest/config/index.d.ts +22 -2
  15. package/dest/config/index.d.ts.map +1 -1
  16. package/dest/config/index.js +18 -14
  17. package/dest/config/package_info.js +1 -1
  18. package/dest/contract/contract_call_graph.d.ts +52 -0
  19. package/dest/contract/contract_call_graph.d.ts.map +1 -0
  20. package/dest/contract/contract_call_graph.js +91 -0
  21. package/dest/contract/contract_class_service.d.ts +24 -0
  22. package/dest/contract/contract_class_service.d.ts.map +1 -0
  23. package/dest/contract/contract_class_service.js +36 -0
  24. package/dest/contract/contract_sync_service.d.ts +83 -0
  25. package/dest/contract/contract_sync_service.d.ts.map +1 -0
  26. package/dest/contract/contract_sync_service.js +213 -0
  27. package/dest/contract/helpers.d.ts +7 -0
  28. package/dest/contract/helpers.d.ts.map +1 -0
  29. package/dest/contract/helpers.js +20 -0
  30. package/dest/contract/skip_sync_contracts.d.ts +11 -0
  31. package/dest/contract/skip_sync_contracts.d.ts.map +1 -0
  32. package/dest/contract/skip_sync_contracts.js +18 -0
  33. package/dest/contract_function_simulator/anchored_contract_data.d.ts +36 -0
  34. package/dest/contract_function_simulator/anchored_contract_data.d.ts.map +1 -0
  35. package/dest/contract_function_simulator/anchored_contract_data.js +54 -0
  36. package/dest/contract_function_simulator/contract_function_simulator.d.ts +25 -25
  37. package/dest/contract_function_simulator/contract_function_simulator.d.ts.map +1 -1
  38. package/dest/contract_function_simulator/contract_function_simulator.js +90 -65
  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 +10 -29
  45. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts +5 -9
  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 +3 -7
  48. package/dest/contract_function_simulator/index.d.ts +26 -6
  49. package/dest/contract_function_simulator/index.d.ts.map +1 -1
  50. package/dest/contract_function_simulator/index.js +11 -4
  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 -3
  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 +5 -4
  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 -61
  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 -3
  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 +6 -5
  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 -103
  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 +1 -1
  133. package/dest/contract_function_simulator/oracle/private_execution.d.ts.map +1 -1
  134. package/dest/contract_function_simulator/oracle/private_execution.js +2 -3
  135. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts +47 -36
  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 +200 -65
  138. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts +152 -66
  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 +590 -173
  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/debug/pxe_debug_utils.d.ts +2 -7
  148. package/dest/debug/pxe_debug_utils.d.ts.map +1 -1
  149. package/dest/debug/pxe_debug_utils.js +9 -7
  150. package/dest/entrypoints/client/bundle/index.d.ts +2 -1
  151. package/dest/entrypoints/client/bundle/index.d.ts.map +1 -1
  152. package/dest/entrypoints/client/bundle/index.js +1 -0
  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 -1
  157. package/dest/entrypoints/client/lazy/index.d.ts.map +1 -1
  158. package/dest/entrypoints/client/lazy/index.js +1 -0
  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 -3
  169. package/dest/entrypoints/server/index.d.ts.map +1 -1
  170. package/dest/entrypoints/server/index.js +5 -2
  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 +19 -4
  181. package/dest/events/event_service.d.ts.map +1 -1
  182. package/dest/events/event_service.js +37 -15
  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/job_coordinator/job_coordinator.d.ts +10 -1
  202. package/dest/job_coordinator/job_coordinator.d.ts.map +1 -1
  203. package/dest/job_coordinator/job_coordinator.js +19 -0
  204. package/dest/logs/log_service.d.ts +21 -10
  205. package/dest/logs/log_service.d.ts.map +1 -1
  206. package/dest/logs/log_service.js +173 -76
  207. package/dest/messages/tx_resolver_service.d.ts +28 -0
  208. package/dest/messages/tx_resolver_service.d.ts.map +1 -0
  209. package/dest/messages/tx_resolver_service.js +62 -0
  210. package/dest/node/benchmarked_node.d.ts +20 -0
  211. package/dest/node/benchmarked_node.d.ts.map +1 -0
  212. package/dest/node/benchmarked_node.js +94 -0
  213. package/dest/node/caching_aztec_node.d.ts +24 -0
  214. package/dest/node/caching_aztec_node.d.ts.map +1 -0
  215. package/dest/node/caching_aztec_node.js +268 -0
  216. package/dest/notes/note_service.d.ts +32 -4
  217. package/dest/notes/note_service.d.ts.map +1 -1
  218. package/dest/notes/note_service.js +82 -66
  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 -10
  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/private_kernel_reset_private_inputs_builder.d.ts +1 -1
  226. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts.map +1 -1
  227. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.js +10 -5
  228. package/dest/private_kernel/hints/test_utils.d.ts +1 -1
  229. package/dest/private_kernel/hints/test_utils.d.ts.map +1 -1
  230. package/dest/private_kernel/hints/test_utils.js +3 -4
  231. package/dest/private_kernel/private_kernel_execution_prover.d.ts +6 -2
  232. package/dest/private_kernel/private_kernel_execution_prover.d.ts.map +1 -1
  233. package/dest/private_kernel/private_kernel_execution_prover.js +160 -85
  234. package/dest/private_kernel/private_kernel_oracle.d.ts +12 -10
  235. package/dest/private_kernel/private_kernel_oracle.d.ts.map +1 -1
  236. package/dest/private_kernel/private_kernel_oracle.js +40 -26
  237. package/dest/pxe.d.ts +164 -51
  238. package/dest/pxe.d.ts.map +1 -1
  239. package/dest/pxe.js +388 -215
  240. package/dest/storage/address_store/address_store.d.ts +1 -1
  241. package/dest/storage/address_store/address_store.d.ts.map +1 -1
  242. package/dest/storage/address_store/address_store.js +2 -1
  243. package/dest/storage/allowed_scopes.d.ts +6 -0
  244. package/dest/storage/allowed_scopes.d.ts.map +1 -0
  245. package/dest/storage/allowed_scopes.js +7 -0
  246. package/dest/storage/anchor_block_store/anchor_block_store.d.ts +9 -6
  247. package/dest/storage/anchor_block_store/anchor_block_store.d.ts.map +1 -1
  248. package/dest/storage/anchor_block_store/anchor_block_store.js +9 -7
  249. package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.d.ts +42 -0
  250. package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.d.ts.map +1 -0
  251. package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.js +93 -0
  252. package/dest/storage/backwards_compatibility_tests/schema_tests.d.ts +15 -0
  253. package/dest/storage/backwards_compatibility_tests/schema_tests.d.ts.map +1 -0
  254. package/dest/storage/backwards_compatibility_tests/schema_tests.js +671 -0
  255. package/dest/storage/backwards_compatibility_tests/store_spy.d.ts +19 -0
  256. package/dest/storage/backwards_compatibility_tests/store_spy.d.ts.map +1 -0
  257. package/dest/storage/backwards_compatibility_tests/store_spy.js +63 -0
  258. package/dest/storage/capsule_store/capsule_service.d.ts +1 -1
  259. package/dest/storage/capsule_store/capsule_service.d.ts.map +1 -1
  260. package/dest/storage/capsule_store/capsule_service.js +6 -9
  261. package/dest/storage/capsule_store/capsule_store.d.ts +1 -1
  262. package/dest/storage/capsule_store/capsule_store.d.ts.map +1 -1
  263. package/dest/storage/capsule_store/capsule_store.js +9 -6
  264. package/dest/storage/contract_store/contract_store.d.ts +27 -24
  265. package/dest/storage/contract_store/contract_store.d.ts.map +1 -1
  266. package/dest/storage/contract_store/contract_store.js +72 -99
  267. package/dest/storage/contract_store/private_functions_tree.d.ts +1 -1
  268. package/dest/storage/contract_store/private_functions_tree.d.ts.map +1 -1
  269. package/dest/storage/contract_store/private_functions_tree.js +2 -1
  270. package/dest/storage/fact_store/fact_service.d.ts +22 -0
  271. package/dest/storage/fact_store/fact_service.d.ts.map +1 -0
  272. package/dest/storage/fact_store/fact_service.js +45 -0
  273. package/dest/storage/fact_store/fact_store.d.ts +95 -0
  274. package/dest/storage/fact_store/fact_store.d.ts.map +1 -0
  275. package/dest/storage/fact_store/fact_store.js +411 -0
  276. package/dest/storage/fact_store/fact_store_keys.d.ts +34 -0
  277. package/dest/storage/fact_store/fact_store_keys.d.ts.map +1 -0
  278. package/dest/storage/fact_store/fact_store_keys.js +50 -0
  279. package/dest/storage/fact_store/index.d.ts +6 -0
  280. package/dest/storage/fact_store/index.d.ts.map +1 -0
  281. package/dest/storage/fact_store/index.js +4 -0
  282. package/dest/storage/fact_store/origin_state.d.ts +59 -0
  283. package/dest/storage/fact_store/origin_state.d.ts.map +1 -0
  284. package/dest/storage/fact_store/origin_state.js +60 -0
  285. package/dest/storage/fact_store/stored_fact.d.ts +32 -0
  286. package/dest/storage/fact_store/stored_fact.d.ts.map +1 -0
  287. package/dest/storage/fact_store/stored_fact.js +64 -0
  288. package/dest/storage/index.d.ts +3 -2
  289. package/dest/storage/index.d.ts.map +1 -1
  290. package/dest/storage/index.js +2 -1
  291. package/dest/storage/metadata.d.ts +2 -2
  292. package/dest/storage/metadata.d.ts.map +1 -1
  293. package/dest/storage/metadata.js +1 -1
  294. package/dest/storage/note_store/note_store.d.ts +42 -33
  295. package/dest/storage/note_store/note_store.d.ts.map +1 -1
  296. package/dest/storage/note_store/note_store.js +200 -170
  297. package/dest/storage/note_store/stored_note.d.ts +3 -8
  298. package/dest/storage/note_store/stored_note.d.ts.map +1 -1
  299. package/dest/storage/note_store/stored_note.js +4 -20
  300. package/dest/storage/open_pxe_stores.d.ts +35 -0
  301. package/dest/storage/open_pxe_stores.d.ts.map +1 -0
  302. package/dest/storage/open_pxe_stores.js +29 -0
  303. package/dest/storage/private_event_store/private_event_store.d.ts +13 -16
  304. package/dest/storage/private_event_store/private_event_store.d.ts.map +1 -1
  305. package/dest/storage/private_event_store/private_event_store.js +48 -45
  306. package/dest/storage/private_event_store/stored_private_event.js +1 -1
  307. package/dest/storage/store_identity.d.ts +35 -0
  308. package/dest/storage/store_identity.d.ts.map +1 -0
  309. package/dest/storage/store_identity.js +44 -0
  310. package/dest/storage/tagging_store/index.d.ts +2 -2
  311. package/dest/storage/tagging_store/index.d.ts.map +1 -1
  312. package/dest/storage/tagging_store/index.js +1 -1
  313. package/dest/storage/tagging_store/recipient_tagging_store.d.ts +6 -6
  314. package/dest/storage/tagging_store/recipient_tagging_store.d.ts.map +1 -1
  315. package/dest/storage/tagging_store/sender_tagging_store.d.ts +44 -13
  316. package/dest/storage/tagging_store/sender_tagging_store.d.ts.map +1 -1
  317. package/dest/storage/tagging_store/sender_tagging_store.js +91 -36
  318. package/dest/storage/tagging_store/tagging_secret_sources_store.d.ts +51 -0
  319. package/dest/storage/tagging_store/tagging_secret_sources_store.d.ts.map +1 -0
  320. package/dest/storage/tagging_store/tagging_secret_sources_store.js +105 -0
  321. package/dest/tagging/constants.d.ts +11 -2
  322. package/dest/tagging/constants.d.ts.map +1 -1
  323. package/dest/tagging/constants.js +38 -10
  324. package/dest/tagging/get_all_logs_by_tags.d.ts +55 -10
  325. package/dest/tagging/get_all_logs_by_tags.d.ts.map +1 -1
  326. package/dest/tagging/get_all_logs_by_tags.js +55 -36
  327. package/dest/tagging/index.d.ts +7 -6
  328. package/dest/tagging/index.d.ts.map +1 -1
  329. package/dest/tagging/index.js +6 -5
  330. package/dest/tagging/persist_sender_tagging_index_ranges.d.ts +29 -0
  331. package/dest/tagging/persist_sender_tagging_index_ranges.d.ts.map +1 -0
  332. package/dest/tagging/persist_sender_tagging_index_ranges.js +42 -0
  333. package/dest/tagging/recipient_sync/sync_tagged_private_logs.d.ts +74 -0
  334. package/dest/tagging/recipient_sync/sync_tagged_private_logs.d.ts.map +1 -0
  335. package/dest/tagging/recipient_sync/sync_tagged_private_logs.js +235 -0
  336. package/dest/tagging/recipient_sync/utils/find_highest_indexes.d.ts +3 -3
  337. package/dest/tagging/recipient_sync/utils/find_highest_indexes.d.ts.map +1 -1
  338. package/dest/tagging/reconcile_tagging_index_ranges.d.ts +36 -0
  339. package/dest/tagging/reconcile_tagging_index_ranges.d.ts.map +1 -0
  340. package/dest/tagging/reconcile_tagging_index_ranges.js +74 -0
  341. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts +8 -6
  342. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts.map +1 -1
  343. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.js +24 -27
  344. package/dest/tagging/sender_sync/utils/classify_pending_txs.d.ts +22 -0
  345. package/dest/tagging/sender_sync/utils/classify_pending_txs.d.ts.map +1 -0
  346. package/dest/tagging/sender_sync/utils/classify_pending_txs.js +62 -0
  347. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts +17 -7
  348. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts.map +1 -1
  349. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.js +39 -37
  350. package/dest/tagging/sender_sync/utils/resolve_pending_txs.d.ts +29 -0
  351. package/dest/tagging/sender_sync/utils/resolve_pending_txs.d.ts.map +1 -0
  352. package/dest/tagging/sender_sync/utils/resolve_pending_txs.js +42 -0
  353. package/dest/tagging/sender_sync/utils/test_utils.d.ts +16 -0
  354. package/dest/tagging/sender_sync/utils/test_utils.d.ts.map +1 -0
  355. package/dest/tagging/sender_sync/utils/test_utils.js +24 -0
  356. package/dest/tagging/testing/tag_query_test_utils.d.ts +6 -0
  357. package/dest/tagging/testing/tag_query_test_utils.d.ts.map +1 -0
  358. package/dest/tagging/testing/tag_query_test_utils.js +10 -0
  359. package/package.json +20 -17
  360. package/src/bin/check_oracle_version.ts +46 -135
  361. package/src/bin/index.ts +1 -0
  362. package/src/bin/oracle_version_helpers.ts +54 -0
  363. package/src/block_synchronizer/block_stream_source.ts +42 -0
  364. package/src/block_synchronizer/block_synchronizer.ts +80 -40
  365. package/src/config/index.ts +40 -9
  366. package/src/config/package_info.ts +1 -1
  367. package/src/contract/contract_call_graph.ts +113 -0
  368. package/src/contract/contract_class_service.ts +45 -0
  369. package/src/contract/contract_sync_service.ts +342 -0
  370. package/src/contract/helpers.ts +35 -0
  371. package/src/contract/skip_sync_contracts.ts +23 -0
  372. package/src/contract_function_simulator/anchored_contract_data.ts +74 -0
  373. package/src/contract_function_simulator/contract_function_simulator.ts +142 -78
  374. package/src/contract_function_simulator/ephemeral_array_service.ts +110 -0
  375. package/src/contract_function_simulator/execution_note_cache.ts +10 -30
  376. package/src/contract_function_simulator/execution_tagging_index_cache.ts +5 -9
  377. package/src/contract_function_simulator/index.ts +89 -5
  378. package/src/contract_function_simulator/noir-structs/bounded_vec.ts +43 -0
  379. package/src/contract_function_simulator/noir-structs/contract_class_log_data.ts +9 -0
  380. package/src/contract_function_simulator/noir-structs/embedded_curve_point.ts +4 -0
  381. package/src/contract_function_simulator/noir-structs/ephemeral_array.ts +66 -0
  382. package/src/contract_function_simulator/noir-structs/event_validation_request.ts +5 -4
  383. package/src/contract_function_simulator/noir-structs/fact.ts +13 -0
  384. package/src/contract_function_simulator/noir-structs/fact_collection.ts +64 -0
  385. package/src/contract_function_simulator/noir-structs/log_retrieval_request.ts +27 -20
  386. package/src/contract_function_simulator/noir-structs/log_retrieval_response.ts +14 -61
  387. package/src/contract_function_simulator/noir-structs/note_data.ts +27 -0
  388. package/src/contract_function_simulator/noir-structs/note_validation_request.ts +6 -5
  389. package/src/contract_function_simulator/noir-structs/option.ts +75 -0
  390. package/src/contract_function_simulator/noir-structs/origin_block.ts +8 -0
  391. package/src/contract_function_simulator/noir-structs/pending_tagged_log.ts +12 -0
  392. package/src/contract_function_simulator/noir-structs/provided_secret.ts +5 -0
  393. package/src/contract_function_simulator/noir-structs/resolved_tagging_strategy.ts +66 -0
  394. package/src/contract_function_simulator/noir-structs/resolved_tx.ts +19 -0
  395. package/src/contract_function_simulator/noir-structs/tx_effect_data.ts +16 -0
  396. package/src/contract_function_simulator/noir-structs/utility_context.ts +5 -17
  397. package/src/contract_function_simulator/oracle/acir_callback.ts +154 -0
  398. package/src/contract_function_simulator/oracle/index.ts +1 -15
  399. package/src/contract_function_simulator/oracle/interfaces.ts +11 -185
  400. package/src/contract_function_simulator/oracle/legacy_oracle_registry.ts +147 -0
  401. package/src/contract_function_simulator/oracle/message_load_oracle_inputs.ts +6 -21
  402. package/src/contract_function_simulator/oracle/note_packing_utils.ts +3 -3
  403. package/src/contract_function_simulator/oracle/oracle_registry.ts +710 -0
  404. package/src/contract_function_simulator/oracle/oracle_type_mappings.ts +1052 -0
  405. package/src/contract_function_simulator/oracle/private_execution.ts +2 -3
  406. package/src/contract_function_simulator/oracle/private_execution_oracle.ts +249 -92
  407. package/src/contract_function_simulator/oracle/utility_execution_oracle.ts +846 -325
  408. package/src/contract_function_simulator/pick_notes.ts +22 -3
  409. package/src/contract_function_simulator/transient_array_service.ts +91 -0
  410. package/src/debug/pxe_debug_utils.ts +8 -15
  411. package/src/entrypoints/client/bundle/index.ts +1 -0
  412. package/src/entrypoints/client/bundle/utils.ts +26 -8
  413. package/src/entrypoints/client/lazy/index.ts +1 -0
  414. package/src/entrypoints/client/lazy/utils.ts +26 -8
  415. package/src/entrypoints/client/store.ts +54 -0
  416. package/src/entrypoints/pxe_creation_options.ts +21 -1
  417. package/src/entrypoints/server/index.ts +7 -2
  418. package/src/entrypoints/server/store.ts +47 -0
  419. package/src/entrypoints/server/utils.ts +39 -14
  420. package/src/error_enriching.ts +30 -13
  421. package/src/events/event_service.ts +70 -24
  422. package/src/events/private_event_filter_validator.ts +21 -1
  423. package/src/hooks/authorize_utility_call.ts +44 -0
  424. package/src/hooks/execution_hooks.ts +68 -0
  425. package/src/hooks/index.ts +13 -0
  426. package/src/hooks/resolve_custom_request.ts +24 -0
  427. package/src/hooks/resolve_tagging_secret_strategy.ts +60 -0
  428. package/src/job_coordinator/job_coordinator.ts +30 -0
  429. package/src/logs/log_service.ts +212 -146
  430. package/src/messages/tx_resolver_service.ts +81 -0
  431. package/src/node/benchmarked_node.ts +140 -0
  432. package/src/node/caching_aztec_node.ts +407 -0
  433. package/src/notes/note_service.ts +123 -92
  434. package/src/oracle_version.ts +20 -10
  435. package/src/private_kernel/batch_planner.ts +169 -0
  436. package/src/private_kernel/hints/private_kernel_reset_private_inputs_builder.ts +15 -4
  437. package/src/private_kernel/hints/test_utils.ts +3 -10
  438. package/src/private_kernel/private_kernel_execution_prover.ts +246 -117
  439. package/src/private_kernel/private_kernel_oracle.ts +58 -29
  440. package/src/pxe.ts +576 -256
  441. package/src/storage/address_store/address_store.ts +2 -1
  442. package/src/storage/allowed_scopes.ts +14 -0
  443. package/src/storage/anchor_block_store/anchor_block_store.ts +9 -7
  444. package/src/storage/backwards_compatibility_tests/__snapshots__/AddressStore.json +22 -0
  445. package/src/storage/backwards_compatibility_tests/__snapshots__/AnchorBlockStore.json +3 -0
  446. package/src/storage/backwards_compatibility_tests/__snapshots__/CapsuleStore.json +16 -0
  447. package/src/storage/backwards_compatibility_tests/__snapshots__/ContractStore.json +28 -0
  448. package/src/storage/backwards_compatibility_tests/__snapshots__/FactStore.json +40 -0
  449. package/src/storage/backwards_compatibility_tests/__snapshots__/KeyStore.json +52 -0
  450. package/src/storage/backwards_compatibility_tests/__snapshots__/L2TipsKVStore.json +40 -0
  451. package/src/storage/backwards_compatibility_tests/__snapshots__/NoteStore.json +56 -0
  452. package/src/storage/backwards_compatibility_tests/__snapshots__/PrivateEventStore.json +44 -0
  453. package/src/storage/backwards_compatibility_tests/__snapshots__/RecipientTaggingStore.json +26 -0
  454. package/src/storage/backwards_compatibility_tests/__snapshots__/SenderTaggingStore.json +30 -0
  455. package/src/storage/backwards_compatibility_tests/__snapshots__/TaggingSecretSourcesStore.json +30 -0
  456. package/src/storage/backwards_compatibility_tests/__snapshots__/opened_stores.json +117 -0
  457. package/src/storage/backwards_compatibility_tests/kv_store_snapshot.ts +122 -0
  458. package/src/storage/backwards_compatibility_tests/schema_tests.ts +803 -0
  459. package/src/storage/backwards_compatibility_tests/store_spy.ts +73 -0
  460. package/src/storage/capsule_store/capsule_service.ts +8 -13
  461. package/src/storage/capsule_store/capsule_store.ts +16 -6
  462. package/src/storage/contract_store/contract_store.ts +98 -125
  463. package/src/storage/contract_store/private_functions_tree.ts +2 -1
  464. package/src/storage/fact_store/fact_service.ts +69 -0
  465. package/src/storage/fact_store/fact_store.ts +488 -0
  466. package/src/storage/fact_store/fact_store_keys.ts +75 -0
  467. package/src/storage/fact_store/index.ts +15 -0
  468. package/src/storage/fact_store/origin_state.ts +84 -0
  469. package/src/storage/fact_store/stored_fact.ts +80 -0
  470. package/src/storage/index.ts +2 -1
  471. package/src/storage/metadata.ts +1 -1
  472. package/src/storage/note_store/note_store.ts +231 -189
  473. package/src/storage/note_store/stored_note.ts +5 -27
  474. package/src/storage/open_pxe_stores.ts +52 -0
  475. package/src/storage/private_event_store/private_event_store.ts +55 -56
  476. package/src/storage/private_event_store/stored_private_event.ts +1 -1
  477. package/src/storage/store_identity.ts +72 -0
  478. package/src/storage/tagging_store/index.ts +1 -1
  479. package/src/storage/tagging_store/recipient_tagging_store.ts +5 -9
  480. package/src/storage/tagging_store/sender_tagging_store.ts +123 -50
  481. package/src/storage/tagging_store/tagging_secret_sources_store.ts +138 -0
  482. package/src/tagging/constants.ts +42 -10
  483. package/src/tagging/get_all_logs_by_tags.ts +115 -50
  484. package/src/tagging/index.ts +11 -5
  485. package/src/tagging/persist_sender_tagging_index_ranges.ts +57 -0
  486. package/src/tagging/recipient_sync/sync_tagged_private_logs.ts +356 -0
  487. package/src/tagging/recipient_sync/utils/find_highest_indexes.ts +2 -2
  488. package/src/tagging/reconcile_tagging_index_ranges.ts +102 -0
  489. package/src/tagging/sender_sync/sync_sender_tagging_indexes.ts +30 -38
  490. package/src/tagging/sender_sync/utils/classify_pending_txs.ts +92 -0
  491. package/src/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.ts +50 -44
  492. package/src/tagging/sender_sync/utils/resolve_pending_txs.ts +65 -0
  493. package/src/tagging/sender_sync/utils/test_utils.ts +46 -0
  494. package/src/tagging/testing/tag_query_test_utils.ts +11 -0
  495. package/dest/contract_function_simulator/benchmarked_node.d.ts +0 -9
  496. package/dest/contract_function_simulator/benchmarked_node.d.ts.map +0 -1
  497. package/dest/contract_function_simulator/benchmarked_node.js +0 -77
  498. package/dest/contract_function_simulator/oracle/legacy_oracle_mappings.d.ts +0 -9
  499. package/dest/contract_function_simulator/oracle/legacy_oracle_mappings.d.ts.map +0 -1
  500. package/dest/contract_function_simulator/oracle/legacy_oracle_mappings.js +0 -38
  501. package/dest/contract_function_simulator/oracle/oracle.d.ts +0 -80
  502. package/dest/contract_function_simulator/oracle/oracle.d.ts.map +0 -1
  503. package/dest/contract_function_simulator/oracle/oracle.js +0 -458
  504. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts +0 -6
  505. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts.map +0 -1
  506. package/dest/contract_function_simulator/proxied_contract_data_source.js +0 -80
  507. package/dest/contract_sync/contract_sync_service.d.ts +0 -44
  508. package/dest/contract_sync/contract_sync_service.d.ts.map +0 -1
  509. package/dest/contract_sync/contract_sync_service.js +0 -104
  510. package/dest/contract_sync/helpers.d.ts +0 -28
  511. package/dest/contract_sync/helpers.d.ts.map +0 -1
  512. package/dest/contract_sync/helpers.js +0 -60
  513. package/dest/messages/message_context_service.d.ts +0 -17
  514. package/dest/messages/message_context_service.d.ts.map +0 -1
  515. package/dest/messages/message_context_service.js +0 -36
  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 -12
  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 -39
  528. package/src/contract_function_simulator/benchmarked_node.ts +0 -103
  529. package/src/contract_function_simulator/oracle/legacy_oracle_mappings.ts +0 -98
  530. package/src/contract_function_simulator/oracle/oracle.ts +0 -721
  531. package/src/contract_function_simulator/proxied_contract_data_source.ts +0 -83
  532. package/src/contract_sync/contract_sync_service.ts +0 -170
  533. package/src/contract_sync/helpers.ts +0 -98
  534. package/src/messages/message_context_service.ts +0 -44
  535. package/src/storage/tagging_store/sender_address_book_store.ts +0 -48
  536. package/src/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.ts +0 -140
  537. package/src/tagging/recipient_sync/utils/load_logs_for_range.ts +0 -44
  538. package/src/tagging/sender_sync/utils/get_status_change_of_pending.ts +0 -51
@@ -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,12 +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
 
12
+ import type { NoteValidationRequest } from '../contract_function_simulator/noir-structs/note_validation_request.js';
10
13
  import type { NoteStore } from '../storage/note_store/note_store.js';
11
14
 
12
15
  export class NoteService {
@@ -24,7 +27,7 @@ export class NoteService {
24
27
  *
25
28
  * @param owner - The owner of the notes. If undefined, returns notes for all known owners.
26
29
  * @param status - The status of notes to fetch.
27
- * @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.
28
31
  */
29
32
  public async getNotes(
30
33
  contractAddress: AztecAddress,
@@ -80,24 +83,7 @@ export class NoteService {
80
83
  }
81
84
 
82
85
  const nullifiersToCheck = contractNotes.map(note => note.siloedNullifier);
83
- const nullifierBatches = nullifiersToCheck.reduce(
84
- (acc, nullifier) => {
85
- if (acc[acc.length - 1].length < MAX_RPC_LEN) {
86
- acc[acc.length - 1].push(nullifier);
87
- } else {
88
- acc.push([nullifier]);
89
- }
90
- return acc;
91
- },
92
- [[]] as Fr[][],
93
- );
94
- const nullifierIndexes = (
95
- await Promise.all(
96
- nullifierBatches.map(batch =>
97
- this.aztecNode.findLeavesIndexes(anchorBlockHash, MerkleTreeId.NULLIFIER_TREE, batch),
98
- ),
99
- )
100
- ).flat();
86
+ const nullifierIndexes = await this.#findNullifierIndexes(anchorBlockHash, nullifiersToCheck);
101
87
 
102
88
  const foundNullifiers = nullifiersToCheck
103
89
  .map((nullifier, i) => {
@@ -110,30 +96,34 @@ export class NoteService {
110
96
  await this.noteStore.applyNullifiers(foundNullifiers, this.jobId);
111
97
  }
112
98
 
113
- public async validateAndStoreNote(
114
- contractAddress: AztecAddress,
115
- owner: AztecAddress,
116
- storageSlot: Fr,
117
- randomness: Fr,
118
- noteNonce: Fr,
119
- content: Fr[],
120
- noteHash: Fr,
121
- nullifier: Fr,
122
- txHash: TxHash,
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[],
123
121
  scope: AztecAddress,
122
+ validationTxData: ReadonlyMap<string, NoteValidationTxData>,
124
123
  ): Promise<void> {
125
- // We are going to store the new note in the NoteStore, which will let us later return it via `getNotes`.
126
- // There's two things we need to check before we do this however:
127
- // - we must make sure the note does actually exist in the note hash tree
128
- // - we need to check if the note has already been nullified
129
- //
130
- // Failing to do either of the above would result in circuits getting either non-existent notes and failing to
131
- // produce inclusion proofs for them, or getting nullified notes and producing duplicate nullifiers, both of which
132
- // are catastrophic failure modes.
133
- //
134
- // Note that adding a note and removing it is *not* equivalent to never adding it in the first place. A nullifier
135
- // emitted in a block that comes after note creation might result in the note being de-nullified by a chain reorg,
136
- // so we must store both the note hash and nullifier block information.
124
+ if (requests.length === 0) {
125
+ return;
126
+ }
137
127
 
138
128
  // We avoid making node queries at 'latest' since we don't want to process notes or nullifiers that only exist ahead
139
129
  // in time of the locally synced state.
@@ -146,61 +136,102 @@ export class NoteService {
146
136
 
147
137
  // By computing siloed and unique note hashes ourselves we prevent contracts from interfering with the note storage
148
138
  // of other contracts, which would constitute a security breach.
149
- const uniqueNoteHash = await computeUniqueNoteHash(noteNonce, await siloNoteHash(contractAddress, noteHash));
150
- const siloedNullifier = await siloNullifier(contractAddress, nullifier);
151
-
152
- const [txEffect, [nullifierIndex]] = await Promise.all([
153
- this.aztecNode.getTxEffect(txHash),
154
- this.aztecNode.findLeavesIndexes(anchorBlockHash, MerkleTreeId.NULLIFIER_TREE, [siloedNullifier]),
155
- ]);
156
- if (!txEffect) {
157
- // We error out instead of just logging a warning and skipping the note because this would indicate a bug. This
158
- // is because the node has already served info about this tx either when obtaining the log (TxScopedL2Log contain
159
- // tx info) or when getting metadata for the offchain message (before the message got passed to `process_log`).
160
- throw new Error(`Could not find tx effect for tx hash ${txHash} when processing a note.`);
161
- }
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
+ );
162
149
 
163
- if (txEffect.l2BlockNumber > anchorBlockNumber) {
164
- // If the message was delivered onchain, this would indicate a bug: log sync should never load logs from blocks
165
- // newer than the anchor block. If the note came via an offchain message, it would likely also be a bug, since we
166
- // sync a new anchor block before calling `process_message`. For this not to be a bug, the message would need to
167
- // come from a newer block than the anchor served by the node, implying the node isn't properly synced.
168
- // We therefore error out here rather than assuming the offchain message was constructed by a malicious
169
- // sender with the intention of bricking recipient's PXE (if we assumed that we would just ignore the message).
170
- throw new Error(
171
- `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.`,
150
+ const nullifierIndexes = await this.#findNullifierIndexes(
151
+ anchorBlockHash,
152
+ computed.map(c => c.siloedNullifier),
153
+ );
154
+
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
+ ),
172
207
  );
173
- }
174
208
 
175
- // Find the index of the note hash in the noteHashes array to determine note ordering within the tx
176
- const noteIndexInTx = txEffect.data.noteHashes.findIndex(nh => nh.equals(uniqueNoteHash));
177
- if (noteIndexInTx === -1) {
178
- // Similar to the comment above - we error out as this would indicate a bug in nonce discovery.
179
- throw new Error(`Note hash ${noteHash} (uniqued as ${uniqueNoteHash}) is not present in tx ${txHash}`);
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
+ }
180
214
  }
181
215
 
182
- const noteDao = new NoteDao(
183
- new Note(content),
184
- contractAddress,
185
- owner,
186
- storageSlot,
187
- randomness,
188
- noteNonce,
189
- noteHash,
190
- siloedNullifier,
191
- txHash,
192
- txEffect.l2BlockNumber,
193
- txEffect.l2BlockHash.toString(),
194
- txEffect.txIndexInBlock,
195
- noteIndexInTx,
196
- );
197
-
198
- await this.noteStore.addNotes([noteDao], scope, this.jobId);
216
+ await this.noteStore.addNotes(noteDaos, scope, this.jobId);
199
217
 
200
- if (nullifierIndex !== undefined) {
201
- // We found nullifier index which implies that the note has already been nullified.
202
- const { data: _, ...blockHashAndNum } = nullifierIndex;
203
- await this.noteStore.applyNullifiers([{ data: siloedNullifier, ...blockHashAndNum }], this.jobId);
218
+ if (foundNullifiers.length > 0) {
219
+ await this.noteStore.applyNullifiers(foundNullifiers, this.jobId);
204
220
  }
205
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
+ }
206
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
+ };