@aztec/pxe 0.0.1-commit.96bb3f7 → 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 (379) hide show
  1. package/dest/bin/check_oracle_version.d.ts +12 -2
  2. package/dest/bin/check_oracle_version.d.ts.map +1 -1
  3. package/dest/bin/check_oracle_version.js +32 -26
  4. package/dest/bin/index.d.ts +2 -0
  5. package/dest/bin/index.d.ts.map +1 -0
  6. package/dest/bin/index.js +1 -0
  7. package/dest/block_synchronizer/block_stream_source.d.ts +10 -0
  8. package/dest/block_synchronizer/block_stream_source.d.ts.map +1 -0
  9. package/dest/block_synchronizer/block_stream_source.js +62 -0
  10. package/dest/block_synchronizer/block_synchronizer.d.ts +16 -6
  11. package/dest/block_synchronizer/block_synchronizer.d.ts.map +1 -1
  12. package/dest/block_synchronizer/block_synchronizer.js +94 -23
  13. package/dest/config/index.d.ts +10 -2
  14. package/dest/config/index.d.ts.map +1 -1
  15. package/dest/config/index.js +17 -2
  16. package/dest/config/package_info.js +1 -1
  17. package/dest/contract_function_simulator/benchmarked_node.d.ts +9 -0
  18. package/dest/contract_function_simulator/benchmarked_node.d.ts.map +1 -0
  19. package/dest/contract_function_simulator/benchmarked_node.js +77 -0
  20. package/dest/contract_function_simulator/contract_function_simulator.d.ts +69 -36
  21. package/dest/contract_function_simulator/contract_function_simulator.d.ts.map +1 -1
  22. package/dest/contract_function_simulator/contract_function_simulator.js +240 -91
  23. package/dest/contract_function_simulator/ephemeral_array_service.d.ts +28 -0
  24. package/dest/contract_function_simulator/ephemeral_array_service.d.ts.map +1 -0
  25. package/dest/contract_function_simulator/ephemeral_array_service.js +78 -0
  26. package/dest/contract_function_simulator/execution_note_cache.d.ts +18 -9
  27. package/dest/contract_function_simulator/execution_note_cache.d.ts.map +1 -1
  28. package/dest/contract_function_simulator/execution_note_cache.js +45 -28
  29. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts +7 -11
  30. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts.map +1 -1
  31. package/dest/contract_function_simulator/execution_tagging_index_cache.js +19 -15
  32. package/dest/contract_function_simulator/index.d.ts +5 -2
  33. package/dest/contract_function_simulator/index.d.ts.map +1 -1
  34. package/dest/contract_function_simulator/index.js +4 -1
  35. package/dest/contract_function_simulator/noir-structs/bounded_vec.d.ts +48 -0
  36. package/dest/contract_function_simulator/noir-structs/bounded_vec.d.ts.map +1 -0
  37. package/dest/contract_function_simulator/noir-structs/bounded_vec.js +45 -0
  38. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts +5 -7
  39. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts.map +1 -1
  40. package/dest/contract_function_simulator/noir-structs/event_validation_request.js +9 -10
  41. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.d.ts +13 -3
  42. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.d.ts.map +1 -1
  43. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.js +35 -4
  44. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts +2 -2
  45. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts.map +1 -1
  46. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.js +2 -4
  47. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts +5 -8
  48. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts.map +1 -1
  49. package/dest/contract_function_simulator/noir-structs/note_validation_request.js +7 -11
  50. package/dest/contract_function_simulator/noir-structs/option.d.ts +61 -0
  51. package/dest/contract_function_simulator/noir-structs/option.d.ts.map +1 -0
  52. package/dest/contract_function_simulator/noir-structs/option.js +62 -0
  53. package/dest/contract_function_simulator/noir-structs/utility_context.d.ts +4 -10
  54. package/dest/contract_function_simulator/noir-structs/utility_context.d.ts.map +1 -1
  55. package/dest/contract_function_simulator/noir-structs/utility_context.js +7 -18
  56. package/dest/contract_function_simulator/oracle/interfaces.d.ts +70 -50
  57. package/dest/contract_function_simulator/oracle/interfaces.d.ts.map +1 -1
  58. package/dest/contract_function_simulator/oracle/message_load_oracle_inputs.d.ts +3 -1
  59. package/dest/contract_function_simulator/oracle/message_load_oracle_inputs.d.ts.map +1 -1
  60. package/dest/contract_function_simulator/oracle/note_packing_utils.d.ts +7 -7
  61. package/dest/contract_function_simulator/oracle/note_packing_utils.d.ts.map +1 -1
  62. package/dest/contract_function_simulator/oracle/note_packing_utils.js +10 -10
  63. package/dest/contract_function_simulator/oracle/oracle.d.ts +74 -43
  64. package/dest/contract_function_simulator/oracle/oracle.d.ts.map +1 -1
  65. package/dest/contract_function_simulator/oracle/oracle.js +471 -264
  66. package/dest/contract_function_simulator/oracle/oracle_registry.d.ts +147 -0
  67. package/dest/contract_function_simulator/oracle/oracle_registry.d.ts.map +1 -0
  68. package/dest/contract_function_simulator/oracle/oracle_registry.js +1199 -0
  69. package/dest/contract_function_simulator/oracle/private_execution.d.ts +2 -26
  70. package/dest/contract_function_simulator/oracle/private_execution.d.ts.map +1 -1
  71. package/dest/contract_function_simulator/oracle/private_execution.js +5 -38
  72. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts +74 -91
  73. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts.map +1 -1
  74. package/dest/contract_function_simulator/oracle/private_execution_oracle.js +164 -110
  75. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts +156 -78
  76. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts.map +1 -1
  77. package/dest/contract_function_simulator/oracle/utility_execution_oracle.js +459 -186
  78. package/dest/contract_function_simulator/pick_notes.d.ts +1 -1
  79. package/dest/contract_function_simulator/pick_notes.d.ts.map +1 -1
  80. package/dest/contract_function_simulator/pick_notes.js +20 -3
  81. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts +1 -1
  82. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts.map +1 -1
  83. package/dest/contract_function_simulator/proxied_contract_data_source.js +35 -64
  84. package/dest/contract_logging.d.ts +27 -0
  85. package/dest/contract_logging.d.ts.map +1 -0
  86. package/dest/contract_logging.js +38 -0
  87. package/dest/contract_sync/contract_sync_service.d.ts +42 -0
  88. package/dest/contract_sync/contract_sync_service.d.ts.map +1 -0
  89. package/dest/contract_sync/contract_sync_service.js +135 -0
  90. package/dest/contract_sync/helpers.d.ts +27 -0
  91. package/dest/contract_sync/helpers.d.ts.map +1 -0
  92. package/dest/contract_sync/helpers.js +53 -0
  93. package/dest/debug/pxe_debug_utils.d.ts +19 -10
  94. package/dest/debug/pxe_debug_utils.d.ts.map +1 -1
  95. package/dest/debug/pxe_debug_utils.js +22 -17
  96. package/dest/entrypoints/client/bundle/index.d.ts +3 -1
  97. package/dest/entrypoints/client/bundle/index.d.ts.map +1 -1
  98. package/dest/entrypoints/client/bundle/index.js +2 -0
  99. package/dest/entrypoints/client/bundle/utils.d.ts +2 -2
  100. package/dest/entrypoints/client/bundle/utils.d.ts.map +1 -1
  101. package/dest/entrypoints/client/bundle/utils.js +33 -11
  102. package/dest/entrypoints/client/lazy/index.d.ts +3 -1
  103. package/dest/entrypoints/client/lazy/index.d.ts.map +1 -1
  104. package/dest/entrypoints/client/lazy/index.js +2 -0
  105. package/dest/entrypoints/client/lazy/utils.d.ts +3 -3
  106. package/dest/entrypoints/client/lazy/utils.d.ts.map +1 -1
  107. package/dest/entrypoints/client/lazy/utils.js +34 -12
  108. package/dest/entrypoints/pxe_creation_options.d.ts +11 -2
  109. package/dest/entrypoints/pxe_creation_options.d.ts.map +1 -1
  110. package/dest/entrypoints/pxe_creation_options.js +3 -1
  111. package/dest/entrypoints/server/index.d.ts +6 -2
  112. package/dest/entrypoints/server/index.d.ts.map +1 -1
  113. package/dest/entrypoints/server/index.js +5 -1
  114. package/dest/entrypoints/server/utils.d.ts +4 -3
  115. package/dest/entrypoints/server/utils.d.ts.map +1 -1
  116. package/dest/entrypoints/server/utils.js +40 -13
  117. package/dest/events/event_service.d.ts +17 -8
  118. package/dest/events/event_service.d.ts.map +1 -1
  119. package/dest/events/event_service.js +58 -28
  120. package/dest/events/private_event_filter_validator.d.ts +6 -5
  121. package/dest/events/private_event_filter_validator.d.ts.map +1 -1
  122. package/dest/events/private_event_filter_validator.js +20 -6
  123. package/dest/hooks/authorize_utility_call.d.ts +41 -0
  124. package/dest/hooks/authorize_utility_call.d.ts.map +1 -0
  125. package/dest/hooks/authorize_utility_call.js +4 -0
  126. package/dest/hooks/execution_hooks.d.ts +42 -0
  127. package/dest/hooks/execution_hooks.d.ts.map +1 -0
  128. package/dest/hooks/execution_hooks.js +9 -0
  129. package/dest/hooks/index.d.ts +4 -0
  130. package/dest/hooks/index.d.ts.map +1 -0
  131. package/dest/hooks/index.js +1 -0
  132. package/dest/job_coordinator/job_coordinator.d.ts +3 -2
  133. package/dest/job_coordinator/job_coordinator.d.ts.map +1 -1
  134. package/dest/job_coordinator/job_coordinator.js +3 -2
  135. package/dest/logs/log_service.d.ts +13 -10
  136. package/dest/logs/log_service.d.ts.map +1 -1
  137. package/dest/logs/log_service.js +132 -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 +38 -0
  141. package/dest/notes/note_service.d.ts +31 -9
  142. package/dest/notes/note_service.d.ts.map +1 -1
  143. package/dest/notes/note_service.js +97 -77
  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 -9
  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 +3 -3
  157. package/dest/private_kernel/hints/index.d.ts.map +1 -1
  158. package/dest/private_kernel/hints/index.js +2 -2
  159. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts +29 -0
  160. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts.map +1 -0
  161. package/dest/private_kernel/hints/{build_private_kernel_reset_private_inputs.js → private_kernel_reset_private_inputs_builder.js} +141 -74
  162. package/dest/private_kernel/hints/test_utils.d.ts +122 -0
  163. package/dest/private_kernel/hints/test_utils.d.ts.map +1 -0
  164. package/dest/private_kernel/hints/test_utils.js +202 -0
  165. package/dest/private_kernel/private_kernel_execution_prover.d.ts +7 -2
  166. package/dest/private_kernel/private_kernel_execution_prover.d.ts.map +1 -1
  167. package/dest/private_kernel/private_kernel_execution_prover.js +168 -67
  168. package/dest/private_kernel/private_kernel_oracle.d.ts +28 -29
  169. package/dest/private_kernel/private_kernel_oracle.d.ts.map +1 -1
  170. package/dest/private_kernel/private_kernel_oracle.js +96 -2
  171. package/dest/pxe.d.ts +126 -59
  172. package/dest/pxe.d.ts.map +1 -1
  173. package/dest/pxe.js +257 -200
  174. package/dest/storage/address_store/address_store.d.ts +1 -1
  175. package/dest/storage/address_store/address_store.d.ts.map +1 -1
  176. package/dest/storage/address_store/address_store.js +12 -11
  177. package/dest/storage/anchor_block_store/anchor_block_store.d.ts +9 -1
  178. package/dest/storage/anchor_block_store/anchor_block_store.d.ts.map +1 -1
  179. package/dest/storage/anchor_block_store/anchor_block_store.js +9 -2
  180. package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.d.ts +42 -0
  181. package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.d.ts.map +1 -0
  182. package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.js +93 -0
  183. package/dest/storage/backwards_compatibility_tests/schema_tests.d.ts +15 -0
  184. package/dest/storage/backwards_compatibility_tests/schema_tests.d.ts.map +1 -0
  185. package/dest/storage/backwards_compatibility_tests/schema_tests.js +591 -0
  186. package/dest/storage/backwards_compatibility_tests/store_spy.d.ts +19 -0
  187. package/dest/storage/backwards_compatibility_tests/store_spy.d.ts.map +1 -0
  188. package/dest/storage/backwards_compatibility_tests/store_spy.js +63 -0
  189. package/dest/storage/capsule_store/capsule_service.d.ts +21 -0
  190. package/dest/storage/capsule_store/capsule_service.d.ts.map +1 -0
  191. package/dest/storage/capsule_store/capsule_service.js +50 -0
  192. package/dest/storage/capsule_store/capsule_store.d.ts +25 -10
  193. package/dest/storage/capsule_store/capsule_store.d.ts.map +1 -1
  194. package/dest/storage/capsule_store/capsule_store.js +143 -28
  195. package/dest/storage/capsule_store/index.d.ts +2 -1
  196. package/dest/storage/capsule_store/index.d.ts.map +1 -1
  197. package/dest/storage/capsule_store/index.js +1 -0
  198. package/dest/storage/contract_store/contract_store.d.ts +42 -16
  199. package/dest/storage/contract_store/contract_store.d.ts.map +1 -1
  200. package/dest/storage/contract_store/contract_store.js +158 -102
  201. package/dest/storage/metadata.d.ts +1 -1
  202. package/dest/storage/metadata.js +1 -1
  203. package/dest/storage/note_store/note_store.d.ts +50 -51
  204. package/dest/storage/note_store/note_store.d.ts.map +1 -1
  205. package/dest/storage/note_store/note_store.js +284 -263
  206. package/dest/storage/note_store/stored_note.d.ts +16 -0
  207. package/dest/storage/note_store/stored_note.d.ts.map +1 -0
  208. package/dest/storage/note_store/stored_note.js +43 -0
  209. package/dest/storage/open_pxe_stores.d.ts +33 -0
  210. package/dest/storage/open_pxe_stores.d.ts.map +1 -0
  211. package/dest/storage/open_pxe_stores.js +27 -0
  212. package/dest/storage/private_event_store/private_event_store.d.ts +43 -8
  213. package/dest/storage/private_event_store/private_event_store.d.ts.map +1 -1
  214. package/dest/storage/private_event_store/private_event_store.js +229 -111
  215. package/dest/storage/private_event_store/stored_private_event.d.ts +23 -0
  216. package/dest/storage/private_event_store/stored_private_event.d.ts.map +1 -0
  217. package/dest/storage/private_event_store/stored_private_event.js +56 -0
  218. package/dest/storage/tagging_store/recipient_tagging_store.d.ts +16 -9
  219. package/dest/storage/tagging_store/recipient_tagging_store.d.ts.map +1 -1
  220. package/dest/storage/tagging_store/recipient_tagging_store.js +88 -19
  221. package/dest/storage/tagging_store/sender_address_book_store.d.ts +1 -1
  222. package/dest/storage/tagging_store/sender_address_book_store.d.ts.map +1 -1
  223. package/dest/storage/tagging_store/sender_address_book_store.js +20 -14
  224. package/dest/storage/tagging_store/sender_tagging_store.d.ts +43 -32
  225. package/dest/storage/tagging_store/sender_tagging_store.d.ts.map +1 -1
  226. package/dest/storage/tagging_store/sender_tagging_store.js +300 -122
  227. package/dest/tagging/get_all_logs_by_tags.d.ts +48 -0
  228. package/dest/tagging/get_all_logs_by_tags.d.ts.map +1 -0
  229. package/dest/tagging/get_all_logs_by_tags.js +59 -0
  230. package/dest/tagging/index.d.ts +7 -5
  231. package/dest/tagging/index.d.ts.map +1 -1
  232. package/dest/tagging/index.js +5 -3
  233. package/dest/tagging/persist_sender_tagging_index_ranges.d.ts +29 -0
  234. package/dest/tagging/persist_sender_tagging_index_ranges.d.ts.map +1 -0
  235. package/dest/tagging/persist_sender_tagging_index_ranges.js +42 -0
  236. package/dest/tagging/recipient_sync/sync_tagged_private_logs.d.ts +56 -0
  237. package/dest/tagging/recipient_sync/sync_tagged_private_logs.d.ts.map +1 -0
  238. package/dest/tagging/recipient_sync/sync_tagged_private_logs.js +163 -0
  239. package/dest/tagging/recipient_sync/utils/find_highest_indexes.d.ts +3 -3
  240. package/dest/tagging/recipient_sync/utils/find_highest_indexes.d.ts.map +1 -1
  241. package/dest/tagging/recipient_sync/utils/find_highest_indexes.js +2 -2
  242. package/dest/tagging/reconcile_tagging_index_ranges.d.ts +36 -0
  243. package/dest/tagging/reconcile_tagging_index_ranges.d.ts.map +1 -0
  244. package/dest/tagging/reconcile_tagging_index_ranges.js +74 -0
  245. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts +5 -9
  246. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts.map +1 -1
  247. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.js +34 -18
  248. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts +13 -7
  249. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts.map +1 -1
  250. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.js +44 -16
  251. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts +8 -7
  252. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts.map +1 -1
  253. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.js +44 -27
  254. package/package.json +31 -19
  255. package/src/bin/check_oracle_version.ts +42 -31
  256. package/src/bin/index.ts +1 -0
  257. package/src/block_synchronizer/block_stream_source.ts +81 -0
  258. package/src/block_synchronizer/block_synchronizer.ts +116 -36
  259. package/src/config/index.ts +21 -1
  260. package/src/config/package_info.ts +1 -1
  261. package/src/contract_function_simulator/benchmarked_node.ts +103 -0
  262. package/src/contract_function_simulator/contract_function_simulator.ts +417 -156
  263. package/src/contract_function_simulator/ephemeral_array_service.ts +110 -0
  264. package/src/contract_function_simulator/execution_note_cache.ts +44 -25
  265. package/src/contract_function_simulator/execution_tagging_index_cache.ts +19 -18
  266. package/src/contract_function_simulator/index.ts +4 -1
  267. package/src/contract_function_simulator/noir-structs/bounded_vec.ts +55 -0
  268. package/src/contract_function_simulator/noir-structs/event_validation_request.ts +11 -10
  269. package/src/contract_function_simulator/noir-structs/log_retrieval_request.ts +36 -3
  270. package/src/contract_function_simulator/noir-structs/log_retrieval_response.ts +2 -5
  271. package/src/contract_function_simulator/noir-structs/note_validation_request.ts +6 -11
  272. package/src/contract_function_simulator/noir-structs/option.ts +69 -0
  273. package/src/contract_function_simulator/noir-structs/utility_context.ts +6 -25
  274. package/src/contract_function_simulator/oracle/interfaces.ts +93 -70
  275. package/src/contract_function_simulator/oracle/note_packing_utils.ts +13 -13
  276. package/src/contract_function_simulator/oracle/oracle.ts +567 -461
  277. package/src/contract_function_simulator/oracle/oracle_registry.ts +904 -0
  278. package/src/contract_function_simulator/oracle/private_execution.ts +5 -71
  279. package/src/contract_function_simulator/oracle/private_execution_oracle.ts +213 -209
  280. package/src/contract_function_simulator/oracle/utility_execution_oracle.ts +657 -254
  281. package/src/contract_function_simulator/pick_notes.ts +22 -3
  282. package/src/contract_function_simulator/proxied_contract_data_source.ts +41 -64
  283. package/src/contract_logging.ts +52 -0
  284. package/src/contract_sync/contract_sync_service.ts +189 -0
  285. package/src/contract_sync/helpers.ts +86 -0
  286. package/src/debug/pxe_debug_utils.ts +55 -18
  287. package/src/entrypoints/client/bundle/index.ts +2 -0
  288. package/src/entrypoints/client/bundle/utils.ts +26 -20
  289. package/src/entrypoints/client/lazy/index.ts +2 -0
  290. package/src/entrypoints/client/lazy/utils.ts +28 -21
  291. package/src/entrypoints/pxe_creation_options.ts +16 -1
  292. package/src/entrypoints/server/index.ts +5 -1
  293. package/src/entrypoints/server/utils.ts +37 -32
  294. package/src/events/event_service.ts +79 -39
  295. package/src/events/private_event_filter_validator.ts +23 -5
  296. package/src/hooks/authorize_utility_call.ts +44 -0
  297. package/src/hooks/execution_hooks.ts +48 -0
  298. package/src/hooks/index.ts +7 -0
  299. package/src/job_coordinator/job_coordinator.ts +4 -3
  300. package/src/logs/log_service.ts +171 -141
  301. package/src/messages/message_context_service.ts +45 -0
  302. package/src/notes/note_service.ts +137 -107
  303. package/src/notes_filter.ts +24 -0
  304. package/src/oracle_version.ts +20 -9
  305. package/src/private_kernel/batch_planner.ts +169 -0
  306. package/src/private_kernel/hints/{compute_tx_include_by_timestamp.ts → compute_tx_expiration_timestamp.ts} +13 -13
  307. package/src/private_kernel/hints/index.ts +2 -2
  308. package/src/private_kernel/hints/{build_private_kernel_reset_private_inputs.ts → private_kernel_reset_private_inputs_builder.ts} +196 -137
  309. package/src/private_kernel/hints/test_utils.ts +318 -0
  310. package/src/private_kernel/private_kernel_execution_prover.ts +261 -93
  311. package/src/private_kernel/private_kernel_oracle.ts +129 -40
  312. package/src/pxe.ts +467 -273
  313. package/src/storage/address_store/address_store.ts +15 -15
  314. package/src/storage/anchor_block_store/anchor_block_store.ts +9 -1
  315. package/src/storage/backwards_compatibility_tests/__snapshots__/AddressStore.json +22 -0
  316. package/src/storage/backwards_compatibility_tests/__snapshots__/AnchorBlockStore.json +3 -0
  317. package/src/storage/backwards_compatibility_tests/__snapshots__/CapsuleStore.json +16 -0
  318. package/src/storage/backwards_compatibility_tests/__snapshots__/ContractStore.json +28 -0
  319. package/src/storage/backwards_compatibility_tests/__snapshots__/KeyStore.json +52 -0
  320. package/src/storage/backwards_compatibility_tests/__snapshots__/L2TipsKVStore.json +46 -0
  321. package/src/storage/backwards_compatibility_tests/__snapshots__/NoteStore.json +36 -0
  322. package/src/storage/backwards_compatibility_tests/__snapshots__/PrivateEventStore.json +44 -0
  323. package/src/storage/backwards_compatibility_tests/__snapshots__/RecipientTaggingStore.json +18 -0
  324. package/src/storage/backwards_compatibility_tests/__snapshots__/SenderAddressBookStore.json +16 -0
  325. package/src/storage/backwards_compatibility_tests/__snapshots__/SenderTaggingStore.json +22 -0
  326. package/src/storage/backwards_compatibility_tests/__snapshots__/opened_stores.json +97 -0
  327. package/src/storage/backwards_compatibility_tests/kv_store_snapshot.ts +122 -0
  328. package/src/storage/backwards_compatibility_tests/schema_tests.ts +712 -0
  329. package/src/storage/backwards_compatibility_tests/store_spy.ts +73 -0
  330. package/src/storage/capsule_store/capsule_service.ts +90 -0
  331. package/src/storage/capsule_store/capsule_store.ts +183 -29
  332. package/src/storage/capsule_store/index.ts +1 -0
  333. package/src/storage/contract_store/contract_store.ts +194 -125
  334. package/src/storage/metadata.ts +1 -1
  335. package/src/storage/note_store/note_store.ts +323 -320
  336. package/src/storage/note_store/stored_note.ts +48 -0
  337. package/src/storage/open_pxe_stores.ts +49 -0
  338. package/src/storage/private_event_store/private_event_store.ts +296 -124
  339. package/src/storage/private_event_store/stored_private_event.ts +73 -0
  340. package/src/storage/tagging_store/recipient_tagging_store.ts +107 -21
  341. package/src/storage/tagging_store/sender_address_book_store.ts +20 -14
  342. package/src/storage/tagging_store/sender_tagging_store.ts +366 -134
  343. package/src/tagging/get_all_logs_by_tags.ts +120 -0
  344. package/src/tagging/index.ts +6 -4
  345. package/src/tagging/persist_sender_tagging_index_ranges.ts +57 -0
  346. package/src/tagging/recipient_sync/sync_tagged_private_logs.ts +240 -0
  347. package/src/tagging/recipient_sync/utils/find_highest_indexes.ts +4 -4
  348. package/src/tagging/reconcile_tagging_index_ranges.ts +102 -0
  349. package/src/tagging/sender_sync/sync_sender_tagging_indexes.ts +59 -21
  350. package/src/tagging/sender_sync/utils/get_status_change_of_pending.ts +47 -29
  351. package/src/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.ts +41 -29
  352. package/dest/contract_function_simulator/proxied_node.d.ts +0 -9
  353. package/dest/contract_function_simulator/proxied_node.d.ts.map +0 -1
  354. package/dest/contract_function_simulator/proxied_node.js +0 -27
  355. package/dest/private_kernel/hints/build_private_kernel_reset_private_inputs.d.ts +0 -28
  356. package/dest/private_kernel/hints/build_private_kernel_reset_private_inputs.d.ts.map +0 -1
  357. package/dest/private_kernel/hints/compute_tx_include_by_timestamp.d.ts +0 -4
  358. package/dest/private_kernel/hints/compute_tx_include_by_timestamp.d.ts.map +0 -1
  359. package/dest/private_kernel/private_kernel_oracle_impl.d.ts +0 -46
  360. package/dest/private_kernel/private_kernel_oracle_impl.d.ts.map +0 -1
  361. package/dest/private_kernel/private_kernel_oracle_impl.js +0 -85
  362. package/dest/public_storage/public_storage_service.d.ts +0 -24
  363. package/dest/public_storage/public_storage_service.d.ts.map +0 -1
  364. package/dest/public_storage/public_storage_service.js +0 -26
  365. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts +0 -14
  366. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts.map +0 -1
  367. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.js +0 -99
  368. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts +0 -14
  369. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts.map +0 -1
  370. package/dest/tagging/recipient_sync/utils/load_logs_for_range.js +0 -29
  371. package/dest/tree_membership/tree_membership_service.d.ts +0 -52
  372. package/dest/tree_membership/tree_membership_service.d.ts.map +0 -1
  373. package/dest/tree_membership/tree_membership_service.js +0 -84
  374. package/src/contract_function_simulator/proxied_node.ts +0 -33
  375. package/src/private_kernel/private_kernel_oracle_impl.ts +0 -127
  376. package/src/public_storage/public_storage_service.ts +0 -33
  377. package/src/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.ts +0 -132
  378. package/src/tagging/recipient_sync/utils/load_logs_for_range.ts +0 -43
  379. package/src/tree_membership/tree_membership_service.ts +0 -112
