@aztec/p2p 0.0.1-commit.d431d1c → 0.0.1-commit.dbf9cec

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 (476) 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 +10 -10
  5. package/dest/client/factory.d.ts.map +1 -1
  6. package/dest/client/factory.js +45 -18
  7. package/dest/client/interface.d.ts +46 -33
  8. package/dest/client/interface.d.ts.map +1 -1
  9. package/dest/client/p2p_client.d.ts +41 -51
  10. package/dest/client/p2p_client.d.ts.map +1 -1
  11. package/dest/client/p2p_client.js +156 -200
  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 +304 -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 +21 -7
  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 +104 -88
  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 +353 -87
  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 +2 -2
  37. package/dest/mem_pools/attestation_pool/mocks.d.ts.map +1 -1
  38. package/dest/mem_pools/attestation_pool/mocks.js +2 -2
  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 +2 -2
  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 +3 -3
  48. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.d.ts.map +1 -1
  49. package/dest/mem_pools/tx_pool/eviction/eviction_manager.d.ts +3 -2
  50. package/dest/mem_pools/tx_pool/eviction/eviction_manager.d.ts.map +1 -1
  51. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.d.ts +3 -2
  52. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.d.ts.map +1 -1
  53. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.d.ts +3 -3
  54. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.d.ts.map +1 -1
  55. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.js +8 -1
  56. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.js +3 -3
  57. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.d.ts +3 -3
  58. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.d.ts.map +1 -1
  59. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.js +2 -0
  60. package/dest/mem_pools/tx_pool_v2/archive/index.d.ts +2 -0
  61. package/dest/mem_pools/tx_pool_v2/archive/index.d.ts.map +1 -0
  62. package/dest/mem_pools/tx_pool_v2/archive/index.js +1 -0
  63. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.d.ts +43 -0
  64. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.d.ts.map +1 -0
  65. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.js +103 -0
  66. package/dest/mem_pools/tx_pool_v2/deleted_pool.d.ts +104 -0
  67. package/dest/mem_pools/tx_pool_v2/deleted_pool.d.ts.map +1 -0
  68. package/dest/mem_pools/tx_pool_v2/deleted_pool.js +251 -0
  69. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.d.ts +47 -0
  70. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.d.ts.map +1 -0
  71. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.js +128 -0
  72. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.d.ts +17 -0
  73. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.d.ts.map +1 -0
  74. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.js +93 -0
  75. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.d.ts +19 -0
  76. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.d.ts.map +1 -0
  77. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.js +97 -0
  78. package/dest/mem_pools/tx_pool_v2/eviction/index.d.ts +10 -0
  79. package/dest/mem_pools/tx_pool_v2/eviction/index.d.ts.map +1 -0
  80. package/dest/mem_pools/tx_pool_v2/eviction/index.js +11 -0
  81. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.d.ts +174 -0
  82. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.d.ts.map +1 -0
  83. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.js +25 -0
  84. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.d.ts +15 -0
  85. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.d.ts.map +1 -0
  86. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.js +65 -0
  87. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.d.ts +17 -0
  88. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.d.ts.map +1 -0
  89. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.js +93 -0
  90. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.d.ts +16 -0
  91. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.d.ts.map +1 -0
  92. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.js +78 -0
  93. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.d.ts +20 -0
  94. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.d.ts.map +1 -0
  95. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.js +73 -0
  96. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.d.ts +15 -0
  97. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.d.ts.map +1 -0
  98. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.js +19 -0
  99. package/dest/mem_pools/tx_pool_v2/index.d.ts +6 -0
  100. package/dest/mem_pools/tx_pool_v2/index.d.ts.map +1 -0
  101. package/dest/mem_pools/tx_pool_v2/index.js +5 -0
  102. package/dest/mem_pools/tx_pool_v2/instrumentation.d.ts +15 -0
  103. package/dest/mem_pools/tx_pool_v2/instrumentation.d.ts.map +1 -0
  104. package/dest/mem_pools/tx_pool_v2/instrumentation.js +43 -0
  105. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts +211 -0
  106. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts.map +1 -0
  107. package/dest/mem_pools/tx_pool_v2/interfaces.js +9 -0
  108. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts +119 -0
  109. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts.map +1 -0
  110. package/dest/mem_pools/tx_pool_v2/tx_metadata.js +193 -0
  111. package/dest/mem_pools/tx_pool_v2/tx_pool_bench_metrics.d.ts +26 -0
  112. package/dest/mem_pools/tx_pool_v2/tx_pool_bench_metrics.d.ts.map +1 -0
  113. package/dest/mem_pools/tx_pool_v2/tx_pool_bench_metrics.js +70 -0
  114. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.d.ts +108 -0
  115. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.d.ts.map +1 -0
  116. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.js +354 -0
  117. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts +60 -0
  118. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts.map +1 -0
  119. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.js +161 -0
  120. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts +77 -0
  121. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts.map +1 -0
  122. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.js +905 -0
  123. package/dest/msg_validators/attestation_validator/attestation_validator.d.ts +3 -3
  124. package/dest/msg_validators/attestation_validator/attestation_validator.d.ts.map +1 -1
  125. package/dest/msg_validators/attestation_validator/attestation_validator.js +40 -9
  126. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts +5 -5
  127. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts.map +1 -1
  128. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.js +18 -6
  129. package/dest/msg_validators/clock_tolerance.d.ts +21 -0
  130. package/dest/msg_validators/clock_tolerance.d.ts.map +1 -0
  131. package/dest/msg_validators/clock_tolerance.js +37 -0
  132. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts +3 -3
  133. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts.map +1 -1
  134. package/dest/msg_validators/proposal_validator/proposal_validator.js +46 -15
  135. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.d.ts +3 -3
  136. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.d.ts.map +1 -1
  137. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.js +66 -11
  138. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts +4 -4
  139. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts.map +1 -1
  140. package/dest/msg_validators/tx_validator/aggregate_tx_validator.js +3 -3
  141. package/dest/msg_validators/tx_validator/archive_cache.d.ts +3 -3
  142. package/dest/msg_validators/tx_validator/archive_cache.d.ts.map +1 -1
  143. package/dest/msg_validators/tx_validator/archive_cache.js +1 -1
  144. package/dest/msg_validators/tx_validator/block_header_validator.d.ts +20 -6
  145. package/dest/msg_validators/tx_validator/block_header_validator.d.ts.map +1 -1
  146. package/dest/msg_validators/tx_validator/block_header_validator.js +4 -3
  147. package/dest/msg_validators/tx_validator/data_validator.d.ts +3 -1
  148. package/dest/msg_validators/tx_validator/data_validator.d.ts.map +1 -1
  149. package/dest/msg_validators/tx_validator/data_validator.js +4 -1
  150. package/dest/msg_validators/tx_validator/double_spend_validator.d.ts +15 -4
  151. package/dest/msg_validators/tx_validator/double_spend_validator.d.ts.map +1 -1
  152. package/dest/msg_validators/tx_validator/double_spend_validator.js +7 -6
  153. package/dest/msg_validators/tx_validator/factory.d.ts +118 -5
  154. package/dest/msg_validators/tx_validator/factory.d.ts.map +1 -1
  155. package/dest/msg_validators/tx_validator/factory.js +228 -57
  156. package/dest/msg_validators/tx_validator/gas_validator.d.ts +59 -3
  157. package/dest/msg_validators/tx_validator/gas_validator.d.ts.map +1 -1
  158. package/dest/msg_validators/tx_validator/gas_validator.js +76 -38
  159. package/dest/msg_validators/tx_validator/index.d.ts +2 -1
  160. package/dest/msg_validators/tx_validator/index.d.ts.map +1 -1
  161. package/dest/msg_validators/tx_validator/index.js +1 -0
  162. package/dest/msg_validators/tx_validator/metadata_validator.d.ts +3 -2
  163. package/dest/msg_validators/tx_validator/metadata_validator.d.ts.map +1 -1
  164. package/dest/msg_validators/tx_validator/metadata_validator.js +2 -2
  165. package/dest/msg_validators/tx_validator/nullifier_cache.d.ts +14 -0
  166. package/dest/msg_validators/tx_validator/nullifier_cache.d.ts.map +1 -0
  167. package/dest/msg_validators/tx_validator/nullifier_cache.js +24 -0
  168. package/dest/msg_validators/tx_validator/phases_validator.d.ts +3 -2
  169. package/dest/msg_validators/tx_validator/phases_validator.d.ts.map +1 -1
  170. package/dest/msg_validators/tx_validator/phases_validator.js +3 -3
  171. package/dest/msg_validators/tx_validator/size_validator.d.ts +3 -1
  172. package/dest/msg_validators/tx_validator/size_validator.d.ts.map +1 -1
  173. package/dest/msg_validators/tx_validator/size_validator.js +4 -1
  174. package/dest/msg_validators/tx_validator/timestamp_validator.d.ts +22 -5
  175. package/dest/msg_validators/tx_validator/timestamp_validator.d.ts.map +1 -1
  176. package/dest/msg_validators/tx_validator/timestamp_validator.js +8 -8
  177. package/dest/msg_validators/tx_validator/tx_permitted_validator.d.ts +3 -2
  178. package/dest/msg_validators/tx_validator/tx_permitted_validator.d.ts.map +1 -1
  179. package/dest/msg_validators/tx_validator/tx_permitted_validator.js +2 -2
  180. package/dest/msg_validators/tx_validator/tx_proof_validator.d.ts +3 -2
  181. package/dest/msg_validators/tx_validator/tx_proof_validator.d.ts.map +1 -1
  182. package/dest/msg_validators/tx_validator/tx_proof_validator.js +2 -2
  183. package/dest/services/data_store.d.ts +1 -1
  184. package/dest/services/data_store.d.ts.map +1 -1
  185. package/dest/services/data_store.js +10 -6
  186. package/dest/services/discv5/discV5_service.js +1 -1
  187. package/dest/services/dummy_service.d.ts +24 -4
  188. package/dest/services/dummy_service.d.ts.map +1 -1
  189. package/dest/services/dummy_service.js +46 -1
  190. package/dest/services/encoding.d.ts +3 -3
  191. package/dest/services/encoding.d.ts.map +1 -1
  192. package/dest/services/encoding.js +11 -10
  193. package/dest/services/gossipsub/index.d.ts +3 -0
  194. package/dest/services/gossipsub/index.d.ts.map +1 -0
  195. package/dest/services/gossipsub/index.js +2 -0
  196. package/dest/services/gossipsub/scoring.d.ts +21 -3
  197. package/dest/services/gossipsub/scoring.d.ts.map +1 -1
  198. package/dest/services/gossipsub/scoring.js +24 -7
  199. package/dest/services/gossipsub/topic_score_params.d.ts +173 -0
  200. package/dest/services/gossipsub/topic_score_params.d.ts.map +1 -0
  201. package/dest/services/gossipsub/topic_score_params.js +346 -0
  202. package/dest/services/index.d.ts +2 -1
  203. package/dest/services/index.d.ts.map +1 -1
  204. package/dest/services/index.js +1 -0
  205. package/dest/services/libp2p/instrumentation.d.ts +1 -1
  206. package/dest/services/libp2p/instrumentation.d.ts.map +1 -1
  207. package/dest/services/libp2p/instrumentation.js +14 -3
  208. package/dest/services/libp2p/libp2p_service.d.ts +101 -43
  209. package/dest/services/libp2p/libp2p_service.d.ts.map +1 -1
  210. package/dest/services/libp2p/libp2p_service.js +455 -363
  211. package/dest/services/peer-manager/metrics.d.ts +2 -2
  212. package/dest/services/peer-manager/metrics.d.ts.map +1 -1
  213. package/dest/services/peer-manager/metrics.js +20 -5
  214. package/dest/services/peer-manager/peer_scoring.d.ts +1 -1
  215. package/dest/services/peer-manager/peer_scoring.d.ts.map +1 -1
  216. package/dest/services/peer-manager/peer_scoring.js +33 -4
  217. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts +48 -0
  218. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts.map +1 -0
  219. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.js +539 -0
  220. package/dest/services/reqresp/batch-tx-requester/config.d.ts +17 -0
  221. package/dest/services/reqresp/batch-tx-requester/config.d.ts.map +1 -0
  222. package/dest/services/reqresp/batch-tx-requester/config.js +27 -0
  223. package/dest/services/reqresp/batch-tx-requester/interface.d.ts +46 -0
  224. package/dest/services/reqresp/batch-tx-requester/interface.d.ts.map +1 -0
  225. package/dest/services/reqresp/batch-tx-requester/interface.js +1 -0
  226. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts +34 -0
  227. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts.map +1 -0
  228. package/dest/services/reqresp/batch-tx-requester/missing_txs.js +130 -0
  229. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts +60 -0
  230. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts.map +1 -0
  231. package/dest/services/reqresp/batch-tx-requester/peer_collection.js +173 -0
  232. package/dest/services/reqresp/batch-tx-requester/tx_validator.d.ts +20 -0
  233. package/dest/services/reqresp/batch-tx-requester/tx_validator.d.ts.map +1 -0
  234. package/dest/services/reqresp/batch-tx-requester/tx_validator.js +21 -0
  235. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.d.ts +22 -3
  236. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.d.ts.map +1 -1
  237. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.js +63 -4
  238. package/dest/services/reqresp/connection-sampler/connection_sampler.d.ts +2 -1
  239. package/dest/services/reqresp/connection-sampler/connection_sampler.d.ts.map +1 -1
  240. package/dest/services/reqresp/connection-sampler/connection_sampler.js +12 -0
  241. package/dest/services/reqresp/interface.d.ts +14 -3
  242. package/dest/services/reqresp/interface.d.ts.map +1 -1
  243. package/dest/services/reqresp/interface.js +17 -3
  244. package/dest/services/reqresp/metrics.d.ts +6 -5
  245. package/dest/services/reqresp/metrics.d.ts.map +1 -1
  246. package/dest/services/reqresp/metrics.js +17 -5
  247. package/dest/services/reqresp/protocols/block_txs/bitvector.d.ts +5 -1
  248. package/dest/services/reqresp/protocols/block_txs/bitvector.d.ts.map +1 -1
  249. package/dest/services/reqresp/protocols/block_txs/bitvector.js +5 -0
  250. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts +7 -5
  251. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts.map +1 -1
  252. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.js +27 -9
  253. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts +29 -6
  254. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts.map +1 -1
  255. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.js +59 -13
  256. package/dest/services/reqresp/protocols/tx.d.ts +7 -1
  257. package/dest/services/reqresp/protocols/tx.d.ts.map +1 -1
  258. package/dest/services/reqresp/protocols/tx.js +20 -0
  259. package/dest/services/reqresp/reqresp.d.ts +6 -1
  260. package/dest/services/reqresp/reqresp.d.ts.map +1 -1
  261. package/dest/services/reqresp/reqresp.js +71 -27
  262. package/dest/services/service.d.ts +42 -3
  263. package/dest/services/service.d.ts.map +1 -1
  264. package/dest/services/tx_collection/config.d.ts +22 -1
  265. package/dest/services/tx_collection/config.d.ts.map +1 -1
  266. package/dest/services/tx_collection/config.js +55 -1
  267. package/dest/services/tx_collection/fast_tx_collection.d.ts +7 -4
  268. package/dest/services/tx_collection/fast_tx_collection.d.ts.map +1 -1
  269. package/dest/services/tx_collection/fast_tx_collection.js +71 -44
  270. package/dest/services/tx_collection/file_store_tx_collection.d.ts +53 -0
  271. package/dest/services/tx_collection/file_store_tx_collection.d.ts.map +1 -0
  272. package/dest/services/tx_collection/file_store_tx_collection.js +167 -0
  273. package/dest/services/tx_collection/file_store_tx_source.d.ts +37 -0
  274. package/dest/services/tx_collection/file_store_tx_source.d.ts.map +1 -0
  275. package/dest/services/tx_collection/file_store_tx_source.js +90 -0
  276. package/dest/services/tx_collection/index.d.ts +3 -1
  277. package/dest/services/tx_collection/index.d.ts.map +1 -1
  278. package/dest/services/tx_collection/index.js +2 -0
  279. package/dest/services/tx_collection/instrumentation.d.ts +1 -1
  280. package/dest/services/tx_collection/instrumentation.d.ts.map +1 -1
  281. package/dest/services/tx_collection/instrumentation.js +10 -2
  282. package/dest/services/tx_collection/missing_txs_tracker.d.ts +32 -0
  283. package/dest/services/tx_collection/missing_txs_tracker.d.ts.map +1 -0
  284. package/dest/services/tx_collection/missing_txs_tracker.js +27 -0
  285. package/dest/services/tx_collection/proposal_tx_collector.d.ts +49 -0
  286. package/dest/services/tx_collection/proposal_tx_collector.d.ts.map +1 -0
  287. package/dest/services/tx_collection/proposal_tx_collector.js +50 -0
  288. package/dest/services/tx_collection/slow_tx_collection.d.ts +9 -5
  289. package/dest/services/tx_collection/slow_tx_collection.d.ts.map +1 -1
  290. package/dest/services/tx_collection/slow_tx_collection.js +60 -26
  291. package/dest/services/tx_collection/tx_collection.d.ts +29 -16
  292. package/dest/services/tx_collection/tx_collection.d.ts.map +1 -1
  293. package/dest/services/tx_collection/tx_collection.js +79 -7
  294. package/dest/services/tx_collection/tx_collection_sink.d.ts +18 -8
  295. package/dest/services/tx_collection/tx_collection_sink.d.ts.map +1 -1
  296. package/dest/services/tx_collection/tx_collection_sink.js +26 -29
  297. package/dest/services/tx_collection/tx_source.d.ts +8 -3
  298. package/dest/services/tx_collection/tx_source.d.ts.map +1 -1
  299. package/dest/services/tx_collection/tx_source.js +19 -2
  300. package/dest/services/tx_file_store/config.d.ts +16 -0
  301. package/dest/services/tx_file_store/config.d.ts.map +1 -0
  302. package/dest/services/tx_file_store/config.js +22 -0
  303. package/dest/services/tx_file_store/index.d.ts +4 -0
  304. package/dest/services/tx_file_store/index.d.ts.map +1 -0
  305. package/dest/services/tx_file_store/index.js +3 -0
  306. package/dest/services/tx_file_store/instrumentation.d.ts +15 -0
  307. package/dest/services/tx_file_store/instrumentation.d.ts.map +1 -0
  308. package/dest/services/tx_file_store/instrumentation.js +29 -0
  309. package/dest/services/tx_file_store/tx_file_store.d.ts +48 -0
  310. package/dest/services/tx_file_store/tx_file_store.d.ts.map +1 -0
  311. package/dest/services/tx_file_store/tx_file_store.js +152 -0
  312. package/dest/services/tx_provider.d.ts +6 -6
  313. package/dest/services/tx_provider.d.ts.map +1 -1
  314. package/dest/services/tx_provider.js +9 -8
  315. package/dest/services/tx_provider_instrumentation.d.ts +1 -1
  316. package/dest/services/tx_provider_instrumentation.d.ts.map +1 -1
  317. package/dest/services/tx_provider_instrumentation.js +5 -5
  318. package/dest/test-helpers/index.d.ts +3 -1
  319. package/dest/test-helpers/index.d.ts.map +1 -1
  320. package/dest/test-helpers/index.js +2 -0
  321. package/dest/test-helpers/make-test-p2p-clients.d.ts +7 -8
  322. package/dest/test-helpers/make-test-p2p-clients.d.ts.map +1 -1
  323. package/dest/test-helpers/make-test-p2p-clients.js +1 -2
  324. package/dest/test-helpers/mock-pubsub.d.ts +30 -4
  325. package/dest/test-helpers/mock-pubsub.d.ts.map +1 -1
  326. package/dest/test-helpers/mock-pubsub.js +105 -4
  327. package/dest/test-helpers/reqresp-nodes.d.ts +2 -3
  328. package/dest/test-helpers/reqresp-nodes.d.ts.map +1 -1
  329. package/dest/test-helpers/reqresp-nodes.js +4 -3
  330. package/dest/test-helpers/test_tx_provider.d.ts +40 -0
  331. package/dest/test-helpers/test_tx_provider.d.ts.map +1 -0
  332. package/dest/test-helpers/test_tx_provider.js +41 -0
  333. package/dest/test-helpers/testbench-utils.d.ts +163 -0
  334. package/dest/test-helpers/testbench-utils.d.ts.map +1 -0
  335. package/dest/test-helpers/testbench-utils.js +366 -0
  336. package/dest/testbench/p2p_client_testbench_worker.d.ts +28 -2
  337. package/dest/testbench/p2p_client_testbench_worker.d.ts.map +1 -1
  338. package/dest/testbench/p2p_client_testbench_worker.js +219 -137
  339. package/dest/testbench/worker_client_manager.d.ts +51 -6
  340. package/dest/testbench/worker_client_manager.d.ts.map +1 -1
  341. package/dest/testbench/worker_client_manager.js +226 -44
  342. package/dest/util.d.ts +2 -2
  343. package/dest/util.d.ts.map +1 -1
  344. package/package.json +14 -14
  345. package/src/bootstrap/bootstrap.ts +7 -4
  346. package/src/client/factory.ts +83 -36
  347. package/src/client/interface.ts +56 -34
  348. package/src/client/p2p_client.ts +196 -251
  349. package/src/client/test/tx_proposal_collector/README.md +227 -0
  350. package/src/client/test/tx_proposal_collector/proposal_tx_collector_worker.ts +345 -0
  351. package/src/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.ts +43 -0
  352. package/src/config.ts +47 -11
  353. package/src/errors/tx-pool.error.ts +12 -0
  354. package/src/index.ts +1 -0
  355. package/src/mem_pools/attestation_pool/attestation_pool.ts +496 -91
  356. package/src/mem_pools/attestation_pool/attestation_pool_test_suite.ts +442 -102
  357. package/src/mem_pools/attestation_pool/index.ts +9 -2
  358. package/src/mem_pools/attestation_pool/mocks.ts +2 -1
  359. package/src/mem_pools/index.ts +4 -1
  360. package/src/mem_pools/instrumentation.ts +2 -1
  361. package/src/mem_pools/interface.ts +4 -4
  362. package/src/mem_pools/tx_pool/README.md +1 -1
  363. package/src/mem_pools/tx_pool/aztec_kv_tx_pool.ts +2 -2
  364. package/src/mem_pools/tx_pool/eviction/eviction_manager.ts +2 -1
  365. package/src/mem_pools/tx_pool/eviction/eviction_strategy.ts +2 -1
  366. package/src/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.ts +10 -7
  367. package/src/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.ts +3 -3
  368. package/src/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.ts +4 -2
  369. package/src/mem_pools/tx_pool_v2/README.md +275 -0
  370. package/src/mem_pools/tx_pool_v2/archive/index.ts +1 -0
  371. package/src/mem_pools/tx_pool_v2/archive/tx_archive.ts +120 -0
  372. package/src/mem_pools/tx_pool_v2/deleted_pool.ts +321 -0
  373. package/src/mem_pools/tx_pool_v2/eviction/eviction_manager.ts +160 -0
  374. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.ts +121 -0
  375. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.ts +125 -0
  376. package/src/mem_pools/tx_pool_v2/eviction/index.ts +27 -0
  377. package/src/mem_pools/tx_pool_v2/eviction/interfaces.ts +209 -0
  378. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.ts +74 -0
  379. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.ts +101 -0
  380. package/src/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.ts +91 -0
  381. package/src/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.ts +90 -0
  382. package/src/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.ts +31 -0
  383. package/src/mem_pools/tx_pool_v2/index.ts +12 -0
  384. package/src/mem_pools/tx_pool_v2/instrumentation.ts +69 -0
  385. package/src/mem_pools/tx_pool_v2/interfaces.ts +242 -0
  386. package/src/mem_pools/tx_pool_v2/tx_metadata.ts +297 -0
  387. package/src/mem_pools/tx_pool_v2/tx_pool_bench_metrics.ts +77 -0
  388. package/src/mem_pools/tx_pool_v2/tx_pool_indices.ts +444 -0
  389. package/src/mem_pools/tx_pool_v2/tx_pool_v2.ts +223 -0
  390. package/src/mem_pools/tx_pool_v2/tx_pool_v2_impl.ts +1083 -0
  391. package/src/msg_validators/attestation_validator/attestation_validator.ts +25 -13
  392. package/src/msg_validators/attestation_validator/fisherman_attestation_validator.ts +16 -10
  393. package/src/msg_validators/clock_tolerance.ts +51 -0
  394. package/src/msg_validators/proposal_validator/proposal_validator.ts +21 -14
  395. package/src/msg_validators/proposal_validator/proposal_validator_test_suite.ts +53 -14
  396. package/src/msg_validators/tx_validator/README.md +115 -0
  397. package/src/msg_validators/tx_validator/aggregate_tx_validator.ts +5 -5
  398. package/src/msg_validators/tx_validator/archive_cache.ts +3 -3
  399. package/src/msg_validators/tx_validator/block_header_validator.ts +21 -8
  400. package/src/msg_validators/tx_validator/data_validator.ts +6 -2
  401. package/src/msg_validators/tx_validator/double_spend_validator.ts +15 -9
  402. package/src/msg_validators/tx_validator/factory.ts +372 -55
  403. package/src/msg_validators/tx_validator/gas_validator.ts +98 -29
  404. package/src/msg_validators/tx_validator/index.ts +1 -0
  405. package/src/msg_validators/tx_validator/metadata_validator.ts +6 -3
  406. package/src/msg_validators/tx_validator/nullifier_cache.ts +30 -0
  407. package/src/msg_validators/tx_validator/phases_validator.ts +5 -3
  408. package/src/msg_validators/tx_validator/size_validator.ts +6 -2
  409. package/src/msg_validators/tx_validator/timestamp_validator.ts +29 -21
  410. package/src/msg_validators/tx_validator/tx_permitted_validator.ts +8 -3
  411. package/src/msg_validators/tx_validator/tx_proof_validator.ts +8 -3
  412. package/src/services/data_store.ts +10 -7
  413. package/src/services/discv5/discV5_service.ts +1 -1
  414. package/src/services/dummy_service.ts +59 -2
  415. package/src/services/encoding.ts +9 -9
  416. package/src/services/gossipsub/README.md +641 -0
  417. package/src/services/gossipsub/index.ts +2 -0
  418. package/src/services/gossipsub/scoring.ts +29 -5
  419. package/src/services/gossipsub/topic_score_params.ts +487 -0
  420. package/src/services/index.ts +1 -0
  421. package/src/services/libp2p/instrumentation.ts +15 -2
  422. package/src/services/libp2p/libp2p_service.ts +505 -396
  423. package/src/services/peer-manager/metrics.ts +21 -4
  424. package/src/services/peer-manager/peer_scoring.ts +29 -1
  425. package/src/services/reqresp/batch-tx-requester/README.md +305 -0
  426. package/src/services/reqresp/batch-tx-requester/batch_tx_requester.ts +678 -0
  427. package/src/services/reqresp/batch-tx-requester/config.ts +40 -0
  428. package/src/services/reqresp/batch-tx-requester/interface.ts +53 -0
  429. package/src/services/reqresp/batch-tx-requester/missing_txs.ts +161 -0
  430. package/src/services/reqresp/batch-tx-requester/peer_collection.ts +244 -0
  431. package/src/services/reqresp/batch-tx-requester/tx_validator.ts +37 -0
  432. package/src/services/reqresp/connection-sampler/batch_connection_sampler.ts +65 -4
  433. package/src/services/reqresp/connection-sampler/connection_sampler.ts +16 -0
  434. package/src/services/reqresp/interface.ts +31 -3
  435. package/src/services/reqresp/metrics.ts +34 -9
  436. package/src/services/reqresp/protocols/block_txs/bitvector.ts +7 -0
  437. package/src/services/reqresp/protocols/block_txs/block_txs_handler.ts +35 -12
  438. package/src/services/reqresp/protocols/block_txs/block_txs_reqresp.ts +74 -9
  439. package/src/services/reqresp/protocols/tx.ts +22 -0
  440. package/src/services/reqresp/reqresp.ts +82 -23
  441. package/src/services/service.ts +55 -2
  442. package/src/services/tx_collection/config.ts +83 -1
  443. package/src/services/tx_collection/fast_tx_collection.ts +93 -47
  444. package/src/services/tx_collection/file_store_tx_collection.ts +202 -0
  445. package/src/services/tx_collection/file_store_tx_source.ts +117 -0
  446. package/src/services/tx_collection/index.ts +6 -0
  447. package/src/services/tx_collection/instrumentation.ts +17 -2
  448. package/src/services/tx_collection/missing_txs_tracker.ts +52 -0
  449. package/src/services/tx_collection/proposal_tx_collector.ts +113 -0
  450. package/src/services/tx_collection/slow_tx_collection.ts +68 -35
  451. package/src/services/tx_collection/tx_collection.ts +121 -24
  452. package/src/services/tx_collection/tx_collection_sink.ts +30 -34
  453. package/src/services/tx_collection/tx_source.ts +22 -3
  454. package/src/services/tx_file_store/config.ts +37 -0
  455. package/src/services/tx_file_store/index.ts +3 -0
  456. package/src/services/tx_file_store/instrumentation.ts +36 -0
  457. package/src/services/tx_file_store/tx_file_store.ts +175 -0
  458. package/src/services/tx_provider.ts +12 -11
  459. package/src/services/tx_provider_instrumentation.ts +11 -5
  460. package/src/test-helpers/index.ts +2 -0
  461. package/src/test-helpers/make-test-p2p-clients.ts +3 -5
  462. package/src/test-helpers/mock-pubsub.ts +146 -9
  463. package/src/test-helpers/reqresp-nodes.ts +4 -6
  464. package/src/test-helpers/test_tx_provider.ts +64 -0
  465. package/src/test-helpers/testbench-utils.ts +430 -0
  466. package/src/testbench/p2p_client_testbench_worker.ts +333 -131
  467. package/src/testbench/worker_client_manager.ts +304 -47
  468. package/src/util.ts +7 -1
  469. package/dest/mem_pools/attestation_pool/kv_attestation_pool.d.ts +0 -40
  470. package/dest/mem_pools/attestation_pool/kv_attestation_pool.d.ts.map +0 -1
  471. package/dest/mem_pools/attestation_pool/kv_attestation_pool.js +0 -218
  472. package/dest/mem_pools/attestation_pool/memory_attestation_pool.d.ts +0 -31
  473. package/dest/mem_pools/attestation_pool/memory_attestation_pool.d.ts.map +0 -1
  474. package/dest/mem_pools/attestation_pool/memory_attestation_pool.js +0 -180
  475. package/src/mem_pools/attestation_pool/kv_attestation_pool.ts +0 -320
  476. package/src/mem_pools/attestation_pool/memory_attestation_pool.ts +0 -264
