@aztec/pxe 0.0.1-commit.993d240 → 0.0.1-commit.9a89641

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 (451) hide show
  1. package/dest/bin/check_oracle_version.d.ts +2 -12
  2. package/dest/bin/check_oracle_version.d.ts.map +1 -1
  3. package/dest/bin/check_oracle_version.js +9 -122
  4. package/dest/bin/index.d.ts +2 -2
  5. package/dest/bin/index.d.ts.map +1 -1
  6. package/dest/bin/index.js +1 -1
  7. package/dest/bin/oracle_version_helpers.d.ts +20 -0
  8. package/dest/bin/oracle_version_helpers.d.ts.map +1 -0
  9. package/dest/bin/oracle_version_helpers.js +25 -0
  10. package/dest/block_synchronizer/block_stream_source.d.ts +5 -5
  11. package/dest/block_synchronizer/block_stream_source.d.ts.map +1 -1
  12. package/dest/block_synchronizer/block_stream_source.js +4 -29
  13. package/dest/block_synchronizer/block_synchronizer.d.ts +17 -15
  14. package/dest/block_synchronizer/block_synchronizer.d.ts.map +1 -1
  15. package/dest/block_synchronizer/block_synchronizer.js +41 -18
  16. package/dest/config/index.d.ts +2 -1
  17. package/dest/config/index.d.ts.map +1 -1
  18. package/dest/config/index.js +1 -0
  19. package/dest/config/package_info.js +1 -1
  20. package/dest/contract/contract_class_service.d.ts +24 -0
  21. package/dest/contract/contract_class_service.d.ts.map +1 -0
  22. package/dest/contract/contract_class_service.js +36 -0
  23. package/dest/contract/contract_sync_service.d.ts +48 -0
  24. package/dest/contract/contract_sync_service.d.ts.map +1 -0
  25. package/dest/{contract_sync → contract}/contract_sync_service.js +26 -45
  26. package/dest/contract/helpers.d.ts +7 -0
  27. package/dest/contract/helpers.d.ts.map +1 -0
  28. package/dest/contract/helpers.js +20 -0
  29. package/dest/contract/skip_sync_contracts.d.ts +11 -0
  30. package/dest/contract/skip_sync_contracts.d.ts.map +1 -0
  31. package/dest/contract/skip_sync_contracts.js +18 -0
  32. package/dest/contract_function_simulator/anchored_contract_data.d.ts +36 -0
  33. package/dest/contract_function_simulator/anchored_contract_data.d.ts.map +1 -0
  34. package/dest/contract_function_simulator/anchored_contract_data.js +54 -0
  35. package/dest/contract_function_simulator/contract_function_simulator.d.ts +19 -25
  36. package/dest/contract_function_simulator/contract_function_simulator.d.ts.map +1 -1
  37. package/dest/contract_function_simulator/contract_function_simulator.js +63 -49
  38. package/dest/contract_function_simulator/execution_note_cache.d.ts +4 -10
  39. package/dest/contract_function_simulator/execution_note_cache.d.ts.map +1 -1
  40. package/dest/contract_function_simulator/execution_note_cache.js +8 -28
  41. package/dest/contract_function_simulator/index.d.ts +24 -6
  42. package/dest/contract_function_simulator/index.d.ts.map +1 -1
  43. package/dest/contract_function_simulator/index.js +9 -4
  44. package/dest/contract_function_simulator/noir-structs/bounded_vec.d.ts +8 -27
  45. package/dest/contract_function_simulator/noir-structs/bounded_vec.d.ts.map +1 -1
  46. package/dest/contract_function_simulator/noir-structs/bounded_vec.js +8 -23
  47. package/dest/contract_function_simulator/noir-structs/contract_class_log_data.d.ts +9 -0
  48. package/dest/contract_function_simulator/noir-structs/contract_class_log_data.d.ts.map +1 -0
  49. package/dest/contract_function_simulator/noir-structs/contract_class_log_data.js +1 -0
  50. package/dest/contract_function_simulator/noir-structs/embedded_curve_point.d.ts +7 -0
  51. package/dest/contract_function_simulator/noir-structs/embedded_curve_point.d.ts.map +1 -0
  52. package/dest/contract_function_simulator/noir-structs/embedded_curve_point.js +1 -0
  53. package/dest/contract_function_simulator/noir-structs/ephemeral_array.d.ts +37 -0
  54. package/dest/contract_function_simulator/noir-structs/ephemeral_array.d.ts.map +1 -0
  55. package/dest/contract_function_simulator/noir-structs/ephemeral_array.js +59 -0
  56. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts +3 -2
  57. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts.map +1 -1
  58. package/dest/contract_function_simulator/noir-structs/event_validation_request.js +2 -2
  59. package/dest/contract_function_simulator/noir-structs/fact.d.ts +16 -0
  60. package/dest/contract_function_simulator/noir-structs/fact.d.ts.map +1 -0
  61. package/dest/contract_function_simulator/noir-structs/fact.js +6 -0
  62. package/dest/contract_function_simulator/noir-structs/fact_collection.d.ts +27 -0
  63. package/dest/contract_function_simulator/noir-structs/fact_collection.d.ts.map +1 -0
  64. package/dest/contract_function_simulator/noir-structs/fact_collection.js +31 -0
  65. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.d.ts +11 -12
  66. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.d.ts.map +1 -1
  67. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.js +6 -49
  68. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts +10 -8
  69. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts.map +1 -1
  70. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.js +1 -60
  71. package/dest/contract_function_simulator/noir-structs/note_data.d.ts +27 -0
  72. package/dest/contract_function_simulator/noir-structs/note_data.d.ts.map +1 -0
  73. package/dest/contract_function_simulator/noir-structs/note_data.js +3 -0
  74. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts +3 -2
  75. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts.map +1 -1
  76. package/dest/contract_function_simulator/noir-structs/note_validation_request.js +3 -3
  77. package/dest/contract_function_simulator/noir-structs/option.d.ts +9 -11
  78. package/dest/contract_function_simulator/noir-structs/option.d.ts.map +1 -1
  79. package/dest/contract_function_simulator/noir-structs/option.js +18 -13
  80. package/dest/contract_function_simulator/noir-structs/origin_block.d.ts +11 -0
  81. package/dest/contract_function_simulator/noir-structs/origin_block.d.ts.map +1 -0
  82. package/dest/contract_function_simulator/noir-structs/origin_block.js +5 -0
  83. package/dest/contract_function_simulator/noir-structs/pending_tagged_log.d.ts +11 -0
  84. package/dest/contract_function_simulator/noir-structs/pending_tagged_log.d.ts.map +1 -0
  85. package/dest/contract_function_simulator/noir-structs/pending_tagged_log.js +4 -0
  86. package/dest/contract_function_simulator/noir-structs/provided_secret.d.ts +8 -0
  87. package/dest/contract_function_simulator/noir-structs/provided_secret.d.ts.map +1 -0
  88. package/dest/contract_function_simulator/noir-structs/provided_secret.js +1 -0
  89. package/dest/contract_function_simulator/noir-structs/resolved_tagging_strategy.d.ts +28 -0
  90. package/dest/contract_function_simulator/noir-structs/resolved_tagging_strategy.d.ts.map +1 -0
  91. package/dest/contract_function_simulator/noir-structs/resolved_tagging_strategy.js +50 -0
  92. package/dest/contract_function_simulator/noir-structs/resolved_tx.d.ts +19 -0
  93. package/dest/contract_function_simulator/noir-structs/resolved_tx.d.ts.map +1 -0
  94. package/dest/contract_function_simulator/noir-structs/resolved_tx.js +9 -0
  95. package/dest/contract_function_simulator/noir-structs/tx_effect_data.d.ts +15 -0
  96. package/dest/contract_function_simulator/noir-structs/tx_effect_data.d.ts.map +1 -0
  97. package/dest/contract_function_simulator/noir-structs/tx_effect_data.js +5 -0
  98. package/dest/contract_function_simulator/noir-structs/utility_context.d.ts +6 -11
  99. package/dest/contract_function_simulator/noir-structs/utility_context.d.ts.map +1 -1
  100. package/dest/contract_function_simulator/noir-structs/utility_context.js +1 -20
  101. package/dest/contract_function_simulator/oracle/acir_callback.d.ts +21 -0
  102. package/dest/contract_function_simulator/oracle/acir_callback.d.ts.map +1 -0
  103. package/dest/contract_function_simulator/oracle/acir_callback.js +115 -0
  104. package/dest/contract_function_simulator/oracle/index.d.ts +2 -13
  105. package/dest/contract_function_simulator/oracle/index.d.ts.map +1 -1
  106. package/dest/contract_function_simulator/oracle/index.js +1 -1
  107. package/dest/contract_function_simulator/oracle/interfaces.d.ts +15 -114
  108. package/dest/contract_function_simulator/oracle/interfaces.d.ts.map +1 -1
  109. package/dest/contract_function_simulator/oracle/interfaces.js +2 -2
  110. package/dest/contract_function_simulator/oracle/legacy_oracle_registry.d.ts +39 -0
  111. package/dest/contract_function_simulator/oracle/legacy_oracle_registry.d.ts.map +1 -0
  112. package/dest/contract_function_simulator/oracle/legacy_oracle_registry.js +107 -0
  113. package/dest/contract_function_simulator/oracle/message_load_oracle_inputs.d.ts +3 -14
  114. package/dest/contract_function_simulator/oracle/message_load_oracle_inputs.d.ts.map +1 -1
  115. package/dest/contract_function_simulator/oracle/message_load_oracle_inputs.js +1 -24
  116. package/dest/contract_function_simulator/oracle/oracle_registry.d.ts +92 -100
  117. package/dest/contract_function_simulator/oracle/oracle_registry.d.ts.map +1 -1
  118. package/dest/contract_function_simulator/oracle/oracle_registry.js +296 -479
  119. package/dest/contract_function_simulator/oracle/oracle_type_mappings.d.ts +274 -0
  120. package/dest/contract_function_simulator/oracle/oracle_type_mappings.d.ts.map +1 -0
  121. package/dest/contract_function_simulator/oracle/oracle_type_mappings.js +1253 -0
  122. package/dest/contract_function_simulator/oracle/private_execution.d.ts +1 -1
  123. package/dest/contract_function_simulator/oracle/private_execution.d.ts.map +1 -1
  124. package/dest/contract_function_simulator/oracle/private_execution.js +2 -3
  125. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts +32 -21
  126. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts.map +1 -1
  127. package/dest/contract_function_simulator/oracle/private_execution_oracle.js +152 -49
  128. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts +97 -37
  129. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts.map +1 -1
  130. package/dest/contract_function_simulator/oracle/utility_execution_oracle.js +376 -138
  131. package/dest/contract_function_simulator/transient_array_service.d.ts +31 -0
  132. package/dest/contract_function_simulator/transient_array_service.d.ts.map +1 -0
  133. package/dest/contract_function_simulator/transient_array_service.js +62 -0
  134. package/dest/debug/pxe_debug_utils.d.ts +2 -2
  135. package/dest/debug/pxe_debug_utils.d.ts.map +1 -1
  136. package/dest/entrypoints/client/bundle/index.d.ts +2 -1
  137. package/dest/entrypoints/client/bundle/index.d.ts.map +1 -1
  138. package/dest/entrypoints/client/bundle/index.js +1 -0
  139. package/dest/entrypoints/client/bundle/utils.d.ts +1 -1
  140. package/dest/entrypoints/client/bundle/utils.d.ts.map +1 -1
  141. package/dest/entrypoints/client/bundle/utils.js +17 -6
  142. package/dest/entrypoints/client/lazy/index.d.ts +2 -1
  143. package/dest/entrypoints/client/lazy/index.d.ts.map +1 -1
  144. package/dest/entrypoints/client/lazy/index.js +1 -0
  145. package/dest/entrypoints/client/lazy/utils.d.ts +1 -1
  146. package/dest/entrypoints/client/lazy/utils.d.ts.map +1 -1
  147. package/dest/entrypoints/client/lazy/utils.js +17 -6
  148. package/dest/entrypoints/client/store.d.ts +14 -0
  149. package/dest/entrypoints/client/store.d.ts.map +1 -0
  150. package/dest/entrypoints/client/store.js +42 -0
  151. package/dest/entrypoints/pxe_creation_options.d.ts +9 -3
  152. package/dest/entrypoints/pxe_creation_options.d.ts.map +1 -1
  153. package/dest/entrypoints/server/index.d.ts +6 -3
  154. package/dest/entrypoints/server/index.d.ts.map +1 -1
  155. package/dest/entrypoints/server/index.js +4 -2
  156. package/dest/entrypoints/server/store.d.ts +18 -0
  157. package/dest/entrypoints/server/store.d.ts.map +1 -0
  158. package/dest/entrypoints/server/store.js +28 -0
  159. package/dest/entrypoints/server/utils.d.ts +1 -1
  160. package/dest/entrypoints/server/utils.d.ts.map +1 -1
  161. package/dest/entrypoints/server/utils.js +16 -4
  162. package/dest/error_enriching.d.ts +5 -3
  163. package/dest/error_enriching.d.ts.map +1 -1
  164. package/dest/error_enriching.js +13 -11
  165. package/dest/events/event_service.d.ts +13 -6
  166. package/dest/events/event_service.d.ts.map +1 -1
  167. package/dest/events/event_service.js +13 -13
  168. package/dest/hooks/execution_hooks.d.ts +31 -11
  169. package/dest/hooks/execution_hooks.d.ts.map +1 -1
  170. package/dest/hooks/execution_hooks.js +3 -3
  171. package/dest/hooks/index.d.ts +4 -3
  172. package/dest/hooks/index.d.ts.map +1 -1
  173. package/dest/hooks/index.js +1 -0
  174. package/dest/hooks/resolve_custom_request.d.ts +23 -0
  175. package/dest/hooks/resolve_custom_request.d.ts.map +1 -0
  176. package/dest/hooks/resolve_custom_request.js +3 -0
  177. package/dest/hooks/resolve_tagging_secret_strategy.d.ts +50 -0
  178. package/dest/hooks/resolve_tagging_secret_strategy.d.ts.map +1 -0
  179. package/dest/hooks/resolve_tagging_secret_strategy.js +3 -0
  180. package/dest/logs/log_service.d.ts +18 -8
  181. package/dest/logs/log_service.d.ts.map +1 -1
  182. package/dest/logs/log_service.js +93 -45
  183. package/dest/messages/tx_resolver_service.d.ts +28 -0
  184. package/dest/messages/tx_resolver_service.d.ts.map +1 -0
  185. package/dest/messages/tx_resolver_service.js +61 -0
  186. package/dest/node/benchmarked_node.d.ts +20 -0
  187. package/dest/node/benchmarked_node.d.ts.map +1 -0
  188. package/dest/node/benchmarked_node.js +94 -0
  189. package/dest/node/caching_aztec_node.d.ts +24 -0
  190. package/dest/node/caching_aztec_node.d.ts.map +1 -0
  191. package/dest/node/caching_aztec_node.js +267 -0
  192. package/dest/notes/note_service.d.ts +13 -7
  193. package/dest/notes/note_service.d.ts.map +1 -1
  194. package/dest/notes/note_service.js +10 -10
  195. package/dest/oracle_version.d.ts +3 -3
  196. package/dest/oracle_version.js +8 -8
  197. package/dest/private_kernel/batch_planner.d.ts +1 -1
  198. package/dest/private_kernel/batch_planner.d.ts.map +1 -1
  199. package/dest/private_kernel/batch_planner.js +1 -1
  200. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts +1 -1
  201. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts.map +1 -1
  202. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.js +6 -2
  203. package/dest/private_kernel/hints/test_utils.js +1 -1
  204. package/dest/private_kernel/private_kernel_execution_prover.d.ts +1 -1
  205. package/dest/private_kernel/private_kernel_execution_prover.d.ts.map +1 -1
  206. package/dest/private_kernel/private_kernel_execution_prover.js +61 -40
  207. package/dest/private_kernel/private_kernel_oracle.d.ts +4 -2
  208. package/dest/private_kernel/private_kernel_oracle.d.ts.map +1 -1
  209. package/dest/private_kernel/private_kernel_oracle.js +17 -5
  210. package/dest/pxe.d.ts +114 -48
  211. package/dest/pxe.d.ts.map +1 -1
  212. package/dest/pxe.js +251 -148
  213. package/dest/storage/allowed_scopes.d.ts +6 -0
  214. package/dest/storage/allowed_scopes.d.ts.map +1 -0
  215. package/dest/storage/allowed_scopes.js +7 -0
  216. package/dest/storage/anchor_block_store/anchor_block_store.d.ts +9 -6
  217. package/dest/storage/anchor_block_store/anchor_block_store.d.ts.map +1 -1
  218. package/dest/storage/anchor_block_store/anchor_block_store.js +8 -6
  219. package/dest/storage/backwards_compatibility_tests/schema_tests.d.ts +1 -1
  220. package/dest/storage/backwards_compatibility_tests/schema_tests.d.ts.map +1 -1
  221. package/dest/storage/backwards_compatibility_tests/schema_tests.js +129 -49
  222. package/dest/storage/capsule_store/capsule_service.d.ts +1 -1
  223. package/dest/storage/capsule_store/capsule_service.d.ts.map +1 -1
  224. package/dest/storage/capsule_store/capsule_service.js +6 -9
  225. package/dest/storage/contract_store/contract_store.d.ts +27 -24
  226. package/dest/storage/contract_store/contract_store.d.ts.map +1 -1
  227. package/dest/storage/contract_store/contract_store.js +66 -77
  228. package/dest/storage/fact_store/fact_service.d.ts +22 -0
  229. package/dest/storage/fact_store/fact_service.d.ts.map +1 -0
  230. package/dest/storage/fact_store/fact_service.js +45 -0
  231. package/dest/storage/fact_store/fact_store.d.ts +95 -0
  232. package/dest/storage/fact_store/fact_store.d.ts.map +1 -0
  233. package/dest/storage/fact_store/fact_store.js +408 -0
  234. package/dest/storage/fact_store/fact_store_keys.d.ts +34 -0
  235. package/dest/storage/fact_store/fact_store_keys.d.ts.map +1 -0
  236. package/dest/storage/fact_store/fact_store_keys.js +50 -0
  237. package/dest/storage/fact_store/index.d.ts +6 -0
  238. package/dest/storage/fact_store/index.d.ts.map +1 -0
  239. package/dest/storage/fact_store/index.js +4 -0
  240. package/dest/storage/fact_store/origin_state.d.ts +59 -0
  241. package/dest/storage/fact_store/origin_state.d.ts.map +1 -0
  242. package/dest/storage/fact_store/origin_state.js +60 -0
  243. package/dest/storage/fact_store/stored_fact.d.ts +32 -0
  244. package/dest/storage/fact_store/stored_fact.d.ts.map +1 -0
  245. package/dest/storage/fact_store/stored_fact.js +64 -0
  246. package/dest/storage/index.d.ts +3 -2
  247. package/dest/storage/index.d.ts.map +1 -1
  248. package/dest/storage/index.js +2 -1
  249. package/dest/storage/metadata.d.ts +2 -2
  250. package/dest/storage/metadata.d.ts.map +1 -1
  251. package/dest/storage/metadata.js +1 -1
  252. package/dest/storage/note_store/note_store.d.ts +42 -33
  253. package/dest/storage/note_store/note_store.d.ts.map +1 -1
  254. package/dest/storage/note_store/note_store.js +197 -168
  255. package/dest/storage/note_store/stored_note.d.ts +3 -8
  256. package/dest/storage/note_store/stored_note.d.ts.map +1 -1
  257. package/dest/storage/note_store/stored_note.js +4 -20
  258. package/dest/storage/open_pxe_stores.d.ts +5 -3
  259. package/dest/storage/open_pxe_stores.d.ts.map +1 -1
  260. package/dest/storage/open_pxe_stores.js +5 -3
  261. package/dest/storage/private_event_store/private_event_store.d.ts +13 -16
  262. package/dest/storage/private_event_store/private_event_store.d.ts.map +1 -1
  263. package/dest/storage/private_event_store/private_event_store.js +40 -43
  264. package/dest/storage/store_identity.d.ts +35 -0
  265. package/dest/storage/store_identity.d.ts.map +1 -0
  266. package/dest/storage/store_identity.js +44 -0
  267. package/dest/storage/tagging_store/index.d.ts +2 -2
  268. package/dest/storage/tagging_store/index.d.ts.map +1 -1
  269. package/dest/storage/tagging_store/index.js +1 -1
  270. package/dest/storage/tagging_store/sender_tagging_store.d.ts +41 -10
  271. package/dest/storage/tagging_store/sender_tagging_store.d.ts.map +1 -1
  272. package/dest/storage/tagging_store/sender_tagging_store.js +81 -29
  273. package/dest/storage/tagging_store/tagging_secret_sources_store.d.ts +51 -0
  274. package/dest/storage/tagging_store/tagging_secret_sources_store.d.ts.map +1 -0
  275. package/dest/storage/tagging_store/tagging_secret_sources_store.js +105 -0
  276. package/dest/tagging/constants.d.ts +11 -2
  277. package/dest/tagging/constants.d.ts.map +1 -1
  278. package/dest/tagging/constants.js +38 -10
  279. package/dest/tagging/get_all_logs_by_tags.d.ts +29 -8
  280. package/dest/tagging/get_all_logs_by_tags.d.ts.map +1 -1
  281. package/dest/tagging/get_all_logs_by_tags.js +29 -10
  282. package/dest/tagging/index.d.ts +3 -3
  283. package/dest/tagging/index.d.ts.map +1 -1
  284. package/dest/tagging/index.js +2 -2
  285. package/dest/tagging/recipient_sync/sync_tagged_private_logs.d.ts +27 -9
  286. package/dest/tagging/recipient_sync/sync_tagged_private_logs.d.ts.map +1 -1
  287. package/dest/tagging/recipient_sync/sync_tagged_private_logs.js +104 -33
  288. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts +6 -3
  289. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts.map +1 -1
  290. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.js +23 -36
  291. package/dest/tagging/sender_sync/utils/classify_pending_txs.d.ts +22 -0
  292. package/dest/tagging/sender_sync/utils/classify_pending_txs.d.ts.map +1 -0
  293. package/dest/tagging/sender_sync/utils/classify_pending_txs.js +61 -0
  294. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts +15 -5
  295. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts.map +1 -1
  296. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.js +36 -35
  297. package/dest/tagging/sender_sync/utils/resolve_pending_txs.d.ts +29 -0
  298. package/dest/tagging/sender_sync/utils/resolve_pending_txs.d.ts.map +1 -0
  299. package/dest/tagging/sender_sync/utils/resolve_pending_txs.js +41 -0
  300. package/dest/tagging/sender_sync/utils/test_utils.d.ts +16 -0
  301. package/dest/tagging/sender_sync/utils/test_utils.d.ts.map +1 -0
  302. package/dest/tagging/sender_sync/utils/test_utils.js +24 -0
  303. package/dest/tagging/testing/tag_query_test_utils.d.ts +6 -0
  304. package/dest/tagging/testing/tag_query_test_utils.d.ts.map +1 -0
  305. package/dest/tagging/testing/tag_query_test_utils.js +10 -0
  306. package/package.json +17 -17
  307. package/src/bin/check_oracle_version.ts +8 -151
  308. package/src/bin/index.ts +1 -1
  309. package/src/bin/oracle_version_helpers.ts +30 -0
  310. package/src/block_synchronizer/block_stream_source.ts +6 -45
  311. package/src/block_synchronizer/block_synchronizer.ts +54 -30
  312. package/src/config/index.ts +1 -0
  313. package/src/config/package_info.ts +1 -1
  314. package/src/contract/contract_class_service.ts +45 -0
  315. package/src/{contract_sync → contract}/contract_sync_service.ts +37 -50
  316. package/src/contract/helpers.ts +35 -0
  317. package/src/contract/skip_sync_contracts.ts +23 -0
  318. package/src/contract_function_simulator/anchored_contract_data.ts +74 -0
  319. package/src/contract_function_simulator/contract_function_simulator.ts +96 -59
  320. package/src/contract_function_simulator/execution_note_cache.ts +8 -29
  321. package/src/contract_function_simulator/index.ts +87 -5
  322. package/src/contract_function_simulator/noir-structs/bounded_vec.ts +12 -24
  323. package/src/contract_function_simulator/noir-structs/contract_class_log_data.ts +9 -0
  324. package/src/contract_function_simulator/noir-structs/embedded_curve_point.ts +4 -0
  325. package/src/contract_function_simulator/noir-structs/ephemeral_array.ts +66 -0
  326. package/src/contract_function_simulator/noir-structs/event_validation_request.ts +3 -3
  327. package/src/contract_function_simulator/noir-structs/fact.ts +13 -0
  328. package/src/contract_function_simulator/noir-structs/fact_collection.ts +64 -0
  329. package/src/contract_function_simulator/noir-structs/log_retrieval_request.ts +20 -46
  330. package/src/contract_function_simulator/noir-structs/log_retrieval_response.ts +13 -60
  331. package/src/contract_function_simulator/noir-structs/note_data.ts +27 -0
  332. package/src/contract_function_simulator/noir-structs/note_validation_request.ts +4 -4
  333. package/src/contract_function_simulator/noir-structs/option.ts +17 -11
  334. package/src/contract_function_simulator/noir-structs/origin_block.ts +8 -0
  335. package/src/contract_function_simulator/noir-structs/pending_tagged_log.ts +12 -0
  336. package/src/contract_function_simulator/noir-structs/provided_secret.ts +5 -0
  337. package/src/contract_function_simulator/noir-structs/resolved_tagging_strategy.ts +66 -0
  338. package/src/contract_function_simulator/noir-structs/resolved_tx.ts +19 -0
  339. package/src/contract_function_simulator/noir-structs/tx_effect_data.ts +16 -0
  340. package/src/contract_function_simulator/noir-structs/utility_context.ts +5 -17
  341. package/src/contract_function_simulator/oracle/acir_callback.ts +154 -0
  342. package/src/contract_function_simulator/oracle/index.ts +1 -15
  343. package/src/contract_function_simulator/oracle/interfaces.ts +11 -189
  344. package/src/contract_function_simulator/oracle/legacy_oracle_registry.ts +147 -0
  345. package/src/contract_function_simulator/oracle/message_load_oracle_inputs.ts +6 -21
  346. package/src/contract_function_simulator/oracle/oracle_registry.ts +289 -483
  347. package/src/contract_function_simulator/oracle/oracle_type_mappings.ts +1067 -0
  348. package/src/contract_function_simulator/oracle/private_execution.ts +2 -3
  349. package/src/contract_function_simulator/oracle/private_execution_oracle.ts +190 -61
  350. package/src/contract_function_simulator/oracle/utility_execution_oracle.ts +556 -174
  351. package/src/contract_function_simulator/transient_array_service.ts +91 -0
  352. package/src/debug/pxe_debug_utils.ts +1 -1
  353. package/src/entrypoints/client/bundle/index.ts +1 -0
  354. package/src/entrypoints/client/bundle/utils.ts +24 -5
  355. package/src/entrypoints/client/lazy/index.ts +1 -0
  356. package/src/entrypoints/client/lazy/utils.ts +24 -5
  357. package/src/entrypoints/client/store.ts +54 -0
  358. package/src/entrypoints/pxe_creation_options.ts +8 -2
  359. package/src/entrypoints/server/index.ts +6 -2
  360. package/src/entrypoints/server/store.ts +47 -0
  361. package/src/entrypoints/server/utils.ts +31 -9
  362. package/src/error_enriching.ts +27 -11
  363. package/src/events/event_service.ts +24 -14
  364. package/src/hooks/execution_hooks.ts +32 -12
  365. package/src/hooks/index.ts +8 -2
  366. package/src/hooks/resolve_custom_request.ts +24 -0
  367. package/src/hooks/resolve_tagging_secret_strategy.ts +60 -0
  368. package/src/logs/log_service.ts +122 -61
  369. package/src/messages/tx_resolver_service.ts +80 -0
  370. package/src/node/benchmarked_node.ts +140 -0
  371. package/src/node/caching_aztec_node.ts +406 -0
  372. package/src/notes/note_service.ts +20 -14
  373. package/src/oracle_version.ts +8 -8
  374. package/src/private_kernel/batch_planner.ts +0 -1
  375. package/src/private_kernel/hints/private_kernel_reset_private_inputs_builder.ts +11 -1
  376. package/src/private_kernel/hints/test_utils.ts +1 -1
  377. package/src/private_kernel/private_kernel_execution_prover.ts +112 -56
  378. package/src/private_kernel/private_kernel_oracle.ts +23 -4
  379. package/src/pxe.ts +357 -172
  380. package/src/storage/allowed_scopes.ts +14 -0
  381. package/src/storage/anchor_block_store/anchor_block_store.ts +8 -6
  382. package/src/storage/backwards_compatibility_tests/__snapshots__/AddressStore.json +6 -6
  383. package/src/storage/backwards_compatibility_tests/__snapshots__/ContractStore.json +1 -1
  384. package/src/storage/backwards_compatibility_tests/__snapshots__/FactStore.json +40 -0
  385. package/src/storage/backwards_compatibility_tests/__snapshots__/KeyStore.json +12 -12
  386. package/src/storage/backwards_compatibility_tests/__snapshots__/L2TipsKVStore.json +9 -15
  387. package/src/storage/backwards_compatibility_tests/__snapshots__/NoteStore.json +24 -4
  388. package/src/storage/backwards_compatibility_tests/__snapshots__/RecipientTaggingStore.json +11 -3
  389. package/src/storage/backwards_compatibility_tests/__snapshots__/SenderTaggingStore.json +12 -4
  390. package/src/storage/backwards_compatibility_tests/__snapshots__/TaggingSecretSourcesStore.json +30 -0
  391. package/src/storage/backwards_compatibility_tests/__snapshots__/opened_stores.json +29 -9
  392. package/src/storage/backwards_compatibility_tests/schema_tests.ts +141 -50
  393. package/src/storage/capsule_store/capsule_service.ts +8 -13
  394. package/src/storage/contract_store/contract_store.ts +88 -94
  395. package/src/storage/fact_store/fact_service.ts +69 -0
  396. package/src/storage/fact_store/fact_store.ts +487 -0
  397. package/src/storage/fact_store/fact_store_keys.ts +75 -0
  398. package/src/storage/fact_store/index.ts +15 -0
  399. package/src/storage/fact_store/origin_state.ts +84 -0
  400. package/src/storage/fact_store/stored_fact.ts +80 -0
  401. package/src/storage/index.ts +2 -1
  402. package/src/storage/metadata.ts +1 -1
  403. package/src/storage/note_store/note_store.ts +226 -187
  404. package/src/storage/note_store/stored_note.ts +5 -27
  405. package/src/storage/open_pxe_stores.ts +6 -3
  406. package/src/storage/private_event_store/private_event_store.ts +49 -55
  407. package/src/storage/store_identity.ts +72 -0
  408. package/src/storage/tagging_store/index.ts +1 -1
  409. package/src/storage/tagging_store/sender_tagging_store.ts +113 -41
  410. package/src/storage/tagging_store/tagging_secret_sources_store.ts +138 -0
  411. package/src/tagging/constants.ts +42 -10
  412. package/src/tagging/get_all_logs_by_tags.ts +47 -11
  413. package/src/tagging/index.ts +7 -2
  414. package/src/tagging/recipient_sync/sync_tagged_private_logs.ts +161 -46
  415. package/src/tagging/sender_sync/sync_sender_tagging_indexes.ts +27 -57
  416. package/src/tagging/sender_sync/utils/classify_pending_txs.ts +91 -0
  417. package/src/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.ts +46 -40
  418. package/src/tagging/sender_sync/utils/resolve_pending_txs.ts +64 -0
  419. package/src/tagging/sender_sync/utils/test_utils.ts +46 -0
  420. package/src/tagging/testing/tag_query_test_utils.ts +11 -0
  421. package/dest/contract_function_simulator/benchmarked_node.d.ts +0 -9
  422. package/dest/contract_function_simulator/benchmarked_node.d.ts.map +0 -1
  423. package/dest/contract_function_simulator/benchmarked_node.js +0 -77
  424. package/dest/contract_function_simulator/oracle/oracle.d.ts +0 -89
  425. package/dest/contract_function_simulator/oracle/oracle.d.ts.map +0 -1
  426. package/dest/contract_function_simulator/oracle/oracle.js +0 -552
  427. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts +0 -6
  428. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts.map +0 -1
  429. package/dest/contract_function_simulator/proxied_contract_data_source.js +0 -51
  430. package/dest/contract_sync/contract_sync_service.d.ts +0 -42
  431. package/dest/contract_sync/contract_sync_service.d.ts.map +0 -1
  432. package/dest/contract_sync/helpers.d.ts +0 -27
  433. package/dest/contract_sync/helpers.d.ts.map +0 -1
  434. package/dest/contract_sync/helpers.js +0 -53
  435. package/dest/messages/message_context_service.d.ts +0 -17
  436. package/dest/messages/message_context_service.d.ts.map +0 -1
  437. package/dest/messages/message_context_service.js +0 -38
  438. package/dest/storage/tagging_store/sender_address_book_store.d.ts +0 -14
  439. package/dest/storage/tagging_store/sender_address_book_store.d.ts.map +0 -1
  440. package/dest/storage/tagging_store/sender_address_book_store.js +0 -36
  441. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts +0 -17
  442. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts.map +0 -1
  443. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.js +0 -60
  444. package/src/contract_function_simulator/benchmarked_node.ts +0 -103
  445. package/src/contract_function_simulator/oracle/oracle.ts +0 -711
  446. package/src/contract_function_simulator/proxied_contract_data_source.ts +0 -60
  447. package/src/contract_sync/helpers.ts +0 -86
  448. package/src/messages/message_context_service.ts +0 -45
  449. package/src/storage/backwards_compatibility_tests/__snapshots__/SenderAddressBookStore.json +0 -16
  450. package/src/storage/tagging_store/sender_address_book_store.ts +0 -48
  451. package/src/tagging/sender_sync/utils/get_status_change_of_pending.ts +0 -66
