@aztec/stdlib 3.0.3 → 3.9.9-nightly.20260312

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 (859) hide show
  1. package/dest/abi/abi.d.ts +602 -4
  2. package/dest/abi/abi.d.ts.map +1 -1
  3. package/dest/abi/abi.js +7 -7
  4. package/dest/abi/contract_artifact.d.ts +2 -2
  5. package/dest/abi/contract_artifact.d.ts.map +1 -1
  6. package/dest/abi/contract_artifact.js +1 -1
  7. package/dest/abi/decoder.d.ts +2 -2
  8. package/dest/abi/decoder.d.ts.map +1 -1
  9. package/dest/abi/decoder.js +7 -5
  10. package/dest/abi/encoder.d.ts +1 -1
  11. package/dest/abi/encoder.d.ts.map +1 -1
  12. package/dest/abi/encoder.js +37 -6
  13. package/dest/abi/event_metadata_definition.d.ts +3 -1
  14. package/dest/abi/event_metadata_definition.d.ts.map +1 -1
  15. package/dest/abi/event_metadata_definition.js +1 -1
  16. package/dest/abi/function_call.d.ts +47 -9
  17. package/dest/abi/function_call.d.ts.map +1 -1
  18. package/dest/abi/function_call.js +20 -3
  19. package/dest/abi/function_selector.d.ts +2 -1
  20. package/dest/abi/function_selector.d.ts.map +1 -1
  21. package/dest/abi/function_selector.js +7 -0
  22. package/dest/abi/selector.js +3 -1
  23. package/dest/abi/utils.d.ts +20 -1
  24. package/dest/abi/utils.d.ts.map +1 -1
  25. package/dest/abi/utils.js +22 -0
  26. package/dest/auth_witness/auth_witness.d.ts +2 -1
  27. package/dest/auth_witness/auth_witness.d.ts.map +1 -1
  28. package/dest/auth_witness/auth_witness.js +3 -3
  29. package/dest/avm/avm.d.ts +362 -362
  30. package/dest/avm/avm.js +1 -1
  31. package/dest/avm/avm_accumulated_data.d.ts +30 -3
  32. package/dest/avm/avm_accumulated_data.d.ts.map +1 -1
  33. package/dest/avm/avm_accumulated_data.js +5 -2
  34. package/dest/avm/avm_circuit_public_inputs.d.ts +9 -9
  35. package/dest/avm/avm_circuit_public_inputs.js +3 -1
  36. package/dest/avm/avm_proving_request.d.ts +465 -465
  37. package/dest/avm/contract_storage_read.d.ts +13 -1
  38. package/dest/avm/contract_storage_read.d.ts.map +1 -1
  39. package/dest/avm/contract_storage_update_request.d.ts +13 -1
  40. package/dest/avm/contract_storage_update_request.d.ts.map +1 -1
  41. package/dest/avm/public_call_stack_item_compressed.d.ts +3 -1
  42. package/dest/avm/public_call_stack_item_compressed.d.ts.map +1 -1
  43. package/dest/avm/public_data_read.d.ts +10 -1
  44. package/dest/avm/public_data_read.d.ts.map +1 -1
  45. package/dest/avm/public_data_update_request.d.ts +10 -1
  46. package/dest/avm/public_data_update_request.d.ts.map +1 -1
  47. package/dest/avm/public_data_update_request.js +3 -1
  48. package/dest/avm/public_data_write.d.ts +7 -1
  49. package/dest/avm/public_data_write.d.ts.map +1 -1
  50. package/dest/avm/public_inner_call_request.d.ts +4 -1
  51. package/dest/avm/public_inner_call_request.d.ts.map +1 -1
  52. package/dest/avm/public_inner_call_request.js +3 -1
  53. package/dest/avm/revert_code.d.ts +19 -4
  54. package/dest/avm/revert_code.d.ts.map +1 -1
  55. package/dest/avm/revert_code.js +18 -6
  56. package/dest/aztec-address/index.js +4 -2
  57. package/dest/block/attestation_info.d.ts +5 -5
  58. package/dest/block/attestation_info.d.ts.map +1 -1
  59. package/dest/block/attestation_info.js +4 -4
  60. package/dest/block/block_data.d.ts +52 -0
  61. package/dest/block/block_data.d.ts.map +1 -0
  62. package/dest/block/block_data.js +12 -0
  63. package/dest/block/block_hash.d.ts +18 -14
  64. package/dest/block/block_hash.d.ts.map +1 -1
  65. package/dest/block/block_hash.js +22 -20
  66. package/dest/block/block_parameter.d.ts +4 -3
  67. package/dest/block/block_parameter.d.ts.map +1 -1
  68. package/dest/block/block_parameter.js +2 -0
  69. package/dest/block/body.d.ts +1 -1
  70. package/dest/block/body.d.ts.map +1 -1
  71. package/dest/block/body.js +5 -2
  72. package/dest/block/checkpointed_l2_block.d.ts +150 -0
  73. package/dest/block/checkpointed_l2_block.d.ts.map +1 -0
  74. package/dest/block/checkpointed_l2_block.js +46 -0
  75. package/dest/block/in_block.d.ts +9 -9
  76. package/dest/block/in_block.d.ts.map +1 -1
  77. package/dest/block/in_block.js +5 -5
  78. package/dest/block/index.d.ts +3 -4
  79. package/dest/block/index.d.ts.map +1 -1
  80. package/dest/block/index.js +2 -3
  81. package/dest/block/l2_block.d.ts +65 -57
  82. package/dest/block/l2_block.d.ts.map +1 -1
  83. package/dest/block/l2_block.js +73 -107
  84. package/dest/block/l2_block_source.d.ts +372 -92
  85. package/dest/block/l2_block_source.d.ts.map +1 -1
  86. package/dest/block/l2_block_source.js +25 -6
  87. package/dest/block/l2_block_stream/index.d.ts +2 -1
  88. package/dest/block/l2_block_stream/index.d.ts.map +1 -1
  89. package/dest/block/l2_block_stream/index.js +1 -0
  90. package/dest/block/l2_block_stream/interfaces.d.ts +15 -5
  91. package/dest/block/l2_block_stream/interfaces.d.ts.map +1 -1
  92. package/dest/block/l2_block_stream/l2_block_stream.d.ts +13 -3
  93. package/dest/block/l2_block_stream/l2_block_stream.d.ts.map +1 -1
  94. package/dest/block/l2_block_stream/l2_block_stream.js +125 -32
  95. package/dest/block/l2_block_stream/l2_tips_memory_store.d.ts +24 -16
  96. package/dest/block/l2_block_stream/l2_tips_memory_store.d.ts.map +1 -1
  97. package/dest/block/l2_block_stream/l2_tips_memory_store.js +55 -61
  98. package/dest/block/l2_block_stream/l2_tips_store_base.d.ts +49 -0
  99. package/dest/block/l2_block_stream/l2_tips_store_base.d.ts.map +1 -0
  100. package/dest/block/l2_block_stream/l2_tips_store_base.js +179 -0
  101. package/dest/block/test/l2_tips_store_test_suite.d.ts +1 -1
  102. package/dest/block/test/l2_tips_store_test_suite.d.ts.map +1 -1
  103. package/dest/block/test/l2_tips_store_test_suite.js +478 -41
  104. package/dest/block/validate_block_result.d.ts +24 -24
  105. package/dest/block/validate_block_result.d.ts.map +1 -1
  106. package/dest/block/validate_block_result.js +18 -17
  107. package/dest/checkpoint/checkpoint.d.ts +58 -18
  108. package/dest/checkpoint/checkpoint.d.ts.map +1 -1
  109. package/dest/checkpoint/checkpoint.js +83 -16
  110. package/dest/checkpoint/checkpoint_data.d.ts +120 -0
  111. package/dest/checkpoint/checkpoint_data.d.ts.map +1 -0
  112. package/dest/checkpoint/checkpoint_data.js +26 -0
  113. package/dest/checkpoint/checkpoint_info.d.ts +38 -0
  114. package/dest/checkpoint/checkpoint_info.d.ts.map +1 -0
  115. package/dest/checkpoint/checkpoint_info.js +34 -0
  116. package/dest/checkpoint/index.d.ts +4 -1
  117. package/dest/checkpoint/index.d.ts.map +1 -1
  118. package/dest/checkpoint/index.js +3 -0
  119. package/dest/checkpoint/published_checkpoint.d.ts +46 -23
  120. package/dest/checkpoint/published_checkpoint.d.ts.map +1 -1
  121. package/dest/checkpoint/published_checkpoint.js +15 -5
  122. package/dest/checkpoint/validate.d.ts +36 -0
  123. package/dest/checkpoint/validate.d.ts.map +1 -0
  124. package/dest/checkpoint/validate.js +120 -0
  125. package/dest/config/index.d.ts +2 -1
  126. package/dest/config/index.d.ts.map +1 -1
  127. package/dest/config/index.js +1 -0
  128. package/dest/config/node-rpc-config.js +1 -1
  129. package/dest/config/sequencer-config.d.ts +10 -0
  130. package/dest/config/sequencer-config.d.ts.map +1 -0
  131. package/dest/config/sequencer-config.js +23 -0
  132. package/dest/contract/complete_address.d.ts +4 -1
  133. package/dest/contract/complete_address.d.ts.map +1 -1
  134. package/dest/contract/contract_address.js +4 -4
  135. package/dest/contract/contract_class.d.ts +2 -3
  136. package/dest/contract/contract_class.d.ts.map +1 -1
  137. package/dest/contract/contract_class_id.d.ts +2 -2
  138. package/dest/contract/contract_class_id.d.ts.map +1 -1
  139. package/dest/contract/contract_class_id.js +6 -5
  140. package/dest/contract/contract_deployment_data.d.ts +5 -5
  141. package/dest/contract/index.d.ts +1 -3
  142. package/dest/contract/index.d.ts.map +1 -1
  143. package/dest/contract/index.js +0 -2
  144. package/dest/contract/interfaces/contract_class.d.ts +11 -13
  145. package/dest/contract/interfaces/contract_class.d.ts.map +1 -1
  146. package/dest/contract/interfaces/contract_class.js +18 -18
  147. package/dest/contract/interfaces/contract_instance.d.ts +28 -29
  148. package/dest/contract/interfaces/contract_instance.d.ts.map +1 -1
  149. package/dest/contract/interfaces/contract_instance.js +5 -5
  150. package/dest/contract/interfaces/contract_instance_update.d.ts +6 -7
  151. package/dest/contract/interfaces/contract_instance_update.d.ts.map +1 -1
  152. package/dest/contract/interfaces/contract_instance_update.js +5 -5
  153. package/dest/contract/interfaces/node-info.d.ts +3 -1
  154. package/dest/contract/interfaces/node-info.d.ts.map +1 -1
  155. package/dest/contract/interfaces/node-info.js +2 -1
  156. package/dest/contract/private_function.d.ts +1 -1
  157. package/dest/contract/private_function.d.ts.map +1 -1
  158. package/dest/contract/private_function.js +3 -4
  159. package/dest/contract/private_function_membership_proof.d.ts +1 -1
  160. package/dest/contract/private_function_membership_proof.js +1 -1
  161. package/dest/database-version/database_version.d.ts +58 -0
  162. package/dest/database-version/database_version.d.ts.map +1 -0
  163. package/dest/database-version/database_version.js +69 -0
  164. package/dest/database-version/version_manager.d.ts +3 -49
  165. package/dest/database-version/version_manager.d.ts.map +1 -1
  166. package/dest/database-version/version_manager.js +1 -64
  167. package/dest/delayed_public_mutable/delayed_public_mutable_values.d.ts +2 -2
  168. package/dest/delayed_public_mutable/delayed_public_mutable_values.d.ts.map +1 -1
  169. package/dest/delayed_public_mutable/delayed_public_mutable_values.js +7 -10
  170. package/dest/deserialization/index.d.ts +11 -0
  171. package/dest/deserialization/index.d.ts.map +1 -0
  172. package/dest/deserialization/index.js +10 -0
  173. package/dest/epoch-helpers/index.d.ts +11 -1
  174. package/dest/epoch-helpers/index.d.ts.map +1 -1
  175. package/dest/epoch-helpers/index.js +14 -6
  176. package/dest/errors/proving_error.d.ts +2 -2
  177. package/dest/errors/proving_error.d.ts.map +1 -1
  178. package/dest/file-store/local.d.ts +3 -3
  179. package/dest/file-store/local.d.ts.map +1 -1
  180. package/dest/file-store/local.js +13 -4
  181. package/dest/file-store/s3.d.ts +1 -1
  182. package/dest/file-store/s3.d.ts.map +1 -1
  183. package/dest/file-store/s3.js +11 -3
  184. package/dest/gas/gas.js +3 -1
  185. package/dest/gas/gas_fees.js +3 -1
  186. package/dest/hash/hash.d.ts +2 -9
  187. package/dest/hash/hash.d.ts.map +1 -1
  188. package/dest/hash/hash.js +14 -20
  189. package/dest/hash/map_slot.d.ts +1 -1
  190. package/dest/hash/map_slot.d.ts.map +1 -1
  191. package/dest/hash/map_slot.js +4 -3
  192. package/dest/interfaces/allowed_element.d.ts +30 -25
  193. package/dest/interfaces/allowed_element.d.ts.map +1 -1
  194. package/dest/interfaces/allowed_element.js +11 -11
  195. package/dest/interfaces/api_limit.d.ts +3 -1
  196. package/dest/interfaces/api_limit.d.ts.map +1 -1
  197. package/dest/interfaces/api_limit.js +2 -0
  198. package/dest/interfaces/archiver.d.ts +6 -6
  199. package/dest/interfaces/archiver.d.ts.map +1 -1
  200. package/dest/interfaces/archiver.js +33 -17
  201. package/dest/interfaces/aztec-node-admin.d.ts +202 -65
  202. package/dest/interfaces/aztec-node-admin.d.ts.map +1 -1
  203. package/dest/interfaces/aztec-node-admin.js +15 -7
  204. package/dest/interfaces/aztec-node.d.ts +86 -83
  205. package/dest/interfaces/aztec-node.d.ts.map +1 -1
  206. package/dest/interfaces/aztec-node.js +18 -18
  207. package/dest/interfaces/block-builder.d.ts +27 -15
  208. package/dest/interfaces/block-builder.d.ts.map +1 -1
  209. package/dest/interfaces/block-builder.js +24 -1
  210. package/dest/interfaces/configs.d.ts +132 -53
  211. package/dest/interfaces/configs.d.ts.map +1 -1
  212. package/dest/interfaces/configs.js +22 -8
  213. package/dest/interfaces/get_logs_response.d.ts +27 -5
  214. package/dest/interfaces/get_logs_response.d.ts.map +1 -1
  215. package/dest/interfaces/get_logs_response.js +5 -4
  216. package/dest/interfaces/l2_logs_source.d.ts +21 -8
  217. package/dest/interfaces/l2_logs_source.d.ts.map +1 -1
  218. package/dest/interfaces/merkle_tree_operations.d.ts +2 -2
  219. package/dest/interfaces/merkle_tree_operations.d.ts.map +1 -1
  220. package/dest/interfaces/p2p.d.ts +9 -16
  221. package/dest/interfaces/p2p.d.ts.map +1 -1
  222. package/dest/interfaces/p2p.js +3 -4
  223. package/dest/interfaces/prover-broker.d.ts +16 -1
  224. package/dest/interfaces/prover-broker.d.ts.map +1 -1
  225. package/dest/interfaces/prover-broker.js +4 -1
  226. package/dest/interfaces/prover-client.d.ts +24 -3
  227. package/dest/interfaces/prover-client.d.ts.map +1 -1
  228. package/dest/interfaces/prover-client.js +22 -4
  229. package/dest/interfaces/proving-job.d.ts +218 -218
  230. package/dest/interfaces/proving-job.d.ts.map +1 -1
  231. package/dest/interfaces/proving-job.js +1 -7
  232. package/dest/interfaces/server_circuit_prover.d.ts +4 -3
  233. package/dest/interfaces/server_circuit_prover.d.ts.map +1 -1
  234. package/dest/interfaces/slasher.d.ts +9 -1
  235. package/dest/interfaces/slasher.d.ts.map +1 -1
  236. package/dest/interfaces/slasher.js +5 -3
  237. package/dest/interfaces/tx_provider.d.ts +3 -3
  238. package/dest/interfaces/tx_provider.d.ts.map +1 -1
  239. package/dest/interfaces/validator.d.ts +224 -47
  240. package/dest/interfaces/validator.d.ts.map +1 -1
  241. package/dest/interfaces/validator.js +17 -8
  242. package/dest/interfaces/world_state.d.ts +17 -8
  243. package/dest/interfaces/world_state.d.ts.map +1 -1
  244. package/dest/kernel/claimed_length_array.js +3 -1
  245. package/dest/kernel/hints/build_note_hash_read_request_hints.d.ts +7 -6
  246. package/dest/kernel/hints/build_note_hash_read_request_hints.d.ts.map +1 -1
  247. package/dest/kernel/hints/build_note_hash_read_request_hints.js +31 -19
  248. package/dest/kernel/hints/build_nullifier_read_request_hints.d.ts +4 -4
  249. package/dest/kernel/hints/build_nullifier_read_request_hints.d.ts.map +1 -1
  250. package/dest/kernel/hints/build_nullifier_read_request_hints.js +28 -17
  251. package/dest/kernel/hints/build_transient_data_hints.d.ts +5 -2
  252. package/dest/kernel/hints/build_transient_data_hints.d.ts.map +1 -1
  253. package/dest/kernel/hints/build_transient_data_hints.js +9 -3
  254. package/dest/kernel/hints/find_private_kernel_reset_dimensions.d.ts +1 -1
  255. package/dest/kernel/hints/find_private_kernel_reset_dimensions.d.ts.map +1 -1
  256. package/dest/kernel/hints/find_private_kernel_reset_dimensions.js +1 -3
  257. package/dest/kernel/hints/index.d.ts +2 -2
  258. package/dest/kernel/hints/index.js +2 -2
  259. package/dest/kernel/hints/key_validation_hint.d.ts +2 -1
  260. package/dest/kernel/hints/key_validation_hint.d.ts.map +1 -1
  261. package/dest/kernel/hints/key_validation_request.d.ts +2 -1
  262. package/dest/kernel/hints/key_validation_request.d.ts.map +1 -1
  263. package/dest/kernel/hints/key_validation_request_and_separator.d.ts +24 -0
  264. package/dest/kernel/hints/key_validation_request_and_separator.d.ts.map +1 -0
  265. package/dest/kernel/hints/{key_validation_request_and_generator.js → key_validation_request_and_separator.js} +12 -15
  266. package/dest/kernel/hints/private_kernel_reset_hints.d.ts +13 -1
  267. package/dest/kernel/hints/private_kernel_reset_hints.d.ts.map +1 -1
  268. package/dest/kernel/hints/read_request.d.ts +7 -1
  269. package/dest/kernel/hints/read_request.d.ts.map +1 -1
  270. package/dest/kernel/hints/read_request_hints.d.ts +7 -1
  271. package/dest/kernel/hints/read_request_hints.d.ts.map +1 -1
  272. package/dest/kernel/hints/{scoped_key_validation_request_and_generator.d.ts → scoped_key_validation_request_and_separator.d.ts} +8 -8
  273. package/dest/kernel/hints/{scoped_key_validation_request_and_generator.d.ts.map → scoped_key_validation_request_and_separator.d.ts.map} +1 -1
  274. package/dest/kernel/hints/{scoped_key_validation_request_and_generator.js → scoped_key_validation_request_and_separator.js} +6 -6
  275. package/dest/kernel/hints/transient_data_squashing_hint.js +3 -1
  276. package/dest/kernel/log_hash.js +3 -1
  277. package/dest/kernel/private_accumulated_data.d.ts +23 -1
  278. package/dest/kernel/private_accumulated_data.d.ts.map +1 -1
  279. package/dest/kernel/private_call_data.d.ts +25 -1
  280. package/dest/kernel/private_call_data.d.ts.map +1 -1
  281. package/dest/kernel/private_call_request.d.ts +16 -1
  282. package/dest/kernel/private_call_request.d.ts.map +1 -1
  283. package/dest/kernel/private_circuit_public_inputs.d.ts +126 -53
  284. package/dest/kernel/private_circuit_public_inputs.d.ts.map +1 -1
  285. package/dest/kernel/private_circuit_public_inputs.js +71 -71
  286. package/dest/kernel/private_kernel_circuit_public_inputs.d.ts +33 -3
  287. package/dest/kernel/private_kernel_circuit_public_inputs.d.ts.map +1 -1
  288. package/dest/kernel/private_kernel_circuit_public_inputs.js +4 -4
  289. package/dest/kernel/private_kernel_data.d.ts +7 -1
  290. package/dest/kernel/private_kernel_data.d.ts.map +1 -1
  291. package/dest/kernel/private_kernel_init_circuit_private_inputs.d.ts +22 -1
  292. package/dest/kernel/private_kernel_init_circuit_private_inputs.d.ts.map +1 -1
  293. package/dest/kernel/private_kernel_inner_circuit_private_inputs.d.ts +7 -1
  294. package/dest/kernel/private_kernel_inner_circuit_private_inputs.d.ts.map +1 -1
  295. package/dest/kernel/private_kernel_reset_circuit_private_inputs.d.ts +4 -1
  296. package/dest/kernel/private_kernel_reset_circuit_private_inputs.d.ts.map +1 -1
  297. package/dest/kernel/private_kernel_tail_circuit_private_inputs.d.ts +12 -3
  298. package/dest/kernel/private_kernel_tail_circuit_private_inputs.d.ts.map +1 -1
  299. package/dest/kernel/private_kernel_tail_circuit_private_inputs.js +4 -4
  300. package/dest/kernel/private_kernel_tail_circuit_public_inputs.d.ts +26 -3
  301. package/dest/kernel/private_kernel_tail_circuit_public_inputs.d.ts.map +1 -1
  302. package/dest/kernel/private_kernel_tail_circuit_public_inputs.js +11 -7
  303. package/dest/kernel/private_log_data.js +5 -2
  304. package/dest/kernel/private_to_avm_accumulated_data.d.ts +2 -2
  305. package/dest/kernel/private_to_avm_accumulated_data.js +5 -2
  306. package/dest/kernel/private_to_public_accumulated_data.js +3 -1
  307. package/dest/kernel/private_to_public_kernel_circuit_public_inputs.d.ts +3 -3
  308. package/dest/kernel/private_to_public_kernel_circuit_public_inputs.d.ts.map +1 -1
  309. package/dest/kernel/private_to_public_kernel_circuit_public_inputs.js +7 -7
  310. package/dest/kernel/private_to_rollup_accumulated_data.d.ts +17 -1
  311. package/dest/kernel/private_to_rollup_accumulated_data.d.ts.map +1 -1
  312. package/dest/kernel/private_to_rollup_accumulated_data.js +3 -1
  313. package/dest/kernel/private_to_rollup_kernel_circuit_public_inputs.d.ts +18 -3
  314. package/dest/kernel/private_to_rollup_kernel_circuit_public_inputs.d.ts.map +1 -1
  315. package/dest/kernel/private_to_rollup_kernel_circuit_public_inputs.js +7 -7
  316. package/dest/kernel/private_validation_requests.d.ts +13 -4
  317. package/dest/kernel/private_validation_requests.d.ts.map +1 -1
  318. package/dest/kernel/private_validation_requests.js +12 -10
  319. package/dest/kernel/public_call_request.d.ts +22 -1
  320. package/dest/kernel/public_call_request.d.ts.map +1 -1
  321. package/dest/kernel/public_call_request.js +5 -2
  322. package/dest/kernel/utils/optional_number.d.ts +7 -1
  323. package/dest/kernel/utils/optional_number.d.ts.map +1 -1
  324. package/dest/keys/derivation.d.ts +3 -3
  325. package/dest/keys/derivation.js +15 -15
  326. package/dest/keys/key_types.d.ts +3 -3
  327. package/dest/keys/key_types.d.ts.map +1 -1
  328. package/dest/keys/public_keys.d.ts +5 -1
  329. package/dest/keys/public_keys.d.ts.map +1 -1
  330. package/dest/keys/public_keys.js +2 -2
  331. package/dest/keys/utils.d.ts +1 -1
  332. package/dest/keys/utils.d.ts.map +1 -1
  333. package/dest/keys/utils.js +8 -4
  334. package/dest/l1-contracts/slash_factory.d.ts +1 -1
  335. package/dest/l1-contracts/slash_factory.d.ts.map +1 -1
  336. package/dest/l1-contracts/slash_factory.js +1 -0
  337. package/dest/logs/contract_class_log.js +3 -1
  338. package/dest/logs/debug_log_store.d.ts +30 -0
  339. package/dest/logs/debug_log_store.d.ts.map +1 -0
  340. package/dest/logs/debug_log_store.js +30 -0
  341. package/dest/logs/extended_contract_class_log.d.ts +3 -1
  342. package/dest/logs/extended_contract_class_log.d.ts.map +1 -1
  343. package/dest/logs/extended_directional_app_tagging_secret.d.ts +47 -0
  344. package/dest/logs/extended_directional_app_tagging_secret.d.ts.map +1 -0
  345. package/dest/logs/{directional_app_tagging_secret.js → extended_directional_app_tagging_secret.js} +23 -15
  346. package/dest/logs/extended_public_log.d.ts +17 -3
  347. package/dest/logs/extended_public_log.d.ts.map +1 -1
  348. package/dest/logs/index.d.ts +5 -3
  349. package/dest/logs/index.d.ts.map +1 -1
  350. package/dest/logs/index.js +4 -2
  351. package/dest/logs/log_id.d.ts +22 -7
  352. package/dest/logs/log_id.d.ts.map +1 -1
  353. package/dest/logs/log_id.js +23 -13
  354. package/dest/logs/pre_tag.d.ts +16 -11
  355. package/dest/logs/pre_tag.d.ts.map +1 -1
  356. package/dest/logs/pre_tag.js +2 -2
  357. package/dest/logs/private_log.d.ts +2 -2
  358. package/dest/logs/private_log.d.ts.map +1 -1
  359. package/dest/logs/private_log.js +5 -2
  360. package/dest/logs/public_log.d.ts +4 -3
  361. package/dest/logs/public_log.d.ts.map +1 -1
  362. package/dest/logs/public_log.js +5 -2
  363. package/dest/logs/siloed_tag.d.ts +25 -0
  364. package/dest/logs/siloed_tag.d.ts.map +1 -0
  365. package/dest/logs/siloed_tag.js +32 -0
  366. package/dest/logs/tag.d.ts +21 -0
  367. package/dest/logs/tag.d.ts.map +1 -0
  368. package/dest/logs/tag.js +30 -0
  369. package/dest/logs/tx_scoped_l2_log.d.ts +24 -33
  370. package/dest/logs/tx_scoped_l2_log.d.ts.map +1 -1
  371. package/dest/logs/tx_scoped_l2_log.js +37 -43
  372. package/dest/messaging/in_hash.d.ts +4 -2
  373. package/dest/messaging/in_hash.d.ts.map +1 -1
  374. package/dest/messaging/in_hash.js +3 -1
  375. package/dest/messaging/inbox_leaf.d.ts +3 -1
  376. package/dest/messaging/inbox_leaf.d.ts.map +1 -1
  377. package/dest/messaging/l1_actor.d.ts +7 -1
  378. package/dest/messaging/l1_actor.d.ts.map +1 -1
  379. package/dest/messaging/l1_to_l2_message.d.ts +6 -1
  380. package/dest/messaging/l1_to_l2_message.d.ts.map +1 -1
  381. package/dest/messaging/l2_actor.d.ts +7 -1
  382. package/dest/messaging/l2_actor.d.ts.map +1 -1
  383. package/dest/messaging/l2_to_l1_membership.d.ts +88 -6
  384. package/dest/messaging/l2_to_l1_membership.d.ts.map +1 -1
  385. package/dest/messaging/l2_to_l1_membership.js +160 -42
  386. package/dest/messaging/out_hash.d.ts +41 -3
  387. package/dest/messaging/out_hash.d.ts.map +1 -1
  388. package/dest/messaging/out_hash.js +54 -19
  389. package/dest/note/index.d.ts +1 -2
  390. package/dest/note/index.d.ts.map +1 -1
  391. package/dest/note/index.js +0 -1
  392. package/dest/note/note_dao.d.ts +36 -5
  393. package/dest/note/note_dao.d.ts.map +1 -1
  394. package/dest/note/note_dao.js +15 -12
  395. package/dest/p2p/attestation_utils.d.ts +13 -3
  396. package/dest/p2p/attestation_utils.d.ts.map +1 -1
  397. package/dest/p2p/attestation_utils.js +46 -1
  398. package/dest/p2p/block_proposal.d.ts +102 -23
  399. package/dest/p2p/block_proposal.d.ts.map +1 -1
  400. package/dest/p2p/block_proposal.js +138 -39
  401. package/dest/p2p/checkpoint_attestation.d.ts +82 -0
  402. package/dest/p2p/checkpoint_attestation.d.ts.map +1 -0
  403. package/dest/p2p/{block_attestation.js → checkpoint_attestation.js} +22 -19
  404. package/dest/p2p/checkpoint_proposal.d.ts +174 -0
  405. package/dest/p2p/checkpoint_proposal.d.ts.map +1 -0
  406. package/dest/p2p/checkpoint_proposal.js +231 -0
  407. package/dest/p2p/client_type.d.ts +2 -5
  408. package/dest/p2p/client_type.d.ts.map +1 -1
  409. package/dest/p2p/client_type.js +0 -7
  410. package/dest/p2p/consensus_payload.d.ts +20 -11
  411. package/dest/p2p/consensus_payload.d.ts.map +1 -1
  412. package/dest/p2p/consensus_payload.js +24 -19
  413. package/dest/p2p/constants.d.ts +5 -0
  414. package/dest/p2p/constants.d.ts.map +1 -0
  415. package/dest/p2p/constants.js +3 -0
  416. package/dest/p2p/gossipable.d.ts +4 -3
  417. package/dest/p2p/gossipable.d.ts.map +1 -1
  418. package/dest/p2p/gossipable.js +16 -5
  419. package/dest/p2p/index.d.ts +5 -3
  420. package/dest/p2p/index.d.ts.map +1 -1
  421. package/dest/p2p/index.js +4 -2
  422. package/dest/p2p/message_validator.d.ts +18 -3
  423. package/dest/p2p/message_validator.d.ts.map +1 -1
  424. package/dest/p2p/message_validator.js +2 -1
  425. package/dest/p2p/peer_error.d.ts +3 -1
  426. package/dest/p2p/peer_error.d.ts.map +1 -1
  427. package/dest/p2p/peer_error.js +5 -0
  428. package/dest/p2p/signature_utils.d.ts +5 -3
  429. package/dest/p2p/signature_utils.d.ts.map +1 -1
  430. package/dest/p2p/signature_utils.js +3 -1
  431. package/dest/p2p/signed_txs.d.ts +42 -0
  432. package/dest/p2p/signed_txs.d.ts.map +1 -0
  433. package/dest/p2p/signed_txs.js +75 -0
  434. package/dest/p2p/topic_type.d.ts +5 -5
  435. package/dest/p2p/topic_type.d.ts.map +1 -1
  436. package/dest/p2p/topic_type.js +9 -19
  437. package/dest/parity/parity_base_private_inputs.d.ts +3 -1
  438. package/dest/parity/parity_base_private_inputs.d.ts.map +1 -1
  439. package/dest/parity/parity_public_inputs.d.ts +4 -1
  440. package/dest/parity/parity_public_inputs.d.ts.map +1 -1
  441. package/dest/parity/parity_root_private_inputs.d.ts +2 -1
  442. package/dest/parity/parity_root_private_inputs.d.ts.map +1 -1
  443. package/dest/proofs/chonk_proof.d.ts +1 -1
  444. package/dest/proofs/chonk_proof.d.ts.map +1 -1
  445. package/dest/proofs/chonk_proof.js +9 -4
  446. package/dest/proofs/proof.d.ts +4 -1
  447. package/dest/proofs/proof.d.ts.map +1 -1
  448. package/dest/proofs/recursive_proof.d.ts +10 -1
  449. package/dest/proofs/recursive_proof.d.ts.map +1 -1
  450. package/dest/rollup/avm_proof_data.d.ts +1 -3
  451. package/dest/rollup/avm_proof_data.d.ts.map +1 -1
  452. package/dest/rollup/avm_proof_data.js +1 -9
  453. package/dest/rollup/base_rollup_hints.d.ts +34 -1
  454. package/dest/rollup/base_rollup_hints.d.ts.map +1 -1
  455. package/dest/rollup/block_constant_data.d.ts +12 -1
  456. package/dest/rollup/block_constant_data.d.ts.map +1 -1
  457. package/dest/rollup/block_headers_hash.js +1 -1
  458. package/dest/rollup/block_merge_rollup_private_inputs.d.ts +4 -1
  459. package/dest/rollup/block_merge_rollup_private_inputs.d.ts.map +1 -1
  460. package/dest/rollup/block_rollup_public_inputs.d.ts +47 -11
  461. package/dest/rollup/block_rollup_public_inputs.d.ts.map +1 -1
  462. package/dest/rollup/block_rollup_public_inputs.js +8 -12
  463. package/dest/rollup/block_root_rollup_private_inputs.d.ts +64 -1
  464. package/dest/rollup/block_root_rollup_private_inputs.d.ts.map +1 -1
  465. package/dest/rollup/checkpoint_constant_data.d.ts +11 -1
  466. package/dest/rollup/checkpoint_constant_data.d.ts.map +1 -1
  467. package/dest/rollup/checkpoint_constant_data.js +4 -1
  468. package/dest/rollup/checkpoint_header.d.ts +46 -12
  469. package/dest/rollup/checkpoint_header.d.ts.map +1 -1
  470. package/dest/rollup/checkpoint_header.js +53 -20
  471. package/dest/rollup/checkpoint_merge_rollup_private_inputs.d.ts +4 -1
  472. package/dest/rollup/checkpoint_merge_rollup_private_inputs.d.ts.map +1 -1
  473. package/dest/rollup/checkpoint_rollup_public_inputs.d.ts +46 -6
  474. package/dest/rollup/checkpoint_rollup_public_inputs.d.ts.map +1 -1
  475. package/dest/rollup/checkpoint_rollup_public_inputs.js +11 -3
  476. package/dest/rollup/checkpoint_root_rollup_private_inputs.d.ts +44 -3
  477. package/dest/rollup/checkpoint_root_rollup_private_inputs.d.ts.map +1 -1
  478. package/dest/rollup/checkpoint_root_rollup_private_inputs.js +13 -2
  479. package/dest/rollup/epoch_constant_data.d.ts +16 -1
  480. package/dest/rollup/epoch_constant_data.d.ts.map +1 -1
  481. package/dest/rollup/root_rollup_private_inputs.d.ts +6 -1
  482. package/dest/rollup/root_rollup_private_inputs.d.ts.map +1 -1
  483. package/dest/rollup/root_rollup_public_inputs.d.ts +21 -6
  484. package/dest/rollup/root_rollup_public_inputs.d.ts.map +1 -1
  485. package/dest/rollup/root_rollup_public_inputs.js +10 -4
  486. package/dest/rollup/tree_snapshot_diff_hints.d.ts +24 -1
  487. package/dest/rollup/tree_snapshot_diff_hints.d.ts.map +1 -1
  488. package/dest/rollup/tx_merge_rollup_private_inputs.d.ts +4 -1
  489. package/dest/rollup/tx_merge_rollup_private_inputs.d.ts.map +1 -1
  490. package/dest/rollup/tx_rollup_public_inputs.d.ts +29 -1
  491. package/dest/rollup/tx_rollup_public_inputs.d.ts.map +1 -1
  492. package/dest/schemas/schemas.d.ts +5 -3
  493. package/dest/schemas/schemas.d.ts.map +1 -1
  494. package/dest/schemas/schemas.js +2 -1
  495. package/dest/slashing/empire.d.ts +1 -1
  496. package/dest/slashing/empire.d.ts.map +1 -1
  497. package/dest/slashing/empire.js +2 -0
  498. package/dest/slashing/helpers.d.ts +2 -2
  499. package/dest/slashing/helpers.d.ts.map +1 -1
  500. package/dest/slashing/helpers.js +6 -0
  501. package/dest/slashing/tally.d.ts +8 -2
  502. package/dest/slashing/tally.d.ts.map +1 -1
  503. package/dest/slashing/tally.js +35 -3
  504. package/dest/slashing/types.d.ts +10 -7
  505. package/dest/slashing/types.d.ts.map +1 -1
  506. package/dest/slashing/types.js +18 -6
  507. package/dest/snapshots/types.d.ts +1 -1
  508. package/dest/snapshots/types.d.ts.map +1 -1
  509. package/dest/snapshots/types.js +5 -5
  510. package/dest/stats/stats.d.ts +10 -8
  511. package/dest/stats/stats.d.ts.map +1 -1
  512. package/dest/tests/factories.d.ts +41 -10
  513. package/dest/tests/factories.d.ts.map +1 -1
  514. package/dest/tests/factories.js +99 -36
  515. package/dest/tests/jest.js +1 -1
  516. package/dest/tests/mocks.d.ts +81 -20
  517. package/dest/tests/mocks.d.ts.map +1 -1
  518. package/dest/tests/mocks.js +160 -71
  519. package/dest/timetable/index.d.ts +37 -0
  520. package/dest/timetable/index.d.ts.map +1 -0
  521. package/dest/timetable/index.js +39 -0
  522. package/dest/trees/append_only_tree_snapshot.d.ts +13 -1
  523. package/dest/trees/append_only_tree_snapshot.d.ts.map +1 -1
  524. package/dest/trees/append_only_tree_snapshot.js +3 -1
  525. package/dest/trees/nullifier_leaf.d.ts +13 -1
  526. package/dest/trees/nullifier_leaf.d.ts.map +1 -1
  527. package/dest/trees/nullifier_membership_witness.d.ts +10 -1
  528. package/dest/trees/nullifier_membership_witness.d.ts.map +1 -1
  529. package/dest/trees/public_data_leaf.d.ts +17 -1
  530. package/dest/trees/public_data_leaf.d.ts.map +1 -1
  531. package/dest/trees/public_data_leaf.js +7 -6
  532. package/dest/trees/public_data_witness.d.ts +11 -1
  533. package/dest/trees/public_data_witness.d.ts.map +1 -1
  534. package/dest/tx/block_header.d.ts +23 -8
  535. package/dest/tx/block_header.d.ts.map +1 -1
  536. package/dest/tx/block_header.js +17 -3
  537. package/dest/tx/call_context.d.ts +13 -1
  538. package/dest/tx/call_context.d.ts.map +1 -1
  539. package/dest/tx/call_context.js +3 -1
  540. package/dest/tx/capsule.d.ts +4 -1
  541. package/dest/tx/capsule.d.ts.map +1 -1
  542. package/dest/tx/execution_payload.d.ts +9 -1
  543. package/dest/tx/execution_payload.d.ts.map +1 -1
  544. package/dest/tx/function_data.d.ts +4 -2
  545. package/dest/tx/function_data.d.ts.map +1 -1
  546. package/dest/tx/global_variable_builder.d.ts +5 -3
  547. package/dest/tx/global_variable_builder.d.ts.map +1 -1
  548. package/dest/tx/global_variables.d.ts +14 -1
  549. package/dest/tx/global_variables.d.ts.map +1 -1
  550. package/dest/tx/global_variables.js +3 -1
  551. package/dest/tx/hashed_values.d.ts +7 -1
  552. package/dest/tx/hashed_values.d.ts.map +1 -1
  553. package/dest/tx/in_tx.d.ts +4 -4
  554. package/dest/tx/index.d.ts +1 -2
  555. package/dest/tx/index.d.ts.map +1 -1
  556. package/dest/tx/index.js +0 -1
  557. package/dest/tx/indexed_tx_effect.d.ts +5 -5
  558. package/dest/tx/indexed_tx_effect.d.ts.map +1 -1
  559. package/dest/tx/indexed_tx_effect.js +3 -2
  560. package/dest/tx/partial_state_reference.d.ts +4 -1
  561. package/dest/tx/partial_state_reference.d.ts.map +1 -1
  562. package/dest/tx/private_execution_result.d.ts +24 -7
  563. package/dest/tx/private_execution_result.d.ts.map +1 -1
  564. package/dest/tx/private_execution_result.js +4 -21
  565. package/dest/tx/private_tx_constant_data.d.ts +16 -1
  566. package/dest/tx/private_tx_constant_data.d.ts.map +1 -1
  567. package/dest/tx/profiling.d.ts +152 -29
  568. package/dest/tx/profiling.d.ts.map +1 -1
  569. package/dest/tx/profiling.js +47 -10
  570. package/dest/tx/protocol_contracts.d.ts +2 -2
  571. package/dest/tx/protocol_contracts.d.ts.map +1 -1
  572. package/dest/tx/protocol_contracts.js +2 -2
  573. package/dest/tx/public_call_request_with_calldata.d.ts +7 -1
  574. package/dest/tx/public_call_request_with_calldata.d.ts.map +1 -1
  575. package/dest/tx/public_call_request_with_calldata.js +3 -1
  576. package/dest/tx/public_simulation_output.d.ts +4 -2
  577. package/dest/tx/public_simulation_output.d.ts.map +1 -1
  578. package/dest/tx/public_simulation_output.js +7 -3
  579. package/dest/tx/simulated_tx.d.ts +1035 -8
  580. package/dest/tx/simulated_tx.d.ts.map +1 -1
  581. package/dest/tx/simulated_tx.js +4 -1
  582. package/dest/tx/state_reference.d.ts +3 -1
  583. package/dest/tx/state_reference.d.ts.map +1 -1
  584. package/dest/tx/state_reference.js +3 -1
  585. package/dest/tx/tree_snapshots.js +3 -1
  586. package/dest/tx/tx.d.ts +38 -7
  587. package/dest/tx/tx.d.ts.map +1 -1
  588. package/dest/tx/tx.js +36 -12
  589. package/dest/tx/tx_context.d.ts +2 -1
  590. package/dest/tx/tx_context.d.ts.map +1 -1
  591. package/dest/tx/tx_effect.d.ts +32 -6
  592. package/dest/tx/tx_effect.d.ts.map +1 -1
  593. package/dest/tx/tx_effect.js +6 -9
  594. package/dest/tx/tx_execution_request.d.ts +30 -1
  595. package/dest/tx/tx_execution_request.d.ts.map +1 -1
  596. package/dest/tx/tx_execution_request.js +6 -2
  597. package/dest/tx/tx_hash.d.ts +2 -1
  598. package/dest/tx/tx_hash.d.ts.map +1 -1
  599. package/dest/tx/tx_receipt.d.ts +62 -14
  600. package/dest/tx/tx_receipt.d.ts.map +1 -1
  601. package/dest/tx/tx_receipt.js +55 -16
  602. package/dest/tx/tx_request.d.ts +6 -1
  603. package/dest/tx/tx_request.d.ts.map +1 -1
  604. package/dest/tx/tx_request.js +2 -2
  605. package/dest/tx/validator/empty_validator.d.ts +2 -2
  606. package/dest/tx/validator/empty_validator.d.ts.map +1 -1
  607. package/dest/tx/validator/error_texts.d.ts +7 -2
  608. package/dest/tx/validator/error_texts.d.ts.map +1 -1
  609. package/dest/tx/validator/error_texts.js +7 -1
  610. package/dest/tx/validator/tx_validator.d.ts +2 -5
  611. package/dest/tx/validator/tx_validator.d.ts.map +1 -1
  612. package/dest/tx/validator/tx_validator.js +4 -4
  613. package/dest/types/shared.d.ts +4 -1
  614. package/dest/types/shared.d.ts.map +1 -1
  615. package/dest/update-checker/index.d.ts +3 -2
  616. package/dest/update-checker/index.d.ts.map +1 -1
  617. package/dest/update-checker/index.js +2 -1
  618. package/dest/update-checker/package_version.d.ts +3 -0
  619. package/dest/update-checker/package_version.d.ts.map +1 -0
  620. package/dest/update-checker/package_version.js +24 -0
  621. package/dest/update-checker/version_checker.d.ts +25 -0
  622. package/dest/update-checker/version_checker.d.ts.map +1 -0
  623. package/dest/update-checker/version_checker.js +50 -0
  624. package/dest/validators/errors.d.ts +6 -1
  625. package/dest/validators/errors.d.ts.map +1 -1
  626. package/dest/validators/errors.js +7 -0
  627. package/dest/validators/schemas.d.ts +38 -38
  628. package/dest/validators/schemas.d.ts.map +1 -1
  629. package/dest/validators/schemas.js +17 -16
  630. package/dest/validators/types.d.ts +3 -3
  631. package/dest/validators/types.d.ts.map +1 -1
  632. package/dest/vks/verification_key.d.ts +22 -1
  633. package/dest/vks/verification_key.d.ts.map +1 -1
  634. package/dest/vks/vk_data.d.ts +7 -1
  635. package/dest/vks/vk_data.d.ts.map +1 -1
  636. package/dest/zkpassport/index.d.ts +3 -4
  637. package/dest/zkpassport/index.d.ts.map +1 -1
  638. package/dest/zkpassport/index.js +9 -9
  639. package/package.json +28 -14
  640. package/src/abi/abi.ts +39 -33
  641. package/src/abi/contract_artifact.ts +10 -10
  642. package/src/abi/decoder.ts +15 -6
  643. package/src/abi/encoder.ts +49 -6
  644. package/src/abi/event_metadata_definition.ts +2 -0
  645. package/src/abi/function_call.ts +25 -3
  646. package/src/abi/function_selector.ts +8 -0
  647. package/src/abi/utils.ts +42 -0
  648. package/src/auth_witness/auth_witness.ts +3 -3
  649. package/src/avm/avm.ts +1 -1
  650. package/src/avm/revert_code.ts +15 -0
  651. package/src/block/attestation_info.ts +9 -6
  652. package/src/block/block_data.ts +26 -0
  653. package/src/block/block_hash.ts +26 -25
  654. package/src/block/block_parameter.ts +4 -2
  655. package/src/block/body.ts +2 -1
  656. package/src/block/checkpointed_l2_block.ts +70 -0
  657. package/src/block/in_block.ts +6 -6
  658. package/src/block/index.ts +2 -3
  659. package/src/block/l2_block.ts +112 -147
  660. package/src/block/l2_block_source.ts +207 -70
  661. package/src/block/l2_block_stream/index.ts +1 -0
  662. package/src/block/l2_block_stream/interfaces.ts +15 -4
  663. package/src/block/l2_block_stream/l2_block_stream.ts +160 -39
  664. package/src/block/l2_block_stream/l2_tips_memory_store.ts +62 -56
  665. package/src/block/l2_block_stream/l2_tips_store_base.ts +226 -0
  666. package/src/block/test/l2_tips_store_test_suite.ts +480 -35
  667. package/src/block/validate_block_result.ts +40 -35
  668. package/src/checkpoint/checkpoint.ts +120 -23
  669. package/src/checkpoint/checkpoint_data.ts +51 -0
  670. package/src/checkpoint/checkpoint_info.ts +52 -0
  671. package/src/checkpoint/index.ts +3 -0
  672. package/src/checkpoint/published_checkpoint.ts +25 -8
  673. package/src/checkpoint/validate.ts +230 -0
  674. package/src/config/index.ts +1 -0
  675. package/src/config/node-rpc-config.ts +1 -1
  676. package/src/config/sequencer-config.ts +34 -0
  677. package/src/contract/contract_address.ts +4 -4
  678. package/src/contract/contract_class.ts +3 -3
  679. package/src/contract/contract_class_id.ts +6 -5
  680. package/src/contract/index.ts +0 -2
  681. package/src/contract/interfaces/contract_class.ts +59 -46
  682. package/src/contract/interfaces/contract_instance.ts +15 -13
  683. package/src/contract/interfaces/contract_instance_update.ts +11 -9
  684. package/src/contract/interfaces/node-info.ts +3 -0
  685. package/src/contract/private_function.ts +3 -4
  686. package/src/contract/private_function_membership_proof.ts +1 -1
  687. package/src/database-version/database_version.ts +87 -0
  688. package/src/database-version/version_manager.ts +1 -77
  689. package/src/delayed_public_mutable/delayed_public_mutable_values.ts +9 -10
  690. package/src/deserialization/index.ts +21 -0
  691. package/src/epoch-helpers/index.ts +27 -10
  692. package/src/file-store/local.ts +15 -5
  693. package/src/file-store/s3.ts +12 -3
  694. package/src/hash/hash.ts +12 -19
  695. package/src/hash/map_slot.ts +3 -2
  696. package/src/interfaces/allowed_element.ts +34 -12
  697. package/src/interfaces/api_limit.ts +2 -0
  698. package/src/interfaces/archiver.ts +41 -25
  699. package/src/interfaces/aztec-node-admin.ts +33 -6
  700. package/src/interfaces/aztec-node.ts +133 -139
  701. package/src/interfaces/block-builder.ts +76 -25
  702. package/src/interfaces/configs.ts +104 -37
  703. package/src/interfaces/get_logs_response.ts +13 -9
  704. package/src/interfaces/l2_logs_source.ts +25 -7
  705. package/src/interfaces/merkle_tree_operations.ts +4 -1
  706. package/src/interfaces/p2p.ts +10 -25
  707. package/src/interfaces/prover-broker.ts +22 -0
  708. package/src/interfaces/prover-client.ts +43 -10
  709. package/src/interfaces/proving-job.ts +2 -11
  710. package/src/interfaces/server_circuit_prover.ts +3 -3
  711. package/src/interfaces/slasher.ts +28 -22
  712. package/src/interfaces/tx_provider.ts +2 -2
  713. package/src/interfaces/validator.ts +110 -32
  714. package/src/interfaces/world_state.ts +16 -9
  715. package/src/kernel/hints/build_note_hash_read_request_hints.ts +34 -30
  716. package/src/kernel/hints/build_nullifier_read_request_hints.ts +32 -32
  717. package/src/kernel/hints/build_transient_data_hints.ts +17 -2
  718. package/src/kernel/hints/find_private_kernel_reset_dimensions.ts +2 -4
  719. package/src/kernel/hints/index.ts +2 -2
  720. package/src/kernel/hints/{key_validation_request_and_generator.ts → key_validation_request_and_separator.ts} +12 -15
  721. package/src/kernel/hints/{scoped_key_validation_request_and_generator.ts → scoped_key_validation_request_and_separator.ts} +10 -10
  722. package/src/kernel/private_circuit_public_inputs.ts +99 -99
  723. package/src/kernel/private_kernel_circuit_public_inputs.ts +2 -2
  724. package/src/kernel/private_kernel_tail_circuit_private_inputs.ts +2 -2
  725. package/src/kernel/private_kernel_tail_circuit_public_inputs.ts +14 -5
  726. package/src/kernel/private_to_public_kernel_circuit_public_inputs.ts +5 -5
  727. package/src/kernel/private_to_rollup_kernel_circuit_public_inputs.ts +5 -5
  728. package/src/kernel/private_validation_requests.ts +8 -8
  729. package/src/keys/derivation.ts +15 -15
  730. package/src/keys/key_types.ts +6 -2
  731. package/src/keys/public_keys.ts +2 -2
  732. package/src/keys/utils.ts +8 -4
  733. package/src/l1-contracts/slash_factory.ts +1 -0
  734. package/src/logs/debug_log_store.ts +54 -0
  735. package/src/logs/{directional_app_tagging_secret.ts → extended_directional_app_tagging_secret.ts} +24 -16
  736. package/src/logs/index.ts +4 -2
  737. package/src/logs/log_id.ts +26 -12
  738. package/src/logs/pre_tag.ts +5 -5
  739. package/src/logs/private_log.ts +2 -1
  740. package/src/logs/public_log.ts +4 -2
  741. package/src/logs/siloed_tag.ts +50 -0
  742. package/src/logs/tag.ts +42 -0
  743. package/src/logs/tx_scoped_l2_log.ts +45 -43
  744. package/src/messaging/in_hash.ts +3 -1
  745. package/src/messaging/l1_to_l2_message.ts +1 -0
  746. package/src/messaging/l2_to_l1_membership.ts +178 -52
  747. package/src/messaging/out_hash.ts +62 -21
  748. package/src/note/index.ts +0 -1
  749. package/src/note/note_dao.ts +18 -13
  750. package/src/p2p/attestation_utils.ts +59 -3
  751. package/src/p2p/block_proposal.ts +211 -46
  752. package/src/p2p/{block_attestation.ts → checkpoint_attestation.ts} +36 -25
  753. package/src/p2p/checkpoint_proposal.ts +370 -0
  754. package/src/p2p/client_type.ts +0 -6
  755. package/src/p2p/consensus_payload.ts +29 -18
  756. package/src/p2p/constants.ts +6 -0
  757. package/src/p2p/gossipable.ts +14 -4
  758. package/src/p2p/index.ts +4 -2
  759. package/src/p2p/message_validator.ts +14 -2
  760. package/src/p2p/peer_error.ts +7 -0
  761. package/src/p2p/signature_utils.ts +3 -1
  762. package/src/p2p/signed_txs.ts +88 -0
  763. package/src/p2p/topic_type.ts +10 -16
  764. package/src/proofs/chonk_proof.ts +9 -5
  765. package/src/rollup/avm_proof_data.ts +0 -7
  766. package/src/rollup/block_headers_hash.ts +1 -1
  767. package/src/rollup/block_rollup_public_inputs.ts +5 -11
  768. package/src/rollup/checkpoint_constant_data.ts +1 -0
  769. package/src/rollup/checkpoint_header.ts +67 -20
  770. package/src/rollup/checkpoint_rollup_public_inputs.ts +17 -5
  771. package/src/rollup/checkpoint_root_rollup_private_inputs.ts +14 -1
  772. package/src/rollup/root_rollup_public_inputs.ts +16 -7
  773. package/src/schemas/schemas.ts +4 -0
  774. package/src/slashing/empire.ts +3 -1
  775. package/src/slashing/helpers.ts +8 -0
  776. package/src/slashing/tally.ts +41 -2
  777. package/src/slashing/types.ts +38 -20
  778. package/src/snapshots/types.ts +33 -29
  779. package/src/stats/stats.ts +10 -7
  780. package/src/tests/factories.ts +124 -54
  781. package/src/tests/jest.ts +1 -1
  782. package/src/tests/mocks.ts +260 -100
  783. package/src/timetable/index.ts +66 -0
  784. package/src/trees/public_data_leaf.ts +11 -5
  785. package/src/tx/block_header.ts +28 -9
  786. package/src/tx/global_variable_builder.ts +9 -2
  787. package/src/tx/global_variables.ts +6 -0
  788. package/src/tx/index.ts +0 -1
  789. package/src/tx/indexed_tx_effect.ts +3 -2
  790. package/src/tx/private_execution_result.ts +2 -17
  791. package/src/tx/profiling.ts +51 -9
  792. package/src/tx/protocol_contracts.ts +2 -2
  793. package/src/tx/public_simulation_output.ts +4 -0
  794. package/src/tx/simulated_tx.ts +8 -1
  795. package/src/tx/tx.ts +39 -22
  796. package/src/tx/tx_effect.ts +3 -10
  797. package/src/tx/tx_execution_request.ts +2 -0
  798. package/src/tx/tx_receipt.ts +85 -18
  799. package/src/tx/tx_request.ts +2 -2
  800. package/src/tx/validator/empty_validator.ts +1 -1
  801. package/src/tx/validator/error_texts.ts +8 -1
  802. package/src/tx/validator/tx_validator.ts +9 -7
  803. package/src/update-checker/index.ts +2 -1
  804. package/src/update-checker/package_version.ts +30 -0
  805. package/src/update-checker/version_checker.ts +65 -0
  806. package/src/validators/errors.ts +9 -0
  807. package/src/validators/schemas.ts +61 -48
  808. package/src/validators/types.ts +5 -4
  809. package/src/zkpassport/index.ts +11 -12
  810. package/dest/block/l2_block_code_to_purge.d.ts +0 -12
  811. package/dest/block/l2_block_code_to_purge.d.ts.map +0 -1
  812. package/dest/block/l2_block_code_to_purge.js +0 -61
  813. package/dest/block/l2_block_header.d.ts +0 -98
  814. package/dest/block/l2_block_header.d.ts.map +0 -1
  815. package/dest/block/l2_block_header.js +0 -153
  816. package/dest/block/l2_block_new.d.ts +0 -130
  817. package/dest/block/l2_block_new.d.ts.map +0 -1
  818. package/dest/block/l2_block_new.js +0 -151
  819. package/dest/block/published_l2_block.d.ts +0 -130
  820. package/dest/block/published_l2_block.d.ts.map +0 -1
  821. package/dest/block/published_l2_block.js +0 -48
  822. package/dest/contract/contract_class_metadata.d.ts +0 -8
  823. package/dest/contract/contract_class_metadata.d.ts.map +0 -1
  824. package/dest/contract/contract_class_metadata.js +0 -1
  825. package/dest/contract/contract_metadata.d.ts +0 -7
  826. package/dest/contract/contract_metadata.d.ts.map +0 -1
  827. package/dest/contract/contract_metadata.js +0 -1
  828. package/dest/database-version/index.d.ts +0 -2
  829. package/dest/database-version/index.d.ts.map +0 -1
  830. package/dest/database-version/index.js +0 -1
  831. package/dest/kernel/hints/key_validation_request_and_generator.d.ts +0 -25
  832. package/dest/kernel/hints/key_validation_request_and_generator.d.ts.map +0 -1
  833. package/dest/logs/directional_app_tagging_secret.d.ts +0 -40
  834. package/dest/logs/directional_app_tagging_secret.d.ts.map +0 -1
  835. package/dest/logs/log_with_tx_data.d.ts +0 -19
  836. package/dest/logs/log_with_tx_data.d.ts.map +0 -1
  837. package/dest/logs/log_with_tx_data.js +0 -49
  838. package/dest/note/notes_filter.d.ts +0 -27
  839. package/dest/note/notes_filter.d.ts.map +0 -1
  840. package/dest/note/notes_filter.js +0 -11
  841. package/dest/p2p/block_attestation.d.ts +0 -80
  842. package/dest/p2p/block_attestation.d.ts.map +0 -1
  843. package/dest/tx/content_commitment.d.ts +0 -49
  844. package/dest/tx/content_commitment.d.ts.map +0 -1
  845. package/dest/tx/content_commitment.js +0 -90
  846. package/dest/update-checker/update-checker.d.ts +0 -49
  847. package/dest/update-checker/update-checker.d.ts.map +0 -1
  848. package/dest/update-checker/update-checker.js +0 -130
  849. package/src/block/l2_block_code_to_purge.ts +0 -88
  850. package/src/block/l2_block_header.ts +0 -246
  851. package/src/block/l2_block_new.ts +0 -197
  852. package/src/block/published_l2_block.ts +0 -65
  853. package/src/contract/contract_class_metadata.ts +0 -8
  854. package/src/contract/contract_metadata.ts +0 -7
  855. package/src/database-version/index.ts +0 -1
  856. package/src/logs/log_with_tx_data.ts +0 -46
  857. package/src/note/notes_filter.ts +0 -38
  858. package/src/tx/content_commitment.ts +0 -113
  859. package/src/update-checker/update-checker.ts +0 -166