@@ -1,14 +1,12 @@
1
1
  import type { EpochCacheInterface } from '@aztec/epoch-cache';
2
- import { BlockNumber } 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
- import type { EthAddress, L2BlockNew, L2BlockSource } from '@aztec/stdlib/block';
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';
@@ -18,12 +16,12 @@ import {
18
16
  CheckpointProposal,
19
17
  type CheckpointProposalCore,
20
18
  type Gossipable,
21
- P2PClientType,
22
19
  P2PMessage,
20
+ type ValidationResult as P2PValidationResult,
23
21
  PeerErrorSeverity,
24
22
  TopicType,
25
23
  createTopicString,
26
- getTopicsForClientAndConfig,
24
+ getTopicsForConfig,
27
25
  metricsTopicStrToLabels,
28
26
  } from '@aztec/stdlib/p2p';
29
27
  import { MerkleTreeId } from '@aztec/stdlib/trees';
@@ -45,7 +43,7 @@ import {
45
43
  type GossipsubMessage,
46
44
  gossipsub,
47
45
  } from '@chainsafe/libp2p-gossipsub';
48
- import { createPeerScoreParams, createTopicScoreParams } from '@chainsafe/libp2p-gossipsub/score';
46
+ import { createPeerScoreParams } from '@chainsafe/libp2p-gossipsub/score';
49
47
  import { SignaturePolicy } from '@chainsafe/libp2p-gossipsub/types';