@@ -1,20 +1,19 @@
1
- import type { BlockHash } from '@aztec/stdlib/block';
1
+ import type { BlockNumber } from '@aztec/foundation/branded-types';
2
2
  import type { AztecNode } from '@aztec/stdlib/interfaces/server';
3
3
  import type { AppTaggingSecret } from '@aztec/stdlib/logs';
4
4
 
5
5
  import type { SenderTaggingStore } from '../../storage/tagging_store/sender_tagging_store.js';
6
- import { UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN } from '../constants.js';
7
- import {
8
- EMPTY_STATUS_CHANGE,
9
- getStatusChangeOfPending,
10
- mergeStatusChanges,
11
- } from './utils/get_status_change_of_pending.js';
6
+ import { unfinalizedTaggingIndexesWindowEnd } from '../constants.js';
7
+ import type { LogQueryAnchor } from '../get_all_logs_by_tags.js';
12
8
  import { loadAndStoreNewTaggingIndexes } from './utils/load_and_store_new_tagging_indexes.js';
9
+ import { resolvePendingTxs } from './utils/resolve_pending_txs.js';
13
10
 
14
11
  /**
15
12
  * Syncs tagging indexes. This function needs to be called whenever a private log is being sent.
16
13
  *
17
14
  * @param secret - The sender-side tagging `AppTaggingSecret`.
15
+ * @param finalizedBlockNumber - The locally-synced finalized tip, used to tell whether the block a discovered log
16
+ * sits in is finalized.
18
17
  * @remarks When syncing the indexes as sender we don't care about the log contents - we only care about the highest
19
18
  * pending and highest finalized indexes as that guides the next index choice when sending a log. The next index choice
20
19
  * is simply the highest pending index plus one (or finalized if pending is undefined).
@@ -25,7 +24,8 @@ export async function syncSenderTaggingIndexes(
25
24
  secret: AppTaggingSecret,
26
25
  aztecNode: AztecNode,
27
26
  taggingStore: SenderTaggingStore,
28
- anchorBlockHash: BlockHash,
27
+ finalizedBlockNumber: BlockNumber,
28
+ anchor: LogQueryAnchor,
29
29
  jobId: string,
30
30
  ): Promise<void> {
31
31
  // # Explanation of how syncing works
@@ -43,68 +43,39 @@ export async function syncSenderTaggingIndexes(
43
43
  // than WINDOW_LEN from the highest finalized index.
44
44
  //
45
45
  // # Note on performance
46
- // Each window advance requires two queries (logs + tx status). For example, syncing indexes 0–500 with a window of
47
- // 100 takes at least 10 round trips (5 windows × 2 queries).
46
+ // A window advance usually takes a single logs query: the finalization status of most txs the logs surface is
47
+ // derived from the log block numbers and the locally-synced finalized tip, without a per-tx node call. See
48
+ // `resolvePendingTxs` for the txs that the logs cannot settle and what they cost.
48
49
 
49
50
  const finalizedIndex = await taggingStore.getLastFinalizedIndex(secret, jobId);
50
51
 
51
52
  let start = finalizedIndex === undefined ? 0 : finalizedIndex + 1;
52
- let end = start + UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN;
53
+ // The loop only extends the window when the finalized index moves,
54
+ // so this first window must cover the entire permitted range on its own.
55
+ let end = unfinalizedTaggingIndexesWindowEnd(finalizedIndex);
53
56
 
54
57
  let previousFinalizedIndex = finalizedIndex;
55
58
  let newFinalizedIndex = undefined;
56
59
 
57
60
  while (true) {
58
- // Pending tx hashes already in the store for this window (from prior syncs or txs this PXE itself sent).
59
- // Reading these before issuing any RPC lets us fetch their receipts in parallel with the logs query below.
60
- const knownPendingTxHashes = await taggingStore.getTxHashesOfPendingIndexes(secret, start, end, jobId);
61
+ const txsInLogs = await loadAndStoreNewTaggingIndexes(secret, start, end, aztecNode, taggingStore, anchor, jobId);
61
62
 
62
- // Fire the logs query and the known-pending receipts query in parallel
63
- const [, statusOfKnown] = await Promise.all([
64
- loadAndStoreNewTaggingIndexes(secret, start, end, aztecNode, taggingStore, anchorBlockHash, jobId),
65
- knownPendingTxHashes.length > 0
66
- ? getStatusChangeOfPending(knownPendingTxHashes, aztecNode)
67
- : Promise.resolve(EMPTY_STATUS_CHANGE),
68
- ]);
69
-
70
- // Re-read pending tx hashes after the logs query writes any newly-discovered ones to the store.
71
- const allPendingTxHashes = await taggingStore.getTxHashesOfPendingIndexes(secret, start, end, jobId);
72
- if (allPendingTxHashes.length === 0) {
63
+ // Pending txs for this window: prior syncs, txs this PXE itself sent, and what the logs just stored.
64
+ const pendingTxs = await taggingStore.getPendingTxs(secret, start, end, jobId);
65
+ if (pendingTxs.length === 0) {
73
66
  break;
74
67
  }
75
68
 
76
- // Receipts for pending tx hashes that the logs query just surfaced still need a sequential follow-up call.
77
- // `storePendingIndexes` is idempotent on (secret, txHash), so a re-discovered hash stays classified as known
78
- // and is not re-fetched here.
79
- const knownSet = new Set(knownPendingTxHashes.map(h => h.toString()));
80
- const newPendingTxHashes = allPendingTxHashes.filter(h => !knownSet.has(h.toString()));
81
-
82
- const statusOfNew =
83
- newPendingTxHashes.length > 0
84
- ? await getStatusChangeOfPending(newPendingTxHashes, aztecNode)
85
- : EMPTY_STATUS_CHANGE;
86
-
87
- const { txHashesToFinalize, txHashesToDrop, txHashesWithExecutionReverted } = mergeStatusChanges(
88
- statusOfKnown,
89
- statusOfNew,
90
- );
91
-
92
- await taggingStore.dropPendingIndexes(txHashesToDrop, jobId);
93
- await taggingStore.finalizePendingIndexes(txHashesToFinalize, jobId);
69
+ const { txHashesFinalizedFromLogs, txHashesFinalizedFromReceipts, txHashesDropped, receiptsWithExecutionReverted } =
70
+ await resolvePendingTxs(pendingTxs, txsInLogs, finalizedBlockNumber, aztecNode);
94
71
 
95
- if (txHashesWithExecutionReverted.length > 0) {
96
- const indexedTxEffects = await Promise.all(
97
- txHashesWithExecutionReverted.map(txHash => aztecNode.getTxEffect(txHash)),
98
- );
99
- for (const indexedTxEffect of indexedTxEffects) {
100
- if (indexedTxEffect === undefined) {
101
- throw new Error(
102
- 'TxEffect not found for execution-reverted tx. This is either a bug or a reorg has occurred.',
103
- );
104
- }
72
+ await taggingStore.dropPendingIndexes(txHashesDropped, jobId);
73
+ // The logs are queried per secret, so they only evidence this one's indexes. A receipt covers the whole tx.
74
+ await taggingStore.finalizePendingIndexesOfSecret(secret, txHashesFinalizedFromLogs, jobId);
75
+ await taggingStore.finalizePendingIndexes(txHashesFinalizedFromReceipts, jobId);
105
76
 
106
- await taggingStore.finalizePendingIndexesOfAPartiallyRevertedTx(indexedTxEffect.data, jobId);
107
- }
77
+ for (const receipt of receiptsWithExecutionReverted) {
78
+ await taggingStore.finalizePendingIndexesOfAPartiallyRevertedTx(receipt.txEffect, jobId);
108
79
  }
109
80
 
110
81
  // We check if the finalized index has been updated.
@@ -122,8 +93,7 @@ export async function syncSenderTaggingIndexes(
122
93
  // New window: [21, 22, 23]
123
94
 
124
95
  const previousEnd = end;
125
- // Add 1 because `end` is exclusive and the known finalized index is not included in the window.
126
- end = newFinalizedIndex! + UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN + 1;
96
+ end = unfinalizedTaggingIndexesWindowEnd(newFinalizedIndex);
127
97
  start = previousEnd;
128
98
  previousFinalizedIndex = newFinalizedIndex;
129
99
  } else {
@@ -0,0 +1,91 @@
1
+ import type { BlockNumber } from '@aztec/foundation/branded-types';
2
+ import type { AztecNode } from '@aztec/stdlib/interfaces/server';
3
+ import { TxHash, TxStatus } from '@aztec/stdlib/tx';
4
+
5
+ import type { PendingTx } from '../../../storage/tagging_store/sender_tagging_store.js';
6
+ import type { TxInLogs } from './load_and_store_new_tagging_indexes.js';
7
+
8
+ /** A sync window's pending txs, grouped by what the window's logs evidence about each of them. */
9
+ export type LogClassification = {
10
+ txHashesFinalized: TxHash[];
11
+ txHashesWithExecutionReverted: TxHash[];
12
+ txHashesAbsent: TxHash[];
13
+ };
14
+
15
+ /** Groups a window's pending txs by what its logs say about them. */
16
+ export function classifyPendingTxsFromLogs(
17
+ pendingTxs: PendingTx[],
18
+ txsInLogs: Map<string, TxInLogs>,
19
+ finalizedBlockNumber: BlockNumber,
20
+ ): LogClassification {
21
+ const txHashesFinalized: TxHash[] = [];
22
+ const txHashesWithExecutionReverted: TxHash[] = [];
23
+ const txHashesAbsent: TxHash[] = [];
24
+
25
+ for (const pendingTx of pendingTxs) {
26
+ const txHash = TxHash.fromString(pendingTx.txHash);
27
+ const txInLogs = txsInLogs.get(pendingTx.txHash);
28
+ if (!txInLogs) {
29
+ txHashesAbsent.push(txHash);
30
+ } else if (txInLogs.blockNumber > finalizedBlockNumber) {
31
+ // A tx in the logs is mined in the log's block, so it is finalized exactly when that block is at or below the
32
+ // finalized tip. This one is not, so it belongs to no group until the tip catches up.
33
+ } else if (txInLogs.taggingIndexes.includes(pendingTx.highestIndex)) {
34
+ txHashesFinalized.push(txHash);
35
+ } else {
36
+ // A partially reverted tx: the revert dropped the logs carrying its higher indexes.
37
+ txHashesWithExecutionReverted.push(txHash);
38
+ }
39
+ }
40
+
41
+ return { txHashesFinalized, txHashesWithExecutionReverted, txHashesAbsent };
42
+ }
43
+
44
+ /** A batch of pending txs grouped by what their receipts report about them. */
45
+ export type ReceiptClassification = {
46
+ txHashesFinalized: TxHash[];
47
+ txHashesDropped: TxHash[];
48
+ txHashesWithExecutionReverted: TxHash[];
49
+ };
50
+
51
+ /** Groups pending txs by what their receipts say, for the txs the logs could not resolve. */
52
+ export async function classifyPendingTxsFromReceipts(
53
+ pending: TxHash[],
54
+ aztecNode: AztecNode,
55
+ ): Promise<ReceiptClassification> {
56
+ const receipts = await Promise.all(pending.map(pendingTxHash => aztecNode.getTxReceipt(pendingTxHash)));
57
+
58
+ const txHashesFinalized: TxHash[] = [];
59
+ const txHashesDropped: TxHash[] = [];
60
+ const txHashesWithExecutionReverted: TxHash[] = [];
61
+
62
+ for (let i = 0; i < receipts.length; i++) {
63
+ const receipt = receipts[i];
64
+ const txHash = pending[i];
65
+
66
+ if (receipt.status === TxStatus.FINALIZED) {
67
+ // Tx has been included in a block and the corresponding block is finalized
68
+ if (receipt.hasExecutionSucceeded()) {
69
+ // No part of execution reverted - we just finalize all the indexes.
70
+ txHashesFinalized.push(txHash);
71
+ } else if (receipt.hasExecutionReverted()) {
72
+ // Tx was mined but execution reverted (app logic, teardown, or both). Some logs from the non-revertible
73
+ // phase may still be onchain. We check which tags made it onchain and finalize those; drop the rest.
74
+ txHashesWithExecutionReverted.push(txHash);
75
+ } else {
76
+ // Defensive check - this branch should never be triggered
77
+ throw new Error(
78
+ 'Both hasExecutionSucceeded and hasExecutionReverted on the receipt returned false. This should never happen and it implies a bug. Please open an issue.',
79
+ );
80
+ }
81
+ } else if (receipt.isDropped()) {
82
+ // Tx was dropped from the mempool --> we drop the corresponding pending indexes.
83
+ txHashesDropped.push(txHash);
84
+ } else {
85
+ // Tx is still pending, not yet finalized, or was mined successfully but not yet finalized --> we don't do
86
+ // anything.
87
+ }
88
+ }
89
+
90
+ return { txHashesFinalized, txHashesDropped, txHashesWithExecutionReverted };
91
+ }
@@ -1,13 +1,15 @@
1
- import type { BlockHash } from '@aztec/stdlib/block';
1
+ import type { BlockNumber } from '@aztec/foundation/branded-types';
2
2
  import type { AztecNode } from '@aztec/stdlib/interfaces/server';
