@aztec/pxe 0.0.1-commit.2ed92850 → 0.0.1-commit.2f68f620

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 (364) hide show
  1. package/dest/bin/check_oracle_version.js +43 -99
  2. package/dest/bin/index.d.ts +2 -0
  3. package/dest/bin/index.d.ts.map +1 -0
  4. package/dest/bin/index.js +1 -0
  5. package/dest/bin/oracle_version_helpers.d.ts +26 -0
  6. package/dest/bin/oracle_version_helpers.d.ts.map +1 -0
  7. package/dest/bin/oracle_version_helpers.js +93 -0
  8. package/dest/block_synchronizer/block_stream_source.d.ts +10 -0
  9. package/dest/block_synchronizer/block_stream_source.d.ts.map +1 -0
  10. package/dest/block_synchronizer/block_stream_source.js +62 -0
  11. package/dest/block_synchronizer/block_synchronizer.d.ts +10 -4
  12. package/dest/block_synchronizer/block_synchronizer.d.ts.map +1 -1
  13. package/dest/block_synchronizer/block_synchronizer.js +39 -13
  14. package/dest/config/index.d.ts +8 -2
  15. package/dest/config/index.d.ts.map +1 -1
  16. package/dest/config/index.js +13 -15
  17. package/dest/config/package_info.js +1 -1
  18. package/dest/contract_function_simulator/contract_function_simulator.d.ts +66 -31
  19. package/dest/contract_function_simulator/contract_function_simulator.d.ts.map +1 -1
  20. package/dest/contract_function_simulator/contract_function_simulator.js +216 -77
  21. package/dest/contract_function_simulator/ephemeral_array_service.d.ts +28 -0
  22. package/dest/contract_function_simulator/ephemeral_array_service.d.ts.map +1 -0
  23. package/dest/contract_function_simulator/ephemeral_array_service.js +78 -0
  24. package/dest/contract_function_simulator/execution_note_cache.d.ts +2 -2
  25. package/dest/contract_function_simulator/execution_note_cache.d.ts.map +1 -1
  26. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts +7 -11
  27. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts.map +1 -1
  28. package/dest/contract_function_simulator/execution_tagging_index_cache.js +19 -15
  29. package/dest/contract_function_simulator/index.d.ts +14 -2
  30. package/dest/contract_function_simulator/index.d.ts.map +1 -1
  31. package/dest/contract_function_simulator/index.js +11 -0
  32. package/dest/contract_function_simulator/noir-structs/bounded_vec.d.ts +48 -0
  33. package/dest/contract_function_simulator/noir-structs/bounded_vec.d.ts.map +1 -0
  34. package/dest/contract_function_simulator/noir-structs/bounded_vec.js +45 -0
  35. package/dest/contract_function_simulator/noir-structs/ephemeral_array.d.ts +37 -0
  36. package/dest/contract_function_simulator/noir-structs/ephemeral_array.d.ts.map +1 -0
  37. package/dest/contract_function_simulator/noir-structs/ephemeral_array.js +59 -0
  38. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts +3 -4
  39. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts.map +1 -1
  40. package/dest/contract_function_simulator/noir-structs/event_validation_request.js +8 -9
  41. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.d.ts +13 -3
  42. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.d.ts.map +1 -1
  43. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.js +35 -4
  44. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts +2 -2
  45. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts.map +1 -1
  46. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.js +2 -4
  47. package/dest/contract_function_simulator/noir-structs/note_data.d.ts +27 -0
  48. package/dest/contract_function_simulator/noir-structs/note_data.d.ts.map +1 -0
  49. package/dest/contract_function_simulator/noir-structs/note_data.js +3 -0
  50. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts +3 -5
  51. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts.map +1 -1
  52. package/dest/contract_function_simulator/noir-structs/note_validation_request.js +6 -10
  53. package/dest/contract_function_simulator/noir-structs/option.d.ts +61 -0
  54. package/dest/contract_function_simulator/noir-structs/option.d.ts.map +1 -0
  55. package/dest/contract_function_simulator/noir-structs/option.js +62 -0
  56. package/dest/contract_function_simulator/noir-structs/provided_secret.d.ts +11 -0
  57. package/dest/contract_function_simulator/noir-structs/provided_secret.d.ts.map +1 -0
  58. package/dest/contract_function_simulator/noir-structs/provided_secret.js +24 -0
  59. package/dest/contract_function_simulator/oracle/interfaces.d.ts +16 -98
  60. package/dest/contract_function_simulator/oracle/interfaces.d.ts.map +1 -1
  61. package/dest/contract_function_simulator/oracle/interfaces.js +2 -2
  62. package/dest/contract_function_simulator/oracle/note_packing_utils.d.ts +2 -2
  63. package/dest/contract_function_simulator/oracle/note_packing_utils.d.ts.map +1 -1
  64. package/dest/contract_function_simulator/oracle/note_packing_utils.js +2 -2
  65. package/dest/contract_function_simulator/oracle/oracle.d.ts +75 -46
  66. package/dest/contract_function_simulator/oracle/oracle.d.ts.map +1 -1
  67. package/dest/contract_function_simulator/oracle/oracle.js +471 -275
  68. package/dest/contract_function_simulator/oracle/oracle_registry.d.ts +127 -0
  69. package/dest/contract_function_simulator/oracle/oracle_registry.d.ts.map +1 -0
  70. package/dest/contract_function_simulator/oracle/oracle_registry.js +786 -0
  71. package/dest/contract_function_simulator/oracle/oracle_type_mappings.d.ts +139 -0
  72. package/dest/contract_function_simulator/oracle/oracle_type_mappings.d.ts.map +1 -0
  73. package/dest/contract_function_simulator/oracle/oracle_type_mappings.js +560 -0
  74. package/dest/contract_function_simulator/oracle/private_execution.js +5 -3
  75. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts +68 -96
  76. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts.map +1 -1
  77. package/dest/contract_function_simulator/oracle/private_execution_oracle.js +142 -111
  78. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts +156 -78
  79. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts.map +1 -1
  80. package/dest/contract_function_simulator/oracle/utility_execution_oracle.js +454 -172
  81. package/dest/contract_function_simulator/pick_notes.d.ts +1 -1
  82. package/dest/contract_function_simulator/pick_notes.d.ts.map +1 -1
  83. package/dest/contract_function_simulator/pick_notes.js +20 -3
  84. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts +1 -1
  85. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts.map +1 -1
  86. package/dest/contract_function_simulator/proxied_contract_data_source.js +35 -64
  87. package/dest/contract_logging.d.ts +27 -0
  88. package/dest/contract_logging.d.ts.map +1 -0
  89. package/dest/contract_logging.js +38 -0
  90. package/dest/contract_sync/contract_sync_service.d.ts +42 -0
  91. package/dest/contract_sync/contract_sync_service.d.ts.map +1 -0
  92. package/dest/contract_sync/contract_sync_service.js +135 -0
  93. package/dest/contract_sync/helpers.d.ts +27 -0
  94. package/dest/contract_sync/helpers.d.ts.map +1 -0
  95. package/dest/contract_sync/{index.js → helpers.js} +16 -17
  96. package/dest/debug/pxe_debug_utils.d.ts +19 -10
  97. package/dest/debug/pxe_debug_utils.d.ts.map +1 -1
  98. package/dest/debug/pxe_debug_utils.js +22 -18
  99. package/dest/entrypoints/client/bundle/index.d.ts +3 -1
  100. package/dest/entrypoints/client/bundle/index.d.ts.map +1 -1
  101. package/dest/entrypoints/client/bundle/index.js +2 -0
  102. package/dest/entrypoints/client/bundle/utils.d.ts +2 -2
  103. package/dest/entrypoints/client/bundle/utils.d.ts.map +1 -1
  104. package/dest/entrypoints/client/bundle/utils.js +33 -11
  105. package/dest/entrypoints/client/lazy/index.d.ts +3 -1
  106. package/dest/entrypoints/client/lazy/index.d.ts.map +1 -1
  107. package/dest/entrypoints/client/lazy/index.js +2 -0
  108. package/dest/entrypoints/client/lazy/utils.d.ts +3 -3
  109. package/dest/entrypoints/client/lazy/utils.d.ts.map +1 -1
  110. package/dest/entrypoints/client/lazy/utils.js +34 -12
  111. package/dest/entrypoints/pxe_creation_options.d.ts +11 -2
  112. package/dest/entrypoints/pxe_creation_options.d.ts.map +1 -1
  113. package/dest/entrypoints/pxe_creation_options.js +3 -1
  114. package/dest/entrypoints/server/index.d.ts +5 -3
  115. package/dest/entrypoints/server/index.d.ts.map +1 -1
  116. package/dest/entrypoints/server/index.js +4 -2
  117. package/dest/entrypoints/server/utils.d.ts +4 -3
  118. package/dest/entrypoints/server/utils.d.ts.map +1 -1
  119. package/dest/entrypoints/server/utils.js +40 -13
  120. package/dest/events/event_service.d.ts +16 -8
  121. package/dest/events/event_service.d.ts.map +1 -1
  122. package/dest/events/event_service.js +46 -14
  123. package/dest/events/private_event_filter_validator.d.ts +3 -2
  124. package/dest/events/private_event_filter_validator.d.ts.map +1 -1
  125. package/dest/events/private_event_filter_validator.js +15 -0
  126. package/dest/hooks/authorize_utility_call.d.ts +41 -0
  127. package/dest/hooks/authorize_utility_call.d.ts.map +1 -0
  128. package/dest/hooks/authorize_utility_call.js +4 -0
  129. package/dest/hooks/execution_hooks.d.ts +42 -0
  130. package/dest/hooks/execution_hooks.d.ts.map +1 -0
  131. package/dest/hooks/execution_hooks.js +9 -0
  132. package/dest/hooks/index.d.ts +4 -0
  133. package/dest/hooks/index.d.ts.map +1 -0
  134. package/dest/hooks/index.js +1 -0
  135. package/dest/job_coordinator/job_coordinator.d.ts +3 -2
  136. package/dest/job_coordinator/job_coordinator.d.ts.map +1 -1
  137. package/dest/job_coordinator/job_coordinator.js +3 -2
  138. package/dest/logs/log_service.d.ts +12 -10
  139. package/dest/logs/log_service.d.ts.map +1 -1
  140. package/dest/logs/log_service.js +134 -90
  141. package/dest/messages/message_context_service.d.ts +17 -0
  142. package/dest/messages/message_context_service.d.ts.map +1 -0
  143. package/dest/messages/message_context_service.js +55 -0
  144. package/dest/notes/note_service.d.ts +29 -8
  145. package/dest/notes/note_service.d.ts.map +1 -1
  146. package/dest/notes/note_service.js +89 -65
  147. package/dest/notes_filter.d.ts +24 -0
  148. package/dest/notes_filter.d.ts.map +1 -0
  149. package/dest/notes_filter.js +4 -0
  150. package/dest/oracle_version.d.ts +4 -3
  151. package/dest/oracle_version.d.ts.map +1 -1
  152. package/dest/oracle_version.js +20 -10
  153. package/dest/private_kernel/batch_planner.d.ts +47 -0
  154. package/dest/private_kernel/batch_planner.d.ts.map +1 -0
  155. package/dest/private_kernel/batch_planner.js +104 -0
  156. package/dest/private_kernel/hints/compute_tx_expiration_timestamp.d.ts +4 -0
  157. package/dest/private_kernel/hints/compute_tx_expiration_timestamp.d.ts.map +1 -0
  158. package/dest/private_kernel/hints/{compute_tx_include_by_timestamp.js → compute_tx_expiration_timestamp.js} +12 -12
  159. package/dest/private_kernel/hints/index.d.ts +1 -1
  160. package/dest/private_kernel/hints/index.js +1 -1
  161. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts +4 -3
  162. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts.map +1 -1
  163. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.js +130 -69
  164. package/dest/private_kernel/hints/test_utils.d.ts +122 -0
  165. package/dest/private_kernel/hints/test_utils.d.ts.map +1 -0
  166. package/dest/private_kernel/hints/test_utils.js +202 -0
  167. package/dest/private_kernel/private_kernel_execution_prover.d.ts +7 -2
  168. package/dest/private_kernel/private_kernel_execution_prover.d.ts.map +1 -1
  169. package/dest/private_kernel/private_kernel_execution_prover.js +167 -66
  170. package/dest/private_kernel/private_kernel_oracle.d.ts +15 -11
  171. package/dest/private_kernel/private_kernel_oracle.d.ts.map +1 -1
  172. package/dest/private_kernel/private_kernel_oracle.js +31 -25
  173. package/dest/pxe.d.ts +120 -24
  174. package/dest/pxe.d.ts.map +1 -1
  175. package/dest/pxe.js +235 -136
  176. package/dest/storage/address_store/address_store.d.ts +1 -1
  177. package/dest/storage/address_store/address_store.d.ts.map +1 -1
  178. package/dest/storage/address_store/address_store.js +12 -11
  179. package/dest/storage/anchor_block_store/anchor_block_store.d.ts +9 -1
  180. package/dest/storage/anchor_block_store/anchor_block_store.d.ts.map +1 -1
  181. package/dest/storage/anchor_block_store/anchor_block_store.js +9 -2
  182. package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.d.ts +42 -0
  183. package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.d.ts.map +1 -0
  184. package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.js +93 -0
  185. package/dest/storage/backwards_compatibility_tests/schema_tests.d.ts +15 -0
  186. package/dest/storage/backwards_compatibility_tests/schema_tests.d.ts.map +1 -0
  187. package/dest/storage/backwards_compatibility_tests/schema_tests.js +591 -0
  188. package/dest/storage/backwards_compatibility_tests/store_spy.d.ts +19 -0
  189. package/dest/storage/backwards_compatibility_tests/store_spy.d.ts.map +1 -0
  190. package/dest/storage/backwards_compatibility_tests/store_spy.js +63 -0
  191. package/dest/storage/capsule_store/capsule_service.d.ts +21 -0
  192. package/dest/storage/capsule_store/capsule_service.d.ts.map +1 -0
  193. package/dest/storage/capsule_store/capsule_service.js +50 -0
  194. package/dest/storage/capsule_store/capsule_store.d.ts +9 -9
  195. package/dest/storage/capsule_store/capsule_store.d.ts.map +1 -1
  196. package/dest/storage/capsule_store/capsule_store.js +42 -36
  197. package/dest/storage/capsule_store/index.d.ts +2 -1
  198. package/dest/storage/capsule_store/index.d.ts.map +1 -1
  199. package/dest/storage/capsule_store/index.js +1 -0
  200. package/dest/storage/contract_store/contract_store.d.ts +42 -15
  201. package/dest/storage/contract_store/contract_store.d.ts.map +1 -1
  202. package/dest/storage/contract_store/contract_store.js +158 -90
  203. package/dest/storage/metadata.d.ts +1 -1
  204. package/dest/storage/metadata.js +1 -1
  205. package/dest/storage/note_store/note_store.d.ts +13 -3
  206. package/dest/storage/note_store/note_store.d.ts.map +1 -1
  207. package/dest/storage/note_store/note_store.js +147 -107
  208. package/dest/storage/open_pxe_stores.d.ts +33 -0
  209. package/dest/storage/open_pxe_stores.d.ts.map +1 -0
  210. package/dest/storage/open_pxe_stores.js +27 -0
  211. package/dest/storage/private_event_store/private_event_store.d.ts +1 -1
  212. package/dest/storage/private_event_store/private_event_store.d.ts.map +1 -1
  213. package/dest/storage/private_event_store/private_event_store.js +87 -61
  214. package/dest/storage/private_event_store/stored_private_event.d.ts +4 -4
  215. package/dest/storage/private_event_store/stored_private_event.d.ts.map +1 -1
  216. package/dest/storage/private_event_store/stored_private_event.js +2 -2
  217. package/dest/storage/tagging_store/recipient_tagging_store.d.ts +6 -6
  218. package/dest/storage/tagging_store/recipient_tagging_store.d.ts.map +1 -1
  219. package/dest/storage/tagging_store/recipient_tagging_store.js +31 -19
  220. package/dest/storage/tagging_store/sender_address_book_store.d.ts +1 -1
  221. package/dest/storage/tagging_store/sender_address_book_store.d.ts.map +1 -1
  222. package/dest/storage/tagging_store/sender_address_book_store.js +20 -14
  223. package/dest/storage/tagging_store/sender_tagging_store.d.ts +29 -28
  224. package/dest/storage/tagging_store/sender_tagging_store.d.ts.map +1 -1
  225. package/dest/storage/tagging_store/sender_tagging_store.js +233 -137
  226. package/dest/tagging/get_all_logs_by_tags.d.ts +35 -11
  227. package/dest/tagging/get_all_logs_by_tags.d.ts.map +1 -1
  228. package/dest/tagging/get_all_logs_by_tags.js +45 -32
  229. package/dest/tagging/index.d.ts +6 -5
  230. package/dest/tagging/index.d.ts.map +1 -1
  231. package/dest/tagging/index.js +4 -3
  232. package/dest/tagging/persist_sender_tagging_index_ranges.d.ts +29 -0
  233. package/dest/tagging/persist_sender_tagging_index_ranges.d.ts.map +1 -0
  234. package/dest/tagging/persist_sender_tagging_index_ranges.js +42 -0
  235. package/dest/tagging/recipient_sync/sync_tagged_private_logs.d.ts +56 -0
  236. package/dest/tagging/recipient_sync/sync_tagged_private_logs.d.ts.map +1 -0
  237. package/dest/tagging/recipient_sync/sync_tagged_private_logs.js +163 -0
  238. package/dest/tagging/recipient_sync/utils/find_highest_indexes.d.ts +3 -3
  239. package/dest/tagging/recipient_sync/utils/find_highest_indexes.d.ts.map +1 -1
  240. package/dest/tagging/recipient_sync/utils/find_highest_indexes.js +2 -2
  241. package/dest/tagging/reconcile_tagging_index_ranges.d.ts +36 -0
  242. package/dest/tagging/reconcile_tagging_index_ranges.d.ts.map +1 -0
  243. package/dest/tagging/reconcile_tagging_index_ranges.js +74 -0
  244. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts +5 -10
  245. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts.map +1 -1
  246. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.js +32 -14
  247. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts +13 -7
  248. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts.map +1 -1
  249. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.js +41 -10
  250. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts +6 -8
  251. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts.map +1 -1
  252. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.js +37 -25
  253. package/package.json +29 -17
  254. package/src/bin/check_oracle_version.ts +49 -122
  255. package/src/bin/index.ts +1 -0
  256. package/src/bin/oracle_version_helpers.ts +121 -0
  257. package/src/block_synchronizer/block_stream_source.ts +81 -0
  258. package/src/block_synchronizer/block_synchronizer.ts +54 -28
  259. package/src/config/index.ts +15 -9
  260. package/src/config/package_info.ts +1 -1
  261. package/src/contract_function_simulator/contract_function_simulator.ts +391 -136
  262. package/src/contract_function_simulator/ephemeral_array_service.ts +110 -0
  263. package/src/contract_function_simulator/execution_note_cache.ts +1 -1
  264. package/src/contract_function_simulator/execution_tagging_index_cache.ts +19 -18
  265. package/src/contract_function_simulator/index.ts +51 -1
  266. package/src/contract_function_simulator/noir-structs/bounded_vec.ts +55 -0
  267. package/src/contract_function_simulator/noir-structs/ephemeral_array.ts +66 -0
  268. package/src/contract_function_simulator/noir-structs/event_validation_request.ts +9 -8
  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_data.ts +27 -0
  272. package/src/contract_function_simulator/noir-structs/note_validation_request.ts +4 -9
  273. package/src/contract_function_simulator/noir-structs/option.ts +69 -0
  274. package/src/contract_function_simulator/noir-structs/provided_secret.ts +27 -0
  275. package/src/contract_function_simulator/oracle/interfaces.ts +12 -176
  276. package/src/contract_function_simulator/oracle/note_packing_utils.ts +3 -3
  277. package/src/contract_function_simulator/oracle/oracle.ts +564 -473
  278. package/src/contract_function_simulator/oracle/oracle_registry.ts +585 -0
  279. package/src/contract_function_simulator/oracle/oracle_type_mappings.ts +553 -0
  280. package/src/contract_function_simulator/oracle/private_execution.ts +4 -4
  281. package/src/contract_function_simulator/oracle/private_execution_oracle.ts +174 -210
  282. package/src/contract_function_simulator/oracle/utility_execution_oracle.ts +672 -253
  283. package/src/contract_function_simulator/pick_notes.ts +22 -3
  284. package/src/contract_function_simulator/proxied_contract_data_source.ts +41 -64
  285. package/src/contract_logging.ts +52 -0
  286. package/src/contract_sync/contract_sync_service.ts +189 -0
  287. package/src/contract_sync/{index.ts → helpers.ts} +17 -29
  288. package/src/debug/pxe_debug_utils.ts +55 -19
  289. package/src/entrypoints/client/bundle/index.ts +2 -0
  290. package/src/entrypoints/client/bundle/utils.ts +26 -20
  291. package/src/entrypoints/client/lazy/index.ts +2 -0
  292. package/src/entrypoints/client/lazy/utils.ts +28 -21
  293. package/src/entrypoints/pxe_creation_options.ts +16 -1
  294. package/src/entrypoints/server/index.ts +4 -2
  295. package/src/entrypoints/server/utils.ts +37 -32
  296. package/src/events/event_service.ts +70 -24
  297. package/src/events/private_event_filter_validator.ts +21 -1
  298. package/src/hooks/authorize_utility_call.ts +44 -0
  299. package/src/hooks/execution_hooks.ts +48 -0
  300. package/src/hooks/index.ts +7 -0
  301. package/src/job_coordinator/job_coordinator.ts +4 -3
  302. package/src/logs/log_service.ts +170 -153
  303. package/src/messages/message_context_service.ts +62 -0
  304. package/src/notes/note_service.ts +124 -91
  305. package/src/notes_filter.ts +24 -0
  306. package/src/oracle_version.ts +20 -10
  307. package/src/private_kernel/batch_planner.ts +169 -0
  308. package/src/private_kernel/hints/{compute_tx_include_by_timestamp.ts → compute_tx_expiration_timestamp.ts} +13 -13
  309. package/src/private_kernel/hints/index.ts +1 -1
  310. package/src/private_kernel/hints/private_kernel_reset_private_inputs_builder.ts +165 -118
  311. package/src/private_kernel/hints/test_utils.ts +318 -0
  312. package/src/private_kernel/private_kernel_execution_prover.ts +260 -92
  313. package/src/private_kernel/private_kernel_oracle.ts +42 -32
  314. package/src/pxe.ts +429 -186
  315. package/src/storage/address_store/address_store.ts +15 -15
  316. package/src/storage/anchor_block_store/anchor_block_store.ts +9 -1
  317. package/src/storage/backwards_compatibility_tests/__snapshots__/AddressStore.json +22 -0
  318. package/src/storage/backwards_compatibility_tests/__snapshots__/AnchorBlockStore.json +3 -0
  319. package/src/storage/backwards_compatibility_tests/__snapshots__/CapsuleStore.json +16 -0
  320. package/src/storage/backwards_compatibility_tests/__snapshots__/ContractStore.json +28 -0
  321. package/src/storage/backwards_compatibility_tests/__snapshots__/KeyStore.json +52 -0
  322. package/src/storage/backwards_compatibility_tests/__snapshots__/L2TipsKVStore.json +46 -0
  323. package/src/storage/backwards_compatibility_tests/__snapshots__/NoteStore.json +36 -0
  324. package/src/storage/backwards_compatibility_tests/__snapshots__/PrivateEventStore.json +44 -0
  325. package/src/storage/backwards_compatibility_tests/__snapshots__/RecipientTaggingStore.json +18 -0
  326. package/src/storage/backwards_compatibility_tests/__snapshots__/SenderAddressBookStore.json +16 -0
  327. package/src/storage/backwards_compatibility_tests/__snapshots__/SenderTaggingStore.json +22 -0
  328. package/src/storage/backwards_compatibility_tests/__snapshots__/opened_stores.json +97 -0
  329. package/src/storage/backwards_compatibility_tests/kv_store_snapshot.ts +122 -0
  330. package/src/storage/backwards_compatibility_tests/schema_tests.ts +712 -0
  331. package/src/storage/backwards_compatibility_tests/store_spy.ts +73 -0
  332. package/src/storage/capsule_store/capsule_service.ts +90 -0
  333. package/src/storage/capsule_store/capsule_store.ts +52 -34
  334. package/src/storage/capsule_store/index.ts +1 -0
  335. package/src/storage/contract_store/contract_store.ts +194 -105
  336. package/src/storage/metadata.ts +1 -1
  337. package/src/storage/note_store/note_store.ts +166 -132
  338. package/src/storage/open_pxe_stores.ts +49 -0
  339. package/src/storage/private_event_store/private_event_store.ts +106 -81
  340. package/src/storage/private_event_store/stored_private_event.ts +3 -3
  341. package/src/storage/tagging_store/recipient_tagging_store.ts +34 -24
  342. package/src/storage/tagging_store/sender_address_book_store.ts +20 -14
  343. package/src/storage/tagging_store/sender_tagging_store.ts +287 -156
  344. package/src/tagging/get_all_logs_by_tags.ts +90 -38
  345. package/src/tagging/index.ts +5 -4
  346. package/src/tagging/persist_sender_tagging_index_ranges.ts +57 -0
  347. package/src/tagging/recipient_sync/sync_tagged_private_logs.ts +240 -0
  348. package/src/tagging/recipient_sync/utils/find_highest_indexes.ts +4 -4
  349. package/src/tagging/reconcile_tagging_index_ranges.ts +102 -0
  350. package/src/tagging/sender_sync/sync_sender_tagging_indexes.ts +54 -19
  351. package/src/tagging/sender_sync/utils/get_status_change_of_pending.ts +44 -14
  352. package/src/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.ts +30 -30
  353. package/dest/contract_sync/index.d.ts +0 -23
  354. package/dest/contract_sync/index.d.ts.map +0 -1
  355. package/dest/private_kernel/hints/compute_tx_include_by_timestamp.d.ts +0 -4
  356. package/dest/private_kernel/hints/compute_tx_include_by_timestamp.d.ts.map +0 -1
  357. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts +0 -15
  358. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts.map +0 -1
  359. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.js +0 -99
  360. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts +0 -15
  361. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts.map +0 -1
  362. package/dest/tagging/recipient_sync/utils/load_logs_for_range.js +0 -32
  363. package/src/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.ts +0 -143
  364. package/src/tagging/recipient_sync/utils/load_logs_for_range.ts +0 -49