50
48
  import { noise } from '@chainsafe/libp2p-noise';
51
49
  import { yamux } from '@chainsafe/libp2p-yamux';
@@ -59,62 +57,62 @@ import { ENR } from '@nethermindeth/enr';
59
57
  import { createLibp2p } from 'libp2p';
60
58
 
61
59
  import type { P2PConfig } from '../../config.js';
62
- import { ProposalSlotCapExceededError } from '../../errors/attestation-pool.error.js';
63
60
  import type { MemPools } from '../../mem_pools/interface.js';
64
61
  import {
65
62
  BlockProposalValidator,
66
63
  CheckpointAttestationValidator,
67
64
  CheckpointProposalValidator,
65
+ DoubleSpendTxValidator,
68
66
  FishermanAttestationValidator,
69
- SizeTxValidator,
67
+ getDefaultAllowedSetupFunctions,
70
68
  } from '../../msg_validators/index.js';
71
69
  import { MessageSeenValidator } from '../../msg_validators/msg_seen_validator/msg_seen_validator.js';
72
- import { getDefaultAllowedSetupFunctions } from '../../msg_validators/tx_validator/allowed_public_setup.js';
73
- import { type MessageValidator, createTxMessageValidators } from '../../msg_validators/tx_validator/factory.js';
74
70
  import {
75
- AggregateTxValidator,
76
- DataTxValidator,
77
- DoubleSpendTxValidator,
78
- MetadataTxValidator,
79
- TxProofValidator,
80
- } from '../../msg_validators/tx_validator/index.js';
71
+ type TransactionValidator,
72
+ createFirstStageTxValidationsForGossipedTransactions,
73
+ createSecondStageTxValidationsForGossipedTransactions,
74
+ createTxValidatorForBlockProposalReceivedTxs,
75
+ createTxValidatorForReqResponseReceivedTxs,
76
+ } from '../../msg_validators/tx_validator/factory.js';
81
77
  import { GossipSubEvent } from '../../types/index.js';
82
78
  import { type PubSubLibp2p, convertToMultiaddr } from '../../util.js';
83
79
  import { getVersions } from '../../versioning.js';
84
80
  import { AztecDatastore } from '../data_store.js';
85
81
  import { DiscV5Service } from '../discv5/discV5_service.js';
86
82
  import { SnappyTransform, fastMsgIdFn, getMsgIdFn, msgIdToStrFn } from '../encoding.js';
87
- import { gossipScoreThresholds } from '../gossipsub/scoring.js';
83
+ import { APP_SPECIFIC_WEIGHT, gossipScoreThresholds } from '../gossipsub/scoring.js';
84
+ import { createAllTopicScoreParams } from '../gossipsub/topic_score_params.js';
88
85
  import type { PeerManagerInterface } from '../peer-manager/interface.js';
89
86
  import { PeerManager } from '../peer-manager/peer_manager.js';
90
87
  import { PeerScoring } from '../peer-manager/peer_scoring.js';
88
+ import type { BatchTxRequesterLibP2PService } from '../reqresp/batch-tx-requester/interface.js';
91
89
  import type { P2PReqRespConfig } from '../reqresp/config.js';
92
90
  import {
91
+ AuthRequest,
92
+ BlockTxsRequest,
93
+ BlockTxsResponse,
93
94
  DEFAULT_SUB_PROTOCOL_VALIDATORS,
94
95
  type ReqRespInterface,
96
+ type ReqRespResponse,
95
97
  ReqRespSubProtocol,
96
98
  type ReqRespSubProtocolHandler,
97
99
  type ReqRespSubProtocolHandlers,
98
100
  type ReqRespSubProtocolValidators,
101
+ StatusMessage,
99
102
  type SubProtocolMap,
100
103
  ValidationError,
101
- } from '../reqresp/interface.js';
102
- import { reqRespBlockTxsHandler } from '../reqresp/protocols/block_txs/block_txs_handler.js';
103
- import { reqGoodbyeHandler } from '../reqresp/protocols/goodbye.js';
104
- import {
105
- AuthRequest,
106
- BlockTxsRequest,
107
- BlockTxsResponse,
108
- StatusMessage,
109
104
  pingHandler,
105
+ reqGoodbyeHandler,
110
106
  reqRespBlockHandler,
107
+ reqRespBlockTxsHandler,
111
108
  reqRespStatusHandler,
112
109
  reqRespTxHandler,
113
- } from '../reqresp/protocols/index.js';
110
+ } from '../reqresp/index.js';
114
111
  import { ReqResp } from '../reqresp/reqresp.js';
115
112
  import type {
116
113
  P2PBlockReceivedCallback,
117
114
  P2PCheckpointReceivedCallback,
115
+ P2PDuplicateAttestationCallback,
118
116
  P2PService,
119
117
  PeerDiscoveryService,
120
118
  } from '../service.js';