@@ -1,14 +0,0 @@
1
- import type { BlockNumber } from '@aztec/foundation/branded-types';
2
- import type { AztecAddress } from '@aztec/stdlib/aztec-address';
3
- import type { AztecNode } from '@aztec/stdlib/interfaces/client';
4
- import type { DirectionalAppTaggingSecret, TxScopedL2Log } from '@aztec/stdlib/logs';
5
- import type { RecipientTaggingStore } from '../../storage/tagging_store/recipient_tagging_store.js';
6
- /**
7
- * Loads private logs for `app` and sender-recipient pair defined by `secret` and updates the highest aged and
8
- * finalized indexes in the db. At most load logs from blocks up to and including `anchorBlockNumber`.
9
- *
10
- * @dev This function can be safely executed "in parallel" for other sender-recipient pairs because the data in
11
- * in the tagging data provider is indexed by the secret and hence completely disjoint.
12
- */
13
- export declare function loadPrivateLogsForSenderRecipientPair(secret: DirectionalAppTaggingSecret, app: AztecAddress, aztecNode: AztecNode, taggingStore: RecipientTaggingStore, anchorBlockNumber: BlockNumber): Promise<TxScopedL2Log[]>;
14
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9hZF9wcml2YXRlX2xvZ3NfZm9yX3NlbmRlcl9yZWNpcGllbnRfcGFpci5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL3RhZ2dpbmcvcmVjaXBpZW50X3N5bmMvbG9hZF9wcml2YXRlX2xvZ3NfZm9yX3NlbmRlcl9yZWNpcGllbnRfcGFpci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxXQUFXLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUNuRSxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUNoRSxPQUFPLEtBQUssRUFBRSxTQUFTLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUNqRSxPQUFPLEtBQUssRUFBRSwyQkFBMkIsRUFBRSxhQUFhLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUVyRixPQUFPLEtBQUssRUFBRSxxQkFBcUIsRUFBRSxNQUFNLHdEQUF3RCxDQUFDO0FBS3BHOzs7Ozs7R0FNRztBQUNILHdCQUFzQixxQ0FBcUMsQ0FDekQsTUFBTSxFQUFFLDJCQUEyQixFQUNuQyxHQUFHLEVBQUUsWUFBWSxFQUNqQixTQUFTLEVBQUUsU0FBUyxFQUNwQixZQUFZLEVBQUUscUJBQXFCLEVBQ25DLGlCQUFpQixFQUFFLFdBQVcsR0FDN0IsT0FBTyxDQUFDLGFBQWEsRUFBRSxDQUFDLENBNEcxQiJ9
@@ -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,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,GAC7B,OAAO,CAAC,aAAa,EAAE,CAAC,CA4G1B"}
@@ -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) {
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_INCLUDE_BY_TIMESTAMP_DURATION` 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_INCLUDE_BY_TIMESTAMP_DURATION` 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_INCLUDE_BY_TIMESTAMP_DURATION` 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_INCLUDE_BY_TIMESTAMP_DURATION`
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);
65
- const currentHighestFinalizedIndex = await taggingStore.getHighestFinalizedIndex(secret);
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);
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);
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);
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,14 +0,0 @@
1
- import type { BlockNumber } from '@aztec/foundation/branded-types';
2
- import type { AztecAddress } from '@aztec/stdlib/aztec-address';
3
- import type { AztecNode } from '@aztec/stdlib/interfaces/client';
4
- import type { DirectionalAppTaggingSecret, TxScopedL2Log } from '@aztec/stdlib/logs';
5
- /**
6
- * Gets private logs with their corresponding block timestamps and tagging indexes for the given index range, `app` and
7
- * `secret`. At most load logs from blocks up to and including `anchorBlockNumber`. `start` is inclusive and `end` is
8
- * exclusive.
9
- */
10
- export declare function loadLogsForRange(secret: DirectionalAppTaggingSecret, app: AztecAddress, aztecNode: AztecNode, start: number, end: number, anchorBlockNumber: BlockNumber): Promise<Array<{
11
- log: TxScopedL2Log;
12
- taggingIndex: number;
13
- }>>;
14
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9hZF9sb2dzX2Zvcl9yYW5nZS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL3RhZ2dpbmcvcmVjaXBpZW50X3N5bmMvdXRpbHMvbG9hZF9sb2dzX2Zvcl9yYW5nZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxXQUFXLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUNuRSxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUNoRSxPQUFPLEtBQUssRUFBRSxTQUFTLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUNqRSxPQUFPLEtBQUssRUFBRSwyQkFBMkIsRUFBVSxhQUFhLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUc3Rjs7OztHQUlHO0FBQ0gsd0JBQXNCLGdCQUFnQixDQUNwQyxNQUFNLEVBQUUsMkJBQTJCLEVBQ25DLEdBQUcsRUFBRSxZQUFZLEVBQ2pCLFNBQVMsRUFBRSxTQUFTLEVBQ3BCLEtBQUssRUFBRSxNQUFNLEVBQ2IsR0FBRyxFQUFFLE1BQU0sRUFDWCxpQkFBaUIsRUFBRSxXQUFXLEdBQzdCLE9BQU8sQ0FBQyxLQUFLLENBQUM7SUFBRSxHQUFHLEVBQUUsYUFBYSxDQUFDO0lBQUMsWUFBWSxFQUFFLE1BQU0sQ0FBQTtDQUFFLENBQUMsQ0FBQyxDQXdCOUQifQ==
@@ -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,iCAAiC,CAAC;AACjE,OAAO,KAAK,EAAE,2BAA2B,EAAU,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAG7F;;;;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,GAC7B,OAAO,CAAC,KAAK,CAAC;IAAE,GAAG,EAAE,aAAa,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAwB9D"}
@@ -1,29 +0,0 @@
1
- import { SiloedTag, Tag } from '@aztec/stdlib/logs';
2
- /**
3
- * Gets private logs with their corresponding block timestamps and tagging indexes for the given index range, `app` and
4
- * `secret`. At most load logs from blocks up to and including `anchorBlockNumber`. `start` is inclusive and `end` is
5
- * exclusive.
6
- */ export async function loadLogsForRange(secret, app, aztecNode, start, end, anchorBlockNumber) {
7
- // Derive tags for the window
8
- const preTags = Array(end - start).fill(0).map((_, i)=>({
9
- secret,
10
- index: start + i
11
- }));
12
- const siloedTags = await Promise.all(preTags.map((preTag)=>Tag.compute(preTag))).then((tags)=>Promise.all(tags.map((tag)=>SiloedTag.compute(tag, app))));
13
- const logs = await aztecNode.getPrivateLogsByTags(siloedTags);
14
- // Pair logs with their corresponding tagging indexes
15
- const logsWithIndexes = [];
16
- for(let i = 0; i < logs.length; i++){
17
- const logsForTag = logs[i];
18
- const taggingIndex = preTags[i].index;
19
- for (const log of logsForTag){
20
- if (log.blockNumber <= anchorBlockNumber) {
21
- logsWithIndexes.push({
22
- log,
23
- taggingIndex
24
- });
25
- }
26
- }
27
- }
28
- return logsWithIndexes;
29
- }
@@ -1,52 +0,0 @@
1
- import type { L1_TO_L2_MSG_TREE_HEIGHT } from '@aztec/constants';
2
- import type { Fr } from '@aztec/foundation/curves/bn254';
3
- import type { SiblingPath } from '@aztec/foundation/trees';
4
- import type { AztecAddress } from '@aztec/stdlib/aztec-address';
5
- import type { BlockParameter } from '@aztec/stdlib/block';
6
- import type { AztecNode } from '@aztec/stdlib/interfaces/server';
7
- import { MerkleTreeId, NullifierMembershipWitness, PublicDataWitness } from '@aztec/stdlib/trees';
8
- import type { AnchorBlockStore } from '../storage/anchor_block_store/anchor_block_store.js';
9
- export declare class TreeMembershipService {
10
- #private;
11
- private readonly aztecNode;
12
- private readonly anchorBlockStore;
13
- constructor(aztecNode: AztecNode, anchorBlockStore: AnchorBlockStore);
14
- /**
15
- * Gets the index of a nullifier in the nullifier tree.
16
- * @returns - The index of the nullifier. Undefined if it does not exist in the tree.
17
- */
18
- getNullifierIndex(nullifier: Fr): Promise<bigint | undefined>;
19
- /**
20
- * Fetches the index and sibling path of a leaf at a given block from a given tree.
21
- * @param blockNumber - The block number at which to get the membership witness.
22
- * @param treeId - Id of the tree to get the sibling path from.
23
- * @param leafValue - The leaf value
24
- * @returns The index and sibling path concatenated [index, sibling_path]
25
- */
26
- getMembershipWitness(blockNumber: BlockParameter, treeId: MerkleTreeId, leafValue: Fr): Promise<Fr[]>;
27
- /**
28
- * Returns a low nullifier membership witness for a given nullifier at a given block.
29
- * @param blockNumber - The block number at which to get the index.
30
- * @param nullifier - Nullifier we try to find the low nullifier witness for.
31
- * @returns The low nullifier membership witness (if found).
32
- * @remarks Low nullifier witness can be used to perform a nullifier non-inclusion proof by leveraging the "linked
33
- * list structure" of leaves and proving that a lower nullifier is pointing to a bigger next value than the nullifier
34
- * we are trying to prove non-inclusion for.
35
- */
36
- getLowNullifierMembershipWitness(blockNumber: BlockParameter, nullifier: Fr): Promise<NullifierMembershipWitness | undefined>;
37
- /**
38
- * Returns a witness for a given slot of the public data tree at a given block.
39
- * @param blockNumber - The block number at which to get the witness.
40
- * @param leafSlot - The slot of the public data in the public data tree.
41
- */
42
- getPublicDataWitness(blockNumber: BlockParameter, leafSlot: Fr): Promise<PublicDataWitness | undefined>;
43
- /**
44
- * Looks for the L1 to L2 membership witness of a message at the Aztec node, given its hash.
45
- * @param contractAddress - Address of a contract by which the message was emitted.
46
- * @dev Contract address and secret are only used to compute the nullifier to get non-nullified messages.
47
- * The message nullifier is computed locally, so the secret is not sent to the node.
48
- * @returns The l1 to l2 membership witness (index of message in the tree and sibling path).
49
- */
50
- getL1ToL2MembershipWitness(contractAddress: AztecAddress, messageHash: Fr, secret: Fr): Promise<[bigint, SiblingPath<typeof L1_TO_L2_MSG_TREE_HEIGHT>]>;
51
- }
52
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHJlZV9tZW1iZXJzaGlwX3NlcnZpY2UuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90cmVlX21lbWJlcnNoaXAvdHJlZV9tZW1iZXJzaGlwX3NlcnZpY2UudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsd0JBQXdCLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUNqRSxPQUFPLEtBQUssRUFBRSxFQUFFLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUN6RCxPQUFPLEtBQUssRUFBRSxXQUFXLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUMzRCxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUNoRSxPQUFPLEtBQUssRUFBRSxjQUFjLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUMxRCxPQUFPLEtBQUssRUFBRSxTQUFTLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUVqRSxPQUFPLEVBQUUsWUFBWSxFQUFFLDBCQUEwQixFQUFFLGlCQUFpQixFQUFFLE1BQU0scUJBQXFCLENBQUM7QUFFbEcsT0FBTyxLQUFLLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxxREFBcUQsQ0FBQztBQUU1RixxQkFBYSxxQkFBcUI7O0lBRTlCLE9BQU8sQ0FBQyxRQUFRLENBQUMsU0FBUztJQUMxQixPQUFPLENBQUMsUUFBUSxDQUFDLGdCQUFnQjtJQUZuQyxZQUNtQixTQUFTLEVBQUUsU0FBUyxFQUNwQixnQkFBZ0IsRUFBRSxnQkFBZ0IsRUFDakQ7SUFFSjs7O09BR0c7SUFDSSxpQkFBaUIsQ0FBQyxTQUFTLEVBQUUsRUFBRSwrQkFFckM7SUFFRDs7Ozs7O09BTUc7SUFDVSxvQkFBb0IsQ0FBQyxXQUFXLEVBQUUsY0FBYyxFQUFFLE1BQU0sRUFBRSxZQUFZLEVBQUUsU0FBUyxFQUFFLEVBQUUsR0FBRyxPQUFPLENBQUMsRUFBRSxFQUFFLENBQUMsQ0FNakg7SUFFRDs7Ozs7Ozs7T0FRRztJQUNVLGdDQUFnQyxDQUMzQyxXQUFXLEVBQUUsY0FBYyxFQUMzQixTQUFTLEVBQUUsRUFBRSxHQUNaLE9BQU8sQ0FBQywwQkFBMEIsR0FBRyxTQUFTLENBQUMsQ0FNakQ7SUFFRDs7OztPQUlHO0lBQ1Usb0JBQW9CLENBQUMsV0FBVyxFQUFFLGNBQWMsRUFBRSxRQUFRLEVBQUUsRUFBRSxHQUFHLE9BQU8sQ0FBQyxpQkFBaUIsR0FBRyxTQUFTLENBQUMsQ0FNbkg7SUFFRDs7Ozs7O09BTUc7SUFDSSwwQkFBMEIsQ0FDL0IsZUFBZSxFQUFFLFlBQVksRUFDN0IsV0FBVyxFQUFFLEVBQUUsRUFDZixNQUFNLEVBQUUsRUFBRSxHQUNULE9BQU8sQ0FBQyxDQUFDLE1BQU0sRUFBRSxXQUFXLENBQUMsT0FBTyx3QkFBd0IsQ0FBQyxDQUFDLENBQUMsQ0FFakU7Q0F5QkYifQ==
@@ -1 +0,0 @@
1
- {"version":3,"file":"tree_membership_service.d.ts","sourceRoot":"","sources":["../../src/tree_membership/tree_membership_service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAEjE,OAAO,EAAE,YAAY,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAElG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qDAAqD,CAAC;AAE5F,qBAAa,qBAAqB;;IAE9B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAFnC,YACmB,SAAS,EAAE,SAAS,EACpB,gBAAgB,EAAE,gBAAgB,EACjD;IAEJ;;;OAGG;IACI,iBAAiB,CAAC,SAAS,EAAE,EAAE,+BAErC;IAED;;;;;;OAMG;IACU,oBAAoB,CAAC,WAAW,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,EAAE,CAAC,CAMjH;IAED;;;;;;;;OAQG;IACU,gCAAgC,CAC3C,WAAW,EAAE,cAAc,EAC3B,SAAS,EAAE,EAAE,GACZ,OAAO,CAAC,0BAA0B,GAAG,SAAS,CAAC,CAMjD;IAED;;;;OAIG;IACU,oBAAoB,CAAC,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,EAAE,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAMnH;IAED;;;;;;OAMG;IACI,0BAA0B,CAC/B,eAAe,EAAE,YAAY,EAC7B,WAAW,EAAE,EAAE,EACf,MAAM,EAAE,EAAE,GACT,OAAO,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,wBAAwB,CAAC,CAAC,CAAC,CAEjE;CAyBF"}
@@ -1,84 +0,0 @@
1
- import { getNonNullifiedL1ToL2MessageWitness } from '@aztec/stdlib/messaging';
2
- import { MerkleTreeId } from '@aztec/stdlib/trees';
3
- export class TreeMembershipService {
4
- aztecNode;
5
- anchorBlockStore;
6
- constructor(aztecNode, anchorBlockStore){
7
- this.aztecNode = aztecNode;
8
- this.anchorBlockStore = anchorBlockStore;
9
- }
10
- /**
11
- * Gets the index of a nullifier in the nullifier tree.
12
- * @returns - The index of the nullifier. Undefined if it does not exist in the tree.
13
- */ getNullifierIndex(nullifier) {
14
- return this.#findLeafIndex('latest', MerkleTreeId.NULLIFIER_TREE, nullifier);
15
- }
16
- /**
17
- * Fetches the index and sibling path of a leaf at a given block from a given tree.
18
- * @param blockNumber - The block number at which to get the membership witness.
19
- * @param treeId - Id of the tree to get the sibling path from.
20
- * @param leafValue - The leaf value
21
- * @returns The index and sibling path concatenated [index, sibling_path]
22
- */ async getMembershipWitness(blockNumber, treeId, leafValue) {
23
- const witness = await this.#tryGetMembershipWitness(blockNumber, treeId, leafValue);
24
- if (!witness) {
25
- throw new Error(`Leaf value ${leafValue} not found in tree ${MerkleTreeId[treeId]} at block ${blockNumber}`);
26
- }
27
- return witness;
28
- }
29
- /**
30
- * Returns a low nullifier membership witness for a given nullifier at a given block.
31
- * @param blockNumber - The block number at which to get the index.
32
- * @param nullifier - Nullifier we try to find the low nullifier witness for.
33
- * @returns The low nullifier membership witness (if found).
34
- * @remarks Low nullifier witness can be used to perform a nullifier non-inclusion proof by leveraging the "linked
35
- * list structure" of leaves and proving that a lower nullifier is pointing to a bigger next value than the nullifier
36
- * we are trying to prove non-inclusion for.
37
- */ async getLowNullifierMembershipWitness(blockNumber, nullifier) {
38
- const anchorBlockNumber = (await this.anchorBlockStore.getBlockHeader()).getBlockNumber();
39
- if (blockNumber !== 'latest' && blockNumber > anchorBlockNumber) {
40
- throw new Error(`Block number ${blockNumber} is higher than current block ${anchorBlockNumber}`);
41
- }
42
- return this.aztecNode.getLowNullifierMembershipWitness(blockNumber, nullifier);
43
- }
44
- /**
45
- * Returns a witness for a given slot of the public data tree at a given block.
46
- * @param blockNumber - The block number at which to get the witness.
47
- * @param leafSlot - The slot of the public data in the public data tree.
48
- */ async getPublicDataWitness(blockNumber, leafSlot) {
49
- const anchorBlockNumber = (await this.anchorBlockStore.getBlockHeader()).getBlockNumber();
50
- if (blockNumber !== 'latest' && blockNumber > anchorBlockNumber) {
51
- throw new Error(`Block number ${blockNumber} is higher than current block ${anchorBlockNumber}`);
52
- }
53
- return await this.aztecNode.getPublicDataWitness(blockNumber, leafSlot);
54
- }
55
- /**
56
- * Looks for the L1 to L2 membership witness of a message at the Aztec node, given its hash.
57
- * @param contractAddress - Address of a contract by which the message was emitted.
58
- * @dev Contract address and secret are only used to compute the nullifier to get non-nullified messages.
59
- * The message nullifier is computed locally, so the secret is not sent to the node.
60
- * @returns The l1 to l2 membership witness (index of message in the tree and sibling path).
61
- */ getL1ToL2MembershipWitness(contractAddress, messageHash, secret) {
62
- return getNonNullifiedL1ToL2MessageWitness(this.aztecNode, contractAddress, messageHash, secret);
63
- }
64
- async #tryGetMembershipWitness(blockNumber, treeId, value) {
65
- switch(treeId){
66
- case MerkleTreeId.NULLIFIER_TREE:
67
- return (await this.aztecNode.getNullifierMembershipWitness(blockNumber, value))?.withoutPreimage().toFields();
68
- case MerkleTreeId.NOTE_HASH_TREE:
69
- return (await this.aztecNode.getNoteHashMembershipWitness(blockNumber, value))?.toFields();
70
- case MerkleTreeId.PUBLIC_DATA_TREE:
71
- return (await this.aztecNode.getPublicDataWitness(blockNumber, value))?.withoutPreimage().toFields();
72
- case MerkleTreeId.ARCHIVE:
73
- return (await this.aztecNode.getArchiveMembershipWitness(blockNumber, value))?.toFields();
74
- default:
75
- throw new Error('Not implemented');
76
- }
77
- }
78
- async #findLeafIndex(blockNumber, treeId, leafValue) {
79
- const [leafIndex] = await this.aztecNode.findLeavesIndexes(blockNumber, treeId, [
80
- leafValue
81
- ]);
82
- return leafIndex?.data;
83
- }
84
- }
@@ -1,33 +0,0 @@
1
- import { Timer } from '@aztec/foundation/timer';
2
- import type { AztecNode } from '@aztec/stdlib/interfaces/client';
3
- import type { NodeStats } from '@aztec/stdlib/tx';
4
-
5
- /*
6
- * Proxy generator for an AztecNode that tracks the time taken for each RPC call.
7
- */
8
- export type ProxiedNode = AztecNode & { getStats(): NodeStats };
9
-
10
- export class ProxiedNodeFactory {
11
- static create(node: AztecNode) {
12
- const stats: Partial<Record<keyof AztecNode, { times: number[] }>> = {};
13
- return new Proxy(node, {
14
- get(target, prop: keyof ProxiedNode) {
15
- if (prop === 'getStats') {
16
- return () => {
17
- return stats;
18
- };
19
- } else {
20
- return async function (...args: any[]) {
21
- if (!stats[prop]) {
22
- stats[prop] = { times: [] };
23
- }
24
- const timer = new Timer();
25
- const result = await (target[prop] as any).apply(target, args);
26
- stats[prop].times.push(timer.ms());
27
- return result;
28
- };
29
- }
30
- },
31
- }) as ProxiedNode;
32
- }
33
- }
@@ -1,127 +0,0 @@
1
- import { NOTE_HASH_TREE_HEIGHT, PUBLIC_DATA_TREE_HEIGHT, VK_TREE_HEIGHT } from '@aztec/constants';
2
- import type { Fr } from '@aztec/foundation/curves/bn254';
3
- import type { GrumpkinScalar, Point } from '@aztec/foundation/curves/grumpkin';
4
- import { createLogger } from '@aztec/foundation/log';
5
- import { MembershipWitness } from '@aztec/foundation/trees';
6
- import type { KeyStore } from '@aztec/key-store';
7
- import { getVKIndex, getVKSiblingPath } from '@aztec/noir-protocol-circuits-types/vk-tree';
8
- import { ProtocolContractAddress } from '@aztec/protocol-contracts';
9
- import type { FunctionSelector } from '@aztec/stdlib/abi';
10
- import type { AztecAddress } from '@aztec/stdlib/aztec-address';
11
- import type { BlockParameter } from '@aztec/stdlib/block';
12
- import { computeContractClassIdPreimage, computeSaltedInitializationHash } from '@aztec/stdlib/contract';
13
- import { DelayedPublicMutableValues, DelayedPublicMutableValuesWithHash } from '@aztec/stdlib/delayed-public-mutable';
14
- import { computePublicDataTreeLeafSlot } from '@aztec/stdlib/hash';
15
- import type { AztecNode } from '@aztec/stdlib/interfaces/client';
16
- import { UpdatedClassIdHints } from '@aztec/stdlib/kernel';
17
- import type { NullifierMembershipWitness } from '@aztec/stdlib/trees';
18
- import type { VerificationKeyAsFields } from '@aztec/stdlib/vks';
19
-
20
- import type { ContractStore } from '../storage/contract_store/contract_store.js';
21
- import type { PrivateKernelOracle } from './private_kernel_oracle.js';
22
-
23
- // TODO: Block number should not be "latest".
24
- // It should be fixed at the time the proof is being simulated. I.e., it should be the same as the value defined in the constant data.
25
-
26
- /**
27
- * A data oracle that provides information needed for simulating a transaction.
28
- */
29
- export class PrivateKernelOracleImpl implements PrivateKernelOracle {
30
- constructor(
31
- private contractStore: ContractStore,
32
- private keyStore: KeyStore,
33
- private node: AztecNode,
34
- private blockNumber: BlockParameter = 'latest',
35
- private log = createLogger('pxe:kernel_oracle'),
36
- ) {}
37
-
38
- public async getContractAddressPreimage(address: AztecAddress) {
39
- const instance = await this.contractStore.getContractInstance(address);
40
- if (!instance) {
41
- throw new Error(`Contract instance not found when getting address preimage. Contract address: ${address}.`);
42
- }
43
- return {
44
- saltedInitializationHash: await computeSaltedInitializationHash(instance),
45
- ...instance,
46
- };
47
- }
48
-
49
- public async getContractClassIdPreimage(contractClassId: Fr) {
50
- const contractClass = await this.contractStore.getContractClass(contractClassId);
51
- if (!contractClass) {
52
- throw new Error(`Contract class not found when getting class id preimage. Class id: ${contractClassId}.`);
53
- }
54
- return computeContractClassIdPreimage(contractClass);
55
- }
56
-
57
- public async getFunctionMembershipWitness(contractClassId: Fr, selector: FunctionSelector) {
58
- const membershipWitness = await this.contractStore.getFunctionMembershipWitness(contractClassId, selector);
59
- if (!membershipWitness) {
60
- throw new Error(
61
- `Membership witness not found for contract class id ${contractClassId} and selector ${selector}.`,
62
- );
63
- }
64
- return membershipWitness;
65
- }
66
-
67
- public getVkMembershipWitness(vk: VerificationKeyAsFields) {
68
- const leafIndex = getVKIndex(vk);
69
- return Promise.resolve(new MembershipWitness(VK_TREE_HEIGHT, BigInt(leafIndex), getVKSiblingPath(leafIndex)));
70
- }
71
-
72
- getNoteHashMembershipWitness(noteHash: Fr): Promise<MembershipWitness<typeof NOTE_HASH_TREE_HEIGHT> | undefined> {
73
- return this.node.getNoteHashMembershipWitness(this.blockNumber, noteHash);
74
- }
75
-
76
- getNullifierMembershipWitness(nullifier: Fr): Promise<NullifierMembershipWitness | undefined> {
77
- return this.node.getNullifierMembershipWitness(this.blockNumber, nullifier);
78
- }
79
-
80
- async getNoteHashTreeRoot(): Promise<Fr> {
81
- const header = await this.node.getBlockHeader(this.blockNumber);
82
- if (!header) {
83
- throw new Error(`No block header found for block number ${this.blockNumber}`);
84
- }
85
- return header.state.partial.noteHashTree.root;
86
- }
87
-
88
- public getMasterSecretKey(masterPublicKey: Point): Promise<GrumpkinScalar> {
89
- return this.keyStore.getMasterSecretKey(masterPublicKey);
90
- }
91
-
92
- public getDebugFunctionName(contractAddress: AztecAddress, selector: FunctionSelector): Promise<string> {
93
- return this.contractStore.getDebugFunctionName(contractAddress, selector);
94
- }
95
-
96
- public async getUpdatedClassIdHints(contractAddress: AztecAddress): Promise<UpdatedClassIdHints> {
97
- const { delayedPublicMutableSlot, delayedPublicMutableHashSlot } =
98
- await DelayedPublicMutableValuesWithHash.getContractUpdateSlots(contractAddress);
99
-
100
- const hashLeafSlot = await computePublicDataTreeLeafSlot(
101
- ProtocolContractAddress.ContractInstanceRegistry,
102
- delayedPublicMutableHashSlot,
103
- );
104
- const updatedClassIdWitness = await this.node.getPublicDataWitness(this.blockNumber, hashLeafSlot);
105
-
106
- if (!updatedClassIdWitness) {
107
- throw new Error(`No public data tree witness found for ${hashLeafSlot}`);
108
- }
109
-
110
- const readStorage = (storageSlot: Fr) =>
111
- this.node.getPublicStorageAt(this.blockNumber, ProtocolContractAddress.ContractInstanceRegistry, storageSlot);
112
- const delayedPublicMutableValues = await DelayedPublicMutableValues.readFromTree(
113
- delayedPublicMutableSlot,
114
- readStorage,
115
- );
116
-
117
- return new UpdatedClassIdHints(
118
- new MembershipWitness(
119
- PUBLIC_DATA_TREE_HEIGHT,
120
- updatedClassIdWitness.index,
121
- updatedClassIdWitness.siblingPath.toTuple(),
122
- ),
123
- updatedClassIdWitness.leafPreimage,
124
- delayedPublicMutableValues,
125
- );
126
- }
127
- }
@@ -1,33 +0,0 @@
1
- import type { Fr } from '@aztec/foundation/curves/bn254';
2
- import type { AztecAddress } from '@aztec/stdlib/aztec-address';
3
- import type { BlockParameter } from '@aztec/stdlib/block';
4
- import type { AztecNode } from '@aztec/stdlib/interfaces/server';
5
-
6
- import type { AnchorBlockStore } from '../storage/anchor_block_store/anchor_block_store.js';
7
-
8
- export class PublicStorageService {
9
- constructor(
10
- private readonly anchorBlockStore: AnchorBlockStore,
11
- private readonly aztecNode: AztecNode,
12
- ) {}
13
-
14
- /**
15
- * Gets the storage value at the given contract storage slot.
16
- *
17
- * @remarks The storage slot here refers to the slot as it is defined in Noir not the index in the merkle tree.
18
- * Aztec's version of `eth_getStorageAt`.
19
- *
20
- * @param blockNumber - The block number at which to get the data.
21
- * @param contract - Address of the contract to query.
22
- * @param slot - Slot to query.
23
- * @returns Storage value at the given contract slot.
24
- * @throws If the contract is not deployed.
25
- */
26
- public async getPublicStorageAt(blockNumber: BlockParameter, contract: AztecAddress, slot: Fr): Promise<Fr> {
27
- const anchorBlockNumber = (await this.anchorBlockStore.getBlockHeader()).getBlockNumber();
28
- if (blockNumber !== 'latest' && blockNumber > anchorBlockNumber) {
29
- throw new Error(`Block number ${blockNumber} is higher than current block ${anchorBlockNumber}`);
30
- }
31
- return await this.aztecNode.getPublicStorageAt(blockNumber, contract, slot);
32
- }
33
- }
@@ -1,132 +0,0 @@
1
- import type { BlockNumber } from '@aztec/foundation/branded-types';
2
- import type { AztecAddress } from '@aztec/stdlib/aztec-address';
3
- import type { AztecNode } from '@aztec/stdlib/interfaces/client';
4
- import type { DirectionalAppTaggingSecret, TxScopedL2Log } from '@aztec/stdlib/logs';
5
-
6
- import type { RecipientTaggingStore } from '../../storage/tagging_store/recipient_tagging_store.js';
7
- import { UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN } from '../constants.js';
8
- import { findHighestIndexes } from './utils/find_highest_indexes.js';
9
- import { loadLogsForRange } from './utils/load_logs_for_range.js';
10
-
11
- /**
12
- * Loads private logs for `app` and sender-recipient pair defined by `secret` and updates the highest aged and
13
- * finalized indexes in the db. At most load logs from blocks up to and including `anchorBlockNumber`.
14
- *
15
- * @dev This function can be safely executed "in parallel" for other sender-recipient pairs because the data in
16
- * in the tagging data provider is indexed by the secret and hence completely disjoint.
17
- */
18
- export async function loadPrivateLogsForSenderRecipientPair(
19
- secret: DirectionalAppTaggingSecret,
20
- app: AztecAddress,
21
- aztecNode: AztecNode,
22
- taggingStore: RecipientTaggingStore,
23
- anchorBlockNumber: BlockNumber,
24
- ): Promise<TxScopedL2Log[]> {
25
- // # Explanation of how the algorithm works
26
- // When we perform the sync we will look at logs that correspond to the tagging index range
27
- // (highestAgedIndex, highestFinalizedIndex + WINDOW_LEN]
28
- //
29
- // highestAgedIndex is the highest index that was used in a tx that is included in a block at least
30
- // `MAX_INCLUDE_BY_TIMESTAMP_DURATION` seconds ago.
31
- // highestFinalizedIndex is the highest index that was used in a tx that is included in a finalized block.
32
- //
33
- // "(" denotes an open end of the range - the index is not included in the range.
34
- // "]" denotes a closed end of the range - the index is included in the range.
35
- //
36
- // ## Explanation of highestAgedIndex
37
- //
38
- // highestAgedIndex is chosen such that for all tagging indexes `i <= highestAgedIndex` we know that no new logs can
39
- // ever appear.
40
- //
41
- // This relies on the "maximum inclusion timestamp" rule enforced by the kernel and rollup circuits:
42
- // - a transaction's maximum inclusion timestamp is at most `MAX_INCLUDE_BY_TIMESTAMP_DURATION` seconds after
43
- // the timestamp of its anchor block; and
44
- // - a rollup only includes transactions whose inclusion timestamp is >= the L2 block's timestamp.
45
- //
46
- // Suppose some device used index `I` in a transaction anchored to block `B_N` at time `N`, and that block is now at
47
- // least `MAX_INCLUDE_BY_TIMESTAMP_DURATION` seconds in the past. Then there is no possibility of any *other* device
48
- // trying to use an index <= `I` while anchoring to a *newer* block than `B_N` because if we were anchoring to
49
- // a newer block than `B_N` then we would already have seen the log with index `I` and hence the device would have
50
- // chosen a larger index.
51
- // If that *other* device would anchor to a block older than `B_N` then that tx could never be included in a block
52
- // because it would already have been expired.
53
- //
54
- // Therefore, once we see that index `I` has been used in a block that is at least `MAX_INCLUDE_BY_TIMESTAMP_DURATION`
55
- // seconds old, we can safely stop syncing logs for all indexes <= `I` and set highestAgedIndex = `I`.
56
- //
57
- // ## Explanation of the upper bound `highestFinalizedIndex + WINDOW_LEN`
58
- //
59
- // When a sender chooses a tagging index, they will select an index that is at most `WINDOW_LEN` greater than
60
- // the highest finalized index. If that index was already used, they will throw an error. For this reason we
61
- // don't have to look further than `highestFinalizedIndex + WINDOW_LEN`.
62
-
63
- let finalizedBlockNumber: number, currentTimestamp: bigint;
64
- {
65
- const [l2Tips, latestBlockHeader] = await Promise.all([aztecNode.getL2Tips(), aztecNode.getBlockHeader('latest')]);
66
-
67
- if (!latestBlockHeader) {
68
- throw new Error('Node failed to return latest block header when syncing logs');
69
- }
70
-
71
- [finalizedBlockNumber, currentTimestamp] = [
72
- l2Tips.finalized.block.number,
73
- latestBlockHeader.globalVariables.timestamp,
74
- ];
75
- }
76
-
77
- let start: number, end: number;
78
- {
79
- const currentHighestAgedIndex = await taggingStore.getHighestAgedIndex(secret);
80
- const currentHighestFinalizedIndex = await taggingStore.getHighestFinalizedIndex(secret);
81
-
82
- // We don't want to include the highest aged index so we start from `currentHighestAgedIndex + 1` (or 0 if not set)
83
- start = currentHighestAgedIndex === undefined ? 0 : currentHighestAgedIndex + 1;
84
-
85
- // The highest index a sender can choose is "highest finalized index + window length" but given that
86
- // `loadLogsForRange` expects an exclusive `end` we add 1.
87
- end = (currentHighestFinalizedIndex ?? 0) + UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN + 1;
88
- }
89
-
90
- const logs: TxScopedL2Log[] = [];
91
-
92
- while (true) {
93
- // Get private logs with their block timestamps and corresponding tagging indexes
94
- const privateLogsWithIndexes = await loadLogsForRange(secret, app, aztecNode, start, end, anchorBlockNumber);
95
-
96
- if (privateLogsWithIndexes.length === 0) {
97
- break;
98
- }
99
-
100
- logs.push(...privateLogsWithIndexes.map(({ log }) => log));
101
-
102
- const { highestAgedIndex, highestFinalizedIndex } = findHighestIndexes(
103
- privateLogsWithIndexes,
104
- currentTimestamp,
105
- finalizedBlockNumber,
106
- );
107
-
108
- // Store updates in data provider and update local variables
109
- if (highestAgedIndex !== undefined) {
110
- await taggingStore.updateHighestAgedIndex(secret, highestAgedIndex);
111
- }
112
-
113
- if (highestFinalizedIndex === undefined) {
114
- // We have not found a new highest finalized index, so there is no need to move the window forward.
115
- break;
116
- }
117
-
118
- if (highestAgedIndex !== undefined && highestAgedIndex > highestFinalizedIndex) {
119
- // This is just a sanity check as this should never happen.
120
- throw new Error('Highest aged index lower than highest finalized index invariant violated');
121
- }
122
-
123
- await taggingStore.updateHighestFinalizedIndex(secret, highestFinalizedIndex);
124
-
125
- // For the next iteration we want to look only at indexes for which we have not attempted to load logs yet while
126
- // ensuring that we do not look further than WINDOW_LEN ahead of the highest finalized index.
127
- start = end;
128
- end = highestFinalizedIndex + UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN + 1; // `end` is exclusive so we add 1.
129
- }
130
-
131
- return logs;
132
- }