@aztec/pxe 0.0.1-commit.e3c1de76 → 0.0.1-commit.e57c76e

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 (347) hide show
  1. package/dest/bin/check_oracle_version.js +43 -99
  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 +26 -0
  6. package/dest/bin/oracle_version_helpers.d.ts.map +1 -0
  7. package/dest/bin/oracle_version_helpers.js +93 -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 +62 -0
  11. package/dest/block_synchronizer/block_synchronizer.d.ts +9 -3
  12. package/dest/block_synchronizer/block_synchronizer.d.ts.map +1 -1
  13. package/dest/block_synchronizer/block_synchronizer.js +37 -11
  14. package/dest/config/index.d.ts +8 -2
  15. package/dest/config/index.d.ts.map +1 -1
  16. package/dest/config/index.js +13 -15
  17. package/dest/config/package_info.js +1 -1
  18. package/dest/contract_function_simulator/contract_function_simulator.d.ts +66 -29
  19. package/dest/contract_function_simulator/contract_function_simulator.d.ts.map +1 -1
  20. package/dest/contract_function_simulator/contract_function_simulator.js +216 -75
  21. package/dest/contract_function_simulator/ephemeral_array_service.d.ts +28 -0
  22. package/dest/contract_function_simulator/ephemeral_array_service.d.ts.map +1 -0
  23. package/dest/contract_function_simulator/ephemeral_array_service.js +78 -0
  24. package/dest/contract_function_simulator/execution_note_cache.d.ts +2 -2
  25. package/dest/contract_function_simulator/execution_note_cache.d.ts.map +1 -1
  26. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts +7 -11
  27. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts.map +1 -1
  28. package/dest/contract_function_simulator/execution_tagging_index_cache.js +19 -15
  29. package/dest/contract_function_simulator/index.d.ts +14 -2
  30. package/dest/contract_function_simulator/index.d.ts.map +1 -1
  31. package/dest/contract_function_simulator/index.js +11 -0
  32. package/dest/contract_function_simulator/noir-structs/bounded_vec.d.ts +48 -0
  33. package/dest/contract_function_simulator/noir-structs/bounded_vec.d.ts.map +1 -0
  34. package/dest/contract_function_simulator/noir-structs/bounded_vec.js +45 -0
  35. package/dest/contract_function_simulator/noir-structs/ephemeral_array.d.ts +37 -0
  36. package/dest/contract_function_simulator/noir-structs/ephemeral_array.d.ts.map +1 -0
  37. package/dest/contract_function_simulator/noir-structs/ephemeral_array.js +59 -0
  38. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts +3 -4
  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 +8 -9
  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_data.d.ts +27 -0
  48. package/dest/contract_function_simulator/noir-structs/note_data.d.ts.map +1 -0
  49. package/dest/contract_function_simulator/noir-structs/note_data.js +3 -0
  50. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts +3 -5
  51. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts.map +1 -1
  52. package/dest/contract_function_simulator/noir-structs/note_validation_request.js +6 -10
  53. package/dest/contract_function_simulator/noir-structs/option.d.ts +61 -0
  54. package/dest/contract_function_simulator/noir-structs/option.d.ts.map +1 -0
  55. package/dest/contract_function_simulator/noir-structs/option.js +62 -0
  56. package/dest/contract_function_simulator/noir-structs/provided_secret.d.ts +11 -0
  57. package/dest/contract_function_simulator/noir-structs/provided_secret.d.ts.map +1 -0
  58. package/dest/contract_function_simulator/noir-structs/provided_secret.js +24 -0
  59. package/dest/contract_function_simulator/oracle/interfaces.d.ts +16 -98
  60. package/dest/contract_function_simulator/oracle/interfaces.d.ts.map +1 -1
  61. package/dest/contract_function_simulator/oracle/interfaces.js +2 -2
  62. package/dest/contract_function_simulator/oracle/note_packing_utils.d.ts +2 -2
  63. package/dest/contract_function_simulator/oracle/note_packing_utils.d.ts.map +1 -1
  64. package/dest/contract_function_simulator/oracle/note_packing_utils.js +2 -2
  65. package/dest/contract_function_simulator/oracle/oracle.d.ts +75 -46
  66. package/dest/contract_function_simulator/oracle/oracle.d.ts.map +1 -1
  67. package/dest/contract_function_simulator/oracle/oracle.js +471 -275
  68. package/dest/contract_function_simulator/oracle/oracle_registry.d.ts +127 -0
  69. package/dest/contract_function_simulator/oracle/oracle_registry.d.ts.map +1 -0
  70. package/dest/contract_function_simulator/oracle/oracle_registry.js +786 -0
  71. package/dest/contract_function_simulator/oracle/oracle_type_mappings.d.ts +139 -0
  72. package/dest/contract_function_simulator/oracle/oracle_type_mappings.d.ts.map +1 -0
  73. package/dest/contract_function_simulator/oracle/oracle_type_mappings.js +560 -0
  74. package/dest/contract_function_simulator/oracle/private_execution.js +5 -3
  75. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts +68 -95
  76. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts.map +1 -1
  77. package/dest/contract_function_simulator/oracle/private_execution_oracle.js +141 -110
  78. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts +156 -76
  79. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts.map +1 -1
  80. package/dest/contract_function_simulator/oracle/utility_execution_oracle.js +450 -166
  81. package/dest/contract_function_simulator/pick_notes.d.ts +1 -1
  82. package/dest/contract_function_simulator/pick_notes.d.ts.map +1 -1
  83. package/dest/contract_function_simulator/pick_notes.js +20 -3
  84. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts +1 -1
  85. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts.map +1 -1
  86. package/dest/contract_function_simulator/proxied_contract_data_source.js +35 -64
  87. package/dest/contract_logging.d.ts +27 -0
  88. package/dest/contract_logging.d.ts.map +1 -0
  89. package/dest/contract_logging.js +38 -0
  90. package/dest/contract_sync/contract_sync_service.d.ts +42 -0
  91. package/dest/contract_sync/contract_sync_service.d.ts.map +1 -0
  92. package/dest/contract_sync/contract_sync_service.js +135 -0
  93. package/dest/contract_sync/helpers.d.ts +27 -0
  94. package/dest/contract_sync/helpers.d.ts.map +1 -0
  95. package/dest/contract_sync/{index.js → helpers.js} +16 -17
  96. package/dest/debug/pxe_debug_utils.d.ts +14 -15
  97. package/dest/debug/pxe_debug_utils.d.ts.map +1 -1
  98. package/dest/debug/pxe_debug_utils.js +16 -21
  99. package/dest/entrypoints/client/bundle/index.d.ts +3 -1
  100. package/dest/entrypoints/client/bundle/index.d.ts.map +1 -1
  101. package/dest/entrypoints/client/bundle/index.js +2 -0
  102. package/dest/entrypoints/client/bundle/utils.d.ts +2 -2
  103. package/dest/entrypoints/client/bundle/utils.d.ts.map +1 -1
  104. package/dest/entrypoints/client/bundle/utils.js +21 -5
  105. package/dest/entrypoints/client/lazy/index.d.ts +3 -1
  106. package/dest/entrypoints/client/lazy/index.d.ts.map +1 -1
  107. package/dest/entrypoints/client/lazy/index.js +2 -0
  108. package/dest/entrypoints/client/lazy/utils.d.ts +2 -2
  109. package/dest/entrypoints/client/lazy/utils.d.ts.map +1 -1
  110. package/dest/entrypoints/client/lazy/utils.js +21 -5
  111. package/dest/entrypoints/pxe_creation_options.d.ts +9 -1
  112. package/dest/entrypoints/pxe_creation_options.d.ts.map +1 -1
  113. package/dest/entrypoints/pxe_creation_options.js +3 -1
  114. package/dest/entrypoints/server/index.d.ts +5 -3
  115. package/dest/entrypoints/server/index.d.ts.map +1 -1
  116. package/dest/entrypoints/server/index.js +4 -2
  117. package/dest/entrypoints/server/utils.d.ts +4 -3
  118. package/dest/entrypoints/server/utils.d.ts.map +1 -1
  119. package/dest/entrypoints/server/utils.js +21 -5
  120. package/dest/events/event_service.d.ts +15 -6
  121. package/dest/events/event_service.d.ts.map +1 -1
  122. package/dest/events/event_service.js +44 -11
  123. package/dest/events/private_event_filter_validator.d.ts +3 -2
  124. package/dest/events/private_event_filter_validator.d.ts.map +1 -1
  125. package/dest/events/private_event_filter_validator.js +15 -0
  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/logs/log_service.d.ts +9 -8
  136. package/dest/logs/log_service.d.ts.map +1 -1
  137. package/dest/logs/log_service.js +131 -84
  138. package/dest/messages/message_context_service.d.ts +17 -0
  139. package/dest/messages/message_context_service.d.ts.map +1 -0
  140. package/dest/messages/message_context_service.js +55 -0
  141. package/dest/notes/note_service.d.ts +27 -5
  142. package/dest/notes/note_service.d.ts.map +1 -1
  143. package/dest/notes/note_service.js +83 -58
  144. package/dest/notes_filter.d.ts +24 -0
  145. package/dest/notes_filter.d.ts.map +1 -0
  146. package/dest/notes_filter.js +4 -0
  147. package/dest/oracle_version.d.ts +4 -3
  148. package/dest/oracle_version.d.ts.map +1 -1
  149. package/dest/oracle_version.js +20 -10
  150. package/dest/private_kernel/batch_planner.d.ts +47 -0
  151. package/dest/private_kernel/batch_planner.d.ts.map +1 -0
  152. package/dest/private_kernel/batch_planner.js +104 -0
  153. package/dest/private_kernel/hints/compute_tx_expiration_timestamp.d.ts +4 -0
  154. package/dest/private_kernel/hints/compute_tx_expiration_timestamp.d.ts.map +1 -0
  155. package/dest/private_kernel/hints/{compute_tx_include_by_timestamp.js → compute_tx_expiration_timestamp.js} +12 -12
  156. package/dest/private_kernel/hints/index.d.ts +1 -1
  157. package/dest/private_kernel/hints/index.js +1 -1
  158. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts +4 -3
  159. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts.map +1 -1
  160. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.js +130 -69
  161. package/dest/private_kernel/hints/test_utils.d.ts +122 -0
  162. package/dest/private_kernel/hints/test_utils.d.ts.map +1 -0
  163. package/dest/private_kernel/hints/test_utils.js +202 -0
  164. package/dest/private_kernel/private_kernel_execution_prover.d.ts +6 -2
  165. package/dest/private_kernel/private_kernel_execution_prover.d.ts.map +1 -1
  166. package/dest/private_kernel/private_kernel_execution_prover.js +166 -65
  167. package/dest/private_kernel/private_kernel_oracle.d.ts +15 -11
  168. package/dest/private_kernel/private_kernel_oracle.d.ts.map +1 -1
  169. package/dest/private_kernel/private_kernel_oracle.js +31 -25
  170. package/dest/pxe.d.ts +120 -24
  171. package/dest/pxe.d.ts.map +1 -1
  172. package/dest/pxe.js +231 -134
  173. package/dest/storage/anchor_block_store/anchor_block_store.js +1 -1
  174. package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.d.ts +42 -0
  175. package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.d.ts.map +1 -0
  176. package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.js +93 -0
  177. package/dest/storage/backwards_compatibility_tests/schema_tests.d.ts +15 -0
  178. package/dest/storage/backwards_compatibility_tests/schema_tests.d.ts.map +1 -0
  179. package/dest/storage/backwards_compatibility_tests/schema_tests.js +591 -0
  180. package/dest/storage/backwards_compatibility_tests/store_spy.d.ts +19 -0
  181. package/dest/storage/backwards_compatibility_tests/store_spy.d.ts.map +1 -0
  182. package/dest/storage/backwards_compatibility_tests/store_spy.js +63 -0
  183. package/dest/storage/capsule_store/capsule_service.d.ts +21 -0
  184. package/dest/storage/capsule_store/capsule_service.d.ts.map +1 -0
  185. package/dest/storage/capsule_store/capsule_service.js +50 -0
  186. package/dest/storage/capsule_store/capsule_store.d.ts +9 -9
  187. package/dest/storage/capsule_store/capsule_store.d.ts.map +1 -1
  188. package/dest/storage/capsule_store/capsule_store.js +36 -28
  189. package/dest/storage/capsule_store/index.d.ts +2 -1
  190. package/dest/storage/capsule_store/index.d.ts.map +1 -1
  191. package/dest/storage/capsule_store/index.js +1 -0
  192. package/dest/storage/contract_store/contract_store.d.ts +42 -15
  193. package/dest/storage/contract_store/contract_store.d.ts.map +1 -1
  194. package/dest/storage/contract_store/contract_store.js +146 -87
  195. package/dest/storage/metadata.d.ts +1 -1
  196. package/dest/storage/metadata.js +1 -1
  197. package/dest/storage/note_store/note_store.d.ts +3 -3
  198. package/dest/storage/note_store/note_store.d.ts.map +1 -1
  199. package/dest/storage/note_store/note_store.js +6 -4
  200. package/dest/storage/open_pxe_stores.d.ts +33 -0
  201. package/dest/storage/open_pxe_stores.d.ts.map +1 -0
  202. package/dest/storage/open_pxe_stores.js +27 -0
  203. package/dest/storage/private_event_store/private_event_store.d.ts +1 -1
  204. package/dest/storage/private_event_store/private_event_store.d.ts.map +1 -1
  205. package/dest/storage/private_event_store/private_event_store.js +3 -0
  206. package/dest/storage/private_event_store/stored_private_event.js +1 -1
  207. package/dest/storage/tagging_store/recipient_tagging_store.d.ts +6 -6
  208. package/dest/storage/tagging_store/recipient_tagging_store.d.ts.map +1 -1
  209. package/dest/storage/tagging_store/sender_tagging_store.d.ts +29 -28
  210. package/dest/storage/tagging_store/sender_tagging_store.d.ts.map +1 -1
  211. package/dest/storage/tagging_store/sender_tagging_store.js +141 -115
  212. package/dest/tagging/get_all_logs_by_tags.d.ts +34 -10
  213. package/dest/tagging/get_all_logs_by_tags.d.ts.map +1 -1
  214. package/dest/tagging/get_all_logs_by_tags.js +45 -32
  215. package/dest/tagging/index.d.ts +6 -5
  216. package/dest/tagging/index.d.ts.map +1 -1
  217. package/dest/tagging/index.js +4 -3
  218. package/dest/tagging/persist_sender_tagging_index_ranges.d.ts +29 -0
  219. package/dest/tagging/persist_sender_tagging_index_ranges.d.ts.map +1 -0
  220. package/dest/tagging/persist_sender_tagging_index_ranges.js +42 -0
  221. package/dest/tagging/recipient_sync/sync_tagged_private_logs.d.ts +56 -0
  222. package/dest/tagging/recipient_sync/sync_tagged_private_logs.d.ts.map +1 -0
  223. package/dest/tagging/recipient_sync/sync_tagged_private_logs.js +163 -0
  224. package/dest/tagging/recipient_sync/utils/find_highest_indexes.d.ts +3 -3
  225. package/dest/tagging/recipient_sync/utils/find_highest_indexes.d.ts.map +1 -1
  226. package/dest/tagging/recipient_sync/utils/find_highest_indexes.js +2 -2
  227. package/dest/tagging/reconcile_tagging_index_ranges.d.ts +36 -0
  228. package/dest/tagging/reconcile_tagging_index_ranges.d.ts.map +1 -0
  229. package/dest/tagging/reconcile_tagging_index_ranges.js +74 -0
  230. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts +4 -9
  231. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts.map +1 -1
  232. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.js +32 -14
  233. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts +13 -7
  234. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts.map +1 -1
  235. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.js +41 -10
  236. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts +5 -7
  237. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts.map +1 -1
  238. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.js +37 -25
  239. package/package.json +29 -17
  240. package/src/bin/check_oracle_version.ts +49 -122
  241. package/src/bin/index.ts +1 -0
  242. package/src/bin/oracle_version_helpers.ts +121 -0
  243. package/src/block_synchronizer/block_stream_source.ts +81 -0
  244. package/src/block_synchronizer/block_synchronizer.ts +39 -11
  245. package/src/config/index.ts +15 -9
  246. package/src/config/package_info.ts +1 -1
  247. package/src/contract_function_simulator/contract_function_simulator.ts +391 -136
  248. package/src/contract_function_simulator/ephemeral_array_service.ts +110 -0
  249. package/src/contract_function_simulator/execution_note_cache.ts +1 -1
  250. package/src/contract_function_simulator/execution_tagging_index_cache.ts +19 -18
  251. package/src/contract_function_simulator/index.ts +51 -1
  252. package/src/contract_function_simulator/noir-structs/bounded_vec.ts +55 -0
  253. package/src/contract_function_simulator/noir-structs/ephemeral_array.ts +66 -0
  254. package/src/contract_function_simulator/noir-structs/event_validation_request.ts +9 -8
  255. package/src/contract_function_simulator/noir-structs/log_retrieval_request.ts +36 -3
  256. package/src/contract_function_simulator/noir-structs/log_retrieval_response.ts +2 -5
  257. package/src/contract_function_simulator/noir-structs/note_data.ts +27 -0
  258. package/src/contract_function_simulator/noir-structs/note_validation_request.ts +4 -9
  259. package/src/contract_function_simulator/noir-structs/option.ts +69 -0
  260. package/src/contract_function_simulator/noir-structs/provided_secret.ts +27 -0
  261. package/src/contract_function_simulator/oracle/interfaces.ts +12 -176
  262. package/src/contract_function_simulator/oracle/note_packing_utils.ts +3 -3
  263. package/src/contract_function_simulator/oracle/oracle.ts +564 -473
  264. package/src/contract_function_simulator/oracle/oracle_registry.ts +585 -0
  265. package/src/contract_function_simulator/oracle/oracle_type_mappings.ts +553 -0
  266. package/src/contract_function_simulator/oracle/private_execution.ts +4 -4
  267. package/src/contract_function_simulator/oracle/private_execution_oracle.ts +173 -205
  268. package/src/contract_function_simulator/oracle/utility_execution_oracle.ts +664 -245
  269. package/src/contract_function_simulator/pick_notes.ts +22 -3
  270. package/src/contract_function_simulator/proxied_contract_data_source.ts +41 -64
  271. package/src/contract_logging.ts +52 -0
  272. package/src/contract_sync/contract_sync_service.ts +189 -0
  273. package/src/contract_sync/{index.ts → helpers.ts} +17 -29
  274. package/src/debug/pxe_debug_utils.ts +47 -25
  275. package/src/entrypoints/client/bundle/index.ts +2 -0
  276. package/src/entrypoints/client/bundle/utils.ts +19 -6
  277. package/src/entrypoints/client/lazy/index.ts +2 -0
  278. package/src/entrypoints/client/lazy/utils.ts +19 -6
  279. package/src/entrypoints/pxe_creation_options.ts +14 -0
  280. package/src/entrypoints/server/index.ts +4 -2
  281. package/src/entrypoints/server/utils.ts +22 -13
  282. package/src/events/event_service.ts +69 -21
  283. package/src/events/private_event_filter_validator.ts +21 -1
  284. package/src/hooks/authorize_utility_call.ts +44 -0
  285. package/src/hooks/execution_hooks.ts +48 -0
  286. package/src/hooks/index.ts +7 -0
  287. package/src/logs/log_service.ts +162 -145
  288. package/src/messages/message_context_service.ts +62 -0
  289. package/src/notes/note_service.ts +120 -85
  290. package/src/notes_filter.ts +24 -0
  291. package/src/oracle_version.ts +20 -10
  292. package/src/private_kernel/batch_planner.ts +169 -0
  293. package/src/private_kernel/hints/{compute_tx_include_by_timestamp.ts → compute_tx_expiration_timestamp.ts} +13 -13
  294. package/src/private_kernel/hints/index.ts +1 -1
  295. package/src/private_kernel/hints/private_kernel_reset_private_inputs_builder.ts +165 -118
  296. package/src/private_kernel/hints/test_utils.ts +318 -0
  297. package/src/private_kernel/private_kernel_execution_prover.ts +254 -89
  298. package/src/private_kernel/private_kernel_oracle.ts +42 -32
  299. package/src/pxe.ts +416 -181
  300. package/src/storage/anchor_block_store/anchor_block_store.ts +1 -1
  301. package/src/storage/backwards_compatibility_tests/__snapshots__/AddressStore.json +22 -0
  302. package/src/storage/backwards_compatibility_tests/__snapshots__/AnchorBlockStore.json +3 -0
  303. package/src/storage/backwards_compatibility_tests/__snapshots__/CapsuleStore.json +16 -0
  304. package/src/storage/backwards_compatibility_tests/__snapshots__/ContractStore.json +28 -0
  305. package/src/storage/backwards_compatibility_tests/__snapshots__/KeyStore.json +52 -0
  306. package/src/storage/backwards_compatibility_tests/__snapshots__/L2TipsKVStore.json +46 -0
  307. package/src/storage/backwards_compatibility_tests/__snapshots__/NoteStore.json +36 -0
  308. package/src/storage/backwards_compatibility_tests/__snapshots__/PrivateEventStore.json +44 -0
  309. package/src/storage/backwards_compatibility_tests/__snapshots__/RecipientTaggingStore.json +18 -0
  310. package/src/storage/backwards_compatibility_tests/__snapshots__/SenderAddressBookStore.json +16 -0
  311. package/src/storage/backwards_compatibility_tests/__snapshots__/SenderTaggingStore.json +22 -0
  312. package/src/storage/backwards_compatibility_tests/__snapshots__/opened_stores.json +97 -0
  313. package/src/storage/backwards_compatibility_tests/kv_store_snapshot.ts +122 -0
  314. package/src/storage/backwards_compatibility_tests/schema_tests.ts +712 -0
  315. package/src/storage/backwards_compatibility_tests/store_spy.ts +73 -0
  316. package/src/storage/capsule_store/capsule_service.ts +90 -0
  317. package/src/storage/capsule_store/capsule_store.ts +44 -26
  318. package/src/storage/capsule_store/index.ts +1 -0
  319. package/src/storage/contract_store/contract_store.ts +182 -104
  320. package/src/storage/metadata.ts +1 -1
  321. package/src/storage/note_store/note_store.ts +9 -5
  322. package/src/storage/open_pxe_stores.ts +49 -0
  323. package/src/storage/private_event_store/private_event_store.ts +4 -0
  324. package/src/storage/private_event_store/stored_private_event.ts +1 -1
  325. package/src/storage/tagging_store/recipient_tagging_store.ts +5 -5
  326. package/src/storage/tagging_store/sender_tagging_store.ts +185 -138
  327. package/src/tagging/get_all_logs_by_tags.ts +87 -35
  328. package/src/tagging/index.ts +5 -4
  329. package/src/tagging/persist_sender_tagging_index_ranges.ts +57 -0
  330. package/src/tagging/recipient_sync/sync_tagged_private_logs.ts +240 -0
  331. package/src/tagging/recipient_sync/utils/find_highest_indexes.ts +4 -4
  332. package/src/tagging/reconcile_tagging_index_ranges.ts +102 -0
  333. package/src/tagging/sender_sync/sync_sender_tagging_indexes.ts +52 -17
  334. package/src/tagging/sender_sync/utils/get_status_change_of_pending.ts +44 -14
  335. package/src/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.ts +27 -27
  336. package/dest/contract_sync/index.d.ts +0 -23
  337. package/dest/contract_sync/index.d.ts.map +0 -1
  338. package/dest/private_kernel/hints/compute_tx_include_by_timestamp.d.ts +0 -4
  339. package/dest/private_kernel/hints/compute_tx_include_by_timestamp.d.ts.map +0 -1
  340. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts +0 -15
  341. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts.map +0 -1
  342. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.js +0 -99
  343. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts +0 -15
  344. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts.map +0 -1
  345. package/dest/tagging/recipient_sync/utils/load_logs_for_range.js +0 -32
  346. package/src/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.ts +0 -143
  347. package/src/tagging/recipient_sync/utils/load_logs_for_range.ts +0 -49