@@ -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';
@@ -21,7 +20,8 @@ import { TxHash } from '@aztec/stdlib/tx';
21
20
  txHash;
22
21
  l2BlockNumber;
23
22
  l2BlockHash;
24
- index;
23
+ txIndexInBlock;
24
+ noteIndexInTx;
25
25
  constructor(// Note information
26
26
  /** The packed content of the note, as will be returned in the getNotes oracle. */ note, /** The address of the contract that created the note (i.e. the address used by the kernel during siloing). */ contractAddress, /** The owner of the note - generally the account that can spend the note. */ owner, /**
27
27
  * The storage location of the note. This value is not used for anything in PXE, but we do index by storage slot
@@ -40,7 +40,7 @@ import { TxHash } from '@aztec/stdlib/tx';
40
40
  * when searching for txEffects.
41
41
  */ txHash, /** The L2 block number in which the tx with this note was included. Used for note management while processing
42
42
  * reorgs.*/ l2BlockNumber, /** The L2 block hash in which the tx with this note was included. Used for note management while processing
43
- * reorgs.*/ l2BlockHash, /** The index of the leaf in the global note hash tree the note is stored at */ index){
43
+ * reorgs.*/ l2BlockHash, /** The index of the tx within the block, used for ordering notes. */ txIndexInBlock, /** The index of the note within the tx (based on note hash position), used for ordering notes. */ noteIndexInTx){
44
44
  this.note = note;
45
45
  this.contractAddress = contractAddress;
46
46
  this.owner = owner;
@@ -52,7 +52,8 @@ import { TxHash } from '@aztec/stdlib/tx';
52
52
  this.txHash = txHash;
53
53
  this.l2BlockNumber = l2BlockNumber;
54
54
  this.l2BlockHash = l2BlockHash;
55
- this.index = index;
55
+ this.txIndexInBlock = txIndexInBlock;
56
+ this.noteIndexInTx = noteIndexInTx;
56
57
  }
