@aztec/p2p 0.0.1-commit.e3c1de76 → 0.0.1-commit.e588bc7e5

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