@aztec/p2p 0.0.1-commit.6d63667d → 0.0.1-commit.71324e566

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 (469) 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 +54 -16
  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 +41 -52
  8. package/dest/client/p2p_client.d.ts.map +1 -1
  9. package/dest/client/p2p_client.js +179 -226
  10. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker.js +21 -11
  11. package/dest/config.d.ts +133 -92
  12. package/dest/config.d.ts.map +1 -1
  13. package/dest/config.js +108 -39
  14. package/dest/errors/p2p-service.error.d.ts +9 -0
  15. package/dest/errors/p2p-service.error.d.ts.map +1 -0
  16. package/dest/errors/p2p-service.error.js +10 -0
  17. package/dest/errors/tx-pool.error.d.ts +8 -0
  18. package/dest/errors/tx-pool.error.d.ts.map +1 -0
  19. package/dest/errors/tx-pool.error.js +9 -0
  20. package/dest/index.d.ts +2 -2
  21. package/dest/index.d.ts.map +1 -1
  22. package/dest/index.js +1 -1
  23. package/dest/mem_pools/attestation_pool/attestation_pool.d.ts +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/deleted_pool.d.ts +104 -0
  44. package/dest/mem_pools/tx_pool_v2/deleted_pool.d.ts.map +1 -0
  45. package/dest/mem_pools/tx_pool_v2/deleted_pool.js +251 -0
  46. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.d.ts +3 -3
  47. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.d.ts.map +1 -1
  48. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.js +18 -9
  49. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.d.ts +1 -1
  50. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.d.ts.map +1 -1
  51. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.js +7 -3
  52. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.d.ts +3 -3
  53. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.d.ts.map +1 -1
  54. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.js +12 -4
  55. package/dest/mem_pools/tx_pool_v2/eviction/index.d.ts +2 -2
  56. package/dest/mem_pools/tx_pool_v2/eviction/index.d.ts.map +1 -1
  57. package/dest/mem_pools/tx_pool_v2/eviction/index.js +1 -1
  58. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.d.ts +54 -5
  59. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.d.ts.map +1 -1
  60. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.js +8 -0
  61. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.js +7 -5
  62. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.js +9 -7
  63. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.d.ts +2 -2
  64. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.d.ts.map +1 -1
  65. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.js +14 -6
  66. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.d.ts +4 -4
  67. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.d.ts.map +1 -1
  68. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.js +16 -4
  69. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.d.ts +3 -3
  70. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.d.ts.map +1 -1
  71. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.js +3 -3
  72. package/dest/mem_pools/tx_pool_v2/index.d.ts +3 -2
  73. package/dest/mem_pools/tx_pool_v2/index.d.ts.map +1 -1
  74. package/dest/mem_pools/tx_pool_v2/index.js +2 -1
  75. package/dest/mem_pools/tx_pool_v2/instrumentation.d.ts +15 -0
  76. package/dest/mem_pools/tx_pool_v2/instrumentation.d.ts.map +1 -0
  77. package/dest/mem_pools/tx_pool_v2/instrumentation.js +43 -0
  78. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts +30 -12
  79. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts.map +1 -1
  80. package/dest/mem_pools/tx_pool_v2/interfaces.js +5 -1
  81. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts +78 -15
  82. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts.map +1 -1
  83. package/dest/mem_pools/tx_pool_v2/tx_metadata.js +144 -19
  84. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.d.ts +12 -3
  85. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.d.ts.map +1 -1
  86. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.js +50 -45
  87. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts +12 -5
  88. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts.map +1 -1
  89. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.js +17 -6
  90. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts +14 -5
  91. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts.map +1 -1
  92. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.js +364 -189
  93. package/dest/msg_validators/attestation_validator/attestation_validator.d.ts +5 -2
  94. package/dest/msg_validators/attestation_validator/attestation_validator.d.ts.map +1 -1
  95. package/dest/msg_validators/attestation_validator/attestation_validator.js +20 -11
  96. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts +5 -3
  97. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts.map +1 -1
  98. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.js +2 -2
  99. package/dest/msg_validators/clock_tolerance.d.ts +12 -1
  100. package/dest/msg_validators/clock_tolerance.d.ts.map +1 -1
  101. package/dest/msg_validators/clock_tolerance.js +54 -3
  102. package/dest/msg_validators/proposal_validator/block_proposal_validator.d.ts +7 -4
  103. package/dest/msg_validators/proposal_validator/block_proposal_validator.d.ts.map +1 -1
  104. package/dest/msg_validators/proposal_validator/block_proposal_validator.js +10 -2
  105. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.d.ts +7 -4
  106. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.d.ts.map +1 -1
  107. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.js +16 -2
  108. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts +15 -8
  109. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts.map +1 -1
  110. package/dest/msg_validators/proposal_validator/proposal_validator.js +67 -47
  111. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts +4 -4
  112. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts.map +1 -1
  113. package/dest/msg_validators/tx_validator/aggregate_tx_validator.js +3 -3
  114. package/dest/msg_validators/tx_validator/allowed_public_setup.d.ts +2 -1
  115. package/dest/msg_validators/tx_validator/allowed_public_setup.d.ts.map +1 -1
  116. package/dest/msg_validators/tx_validator/allowed_public_setup.js +24 -20
  117. package/dest/msg_validators/tx_validator/allowed_setup_helpers.d.ts +17 -0
  118. package/dest/msg_validators/tx_validator/allowed_setup_helpers.d.ts.map +1 -0
  119. package/dest/msg_validators/tx_validator/allowed_setup_helpers.js +24 -0
  120. package/dest/msg_validators/tx_validator/archive_cache.js +1 -1
  121. package/dest/msg_validators/tx_validator/block_header_validator.d.ts +16 -3
  122. package/dest/msg_validators/tx_validator/block_header_validator.d.ts.map +1 -1
  123. package/dest/msg_validators/tx_validator/block_header_validator.js +1 -1
  124. package/dest/msg_validators/tx_validator/contract_instance_validator.d.ts +9 -0
  125. package/dest/msg_validators/tx_validator/contract_instance_validator.d.ts.map +1 -0
  126. package/dest/msg_validators/tx_validator/contract_instance_validator.js +48 -0
  127. package/dest/msg_validators/tx_validator/data_validator.d.ts +1 -1
  128. package/dest/msg_validators/tx_validator/data_validator.d.ts.map +1 -1
  129. package/dest/msg_validators/tx_validator/data_validator.js +35 -2
  130. package/dest/msg_validators/tx_validator/double_spend_validator.d.ts +13 -3
  131. package/dest/msg_validators/tx_validator/double_spend_validator.d.ts.map +1 -1
  132. package/dest/msg_validators/tx_validator/double_spend_validator.js +4 -4
  133. package/dest/msg_validators/tx_validator/factory.d.ts +133 -6
  134. package/dest/msg_validators/tx_validator/factory.d.ts.map +1 -1
  135. package/dest/msg_validators/tx_validator/factory.js +247 -60
  136. package/dest/msg_validators/tx_validator/fee_payer_balance.d.ts +1 -1
  137. package/dest/msg_validators/tx_validator/fee_payer_balance.d.ts.map +1 -1
  138. package/dest/msg_validators/tx_validator/fee_payer_balance.js +6 -2
  139. package/dest/msg_validators/tx_validator/gas_validator.d.ts +67 -3
  140. package/dest/msg_validators/tx_validator/gas_validator.d.ts.map +1 -1
  141. package/dest/msg_validators/tx_validator/gas_validator.js +112 -43
  142. package/dest/msg_validators/tx_validator/index.d.ts +3 -1
  143. package/dest/msg_validators/tx_validator/index.d.ts.map +1 -1
  144. package/dest/msg_validators/tx_validator/index.js +2 -0
  145. package/dest/msg_validators/tx_validator/metadata_validator.d.ts +1 -1
  146. package/dest/msg_validators/tx_validator/metadata_validator.d.ts.map +1 -1
  147. package/dest/msg_validators/tx_validator/metadata_validator.js +4 -4
  148. package/dest/msg_validators/tx_validator/nullifier_cache.d.ts +14 -0
  149. package/dest/msg_validators/tx_validator/nullifier_cache.d.ts.map +1 -0
  150. package/dest/msg_validators/tx_validator/nullifier_cache.js +24 -0
  151. package/dest/msg_validators/tx_validator/phases_validator.d.ts +22 -2
  152. package/dest/msg_validators/tx_validator/phases_validator.d.ts.map +1 -1
  153. package/dest/msg_validators/tx_validator/phases_validator.js +72 -24
  154. package/dest/msg_validators/tx_validator/timestamp_validator.d.ts +20 -4
  155. package/dest/msg_validators/tx_validator/timestamp_validator.d.ts.map +1 -1
  156. package/dest/msg_validators/tx_validator/timestamp_validator.js +6 -6
  157. package/dest/services/data_store.d.ts +1 -1
  158. package/dest/services/data_store.d.ts.map +1 -1
  159. package/dest/services/data_store.js +5 -5
  160. package/dest/services/dummy_service.d.ts +17 -6
  161. package/dest/services/dummy_service.d.ts.map +1 -1
  162. package/dest/services/dummy_service.js +16 -5
  163. package/dest/services/encoding.d.ts +7 -3
  164. package/dest/services/encoding.d.ts.map +1 -1
  165. package/dest/services/encoding.js +18 -11
  166. package/dest/services/gossipsub/index.d.ts +3 -0
  167. package/dest/services/gossipsub/index.d.ts.map +1 -0
  168. package/dest/services/gossipsub/index.js +2 -0
  169. package/dest/services/gossipsub/scoring.d.ts +21 -3
  170. package/dest/services/gossipsub/scoring.d.ts.map +1 -1
  171. package/dest/services/gossipsub/scoring.js +24 -7
  172. package/dest/services/gossipsub/topic_score_params.d.ts +184 -0
  173. package/dest/services/gossipsub/topic_score_params.d.ts.map +1 -0
  174. package/dest/services/gossipsub/topic_score_params.js +363 -0
  175. package/dest/services/libp2p/libp2p_service.d.ts +93 -51
  176. package/dest/services/libp2p/libp2p_service.d.ts.map +1 -1
  177. package/dest/services/libp2p/libp2p_service.js +547 -421
  178. package/dest/services/peer-manager/metrics.d.ts +3 -1
  179. package/dest/services/peer-manager/metrics.d.ts.map +1 -1
  180. package/dest/services/peer-manager/metrics.js +6 -0
  181. package/dest/services/peer-manager/peer_manager.d.ts +6 -2
  182. package/dest/services/peer-manager/peer_manager.d.ts.map +1 -1
  183. package/dest/services/peer-manager/peer_manager.js +39 -11
  184. package/dest/services/peer-manager/peer_scoring.d.ts +7 -2
  185. package/dest/services/peer-manager/peer_scoring.d.ts.map +1 -1
  186. package/dest/services/peer-manager/peer_scoring.js +57 -12
  187. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts +12 -8
  188. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts.map +1 -1
  189. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.js +83 -106
  190. package/dest/services/reqresp/batch-tx-requester/interface.d.ts +4 -7
  191. package/dest/services/reqresp/batch-tx-requester/interface.d.ts.map +1 -1
  192. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts +11 -13
  193. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts.map +1 -1
  194. package/dest/services/reqresp/batch-tx-requester/missing_txs.js +31 -46
  195. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts +19 -11
  196. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts.map +1 -1
  197. package/dest/services/reqresp/batch-tx-requester/peer_collection.js +52 -15
  198. package/dest/services/reqresp/batch-tx-requester/tx_validator.js +2 -2
  199. package/dest/services/reqresp/config.d.ts +3 -3
  200. package/dest/services/reqresp/config.d.ts.map +1 -1
  201. package/dest/services/reqresp/interface.d.ts +23 -9
  202. package/dest/services/reqresp/interface.d.ts.map +1 -1
  203. package/dest/services/reqresp/interface.js +23 -10
  204. package/dest/services/reqresp/metrics.d.ts +1 -1
  205. package/dest/services/reqresp/metrics.d.ts.map +1 -1
  206. package/dest/services/reqresp/metrics.js +0 -1
  207. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts +4 -3
  208. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts.map +1 -1
  209. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts +7 -1
  210. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts.map +1 -1
  211. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.js +15 -0
  212. package/dest/services/reqresp/protocols/index.d.ts +1 -2
  213. package/dest/services/reqresp/protocols/index.d.ts.map +1 -1
  214. package/dest/services/reqresp/protocols/index.js +0 -1
  215. package/dest/services/reqresp/protocols/tx.d.ts +7 -1
  216. package/dest/services/reqresp/protocols/tx.d.ts.map +1 -1
  217. package/dest/services/reqresp/protocols/tx.js +21 -3
  218. package/dest/services/reqresp/rate-limiter/rate_limiter.d.ts +5 -4
  219. package/dest/services/reqresp/rate-limiter/rate_limiter.d.ts.map +1 -1
  220. package/dest/services/reqresp/rate-limiter/rate_limiter.js +10 -8
  221. package/dest/services/reqresp/rate-limiter/rate_limits.d.ts +1 -1
  222. package/dest/services/reqresp/rate-limiter/rate_limits.d.ts.map +1 -1
  223. package/dest/services/reqresp/rate-limiter/rate_limits.js +0 -10
  224. package/dest/services/reqresp/reqresp.d.ts +4 -2
  225. package/dest/services/reqresp/reqresp.d.ts.map +1 -1
  226. package/dest/services/reqresp/reqresp.js +40 -15
  227. package/dest/services/service.d.ts +43 -4
  228. package/dest/services/service.d.ts.map +1 -1
  229. package/dest/services/tx_collection/config.d.ts +19 -1
  230. package/dest/services/tx_collection/config.d.ts.map +1 -1
  231. package/dest/services/tx_collection/config.js +46 -0
  232. package/dest/services/tx_collection/fast_tx_collection.d.ts +3 -4
  233. package/dest/services/tx_collection/fast_tx_collection.d.ts.map +1 -1
  234. package/dest/services/tx_collection/fast_tx_collection.js +80 -76
  235. package/dest/services/tx_collection/file_store_tx_collection.d.ts +53 -0
  236. package/dest/services/tx_collection/file_store_tx_collection.d.ts.map +1 -0
  237. package/dest/services/tx_collection/file_store_tx_collection.js +167 -0
  238. package/dest/services/tx_collection/file_store_tx_source.d.ts +38 -0
  239. package/dest/services/tx_collection/file_store_tx_source.d.ts.map +1 -0
  240. package/dest/services/tx_collection/file_store_tx_source.js +100 -0
  241. package/dest/services/tx_collection/index.d.ts +2 -1
  242. package/dest/services/tx_collection/index.d.ts.map +1 -1
  243. package/dest/services/tx_collection/index.js +1 -0
  244. package/dest/services/tx_collection/instrumentation.d.ts +1 -1
  245. package/dest/services/tx_collection/instrumentation.d.ts.map +1 -1
  246. package/dest/services/tx_collection/instrumentation.js +2 -1
  247. package/dest/services/tx_collection/proposal_tx_collector.d.ts +7 -7
  248. package/dest/services/tx_collection/proposal_tx_collector.d.ts.map +1 -1
  249. package/dest/services/tx_collection/proposal_tx_collector.js +5 -4
  250. package/dest/services/tx_collection/request_tracker.d.ts +53 -0
  251. package/dest/services/tx_collection/request_tracker.d.ts.map +1 -0
  252. package/dest/services/tx_collection/request_tracker.js +84 -0
  253. package/dest/services/tx_collection/slow_tx_collection.d.ts +7 -3
  254. package/dest/services/tx_collection/slow_tx_collection.d.ts.map +1 -1
  255. package/dest/services/tx_collection/slow_tx_collection.js +60 -26
  256. package/dest/services/tx_collection/tx_collection.d.ts +23 -13
  257. package/dest/services/tx_collection/tx_collection.d.ts.map +1 -1
  258. package/dest/services/tx_collection/tx_collection.js +75 -3
  259. package/dest/services/tx_collection/tx_collection_sink.d.ts +18 -8
  260. package/dest/services/tx_collection/tx_collection_sink.d.ts.map +1 -1
  261. package/dest/services/tx_collection/tx_collection_sink.js +26 -29
  262. package/dest/services/tx_collection/tx_source.d.ts +13 -7
  263. package/dest/services/tx_collection/tx_source.d.ts.map +1 -1
  264. package/dest/services/tx_collection/tx_source.js +26 -7
  265. package/dest/services/tx_file_store/config.d.ts +1 -3
  266. package/dest/services/tx_file_store/config.d.ts.map +1 -1
  267. package/dest/services/tx_file_store/config.js +0 -4
  268. package/dest/services/tx_file_store/tx_file_store.d.ts +4 -3
  269. package/dest/services/tx_file_store/tx_file_store.d.ts.map +1 -1
  270. package/dest/services/tx_file_store/tx_file_store.js +9 -6
  271. package/dest/services/tx_provider.d.ts +4 -4
  272. package/dest/services/tx_provider.d.ts.map +1 -1
  273. package/dest/services/tx_provider.js +9 -8
  274. package/dest/test-helpers/make-test-p2p-clients.d.ts +7 -8
  275. package/dest/test-helpers/make-test-p2p-clients.d.ts.map +1 -1
  276. package/dest/test-helpers/make-test-p2p-clients.js +1 -2
  277. package/dest/test-helpers/mock-pubsub.d.ts +40 -6
  278. package/dest/test-helpers/mock-pubsub.d.ts.map +1 -1
  279. package/dest/test-helpers/mock-pubsub.js +139 -13
  280. package/dest/test-helpers/reqresp-nodes.d.ts +2 -3
  281. package/dest/test-helpers/reqresp-nodes.d.ts.map +1 -1
  282. package/dest/test-helpers/reqresp-nodes.js +5 -5
  283. package/dest/test-helpers/testbench-utils.d.ts +43 -38
  284. package/dest/test-helpers/testbench-utils.d.ts.map +1 -1
  285. package/dest/test-helpers/testbench-utils.js +150 -61
  286. package/dest/testbench/p2p_client_testbench_worker.d.ts +2 -2
  287. package/dest/testbench/p2p_client_testbench_worker.d.ts.map +1 -1
  288. package/dest/testbench/p2p_client_testbench_worker.js +80 -28
  289. package/dest/testbench/worker_client_manager.d.ts +10 -1
  290. package/dest/testbench/worker_client_manager.d.ts.map +1 -1
  291. package/dest/testbench/worker_client_manager.js +55 -3
  292. package/dest/util.d.ts +3 -3
  293. package/dest/util.d.ts.map +1 -1
  294. package/package.json +14 -14
  295. package/src/client/factory.ts +105 -29
  296. package/src/client/interface.ts +65 -35
  297. package/src/client/p2p_client.ts +216 -272
  298. package/src/client/test/tx_proposal_collector/proposal_tx_collector_worker.ts +34 -15
  299. package/src/config.ts +171 -45
  300. package/src/errors/p2p-service.error.ts +11 -0
  301. package/src/errors/tx-pool.error.ts +12 -0
  302. package/src/index.ts +1 -1
  303. package/src/mem_pools/attestation_pool/attestation_pool.ts +501 -91
  304. package/src/mem_pools/attestation_pool/attestation_pool_test_suite.ts +442 -102
  305. package/src/mem_pools/attestation_pool/index.ts +9 -2
  306. package/src/mem_pools/attestation_pool/mocks.ts +2 -1
  307. package/src/mem_pools/index.ts +2 -2
  308. package/src/mem_pools/instrumentation.ts +17 -13
  309. package/src/mem_pools/interface.ts +4 -4
  310. package/src/mem_pools/tx_pool_v2/README.md +85 -11
  311. package/src/mem_pools/tx_pool_v2/deleted_pool.ts +321 -0
  312. package/src/mem_pools/tx_pool_v2/eviction/eviction_manager.ts +21 -8
  313. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.ts +7 -3
  314. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.ts +18 -4
  315. package/src/mem_pools/tx_pool_v2/eviction/index.ts +4 -0
  316. package/src/mem_pools/tx_pool_v2/eviction/interfaces.ts +59 -4
  317. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.ts +5 -5
  318. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.ts +8 -8
  319. package/src/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.ts +14 -9
  320. package/src/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.ts +33 -6
  321. package/src/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.ts +4 -3
  322. package/src/mem_pools/tx_pool_v2/index.ts +2 -1
  323. package/src/mem_pools/tx_pool_v2/instrumentation.ts +69 -0
  324. package/src/mem_pools/tx_pool_v2/interfaces.ts +32 -12
  325. package/src/mem_pools/tx_pool_v2/tx_metadata.ts +209 -27
  326. package/src/mem_pools/tx_pool_v2/tx_pool_indices.ts +58 -45
  327. package/src/mem_pools/tx_pool_v2/tx_pool_v2.ts +34 -8
  328. package/src/mem_pools/tx_pool_v2/tx_pool_v2_impl.ts +410 -187
  329. package/src/msg_validators/attestation_validator/README.md +49 -0
  330. package/src/msg_validators/attestation_validator/attestation_validator.ts +21 -9
  331. package/src/msg_validators/attestation_validator/fisherman_attestation_validator.ts +6 -3
  332. package/src/msg_validators/clock_tolerance.ts +72 -3
  333. package/src/msg_validators/proposal_validator/README.md +123 -0
  334. package/src/msg_validators/proposal_validator/block_proposal_validator.ts +17 -4
  335. package/src/msg_validators/proposal_validator/checkpoint_proposal_validator.ts +23 -7
  336. package/src/msg_validators/proposal_validator/proposal_validator.ts +79 -49
  337. package/src/msg_validators/tx_validator/README.md +119 -0
  338. package/src/msg_validators/tx_validator/aggregate_tx_validator.ts +5 -5
  339. package/src/msg_validators/tx_validator/allowed_public_setup.ts +22 -27
  340. package/src/msg_validators/tx_validator/allowed_setup_helpers.ts +31 -0
  341. package/src/msg_validators/tx_validator/archive_cache.ts +1 -1
  342. package/src/msg_validators/tx_validator/block_header_validator.ts +15 -3
  343. package/src/msg_validators/tx_validator/contract_instance_validator.ts +56 -0
  344. package/src/msg_validators/tx_validator/data_validator.ts +42 -1
  345. package/src/msg_validators/tx_validator/double_spend_validator.ts +11 -6
  346. package/src/msg_validators/tx_validator/factory.ts +394 -78
  347. package/src/msg_validators/tx_validator/fee_payer_balance.ts +6 -2
  348. package/src/msg_validators/tx_validator/gas_validator.ts +145 -33
  349. package/src/msg_validators/tx_validator/index.ts +2 -0
  350. package/src/msg_validators/tx_validator/metadata_validator.ts +12 -4
  351. package/src/msg_validators/tx_validator/nullifier_cache.ts +30 -0
  352. package/src/msg_validators/tx_validator/phases_validator.ts +82 -27
  353. package/src/msg_validators/tx_validator/timestamp_validator.ts +23 -18
  354. package/src/services/data_store.ts +5 -13
  355. package/src/services/dummy_service.ts +25 -7
  356. package/src/services/encoding.ts +18 -10
  357. package/src/services/gossipsub/README.md +641 -0
  358. package/src/services/gossipsub/index.ts +2 -0
  359. package/src/services/gossipsub/scoring.ts +29 -5
  360. package/src/services/gossipsub/topic_score_params.ts +519 -0
  361. package/src/services/libp2p/libp2p_service.ts +566 -460
  362. package/src/services/peer-manager/metrics.ts +7 -0
  363. package/src/services/peer-manager/peer_manager.ts +45 -11
  364. package/src/services/peer-manager/peer_scoring.ts +52 -5
  365. package/src/services/reqresp/README.md +229 -0
  366. package/src/services/reqresp/batch-tx-requester/README.md +46 -7
  367. package/src/services/reqresp/batch-tx-requester/batch_tx_requester.ts +79 -112
  368. package/src/services/reqresp/batch-tx-requester/interface.ts +3 -6
  369. package/src/services/reqresp/batch-tx-requester/missing_txs.ts +30 -71
  370. package/src/services/reqresp/batch-tx-requester/peer_collection.ts +68 -24
  371. package/src/services/reqresp/batch-tx-requester/tx_validator.ts +2 -2
  372. package/src/services/reqresp/config.ts +2 -2
  373. package/src/services/reqresp/interface.ts +45 -10
  374. package/src/services/reqresp/metrics.ts +0 -1
  375. package/src/services/reqresp/protocols/block_txs/block_txs_handler.ts +4 -3
  376. package/src/services/reqresp/protocols/block_txs/block_txs_reqresp.ts +17 -0
  377. package/src/services/reqresp/protocols/index.ts +0 -1
  378. package/src/services/reqresp/protocols/tx.ts +23 -3
  379. package/src/services/reqresp/rate-limiter/rate_limiter.ts +13 -9
  380. package/src/services/reqresp/rate-limiter/rate_limits.ts +0 -10
  381. package/src/services/reqresp/reqresp.ts +53 -16
  382. package/src/services/service.ts +57 -3
  383. package/src/services/tx_collection/config.ts +68 -0
  384. package/src/services/tx_collection/fast_tx_collection.ts +83 -76
  385. package/src/services/tx_collection/file_store_tx_collection.ts +202 -0
  386. package/src/services/tx_collection/file_store_tx_source.ts +129 -0
  387. package/src/services/tx_collection/index.ts +1 -0
  388. package/src/services/tx_collection/instrumentation.ts +7 -1
  389. package/src/services/tx_collection/proposal_tx_collector.ts +9 -13
  390. package/src/services/tx_collection/request_tracker.ts +127 -0
  391. package/src/services/tx_collection/slow_tx_collection.ts +66 -33
  392. package/src/services/tx_collection/tx_collection.ts +114 -19
  393. package/src/services/tx_collection/tx_collection_sink.ts +30 -34
  394. package/src/services/tx_collection/tx_source.ts +28 -8
  395. package/src/services/tx_file_store/config.ts +0 -6
  396. package/src/services/tx_file_store/tx_file_store.ts +10 -8
  397. package/src/services/tx_provider.ts +10 -9
  398. package/src/test-helpers/make-test-p2p-clients.ts +4 -6
  399. package/src/test-helpers/mock-pubsub.ts +177 -14
  400. package/src/test-helpers/reqresp-nodes.ts +7 -9
  401. package/src/test-helpers/testbench-utils.ts +157 -74
  402. package/src/testbench/p2p_client_testbench_worker.ts +91 -31
  403. package/src/testbench/worker_client_manager.ts +68 -6
  404. package/src/util.ts +8 -2
  405. package/dest/mem_pools/attestation_pool/kv_attestation_pool.d.ts +0 -40
  406. package/dest/mem_pools/attestation_pool/kv_attestation_pool.d.ts.map +0 -1
  407. package/dest/mem_pools/attestation_pool/kv_attestation_pool.js +0 -218
  408. package/dest/mem_pools/attestation_pool/memory_attestation_pool.d.ts +0 -31
  409. package/dest/mem_pools/attestation_pool/memory_attestation_pool.d.ts.map +0 -1
  410. package/dest/mem_pools/attestation_pool/memory_attestation_pool.js +0 -180
  411. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.d.ts +0 -125
  412. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.d.ts.map +0 -1
  413. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.js +0 -596
  414. package/dest/mem_pools/tx_pool/eviction/eviction_manager.d.ts +0 -32
  415. package/dest/mem_pools/tx_pool/eviction/eviction_manager.d.ts.map +0 -1
  416. package/dest/mem_pools/tx_pool/eviction/eviction_manager.js +0 -112
  417. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.d.ts +0 -157
  418. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.d.ts.map +0 -1
  419. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.js +0 -52
  420. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.d.ts +0 -16
  421. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.d.ts.map +0 -1
  422. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.js +0 -122
  423. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.d.ts +0 -17
  424. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.d.ts.map +0 -1
  425. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.js +0 -84
  426. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.d.ts +0 -19
  427. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.d.ts.map +0 -1
  428. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.js +0 -78
  429. package/dest/mem_pools/tx_pool/eviction/low_priority_eviction_rule.d.ts +0 -26
  430. package/dest/mem_pools/tx_pool/eviction/low_priority_eviction_rule.d.ts.map +0 -1
  431. package/dest/mem_pools/tx_pool/eviction/low_priority_eviction_rule.js +0 -84
  432. package/dest/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.d.ts +0 -25
  433. package/dest/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.d.ts.map +0 -1
  434. package/dest/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.js +0 -57
  435. package/dest/mem_pools/tx_pool/index.d.ts +0 -3
  436. package/dest/mem_pools/tx_pool/index.d.ts.map +0 -1
  437. package/dest/mem_pools/tx_pool/index.js +0 -2
  438. package/dest/mem_pools/tx_pool/priority.d.ts +0 -12
  439. package/dest/mem_pools/tx_pool/priority.d.ts.map +0 -1
  440. package/dest/mem_pools/tx_pool/priority.js +0 -15
  441. package/dest/mem_pools/tx_pool/tx_pool.d.ts +0 -127
  442. package/dest/mem_pools/tx_pool/tx_pool.d.ts.map +0 -1
  443. package/dest/mem_pools/tx_pool/tx_pool.js +0 -3
  444. package/dest/mem_pools/tx_pool/tx_pool_test_suite.d.ts +0 -7
  445. package/dest/mem_pools/tx_pool/tx_pool_test_suite.d.ts.map +0 -1
  446. package/dest/mem_pools/tx_pool/tx_pool_test_suite.js +0 -400
  447. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.d.ts +0 -23
  448. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.d.ts.map +0 -1
  449. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.js +0 -212
  450. package/dest/services/reqresp/protocols/block.d.ts +0 -9
  451. package/dest/services/reqresp/protocols/block.d.ts.map +0 -1
  452. package/dest/services/reqresp/protocols/block.js +0 -32
  453. package/src/mem_pools/attestation_pool/kv_attestation_pool.ts +0 -320
  454. package/src/mem_pools/attestation_pool/memory_attestation_pool.ts +0 -264
  455. package/src/mem_pools/tx_pool/README.md +0 -270
  456. package/src/mem_pools/tx_pool/aztec_kv_tx_pool.ts +0 -746
  457. package/src/mem_pools/tx_pool/eviction/eviction_manager.ts +0 -132
  458. package/src/mem_pools/tx_pool/eviction/eviction_strategy.ts +0 -208
  459. package/src/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.ts +0 -162
  460. package/src/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.ts +0 -104
  461. package/src/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.ts +0 -93
  462. package/src/mem_pools/tx_pool/eviction/low_priority_eviction_rule.ts +0 -106
  463. package/src/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.ts +0 -75
  464. package/src/mem_pools/tx_pool/index.ts +0 -2
  465. package/src/mem_pools/tx_pool/priority.ts +0 -20
  466. package/src/mem_pools/tx_pool/tx_pool.ts +0 -141
  467. package/src/mem_pools/tx_pool/tx_pool_test_suite.ts +0 -319
  468. package/src/msg_validators/proposal_validator/proposal_validator_test_suite.ts +0 -230
  469. 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,8 +57,8 @@ import { ENR } from '@nethermindeth/enr';
