@aztec/pxe 0.0.1-commit.96dac018d → 0.0.1-commit.993d240

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 (312) 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 +31 -25
  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 +6 -2
  11. package/dest/block_synchronizer/block_synchronizer.d.ts.map +1 -1
  12. package/dest/block_synchronizer/block_synchronizer.js +30 -10
  13. package/dest/config/index.d.ts +8 -2
  14. package/dest/config/index.d.ts.map +1 -1
  15. package/dest/config/index.js +13 -15
  16. package/dest/contract_function_simulator/contract_function_simulator.d.ts +16 -5
  17. package/dest/contract_function_simulator/contract_function_simulator.d.ts.map +1 -1
  18. package/dest/contract_function_simulator/contract_function_simulator.js +53 -18
  19. package/dest/contract_function_simulator/ephemeral_array_service.d.ts +28 -0
  20. package/dest/contract_function_simulator/ephemeral_array_service.d.ts.map +1 -0
  21. package/dest/contract_function_simulator/ephemeral_array_service.js +78 -0
  22. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts +7 -11
  23. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts.map +1 -1
  24. package/dest/contract_function_simulator/execution_tagging_index_cache.js +19 -15
  25. package/dest/contract_function_simulator/index.d.ts +4 -1
  26. package/dest/contract_function_simulator/index.d.ts.map +1 -1
  27. package/dest/contract_function_simulator/index.js +3 -0
  28. package/dest/contract_function_simulator/noir-structs/bounded_vec.d.ts +48 -0
  29. package/dest/contract_function_simulator/noir-structs/bounded_vec.d.ts.map +1 -0
  30. package/dest/contract_function_simulator/noir-structs/bounded_vec.js +45 -0
  31. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts +4 -6
  32. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts.map +1 -1
  33. package/dest/contract_function_simulator/noir-structs/event_validation_request.js +8 -9
  34. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.d.ts +13 -3
  35. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.d.ts.map +1 -1
  36. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.js +35 -4
  37. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts +2 -2
  38. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts.map +1 -1
  39. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.js +2 -4
  40. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts +4 -7
  41. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts.map +1 -1
  42. package/dest/contract_function_simulator/noir-structs/note_validation_request.js +6 -10
  43. package/dest/contract_function_simulator/noir-structs/option.d.ts +61 -0
  44. package/dest/contract_function_simulator/noir-structs/option.d.ts.map +1 -0
  45. package/dest/contract_function_simulator/noir-structs/option.js +62 -0
  46. package/dest/contract_function_simulator/oracle/interfaces.d.ts +67 -51
  47. package/dest/contract_function_simulator/oracle/interfaces.d.ts.map +1 -1
  48. package/dest/contract_function_simulator/oracle/note_packing_utils.d.ts +2 -2
  49. package/dest/contract_function_simulator/oracle/note_packing_utils.d.ts.map +1 -1
  50. package/dest/contract_function_simulator/oracle/note_packing_utils.js +2 -2
  51. package/dest/contract_function_simulator/oracle/oracle.d.ts +74 -45
  52. package/dest/contract_function_simulator/oracle/oracle.d.ts.map +1 -1
  53. package/dest/contract_function_simulator/oracle/oracle.js +471 -287
  54. package/dest/contract_function_simulator/oracle/oracle_registry.d.ts +147 -0
  55. package/dest/contract_function_simulator/oracle/oracle_registry.d.ts.map +1 -0
  56. package/dest/contract_function_simulator/oracle/oracle_registry.js +1199 -0
  57. package/dest/contract_function_simulator/oracle/private_execution.js +5 -3
  58. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts +44 -70
  59. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts.map +1 -1
  60. package/dest/contract_function_simulator/oracle/private_execution_oracle.js +96 -99
  61. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts +112 -67
  62. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts.map +1 -1
  63. package/dest/contract_function_simulator/oracle/utility_execution_oracle.js +395 -141
  64. package/dest/contract_function_simulator/pick_notes.d.ts +1 -1
  65. package/dest/contract_function_simulator/pick_notes.d.ts.map +1 -1
  66. package/dest/contract_function_simulator/pick_notes.js +20 -3
  67. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts +1 -1
  68. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts.map +1 -1
  69. package/dest/contract_function_simulator/proxied_contract_data_source.js +35 -64
  70. package/dest/contract_logging.d.ts +9 -4
  71. package/dest/contract_logging.d.ts.map +1 -1
  72. package/dest/contract_logging.js +21 -6
  73. package/dest/contract_sync/contract_sync_service.d.ts +7 -8
  74. package/dest/contract_sync/contract_sync_service.d.ts.map +1 -1
  75. package/dest/contract_sync/contract_sync_service.js +87 -49
  76. package/dest/contract_sync/helpers.d.ts +2 -4
  77. package/dest/contract_sync/helpers.d.ts.map +1 -1
  78. package/dest/contract_sync/helpers.js +12 -14
  79. package/dest/debug/pxe_debug_utils.d.ts +3 -8
  80. package/dest/debug/pxe_debug_utils.d.ts.map +1 -1
  81. package/dest/debug/pxe_debug_utils.js +0 -6
  82. package/dest/entrypoints/client/bundle/index.d.ts +1 -2
  83. package/dest/entrypoints/client/bundle/index.d.ts.map +1 -1
  84. package/dest/entrypoints/client/bundle/index.js +0 -1
  85. package/dest/entrypoints/client/bundle/utils.d.ts +2 -2
  86. package/dest/entrypoints/client/bundle/utils.d.ts.map +1 -1
  87. package/dest/entrypoints/client/bundle/utils.js +13 -5
  88. package/dest/entrypoints/client/lazy/index.d.ts +1 -2
  89. package/dest/entrypoints/client/lazy/index.d.ts.map +1 -1
  90. package/dest/entrypoints/client/lazy/index.js +0 -1
  91. package/dest/entrypoints/client/lazy/utils.d.ts +2 -2
  92. package/dest/entrypoints/client/lazy/utils.d.ts.map +1 -1
  93. package/dest/entrypoints/client/lazy/utils.js +13 -5
  94. package/dest/entrypoints/pxe_creation_options.d.ts +9 -1
  95. package/dest/entrypoints/pxe_creation_options.d.ts.map +1 -1
  96. package/dest/entrypoints/pxe_creation_options.js +3 -1
  97. package/dest/entrypoints/server/index.d.ts +3 -3
  98. package/dest/entrypoints/server/index.d.ts.map +1 -1
  99. package/dest/entrypoints/server/index.js +2 -2
  100. package/dest/entrypoints/server/utils.d.ts +4 -3
  101. package/dest/entrypoints/server/utils.d.ts.map +1 -1
  102. package/dest/entrypoints/server/utils.js +13 -5
  103. package/dest/events/event_service.d.ts +15 -6
  104. package/dest/events/event_service.d.ts.map +1 -1
  105. package/dest/events/event_service.js +44 -11
  106. package/dest/events/private_event_filter_validator.d.ts +3 -2
  107. package/dest/events/private_event_filter_validator.d.ts.map +1 -1
  108. package/dest/events/private_event_filter_validator.js +15 -0
  109. package/dest/hooks/authorize_utility_call.d.ts +41 -0
  110. package/dest/hooks/authorize_utility_call.d.ts.map +1 -0
  111. package/dest/hooks/authorize_utility_call.js +4 -0
  112. package/dest/hooks/execution_hooks.d.ts +42 -0
  113. package/dest/hooks/execution_hooks.d.ts.map +1 -0
  114. package/dest/hooks/execution_hooks.js +9 -0
  115. package/dest/hooks/index.d.ts +4 -0
  116. package/dest/hooks/index.d.ts.map +1 -0
  117. package/dest/hooks/index.js +1 -0
  118. package/dest/logs/log_service.d.ts +9 -9
  119. package/dest/logs/log_service.d.ts.map +1 -1
  120. package/dest/logs/log_service.js +122 -72
  121. package/dest/messages/message_context_service.d.ts +17 -0
  122. package/dest/messages/message_context_service.d.ts.map +1 -0
  123. package/dest/messages/message_context_service.js +38 -0
  124. package/dest/notes/note_service.d.ts +27 -6
  125. package/dest/notes/note_service.d.ts.map +1 -1
  126. package/dest/notes/note_service.js +80 -56
  127. package/dest/notes_filter.d.ts +2 -3
  128. package/dest/notes_filter.d.ts.map +1 -1
  129. package/dest/oracle_version.d.ts +4 -3
  130. package/dest/oracle_version.d.ts.map +1 -1
  131. package/dest/oracle_version.js +20 -10
  132. package/dest/private_kernel/batch_planner.d.ts +47 -0
  133. package/dest/private_kernel/batch_planner.d.ts.map +1 -0
  134. package/dest/private_kernel/batch_planner.js +104 -0
  135. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.js +1 -1
  136. package/dest/private_kernel/hints/test_utils.d.ts +1 -1
  137. package/dest/private_kernel/hints/test_utils.d.ts.map +1 -1
  138. package/dest/private_kernel/hints/test_utils.js +2 -3
  139. package/dest/private_kernel/private_kernel_execution_prover.d.ts +6 -2
  140. package/dest/private_kernel/private_kernel_execution_prover.d.ts.map +1 -1
  141. package/dest/private_kernel/private_kernel_execution_prover.js +152 -59
  142. package/dest/private_kernel/private_kernel_oracle.d.ts +10 -10
  143. package/dest/private_kernel/private_kernel_oracle.d.ts.map +1 -1
  144. package/dest/private_kernel/private_kernel_oracle.js +24 -22
  145. package/dest/pxe.d.ts +61 -11
  146. package/dest/pxe.d.ts.map +1 -1
  147. package/dest/pxe.js +162 -97
  148. package/dest/storage/anchor_block_store/anchor_block_store.js +1 -1
  149. package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.d.ts +42 -0
  150. package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.d.ts.map +1 -0
  151. package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.js +93 -0
  152. package/dest/storage/backwards_compatibility_tests/schema_tests.d.ts +15 -0
  153. package/dest/storage/backwards_compatibility_tests/schema_tests.d.ts.map +1 -0
  154. package/dest/storage/backwards_compatibility_tests/schema_tests.js +591 -0
  155. package/dest/storage/backwards_compatibility_tests/store_spy.d.ts +19 -0
  156. package/dest/storage/backwards_compatibility_tests/store_spy.d.ts.map +1 -0
  157. package/dest/storage/backwards_compatibility_tests/store_spy.js +63 -0
  158. package/dest/storage/capsule_store/capsule_service.d.ts +21 -0
  159. package/dest/storage/capsule_store/capsule_service.d.ts.map +1 -0
  160. package/dest/storage/capsule_store/capsule_service.js +50 -0
  161. package/dest/storage/capsule_store/capsule_store.d.ts +9 -9
  162. package/dest/storage/capsule_store/capsule_store.d.ts.map +1 -1
  163. package/dest/storage/capsule_store/capsule_store.js +36 -28
  164. package/dest/storage/capsule_store/index.d.ts +2 -1
  165. package/dest/storage/capsule_store/index.d.ts.map +1 -1
  166. package/dest/storage/capsule_store/index.js +1 -0
  167. package/dest/storage/contract_store/contract_store.d.ts +1 -1
  168. package/dest/storage/contract_store/contract_store.d.ts.map +1 -1
  169. package/dest/storage/contract_store/contract_store.js +9 -26
  170. package/dest/storage/metadata.d.ts +1 -1
  171. package/dest/storage/metadata.js +1 -1
  172. package/dest/storage/note_store/note_store.d.ts +1 -1
  173. package/dest/storage/note_store/note_store.d.ts.map +1 -1
  174. package/dest/storage/note_store/note_store.js +2 -2
  175. package/dest/storage/open_pxe_stores.d.ts +33 -0
  176. package/dest/storage/open_pxe_stores.d.ts.map +1 -0
  177. package/dest/storage/open_pxe_stores.js +27 -0
  178. package/dest/storage/private_event_store/private_event_store.d.ts +1 -1
  179. package/dest/storage/private_event_store/private_event_store.d.ts.map +1 -1
  180. package/dest/storage/private_event_store/private_event_store.js +3 -0
  181. package/dest/storage/private_event_store/stored_private_event.js +1 -1
  182. package/dest/storage/tagging_store/recipient_tagging_store.d.ts +6 -6
  183. package/dest/storage/tagging_store/recipient_tagging_store.d.ts.map +1 -1
  184. package/dest/storage/tagging_store/sender_tagging_store.d.ts +29 -28
  185. package/dest/storage/tagging_store/sender_tagging_store.d.ts.map +1 -1
  186. package/dest/storage/tagging_store/sender_tagging_store.js +141 -115
  187. package/dest/tagging/get_all_logs_by_tags.d.ts +34 -10
  188. package/dest/tagging/get_all_logs_by_tags.d.ts.map +1 -1
  189. package/dest/tagging/get_all_logs_by_tags.js +36 -37
  190. package/dest/tagging/index.d.ts +6 -5
  191. package/dest/tagging/index.d.ts.map +1 -1
  192. package/dest/tagging/index.js +4 -3
  193. package/dest/tagging/persist_sender_tagging_index_ranges.d.ts +29 -0
  194. package/dest/tagging/persist_sender_tagging_index_ranges.d.ts.map +1 -0
  195. package/dest/tagging/persist_sender_tagging_index_ranges.js +42 -0
  196. package/dest/tagging/recipient_sync/sync_tagged_private_logs.d.ts +56 -0
  197. package/dest/tagging/recipient_sync/sync_tagged_private_logs.d.ts.map +1 -0
  198. package/dest/tagging/recipient_sync/sync_tagged_private_logs.js +163 -0
  199. package/dest/tagging/recipient_sync/utils/find_highest_indexes.d.ts +3 -3
  200. package/dest/tagging/recipient_sync/utils/find_highest_indexes.d.ts.map +1 -1
  201. package/dest/tagging/reconcile_tagging_index_ranges.d.ts +36 -0
  202. package/dest/tagging/reconcile_tagging_index_ranges.d.ts.map +1 -0
  203. package/dest/tagging/reconcile_tagging_index_ranges.js +74 -0
  204. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts +4 -9
  205. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts.map +1 -1
  206. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.js +30 -14
  207. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts +13 -7
  208. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts.map +1 -1
  209. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.js +41 -10
  210. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts +5 -7
  211. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts.map +1 -1
  212. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.js +37 -25
  213. package/package.json +20 -17
  214. package/src/bin/check_oracle_version.ts +41 -31
  215. package/src/bin/index.ts +1 -0
  216. package/src/block_synchronizer/block_stream_source.ts +81 -0
  217. package/src/block_synchronizer/block_synchronizer.ts +33 -11
  218. package/src/config/index.ts +15 -9
  219. package/src/contract_function_simulator/contract_function_simulator.ts +82 -22
  220. package/src/contract_function_simulator/ephemeral_array_service.ts +110 -0
  221. package/src/contract_function_simulator/execution_tagging_index_cache.ts +19 -18
  222. package/src/contract_function_simulator/index.ts +3 -0
  223. package/src/contract_function_simulator/noir-structs/bounded_vec.ts +55 -0
  224. package/src/contract_function_simulator/noir-structs/event_validation_request.ts +10 -9
  225. package/src/contract_function_simulator/noir-structs/log_retrieval_request.ts +36 -3
  226. package/src/contract_function_simulator/noir-structs/log_retrieval_response.ts +2 -5
  227. package/src/contract_function_simulator/noir-structs/note_validation_request.ts +5 -10
  228. package/src/contract_function_simulator/noir-structs/option.ts +69 -0
  229. package/src/contract_function_simulator/oracle/interfaces.ts +85 -72
  230. package/src/contract_function_simulator/oracle/note_packing_utils.ts +3 -3
  231. package/src/contract_function_simulator/oracle/oracle.ts +558 -484
  232. package/src/contract_function_simulator/oracle/oracle_registry.ts +904 -0
  233. package/src/contract_function_simulator/oracle/private_execution.ts +4 -4
  234. package/src/contract_function_simulator/oracle/private_execution_oracle.ts +120 -130
  235. package/src/contract_function_simulator/oracle/utility_execution_oracle.ts +543 -221
  236. package/src/contract_function_simulator/pick_notes.ts +22 -3
  237. package/src/contract_function_simulator/proxied_contract_data_source.ts +41 -64
  238. package/src/contract_logging.ts +18 -5
  239. package/src/contract_sync/contract_sync_service.ts +120 -83
  240. package/src/contract_sync/helpers.ts +13 -25
  241. package/src/debug/pxe_debug_utils.ts +3 -11
  242. package/src/entrypoints/client/bundle/index.ts +0 -1
  243. package/src/entrypoints/client/bundle/utils.ts +10 -5
  244. package/src/entrypoints/client/lazy/index.ts +0 -1
  245. package/src/entrypoints/client/lazy/utils.ts +10 -5
  246. package/src/entrypoints/pxe_creation_options.ts +14 -0
  247. package/src/entrypoints/server/index.ts +2 -2
  248. package/src/entrypoints/server/utils.ts +15 -6
  249. package/src/events/event_service.ts +69 -21
  250. package/src/events/private_event_filter_validator.ts +21 -1
  251. package/src/hooks/authorize_utility_call.ts +44 -0
  252. package/src/hooks/execution_hooks.ts +48 -0
  253. package/src/hooks/index.ts +7 -0
  254. package/src/logs/log_service.ts +153 -129
  255. package/src/messages/message_context_service.ts +45 -0
  256. package/src/notes/note_service.ts +119 -85
  257. package/src/notes_filter.ts +1 -3
  258. package/src/oracle_version.ts +20 -10
  259. package/src/private_kernel/batch_planner.ts +169 -0
  260. package/src/private_kernel/hints/private_kernel_reset_private_inputs_builder.ts +1 -1
  261. package/src/private_kernel/hints/test_utils.ts +2 -9
  262. package/src/private_kernel/private_kernel_execution_prover.ts +240 -82
  263. package/src/private_kernel/private_kernel_oracle.ts +35 -25
  264. package/src/pxe.ts +270 -102
  265. package/src/storage/anchor_block_store/anchor_block_store.ts +1 -1
  266. package/src/storage/backwards_compatibility_tests/__snapshots__/AddressStore.json +22 -0
  267. package/src/storage/backwards_compatibility_tests/__snapshots__/AnchorBlockStore.json +3 -0
  268. package/src/storage/backwards_compatibility_tests/__snapshots__/CapsuleStore.json +16 -0
  269. package/src/storage/backwards_compatibility_tests/__snapshots__/ContractStore.json +28 -0
  270. package/src/storage/backwards_compatibility_tests/__snapshots__/KeyStore.json +52 -0
  271. package/src/storage/backwards_compatibility_tests/__snapshots__/L2TipsKVStore.json +46 -0
  272. package/src/storage/backwards_compatibility_tests/__snapshots__/NoteStore.json +36 -0
  273. package/src/storage/backwards_compatibility_tests/__snapshots__/PrivateEventStore.json +44 -0
  274. package/src/storage/backwards_compatibility_tests/__snapshots__/RecipientTaggingStore.json +18 -0
  275. package/src/storage/backwards_compatibility_tests/__snapshots__/SenderAddressBookStore.json +16 -0
  276. package/src/storage/backwards_compatibility_tests/__snapshots__/SenderTaggingStore.json +22 -0
  277. package/src/storage/backwards_compatibility_tests/__snapshots__/opened_stores.json +97 -0
  278. package/src/storage/backwards_compatibility_tests/kv_store_snapshot.ts +122 -0
  279. package/src/storage/backwards_compatibility_tests/schema_tests.ts +712 -0
  280. package/src/storage/backwards_compatibility_tests/store_spy.ts +73 -0
  281. package/src/storage/capsule_store/capsule_service.ts +90 -0
  282. package/src/storage/capsule_store/capsule_store.ts +44 -26
  283. package/src/storage/capsule_store/index.ts +1 -0
  284. package/src/storage/contract_store/contract_store.ts +14 -35
  285. package/src/storage/metadata.ts +1 -1
  286. package/src/storage/note_store/note_store.ts +2 -5
  287. package/src/storage/open_pxe_stores.ts +49 -0
  288. package/src/storage/private_event_store/private_event_store.ts +4 -0
  289. package/src/storage/private_event_store/stored_private_event.ts +1 -1
  290. package/src/storage/tagging_store/recipient_tagging_store.ts +5 -5
  291. package/src/storage/tagging_store/sender_tagging_store.ts +185 -138
  292. package/src/tagging/get_all_logs_by_tags.ts +78 -50
  293. package/src/tagging/index.ts +5 -4
  294. package/src/tagging/persist_sender_tagging_index_ranges.ts +57 -0
  295. package/src/tagging/recipient_sync/sync_tagged_private_logs.ts +240 -0
  296. package/src/tagging/recipient_sync/utils/find_highest_indexes.ts +2 -2
  297. package/src/tagging/reconcile_tagging_index_ranges.ts +102 -0
  298. package/src/tagging/sender_sync/sync_sender_tagging_indexes.ts +52 -17
  299. package/src/tagging/sender_sync/utils/get_status_change_of_pending.ts +44 -14
  300. package/src/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.ts +27 -27
  301. package/dest/access_scopes.d.ts +0 -9
  302. package/dest/access_scopes.d.ts.map +0 -1
  303. package/dest/access_scopes.js +0 -6
  304. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts +0 -15
  305. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts.map +0 -1
  306. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.js +0 -99
  307. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts +0 -15
  308. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts.map +0 -1
  309. package/dest/tagging/recipient_sync/utils/load_logs_for_range.js +0 -32
  310. package/src/access_scopes.ts +0 -9
  311. package/src/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.ts +0 -143
  312. package/src/tagging/recipient_sync/utils/load_logs_for_range.ts +0 -49
