@aztec/stdlib 0.0.1-commit.1142ef1 → 0.0.1-commit.18ccd8f0

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 (459) hide show
  1. package/dest/abi/function_call.d.ts +9 -1
  2. package/dest/abi/function_call.d.ts.map +1 -1
  3. package/dest/abi/utils.d.ts +7 -1
  4. package/dest/abi/utils.d.ts.map +1 -1
  5. package/dest/abi/utils.js +7 -0
  6. package/dest/auth_witness/auth_witness.d.ts +2 -1
  7. package/dest/auth_witness/auth_witness.d.ts.map +1 -1
  8. package/dest/avm/avm.d.ts +62 -62
  9. package/dest/avm/avm_accumulated_data.d.ts +30 -3
  10. package/dest/avm/avm_accumulated_data.d.ts.map +1 -1
  11. package/dest/avm/avm_circuit_public_inputs.d.ts +9 -9
  12. package/dest/avm/avm_proving_request.d.ts +299 -299
  13. package/dest/avm/contract_storage_read.d.ts +13 -1
  14. package/dest/avm/contract_storage_read.d.ts.map +1 -1
  15. package/dest/avm/contract_storage_update_request.d.ts +13 -1
  16. package/dest/avm/contract_storage_update_request.d.ts.map +1 -1
  17. package/dest/avm/public_call_stack_item_compressed.d.ts +3 -1
  18. package/dest/avm/public_call_stack_item_compressed.d.ts.map +1 -1
  19. package/dest/avm/public_data_read.d.ts +10 -1
  20. package/dest/avm/public_data_read.d.ts.map +1 -1
  21. package/dest/avm/public_data_update_request.d.ts +10 -1
  22. package/dest/avm/public_data_update_request.d.ts.map +1 -1
  23. package/dest/avm/public_data_write.d.ts +7 -1
  24. package/dest/avm/public_data_write.d.ts.map +1 -1
  25. package/dest/avm/public_inner_call_request.d.ts +4 -1
  26. package/dest/avm/public_inner_call_request.d.ts.map +1 -1
  27. package/dest/avm/revert_code.d.ts +4 -4
  28. package/dest/avm/revert_code.d.ts.map +1 -1
  29. package/dest/block/block_hash.d.ts +16 -9
  30. package/dest/block/block_hash.d.ts.map +1 -1
  31. package/dest/block/block_hash.js +23 -8
  32. package/dest/block/block_parameter.d.ts +4 -3
  33. package/dest/block/block_parameter.d.ts.map +1 -1
  34. package/dest/block/block_parameter.js +2 -0
  35. package/dest/block/body.d.ts +1 -1
  36. package/dest/block/body.d.ts.map +1 -1
  37. package/dest/block/body.js +2 -1
  38. package/dest/block/checkpointed_l2_block.d.ts +20 -137
  39. package/dest/block/checkpointed_l2_block.d.ts.map +1 -1
  40. package/dest/block/checkpointed_l2_block.js +7 -45
  41. package/dest/block/in_block.d.ts +8 -8
  42. package/dest/block/in_block.d.ts.map +1 -1
  43. package/dest/block/in_block.js +4 -4
  44. package/dest/block/index.d.ts +1 -3
  45. package/dest/block/index.d.ts.map +1 -1
  46. package/dest/block/index.js +0 -2
  47. package/dest/block/l2_block.d.ts +55 -59
  48. package/dest/block/l2_block.d.ts.map +1 -1
  49. package/dest/block/l2_block.js +64 -109
  50. package/dest/block/l2_block_source.d.ts +63 -38
  51. package/dest/block/l2_block_source.d.ts.map +1 -1
  52. package/dest/block/l2_block_source.js +2 -1
  53. package/dest/block/l2_block_stream/interfaces.d.ts +9 -6
  54. package/dest/block/l2_block_stream/interfaces.d.ts.map +1 -1
  55. package/dest/block/l2_block_stream/l2_block_stream.d.ts +6 -3
  56. package/dest/block/l2_block_stream/l2_block_stream.d.ts.map +1 -1
  57. package/dest/block/l2_block_stream/l2_block_stream.js +37 -34
  58. package/dest/block/l2_block_stream/l2_tips_store_base.d.ts +3 -3
  59. package/dest/block/l2_block_stream/l2_tips_store_base.d.ts.map +1 -1
  60. package/dest/block/test/l2_tips_store_test_suite.d.ts +1 -1
  61. package/dest/block/test/l2_tips_store_test_suite.d.ts.map +1 -1
  62. package/dest/block/test/l2_tips_store_test_suite.js +2 -7
  63. package/dest/block/validate_block_result.d.ts +1 -1
  64. package/dest/block/validate_block_result.d.ts.map +1 -1
  65. package/dest/block/validate_block_result.js +5 -4
  66. package/dest/checkpoint/checkpoint.d.ts +30 -20
  67. package/dest/checkpoint/checkpoint.d.ts.map +1 -1
  68. package/dest/checkpoint/checkpoint.js +18 -6
  69. package/dest/checkpoint/published_checkpoint.d.ts +17 -15
  70. package/dest/checkpoint/published_checkpoint.d.ts.map +1 -1
  71. package/dest/checkpoint/published_checkpoint.js +4 -3
  72. package/dest/config/node-rpc-config.js +1 -1
  73. package/dest/contract/complete_address.d.ts +4 -1
  74. package/dest/contract/complete_address.d.ts.map +1 -1
  75. package/dest/contract/contract_address.js +1 -1
  76. package/dest/contract/contract_class_id.d.ts +1 -1
  77. package/dest/contract/contract_class_id.js +1 -1
  78. package/dest/contract/contract_deployment_data.d.ts +5 -5
  79. package/dest/contract/index.d.ts +1 -3
  80. package/dest/contract/index.d.ts.map +1 -1
  81. package/dest/contract/index.js +0 -2
  82. package/dest/contract/interfaces/contract_instance.d.ts +16 -16
  83. package/dest/contract/private_function.d.ts +1 -1
  84. package/dest/contract/private_function.d.ts.map +1 -1
  85. package/dest/contract/private_function.js +2 -3
  86. package/dest/contract/private_function_membership_proof.d.ts +1 -1
  87. package/dest/contract/private_function_membership_proof.js +1 -1
  88. package/dest/database-version/version_manager.d.ts +4 -2
  89. package/dest/database-version/version_manager.d.ts.map +1 -1
  90. package/dest/delayed_public_mutable/delayed_public_mutable_values.d.ts +2 -2
  91. package/dest/delayed_public_mutable/delayed_public_mutable_values.d.ts.map +1 -1
  92. package/dest/delayed_public_mutable/delayed_public_mutable_values.js +7 -10
  93. package/dest/deserialization/index.d.ts +11 -0
  94. package/dest/deserialization/index.d.ts.map +1 -0
  95. package/dest/deserialization/index.js +10 -0
  96. package/dest/epoch-helpers/index.d.ts +3 -1
  97. package/dest/epoch-helpers/index.d.ts.map +1 -1
  98. package/dest/epoch-helpers/index.js +5 -1
  99. package/dest/errors/proving_error.d.ts +2 -2
  100. package/dest/errors/proving_error.d.ts.map +1 -1
  101. package/dest/hash/hash.js +2 -2
  102. package/dest/hash/map_slot.d.ts +1 -1
  103. package/dest/hash/map_slot.d.ts.map +1 -1
  104. package/dest/hash/map_slot.js +4 -3
  105. package/dest/interfaces/api_limit.d.ts +2 -1
  106. package/dest/interfaces/api_limit.d.ts.map +1 -1
  107. package/dest/interfaces/api_limit.js +1 -0
  108. package/dest/interfaces/archiver.d.ts +1 -1
  109. package/dest/interfaces/archiver.d.ts.map +1 -1
  110. package/dest/interfaces/archiver.js +16 -14
  111. package/dest/interfaces/aztec-node-admin.d.ts +56 -26
  112. package/dest/interfaces/aztec-node-admin.d.ts.map +1 -1
  113. package/dest/interfaces/aztec-node.d.ts +61 -43
  114. package/dest/interfaces/aztec-node.d.ts.map +1 -1
  115. package/dest/interfaces/aztec-node.js +7 -9
  116. package/dest/interfaces/block-builder.d.ts +17 -14
  117. package/dest/interfaces/block-builder.d.ts.map +1 -1
  118. package/dest/interfaces/configs.d.ts +8 -8
  119. package/dest/interfaces/configs.d.ts.map +1 -1
  120. package/dest/interfaces/get_logs_response.d.ts +3 -3
  121. package/dest/interfaces/l2_logs_source.d.ts +14 -5
  122. package/dest/interfaces/l2_logs_source.d.ts.map +1 -1
  123. package/dest/interfaces/prover-client.d.ts +10 -1
  124. package/dest/interfaces/prover-client.d.ts.map +1 -1
  125. package/dest/interfaces/prover-client.js +7 -1
  126. package/dest/interfaces/proving-job.d.ts +14 -14
  127. package/dest/interfaces/tx_provider.d.ts +3 -3
  128. package/dest/interfaces/tx_provider.d.ts.map +1 -1
  129. package/dest/interfaces/validator.d.ts +70 -14
  130. package/dest/interfaces/validator.d.ts.map +1 -1
  131. package/dest/interfaces/validator.js +2 -2
  132. package/dest/kernel/hints/build_note_hash_read_request_hints.d.ts +1 -1
  133. package/dest/kernel/hints/build_note_hash_read_request_hints.d.ts.map +1 -1
  134. package/dest/kernel/hints/build_note_hash_read_request_hints.js +16 -6
  135. package/dest/kernel/hints/build_nullifier_read_request_hints.d.ts +3 -3
  136. package/dest/kernel/hints/build_nullifier_read_request_hints.d.ts.map +1 -1
  137. package/dest/kernel/hints/build_nullifier_read_request_hints.js +16 -8
  138. package/dest/kernel/hints/key_validation_hint.d.ts +2 -1
  139. package/dest/kernel/hints/key_validation_hint.d.ts.map +1 -1
  140. package/dest/kernel/hints/key_validation_request.d.ts +2 -1
  141. package/dest/kernel/hints/key_validation_request.d.ts.map +1 -1
  142. package/dest/kernel/hints/key_validation_request_and_generator.d.ts +6 -1
  143. package/dest/kernel/hints/key_validation_request_and_generator.d.ts.map +1 -1
  144. package/dest/kernel/hints/private_kernel_reset_hints.d.ts +13 -1
  145. package/dest/kernel/hints/private_kernel_reset_hints.d.ts.map +1 -1
  146. package/dest/kernel/hints/read_request.d.ts +7 -1
  147. package/dest/kernel/hints/read_request.d.ts.map +1 -1
  148. package/dest/kernel/hints/read_request_hints.d.ts +7 -1
  149. package/dest/kernel/hints/read_request_hints.d.ts.map +1 -1
  150. package/dest/kernel/private_accumulated_data.d.ts +23 -1
  151. package/dest/kernel/private_accumulated_data.d.ts.map +1 -1
  152. package/dest/kernel/private_call_data.d.ts +25 -1
  153. package/dest/kernel/private_call_data.d.ts.map +1 -1
  154. package/dest/kernel/private_call_request.d.ts +16 -1
  155. package/dest/kernel/private_call_request.d.ts.map +1 -1
  156. package/dest/kernel/private_circuit_public_inputs.d.ts +74 -1
  157. package/dest/kernel/private_circuit_public_inputs.d.ts.map +1 -1
  158. package/dest/kernel/private_kernel_circuit_public_inputs.d.ts +31 -1
  159. package/dest/kernel/private_kernel_circuit_public_inputs.d.ts.map +1 -1
  160. package/dest/kernel/private_kernel_data.d.ts +7 -1
  161. package/dest/kernel/private_kernel_data.d.ts.map +1 -1
  162. package/dest/kernel/private_kernel_init_circuit_private_inputs.d.ts +22 -1
  163. package/dest/kernel/private_kernel_init_circuit_private_inputs.d.ts.map +1 -1
  164. package/dest/kernel/private_kernel_inner_circuit_private_inputs.d.ts +7 -1
  165. package/dest/kernel/private_kernel_inner_circuit_private_inputs.d.ts.map +1 -1
  166. package/dest/kernel/private_kernel_reset_circuit_private_inputs.d.ts +4 -1
  167. package/dest/kernel/private_kernel_reset_circuit_private_inputs.d.ts.map +1 -1
  168. package/dest/kernel/private_kernel_tail_circuit_private_inputs.d.ts +10 -1
  169. package/dest/kernel/private_kernel_tail_circuit_private_inputs.d.ts.map +1 -1
  170. package/dest/kernel/private_kernel_tail_circuit_public_inputs.d.ts +23 -1
  171. package/dest/kernel/private_kernel_tail_circuit_public_inputs.d.ts.map +1 -1
  172. package/dest/kernel/private_to_avm_accumulated_data.d.ts +2 -2
  173. package/dest/kernel/private_to_rollup_accumulated_data.d.ts +17 -1
  174. package/dest/kernel/private_to_rollup_accumulated_data.d.ts.map +1 -1
  175. package/dest/kernel/private_to_rollup_kernel_circuit_public_inputs.d.ts +16 -1
  176. package/dest/kernel/private_to_rollup_kernel_circuit_public_inputs.d.ts.map +1 -1
  177. package/dest/kernel/private_validation_requests.d.ts +10 -1
  178. package/dest/kernel/private_validation_requests.d.ts.map +1 -1
  179. package/dest/kernel/public_call_request.d.ts +22 -1
  180. package/dest/kernel/public_call_request.d.ts.map +1 -1
  181. package/dest/kernel/utils/optional_number.d.ts +7 -1
  182. package/dest/kernel/utils/optional_number.d.ts.map +1 -1
  183. package/dest/keys/public_keys.d.ts +5 -1
  184. package/dest/keys/public_keys.d.ts.map +1 -1
  185. package/dest/logs/extended_contract_class_log.d.ts +3 -1
  186. package/dest/logs/extended_contract_class_log.d.ts.map +1 -1
  187. package/dest/logs/extended_public_log.d.ts +7 -5
  188. package/dest/logs/extended_public_log.d.ts.map +1 -1
  189. package/dest/logs/log_id.d.ts +10 -6
  190. package/dest/logs/log_id.d.ts.map +1 -1
  191. package/dest/logs/log_id.js +5 -5
  192. package/dest/logs/siloed_tag.d.ts +1 -1
  193. package/dest/logs/siloed_tag.d.ts.map +1 -1
  194. package/dest/logs/siloed_tag.js +4 -3
  195. package/dest/messaging/inbox_leaf.d.ts +3 -1
  196. package/dest/messaging/inbox_leaf.d.ts.map +1 -1
  197. package/dest/messaging/l1_actor.d.ts +7 -1
  198. package/dest/messaging/l1_actor.d.ts.map +1 -1
  199. package/dest/messaging/l1_to_l2_message.d.ts +6 -1
  200. package/dest/messaging/l1_to_l2_message.d.ts.map +1 -1
  201. package/dest/messaging/l2_actor.d.ts +7 -1
  202. package/dest/messaging/l2_actor.d.ts.map +1 -1
  203. package/dest/messaging/l2_to_l1_membership.d.ts +1 -1
  204. package/dest/messaging/l2_to_l1_membership.d.ts.map +1 -1
  205. package/dest/messaging/l2_to_l1_membership.js +5 -3
  206. package/dest/messaging/out_hash.d.ts +41 -4
  207. package/dest/messaging/out_hash.d.ts.map +1 -1
  208. package/dest/messaging/out_hash.js +52 -26
  209. package/dest/note/note_dao.d.ts +36 -5
  210. package/dest/note/note_dao.d.ts.map +1 -1
  211. package/dest/note/note_dao.js +15 -12
  212. package/dest/p2p/block_proposal.d.ts +23 -8
  213. package/dest/p2p/block_proposal.d.ts.map +1 -1
  214. package/dest/p2p/block_proposal.js +25 -7
  215. package/dest/p2p/checkpoint_attestation.d.ts +5 -1
  216. package/dest/p2p/checkpoint_attestation.d.ts.map +1 -1
  217. package/dest/p2p/checkpoint_proposal.d.ts +20 -7
  218. package/dest/p2p/checkpoint_proposal.d.ts.map +1 -1
  219. package/dest/p2p/checkpoint_proposal.js +17 -5
  220. package/dest/p2p/consensus_payload.d.ts +4 -3
  221. package/dest/p2p/consensus_payload.d.ts.map +1 -1
  222. package/dest/p2p/consensus_payload.js +0 -3
  223. package/dest/p2p/constants.d.ts +3 -0
  224. package/dest/p2p/constants.d.ts.map +1 -0
  225. package/dest/p2p/constants.js +2 -0
  226. package/dest/p2p/index.d.ts +2 -1
  227. package/dest/p2p/index.d.ts.map +1 -1
  228. package/dest/p2p/index.js +1 -0
  229. package/dest/p2p/message_validator.d.ts +18 -3
  230. package/dest/p2p/message_validator.d.ts.map +1 -1
  231. package/dest/p2p/message_validator.js +2 -1
  232. package/dest/p2p/signed_txs.d.ts +3 -1
  233. package/dest/p2p/signed_txs.d.ts.map +1 -1
  234. package/dest/p2p/signed_txs.js +6 -1
  235. package/dest/p2p/topic_type.js +2 -1
  236. package/dest/parity/parity_base_private_inputs.d.ts +3 -1
  237. package/dest/parity/parity_base_private_inputs.d.ts.map +1 -1
  238. package/dest/parity/parity_public_inputs.d.ts +4 -1
  239. package/dest/parity/parity_public_inputs.d.ts.map +1 -1
  240. package/dest/parity/parity_root_private_inputs.d.ts +2 -1
  241. package/dest/parity/parity_root_private_inputs.d.ts.map +1 -1
  242. package/dest/proofs/chonk_proof.d.ts +1 -1
  243. package/dest/proofs/chonk_proof.d.ts.map +1 -1
  244. package/dest/proofs/chonk_proof.js +9 -4
  245. package/dest/proofs/proof.d.ts +4 -1
  246. package/dest/proofs/proof.d.ts.map +1 -1
  247. package/dest/proofs/recursive_proof.d.ts +10 -1
  248. package/dest/proofs/recursive_proof.d.ts.map +1 -1
  249. package/dest/rollup/base_rollup_hints.d.ts +34 -1
  250. package/dest/rollup/base_rollup_hints.d.ts.map +1 -1
  251. package/dest/rollup/block_constant_data.d.ts +12 -1
  252. package/dest/rollup/block_constant_data.d.ts.map +1 -1
  253. package/dest/rollup/block_headers_hash.js +1 -1
  254. package/dest/rollup/block_merge_rollup_private_inputs.d.ts +4 -1
  255. package/dest/rollup/block_merge_rollup_private_inputs.d.ts.map +1 -1
  256. package/dest/rollup/block_rollup_public_inputs.d.ts +44 -3
  257. package/dest/rollup/block_rollup_public_inputs.d.ts.map +1 -1
  258. package/dest/rollup/block_rollup_public_inputs.js +2 -2
  259. package/dest/rollup/block_root_rollup_private_inputs.d.ts +64 -1
  260. package/dest/rollup/block_root_rollup_private_inputs.d.ts.map +1 -1
  261. package/dest/rollup/checkpoint_constant_data.d.ts +10 -1
  262. package/dest/rollup/checkpoint_constant_data.d.ts.map +1 -1
  263. package/dest/rollup/checkpoint_header.d.ts +29 -2
  264. package/dest/rollup/checkpoint_header.d.ts.map +1 -1
  265. package/dest/rollup/checkpoint_header.js +21 -5
  266. package/dest/rollup/checkpoint_merge_rollup_private_inputs.d.ts +4 -1
  267. package/dest/rollup/checkpoint_merge_rollup_private_inputs.d.ts.map +1 -1
  268. package/dest/rollup/checkpoint_rollup_public_inputs.d.ts +41 -6
  269. package/dest/rollup/checkpoint_rollup_public_inputs.d.ts.map +1 -1
  270. package/dest/rollup/checkpoint_rollup_public_inputs.js +10 -6
  271. package/dest/rollup/checkpoint_root_rollup_private_inputs.d.ts +44 -3
  272. package/dest/rollup/checkpoint_root_rollup_private_inputs.d.ts.map +1 -1
  273. package/dest/rollup/checkpoint_root_rollup_private_inputs.js +13 -2
  274. package/dest/rollup/epoch_constant_data.d.ts +16 -1
  275. package/dest/rollup/epoch_constant_data.d.ts.map +1 -1
  276. package/dest/rollup/root_rollup_private_inputs.d.ts +6 -1
  277. package/dest/rollup/root_rollup_private_inputs.d.ts.map +1 -1
  278. package/dest/rollup/root_rollup_public_inputs.d.ts +12 -2
  279. package/dest/rollup/root_rollup_public_inputs.d.ts.map +1 -1
  280. package/dest/rollup/root_rollup_public_inputs.js +4 -1
  281. package/dest/rollup/tree_snapshot_diff_hints.d.ts +24 -1
  282. package/dest/rollup/tree_snapshot_diff_hints.d.ts.map +1 -1
  283. package/dest/rollup/tx_merge_rollup_private_inputs.d.ts +4 -1
  284. package/dest/rollup/tx_merge_rollup_private_inputs.d.ts.map +1 -1
  285. package/dest/rollup/tx_rollup_public_inputs.d.ts +29 -1
  286. package/dest/rollup/tx_rollup_public_inputs.d.ts.map +1 -1
  287. package/dest/schemas/schemas.d.ts +1 -1
  288. package/dest/tests/factories.d.ts +2 -4
  289. package/dest/tests/factories.d.ts.map +1 -1
  290. package/dest/tests/factories.js +6 -15
  291. package/dest/tests/jest.js +1 -1
  292. package/dest/tests/mocks.d.ts +20 -14
  293. package/dest/tests/mocks.d.ts.map +1 -1
  294. package/dest/tests/mocks.js +45 -27
  295. package/dest/trees/append_only_tree_snapshot.d.ts +13 -1
  296. package/dest/trees/append_only_tree_snapshot.d.ts.map +1 -1
  297. package/dest/trees/nullifier_leaf.d.ts +13 -1
  298. package/dest/trees/nullifier_leaf.d.ts.map +1 -1
  299. package/dest/trees/nullifier_membership_witness.d.ts +10 -1
  300. package/dest/trees/nullifier_membership_witness.d.ts.map +1 -1
  301. package/dest/trees/public_data_leaf.d.ts +16 -1
  302. package/dest/trees/public_data_leaf.d.ts.map +1 -1
  303. package/dest/trees/public_data_witness.d.ts +11 -1
  304. package/dest/trees/public_data_witness.d.ts.map +1 -1
  305. package/dest/tx/block_header.d.ts +14 -2
  306. package/dest/tx/block_header.d.ts.map +1 -1
  307. package/dest/tx/block_header.js +5 -1
  308. package/dest/tx/call_context.d.ts +13 -1
  309. package/dest/tx/call_context.d.ts.map +1 -1
  310. package/dest/tx/capsule.d.ts +4 -1
  311. package/dest/tx/capsule.d.ts.map +1 -1
  312. package/dest/tx/execution_payload.d.ts +9 -1
  313. package/dest/tx/execution_payload.d.ts.map +1 -1
  314. package/dest/tx/function_data.d.ts +4 -2
  315. package/dest/tx/function_data.d.ts.map +1 -1
  316. package/dest/tx/global_variables.d.ts +9 -1
  317. package/dest/tx/global_variables.d.ts.map +1 -1
  318. package/dest/tx/hashed_values.d.ts +7 -1
  319. package/dest/tx/hashed_values.d.ts.map +1 -1
  320. package/dest/tx/in_tx.d.ts +3 -3
  321. package/dest/tx/indexed_tx_effect.d.ts +4 -4
  322. package/dest/tx/indexed_tx_effect.d.ts.map +1 -1
  323. package/dest/tx/indexed_tx_effect.js +2 -2
  324. package/dest/tx/partial_state_reference.d.ts +4 -1
  325. package/dest/tx/partial_state_reference.d.ts.map +1 -1
  326. package/dest/tx/private_execution_result.d.ts +23 -2
  327. package/dest/tx/private_execution_result.d.ts.map +1 -1
  328. package/dest/tx/private_execution_result.js +1 -1
  329. package/dest/tx/private_tx_constant_data.d.ts +16 -1
  330. package/dest/tx/private_tx_constant_data.d.ts.map +1 -1
  331. package/dest/tx/profiling.d.ts +149 -26
  332. package/dest/tx/profiling.d.ts.map +1 -1
  333. package/dest/tx/profiling.js +44 -7
  334. package/dest/tx/protocol_contracts.d.ts +1 -1
  335. package/dest/tx/public_call_request_with_calldata.d.ts +7 -1
  336. package/dest/tx/public_call_request_with_calldata.d.ts.map +1 -1
  337. package/dest/tx/state_reference.d.ts +3 -1
  338. package/dest/tx/state_reference.d.ts.map +1 -1
  339. package/dest/tx/tx.d.ts +24 -1
  340. package/dest/tx/tx.d.ts.map +1 -1
  341. package/dest/tx/tx.js +6 -3
  342. package/dest/tx/tx_context.d.ts +2 -1
  343. package/dest/tx/tx_context.d.ts.map +1 -1
  344. package/dest/tx/tx_effect.d.ts +32 -6
  345. package/dest/tx/tx_effect.d.ts.map +1 -1
  346. package/dest/tx/tx_effect.js +0 -7
  347. package/dest/tx/tx_execution_request.d.ts +30 -1
  348. package/dest/tx/tx_execution_request.d.ts.map +1 -1
  349. package/dest/tx/tx_hash.d.ts +2 -1
  350. package/dest/tx/tx_hash.d.ts.map +1 -1
  351. package/dest/tx/tx_receipt.d.ts +47 -13
  352. package/dest/tx/tx_receipt.d.ts.map +1 -1
  353. package/dest/tx/tx_receipt.js +46 -15
  354. package/dest/tx/tx_request.d.ts +6 -1
  355. package/dest/tx/tx_request.d.ts.map +1 -1
  356. package/dest/tx/validator/error_texts.d.ts +2 -1
  357. package/dest/tx/validator/error_texts.d.ts.map +1 -1
  358. package/dest/tx/validator/error_texts.js +2 -0
  359. package/dest/types/shared.d.ts +4 -1
  360. package/dest/types/shared.d.ts.map +1 -1
  361. package/dest/validators/schemas.d.ts +8 -8
  362. package/dest/vks/verification_key.d.ts +22 -1
  363. package/dest/vks/verification_key.d.ts.map +1 -1
  364. package/dest/vks/vk_data.d.ts +7 -1
  365. package/dest/vks/vk_data.d.ts.map +1 -1
  366. package/dest/zkpassport/index.d.ts +3 -4
  367. package/dest/zkpassport/index.d.ts.map +1 -1
  368. package/dest/zkpassport/index.js +9 -9
  369. package/package.json +12 -10
  370. package/src/abi/utils.ts +17 -0
  371. package/src/block/block_hash.ts +36 -10
  372. package/src/block/block_parameter.ts +4 -2
  373. package/src/block/body.ts +2 -1
  374. package/src/block/checkpointed_l2_block.ts +8 -58
  375. package/src/block/in_block.ts +5 -5
  376. package/src/block/index.ts +0 -2
  377. package/src/block/l2_block.ts +101 -149
  378. package/src/block/l2_block_source.ts +69 -41
  379. package/src/block/l2_block_stream/interfaces.ts +8 -5
  380. package/src/block/l2_block_stream/l2_block_stream.ts +45 -37
  381. package/src/block/l2_block_stream/l2_tips_store_base.ts +2 -2
  382. package/src/block/test/l2_tips_store_test_suite.ts +4 -9
  383. package/src/block/validate_block_result.ts +5 -4
  384. package/src/checkpoint/checkpoint.ts +33 -11
  385. package/src/checkpoint/published_checkpoint.ts +4 -3
  386. package/src/config/node-rpc-config.ts +1 -1
  387. package/src/contract/contract_address.ts +1 -1
  388. package/src/contract/contract_class_id.ts +1 -1
  389. package/src/contract/index.ts +0 -2
  390. package/src/contract/private_function.ts +2 -3
  391. package/src/contract/private_function_membership_proof.ts +1 -1
  392. package/src/delayed_public_mutable/delayed_public_mutable_values.ts +9 -10
  393. package/src/deserialization/index.ts +21 -0
  394. package/src/epoch-helpers/index.ts +10 -1
  395. package/src/hash/hash.ts +2 -2
  396. package/src/hash/map_slot.ts +3 -2
  397. package/src/interfaces/api_limit.ts +1 -0
  398. package/src/interfaces/archiver.ts +16 -23
  399. package/src/interfaces/aztec-node.ts +76 -74
  400. package/src/interfaces/block-builder.ts +33 -24
  401. package/src/interfaces/configs.ts +1 -3
  402. package/src/interfaces/l2_logs_source.ts +17 -4
  403. package/src/interfaces/prover-client.ts +15 -0
  404. package/src/interfaces/tx_provider.ts +2 -2
  405. package/src/interfaces/validator.ts +9 -11
  406. package/src/kernel/hints/build_note_hash_read_request_hints.ts +17 -6
  407. package/src/kernel/hints/build_nullifier_read_request_hints.ts +17 -14
  408. package/src/logs/log_id.ts +6 -6
  409. package/src/logs/siloed_tag.ts +3 -2
  410. package/src/messaging/l2_to_l1_membership.ts +5 -3
  411. package/src/messaging/out_hash.ts +60 -29
  412. package/src/note/note_dao.ts +18 -13
  413. package/src/p2p/block_proposal.ts +36 -13
  414. package/src/p2p/checkpoint_proposal.ts +29 -11
  415. package/src/p2p/consensus_payload.ts +0 -5
  416. package/src/p2p/constants.ts +3 -0
  417. package/src/p2p/index.ts +1 -0
  418. package/src/p2p/message_validator.ts +14 -2
  419. package/src/p2p/signed_txs.ts +6 -1
  420. package/src/p2p/topic_type.ts +1 -1
  421. package/src/proofs/chonk_proof.ts +9 -5
  422. package/src/rollup/block_headers_hash.ts +1 -1
  423. package/src/rollup/block_rollup_public_inputs.ts +2 -2
  424. package/src/rollup/checkpoint_header.ts +20 -0
  425. package/src/rollup/checkpoint_rollup_public_inputs.ts +12 -6
  426. package/src/rollup/checkpoint_root_rollup_private_inputs.ts +14 -1
  427. package/src/rollup/root_rollup_public_inputs.ts +4 -1
  428. package/src/tests/factories.ts +6 -26
  429. package/src/tests/jest.ts +1 -1
  430. package/src/tests/mocks.ts +62 -42
  431. package/src/tx/block_header.ts +11 -3
  432. package/src/tx/indexed_tx_effect.ts +2 -2
  433. package/src/tx/private_execution_result.ts +1 -1
  434. package/src/tx/profiling.ts +46 -4
  435. package/src/tx/tx.ts +8 -9
  436. package/src/tx/tx_effect.ts +0 -9
  437. package/src/tx/tx_receipt.ts +75 -18
  438. package/src/tx/validator/error_texts.ts +3 -0
  439. package/src/zkpassport/index.ts +11 -12
  440. package/dest/block/l2_block_code_to_purge.d.ts +0 -11
  441. package/dest/block/l2_block_code_to_purge.d.ts.map +0 -1
  442. package/dest/block/l2_block_code_to_purge.js +0 -55
  443. package/dest/block/l2_block_header.d.ts +0 -94
  444. package/dest/block/l2_block_header.d.ts.map +0 -1
  445. package/dest/block/l2_block_header.js +0 -160
  446. package/dest/block/l2_block_new.d.ts +0 -134
  447. package/dest/block/l2_block_new.d.ts.map +0 -1
  448. package/dest/block/l2_block_new.js +0 -155
  449. package/dest/contract/contract_class_metadata.d.ts +0 -8
  450. package/dest/contract/contract_class_metadata.d.ts.map +0 -1
  451. package/dest/contract/contract_class_metadata.js +0 -1
  452. package/dest/contract/contract_metadata.d.ts +0 -7
  453. package/dest/contract/contract_metadata.d.ts.map +0 -1
  454. package/dest/contract/contract_metadata.js +0 -1
  455. package/src/block/l2_block_code_to_purge.ts +0 -80
  456. package/src/block/l2_block_header.ts +0 -255
  457. package/src/block/l2_block_new.ts +0 -211
  458. package/src/contract/contract_class_metadata.ts +0 -8
  459. package/src/contract/contract_metadata.ts +0 -7