3
- import { type AppTaggingSecret, SiloedTag } from '@aztec/stdlib/logs';
3
+ import { type AppTaggingSecret, type LogResult, SiloedTag } from '@aztec/stdlib/logs';
4
4
  import { TxHash } from '@aztec/stdlib/tx';
5
5
 
6
6
  import type { SenderTaggingStore } from '../../../storage/tagging_store/sender_tagging_store.js';
7
- import { getAllPrivateLogsByTags } from '../../get_all_logs_by_tags.js';
7
+ import { type LogQueryAnchor, getAllPrivateLogsByTags } from '../../get_all_logs_by_tags.js';
8
8
 
9
9
  /**
10
- * Loads tagging indexes from the Aztec node and stores them in the tagging data provider.
10
+ * Loads tagging indexes from the Aztec node and stores them in the tagging data provider. Returns the txs the
11
+ * window's logs carried, keyed by tx hash string, with the block each was mined in and the window indexes it used,
12
+ * so the caller can classify their finalization status without further node queries.
11
13
  * @remarks This function is one of two places by which a pending index can get to the tagging data provider. The other
12
14
  * place is when a tx is being sent from this PXE.
13
15
  * @param extendedSecret - The app tagging secret whose indexes are being synced.
@@ -15,7 +17,7 @@ import { getAllPrivateLogsByTags } from '../../get_all_logs_by_tags.js';
15
17
  * @param end - The ending index (exclusive) of the window to process.
16
18
  * @param aztecNode - The Aztec node instance to query for logs.
17
19
  * @param taggingStore - The data provider to store pending indexes.
18
- * @param anchorBlockHash - Hash of a block to use as reference block when querying node.
20
+ * @param anchor - Block the log query is anchored to.
19
21
  * @param jobId - Job identifier, used to keep writes in-memory until they can be persisted in a data integrity
20
22
  * preserving way.
21
23
  */