@@ -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 indexedTxEffects = await Promise.all(
97
+ txHashesWithExecutionReverted.map(txHash => aztecNode.getTxEffect(txHash)),
98
+ );
99
+ for (const indexedTxEffect of indexedTxEffects) {
100
+ if (indexedTxEffect === undefined) {
101
+ throw new Error(
102
+ 'TxEffect not found for execution-reverted tx. This is either a bug or a reorg has occurred.',
103
+ );
104
+ }
105
+
106
+ await taggingStore.finalizePendingIndexesOfAPartiallyRevertedTx(indexedTxEffect.data, 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
  }
@@ -1,8 +1,6 @@
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, PreTag } from '@aztec/stdlib/logs';
5
- import { SiloedTag, Tag } from '@aztec/stdlib/logs';
3
+ import { type AppTaggingSecret, SiloedTag } from '@aztec/stdlib/logs';
6
4
  import { TxHash } from '@aztec/stdlib/tx';
7
5
 
8
6
  import type { SenderTaggingStore } from '../../../storage/tagging_store/sender_tagging_store.js';
@@ -12,19 +10,17 @@ import { getAllPrivateLogsByTags } from '../../get_all_logs_by_tags.js';
12
10
  * Loads tagging indexes from the Aztec node and stores them in the tagging data provider.
