@aztec/stdlib 3.0.0-canary.a9708bd → 3.0.0-devnet.3

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 (633) hide show
  1. package/dest/abi/abi.d.ts +8 -8
  2. package/dest/abi/abi.js +1 -1
  3. package/dest/abi/contract_artifact.js +3 -0
  4. package/dest/abi/event_metadata_definition.d.ts +8 -0
  5. package/dest/abi/event_metadata_definition.d.ts.map +1 -0
  6. package/dest/abi/event_metadata_definition.js +1 -0
  7. package/dest/abi/function_call.d.ts +7 -2
  8. package/dest/abi/function_call.d.ts.map +1 -1
  9. package/dest/abi/function_call.js +6 -2
  10. package/dest/abi/index.d.ts +1 -0
  11. package/dest/abi/index.d.ts.map +1 -1
  12. package/dest/abi/index.js +1 -0
  13. package/dest/avm/avm.d.ts +132 -73
  14. package/dest/avm/avm.d.ts.map +1 -1
  15. package/dest/avm/avm.js +10 -6
  16. package/dest/avm/avm_accumulated_data.d.ts +10 -21
  17. package/dest/avm/avm_accumulated_data.d.ts.map +1 -1
  18. package/dest/avm/avm_accumulated_data.js +19 -22
  19. package/dest/avm/avm_circuit_public_inputs.d.ts +30 -13
  20. package/dest/avm/avm_circuit_public_inputs.d.ts.map +1 -1
  21. package/dest/avm/avm_circuit_public_inputs.js +17 -6
  22. package/dest/avm/avm_proving_request.d.ts +96 -48
  23. package/dest/avm/avm_proving_request.d.ts.map +1 -1
  24. package/dest/avm/index.d.ts +1 -1
  25. package/dest/avm/index.d.ts.map +1 -1
  26. package/dest/avm/index.js +1 -1
  27. package/dest/avm/message_pack.d.ts +1 -0
  28. package/dest/avm/message_pack.d.ts.map +1 -1
  29. package/dest/avm/message_pack.js +28 -5
  30. package/dest/block/attestation_info.d.ts +30 -0
  31. package/dest/block/attestation_info.d.ts.map +1 -0
  32. package/dest/block/attestation_info.js +39 -0
  33. package/dest/block/body.d.ts +4 -1
  34. package/dest/block/body.d.ts.map +1 -1
  35. package/dest/block/body.js +17 -15
  36. package/dest/block/in_block.d.ts +5 -5
  37. package/dest/block/in_block.d.ts.map +1 -1
  38. package/dest/block/index.d.ts +4 -0
  39. package/dest/block/index.d.ts.map +1 -1
  40. package/dest/block/index.js +4 -0
  41. package/dest/block/l2_block.d.ts +21 -13
  42. package/dest/block/l2_block.d.ts.map +1 -1
  43. package/dest/block/l2_block.js +33 -10
  44. package/dest/block/l2_block_code_to_purge.d.ts +3 -14
  45. package/dest/block/l2_block_code_to_purge.d.ts.map +1 -1
  46. package/dest/block/l2_block_code_to_purge.js +23 -13
  47. package/dest/block/l2_block_header.d.ts +100 -0
  48. package/dest/block/l2_block_header.d.ts.map +1 -0
  49. package/dest/block/l2_block_header.js +146 -0
  50. package/dest/block/l2_block_info.d.ts +41 -0
  51. package/dest/block/l2_block_info.d.ts.map +1 -0
  52. package/dest/block/l2_block_info.js +40 -0
  53. package/dest/block/l2_block_source.d.ts +30 -428
  54. package/dest/block/l2_block_source.d.ts.map +1 -1
  55. package/dest/block/l2_block_source.js +0 -28
  56. package/dest/block/l2_block_stream/l2_tips_memory_store.js +1 -1
  57. package/dest/block/proposal/attestations_and_signers.d.ts +48 -0
  58. package/dest/block/proposal/attestations_and_signers.d.ts.map +1 -0
  59. package/dest/block/proposal/attestations_and_signers.js +99 -0
  60. package/dest/block/proposal/index.d.ts +1 -0
  61. package/dest/block/proposal/index.d.ts.map +1 -1
  62. package/dest/block/proposal/index.js +1 -0
  63. package/dest/block/published_l2_block.d.ts +27 -5
  64. package/dest/block/published_l2_block.d.ts.map +1 -1
  65. package/dest/block/published_l2_block.js +20 -7
  66. package/dest/block/test/l2_tips_store_test_suite.d.ts.map +1 -1
  67. package/dest/block/test/l2_tips_store_test_suite.js +3 -4
  68. package/dest/block/validate_block_result.d.ts +222 -0
  69. package/dest/block/validate_block_result.d.ts.map +1 -0
  70. package/dest/block/validate_block_result.js +83 -0
  71. package/dest/checkpoint/checkpoint_body.d.ts +4 -0
  72. package/dest/checkpoint/checkpoint_body.d.ts.map +1 -0
  73. package/dest/checkpoint/checkpoint_body.js +9 -0
  74. package/dest/checkpoint/index.d.ts +2 -0
  75. package/dest/checkpoint/index.d.ts.map +1 -0
  76. package/dest/checkpoint/index.js +1 -0
  77. package/dest/config/node-rpc-config.d.ts +2 -0
  78. package/dest/config/node-rpc-config.d.ts.map +1 -1
  79. package/dest/config/node-rpc-config.js +6 -0
  80. package/dest/contract/contract_address.d.ts +1 -1
  81. package/dest/contract/contract_address.js +1 -1
  82. package/dest/contract/contract_class_metadata.d.ts +8 -0
  83. package/dest/contract/contract_class_metadata.d.ts.map +1 -0
  84. package/dest/contract/contract_class_metadata.js +1 -0
  85. package/dest/contract/contract_instance.d.ts +9 -8
  86. package/dest/contract/contract_instance.d.ts.map +1 -1
  87. package/dest/contract/contract_instance.js +1 -2
  88. package/dest/contract/contract_metadata.d.ts +7 -0
  89. package/dest/contract/contract_metadata.d.ts.map +1 -0
  90. package/dest/contract/contract_metadata.js +1 -0
  91. package/dest/contract/index.d.ts +2 -0
  92. package/dest/contract/index.d.ts.map +1 -1
  93. package/dest/contract/index.js +2 -0
  94. package/dest/contract/interfaces/contract_class.d.ts +4 -4
  95. package/dest/contract/interfaces/contract_instance.d.ts +2 -2
  96. package/dest/epoch-helpers/index.d.ts +8 -2
  97. package/dest/epoch-helpers/index.d.ts.map +1 -1
  98. package/dest/epoch-helpers/index.js +9 -0
  99. package/dest/fees/transaction_fee.d.ts.map +1 -1
  100. package/dest/fees/transaction_fee.js +3 -0
  101. package/dest/file-store/factory.d.ts.map +1 -1
  102. package/dest/file-store/factory.js +18 -0
  103. package/dest/file-store/interface.d.ts +8 -2
  104. package/dest/file-store/interface.d.ts.map +1 -1
  105. package/dest/file-store/s3.d.ts +26 -0
  106. package/dest/file-store/s3.d.ts.map +1 -0
  107. package/dest/file-store/s3.js +252 -0
  108. package/dest/hash/hash.d.ts.map +1 -1
  109. package/dest/hash/hash.js +0 -3
  110. package/dest/interfaces/archiver.d.ts +43 -0
  111. package/dest/interfaces/archiver.d.ts.map +1 -1
  112. package/dest/interfaces/archiver.js +17 -1
  113. package/dest/interfaces/aztec-node-admin.d.ts +87 -40
  114. package/dest/interfaces/aztec-node-admin.d.ts.map +1 -1
  115. package/dest/interfaces/aztec-node-admin.js +7 -1
  116. package/dest/interfaces/aztec-node.d.ts +35 -2
  117. package/dest/interfaces/aztec-node.d.ts.map +1 -1
  118. package/dest/interfaces/aztec-node.js +8 -1
  119. package/dest/interfaces/block-builder.d.ts +7 -8
  120. package/dest/interfaces/block-builder.d.ts.map +1 -1
  121. package/dest/interfaces/client.d.ts +0 -1
  122. package/dest/interfaces/client.d.ts.map +1 -1
  123. package/dest/interfaces/client.js +0 -1
  124. package/dest/interfaces/configs.d.ts +10 -0
  125. package/dest/interfaces/configs.d.ts.map +1 -1
  126. package/dest/interfaces/configs.js +3 -1
  127. package/dest/interfaces/epoch-prover.d.ts +26 -9
  128. package/dest/interfaces/epoch-prover.d.ts.map +1 -1
  129. package/dest/interfaces/merkle_tree_operations.d.ts +5 -0
  130. package/dest/interfaces/merkle_tree_operations.d.ts.map +1 -1
  131. package/dest/interfaces/p2p.d.ts +2 -0
  132. package/dest/interfaces/p2p.d.ts.map +1 -1
  133. package/dest/interfaces/p2p.js +2 -1
  134. package/dest/interfaces/private_kernel_prover.d.ts +2 -2
  135. package/dest/interfaces/private_kernel_prover.d.ts.map +1 -1
  136. package/dest/interfaces/proving-job.d.ts +349 -200
  137. package/dest/interfaces/proving-job.d.ts.map +1 -1
  138. package/dest/interfaces/proving-job.js +131 -113
  139. package/dest/interfaces/server.d.ts +1 -0
  140. package/dest/interfaces/server.d.ts.map +1 -1
  141. package/dest/interfaces/server.js +1 -0
  142. package/dest/interfaces/server_circuit_prover.d.ts +34 -34
  143. package/dest/interfaces/server_circuit_prover.d.ts.map +1 -1
  144. package/dest/interfaces/slasher.d.ts +4 -0
  145. package/dest/interfaces/slasher.d.ts.map +1 -1
  146. package/dest/interfaces/slasher.js +1 -0
  147. package/dest/interfaces/tx_provider.d.ts +1 -1
  148. package/dest/interfaces/tx_provider.d.ts.map +1 -1
  149. package/dest/interfaces/validator.d.ts +163 -0
  150. package/dest/interfaces/validator.d.ts.map +1 -0
  151. package/dest/interfaces/validator.js +18 -0
  152. package/dest/kernel/hints/build_nullifier_read_request_hints.d.ts +3 -2
  153. package/dest/kernel/hints/build_nullifier_read_request_hints.d.ts.map +1 -1
  154. package/dest/kernel/hints/nullifier_read_request_hints.d.ts +4 -3
  155. package/dest/kernel/hints/nullifier_read_request_hints.d.ts.map +1 -1
  156. package/dest/kernel/nullifier.d.ts +2 -2
  157. package/dest/kernel/nullifier.d.ts.map +1 -1
  158. package/dest/kernel/nullifier.js +11 -11
  159. package/dest/kernel/private_call_data.d.ts +4 -24
  160. package/dest/kernel/private_call_data.d.ts.map +1 -1
  161. package/dest/kernel/private_call_data.js +4 -16
  162. package/dest/kernel/private_circuit_public_inputs.d.ts +5 -5
  163. package/dest/kernel/private_circuit_public_inputs.d.ts.map +1 -1
  164. package/dest/kernel/private_circuit_public_inputs.js +7 -7
  165. package/dest/kernel/private_context_inputs.d.ts +2 -2
  166. package/dest/kernel/private_context_inputs.d.ts.map +1 -1
  167. package/dest/kernel/private_context_inputs.js +4 -4
  168. package/dest/kernel/private_kernel_circuit_public_inputs.d.ts +3 -3
  169. package/dest/kernel/private_kernel_circuit_public_inputs.d.ts.map +1 -1
  170. package/dest/kernel/private_kernel_circuit_public_inputs.js +3 -3
  171. package/dest/kernel/private_kernel_init_circuit_private_inputs.d.ts +5 -4
  172. package/dest/kernel/private_kernel_init_circuit_private_inputs.d.ts.map +1 -1
  173. package/dest/kernel/private_kernel_init_circuit_private_inputs.js +7 -6
  174. package/dest/kernel/private_kernel_prover_output.d.ts +1 -1
  175. package/dest/kernel/private_kernel_prover_output.d.ts.map +1 -1
  176. package/dest/kernel/private_kernel_tail_circuit_public_inputs.d.ts +1 -0
  177. package/dest/kernel/private_kernel_tail_circuit_public_inputs.d.ts.map +1 -1
  178. package/dest/kernel/private_kernel_tail_circuit_public_inputs.js +4 -1
  179. package/dest/kernel/private_to_public_accumulated_data.d.ts +1 -1
  180. package/dest/kernel/private_to_public_kernel_circuit_public_inputs.d.ts +2 -0
  181. package/dest/kernel/private_to_public_kernel_circuit_public_inputs.d.ts.map +1 -1
  182. package/dest/kernel/private_to_public_kernel_circuit_public_inputs.js +7 -0
  183. package/dest/kernel/private_to_rollup_accumulated_data.d.ts +1 -1
  184. package/dest/keys/derivation.d.ts +0 -2
  185. package/dest/keys/derivation.d.ts.map +1 -1
  186. package/dest/keys/derivation.js +1 -21
  187. package/dest/logs/contract_class_log.d.ts +1 -1
  188. package/dest/logs/contract_class_log.d.ts.map +1 -1
  189. package/dest/logs/contract_class_log.js +1 -3
  190. package/dest/logs/debug_log.d.ts +13 -0
  191. package/dest/logs/debug_log.d.ts.map +1 -0
  192. package/dest/logs/debug_log.js +26 -0
  193. package/dest/logs/directional_app_tagging_secret.d.ts +40 -0
  194. package/dest/logs/directional_app_tagging_secret.d.ts.map +1 -0
  195. package/dest/logs/directional_app_tagging_secret.js +64 -0
  196. package/dest/logs/index.d.ts +3 -1
  197. package/dest/logs/index.d.ts.map +1 -1
  198. package/dest/logs/index.js +3 -1
  199. package/dest/logs/log_with_tx_data.d.ts +9 -12
  200. package/dest/logs/log_with_tx_data.d.ts.map +1 -1
  201. package/dest/logs/log_with_tx_data.js +18 -23
  202. package/dest/logs/pre_tag.d.ts +34 -0
  203. package/dest/logs/pre_tag.d.ts.map +1 -0
  204. package/dest/logs/pre_tag.js +7 -0
  205. package/dest/logs/public_log.d.ts +23 -10
  206. package/dest/logs/public_log.d.ts.map +1 -1
  207. package/dest/logs/public_log.js +117 -42
  208. package/dest/messaging/inbox_leaf.d.ts +2 -0
  209. package/dest/messaging/inbox_leaf.d.ts.map +1 -1
  210. package/dest/messaging/inbox_leaf.js +3 -0
  211. package/dest/messaging/l2_to_l1_membership.d.ts +1 -1
  212. package/dest/messaging/l2_to_l1_membership.d.ts.map +1 -1
  213. package/dest/messaging/l2_to_l1_membership.js +16 -18
  214. package/dest/noir/index.d.ts +11 -0
  215. package/dest/noir/index.d.ts.map +1 -1
  216. package/dest/note/index.d.ts +1 -1
  217. package/dest/note/index.d.ts.map +1 -1
  218. package/dest/note/index.js +1 -1
  219. package/dest/note/notes_filter.d.ts +0 -5
  220. package/dest/note/notes_filter.d.ts.map +1 -1
  221. package/dest/note/notes_filter.js +0 -3
  222. package/dest/note/unique_note.d.ts +43 -0
  223. package/dest/note/unique_note.d.ts.map +1 -0
  224. package/dest/note/{extended_note.js → unique_note.js} +9 -48
  225. package/dest/p2p/block_attestation.d.ts +45 -9
  226. package/dest/p2p/block_attestation.d.ts.map +1 -1
  227. package/dest/p2p/block_attestation.js +37 -15
  228. package/dest/p2p/block_proposal.d.ts +7 -9
  229. package/dest/p2p/block_proposal.d.ts.map +1 -1
  230. package/dest/p2p/block_proposal.js +13 -14
  231. package/dest/p2p/consensus_payload.d.ts +35 -6
  232. package/dest/p2p/consensus_payload.d.ts.map +1 -1
  233. package/dest/p2p/consensus_payload.js +21 -8
  234. package/dest/p2p/gossipable.d.ts +2 -4
  235. package/dest/p2p/gossipable.d.ts.map +1 -1
  236. package/dest/p2p/gossipable.js +5 -14
  237. package/dest/p2p/signature_utils.d.ts +2 -1
  238. package/dest/p2p/signature_utils.d.ts.map +1 -1
  239. package/dest/p2p/signature_utils.js +1 -0
  240. package/dest/parity/index.d.ts +2 -3
  241. package/dest/parity/index.d.ts.map +1 -1
  242. package/dest/parity/index.js +2 -3
  243. package/dest/parity/{base_parity_inputs.d.ts → parity_base_private_inputs.d.ts} +7 -7
  244. package/dest/parity/parity_base_private_inputs.d.ts.map +1 -0
  245. package/dest/parity/{base_parity_inputs.js → parity_base_private_inputs.js} +10 -6
  246. package/dest/parity/parity_root_private_inputs.d.ts +39 -0
  247. package/dest/parity/parity_root_private_inputs.d.ts.map +1 -0
  248. package/dest/parity/{root_parity_inputs.js → parity_root_private_inputs.js} +12 -13
  249. package/dest/proofs/client_ivc_proof.d.ts +17 -7
  250. package/dest/proofs/client_ivc_proof.d.ts.map +1 -1
  251. package/dest/proofs/client_ivc_proof.js +78 -19
  252. package/dest/proofs/index.d.ts +1 -0
  253. package/dest/proofs/index.d.ts.map +1 -1
  254. package/dest/proofs/index.js +1 -0
  255. package/dest/proofs/proof_data.d.ts +21 -0
  256. package/dest/proofs/proof_data.d.ts.map +1 -0
  257. package/dest/proofs/proof_data.js +22 -0
  258. package/dest/proofs/proving_request_type.d.ts +17 -13
  259. package/dest/proofs/proving_request_type.d.ts.map +1 -1
  260. package/dest/proofs/proving_request_type.js +17 -12
  261. package/dest/rollup/avm_proof_data.d.ts +2 -12
  262. package/dest/rollup/avm_proof_data.d.ts.map +1 -1
  263. package/dest/rollup/avm_proof_data.js +0 -24
  264. package/dest/rollup/base_rollup_hints.d.ts +17 -17
  265. package/dest/rollup/base_rollup_hints.d.ts.map +1 -1
  266. package/dest/rollup/base_rollup_hints.js +26 -26
  267. package/dest/rollup/block_constant_data.d.ts +24 -10
  268. package/dest/rollup/block_constant_data.d.ts.map +1 -1
  269. package/dest/rollup/block_constant_data.js +18 -10
  270. package/dest/rollup/{block_merge_rollup.d.ts → block_merge_rollup_private_inputs.d.ts} +17 -10
  271. package/dest/rollup/block_merge_rollup_private_inputs.d.ts.map +1 -0
  272. package/dest/rollup/{block_merge_rollup.js → block_merge_rollup_private_inputs.js} +14 -13
  273. package/dest/rollup/block_rollup_public_inputs.d.ts +124 -0
  274. package/dest/rollup/block_rollup_public_inputs.d.ts.map +1 -0
  275. package/dest/rollup/block_rollup_public_inputs.js +85 -0
  276. package/dest/rollup/block_root_rollup_private_inputs.d.ts +236 -0
  277. package/dest/rollup/block_root_rollup_private_inputs.d.ts.map +1 -0
  278. package/dest/rollup/block_root_rollup_private_inputs.js +257 -0
  279. package/dest/rollup/checkpoint_constant_data.d.ts +54 -0
  280. package/dest/rollup/checkpoint_constant_data.d.ts.map +1 -0
  281. package/dest/rollup/checkpoint_constant_data.js +55 -0
  282. package/dest/{tx/proposed_block_header.d.ts → rollup/checkpoint_header.d.ts} +12 -11
  283. package/dest/rollup/checkpoint_header.d.ts.map +1 -0
  284. package/dest/{tx/proposed_block_header.js → rollup/checkpoint_header.js} +14 -8
  285. package/dest/rollup/checkpoint_merge_rollup_private_inputs.d.ts +30 -0
  286. package/dest/rollup/checkpoint_merge_rollup_private_inputs.d.ts.map +1 -0
  287. package/dest/rollup/checkpoint_merge_rollup_private_inputs.js +37 -0
  288. package/dest/rollup/checkpoint_rollup_public_inputs.d.ts +106 -0
  289. package/dest/rollup/checkpoint_rollup_public_inputs.d.ts.map +1 -0
  290. package/dest/rollup/checkpoint_rollup_public_inputs.js +108 -0
  291. package/dest/rollup/checkpoint_root_rollup_private_inputs.d.ts +123 -0
  292. package/dest/rollup/checkpoint_root_rollup_private_inputs.d.ts.map +1 -0
  293. package/dest/rollup/checkpoint_root_rollup_private_inputs.js +178 -0
  294. package/dest/rollup/epoch_constant_data.d.ts +23 -6
  295. package/dest/rollup/epoch_constant_data.d.ts.map +1 -1
  296. package/dest/rollup/epoch_constant_data.js +25 -12
  297. package/dest/rollup/index.d.ts +17 -16
  298. package/dest/rollup/index.d.ts.map +1 -1
  299. package/dest/rollup/index.js +17 -16
  300. package/dest/rollup/private_tx_base_rollup_private_inputs.d.ts +21 -0
  301. package/dest/rollup/private_tx_base_rollup_private_inputs.d.ts.map +1 -0
  302. package/dest/rollup/private_tx_base_rollup_private_inputs.js +42 -0
  303. package/dest/rollup/public_tube_private_inputs.d.ts +21 -0
  304. package/dest/rollup/public_tube_private_inputs.d.ts.map +1 -0
  305. package/dest/rollup/public_tube_private_inputs.js +42 -0
  306. package/dest/rollup/public_tube_public_inputs.d.ts +20 -0
  307. package/dest/rollup/public_tube_public_inputs.d.ts.map +1 -0
  308. package/dest/rollup/public_tube_public_inputs.js +41 -0
  309. package/dest/rollup/public_tx_base_rollup_private_inputs.d.ts +23 -0
  310. package/dest/rollup/public_tx_base_rollup_private_inputs.d.ts.map +1 -0
  311. package/dest/rollup/public_tx_base_rollup_private_inputs.js +46 -0
  312. package/dest/rollup/root_rollup_private_inputs.d.ts +67 -0
  313. package/dest/rollup/root_rollup_private_inputs.d.ts.map +1 -0
  314. package/dest/rollup/root_rollup_private_inputs.js +69 -0
  315. package/dest/rollup/root_rollup_public_inputs.d.ts +46 -0
  316. package/dest/rollup/root_rollup_public_inputs.d.ts.map +1 -0
  317. package/dest/rollup/root_rollup_public_inputs.js +71 -0
  318. package/dest/rollup/{state_diff_hints.d.ts → tree_snapshot_diff_hints.d.ts} +22 -38
  319. package/dest/rollup/tree_snapshot_diff_hints.d.ts.map +1 -0
  320. package/dest/rollup/tree_snapshot_diff_hints.js +75 -0
  321. package/dest/rollup/{merge_rollup.d.ts → tx_merge_rollup_private_inputs.d.ts} +11 -10
  322. package/dest/rollup/tx_merge_rollup_private_inputs.d.ts.map +1 -0
  323. package/dest/rollup/{merge_rollup.js → tx_merge_rollup_private_inputs.js} +14 -13
  324. package/dest/rollup/{base_or_merge_rollup_public_inputs.d.ts → tx_rollup_public_inputs.d.ts} +14 -14
  325. package/dest/rollup/tx_rollup_public_inputs.d.ts.map +1 -0
  326. package/dest/rollup/{base_or_merge_rollup_public_inputs.js → tx_rollup_public_inputs.js} +15 -15
  327. package/dest/slashing/types.d.ts +1 -0
  328. package/dest/slashing/types.d.ts.map +1 -1
  329. package/dest/slashing/types.js +22 -0
  330. package/dest/snapshots/download.d.ts.map +1 -1
  331. package/dest/snapshots/download.js +58 -2
  332. package/dest/snapshots/upload.d.ts.map +1 -1
  333. package/dest/snapshots/upload.js +1 -0
  334. package/dest/stats/stats.d.ts +1 -1
  335. package/dest/stats/stats.d.ts.map +1 -1
  336. package/dest/tests/factories.d.ts +42 -74
  337. package/dest/tests/factories.d.ts.map +1 -1
  338. package/dest/tests/factories.js +144 -167
  339. package/dest/tests/mocks.d.ts +14 -8
  340. package/dest/tests/mocks.d.ts.map +1 -1
  341. package/dest/tests/mocks.js +53 -31
  342. package/dest/trees/index.d.ts +0 -1
  343. package/dest/trees/index.d.ts.map +1 -1
  344. package/dest/trees/index.js +0 -1
  345. package/dest/trees/merkle_tree_id.d.ts +4 -4
  346. package/dest/trees/nullifier_membership_witness.d.ts +3 -3
  347. package/dest/tx/block_header.d.ts +12 -13
  348. package/dest/tx/block_header.d.ts.map +1 -1
  349. package/dest/tx/block_header.js +16 -21
  350. package/dest/tx/content_commitment.d.ts +1 -0
  351. package/dest/tx/content_commitment.d.ts.map +1 -1
  352. package/dest/tx/content_commitment.js +3 -0
  353. package/dest/tx/global_variables.d.ts.map +1 -1
  354. package/dest/tx/global_variables.js +0 -1
  355. package/dest/tx/index.d.ts +2 -1
  356. package/dest/tx/index.d.ts.map +1 -1
  357. package/dest/tx/index.js +2 -1
  358. package/dest/tx/indexed_tx_effect.d.ts +3 -3
  359. package/dest/tx/partial_state_reference.d.ts +1 -0
  360. package/dest/tx/partial_state_reference.d.ts.map +1 -1
  361. package/dest/tx/partial_state_reference.js +3 -0
  362. package/dest/tx/private_execution_result.d.ts +7 -2
  363. package/dest/tx/private_execution_result.d.ts.map +1 -1
  364. package/dest/tx/private_execution_result.js +10 -6
  365. package/dest/tx/private_tx_constant_data.d.ts +60 -0
  366. package/dest/tx/private_tx_constant_data.d.ts.map +1 -0
  367. package/dest/tx/private_tx_constant_data.js +69 -0
  368. package/dest/tx/processed_tx.d.ts +0 -1
  369. package/dest/tx/processed_tx.d.ts.map +1 -1
  370. package/dest/tx/processed_tx.js +1 -6
  371. package/dest/tx/profiling.d.ts.map +1 -1
  372. package/dest/tx/profiling.js +0 -2
  373. package/dest/tx/protocol_contracts.d.ts +29 -0
  374. package/dest/tx/protocol_contracts.d.ts.map +1 -0
  375. package/dest/tx/protocol_contracts.js +49 -0
  376. package/dest/tx/simulated_tx.d.ts +3 -3
  377. package/dest/tx/state_reference.d.ts +1 -0
  378. package/dest/tx/state_reference.d.ts.map +1 -1
  379. package/dest/tx/state_reference.js +4 -1
  380. package/dest/tx/tx.d.ts +6 -9
  381. package/dest/tx/tx.d.ts.map +1 -1
  382. package/dest/tx/tx.js +10 -11
  383. package/dest/tx/tx_constant_data.d.ts +6 -38
  384. package/dest/tx/tx_constant_data.d.ts.map +1 -1
  385. package/dest/tx/tx_constant_data.js +11 -20
  386. package/dest/tx/tx_effect.d.ts +3 -36
  387. package/dest/tx/tx_effect.d.ts.map +1 -1
  388. package/dest/tx/tx_effect.js +63 -202
  389. package/dest/tx/validator/error_texts.d.ts +1 -1
  390. package/dest/tx/validator/error_texts.d.ts.map +1 -1
  391. package/dest/tx/validator/error_texts.js +1 -1
  392. package/dest/update-checker/update-checker.d.ts +1 -1
  393. package/dest/update-checker/update-checker.d.ts.map +1 -1
  394. package/dest/update-checker/update-checker.js +1 -1
  395. package/dest/validators/schemas.d.ts +42 -4
  396. package/dest/validators/schemas.d.ts.map +1 -1
  397. package/dest/validators/schemas.js +5 -4
  398. package/dest/validators/types.d.ts +8 -10
  399. package/dest/validators/types.d.ts.map +1 -1
  400. package/dest/versioning/versioning.d.ts +2 -2
  401. package/dest/versioning/versioning.d.ts.map +1 -1
  402. package/dest/versioning/versioning.js +18 -13
  403. package/dest/world-state/index.d.ts +2 -0
  404. package/dest/world-state/index.d.ts.map +1 -0
  405. package/dest/world-state/index.js +1 -0
  406. package/dest/world-state/world_state_revision.d.ts +22 -0
  407. package/dest/world-state/world_state_revision.d.ts.map +1 -0
  408. package/dest/world-state/world_state_revision.js +21 -0
  409. package/dest/zkpassport/index.d.ts +17 -11
  410. package/dest/zkpassport/index.d.ts.map +1 -1
  411. package/dest/zkpassport/index.js +21 -15
  412. package/package.json +15 -11
  413. package/src/abi/abi.ts +1 -1
  414. package/src/abi/contract_artifact.ts +3 -0
  415. package/src/abi/event_metadata_definition.ts +8 -0
  416. package/src/abi/function_call.ts +5 -1
  417. package/src/abi/index.ts +1 -0
  418. package/src/avm/avm.ts +15 -7
  419. package/src/avm/avm_accumulated_data.ts +25 -29
  420. package/src/avm/avm_circuit_public_inputs.ts +21 -0
  421. package/src/avm/index.ts +1 -1
  422. package/src/avm/message_pack.ts +25 -1
  423. package/src/block/attestation_info.ts +62 -0
  424. package/src/block/body.ts +25 -23
  425. package/src/block/index.ts +4 -0
  426. package/src/block/l2_block.ts +39 -19
  427. package/src/block/l2_block_code_to_purge.ts +30 -31
  428. package/src/block/l2_block_header.ts +232 -0
  429. package/src/block/l2_block_info.ts +63 -0
  430. package/src/block/l2_block_source.ts +33 -51
  431. package/src/block/l2_block_stream/l2_tips_memory_store.ts +1 -1
  432. package/src/block/proposal/attestations_and_signers.ts +121 -0
  433. package/src/block/proposal/index.ts +1 -0
  434. package/src/block/published_l2_block.ts +37 -15
  435. package/src/block/test/l2_tips_store_test_suite.ts +7 -7
  436. package/src/block/validate_block_result.ts +122 -0
  437. package/src/checkpoint/checkpoint_body.ts +10 -0
  438. package/src/checkpoint/index.ts +1 -0
  439. package/src/config/node-rpc-config.ts +9 -0
  440. package/src/contract/contract_address.ts +1 -1
  441. package/src/contract/contract_class_metadata.ts +8 -0
  442. package/src/contract/contract_instance.ts +11 -10
  443. package/src/contract/contract_metadata.ts +7 -0
  444. package/src/contract/index.ts +2 -0
  445. package/src/contract/interfaces/contract_class.ts +1 -1
  446. package/src/epoch-helpers/index.ts +24 -2
  447. package/src/fees/transaction_fee.ts +11 -0
  448. package/src/file-store/factory.ts +15 -0
  449. package/src/file-store/interface.ts +8 -2
  450. package/src/file-store/s3.ts +254 -0
  451. package/src/hash/hash.ts +0 -4
  452. package/src/interfaces/archiver.ts +46 -1
  453. package/src/interfaces/aztec-node-admin.ts +17 -1
  454. package/src/interfaces/aztec-node.ts +53 -2
  455. package/src/interfaces/block-builder.ts +11 -12
  456. package/src/interfaces/client.ts +0 -1
  457. package/src/interfaces/configs.ts +6 -0
  458. package/src/interfaces/epoch-prover.ts +35 -11
  459. package/src/interfaces/merkle_tree_operations.ts +6 -0
  460. package/src/interfaces/p2p.ts +4 -0
  461. package/src/interfaces/private_kernel_prover.ts +2 -2
  462. package/src/interfaces/proving-job.ts +215 -134
  463. package/src/interfaces/server.ts +1 -0
  464. package/src/interfaces/server_circuit_prover.ts +87 -61
  465. package/src/interfaces/slasher.ts +2 -0
  466. package/src/interfaces/tx_provider.ts +1 -0
  467. package/src/interfaces/validator.ts +95 -0
  468. package/src/kernel/hints/build_nullifier_read_request_hints.ts +3 -2
  469. package/src/kernel/hints/nullifier_read_request_hints.ts +3 -3
  470. package/src/kernel/nullifier.ts +8 -8
  471. package/src/kernel/private_call_data.ts +2 -21
  472. package/src/kernel/private_circuit_public_inputs.ts +5 -5
  473. package/src/kernel/private_context_inputs.ts +2 -2
  474. package/src/kernel/private_kernel_circuit_public_inputs.ts +4 -4
  475. package/src/kernel/private_kernel_init_circuit_private_inputs.ts +5 -4
  476. package/src/kernel/private_kernel_prover_output.ts +1 -1
  477. package/src/kernel/private_kernel_tail_circuit_public_inputs.ts +8 -2
  478. package/src/kernel/private_to_public_kernel_circuit_public_inputs.ts +9 -0
  479. package/src/keys/derivation.ts +1 -26
  480. package/src/logs/contract_class_log.ts +2 -3
  481. package/src/logs/debug_log.ts +32 -0
  482. package/src/logs/directional_app_tagging_secret.ts +78 -0
  483. package/src/logs/index.ts +3 -1
  484. package/src/logs/log_with_tx_data.ts +14 -24
  485. package/src/logs/pre_tag.ts +25 -0
  486. package/src/logs/public_log.ts +120 -58
  487. package/src/messaging/inbox_leaf.ts +5 -0
  488. package/src/messaging/l2_to_l1_membership.ts +20 -26
  489. package/src/noir/index.ts +11 -0
  490. package/src/note/index.ts +1 -1
  491. package/src/note/notes_filter.ts +0 -7
  492. package/src/note/{extended_note.ts → unique_note.ts} +14 -75
  493. package/src/p2p/block_attestation.ts +46 -15
  494. package/src/p2p/block_proposal.ts +15 -18
  495. package/src/p2p/consensus_payload.ts +30 -10
  496. package/src/p2p/gossipable.ts +6 -16
  497. package/src/p2p/signature_utils.ts +1 -0
  498. package/src/parity/index.ts +2 -3
  499. package/src/parity/{base_parity_inputs.ts → parity_base_private_inputs.ts} +13 -11
  500. package/src/parity/{root_parity_inputs.ts → parity_root_private_inputs.ts} +16 -18
  501. package/src/proofs/client_ivc_proof.ts +86 -20
  502. package/src/proofs/index.ts +1 -0
  503. package/src/proofs/proof_data.ts +36 -0
  504. package/src/proofs/proving_request_type.ts +14 -10
  505. package/src/rollup/avm_proof_data.ts +2 -31
  506. package/src/rollup/base_rollup_hints.ts +22 -22
  507. package/src/rollup/block_constant_data.ts +16 -6
  508. package/src/rollup/{block_merge_rollup.ts → block_merge_rollup_private_inputs.ts} +15 -11
  509. package/src/rollup/block_rollup_public_inputs.ts +123 -0
  510. package/src/rollup/block_root_rollup_private_inputs.ts +312 -0
  511. package/src/rollup/checkpoint_constant_data.ts +84 -0
  512. package/src/{tx/proposed_block_header.ts → rollup/checkpoint_header.ts} +40 -15
  513. package/src/rollup/checkpoint_merge_rollup_private_inputs.ts +49 -0
  514. package/src/rollup/{block_root_or_block_merge_public_inputs.ts → checkpoint_rollup_public_inputs.ts} +30 -52
  515. package/src/rollup/checkpoint_root_rollup_private_inputs.ts +218 -0
  516. package/src/rollup/epoch_constant_data.ts +28 -10
  517. package/src/rollup/index.ts +17 -16
  518. package/src/rollup/private_tx_base_rollup_private_inputs.ts +53 -0
  519. package/src/rollup/public_tube_private_inputs.ts +53 -0
  520. package/src/rollup/public_tube_public_inputs.ts +52 -0
  521. package/src/rollup/public_tx_base_rollup_private_inputs.ts +57 -0
  522. package/src/rollup/root_rollup_private_inputs.ts +90 -0
  523. package/src/rollup/root_rollup_public_inputs.ts +99 -0
  524. package/src/rollup/{state_diff_hints.ts → tree_snapshot_diff_hints.ts} +26 -41
  525. package/src/rollup/{merge_rollup.ts → tx_merge_rollup_private_inputs.ts} +13 -9
  526. package/src/rollup/{base_or_merge_rollup_public_inputs.ts → tx_rollup_public_inputs.ts} +13 -13
  527. package/src/slashing/types.ts +23 -0
  528. package/src/snapshots/download.ts +66 -2
  529. package/src/snapshots/upload.ts +1 -0
  530. package/src/stats/stats.ts +19 -13
  531. package/src/tests/factories.ts +217 -275
  532. package/src/tests/mocks.ts +87 -57
  533. package/src/trees/index.ts +0 -1
  534. package/src/tx/block_header.ts +17 -32
  535. package/src/tx/content_commitment.ts +4 -0
  536. package/src/tx/global_variables.ts +0 -1
  537. package/src/tx/index.ts +2 -1
  538. package/src/tx/partial_state_reference.ts +8 -0
  539. package/src/tx/private_execution_result.ts +9 -3
  540. package/src/tx/private_tx_constant_data.ts +94 -0
  541. package/src/tx/processed_tx.ts +1 -7
  542. package/src/tx/profiling.ts +0 -2
  543. package/src/tx/protocol_contracts.ts +70 -0
  544. package/src/tx/state_reference.ts +5 -1
  545. package/src/tx/tx.ts +12 -13
  546. package/src/tx/tx_constant_data.ts +8 -21
  547. package/src/tx/tx_effect.ts +64 -213
  548. package/src/tx/validator/error_texts.ts +1 -1
  549. package/src/update-checker/update-checker.ts +1 -1
  550. package/src/validators/schemas.ts +6 -4
  551. package/src/validators/types.ts +9 -10
  552. package/src/versioning/versioning.ts +20 -15
  553. package/src/world-state/index.ts +1 -0
  554. package/src/world-state/world_state_revision.ts +21 -0
  555. package/src/zkpassport/index.ts +42 -30
  556. package/dest/avm/public_data_hint.d.ts +0 -16
  557. package/dest/avm/public_data_hint.d.ts.map +0 -1
  558. package/dest/avm/public_data_hint.js +0 -27
  559. package/dest/interfaces/pxe.d.ts +0 -329
  560. package/dest/interfaces/pxe.d.ts.map +0 -1
  561. package/dest/interfaces/pxe.js +0 -100
  562. package/dest/logs/indexed_tagging_secret.d.ts +0 -28
  563. package/dest/logs/indexed_tagging_secret.d.ts.map +0 -1
  564. package/dest/logs/indexed_tagging_secret.js +0 -50
  565. package/dest/note/extended_note.d.ts +0 -111
  566. package/dest/note/extended_note.d.ts.map +0 -1
  567. package/dest/parity/base_parity_inputs.d.ts.map +0 -1
  568. package/dest/parity/root_parity_input.d.ts +0 -52
  569. package/dest/parity/root_parity_input.d.ts.map +0 -1
  570. package/dest/parity/root_parity_input.js +0 -50
  571. package/dest/parity/root_parity_inputs.d.ts +0 -37
  572. package/dest/parity/root_parity_inputs.d.ts.map +0 -1
  573. package/dest/rollup/base_or_merge_rollup_public_inputs.d.ts.map +0 -1
  574. package/dest/rollup/block_merge_rollup.d.ts.map +0 -1
  575. package/dest/rollup/block_root_or_block_merge_public_inputs.d.ts +0 -134
  576. package/dest/rollup/block_root_or_block_merge_public_inputs.d.ts.map +0 -1
  577. package/dest/rollup/block_root_or_block_merge_public_inputs.js +0 -125
  578. package/dest/rollup/block_root_rollup.d.ts +0 -283
  579. package/dest/rollup/block_root_rollup.d.ts.map +0 -1
  580. package/dest/rollup/block_root_rollup.js +0 -306
  581. package/dest/rollup/empty_block_root_rollup_inputs.d.ts +0 -51
  582. package/dest/rollup/empty_block_root_rollup_inputs.d.ts.map +0 -1
  583. package/dest/rollup/empty_block_root_rollup_inputs.js +0 -65
  584. package/dest/rollup/merge_rollup.d.ts.map +0 -1
  585. package/dest/rollup/padding_block_root_rollup_inputs.d.ts +0 -20
  586. package/dest/rollup/padding_block_root_rollup_inputs.d.ts.map +0 -1
  587. package/dest/rollup/padding_block_root_rollup_inputs.js +0 -39
  588. package/dest/rollup/previous_rollup_block_data.d.ts +0 -47
  589. package/dest/rollup/previous_rollup_block_data.d.ts.map +0 -1
  590. package/dest/rollup/previous_rollup_block_data.js +0 -37
  591. package/dest/rollup/previous_rollup_data.d.ts +0 -47
  592. package/dest/rollup/previous_rollup_data.d.ts.map +0 -1
  593. package/dest/rollup/previous_rollup_data.js +0 -37
  594. package/dest/rollup/private_base_rollup_inputs.d.ts +0 -21
  595. package/dest/rollup/private_base_rollup_inputs.d.ts.map +0 -1
  596. package/dest/rollup/private_base_rollup_inputs.js +0 -44
  597. package/dest/rollup/private_tube_data.d.ts +0 -15
  598. package/dest/rollup/private_tube_data.d.ts.map +0 -1
  599. package/dest/rollup/private_tube_data.js +0 -25
  600. package/dest/rollup/public_base_rollup_inputs.d.ts +0 -23
  601. package/dest/rollup/public_base_rollup_inputs.d.ts.map +0 -1
  602. package/dest/rollup/public_base_rollup_inputs.js +0 -48
  603. package/dest/rollup/public_tube_data.d.ts +0 -15
  604. package/dest/rollup/public_tube_data.d.ts.map +0 -1
  605. package/dest/rollup/public_tube_data.js +0 -25
  606. package/dest/rollup/root_rollup.d.ts +0 -106
  607. package/dest/rollup/root_rollup.d.ts.map +0 -1
  608. package/dest/rollup/root_rollup.js +0 -147
  609. package/dest/rollup/state_diff_hints.d.ts.map +0 -1
  610. package/dest/rollup/state_diff_hints.js +0 -85
  611. package/dest/rollup/tube_inputs.d.ts +0 -43
  612. package/dest/rollup/tube_inputs.d.ts.map +0 -1
  613. package/dest/rollup/tube_inputs.js +0 -63
  614. package/dest/trees/protocol_contract_leaf.d.ts +0 -84
  615. package/dest/trees/protocol_contract_leaf.d.ts.map +0 -1
  616. package/dest/trees/protocol_contract_leaf.js +0 -100
  617. package/dest/tx/proposed_block_header.d.ts.map +0 -1
  618. package/src/avm/public_data_hint.ts +0 -38
  619. package/src/interfaces/pxe.ts +0 -532
  620. package/src/logs/indexed_tagging_secret.ts +0 -48
  621. package/src/parity/root_parity_input.ts +0 -71
  622. package/src/rollup/block_root_rollup.ts +0 -380
  623. package/src/rollup/empty_block_root_rollup_inputs.ts +0 -80
  624. package/src/rollup/padding_block_root_rollup_inputs.ts +0 -47
  625. package/src/rollup/previous_rollup_block_data.ts +0 -48
  626. package/src/rollup/previous_rollup_data.ts +0 -48
  627. package/src/rollup/private_base_rollup_inputs.ts +0 -53
  628. package/src/rollup/private_tube_data.ts +0 -35
  629. package/src/rollup/public_base_rollup_inputs.ts +0 -59
  630. package/src/rollup/public_tube_data.ts +0 -35
  631. package/src/rollup/root_rollup.ts +0 -195
  632. package/src/rollup/tube_inputs.ts +0 -77
  633. package/src/trees/protocol_contract_leaf.ts +0 -128
