@aztec/p2p 0.0.1-commit.d3ec352c → 0.0.1-commit.d6f2b3f94

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 (533) hide show
  1. package/dest/bootstrap/bootstrap.d.ts +4 -3
  2. package/dest/bootstrap/bootstrap.d.ts.map +1 -1
  3. package/dest/bootstrap/bootstrap.js +4 -4
  4. package/dest/client/factory.d.ts +5 -5
  5. package/dest/client/factory.d.ts.map +1 -1
  6. package/dest/client/factory.js +47 -14
  7. package/dest/client/interface.d.ts +49 -18
  8. package/dest/client/interface.d.ts.map +1 -1
  9. package/dest/client/p2p_client.d.ts +42 -46
  10. package/dest/client/p2p_client.d.ts.map +1 -1
  11. package/dest/client/p2p_client.js +565 -257
  12. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker.d.ts +2 -0
  13. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker.d.ts.map +1 -0
  14. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker.js +305 -0
  15. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.d.ts +73 -0
  16. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.d.ts.map +1 -0
  17. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.js +8 -0
  18. package/dest/config.d.ts +27 -9
  19. package/dest/config.d.ts.map +1 -1
  20. package/dest/config.js +26 -15
  21. package/dest/index.d.ts +2 -1
  22. package/dest/index.d.ts.map +1 -1
  23. package/dest/index.js +1 -0
  24. package/dest/mem_pools/attestation_pool/attestation_pool.d.ts +109 -76
  25. package/dest/mem_pools/attestation_pool/attestation_pool.d.ts.map +1 -1
  26. package/dest/mem_pools/attestation_pool/attestation_pool.js +436 -3
  27. package/dest/mem_pools/attestation_pool/attestation_pool_test_suite.d.ts +2 -2
  28. package/dest/mem_pools/attestation_pool/attestation_pool_test_suite.d.ts.map +1 -1
  29. package/dest/mem_pools/attestation_pool/attestation_pool_test_suite.js +529 -289
  30. package/dest/mem_pools/attestation_pool/index.d.ts +2 -3
  31. package/dest/mem_pools/attestation_pool/index.d.ts.map +1 -1
  32. package/dest/mem_pools/attestation_pool/index.js +1 -2
  33. package/dest/mem_pools/attestation_pool/mocks.d.ts +11 -8
  34. package/dest/mem_pools/attestation_pool/mocks.d.ts.map +1 -1
  35. package/dest/mem_pools/attestation_pool/mocks.js +17 -13
  36. package/dest/mem_pools/index.d.ts +3 -2
  37. package/dest/mem_pools/index.d.ts.map +1 -1
  38. package/dest/mem_pools/index.js +1 -1
  39. package/dest/mem_pools/instrumentation.d.ts +7 -1
  40. package/dest/mem_pools/instrumentation.d.ts.map +1 -1
  41. package/dest/mem_pools/instrumentation.js +31 -13
  42. package/dest/mem_pools/interface.d.ts +6 -7
  43. package/dest/mem_pools/interface.d.ts.map +1 -1
  44. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.d.ts +35 -26
  45. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.d.ts.map +1 -1
  46. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.js +314 -335
  47. package/dest/mem_pools/tx_pool/eviction/eviction_manager.d.ts +32 -0
  48. package/dest/mem_pools/tx_pool/eviction/eviction_manager.d.ts.map +1 -0
  49. package/dest/mem_pools/tx_pool/eviction/eviction_manager.js +112 -0
  50. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.d.ts +157 -0
  51. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.d.ts.map +1 -0
  52. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.js +52 -0
  53. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.d.ts +16 -0
  54. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.d.ts.map +1 -0
  55. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.js +122 -0
  56. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.d.ts +17 -0
  57. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.d.ts.map +1 -0
  58. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.js +84 -0
  59. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.d.ts +19 -0
  60. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.d.ts.map +1 -0
  61. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.js +78 -0
  62. package/dest/mem_pools/tx_pool/eviction/low_priority_eviction_rule.d.ts +26 -0
  63. package/dest/mem_pools/tx_pool/eviction/low_priority_eviction_rule.d.ts.map +1 -0
  64. package/dest/mem_pools/tx_pool/eviction/low_priority_eviction_rule.js +84 -0
  65. package/dest/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.d.ts +25 -0
  66. package/dest/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.d.ts.map +1 -0
  67. package/dest/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.js +57 -0
  68. package/dest/mem_pools/tx_pool/index.d.ts +1 -2
  69. package/dest/mem_pools/tx_pool/index.d.ts.map +1 -1
  70. package/dest/mem_pools/tx_pool/index.js +0 -1
  71. package/dest/mem_pools/tx_pool/priority.d.ts +5 -1
  72. package/dest/mem_pools/tx_pool/priority.d.ts.map +1 -1
  73. package/dest/mem_pools/tx_pool/priority.js +6 -1
  74. package/dest/mem_pools/tx_pool/tx_pool.d.ts +8 -4
  75. package/dest/mem_pools/tx_pool/tx_pool.d.ts.map +1 -1
  76. package/dest/mem_pools/tx_pool/tx_pool_test_suite.d.ts +1 -1
  77. package/dest/mem_pools/tx_pool/tx_pool_test_suite.d.ts.map +1 -1
  78. package/dest/mem_pools/tx_pool/tx_pool_test_suite.js +25 -20
  79. package/dest/mem_pools/tx_pool_v2/archive/index.d.ts +2 -0
  80. package/dest/mem_pools/tx_pool_v2/archive/index.d.ts.map +1 -0
  81. package/dest/mem_pools/tx_pool_v2/archive/index.js +1 -0
  82. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.d.ts +43 -0
  83. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.d.ts.map +1 -0
  84. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.js +103 -0
  85. package/dest/mem_pools/tx_pool_v2/deleted_pool.d.ts +87 -0
  86. package/dest/mem_pools/tx_pool_v2/deleted_pool.d.ts.map +1 -0
  87. package/dest/mem_pools/tx_pool_v2/deleted_pool.js +180 -0
  88. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.d.ts +47 -0
  89. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.d.ts.map +1 -0
  90. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.js +119 -0
  91. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.d.ts +17 -0
  92. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.d.ts.map +1 -0
  93. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.js +90 -0
  94. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.d.ts +19 -0
  95. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.d.ts.map +1 -0
  96. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.js +89 -0
  97. package/dest/mem_pools/tx_pool_v2/eviction/index.d.ts +10 -0
  98. package/dest/mem_pools/tx_pool_v2/eviction/index.d.ts.map +1 -0
  99. package/dest/mem_pools/tx_pool_v2/eviction/index.js +11 -0
  100. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.d.ts +131 -0
  101. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.d.ts.map +1 -0
  102. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.js +17 -0
  103. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.d.ts +15 -0
  104. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.d.ts.map +1 -0
  105. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.js +63 -0
  106. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.d.ts +17 -0
  107. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.d.ts.map +1 -0
  108. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.js +91 -0
  109. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.d.ts +16 -0
  110. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.d.ts.map +1 -0
  111. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.js +70 -0
  112. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.d.ts +20 -0
  113. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.d.ts.map +1 -0
  114. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.js +63 -0
  115. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.d.ts +15 -0
  116. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.d.ts.map +1 -0
  117. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.js +19 -0
  118. package/dest/mem_pools/tx_pool_v2/index.d.ts +6 -0
  119. package/dest/mem_pools/tx_pool_v2/index.d.ts.map +1 -0
  120. package/dest/mem_pools/tx_pool_v2/index.js +5 -0
  121. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts +197 -0
  122. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts.map +1 -0
  123. package/dest/mem_pools/tx_pool_v2/interfaces.js +6 -0
  124. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts +93 -0
  125. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts.map +1 -0
  126. package/dest/mem_pools/tx_pool_v2/tx_metadata.js +127 -0
  127. package/dest/mem_pools/tx_pool_v2/tx_pool_bench_metrics.d.ts +26 -0
  128. package/dest/mem_pools/tx_pool_v2/tx_pool_bench_metrics.d.ts.map +1 -0
  129. package/dest/mem_pools/tx_pool_v2/tx_pool_bench_metrics.js +70 -0
  130. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.d.ts +99 -0
  131. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.d.ts.map +1 -0
  132. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.js +332 -0
  133. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts +55 -0
  134. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts.map +1 -0
  135. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.js +156 -0
  136. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts +69 -0
  137. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts.map +1 -0
  138. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.js +751 -0
  139. package/dest/msg_validators/attestation_validator/attestation_validator.d.ts +4 -4
  140. package/dest/msg_validators/attestation_validator/attestation_validator.d.ts.map +1 -1
  141. package/dest/msg_validators/attestation_validator/attestation_validator.js +52 -19
  142. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts +7 -7
  143. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts.map +1 -1
  144. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.js +22 -13
  145. package/dest/msg_validators/clock_tolerance.d.ts +21 -0
  146. package/dest/msg_validators/clock_tolerance.d.ts.map +1 -0
  147. package/dest/msg_validators/clock_tolerance.js +37 -0
  148. package/dest/msg_validators/index.d.ts +2 -2
  149. package/dest/msg_validators/index.d.ts.map +1 -1
  150. package/dest/msg_validators/index.js +1 -1
  151. package/dest/msg_validators/proposal_validator/block_proposal_validator.d.ts +9 -0
  152. package/dest/msg_validators/proposal_validator/block_proposal_validator.d.ts.map +1 -0
  153. package/dest/msg_validators/proposal_validator/block_proposal_validator.js +6 -0
  154. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.d.ts +9 -0
  155. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.d.ts.map +1 -0
  156. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.js +6 -0
  157. package/dest/msg_validators/proposal_validator/index.d.ts +4 -0
  158. package/dest/msg_validators/proposal_validator/index.d.ts.map +1 -0
  159. package/dest/msg_validators/proposal_validator/index.js +3 -0
  160. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts +13 -0
  161. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts.map +1 -0
  162. package/dest/msg_validators/proposal_validator/proposal_validator.js +104 -0
  163. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.d.ts +23 -0
  164. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.d.ts.map +1 -0
  165. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.js +212 -0
  166. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts +3 -3
  167. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts.map +1 -1
  168. package/dest/msg_validators/tx_validator/archive_cache.d.ts +3 -3
  169. package/dest/msg_validators/tx_validator/archive_cache.d.ts.map +1 -1
  170. package/dest/msg_validators/tx_validator/archive_cache.js +1 -1
  171. package/dest/msg_validators/tx_validator/block_header_validator.d.ts +20 -6
  172. package/dest/msg_validators/tx_validator/block_header_validator.d.ts.map +1 -1
  173. package/dest/msg_validators/tx_validator/block_header_validator.js +4 -3
  174. package/dest/msg_validators/tx_validator/data_validator.d.ts +3 -1
  175. package/dest/msg_validators/tx_validator/data_validator.d.ts.map +1 -1
  176. package/dest/msg_validators/tx_validator/data_validator.js +4 -1
  177. package/dest/msg_validators/tx_validator/double_spend_validator.d.ts +15 -4
  178. package/dest/msg_validators/tx_validator/double_spend_validator.d.ts.map +1 -1
  179. package/dest/msg_validators/tx_validator/double_spend_validator.js +7 -6
  180. package/dest/msg_validators/tx_validator/factory.d.ts +9 -4
  181. package/dest/msg_validators/tx_validator/factory.d.ts.map +1 -1
  182. package/dest/msg_validators/tx_validator/factory.js +22 -12
  183. package/dest/msg_validators/tx_validator/fee_payer_balance.d.ts +10 -0
  184. package/dest/msg_validators/tx_validator/fee_payer_balance.d.ts.map +1 -0
  185. package/dest/msg_validators/tx_validator/fee_payer_balance.js +20 -0
  186. package/dest/msg_validators/tx_validator/gas_validator.d.ts +3 -2
  187. package/dest/msg_validators/tx_validator/gas_validator.d.ts.map +1 -1
  188. package/dest/msg_validators/tx_validator/gas_validator.js +11 -16
  189. package/dest/msg_validators/tx_validator/index.d.ts +2 -1
  190. package/dest/msg_validators/tx_validator/index.d.ts.map +1 -1
  191. package/dest/msg_validators/tx_validator/index.js +1 -0
  192. package/dest/msg_validators/tx_validator/metadata_validator.d.ts +4 -3
  193. package/dest/msg_validators/tx_validator/metadata_validator.d.ts.map +1 -1
  194. package/dest/msg_validators/tx_validator/metadata_validator.js +2 -2
  195. package/dest/msg_validators/tx_validator/phases_validator.d.ts +3 -2
  196. package/dest/msg_validators/tx_validator/phases_validator.d.ts.map +1 -1
  197. package/dest/msg_validators/tx_validator/phases_validator.js +3 -3
  198. package/dest/msg_validators/tx_validator/size_validator.d.ts +8 -0
  199. package/dest/msg_validators/tx_validator/size_validator.d.ts.map +1 -0
  200. package/dest/msg_validators/tx_validator/size_validator.js +23 -0
  201. package/dest/msg_validators/tx_validator/test_utils.d.ts +2 -2
  202. package/dest/msg_validators/tx_validator/test_utils.d.ts.map +1 -1
  203. package/dest/msg_validators/tx_validator/timestamp_validator.d.ts +22 -5
  204. package/dest/msg_validators/tx_validator/timestamp_validator.d.ts.map +1 -1
  205. package/dest/msg_validators/tx_validator/timestamp_validator.js +4 -4
  206. package/dest/msg_validators/tx_validator/tx_permitted_validator.d.ts +3 -2
  207. package/dest/msg_validators/tx_validator/tx_permitted_validator.d.ts.map +1 -1
  208. package/dest/msg_validators/tx_validator/tx_permitted_validator.js +2 -2
  209. package/dest/msg_validators/tx_validator/tx_proof_validator.d.ts +3 -2
  210. package/dest/msg_validators/tx_validator/tx_proof_validator.d.ts.map +1 -1
  211. package/dest/msg_validators/tx_validator/tx_proof_validator.js +2 -2
  212. package/dest/services/data_store.d.ts +1 -1
  213. package/dest/services/data_store.d.ts.map +1 -1
  214. package/dest/services/data_store.js +10 -6
  215. package/dest/services/discv5/discV5_service.js +1 -1
  216. package/dest/services/dummy_service.d.ts +26 -2
  217. package/dest/services/dummy_service.d.ts.map +1 -1
  218. package/dest/services/dummy_service.js +48 -0
  219. package/dest/services/encoding.d.ts +2 -2
  220. package/dest/services/encoding.d.ts.map +1 -1
  221. package/dest/services/encoding.js +9 -8
  222. package/dest/services/gossipsub/index.d.ts +3 -0
  223. package/dest/services/gossipsub/index.d.ts.map +1 -0
  224. package/dest/services/gossipsub/index.js +2 -0
  225. package/dest/services/gossipsub/scoring.d.ts +21 -3
  226. package/dest/services/gossipsub/scoring.d.ts.map +1 -1
  227. package/dest/services/gossipsub/scoring.js +24 -7
  228. package/dest/services/gossipsub/topic_score_params.d.ts +161 -0
  229. package/dest/services/gossipsub/topic_score_params.d.ts.map +1 -0
  230. package/dest/services/gossipsub/topic_score_params.js +324 -0
  231. package/dest/services/index.d.ts +2 -1
  232. package/dest/services/index.d.ts.map +1 -1
  233. package/dest/services/index.js +1 -0
  234. package/dest/services/libp2p/instrumentation.d.ts +1 -1
  235. package/dest/services/libp2p/instrumentation.d.ts.map +1 -1
  236. package/dest/services/libp2p/instrumentation.js +30 -72
  237. package/dest/services/libp2p/libp2p_service.d.ts +108 -36
  238. package/dest/services/libp2p/libp2p_service.d.ts.map +1 -1
  239. package/dest/services/libp2p/libp2p_service.js +978 -320
  240. package/dest/services/peer-manager/metrics.d.ts +7 -2
  241. package/dest/services/peer-manager/metrics.d.ts.map +1 -1
  242. package/dest/services/peer-manager/metrics.js +33 -21
  243. package/dest/services/peer-manager/peer_manager.d.ts +2 -2
  244. package/dest/services/peer-manager/peer_manager.d.ts.map +1 -1
  245. package/dest/services/peer-manager/peer_manager.js +4 -12
  246. package/dest/services/peer-manager/peer_scoring.d.ts +1 -1
  247. package/dest/services/peer-manager/peer_scoring.d.ts.map +1 -1
  248. package/dest/services/peer-manager/peer_scoring.js +32 -6
  249. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts +47 -0
  250. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts.map +1 -0
  251. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.js +566 -0
  252. package/dest/services/reqresp/batch-tx-requester/config.d.ts +17 -0
  253. package/dest/services/reqresp/batch-tx-requester/config.d.ts.map +1 -0
  254. package/dest/services/reqresp/batch-tx-requester/config.js +27 -0
  255. package/dest/services/reqresp/batch-tx-requester/interface.d.ts +50 -0
  256. package/dest/services/reqresp/batch-tx-requester/interface.d.ts.map +1 -0
  257. package/dest/services/reqresp/batch-tx-requester/interface.js +1 -0
  258. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts +37 -0
  259. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts.map +1 -0
  260. package/dest/services/reqresp/batch-tx-requester/missing_txs.js +151 -0
  261. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts +54 -0
  262. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts.map +1 -0
  263. package/dest/services/reqresp/batch-tx-requester/peer_collection.js +139 -0
  264. package/dest/services/reqresp/batch-tx-requester/tx_validator.d.ts +20 -0
  265. package/dest/services/reqresp/batch-tx-requester/tx_validator.d.ts.map +1 -0
  266. package/dest/services/reqresp/batch-tx-requester/tx_validator.js +21 -0
  267. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.d.ts +22 -3
  268. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.d.ts.map +1 -1
  269. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.js +63 -4
  270. package/dest/services/reqresp/connection-sampler/connection_sampler.d.ts +2 -1
  271. package/dest/services/reqresp/connection-sampler/connection_sampler.d.ts.map +1 -1
  272. package/dest/services/reqresp/connection-sampler/connection_sampler.js +12 -0
  273. package/dest/services/reqresp/constants.d.ts +12 -0
  274. package/dest/services/reqresp/constants.d.ts.map +1 -0
  275. package/dest/services/reqresp/constants.js +7 -0
  276. package/dest/services/reqresp/interface.d.ts +13 -2
  277. package/dest/services/reqresp/interface.d.ts.map +1 -1
  278. package/dest/services/reqresp/interface.js +16 -2
  279. package/dest/services/reqresp/metrics.d.ts +6 -5
  280. package/dest/services/reqresp/metrics.d.ts.map +1 -1
  281. package/dest/services/reqresp/metrics.js +17 -21
  282. package/dest/services/reqresp/protocols/auth.d.ts +2 -2
  283. package/dest/services/reqresp/protocols/auth.d.ts.map +1 -1
  284. package/dest/services/reqresp/protocols/auth.js +2 -2
  285. package/dest/services/reqresp/protocols/block.js +1 -1
  286. package/dest/services/reqresp/protocols/block_txs/bitvector.d.ts +5 -1
  287. package/dest/services/reqresp/protocols/block_txs/bitvector.d.ts.map +1 -1
  288. package/dest/services/reqresp/protocols/block_txs/bitvector.js +12 -0
  289. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts +7 -5
  290. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts.map +1 -1
  291. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.js +27 -9
  292. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts +30 -7
  293. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts.map +1 -1
  294. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.js +60 -14
  295. package/dest/services/reqresp/protocols/status.d.ts +1 -1
  296. package/dest/services/reqresp/protocols/status.d.ts.map +1 -1
  297. package/dest/services/reqresp/protocols/status.js +4 -1
  298. package/dest/services/reqresp/protocols/tx.d.ts +8 -3
  299. package/dest/services/reqresp/protocols/tx.d.ts.map +1 -1
  300. package/dest/services/reqresp/protocols/tx.js +20 -0
  301. package/dest/services/reqresp/reqresp.d.ts +6 -1
  302. package/dest/services/reqresp/reqresp.d.ts.map +1 -1
  303. package/dest/services/reqresp/reqresp.js +471 -50
  304. package/dest/services/service.d.ts +53 -3
  305. package/dest/services/service.d.ts.map +1 -1
  306. package/dest/services/tx_collection/config.d.ts +10 -1
  307. package/dest/services/tx_collection/config.d.ts.map +1 -1
  308. package/dest/services/tx_collection/config.js +26 -2
  309. package/dest/services/tx_collection/fast_tx_collection.d.ts +7 -4
  310. package/dest/services/tx_collection/fast_tx_collection.d.ts.map +1 -1
  311. package/dest/services/tx_collection/fast_tx_collection.js +34 -13
  312. package/dest/services/tx_collection/file_store_tx_collection.d.ts +44 -0
  313. package/dest/services/tx_collection/file_store_tx_collection.d.ts.map +1 -0
  314. package/dest/services/tx_collection/file_store_tx_collection.js +118 -0
  315. package/dest/services/tx_collection/file_store_tx_source.d.ts +27 -0
  316. package/dest/services/tx_collection/file_store_tx_source.d.ts.map +1 -0
  317. package/dest/services/tx_collection/file_store_tx_source.js +57 -0
  318. package/dest/services/tx_collection/index.d.ts +3 -1
  319. package/dest/services/tx_collection/index.d.ts.map +1 -1
  320. package/dest/services/tx_collection/index.js +2 -0
  321. package/dest/services/tx_collection/instrumentation.d.ts +1 -1
  322. package/dest/services/tx_collection/instrumentation.d.ts.map +1 -1
  323. package/dest/services/tx_collection/instrumentation.js +10 -13
  324. package/dest/services/tx_collection/proposal_tx_collector.d.ts +48 -0
  325. package/dest/services/tx_collection/proposal_tx_collector.d.ts.map +1 -0
  326. package/dest/services/tx_collection/proposal_tx_collector.js +49 -0
  327. package/dest/services/tx_collection/slow_tx_collection.d.ts +3 -1
  328. package/dest/services/tx_collection/slow_tx_collection.d.ts.map +1 -1
  329. package/dest/services/tx_collection/slow_tx_collection.js +48 -19
  330. package/dest/services/tx_collection/tx_collection.d.ts +21 -11
  331. package/dest/services/tx_collection/tx_collection.d.ts.map +1 -1
  332. package/dest/services/tx_collection/tx_collection.js +63 -7
  333. package/dest/services/tx_collection/tx_collection_sink.d.ts +15 -6
  334. package/dest/services/tx_collection/tx_collection_sink.d.ts.map +1 -1
  335. package/dest/services/tx_collection/tx_collection_sink.js +13 -7
  336. package/dest/services/tx_file_store/config.d.ts +16 -0
  337. package/dest/services/tx_file_store/config.d.ts.map +1 -0
  338. package/dest/services/tx_file_store/config.js +22 -0
  339. package/dest/services/tx_file_store/index.d.ts +4 -0
  340. package/dest/services/tx_file_store/index.d.ts.map +1 -0
  341. package/dest/services/tx_file_store/index.js +3 -0
  342. package/dest/services/tx_file_store/instrumentation.d.ts +15 -0
  343. package/dest/services/tx_file_store/instrumentation.d.ts.map +1 -0
  344. package/dest/services/tx_file_store/instrumentation.js +29 -0
  345. package/dest/services/tx_file_store/tx_file_store.d.ts +47 -0
  346. package/dest/services/tx_file_store/tx_file_store.d.ts.map +1 -0
  347. package/dest/services/tx_file_store/tx_file_store.js +149 -0
  348. package/dest/services/tx_provider.d.ts +6 -5
  349. package/dest/services/tx_provider.d.ts.map +1 -1
  350. package/dest/services/tx_provider.js +16 -6
  351. package/dest/services/tx_provider_instrumentation.d.ts +5 -2
  352. package/dest/services/tx_provider_instrumentation.d.ts.map +1 -1
  353. package/dest/services/tx_provider_instrumentation.js +14 -14
  354. package/dest/test-helpers/index.d.ts +3 -1
  355. package/dest/test-helpers/index.d.ts.map +1 -1
  356. package/dest/test-helpers/index.js +2 -0
  357. package/dest/test-helpers/make-test-p2p-clients.d.ts +3 -3
  358. package/dest/test-helpers/make-test-p2p-clients.d.ts.map +1 -1
  359. package/dest/test-helpers/mock-pubsub.d.ts +27 -1
  360. package/dest/test-helpers/mock-pubsub.d.ts.map +1 -1
  361. package/dest/test-helpers/mock-pubsub.js +97 -2
  362. package/dest/test-helpers/mock-tx-helpers.js +1 -1
  363. package/dest/test-helpers/reqresp-nodes.d.ts +2 -2
  364. package/dest/test-helpers/reqresp-nodes.d.ts.map +1 -1
  365. package/dest/test-helpers/reqresp-nodes.js +2 -1
  366. package/dest/test-helpers/test_tx_provider.d.ts +40 -0
  367. package/dest/test-helpers/test_tx_provider.d.ts.map +1 -0
  368. package/dest/test-helpers/test_tx_provider.js +41 -0
  369. package/dest/test-helpers/testbench-utils.d.ts +158 -0
  370. package/dest/test-helpers/testbench-utils.d.ts.map +1 -0
  371. package/dest/test-helpers/testbench-utils.js +360 -0
  372. package/dest/testbench/p2p_client_testbench_worker.d.ts +28 -2
  373. package/dest/testbench/p2p_client_testbench_worker.d.ts.map +1 -1
  374. package/dest/testbench/p2p_client_testbench_worker.js +219 -124
  375. package/dest/testbench/worker_client_manager.d.ts +51 -6
  376. package/dest/testbench/worker_client_manager.d.ts.map +1 -1
  377. package/dest/testbench/worker_client_manager.js +226 -39
  378. package/package.json +16 -16
  379. package/src/bootstrap/bootstrap.ts +7 -4
  380. package/src/client/factory.ts +80 -29
  381. package/src/client/interface.ts +57 -17
  382. package/src/client/p2p_client.ts +229 -295
  383. package/src/client/test/tx_proposal_collector/README.md +227 -0
  384. package/src/client/test/tx_proposal_collector/proposal_tx_collector_worker.ts +336 -0
  385. package/src/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.ts +43 -0
  386. package/src/config.ts +50 -20
  387. package/src/index.ts +1 -0
  388. package/src/mem_pools/attestation_pool/attestation_pool.ts +502 -78
  389. package/src/mem_pools/attestation_pool/attestation_pool_test_suite.ts +614 -322
  390. package/src/mem_pools/attestation_pool/index.ts +9 -2
  391. package/src/mem_pools/attestation_pool/mocks.ts +21 -15
  392. package/src/mem_pools/index.ts +4 -1
  393. package/src/mem_pools/instrumentation.ts +39 -14
  394. package/src/mem_pools/interface.ts +5 -7
  395. package/src/mem_pools/tx_pool/README.md +270 -0
  396. package/src/mem_pools/tx_pool/aztec_kv_tx_pool.ts +362 -367
  397. package/src/mem_pools/tx_pool/eviction/eviction_manager.ts +132 -0
  398. package/src/mem_pools/tx_pool/eviction/eviction_strategy.ts +208 -0
  399. package/src/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.ts +162 -0
  400. package/src/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.ts +104 -0
  401. package/src/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.ts +93 -0
  402. package/src/mem_pools/tx_pool/eviction/low_priority_eviction_rule.ts +106 -0
  403. package/src/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.ts +75 -0
  404. package/src/mem_pools/tx_pool/index.ts +0 -1
  405. package/src/mem_pools/tx_pool/priority.ts +8 -1
  406. package/src/mem_pools/tx_pool/tx_pool.ts +8 -3
  407. package/src/mem_pools/tx_pool/tx_pool_test_suite.ts +18 -13
  408. package/src/mem_pools/tx_pool_v2/README.md +259 -0
  409. package/src/mem_pools/tx_pool_v2/archive/index.ts +1 -0
  410. package/src/mem_pools/tx_pool_v2/archive/tx_archive.ts +120 -0
  411. package/src/mem_pools/tx_pool_v2/deleted_pool.ts +234 -0
  412. package/src/mem_pools/tx_pool_v2/eviction/eviction_manager.ts +147 -0
  413. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.ts +118 -0
  414. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.ts +111 -0
  415. package/src/mem_pools/tx_pool_v2/eviction/index.ts +23 -0
  416. package/src/mem_pools/tx_pool_v2/eviction/interfaces.ts +164 -0
  417. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.ts +74 -0
  418. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.ts +101 -0
  419. package/src/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.ts +86 -0
  420. package/src/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.ts +72 -0
  421. package/src/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.ts +31 -0
  422. package/src/mem_pools/tx_pool_v2/index.ts +12 -0
  423. package/src/mem_pools/tx_pool_v2/interfaces.ts +227 -0
  424. package/src/mem_pools/tx_pool_v2/tx_metadata.ts +207 -0
  425. package/src/mem_pools/tx_pool_v2/tx_pool_bench_metrics.ts +77 -0
  426. package/src/mem_pools/tx_pool_v2/tx_pool_indices.ts +417 -0
  427. package/src/mem_pools/tx_pool_v2/tx_pool_v2.ts +212 -0
  428. package/src/mem_pools/tx_pool_v2/tx_pool_v2_impl.ts +895 -0
  429. package/src/msg_validators/attestation_validator/attestation_validator.ts +37 -22
  430. package/src/msg_validators/attestation_validator/fisherman_attestation_validator.ts +21 -18
  431. package/src/msg_validators/clock_tolerance.ts +51 -0
  432. package/src/msg_validators/index.ts +1 -1
  433. package/src/msg_validators/proposal_validator/block_proposal_validator.ts +10 -0
  434. package/src/msg_validators/proposal_validator/checkpoint_proposal_validator.ts +13 -0
  435. package/src/msg_validators/proposal_validator/index.ts +3 -0
  436. package/src/msg_validators/proposal_validator/proposal_validator.ts +92 -0
  437. package/src/msg_validators/proposal_validator/proposal_validator_test_suite.ts +230 -0
  438. package/src/msg_validators/tx_validator/aggregate_tx_validator.ts +2 -2
  439. package/src/msg_validators/tx_validator/archive_cache.ts +3 -3
  440. package/src/msg_validators/tx_validator/block_header_validator.ts +21 -8
  441. package/src/msg_validators/tx_validator/data_validator.ts +18 -6
  442. package/src/msg_validators/tx_validator/double_spend_validator.ts +15 -9
  443. package/src/msg_validators/tx_validator/factory.ts +65 -24
  444. package/src/msg_validators/tx_validator/fee_payer_balance.ts +40 -0
  445. package/src/msg_validators/tx_validator/gas_validator.ts +17 -28
  446. package/src/msg_validators/tx_validator/index.ts +1 -0
  447. package/src/msg_validators/tx_validator/metadata_validator.ts +19 -8
  448. package/src/msg_validators/tx_validator/phases_validator.ts +5 -3
  449. package/src/msg_validators/tx_validator/size_validator.ts +22 -0
  450. package/src/msg_validators/tx_validator/test_utils.ts +1 -1
  451. package/src/msg_validators/tx_validator/timestamp_validator.ts +25 -15
  452. package/src/msg_validators/tx_validator/tx_permitted_validator.ts +8 -3
  453. package/src/msg_validators/tx_validator/tx_proof_validator.ts +8 -3
  454. package/src/services/data_store.ts +10 -7
  455. package/src/services/discv5/discV5_service.ts +1 -1
  456. package/src/services/dummy_service.ts +63 -0
  457. package/src/services/encoding.ts +8 -7
  458. package/src/services/gossipsub/README.md +626 -0
  459. package/src/services/gossipsub/index.ts +2 -0
  460. package/src/services/gossipsub/scoring.ts +29 -5
  461. package/src/services/gossipsub/topic_score_params.ts +451 -0
  462. package/src/services/index.ts +1 -0
  463. package/src/services/libp2p/instrumentation.ts +32 -73
  464. package/src/services/libp2p/libp2p_service.ts +647 -307
  465. package/src/services/peer-manager/metrics.ts +39 -21
  466. package/src/services/peer-manager/peer_manager.ts +5 -4
  467. package/src/services/peer-manager/peer_scoring.ts +28 -4
  468. package/src/services/reqresp/batch-tx-requester/README.md +305 -0
  469. package/src/services/reqresp/batch-tx-requester/batch_tx_requester.ts +706 -0
  470. package/src/services/reqresp/batch-tx-requester/config.ts +40 -0
  471. package/src/services/reqresp/batch-tx-requester/interface.ts +57 -0
  472. package/src/services/reqresp/batch-tx-requester/missing_txs.ts +209 -0
  473. package/src/services/reqresp/batch-tx-requester/peer_collection.ts +205 -0
  474. package/src/services/reqresp/batch-tx-requester/tx_validator.ts +37 -0
  475. package/src/services/reqresp/connection-sampler/batch_connection_sampler.ts +65 -4
  476. package/src/services/reqresp/connection-sampler/connection_sampler.ts +19 -1
  477. package/src/services/reqresp/constants.ts +14 -0
  478. package/src/services/reqresp/interface.ts +30 -2
  479. package/src/services/reqresp/metrics.ts +36 -27
  480. package/src/services/reqresp/protocols/auth.ts +2 -2
  481. package/src/services/reqresp/protocols/block.ts +1 -1
  482. package/src/services/reqresp/protocols/block_txs/bitvector.ts +16 -0
  483. package/src/services/reqresp/protocols/block_txs/block_txs_handler.ts +35 -12
  484. package/src/services/reqresp/protocols/block_txs/block_txs_reqresp.ts +75 -10
  485. package/src/services/reqresp/protocols/status.ts +7 -4
  486. package/src/services/reqresp/protocols/tx.ts +23 -2
  487. package/src/services/reqresp/reqresp.ts +79 -22
  488. package/src/services/service.ts +63 -4
  489. package/src/services/tx_collection/config.ts +42 -2
  490. package/src/services/tx_collection/fast_tx_collection.ts +44 -19
  491. package/src/services/tx_collection/file_store_tx_collection.ts +152 -0
  492. package/src/services/tx_collection/file_store_tx_source.ts +70 -0
  493. package/src/services/tx_collection/index.ts +6 -0
  494. package/src/services/tx_collection/instrumentation.ts +5 -13
  495. package/src/services/tx_collection/proposal_tx_collector.ts +112 -0
  496. package/src/services/tx_collection/slow_tx_collection.ts +55 -26
  497. package/src/services/tx_collection/tx_collection.ts +85 -19
  498. package/src/services/tx_collection/tx_collection_sink.ts +17 -7
  499. package/src/services/tx_file_store/config.ts +37 -0
  500. package/src/services/tx_file_store/index.ts +3 -0
  501. package/src/services/tx_file_store/instrumentation.ts +36 -0
  502. package/src/services/tx_file_store/tx_file_store.ts +173 -0
  503. package/src/services/tx_provider.ts +27 -11
  504. package/src/services/tx_provider_instrumentation.ts +24 -14
  505. package/src/test-helpers/index.ts +2 -0
  506. package/src/test-helpers/make-test-p2p-clients.ts +3 -3
  507. package/src/test-helpers/mock-pubsub.ts +134 -4
  508. package/src/test-helpers/mock-tx-helpers.ts +1 -1
  509. package/src/test-helpers/reqresp-nodes.ts +3 -2
  510. package/src/test-helpers/test_tx_provider.ts +64 -0
  511. package/src/test-helpers/testbench-utils.ts +422 -0
  512. package/src/testbench/p2p_client_testbench_worker.ts +339 -120
  513. package/src/testbench/worker_client_manager.ts +304 -42
  514. package/dest/mem_pools/attestation_pool/kv_attestation_pool.d.ts +0 -37
  515. package/dest/mem_pools/attestation_pool/kv_attestation_pool.d.ts.map +0 -1
  516. package/dest/mem_pools/attestation_pool/kv_attestation_pool.js +0 -213
  517. package/dest/mem_pools/attestation_pool/memory_attestation_pool.d.ts +0 -30
  518. package/dest/mem_pools/attestation_pool/memory_attestation_pool.d.ts.map +0 -1
  519. package/dest/mem_pools/attestation_pool/memory_attestation_pool.js +0 -219
  520. package/dest/mem_pools/tx_pool/memory_tx_pool.d.ts +0 -81
  521. package/dest/mem_pools/tx_pool/memory_tx_pool.d.ts.map +0 -1
  522. package/dest/mem_pools/tx_pool/memory_tx_pool.js +0 -239
  523. package/dest/msg_validators/block_proposal_validator/block_proposal_validator.d.ts +0 -12
  524. package/dest/msg_validators/block_proposal_validator/block_proposal_validator.d.ts.map +0 -1
  525. package/dest/msg_validators/block_proposal_validator/block_proposal_validator.js +0 -82
  526. package/dest/msg_validators/block_proposal_validator/index.d.ts +0 -2
  527. package/dest/msg_validators/block_proposal_validator/index.d.ts.map +0 -1
  528. package/dest/msg_validators/block_proposal_validator/index.js +0 -1
  529. package/src/mem_pools/attestation_pool/kv_attestation_pool.ts +0 -298
  530. package/src/mem_pools/attestation_pool/memory_attestation_pool.ts +0 -287
  531. package/src/mem_pools/tx_pool/memory_tx_pool.ts +0 -285
  532. package/src/msg_validators/block_proposal_validator/block_proposal_validator.ts +0 -97
  533. package/src/msg_validators/block_proposal_validator/index.ts +0 -1
