@aztec/p2p 0.0.1-commit.d3ec352c → 0.0.1-commit.d58ff9d0

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 (575) hide show
  1. package/README.md +130 -3
  2. package/dest/bootstrap/bootstrap.d.ts +4 -3
  3. package/dest/bootstrap/bootstrap.d.ts.map +1 -1
  4. package/dest/bootstrap/bootstrap.js +26 -10
  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 +70 -21
  8. package/dest/client/interface.d.ts +104 -41
  9. package/dest/client/interface.d.ts.map +1 -1
  10. package/dest/client/p2p_client.d.ts +72 -70
  11. package/dest/client/p2p_client.d.ts.map +1 -1
  12. package/dest/client/p2p_client.js +681 -346
  13. package/dest/config.d.ts +171 -89
  14. package/dest/config.d.ts.map +1 -1
  15. package/dest/config.js +169 -58
  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 +9 -16
  20. package/dest/errors/reqresp.error.d.ts.map +1 -1
  21. package/dest/errors/reqresp.error.js +10 -17
  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 +154 -77
  29. package/dest/mem_pools/attestation_pool/attestation_pool.d.ts.map +1 -1
  30. package/dest/mem_pools/attestation_pool/attestation_pool.js +518 -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 +694 -295
  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 +11 -8
  38. package/dest/mem_pools/attestation_pool/mocks.d.ts.map +1 -1
  39. package/dest/mem_pools/attestation_pool/mocks.js +19 -13
  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 +14 -1
  44. package/dest/mem_pools/instrumentation.d.ts.map +1 -1
  45. package/dest/mem_pools/instrumentation.js +51 -12
  46. package/dest/mem_pools/interface.d.ts +6 -7
  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 +39 -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 +97 -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_v2/eviction/invalid_txs_after_mining_rule.js +65 -0
  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 +243 -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 +11 -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 +122 -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 +368 -0
  108. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts +68 -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 +178 -0
  111. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts +91 -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 +1013 -0
  114. package/dest/msg_validators/attestation_validator/attestation_validator.d.ts +12 -5
  115. package/dest/msg_validators/attestation_validator/attestation_validator.d.ts.map +1 -1
  116. package/dest/msg_validators/attestation_validator/attestation_validator.js +78 -22
  117. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts +11 -7
  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 +25 -17
  120. package/dest/msg_validators/index.d.ts +2 -2
  121. package/dest/msg_validators/index.d.ts.map +1 -1
  122. package/dest/msg_validators/index.js +1 -1
  123. package/dest/msg_validators/proposal_validator/block_proposal_validator.d.ts +16 -0
  124. package/dest/msg_validators/proposal_validator/block_proposal_validator.d.ts.map +1 -0
  125. package/dest/msg_validators/proposal_validator/block_proposal_validator.js +14 -0
  126. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.d.ts +16 -0
  127. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.d.ts.map +1 -0
  128. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.js +26 -0
  129. package/dest/msg_validators/proposal_validator/index.d.ts +4 -0
  130. package/dest/msg_validators/proposal_validator/index.d.ts.map +1 -0
  131. package/dest/msg_validators/proposal_validator/index.js +3 -0
  132. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts +40 -0
  133. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts.map +1 -0
  134. package/dest/msg_validators/proposal_validator/proposal_validator.js +186 -0
  135. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts +4 -4
  136. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts.map +1 -1
  137. package/dest/msg_validators/tx_validator/aggregate_tx_validator.js +11 -18
  138. package/dest/msg_validators/tx_validator/allowed_public_setup.d.ts +2 -1
  139. package/dest/msg_validators/tx_validator/allowed_public_setup.d.ts.map +1 -1
  140. package/dest/msg_validators/tx_validator/allowed_public_setup.js +25 -21
  141. package/dest/msg_validators/tx_validator/allowed_setup_helpers.d.ts +17 -0
  142. package/dest/msg_validators/tx_validator/allowed_setup_helpers.d.ts.map +1 -0
  143. package/dest/msg_validators/tx_validator/allowed_setup_helpers.js +24 -0
  144. package/dest/msg_validators/tx_validator/archive_cache.d.ts +3 -3
  145. package/dest/msg_validators/tx_validator/archive_cache.d.ts.map +1 -1
  146. package/dest/msg_validators/tx_validator/block_header_validator.d.ts +20 -6
  147. package/dest/msg_validators/tx_validator/block_header_validator.d.ts.map +1 -1
  148. package/dest/msg_validators/tx_validator/block_header_validator.js +4 -3
  149. package/dest/msg_validators/tx_validator/cached_tx_validator.d.ts +15 -0
  150. package/dest/msg_validators/tx_validator/cached_tx_validator.d.ts.map +1 -0
  151. package/dest/msg_validators/tx_validator/cached_tx_validator.js +19 -0
  152. package/dest/msg_validators/tx_validator/contract_instance_validator.d.ts +9 -0
  153. package/dest/msg_validators/tx_validator/contract_instance_validator.d.ts.map +1 -0
  154. package/dest/msg_validators/tx_validator/contract_instance_validator.js +48 -0
  155. package/dest/msg_validators/tx_validator/data_validator.d.ts +4 -1
  156. package/dest/msg_validators/tx_validator/data_validator.d.ts.map +1 -1
  157. package/dest/msg_validators/tx_validator/data_validator.js +40 -3
  158. package/dest/msg_validators/tx_validator/double_spend_validator.d.ts +15 -4
  159. package/dest/msg_validators/tx_validator/double_spend_validator.d.ts.map +1 -1
  160. package/dest/msg_validators/tx_validator/double_spend_validator.js +7 -6
  161. package/dest/msg_validators/tx_validator/factory.d.ts +137 -6
  162. package/dest/msg_validators/tx_validator/factory.d.ts.map +1 -1
  163. package/dest/msg_validators/tx_validator/factory.js +268 -58
  164. package/dest/msg_validators/tx_validator/fee_payer_balance.d.ts +10 -0
  165. package/dest/msg_validators/tx_validator/fee_payer_balance.d.ts.map +1 -0
  166. package/dest/msg_validators/tx_validator/fee_payer_balance.js +24 -0
  167. package/dest/msg_validators/tx_validator/gas_validator.d.ts +105 -3
  168. package/dest/msg_validators/tx_validator/gas_validator.d.ts.map +1 -1
  169. package/dest/msg_validators/tx_validator/gas_validator.js +146 -67
  170. package/dest/msg_validators/tx_validator/index.d.ts +6 -1
  171. package/dest/msg_validators/tx_validator/index.d.ts.map +1 -1
  172. package/dest/msg_validators/tx_validator/index.js +5 -0
  173. package/dest/msg_validators/tx_validator/metadata_validator.d.ts +4 -3
  174. package/dest/msg_validators/tx_validator/metadata_validator.d.ts.map +1 -1
  175. package/dest/msg_validators/tx_validator/metadata_validator.js +6 -6
  176. package/dest/msg_validators/tx_validator/nullifier_cache.d.ts +14 -0
  177. package/dest/msg_validators/tx_validator/nullifier_cache.d.ts.map +1 -0
  178. package/dest/msg_validators/tx_validator/nullifier_cache.js +24 -0
  179. package/dest/msg_validators/tx_validator/phases_validator.d.ts +24 -3
  180. package/dest/msg_validators/tx_validator/phases_validator.d.ts.map +1 -1
  181. package/dest/msg_validators/tx_validator/phases_validator.js +75 -27
  182. package/dest/msg_validators/tx_validator/size_validator.d.ts +8 -0
  183. package/dest/msg_validators/tx_validator/size_validator.d.ts.map +1 -0
  184. package/dest/msg_validators/tx_validator/size_validator.js +23 -0
  185. package/dest/msg_validators/tx_validator/test_utils.d.ts +2 -2
  186. package/dest/msg_validators/tx_validator/test_utils.d.ts.map +1 -1
  187. package/dest/msg_validators/tx_validator/timestamp_validator.d.ts +22 -5
  188. package/dest/msg_validators/tx_validator/timestamp_validator.d.ts.map +1 -1
  189. package/dest/msg_validators/tx_validator/timestamp_validator.js +8 -8
  190. package/dest/msg_validators/tx_validator/tx_permitted_validator.d.ts +3 -2
  191. package/dest/msg_validators/tx_validator/tx_permitted_validator.d.ts.map +1 -1
  192. package/dest/msg_validators/tx_validator/tx_permitted_validator.js +2 -2
  193. package/dest/msg_validators/tx_validator/tx_proof_validator.d.ts +4 -2
  194. package/dest/msg_validators/tx_validator/tx_proof_validator.d.ts.map +1 -1
  195. package/dest/msg_validators/tx_validator/tx_proof_validator.js +4 -2
  196. package/dest/msg_validators/tx_validator/tx_validation_cache.d.ts +48 -0
  197. package/dest/msg_validators/tx_validator/tx_validation_cache.d.ts.map +1 -0
  198. package/dest/msg_validators/tx_validator/tx_validation_cache.js +68 -0
  199. package/dest/services/data_store.d.ts +1 -1
  200. package/dest/services/data_store.d.ts.map +1 -1
  201. package/dest/services/data_store.js +14 -10
  202. package/dest/services/discv5/discV5_service.d.ts +13 -2
  203. package/dest/services/discv5/discV5_service.d.ts.map +1 -1
  204. package/dest/services/discv5/discV5_service.js +120 -24
  205. package/dest/services/discv5/persisted_enr_store.d.ts +38 -0
  206. package/dest/services/discv5/persisted_enr_store.d.ts.map +1 -0
  207. package/dest/services/discv5/persisted_enr_store.js +145 -0
  208. package/dest/services/dummy_service.d.ts +40 -16
  209. package/dest/services/dummy_service.d.ts.map +1 -1
  210. package/dest/services/dummy_service.js +61 -14
  211. package/dest/services/encoding.d.ts +24 -7
  212. package/dest/services/encoding.d.ts.map +1 -1
  213. package/dest/services/encoding.js +48 -30
  214. package/dest/services/gossipsub/index.d.ts +3 -0
  215. package/dest/services/gossipsub/index.d.ts.map +1 -0
  216. package/dest/services/gossipsub/index.js +2 -0
  217. package/dest/services/gossipsub/scoring.d.ts +21 -3
  218. package/dest/services/gossipsub/scoring.d.ts.map +1 -1
  219. package/dest/services/gossipsub/scoring.js +24 -7
  220. package/dest/services/gossipsub/topic_score_params.d.ts +167 -0
  221. package/dest/services/gossipsub/topic_score_params.d.ts.map +1 -0
  222. package/dest/services/gossipsub/topic_score_params.js +336 -0
  223. package/dest/services/index.d.ts +2 -1
  224. package/dest/services/index.d.ts.map +1 -1
  225. package/dest/services/index.js +1 -0
  226. package/dest/services/libp2p/instrumentation.d.ts +3 -1
  227. package/dest/services/libp2p/instrumentation.d.ts.map +1 -1
  228. package/dest/services/libp2p/instrumentation.js +43 -71
  229. package/dest/services/libp2p/libp2p_service.d.ts +127 -54
  230. package/dest/services/libp2p/libp2p_service.d.ts.map +1 -1
  231. package/dest/services/libp2p/libp2p_service.js +1324 -556
  232. package/dest/services/peer-manager/metrics.d.ts +9 -2
  233. package/dest/services/peer-manager/metrics.d.ts.map +1 -1
  234. package/dest/services/peer-manager/metrics.js +39 -21
  235. package/dest/services/peer-manager/peer_manager.d.ts +21 -4
  236. package/dest/services/peer-manager/peer_manager.d.ts.map +1 -1
  237. package/dest/services/peer-manager/peer_manager.js +87 -38
  238. package/dest/services/peer-manager/peer_scoring.d.ts +34 -2
  239. package/dest/services/peer-manager/peer_scoring.d.ts.map +1 -1
  240. package/dest/services/peer-manager/peer_scoring.js +134 -19
  241. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts +44 -0
  242. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts.map +1 -0
  243. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.js +534 -0
  244. package/dest/services/reqresp/batch-tx-requester/config.d.ts +17 -0
  245. package/dest/services/reqresp/batch-tx-requester/config.d.ts.map +1 -0
  246. package/dest/services/reqresp/batch-tx-requester/config.js +27 -0
  247. package/dest/services/reqresp/batch-tx-requester/interface.d.ts +50 -0
  248. package/dest/services/reqresp/batch-tx-requester/interface.d.ts.map +1 -0
  249. package/dest/services/reqresp/batch-tx-requester/interface.js +1 -0
  250. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts +35 -0
  251. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts.map +1 -0
  252. package/dest/services/reqresp/batch-tx-requester/missing_txs.js +136 -0
  253. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts +62 -0
  254. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts.map +1 -0
  255. package/dest/services/reqresp/batch-tx-requester/peer_collection.js +176 -0
  256. package/dest/services/reqresp/batch-tx-requester/tx_validator.d.ts +11 -0
  257. package/dest/services/reqresp/batch-tx-requester/tx_validator.d.ts.map +1 -0
  258. package/dest/services/reqresp/batch-tx-requester/tx_validator.js +7 -0
  259. package/dest/services/reqresp/config.d.ts +15 -3
  260. package/dest/services/reqresp/config.d.ts.map +1 -1
  261. package/dest/services/reqresp/config.js +11 -0
  262. package/dest/services/reqresp/connection-sampler/connection_sampler.d.ts +2 -1
  263. package/dest/services/reqresp/connection-sampler/connection_sampler.d.ts.map +1 -1
  264. package/dest/services/reqresp/connection-sampler/connection_sampler.js +12 -0
  265. package/dest/services/reqresp/constants.d.ts +12 -0
  266. package/dest/services/reqresp/constants.d.ts.map +1 -0
  267. package/dest/services/reqresp/constants.js +7 -0
  268. package/dest/services/reqresp/interface.d.ts +27 -18
  269. package/dest/services/reqresp/interface.d.ts.map +1 -1
  270. package/dest/services/reqresp/interface.js +23 -19
  271. package/dest/services/reqresp/metrics.d.ts +6 -5
  272. package/dest/services/reqresp/metrics.d.ts.map +1 -1
  273. package/dest/services/reqresp/metrics.js +16 -21
  274. package/dest/services/reqresp/protocols/auth.d.ts +2 -2
  275. package/dest/services/reqresp/protocols/auth.d.ts.map +1 -1
  276. package/dest/services/reqresp/protocols/auth.js +2 -2
  277. package/dest/services/reqresp/protocols/block_txs/bitvector.d.ts +8 -3
  278. package/dest/services/reqresp/protocols/block_txs/bitvector.d.ts.map +1 -1
  279. package/dest/services/reqresp/protocols/block_txs/bitvector.js +15 -2
  280. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts +7 -5
  281. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts.map +1 -1
  282. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.js +35 -14
  283. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts +37 -9
  284. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts.map +1 -1
  285. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.js +85 -21
  286. package/dest/services/reqresp/protocols/index.d.ts +1 -2
  287. package/dest/services/reqresp/protocols/index.d.ts.map +1 -1
  288. package/dest/services/reqresp/protocols/index.js +0 -1
  289. package/dest/services/reqresp/protocols/status.d.ts +1 -1
  290. package/dest/services/reqresp/protocols/status.d.ts.map +1 -1
  291. package/dest/services/reqresp/protocols/status.js +4 -1
  292. package/dest/services/reqresp/protocols/tx.d.ts +8 -3
  293. package/dest/services/reqresp/protocols/tx.d.ts.map +1 -1
  294. package/dest/services/reqresp/protocols/tx.js +21 -3
  295. package/dest/services/reqresp/rate-limiter/rate_limiter.d.ts +5 -4
  296. package/dest/services/reqresp/rate-limiter/rate_limiter.d.ts.map +1 -1
  297. package/dest/services/reqresp/rate-limiter/rate_limiter.js +10 -8
  298. package/dest/services/reqresp/rate-limiter/rate_limits.d.ts +1 -1
  299. package/dest/services/reqresp/rate-limiter/rate_limits.d.ts.map +1 -1
  300. package/dest/services/reqresp/rate-limiter/rate_limits.js +3 -13
  301. package/dest/services/reqresp/reqresp.d.ts +12 -29
  302. package/dest/services/reqresp/reqresp.d.ts.map +1 -1
  303. package/dest/services/reqresp/reqresp.js +480 -200
  304. package/dest/services/service.d.ts +78 -13
  305. package/dest/services/service.d.ts.map +1 -1
  306. package/dest/services/tx_collection/config.d.ts +11 -11
  307. package/dest/services/tx_collection/config.d.ts.map +1 -1
  308. package/dest/services/tx_collection/config.js +28 -27
  309. package/dest/services/tx_collection/file_store_tx_collection.d.ts +37 -0
  310. package/dest/services/tx_collection/file_store_tx_collection.d.ts.map +1 -0
  311. package/dest/services/tx_collection/file_store_tx_collection.js +127 -0
  312. package/dest/services/tx_collection/file_store_tx_source.d.ts +38 -0
  313. package/dest/services/tx_collection/file_store_tx_source.d.ts.map +1 -0
  314. package/dest/services/tx_collection/file_store_tx_source.js +100 -0
  315. package/dest/services/tx_collection/index.d.ts +3 -2
  316. package/dest/services/tx_collection/index.d.ts.map +1 -1
  317. package/dest/services/tx_collection/index.js +1 -0
  318. package/dest/services/tx_collection/instrumentation.d.ts +1 -1
  319. package/dest/services/tx_collection/instrumentation.d.ts.map +1 -1
  320. package/dest/services/tx_collection/instrumentation.js +9 -13
  321. package/dest/services/tx_collection/request_tracker.d.ts +53 -0
  322. package/dest/services/tx_collection/request_tracker.d.ts.map +1 -0
  323. package/dest/services/tx_collection/request_tracker.js +84 -0
  324. package/dest/services/tx_collection/tx_collection.d.ts +49 -55
  325. package/dest/services/tx_collection/tx_collection.d.ts.map +1 -1
  326. package/dest/services/tx_collection/tx_collection.js +299 -71
  327. package/dest/services/tx_collection/tx_collection_sink.d.ts +19 -9
  328. package/dest/services/tx_collection/tx_collection_sink.d.ts.map +1 -1
  329. package/dest/services/tx_collection/tx_collection_sink.js +28 -31
  330. package/dest/services/tx_collection/tx_source.d.ts +13 -7
  331. package/dest/services/tx_collection/tx_source.d.ts.map +1 -1
  332. package/dest/services/tx_collection/tx_source.js +29 -7
  333. package/dest/services/tx_file_store/config.d.ts +16 -0
  334. package/dest/services/tx_file_store/config.d.ts.map +1 -0
  335. package/dest/services/tx_file_store/config.js +22 -0
  336. package/dest/services/tx_file_store/index.d.ts +4 -0
  337. package/dest/services/tx_file_store/index.d.ts.map +1 -0
  338. package/dest/services/tx_file_store/index.js +3 -0
  339. package/dest/services/tx_file_store/instrumentation.d.ts +15 -0
  340. package/dest/services/tx_file_store/instrumentation.d.ts.map +1 -0
  341. package/dest/services/tx_file_store/instrumentation.js +29 -0
  342. package/dest/services/tx_file_store/tx_file_store.d.ts +46 -0
  343. package/dest/services/tx_file_store/tx_file_store.d.ts.map +1 -0
  344. package/dest/services/tx_file_store/tx_file_store.js +142 -0
  345. package/dest/services/tx_provider.d.ts +9 -6
  346. package/dest/services/tx_provider.d.ts.map +1 -1
  347. package/dest/services/tx_provider.js +23 -10
  348. package/dest/services/tx_provider_instrumentation.d.ts +5 -2
  349. package/dest/services/tx_provider_instrumentation.d.ts.map +1 -1
  350. package/dest/services/tx_provider_instrumentation.js +14 -14
  351. package/dest/test-helpers/index.d.ts +3 -1
  352. package/dest/test-helpers/index.d.ts.map +1 -1
  353. package/dest/test-helpers/index.js +2 -0
  354. package/dest/test-helpers/make-test-p2p-clients.d.ts +7 -8
  355. package/dest/test-helpers/make-test-p2p-clients.d.ts.map +1 -1
  356. package/dest/test-helpers/make-test-p2p-clients.js +5 -3
  357. package/dest/test-helpers/mock-pubsub.d.ts +46 -6
  358. package/dest/test-helpers/mock-pubsub.d.ts.map +1 -1
  359. package/dest/test-helpers/mock-pubsub.js +115 -14
  360. package/dest/test-helpers/mock-tx-helpers.js +1 -1
  361. package/dest/test-helpers/reqresp-nodes.d.ts +5 -7
  362. package/dest/test-helpers/reqresp-nodes.d.ts.map +1 -1
  363. package/dest/test-helpers/reqresp-nodes.js +19 -20
  364. package/dest/test-helpers/test_tx_provider.d.ts +42 -0
  365. package/dest/test-helpers/test_tx_provider.d.ts.map +1 -0
  366. package/dest/test-helpers/test_tx_provider.js +44 -0
  367. package/dest/test-helpers/testbench-utils.d.ts +164 -0
  368. package/dest/test-helpers/testbench-utils.d.ts.map +1 -0
  369. package/dest/test-helpers/testbench-utils.js +400 -0
  370. package/dest/testbench/p2p_client_testbench_worker.d.ts +26 -2
  371. package/dest/testbench/p2p_client_testbench_worker.d.ts.map +1 -1
  372. package/dest/testbench/p2p_client_testbench_worker.js +289 -131
  373. package/dest/testbench/worker_client_manager.d.ts +57 -6
  374. package/dest/testbench/worker_client_manager.d.ts.map +1 -1
  375. package/dest/testbench/worker_client_manager.js +277 -44
  376. package/dest/util.d.ts +13 -8
  377. package/dest/util.d.ts.map +1 -1
  378. package/dest/util.js +35 -14
  379. package/dest/versioning.d.ts +3 -6
  380. package/dest/versioning.d.ts.map +1 -1
  381. package/dest/versioning.js +3 -24
  382. package/package.json +18 -18
  383. package/src/bootstrap/bootstrap.ts +24 -7
  384. package/src/client/factory.ts +141 -46
  385. package/src/client/interface.ts +113 -49
  386. package/src/client/p2p_client.ts +342 -418
  387. package/src/client/test/p2p_client.batch_tx_requester.bench.README.md +197 -0
  388. package/src/config.ts +298 -66
  389. package/src/errors/p2p-service.error.ts +11 -0
  390. package/src/errors/reqresp.error.ts +13 -19
  391. package/src/errors/tx-pool.error.ts +12 -0
  392. package/src/index.ts +1 -1
  393. package/src/mem_pools/attestation_pool/attestation_pool.ts +594 -76
  394. package/src/mem_pools/attestation_pool/attestation_pool_test_suite.ts +796 -329
  395. package/src/mem_pools/attestation_pool/index.ts +9 -2
  396. package/src/mem_pools/attestation_pool/mocks.ts +29 -17
  397. package/src/mem_pools/index.ts +2 -2
  398. package/src/mem_pools/instrumentation.ts +48 -13
  399. package/src/mem_pools/interface.ts +5 -7
  400. package/src/mem_pools/tx_pool_v2/README.md +283 -0
  401. package/src/mem_pools/tx_pool_v2/archive/index.ts +1 -0
  402. package/src/mem_pools/tx_pool_v2/archive/tx_archive.ts +112 -0
  403. package/src/mem_pools/tx_pool_v2/deleted_pool.ts +321 -0
  404. package/src/mem_pools/tx_pool_v2/eviction/eviction_manager.ts +160 -0
  405. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.ts +122 -0
  406. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.ts +125 -0
  407. package/src/mem_pools/tx_pool_v2/eviction/index.ts +28 -0
  408. package/src/mem_pools/tx_pool_v2/eviction/insufficient_fee_per_gas_eviction_rule.ts +65 -0
  409. package/src/mem_pools/tx_pool_v2/eviction/interfaces.ts +219 -0
  410. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.ts +74 -0
  411. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.ts +101 -0
  412. package/src/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.ts +91 -0
  413. package/src/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.ts +99 -0
  414. package/src/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.ts +32 -0
  415. package/src/mem_pools/tx_pool_v2/index.ts +12 -0
  416. package/src/mem_pools/tx_pool_v2/instrumentation.ts +69 -0
  417. package/src/mem_pools/tx_pool_v2/interfaces.ts +274 -0
  418. package/src/mem_pools/tx_pool_v2/tx_metadata.ts +349 -0
  419. package/src/mem_pools/tx_pool_v2/tx_pool_bench_metrics.ts +77 -0
  420. package/src/mem_pools/tx_pool_v2/tx_pool_indices.ts +465 -0
  421. package/src/mem_pools/tx_pool_v2/tx_pool_v2.ts +252 -0
  422. package/src/mem_pools/tx_pool_v2/tx_pool_v2_impl.ts +1215 -0
  423. package/src/msg_validators/attestation_validator/README.md +49 -0
  424. package/src/msg_validators/attestation_validator/attestation_validator.ts +71 -24
  425. package/src/msg_validators/attestation_validator/fisherman_attestation_validator.ts +34 -23
  426. package/src/msg_validators/index.ts +1 -1
  427. package/src/msg_validators/proposal_validator/README.md +123 -0
  428. package/src/msg_validators/proposal_validator/block_proposal_validator.ts +32 -0
  429. package/src/msg_validators/proposal_validator/checkpoint_proposal_validator.ts +49 -0
  430. package/src/msg_validators/proposal_validator/index.ts +3 -0
  431. package/src/msg_validators/proposal_validator/proposal_validator.ts +198 -0
  432. package/src/msg_validators/tx_validator/README.md +129 -0
  433. package/src/msg_validators/tx_validator/aggregate_tx_validator.ts +8 -17
  434. package/src/msg_validators/tx_validator/allowed_public_setup.ts +22 -27
  435. package/src/msg_validators/tx_validator/allowed_setup_helpers.ts +31 -0
  436. package/src/msg_validators/tx_validator/archive_cache.ts +2 -2
  437. package/src/msg_validators/tx_validator/block_header_validator.ts +21 -8
  438. package/src/msg_validators/tx_validator/cached_tx_validator.ts +31 -0
  439. package/src/msg_validators/tx_validator/contract_instance_validator.ts +56 -0
  440. package/src/msg_validators/tx_validator/data_validator.ts +62 -7
  441. package/src/msg_validators/tx_validator/double_spend_validator.ts +15 -9
  442. package/src/msg_validators/tx_validator/factory.ts +431 -57
  443. package/src/msg_validators/tx_validator/fee_payer_balance.ts +44 -0
  444. package/src/msg_validators/tx_validator/gas_validator.ts +206 -76
  445. package/src/msg_validators/tx_validator/index.ts +5 -0
  446. package/src/msg_validators/tx_validator/metadata_validator.ts +31 -12
  447. package/src/msg_validators/tx_validator/nullifier_cache.ts +30 -0
  448. package/src/msg_validators/tx_validator/phases_validator.ts +87 -30
  449. package/src/msg_validators/tx_validator/size_validator.ts +22 -0
  450. package/src/msg_validators/tx_validator/test_utils.ts +1 -1
  451. package/src/msg_validators/tx_validator/timestamp_validator.ts +29 -19
  452. package/src/msg_validators/tx_validator/tx_permitted_validator.ts +8 -3
  453. package/src/msg_validators/tx_validator/tx_proof_validator.ts +10 -3
  454. package/src/msg_validators/tx_validator/tx_validation_cache.ts +101 -0
  455. package/src/services/data_store.ts +14 -19
  456. package/src/services/discv5/discV5_service.ts +127 -15
  457. package/src/services/discv5/persisted_enr_store.ts +158 -0
  458. package/src/services/dummy_service.ts +82 -38
  459. package/src/services/encoding.ts +46 -29
  460. package/src/services/gossipsub/README.md +663 -0
  461. package/src/services/gossipsub/index.ts +2 -0
  462. package/src/services/gossipsub/scoring.ts +29 -5
  463. package/src/services/gossipsub/topic_score_params.ts +478 -0
  464. package/src/services/index.ts +1 -0
  465. package/src/services/libp2p/instrumentation.ts +48 -75
  466. package/src/services/libp2p/libp2p_service.ts +1073 -607
  467. package/src/services/peer-manager/metrics.ts +46 -21
  468. package/src/services/peer-manager/peer_manager.ts +96 -29
  469. package/src/services/peer-manager/peer_scoring.ts +130 -12
  470. package/src/services/reqresp/README.md +194 -0
  471. package/src/services/reqresp/batch-tx-requester/README.md +344 -0
  472. package/src/services/reqresp/batch-tx-requester/batch_tx_requester.ts +660 -0
  473. package/src/services/reqresp/batch-tx-requester/config.ts +40 -0
  474. package/src/services/reqresp/batch-tx-requester/interface.ts +61 -0
  475. package/src/services/reqresp/batch-tx-requester/missing_txs.ts +168 -0
  476. package/src/services/reqresp/batch-tx-requester/peer_collection.ts +249 -0
  477. package/src/services/reqresp/batch-tx-requester/tx_validator.ts +24 -0
  478. package/src/services/reqresp/config.ts +19 -2
  479. package/src/services/reqresp/connection-sampler/connection_sampler.ts +19 -1
  480. package/src/services/reqresp/constants.ts +14 -0
  481. package/src/services/reqresp/interface.ts +48 -46
  482. package/src/services/reqresp/metrics.ts +35 -27
  483. package/src/services/reqresp/protocols/auth.ts +2 -2
  484. package/src/services/reqresp/protocols/block_txs/bitvector.ts +19 -2
  485. package/src/services/reqresp/protocols/block_txs/block_txs_handler.ts +44 -17
  486. package/src/services/reqresp/protocols/block_txs/block_txs_reqresp.ts +109 -17
  487. package/src/services/reqresp/protocols/index.ts +0 -1
  488. package/src/services/reqresp/protocols/status.ts +7 -4
  489. package/src/services/reqresp/protocols/tx.ts +24 -5
  490. package/src/services/reqresp/rate-limiter/rate_limiter.ts +13 -9
  491. package/src/services/reqresp/rate-limiter/rate_limits.ts +3 -13
  492. package/src/services/reqresp/reqresp.ts +107 -223
  493. package/src/services/service.ts +102 -31
  494. package/src/services/tx_collection/config.ts +42 -37
  495. package/src/services/tx_collection/file_store_tx_collection.ts +153 -0
  496. package/src/services/tx_collection/file_store_tx_source.ts +129 -0
  497. package/src/services/tx_collection/index.ts +2 -1
  498. package/src/services/tx_collection/instrumentation.ts +5 -13
  499. package/src/services/tx_collection/request_tracker.ts +127 -0
  500. package/src/services/tx_collection/tx_collection.ts +367 -115
  501. package/src/services/tx_collection/tx_collection_sink.ts +32 -36
  502. package/src/services/tx_collection/tx_source.ts +29 -8
  503. package/src/services/tx_file_store/config.ts +37 -0
  504. package/src/services/tx_file_store/index.ts +3 -0
  505. package/src/services/tx_file_store/instrumentation.ts +36 -0
  506. package/src/services/tx_file_store/tx_file_store.ts +163 -0
  507. package/src/services/tx_provider.ts +34 -13
  508. package/src/services/tx_provider_instrumentation.ts +24 -14
  509. package/src/test-helpers/index.ts +2 -0
  510. package/src/test-helpers/make-test-p2p-clients.ts +7 -6
  511. package/src/test-helpers/mock-pubsub.ts +138 -15
  512. package/src/test-helpers/mock-tx-helpers.ts +1 -1
  513. package/src/test-helpers/reqresp-nodes.ts +18 -30
  514. package/src/test-helpers/test_tx_provider.ts +69 -0
  515. package/src/test-helpers/testbench-utils.ts +465 -0
  516. package/src/testbench/p2p_client_testbench_worker.ts +406 -130
  517. package/src/testbench/worker_client_manager.ts +355 -46
  518. package/src/util.ts +40 -19
  519. package/src/versioning.ts +3 -33
  520. package/dest/mem_pools/attestation_pool/kv_attestation_pool.d.ts +0 -37
  521. package/dest/mem_pools/attestation_pool/kv_attestation_pool.d.ts.map +0 -1
  522. package/dest/mem_pools/attestation_pool/kv_attestation_pool.js +0 -213
  523. package/dest/mem_pools/attestation_pool/memory_attestation_pool.d.ts +0 -30
  524. package/dest/mem_pools/attestation_pool/memory_attestation_pool.d.ts.map +0 -1
  525. package/dest/mem_pools/attestation_pool/memory_attestation_pool.js +0 -219
  526. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.d.ts +0 -116
  527. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.d.ts.map +0 -1
  528. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.js +0 -617
  529. package/dest/mem_pools/tx_pool/index.d.ts +0 -4
  530. package/dest/mem_pools/tx_pool/index.d.ts.map +0 -1
  531. package/dest/mem_pools/tx_pool/index.js +0 -3
  532. package/dest/mem_pools/tx_pool/memory_tx_pool.d.ts +0 -81
  533. package/dest/mem_pools/tx_pool/memory_tx_pool.d.ts.map +0 -1
  534. package/dest/mem_pools/tx_pool/memory_tx_pool.js +0 -239
  535. package/dest/mem_pools/tx_pool/priority.d.ts +0 -8
  536. package/dest/mem_pools/tx_pool/priority.d.ts.map +0 -1
  537. package/dest/mem_pools/tx_pool/priority.js +0 -10
  538. package/dest/mem_pools/tx_pool/tx_pool.d.ts +0 -123
  539. package/dest/mem_pools/tx_pool/tx_pool.d.ts.map +0 -1
  540. package/dest/mem_pools/tx_pool/tx_pool.js +0 -3
  541. package/dest/mem_pools/tx_pool/tx_pool_test_suite.d.ts +0 -7
  542. package/dest/mem_pools/tx_pool/tx_pool_test_suite.d.ts.map +0 -1
  543. package/dest/mem_pools/tx_pool/tx_pool_test_suite.js +0 -395
  544. package/dest/msg_validators/block_proposal_validator/block_proposal_validator.d.ts +0 -12
  545. package/dest/msg_validators/block_proposal_validator/block_proposal_validator.d.ts.map +0 -1
  546. package/dest/msg_validators/block_proposal_validator/block_proposal_validator.js +0 -82
  547. package/dest/msg_validators/block_proposal_validator/index.d.ts +0 -2
  548. package/dest/msg_validators/block_proposal_validator/index.d.ts.map +0 -1
  549. package/dest/msg_validators/block_proposal_validator/index.js +0 -1
  550. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.d.ts +0 -45
  551. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.d.ts.map +0 -1
  552. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.js +0 -92
  553. package/dest/services/reqresp/protocols/block.d.ts +0 -9
  554. package/dest/services/reqresp/protocols/block.d.ts.map +0 -1
  555. package/dest/services/reqresp/protocols/block.js +0 -32
  556. package/dest/services/tx_collection/fast_tx_collection.d.ts +0 -51
  557. package/dest/services/tx_collection/fast_tx_collection.d.ts.map +0 -1
  558. package/dest/services/tx_collection/fast_tx_collection.js +0 -300
  559. package/dest/services/tx_collection/slow_tx_collection.d.ts +0 -53
  560. package/dest/services/tx_collection/slow_tx_collection.d.ts.map +0 -1
  561. package/dest/services/tx_collection/slow_tx_collection.js +0 -177
  562. package/src/mem_pools/attestation_pool/kv_attestation_pool.ts +0 -298
  563. package/src/mem_pools/attestation_pool/memory_attestation_pool.ts +0 -287
  564. package/src/mem_pools/tx_pool/aztec_kv_tx_pool.ts +0 -751
  565. package/src/mem_pools/tx_pool/index.ts +0 -3
  566. package/src/mem_pools/tx_pool/memory_tx_pool.ts +0 -285
  567. package/src/mem_pools/tx_pool/priority.ts +0 -13
  568. package/src/mem_pools/tx_pool/tx_pool.ts +0 -136
  569. package/src/mem_pools/tx_pool/tx_pool_test_suite.ts +0 -314
  570. package/src/msg_validators/block_proposal_validator/block_proposal_validator.ts +0 -97
  571. package/src/msg_validators/block_proposal_validator/index.ts +0 -1
  572. package/src/services/reqresp/connection-sampler/batch_connection_sampler.ts +0 -100
  573. package/src/services/reqresp/protocols/block.ts +0 -37
  574. package/src/services/tx_collection/fast_tx_collection.ts +0 -341
  575. package/src/services/tx_collection/slow_tx_collection.ts +0 -233
