@aztec/pxe 0.0.1-commit.c2eed6949 → 0.0.1-commit.c52d6e7

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 (541) hide show
  1. package/dest/bin/check_oracle_version.js +11 -118
  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 +20 -0
  6. package/dest/bin/oracle_version_helpers.d.ts.map +1 -0
  7. package/dest/bin/oracle_version_helpers.js +25 -0
  8. package/dest/block_synchronizer/block_stream_source.d.ts +10 -0
  9. package/dest/block_synchronizer/block_stream_source.d.ts.map +1 -0
  10. package/dest/block_synchronizer/block_stream_source.js +37 -0
  11. package/dest/block_synchronizer/block_synchronizer.d.ts +22 -16
  12. package/dest/block_synchronizer/block_synchronizer.d.ts.map +1 -1
  13. package/dest/block_synchronizer/block_synchronizer.js +71 -28
  14. package/dest/config/index.d.ts +8 -1
  15. package/dest/config/index.d.ts.map +1 -1
  16. package/dest/config/index.js +13 -14
  17. package/dest/config/package_info.js +1 -1
  18. package/dest/contract/contract_class_service.d.ts +24 -0
  19. package/dest/contract/contract_class_service.d.ts.map +1 -0
  20. package/dest/contract/contract_class_service.js +36 -0
  21. package/dest/contract/contract_sync_service.d.ts +48 -0
  22. package/dest/contract/contract_sync_service.d.ts.map +1 -0
  23. package/dest/contract/contract_sync_service.js +116 -0
  24. package/dest/contract/helpers.d.ts +7 -0
  25. package/dest/contract/helpers.d.ts.map +1 -0
  26. package/dest/contract/helpers.js +20 -0
  27. package/dest/contract/skip_sync_contracts.d.ts +11 -0
  28. package/dest/contract/skip_sync_contracts.d.ts.map +1 -0
  29. package/dest/contract/skip_sync_contracts.js +18 -0
  30. package/dest/contract_function_simulator/anchored_contract_data.d.ts +36 -0
  31. package/dest/contract_function_simulator/anchored_contract_data.d.ts.map +1 -0
  32. package/dest/contract_function_simulator/anchored_contract_data.js +54 -0
  33. package/dest/contract_function_simulator/contract_function_simulator.d.ts +27 -28
  34. package/dest/contract_function_simulator/contract_function_simulator.d.ts.map +1 -1
  35. package/dest/contract_function_simulator/contract_function_simulator.js +86 -59
  36. package/dest/contract_function_simulator/ephemeral_array_service.d.ts +28 -0
  37. package/dest/contract_function_simulator/ephemeral_array_service.d.ts.map +1 -0
  38. package/dest/contract_function_simulator/ephemeral_array_service.js +78 -0
  39. package/dest/contract_function_simulator/execution_note_cache.d.ts +4 -10
  40. package/dest/contract_function_simulator/execution_note_cache.d.ts.map +1 -1
  41. package/dest/contract_function_simulator/execution_note_cache.js +8 -28
  42. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts +5 -9
  43. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts.map +1 -1
  44. package/dest/contract_function_simulator/execution_tagging_index_cache.js +3 -7
  45. package/dest/contract_function_simulator/index.d.ts +26 -6
  46. package/dest/contract_function_simulator/index.d.ts.map +1 -1
  47. package/dest/contract_function_simulator/index.js +11 -4
  48. package/dest/contract_function_simulator/noir-structs/bounded_vec.d.ts +29 -0
  49. package/dest/contract_function_simulator/noir-structs/bounded_vec.d.ts.map +1 -0
  50. package/dest/contract_function_simulator/noir-structs/bounded_vec.js +30 -0
  51. package/dest/contract_function_simulator/noir-structs/contract_class_log_data.d.ts +9 -0
  52. package/dest/contract_function_simulator/noir-structs/contract_class_log_data.d.ts.map +1 -0
  53. package/dest/contract_function_simulator/noir-structs/contract_class_log_data.js +1 -0
  54. package/dest/contract_function_simulator/noir-structs/embedded_curve_point.d.ts +7 -0
  55. package/dest/contract_function_simulator/noir-structs/embedded_curve_point.d.ts.map +1 -0
  56. package/dest/contract_function_simulator/noir-structs/embedded_curve_point.js +1 -0
  57. package/dest/contract_function_simulator/noir-structs/ephemeral_array.d.ts +37 -0
  58. package/dest/contract_function_simulator/noir-structs/ephemeral_array.d.ts.map +1 -0
  59. package/dest/contract_function_simulator/noir-structs/ephemeral_array.js +59 -0
  60. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts +5 -5
  61. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts.map +1 -1
  62. package/dest/contract_function_simulator/noir-structs/event_validation_request.js +7 -9
  63. package/dest/contract_function_simulator/noir-structs/fact.d.ts +16 -0
  64. package/dest/contract_function_simulator/noir-structs/fact.d.ts.map +1 -0
  65. package/dest/contract_function_simulator/noir-structs/fact.js +6 -0
  66. package/dest/contract_function_simulator/noir-structs/fact_collection.d.ts +27 -0
  67. package/dest/contract_function_simulator/noir-structs/fact_collection.d.ts.map +1 -0
  68. package/dest/contract_function_simulator/noir-structs/fact_collection.js +31 -0
  69. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.d.ts +19 -10
  70. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.d.ts.map +1 -1
  71. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.js +12 -24
  72. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts +11 -9
  73. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts.map +1 -1
  74. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.js +2 -61
  75. package/dest/contract_function_simulator/noir-structs/note_data.d.ts +27 -0
  76. package/dest/contract_function_simulator/noir-structs/note_data.d.ts.map +1 -0
  77. package/dest/contract_function_simulator/noir-structs/note_data.js +3 -0
  78. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts +5 -5
  79. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts.map +1 -1
  80. package/dest/contract_function_simulator/noir-structs/note_validation_request.js +8 -10
  81. package/dest/contract_function_simulator/noir-structs/option.d.ts +59 -0
  82. package/dest/contract_function_simulator/noir-structs/option.d.ts.map +1 -0
  83. package/dest/contract_function_simulator/noir-structs/option.js +67 -0
  84. package/dest/contract_function_simulator/noir-structs/origin_block.d.ts +11 -0
  85. package/dest/contract_function_simulator/noir-structs/origin_block.d.ts.map +1 -0
  86. package/dest/contract_function_simulator/noir-structs/origin_block.js +5 -0
  87. package/dest/contract_function_simulator/noir-structs/pending_tagged_log.d.ts +11 -0
  88. package/dest/contract_function_simulator/noir-structs/pending_tagged_log.d.ts.map +1 -0
  89. package/dest/contract_function_simulator/noir-structs/pending_tagged_log.js +4 -0
  90. package/dest/contract_function_simulator/noir-structs/provided_secret.d.ts +8 -0
  91. package/dest/contract_function_simulator/noir-structs/provided_secret.d.ts.map +1 -0
  92. package/dest/contract_function_simulator/noir-structs/provided_secret.js +1 -0
  93. package/dest/contract_function_simulator/noir-structs/resolved_tagging_strategy.d.ts +28 -0
  94. package/dest/contract_function_simulator/noir-structs/resolved_tagging_strategy.d.ts.map +1 -0
  95. package/dest/contract_function_simulator/noir-structs/resolved_tagging_strategy.js +50 -0
  96. package/dest/contract_function_simulator/noir-structs/resolved_tx.d.ts +19 -0
  97. package/dest/contract_function_simulator/noir-structs/resolved_tx.d.ts.map +1 -0
  98. package/dest/contract_function_simulator/noir-structs/resolved_tx.js +9 -0
  99. package/dest/contract_function_simulator/noir-structs/tx_effect_data.d.ts +15 -0
  100. package/dest/contract_function_simulator/noir-structs/tx_effect_data.d.ts.map +1 -0
  101. package/dest/contract_function_simulator/noir-structs/tx_effect_data.js +5 -0
  102. package/dest/contract_function_simulator/noir-structs/utility_context.d.ts +6 -11
  103. package/dest/contract_function_simulator/noir-structs/utility_context.d.ts.map +1 -1
  104. package/dest/contract_function_simulator/noir-structs/utility_context.js +1 -20
  105. package/dest/contract_function_simulator/oracle/acir_callback.d.ts +21 -0
  106. package/dest/contract_function_simulator/oracle/acir_callback.d.ts.map +1 -0
  107. package/dest/contract_function_simulator/oracle/acir_callback.js +115 -0
  108. package/dest/contract_function_simulator/oracle/index.d.ts +2 -13
  109. package/dest/contract_function_simulator/oracle/index.d.ts.map +1 -1
  110. package/dest/contract_function_simulator/oracle/index.js +1 -1
  111. package/dest/contract_function_simulator/oracle/interfaces.d.ts +15 -103
  112. package/dest/contract_function_simulator/oracle/interfaces.d.ts.map +1 -1
  113. package/dest/contract_function_simulator/oracle/interfaces.js +2 -2
  114. package/dest/contract_function_simulator/oracle/legacy_oracle_registry.d.ts +39 -0
  115. package/dest/contract_function_simulator/oracle/legacy_oracle_registry.d.ts.map +1 -0
  116. package/dest/contract_function_simulator/oracle/legacy_oracle_registry.js +107 -0
  117. package/dest/contract_function_simulator/oracle/message_load_oracle_inputs.d.ts +3 -14
  118. package/dest/contract_function_simulator/oracle/message_load_oracle_inputs.d.ts.map +1 -1
  119. package/dest/contract_function_simulator/oracle/message_load_oracle_inputs.js +1 -24
  120. package/dest/contract_function_simulator/oracle/note_packing_utils.d.ts +2 -2
  121. package/dest/contract_function_simulator/oracle/note_packing_utils.d.ts.map +1 -1
  122. package/dest/contract_function_simulator/oracle/note_packing_utils.js +2 -2
  123. package/dest/contract_function_simulator/oracle/oracle_registry.d.ts +139 -0
  124. package/dest/contract_function_simulator/oracle/oracle_registry.d.ts.map +1 -0
  125. package/dest/contract_function_simulator/oracle/oracle_registry.js +1016 -0
  126. package/dest/contract_function_simulator/oracle/oracle_type_mappings.d.ts +274 -0
  127. package/dest/contract_function_simulator/oracle/oracle_type_mappings.d.ts.map +1 -0
  128. package/dest/contract_function_simulator/oracle/oracle_type_mappings.js +1253 -0
  129. package/dest/contract_function_simulator/oracle/private_execution.d.ts +1 -1
  130. package/dest/contract_function_simulator/oracle/private_execution.d.ts.map +1 -1
  131. package/dest/contract_function_simulator/oracle/private_execution.js +3 -4
  132. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts +52 -42
  133. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts.map +1 -1
  134. package/dest/contract_function_simulator/oracle/private_execution_oracle.js +197 -65
  135. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts +164 -77
  136. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts.map +1 -1
  137. package/dest/contract_function_simulator/oracle/utility_execution_oracle.js +607 -193
  138. package/dest/contract_function_simulator/pick_notes.d.ts +1 -1
  139. package/dest/contract_function_simulator/pick_notes.d.ts.map +1 -1
  140. package/dest/contract_function_simulator/pick_notes.js +20 -3
  141. package/dest/contract_function_simulator/transient_array_service.d.ts +31 -0
  142. package/dest/contract_function_simulator/transient_array_service.d.ts.map +1 -0
  143. package/dest/contract_function_simulator/transient_array_service.js +62 -0
  144. package/dest/contract_logging.d.ts +9 -4
  145. package/dest/contract_logging.d.ts.map +1 -1
  146. package/dest/contract_logging.js +21 -6
  147. package/dest/debug/pxe_debug_utils.d.ts +4 -9
  148. package/dest/debug/pxe_debug_utils.d.ts.map +1 -1
  149. package/dest/debug/pxe_debug_utils.js +0 -6
  150. package/dest/entrypoints/client/bundle/index.d.ts +2 -2
  151. package/dest/entrypoints/client/bundle/index.d.ts.map +1 -1
  152. package/dest/entrypoints/client/bundle/index.js +1 -1
  153. package/dest/entrypoints/client/bundle/utils.d.ts +2 -2
  154. package/dest/entrypoints/client/bundle/utils.d.ts.map +1 -1
  155. package/dest/entrypoints/client/bundle/utils.js +27 -8
  156. package/dest/entrypoints/client/lazy/index.d.ts +2 -2
  157. package/dest/entrypoints/client/lazy/index.d.ts.map +1 -1
  158. package/dest/entrypoints/client/lazy/index.js +1 -1
  159. package/dest/entrypoints/client/lazy/utils.d.ts +2 -2
  160. package/dest/entrypoints/client/lazy/utils.d.ts.map +1 -1
  161. package/dest/entrypoints/client/lazy/utils.js +27 -8
  162. package/dest/entrypoints/client/store.d.ts +14 -0
  163. package/dest/entrypoints/client/store.d.ts.map +1 -0
  164. package/dest/entrypoints/client/store.js +42 -0
  165. package/dest/entrypoints/pxe_creation_options.d.ts +16 -2
  166. package/dest/entrypoints/pxe_creation_options.d.ts.map +1 -1
  167. package/dest/entrypoints/pxe_creation_options.js +3 -1
  168. package/dest/entrypoints/server/index.d.ts +7 -4
  169. package/dest/entrypoints/server/index.d.ts.map +1 -1
  170. package/dest/entrypoints/server/index.js +5 -3
  171. package/dest/entrypoints/server/store.d.ts +18 -0
  172. package/dest/entrypoints/server/store.d.ts.map +1 -0
  173. package/dest/entrypoints/server/store.js +28 -0
  174. package/dest/entrypoints/server/utils.d.ts +4 -3
  175. package/dest/entrypoints/server/utils.d.ts.map +1 -1
  176. package/dest/entrypoints/server/utils.js +28 -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 +13 -11
  180. package/dest/events/event_service.d.ts +21 -5
  181. package/dest/events/event_service.d.ts.map +1 -1
  182. package/dest/events/event_service.js +50 -17
  183. package/dest/events/private_event_filter_validator.d.ts +3 -2
  184. package/dest/events/private_event_filter_validator.d.ts.map +1 -1
  185. package/dest/events/private_event_filter_validator.js +15 -0
  186. package/dest/hooks/authorize_utility_call.d.ts +41 -0
  187. package/dest/hooks/authorize_utility_call.d.ts.map +1 -0
  188. package/dest/hooks/authorize_utility_call.js +4 -0
  189. package/dest/hooks/execution_hooks.d.ts +62 -0
  190. package/dest/hooks/execution_hooks.d.ts.map +1 -0
  191. package/dest/hooks/execution_hooks.js +9 -0
  192. package/dest/hooks/index.d.ts +5 -0
  193. package/dest/hooks/index.d.ts.map +1 -0
  194. package/dest/hooks/index.js +2 -0
  195. package/dest/hooks/resolve_custom_request.d.ts +23 -0
  196. package/dest/hooks/resolve_custom_request.d.ts.map +1 -0
  197. package/dest/hooks/resolve_custom_request.js +3 -0
  198. package/dest/hooks/resolve_tagging_secret_strategy.d.ts +50 -0
  199. package/dest/hooks/resolve_tagging_secret_strategy.d.ts.map +1 -0
  200. package/dest/hooks/resolve_tagging_secret_strategy.js +3 -0
  201. package/dest/logs/log_service.d.ts +21 -11
  202. package/dest/logs/log_service.d.ts.map +1 -1
  203. package/dest/logs/log_service.js +180 -82
  204. package/dest/messages/tx_resolver_service.d.ts +28 -0
  205. package/dest/messages/tx_resolver_service.d.ts.map +1 -0
  206. package/dest/messages/tx_resolver_service.js +61 -0
  207. package/dest/node/benchmarked_node.d.ts +20 -0
  208. package/dest/node/benchmarked_node.d.ts.map +1 -0
  209. package/dest/node/benchmarked_node.js +94 -0
  210. package/dest/node/caching_aztec_node.d.ts +24 -0
  211. package/dest/node/caching_aztec_node.d.ts.map +1 -0
  212. package/dest/node/caching_aztec_node.js +267 -0
  213. package/dest/notes/note_service.d.ts +34 -7
  214. package/dest/notes/note_service.d.ts.map +1 -1
  215. package/dest/notes/note_service.js +81 -57
  216. package/dest/notes_filter.d.ts +2 -3
  217. package/dest/notes_filter.d.ts.map +1 -1
  218. package/dest/oracle_version.d.ts +4 -3
  219. package/dest/oracle_version.d.ts.map +1 -1
  220. package/dest/oracle_version.js +20 -10
  221. package/dest/private_kernel/batch_planner.d.ts +47 -0
  222. package/dest/private_kernel/batch_planner.d.ts.map +1 -0
  223. package/dest/private_kernel/batch_planner.js +104 -0
  224. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts +1 -1
  225. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts.map +1 -1
  226. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.js +7 -3
  227. package/dest/private_kernel/hints/test_utils.d.ts +1 -1
  228. package/dest/private_kernel/hints/test_utils.d.ts.map +1 -1
  229. package/dest/private_kernel/hints/test_utils.js +3 -4
  230. package/dest/private_kernel/private_kernel_execution_prover.d.ts +6 -2
  231. package/dest/private_kernel/private_kernel_execution_prover.d.ts.map +1 -1
  232. package/dest/private_kernel/private_kernel_execution_prover.js +203 -89
  233. package/dest/private_kernel/private_kernel_oracle.d.ts +12 -10
  234. package/dest/private_kernel/private_kernel_oracle.d.ts.map +1 -1
  235. package/dest/private_kernel/private_kernel_oracle.js +40 -26
  236. package/dest/pxe.d.ts +167 -55
  237. package/dest/pxe.d.ts.map +1 -1
  238. package/dest/pxe.js +366 -216
  239. package/dest/storage/allowed_scopes.d.ts +6 -0
  240. package/dest/storage/allowed_scopes.d.ts.map +1 -0
  241. package/dest/storage/allowed_scopes.js +7 -0
  242. package/dest/storage/anchor_block_store/anchor_block_store.d.ts +9 -6
  243. package/dest/storage/anchor_block_store/anchor_block_store.d.ts.map +1 -1
  244. package/dest/storage/anchor_block_store/anchor_block_store.js +9 -7
  245. package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.d.ts +42 -0
  246. package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.d.ts.map +1 -0
  247. package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.js +93 -0
  248. package/dest/storage/backwards_compatibility_tests/schema_tests.d.ts +15 -0
  249. package/dest/storage/backwards_compatibility_tests/schema_tests.d.ts.map +1 -0
  250. package/dest/storage/backwards_compatibility_tests/schema_tests.js +671 -0
  251. package/dest/storage/backwards_compatibility_tests/store_spy.d.ts +19 -0
  252. package/dest/storage/backwards_compatibility_tests/store_spy.d.ts.map +1 -0
  253. package/dest/storage/backwards_compatibility_tests/store_spy.js +63 -0
  254. package/dest/storage/capsule_store/capsule_service.d.ts +21 -0
  255. package/dest/storage/capsule_store/capsule_service.d.ts.map +1 -0
  256. package/dest/storage/capsule_store/capsule_service.js +47 -0
  257. package/dest/storage/capsule_store/capsule_store.d.ts +9 -9
  258. package/dest/storage/capsule_store/capsule_store.d.ts.map +1 -1
  259. package/dest/storage/capsule_store/capsule_store.js +36 -28
  260. package/dest/storage/capsule_store/index.d.ts +2 -1
  261. package/dest/storage/capsule_store/index.d.ts.map +1 -1
  262. package/dest/storage/capsule_store/index.js +1 -0
  263. package/dest/storage/contract_store/contract_store.d.ts +27 -24
  264. package/dest/storage/contract_store/contract_store.d.ts.map +1 -1
  265. package/dest/storage/contract_store/contract_store.js +71 -99
  266. package/dest/storage/fact_store/fact_service.d.ts +22 -0
  267. package/dest/storage/fact_store/fact_service.d.ts.map +1 -0
  268. package/dest/storage/fact_store/fact_service.js +45 -0
  269. package/dest/storage/fact_store/fact_store.d.ts +95 -0
  270. package/dest/storage/fact_store/fact_store.d.ts.map +1 -0
  271. package/dest/storage/fact_store/fact_store.js +408 -0
  272. package/dest/storage/fact_store/fact_store_keys.d.ts +34 -0
  273. package/dest/storage/fact_store/fact_store_keys.d.ts.map +1 -0
  274. package/dest/storage/fact_store/fact_store_keys.js +50 -0
  275. package/dest/storage/fact_store/index.d.ts +6 -0
  276. package/dest/storage/fact_store/index.d.ts.map +1 -0
  277. package/dest/storage/fact_store/index.js +4 -0
  278. package/dest/storage/fact_store/origin_state.d.ts +59 -0
  279. package/dest/storage/fact_store/origin_state.d.ts.map +1 -0
  280. package/dest/storage/fact_store/origin_state.js +60 -0
  281. package/dest/storage/fact_store/stored_fact.d.ts +32 -0
  282. package/dest/storage/fact_store/stored_fact.d.ts.map +1 -0
  283. package/dest/storage/fact_store/stored_fact.js +64 -0
  284. package/dest/storage/index.d.ts +3 -2
  285. package/dest/storage/index.d.ts.map +1 -1
  286. package/dest/storage/index.js +2 -1
  287. package/dest/storage/metadata.d.ts +2 -2
  288. package/dest/storage/metadata.d.ts.map +1 -1
  289. package/dest/storage/metadata.js +1 -1
  290. package/dest/storage/note_store/note_store.d.ts +42 -33
  291. package/dest/storage/note_store/note_store.d.ts.map +1 -1
  292. package/dest/storage/note_store/note_store.js +199 -170
  293. package/dest/storage/note_store/stored_note.d.ts +3 -8
  294. package/dest/storage/note_store/stored_note.d.ts.map +1 -1
  295. package/dest/storage/note_store/stored_note.js +4 -20
  296. package/dest/storage/open_pxe_stores.d.ts +35 -0
  297. package/dest/storage/open_pxe_stores.d.ts.map +1 -0
  298. package/dest/storage/open_pxe_stores.js +29 -0
  299. package/dest/storage/private_event_store/private_event_store.d.ts +13 -16
  300. package/dest/storage/private_event_store/private_event_store.d.ts.map +1 -1
  301. package/dest/storage/private_event_store/private_event_store.js +43 -43
  302. package/dest/storage/private_event_store/stored_private_event.js +1 -1
  303. package/dest/storage/store_identity.d.ts +35 -0
  304. package/dest/storage/store_identity.d.ts.map +1 -0
  305. package/dest/storage/store_identity.js +44 -0
  306. package/dest/storage/tagging_store/index.d.ts +2 -2
  307. package/dest/storage/tagging_store/index.d.ts.map +1 -1
  308. package/dest/storage/tagging_store/index.js +1 -1
  309. package/dest/storage/tagging_store/recipient_tagging_store.d.ts +6 -6
  310. package/dest/storage/tagging_store/recipient_tagging_store.d.ts.map +1 -1
  311. package/dest/storage/tagging_store/sender_tagging_store.d.ts +44 -13
  312. package/dest/storage/tagging_store/sender_tagging_store.d.ts.map +1 -1
  313. package/dest/storage/tagging_store/sender_tagging_store.js +84 -32
  314. package/dest/storage/tagging_store/tagging_secret_sources_store.d.ts +51 -0
  315. package/dest/storage/tagging_store/tagging_secret_sources_store.d.ts.map +1 -0
  316. package/dest/storage/tagging_store/tagging_secret_sources_store.js +105 -0
  317. package/dest/tagging/constants.d.ts +11 -2
  318. package/dest/tagging/constants.d.ts.map +1 -1
  319. package/dest/tagging/constants.js +38 -10
  320. package/dest/tagging/get_all_logs_by_tags.d.ts +55 -10
  321. package/dest/tagging/get_all_logs_by_tags.d.ts.map +1 -1
  322. package/dest/tagging/get_all_logs_by_tags.js +53 -35
  323. package/dest/tagging/index.d.ts +7 -6
  324. package/dest/tagging/index.d.ts.map +1 -1
  325. package/dest/tagging/index.js +6 -5
  326. package/dest/tagging/persist_sender_tagging_index_ranges.d.ts +29 -0
  327. package/dest/tagging/persist_sender_tagging_index_ranges.d.ts.map +1 -0
  328. package/dest/tagging/persist_sender_tagging_index_ranges.js +42 -0
  329. package/dest/tagging/recipient_sync/sync_tagged_private_logs.d.ts +74 -0
  330. package/dest/tagging/recipient_sync/sync_tagged_private_logs.d.ts.map +1 -0
  331. package/dest/tagging/recipient_sync/sync_tagged_private_logs.js +234 -0
  332. package/dest/tagging/recipient_sync/utils/find_highest_indexes.d.ts +3 -3
  333. package/dest/tagging/recipient_sync/utils/find_highest_indexes.d.ts.map +1 -1
  334. package/dest/tagging/reconcile_tagging_index_ranges.d.ts +36 -0
  335. package/dest/tagging/reconcile_tagging_index_ranges.d.ts.map +1 -0
  336. package/dest/tagging/reconcile_tagging_index_ranges.js +74 -0
  337. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts +8 -6
  338. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts.map +1 -1
  339. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.js +24 -27
  340. package/dest/tagging/sender_sync/utils/classify_pending_txs.d.ts +22 -0
  341. package/dest/tagging/sender_sync/utils/classify_pending_txs.d.ts.map +1 -0
  342. package/dest/tagging/sender_sync/utils/classify_pending_txs.js +61 -0
  343. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts +17 -7
  344. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts.map +1 -1
  345. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.js +37 -36
  346. package/dest/tagging/sender_sync/utils/resolve_pending_txs.d.ts +29 -0
  347. package/dest/tagging/sender_sync/utils/resolve_pending_txs.d.ts.map +1 -0
  348. package/dest/tagging/sender_sync/utils/resolve_pending_txs.js +41 -0
  349. package/dest/tagging/sender_sync/utils/test_utils.d.ts +16 -0
  350. package/dest/tagging/sender_sync/utils/test_utils.d.ts.map +1 -0
  351. package/dest/tagging/sender_sync/utils/test_utils.js +24 -0
  352. package/dest/tagging/testing/tag_query_test_utils.d.ts +6 -0
  353. package/dest/tagging/testing/tag_query_test_utils.d.ts.map +1 -0
  354. package/dest/tagging/testing/tag_query_test_utils.js +10 -0
  355. package/package.json +20 -17
  356. package/src/bin/check_oracle_version.ts +10 -143
  357. package/src/bin/index.ts +1 -0
  358. package/src/bin/oracle_version_helpers.ts +30 -0
  359. package/src/block_synchronizer/block_stream_source.ts +42 -0
  360. package/src/block_synchronizer/block_synchronizer.ts +86 -40
  361. package/src/config/index.ts +15 -8
  362. package/src/config/package_info.ts +1 -1
  363. package/src/contract/contract_class_service.ts +45 -0
  364. package/src/contract/contract_sync_service.ts +176 -0
  365. package/src/contract/helpers.ts +35 -0
  366. package/src/contract/skip_sync_contracts.ts +23 -0
  367. package/src/contract_function_simulator/anchored_contract_data.ts +74 -0
  368. package/src/contract_function_simulator/contract_function_simulator.ts +140 -75
  369. package/src/contract_function_simulator/ephemeral_array_service.ts +110 -0
  370. package/src/contract_function_simulator/execution_note_cache.ts +8 -29
  371. package/src/contract_function_simulator/execution_tagging_index_cache.ts +5 -9
  372. package/src/contract_function_simulator/index.ts +89 -5
  373. package/src/contract_function_simulator/noir-structs/bounded_vec.ts +43 -0
  374. package/src/contract_function_simulator/noir-structs/contract_class_log_data.ts +9 -0
  375. package/src/contract_function_simulator/noir-structs/embedded_curve_point.ts +4 -0
  376. package/src/contract_function_simulator/noir-structs/ephemeral_array.ts +66 -0
  377. package/src/contract_function_simulator/noir-structs/event_validation_request.ts +5 -7
  378. package/src/contract_function_simulator/noir-structs/fact.ts +13 -0
  379. package/src/contract_function_simulator/noir-structs/fact_collection.ts +64 -0
  380. package/src/contract_function_simulator/noir-structs/log_retrieval_request.ts +27 -20
  381. package/src/contract_function_simulator/noir-structs/log_retrieval_response.ts +14 -61
  382. package/src/contract_function_simulator/noir-structs/note_data.ts +27 -0
  383. package/src/contract_function_simulator/noir-structs/note_validation_request.ts +6 -8
  384. package/src/contract_function_simulator/noir-structs/option.ts +75 -0
  385. package/src/contract_function_simulator/noir-structs/origin_block.ts +8 -0
  386. package/src/contract_function_simulator/noir-structs/pending_tagged_log.ts +12 -0
  387. package/src/contract_function_simulator/noir-structs/provided_secret.ts +5 -0
  388. package/src/contract_function_simulator/noir-structs/resolved_tagging_strategy.ts +66 -0
  389. package/src/contract_function_simulator/noir-structs/resolved_tx.ts +19 -0
  390. package/src/contract_function_simulator/noir-structs/tx_effect_data.ts +16 -0
  391. package/src/contract_function_simulator/noir-structs/utility_context.ts +5 -17
  392. package/src/contract_function_simulator/oracle/acir_callback.ts +154 -0
  393. package/src/contract_function_simulator/oracle/index.ts +1 -15
  394. package/src/contract_function_simulator/oracle/interfaces.ts +11 -176
  395. package/src/contract_function_simulator/oracle/legacy_oracle_registry.ts +147 -0
  396. package/src/contract_function_simulator/oracle/message_load_oracle_inputs.ts +6 -21
  397. package/src/contract_function_simulator/oracle/note_packing_utils.ts +3 -3
  398. package/src/contract_function_simulator/oracle/oracle_registry.ts +710 -0
  399. package/src/contract_function_simulator/oracle/oracle_type_mappings.ts +1067 -0
  400. package/src/contract_function_simulator/oracle/private_execution.ts +3 -4
  401. package/src/contract_function_simulator/oracle/private_execution_oracle.ts +247 -83
  402. package/src/contract_function_simulator/oracle/utility_execution_oracle.ts +890 -305
  403. package/src/contract_function_simulator/pick_notes.ts +22 -3
  404. package/src/contract_function_simulator/transient_array_service.ts +91 -0
  405. package/src/contract_logging.ts +18 -5
  406. package/src/debug/pxe_debug_utils.ts +4 -12
  407. package/src/entrypoints/client/bundle/index.ts +1 -1
  408. package/src/entrypoints/client/bundle/utils.ts +32 -8
  409. package/src/entrypoints/client/lazy/index.ts +1 -1
  410. package/src/entrypoints/client/lazy/utils.ts +32 -8
  411. package/src/entrypoints/client/store.ts +54 -0
  412. package/src/entrypoints/pxe_creation_options.ts +21 -1
  413. package/src/entrypoints/server/index.ts +7 -3
  414. package/src/entrypoints/server/store.ts +47 -0
  415. package/src/entrypoints/server/utils.ts +45 -14
  416. package/src/error_enriching.ts +27 -11
  417. package/src/events/event_service.ts +84 -26
  418. package/src/events/private_event_filter_validator.ts +21 -1
  419. package/src/hooks/authorize_utility_call.ts +44 -0
  420. package/src/hooks/execution_hooks.ts +68 -0
  421. package/src/hooks/index.ts +13 -0
  422. package/src/hooks/resolve_custom_request.ts +24 -0
  423. package/src/hooks/resolve_tagging_secret_strategy.ts +60 -0
  424. package/src/logs/log_service.ts +225 -145
  425. package/src/messages/tx_resolver_service.ts +80 -0
  426. package/src/node/benchmarked_node.ts +140 -0
  427. package/src/node/caching_aztec_node.ts +406 -0
  428. package/src/notes/note_service.ts +126 -86
  429. package/src/notes_filter.ts +1 -3
  430. package/src/oracle_version.ts +20 -10
  431. package/src/private_kernel/batch_planner.ts +168 -0
  432. package/src/private_kernel/hints/private_kernel_reset_private_inputs_builder.ts +12 -2
  433. package/src/private_kernel/hints/test_utils.ts +3 -10
  434. package/src/private_kernel/private_kernel_execution_prover.ts +335 -121
  435. package/src/private_kernel/private_kernel_oracle.ts +58 -29
  436. package/src/pxe.ts +565 -249
  437. package/src/storage/allowed_scopes.ts +14 -0
  438. package/src/storage/anchor_block_store/anchor_block_store.ts +9 -7
  439. package/src/storage/backwards_compatibility_tests/__snapshots__/AddressStore.json +22 -0
  440. package/src/storage/backwards_compatibility_tests/__snapshots__/AnchorBlockStore.json +3 -0
  441. package/src/storage/backwards_compatibility_tests/__snapshots__/CapsuleStore.json +16 -0
  442. package/src/storage/backwards_compatibility_tests/__snapshots__/ContractStore.json +28 -0
  443. package/src/storage/backwards_compatibility_tests/__snapshots__/FactStore.json +40 -0
  444. package/src/storage/backwards_compatibility_tests/__snapshots__/KeyStore.json +52 -0
  445. package/src/storage/backwards_compatibility_tests/__snapshots__/L2TipsKVStore.json +40 -0
  446. package/src/storage/backwards_compatibility_tests/__snapshots__/NoteStore.json +56 -0
  447. package/src/storage/backwards_compatibility_tests/__snapshots__/PrivateEventStore.json +44 -0
  448. package/src/storage/backwards_compatibility_tests/__snapshots__/RecipientTaggingStore.json +26 -0
  449. package/src/storage/backwards_compatibility_tests/__snapshots__/SenderTaggingStore.json +30 -0
  450. package/src/storage/backwards_compatibility_tests/__snapshots__/TaggingSecretSourcesStore.json +30 -0
  451. package/src/storage/backwards_compatibility_tests/__snapshots__/opened_stores.json +117 -0
  452. package/src/storage/backwards_compatibility_tests/kv_store_snapshot.ts +122 -0
  453. package/src/storage/backwards_compatibility_tests/schema_tests.ts +803 -0
  454. package/src/storage/backwards_compatibility_tests/store_spy.ts +73 -0
  455. package/src/storage/capsule_store/capsule_service.ts +85 -0
  456. package/src/storage/capsule_store/capsule_store.ts +44 -26
  457. package/src/storage/capsule_store/index.ts +1 -0
  458. package/src/storage/contract_store/contract_store.ts +98 -125
  459. package/src/storage/fact_store/fact_service.ts +69 -0
  460. package/src/storage/fact_store/fact_store.ts +487 -0
  461. package/src/storage/fact_store/fact_store_keys.ts +75 -0
  462. package/src/storage/fact_store/index.ts +15 -0
  463. package/src/storage/fact_store/origin_state.ts +84 -0
  464. package/src/storage/fact_store/stored_fact.ts +80 -0
  465. package/src/storage/index.ts +2 -1
  466. package/src/storage/metadata.ts +1 -1
  467. package/src/storage/note_store/note_store.ts +228 -192
  468. package/src/storage/note_store/stored_note.ts +5 -27
  469. package/src/storage/open_pxe_stores.ts +52 -0
  470. package/src/storage/private_event_store/private_event_store.ts +52 -54
  471. package/src/storage/private_event_store/stored_private_event.ts +1 -1
  472. package/src/storage/store_identity.ts +72 -0
  473. package/src/storage/tagging_store/index.ts +1 -1
  474. package/src/storage/tagging_store/recipient_tagging_store.ts +5 -9
  475. package/src/storage/tagging_store/sender_tagging_store.ts +118 -46
  476. package/src/storage/tagging_store/tagging_secret_sources_store.ts +138 -0
  477. package/src/tagging/constants.ts +42 -10
  478. package/src/tagging/get_all_logs_by_tags.ts +113 -49
  479. package/src/tagging/index.ts +11 -5
  480. package/src/tagging/persist_sender_tagging_index_ranges.ts +57 -0
  481. package/src/tagging/recipient_sync/sync_tagged_private_logs.ts +355 -0
  482. package/src/tagging/recipient_sync/utils/find_highest_indexes.ts +2 -2
  483. package/src/tagging/reconcile_tagging_index_ranges.ts +102 -0
  484. package/src/tagging/sender_sync/sync_sender_tagging_indexes.ts +30 -38
  485. package/src/tagging/sender_sync/utils/classify_pending_txs.ts +91 -0
  486. package/src/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.ts +48 -43
  487. package/src/tagging/sender_sync/utils/resolve_pending_txs.ts +64 -0
  488. package/src/tagging/sender_sync/utils/test_utils.ts +46 -0
  489. package/src/tagging/testing/tag_query_test_utils.ts +11 -0
  490. package/dest/access_scopes.d.ts +0 -9
  491. package/dest/access_scopes.d.ts.map +0 -1
  492. package/dest/access_scopes.js +0 -6
  493. package/dest/contract_function_simulator/benchmarked_node.d.ts +0 -9
  494. package/dest/contract_function_simulator/benchmarked_node.d.ts.map +0 -1
  495. package/dest/contract_function_simulator/benchmarked_node.js +0 -77
  496. package/dest/contract_function_simulator/noir-structs/message_tx_context.d.ts +0 -16
  497. package/dest/contract_function_simulator/noir-structs/message_tx_context.d.ts.map +0 -1
  498. package/dest/contract_function_simulator/noir-structs/message_tx_context.js +0 -57
  499. package/dest/contract_function_simulator/oracle/legacy_oracle_mappings.d.ts +0 -9
  500. package/dest/contract_function_simulator/oracle/legacy_oracle_mappings.d.ts.map +0 -1
  501. package/dest/contract_function_simulator/oracle/legacy_oracle_mappings.js +0 -42
  502. package/dest/contract_function_simulator/oracle/oracle.d.ts +0 -61
  503. package/dest/contract_function_simulator/oracle/oracle.d.ts.map +0 -1
  504. package/dest/contract_function_simulator/oracle/oracle.js +0 -437
  505. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts +0 -6
  506. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts.map +0 -1
  507. package/dest/contract_function_simulator/proxied_contract_data_source.js +0 -80
  508. package/dest/contract_sync/contract_sync_service.d.ts +0 -45
  509. package/dest/contract_sync/contract_sync_service.d.ts.map +0 -1
  510. package/dest/contract_sync/contract_sync_service.js +0 -114
  511. package/dest/contract_sync/helpers.d.ts +0 -29
  512. package/dest/contract_sync/helpers.d.ts.map +0 -1
  513. package/dest/contract_sync/helpers.js +0 -55
  514. package/dest/messages/message_context_service.d.ts +0 -17
  515. package/dest/messages/message_context_service.d.ts.map +0 -1
  516. package/dest/messages/message_context_service.js +0 -36
  517. package/dest/storage/tagging_store/sender_address_book_store.d.ts +0 -14
  518. package/dest/storage/tagging_store/sender_address_book_store.d.ts.map +0 -1
  519. package/dest/storage/tagging_store/sender_address_book_store.js +0 -36
  520. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts +0 -14
  521. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts.map +0 -1
  522. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.js +0 -99
  523. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts +0 -14
  524. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts.map +0 -1
  525. package/dest/tagging/recipient_sync/utils/load_logs_for_range.js +0 -33
  526. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts +0 -12
  527. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts.map +0 -1
  528. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.js +0 -39
  529. package/src/access_scopes.ts +0 -9
  530. package/src/contract_function_simulator/benchmarked_node.ts +0 -103
  531. package/src/contract_function_simulator/noir-structs/message_tx_context.ts +0 -55
  532. package/src/contract_function_simulator/oracle/legacy_oracle_mappings.ts +0 -135
  533. package/src/contract_function_simulator/oracle/oracle.ts +0 -675
  534. package/src/contract_function_simulator/proxied_contract_data_source.ts +0 -83
  535. package/src/contract_sync/contract_sync_service.ts +0 -181
  536. package/src/contract_sync/helpers.ts +0 -98
  537. package/src/messages/message_context_service.ts +0 -45
  538. package/src/storage/tagging_store/sender_address_book_store.ts +0 -48
  539. package/src/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.ts +0 -140
  540. package/src/tagging/recipient_sync/utils/load_logs_for_range.ts +0 -44
  541. package/src/tagging/sender_sync/utils/get_status_change_of_pending.ts +0 -51