@@ -4,16 +4,17 @@
4
4
  * The objective of the sender sync algorithm is to determine which tags have already been used by a sender, thereby
5
5
  * deciding which tag should be used next.
6
6
  *
7
- * The objective of the recipient sync algorithm is to load and process the corresponding logs.
7
+ * The objective of the recipient sync algorithm is to fetch and sync the corresponding logs.
8
8
  *
9
9
  * @module tagging
10
10
  */
11
11
 
12
- export { loadPrivateLogsForSenderRecipientPair } from './recipient_sync/load_private_logs_for_sender_recipient_pair.js';
12
+ export { syncTaggedPrivateLogs } from './recipient_sync/sync_tagged_private_logs.js';
13
13
  export { syncSenderTaggingIndexes } from './sender_sync/sync_sender_tagging_indexes.js';
14
+ export { persistSenderTaggingIndexRangesForTx } from './persist_sender_tagging_index_ranges.js';
14
15
  export { UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN } from './constants.js';
15
16
  export { getAllPrivateLogsByTags, getAllPublicLogsByTagsFromContract } from './get_all_logs_by_tags.js';
16
17
 
17
18
  // Re-export tagging-related types from stdlib
18
- export { DirectionalAppTaggingSecret, Tag, SiloedTag } from '@aztec/stdlib/logs';
19
- export { type PreTag } from '@aztec/stdlib/logs';
19
+ export { AppTaggingSecret, Tag, SiloedTag } from '@aztec/stdlib/logs';
20
+ export { type PreTag, type TaggingIndexRange } from '@aztec/stdlib/logs';
@@ -0,0 +1,57 @@
1
+ import type { Logger } from '@aztec/foundation/log';
2
+ import type { PrivateKernelTailCircuitPublicInputs } from '@aztec/stdlib/kernel';
3
+ import type { TaggingIndexRange } from '@aztec/stdlib/logs';
4
+ import type { TxHash } from '@aztec/stdlib/tx';
5
+
6
+ import type { SenderTaggingStore } from '../storage/tagging_store/sender_tagging_store.js';
7
+ import { reconcileTaggingIndexRangesAgainstSurvivingTags } from './reconcile_tagging_index_ranges.js';
8
+
9
+ /**
10
+ * Persists the tagging index ranges that a tx used as a sender, after reconciling them against the kernel's surviving
11
+ * private logs.
12
+ *
13
+ * The tagging index cache reserves an index for every log emission attempted during private execution, but the kernel
14
+ * may then squash some of those logs (e.g. when a note is created and nullified within the same tx). This function
15
+ * shrinks the recorded ranges to match the actual on-chain footprint before writing them, so that what we persist is
16
+ * consistent with what the network will see.
17
+ *
18
+ * @remarks Storing the recorded ranges in the DB may not be seen as necessary because we sync from chain before sending
19
+ * new logs, but the sync can only see logs already included in blocks. If we sent another transaction before this one
20
+ * was included from the same PXE, and that transaction contained a log with a tag derived from the same secret, we
21
+ * would reuse the tag and the transactions would be linked. Persisting in the DB prevents that linkage.
22
+ *
23
+ * @param store - The sender tagging store.
24
+ * @param recordedRanges - The tagging index ranges as recorded during private execution (pre-squash).
25
+ * @param publicInputs - The final kernel public inputs, used to determine which private logs survived squashing.
26
+ * @param getTxHash - Lazy accessor for the tx hash. Called only when there is something to persist, since computing
27
+ * the tx hash is expensive.
28
+ * @param jobId - Job context for staged writes to the store. See `JobCoordinator` for more details.
29
+ * @param log - Logger.
30
+ */
31
+ export async function persistSenderTaggingIndexRangesForTx(
32
+ store: SenderTaggingStore,
33
+ recordedRanges: TaggingIndexRange[],
34
+ publicInputs: PrivateKernelTailCircuitPublicInputs,
35
+ getTxHash: () => Promise<TxHash>,
36
+ jobId: string,
37
+ log: Logger,
38
+ ): Promise<void> {
39
+ if (recordedRanges.length === 0) {
40
+ log.debug(`No tagging index ranges used in the tx`);
41
+ return;
42
+ }
43
+
44
+ const survivingTags = new Set(
45
+ publicInputs.getNonEmptyPrivateLogs().map(privateLog => privateLog.fields[0].toString()),
46
+ );
47
+ const reconciledRanges = await reconcileTaggingIndexRangesAgainstSurvivingTags(recordedRanges, survivingTags);
48
+
49
+ if (reconciledRanges.length === 0) {
50
+ log.debug(`All tagging index ranges used in the tx were squashed by the kernel`, { recordedRanges });
51
+ return;
52
+ }
53
+
54
+ const txHash = await getTxHash();
55
+ await store.storePendingIndexes(reconciledRanges, txHash, jobId);
56
+ log.debug(`Stored used tagging index ranges as sender for the tx`, { recordedRanges, reconciledRanges });
57
+ }
@@ -0,0 +1,240 @@
1
+ import { BlockNumber } from '@aztec/foundation/branded-types';
2
+ import { isDefined } from '@aztec/foundation/types';
3
+ import type { BlockHash } from '@aztec/stdlib/block';
4
+ import type { AztecNode } from '@aztec/stdlib/interfaces/client';
5
+ import type { AppTaggingSecret, LogResult } from '@aztec/stdlib/logs';
6
+ import { SiloedTag } from '@aztec/stdlib/logs';
7
+ import type { BlockHeader } from '@aztec/stdlib/tx';
8
+
9
+ import type { RecipientTaggingStore } from '../../storage/tagging_store/recipient_tagging_store.js';
10
+ import { UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN } from '../constants.js';
11
+ import { getAllPrivateLogsByTags } from '../get_all_logs_by_tags.js';
12
+ import { findHighestIndexes } from './utils/find_highest_indexes.js';
13
+
14
+ /**
15
+ * Fetches and syncs tagged private logs for multiple sender-recipient pairs, batching tag queries across all secrets
16
+ * into shared RPC calls.
17
+ *
18
+ * # Explanation of how the algorithm works
19
+ *
20
+ * For each secret we sync logs that correspond to the tagging index range
21
+ * (highestAgedIndex, highestFinalizedIndex + WINDOW_LEN]
22
+ *
23
+ * highestAgedIndex is the highest index that was used in a tx that is included in a block at least
24
+ * `MAX_TX_LIFETIME` seconds ago.
25
+ * highestFinalizedIndex is the highest index that was used in a tx that is included in a finalized block.
26
+ *
27
+ * "(" denotes an open end of the range - the index is not included in the range.
28
+ * "]" denotes a closed end of the range - the index is included in the range.
29
+ *
30
+ * ## Explanation of highestAgedIndex
31
+ *
32
+ * highestAgedIndex is chosen such that for all tagging indexes `i <= highestAgedIndex` we know that no new logs can
33
+ * ever appear.
34
+ *
35
+ * This relies on the "maximum inclusion timestamp" rule enforced by the kernel and rollup circuits:
36
+ * - a transaction's maximum inclusion timestamp is at most `MAX_TX_LIFETIME` seconds after
37
+ * the timestamp of its anchor block; and
38
+ * - a rollup only includes transactions whose inclusion timestamp is >= the L2 block's timestamp.
39
+ *
40
+ * Suppose some device used index `I` in a transaction anchored to block `B_N` at time `N`, and that block is now at
41
+ * least `MAX_TX_LIFETIME` seconds in the past. Then there is no possibility of any *other* device
42
+ * trying to use an index <= `I` while anchoring to a *newer* block than `B_N` because if we were anchoring to
43
+ * a newer block than `B_N` then we would already have seen the log with index `I` and hence the device would have
44
+ * chosen a larger index.
45
+ * If that *other* device would anchor to a block older than `B_N` then that tx could never be included in a block
46
+ * because it would already have been expired.
47
+ *
48
+ * Therefore, once we see that index `I` has been used in a block that is at least `MAX_TX_LIFETIME`
49
+ * seconds old, we can safely stop syncing logs for all indexes <= `I` and set highestAgedIndex = `I`.
50
+ *
51
+ * ## Explanation of the upper bound `highestFinalizedIndex + WINDOW_LEN`
52
+ *
53
+ * When a sender chooses a tagging index, they will select an index that is at most `WINDOW_LEN` greater than
54
+ * the highest finalized index. If that index was already used, they will throw an error. For this reason we
55
+ * don't have to look further than `highestFinalizedIndex + WINDOW_LEN`.
56
+ *
57
+ * ## Batching across secrets
58
+ *
59
+ * Instead of running one RPC call per secret, we merge tags from all pending secrets into a single flat array,
60
+ * make one batched `getAllPrivateLogsByTags` call (which internally chunks at MAX_RPC_LEN), then split results
61
+ * back per secret using tracked offsets. Only secrets whose window advanced are kept for the next iteration.
62
+ */
63
+ export async function syncTaggedPrivateLogs(
64
+ secrets: AppTaggingSecret[],
65
+ aztecNode: AztecNode,
66
+ taggingStore: RecipientTaggingStore,
67
+ anchorBlockHeader: BlockHeader,
68
+ finalizedBlockNumber: BlockNumber,
69
+ jobId: string,
70
+ ): Promise<LogResult[]> {
71
+ if (secrets.length === 0) {
72
+ return [];
73
+ }
74
+
75
+ const anchorBlockNumber = anchorBlockHeader.getBlockNumber();
76
+ const anchorBlockHash = await anchorBlockHeader.hash();
77
+ const currentTimestamp = anchorBlockHeader.globalVariables.timestamp;
78
+
79
+ // Read stored indexes from the db and compute the initial [start, end) range for each secret
80
+ let pending = await getIndexRangesForSecrets(secrets, taggingStore, jobId);
81
+ const allLogs: LogResult[] = [];
82
+
83
+ while (pending.length > 0) {
84
+ // Compute tags for all pending secrets and fetch logs in batched RPC calls
85
+ const logsPerSecret = await fetchLogsForSecrets(pending, aztecNode, anchorBlockNumber, anchorBlockHash);
86
+
87
+ const nextRound = await Promise.all(
88
+ pending.map(async (pendingSecret, i) => {
89
+ const logsFoundWithSecret = logsPerSecret[i];
90
+ if (logsFoundWithSecret.length === 0) {
91
+ // No logs found, no need to update indexes or advance window.
92
+ return undefined;
93
+ }
94
+
95
+ allLogs.push(...logsFoundWithSecret.map(({ log }) => log));
96
+
97
+ // Persist new indexes. If the finalized index moved forward, the window advances
98
+ // and we need another round for this secret.
99
+ return await updateIndexesAndAdvanceWindow(
100
+ pendingSecret,
101
+ logsFoundWithSecret,
102
+ taggingStore,
103
+ currentTimestamp,
104
+ finalizedBlockNumber,
105
+ jobId,
106
+ );
107
+ }),
108
+ );
109
+
110
+ pending = nextRound.filter(isDefined);
111
+ }
112
+
113
+ return allLogs;
114
+ }
115
+
116
+ /** Reads stored indexes for each secret and computes the initial index range to query. */
117
+ function getIndexRangesForSecrets(
118
+ secrets: AppTaggingSecret[],
119
+ taggingStore: RecipientTaggingStore,
120
+ jobId: string,
121
+ ): Promise<PendingSecret[]> {
122
+ return Promise.all(
123
+ secrets.map(async secret => {
124
+ const [currentHighestAgedIndex, currentHighestFinalizedIndex] = await Promise.all([
125
+ taggingStore.getHighestAgedIndex(secret, jobId),
126
+ taggingStore.getHighestFinalizedIndex(secret, jobId),
127
+ ]);
128
+
129
+ const start = currentHighestAgedIndex === undefined ? 0 : currentHighestAgedIndex + 1;
130
+ const end = (currentHighestFinalizedIndex ?? 0) + UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN + 1;
131
+
132
+ return { secret, start, end };
133
+ }),
134
+ );
135
+ }
136
+
137
+ /**
138
+ * Computes siloed tags for all pending secrets' index ranges, fetches logs in one batched RPC call,
139
+ * and returns the results grouped back per secret.
140
+ */
141
+ async function fetchLogsForSecrets(
142
+ pending: PendingSecret[],
143
+ aztecNode: AztecNode,
144
+ anchorBlockNumber: BlockNumber,
145
+ anchorBlockHash: BlockHash,
146
+ ): Promise<LogWithIndex[][]> {
147
+ // Determine the index range for each secret
148
+ const indexesPerSecret = pending.map(({ start, end }) => Array.from({ length: end - start }, (_, i) => start + i));
149
+
150
+ // Compute siloed tags for all indexes
151
+ const tagsPerSecret = await Promise.all(
152
+ pending.map(({ secret }, i) =>
153
+ Promise.all(indexesPerSecret[i].map(index => SiloedTag.compute({ extendedSecret: secret, index }))),
154
+ ),
155
+ );
156
+
157
+ const allTags = tagsPerSecret.flat();
158
+
159
+ // getAllPrivateLogsByTags handles MAX_RPC_LEN chunking internally. Recipient sync builds `PendingTaggedLog` from
160
+ // each log's note hashes and first nullifier, so we opt into effects. The `toBlock` cap (anchor block + 1,
161
+ // exclusive) tells the node to skip any logs in blocks past the anchor — the same guard previously enforced
162
+ // by an in-memory filter on the response.
163
+ const allResults = await getAllPrivateLogsByTags(aztecNode, allTags, anchorBlockHash, {
164
+ includeEffects: true,
165
+ toBlock: BlockNumber(anchorBlockNumber + 1),
166
+ });
167
+
168
+ // Split flat results back per secret using the known lengths
169
+ const logsPerSecret: LogWithIndex[][] = [];
170
+ let offset = 0;
171
+ for (const indexes of indexesPerSecret) {
172
+ const logsForSecret: LogWithIndex[] = [];
173
+ for (let i = 0; i < indexes.length; i++) {
174
+ for (const log of allResults[offset + i]) {
175
+ logsForSecret.push({ log, taggingIndex: indexes[i] });
176
+ }
177
+ }
178
+ logsPerSecret.push(logsForSecret);
179
+ offset += indexes.length;
180
+ }
181
+
182
+ return logsPerSecret;
183
+ }
184
+
185
+ /**
186
+ * Processes a single secret's fetched logs: updates stored indexes and returns a new PendingSecret
187
+ * if the window needs to advance, or undefined if this secret is done.
188
+ */
189
+ async function updateIndexesAndAdvanceWindow(
190
+ pending: PendingSecret,
191
+ logsWithIndexes: LogWithIndex[],
192
+ taggingStore: RecipientTaggingStore,
193
+ currentTimestamp: bigint,
194
+ finalizedBlockNumber: BlockNumber,
195
+ jobId: string,
196
+ ): Promise<PendingSecret | undefined> {
197
+ const { highestAgedIndex, highestFinalizedIndex } = findHighestIndexes(
198
+ logsWithIndexes,
199
+ currentTimestamp,
200
+ finalizedBlockNumber,
201
+ );
202
+
203
+ // Store updates in data provider and update local variables
204
+ if (highestAgedIndex !== undefined) {
205
+ await taggingStore.updateHighestAgedIndex(pending.secret, highestAgedIndex, jobId);
206
+ }
207
+
208
+ if (highestFinalizedIndex === undefined) {
209
+ // We have not found a new highest finalized index, so there is no need to move the window forward.
210
+ return undefined;
211
+ }
212
+
213
+ if (highestAgedIndex !== undefined && highestAgedIndex > highestFinalizedIndex) {
214
+ // This is just a sanity check as this should never happen.
215
+ throw new Error(
216
+ `Highest aged index (${highestAgedIndex}) must not exceed highest finalized index (${highestFinalizedIndex})`,
217
+ );
218
+ }
219
+
220
+ await taggingStore.updateHighestFinalizedIndex(pending.secret, highestFinalizedIndex, jobId);
221
+
222
+ // For the next iteration we want to look only at indexes for which we have not yet fetched logs while
223
+ // ensuring that we do not look further than WINDOW_LEN ahead of the highest finalized index.
224
+ return {
225
+ secret: pending.secret,
226
+ start: pending.end,
227
+ end: highestFinalizedIndex + UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN + 1,
228
+ };
229
+ }
230
+
231
+ type PendingSecret = {
232
+ secret: AppTaggingSecret;
233
+ start: number;
234
+ end: number;
235
+ };
236
+
237
+ type LogWithIndex = {
238
+ log: LogResult;
239
+ taggingIndex: number;
240
+ };
@@ -1,11 +1,11 @@
1
- import { MAX_INCLUDE_BY_TIMESTAMP_DURATION } from '@aztec/constants';
2
- import type { TxScopedL2Log } from '@aztec/stdlib/logs';
1
+ import { MAX_TX_LIFETIME } from '@aztec/constants';
2
+ import type { LogResult } from '@aztec/stdlib/logs';
3
3
 