@@ -1,23 +1,24 @@
1
1
  import type { EpochCacheInterface } from '@aztec/epoch-cache';
2
- import { BlockNumber, SlotNumber } from '@aztec/foundation/branded-types';
3
- import { randomInt } from '@aztec/foundation/crypto';
4
- import { Fr } from '@aztec/foundation/fields';
2
+ import { BlockNumber, type SlotNumber } from '@aztec/foundation/branded-types';
3
+ import { Fr } from '@aztec/foundation/curves/bn254';
5
4
  import { type Logger, createLibp2pComponentLogger, createLogger } from '@aztec/foundation/log';
6
5
  import { RunningPromise } from '@aztec/foundation/running-promise';
7
6
  import { Timer } from '@aztec/foundation/timer';
8
7
  import type { AztecAsyncKVStore } from '@aztec/kv-store';
9
- import { getVKTreeRoot } from '@aztec/noir-protocol-circuits-types/vk-tree';
10
8
  import { protocolContractsHash } from '@aztec/protocol-contracts';
11
9
  import type { EthAddress, L2Block, L2BlockSource } from '@aztec/stdlib/block';
12
10
  import type { ContractDataSource } from '@aztec/stdlib/contract';
13
11
  import { GasFees } from '@aztec/stdlib/gas';