@@ -1,6 +1,8 @@
1
+ import { MAX_APPS_PER_KERNEL } from '@aztec/constants';
2
+ import { uniqueBy } from '@aztec/foundation/collection';
1
3
  import { vkAsFieldsMegaHonk } from '@aztec/foundation/crypto/keys';
2
4
  import { Fr } from '@aztec/foundation/curves/bn254';
3
- import { createLogger } from '@aztec/foundation/log';
5
+ import { type Logger, type LoggerBindings, createLogger } from '@aztec/foundation/log';
4
6
  import { pushTestData } from '@aztec/foundation/testing';
5
7
  import { Timer } from '@aztec/foundation/timer';
6
8
  import { getVKTreeRoot } from '@aztec/noir-protocol-circuits-types/vk-tree';
@@ -16,23 +18,31 @@ import {
16
18
  PrivateKernelCircuitPublicInputs,
17
19
  PrivateKernelData,
18
20
  type PrivateKernelExecutionProofOutput,
21
+ PrivateKernelInit2CircuitPrivateInputs,
22
+ PrivateKernelInit3CircuitPrivateInputs,
19
23
  PrivateKernelInitCircuitPrivateInputs,
24
+ PrivateKernelInner2CircuitPrivateInputs,
25
+ PrivateKernelInner3CircuitPrivateInputs,
20
26
  PrivateKernelInnerCircuitPrivateInputs,
21
27
  type PrivateKernelSimulateOutput,
22
28
  PrivateKernelTailCircuitPrivateInputs,
23
29
  type PrivateKernelTailCircuitPublicInputs,
24
30
  PrivateVerificationKeyHints,
31
+ type UpdatedClassIdHints,
25
32
  } from '@aztec/stdlib/kernel';