@@ -1,83 +0,0 @@
1
- import { FunctionSelector } from '@aztec/stdlib/abi';
2
- import { AztecAddress } from '@aztec/stdlib/aztec-address';
3
- import type { ContractOverrides } from '@aztec/stdlib/tx';
4
-
5
- import type { ContractStore } from '../storage/contract_store/contract_store.js';
6
-
7
- /*
8
- * Proxy generator for a ContractStore that allows overriding contract instances and artifacts, so
9
- * the contract function simulator can execute different bytecode on certain addresses. An example use case
10
- * would be overriding your own account contract so that valid signatures don't have to be provided while simulating.
11
- */
12
- export class ProxiedContractStoreFactory {
13
- static create(contractStore: ContractStore, overrides?: ContractOverrides) {
14
- if (!overrides) {
15
- return contractStore;
16
- }
17
-
18
- return new Proxy(contractStore, {
19
- get(target, prop: keyof ContractStore) {
20
- switch (prop) {
21
- case 'getContractInstance': {
22
- return async (address: AztecAddress) => {
23
- if (overrides[address.toString()]) {
24
- const { instance } = overrides[address.toString()]!;
25
- instance.address = address;
26
- const realInstance = await target.getContractInstance(address);
27
- if (!realInstance) {
28
- throw new Error(`Contract instance not found for address: ${address}`);
29
- }
30
- instance.currentContractClassId = realInstance.currentContractClassId;
31
- instance.originalContractClassId = realInstance.originalContractClassId;
32
- return instance;
33
- } else {
34
- return target.getContractInstance(address);
35
- }
36
- };
37
- }
38
- case 'getFunctionArtifact': {
39
- return async (contractAddress: AztecAddress, selector: FunctionSelector) => {
40
- if (overrides[contractAddress.toString()]) {
41
- const { artifact } = overrides[contractAddress.toString()]!;
42
- const functions = artifact.functions;
43
- for (let i = 0; i < functions.length; i++) {
44
- const fn = functions[i];
45
- const fnSelector = await FunctionSelector.fromNameAndParameters(fn.name, fn.parameters);
46
- if (fnSelector.equals(selector)) {
47
- return fn;
48
- }
49
- }
50
- } else {
51
- return target.getFunctionArtifact(contractAddress, selector);
52
- }
53
- };
54
- }
55
- case 'getFunctionArtifactWithDebugMetadata': {
56
- return async (contractAddress: AztecAddress, selector: FunctionSelector) => {
57
- if (overrides[contractAddress.toString()]) {
58
- const { artifact } = overrides[contractAddress.toString()]!;
59
- const functions = artifact.functions;
60
- for (let i = 0; i < functions.length; i++) {
61
- const fn = functions[i];
62
- const fnSelector = await FunctionSelector.fromNameAndParameters(fn.name, fn.parameters);
63
- if (fnSelector.equals(selector)) {
64
- return fn;
65
- }
66
- }
67
- } else {
68
- return target.getFunctionArtifactWithDebugMetadata(contractAddress, selector);
69
- }
70
- };
71
- }
72
- default: {
73
- const value = Reflect.get(target, prop);
74
- if (typeof value === 'function') {
75
- return value.bind(target);
76
- }
77
- return value;
78
- }
79
- }
80
- },
81
- });
82
- }
83
- }
@@ -1,181 +0,0 @@
1
- import type { Logger } from '@aztec/foundation/log';
2
- import type { FunctionCall, FunctionSelector } from '@aztec/stdlib/abi';
3
- import type { AztecAddress } from '@aztec/stdlib/aztec-address';
4
- import type { AztecNode } from '@aztec/stdlib/interfaces/client';
5
- import type { BlockHeader } from '@aztec/stdlib/tx';
6
-
7
- import type { AccessScopes } from '../access_scopes.js';
8
- import type { StagedStore } from '../job_coordinator/job_coordinator.js';
9
- import type { ContractStore } from '../storage/contract_store/contract_store.js';
10
- import type { NoteStore } from '../storage/note_store/note_store.js';
11
- import { syncState, verifyCurrentClassId } from './helpers.js';
12
-
13
- /**
14
- * Service for syncing the private state of contracts and verifying that the PXE holds the current class artifact.
15
- * It uses a cache to avoid redundant sync operations - the cache is wiped when the anchor block changes.
16
- *
17
- * TODO: The StagedStore naming is broken here. Figure out a better name.
18
- */
19
- export class ContractSyncService implements StagedStore {
20
- readonly storeName = 'contract_sync';
21
-
22
- // Tracks contracts synced since last wipe. The cache is keyed per individual scope address
23
- // (`contractAddress:scopeAddress`), or `contractAddress:*` for all scopes (all accounts).
24
- // The value is a promise that resolves when the contract is synced.
25
- private syncedContracts: Map<string, Promise<void>> = new Map();
26
-
27
- // Per-job excluded contract addresses - these contracts should not be synced.
28
- private excludedFromSync: Map<string, Set<string>> = new Map();
29
-
30
- constructor(
31
- private aztecNode: AztecNode,
32
- private contractStore: ContractStore,
33
- private noteStore: NoteStore,
34
- private log: Logger,
35
- ) {}
36
-
37
- /** Sets contracts that should be skipped during sync for a specific job. */
38
- setExcludedFromSync(jobId: string, addresses: Set<string>): void {
39
- this.excludedFromSync.set(jobId, addresses);
40
- }
41
-
42
- /**
43
- * Ensures a contract's private state is synchronized and that the PXE holds the current class artifact.
44
- * Uses a cache to avoid redundant sync operations - the cache is wiped when the anchor block changes.
45
- * @param contractAddress - The address of the contract to sync.
46
- * @param functionToInvokeAfterSync - The function selector that will be called after sync (used to validate it's
47
- * not sync_state itself).
48
- * @param utilityExecutor - Executor function for running the sync_state utility function.
49
- * @param scopes - Access scopes to pass through to the utility executor (affects whose account's private state is discovered).
50
- */
51
- async ensureContractSynced(
52
- contractAddress: AztecAddress,
53
- functionToInvokeAfterSync: FunctionSelector | null,
54
- utilityExecutor: (call: FunctionCall, scopes: AccessScopes) => Promise<any>,
55
- anchorBlockHeader: BlockHeader,
56
- jobId: string,
57
- scopes: AccessScopes,
58
- ): Promise<void> {
59
- if (this.#shouldSkipSync(jobId, contractAddress)) {
60
- return;
61
- }
62
-
63
- this.#startSyncIfNeeded(contractAddress, scopes, scopesToSync =>
64
- this.#syncContract(
65
- contractAddress,
66
- functionToInvokeAfterSync,
67
- utilityExecutor,
68
- anchorBlockHeader,
69
- jobId,
70
- scopesToSync,
71
- ),
72
- );
73
-
74
- await this.#awaitSync(contractAddress, scopes);
75
- }
76
-
77
- /** Clears sync cache entries for the given scopes of a contract. Also clears the ALL_SCOPES entry. */
78
- invalidateContractForScopes(contractAddress: AztecAddress, scopes: AztecAddress[]): void {
79
- if (scopes.length === 0) {
80
- return;
81
- }
82
- scopes.forEach(scope => this.syncedContracts.delete(toKey(contractAddress, scope)));
83
- this.syncedContracts.delete(toKey(contractAddress, 'ALL_SCOPES'));
84
- }
85
-
86
- async #syncContract(
87
- contractAddress: AztecAddress,
88
- functionToInvokeAfterSync: FunctionSelector | null,
89
- utilityExecutor: (call: FunctionCall, scopes: AccessScopes) => Promise<any>,
90
- anchorBlockHeader: BlockHeader,
91
- jobId: string,
92
- scopes: AccessScopes,
93
- ): Promise<void> {
94
- this.log.debug(`Syncing contract ${contractAddress}`);
95
- await Promise.all([
96
- syncState(
97
- contractAddress,
98
- this.contractStore,
99
- functionToInvokeAfterSync,
100
- utilityExecutor,
101
- this.noteStore,
102
- this.aztecNode,
103
- anchorBlockHeader,
104
- jobId,
105
- scopes,
106
- ),
107
- verifyCurrentClassId(contractAddress, this.aztecNode, this.contractStore, anchorBlockHeader),
108
- ]);
109
- this.log.debug(`Contract ${contractAddress} synced`);
110
- }
111
-
112
- /** Clears sync cache. Called by BlockSynchronizer when anchor block changes. */
113
- wipe(): void {
114
- this.log.debug(`Wiping contract sync cache (${this.syncedContracts.size} entries)`);
115
- this.syncedContracts.clear();
116
- }
117
-
118
- commit(jobId: string): Promise<void> {
119
- // Clear excluded contracts for this job
120
- this.excludedFromSync.delete(jobId);
121
- return Promise.resolve();
122
- }
123
-
124
- discardStaged(jobId: string): Promise<void> {
125
- // We clear the synced contracts cache here because, when the job is discarded, any associated database writes from
126
- // the sync are also undone.
127
- this.syncedContracts.clear();
128
- this.excludedFromSync.delete(jobId);
129
- return Promise.resolve();
130
- }
131
- /** Returns true if sync should be skipped for this contract */
132
- #shouldSkipSync(jobId: string, contractAddress: AztecAddress): boolean {
133
- return !!this.excludedFromSync.get(jobId)?.has(contractAddress.toString());
134
- }
135
-
136
- /** If there are unsynced scopes, starts sync and stores the promise in cache with error cleanup. */
137
- #startSyncIfNeeded(
138
- contractAddress: AztecAddress,
139
- scopes: AccessScopes,
140
- syncFn: (scopesToSync: AccessScopes) => Promise<void>,
141
- ): void {
142
- const scopesToSync = this.#getScopesToSync(contractAddress, scopes);
143
- const keys = toKeys(contractAddress, scopesToSync);
144
- if (keys.length === 0) {
145
- return;
146
- }
147
- const promise = syncFn(scopesToSync).catch(err => {
148
- keys.forEach(key => this.syncedContracts.delete(key));
149
- throw err;
150
- });
151
- keys.forEach(key => this.syncedContracts.set(key, promise));
152
- }
153
-
154
- /** Filters out scopes that are already cached, returning only those that still need syncing. */
155
- #getScopesToSync(contractAddress: AztecAddress, scopes: AccessScopes): AccessScopes {
156
- if (this.syncedContracts.has(toKey(contractAddress, 'ALL_SCOPES'))) {
157
- // If we are already syncing all scopes, then return an empty list
158
- return [];
159
- }
160
- if (scopes === 'ALL_SCOPES') {
161
- return 'ALL_SCOPES';
162
- }
163
- return scopes.filter(scope => !this.syncedContracts.has(toKey(contractAddress, scope)));
164
- }
165
-
166
- /** Collects all relevant scope promises (including in-flight ones from concurrent calls) and awaits them. */
167
- async #awaitSync(contractAddress: AztecAddress, scopes: AccessScopes): Promise<void> {
168
- const promises = toKeys(contractAddress, scopes)
169
- .map(key => this.syncedContracts.get(key))
170
- .filter(p => p !== undefined);
171
- await Promise.all(promises);
172
- }
173
- }
174
-
175
- function toKeys(contract: AztecAddress, scopes: AccessScopes) {
176
- return scopes === 'ALL_SCOPES' ? [toKey(contract, scopes)] : scopes.map(scope => toKey(contract, scope));
177
- }
178
-
179
- function toKey(contract: AztecAddress, scope: AztecAddress | 'ALL_SCOPES') {
180
- return scope === 'ALL_SCOPES' ? `${contract.toString()}:*` : `${contract.toString()}:${scope.toString()}`;
181
- }
@@ -1,98 +0,0 @@
1
- import { ProtocolContractAddress, isProtocolContract } from '@aztec/protocol-contracts';
2
- import type { FunctionCall, FunctionSelector } from '@aztec/stdlib/abi';
3
- import type { AztecAddress } from '@aztec/stdlib/aztec-address';
4
- import type { ContractInstance } from '@aztec/stdlib/contract';
5
- import { DelayedPublicMutableValues, DelayedPublicMutableValuesWithHash } from '@aztec/stdlib/delayed-public-mutable';
6
- import type { AztecNode } from '@aztec/stdlib/interfaces/client';
7
- import type { BlockHeader } from '@aztec/stdlib/tx';
8
-
9
- import type { AccessScopes } from '../access_scopes.js';
10
- import { NoteService } from '../notes/note_service.js';
11
- import type { ContractStore } from '../storage/contract_store/contract_store.js';
12
- import type { NoteStore } from '../storage/note_store/note_store.js';
13
-
14
- /**
15
- * Read the current class id of a contract from the execution data provider or AztecNode. If not found, class id
16
- * from the instance is used.
17
- * @param contractAddress - The address of the contract to read the class id for.
18
- * @param instance - The instance of the contract.
19
- * @param aztecNode - The Aztec node to query for storage.
20
- * @param header - The header of the block at which to load the DelayedPublicMutable storing the class id.
21
- * @returns The current class id.
22
- */
23
- export async function readCurrentClassId(
24
- contractAddress: AztecAddress,
25
- instance: ContractInstance,
26
- aztecNode: AztecNode,
27
- header: BlockHeader,
28
- ) {
29
- const blockHash = await header.hash();
30
- const timestamp = header.globalVariables.timestamp;
31
- const { delayedPublicMutableSlot } = await DelayedPublicMutableValuesWithHash.getContractUpdateSlots(contractAddress);
32
- const delayedPublicMutableValues = await DelayedPublicMutableValues.readFromTree(delayedPublicMutableSlot, slot =>
33
- aztecNode.getPublicStorageAt(blockHash, ProtocolContractAddress.ContractInstanceRegistry, slot),
34
- );
35
- let currentClassId = delayedPublicMutableValues.svc.getCurrentAt(timestamp)[0];
36
- if (currentClassId.isZero()) {
37
- currentClassId = instance.originalContractClassId;
38
- }
39
- return currentClassId;
40
- }
41
-
42
- export async function syncState(
43
- contractAddress: AztecAddress,
44
- contractStore: ContractStore,
45
- functionToInvokeAfterSync: FunctionSelector | null,
46
- utilityExecutor: (privateSyncCall: FunctionCall, scopes: AccessScopes) => Promise<any>,
47
- noteStore: NoteStore,
48
- aztecNode: AztecNode,
49
- anchorBlockHeader: BlockHeader,
50
- jobId: string,
51
- scopes: AccessScopes,
52
- ) {
53
- // Protocol contracts don't have private state to sync
54
- if (!isProtocolContract(contractAddress)) {
55
- const syncStateFunctionCall = await contractStore.getFunctionCall('sync_state', [], contractAddress);
56
- if (functionToInvokeAfterSync && functionToInvokeAfterSync.equals(syncStateFunctionCall.selector)) {
57
- throw new Error(
58
- 'Forbidden `sync_state` invocation. `sync_state` can only be invoked by PXE, manual execution can lead to inconsistencies.',
59
- );
60
- }
61
-
62
- const noteService = new NoteService(noteStore, aztecNode, anchorBlockHeader, jobId);
63
-
64
- // Both sync_state and syncNoteNullifiers interact with the note store, but running them in parallel is safe
65
- // because note store is designed to handle concurrent operations.
66
- await Promise.all([
67
- utilityExecutor(syncStateFunctionCall, scopes),
68
- noteService.syncNoteNullifiers(contractAddress, scopes),
69
- ]);
70
- }
71
- }
72
-
73
- /**
74
- * Verify that the current class id of a contract obtained from AztecNode is the same as the one in contract data
75
- * provider (i.e. PXE's own storage).
76
- * @param contractAddress - The address of the contract to verify.
77
- * @param aztecNode - The Aztec node to query for storage.
78
- * @param contractStore - The contract store to fetch the local instance from.
79
- * @param header - The header of the block at which to verify the current class id.
80
- */
81
- export async function verifyCurrentClassId(
82
- contractAddress: AztecAddress,
83
- aztecNode: AztecNode,
84
- contractStore: ContractStore,
85
- header: BlockHeader,
86
- ) {
87
- const instance = await contractStore.getContractInstance(contractAddress);
88
- if (!instance) {
89
- throw new Error(`No contract instance found for address ${contractAddress.toString()}`);
90
- }
91
-
92
- const currentClassId = await readCurrentClassId(contractAddress, instance, aztecNode, header);
93
- if (!instance.currentContractClassId.equals(currentClassId)) {
94
- throw new Error(
95
- `Contract ${contractAddress} is outdated, current class id is ${currentClassId}, local class id is ${instance.currentContractClassId}`,
96
- );
97
- }
98
- }
@@ -1,45 +0,0 @@
1
- import { Fr } from '@aztec/foundation/curves/bn254';
2
- import type { AztecNode } from '@aztec/stdlib/interfaces/server';
3
- import { TxHash } from '@aztec/stdlib/tx';
4
-
5
- import { MessageTxContext } from '../contract_function_simulator/noir-structs/message_tx_context.js';
6
-
7
- /** Resolves transaction hashes into the context needed to process messages. */
8
- export class MessageContextService {
9
- constructor(private readonly aztecNode: AztecNode) {}
10
-
11
- /**
12
- * Resolves a list of tx hashes into their message contexts.
13
- *
14
- * For each tx hash, looks up the corresponding tx effect and extracts the note hashes and first nullifier needed to
15
- * process messages that originated from that transaction. Returns `null` for tx hashes that are zero, not yet
16
- * available, or in blocks beyond the anchor block.
17
- */
18
- resolveMessageContexts(txHashes: Fr[], anchorBlockNumber: number): Promise<(MessageTxContext | null)[]> {
19
- // TODO: optimize, we might be hitting the node to get the same txHash repeatedly
20
- return Promise.all(
21
- txHashes.map(async txHashField => {
22
- // A zero tx hash indicates a tx-less offchain message (e.g. one not tied to any onchain transaction).
23
- // These messages don't have a transaction context to resolve, so we return null.
24
- if (txHashField.isZero()) {
25
- return null;
26
- }
27
-
28
- const txHash = TxHash.fromField(txHashField);
29
- const txEffect = await this.aztecNode.getTxEffect(txHash);
30
- if (!txEffect || txEffect.l2BlockNumber > anchorBlockNumber) {
31
- return null;
32
- }
33
-
34
- // Every tx has at least one nullifier (the first nullifier derived from the tx hash). Hitting this condition
35
- // would mean a buggy node, but since we need to access data.nullifiers[0], the defensive check does no harm.
36
- const data = txEffect.data;
37
- if (data.nullifiers.length === 0) {
38
- throw new Error(`Tx effect for ${txHash} has no nullifiers`);
39
- }
40
-
41
- return new MessageTxContext(data.txHash, data.noteHashes, data.nullifiers[0]);
42
- }),
43
- );
44
- }
45
- }
@@ -1,48 +0,0 @@
1
- import { toArray } from '@aztec/foundation/iterable';
2
- import type { AztecAsyncKVStore, AztecAsyncMap } from '@aztec/kv-store';
3
- import { AztecAddress } from '@aztec/stdlib/aztec-address';
4
-
5
- /**
6
- * Stores sender addresses. During recipient log synchronization, these senders are used, along with a given recipient,
7
- * to derive directional app tagging secrets that are then used to sync the logs.
8
- */
9
- export class SenderAddressBookStore {
10
- #store: AztecAsyncKVStore;
11
- #addressBook: AztecAsyncMap<string, true>;
12
-
13
- constructor(store: AztecAsyncKVStore) {
14
- this.#store = store;
15
-
16
- this.#addressBook = this.#store.openMap('address_book');
17
- }
18
-
19
- addSender(address: AztecAddress): Promise<boolean> {
20
- return this.#store.transactionAsync(async () => {
21
- if (await this.#addressBook.hasAsync(address.toString())) {
22
- return false;
23
- }
24
-
25
- await this.#addressBook.set(address.toString(), true);
26
-
27
- return true;
28
- });
29
- }
30
-
31
- getSenders(): Promise<AztecAddress[]> {
32
- return this.#store.transactionAsync(async () => {
33
- return (await toArray(this.#addressBook.keysAsync())).map(AztecAddress.fromString);
34
- });
35
- }
36
-
37
- removeSender(address: AztecAddress): Promise<boolean> {
38
- return this.#store.transactionAsync(async () => {
39
- if (!(await this.#addressBook.hasAsync(address.toString()))) {
40
- return false;
41
- }
42
-
43
- await this.#addressBook.delete(address.toString());
44
-
45
- return true;
46
- });
47
- }
48
- }
@@ -1,140 +0,0 @@
1
- import type { BlockNumber } from '@aztec/foundation/branded-types';
2
- import type { BlockHash } from '@aztec/stdlib/block';
3
- import type { AztecNode } from '@aztec/stdlib/interfaces/client';
4
- import type { ExtendedDirectionalAppTaggingSecret, TxScopedL2Log } from '@aztec/stdlib/logs';
5
-
6
- import type { RecipientTaggingStore } from '../../storage/tagging_store/recipient_tagging_store.js';
7
- import { UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN } from '../constants.js';
8
- import { findHighestIndexes } from './utils/find_highest_indexes.js';
9
- import { loadLogsForRange } from './utils/load_logs_for_range.js';
10
-
11
- /**
12
- * Loads private logs for the app-sender-recipient triplet defined by `secret` and updates the highest aged and
13
- * finalized indexes in the db. At most load logs from blocks up to and including `anchorBlockNumber`.
14
- *
15
- * @dev This function can be safely executed "in parallel" for other sender-recipient pairs because the data in
16
- * in the tagging data provider is indexed by the secret and hence completely disjoint.
17
- */
18
- export async function loadPrivateLogsForSenderRecipientPair(
19
- secret: ExtendedDirectionalAppTaggingSecret,
20
- aztecNode: AztecNode,
21
- taggingStore: RecipientTaggingStore,
22
- anchorBlockNumber: BlockNumber,
23
- anchorBlockHash: BlockHash,
24
- jobId: string,
25
- ): Promise<TxScopedL2Log[]> {
26
- // # Explanation of how the algorithm works
27
- // When we perform the sync we will look at logs that correspond to the tagging index range
28
- // (highestAgedIndex, highestFinalizedIndex + WINDOW_LEN]
29
- //
30
- // highestAgedIndex is the highest index that was used in a tx that is included in a block at least
31
- // `MAX_TX_LIFETIME` seconds ago.
32
- // highestFinalizedIndex is the highest index that was used in a tx that is included in a finalized block.
33
- //
34
- // "(" denotes an open end of the range - the index is not included in the range.
35
- // "]" denotes a closed end of the range - the index is included in the range.
36
- //
37
- // ## Explanation of highestAgedIndex
38
- //
39
- // highestAgedIndex is chosen such that for all tagging indexes `i <= highestAgedIndex` we know that no new logs can
40
- // ever appear.
41
- //
42
- // This relies on the "maximum inclusion timestamp" rule enforced by the kernel and rollup circuits:
43
- // - a transaction's maximum inclusion timestamp is at most `MAX_TX_LIFETIME` seconds after
44
- // the timestamp of its anchor block; and
45
- // - a rollup only includes transactions whose inclusion timestamp is >= the L2 block's timestamp.
46
- //
47
- // Suppose some device used index `I` in a transaction anchored to block `B_N` at time `N`, and that block is now at
48
- // least `MAX_TX_LIFETIME` seconds in the past. Then there is no possibility of any *other* device
49
- // trying to use an index <= `I` while anchoring to a *newer* block than `B_N` because if we were anchoring to
50
- // a newer block than `B_N` then we would already have seen the log with index `I` and hence the device would have
51
- // chosen a larger index.
52
- // If that *other* device would anchor to a block older than `B_N` then that tx could never be included in a block
53
- // because it would already have been expired.
54
- //
55
- // Therefore, once we see that index `I` has been used in a block that is at least `MAX_TX_LIFETIME`
56
- // seconds old, we can safely stop syncing logs for all indexes <= `I` and set highestAgedIndex = `I`.
57
- //
58
- // ## Explanation of the upper bound `highestFinalizedIndex + WINDOW_LEN`
59
- //
60
- // When a sender chooses a tagging index, they will select an index that is at most `WINDOW_LEN` greater than
61
- // the highest finalized index. If that index was already used, they will throw an error. For this reason we
62
- // don't have to look further than `highestFinalizedIndex + WINDOW_LEN`.
63
-
64
- let finalizedBlockNumber: number, currentTimestamp: bigint;
65
- {
66
- const [l2Tips, latestBlockHeader] = await Promise.all([aztecNode.getL2Tips(), aztecNode.getBlockHeader('latest')]);
67
-
68
- if (!latestBlockHeader) {
69
- throw new Error('Node failed to return latest block header when syncing logs');
70
- }
71
-
72
- [finalizedBlockNumber, currentTimestamp] = [
73
- l2Tips.finalized.block.number,
74
- latestBlockHeader.globalVariables.timestamp,
75
- ];
76
- }
77
-
78
- let start: number, end: number;
79
- {
80
- const currentHighestAgedIndex = await taggingStore.getHighestAgedIndex(secret, jobId);
81
- const currentHighestFinalizedIndex = await taggingStore.getHighestFinalizedIndex(secret, jobId);
82
-
83
- // We don't want to include the highest aged index so we start from `currentHighestAgedIndex + 1` (or 0 if not set)
84
- start = currentHighestAgedIndex === undefined ? 0 : currentHighestAgedIndex + 1;
85
-
86
- // The highest index a sender can choose is "highest finalized index + window length" but given that
87
- // `loadLogsForRange` expects an exclusive `end` we add 1.
88
- end = (currentHighestFinalizedIndex ?? 0) + UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN + 1;
89
- }
90
-
91
- const logs: TxScopedL2Log[] = [];
92
-
93
- while (true) {
94
- // Get private logs with their block timestamps and corresponding tagging indexes
95
- const privateLogsWithIndexes = await loadLogsForRange(
96
- secret,
97
- aztecNode,
98
- start,
99
- end,
100
- anchorBlockNumber,
101
- anchorBlockHash,
102
- );
103
-
104
- if (privateLogsWithIndexes.length === 0) {
105
- break;
106
- }
107
-
108
- logs.push(...privateLogsWithIndexes.map(({ log }) => log));
109
-
110
- const { highestAgedIndex, highestFinalizedIndex } = findHighestIndexes(
111
- privateLogsWithIndexes,
112
- currentTimestamp,
113
- finalizedBlockNumber,
114
- );
115
-
116
- // Store updates in data provider and update local variables
117
- if (highestAgedIndex !== undefined) {
118
- await taggingStore.updateHighestAgedIndex(secret, highestAgedIndex, jobId);
119
- }
120
-
121
- if (highestFinalizedIndex === undefined) {
122
- // We have not found a new highest finalized index, so there is no need to move the window forward.
123
- break;
124
- }
125
-
126
- if (highestAgedIndex !== undefined && highestAgedIndex > highestFinalizedIndex) {
127
- // This is just a sanity check as this should never happen.
128
- throw new Error('Highest aged index lower than highest finalized index invariant violated');
129
- }
130
-
131
- await taggingStore.updateHighestFinalizedIndex(secret, highestFinalizedIndex, jobId);
132
-
133
- // For the next iteration we want to look only at indexes for which we have not attempted to load logs yet while
134
- // ensuring that we do not look further than WINDOW_LEN ahead of the highest finalized index.
135
- start = end;
136
- end = highestFinalizedIndex + UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN + 1; // `end` is exclusive so we add 1.
137
- }
138
-
139
- return logs;
140
- }
@@ -1,44 +0,0 @@
1
- import type { BlockNumber } from '@aztec/foundation/branded-types';
2
- import type { BlockHash } from '@aztec/stdlib/block';
3
- import type { AztecNode } from '@aztec/stdlib/interfaces/client';
4
- import type { ExtendedDirectionalAppTaggingSecret, TxScopedL2Log } from '@aztec/stdlib/logs';
5
- import { SiloedTag } from '@aztec/stdlib/logs';
6
-
7
- import { getAllPrivateLogsByTags } from '../../get_all_logs_by_tags.js';
8
-
9
- /**
10
- * Gets private logs with their corresponding block timestamps and tagging indexes for the given index range and
11
- * `extendedSecret`. At most load logs from blocks up to and including `anchorBlockNumber`. `start` is inclusive and
12
- * `end` is exclusive.
13
- */
14
- export async function loadLogsForRange(
15
- extendedSecret: ExtendedDirectionalAppTaggingSecret,
16
- aztecNode: AztecNode,
17
- start: number,
18
- end: number,
19
- anchorBlockNumber: BlockNumber,
20
- anchorBlockHash: BlockHash,
21
- ): Promise<Array<{ log: TxScopedL2Log; taggingIndex: number }>> {
22
- // Derive siloed tags for the window
23
- const siloedTags = await Promise.all(
24
- Array.from({ length: end - start }, (_, i) => SiloedTag.compute({ extendedSecret, index: start + i })),
25
- );
26
-
27
- // We use the utility function below to retrieve all logs for the tags across all pages, so we don't need to handle
28
- // pagination here.
29
- const logs = await getAllPrivateLogsByTags(aztecNode, siloedTags, anchorBlockHash);
30
-
31
- // Pair logs with their corresponding tagging indexes
32
- const logsWithIndexes: Array<{ log: TxScopedL2Log; taggingIndex: number }> = [];
33
- for (let i = 0; i < logs.length; i++) {
34
- const logsForTag = logs[i];
35
- const taggingIndex = start + i;
36
- for (const log of logsForTag) {
37
- if (log.blockNumber <= anchorBlockNumber) {
38
- logsWithIndexes.push({ log, taggingIndex });
39
- }
40
- }
41
- }
42
-
43
- return logsWithIndexes;
44
- }