@aztec/p2p 0.0.1-commit.ee80a48 → 0.0.1-commit.f103f88

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