26
33
  import { ChonkProof, ChonkProofWithPublicInputs } from '@aztec/stdlib/proofs';
27
34
  import {
28
35
  type PrivateCallExecutionResult,
29
36
  type PrivateExecutionResult,
30
37
  TxRequest,
38
+ collectNested,
31
39
  collectNoteHashNullifierCounterMap,
32
40
  getFinalMinRevertibleSideEffectCounter,
33
41
  } from '@aztec/stdlib/tx';
34
42
  import { VerificationKeyAsFields, VerificationKeyData, VkData } from '@aztec/stdlib/vks';
35
43
 
44
+ import { BatchPlanner } from './batch_planner.js';
45
+ import { computeTxExpirationTimestamp } from './hints/compute_tx_expiration_timestamp.js';
36
46
  import { PrivateKernelResetPrivateInputsBuilder } from './hints/private_kernel_reset_private_inputs_builder.js';
37
47
  import type { PrivateKernelOracle } from './private_kernel_oracle.js';
38
48
 
@@ -56,13 +66,17 @@ export interface PrivateKernelExecutionProverConfig {
56
66
  * inform state tree updates.
57
67
  */
58
68
  export class PrivateKernelExecutionProver {
59
- private log = createLogger('pxe:private-kernel-execution-prover');
69
+ private log: Logger;
60
70
 
61
71
  constructor(
62
72
  private oracle: PrivateKernelOracle,
63
73
  private proofCreator: PrivateKernelProver,
64
74
  private fakeProofs = false,
65
- ) {}
75
+ bindings?: LoggerBindings,
76
+ private maxBatchSize: number = MAX_APPS_PER_KERNEL,
77
+ ) {
78
+ this.log = createLogger('pxe:private-kernel-execution-prover', bindings);
79
+ }
66
80
 
67
81
  /**
68
82
  * Generate a proof for a given transaction request and execution result.
@@ -104,6 +118,13 @@ export class PrivateKernelExecutionProver {
104
118
  const minRevertibleSideEffectCounter = getFinalMinRevertibleSideEffectCounter(executionResult);
105
119
  const splitCounter = isPrivateOnlyTx ? 0 : minRevertibleSideEffectCounter;
106
120
 
121
+ // Each kernel iteration absorbs up to `maxBatchSize` apps. The planner walks the upcoming
122
+ // apps and decides where the next reset must fall by using an accumulator and
123
+ // reusing the existing single-app `needsReset()` check.
124
+ const planner = new BatchPlanner(noteHashNullifierCounterMap, splitCounter, this.maxBatchSize);
125
+
126
+ const updatedClassIdHintsMap = await this.prefetchUpdatedClassIdHints(executionResult);
127
+
107
128
  while (executionStack.length) {
108
129
  if (!firstIteration) {
109
130
  let resetBuilder = new PrivateKernelResetPrivateInputsBuilder(
@@ -113,6 +134,7 @@ export class PrivateKernelExecutionProver {
113
134
  splitCounter,
114
135
  );
115
136
  while (resetBuilder.needsReset()) {
137
+ // Inner reset: without siloing.
116
138
  const witgenTimer = new Timer();
117
139
  const privateInputs = await resetBuilder.build(this.oracle);
118
140
  output = generateWitnesses
@@ -136,93 +158,45 @@ export class PrivateKernelExecutionProver {
136
158
  }
137
159
  }
138
160
 
139
- const currentExecution = executionStack.pop()!;
140
-
141
- executionStack.push(...[...currentExecution.nestedExecutionResults].reverse());
142
-
143
- const functionName = await this.oracle.getDebugFunctionName(
144
- currentExecution.publicInputs.callContext.contractAddress,
145
- currentExecution.publicInputs.callContext.functionSelector,
146
- );
161
+ const batchSize = planner.decideBatchSize(output.publicInputs, executionStack);
162
+ const apps: PrivateCallData[] = [];
163
+ for (let i = 0; i < batchSize; i++) {
164
+ apps.push(await this.consumeNextApp(executionStack, executionSteps, updatedClassIdHintsMap));
165
+ }
147
166
 
148
- executionSteps.push({
149
- functionName: functionName!,
150
- bytecode: currentExecution.acir,
151
- witness: currentExecution.partialWitness,
152
- vk: currentExecution.vk,
153
- timings: {
154
- witgen: currentExecution.profileResult?.timings.witgen ?? 0,
155
- oracles: currentExecution.profileResult?.timings.oracles,
156
- },
167
+ output = await this.runBatchedKernel({
168
+ apps,
169
+ firstIteration,
170
+ previousOutput: output,
171
+ txRequest,
172
+ isPrivateOnlyTx,
173
+ firstNullifierHint: executionResult.firstNullifier,
174
+ minRevertibleSideEffectCounter,
175
+ executionSteps,
176
+ generateWitnesses,
157
177
  });
158
178
 
159
- const privateCallData = await this.createPrivateCallData(currentExecution);
160
-
161
- if (firstIteration) {
162
- const witgenTimer = new Timer();
163
-
164
- const proofInput = new PrivateKernelInitCircuitPrivateInputs(
165
- txRequest,
166
- getVKTreeRoot(),
167
- ProtocolContractsList,
168
- privateCallData,
169
- isPrivateOnlyTx,
170
- executionResult.firstNullifier,
171
- minRevertibleSideEffectCounter,
172
- );
173
- this.log.debug(
174
- `Calling private kernel init with isPrivateOnly ${isPrivateOnlyTx} and firstNullifierHint ${proofInput.firstNullifierHint}`,
175
- );
176
-
177
- pushTestData('private-kernel-inputs-init', proofInput);
178
-
179
- output = generateWitnesses
180
- ? await this.proofCreator.generateInitOutput(proofInput)
181
- : await this.proofCreator.simulateInit(proofInput);
182
-
183
- executionSteps.push({
184
- functionName: 'private_kernel_init',
185
- bytecode: output.bytecode,
186
- witness: output.outputWitness,
187
- vk: output.verificationKey.keyAsBytes,
188
- timings: {
189
- witgen: witgenTimer.ms(),
190
- },
191
- });
192
- } else {
193
- const witgenTimer = new Timer();
194
- const vkData = await this.getVkData(output.verificationKey);
195
- const previousKernelData = new PrivateKernelData(output.publicInputs, vkData);
196
- const proofInput = new PrivateKernelInnerCircuitPrivateInputs(previousKernelData, privateCallData);
197
-
198
- pushTestData('private-kernel-inputs-inner', proofInput);
199
- output = generateWitnesses
200
- ? await this.proofCreator.generateInnerOutput(proofInput)
201
- : await this.proofCreator.simulateInner(proofInput);
202
-
203
- executionSteps.push({
204
- functionName: 'private_kernel_inner',
205
- bytecode: output.bytecode,
206
- witness: output.outputWitness,
207
- vk: output.verificationKey.keyAsBytes,
208
- timings: {
209
- witgen: witgenTimer.ms(),
210
- },
211
- });
212
- }
213
179
  firstIteration = false;
214
180
  }
215
181
 
216
- // Reset.
217
- let resetBuilder = new PrivateKernelResetPrivateInputsBuilder(
182
+ // Final reset: include siloing of note hashes, nullifiers and private logs.
183
+ const finalResetBuilder = new PrivateKernelResetPrivateInputsBuilder(
218
184
  output,
219
185
  [],
220
186
  noteHashNullifierCounterMap,
221
187
  splitCounter,
222
188
  );
223
- while (resetBuilder.needsReset()) {
189
+ if (!finalResetBuilder.needsReset()) {
190
+ // The final reset must be performed exactly once, because each tx has at least one nullifier that requires
191
+ // siloing, and siloing cannot be done multiple times.
192
+ // While, in theory, it might be possible to silo note hashes first and then run another reset to silo nullifiers
193
+ // and/or private logs, we currently don't have standalone dimensions for the arrays that require siloing. As a
194
+ // result, all necessary siloing must be done together in a single reset.
195
+ // Refer to the possible combinations of dimensions in private_kernel_reset_config.json.
196
+ throw new Error('Nothing to reset for the final reset.');
197
+ } else {
224
198
  const witgenTimer = new Timer();
225
- const privateInputs = await resetBuilder.build(this.oracle);
199
+ const privateInputs = await finalResetBuilder.build(this.oracle);
226
200
  output = generateWitnesses
227
201
  ? await this.proofCreator.generateResetOutput(privateInputs)
228
202
  : await this.proofCreator.simulateReset(privateInputs);
@@ -236,8 +210,6 @@ export class PrivateKernelExecutionProver {
236
210
  witgen: witgenTimer.ms(),
237
211
  },
238
212
  });
239
-
240
- resetBuilder = new PrivateKernelResetPrivateInputsBuilder(output, [], noteHashNullifierCounterMap, splitCounter);
241
213
  }
242
214
 
243
215
  if (output.publicInputs.feePayer.isZero() && skipFeeEnforcement) {
@@ -257,20 +229,14 @@ export class PrivateKernelExecutionProver {
257
229
  // TODO: Enable padding once we better understand the final amounts to pad to.
258
230
  const paddedSideEffectAmounts = PaddedSideEffectAmounts.empty();
259
231
 
260
- // Use the aggregated includeByTimestamp set throughout the tx execution.
261
- // TODO: Call `computeTxIncludeByTimestamp` to round the value down and reduce precision, improving privacy.
262
- const includeByTimestampUpperBound = previousKernelData.publicInputs.includeByTimestamp;
263
- const anchorBlockTimestamp = previousKernelData.publicInputs.constants.anchorBlockHeader.globalVariables.timestamp;
264
- if (includeByTimestampUpperBound <= anchorBlockTimestamp) {
265
- throw new Error(
266
- `Include-by timestamp must be greater than the anchor block timestamp. Anchor block timestamp: ${anchorBlockTimestamp}. Include-by timestamp: ${includeByTimestampUpperBound}.`,
267
- );
268
- }
232
+ // Round the aggregated expirationTimestamp down to reduce precision and avoid leaking which private
233
+ // functions were called via their exact expiration offsets.
234
+ const expirationTimestampUpperBound = computeTxExpirationTimestamp(previousKernelData.publicInputs);
269
235
 
270
236
  const privateInputs = new PrivateKernelTailCircuitPrivateInputs(
271
237
  previousKernelData,
272
238
  paddedSideEffectAmounts,
273
- includeByTimestampUpperBound,
239
+ expirationTimestampUpperBound,
274
240
  );
275
241
 
276
242
  const witgenTimer = new Timer();
@@ -396,7 +362,60 @@ export class PrivateKernelExecutionProver {
396
362
  );
397
363
  }
398
364
 
399
- private async createPrivateCallData({ publicInputs, vk: vkAsBuffer }: PrivateCallExecutionResult) {
365
+ /**
366
+ * Pops the next app off the execution stack, pushes its nested calls back on (preserving DFS
367
+ * order), records the app's execution step, and returns its constructed `PrivateCallData`.
368
+ * Caller is responsible for ensuring the stack is non-empty.
369
+ */
370
+ private async consumeNextApp(
371
+ executionStack: PrivateCallExecutionResult[],
372
+ executionSteps: PrivateExecutionStep[],
373
+ updatedClassIdHintsMap: Map<string, UpdatedClassIdHints>,
374
+ ): Promise<PrivateCallData> {
375
+ const next = executionStack.pop()!;
376
+ executionStack.push(...[...next.nestedExecutionResults].reverse());
377
+
378
+ const functionName = await this.oracle.getDebugFunctionName(
379
+ next.publicInputs.callContext.contractAddress,
380
+ next.publicInputs.callContext.functionSelector,
381
+ );
382
+
383
+ executionSteps.push({
384
+ functionName: functionName!,
385
+ bytecode: next.acir,
386
+ witness: next.partialWitness,
387
+ vk: next.vk,
388
+ timings: {
389
+ witgen: next.profileResult?.timings.witgen ?? 0,
390
+ oracles: next.profileResult?.timings.oracles,
391
+ },
392
+ });
393
+
394
+ return await this.createPrivateCallData(next, updatedClassIdHintsMap);
395
+ }
396
+
397
+ /** Prefetches updated class id hints for all unique contracts in the execution tree in parallel. */
398
+ private async prefetchUpdatedClassIdHints(
399
+ executionResult: PrivateExecutionResult,
400
+ ): Promise<Map<string, UpdatedClassIdHints>> {
401
+ const allAddresses = collectNested([executionResult.entrypoint], exec => [
402
+ exec.publicInputs.callContext.contractAddress,
403
+ ]);
404
+ const uniqueAddresses = uniqueBy(allAddresses, a => a.toString());
405
+ return new Map<string, UpdatedClassIdHints>(
406
+ await Promise.all(
407
+ uniqueAddresses.map(
408
+ async addr =>
409
+ [addr.toString(), await this.oracle.getUpdatedClassIdHints(addr)] as [string, UpdatedClassIdHints],
410
+ ),
411
+ ),
412
+ );
413
+ }
414
+
415
+ private async createPrivateCallData(
416
+ { publicInputs, vk: vkAsBuffer }: PrivateCallExecutionResult,
417
+ updatedClassIdHintsMap: Map<string, UpdatedClassIdHints>,
418
+ ) {
400
419
  const { contractAddress, functionSelector } = publicInputs.callContext;
401
420
 
402
421
  const vkAsFields = await vkAsFieldsMegaHonk(vkAsBuffer);
@@ -412,7 +431,7 @@ export class PrivateKernelExecutionProver {
412
431
  const { artifactHash: contractClassArtifactHash, publicBytecodeCommitment: contractClassPublicBytecodeCommitment } =
413
432
  await this.oracle.getContractClassIdPreimage(currentContractClassId);
414
433
 
415
- const updatedClassIdHints = await this.oracle.getUpdatedClassIdHints(contractAddress);
434
+ const updatedClassIdHints = updatedClassIdHintsMap.get(contractAddress.toString())!;
416
435
 
417
436
  return PrivateCallData.from({
418
437
  publicInputs,
@@ -427,4 +446,153 @@ export class PrivateKernelExecutionProver {
427
446
  }),
428
447
  });
429
448
  }
449
+
450
+ /**
451
+ * Runs one batched kernel iteration. Picks the right circuit variant based on whether this is
452
+ * the first iteration or a later one and the size of the batch.
453
+ */
454
+ private async runBatchedKernel(args: {
455
+ apps: PrivateCallData[];
456
+ firstIteration: boolean;
457
+ previousOutput: PrivateKernelSimulateOutput<PrivateKernelCircuitPublicInputs>;
458
+ txRequest: TxRequest;
459
+ isPrivateOnlyTx: boolean;
460
+ firstNullifierHint: Fr;
461
+ minRevertibleSideEffectCounter: number;
462
+ executionSteps: PrivateExecutionStep[];
463
+ generateWitnesses: boolean;
464
+ }): Promise<PrivateKernelSimulateOutput<PrivateKernelCircuitPublicInputs>> {
465
+ const {
466
+ apps,
467
+ firstIteration,
468
+ previousOutput,
469
+ txRequest,
470
+ isPrivateOnlyTx,
471
+ firstNullifierHint,
472
+ minRevertibleSideEffectCounter,
473
+ executionSteps,
474
+ generateWitnesses,
475
+ } = args;
476
+
477
+ const witgenTimer = new Timer();
478
+ let output: PrivateKernelSimulateOutput<PrivateKernelCircuitPublicInputs>;
479
+ let functionName: string;
480
+
481
+ if (firstIteration) {
482
+ const vkTreeRoot = getVKTreeRoot();
483
+ switch (apps.length) {
484
+ case 1: {
485
+ const proofInput = new PrivateKernelInitCircuitPrivateInputs(
486
+ txRequest,
487
+ vkTreeRoot,
488
+ ProtocolContractsList,
489
+ apps[0],
490
+ isPrivateOnlyTx,
491
+ firstNullifierHint,
492
+ minRevertibleSideEffectCounter,
493
+ );
494
+ this.log.debug(
495
+ `Calling private kernel init with isPrivateOnly ${isPrivateOnlyTx} and firstNullifierHint ${proofInput.firstNullifierHint}`,
496
+ );
497
+ pushTestData('private-kernel-inputs-init', proofInput);
498
+ output = generateWitnesses
499
+ ? await this.proofCreator.generateInitOutput(proofInput)
500
+ : await this.proofCreator.simulateInit(proofInput);
501
+ functionName = 'private_kernel_init';
502
+ break;
503
+ }
504
+ case 2: {
505
+ const proofInput = new PrivateKernelInit2CircuitPrivateInputs(
506
+ txRequest,
507
+ vkTreeRoot,
508
+ ProtocolContractsList,
509
+ apps[0],
510
+ apps[1],
511
+ isPrivateOnlyTx,
512
+ firstNullifierHint,
513
+ minRevertibleSideEffectCounter,
514
+ );
515
+ this.log.debug(
516
+ `Calling private kernel init_2 with isPrivateOnly ${isPrivateOnlyTx} and firstNullifierHint ${proofInput.firstNullifierHint}`,
517
+ );
518
+ pushTestData('private-kernel-inputs-init-2', proofInput);
519
+ output = generateWitnesses
520
+ ? await this.proofCreator.generateInit2Output(proofInput)
521
+ : await this.proofCreator.simulateInit2(proofInput);
522
+ functionName = 'private_kernel_init_2';
523
+ break;
524
+ }
525
+ case 3: {
526
+ const proofInput = new PrivateKernelInit3CircuitPrivateInputs(
527
+ txRequest,
528
+ vkTreeRoot,
529
+ ProtocolContractsList,
530
+ apps[0],
531
+ apps[1],
532
+ apps[2],
533
+ isPrivateOnlyTx,
534
+ firstNullifierHint,
535
+ minRevertibleSideEffectCounter,
536
+ );
537
+ this.log.debug(
538
+ `Calling private kernel init_3 with isPrivateOnly ${isPrivateOnlyTx} and firstNullifierHint ${proofInput.firstNullifierHint}`,
539
+ );
540
+ pushTestData('private-kernel-inputs-init-3', proofInput);
541
+ output = generateWitnesses
542
+ ? await this.proofCreator.generateInit3Output(proofInput)
543
+ : await this.proofCreator.simulateInit3(proofInput);
544
+ functionName = 'private_kernel_init_3';
545
+ break;
546
+ }
547
+ default:
548
+ throw new Error(`Unsupported init kernel batch size: ${apps.length}`);
549
+ }
550
+ } else {
551
+ const vkData = await this.getVkData(previousOutput.verificationKey);
552
+ const previousKernelData = new PrivateKernelData(previousOutput.publicInputs, vkData);
553
+ switch (apps.length) {
554
+ case 1: {
555
+ const proofInput = new PrivateKernelInnerCircuitPrivateInputs(previousKernelData, apps[0]);
556
+ pushTestData('private-kernel-inputs-inner', proofInput);
557
+ output = generateWitnesses
558
+ ? await this.proofCreator.generateInnerOutput(proofInput)
559
+ : await this.proofCreator.simulateInner(proofInput);
560
+ functionName = 'private_kernel_inner';
561
+ break;
562
+ }
563
+ case 2: {
564
+ const proofInput = new PrivateKernelInner2CircuitPrivateInputs(previousKernelData, apps[0], apps[1]);
565
+ pushTestData('private-kernel-inputs-inner-2', proofInput);
566
+ output = generateWitnesses
567
+ ? await this.proofCreator.generateInner2Output(proofInput)
568
+ : await this.proofCreator.simulateInner2(proofInput);
569
+ functionName = 'private_kernel_inner_2';
570
+ break;
571
+ }
572
+ case 3: {
573
+ const proofInput = new PrivateKernelInner3CircuitPrivateInputs(previousKernelData, apps[0], apps[1], apps[2]);
574
+ pushTestData('private-kernel-inputs-inner-3', proofInput);
575
+ output = generateWitnesses
576
+ ? await this.proofCreator.generateInner3Output(proofInput)
577
+ : await this.proofCreator.simulateInner3(proofInput);
578
+ functionName = 'private_kernel_inner_3';
579
+ break;
580
+ }
581
+ default:
582
+ throw new Error(`Unsupported inner kernel batch size: ${apps.length}`);
583
+ }
584
+ }
585
+
586
+ executionSteps.push({
587
+ functionName,
588
+ bytecode: output.bytecode,
589
+ witness: output.outputWitness,
590
+ vk: output.verificationKey.keyAsBytes,
591
+ timings: {
592
+ witgen: witgenTimer.ms(),
593
+ },
594
+ });
595
+
596
+ return output;
597
+ }
430
598
  }
