@aztec/stdlib 0.0.1-commit.6230efd → 0.0.1-commit.64b6bbb

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 (634) hide show
  1. package/dest/abi/contract_artifact.d.ts +2 -2
  2. package/dest/abi/contract_artifact.d.ts.map +1 -1
  3. package/dest/abi/contract_artifact.js +1 -1
  4. package/dest/abi/function_call.d.ts +47 -9
  5. package/dest/abi/function_call.d.ts.map +1 -1
  6. package/dest/abi/function_call.js +20 -3
  7. package/dest/abi/selector.js +3 -1
  8. package/dest/abi/utils.d.ts +7 -1
  9. package/dest/abi/utils.d.ts.map +1 -1
  10. package/dest/abi/utils.js +7 -0
  11. package/dest/auth_witness/auth_witness.d.ts +2 -1
  12. package/dest/auth_witness/auth_witness.d.ts.map +1 -1
  13. package/dest/avm/avm.d.ts +62 -62
  14. package/dest/avm/avm_accumulated_data.d.ts +30 -3
  15. package/dest/avm/avm_accumulated_data.d.ts.map +1 -1
  16. package/dest/avm/avm_accumulated_data.js +5 -2
  17. package/dest/avm/avm_circuit_public_inputs.d.ts +9 -9
  18. package/dest/avm/avm_circuit_public_inputs.js +3 -1
  19. package/dest/avm/avm_proving_request.d.ts +299 -299
  20. package/dest/avm/contract_storage_read.d.ts +13 -1
  21. package/dest/avm/contract_storage_read.d.ts.map +1 -1
  22. package/dest/avm/contract_storage_update_request.d.ts +13 -1
  23. package/dest/avm/contract_storage_update_request.d.ts.map +1 -1
  24. package/dest/avm/public_call_stack_item_compressed.d.ts +3 -1
  25. package/dest/avm/public_call_stack_item_compressed.d.ts.map +1 -1
  26. package/dest/avm/public_data_read.d.ts +10 -1
  27. package/dest/avm/public_data_read.d.ts.map +1 -1
  28. package/dest/avm/public_data_update_request.d.ts +10 -1
  29. package/dest/avm/public_data_update_request.d.ts.map +1 -1
  30. package/dest/avm/public_data_update_request.js +3 -1
  31. package/dest/avm/public_data_write.d.ts +7 -1
  32. package/dest/avm/public_data_write.d.ts.map +1 -1
  33. package/dest/avm/public_inner_call_request.d.ts +4 -1
  34. package/dest/avm/public_inner_call_request.d.ts.map +1 -1
  35. package/dest/avm/public_inner_call_request.js +3 -1
  36. package/dest/avm/revert_code.d.ts +4 -4
  37. package/dest/avm/revert_code.d.ts.map +1 -1
  38. package/dest/avm/revert_code.js +3 -1
  39. package/dest/aztec-address/index.js +4 -2
  40. package/dest/block/attestation_info.d.ts +5 -5
  41. package/dest/block/attestation_info.d.ts.map +1 -1
  42. package/dest/block/attestation_info.js +4 -4
  43. package/dest/block/block_hash.d.ts +18 -14
  44. package/dest/block/block_hash.d.ts.map +1 -1
  45. package/dest/block/block_hash.js +22 -20
  46. package/dest/block/block_parameter.d.ts +4 -3
  47. package/dest/block/block_parameter.d.ts.map +1 -1
  48. package/dest/block/block_parameter.js +2 -0
  49. package/dest/block/body.d.ts +1 -1
  50. package/dest/block/body.d.ts.map +1 -1
  51. package/dest/block/body.js +5 -2
  52. package/dest/block/checkpointed_l2_block.d.ts +20 -137
  53. package/dest/block/checkpointed_l2_block.d.ts.map +1 -1
  54. package/dest/block/checkpointed_l2_block.js +7 -45
  55. package/dest/block/in_block.d.ts +9 -9
  56. package/dest/block/in_block.d.ts.map +1 -1
  57. package/dest/block/in_block.js +5 -5
  58. package/dest/block/index.d.ts +1 -3
  59. package/dest/block/index.d.ts.map +1 -1
  60. package/dest/block/index.js +0 -2
  61. package/dest/block/l2_block.d.ts +57 -57
  62. package/dest/block/l2_block.d.ts.map +1 -1
  63. package/dest/block/l2_block.js +64 -108
  64. package/dest/block/l2_block_source.d.ts +298 -68
  65. package/dest/block/l2_block_source.d.ts.map +1 -1
  66. package/dest/block/l2_block_source.js +25 -6
  67. package/dest/block/l2_block_stream/index.d.ts +2 -1
  68. package/dest/block/l2_block_stream/index.d.ts.map +1 -1
  69. package/dest/block/l2_block_stream/index.js +1 -0
  70. package/dest/block/l2_block_stream/interfaces.d.ts +15 -5
  71. package/dest/block/l2_block_stream/interfaces.d.ts.map +1 -1
  72. package/dest/block/l2_block_stream/l2_block_stream.d.ts +8 -3
  73. package/dest/block/l2_block_stream/l2_block_stream.d.ts.map +1 -1
  74. package/dest/block/l2_block_stream/l2_block_stream.js +106 -31
  75. package/dest/block/l2_block_stream/l2_tips_memory_store.d.ts +24 -16
  76. package/dest/block/l2_block_stream/l2_tips_memory_store.d.ts.map +1 -1
  77. package/dest/block/l2_block_stream/l2_tips_memory_store.js +55 -61
  78. package/dest/block/l2_block_stream/l2_tips_store_base.d.ts +49 -0
  79. package/dest/block/l2_block_stream/l2_tips_store_base.d.ts.map +1 -0
  80. package/dest/block/l2_block_stream/l2_tips_store_base.js +179 -0
  81. package/dest/block/test/l2_tips_store_test_suite.d.ts +1 -1
  82. package/dest/block/test/l2_tips_store_test_suite.d.ts.map +1 -1
  83. package/dest/block/test/l2_tips_store_test_suite.js +478 -38
  84. package/dest/block/validate_block_result.d.ts +24 -24
  85. package/dest/block/validate_block_result.d.ts.map +1 -1
  86. package/dest/block/validate_block_result.js +18 -17
  87. package/dest/checkpoint/checkpoint.d.ts +30 -20
  88. package/dest/checkpoint/checkpoint.d.ts.map +1 -1
  89. package/dest/checkpoint/checkpoint.js +19 -6
  90. package/dest/checkpoint/checkpoint_info.d.ts +32 -3
  91. package/dest/checkpoint/checkpoint_info.d.ts.map +1 -1
  92. package/dest/checkpoint/checkpoint_info.js +34 -1
  93. package/dest/checkpoint/index.d.ts +2 -1
  94. package/dest/checkpoint/index.d.ts.map +1 -1
  95. package/dest/checkpoint/index.js +1 -0
  96. package/dest/checkpoint/published_checkpoint.d.ts +17 -15
  97. package/dest/checkpoint/published_checkpoint.d.ts.map +1 -1
  98. package/dest/checkpoint/published_checkpoint.js +4 -3
  99. package/dest/config/index.d.ts +2 -1
  100. package/dest/config/index.d.ts.map +1 -1
  101. package/dest/config/index.js +1 -0
  102. package/dest/config/node-rpc-config.js +1 -1
  103. package/dest/config/sequencer-config.d.ts +10 -0
  104. package/dest/config/sequencer-config.d.ts.map +1 -0
  105. package/dest/config/sequencer-config.js +12 -0
  106. package/dest/contract/complete_address.d.ts +4 -1
  107. package/dest/contract/complete_address.d.ts.map +1 -1
  108. package/dest/contract/contract_address.js +1 -1
  109. package/dest/contract/contract_class_id.d.ts +1 -1
  110. package/dest/contract/contract_class_id.js +1 -1
  111. package/dest/contract/contract_deployment_data.d.ts +5 -5
  112. package/dest/contract/index.d.ts +1 -3
  113. package/dest/contract/index.d.ts.map +1 -1
  114. package/dest/contract/index.js +0 -2
  115. package/dest/contract/interfaces/contract_instance.d.ts +16 -16
  116. package/dest/contract/private_function.d.ts +1 -1
  117. package/dest/contract/private_function.d.ts.map +1 -1
  118. package/dest/contract/private_function.js +2 -3
  119. package/dest/contract/private_function_membership_proof.d.ts +1 -1
  120. package/dest/contract/private_function_membership_proof.js +1 -1
  121. package/dest/database-version/database_version.d.ts +58 -0
  122. package/dest/database-version/database_version.d.ts.map +1 -0
  123. package/dest/database-version/database_version.js +69 -0
  124. package/dest/database-version/version_manager.d.ts +3 -49
  125. package/dest/database-version/version_manager.d.ts.map +1 -1
  126. package/dest/database-version/version_manager.js +1 -64
  127. package/dest/delayed_public_mutable/delayed_public_mutable_values.d.ts +2 -2
  128. package/dest/delayed_public_mutable/delayed_public_mutable_values.d.ts.map +1 -1
  129. package/dest/delayed_public_mutable/delayed_public_mutable_values.js +7 -10
  130. package/dest/deserialization/index.d.ts +11 -0
  131. package/dest/deserialization/index.d.ts.map +1 -0
  132. package/dest/deserialization/index.js +10 -0
  133. package/dest/epoch-helpers/index.d.ts +7 -1
  134. package/dest/epoch-helpers/index.d.ts.map +1 -1
  135. package/dest/epoch-helpers/index.js +9 -3
  136. package/dest/errors/proving_error.d.ts +2 -2
  137. package/dest/errors/proving_error.d.ts.map +1 -1
  138. package/dest/gas/gas.js +3 -1
  139. package/dest/gas/gas_fees.js +3 -1
  140. package/dest/hash/hash.js +2 -2
  141. package/dest/hash/map_slot.d.ts +1 -1
  142. package/dest/hash/map_slot.d.ts.map +1 -1
  143. package/dest/hash/map_slot.js +4 -3
  144. package/dest/interfaces/api_limit.d.ts +3 -1
  145. package/dest/interfaces/api_limit.d.ts.map +1 -1
  146. package/dest/interfaces/api_limit.js +2 -0
  147. package/dest/interfaces/archiver.d.ts +6 -6
  148. package/dest/interfaces/archiver.d.ts.map +1 -1
  149. package/dest/interfaces/archiver.js +22 -17
  150. package/dest/interfaces/aztec-node-admin.d.ts +82 -31
  151. package/dest/interfaces/aztec-node-admin.d.ts.map +1 -1
  152. package/dest/interfaces/aztec-node-admin.js +5 -3
  153. package/dest/interfaces/aztec-node.d.ts +74 -76
  154. package/dest/interfaces/aztec-node.d.ts.map +1 -1
  155. package/dest/interfaces/aztec-node.js +15 -16
  156. package/dest/interfaces/block-builder.d.ts +22 -14
  157. package/dest/interfaces/block-builder.d.ts.map +1 -1
  158. package/dest/interfaces/block-builder.js +7 -0
  159. package/dest/interfaces/configs.d.ts +12 -7
  160. package/dest/interfaces/configs.d.ts.map +1 -1
  161. package/dest/interfaces/configs.js +2 -1
  162. package/dest/interfaces/get_logs_response.d.ts +16 -9
  163. package/dest/interfaces/get_logs_response.d.ts.map +1 -1
  164. package/dest/interfaces/l2_logs_source.d.ts +14 -5
  165. package/dest/interfaces/l2_logs_source.d.ts.map +1 -1
  166. package/dest/interfaces/p2p.d.ts +7 -9
  167. package/dest/interfaces/p2p.d.ts.map +1 -1
  168. package/dest/interfaces/p2p.js +3 -4
  169. package/dest/interfaces/prover-broker.d.ts +16 -1
  170. package/dest/interfaces/prover-broker.d.ts.map +1 -1
  171. package/dest/interfaces/prover-broker.js +4 -1
  172. package/dest/interfaces/prover-client.d.ts +15 -1
  173. package/dest/interfaces/prover-client.d.ts.map +1 -1
  174. package/dest/interfaces/prover-client.js +12 -1
  175. package/dest/interfaces/proving-job.d.ts +52 -52
  176. package/dest/interfaces/proving-job.d.ts.map +1 -1
  177. package/dest/interfaces/proving-job.js +1 -7
  178. package/dest/interfaces/server_circuit_prover.d.ts +4 -3
  179. package/dest/interfaces/server_circuit_prover.d.ts.map +1 -1
  180. package/dest/interfaces/slasher.d.ts +9 -1
  181. package/dest/interfaces/slasher.d.ts.map +1 -1
  182. package/dest/interfaces/slasher.js +2 -0
  183. package/dest/interfaces/tx_provider.d.ts +3 -3
  184. package/dest/interfaces/tx_provider.d.ts.map +1 -1
  185. package/dest/interfaces/validator.d.ts +155 -19
  186. package/dest/interfaces/validator.d.ts.map +1 -1
  187. package/dest/interfaces/validator.js +8 -3
  188. package/dest/kernel/claimed_length_array.js +3 -1
  189. package/dest/kernel/hints/build_note_hash_read_request_hints.d.ts +6 -5
  190. package/dest/kernel/hints/build_note_hash_read_request_hints.d.ts.map +1 -1
  191. package/dest/kernel/hints/build_note_hash_read_request_hints.js +19 -10
  192. package/dest/kernel/hints/build_nullifier_read_request_hints.d.ts +3 -3
  193. package/dest/kernel/hints/build_nullifier_read_request_hints.d.ts.map +1 -1
  194. package/dest/kernel/hints/build_nullifier_read_request_hints.js +16 -8
  195. package/dest/kernel/hints/key_validation_hint.d.ts +2 -1
  196. package/dest/kernel/hints/key_validation_hint.d.ts.map +1 -1
  197. package/dest/kernel/hints/key_validation_request.d.ts +2 -1
  198. package/dest/kernel/hints/key_validation_request.d.ts.map +1 -1
  199. package/dest/kernel/hints/key_validation_request_and_generator.d.ts +6 -1
  200. package/dest/kernel/hints/key_validation_request_and_generator.d.ts.map +1 -1
  201. package/dest/kernel/hints/private_kernel_reset_hints.d.ts +13 -1
  202. package/dest/kernel/hints/private_kernel_reset_hints.d.ts.map +1 -1
  203. package/dest/kernel/hints/read_request.d.ts +7 -1
  204. package/dest/kernel/hints/read_request.d.ts.map +1 -1
  205. package/dest/kernel/hints/read_request_hints.d.ts +7 -1
  206. package/dest/kernel/hints/read_request_hints.d.ts.map +1 -1
  207. package/dest/kernel/hints/transient_data_squashing_hint.js +3 -1
  208. package/dest/kernel/log_hash.js +3 -1
  209. package/dest/kernel/private_accumulated_data.d.ts +23 -1
  210. package/dest/kernel/private_accumulated_data.d.ts.map +1 -1
  211. package/dest/kernel/private_call_data.d.ts +25 -1
  212. package/dest/kernel/private_call_data.d.ts.map +1 -1
  213. package/dest/kernel/private_call_request.d.ts +16 -1
  214. package/dest/kernel/private_call_request.d.ts.map +1 -1
  215. package/dest/kernel/private_circuit_public_inputs.d.ts +74 -1
  216. package/dest/kernel/private_circuit_public_inputs.d.ts.map +1 -1
  217. package/dest/kernel/private_kernel_circuit_public_inputs.d.ts +31 -1
  218. package/dest/kernel/private_kernel_circuit_public_inputs.d.ts.map +1 -1
  219. package/dest/kernel/private_kernel_data.d.ts +7 -1
  220. package/dest/kernel/private_kernel_data.d.ts.map +1 -1
  221. package/dest/kernel/private_kernel_init_circuit_private_inputs.d.ts +22 -1
  222. package/dest/kernel/private_kernel_init_circuit_private_inputs.d.ts.map +1 -1
  223. package/dest/kernel/private_kernel_inner_circuit_private_inputs.d.ts +7 -1
  224. package/dest/kernel/private_kernel_inner_circuit_private_inputs.d.ts.map +1 -1
  225. package/dest/kernel/private_kernel_reset_circuit_private_inputs.d.ts +4 -1
  226. package/dest/kernel/private_kernel_reset_circuit_private_inputs.d.ts.map +1 -1
  227. package/dest/kernel/private_kernel_tail_circuit_private_inputs.d.ts +10 -1
  228. package/dest/kernel/private_kernel_tail_circuit_private_inputs.d.ts.map +1 -1
  229. package/dest/kernel/private_kernel_tail_circuit_public_inputs.d.ts +23 -1
  230. package/dest/kernel/private_kernel_tail_circuit_public_inputs.d.ts.map +1 -1
  231. package/dest/kernel/private_log_data.js +5 -2
  232. package/dest/kernel/private_to_avm_accumulated_data.d.ts +2 -2
  233. package/dest/kernel/private_to_avm_accumulated_data.js +5 -2
  234. package/dest/kernel/private_to_public_accumulated_data.js +3 -1
  235. package/dest/kernel/private_to_rollup_accumulated_data.d.ts +17 -1
  236. package/dest/kernel/private_to_rollup_accumulated_data.d.ts.map +1 -1
  237. package/dest/kernel/private_to_rollup_accumulated_data.js +3 -1
  238. package/dest/kernel/private_to_rollup_kernel_circuit_public_inputs.d.ts +16 -1
  239. package/dest/kernel/private_to_rollup_kernel_circuit_public_inputs.d.ts.map +1 -1
  240. package/dest/kernel/private_validation_requests.d.ts +10 -1
  241. package/dest/kernel/private_validation_requests.d.ts.map +1 -1
  242. package/dest/kernel/private_validation_requests.js +3 -1
  243. package/dest/kernel/public_call_request.d.ts +22 -1
  244. package/dest/kernel/public_call_request.d.ts.map +1 -1
  245. package/dest/kernel/public_call_request.js +5 -2
  246. package/dest/kernel/utils/optional_number.d.ts +7 -1
  247. package/dest/kernel/utils/optional_number.d.ts.map +1 -1
  248. package/dest/keys/derivation.d.ts +3 -3
  249. package/dest/keys/derivation.js +8 -8
  250. package/dest/keys/key_types.d.ts +1 -1
  251. package/dest/keys/public_keys.d.ts +5 -1
  252. package/dest/keys/public_keys.d.ts.map +1 -1
  253. package/dest/keys/utils.d.ts +1 -1
  254. package/dest/keys/utils.d.ts.map +1 -1
  255. package/dest/keys/utils.js +7 -3
  256. package/dest/l1-contracts/slash_factory.d.ts +1 -1
  257. package/dest/l1-contracts/slash_factory.d.ts.map +1 -1
  258. package/dest/l1-contracts/slash_factory.js +1 -0
  259. package/dest/logs/contract_class_log.js +3 -1
  260. package/dest/logs/extended_contract_class_log.d.ts +3 -1
  261. package/dest/logs/extended_contract_class_log.d.ts.map +1 -1
  262. package/dest/logs/extended_public_log.d.ts +17 -9
  263. package/dest/logs/extended_public_log.d.ts.map +1 -1
  264. package/dest/logs/log_id.d.ts +21 -14
  265. package/dest/logs/log_id.d.ts.map +1 -1
  266. package/dest/logs/log_id.js +20 -17
  267. package/dest/logs/private_log.js +3 -1
  268. package/dest/logs/public_log.js +3 -1
  269. package/dest/logs/siloed_tag.d.ts +1 -1
  270. package/dest/logs/siloed_tag.d.ts.map +1 -1
  271. package/dest/logs/siloed_tag.js +4 -3
  272. package/dest/messaging/in_hash.d.ts +4 -2
  273. package/dest/messaging/in_hash.d.ts.map +1 -1
  274. package/dest/messaging/in_hash.js +3 -1
  275. package/dest/messaging/inbox_leaf.d.ts +3 -1
  276. package/dest/messaging/inbox_leaf.d.ts.map +1 -1
  277. package/dest/messaging/l1_actor.d.ts +7 -1
  278. package/dest/messaging/l1_actor.d.ts.map +1 -1
  279. package/dest/messaging/l1_to_l2_message.d.ts +6 -1
  280. package/dest/messaging/l1_to_l2_message.d.ts.map +1 -1
  281. package/dest/messaging/l2_actor.d.ts +7 -1
  282. package/dest/messaging/l2_actor.d.ts.map +1 -1
  283. package/dest/messaging/l2_to_l1_membership.d.ts +88 -6
  284. package/dest/messaging/l2_to_l1_membership.d.ts.map +1 -1
  285. package/dest/messaging/l2_to_l1_membership.js +160 -42
  286. package/dest/messaging/out_hash.d.ts +41 -3
  287. package/dest/messaging/out_hash.d.ts.map +1 -1
  288. package/dest/messaging/out_hash.js +54 -19
  289. package/dest/note/note_dao.d.ts +36 -5
  290. package/dest/note/note_dao.d.ts.map +1 -1
  291. package/dest/note/note_dao.js +15 -12
  292. package/dest/p2p/attestation_utils.d.ts +3 -3
  293. package/dest/p2p/attestation_utils.d.ts.map +1 -1
  294. package/dest/p2p/attestation_utils.js +1 -1
  295. package/dest/p2p/block_proposal.d.ts +102 -23
  296. package/dest/p2p/block_proposal.d.ts.map +1 -1
  297. package/dest/p2p/block_proposal.js +140 -39
  298. package/dest/p2p/checkpoint_attestation.d.ts +81 -0
  299. package/dest/p2p/checkpoint_attestation.d.ts.map +1 -0
  300. package/dest/p2p/{block_attestation.js → checkpoint_attestation.js} +22 -19
  301. package/dest/p2p/checkpoint_proposal.d.ts +174 -0
  302. package/dest/p2p/checkpoint_proposal.d.ts.map +1 -0
  303. package/dest/p2p/checkpoint_proposal.js +238 -0
  304. package/dest/p2p/consensus_payload.d.ts +9 -9
  305. package/dest/p2p/consensus_payload.d.ts.map +1 -1
  306. package/dest/p2p/consensus_payload.js +3 -5
  307. package/dest/p2p/constants.d.ts +5 -0
  308. package/dest/p2p/constants.d.ts.map +1 -0
  309. package/dest/p2p/constants.js +3 -0
  310. package/dest/p2p/gossipable.d.ts +4 -3
  311. package/dest/p2p/gossipable.d.ts.map +1 -1
  312. package/dest/p2p/gossipable.js +16 -5
  313. package/dest/p2p/index.d.ts +5 -2
  314. package/dest/p2p/index.d.ts.map +1 -1
  315. package/dest/p2p/index.js +4 -1
  316. package/dest/p2p/message_validator.d.ts +18 -3
  317. package/dest/p2p/message_validator.d.ts.map +1 -1
  318. package/dest/p2p/message_validator.js +2 -1
  319. package/dest/p2p/signature_utils.d.ts +5 -3
  320. package/dest/p2p/signature_utils.d.ts.map +1 -1
  321. package/dest/p2p/signature_utils.js +3 -1
  322. package/dest/p2p/signed_txs.d.ts +42 -0
  323. package/dest/p2p/signed_txs.d.ts.map +1 -0
  324. package/dest/p2p/signed_txs.js +75 -0
  325. package/dest/p2p/topic_type.d.ts +3 -2
  326. package/dest/p2p/topic_type.d.ts.map +1 -1
  327. package/dest/p2p/topic_type.js +10 -3
  328. package/dest/parity/parity_base_private_inputs.d.ts +3 -1
  329. package/dest/parity/parity_base_private_inputs.d.ts.map +1 -1
  330. package/dest/parity/parity_public_inputs.d.ts +4 -1
  331. package/dest/parity/parity_public_inputs.d.ts.map +1 -1
  332. package/dest/parity/parity_root_private_inputs.d.ts +2 -1
  333. package/dest/parity/parity_root_private_inputs.d.ts.map +1 -1
  334. package/dest/proofs/chonk_proof.d.ts +1 -1
  335. package/dest/proofs/chonk_proof.d.ts.map +1 -1
  336. package/dest/proofs/chonk_proof.js +9 -4
  337. package/dest/proofs/proof.d.ts +4 -1
  338. package/dest/proofs/proof.d.ts.map +1 -1
  339. package/dest/proofs/recursive_proof.d.ts +10 -1
  340. package/dest/proofs/recursive_proof.d.ts.map +1 -1
  341. package/dest/rollup/base_rollup_hints.d.ts +34 -1
  342. package/dest/rollup/base_rollup_hints.d.ts.map +1 -1
  343. package/dest/rollup/block_constant_data.d.ts +12 -1
  344. package/dest/rollup/block_constant_data.d.ts.map +1 -1
  345. package/dest/rollup/block_headers_hash.js +1 -1
  346. package/dest/rollup/block_merge_rollup_private_inputs.d.ts +4 -1
  347. package/dest/rollup/block_merge_rollup_private_inputs.d.ts.map +1 -1
  348. package/dest/rollup/block_rollup_public_inputs.d.ts +47 -11
  349. package/dest/rollup/block_rollup_public_inputs.d.ts.map +1 -1
  350. package/dest/rollup/block_rollup_public_inputs.js +8 -12
  351. package/dest/rollup/block_root_rollup_private_inputs.d.ts +64 -1
  352. package/dest/rollup/block_root_rollup_private_inputs.d.ts.map +1 -1
  353. package/dest/rollup/checkpoint_constant_data.d.ts +10 -1
  354. package/dest/rollup/checkpoint_constant_data.d.ts.map +1 -1
  355. package/dest/rollup/checkpoint_constant_data.js +3 -1
  356. package/dest/rollup/checkpoint_header.d.ts +42 -12
  357. package/dest/rollup/checkpoint_header.d.ts.map +1 -1
  358. package/dest/rollup/checkpoint_header.js +49 -19
  359. package/dest/rollup/checkpoint_merge_rollup_private_inputs.d.ts +4 -1
  360. package/dest/rollup/checkpoint_merge_rollup_private_inputs.d.ts.map +1 -1
  361. package/dest/rollup/checkpoint_rollup_public_inputs.d.ts +46 -6
  362. package/dest/rollup/checkpoint_rollup_public_inputs.d.ts.map +1 -1
  363. package/dest/rollup/checkpoint_rollup_public_inputs.js +11 -3
  364. package/dest/rollup/checkpoint_root_rollup_private_inputs.d.ts +44 -3
  365. package/dest/rollup/checkpoint_root_rollup_private_inputs.d.ts.map +1 -1
  366. package/dest/rollup/checkpoint_root_rollup_private_inputs.js +13 -2
  367. package/dest/rollup/epoch_constant_data.d.ts +16 -1
  368. package/dest/rollup/epoch_constant_data.d.ts.map +1 -1
  369. package/dest/rollup/root_rollup_private_inputs.d.ts +6 -1
  370. package/dest/rollup/root_rollup_private_inputs.d.ts.map +1 -1
  371. package/dest/rollup/root_rollup_public_inputs.d.ts +21 -6
  372. package/dest/rollup/root_rollup_public_inputs.d.ts.map +1 -1
  373. package/dest/rollup/root_rollup_public_inputs.js +10 -4
  374. package/dest/rollup/tree_snapshot_diff_hints.d.ts +24 -1
  375. package/dest/rollup/tree_snapshot_diff_hints.d.ts.map +1 -1
  376. package/dest/rollup/tx_merge_rollup_private_inputs.d.ts +4 -1
  377. package/dest/rollup/tx_merge_rollup_private_inputs.d.ts.map +1 -1
  378. package/dest/rollup/tx_rollup_public_inputs.d.ts +29 -1
  379. package/dest/rollup/tx_rollup_public_inputs.d.ts.map +1 -1
  380. package/dest/schemas/schemas.d.ts +1 -1
  381. package/dest/slashing/empire.d.ts +1 -1
  382. package/dest/slashing/empire.d.ts.map +1 -1
  383. package/dest/slashing/empire.js +2 -0
  384. package/dest/slashing/helpers.d.ts +2 -2
  385. package/dest/slashing/helpers.d.ts.map +1 -1
  386. package/dest/slashing/helpers.js +6 -0
  387. package/dest/slashing/tally.d.ts +2 -1
  388. package/dest/slashing/tally.d.ts.map +1 -1
  389. package/dest/slashing/tally.js +6 -2
  390. package/dest/slashing/types.d.ts +7 -3
  391. package/dest/slashing/types.d.ts.map +1 -1
  392. package/dest/slashing/types.js +13 -1
  393. package/dest/stats/stats.d.ts +1 -3
  394. package/dest/stats/stats.d.ts.map +1 -1
  395. package/dest/tests/factories.d.ts +16 -10
  396. package/dest/tests/factories.d.ts.map +1 -1
  397. package/dest/tests/factories.js +61 -26
  398. package/dest/tests/jest.js +1 -1
  399. package/dest/tests/mocks.d.ts +74 -19
  400. package/dest/tests/mocks.d.ts.map +1 -1
  401. package/dest/tests/mocks.js +123 -57
  402. package/dest/timetable/index.d.ts +37 -0
  403. package/dest/timetable/index.d.ts.map +1 -0
  404. package/dest/timetable/index.js +39 -0
  405. package/dest/trees/append_only_tree_snapshot.d.ts +13 -1
  406. package/dest/trees/append_only_tree_snapshot.d.ts.map +1 -1
  407. package/dest/trees/append_only_tree_snapshot.js +3 -1
  408. package/dest/trees/nullifier_leaf.d.ts +13 -1
  409. package/dest/trees/nullifier_leaf.d.ts.map +1 -1
  410. package/dest/trees/nullifier_membership_witness.d.ts +10 -1
  411. package/dest/trees/nullifier_membership_witness.d.ts.map +1 -1
  412. package/dest/trees/public_data_leaf.d.ts +17 -1
  413. package/dest/trees/public_data_leaf.d.ts.map +1 -1
  414. package/dest/trees/public_data_leaf.js +7 -6
  415. package/dest/trees/public_data_witness.d.ts +11 -1
  416. package/dest/trees/public_data_witness.d.ts.map +1 -1
  417. package/dest/tx/block_header.d.ts +14 -2
  418. package/dest/tx/block_header.d.ts.map +1 -1
  419. package/dest/tx/block_header.js +8 -2
  420. package/dest/tx/call_context.d.ts +13 -1
  421. package/dest/tx/call_context.d.ts.map +1 -1
  422. package/dest/tx/call_context.js +3 -1
  423. package/dest/tx/capsule.d.ts +4 -1
  424. package/dest/tx/capsule.d.ts.map +1 -1
  425. package/dest/tx/execution_payload.d.ts +9 -1
  426. package/dest/tx/execution_payload.d.ts.map +1 -1
  427. package/dest/tx/function_data.d.ts +4 -2
  428. package/dest/tx/function_data.d.ts.map +1 -1
  429. package/dest/tx/global_variable_builder.d.ts +2 -2
  430. package/dest/tx/global_variable_builder.d.ts.map +1 -1
  431. package/dest/tx/global_variables.d.ts +9 -1
  432. package/dest/tx/global_variables.d.ts.map +1 -1
  433. package/dest/tx/global_variables.js +3 -1
  434. package/dest/tx/hashed_values.d.ts +7 -1
  435. package/dest/tx/hashed_values.d.ts.map +1 -1
  436. package/dest/tx/in_tx.d.ts +4 -4
  437. package/dest/tx/index.d.ts +1 -2
  438. package/dest/tx/index.d.ts.map +1 -1
  439. package/dest/tx/index.js +0 -1
  440. package/dest/tx/indexed_tx_effect.d.ts +5 -5
  441. package/dest/tx/indexed_tx_effect.d.ts.map +1 -1
  442. package/dest/tx/indexed_tx_effect.js +3 -2
  443. package/dest/tx/partial_state_reference.d.ts +4 -1
  444. package/dest/tx/partial_state_reference.d.ts.map +1 -1
  445. package/dest/tx/private_execution_result.d.ts +23 -6
  446. package/dest/tx/private_execution_result.d.ts.map +1 -1
  447. package/dest/tx/private_execution_result.js +4 -21
  448. package/dest/tx/private_tx_constant_data.d.ts +16 -1
  449. package/dest/tx/private_tx_constant_data.d.ts.map +1 -1
  450. package/dest/tx/profiling.d.ts +149 -26
  451. package/dest/tx/profiling.d.ts.map +1 -1
  452. package/dest/tx/profiling.js +44 -7
  453. package/dest/tx/protocol_contracts.d.ts +1 -1
  454. package/dest/tx/public_call_request_with_calldata.d.ts +7 -1
  455. package/dest/tx/public_call_request_with_calldata.d.ts.map +1 -1
  456. package/dest/tx/public_call_request_with_calldata.js +3 -1
  457. package/dest/tx/state_reference.d.ts +3 -1
  458. package/dest/tx/state_reference.d.ts.map +1 -1
  459. package/dest/tx/state_reference.js +3 -1
  460. package/dest/tx/tree_snapshots.js +3 -1
  461. package/dest/tx/tx.d.ts +24 -1
  462. package/dest/tx/tx.d.ts.map +1 -1
  463. package/dest/tx/tx.js +9 -4
  464. package/dest/tx/tx_context.d.ts +2 -1
  465. package/dest/tx/tx_context.d.ts.map +1 -1
  466. package/dest/tx/tx_effect.d.ts +32 -6
  467. package/dest/tx/tx_effect.d.ts.map +1 -1
  468. package/dest/tx/tx_effect.js +3 -8
  469. package/dest/tx/tx_execution_request.d.ts +30 -1
  470. package/dest/tx/tx_execution_request.d.ts.map +1 -1
  471. package/dest/tx/tx_execution_request.js +6 -2
  472. package/dest/tx/tx_hash.d.ts +2 -1
  473. package/dest/tx/tx_hash.d.ts.map +1 -1
  474. package/dest/tx/tx_receipt.d.ts +47 -13
  475. package/dest/tx/tx_receipt.d.ts.map +1 -1
  476. package/dest/tx/tx_receipt.js +46 -15
  477. package/dest/tx/tx_request.d.ts +6 -1
  478. package/dest/tx/tx_request.d.ts.map +1 -1
  479. package/dest/tx/validator/empty_validator.d.ts +2 -2
  480. package/dest/tx/validator/empty_validator.d.ts.map +1 -1
  481. package/dest/tx/validator/error_texts.d.ts +2 -1
  482. package/dest/tx/validator/error_texts.d.ts.map +1 -1
  483. package/dest/tx/validator/error_texts.js +2 -0
  484. package/dest/tx/validator/tx_validator.d.ts +2 -2
  485. package/dest/tx/validator/tx_validator.d.ts.map +1 -1
  486. package/dest/types/shared.d.ts +4 -1
  487. package/dest/types/shared.d.ts.map +1 -1
  488. package/dest/validators/schemas.d.ts +8 -8
  489. package/dest/vks/verification_key.d.ts +22 -1
  490. package/dest/vks/verification_key.d.ts.map +1 -1
  491. package/dest/vks/vk_data.d.ts +7 -1
  492. package/dest/vks/vk_data.d.ts.map +1 -1
  493. package/dest/zkpassport/index.d.ts +3 -4
  494. package/dest/zkpassport/index.d.ts.map +1 -1
  495. package/dest/zkpassport/index.js +9 -9
  496. package/package.json +27 -13
  497. package/src/abi/contract_artifact.ts +10 -10
  498. package/src/abi/function_call.ts +25 -3
  499. package/src/abi/utils.ts +17 -0
  500. package/src/block/attestation_info.ts +9 -6
  501. package/src/block/block_hash.ts +26 -25
  502. package/src/block/block_parameter.ts +4 -2
  503. package/src/block/body.ts +2 -1
  504. package/src/block/checkpointed_l2_block.ts +8 -58
  505. package/src/block/in_block.ts +6 -6
  506. package/src/block/index.ts +0 -2
  507. package/src/block/l2_block.ts +102 -149
  508. package/src/block/l2_block_source.ts +123 -44
  509. package/src/block/l2_block_stream/index.ts +1 -0
  510. package/src/block/l2_block_stream/interfaces.ts +15 -4
  511. package/src/block/l2_block_stream/l2_block_stream.ts +130 -39
  512. package/src/block/l2_block_stream/l2_tips_memory_store.ts +62 -56
  513. package/src/block/l2_block_stream/l2_tips_store_base.ts +226 -0
  514. package/src/block/test/l2_tips_store_test_suite.ts +480 -36
  515. package/src/block/validate_block_result.ts +40 -35
  516. package/src/checkpoint/checkpoint.ts +34 -11
  517. package/src/checkpoint/checkpoint_info.ts +45 -2
  518. package/src/checkpoint/index.ts +1 -0
  519. package/src/checkpoint/published_checkpoint.ts +4 -3
  520. package/src/config/index.ts +1 -0
  521. package/src/config/node-rpc-config.ts +1 -1
  522. package/src/config/sequencer-config.ts +19 -0
  523. package/src/contract/contract_address.ts +1 -1
  524. package/src/contract/contract_class_id.ts +1 -1
  525. package/src/contract/index.ts +0 -2
  526. package/src/contract/private_function.ts +2 -3
  527. package/src/contract/private_function_membership_proof.ts +1 -1
  528. package/src/database-version/database_version.ts +87 -0
  529. package/src/database-version/version_manager.ts +1 -77
  530. package/src/delayed_public_mutable/delayed_public_mutable_values.ts +9 -10
  531. package/src/deserialization/index.ts +21 -0
  532. package/src/epoch-helpers/index.ts +13 -1
  533. package/src/hash/hash.ts +2 -2
  534. package/src/hash/map_slot.ts +3 -2
  535. package/src/interfaces/api_limit.ts +2 -0
  536. package/src/interfaces/archiver.ts +26 -24
  537. package/src/interfaces/aztec-node-admin.ts +8 -4
  538. package/src/interfaces/aztec-node.ts +109 -128
  539. package/src/interfaces/block-builder.ts +40 -23
  540. package/src/interfaces/configs.ts +3 -0
  541. package/src/interfaces/l2_logs_source.ts +17 -4
  542. package/src/interfaces/p2p.ts +8 -12
  543. package/src/interfaces/prover-broker.ts +22 -0
  544. package/src/interfaces/prover-client.ts +22 -0
  545. package/src/interfaces/proving-job.ts +2 -11
  546. package/src/interfaces/server_circuit_prover.ts +3 -2
  547. package/src/interfaces/slasher.ts +4 -0
  548. package/src/interfaces/tx_provider.ts +2 -2
  549. package/src/interfaces/validator.ts +72 -15
  550. package/src/kernel/hints/build_note_hash_read_request_hints.ts +20 -12
  551. package/src/kernel/hints/build_nullifier_read_request_hints.ts +17 -14
  552. package/src/keys/derivation.ts +8 -8
  553. package/src/keys/key_types.ts +1 -1
  554. package/src/keys/utils.ts +7 -3
  555. package/src/l1-contracts/slash_factory.ts +1 -0
  556. package/src/logs/log_id.ts +22 -18
  557. package/src/logs/siloed_tag.ts +3 -2
  558. package/src/messaging/in_hash.ts +3 -1
  559. package/src/messaging/l2_to_l1_membership.ts +178 -52
  560. package/src/messaging/out_hash.ts +62 -21
  561. package/src/note/note_dao.ts +18 -13
  562. package/src/p2p/attestation_utils.ts +3 -3
  563. package/src/p2p/block_proposal.ts +213 -46
  564. package/src/p2p/{block_attestation.ts → checkpoint_attestation.ts} +31 -25
  565. package/src/p2p/checkpoint_proposal.ts +365 -0
  566. package/src/p2p/consensus_payload.ts +5 -7
  567. package/src/p2p/constants.ts +6 -0
  568. package/src/p2p/gossipable.ts +14 -4
  569. package/src/p2p/index.ts +4 -1
  570. package/src/p2p/message_validator.ts +14 -2
  571. package/src/p2p/signature_utils.ts +3 -1
  572. package/src/p2p/signed_txs.ts +88 -0
  573. package/src/p2p/topic_type.ts +4 -3
  574. package/src/proofs/chonk_proof.ts +9 -5
  575. package/src/rollup/block_headers_hash.ts +1 -1
  576. package/src/rollup/block_rollup_public_inputs.ts +5 -11
  577. package/src/rollup/checkpoint_header.ts +63 -20
  578. package/src/rollup/checkpoint_rollup_public_inputs.ts +17 -5
  579. package/src/rollup/checkpoint_root_rollup_private_inputs.ts +14 -1
  580. package/src/rollup/root_rollup_public_inputs.ts +16 -7
  581. package/src/slashing/empire.ts +3 -1
  582. package/src/slashing/helpers.ts +8 -0
  583. package/src/slashing/tally.ts +8 -2
  584. package/src/slashing/types.ts +14 -0
  585. package/src/stats/stats.ts +0 -2
  586. package/src/tests/factories.ts +58 -42
  587. package/src/tests/jest.ts +1 -1
  588. package/src/tests/mocks.ts +213 -91
  589. package/src/timetable/index.ts +66 -0
  590. package/src/trees/public_data_leaf.ts +11 -5
  591. package/src/tx/block_header.ts +11 -3
  592. package/src/tx/global_variable_builder.ts +1 -1
  593. package/src/tx/index.ts +0 -1
  594. package/src/tx/indexed_tx_effect.ts +3 -2
  595. package/src/tx/private_execution_result.ts +1 -16
  596. package/src/tx/profiling.ts +46 -4
  597. package/src/tx/tx.ts +10 -9
  598. package/src/tx/tx_effect.ts +0 -9
  599. package/src/tx/tx_execution_request.ts +2 -0
  600. package/src/tx/tx_receipt.ts +75 -18
  601. package/src/tx/validator/empty_validator.ts +1 -1
  602. package/src/tx/validator/error_texts.ts +3 -0
  603. package/src/tx/validator/tx_validator.ts +1 -1
  604. package/src/zkpassport/index.ts +11 -12
  605. package/dest/block/l2_block_code_to_purge.d.ts +0 -12
  606. package/dest/block/l2_block_code_to_purge.d.ts.map +0 -1
  607. package/dest/block/l2_block_code_to_purge.js +0 -61
  608. package/dest/block/l2_block_header.d.ts +0 -98
  609. package/dest/block/l2_block_header.d.ts.map +0 -1
  610. package/dest/block/l2_block_header.js +0 -153
  611. package/dest/block/l2_block_new.d.ts +0 -135
  612. package/dest/block/l2_block_new.d.ts.map +0 -1
  613. package/dest/block/l2_block_new.js +0 -152
  614. package/dest/contract/contract_class_metadata.d.ts +0 -8
  615. package/dest/contract/contract_class_metadata.d.ts.map +0 -1
  616. package/dest/contract/contract_class_metadata.js +0 -1
  617. package/dest/contract/contract_metadata.d.ts +0 -7
  618. package/dest/contract/contract_metadata.d.ts.map +0 -1
  619. package/dest/contract/contract_metadata.js +0 -1
  620. package/dest/database-version/index.d.ts +0 -2
  621. package/dest/database-version/index.d.ts.map +0 -1
  622. package/dest/database-version/index.js +0 -1
  623. package/dest/p2p/block_attestation.d.ts +0 -80
  624. package/dest/p2p/block_attestation.d.ts.map +0 -1
  625. package/dest/tx/content_commitment.d.ts +0 -49
  626. package/dest/tx/content_commitment.d.ts.map +0 -1
  627. package/dest/tx/content_commitment.js +0 -90
  628. package/src/block/l2_block_code_to_purge.ts +0 -88
  629. package/src/block/l2_block_header.ts +0 -246
  630. package/src/block/l2_block_new.ts +0 -207
  631. package/src/contract/contract_class_metadata.ts +0 -8
  632. package/src/contract/contract_metadata.ts +0 -7
  633. package/src/database-version/index.ts +0 -1
  634. package/src/tx/content_commitment.ts +0 -113
