@aztec/p2p 0.0.1-commit.86469d5 → 0.0.1-commit.8655d4a

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 (549) hide show
  1. package/README.md +129 -3
  2. package/dest/bootstrap/bootstrap.d.ts +1 -1
  3. package/dest/bootstrap/bootstrap.d.ts.map +1 -1
  4. package/dest/bootstrap/bootstrap.js +9 -1
  5. package/dest/client/factory.d.ts +13 -12
  6. package/dest/client/factory.d.ts.map +1 -1
  7. package/dest/client/factory.js +61 -17
  8. package/dest/client/interface.d.ts +58 -36
  9. package/dest/client/interface.d.ts.map +1 -1
  10. package/dest/client/p2p_client.d.ts +52 -58
  11. package/dest/client/p2p_client.d.ts.map +1 -1
  12. package/dest/client/p2p_client.js +228 -235
  13. package/dest/config.d.ts +162 -89
  14. package/dest/config.d.ts.map +1 -1
  15. package/dest/config.js +153 -42
  16. package/dest/errors/p2p-service.error.d.ts +9 -0
  17. package/dest/errors/p2p-service.error.d.ts.map +1 -0
  18. package/dest/errors/p2p-service.error.js +10 -0
  19. package/dest/errors/reqresp.error.d.ts +1 -20
  20. package/dest/errors/reqresp.error.d.ts.map +1 -1
  21. package/dest/errors/reqresp.error.js +0 -21
  22. package/dest/errors/tx-pool.error.d.ts +8 -0
  23. package/dest/errors/tx-pool.error.d.ts.map +1 -0
  24. package/dest/errors/tx-pool.error.js +9 -0
  25. package/dest/index.d.ts +2 -2
  26. package/dest/index.d.ts.map +1 -1
  27. package/dest/index.js +1 -1
  28. package/dest/mem_pools/attestation_pool/attestation_pool.d.ts +162 -106
  29. package/dest/mem_pools/attestation_pool/attestation_pool.d.ts.map +1 -1
  30. package/dest/mem_pools/attestation_pool/attestation_pool.js +511 -3
  31. package/dest/mem_pools/attestation_pool/attestation_pool_test_suite.d.ts +2 -2
  32. package/dest/mem_pools/attestation_pool/attestation_pool_test_suite.d.ts.map +1 -1
  33. package/dest/mem_pools/attestation_pool/attestation_pool_test_suite.js +507 -125
  34. package/dest/mem_pools/attestation_pool/index.d.ts +2 -3
  35. package/dest/mem_pools/attestation_pool/index.d.ts.map +1 -1
  36. package/dest/mem_pools/attestation_pool/index.js +1 -2
  37. package/dest/mem_pools/attestation_pool/mocks.d.ts +2 -2
  38. package/dest/mem_pools/attestation_pool/mocks.d.ts.map +1 -1
  39. package/dest/mem_pools/attestation_pool/mocks.js +7 -5
  40. package/dest/mem_pools/index.d.ts +3 -3
  41. package/dest/mem_pools/index.d.ts.map +1 -1
  42. package/dest/mem_pools/index.js +1 -1
  43. package/dest/mem_pools/instrumentation.d.ts +4 -2
  44. package/dest/mem_pools/instrumentation.d.ts.map +1 -1
  45. package/dest/mem_pools/instrumentation.js +33 -15
  46. package/dest/mem_pools/interface.d.ts +5 -5
  47. package/dest/mem_pools/interface.d.ts.map +1 -1
  48. package/dest/mem_pools/tx_pool_v2/archive/index.d.ts +2 -0
  49. package/dest/mem_pools/tx_pool_v2/archive/index.d.ts.map +1 -0
  50. package/dest/mem_pools/tx_pool_v2/archive/index.js +1 -0
  51. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.d.ts +43 -0
  52. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.d.ts.map +1 -0
  53. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.js +103 -0
  54. package/dest/mem_pools/tx_pool_v2/deleted_pool.d.ts +104 -0
  55. package/dest/mem_pools/tx_pool_v2/deleted_pool.d.ts.map +1 -0
  56. package/dest/mem_pools/tx_pool_v2/deleted_pool.js +251 -0
  57. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.d.ts +47 -0
  58. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.d.ts.map +1 -0
  59. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.js +128 -0
  60. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.d.ts +17 -0
  61. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.d.ts.map +1 -0
  62. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.js +94 -0
  63. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.d.ts +19 -0
  64. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.d.ts.map +1 -0
  65. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.js +97 -0
  66. package/dest/mem_pools/tx_pool_v2/eviction/index.d.ts +11 -0
  67. package/dest/mem_pools/tx_pool_v2/eviction/index.d.ts.map +1 -0
  68. package/dest/mem_pools/tx_pool_v2/eviction/index.js +12 -0
  69. package/dest/mem_pools/tx_pool_v2/eviction/insufficient_fee_per_gas_eviction_rule.d.ts +16 -0
  70. package/dest/mem_pools/tx_pool_v2/eviction/insufficient_fee_per_gas_eviction_rule.d.ts.map +1 -0
  71. package/dest/mem_pools/tx_pool_v2/eviction/insufficient_fee_per_gas_eviction_rule.js +62 -0
  72. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.d.ts +180 -0
  73. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.d.ts.map +1 -0
  74. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.js +25 -0
  75. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.d.ts +15 -0
  76. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.d.ts.map +1 -0
  77. package/dest/mem_pools/{tx_pool → tx_pool_v2}/eviction/invalid_txs_after_mining_rule.js +16 -35
  78. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.d.ts +17 -0
  79. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.d.ts.map +1 -0
  80. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.js +93 -0
  81. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.d.ts +16 -0
  82. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.d.ts.map +1 -0
  83. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.js +78 -0
  84. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.d.ts +20 -0
  85. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.d.ts.map +1 -0
  86. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.js +75 -0
  87. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.d.ts +15 -0
  88. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.d.ts.map +1 -0
  89. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.js +19 -0
  90. package/dest/mem_pools/tx_pool_v2/index.d.ts +6 -0
  91. package/dest/mem_pools/tx_pool_v2/index.d.ts.map +1 -0
  92. package/dest/mem_pools/tx_pool_v2/index.js +5 -0
  93. package/dest/mem_pools/tx_pool_v2/instrumentation.d.ts +15 -0
  94. package/dest/mem_pools/tx_pool_v2/instrumentation.d.ts.map +1 -0
  95. package/dest/mem_pools/tx_pool_v2/instrumentation.js +43 -0
  96. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts +218 -0
  97. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts.map +1 -0
  98. package/dest/mem_pools/tx_pool_v2/interfaces.js +10 -0
  99. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts +137 -0
  100. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts.map +1 -0
  101. package/dest/mem_pools/tx_pool_v2/tx_metadata.js +223 -0
  102. package/dest/mem_pools/tx_pool_v2/tx_pool_bench_metrics.d.ts +26 -0
  103. package/dest/mem_pools/tx_pool_v2/tx_pool_bench_metrics.d.ts.map +1 -0
  104. package/dest/mem_pools/tx_pool_v2/tx_pool_bench_metrics.js +70 -0
  105. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.d.ts +108 -0
  106. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.d.ts.map +1 -0
  107. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.js +337 -0
  108. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts +62 -0
  109. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts.map +1 -0
  110. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.js +167 -0
  111. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts +78 -0
  112. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts.map +1 -0
  113. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.js +914 -0
  114. package/dest/msg_validators/attestation_validator/attestation_validator.d.ts +9 -3
  115. package/dest/msg_validators/attestation_validator/attestation_validator.d.ts.map +1 -1
  116. package/dest/msg_validators/attestation_validator/attestation_validator.js +37 -12
  117. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts +8 -4
  118. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts.map +1 -1
  119. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.js +4 -5
  120. package/dest/msg_validators/clock_tolerance.d.ts +12 -1
  121. package/dest/msg_validators/clock_tolerance.d.ts.map +1 -1
  122. package/dest/msg_validators/clock_tolerance.js +61 -3
  123. package/dest/msg_validators/proposal_validator/block_proposal_validator.d.ts +10 -4
  124. package/dest/msg_validators/proposal_validator/block_proposal_validator.d.ts.map +1 -1
  125. package/dest/msg_validators/proposal_validator/block_proposal_validator.js +10 -2
  126. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.d.ts +10 -4
  127. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.d.ts.map +1 -1
  128. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.js +16 -2
  129. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts +21 -8
  130. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts.map +1 -1
  131. package/dest/msg_validators/proposal_validator/proposal_validator.js +90 -44
  132. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts +4 -4
  133. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts.map +1 -1
  134. package/dest/msg_validators/tx_validator/aggregate_tx_validator.js +11 -18
  135. package/dest/msg_validators/tx_validator/allowed_public_setup.d.ts +2 -1
  136. package/dest/msg_validators/tx_validator/allowed_public_setup.d.ts.map +1 -1
  137. package/dest/msg_validators/tx_validator/allowed_public_setup.js +25 -21
  138. package/dest/msg_validators/tx_validator/allowed_setup_helpers.d.ts +17 -0
  139. package/dest/msg_validators/tx_validator/allowed_setup_helpers.d.ts.map +1 -0
  140. package/dest/msg_validators/tx_validator/allowed_setup_helpers.js +24 -0
  141. package/dest/msg_validators/tx_validator/archive_cache.js +1 -1
  142. package/dest/msg_validators/tx_validator/block_header_validator.d.ts +16 -3
  143. package/dest/msg_validators/tx_validator/block_header_validator.d.ts.map +1 -1
  144. package/dest/msg_validators/tx_validator/block_header_validator.js +1 -1
  145. package/dest/msg_validators/tx_validator/cached_tx_validator.d.ts +15 -0
  146. package/dest/msg_validators/tx_validator/cached_tx_validator.d.ts.map +1 -0
  147. package/dest/msg_validators/tx_validator/cached_tx_validator.js +19 -0
  148. package/dest/msg_validators/tx_validator/contract_instance_validator.d.ts +9 -0
  149. package/dest/msg_validators/tx_validator/contract_instance_validator.d.ts.map +1 -0
  150. package/dest/msg_validators/tx_validator/contract_instance_validator.js +48 -0
  151. package/dest/msg_validators/tx_validator/data_validator.d.ts +2 -1
  152. package/dest/msg_validators/tx_validator/data_validator.d.ts.map +1 -1
  153. package/dest/msg_validators/tx_validator/data_validator.js +36 -2
  154. package/dest/msg_validators/tx_validator/double_spend_validator.d.ts +13 -3
  155. package/dest/msg_validators/tx_validator/double_spend_validator.d.ts.map +1 -1
  156. package/dest/msg_validators/tx_validator/double_spend_validator.js +4 -4
  157. package/dest/msg_validators/tx_validator/factory.d.ts +135 -7
  158. package/dest/msg_validators/tx_validator/factory.d.ts.map +1 -1
  159. package/dest/msg_validators/tx_validator/factory.js +252 -61
  160. package/dest/msg_validators/tx_validator/fee_payer_balance.d.ts +1 -1
  161. package/dest/msg_validators/tx_validator/fee_payer_balance.d.ts.map +1 -1
  162. package/dest/msg_validators/tx_validator/fee_payer_balance.js +6 -2
  163. package/dest/msg_validators/tx_validator/gas_validator.d.ts +99 -3
  164. package/dest/msg_validators/tx_validator/gas_validator.d.ts.map +1 -1
  165. package/dest/msg_validators/tx_validator/gas_validator.js +137 -53
  166. package/dest/msg_validators/tx_validator/index.d.ts +5 -1
  167. package/dest/msg_validators/tx_validator/index.d.ts.map +1 -1
  168. package/dest/msg_validators/tx_validator/index.js +4 -0
  169. package/dest/msg_validators/tx_validator/metadata_validator.d.ts +1 -1
  170. package/dest/msg_validators/tx_validator/metadata_validator.d.ts.map +1 -1
  171. package/dest/msg_validators/tx_validator/metadata_validator.js +4 -4
  172. package/dest/msg_validators/tx_validator/nullifier_cache.d.ts +14 -0
  173. package/dest/msg_validators/tx_validator/nullifier_cache.d.ts.map +1 -0
  174. package/dest/msg_validators/tx_validator/nullifier_cache.js +24 -0
  175. package/dest/msg_validators/tx_validator/phases_validator.d.ts +22 -2
  176. package/dest/msg_validators/tx_validator/phases_validator.d.ts.map +1 -1
  177. package/dest/msg_validators/tx_validator/phases_validator.js +72 -24
  178. package/dest/msg_validators/tx_validator/timestamp_validator.d.ts +20 -4
  179. package/dest/msg_validators/tx_validator/timestamp_validator.d.ts.map +1 -1
  180. package/dest/msg_validators/tx_validator/timestamp_validator.js +6 -6
  181. package/dest/msg_validators/tx_validator/tx_proof_validator.d.ts +2 -1
  182. package/dest/msg_validators/tx_validator/tx_proof_validator.d.ts.map +1 -1
  183. package/dest/msg_validators/tx_validator/tx_proof_validator.js +2 -0
  184. package/dest/msg_validators/tx_validator/tx_validation_cache.d.ts +48 -0
  185. package/dest/msg_validators/tx_validator/tx_validation_cache.d.ts.map +1 -0
  186. package/dest/msg_validators/tx_validator/tx_validation_cache.js +69 -0
  187. package/dest/services/data_store.d.ts +1 -1
  188. package/dest/services/data_store.d.ts.map +1 -1
  189. package/dest/services/data_store.js +5 -5
  190. package/dest/services/discv5/discV5_service.d.ts +2 -1
  191. package/dest/services/discv5/discV5_service.d.ts.map +1 -1
  192. package/dest/services/discv5/discV5_service.js +35 -8
  193. package/dest/services/dummy_service.d.ts +22 -18
  194. package/dest/services/dummy_service.d.ts.map +1 -1
  195. package/dest/services/dummy_service.js +22 -20
  196. package/dest/services/encoding.d.ts +7 -3
  197. package/dest/services/encoding.d.ts.map +1 -1
  198. package/dest/services/encoding.js +18 -11
  199. package/dest/services/gossipsub/index.d.ts +3 -0
  200. package/dest/services/gossipsub/index.d.ts.map +1 -0
  201. package/dest/services/gossipsub/index.js +2 -0
  202. package/dest/services/gossipsub/scoring.d.ts +21 -3
  203. package/dest/services/gossipsub/scoring.d.ts.map +1 -1
  204. package/dest/services/gossipsub/scoring.js +24 -7
  205. package/dest/services/gossipsub/topic_score_params.d.ts +184 -0
  206. package/dest/services/gossipsub/topic_score_params.d.ts.map +1 -0
  207. package/dest/services/gossipsub/topic_score_params.js +363 -0
  208. package/dest/services/index.d.ts +2 -1
  209. package/dest/services/index.d.ts.map +1 -1
  210. package/dest/services/index.js +1 -0
  211. package/dest/services/libp2p/instrumentation.d.ts +3 -1
  212. package/dest/services/libp2p/instrumentation.d.ts.map +1 -1
  213. package/dest/services/libp2p/instrumentation.js +14 -0
  214. package/dest/services/libp2p/libp2p_service.d.ts +102 -60
  215. package/dest/services/libp2p/libp2p_service.d.ts.map +1 -1
  216. package/dest/services/libp2p/libp2p_service.js +665 -530
  217. package/dest/services/peer-manager/metrics.d.ts +3 -1
  218. package/dest/services/peer-manager/metrics.d.ts.map +1 -1
  219. package/dest/services/peer-manager/metrics.js +6 -0
  220. package/dest/services/peer-manager/peer_manager.d.ts +6 -2
  221. package/dest/services/peer-manager/peer_manager.d.ts.map +1 -1
  222. package/dest/services/peer-manager/peer_manager.js +40 -11
  223. package/dest/services/peer-manager/peer_scoring.d.ts +7 -2
  224. package/dest/services/peer-manager/peer_scoring.d.ts.map +1 -1
  225. package/dest/services/peer-manager/peer_scoring.js +57 -12
  226. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts +14 -10
  227. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts.map +1 -1
  228. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.js +104 -118
  229. package/dest/services/reqresp/batch-tx-requester/interface.d.ts +11 -11
  230. package/dest/services/reqresp/batch-tx-requester/interface.d.ts.map +1 -1
  231. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts +11 -13
  232. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts.map +1 -1
  233. package/dest/services/reqresp/batch-tx-requester/missing_txs.js +31 -46
  234. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts +19 -11
  235. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts.map +1 -1
  236. package/dest/services/reqresp/batch-tx-requester/peer_collection.js +52 -15
  237. package/dest/services/reqresp/batch-tx-requester/tx_validator.d.ts +5 -14
  238. package/dest/services/reqresp/batch-tx-requester/tx_validator.d.ts.map +1 -1
  239. package/dest/services/reqresp/batch-tx-requester/tx_validator.js +6 -20
  240. package/dest/services/reqresp/config.d.ts +3 -3
  241. package/dest/services/reqresp/config.d.ts.map +1 -1
  242. package/dest/services/reqresp/interface.d.ts +25 -18
  243. package/dest/services/reqresp/interface.d.ts.map +1 -1
  244. package/dest/services/reqresp/interface.js +23 -19
  245. package/dest/services/reqresp/metrics.d.ts +1 -1
  246. package/dest/services/reqresp/metrics.d.ts.map +1 -1
  247. package/dest/services/reqresp/metrics.js +0 -1
  248. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts +7 -5
  249. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts.map +1 -1
  250. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.js +18 -11
  251. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts +21 -10
  252. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts.map +1 -1
  253. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.js +27 -11
  254. package/dest/services/reqresp/protocols/index.d.ts +1 -2
  255. package/dest/services/reqresp/protocols/index.d.ts.map +1 -1
  256. package/dest/services/reqresp/protocols/index.js +0 -1
  257. package/dest/services/reqresp/protocols/tx.d.ts +7 -1
  258. package/dest/services/reqresp/protocols/tx.d.ts.map +1 -1
  259. package/dest/services/reqresp/protocols/tx.js +21 -3
  260. package/dest/services/reqresp/rate-limiter/rate_limiter.d.ts +5 -4
  261. package/dest/services/reqresp/rate-limiter/rate_limiter.d.ts.map +1 -1
  262. package/dest/services/reqresp/rate-limiter/rate_limiter.js +10 -8
  263. package/dest/services/reqresp/rate-limiter/rate_limits.d.ts +1 -1
  264. package/dest/services/reqresp/rate-limiter/rate_limits.d.ts.map +1 -1
  265. package/dest/services/reqresp/rate-limiter/rate_limits.js +0 -10
  266. package/dest/services/reqresp/reqresp.d.ts +7 -29
  267. package/dest/services/reqresp/reqresp.d.ts.map +1 -1
  268. package/dest/services/reqresp/reqresp.js +53 -218
  269. package/dest/services/service.d.ts +46 -13
  270. package/dest/services/service.d.ts.map +1 -1
  271. package/dest/services/tx_collection/config.d.ts +11 -14
  272. package/dest/services/tx_collection/config.d.ts.map +1 -1
  273. package/dest/services/tx_collection/config.js +26 -33
  274. package/dest/services/tx_collection/file_store_tx_collection.d.ts +37 -0
  275. package/dest/services/tx_collection/file_store_tx_collection.d.ts.map +1 -0
  276. package/dest/services/tx_collection/file_store_tx_collection.js +127 -0
  277. package/dest/services/tx_collection/file_store_tx_source.d.ts +38 -0
  278. package/dest/services/tx_collection/file_store_tx_source.d.ts.map +1 -0
  279. package/dest/services/tx_collection/file_store_tx_source.js +100 -0
  280. package/dest/services/tx_collection/index.d.ts +3 -3
  281. package/dest/services/tx_collection/index.d.ts.map +1 -1
  282. package/dest/services/tx_collection/index.js +1 -1
  283. package/dest/services/tx_collection/instrumentation.js +1 -2
  284. package/dest/services/tx_collection/request_tracker.d.ts +53 -0
  285. package/dest/services/tx_collection/request_tracker.d.ts.map +1 -0
  286. package/dest/services/tx_collection/request_tracker.js +84 -0
  287. package/dest/services/tx_collection/tx_collection.d.ts +45 -51
  288. package/dest/services/tx_collection/tx_collection.d.ts.map +1 -1
  289. package/dest/services/tx_collection/tx_collection.js +296 -68
  290. package/dest/services/tx_collection/tx_collection_sink.d.ts +19 -9
  291. package/dest/services/tx_collection/tx_collection_sink.d.ts.map +1 -1
  292. package/dest/services/tx_collection/tx_collection_sink.js +28 -31
  293. package/dest/services/tx_collection/tx_source.d.ts +13 -7
  294. package/dest/services/tx_collection/tx_source.d.ts.map +1 -1
  295. package/dest/services/tx_collection/tx_source.js +26 -7
  296. package/dest/services/tx_file_store/config.d.ts +16 -0
  297. package/dest/services/tx_file_store/config.d.ts.map +1 -0
  298. package/dest/services/tx_file_store/config.js +22 -0
  299. package/dest/services/tx_file_store/index.d.ts +4 -0
  300. package/dest/services/tx_file_store/index.d.ts.map +1 -0
  301. package/dest/services/tx_file_store/index.js +3 -0
  302. package/dest/services/tx_file_store/instrumentation.d.ts +15 -0
  303. package/dest/services/tx_file_store/instrumentation.d.ts.map +1 -0
  304. package/dest/services/tx_file_store/instrumentation.js +29 -0
  305. package/dest/services/tx_file_store/tx_file_store.d.ts +46 -0
  306. package/dest/services/tx_file_store/tx_file_store.d.ts.map +1 -0
  307. package/dest/services/tx_file_store/tx_file_store.js +142 -0
  308. package/dest/services/tx_provider.d.ts +6 -4
  309. package/dest/services/tx_provider.d.ts.map +1 -1
  310. package/dest/services/tx_provider.js +12 -8
  311. package/dest/test-helpers/make-test-p2p-clients.d.ts +7 -8
  312. package/dest/test-helpers/make-test-p2p-clients.d.ts.map +1 -1
  313. package/dest/test-helpers/make-test-p2p-clients.js +5 -3
  314. package/dest/test-helpers/mock-pubsub.d.ts +46 -6
  315. package/dest/test-helpers/mock-pubsub.d.ts.map +1 -1
  316. package/dest/test-helpers/mock-pubsub.js +115 -14
  317. package/dest/test-helpers/reqresp-nodes.d.ts +5 -7
  318. package/dest/test-helpers/reqresp-nodes.d.ts.map +1 -1
  319. package/dest/test-helpers/reqresp-nodes.js +19 -20
  320. package/dest/test-helpers/test_tx_provider.d.ts +3 -1
  321. package/dest/test-helpers/test_tx_provider.d.ts.map +1 -1
  322. package/dest/test-helpers/test_tx_provider.js +3 -0
  323. package/dest/test-helpers/testbench-utils.d.ts +53 -50
  324. package/dest/test-helpers/testbench-utils.d.ts.map +1 -1
  325. package/dest/test-helpers/testbench-utils.js +171 -75
  326. package/dest/testbench/p2p_client_testbench_worker.d.ts +3 -5
  327. package/dest/testbench/p2p_client_testbench_worker.d.ts.map +1 -1
  328. package/dest/testbench/p2p_client_testbench_worker.js +94 -48
  329. package/dest/testbench/worker_client_manager.d.ts +12 -6
  330. package/dest/testbench/worker_client_manager.d.ts.map +1 -1
  331. package/dest/testbench/worker_client_manager.js +57 -11
  332. package/dest/util.d.ts +13 -8
  333. package/dest/util.d.ts.map +1 -1
  334. package/dest/util.js +35 -14
  335. package/dest/versioning.d.ts +3 -6
  336. package/dest/versioning.d.ts.map +1 -1
  337. package/dest/versioning.js +3 -24
  338. package/package.json +15 -14
  339. package/src/bootstrap/bootstrap.ts +9 -1
  340. package/src/client/factory.ts +130 -30
  341. package/src/client/interface.ts +70 -44
  342. package/src/client/p2p_client.ts +273 -299
  343. package/src/client/test/{tx_proposal_collector/README.md → p2p_client.batch_tx_requester.bench.README.md} +23 -53
  344. package/src/config.ts +267 -46
  345. package/src/errors/p2p-service.error.ts +11 -0
  346. package/src/errors/reqresp.error.ts +0 -25
  347. package/src/errors/tx-pool.error.ts +12 -0
  348. package/src/index.ts +1 -1
  349. package/src/mem_pools/attestation_pool/attestation_pool.ts +575 -94
  350. package/src/mem_pools/attestation_pool/attestation_pool_test_suite.ts +617 -141
  351. package/src/mem_pools/attestation_pool/index.ts +9 -2
  352. package/src/mem_pools/attestation_pool/mocks.ts +14 -8
  353. package/src/mem_pools/index.ts +2 -2
  354. package/src/mem_pools/instrumentation.ts +22 -14
  355. package/src/mem_pools/interface.ts +4 -4
  356. package/src/mem_pools/tx_pool_v2/README.md +283 -0
  357. package/src/mem_pools/tx_pool_v2/archive/index.ts +1 -0
  358. package/src/mem_pools/tx_pool_v2/archive/tx_archive.ts +120 -0
  359. package/src/mem_pools/tx_pool_v2/deleted_pool.ts +321 -0
  360. package/src/mem_pools/tx_pool_v2/eviction/eviction_manager.ts +160 -0
  361. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.ts +122 -0
  362. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.ts +125 -0
  363. package/src/mem_pools/tx_pool_v2/eviction/index.ts +28 -0
  364. package/src/mem_pools/tx_pool_v2/eviction/insufficient_fee_per_gas_eviction_rule.ts +65 -0
  365. package/src/mem_pools/tx_pool_v2/eviction/interfaces.ts +219 -0
  366. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.ts +74 -0
  367. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.ts +101 -0
  368. package/src/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.ts +91 -0
  369. package/src/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.ts +99 -0
  370. package/src/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.ts +32 -0
  371. package/src/mem_pools/tx_pool_v2/index.ts +12 -0
  372. package/src/mem_pools/tx_pool_v2/instrumentation.ts +69 -0
  373. package/src/mem_pools/tx_pool_v2/interfaces.ts +250 -0
  374. package/src/mem_pools/tx_pool_v2/tx_metadata.ts +349 -0
  375. package/src/mem_pools/tx_pool_v2/tx_pool_bench_metrics.ts +77 -0
  376. package/src/mem_pools/tx_pool_v2/tx_pool_indices.ts +430 -0
  377. package/src/mem_pools/tx_pool_v2/tx_pool_v2.ts +238 -0
  378. package/src/mem_pools/tx_pool_v2/tx_pool_v2_impl.ts +1090 -0
  379. package/src/msg_validators/attestation_validator/README.md +49 -0
  380. package/src/msg_validators/attestation_validator/attestation_validator.ts +41 -9
  381. package/src/msg_validators/attestation_validator/fisherman_attestation_validator.ts +16 -9
  382. package/src/msg_validators/clock_tolerance.ts +79 -3
  383. package/src/msg_validators/proposal_validator/README.md +123 -0
  384. package/src/msg_validators/proposal_validator/block_proposal_validator.ts +24 -4
  385. package/src/msg_validators/proposal_validator/checkpoint_proposal_validator.ts +35 -7
  386. package/src/msg_validators/proposal_validator/proposal_validator.ts +114 -47
  387. package/src/msg_validators/tx_validator/README.md +127 -0
  388. package/src/msg_validators/tx_validator/aggregate_tx_validator.ts +8 -17
  389. package/src/msg_validators/tx_validator/allowed_public_setup.ts +22 -27
  390. package/src/msg_validators/tx_validator/allowed_setup_helpers.ts +31 -0
  391. package/src/msg_validators/tx_validator/archive_cache.ts +1 -1
  392. package/src/msg_validators/tx_validator/block_header_validator.ts +15 -3
  393. package/src/msg_validators/tx_validator/cached_tx_validator.ts +31 -0
  394. package/src/msg_validators/tx_validator/contract_instance_validator.ts +56 -0
  395. package/src/msg_validators/tx_validator/data_validator.ts +44 -1
  396. package/src/msg_validators/tx_validator/double_spend_validator.ts +11 -6
  397. package/src/msg_validators/tx_validator/factory.ts +407 -80
  398. package/src/msg_validators/tx_validator/fee_payer_balance.ts +6 -2
  399. package/src/msg_validators/tx_validator/gas_validator.ts +199 -54
  400. package/src/msg_validators/tx_validator/index.ts +4 -0
  401. package/src/msg_validators/tx_validator/metadata_validator.ts +12 -4
  402. package/src/msg_validators/tx_validator/nullifier_cache.ts +30 -0
  403. package/src/msg_validators/tx_validator/phases_validator.ts +82 -27
  404. package/src/msg_validators/tx_validator/timestamp_validator.ts +23 -18
  405. package/src/msg_validators/tx_validator/tx_proof_validator.ts +2 -0
  406. package/src/msg_validators/tx_validator/tx_validation_cache.ts +102 -0
  407. package/src/services/data_store.ts +5 -13
  408. package/src/services/discv5/discV5_service.ts +38 -5
  409. package/src/services/dummy_service.ts +32 -45
  410. package/src/services/encoding.ts +18 -10
  411. package/src/services/gossipsub/README.md +641 -0
  412. package/src/services/gossipsub/index.ts +2 -0
  413. package/src/services/gossipsub/scoring.ts +29 -5
  414. package/src/services/gossipsub/topic_score_params.ts +519 -0
  415. package/src/services/index.ts +1 -0
  416. package/src/services/libp2p/instrumentation.ts +14 -0
  417. package/src/services/libp2p/libp2p_service.ts +716 -586
  418. package/src/services/peer-manager/metrics.ts +7 -0
  419. package/src/services/peer-manager/peer_manager.ts +46 -11
  420. package/src/services/peer-manager/peer_scoring.ts +52 -5
  421. package/src/services/reqresp/README.md +215 -0
  422. package/src/services/reqresp/batch-tx-requester/README.md +53 -14
  423. package/src/services/reqresp/batch-tx-requester/batch_tx_requester.ts +108 -130
  424. package/src/services/reqresp/batch-tx-requester/interface.ts +14 -10
  425. package/src/services/reqresp/batch-tx-requester/missing_txs.ts +30 -71
  426. package/src/services/reqresp/batch-tx-requester/peer_collection.ts +68 -24
  427. package/src/services/reqresp/batch-tx-requester/tx_validator.ts +12 -25
  428. package/src/services/reqresp/config.ts +2 -2
  429. package/src/services/reqresp/interface.ts +45 -46
  430. package/src/services/reqresp/metrics.ts +0 -1
  431. package/src/services/reqresp/protocols/block_txs/block_txs_handler.ts +25 -14
  432. package/src/services/reqresp/protocols/block_txs/block_txs_reqresp.ts +38 -15
  433. package/src/services/reqresp/protocols/index.ts +0 -1
  434. package/src/services/reqresp/protocols/tx.ts +23 -3
  435. package/src/services/reqresp/rate-limiter/rate_limiter.ts +13 -9
  436. package/src/services/reqresp/rate-limiter/rate_limits.ts +0 -10
  437. package/src/services/reqresp/reqresp.ts +61 -264
  438. package/src/services/service.ts +62 -29
  439. package/src/services/tx_collection/config.ts +40 -49
  440. package/src/services/tx_collection/file_store_tx_collection.ts +153 -0
  441. package/src/services/tx_collection/file_store_tx_source.ts +129 -0
  442. package/src/services/tx_collection/index.ts +2 -6
  443. package/src/services/tx_collection/instrumentation.ts +1 -1
  444. package/src/services/tx_collection/request_tracker.ts +127 -0
  445. package/src/services/tx_collection/tx_collection.ts +362 -110
  446. package/src/services/tx_collection/tx_collection_sink.ts +32 -36
  447. package/src/services/tx_collection/tx_source.ts +28 -8
  448. package/src/services/tx_file_store/config.ts +37 -0
  449. package/src/services/tx_file_store/index.ts +3 -0
  450. package/src/services/tx_file_store/instrumentation.ts +36 -0
  451. package/src/services/tx_file_store/tx_file_store.ts +163 -0
  452. package/src/services/tx_provider.ts +15 -9
  453. package/src/test-helpers/make-test-p2p-clients.ts +7 -6
  454. package/src/test-helpers/mock-pubsub.ts +137 -14
  455. package/src/test-helpers/reqresp-nodes.ts +17 -29
  456. package/src/test-helpers/test_tx_provider.ts +5 -0
  457. package/src/test-helpers/testbench-utils.ts +177 -96
  458. package/src/testbench/p2p_client_testbench_worker.ts +100 -63
  459. package/src/testbench/worker_client_manager.ts +72 -25
  460. package/src/util.ts +40 -19
  461. package/src/versioning.ts +3 -33
  462. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker.d.ts +0 -2
  463. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker.d.ts.map +0 -1
  464. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker.js +0 -305
  465. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.d.ts +0 -73
  466. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.d.ts.map +0 -1
  467. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.js +0 -8
  468. package/dest/mem_pools/attestation_pool/kv_attestation_pool.d.ts +0 -40
  469. package/dest/mem_pools/attestation_pool/kv_attestation_pool.d.ts.map +0 -1
  470. package/dest/mem_pools/attestation_pool/kv_attestation_pool.js +0 -218
  471. package/dest/mem_pools/attestation_pool/memory_attestation_pool.d.ts +0 -31
  472. package/dest/mem_pools/attestation_pool/memory_attestation_pool.d.ts.map +0 -1
  473. package/dest/mem_pools/attestation_pool/memory_attestation_pool.js +0 -180
  474. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.d.ts +0 -125
  475. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.d.ts.map +0 -1
  476. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.js +0 -596
  477. package/dest/mem_pools/tx_pool/eviction/eviction_manager.d.ts +0 -32
  478. package/dest/mem_pools/tx_pool/eviction/eviction_manager.d.ts.map +0 -1
  479. package/dest/mem_pools/tx_pool/eviction/eviction_manager.js +0 -112
  480. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.d.ts +0 -157
  481. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.d.ts.map +0 -1
  482. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.js +0 -52
  483. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.d.ts +0 -16
  484. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.d.ts.map +0 -1
  485. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.js +0 -122
  486. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.d.ts +0 -17
  487. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.d.ts.map +0 -1
  488. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.d.ts +0 -19
  489. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.d.ts.map +0 -1
  490. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.js +0 -78
  491. package/dest/mem_pools/tx_pool/eviction/low_priority_eviction_rule.d.ts +0 -26
  492. package/dest/mem_pools/tx_pool/eviction/low_priority_eviction_rule.d.ts.map +0 -1
  493. package/dest/mem_pools/tx_pool/eviction/low_priority_eviction_rule.js +0 -84
  494. package/dest/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.d.ts +0 -25
  495. package/dest/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.d.ts.map +0 -1
  496. package/dest/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.js +0 -57
  497. package/dest/mem_pools/tx_pool/index.d.ts +0 -3
  498. package/dest/mem_pools/tx_pool/index.d.ts.map +0 -1
  499. package/dest/mem_pools/tx_pool/index.js +0 -2
  500. package/dest/mem_pools/tx_pool/priority.d.ts +0 -12
  501. package/dest/mem_pools/tx_pool/priority.d.ts.map +0 -1
  502. package/dest/mem_pools/tx_pool/priority.js +0 -15
  503. package/dest/mem_pools/tx_pool/tx_pool.d.ts +0 -127
  504. package/dest/mem_pools/tx_pool/tx_pool.d.ts.map +0 -1
  505. package/dest/mem_pools/tx_pool/tx_pool.js +0 -3
  506. package/dest/mem_pools/tx_pool/tx_pool_test_suite.d.ts +0 -7
  507. package/dest/mem_pools/tx_pool/tx_pool_test_suite.d.ts.map +0 -1
  508. package/dest/mem_pools/tx_pool/tx_pool_test_suite.js +0 -400
  509. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.d.ts +0 -23
  510. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.d.ts.map +0 -1
  511. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.js +0 -212
  512. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.d.ts +0 -64
  513. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.d.ts.map +0 -1
  514. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.js +0 -151
  515. package/dest/services/reqresp/protocols/block.d.ts +0 -9
  516. package/dest/services/reqresp/protocols/block.d.ts.map +0 -1
  517. package/dest/services/reqresp/protocols/block.js +0 -32
  518. package/dest/services/tx_collection/fast_tx_collection.d.ts +0 -53
  519. package/dest/services/tx_collection/fast_tx_collection.d.ts.map +0 -1
  520. package/dest/services/tx_collection/fast_tx_collection.js +0 -311
  521. package/dest/services/tx_collection/proposal_tx_collector.d.ts +0 -48
  522. package/dest/services/tx_collection/proposal_tx_collector.d.ts.map +0 -1
  523. package/dest/services/tx_collection/proposal_tx_collector.js +0 -50
  524. package/dest/services/tx_collection/slow_tx_collection.d.ts +0 -53
  525. package/dest/services/tx_collection/slow_tx_collection.d.ts.map +0 -1
  526. package/dest/services/tx_collection/slow_tx_collection.js +0 -177
  527. package/src/client/test/tx_proposal_collector/proposal_tx_collector_worker.ts +0 -336
  528. package/src/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.ts +0 -43
  529. package/src/mem_pools/attestation_pool/kv_attestation_pool.ts +0 -320
  530. package/src/mem_pools/attestation_pool/memory_attestation_pool.ts +0 -264
  531. package/src/mem_pools/tx_pool/README.md +0 -270
  532. package/src/mem_pools/tx_pool/aztec_kv_tx_pool.ts +0 -746
  533. package/src/mem_pools/tx_pool/eviction/eviction_manager.ts +0 -132
  534. package/src/mem_pools/tx_pool/eviction/eviction_strategy.ts +0 -208
  535. package/src/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.ts +0 -162
  536. package/src/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.ts +0 -104
  537. package/src/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.ts +0 -93
  538. package/src/mem_pools/tx_pool/eviction/low_priority_eviction_rule.ts +0 -106
  539. package/src/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.ts +0 -75
  540. package/src/mem_pools/tx_pool/index.ts +0 -2
  541. package/src/mem_pools/tx_pool/priority.ts +0 -20
  542. package/src/mem_pools/tx_pool/tx_pool.ts +0 -141
  543. package/src/mem_pools/tx_pool/tx_pool_test_suite.ts +0 -319
  544. package/src/msg_validators/proposal_validator/proposal_validator_test_suite.ts +0 -230
  545. package/src/services/reqresp/connection-sampler/batch_connection_sampler.ts +0 -161
  546. package/src/services/reqresp/protocols/block.ts +0 -37
  547. package/src/services/tx_collection/fast_tx_collection.ts +0 -364
  548. package/src/services/tx_collection/proposal_tx_collector.ts +0 -114
  549. package/src/services/tx_collection/slow_tx_collection.ts +0 -233