@@ -1,23 +1,25 @@
1
- import { FUNCTION_TREE_HEIGHT, NOTE_HASH_TREE_HEIGHT, PUBLIC_DATA_TREE_HEIGHT, VK_TREE_HEIGHT } from '@aztec/constants';
1
+ import {
2
+ FUNCTION_TREE_HEIGHT,
3
+ NOTE_HASH_TREE_HEIGHT,
4
+ PUBLIC_DATA_TREE_HEIGHT,
5
+ UPDATES_VALUE_SIZE,
6
+ VK_TREE_HEIGHT,
7
+ } from '@aztec/constants';
2
8
  import type { Fr } from '@aztec/foundation/curves/bn254';
3
- import type { GrumpkinScalar, Point } from '@aztec/foundation/curves/grumpkin';
9
+ import type { GrumpkinScalar } from '@aztec/foundation/curves/grumpkin';
4
10
  import { MembershipWitness } from '@aztec/foundation/trees';
5
11
  import type { KeyStore } from '@aztec/key-store';
6
12
  import { getVKIndex, getVKSiblingPath } from '@aztec/noir-protocol-circuits-types/vk-tree';
7
13
  import { ProtocolContractAddress } from '@aztec/protocol-contracts';
8
14
  import type { FunctionSelector } from '@aztec/stdlib/abi';