@@ -0,0 +1,365 @@
1
+ import { BlockNumber, IndexWithinCheckpoint, SlotNumber } from '@aztec/foundation/branded-types';
2
+ import { Buffer32 } from '@aztec/foundation/buffer';
3
+ import { keccak256 } from '@aztec/foundation/crypto/keccak';
4
+ import { tryRecoverAddress } from '@aztec/foundation/crypto/secp256k1-signer';
5
+ import { Fr } from '@aztec/foundation/curves/bn254';
6
+ import type { EthAddress } from '@aztec/foundation/eth-address';
7
+ import { Signature } from '@aztec/foundation/eth-signature';
8
+ import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize';
9
+ import { DutyType, type SigningContext } from '@aztec/validator-ha-signer/types';
10
+
11
+ import type { L2BlockInfo } from '../block/l2_block_info.js';
12
+ import { MAX_TXS_PER_BLOCK } from '../deserialization/index.js';
13
+ import { CheckpointHeader } from '../rollup/checkpoint_header.js';
14
+ import { BlockHeader } from '../tx/block_header.js';
15
+ import { TxHash } from '../tx/index.js';
16
+ import type { Tx } from '../tx/tx.js';
17
+ import { BlockProposal } from './block_proposal.js';
18
+ import { Gossipable } from './gossipable.js';
19
+ import {
20
+ SignatureDomainSeparator,
21
+ getHashedSignaturePayload,
22
+ getHashedSignaturePayloadEthSignedMessage,
23
+ } from './signature_utils.js';
24
+ import { SignedTxs } from './signed_txs.js';
25
+ import { TopicType } from './topic_type.js';
26
+
27
+ // REFACTOR(palla): Use a branded type instead of a subclass of Buffer32
28
+ export class CheckpointProposalHash extends Buffer32 {
29
+ constructor(hash: Buffer) {
30
+ super(hash);
31
+ }
32
+ }
33
+
34
+ export type CheckpointProposalOptions = {
35
+ /**
36
+ * Whether to include the tx objects along with the block proposal.
37
+ * Dramatically increases size of the payload but eliminates failed reexecutions due to missing txs.
38
+ */
39
+ publishFullTxs?: boolean;
40
+ /**
41
+ * Whether to generate an invalid checkpoint proposal for broadcasting.
42
+ * Use only for testing.
43
+ */
44
+ broadcastInvalidCheckpointProposal?: boolean;
45
+ };
46
+
47
+ /** Data for the last block included in a checkpoint proposal */
48
+ export type CheckpointLastBlockData = {
49
+ /** The per-block header for the last block in the checkpoint */
50
+ blockHeader: BlockHeader;
51
+ /** Index of this block within the checkpoint (should be the last index, e.g., numBlocks - 1) */
52
+ indexWithinCheckpoint: IndexWithinCheckpoint;
53
+ /** The sequence of transactions in the last block */
54
+ txHashes: TxHash[];
55
+ /** The tx in the last block (optional, for DA guarantees) */
56
+ txs?: Tx[];
57
+ };
58
+
59
+ /** Last block included in a checkpoint proposal */
60
+ export type CheckpointLastBlock = Omit<CheckpointLastBlockData, 'txs'> & {
61
+ /** The proposer's signature over the block data (separate from checkpoint signature) */
62
+ signature: Signature;
63
+ /** The signed transactions in the last block (optional, for DA guarantees) */
64
+ signedTxs?: SignedTxs;
65
+ };
66
+
67
+ /**
68
+ * A checkpoint proposal is created by the leader of the chain for the last block in a checkpoint.
69
+ * It includes the aggregated checkpoint header that validators will attest to, plus optionally
70
+ * the last block's info for nodes to re-execute. This marks the completion of a slot's worth of blocks.
71
+ */
72
+ export class CheckpointProposal extends Gossipable {
73
+ static override p2pTopic = TopicType.checkpoint_proposal;
74
+
75
+ private sender: EthAddress | undefined;
76
+
77
+ constructor(
78
+ /** The aggregated checkpoint header for consensus */
79
+ public readonly checkpointHeader: CheckpointHeader,
80
+
81
+ /** Archive root after this checkpoint is applied */
82
+ public readonly archive: Fr,
83
+
84
+ /** The proposer's signature over the checkpoint payload (checkpointHeader + archive) */
85
+ public readonly signature: Signature,
86
+
87
+ /** Optional last block info, including its own signature for BlockProposal extraction */
88
+ public readonly lastBlock?: CheckpointLastBlock,
89
+ ) {
90
+ super();
91
+ }
92
+
93
+ override generateP2PMessageIdentifier(): Promise<Buffer32> {
94
+ return Promise.resolve(new CheckpointProposalHash(keccak256(this.signature.toBuffer())));
95
+ }
96
+
97
+ get slotNumber(): SlotNumber {
98
+ return this.checkpointHeader.slotNumber;
99
+ }
100
+
101
+ get blockNumber(): BlockNumber {
102
+ if (!this.lastBlock) {
103
+ throw new Error('Cannot get blockNumber without lastBlock');
104
+ }
105
+ return this.lastBlock.blockHeader.getBlockNumber();
106
+ }
107
+
108
+ /** Convenience getter for txHashes from lastBlock */
109
+ get txHashes(): TxHash[] {
110
+ return this.lastBlock?.txHashes ?? [];
111
+ }
112
+
113
+ /** Convenience getter for txs from lastBlock */
114
+ get txs(): Tx[] | undefined {
115
+ return this.lastBlock?.signedTxs?.txs;
116
+ }
117
+
118
+ /**
119
+ * Extract a BlockProposal from the last block info.
120
+ * Uses inHash from checkpointHeader.contentCommitment.inHash
121
+ */
122
+ getBlockProposal(): BlockProposal | undefined {
123
+ if (!this.lastBlock) {
124
+ return undefined;
125
+ }
126
+
127
+ return new BlockProposal(
128
+ this.lastBlock.blockHeader,
129
+ this.lastBlock.indexWithinCheckpoint,
130
+ this.checkpointHeader.inHash,
131
+ this.archive,
132
+ this.lastBlock.txHashes,
133
+ this.lastBlock.signature,
134
+ this.lastBlock.signedTxs,
135
+ );
136
+ }
137
+
138
+ toBlockInfo(): Omit<L2BlockInfo, 'blockNumber'> {
139
+ if (!this.lastBlock) {
140
+ throw new Error('Cannot get blockInfo without lastBlock');
141
+ }
142
+ return {
143
+ slotNumber: this.slotNumber,
144
+ lastArchive: this.lastBlock.blockHeader.lastArchive.root,
145
+ timestamp: this.lastBlock.blockHeader.globalVariables.timestamp,
146
+ archive: this.archive,
147
+ txCount: this.lastBlock.txHashes.length,
148
+ };
149
+ }
150
+
151
+ toCheckpointInfo() {
152
+ return {
153
+ slotNumber: this.slotNumber,
154
+ archive: this.archive,
155
+ lastBlockNumber: this.lastBlock?.blockHeader.getBlockNumber(),
156
+ lastBlockIndex: this.lastBlock?.indexWithinCheckpoint,
157
+ blockHeadersHash: this.checkpointHeader.blockHeadersHash,
158
+ };
159
+ }
160
+
161
+ /**
162
+ * Get the payload to sign for this checkpoint proposal.
163
+ * The signature is over the checkpoint header + archive root (for consensus).
164
+ */
165
+ getPayloadToSign(domainSeparator: SignatureDomainSeparator): Buffer {
166
+ return serializeToBuffer([domainSeparator, this.checkpointHeader, this.archive]);
167
+ }
168
+
169
+ static async createProposalFromSigner(
170
+ checkpointHeader: CheckpointHeader,
171
+ archiveRoot: Fr,
172
+ lastBlockInfo: CheckpointLastBlockData | undefined,
173
+ payloadSigner: (payload: Buffer32, context: SigningContext) => Promise<Signature>,
174
+ ): Promise<CheckpointProposal> {
175
+ // Sign the checkpoint payload with CHECKPOINT_PROPOSAL duty type
176
+ const tempProposal = new CheckpointProposal(checkpointHeader, archiveRoot, Signature.empty(), undefined);
177
+ const checkpointHash = getHashedSignaturePayload(tempProposal, SignatureDomainSeparator.checkpointProposal);
178
+
179
+ const checkpointContext: SigningContext = {
180
+ slot: checkpointHeader.slotNumber,
181
+ blockNumber: lastBlockInfo?.blockHeader?.globalVariables.blockNumber ?? BlockNumber(0),
182
+ dutyType: DutyType.CHECKPOINT_PROPOSAL,
183
+ };
184
+ const checkpointSignature = await payloadSigner(checkpointHash, checkpointContext);
185
+
186
+ if (!lastBlockInfo) {
187
+ return new CheckpointProposal(checkpointHeader, archiveRoot, checkpointSignature);
188
+ }
189
+
190
+ const lastBlockProposal = await BlockProposal.createProposalFromSigner(
191
+ lastBlockInfo.blockHeader,
192
+ lastBlockInfo.indexWithinCheckpoint,
193
+ checkpointHeader.inHash,
194
+ archiveRoot,
195
+ lastBlockInfo.txHashes,
196
+ lastBlockInfo.txs,
197
+ payloadSigner,
198
+ );
199
+
200
+ return new CheckpointProposal(checkpointHeader, archiveRoot, checkpointSignature, {
201
+ blockHeader: lastBlockInfo.blockHeader,
202
+ indexWithinCheckpoint: lastBlockInfo.indexWithinCheckpoint,
203
+ txHashes: lastBlockInfo.txHashes,
204
+ signature: lastBlockProposal.signature,
205
+ signedTxs: lastBlockProposal.signedTxs,
206
+ });
207
+ }
208
+
209
+ /**
210
+ * Lazily evaluate the sender of the proposal; result is cached.
211
+ * If there's a lastBlock, also verifies the block proposal sender matches the checkpoint sender.
212
+ * @returns The sender address, or undefined if signature recovery fails or senders don't match
213
+ */
214
+ getSender(): EthAddress | undefined {
215
+ if (!this.sender) {
216
+ const hashed = getHashedSignaturePayloadEthSignedMessage(this, SignatureDomainSeparator.checkpointProposal);
217
+ const checkpointSender = tryRecoverAddress(hashed, this.signature);
218
+
219
+ // If there's a lastBlock, verify the block proposal sender matches
220
+ if (checkpointSender && this.lastBlock) {
221
+ const blockProposal = this.getBlockProposal();
222
+ const blockSender = blockProposal?.getSender();
223
+ if (!blockSender || !blockSender.equals(checkpointSender)) {
224
+ return undefined; // Sender mismatch - fail
225
+ }
226
+ }
227
+
228
+ // Cache the sender for later use
229
+ this.sender = checkpointSender;
230
+ }
231
+
232
+ return this.sender;
233
+ }
234
+
235
+ getPayload() {
236
+ return this.getPayloadToSign(SignatureDomainSeparator.checkpointProposal);
237
+ }
238
+
239
+ toBuffer(): Buffer {
240
+ const buffer: any[] = [this.checkpointHeader, this.archive, this.signature];
241
+
242
+ if (this.lastBlock) {
243
+ buffer.push(1); // hasLastBlock = true
244
+ buffer.push(this.lastBlock.blockHeader);
245
+ buffer.push(this.lastBlock.indexWithinCheckpoint);
246
+ buffer.push(this.lastBlock.signature);
247
+ buffer.push(this.lastBlock.txHashes.length);
248
+ buffer.push(this.lastBlock.txHashes);
249
+ if (this.lastBlock.signedTxs) {
250
+ buffer.push(1); // hasSignedTxs = true
251
+ buffer.push(this.lastBlock.signedTxs.toBuffer());
252
+ } else {
253
+ buffer.push(0); // hasSignedTxs = false
254
+ }
255
+ } else {
256
+ buffer.push(0); // hasLastBlock = false
257
+ }
258
+
259
+ return serializeToBuffer(buffer);
260
+ }
261
+
262
+ static fromBuffer(buf: Buffer | BufferReader): CheckpointProposal {
263
+ const reader = BufferReader.asReader(buf);
264
+
265
+ const checkpointHeader = reader.readObject(CheckpointHeader);
266
+ const archive = reader.readObject(Fr);
267
+ const signature = reader.readObject(Signature);
268
+
269
+ const hasLastBlock = reader.readNumber();
270
+
271
+ if (hasLastBlock) {
272
+ const blockHeader = reader.readObject(BlockHeader);
273
+ const indexWithinCheckpoint = IndexWithinCheckpoint(reader.readNumber());
274
+ const blockSignature = reader.readObject(Signature);
275
+ const txHashCount = reader.readNumber();
276
+ if (txHashCount > MAX_TXS_PER_BLOCK) {
277
+ throw new Error(`txHashes count ${txHashCount} exceeds maximum ${MAX_TXS_PER_BLOCK}`);
278
+ }
279
+ const txHashes = reader.readArray(txHashCount, TxHash);
280
+
281
+ let signedTxs: SignedTxs | undefined;
282
+ if (!reader.isEmpty()) {
283
+ const hasSignedTxs = reader.readNumber();
284
+ if (hasSignedTxs) {
285
+ signedTxs = SignedTxs.fromBuffer(reader);
286
+ }
287
+ }
288
+
289
+ return new CheckpointProposal(checkpointHeader, archive, signature, {
290
+ blockHeader,
291
+ indexWithinCheckpoint,
292
+ txHashes,
293
+ signature: blockSignature,
294
+ signedTxs,
295
+ });
296
+ }
297
+
298
+ return new CheckpointProposal(checkpointHeader, archive, signature);
299
+ }
300
+
301
+ getSize(): number {
302
+ let size =
303
+ this.checkpointHeader.toBuffer().length +
304
+ this.archive.size +
305
+ this.signature.getSize() +
306
+ 4; /* hasLastBlock flag */
307
+
308
+ if (this.lastBlock) {
309
+ size +=
310
+ this.lastBlock.blockHeader.getSize() +
311
+ 4 /* indexWithinCheckpoint */ +
312
+ this.lastBlock.signature.getSize() +
313
+ 4 /* txHashes.length */ +
314
+ this.lastBlock.txHashes.length * TxHash.SIZE +
315
+ 4 /* hasSignedTxs flag */ +
316
+ (this.lastBlock.signedTxs ? this.lastBlock.signedTxs.getSize() : 0);
317
+ }
318
+
319
+ return size;
320
+ }
321
+
322
+ static empty(): CheckpointProposal {
323
+ return new CheckpointProposal(CheckpointHeader.empty(), Fr.ZERO, Signature.empty());
324
+ }
325
+
326
+ static random(): CheckpointProposal {
327
+ return new CheckpointProposal(CheckpointHeader.random(), Fr.random(), Signature.random(), {
328
+ blockHeader: BlockHeader.random(),
329
+ indexWithinCheckpoint: IndexWithinCheckpoint(Math.floor(Math.random() * 5)),
330
+ txHashes: [TxHash.random(), TxHash.random()],
331
+ signature: Signature.random(),
332
+ });
333
+ }
334
+
335
+ toInspect() {
336
+ return {
337
+ checkpointHeader: this.checkpointHeader.toInspect(),
338
+ archive: this.archive.toString(),
339
+ signature: this.signature.toString(),
340
+ lastBlock: this.lastBlock
341
+ ? {
342
+ blockHeader: this.lastBlock.blockHeader.toInspect(),
343
+ indexWithinCheckpoint: this.lastBlock.indexWithinCheckpoint,
344
+ txHashes: this.lastBlock.txHashes.map(h => h.toString()),
345
+ signature: this.lastBlock.signature.toString(),
346
+ }
347
+ : undefined,
348
+ };
349
+ }
350
+
351
+ /**
352
+ * Returns a copy of this proposal without lastBlock info, as a CheckpointProposalCore.
353
+ * Used when the lastBlock has been extracted and stored separately.
354
+ */
355
+ toCore(): CheckpointProposalCore {
356
+ return new CheckpointProposal(this.checkpointHeader, this.archive, this.signature);
357
+ }
358
+ }
359
+
360
+ /**
361
+ * A checkpoint proposal without the lastBlock info.
362
+ * Used when the lastBlock has been extracted and handled separately as a BlockProposal.
363
+ * This type makes it clear that lastBlock and getBlockProposal() are not available.
364
+ */
365
+ export type CheckpointProposalCore = Omit<CheckpointProposal, 'lastBlock' | 'getBlockProposal' | 'toCore'>;
@@ -7,11 +7,12 @@ import type { FieldsOf } from '@aztec/foundation/types';
7
7
  import { encodeAbiParameters, parseAbiParameters } from 'viem';
