@aztec/pxe 0.0.1-commit.03f7ef2 → 0.0.1-commit.04d373f

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 (488) hide show
  1. package/dest/bin/check_oracle_version.d.ts +12 -2
  2. package/dest/bin/check_oracle_version.d.ts.map +1 -1
  3. package/dest/bin/check_oracle_version.js +32 -26
  4. package/dest/bin/index.d.ts +2 -0
  5. package/dest/bin/index.d.ts.map +1 -0
  6. package/dest/bin/index.js +1 -0
  7. package/dest/block_synchronizer/block_stream_source.d.ts +10 -0
  8. package/dest/block_synchronizer/block_stream_source.d.ts.map +1 -0
  9. package/dest/block_synchronizer/block_stream_source.js +62 -0
  10. package/dest/block_synchronizer/block_synchronizer.d.ts +22 -12
  11. package/dest/block_synchronizer/block_synchronizer.d.ts.map +1 -1
  12. package/dest/block_synchronizer/block_synchronizer.js +101 -35
  13. package/dest/config/index.d.ts +10 -2
  14. package/dest/config/index.d.ts.map +1 -1
  15. package/dest/config/index.js +17 -2
  16. package/dest/config/package_info.js +1 -1
  17. package/dest/contract_function_simulator/benchmarked_node.d.ts +9 -0
  18. package/dest/contract_function_simulator/benchmarked_node.d.ts.map +1 -0
  19. package/dest/contract_function_simulator/benchmarked_node.js +77 -0
  20. package/dest/contract_function_simulator/contract_function_simulator.d.ts +77 -41
  21. package/dest/contract_function_simulator/contract_function_simulator.d.ts.map +1 -1
  22. package/dest/contract_function_simulator/contract_function_simulator.js +251 -96
  23. package/dest/contract_function_simulator/ephemeral_array_service.d.ts +28 -0
  24. package/dest/contract_function_simulator/ephemeral_array_service.d.ts.map +1 -0
  25. package/dest/contract_function_simulator/ephemeral_array_service.js +78 -0
  26. package/dest/contract_function_simulator/execution_note_cache.d.ts +18 -9
  27. package/dest/contract_function_simulator/execution_note_cache.d.ts.map +1 -1
  28. package/dest/contract_function_simulator/execution_note_cache.js +45 -28
  29. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts +7 -11
  30. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts.map +1 -1
  31. package/dest/contract_function_simulator/execution_tagging_index_cache.js +19 -15
  32. package/dest/contract_function_simulator/index.d.ts +5 -2
  33. package/dest/contract_function_simulator/index.d.ts.map +1 -1
  34. package/dest/contract_function_simulator/index.js +4 -1
  35. package/dest/contract_function_simulator/noir-structs/bounded_vec.d.ts +48 -0
  36. package/dest/contract_function_simulator/noir-structs/bounded_vec.d.ts.map +1 -0
  37. package/dest/contract_function_simulator/noir-structs/bounded_vec.js +45 -0
  38. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts +6 -7
  39. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts.map +1 -1
  40. package/dest/contract_function_simulator/noir-structs/event_validation_request.js +12 -10
  41. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.d.ts +13 -3
  42. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.d.ts.map +1 -1
  43. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.js +35 -4
  44. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts +2 -2
  45. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts.map +1 -1
  46. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.js +2 -4
  47. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts +5 -8
  48. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts.map +1 -1
  49. package/dest/contract_function_simulator/noir-structs/note_validation_request.js +7 -11
  50. package/dest/contract_function_simulator/noir-structs/option.d.ts +61 -0
  51. package/dest/contract_function_simulator/noir-structs/option.d.ts.map +1 -0
  52. package/dest/contract_function_simulator/noir-structs/option.js +62 -0
  53. package/dest/contract_function_simulator/noir-structs/utility_context.d.ts +4 -10
  54. package/dest/contract_function_simulator/noir-structs/utility_context.d.ts.map +1 -1
  55. package/dest/contract_function_simulator/noir-structs/utility_context.js +7 -18
  56. package/dest/contract_function_simulator/oracle/interfaces.d.ts +70 -50
  57. package/dest/contract_function_simulator/oracle/interfaces.d.ts.map +1 -1
  58. package/dest/contract_function_simulator/oracle/message_load_oracle_inputs.d.ts +3 -1
  59. package/dest/contract_function_simulator/oracle/message_load_oracle_inputs.d.ts.map +1 -1
  60. package/dest/contract_function_simulator/oracle/note_packing_utils.d.ts +7 -7
  61. package/dest/contract_function_simulator/oracle/note_packing_utils.d.ts.map +1 -1
  62. package/dest/contract_function_simulator/oracle/note_packing_utils.js +10 -10
  63. package/dest/contract_function_simulator/oracle/oracle.d.ts +74 -43
  64. package/dest/contract_function_simulator/oracle/oracle.d.ts.map +1 -1
  65. package/dest/contract_function_simulator/oracle/oracle.js +471 -264
  66. package/dest/contract_function_simulator/oracle/oracle_registry.d.ts +147 -0
  67. package/dest/contract_function_simulator/oracle/oracle_registry.d.ts.map +1 -0
  68. package/dest/contract_function_simulator/oracle/oracle_registry.js +1199 -0
  69. package/dest/contract_function_simulator/oracle/private_execution.d.ts +2 -26
  70. package/dest/contract_function_simulator/oracle/private_execution.d.ts.map +1 -1
  71. package/dest/contract_function_simulator/oracle/private_execution.js +5 -39
  72. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts +74 -100
  73. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts.map +1 -1
  74. package/dest/contract_function_simulator/oracle/private_execution_oracle.js +168 -139
  75. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts +169 -90
  76. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts.map +1 -1
  77. package/dest/contract_function_simulator/oracle/utility_execution_oracle.js +468 -193
  78. package/dest/contract_function_simulator/pick_notes.d.ts +1 -1
  79. package/dest/contract_function_simulator/pick_notes.d.ts.map +1 -1
  80. package/dest/contract_function_simulator/pick_notes.js +20 -3
  81. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts +4 -4
  82. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts.map +1 -1
  83. package/dest/contract_function_simulator/proxied_contract_data_source.js +39 -68
  84. package/dest/contract_logging.d.ts +27 -0
  85. package/dest/contract_logging.d.ts.map +1 -0
  86. package/dest/contract_logging.js +38 -0
  87. package/dest/contract_sync/contract_sync_service.d.ts +42 -0
  88. package/dest/contract_sync/contract_sync_service.d.ts.map +1 -0
  89. package/dest/contract_sync/contract_sync_service.js +135 -0
  90. package/dest/contract_sync/helpers.d.ts +27 -0
  91. package/dest/contract_sync/helpers.d.ts.map +1 -0
  92. package/dest/contract_sync/helpers.js +53 -0
  93. package/dest/debug/pxe_debug_utils.d.ts +21 -12
  94. package/dest/debug/pxe_debug_utils.d.ts.map +1 -1
  95. package/dest/debug/pxe_debug_utils.js +24 -19
  96. package/dest/entrypoints/client/bundle/index.d.ts +3 -1
  97. package/dest/entrypoints/client/bundle/index.d.ts.map +1 -1
  98. package/dest/entrypoints/client/bundle/index.js +2 -0
  99. package/dest/entrypoints/client/bundle/utils.d.ts +2 -2
  100. package/dest/entrypoints/client/bundle/utils.d.ts.map +1 -1
  101. package/dest/entrypoints/client/bundle/utils.js +41 -10
  102. package/dest/entrypoints/client/lazy/index.d.ts +3 -1
  103. package/dest/entrypoints/client/lazy/index.d.ts.map +1 -1
  104. package/dest/entrypoints/client/lazy/index.js +2 -0
  105. package/dest/entrypoints/client/lazy/utils.d.ts +3 -3
  106. package/dest/entrypoints/client/lazy/utils.d.ts.map +1 -1
  107. package/dest/entrypoints/client/lazy/utils.js +42 -11
  108. package/dest/entrypoints/pxe_creation_options.d.ts +13 -3
  109. package/dest/entrypoints/pxe_creation_options.d.ts.map +1 -1
  110. package/dest/entrypoints/pxe_creation_options.js +3 -1
  111. package/dest/entrypoints/server/index.d.ts +6 -2
  112. package/dest/entrypoints/server/index.d.ts.map +1 -1
  113. package/dest/entrypoints/server/index.js +5 -1
  114. package/dest/entrypoints/server/utils.d.ts +4 -3
  115. package/dest/entrypoints/server/utils.d.ts.map +1 -1
  116. package/dest/entrypoints/server/utils.js +49 -18
  117. package/dest/error_enriching.d.ts +4 -4
  118. package/dest/error_enriching.d.ts.map +1 -1
  119. package/dest/error_enriching.js +6 -6
  120. package/dest/events/event_service.d.ts +19 -10
  121. package/dest/events/event_service.d.ts.map +1 -1
  122. package/dest/events/event_service.js +60 -30
  123. package/dest/events/private_event_filter_validator.d.ts +7 -6
  124. package/dest/events/private_event_filter_validator.d.ts.map +1 -1
  125. package/dest/events/private_event_filter_validator.js +20 -6
  126. package/dest/hooks/authorize_utility_call.d.ts +41 -0
  127. package/dest/hooks/authorize_utility_call.d.ts.map +1 -0
  128. package/dest/hooks/authorize_utility_call.js +4 -0
  129. package/dest/hooks/execution_hooks.d.ts +42 -0
  130. package/dest/hooks/execution_hooks.d.ts.map +1 -0
  131. package/dest/hooks/execution_hooks.js +9 -0
  132. package/dest/hooks/index.d.ts +4 -0
  133. package/dest/hooks/index.d.ts.map +1 -0
  134. package/dest/hooks/index.js +1 -0
  135. package/dest/job_coordinator/job_coordinator.d.ts +75 -0
  136. package/dest/job_coordinator/job_coordinator.d.ts.map +1 -0
  137. package/dest/job_coordinator/job_coordinator.js +94 -0
  138. package/dest/logs/log_service.d.ts +21 -35
  139. package/dest/logs/log_service.d.ts.map +1 -1
  140. package/dest/logs/log_service.js +144 -215
  141. package/dest/messages/message_context_service.d.ts +17 -0
  142. package/dest/messages/message_context_service.d.ts.map +1 -0
  143. package/dest/messages/message_context_service.js +38 -0
  144. package/dest/notes/note_service.d.ts +34 -12
  145. package/dest/notes/note_service.d.ts.map +1 -1
  146. package/dest/notes/note_service.js +102 -82
  147. package/dest/notes_filter.d.ts +24 -0
  148. package/dest/notes_filter.d.ts.map +1 -0
  149. package/dest/notes_filter.js +4 -0
  150. package/dest/oracle_version.d.ts +4 -3
  151. package/dest/oracle_version.d.ts.map +1 -1
  152. package/dest/oracle_version.js +20 -9
  153. package/dest/private_kernel/batch_planner.d.ts +47 -0
  154. package/dest/private_kernel/batch_planner.d.ts.map +1 -0
  155. package/dest/private_kernel/batch_planner.js +104 -0
  156. package/dest/private_kernel/hints/compute_tx_expiration_timestamp.d.ts +4 -0
  157. package/dest/private_kernel/hints/compute_tx_expiration_timestamp.d.ts.map +1 -0
  158. package/dest/private_kernel/hints/{compute_tx_include_by_timestamp.js → compute_tx_expiration_timestamp.js} +12 -12
  159. package/dest/private_kernel/hints/index.d.ts +3 -3
  160. package/dest/private_kernel/hints/index.d.ts.map +1 -1
  161. package/dest/private_kernel/hints/index.js +2 -2
  162. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts +29 -0
  163. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts.map +1 -0
  164. package/dest/private_kernel/hints/{build_private_kernel_reset_private_inputs.js → private_kernel_reset_private_inputs_builder.js} +142 -75
  165. package/dest/private_kernel/hints/test_utils.d.ts +122 -0
  166. package/dest/private_kernel/hints/test_utils.d.ts.map +1 -0
  167. package/dest/private_kernel/hints/test_utils.js +202 -0
  168. package/dest/private_kernel/private_kernel_execution_prover.d.ts +7 -2
  169. package/dest/private_kernel/private_kernel_execution_prover.d.ts.map +1 -1
  170. package/dest/private_kernel/private_kernel_execution_prover.js +169 -69
  171. package/dest/private_kernel/private_kernel_oracle.d.ts +29 -29
  172. package/dest/private_kernel/private_kernel_oracle.d.ts.map +1 -1
  173. package/dest/private_kernel/private_kernel_oracle.js +96 -2
  174. package/dest/pxe.d.ts +136 -67
  175. package/dest/pxe.d.ts.map +1 -1
  176. package/dest/pxe.js +314 -231
  177. package/dest/storage/address_store/address_store.d.ts +11 -0
  178. package/dest/storage/address_store/address_store.d.ts.map +1 -0
  179. package/dest/storage/{address_data_provider/address_data_provider.js → address_store/address_store.js} +13 -12
  180. package/dest/storage/address_store/index.d.ts +2 -0
  181. package/dest/storage/address_store/index.d.ts.map +1 -0
  182. package/dest/storage/address_store/index.js +1 -0
  183. package/dest/storage/anchor_block_store/anchor_block_store.d.ts +17 -0
  184. package/dest/storage/anchor_block_store/anchor_block_store.d.ts.map +1 -0
  185. package/dest/storage/anchor_block_store/anchor_block_store.js +26 -0
  186. package/dest/storage/anchor_block_store/index.d.ts +2 -0
  187. package/dest/storage/anchor_block_store/index.d.ts.map +1 -0
  188. package/dest/storage/anchor_block_store/index.js +1 -0
  189. package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.d.ts +42 -0
  190. package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.d.ts.map +1 -0
  191. package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.js +93 -0
  192. package/dest/storage/backwards_compatibility_tests/schema_tests.d.ts +15 -0
  193. package/dest/storage/backwards_compatibility_tests/schema_tests.d.ts.map +1 -0
  194. package/dest/storage/backwards_compatibility_tests/schema_tests.js +591 -0
  195. package/dest/storage/backwards_compatibility_tests/store_spy.d.ts +19 -0
  196. package/dest/storage/backwards_compatibility_tests/store_spy.d.ts.map +1 -0
  197. package/dest/storage/backwards_compatibility_tests/store_spy.js +63 -0
  198. package/dest/storage/capsule_store/capsule_service.d.ts +21 -0
  199. package/dest/storage/capsule_store/capsule_service.d.ts.map +1 -0
  200. package/dest/storage/capsule_store/capsule_service.js +50 -0
  201. package/dest/storage/capsule_store/capsule_store.d.ts +72 -0
  202. package/dest/storage/capsule_store/capsule_store.d.ts.map +1 -0
  203. package/dest/storage/capsule_store/capsule_store.js +261 -0
  204. package/dest/storage/capsule_store/index.d.ts +3 -0
  205. package/dest/storage/capsule_store/index.d.ts.map +1 -0
  206. package/dest/storage/capsule_store/index.js +2 -0
  207. package/dest/storage/contract_store/contract_store.d.ts +93 -0
  208. package/dest/storage/contract_store/contract_store.d.ts.map +1 -0
  209. package/dest/storage/contract_store/contract_store.js +292 -0
  210. package/dest/storage/contract_store/index.d.ts +2 -0
  211. package/dest/storage/contract_store/index.d.ts.map +1 -0
  212. package/dest/storage/contract_store/index.js +1 -0
  213. package/dest/storage/{contract_data_provider → contract_store}/private_functions_tree.d.ts +1 -1
  214. package/dest/storage/contract_store/private_functions_tree.d.ts.map +1 -0
  215. package/dest/storage/index.d.ts +8 -8
  216. package/dest/storage/index.d.ts.map +1 -1
  217. package/dest/storage/index.js +7 -7
  218. package/dest/storage/metadata.d.ts +1 -1
  219. package/dest/storage/metadata.js +1 -1
  220. package/dest/storage/note_store/index.d.ts +3 -0
  221. package/dest/storage/note_store/index.d.ts.map +1 -0
  222. package/dest/storage/note_store/index.js +2 -0
  223. package/dest/storage/note_store/note_store.d.ts +83 -0
  224. package/dest/storage/note_store/note_store.d.ts.map +1 -0
  225. package/dest/storage/note_store/note_store.js +343 -0
  226. package/dest/storage/note_store/stored_note.d.ts +16 -0
  227. package/dest/storage/note_store/stored_note.d.ts.map +1 -0
  228. package/dest/storage/note_store/stored_note.js +43 -0
  229. package/dest/storage/open_pxe_stores.d.ts +33 -0
  230. package/dest/storage/open_pxe_stores.d.ts.map +1 -0
  231. package/dest/storage/open_pxe_stores.js +27 -0
  232. package/dest/storage/private_event_store/private_event_store.d.ts +91 -0
  233. package/dest/storage/private_event_store/private_event_store.d.ts.map +1 -0
  234. package/dest/storage/private_event_store/private_event_store.js +276 -0
  235. package/dest/storage/private_event_store/stored_private_event.d.ts +23 -0
  236. package/dest/storage/private_event_store/stored_private_event.d.ts.map +1 -0
  237. package/dest/storage/private_event_store/stored_private_event.js +56 -0
  238. package/dest/storage/tagging_store/index.d.ts +4 -0
  239. package/dest/storage/tagging_store/index.d.ts.map +1 -0
  240. package/dest/storage/tagging_store/index.js +3 -0
  241. package/dest/storage/tagging_store/recipient_tagging_store.d.ts +28 -0
  242. package/dest/storage/tagging_store/recipient_tagging_store.d.ts.map +1 -0
  243. package/dest/storage/tagging_store/recipient_tagging_store.js +111 -0
  244. package/dest/storage/tagging_store/sender_address_book_store.d.ts +14 -0
  245. package/dest/storage/tagging_store/sender_address_book_store.d.ts.map +1 -0
  246. package/dest/storage/tagging_store/sender_address_book_store.js +36 -0
  247. package/dest/storage/tagging_store/sender_tagging_store.d.ts +78 -0
  248. package/dest/storage/tagging_store/sender_tagging_store.d.ts.map +1 -0
  249. package/dest/storage/tagging_store/sender_tagging_store.js +374 -0
  250. package/dest/tagging/constants.d.ts +2 -2
  251. package/dest/tagging/constants.d.ts.map +1 -1
  252. package/dest/tagging/constants.js +10 -3
  253. package/dest/tagging/get_all_logs_by_tags.d.ts +48 -0
  254. package/dest/tagging/get_all_logs_by_tags.d.ts.map +1 -0
  255. package/dest/tagging/get_all_logs_by_tags.js +59 -0
  256. package/dest/tagging/index.d.ts +18 -5
  257. package/dest/tagging/index.d.ts.map +1 -1
  258. package/dest/tagging/index.js +16 -3
  259. package/dest/tagging/persist_sender_tagging_index_ranges.d.ts +29 -0
  260. package/dest/tagging/persist_sender_tagging_index_ranges.d.ts.map +1 -0
  261. package/dest/tagging/persist_sender_tagging_index_ranges.js +42 -0
  262. package/dest/tagging/recipient_sync/sync_tagged_private_logs.d.ts +56 -0
  263. package/dest/tagging/recipient_sync/sync_tagged_private_logs.d.ts.map +1 -0
  264. package/dest/tagging/recipient_sync/sync_tagged_private_logs.js +163 -0
  265. package/dest/tagging/recipient_sync/utils/find_highest_indexes.d.ts +3 -3
  266. package/dest/tagging/recipient_sync/utils/find_highest_indexes.d.ts.map +1 -1
  267. package/dest/tagging/recipient_sync/utils/find_highest_indexes.js +2 -2
  268. package/dest/tagging/reconcile_tagging_index_ranges.d.ts +36 -0
  269. package/dest/tagging/reconcile_tagging_index_ranges.d.ts.map +1 -0
  270. package/dest/tagging/reconcile_tagging_index_ranges.js +74 -0
  271. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts +16 -0
  272. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts.map +1 -0
  273. package/dest/tagging/{sync → sender_sync}/sync_sender_tagging_indexes.js +35 -34
  274. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts +17 -0
  275. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts.map +1 -0
  276. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.js +60 -0
  277. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts +19 -0
  278. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts.map +1 -0
  279. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.js +72 -0
  280. package/package.json +31 -19
  281. package/src/bin/check_oracle_version.ts +42 -31
  282. package/src/bin/index.ts +1 -0
  283. package/src/block_synchronizer/block_stream_source.ts +81 -0
  284. package/src/block_synchronizer/block_synchronizer.ts +123 -48
  285. package/src/config/index.ts +21 -1
  286. package/src/config/package_info.ts +1 -1
  287. package/src/contract_function_simulator/benchmarked_node.ts +103 -0
  288. package/src/contract_function_simulator/contract_function_simulator.ts +431 -161
  289. package/src/contract_function_simulator/ephemeral_array_service.ts +110 -0
  290. package/src/contract_function_simulator/execution_note_cache.ts +44 -25
  291. package/src/contract_function_simulator/execution_tagging_index_cache.ts +19 -18
  292. package/src/contract_function_simulator/index.ts +4 -1
  293. package/src/contract_function_simulator/noir-structs/bounded_vec.ts +55 -0
  294. package/src/contract_function_simulator/noir-structs/event_validation_request.ts +15 -10
  295. package/src/contract_function_simulator/noir-structs/log_retrieval_request.ts +36 -3
  296. package/src/contract_function_simulator/noir-structs/log_retrieval_response.ts +2 -5
  297. package/src/contract_function_simulator/noir-structs/note_validation_request.ts +6 -11
  298. package/src/contract_function_simulator/noir-structs/option.ts +69 -0
  299. package/src/contract_function_simulator/noir-structs/utility_context.ts +6 -25
  300. package/src/contract_function_simulator/oracle/interfaces.ts +93 -70
  301. package/src/contract_function_simulator/oracle/note_packing_utils.ts +13 -13
  302. package/src/contract_function_simulator/oracle/oracle.ts +567 -461
  303. package/src/contract_function_simulator/oracle/oracle_registry.ts +904 -0
  304. package/src/contract_function_simulator/oracle/private_execution.ts +5 -73
  305. package/src/contract_function_simulator/oracle/private_execution_oracle.ts +215 -239
  306. package/src/contract_function_simulator/oracle/utility_execution_oracle.ts +668 -261
  307. package/src/contract_function_simulator/pick_notes.ts +22 -3
  308. package/src/contract_function_simulator/proxied_contract_data_source.ts +47 -70
  309. package/src/contract_logging.ts +52 -0
  310. package/src/contract_sync/contract_sync_service.ts +189 -0
  311. package/src/contract_sync/helpers.ts +86 -0
  312. package/src/debug/pxe_debug_utils.ts +57 -20
  313. package/src/entrypoints/client/bundle/index.ts +2 -0
  314. package/src/entrypoints/client/bundle/utils.ts +31 -19
  315. package/src/entrypoints/client/lazy/index.ts +2 -0
  316. package/src/entrypoints/client/lazy/utils.ts +33 -21
  317. package/src/entrypoints/pxe_creation_options.ts +18 -2
  318. package/src/entrypoints/server/index.ts +5 -1
  319. package/src/entrypoints/server/utils.ts +46 -45
  320. package/src/error_enriching.ts +7 -15
  321. package/src/events/event_service.ts +83 -41
  322. package/src/events/private_event_filter_validator.ts +24 -6
  323. package/src/hooks/authorize_utility_call.ts +44 -0
  324. package/src/hooks/execution_hooks.ts +48 -0
  325. package/src/hooks/index.ts +7 -0
  326. package/src/job_coordinator/job_coordinator.ts +150 -0
  327. package/src/logs/log_service.ts +181 -313
  328. package/src/messages/message_context_service.ts +45 -0
  329. package/src/notes/note_service.ts +140 -110
  330. package/src/notes_filter.ts +24 -0
  331. package/src/oracle_version.ts +20 -9
  332. package/src/private_kernel/batch_planner.ts +169 -0
  333. package/src/private_kernel/hints/{compute_tx_include_by_timestamp.ts → compute_tx_expiration_timestamp.ts} +13 -13
  334. package/src/private_kernel/hints/index.ts +2 -2
  335. package/src/private_kernel/hints/{build_private_kernel_reset_private_inputs.ts → private_kernel_reset_private_inputs_builder.ts} +197 -139
  336. package/src/private_kernel/hints/test_utils.ts +318 -0
  337. package/src/private_kernel/private_kernel_execution_prover.ts +262 -96
  338. package/src/private_kernel/private_kernel_oracle.ts +129 -39
  339. package/src/pxe.ts +552 -310
  340. package/src/storage/{address_data_provider/address_data_provider.ts → address_store/address_store.ts} +16 -16
  341. package/src/storage/address_store/index.ts +1 -0
  342. package/src/storage/{anchor_block_data_provider/anchor_block_data_provider.ts → anchor_block_store/anchor_block_store.ts} +10 -2
  343. package/src/storage/anchor_block_store/index.ts +1 -0
  344. package/src/storage/backwards_compatibility_tests/__snapshots__/AddressStore.json +22 -0
  345. package/src/storage/backwards_compatibility_tests/__snapshots__/AnchorBlockStore.json +3 -0
  346. package/src/storage/backwards_compatibility_tests/__snapshots__/CapsuleStore.json +16 -0
  347. package/src/storage/backwards_compatibility_tests/__snapshots__/ContractStore.json +28 -0
  348. package/src/storage/backwards_compatibility_tests/__snapshots__/KeyStore.json +52 -0
  349. package/src/storage/backwards_compatibility_tests/__snapshots__/L2TipsKVStore.json +46 -0
  350. package/src/storage/backwards_compatibility_tests/__snapshots__/NoteStore.json +36 -0
  351. package/src/storage/backwards_compatibility_tests/__snapshots__/PrivateEventStore.json +44 -0
  352. package/src/storage/backwards_compatibility_tests/__snapshots__/RecipientTaggingStore.json +18 -0
  353. package/src/storage/backwards_compatibility_tests/__snapshots__/SenderAddressBookStore.json +16 -0
  354. package/src/storage/backwards_compatibility_tests/__snapshots__/SenderTaggingStore.json +22 -0
  355. package/src/storage/backwards_compatibility_tests/__snapshots__/opened_stores.json +97 -0
  356. package/src/storage/backwards_compatibility_tests/kv_store_snapshot.ts +122 -0
  357. package/src/storage/backwards_compatibility_tests/schema_tests.ts +712 -0
  358. package/src/storage/backwards_compatibility_tests/store_spy.ts +73 -0
  359. package/src/storage/capsule_store/capsule_service.ts +90 -0
  360. package/src/storage/capsule_store/capsule_store.ts +333 -0
  361. package/src/storage/capsule_store/index.ts +2 -0
  362. package/src/storage/contract_store/contract_store.ts +408 -0
  363. package/src/storage/contract_store/index.ts +1 -0
  364. package/src/storage/index.ts +7 -7
  365. package/src/storage/metadata.ts +1 -1
  366. package/src/storage/note_store/index.ts +2 -0
  367. package/src/storage/note_store/note_store.ts +415 -0
  368. package/src/storage/note_store/stored_note.ts +48 -0
  369. package/src/storage/open_pxe_stores.ts +49 -0
  370. package/src/storage/private_event_store/private_event_store.ts +388 -0
  371. package/src/storage/private_event_store/stored_private_event.ts +73 -0
  372. package/src/storage/tagging_store/index.ts +3 -0
  373. package/src/storage/tagging_store/recipient_tagging_store.ts +139 -0
  374. package/src/storage/tagging_store/sender_address_book_store.ts +48 -0
  375. package/src/storage/tagging_store/sender_tagging_store.ts +476 -0
  376. package/src/tagging/constants.ts +10 -3
  377. package/src/tagging/get_all_logs_by_tags.ts +120 -0
  378. package/src/tagging/index.ts +20 -4
  379. package/src/tagging/persist_sender_tagging_index_ranges.ts +57 -0
  380. package/src/tagging/recipient_sync/sync_tagged_private_logs.ts +240 -0
  381. package/src/tagging/recipient_sync/utils/find_highest_indexes.ts +4 -4
  382. package/src/tagging/reconcile_tagging_index_ranges.ts +102 -0
  383. package/src/tagging/sender_sync/sync_sender_tagging_indexes.ts +134 -0
  384. package/src/tagging/sender_sync/utils/get_status_change_of_pending.ts +66 -0
  385. package/src/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.ts +84 -0
  386. package/dest/contract_function_simulator/proxied_node.d.ts +0 -9
  387. package/dest/contract_function_simulator/proxied_node.d.ts.map +0 -1
  388. package/dest/contract_function_simulator/proxied_node.js +0 -27
  389. package/dest/private_kernel/hints/build_private_kernel_reset_private_inputs.d.ts +0 -28
  390. package/dest/private_kernel/hints/build_private_kernel_reset_private_inputs.d.ts.map +0 -1
  391. package/dest/private_kernel/hints/compute_tx_include_by_timestamp.d.ts +0 -4
  392. package/dest/private_kernel/hints/compute_tx_include_by_timestamp.d.ts.map +0 -1
  393. package/dest/private_kernel/private_kernel_oracle_impl.d.ts +0 -46
  394. package/dest/private_kernel/private_kernel_oracle_impl.d.ts.map +0 -1
  395. package/dest/private_kernel/private_kernel_oracle_impl.js +0 -86
  396. package/dest/public_storage/public_storage_service.d.ts +0 -24
  397. package/dest/public_storage/public_storage_service.d.ts.map +0 -1
  398. package/dest/public_storage/public_storage_service.js +0 -26
  399. package/dest/storage/address_data_provider/address_data_provider.d.ts +0 -11
  400. package/dest/storage/address_data_provider/address_data_provider.d.ts.map +0 -1
  401. package/dest/storage/address_data_provider/index.d.ts +0 -2
  402. package/dest/storage/address_data_provider/index.d.ts.map +0 -1
  403. package/dest/storage/address_data_provider/index.js +0 -1
  404. package/dest/storage/anchor_block_data_provider/anchor_block_data_provider.d.ts +0 -9
  405. package/dest/storage/anchor_block_data_provider/anchor_block_data_provider.d.ts.map +0 -1
  406. package/dest/storage/anchor_block_data_provider/anchor_block_data_provider.js +0 -19
  407. package/dest/storage/anchor_block_data_provider/index.d.ts +0 -2
  408. package/dest/storage/anchor_block_data_provider/index.d.ts.map +0 -1
  409. package/dest/storage/anchor_block_data_provider/index.js +0 -1
  410. package/dest/storage/capsule_data_provider/capsule_data_provider.d.ts +0 -57
  411. package/dest/storage/capsule_data_provider/capsule_data_provider.d.ts.map +0 -1
  412. package/dest/storage/capsule_data_provider/capsule_data_provider.js +0 -146
  413. package/dest/storage/capsule_data_provider/index.d.ts +0 -2
  414. package/dest/storage/capsule_data_provider/index.d.ts.map +0 -1
  415. package/dest/storage/capsule_data_provider/index.js +0 -1
  416. package/dest/storage/contract_data_provider/contract_data_provider.d.ts +0 -66
  417. package/dest/storage/contract_data_provider/contract_data_provider.d.ts.map +0 -1
  418. package/dest/storage/contract_data_provider/contract_data_provider.js +0 -224
  419. package/dest/storage/contract_data_provider/index.d.ts +0 -2
  420. package/dest/storage/contract_data_provider/index.d.ts.map +0 -1
  421. package/dest/storage/contract_data_provider/index.js +0 -1
  422. package/dest/storage/contract_data_provider/private_functions_tree.d.ts.map +0 -1
  423. package/dest/storage/note_data_provider/index.d.ts +0 -3
  424. package/dest/storage/note_data_provider/index.d.ts.map +0 -1
  425. package/dest/storage/note_data_provider/index.js +0 -2
  426. package/dest/storage/note_data_provider/note_data_provider.d.ts +0 -84
  427. package/dest/storage/note_data_provider/note_data_provider.d.ts.map +0 -1
  428. package/dest/storage/note_data_provider/note_data_provider.js +0 -322
  429. package/dest/storage/private_event_data_provider/private_event_data_provider.d.ts +0 -51
  430. package/dest/storage/private_event_data_provider/private_event_data_provider.d.ts.map +0 -1
  431. package/dest/storage/private_event_data_provider/private_event_data_provider.js +0 -115
  432. package/dest/storage/tagging_data_provider/index.d.ts +0 -3
  433. package/dest/storage/tagging_data_provider/index.d.ts.map +0 -1
  434. package/dest/storage/tagging_data_provider/index.js +0 -2
  435. package/dest/storage/tagging_data_provider/recipient_tagging_data_provider.d.ts +0 -31
  436. package/dest/storage/tagging_data_provider/recipient_tagging_data_provider.d.ts.map +0 -1
  437. package/dest/storage/tagging_data_provider/recipient_tagging_data_provider.js +0 -65
  438. package/dest/storage/tagging_data_provider/sender_tagging_data_provider.d.ts +0 -67
  439. package/dest/storage/tagging_data_provider/sender_tagging_data_provider.d.ts.map +0 -1
  440. package/dest/storage/tagging_data_provider/sender_tagging_data_provider.js +0 -196
  441. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts +0 -14
  442. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts.map +0 -1
  443. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.js +0 -99
  444. package/dest/tagging/recipient_sync/new_recipient_tagging_data_provider.d.ts +0 -21
  445. package/dest/tagging/recipient_sync/new_recipient_tagging_data_provider.d.ts.map +0 -1
  446. package/dest/tagging/recipient_sync/new_recipient_tagging_data_provider.js +0 -42
  447. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts +0 -14
  448. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts.map +0 -1
  449. package/dest/tagging/recipient_sync/utils/load_logs_for_range.js +0 -29
  450. package/dest/tagging/sync/sync_sender_tagging_indexes.d.ts +0 -21
  451. package/dest/tagging/sync/sync_sender_tagging_indexes.d.ts.map +0 -1
  452. package/dest/tagging/sync/utils/get_status_change_of_pending.d.ts +0 -11
  453. package/dest/tagging/sync/utils/get_status_change_of_pending.d.ts.map +0 -1
  454. package/dest/tagging/sync/utils/get_status_change_of_pending.js +0 -32
  455. package/dest/tagging/sync/utils/load_and_store_new_tagging_indexes.d.ts +0 -18
  456. package/dest/tagging/sync/utils/load_and_store_new_tagging_indexes.d.ts.map +0 -1
  457. package/dest/tagging/sync/utils/load_and_store_new_tagging_indexes.js +0 -55
  458. package/dest/tagging/utils.d.ts +0 -18
  459. package/dest/tagging/utils.d.ts.map +0 -1
  460. package/dest/tagging/utils.js +0 -25
  461. package/dest/tree_membership/tree_membership_service.d.ts +0 -52
  462. package/dest/tree_membership/tree_membership_service.d.ts.map +0 -1
  463. package/dest/tree_membership/tree_membership_service.js +0 -84
  464. package/src/contract_function_simulator/proxied_node.ts +0 -33
  465. package/src/private_kernel/private_kernel_oracle_impl.ts +0 -133
  466. package/src/public_storage/public_storage_service.ts +0 -33
  467. package/src/storage/address_data_provider/index.ts +0 -1
  468. package/src/storage/anchor_block_data_provider/index.ts +0 -1
  469. package/src/storage/capsule_data_provider/capsule_data_provider.ts +0 -179
  470. package/src/storage/capsule_data_provider/index.ts +0 -1
  471. package/src/storage/contract_data_provider/contract_data_provider.ts +0 -319
  472. package/src/storage/contract_data_provider/index.ts +0 -1
  473. package/src/storage/note_data_provider/index.ts +0 -2
  474. package/src/storage/note_data_provider/note_data_provider.ts +0 -412
  475. package/src/storage/private_event_data_provider/private_event_data_provider.ts +0 -162
  476. package/src/storage/tagging_data_provider/index.ts +0 -2
  477. package/src/storage/tagging_data_provider/recipient_tagging_data_provider.ts +0 -86
  478. package/src/storage/tagging_data_provider/sender_tagging_data_provider.ts +0 -244
  479. package/src/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.ts +0 -129
  480. package/src/tagging/recipient_sync/new_recipient_tagging_data_provider.ts +0 -53
  481. package/src/tagging/recipient_sync/utils/load_logs_for_range.ts +0 -43
  482. package/src/tagging/sync/sync_sender_tagging_indexes.ts +0 -112
  483. package/src/tagging/sync/utils/get_status_change_of_pending.ts +0 -44
  484. package/src/tagging/sync/utils/load_and_store_new_tagging_indexes.ts +0 -72
  485. package/src/tagging/utils.ts +0 -32
  486. package/src/tree_membership/tree_membership_service.ts +0 -112
  487. /package/dest/storage/{contract_data_provider → contract_store}/private_functions_tree.js +0 -0
  488. /package/src/storage/{contract_data_provider → contract_store}/private_functions_tree.ts +0 -0