9
15
  import type { AztecAddress } from '@aztec/stdlib/aztec-address';
10
- import { L2BlockHash } from '@aztec/stdlib/block';
11
- import {
12
- type ContractInstanceWithAddress,
13
- computeContractClassIdPreimage,
14
- computeSaltedInitializationHash,
15
- } from '@aztec/stdlib/contract';
16
+ import { type ContractInstanceWithAddress, computeSaltedInitializationHash } from '@aztec/stdlib/contract';
16
17
  import { DelayedPublicMutableValues, DelayedPublicMutableValuesWithHash } from '@aztec/stdlib/delayed-public-mutable';
17
18
  import { computePublicDataTreeLeafSlot } from '@aztec/stdlib/hash';
18
19
  import type { AztecNode } from '@aztec/stdlib/interfaces/client';
19
20
  import { UpdatedClassIdHints } from '@aztec/stdlib/kernel';
20
21
  import type { NullifierMembershipWitness } from '@aztec/stdlib/trees';
22
+ import type { BlockHeader } from '@aztec/stdlib/tx';
21
23
  import type { VerificationKeyAsFields } from '@aztec/stdlib/vks';
22
24
 
23
25
  import type { ContractStore } from '../storage/contract_store/contract_store.js';
@@ -30,7 +32,7 @@ export class PrivateKernelOracle {
30
32
  private contractStore: ContractStore,
31
33
  private keyStore: KeyStore,
32
34
  private node: AztecNode,
33
- private blockHash: L2BlockHash,
35
+ private blockHeader: BlockHeader,
34
36
  ) {}