8
8
  import { z } from 'zod';
9
9
 
10
- import type { L2Block } from '../block/l2_block.js';
11
10
  import type { Checkpoint } from '../checkpoint/checkpoint.js';
12
11
  import { CheckpointHeader } from '../rollup/checkpoint_header.js';
12
+ import type { CheckpointProposal, CheckpointProposalCore } from './checkpoint_proposal.js';
13
13
  import type { Signable, SignatureDomainSeparator } from './signature_utils.js';
14
14
 
15
+ /** Checkpoint consensus payload as signed by validators and verified on L1. */
15
16
  export class ConsensusPayload implements Signable {
16
17
  private size: number | undefined;
17
18
 
@@ -59,8 +60,9 @@ export class ConsensusPayload implements Signable {
59
60
  return serializeToBuffer([this.header, this.archive]);
60
61
  }
61
62
 
62
- public equals(other: ConsensusPayload): boolean {
63
- return this.header.equals(other.header) && this.archive.equals(other.archive);
63
+ public equals(other: ConsensusPayload | CheckpointProposal | CheckpointProposalCore): boolean {
64
+ const otherHeader = 'checkpointHeader' in other ? other.checkpointHeader : other.header;
65
+ return this.header.equals(otherHeader) && this.archive.equals(other.archive);
64
66
  }
65
67
 
66
68
  static fromBuffer(buf: Buffer | BufferReader): ConsensusPayload {
@@ -73,10 +75,6 @@ export class ConsensusPayload implements Signable {
73
75
  return new ConsensusPayload(fields.header, fields.archive);
74
76
  }
75
77
 
76
- static fromBlock(block: L2Block): ConsensusPayload {
77
- return new ConsensusPayload(block.header.toCheckpointHeader(), block.archive.root);
78
- }
79
-
80
78
  static fromCheckpoint(checkpoint: Checkpoint): ConsensusPayload {
81
79
  return new ConsensusPayload(checkpoint.header, checkpoint.archive.root);
82
80
  }
@@ -0,0 +1,6 @@
1
+ export const MAX_TX_SIZE_KB: number = 512;
2
+
3
+ export const MAX_MESSAGE_SIZE_KB: number = 10 * 1024;
4
+
5
+ /** Maximum size for L2Block response (contains TxEffects, not full Txs with proofs) */
6
+ export const MAX_L2_BLOCK_SIZE_KB: number = 3 * 1024; // 3 MB
@@ -7,23 +7,33 @@ export class P2PMessage {
7
7
  constructor(
8
8
  public readonly payload: Buffer,
9
9
  public readonly timestamp?: Date,
10
+ public readonly traceContext?: string,
10
11
  ) {}
11
12
 
12
- static fromGossipable(message: Gossipable, instrumentMessages = false): P2PMessage {
13
- return new P2PMessage(message.toBuffer(), instrumentMessages ? new Date() : undefined);
13
+ static fromGossipable(message: Gossipable, instrumentMessages = false, traceContext?: string): P2PMessage {
14
+ if (!instrumentMessages) {
15
+ return new P2PMessage(message.toBuffer());
16
+ }
17
+ return new P2PMessage(message.toBuffer(), new Date(), traceContext);
14
18
  }
15
19
 
16
20
  static fromMessageData(messageData: Buffer, instrumentMessages = false): P2PMessage {
17
21
  const reader = new BufferReader(messageData);
18
- const timestamp = instrumentMessages ? new Date(Number(reader.readUInt64())) : undefined;
22
+ let timestamp: Date | undefined;
23
+ let traceContext: string | undefined;
24
+ if (instrumentMessages) {
25
+ timestamp = new Date(Number(reader.readUInt64()));
26
+ traceContext = reader.readString();
27
+ }
19
28
  const payload = reader.readBuffer();
20
- return new P2PMessage(payload, timestamp);
29
+ return new P2PMessage(payload, timestamp, traceContext);
21
30
  }
22
31
 
23
32
  toMessageData(): Buffer {
24
33
  const arr: Buffer[] = [];
25
34
  if (this.timestamp) {
26
35
  arr.push(bigintToUInt64BE(BigInt(this.timestamp.getTime())));
36
+ arr.push(serializeToBuffer(this.traceContext ?? ''));
27
37
  }
28
38
  arr.push(serializeToBuffer(this.payload.length, this.payload));
29
39
  return serializeToBuffer(arr);
package/src/p2p/index.ts CHANGED
@@ -1,11 +1,14 @@
1
1
  export * from './attestation_utils.js';
2
- export * from './block_attestation.js';
3
2
  export * from './block_proposal.js';
3
+ export * from './checkpoint_attestation.js';
4
+ export * from './checkpoint_proposal.js';
4
5
  export * from './consensus_payload.js';
5
6
  export * from './gossipable.js';
6
7
  export * from './interface.js';
7
8
  export * from './signature_utils.js';
9
+ export * from './signed_txs.js';
8
10
  export * from './topic_type.js';
9
11
  export * from './client_type.js';
10
12
  export * from './message_validator.js';
11
13
  export * from './peer_error.js';
14
+ export * from './constants.js';
@@ -1,10 +1,22 @@
1
1
  import type { PeerErrorSeverity } from './peer_error.js';
2
2
 
3
+ /**
4
+ * Result of validating a P2P message.
5
+ * - 'accept': Message is valid and should be accepted and processed
6
+ * - 'ignore': Message should be ignored (not propagated or processed, but sender not penalized)
7
+ * - 'reject': Message is invalid (rejected and sender penalized)
8
+ */
9
+ export type ValidationResult =
10
+ | { result: 'accept' }
11
+ | { result: 'ignore' }
12
+ | { result: 'reject'; severity: PeerErrorSeverity };
13
+
3
14
  /**
4
15
  * P2PValidator
5
16
  *
6
- * A validator for P2P messages, which returns a severity of error to be applied to the peer
17
+ * A validator for P2P messages, which returns a ValidationResult indicating
18
+ * whether to accept, ignore, or reject the message
7
19
  */
8
20
  export interface P2PValidator<T> {
9
- validate(message: T): Promise<PeerErrorSeverity | undefined>;
21
+ validate(message: T): Promise<ValidationResult>;
10
22
  }
@@ -4,8 +4,10 @@ import { makeEthSignDigest } from '@aztec/foundation/crypto/secp256k1-signer';
4
4
 
5
5
  export enum SignatureDomainSeparator {
6
6
  blockProposal = 0,
7
- blockAttestation = 1,
7
+ checkpointAttestation = 1,
8
8
  attestationsAndSigners = 2,
9
+ checkpointProposal = 3,
10
+ signedTxs = 4,
9
11
  }
10
12
 
11
13
  export interface Signable {
@@ -0,0 +1,88 @@
1
+ import { Buffer32 } from '@aztec/foundation/buffer';
2
+ import { tryRecoverAddress } from '@aztec/foundation/crypto/secp256k1-signer';
3
+ import type { EthAddress } from '@aztec/foundation/eth-address';
4
+ import { Signature } from '@aztec/foundation/eth-signature';
5
+ import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize';
6
+
7
+ import { MAX_TXS_PER_BLOCK } from '../deserialization/index.js';
8
+ import { Tx } from '../tx/tx.js';
9
+ import {
10
+ SignatureDomainSeparator,
11
+ getHashedSignaturePayload,
12
+ getHashedSignaturePayloadEthSignedMessage,
13
+ } from './signature_utils.js';
14
+
15
+ /**
16
+ * A signed collection of transactions.
17
+ * The signature is over the transaction objects themselves, providing
18
+ * data availability guarantees beyond just the transaction hashes.
19
+ */
20
+ export class SignedTxs {
21
+ private sender: EthAddress | undefined;
22
+
23
+ constructor(
24
+ /** The transactions */
25
+ public readonly txs: Tx[],
26
+ /** The proposer's signature over the transactions */
27
+ public readonly signature: Signature,
28
+ ) {}
29
+
30
+ /**
31
+ * Get the payload to sign for this signed txs.
32
+ */
33
+ getPayloadToSign(domainSeparator: SignatureDomainSeparator): Buffer {
34
+ return serializeToBuffer([domainSeparator, this.txs.length, this.txs]);
35
+ }
36
+
37
+ /**
38
+ * Lazily evaluate the sender of the signed txs; result is cached
39
+ * @returns The sender address, or undefined if signature recovery fails
40
+ */
41
+ getSender(): EthAddress | undefined {
42
+ if (!this.sender) {
43
+ const hashed = getHashedSignaturePayloadEthSignedMessage(this, SignatureDomainSeparator.signedTxs);
44
+ this.sender = tryRecoverAddress(hashed, this.signature);
45
+ }
46
+ return this.sender;
47
+ }
48
+
49
+ /**
50
+ * Create SignedTxs from a signer function
51
+ */
52
+ static async createFromSigner(
53
+ txs: Tx[],
54
+ payloadSigner: (payload: Buffer32) => Promise<Signature>,
55
+ ): Promise<SignedTxs> {
56
+ const tempSignedTxs = new SignedTxs(txs, Signature.empty());
57
+ const hashed = getHashedSignaturePayload(tempSignedTxs, SignatureDomainSeparator.signedTxs);
58
+ const signature = await payloadSigner(hashed);
59
+ return new SignedTxs(txs, signature);
60
+ }
61
+
62
+ toBuffer(): Buffer {
63
+ return serializeToBuffer([this.txs.length, this.txs, this.signature]);
64
+ }
65
+
66
+ static fromBuffer(buf: Buffer | BufferReader): SignedTxs {
67
+ const reader = BufferReader.asReader(buf);
68
+ const txCount = reader.readNumber();
69
+ if (txCount > MAX_TXS_PER_BLOCK) {
70
+ throw new Error(`txs count ${txCount} exceeds maximum ${MAX_TXS_PER_BLOCK}`);
71
+ }
72
+ const txs = reader.readArray(txCount, Tx);
73
+ const signature = reader.readObject(Signature);
74
+ return new SignedTxs(txs, signature);
75
+ }
76
+
77
+ getSize(): number {
78
+ return 4 /* txs.length */ + this.txs.reduce((acc, tx) => acc + tx.getSize(), 0) + this.signature.getSize();
79
+ }
80
+
81
+ static empty(): SignedTxs {
82
+ return new SignedTxs([], Signature.empty());
83
+ }
84
+
85
+ static random(): SignedTxs {
86
+ return new SignedTxs([Tx.random(), Tx.random()], Signature.random());
87
+ }
88
+ }
@@ -23,14 +23,15 @@ export function getTopicFromString(topicStr: string): TopicType | undefined {
23
23
  export enum TopicType {
24
24
  tx = 'tx',
25
25
  block_proposal = 'block_proposal',
26
- block_attestation = 'block_attestation',
26
+ checkpoint_proposal = 'checkpoint_proposal',
27
+ checkpoint_attestation = 'checkpoint_attestation',
27
28
  }
28
29
 
29
30
  export function getTopicTypeForClientType(clientType: P2PClientType) {
30
31
  if (clientType === P2PClientType.Full) {
31
- return Object.values(TopicType);
32
+ return [TopicType.tx, TopicType.block_proposal, TopicType.checkpoint_proposal, TopicType.checkpoint_attestation];
32
33
  } else if (clientType === P2PClientType.Prover) {
33
- return [TopicType.tx, TopicType.block_proposal];
34
+ return [TopicType.tx, TopicType.block_proposal, TopicType.checkpoint_proposal];
34
35
  } else {
35
36
  const _: never = clientType;
36
37
  return [TopicType.tx];
@@ -1,4 +1,5 @@
1
1
  import { CHONK_PROOF_LENGTH } from '@aztec/constants';
2
+ import { times } from '@aztec/foundation/collection';
2
3
  import { randomBytes } from '@aztec/foundation/crypto/random';
3
4
  import { Fr } from '@aztec/foundation/curves/bn254';
4
5
  import { bufferSchemaFor } from '@aztec/foundation/schemas';
@@ -31,12 +32,15 @@ export class ChonkProof {
31
32
 
32
33
  static random() {
33
34
  // NB: Not using Fr.random here because it slows down some tests that require a large number of txs significantly.
35
+ // NB2: generate one fewer random bytes to not have to deal with buffers representing numbers greater than the field modulus
36
+ // NB3: a chonk proof can be compressed. Simulate this by filling 1/4 of the proof with zero data
34
37
  const reducedFrSize = Fr.SIZE_IN_BYTES - 1;
35
- const randomFields = randomBytes(CHONK_PROOF_LENGTH * reducedFrSize);
36
- const proof = Array.from(
37
- { length: CHONK_PROOF_LENGTH },
38
- (_, i) => new Fr(randomFields.subarray(i * reducedFrSize, (i + 1) * reducedFrSize)),
39
- );
38
+ const nonZeroFields = Math.floor((3 * CHONK_PROOF_LENGTH) / 4);
39
+ const randomFields = randomBytes(nonZeroFields * Fr.SIZE_IN_BYTES);
40
+ const proof = [
41
+ ...times(nonZeroFields, i => new Fr(randomFields.subarray(i * reducedFrSize, (i + 1) * reducedFrSize))),
42
+ ...times(CHONK_PROOF_LENGTH - nonZeroFields, () => Fr.ZERO),
43
+ ];
40
44
  return new ChonkProof(proof);
41
45
  }
42
46
 
@@ -5,7 +5,7 @@ import type { BlockHeader } from '../tx/block_header.js';
5
5
 
6
6
  export async function computeBlockHeadersHash(blockHeaders: BlockHeader[]): Promise<Fr> {
7
7
  const blockHeaderHashes = await Promise.all(blockHeaders.map(header => header.hash()));
8
- // Must match the implementation in merge_block_rollups.nr, with the **wonky** rollup structure
8
+ // Must match the implementation in merge_block_rollups.nr, with the **unbalanced** rollup structure
9
9
  // (see validate_consecutive_block_rollups.nr > assert_rollups_filled_greedily.nr).
10
10
  const blockHeadersHash = await computeUnbalancedPoseidonRoot(blockHeaderHashes.map(hash => hash.toBuffer()));
11
11
  return Fr.fromBuffer(blockHeadersHash);