@aztec/p2p 0.0.1-commit.fcb71a6 → 0.0.1-commit.ff7989d6c

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