@aztec/stdlib 0.0.1-commit.cd76b27 → 0.0.1-commit.ce4f8c4f2

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 (340) hide show
  1. package/dest/abi/abi.d.ts +138 -1
  2. package/dest/abi/abi.d.ts.map +1 -1
  3. package/dest/abi/abi.js +10 -2
  4. package/dest/abi/buffer.d.ts +14 -4
  5. package/dest/abi/buffer.d.ts.map +1 -1
  6. package/dest/abi/buffer.js +25 -4
  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/utils.d.ts +14 -1
  17. package/dest/abi/utils.d.ts.map +1 -1
  18. package/dest/abi/utils.js +15 -0
  19. package/dest/avm/avm_proving_request.d.ts +166 -166
  20. package/dest/avm/revert_code.d.ts +16 -1
  21. package/dest/avm/revert_code.d.ts.map +1 -1
  22. package/dest/avm/revert_code.js +15 -5
  23. package/dest/block/l2_block.d.ts +9 -1
  24. package/dest/block/l2_block.d.ts.map +1 -1
  25. package/dest/block/l2_block.js +12 -2
  26. package/dest/block/l2_block_source.d.ts +16 -8
  27. package/dest/block/l2_block_source.d.ts.map +1 -1
  28. package/dest/block/l2_block_stream/l2_block_stream.d.ts +1 -1
  29. package/dest/block/l2_block_stream/l2_block_stream.d.ts.map +1 -1
  30. package/dest/block/l2_block_stream/l2_block_stream.js +10 -0
  31. package/dest/checkpoint/checkpoint.d.ts +2 -1
  32. package/dest/checkpoint/checkpoint.d.ts.map +1 -1
  33. package/dest/checkpoint/checkpoint.js +9 -4
  34. package/dest/checkpoint/index.d.ts +2 -1
  35. package/dest/checkpoint/index.d.ts.map +1 -1
  36. package/dest/checkpoint/index.js +1 -0
  37. package/dest/checkpoint/validate.d.ts +36 -0
  38. package/dest/checkpoint/validate.d.ts.map +1 -0
  39. package/dest/checkpoint/validate.js +120 -0
  40. package/dest/config/index.d.ts +2 -1
  41. package/dest/config/index.d.ts.map +1 -1
  42. package/dest/config/index.js +1 -0
  43. package/dest/config/pipelining-config.d.ts +19 -0
  44. package/dest/config/pipelining-config.d.ts.map +1 -0
  45. package/dest/config/pipelining-config.js +18 -0
  46. package/dest/config/sequencer-config.d.ts +4 -2
  47. package/dest/config/sequencer-config.d.ts.map +1 -1
  48. package/dest/config/sequencer-config.js +6 -0
  49. package/dest/contract/contract_address.d.ts +3 -3
  50. package/dest/contract/contract_address.js +3 -3
  51. package/dest/contract/contract_class.d.ts +2 -3
  52. package/dest/contract/contract_class.d.ts.map +1 -1
  53. package/dest/contract/contract_class_id.d.ts +2 -2
  54. package/dest/contract/contract_class_id.js +2 -2
  55. package/dest/contract/index.d.ts +1 -3
  56. package/dest/contract/index.d.ts.map +1 -1
  57. package/dest/contract/index.js +0 -2
  58. package/dest/contract/interfaces/contract_class.d.ts +3 -156
  59. package/dest/contract/interfaces/contract_class.d.ts.map +1 -1
  60. package/dest/contract/interfaces/contract_class.js +1 -28
  61. package/dest/epoch-helpers/index.d.ts +7 -1
  62. package/dest/epoch-helpers/index.d.ts.map +1 -1
  63. package/dest/epoch-helpers/index.js +10 -2
  64. package/dest/gas/gas_fees.d.ts +1 -1
  65. package/dest/gas/gas_fees.d.ts.map +1 -1
  66. package/dest/gas/gas_fees.js +4 -1
  67. package/dest/ha-signing/config.d.ts +136 -0
  68. package/dest/ha-signing/config.d.ts.map +1 -0
  69. package/dest/ha-signing/config.js +97 -0
  70. package/dest/ha-signing/index.d.ts +4 -0
  71. package/dest/ha-signing/index.d.ts.map +1 -0
  72. package/dest/ha-signing/index.js +3 -0
  73. package/dest/ha-signing/local_config.d.ts +63 -0
  74. package/dest/ha-signing/local_config.d.ts.map +1 -0
  75. package/dest/ha-signing/local_config.js +24 -0
  76. package/dest/ha-signing/types.d.ts +85 -0
  77. package/dest/ha-signing/types.d.ts.map +1 -0
  78. package/dest/ha-signing/types.js +32 -0
  79. package/dest/hash/hash.d.ts +16 -1
  80. package/dest/hash/hash.d.ts.map +1 -1
  81. package/dest/hash/hash.js +24 -0
  82. package/dest/interfaces/allowed_element.d.ts +26 -20
  83. package/dest/interfaces/allowed_element.d.ts.map +1 -1
  84. package/dest/interfaces/allowed_element.js +8 -8
  85. package/dest/interfaces/archiver.d.ts +1 -1
  86. package/dest/interfaces/archiver.d.ts.map +1 -1
  87. package/dest/interfaces/archiver.js +3 -2
  88. package/dest/interfaces/aztec-node-admin.d.ts +76 -30
  89. package/dest/interfaces/aztec-node-admin.d.ts.map +1 -1
  90. package/dest/interfaces/aztec-node.d.ts +12 -6
  91. package/dest/interfaces/aztec-node.d.ts.map +1 -1
  92. package/dest/interfaces/aztec-node.js +5 -2
  93. package/dest/interfaces/block-builder.d.ts +38 -11
  94. package/dest/interfaces/block-builder.d.ts.map +1 -1
  95. package/dest/interfaces/block-builder.js +13 -6
  96. package/dest/interfaces/configs.d.ts +62 -32
  97. package/dest/interfaces/configs.d.ts.map +1 -1
  98. package/dest/interfaces/configs.js +6 -2
  99. package/dest/interfaces/l2_logs_source.d.ts +5 -3
  100. package/dest/interfaces/l2_logs_source.d.ts.map +1 -1
  101. package/dest/interfaces/merkle_tree_operations.d.ts +9 -19
  102. package/dest/interfaces/merkle_tree_operations.d.ts.map +1 -1
  103. package/dest/interfaces/p2p.d.ts +3 -8
  104. package/dest/interfaces/p2p.d.ts.map +1 -1
  105. package/dest/interfaces/prover-client.d.ts +6 -1
  106. package/dest/interfaces/prover-client.d.ts.map +1 -1
  107. package/dest/interfaces/prover-client.js +7 -1
  108. package/dest/interfaces/proving-job.d.ts +200 -200
  109. package/dest/interfaces/validator.d.ts +103 -41
  110. package/dest/interfaces/validator.d.ts.map +1 -1
  111. package/dest/interfaces/validator.js +8 -4
  112. package/dest/interfaces/world_state.d.ts +5 -4
  113. package/dest/interfaces/world_state.d.ts.map +1 -1
  114. package/dest/kernel/hints/build_note_hash_read_request_hints.d.ts +3 -3
  115. package/dest/kernel/hints/build_note_hash_read_request_hints.d.ts.map +1 -1
  116. package/dest/kernel/hints/build_note_hash_read_request_hints.js +13 -10
  117. package/dest/kernel/hints/build_nullifier_read_request_hints.d.ts +3 -3
  118. package/dest/kernel/hints/build_nullifier_read_request_hints.d.ts.map +1 -1
  119. package/dest/kernel/hints/build_nullifier_read_request_hints.js +13 -10
  120. package/dest/kernel/hints/build_transient_data_hints.d.ts +5 -2
  121. package/dest/kernel/hints/build_transient_data_hints.d.ts.map +1 -1
  122. package/dest/kernel/hints/build_transient_data_hints.js +9 -3
  123. package/dest/kernel/private_kernel_tail_circuit_public_inputs.d.ts +2 -1
  124. package/dest/kernel/private_kernel_tail_circuit_public_inputs.d.ts.map +1 -1
  125. package/dest/kernel/private_kernel_tail_circuit_public_inputs.js +4 -0
  126. package/dest/kv-store/config.d.ts +17 -0
  127. package/dest/kv-store/config.d.ts.map +1 -0
  128. package/dest/kv-store/config.js +26 -0
  129. package/dest/kv-store/index.d.ts +2 -0
  130. package/dest/kv-store/index.d.ts.map +1 -0
  131. package/dest/kv-store/index.js +1 -0
  132. package/dest/logs/debug_log_store.d.ts +30 -0
  133. package/dest/logs/debug_log_store.d.ts.map +1 -0
  134. package/dest/logs/debug_log_store.js +30 -0
  135. package/dest/logs/extended_directional_app_tagging_secret.d.ts +47 -0
  136. package/dest/logs/extended_directional_app_tagging_secret.d.ts.map +1 -0
  137. package/dest/logs/{directional_app_tagging_secret.js → extended_directional_app_tagging_secret.js} +23 -15
  138. package/dest/logs/index.d.ts +4 -2
  139. package/dest/logs/index.d.ts.map +1 -1
  140. package/dest/logs/index.js +3 -1
  141. package/dest/logs/log_filter.d.ts +4 -1
  142. package/dest/logs/log_filter.d.ts.map +1 -1
  143. package/dest/logs/log_filter.js +2 -1
  144. package/dest/logs/pre_tag.d.ts +16 -11
  145. package/dest/logs/pre_tag.d.ts.map +1 -1
  146. package/dest/logs/pre_tag.js +2 -2
  147. package/dest/logs/public_log.d.ts +4 -3
  148. package/dest/logs/public_log.d.ts.map +1 -1
  149. package/dest/logs/public_log.js +2 -1
  150. package/dest/logs/siloed_tag.d.ts +5 -3
  151. package/dest/logs/siloed_tag.d.ts.map +1 -1
  152. package/dest/logs/siloed_tag.js +6 -1
  153. package/dest/logs/tag.js +1 -1
  154. package/dest/logs/tagging_index_range.d.ts +40 -0
  155. package/dest/logs/tagging_index_range.d.ts.map +1 -0
  156. package/dest/logs/tagging_index_range.js +8 -0
  157. package/dest/logs/tx_scoped_l2_log.d.ts +3 -1
  158. package/dest/logs/tx_scoped_l2_log.d.ts.map +1 -1
  159. package/dest/logs/tx_scoped_l2_log.js +7 -0
  160. package/dest/messaging/l1_to_l2_message.d.ts +3 -2
  161. package/dest/messaging/l1_to_l2_message.d.ts.map +1 -1
  162. package/dest/messaging/l1_to_l2_message.js +11 -13
  163. package/dest/messaging/l1_to_l2_message_source.d.ts +4 -2
  164. package/dest/messaging/l1_to_l2_message_source.d.ts.map +1 -1
  165. package/dest/messaging/l2_to_l1_membership.d.ts +32 -6
  166. package/dest/messaging/l2_to_l1_membership.d.ts.map +1 -1
  167. package/dest/messaging/l2_to_l1_membership.js +69 -26
  168. package/dest/noir/index.d.ts +3 -3
  169. package/dest/noir/index.d.ts.map +1 -1
  170. package/dest/p2p/attestation_utils.d.ts +11 -1
  171. package/dest/p2p/attestation_utils.d.ts.map +1 -1
  172. package/dest/p2p/attestation_utils.js +45 -0
  173. package/dest/p2p/block_proposal.d.ts +2 -2
  174. package/dest/p2p/block_proposal.d.ts.map +1 -1
  175. package/dest/p2p/block_proposal.js +1 -1
  176. package/dest/p2p/checkpoint_proposal.d.ts +2 -7
  177. package/dest/p2p/checkpoint_proposal.d.ts.map +1 -1
  178. package/dest/p2p/checkpoint_proposal.js +14 -24
  179. package/dest/p2p/client_type.d.ts +2 -5
  180. package/dest/p2p/client_type.d.ts.map +1 -1
  181. package/dest/p2p/client_type.js +0 -7
  182. package/dest/p2p/index.d.ts +1 -2
  183. package/dest/p2p/index.d.ts.map +1 -1
  184. package/dest/p2p/index.js +0 -1
  185. package/dest/p2p/peer_error.d.ts +3 -1
  186. package/dest/p2p/peer_error.d.ts.map +1 -1
  187. package/dest/p2p/peer_error.js +5 -0
  188. package/dest/p2p/topic_type.d.ts +3 -4
  189. package/dest/p2p/topic_type.d.ts.map +1 -1
  190. package/dest/p2p/topic_type.js +7 -24
  191. package/dest/proofs/chonk_proof.d.ts +46 -2
  192. package/dest/proofs/chonk_proof.d.ts.map +1 -1
  193. package/dest/proofs/chonk_proof.js +85 -10
  194. package/dest/slashing/tally.d.ts +7 -2
  195. package/dest/slashing/tally.d.ts.map +1 -1
  196. package/dest/slashing/tally.js +30 -2
  197. package/dest/tests/factories.d.ts +4 -4
  198. package/dest/tests/factories.d.ts.map +1 -1
  199. package/dest/tests/factories.js +8 -27
  200. package/dest/tests/mocks.d.ts +5 -3
  201. package/dest/tests/mocks.d.ts.map +1 -1
  202. package/dest/tests/mocks.js +18 -13
  203. package/dest/tx/block_header.d.ts +3 -1
  204. package/dest/tx/block_header.d.ts.map +1 -1
  205. package/dest/tx/block_header.js +4 -0
  206. package/dest/tx/private_execution_result.d.ts +6 -6
  207. package/dest/tx/private_execution_result.d.ts.map +1 -1
  208. package/dest/tx/private_execution_result.js +6 -6
  209. package/dest/tx/profiling.d.ts +14 -2
  210. package/dest/tx/profiling.d.ts.map +1 -1
  211. package/dest/tx/profiling.js +13 -3
  212. package/dest/tx/public_simulation_output.d.ts +4 -2
  213. package/dest/tx/public_simulation_output.d.ts.map +1 -1
  214. package/dest/tx/public_simulation_output.js +7 -3
  215. package/dest/tx/simulated_tx.d.ts +113 -2
  216. package/dest/tx/simulated_tx.d.ts.map +1 -1
  217. package/dest/tx/simulated_tx.js +4 -1
  218. package/dest/tx/tx.d.ts +6 -5
  219. package/dest/tx/tx.d.ts.map +1 -1
  220. package/dest/tx/tx.js +18 -6
  221. package/dest/tx/tx_receipt.d.ts +22 -3
  222. package/dest/tx/tx_receipt.d.ts.map +1 -1
  223. package/dest/tx/tx_receipt.js +15 -4
  224. package/dest/tx/validator/error_texts.d.ts +9 -1
  225. package/dest/tx/validator/error_texts.d.ts.map +1 -1
  226. package/dest/tx/validator/error_texts.js +10 -0
  227. package/dest/update-checker/index.d.ts +3 -2
  228. package/dest/update-checker/index.d.ts.map +1 -1
  229. package/dest/update-checker/index.js +2 -1
  230. package/dest/update-checker/package_version.d.ts +3 -0
  231. package/dest/update-checker/package_version.d.ts.map +1 -0
  232. package/dest/update-checker/package_version.js +24 -0
  233. package/dest/update-checker/version_checker.d.ts +25 -0
  234. package/dest/update-checker/version_checker.d.ts.map +1 -0
  235. package/dest/update-checker/version_checker.js +50 -0
  236. package/dest/validators/errors.d.ts +6 -1
  237. package/dest/validators/errors.d.ts.map +1 -1
  238. package/dest/validators/errors.js +7 -0
  239. package/dest/versioning/versioning.d.ts +4 -2
  240. package/dest/versioning/versioning.d.ts.map +1 -1
  241. package/dest/versioning/versioning.js +4 -1
  242. package/package.json +12 -11
  243. package/src/abi/abi.ts +25 -2
  244. package/src/abi/buffer.ts +25 -4
  245. package/src/abi/decoder.ts +15 -6
  246. package/src/abi/encoder.ts +49 -6
  247. package/src/abi/event_metadata_definition.ts +2 -0
  248. package/src/abi/utils.ts +25 -0
  249. package/src/avm/revert_code.ts +15 -0
  250. package/src/block/l2_block.ts +13 -1
  251. package/src/block/l2_block_source.ts +16 -7
  252. package/src/block/l2_block_stream/l2_block_stream.ts +21 -0
  253. package/src/checkpoint/checkpoint.ts +12 -3
  254. package/src/checkpoint/index.ts +1 -0
  255. package/src/checkpoint/validate.ts +230 -0
  256. package/src/config/index.ts +1 -0
  257. package/src/config/pipelining-config.ts +31 -0
  258. package/src/config/sequencer-config.ts +9 -1
  259. package/src/contract/contract_address.ts +3 -3
  260. package/src/contract/contract_class.ts +3 -3
  261. package/src/contract/contract_class_id.ts +2 -2
  262. package/src/contract/index.ts +0 -2
  263. package/src/contract/interfaces/contract_class.ts +2 -82
  264. package/src/epoch-helpers/index.ts +14 -0
  265. package/src/gas/README.md +123 -0
  266. package/src/gas/gas_fees.ts +7 -1
  267. package/src/ha-signing/config.ts +156 -0
  268. package/src/ha-signing/index.ts +27 -0
  269. package/src/ha-signing/local_config.ts +46 -0
  270. package/src/ha-signing/types.ts +112 -0
  271. package/src/hash/hash.ts +29 -0
  272. package/src/interfaces/allowed_element.ts +29 -9
  273. package/src/interfaces/archiver.ts +3 -2
  274. package/src/interfaces/aztec-node.ts +24 -5
  275. package/src/interfaces/block-builder.ts +60 -14
  276. package/src/interfaces/configs.ts +25 -8
  277. package/src/interfaces/l2_logs_source.ts +4 -1
  278. package/src/interfaces/merkle_tree_operations.ts +8 -18
  279. package/src/interfaces/p2p.ts +2 -13
  280. package/src/interfaces/prover-client.ts +8 -0
  281. package/src/interfaces/validator.ts +50 -28
  282. package/src/interfaces/world_state.ts +4 -3
  283. package/src/kernel/hints/build_note_hash_read_request_hints.ts +14 -18
  284. package/src/kernel/hints/build_nullifier_read_request_hints.ts +15 -18
  285. package/src/kernel/hints/build_transient_data_hints.ts +17 -2
  286. package/src/kernel/private_kernel_tail_circuit_public_inputs.ts +9 -0
  287. package/src/kv-store/config.ts +36 -0
  288. package/src/kv-store/index.ts +1 -0
  289. package/src/logs/debug_log_store.ts +54 -0
  290. package/src/logs/{directional_app_tagging_secret.ts → extended_directional_app_tagging_secret.ts} +24 -16
  291. package/src/logs/index.ts +3 -1
  292. package/src/logs/log_filter.ts +5 -0
  293. package/src/logs/pre_tag.ts +5 -5
  294. package/src/logs/public_log.ts +4 -2
  295. package/src/logs/siloed_tag.ts +8 -2
  296. package/src/logs/tag.ts +1 -1
  297. package/src/logs/tagging_index_range.ts +24 -0
  298. package/src/logs/tx_scoped_l2_log.ts +16 -0
  299. package/src/messaging/l1_to_l2_message.ts +12 -9
  300. package/src/messaging/l1_to_l2_message_source.ts +3 -1
  301. package/src/messaging/l2_to_l1_membership.ts +98 -33
  302. package/src/noir/index.ts +2 -2
  303. package/src/p2p/attestation_utils.ts +56 -0
  304. package/src/p2p/block_proposal.ts +1 -1
  305. package/src/p2p/checkpoint_proposal.ts +24 -38
  306. package/src/p2p/client_type.ts +0 -6
  307. package/src/p2p/index.ts +0 -1
  308. package/src/p2p/peer_error.ts +7 -0
  309. package/src/p2p/topic_type.ts +8 -15
  310. package/src/proofs/chonk_proof.ts +91 -5
  311. package/src/slashing/tally.ts +34 -1
  312. package/src/tests/factories.ts +9 -33
  313. package/src/tests/mocks.ts +25 -10
  314. package/src/tx/block_header.ts +6 -0
  315. package/src/tx/private_execution_result.ts +5 -5
  316. package/src/tx/profiling.ts +11 -2
  317. package/src/tx/public_simulation_output.ts +4 -0
  318. package/src/tx/simulated_tx.ts +8 -1
  319. package/src/tx/tx.ts +20 -11
  320. package/src/tx/tx_receipt.ts +17 -2
  321. package/src/tx/validator/error_texts.ts +12 -0
  322. package/src/update-checker/index.ts +2 -1
  323. package/src/update-checker/package_version.ts +30 -0
  324. package/src/update-checker/version_checker.ts +65 -0
  325. package/src/validators/errors.ts +9 -0
  326. package/src/versioning/versioning.ts +4 -1
  327. package/dest/contract/private_function_membership_proof.d.ts +0 -32
  328. package/dest/contract/private_function_membership_proof.d.ts.map +0 -1
  329. package/dest/contract/private_function_membership_proof.js +0 -124
  330. package/dest/contract/utility_function_membership_proof.d.ts +0 -27
  331. package/dest/contract/utility_function_membership_proof.d.ts.map +0 -1
  332. package/dest/contract/utility_function_membership_proof.js +0 -87
  333. package/dest/logs/directional_app_tagging_secret.d.ts +0 -40
  334. package/dest/logs/directional_app_tagging_secret.d.ts.map +0 -1
  335. package/dest/update-checker/update-checker.d.ts +0 -49
  336. package/dest/update-checker/update-checker.d.ts.map +0 -1
  337. package/dest/update-checker/update-checker.js +0 -130
  338. package/src/contract/private_function_membership_proof.ts +0 -167
  339. package/src/contract/utility_function_membership_proof.ts +0 -118
  340. package/src/update-checker/update-checker.ts +0 -166