14
12
  import type { ClientProtocolCircuitVerifier, PeerInfo, WorldStateSynchronizer } from '@aztec/stdlib/interfaces/server';
15
13
  import {
16
- BlockAttestation,
17
14
  BlockProposal,
15
+ CheckpointAttestation,
16
+ CheckpointProposal,
17
+ type CheckpointProposalCore,
18
18
  type Gossipable,
19
19
  P2PClientType,
20
20
  P2PMessage,
21
+ type ValidationResult as P2PValidationResult,
21
22
  PeerErrorSeverity,
22
23
  TopicType,
23
24
  createTopicString,
@@ -28,7 +29,14 @@ import { MerkleTreeId } from '@aztec/stdlib/trees';
28
29
  import { Tx, type TxHash, type TxValidationResult, type TxValidator } from '@aztec/stdlib/tx';
29
30
  import type { UInt64 } from '@aztec/stdlib/types';
30
31
  import { compressComponentVersions } from '@aztec/stdlib/versioning';
31
- import { Attributes, OtelMetricsAdapter, type TelemetryClient, WithTracer, trackSpan } from '@aztec/telemetry-client';
32
+ import {
33
+ Attributes,
34
+ OtelMetricsAdapter,
35
+ SpanStatusCode,
36
+ type TelemetryClient,
37
+ WithTracer,
38
+ trackSpan,
39
+ } from '@aztec/telemetry-client';
32
40
 
33
41
  import {
34
42
  type GossipSub,
@@ -36,7 +44,7 @@ import {
36
44
  type GossipsubMessage,
37
45
  gossipsub,
38
46
  } from '@chainsafe/libp2p-gossipsub';
39
- import { createPeerScoreParams, createTopicScoreParams } from '@chainsafe/libp2p-gossipsub/score';
47
+ import { createPeerScoreParams } from '@chainsafe/libp2p-gossipsub/score';
40
48
  import { SignaturePolicy } from '@chainsafe/libp2p-gossipsub/types';
41
49
  import { noise } from '@chainsafe/libp2p-noise';
42
50
  import { yamux } from '@chainsafe/libp2p-yamux';
@@ -50,58 +58,65 @@ import { ENR } from '@nethermindeth/enr';
50
58
  import { createLibp2p } from 'libp2p';
51
59
 
52
60
  import type { P2PConfig } from '../../config.js';
53
- import { ProposalSlotCapExceededError } from '../../errors/attestation-pool.error.js';
54
61
  import type { MemPools } from '../../mem_pools/interface.js';
55
62
  import {
56
- AttestationValidator,
57
63
  BlockProposalValidator,
64
+ CheckpointAttestationValidator,
65
+ CheckpointProposalValidator,
66
+ DoubleSpendTxValidator,
58
67
  FishermanAttestationValidator,
68
+ getDefaultAllowedSetupFunctions,
59
69
  } from '../../msg_validators/index.js';
60
70
  import { MessageSeenValidator } from '../../msg_validators/msg_seen_validator/msg_seen_validator.js';
61
- import { getDefaultAllowedSetupFunctions } from '../../msg_validators/tx_validator/allowed_public_setup.js';
62
- import { type MessageValidator, createTxMessageValidators } from '../../msg_validators/tx_validator/factory.js';
63
71
  import {
64
- AggregateTxValidator,
65
- DataTxValidator,
66
- DoubleSpendTxValidator,
67
- MetadataTxValidator,
68
- TxProofValidator,
69
- } from '../../msg_validators/tx_validator/index.js';
72
+ type MessageValidator,
73
+ createTxMessageValidators,
74
+ createTxReqRespValidator,
75
+ } from '../../msg_validators/tx_validator/factory.js';
70
76
  import { GossipSubEvent } from '../../types/index.js';
71
77
  import { type PubSubLibp2p, convertToMultiaddr } from '../../util.js';
72
78
  import { getVersions } from '../../versioning.js';
73
79
  import { AztecDatastore } from '../data_store.js';
74
80
  import { DiscV5Service } from '../discv5/discV5_service.js';
75
81
  import { SnappyTransform, fastMsgIdFn, getMsgIdFn, msgIdToStrFn } from '../encoding.js';
76
- import { gossipScoreThresholds } from '../gossipsub/scoring.js';
82
+ import { APP_SPECIFIC_WEIGHT, gossipScoreThresholds } from '../gossipsub/scoring.js';
83
+ import { createAllTopicScoreParams } from '../gossipsub/topic_score_params.js';
77
84
  import type { PeerManagerInterface } from '../peer-manager/interface.js';
78
85
  import { PeerManager } from '../peer-manager/peer_manager.js';
79
86
  import { PeerScoring } from '../peer-manager/peer_scoring.js';
87
+ import type { BatchTxRequesterLibP2PService } from '../reqresp/batch-tx-requester/interface.js';
80
88
  import type { P2PReqRespConfig } from '../reqresp/config.js';
81
89
  import {
82
90
  DEFAULT_SUB_PROTOCOL_VALIDATORS,
83
91
  type ReqRespInterface,
92
+ type ReqRespResponse,
84
93
  ReqRespSubProtocol,
85
94
  type ReqRespSubProtocolHandler,
86
95
  type ReqRespSubProtocolHandlers,
87
96
  type ReqRespSubProtocolValidators,
88
97
  type SubProtocolMap,
89
98
  ValidationError,
90
- } from '../reqresp/interface.js';
91
- import { reqRespBlockTxsHandler } from '../reqresp/protocols/block_txs/block_txs_handler.js';
92
- import { reqGoodbyeHandler } from '../reqresp/protocols/goodbye.js';
99
+ } from '../reqresp/index.js';
93
100
  import {
94
101
  AuthRequest,
95
102
  BlockTxsRequest,
96
103
  BlockTxsResponse,
97
104
  StatusMessage,
98
105
  pingHandler,
106
+ reqGoodbyeHandler,
99
107
  reqRespBlockHandler,
108
+ reqRespBlockTxsHandler,
100
109
  reqRespStatusHandler,
101
110
  reqRespTxHandler,
102
- } from '../reqresp/protocols/index.js';
111
+ } from '../reqresp/index.js';
103
112
  import { ReqResp } from '../reqresp/reqresp.js';
