@aztec/pxe 0.0.0-test.1 → 0.0.1-commit.017a351

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 (573) hide show
  1. package/README.md +5 -5
  2. package/dest/bin/check_oracle_version.d.ts +2 -0
  3. package/dest/bin/check_oracle_version.d.ts.map +1 -0
  4. package/dest/bin/check_oracle_version.js +73 -0
  5. package/dest/bin/index.d.ts +2 -3
  6. package/dest/bin/index.d.ts.map +1 -1
  7. package/dest/bin/index.js +1 -28
  8. package/dest/bin/oracle_version_helpers.d.ts +26 -0
  9. package/dest/bin/oracle_version_helpers.d.ts.map +1 -0
  10. package/dest/bin/oracle_version_helpers.js +93 -0
  11. package/dest/block_synchronizer/block_stream_source.d.ts +10 -0
  12. package/dest/block_synchronizer/block_stream_source.d.ts.map +1 -0
  13. package/dest/block_synchronizer/block_stream_source.js +62 -0
  14. package/dest/block_synchronizer/block_synchronizer.d.ts +49 -0
  15. package/dest/block_synchronizer/block_synchronizer.d.ts.map +1 -0
  16. package/dest/block_synchronizer/block_synchronizer.js +173 -0
  17. package/dest/block_synchronizer/index.d.ts +2 -0
  18. package/dest/block_synchronizer/index.d.ts.map +1 -0
  19. package/dest/block_synchronizer/index.js +1 -0
  20. package/dest/config/index.d.ts +20 -25
  21. package/dest/config/index.d.ts.map +1 -1
  22. package/dest/config/index.js +35 -35
  23. package/dest/config/package_info.d.ts +1 -1
  24. package/dest/config/package_info.js +1 -1
  25. package/dest/contract_function_simulator/benchmarked_node.d.ts +9 -0
  26. package/dest/contract_function_simulator/benchmarked_node.d.ts.map +1 -0
  27. package/dest/contract_function_simulator/benchmarked_node.js +77 -0
  28. package/dest/contract_function_simulator/contract_function_simulator.d.ts +119 -0
  29. package/dest/contract_function_simulator/contract_function_simulator.d.ts.map +1 -0
  30. package/dest/contract_function_simulator/contract_function_simulator.js +480 -0
  31. package/dest/contract_function_simulator/ephemeral_array_service.d.ts +28 -0
  32. package/dest/contract_function_simulator/ephemeral_array_service.d.ts.map +1 -0
  33. package/dest/contract_function_simulator/ephemeral_array_service.js +78 -0
  34. package/dest/contract_function_simulator/execution_note_cache.d.ts +104 -0
  35. package/dest/contract_function_simulator/execution_note_cache.d.ts.map +1 -0
  36. package/dest/contract_function_simulator/execution_note_cache.js +208 -0
  37. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts +12 -0
  38. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts.map +1 -0
  39. package/dest/contract_function_simulator/execution_tagging_index_cache.js +30 -0
  40. package/dest/contract_function_simulator/hashed_values_cache.d.ts +28 -0
  41. package/dest/contract_function_simulator/hashed_values_cache.d.ts.map +1 -0
  42. package/dest/contract_function_simulator/hashed_values_cache.js +36 -0
  43. package/dest/contract_function_simulator/index.d.ts +26 -0
  44. package/dest/contract_function_simulator/index.d.ts.map +1 -0
  45. package/dest/contract_function_simulator/index.js +23 -0
  46. package/dest/contract_function_simulator/noir-structs/bounded_vec.d.ts +48 -0
  47. package/dest/contract_function_simulator/noir-structs/bounded_vec.d.ts.map +1 -0
  48. package/dest/contract_function_simulator/noir-structs/bounded_vec.js +45 -0
  49. package/dest/contract_function_simulator/noir-structs/ephemeral_array.d.ts +37 -0
  50. package/dest/contract_function_simulator/noir-structs/ephemeral_array.d.ts.map +1 -0
  51. package/dest/contract_function_simulator/noir-structs/ephemeral_array.js +59 -0
  52. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts +20 -0
  53. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts.map +1 -0
  54. package/dest/contract_function_simulator/noir-structs/event_validation_request.js +39 -0
  55. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.d.ts +26 -0
  56. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.d.ts.map +1 -0
  57. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.js +57 -0
  58. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts +17 -0
  59. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts.map +1 -0
  60. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.js +63 -0
  61. package/dest/contract_function_simulator/noir-structs/note_data.d.ts +27 -0
  62. package/dest/contract_function_simulator/noir-structs/note_data.d.ts.map +1 -0
  63. package/dest/contract_function_simulator/noir-structs/note_data.js +3 -0
  64. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts +22 -0
  65. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts.map +1 -0
  66. package/dest/contract_function_simulator/noir-structs/note_validation_request.js +47 -0
  67. package/dest/contract_function_simulator/noir-structs/option.d.ts +61 -0
  68. package/dest/contract_function_simulator/noir-structs/option.d.ts.map +1 -0
  69. package/dest/contract_function_simulator/noir-structs/option.js +62 -0
  70. package/dest/contract_function_simulator/noir-structs/provided_secret.d.ts +11 -0
  71. package/dest/contract_function_simulator/noir-structs/provided_secret.d.ts.map +1 -0
  72. package/dest/contract_function_simulator/noir-structs/provided_secret.js +24 -0
  73. package/dest/contract_function_simulator/noir-structs/utility_context.d.ts +16 -0
  74. package/dest/contract_function_simulator/noir-structs/utility_context.d.ts.map +1 -0
  75. package/dest/contract_function_simulator/noir-structs/utility_context.js +22 -0
  76. package/dest/contract_function_simulator/oracle/index.d.ts +14 -0
  77. package/dest/contract_function_simulator/oracle/index.d.ts.map +1 -0
  78. package/dest/contract_function_simulator/oracle/index.js +2 -0
  79. package/dest/contract_function_simulator/oracle/interfaces.d.ts +25 -0
  80. package/dest/contract_function_simulator/oracle/interfaces.d.ts.map +1 -0
  81. package/dest/contract_function_simulator/oracle/interfaces.js +4 -0
  82. package/dest/contract_function_simulator/oracle/message_load_oracle_inputs.d.ts +19 -0
  83. package/dest/contract_function_simulator/oracle/message_load_oracle_inputs.d.ts.map +1 -0
  84. package/dest/contract_function_simulator/oracle/message_load_oracle_inputs.js +24 -0
  85. package/dest/contract_function_simulator/oracle/note_packing_utils.d.ts +28 -0
  86. package/dest/contract_function_simulator/oracle/note_packing_utils.d.ts.map +1 -0
  87. package/dest/contract_function_simulator/oracle/note_packing_utils.js +54 -0
  88. package/dest/contract_function_simulator/oracle/oracle.d.ts +89 -0
  89. package/dest/contract_function_simulator/oracle/oracle.d.ts.map +1 -0
  90. package/dest/contract_function_simulator/oracle/oracle.js +552 -0
  91. package/dest/contract_function_simulator/oracle/oracle_registry.d.ts +127 -0
  92. package/dest/contract_function_simulator/oracle/oracle_registry.d.ts.map +1 -0
  93. package/dest/contract_function_simulator/oracle/oracle_registry.js +786 -0
  94. package/dest/contract_function_simulator/oracle/oracle_type_mappings.d.ts +139 -0
  95. package/dest/contract_function_simulator/oracle/oracle_type_mappings.d.ts.map +1 -0
  96. package/dest/contract_function_simulator/oracle/oracle_type_mappings.js +560 -0
  97. package/dest/contract_function_simulator/oracle/private_execution.d.ts +23 -0
  98. package/dest/contract_function_simulator/oracle/private_execution.d.ts.map +1 -0
  99. package/dest/contract_function_simulator/oracle/private_execution.js +89 -0
  100. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts +212 -0
  101. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts.map +1 -0
  102. package/dest/contract_function_simulator/oracle/private_execution_oracle.js +457 -0
  103. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts +283 -0
  104. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts.map +1 -0
  105. package/dest/contract_function_simulator/oracle/utility_execution_oracle.js +654 -0
  106. package/dest/contract_function_simulator/pick_notes.d.ts +85 -0
  107. package/dest/contract_function_simulator/pick_notes.d.ts.map +1 -0
  108. package/dest/contract_function_simulator/pick_notes.js +68 -0
  109. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts +6 -0
  110. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts.map +1 -0
  111. package/dest/contract_function_simulator/proxied_contract_data_source.js +51 -0
  112. package/dest/contract_logging.d.ts +27 -0
  113. package/dest/contract_logging.d.ts.map +1 -0
  114. package/dest/contract_logging.js +38 -0
  115. package/dest/contract_sync/contract_sync_service.d.ts +42 -0
  116. package/dest/contract_sync/contract_sync_service.d.ts.map +1 -0
  117. package/dest/contract_sync/contract_sync_service.js +135 -0
  118. package/dest/contract_sync/helpers.d.ts +27 -0
  119. package/dest/contract_sync/helpers.d.ts.map +1 -0
  120. package/dest/contract_sync/helpers.js +53 -0
  121. package/dest/debug/pxe_debug_utils.d.ts +40 -0
  122. package/dest/debug/pxe_debug_utils.d.ts.map +1 -0
  123. package/dest/debug/pxe_debug_utils.js +42 -0
  124. package/dest/entrypoints/client/bundle/index.d.ts +6 -3
  125. package/dest/entrypoints/client/bundle/index.d.ts.map +1 -1
  126. package/dest/entrypoints/client/bundle/index.js +4 -2
  127. package/dest/entrypoints/client/bundle/utils.d.ts +10 -10
  128. package/dest/entrypoints/client/bundle/utils.d.ts.map +1 -1
  129. package/dest/entrypoints/client/bundle/utils.js +51 -14
  130. package/dest/entrypoints/client/lazy/index.d.ts +6 -3
  131. package/dest/entrypoints/client/lazy/index.d.ts.map +1 -1
  132. package/dest/entrypoints/client/lazy/index.js +4 -2
  133. package/dest/entrypoints/client/lazy/utils.d.ts +10 -10
  134. package/dest/entrypoints/client/lazy/utils.d.ts.map +1 -1
  135. package/dest/entrypoints/client/lazy/utils.js +51 -14
  136. package/dest/entrypoints/pxe_creation_options.d.ts +26 -0
  137. package/dest/entrypoints/pxe_creation_options.d.ts.map +1 -0
  138. package/dest/entrypoints/pxe_creation_options.js +3 -0
  139. package/dest/entrypoints/server/index.d.ts +10 -4
  140. package/dest/entrypoints/server/index.d.ts.map +1 -1
  141. package/dest/entrypoints/server/index.js +8 -3
  142. package/dest/entrypoints/server/utils.d.ts +9 -16
  143. package/dest/entrypoints/server/utils.d.ts.map +1 -1
  144. package/dest/entrypoints/server/utils.js +62 -36
  145. package/dest/error_enriching.d.ts +11 -0
  146. package/dest/error_enriching.d.ts.map +1 -0
  147. package/dest/{pxe_service/error_enriching.js → error_enriching.js} +30 -22
  148. package/dest/events/event_service.d.ts +24 -0
  149. package/dest/events/event_service.d.ts.map +1 -0
  150. package/dest/events/event_service.js +77 -0
  151. package/dest/events/index.d.ts +2 -0
  152. package/dest/events/index.d.ts.map +1 -0
  153. package/dest/events/index.js +1 -0
  154. package/dest/events/private_event_filter_validator.d.ts +10 -0
  155. package/dest/events/private_event_filter_validator.d.ts.map +1 -0
  156. package/dest/events/private_event_filter_validator.js +53 -0
  157. package/dest/hooks/authorize_utility_call.d.ts +41 -0
  158. package/dest/hooks/authorize_utility_call.d.ts.map +1 -0
  159. package/dest/hooks/authorize_utility_call.js +4 -0
  160. package/dest/hooks/execution_hooks.d.ts +42 -0
  161. package/dest/hooks/execution_hooks.d.ts.map +1 -0
  162. package/dest/hooks/execution_hooks.js +9 -0
  163. package/dest/hooks/index.d.ts +4 -0
  164. package/dest/hooks/index.d.ts.map +1 -0
  165. package/dest/hooks/index.js +1 -0
  166. package/dest/job_coordinator/job_coordinator.d.ts +75 -0
  167. package/dest/job_coordinator/job_coordinator.d.ts.map +1 -0
  168. package/dest/job_coordinator/job_coordinator.js +94 -0
  169. package/dest/logs/log_service.d.ts +29 -0
  170. package/dest/logs/log_service.d.ts.map +1 -0
  171. package/dest/logs/log_service.js +172 -0
  172. package/dest/messages/message_context_service.d.ts +17 -0
  173. package/dest/messages/message_context_service.d.ts.map +1 -0
  174. package/dest/messages/message_context_service.js +55 -0
  175. package/dest/notes/index.d.ts +2 -0
  176. package/dest/notes/index.d.ts.map +1 -0
  177. package/dest/notes/index.js +1 -0
  178. package/dest/notes/note_service.d.ts +70 -0
  179. package/dest/notes/note_service.d.ts.map +1 -0
  180. package/dest/notes/note_service.js +172 -0
  181. package/dest/notes_filter.d.ts +24 -0
  182. package/dest/notes_filter.d.ts.map +1 -0
  183. package/dest/notes_filter.js +4 -0
  184. package/dest/oracle_version.d.ts +4 -0
  185. package/dest/oracle_version.d.ts.map +1 -0
  186. package/dest/oracle_version.js +21 -0
  187. package/dest/private_kernel/batch_planner.d.ts +47 -0
  188. package/dest/private_kernel/batch_planner.d.ts.map +1 -0
  189. package/dest/private_kernel/batch_planner.js +104 -0
  190. package/dest/private_kernel/hints/compute_tx_expiration_timestamp.d.ts +4 -0
  191. package/dest/private_kernel/hints/compute_tx_expiration_timestamp.d.ts.map +1 -0
  192. package/dest/private_kernel/hints/compute_tx_expiration_timestamp.js +41 -0
  193. package/dest/private_kernel/hints/index.d.ts +3 -0
  194. package/dest/private_kernel/hints/index.d.ts.map +1 -0
  195. package/dest/private_kernel/hints/index.js +2 -0
  196. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts +29 -0
  197. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts.map +1 -0
  198. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.js +338 -0
  199. package/dest/private_kernel/hints/test_utils.d.ts +122 -0
  200. package/dest/private_kernel/hints/test_utils.d.ts.map +1 -0
  201. package/dest/private_kernel/hints/test_utils.js +202 -0
  202. package/dest/private_kernel/index.d.ts +3 -0
  203. package/dest/private_kernel/index.d.ts.map +1 -0
  204. package/dest/private_kernel/index.js +2 -0
  205. package/dest/private_kernel/private_kernel_execution_prover.d.ts +49 -0
  206. package/dest/private_kernel/private_kernel_execution_prover.d.ts.map +1 -0
  207. package/dest/private_kernel/private_kernel_execution_prover.js +386 -0
  208. package/dest/private_kernel/private_kernel_oracle.d.ts +63 -0
  209. package/dest/private_kernel/private_kernel_oracle.d.ts.map +1 -0
  210. package/dest/private_kernel/private_kernel_oracle.js +98 -0
  211. package/dest/pxe.d.ts +300 -0
  212. package/dest/pxe.d.ts.map +1 -0
  213. package/dest/pxe.js +839 -0
  214. package/dest/storage/address_store/address_store.d.ts +11 -0
  215. package/dest/storage/address_store/address_store.d.ts.map +1 -0
  216. package/dest/storage/{address_data_provider/address_data_provider.js → address_store/address_store.js} +13 -15
  217. package/dest/storage/address_store/index.d.ts +2 -0
  218. package/dest/storage/address_store/index.d.ts.map +1 -0
  219. package/dest/storage/address_store/index.js +1 -0
  220. package/dest/storage/anchor_block_store/anchor_block_store.d.ts +17 -0
  221. package/dest/storage/anchor_block_store/anchor_block_store.d.ts.map +1 -0
  222. package/dest/storage/anchor_block_store/anchor_block_store.js +26 -0
  223. package/dest/storage/anchor_block_store/index.d.ts +2 -0
  224. package/dest/storage/anchor_block_store/index.d.ts.map +1 -0
  225. package/dest/storage/anchor_block_store/index.js +1 -0
  226. package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.d.ts +42 -0
  227. package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.d.ts.map +1 -0
  228. package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.js +93 -0
  229. package/dest/storage/backwards_compatibility_tests/schema_tests.d.ts +15 -0
  230. package/dest/storage/backwards_compatibility_tests/schema_tests.d.ts.map +1 -0
  231. package/dest/storage/backwards_compatibility_tests/schema_tests.js +591 -0
  232. package/dest/storage/backwards_compatibility_tests/store_spy.d.ts +19 -0
  233. package/dest/storage/backwards_compatibility_tests/store_spy.d.ts.map +1 -0
  234. package/dest/storage/backwards_compatibility_tests/store_spy.js +63 -0
  235. package/dest/storage/capsule_store/capsule_service.d.ts +21 -0
  236. package/dest/storage/capsule_store/capsule_service.d.ts.map +1 -0
  237. package/dest/storage/capsule_store/capsule_service.js +50 -0
  238. package/dest/storage/capsule_store/capsule_store.d.ts +72 -0
  239. package/dest/storage/capsule_store/capsule_store.d.ts.map +1 -0
  240. package/dest/storage/capsule_store/capsule_store.js +261 -0
  241. package/dest/storage/capsule_store/index.d.ts +3 -0
  242. package/dest/storage/capsule_store/index.d.ts.map +1 -0
  243. package/dest/storage/capsule_store/index.js +2 -0
  244. package/dest/storage/contract_store/contract_store.d.ts +93 -0
  245. package/dest/storage/contract_store/contract_store.d.ts.map +1 -0
  246. package/dest/storage/contract_store/contract_store.js +292 -0
  247. package/dest/storage/contract_store/index.d.ts +2 -0
  248. package/dest/storage/contract_store/index.d.ts.map +1 -0
  249. package/dest/storage/contract_store/index.js +1 -0
  250. package/dest/storage/contract_store/private_functions_tree.d.ts +27 -0
  251. package/dest/storage/contract_store/private_functions_tree.d.ts.map +1 -0
  252. package/dest/storage/contract_store/private_functions_tree.js +47 -0
  253. package/dest/storage/index.d.ts +9 -10
  254. package/dest/storage/index.d.ts.map +1 -1
  255. package/dest/storage/index.js +8 -9
  256. package/dest/storage/metadata.d.ts +2 -0
  257. package/dest/storage/metadata.d.ts.map +1 -0
  258. package/dest/storage/metadata.js +1 -0
  259. package/dest/storage/note_store/index.d.ts +3 -0
  260. package/dest/storage/note_store/index.d.ts.map +1 -0
  261. package/dest/storage/note_store/index.js +2 -0
  262. package/dest/storage/note_store/note_store.d.ts +83 -0
  263. package/dest/storage/note_store/note_store.d.ts.map +1 -0
  264. package/dest/storage/note_store/note_store.js +343 -0
  265. package/dest/storage/note_store/stored_note.d.ts +16 -0
  266. package/dest/storage/note_store/stored_note.d.ts.map +1 -0
  267. package/dest/storage/note_store/stored_note.js +43 -0
  268. package/dest/storage/open_pxe_stores.d.ts +33 -0
  269. package/dest/storage/open_pxe_stores.d.ts.map +1 -0
  270. package/dest/storage/open_pxe_stores.js +27 -0
  271. package/dest/storage/private_event_store/private_event_store.d.ts +91 -0
  272. package/dest/storage/private_event_store/private_event_store.d.ts.map +1 -0
  273. package/dest/storage/private_event_store/private_event_store.js +276 -0
  274. package/dest/storage/private_event_store/stored_private_event.d.ts +23 -0
  275. package/dest/storage/private_event_store/stored_private_event.d.ts.map +1 -0
  276. package/dest/storage/private_event_store/stored_private_event.js +56 -0
  277. package/dest/storage/tagging_store/index.d.ts +4 -0
  278. package/dest/storage/tagging_store/index.d.ts.map +1 -0
  279. package/dest/storage/tagging_store/index.js +3 -0
  280. package/dest/storage/tagging_store/recipient_tagging_store.d.ts +28 -0
  281. package/dest/storage/tagging_store/recipient_tagging_store.d.ts.map +1 -0
  282. package/dest/storage/tagging_store/recipient_tagging_store.js +111 -0
  283. package/dest/storage/tagging_store/sender_address_book_store.d.ts +14 -0
  284. package/dest/storage/tagging_store/sender_address_book_store.d.ts.map +1 -0
  285. package/dest/storage/tagging_store/sender_address_book_store.js +36 -0
  286. package/dest/storage/tagging_store/sender_tagging_store.d.ts +78 -0
  287. package/dest/storage/tagging_store/sender_tagging_store.d.ts.map +1 -0
  288. package/dest/storage/tagging_store/sender_tagging_store.js +374 -0
  289. package/dest/tagging/constants.d.ts +2 -0
  290. package/dest/tagging/constants.d.ts.map +1 -0
  291. package/dest/tagging/constants.js +10 -0
  292. package/dest/tagging/get_all_logs_by_tags.d.ts +48 -0
  293. package/dest/tagging/get_all_logs_by_tags.d.ts.map +1 -0
  294. package/dest/tagging/get_all_logs_by_tags.js +59 -0
  295. package/dest/tagging/index.d.ts +18 -0
  296. package/dest/tagging/index.d.ts.map +1 -0
  297. package/dest/tagging/index.js +16 -0
  298. package/dest/tagging/persist_sender_tagging_index_ranges.d.ts +29 -0
  299. package/dest/tagging/persist_sender_tagging_index_ranges.d.ts.map +1 -0
  300. package/dest/tagging/persist_sender_tagging_index_ranges.js +42 -0
  301. package/dest/tagging/recipient_sync/sync_tagged_private_logs.d.ts +56 -0
  302. package/dest/tagging/recipient_sync/sync_tagged_private_logs.d.ts.map +1 -0
  303. package/dest/tagging/recipient_sync/sync_tagged_private_logs.js +163 -0
  304. package/dest/tagging/recipient_sync/utils/find_highest_indexes.d.ts +12 -0
  305. package/dest/tagging/recipient_sync/utils/find_highest_indexes.d.ts.map +1 -0
  306. package/dest/tagging/recipient_sync/utils/find_highest_indexes.js +20 -0
  307. package/dest/tagging/reconcile_tagging_index_ranges.d.ts +36 -0
  308. package/dest/tagging/reconcile_tagging_index_ranges.d.ts.map +1 -0
  309. package/dest/tagging/reconcile_tagging_index_ranges.js +74 -0
  310. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts +16 -0
  311. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts.map +1 -0
  312. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.js +92 -0
  313. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts +17 -0
  314. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts.map +1 -0
  315. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.js +60 -0
  316. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts +19 -0
  317. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts.map +1 -0
  318. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.js +72 -0
  319. package/package.json +48 -33
  320. package/src/bin/check_oracle_version.ts +88 -0
  321. package/src/bin/index.ts +1 -38
  322. package/src/bin/oracle_version_helpers.ts +121 -0
  323. package/src/block_synchronizer/block_stream_source.ts +81 -0
  324. package/src/block_synchronizer/block_synchronizer.ts +200 -0
  325. package/src/block_synchronizer/index.ts +1 -0
  326. package/src/config/index.ts +48 -56
  327. package/src/config/package_info.ts +1 -1
  328. package/src/contract_function_simulator/benchmarked_node.ts +103 -0
  329. package/src/contract_function_simulator/contract_function_simulator.ts +888 -0
  330. package/src/contract_function_simulator/ephemeral_array_service.ts +110 -0
  331. package/src/contract_function_simulator/execution_note_cache.ts +252 -0
  332. package/src/contract_function_simulator/execution_tagging_index_cache.ts +33 -0
  333. package/src/contract_function_simulator/hashed_values_cache.ts +47 -0
  334. package/src/contract_function_simulator/index.ts +63 -0
  335. package/src/contract_function_simulator/noir-structs/bounded_vec.ts +55 -0
  336. package/src/contract_function_simulator/noir-structs/ephemeral_array.ts +66 -0
  337. package/src/contract_function_simulator/noir-structs/event_validation_request.ts +52 -0
  338. package/src/contract_function_simulator/noir-structs/log_retrieval_request.ts +61 -0
  339. package/src/contract_function_simulator/noir-structs/log_retrieval_response.ts +66 -0
  340. package/src/contract_function_simulator/noir-structs/note_data.ts +27 -0
  341. package/src/contract_function_simulator/noir-structs/note_validation_request.ts +59 -0
  342. package/src/contract_function_simulator/noir-structs/option.ts +69 -0
  343. package/src/contract_function_simulator/noir-structs/provided_secret.ts +27 -0
  344. package/src/contract_function_simulator/noir-structs/utility_context.ts +23 -0
  345. package/src/contract_function_simulator/oracle/index.ts +16 -0
  346. package/src/contract_function_simulator/oracle/interfaces.ts +21 -0
  347. package/src/contract_function_simulator/oracle/message_load_oracle_inputs.ts +23 -0
  348. package/src/contract_function_simulator/oracle/note_packing_utils.ts +68 -0
  349. package/src/contract_function_simulator/oracle/oracle.ts +711 -0
  350. package/src/contract_function_simulator/oracle/oracle_registry.ts +585 -0
  351. package/src/contract_function_simulator/oracle/oracle_type_mappings.ts +553 -0
  352. package/src/contract_function_simulator/oracle/private_execution.ts +141 -0
  353. package/src/contract_function_simulator/oracle/private_execution_oracle.ts +667 -0
  354. package/src/contract_function_simulator/oracle/utility_execution_oracle.ts +967 -0
  355. package/src/contract_function_simulator/pick_notes.ts +160 -0
  356. package/src/contract_function_simulator/proxied_contract_data_source.ts +60 -0
  357. package/src/contract_logging.ts +52 -0
  358. package/src/contract_sync/contract_sync_service.ts +189 -0
  359. package/src/contract_sync/helpers.ts +86 -0
  360. package/src/debug/pxe_debug_utils.ts +85 -0
  361. package/src/entrypoints/client/bundle/index.ts +5 -2
  362. package/src/entrypoints/client/bundle/utils.ts +47 -35
  363. package/src/entrypoints/client/lazy/index.ts +5 -2
  364. package/src/entrypoints/client/lazy/utils.ts +48 -31
  365. package/src/entrypoints/pxe_creation_options.ts +28 -0
  366. package/src/entrypoints/server/index.ts +9 -3
  367. package/src/entrypoints/server/utils.ts +65 -56
  368. package/src/{pxe_service/error_enriching.ts → error_enriching.ts} +40 -39
  369. package/src/events/event_service.ts +119 -0
  370. package/src/events/index.ts +1 -0
  371. package/src/events/private_event_filter_validator.ts +66 -0
  372. package/src/hooks/authorize_utility_call.ts +44 -0
  373. package/src/hooks/execution_hooks.ts +48 -0
  374. package/src/hooks/index.ts +7 -0
  375. package/src/job_coordinator/job_coordinator.ts +150 -0
  376. package/src/logs/log_service.ts +237 -0
  377. package/src/messages/message_context_service.ts +62 -0
  378. package/src/notes/index.ts +1 -0
  379. package/src/notes/note_service.ts +230 -0
  380. package/src/notes_filter.ts +24 -0
  381. package/src/oracle_version.ts +22 -0
  382. package/src/private_kernel/batch_planner.ts +169 -0
  383. package/src/private_kernel/hints/compute_tx_expiration_timestamp.ts +58 -0
  384. package/src/private_kernel/hints/index.ts +2 -0
  385. package/src/private_kernel/hints/private_kernel_reset_private_inputs_builder.ts +542 -0
  386. package/src/private_kernel/hints/test_utils.ts +318 -0
  387. package/src/private_kernel/index.ts +2 -0
  388. package/src/private_kernel/private_kernel_execution_prover.ts +598 -0
  389. package/src/private_kernel/private_kernel_oracle.ts +162 -0
  390. package/src/pxe.ts +1305 -0
  391. package/src/storage/{address_data_provider/address_data_provider.ts → address_store/address_store.ts} +15 -21
  392. package/src/storage/address_store/index.ts +1 -0
  393. package/src/storage/anchor_block_store/anchor_block_store.ts +33 -0
  394. package/src/storage/anchor_block_store/index.ts +1 -0
  395. package/src/storage/backwards_compatibility_tests/__snapshots__/AddressStore.json +22 -0
  396. package/src/storage/backwards_compatibility_tests/__snapshots__/AnchorBlockStore.json +3 -0
  397. package/src/storage/backwards_compatibility_tests/__snapshots__/CapsuleStore.json +16 -0
  398. package/src/storage/backwards_compatibility_tests/__snapshots__/ContractStore.json +28 -0
  399. package/src/storage/backwards_compatibility_tests/__snapshots__/KeyStore.json +52 -0
  400. package/src/storage/backwards_compatibility_tests/__snapshots__/L2TipsKVStore.json +46 -0
  401. package/src/storage/backwards_compatibility_tests/__snapshots__/NoteStore.json +36 -0
  402. package/src/storage/backwards_compatibility_tests/__snapshots__/PrivateEventStore.json +44 -0
  403. package/src/storage/backwards_compatibility_tests/__snapshots__/RecipientTaggingStore.json +18 -0
  404. package/src/storage/backwards_compatibility_tests/__snapshots__/SenderAddressBookStore.json +16 -0
  405. package/src/storage/backwards_compatibility_tests/__snapshots__/SenderTaggingStore.json +22 -0
  406. package/src/storage/backwards_compatibility_tests/__snapshots__/opened_stores.json +97 -0
  407. package/src/storage/backwards_compatibility_tests/kv_store_snapshot.ts +122 -0
  408. package/src/storage/backwards_compatibility_tests/schema_tests.ts +712 -0
  409. package/src/storage/backwards_compatibility_tests/store_spy.ts +73 -0
  410. package/src/storage/capsule_store/capsule_service.ts +90 -0
  411. package/src/storage/capsule_store/capsule_store.ts +333 -0
  412. package/src/storage/capsule_store/index.ts +2 -0
  413. package/src/storage/contract_store/contract_store.ts +408 -0
  414. package/src/storage/contract_store/index.ts +1 -0
  415. package/src/storage/contract_store/private_functions_tree.ts +67 -0
  416. package/src/storage/index.ts +8 -10
  417. package/src/storage/metadata.ts +1 -0
  418. package/src/storage/note_store/index.ts +2 -0
  419. package/src/storage/note_store/note_store.ts +415 -0
  420. package/src/storage/note_store/stored_note.ts +48 -0
  421. package/src/storage/open_pxe_stores.ts +49 -0
  422. package/src/storage/private_event_store/private_event_store.ts +388 -0
  423. package/src/storage/private_event_store/stored_private_event.ts +73 -0
  424. package/src/storage/tagging_store/index.ts +3 -0
  425. package/src/storage/tagging_store/recipient_tagging_store.ts +139 -0
  426. package/src/storage/tagging_store/sender_address_book_store.ts +48 -0
  427. package/src/storage/tagging_store/sender_tagging_store.ts +476 -0
  428. package/src/tagging/constants.ts +10 -0
  429. package/src/tagging/get_all_logs_by_tags.ts +120 -0
  430. package/src/tagging/index.ts +20 -0
  431. package/src/tagging/persist_sender_tagging_index_ranges.ts +57 -0
  432. package/src/tagging/recipient_sync/sync_tagged_private_logs.ts +240 -0
  433. package/src/tagging/recipient_sync/utils/find_highest_indexes.ts +34 -0
  434. package/src/tagging/reconcile_tagging_index_ranges.ts +102 -0
  435. package/src/tagging/sender_sync/sync_sender_tagging_indexes.ts +134 -0
  436. package/src/tagging/sender_sync/utils/get_status_change_of_pending.ts +66 -0
  437. package/src/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.ts +84 -0
  438. package/dest/entrypoints/client/pxe_creation_options.d.ts +0 -11
  439. package/dest/entrypoints/client/pxe_creation_options.d.ts.map +0 -1
  440. package/dest/entrypoints/client/pxe_creation_options.js +0 -1
  441. package/dest/kernel_oracle/index.d.ts +0 -45
  442. package/dest/kernel_oracle/index.d.ts.map +0 -1
  443. package/dest/kernel_oracle/index.js +0 -76
  444. package/dest/kernel_prover/hints/build_private_kernel_reset_private_inputs.d.ts +0 -28
  445. package/dest/kernel_prover/hints/build_private_kernel_reset_private_inputs.d.ts.map +0 -1
  446. package/dest/kernel_prover/hints/build_private_kernel_reset_private_inputs.js +0 -270
  447. package/dest/kernel_prover/hints/index.d.ts +0 -2
  448. package/dest/kernel_prover/hints/index.d.ts.map +0 -1
  449. package/dest/kernel_prover/hints/index.js +0 -1
  450. package/dest/kernel_prover/index.d.ts +0 -3
  451. package/dest/kernel_prover/index.d.ts.map +0 -1
  452. package/dest/kernel_prover/index.js +0 -2
  453. package/dest/kernel_prover/kernel_prover.d.ts +0 -38
  454. package/dest/kernel_prover/kernel_prover.d.ts.map +0 -1
  455. package/dest/kernel_prover/kernel_prover.js +0 -217
  456. package/dest/kernel_prover/proving_data_oracle.d.ts +0 -73
  457. package/dest/kernel_prover/proving_data_oracle.d.ts.map +0 -1
  458. package/dest/kernel_prover/proving_data_oracle.js +0 -4
  459. package/dest/note_decryption_utils/add_public_values_to_payload.d.ts +0 -11
  460. package/dest/note_decryption_utils/add_public_values_to_payload.d.ts.map +0 -1
  461. package/dest/note_decryption_utils/add_public_values_to_payload.js +0 -47
  462. package/dest/pxe_http/index.d.ts +0 -2
  463. package/dest/pxe_http/index.d.ts.map +0 -1
  464. package/dest/pxe_http/index.js +0 -1
  465. package/dest/pxe_http/pxe_http_server.d.ts +0 -16
  466. package/dest/pxe_http/pxe_http_server.d.ts.map +0 -1
  467. package/dest/pxe_http/pxe_http_server.js +0 -27
  468. package/dest/pxe_oracle_interface/index.d.ts +0 -159
  469. package/dest/pxe_oracle_interface/index.d.ts.map +0 -1
  470. package/dest/pxe_oracle_interface/index.js +0 -692
  471. package/dest/pxe_oracle_interface/tagging_utils.d.ts +0 -17
  472. package/dest/pxe_oracle_interface/tagging_utils.d.ts.map +0 -1
  473. package/dest/pxe_oracle_interface/tagging_utils.js +0 -23
  474. package/dest/pxe_service/error_enriching.d.ts +0 -11
  475. package/dest/pxe_service/error_enriching.d.ts.map +0 -1
  476. package/dest/pxe_service/index.d.ts +0 -3
  477. package/dest/pxe_service/index.d.ts.map +0 -1
  478. package/dest/pxe_service/index.js +0 -2
  479. package/dest/pxe_service/pxe_service.d.ts +0 -111
  480. package/dest/pxe_service/pxe_service.d.ts.map +0 -1
  481. package/dest/pxe_service/pxe_service.js +0 -664
  482. package/dest/storage/address_data_provider/address_data_provider.d.ts +0 -13
  483. package/dest/storage/address_data_provider/address_data_provider.d.ts.map +0 -1
  484. package/dest/storage/address_data_provider/index.d.ts +0 -2
  485. package/dest/storage/address_data_provider/index.d.ts.map +0 -1
  486. package/dest/storage/address_data_provider/index.js +0 -1
  487. package/dest/storage/auth_witness_data_provider/auth_witness_data_provider.d.ts +0 -11
  488. package/dest/storage/auth_witness_data_provider/auth_witness_data_provider.d.ts.map +0 -1
  489. package/dest/storage/auth_witness_data_provider/auth_witness_data_provider.js +0 -20
  490. package/dest/storage/auth_witness_data_provider/index.d.ts +0 -2
  491. package/dest/storage/auth_witness_data_provider/index.d.ts.map +0 -1
  492. package/dest/storage/auth_witness_data_provider/index.js +0 -1
  493. package/dest/storage/capsule_data_provider/capsule_data_provider.d.ts +0 -16
  494. package/dest/storage/capsule_data_provider/capsule_data_provider.d.ts.map +0 -1
  495. package/dest/storage/capsule_data_provider/capsule_data_provider.js +0 -57
  496. package/dest/storage/capsule_data_provider/index.d.ts +0 -2
  497. package/dest/storage/capsule_data_provider/index.d.ts.map +0 -1
  498. package/dest/storage/capsule_data_provider/index.js +0 -1
  499. package/dest/storage/contract_data_provider/contract_data_provider.d.ts +0 -109
  500. package/dest/storage/contract_data_provider/contract_data_provider.d.ts.map +0 -1
  501. package/dest/storage/contract_data_provider/contract_data_provider.js +0 -183
  502. package/dest/storage/contract_data_provider/index.d.ts +0 -3
  503. package/dest/storage/contract_data_provider/index.d.ts.map +0 -1
  504. package/dest/storage/contract_data_provider/index.js +0 -2
  505. package/dest/storage/contract_data_provider/private_functions_tree.d.ts +0 -66
  506. package/dest/storage/contract_data_provider/private_functions_tree.d.ts.map +0 -1
  507. package/dest/storage/contract_data_provider/private_functions_tree.js +0 -99
  508. package/dest/storage/data_provider.d.ts +0 -4
  509. package/dest/storage/data_provider.d.ts.map +0 -1
  510. package/dest/storage/data_provider.js +0 -1
  511. package/dest/storage/note_data_provider/index.d.ts +0 -3
  512. package/dest/storage/note_data_provider/index.d.ts.map +0 -1
  513. package/dest/storage/note_data_provider/index.js +0 -2
  514. package/dest/storage/note_data_provider/note_dao.d.ts +0 -106
  515. package/dest/storage/note_data_provider/note_dao.d.ts.map +0 -1
  516. package/dest/storage/note_data_provider/note_dao.js +0 -106
  517. package/dest/storage/note_data_provider/note_data_provider.d.ts +0 -20
  518. package/dest/storage/note_data_provider/note_data_provider.d.ts.map +0 -1
  519. package/dest/storage/note_data_provider/note_data_provider.js +0 -249
  520. package/dest/storage/sync_data_provider/index.d.ts +0 -2
  521. package/dest/storage/sync_data_provider/index.d.ts.map +0 -1
  522. package/dest/storage/sync_data_provider/index.js +0 -1
  523. package/dest/storage/sync_data_provider/sync_data_provider.d.ts +0 -12
  524. package/dest/storage/sync_data_provider/sync_data_provider.d.ts.map +0 -1
  525. package/dest/storage/sync_data_provider/sync_data_provider.js +0 -29
  526. package/dest/storage/tagging_data_provider/index.d.ts +0 -2
  527. package/dest/storage/tagging_data_provider/index.d.ts.map +0 -1
  528. package/dest/storage/tagging_data_provider/index.js +0 -1
  529. package/dest/storage/tagging_data_provider/tagging_data_provider.d.ts +0 -18
  530. package/dest/storage/tagging_data_provider/tagging_data_provider.d.ts.map +0 -1
  531. package/dest/storage/tagging_data_provider/tagging_data_provider.js +0 -65
  532. package/dest/synchronizer/index.d.ts +0 -2
  533. package/dest/synchronizer/index.d.ts.map +0 -1
  534. package/dest/synchronizer/index.js +0 -1
  535. package/dest/synchronizer/synchronizer.d.ts +0 -37
  536. package/dest/synchronizer/synchronizer.d.ts.map +0 -1
  537. package/dest/synchronizer/synchronizer.js +0 -103
  538. package/dest/test/pxe_test_suite.d.ts +0 -3
  539. package/dest/test/pxe_test_suite.d.ts.map +0 -1
  540. package/dest/test/pxe_test_suite.js +0 -97
  541. package/src/entrypoints/client/pxe_creation_options.ts +0 -7
  542. package/src/kernel_oracle/index.ts +0 -117
  543. package/src/kernel_prover/hints/build_private_kernel_reset_private_inputs.ts +0 -472
  544. package/src/kernel_prover/hints/index.ts +0 -1
  545. package/src/kernel_prover/index.ts +0 -2
  546. package/src/kernel_prover/kernel_prover.ts +0 -351
  547. package/src/kernel_prover/proving_data_oracle.ts +0 -83
  548. package/src/note_decryption_utils/add_public_values_to_payload.ts +0 -64
  549. package/src/pxe_http/index.ts +0 -1
  550. package/src/pxe_http/pxe_http_server.ts +0 -29
  551. package/src/pxe_oracle_interface/index.ts +0 -925
  552. package/src/pxe_oracle_interface/tagging_utils.ts +0 -32
  553. package/src/pxe_service/index.ts +0 -2
  554. package/src/pxe_service/pxe_service.ts +0 -949
  555. package/src/storage/address_data_provider/index.ts +0 -1
  556. package/src/storage/auth_witness_data_provider/auth_witness_data_provider.ts +0 -34
  557. package/src/storage/auth_witness_data_provider/index.ts +0 -1
  558. package/src/storage/capsule_data_provider/capsule_data_provider.ts +0 -80
  559. package/src/storage/capsule_data_provider/index.ts +0 -1
  560. package/src/storage/contract_data_provider/contract_data_provider.ts +0 -261
  561. package/src/storage/contract_data_provider/index.ts +0 -2
  562. package/src/storage/contract_data_provider/private_functions_tree.ts +0 -131
  563. package/src/storage/data_provider.ts +0 -3
  564. package/src/storage/note_data_provider/index.ts +0 -2
  565. package/src/storage/note_data_provider/note_dao.ts +0 -162
  566. package/src/storage/note_data_provider/note_data_provider.ts +0 -345
  567. package/src/storage/sync_data_provider/index.ts +0 -1
  568. package/src/storage/sync_data_provider/sync_data_provider.ts +0 -40
  569. package/src/storage/tagging_data_provider/index.ts +0 -1
  570. package/src/storage/tagging_data_provider/tagging_data_provider.ts +0 -92
  571. package/src/synchronizer/index.ts +0 -1
  572. package/src/synchronizer/synchronizer.ts +0 -121
  573. package/src/test/pxe_test_suite.ts +0 -111