35
37
 
36
38
  /** Retrieves the preimage of a contract address from the registered contract instances db. */
@@ -49,11 +51,15 @@ export class PrivateKernelOracle {
49
51
 
50
52
  /** Retrieves the preimage of a contract class id from the contract classes db. */
51
53
  public async getContractClassIdPreimage(contractClassId: Fr) {
52
- const contractClass = await this.contractStore.getContractClass(contractClassId);
54
+ const contractClass = await this.contractStore.getContractClassWithPreimage(contractClassId);
53
55
  if (!contractClass) {
54
56
  throw new Error(`Contract class not found when getting class id preimage. Class id: ${contractClassId}.`);
55
57
  }
56
- return computeContractClassIdPreimage(contractClass);
58
+ return {
59
+ artifactHash: contractClass.artifactHash,
60
+ privateFunctionsRoot: contractClass.privateFunctionsRoot,
61
+ publicBytecodeCommitment: contractClass.publicBytecodeCommitment,
62
+ };
57
63
  }
58
64
 
59
65
  /** Returns a membership witness with the sibling path and leaf index in our private functions tree. */
@@ -80,33 +86,31 @@ export class PrivateKernelOracle {
80
86
  }
81
87
 
82
88
  /** Returns a membership witness with the sibling path and leaf index in our note hash tree. */
83
- getNoteHashMembershipWitness(noteHash: Fr): Promise<MembershipWitness<typeof NOTE_HASH_TREE_HEIGHT> | undefined> {
84
- return this.node.getNoteHashMembershipWitness(this.blockHash, noteHash);
89
+ async getNoteHashMembershipWitness(
90
+ noteHash: Fr,
91
+ ): Promise<MembershipWitness<typeof NOTE_HASH_TREE_HEIGHT> | undefined> {
92
+ return this.node.getNoteHashMembershipWitness(await this.blockHeader.hash(), noteHash);
85
93
  }
86
94
 
87
95
  /** Returns a membership witness with the sibling path and leaf index in our nullifier indexed merkle tree. */
88
- getNullifierMembershipWitness(nullifier: Fr): Promise<NullifierMembershipWitness | undefined> {
89
- return this.node.getNullifierMembershipWitness(this.blockHash, nullifier);
96
+ async getNullifierMembershipWitness(nullifier: Fr): Promise<NullifierMembershipWitness | undefined> {
97
+ return this.node.getNullifierMembershipWitness(await this.blockHeader.hash(), nullifier);
90
98
  }
91
99
 
92
100
  /** Returns the root of our note hash merkle tree. */
93
- async getNoteHashTreeRoot(): Promise<Fr> {
94
- const header = await this.node.getBlockHeader(this.blockHash);
95
- if (!header) {
96
- throw new Error(`No block header found for block hash ${this.blockHash}`);
97
- }
98
- return header.state.partial.noteHashTree.root;
101
+ getNoteHashTreeRoot(): Fr {
102
+ return this.blockHeader.state.partial.noteHashTree.root;
99
103
  }
100
104
 
101
105
  /**
102
- * Retrieves the sk_m corresponding to the pk_m.
103
- * @throws If the provided public key is not associated with any of the registered accounts.
104
- * @param masterPublicKey - The master public key to get secret key for.
106
+ * Retrieves the sk_m corresponding to the pk_m hash.
107
+ * @throws If the provided hash is not associated with any of the registered accounts.
108
+ * @param masterPublicKeyHash - The master public key hash to get secret key for.
105
109
  * @returns A Promise that resolves to sk_m.
106
110
  * @dev Used when feeding the sk_m to the kernel circuit for keys verification.
107
111
  */
108
- public getMasterSecretKey(masterPublicKey: Point): Promise<GrumpkinScalar> {
109
- return this.keyStore.getMasterSecretKey(masterPublicKey);
112
+ public getMasterSecretKey(masterPublicKeyHash: Fr): Promise<GrumpkinScalar> {
113
+ return this.keyStore.getMasterSecretKey(masterPublicKeyHash);
110
114
  }
111
115
 
112
116
  /** Use debug data to get the function name corresponding to a selector. */
@@ -126,18 +130,24 @@ export class PrivateKernelOracle {
126
130
  ProtocolContractAddress.ContractInstanceRegistry,
127
131
  delayedPublicMutableHashSlot,
128
132
  );
129
- const updatedClassIdWitness = await this.node.getPublicDataWitness(this.blockHash, hashLeafSlot);
133
+ const blockHash = await this.blockHeader.hash();
134
+
135
+ const updatedClassIdWitness = await this.node.getPublicDataWitness(blockHash, hashLeafSlot);
130
136
 
131
137
  if (!updatedClassIdWitness) {
132
138
  throw new Error(`No public data tree witness found for ${hashLeafSlot}`);
133
139
  }
134
140
 
141
+ // In an indexed merkle tree, getPublicDataWitness returns a leaf whose slot matches our query
142
+ // only if the slot has been written to. Otherwise, it returns the "low leaf" predecessor, whose
143
+ // slot will differ. Most contracts are never updated, so we can skip the readFromTree call
144
+ // (which triggers multiple RPC calls) and return empty values directly.
135
145
  const readStorage = (storageSlot: Fr) =>
136
- this.node.getPublicStorageAt(this.blockHash, ProtocolContractAddress.ContractInstanceRegistry, storageSlot);
137
- const delayedPublicMutableValues = await DelayedPublicMutableValues.readFromTree(
138
- delayedPublicMutableSlot,
139
- readStorage,
140
- );
146
+ this.node.getPublicStorageAt(blockHash, ProtocolContractAddress.ContractInstanceRegistry, storageSlot);
147
+ const slotExists = updatedClassIdWitness.leafPreimage.leaf.slot.equals(hashLeafSlot);
148
+ const delayedPublicMutableValues = slotExists
149
+ ? await DelayedPublicMutableValues.readFromTree(delayedPublicMutableSlot, readStorage)
150
+ : DelayedPublicMutableValues.empty(UPDATES_VALUE_SIZE);
141
151
 
142
152
  return new UpdatedClassIdHints(
143
153
  new MembershipWitness(