@@ -0,0 +1,62 @@
1
+ import { recoverAddress } from '@aztec/foundation/crypto';
2
+ import type { EthAddress } from '@aztec/foundation/eth-address';
3
+
4
+ import { ConsensusPayload } from '../p2p/consensus_payload.js';
5
+ import { SignatureDomainSeparator, getHashedSignaturePayloadEthSignedMessage } from '../p2p/signature_utils.js';
6
+ import type { L2Block } from './l2_block.js';
7
+ import type { CommitteeAttestation } from './proposal/committee_attestation.js';
8
+
9
+ /**
10
+ * Status indicating how the attestation address was determined
11
+ */
12
+ export type AttestationStatus = 'recovered-from-signature' | 'provided-as-address' | 'invalid-signature' | 'empty';
13
+
14
+ /**
15
+ * Information about an attestation extracted from a published block
16
+ */
17
+ export type AttestationInfo =
18
+ | {
19
+ /** The validator's address, undefined if signature recovery failed or empty */
20
+ address?: undefined;
21
+ /** How the attestation address was determined */
22
+ status: Extract<AttestationStatus, 'invalid-signature' | 'empty'>;
23
+ }
24
+ | {
25
+ /** The validator's address */
26
+ address: EthAddress;
27
+ /** How the attestation address was determined */
28
+ status: Extract<AttestationStatus, 'provided-as-address' | 'recovered-from-signature'>;
29
+ };
30
+
31
+ /**
32
+ * Extracts attestation information from a published L2 block.
33
+ * Returns info for each attestation, preserving array indices.
34
+ */
35
+ export function getAttestationInfoFromPublishedL2Block(block: {
36
+ attestations: CommitteeAttestation[];
37
+ block: L2Block;
38
+ }): AttestationInfo[] {
39
+ const payload = ConsensusPayload.fromBlock(block.block);
40
+ const hashedPayload = getHashedSignaturePayloadEthSignedMessage(payload, SignatureDomainSeparator.blockAttestation);
41
+
42
+ return block.attestations.map(attestation => {
43
+ // If signature is empty, check if we have an address directly
44
+ if (attestation.signature.isEmpty()) {
45
+ if (attestation.address.isZero()) {
46
+ // No signature and no address - empty
47
+ return { status: 'empty' as const };
48
+ }
49
+ // Address provided without signature
50
+ return { address: attestation.address, status: 'provided-as-address' as const };
51
+ }
52
+
53
+ // Try to recover address from signature
54
+ try {
55
+ const recoveredAddress = recoverAddress(hashedPayload, attestation.signature);
56
+ return { address: recoveredAddress, status: 'recovered-from-signature' as const };
57
+ } catch {
58
+ // Signature present but recovery failed
59
+ return { status: 'invalid-signature' as const };
60
+ }
61
+ });
62
+ }
package/src/block/body.ts CHANGED
@@ -1,6 +1,6 @@
1
- import { BLOBS_PER_BLOCK, FIELDS_PER_BLOB } from '@aztec/constants';
1
+ import { createBlockEndMarker, getNumTxsFromBlockEndMarker, isBlockEndMarker } from '@aztec/blob-lib/encoding';
2
2
  import { timesParallel } from '@aztec/foundation/collection';