57
58
  toBuffer() {
58
59
  return serializeToBuffer([
@@ -67,7 +68,8 @@ import { TxHash } from '@aztec/stdlib/tx';
67
68
  this.txHash,
68
69
  this.l2BlockNumber,
69
70
  Fr.fromHexString(this.l2BlockHash),
70
- this.index
71
+ this.txIndexInBlock,
72
+ this.noteIndexInTx
71
73
  ]);
72
74
  }
73
75
  static fromBuffer(buffer) {
@@ -83,8 +85,9 @@ import { TxHash } from '@aztec/stdlib/tx';
83
85
  const txHash = reader.readObject(TxHash);
84
86
  const l2BlockNumber = BlockNumber(reader.readNumber());
85
87
  const l2BlockHash = Fr.fromBuffer(reader).toString();
86
- const index = toBigIntBE(reader.readBytes(32));
87
- return new NoteDao(note, contractAddress, owner, storageSlot, randomness, noteNonce, noteHash, siloedNullifier, txHash, l2BlockNumber, l2BlockHash, index);
88
+ const txIndexInBlock = reader.readNumber();
89
+ const noteIndexInTx = reader.readNumber();
90
+ return new NoteDao(note, contractAddress, owner, storageSlot, randomness, noteNonce, noteHash, siloedNullifier, txHash, l2BlockNumber, l2BlockHash, txIndexInBlock, noteIndexInTx);
88
91
  }