@@ -1,15 +1,14 @@
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, merge } 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
- import { GasFees } from '@aztec/stdlib/gas';
11
+ import { type BlockMinFeesProvider, GasFees } from '@aztec/stdlib/gas';
13
12
  import type { ClientProtocolCircuitVerifier, PeerInfo, WorldStateSynchronizer } from '@aztec/stdlib/interfaces/server';
14
13
  import {
15
14
  BlockProposal,
@@ -17,17 +16,16 @@ 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';
30
- import { Tx, type TxHash, type TxValidationResult, type TxValidator } from '@aztec/stdlib/tx';
28
+ import { Tx, type TxValidationResult } from '@aztec/stdlib/tx';
31
29
  import type { UInt64 } from '@aztec/stdlib/types';
32
30
  import { compressComponentVersions } from '@aztec/stdlib/versioning';
33
31
  import {
@@ -45,75 +43,75 @@ 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';
52
50
  import { bootstrap } from '@libp2p/bootstrap';
53
51
  import { identify } from '@libp2p/identify';
54
52
  import { type Message, type MultiaddrConnection, type PeerId, TopicValidatorResult } from '@libp2p/interface';
55
- import type { ConnectionManager } from '@libp2p/interface-internal';
53
+ import type { AddressManager, ConnectionManager } from '@libp2p/interface-internal';
56
54
  import { mplex } from '@libp2p/mplex';
57
55
  import { tcp } from '@libp2p/tcp';
56
+ import { multiaddr } from '@multiformats/multiaddr';
58
57
  import { ENR } from '@nethermindeth/enr';
59
58
  import { createLibp2p } from 'libp2p';
60
59
 
61
60
  import type { P2PConfig } from '../../config.js';
62
- import { ProposalSlotCapExceededError } from '../../errors/attestation-pool.error.js';
61
+ import { CheckpointProposalReceivedCallbackNotRegisteredError } from '../../errors/p2p-service.error.js';
63
62
  import type { MemPools } from '../../mem_pools/interface.js';
64
63
  import {
65
64
  BlockProposalValidator,
66
65
  CheckpointAttestationValidator,
67
66
  CheckpointProposalValidator,
67
+ DoubleSpendTxValidator,
68
68
  FishermanAttestationValidator,
69
+ getDefaultAllowedSetupFunctions,
69
70
  } from '../../msg_validators/index.js';
70
71
  import { MessageSeenValidator } from '../../msg_validators/msg_seen_validator/msg_seen_validator.js';
71
- import { getDefaultAllowedSetupFunctions } from '../../msg_validators/tx_validator/allowed_public_setup.js';
72
72
  import {
73
- type MessageValidator,
74
- createTxMessageValidators,
75
- createTxReqRespValidator,
73
+ type TransactionValidator,
74
+ createFirstStageTxValidationsForGossipedTransactions,
75
+ createSecondStageTxValidationsForGossipedTransactions,
76
+ createTxValidatorForBlockProposalReceivedTxs,
76
77
  } from '../../msg_validators/tx_validator/factory.js';
77
- import { DoubleSpendTxValidator } from '../../msg_validators/tx_validator/index.js';
78
+ import { TxValidationCache } from '../../msg_validators/tx_validator/tx_validation_cache.js';
78
79
  import { GossipSubEvent } from '../../types/index.js';
79
80
  import { type PubSubLibp2p, convertToMultiaddr } from '../../util.js';
80
81
  import { getVersions } from '../../versioning.js';
81
82
  import { AztecDatastore } from '../data_store.js';
82
83
  import { DiscV5Service } from '../discv5/discV5_service.js';
83
84
  import { SnappyTransform, fastMsgIdFn, getMsgIdFn, msgIdToStrFn } from '../encoding.js';
84
- import { gossipScoreThresholds } from '../gossipsub/scoring.js';
85
+ import { APP_SPECIFIC_WEIGHT, gossipScoreThresholds } from '../gossipsub/scoring.js';
86
+ import { createAllTopicScoreParams } from '../gossipsub/topic_score_params.js';
85
87
  import type { PeerManagerInterface } from '../peer-manager/interface.js';
86
88
  import { PeerManager } from '../peer-manager/peer_manager.js';
87
89
  import { PeerScoring } from '../peer-manager/peer_scoring.js';
88
90
  import type { BatchTxRequesterLibP2PService } from '../reqresp/batch-tx-requester/interface.js';
89
91
  import type { P2PReqRespConfig } from '../reqresp/config.js';
90
92
  import {
91
- DEFAULT_SUB_PROTOCOL_VALIDATORS,
93
+ AuthRequest,
94
+ BlockTxsRequest,
95
+ BlockTxsResponse,
92
96
  type ReqRespInterface,
93
97
  type ReqRespResponse,
94
98
  ReqRespSubProtocol,
95
99
  type ReqRespSubProtocolHandler,
96
100
  type ReqRespSubProtocolHandlers,
97
- type ReqRespSubProtocolValidators,
98
- type SubProtocolMap,
99
- ValidationError,
100
- } from '../reqresp/interface.js';
101
- import { reqRespBlockTxsHandler } from '../reqresp/protocols/block_txs/block_txs_handler.js';
102
- import { reqGoodbyeHandler } from '../reqresp/protocols/goodbye.js';
103
- import {
104
- AuthRequest,
105
- BlockTxsRequest,
106
- BlockTxsResponse,
107
101
  StatusMessage,
102
+ ValidationError,
108
103
  pingHandler,
109
- reqRespBlockHandler,
104
+ reqGoodbyeHandler,
105
+ reqRespBlockTxsHandler,
110
106
  reqRespStatusHandler,
111
107
  reqRespTxHandler,
112
- } from '../reqresp/protocols/index.js';
108
+ } from '../reqresp/index.js';
113
109
  import { ReqResp } from '../reqresp/reqresp.js';
114
110
  import type {
115
111
  P2PBlockReceivedCallback,
112
+ P2PCheckpointAttestationCallback,
116
113
  P2PCheckpointReceivedCallback,
114
+ P2PDuplicateAttestationCallback,
117
115
  P2PService,
118
116
  PeerDiscoveryService,
119
117
  } from '../service.js';
@@ -128,14 +126,14 @@ interface ValidationResult {
128
126
  type ValidationOutcome = { allPassed: true } | { allPassed: false; failure: ValidationResult };
129
127
 
130
128
  // REFACTOR: Unify with the type above
131
- type ReceivedMessageValidationResult<T> =
132
- | { obj: T; result: Exclude<TopicValidatorResult, TopicValidatorResult.Reject> }
133
- | { obj?: undefined; result: TopicValidatorResult.Reject };
129
+ type ReceivedMessageValidationResult<T, M = undefined> =
130
+ | { obj: T; result: Exclude<TopicValidatorResult, TopicValidatorResult.Reject>; metadata?: M }
131
+ | { obj?: T; result: TopicValidatorResult.Reject; metadata?: M; severity: PeerErrorSeverity };
134
132
 
135
133
  /**
136
134
  * Lib P2P implementation of the P2PService interface.
137
135
  */
138
- export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends WithTracer implements P2PService {
136
+ export class LibP2PService extends WithTracer implements P2PService {
139
137
  private discoveryRunningPromise?: RunningPromise;
140
138
  private msgIdSeenValidators: Record<TopicType, MessageSeenValidator> = {} as Record<TopicType, MessageSeenValidator>;
141
139
 
@@ -147,7 +145,18 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
147
145
  private protocolVersion = '';
148
146
  private topicStrings: Record<TopicType, string> = {} as Record<TopicType, string>;
149
147
 
150
- private feesCache: { blockNumber: BlockNumber; gasFees: GasFees } | undefined;
148
+ /** Callback invoked when a duplicate proposal is detected (triggers slashing). */
149
+ private duplicateProposalCallback?: (info: {
150
+ slot: SlotNumber;
151
+ proposer: EthAddress;
152
+ type: 'checkpoint' | 'block';
153
+ }) => void;
154
+
155
+ /** Callback invoked when a duplicate attestation is detected (triggers slashing). */
156
+ private duplicateAttestationCallback?: P2PDuplicateAttestationCallback;
157
+
158
+ /** Callback invoked when a valid checkpoint attestation is accepted into the pool. */
159
+ private checkpointAttestationCallback?: P2PCheckpointAttestationCallback;
151
160
 
152
161
  /**
153
162
  * Callback for when a block is received from a peer.
@@ -161,10 +170,19 @@ 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
 
183
+ private ipChangedHandler?: (ip: string) => void;
184
+ private discoveredP2pIp?: string;
185
+
168
186
  private instrumentation: P2PInstrumentation;
169
187
 
170
188
  private telemetry: TelemetryClient;
@@ -172,19 +190,20 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
172
190
  protected logger: Logger;
173
191
 
174
192
  constructor(
175
- private clientType: T,
176
193
  private config: P2PConfig,
177
194
  protected node: PubSubLibp2p,
178
195
  private peerDiscoveryService: PeerDiscoveryService,
179
196
  private reqresp: ReqRespInterface,
180
- private peerManager: PeerManagerInterface,
197
+ protected peerManager: PeerManagerInterface,
181
198
  protected mempools: MemPools,
182
- private archiver: L2BlockSource & ContractDataSource,
199
+ protected archiver: L2BlockSource & ContractDataSource,
183
200
  private epochCache: EpochCacheInterface,
184
201
  private proofVerifier: ClientProtocolCircuitVerifier,
185
202
  private worldStateSynchronizer: WorldStateSynchronizer,
203
+ private blockMinFeesProvider: BlockMinFeesProvider,
186
204
  telemetry: TelemetryClient,
187
205
  logger: Logger = createLogger('p2p:libp2p_service'),
206
+ private txValidationCache?: TxValidationCache,
188
207
  ) {
189
208
  super(telemetry, 'LibP2PService');
190
209
  this.telemetry = telemetry;
@@ -214,36 +233,55 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
214
233
  this.protocolVersion,
215
234
  );
216
235
 
217
- this.blockProposalValidator = new BlockProposalValidator(epochCache, { txsPermitted: !config.disableTransactions });
218
- this.checkpointProposalValidator = new CheckpointProposalValidator(epochCache, {
236
+ const p2pPropagationTime = config.attestationPropagationTime;
237
+ const proposalValidatorOpts = {
219
238
  txsPermitted: !config.disableTransactions,
220
- });
239
+ maxTxsPerBlock: config.validateMaxTxsPerBlock ?? config.validateMaxTxsPerCheckpoint,
240
+ maxBlocksPerCheckpoint: config.maxBlocksPerCheckpoint,
241
+ p2pPropagationTime,
242
+ skipSlotValidation: config.skipProposalSlotValidation,
243
+ signatureContext: {
244
+ chainId: config.l1ChainId,
245
+ rollupAddress: config.rollupAddress,
246
+ },
247
+ };
248
+ this.blockProposalValidator = new BlockProposalValidator(epochCache, proposalValidatorOpts);
249
+ this.checkpointProposalValidator = new CheckpointProposalValidator(epochCache, proposalValidatorOpts);
250
+ const attestationValidatorOpts = {
251
+ l1PublishingTime: config.l1PublishingTime,
252
+ p2pPropagationTime,
253
+ signatureContext: proposalValidatorOpts.signatureContext,
254
+ };
221
255
  this.checkpointAttestationValidator = config.fishermanMode
222
- ? new FishermanAttestationValidator(epochCache, mempools.attestationPool, telemetry)
223
- : new CheckpointAttestationValidator(epochCache);
256
+ ? new FishermanAttestationValidator(epochCache, mempools.attestationPool, telemetry, attestationValidatorOpts)
257
+ : new CheckpointAttestationValidator(epochCache, attestationValidatorOpts);
224
258
 
225
259
  this.gossipSubEventHandler = this.handleGossipSubEvent.bind(this);
226
260
 
227
261
  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.`,
262
+ this.logger.warn(
263
+ `Handler for block received not yet registered on P2P service. Received block ${block.blockNumber} for slot ${block.slotNumber} from peer.`,
230
264
  { p2pMessageIdentifier: await block.p2pMessageLoggingIdentifier() },
231
265
  );
232
- return false;
266
+ return true;
233
267
  };
234
268
 
235
- this.checkpointReceivedCallback = (
236
- checkpoint: CheckpointProposalCore,
269
+ this.allNodesCheckpointReceivedCallback = (
270
+ _checkpoint: CheckpointProposalCore,
271
+ ): Promise<CheckpointAttestation[] | undefined> => {
272
+ throw new CheckpointProposalReceivedCallbackNotRegisteredError();
273
+ };
274
+
275
+ this.validatorCheckpointReceivedCallback = (
276
+ _checkpoint: CheckpointProposalCore,
237
277
  ): 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
278
  return Promise.resolve(undefined);
242
279
  };
243
280
  }
244
281
 
245
- public updateConfig(config: Partial<P2PReqRespConfig>) {
282
+ public updateConfig(config: Partial<P2PReqRespConfig & Pick<P2PConfig, 'skipIncomingProposals'>>) {
246
283
  this.reqresp.updateConfig(config);
284
+ this.config = merge(this.config, config);
247
285
  }
248
286
 
249
287
  /**
@@ -252,8 +290,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
252
290
  * @param txPool - The transaction pool to be accessed by the service.
253
291
  * @returns The new service.
254
292
  */
255
- public static async new<T extends P2PClientType>(
256
- clientType: T,
293
+ public static async new(
257
294
  config: P2PConfig,
258
295
  peerId: PeerId,
259
296
  deps: {
@@ -263,9 +300,11 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
263
300
  proofVerifier: ClientProtocolCircuitVerifier;
264
301
  worldStateSynchronizer: WorldStateSynchronizer;
265
302
  peerStore: AztecAsyncKVStore;
303
+ blockMinFeesProvider: BlockMinFeesProvider;
266
304
  telemetry: TelemetryClient;
267
305
  logger: Logger;
268
306
  packageVersion: string;
307
+ txValidationCache?: TxValidationCache;
269
308
  },
270
309
  ) {
271
310
  const {
@@ -275,9 +314,11 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
275
314
  mempools,
276
315
  proofVerifier,
277
316
  peerStore,
317
+ blockMinFeesProvider,
278
318
  telemetry,
279
319
  logger,
280
320
  packageVersion,
321
+ txValidationCache,
281
322
  } = deps;
282
323
  const { p2pPort, maxPeerCount, listenAddress } = config;
283
324
  const bindAddrTcp = convertToMultiaddr(listenAddress, p2pPort, 'tcp');
@@ -305,11 +346,6 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
305
346
  const versions = getVersions(config);
306
347
  const protocolVersion = compressComponentVersions(versions);
307
348
 
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
349
  const preferredPeersEnrs: ENR[] = config.preferredPeers.map(enr => ENR.decodeTxt(enr));
314
350
  const directPeers = (
315
351
  await Promise.all(
@@ -329,6 +365,19 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
329
365
 
330
366
  const announceTcpMultiaddr = config.p2pIp ? [convertToMultiaddr(config.p2pIp, p2pPort, 'tcp')] : [];
331
367
 
368
+ // Create dynamic topic score params based on network configuration
369
+ const l1Constants = epochCache.getL1Constants();
370
+ const topicScoreParams = createAllTopicScoreParams(protocolVersion, {
371
+ slotDurationMs: l1Constants.slotDuration * 1000,
372
+ ethereumSlotDuration: l1Constants.ethereumSlotDuration,
373
+ heartbeatIntervalMs: config.gossipsubInterval,
374
+ targetCommitteeSize: l1Constants.targetCommitteeSize,
375
+ blockDurationMs: config.blockDurationMs,
376
+ l1PublishingTime: config.l1PublishingTime,
377
+ p2pPropagationTime: config.attestationPropagationTime,
378
+ expectedBlockProposalsPerSlot: config.expectedBlockProposalsPerSlot,
379
+ });
380
+
332
381
  const node = await createLibp2p({
333
382
  start: false,
334
383
  peerId,
@@ -424,32 +473,12 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
424
473
  scoreParams: createPeerScoreParams({
425
474
  // IPColocation factor can be disabled for local testing - default to -5
426
475
  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
- },
476
+ topics: topicScoreParams,
449
477
  }),
450
478
  }) as (components: GossipSubComponents) => GossipSub,
451
- components: (components: { connectionManager: ConnectionManager }) => ({
479
+ components: (components: { connectionManager: ConnectionManager; addressManager: AddressManager }) => ({
452
480
  connectionManager: components.connectionManager,
481
+ addressManager: components.addressManager,
453
482
  }),
454
483
  },
455
484
  logger: createLibp2pComponentLogger(logger.module, logger.getBindings()),
@@ -471,13 +500,19 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
471
500
  epochCache,
472
501
  );
473
502
 
474
- // Update gossipsub score params
475
- node.services.pubsub.score.params.appSpecificWeight = 10;
503
+ // Gate req/resp data protocols for unauthenticated peers when p2pAllowOnlyValidators is enabled
504
+ reqresp.setShouldRejectPeer(peerId => peerManager.shouldDisableP2PGossip(peerId));
505
+
506
+ // Configure application-specific scoring for gossipsub.
507
+ // The weight scales app score to align with gossipsub thresholds:
508
+ // - Disconnect (-50) × 10 = -500 = gossipThreshold (stops receiving gossip)
509
+ // - Ban (-100) × 10 = -1000 = publishThreshold (cannot publish)
510
+ // Note: positive topic scores can offset penalties, so alignment is best-effort.
511
+ node.services.pubsub.score.params.appSpecificWeight = APP_SPECIFIC_WEIGHT;
476
512
  node.services.pubsub.score.params.appSpecificScore = (peerId: string) =>
477
513
  peerManager.shouldDisableP2PGossip(peerId) ? -Infinity : peerManager.getPeerScore(peerId);
478
514
 
479
515
  return new LibP2PService(
480
- clientType,
481
516
  config,
482
517
  node,
483
518
  peerDiscoveryService,
@@ -488,8 +523,10 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
488
523
  epochCache,
489
524
  proofVerifier,
490
525
  worldStateSynchronizer,
526
+ blockMinFeesProvider,
491
527
  telemetry,
492
528
  logger,
529
+ txValidationCache,
493
530
  );
494
531
  }
495
532
 
@@ -503,28 +540,29 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
503
540
  throw new Error('P2P service already started');
504
541
  }
505
542
 
506
- // Get listen & announce addresses for logging
507
543
  const { p2pIp, p2pPort } = this.config;
508
- if (!p2pIp) {
509
- throw new Error('Announce address not provided.');
544
+ if (!p2pIp && !this.config.queryForIp) {
545
+ throw new Error('Announce address not provided and queryForIp is not enabled.');
510
546
  }
511
- const announceTcpMultiaddr = convertToMultiaddr(p2pIp, p2pPort, 'tcp');
547
+ const announceTcpMultiaddr = p2pIp ? convertToMultiaddr(p2pIp, p2pPort, 'tcp') : undefined;
512
548
 
513
549
  // Create request response protocol handlers
514
550
  const txHandler = reqRespTxHandler(this.mempools);
515
551
  const goodbyeHandler = reqGoodbyeHandler(this.peerManager);
516
- const blockHandler = reqRespBlockHandler(this.archiver);
517
552
  const statusHandler = reqRespStatusHandler(this.protocolVersion, this.worldStateSynchronizer, this.logger);
518
553
 
519
554
  const requestResponseHandlers: Partial<ReqRespSubProtocolHandlers> = {
520
555
  [ReqRespSubProtocol.PING]: pingHandler,
521
556
  [ReqRespSubProtocol.STATUS]: statusHandler.bind(this),
522
557
  [ReqRespSubProtocol.GOODBYE]: goodbyeHandler.bind(this),
523
- [ReqRespSubProtocol.BLOCK]: blockHandler.bind(this),
524
558
  };
525
559
 
526
560
  if (!this.config.disableTransactions) {
527
- const blockTxsHandler = reqRespBlockTxsHandler(this.mempools.attestationPool, this.mempools.txPool);
561
+ const blockTxsHandler = reqRespBlockTxsHandler(
562
+ this.mempools.attestationPool,
563
+ this.archiver,
564
+ this.mempools.txPool,
565
+ );
528
566
  requestResponseHandlers[ReqRespSubProtocol.BLOCK_TXS] = blockTxsHandler.bind(this);
529
567
  }
530
568
 
@@ -532,22 +570,14 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
532
570
  requestResponseHandlers[ReqRespSubProtocol.TX] = txHandler.bind(this);
533
571
  }
534
572
 
535
- // Define the sub protocol validators - This is done within this start() method to gain a callback to the existing validateTx function
536
- const reqrespSubProtocolValidators = {
537
- ...DEFAULT_SUB_PROTOCOL_VALIDATORS,
538
- [ReqRespSubProtocol.TX]: this.validateRequestedTxs.bind(this),
539
- [ReqRespSubProtocol.BLOCK_TXS]: this.validateRequestedBlockTxs.bind(this),
540
- [ReqRespSubProtocol.BLOCK]: this.validateRequestedBlock.bind(this),
541
- };
542
-
543
573
  await this.peerManager.initializePeers();
544
574
 
545
- await this.reqresp.start(requestResponseHandlers, reqrespSubProtocolValidators);
575
+ await this.reqresp.start(requestResponseHandlers);
546
576
 
547
577
  await this.node.start();
548
578
 
549
579
  // Subscribe to standard GossipSub topics by default
550
- for (const topic of getTopicsForClientAndConfig(this.clientType, this.config.disableTransactions)) {
580
+ for (const topic of getTopicsForConfig(this.config.disableTransactions)) {
551
581
  this.subscribeToTopic(this.topicStrings[topic]);
552
582
  }
553
583
 
@@ -558,6 +588,38 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
558
588
  if (!this.config.p2pDiscoveryDisabled) {
559
589
  await this.peerDiscoveryService.start();
560
590
  }
591
+
592
+ // Bridge discv5 IP changes to libp2p's AddressManager so peers see the updated address
593
+ if (this.config.queryForIp) {
594
+ this.discoveredP2pIp = this.config.p2pIp;
595
+ this.logger.info('IP change tracking enabled, bridging discv5 IP updates to libp2p AddressManager');
596
+ this.ipChangedHandler = (ip: string) => {
597
+ const addressManager = this.node.services.components.addressManager;
598
+ const newAddr = multiaddr(convertToMultiaddr(ip, this.config.p2pPort, 'tcp'));
599
+ const previousIp = this.discoveredP2pIp;
600
+
601
+ if (previousIp) {
602
+ const oldAddr = multiaddr(convertToMultiaddr(previousIp, this.config.p2pPort, 'tcp'));
603
+ addressManager.removeObservedAddr(oldAddr);
604
+ this.logger.info('Libp2p announce address updated due to IP change', {
605
+ previousIp,
606
+ newIp: ip,
607
+ newMultiaddr: newAddr.toString(),
608
+ });
609
+ } else {
610
+ this.logger.info('Libp2p announce address set from initial discv5 IP discovery', {
611
+ ip,
612
+ multiaddr: newAddr.toString(),
613
+ });
614
+ }
615
+
616
+ addressManager.addObservedAddr(newAddr);
617
+ addressManager.confirmObservedAddr(newAddr);
618
+ this.discoveredP2pIp = ip;
619
+ };
620
+ this.peerDiscoveryService.on('ip:changed', this.ipChangedHandler);
621
+ }
622
+
561
623
  this.discoveryRunningPromise = new RunningPromise(
562
624
  async () => {
563
625
  await this.peerManager.heartbeat();
@@ -583,6 +645,11 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
583
645
  // Remove gossip sub listener
584
646
  this.node.services.pubsub.removeEventListener(GossipSubEvent.MESSAGE, this.gossipSubEventHandler);
585
647
 
648
+ if (this.ipChangedHandler) {
649
+ this.peerDiscoveryService.removeListener('ip:changed', this.ipChangedHandler);
650
+ this.ipChangedHandler = undefined;
651
+ }
652
+
586
653
  // Stop peer manager
587
654
  this.logger.debug('Stopping peer manager...');
588
655
  await this.peerManager.stop();
@@ -597,12 +664,8 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
597
664
  this.logger.info('LibP2P service stopped');
598
665
  }
599
666
 
600
- addReqRespSubProtocol(
601
- subProtocol: ReqRespSubProtocol,
602
- handler: ReqRespSubProtocolHandler,
603
- validator?: ReqRespSubProtocolValidators[ReqRespSubProtocol],
604
- ): Promise<void> {
605
- return this.reqresp.addSubProtocol(subProtocol, handler, validator);
667
+ addReqRespSubProtocol(subProtocol: ReqRespSubProtocol, handler: ReqRespSubProtocolHandler): Promise<void> {
668
+ return this.reqresp.addSubProtocol(subProtocol, handler);
606
669
  }
607
670
 
608
671
  public registerThisValidatorAddresses(address: EthAddress[]): void {
@@ -613,6 +676,10 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
613
676
  return this.peerManager.getPeers(includePending);
614
677
  }
615
678
 
679
+ public getGossipMeshPeerCount(topicType: TopicType): number {
680
+ return this.node.services.pubsub.getMeshPeers(this.topicStrings[topicType]).length;
681
+ }
682
+
616
683
  private handleGossipSubEvent(e: CustomEvent<GossipsubMessage>) {
617
684
  this.logger.trace(`Received PUBSUB message.`);
618
685
 
@@ -626,20 +693,6 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
626
693
  setImmediate(() => void safeJob());
627
694
  }
628
695
 
629
- /**
630
- * Send a batch of requests to peers, and return the responses
631
- * @param protocol - The request response protocol to use
632
- * @param requests - The requests to send to the peers
633
- * @returns The responses to the requests
634
- */
635
- sendBatchRequest<SubProtocol extends ReqRespSubProtocol>(
636
- protocol: SubProtocol,
637
- requests: InstanceType<SubProtocolMap[SubProtocol]['request']>[],
638
- pinnedPeerId: PeerId | undefined,
639
- ): Promise<InstanceType<SubProtocolMap[SubProtocol]['response']>[]> {
640
- return this.reqresp.sendBatchRequest(protocol, requests, pinnedPeerId);
641
- }
642
-
643
696
  public sendRequestToPeer(
644
697
  peerId: PeerId,
645
698
  subProtocol: ReqRespSubProtocol,
@@ -661,8 +714,35 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
661
714
  this.blockReceivedCallback = callback;
662
715
  }
663
716
 
664
- public registerCheckpointReceivedCallback(callback: P2PCheckpointReceivedCallback) {
665
- this.checkpointReceivedCallback = callback;
717
+ public registerValidatorCheckpointReceivedCallback(callback: P2PCheckpointReceivedCallback) {
718
+ this.validatorCheckpointReceivedCallback = callback;
719
+ }
720
+
721
+ public registerAllNodesCheckpointReceivedCallback(callback: P2PCheckpointReceivedCallback) {
722
+ this.allNodesCheckpointReceivedCallback = callback;
723
+ }
724
+
725
+ /**
726
+ * Registers a callback to be invoked when a duplicate proposal is detected.
727
+ * This callback is triggered on the first duplicate (when count goes from 1 to 2).
728
+ */
729
+ public registerDuplicateProposalCallback(
730
+ callback: (info: { slot: SlotNumber; proposer: EthAddress; type: 'checkpoint' | 'block' }) => void,
731
+ ): void {
732
+ this.duplicateProposalCallback = callback;
733
+ }
734
+
735
+ /**
736
+ * Registers a callback to be invoked when a duplicate attestation is detected.
737
+ * A validator signing attestations for different proposals at the same slot.
738
+ * This callback is triggered on the first duplicate (when count goes from 1 to 2).
739
+ */
740
+ public registerDuplicateAttestationCallback(callback: P2PDuplicateAttestationCallback): void {
741
+ this.duplicateAttestationCallback = callback;
742
+ }
743
+
744
+ public registerCheckpointAttestationCallback(callback: P2PCheckpointAttestationCallback): void {
745
+ this.checkpointAttestationCallback = callback;
666
746
  }
667
747
 
668
748
  /**
@@ -729,6 +809,9 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
729
809
  if (!validator || !validator.addMessage(msgId)) {
730
810
  this.instrumentation.incMessagePrevalidationStatus(false, topicType);
731
811
  this.node.services.pubsub.reportMessageValidationResult(msgId, source.toString(), TopicValidatorResult.Ignore);
812
+ if (topicType === TopicType.tx) {
813
+ this.logger.verbose(`Ignoring already-seen tx gossip message`, { msgId, source: source.toString() });
814
+ }
732
815
  return { result: false, topicType };
733
816
  }
734
817
 
@@ -790,12 +873,19 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
790
873
 
791
874
  // Process the message, optionally within a linked span for trace propagation
792
875
  const processMessage = async () => {
876
+ if (
877
+ this.config.skipIncomingProposals &&
878
+ (msg.topic === this.topicStrings[TopicType.block_proposal] ||
879
+ msg.topic === this.topicStrings[TopicType.checkpoint_proposal])
880
+ ) {
881
+ this.logger.warn(`Ignoring incoming proposal (skipIncomingProposals is set)`, { topic: msg.topic });
882
+ this.node.services.pubsub.reportMessageValidationResult(msgId, source.toString(), TopicValidatorResult.Ignore);
883
+ return;
884
+ }
793
885
  if (msg.topic === this.topicStrings[TopicType.tx]) {
794
886
  await this.handleGossipedTx(p2pMessage.payload, msgId, source);
795
887
  } else if (msg.topic === this.topicStrings[TopicType.checkpoint_attestation]) {
796
- if (this.clientType === P2PClientType.Full) {
797
- await this.processCheckpointAttestationFromPeer(p2pMessage.payload, msgId, source);
798
- }
888
+ await this.processCheckpointAttestationFromPeer(p2pMessage.payload, msgId, source);
799
889
  } else if (msg.topic === this.topicStrings[TopicType.block_proposal]) {
800
890
  await this.processBlockFromPeer(p2pMessage.payload, msgId, source);
801
891
  } else if (msg.topic === this.topicStrings[TopicType.checkpoint_proposal]) {
@@ -851,51 +941,145 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
851
941
  return;
852
942
  }
853
943
 
854
- protected async validateReceivedMessage<T>(
855
- validationFunc: () => Promise<ReceivedMessageValidationResult<T>>,
944
+ protected async validateReceivedMessage<T, M = undefined>(
945
+ validationFunc: () => Promise<ReceivedMessageValidationResult<T, M>>,
856
946
  msgId: string,
857
947
  source: PeerId,
858
948
  topicType: TopicType,
859
- ): Promise<ReceivedMessageValidationResult<T>> {
860
- let resultAndObj: ReceivedMessageValidationResult<T> = { result: TopicValidatorResult.Reject };
949
+ ): Promise<ReceivedMessageValidationResult<T, M>> {
950
+ // Default to reject result with a penalty if validation function throws an error
951
+ let resultAndObj: ReceivedMessageValidationResult<T, M> = {
952
+ result: TopicValidatorResult.Reject,
953
+ severity: PeerErrorSeverity.MidToleranceError,
954
+ };
861
955
  const timer = new Timer();
862
956
  try {
863
957
  resultAndObj = await validationFunc();
864
958
  } catch (err) {
865
- this.peerManager.penalizePeer(source, PeerErrorSeverity.LowToleranceError);
866
- this.logger.error(`Error deserializing and validating gossipsub message`, err, {
867
- msgId,
868
- source: source.toString(),
869
- topicType,
870
- });
959
+ this.logger.error(`Error validating gossipsub message`, err, { msgId, source: source.toString(), topicType });
960
+ }
961
+
962
+ const validationTimeMs = timer.ms();
963
+ const mcacheWindowMs = this.config.gossipsubMcacheLength * this.config.gossipsubInterval;
964
+ if (validationTimeMs > mcacheWindowMs * 0.75) {
965
+ this.instrumentation.incSlowValidation(topicType);
966
+ this.logger.warn(
967
+ `Gossip validation for ${topicType} took ${validationTimeMs}ms, approaching mcache eviction window of ${mcacheWindowMs}ms. ` +
968
+ `Message forwarding may be skipped if validation exceeds the window.`,
969
+ { msgId, source: source.toString(), topicType, validationTimeMs, mcacheWindowMs },
970
+ );
871
971
  }
872
972
 
873
973
  if (resultAndObj.result === TopicValidatorResult.Accept) {
974
+ this.logger.debug(`Message ${topicType} accepted by validator`, { msgId, source: source.toString(), topicType });
874
975
  this.instrumentation.recordMessageValidation(topicType, timer);
976
+ } else if (resultAndObj.result === TopicValidatorResult.Reject) {
977
+ this.logger.warn(`Message ${topicType} rejected by validator with severity ${resultAndObj.severity}`, {
978
+ msgId,
979
+ source: source.toString(),
980
+ topicType,
981
+ severity: resultAndObj.severity,
982
+ });
983
+ this.peerManager.penalizePeer(source, resultAndObj.severity);
984
+ } else {
985
+ this.logger.trace(`Message ${topicType} ignored by validator`, { msgId, source: source.toString(), topicType });
875
986
  }
876
987
 
877
988
  this.node.services.pubsub.reportMessageValidationResult(msgId, source.toString(), resultAndObj.result);
878
989
  return resultAndObj;
879
990
  }
880
991
 
992
+ private tryDeserialize<T>(deserializeFunc: () => T, msgId: string, source: PeerId): T | undefined {
993
+ try {
994
+ return deserializeFunc();
995
+ } catch (err) {
996
+ this.logger.warn(`Failed to deserialize gossipsub message from buffer`, {
997
+ err,
998
+ msgId,
999
+ source: source.toString(),
1000
+ });
1001
+ return undefined;
1002
+ }
1003
+ }
1004
+
881
1005
  protected async handleGossipedTx(payloadData: Buffer, msgId: string, source: PeerId) {
882
1006
  const validationFunc: () => Promise<ReceivedMessageValidationResult<Tx>> = async () => {
883
- const tx = Tx.fromBuffer(payloadData);
884
- const isValid = await this.validatePropagatedTx(tx, source);
885
- const exists = isValid && (await this.mempools.txPool.hasTx(tx.getTxHash()));
1007
+ const tx = this.tryDeserialize(() => Tx.fromBuffer(payloadData), msgId, source);
1008
+ if (!tx) {
1009
+ return { result: TopicValidatorResult.Reject, severity: PeerErrorSeverity.LowToleranceError };
1010
+ }
886
1011
 
887
- this.logger.trace(`Validate propagated tx`, {
888
- isValid,
889
- exists,
1012
+ const currentBlockNumber = await this.archiver.getBlockNumber();
1013
+ const { ts: nextSlotTimestamp } = this.epochCache.getEpochAndSlotInNextL1Slot();
1014
+
1015
+ // Stage 1: fast validators (metadata, data, timestamps, double-spend, gas, phases, block header)
1016
+ const firstStageValidators = await this.createFirstStageMessageValidators(currentBlockNumber, nextSlotTimestamp);
1017
+ const firstStageOutcome = await this.runValidations(tx, firstStageValidators);
1018
+ if (!firstStageOutcome.allPassed) {
1019
+ const { name } = firstStageOutcome.failure;
1020
+ let { severity } = firstStageOutcome.failure;
1021
+
1022
+ // Double spend validator has a special case handler. We perform more detailed examination
1023
+ // as to how recently the nullifier was entered into the tree and if the transaction should
1024
+ // have 'known' the nullifier existed. This determines the severity of the penalty applied to the peer.
1025
+ if (name === 'doubleSpendValidator') {
1026
+ const txBlockNumber = BlockNumber(currentBlockNumber + 1);
1027
+ severity = await this.handleDoubleSpendFailure(tx, txBlockNumber);
1028
+ }
1029
+
1030
+ this.logger.verbose(`Rejecting gossiped tx ${tx.getTxHash().toString()}: stage 1 validation failed`, {
1031
+ validator: name,
1032
+ severity,
1033
+ source: source.toString(),
1034
+ });
1035
+ return { result: TopicValidatorResult.Reject, severity };
1036
+ }
1037
+
1038
+ // Pool pre-check: see if the pool would accept this tx before doing expensive proof verification
1039
+ const canAdd = await this.mempools.txPool.canAddPendingTx(tx);
1040
+ if (canAdd === 'ignored') {
1041
+ this.logger.verbose(`Ignoring gossiped tx ${tx.getTxHash().toString()}: pool pre-check returned ignored`, {
1042
+ source: source.toString(),
1043
+ });
1044
+ return { result: TopicValidatorResult.Ignore, obj: tx };
1045
+ }
1046
+
1047
+ // Stage 2: expensive proof verification
1048
+ const secondStageValidators = this.createSecondStageMessageValidators();
1049
+ const secondStageOutcome = await this.runValidations(tx, secondStageValidators);
1050
+ if (!secondStageOutcome.allPassed) {
1051
+ const { severity, name } = secondStageOutcome.failure;
1052
+ this.logger.verbose(`Rejecting gossiped tx ${tx.getTxHash().toString()}: stage 2 validation failed`, {
1053
+ validator: name,
1054
+ severity,
1055
+ source: source.toString(),
1056
+ });
1057
+ return { result: TopicValidatorResult.Reject, severity };
1058
+ }
1059
+
1060
+ // Pool add: persist the tx
1061
+ const txHash = tx.getTxHash();
1062
+ const addResult = await this.mempools.txPool.addPendingTxs([tx], { source: 'gossip' });
1063
+
1064
+ const wasAccepted = addResult.accepted.some(h => h.equals(txHash));
1065
+ const wasIgnored = addResult.ignored.some(h => h.equals(txHash));
1066
+
1067
+ this.logger.verbose(`Validate propagated tx ${txHash.toString()}`, {
1068
+ wasAccepted,
1069
+ wasIgnored,
890
1070
  [Attributes.P2P_ID]: source.toString(),
891
1071
  });
892
1072
 
893
- if (!isValid) {
894
- return { result: TopicValidatorResult.Reject };
895
- } else if (exists) {
1073
+ if (wasAccepted) {
1074
+ return { result: TopicValidatorResult.Accept, obj: tx };
1075
+ } else if (wasIgnored) {
896
1076
  return { result: TopicValidatorResult.Ignore, obj: tx };
897
1077
  } else {
898
- return { result: TopicValidatorResult.Accept, obj: tx };
1078
+ this.logger.warn(`Gossiped tx ${txHash.toString()} unexpectedly rejected by pool`, {
1079
+ source: source.toString(),
1080
+ txHash: txHash.toString(),
1081
+ });
1082
+ return { result: TopicValidatorResult.Reject, severity: PeerErrorSeverity.HighToleranceError };
899
1083
  }
900
1084
  };
901
1085
 
@@ -904,6 +1088,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
904
1088
  return;
905
1089
  }
906
1090
 
1091
+ // Tx was accepted into pool and will be propagated - just log and record metrics
907
1092
  const txHash = tx.getTxHash();
908
1093
  const txHashString = txHash.toString();
909
1094
  this.logger.verbose(`Received tx ${txHashString} from external peer ${source.toString()} via gossip`, {
@@ -911,13 +1096,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
911
1096
  txHash: txHashString,
912
1097
  });
913
1098
 
914
- if (this.config.dropTransactions && randomInt(1000) < this.config.dropTransactionsProbability * 1000) {
915
- this.logger.warn(`Intentionally dropping tx ${txHashString} (probability rule)`);
916
- return;
917
- }
918
-
919
1099
  this.instrumentation.incrementTxReceived(1);
920
- await this.mempools.txPool.addTxs([tx]);
921
1100
  }
922
1101
 
923
1102
  /**
@@ -929,47 +1108,17 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
929
1108
  msgId: string,
930
1109
  source: PeerId,
931
1110
  ): Promise<void> {
932
- const validationFunc: () => Promise<ReceivedMessageValidationResult<CheckpointAttestation>> = async () => {
933
- const attestation = CheckpointAttestation.fromBuffer(payloadData);
934
- const pool = this.mempools.attestationPool;
935
- const validationResult = await this.validateCheckpointAttestation(source, attestation);
936
- const isValid = validationResult.result === 'accept';
937
- const exists = isValid && (await pool.hasCheckpointAttestation(attestation));
938
-
939
- let canAdd = true;
940
- if (isValid && !exists) {
941
- const slot = attestation.payload.header.slotNumber;
942
- const { committee } = await this.epochCache.getCommittee(slot);
943
- const committeeSize = committee?.length ?? 0;
944
- canAdd = await pool.canAddCheckpointAttestation(attestation, committeeSize);
945
- }
946
-
947
- this.logger.trace(`Validate propagated checkpoint attestation`, {
948
- isValid,
949
- exists,
950
- canAdd,
951
- [Attributes.SLOT_NUMBER]: attestation.payload.header.slotNumber.toString(),
952
- [Attributes.P2P_ID]: source.toString(),
953
- });
954
-
955
- if (validationResult.result === 'reject') {
956
- return { result: TopicValidatorResult.Reject };
957
- } else if (validationResult.result === 'ignore' || exists) {
958
- return { result: TopicValidatorResult.Ignore, obj: attestation };
959
- } else if (!canAdd) {
960
- this.logger.warn(`Dropping checkpoint attestation due to per-(slot, proposalId) attestation cap`, {
961
- slot: attestation.payload.header.slotNumber.toString(),
962
- archive: attestation.archive.toString(),
963
- source: source.toString(),
964
- });
965
- return { result: TopicValidatorResult.Ignore, obj: attestation };
966
- } else {
967
- return { result: TopicValidatorResult.Accept, obj: attestation };
968
- }
969
- };
970
-
971
1111
  const { result, obj: attestation } = await this.validateReceivedMessage<CheckpointAttestation>(
972
- validationFunc,
1112
+ () => {
1113
+ const attestation = this.tryDeserialize(() => CheckpointAttestation.fromBuffer(payloadData), msgId, source);
1114
+ if (!attestation) {
1115
+ return Promise.resolve({
1116
+ result: TopicValidatorResult.Reject,
1117
+ severity: PeerErrorSeverity.LowToleranceError,
1118
+ });
1119
+ }
1120
+ return this.validateAndStoreCheckpointAttestation(source, attestation);
1121
+ },
973
1122
  msgId,
974
1123
  source,
975
1124
  TopicType.checkpoint_attestation,
@@ -979,8 +1128,8 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
979
1128
  return;
980
1129
  }
981
1130
 
982
- this.logger.debug(
983
- `Received checkpoint attestation for slot ${attestation.slotNumber} from external peer ${source.toString()}`,
1131
+ this.logger.verbose(
1132
+ `Received valid checkpoint attestation for slot ${attestation.slotNumber} from external peer ${source.toString()}`,
984
1133
  {
985
1134
  p2pMessageIdentifier: await attestation.p2pMessageLoggingIdentifier(),
986
1135
  slot: attestation.slotNumber,
@@ -988,60 +1137,169 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
988
1137
  source: source.toString(),
989
1138
  },
990
1139
  );
991
-
992
- await this.mempools.attestationPool.addCheckpointAttestations([attestation]);
993
1140
  }
994
1141
 
995
- private async processBlockFromPeer(payloadData: Buffer, msgId: string, source: PeerId): Promise<void> {
996
- const validationFunc: () => Promise<ReceivedMessageValidationResult<BlockProposal>> = async () => {
997
- const block = BlockProposal.fromBuffer(payloadData);
998
- const validationResult = await this.validateBlockProposal(source, block);
999
- const isValid = validationResult.result === 'accept';
1000
- const pool = this.mempools.attestationPool;
1001
-
1002
- const exists = isValid && (await pool.hasBlockProposal(block));
1003
- const canAdd = isValid && (await pool.canAddProposal(block));
1004
-
1005
- this.logger.trace(`Validate propagated block proposal`, {
1006
- isValid,
1007
- exists,
1008
- canAdd,
1009
- [Attributes.SLOT_NUMBER]: block.slotNumber.toString(),
1010
- [Attributes.P2P_ID]: source.toString(),
1142
+ /** Validates a checkpoint attestation and adds it to the pool. Penalizes the peer if validation fails. */
1143
+ @trackSpan('Libp2pService.validateAndStoreCheckpointAttestation', (_peerId, attestation) => ({
1144
+ [Attributes.SLOT_NUMBER]: attestation.payload.header.slotNumber.toString(),
1145
+ }))
1146
+ protected async validateAndStoreCheckpointAttestation(
1147
+ peerId: PeerId,
1148
+ attestation: CheckpointAttestation,
1149
+ ): Promise<ReceivedMessageValidationResult<CheckpointAttestation>> {
1150
+ const validationResult = await this.checkpointAttestationValidator.validate(attestation);
1151
+
1152
+ if (validationResult.result === 'reject') {
1153
+ this.logger.warn(`Penalizing peer ${peerId} for checkpoint attestation validation failure`);
1154
+ return { result: TopicValidatorResult.Reject, severity: validationResult.severity };
1155
+ }
1156
+
1157
+ if (validationResult.result === 'ignore') {
1158
+ return { result: TopicValidatorResult.Ignore, obj: attestation };
1159
+ }
1160
+
1161
+ // Try to add the attestation: this handles existence check, cap check, and adding in one call
1162
+ // count is the number of attestations by this signer for this slot (for duplicate detection)
1163
+ const slot = attestation.payload.header.slotNumber;
1164
+ const { added, alreadyExists, count } =
1165
+ await this.mempools.attestationPool.tryAddCheckpointAttestation(attestation);
1166
+
1167
+ this.logger.trace(`Validate propagated checkpoint attestation`, {
1168
+ added,
1169
+ alreadyExists,
1170
+ count,
1171
+ [Attributes.SLOT_NUMBER]: slot.toString(),
1172
+ [Attributes.P2P_ID]: peerId.toString(),
1173
+ });
1174
+
1175
+ // Exact same attestation received, no need to re-broadcast
1176
+ if (alreadyExists) {
1177
+ return { result: TopicValidatorResult.Ignore, obj: attestation };
1178
+ }
1179
+
1180
+ // Could not add (cap reached for signer), penalize and do not re-broadcast
1181
+ if (!added) {
1182
+ this.logger.warn(`Rejecting checkpoint attestation due to cap`, {
1183
+ slot: slot.toString(),
1184
+ archive: attestation.archive.toString(),
1185
+ source: peerId.toString(),
1186
+ attester: attestation.getSender()?.toString(),
1187
+ count,
1011
1188
  });
1189
+ return { result: TopicValidatorResult.Reject, severity: PeerErrorSeverity.HighToleranceError };
1190
+ }
1012
1191
 
1013
- if (validationResult.result === 'reject') {
1014
- return { result: TopicValidatorResult.Reject };
1015
- } else if (validationResult.result === 'ignore' || exists) {
1016
- return { result: TopicValidatorResult.Ignore, obj: block };
1017
- } else if (!canAdd) {
1018
- this.peerManager.penalizePeer(source, PeerErrorSeverity.MidToleranceError);
1019
- this.logger.warn(`Penalizing peer for block proposal exceeding per-slot cap`, {
1020
- slot: block.slotNumber.toString(),
1021
- archive: block.archive.toString(),
1022
- source: source.toString(),
1192
+ // Check if this is a duplicate attestation (signer attested to a different proposal at the same slot)
1193
+ // count is the number of attestations by this signer for this slot
1194
+ if (count === 2) {
1195
+ const attester = attestation.getSender();
1196
+ if (attester) {
1197
+ this.logger.warn(`Detected duplicate attestation (equivocation) at slot ${slot}`, {
1198
+ slot: slot.toString(),
1199
+ archive: attestation.archive.toString(),
1200
+ source: peerId.toString(),
1201
+ attester: attester.toString(),
1023
1202
  });
1024
- return { result: TopicValidatorResult.Reject };
1025
- } else {
1026
- return { result: TopicValidatorResult.Accept, obj: block };
1203
+ this.duplicateAttestationCallback?.({ slot, attester });
1027
1204
  }
1028
- };
1205
+ }
1029
1206
 
1030
- const { result, obj: block } = await this.validateReceivedMessage<BlockProposal>(
1031
- validationFunc,
1207
+ // Attestation was added successfully - accept it so other nodes can also detect the equivocation
1208
+ this.checkpointAttestationCallback?.(attestation);
1209
+ return { result: TopicValidatorResult.Accept, obj: attestation };
1210
+ }
1211
+
1212
+ protected async processBlockFromPeer(payloadData: Buffer, msgId: string, source: PeerId): Promise<void> {
1213
+ const {
1214
+ result,
1215
+ obj: block,
1216
+ metadata: { isEquivocated } = {},
1217
+ } = await this.validateReceivedMessage<BlockProposal, { isEquivocated: boolean }>(
1218
+ () => this.validateAndStoreBlockProposal(source, BlockProposal.fromBuffer(payloadData)),
1032
1219
  msgId,
1033
1220
  source,
1034
1221
  TopicType.block_proposal,
1035
1222
  );
1036
1223
 
1037
- if (!result || !block) {
1224
+ // If not accepted or equivocated, return
1225
+ if (result !== TopicValidatorResult.Accept || !block || isEquivocated) {
1038
1226
  return;
1039
1227
  }
1040
1228
 
1041
1229
  await this.processValidBlockProposal(block, source);
1042
1230
  }
1043
1231
 
1044
- // REVIEW: callback pattern https://github.com/AztecProtocol/aztec-packages/issues/7963
1232
+ /** Validates a block proposal. Triggers a penalization to the peer that sent it if invalid. Adds to the mempool if valid. */
1233
+ @trackSpan('Libp2pService.validateAndStoreBlockProposal', (_peerId, block) => ({
1234
+ [Attributes.BLOCK_NUMBER]: block.blockNumber.toString(),
1235
+ [Attributes.SLOT_NUMBER]: block.slotNumber.toString(),
1236
+ }))
1237
+ protected async validateAndStoreBlockProposal(
1238
+ peerId: PeerId,
1239
+ block: BlockProposal,
1240
+ ): Promise<ReceivedMessageValidationResult<BlockProposal, { isEquivocated: boolean }>> {
1241
+ const validationResult = await this.blockProposalValidator.validate(block);
1242
+
1243
+ if (validationResult.result === 'reject') {
1244
+ this.logger.warn(`Penalizing peer ${peerId} for block proposal validation failure`);
1245
+ return { result: TopicValidatorResult.Reject, severity: validationResult.severity };
1246
+ }
1247
+
1248
+ if (validationResult.result === 'ignore') {
1249
+ return { result: TopicValidatorResult.Ignore, obj: block };
1250
+ }
1251
+
1252
+ // Try to add the proposal: this handles existence check, cap check, and adding in one call
1253
+ const { added, alreadyExists, count } = await this.mempools.attestationPool.tryAddBlockProposal(block);
1254
+ const isEquivocated = count !== undefined && count > 1;
1255
+
1256
+ // Duplicate proposal received, no need to re-broadcast
1257
+ if (alreadyExists) {
1258
+ this.logger.debug(`Ignoring duplicate block proposal received`, {
1259
+ ...block.toBlockInfo(),
1260
+ indexWithinCheckpoint: block.indexWithinCheckpoint,
1261
+ proposer: block.getSender()?.toString(),
1262
+ source: peerId.toString(),
1263
+ });
1264
+ return { result: TopicValidatorResult.Ignore, obj: block, metadata: { isEquivocated } };
1265
+ }
1266
+
1267
+ // Too many blocks received for this slot and index, penalize peer and do not re-broadcast
1268
+ if (!added) {
1269
+ this.logger.warn(`Penalizing peer for block proposal exceeding per-position cap`, {
1270
+ ...block.toBlockInfo(),
1271
+ indexWithinCheckpoint: block.indexWithinCheckpoint,
1272
+ count,
1273
+ proposer: block.getSender()?.toString(),
1274
+ source: peerId.toString(),
1275
+ });
1276
+ return {
1277
+ result: TopicValidatorResult.Reject,
1278
+ metadata: { isEquivocated },
1279
+ severity: PeerErrorSeverity.HighToleranceError,
1280
+ };
1281
+ }
1282
+
1283
+ // If this was a duplicate proposal, do not process it, but do invoke the duplicate callback,
1284
+ // and do re-broadcast it so other nodes in the network know to slash the proposer
1285
+ if (isEquivocated) {
1286
+ const proposer = block.getSender();
1287
+ this.logger.warn(`Detected duplicate block proposal (equivocation) at slot ${block.slotNumber}`, {
1288
+ ...block.toBlockInfo(),
1289
+ source: peerId.toString(),
1290
+ proposer: proposer?.toString(),
1291
+ });
1292
+ // Invoke the duplicate callback on the first duplicate spotted only
1293
+ if (proposer && count === 2) {
1294
+ this.duplicateProposalCallback?.({ slot: block.slotNumber, proposer, type: 'block' });
1295
+ }
1296
+ return { result: TopicValidatorResult.Accept, obj: block, metadata: { isEquivocated } };
1297
+ }
1298
+
1299
+ // Otherwise, we're good to go!
1300
+ return { result: TopicValidatorResult.Accept, obj: block };
1301
+ }
1302
+
1045
1303
  // REFACTOR(palla): This method should be moved to the p2p_client or to a separate component,
1046
1304
  // should not be here as it does not deal with p2p networking.
1047
1305
  @trackSpan('Libp2pService.processValidBlockProposal', async block => ({
@@ -1049,7 +1307,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1049
1307
  [Attributes.BLOCK_ARCHIVE]: block.archive.toString(),
1050
1308
  [Attributes.P2P_ID]: await block.p2pMessageLoggingIdentifier().then(i => i.toString()),
1051
1309
  }))
1052
- private async processValidBlockProposal(block: BlockProposal, sender: PeerId) {
1310
+ protected async processValidBlockProposal(block: BlockProposal, sender: PeerId) {
1053
1311
  const slot = block.slotNumber;
1054
1312
  this.logger.verbose(`Received block proposal for slot ${slot} from external peer ${sender.toString()}.`, {
1055
1313
  p2pMessageIdentifier: await block.p2pMessageLoggingIdentifier(),
@@ -1057,30 +1315,14 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1057
1315
  ...block.toBlockInfo(),
1058
1316
  });
1059
1317
 
1060
- // Attempt to add proposal
1061
- try {
1062
- await this.mempools.attestationPool.addBlockProposal(block);
1063
- } catch (err: unknown) {
1064
- // Drop proposals if we hit per-slot cap in the attestation pool; rethrow unknown errors
1065
- if (err instanceof ProposalSlotCapExceededError) {
1066
- this.logger.warn(`Dropping block proposal due to per-slot proposal cap`, {
1067
- slot: String(slot),
1068
- archive: block.archive.toString(),
1069
- error: (err as Error).message,
1070
- });
1071
- return;
1072
- }
1073
- throw err;
1074
- }
1075
-
1076
- // Mark the txs in this proposal as non-evictable
1077
- await this.mempools.txPool.markTxsAsNonEvictable(block.txHashes);
1318
+ // Mark the txs in this proposal as protected
1319
+ await this.mempools.txPool.protectTxs(block.txHashes, block.blockHeader);
1078
1320
 
1079
1321
  // Call the block received callback to validate the proposal.
1080
1322
  // Note: Validators do NOT attest to individual blocks, only to checkpoint proposals.
1081
1323
  const isValid = await this.blockReceivedCallback(block, sender);
1082
1324
  if (!isValid) {
1083
- this.logger.warn(`Block proposal validation failed for block ${block.blockNumber}`, block.toBlockInfo());
1325
+ this.logger.info(`Block proposal validation failed for block ${block.blockNumber}`, block.toBlockInfo());
1084
1326
  }
1085
1327
  }
1086
1328
 
@@ -1088,67 +1330,165 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1088
1330
  * Handle a gossiped checkpoint proposal.
1089
1331
  * Validates and processes the checkpoint proposal, then triggers the callback for attestation.
1090
1332
  */
1091
- private async handleGossipedCheckpointProposal(payloadData: Buffer, msgId: string, source: PeerId): Promise<void> {
1092
- // TODO(palla/mbps): This pattern is repeated across multiple message handlers, consider abstracting it.
1093
- const validationFunc: () => Promise<ReceivedMessageValidationResult<CheckpointProposal>> = async () => {
1094
- const checkpoint = CheckpointProposal.fromBuffer(payloadData);
1095
- const validationResult = await this.validateCheckpointProposal(source, checkpoint);
1096
- const isValid = validationResult.result === 'accept';
1097
- const pool = this.mempools.attestationPool;
1098
-
1099
- const exists = isValid && (await pool.hasCheckpointProposal(checkpoint));
1100
- const canAdd = isValid && (await pool.canAddCheckpointProposal(checkpoint));
1101
-
1102
- this.logger.trace(`Validate propagated checkpoint proposal`, {
1103
- isValid,
1104
- exists,
1105
- canAdd,
1106
- [Attributes.SLOT_NUMBER]: checkpoint.slotNumber.toString(),
1107
- [Attributes.P2P_ID]: source.toString(),
1108
- });
1109
-
1110
- if (validationResult.result === 'reject') {
1111
- return { result: TopicValidatorResult.Reject };
1112
- } else if (validationResult.result === 'ignore' || exists) {
1113
- return { result: TopicValidatorResult.Ignore, obj: checkpoint };
1114
- } else if (!canAdd) {
1115
- this.peerManager.penalizePeer(source, PeerErrorSeverity.MidToleranceError);
1116
- this.logger.warn(`Penalizing peer for checkpoint proposal exceeding per-slot cap`, {
1117
- slot: checkpoint.slotNumber.toString(),
1118
- archive: checkpoint.archive.toString(),
1119
- source: source.toString(),
1120
- });
1121
- return { result: TopicValidatorResult.Reject };
1122
- } else {
1123
- return { result: TopicValidatorResult.Accept, obj: checkpoint };
1124
- }
1125
- };
1126
-
1127
- const { result, obj: checkpoint } = await this.validateReceivedMessage<CheckpointProposal>(
1128
- validationFunc,
1333
+ protected async handleGossipedCheckpointProposal(payloadData: Buffer, msgId: string, source: PeerId): Promise<void> {
1334
+ const {
1335
+ result,
1336
+ obj: checkpoint,
1337
+ metadata: { isEquivocated, processBlock } = {},
1338
+ } = await this.validateReceivedMessage<CheckpointProposal, { isEquivocated: boolean; processBlock: boolean }>(
1339
+ () => this.validateAndStoreCheckpointProposal(source, CheckpointProposal.fromBuffer(payloadData)),
1129
1340
  msgId,
1130
1341
  source,
1131
1342
  TopicType.checkpoint_proposal,
1132
1343
  );
1133
1344
 
1134
- if (result !== TopicValidatorResult.Accept || !checkpoint) {
1345
+ // Process checkpoint proposal if valid and not equivocated.
1346
+ const processCheckpointFn = () =>
1347
+ result === TopicValidatorResult.Accept && checkpoint && !isEquivocated
1348
+ ? this.processValidCheckpointProposal(checkpoint.toCore(), source)
1349
+ : Promise.resolve();
1350
+
1351
+ // If the checkpoint contained a valid last block, we process it even if the checkpoint itself is to be rejected
1352
+ // TODO(palla/mbps): Is this ok? Should we be considering a block from a checkpoint that was equivocated?
1353
+ const processBlockFn = () =>
1354
+ processBlock && checkpoint && checkpoint.getBlockProposal()
1355
+ ? this.processValidBlockProposal(checkpoint.getBlockProposal()!, source)
1356
+ : Promise.resolve();
1357
+
1358
+ // A node that skips checkpoint validation attests without re-executing the embedded last block, so run
1359
+ // the checkpoint callback first: this creates and broadcasts the attestation before the block is
1360
+ // processed. Otherwise the block's re-execution — which can stall until the re-execution deadline
1361
+ // waiting for a parent that may never arrive — would delay the attestation past the slot's attestation
1362
+ // window, after which peers reject it as stale.
1363
+ if (this.config.skipCheckpointProposalValidation) {
1364
+ await processCheckpointFn();
1365
+ await processBlockFn();
1135
1366
  return;
1136
1367
  }
1137
1368
 
1138
- await this.processValidCheckpointProposal(checkpoint, source);
1369
+ // Process the block first, since it's required for the checkpoint proposal validation.
1370
+ await processBlockFn();
1371
+ await processCheckpointFn();
1372
+ }
1373
+
1374
+ /**
1375
+ * Validates a checkpoint proposal. Penalizes peer if validation fails. Adds the checkpoint and
1376
+ * its last block (if present) to the mempool if valid. Triggers equivocation detection on both.
1377
+ */
1378
+ @trackSpan('Libp2pService.validateAndStoreCheckpointProposal', (_peerId, checkpoint) => ({
1379
+ [Attributes.SLOT_NUMBER]: checkpoint.slotNumber.toString(),
1380
+ }))
1381
+ protected async validateAndStoreCheckpointProposal(
1382
+ peerId: PeerId,
1383
+ checkpoint: CheckpointProposal,
1384
+ ): Promise<ReceivedMessageValidationResult<CheckpointProposal, { isEquivocated: boolean; processBlock: boolean }>> {
1385
+ const validationResult = await this.checkpointProposalValidator.validate(checkpoint);
1386
+
1387
+ if (validationResult.result === 'reject') {
1388
+ this.logger.warn(`Penalizing peer ${peerId} for checkpoint proposal validation failure`);
1389
+ return { result: TopicValidatorResult.Reject, severity: validationResult.severity };
1390
+ }
1391
+
1392
+ if (validationResult.result === 'ignore') {
1393
+ return { result: TopicValidatorResult.Ignore, obj: checkpoint };
1394
+ }
1395
+
1396
+ // Extract and try to add the block proposal first if present
1397
+ const blockProposal = checkpoint.getBlockProposal();
1398
+ let processBlock = false;
1399
+ if (blockProposal) {
1400
+ this.logger.debug(`Validating block proposal from propagated checkpoint`, {
1401
+ [Attributes.SLOT_NUMBER]: checkpoint.slotNumber.toString(),
1402
+ [Attributes.P2P_ID]: peerId.toString(),
1403
+ });
1404
+ const blockProposalResult = await this.validateAndStoreBlockProposal(peerId, blockProposal);
1405
+ const { obj, metadata: { isEquivocated } = {} } = blockProposalResult;
1406
+ if (blockProposalResult.result === TopicValidatorResult.Reject || !obj || isEquivocated) {
1407
+ this.logger.debug(`Rejecting checkpoint due to invalid last block proposal`, {
1408
+ [Attributes.SLOT_NUMBER]: checkpoint.slotNumber.toString(),
1409
+ [Attributes.P2P_ID]: peerId.toString(),
1410
+ isEquivocated,
1411
+ result: blockProposalResult.result,
1412
+ });
1413
+ return {
1414
+ result: TopicValidatorResult.Reject,
1415
+ severity:
1416
+ 'severity' in blockProposalResult ? blockProposalResult.severity : PeerErrorSeverity.MidToleranceError,
1417
+ };
1418
+ } else if (blockProposalResult.result === TopicValidatorResult.Accept && obj && !isEquivocated) {
1419
+ processBlock = true;
1420
+ }
1421
+ }
1422
+
1423
+ // Try to add the checkpoint proposal core: this handles existence check, cap check, and adding in one call
1424
+ const checkpointCore = checkpoint.toCore();
1425
+ const tryAddResult = await this.mempools.attestationPool.tryAddCheckpointProposal(checkpointCore);
1426
+ const { added, alreadyExists, count } = tryAddResult;
1427
+ const isEquivocated = count !== undefined && count > 1;
1428
+
1429
+ // Duplicate proposal received, do not re-broadcast
1430
+ if (alreadyExists) {
1431
+ this.logger.debug(`Ignoring duplicate checkpoint proposal received`, {
1432
+ ...checkpoint.toCheckpointInfo(),
1433
+ source: peerId.toString(),
1434
+ });
1435
+ return {
1436
+ result: TopicValidatorResult.Ignore,
1437
+ obj: checkpoint,
1438
+ metadata: { isEquivocated, processBlock },
1439
+ };
1440
+ }
1441
+
1442
+ // Too many checkpoint proposals received for this slot, penalize peer and do not re-broadcast
1443
+ // Note: We still return the checkpoint obj so the lastBlock can be processed if valid
1444
+ if (!added) {
1445
+ this.logger.warn(`Penalizing peer for checkpoint proposal exceeding per-slot cap`, {
1446
+ ...checkpoint.toCheckpointInfo(),
1447
+ count,
1448
+ source: peerId.toString(),
1449
+ });
1450
+ return {
1451
+ result: TopicValidatorResult.Reject,
1452
+ obj: checkpoint,
1453
+ metadata: { isEquivocated, processBlock },
1454
+ severity: PeerErrorSeverity.HighToleranceError,
1455
+ };
1456
+ }
1457
+
1458
+ // If this was a duplicate proposal, do not process it, but do invoke the duplicate callback,
1459
+ // and do re-broadcast it so other nodes in the network know to slash the proposer
1460
+ if (isEquivocated) {
1461
+ const proposer = checkpoint.getSender();
1462
+ this.logger.warn(`Detected duplicate checkpoint proposal (equivocation) at slot ${checkpoint.slotNumber}`, {
1463
+ ...checkpoint.toCheckpointInfo(),
1464
+ source: peerId.toString(),
1465
+ proposer: proposer?.toString(),
1466
+ });
1467
+ // Invoke the duplicate callback on the first duplicate spotted only
1468
+ if (proposer && count === 2) {
1469
+ this.duplicateProposalCallback?.({ slot: checkpoint.slotNumber, proposer, type: 'checkpoint' });
1470
+ }
1471
+ return {
1472
+ result: TopicValidatorResult.Accept,
1473
+ obj: checkpoint,
1474
+ metadata: { isEquivocated, processBlock },
1475
+ };
1476
+ }
1477
+
1478
+ // Otherwise, we're good to go!
1479
+ return { result: TopicValidatorResult.Accept, obj: checkpoint, metadata: { processBlock, isEquivocated } };
1139
1480
  }
1140
1481
 
1141
1482
  /**
1142
1483
  * Process a validated checkpoint proposal.
1143
- * Extracts and processes the last block proposal (if present) first, then processes the checkpoint.
1144
- * The block callback is invoked before the checkpoint callback.
1484
+ * Note: The proposal was already added to the pool by tryAddCheckpointProposal in handleGossipedCheckpointProposal.
1145
1485
  */
1146
1486
  @trackSpan('Libp2pService.processValidCheckpointProposal', async checkpoint => ({
1147
1487
  [Attributes.SLOT_NUMBER]: checkpoint.slotNumber,
1148
1488
  [Attributes.BLOCK_ARCHIVE]: checkpoint.archive.toString(),
1149
1489
  [Attributes.P2P_ID]: await checkpoint.p2pMessageLoggingIdentifier().then(i => i.toString()),
1150
1490
  }))
1151
- private async processValidCheckpointProposal(checkpoint: CheckpointProposal, sender: PeerId) {
1491
+ protected async processValidCheckpointProposal(checkpoint: CheckpointProposalCore, sender: PeerId) {
1152
1492
  const slot = checkpoint.slotNumber;
1153
1493
  this.logger.verbose(`Received checkpoint proposal for slot ${slot} from external peer ${sender.toString()}.`, {
1154
1494
  p2pMessageIdentifier: await checkpoint.p2pMessageLoggingIdentifier(),
@@ -1157,37 +1497,14 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1157
1497
  source: sender.toString(),
1158
1498
  });
1159
1499
 
1160
- // Extract block proposal before adding to pool (pool stores them separately)
1161
- const blockProposal = checkpoint.getBlockProposal();
1162
-
1163
- // Add proposal to the pool (this extracts and stores block proposal separately)
1164
- await this.mempools.attestationPool.addCheckpointProposal(checkpoint);
1165
-
1166
- // Mark txs as non-evictable if present (from the last block)
1167
- if (checkpoint.txHashes.length > 0) {
1168
- await this.mempools.txPool.markTxsAsNonEvictable(checkpoint.txHashes);
1169
- }
1170
-
1171
- // If there was a last block proposal, invoke the block callback first for validation.
1172
- // Note: The block proposal is already stored in the pool by addCheckpointProposal.
1173
- if (blockProposal) {
1174
- const isValid = await this.blockReceivedCallback(blockProposal, sender);
1175
- if (!isValid) {
1176
- this.logger.warn(`Block proposal from checkpoint failed validation`, {
1177
- slot: slot.toString(),
1178
- archive: checkpoint.archive.toString(),
1179
- blockNumber: blockProposal.blockNumber.toString(),
1180
- });
1181
- return;
1182
- }
1183
- }
1500
+ await this.allNodesCheckpointReceivedCallback(checkpoint, sender);
1184
1501
 
1185
1502
  // Call the checkpoint received callback with the core version (without lastBlock)
1186
1503
  // to validate and potentially generate attestations
1187
- const attestations = await this.checkpointReceivedCallback(checkpoint.toCore(), sender);
1504
+ const attestations = await this.validatorCheckpointReceivedCallback(checkpoint, sender);
1188
1505
  if (attestations && attestations.length > 0) {
1189
1506
  // If the callback returned attestations, add them to the pool and propagate them
1190
- await this.mempools.attestationPool.addCheckpointAttestations(attestations);
1507
+ await this.mempools.attestationPool.addOwnCheckpointAttestations(attestations);
1191
1508
  for (const attestation of attestations) {
1192
1509
  await this.propagate(attestation);
1193
1510
  }
@@ -1207,23 +1524,32 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1207
1524
  }
1208
1525
 
1209
1526
  /**
1210
- * Validate the requested block transactions. Allow partial returns.
1527
+ * Validate the requested block transactions request-response consistency.
1528
+ * It does NOT validate the transactions themselves.
1211
1529
  * @param request - The block transactions request.
1212
1530
  * @param response - The block transactions response.
1213
1531
  * @param peerId - The ID of the peer that made the request.
1214
- * @returns True if the requested block transactions are valid, false otherwise.
1532
+ * @returns True if the request-response is consistent, false otherwise.
1215
1533
  */
1216
- @trackSpan('Libp2pService.validateRequestedBlockTxs', request => ({
1534
+ @trackSpan('Libp2pService.validateRequestedBlockTxsConsistency', request => ({
1217
1535
  [Attributes.BLOCK_ARCHIVE]: request.archiveRoot.toString(),
1218
1536
  }))
1219
- private async validateRequestedBlockTxs(
1537
+ protected async validateRequestedBlockTxsConsistency(
1220
1538
  request: BlockTxsRequest,
1221
1539
  response: BlockTxsResponse,
1222
1540
  peerId: PeerId,
1223
1541
  ): Promise<boolean> {
1224
- const requestedTxValidator = this.createRequestedTxValidator();
1225
-
1226
1542
  try {
1543
+ // A response with archiveRoot=Fr.zero is the documented "I don't have the block" signal from
1544
+ // reqRespBlockTxsHandler (block_txs_handler.ts:54-58): the peer lacked the block in its
1545
+ // attestation pool and archiver, but matched the requested hashes against its tx pool and
1546
+ // shipped what it found. This is legitimate behaviour, not misbehaviour — we just can't verify
1547
+ // membership/order without the block, so we drop the response without penalising the peer.
1548
+ if (response.archiveRoot.isZero()) {
1549
+ this.logger.debug(`Peer ${peerId.toString()} signalled missing block with Fr.zero archive root`);
1550
+ return false;
1551
+ }
1552
+
1227
1553
  if (!response.archiveRoot.equals(request.archiveRoot)) {
1228
1554
  this.peerManager.penalizePeer(peerId, PeerErrorSeverity.MidToleranceError);
1229
1555
  throw new ValidationError(
@@ -1256,18 +1582,26 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1256
1582
  );
1257
1583
  }
1258
1584
 
1259
- // Given proposal (should have locally), ensure returned txs are valid subset and match request indices
1260
- const proposal = await this.mempools.attestationPool.getBlockProposal(request.archiveRoot.toString());
1261
- if (proposal) {
1585
+ // To verify membership/order of the returned txs we need the canonical tx hash list for the
1586
+ // block. Prefer the block proposal (held while a block is in flight), but fall back to the
1587
+ // archiver for blocks we only know as mined — e.g. a prover collecting txs to prove a block it
1588
+ // never received a proposal for. This mirrors the responder side (reqRespBlockTxsHandler),
1589
+ // which serves from proposal-or-archiver.
1590
+ const proposal = await this.mempools.attestationPool.getBlockProposalByArchive(request.archiveRoot.toString());
1591
+ const blockTxHashes =
1592
+ proposal?.txHashes ??
1593
+ (await this.archiver.getBlock({ archive: request.archiveRoot }))?.body.txEffects.map(e => e.txHash);
1594
+
1595
+ if (blockTxHashes) {
1262
1596
  // Build intersected indices
1263
1597
  const intersectIdx = request.txIndices.getTrueIndices().filter(i => response.txIndices.isSet(i));
1264
1598
 
1265
1599
  // Enforce subset membership and preserve increasing order by index.
1266
- const hashToIndexInProposal = new Map<string, number>(
1267
- proposal.txHashes.map((h, i) => [h.toString(), i] as [string, number]),
1600
+ const hashToIndexInBlock = new Map<string, number>(
1601
+ blockTxHashes.map((h, i) => [h.toString(), i] as [string, number]),
1268
1602
  );
1269
1603
  const allowedIndexSet = new Set(intersectIdx);
1270
- const indices = returnedHashes.map(h => hashToIndexInProposal.get(h));
1604
+ const indices = returnedHashes.map(h => hashToIndexInBlock.get(h));
1271
1605
  const allAllowed = indices.every(idx => idx !== undefined && allowedIndexSet.has(idx));
1272
1606
  const strictlyIncreasing = indices.every((idx, i) => (i === 0 ? idx !== undefined : idx! > indices[i - 1]!));
1273
1607
  if (!allAllowed || !strictlyIncreasing) {
@@ -1275,14 +1609,14 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1275
1609
  throw new ValidationError('Returned txs do not match expected subset/order for requested indices');
1276
1610
  }
1277
1611
  } else {
1278
- // No local proposal, cannot check the membership/order of the returned txs
1612
+ // Neither a local proposal nor an archived block: we cannot verify membership/order of the
1613
+ // returned txs. This is a local-state gap, not a peer fault, so we do not penalize.
1279
1614
  this.logger.warn(
1280
- `Block proposal not found for archive root ${request.archiveRoot.toString()}; cannot validate membership/order of returned txs`,
1615
+ `Block ${request.archiveRoot.toString()} not found in attestation pool or archiver; cannot validate membership/order of returned txs`,
1281
1616
  );
1282
1617
  return false;
1283
1618
  }
1284
1619
 
1285
- await Promise.all(response.txs.map(tx => this.validateRequestedTx(tx, peerId, requestedTxValidator)));
1286
1620
  return true;
1287
1621
  } catch (e: any) {
1288
1622
  if (e instanceof ValidationError) {
@@ -1295,151 +1629,8 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1295
1629
  }
1296
1630
  }
1297
1631
 
1298
- /**
1299
- * Validate a collection of txs that has been requested from a peer.
1300
- *
1301
- * The core component of this validator is that each tx hash MUST match the requested tx hash,
1302
- * In order to perform this check, the tx proof must be verified.
1303
- *
1304
- * Note: This function is called from within `ReqResp.sendRequest` as part of the
1305
- * ReqRespSubProtocol.TX subprotocol validation.
1306
- *
1307
- * @param requestedTxHash - The collection of the txs that was requested.
1308
- * @param responseTx - The collection of txs that was received as a response to the request.
1309
- * @param peerId - The peer ID of the peer that sent the tx.
1310
- * @returns True if the whole collection of txs is valid, false otherwise.
1311
- */
1312
- @trackSpan('Libp2pService.validateRequestedTx', (requestedTxHash, _responseTx) => ({
1313
- [Attributes.TX_HASH]: requestedTxHash.toString(),
1314
- }))
1315
- private async validateRequestedTxs(requestedTxHash: TxHash[], responseTx: Tx[], peerId: PeerId): Promise<boolean> {
1316
- const requested = new Set(requestedTxHash.map(h => h.toString()));
1317
- const requestedTxValidator = this.createRequestedTxValidator();
1318
-
1319
- //TODO: (mralj) - this is somewhat naive implementation, if single tx is invalid we consider the whole response invalid.
1320
- // I think we should still extract the valid txs and return them, so that we can still use the response.
1321
- try {
1322
- await Promise.all(responseTx.map(tx => this.validateRequestedTx(tx, peerId, requestedTxValidator, requested)));
1323
- return true;
1324
- } catch (e: any) {
1325
- if (e instanceof ValidationError) {
1326
- this.logger.warn(`Failed to validate requested txs from peer ${peerId.toString()}, reason ${e.message}`);
1327
- } else {
1328
- this.logger.error(`Error during validation of requested txs`, e);
1329
- }
1330
-
1331
- return false;
1332
- }
1333
- }
1334
-
1335
- /**
1336
- * Validates a BLOCK response.
1337
- *
1338
- * If a local copy exists, enforces hash equality. If missing, rejects (no penalty) since the hash cannot be verified.
1339
- * Penalizes on block number mismatch or hash mismatch.
1340
- *
1341
- * @param requestedBlockNumber - The requested block number.
1342
- * @param responseBlock - The block returned by the peer.
1343
- * @param peerId - The peer that returned the block.
1344
- * @returns True if the response is valid, false otherwise.
1345
- */
1346
- @trackSpan('Libp2pService.validateRequestedBlock', (requestedBlockNumber, _responseBlock) => ({
1347
- [Attributes.BLOCK_NUMBER]: requestedBlockNumber.toString(),
1348
- }))
1349
- private async validateRequestedBlock(
1350
- requestedBlockNumber: Fr,
1351
- responseBlock: L2Block,
1352
- peerId: PeerId,
1353
- ): Promise<boolean> {
1354
- try {
1355
- const reqNum = Number(requestedBlockNumber.toString());
1356
- if (responseBlock.number !== reqNum) {
1357
- this.peerManager.penalizePeer(peerId, PeerErrorSeverity.LowToleranceError);
1358
- return false;
1359
- }
1360
-
1361
- const local = await this.archiver.getBlock(BlockNumber(reqNum));
1362
- if (!local) {
1363
- // We are missing the local block; we cannot verify the hash yet. Reject without penalizing.
1364
- // TODO: Consider extending this validator to accept an expected hash or
1365
- // performing quorum-based checks when using P2P syncing prior to L1 sync.
1366
- this.logger.warn(`Local block ${reqNum} not found; rejecting BLOCK response without hash verification`);
1367
- return false;
1368
- }
1369
- const [localHash, respHash] = await Promise.all([local.hash(), responseBlock.hash()]);
1370
- if (!localHash.equals(respHash)) {
1371
- this.peerManager.penalizePeer(peerId, PeerErrorSeverity.MidToleranceError);
1372
- return false;
1373
- }
1374
-
1375
- return true;
1376
- } catch (e) {
1377
- this.logger.warn(`Error validating requested block`, e);
1378
- return false;
1379
- }
1380
- }
1381
-
1382
- private async validateRequestedTx(tx: Tx, peerId: PeerId, txValidator: TxValidator, requested?: Set<`0x${string}`>) {
1383
- const penalize = (severity: PeerErrorSeverity) => this.peerManager.penalizePeer(peerId, severity);
1384
- if (requested && !requested.has(tx.getTxHash().toString())) {
1385
- penalize(PeerErrorSeverity.MidToleranceError);
1386
- throw new ValidationError(`Received tx with hash ${tx.getTxHash().toString()} that was not requested.`);
1387
- }
1388
-
1389
- const { result } = await txValidator.validateTx(tx);
1390
- if (result === 'invalid') {
1391
- penalize(PeerErrorSeverity.LowToleranceError);
1392
- throw new ValidationError(`Received tx with hash ${tx.getTxHash().toString()} that is invalid.`);
1393
- }
1394
- }
1395
-
1396
- private createRequestedTxValidator(): TxValidator {
1397
- return createTxReqRespValidator(this.proofVerifier, {
1398
- l1ChainId: this.config.l1ChainId,
1399
- rollupVersion: this.config.rollupVersion,
1400
- });
1401
- }
1402
-
1403
- @trackSpan('Libp2pService.validatePropagatedTx', tx => ({
1404
- [Attributes.TX_HASH]: tx.getTxHash().toString(),
1405
- }))
1406
- private async validatePropagatedTx(tx: Tx, peerId: PeerId): Promise<boolean> {
1407
- const currentBlockNumber = await this.archiver.getBlockNumber();
1408
-
1409
- // We accept transactions if they are not expired by the next slot (checked based on the IncludeByTimestamp field)
1410
- const { ts: nextSlotTimestamp } = this.epochCache.getEpochAndSlotInNextL1Slot();
1411
- const messageValidators = await this.createMessageValidators(currentBlockNumber, nextSlotTimestamp);
1412
-
1413
- for (const validator of messageValidators) {
1414
- const outcome = await this.runValidations(tx, validator);
1415
-
1416
- if (outcome.allPassed) {
1417
- continue;
1418
- }
1419
- const { name } = outcome.failure;
1420
- let { severity } = outcome.failure;
1421
-
1422
- // Double spend validator has a special case handler
1423
- if (name === 'doubleSpendValidator') {
1424
- const txBlockNumber = BlockNumber(currentBlockNumber + 1); // tx is expected to be in the next block
1425
- severity = await this.handleDoubleSpendFailure(tx, txBlockNumber);
1426
- }
1427
-
1428
- this.peerManager.penalizePeer(peerId, severity);
1429
- return false;
1430
- }
1431
- return true;
1432
- }
1433
-
1434
- private async getGasFees(blockNumber: BlockNumber): Promise<GasFees> {
1435
- if (blockNumber === this.feesCache?.blockNumber) {
1436
- return this.feesCache.gasFees;
1437
- }
1438
-
1439
- const header = await this.archiver.getBlockHeader(blockNumber);
1440
- const gasFees = header?.globalVariables.gasFees ?? GasFees.empty();
1441
- this.feesCache = { blockNumber, gasFees };
1442
- return gasFees;
1632
+ private getGasFees(): Promise<GasFees> {
1633
+ return this.blockMinFeesProvider.getCurrentMinFees();
1443
1634
  }
1444
1635
 
1445
1636
  /**
@@ -1453,65 +1644,70 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1453
1644
  l1ChainId: this.config.l1ChainId,
1454
1645
  rollupVersion: this.config.rollupVersion,
1455
1646
  proofVerifier: this.proofVerifier,
1647
+ txValidationCache: this.txValidationCache,
1456
1648
  },
1457
1649
  peerScoring: this.peerManager,
1650
+ validateRequestedBlockTxsConsistency: this.validateRequestedBlockTxsConsistency.bind(this),
1458
1651
  };
1459
1652
  }
1460
1653
 
1461
- public async validate(txs: Tx[]): Promise<void> {
1462
- const currentBlockNumber = await this.archiver.getBlockNumber();
1463
-
1464
- // We accept transactions if they are not expired by the next slot (checked based on the IncludeByTimestamp field)
1465
- const { ts: nextSlotTimestamp } = this.epochCache.getEpochAndSlotInNextL1Slot();
1466
- const messageValidators = await this.createMessageValidators(currentBlockNumber, nextSlotTimestamp);
1654
+ public async validateTxsReceivedInBlockProposal(txs: Tx[]): Promise<void> {
1655
+ const validator = createTxValidatorForBlockProposalReceivedTxs(
1656
+ this.proofVerifier,
1657
+ { l1ChainId: this.config.l1ChainId, rollupVersion: this.config.rollupVersion },
1658
+ this.logger.getBindings(),
1659
+ this.txValidationCache,
1660
+ );
1467
1661
 
1468
- await Promise.all(
1662
+ const results = await Promise.all(
1469
1663
  txs.map(async tx => {
1470
- for (const validator of messageValidators) {
1471
- const outcome = await this.runValidations(tx, validator);
1472
- if (!outcome.allPassed) {
1473
- throw new Error('Invalid tx detected', { cause: { outcome } });
1474
- }
1475
- }
1664
+ const result = await validator.validateTx(tx);
1665
+ return result.result !== 'invalid';
1476
1666
  }),
1477
1667
  );
1668
+ if (results.some(value => value === false)) {
1669
+ throw new Error('Invalid tx detected');
1670
+ }
1478
1671
  }
1479
1672
 
1480
- /**
1481
- * Create message validators for the given block number and timestamp.
1482
- *
1483
- * Each validator is a pair of a validator and a severity.
1484
- * If a validator fails, the peer is penalized with the severity of the validator.
1485
- *
1486
- * @param currentBlockNumber - The current synced block number.
1487
- * @param nextSlotTimestamp - The timestamp of the next slot (used to validate txs are not expired).
1488
- * @returns The message validators.
1489
- */
1490
- private async createMessageValidators(
1673
+ /** Creates the first stage (fast) validators for gossiped transactions. */
1674
+ protected async createFirstStageMessageValidators(
1491
1675
  currentBlockNumber: BlockNumber,
1492
1676
  nextSlotTimestamp: UInt64,
1493
- ): Promise<Record<string, MessageValidator>[]> {
1494
- const gasFees = await this.getGasFees(currentBlockNumber);
1495
- const allowedInSetup = this.config.txPublicSetupAllowList ?? (await getDefaultAllowedSetupFunctions());
1496
-
1497
- const blockNumberInWhichTheTxIsConsideredToBeIncluded = BlockNumber(currentBlockNumber + 1);
1498
-
1499
- return createTxMessageValidators(
1677
+ ): Promise<Record<string, TransactionValidator>> {
1678
+ const gasFees = await this.getGasFees();
1679
+ const allowedInSetup = [
1680
+ ...(await getDefaultAllowedSetupFunctions()),
1681
+ ...(this.config.txPublicSetupAllowListExtend ?? []),
1682
+ ];
1683
+ const blockNumber = BlockNumber(currentBlockNumber + 1);
1684
+ const l1Constants = await this.archiver.getL1Constants();
1685
+
1686
+ return createFirstStageTxValidationsForGossipedTransactions(
1500
1687
  nextSlotTimestamp,
1501
- blockNumberInWhichTheTxIsConsideredToBeIncluded,
1688
+ blockNumber,
1502
1689
  this.worldStateSynchronizer,
1503
1690
  gasFees,
1504
1691
  this.config.l1ChainId,
1505
1692
  this.config.rollupVersion,
1506
1693
  protocolContractsHash,
1507
1694
  this.archiver,
1508
- this.proofVerifier,
1509
1695
  !this.config.disableTransactions,
1510
1696
  allowedInSetup,
1511
1697
  this.logger.getBindings(),
1698
+ {
1699
+ rollupManaLimit: l1Constants.rollupManaLimit,
1700
+ maxBlockL2Gas: this.config.validateMaxL2BlockGas,
1701
+ maxBlockDAGas: this.config.validateMaxDABlockGas,
1702
+ },
1512
1703
  );
1513
1704
  }
1514
1705
 
1706
+ /** Creates the second stage (expensive proof verification) validators for gossiped transactions. */
1707
+ protected createSecondStageMessageValidators(): Record<string, TransactionValidator> {
1708
+ return createSecondStageTxValidationsForGossipedTransactions(this.proofVerifier, this.logger.getBindings());
1709
+ }
1710
+
1515
1711
  /**
1516
1712
  * Run validations on a tx.
1517
1713
  * @param tx - The tx to validate.
@@ -1520,7 +1716,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1520
1716
  */
1521
1717
  private async runValidations(
1522
1718
  tx: Tx,
1523
- messageValidators: Record<string, MessageValidator>,
1719
+ messageValidators: Record<string, TransactionValidator>,
1524
1720
  ): Promise<ValidationOutcome> {
1525
1721
  const validationPromises = Object.entries(messageValidators).map(async ([name, { validator, severity }]) => {
1526
1722
  const { result } = await validator.validateTx(tx);
@@ -1529,8 +1725,10 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1529
1725
 
1530
1726
  // A promise that resolves when all validations have been run
1531
1727
  const allValidations = await Promise.all(validationPromises);
1532
- const failed = allValidations.find(x => !x.isValid);
1533
- if (failed) {
1728
+ const failures = allValidations.filter(x => !x.isValid);
1729
+ if (failures.length > 0) {
1730
+ // Pick the most severe failure (lowest tolerance = harshest penalty)
1731
+ const failed = maxBy(failures, f => PeerErrorSeverityByHarshness.indexOf(f.severity))!;
1534
1732
  return {
1535
1733
  allPassed: false,
1536
1734
  failure: {
@@ -1583,74 +1781,6 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1583
1781
  return PeerErrorSeverity.HighToleranceError;
1584
1782
  }
1585
1783
 
1586
- /**
1587
- * Validate a checkpoint attestation.
1588
- *
1589
- * @param attestation - The checkpoint attestation to validate.
1590
- * @returns True if the checkpoint attestation is valid, false otherwise.
1591
- */
1592
- @trackSpan('Libp2pService.validateCheckpointAttestation', async (_, attestation) => ({
1593
- [Attributes.SLOT_NUMBER]: attestation.payload.header.slotNumber,
1594
- [Attributes.BLOCK_ARCHIVE]: attestation.archive.toString(),
1595
- [Attributes.P2P_ID]: await attestation.p2pMessageLoggingIdentifier().then(i => i.toString()),
1596
- }))
1597
- public async validateCheckpointAttestation(
1598
- peerId: PeerId,
1599
- attestation: CheckpointAttestation,
1600
- ): Promise<P2PValidationResult> {
1601
- const result = await this.checkpointAttestationValidator.validate(attestation);
1602
-
1603
- if (result.result === 'reject') {
1604
- this.logger.debug(`Penalizing peer ${peerId} for checkpoint attestation validation failure`);
1605
- this.peerManager.penalizePeer(peerId, result.severity);
1606
- }
1607
-
1608
- return result;
1609
- }
1610
-
1611
- /**
1612
- * Validate a block proposal.
1613
- *
1614
- * @param block - The block proposal to validate.
1615
- * @returns True if the block proposal is valid, false otherwise.
1616
- */
1617
- @trackSpan('Libp2pService.validateBlockProposal', (_peerId, block) => ({
1618
- [Attributes.SLOT_NUMBER]: block.slotNumber.toString(),
1619
- }))
1620
- public async validateBlockProposal(peerId: PeerId, block: BlockProposal): Promise<P2PValidationResult> {
1621
- const result = await this.blockProposalValidator.validate(block);
1622
-
1623
- if (result.result === 'reject') {
1624
- this.logger.debug(`Penalizing peer ${peerId} for block proposal validation failure`);
1625
- this.peerManager.penalizePeer(peerId, result.severity);
1626
- }
1627
-
1628
- return result;
1629
- }
1630
-
1631
- /**
1632
- * Validate a checkpoint proposal.
1633
- *
1634
- * @param checkpoint - The checkpoint proposal to validate.
1635
- * @returns True if the checkpoint proposal is valid, false otherwise.
1636
- */
1637
- @trackSpan('Libp2pService.validateCheckpointProposal', (_peerId, checkpoint) => ({
1638
- [Attributes.SLOT_NUMBER]: checkpoint.slotNumber.toString(),
1639
- }))
1640
- public async validateCheckpointProposal(
1641
- peerId: PeerId,
1642
- checkpoint: CheckpointProposal,
1643
- ): Promise<P2PValidationResult> {
1644
- const result = await this.checkpointProposalValidator.validate(checkpoint);
1645
-
1646
- if (result.result === 'reject') {
1647
- this.logger.debug(`Penalizing peer ${peerId} for checkpoint proposal validation failure`);
1648
- this.peerManager.penalizePeer(peerId, result.severity);
1649
- }
1650
-
1651
- return result;
1652
- }
1653
-
1654
1784
  public getPeerScore(peerId: PeerId): number {
1655
1785
  return this.node.services.pubsub.score.score(peerId.toString());
1656
1786
  }