@@ -1,3 +1,4 @@
1
+ import type { BlockNumber, CheckpointNumber, SlotNumber } from '@aztec/foundation/branded-types';
1
2
  import type { SecretValue } from '@aztec/foundation/config';
2
3
  import { Fr } from '@aztec/foundation/curves/bn254';
3
4
  import type { EthAddress } from '@aztec/foundation/eth-address';
@@ -14,6 +15,7 @@ import type {
14
15
  } from '@aztec/stdlib/p2p';
15
16
  import type { CheckpointHeader } from '@aztec/stdlib/rollup';
16
17
  import type { BlockHeader, Tx } from '@aztec/stdlib/tx';
18
+ import { type ValidatorHASignerConfig, ValidatorHASignerConfigSchema } from '@aztec/validator-ha-signer/config';
17
19
 
18
20
  import type { PeerId } from '@libp2p/interface';
19
21
  import { z } from 'zod';
@@ -24,7 +26,7 @@ import { AllowedElementSchema } from './allowed_element.js';
24
26
  /**
25
27
  * Validator client configuration
26
28
  */
27
- export interface ValidatorClientConfig {
29
+ export type ValidatorClientConfig = ValidatorHASignerConfig & {
28
30
  /** The private keys of the validators participating in attestation duties */
29
31
  validatorPrivateKeys?: SecretValue<`0x${string}`[]>;
30
32
 
@@ -43,23 +45,18 @@ export interface ValidatorClientConfig {
43
45
  /** Whether to re-execute transactions in a block proposal before attesting */
44
46
  validatorReexecute: boolean;
45
47
 
46
- /** Will re-execute until this many milliseconds are left in the slot */
47
- validatorReexecuteDeadlineMs: number;
48
-
49
48
  /** Whether to always reexecute block proposals, even for non-validator nodes or when out of the currnet committee */
50
49
  alwaysReexecuteBlockProposals?: boolean;
51
50
 
52
51
  /** Whether to run in fisherman mode: validates all proposals and attestations but does not broadcast attestations or participate in consensus */
53
52
  fishermanMode?: boolean;
54
53
 
55
- // TODO(palla/mbps): Change default to false once checkpoint validation is stable
56
- /** Skip checkpoint proposal validation and always attest (default: true) */
54
+ /** Skip checkpoint proposal validation and always attest (default: false) */
57
55
  skipCheckpointProposalValidation?: boolean;
58
56
 
59
- // TODO(palla/mbps): Change default to false once block sync is stable
60
- /** Skip pushing re-executed blocks to archiver (default: true) */
57
+ /** Skip pushing re-executed blocks to archiver (default: false) */
61
58
  skipPushProposedBlocksToArchiver?: boolean;
62
- }
59
+ };
63
60
 
64
61
  export type ValidatorClientFullConfig = ValidatorClientConfig &
65
62
  Pick<SequencerConfig, 'txPublicSetupAllowList' | 'broadcastInvalidBlockProposal'> &
@@ -72,13 +69,12 @@ export type ValidatorClientFullConfig = ValidatorClientConfig &
72
69
  };