@@ -3,6 +3,9 @@ import type { EpochNumber } from '@aztec/foundation/branded-types';
3
3
  import { Fr } from '@aztec/foundation/curves/bn254';
4
4
  import { SiblingPath, UnbalancedMerkleTreeCalculator, computeUnbalancedShaRoot } from '@aztec/foundation/trees';
5
5
 
6
+ import type { AztecNode } from '../interfaces/aztec-node.js';
7
+ import { TxHash } from '../tx/tx_hash.js';
8
+
6
9
  /**
7
10
  * # L2-to-L1 Message Tree Structure and Leaf IDs
8
11
  *
@@ -92,59 +95,94 @@ export function getL2ToL1MessageLeafId(
92
95
  return 2n ** BigInt(membershipWitness.siblingPath.pathSize) + membershipWitness.leafIndex;
93
96
  }
94
97
 
95
- export interface MessageRetrieval {
96
- getL2ToL1Messages(epoch: EpochNumber): Promise<Fr[][][][]>;
97
- }
98
-
99
98
  export type L2ToL1MembershipWitness = {
100
99
  root: Fr;
101
100
  leafIndex: bigint;
102
101
  siblingPath: SiblingPath<number>;
102
+ epochNumber: EpochNumber;
103
103
  };
104
104
 
105
+ /**
106
+ * Computes the L2 to L1 membership witness for a given message in a transaction.
107
+ *
108
+ * @param node - The Aztec node to query for block/tx/epoch data.
109
+ * @param message - The L2 to L1 message hash to prove membership of.
110
+ * @param txHash - The hash of the transaction that emitted the message.
111
+ * @param messageIndexInTx - Optional index of the message within the transaction's L2-to-L1 messages.
112
+ * If not provided, the message is found by scanning the tx's messages (throws if duplicates exist).
113
+ * @returns The membership witness and epoch number, or undefined if the tx is not yet in a block/epoch.
114
+ */
105
115
  export async function computeL2ToL1MembershipWitness(
106
- messageRetriever: MessageRetrieval,
107
- epoch: EpochNumber,
116
+ node: Pick<
117
+ AztecNode,
118
+ 'getL2ToL1Messages' | 'getTxReceipt' | 'getTxEffect' | 'getBlock' | 'getCheckpointsDataForEpoch'
119
+ >,
108
120
  message: Fr,
121
+ txHash: TxHash,
122
+ messageIndexInTx?: number,
109
123
  ): Promise<L2ToL1MembershipWitness | undefined> {
110
- const messagesInEpoch = await messageRetriever.getL2ToL1Messages(epoch);
111
- if (messagesInEpoch.length === 0) {
124
+ const { epochNumber, blockNumber } = await node.getTxReceipt(txHash);
125
+ if (epochNumber === undefined || blockNumber === undefined) {
126
+ return undefined;
127
+ }
128
+
129
+ const [messagesInEpoch, block, txEffect, checkpointsData] = await Promise.all([
130
+ node.getL2ToL1Messages(epochNumber),
131
+ node.getBlock(blockNumber),
132
+ node.getTxEffect(txHash),
133
+ node.getCheckpointsDataForEpoch(epochNumber),
134
+ ]);
135
+
136
+ if (messagesInEpoch.length === 0 || !block || !txEffect) {
137
+ return undefined;
138
+ }
139
+
140
+ const checkpointIndex = checkpointsData.findIndex(c => c.checkpointNumber === block.checkpointNumber);
141
+ if (checkpointIndex === -1) {
112
142
  return undefined;
113
143
  }
114
144
 
115
- return computeL2ToL1MembershipWitnessFromMessagesInEpoch(messagesInEpoch, message);
145
+ const blockIndex = block.indexWithinCheckpoint;
146
+ const txIndex = txEffect.txIndexInBlock;
147
+
148
+ const { root, leafIndex, siblingPath } = computeL2ToL1MembershipWitnessFromMessagesInEpoch(
149
+ messagesInEpoch,
150
+ message,
151
+ checkpointIndex,
152
+ blockIndex,
153
+ txIndex,
154
+ messageIndexInTx,
155
+ );
156
+ return { epochNumber, root, leafIndex, siblingPath };
116
157
  }
117
158
 
118
- // TODO: Allow to specify the message to consume by its index or by an offset, in case there are multiple messages with
119
- // the same value.
159
+ /**
160
+ * Computes a membership witness for a message in the epoch's L2-to-L1 message tree, given explicit position indices.
161
+ *
162
+ * @param messagesInEpoch - All L2-to-L1 messages in the epoch, organized as checkpoints → blocks → txs → messages.
163
+ * @param message - The message hash to prove membership of.
164
+ * @param checkpointIndex - Index of the checkpoint within the epoch's message array.
165
+ * @param blockIndex - Index of the block within the checkpoint.
166
+ * @param txIndex - Index of the transaction within the block.
167
+ * @param messageIndexInTx - Optional index of the message within the transaction's messages.
168
+ * If not provided, the message is found by scanning (throws if duplicates exist within the tx).
169
+ */
170
+ /** @internal Exported for testing only. */
120
171
  export function computeL2ToL1MembershipWitnessFromMessagesInEpoch(
121
172
  messagesInEpoch: Fr[][][][],
122
173
  message: Fr,
123
- ): L2ToL1MembershipWitness {
124
- // Find the index of the message in the tx, index of the tx in the block, and index of the block in the epoch.
125
- let messageIndexInTx = -1;
126
- let txIndex = -1;
127
- let blockIndex = -1;
128
- const checkpointIndex = messagesInEpoch.findIndex(messagesInCheckpoint => {
129
- blockIndex = messagesInCheckpoint.findIndex(messagesInBlock => {
130
- txIndex = messagesInBlock.findIndex(messagesInTx => {
131
- messageIndexInTx = messagesInTx.findIndex(msg => msg.equals(message));
132
- return messageIndexInTx !== -1;
133
- });
134
- return txIndex !== -1;
135
- });
136
- return blockIndex !== -1;
137
- });
138
-
139
- if (checkpointIndex === -1) {
140
- throw new Error('The L2ToL1Message you are trying to prove inclusion of does not exist');
141
- }
174
+ checkpointIndex: number,
175
+ blockIndex: number,
176
+ txIndex: number,
177
+ messageIndexInTx?: number,
178
+ ): { root: Fr; leafIndex: bigint; siblingPath: SiblingPath<number> } {
179
+ const messagesInTx = messagesInEpoch[checkpointIndex][blockIndex][txIndex];
180
+ const resolvedMessageIndex = resolveMessageIndex(messagesInTx, message, messageIndexInTx);
142
181
 
143
182
  // Build the tx tree.
144
- const messagesInTx = messagesInEpoch[checkpointIndex][blockIndex][txIndex];
145
183
  const txTree = UnbalancedMerkleTreeCalculator.create(messagesInTx.map(msg => msg.toBuffer()));
146
184
  // Get the sibling path of the target message in the tx tree.
147
- const pathToMessageInTxSubtree = txTree.getSiblingPathByLeafIndex(messageIndexInTx);
185
+ const pathToMessageInTxSubtree = txTree.getSiblingPathByLeafIndex(resolvedMessageIndex);
148
186
 
149
187
  // Build the tree of the block containing the target message.
150
188
  const blockTree = buildBlockTree(messagesInEpoch[checkpointIndex][blockIndex]);
@@ -189,7 +227,7 @@ export function computeL2ToL1MembershipWitnessFromMessagesInEpoch(
189
227
  // Compute the combined index.
190
228
  // It is the index of the message in the balanced tree (by filling up the wonky tree with empty nodes) at its current
191
229
  // height. It's used to validate the membership proof.
192
- const messageLeafPosition = txTree.getLeafLocation(messageIndexInTx);
230
+ const messageLeafPosition = txTree.getLeafLocation(resolvedMessageIndex);
193
231
  const txLeafPosition = blockTree.getLeafLocation(txIndex);
194
232
  const blockLeafPosition = checkpointTree.getLeafLocation(blockIndex);
195
233
  const checkpointLeafPosition = epochTree.getLeafLocation(checkpointIndex);
@@ -207,6 +245,33 @@ export function computeL2ToL1MembershipWitnessFromMessagesInEpoch(
207
245
  };
208
246
  }
209
247
 
248
+ function resolveMessageIndex(messagesInTx: Fr[], message: Fr, messageIndexInTx?: number): number {
249
+ if (messageIndexInTx !== undefined) {
250
+ if (!messagesInTx[messageIndexInTx]?.equals(message)) {
251
+ throw new Error(`Message at index ${messageIndexInTx} in tx does not match the expected message ${message}`);
252
+ }
253
+ return messageIndexInTx;
254
+ }
255
+
256
+ const indices = messagesInTx.reduce<number[]>((acc, msg, i) => {
257
+ if (msg.equals(message)) {
258
+ acc.push(i);
259
+ }
260
+ return acc;
261
+ }, []);
262
+
263
+ if (indices.length === 0) {
264
+ throw new Error('The L2ToL1Message you are trying to prove inclusion of does not exist');
265
+ }
266
+ if (indices.length > 1) {
267
+ throw new Error(
268
+ `Multiple messages with the same value ${message} found in tx (indices: ${indices.join(', ')}). ` +
269
+ `Provide messageIndexInTx to disambiguate.`,
270
+ );
271
+ }
272
+ return indices[0];
273
+ }
274
+
210
275
  function buildCheckpointTree(messagesInCheckpoint: Fr[][][]) {
211
276
  const blockOutHashes = messagesInCheckpoint.map(messagesInBlock => buildBlockTree(messagesInBlock).getRoot());
212
277
  return buildCompressedTree(blockOutHashes);
package/src/noir/index.ts CHANGED
@@ -19,7 +19,7 @@ export const AZTEC_VIEW_ATTRIBUTE = 'abi_view';
19
19
  export interface NoirFunctionAbi {
20
20
  /** The parameters of the function. */
21
21
  parameters: ABIParameter[];
22
- /** The return type of the function. */
22
+ /** The return type of the function, or null for void functions. */
23
23
  return_type: {
24
24
  /**
25
25
  * The type of the return value.
@@ -29,7 +29,7 @@ export interface NoirFunctionAbi {
29
29
  * The visibility of the return value.
30
30
  */
31
31
  visibility: ABIParameterVisibility;
32
- };
32
+ } | null;
33
33
  /** Mapping of error selector => error type */
34
34
  error_types: Partial<Record<string, AbiErrorType>>;
35
35
  }
@@ -33,3 +33,59 @@ export function orderAttestations(
33
33
 
34
34
  return orderedAttestations;
35
35
  }
36
+
37
+ /**
38
+ * Trims attestations to the minimum required number to save L1 calldata gas.
39
+ * Each signature costs 65 bytes of calldata vs 20 bytes for just an address.
40
+ *
41
+ * Priority order for keeping attestations:
42
+ * 1. The proposer's attestation (required by L1 contract - MissingProposerSignature revert)
43
+ * 2. Attestations from the local node's validator keys
44
+ * 3. Remaining attestations filled to reach the required count
45
+ */
46
+ export function trimAttestations(
47
+ attestations: CheckpointAttestation[],
48
+ required: number,
49
+ proposerAddress: EthAddress,
50
+ localAddresses: EthAddress[],
51
+ ): CheckpointAttestation[] {
52
+ if (attestations.length <= required) {
53
+ return attestations;
54
+ }
55
+
56
+ const proposerAttestation: CheckpointAttestation[] = [];
57
+ const localAttestations: CheckpointAttestation[] = [];
58
+ const otherAttestations: CheckpointAttestation[] = [];
59
+
60
+ for (const attestation of attestations) {
61
+ const sender = attestation.getSender();
62
+ if (!sender) {
63
+ continue;
64
+ }
65
+ if (sender.equals(proposerAddress)) {
66
+ proposerAttestation.push(attestation);
67
+ } else if (localAddresses.some(addr => addr.equals(sender))) {
68
+ localAttestations.push(attestation);
69
+ } else {
70
+ otherAttestations.push(attestation);
71
+ }
72
+ }
73
+
74
+ const result: CheckpointAttestation[] = [...proposerAttestation];
75
+
76
+ for (const att of localAttestations) {
77
+ if (result.length >= required) {
78
+ break;
79
+ }
80
+ result.push(att);
81
+ }
82
+
83
+ for (const att of otherAttestations) {
84
+ if (result.length >= required) {
85
+ break;
86
+ }
87
+ result.push(att);
88
+ }
89
+
90
+ return result;
91
+ }
@@ -6,11 +6,11 @@ import { Fr } from '@aztec/foundation/curves/bn254';
6
6
  import type { EthAddress } from '@aztec/foundation/eth-address';
7
7
  import { Signature } from '@aztec/foundation/eth-signature';
8
8
  import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize';
9
- import { DutyType, type SigningContext } from '@aztec/validator-ha-signer/types';
10
9
 
11
10
  import type { L2Block } from '../block/l2_block.js';
12
11
  import type { L2BlockInfo } from '../block/l2_block_info.js';
13
12
  import { MAX_TXS_PER_BLOCK } from '../deserialization/index.js';
13
+ import { DutyType, type SigningContext } from '../ha-signing/index.js';
14
14
  import { BlockHeader } from '../tx/block_header.js';
15
15
  import { TxHash } from '../tx/index.js';
16
16
  import type { Tx } from '../tx/tx.js';
@@ -6,10 +6,10 @@ import { Fr } from '@aztec/foundation/curves/bn254';
6
6
  import type { EthAddress } from '@aztec/foundation/eth-address';
7
7
  import { Signature } from '@aztec/foundation/eth-signature';
8
8
  import { BufferReader, serializeSignedBigInt, serializeToBuffer } from '@aztec/foundation/serialize';
9
- import { DutyType, type SigningContext } from '@aztec/validator-ha-signer/types';
10
9
 
11
10
  import type { L2BlockInfo } from '../block/l2_block_info.js';
12
11
  import { MAX_TXS_PER_BLOCK } from '../deserialization/index.js';
12
+ import { DutyType, type SigningContext } from '../ha-signing/index.js';
13
13
  import { CheckpointHeader } from '../rollup/checkpoint_header.js';
14
14
  import { BlockHeader } from '../tx/block_header.js';
15
15
  import { TxHash } from '../tx/index.js';
@@ -101,23 +101,6 @@ export class CheckpointProposal extends Gossipable {
101
101
  return this.checkpointHeader.slotNumber;
102
102
  }
103
103
 
104
- get blockNumber(): BlockNumber {
105
- if (!this.lastBlock) {
106
- throw new Error('Cannot get blockNumber without lastBlock');
107
- }
108
- return this.lastBlock.blockHeader.getBlockNumber();
109
- }
110
-
111
- /** Convenience getter for txHashes from lastBlock */
112
- get txHashes(): TxHash[] {
113
- return this.lastBlock?.txHashes ?? [];
114
- }
115
-
116
- /** Convenience getter for txs from lastBlock */
117
- get txs(): Tx[] | undefined {
118
- return this.lastBlock?.signedTxs?.txs;
119
- }
120
-
121
104
  /**
122
105
  * Extract a BlockProposal from the last block info.
123
106
  * Uses inHash from checkpointHeader.contentCommitment.inHash
@@ -195,29 +178,32 @@ export class CheckpointProposal extends Gossipable {
195
178
  blockNumber: lastBlockInfo?.blockHeader?.globalVariables.blockNumber ?? BlockNumber(0),
196
179
  dutyType: DutyType.CHECKPOINT_PROPOSAL,
197
180
  };
198
- const checkpointSignature = await payloadSigner(checkpointHash, checkpointContext);
199
181
 
200
- if (!lastBlockInfo) {
201
- return new CheckpointProposal(checkpointHeader, archiveRoot, feeAssetPriceModifier, checkpointSignature);
182
+ if (lastBlockInfo) {
183
+ // Sign block proposal before signing checkpoint proposal to ensure HA protection
184
+ const lastBlockProposal = await BlockProposal.createProposalFromSigner(
185
+ lastBlockInfo.blockHeader,
186
+ lastBlockInfo.indexWithinCheckpoint,
187
+ checkpointHeader.inHash,
188
+ archiveRoot,
189
+ lastBlockInfo.txHashes,
190
+ lastBlockInfo.txs,
191
+ payloadSigner,
192
+ );
193
+
194
+ const checkpointSignature = await payloadSigner(checkpointHash, checkpointContext);
195
+
196
+ return new CheckpointProposal(checkpointHeader, archiveRoot, feeAssetPriceModifier, checkpointSignature, {
197
+ blockHeader: lastBlockInfo.blockHeader,
198
+ indexWithinCheckpoint: lastBlockInfo.indexWithinCheckpoint,
199
+ txHashes: lastBlockInfo.txHashes,
200
+ signature: lastBlockProposal.signature,
201
+ signedTxs: lastBlockProposal.signedTxs,
202
+ });
202
203
  }
203
204
 
204
- const lastBlockProposal = await BlockProposal.createProposalFromSigner(
205
- lastBlockInfo.blockHeader,
206
- lastBlockInfo.indexWithinCheckpoint,
207
- checkpointHeader.inHash,
208
- archiveRoot,
209
- lastBlockInfo.txHashes,
210
- lastBlockInfo.txs,
211
- payloadSigner,
212
- );
213
-
214
- return new CheckpointProposal(checkpointHeader, archiveRoot, feeAssetPriceModifier, checkpointSignature, {
215
- blockHeader: lastBlockInfo.blockHeader,
216
- indexWithinCheckpoint: lastBlockInfo.indexWithinCheckpoint,
217
- txHashes: lastBlockInfo.txHashes,
218
- signature: lastBlockProposal.signature,
219
- signedTxs: lastBlockProposal.signedTxs,
220
- });
205
+ const checkpointSignature = await payloadSigner(checkpointHash, checkpointContext);
206
+ return new CheckpointProposal(checkpointHeader, archiveRoot, feeAssetPriceModifier, checkpointSignature);
221
207
  }
222
208
 
223
209
  /**
@@ -1,6 +0,0 @@
1
- export enum P2PClientType {
2
- // Full p2p clients will subscribe to all gossip topics
3
- Full,
4
- // Prove p2p clients will only subscribe to transaction and proving topics
5
- Prover,
6
- }
package/src/p2p/index.ts CHANGED
@@ -8,7 +8,6 @@ export * from './interface.js';
8
8
  export * from './signature_utils.js';
9
9
  export * from './signed_txs.js';
10
10
  export * from './topic_type.js';
11
- export * from './client_type.js';
12
11
  export * from './message_validator.js';
13
12
  export * from './peer_error.js';
14
13
  export * from './constants.js';
@@ -15,3 +15,10 @@ export enum PeerErrorSeverity {
15
15
  */
16
16
  HighToleranceError = 'HighToleranceError',
17
17
  }
18
+
19
+ /** Severities ordered from mildest to harshest. */
20
+ export const PeerErrorSeverityByHarshness = [
21
+ PeerErrorSeverity.HighToleranceError,
22
+ PeerErrorSeverity.MidToleranceError,
23
+ PeerErrorSeverity.LowToleranceError,
24
+ ] as const;
@@ -1,5 +1,3 @@
1
- import { P2PClientType } from './client_type.js';
2
-
3
1
  /**
4
2
  * Creates the topic channel identifier string from a given topic type
5
3
  */
@@ -27,19 +25,14 @@ export enum TopicType {
27
25
  checkpoint_attestation = 'checkpoint_attestation',
28
26
  }
29
27
 
30
- export function getTopicTypeForClientType(clientType: P2PClientType) {
31
- if (clientType === P2PClientType.Full) {
32
- return [TopicType.tx, TopicType.block_proposal, TopicType.checkpoint_proposal, TopicType.checkpoint_attestation];
33
- } else if (clientType === P2PClientType.Prover) {
34
- return [TopicType.tx, TopicType.block_proposal, TopicType.checkpoint_proposal];
35
- } else {
36
- const _: never = clientType;
37
- return [TopicType.tx];
38
- }
39
- }
40
-
41
- export function getTopicsForClientAndConfig(clientType: P2PClientType, disableTransactions: boolean) {
42
- const topics = getTopicTypeForClientType(clientType);
28
+ /** Returns all gossip topics, optionally filtering out transactions. */
29
+ export function getTopicsForConfig(disableTransactions: boolean) {
30
+ const topics = [
31
+ TopicType.tx,
32
+ TopicType.block_proposal,
33
+ TopicType.checkpoint_proposal,
34
+ TopicType.checkpoint_attestation,
35
+ ];
43
36
  if (disableTransactions) {
44
37
  return topics.filter(topic => topic !== TopicType.tx);
45
38
  }
@@ -1,21 +1,41 @@
1
+ import { BarretenbergSync, flattenChonkProofFields } from '@aztec/bb.js';
1
2
  import { CHONK_PROOF_LENGTH } from '@aztec/constants';
2
3
  import { times } from '@aztec/foundation/collection';
3
4
  import { randomBytes } from '@aztec/foundation/crypto/random';
4
5
  import { Fr } from '@aztec/foundation/curves/bn254';
5
6
  import { bufferSchemaFor } from '@aztec/foundation/schemas';
6
- import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize';
7
+ import { BufferReader, numToUInt32BE, serializeToBuffer } from '@aztec/foundation/serialize';
8
+
9
+ /**
10
+ * Serialization format detection for ChonkProof is size-based:
11
+ * - UNCOMPRESSED (legacy): [field_count=1632: uint32] [fields...] → total ≈ 52KB (>= 40KB)
12
+ * - COMPRESSED: [byte_count: uint32] [compressed_bytes] → total ≈ 35KB (< 40KB)
13
+ *
14
+ * Detection: if the first uint32 equals CHONK_PROOF_LENGTH (1632), it's legacy format
15
+ * (field count). Otherwise, it's compressed format (byte count). The old uncompressed
16
+ * format is never smaller than 40KB; compressed proofs are always smaller than 40KB.
17
+ */
7
18
 
8
19
  // CHONK: "Client Honk" - An UltraHonk variant with incremental folding and delayed non-native arithmetic.
9
20
  export class ChonkProof {
21
+ /**
22
+ * Optional compressed proof bytes from chonk compression (point compression + u256 encoding).
23
+ * When set, toBuffer() will serialize in compressed format (~1.7x smaller).
24
+ * When reading from compressed format, this is populated and fields are decompressed on demand.
25
+ */
26
+ public compressedProof?: Buffer;
27
+
10
28
  constructor(
11
29
  // The proof fields.
12
30
  // For native verification, attach public inputs via `attachPublicInputs(publicInputs)`.
13
31
  // Not using Tuple here due to the length being too high.
14
32
  public fields: Fr[],
33
+ compressedProof?: Buffer,
15
34
  ) {
16
35
  if (fields.length !== CHONK_PROOF_LENGTH) {
17
36
  throw new Error(`Invalid ChonkProof length: ${fields.length}`);
18
37
  }
38
+ this.compressedProof = compressedProof;
19
39
  }
20
40
 
21
41
  public attachPublicInputs(publicInputs: Fr[]) {
@@ -53,19 +73,84 @@ export class ChonkProof {
53
73
  return this.toBuffer();
54
74
  }
55
75
 
76
+ /**
77
+ * Deserialize a ChonkProof from a buffer.
78
+ * Supports both legacy (field elements) and compressed (chonk compression) formats.
79
+ *
80
+ * Size-based format detection:
81
+ * - First uint32 == CHONK_PROOF_LENGTH (1632): legacy format, read field elements
82
+ * Total proof data ≈ 52KB (always >= 40KB)
83
+ * - Otherwise: compressed format, first uint32 is byte count of compressed data
84
+ * Total proof data ≈ 35KB (always < 40KB)
85
+ */
56
86
  static fromBuffer(buffer: Buffer | BufferReader): ChonkProof {
57
87
  const reader = BufferReader.asReader(buffer);
58
- const proofLength = reader.readNumber();
59
- const proof = reader.readArray(proofLength, Fr);
60
- return new ChonkProof(proof);
88
+ const firstUint32 = reader.readNumber();
89
+
90
+ if (firstUint32 === CHONK_PROOF_LENGTH) {
91
+ // Legacy format: firstUint32 is the field count (1632)
92
+ // Widen to `number` to prevent TS from narrowing to literal 1632,
93
+ // which would cause Tuple<Fr, 1632> to exceed the recursion limit.
94
+ const fieldCount: number = firstUint32;
95
+ const proof = reader.readArray(fieldCount, Fr);
96
+ return new ChonkProof(proof);
97
+ }
98
+
99
+ // Compressed format: firstUint32 is the compressed byte count
100
+ const compressedBytes = reader.readBytes(firstUint32);
101
+ return ChonkProof.fromCompressedBytes(Buffer.from(compressedBytes));
102
+ }
103
+
104
+ /**
105
+ * Create a ChonkProof from compressed bytes by decompressing via the BarretenbergSync API.
106
+ * The compressed format uses point compression and u256 encoding (from PR #20645).
107
+ *
108
+ * @param compressed - Compressed proof bytes from chonk compression
109
+ * @returns ChonkProof with both fields and compressed bytes populated
110
+ */
111
+ static fromCompressedBytes(compressed: Buffer): ChonkProof {
112
+ const api = BarretenbergSync.getSingleton();
113
+ const result = api.chonkDecompressProof({ compressedProof: new Uint8Array(compressed) });
114
+
115
+ // Flatten the structured bb.js ChonkProof into flat Fr[] field elements
116
+ const flatFields = flattenChonkProofFields(result.proof);
117
+ const fields = flatFields.map(f => Fr.fromBuffer(Buffer.from(f)));
118
+
119
+ // The decompressed proof includes public inputs in hidingOinkProof.
120
+ // Since ChonkProof stores fields WITHOUT public inputs, strip them.
121
+ // The number of public inputs = total fields - CHONK_PROOF_LENGTH
122
+ if (fields.length > CHONK_PROOF_LENGTH) {
123
+ const numPubInputs = fields.length - CHONK_PROOF_LENGTH;
124
+ const proofFields = fields.slice(numPubInputs);
125
+ return new ChonkProof(proofFields, compressed);
126
+ }
127
+
128
+ return new ChonkProof(fields, compressed);
61
129
  }
62
130
 
131
+ /**
132
+ * Serialize the proof to a buffer.
133
+ * If compressed bytes are available, uses the compressed format (~1.7x smaller).
134
+ * Otherwise falls back to legacy field element format.
135
+ */
63
136
  public toBuffer() {
137
+ if (this.compressedProof) {
138
+ // Compressed format: [compressed_byte_count: uint32] [compressed_bytes]
139
+ return Buffer.concat([numToUInt32BE(this.compressedProof.length), this.compressedProof]);
140
+ }
141
+ // Legacy format: [field_count=1632: uint32] [fields...]
64
142
  return serializeToBuffer(this.fields.length, this.fields);
65
143
  }
66
144
  }
67
145
 
68
146
  export class ChonkProofWithPublicInputs {
147
+ /**
148
+ * Optional compressed proof bytes (covers the full proof WITH public inputs).
149
+ * Set by the prover when using chonk compression. Flows through to ChonkProof
150
+ * via removePublicInputs() so the Tx can serialize in compressed format.
151
+ */
152
+ public compressedProof?: Buffer;
153
+
69
154
  constructor(
70
155
  // The proof fields with public inputs.
71
156
  // For recursive verification, use without public inputs via `removePublicInputs()`.
@@ -83,7 +168,8 @@ export class ChonkProofWithPublicInputs {
83
168
 
84
169
  public removePublicInputs() {
85
170
  const numPublicInputs = this.fieldsWithPublicInputs.length - CHONK_PROOF_LENGTH;
86
- return new ChonkProof(this.fieldsWithPublicInputs.slice(numPublicInputs));
171
+ // Flow compressed proof bytes through so the ChonkProof can serialize efficiently
172
+ return new ChonkProof(this.fieldsWithPublicInputs.slice(numPublicInputs), this.compressedProof);
87
173
  }
88
174
 
89
175
  public isEmpty() {
@@ -1,6 +1,7 @@
1
1
  import { sumBigint } from '@aztec/foundation/bigint';
2
2
  import { padArrayEnd } from '@aztec/foundation/collection';
3
3
  import { EthAddress } from '@aztec/foundation/eth-address';
4
+ import { type Logger, createLogger } from '@aztec/foundation/log';
4
5
  import type { PartialBy } from '@aztec/foundation/types';
5
6
 
6
7
  import { getEpochForOffense } from './helpers.js';
@@ -12,6 +13,9 @@ import type { Offense, ValidatorSlashVote } from './types.js';
12
13
  * @param committees - Array of committees (each containing array of validator addresses)
13
14
  * @param epochsForCommittees - Array of epochs corresponding to each committee
14
15
  * @param settings - Settings including slashingAmounts and optional validator override lists
16
+ * @param settings.maxSlashedValidators - If set, limits the total number of [validator, epoch] pairs
17
+ * with non-zero votes. The lowest-vote pairs are zeroed out to stay within the limit.
18
+ * @param logger - Logger, logs which validators were dropped.
15
19
  * @returns Array of ValidatorSlashVote, where each vote is how many slash units the validator in that position should be slashed
16
20
  */
17
21
  export function getSlashConsensusVotesFromOffenses(
@@ -22,9 +26,11 @@ export function getSlashConsensusVotesFromOffenses(
22
26
  slashingAmounts: [bigint, bigint, bigint];
23
27
  epochDuration: number;
24
28
  targetCommitteeSize: number;
29
+ maxSlashedValidators?: number;
25
30
  },
31
+ logger: Logger = createLogger('slasher:tally'),
26
32
  ): ValidatorSlashVote[] {
27
- const { slashingAmounts, targetCommitteeSize } = settings;
33
+ const { slashingAmounts, targetCommitteeSize, maxSlashedValidators } = settings;
28
34
 
29
35
  if (committees.length !== epochsForCommittees.length) {
30
36
  throw new Error('committees and epochsForCommittees must have the same length');
@@ -53,6 +59,33 @@ export function getSlashConsensusVotesFromOffenses(
53
59
  return padArrayEnd(votes, 0, targetCommitteeSize);
54
60
  });
55
61
 
62
+ // if a cap is set, zero out the lowest-vote [validator, epoch] pairs so that the most severe slashes stay.
63
+ if (maxSlashedValidators === undefined) {
64
+ return votes;
65
+ }
66
+
67
+ const nonZeroByDescendingVote = [...votes.entries()].filter(([, vote]) => vote > 0).sort(([, a], [, b]) => b - a);
68
+
69
+ const toTruncate = nonZeroByDescendingVote.slice(maxSlashedValidators);
70
+ for (const [idx] of toTruncate) {
71
+ votes[idx] = 0;
72
+ }
73
+
74
+ if (toTruncate.length > 0) {
75
+ const truncated = toTruncate.map(([idx]) => {
76
+ const committeeIndex = Math.floor(idx / targetCommitteeSize);
77
+ const positionInCommittee = idx % targetCommitteeSize;
78
+ return {
79
+ validator: committees[committeeIndex][positionInCommittee].toString(),
80
+ epoch: epochsForCommittees[committeeIndex],
81
+ };
82
+ });
83
+ logger.warn(
84
+ `Truncated ${toTruncate.length} validator-epoch pairs to stay within limit of ${maxSlashedValidators}`,
85
+ { truncated },
86
+ );
87
+ }
88
+
56
89
  return votes;
57
90
  }
58
91