59
57
  import { createLibp2p } from 'libp2p';
60
58
 
61
59
  import type { P2PConfig } from '../../config.js';
62
- import { ProposalSlotCapExceededError } from '../../errors/attestation-pool.error.js';
63
- import type { MemPools } from '../../mem_pools/index.js';
60
+ import { CheckpointProposalReceivedCallbackNotRegisteredError } from '../../errors/p2p-service.error.js';
61
+ import type { MemPools } from '../../mem_pools/interface.js';
64
62
  import {
65
63
  BlockProposalValidator,
66
64
  CheckpointAttestationValidator,
@@ -71,9 +69,11 @@ import {
71
69
  } from '../../msg_validators/index.js';
72
70
  import { MessageSeenValidator } from '../../msg_validators/msg_seen_validator/msg_seen_validator.js';
73
71
  import {
74
- type MessageValidator,
75
- createTxMessageValidators,
76
- createTxReqRespValidator,
72
+ type TransactionValidator,
73
+ createFirstStageTxValidationsForGossipedTransactions,
74
+ createSecondStageTxValidationsForGossipedTransactions,
75
+ createTxValidatorForBlockProposalReceivedTxs,
76
+ createTxValidatorForReqResponseReceivedTxs,
77
77
  } from '../../msg_validators/tx_validator/factory.js';
78
78
  import { GossipSubEvent } from '../../types/index.js';
79
79
  import { type PubSubLibp2p, convertToMultiaddr } from '../../util.js';
@@ -81,13 +81,17 @@ 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,17 +99,11 @@ 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/index.js';
101
- import {
102
- AuthRequest,
103
- BlockTxsRequest,
104
- BlockTxsResponse,
105
- StatusMessage,
106
105
  pingHandler,
107
106
  reqGoodbyeHandler,
108
- reqRespBlockHandler,
109
107
  reqRespBlockTxsHandler,
110
108
  reqRespStatusHandler,
111
109
  reqRespTxHandler,
@@ -114,6 +112,7 @@ 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,14 +528,12 @@ 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) {
@@ -541,7 +554,6 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
541
554
  ...DEFAULT_SUB_PROTOCOL_VALIDATORS,
542
555
  [ReqRespSubProtocol.TX]: this.validateRequestedTxs.bind(this),
543
556
  [ReqRespSubProtocol.BLOCK_TXS]: this.validateRequestedBlockTxs.bind(this),
544
- [ReqRespSubProtocol.BLOCK]: this.validateRequestedBlock.bind(this),
545
557
  };
546
558
 
547
559
  await this.peerManager.initializePeers();
@@ -551,7 +563,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
551
563
  await this.node.start();
552
564
 
553
565
  // Subscribe to standard GossipSub topics by default
554
- for (const topic of getTopicsForClientAndConfig(this.clientType, this.config.disableTransactions)) {
566
+ for (const topic of getTopicsForConfig(this.config.disableTransactions)) {
555
567
  this.subscribeToTopic(this.topicStrings[topic]);
556
568
  }
557
569
 
@@ -617,6 +629,10 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
617
629
  return this.peerManager.getPeers(includePending);
618
630
  }
619
631
 
632
+ public getGossipMeshPeerCount(topicType: TopicType): number {
633
+ return this.node.services.pubsub.getMeshPeers(this.topicStrings[topicType]).length;
634
+ }
635
+
620
636
  private handleGossipSubEvent(e: CustomEvent<GossipsubMessage>) {
621
637
  this.logger.trace(`Received PUBSUB message.`);
622
638
 
@@ -665,8 +681,35 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
665
681
  this.blockReceivedCallback = callback;
666
682
  }
667
683
 
668
- public registerCheckpointReceivedCallback(callback: P2PCheckpointReceivedCallback) {
669
- 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;
670
713
  }
671
714
 
672
715
  /**
@@ -733,6 +776,9 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
733
776
  if (!validator || !validator.addMessage(msgId)) {
734
777
  this.instrumentation.incMessagePrevalidationStatus(false, topicType);
735
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
+ }
736
782
  return { result: false, topicType };
737
783
  }
738
784
 
@@ -797,9 +843,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
797
843
  if (msg.topic === this.topicStrings[TopicType.tx]) {
798
844
  await this.handleGossipedTx(p2pMessage.payload, msgId, source);
799
845
  } else if (msg.topic === this.topicStrings[TopicType.checkpoint_attestation]) {
800
- if (this.clientType === P2PClientType.Full) {
801
- await this.processCheckpointAttestationFromPeer(p2pMessage.payload, msgId, source);
802
- }
846
+ await this.processCheckpointAttestationFromPeer(p2pMessage.payload, msgId, source);
803
847
  } else if (msg.topic === this.topicStrings[TopicType.block_proposal]) {
804
848
  await this.processBlockFromPeer(p2pMessage.payload, msgId, source);
805
849
  } else if (msg.topic === this.topicStrings[TopicType.checkpoint_proposal]) {
@@ -855,51 +899,134 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
855
899
  return;
856
900
  }
857
901
 
858
- protected async validateReceivedMessage<T>(
859
- validationFunc: () => Promise<ReceivedMessageValidationResult<T>>,
902
+ protected async validateReceivedMessage<T, M = undefined>(
903
+ validationFunc: () => Promise<ReceivedMessageValidationResult<T, M>>,
860
904
  msgId: string,
861
905
  source: PeerId,
862
906
  topicType: TopicType,
863
- ): Promise<ReceivedMessageValidationResult<T>> {
864
- 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
+ };
865
913
  const timer = new Timer();
866
914
  try {
867
915
  resultAndObj = await validationFunc();
868
916
  } catch (err) {
869
- this.peerManager.penalizePeer(source, PeerErrorSeverity.LowToleranceError);
870
- this.logger.error(`Error deserializing and validating gossipsub message`, err, {
871
- msgId,
872
- source: source.toString(),
873
- topicType,
874
- });
917
+ this.logger.error(`Error validating gossipsub message`, err, { msgId, source: source.toString(), topicType });
875
918
  }
876
919
 
877
920
  if (resultAndObj.result === TopicValidatorResult.Accept) {
921
+ this.logger.debug(`Message ${topicType} accepted by validator`, { msgId, source: source.toString(), topicType });
878
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 });
879
933
  }
880
934
 
881
935
  this.node.services.pubsub.reportMessageValidationResult(msgId, source.toString(), resultAndObj.result);
882
936
  return resultAndObj;
883
937
  }
884
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
+
885
952
  protected async handleGossipedTx(payloadData: Buffer, msgId: string, source: PeerId) {
886
953
  const validationFunc: () => Promise<ReceivedMessageValidationResult<Tx>> = async () => {
887
- const tx = Tx.fromBuffer(payloadData);
888
- const isValid = await this.validatePropagatedTx(tx, source);
889
- 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
+ }
890
993
 
891
- this.logger.trace(`Validate propagated tx`, {
892
- isValid,
893
- 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,
894
1017
  [Attributes.P2P_ID]: source.toString(),
895
1018
  });
896
1019
 
897
- if (!isValid) {
898
- return { result: TopicValidatorResult.Reject };
899
- } else if (exists) {
1020
+ if (wasAccepted) {
1021
+ return { result: TopicValidatorResult.Accept, obj: tx };
1022
+ } else if (wasIgnored) {
900
1023
  return { result: TopicValidatorResult.Ignore, obj: tx };
901
1024
  } else {
902
- 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 };
903
1030
  }
904
1031
  };
905
1032
 
@@ -908,6 +1035,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
908
1035
  return;
909
1036
  }
910
1037
 
1038
+ // Tx was accepted into pool and will be propagated - just log and record metrics
911
1039
  const txHash = tx.getTxHash();
912
1040
  const txHashString = txHash.toString();
913
1041
  this.logger.verbose(`Received tx ${txHashString} from external peer ${source.toString()} via gossip`, {
@@ -915,13 +1043,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
915
1043
  txHash: txHashString,
916
1044
  });
917
1045
 
918
- if (this.config.dropTransactions && randomInt(1000) < this.config.dropTransactionsProbability * 1000) {
919
- this.logger.warn(`Intentionally dropping tx ${txHashString} (probability rule)`);
920
- return;
921
- }
922
-
923
1046
  this.instrumentation.incrementTxReceived(1);
924
- await this.mempools.txPool.addTxs([tx]);
925
1047
  }
926
1048
 
927
1049
  /**
@@ -933,47 +1055,17 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
933
1055
  msgId: string,
934
1056
  source: PeerId,
935
1057
  ): Promise<void> {
936
- const validationFunc: () => Promise<ReceivedMessageValidationResult<CheckpointAttestation>> = async () => {
937
- const attestation = CheckpointAttestation.fromBuffer(payloadData);
938
- const pool = this.mempools.attestationPool;
939
- const validationResult = await this.validateCheckpointAttestation(source, attestation);
940
- const isValid = validationResult.result === 'accept';
941
- const exists = isValid && (await pool.hasCheckpointAttestation(attestation));
942
-
943
- let canAdd = true;
944
- if (isValid && !exists) {
945
- const slot = attestation.payload.header.slotNumber;
946
- const { committee } = await this.epochCache.getCommittee(slot);
947
- const committeeSize = committee?.length ?? 0;
948
- canAdd = await pool.canAddCheckpointAttestation(attestation, committeeSize);
949
- }
950
-
951
- this.logger.trace(`Validate propagated checkpoint attestation`, {
952
- isValid,
953
- exists,
954
- canAdd,
955
- [Attributes.SLOT_NUMBER]: attestation.payload.header.slotNumber.toString(),
956
- [Attributes.P2P_ID]: source.toString(),
957
- });
958
-
959
- if (validationResult.result === 'reject') {
960
- return { result: TopicValidatorResult.Reject };
961
- } else if (validationResult.result === 'ignore' || exists) {
962
- return { result: TopicValidatorResult.Ignore, obj: attestation };
963
- } else if (!canAdd) {
964
- this.logger.warn(`Dropping checkpoint attestation due to per-(slot, proposalId) attestation cap`, {
965
- slot: attestation.payload.header.slotNumber.toString(),
966
- archive: attestation.archive.toString(),
967
- source: source.toString(),
968
- });
969
- return { result: TopicValidatorResult.Ignore, obj: attestation };
970
- } else {
971
- return { result: TopicValidatorResult.Accept, obj: attestation };
972
- }
973
- };
974
-
975
1058
  const { result, obj: attestation } = await this.validateReceivedMessage<CheckpointAttestation>(
976
- 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
+ },
977
1069
  msgId,
978
1070
  source,
979
1071
  TopicType.checkpoint_attestation,
@@ -983,8 +1075,8 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
983
1075
  return;
984
1076
  }
985
1077
 
986
- this.logger.debug(
987
- `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()}`,
988
1080
  {
989
1081
  p2pMessageIdentifier: await attestation.p2pMessageLoggingIdentifier(),
990
1082
  slot: attestation.slotNumber,
@@ -992,60 +1084,168 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
992
1084
  source: source.toString(),
993
1085
  },
994
1086
  );
995
-
996
- await this.mempools.attestationPool.addCheckpointAttestations([attestation]);
997
1087
  }
998
1088
 
999
- private async processBlockFromPeer(payloadData: Buffer, msgId: string, source: PeerId): Promise<void> {
1000
- const validationFunc: () => Promise<ReceivedMessageValidationResult<BlockProposal>> = async () => {
1001
- const block = BlockProposal.fromBuffer(payloadData);
1002
- const validationResult = await this.validateBlockProposal(source, block);
1003
- const isValid = validationResult.result === 'accept';
1004
- const pool = this.mempools.attestationPool;
1005
-
1006
- const exists = isValid && (await pool.hasBlockProposal(block));
1007
- const canAdd = isValid && (await pool.canAddProposal(block));
1008
-
1009
- this.logger.trace(`Validate propagated block proposal`, {
1010
- isValid,
1011
- exists,
1012
- canAdd,
1013
- [Attributes.SLOT_NUMBER]: block.slotNumber.toString(),
1014
- [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,
1015
1135
  });
1136
+ return { result: TopicValidatorResult.Reject, severity: PeerErrorSeverity.HighToleranceError };
1137
+ }
1016
1138
 
1017
- if (validationResult.result === 'reject') {
1018
- return { result: TopicValidatorResult.Reject };
1019
- } else if (validationResult.result === 'ignore' || exists) {
1020
- return { result: TopicValidatorResult.Ignore, obj: block };
1021
- } else if (!canAdd) {
1022
- this.peerManager.penalizePeer(source, PeerErrorSeverity.MidToleranceError);
1023
- this.logger.warn(`Penalizing peer for block proposal exceeding per-slot cap`, {
1024
- slot: block.slotNumber.toString(),
1025
- archive: block.archive.toString(),
1026
- 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(),
1027
1149
  });
1028
- return { result: TopicValidatorResult.Reject };
1029
- } else {
1030
- return { result: TopicValidatorResult.Accept, obj: block };
1150
+ this.duplicateAttestationCallback?.({ slot, attester });
1031
1151
  }
1032
- };
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
+ }
1033
1157
 
1034
- const { result, obj: block } = await this.validateReceivedMessage<BlockProposal>(
1035
- 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)),
1036
1165
  msgId,
1037
1166
  source,
1038
1167
  TopicType.block_proposal,
1039
1168
  );
1040
1169
 
1041
- if (!result || !block) {
1170
+ // If not accepted or equivocated, return
1171
+ if (result !== TopicValidatorResult.Accept || !block || isEquivocated) {
1042
1172
  return;
1043
1173
  }
1044
1174
 
1045
1175
  await this.processValidBlockProposal(block, source);
1046
1176
  }
1047
1177
 
1048
- // 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
+
1049
1249
  // REFACTOR(palla): This method should be moved to the p2p_client or to a separate component,
1050
1250
  // should not be here as it does not deal with p2p networking.
1051
1251
  @trackSpan('Libp2pService.processValidBlockProposal', async block => ({
@@ -1053,7 +1253,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1053
1253
  [Attributes.BLOCK_ARCHIVE]: block.archive.toString(),
1054
1254
  [Attributes.P2P_ID]: await block.p2pMessageLoggingIdentifier().then(i => i.toString()),
1055
1255
  }))
1056
- private async processValidBlockProposal(block: BlockProposal, sender: PeerId) {
1256
+ protected async processValidBlockProposal(block: BlockProposal, sender: PeerId) {
1057
1257
  const slot = block.slotNumber;
1058
1258
  this.logger.verbose(`Received block proposal for slot ${slot} from external peer ${sender.toString()}.`, {
1059
1259
  p2pMessageIdentifier: await block.p2pMessageLoggingIdentifier(),
@@ -1061,30 +1261,14 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1061
1261
  ...block.toBlockInfo(),
1062
1262
  });
1063
1263
 
1064
- // Attempt to add proposal
1065
- try {
1066
- await this.mempools.attestationPool.addBlockProposal(block);
1067
- } catch (err: unknown) {
1068
- // Drop proposals if we hit per-slot cap in the attestation pool; rethrow unknown errors
1069
- if (err instanceof ProposalSlotCapExceededError) {
1070
- this.logger.warn(`Dropping block proposal due to per-slot proposal cap`, {
1071
- slot: String(slot),
1072
- archive: block.archive.toString(),
1073
- error: (err as Error).message,
1074
- });
1075
- return;
1076
- }
1077
- throw err;
1078
- }
1079
-
1080
- // Mark the txs in this proposal as non-evictable
1081
- 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);
1082
1266
 
1083
1267
  // Call the block received callback to validate the proposal.
1084
1268
  // Note: Validators do NOT attest to individual blocks, only to checkpoint proposals.
1085
1269
  const isValid = await this.blockReceivedCallback(block, sender);
1086
1270
  if (!isValid) {
1087
- 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());
1088
1272
  }
1089
1273
  }
1090
1274
 
@@ -1092,67 +1276,149 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1092
1276
  * Handle a gossiped checkpoint proposal.
1093
1277
  * Validates and processes the checkpoint proposal, then triggers the callback for attestation.
1094
1278
  */
1095
- private async handleGossipedCheckpointProposal(payloadData: Buffer, msgId: string, source: PeerId): Promise<void> {
1096
- // TODO(palla/mbps): This pattern is repeated across multiple message handlers, consider abstracting it.
1097
- const validationFunc: () => Promise<ReceivedMessageValidationResult<CheckpointProposal>> = async () => {
1098
- const checkpoint = CheckpointProposal.fromBuffer(payloadData);
1099
- const validationResult = await this.validateCheckpointProposal(source, checkpoint);
1100
- const isValid = validationResult.result === 'accept';
1101
- const pool = this.mempools.attestationPool;
1102
-
1103
- const exists = isValid && (await pool.hasCheckpointProposal(checkpoint));
1104
- const canAdd = isValid && (await pool.canAddCheckpointProposal(checkpoint));
1105
-
1106
- this.logger.trace(`Validate propagated checkpoint proposal`, {
1107
- isValid,
1108
- exists,
1109
- canAdd,
1110
- [Attributes.SLOT_NUMBER]: checkpoint.slotNumber.toString(),
1111
- [Attributes.P2P_ID]: source.toString(),
1112
- });
1113
-
1114
- if (validationResult.result === 'reject') {
1115
- return { result: TopicValidatorResult.Reject };
1116
- } else if (validationResult.result === 'ignore' || exists) {
1117
- return { result: TopicValidatorResult.Ignore, obj: checkpoint };
1118
- } else if (!canAdd) {
1119
- this.peerManager.penalizePeer(source, PeerErrorSeverity.MidToleranceError);
1120
- this.logger.warn(`Penalizing peer for checkpoint proposal exceeding per-slot cap`, {
1121
- slot: checkpoint.slotNumber.toString(),
1122
- archive: checkpoint.archive.toString(),
1123
- source: source.toString(),
1124
- });
1125
- return { result: TopicValidatorResult.Reject };
1126
- } else {
1127
- return { result: TopicValidatorResult.Accept, obj: checkpoint };
1128
- }
1129
- };
1130
-
1131
- const { result, obj: checkpoint } = await this.validateReceivedMessage<CheckpointProposal>(
1132
- 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)),
1133
1286
  msgId,
1134
1287
  source,
1135
1288
  TopicType.checkpoint_proposal,
1136
1289
  );