73
70
 
74
71
  export const ValidatorClientConfigSchema = zodFor<Omit<ValidatorClientConfig, 'validatorPrivateKeys'>>()(
75
- z.object({
72
+ ValidatorHASignerConfigSchema.extend({
76
73
  validatorAddresses: z.array(schemas.EthAddress).optional(),
77
74
  disableValidator: z.boolean(),
78
75
  disabledValidators: z.array(schemas.EthAddress),
79
76
  attestationPollingIntervalMs: z.number().min(0),
80
77
  validatorReexecute: z.boolean(),
81
- validatorReexecuteDeadlineMs: z.number().min(0),
82
78
  alwaysReexecuteBlockProposals: z.boolean().optional(),
83
79
  fishermanMode: z.boolean().optional(),
84
80
  skipCheckpointProposalValidation: z.boolean().optional(),
@@ -148,5 +144,7 @@ export interface Validator {
148
144
  signAttestationsAndSigners(
149
145
  attestationsAndSigners: CommitteeAttestationsAndSigners,
150
146
  proposer: EthAddress,
147
+ slot: SlotNumber,
148
+ blockNumber: BlockNumber | CheckpointNumber,
151
149
  ): Promise<Signature>;
152
150
  }
@@ -76,17 +76,28 @@ export async function buildNoteHashReadRequestHintsFromResetActions<PENDING exte
76
76
  builder.addPendingReadRequest(hint.readRequestIndex, hint.pendingValueIndex);
77
77
  });
78
78
 
79
+ // Collect all settled read requests
80
+ const settledRequests: { index: number; readRequest: ScopedReadRequest }[] = [];
79
81
  for (let i = 0; i < resetActions.actions.length; i++) {
80
82
  if (resetActions.actions[i] === ReadRequestActionEnum.READ_AS_SETTLED) {
81
- const readRequest = noteHashReadRequests.array[i];
82
- const membershipWitness = await oracle.getNoteHashMembershipWitness(readRequest.value);
83
- if (!membershipWitness) {
84
- throw new Error('Read request is reading an unknown note hash.');
85
- }
86
- builder.addSettledReadRequest(i, membershipWitness, readRequest.value);
83
+ settledRequests.push({ index: i, readRequest: noteHashReadRequests.array[i] });
87
84
  }
88
85
  }
89
86
 
87
+ // Fetch all membership witnesses in parallel
88
+ const membershipWitnesses = await Promise.all(
89
+ settledRequests.map(({ readRequest }) => oracle.getNoteHashMembershipWitness(readRequest.value)),
90
+ );
91
+
92
+ // Add settled read requests to builder
93
+ for (let i = 0; i < settledRequests.length; i++) {
94
+ const membershipWitness = membershipWitnesses[i];
95
+ if (!membershipWitness) {
96
+ throw new Error('Read request is reading an unknown note hash.');
97
+ }
98
+ builder.addSettledReadRequest(settledRequests[i].index, membershipWitness, settledRequests[i].readRequest.value);
99
+ }
100
+
90
101
  const noteHashMap: Map<bigint, { noteHash: ScopedNoteHash; index: number }[]> = new Map();
91
102
  noteHashes.getActiveItems().forEach((noteHash, index) => {
92
103
  const value = noteHash.value.toBigInt();
@@ -6,7 +6,6 @@ import {
6
6
  import type { Fr } from '@aztec/foundation/curves/bn254';
7
7
  import { MembershipWitness } from '@aztec/foundation/trees';
8
8
 
9
- import { siloNullifier } from '../../hash/hash.js';
10
9
  import type { NullifierLeafPreimage } from '../../trees/nullifier_leaf.js';
11
10
  import type { ClaimedLengthArray } from '../claimed_length_array.js';
12
11
  import type { ScopedNullifier } from '../nullifier.js';
@@ -74,7 +73,6 @@ export async function buildNullifierReadRequestHintsFromResetActions<PENDING ext
74
73
  resetActions: ReadRequestResetActions<typeof MAX_NULLIFIER_READ_REQUESTS_PER_TX>,
75
74
  maxPending: PENDING = MAX_NULLIFIER_READ_REQUESTS_PER_TX as PENDING,
76
75
  maxSettled: SETTLED = MAX_NULLIFIER_READ_REQUESTS_PER_TX as SETTLED,
77
- siloed = false,
78
76
  ) {
79
77
  const builder = new NullifierReadRequestHintsBuilder(maxPending, maxSettled);
80
78
 
@@ -82,21 +80,28 @@ export async function buildNullifierReadRequestHintsFromResetActions<PENDING ext
82
80
  builder.addPendingReadRequest(hint.readRequestIndex, hint.pendingValueIndex);
83
81
  });
84
82
 
83
+ // Collect all settled read requests
84
+ const settledRequests: { index: number; readRequest: ScopedReadRequest }[] = [];
85
85
  for (let i = 0; i < resetActions.actions.length; i++) {
86
86
  if (resetActions.actions[i] === ReadRequestActionEnum.READ_AS_SETTLED) {
87
- const readRequest = nullifierReadRequests.array[i];
88
- const siloedValue = siloed
89
- ? readRequest.value
90
- : await siloNullifier(readRequest.contractAddress, readRequest.value);
91
- const membershipWitnessWithPreimage = await oracle.getNullifierMembershipWitness(siloedValue);
92
- builder.addSettledReadRequest(
93
- i,
94
- membershipWitnessWithPreimage.membershipWitness,
95
- membershipWitnessWithPreimage.leafPreimage,
96
- );
87
+ settledRequests.push({ index: i, readRequest: nullifierReadRequests.array[i] });
97
88
  }
98
89
  }
99
90
 
91
+ const siloedValues = settledRequests.map(({ readRequest }) => readRequest.value);
92
+
93
+ // Fetch all membership witnesses in parallel
94
+ const membershipWitnesses = await Promise.all(siloedValues.map(value => oracle.getNullifierMembershipWitness(value)));
95
+
96
+ // Add settled read requests to builder
97
+ for (let i = 0; i < settledRequests.length; i++) {
98
+ builder.addSettledReadRequest(
99
+ settledRequests[i].index,
100
+ membershipWitnesses[i].membershipWitness,
101
+ membershipWitnesses[i].leafPreimage,
102
+ );
103
+ }
104
+
100
105
  return builder.toHints();
101
106
  }
102
107
 
@@ -109,7 +114,6 @@ export async function buildNullifierReadRequestHints<PENDING extends number, SET
109
114
  futureNullifiers: ScopedNullifier[],
110
115
  maxPending: PENDING = MAX_NULLIFIER_READ_REQUESTS_PER_TX as PENDING,
111
116
  maxSettled: SETTLED = MAX_NULLIFIER_READ_REQUESTS_PER_TX as SETTLED,
112
- siloed = false,
113
117
  ) {
114
118
  const resetActions = getNullifierReadRequestResetActions(nullifierReadRequests, nullifiers, futureNullifiers);
115
119
  return await buildNullifierReadRequestHintsFromResetActions(
@@ -118,6 +122,5 @@ export async function buildNullifierReadRequestHints<PENDING extends number, SET
118
122
  resetActions,
119
123
  maxPending,
120
124
  maxSettled,
121
- siloed,
122
125
  );
123
126
  }
@@ -5,7 +5,7 @@ import { BufferReader } from '@aztec/foundation/serialize';
5
5
 
6
6
  import { z } from 'zod';
7
7
 
8
- import { L2BlockHash } from '../block/block_hash.js';
8
+ import { BlockHash } from '../block/block_hash.js';
9
9
  import { schemas } from '../schemas/index.js';
10
10
 
11
11
  /** A globally unique log id. */
@@ -20,7 +20,7 @@ export class LogId {
20
20
  /** The block number the log was emitted in. */
21
21
  public readonly blockNumber: BlockNumber,
22
22
  /** The hash of the block the log was emitted in. */
23
- public readonly blockHash: L2BlockHash,
23
+ public readonly blockHash: BlockHash,
24
24
  /** The index of a tx in a block the log was emitted in. */
25
25
  public readonly txIndex: number,
26
26
  /** The index of a log the tx was emitted in. */
@@ -40,7 +40,7 @@ export class LogId {
40
40
  static random() {
41
41
  return new LogId(
42
42
  BlockNumber(Math.floor(Math.random() * 1000) + 1),
43
- L2BlockHash.random(),
43
+ BlockHash.random(),
44
44
  Math.floor(Math.random() * 1000),
45
45
  Math.floor(Math.random() * 100),
46
46
  );
@@ -50,7 +50,7 @@ export class LogId {
50
50
  return z
51
51
  .object({
52
52
  blockNumber: BlockNumberSchema,
53
- blockHash: L2BlockHash.schema,
53
+ blockHash: BlockHash.schema,
54
54
  txIndex: schemas.Integer,
55
55
  logIndex: schemas.Integer,
56
56
  })
@@ -81,7 +81,7 @@ export class LogId {
81
81
  const reader = BufferReader.asReader(buffer);
82
82
 
83
83
  const blockNumber = BlockNumber(reader.readNumber());
84
- const blockHash = reader.readObject(L2BlockHash);
84
+ const blockHash = reader.readObject(BlockHash);
85
85
  const txIndex = reader.readNumber();
86
86
  const logIndex = reader.readNumber();
87
87
 
@@ -104,7 +104,7 @@ export class LogId {
104
104
  static fromString(data: string): LogId {
105
105
  const [rawBlockNumber, rawTxIndex, rawLogIndex, rawBlockHash] = data.split('-');
106
106
  const blockNumber = BlockNumber(Number(rawBlockNumber));
107
- const blockHash = L2BlockHash.fromString(rawBlockHash);
107
+ const blockHash = BlockHash.fromString(rawBlockHash);
108
108
  const txIndex = Number(rawTxIndex);
109
109
  const logIndex = Number(rawLogIndex);
110
110
 
@@ -1,4 +1,5 @@
1
- import { poseidon2Hash } from '@aztec/foundation/crypto/poseidon';
1
+ import { GeneratorIndex } from '@aztec/constants';
2
+ import { poseidon2HashWithSeparator } from '@aztec/foundation/crypto/poseidon';
2
3
  import type { Fr } from '@aztec/foundation/curves/bn254';
3
4
  import type { ZodFor } from '@aztec/foundation/schemas';
4
5
 
@@ -22,7 +23,7 @@ export class SiloedTag {
22
23
  constructor(public readonly value: Fr) {}
23
24
 
24
25
  static async compute(tag: Tag, app: AztecAddress): Promise<SiloedTag> {
25
- const siloedTag = await poseidon2Hash([app, tag.value]);
26
+ const siloedTag = await poseidon2HashWithSeparator([app, tag.value], GeneratorIndex.PRIVATE_LOG_FIRST_FIELD);
26
27
  return new SiloedTag(siloedTag);
27
28
  }
28
29
 
@@ -1,4 +1,4 @@
1
- import { AZTEC_MAX_EPOCH_DURATION } from '@aztec/constants';
1
+ import { OUT_HASH_TREE_LEAF_COUNT } from '@aztec/constants';
2
2
  import type { EpochNumber } from '@aztec/foundation/branded-types';
3
3
  import { Fr } from '@aztec/foundation/curves/bn254';
4
4
  import { SiblingPath, UnbalancedMerkleTreeCalculator, computeUnbalancedShaRoot } from '@aztec/foundation/trees';
@@ -165,10 +165,12 @@ export function computeL2ToL1MembershipWitnessFromMessagesInEpoch(
165
165
  });
166
166
  // Pad to AZTEC_MAX_EPOCH_DURATION with zeros.
167
167
  checkpointOutHashes = checkpointOutHashes.concat(
168
- Array.from({ length: AZTEC_MAX_EPOCH_DURATION - messagesInEpoch.length }, () => Buffer.alloc(32)),
168
+ Array.from({ length: OUT_HASH_TREE_LEAF_COUNT - messagesInEpoch.length }, () => Buffer.alloc(32)),
169
169
  );
170
170
 
171
- // Build the epoch tree with all the checkpoint out hashes, including the padded zeros
171
+ // Build the epoch tree with all the checkpoint out hashes, including the padded zeros.
172
+ // Note: The epoch tree is actually a balanced tree, but we use an unbalanced tree calculator here to avoid turning
173
+ // this function into async.
172
174
  const epochTree = UnbalancedMerkleTreeCalculator.create(checkpointOutHashes);
173
175
  // Get the sibling path of the checkpoint out hash in the epoch tree.
174
176
  const pathToCheckpointOutHashInEpochTree = epochTree.getSiblingPathByLeafIndex(checkpointIndex);
@@ -1,46 +1,77 @@
1
- import { AZTEC_MAX_EPOCH_DURATION } from '@aztec/constants';
1
+ import { OUT_HASH_TREE_LEAF_COUNT } from '@aztec/constants';
2
2
  import { padArrayEnd } from '@aztec/foundation/collection';
3
3
  import { Fr } from '@aztec/foundation/curves/bn254';
4
- import { computeCompressedUnbalancedShaRoot, computeUnbalancedShaRoot } from '@aztec/foundation/trees';
4
+ import { computeBalancedShaRoot, computeUnbalancedShaRoot, computeWonkyShaRoot } from '@aztec/foundation/trees';
5
5
 
6
+ /**
7
+ * Computes the out hash of a tx. It's the root of the unbalanced tree of all the L2-to-L1 messages emitted by the tx.
8
+ * @param messages - The L2-to-L1 messages emitted by the tx.
9
+ * @returns The out hash of the tx.
10
+ */
6
11
  export function computeTxOutHash(messages: Fr[]): Fr {
12
+ // Must match the implementation in `tx_base_public_inputs_composer.nr > compute_kernel_out_hash()`
7
13
  if (!messages.length) {
8
14
  return Fr.ZERO;
9
15
  }
10
- // Tx out hash is the root of the unbalanced merkle tree of all the messages.
11
- // Zero hashes (which should not happen) are not compressed.
16
+ // It's an unbalanced tree because zero hashes (which should not happen) will be included.
12
17
  return Fr.fromBuffer(computeUnbalancedShaRoot(messages.map(msg => msg.toBuffer())));
13
18
  }
14
19
 
15
- export function computeBlockOutHash(messagesPerBlock: Fr[][]): Fr {
16
- const txOutHashes = messagesPerBlock.map(messages => computeTxOutHash(messages));
17
- return aggregateOutHashes(txOutHashes);
20
+ /**
21
+ * Computes the out hash of a block. It's the root of the wonky tree of all the tx out hashes.
22
+ * @param messagesPerTx - The L2-to-L1 messages emitted by the txs in the block. This is an array of message arrays.
23
+ * The array at index 0 contains the messages emitted by the first tx, the array at index 1 contains the messages
24
+ * emitted by the second tx, and so on.
25
+ * @returns The out hash of the block.
26
+ */
27
+ export function computeBlockOutHash(messagesPerTx: Fr[][]): Fr {
28
+ // See how the tx out hashes are aggregated into a block out hash in `merge_tx_rollups.nr > accumulate_out_hash()`.
29
+ const txOutHashes = messagesPerTx.map(messages => computeTxOutHash(messages));
30
+ return Fr.fromBuffer(computeWonkyShaRoot(txOutHashes.map(hash => hash.toBuffer())));
18
31
  }
19
32
 
20
- export function computeCheckpointOutHash(messagesForAllTxs: Fr[][][]): Fr {
21
- const blockOutHashes = messagesForAllTxs.map(block => computeBlockOutHash(block));
22
- return aggregateOutHashes(blockOutHashes);
33
+ /**
34
+ * Computes the out hash of a checkpoint. It's the root of the wonky tree of all the block out hashes.
35
+ * @param messagesPerBlock - The L2-to-L1 messages emitted by the txs in the blocks in the checkpoint. This is an array
36
+ * of arrays of messages. The array at index 0 contains the arrays of messages emitted by the first block, the array at
37
+ * index 1 contains the arrays of messages emitted by the second block, and so on.
38
+ * @returns The out hash of the checkpoint.
39
+ */
40
+ export function computeCheckpointOutHash(messagesPerBlock: Fr[][][]): Fr {
41
+ // See how the block out hashes are aggregated into a checkpoint out hash in `merge_block_rollups.nr > accumulate_out_hash()`.
42
+ const blockOutHashes = messagesPerBlock.map(block => computeBlockOutHash(block));
43
+ return Fr.fromBuffer(computeWonkyShaRoot(blockOutHashes.map(hash => hash.toBuffer())));
23
44
  }
24
45
 
25
- export function computeEpochOutHash(messagesInEpoch: Fr[][][][]): Fr {
26
- // Must match the implementation in `compute_epoch_out_hash.nr`.
27
- const checkpointOutHashes = messagesInEpoch
28
- .map(checkpoint => computeCheckpointOutHash(checkpoint))
29
- .map(hash => hash.toBuffer());
30
- if (checkpointOutHashes.every(hash => hash.equals(Buffer.alloc(32)))) {
31
- return Fr.ZERO;
32
- }
33
-
34
- const paddedOutHashes = padArrayEnd(checkpointOutHashes, Buffer.alloc(32), AZTEC_MAX_EPOCH_DURATION);
35
- return Fr.fromBuffer(computeUnbalancedShaRoot(paddedOutHashes));
46
+ /**
47
+ * Computes the accumulated (epoch) out hash of a checkpoint. It's the root of the balanced tree of all the out hashes
48
+ * from the first checkpoint in an epoch to the current checkpoint.
49
+ * It's this value that's set to the checkpoint header and validated on L1 instead of the checkpoint out hash.
50
+ * @param checkpointOutHashes - The out hashes of all checkpoints in the epoch.
51
+ * @returns The accumulated (epoch) out hash.
52
+ */
53
+ export function accumulateCheckpointOutHashes(checkpointOutHashes: Fr[]): Fr {
54
+ // See how the checkpoint out hashes are accumulated in `checkpoint_rollup_public_inputs_composer.nr > accumulate_checkpoint_out_hash()`.
55
+ const paddedOutHashes = padArrayEnd(
56
+ checkpointOutHashes.map(hash => hash.toBuffer()),
57
+ Buffer.alloc(32),
58
+ OUT_HASH_TREE_LEAF_COUNT,
59
+ );
60
+ return Fr.fromBuffer(computeBalancedShaRoot(paddedOutHashes));
36
61
  }
37
62
 
38
- // The root of this tree should match the `out_hash` calculated in the circuits. Zero hashes are compressed to reduce
39
- // cost if the non-zero leaves result in a shorter path.
40
- function aggregateOutHashes(outHashes: Fr[]): Fr {
41
- if (!outHashes.length) {
42
- return Fr.ZERO;
43
- }
44
-
45
- return Fr.fromBuffer(computeCompressedUnbalancedShaRoot(outHashes.map(hash => hash.toBuffer())));
63
+ /**
64
+ * Computes the epoch out hash. It's the root of the balanced tree of all the checkpoint out hashes.
65
+ * It should match the **accumulated** out hash of the last checkpoint in the epoch.
66
+ * This value will be inserted into the Outbox on L1.
67
+ * @param messagesPerCheckpoint - The L2-to-L1 messages emitted by the txs in the blocks in the checkpoints in the epoch.
68
+ * This is an array of arrays of arrays of messages. The array at index 0 contains the arrays of arrays of messages
69
+ * emitted by the first checkpoint, the array at index 1 contains the arrays of arrays of messages emitted by the second
70
+ * checkpoint, and so on.
71
+ * @returns The epoch out hash.
72
+ */
73
+ export function computeEpochOutHash(messagesPerCheckpoint: Fr[][][][]): Fr {
74
+ // See how the accumulated out hash is assigned to the root rollup's public inputs in `root_rollup.nr`.
75
+ const checkpointOutHashes = messagesPerCheckpoint.map(checkpoint => computeCheckpointOutHash(checkpoint));
76
+ return accumulateCheckpointOutHashes(checkpointOutHashes);
46
77
  }
@@ -1,4 +1,3 @@
1
- import { toBigIntBE } from '@aztec/foundation/bigint-buffer';
2
1
  import { BlockNumber } from '@aztec/foundation/branded-types';
3
2
  import { Fr } from '@aztec/foundation/curves/bn254';
4
3
  import { Point } from '@aztec/foundation/curves/grumpkin';
@@ -56,8 +55,10 @@ export class NoteDao {
56
55
  /** The L2 block hash in which the tx with this note was included. Used for note management while processing
57
56
  * reorgs.*/
58
57
  public l2BlockHash: string,
59
- /** The index of the leaf in the global note hash tree the note is stored at */
60
- public index: bigint,
58
+ /** The index of the tx within the block, used for ordering notes. */
59
+ public txIndexInBlock: number,
60
+ /** The index of the note within the tx (based on note hash position), used for ordering notes. */
61
+ public noteIndexInTx: number,
61
62
  ) {}
62
63
 
63
64
  toBuffer(): Buffer {
@@ -73,7 +74,8 @@ export class NoteDao {
73
74
  this.txHash,
74
75
  this.l2BlockNumber,
75
76
  Fr.fromHexString(this.l2BlockHash),
76
- this.index,
77
+ this.txIndexInBlock,
78
+ this.noteIndexInTx,
77
79
  ]);
78
80
  }
79
81
 
@@ -91,7 +93,8 @@ export class NoteDao {
91
93
  const txHash = reader.readObject(TxHash);
92
94
  const l2BlockNumber = BlockNumber(reader.readNumber());
93
95
  const l2BlockHash = Fr.fromBuffer(reader).toString();
94
- const index = toBigIntBE(reader.readBytes(32));
96
+ const txIndexInBlock = reader.readNumber();
97
+ const noteIndexInTx = reader.readNumber();
95
98
 
96
99
  return new NoteDao(
97
100
  note,
@@ -105,7 +108,8 @@ export class NoteDao {
105
108
  txHash,
106
109
  l2BlockNumber,
107
110
  l2BlockHash,
108
- index,
111
+ txIndexInBlock,
112
+ noteIndexInTx,
109
113
  );
110
114
  }
111
115
 
@@ -134,7 +138,8 @@ export class NoteDao {
134
138
  this.txHash.equals(other.txHash) &&
135
139
  this.l2BlockNumber === other.l2BlockNumber &&
136
140
  this.l2BlockHash === other.l2BlockHash &&
137
- this.index === other.index
141
+ this.txIndexInBlock === other.txIndexInBlock &&
142
+ this.noteIndexInTx === other.noteIndexInTx
138
143
  );
139
144
  }
140
145
 
@@ -143,11 +148,9 @@ export class NoteDao {
143
148
  * @returns - Its size in bytes.
144
149
  */
145
150
  public getSize() {
146
- const indexSize = Math.ceil(Math.log2(Number(this.index)));
147
151
  const noteSize = 4 + this.note.items.length * Fr.SIZE_IN_BYTES;
148
- return (
149
- noteSize + AztecAddress.SIZE_IN_BYTES * 2 + Fr.SIZE_IN_BYTES * 4 + TxHash.SIZE + Point.SIZE_IN_BYTES + indexSize
150
- );
152
+ // 2 numbers for txIndexInBlock and noteIndexInTx (4 bytes each)
153
+ return noteSize + AztecAddress.SIZE_IN_BYTES * 2 + Fr.SIZE_IN_BYTES * 4 + TxHash.SIZE + Point.SIZE_IN_BYTES + 8;
151
154
  }
152
155
 
153
156
  static async random({
@@ -162,7 +165,8 @@ export class NoteDao {
162
165
  txHash = TxHash.random(),
163
166
  l2BlockNumber = BlockNumber(Math.floor(Math.random() * 1000)),
164
167
  l2BlockHash = Fr.random().toString(),
165
- index = Fr.random().toBigInt(),
168
+ txIndexInBlock = Math.floor(Math.random() * 100),
169
+ noteIndexInTx = Math.floor(Math.random() * 100),
166
170
  }: Partial<NoteDao> = {}) {
167
171
  return new NoteDao(
168
172
  note,
@@ -176,7 +180,8 @@ export class NoteDao {
176
180
  txHash,
177
181
  l2BlockNumber,
178
182
  l2BlockHash,
179
- index,
183
+ txIndexInBlock,
184
+ noteIndexInTx,
180
185
  );
181
186
  }
182
187
  }
@@ -1,4 +1,4 @@
1
- import { BlockNumber, SlotNumber } from '@aztec/foundation/branded-types';
1
+ import { BlockNumber, IndexWithinCheckpoint, SlotNumber } from '@aztec/foundation/branded-types';
2
2
  import { Buffer32 } from '@aztec/foundation/buffer';
3
3
  import { keccak256 } from '@aztec/foundation/crypto/keccak';
4
4
  import { tryRecoverAddress } from '@aztec/foundation/crypto/secp256k1-signer';
@@ -6,9 +6,11 @@ import { Fr } from '@aztec/foundation/curves/bn254';
6
6
  import type { EthAddress } from '@aztec/foundation/eth-address';
7
7
  import { Signature } from '@aztec/foundation/eth-signature';
8
8
  import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize';
9
+ import { DutyType, type SigningContext } from '@aztec/validator-ha-signer/types';
9
10
 
10
11
  import type { L2Block } from '../block/l2_block.js';
11
12
  import type { L2BlockInfo } from '../block/l2_block_info.js';
13
+ import { MAX_TXS_PER_BLOCK } from '../deserialization/index.js';
12
14
  import { BlockHeader } from '../tx/block_header.js';
13
15
  import { TxHash } from '../tx/index.js';
14
16
  import type { Tx } from '../tx/tx.js';
@@ -28,8 +30,15 @@ export class BlockProposalHash extends Buffer32 {
28
30
  }
29
31
 
30
32
  export type BlockProposalOptions = {
31
- publishFullTxs: boolean;
32
- /** Whether to generate an invalid block proposal for broadcasting. Use only for testing. */
33
+ /**
34
+ * Whether to include the tx objects along with the block proposal.
35
+ * Dramatically increases size of the payload but eliminates failed reexecutions due to missing txs.
36
+ */
37
+ publishFullTxs?: boolean;
38
+ /**
39
+ * Whether to generate an invalid block proposal for broadcasting.
40
+ * Use only for testing.
41
+ */
33
42
  broadcastInvalidBlockProposal?: boolean;
34
43
  };
35
44
 
@@ -50,7 +59,7 @@ export class BlockProposal extends Gossipable {
50
59
  // TODO(palla/mbps): Is this really needed? Can we just derive it from the indexWithinCheckpoint of the parent block and the slot number?
51
60
  // See the block-proposal-handler, we have a lot of extra validations to check this is correct, so maybe we can avoid storing it here.
52
61
  /** Index of this block within the checkpoint (0-indexed) */
53
- public readonly indexWithinCheckpoint: number,
62
+ public readonly indexWithinCheckpoint: IndexWithinCheckpoint,
54
63
 
55
64
  /** Hash of L1 to L2 messages for this checkpoint (constant across all blocks in checkpoint) */
56
65
  public readonly inHash: Fr,
@@ -119,12 +128,12 @@ export class BlockProposal extends Gossipable {
119
128
 
120
129
  static async createProposalFromSigner(
121
130
  blockHeader: BlockHeader,
122
- indexWithinCheckpoint: number,
131
+ indexWithinCheckpoint: IndexWithinCheckpoint,
123
132
  inHash: Fr,
124
133
  archiveRoot: Fr,
125
134
  txHashes: TxHash[],
126
135
  txs: Tx[] | undefined,
127
- payloadSigner: (payload: Buffer32) => Promise<Signature>,
136
+ payloadSigner: (payload: Buffer32, context: SigningContext) => Promise<Signature>,
128
137
  ): Promise<BlockProposal> {
129
138
  // Create a temporary proposal to get the payload to sign
130
139
  const tempProposal = new BlockProposal(
@@ -136,13 +145,23 @@ export class BlockProposal extends Gossipable {
136
145
  Signature.empty(),
137
146
  );
138
147
 
148
+ // Create the block signing context
149
+ const blockContext: SigningContext = {
150
+ slot: blockHeader.globalVariables.slotNumber,
151
+ blockNumber: blockHeader.globalVariables.blockNumber,
152
+ blockIndexWithinCheckpoint: indexWithinCheckpoint,
153
+ dutyType: DutyType.BLOCK_PROPOSAL,
154
+ };
155
+
139
156
  const hashed = getHashedSignaturePayload(tempProposal, SignatureDomainSeparator.blockProposal);
140
- const sig = await payloadSigner(hashed);
157
+ const sig = await payloadSigner(hashed, blockContext);
141
158
 
142
159
  // If txs are provided, sign them as well
143
160
  let signedTxs: SignedTxs | undefined;
144
161
  if (txs) {
145
- signedTxs = await SignedTxs.createFromSigner(txs, payloadSigner);
162
+ const txsSigningContext: SigningContext = { dutyType: DutyType.TXS };
163
+ const txsSigner = (payload: Buffer32) => payloadSigner(payload, txsSigningContext);
164
+ signedTxs = await SignedTxs.createFromSigner(txs, txsSigner);
146
165
  }
147
166
 
148
167
  return new BlockProposal(blockHeader, indexWithinCheckpoint, inHash, archiveRoot, txHashes, sig, signedTxs);
@@ -200,11 +219,15 @@ export class BlockProposal extends Gossipable {
200
219
  const reader = BufferReader.asReader(buf);
201
220
 
202
221
  const blockHeader = reader.readObject(BlockHeader);
203
- const indexWithinCheckpoint = reader.readNumber();
222
+ const indexWithinCheckpoint = IndexWithinCheckpoint(reader.readNumber());
204
223
  const inHash = reader.readObject(Fr);
205
224
  const archiveRoot = reader.readObject(Fr);
206
225
  const signature = reader.readObject(Signature);
207
- const txHashes = reader.readArray(reader.readNumber(), TxHash);
226
+ const txHashCount = reader.readNumber();
227
+ if (txHashCount > MAX_TXS_PER_BLOCK) {
228
+ throw new Error(`txHashes count ${txHashCount} exceeds maximum ${MAX_TXS_PER_BLOCK}`);
229
+ }
230
+ const txHashes = reader.readArray(txHashCount, TxHash);
208
231
 
209
232
  if (!reader.isEmpty()) {
210
233
  const hasSignedTxs = reader.readNumber();
@@ -240,13 +263,13 @@ export class BlockProposal extends Gossipable {
240
263
  }
241
264
 
242
265
  static empty(): BlockProposal {
243
- return new BlockProposal(BlockHeader.empty(), 0, Fr.ZERO, Fr.ZERO, [], Signature.empty());
266
+ return new BlockProposal(BlockHeader.empty(), IndexWithinCheckpoint(0), Fr.ZERO, Fr.ZERO, [], Signature.empty());
244
267
  }
245
268
 
246
269
  static random(): BlockProposal {
247
270
  return new BlockProposal(
248
271
  BlockHeader.random(),
249
- Math.floor(Math.random() * 5),
272
+ IndexWithinCheckpoint(Math.floor(Math.random() * 5)),
250
273
  Fr.random(),
251
274
  Fr.random(),
252
275
  [TxHash.random(), TxHash.random()],
@@ -272,7 +295,7 @@ export class BlockProposal extends Gossipable {
272
295
  * @returns True if the proposal matches the block
273
296
  */
274
297
  matchesBlock(block: L2Block): boolean {
275
- return this.archiveRoot.equals(block.archive.root) && this.blockHeader.equals(block.getBlockHeader());
298
+ return this.archiveRoot.equals(block.archive.root) && this.blockHeader.equals(block.header);
276
299
  }
277
300
 
278
301
  /**