89
92
  toString() {
90
93
  return '0x' + this.toBuffer().toString('hex');
@@ -96,17 +99,17 @@ import { TxHash } from '@aztec/stdlib/tx';
96
99
  /**
97
100
  * Returns true if this note is equal to the `other` one.
98
101
  */ equals(other) {
99
- return this.note.equals(other.note) && this.contractAddress.equals(other.contractAddress) && this.owner.equals(other.owner) && this.storageSlot.equals(other.storageSlot) && this.randomness.equals(other.randomness) && this.noteNonce.equals(other.noteNonce) && this.noteHash.equals(other.noteHash) && this.siloedNullifier.equals(other.siloedNullifier) && this.txHash.equals(other.txHash) && this.l2BlockNumber === other.l2BlockNumber && this.l2BlockHash === other.l2BlockHash && this.index === other.index;
102
+ return this.note.equals(other.note) && this.contractAddress.equals(other.contractAddress) && this.owner.equals(other.owner) && this.storageSlot.equals(other.storageSlot) && this.randomness.equals(other.randomness) && this.noteNonce.equals(other.noteNonce) && this.noteHash.equals(other.noteHash) && this.siloedNullifier.equals(other.siloedNullifier) && this.txHash.equals(other.txHash) && this.l2BlockNumber === other.l2BlockNumber && this.l2BlockHash === other.l2BlockHash && this.txIndexInBlock === other.txIndexInBlock && this.noteIndexInTx === other.noteIndexInTx;
100
103
  }
101
104
  /**
102
105
  * Returns the size in bytes of the Note Dao.
103
106
  * @returns - Its size in bytes.
104
107
  */ getSize() {
105
- const indexSize = Math.ceil(Math.log2(Number(this.index)));
106
108
  const noteSize = 4 + this.note.items.length * Fr.SIZE_IN_BYTES;
107
- return noteSize + AztecAddress.SIZE_IN_BYTES * 2 + Fr.SIZE_IN_BYTES * 4 + TxHash.SIZE + Point.SIZE_IN_BYTES + indexSize;
109
+ // 2 numbers for txIndexInBlock and noteIndexInTx (4 bytes each)
110
+ return noteSize + AztecAddress.SIZE_IN_BYTES * 2 + Fr.SIZE_IN_BYTES * 4 + TxHash.SIZE + Point.SIZE_IN_BYTES + 8;
108
111
  }
109
- static async random({ note = Note.random(), contractAddress = undefined, owner = undefined, storageSlot = Fr.random(), randomness = Fr.random(), noteNonce = Fr.random(), noteHash = Fr.random(), siloedNullifier = Fr.random(), txHash = TxHash.random(), l2BlockNumber = BlockNumber(Math.floor(Math.random() * 1000)), l2BlockHash = Fr.random().toString(), index = Fr.random().toBigInt() } = {}) {
110
- return new NoteDao(note, contractAddress ?? await AztecAddress.random(), owner ?? await AztecAddress.random(), storageSlot, randomness, noteNonce, noteHash, siloedNullifier, txHash, l2BlockNumber, l2BlockHash, index);
112
+ static async random({ note = Note.random(), contractAddress = undefined, owner = undefined, storageSlot = Fr.random(), randomness = Fr.random(), noteNonce = Fr.random(), noteHash = Fr.random(), siloedNullifier = Fr.random(), txHash = TxHash.random(), l2BlockNumber = BlockNumber(Math.floor(Math.random() * 1000)), l2BlockHash = Fr.random().toString(), txIndexInBlock = Math.floor(Math.random() * 100), noteIndexInTx = Math.floor(Math.random() * 100) } = {}) {
113
+ return new NoteDao(note, contractAddress ?? await AztecAddress.random(), owner ?? await AztecAddress.random(), storageSlot, randomness, noteNonce, noteHash, siloedNullifier, txHash, l2BlockNumber, l2BlockHash, txIndexInBlock, noteIndexInTx);
111
114
  }
112
115
  }
@@ -1,10 +1,20 @@
1
1
  import type { EthAddress } from '@aztec/foundation/eth-address';
2
2
  import { CommitteeAttestation } from '../block/index.js';
3
- import type { BlockAttestation } from './block_attestation.js';
3
+ import type { CheckpointAttestation } from './checkpoint_attestation.js';
4
4
  /**
5
5
  * Returns attestation signatures in the order of a series of provided ethereum addresses
6
6
  * The rollup smart contract expects attestations to appear in the order of the committee
7
7
  * @todo: perform this logic within the memory attestation store instead?
8
8
  */
9
- export declare function orderAttestations(attestations: BlockAttestation[], orderAddresses: EthAddress[]): CommitteeAttestation[];
10
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXR0ZXN0YXRpb25fdXRpbHMuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9wMnAvYXR0ZXN0YXRpb25fdXRpbHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsVUFBVSxFQUFFLE1BQU0sK0JBQStCLENBQUM7QUFFaEUsT0FBTyxFQUFFLG9CQUFvQixFQUFFLE1BQU0sbUJBQW1CLENBQUM7QUFDekQsT0FBTyxLQUFLLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUUvRDs7OztHQUlHO0FBQ0gsd0JBQWdCLGlCQUFpQixDQUMvQixZQUFZLEVBQUUsZ0JBQWdCLEVBQUUsRUFDaEMsY0FBYyxFQUFFLFVBQVUsRUFBRSxHQUMzQixvQkFBb0IsRUFBRSxDQXFCeEIifQ==
9
+ export declare function orderAttestations(attestations: CheckpointAttestation[], orderAddresses: EthAddress[]): CommitteeAttestation[];
10
+ /**
11
+ * Trims attestations to the minimum required number to save L1 calldata gas.
12
+ * Each signature costs 65 bytes of calldata vs 20 bytes for just an address.
13
+ *
14
+ * Priority order for keeping attestations:
15
+ * 1. The proposer's attestation (required by L1 contract - MissingProposerSignature revert)
16
+ * 2. Attestations from the local node's validator keys
17
+ * 3. Remaining attestations filled to reach the required count
18
+ */
19
+ export declare function trimAttestations(attestations: CheckpointAttestation[], required: number, proposerAddress: EthAddress, localAddresses: EthAddress[]): CheckpointAttestation[];
20
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXR0ZXN0YXRpb25fdXRpbHMuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9wMnAvYXR0ZXN0YXRpb25fdXRpbHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsVUFBVSxFQUFFLE1BQU0sK0JBQStCLENBQUM7QUFFaEUsT0FBTyxFQUFFLG9CQUFvQixFQUFFLE1BQU0sbUJBQW1CLENBQUM7QUFDekQsT0FBTyxLQUFLLEVBQUUscUJBQXFCLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUV6RTs7OztHQUlHO0FBQ0gsd0JBQWdCLGlCQUFpQixDQUMvQixZQUFZLEVBQUUscUJBQXFCLEVBQUUsRUFDckMsY0FBYyxFQUFFLFVBQVUsRUFBRSxHQUMzQixvQkFBb0IsRUFBRSxDQXFCeEI7QUFFRDs7Ozs7Ozs7R0FRRztBQUNILHdCQUFnQixnQkFBZ0IsQ0FDOUIsWUFBWSxFQUFFLHFCQUFxQixFQUFFLEVBQ3JDLFFBQVEsRUFBRSxNQUFNLEVBQ2hCLGVBQWUsRUFBRSxVQUFVLEVBQzNCLGNBQWMsRUFBRSxVQUFVLEVBQUUsR0FDM0IscUJBQXFCLEVBQUUsQ0F3Q3pCIn0=
@@ -1 +1 @@
1
- {"version":3,"file":"attestation_utils.d.ts","sourceRoot":"","sources":["../../src/p2p/attestation_utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAEhE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,gBAAgB,EAAE,EAChC,cAAc,EAAE,UAAU,EAAE,GAC3B,oBAAoB,EAAE,CAqBxB"}
1
+ {"version":3,"file":"attestation_utils.d.ts","sourceRoot":"","sources":["../../src/p2p/attestation_utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAEhE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEzE;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,qBAAqB,EAAE,EACrC,cAAc,EAAE,UAAU,EAAE,GAC3B,oBAAoB,EAAE,CAqBxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,qBAAqB,EAAE,EACrC,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,UAAU,EAC3B,cAAc,EAAE,UAAU,EAAE,GAC3B,qBAAqB,EAAE,CAwCzB"}
@@ -4,7 +4,7 @@ import { CommitteeAttestation } from '../block/index.js';
4
4
  * The rollup smart contract expects attestations to appear in the order of the committee
5
5
  * @todo: perform this logic within the memory attestation store instead?
6
6
  */ export function orderAttestations(attestations, orderAddresses) {
7
- // Create a map of sender addresses to BlockAttestations
7
+ // Create a map of sender addresses to attestations
8
8
  const attestationMap = new Map();
9
9
  for (const attestation of attestations){
10
10
  const sender = attestation.getSender();
@@ -19,3 +19,48 @@ import { CommitteeAttestation } from '../block/index.js';
19
19
  });
20
20
  return orderedAttestations;
21
21
  }
22
+ /**
23
+ * Trims attestations to the minimum required number to save L1 calldata gas.
24
+ * Each signature costs 65 bytes of calldata vs 20 bytes for just an address.
25
+ *
26
+ * Priority order for keeping attestations:
27
+ * 1. The proposer's attestation (required by L1 contract - MissingProposerSignature revert)
28
+ * 2. Attestations from the local node's validator keys
29
+ * 3. Remaining attestations filled to reach the required count
30
+ */ export function trimAttestations(attestations, required, proposerAddress, localAddresses) {
31
+ if (attestations.length <= required) {
32
+ return attestations;
33
+ }
34
+ const proposerAttestation = [];
35
+ const localAttestations = [];
36
+ const otherAttestations = [];
37
+ for (const attestation of attestations){
38
+ const sender = attestation.getSender();
39
+ if (!sender) {
40
+ continue;
41
+ }
42
+ if (sender.equals(proposerAddress)) {
43
+ proposerAttestation.push(attestation);
44
+ } else if (localAddresses.some((addr)=>addr.equals(sender))) {
45
+ localAttestations.push(attestation);
46
+ } else {
47
+ otherAttestations.push(attestation);
48
+ }
49
+ }
50
+ const result = [
51
+ ...proposerAttestation
52
+ ];
53
+ for (const att of localAttestations){
54
+ if (result.length >= required) {
55
+ break;
56
+ }
57
+ result.push(att);
58
+ }
59
+ for (const att of otherAttestations){
60
+ if (result.length >= required) {
61
+ break;
62
+ }
63
+ result.push(att);
64
+ }
65
+ return result;
66
+ }
@@ -1,58 +1,137 @@
1
- import { 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 { Fr } from '@aztec/foundation/curves/bn254';
4
4
  import type { EthAddress } from '@aztec/foundation/eth-address';
5
5
  import { Signature } from '@aztec/foundation/eth-signature';
6
6
  import { BufferReader } from '@aztec/foundation/serialize';
7
+ import { type SigningContext } from '@aztec/validator-ha-signer/types';
8
+ import type { L2Block } from '../block/l2_block.js';
7
9
  import type { L2BlockInfo } from '../block/l2_block_info.js';
10
+ import { BlockHeader } from '../tx/block_header.js';
8
11
  import { TxHash } from '../tx/index.js';
9
- import { Tx } from '../tx/tx.js';
10
- import { ConsensusPayload } from './consensus_payload.js';
12
+ import type { Tx } from '../tx/tx.js';
11
13
  import { Gossipable } from './gossipable.js';
14
+ import { SignatureDomainSeparator } from './signature_utils.js';
15
+ import { SignedTxs } from './signed_txs.js';
12
16
  import { TopicType } from './topic_type.js';
13
17
  export declare class BlockProposalHash extends Buffer32 {
14
18
  constructor(hash: Buffer);
15
19
  }
16
20
  export type BlockProposalOptions = {
17
- publishFullTxs: boolean;
18
- /** Whether to generate an invalid block proposal for broadcasting. Use only for testing. */
21
+ /**
22
+ * Whether to include the tx objects along with the block proposal.
23
+ * Dramatically increases size of the payload but eliminates failed reexecutions due to missing txs.
24
+ */
25
+ publishFullTxs?: boolean;
26
+ /**
27
+ * Whether to generate an invalid block proposal for broadcasting.
28
+ * Use only for testing.
29
+ */
19
30
  broadcastInvalidBlockProposal?: boolean;
20
31
  };
21
32
  /**
22
- * BlockProposal
23
- *
24
- * A block proposal is created by the leader of the chain proposing a sequence of transactions to
25
- * be included in the head of the chain
33
+ * A block proposal is created by the leader of the chain proposing a sequence of transactions
34
+ * to be included in a block within a checkpoint. This is used for non-last blocks in a slot.
35
+ * The last block is sent as part of a CheckpointProposal.
26
36
  */
27
37
  export declare class BlockProposal extends Gossipable {
28
- readonly payload: ConsensusPayload;
29
- readonly signature: Signature;
38
+ /** The per-block header containing block state and global variables */
39
+ readonly blockHeader: BlockHeader;
40
+ /** Index of this block within the checkpoint (0-indexed) */
41
+ readonly indexWithinCheckpoint: IndexWithinCheckpoint;
42
+ /** Hash of L1 to L2 messages for this checkpoint (constant across all blocks in checkpoint) */
43
+ readonly inHash: Fr;
44
+ /** Archive root after this block is applied */
45
+ readonly archiveRoot: Fr;
46
+ /** The sequence of transactions in the block */
30
47
  readonly txHashes: TxHash[];
31
- readonly txs?: Tx[] | undefined;
48
+ /** The proposer's signature over the block data */
49
+ readonly signature: Signature;
50
+ /** The signed transactions in the block (optional, for DA guarantees) */
51
+ readonly signedTxs?: SignedTxs | undefined;
32
52
  static p2pTopic: TopicType;
33
53
  private sender;
34
54
  constructor(
35
- /** The payload of the message, and what the signature is over */
36
- payload: ConsensusPayload,
37
- /** The signer of the BlockProposal over the header of the new block*/
38
- signature: Signature,
55
+ /** The per-block header containing block state and global variables */
56
+ blockHeader: BlockHeader,
57
+ /** Index of this block within the checkpoint (0-indexed) */
58
+ indexWithinCheckpoint: IndexWithinCheckpoint,
59
+ /** Hash of L1 to L2 messages for this checkpoint (constant across all blocks in checkpoint) */
60
+ inHash: Fr,
61
+ /** Archive root after this block is applied */
62
+ archiveRoot: Fr,
39
63
  /** The sequence of transactions in the block */
40
64
  txHashes: TxHash[],
41
- /** The transactions in the block */
42
- txs?: Tx[] | undefined);
65
+ /** The proposer's signature over the block data */
66
+ signature: Signature,
67
+ /** The signed transactions in the block (optional, for DA guarantees) */
68
+ signedTxs?: SignedTxs | undefined);
43
69
  generateP2PMessageIdentifier(): Promise<Buffer32>;
44
70
  get archive(): Fr;
45
71
  get slotNumber(): SlotNumber;
72
+ get blockNumber(): BlockNumber;
73
+ /** Convenience getter for txs from signedTxs */
74
+ get txs(): Tx[] | undefined;
46
75
  toBlockInfo(): Omit<L2BlockInfo, 'blockNumber'>;
47
- static createProposalFromSigner(payload: ConsensusPayload, txHashes: TxHash[], txs: Tx[] | undefined, payloadSigner: (payload: Buffer32) => Promise<Signature>): Promise<BlockProposal>;
48
- /**Get Sender
49
- * Lazily evaluate the sender of the proposal; result is cached
50
- * @returns The sender address, or undefined if signature recovery fails
76
+ /**
77
+ * Get the payload to sign for this block proposal.
78
+ * The signature is over: blockHeader + indexWithinCheckpoint + inHash + archiveRoot + txHashes
79
+ */
80
+ getPayloadToSign(domainSeparator: SignatureDomainSeparator): Buffer;
81
+ static createProposalFromSigner(blockHeader: BlockHeader, indexWithinCheckpoint: IndexWithinCheckpoint, inHash: Fr, archiveRoot: Fr, txHashes: TxHash[], txs: Tx[] | undefined, payloadSigner: (payload: Buffer32, context: SigningContext) => Promise<Signature>): Promise<BlockProposal>;
82
+ /**
83
+ * Lazily evaluate the sender of the proposal; result is cached.
84
+ * If there's signedTxs, also verifies the signedTxs sender matches the block proposal sender.
85
+ * @returns The sender address, or undefined if signature recovery fails or senders don't match
51
86
  */
52
87
  getSender(): EthAddress | undefined;
53
88
  getPayload(): Buffer<ArrayBufferLike>;
54
89
  toBuffer(): Buffer;
55
90
  static fromBuffer(buf: Buffer | BufferReader): BlockProposal;
56
91
  getSize(): number;
92
+ static empty(): BlockProposal;
93
+ static random(): BlockProposal;
94
+ toInspect(): {
95
+ blockHeader: {
96
+ lastArchive: `0x${string}`;
97
+ state: {
98
+ l1ToL2MessageTree: `0x${string}`;
99
+ noteHashTree: `0x${string}`;
100
+ nullifierTree: `0x${string}`;
101
+ publicDataTree: `0x${string}`;
102
+ };
103
+ spongeBlobHash: bigint;
104
+ globalVariables: {
105
+ chainId: number;
106
+ version: number;
107
+ blockNumber: BlockNumber;
108
+ slotNumber: SlotNumber;
109
+ timestamp: bigint;
110
+ coinbase: `0x${string}`;
111
+ feeRecipient: `0x${string}`;
112
+ feePerDaGas: number;
113
+ feePerL2Gas: number;
114
+ };
115
+ totalFees: bigint;
116
+ totalManaUsed: bigint;
117
+ };
118
+ indexWithinCheckpoint: IndexWithinCheckpoint;
119
+ inHash: `0x${string}`;
120
+ archiveRoot: `0x${string}`;
121
+ signature: `0x${string}`;
122
+ txHashes: `0x${string}`[];
123
+ };
124
+ /**
125
+ * Check if this proposal matches the given block.
126
+ * Compares the archive root and block header.
127
+ * @param block - The L2Block to compare against
128
+ * @returns True if the proposal matches the block
129
+ */
130
+ matchesBlock(block: L2Block): boolean;
131
+ /**
132
+ * Returns a copy of this proposal without signedTxs.
133
+ * Used when storing proposals in attestation pool to avoid storing full tx data.
134
+ */
135
+ withoutSignedTxs(): BlockProposal;
57
136
  }
58
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYmxvY2tfcHJvcG9zYWwuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9wMnAvYmxvY2tfcHJvcG9zYWwudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLFVBQVUsRUFBRSxNQUFNLGlDQUFpQyxDQUFDO0FBQzdELE9BQU8sRUFBRSxRQUFRLEVBQUUsTUFBTSwwQkFBMEIsQ0FBQztBQUdwRCxPQUFPLEVBQUUsRUFBRSxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFDcEQsT0FBTyxLQUFLLEVBQUUsVUFBVSxFQUFFLE1BQU0sK0JBQStCLENBQUM7QUFDaEUsT0FBTyxFQUFFLFNBQVMsRUFBRSxNQUFNLGlDQUFpQyxDQUFDO0FBQzVELE9BQU8sRUFBRSxZQUFZLEVBQXFCLE1BQU0sNkJBQTZCLENBQUM7QUFFOUUsT0FBTyxLQUFLLEVBQUUsV0FBVyxFQUFFLE1BQU0sMkJBQTJCLENBQUM7QUFDN0QsT0FBTyxFQUFFLE1BQU0sRUFBRSxNQUFNLGdCQUFnQixDQUFDO0FBQ3hDLE9BQU8sRUFBRSxFQUFFLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFDakMsT0FBTyxFQUFFLGdCQUFnQixFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFDMUQsT0FBTyxFQUFFLFVBQVUsRUFBRSxNQUFNLGlCQUFpQixDQUFDO0FBTTdDLE9BQU8sRUFBRSxTQUFTLEVBQUUsTUFBTSxpQkFBaUIsQ0FBQztBQUU1QyxxQkFBYSxpQkFBa0IsU0FBUSxRQUFRO0lBQzdDLFlBQVksSUFBSSxFQUFFLE1BQU0sRUFFdkI7Q0FDRjtBQUVELE1BQU0sTUFBTSxvQkFBb0IsR0FBRztJQUNqQyxjQUFjLEVBQUUsT0FBTyxDQUFDO0lBQ3hCLDRGQUE0RjtJQUM1Riw2QkFBNkIsQ0FBQyxFQUFFLE9BQU8sQ0FBQztDQUN6QyxDQUFDO0FBRUY7Ozs7O0dBS0c7QUFDSCxxQkFBYSxhQUFjLFNBQVEsVUFBVTthQU96QixPQUFPLEVBQUUsZ0JBQWdCO2FBR3pCLFNBQVMsRUFBRSxTQUFTO2FBR3BCLFFBQVEsRUFBRSxNQUFNLEVBQUU7YUFJbEIsR0FBRyxDQUFDO0lBaEJ0QixPQUFnQixRQUFRLFlBQTRCO0lBRXBELE9BQU8sQ0FBQyxNQUFNLENBQXlCO0lBRXZDO0lBQ0UsaUVBQWlFO0lBQ2pELE9BQU8sRUFBRSxnQkFBZ0I7SUFFekMsc0VBQXNFO0lBQ3RELFNBQVMsRUFBRSxTQUFTO0lBRXBDLGdEQUFnRDtJQUNoQyxRQUFRLEVBQUUsTUFBTSxFQUFFO0lBR2xDLG9DQUFvQztJQUNwQixHQUFHLENBQUMsa0JBQU0sRUFHM0I7SUFFUSw0QkFBNEIsSUFBSSxPQUFPLENBQUMsUUFBUSxDQUFDLENBRXpEO0lBRUQsSUFBSSxPQUFPLElBQUksRUFBRSxDQUVoQjtJQUVELElBQUksVUFBVSxJQUFJLFVBQVUsQ0FFM0I7SUFFRCxXQUFXLElBQUksSUFBSSxDQUFDLFdBQVcsRUFBRSxhQUFhLENBQUMsQ0FROUM7SUFFRCxPQUFhLHdCQUF3QixDQUNuQyxPQUFPLEVBQUUsZ0JBQWdCLEVBQ3pCLFFBQVEsRUFBRSxNQUFNLEVBQUUsRUFFbEIsR0FBRyxFQUFFLEVBQUUsRUFBRSxHQUFHLFNBQVMsRUFDckIsYUFBYSxFQUFFLENBQUMsT0FBTyxFQUFFLFFBQVEsS0FBSyxPQUFPLENBQUMsU0FBUyxDQUFDLDBCQU16RDtJQUVEOzs7T0FHRztJQUNILFNBQVMsSUFBSSxVQUFVLEdBQUcsU0FBUyxDQVFsQztJQUVELFVBQVUsNEJBRVQ7SUFFRCxRQUFRLElBQUksTUFBTSxDQU9qQjtJQUVELE1BQU0sQ0FBQyxVQUFVLENBQUMsR0FBRyxFQUFFLE1BQU0sR0FBRyxZQUFZLEdBQUcsYUFBYSxDQWEzRDtJQUVELE9BQU8sSUFBSSxNQUFNLENBUWhCO0NBQ0YifQ==
137
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYmxvY2tfcHJvcG9zYWwuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9wMnAvYmxvY2tfcHJvcG9zYWwudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLFdBQVcsRUFBRSxxQkFBcUIsRUFBRSxVQUFVLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUNqRyxPQUFPLEVBQUUsUUFBUSxFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUFHcEQsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLGdDQUFnQyxDQUFDO0FBQ3BELE9BQU8sS0FBSyxFQUFFLFVBQVUsRUFBRSxNQUFNLCtCQUErQixDQUFDO0FBQ2hFLE9BQU8sRUFBRSxTQUFTLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUM1RCxPQUFPLEVBQUUsWUFBWSxFQUFxQixNQUFNLDZCQUE2QixDQUFDO0FBQzlFLE9BQU8sRUFBWSxLQUFLLGNBQWMsRUFBRSxNQUFNLGtDQUFrQyxDQUFDO0FBRWpGLE9BQU8sS0FBSyxFQUFFLE9BQU8sRUFBRSxNQUFNLHNCQUFzQixDQUFDO0FBQ3BELE9BQU8sS0FBSyxFQUFFLFdBQVcsRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBRTdELE9BQU8sRUFBRSxXQUFXLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUNwRCxPQUFPLEVBQUUsTUFBTSxFQUFFLE1BQU0sZ0JBQWdCLENBQUM7QUFDeEMsT0FBTyxLQUFLLEVBQUUsRUFBRSxFQUFFLE1BQU0sYUFBYSxDQUFDO0FBQ3RDLE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSxpQkFBaUIsQ0FBQztBQUM3QyxPQUFPLEVBQ0wsd0JBQXdCLEVBR3pCLE1BQU0sc0JBQXNCLENBQUM7QUFDOUIsT0FBTyxFQUFFLFNBQVMsRUFBRSxNQUFNLGlCQUFpQixDQUFDO0FBQzVDLE9BQU8sRUFBRSxTQUFTLEVBQUUsTUFBTSxpQkFBaUIsQ0FBQztBQUU1QyxxQkFBYSxpQkFBa0IsU0FBUSxRQUFRO0lBQzdDLFlB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
@@ -1 +1 @@
1
- {"version":3,"file":"block_proposal.d.ts","sourceRoot":"","sources":["../../src/p2p/block_proposal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAGpD,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAqB,MAAM,6BAA6B,CAAC;AAE9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAM7C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,qBAAa,iBAAkB,SAAQ,QAAQ;IAC7C,YAAY,IAAI,EAAE,MAAM,EAEvB;CACF;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,cAAc,EAAE,OAAO,CAAC;IACxB,4FAA4F;IAC5F,6BAA6B,CAAC,EAAE,OAAO,CAAC;CACzC,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,UAAU;aAOzB,OAAO,EAAE,gBAAgB;aAGzB,SAAS,EAAE,SAAS;aAGpB,QAAQ,EAAE,MAAM,EAAE;aAIlB,GAAG,CAAC;IAhBtB,OAAgB,QAAQ,YAA4B;IAEpD,OAAO,CAAC,MAAM,CAAyB;IAEvC;IACE,iEAAiE;IACjD,OAAO,EAAE,gBAAgB;IAEzC,sEAAsE;IACtD,SAAS,EAAE,SAAS;IAEpC,gDAAgD;IAChC,QAAQ,EAAE,MAAM,EAAE;IAGlC,oCAAoC;IACpB,GAAG,CAAC,kBAAM,EAG3B;IAEQ,4BAA4B,IAAI,OAAO,CAAC,QAAQ,CAAC,CAEzD;IAED,IAAI,OAAO,IAAI,EAAE,CAEhB;IAED,IAAI,UAAU,IAAI,UAAU,CAE3B;IAED,WAAW,IAAI,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAQ9C;IAED,OAAa,wBAAwB,CACnC,OAAO,EAAE,gBAAgB,EACzB,QAAQ,EAAE,MAAM,EAAE,EAElB,GAAG,EAAE,EAAE,EAAE,GAAG,SAAS,EACrB,aAAa,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC,SAAS,CAAC,0BAMzD;IAED;;;OAGG;IACH,SAAS,IAAI,UAAU,GAAG,SAAS,CAQlC;IAED,UAAU,4BAET;IAED,QAAQ,IAAI,MAAM,CAOjB;IAED,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,aAAa,CAa3D;IAED,OAAO,IAAI,MAAM,CAQhB;CACF"}
1
+ {"version":3,"file":"block_proposal.d.ts","sourceRoot":"","sources":["../../src/p2p/block_proposal.ts"],"names":[],"mappings":"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"}
@@ -1,13 +1,17 @@
1
+ import { IndexWithinCheckpoint } from '@aztec/foundation/branded-types';
1
2
  import { Buffer32 } from '@aztec/foundation/buffer';
2
3
  import { keccak256 } from '@aztec/foundation/crypto/keccak';
3
4
  import { tryRecoverAddress } from '@aztec/foundation/crypto/secp256k1-signer';
5
+ import { Fr } from '@aztec/foundation/curves/bn254';
4
6
  import { Signature } from '@aztec/foundation/eth-signature';
5
7
  import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize';
8
+ import { DutyType } from '@aztec/validator-ha-signer/types';
9
+ import { MAX_TXS_PER_BLOCK } from '../deserialization/index.js';
10
+ import { BlockHeader } from '../tx/block_header.js';
6
11
  import { TxHash } from '../tx/index.js';
7
- import { Tx } from '../tx/tx.js';
8
- import { ConsensusPayload } from './consensus_payload.js';
9
12
  import { Gossipable } from './gossipable.js';
10
13
  import { SignatureDomainSeparator, getHashedSignaturePayload, getHashedSignaturePayloadEthSignedMessage } from './signature_utils.js';
14
+ import { SignedTxs } from './signed_txs.js';
11
15
  import { TopicType } from './topic_type.js';
12
16
  export class BlockProposalHash extends Buffer32 {
13
17
  constructor(hash){
@@ -15,84 +19,179 @@ export class BlockProposalHash extends Buffer32 {
15
19
  }
16
20
  }
17
21
  /**
18
- * BlockProposal
19
- *
20
- * A block proposal is created by the leader of the chain proposing a sequence of transactions to
21
- * be included in the head of the chain
22
+ * A block proposal is created by the leader of the chain proposing a sequence of transactions
23
+ * to be included in a block within a checkpoint. This is used for non-last blocks in a slot.
24
+ * The last block is sent as part of a CheckpointProposal.
22
25
  */ export class BlockProposal extends Gossipable {
23
- payload;
24
- signature;
26
+ blockHeader;
27
+ indexWithinCheckpoint;
28
+ inHash;
29
+ archiveRoot;
25
30
  txHashes;
26
- txs;
31
+ signature;
32
+ signedTxs;
27
33
  static p2pTopic = TopicType.block_proposal;
28
34
  sender;
29
- constructor(/** The payload of the message, and what the signature is over */ payload, /** The signer of the BlockProposal over the header of the new block*/ signature, /** The sequence of transactions in the block */ txHashes, // Note(md): this is placed after the txs payload in order to be backwards compatible with previous versions
30
- /** The transactions in the block */ txs){
31
- super(), this.payload = payload, this.signature = signature, this.txHashes = txHashes, this.txs = txs;
35
+ constructor(/** The per-block header containing block state and global variables */ blockHeader, /** Index of this block within the checkpoint (0-indexed) */ indexWithinCheckpoint, /** Hash of L1 to L2 messages for this checkpoint (constant across all blocks in checkpoint) */ inHash, /** Archive root after this block is applied */ archiveRoot, /** The sequence of transactions in the block */ txHashes, /** The proposer's signature over the block data */ signature, /** The signed transactions in the block (optional, for DA guarantees) */ signedTxs){
36
+ super(), this.blockHeader = blockHeader, this.indexWithinCheckpoint = indexWithinCheckpoint, this.inHash = inHash, this.archiveRoot = archiveRoot, this.txHashes = txHashes, this.signature = signature, this.signedTxs = signedTxs;
32
37
  }
33
38
  generateP2PMessageIdentifier() {
34
39
  return Promise.resolve(new BlockProposalHash(keccak256(this.signature.toBuffer())));
35
40
  }
36
41
  get archive() {
37
- return this.payload.archive;
42
+ return this.archiveRoot;
38
43
  }
39
44
  get slotNumber() {
40
- return this.payload.header.slotNumber;
45
+ return this.blockHeader.getSlot();
46
+ }
47
+ get blockNumber() {
48
+ return this.blockHeader.getBlockNumber();
49
+ }
50
+ /** Convenience getter for txs from signedTxs */ get txs() {
51
+ return this.signedTxs?.txs;
41
52
  }
42
53
  toBlockInfo() {
43
54
  return {
44
55
  slotNumber: this.slotNumber,
45
- lastArchive: this.payload.header.lastArchiveRoot,
46
- timestamp: this.payload.header.timestamp,
47
- archive: this.archive,
56
+ lastArchive: this.blockHeader.lastArchive.root,
57
+ timestamp: this.blockHeader.globalVariables.timestamp,
58
+ archive: this.archiveRoot,
48
59
  txCount: this.txHashes.length
49
60
  };
50
61
  }
51
- static async createProposalFromSigner(payload, txHashes, // Note(md): Provided separately to tx hashes such that this function can be optional
52
- txs, payloadSigner) {
53
- const hashed = getHashedSignaturePayload(payload, SignatureDomainSeparator.blockProposal);
54
- const sig = await payloadSigner(hashed);
55
- return new BlockProposal(payload, sig, txHashes, txs);
62
+ /**
63
+ * Get the payload to sign for this block proposal.
64
+ * The signature is over: blockHeader + indexWithinCheckpoint + inHash + archiveRoot + txHashes
65
+ */ getPayloadToSign(domainSeparator) {
66
+ return serializeToBuffer([
67
+ domainSeparator,
68
+ this.blockHeader,
69
+ this.indexWithinCheckpoint,
70
+ this.inHash,
71
+ this.archiveRoot,
72
+ this.txHashes.length,
73
+ this.txHashes
74
+ ]);
75
+ }
76
+ static async createProposalFromSigner(blockHeader, indexWithinCheckpoint, inHash, archiveRoot, txHashes, txs, payloadSigner) {
77
+ // Create a temporary proposal to get the payload to sign
78
+ const tempProposal = new BlockProposal(blockHeader, indexWithinCheckpoint, inHash, archiveRoot, txHashes, Signature.empty());
79
+ // Create the block signing context
80
+ const blockContext = {
81
+ slot: blockHeader.globalVariables.slotNumber,
82
+ blockNumber: blockHeader.globalVariables.blockNumber,
83
+ blockIndexWithinCheckpoint: indexWithinCheckpoint,
84
+ dutyType: DutyType.BLOCK_PROPOSAL
85
+ };
86
+ const hashed = getHashedSignaturePayload(tempProposal, SignatureDomainSeparator.blockProposal);
87
+ const sig = await payloadSigner(hashed, blockContext);
88
+ // If txs are provided, sign them as well
89
+ let signedTxs;
90
+ if (txs) {
91
+ const txsSigningContext = {
92
+ dutyType: DutyType.TXS
93
+ };
94
+ const txsSigner = (payload)=>payloadSigner(payload, txsSigningContext);
95
+ signedTxs = await SignedTxs.createFromSigner(txs, txsSigner);
96
+ }
97
+ return new BlockProposal(blockHeader, indexWithinCheckpoint, inHash, archiveRoot, txHashes, sig, signedTxs);
56
98
  }
57
- /**Get Sender
58
- * Lazily evaluate the sender of the proposal; result is cached
59
- * @returns The sender address, or undefined if signature recovery fails
99
+ /**
100
+ * Lazily evaluate the sender of the proposal; result is cached.
101
+ * If there's signedTxs, also verifies the signedTxs sender matches the block proposal sender.
102
+ * @returns The sender address, or undefined if signature recovery fails or senders don't match
60
103
  */ getSender() {
61
104
  if (!this.sender) {
62
- const hashed = getHashedSignaturePayloadEthSignedMessage(this.payload, SignatureDomainSeparator.blockProposal);
105
+ const hashed = getHashedSignaturePayloadEthSignedMessage(this, SignatureDomainSeparator.blockProposal);
106
+ const blockSender = tryRecoverAddress(hashed, this.signature);
107
+ // If there's signedTxs, verify the sender matches
108
+ if (blockSender && this.signedTxs) {
109
+ const txsSender = this.signedTxs.getSender();
110
+ if (!txsSender || !txsSender.equals(blockSender)) {
111
+ return undefined; // Sender mismatch - fail
112
+ }
113
+ }
63
114
  // Cache the sender for later use
64
- this.sender = tryRecoverAddress(hashed, this.signature);
115
+ this.sender = blockSender;
65
116
  }
66
117
  return this.sender;
67
118
  }
68
119
  getPayload() {
69
- return this.payload.getPayloadToSign(SignatureDomainSeparator.blockProposal);
120
+ return this.getPayloadToSign(SignatureDomainSeparator.blockProposal);
70
121
  }
71
122
  toBuffer() {
72
123
  const buffer = [
73
- this.payload,
124
+ this.blockHeader,
125
+ this.indexWithinCheckpoint,
126
+ this.inHash,
127
+ this.archiveRoot,
74
128
  this.signature,
75
129
  this.txHashes.length,
76
130
  this.txHashes
77
131
  ];
78
- if (this.txs) {
79
- buffer.push(this.txs.length);
80
- buffer.push(this.txs);
132
+ if (this.signedTxs) {
133
+ buffer.push(1); // hasSignedTxs = true
134
+ buffer.push(this.signedTxs.toBuffer());
135
+ } else {
136
+ buffer.push(0); // hasSignedTxs = false
81
137
  }
82
138
  return serializeToBuffer(buffer);
83
139
  }
84
140
  static fromBuffer(buf) {
85
141
  const reader = BufferReader.asReader(buf);
86
- const payload = reader.readObject(ConsensusPayload);
87
- const sig = reader.readObject(Signature);
88
- const txHashes = reader.readArray(reader.readNumber(), TxHash);
142
+ const blockHeader = reader.readObject(BlockHeader);
143
+ const indexWithinCheckpoint = IndexWithinCheckpoint(reader.readNumber());
144
+ const inHash = reader.readObject(Fr);
145
+ const archiveRoot = reader.readObject(Fr);
146
+ const signature = reader.readObject(Signature);
147
+ const txHashCount = reader.readNumber();
148
+ if (txHashCount > MAX_TXS_PER_BLOCK) {
149
+ throw new Error(`txHashes count ${txHashCount} exceeds maximum ${MAX_TXS_PER_BLOCK}`);
150
+ }
151
+ const txHashes = reader.readArray(txHashCount, TxHash);
89
152
  if (!reader.isEmpty()) {
90
- const txs = reader.readArray(reader.readNumber(), Tx);
91
- return new BlockProposal(payload, sig, txHashes, txs);
153
+ const hasSignedTxs = reader.readNumber();
154
+ if (hasSignedTxs) {
155
+ const signedTxs = SignedTxs.fromBuffer(reader);
156
+ return new BlockProposal(blockHeader, indexWithinCheckpoint, inHash, archiveRoot, txHashes, signature, signedTxs);
157
+ }
92
158
  }
93
- return new BlockProposal(payload, sig, txHashes);
159
+ return new BlockProposal(blockHeader, indexWithinCheckpoint, inHash, archiveRoot, txHashes, signature);
94
160
  }
95
161
  getSize() {
96
- return this.payload.getSize() + this.signature.getSize() + 4 /* txHashes.length */ + this.txHashes.length * TxHash.SIZE + (this.txs ? 4 /* txs.length */ + this.txs.reduce((acc, tx)=>acc + tx.getSize(), 0) : 0);
162
+ return this.blockHeader.getSize() + 4 /* indexWithinCheckpoint */ + this.inHash.size + this.archiveRoot.size + this.signature.getSize() + 4 /* txHashes.length */ + this.txHashes.length * TxHash.SIZE + 4 /* hasSignedTxs flag */ + (this.signedTxs ? this.signedTxs.getSize() : 0);
163
+ }
164
+ static empty() {
165
+ return new BlockProposal(BlockHeader.empty(), IndexWithinCheckpoint(0), Fr.ZERO, Fr.ZERO, [], Signature.empty());
166
+ }
167
+ static random() {
168
+ return new BlockProposal(BlockHeader.random(), IndexWithinCheckpoint(Math.floor(Math.random() * 5)), Fr.random(), Fr.random(), [
169
+ TxHash.random(),
170
+ TxHash.random()
171
+ ], Signature.random());
172
+ }
173
+ toInspect() {
174
+ return {
175
+ blockHeader: this.blockHeader.toInspect(),
176
+ indexWithinCheckpoint: this.indexWithinCheckpoint,
177
+ inHash: this.inHash.toString(),
178
+ archiveRoot: this.archiveRoot.toString(),
179
+ signature: this.signature.toString(),
180
+ txHashes: this.txHashes.map((h)=>h.toString())
181
+ };
182
+ }
183
+ /**
184
+ * Check if this proposal matches the given block.
185
+ * Compares the archive root and block header.
186
+ * @param block - The L2Block to compare against
187
+ * @returns True if the proposal matches the block
188
+ */ matchesBlock(block) {
189
+ return this.archiveRoot.equals(block.archive.root) && this.blockHeader.equals(block.header);
190
+ }
191
+ /**
192
+ * Returns a copy of this proposal without signedTxs.
193
+ * Used when storing proposals in attestation pool to avoid storing full tx data.
194
+ */ withoutSignedTxs() {
195
+ return new BlockProposal(this.blockHeader, this.indexWithinCheckpoint, this.inHash, this.archiveRoot, this.txHashes, this.signature);
97
196
  }
98
197
  }