@@ -1,14 +1,15 @@
1
1
  import { BBBundlePrivateKernelProver } from '@aztec/bb-prover/client/bundle';
2
- import { randomBytes } from '@aztec/foundation/crypto/random';
3
2
  import { createLogger } from '@aztec/foundation/log';
4
3
  import { createStore } from '@aztec/kv-store/indexeddb';
5
4
  import { BundledProtocolContractsProvider } from '@aztec/protocol-contracts/providers/bundle';
6
5
  import { WASMSimulator } from '@aztec/simulator/client';
6
+ import { getStandardMultiCallEntrypoint } from '@aztec/standard-contracts/multi-call-entrypoint';
7
7
  import type { AztecNode } from '@aztec/stdlib/interfaces/client';
8
8
 
9
9
  import type { PXEConfig } from '../../../config/index.js';
10
10
  import { PXE } from '../../../pxe.js';
11
- import type { PXECreationOptions } from '../../pxe_creation_options.js';
11
+ import { PXE_DATA_SCHEMA_VERSION } from '../../../storage/metadata.js';
12
+ import { type PXECreationOptions, isPrivateKernelProver } from '../../pxe_creation_options.js';
12
13
 
13
14
  /**
14
15
  * Create and start an PXE instance with the given AztecNode.
@@ -25,34 +26,45 @@ export async function createPXE(
25
26
  config: PXEConfig,
26
27
  options: PXECreationOptions = { loggers: {} },
27
28
  ) {
28
- const logSuffix =
29
- typeof options.useLogSuffix === 'boolean'
30
- ? options.useLogSuffix
31
- ? randomBytes(3).toString('hex')
32
- : undefined
33
- : options.useLogSuffix;
34
-
29
+ const actor = options.loggerActorLabel;
35
30
  const loggers = options.loggers ?? {};
36
31
 
37
- const l1Contracts = await aztecNode.getL1ContractAddresses();
32
+ const l1ContractAddresses = await aztecNode.getL1ContractAddresses();
38
33
  const configWithContracts = {
39
34
  ...config,
40
- l1Contracts,
35
+ ...l1ContractAddresses,
41
36
  } as PXEConfig;
42
37
 
43
- const storeLogger = loggers.store ? loggers.store : createLogger('pxe:data:idb' + (logSuffix ? `:${logSuffix}` : ''));
38
+ const storeLogger = loggers.store ?? createLogger('pxe:data:idb', { actor });
44
39
 
45
- const store = options.store ?? (await createStore('pxe_data', configWithContracts, storeLogger));
40
+ const store =
41
+ options.store ?? (await createStore('pxe_data', configWithContracts, PXE_DATA_SCHEMA_VERSION, storeLogger));
46
42
 
47
43
  const simulator = options.simulator ?? new WASMSimulator();
48
- const proverLogger = loggers.prover
49
- ? loggers.prover
50
- : createLogger('pxe:bb:wasm:bundle' + (logSuffix ? `:${logSuffix}` : ''));
44
+ const proverLogger = loggers.prover ?? createLogger('pxe:bb:wasm:bundle', { actor });
51
45
 
52
- const prover = options.prover ?? new BBBundlePrivateKernelProver(simulator, proverLogger);
46
+ let prover;
47
+ if (isPrivateKernelProver(options.proverOrOptions)) {
48
+ prover = options.proverOrOptions;
49
+ } else {
50
+ prover = new BBBundlePrivateKernelProver(simulator, { ...options.proverOrOptions, logger: proverLogger });
51
+ }
53
52
  const protocolContractsProvider = new BundledProtocolContractsProvider();
53
+ const preloadedContractsProvider = options.preloadedContractsProvider ?? {
54
+ getPreloadedContracts: async () => [await getStandardMultiCallEntrypoint()],
55
+ };
54
56
 
55
- const pxeLogger = loggers.pxe ? loggers.pxe : createLogger('pxe:service' + (logSuffix ? `:${logSuffix}` : ''));
56
- const pxe = await PXE.create(aztecNode, store, prover, simulator, protocolContractsProvider, config, pxeLogger);
57
+ const pxeLogger = loggers.pxe ?? createLogger('pxe:service', { actor });
58
+ const pxe = await PXE.create({
59
+ node: aztecNode,
60
+ store,
61
+ proofCreator: prover,
62
+ simulator,
63
+ protocolContractsProvider,
64
+ preloadedContractsProvider,
65
+ config,
66
+ loggerOrSuffix: pxeLogger,
67
+ hooks: options.hooks,
68
+ });
57
69
  return pxe;
58
70
  }
@@ -1,6 +1,8 @@
1
+ export * from '../../../notes_filter.js';
1
2
  export * from '../../../pxe.js';
2
3
  export * from '../../../config/index.js';
3
4
  export * from '../../../storage/index.js';
4
5
  export * from '../../../error_enriching.js';
6
+ export * from '../../../contract_logging.js';
5
7
  export * from './utils.js';
6
8
  export { type PXECreationOptions } from '../../pxe_creation_options.js';
@@ -1,14 +1,15 @@
1
1
  import { BBLazyPrivateKernelProver } from '@aztec/bb-prover/client/lazy';
2
- import { randomBytes } from '@aztec/foundation/crypto/random';
3
2
  import { createLogger } from '@aztec/foundation/log';
4
3
  import { createStore } from '@aztec/kv-store/indexeddb';
5
4
  import { LazyProtocolContractsProvider } from '@aztec/protocol-contracts/providers/lazy';
6
5
  import { WASMSimulator } from '@aztec/simulator/client';
6
+ import { getStandardMultiCallEntrypoint } from '@aztec/standard-contracts/multi-call-entrypoint/lazy';
7
7
  import type { AztecNode } from '@aztec/stdlib/interfaces/client';
8
8
 
9
9
  import type { PXEConfig } from '../../../config/index.js';
10
10
  import { PXE } from '../../../pxe.js';
11
- import type { PXECreationOptions } from '../../pxe_creation_options.js';
11
+ import { PXE_DATA_SCHEMA_VERSION } from '../../../storage/metadata.js';
12
+ import { type PXECreationOptions, isPrivateKernelProver } from '../../pxe_creation_options.js';
12
13
 
13
14
  /**
14
15
  * Create and start an PXE instance with the given AztecNode.
@@ -16,7 +17,7 @@ import type { PXECreationOptions } from '../../pxe_creation_options.js';
16
17
  *
17
18
  * @param aztecNode - The AztecNode instance to be used by the server.
18
19
  * @param config - The PXE Config to use
19
- * @param
20
+ * @param options - (Optional) Optional information for creating an PXE.
20
21
  * @returns A Promise that resolves to the started PXE instance.
21
22
  */