1137
1290
 
1138
- 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) {
1139
1298
  return;
1140
1299
  }
1141
1300
 
1142
- 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 } };
1143
1410
  }
1144
1411
 
1145
1412
  /**
1146
1413
  * Process a validated checkpoint proposal.
1147
- * Extracts and processes the last block proposal (if present) first, then processes the checkpoint.
1148
- * The block callback is invoked before the checkpoint callback.
1414
+ * Note: The proposal was already added to the pool by tryAddCheckpointProposal in handleGossipedCheckpointProposal.
1149
1415
  */
1150
1416
  @trackSpan('Libp2pService.processValidCheckpointProposal', async checkpoint => ({
1151
1417
  [Attributes.SLOT_NUMBER]: checkpoint.slotNumber,
1152
1418
  [Attributes.BLOCK_ARCHIVE]: checkpoint.archive.toString(),
1153
1419
  [Attributes.P2P_ID]: await checkpoint.p2pMessageLoggingIdentifier().then(i => i.toString()),
1154
1420
  }))
1155
- private async processValidCheckpointProposal(checkpoint: CheckpointProposal, sender: PeerId) {
1421
+ protected async processValidCheckpointProposal(checkpoint: CheckpointProposalCore, sender: PeerId) {
1156
1422
  const slot = checkpoint.slotNumber;
1157
1423
  this.logger.verbose(`Received checkpoint proposal for slot ${slot} from external peer ${sender.toString()}.`, {
1158
1424
  p2pMessageIdentifier: await checkpoint.p2pMessageLoggingIdentifier(),
@@ -1161,37 +1427,14 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1161
1427
  source: sender.toString(),
1162
1428
  });
1163
1429
 
1164
- // Extract block proposal before adding to pool (pool stores them separately)
1165
- const blockProposal = checkpoint.getBlockProposal();
1166
-
1167
- // Add proposal to the pool (this extracts and stores block proposal separately)
1168
- await this.mempools.attestationPool.addCheckpointProposal(checkpoint);
1169
-
1170
- // Mark txs as non-evictable if present (from the last block)
1171
- if (checkpoint.txHashes.length > 0) {
1172
- await this.mempools.txPool.markTxsAsNonEvictable(checkpoint.txHashes);
1173
- }
1174
-
1175
- // If there was a last block proposal, invoke the block callback first for validation.
1176
- // Note: The block proposal is already stored in the pool by addCheckpointProposal.
1177
- if (blockProposal) {
1178
- const isValid = await this.blockReceivedCallback(blockProposal, sender);
1179
- if (!isValid) {
1180
- this.logger.warn(`Block proposal from checkpoint failed validation`, {
1181
- slot: slot.toString(),
1182
- archive: checkpoint.archive.toString(),
1183
- blockNumber: blockProposal.blockNumber.toString(),
1184
- });
1185
- return;
1186
- }
1187
- }
1430
+ await this.allNodesCheckpointReceivedCallback(checkpoint, sender);
1188
1431
 
1189
1432
  // Call the checkpoint received callback with the core version (without lastBlock)
1190
1433
  // to validate and potentially generate attestations
1191
- const attestations = await this.checkpointReceivedCallback(checkpoint.toCore(), sender);
1434
+ const attestations = await this.validatorCheckpointReceivedCallback(checkpoint, sender);
1192
1435
  if (attestations && attestations.length > 0) {
1193
1436
  // If the callback returned attestations, add them to the pool and propagate them
1194
- await this.mempools.attestationPool.addCheckpointAttestations(attestations);
1437
+ await this.mempools.attestationPool.addOwnCheckpointAttestations(attestations);
1195
1438
  for (const attestation of attestations) {
1196
1439
  await this.propagate(attestation);
1197
1440
  }
@@ -1220,7 +1463,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1220
1463
  @trackSpan('Libp2pService.validateRequestedBlockTxs', request => ({
1221
1464
  [Attributes.BLOCK_ARCHIVE]: request.archiveRoot.toString(),
1222
1465
  }))
1223
- private async validateRequestedBlockTxs(
1466
+ protected async validateRequestedBlockTxs(
1224
1467
  request: BlockTxsRequest,
1225
1468
  response: BlockTxsResponse,
1226
1469
  peerId: PeerId,
@@ -1336,54 +1579,12 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1336
1579
  }
1337
1580
  }
1338
1581
 
1339
- /**
1340
- * Validates a BLOCK response.
1341
- *
1342
- * If a local copy exists, enforces hash equality. If missing, rejects (no penalty) since the hash cannot be verified.
1343
- * Penalizes on block number mismatch or hash mismatch.
1344
- *
1345
- * @param requestedBlockNumber - The requested block number.
1346
- * @param responseBlock - The block returned by the peer.
1347
- * @param peerId - The peer that returned the block.
1348
- * @returns True if the response is valid, false otherwise.
1349
- */
1350
- @trackSpan('Libp2pService.validateRequestedBlock', (requestedBlockNumber, _responseBlock) => ({
1351
- [Attributes.BLOCK_NUMBER]: requestedBlockNumber.toString(),
1352
- }))
1353
- private async validateRequestedBlock(
1354
- requestedBlockNumber: Fr,
1355
- responseBlock: L2Block,
1582
+ protected async validateRequestedTx(
1583
+ tx: Tx,
1356
1584
  peerId: PeerId,
1357
- ): Promise<boolean> {
1358
- try {
1359
- const reqNum = Number(requestedBlockNumber.toString());
1360
- if (responseBlock.number !== reqNum) {
1361
- this.peerManager.penalizePeer(peerId, PeerErrorSeverity.LowToleranceError);
1362
- return false;
1363
- }
1364
-
1365
- const local = await this.archiver.getBlock(BlockNumber(reqNum));
1366
- if (!local) {
1367
- // We are missing the local block; we cannot verify the hash yet. Reject without penalizing.
1368
- // TODO: Consider extending this validator to accept an expected hash or
1369
- // performing quorum-based checks when using P2P syncing prior to L1 sync.
1370
- this.logger.warn(`Local block ${reqNum} not found; rejecting BLOCK response without hash verification`);
1371
- return false;
1372
- }
1373
- const [localHash, respHash] = await Promise.all([local.hash(), responseBlock.hash()]);
1374
- if (!localHash.equals(respHash)) {
1375
- this.peerManager.penalizePeer(peerId, PeerErrorSeverity.MidToleranceError);
1376
- return false;
1377
- }
1378
-
1379
- return true;
1380
- } catch (e) {
1381
- this.logger.warn(`Error validating requested block`, e);
1382
- return false;
1383
- }
1384
- }
1385
-
1386
- private async validateRequestedTx(tx: Tx, peerId: PeerId, txValidator: TxValidator, requested?: Set<`0x${string}`>) {
1585
+ txValidator: TxValidator,
1586
+ requested?: Set<`0x${string}`>,
1587
+ ) {
1387
1588
  const penalize = (severity: PeerErrorSeverity) => this.peerManager.penalizePeer(peerId, severity);
1388
1589
  if (requested && !requested.has(tx.getTxHash().toString())) {
1389
1590
  penalize(PeerErrorSeverity.MidToleranceError);
@@ -1397,44 +1598,13 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1397
1598
  }
1398
1599
  }
1399
1600
 
1400
- private createRequestedTxValidator(): TxValidator {
1401
- return createTxReqRespValidator(this.proofVerifier, {
1601
+ protected createRequestedTxValidator(): TxValidator {
1602
+ return createTxValidatorForReqResponseReceivedTxs(this.proofVerifier, {
1402
1603
  l1ChainId: this.config.l1ChainId,
1403
1604
  rollupVersion: this.config.rollupVersion,
1404
1605
  });
1405
1606
  }
1406
1607
 
1407
- @trackSpan('Libp2pService.validatePropagatedTx', tx => ({
1408
- [Attributes.TX_HASH]: tx.getTxHash().toString(),
1409
- }))
1410
- private async validatePropagatedTx(tx: Tx, peerId: PeerId): Promise<boolean> {
1411
- const currentBlockNumber = await this.archiver.getBlockNumber();
1412
-
1413
- // We accept transactions if they are not expired by the next slot (checked based on the IncludeByTimestamp field)
1414
- const { ts: nextSlotTimestamp } = this.epochCache.getEpochAndSlotInNextL1Slot();
1415
- const messageValidators = await this.createMessageValidators(currentBlockNumber, nextSlotTimestamp);
1416
-
1417
- for (const validator of messageValidators) {
1418
- const outcome = await this.runValidations(tx, validator);
1419
-
1420
- if (outcome.allPassed) {
1421
- continue;
1422
- }
1423
- const { name } = outcome.failure;
1424
- let { severity } = outcome.failure;
1425
-
1426
- // Double spend validator has a special case handler
1427
- if (name === 'doubleSpendValidator') {
1428
- const txBlockNumber = BlockNumber(currentBlockNumber + 1); // tx is expected to be in the next block
1429
- severity = await this.handleDoubleSpendFailure(tx, txBlockNumber);
1430
- }
1431
-
1432
- this.peerManager.penalizePeer(peerId, severity);
1433
- return false;
1434
- }
1435
- return true;
1436
- }
1437
-
1438
1608
  private async getGasFees(blockNumber: BlockNumber): Promise<GasFees> {
1439
1609
  if (blockNumber === this.feesCache?.blockNumber) {
1440
1610
  return this.feesCache.gasFees;
@@ -1462,60 +1632,62 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1462
1632
  };
1463
1633
  }
1464
1634
 
1465
- public async validate(txs: Tx[]): Promise<void> {
1466
- const currentBlockNumber = await this.archiver.getBlockNumber();
1467
-
1468
- // We accept transactions if they are not expired by the next slot (checked based on the IncludeByTimestamp field)
1469
- const { ts: nextSlotTimestamp } = this.epochCache.getEpochAndSlotInNextL1Slot();
1470
- 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
+ );
1471
1641
 
1472
- await Promise.all(
1642
+ const results = await Promise.all(
1473
1643
  txs.map(async tx => {
1474
- for (const validator of messageValidators) {
1475
- const outcome = await this.runValidations(tx, validator);
1476
- if (!outcome.allPassed) {
1477
- throw new Error('Invalid tx detected', { cause: { outcome } });
1478
- }
1479
- }
1644
+ const result = await validator.validateTx(tx);
1645
+ return result.result !== 'invalid';
1480
1646
  }),
1481
1647
  );
1648
+ if (results.some(value => value === false)) {
1649
+ throw new Error('Invalid tx detected');
1650
+ }
1482
1651
  }
1483
1652
 
1484
- /**
1485
- * Create message validators for the given block number and timestamp.
1486
- *
1487
- * Each validator is a pair of a validator and a severity.
1488
- * If a validator fails, the peer is penalized with the severity of the validator.
1489
- *
1490
- * @param currentBlockNumber - The current synced block number.
1491
- * @param nextSlotTimestamp - The timestamp of the next slot (used to validate txs are not expired).
1492
- * @returns The message validators.
1493
- */
1494
- private async createMessageValidators(
1653
+ /** Creates the first stage (fast) validators for gossiped transactions. */
1654
+ protected async createFirstStageMessageValidators(
1495
1655
  currentBlockNumber: BlockNumber,
1496
1656
  nextSlotTimestamp: UInt64,
1497
- ): Promise<Record<string, MessageValidator>[]> {
1657
+ ): Promise<Record<string, TransactionValidator>> {
1498
1658
  const gasFees = await this.getGasFees(currentBlockNumber);
1499
- const allowedInSetup = this.config.txPublicSetupAllowList ?? (await getDefaultAllowedSetupFunctions());
1500
-
1501
- const blockNumberInWhichTheTxIsConsideredToBeIncluded = BlockNumber(currentBlockNumber + 1);
1502
-
1503
- 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(
1504
1667
  nextSlotTimestamp,
1505
- blockNumberInWhichTheTxIsConsideredToBeIncluded,
1668
+ blockNumber,
1506
1669
  this.worldStateSynchronizer,
1507
1670
  gasFees,
1508
1671
  this.config.l1ChainId,
1509
1672
  this.config.rollupVersion,
1510
1673
  protocolContractsHash,
1511
1674
  this.archiver,
1512
- this.proofVerifier,
1513
1675
  !this.config.disableTransactions,
1514
1676
  allowedInSetup,
1515
1677
  this.logger.getBindings(),
1678
+ {
1679
+ rollupManaLimit: l1Constants.rollupManaLimit,
1680
+ maxBlockL2Gas: this.config.validateMaxL2BlockGas,
1681
+ maxBlockDAGas: this.config.validateMaxDABlockGas,
1682
+ },
1516
1683
  );
1517
1684
  }
1518
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
+
1519
1691
  /**
1520
1692
  * Run validations on a tx.
1521
1693
  * @param tx - The tx to validate.
@@ -1524,7 +1696,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1524
1696
  */
1525
1697
  private async runValidations(
1526
1698
  tx: Tx,
1527
- messageValidators: Record<string, MessageValidator>,
1699
+ messageValidators: Record<string, TransactionValidator>,
1528
1700
  ): Promise<ValidationOutcome> {
1529
1701
  const validationPromises = Object.entries(messageValidators).map(async ([name, { validator, severity }]) => {
1530
1702
  const { result } = await validator.validateTx(tx);
@@ -1533,8 +1705,10 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1533
1705
 
1534
1706
  // A promise that resolves when all validations have been run
1535
1707
  const allValidations = await Promise.all(validationPromises);
1536
- const failed = allValidations.find(x => !x.isValid);
1537
- 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))!;
1538
1712
  return {
1539
1713
  allPassed: false,
1540
1714
  failure: {
@@ -1587,74 +1761,6 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1587
1761
  return PeerErrorSeverity.HighToleranceError;
1588
1762
  }
1589
1763
 
1590
- /**
1591
- * Validate a checkpoint attestation.
1592
- *
1593
- * @param attestation - The checkpoint attestation to validate.
1594
- * @returns True if the checkpoint attestation is valid, false otherwise.
1595
- */
1596
- @trackSpan('Libp2pService.validateCheckpointAttestation', async (_, attestation) => ({
1597
- [Attributes.SLOT_NUMBER]: attestation.payload.header.slotNumber,
1598
- [Attributes.BLOCK_ARCHIVE]: attestation.archive.toString(),
1599
- [Attributes.P2P_ID]: await attestation.p2pMessageLoggingIdentifier().then(i => i.toString()),
1600
- }))
1601
- public async validateCheckpointAttestation(
1602
- peerId: PeerId,
1603
- attestation: CheckpointAttestation,
1604
- ): Promise<P2PValidationResult> {
1605
- const result = await this.checkpointAttestationValidator.validate(attestation);
1606
-
1607
- if (result.result === 'reject') {
1608
- this.logger.debug(`Penalizing peer ${peerId} for checkpoint attestation validation failure`);
1609
- this.peerManager.penalizePeer(peerId, result.severity);
1610
- }
1611
-
1612
- return result;
1613
- }
1614
-
1615
- /**
1616
- * Validate a block proposal.
1617
- *
1618
- * @param block - The block proposal to validate.
1619
- * @returns True if the block proposal is valid, false otherwise.
1620
- */
1621
- @trackSpan('Libp2pService.validateBlockProposal', (_peerId, block) => ({
1622
- [Attributes.SLOT_NUMBER]: block.slotNumber.toString(),
1623
- }))
1624
- public async validateBlockProposal(peerId: PeerId, block: BlockProposal): Promise<P2PValidationResult> {
1625
- const result = await this.blockProposalValidator.validate(block);
1626
-
1627
- if (result.result === 'reject') {
1628
- this.logger.debug(`Penalizing peer ${peerId} for block proposal validation failure`);
1629
- this.peerManager.penalizePeer(peerId, result.severity);
1630
- }
1631
-
1632
- return result;
1633
- }
1634
-
1635
- /**
1636
- * Validate a checkpoint proposal.
1637
- *
1638
- * @param checkpoint - The checkpoint proposal to validate.
1639
- * @returns True if the checkpoint proposal is valid, false otherwise.
1640
- */
1641
- @trackSpan('Libp2pService.validateCheckpointProposal', (_peerId, checkpoint) => ({
1642
- [Attributes.SLOT_NUMBER]: checkpoint.slotNumber.toString(),
1643
- }))
1644
- public async validateCheckpointProposal(
1645
- peerId: PeerId,
1646
- checkpoint: CheckpointProposal,
1647
- ): Promise<P2PValidationResult> {
1648
- const result = await this.checkpointProposalValidator.validate(checkpoint);
1649
-
1650
- if (result.result === 'reject') {
1651
- this.logger.debug(`Penalizing peer ${peerId} for checkpoint proposal validation failure`);
1652
- this.peerManager.penalizePeer(peerId, result.severity);
1653
- }
1654
-
1655
- return result;
1656
- }
1657
-
1658
1764
  public getPeerScore(peerId: PeerId): number {
1659
1765
  return this.node.services.pubsub.score.score(peerId.toString());
1660
1766
  }