@@ -1,34 +1,43 @@
1
1
  import type { EpochCacheInterface } from '@aztec/epoch-cache';
2
- import { BlockNumber, SlotNumber } from '@aztec/foundation/branded-types';
3
- import { randomInt } from '@aztec/foundation/crypto';
4
- import { Fr } from '@aztec/foundation/fields';
2
+ import { BlockNumber, type SlotNumber } from '@aztec/foundation/branded-types';
3
+ import { compactArray, 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
- import { getVKTreeRoot } from '@aztec/noir-protocol-circuits-types/vk-tree';
10
8
  import { protocolContractsHash } from '@aztec/protocol-contracts';
11
- import type { EthAddress, L2Block, L2BlockSource } from '@aztec/stdlib/block';
9
+ import type { EthAddress, L2BlockSource } from '@aztec/stdlib/block';
10
+ import { DEFAULT_MAX_BLOCKS_PER_CHECKPOINT } from '@aztec/stdlib/config';
12
11
  import type { ContractDataSource } from '@aztec/stdlib/contract';
13
- import { GasFees } from '@aztec/stdlib/gas';
12
+ import { type BlockMinFeesProvider, GasFees, getNetworkTxGasLimits } from '@aztec/stdlib/gas';
14
13
  import type { ClientProtocolCircuitVerifier, PeerInfo, WorldStateSynchronizer } from '@aztec/stdlib/interfaces/server';
15
14
  import {
16
- BlockAttestation,
17
15
  BlockProposal,
16
+ CheckpointAttestation,
17
+ CheckpointProposal,
18
+ type CheckpointProposalCore,
18
19
  type Gossipable,
19
- P2PClientType,
20
20
  P2PMessage,
21
21
  PeerErrorSeverity,
22
+ PeerErrorSeverityByHarshness,
22
23
  TopicType,
23
24
  createTopicString,
24
- getTopicsForClientAndConfig,
25
+ getTopicsForConfig,
25
26
  metricsTopicStrToLabels,
26
27
  } from '@aztec/stdlib/p2p';
28
+ import { ConsensusTimetable, getDefaultCheckpointProposalSyncGrace } from '@aztec/stdlib/timetable';
27
29
  import { MerkleTreeId } from '@aztec/stdlib/trees';
28
- import { Tx, type TxHash, type TxValidationResult, type TxValidator } from '@aztec/stdlib/tx';
30
+ import { Tx, type TxValidationResult } from '@aztec/stdlib/tx';
29
31
  import type { UInt64 } from '@aztec/stdlib/types';
30
32
  import { compressComponentVersions } from '@aztec/stdlib/versioning';
31
- import { Attributes, OtelMetricsAdapter, type TelemetryClient, WithTracer, trackSpan } from '@aztec/telemetry-client';
33
+ import {
34
+ Attributes,
35
+ OtelMetricsAdapter,
36
+ SpanStatusCode,
37
+ type TelemetryClient,
38
+ WithTracer,
39
+ trackSpan,
40
+ } from '@aztec/telemetry-client';
32
41
 
33
42
  import {
34
43
  type GossipSub,
@@ -36,74 +45,99 @@ import {
36
45
  type GossipsubMessage,
37
46
  gossipsub,
38
47
  } from '@chainsafe/libp2p-gossipsub';
39
- import { createPeerScoreParams, createTopicScoreParams } from '@chainsafe/libp2p-gossipsub/score';
48
+ import { createPeerScoreParams } from '@chainsafe/libp2p-gossipsub/score';
40
49
  import { SignaturePolicy } from '@chainsafe/libp2p-gossipsub/types';
41
50
  import { noise } from '@chainsafe/libp2p-noise';
42
51
  import { yamux } from '@chainsafe/libp2p-yamux';
43
52
  import { bootstrap } from '@libp2p/bootstrap';
44
53
  import { identify } from '@libp2p/identify';
45
54
  import { type Message, type MultiaddrConnection, type PeerId, TopicValidatorResult } from '@libp2p/interface';
46
- import type { ConnectionManager } from '@libp2p/interface-internal';
55
+ import type { AddressManager, ConnectionManager } from '@libp2p/interface-internal';
47
56
  import { mplex } from '@libp2p/mplex';
48
57
  import { tcp } from '@libp2p/tcp';
58
+ import { multiaddr } from '@multiformats/multiaddr';
49
59
  import { ENR } from '@nethermindeth/enr';
50
60
  import { createLibp2p } from 'libp2p';
51
61
 
52
62
  import type { P2PConfig } from '../../config.js';
53
- import { ProposalSlotCapExceededError } from '../../errors/attestation-pool.error.js';
63
+ import { CheckpointProposalReceivedCallbackNotRegisteredError } from '../../errors/p2p-service.error.js';
54
64
  import type { MemPools } from '../../mem_pools/interface.js';
55
65
  import {
56
- AttestationValidator,
57
66
  BlockProposalValidator,
67
+ CheckpointAttestationValidator,
68
+ CheckpointProposalValidator,
69
+ DoubleSpendTxValidator,
58
70
  FishermanAttestationValidator,
71
+ getDefaultAllowedSetupFunctions,
59
72
  } from '../../msg_validators/index.js';
60
73
  import { MessageSeenValidator } from '../../msg_validators/msg_seen_validator/msg_seen_validator.js';
61
- import { getDefaultAllowedSetupFunctions } from '../../msg_validators/tx_validator/allowed_public_setup.js';
62
- import { type MessageValidator, createTxMessageValidators } from '../../msg_validators/tx_validator/factory.js';
63
74
  import {
64
- AggregateTxValidator,
65
- DataTxValidator,
66
- DoubleSpendTxValidator,
67
- MetadataTxValidator,
68
- TxProofValidator,
69
- } from '../../msg_validators/tx_validator/index.js';
75
+ type TransactionValidator,
76
+ createFirstStageTxValidationsForGossipedTransactions,
77
+ createSecondStageTxValidationsForGossipedTransactions,
78
+ createTxValidatorForBlockProposalReceivedTxs,
79
+ } from '../../msg_validators/tx_validator/factory.js';
80
+ import { TxValidationCache } from '../../msg_validators/tx_validator/tx_validation_cache.js';
70
81
  import { GossipSubEvent } from '../../types/index.js';
71
82
  import { type PubSubLibp2p, convertToMultiaddr } from '../../util.js';
72
83
  import { getVersions } from '../../versioning.js';
73
84
  import { AztecDatastore } from '../data_store.js';
74
85
  import { DiscV5Service } from '../discv5/discV5_service.js';
75
- import { SnappyTransform, fastMsgIdFn, getMsgIdFn, msgIdToStrFn } from '../encoding.js';
76
- import { gossipScoreThresholds } from '../gossipsub/scoring.js';
86
+ import { SnappyTransform, getMsgIdFn, msgIdToStrFn } from '../encoding.js';
87
+ import { APP_SPECIFIC_WEIGHT, gossipScoreThresholds } from '../gossipsub/scoring.js';
88
+ import { createAllTopicScoreParams } from '../gossipsub/topic_score_params.js';
77
89
  import type { PeerManagerInterface } from '../peer-manager/interface.js';
78
90
  import { PeerManager } from '../peer-manager/peer_manager.js';
79
91
  import { PeerScoring } from '../peer-manager/peer_scoring.js';
80
- import type { P2PReqRespConfig } from '../reqresp/config.js';
92
+ import type { BatchTxRequesterLibP2PService } from '../reqresp/batch-tx-requester/interface.js';
93
+ import { type P2PReqRespConfig, YAMUX_MAX_MESSAGE_SIZE_BYTES } from '../reqresp/config.js';
81
94
  import {
82
- DEFAULT_SUB_PROTOCOL_VALIDATORS,
95
+ AuthRequest,
96
+ BlockTxsRequest,
97
+ BlockTxsResponse,
83
98
  type ReqRespInterface,
99
+ type ReqRespResponse,
84
100
  ReqRespSubProtocol,
85
101
  type ReqRespSubProtocolHandler,
86
102
  type ReqRespSubProtocolHandlers,
87
- type ReqRespSubProtocolValidators,
88
- type SubProtocolMap,
89
- ValidationError,
90
- } from '../reqresp/interface.js';
91
- import { reqRespBlockTxsHandler } from '../reqresp/protocols/block_txs/block_txs_handler.js';
92
- import { reqGoodbyeHandler } from '../reqresp/protocols/goodbye.js';
93
- import {
94
- AuthRequest,
95
- BlockTxsRequest,
96
- BlockTxsResponse,
97
103
  StatusMessage,
104
+ ValidationError,
98
105
  pingHandler,
99
- reqRespBlockHandler,
106
+ reqGoodbyeHandler,
107
+ reqRespBlockTxsHandler,
100
108
  reqRespStatusHandler,
101
109
  reqRespTxHandler,
102
- } from '../reqresp/protocols/index.js';
110
+ } from '../reqresp/index.js';
103
111
  import { ReqResp } from '../reqresp/reqresp.js';