104
- import type { P2PBlockReceivedCallback, P2PService, PeerDiscoveryService } from '../service.js';
113
+ import type {
114
+ P2PBlockReceivedCallback,
115
+ P2PCheckpointReceivedCallback,
116
+ P2PDuplicateAttestationCallback,
117
+ P2PService,
118
+ PeerDiscoveryService,
119
+ } from '../service.js';
105
120
  import { P2PInstrumentation } from './instrumentation.js';
106
121
 
107
122
  interface ValidationResult {
@@ -113,9 +128,9 @@ interface ValidationResult {
113
128
  type ValidationOutcome = { allPassed: true } | { allPassed: false; failure: ValidationResult };
114
129
 
115
130
  // REFACTOR: Unify with the type above
116
- type ReceivedMessageValidationResult<T> =
117
- | { obj: T; result: Exclude<TopicValidatorResult, TopicValidatorResult.Reject> }
118
- | { obj?: undefined; result: TopicValidatorResult.Reject };
131
+ type ReceivedMessageValidationResult<T, M = undefined> =
132
+ | { obj: T; result: Exclude<TopicValidatorResult, TopicValidatorResult.Reject>; metadata?: M }
133
+ | { obj?: T; result: TopicValidatorResult.Reject; metadata?: M };
119
134
 
120
135
  /**
121
136
  * Lib P2P implementation of the P2PService interface.
@@ -125,14 +140,25 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
125
140
  private msgIdSeenValidators: Record<TopicType, MessageSeenValidator> = {} as Record<TopicType, MessageSeenValidator>;
126
141
 
127
142
  // Message validators
128
- private attestationValidator: AttestationValidator;
129
143
  private blockProposalValidator: BlockProposalValidator;
144
+ private checkpointProposalValidator: CheckpointProposalValidator;
145
+ private checkpointAttestationValidator: CheckpointAttestationValidator;
130
146
 
131
147
  private protocolVersion = '';
132
148
  private topicStrings: Record<TopicType, string> = {} as Record<TopicType, string>;
133
149
 
134
150
  private feesCache: { blockNumber: BlockNumber; gasFees: GasFees } | undefined;
135
151
 
152
+ /** Callback invoked when a duplicate proposal is detected (triggers slashing). */
153
+ private duplicateProposalCallback?: (info: {
154
+ slot: SlotNumber;
155
+ proposer: EthAddress;
156
+ type: 'checkpoint' | 'block';
157
+ }) => void;
158
+
159
+ /** Callback invoked when a duplicate attestation is detected (triggers slashing). */
160
+ private duplicateAttestationCallback?: P2PDuplicateAttestationCallback;
161
+
136
162
  /**
137
163
  * Callback for when a block is received from a peer.
138
164
  * @param block - The block received from the peer.
@@ -140,10 +166,19 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
140
166
  */
141
167
  private blockReceivedCallback: P2PBlockReceivedCallback;
142
168
 
169
+ /**
170
+ * Callback for when a checkpoint proposal is received from a peer.
171
+ * @param checkpoint - The checkpoint proposal received from the peer.
172
+ * @returns The attestations for the checkpoint, if any.
173
+ */
174
+ private checkpointReceivedCallback: P2PCheckpointReceivedCallback;
175
+
143
176
  private gossipSubEventHandler: (e: CustomEvent<GossipsubMessage>) => void;
144
177
 
145
178
  private instrumentation: P2PInstrumentation;
146
179
 
180
+ private telemetry: TelemetryClient;
181
+
147
182
  protected logger: Logger;
148
183
 
149
184
  constructor(
@@ -152,9 +187,9 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
152
187
  protected node: PubSubLibp2p,
153
188
  private peerDiscoveryService: PeerDiscoveryService,
154
189
  private reqresp: ReqRespInterface,
155
- private peerManager: PeerManagerInterface,
156
- protected mempools: MemPools<T>,
157
- private archiver: L2BlockSource & ContractDataSource,
190
+ protected peerManager: PeerManagerInterface,
191
+ protected mempools: MemPools,
192
+ protected archiver: L2BlockSource & ContractDataSource,
158
193
  private epochCache: EpochCacheInterface,
159
194
  private proofVerifier: ClientProtocolCircuitVerifier,
160
195
  private worldStateSynchronizer: WorldStateSynchronizer,
@@ -162,6 +197,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
162
197
  logger: Logger = createLogger('p2p:libp2p_service'),
163
198
  ) {
164
199
  super(telemetry, 'LibP2PService');
200
+ this.telemetry = telemetry;
165
201
 
166
202
  // Create child logger with fisherman prefix if in fisherman mode
167
203
  this.logger = config.fishermanMode ? logger.createChild('[FISHERMAN]') : logger;
@@ -170,7 +206,8 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
170
206
 
171
207
  this.msgIdSeenValidators[TopicType.tx] = new MessageSeenValidator(config.seenMessageCacheSize);
172
208
  this.msgIdSeenValidators[TopicType.block_proposal] = new MessageSeenValidator(config.seenMessageCacheSize);
173
- this.msgIdSeenValidators[TopicType.block_attestation] = new MessageSeenValidator(config.seenMessageCacheSize);
209
+ this.msgIdSeenValidators[TopicType.checkpoint_proposal] = new MessageSeenValidator(config.seenMessageCacheSize);
210
+ this.msgIdSeenValidators[TopicType.checkpoint_attestation] = new MessageSeenValidator(config.seenMessageCacheSize);
174
211
 
175
212
  const versions = getVersions(config);
176
213
  this.protocolVersion = compressComponentVersions(versions);
@@ -178,25 +215,40 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
178
215
 
179
216
  this.topicStrings[TopicType.tx] = createTopicString(TopicType.tx, this.protocolVersion);
180
217
  this.topicStrings[TopicType.block_proposal] = createTopicString(TopicType.block_proposal, this.protocolVersion);
181
- this.topicStrings[TopicType.block_attestation] = createTopicString(
182
- TopicType.block_attestation,
218
+ this.topicStrings[TopicType.checkpoint_proposal] = createTopicString(
219
+ TopicType.checkpoint_proposal,
220
+ this.protocolVersion,
221
+ );
222
+ this.topicStrings[TopicType.checkpoint_attestation] = createTopicString(
223
+ TopicType.checkpoint_attestation,
183
224
  this.protocolVersion,
184
225
  );
185
226
 
186
- // Use FishermanAttestationValidator in fisherman mode to validate attestation payloads against proposals
187
- this.attestationValidator = config.fishermanMode
188
- ? new FishermanAttestationValidator(epochCache, mempools.attestationPool!, telemetry)
189
- : new AttestationValidator(epochCache);
190
227
  this.blockProposalValidator = new BlockProposalValidator(epochCache, { txsPermitted: !config.disableTransactions });
228
+ this.checkpointProposalValidator = new CheckpointProposalValidator(epochCache, {
229
+ txsPermitted: !config.disableTransactions,
230
+ });
231
+ this.checkpointAttestationValidator = config.fishermanMode
232
+ ? new FishermanAttestationValidator(epochCache, mempools.attestationPool, telemetry)
233
+ : new CheckpointAttestationValidator(epochCache);
191
234
 
192
235
  this.gossipSubEventHandler = this.handleGossipSubEvent.bind(this);
193
236
 
194
- this.blockReceivedCallback = async (block: BlockProposal): Promise<BlockAttestation[] | undefined> => {
237
+ this.blockReceivedCallback = async (block: BlockProposal): Promise<boolean> => {
195
238
  this.logger.debug(
196
239
  `Handler not yet registered: Block received callback not set. Received block for slot ${block.slotNumber} from peer.`,
197
240
  { p2pMessageIdentifier: await block.p2pMessageLoggingIdentifier() },
198
241
  );
199
- return undefined;
242
+ return false;
243
+ };
244
+
245
+ this.checkpointReceivedCallback = (
246
+ checkpoint: CheckpointProposalCore,
247
+ ): Promise<CheckpointAttestation[] | undefined> => {
248
+ this.logger.debug(
249
+ `Handler not yet registered: Checkpoint received callback not set. Received checkpoint for slot ${checkpoint.slotNumber} from peer.`,
250
+ );
251
+ return Promise.resolve(undefined);
200
252
  };
201
253
  }
202
254
 
@@ -215,7 +267,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
215
267
  config: P2PConfig,
216
268
  peerId: PeerId,
217
269
  deps: {
218
- mempools: MemPools<T>;
270
+ mempools: MemPools;
219
271
  l2BlockSource: L2BlockSource & ContractDataSource;
220
272
  epochCache: EpochCacheInterface;
221
273
  proofVerifier: ClientProtocolCircuitVerifier;
@@ -242,14 +294,14 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
242
294
 
243
295
  const datastore = new AztecDatastore(peerStore);
244
296
 
245
- const otelMetricsAdapter = new OtelMetricsAdapter(telemetry);
297
+ const otelMetricsAdapter = new OtelMetricsAdapter(telemetry, logger.getBindings());
246
298
 
247
299
  const peerDiscoveryService = new DiscV5Service(
248
300
  peerId,
249
301
  config,
250
302
  packageVersion,
251
303
  telemetry,
252
- createLogger(`${logger.module}:discv5_service`),
304
+ createLogger(`${logger.module}:discv5_service`, logger.getBindings()),
253
305
  );
254
306
 
255
307
  // Seed libp2p's bootstrap discovery with private and trusted peers
@@ -263,10 +315,6 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
263
315
  const versions = getVersions(config);
264
316
  const protocolVersion = compressComponentVersions(versions);
265
317
 
266
- const txTopic = createTopicString(TopicType.tx, protocolVersion);
267
- const blockProposalTopic = createTopicString(TopicType.block_proposal, protocolVersion);
268
- const blockAttestationTopic = createTopicString(TopicType.block_attestation, protocolVersion);
269
-
270
318
  const preferredPeersEnrs: ENR[] = config.preferredPeers.map(enr => ENR.decodeTxt(enr));
271
319
  const directPeers = (
272
320
  await Promise.all(
@@ -286,6 +334,15 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
286
334
 
287
335
  const announceTcpMultiaddr = config.p2pIp ? [convertToMultiaddr(config.p2pIp, p2pPort, 'tcp')] : [];
288
336
 
337
+ // Create dynamic topic score params based on network configuration
338
+ const l1Constants = epochCache.getL1Constants();
339
+ const topicScoreParams = createAllTopicScoreParams(protocolVersion, {
340
+ slotDurationMs: l1Constants.slotDuration * 1000,
341
+ heartbeatIntervalMs: config.gossipsubInterval,
342
+ targetCommitteeSize: l1Constants.targetCommitteeSize,
343
+ blockDurationMs: config.blockDurationMs,
344
+ });
345
+
289
346
  const node = await createLibp2p({
290
347
  start: false,
291
348
  peerId,
@@ -381,30 +438,14 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
381
438
  scoreParams: createPeerScoreParams({
382
439
  // IPColocation factor can be disabled for local testing - default to -5
383
440
  IPColocationFactorWeight: config.debugDisableColocationPenalty ? 0 : -5.0,
384
- topics: {
385
- [txTopic]: createTopicScoreParams({
386
- topicWeight: 1,
387
- invalidMessageDeliveriesWeight: -20,
388
- invalidMessageDeliveriesDecay: 0.5,
389
- }),
390
- [blockAttestationTopic]: createTopicScoreParams({
391
- topicWeight: 1,
392
- invalidMessageDeliveriesWeight: -20,
393
- invalidMessageDeliveriesDecay: 0.5,
394
- }),
395
- [blockProposalTopic]: createTopicScoreParams({
396
- topicWeight: 1,
397
- invalidMessageDeliveriesWeight: -20,
398
- invalidMessageDeliveriesDecay: 0.5,
399
- }),
400
- },
441
+ topics: topicScoreParams,
401
442
  }),
402
443
  }) as (components: GossipSubComponents) => GossipSub,
403
444
  components: (components: { connectionManager: ConnectionManager }) => ({
404
445
  connectionManager: components.connectionManager,
405
446
  }),
406
447
  },
407
- logger: createLibp2pComponentLogger(logger.module),
448
+ logger: createLibp2pComponentLogger(logger.module, logger.getBindings()),
408
449
  });
409
450
 
410
451
  const peerScoring = new PeerScoring(config, telemetry);
@@ -423,8 +464,12 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
423
464
  epochCache,
424
465
  );
425
466
 
426
- // Update gossipsub score params
427
- node.services.pubsub.score.params.appSpecificWeight = 10;
467
+ // Configure application-specific scoring for gossipsub.
468
+ // The weight scales app score to align with gossipsub thresholds:
469
+ // - Disconnect (-50) × 10 = -500 = gossipThreshold (stops receiving gossip)
470
+ // - Ban (-100) × 10 = -1000 = publishThreshold (cannot publish)
471
+ // Note: positive topic scores can offset penalties, so alignment is best-effort.
472
+ node.services.pubsub.score.params.appSpecificWeight = APP_SPECIFIC_WEIGHT;
428
473
  node.services.pubsub.score.params.appSpecificScore = (peerId: string) =>
429
474
  peerManager.shouldDisableP2PGossip(peerId) ? -Infinity : peerManager.getPeerScore(peerId);
430
475
 
@@ -462,17 +507,6 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
462
507
  }
463
508
  const announceTcpMultiaddr = convertToMultiaddr(p2pIp, p2pPort, 'tcp');
464
509
 
465
- await this.peerManager.initializePeers();
466
- if (!this.config.p2pDiscoveryDisabled) {
467
- await this.peerDiscoveryService.start();
468
- }
469
- await this.node.start();
470
-
471
- // Subscribe to standard GossipSub topics by default
472
- for (const topic of getTopicsForClientAndConfig(this.clientType, this.config.disableTransactions)) {
473
- this.subscribeToTopic(this.topicStrings[topic]);
474
- }
475
-
476
510
  // Create request response protocol handlers
477
511
  const txHandler = reqRespTxHandler(this.mempools);
478
512
  const goodbyeHandler = reqGoodbyeHandler(this.peerManager);
@@ -486,9 +520,12 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
486
520
  [ReqRespSubProtocol.BLOCK]: blockHandler.bind(this),
487
521
  };
488
522
 
489
- // Only handle block transactions request if attestation pool is available to the client
490
- if (this.mempools.attestationPool && !this.config.disableTransactions) {
491
- const blockTxsHandler = reqRespBlockTxsHandler(this.mempools.attestationPool, this.mempools.txPool);
523
+ if (!this.config.disableTransactions) {
524
+ const blockTxsHandler = reqRespBlockTxsHandler(
525
+ this.mempools.attestationPool,
526
+ this.archiver,
527
+ this.mempools.txPool,
528
+ );
492
529
  requestResponseHandlers[ReqRespSubProtocol.BLOCK_TXS] = blockTxsHandler.bind(this);
493
530
  }
494
531
 
@@ -496,10 +533,32 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
496
533
  requestResponseHandlers[ReqRespSubProtocol.TX] = txHandler.bind(this);
497
534
  }
498
535
 
536
+ // Define the sub protocol validators - This is done within this start() method to gain a callback to the existing validateTx function
537
+ const reqrespSubProtocolValidators = {
538
+ ...DEFAULT_SUB_PROTOCOL_VALIDATORS,
539
+ [ReqRespSubProtocol.TX]: this.validateRequestedTxs.bind(this),
540
+ [ReqRespSubProtocol.BLOCK_TXS]: this.validateRequestedBlockTxs.bind(this),
541
+ [ReqRespSubProtocol.BLOCK]: this.validateRequestedBlock.bind(this),
542
+ };
543
+
544
+ await this.peerManager.initializePeers();
545
+
546
+ await this.reqresp.start(requestResponseHandlers, reqrespSubProtocolValidators);
547
+
548
+ await this.node.start();
549
+
550
+ // Subscribe to standard GossipSub topics by default
551
+ for (const topic of getTopicsForClientAndConfig(this.clientType, this.config.disableTransactions)) {
552
+ this.subscribeToTopic(this.topicStrings[topic]);
553
+ }
554
+
499
555
  // add GossipSub listener
500
556
  this.node.services.pubsub.addEventListener(GossipSubEvent.MESSAGE, this.gossipSubEventHandler);
501
557
 
502
558
  // Start running promise for peer discovery and metrics collection
559
+ if (!this.config.p2pDiscoveryDisabled) {
560
+ await this.peerDiscoveryService.start();
561
+ }
503
562
  this.discoveryRunningPromise = new RunningPromise(
504
563
  async () => {
505
564
  await this.peerManager.heartbeat();
@@ -509,14 +568,6 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
509
568
  );
510
569
  this.discoveryRunningPromise.start();
511
570
 
512
- // Define the sub protocol validators - This is done within this start() method to gain a callback to the existing validateTx function
513
- const reqrespSubProtocolValidators = {
514
- ...DEFAULT_SUB_PROTOCOL_VALIDATORS,
515
- [ReqRespSubProtocol.TX]: this.validateRequestedTxs.bind(this),
516
- [ReqRespSubProtocol.BLOCK_TXS]: this.validateRequestedBlockTxs.bind(this),
517
- [ReqRespSubProtocol.BLOCK]: this.validateRequestedBlock.bind(this),
518
- };
519
- await this.reqresp.start(requestResponseHandlers, reqrespSubProtocolValidators);
520
571
  this.logger.info(`Started P2P service`, {
521
572
  listen: this.config.listenAddress,
522
573
  port: this.config.p2pPort,
@@ -590,6 +641,15 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
590
641
  return this.reqresp.sendBatchRequest(protocol, requests, pinnedPeerId);
591
642
  }
592
643
 
644
+ public sendRequestToPeer(
645
+ peerId: PeerId,
646
+ subProtocol: ReqRespSubProtocol,
647
+ payload: Buffer,
648
+ dialTimeout?: number,
649
+ ): Promise<ReqRespResponse> {
650
+ return this.reqresp.sendRequestToPeer(peerId, subProtocol, payload, dialTimeout);
651
+ }
652
+
593
653
  /**
594
654
  * Get the ENR of the node
595
655
  * @returns The ENR of the node
@@ -602,6 +662,29 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
602
662
  this.blockReceivedCallback = callback;
603
663
  }
604
664
 
665
+ public registerCheckpointReceivedCallback(callback: P2PCheckpointReceivedCallback) {
666
+ this.checkpointReceivedCallback = callback;
667
+ }
668
+
669
+ /**
670
+ * Registers a callback to be invoked when a duplicate proposal is detected.
671
+ * This callback is triggered on the first duplicate (when count goes from 1 to 2).
672
+ */
673
+ public registerDuplicateProposalCallback(
674
+ callback: (info: { slot: SlotNumber; proposer: EthAddress; type: 'checkpoint' | 'block' }) => void,
675
+ ): void {
676
+ this.duplicateProposalCallback = callback;
677
+ }
678
+
679
+ /**
680
+ * Registers a callback to be invoked when a duplicate attestation is detected.
681
+ * A validator signing attestations for different proposals at the same slot.
682
+ * This callback is triggered on the first duplicate (when count goes from 1 to 2).
683
+ */
684
+ public registerDuplicateAttestationCallback(callback: P2PDuplicateAttestationCallback): void {
685
+ this.duplicateAttestationCallback = callback;
686
+ }
687
+
605
688
  /**
606
689
  * Subscribes to a topic.
607
690
  * @param topic - The topic to subscribe to.
@@ -623,7 +706,10 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
623
706
  if (!this.node.services.pubsub) {
624
707
  throw new Error('Pubsub service not available.');
625
708
  }
626
- const p2pMessage = P2PMessage.fromGossipable(message, this.config.debugP2PInstrumentMessages);
709
+ const isBlockProposal = topic === this.topicStrings[TopicType.block_proposal];
710
+ const traceContext =
711
+ this.config.debugP2PInstrumentMessages && isBlockProposal ? this.telemetry.getTraceContext() : undefined;
712
+ const p2pMessage = P2PMessage.fromGossipable(message, this.config.debugP2PInstrumentMessages, traceContext);
627
713
  const result = await this.node.services.pubsub.publish(topic, p2pMessage.toMessageData());
628
714
  return result.recipients.length;
629
715
  }
@@ -644,12 +730,15 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
644
730
  case this.topicStrings[TopicType.tx]:
645
731
  topicType = TopicType.tx;
646
732
  break;
647
- case this.topicStrings[TopicType.block_attestation]:
648
- topicType = TopicType.block_attestation;
649
- break;
650
733
  case this.topicStrings[TopicType.block_proposal]:
651
734
  topicType = TopicType.block_proposal;
652
735
  break;
736
+ case this.topicStrings[TopicType.checkpoint_proposal]:
737
+ topicType = TopicType.checkpoint_proposal;
738
+ break;
739
+ case this.topicStrings[TopicType.checkpoint_attestation]:
740
+ topicType = TopicType.checkpoint_attestation;
741
+ break;
653
742
  default:
654
743
  this.logger.error(`Received message on unknown topic: ${msg.topic}`);
655
744
  break;
@@ -708,36 +797,87 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
708
797
  return;
709
798
  }
710
799
 
800
+ // Determine topic type for attributes
711
801
  if (msg.topic === this.topicStrings[TopicType.tx]) {
712
802
  topicType = TopicType.tx;
713
- await this.handleGossipedTx(p2pMessage.payload, msgId, source);
803
+ } else if (msg.topic === this.topicStrings[TopicType.checkpoint_attestation]) {
804
+ topicType = TopicType.checkpoint_attestation;
805
+ } else if (msg.topic === this.topicStrings[TopicType.block_proposal]) {
806
+ topicType = TopicType.block_proposal;
807
+ } else if (msg.topic === this.topicStrings[TopicType.checkpoint_proposal]) {
808
+ topicType = TopicType.checkpoint_proposal;
714
809
  }
715
- if (msg.topic === this.topicStrings[TopicType.block_attestation]) {
716
- topicType = TopicType.block_attestation;
717
- if (this.clientType === P2PClientType.Full) {
718
- await this.processAttestationFromPeer(p2pMessage.payload, msgId, source);
810
+
811
+ // Process the message, optionally within a linked span for trace propagation
812
+ const processMessage = async () => {
813
+ if (msg.topic === this.topicStrings[TopicType.tx]) {
814
+ await this.handleGossipedTx(p2pMessage.payload, msgId, source);
815
+ } else if (msg.topic === this.topicStrings[TopicType.checkpoint_attestation]) {
816
+ if (this.clientType === P2PClientType.Full) {
817
+ await this.processCheckpointAttestationFromPeer(p2pMessage.payload, msgId, source);
818
+ }
819
+ } else if (msg.topic === this.topicStrings[TopicType.block_proposal]) {
820
+ await this.processBlockFromPeer(p2pMessage.payload, msgId, source);
821
+ } else if (msg.topic === this.topicStrings[TopicType.checkpoint_proposal]) {
822
+ await this.handleGossipedCheckpointProposal(p2pMessage.payload, msgId, source);
823
+ } else {
824
+ this.logger.error(`Received message on unknown topic: ${msg.topic}`);
719
825
  }
720
- }
721
- if (msg.topic === this.topicStrings[TopicType.block_proposal]) {
722
- topicType = TopicType.block_proposal;
723
- await this.processBlockFromPeer(p2pMessage.payload, msgId, source);
826
+ };
827
+
828
+ const latency = p2pMessage.timestamp !== undefined ? msgReceivedTime - p2pMessage.timestamp.getTime() : undefined;
829
+ const propagatedContext = p2pMessage.traceContext
830
+ ? this.telemetry.extractPropagatedContext(p2pMessage.traceContext)
831
+ : undefined;
832
+
833
+ if (propagatedContext) {
834
+ await this.tracer.startActiveSpan(
835
+ 'LibP2PService.processMessage',
836
+ {
837
+ attributes: {
838
+ [Attributes.TOPIC_NAME]: topicType!,
839
+ [Attributes.PEER_ID]: source.toString(),
840
+ },
841
+ },
842
+ propagatedContext,
843
+ async span => {
844
+ try {
845
+ await processMessage();
846
+ span.setStatus({
847
+ code: SpanStatusCode.OK,
848
+ });
849
+ } catch (err) {
850
+ span.setStatus({
851
+ code: SpanStatusCode.ERROR,
852
+ message: String(err),
853
+ });
854
+ if (typeof err === 'string' || (err && err instanceof Error)) {
855
+ span.recordException(err);
856
+ }
857
+ throw err;
858
+ } finally {
859
+ span.end();
860
+ }
861
+ },
862
+ );
863
+ } else {
864
+ await processMessage();
724
865
  }
725
866
 
726
- if (p2pMessage.timestamp !== undefined && topicType !== undefined) {
727
- const latency = msgReceivedTime - p2pMessage.timestamp.getTime();
867
+ if (latency !== undefined && topicType !== undefined) {
728
868
  this.instrumentation.recordMessageLatency(topicType, latency);
729
869
  }
730
870
 
731
871
  return;
732
872
  }
733
873
 
734
- protected async validateReceivedMessage<T>(
735
- validationFunc: () => Promise<ReceivedMessageValidationResult<T>>,
874
+ protected async validateReceivedMessage<T, M = undefined>(
875
+ validationFunc: () => Promise<ReceivedMessageValidationResult<T, M>>,
736
876
  msgId: string,
737
877
  source: PeerId,
738
878
  topicType: TopicType,
739
- ): Promise<ReceivedMessageValidationResult<T>> {
740
- let resultAndObj: ReceivedMessageValidationResult<T> = { result: TopicValidatorResult.Reject };
879
+ ): Promise<ReceivedMessageValidationResult<T, M>> {
880
+ let resultAndObj: ReceivedMessageValidationResult<T, M> = { result: TopicValidatorResult.Reject };
741
881
  const timer = new Timer();
742
882
  try {
743
883
  resultAndObj = await validationFunc();
@@ -762,20 +902,33 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
762
902
  const validationFunc: () => Promise<ReceivedMessageValidationResult<Tx>> = async () => {
763
903
  const tx = Tx.fromBuffer(payloadData);
764
904
  const isValid = await this.validatePropagatedTx(tx, source);
765
- const exists = isValid && (await this.mempools.txPool.hasTx(tx.getTxHash()));
905
+ if (!isValid) {
906
+ this.logger.trace(`Rejecting invalid propagated tx`, {
907
+ [Attributes.P2P_ID]: source.toString(),
908
+ });
909
+ return { result: TopicValidatorResult.Reject };
910
+ }
911
+
912
+ // Propagate only on pool acceptance
913
+ const txHash = tx.getTxHash();
914
+ const addResult = await this.mempools.txPool.addPendingTxs([tx], { source: 'gossip' });
915
+
916
+ const wasAccepted = addResult.accepted.some(h => h.equals(txHash));
917
+ const wasIgnored = addResult.ignored.some(h => h.equals(txHash));
766
918
 
767
919
  this.logger.trace(`Validate propagated tx`, {
768
920
  isValid,
769
- exists,
921
+ wasAccepted,
922
+ wasIgnored,
770
923
  [Attributes.P2P_ID]: source.toString(),
771
924
  });
772
925
 
773
- if (!isValid) {
774
- return { result: TopicValidatorResult.Reject };
775
- } else if (exists) {
926
+ if (wasAccepted) {
927
+ return { result: TopicValidatorResult.Accept, obj: tx };
928
+ } else if (wasIgnored) {
776
929
  return { result: TopicValidatorResult.Ignore, obj: tx };
777
930
  } else {
778
- return { result: TopicValidatorResult.Accept, obj: tx };
931
+ return { result: TopicValidatorResult.Reject };
779
932
  }
780
933
  };
781
934
 
@@ -784,6 +937,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
784
937
  return;
785
938
  }
786
939
 
940
+ // Tx was accepted into pool and will be propagated - just log and record metrics
787
941
  const txHash = tx.getTxHash();
788
942
  const txHashString = txHash.toString();
789
943
  this.logger.verbose(`Received tx ${txHashString} from external peer ${source.toString()} via gossip`, {
@@ -791,73 +945,31 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
791
945
  txHash: txHashString,
792
946
  });
793
947
 
794
- if (this.config.dropTransactions && randomInt(1000) < this.config.dropTransactionsProbability * 1000) {
795
- this.logger.warn(`Intentionally dropping tx ${txHashString} (probability rule)`);
796
- return;
797
- }
798
-
799
948
  this.instrumentation.incrementTxReceived(1);
800
- await this.mempools.txPool.addTxs([tx]);
801
949
  }
802
950
 
803
951
  /**
804
- * Process Attestation From Peer
805
- * When a proposal is received from a peer, we add it to the attestation pool, so it can be accessed by other services.
806
- *
807
- * @param attestation - The attestation to process.
952
+ * Process a checkpoint attestation from a peer.
953
+ * Validates the attestation and adds it to the pool.
808
954
  */
809
- private async processAttestationFromPeer(payloadData: Buffer, msgId: string, source: PeerId): Promise<void> {
810
- const validationFunc: () => Promise<ReceivedMessageValidationResult<BlockAttestation>> = async () => {
811
- const attestation = BlockAttestation.fromBuffer(payloadData);
812
- const pool = this.mempools.attestationPool!;
813
- const isValid = await this.validateAttestation(source, attestation);
814
- const exists = isValid && (await pool.hasAttestation(attestation));
815
-
816
- let canAdd = true;
817
- if (isValid && !exists) {
818
- const slot = attestation.payload.header.slotNumber;
819
- const { committee } = await this.epochCache.getCommittee(slot);
820
- const committeeSize = committee?.length ?? 0;
821
- canAdd = await pool.canAddAttestation(attestation, committeeSize);
822
- }
823
-
824
- this.logger.trace(`Validate propagated block attestation`, {
825
- isValid,
826
- exists,
827
- canAdd,
828
- [Attributes.SLOT_NUMBER]: attestation.payload.header.slotNumber.toString(),
829
- [Attributes.P2P_ID]: source.toString(),
830
- });
831
-
832
- if (!isValid) {
833
- return { result: TopicValidatorResult.Reject };
834
- } else if (exists) {
835
- return { result: TopicValidatorResult.Ignore, obj: attestation };
836
- } else if (!canAdd) {
837
- this.logger.warn(`Dropping block attestation due to per-(slot, proposalId) attestation cap`, {
838
- slot: attestation.payload.header.slotNumber.toString(),
839
- archive: attestation.archive.toString(),
840
- source: source.toString(),
841
- });
842
- return { result: TopicValidatorResult.Ignore, obj: attestation };
843
- } else {
844
- return { result: TopicValidatorResult.Accept, obj: attestation };
845
- }
846
- };
847
-
848
- const { result, obj: attestation } = await this.validateReceivedMessage<BlockAttestation>(
849
- validationFunc,
955
+ private async processCheckpointAttestationFromPeer(
956
+ payloadData: Buffer,
957
+ msgId: string,
958
+ source: PeerId,
959
+ ): Promise<void> {
960
+ const { result, obj: attestation } = await this.validateReceivedMessage<CheckpointAttestation>(
961
+ () => this.validateAndStoreCheckpointAttestation(source, CheckpointAttestation.fromBuffer(payloadData)),
850
962
  msgId,
851
963
  source,
852
- TopicType.block_attestation,
964
+ TopicType.checkpoint_attestation,
853
965
  );
854
966
 
855
967
  if (result !== TopicValidatorResult.Accept || !attestation) {
856
968
  return;
857
969
  }
858
970
 
859
- this.logger.debug(
860
- `Received attestation for slot ${attestation.slotNumber} from external peer ${source.toString()}`,
971
+ this.logger.verbose(
972
+ `Received valid checkpoint attestation for slot ${attestation.slotNumber} from external peer ${source.toString()}`,
861
973
  {
862
974
  p2pMessageIdentifier: await attestation.p2pMessageLoggingIdentifier(),
863
975
  slot: attestation.slotNumber,
@@ -865,123 +977,354 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
865
977
  source: source.toString(),
866
978
  },
867
979
  );
868
-
869
- await this.mempools.attestationPool!.addAttestations([attestation]);
870
980
  }
871
981
 
872
- private async processBlockFromPeer(payloadData: Buffer, msgId: string, source: PeerId): Promise<void> {
873
- const validationFunc: () => Promise<ReceivedMessageValidationResult<BlockProposal>> = async () => {
874
- const block = BlockProposal.fromBuffer(payloadData);
875
- const isValid = await this.validateBlockProposal(source, block);
876
- const pool = this.mempools.attestationPool;
982
+ /** Validates a checkpoint attestation and adds it to the pool. Penalizes the peer if validation fails. */
983
+ @trackSpan('Libp2pService.validateAndStoreCheckpointAttestation', (_peerId, attestation) => ({
984
+ [Attributes.SLOT_NUMBER]: attestation.payload.header.slotNumber.toString(),
985
+ }))
986
+ protected async validateAndStoreCheckpointAttestation(
987
+ peerId: PeerId,
988
+ attestation: CheckpointAttestation,
989
+ ): Promise<ReceivedMessageValidationResult<CheckpointAttestation>> {
990
+ const validationResult = await this.checkpointAttestationValidator.validate(attestation);
991
+
992
+ if (validationResult.result === 'reject') {
993
+ this.logger.warn(`Penalizing peer ${peerId} for checkpoint attestation validation failure`);
994
+ this.peerManager.penalizePeer(peerId, validationResult.severity);
995
+ return { result: TopicValidatorResult.Reject };
996
+ }
997
+
998
+ if (validationResult.result === 'ignore') {
999
+ return { result: TopicValidatorResult.Ignore, obj: attestation };
1000
+ }
877
1001
 
878
- // Note that we dont have an attestation pool if we're a prover node, but we still
879
- // subscribe to block proposal topics in order to prevent their txs from being cleared.
880
- const exists = isValid && (await pool?.hasBlockProposal(block));
881
- const canAdd = isValid && (await pool?.canAddProposal(block));
1002
+ // Try to add the attestation: this handles existence check, cap check, and adding in one call
1003
+ // count is the number of attestations by this signer for this slot (for duplicate detection)
1004
+ const slot = attestation.payload.header.slotNumber;
1005
+ const { added, alreadyExists, count } =
1006
+ await this.mempools.attestationPool.tryAddCheckpointAttestation(attestation);
1007
+
1008
+ this.logger.trace(`Validate propagated checkpoint attestation`, {
1009
+ added,
1010
+ alreadyExists,
1011
+ count,
1012
+ [Attributes.SLOT_NUMBER]: slot.toString(),
1013
+ [Attributes.P2P_ID]: peerId.toString(),
1014
+ });
882
1015
 
883
- this.logger.trace(`Validate propagated block proposal`, {
884
- isValid,
885
- exists,
886
- canAdd,
887
- [Attributes.SLOT_NUMBER]: block.payload.header.slotNumber.toString(),
888
- [Attributes.P2P_ID]: source.toString(),
1016
+ // Exact same attestation received, no need to re-broadcast
1017
+ if (alreadyExists) {
1018
+ return { result: TopicValidatorResult.Ignore, obj: attestation };
1019
+ }
1020
+
1021
+ // Could not add (cap reached for signer), no need to re-broadcast
1022
+ if (!added) {
1023
+ this.logger.warn(`Dropping checkpoint attestation due to cap`, {
1024
+ slot: slot.toString(),
1025
+ archive: attestation.archive.toString(),
1026
+ source: peerId.toString(),
1027
+ attester: attestation.getSender()?.toString(),
1028
+ count,
889
1029
  });
1030
+ return { result: TopicValidatorResult.Ignore, obj: attestation };
1031
+ }
890
1032
 
891
- if (!isValid) {
892
- return { result: TopicValidatorResult.Reject };
893
- } else if (exists) {
894
- return { result: TopicValidatorResult.Ignore, obj: block };
895
- } else if (!canAdd) {
896
- this.peerManager.penalizePeer(source, PeerErrorSeverity.MidToleranceError);
897
- this.logger.warn(`Penalizing peer for block proposal exceeding per-slot cap`, {
898
- slot: block.slotNumber.toString(),
899
- archive: block.archive.toString(),
900
- source: source.toString(),
1033
+ // Check if this is a duplicate attestation (signer attested to a different proposal at the same slot)
1034
+ // count is the number of attestations by this signer for this slot
1035
+ if (count === 2) {
1036
+ const attester = attestation.getSender();
1037
+ if (attester) {
1038
+ this.logger.warn(`Detected duplicate attestation (equivocation) at slot ${slot}`, {
1039
+ slot: slot.toString(),
1040
+ archive: attestation.archive.toString(),
1041
+ source: peerId.toString(),
1042
+ attester: attester.toString(),
901
1043
  });
902
- return { result: TopicValidatorResult.Reject };
903
- } else {
904
- return { result: TopicValidatorResult.Accept, obj: block };
1044
+ this.duplicateAttestationCallback?.({ slot, attester });
905
1045
  }
906
- };
1046
+ }
1047
+
1048
+ // Attestation was added successfully - accept it so other nodes can also detect the equivocation
1049
+ return { result: TopicValidatorResult.Accept, obj: attestation };
1050
+ }
907
1051
 
908
- const { result, obj: block } = await this.validateReceivedMessage<BlockProposal>(
909
- validationFunc,
1052
+ protected async processBlockFromPeer(payloadData: Buffer, msgId: string, source: PeerId): Promise<void> {
1053
+ const {
1054
+ result,
1055
+ obj: block,
1056
+ metadata: { isEquivocated } = {},
1057
+ } = await this.validateReceivedMessage<BlockProposal, { isEquivocated: boolean }>(
1058
+ () => this.validateAndStoreBlockProposal(source, BlockProposal.fromBuffer(payloadData)),
910
1059
  msgId,
911
1060
  source,
912
1061
  TopicType.block_proposal,
913
1062
  );
914
1063
 
915
- if (!result || !block) {
1064
+ // If not accepted or equivocated, return
1065
+ if (result !== TopicValidatorResult.Accept || !block || isEquivocated) {
916
1066
  return;
917
1067
  }
918
1068
 
919
1069
  await this.processValidBlockProposal(block, source);
920
1070
  }
921
1071
 
922
- // REVIEW: callback pattern https://github.com/AztecProtocol/aztec-packages/issues/7963
1072
+ /** Validates a block proposal. Triggers a penalization to the peer that sent it if invalid. Adds to the mempool if valid. */
1073
+ @trackSpan('Libp2pService.validateAndStoreBlockProposal', (_peerId, block) => ({
1074
+ [Attributes.BLOCK_NUMBER]: block.blockNumber.toString(),
1075
+ [Attributes.SLOT_NUMBER]: block.slotNumber.toString(),
1076
+ }))
1077
+ protected async validateAndStoreBlockProposal(
1078
+ peerId: PeerId,
1079
+ block: BlockProposal,
1080
+ ): Promise<ReceivedMessageValidationResult<BlockProposal, { isEquivocated: boolean }>> {
1081
+ const validationResult = await this.blockProposalValidator.validate(block);
1082
+
1083
+ if (validationResult.result === 'reject') {
1084
+ this.logger.warn(`Penalizing peer ${peerId} for block proposal validation failure`);
1085
+ this.peerManager.penalizePeer(peerId, validationResult.severity);
1086
+ return { result: TopicValidatorResult.Reject };
1087
+ }
1088
+
1089
+ if (validationResult.result === 'ignore') {
1090
+ return { result: TopicValidatorResult.Ignore, obj: block };
1091
+ }
1092
+
1093
+ // Try to add the proposal: this handles existence check, cap check, and adding in one call
1094
+ const { added, alreadyExists, count } = await this.mempools.attestationPool.tryAddBlockProposal(block);
1095
+ const isEquivocated = count !== undefined && count > 1;
1096
+
1097
+ // Duplicate proposal received, no need to re-broadcast
1098
+ if (alreadyExists) {
1099
+ this.logger.debug(`Ignoring duplicate block proposal received`, {
1100
+ ...block.toBlockInfo(),
1101
+ indexWithinCheckpoint: block.indexWithinCheckpoint,
1102
+ proposer: block.getSender()?.toString(),
1103
+ source: peerId.toString(),
1104
+ });
1105
+ return { result: TopicValidatorResult.Ignore, obj: block, metadata: { isEquivocated } };
1106
+ }
1107
+
1108
+ // Too many blocks received for this slot and index, penalize peer and do not re-broadcast
1109
+ if (!added) {
1110
+ this.peerManager.penalizePeer(peerId, PeerErrorSeverity.HighToleranceError);
1111
+ this.logger.warn(`Penalizing peer for block proposal exceeding per-position cap`, {
1112
+ ...block.toBlockInfo(),
1113
+ indexWithinCheckpoint: block.indexWithinCheckpoint,
1114
+ count,
1115
+ proposer: block.getSender()?.toString(),
1116
+ source: peerId.toString(),
1117
+ });
1118
+ return { result: TopicValidatorResult.Reject, metadata: { isEquivocated } };
1119
+ }
1120
+
1121
+ // If this was a duplicate proposal, do not process it, but do invoke the duplicate callback,
1122
+ // and do re-broadcast it so other nodes in the network know to slash the proposer
1123
+ if (isEquivocated) {
1124
+ const proposer = block.getSender();
1125
+ this.logger.warn(`Detected duplicate block proposal (equivocation) at slot ${block.slotNumber}`, {
1126
+ ...block.toBlockInfo(),
1127
+ source: peerId.toString(),
1128
+ proposer: proposer?.toString(),
1129
+ });
1130
+ // Invoke the duplicate callback on the first duplicate spotted only
1131
+ if (proposer && count === 2) {
1132
+ this.duplicateProposalCallback?.({ slot: block.slotNumber, proposer, type: 'block' });
1133
+ }
1134
+ return { result: TopicValidatorResult.Accept, obj: block, metadata: { isEquivocated } };
1135
+ }
1136
+
1137
+ // Otherwise, we're good to go!
1138
+ return { result: TopicValidatorResult.Accept, obj: block };
1139
+ }
1140
+
1141
+ // REFACTOR(palla): This method should be moved to the p2p_client or to a separate component,
1142
+ // should not be here as it does not deal with p2p networking.
923
1143
  @trackSpan('Libp2pService.processValidBlockProposal', async block => ({
924
1144
  [Attributes.SLOT_NUMBER]: block.slotNumber,
925
1145
  [Attributes.BLOCK_ARCHIVE]: block.archive.toString(),
926
1146
  [Attributes.P2P_ID]: await block.p2pMessageLoggingIdentifier().then(i => i.toString()),
927
1147
  }))
928
- private async processValidBlockProposal(block: BlockProposal, sender: PeerId) {
1148
+ protected async processValidBlockProposal(block: BlockProposal, sender: PeerId) {
929
1149
  const slot = block.slotNumber;
930
- const previousSlot = SlotNumber(slot - 1);
931
1150
  this.logger.verbose(`Received block proposal for slot ${slot} from external peer ${sender.toString()}.`, {
932
1151
  p2pMessageIdentifier: await block.p2pMessageLoggingIdentifier(),
933
- slot: block.slotNumber,
934
- archive: block.archive.toString(),
935
1152
  source: sender.toString(),
1153
+ ...block.toBlockInfo(),
936
1154
  });
937
- const attestationsForPreviousSlot = await this.mempools.attestationPool?.getAttestationsForSlot(previousSlot);
938
- if (attestationsForPreviousSlot !== undefined) {
939
- this.logger.verbose(`Received ${attestationsForPreviousSlot.length} attestations for slot ${previousSlot}`);
1155
+
1156
+ // Mark the txs in this proposal as protected
1157
+ await this.mempools.txPool.protectTxs(block.txHashes, block.blockHeader);
1158
+
1159
+ // Call the block received callback to validate the proposal.
1160
+ // Note: Validators do NOT attest to individual blocks, only to checkpoint proposals.
1161
+ const isValid = await this.blockReceivedCallback(block, sender);
1162
+ if (!isValid) {
1163
+ this.logger.warn(`Block proposal validation failed for block ${block.blockNumber}`, block.toBlockInfo());
940
1164
  }
1165
+ }
941
1166
 
942
- // Attempt to add proposal, then mark the txs in this proposal as non-evictable
943
- try {
944
- await this.mempools.attestationPool?.addBlockProposal(block);
945
- } catch (err: unknown) {
946
- // Drop proposals if we hit per-slot cap in the attestation pool; rethrow unknown errors
947
- if (err instanceof ProposalSlotCapExceededError) {
948
- this.logger.warn(`Dropping block proposal due to per-slot proposal cap`, {
949
- slot: String(slot),
950
- archive: block.archive.toString(),
951
- error: (err as Error).message,
1167
+ /**
1168
+ * Handle a gossiped checkpoint proposal.
1169
+ * Validates and processes the checkpoint proposal, then triggers the callback for attestation.
1170
+ */
1171
+ protected async handleGossipedCheckpointProposal(payloadData: Buffer, msgId: string, source: PeerId): Promise<void> {
1172
+ const {
1173
+ result,
1174
+ obj: checkpoint,
1175
+ metadata: { isEquivocated, processBlock } = {},
1176
+ } = await this.validateReceivedMessage<CheckpointProposal, { isEquivocated: boolean; processBlock: boolean }>(
1177
+ () => this.validateAndStoreCheckpointProposal(source, CheckpointProposal.fromBuffer(payloadData)),
1178
+ msgId,
1179
+ source,
1180
+ TopicType.checkpoint_proposal,
1181
+ );
1182
+
1183
+ // If the checkpoint contained a valid last block, we process it even if the checkpoint itself is to be rejected
1184
+ // TODO(palla/mbps): Is this ok? Should we be considering a block from a checkpoint that was equivocated?
1185
+ if (processBlock && checkpoint?.getBlockProposal()) {
1186
+ await this.processValidBlockProposal(checkpoint.getBlockProposal()!, source);
1187
+ }
1188
+
1189
+ if (result !== TopicValidatorResult.Accept || !checkpoint || isEquivocated) {
1190
+ return;
1191
+ }
1192
+
1193
+ await this.processValidCheckpointProposal(checkpoint.toCore(), source);
1194
+ }
1195
+
1196
+ /**
1197
+ * Validates a checkpoint proposal. Penalizes peer if validation fails. Adds the checkpoint and
1198
+ * its last block (if present) to the mempool if valid. Triggers equivocation detection on both.
1199
+ */
1200
+ @trackSpan('Libp2pService.validateAndStoreCheckpointProposal', (_peerId, checkpoint) => ({
1201
+ [Attributes.SLOT_NUMBER]: checkpoint.slotNumber.toString(),
1202
+ }))
1203
+ protected async validateAndStoreCheckpointProposal(
1204
+ peerId: PeerId,
1205
+ checkpoint: CheckpointProposal,
1206
+ ): Promise<ReceivedMessageValidationResult<CheckpointProposal, { isEquivocated: boolean; processBlock: boolean }>> {
1207
+ const validationResult = await this.checkpointProposalValidator.validate(checkpoint);
1208
+
1209
+ if (validationResult.result === 'reject') {
1210
+ this.logger.warn(`Penalizing peer ${peerId} for checkpoint proposal validation failure`);
1211
+ this.peerManager.penalizePeer(peerId, validationResult.severity);
1212
+ return { result: TopicValidatorResult.Reject };
1213
+ }
1214
+
1215
+ if (validationResult.result === 'ignore') {
1216
+ return { result: TopicValidatorResult.Ignore, obj: checkpoint };
1217
+ }
1218
+
1219
+ // Extract and try to add the block proposal first if present
1220
+ const blockProposal = checkpoint.getBlockProposal();
1221
+ let processBlock = false;
1222
+ if (blockProposal) {
1223
+ this.logger.debug(`Validating block proposal from propagated checkpoint`, {
1224
+ [Attributes.SLOT_NUMBER]: checkpoint.slotNumber.toString(),
1225
+ [Attributes.P2P_ID]: peerId.toString(),
1226
+ });
1227
+ const {
1228
+ result,
1229
+ obj,
1230
+ metadata: { isEquivocated } = {},
1231
+ } = await this.validateAndStoreBlockProposal(peerId, blockProposal);
1232
+ if (result === TopicValidatorResult.Reject || !obj || isEquivocated) {
1233
+ this.logger.debug(`Rejecting checkpoint due to invalid last block proposal`, {
1234
+ [Attributes.SLOT_NUMBER]: checkpoint.slotNumber.toString(),
1235
+ [Attributes.P2P_ID]: peerId.toString(),
1236
+ isEquivocated,
1237
+ result,
952
1238
  });
953
- return;
1239
+ return { result: TopicValidatorResult.Reject };
1240
+ } else if (result === TopicValidatorResult.Accept && obj && !isEquivocated) {
1241
+ processBlock = true;
954
1242
  }
955
- throw err;
956
1243
  }
957
- await this.mempools.txPool.markTxsAsNonEvictable(block.txHashes);
958
- const attestations = await this.blockReceivedCallback(block, sender);
959
1244
 
960
- // TODO: fix up this pattern - the abstraction is not nice
961
- // The attestation can be undefined if no handler is registered / the validator deems the block invalid / in fisherman mode
962
- if (attestations?.length) {
963
- for (const attestation of attestations) {
964
- this.logger.verbose(`Broadcasting attestation for slot ${attestation.slotNumber}`, {
965
- p2pMessageIdentifier: await attestation.p2pMessageLoggingIdentifier(),
966
- slot: attestation.slotNumber,
967
- archive: attestation.archive.toString(),
968
- });
969
- await this.broadcastAttestation(attestation);
1245
+ // Try to add the checkpoint proposal core: this handles existence check, cap check, and adding in one call
1246
+ const checkpointCore = checkpoint.toCore();
1247
+ const tryAddResult = await this.mempools.attestationPool.tryAddCheckpointProposal(checkpointCore);
1248
+ const { added, alreadyExists, count } = tryAddResult;
1249
+ const isEquivocated = count !== undefined && count > 1;
1250
+
1251
+ // Duplicate proposal received, do not re-broadcast
1252
+ if (alreadyExists) {
1253
+ this.logger.debug(`Ignoring duplicate checkpoint proposal received`, {
1254
+ ...checkpoint.toCheckpointInfo(),
1255
+ source: peerId.toString(),
1256
+ });
1257
+ return {
1258
+ result: TopicValidatorResult.Ignore,
1259
+ obj: checkpoint,
1260
+ metadata: { isEquivocated, processBlock },
1261
+ };
1262
+ }
1263
+
1264
+ // Too many checkpoint proposals received for this slot, penalize peer and do not re-broadcast
1265
+ // Note: We still return the checkpoint obj so the lastBlock can be processed if valid
1266
+ if (!added) {
1267
+ this.peerManager.penalizePeer(peerId, PeerErrorSeverity.HighToleranceError);
1268
+ this.logger.warn(`Penalizing peer for checkpoint proposal exceeding per-slot cap`, {
1269
+ ...checkpoint.toCheckpointInfo(),
1270
+ count,
1271
+ source: peerId.toString(),
1272
+ });
1273
+ return { result: TopicValidatorResult.Reject, obj: checkpoint, metadata: { isEquivocated, processBlock } };
1274
+ }
1275
+
1276
+ // If this was a duplicate proposal, do not process it, but do invoke the duplicate callback,
1277
+ // and do re-broadcast it so other nodes in the network know to slash the proposer
1278
+ if (isEquivocated) {
1279
+ const proposer = checkpoint.getSender();
1280
+ this.logger.warn(`Detected duplicate checkpoint proposal (equivocation) at slot ${checkpoint.slotNumber}`, {
1281
+ ...checkpoint.toCheckpointInfo(),
1282
+ source: peerId.toString(),
1283
+ proposer: proposer?.toString(),
1284
+ });
1285
+ // Invoke the duplicate callback on the first duplicate spotted only
1286
+ if (proposer && count === 2) {
1287
+ this.duplicateProposalCallback?.({ slot: checkpoint.slotNumber, proposer, type: 'checkpoint' });
970
1288
  }
1289
+ return {
1290
+ result: TopicValidatorResult.Accept,
1291
+ obj: checkpoint,
1292
+ metadata: { isEquivocated, processBlock },
1293
+ };
971
1294
  }
1295
+
1296
+ // Otherwise, we're good to go!
1297
+ return { result: TopicValidatorResult.Accept, obj: checkpoint, metadata: { processBlock, isEquivocated } };
972
1298
  }
973
1299
 
974
1300
  /**
975
- * Broadcast an attestation to all peers.
976
- * @param attestation - The attestation to broadcast.
1301
+ * Process a validated checkpoint proposal.
1302
+ * Note: The proposal was already added to the pool by tryAddCheckpointProposal in handleGossipedCheckpointProposal.
977
1303
  */
978
- @trackSpan('Libp2pService.broadcastAttestation', async attestation => ({
979
- [Attributes.SLOT_NUMBER]: attestation.payload.header.slotNumber,
980
- [Attributes.BLOCK_ARCHIVE]: attestation.archive.toString(),
981
- [Attributes.P2P_ID]: await attestation.p2pMessageLoggingIdentifier().then(i => i.toString()),
1304
+ @trackSpan('Libp2pService.processValidCheckpointProposal', async checkpoint => ({
1305
+ [Attributes.SLOT_NUMBER]: checkpoint.slotNumber,
1306
+ [Attributes.BLOCK_ARCHIVE]: checkpoint.archive.toString(),
1307
+ [Attributes.P2P_ID]: await checkpoint.p2pMessageLoggingIdentifier().then(i => i.toString()),
982
1308
  }))
983
- private async broadcastAttestation(attestation: BlockAttestation) {
984
- await this.propagate(attestation);
1309
+ protected async processValidCheckpointProposal(checkpoint: CheckpointProposalCore, sender: PeerId) {
1310
+ const slot = checkpoint.slotNumber;
1311
+ this.logger.verbose(`Received checkpoint proposal for slot ${slot} from external peer ${sender.toString()}.`, {
1312
+ p2pMessageIdentifier: await checkpoint.p2pMessageLoggingIdentifier(),
1313
+ slot: checkpoint.slotNumber,
1314
+ archive: checkpoint.archive.toString(),
1315
+ source: sender.toString(),
1316
+ });
1317
+
1318
+ // Call the checkpoint received callback with the core version (without lastBlock)
1319
+ // to validate and potentially generate attestations
1320
+ const attestations = await this.checkpointReceivedCallback(checkpoint, sender);
1321
+ if (attestations && attestations.length > 0) {
1322
+ // If the callback returned attestations, add them to the pool and propagate them
1323
+ await this.mempools.attestationPool.addOwnCheckpointAttestations(attestations);
1324
+ for (const attestation of attestations) {
1325
+ await this.propagate(attestation);
1326
+ }
1327
+ }
985
1328
  }
986
1329
 
987
1330
  /**
@@ -1004,9 +1347,9 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1004
1347
  * @returns True if the requested block transactions are valid, false otherwise.
1005
1348
  */
1006
1349
  @trackSpan('Libp2pService.validateRequestedBlockTxs', request => ({
1007
- [Attributes.BLOCK_HASH]: request.blockHash.toString(),
1350
+ [Attributes.BLOCK_ARCHIVE]: request.archiveRoot.toString(),
1008
1351
  }))
1009
- private async validateRequestedBlockTxs(
1352
+ protected async validateRequestedBlockTxs(
1010
1353
  request: BlockTxsRequest,
1011
1354
  response: BlockTxsResponse,
1012
1355
  peerId: PeerId,
@@ -1014,10 +1357,10 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1014
1357
  const requestedTxValidator = this.createRequestedTxValidator();
1015
1358
 
1016
1359
  try {
1017
- if (!response.blockHash.equals(request.blockHash)) {
1360
+ if (!response.archiveRoot.equals(request.archiveRoot)) {
1018
1361
  this.peerManager.penalizePeer(peerId, PeerErrorSeverity.MidToleranceError);
1019
1362
  throw new ValidationError(
1020
- `Received block txs for unexpected block: expected ${request.blockHash.toString()}, got ${response.blockHash.toString()}`,
1363
+ `Received block txs for unexpected archive root: expected ${request.archiveRoot.toString()}, got ${response.archiveRoot.toString()}`,
1021
1364
  );
1022
1365
  }
1023
1366
 
@@ -1047,7 +1390,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1047
1390
  }
1048
1391
 
1049
1392
  // Given proposal (should have locally), ensure returned txs are valid subset and match request indices
1050
- const proposal = await this.mempools.attestationPool?.getBlockProposal(request.blockHash.toString());
1393
+ const proposal = await this.mempools.attestationPool.getBlockProposal(request.archiveRoot.toString());
1051
1394
  if (proposal) {
1052
1395
  // Build intersected indices
1053
1396
  const intersectIdx = request.txIndices.getTrueIndices().filter(i => response.txIndices.isSet(i));
@@ -1067,7 +1410,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1067
1410
  } else {
1068
1411
  // No local proposal, cannot check the membership/order of the returned txs
1069
1412
  this.logger.warn(
1070
- `Block proposal not found for block hash ${request.blockHash.toString()}; cannot validate membership/order of returned txs`,
1413
+ `Block proposal not found for archive root ${request.archiveRoot.toString()}; cannot validate membership/order of returned txs`,
1071
1414
  );
1072
1415
  return false;
1073
1416
  }
@@ -1106,7 +1449,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1106
1449
  const requested = new Set(requestedTxHash.map(h => h.toString()));
1107
1450
  const requestedTxValidator = this.createRequestedTxValidator();
1108
1451
 
1109
- //TODO: (mralj) - this is somewhat naive implementation, if single tx is invlid we consider the whole response invalid.
1452
+ //TODO: (mralj) - this is somewhat naive implementation, if single tx is invalid we consider the whole response invalid.
1110
1453
  // I think we should still extract the valid txs and return them, so that we can still use the response.
1111
1454
  try {
1112
1455
  await Promise.all(responseTx.map(tx => this.validateRequestedTx(tx, peerId, requestedTxValidator, requested)));
@@ -1136,7 +1479,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1136
1479
  @trackSpan('Libp2pService.validateRequestedBlock', (requestedBlockNumber, _responseBlock) => ({
1137
1480
  [Attributes.BLOCK_NUMBER]: requestedBlockNumber.toString(),
1138
1481
  }))
1139
- private async validateRequestedBlock(
1482
+ protected async validateRequestedBlock(
1140
1483
  requestedBlockNumber: Fr,
1141
1484
  responseBlock: L2Block,
1142
1485
  peerId: PeerId,
@@ -1169,27 +1512,13 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1169
1512
  }
1170
1513
  }
1171
1514
 
1172
- private createRequestedTxValidator(): TxValidator {
1173
- return new AggregateTxValidator(
1174
- new DataTxValidator(),
1175
- new MetadataTxValidator({
1176
- l1ChainId: new Fr(this.config.l1ChainId),
1177
- rollupVersion: new Fr(this.config.rollupVersion),
1178
- protocolContractsHash,
1179
- vkTreeRoot: getVKTreeRoot(),
1180
- }),
1181
- new TxProofValidator(this.proofVerifier),
1182
- );
1183
- }
1184
-
1185
- private async validateRequestedTx(tx: Tx, peerId: PeerId, txValidator: TxValidator, requested?: Set<`0x${string}`>) {
1515
+ protected async validateRequestedTx(
1516
+ tx: Tx,
1517
+ peerId: PeerId,
1518
+ txValidator: TxValidator,
1519
+ requested?: Set<`0x${string}`>,
1520
+ ) {
1186
1521
  const penalize = (severity: PeerErrorSeverity) => this.peerManager.penalizePeer(peerId, severity);
1187
-
1188
- if (!(await tx.validateTxHash())) {
1189
- penalize(PeerErrorSeverity.MidToleranceError);
1190
- throw new ValidationError(`Received tx with invalid hash ${tx.getTxHash().toString()}.`);
1191
- }
1192
-
1193
1522
  if (requested && !requested.has(tx.getTxHash().toString())) {
1194
1523
  penalize(PeerErrorSeverity.MidToleranceError);
1195
1524
  throw new ValidationError(`Received tx with hash ${tx.getTxHash().toString()} that was not requested.`);
@@ -1202,10 +1531,17 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1202
1531
  }
1203
1532
  }
1204
1533
 
1534
+ protected createRequestedTxValidator(): TxValidator {
1535
+ return createTxReqRespValidator(this.proofVerifier, {
1536
+ l1ChainId: this.config.l1ChainId,
1537
+ rollupVersion: this.config.rollupVersion,
1538
+ });
1539
+ }
1540
+
1205
1541
  @trackSpan('Libp2pService.validatePropagatedTx', tx => ({
1206
1542
  [Attributes.TX_HASH]: tx.getTxHash().toString(),
1207
1543
  }))
1208
- private async validatePropagatedTx(tx: Tx, peerId: PeerId): Promise<boolean> {
1544
+ protected async validatePropagatedTx(tx: Tx, peerId: PeerId): Promise<boolean> {
1209
1545
  const currentBlockNumber = await this.archiver.getBlockNumber();
1210
1546
 
1211
1547
  // We accept transactions if they are not expired by the next slot (checked based on the IncludeByTimestamp field)
@@ -1244,6 +1580,22 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1244
1580
  return gasFees;
1245
1581
  }
1246
1582
 
1583
+ /**
1584
+ * Get the BatchTxRequesterLibP2PService dependencies for creating BatchTxRequester instances
1585
+ */
1586
+ public getBatchTxRequesterService(): BatchTxRequesterLibP2PService {
1587
+ return {
1588
+ reqResp: this.reqresp,
1589
+ connectionSampler: this.reqresp.getConnectionSampler(),
1590
+ txValidatorConfig: {
1591
+ l1ChainId: this.config.l1ChainId,
1592
+ rollupVersion: this.config.rollupVersion,
1593
+ proofVerifier: this.proofVerifier,
1594
+ },
1595
+ peerScoring: this.peerManager,
1596
+ };
1597
+ }
1598
+
1247
1599
  public async validate(txs: Tx[]): Promise<void> {
1248
1600
  const currentBlockNumber = await this.archiver.getBlockNumber();
1249
1601
 
@@ -1294,6 +1646,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1294
1646
  this.proofVerifier,
1295
1647
  !this.config.disableTransactions,
1296
1648
  allowedInSetup,
1649
+ this.logger.getBindings(),
1297
1650
  );
1298
1651
  }
1299
1652
 
@@ -1347,15 +1700,18 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1347
1700
  return PeerErrorSeverity.HighToleranceError;
1348
1701
  }
1349
1702
 
1350
- const snapshotValidator = new DoubleSpendTxValidator({
1351
- nullifiersExist: async (nullifiers: Buffer[]) => {
1352
- const merkleTree = this.worldStateSynchronizer.getSnapshot(
1353
- BlockNumber(blockNumber - this.config.doubleSpendSeverePeerPenaltyWindow),
1354
- );
1355
- const indices = await merkleTree.findLeafIndices(MerkleTreeId.NULLIFIER_TREE, nullifiers);
1356
- return indices.map(index => index !== undefined);
1703
+ const snapshotValidator = new DoubleSpendTxValidator(
1704
+ {
1705
+ nullifiersExist: async (nullifiers: Buffer[]) => {
1706
+ const merkleTree = this.worldStateSynchronizer.getSnapshot(
1707
+ BlockNumber(blockNumber - this.config.doubleSpendSeverePeerPenaltyWindow),
1708
+ );
1709
+ const indices = await merkleTree.findLeafIndices(MerkleTreeId.NULLIFIER_TREE, nullifiers);
1710
+ return indices.map(index => index !== undefined);
1711
+ },
1357
1712
  },
1358
- });
1713
+ this.logger.getBindings(),
1714
+ );
1359
1715
 
1360
1716
  const validSnapshot = await snapshotValidator.validateTx(tx);
1361
1717
  if (validSnapshot.result !== 'valid') {
@@ -1366,44 +1722,28 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1366
1722
  }
1367
1723
 
1368
1724
  /**
1369
- * Validate an attestation.
1725
+ * Validate a checkpoint attestation.
1370
1726
  *
1371
- * @param attestation - The attestation to validate.
1372
- * @returns True if the attestation is valid, false otherwise.
1727
+ * @param attestation - The checkpoint attestation to validate.
1728
+ * @returns True if the checkpoint attestation is valid, false otherwise.
1373
1729
  */
1374
- @trackSpan('Libp2pService.validateAttestation', async (_, attestation) => ({
1730
+ @trackSpan('Libp2pService.validateCheckpointAttestation', async (_, attestation) => ({
1375
1731
  [Attributes.SLOT_NUMBER]: attestation.payload.header.slotNumber,
1376
1732
  [Attributes.BLOCK_ARCHIVE]: attestation.archive.toString(),
1377
1733
  [Attributes.P2P_ID]: await attestation.p2pMessageLoggingIdentifier().then(i => i.toString()),
1378
1734
  }))
1379
- public async validateAttestation(peerId: PeerId, attestation: BlockAttestation): Promise<boolean> {
1380
- const severity = await this.attestationValidator.validate(attestation);
1381
- if (severity) {
1382
- this.peerManager.penalizePeer(peerId, severity);
1383
- return false;
1384
- }
1385
-
1386
- return true;
1387
- }
1735
+ public async validateCheckpointAttestation(
1736
+ peerId: PeerId,
1737
+ attestation: CheckpointAttestation,
1738
+ ): Promise<P2PValidationResult> {
1739
+ const result = await this.checkpointAttestationValidator.validate(attestation);
1388
1740
 
1389
- /**
1390
- * Validate a block proposal.
1391
- *
1392
- * @param block - The block proposal to validate.
1393
- * @returns True if the block proposal is valid, false otherwise.
1394
- */
1395
- @trackSpan('Libp2pService.validateBlockProposal', (_peerId, block) => ({
1396
- [Attributes.SLOT_NUMBER]: block.payload.header.slotNumber.toString(),
1397
- }))
1398
- public async validateBlockProposal(peerId: PeerId, block: BlockProposal): Promise<boolean> {
1399
- const severity = await this.blockProposalValidator.validate(block);
1400
- if (severity) {
1401
- this.logger.debug(`Penalizing peer ${peerId} for block proposal validation failure`);
1402
- this.peerManager.penalizePeer(peerId, severity);
1403
- return false;
1741
+ if (result.result === 'reject') {
1742
+ this.logger.warn(`Penalizing peer ${peerId} for checkpoint attestation validation failure`);
1743
+ this.peerManager.penalizePeer(peerId, result.severity);
1404
1744
  }
1405
1745
 
1406
- return true;
1746
+ return result;
1407
1747
  }
1408
1748
 
1409
1749
  public getPeerScore(peerId: PeerId): number {