@@ -25,60 +27,64 @@ export async function loadAndStoreNewTaggingIndexes(
25
27
  end: number,
26
28
  aztecNode: AztecNode,
27
29
  taggingStore: SenderTaggingStore,
28
- anchorBlockHash: BlockHash,
30
+ anchor: LogQueryAnchor,
29
31
  jobId: string,
30
- ) {
32
+ ): Promise<Map<string, TxInLogs>> {
31
33
  // We compute the tags for the current window of indexes
32
34
  const siloedTagsForWindow = await Promise.all(
33
35
  Array.from({ length: end - start }, (_, i) => SiloedTag.compute({ extendedSecret, index: start + i })),
34
36
  );
35
37
 
36
- const txsForTags = await getTxsContainingTags(siloedTagsForWindow, aztecNode, anchorBlockHash);
37
- const txIndexesMap = getTxIndexesMap(txsForTags, start, siloedTagsForWindow.length);
38
+ const allLogs = await getAllPrivateLogsByTags(aztecNode, siloedTagsForWindow, anchor);
39
+ if (allLogs.length !== siloedTagsForWindow.length) {
40
+ throw new Error(
41
+ `Number of log arrays does not match number of tags. ${allLogs.length} !== ${siloedTagsForWindow.length}`,
42
+ );
43
+ }
44
+
45
+ const txsInLogs = getTxsInLogs(allLogs, start);
38
46
 
39
- // Now we iterate over the map, construct the tagging index ranges and store them in the db.
40
- for (const [txHashStr, indexes] of txIndexesMap.entries()) {
47
+ // Now we iterate over the map, construct the tagging index ranges and store them in the db. A tx already tracked
48
+ // in the store is merged rather than range-checked: if this PXE sent the tx and it partially reverted, the chain
49
+ // only shows the surviving sub-range of the prove-time entry (the finalized receipt step of the sync owns
50
+ // resolving that difference), and a tx from another PXE may straddle a sync window boundary, in which case the
51
+ // entry is widened so the next index choice covers the full onchain range.
52
+ for (const [txHashStr, { taggingIndexes }] of txsInLogs.entries()) {
41
53
  const txHash = TxHash.fromString(txHashStr);
42
- const ranges = [{ extendedSecret, lowestIndex: Math.min(...indexes), highestIndex: Math.max(...indexes) }];
43
- await taggingStore.storePendingIndexes(ranges, txHash, jobId);
54
+ const ranges = [
55
+ { extendedSecret, lowestIndex: Math.min(...taggingIndexes), highestIndex: Math.max(...taggingIndexes) },
56
+ ];
57
+ await taggingStore.mergePendingIndexes(ranges, txHash, jobId);
44
58
  }
45
- }
46
59
 
47
- // Returns txs that used the given tags. A tag might have been used in multiple txs and for this reason we return
48
- // an array for each tag.
49
- async function getTxsContainingTags(
50
- tags: SiloedTag[],
51
- aztecNode: AztecNode,
52
- anchorBlockHash: BlockHash,
53
- ): Promise<TxHash[][]> {
54
- // We use the utility function below to retrieve all logs for the tags across all pages, so we don't need to handle
55
- // pagination here. Sender sync only needs `txHash` from each log, so we leave `includeEffects` off.
56
- const allLogs = await getAllPrivateLogsByTags(aztecNode, tags, anchorBlockHash);
57
- return allLogs.map(logs => logs.map(log => log.txHash));
60
+ return txsInLogs;
58
61
  }
59
62
 
60
- // Returns a map of txHash to all indexes for that txHash.
61
- function getTxIndexesMap(txHashesForTags: TxHash[][], start: number, count: number): Map<string, number[]> {
62
- if (txHashesForTags.length !== count) {
63
- throw new Error(`Number of tx hashes arrays does not match number of tags. ${txHashesForTags.length} !== ${count}`);
64
- }
63
+ /** A tx that a sync window's logs carried. */
64
+ export type TxInLogs = {
65
+ /** The block the tx was mined in, which decides whether it is finalized. */
66
+ blockNumber: BlockNumber;
67
+ /** The window's tagging indexes whose siloed tags this tx's logs carried. */
68
+ taggingIndexes: number[];
69
+ };
65
70
 
66
- const indexesMap = new Map<string, number[]>();
71
+ // Returns a map of txHash to the block it was mined in and all window indexes used by it.
72
+ function getTxsInLogs(logsForTags: LogResult[][], start: number): Map<string, TxInLogs> {
73
+ const txsInLogs = new Map<string, TxInLogs>();
67
74
  // Iterate over indexes
68
- for (let i = 0; i < txHashesForTags.length; i++) {
75
+ for (let i = 0; i < logsForTags.length; i++) {
69
76
  const taggingIndex = start + i;
70
- const txHashesForTag = txHashesForTags[i];
71
- // iterate over tx hashes that used that index (tag)
72
- for (const txHash of txHashesForTag) {
73
- const key = txHash.toString();
74
- const existing = indexesMap.get(key);
77
+ // iterate over logs that used that index (tag)
78
+ for (const log of logsForTags[i]) {
79
+ const key = log.txHash.toString();
80
+ const existing = txsInLogs.get(key);
75
81
  // Add the index to the tx's indexes
76
82
  if (existing) {
77
- existing.push(taggingIndex);
83
+ existing.taggingIndexes.push(taggingIndex);
78
84
  } else {
79
- indexesMap.set(key, [taggingIndex]);
85
+ txsInLogs.set(key, { blockNumber: log.blockNumber, taggingIndexes: [taggingIndex] });
80
86
  }
81
87
  }
82
88
  }
83
- return indexesMap;
89
+ return txsInLogs;
84
90
  }
@@ -0,0 +1,64 @@
1
+ import type { BlockNumber } from '@aztec/foundation/branded-types';
2
+ import type { AztecNode } from '@aztec/stdlib/interfaces/server';
3
+ import { type MinedTxReceipt, type TxHash, type TxReceipt, TxStatus } from '@aztec/stdlib/tx';
4
+
5
+ import type { PendingTx } from '../../../storage/tagging_store/sender_tagging_store.js';
6
+ import { classifyPendingTxsFromLogs, classifyPendingTxsFromReceipts } from './classify_pending_txs.js';
7
+ import type { TxInLogs } from './load_and_store_new_tagging_indexes.js';
8
+
9
+ /** What a window's node reads established about each of its pending txs. */
10
+ export type ResolvedPendingTxs = {
11
+ txHashesFinalizedFromLogs: TxHash[];
12
+ txHashesFinalizedFromReceipts: TxHash[];
13
+ txHashesDropped: TxHash[];
14
+ /** Both sources land here: the logs when a surviving tag fell inside the window, a receipt otherwise. */
15
+ receiptsWithExecutionReverted: MinedTxReceipt<{ includeTxEffect: true }>[];
16
+ };
17
+
18
+ /**
19
+ * Resolves a window's pending txs. All of the window's node reads happen here.
20
+ *
21
+ * The logs it is handed settle most txs on their own, as {@link classifyPendingTxsFromLogs} explains. Two groups are
22
+ * left over, and share one further round trip:
23
+ *
24
+ * - txs absent from the logs, whose receipt is what tells whether they are still in the mempool, dropped, or reverted;
25
+ * - txs the logs show as reverted, which only their tx effect resolves.
26
+ *
27
+ * A third round trip is paid only when those receipts reveal a reverted tx, since its effect cannot be requested
28
+ * before its status says it reverted.
29
+ */
30
+ export async function resolvePendingTxs(
31
+ pendingTxs: PendingTx[],
32
+ txsInLogs: Map<string, TxInLogs>,
33
+ finalizedBlockNumber: BlockNumber,
34
+ aztecNode: AztecNode,
35
+ ): Promise<ResolvedPendingTxs> {
36
+ const statusFromLogs = classifyPendingTxsFromLogs(pendingTxs, txsInLogs, finalizedBlockNumber);
37
+
38
+ const [statusOfAbsent, receiptsOfRevertedInLogs] = await Promise.all([
39
+ classifyPendingTxsFromReceipts(statusFromLogs.txHashesAbsent, aztecNode),
40
+ getReceiptsWithEffect(statusFromLogs.txHashesWithExecutionReverted, aztecNode),
41
+ ]);
42
+
43
+ const receiptsOfRevertedAbsent = await getReceiptsWithEffect(statusOfAbsent.txHashesWithExecutionReverted, aztecNode);
44
+
45
+ return {
46
+ txHashesFinalizedFromLogs: statusFromLogs.txHashesFinalized,
47
+ txHashesFinalizedFromReceipts: statusOfAbsent.txHashesFinalized,
48
+ txHashesDropped: statusOfAbsent.txHashesDropped,
49
+ // Both groups were judged finalized before this fetch, the first off our own tip and the second off an earlier
50
+ // receipt, so both are confirmed against what the node says now. Finalizing off a reorgeable block would burn
51
+ // the indexes.
52
+ receiptsWithExecutionReverted: [...receiptsOfRevertedInLogs, ...receiptsOfRevertedAbsent].filter(isFinalized),
53
+ };
54
+ }
55
+
56
+ function getReceiptsWithEffect(txHashes: TxHash[], aztecNode: AztecNode) {
57
+ return Promise.all(txHashes.map(txHash => aztecNode.getTxReceipt(txHash, { includeTxEffect: true })));
58
+ }
59
+
60
+ function isFinalized(
61
+ receipt: TxReceipt<{ includeTxEffect: true }>,
62
+ ): receipt is MinedTxReceipt<{ includeTxEffect: true }> {
63
+ return receipt.status === TxStatus.FINALIZED;
64
+ }
@@ -0,0 +1,46 @@
1
+ import { BlockNumber, EpochNumber, SlotNumber } from '@aztec/foundation/branded-types';
2
+ import { BlockHash } from '@aztec/stdlib/block';
3
+ import type { MinedTxStatus, TxEffect, TxHash } from '@aztec/stdlib/tx';
4
+ import { MinedTxReceipt, TxExecutionResult } from '@aztec/stdlib/tx';
5
+
6
+ import type { PendingTx } from '../../../storage/tagging_store/sender_tagging_store.js';
7
+ import type { TxInLogs } from './load_and_store_new_tagging_indexes.js';
8
+
9
+ /** A tx the store holds as pending, tracked up to the given index. */
10
+ export function pendingTx(txHash: TxHash, highestIndex: number): PendingTx {
11
+ return { txHash: txHash.toString(), highestIndex };
12
+ }
13
+
14
+ /** One tx as a window's logs show it: the block it was mined in and the tagging indexes its logs carried. */
15
+ export function minedIn(blockNumber: number, taggingIndexes: number[]): TxInLogs {
16
+ return { blockNumber: BlockNumber(blockNumber), taggingIndexes };
17
+ }
18
+
19
+ /** Builds the tx-hash-keyed map a window's logs would produce. */
20
+ export function txsInLogs(...entries: [TxHash, TxInLogs][]): Map<string, TxInLogs> {
21
+ return new Map(entries.map(([txHash, txInLogs]) => [txHash.toString(), txInLogs]));
22
+ }
23
+
24
+ /** The receipt of a mined tx, successful and without a tx effect unless stated otherwise. */
25
+ export function minedReceipt(
26
+ txHash: TxHash,
27
+ status: MinedTxStatus,
28
+ blockNumber: number,
29
+ {
30
+ executionResult = TxExecutionResult.SUCCESS,
31
+ txEffect,
32
+ }: { executionResult?: TxExecutionResult; txEffect?: TxEffect } = {},
33
+ ): MinedTxReceipt {
34
+ return new MinedTxReceipt(
35
+ txHash,
36
+ status,
37
+ executionResult,
38
+ 1n,
39
+ BlockHash.random(),
40
+ BlockNumber(blockNumber),
41
+ SlotNumber(Number(blockNumber)),
42
+ 0,
43
+ EpochNumber(1),
44
+ txEffect,
45
+ );
46
+ }
@@ -0,0 +1,11 @@
1
+ import { type AppTaggingSecret, type PrivateLogsQuery, SiloedTag, type TagQuery } from '@aztec/stdlib/logs';
2
+
3
+ /** Computes the siloed tag */
4
+ export function computeSiloedTagForIndex(secret: AppTaggingSecret, index: number): Promise<SiloedTag> {
5
+ return SiloedTag.compute({ extendedSecret: secret, index });
6
+ }
7
+
8
+ /** Extracts the bare-tag set from a query */
9
+ export function extractTags(query: PrivateLogsQuery): SiloedTag[] {
10
+ return query.tags.map((entry: TagQuery<SiloedTag>) => (entry instanceof SiloedTag ? entry : entry.tag));
11
+ }
@@ -1,9 +0,0 @@
1
- import type { AztecNode } from '@aztec/stdlib/interfaces/client';
2
- import type { NodeStats } from '@aztec/stdlib/tx';
3
- export type BenchmarkedNode = AztecNode & {
4
- getStats(): NodeStats;
5
- };
6
- export declare class BenchmarkedNodeFactory {
7
- static create(node: AztecNode): BenchmarkedNode;
8
- }
9
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYmVuY2htYXJrZWRfbm9kZS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2NvbnRyYWN0X2Z1bmN0aW9uX3NpbXVsYXRvci9iZW5jaG1hcmtlZF9ub2RlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUNBLE9BQU8sS0FBSyxFQUFFLFNBQVMsRUFBRSxNQUFNLGlDQUFpQyxDQUFDO0FBQ2pFLE9BQU8sS0FBSyxFQUFFLFNBQVMsRUFBa0IsTUFBTSxrQkFBa0IsQ0FBQztBQWlCbEUsTUFBTSxNQUFNLGVBQWUsR0FBRyxTQUFTLEdBQUc7SUFBRSxRQUFRLElBQUksU0FBUyxDQUFBO0NBQUUsQ0FBQztBQUVwRSxxQkFBYSxzQkFBc0I7SUFDakMsTUFBTSxDQUFDLE1BQU0sQ0FBQyxJQUFJLEVBQUUsU0FBUyxHQUFHLGVBQWUsQ0ErRTlDO0NBQ0YifQ==
@@ -1 +0,0 @@
1
- {"version":3,"file":"benchmarked_node.d.ts","sourceRoot":"","sources":["../../src/contract_function_simulator/benchmarked_node.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,kBAAkB,CAAC;AAiBlE,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG;IAAE,QAAQ,IAAI,SAAS,CAAA;CAAE,CAAC;AAEpE,qBAAa,sBAAsB;IACjC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,GAAG,eAAe,CA+E9C;CACF"}
@@ -1,77 +0,0 @@
1
- import { Timer } from '@aztec/foundation/timer';
2
- export class BenchmarkedNodeFactory {
3
- static create(node) {
4
- // Per-method call stats
5
- const perMethod = {};
6
- // Round trip tracking
7
- let inFlightCount = 0;
8
- let currentRoundTripTimer = null;
9
- let currentRoundTripMethods = [];
10
- const roundTrips = {
11
- roundTrips: 0,
12
- totalBlockingTime: 0,
13
- roundTripDurations: [],
14
- roundTripMethods: []
15
- };
16
- return new Proxy(node, {
17
- get (target, prop) {
18
- if (prop === 'getStats') {
19
- return ()=>{
20
- return {
21
- perMethod,
22
- roundTrips
23
- };
24
- };
25
- } else {
26
- return function(...args) {
27
- // Track per-method stats
28
- if (!perMethod[prop]) {
29
- perMethod[prop] = {
30
- times: []
31
- };
32
- }
33
- // Start of a new round trip batch?
34
- if (inFlightCount === 0) {
35
- roundTrips.roundTrips++;
36
- currentRoundTripTimer = new Timer();
37
- currentRoundTripMethods = [];
38
- }
39
- inFlightCount++;
40
- currentRoundTripMethods.push(prop);
41
- const callTimer = new Timer();
42
- const result = target[prop].apply(target, args);
43
- // Handle completion - called when the call finishes (after Promise resolves)
44
- const handleCompletion = ()=>{
45
- const callTime = callTimer.ms();
46
- perMethod[prop].times.push(callTime);
47
- inFlightCount--;
48
- // End of round trip batch - all concurrent calls completed
49
- if (inFlightCount === 0 && currentRoundTripTimer) {
50
- const roundTripTime = currentRoundTripTimer.ms();
51
- roundTrips.totalBlockingTime += roundTripTime;
52
- roundTrips.roundTripDurations.push(roundTripTime);
53
- roundTrips.roundTripMethods.push(currentRoundTripMethods);
54
- currentRoundTripTimer = null;
55
- currentRoundTripMethods = [];
56
- }
57
- };
58
- // If the result is a Promise, chain the completion handler
59
- if (result && typeof result.then === 'function') {
60
- return result.then((value)=>{
61
- handleCompletion();
62
- return value;
63
- }, (error)=>{
64
- handleCompletion();
65
- throw error;
66
- });
67
- } else {
68
- // Synchronous method - handle completion immediately
69
- handleCompletion();
70
- return result;
71
- }
72
- };
73
- }
74
- }
75
- });
76
- }
77
- }