104
- import type { P2PBlockReceivedCallback, P2PService, PeerDiscoveryService } from '../service.js';
112
+ import type {
113
+ P2PBlockReceivedCallback,
114
+ P2PCheckpointAttestationCallback,
115
+ P2PCheckpointReceivedCallback,
116
+ P2PDuplicateAttestationCallback,
117
+ P2POversizedProposalCallback,
118
+ P2PService,
119
+ PeerDiscoveryService,
120
+ } from '../service.js';
105
121
  import { P2PInstrumentation } from './instrumentation.js';
106
122
 
123
+ /**
124
+ * Builds the {@link ConsensusTimetable} shared by the gossip validators for proposal/attestation receive-window
125
+ * bounds. Derived purely from protocol slot-timing constants plus the block sub-slot duration and the consensus
126
+ * materialization grace, so every node agrees on these bounds without depending on proposer operational budgets.
127
+ */
128
+ function buildConsensusTimetable(
129
+ config: P2PConfig,
130
+ l1Constants: ReturnType<EpochCacheInterface['getL1Constants']>,
131
+ ): ConsensusTimetable {
132
+ const blockDuration = config.blockDurationMs / 1000;
133
+ return new ConsensusTimetable({
134
+ l1Constants,
135
+ blockDuration,
136
+ checkpointProposalSyncGrace:
137
+ config.checkpointProposalSyncGraceSeconds ?? getDefaultCheckpointProposalSyncGrace(blockDuration),
138
+ });
139
+ }
140
+
107
141
  interface ValidationResult {
108
142
  name: string;
109
143
  isValid: TxValidationResult;
@@ -113,25 +147,40 @@ interface ValidationResult {
113
147
  type ValidationOutcome = { allPassed: true } | { allPassed: false; failure: ValidationResult };
114
148
 
115
149
  // REFACTOR: Unify with the type above
116
- type ReceivedMessageValidationResult<T> =
117
- | { obj: T; result: Exclude<TopicValidatorResult, TopicValidatorResult.Reject> }
118
- | { obj?: undefined; result: TopicValidatorResult.Reject };
150
+ type ReceivedMessageValidationResult<T, M = undefined> =
151
+ | { obj: T; result: Exclude<TopicValidatorResult, TopicValidatorResult.Reject>; metadata?: M }
152
+ | { obj?: T; result: TopicValidatorResult.Reject; metadata?: M; severity: PeerErrorSeverity };
119
153
 
120
154
  /**
121
155
  * Lib P2P implementation of the P2PService interface.
122
156
  */
123
- export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends WithTracer implements P2PService {
157
+ export class LibP2PService extends WithTracer implements P2PService {
124
158
  private discoveryRunningPromise?: RunningPromise;
125
159
  private msgIdSeenValidators: Record<TopicType, MessageSeenValidator> = {} as Record<TopicType, MessageSeenValidator>;
126
160
 
127
161
  // Message validators
128
- private attestationValidator: AttestationValidator;
129
162
  private blockProposalValidator: BlockProposalValidator;
163
+ private checkpointProposalValidator: CheckpointProposalValidator;
164
+ private checkpointAttestationValidator: CheckpointAttestationValidator;
130
165
 
131
166
  private protocolVersion = '';
132
167
  private topicStrings: Record<TopicType, string> = {} as Record<TopicType, string>;
133
168
 
134
- private feesCache: { blockNumber: BlockNumber; gasFees: GasFees } | undefined;
169
+ /** Callback invoked when a duplicate proposal is detected (triggers slashing). */
170
+ private duplicateProposalCallback?: (info: {
171
+ slot: SlotNumber;
172
+ proposer: EthAddress;
173
+ type: 'checkpoint' | 'block';
174
+ }) => void;
175
+
176
+ /** Callback invoked when an oversized block proposal is stored as slashing evidence (triggers slashing). */
177
+ private oversizedProposalCallback?: P2POversizedProposalCallback;
178
+
179
+ /** Callback invoked when a duplicate attestation is detected (triggers slashing). */
180
+ private duplicateAttestationCallback?: P2PDuplicateAttestationCallback;
181
+
182
+ /** Callback invoked when a valid checkpoint attestation is accepted into the pool. */
183
+ private checkpointAttestationCallback?: P2PCheckpointAttestationCallback;
135
184
 
136
185
  /**
137
186
  * Callback for when a block is received from a peer.
@@ -140,28 +189,48 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
140
189
  */
141
190
  private blockReceivedCallback: P2PBlockReceivedCallback;
142
191
 
192
+ /**
193
+ * Callback for when a checkpoint proposal is received from a peer.
194
+ * @param checkpoint - The checkpoint proposal received from the peer.
195
+ * @returns The attestations for the checkpoint, if any.
196
+ */
197
+ private allNodesCheckpointReceivedCallback: P2PCheckpointReceivedCallback;
198
+ /**
199
+ * Callback for when a checkpoint proposal is received - specifically for validators - from a peer.
200
+ * @param checkpoint - The checkpoint proposal received from the peer.
201
+ * @returns The attestations for the checkpoint, if any.
202
+ */
203
+ private validatorCheckpointReceivedCallback: P2PCheckpointReceivedCallback;
204
+
143
205
  private gossipSubEventHandler: (e: CustomEvent<GossipsubMessage>) => void;
144
206
 
207
+ private ipChangedHandler?: (ip: string) => void;
208
+ private discoveredP2pIp?: string;
209
+
145
210
  private instrumentation: P2PInstrumentation;
146
211
 
212
+ private telemetry: TelemetryClient;
213
+
147
214
  protected logger: Logger;
148
215
 
149
216
  constructor(
150
- private clientType: T,
151
217
  private config: P2PConfig,
152
218
  protected node: PubSubLibp2p,
153
219
  private peerDiscoveryService: PeerDiscoveryService,
154
220
  private reqresp: ReqRespInterface,
155
- private peerManager: PeerManagerInterface,
156
- protected mempools: MemPools<T>,
157
- private archiver: L2BlockSource & ContractDataSource,
221
+ protected peerManager: PeerManagerInterface,
222
+ protected mempools: MemPools,
223
+ protected archiver: L2BlockSource & ContractDataSource,
158
224
  private epochCache: EpochCacheInterface,
159
225
  private proofVerifier: ClientProtocolCircuitVerifier,
160
226
  private worldStateSynchronizer: WorldStateSynchronizer,
227
+ private blockMinFeesProvider: BlockMinFeesProvider,
161
228
  telemetry: TelemetryClient,
162
229
  logger: Logger = createLogger('p2p:libp2p_service'),
230
+ private txValidationCache?: TxValidationCache,
163
231
  ) {
164
232
  super(telemetry, 'LibP2PService');
233
+ this.telemetry = telemetry;
165
234
 
166
235
  // Create child logger with fisherman prefix if in fisherman mode
167
236
  this.logger = config.fishermanMode ? logger.createChild('[FISHERMAN]') : logger;
@@ -170,7 +239,8 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
170
239
 
171
240
  this.msgIdSeenValidators[TopicType.tx] = new MessageSeenValidator(config.seenMessageCacheSize);
172
241
  this.msgIdSeenValidators[TopicType.block_proposal] = new MessageSeenValidator(config.seenMessageCacheSize);
173
- this.msgIdSeenValidators[TopicType.block_attestation] = new MessageSeenValidator(config.seenMessageCacheSize);
242
+ this.msgIdSeenValidators[TopicType.checkpoint_proposal] = new MessageSeenValidator(config.seenMessageCacheSize);
243
+ this.msgIdSeenValidators[TopicType.checkpoint_attestation] = new MessageSeenValidator(config.seenMessageCacheSize);
174
244
 
175
245
  const versions = getVersions(config);
176
246
  this.protocolVersion = compressComponentVersions(versions);
@@ -178,30 +248,75 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
178
248
 
179
249
  this.topicStrings[TopicType.tx] = createTopicString(TopicType.tx, this.protocolVersion);
180
250
  this.topicStrings[TopicType.block_proposal] = createTopicString(TopicType.block_proposal, this.protocolVersion);
181
- this.topicStrings[TopicType.block_attestation] = createTopicString(
182
- TopicType.block_attestation,
251
+ this.topicStrings[TopicType.checkpoint_proposal] = createTopicString(
252
+ TopicType.checkpoint_proposal,
253
+ this.protocolVersion,
254
+ );
255
+ this.topicStrings[TopicType.checkpoint_attestation] = createTopicString(
256
+ TopicType.checkpoint_attestation,
183
257
  this.protocolVersion,
184
258
  );
185
259
 
186
- // Use FishermanAttestationValidator in fisherman mode to validate attestation payloads against proposals
187
- this.attestationValidator = config.fishermanMode
188
- ? new FishermanAttestationValidator(epochCache, mempools.attestationPool!, telemetry)
189
- : new AttestationValidator(epochCache);
190
- this.blockProposalValidator = new BlockProposalValidator(epochCache, { txsPermitted: !config.disableTransactions });
260
+ // Build the consensus timetable once from protocol slot-timing constants and inject it into every
261
+ // validator so they share one set of receive-window bounds, independent of proposer operational budgets.
262
+ const consensusTimetable = buildConsensusTimetable(config, epochCache.getL1Constants());
263
+ const proposalValidatorOpts = {
264
+ txsPermitted: !config.disableTransactions,
265
+ maxTxsPerBlock: config.validateMaxTxsPerBlock ?? config.validateMaxTxsPerCheckpoint,
266
+ maxBlocksPerCheckpoint: config.maxBlocksPerCheckpoint,
267
+ skipSlotValidation: config.skipProposalSlotValidation,
268
+ signatureContext: {
269
+ chainId: config.l1ChainId,
270
+ rollupAddress: config.rollupAddress,
271
+ },
272
+ clockDisparityMs: config.maxGossipClockDisparityMs,
273
+ };
274
+ this.blockProposalValidator = new BlockProposalValidator(epochCache, consensusTimetable, proposalValidatorOpts);
275
+ this.checkpointProposalValidator = new CheckpointProposalValidator(
276
+ epochCache,
277
+ consensusTimetable,
278
+ proposalValidatorOpts,
279
+ );
280
+ const attestationValidatorOpts = {
281
+ signatureContext: proposalValidatorOpts.signatureContext,
282
+ clockDisparityMs: config.maxGossipClockDisparityMs,
283
+ };
284
+ this.checkpointAttestationValidator = config.fishermanMode
285
+ ? new FishermanAttestationValidator(
286
+ epochCache,
287
+ consensusTimetable,
288
+ mempools.attestationPool,
289
+ telemetry,
290
+ attestationValidatorOpts,
291
+ )
292
+ : new CheckpointAttestationValidator(epochCache, consensusTimetable, attestationValidatorOpts);
191
293
 
192
294
  this.gossipSubEventHandler = this.handleGossipSubEvent.bind(this);
193
295
 
194
- this.blockReceivedCallback = async (block: BlockProposal): Promise<BlockAttestation[] | undefined> => {
195
- this.logger.debug(
196
- `Handler not yet registered: Block received callback not set. Received block for slot ${block.slotNumber} from peer.`,
296
+ this.blockReceivedCallback = async (block: BlockProposal): Promise<boolean> => {
297
+ this.logger.warn(
298
+ `Handler for block received not yet registered on P2P service. Received block ${block.blockNumber} for slot ${block.slotNumber} from peer.`,
197
299
  { p2pMessageIdentifier: await block.p2pMessageLoggingIdentifier() },
198
300
  );
199
- return undefined;
301
+ return true;
302
+ };
303
+
304
+ this.allNodesCheckpointReceivedCallback = (
305
+ _checkpoint: CheckpointProposalCore,
306
+ ): Promise<CheckpointAttestation[] | undefined> => {
307
+ throw new CheckpointProposalReceivedCallbackNotRegisteredError();
308
+ };
309
+
310
+ this.validatorCheckpointReceivedCallback = (
311
+ _checkpoint: CheckpointProposalCore,
312
+ ): Promise<CheckpointAttestation[] | undefined> => {
313
+ return Promise.resolve(undefined);
200
314
  };
201
315
  }
202
316
 
203
- public updateConfig(config: Partial<P2PReqRespConfig>) {
317
+ public updateConfig(config: Partial<P2PReqRespConfig & Pick<P2PConfig, 'skipIncomingProposals'>>) {
204
318
  this.reqresp.updateConfig(config);
319
+ this.config = merge(this.config, config);
205
320
  }
206
321
 
207
322
  /**
@@ -210,20 +325,21 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
210
325
  * @param txPool - The transaction pool to be accessed by the service.
211
326
  * @returns The new service.
212
327
  */
213
- public static async new<T extends P2PClientType>(
214
- clientType: T,
328
+ public static async new(
215
329
  config: P2PConfig,
216
330
  peerId: PeerId,
217
331
  deps: {
218
- mempools: MemPools<T>;
332
+ mempools: MemPools;
219
333
  l2BlockSource: L2BlockSource & ContractDataSource;
220
334
  epochCache: EpochCacheInterface;
221
335
  proofVerifier: ClientProtocolCircuitVerifier;
222
336
  worldStateSynchronizer: WorldStateSynchronizer;
223
337
  peerStore: AztecAsyncKVStore;
338
+ blockMinFeesProvider: BlockMinFeesProvider;
224
339
  telemetry: TelemetryClient;
225
340
  logger: Logger;
226
341
  packageVersion: string;
342
+ txValidationCache?: TxValidationCache;
227
343
  },
228
344
  ) {
229
345
  const {
@@ -233,23 +349,26 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
233
349
  mempools,
234
350
  proofVerifier,
235
351
  peerStore,
352
+ blockMinFeesProvider,
236
353
  telemetry,
237
354
  logger,
238
355
  packageVersion,
356
+ txValidationCache,
239
357
  } = deps;
240
358
  const { p2pPort, maxPeerCount, listenAddress } = config;
241
359
  const bindAddrTcp = convertToMultiaddr(listenAddress, p2pPort, 'tcp');
242
360
 
243
361
  const datastore = new AztecDatastore(peerStore);
244
362
 
245
- const otelMetricsAdapter = new OtelMetricsAdapter(telemetry);
363
+ const otelMetricsAdapter = new OtelMetricsAdapter(telemetry, logger.getBindings());
246
364
 
247
365
  const peerDiscoveryService = new DiscV5Service(
248
366
  peerId,
249
367
  config,
250
368
  packageVersion,
251
369
  telemetry,
252
- createLogger(`${logger.module}:discv5_service`),
370
+ createLogger(`${logger.module}:discv5_service`, logger.getBindings()),
371
+ peerStore,
253
372
  );
254
373
 
255
374
  // Seed libp2p's bootstrap discovery with private and trusted peers
@@ -263,29 +382,50 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
263
382
  const versions = getVersions(config);
264
383
  const protocolVersion = compressComponentVersions(versions);
265
384
 
266
- const txTopic = createTopicString(TopicType.tx, protocolVersion);
267
- const blockProposalTopic = createTopicString(TopicType.block_proposal, protocolVersion);
268
- const blockAttestationTopic = createTopicString(TopicType.block_attestation, protocolVersion);
269
-
270
385
  const preferredPeersEnrs: ENR[] = config.preferredPeers.map(enr => ENR.decodeTxt(enr));
271
- const directPeers = (
386
+ const directPeers = compactArray(
272
387
  await Promise.all(
273
388
  preferredPeersEnrs.map(async enr => {
274
- const peerId = await enr.peerId();
275
- const address = enr.getLocationMultiaddr('tcp');
276
- if (address === undefined) {
277
- throw new Error(`Direct peer ${peerId.toString()} has no TCP address, ENR: ${enr.encodeTxt()}`);
389
+ try {
390
+ const peerId = await enr.peerId();
391
+ const address = enr.getLocationMultiaddr('tcp');
392
+ if (address === undefined) {
393
+ throw new Error(`Direct peer ${peerId.toString()} has no TCP address, ENR: ${enr.encodeTxt()}`);
394
+ }
395
+ return {
396
+ id: peerId,
397
+ addrs: [address],
398
+ };
399
+ } catch (err) {
400
+ // A malformed configured ENR shouldn't abort node setup — skip it and log.
401
+ logger.warn(`Skipping preferred peer with invalid ENR`, { err });
402
+ return undefined;
278
403
  }
279
- return {
280
- id: peerId,
281
- addrs: [address],
282
- };
283
404
  }),
284
- )
285
- ).filter(peer => peer !== undefined);
405
+ ),
406
+ );
286
407
 
287
408
  const announceTcpMultiaddr = config.p2pIp ? [convertToMultiaddr(config.p2pIp, p2pPort, 'tcp')] : [];
288
409
 
410
+ // Create dynamic topic score params based on network configuration. Scoring uses the network-wide
411
+ // max-blocks-per-checkpoint config value directly to size expected per-slot message rates; these are
412
+ // peer-rate thresholds, not consensus deadlines, so they need no proposer operational budgets.
413
+ const l1Constants = epochCache.getL1Constants();
414
+ const topicScoreParams = createAllTopicScoreParams(protocolVersion, {
415
+ slotDurationMs: l1Constants.slotDuration * 1000,
416
+ heartbeatIntervalMs: config.gossipsubInterval,
417
+ targetCommitteeSize: l1Constants.targetCommitteeSize,
418
+ maxBlocksPerCheckpoint: config.maxBlocksPerCheckpoint ?? DEFAULT_MAX_BLOCKS_PER_CHECKPOINT,
419
+ expectedBlockProposalsPerSlot: config.expectedBlockProposalsPerSlot,
420
+ });
421
+
422
+ // Restrict gossipsub to exactly the topics we subscribe to. Without this, an arbitrary-topic
423
+ // message is transformed, msg-id'd and inserted into the seenCache before the subscription check,
424
+ // so a crafted topic colliding on msg id can suppress a real message as a duplicate.
425
+ const allowedTopics = getTopicsForConfig(config.disableTransactions).map(topic =>
426
+ createTopicString(topic, protocolVersion),
427
+ );
428
+
289
429
  const node = await createLibp2p({
290
430
  start: false,
291
431
  peerId,
@@ -317,7 +457,8 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
317
457
  ],
318
458
  datastore,
319
459
  peerDiscovery,
320
- streamMuxers: [yamux(), mplex()],
460
+ // Pin the yamux frame size: MAX_REQRESP_REQUEST_SIZE_BYTES relies on a reqresp request fitting in one frame.
461
+ streamMuxers: [yamux({ maxMessageSize: YAMUX_MAX_MESSAGE_SIZE_BYTES }), mplex()],
321
462
  connectionEncryption: [noise()],
322
463
  connectionManager: {
323
464
  minConnections: 0, // Disable libp2p peer dialing, we do it manually
@@ -331,7 +472,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
331
472
  },
332
473
  connectionGater: {
333
474
  denyInboundConnection: (maConn: MultiaddrConnection) => {
334
- const allowed = peerManager.isNodeAllowedToConnect(maConn.remoteAddr.nodeAddress().address);
475
+ const allowed = peerManager.isAddressAllowedToConnect(maConn.remoteAddr.nodeAddress().address);
335
476
  if (allowed) {
336
477
  return false;
337
478
  }
@@ -342,7 +483,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
342
483
  denyInboundEncryptedConnection: (peerId: PeerId, _maConn: MultiaddrConnection) => {
343
484
  //NOTE: it is not necessary to check address here because this was already done by
344
485
  // denyInboundConnection
345
- const allowed = peerManager.isNodeAllowedToConnect(peerId);
486
+ const allowed = peerManager.isPeerAllowedToConnect(peerId);
346
487
  if (allowed) {
347
488
  return false;
348
489
  }
@@ -370,9 +511,13 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
370
511
  mcacheLength: config.gossipsubMcacheLength,
371
512
  mcacheGossip: config.gossipsubMcacheGossip,
372
513
  seenTTL: config.gossipsubSeenTTL,
514
+ allowedTopics,
515
+ // No fastMsgIdFn: the fast-path dedup cache keys on a non-cryptographic 64-bit hash of the
516
+ // raw data only (no topic), so a collision — accidental or engineered via a weak seed — drops
517
+ // a different message with no fallback to the full id. Dedup instead rests solely on the
518
+ // cryptographic, topic-framed msgIdFn below.
373
519
  msgIdFn: getMsgIdFn,
374
520
  msgIdToStrFn: msgIdToStrFn,
375
- fastMsgIdFn: fastMsgIdFn,
376
521
  dataTransform: new SnappyTransform(),
377
522
  metricsRegister: otelMetricsAdapter,
378
523
  metricsTopicStrToLabel: metricsTopicStrToLabels(protocolVersion),
@@ -381,30 +526,15 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
381
526
  scoreParams: createPeerScoreParams({
382
527
  // IPColocation factor can be disabled for local testing - default to -5
383
528
  IPColocationFactorWeight: config.debugDisableColocationPenalty ? 0 : -5.0,
384
- topics: {
385
- [txTopic]: createTopicScoreParams({
386
- topicWeight: 1,
387
- invalidMessageDeliveriesWeight: -20,
388
- invalidMessageDeliveriesDecay: 0.5,
389
- }),
390
- [blockAttestationTopic]: createTopicScoreParams({
391
- topicWeight: 1,
392
- invalidMessageDeliveriesWeight: -20,
393
- invalidMessageDeliveriesDecay: 0.5,
394
- }),
395
- [blockProposalTopic]: createTopicScoreParams({
396
- topicWeight: 1,
397
- invalidMessageDeliveriesWeight: -20,
398
- invalidMessageDeliveriesDecay: 0.5,
399
- }),
400
- },
529
+ topics: topicScoreParams,
401
530
  }),
402
531
  }) as (components: GossipSubComponents) => GossipSub,
403
- components: (components: { connectionManager: ConnectionManager }) => ({
532
+ components: (components: { connectionManager: ConnectionManager; addressManager: AddressManager }) => ({
404
533
  connectionManager: components.connectionManager,
534
+ addressManager: components.addressManager,
405
535
  }),
406
536
  },
407
- logger: createLibp2pComponentLogger(logger.module),
537
+ logger: createLibp2pComponentLogger(logger.module, logger.getBindings()),
408
538
  });
409
539
 
410
540
  const peerScoring = new PeerScoring(config, telemetry);
@@ -423,13 +553,19 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
423
553
  epochCache,
424
554
  );
425
555
 
426
- // Update gossipsub score params
427
- node.services.pubsub.score.params.appSpecificWeight = 10;
556
+ // Gate req/resp data protocols for unauthenticated peers when p2pAllowOnlyValidators is enabled
557
+ reqresp.setShouldRejectPeer(peerId => peerManager.shouldDisableP2PGossip(peerId));
558
+
559
+ // Configure application-specific scoring for gossipsub.
560
+ // The weight scales app score to align with gossipsub thresholds:
561
+ // - Disconnect (-50) × 10 = -500 = gossipThreshold (stops receiving gossip)
562
+ // - Ban (-100) × 10 = -1000 = publishThreshold (cannot publish)
563
+ // Note: positive topic scores can offset penalties, so alignment is best-effort.
564
+ node.services.pubsub.score.params.appSpecificWeight = APP_SPECIFIC_WEIGHT;
428
565
  node.services.pubsub.score.params.appSpecificScore = (peerId: string) =>
429
566
  peerManager.shouldDisableP2PGossip(peerId) ? -Infinity : peerManager.getPeerScore(peerId);
430
567
 
431
568
  return new LibP2PService(
432
- clientType,
433
569
  config,
434
570
  node,
435
571
  peerDiscoveryService,
@@ -440,8 +576,10 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
440
576
  epochCache,
441
577
  proofVerifier,
442
578
  worldStateSynchronizer,
579
+ blockMinFeesProvider,
443
580
  telemetry,
444
581
  logger,
582
+ txValidationCache,
445
583
  );
446
584
  }
447
585
 
@@ -455,40 +593,29 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
455
593
  throw new Error('P2P service already started');
456
594
  }
457
595
 
458
- // Get listen & announce addresses for logging
459
596
  const { p2pIp, p2pPort } = this.config;
460
- if (!p2pIp) {
461
- throw new Error('Announce address not provided.');
462
- }
463
- const announceTcpMultiaddr = convertToMultiaddr(p2pIp, p2pPort, 'tcp');
464
-
465
- await this.peerManager.initializePeers();
466
- if (!this.config.p2pDiscoveryDisabled) {
467
- await this.peerDiscoveryService.start();
468
- }
469
- await this.node.start();
470
-
471
- // Subscribe to standard GossipSub topics by default
472
- for (const topic of getTopicsForClientAndConfig(this.clientType, this.config.disableTransactions)) {
473
- this.subscribeToTopic(this.topicStrings[topic]);
597
+ if (!p2pIp && !this.config.queryForIp) {
598
+ throw new Error('Announce address not provided and queryForIp is not enabled.');
474
599
  }
600
+ const announceTcpMultiaddr = p2pIp ? convertToMultiaddr(p2pIp, p2pPort, 'tcp') : undefined;
475
601
 
476
602
  // Create request response protocol handlers
477
603
  const txHandler = reqRespTxHandler(this.mempools);
478
604
  const goodbyeHandler = reqGoodbyeHandler(this.peerManager);
479
- const blockHandler = reqRespBlockHandler(this.archiver);
480
605
  const statusHandler = reqRespStatusHandler(this.protocolVersion, this.worldStateSynchronizer, this.logger);
481
606
 
482
607
  const requestResponseHandlers: Partial<ReqRespSubProtocolHandlers> = {
483
608
  [ReqRespSubProtocol.PING]: pingHandler,
484
609
  [ReqRespSubProtocol.STATUS]: statusHandler.bind(this),
485
610
  [ReqRespSubProtocol.GOODBYE]: goodbyeHandler.bind(this),
486
- [ReqRespSubProtocol.BLOCK]: blockHandler.bind(this),
487
611
  };
488
612
 
489
- // Only handle block transactions request if attestation pool is available to the client
490
- if (this.mempools.attestationPool && !this.config.disableTransactions) {
491
- const blockTxsHandler = reqRespBlockTxsHandler(this.mempools.attestationPool, this.mempools.txPool);
613
+ if (!this.config.disableTransactions) {
614
+ const blockTxsHandler = reqRespBlockTxsHandler(
615
+ this.mempools.attestationPool,
616
+ this.archiver,
617
+ this.mempools.txPool,
618
+ );
492
619
  requestResponseHandlers[ReqRespSubProtocol.BLOCK_TXS] = blockTxsHandler.bind(this);
493
620
  }
494
621
 
@@ -496,10 +623,56 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
496
623
  requestResponseHandlers[ReqRespSubProtocol.TX] = txHandler.bind(this);
497
624
  }
498
625
 
626
+ await this.peerManager.initializePeers();
627
+
628
+ await this.reqresp.start(requestResponseHandlers);
629
+
630
+ await this.node.start();
631
+
632
+ // Subscribe to standard GossipSub topics by default
633
+ for (const topic of getTopicsForConfig(this.config.disableTransactions)) {
634
+ this.subscribeToTopic(this.topicStrings[topic]);
635
+ }
636
+
499
637
  // add GossipSub listener
500
638
  this.node.services.pubsub.addEventListener(GossipSubEvent.MESSAGE, this.gossipSubEventHandler);
501
639
 
502
640
  // Start running promise for peer discovery and metrics collection
641
+ if (!this.config.p2pDiscoveryDisabled) {
642
+ await this.peerDiscoveryService.start();
643
+ }
644
+
645
+ // Bridge discv5 IP changes to libp2p's AddressManager so peers see the updated address
646
+ if (this.config.queryForIp) {
647
+ this.discoveredP2pIp = this.config.p2pIp;
648
+ this.logger.info('IP change tracking enabled, bridging discv5 IP updates to libp2p AddressManager');
649
+ this.ipChangedHandler = (ip: string) => {
650
+ const addressManager = this.node.services.components.addressManager;
651
+ const newAddr = multiaddr(convertToMultiaddr(ip, this.config.p2pPort, 'tcp'));
652
+ const previousIp = this.discoveredP2pIp;
653
+
654
+ if (previousIp) {
655
+ const oldAddr = multiaddr(convertToMultiaddr(previousIp, this.config.p2pPort, 'tcp'));
656
+ addressManager.removeObservedAddr(oldAddr);
657
+ this.logger.info('Libp2p announce address updated due to IP change', {
658
+ previousIp,
659
+ newIp: ip,
660
+ newMultiaddr: newAddr.toString(),
661
+ });
662
+ } else {
663
+ this.logger.info('Libp2p announce address set from initial discv5 IP discovery', {
664
+ ip,
665
+ multiaddr: newAddr.toString(),
666
+ });
667
+ }
668
+
669
+ addressManager.addObservedAddr(newAddr);
670
+ addressManager.confirmObservedAddr(newAddr);
671
+ this.discoveredP2pIp = ip;
672
+ };
673
+ this.peerDiscoveryService.on('ip:changed', this.ipChangedHandler);
674
+ }
675
+
503
676
  this.discoveryRunningPromise = new RunningPromise(
504
677
  async () => {
505
678
  await this.peerManager.heartbeat();
@@ -509,14 +682,6 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
509
682
  );
510
683
  this.discoveryRunningPromise.start();
511
684
 
512
- // Define the sub protocol validators - This is done within this start() method to gain a callback to the existing validateTx function
513
- const reqrespSubProtocolValidators = {
514
- ...DEFAULT_SUB_PROTOCOL_VALIDATORS,
515
- [ReqRespSubProtocol.TX]: this.validateRequestedTxs.bind(this),
516
- [ReqRespSubProtocol.BLOCK_TXS]: this.validateRequestedBlockTxs.bind(this),
517
- [ReqRespSubProtocol.BLOCK]: this.validateRequestedBlock.bind(this),
518
- };
519
- await this.reqresp.start(requestResponseHandlers, reqrespSubProtocolValidators);
520
685
  this.logger.info(`Started P2P service`, {
521
686
  listen: this.config.listenAddress,
522
687
  port: this.config.p2pPort,
@@ -533,6 +698,11 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
533
698
  // Remove gossip sub listener
534
699
  this.node.services.pubsub.removeEventListener(GossipSubEvent.MESSAGE, this.gossipSubEventHandler);
535
700
 
701
+ if (this.ipChangedHandler) {
702
+ this.peerDiscoveryService.removeListener('ip:changed', this.ipChangedHandler);
703
+ this.ipChangedHandler = undefined;
704
+ }
705
+
536
706
  // Stop peer manager
537
707
  this.logger.debug('Stopping peer manager...');
538
708
  await this.peerManager.stop();
@@ -547,12 +717,8 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
547
717
  this.logger.info('LibP2P service stopped');
548
718
  }
549
719
 
550
- addReqRespSubProtocol(
551
- subProtocol: ReqRespSubProtocol,
552
- handler: ReqRespSubProtocolHandler,
553
- validator?: ReqRespSubProtocolValidators[ReqRespSubProtocol],
554
- ): Promise<void> {
555
- return this.reqresp.addSubProtocol(subProtocol, handler, validator);
720
+ addReqRespSubProtocol(subProtocol: ReqRespSubProtocol, handler: ReqRespSubProtocolHandler): Promise<void> {
721
+ return this.reqresp.addSubProtocol(subProtocol, handler);
556
722
  }
557
723
 
558
724
  public registerThisValidatorAddresses(address: EthAddress[]): void {
@@ -563,6 +729,10 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
563
729
  return this.peerManager.getPeers(includePending);
564
730
  }
565
731
 
732
+ public getGossipMeshPeerCount(topicType: TopicType): number {
733
+ return this.node.services.pubsub.getMeshPeers(this.topicStrings[topicType]).length;
734
+ }
735
+
566
736
  private handleGossipSubEvent(e: CustomEvent<GossipsubMessage>) {
567
737
  this.logger.trace(`Received PUBSUB message.`);
568
738
 
@@ -576,18 +746,13 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
576
746
  setImmediate(() => void safeJob());
577
747
  }
578
748
 
579
- /**
580
- * Send a batch of requests to peers, and return the responses
581
- * @param protocol - The request response protocol to use
582
- * @param requests - The requests to send to the peers
583
- * @returns The responses to the requests
584
- */
585
- sendBatchRequest<SubProtocol extends ReqRespSubProtocol>(
586
- protocol: SubProtocol,
587
- requests: InstanceType<SubProtocolMap[SubProtocol]['request']>[],
588
- pinnedPeerId: PeerId | undefined,
589
- ): Promise<InstanceType<SubProtocolMap[SubProtocol]['response']>[]> {
590
- return this.reqresp.sendBatchRequest(protocol, requests, pinnedPeerId);
749
+ public sendRequestToPeer(
750
+ peerId: PeerId,
751
+ subProtocol: ReqRespSubProtocol,
752
+ payload: Buffer,
753
+ dialTimeout?: number,
754
+ ): Promise<ReqRespResponse> {
755
+ return this.reqresp.sendRequestToPeer(peerId, subProtocol, payload, dialTimeout);
591
756
  }
592
757
 
593
758
  /**
@@ -602,6 +767,44 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
602
767
  this.blockReceivedCallback = callback;
603
768
  }
604
769
 
770
+ public registerValidatorCheckpointReceivedCallback(callback: P2PCheckpointReceivedCallback) {
771
+ this.validatorCheckpointReceivedCallback = callback;
772
+ }
773
+
774
+ public registerAllNodesCheckpointReceivedCallback(callback: P2PCheckpointReceivedCallback) {
775
+ this.allNodesCheckpointReceivedCallback = callback;
776
+ }
777
+
778
+ /**
779
+ * Registers a callback to be invoked when a duplicate proposal is detected.
780
+ * This callback is triggered on the first duplicate (when count goes from 1 to 2).
781
+ */
782
+ public registerDuplicateProposalCallback(
783
+ callback: (info: { slot: SlotNumber; proposer: EthAddress; type: 'checkpoint' | 'block' }) => void,
784
+ ): void {
785
+ this.duplicateProposalCallback = callback;
786
+ }
787
+
788
+ /**
789
+ * Registers a callback to be invoked when an oversized block proposal is stored as slashing evidence.
790
+ */
791
+ public registerOversizedProposalCallback(callback: P2POversizedProposalCallback): void {
792
+ this.oversizedProposalCallback = callback;
793
+ }
794
+
795
+ /**
796
+ * Registers a callback to be invoked when a duplicate attestation is detected.
797
+ * A validator signing attestations for different proposals at the same slot.
798
+ * This callback is triggered on the first duplicate (when count goes from 1 to 2).
799
+ */
800
+ public registerDuplicateAttestationCallback(callback: P2PDuplicateAttestationCallback): void {
801
+ this.duplicateAttestationCallback = callback;
802
+ }
803
+
804
+ public registerCheckpointAttestationCallback(callback: P2PCheckpointAttestationCallback): void {
805
+ this.checkpointAttestationCallback = callback;
806
+ }
807
+
605
808
  /**
606
809
  * Subscribes to a topic.
607
810
  * @param topic - The topic to subscribe to.
@@ -623,7 +826,10 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
623
826
  if (!this.node.services.pubsub) {
624
827
  throw new Error('Pubsub service not available.');
625
828
  }
626
- const p2pMessage = P2PMessage.fromGossipable(message, this.config.debugP2PInstrumentMessages);
829
+ const isBlockProposal = topic === this.topicStrings[TopicType.block_proposal];
830
+ const traceContext =
831
+ this.config.debugP2PInstrumentMessages && isBlockProposal ? this.telemetry.getTraceContext() : undefined;
832
+ const p2pMessage = P2PMessage.fromGossipable(message, this.config.debugP2PInstrumentMessages, traceContext);
627
833
  const result = await this.node.services.pubsub.publish(topic, p2pMessage.toMessageData());
628
834
  return result.recipients.length;
629
835
  }
@@ -644,12 +850,15 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
644
850
  case this.topicStrings[TopicType.tx]:
645
851
  topicType = TopicType.tx;
646
852
  break;
647
- case this.topicStrings[TopicType.block_attestation]:
648
- topicType = TopicType.block_attestation;
649
- break;
650
853
  case this.topicStrings[TopicType.block_proposal]:
651
854
  topicType = TopicType.block_proposal;
652
855
  break;
856
+ case this.topicStrings[TopicType.checkpoint_proposal]:
857
+ topicType = TopicType.checkpoint_proposal;
858
+ break;
859
+ case this.topicStrings[TopicType.checkpoint_attestation]:
860
+ topicType = TopicType.checkpoint_attestation;
861
+ break;
653
862
  default:
654
863
  this.logger.error(`Received message on unknown topic: ${msg.topic}`);
655
864
  break;
@@ -660,6 +869,9 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
660
869
  if (!validator || !validator.addMessage(msgId)) {
661
870
  this.instrumentation.incMessagePrevalidationStatus(false, topicType);
662
871
  this.node.services.pubsub.reportMessageValidationResult(msgId, source.toString(), TopicValidatorResult.Ignore);
872
+ if (topicType === TopicType.tx) {
873
+ this.logger.verbose(`Ignoring already-seen tx gossip message`, { msgId, source: source.toString() });
874
+ }
663
875
  return { result: false, topicType };
664
876
  }
665
877
 
@@ -708,74 +920,226 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
708
920
  return;
709
921
  }
710
922
 
923
+ // Determine topic type for attributes
711
924
  if (msg.topic === this.topicStrings[TopicType.tx]) {
712
925
  topicType = TopicType.tx;
713
- await this.handleGossipedTx(p2pMessage.payload, msgId, source);
926
+ } else if (msg.topic === this.topicStrings[TopicType.checkpoint_attestation]) {
927
+ topicType = TopicType.checkpoint_attestation;
928
+ } else if (msg.topic === this.topicStrings[TopicType.block_proposal]) {
929
+ topicType = TopicType.block_proposal;
930
+ } else if (msg.topic === this.topicStrings[TopicType.checkpoint_proposal]) {
931
+ topicType = TopicType.checkpoint_proposal;
714
932
  }
715
- if (msg.topic === this.topicStrings[TopicType.block_attestation]) {
716
- topicType = TopicType.block_attestation;
717
- if (this.clientType === P2PClientType.Full) {
718
- await this.processAttestationFromPeer(p2pMessage.payload, msgId, source);
933
+
934
+ // Process the message, optionally within a linked span for trace propagation
935
+ const processMessage = async () => {
936
+ if (
937
+ this.config.skipIncomingProposals &&
938
+ (msg.topic === this.topicStrings[TopicType.block_proposal] ||
939
+ msg.topic === this.topicStrings[TopicType.checkpoint_proposal])
940
+ ) {
941
+ this.logger.warn(`Ignoring incoming proposal (skipIncomingProposals is set)`, { topic: msg.topic });
942
+ this.node.services.pubsub.reportMessageValidationResult(msgId, source.toString(), TopicValidatorResult.Ignore);
943
+ return;
719
944
  }
720
- }
721
- if (msg.topic === this.topicStrings[TopicType.block_proposal]) {
722
- topicType = TopicType.block_proposal;
723
- await this.processBlockFromPeer(p2pMessage.payload, msgId, source);
945
+ if (msg.topic === this.topicStrings[TopicType.tx]) {
946
+ await this.handleGossipedTx(p2pMessage.payload, msgId, source);
947
+ } else if (msg.topic === this.topicStrings[TopicType.checkpoint_attestation]) {
948
+ await this.processCheckpointAttestationFromPeer(p2pMessage.payload, msgId, source);
949
+ } else if (msg.topic === this.topicStrings[TopicType.block_proposal]) {
950
+ await this.processBlockFromPeer(p2pMessage.payload, msgId, source);
951
+ } else if (msg.topic === this.topicStrings[TopicType.checkpoint_proposal]) {
952
+ await this.handleGossipedCheckpointProposal(p2pMessage.payload, msgId, source);
953
+ } else {
954
+ this.logger.error(`Received message on unknown topic: ${msg.topic}`);
955
+ }
956
+ };
957
+
958
+ const latency = p2pMessage.timestamp !== undefined ? msgReceivedTime - p2pMessage.timestamp.getTime() : undefined;
959
+ const propagatedContext = p2pMessage.traceContext
960
+ ? this.telemetry.extractPropagatedContext(p2pMessage.traceContext)
961
+ : undefined;
962
+
963
+ if (propagatedContext) {
964
+ await this.tracer.startActiveSpan(
965
+ 'LibP2PService.processMessage',
966
+ {
967
+ attributes: {
968
+ [Attributes.TOPIC_NAME]: topicType!,
969
+ [Attributes.PEER_ID]: source.toString(),
970
+ },
971
+ },
972
+ propagatedContext,
973
+ async span => {
974
+ try {
975
+ await processMessage();
976
+ span.setStatus({
977
+ code: SpanStatusCode.OK,
978
+ });
979
+ } catch (err) {
980
+ span.setStatus({
981
+ code: SpanStatusCode.ERROR,
982
+ message: String(err),
983
+ });
984
+ if (typeof err === 'string' || (err && err instanceof Error)) {
985
+ span.recordException(err);
986
+ }
987
+ throw err;
988
+ } finally {
989
+ span.end();
990
+ }
991
+ },
992
+ );
993
+ } else {
994
+ await processMessage();
724
995
  }
725
996
 
726
- if (p2pMessage.timestamp !== undefined && topicType !== undefined) {
727
- const latency = msgReceivedTime - p2pMessage.timestamp.getTime();
997
+ if (latency !== undefined && topicType !== undefined) {
728
998
  this.instrumentation.recordMessageLatency(topicType, latency);
729
999
  }
730
1000
 
731
1001
  return;
732
1002
  }
733
1003
 
734
- protected async validateReceivedMessage<T>(
735
- validationFunc: () => Promise<ReceivedMessageValidationResult<T>>,
1004
+ protected async validateReceivedMessage<T, M = undefined>(
1005
+ validationFunc: () => Promise<ReceivedMessageValidationResult<T, M>>,
736
1006
  msgId: string,
737
1007
  source: PeerId,
738
1008
  topicType: TopicType,
739
- ): Promise<ReceivedMessageValidationResult<T>> {
740
- let resultAndObj: ReceivedMessageValidationResult<T> = { result: TopicValidatorResult.Reject };
1009
+ ): Promise<ReceivedMessageValidationResult<T, M>> {
1010
+ // Default to reject result with a penalty if validation function throws an error
1011
+ let resultAndObj: ReceivedMessageValidationResult<T, M> = {
1012
+ result: TopicValidatorResult.Reject,
1013
+ severity: PeerErrorSeverity.MidToleranceError,
1014
+ };
741
1015
  const timer = new Timer();
742
1016
  try {
743
1017
  resultAndObj = await validationFunc();
744
1018
  } catch (err) {
745
- this.peerManager.penalizePeer(source, PeerErrorSeverity.LowToleranceError);
746
- this.logger.error(`Error deserializing and validating gossipsub message`, err, {
747
- msgId,
748
- source: source.toString(),
749
- topicType,
750
- });
1019
+ this.logger.error(`Error validating gossipsub message`, err, { msgId, source: source.toString(), topicType });
1020
+ }
1021
+
1022
+ const validationTimeMs = timer.ms();
1023
+ const mcacheWindowMs = this.config.gossipsubMcacheLength * this.config.gossipsubInterval;
1024
+ if (validationTimeMs > mcacheWindowMs * 0.75) {
1025
+ this.instrumentation.incSlowValidation(topicType);
1026
+ this.logger.warn(
1027
+ `Gossip validation for ${topicType} took ${validationTimeMs}ms, approaching mcache eviction window of ${mcacheWindowMs}ms. ` +
1028
+ `Message forwarding may be skipped if validation exceeds the window.`,
1029
+ { msgId, source: source.toString(), topicType, validationTimeMs, mcacheWindowMs },
1030
+ );
751
1031
  }
752
1032
 
753
1033
  if (resultAndObj.result === TopicValidatorResult.Accept) {
1034
+ this.logger.debug(`Message ${topicType} accepted by validator`, { msgId, source: source.toString(), topicType });
754
1035
  this.instrumentation.recordMessageValidation(topicType, timer);
1036
+ } else if (resultAndObj.result === TopicValidatorResult.Reject) {
1037
+ this.logger.warn(`Message ${topicType} rejected by validator with severity ${resultAndObj.severity}`, {
1038
+ msgId,
1039
+ source: source.toString(),
1040
+ topicType,
1041
+ severity: resultAndObj.severity,
1042
+ });
1043
+ this.peerManager.penalizePeer(source, resultAndObj.severity);
1044
+ } else {
1045
+ this.logger.trace(`Message ${topicType} ignored by validator`, { msgId, source: source.toString(), topicType });
755
1046
  }
756
1047
 
757
1048
  this.node.services.pubsub.reportMessageValidationResult(msgId, source.toString(), resultAndObj.result);
758
1049
  return resultAndObj;
759
1050
  }
760
1051
 
1052
+ private tryDeserialize<T>(deserializeFunc: () => T, msgId: string, source: PeerId): T | undefined {
1053
+ try {
1054
+ return deserializeFunc();
1055
+ } catch (err) {
1056
+ this.logger.warn(`Failed to deserialize gossipsub message from buffer`, {
1057
+ err,
1058
+ msgId,
1059
+ source: source.toString(),
1060
+ });
1061
+ return undefined;
1062
+ }
1063
+ }
1064
+
761
1065
  protected async handleGossipedTx(payloadData: Buffer, msgId: string, source: PeerId) {
762
1066
  const validationFunc: () => Promise<ReceivedMessageValidationResult<Tx>> = async () => {
763
- const tx = Tx.fromBuffer(payloadData);
764
- const isValid = await this.validatePropagatedTx(tx, source);
765
- const exists = isValid && (await this.mempools.txPool.hasTx(tx.getTxHash()));
1067
+ const tx = this.tryDeserialize(() => Tx.fromBuffer(payloadData), msgId, source);
1068
+ if (!tx) {
1069
+ return { result: TopicValidatorResult.Reject, severity: PeerErrorSeverity.LowToleranceError };
1070
+ }
1071
+
1072
+ const currentBlockNumber = await this.archiver.getBlockNumber();
1073
+ const { ts: nextSlotTimestamp } = this.epochCache.getEpochAndSlotInNextL1Slot();
1074
+
1075
+ // Stage 1: fast validators (metadata, data, timestamps, double-spend, gas, phases, block header)
1076
+ const firstStageValidators = await this.createFirstStageMessageValidators(currentBlockNumber, nextSlotTimestamp);
1077
+ const firstStageOutcome = await this.runValidations(tx, firstStageValidators);
1078
+ if (!firstStageOutcome.allPassed) {
1079
+ const { name } = firstStageOutcome.failure;
1080
+ let { severity } = firstStageOutcome.failure;
1081
+
1082
+ // Double spend validator has a special case handler. We perform more detailed examination
1083
+ // as to how recently the nullifier was entered into the tree and if the transaction should
1084
+ // have 'known' the nullifier existed. This determines the severity of the penalty applied to the peer.
1085
+ if (name === 'doubleSpendValidator') {
1086
+ const txBlockNumber = BlockNumber(currentBlockNumber + 1);
1087
+ severity = await this.handleDoubleSpendFailure(tx, txBlockNumber);
1088
+ }
766
1089
 
767
- this.logger.trace(`Validate propagated tx`, {
768
- isValid,
769
- exists,
1090
+ this.logger.verbose(`Rejecting gossiped tx ${tx.getTxHash().toString()}: stage 1 validation failed`, {
1091
+ validator: name,
1092
+ severity,
1093
+ source: source.toString(),
1094
+ });
1095
+ return { result: TopicValidatorResult.Reject, severity };
1096
+ }
1097
+
1098
+ // Pool pre-check: see if the pool would accept this tx before doing expensive proof verification
1099
+ const canAdd = await this.mempools.txPool.canAddPendingTx(tx);
1100
+ if (canAdd === 'ignored') {
1101
+ this.logger.verbose(`Ignoring gossiped tx ${tx.getTxHash().toString()}: pool pre-check returned ignored`, {
1102
+ source: source.toString(),
1103
+ });
1104
+ return { result: TopicValidatorResult.Ignore, obj: tx };
1105
+ }
1106
+
1107
+ // Stage 2: expensive proof verification
1108
+ const secondStageValidators = this.createSecondStageMessageValidators();
1109
+ const secondStageOutcome = await this.runValidations(tx, secondStageValidators);
1110
+ if (!secondStageOutcome.allPassed) {
1111
+ const { severity, name } = secondStageOutcome.failure;
1112
+ this.logger.verbose(`Rejecting gossiped tx ${tx.getTxHash().toString()}: stage 2 validation failed`, {
1113
+ validator: name,
1114
+ severity,
1115
+ source: source.toString(),
1116
+ });
1117
+ return { result: TopicValidatorResult.Reject, severity };
1118
+ }
1119
+
1120
+ // Pool add: persist the tx
1121
+ const txHash = tx.getTxHash();
1122
+ const addResult = await this.mempools.txPool.addPendingTxs([tx], { source: 'gossip' });
1123
+
1124
+ const wasAccepted = addResult.accepted.some(h => h.equals(txHash));
1125
+ const wasIgnored = addResult.ignored.some(h => h.equals(txHash));
1126
+
1127
+ this.logger.verbose(`Validate propagated tx ${txHash.toString()}`, {
1128
+ wasAccepted,
1129
+ wasIgnored,
770
1130
  [Attributes.P2P_ID]: source.toString(),
771
1131
  });
772
1132
 
773
- if (!isValid) {
774
- return { result: TopicValidatorResult.Reject };
775
- } else if (exists) {
1133
+ if (wasAccepted) {
1134
+ return { result: TopicValidatorResult.Accept, obj: tx };
1135
+ } else if (wasIgnored) {
776
1136
  return { result: TopicValidatorResult.Ignore, obj: tx };
777
1137
  } else {
778
- return { result: TopicValidatorResult.Accept, obj: tx };
1138
+ this.logger.warn(`Gossiped tx ${txHash.toString()} unexpectedly rejected by pool`, {
1139
+ source: source.toString(),
1140
+ txHash: txHash.toString(),
1141
+ });
1142
+ return { result: TopicValidatorResult.Reject, severity: PeerErrorSeverity.HighToleranceError };
779
1143
  }
780
1144
  };
781
1145
 
@@ -784,6 +1148,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
784
1148
  return;
785
1149
  }
786
1150
 
1151
+ // Tx was accepted into pool and will be propagated - just log and record metrics
787
1152
  const txHash = tx.getTxHash();
788
1153
  const txHashString = txHash.toString();
789
1154
  this.logger.verbose(`Received tx ${txHashString} from external peer ${source.toString()} via gossip`, {
@@ -791,73 +1156,40 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
791
1156
  txHash: txHashString,
792
1157
  });
793
1158
 
794
- if (this.config.dropTransactions && randomInt(1000) < this.config.dropTransactionsProbability * 1000) {
795
- this.logger.warn(`Intentionally dropping tx ${txHashString} (probability rule)`);
796
- return;
797
- }
798
-
799
1159
  this.instrumentation.incrementTxReceived(1);
800
- await this.mempools.txPool.addTxs([tx]);
801
1160
  }
802
1161
 
803
1162
  /**
804
- * Process Attestation From Peer
805
- * When a proposal is received from a peer, we add it to the attestation pool, so it can be accessed by other services.
806
- *
807
- * @param attestation - The attestation to process.
1163
+ * Process a checkpoint attestation from a peer.
1164
+ * Validates the attestation and adds it to the pool.
808
1165
  */
809
- private async processAttestationFromPeer(payloadData: Buffer, msgId: string, source: PeerId): Promise<void> {
810
- const validationFunc: () => Promise<ReceivedMessageValidationResult<BlockAttestation>> = async () => {
811
- const attestation = BlockAttestation.fromBuffer(payloadData);
812
- const pool = this.mempools.attestationPool!;
813
- const isValid = await this.validateAttestation(source, attestation);
814
- const exists = isValid && (await pool.hasAttestation(attestation));
815
-
816
- let canAdd = true;
817
- if (isValid && !exists) {
818
- const slot = attestation.payload.header.slotNumber;
819
- const { committee } = await this.epochCache.getCommittee(slot);
820
- const committeeSize = committee?.length ?? 0;
821
- canAdd = await pool.canAddAttestation(attestation, committeeSize);
822
- }
823
-
824
- this.logger.trace(`Validate propagated block attestation`, {
825
- isValid,
826
- exists,
827
- canAdd,
828
- [Attributes.SLOT_NUMBER]: attestation.payload.header.slotNumber.toString(),
829
- [Attributes.P2P_ID]: source.toString(),
830
- });
831
-
832
- if (!isValid) {
833
- return { result: TopicValidatorResult.Reject };
834
- } else if (exists) {
835
- return { result: TopicValidatorResult.Ignore, obj: attestation };
836
- } else if (!canAdd) {
837
- this.logger.warn(`Dropping block attestation due to per-(slot, proposalId) attestation cap`, {
838
- slot: attestation.payload.header.slotNumber.toString(),
839
- archive: attestation.archive.toString(),
840
- source: source.toString(),
841
- });
842
- return { result: TopicValidatorResult.Ignore, obj: attestation };
843
- } else {
844
- return { result: TopicValidatorResult.Accept, obj: attestation };
845
- }
846
- };
847
-
848
- const { result, obj: attestation } = await this.validateReceivedMessage<BlockAttestation>(
849
- validationFunc,
1166
+ private async processCheckpointAttestationFromPeer(
1167
+ payloadData: Buffer,
1168
+ msgId: string,
1169
+ source: PeerId,
1170
+ ): Promise<void> {
1171
+ const { result, obj: attestation } = await this.validateReceivedMessage<CheckpointAttestation>(
1172
+ () => {
1173
+ const attestation = this.tryDeserialize(() => CheckpointAttestation.fromBuffer(payloadData), msgId, source);
1174
+ if (!attestation) {
1175
+ return Promise.resolve({
1176
+ result: TopicValidatorResult.Reject,
1177
+ severity: PeerErrorSeverity.LowToleranceError,
1178
+ });
1179
+ }
1180
+ return this.validateAndStoreCheckpointAttestation(source, attestation);
1181
+ },
850
1182
  msgId,
851
1183
  source,
852
- TopicType.block_attestation,
1184
+ TopicType.checkpoint_attestation,
853
1185
  );
854
1186
 
855
1187
  if (result !== TopicValidatorResult.Accept || !attestation) {
856
1188
  return;
857
1189
  }
858
1190
 
859
- this.logger.debug(
860
- `Received attestation for slot ${attestation.slotNumber} from external peer ${source.toString()}`,
1191
+ this.logger.verbose(
1192
+ `Received valid checkpoint attestation for slot ${attestation.slotNumber} from external peer ${source.toString()}`,
861
1193
  {
862
1194
  p2pMessageIdentifier: await attestation.p2pMessageLoggingIdentifier(),
863
1195
  slot: attestation.slotNumber,
@@ -865,123 +1197,421 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
865
1197
  source: source.toString(),
866
1198
  },
867
1199
  );
868
-
869
- await this.mempools.attestationPool!.addAttestations([attestation]);
870
1200
  }
871
1201
 
872
- private async processBlockFromPeer(payloadData: Buffer, msgId: string, source: PeerId): Promise<void> {
873
- const validationFunc: () => Promise<ReceivedMessageValidationResult<BlockProposal>> = async () => {
874
- const block = BlockProposal.fromBuffer(payloadData);
875
- const isValid = await this.validateBlockProposal(source, block);
876
- const pool = this.mempools.attestationPool;
877
-
878
- // Note that we dont have an attestation pool if we're a prover node, but we still
879
- // subscribe to block proposal topics in order to prevent their txs from being cleared.
880
- const exists = isValid && (await pool?.hasBlockProposal(block));
881
- const canAdd = isValid && (await pool?.canAddProposal(block));
882
-
883
- this.logger.trace(`Validate propagated block proposal`, {
884
- isValid,
885
- exists,
886
- canAdd,
887
- [Attributes.SLOT_NUMBER]: block.payload.header.slotNumber.toString(),
888
- [Attributes.P2P_ID]: source.toString(),
1202
+ /** Validates a checkpoint attestation and adds it to the pool. Penalizes the peer if validation fails. */
1203
+ @trackSpan('Libp2pService.validateAndStoreCheckpointAttestation', (_peerId, attestation) => ({
1204
+ [Attributes.SLOT_NUMBER]: attestation.payload.header.slotNumber.toString(),
1205
+ }))
1206
+ protected async validateAndStoreCheckpointAttestation(
1207
+ peerId: PeerId,
1208
+ attestation: CheckpointAttestation,
1209
+ ): Promise<ReceivedMessageValidationResult<CheckpointAttestation>> {
1210
+ const validationResult = await this.checkpointAttestationValidator.validate(attestation);
1211
+
1212
+ if (validationResult.result === 'reject') {
1213
+ this.logger.warn(`Penalizing peer ${peerId} for checkpoint attestation validation failure`);
1214
+ return { result: TopicValidatorResult.Reject, severity: validationResult.severity };
1215
+ }
1216
+
1217
+ if (validationResult.result === 'ignore') {
1218
+ return { result: TopicValidatorResult.Ignore, obj: attestation };
1219
+ }
1220
+
1221
+ // Try to add the attestation: this handles existence check, cap check, and adding in one call
1222
+ // count is the number of attestations by this signer for this slot (for duplicate detection)
1223
+ const slot = attestation.payload.header.slotNumber;
1224
+ const { added, alreadyExists, count } =
1225
+ await this.mempools.attestationPool.tryAddCheckpointAttestation(attestation);
1226
+
1227
+ this.logger.trace(`Validate propagated checkpoint attestation`, {
1228
+ added,
1229
+ alreadyExists,
1230
+ count,
1231
+ [Attributes.SLOT_NUMBER]: slot.toString(),
1232
+ [Attributes.P2P_ID]: peerId.toString(),
1233
+ });
1234
+
1235
+ // Exact same attestation received, no need to re-broadcast
1236
+ if (alreadyExists) {
1237
+ return { result: TopicValidatorResult.Ignore, obj: attestation };
1238
+ }
1239
+
1240
+ // Could not add (cap reached for signer), penalize and do not re-broadcast
1241
+ if (!added) {
1242
+ this.logger.warn(`Rejecting checkpoint attestation due to cap`, {
1243
+ slot: slot.toString(),
1244
+ archive: attestation.archive.toString(),
1245
+ source: peerId.toString(),
1246
+ attester: attestation.getSender()?.toString(),
1247
+ count,
889
1248
  });
1249
+ return { result: TopicValidatorResult.Reject, severity: PeerErrorSeverity.HighToleranceError };
1250
+ }
890
1251
 
891
- if (!isValid) {
892
- return { result: TopicValidatorResult.Reject };
893
- } else if (exists) {
894
- return { result: TopicValidatorResult.Ignore, obj: block };
895
- } else if (!canAdd) {
896
- this.peerManager.penalizePeer(source, PeerErrorSeverity.MidToleranceError);
897
- this.logger.warn(`Penalizing peer for block proposal exceeding per-slot cap`, {
898
- slot: block.slotNumber.toString(),
899
- archive: block.archive.toString(),
900
- source: source.toString(),
1252
+ // Check if this is a duplicate attestation (signer attested to a different proposal at the same slot)
1253
+ // count is the number of attestations by this signer for this slot
1254
+ if (count === 2) {
1255
+ const attester = attestation.getSender();
1256
+ if (attester) {
1257
+ this.logger.warn(`Detected duplicate attestation (equivocation) at slot ${slot}`, {
1258
+ slot: slot.toString(),
1259
+ archive: attestation.archive.toString(),
1260
+ source: peerId.toString(),
1261
+ attester: attester.toString(),
901
1262
  });
902
- return { result: TopicValidatorResult.Reject };
903
- } else {
904
- return { result: TopicValidatorResult.Accept, obj: block };
1263
+ this.duplicateAttestationCallback?.({ slot, attester });
905
1264
  }
906
- };
1265
+ }
1266
+
1267
+ // Attestation was added successfully - accept it so other nodes can also detect the equivocation
1268
+ this.checkpointAttestationCallback?.(attestation);
1269
+ return { result: TopicValidatorResult.Accept, obj: attestation };
1270
+ }
907
1271
 
908
- const { result, obj: block } = await this.validateReceivedMessage<BlockProposal>(
909
- validationFunc,
1272
+ protected async processBlockFromPeer(payloadData: Buffer, msgId: string, source: PeerId): Promise<void> {
1273
+ const {
1274
+ result,
1275
+ obj: block,
1276
+ metadata: { isEquivocated, isOversized } = {},
1277
+ } = await this.validateReceivedMessage<BlockProposal, { isEquivocated: boolean; isOversized: boolean }>(
1278
+ () => this.validateAndStoreBlockProposal(source, BlockProposal.fromBuffer(payloadData)),
910
1279
  msgId,
911
1280
  source,
912
1281
  TopicType.block_proposal,
913
1282
  );
914
1283
 
915
- if (!result || !block) {
1284
+ // If not accepted, equivocated, or oversized, return. Oversized proposals are re-broadcast as
1285
+ // slashing evidence but never attested or processed.
1286
+ if (result !== TopicValidatorResult.Accept || !block || isEquivocated || isOversized) {
916
1287
  return;
917
1288
  }
918
1289
 
919
1290
  await this.processValidBlockProposal(block, source);
920
1291
  }
921
1292
 
922
- // REVIEW: callback pattern https://github.com/AztecProtocol/aztec-packages/issues/7963
1293
+ /** Validates a block proposal. Triggers a penalization to the peer that sent it if invalid. Adds to the mempool if valid. */
1294
+ @trackSpan('Libp2pService.validateAndStoreBlockProposal', (_peerId, block) => ({
1295
+ [Attributes.BLOCK_NUMBER]: block.blockNumber.toString(),
1296
+ [Attributes.SLOT_NUMBER]: block.slotNumber.toString(),
1297
+ }))
1298
+ protected async validateAndStoreBlockProposal(
1299
+ peerId: PeerId,
1300
+ block: BlockProposal,
1301
+ ): Promise<ReceivedMessageValidationResult<BlockProposal, { isEquivocated: boolean; isOversized: boolean }>> {
1302
+ const validationResult = await this.blockProposalValidator.validate(block);
1303
+
1304
+ if (validationResult.result === 'reject') {
1305
+ this.logger.warn(`Penalizing peer ${peerId} for block proposal validation failure`);
1306
+ return { result: TopicValidatorResult.Reject, severity: validationResult.severity };
1307
+ }
1308
+
1309
+ if (validationResult.result === 'ignore') {
1310
+ return { result: TopicValidatorResult.Ignore, obj: block };
1311
+ }
1312
+
1313
+ // Try to add the proposal: this handles existence check, cap check, and adding in one call
1314
+ const { added, alreadyExists, count } = await this.mempools.attestationPool.tryAddBlockProposal(block);
1315
+ const isEquivocated = count !== undefined && count > 1;
1316
+ // An oversized proposal (index at or beyond the consensus per-checkpoint limit) is structurally valid
1317
+ // proposer misbehavior: it is stored and re-broadcast as slashing evidence but never processed or
1318
+ // attested to. No-ops when maxBlocksPerCheckpoint is unset (local/test).
1319
+ const isOversized =
1320
+ this.config.maxBlocksPerCheckpoint !== undefined &&
1321
+ block.indexWithinCheckpoint >= this.config.maxBlocksPerCheckpoint;
1322
+
1323
+ // Duplicate proposal received, no need to re-broadcast
1324
+ if (alreadyExists) {
1325
+ this.logger.debug(`Ignoring duplicate block proposal received`, {
1326
+ ...block.toBlockInfo(),
1327
+ indexWithinCheckpoint: block.indexWithinCheckpoint,
1328
+ proposer: block.getSender()?.toString(),
1329
+ source: peerId.toString(),
1330
+ });
1331
+ return { result: TopicValidatorResult.Ignore, obj: block, metadata: { isEquivocated, isOversized } };
1332
+ }
1333
+
1334
+ // Too many blocks received for this slot and index, penalize peer and do not re-broadcast
1335
+ if (!added) {
1336
+ this.logger.warn(`Penalizing peer for block proposal exceeding per-position cap`, {
1337
+ ...block.toBlockInfo(),
1338
+ indexWithinCheckpoint: block.indexWithinCheckpoint,
1339
+ count,
1340
+ proposer: block.getSender()?.toString(),
1341
+ source: peerId.toString(),
1342
+ });
1343
+ return {
1344
+ result: TopicValidatorResult.Reject,
1345
+ metadata: { isEquivocated, isOversized },
1346
+ severity: PeerErrorSeverity.HighToleranceError,
1347
+ };
1348
+ }
1349
+
1350
+ // The proposal was stored: if oversized, invoke the oversized callback so the proposer can be
1351
+ // slashed. Fired alongside (not instead of) equivocation detection below.
1352
+ if (isOversized) {
1353
+ const proposer = block.getSender();
1354
+ if (proposer) {
1355
+ this.logger.warn(`Detected oversized block proposal at slot ${block.slotNumber}`, {
1356
+ ...block.toBlockInfo(),
1357
+ indexWithinCheckpoint: block.indexWithinCheckpoint,
1358
+ maxBlocksPerCheckpoint: this.config.maxBlocksPerCheckpoint,
1359
+ source: peerId.toString(),
1360
+ proposer: proposer.toString(),
1361
+ });
1362
+ this.oversizedProposalCallback?.({ slot: block.slotNumber, proposer });
1363
+ }
1364
+ }
1365
+
1366
+ // If this was a duplicate proposal, do not process it, but do invoke the duplicate callback,
1367
+ // and do re-broadcast it so other nodes in the network know to slash the proposer
1368
+ if (isEquivocated) {
1369
+ const proposer = block.getSender();
1370
+ this.logger.warn(`Detected duplicate block proposal (equivocation) at slot ${block.slotNumber}`, {
1371
+ ...block.toBlockInfo(),
1372
+ source: peerId.toString(),
1373
+ proposer: proposer?.toString(),
1374
+ });
1375
+ // Invoke the duplicate callback on the first duplicate spotted only
1376
+ if (proposer && count === 2) {
1377
+ this.duplicateProposalCallback?.({ slot: block.slotNumber, proposer, type: 'block' });
1378
+ }
1379
+ return { result: TopicValidatorResult.Accept, obj: block, metadata: { isEquivocated, isOversized } };
1380
+ }
1381
+
1382
+ // Otherwise, we're good to go!
1383
+ return { result: TopicValidatorResult.Accept, obj: block, metadata: { isEquivocated: false, isOversized } };
1384
+ }
1385
+
1386
+ // REFACTOR(palla): This method should be moved to the p2p_client or to a separate component,
1387
+ // should not be here as it does not deal with p2p networking.
923
1388
  @trackSpan('Libp2pService.processValidBlockProposal', async block => ({
924
1389
  [Attributes.SLOT_NUMBER]: block.slotNumber,
925
1390
  [Attributes.BLOCK_ARCHIVE]: block.archive.toString(),
926
1391
  [Attributes.P2P_ID]: await block.p2pMessageLoggingIdentifier().then(i => i.toString()),
927
1392
  }))
928
- private async processValidBlockProposal(block: BlockProposal, sender: PeerId) {
1393
+ protected async processValidBlockProposal(block: BlockProposal, sender: PeerId) {
929
1394
  const slot = block.slotNumber;
930
- const previousSlot = SlotNumber(slot - 1);
931
1395
  this.logger.verbose(`Received block proposal for slot ${slot} from external peer ${sender.toString()}.`, {
932
1396
  p2pMessageIdentifier: await block.p2pMessageLoggingIdentifier(),
933
- slot: block.slotNumber,
934
- archive: block.archive.toString(),
935
1397
  source: sender.toString(),
1398
+ ...block.toBlockInfo(),
936
1399
  });
937
- const attestationsForPreviousSlot = await this.mempools.attestationPool?.getAttestationsForSlot(previousSlot);
938
- if (attestationsForPreviousSlot !== undefined) {
939
- this.logger.verbose(`Received ${attestationsForPreviousSlot.length} attestations for slot ${previousSlot}`);
1400
+
1401
+ // Mark the txs in this proposal as protected
1402
+ await this.mempools.txPool.protectTxs(block.txHashes, block.blockHeader);
1403
+
1404
+ // Call the block received callback to validate the proposal.
1405
+ // Note: Validators do NOT attest to individual blocks, only to checkpoint proposals.
1406
+ const isValid = await this.blockReceivedCallback(block, sender);
1407
+ if (!isValid) {
1408
+ this.logger.info(`Block proposal validation failed for block ${block.blockNumber}`, block.toBlockInfo());
1409
+ // Release the protections this proposal created so its txs return to pending. Only entries still
1410
+ // keyed to this slot are cleared, so a tx referenced by a live proposal at another slot stays protected.
1411
+ await this.mempools.txPool.unprotectTxs(block.txHashes, slot);
940
1412
  }
1413
+ }
941
1414
 
942
- // Attempt to add proposal, then mark the txs in this proposal as non-evictable
943
- try {
944
- await this.mempools.attestationPool?.addBlockProposal(block);
945
- } catch (err: unknown) {
946
- // Drop proposals if we hit per-slot cap in the attestation pool; rethrow unknown errors
947
- if (err instanceof ProposalSlotCapExceededError) {
948
- this.logger.warn(`Dropping block proposal due to per-slot proposal cap`, {
949
- slot: String(slot),
950
- archive: block.archive.toString(),
951
- error: (err as Error).message,
1415
+ /**
1416
+ * Handle a gossiped checkpoint proposal.
1417
+ * Validates and processes the checkpoint proposal, then triggers the callback for attestation.
1418
+ */
1419
+ protected async handleGossipedCheckpointProposal(payloadData: Buffer, msgId: string, source: PeerId): Promise<void> {
1420
+ const {
1421
+ result,
1422
+ obj: checkpoint,
1423
+ metadata: { isEquivocated, processBlock, isOversized } = {},
1424
+ } = await this.validateReceivedMessage<
1425
+ CheckpointProposal,
1426
+ { isEquivocated: boolean; processBlock: boolean; isOversized: boolean }
1427
+ >(
1428
+ () => this.validateAndStoreCheckpointProposal(source, CheckpointProposal.fromBuffer(payloadData)),
1429
+ msgId,
1430
+ source,
1431
+ TopicType.checkpoint_proposal,
1432
+ );
1433
+
1434
+ // An oversized checkpoint is re-broadcast as slashing evidence but never attested or processed.
1435
+ // Process checkpoint proposal if valid and neither equivocated nor oversized.
1436
+ const processCheckpointFn = () =>
1437
+ result === TopicValidatorResult.Accept && checkpoint && !isEquivocated && !isOversized
1438
+ ? this.processValidCheckpointProposal(checkpoint.toCore(), source)
1439
+ : Promise.resolve();
1440
+
1441
+ // If the checkpoint contained a valid last block, we process it even if the checkpoint itself is to be rejected
1442
+ // TODO(palla/mbps): Is this ok? Should we be considering a block from a checkpoint that was equivocated?
1443
+ const processBlockFn = () =>
1444
+ processBlock && checkpoint && checkpoint.getBlockProposal()
1445
+ ? this.processValidBlockProposal(checkpoint.getBlockProposal()!, source)
1446
+ : Promise.resolve();
1447
+
1448
+ // A node that skips checkpoint validation attests without re-executing the embedded last block, so run
1449
+ // the checkpoint callback first: this creates and broadcasts the attestation before the block is
1450
+ // processed. Otherwise the block's re-execution — which can stall until the re-execution deadline
1451
+ // waiting for a parent that may never arrive — would delay the attestation past the slot's attestation
1452
+ // window, after which peers reject it as stale.
1453
+ if (this.config.skipCheckpointProposalValidation) {
1454
+ await processCheckpointFn();
1455
+ await processBlockFn();
1456
+ return;
1457
+ }
1458
+
1459
+ // Process the block first, since it's required for the checkpoint proposal validation.
1460
+ await processBlockFn();
1461
+ await processCheckpointFn();
1462
+ }
1463
+
1464
+ /**
1465
+ * Validates a checkpoint proposal. Penalizes peer if validation fails. Adds the checkpoint and
1466
+ * its last block (if present) to the mempool if valid. Triggers equivocation detection on both.
1467
+ */
1468
+ @trackSpan('Libp2pService.validateAndStoreCheckpointProposal', (_peerId, checkpoint) => ({
1469
+ [Attributes.SLOT_NUMBER]: checkpoint.slotNumber.toString(),
1470
+ }))
1471
+ protected async validateAndStoreCheckpointProposal(
1472
+ peerId: PeerId,
1473
+ checkpoint: CheckpointProposal,
1474
+ ): Promise<
1475
+ ReceivedMessageValidationResult<
1476
+ CheckpointProposal,
1477
+ { isEquivocated: boolean; processBlock: boolean; isOversized: boolean }
1478
+ >
1479
+ > {
1480
+ const validationResult = await this.checkpointProposalValidator.validate(checkpoint);
1481
+
1482
+ if (validationResult.result === 'reject') {
1483
+ this.logger.warn(`Penalizing peer ${peerId} for checkpoint proposal validation failure`);
1484
+ return { result: TopicValidatorResult.Reject, severity: validationResult.severity };
1485
+ }
1486
+
1487
+ if (validationResult.result === 'ignore') {
1488
+ return { result: TopicValidatorResult.Ignore, obj: checkpoint };
1489
+ }
1490
+
1491
+ // Extract and try to add the block proposal first if present
1492
+ const blockProposal = checkpoint.getBlockProposal();
1493
+ let processBlock = false;
1494
+ let isOversized = false;
1495
+ if (blockProposal) {
1496
+ this.logger.debug(`Validating block proposal from propagated checkpoint`, {
1497
+ [Attributes.SLOT_NUMBER]: checkpoint.slotNumber.toString(),
1498
+ [Attributes.P2P_ID]: peerId.toString(),
1499
+ });
1500
+ const blockProposalResult = await this.validateAndStoreBlockProposal(peerId, blockProposal);
1501
+ const { obj, metadata: { isEquivocated, isOversized: blockIsOversized } = {} } = blockProposalResult;
1502
+ isOversized = blockIsOversized ?? false;
1503
+
1504
+ if (blockProposalResult.result === TopicValidatorResult.Reject || !obj || isEquivocated) {
1505
+ this.logger.debug(`Rejecting checkpoint due to invalid last block proposal`, {
1506
+ [Attributes.SLOT_NUMBER]: checkpoint.slotNumber.toString(),
1507
+ [Attributes.P2P_ID]: peerId.toString(),
1508
+ isEquivocated,
1509
+ result: blockProposalResult.result,
952
1510
  });
953
- return;
1511
+ return {
1512
+ result: TopicValidatorResult.Reject,
1513
+ severity:
1514
+ 'severity' in blockProposalResult ? blockProposalResult.severity : PeerErrorSeverity.MidToleranceError,
1515
+ };
1516
+ } else if (blockProposalResult.result === TopicValidatorResult.Accept && obj && !isEquivocated && !isOversized) {
1517
+ // An oversized terminal block is re-broadcast as slashing evidence but never processed.
1518
+ processBlock = true;
954
1519
  }
955
- throw err;
956
1520
  }
957
- await this.mempools.txPool.markTxsAsNonEvictable(block.txHashes);
958
- const attestations = await this.blockReceivedCallback(block, sender);
959
1521
 
960
- // TODO: fix up this pattern - the abstraction is not nice
961
- // The attestation can be undefined if no handler is registered / the validator deems the block invalid / in fisherman mode
962
- if (attestations?.length) {
963
- for (const attestation of attestations) {
964
- this.logger.verbose(`Broadcasting attestation for slot ${attestation.slotNumber}`, {
965
- p2pMessageIdentifier: await attestation.p2pMessageLoggingIdentifier(),
966
- slot: attestation.slotNumber,
967
- archive: attestation.archive.toString(),
968
- });
969
- await this.broadcastAttestation(attestation);
1522
+ // Try to add the checkpoint proposal core: this handles existence check, cap check, and adding in one call
1523
+ const checkpointCore = checkpoint.toCore();
1524
+ const tryAddResult = await this.mempools.attestationPool.tryAddCheckpointProposal(checkpointCore);
1525
+ const { added, alreadyExists, count } = tryAddResult;
1526
+ const isEquivocated = count !== undefined && count > 1;
1527
+
1528
+ // Duplicate proposal received, do not re-broadcast
1529
+ if (alreadyExists) {
1530
+ this.logger.debug(`Ignoring duplicate checkpoint proposal received`, {
1531
+ ...checkpoint.toCheckpointInfo(),
1532
+ source: peerId.toString(),
1533
+ });
1534
+ return {
1535
+ result: TopicValidatorResult.Ignore,
1536
+ obj: checkpoint,
1537
+ metadata: { isEquivocated, processBlock, isOversized },
1538
+ };
1539
+ }
1540
+
1541
+ // Too many checkpoint proposals received for this slot, penalize peer and do not re-broadcast.
1542
+ // Note: We still return the checkpoint obj so the lastBlock can be processed if valid
1543
+ if (!added) {
1544
+ this.logger.warn(`Penalizing peer for checkpoint proposal exceeding per-slot cap`, {
1545
+ ...checkpoint.toCheckpointInfo(),
1546
+ count,
1547
+ source: peerId.toString(),
1548
+ });
1549
+ return {
1550
+ result: TopicValidatorResult.Reject,
1551
+ obj: checkpoint,
1552
+ metadata: { isEquivocated, processBlock, isOversized },
1553
+ severity: PeerErrorSeverity.HighToleranceError,
1554
+ };
1555
+ }
1556
+
1557
+ // If this was a duplicate proposal, do not process it, but do invoke the duplicate callback,
1558
+ // and do re-broadcast it so other nodes in the network know to slash the proposer
1559
+ if (isEquivocated) {
1560
+ const proposer = checkpoint.getSender();
1561
+ this.logger.warn(`Detected duplicate checkpoint proposal (equivocation) at slot ${checkpoint.slotNumber}`, {
1562
+ ...checkpoint.toCheckpointInfo(),
1563
+ source: peerId.toString(),
1564
+ proposer: proposer?.toString(),
1565
+ });
1566
+ // Invoke the duplicate callback on the first duplicate spotted only
1567
+ if (proposer && count === 2) {
1568
+ this.duplicateProposalCallback?.({ slot: checkpoint.slotNumber, proposer, type: 'checkpoint' });
970
1569
  }
1570
+ return {
1571
+ result: TopicValidatorResult.Accept,
1572
+ obj: checkpoint,
1573
+ metadata: { isEquivocated, processBlock, isOversized },
1574
+ };
971
1575
  }
1576
+
1577
+ // Otherwise, we're good to go!
1578
+ return {
1579
+ result: TopicValidatorResult.Accept,
1580
+ obj: checkpoint,
1581
+ metadata: { processBlock, isEquivocated, isOversized },
1582
+ };
972
1583
  }
973
1584
 
974
1585
  /**
975
- * Broadcast an attestation to all peers.
976
- * @param attestation - The attestation to broadcast.
1586
+ * Process a validated checkpoint proposal.
1587
+ * Note: The proposal was already added to the pool by tryAddCheckpointProposal in handleGossipedCheckpointProposal.
977
1588
  */
978
- @trackSpan('Libp2pService.broadcastAttestation', async attestation => ({
979
- [Attributes.SLOT_NUMBER]: attestation.payload.header.slotNumber,
980
- [Attributes.BLOCK_ARCHIVE]: attestation.archive.toString(),
981
- [Attributes.P2P_ID]: await attestation.p2pMessageLoggingIdentifier().then(i => i.toString()),
1589
+ @trackSpan('Libp2pService.processValidCheckpointProposal', async checkpoint => ({
1590
+ [Attributes.SLOT_NUMBER]: checkpoint.slotNumber,
1591
+ [Attributes.BLOCK_ARCHIVE]: checkpoint.archive.toString(),
1592
+ [Attributes.P2P_ID]: await checkpoint.p2pMessageLoggingIdentifier().then(i => i.toString()),
982
1593
  }))
983
- private async broadcastAttestation(attestation: BlockAttestation) {
984
- await this.propagate(attestation);
1594
+ protected async processValidCheckpointProposal(checkpoint: CheckpointProposalCore, sender: PeerId) {
1595
+ const slot = checkpoint.slotNumber;
1596
+ this.logger.verbose(`Received checkpoint proposal for slot ${slot} from external peer ${sender.toString()}.`, {
1597
+ p2pMessageIdentifier: await checkpoint.p2pMessageLoggingIdentifier(),
1598
+ slot: checkpoint.slotNumber,
1599
+ archive: checkpoint.archive.toString(),
1600
+ source: sender.toString(),
1601
+ });
1602
+
1603
+ await this.allNodesCheckpointReceivedCallback(checkpoint, sender);
1604
+
1605
+ // Call the checkpoint received callback with the core version (without lastBlock)
1606
+ // to validate and potentially generate attestations
1607
+ const attestations = await this.validatorCheckpointReceivedCallback(checkpoint, sender);
1608
+ if (attestations && attestations.length > 0) {
1609
+ // If the callback returned attestations, add them to the pool and propagate them
1610
+ await this.mempools.attestationPool.addOwnCheckpointAttestations(attestations);
1611
+ for (const attestation of attestations) {
1612
+ await this.propagate(attestation);
1613
+ }
1614
+ }
985
1615
  }
986
1616
 
987
1617
  /**
@@ -997,82 +1627,87 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
997
1627
  }
998
1628
 
999
1629
  /**
1000
- * Validate the requested block transactions. Allow partial returns.
1630
+ * Validate the requested block transactions request-response consistency.
1631
+ * It does NOT validate the transactions themselves.
1001
1632
  * @param request - The block transactions request.
1002
1633
  * @param response - The block transactions response.
1003
1634
  * @param peerId - The ID of the peer that made the request.
1004
- * @returns True if the requested block transactions are valid, false otherwise.
1635
+ * @returns True if the request-response is consistent, false otherwise.
1005
1636
  */
1006
- @trackSpan('Libp2pService.validateRequestedBlockTxs', request => ({
1007
- [Attributes.BLOCK_HASH]: request.blockHash.toString(),
1637
+ @trackSpan('Libp2pService.validateRequestedBlockTxsConsistency', request => ({
1638
+ [Attributes.BLOCK_ARCHIVE]: request.archiveRoot.toString(),
1008
1639
  }))
1009
- private async validateRequestedBlockTxs(
1640
+ protected async validateRequestedBlockTxsConsistency(
1010
1641
  request: BlockTxsRequest,
1011
1642
  response: BlockTxsResponse,
1012
1643
  peerId: PeerId,
1013
1644
  ): Promise<boolean> {
1014
- const requestedTxValidator = this.createRequestedTxValidator();
1015
-
1016
1645
  try {
1017
- if (!response.blockHash.equals(request.blockHash)) {
1646
+ // Check for duplicates txs (or hashes) in the response.
1647
+ const returnedHashes = response.txs.map(tx => tx.getTxHash().toString());
1648
+ const uniqueReturned = new Set(returnedHashes.map(h => h.toString()));
1649
+ if (uniqueReturned.size !== returnedHashes.length) {
1018
1650
  this.peerManager.penalizePeer(peerId, PeerErrorSeverity.MidToleranceError);
1019
- throw new ValidationError(
1020
- `Received block txs for unexpected block: expected ${request.blockHash.toString()}, got ${response.blockHash.toString()}`,
1651
+ throw new ValidationError(`Received duplicate txs in block txs response`);
1652
+ }
1653
+
1654
+ // We get the block tx hashes from the proposal or the archiver.
1655
+ const proposal = await this.mempools.attestationPool.getBlockProposalByArchive(request.archiveRoot.toString());
1656
+ const blockTxHashes =
1657
+ proposal?.txHashes ??
1658
+ (await this.archiver.getBlock({ archive: request.archiveRoot }))?.body.txEffects.map(e => e.txHash);
1659
+
1660
+ // If we don't have the block, we can't verify membership/order of the returned txs.
1661
+ if (!blockTxHashes) {
1662
+ // This shouldn't happen, since we asked for the block (proposal).
1663
+ // Neither a local proposal nor an archived block: we cannot verify membership/order of the
1664
+ // returned txs. This is a local-state gap, not a peer fault, so we do not penalize.
1665
+ this.logger.warn(
1666
+ `Block ${request.archiveRoot.toString()} not found in attestation pool or archiver; cannot validate membership/order of returned txs`,
1021
1667
  );
1668
+ // NOTE: We mark the response as invalid, given the limitations of a true/false return value.
1669
+ return false;
1022
1670
  }
1023
1671
 
1024
- if (response.txIndices.getLength() !== request.txIndices.getLength()) {
1025
- this.peerManager.penalizePeer(peerId, PeerErrorSeverity.MidToleranceError);
1672
+ // Verify that the returned tx hashes are a subset of (tx hashes by index) U (explicitly requested tx hashes).
1673
+ const uniqueRequestedHashes = new Set([
1674
+ // tx hashes requested by index.
1675
+ ...request.txIndices.getTrueIndices().map(i => blockTxHashes[i].toString()),
1676
+ // explicitly requested tx hashes.
1677
+ ...request.txHashes.map(h => h.toString()),
1678
+ ]);
1679
+ if (!returnedHashes.every(h => uniqueRequestedHashes.has(h))) {
1680
+ this.peerManager.penalizePeer(peerId, PeerErrorSeverity.LowToleranceError);
1026
1681
  throw new ValidationError(
1027
- `Received block txs with mismatched bitvector length: expected ${request.txIndices.getLength()}, got ${response.txIndices.getLength()}`,
1682
+ 'Returned txs should be a subset of (tx hashes by index) U (explicitly requested tx hashes)',
1028
1683
  );
1029
1684
  }
1030
1685
 
1031
- // Check no duplicates and not exceeding returnable count
1032
- const requestedIndices = new Set(request.txIndices.getTrueIndices());
1033
- const availableIndices = new Set(response.txIndices.getTrueIndices());
1034
- const maxReturnable = [...requestedIndices].filter(i => availableIndices.has(i)).length;
1035
-
1036
- const returnedHashes = await Promise.all(response.txs.map(tx => tx.getTxHash().toString()));
1037
- const uniqueReturned = new Set(returnedHashes.map(h => h.toString()));
1038
- if (uniqueReturned.size !== returnedHashes.length) {
1039
- this.peerManager.penalizePeer(peerId, PeerErrorSeverity.MidToleranceError);
1040
- throw new ValidationError(`Received duplicate txs in block txs response`);
1686
+ // Tx indices information is optional, but if present, we need to verify a few things.
1687
+ if (!response.peerHasBlock()) {
1688
+ this.logger.debug(`Peer ${peerId.toString()} signalled missing block`);
1689
+ return true;
1041
1690
  }
1042
- if (response.txs.length > maxReturnable) {
1691
+
1692
+ // If the response has a non-empty bitvector, it needs to be consistent with the number of txs in the block.
1693
+ if (response.txIndices.getLength() !== blockTxHashes.length) {
1043
1694
  this.peerManager.penalizePeer(peerId, PeerErrorSeverity.MidToleranceError);
1044
1695
  throw new ValidationError(
1045
- `Received more txs (${response.txs.length}) than requested-and-available (${maxReturnable})`,
1696
+ `Received block txs with mismatched bitvector length: expected ${blockTxHashes.length}, got ${response.txIndices.getLength()}`,
1046
1697
  );
1047
1698
  }
1048
1699
 
1049
- // Given proposal (should have locally), ensure returned txs are valid subset and match request indices
1050
- const proposal = await this.mempools.attestationPool?.getBlockProposal(request.blockHash.toString());
1051
- if (proposal) {
1052
- // Build intersected indices
1053
- const intersectIdx = request.txIndices.getTrueIndices().filter(i => response.txIndices.isSet(i));
1054
-
1055
- // Enforce subset membership and preserve increasing order by index.
1056
- const hashToIndexInProposal = new Map<string, number>(
1057
- proposal.txHashes.map((h, i) => [h.toString(), i] as [string, number]),
1058
- );
1059
- const allowedIndexSet = new Set(intersectIdx);
1060
- const indices = returnedHashes.map(h => hashToIndexInProposal.get(h));
1061
- const allAllowed = indices.every(idx => idx !== undefined && allowedIndexSet.has(idx));
1062
- const strictlyIncreasing = indices.every((idx, i) => (i === 0 ? idx !== undefined : idx! > indices[i - 1]!));
1063
- if (!allAllowed || !strictlyIncreasing) {
1064
- this.peerManager.penalizePeer(peerId, PeerErrorSeverity.LowToleranceError);
1065
- throw new ValidationError('Returned txs do not match expected subset/order for requested indices');
1066
- }
1067
- } else {
1068
- // No local proposal, cannot check the membership/order of the returned txs
1069
- this.logger.warn(
1070
- `Block proposal not found for block hash ${request.blockHash.toString()}; cannot validate membership/order of returned txs`,
1071
- );
1072
- return false;
1700
+ // For every index we requested that the peer claims to have (per its bitvector), the
1701
+ // corresponding tx must be present in the response. A peer advertising availability but
1702
+ // withholding the tx is inconsistent.
1703
+ const returnedHashSet = new Set(returnedHashes);
1704
+ const expectedIndices = request.txIndices.getTrueIndices().filter(i => response.txIndices.isSet(i));
1705
+ const missingExpected = expectedIndices.some(i => !returnedHashSet.has(blockTxHashes[i].toString()));
1706
+ if (missingExpected) {
1707
+ this.peerManager.penalizePeer(peerId, PeerErrorSeverity.LowToleranceError);
1708
+ throw new ValidationError('Peer advertised requested txs via indices but did not return them');
1073
1709
  }
1074
1710
 
1075
- await Promise.all(response.txs.map(tx => this.validateRequestedTx(tx, peerId, requestedTxValidator)));
1076
1711
  return true;
1077
1712
  } catch (e: any) {
1078
1713
  if (e instanceof ValidationError) {
@@ -1085,218 +1720,85 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1085
1720
  }
1086
1721
  }
1087
1722
 
1088
- /**
1089
- * Validate a collection of txs that has been requested from a peer.
1090
- *
1091
- * The core component of this validator is that each tx hash MUST match the requested tx hash,
1092
- * In order to perform this check, the tx proof must be verified.
1093
- *
1094
- * Note: This function is called from within `ReqResp.sendRequest` as part of the
1095
- * ReqRespSubProtocol.TX subprotocol validation.
1096
- *
1097
- * @param requestedTxHash - The collection of the txs that was requested.
1098
- * @param responseTx - The collection of txs that was received as a response to the request.
1099
- * @param peerId - The peer ID of the peer that sent the tx.
1100
- * @returns True if the whole collection of txs is valid, false otherwise.
1101
- */
1102
- @trackSpan('Libp2pService.validateRequestedTx', (requestedTxHash, _responseTx) => ({
1103
- [Attributes.TX_HASH]: requestedTxHash.toString(),
1104
- }))
1105
- private async validateRequestedTxs(requestedTxHash: TxHash[], responseTx: Tx[], peerId: PeerId): Promise<boolean> {
1106
- const requested = new Set(requestedTxHash.map(h => h.toString()));
1107
- const requestedTxValidator = this.createRequestedTxValidator();
1108
-
1109
- //TODO: (mralj) - this is somewhat naive implementation, if single tx is invlid we consider the whole response invalid.
1110
- // I think we should still extract the valid txs and return them, so that we can still use the response.
1111
- try {
1112
- await Promise.all(responseTx.map(tx => this.validateRequestedTx(tx, peerId, requestedTxValidator, requested)));
1113
- return true;
1114
- } catch (e: any) {
1115
- if (e instanceof ValidationError) {
1116
- this.logger.warn(`Failed to validate requested txs from peer ${peerId.toString()}, reason ${e.message}`);
1117
- } else {
1118
- this.logger.error(`Error during validation of requested txs`, e);
1119
- }
1120
-
1121
- return false;
1122
- }
1723
+ private getGasFees(): Promise<GasFees> {
1724
+ return this.blockMinFeesProvider.getCurrentMinFees();
1123
1725
  }
1124
1726
 
1125
1727
  /**
1126
- * Validates a BLOCK response.
1127
- *
1128
- * If a local copy exists, enforces hash equality. If missing, rejects (no penalty) since the hash cannot be verified.
1129
- * Penalizes on block number mismatch or hash mismatch.
1130
- *
1131
- * @param requestedBlockNumber - The requested block number.
1132
- * @param responseBlock - The block returned by the peer.
1133
- * @param peerId - The peer that returned the block.
1134
- * @returns True if the response is valid, false otherwise.
1728
+ * Get the BatchTxRequesterLibP2PService dependencies for creating BatchTxRequester instances
1135
1729
  */
1136
- @trackSpan('Libp2pService.validateRequestedBlock', (requestedBlockNumber, _responseBlock) => ({
1137
- [Attributes.BLOCK_NUMBER]: requestedBlockNumber.toString(),
1138
- }))
1139
- private async validateRequestedBlock(
1140
- requestedBlockNumber: Fr,
1141
- responseBlock: L2Block,
1142
- peerId: PeerId,
1143
- ): Promise<boolean> {
1144
- try {
1145
- const reqNum = Number(requestedBlockNumber.toString());
1146
- if (responseBlock.number !== reqNum) {
1147
- this.peerManager.penalizePeer(peerId, PeerErrorSeverity.LowToleranceError);
1148
- return false;
1149
- }
1150
-
1151
- const local = await this.archiver.getBlock(BlockNumber(reqNum));
1152
- if (!local) {
1153
- // We are missing the local block; we cannot verify the hash yet. Reject without penalizing.
1154
- // TODO: Consider extending this validator to accept an expected hash or
1155
- // performing quorum-based checks when using P2P syncing prior to L1 sync.
1156
- this.logger.warn(`Local block ${reqNum} not found; rejecting BLOCK response without hash verification`);
1157
- return false;
1158
- }
1159
- const [localHash, respHash] = await Promise.all([local.hash(), responseBlock.hash()]);
1160
- if (!localHash.equals(respHash)) {
1161
- this.peerManager.penalizePeer(peerId, PeerErrorSeverity.MidToleranceError);
1162
- return false;
1163
- }
1164
-
1165
- return true;
1166
- } catch (e) {
1167
- this.logger.warn(`Error validating requested block`, e);
1168
- return false;
1169
- }
1730
+ public getBatchTxRequesterService(): BatchTxRequesterLibP2PService {
1731
+ return {
1732
+ reqResp: this.reqresp,
1733
+ connectionSampler: this.reqresp.getConnectionSampler(),
1734
+ txValidatorConfig: {
1735
+ l1ChainId: this.config.l1ChainId,
1736
+ rollupVersion: this.config.rollupVersion,
1737
+ proofVerifier: this.proofVerifier,
1738
+ txValidationCache: this.txValidationCache,
1739
+ },
1740
+ peerScoring: this.peerManager,
1741
+ validateRequestedBlockTxsConsistency: this.validateRequestedBlockTxsConsistency.bind(this),
1742
+ };
1170
1743
  }
1171
1744
 
1172
- private createRequestedTxValidator(): TxValidator {
1173
- return new AggregateTxValidator(
1174
- new DataTxValidator(),
1175
- new MetadataTxValidator({
1176
- l1ChainId: new Fr(this.config.l1ChainId),
1177
- rollupVersion: new Fr(this.config.rollupVersion),
1178
- protocolContractsHash,
1179
- vkTreeRoot: getVKTreeRoot(),
1180
- }),
1181
- new TxProofValidator(this.proofVerifier),
1745
+ public async validateTxsReceivedInBlockProposal(txs: Tx[]): Promise<void> {
1746
+ const validator = createTxValidatorForBlockProposalReceivedTxs(
1747
+ this.proofVerifier,
1748
+ { l1ChainId: this.config.l1ChainId, rollupVersion: this.config.rollupVersion },
1749
+ this.logger.getBindings(),
1750
+ this.txValidationCache,
1182
1751
  );
1183
- }
1184
-
1185
- private async validateRequestedTx(tx: Tx, peerId: PeerId, txValidator: TxValidator, requested?: Set<`0x${string}`>) {
1186
- const penalize = (severity: PeerErrorSeverity) => this.peerManager.penalizePeer(peerId, severity);
1187
-
1188
- if (!(await tx.validateTxHash())) {
1189
- penalize(PeerErrorSeverity.MidToleranceError);
1190
- throw new ValidationError(`Received tx with invalid hash ${tx.getTxHash().toString()}.`);
1191
- }
1192
-
1193
- if (requested && !requested.has(tx.getTxHash().toString())) {
1194
- penalize(PeerErrorSeverity.MidToleranceError);
1195
- throw new ValidationError(`Received tx with hash ${tx.getTxHash().toString()} that was not requested.`);
1196
- }
1197
-
1198
- const { result } = await txValidator.validateTx(tx);
1199
- if (result === 'invalid') {
1200
- penalize(PeerErrorSeverity.LowToleranceError);
1201
- throw new ValidationError(`Received tx with hash ${tx.getTxHash().toString()} that is invalid.`);
1202
- }
1203
- }
1204
-
1205
- @trackSpan('Libp2pService.validatePropagatedTx', tx => ({
1206
- [Attributes.TX_HASH]: tx.getTxHash().toString(),
1207
- }))
1208
- private async validatePropagatedTx(tx: Tx, peerId: PeerId): Promise<boolean> {
1209
- const currentBlockNumber = await this.archiver.getBlockNumber();
1210
-
1211
- // We accept transactions if they are not expired by the next slot (checked based on the IncludeByTimestamp field)
1212
- const { ts: nextSlotTimestamp } = this.epochCache.getEpochAndSlotInNextL1Slot();
1213
- const messageValidators = await this.createMessageValidators(currentBlockNumber, nextSlotTimestamp);
1214
1752
 
1215
- for (const validator of messageValidators) {
1216
- const outcome = await this.runValidations(tx, validator);
1217
-
1218
- if (outcome.allPassed) {
1219
- continue;
1220
- }
1221
- const { name } = outcome.failure;
1222
- let { severity } = outcome.failure;
1223
-
1224
- // Double spend validator has a special case handler
1225
- if (name === 'doubleSpendValidator') {
1226
- const txBlockNumber = BlockNumber(currentBlockNumber + 1); // tx is expected to be in the next block
1227
- severity = await this.handleDoubleSpendFailure(tx, txBlockNumber);
1228
- }
1229
-
1230
- this.peerManager.penalizePeer(peerId, severity);
1231
- return false;
1232
- }
1233
- return true;
1234
- }
1235
-
1236
- private async getGasFees(blockNumber: BlockNumber): Promise<GasFees> {
1237
- if (blockNumber === this.feesCache?.blockNumber) {
1238
- return this.feesCache.gasFees;
1239
- }
1240
-
1241
- const header = await this.archiver.getBlockHeader(blockNumber);
1242
- const gasFees = header?.globalVariables.gasFees ?? GasFees.empty();
1243
- this.feesCache = { blockNumber, gasFees };
1244
- return gasFees;
1245
- }
1246
-
1247
- public async validate(txs: Tx[]): Promise<void> {
1248
- const currentBlockNumber = await this.archiver.getBlockNumber();
1249
-
1250
- // We accept transactions if they are not expired by the next slot (checked based on the IncludeByTimestamp field)
1251
- const { ts: nextSlotTimestamp } = this.epochCache.getEpochAndSlotInNextL1Slot();
1252
- const messageValidators = await this.createMessageValidators(currentBlockNumber, nextSlotTimestamp);
1253
-
1254
- await Promise.all(
1753
+ const results = await Promise.all(
1255
1754
  txs.map(async tx => {
1256
- for (const validator of messageValidators) {
1257
- const outcome = await this.runValidations(tx, validator);
1258
- if (!outcome.allPassed) {
1259
- throw new Error('Invalid tx detected', { cause: { outcome } });
1260
- }
1261
- }
1755
+ const result = await validator.validateTx(tx);
1756
+ return result.result !== 'invalid';
1262
1757
  }),
1263
1758
  );
1759
+ if (results.some(value => value === false)) {
1760
+ throw new Error('Invalid tx detected');
1761
+ }
1264
1762
  }
1265
1763
 
1266
- /**
1267
- * Create message validators for the given block number and timestamp.
1268
- *
1269
- * Each validator is a pair of a validator and a severity.
1270
- * If a validator fails, the peer is penalized with the severity of the validator.
1271
- *
1272
- * @param currentBlockNumber - The current synced block number.
1273
- * @param nextSlotTimestamp - The timestamp of the next slot (used to validate txs are not expired).
1274
- * @returns The message validators.
1275
- */
1276
- private async createMessageValidators(
1764
+ /** Creates the first stage (fast) validators for gossiped transactions. */
1765
+ protected async createFirstStageMessageValidators(
1277
1766
  currentBlockNumber: BlockNumber,
1278
1767
  nextSlotTimestamp: UInt64,
1279
- ): Promise<Record<string, MessageValidator>[]> {
1280
- const gasFees = await this.getGasFees(currentBlockNumber);
1281
- const allowedInSetup = this.config.txPublicSetupAllowList ?? (await getDefaultAllowedSetupFunctions());
1282
-
1283
- const blockNumberInWhichTheTxIsConsideredToBeIncluded = BlockNumber(currentBlockNumber + 1);
1284
-
1285
- return createTxMessageValidators(
1768
+ ): Promise<Record<string, TransactionValidator>> {
1769
+ const gasFees = await this.getGasFees();
1770
+ const allowedInSetup = [
1771
+ ...(await getDefaultAllowedSetupFunctions()),
1772
+ ...(this.config.txPublicSetupAllowListExtend ?? []),
1773
+ ];
1774
+ const blockNumber = BlockNumber(currentBlockNumber + 1);
1775
+ const l1Constants = await this.archiver.getL1Constants();
1776
+ const networkTxGasLimits = getNetworkTxGasLimits(this.config, l1Constants);
1777
+
1778
+ return createFirstStageTxValidationsForGossipedTransactions(
1286
1779
  nextSlotTimestamp,
1287
- blockNumberInWhichTheTxIsConsideredToBeIncluded,
1780
+ blockNumber,
1288
1781
  this.worldStateSynchronizer,
1289
1782
  gasFees,
1290
1783
  this.config.l1ChainId,
1291
1784
  this.config.rollupVersion,
1292
1785
  protocolContractsHash,
1293
1786
  this.archiver,
1294
- this.proofVerifier,
1295
1787
  !this.config.disableTransactions,
1296
1788
  allowedInSetup,
1789
+ this.logger.getBindings(),
1790
+ {
1791
+ maxTxL2Gas: networkTxGasLimits.l2Gas,
1792
+ maxTxDAGas: networkTxGasLimits.daGas,
1793
+ },
1297
1794
  );
1298
1795
  }
1299
1796
 
1797
+ /** Creates the second stage (expensive proof verification) validators for gossiped transactions. */
1798
+ protected createSecondStageMessageValidators(): Record<string, TransactionValidator> {
1799
+ return createSecondStageTxValidationsForGossipedTransactions(this.proofVerifier, this.logger.getBindings());
1800
+ }
1801
+
1300
1802
  /**
1301
1803
  * Run validations on a tx.
1302
1804
  * @param tx - The tx to validate.
@@ -1305,7 +1807,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1305
1807
  */
1306
1808
  private async runValidations(
1307
1809
  tx: Tx,
1308
- messageValidators: Record<string, MessageValidator>,
1810
+ messageValidators: Record<string, TransactionValidator>,
1309
1811
  ): Promise<ValidationOutcome> {
1310
1812
  const validationPromises = Object.entries(messageValidators).map(async ([name, { validator, severity }]) => {
1311
1813
  const { result } = await validator.validateTx(tx);
@@ -1314,8 +1816,10 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1314
1816
 
1315
1817
  // A promise that resolves when all validations have been run
1316
1818
  const allValidations = await Promise.all(validationPromises);
1317
- const failed = allValidations.find(x => !x.isValid);
1318
- if (failed) {
1819
+ const failures = allValidations.filter(x => !x.isValid);
1820
+ if (failures.length > 0) {
1821
+ // Pick the most severe failure (lowest tolerance = harshest penalty)
1822
+ const failed = maxBy(failures, f => PeerErrorSeverityByHarshness.indexOf(f.severity))!;
1319
1823
  return {
1320
1824
  allPassed: false,
1321
1825
  failure: {
@@ -1347,15 +1851,18 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1347
1851
  return PeerErrorSeverity.HighToleranceError;
1348
1852
  }
1349
1853
 
1350
- const snapshotValidator = new DoubleSpendTxValidator({
1351
- nullifiersExist: async (nullifiers: Buffer[]) => {
1352
- const merkleTree = this.worldStateSynchronizer.getSnapshot(
1353
- BlockNumber(blockNumber - this.config.doubleSpendSeverePeerPenaltyWindow),
1354
- );
1355
- const indices = await merkleTree.findLeafIndices(MerkleTreeId.NULLIFIER_TREE, nullifiers);
1356
- return indices.map(index => index !== undefined);
1854
+ const snapshotValidator = new DoubleSpendTxValidator(
1855
+ {
1856
+ nullifiersExist: async (nullifiers: Buffer[]) => {
1857
+ const merkleTree = this.worldStateSynchronizer.getSnapshot(
1858
+ BlockNumber(blockNumber - this.config.doubleSpendSeverePeerPenaltyWindow),
1859
+ );
1860
+ const indices = await merkleTree.findLeafIndices(MerkleTreeId.NULLIFIER_TREE, nullifiers);
1861
+ return indices.map(index => index !== undefined);
1862
+ },
1357
1863
  },
1358
- });
1864
+ this.logger.getBindings(),
1865
+ );
1359
1866
 
1360
1867
  const validSnapshot = await snapshotValidator.validateTx(tx);
1361
1868
  if (validSnapshot.result !== 'valid') {
@@ -1365,47 +1872,6 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1365
1872
  return PeerErrorSeverity.HighToleranceError;
1366
1873
  }
1367
1874
 
1368
- /**
1369
- * Validate an attestation.
1370
- *
1371
- * @param attestation - The attestation to validate.
1372
- * @returns True if the attestation is valid, false otherwise.
1373
- */
1374
- @trackSpan('Libp2pService.validateAttestation', async (_, attestation) => ({
1375
- [Attributes.SLOT_NUMBER]: attestation.payload.header.slotNumber,
1376
- [Attributes.BLOCK_ARCHIVE]: attestation.archive.toString(),
1377
- [Attributes.P2P_ID]: await attestation.p2pMessageLoggingIdentifier().then(i => i.toString()),
1378
- }))
1379
- public async validateAttestation(peerId: PeerId, attestation: BlockAttestation): Promise<boolean> {
1380
- const severity = await this.attestationValidator.validate(attestation);
1381
- if (severity) {
1382
- this.peerManager.penalizePeer(peerId, severity);
1383
- return false;
1384
- }
1385
-
1386
- return true;
1387
- }
1388
-
1389
- /**
1390
- * Validate a block proposal.
1391
- *
1392
- * @param block - The block proposal to validate.
1393
- * @returns True if the block proposal is valid, false otherwise.
1394
- */
1395
- @trackSpan('Libp2pService.validateBlockProposal', (_peerId, block) => ({
1396
- [Attributes.SLOT_NUMBER]: block.payload.header.slotNumber.toString(),
1397
- }))
1398
- public async validateBlockProposal(peerId: PeerId, block: BlockProposal): Promise<boolean> {
1399
- const severity = await this.blockProposalValidator.validate(block);
1400
- if (severity) {
1401
- this.logger.debug(`Penalizing peer ${peerId} for block proposal validation failure`);
1402
- this.peerManager.penalizePeer(peerId, severity);
1403
- return false;
1404
- }
1405
-
1406
- return true;
1407
- }
1408
-
1409
1875
  public getPeerScore(peerId: PeerId): number {
1410
1876
  return this.node.services.pubsub.score.score(peerId.toString());
1411
1877
  }