4
4
  /**
5
5
  * Finds the highest aged and the highest finalized tagging indexes.
6
6
  */
7
7
  export function findHighestIndexes(
8
- privateLogsWithIndexes: Array<{ log: TxScopedL2Log; taggingIndex: number }>,
8
+ privateLogsWithIndexes: Array<{ log: LogResult; taggingIndex: number }>,
9
9
  currentTimestamp: bigint,
10
10
  finalizedBlockNumber: number,
11
11
  ): { highestAgedIndex: number | undefined; highestFinalizedIndex: number | undefined } {
@@ -16,7 +16,7 @@ export function findHighestIndexes(
16
16
  const ageInSeconds = currentTimestamp - log.blockTimestamp;
17
17
 
18
18
  if (
19
- ageInSeconds >= BigInt(MAX_INCLUDE_BY_TIMESTAMP_DURATION) &&
19
+ ageInSeconds >= BigInt(MAX_TX_LIFETIME) &&
20
20
  (highestAgedIndex === undefined || taggingIndex > highestAgedIndex)
21
21
  ) {
22
22
  highestAgedIndex = taggingIndex;
@@ -0,0 +1,102 @@
1
+ import { type AppTaggingSecret, SiloedTag, type TaggingIndexRange } from '@aztec/stdlib/logs';
2
+
3
+ /**
4
+ * Reconciles tagging index ranges recorded by the PXE during private execution against the set of siloed tags whose
5
+ * private logs survived to the final kernel output.
6
+ *
7
+ * Each input range is the contiguous `[lowestIndex, highestIndex]` set of indexes that the tagging index cache
8
+ * reserved for a given tagging secret while a tx was being executed. The kernel may then squash some of those logs
9
+ * (e.g. when a note is created and nullified within the same tx, taking its log with it), so the actual on-chain
10
+ * footprint can be a strict subset of what was reserved.
11
+ *
12
+ * For each input range, this function shrinks `[lowestIndex, highestIndex]` so that both bounds correspond to indexes
13
+ * that actually survived, trimming any dropped indices at the front or the back. It is possible that some interior
14
+ * indexes were also dropped, leaving gaps between the lowest and highest indices, but we ignore those and accept the
15
+ * resulting inefficiency rather than complicate the tagging model with one in which transactions may use interleaved
16
+ * indices.
17
+ *
18
+ * Trimming tailing indices (e.g. `highestIndex`) is highly useful as it lets us reuse those indices in future
19
+ * transactions. Trimming indices at the front (e.g. `lowestIndex`) is not as impactful since we will not ever use a
20
+ * tagging index if a larger one exists (same as with gaps), but it does help in both making the consistency check
21
+ * between database and transaction effects cheaper (as there's fewer logs to test) and making the database more
22
+ * accurately reflect reality.
23
+ *
24
+ * Ranges with no surviving indexes are dropped from the output entirely.
25
+ *
26
+ * Example scenario:
27
+ * - used indexes 3 to 7, kerel squashed indexes 3, 5, and 7:
28
+ * - range: [3, 7]
29
+ * - survived: set(3, 5, 7)
30
+ * - output: [4, 6] (trimmed from both ends, gap at 5 is tolerated)
31
+ *
32
+ * @param ranges - The tagging index ranges as recorded during private execution (pre-squash).
33
+ * @param survivingTags - The set of siloed tag values (as strings) of private logs that survived kernel squashing.
34
+ * @returns The reconciled ranges, with bounds tightened to surviving indexes and fully-squashed ranges removed.
35
+ */
36
+ export async function reconcileTaggingIndexRangesAgainstSurvivingTags(
37
+ ranges: TaggingIndexRange[],
38
+ survivingTags: Set<string>,
39
+ ): Promise<TaggingIndexRange[]> {
40
+ const reconciled: TaggingIndexRange[] = [];
41
+
42
+ for (const range of ranges) {
43
+ const newLowestIndex = await findFirstSurvivingIndex(
44
+ range.extendedSecret,
45
+ range.lowestIndex,
46
+ range.highestIndex,
47
+ survivingTags,
48
+ );
49
+ if (newLowestIndex === undefined) {
50
+ // No index in this range corresponds to a surviving log: the entire range was squashed.
51
+ continue;
52
+ }
53
+
54
+ // newLowestIndex is itself a survivor, so the backward scan is guaranteed to find at least that index.
55
+ const newHighestIndex = await findLastSurvivingIndex(
56
+ range.extendedSecret,
57
+ newLowestIndex,
58
+ range.highestIndex,
59
+ survivingTags,
60
+ );
61
+
62
+ reconciled.push({
63
+ extendedSecret: range.extendedSecret,
64
+ lowestIndex: newLowestIndex,
65
+ highestIndex: newHighestIndex!,
66
+ });
67
+ }
68
+
69
+ return reconciled;
70
+ }
71
+
72
+ /** Scans `[start, end]` ascending and returns the first index whose siloed tag is in `survivingTags`. */
73
+ async function findFirstSurvivingIndex(
74
+ secret: AppTaggingSecret,
75
+ start: number,
76
+ end: number,
77
+ survivingTags: Set<string>,
78
+ ): Promise<number | undefined> {
79
+ for (let index = start; index <= end; index++) {
80
+ const tag = await SiloedTag.compute({ extendedSecret: secret, index });
81
+ if (survivingTags.has(tag.value.toString())) {
82
+ return index;
83
+ }
84
+ }
85
+ return undefined;
86
+ }
87
+
88
+ /** Scans `[start, end]` descending and returns the first index whose siloed tag is in `survivingTags`. */
89
+ async function findLastSurvivingIndex(
90
+ secret: AppTaggingSecret,
91
+ start: number,
92
+ end: number,
93
+ survivingTags: Set<string>,
94
+ ): Promise<number | undefined> {
95
+ for (let index = end; index >= start; index--) {
96
+ const tag = await SiloedTag.compute({ extendedSecret: secret, index });
97
+ if (survivingTags.has(tag.value.toString())) {
98
+ return index;
99
+ }
100
+ }
101
+ return undefined;
102
+ }
@@ -1,21 +1,20 @@
1
- import type { AztecAddress } from '@aztec/stdlib/aztec-address';
2
1
  import type { BlockHash } from '@aztec/stdlib/block';
3
2
  import type { AztecNode } from '@aztec/stdlib/interfaces/server';
4
- import type { DirectionalAppTaggingSecret } from '@aztec/stdlib/logs';
3
+ import type { AppTaggingSecret } from '@aztec/stdlib/logs';
5
4
 
6
5
  import type { SenderTaggingStore } from '../../storage/tagging_store/sender_tagging_store.js';
7
6
  import { UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN } from '../constants.js';
8
- import { getStatusChangeOfPending } from './utils/get_status_change_of_pending.js';
7
+ import {
8
+ EMPTY_STATUS_CHANGE,
9
+ getStatusChangeOfPending,
10
+ mergeStatusChanges,
11
+ } from './utils/get_status_change_of_pending.js';
9
12
  import { loadAndStoreNewTaggingIndexes } from './utils/load_and_store_new_tagging_indexes.js';
10
13
 
11
14
  /**
12
15
  * Syncs tagging indexes. This function needs to be called whenever a private log is being sent.
13
16
  *
14
- * @param secret - The secret that's unique for (sender, recipient, contract) tuple while the direction of
15
- * sender -> recipient matters.
16
- * @param app - The address of the contract that the logs are tagged for. Needs to be provided because we perform
17
- * second round of siloing in this function which is necessary because kernels do it as well (they silo first field
18
- * of the private log which corresponds to the tag).
17
+ * @param secret - The sender-side tagging `AppTaggingSecret`.
19
18
  * @remarks When syncing the indexes as sender we don't care about the log contents - we only care about the highest
20
19
  * pending and highest finalized indexes as that guides the next index choice when sending a log. The next index choice
21
20
  * is simply the highest pending index plus one (or finalized if pending is undefined).
@@ -23,8 +22,7 @@ import { loadAndStoreNewTaggingIndexes } from './utils/load_and_store_new_taggin
23
22
  * updates its status accordingly.
24
23
  */
25
24
  export async function syncSenderTaggingIndexes(
26
- secret: DirectionalAppTaggingSecret,
27
- app: AztecAddress,
25
+ secret: AppTaggingSecret,
28
26
  aztecNode: AztecNode,
29
27
  taggingStore: SenderTaggingStore,
30
28
  anchorBlockHash: BlockHash,
@@ -57,21 +55,58 @@ export async function syncSenderTaggingIndexes(
57
55
  let newFinalizedIndex = undefined;
58
56
 
59
57
  while (true) {
60
- // Load and store indexes for the current window. These indexes may already exist in the database if txs using
61
- // them were previously sent from this PXE. Any duplicates are handled by the tagging data provider.
62
- await loadAndStoreNewTaggingIndexes(secret, app, start, end, aztecNode, taggingStore, anchorBlockHash, jobId);
58
+ // Pending tx hashes already in the store for this window (from prior syncs or txs this PXE itself sent).
59
+ // Reading these before issuing any RPC lets us fetch their receipts in parallel with the logs query below.
60
+ const knownPendingTxHashes = await taggingStore.getTxHashesOfPendingIndexes(secret, start, end, jobId);
63
61
 
64
- // Retrieve all indexes within the current window from storage and update their status accordingly.
65
- const pendingTxHashes = await taggingStore.getTxHashesOfPendingIndexes(secret, start, end, jobId);
66
- if (pendingTxHashes.length === 0) {
62
+ // Fire the logs query and the known-pending receipts query in parallel
63
+ const [, statusOfKnown] = await Promise.all([
64
+ loadAndStoreNewTaggingIndexes(secret, start, end, aztecNode, taggingStore, anchorBlockHash, jobId),
65
+ knownPendingTxHashes.length > 0
66
+ ? getStatusChangeOfPending(knownPendingTxHashes, aztecNode)
67
+ : Promise.resolve(EMPTY_STATUS_CHANGE),
68
+ ]);
69
+
70
+ // Re-read pending tx hashes after the logs query writes any newly-discovered ones to the store.
71
+ const allPendingTxHashes = await taggingStore.getTxHashesOfPendingIndexes(secret, start, end, jobId);
72
+ if (allPendingTxHashes.length === 0) {
67
73
  break;
68
74
  }
69
75
 
70
- const { txHashesToFinalize, txHashesToDrop } = await getStatusChangeOfPending(pendingTxHashes, aztecNode);
76
+ // Receipts for pending tx hashes that the logs query just surfaced still need a sequential follow-up call.
77
+ // `storePendingIndexes` is idempotent on (secret, txHash), so a re-discovered hash stays classified as known
78
+ // and is not re-fetched here.
79
+ const knownSet = new Set(knownPendingTxHashes.map(h => h.toString()));
80
+ const newPendingTxHashes = allPendingTxHashes.filter(h => !knownSet.has(h.toString()));
81
+
82
+ const statusOfNew =
83
+ newPendingTxHashes.length > 0
84
+ ? await getStatusChangeOfPending(newPendingTxHashes, aztecNode)
85
+ : EMPTY_STATUS_CHANGE;
86
+
87
+ const { txHashesToFinalize, txHashesToDrop, txHashesWithExecutionReverted } = mergeStatusChanges(
88
+ statusOfKnown,
89
+ statusOfNew,
90
+ );
71
91
 
72
92
  await taggingStore.dropPendingIndexes(txHashesToDrop, jobId);
73
93
  await taggingStore.finalizePendingIndexes(txHashesToFinalize, jobId);
74
94
 
95
+ if (txHashesWithExecutionReverted.length > 0) {
96
+ const receipts = await Promise.all(
97
+ txHashesWithExecutionReverted.map(txHash => aztecNode.getTxReceipt(txHash, { includeTxEffect: true })),
98
+ );
99
+ for (const receipt of receipts) {
100
+ if (!receipt.isMined() || !receipt.txEffect) {
101
+ throw new Error(
102
+ 'TxEffect not found for execution-reverted tx. This is either a bug or a reorg has occurred.',
103
+ );
104
+ }
105
+
106
+ await taggingStore.finalizePendingIndexesOfAPartiallyRevertedTx(receipt.txEffect, jobId);
107
+ }
108
+ }
109
+
75
110
  // We check if the finalized index has been updated.
76
111
  newFinalizedIndex = await taggingStore.getLastFinalizedIndex(secret, jobId);
77
112
  if (previousFinalizedIndex !== newFinalizedIndex) {
@@ -1,36 +1,66 @@
1
1
  import type { AztecNode } from '@aztec/stdlib/interfaces/server';
2
2
  import { TxHash, TxStatus } from '@aztec/stdlib/tx';
3
3
 
4
+ /** Classification of a batch of pending tx hashes by the status change implied by their receipts. */
5
+ export type StatusChange = {
6
+ txHashesToFinalize: TxHash[];
7
+ txHashesToDrop: TxHash[];
8
+ txHashesWithExecutionReverted: TxHash[];
9
+ };
10
+
11
+ export const EMPTY_STATUS_CHANGE: StatusChange = {
12
+ txHashesToFinalize: [],
13
+ txHashesToDrop: [],
14
+ txHashesWithExecutionReverted: [],
15
+ };
16
+
17
+ /** Concatenates two status changes field-by-field. */
18
+ export function mergeStatusChanges(a: StatusChange, b: StatusChange): StatusChange {
19
+ return {
20
+ txHashesToFinalize: [...a.txHashesToFinalize, ...b.txHashesToFinalize],
21
+ txHashesToDrop: [...a.txHashesToDrop, ...b.txHashesToDrop],
22
+ txHashesWithExecutionReverted: [...a.txHashesWithExecutionReverted, ...b.txHashesWithExecutionReverted],
23
+ };
24
+ }
25
+
4
26
  /**
5
- * Based on receipts obtained from `aztecNode` returns which pending transactions changed their status to finalized or
6
- * dropped.
27
+ * Based on receipts obtained from `aztecNode` returns which pending transactions changed their status to finalized,
28
+ * dropped, or execution-reverted (but mined).
7
29
  */
8
- export async function getStatusChangeOfPending(
9
- pending: TxHash[],
10
- aztecNode: AztecNode,
11
- ): Promise<{ txHashesToFinalize: TxHash[]; txHashesToDrop: TxHash[] }> {
30
+ export async function getStatusChangeOfPending(pending: TxHash[], aztecNode: AztecNode): Promise<StatusChange> {
12
31
  // Get receipts for all pending tx hashes.
13
32
  const receipts = await Promise.all(pending.map(pendingTxHash => aztecNode.getTxReceipt(pendingTxHash)));
14
33
 
15
34
  const txHashesToFinalize: TxHash[] = [];
16
35
  const txHashesToDrop: TxHash[] = [];
36
+ const txHashesWithExecutionReverted: TxHash[] = [];
17
37
 
18
38
  for (let i = 0; i < receipts.length; i++) {
19
39
  const receipt = receipts[i];
20
40
  const txHash = pending[i];
21
41
 
22
- if (receipt.status === TxStatus.FINALIZED && receipt.hasExecutionSucceeded()) {
23
- // Tx has been included in a block and the corresponding block is finalized --> we mark the indexes as
24
- // finalized.
25
- txHashesToFinalize.push(txHash);
26
- } else if (receipt.isDropped() || receipt.hasExecutionReverted()) {
27
- // Tx was dropped or reverted --> we drop the corresponding pending indexes.
28
- // TODO(#17615): Don't drop pending indexes corresponding to non-revertible phases.
42
+ if (receipt.status === TxStatus.FINALIZED) {
43
+ // Tx has been included in a block and the corresponding block is finalized
44
+ if (receipt.hasExecutionSucceeded()) {
45
+ // No part of execution reverted - we just finalize all the indexes.
46
+ txHashesToFinalize.push(txHash);
47
+ } else if (receipt.hasExecutionReverted()) {
48
+ // Tx was mined but execution reverted (app logic, teardown, or both). Some logs from the non-revertible
49
+ // phase may still be onchain. We check which tags made it onchain and finalize those; drop the rest.
50
+ txHashesWithExecutionReverted.push(txHash);
51
+ } else {
52
+ // Defensive check - this branch should never be triggered
53
+ throw new Error(
54
+ 'Both hasExecutionSucceeded and hasExecutionReverted on the receipt returned false. This should never happen and it implies a bug. Please open an issue.',
55
+ );
56
+ }
57
+ } else if (receipt.isDropped()) {
58
+ // Tx was dropped from the mempool --> we drop the corresponding pending indexes.
29
59
  txHashesToDrop.push(txHash);
30
60
  } else {
31
61
  // Tx is still pending, not yet finalized, or was mined successfully but not yet finalized --> we don't do anything.
32
62
  }
33
63
  }
34
64
 
35
- return { txHashesToFinalize, txHashesToDrop };
65
+ return { txHashesToFinalize, txHashesToDrop, txHashesWithExecutionReverted };
36
66
  }