13
11
  * @remarks This function is one of two places by which a pending index can get to the tagging data provider. The other
14
12
  * place is when a tx is being sent from this PXE.
15
- * @param secret - The directional app tagging secret that's unique for (sender, recipient, contract) tuple.
16
- * @param app - The address of the contract that the logs are tagged for. Used for siloing tags to match
17
- * kernel circuit behavior.
13
+ * @param extendedSecret - The app tagging secret whose indexes are being synced.
18
14
  * @param start - The starting index (inclusive) of the window to process.
19
15
  * @param end - The ending index (exclusive) of the window to process.
20
16
  * @param aztecNode - The Aztec node instance to query for logs.
21
17
  * @param taggingStore - The data provider to store pending indexes.
18
+ * @param anchorBlockHash - Hash of a block to use as reference block when querying node.
22
19
  * @param jobId - Job identifier, used to keep writes in-memory until they can be persisted in a data integrity
23
20
  * preserving way.
24
21
  */
25
22
  export async function loadAndStoreNewTaggingIndexes(
26
- secret: DirectionalAppTaggingSecret,
27
- app: AztecAddress,
23
+ extendedSecret: AppTaggingSecret,
28
24
  start: number,
29
25
  end: number,
30
26
  aztecNode: AztecNode,
@@ -33,20 +29,18 @@ export async function loadAndStoreNewTaggingIndexes(
33
29
  jobId: string,
34
30
  ) {
35
31
  // We compute the tags for the current window of indexes
36
- const preTagsForWindow: PreTag[] = Array(end - start)
37
- .fill(0)
38
- .map((_, i) => ({ secret, index: start + i }));
39
32
  const siloedTagsForWindow = await Promise.all(
40
- preTagsForWindow.map(async preTag => SiloedTag.compute(await Tag.compute(preTag), app)),
33
+ Array.from({ length: end - start }, (_, i) => SiloedTag.compute({ extendedSecret, index: start + i })),
41
34
  );
42
35
 
43
36
  const txsForTags = await getTxsContainingTags(siloedTagsForWindow, aztecNode, anchorBlockHash);
44
- const highestIndexMap = getTxHighestIndexMap(txsForTags, preTagsForWindow);
37
+ const txIndexesMap = getTxIndexesMap(txsForTags, start, siloedTagsForWindow.length);
45
38
 
46
- // Now we iterate over the map, reconstruct the preTags and tx hash and store them in the db.
47
- for (const [txHashStr, highestIndex] of highestIndexMap.entries()) {
39
+ // Now we iterate over the map, construct the tagging index ranges and store them in the db.
40
+ for (const [txHashStr, indexes] of txIndexesMap.entries()) {
48
41
  const txHash = TxHash.fromString(txHashStr);
49
- await taggingStore.storePendingIndexes([{ secret, index: highestIndex }], txHash, jobId);
42
+ const ranges = [{ extendedSecret, lowestIndex: Math.min(...indexes), highestIndex: Math.max(...indexes) }];
43
+ await taggingStore.storePendingIndexes(ranges, txHash, jobId);
50
44
  }
51
45
  }
52
46
 
@@ -58,27 +52,33 @@ async function getTxsContainingTags(
58
52
  anchorBlockHash: BlockHash,
59
53
  ): Promise<TxHash[][]> {
60
54
  // We use the utility function below to retrieve all logs for the tags across all pages, so we don't need to handle
61
- // pagination here.
55
+ // pagination here. Sender sync only needs `txHash` from each log, so we leave `includeEffects` off.
62
56
  const allLogs = await getAllPrivateLogsByTags(aztecNode, tags, anchorBlockHash);
63
57
  return allLogs.map(logs => logs.map(log => log.txHash));
64
58
  }
65
59
 
66
- // Returns a map of txHash to the highest index for that txHash.
67
- function getTxHighestIndexMap(txHashesForTags: TxHash[][], preTagsForWindow: PreTag[]): Map<string, number> {
68
- if (txHashesForTags.length !== preTagsForWindow.length) {
69
- throw new Error(
70
- `Number of tx hashes arrays does not match number of pre-tags. ${txHashesForTags.length} !== ${preTagsForWindow.length}`,
71
- );
60
+ // Returns a map of txHash to all indexes for that txHash.
61
+ function getTxIndexesMap(txHashesForTags: TxHash[][], start: number, count: number): Map<string, number[]> {
62
+ if (txHashesForTags.length !== count) {
63
+ throw new Error(`Number of tx hashes arrays does not match number of tags. ${txHashesForTags.length} !== ${count}`);
72
64
  }
73
65
 
74
- const highestIndexMap = new Map<string, number>();
66
+ const indexesMap = new Map<string, number[]>();
67
+ // Iterate over indexes
75
68
  for (let i = 0; i < txHashesForTags.length; i++) {
76
- const taggingIndex = preTagsForWindow[i].index;
69
+ const taggingIndex = start + i;
77
70
  const txHashesForTag = txHashesForTags[i];
71
+ // iterate over tx hashes that used that index (tag)
78
72
  for (const txHash of txHashesForTag) {
79
73
  const key = txHash.toString();
80
- highestIndexMap.set(key, Math.max(highestIndexMap.get(key) ?? 0, taggingIndex));
74
+ const existing = indexesMap.get(key);
75
+ // Add the index to the tx's indexes
76
+ if (existing) {
77
+ existing.push(taggingIndex);
78
+ } else {
79
+ indexesMap.set(key, [taggingIndex]);
80
+ }
81
81
  }
82
82
  }
83
- return highestIndexMap;
83
+ return indexesMap;
84
84
  }
@@ -1,9 +0,0 @@
1
- import type { AztecAddress } from '@aztec/stdlib/aztec-address';
2
- /**
3
- * Controls which accounts' private state and keys are accessible during execution.
4
- * - `'ALL_SCOPES'`: All registered accounts' private state and keys are accessible.
5
- * - `AztecAddress[]` with entries: Only the specified accounts' private state and keys are accessible.
6
- * - `[]` (empty array): Deny-all. No private state is visible and no keys are accessible.
7
- */
8
- export type AccessScopes = 'ALL_SCOPES' | AztecAddress[];
9
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWNjZXNzX3Njb3Blcy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2FjY2Vzc19zY29wZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsWUFBWSxFQUFFLE1BQU0sNkJBQTZCLENBQUM7QUFFaEU7Ozs7O0dBS0c7QUFDSCxNQUFNLE1BQU0sWUFBWSxHQUFHLFlBQVksR0FBRyxZQUFZLEVBQUUsQ0FBQyJ9
@@ -1 +0,0 @@
1
- {"version":3,"file":"access_scopes.d.ts","sourceRoot":"","sources":["../src/access_scopes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEhE;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,YAAY,EAAE,CAAC"}
@@ -1,6 +0,0 @@
1
- /**
2
- * Controls which accounts' private state and keys are accessible during execution.
3
- * - `'ALL_SCOPES'`: All registered accounts' private state and keys are accessible.
4
- * - `AztecAddress[]` with entries: Only the specified accounts' private state and keys are accessible.
5
- * - `[]` (empty array): Deny-all. No private state is visible and no keys are accessible.
6
- */ export { };
@@ -1,15 +0,0 @@
1
- import type { BlockNumber } from '@aztec/foundation/branded-types';
2
- import type { AztecAddress } from '@aztec/stdlib/aztec-address';
3
- import type { BlockHash } from '@aztec/stdlib/block';
4
- import type { AztecNode } from '@aztec/stdlib/interfaces/client';
5
- import type { DirectionalAppTaggingSecret, TxScopedL2Log } from '@aztec/stdlib/logs';
6
- import type { RecipientTaggingStore } from '../../storage/tagging_store/recipient_tagging_store.js';
7
- /**
8
- * Loads private logs for `app` and sender-recipient pair defined by `secret` and updates the highest aged and
9
- * finalized indexes in the db. At most load logs from blocks up to and including `anchorBlockNumber`.
10
- *
11
- * @dev This function can be safely executed "in parallel" for other sender-recipient pairs because the data in
12
- * in the tagging data provider is indexed by the secret and hence completely disjoint.
13
- */
14
- export declare function loadPrivateLogsForSenderRecipientPair(secret: DirectionalAppTaggingSecret, app: AztecAddress, aztecNode: AztecNode, taggingStore: RecipientTaggingStore, anchorBlockNumber: BlockNumber, anchorBlockHash: BlockHash, jobId: string): Promise<TxScopedL2Log[]>;
15
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9hZF9wcml2YXRlX2xvZ3NfZm9yX3NlbmRlcl9yZWNpcGllbnRfcGFpci5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL3RhZ2dpbmcvcmVjaXBpZW50X3N5bmMvbG9hZF9wcml2YXRlX2xvZ3NfZm9yX3NlbmRlcl9yZWNpcGllbnRfcGFpci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxXQUFXLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUNuRSxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUNoRSxPQUFPLEtBQUssRUFBRSxTQUFTLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUNyRCxPQUFPLEtBQUssRUFBRSxTQUFTLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUNqRSxPQUFPLEtBQUssRUFBRSwyQkFBMkIsRUFBRSxhQUFhLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUVyRixPQUFPLEtBQUssRUFBRSxxQkFBcUIsRUFBRSxNQUFNLHdEQUF3RCxDQUFDO0FBS3BHOzs7Ozs7R0FNRztBQUNILHdCQUFzQixxQ0FBcUMsQ0FDekQsTUFBTSxFQUFFLDJCQUEyQixFQUNuQyxHQUFHLEVBQUUsWUFBWSxFQUNqQixTQUFTLEVBQUUsU0FBUyxFQUNwQixZQUFZLEVBQUUscUJBQXFCLEVBQ25DLGlCQUFpQixFQUFFLFdBQVcsRUFDOUIsZUFBZSxFQUFFLFNBQVMsRUFDMUIsS0FBSyxFQUFFLE1BQU0sR0FDWixPQUFPLENBQUMsYUFBYSxFQUFFLENBQUMsQ0FvSDFCIn0=
@@ -1 +0,0 @@
1
- {"version":3,"file":"load_private_logs_for_sender_recipient_pair.d.ts","sourceRoot":"","sources":["../../../src/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,KAAK,EAAE,2BAA2B,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAErF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wDAAwD,CAAC;AAKpG;;;;;;GAMG;AACH,wBAAsB,qCAAqC,CACzD,MAAM,EAAE,2BAA2B,EACnC,GAAG,EAAE,YAAY,EACjB,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,qBAAqB,EACnC,iBAAiB,EAAE,WAAW,EAC9B,eAAe,EAAE,SAAS,EAC1B,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,aAAa,EAAE,CAAC,CAoH1B"}
@@ -1,99 +0,0 @@
1
- import { UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN } from '../constants.js';
2
- import { findHighestIndexes } from './utils/find_highest_indexes.js';
3
- import { loadLogsForRange } from './utils/load_logs_for_range.js';
4
- /**
5
- * Loads private logs for `app` and sender-recipient pair defined by `secret` and updates the highest aged and
6
- * finalized indexes in the db. At most load logs from blocks up to and including `anchorBlockNumber`.
7
- *
8
- * @dev This function can be safely executed "in parallel" for other sender-recipient pairs because the data in
9
- * in the tagging data provider is indexed by the secret and hence completely disjoint.
10
- */ export async function loadPrivateLogsForSenderRecipientPair(secret, app, aztecNode, taggingStore, anchorBlockNumber, anchorBlockHash, jobId) {
11
- // # Explanation of how the algorithm works
12
- // When we perform the sync we will look at logs that correspond to the tagging index range
13
- // (highestAgedIndex, highestFinalizedIndex + WINDOW_LEN]
14
- //
15
- // highestAgedIndex is the highest index that was used in a tx that is included in a block at least
16
- // `MAX_TX_LIFETIME` seconds ago.
17
- // highestFinalizedIndex is the highest index that was used in a tx that is included in a finalized block.
18
- //
19
- // "(" denotes an open end of the range - the index is not included in the range.
20
- // "]" denotes a closed end of the range - the index is included in the range.
21
- //
22
- // ## Explanation of highestAgedIndex
23
- //
24
- // highestAgedIndex is chosen such that for all tagging indexes `i <= highestAgedIndex` we know that no new logs can
25
- // ever appear.
26
- //
27
- // This relies on the "maximum inclusion timestamp" rule enforced by the kernel and rollup circuits:
28
- // - a transaction's maximum inclusion timestamp is at most `MAX_TX_LIFETIME` seconds after
29
- // the timestamp of its anchor block; and
30
- // - a rollup only includes transactions whose inclusion timestamp is >= the L2 block's timestamp.
31
- //
32
- // Suppose some device used index `I` in a transaction anchored to block `B_N` at time `N`, and that block is now at
33
- // least `MAX_TX_LIFETIME` seconds in the past. Then there is no possibility of any *other* device
34
- // trying to use an index <= `I` while anchoring to a *newer* block than `B_N` because if we were anchoring to
35
- // a newer block than `B_N` then we would already have seen the log with index `I` and hence the device would have
36
- // chosen a larger index.
37
- // If that *other* device would anchor to a block older than `B_N` then that tx could never be included in a block
38
- // because it would already have been expired.
39
- //
40
- // Therefore, once we see that index `I` has been used in a block that is at least `MAX_TX_LIFETIME`
41
- // seconds old, we can safely stop syncing logs for all indexes <= `I` and set highestAgedIndex = `I`.
42
- //
43
- // ## Explanation of the upper bound `highestFinalizedIndex + WINDOW_LEN`
44
- //
45
- // When a sender chooses a tagging index, they will select an index that is at most `WINDOW_LEN` greater than
46
- // the highest finalized index. If that index was already used, they will throw an error. For this reason we
47
- // don't have to look further than `highestFinalizedIndex + WINDOW_LEN`.
48
- let finalizedBlockNumber, currentTimestamp;
49
- {
50
- const [l2Tips, latestBlockHeader] = await Promise.all([
51
- aztecNode.getL2Tips(),
52
- aztecNode.getBlockHeader('latest')
53
- ]);
54
- if (!latestBlockHeader) {
55
- throw new Error('Node failed to return latest block header when syncing logs');
56
- }
57
- [finalizedBlockNumber, currentTimestamp] = [
58
- l2Tips.finalized.block.number,
59
- latestBlockHeader.globalVariables.timestamp
60
- ];
61
- }
62
- let start, end;
63
- {
64
- const currentHighestAgedIndex = await taggingStore.getHighestAgedIndex(secret, jobId);
65
- const currentHighestFinalizedIndex = await taggingStore.getHighestFinalizedIndex(secret, jobId);
66
- // We don't want to include the highest aged index so we start from `currentHighestAgedIndex + 1` (or 0 if not set)
67
- start = currentHighestAgedIndex === undefined ? 0 : currentHighestAgedIndex + 1;
68
- // The highest index a sender can choose is "highest finalized index + window length" but given that
69
- // `loadLogsForRange` expects an exclusive `end` we add 1.
70
- end = (currentHighestFinalizedIndex ?? 0) + UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN + 1;
71
- }
72
- const logs = [];
73
- while(true){
74
- // Get private logs with their block timestamps and corresponding tagging indexes
75
- const privateLogsWithIndexes = await loadLogsForRange(secret, app, aztecNode, start, end, anchorBlockNumber, anchorBlockHash);
76
- if (privateLogsWithIndexes.length === 0) {
77
- break;
78
- }
79
- logs.push(...privateLogsWithIndexes.map(({ log })=>log));
80
- const { highestAgedIndex, highestFinalizedIndex } = findHighestIndexes(privateLogsWithIndexes, currentTimestamp, finalizedBlockNumber);
81
- // Store updates in data provider and update local variables
82
- if (highestAgedIndex !== undefined) {
83
- await taggingStore.updateHighestAgedIndex(secret, highestAgedIndex, jobId);
84
- }
85
- if (highestFinalizedIndex === undefined) {
86
- break;
87
- }
88
- if (highestAgedIndex !== undefined && highestAgedIndex > highestFinalizedIndex) {
89
- // This is just a sanity check as this should never happen.
90
- throw new Error('Highest aged index lower than highest finalized index invariant violated');
91
- }
92
- await taggingStore.updateHighestFinalizedIndex(secret, highestFinalizedIndex, jobId);
93
- // For the next iteration we want to look only at indexes for which we have not attempted to load logs yet while
94
- // ensuring that we do not look further than WINDOW_LEN ahead of the highest finalized index.
95
- start = end;
96
- end = highestFinalizedIndex + UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN + 1; // `end` is exclusive so we add 1.
97
- }
98
- return logs;
99
- }
@@ -1,15 +0,0 @@
1
- import type { BlockNumber } from '@aztec/foundation/branded-types';
2
- import type { AztecAddress } from '@aztec/stdlib/aztec-address';
3
- import type { BlockHash } from '@aztec/stdlib/block';
4
- import type { AztecNode } from '@aztec/stdlib/interfaces/client';
5
- import type { DirectionalAppTaggingSecret, TxScopedL2Log } from '@aztec/stdlib/logs';
6
- /**
7
- * Gets private logs with their corresponding block timestamps and tagging indexes for the given index range, `app` and
8
- * `secret`. At most load logs from blocks up to and including `anchorBlockNumber`. `start` is inclusive and `end` is
9
- * exclusive.
10
- */
11
- export declare function loadLogsForRange(secret: DirectionalAppTaggingSecret, app: AztecAddress, aztecNode: AztecNode, start: number, end: number, anchorBlockNumber: BlockNumber, anchorBlockHash: BlockHash): Promise<Array<{
12
- log: TxScopedL2Log;
13
- taggingIndex: number;
14
- }>>;
15
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9hZF9sb2dzX2Zvcl9yYW5nZS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL3RhZ2dpbmcvcmVjaXBpZW50X3N5bmMvdXRpbHMvbG9hZF9sb2dzX2Zvcl9yYW5nZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxXQUFXLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUNuRSxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUNoRSxPQUFPLEtBQUssRUFBRSxTQUFTLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUNyRCxPQUFPLEtBQUssRUFBRSxTQUFTLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUNqRSxPQUFPLEtBQUssRUFBRSwyQkFBMkIsRUFBVSxhQUFhLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUs3Rjs7OztHQUlHO0FBQ0gsd0JBQXNCLGdCQUFnQixDQUNwQyxNQUFNLEVBQUUsMkJBQTJCLEVBQ25DLEdBQUcsRUFBRSxZQUFZLEVBQ2pCLFNBQVMsRUFBRSxTQUFTLEVBQ3BCLEtBQUssRUFBRSxNQUFNLEVBQ2IsR0FBRyxFQUFFLE1BQU0sRUFDWCxpQkFBaUIsRUFBRSxXQUFXLEVBQzlCLGVBQWUsRUFBRSxTQUFTLEdBQ3pCLE9BQU8sQ0FBQyxLQUFLLENBQUM7SUFBRSxHQUFHLEVBQUUsYUFBYSxDQUFDO0lBQUMsWUFBWSxFQUFFLE1BQU0sQ0FBQTtDQUFFLENBQUMsQ0FBQyxDQTBCOUQifQ==
@@ -1 +0,0 @@
1
- {"version":3,"file":"load_logs_for_range.d.ts","sourceRoot":"","sources":["../../../../src/tagging/recipient_sync/utils/load_logs_for_range.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,KAAK,EAAE,2BAA2B,EAAU,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAK7F;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,2BAA2B,EACnC,GAAG,EAAE,YAAY,EACjB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,iBAAiB,EAAE,WAAW,EAC9B,eAAe,EAAE,SAAS,GACzB,OAAO,CAAC,KAAK,CAAC;IAAE,GAAG,EAAE,aAAa,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CA0B9D"}
@@ -1,32 +0,0 @@
1
- import { SiloedTag, Tag } from '@aztec/stdlib/logs';
2
- import { getAllPrivateLogsByTags } from '../../get_all_logs_by_tags.js';
3
- /**
4
- * Gets private logs with their corresponding block timestamps and tagging indexes for the given index range, `app` and
5
- * `secret`. At most load logs from blocks up to and including `anchorBlockNumber`. `start` is inclusive and `end` is
6
- * exclusive.
7
- */ export async function loadLogsForRange(secret, app, aztecNode, start, end, anchorBlockNumber, anchorBlockHash) {
8
- // Derive tags for the window
9
- const preTags = Array(end - start).fill(0).map((_, i)=>({
10
- secret,
11
- index: start + i
12
- }));
13
- const siloedTags = await Promise.all(preTags.map((preTag)=>Tag.compute(preTag))).then((tags)=>Promise.all(tags.map((tag)=>SiloedTag.compute(tag, app))));
14
- // We use the utility function below to retrieve all logs for the tags across all pages, so we don't need to handle
15
- // pagination here.
16
- const logs = await getAllPrivateLogsByTags(aztecNode, siloedTags, anchorBlockHash);
17
- // Pair logs with their corresponding tagging indexes
18
- const logsWithIndexes = [];
19
- for(let i = 0; i < logs.length; i++){
20
- const logsForTag = logs[i];
21
- const taggingIndex = preTags[i].index;
22
- for (const log of logsForTag){
23
- if (log.blockNumber <= anchorBlockNumber) {
24
- logsWithIndexes.push({
25
- log,
26
- taggingIndex
27
- });
28
- }
29
- }
30
- }
31
- return logsWithIndexes;
32
- }
@@ -1,9 +0,0 @@
1
- import type { AztecAddress } from '@aztec/stdlib/aztec-address';
2
-
3
- /**
4
- * Controls which accounts' private state and keys are accessible during execution.
5
- * - `'ALL_SCOPES'`: All registered accounts' private state and keys are accessible.
6
- * - `AztecAddress[]` with entries: Only the specified accounts' private state and keys are accessible.
7
- * - `[]` (empty array): Deny-all. No private state is visible and no keys are accessible.
8
- */
9
- export type AccessScopes = 'ALL_SCOPES' | AztecAddress[];