@@ -129,14 +127,14 @@ interface ValidationResult {
129
127
  type ValidationOutcome = { allPassed: true } | { allPassed: false; failure: ValidationResult };
130
128
 
131
129
  // REFACTOR: Unify with the type above
132
- type ReceivedMessageValidationResult<T> =
133
- | { obj: T; result: Exclude<TopicValidatorResult, TopicValidatorResult.Reject> }
134
- | { obj?: undefined; result: TopicValidatorResult.Reject };
130
+ type ReceivedMessageValidationResult<T, M = undefined> =
131
+ | { obj: T; result: Exclude<TopicValidatorResult, TopicValidatorResult.Reject>; metadata?: M }
132
+ | { obj?: T; result: TopicValidatorResult.Reject; metadata?: M };
135
133
 
136
134
  /**
137
135
  * Lib P2P implementation of the P2PService interface.
138
136
  */
139
- export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends WithTracer implements P2PService {
137
+ export class LibP2PService extends WithTracer implements P2PService {
140
138
  private discoveryRunningPromise?: RunningPromise;
141
139
  private msgIdSeenValidators: Record<TopicType, MessageSeenValidator> = {} as Record<TopicType, MessageSeenValidator>;
142
140
 
@@ -150,6 +148,16 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
150
148
 
151
149
  private feesCache: { blockNumber: BlockNumber; gasFees: GasFees } | undefined;
152
150
 
151
+ /** Callback invoked when a duplicate proposal is detected (triggers slashing). */
152
+ private duplicateProposalCallback?: (info: {
153
+ slot: SlotNumber;
154
+ proposer: EthAddress;
155
+ type: 'checkpoint' | 'block';
156
+ }) => void;
157
+
158
+ /** Callback invoked when a duplicate attestation is detected (triggers slashing). */
159
+ private duplicateAttestationCallback?: P2PDuplicateAttestationCallback;
160
+
153
161
  /**
154
162
  * Callback for when a block is received from a peer.
155
163
  * @param block - The block received from the peer.
@@ -173,14 +181,13 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
173
181
  protected logger: Logger;
174
182
 
175
183
  constructor(
176
- private clientType: T,
177
184
  private config: P2PConfig,
178
185
  protected node: PubSubLibp2p,
179
186
  private peerDiscoveryService: PeerDiscoveryService,
180
187
  private reqresp: ReqRespInterface,
181
- private peerManager: PeerManagerInterface,
188
+ protected peerManager: PeerManagerInterface,
182
189
  protected mempools: MemPools,
183
- private archiver: L2BlockSource & ContractDataSource,
190
+ protected archiver: L2BlockSource & ContractDataSource,
184
191
  private epochCache: EpochCacheInterface,
185
192
  private proofVerifier: ClientProtocolCircuitVerifier,
186
193
  private worldStateSynchronizer: WorldStateSynchronizer,
@@ -253,8 +260,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
253
260
  * @param txPool - The transaction pool to be accessed by the service.
254
261
  * @returns The new service.
255
262
  */
256
- public static async new<T extends P2PClientType>(
257
- clientType: T,
263
+ public static async new(
258
264
  config: P2PConfig,
259
265
  peerId: PeerId,
260
266
  deps: {
@@ -285,14 +291,14 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
285
291
 
286
292
  const datastore = new AztecDatastore(peerStore);
287
293
 
288
- const otelMetricsAdapter = new OtelMetricsAdapter(telemetry);
294
+ const otelMetricsAdapter = new OtelMetricsAdapter(telemetry, logger.getBindings());
289
295
 
290
296
  const peerDiscoveryService = new DiscV5Service(
291
297
  peerId,
292
298
  config,
293
299
  packageVersion,
294
300
  telemetry,
295
- createLogger(`${logger.module}:discv5_service`),
301
+ createLogger(`${logger.module}:discv5_service`, logger.getBindings()),
296
302
  );
297
303
 
298
304
  // Seed libp2p's bootstrap discovery with private and trusted peers
@@ -306,11 +312,6 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
306
312
  const versions = getVersions(config);
307
313
  const protocolVersion = compressComponentVersions(versions);
308
314
 
309
- const txTopic = createTopicString(TopicType.tx, protocolVersion);
310
- const blockProposalTopic = createTopicString(TopicType.block_proposal, protocolVersion);
311
- const checkpointProposalTopic = createTopicString(TopicType.checkpoint_proposal, protocolVersion);
312
- const checkpointAttestationTopic = createTopicString(TopicType.checkpoint_attestation, protocolVersion);
313
-
314
315
  const preferredPeersEnrs: ENR[] = config.preferredPeers.map(enr => ENR.decodeTxt(enr));
315
316
  const directPeers = (
316
317
  await Promise.all(
@@ -330,6 +331,16 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
330
331
 
331
332
  const announceTcpMultiaddr = config.p2pIp ? [convertToMultiaddr(config.p2pIp, p2pPort, 'tcp')] : [];
332
333
 
334
+ // Create dynamic topic score params based on network configuration
335
+ const l1Constants = epochCache.getL1Constants();
336
+ const topicScoreParams = createAllTopicScoreParams(protocolVersion, {
337
+ slotDurationMs: l1Constants.slotDuration * 1000,
338
+ heartbeatIntervalMs: config.gossipsubInterval,
339
+ targetCommitteeSize: l1Constants.targetCommitteeSize,
340
+ blockDurationMs: config.blockDurationMs,
341
+ expectedBlockProposalsPerSlot: config.expectedBlockProposalsPerSlot,
342
+ });
343
+
333
344
  const node = await createLibp2p({
334
345
  start: false,
335
346
  peerId,
@@ -425,35 +436,14 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
425
436
  scoreParams: createPeerScoreParams({
426
437
  // IPColocation factor can be disabled for local testing - default to -5
427
438
  IPColocationFactorWeight: config.debugDisableColocationPenalty ? 0 : -5.0,
428
- topics: {
429
- [txTopic]: createTopicScoreParams({
430
- topicWeight: 1,
431
- invalidMessageDeliveriesWeight: -20,
432
- invalidMessageDeliveriesDecay: 0.5,
433
- }),
434
- [blockProposalTopic]: createTopicScoreParams({
435
- topicWeight: 1,
436
- invalidMessageDeliveriesWeight: -20,
437
- invalidMessageDeliveriesDecay: 0.5,
438
- }),
439
- [checkpointProposalTopic]: createTopicScoreParams({
440
- topicWeight: 1,
441
- invalidMessageDeliveriesWeight: -20,
442
- invalidMessageDeliveriesDecay: 0.5,
443
- }),
444
- [checkpointAttestationTopic]: createTopicScoreParams({
445
- topicWeight: 1,
446
- invalidMessageDeliveriesWeight: -20,
447
- invalidMessageDeliveriesDecay: 0.5,
448
- }),
449
- },
439
+ topics: topicScoreParams,
450
440
  }),
451
441
  }) as (components: GossipSubComponents) => GossipSub,
452
442
  components: (components: { connectionManager: ConnectionManager }) => ({
453
443
  connectionManager: components.connectionManager,
454
444
  }),
455
445
  },
456
- logger: createLibp2pComponentLogger(logger.module),
446
+ logger: createLibp2pComponentLogger(logger.module, logger.getBindings()),
457
447
  });
458
448
 
459
449
  const peerScoring = new PeerScoring(config, telemetry);
@@ -472,13 +462,16 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
472
462
  epochCache,
473
463
  );
474
464
 
475
- // Update gossipsub score params
476
- node.services.pubsub.score.params.appSpecificWeight = 10;
465
+ // Configure application-specific scoring for gossipsub.
466
+ // The weight scales app score to align with gossipsub thresholds:
467
+ // - Disconnect (-50) × 10 = -500 = gossipThreshold (stops receiving gossip)
468
+ // - Ban (-100) × 10 = -1000 = publishThreshold (cannot publish)
469
+ // Note: positive topic scores can offset penalties, so alignment is best-effort.
470
+ node.services.pubsub.score.params.appSpecificWeight = APP_SPECIFIC_WEIGHT;
477
471
  node.services.pubsub.score.params.appSpecificScore = (peerId: string) =>
478
472
  peerManager.shouldDisableP2PGossip(peerId) ? -Infinity : peerManager.getPeerScore(peerId);
479
473
 
480
474
  return new LibP2PService(
481
- clientType,
482
475
  config,
483
476
  node,
484
477
  peerDiscoveryService,
@@ -525,7 +518,11 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
525
518
  };
526
519
 
527
520
  if (!this.config.disableTransactions) {
528
- const blockTxsHandler = reqRespBlockTxsHandler(this.mempools.attestationPool, this.mempools.txPool);
521
+ const blockTxsHandler = reqRespBlockTxsHandler(
522
+ this.mempools.attestationPool,
523
+ this.archiver,
524
+ this.mempools.txPool,
525
+ );
529
526
  requestResponseHandlers[ReqRespSubProtocol.BLOCK_TXS] = blockTxsHandler.bind(this);
530
527
  }
531
528
 
@@ -548,7 +545,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
548
545
  await this.node.start();
549
546
 
550
547
  // Subscribe to standard GossipSub topics by default
551
- for (const topic of getTopicsForClientAndConfig(this.clientType, this.config.disableTransactions)) {
548
+ for (const topic of getTopicsForConfig(this.config.disableTransactions)) {
552
549
  this.subscribeToTopic(this.topicStrings[topic]);
553
550
  }
554
551
 
@@ -614,6 +611,10 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
614
611
  return this.peerManager.getPeers(includePending);
615
612
  }
616
613
 
614
+ public getGossipMeshPeerCount(topicType: TopicType): number {
615
+ return this.node.services.pubsub.getMeshPeers(this.topicStrings[topicType]).length;
616
+ }
617
+
617
618
  private handleGossipSubEvent(e: CustomEvent<GossipsubMessage>) {
618
619
  this.logger.trace(`Received PUBSUB message.`);
619
620
 
@@ -641,6 +642,15 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
641
642
  return this.reqresp.sendBatchRequest(protocol, requests, pinnedPeerId);
642
643
  }
643
644
 
645
+ public sendRequestToPeer(
646
+ peerId: PeerId,
647
+ subProtocol: ReqRespSubProtocol,
648
+ payload: Buffer,
649
+ dialTimeout?: number,
650
+ ): Promise<ReqRespResponse> {
651
+ return this.reqresp.sendRequestToPeer(peerId, subProtocol, payload, dialTimeout);
652
+ }
653
+
644
654
  /**
645
655
  * Get the ENR of the node
646
656
  * @returns The ENR of the node
@@ -657,6 +667,25 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
657
667
  this.checkpointReceivedCallback = callback;
658
668
  }
659
669
 
670
+ /**
671
+ * Registers a callback to be invoked when a duplicate proposal is detected.
672
+ * This callback is triggered on the first duplicate (when count goes from 1 to 2).
673
+ */
674
+ public registerDuplicateProposalCallback(
675
+ callback: (info: { slot: SlotNumber; proposer: EthAddress; type: 'checkpoint' | 'block' }) => void,
676
+ ): void {
677
+ this.duplicateProposalCallback = callback;
678
+ }
679
+
680
+ /**
681
+ * Registers a callback to be invoked when a duplicate attestation is detected.
682
+ * A validator signing attestations for different proposals at the same slot.
683
+ * This callback is triggered on the first duplicate (when count goes from 1 to 2).
684
+ */
685
+ public registerDuplicateAttestationCallback(callback: P2PDuplicateAttestationCallback): void {
686
+ this.duplicateAttestationCallback = callback;
687
+ }
688
+
660
689
  /**
661
690
  * Subscribes to a topic.
662
691
  * @param topic - The topic to subscribe to.
@@ -785,9 +814,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
785
814
  if (msg.topic === this.topicStrings[TopicType.tx]) {
786
815
  await this.handleGossipedTx(p2pMessage.payload, msgId, source);
787
816
  } else if (msg.topic === this.topicStrings[TopicType.checkpoint_attestation]) {
788
- if (this.clientType === P2PClientType.Full) {
789
- await this.processCheckpointAttestationFromPeer(p2pMessage.payload, msgId, source);
790
- }
817
+ await this.processCheckpointAttestationFromPeer(p2pMessage.payload, msgId, source);
791
818
  } else if (msg.topic === this.topicStrings[TopicType.block_proposal]) {
792
819
  await this.processBlockFromPeer(p2pMessage.payload, msgId, source);
793
820
  } else if (msg.topic === this.topicStrings[TopicType.checkpoint_proposal]) {
@@ -843,13 +870,13 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
843
870
  return;
844
871
  }
845
872
 
846
- protected async validateReceivedMessage<T>(
847
- validationFunc: () => Promise<ReceivedMessageValidationResult<T>>,
873
+ protected async validateReceivedMessage<T, M = undefined>(
874
+ validationFunc: () => Promise<ReceivedMessageValidationResult<T, M>>,
848
875
  msgId: string,
849
876
  source: PeerId,
850
877
  topicType: TopicType,
851
- ): Promise<ReceivedMessageValidationResult<T>> {
852
- let resultAndObj: ReceivedMessageValidationResult<T> = { result: TopicValidatorResult.Reject };
878
+ ): Promise<ReceivedMessageValidationResult<T, M>> {
879
+ let resultAndObj: ReceivedMessageValidationResult<T, M> = { result: TopicValidatorResult.Reject };
853
880
  const timer = new Timer();
854
881
  try {
855
882
  resultAndObj = await validationFunc();
@@ -873,21 +900,63 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
873
900
  protected async handleGossipedTx(payloadData: Buffer, msgId: string, source: PeerId) {
874
901
  const validationFunc: () => Promise<ReceivedMessageValidationResult<Tx>> = async () => {
875
902
  const tx = Tx.fromBuffer(payloadData);
876
- const isValid = await this.validatePropagatedTx(tx, source);
877
- const exists = isValid && (await this.mempools.txPool.hasTx(tx.getTxHash()));
903
+
904
+ const currentBlockNumber = await this.archiver.getBlockNumber();
905
+ const { ts: nextSlotTimestamp } = this.epochCache.getEpochAndSlotInNextL1Slot();
906
+
907
+ // Stage 1: fast validators (metadata, data, timestamps, double-spend, gas, phases, block header)
908
+ const firstStageValidators = await this.createFirstStageMessageValidators(currentBlockNumber, nextSlotTimestamp);
909
+ const firstStageOutcome = await this.runValidations(tx, firstStageValidators);
910
+ if (!firstStageOutcome.allPassed) {
911
+ const { name } = firstStageOutcome.failure;
912
+ let { severity } = firstStageOutcome.failure;
913
+
914
+ // Double spend validator has a special case handler. We perform more detailed examination
915
+ // as to how recently the nullifier was entered into the tree and if the transaction should
916
+ // have 'known' the nullifier existed. This determines the severity of the penalty applied to the peer.
917
+ if (name === 'doubleSpendValidator') {
918
+ const txBlockNumber = BlockNumber(currentBlockNumber + 1);
919
+ severity = await this.handleDoubleSpendFailure(tx, txBlockNumber);
920
+ }
921
+
922
+ this.peerManager.penalizePeer(source, severity);
923
+ return { result: TopicValidatorResult.Reject };
924
+ }
925
+
926
+ // Pool pre-check: see if the pool would accept this tx before doing expensive proof verification
927
+ const canAdd = await this.mempools.txPool.canAddPendingTx(tx);
928
+ if (canAdd === 'ignored') {
929
+ return { result: TopicValidatorResult.Ignore, obj: tx };
930
+ }
931
+
932
+ // Stage 2: expensive proof verification
933
+ const secondStageValidators = this.createSecondStageMessageValidators();
934
+ const secondStageOutcome = await this.runValidations(tx, secondStageValidators);
935
+ if (!secondStageOutcome.allPassed) {
936
+ const { severity } = secondStageOutcome.failure;
937
+ this.peerManager.penalizePeer(source, severity);
938
+ return { result: TopicValidatorResult.Reject };
939
+ }
940
+
941
+ // Pool add: persist the tx
942
+ const txHash = tx.getTxHash();
943
+ const addResult = await this.mempools.txPool.addPendingTxs([tx], { source: 'gossip' });
944
+
945
+ const wasAccepted = addResult.accepted.some(h => h.equals(txHash));
946
+ const wasIgnored = addResult.ignored.some(h => h.equals(txHash));
878
947
 
879
948
  this.logger.trace(`Validate propagated tx`, {
880
- isValid,
881
- exists,
949
+ wasAccepted,
950
+ wasIgnored,
882
951
  [Attributes.P2P_ID]: source.toString(),
883
952
  });
884
953
 
885
- if (!isValid) {
886
- return { result: TopicValidatorResult.Reject };
887
- } else if (exists) {
954
+ if (wasAccepted) {
955
+ return { result: TopicValidatorResult.Accept, obj: tx };
956
+ } else if (wasIgnored) {
888
957
  return { result: TopicValidatorResult.Ignore, obj: tx };
889
958
  } else {
890
- return { result: TopicValidatorResult.Accept, obj: tx };
959
+ return { result: TopicValidatorResult.Reject };
891
960
  }
892
961
  };
893
962
 
@@ -896,6 +965,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
896
965
  return;
897
966
  }
898
967
 
968
+ // Tx was accepted into pool and will be propagated - just log and record metrics
899
969
  const txHash = tx.getTxHash();
900
970
  const txHashString = txHash.toString();
901
971
  this.logger.verbose(`Received tx ${txHashString} from external peer ${source.toString()} via gossip`, {
@@ -903,13 +973,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
903
973
  txHash: txHashString,
904
974
  });
905
975
 
906
- if (this.config.dropTransactions && randomInt(1000) < this.config.dropTransactionsProbability * 1000) {
907
- this.logger.warn(`Intentionally dropping tx ${txHashString} (probability rule)`);
908
- return;
909
- }
910
-
911
976
  this.instrumentation.incrementTxReceived(1);
912
- await this.mempools.txPool.addTxs([tx]);
913
977
  }
914
978
 
915
979
  /**
@@ -921,46 +985,8 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
921
985
  msgId: string,
922
986
  source: PeerId,
923
987
  ): Promise<void> {
924
- const validationFunc: () => Promise<ReceivedMessageValidationResult<CheckpointAttestation>> = async () => {
925
- const attestation = CheckpointAttestation.fromBuffer(payloadData);
926
- const pool = this.mempools.attestationPool;
927
- const isValid = await this.validateCheckpointAttestation(source, attestation);
928
- const exists = isValid && (await pool.hasCheckpointAttestation(attestation));
929
-
930
- let canAdd = true;
931
- if (isValid && !exists) {
932
- const slot = attestation.payload.header.slotNumber;
933
- const { committee } = await this.epochCache.getCommittee(slot);
934
- const committeeSize = committee?.length ?? 0;
935
- canAdd = await pool.canAddCheckpointAttestation(attestation, committeeSize);
936
- }
937
-
938
- this.logger.trace(`Validate propagated checkpoint attestation`, {
939
- isValid,
940
- exists,
941
- canAdd,
942
- [Attributes.SLOT_NUMBER]: attestation.payload.header.slotNumber.toString(),
943
- [Attributes.P2P_ID]: source.toString(),
944
- });
945
-
946
- if (!isValid) {
947
- return { result: TopicValidatorResult.Reject };
948
- } else if (exists) {
949
- return { result: TopicValidatorResult.Ignore, obj: attestation };
950
- } else if (!canAdd) {
951
- this.logger.warn(`Dropping checkpoint attestation due to per-(slot, proposalId) attestation cap`, {
952
- slot: attestation.payload.header.slotNumber.toString(),
953
- archive: attestation.archive.toString(),
954
- source: source.toString(),
955
- });
956
- return { result: TopicValidatorResult.Ignore, obj: attestation };
957
- } else {
958
- return { result: TopicValidatorResult.Accept, obj: attestation };
959
- }
960
- };
961
-
962
988
  const { result, obj: attestation } = await this.validateReceivedMessage<CheckpointAttestation>(
963
- validationFunc,
989
+ () => this.validateAndStoreCheckpointAttestation(source, CheckpointAttestation.fromBuffer(payloadData)),
964
990
  msgId,
965
991
  source,
966
992
  TopicType.checkpoint_attestation,
@@ -970,8 +996,8 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
970
996
  return;
971
997
  }
972
998
 
973
- this.logger.debug(
974
- `Received checkpoint attestation for slot ${attestation.slotNumber} from external peer ${source.toString()}`,
999
+ this.logger.verbose(
1000
+ `Received valid checkpoint attestation for slot ${attestation.slotNumber} from external peer ${source.toString()}`,
975
1001
  {
976
1002
  p2pMessageIdentifier: await attestation.p2pMessageLoggingIdentifier(),
977
1003
  slot: attestation.slotNumber,
@@ -979,59 +1005,167 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
979
1005
  source: source.toString(),
980
1006
  },
981
1007
  );
982
-
983
- await this.mempools.attestationPool.addCheckpointAttestations([attestation]);
984
1008
  }
985
1009
 
986
- private async processBlockFromPeer(payloadData: Buffer, msgId: string, source: PeerId): Promise<void> {
987
- const validationFunc: () => Promise<ReceivedMessageValidationResult<BlockProposal>> = async () => {
988
- const block = BlockProposal.fromBuffer(payloadData);
989
- const isValid = await this.validateBlockProposal(source, block);
990
- const pool = this.mempools.attestationPool;
1010
+ /** Validates a checkpoint attestation and adds it to the pool. Penalizes the peer if validation fails. */
1011
+ @trackSpan('Libp2pService.validateAndStoreCheckpointAttestation', (_peerId, attestation) => ({
1012
+ [Attributes.SLOT_NUMBER]: attestation.payload.header.slotNumber.toString(),
1013
+ }))
1014
+ protected async validateAndStoreCheckpointAttestation(
1015
+ peerId: PeerId,
1016
+ attestation: CheckpointAttestation,
1017
+ ): Promise<ReceivedMessageValidationResult<CheckpointAttestation>> {
1018
+ const validationResult = await this.checkpointAttestationValidator.validate(attestation);
1019
+
1020
+ if (validationResult.result === 'reject') {
1021
+ this.logger.warn(`Penalizing peer ${peerId} for checkpoint attestation validation failure`);
1022
+ this.peerManager.penalizePeer(peerId, validationResult.severity);
1023
+ return { result: TopicValidatorResult.Reject };
1024
+ }
991
1025
 
992
- const exists = isValid && (await pool.hasBlockProposal(block));
993
- const canAdd = isValid && (await pool.canAddProposal(block));
1026
+ if (validationResult.result === 'ignore') {
1027
+ return { result: TopicValidatorResult.Ignore, obj: attestation };
1028
+ }
994
1029
 
995
- this.logger.trace(`Validate propagated block proposal`, {
996
- isValid,
997
- exists,
998
- canAdd,
999
- [Attributes.SLOT_NUMBER]: block.slotNumber.toString(),
1000
- [Attributes.P2P_ID]: source.toString(),
1030
+ // Try to add the attestation: this handles existence check, cap check, and adding in one call
1031
+ // count is the number of attestations by this signer for this slot (for duplicate detection)
1032
+ const slot = attestation.payload.header.slotNumber;
1033
+ const { added, alreadyExists, count } =
1034
+ await this.mempools.attestationPool.tryAddCheckpointAttestation(attestation);
1035
+
1036
+ this.logger.trace(`Validate propagated checkpoint attestation`, {
1037
+ added,
1038
+ alreadyExists,
1039
+ count,
1040
+ [Attributes.SLOT_NUMBER]: slot.toString(),
1041
+ [Attributes.P2P_ID]: peerId.toString(),
1042
+ });
1043
+
1044
+ // Exact same attestation received, no need to re-broadcast
1045
+ if (alreadyExists) {
1046
+ return { result: TopicValidatorResult.Ignore, obj: attestation };
1047
+ }
1048
+
1049
+ // Could not add (cap reached for signer), no need to re-broadcast
1050
+ if (!added) {
1051
+ this.logger.warn(`Dropping checkpoint attestation due to cap`, {
1052
+ slot: slot.toString(),
1053
+ archive: attestation.archive.toString(),
1054
+ source: peerId.toString(),
1055
+ attester: attestation.getSender()?.toString(),
1056
+ count,
1001
1057
  });
1058
+ return { result: TopicValidatorResult.Ignore, obj: attestation };
1059
+ }
1002
1060
 
1003
- if (!isValid) {
1004
- return { result: TopicValidatorResult.Reject };
1005
- } else if (exists) {
1006
- return { result: TopicValidatorResult.Ignore, obj: block };
1007
- } else if (!canAdd) {
1008
- this.peerManager.penalizePeer(source, PeerErrorSeverity.MidToleranceError);
1009
- this.logger.warn(`Penalizing peer for block proposal exceeding per-slot cap`, {
1010
- slot: block.slotNumber.toString(),
1011
- archive: block.archive.toString(),
1012
- source: source.toString(),
1061
+ // Check if this is a duplicate attestation (signer attested to a different proposal at the same slot)
1062
+ // count is the number of attestations by this signer for this slot
1063
+ if (count === 2) {
1064
+ const attester = attestation.getSender();
1065
+ if (attester) {
1066
+ this.logger.warn(`Detected duplicate attestation (equivocation) at slot ${slot}`, {
1067
+ slot: slot.toString(),
1068
+ archive: attestation.archive.toString(),
1069
+ source: peerId.toString(),
1070
+ attester: attester.toString(),
1013
1071
  });
1014
- return { result: TopicValidatorResult.Reject };
1015
- } else {
1016
- return { result: TopicValidatorResult.Accept, obj: block };
1072
+ this.duplicateAttestationCallback?.({ slot, attester });
1017
1073
  }
1018
- };
1074
+ }
1075
+
1076
+ // Attestation was added successfully - accept it so other nodes can also detect the equivocation
1077
+ return { result: TopicValidatorResult.Accept, obj: attestation };
1078
+ }
1019
1079
 
1020
- const { result, obj: block } = await this.validateReceivedMessage<BlockProposal>(
1021
- validationFunc,
1080
+ protected async processBlockFromPeer(payloadData: Buffer, msgId: string, source: PeerId): Promise<void> {
1081
+ const {
1082
+ result,
1083
+ obj: block,
1084
+ metadata: { isEquivocated } = {},
1085
+ } = await this.validateReceivedMessage<BlockProposal, { isEquivocated: boolean }>(
1086
+ () => this.validateAndStoreBlockProposal(source, BlockProposal.fromBuffer(payloadData)),
1022
1087
  msgId,
1023
1088
  source,
1024
1089
  TopicType.block_proposal,
1025
1090
  );
1026
1091
 
1027
- if (!result || !block) {
1092
+ // If not accepted or equivocated, return
1093
+ if (result !== TopicValidatorResult.Accept || !block || isEquivocated) {
1028
1094
  return;
1029
1095
  }
1030
1096
 
1031
1097
  await this.processValidBlockProposal(block, source);
1032
1098
  }
1033
1099
 
1034
- // REVIEW: callback pattern https://github.com/AztecProtocol/aztec-packages/issues/7963
1100
+ /** Validates a block proposal. Triggers a penalization to the peer that sent it if invalid. Adds to the mempool if valid. */
1101
+ @trackSpan('Libp2pService.validateAndStoreBlockProposal', (_peerId, block) => ({
1102
+ [Attributes.BLOCK_NUMBER]: block.blockNumber.toString(),
1103
+ [Attributes.SLOT_NUMBER]: block.slotNumber.toString(),
1104
+ }))
1105
+ protected async validateAndStoreBlockProposal(
1106
+ peerId: PeerId,
1107
+ block: BlockProposal,
1108
+ ): Promise<ReceivedMessageValidationResult<BlockProposal, { isEquivocated: boolean }>> {
1109
+ const validationResult = await this.blockProposalValidator.validate(block);
1110
+
1111
+ if (validationResult.result === 'reject') {
1112
+ this.logger.warn(`Penalizing peer ${peerId} for block proposal validation failure`);
1113
+ this.peerManager.penalizePeer(peerId, validationResult.severity);
1114
+ return { result: TopicValidatorResult.Reject };
1115
+ }
1116
+
1117
+ if (validationResult.result === 'ignore') {
1118
+ return { result: TopicValidatorResult.Ignore, obj: block };
1119
+ }
1120
+
1121
+ // Try to add the proposal: this handles existence check, cap check, and adding in one call
1122
+ const { added, alreadyExists, count } = await this.mempools.attestationPool.tryAddBlockProposal(block);
1123
+ const isEquivocated = count !== undefined && count > 1;
1124
+
1125
+ // Duplicate proposal received, no need to re-broadcast
1126
+ if (alreadyExists) {
1127
+ this.logger.debug(`Ignoring duplicate block proposal received`, {
1128
+ ...block.toBlockInfo(),
1129
+ indexWithinCheckpoint: block.indexWithinCheckpoint,
1130
+ proposer: block.getSender()?.toString(),
1131
+ source: peerId.toString(),
1132
+ });
1133
+ return { result: TopicValidatorResult.Ignore, obj: block, metadata: { isEquivocated } };
1134
+ }
1135
+
1136
+ // Too many blocks received for this slot and index, penalize peer and do not re-broadcast
1137
+ if (!added) {
1138
+ this.peerManager.penalizePeer(peerId, PeerErrorSeverity.HighToleranceError);
1139
+ this.logger.warn(`Penalizing peer for block proposal exceeding per-position cap`, {
1140
+ ...block.toBlockInfo(),
1141
+ indexWithinCheckpoint: block.indexWithinCheckpoint,
1142
+ count,
1143
+ proposer: block.getSender()?.toString(),
1144
+ source: peerId.toString(),
1145
+ });
1146
+ return { result: TopicValidatorResult.Reject, metadata: { isEquivocated } };
1147
+ }
1148
+
1149
+ // If this was a duplicate proposal, do not process it, but do invoke the duplicate callback,
1150
+ // and do re-broadcast it so other nodes in the network know to slash the proposer
1151
+ if (isEquivocated) {
1152
+ const proposer = block.getSender();
1153
+ this.logger.warn(`Detected duplicate block proposal (equivocation) at slot ${block.slotNumber}`, {
1154
+ ...block.toBlockInfo(),
1155
+ source: peerId.toString(),
1156
+ proposer: proposer?.toString(),
1157
+ });
1158
+ // Invoke the duplicate callback on the first duplicate spotted only
1159
+ if (proposer && count === 2) {
1160
+ this.duplicateProposalCallback?.({ slot: block.slotNumber, proposer, type: 'block' });
1161
+ }
1162
+ return { result: TopicValidatorResult.Accept, obj: block, metadata: { isEquivocated } };
1163
+ }
1164
+
1165
+ // Otherwise, we're good to go!
1166
+ return { result: TopicValidatorResult.Accept, obj: block };
1167
+ }
1168
+
1035
1169
  // REFACTOR(palla): This method should be moved to the p2p_client or to a separate component,
1036
1170
  // should not be here as it does not deal with p2p networking.
1037
1171
  @trackSpan('Libp2pService.processValidBlockProposal', async block => ({
@@ -1039,7 +1173,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1039
1173
  [Attributes.BLOCK_ARCHIVE]: block.archive.toString(),
1040
1174
  [Attributes.P2P_ID]: await block.p2pMessageLoggingIdentifier().then(i => i.toString()),
1041
1175
  }))
1042
- private async processValidBlockProposal(block: BlockProposal, sender: PeerId) {
1176
+ protected async processValidBlockProposal(block: BlockProposal, sender: PeerId) {
1043
1177
  const slot = block.slotNumber;
1044
1178
  this.logger.verbose(`Received block proposal for slot ${slot} from external peer ${sender.toString()}.`, {
1045
1179
  p2pMessageIdentifier: await block.p2pMessageLoggingIdentifier(),
@@ -1047,24 +1181,8 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1047
1181
  ...block.toBlockInfo(),
1048
1182
  });
1049
1183
 
1050
- // Attempt to add proposal
1051
- try {
1052
- await this.mempools.attestationPool.addBlockProposal(block);
1053
- } catch (err: unknown) {
1054
- // Drop proposals if we hit per-slot cap in the attestation pool; rethrow unknown errors
1055
- if (err instanceof ProposalSlotCapExceededError) {
1056
- this.logger.warn(`Dropping block proposal due to per-slot proposal cap`, {
1057
- slot: String(slot),
1058
- archive: block.archive.toString(),
1059
- error: (err as Error).message,
1060
- });
1061
- return;
1062
- }
1063
- throw err;
1064
- }
1065
-
1066
- // Mark the txs in this proposal as non-evictable
1067
- await this.mempools.txPool.markTxsAsNonEvictable(block.txHashes);
1184
+ // Mark the txs in this proposal as protected
1185
+ await this.mempools.txPool.protectTxs(block.txHashes, block.blockHeader);
1068
1186
 
1069
1187
  // Call the block received callback to validate the proposal.
1070
1188
  // Note: Validators do NOT attest to individual blocks, only to checkpoint proposals.
@@ -1078,66 +1196,145 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1078
1196
  * Handle a gossiped checkpoint proposal.
1079
1197
  * Validates and processes the checkpoint proposal, then triggers the callback for attestation.
1080
1198
  */
1081
- private async handleGossipedCheckpointProposal(payloadData: Buffer, msgId: string, source: PeerId): Promise<void> {
1082
- // TODO(palla/mbps): This pattern is repeated across multiple message handlers, consider abstracting it.
1083
- const validationFunc: () => Promise<ReceivedMessageValidationResult<CheckpointProposal>> = async () => {
1084
- const checkpoint = CheckpointProposal.fromBuffer(payloadData);
1085
- const isValid = await this.validateCheckpointProposal(source, checkpoint);
1086
- const pool = this.mempools.attestationPool;
1087
-
1088
- const exists = isValid && (await pool.hasCheckpointProposal(checkpoint));
1089
- const canAdd = isValid && (await pool.canAddCheckpointProposal(checkpoint));
1090
-
1091
- this.logger.trace(`Validate propagated checkpoint proposal`, {
1092
- isValid,
1093
- exists,
1094
- canAdd,
1199
+ protected async handleGossipedCheckpointProposal(payloadData: Buffer, msgId: string, source: PeerId): Promise<void> {
1200
+ const {
1201
+ result,
1202
+ obj: checkpoint,
1203
+ metadata: { isEquivocated, processBlock } = {},
1204
+ } = await this.validateReceivedMessage<CheckpointProposal, { isEquivocated: boolean; processBlock: boolean }>(
1205
+ () => this.validateAndStoreCheckpointProposal(source, CheckpointProposal.fromBuffer(payloadData)),
1206
+ msgId,
1207
+ source,
1208
+ TopicType.checkpoint_proposal,
1209
+ );
1210
+
1211
+ // If the checkpoint contained a valid last block, we process it even if the checkpoint itself is to be rejected
1212
+ // TODO(palla/mbps): Is this ok? Should we be considering a block from a checkpoint that was equivocated?
1213
+ if (processBlock && checkpoint?.getBlockProposal()) {
1214
+ await this.processValidBlockProposal(checkpoint.getBlockProposal()!, source);
1215
+ }
1216
+
1217
+ if (result !== TopicValidatorResult.Accept || !checkpoint || isEquivocated) {
1218
+ return;
1219
+ }
1220
+
1221
+ await this.processValidCheckpointProposal(checkpoint.toCore(), source);
1222
+ }
1223
+
1224
+ /**
1225
+ * Validates a checkpoint proposal. Penalizes peer if validation fails. Adds the checkpoint and
1226
+ * its last block (if present) to the mempool if valid. Triggers equivocation detection on both.
1227
+ */
1228
+ @trackSpan('Libp2pService.validateAndStoreCheckpointProposal', (_peerId, checkpoint) => ({
1229
+ [Attributes.SLOT_NUMBER]: checkpoint.slotNumber.toString(),
1230
+ }))
1231
+ protected async validateAndStoreCheckpointProposal(
1232
+ peerId: PeerId,
1233
+ checkpoint: CheckpointProposal,
1234
+ ): Promise<ReceivedMessageValidationResult<CheckpointProposal, { isEquivocated: boolean; processBlock: boolean }>> {
1235
+ const validationResult = await this.checkpointProposalValidator.validate(checkpoint);
1236
+
1237
+ if (validationResult.result === 'reject') {
1238
+ this.logger.warn(`Penalizing peer ${peerId} for checkpoint proposal validation failure`);
1239
+ this.peerManager.penalizePeer(peerId, validationResult.severity);
1240
+ return { result: TopicValidatorResult.Reject };
1241
+ }
1242
+
1243
+ if (validationResult.result === 'ignore') {
1244
+ return { result: TopicValidatorResult.Ignore, obj: checkpoint };
1245
+ }
1246
+
1247
+ // Extract and try to add the block proposal first if present
1248
+ const blockProposal = checkpoint.getBlockProposal();
1249
+ let processBlock = false;
1250
+ if (blockProposal) {
1251
+ this.logger.debug(`Validating block proposal from propagated checkpoint`, {
1095
1252
  [Attributes.SLOT_NUMBER]: checkpoint.slotNumber.toString(),
1096
- [Attributes.P2P_ID]: source.toString(),
1253
+ [Attributes.P2P_ID]: peerId.toString(),
1097
1254
  });
1098
-
1099
- if (!isValid) {
1100
- return { result: TopicValidatorResult.Reject };
1101
- } else if (exists) {
1102
- return { result: TopicValidatorResult.Ignore, obj: checkpoint };
1103
- } else if (!canAdd) {
1104
- this.peerManager.penalizePeer(source, PeerErrorSeverity.MidToleranceError);
1105
- this.logger.warn(`Penalizing peer for checkpoint proposal exceeding per-slot cap`, {
1106
- slot: checkpoint.slotNumber.toString(),
1107
- archive: checkpoint.archive.toString(),
1108
- source: source.toString(),
1255
+ const {
1256
+ result,
1257
+ obj,
1258
+ metadata: { isEquivocated } = {},
1259
+ } = await this.validateAndStoreBlockProposal(peerId, blockProposal);
1260
+ if (result === TopicValidatorResult.Reject || !obj || isEquivocated) {
1261
+ this.logger.debug(`Rejecting checkpoint due to invalid last block proposal`, {
1262
+ [Attributes.SLOT_NUMBER]: checkpoint.slotNumber.toString(),
1263
+ [Attributes.P2P_ID]: peerId.toString(),
1264
+ isEquivocated,
1265
+ result,
1109
1266
  });
1110
1267
  return { result: TopicValidatorResult.Reject };
1111
- } else {
1112
- return { result: TopicValidatorResult.Accept, obj: checkpoint };
1268
+ } else if (result === TopicValidatorResult.Accept && obj && !isEquivocated) {
1269
+ processBlock = true;
1113
1270
  }
1114
- };
1271
+ }
1115
1272
 
1116
- const { result, obj: checkpoint } = await this.validateReceivedMessage<CheckpointProposal>(
1117
- validationFunc,
1118
- msgId,
1119
- source,
1120
- TopicType.checkpoint_proposal,
1121
- );
1273
+ // Try to add the checkpoint proposal core: this handles existence check, cap check, and adding in one call
1274
+ const checkpointCore = checkpoint.toCore();
1275
+ const tryAddResult = await this.mempools.attestationPool.tryAddCheckpointProposal(checkpointCore);
1276
+ const { added, alreadyExists, count } = tryAddResult;
1277
+ const isEquivocated = count !== undefined && count > 1;
1278
+
1279
+ // Duplicate proposal received, do not re-broadcast
1280
+ if (alreadyExists) {
1281
+ this.logger.debug(`Ignoring duplicate checkpoint proposal received`, {
1282
+ ...checkpoint.toCheckpointInfo(),
1283
+ source: peerId.toString(),
1284
+ });
1285
+ return {
1286
+ result: TopicValidatorResult.Ignore,
1287
+ obj: checkpoint,
1288
+ metadata: { isEquivocated, processBlock },
1289
+ };
1290
+ }
1122
1291
 
1123
- if (result !== TopicValidatorResult.Accept || !checkpoint) {
1124
- return;
1292
+ // Too many checkpoint proposals received for this slot, penalize peer and do not re-broadcast
1293
+ // Note: We still return the checkpoint obj so the lastBlock can be processed if valid
1294
+ if (!added) {
1295
+ this.peerManager.penalizePeer(peerId, PeerErrorSeverity.HighToleranceError);
1296
+ this.logger.warn(`Penalizing peer for checkpoint proposal exceeding per-slot cap`, {
1297
+ ...checkpoint.toCheckpointInfo(),
1298
+ count,
1299
+ source: peerId.toString(),
1300
+ });
1301
+ return { result: TopicValidatorResult.Reject, obj: checkpoint, metadata: { isEquivocated, processBlock } };
1125
1302
  }
1126
1303
 
1127
- await this.processValidCheckpointProposal(checkpoint, source);
1304
+ // If this was a duplicate proposal, do not process it, but do invoke the duplicate callback,
1305
+ // and do re-broadcast it so other nodes in the network know to slash the proposer
1306
+ if (isEquivocated) {
1307
+ const proposer = checkpoint.getSender();
1308
+ this.logger.warn(`Detected duplicate checkpoint proposal (equivocation) at slot ${checkpoint.slotNumber}`, {
1309
+ ...checkpoint.toCheckpointInfo(),
1310
+ source: peerId.toString(),
1311
+ proposer: proposer?.toString(),
1312
+ });
1313
+ // Invoke the duplicate callback on the first duplicate spotted only
1314
+ if (proposer && count === 2) {
1315
+ this.duplicateProposalCallback?.({ slot: checkpoint.slotNumber, proposer, type: 'checkpoint' });
1316
+ }
1317
+ return {
1318
+ result: TopicValidatorResult.Accept,
1319
+ obj: checkpoint,
1320
+ metadata: { isEquivocated, processBlock },
1321
+ };
1322
+ }
1323
+
1324
+ // Otherwise, we're good to go!
1325
+ return { result: TopicValidatorResult.Accept, obj: checkpoint, metadata: { processBlock, isEquivocated } };
1128
1326
  }
1129
1327
 
1130
1328
  /**
1131
1329
  * Process a validated checkpoint proposal.
1132
- * Extracts and processes the last block proposal (if present) first, then processes the checkpoint.
1133
- * The block callback is invoked before the checkpoint callback.
1330
+ * Note: The proposal was already added to the pool by tryAddCheckpointProposal in handleGossipedCheckpointProposal.
1134
1331
  */
1135
1332
  @trackSpan('Libp2pService.processValidCheckpointProposal', async checkpoint => ({
1136
1333
  [Attributes.SLOT_NUMBER]: checkpoint.slotNumber,
1137
1334
  [Attributes.BLOCK_ARCHIVE]: checkpoint.archive.toString(),
1138
1335
  [Attributes.P2P_ID]: await checkpoint.p2pMessageLoggingIdentifier().then(i => i.toString()),
1139
1336
  }))
1140
- private async processValidCheckpointProposal(checkpoint: CheckpointProposal, sender: PeerId) {
1337
+ protected async processValidCheckpointProposal(checkpoint: CheckpointProposalCore, sender: PeerId) {
1141
1338
  const slot = checkpoint.slotNumber;
1142
1339
  this.logger.verbose(`Received checkpoint proposal for slot ${slot} from external peer ${sender.toString()}.`, {
1143
1340
  p2pMessageIdentifier: await checkpoint.p2pMessageLoggingIdentifier(),
@@ -1146,37 +1343,12 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1146
1343
  source: sender.toString(),
1147
1344
  });
1148
1345
 
1149
- // Extract block proposal before adding to pool (pool stores them separately)
1150
- const blockProposal = checkpoint.getBlockProposal();
1151
-
1152
- // Add proposal to the pool (this extracts and stores block proposal separately)
1153
- await this.mempools.attestationPool.addCheckpointProposal(checkpoint);
1154
-
1155
- // Mark txs as non-evictable if present (from the last block)
1156
- if (checkpoint.txHashes.length > 0) {
1157
- await this.mempools.txPool.markTxsAsNonEvictable(checkpoint.txHashes);
1158
- }
1159
-
1160
- // If there was a last block proposal, invoke the block callback first for validation.
1161
- // Note: The block proposal is already stored in the pool by addCheckpointProposal.
1162
- if (blockProposal) {
1163
- const isValid = await this.blockReceivedCallback(blockProposal, sender);
1164
- if (!isValid) {
1165
- this.logger.warn(`Block proposal from checkpoint failed validation`, {
1166
- slot: slot.toString(),
1167
- archive: checkpoint.archive.toString(),
1168
- blockNumber: blockProposal.blockNumber.toString(),
1169
- });
1170
- return;
1171
- }
1172
- }
1173
-
1174
1346
  // Call the checkpoint received callback with the core version (without lastBlock)
1175
1347
  // to validate and potentially generate attestations
1176
- const attestations = await this.checkpointReceivedCallback(checkpoint.toCore(), sender);
1348
+ const attestations = await this.checkpointReceivedCallback(checkpoint, sender);
1177
1349
  if (attestations && attestations.length > 0) {
1178
1350
  // If the callback returned attestations, add them to the pool and propagate them
1179
- await this.mempools.attestationPool.addCheckpointAttestations(attestations);
1351
+ await this.mempools.attestationPool.addOwnCheckpointAttestations(attestations);
1180
1352
  for (const attestation of attestations) {
1181
1353
  await this.propagate(attestation);
1182
1354
  }
@@ -1203,9 +1375,9 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1203
1375
  * @returns True if the requested block transactions are valid, false otherwise.
1204
1376
  */
1205
1377
  @trackSpan('Libp2pService.validateRequestedBlockTxs', request => ({
1206
- [Attributes.BLOCK_HASH]: request.blockHash.toString(),
1378
+ [Attributes.BLOCK_ARCHIVE]: request.archiveRoot.toString(),
1207
1379
  }))
1208
- private async validateRequestedBlockTxs(
1380
+ protected async validateRequestedBlockTxs(
1209
1381
  request: BlockTxsRequest,
1210
1382
  response: BlockTxsResponse,
1211
1383
  peerId: PeerId,
@@ -1213,10 +1385,10 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1213
1385
  const requestedTxValidator = this.createRequestedTxValidator();
1214
1386
 
1215
1387
  try {
1216
- if (!response.blockHash.equals(request.blockHash)) {
1388
+ if (!response.archiveRoot.equals(request.archiveRoot)) {
1217
1389
  this.peerManager.penalizePeer(peerId, PeerErrorSeverity.MidToleranceError);
1218
1390
  throw new ValidationError(
1219
- `Received block txs for unexpected block: expected ${request.blockHash.toString()}, got ${response.blockHash.toString()}`,
1391
+ `Received block txs for unexpected archive root: expected ${request.archiveRoot.toString()}, got ${response.archiveRoot.toString()}`,
1220
1392
  );
1221
1393
  }
1222
1394
 
@@ -1246,7 +1418,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1246
1418
  }
1247
1419
 
1248
1420
  // Given proposal (should have locally), ensure returned txs are valid subset and match request indices
1249
- const proposal = await this.mempools.attestationPool.getBlockProposal(request.blockHash.toString());
1421
+ const proposal = await this.mempools.attestationPool.getBlockProposal(request.archiveRoot.toString());
1250
1422
  if (proposal) {
1251
1423
  // Build intersected indices
1252
1424
  const intersectIdx = request.txIndices.getTrueIndices().filter(i => response.txIndices.isSet(i));
@@ -1266,7 +1438,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1266
1438
  } else {
1267
1439
  // No local proposal, cannot check the membership/order of the returned txs
1268
1440
  this.logger.warn(
1269
- `Block proposal not found for block hash ${request.blockHash.toString()}; cannot validate membership/order of returned txs`,
1441
+ `Block proposal not found for archive root ${request.archiveRoot.toString()}; cannot validate membership/order of returned txs`,
1270
1442
  );
1271
1443
  return false;
1272
1444
  }
@@ -1305,7 +1477,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1305
1477
  const requested = new Set(requestedTxHash.map(h => h.toString()));
1306
1478
  const requestedTxValidator = this.createRequestedTxValidator();
1307
1479
 
1308
- //TODO: (mralj) - this is somewhat naive implementation, if single tx is invlid we consider the whole response invalid.
1480
+ //TODO: (mralj) - this is somewhat naive implementation, if single tx is invalid we consider the whole response invalid.
1309
1481
  // I think we should still extract the valid txs and return them, so that we can still use the response.
1310
1482
  try {
1311
1483
  await Promise.all(responseTx.map(tx => this.validateRequestedTx(tx, peerId, requestedTxValidator, requested)));
@@ -1335,9 +1507,9 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1335
1507
  @trackSpan('Libp2pService.validateRequestedBlock', (requestedBlockNumber, _responseBlock) => ({
1336
1508
  [Attributes.BLOCK_NUMBER]: requestedBlockNumber.toString(),
1337
1509
  }))
1338
- private async validateRequestedBlock(
1510
+ protected async validateRequestedBlock(
1339
1511
  requestedBlockNumber: Fr,
1340
- responseBlock: L2BlockNew,
1512
+ responseBlock: L2Block,
1341
1513
  peerId: PeerId,
1342
1514
  ): Promise<boolean> {
1343
1515
  try {
@@ -1368,28 +1540,13 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1368
1540
  }
1369
1541
  }
1370
1542
 
1371
- private createRequestedTxValidator(): TxValidator {
1372
- return new AggregateTxValidator(
1373
- new DataTxValidator(),
1374
- new SizeTxValidator(),
1375
- new MetadataTxValidator({
1376
- l1ChainId: new Fr(this.config.l1ChainId),
1377
- rollupVersion: new Fr(this.config.rollupVersion),
1378
- protocolContractsHash,
1379
- vkTreeRoot: getVKTreeRoot(),
1380
- }),
1381
- new TxProofValidator(this.proofVerifier),
1382
- );
1383
- }
1384
-
1385
- private async validateRequestedTx(tx: Tx, peerId: PeerId, txValidator: TxValidator, requested?: Set<`0x${string}`>) {
1543
+ protected async validateRequestedTx(
1544
+ tx: Tx,
1545
+ peerId: PeerId,
1546
+ txValidator: TxValidator,
1547
+ requested?: Set<`0x${string}`>,
1548
+ ) {
1386
1549
  const penalize = (severity: PeerErrorSeverity) => this.peerManager.penalizePeer(peerId, severity);
1387
-
1388
- if (!(await tx.validateTxHash())) {
1389
- penalize(PeerErrorSeverity.MidToleranceError);
1390
- throw new ValidationError(`Received tx with invalid hash ${tx.getTxHash().toString()}.`);
1391
- }
1392
-
1393
1550
  if (requested && !requested.has(tx.getTxHash().toString())) {
1394
1551
  penalize(PeerErrorSeverity.MidToleranceError);
1395
1552
  throw new ValidationError(`Received tx with hash ${tx.getTxHash().toString()} that was not requested.`);
@@ -1402,35 +1559,11 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1402
1559
  }
1403
1560
  }
1404
1561
 
1405
- @trackSpan('Libp2pService.validatePropagatedTx', tx => ({
1406
- [Attributes.TX_HASH]: tx.getTxHash().toString(),
1407
- }))
1408
- private async validatePropagatedTx(tx: Tx, peerId: PeerId): Promise<boolean> {
1409
- const currentBlockNumber = await this.archiver.getBlockNumber();
1410
-
1411
- // We accept transactions if they are not expired by the next slot (checked based on the IncludeByTimestamp field)
1412
- const { ts: nextSlotTimestamp } = this.epochCache.getEpochAndSlotInNextL1Slot();
1413
- const messageValidators = await this.createMessageValidators(currentBlockNumber, nextSlotTimestamp);
1414
-
1415
- for (const validator of messageValidators) {
1416
- const outcome = await this.runValidations(tx, validator);
1417
-
1418
- if (outcome.allPassed) {
1419
- continue;
1420
- }
1421
- const { name } = outcome.failure;
1422
- let { severity } = outcome.failure;
1423
-
1424
- // Double spend validator has a special case handler
1425
- if (name === 'doubleSpendValidator') {
1426
- const txBlockNumber = BlockNumber(currentBlockNumber + 1); // tx is expected to be in the next block
1427
- severity = await this.handleDoubleSpendFailure(tx, txBlockNumber);
1428
- }
1429
-
1430
- this.peerManager.penalizePeer(peerId, severity);
1431
- return false;
1432
- }
1433
- return true;
1562
+ protected createRequestedTxValidator(): TxValidator {
1563
+ return createTxValidatorForReqResponseReceivedTxs(this.proofVerifier, {
1564
+ l1ChainId: this.config.l1ChainId,
1565
+ rollupVersion: this.config.rollupVersion,
1566
+ });
1434
1567
  }
1435
1568
 
1436
1569
  private async getGasFees(blockNumber: BlockNumber): Promise<GasFees> {
@@ -1444,59 +1577,69 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1444
1577
  return gasFees;
1445
1578
  }
1446
1579
 
1447
- public async validate(txs: Tx[]): Promise<void> {
1448
- const currentBlockNumber = await this.archiver.getBlockNumber();
1580
+ /**
1581
+ * Get the BatchTxRequesterLibP2PService dependencies for creating BatchTxRequester instances
1582
+ */
1583
+ public getBatchTxRequesterService(): BatchTxRequesterLibP2PService {
1584
+ return {
1585
+ reqResp: this.reqresp,
1586
+ connectionSampler: this.reqresp.getConnectionSampler(),
1587
+ txValidatorConfig: {
1588
+ l1ChainId: this.config.l1ChainId,
1589
+ rollupVersion: this.config.rollupVersion,
1590
+ proofVerifier: this.proofVerifier,
1591
+ },
1592
+ peerScoring: this.peerManager,
1593
+ };
1594
+ }
1449
1595
 
1450
- // We accept transactions if they are not expired by the next slot (checked based on the IncludeByTimestamp field)
1451
- const { ts: nextSlotTimestamp } = this.epochCache.getEpochAndSlotInNextL1Slot();
1452
- const messageValidators = await this.createMessageValidators(currentBlockNumber, nextSlotTimestamp);
1596
+ public async validateTxsReceivedInBlockProposal(txs: Tx[]): Promise<void> {
1597
+ const validator = createTxValidatorForBlockProposalReceivedTxs(
1598
+ this.proofVerifier,
1599
+ { l1ChainId: this.config.l1ChainId, rollupVersion: this.config.rollupVersion },
1600
+ this.logger.getBindings(),
1601
+ );
1453
1602
 
1454
- await Promise.all(
1603
+ const results = await Promise.all(
1455
1604
  txs.map(async tx => {
1456
- for (const validator of messageValidators) {
1457
- const outcome = await this.runValidations(tx, validator);
1458
- if (!outcome.allPassed) {
1459
- throw new Error('Invalid tx detected', { cause: { outcome } });
1460
- }
1461
- }
1605
+ const result = await validator.validateTx(tx);
1606
+ return result.result !== 'invalid';
1462
1607
  }),
1463
1608
  );
1609
+ if (results.some(value => value === false)) {
1610
+ throw new Error('Invalid tx detected');
1611
+ }
1464
1612
  }
1465
1613
 
1466
- /**
1467
- * Create message validators for the given block number and timestamp.
1468
- *
1469
- * Each validator is a pair of a validator and a severity.
1470
- * If a validator fails, the peer is penalized with the severity of the validator.
1471
- *
1472
- * @param currentBlockNumber - The current synced block number.
1473
- * @param nextSlotTimestamp - The timestamp of the next slot (used to validate txs are not expired).
1474
- * @returns The message validators.
1475
- */
1476
- private async createMessageValidators(
1614
+ /** Creates the first stage (fast) validators for gossiped transactions. */
1615
+ protected async createFirstStageMessageValidators(
1477
1616
  currentBlockNumber: BlockNumber,
1478
1617
  nextSlotTimestamp: UInt64,
1479
- ): Promise<Record<string, MessageValidator>[]> {
1618
+ ): Promise<Record<string, TransactionValidator>> {
1480
1619
  const gasFees = await this.getGasFees(currentBlockNumber);
1481
1620
  const allowedInSetup = this.config.txPublicSetupAllowList ?? (await getDefaultAllowedSetupFunctions());
1621
+ const blockNumber = BlockNumber(currentBlockNumber + 1);
1482
1622
 
1483
- const blockNumberInWhichTheTxIsConsideredToBeIncluded = BlockNumber(currentBlockNumber + 1);
1484
-
1485
- return createTxMessageValidators(
1623
+ return createFirstStageTxValidationsForGossipedTransactions(
1486
1624
  nextSlotTimestamp,
1487
- blockNumberInWhichTheTxIsConsideredToBeIncluded,
1625
+ blockNumber,
1488
1626
  this.worldStateSynchronizer,
1489
1627
  gasFees,
1490
1628
  this.config.l1ChainId,
1491
1629
  this.config.rollupVersion,
1492
1630
  protocolContractsHash,
1493
1631
  this.archiver,
1494
- this.proofVerifier,
1495
1632
  !this.config.disableTransactions,
1496
1633
  allowedInSetup,
1634
+ this.logger.getBindings(),
1497
1635
  );
1498
1636
  }
1499
1637
 
1638
+ /** Creates the second stage (expensive proof verification) validators for gossiped transactions. */
1639
+ protected createSecondStageMessageValidators(): Record<string, TransactionValidator> {
1640
+ return createSecondStageTxValidationsForGossipedTransactions(this.proofVerifier, this.logger.getBindings());
1641
+ }
1642
+
1500
1643
  /**
1501
1644
  * Run validations on a tx.
1502
1645
  * @param tx - The tx to validate.
@@ -1505,7 +1648,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1505
1648
  */
1506
1649
  private async runValidations(
1507
1650
  tx: Tx,
1508
- messageValidators: Record<string, MessageValidator>,
1651
+ messageValidators: Record<string, TransactionValidator>,
1509
1652
  ): Promise<ValidationOutcome> {
1510
1653
  const validationPromises = Object.entries(messageValidators).map(async ([name, { validator, severity }]) => {
1511
1654
  const { result } = await validator.validateTx(tx);
@@ -1547,15 +1690,18 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1547
1690
  return PeerErrorSeverity.HighToleranceError;
1548
1691
  }
1549
1692
 
1550
- const snapshotValidator = new DoubleSpendTxValidator({
1551
- nullifiersExist: async (nullifiers: Buffer[]) => {
1552
- const merkleTree = this.worldStateSynchronizer.getSnapshot(
1553
- BlockNumber(blockNumber - this.config.doubleSpendSeverePeerPenaltyWindow),
1554
- );
1555
- const indices = await merkleTree.findLeafIndices(MerkleTreeId.NULLIFIER_TREE, nullifiers);
1556
- return indices.map(index => index !== undefined);
1693
+ const snapshotValidator = new DoubleSpendTxValidator(
1694
+ {
1695
+ nullifiersExist: async (nullifiers: Buffer[]) => {
1696
+ const merkleTree = this.worldStateSynchronizer.getSnapshot(
1697
+ BlockNumber(blockNumber - this.config.doubleSpendSeverePeerPenaltyWindow),
1698
+ );
1699
+ const indices = await merkleTree.findLeafIndices(MerkleTreeId.NULLIFIER_TREE, nullifiers);
1700
+ return indices.map(index => index !== undefined);
1701
+ },
1557
1702
  },
1558
- });
1703
+ this.logger.getBindings(),
1704
+ );
1559
1705
 
1560
1706
  const validSnapshot = await snapshotValidator.validateTx(tx);
1561
1707
  if (validSnapshot.result !== 'valid') {
@@ -1576,55 +1722,18 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1576
1722
  [Attributes.BLOCK_ARCHIVE]: attestation.archive.toString(),
1577
1723
  [Attributes.P2P_ID]: await attestation.p2pMessageLoggingIdentifier().then(i => i.toString()),
1578
1724
  }))
1579
- public async validateCheckpointAttestation(peerId: PeerId, attestation: CheckpointAttestation): Promise<boolean> {
1580
- const severity = await this.checkpointAttestationValidator.validate(attestation);
1581
- if (severity) {
1582
- this.logger.debug(`Penalizing peer ${peerId} for checkpoint attestation validation failure`);
1583
- this.peerManager.penalizePeer(peerId, severity);
1584
- return false;
1585
- }
1586
-
1587
- return true;
1588
- }
1589
-
1590
- /**
1591
- * Validate a block proposal.
1592
- *
1593
- * @param block - The block proposal to validate.
1594
- * @returns True if the block proposal is valid, false otherwise.
1595
- */
1596
- @trackSpan('Libp2pService.validateBlockProposal', (_peerId, block) => ({
1597
- [Attributes.SLOT_NUMBER]: block.slotNumber.toString(),
1598
- }))
1599
- public async validateBlockProposal(peerId: PeerId, block: BlockProposal): Promise<boolean> {
1600
- const severity = await this.blockProposalValidator.validate(block);
1601
- if (severity) {
1602
- this.logger.debug(`Penalizing peer ${peerId} for block proposal validation failure`);
1603
- this.peerManager.penalizePeer(peerId, severity);
1604
- return false;
1605
- }
1606
-
1607
- return true;
1608
- }
1725
+ public async validateCheckpointAttestation(
1726
+ peerId: PeerId,
1727
+ attestation: CheckpointAttestation,
1728
+ ): Promise<P2PValidationResult> {
1729
+ const result = await this.checkpointAttestationValidator.validate(attestation);
1609
1730
 
1610
- /**
1611
- * Validate a checkpoint proposal.
1612
- *
1613
- * @param checkpoint - The checkpoint proposal to validate.
1614
- * @returns True if the checkpoint proposal is valid, false otherwise.
1615
- */
1616
- @trackSpan('Libp2pService.validateCheckpointProposal', (_peerId, checkpoint) => ({
1617
- [Attributes.SLOT_NUMBER]: checkpoint.slotNumber.toString(),
1618
- }))
1619
- public async validateCheckpointProposal(peerId: PeerId, checkpoint: CheckpointProposal): Promise<boolean> {
1620
- const severity = await this.checkpointProposalValidator.validate(checkpoint);
1621
- if (severity) {
1622
- this.logger.debug(`Penalizing peer ${peerId} for checkpoint proposal validation failure`);
1623
- this.peerManager.penalizePeer(peerId, severity);
1624
- return false;
1731
+ if (result.result === 'reject') {
1732
+ this.logger.warn(`Penalizing peer ${peerId} for checkpoint attestation validation failure`);
1733
+ this.peerManager.penalizePeer(peerId, result.severity);
1625
1734
  }
1626
1735
 
1627
- return true;
1736
+ return result;
1628
1737
  }
1629
1738
 
1630
1739
  public getPeerScore(peerId: PeerId): number {