22
23
  export async function createPXE(
@@ -24,35 +25,46 @@ export async function createPXE(
24
25
  config: PXEConfig,
25
26
  options: PXECreationOptions = { loggers: {} },
26
27
  ) {
27
- const logSuffix =
28
- typeof options.useLogSuffix === 'boolean'
29
- ? options.useLogSuffix
30
- ? randomBytes(3).toString('hex')
31
- : undefined
32
- : options.useLogSuffix;
33
-
34
- const l1Contracts = await aztecNode.getL1ContractAddresses();
28
+ const actor = options.loggerActorLabel;
29
+
30
+ const l1ContractAddresses = await aztecNode.getL1ContractAddresses();
35
31
  const configWithContracts = {
36
32
  ...config,
37
- l1Contracts,
33
+ ...l1ContractAddresses,
38
34
  } as PXEConfig;
39
35
 
40
36
  const loggers = options.loggers ?? {};
41
37
 
42
- const storeLogger = loggers.store ? loggers.store : createLogger('pxe:data:idb' + (logSuffix ? `:${logSuffix}` : ''));
38
+ const storeLogger = loggers.store ?? createLogger('pxe:data:idb', { actor });
43
39
 
44
- const store = options.store ?? (await createStore('pxe_data', configWithContracts, storeLogger));
40
+ const store =
41
+ options.store ?? (await createStore('pxe_data', configWithContracts, PXE_DATA_SCHEMA_VERSION, storeLogger));
45
42
 
46
43
  const simulator = options.simulator ?? new WASMSimulator();
47
- const proverLogger = loggers.prover
48
- ? loggers.prover
49
- : createLogger('pxe:bb:wasm:bundle' + (logSuffix ? `:${logSuffix}` : ''));
50
-
51
- const prover = options.prover ?? new BBLazyPrivateKernelProver(simulator, proverLogger);
44
+ const proverLogger = loggers.prover ?? createLogger('pxe:bb:wasm:bundle', { actor });
52
45
 
46
+ let prover;
47
+ if (isPrivateKernelProver(options.proverOrOptions)) {
48
+ prover = options.proverOrOptions;
49
+ } else {
50
+ prover = new BBLazyPrivateKernelProver(simulator, { ...options.proverOrOptions, logger: proverLogger });
51
+ }
53
52
  const protocolContractsProvider = new LazyProtocolContractsProvider();
53
+ const preloadedContractsProvider = options.preloadedContractsProvider ?? {
54
+ getPreloadedContracts: async () => [await getStandardMultiCallEntrypoint()],
55
+ };
54
56
 
55
- const pxeLogger = loggers.pxe ? loggers.pxe : createLogger('pxe:service' + (logSuffix ? `:${logSuffix}` : ''));
56
- const pxe = await PXE.create(aztecNode, store, prover, simulator, protocolContractsProvider, config, pxeLogger);
57
+ const pxeLogger = loggers.pxe ?? createLogger('pxe:service', { actor });
58
+ const pxe = await PXE.create({
59
+ node: aztecNode,
60
+ store,
61
+ proofCreator: prover,
62
+ simulator,
63
+ protocolContractsProvider,
64
+ preloadedContractsProvider,
65
+ config,
66
+ loggerOrSuffix: pxeLogger,
67
+ hooks: options.hooks,
68
+ });
57
69
  return pxe;
58
70
  }
@@ -1,12 +1,28 @@
1
+ import type { BBPrivateKernelProverOptions } from '@aztec/bb-prover/client';
1
2
  import type { Logger } from '@aztec/foundation/log';
2
3
  import type { AztecAsyncKVStore } from '@aztec/kv-store';
3
4
  import type { CircuitSimulator } from '@aztec/simulator/client';
4
5
  import type { PrivateKernelProver } from '@aztec/stdlib/interfaces/client';
5
6
 
7
+ import type { ExecutionHooks } from '../hooks/index.js';
8
+ import type { PreloadedContractsProvider } from '../pxe.js';
9
+
6
10
  export type PXECreationOptions = {
7
11
  loggers?: { store?: Logger; pxe?: Logger; prover?: Logger };
8
- useLogSuffix?: boolean | string;
9
- prover?: PrivateKernelProver;
12
+ /** Actor label to include in log output (e.g., 'pxe-0', 'pxe-test'). */
13
+ loggerActorLabel?: string;
14
+ proverOrOptions?: PrivateKernelProver | BBPrivateKernelProverOptions;
10
15
  store?: AztecAsyncKVStore;
11
16
  simulator?: CircuitSimulator;
17
+ /** Optional hooks to observe and influence contract execution. */
18
+ hooks?: ExecutionHooks;
19
+ /** Contracts to preload; used directly in place of the PXE's default (the standard multi-call entrypoint). */
20
+ preloadedContractsProvider?: PreloadedContractsProvider;
12
21
  };
22
+
23
+ /** Checks if the given value implements the PrivateKernelProver interface via duck-typing. */
24
+ export function isPrivateKernelProver(value: unknown): value is PrivateKernelProver {
25
+ return (
26
+ typeof value === 'object' && value !== null && typeof (value as PrivateKernelProver).createChonkProof === 'function'
27
+ );
28
+ }
@@ -1,8 +1,12 @@
1
+ export * from '../../notes_filter.js';
1
2
  export * from '../../pxe.js';
3
+ export * from '../../hooks/index.js';
2
4
  export * from '../../config/index.js';
3
5
  export * from '../../error_enriching.js';
4
6
  export * from '../../storage/index.js';
5
7
  export * from './utils.js';
6
8
  export { NoteService } from '../../notes/note_service.js';
7
- export { ORACLE_VERSION } from '../../oracle_version.js';
9
+ export { ORACLE_VERSION_MAJOR, ORACLE_VERSION_MINOR } from '../../oracle_version.js';
8
10
  export { type PXECreationOptions } from '../pxe_creation_options.js';
11
+ export { JobCoordinator } from '../../job_coordinator/job_coordinator.js';
12
+ export { ContractSyncService } from '../../contract_sync/contract_sync_service.js';
@@ -1,79 +1,80 @@
1
1
  import { BBBundlePrivateKernelProver } from '@aztec/bb-prover/client/bundle';
2
- import { randomBytes } from '@aztec/foundation/crypto/random';
3
- import { type Logger, createLogger } from '@aztec/foundation/log';
2
+ import type { L1ContractAddresses } from '@aztec/ethereum/l1-contract-addresses';
3
+ import { createLogger } from '@aztec/foundation/log';
4
+ import { createStore } from '@aztec/kv-store/lmdb-v2';
4
5
  import { BundledProtocolContractsProvider } from '@aztec/protocol-contracts/providers/bundle';
5
- import {
6
- type CircuitSimulator,
7
- MemoryCircuitRecorder,
8
- SimulatorRecorderWrapper,
9
- WASMSimulator,
10
- } from '@aztec/simulator/client';
6
+ import { MemoryCircuitRecorder, SimulatorRecorderWrapper, WASMSimulator } from '@aztec/simulator/client';
11
7
  import { FileCircuitRecorder } from '@aztec/simulator/testing';
8
+ import { getStandardMultiCallEntrypoint } from '@aztec/standard-contracts/multi-call-entrypoint';
12
9
  import type { AztecNode } from '@aztec/stdlib/interfaces/client';
13
10
 
14
11
  import type { PXEConfig } from '../../config/index.js';
15
12
  import { PXE } from '../../pxe.js';
16
13
  import { PXE_DATA_SCHEMA_VERSION } from '../../storage/index.js';
17
- import type { PXECreationOptions } from '../pxe_creation_options.js';
14
+ import { type PXECreationOptions, isPrivateKernelProver } from '../pxe_creation_options.js';
18
15
 
19
- type PXEConfigWithoutDefaults = Omit<PXEConfig, 'l1Contracts' | 'l1ChainId' | 'l2BlockBatchSize' | 'rollupVersion'>;
16
+ type PXEConfigWithoutDefaults = Omit<
17
+ PXEConfig,
18
+ 'l1ChainId' | 'l2BlockBatchSize' | 'rollupVersion' | keyof L1ContractAddresses
19
+ >;
20
20
 
21
21
  export async function createPXE(
22
22
  aztecNode: AztecNode,
23
23
  config: PXEConfigWithoutDefaults,
24
24
  options: PXECreationOptions = { loggers: {} },
25
25
  ) {
26
+ const actor = options.loggerActorLabel;
27
+ const recorderLogger = createLogger('simulator:acvm:recording', { actor });
26
28
  const recorder = process.env.CIRCUIT_RECORD_DIR
27
- ? new FileCircuitRecorder(process.env.CIRCUIT_RECORD_DIR)
28
- : new MemoryCircuitRecorder();
29
- const simulator = new SimulatorRecorderWrapper(new WASMSimulator(), recorder);
30
-
31
- const logSuffix =
32
- typeof options.useLogSuffix === 'boolean'
33
- ? options.useLogSuffix
34
- ? randomBytes(3).toString('hex')
35
- : undefined
36
- : options.useLogSuffix;
29
+ ? new FileCircuitRecorder(process.env.CIRCUIT_RECORD_DIR, recorderLogger)
30
+ : new MemoryCircuitRecorder(recorderLogger);
31
+ const simulatorLogger = createLogger('wasm-simulator', { actor });
32
+ const simulator = new SimulatorRecorderWrapper(new WASMSimulator(simulatorLogger), recorder);
37
33
  const loggers = options.loggers ?? {};
38
34
 
39
- const { l1ChainId, l1ContractAddresses: l1Contracts, rollupVersion } = await aztecNode.getNodeInfo();
35
+ const { l1ChainId, l1ContractAddresses, rollupVersion } = await aztecNode.getNodeInfo();
40
36
  const configWithContracts: PXEConfig = {
41
37
  ...config,
42
- l1Contracts,
38
+ ...l1ContractAddresses,
43
39
  l1ChainId,
44
40
  rollupVersion,
45
41
  l2BlockBatchSize: 50,
46
42
  };
47
43
 
48
44
  if (!options.store) {
49
- // TODO once https://github.com/AztecProtocol/aztec-packages/issues/13656 is fixed, we can remove this and always
50
- // import the lmdb-v2 version
51
- const { createStore } = await import('@aztec/kv-store/lmdb-v2');
52
- const storeLogger = loggers.store
53
- ? loggers.store
54
- : createLogger('pxe:data:lmdb' + (logSuffix ? `:${logSuffix}` : ''));
55
- options.store = await createStore('pxe_data', PXE_DATA_SCHEMA_VERSION, configWithContracts, storeLogger);
45
+ const storeLogger = loggers.store ?? createLogger('pxe:data:lmdb', { actor });
46
+ options.store = await createStore(
47
+ 'pxe_data',
48
+ PXE_DATA_SCHEMA_VERSION,
49
+ configWithContracts,
50
+ storeLogger.getBindings(),
51
+ );
52
+ }
53
+ const proverLogger = loggers.prover ?? createLogger('pxe:bb:native', { actor });
54
+
55
+ let prover;
56
+ if (isPrivateKernelProver(options.proverOrOptions)) {
57
+ prover = options.proverOrOptions;
58
+ } else {
59
+ prover = new BBBundlePrivateKernelProver(simulator, { ...options.proverOrOptions, logger: proverLogger });
56
60
  }
57
- const proverLogger = loggers.prover
58
- ? loggers.prover
59
- : createLogger('pxe:bb:native' + (logSuffix ? `:${logSuffix}` : ''));
60
61
 
61
- const prover = options.prover ?? createProver(simulator, proverLogger);
62
62
  const protocolContractsProvider = new BundledProtocolContractsProvider();
63
+ const preloadedContractsProvider = options.preloadedContractsProvider ?? {
64
+ getPreloadedContracts: async () => [await getStandardMultiCallEntrypoint()],
65
+ };
63
66
 
64
- const pxeLogger = loggers.pxe ? loggers.pxe : createLogger('pxe:service' + (logSuffix ? `:${logSuffix}` : ''));
65
- const pxe = await PXE.create(
66
- aztecNode,
67
- options.store,
68
- prover,
67
+ const pxeLogger = loggers.pxe ?? createLogger('pxe:service', { actor });
68
+ const pxe = await PXE.create({
69
+ node: aztecNode,
70
+ store: options.store,
71
+ proofCreator: prover,
69
72
  simulator,
70
73
  protocolContractsProvider,
71
- configWithContracts,
72
- pxeLogger,
73
- );
74
+ preloadedContractsProvider,
75
+ config: configWithContracts,
76
+ loggerOrSuffix: pxeLogger,
77
+ hooks: options.hooks,
78
+ });
74
79
  return pxe;
75
80
  }
76
-
77
- function createProver(simulator: CircuitSimulator, logger?: Logger) {
78
- return new BBBundlePrivateKernelProver(simulator, logger);
79
- }
@@ -4,18 +4,14 @@ import { FunctionSelector } from '@aztec/stdlib/abi';
4
4
  import { AztecAddress } from '@aztec/stdlib/aztec-address';
5
5
  import { type SimulationError, isNoirCallStackUnresolved } from '@aztec/stdlib/errors';
6
6
 
7
- import type { ContractDataProvider } from './storage/contract_data_provider/contract_data_provider.js';
7
+ import type { ContractStore } from './storage/contract_store/contract_store.js';
8
8
 
9
9
  /**
10
10
  * Adds contract and function names to a simulation error, if they
11
11
  * can be found in the PXE database
12
12
  * @param err - The error to enrich.
13
13
  */
14
- export async function enrichSimulationError(
15
- err: SimulationError,
16
- contractDataProvider: ContractDataProvider,
17
- logger: Logger,
18
- ) {
14
+ export async function enrichSimulationError(err: SimulationError, contractStore: ContractStore, logger: Logger) {
19
15
  // Maps contract addresses to the set of function selectors that were in error.
20
16
  // Map and Set do reference equality for their keys instead of value equality, so we store the string
21
17
  // representation to get e.g. different contract address objects with the same address value to match.
@@ -34,7 +30,7 @@ export async function enrichSimulationError(
34
30
  await Promise.all(
35
31
  [...mentionedFunctions.entries()].map(async ([contractAddress, fnSelectors]) => {
36
32
  const parsedContractAddress = AztecAddress.fromString(contractAddress);
37
- const contract = await contractDataProvider.getContract(parsedContractAddress);
33
+ const contract = await contractStore.getContract(parsedContractAddress);
38
34
  if (contract) {
39
35
  err.enrichWithContractName(parsedContractAddress, contract.name);
40
36
  // Map from function selector to function name. It uses a stringified key for the same reason as mentionedFunctions.
@@ -68,11 +64,7 @@ export async function enrichSimulationError(
68
64
  );
69
65
  }
70
66
 
71
- export async function enrichPublicSimulationError(
72
- err: SimulationError,
73
- contractDataProvider: ContractDataProvider,
74
- logger: Logger,
75
- ) {
67
+ export async function enrichPublicSimulationError(err: SimulationError, contractStore: ContractStore, logger: Logger) {
76
68
  const callStack = err.getCallStack();
77
69
  const originalFailingFunction = callStack[callStack.length - 1];
78
70
 
@@ -80,7 +72,7 @@ export async function enrichPublicSimulationError(
80
72
  throw new Error(`Original failing function not found when enriching public simulation, missing callstack`);
81
73
  }
82
74
 
83
- const artifact = await contractDataProvider.getPublicFunctionArtifact(originalFailingFunction.contractAddress);
75
+ const artifact = await contractStore.getPublicFunctionArtifact(originalFailingFunction.contractAddress);
84
76
  if (!artifact) {
85
77
  throw new Error(
86
78
  `Artifact not found when enriching public simulation error. Contract address: ${originalFailingFunction.contractAddress}.`,
@@ -92,7 +84,7 @@ export async function enrichPublicSimulationError(
92
84
  err.setOriginalMessage(err.getOriginalMessage() + `${assertionMessage}`);
93
85
  }
94
86
 
95
- const debugInfo = await contractDataProvider.getPublicFunctionDebugMetadata(originalFailingFunction.contractAddress);
87
+ const debugInfo = await contractStore.getPublicFunctionDebugMetadata(originalFailingFunction.contractAddress);
96
88
 
97
89
  const noirCallStack = err.getNoirCallStack();
98
90
  if (debugInfo) {
@@ -110,6 +102,6 @@ export async function enrichPublicSimulationError(
110
102
  );
111
103
  }
112
104
  }
113
- await enrichSimulationError(err, contractDataProvider, logger);
105
+ await enrichSimulationError(err, contractStore, logger);
114
106
  }
115
107
  }
@@ -1,77 +1,119 @@
1
- import type { Fr } from '@aztec/foundation/curves/bn254';
2
- import type { EventSelector } from '@aztec/stdlib/abi';
1
+ import { createLogger } from '@aztec/foundation/log';
3
2
  import type { AztecAddress } from '@aztec/stdlib/aztec-address';
4
- import { siloNullifier } from '@aztec/stdlib/hash';
3
+ import { computePrivateEventCommitment, siloNullifier } from '@aztec/stdlib/hash';
5
4
  import type { AztecNode } from '@aztec/stdlib/interfaces/server';
6
- import { MerkleTreeId } from '@aztec/stdlib/trees';
7
- import type { TxHash } from '@aztec/stdlib/tx';
5
+ import type { BlockHeader, IndexedTxEffect } from '@aztec/stdlib/tx';
8
6
 
9
- import { AnchorBlockDataProvider } from '../storage/anchor_block_data_provider/anchor_block_data_provider.js';
10
- import { PrivateEventDataProvider } from '../storage/private_event_data_provider/private_event_data_provider.js';
7
+ import type { EventValidationRequest } from '../contract_function_simulator/noir-structs/event_validation_request.js';
8
+ import { PrivateEventStore } from '../storage/private_event_store/private_event_store.js';
11
9
 
12
10
  export class EventService {
13
11
  constructor(
14
- private readonly anchorBlockDataProvider: AnchorBlockDataProvider,
12
+ private readonly anchorBlockHeader: BlockHeader,
15
13
  private readonly aztecNode: AztecNode,
16
- private readonly privateEventDataProvider: PrivateEventDataProvider,
14
+ private readonly privateEventStore: PrivateEventStore,
15
+ private readonly jobId: string,
16
+ private readonly log = createLogger('pxe:event_service'),
17
17
  ) {}
18
18
 
19
- public async deliverEvent(
20
- contractAddress: AztecAddress,
21
- selector: EventSelector,
22
- content: Fr[],
23
- eventCommitment: Fr,
24
- txHash: TxHash,
19
+ /**
20
+ * Validates and stores a batch of private events against pre-fetched tx effects.
21
+ *
22
+ * @param requests - The events to validate and store.
23
+ * @param scope - The scope under which the events are being stored.
24
+ * @param txEffects - Pre-fetched tx effects keyed by `TxHash.toString()`. Must contain entries for every request's
25
+ * txHash; missing entries are treated as a node bug and cause an error.
26
+ */
27
+ public async validateAndStoreEvents(
28
+ requests: EventValidationRequest[],
25
29
  scope: AztecAddress,
30
+ txEffects: Map<string, IndexedTxEffect>,
26
31
  ): Promise<void> {
32
+ if (requests.length === 0) {
33
+ return;
34
+ }
35
+
36
+ const anchorBlockNumber = this.anchorBlockHeader.getBlockNumber();
37
+
38
+ await Promise.all(requests.map(req => this.#validateAndStoreEvent(req, scope, txEffects, anchorBlockNumber)));
39
+ }
40
+
41
+ async #validateAndStoreEvent(
42
+ request: EventValidationRequest,
43
+ scope: AztecAddress,
44
+ txEffects: Map<string, IndexedTxEffect>,
45
+ anchorBlockNumber: number,
46
+ ): Promise<void> {
47
+ const {
48
+ contractAddress,
49
+ eventTypeId: selector,
50
+ randomness,
51
+ serializedEvent: content,
52
+ eventCommitment,
53
+ txHash,
54
+ } = request;
55
+
56
+ // Defense-in-depth: the built-in private-event path derives this commitment from content before enqueueing, but
57
+ // unconstrained PXE-side code (e.g. a custom message handler) can reach this oracle with arbitrary
58
+ // (content, commitment) pairs. Without this check it could bind arbitrary content to a legitimate tx nullifier,
59
+ // causing PXE to surface fabricated event data.
60
+ const recomputedCommitment = await computePrivateEventCommitment(randomness, selector.toField(), content);
61
+ if (!recomputedCommitment.equals(eventCommitment)) {
62
+ this.log.warn(
63
+ `Skipping event whose content does not hash to the provided commitment. contract=${contractAddress}, selector=${selector}, eventCommitment=${eventCommitment}, txHash=${txHash}, recomputedCommitment=${recomputedCommitment}`,
64
+ );
65
+ return;
66
+ }
67
+
27
68
  // While using 'latest' block number would be fine for private events since they cannot be accessed from Aztec.nr
28
69
  // (and thus we're less concerned about being ahead of the synced block), we use the synced block number to
29
70
  // maintain consistent behavior in the PXE. Additionally, events should never be ahead of the synced block here
30
71
  // since `fetchTaggedLogs` only processes logs up to the synced block.
31
- const [syncedBlockHeader, siloedEventCommitment, txEffect] = await Promise.all([
32
- this.anchorBlockDataProvider.getBlockHeader(),
33
- siloNullifier(contractAddress, eventCommitment),
34
- this.aztecNode.getTxEffect(txHash),
35
- ]);
36
-
37
- const syncedBlockNumber = syncedBlockHeader.getBlockNumber();
72
+ const siloedEventCommitment = await siloNullifier(contractAddress, eventCommitment);
38
73
 
74
+ const txEffect = txEffects.get(txHash.toString());
39
75
  if (!txEffect) {
40
- throw new Error(`Could not find tx effect for tx hash ${txHash}`);
41
- }
42
-
43
- if (txEffect.l2BlockNumber > syncedBlockNumber) {
44
- throw new Error(`Could not find tx effect for tx hash ${txHash} as of block number ${syncedBlockNumber}`);
76
+ // We error out instead of just logging a warning and skipping the event because this would indicate a bug. This
77
+ // is because the node has already served info about this tx either when obtaining the log (LogResult carries
78
+ // the tx info) or when getting metadata for the offchain message (before the message got passed to `process_log`).
79
+ throw new Error(`Could not find tx effect for tx hash ${txHash} when processing an event.`);
45
80
  }
46
81
 
47
- const eventInTx = txEffect.data.nullifiers.some(n => n.equals(siloedEventCommitment));
48
- if (!eventInTx) {
82
+ if (txEffect.l2BlockNumber > anchorBlockNumber) {
83
+ // We should never process a message from a tx past the anchor block. If we got here, a preprocessing step made
84
+ // a mistake.
49
85
  throw new Error(
50
- `Event commitment ${eventCommitment} (siloed as ${siloedEventCommitment}) is not present in tx ${txHash}`,
86
+ `Obtained a newer tx effect for ${txHash} for an event validation request than the anchor block ${anchorBlockNumber}. This is a bug as smart contracts should not issue event validation requests for events from blocks newer than the anchor block.`,
51
87
  );
52
88
  }
53
89
 
54
- const [nullifierIndex] = await this.aztecNode.findLeavesIndexes(syncedBlockNumber, MerkleTreeId.NULLIFIER_TREE, [
55
- siloedEventCommitment,
56
- ]);
57
-
58
- if (nullifierIndex === undefined) {
59
- throw new Error(
60
- `Event commitment ${eventCommitment} (siloed as ${siloedEventCommitment}) is not present on the nullifier tree at block ${syncedBlockNumber} (from tx ${txHash})`,
90
+ // Find the index of the event commitment in the nullifiers array to determine event ordering within the tx
91
+ const eventIndexInTx = txEffect.data.nullifiers.findIndex(n => n.equals(siloedEventCommitment));
92
+ if (eventIndexInTx === -1) {
93
+ // Unlike in NoteService, this might not be a bug since the commitment hasn't been verified yet in the message
94
+ // processing pipeline. A malformed or malicious message could trigger this condition. Because of this we don't
95
+ // error out and we just show a warning.
96
+ this.log.warn(
97
+ `Skipping event whose commitment is not present in its tx. siloedEventCommitment=${siloedEventCommitment}, contract=${contractAddress}, selector=${selector}, eventCommitment=${eventCommitment}, txHash=${txHash}`,
61
98
  );
99
+ return;
62
100
  }
63
101
 
64
- return this.privateEventDataProvider.storePrivateEventLog(
102
+ return this.privateEventStore.storePrivateEventLog(
65
103
  selector,
104
+ randomness,
66
105
  content,
67
- Number(nullifierIndex.data), // Index of the event commitment in the nullifier tree
106
+ siloedEventCommitment,
68
107
  {
69
108
  contractAddress,
70
109
  scope,
71
110
  txHash,
72
- l2BlockNumber: nullifierIndex.l2BlockNumber, // Block number in which the event was emitted
73
- l2BlockHash: nullifierIndex.l2BlockHash, // Block hash in which the event was emitted
111
+ l2BlockNumber: txEffect.l2BlockNumber,
112
+ l2BlockHash: txEffect.l2BlockHash,
113
+ txIndexInBlock: txEffect.txIndexInBlock,
114
+ eventIndexInTx,
74
115
  },
116
+ this.jobId,
75
117
  );
76
118
  }
77
119
  }
@@ -1,14 +1,16 @@
1
1
  import type { PrivateEventFilter } from '@aztec/aztec.js/wallet';
2
2
  import { INITIAL_L2_BLOCK_NUM } from '@aztec/constants';
3
3
  import { BlockNumber } from '@aztec/foundation/branded-types';
4
+ import { createLogger } from '@aztec/foundation/log';
4
5
 
5
- import { AnchorBlockDataProvider } from '../storage/anchor_block_data_provider/anchor_block_data_provider.js';
6
- import type { PrivateEventDataProviderFilter } from '../storage/private_event_data_provider/private_event_data_provider.js';
6
+ import type { PrivateEventStoreFilter } from '../storage/private_event_store/private_event_store.js';
7
7
 
8
8
  export class PrivateEventFilterValidator {
9
- constructor(private anchorBlockDataProvider: AnchorBlockDataProvider) {}
9
+ private readonly log = createLogger('pxe:private_event_filter_validator');
10
10
 
11
- async validate(filter: PrivateEventFilter): Promise<PrivateEventDataProviderFilter> {
11
+ constructor(private readonly lastBlock: BlockNumber) {}
12
+
13
+ validate(filter: PrivateEventFilter): PrivateEventStoreFilter {
12
14
  let { fromBlock, toBlock } = filter;
13
15
 
14
16
  // Block range filters in Aztec Node are defined as closed-open intervals [fromBlock, toBlock), so
@@ -16,9 +18,8 @@ export class PrivateEventFilterValidator {
16
18
  // We then default to [INITIAL_L2_BLOCK_NUM, latestKnownBlock + 1), ie: by default return events from
17
19
  // the first block to the latest known block.
18
20
  if (!fromBlock || !toBlock) {
19
- const lastKnownBlock = (await this.anchorBlockDataProvider.getBlockHeader()).getBlockNumber();
20
21
  fromBlock = fromBlock ?? BlockNumber(INITIAL_L2_BLOCK_NUM);
21
- toBlock = toBlock ?? BlockNumber(lastKnownBlock + 1);
22
+ toBlock = toBlock ?? BlockNumber(this.lastBlock + 1);
22
23
  }
23
24
 
24
25
  if (filter.scopes.length === 0) {
@@ -37,6 +38,23 @@ export class PrivateEventFilterValidator {
37
38
  throw new Error('toBlock must be strictly greater than fromBlock');
38
39
  }
39
40
 
41
+ // Cap the requested range to the synced block range. Without this, callers that pass a large
42
+ // toBlock (e.g. Number.MAX_SAFE_INTEGER as a "give me everything" idiom) would silently receive
43
+ // only the events that happen to be synced and believe they have complete coverage.
44
+ // We warn + cap rather than throw so callers don't need to query the last synced block before
45
+ // every request (which would also be unreliable, as the block can advance between the two calls).
46
+ const syncedUpperBound = BlockNumber(this.lastBlock + 1);
47
+ if (fromBlock >= syncedUpperBound) {
48
+ this.log.warn(
49
+ `Requested fromBlock ${fromBlock} is past last synced block ${this.lastBlock}; no events will be returned until PXE syncs further.`,
50
+ );
51
+ } else if (toBlock > syncedUpperBound) {
52
+ this.log.warn(
53
+ `Requested toBlock ${toBlock} exceeds last synced block ${this.lastBlock}; capping to ${syncedUpperBound}. Retry once PXE is further synced for complete coverage.`,
54
+ );
55
+ toBlock = syncedUpperBound;
56
+ }
57
+
40
58
  return {
41
59
  contractAddress: filter.contractAddress,
42
60
  scopes: filter.scopes,