3
- import type { Fr } from '@aztec/foundation/fields';
3
+ import { Fr } from '@aztec/foundation/fields';
4
4
  import { BufferReader, FieldReader, serializeToBuffer } from '@aztec/foundation/serialize';
5
5
 
6
6
  import { inspect } from 'util';
@@ -9,14 +9,16 @@ import { z } from 'zod';
9
9
  import type { ZodFor } from '../schemas/index.js';
10
10
  import { TxEffect } from '../tx/tx_effect.js';
11
11
 
12
+ export { createBlockEndMarker };
13
+
14
+ export function getBlockBlobFields(txEffects: TxEffect[]) {
15
+ const blobFields = txEffects.flatMap(txEffect => txEffect.toBlobFields());
16
+ blobFields.push(createBlockEndMarker(txEffects.length));
17
+ return blobFields;
18
+ }
19
+
12
20
  export class Body {
13
- constructor(public txEffects: TxEffect[]) {
14
- txEffects.forEach(txEffect => {
15
- if (txEffect.isEmpty()) {
16
- throw new Error('Empty tx effect not allowed in Body');
17
- }
18
- });
19
- }
21
+ constructor(public txEffects: TxEffect[]) {}
20
22
 
21
23
  equals(other: Body) {
22
24
  return (
@@ -54,19 +56,7 @@ export class Body {
54
56
  * Returns a flat packed array of fields of all tx effects - used for blobs.
55
57
  */
56
58
  toBlobFields() {
57
- let flattened: Fr[] = [];
58
- this.txEffects.forEach((effect: TxEffect) => {
59
- flattened = flattened.concat(effect.toBlobFields());
60
- });
61
- if (flattened.length > BLOBS_PER_BLOCK * FIELDS_PER_BLOB) {
62
- throw new Error(
63
- `Attempted to overfill block's blobs with ${flattened.length} elements. The maximum is ${
64
- BLOBS_PER_BLOCK * FIELDS_PER_BLOB
65
- }`,
66
- );
67
- }
68
-
69
- return flattened;
59
+ return getBlockBlobFields(this.txEffects);
70
60
  }
71
61
 
72
62
  /**
@@ -74,10 +64,22 @@ export class Body {
74
64
  */
75
65
  static fromBlobFields(fields: Fr[]) {
76
66
  const txEffects: TxEffect[] = [];
77
- const reader = new FieldReader(fields);
67
+ const reader = new FieldReader(fields.slice(0, -1));
78
68
  while (!reader.isFinished()) {
79
69
  txEffects.push(TxEffect.fromBlobFields(reader));
80
70
  }
71
+
72
+ // If the fields are from a proven block, or are constructed by calling `toBlobFields`, the following errors should never throw.
73
+
74
+ if (!isBlockEndMarker(fields[fields.length - 1])) {
75
+ throw new Error('Block end marker not found');
76
+ }
77
+
78
+ const numTxs = getNumTxsFromBlockEndMarker(fields[fields.length - 1]);
79
+ if (numTxs !== txEffects.length) {
80
+ throw new Error(`Expected ${numTxs} txs, but got ${txEffects.length}`);
81
+ }
82
+
81
83
  return new this(txEffects);
82
84
  }
83
85
 
@@ -1,4 +1,5 @@
1
1
  export * from './l2_block.js';
2
+ export * from './l2_block_header.js';
2
3
  export * from './l2_block_stream/index.js';
3
4
  export * from './in_block.js';
4
5
  export * from './body.js';
@@ -7,3 +8,6 @@ export * from './l2_block_source.js';
7
8
  export * from './block_hash.js';
8
9
  export * from './published_l2_block.js';
9
10
  export * from './proposal/index.js';
11
+ export * from './validate_block_result.js';
12
+ export * from './l2_block_info.js';
13
+ export * from './attestation_info.js';
@@ -4,10 +4,13 @@ import { bufferToHex, hexToBuffer } from '@aztec/foundation/string';
4
4
 
5
5
  import { z } from 'zod';
6
6
 
7
+ import { getCheckpointBlobFields } from '../checkpoint/checkpoint_body.js';
7
8
  import { AppendOnlyTreeSnapshot } from '../trees/append_only_tree_snapshot.js';
8
- import { BlockHeader } from '../tx/block_header.js';
9
+ import type { BlockHeader } from '../tx/block_header.js';
9
10
  import { Body } from './body.js';
10
- import { makeAppendOnlyTreeSnapshot, makeHeader } from './l2_block_code_to_purge.js';
11
+ import { makeAppendOnlyTreeSnapshot, makeL2BlockHeader } from './l2_block_code_to_purge.js';
12
+ import { L2BlockHeader } from './l2_block_header.js';
13
+ import type { L2BlockInfo } from './l2_block_info.js';
11
14
 
12
15
  /**
13
16
  * The data that makes up the rollup proof, with encoder decoder functions.
@@ -17,7 +20,7 @@ export class L2Block {
17
20
  /** Snapshot of archive tree after the block is applied. */
18
21
  public archive: AppendOnlyTreeSnapshot,
19
22
  /** L2 block header. */
20
- public header: BlockHeader,
23
+ public header: L2BlockHeader,
21
24
  /** L2 block body. */
22
25
  public body: Body,
23
26
  private blockHash: Fr | undefined = undefined,
@@ -27,7 +30,7 @@ export class L2Block {
27
30
  return z
28
31
  .object({
29
32
  archive: AppendOnlyTreeSnapshot.schema,
30
- header: BlockHeader.schema,
33
+ header: L2BlockHeader.schema,
31
34
  body: Body.schema,
32
35
  })
33
36
  .transform(({ archive, header, body }) => new L2Block(archive, header, body));
@@ -39,7 +42,7 @@ export class L2Block {
39
42
  */
40
43
  static fromBuffer(buf: Buffer | BufferReader) {
41
44
  const reader = BufferReader.asReader(buf);
42
- const header = reader.readObject(BlockHeader);
45
+ const header = reader.readObject(L2BlockHeader);
43
46
  const archive = reader.readObject(AppendOnlyTreeSnapshot);
44
47
  const body = reader.readObject(Body);
45
48
 
@@ -93,7 +96,7 @@ export class L2Block {
93
96
 
94
97
  return new L2Block(
95
98
  makeAppendOnlyTreeSnapshot(l2BlockNum + 1),
96
- makeHeader(0, l2BlockNum, slotNumber ?? l2BlockNum, inHash),
99
+ makeL2BlockHeader(0, l2BlockNum, slotNumber ?? l2BlockNum, {}, inHash),
97
100
  body,
98
101
  );
99
102
  }
@@ -103,7 +106,7 @@ export class L2Block {
103
106
  * @returns The L2 block.
104
107
  */
105
108
  static empty(): L2Block {
106
- return new L2Block(AppendOnlyTreeSnapshot.empty(), BlockHeader.empty(), Body.empty());
109
+ return new L2Block(AppendOnlyTreeSnapshot.empty(), L2BlockHeader.empty(), Body.empty());
107
110
  }
108
111
 
109
112
  get number(): number {
@@ -124,11 +127,34 @@ export class L2Block {
124
127
  */
125
128
  public async hash(): Promise<Fr> {
126
129
  if (this.blockHash === undefined) {
127
- this.blockHash = await this.header.hash();
130
+ this.blockHash = await this.getBlockHeader().hash();
128
131
  }
129
132
  return this.blockHash;
130
133
  }
131
134
 
135
+ /**
136
+ * @deprecated
137
+ * This only works when there's one block per checkpoint.
138
+ * TODO(#17027): Remove this method from L2Block and create a dedicated Checkpoint class.
139
+ */
140
+ public getCheckpointHeader() {
141
+ return this.header.toCheckpointHeader();
142
+ }
143
+
144
+ // Temporary helper to get the actual block header.
145
+ public getBlockHeader(): BlockHeader {
146
+ return this.header.toBlockHeader();
147
+ }
148
+
149
+ /**
150
+ * @deprecated
151
+ * This only works when there's one block per checkpoint.
152
+ * TODO(#17027): Remove this method from L2Block and create a dedicated Checkpoint class.
153
+ */
154
+ public getCheckpointBlobFields() {
155
+ return getCheckpointBlobFields([this.body.txEffects]);
156
+ }
157
+
132
158
  /**
133
159
  * Returns stats used for logging.
134
160
  * @returns Stats on tx count, number, and log size and count.
@@ -156,13 +182,15 @@ export class L2Block {
156
182
  };
157
183
  }
158
184
 
159
- toBlockInfo(): BlockInfo {
185
+ toBlockInfo(): L2BlockInfo {
160
186
  return {
161
- blockHash: this.blockHash?.toString(),
162
- archive: this.archive.root.toString(),
187
+ blockHash: this.blockHash,
188
+ archive: this.archive.root,
189
+ lastArchive: this.header.lastArchive.root,
163
190
  blockNumber: this.number,
164
191
  slotNumber: Number(this.header.getSlot()),
165
192
  txCount: this.body.txEffects.length,
193
+ timestamp: this.header.globalVariables.timestamp,
166
194
  };
167
195
  }
168
196
 
@@ -170,11 +198,3 @@ export class L2Block {
170
198
  return this.archive.equals(other.archive) && this.header.equals(other.header) && this.body.equals(other.body);
171
199
  }
172
200
  }
173
-
174
- export type BlockInfo = {
175
- blockHash?: string;
176
- archive: string;
177
- blockNumber: number;
178
- slotNumber: number;
179
- txCount: number;
180
- };
@@ -1,26 +1,35 @@
1
+ import { compact } from '@aztec/foundation/collection';
1
2
  import { EthAddress } from '@aztec/foundation/eth-address';
2
3
  import { Fr } from '@aztec/foundation/fields';
4
+ import type { FieldsOf } from '@aztec/foundation/types';
3
5
 
4
6
  import { AztecAddress } from '../aztec-address/index.js';
5
7
  import { GasFees } from '../gas/gas_fees.js';
6
8
  import { AppendOnlyTreeSnapshot } from '../trees/append_only_tree_snapshot.js';
7
- import { BlockHeader } from '../tx/block_header.js';
8
9
  import { ContentCommitment } from '../tx/content_commitment.js';
9
10
  import { GlobalVariables } from '../tx/global_variables.js';
10
11
  import { PartialStateReference } from '../tx/partial_state_reference.js';
11
12
  import { StateReference } from '../tx/state_reference.js';
13
+ import { L2BlockHeader } from './l2_block_header.js';
12
14
 
13
- /**
14
- * Makes header.
15
- */
16
- export function makeHeader(seed = 0, blockNumber?: number, slotNumber?: number, inHash?: Fr): BlockHeader {
17
- return new BlockHeader(
15
+ export function makeL2BlockHeader(
16
+ seed = 0,
17
+ blockNumber?: number,
18
+ slotNumber?: number,
19
+ overrides: Partial<FieldsOf<L2BlockHeader>> = {},
20
+ inHash?: Fr,
21
+ ) {
22
+ return new L2BlockHeader(
18
23
  makeAppendOnlyTreeSnapshot(seed + 0x100),
19
- makeContentCommitment(seed + 0x200, inHash),
20
- makeStateReference(seed + 0x600),
21
- makeGlobalVariables((seed += 0x700), blockNumber, slotNumber ?? blockNumber),
24
+ overrides?.contentCommitment ?? makeContentCommitment(seed + 0x200, inHash),
25
+ overrides?.state ?? makeStateReference(seed + 0x600),
26
+ makeGlobalVariables((seed += 0x700), {
27
+ ...(blockNumber ? { blockNumber } : {}),
28
+ ...(slotNumber ? { slotNumber: new Fr(slotNumber) } : {}),
29
+ }),
22
30
  new Fr(seed + 0x800),
23
31
  new Fr(seed + 0x900),
32
+ new Fr(seed + 0xa00),
24
33
  );
25
34
  }
26
35
 
@@ -62,26 +71,16 @@ function makePartialStateReference(seed = 0): PartialStateReference {
62
71
  );
63
72
  }
64
73
 
65
- /**
66
- * Makes global variables.
67
- * @param seed - The seed to use for generating the global variables.
68
- * @param blockNumber - The block number to use for generating the global variables.
69
- * If blockNumber is undefined, it will be set to seed + 2.
70
- * @returns Global variables.
71
- */
72
- export function makeGlobalVariables(
73
- seed = 1,
74
- blockNumber: number | undefined = undefined,
75
- slotNumber: number | undefined = undefined,
76
- ): GlobalVariables {
77
- return new GlobalVariables(
78
- new Fr(seed),
79
- new Fr(seed + 1),
80
- blockNumber ?? seed + 2,
81
- new Fr(slotNumber ?? seed + 3),
82
- BigInt(seed + 4),
83
- EthAddress.fromField(new Fr(seed + 5)),
84
- AztecAddress.fromField(new Fr(seed + 6)),
85
- new GasFees(seed + 7, seed + 8),
86
- );
74
+ function makeGlobalVariables(seed = 1, overrides: Partial<FieldsOf<GlobalVariables>> = {}): GlobalVariables {
75
+ return GlobalVariables.from({
76
+ chainId: new Fr(seed),
77
+ version: new Fr(seed + 1),
78
+ blockNumber: seed + 2,
79
+ slotNumber: new Fr(seed + 3),
80
+ timestamp: BigInt(seed + 4),
81
+ coinbase: EthAddress.fromField(new Fr(seed + 5)),
82
+ feeRecipient: AztecAddress.fromField(new Fr(seed + 6)),
83
+ gasFees: new GasFees(seed + 7, seed + 8),
84
+ ...compact(overrides),
85
+ });
87
86
  }
@@ -0,0 +1,232 @@
1
+ import { Fr } from '@aztec/foundation/fields';
2
+ import { type ZodFor, schemas } from '@aztec/foundation/schemas';
3
+ import { BufferReader, FieldReader, serializeToBuffer, serializeToFields } from '@aztec/foundation/serialize';
4
+ import { bufferToHex, hexToBuffer } from '@aztec/foundation/string';
5
+ import type { FieldsOf } from '@aztec/foundation/types';
6
+
7
+ import { inspect } from 'util';
8
+ import { z } from 'zod';
9
+
10
+ import { CheckpointHeader } from '../rollup/checkpoint_header.js';
11
+ import { AppendOnlyTreeSnapshot } from '../trees/append_only_tree_snapshot.js';
12
+ import { BlockHeader, ContentCommitment, GlobalVariables, StateReference } from '../tx/index.js';
13
+
14
+ /**
15
+ * TO BE DELETED
16
+ *
17
+ * A header of an L2 block combining the block header and the checkpoint header.
18
+ * This is a temporary workaround to avoid changing too many things before building in chunks is properly implemented.
19
+ * This works for now because we only have one block per checkpoint.
20
+ *
21
+ * @deprecated Use BlockHeader or CheckpointHeader instead.
22
+ */
23
+ export class L2BlockHeader {
24
+ constructor(
25
+ /** Snapshot of archive before the block is applied. */
26
+ public lastArchive: AppendOnlyTreeSnapshot,
27
+ /** Hash of the body of an L2 block. */
28
+ public contentCommitment: ContentCommitment,
29
+ /** State reference. */
30
+ public state: StateReference,
31
+ /** Global variables of an L2 block. */
32
+ public globalVariables: GlobalVariables,
33
+ /** Total fees in the block, computed by the root rollup circuit */
34
+ public totalFees: Fr,
35
+ /** Total mana used in the block, computed by the root rollup circuit */
36
+ public totalManaUsed: Fr,
37
+ /** Hash of the sponge blob of the block. */
38
+ public spongeBlobHash: Fr,
39
+ ) {}
40
+
41
+ static get schema(): ZodFor<L2BlockHeader> {
42
+ return z
43
+ .object({
44
+ lastArchive: AppendOnlyTreeSnapshot.schema,
45
+ contentCommitment: ContentCommitment.schema,
46
+ state: StateReference.schema,
47
+ globalVariables: GlobalVariables.schema,
48
+ totalFees: schemas.Fr,
49
+ totalManaUsed: schemas.Fr,
50
+ spongeBlobHash: schemas.Fr,
51
+ })
52
+ .transform(L2BlockHeader.from);
53
+ }
54
+
55
+ static getFields(fields: FieldsOf<L2BlockHeader>) {
56
+ return [
57
+ fields.lastArchive,
58
+ fields.contentCommitment,
59
+ fields.state,
60
+ fields.globalVariables,
61
+ fields.totalFees,
62
+ fields.totalManaUsed,
63
+ fields.spongeBlobHash,
64
+ ] as const;
65
+ }
66
+
67
+ static from(fields: FieldsOf<L2BlockHeader>) {
68
+ return new L2BlockHeader(...L2BlockHeader.getFields(fields));
69
+ }
70
+
71
+ getSlot() {
72
+ return this.globalVariables.slotNumber.toBigInt();
73
+ }
74
+
75
+ getBlockNumber() {
76
+ return this.globalVariables.blockNumber;
77
+ }
78
+
79
+ getSize() {
80
+ return (
81
+ this.lastArchive.getSize() +
82
+ this.contentCommitment.getSize() +
83
+ this.state.getSize() +
84
+ this.globalVariables.getSize() +
85
+ this.totalFees.size +
86
+ this.totalManaUsed.size +
87
+ this.spongeBlobHash.size
88
+ );
89
+ }
90
+
91
+ toBuffer() {
92
+ return serializeToBuffer(...L2BlockHeader.getFields(this));
93
+ }
94
+
95
+ toFields(): Fr[] {
96
+ return serializeToFields(...L2BlockHeader.getFields(this));
97
+ }
98
+
99
+ clone() {
100
+ return L2BlockHeader.fromBuffer(this.toBuffer());
101
+ }
102
+
103
+ static fromBuffer(buffer: Buffer | BufferReader) {
104
+ const reader = BufferReader.asReader(buffer);
105
+
106
+ return new L2BlockHeader(
107
+ reader.readObject(AppendOnlyTreeSnapshot),
108
+ reader.readObject(ContentCommitment),
109
+ reader.readObject(StateReference),
110
+ reader.readObject(GlobalVariables),
111
+ reader.readObject(Fr),
112
+ reader.readObject(Fr),
113
+ reader.readObject(Fr),
114
+ );
115
+ }
116
+
117
+ static fromFields(fields: Fr[] | FieldReader) {
118
+ const reader = FieldReader.asReader(fields);
119
+
120
+ return new L2BlockHeader(
121
+ AppendOnlyTreeSnapshot.fromFields(reader),
122
+ ContentCommitment.fromFields(reader),
123
+ StateReference.fromFields(reader),
124
+ GlobalVariables.fromFields(reader),
125
+ reader.readField(),
126
+ reader.readField(),
127
+ reader.readField(),
128
+ );
129
+ }
130
+
131
+ static empty(fields: Partial<FieldsOf<L2BlockHeader>> = {}) {
132
+ return L2BlockHeader.from({
133
+ lastArchive: AppendOnlyTreeSnapshot.empty(),
134
+ contentCommitment: ContentCommitment.empty(),
135
+ state: StateReference.empty(),
136
+ globalVariables: GlobalVariables.empty(),
137
+ totalFees: Fr.ZERO,
138
+ totalManaUsed: Fr.ZERO,
139
+ spongeBlobHash: Fr.ZERO,
140
+ ...fields,
141
+ });
142
+ }
143
+
144
+ isEmpty(): boolean {
145
+ return (
146
+ this.lastArchive.isEmpty() &&
147
+ this.contentCommitment.isEmpty() &&
148
+ this.state.isEmpty() &&
149
+ this.globalVariables.isEmpty() &&
150
+ this.totalFees.isZero() &&
151
+ this.totalManaUsed.isZero() &&
152
+ this.spongeBlobHash.isZero()
153
+ );
154
+ }
155
+
156
+ /**
157
+ * Serializes this instance into a string.
158
+ * @returns Encoded string.
159
+ */
160
+ public toString() {
161
+ return bufferToHex(this.toBuffer());
162
+ }
163
+
164
+ static fromString(str: string) {
165
+ return L2BlockHeader.fromBuffer(hexToBuffer(str));
166
+ }
167
+
168
+ toCheckpointHeader() {
169
+ return new CheckpointHeader(
170
+ this.lastArchive.root,
171
+ this.contentCommitment,
172
+ this.globalVariables.slotNumber,
173
+ this.globalVariables.timestamp,
174
+ this.globalVariables.coinbase,
175
+ this.globalVariables.feeRecipient,
176
+ this.globalVariables.gasFees,
177
+ this.totalManaUsed,
178
+ );
179
+ }
180
+
181
+ toBlockHeader() {
182
+ return new BlockHeader(
183
+ this.lastArchive,
184
+ this.state,
185
+ this.spongeBlobHash,
186
+ this.globalVariables,
187
+ this.totalFees,
188
+ this.totalManaUsed,
189
+ );
190
+ }
191
+
192
+ toInspect() {
193
+ return {
194
+ lastArchive: this.lastArchive.root.toString(),
195
+ contentCommitment: this.contentCommitment.toInspect(),
196
+ state: this.state.toInspect(),
197
+ globalVariables: this.globalVariables.toInspect(),
198
+ totalFees: this.totalFees.toBigInt(),
199
+ totalManaUsed: this.totalManaUsed.toBigInt(),
200
+ spongeBlobHash: this.spongeBlobHash.toString(),
201
+ };
202
+ }
203
+
204
+ [inspect.custom]() {
205
+ return `L2BlockHeader {
206
+ lastArchive: ${inspect(this.lastArchive)},
207
+ contentCommitment.blobsHash: ${inspect(this.contentCommitment.blobsHash)},
208
+ contentCommitment.inHash: ${inspect(this.contentCommitment.inHash)},
209
+ contentCommitment.outHash: ${inspect(this.contentCommitment.outHash)},
210
+ state.l1ToL2MessageTree: ${inspect(this.state.l1ToL2MessageTree)},
211
+ state.noteHashTree: ${inspect(this.state.partial.noteHashTree)},
212
+ state.nullifierTree: ${inspect(this.state.partial.nullifierTree)},
213
+ state.publicDataTree: ${inspect(this.state.partial.publicDataTree)},
214
+ globalVariables: ${inspect(this.globalVariables)},
215
+ totalFees: ${this.totalFees},
216
+ totalManaUsed: ${this.totalManaUsed},
217
+ spongeBlobHash: ${this.spongeBlobHash},
218
+ }`;
219
+ }
220
+
221
+ public equals(other: this): boolean {
222
+ return (
223
+ this.contentCommitment.equals(other.contentCommitment) &&
224
+ this.state.equals(other.state) &&
225
+ this.globalVariables.equals(other.globalVariables) &&
226
+ this.totalFees.equals(other.totalFees) &&
227
+ this.totalManaUsed.equals(other.totalManaUsed) &&
228
+ this.lastArchive.equals(other.lastArchive) &&
229
+ this.spongeBlobHash.equals(other.spongeBlobHash)
230
+ );
231
+ }
232
+ }
@@ -0,0 +1,63 @@
1
+ import { Fr } from '@aztec/foundation/fields';
2
+ import { schemas } from '@aztec/foundation/schemas';
3
+ import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize';
4
+
5
+ import { z } from 'zod';
6
+
7
+ export type L2BlockInfo = {
8
+ blockHash?: Fr;
9
+ archive: Fr;
10
+ lastArchive: Fr;
11
+ blockNumber: number;
12
+ slotNumber: number;
13
+ txCount: number;
14
+ timestamp: bigint;
15
+ };
16
+
17
+ export function randomBlockInfo(blockNumber?: number): L2BlockInfo {
18
+ return {
19
+ blockHash: Fr.random(),
20
+ archive: Fr.random(),
21
+ lastArchive: Fr.random(),
22
+ blockNumber: blockNumber ?? Math.floor(Math.random() * 100000) + 1,
23
+ slotNumber: Math.floor(Math.random() * 100000) + 1,
24
+ txCount: Math.floor(Math.random() * 100),
25
+ timestamp: BigInt(Math.floor(Date.now() / 1000)),
26
+ };
27
+ }
28
+
29
+ export const BlockInfoSchema = z.object({
30
+ blockHash: schemas.Fr.optional(),
31
+ archive: schemas.Fr,
32
+ lastArchive: schemas.Fr,
33
+ blockNumber: z.number(),
34
+ slotNumber: z.number(),
35
+ txCount: z.number(),
36
+ timestamp: schemas.BigInt,
37
+ });
38
+
39
+ export function serializeBlockInfo(blockInfo: L2BlockInfo): Buffer {
40
+ return serializeToBuffer(
41
+ blockInfo.blockHash ?? Fr.ZERO,
42
+ blockInfo.archive,
43
+ blockInfo.lastArchive,
44
+ blockInfo.blockNumber,
45
+ blockInfo.slotNumber,
46
+ blockInfo.txCount,
47
+ blockInfo.timestamp,
48
+ );
49
+ }
50
+
51
+ export function deserializeBlockInfo(buffer: Buffer | BufferReader): L2BlockInfo {
52
+ const reader = BufferReader.asReader(buffer);
53
+ const blockHash = reader.readObject(Fr);
54
+ return {
55
+ blockHash: blockHash.equals(Fr.ZERO) ? undefined : blockHash,
56
+ archive: reader.readObject(Fr),
57
+ lastArchive: reader.readObject(Fr),
58
+ blockNumber: reader.readNumber(),
59
+ slotNumber: reader.readNumber(),
60
+ txCount: reader.readNumber(),
61
+ timestamp: reader.readBigInt(),
62
+ };
63
+ }