@@ -0,0 +1,598 @@
1
+ import { MAX_APPS_PER_KERNEL } from '@aztec/constants';
2
+ import { uniqueBy } from '@aztec/foundation/collection';
3
+ import { vkAsFieldsMegaHonk } from '@aztec/foundation/crypto/keys';
4
+ import { Fr } from '@aztec/foundation/curves/bn254';
5
+ import { type Logger, type LoggerBindings, createLogger } from '@aztec/foundation/log';
6
+ import { pushTestData } from '@aztec/foundation/testing';
7
+ import { Timer } from '@aztec/foundation/timer';
8
+ import { getVKTreeRoot } from '@aztec/noir-protocol-circuits-types/vk-tree';
9
+ import { ProtocolContractsList } from '@aztec/protocol-contracts';
10
+ import { AztecAddress } from '@aztec/stdlib/aztec-address';
11
+ import type { PrivateKernelProver } from '@aztec/stdlib/interfaces/client';
12
+ import {
13
+ HidingKernelToPublicPrivateInputs,
14
+ HidingKernelToRollupPrivateInputs,
15
+ PaddedSideEffectAmounts,
16
+ PrivateCallData,
17
+ type PrivateExecutionStep,
18
+ PrivateKernelCircuitPublicInputs,
19
+ PrivateKernelData,
20
+ type PrivateKernelExecutionProofOutput,
21
+ PrivateKernelInit2CircuitPrivateInputs,
22
+ PrivateKernelInit3CircuitPrivateInputs,
23
+ PrivateKernelInitCircuitPrivateInputs,
24
+ PrivateKernelInner2CircuitPrivateInputs,
25
+ PrivateKernelInner3CircuitPrivateInputs,
26
+ PrivateKernelInnerCircuitPrivateInputs,
27
+ type PrivateKernelSimulateOutput,
28
+ PrivateKernelTailCircuitPrivateInputs,
29
+ type PrivateKernelTailCircuitPublicInputs,
30
+ PrivateVerificationKeyHints,
31
+ type UpdatedClassIdHints,
32
+ } from '@aztec/stdlib/kernel';
33
+ import { ChonkProof, ChonkProofWithPublicInputs } from '@aztec/stdlib/proofs';
34
+ import {
35
+ type PrivateCallExecutionResult,
36
+ type PrivateExecutionResult,
37
+ TxRequest,
38
+ collectNested,
39
+ collectNoteHashNullifierCounterMap,
40
+ getFinalMinRevertibleSideEffectCounter,
41
+ } from '@aztec/stdlib/tx';
42
+ import { VerificationKeyAsFields, VerificationKeyData, VkData } from '@aztec/stdlib/vks';
43
+
44
+ import { BatchPlanner } from './batch_planner.js';
45
+ import { computeTxExpirationTimestamp } from './hints/compute_tx_expiration_timestamp.js';
46
+ import { PrivateKernelResetPrivateInputsBuilder } from './hints/private_kernel_reset_private_inputs_builder.js';
47
+ import type { PrivateKernelOracle } from './private_kernel_oracle.js';
48
+
49
+ const NULL_SIMULATE_OUTPUT: PrivateKernelSimulateOutput<PrivateKernelCircuitPublicInputs> = {
50
+ publicInputs: PrivateKernelCircuitPublicInputs.empty(),
51
+ verificationKey: VerificationKeyData.empty(),
52
+ outputWitness: new Map(),
53
+ bytecode: Buffer.from([]),
54
+ };
55
+
56
+ export interface PrivateKernelExecutionProverConfig {
57
+ simulate: boolean;
58
+ skipFeeEnforcement: boolean;
59
+ profileMode: 'gates' | 'execution-steps' | 'full' | 'none';
60
+ }
61
+
62
+ /**
63
+ * The PrivateKernelExecutionProver class is responsible for taking a transaction request and sequencing the
64
+ * the execution of the private functions within, sequenced with private kernel "glue" to check protocol rules.
65
+ * The result can be a chonk proof of the private transaction portion, or just a simulation that can e.g.
66
+ * inform state tree updates.
67
+ */
68
+ export class PrivateKernelExecutionProver {
69
+ private log: Logger;
70
+
71
+ constructor(
72
+ private oracle: PrivateKernelOracle,
73
+ private proofCreator: PrivateKernelProver,
74
+ private fakeProofs = false,
75
+ bindings?: LoggerBindings,
76
+ private maxBatchSize: number = MAX_APPS_PER_KERNEL,
77
+ ) {
78
+ this.log = createLogger('pxe:private-kernel-execution-prover', bindings);
79
+ }
80
+
81
+ /**
82
+ * Generate a proof for a given transaction request and execution result.
83
+ * The function iterates through the nested executions in the execution result, creates private call data,
84
+ * and generates a proof using the provided ProofCreator instance. It also maintains an index of new notes
85
+ * created during the execution and returns them as a part of the KernelProverOutput.
86
+ *
87
+ * @param txRequest - The authenticated transaction request object.
88
+ * @param executionResult - The execution result object containing nested executions and preimages.
89
+ * @param profile - Set true to profile the gate count for each circuit
90
+ * @returns A Promise that resolves to a KernelProverOutput object containing proof, public inputs, and output notes.
91
+ */
92
+ async proveWithKernels(
93
+ txRequest: TxRequest,
94
+ executionResult: PrivateExecutionResult,
95
+ { simulate, skipFeeEnforcement, profileMode }: PrivateKernelExecutionProverConfig = {
96
+ simulate: false,
97
+ skipFeeEnforcement: false,
98
+ profileMode: 'none',
99
+ },
100
+ ): Promise<PrivateKernelExecutionProofOutput<PrivateKernelTailCircuitPublicInputs>> {
101
+ const skipProofGeneration = this.fakeProofs || simulate;
102
+ const generateWitnesses = !skipProofGeneration || profileMode !== 'none';
103
+
104
+ const timer = new Timer();
105
+
106
+ const isPrivateOnlyTx = executionResult.publicFunctionCalldata.length === 0;
107
+
108
+ // Initialize an executionStack, beginning with the PrivateCallExecutionResult
109
+ // of the entrypoint function of the tx.
110
+ const executionStack = [executionResult.entrypoint];
111
+ let firstIteration = true;
112
+
113
+ let output = NULL_SIMULATE_OUTPUT;
114
+
115
+ const executionSteps: PrivateExecutionStep[] = [];
116
+
117
+ const noteHashNullifierCounterMap = collectNoteHashNullifierCounterMap(executionResult);
118
+ const minRevertibleSideEffectCounter = getFinalMinRevertibleSideEffectCounter(executionResult);
119
+ const splitCounter = isPrivateOnlyTx ? 0 : minRevertibleSideEffectCounter;
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
+
128
+ while (executionStack.length) {
129
+ if (!firstIteration) {
130
+ let resetBuilder = new PrivateKernelResetPrivateInputsBuilder(
131
+ output,
132
+ executionStack,
133
+ noteHashNullifierCounterMap,
134
+ splitCounter,
135
+ );
136
+ while (resetBuilder.needsReset()) {
137
+ // Inner reset: without siloing.
138
+ const witgenTimer = new Timer();
139
+ const privateInputs = await resetBuilder.build(this.oracle);
140
+ output = generateWitnesses
141
+ ? await this.proofCreator.generateResetOutput(privateInputs)
142
+ : await this.proofCreator.simulateReset(privateInputs);
143
+ executionSteps.push({
144
+ functionName: 'private_kernel_reset',
145
+ bytecode: output.bytecode,
146
+ witness: output.outputWitness,
147
+ vk: output.verificationKey.keyAsBytes,
148
+ timings: {
149
+ witgen: witgenTimer.ms(),
150
+ },
151
+ });
152
+ resetBuilder = new PrivateKernelResetPrivateInputsBuilder(
153
+ output,
154
+ executionStack,
155
+ noteHashNullifierCounterMap,
156
+ splitCounter,
157
+ );
158
+ }
159
+ }
160
+
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
+ }
166
+
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,
177
+ });
178
+
179
+ firstIteration = false;
180
+ }
181
+
182
+ // Final reset: include siloing of note hashes, nullifiers and private logs.
183
+ const finalResetBuilder = new PrivateKernelResetPrivateInputsBuilder(
184
+ output,
185
+ [],
186
+ noteHashNullifierCounterMap,
187
+ splitCounter,
188
+ );
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 {
198
+ const witgenTimer = new Timer();
199
+ const privateInputs = await finalResetBuilder.build(this.oracle);
200
+ output = generateWitnesses
201
+ ? await this.proofCreator.generateResetOutput(privateInputs)
202
+ : await this.proofCreator.simulateReset(privateInputs);
203
+
204
+ executionSteps.push({
205
+ functionName: 'private_kernel_reset',
206
+ bytecode: output.bytecode,
207
+ witness: output.outputWitness,
208
+ vk: output.verificationKey.keyAsBytes,
209
+ timings: {
210
+ witgen: witgenTimer.ms(),
211
+ },
212
+ });
213
+ }
214
+
215
+ if (output.publicInputs.feePayer.isZero() && skipFeeEnforcement) {
216
+ if (!skipProofGeneration) {
217
+ throw new Error('Fee payment must be enforced when creating real proof.');
218
+ }
219
+ output.publicInputs.feePayer = new AztecAddress(Fr.MAX_FIELD_VALUE);
220
+ }
221
+ // Private tail.
222
+ const vkData = await this.getVkData(output.verificationKey);
223
+ const previousKernelData = new PrivateKernelData(output.publicInputs, vkData);
224
+
225
+ this.log.debug(
226
+ `Calling private kernel tail with hwm ${previousKernelData.publicInputs.minRevertibleSideEffectCounter}`,
227
+ );
228
+
229
+ // TODO: Enable padding once we better understand the final amounts to pad to.
230
+ const paddedSideEffectAmounts = PaddedSideEffectAmounts.empty();
231
+
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);
235
+
236
+ const privateInputs = new PrivateKernelTailCircuitPrivateInputs(
237
+ previousKernelData,
238
+ paddedSideEffectAmounts,
239
+ expirationTimestampUpperBound,
240
+ );
241
+
242
+ const witgenTimer = new Timer();
243
+ const tailOutput = generateWitnesses
244
+ ? await this.proofCreator.generateTailOutput(privateInputs)
245
+ : await this.proofCreator.simulateTail(privateInputs);
246
+
247
+ executionSteps.push({
248
+ functionName: 'private_kernel_tail',
249
+ bytecode: tailOutput.bytecode,
250
+ witness: tailOutput.outputWitness,
251
+ vk: tailOutput.verificationKey.keyAsBytes,
252
+ timings: {
253
+ witgen: witgenTimer.ms(),
254
+ },
255
+ });
256
+
257
+ // Hiding kernel is only executed if we are generating witnesses.
258
+ // For simulation, we can end with the tail, since the Hiding kernel will simply return the same tail output.
259
+ if (generateWitnesses) {
260
+ const previousKernelVkData = await this.getVkData(tailOutput.verificationKey);
261
+
262
+ const witgenTimer = new Timer();
263
+ let hidingOutput: PrivateKernelSimulateOutput<PrivateKernelTailCircuitPublicInputs>;
264
+ if (tailOutput.publicInputs.forPublic) {
265
+ const privateInputs = new HidingKernelToPublicPrivateInputs(
266
+ tailOutput.publicInputs.toPrivateToPublicKernelCircuitPublicInputs(),
267
+ previousKernelVkData,
268
+ );
269
+ hidingOutput = await this.proofCreator.generateHidingToPublicOutput(privateInputs);
270
+ } else {
271
+ const privateInputs = new HidingKernelToRollupPrivateInputs(
272
+ tailOutput.publicInputs.toPrivateToRollupKernelCircuitPublicInputs(),
273
+ previousKernelVkData,
274
+ );
275
+ hidingOutput = await this.proofCreator.generateHidingToRollupOutput(privateInputs);
276
+ }
277
+
278
+ executionSteps.push({
279
+ functionName: 'hiding_kernel',
280
+ bytecode: hidingOutput.bytecode,
281
+ witness: hidingOutput.outputWitness,
282
+ vk: hidingOutput.verificationKey.keyAsBytes,
283
+ timings: {
284
+ witgen: witgenTimer.ms(),
285
+ },
286
+ });
287
+ }
288
+
289
+ if (profileMode == 'gates' || profileMode == 'full') {
290
+ for (const entry of executionSteps) {
291
+ const gateCountTimer = new Timer();
292
+ const gateCount = await this.proofCreator.computeGateCountForCircuit(entry.bytecode, entry.functionName);
293
+ entry.gateCount = gateCount;
294
+ entry.timings.gateCount = gateCountTimer.ms();
295
+ }
296
+ }
297
+ if (profileMode === 'gates') {
298
+ for (const entry of executionSteps) {
299
+ // These buffers are often a few megabytes in size - prevent accidentally serializing them if not requested.
300
+ entry.bytecode = Buffer.from([]);
301
+ entry.witness = new Map();
302
+ }
303
+ }
304
+
305
+ if (generateWitnesses) {
306
+ this.log.info(`Private kernel witness generation took ${timer.ms()}ms`);
307
+ }
308
+
309
+ let chonkProof: ChonkProof;
310
+ // TODO(#7368) how do we 'bincode' encode these inputs?
311
+ let provingTime;
312
+ if (!skipProofGeneration) {
313
+ const provingTimer = new Timer();
314
+ const proofWithPublicInputs = await this.proofCreator.createChonkProof(executionSteps);
315
+ provingTime = provingTimer.ms();
316
+ this.ensurePublicInputsMatch(proofWithPublicInputs, tailOutput.publicInputs);
317
+ chonkProof = proofWithPublicInputs.removePublicInputs();
318
+ } else {
319
+ chonkProof = ChonkProof.random();
320
+ }
321
+
322
+ return {
323
+ publicInputs: tailOutput.publicInputs,
324
+ executionSteps,
325
+ chonkProof,
326
+ timings: provingTime ? { proving: provingTime } : undefined,
327
+ };
328
+ }
329
+
330
+ /**
331
+ * Checks that the public inputs of the chonk proof match the public inputs of the tail circuit.
332
+ * This can only mismatch if there is a circuit / noir / bb bug.
333
+ * @param chonkProof - The chonk proof with public inputs.
334
+ * @param tailPublicInputs - The public inputs resulting from witness generation of the tail circuit.
335
+ */
336
+ private ensurePublicInputsMatch(
337
+ chonkProof: ChonkProofWithPublicInputs,
338
+ tailPublicInputs: PrivateKernelTailCircuitPublicInputs,
339
+ ) {
340
+ const serializedChonkProofPublicInputs = chonkProof.getPublicInputs();
341
+ const serializedTailPublicInputs = tailPublicInputs.publicInputs().toFields();
342
+ if (serializedChonkProofPublicInputs.length !== serializedTailPublicInputs.length) {
343
+ throw new Error(
344
+ `Public inputs length mismatch: ${serializedChonkProofPublicInputs.length} !== ${serializedTailPublicInputs.length}`,
345
+ );
346
+ }
347
+ if (
348
+ !serializedChonkProofPublicInputs.every((input: Fr, index: number) =>
349
+ input.equals(serializedTailPublicInputs[index]),
350
+ )
351
+ ) {
352
+ throw new Error(`Public inputs mismatch between kernel and chonk proof`);
353
+ }
354
+ }
355
+
356
+ private async getVkData(verificationKey: VerificationKeyData) {
357
+ const previousVkMembershipWitness = await this.oracle.getVkMembershipWitness(verificationKey.keyAsFields);
358
+ return new VkData(
359
+ verificationKey,
360
+ Number(previousVkMembershipWitness.leafIndex),
361
+ previousVkMembershipWitness.siblingPath,
362
+ );
363
+ }
364
+
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
+ ) {
419
+ const { contractAddress, functionSelector } = publicInputs.callContext;
420
+
421
+ const vkAsFields = await vkAsFieldsMegaHonk(vkAsBuffer);
422
+ const vk = await VerificationKeyAsFields.fromKey(vkAsFields);
423
+
424
+ const { currentContractClassId, publicKeys, saltedInitializationHash } =
425
+ await this.oracle.getContractAddressPreimage(contractAddress);
426
+ const functionLeafMembershipWitness = await this.oracle.getFunctionMembershipWitness(
427
+ currentContractClassId,
428
+ functionSelector,
429
+ );
430
+
431
+ const { artifactHash: contractClassArtifactHash, publicBytecodeCommitment: contractClassPublicBytecodeCommitment } =
432
+ await this.oracle.getContractClassIdPreimage(currentContractClassId);
433
+
434
+ const updatedClassIdHints = updatedClassIdHintsMap.get(contractAddress.toString())!;
435
+
436
+ return PrivateCallData.from({
437
+ publicInputs,
438
+ vk,
439
+ verificationKeyHints: PrivateVerificationKeyHints.from({
440
+ publicKeys,
441
+ contractClassArtifactHash,
442
+ contractClassPublicBytecodeCommitment,
443
+ saltedInitializationHash,
444
+ functionLeafMembershipWitness,
445
+ updatedClassIdHints,
446
+ }),
447
+ });
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
+ }
598
+ }