@aztec/p2p 0.0.1-commit.2ed92850 → 0.0.1-commit.3100065

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 (574) 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 -20
  8. package/dest/client/interface.d.ts +90 -40
  9. package/dest/client/interface.d.ts.map +1 -1
  10. package/dest/client/p2p_client.d.ts +69 -64
  11. package/dest/client/p2p_client.d.ts.map +1 -1
  12. package/dest/client/p2p_client.js +247 -244
  13. package/dest/config.d.ts +169 -84
  14. package/dest/config.d.ts.map +1 -1
  15. package/dest/config.js +159 -45
  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 +164 -106
  29. package/dest/mem_pools/attestation_pool/attestation_pool.d.ts.map +1 -1
  30. package/dest/mem_pools/attestation_pool/attestation_pool.js +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 +550 -125
  34. package/dest/mem_pools/attestation_pool/index.d.ts +2 -3
  35. package/dest/mem_pools/attestation_pool/index.d.ts.map +1 -1
  36. package/dest/mem_pools/attestation_pool/index.js +1 -2
  37. package/dest/mem_pools/attestation_pool/mocks.d.ts +2 -2
  38. package/dest/mem_pools/attestation_pool/mocks.d.ts.map +1 -1
  39. package/dest/mem_pools/attestation_pool/mocks.js +7 -5
  40. package/dest/mem_pools/index.d.ts +3 -3
  41. package/dest/mem_pools/index.d.ts.map +1 -1
  42. package/dest/mem_pools/index.js +1 -1
  43. package/dest/mem_pools/instrumentation.d.ts +12 -5
  44. package/dest/mem_pools/instrumentation.d.ts.map +1 -1
  45. package/dest/mem_pools/instrumentation.js +40 -19
  46. package/dest/mem_pools/interface.d.ts +5 -5
  47. package/dest/mem_pools/interface.d.ts.map +1 -1
  48. package/dest/mem_pools/tx_pool_v2/archive/index.d.ts +2 -0
  49. package/dest/mem_pools/tx_pool_v2/archive/index.d.ts.map +1 -0
  50. package/dest/mem_pools/tx_pool_v2/archive/index.js +1 -0
  51. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.d.ts +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 → tx_pool_v2}/eviction/invalid_txs_after_mining_rule.js +16 -35
  78. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.d.ts +17 -0
  79. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.d.ts.map +1 -0
  80. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.js +93 -0
  81. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.d.ts +16 -0
  82. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.d.ts.map +1 -0
  83. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.js +78 -0
  84. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.d.ts +20 -0
  85. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.d.ts.map +1 -0
  86. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.js +75 -0
  87. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.d.ts +15 -0
  88. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.d.ts.map +1 -0
  89. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.js +19 -0
  90. package/dest/mem_pools/tx_pool_v2/index.d.ts +6 -0
  91. package/dest/mem_pools/tx_pool_v2/index.d.ts.map +1 -0
  92. package/dest/mem_pools/tx_pool_v2/index.js +5 -0
  93. package/dest/mem_pools/tx_pool_v2/instrumentation.d.ts +15 -0
  94. package/dest/mem_pools/tx_pool_v2/instrumentation.d.ts.map +1 -0
  95. package/dest/mem_pools/tx_pool_v2/instrumentation.js +43 -0
  96. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts +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 +10 -3
  115. package/dest/msg_validators/attestation_validator/attestation_validator.d.ts.map +1 -1
  116. package/dest/msg_validators/attestation_validator/attestation_validator.js +38 -15
  117. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts +8 -4
  118. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts.map +1 -1
  119. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.js +11 -7
  120. package/dest/msg_validators/proposal_validator/block_proposal_validator.d.ts +12 -5
  121. package/dest/msg_validators/proposal_validator/block_proposal_validator.d.ts.map +1 -1
  122. package/dest/msg_validators/proposal_validator/block_proposal_validator.js +11 -3
  123. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.d.ts +12 -5
  124. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.d.ts.map +1 -1
  125. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.js +23 -3
  126. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts +36 -9
  127. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts.map +1 -1
  128. package/dest/msg_validators/proposal_validator/proposal_validator.js +133 -51
  129. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts +4 -4
  130. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts.map +1 -1
  131. package/dest/msg_validators/tx_validator/aggregate_tx_validator.js +11 -18
  132. package/dest/msg_validators/tx_validator/allowed_public_setup.d.ts +2 -1
  133. package/dest/msg_validators/tx_validator/allowed_public_setup.d.ts.map +1 -1
  134. package/dest/msg_validators/tx_validator/allowed_public_setup.js +25 -21
  135. package/dest/msg_validators/tx_validator/allowed_setup_helpers.d.ts +17 -0
  136. package/dest/msg_validators/tx_validator/allowed_setup_helpers.d.ts.map +1 -0
  137. package/dest/msg_validators/tx_validator/allowed_setup_helpers.js +24 -0
  138. package/dest/msg_validators/tx_validator/archive_cache.d.ts +3 -3
  139. package/dest/msg_validators/tx_validator/archive_cache.d.ts.map +1 -1
  140. package/dest/msg_validators/tx_validator/block_header_validator.d.ts +20 -6
  141. package/dest/msg_validators/tx_validator/block_header_validator.d.ts.map +1 -1
  142. package/dest/msg_validators/tx_validator/block_header_validator.js +5 -4
  143. package/dest/msg_validators/tx_validator/cached_tx_validator.d.ts +15 -0
  144. package/dest/msg_validators/tx_validator/cached_tx_validator.d.ts.map +1 -0
  145. package/dest/msg_validators/tx_validator/cached_tx_validator.js +19 -0
  146. package/dest/msg_validators/tx_validator/contract_instance_validator.d.ts +9 -0
  147. package/dest/msg_validators/tx_validator/contract_instance_validator.d.ts.map +1 -0
  148. package/dest/msg_validators/tx_validator/contract_instance_validator.js +48 -0
  149. package/dest/msg_validators/tx_validator/data_validator.d.ts +4 -1
  150. package/dest/msg_validators/tx_validator/data_validator.d.ts.map +1 -1
  151. package/dest/msg_validators/tx_validator/data_validator.js +40 -3
  152. package/dest/msg_validators/tx_validator/double_spend_validator.d.ts +15 -4
  153. package/dest/msg_validators/tx_validator/double_spend_validator.d.ts.map +1 -1
  154. package/dest/msg_validators/tx_validator/double_spend_validator.js +7 -6
  155. package/dest/msg_validators/tx_validator/factory.d.ts +136 -5
  156. package/dest/msg_validators/tx_validator/factory.d.ts.map +1 -1
  157. package/dest/msg_validators/tx_validator/factory.js +268 -58
  158. package/dest/msg_validators/tx_validator/fee_payer_balance.d.ts +1 -1
  159. package/dest/msg_validators/tx_validator/fee_payer_balance.d.ts.map +1 -1
  160. package/dest/msg_validators/tx_validator/fee_payer_balance.js +6 -2
  161. package/dest/msg_validators/tx_validator/gas_validator.d.ts +105 -3
  162. package/dest/msg_validators/tx_validator/gas_validator.d.ts.map +1 -1
  163. package/dest/msg_validators/tx_validator/gas_validator.js +138 -53
  164. package/dest/msg_validators/tx_validator/index.d.ts +5 -1
  165. package/dest/msg_validators/tx_validator/index.d.ts.map +1 -1
  166. package/dest/msg_validators/tx_validator/index.js +4 -0
  167. package/dest/msg_validators/tx_validator/metadata_validator.d.ts +3 -2
  168. package/dest/msg_validators/tx_validator/metadata_validator.d.ts.map +1 -1
  169. package/dest/msg_validators/tx_validator/metadata_validator.js +6 -6
  170. package/dest/msg_validators/tx_validator/nullifier_cache.d.ts +14 -0
  171. package/dest/msg_validators/tx_validator/nullifier_cache.d.ts.map +1 -0
  172. package/dest/msg_validators/tx_validator/nullifier_cache.js +24 -0
  173. package/dest/msg_validators/tx_validator/phases_validator.d.ts +24 -3
  174. package/dest/msg_validators/tx_validator/phases_validator.d.ts.map +1 -1
  175. package/dest/msg_validators/tx_validator/phases_validator.js +75 -27
  176. package/dest/msg_validators/tx_validator/size_validator.d.ts +3 -1
  177. package/dest/msg_validators/tx_validator/size_validator.d.ts.map +1 -1
  178. package/dest/msg_validators/tx_validator/size_validator.js +4 -1
  179. package/dest/msg_validators/tx_validator/timestamp_validator.d.ts +22 -5
  180. package/dest/msg_validators/tx_validator/timestamp_validator.d.ts.map +1 -1
  181. package/dest/msg_validators/tx_validator/timestamp_validator.js +8 -8
  182. package/dest/msg_validators/tx_validator/tx_permitted_validator.d.ts +3 -2
  183. package/dest/msg_validators/tx_validator/tx_permitted_validator.d.ts.map +1 -1
  184. package/dest/msg_validators/tx_validator/tx_permitted_validator.js +2 -2
  185. package/dest/msg_validators/tx_validator/tx_proof_validator.d.ts +4 -2
  186. package/dest/msg_validators/tx_validator/tx_proof_validator.d.ts.map +1 -1
  187. package/dest/msg_validators/tx_validator/tx_proof_validator.js +4 -2
  188. package/dest/msg_validators/tx_validator/tx_validation_cache.d.ts +48 -0
  189. package/dest/msg_validators/tx_validator/tx_validation_cache.d.ts.map +1 -0
  190. package/dest/msg_validators/tx_validator/tx_validation_cache.js +68 -0
  191. package/dest/services/data_store.d.ts +1 -1
  192. package/dest/services/data_store.d.ts.map +1 -1
  193. package/dest/services/data_store.js +14 -10
  194. package/dest/services/discv5/discV5_service.d.ts +13 -2
  195. package/dest/services/discv5/discV5_service.d.ts.map +1 -1
  196. package/dest/services/discv5/discV5_service.js +120 -24
  197. package/dest/services/discv5/persisted_enr_store.d.ts +38 -0
  198. package/dest/services/discv5/persisted_enr_store.d.ts.map +1 -0
  199. package/dest/services/discv5/persisted_enr_store.js +145 -0
  200. package/dest/services/dummy_service.d.ts +37 -17
  201. package/dest/services/dummy_service.d.ts.map +1 -1
  202. package/dest/services/dummy_service.js +59 -15
  203. package/dest/services/encoding.d.ts +24 -7
  204. package/dest/services/encoding.d.ts.map +1 -1
  205. package/dest/services/encoding.js +43 -26
  206. package/dest/services/gossipsub/index.d.ts +3 -0
  207. package/dest/services/gossipsub/index.d.ts.map +1 -0
  208. package/dest/services/gossipsub/index.js +2 -0
  209. package/dest/services/gossipsub/scoring.d.ts +21 -3
  210. package/dest/services/gossipsub/scoring.d.ts.map +1 -1
  211. package/dest/services/gossipsub/scoring.js +24 -7
  212. package/dest/services/gossipsub/topic_score_params.d.ts +167 -0
  213. package/dest/services/gossipsub/topic_score_params.d.ts.map +1 -0
  214. package/dest/services/gossipsub/topic_score_params.js +336 -0
  215. package/dest/services/index.d.ts +2 -1
  216. package/dest/services/index.d.ts.map +1 -1
  217. package/dest/services/index.js +1 -0
  218. package/dest/services/libp2p/instrumentation.d.ts +3 -1
  219. package/dest/services/libp2p/instrumentation.d.ts.map +1 -1
  220. package/dest/services/libp2p/instrumentation.js +28 -3
  221. package/dest/services/libp2p/libp2p_service.d.ts +116 -60
  222. package/dest/services/libp2p/libp2p_service.d.ts.map +1 -1
  223. package/dest/services/libp2p/libp2p_service.js +800 -586
  224. package/dest/services/peer-manager/metrics.d.ts +4 -2
  225. package/dest/services/peer-manager/metrics.d.ts.map +1 -1
  226. package/dest/services/peer-manager/metrics.js +26 -5
  227. package/dest/services/peer-manager/peer_manager.d.ts +20 -3
  228. package/dest/services/peer-manager/peer_manager.d.ts.map +1 -1
  229. package/dest/services/peer-manager/peer_manager.js +83 -26
  230. package/dest/services/peer-manager/peer_scoring.d.ts +34 -2
  231. package/dest/services/peer-manager/peer_scoring.d.ts.map +1 -1
  232. package/dest/services/peer-manager/peer_scoring.js +135 -17
  233. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts +44 -0
  234. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts.map +1 -0
  235. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.js +534 -0
  236. package/dest/services/reqresp/batch-tx-requester/config.d.ts +17 -0
  237. package/dest/services/reqresp/batch-tx-requester/config.d.ts.map +1 -0
  238. package/dest/services/reqresp/batch-tx-requester/config.js +27 -0
  239. package/dest/services/reqresp/batch-tx-requester/interface.d.ts +50 -0
  240. package/dest/services/reqresp/batch-tx-requester/interface.d.ts.map +1 -0
  241. package/dest/services/reqresp/batch-tx-requester/interface.js +1 -0
  242. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts +35 -0
  243. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts.map +1 -0
  244. package/dest/services/reqresp/batch-tx-requester/missing_txs.js +136 -0
  245. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts +62 -0
  246. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts.map +1 -0
  247. package/dest/services/reqresp/batch-tx-requester/peer_collection.js +176 -0
  248. package/dest/services/reqresp/batch-tx-requester/tx_validator.d.ts +11 -0
  249. package/dest/services/reqresp/batch-tx-requester/tx_validator.d.ts.map +1 -0
  250. package/dest/services/reqresp/batch-tx-requester/tx_validator.js +7 -0
  251. package/dest/services/reqresp/config.d.ts +15 -3
  252. package/dest/services/reqresp/config.d.ts.map +1 -1
  253. package/dest/services/reqresp/config.js +11 -0
  254. package/dest/services/reqresp/connection-sampler/connection_sampler.d.ts +2 -1
  255. package/dest/services/reqresp/connection-sampler/connection_sampler.d.ts.map +1 -1
  256. package/dest/services/reqresp/connection-sampler/connection_sampler.js +12 -0
  257. package/dest/services/reqresp/interface.d.ts +27 -18
  258. package/dest/services/reqresp/interface.d.ts.map +1 -1
  259. package/dest/services/reqresp/interface.js +23 -19
  260. package/dest/services/reqresp/metrics.d.ts +6 -5
  261. package/dest/services/reqresp/metrics.d.ts.map +1 -1
  262. package/dest/services/reqresp/metrics.js +16 -5
  263. package/dest/services/reqresp/protocols/block_txs/bitvector.d.ts +8 -3
  264. package/dest/services/reqresp/protocols/block_txs/bitvector.d.ts.map +1 -1
  265. package/dest/services/reqresp/protocols/block_txs/bitvector.js +8 -2
  266. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts +7 -5
  267. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts.map +1 -1
  268. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.js +35 -14
  269. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts +36 -8
  270. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts.map +1 -1
  271. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.js +84 -20
  272. package/dest/services/reqresp/protocols/index.d.ts +1 -2
  273. package/dest/services/reqresp/protocols/index.d.ts.map +1 -1
  274. package/dest/services/reqresp/protocols/index.js +0 -1
  275. package/dest/services/reqresp/protocols/tx.d.ts +7 -1
  276. package/dest/services/reqresp/protocols/tx.d.ts.map +1 -1
  277. package/dest/services/reqresp/protocols/tx.js +21 -3
  278. package/dest/services/reqresp/rate-limiter/rate_limiter.d.ts +5 -4
  279. package/dest/services/reqresp/rate-limiter/rate_limiter.d.ts.map +1 -1
  280. package/dest/services/reqresp/rate-limiter/rate_limiter.js +10 -8
  281. package/dest/services/reqresp/rate-limiter/rate_limits.d.ts +1 -1
  282. package/dest/services/reqresp/rate-limiter/rate_limits.d.ts.map +1 -1
  283. package/dest/services/reqresp/rate-limiter/rate_limits.js +3 -13
  284. package/dest/services/reqresp/reqresp.d.ts +12 -29
  285. package/dest/services/reqresp/reqresp.d.ts.map +1 -1
  286. package/dest/services/reqresp/reqresp.js +90 -188
  287. package/dest/services/service.d.ts +65 -13
  288. package/dest/services/service.d.ts.map +1 -1
  289. package/dest/services/tx_collection/config.d.ts +11 -11
  290. package/dest/services/tx_collection/config.d.ts.map +1 -1
  291. package/dest/services/tx_collection/config.js +27 -26
  292. package/dest/services/tx_collection/file_store_tx_collection.d.ts +37 -0
  293. package/dest/services/tx_collection/file_store_tx_collection.d.ts.map +1 -0
  294. package/dest/services/tx_collection/file_store_tx_collection.js +127 -0
  295. package/dest/services/tx_collection/file_store_tx_source.d.ts +38 -0
  296. package/dest/services/tx_collection/file_store_tx_source.d.ts.map +1 -0
  297. package/dest/services/tx_collection/file_store_tx_source.js +100 -0
  298. package/dest/services/tx_collection/index.d.ts +3 -2
  299. package/dest/services/tx_collection/index.d.ts.map +1 -1
  300. package/dest/services/tx_collection/index.js +1 -0
  301. package/dest/services/tx_collection/instrumentation.d.ts +1 -1
  302. package/dest/services/tx_collection/instrumentation.d.ts.map +1 -1
  303. package/dest/services/tx_collection/instrumentation.js +8 -2
  304. package/dest/services/tx_collection/request_tracker.d.ts +53 -0
  305. package/dest/services/tx_collection/request_tracker.d.ts.map +1 -0
  306. package/dest/services/tx_collection/request_tracker.js +84 -0
  307. package/dest/services/tx_collection/tx_collection.d.ts +47 -53
  308. package/dest/services/tx_collection/tx_collection.d.ts.map +1 -1
  309. package/dest/services/tx_collection/tx_collection.js +298 -70
  310. package/dest/services/tx_collection/tx_collection_sink.d.ts +19 -9
  311. package/dest/services/tx_collection/tx_collection_sink.d.ts.map +1 -1
  312. package/dest/services/tx_collection/tx_collection_sink.js +28 -31
  313. package/dest/services/tx_collection/tx_source.d.ts +13 -7
  314. package/dest/services/tx_collection/tx_source.d.ts.map +1 -1
  315. package/dest/services/tx_collection/tx_source.js +29 -7
  316. package/dest/services/tx_file_store/config.d.ts +16 -0
  317. package/dest/services/tx_file_store/config.d.ts.map +1 -0
  318. package/dest/services/tx_file_store/config.js +22 -0
  319. package/dest/services/tx_file_store/index.d.ts +4 -0
  320. package/dest/services/tx_file_store/index.d.ts.map +1 -0
  321. package/dest/services/tx_file_store/index.js +3 -0
  322. package/dest/services/tx_file_store/instrumentation.d.ts +15 -0
  323. package/dest/services/tx_file_store/instrumentation.d.ts.map +1 -0
  324. package/dest/services/tx_file_store/instrumentation.js +29 -0
  325. package/dest/services/tx_file_store/tx_file_store.d.ts +46 -0
  326. package/dest/services/tx_file_store/tx_file_store.d.ts.map +1 -0
  327. package/dest/services/tx_file_store/tx_file_store.js +142 -0
  328. package/dest/services/tx_provider.d.ts +6 -4
  329. package/dest/services/tx_provider.d.ts.map +1 -1
  330. package/dest/services/tx_provider.js +12 -8
  331. package/dest/services/tx_provider_instrumentation.d.ts +1 -1
  332. package/dest/services/tx_provider_instrumentation.d.ts.map +1 -1
  333. package/dest/services/tx_provider_instrumentation.js +5 -5
  334. package/dest/test-helpers/index.d.ts +3 -1
  335. package/dest/test-helpers/index.d.ts.map +1 -1
  336. package/dest/test-helpers/index.js +2 -0
  337. package/dest/test-helpers/make-test-p2p-clients.d.ts +7 -8
  338. package/dest/test-helpers/make-test-p2p-clients.d.ts.map +1 -1
  339. package/dest/test-helpers/make-test-p2p-clients.js +5 -3
  340. package/dest/test-helpers/mock-pubsub.d.ts +46 -6
  341. package/dest/test-helpers/mock-pubsub.d.ts.map +1 -1
  342. package/dest/test-helpers/mock-pubsub.js +115 -14
  343. package/dest/test-helpers/reqresp-nodes.d.ts +5 -7
  344. package/dest/test-helpers/reqresp-nodes.d.ts.map +1 -1
  345. package/dest/test-helpers/reqresp-nodes.js +19 -20
  346. package/dest/test-helpers/test_tx_provider.d.ts +42 -0
  347. package/dest/test-helpers/test_tx_provider.d.ts.map +1 -0
  348. package/dest/test-helpers/test_tx_provider.js +44 -0
  349. package/dest/test-helpers/testbench-utils.d.ts +164 -0
  350. package/dest/test-helpers/testbench-utils.d.ts.map +1 -0
  351. package/dest/test-helpers/testbench-utils.js +400 -0
  352. package/dest/testbench/p2p_client_testbench_worker.d.ts +26 -2
  353. package/dest/testbench/p2p_client_testbench_worker.d.ts.map +1 -1
  354. package/dest/testbench/p2p_client_testbench_worker.js +284 -140
  355. package/dest/testbench/worker_client_manager.d.ts +57 -6
  356. package/dest/testbench/worker_client_manager.d.ts.map +1 -1
  357. package/dest/testbench/worker_client_manager.js +277 -49
  358. package/dest/util.d.ts +13 -8
  359. package/dest/util.d.ts.map +1 -1
  360. package/dest/util.js +35 -14
  361. package/dest/versioning.d.ts +3 -6
  362. package/dest/versioning.d.ts.map +1 -1
  363. package/dest/versioning.js +3 -24
  364. package/package.json +16 -16
  365. package/src/bootstrap/bootstrap.ts +24 -7
  366. package/src/client/factory.ts +139 -39
  367. package/src/client/interface.ts +97 -48
  368. package/src/client/p2p_client.ts +289 -310
  369. package/src/client/test/p2p_client.batch_tx_requester.bench.README.md +197 -0
  370. package/src/config.ts +287 -49
  371. package/src/errors/p2p-service.error.ts +11 -0
  372. package/src/errors/reqresp.error.ts +13 -19
  373. package/src/errors/tx-pool.error.ts +12 -0
  374. package/src/index.ts +1 -1
  375. package/src/mem_pools/attestation_pool/attestation_pool.ts +585 -94
  376. package/src/mem_pools/attestation_pool/attestation_pool_test_suite.ts +656 -141
  377. package/src/mem_pools/attestation_pool/index.ts +9 -2
  378. package/src/mem_pools/attestation_pool/mocks.ts +14 -8
  379. package/src/mem_pools/index.ts +2 -2
  380. package/src/mem_pools/instrumentation.ts +29 -18
  381. package/src/mem_pools/interface.ts +4 -4
  382. package/src/mem_pools/tx_pool_v2/README.md +283 -0
  383. package/src/mem_pools/tx_pool_v2/archive/index.ts +1 -0
  384. package/src/mem_pools/tx_pool_v2/archive/tx_archive.ts +112 -0
  385. package/src/mem_pools/tx_pool_v2/deleted_pool.ts +321 -0
  386. package/src/mem_pools/tx_pool_v2/eviction/eviction_manager.ts +160 -0
  387. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.ts +122 -0
  388. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.ts +125 -0
  389. package/src/mem_pools/tx_pool_v2/eviction/index.ts +28 -0
  390. package/src/mem_pools/tx_pool_v2/eviction/insufficient_fee_per_gas_eviction_rule.ts +65 -0
  391. package/src/mem_pools/tx_pool_v2/eviction/interfaces.ts +219 -0
  392. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.ts +74 -0
  393. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.ts +101 -0
  394. package/src/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.ts +91 -0
  395. package/src/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.ts +99 -0
  396. package/src/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.ts +32 -0
  397. package/src/mem_pools/tx_pool_v2/index.ts +12 -0
  398. package/src/mem_pools/tx_pool_v2/instrumentation.ts +69 -0
  399. package/src/mem_pools/tx_pool_v2/interfaces.ts +274 -0
  400. package/src/mem_pools/tx_pool_v2/tx_metadata.ts +349 -0
  401. package/src/mem_pools/tx_pool_v2/tx_pool_bench_metrics.ts +77 -0
  402. package/src/mem_pools/tx_pool_v2/tx_pool_indices.ts +465 -0
  403. package/src/mem_pools/tx_pool_v2/tx_pool_v2.ts +252 -0
  404. package/src/mem_pools/tx_pool_v2/tx_pool_v2_impl.ts +1215 -0
  405. package/src/msg_validators/attestation_validator/README.md +49 -0
  406. package/src/msg_validators/attestation_validator/attestation_validator.ts +46 -14
  407. package/src/msg_validators/attestation_validator/fisherman_attestation_validator.ts +25 -11
  408. package/src/msg_validators/proposal_validator/README.md +123 -0
  409. package/src/msg_validators/proposal_validator/block_proposal_validator.ts +26 -4
  410. package/src/msg_validators/proposal_validator/checkpoint_proposal_validator.ts +43 -7
  411. package/src/msg_validators/proposal_validator/proposal_validator.ts +157 -51
  412. package/src/msg_validators/tx_validator/README.md +129 -0
  413. package/src/msg_validators/tx_validator/aggregate_tx_validator.ts +8 -17
  414. package/src/msg_validators/tx_validator/allowed_public_setup.ts +22 -27
  415. package/src/msg_validators/tx_validator/allowed_setup_helpers.ts +31 -0
  416. package/src/msg_validators/tx_validator/archive_cache.ts +2 -2
  417. package/src/msg_validators/tx_validator/block_header_validator.ts +22 -11
  418. package/src/msg_validators/tx_validator/cached_tx_validator.ts +31 -0
  419. package/src/msg_validators/tx_validator/contract_instance_validator.ts +56 -0
  420. package/src/msg_validators/tx_validator/data_validator.ts +50 -3
  421. package/src/msg_validators/tx_validator/double_spend_validator.ts +15 -9
  422. package/src/msg_validators/tx_validator/factory.ts +430 -56
  423. package/src/msg_validators/tx_validator/fee_payer_balance.ts +6 -2
  424. package/src/msg_validators/tx_validator/gas_validator.ts +198 -51
  425. package/src/msg_validators/tx_validator/index.ts +4 -0
  426. package/src/msg_validators/tx_validator/metadata_validator.ts +18 -7
  427. package/src/msg_validators/tx_validator/nullifier_cache.ts +30 -0
  428. package/src/msg_validators/tx_validator/phases_validator.ts +87 -30
  429. package/src/msg_validators/tx_validator/size_validator.ts +6 -2
  430. package/src/msg_validators/tx_validator/timestamp_validator.ts +29 -21
  431. package/src/msg_validators/tx_validator/tx_permitted_validator.ts +8 -3
  432. package/src/msg_validators/tx_validator/tx_proof_validator.ts +10 -3
  433. package/src/msg_validators/tx_validator/tx_validation_cache.ts +101 -0
  434. package/src/services/data_store.ts +14 -19
  435. package/src/services/discv5/discV5_service.ts +127 -15
  436. package/src/services/discv5/persisted_enr_store.ts +158 -0
  437. package/src/services/dummy_service.ts +77 -39
  438. package/src/services/encoding.ts +42 -26
  439. package/src/services/gossipsub/README.md +663 -0
  440. package/src/services/gossipsub/index.ts +2 -0
  441. package/src/services/gossipsub/scoring.ts +29 -5
  442. package/src/services/gossipsub/topic_score_params.ts +478 -0
  443. package/src/services/index.ts +1 -0
  444. package/src/services/libp2p/instrumentation.ts +29 -2
  445. package/src/services/libp2p/libp2p_service.ts +895 -660
  446. package/src/services/peer-manager/metrics.ts +28 -4
  447. package/src/services/peer-manager/peer_manager.ts +91 -25
  448. package/src/services/peer-manager/peer_scoring.ts +131 -9
  449. package/src/services/reqresp/README.md +194 -0
  450. package/src/services/reqresp/batch-tx-requester/README.md +344 -0
  451. package/src/services/reqresp/batch-tx-requester/batch_tx_requester.ts +660 -0
  452. package/src/services/reqresp/batch-tx-requester/config.ts +40 -0
  453. package/src/services/reqresp/batch-tx-requester/interface.ts +61 -0
  454. package/src/services/reqresp/batch-tx-requester/missing_txs.ts +168 -0
  455. package/src/services/reqresp/batch-tx-requester/peer_collection.ts +249 -0
  456. package/src/services/reqresp/batch-tx-requester/tx_validator.ts +24 -0
  457. package/src/services/reqresp/config.ts +19 -2
  458. package/src/services/reqresp/connection-sampler/connection_sampler.ts +16 -0
  459. package/src/services/reqresp/interface.ts +48 -46
  460. package/src/services/reqresp/metrics.ts +33 -9
  461. package/src/services/reqresp/protocols/block_txs/bitvector.ts +10 -2
  462. package/src/services/reqresp/protocols/block_txs/block_txs_handler.ts +44 -17
  463. package/src/services/reqresp/protocols/block_txs/block_txs_reqresp.ts +108 -16
  464. package/src/services/reqresp/protocols/index.ts +0 -1
  465. package/src/services/reqresp/protocols/tx.ts +23 -3
  466. package/src/services/reqresp/rate-limiter/rate_limiter.ts +13 -9
  467. package/src/services/reqresp/rate-limiter/rate_limits.ts +3 -13
  468. package/src/services/reqresp/reqresp.ts +107 -223
  469. package/src/services/service.ts +85 -29
  470. package/src/services/tx_collection/config.ts +41 -36
  471. package/src/services/tx_collection/file_store_tx_collection.ts +153 -0
  472. package/src/services/tx_collection/file_store_tx_source.ts +129 -0
  473. package/src/services/tx_collection/index.ts +2 -1
  474. package/src/services/tx_collection/instrumentation.ts +11 -2
  475. package/src/services/tx_collection/request_tracker.ts +127 -0
  476. package/src/services/tx_collection/tx_collection.ts +364 -112
  477. package/src/services/tx_collection/tx_collection_sink.ts +32 -36
  478. package/src/services/tx_collection/tx_source.ts +29 -8
  479. package/src/services/tx_file_store/config.ts +37 -0
  480. package/src/services/tx_file_store/index.ts +3 -0
  481. package/src/services/tx_file_store/instrumentation.ts +36 -0
  482. package/src/services/tx_file_store/tx_file_store.ts +163 -0
  483. package/src/services/tx_provider.ts +15 -9
  484. package/src/services/tx_provider_instrumentation.ts +11 -5
  485. package/src/test-helpers/index.ts +2 -0
  486. package/src/test-helpers/make-test-p2p-clients.ts +7 -6
  487. package/src/test-helpers/mock-pubsub.ts +137 -14
  488. package/src/test-helpers/reqresp-nodes.ts +17 -29
  489. package/src/test-helpers/test_tx_provider.ts +69 -0
  490. package/src/test-helpers/testbench-utils.ts +465 -0
  491. package/src/testbench/p2p_client_testbench_worker.ts +389 -133
  492. package/src/testbench/worker_client_manager.ts +355 -51
  493. package/src/util.ts +40 -19
  494. package/src/versioning.ts +3 -33
  495. package/dest/mem_pools/attestation_pool/kv_attestation_pool.d.ts +0 -40
  496. package/dest/mem_pools/attestation_pool/kv_attestation_pool.d.ts.map +0 -1
  497. package/dest/mem_pools/attestation_pool/kv_attestation_pool.js +0 -218
  498. package/dest/mem_pools/attestation_pool/memory_attestation_pool.d.ts +0 -31
  499. package/dest/mem_pools/attestation_pool/memory_attestation_pool.d.ts.map +0 -1
  500. package/dest/mem_pools/attestation_pool/memory_attestation_pool.js +0 -180
  501. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.d.ts +0 -125
  502. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.d.ts.map +0 -1
  503. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.js +0 -596
  504. package/dest/mem_pools/tx_pool/eviction/eviction_manager.d.ts +0 -32
  505. package/dest/mem_pools/tx_pool/eviction/eviction_manager.d.ts.map +0 -1
  506. package/dest/mem_pools/tx_pool/eviction/eviction_manager.js +0 -112
  507. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.d.ts +0 -157
  508. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.d.ts.map +0 -1
  509. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.js +0 -52
  510. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.d.ts +0 -16
  511. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.d.ts.map +0 -1
  512. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.js +0 -122
  513. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.d.ts +0 -17
  514. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.d.ts.map +0 -1
  515. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.d.ts +0 -19
  516. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.d.ts.map +0 -1
  517. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.js +0 -78
  518. package/dest/mem_pools/tx_pool/eviction/low_priority_eviction_rule.d.ts +0 -26
  519. package/dest/mem_pools/tx_pool/eviction/low_priority_eviction_rule.d.ts.map +0 -1
  520. package/dest/mem_pools/tx_pool/eviction/low_priority_eviction_rule.js +0 -84
  521. package/dest/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.d.ts +0 -25
  522. package/dest/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.d.ts.map +0 -1
  523. package/dest/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.js +0 -57
  524. package/dest/mem_pools/tx_pool/index.d.ts +0 -3
  525. package/dest/mem_pools/tx_pool/index.d.ts.map +0 -1
  526. package/dest/mem_pools/tx_pool/index.js +0 -2
  527. package/dest/mem_pools/tx_pool/priority.d.ts +0 -12
  528. package/dest/mem_pools/tx_pool/priority.d.ts.map +0 -1
  529. package/dest/mem_pools/tx_pool/priority.js +0 -15
  530. package/dest/mem_pools/tx_pool/tx_pool.d.ts +0 -127
  531. package/dest/mem_pools/tx_pool/tx_pool.d.ts.map +0 -1
  532. package/dest/mem_pools/tx_pool/tx_pool.js +0 -3
  533. package/dest/mem_pools/tx_pool/tx_pool_test_suite.d.ts +0 -7
  534. package/dest/mem_pools/tx_pool/tx_pool_test_suite.d.ts.map +0 -1
  535. package/dest/mem_pools/tx_pool/tx_pool_test_suite.js +0 -400
  536. package/dest/msg_validators/clock_tolerance.d.ts +0 -21
  537. package/dest/msg_validators/clock_tolerance.d.ts.map +0 -1
  538. package/dest/msg_validators/clock_tolerance.js +0 -37
  539. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.d.ts +0 -23
  540. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.d.ts.map +0 -1
  541. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.js +0 -212
  542. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.d.ts +0 -45
  543. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.d.ts.map +0 -1
  544. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.js +0 -92
  545. package/dest/services/reqresp/protocols/block.d.ts +0 -9
  546. package/dest/services/reqresp/protocols/block.d.ts.map +0 -1
  547. package/dest/services/reqresp/protocols/block.js +0 -32
  548. package/dest/services/tx_collection/fast_tx_collection.d.ts +0 -51
  549. package/dest/services/tx_collection/fast_tx_collection.d.ts.map +0 -1
  550. package/dest/services/tx_collection/fast_tx_collection.js +0 -300
  551. package/dest/services/tx_collection/slow_tx_collection.d.ts +0 -53
  552. package/dest/services/tx_collection/slow_tx_collection.d.ts.map +0 -1
  553. package/dest/services/tx_collection/slow_tx_collection.js +0 -177
  554. package/src/mem_pools/attestation_pool/kv_attestation_pool.ts +0 -320
  555. package/src/mem_pools/attestation_pool/memory_attestation_pool.ts +0 -264
  556. package/src/mem_pools/tx_pool/README.md +0 -270
  557. package/src/mem_pools/tx_pool/aztec_kv_tx_pool.ts +0 -746
  558. package/src/mem_pools/tx_pool/eviction/eviction_manager.ts +0 -132
  559. package/src/mem_pools/tx_pool/eviction/eviction_strategy.ts +0 -208
  560. package/src/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.ts +0 -162
  561. package/src/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.ts +0 -104
  562. package/src/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.ts +0 -93
  563. package/src/mem_pools/tx_pool/eviction/low_priority_eviction_rule.ts +0 -106
  564. package/src/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.ts +0 -75
  565. package/src/mem_pools/tx_pool/index.ts +0 -2
  566. package/src/mem_pools/tx_pool/priority.ts +0 -20
  567. package/src/mem_pools/tx_pool/tx_pool.ts +0 -141
  568. package/src/mem_pools/tx_pool/tx_pool_test_suite.ts +0 -319
  569. package/src/msg_validators/clock_tolerance.ts +0 -51
  570. package/src/msg_validators/proposal_validator/proposal_validator_test_suite.ts +0 -230
  571. package/src/services/reqresp/connection-sampler/batch_connection_sampler.ts +0 -100
  572. package/src/services/reqresp/protocols/block.ts +0 -37
  573. package/src/services/tx_collection/fast_tx_collection.ts +0 -341
  574. package/src/services/tx_collection/slow_tx_collection.ts +0 -233
@@ -1,16 +1,15 @@
1
1
  import type { EpochCacheInterface } from '@aztec/epoch-cache';
2
- import { BlockNumber } from '@aztec/foundation/branded-types';
3
- import { randomInt } from '@aztec/foundation/crypto/random';
4
- import { Fr } from '@aztec/foundation/curves/bn254';
2
+ import { BlockNumber, type SlotNumber } from '@aztec/foundation/branded-types';
3
+ import { 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
15
  BlockProposal,
@@ -18,17 +17,17 @@ import {
18
17
  CheckpointProposal,
19
18
  type CheckpointProposalCore,
20
19
  type Gossipable,
21
- P2PClientType,
22
20
  P2PMessage,
23
- type ValidationResult as P2PValidationResult,
24
21
  PeerErrorSeverity,
22
+ PeerErrorSeverityByHarshness,
25
23
  TopicType,
26
24
  createTopicString,
27
- getTopicsForClientAndConfig,
25
+ getTopicsForConfig,
28
26
  metricsTopicStrToLabels,
29
27
  } from '@aztec/stdlib/p2p';
28
+ import { ConsensusTimetable, getDefaultCheckpointProposalSyncGrace } from '@aztec/stdlib/timetable';
30
29
  import { MerkleTreeId } from '@aztec/stdlib/trees';
31
- import { Tx, type TxHash, type TxValidationResult, type TxValidator } from '@aztec/stdlib/tx';
30
+ import { Tx, type TxValidationResult } from '@aztec/stdlib/tx';
32
31
  import type { UInt64 } from '@aztec/stdlib/types';
33
32
  import { compressComponentVersions } from '@aztec/stdlib/versioning';
34
33
  import {
@@ -46,81 +45,99 @@ import {
46
45
  type GossipsubMessage,
47
46
  gossipsub,
48
47
  } from '@chainsafe/libp2p-gossipsub';
49
- import { createPeerScoreParams, createTopicScoreParams } from '@chainsafe/libp2p-gossipsub/score';
48
+ import { createPeerScoreParams } from '@chainsafe/libp2p-gossipsub/score';
50
49
  import { SignaturePolicy } from '@chainsafe/libp2p-gossipsub/types';
51
50
  import { noise } from '@chainsafe/libp2p-noise';
52
51
  import { yamux } from '@chainsafe/libp2p-yamux';
53
52
  import { bootstrap } from '@libp2p/bootstrap';
54
53
  import { identify } from '@libp2p/identify';
55
54
  import { type Message, type MultiaddrConnection, type PeerId, TopicValidatorResult } from '@libp2p/interface';
56
- import type { ConnectionManager } from '@libp2p/interface-internal';
55
+ import type { AddressManager, ConnectionManager } from '@libp2p/interface-internal';
57
56
  import { mplex } from '@libp2p/mplex';
58
57
  import { tcp } from '@libp2p/tcp';
58
+ import { multiaddr } from '@multiformats/multiaddr';
59
59
  import { ENR } from '@nethermindeth/enr';
60
60
  import { createLibp2p } from 'libp2p';
61
61
 
62
62
  import type { P2PConfig } from '../../config.js';
63
- import { ProposalSlotCapExceededError } from '../../errors/attestation-pool.error.js';
63
+ import { CheckpointProposalReceivedCallbackNotRegisteredError } from '../../errors/p2p-service.error.js';
64
64
  import type { MemPools } from '../../mem_pools/interface.js';
65
65
  import {
66
66
  BlockProposalValidator,
67
67
  CheckpointAttestationValidator,
68
68
  CheckpointProposalValidator,
69
+ DoubleSpendTxValidator,
69
70
  FishermanAttestationValidator,
70
- SizeTxValidator,
71
+ getDefaultAllowedSetupFunctions,
71
72
  } from '../../msg_validators/index.js';
72
73
  import { MessageSeenValidator } from '../../msg_validators/msg_seen_validator/msg_seen_validator.js';
73
- import { getDefaultAllowedSetupFunctions } from '../../msg_validators/tx_validator/allowed_public_setup.js';
74
- import { type MessageValidator, createTxMessageValidators } from '../../msg_validators/tx_validator/factory.js';
75
74
  import {
76
- AggregateTxValidator,
77
- DataTxValidator,
78
- DoubleSpendTxValidator,
79
- MetadataTxValidator,
80
- TxProofValidator,
81
- } 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';
82
81
  import { GossipSubEvent } from '../../types/index.js';
83
82
  import { type PubSubLibp2p, convertToMultiaddr } from '../../util.js';
84
83
  import { getVersions } from '../../versioning.js';
85
84
  import { AztecDatastore } from '../data_store.js';
86
85
  import { DiscV5Service } from '../discv5/discV5_service.js';
87
- import { SnappyTransform, fastMsgIdFn, getMsgIdFn, msgIdToStrFn } from '../encoding.js';
88
- 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';
89
89
  import type { PeerManagerInterface } from '../peer-manager/interface.js';
90
90
  import { PeerManager } from '../peer-manager/peer_manager.js';
91
91
  import { PeerScoring } from '../peer-manager/peer_scoring.js';
92
- 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';
93
94
  import {
94
- DEFAULT_SUB_PROTOCOL_VALIDATORS,
95
+ AuthRequest,
96
+ BlockTxsRequest,
97
+ BlockTxsResponse,
95
98
  type ReqRespInterface,
99
+ type ReqRespResponse,
96
100
  ReqRespSubProtocol,
97
101
  type ReqRespSubProtocolHandler,
98
102
  type ReqRespSubProtocolHandlers,
99
- type ReqRespSubProtocolValidators,
100
- type SubProtocolMap,
101
- ValidationError,
102
- } from '../reqresp/interface.js';
103
- import { reqRespBlockTxsHandler } from '../reqresp/protocols/block_txs/block_txs_handler.js';
104
- import { reqGoodbyeHandler } from '../reqresp/protocols/goodbye.js';
105
- import {
106
- AuthRequest,
107
- BlockTxsRequest,
108
- BlockTxsResponse,
109
103
  StatusMessage,
104
+ ValidationError,
110
105
  pingHandler,
111
- reqRespBlockHandler,
106
+ reqGoodbyeHandler,
107
+ reqRespBlockTxsHandler,
112
108
  reqRespStatusHandler,
113
109
  reqRespTxHandler,
114
- } from '../reqresp/protocols/index.js';
110
+ } from '../reqresp/index.js';
115
111
  import { ReqResp } from '../reqresp/reqresp.js';
116
112
  import type {
117
113
  P2PBlockReceivedCallback,
114
+ P2PCheckpointAttestationCallback,
118
115
  P2PCheckpointReceivedCallback,
116
+ P2PDuplicateAttestationCallback,
117
+ P2POversizedProposalCallback,
119
118
  P2PService,
120
119
  PeerDiscoveryService,
121
120
  } from '../service.js';
122
121
  import { P2PInstrumentation } from './instrumentation.js';
123
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
+
124
141
  interface ValidationResult {
125
142
  name: string;
126
143
  isValid: TxValidationResult;
@@ -130,14 +147,14 @@ interface ValidationResult {
130
147
  type ValidationOutcome = { allPassed: true } | { allPassed: false; failure: ValidationResult };
131
148
 
132
149
  // REFACTOR: Unify with the type above
133
- type ReceivedMessageValidationResult<T> =
134
- | { obj: T; result: Exclude<TopicValidatorResult, TopicValidatorResult.Reject> }
135
- | { 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 };
136
153
 
137
154
  /**
138
155
  * Lib P2P implementation of the P2PService interface.
139
156
  */
140
- export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends WithTracer implements P2PService {
157
+ export class LibP2PService extends WithTracer implements P2PService {
141
158
  private discoveryRunningPromise?: RunningPromise;
142
159
  private msgIdSeenValidators: Record<TopicType, MessageSeenValidator> = {} as Record<TopicType, MessageSeenValidator>;
143
160
 
@@ -149,7 +166,21 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
149
166
  private protocolVersion = '';
150
167
  private topicStrings: Record<TopicType, string> = {} as Record<TopicType, string>;
151
168
 
152
- 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;
153
184
 
154
185
  /**
155
186
  * Callback for when a block is received from a peer.
@@ -163,10 +194,19 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
163
194
  * @param checkpoint - The checkpoint proposal received from the peer.
164
195
  * @returns The attestations for the checkpoint, if any.
165
196
  */
166
- private checkpointReceivedCallback: P2PCheckpointReceivedCallback;
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;
167
204
 
168
205
  private gossipSubEventHandler: (e: CustomEvent<GossipsubMessage>) => void;
169
206
 
207
+ private ipChangedHandler?: (ip: string) => void;
208
+ private discoveredP2pIp?: string;
209
+
170
210
  private instrumentation: P2PInstrumentation;
171
211
 
172
212
  private telemetry: TelemetryClient;
@@ -174,19 +214,20 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
174
214
  protected logger: Logger;
175
215
 
176
216
  constructor(
177
- private clientType: T,
178
217
  private config: P2PConfig,
179
218
  protected node: PubSubLibp2p,
180
219
  private peerDiscoveryService: PeerDiscoveryService,
181
220
  private reqresp: ReqRespInterface,
182
- private peerManager: PeerManagerInterface,
221
+ protected peerManager: PeerManagerInterface,
183
222
  protected mempools: MemPools,
184
- private archiver: L2BlockSource & ContractDataSource,
223
+ protected archiver: L2BlockSource & ContractDataSource,
185
224
  private epochCache: EpochCacheInterface,
186
225
  private proofVerifier: ClientProtocolCircuitVerifier,
187
226
  private worldStateSynchronizer: WorldStateSynchronizer,
227
+ private blockMinFeesProvider: BlockMinFeesProvider,
188
228
  telemetry: TelemetryClient,
189
229
  logger: Logger = createLogger('p2p:libp2p_service'),
230
+ private txValidationCache?: TxValidationCache,
190
231
  ) {
191
232
  super(telemetry, 'LibP2PService');
192
233
  this.telemetry = telemetry;
@@ -216,36 +257,66 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
216
257
  this.protocolVersion,
217
258
  );
218
259
 
219
- this.blockProposalValidator = new BlockProposalValidator(epochCache, { txsPermitted: !config.disableTransactions });
220
- this.checkpointProposalValidator = new CheckpointProposalValidator(epochCache, {
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 = {
221
264
  txsPermitted: !config.disableTransactions,
222
- });
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
+ };
223
284
  this.checkpointAttestationValidator = config.fishermanMode
224
- ? new FishermanAttestationValidator(epochCache, mempools.attestationPool, telemetry)
225
- : new CheckpointAttestationValidator(epochCache);
285
+ ? new FishermanAttestationValidator(
286
+ epochCache,
287
+ consensusTimetable,
288
+ mempools.attestationPool,
289
+ telemetry,
290
+ attestationValidatorOpts,
291
+ )
292
+ : new CheckpointAttestationValidator(epochCache, consensusTimetable, attestationValidatorOpts);
226
293
 
227
294
  this.gossipSubEventHandler = this.handleGossipSubEvent.bind(this);
228
295
 
229
296
  this.blockReceivedCallback = async (block: BlockProposal): Promise<boolean> => {
230
- this.logger.debug(
231
- `Handler not yet registered: Block received callback not set. Received block for slot ${block.slotNumber} from peer.`,
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.`,
232
299
  { p2pMessageIdentifier: await block.p2pMessageLoggingIdentifier() },
233
300
  );
234
- return false;
301
+ return true;
235
302
  };
236
303
 
237
- this.checkpointReceivedCallback = (
238
- checkpoint: CheckpointProposalCore,
304
+ this.allNodesCheckpointReceivedCallback = (
305
+ _checkpoint: CheckpointProposalCore,
306
+ ): Promise<CheckpointAttestation[] | undefined> => {
307
+ throw new CheckpointProposalReceivedCallbackNotRegisteredError();
308
+ };
309
+
310
+ this.validatorCheckpointReceivedCallback = (
311
+ _checkpoint: CheckpointProposalCore,
239
312
  ): Promise<CheckpointAttestation[] | undefined> => {
240
- this.logger.debug(
241
- `Handler not yet registered: Checkpoint received callback not set. Received checkpoint for slot ${checkpoint.slotNumber} from peer.`,
242
- );
243
313
  return Promise.resolve(undefined);
244
314
  };
245
315
  }
246
316
 
247
- public updateConfig(config: Partial<P2PReqRespConfig>) {
317
+ public updateConfig(config: Partial<P2PReqRespConfig & Pick<P2PConfig, 'skipIncomingProposals'>>) {
248
318
  this.reqresp.updateConfig(config);
319
+ this.config = merge(this.config, config);
249
320
  }
250
321
 
251
322
  /**
@@ -254,8 +325,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
254
325
  * @param txPool - The transaction pool to be accessed by the service.
255
326
  * @returns The new service.
256
327
  */
257
- public static async new<T extends P2PClientType>(
258
- clientType: T,
328
+ public static async new(
259
329
  config: P2PConfig,
260
330
  peerId: PeerId,
261
331
  deps: {
@@ -265,9 +335,11 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
265
335
  proofVerifier: ClientProtocolCircuitVerifier;
266
336
  worldStateSynchronizer: WorldStateSynchronizer;
267
337
  peerStore: AztecAsyncKVStore;
338
+ blockMinFeesProvider: BlockMinFeesProvider;
268
339
  telemetry: TelemetryClient;
269
340
  logger: Logger;
270
341
  packageVersion: string;
342
+ txValidationCache?: TxValidationCache;
271
343
  },
272
344
  ) {
273
345
  const {
@@ -277,23 +349,26 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
277
349
  mempools,
278
350
  proofVerifier,
279
351
  peerStore,
352
+ blockMinFeesProvider,
280
353
  telemetry,
281
354
  logger,
282
355
  packageVersion,
356
+ txValidationCache,
283
357
  } = deps;
284
358
  const { p2pPort, maxPeerCount, listenAddress } = config;
285
359
  const bindAddrTcp = convertToMultiaddr(listenAddress, p2pPort, 'tcp');
286
360
 
287
361
  const datastore = new AztecDatastore(peerStore);
288
362
 
289
- const otelMetricsAdapter = new OtelMetricsAdapter(telemetry);
363
+ const otelMetricsAdapter = new OtelMetricsAdapter(telemetry, logger.getBindings());
290
364
 
291
365
  const peerDiscoveryService = new DiscV5Service(
292
366
  peerId,
293
367
  config,
294
368
  packageVersion,
295
369
  telemetry,
296
- createLogger(`${logger.module}:discv5_service`),
370
+ createLogger(`${logger.module}:discv5_service`, logger.getBindings()),
371
+ peerStore,
297
372
  );
298
373
 
299
374
  // Seed libp2p's bootstrap discovery with private and trusted peers
@@ -307,30 +382,50 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
307
382
  const versions = getVersions(config);
308
383
  const protocolVersion = compressComponentVersions(versions);
309
384
 
310
- const txTopic = createTopicString(TopicType.tx, protocolVersion);
311
- const blockProposalTopic = createTopicString(TopicType.block_proposal, protocolVersion);
312
- const checkpointProposalTopic = createTopicString(TopicType.checkpoint_proposal, protocolVersion);
313
- const checkpointAttestationTopic = createTopicString(TopicType.checkpoint_attestation, protocolVersion);
314
-
315
385
  const preferredPeersEnrs: ENR[] = config.preferredPeers.map(enr => ENR.decodeTxt(enr));
316
- const directPeers = (
386
+ const directPeers = compactArray(
317
387
  await Promise.all(
318
388
  preferredPeersEnrs.map(async enr => {
319
- const peerId = await enr.peerId();
320
- const address = enr.getLocationMultiaddr('tcp');
321
- if (address === undefined) {
322
- 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;
323
403
  }
324
- return {
325
- id: peerId,
326
- addrs: [address],
327
- };
328
404
  }),
329
- )
330
- ).filter(peer => peer !== undefined);
405
+ ),
406
+ );
331
407
 
332
408
  const announceTcpMultiaddr = config.p2pIp ? [convertToMultiaddr(config.p2pIp, p2pPort, 'tcp')] : [];
333
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
+
334
429
  const node = await createLibp2p({
335
430
  start: false,
336
431
  peerId,
@@ -362,7 +457,8 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
362
457
  ],
363
458
  datastore,
364
459
  peerDiscovery,
365
- 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()],
366
462
  connectionEncryption: [noise()],
367
463
  connectionManager: {
368
464
  minConnections: 0, // Disable libp2p peer dialing, we do it manually
@@ -376,7 +472,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
376
472
  },
377
473
  connectionGater: {
378
474
  denyInboundConnection: (maConn: MultiaddrConnection) => {
379
- const allowed = peerManager.isNodeAllowedToConnect(maConn.remoteAddr.nodeAddress().address);
475
+ const allowed = peerManager.isAddressAllowedToConnect(maConn.remoteAddr.nodeAddress().address);
380
476
  if (allowed) {
381
477
  return false;
382
478
  }
@@ -387,7 +483,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
387
483
  denyInboundEncryptedConnection: (peerId: PeerId, _maConn: MultiaddrConnection) => {
388
484
  //NOTE: it is not necessary to check address here because this was already done by
389
485
  // denyInboundConnection
390
- const allowed = peerManager.isNodeAllowedToConnect(peerId);
486
+ const allowed = peerManager.isPeerAllowedToConnect(peerId);
391
487
  if (allowed) {
392
488
  return false;
393
489
  }
@@ -415,9 +511,13 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
415
511
  mcacheLength: config.gossipsubMcacheLength,
416
512
  mcacheGossip: config.gossipsubMcacheGossip,
417
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.
418
519
  msgIdFn: getMsgIdFn,
419
520
  msgIdToStrFn: msgIdToStrFn,
420
- fastMsgIdFn: fastMsgIdFn,
421
521
  dataTransform: new SnappyTransform(),
422
522
  metricsRegister: otelMetricsAdapter,
423
523
  metricsTopicStrToLabel: metricsTopicStrToLabels(protocolVersion),
@@ -426,35 +526,15 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
426
526
  scoreParams: createPeerScoreParams({
427
527
  // IPColocation factor can be disabled for local testing - default to -5
428
528
  IPColocationFactorWeight: config.debugDisableColocationPenalty ? 0 : -5.0,
429
- topics: {
430
- [txTopic]: createTopicScoreParams({
431
- topicWeight: 1,
432
- invalidMessageDeliveriesWeight: -20,
433
- invalidMessageDeliveriesDecay: 0.5,
434
- }),
435
- [blockProposalTopic]: createTopicScoreParams({
436
- topicWeight: 1,
437
- invalidMessageDeliveriesWeight: -20,
438
- invalidMessageDeliveriesDecay: 0.5,
439
- }),
440
- [checkpointProposalTopic]: createTopicScoreParams({
441
- topicWeight: 1,
442
- invalidMessageDeliveriesWeight: -20,
443
- invalidMessageDeliveriesDecay: 0.5,
444
- }),
445
- [checkpointAttestationTopic]: createTopicScoreParams({
446
- topicWeight: 1,
447
- invalidMessageDeliveriesWeight: -20,
448
- invalidMessageDeliveriesDecay: 0.5,
449
- }),
450
- },
529
+ topics: topicScoreParams,
451
530
  }),
452
531
  }) as (components: GossipSubComponents) => GossipSub,
453
- components: (components: { connectionManager: ConnectionManager }) => ({
532
+ components: (components: { connectionManager: ConnectionManager; addressManager: AddressManager }) => ({
454
533
  connectionManager: components.connectionManager,
534
+ addressManager: components.addressManager,
455
535
  }),
456
536
  },
457
- logger: createLibp2pComponentLogger(logger.module),
537
+ logger: createLibp2pComponentLogger(logger.module, logger.getBindings()),
458
538
  });
459
539
 
460
540
  const peerScoring = new PeerScoring(config, telemetry);
@@ -473,13 +553,19 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
473
553
  epochCache,
474
554
  );
475
555
 
476
- // Update gossipsub score params
477
- 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;
478
565
  node.services.pubsub.score.params.appSpecificScore = (peerId: string) =>
479
566
  peerManager.shouldDisableP2PGossip(peerId) ? -Infinity : peerManager.getPeerScore(peerId);
480
567
 
481
568
  return new LibP2PService(
482
- clientType,
483
569
  config,
484
570
  node,
485
571
  peerDiscoveryService,
@@ -490,8 +576,10 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
490
576
  epochCache,
491
577
  proofVerifier,
492
578
  worldStateSynchronizer,
579
+ blockMinFeesProvider,
493
580
  telemetry,
494
581
  logger,
582
+ txValidationCache,
495
583
  );
496
584
  }
497
585
 
@@ -505,28 +593,29 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
505
593
  throw new Error('P2P service already started');
506
594
  }
507
595
 
508
- // Get listen & announce addresses for logging
509
596
  const { p2pIp, p2pPort } = this.config;
510
- if (!p2pIp) {
511
- throw new Error('Announce address not provided.');
597
+ if (!p2pIp && !this.config.queryForIp) {
598
+ throw new Error('Announce address not provided and queryForIp is not enabled.');
512
599
  }
513
- const announceTcpMultiaddr = convertToMultiaddr(p2pIp, p2pPort, 'tcp');
600
+ const announceTcpMultiaddr = p2pIp ? convertToMultiaddr(p2pIp, p2pPort, 'tcp') : undefined;
514
601
 
515
602
  // Create request response protocol handlers
516
603
  const txHandler = reqRespTxHandler(this.mempools);
517
604
  const goodbyeHandler = reqGoodbyeHandler(this.peerManager);
518
- const blockHandler = reqRespBlockHandler(this.archiver);
519
605
  const statusHandler = reqRespStatusHandler(this.protocolVersion, this.worldStateSynchronizer, this.logger);
520
606
 
521
607
  const requestResponseHandlers: Partial<ReqRespSubProtocolHandlers> = {
522
608
  [ReqRespSubProtocol.PING]: pingHandler,
523
609
  [ReqRespSubProtocol.STATUS]: statusHandler.bind(this),
524
610
  [ReqRespSubProtocol.GOODBYE]: goodbyeHandler.bind(this),
525
- [ReqRespSubProtocol.BLOCK]: blockHandler.bind(this),
526
611
  };
527
612
 
528
613
  if (!this.config.disableTransactions) {
529
- const blockTxsHandler = reqRespBlockTxsHandler(this.mempools.attestationPool, this.mempools.txPool);
614
+ const blockTxsHandler = reqRespBlockTxsHandler(
615
+ this.mempools.attestationPool,
616
+ this.archiver,
617
+ this.mempools.txPool,
618
+ );
530
619
  requestResponseHandlers[ReqRespSubProtocol.BLOCK_TXS] = blockTxsHandler.bind(this);
531
620
  }
532
621
 
@@ -534,22 +623,14 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
534
623
  requestResponseHandlers[ReqRespSubProtocol.TX] = txHandler.bind(this);
535
624
  }
536
625
 
537
- // Define the sub protocol validators - This is done within this start() method to gain a callback to the existing validateTx function
538
- const reqrespSubProtocolValidators = {
539
- ...DEFAULT_SUB_PROTOCOL_VALIDATORS,
540
- [ReqRespSubProtocol.TX]: this.validateRequestedTxs.bind(this),
541
- [ReqRespSubProtocol.BLOCK_TXS]: this.validateRequestedBlockTxs.bind(this),
542
- [ReqRespSubProtocol.BLOCK]: this.validateRequestedBlock.bind(this),
543
- };
544
-
545
626
  await this.peerManager.initializePeers();
546
627
 
547
- await this.reqresp.start(requestResponseHandlers, reqrespSubProtocolValidators);
628
+ await this.reqresp.start(requestResponseHandlers);
548
629
 
549
630
  await this.node.start();
550
631
 
551
632
  // Subscribe to standard GossipSub topics by default
552
- for (const topic of getTopicsForClientAndConfig(this.clientType, this.config.disableTransactions)) {
633
+ for (const topic of getTopicsForConfig(this.config.disableTransactions)) {
553
634
  this.subscribeToTopic(this.topicStrings[topic]);
554
635
  }
555
636
 
@@ -560,6 +641,38 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
560
641
  if (!this.config.p2pDiscoveryDisabled) {
561
642
  await this.peerDiscoveryService.start();
562
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
+
563
676
  this.discoveryRunningPromise = new RunningPromise(
564
677
  async () => {
565
678
  await this.peerManager.heartbeat();
@@ -585,6 +698,11 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
585
698
  // Remove gossip sub listener
586
699
  this.node.services.pubsub.removeEventListener(GossipSubEvent.MESSAGE, this.gossipSubEventHandler);
587
700
 
701
+ if (this.ipChangedHandler) {
702
+ this.peerDiscoveryService.removeListener('ip:changed', this.ipChangedHandler);
703
+ this.ipChangedHandler = undefined;
704
+ }
705
+
588
706
  // Stop peer manager
589
707
  this.logger.debug('Stopping peer manager...');
590
708
  await this.peerManager.stop();
@@ -599,12 +717,8 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
599
717
  this.logger.info('LibP2P service stopped');
600
718
  }
601
719
 
602
- addReqRespSubProtocol(
603
- subProtocol: ReqRespSubProtocol,
604
- handler: ReqRespSubProtocolHandler,
605
- validator?: ReqRespSubProtocolValidators[ReqRespSubProtocol],
606
- ): Promise<void> {
607
- return this.reqresp.addSubProtocol(subProtocol, handler, validator);
720
+ addReqRespSubProtocol(subProtocol: ReqRespSubProtocol, handler: ReqRespSubProtocolHandler): Promise<void> {
721
+ return this.reqresp.addSubProtocol(subProtocol, handler);
608
722
  }
609
723
 
610
724
  public registerThisValidatorAddresses(address: EthAddress[]): void {
@@ -615,6 +729,10 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
615
729
  return this.peerManager.getPeers(includePending);
616
730
  }
617
731
 
732
+ public getGossipMeshPeerCount(topicType: TopicType): number {
733
+ return this.node.services.pubsub.getMeshPeers(this.topicStrings[topicType]).length;
734
+ }
735
+
618
736
  private handleGossipSubEvent(e: CustomEvent<GossipsubMessage>) {
619
737
  this.logger.trace(`Received PUBSUB message.`);
620
738
 
@@ -628,18 +746,13 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
628
746
  setImmediate(() => void safeJob());
629
747
  }
630
748
 
631
- /**
632
- * Send a batch of requests to peers, and return the responses
633
- * @param protocol - The request response protocol to use
634
- * @param requests - The requests to send to the peers
635
- * @returns The responses to the requests
636
- */
637
- sendBatchRequest<SubProtocol extends ReqRespSubProtocol>(
638
- protocol: SubProtocol,
639
- requests: InstanceType<SubProtocolMap[SubProtocol]['request']>[],
640
- pinnedPeerId: PeerId | undefined,
641
- ): Promise<InstanceType<SubProtocolMap[SubProtocol]['response']>[]> {
642
- 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);
643
756
  }
644
757
 
645
758
  /**
@@ -654,8 +767,42 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
654
767
  this.blockReceivedCallback = callback;
655
768
  }
656
769
 
657
- public registerCheckpointReceivedCallback(callback: P2PCheckpointReceivedCallback) {
658
- this.checkpointReceivedCallback = callback;
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;
659
806
  }
660
807
 
661
808
  /**
@@ -722,6 +869,9 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
722
869
  if (!validator || !validator.addMessage(msgId)) {
723
870
  this.instrumentation.incMessagePrevalidationStatus(false, topicType);
724
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
+ }
725
875
  return { result: false, topicType };
726
876
  }
727
877
 
@@ -783,12 +933,19 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
783
933
 
784
934
  // Process the message, optionally within a linked span for trace propagation
785
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;
944
+ }
786
945
  if (msg.topic === this.topicStrings[TopicType.tx]) {
787
946
  await this.handleGossipedTx(p2pMessage.payload, msgId, source);
788
947
  } else if (msg.topic === this.topicStrings[TopicType.checkpoint_attestation]) {
789
- if (this.clientType === P2PClientType.Full) {
790
- await this.processCheckpointAttestationFromPeer(p2pMessage.payload, msgId, source);
791
- }
948
+ await this.processCheckpointAttestationFromPeer(p2pMessage.payload, msgId, source);
792
949
  } else if (msg.topic === this.topicStrings[TopicType.block_proposal]) {
793
950
  await this.processBlockFromPeer(p2pMessage.payload, msgId, source);
794
951
  } else if (msg.topic === this.topicStrings[TopicType.checkpoint_proposal]) {
@@ -844,51 +1001,145 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
844
1001
  return;
845
1002
  }
846
1003
 
847
- protected async validateReceivedMessage<T>(
848
- validationFunc: () => Promise<ReceivedMessageValidationResult<T>>,
1004
+ protected async validateReceivedMessage<T, M = undefined>(
1005
+ validationFunc: () => Promise<ReceivedMessageValidationResult<T, M>>,
849
1006
  msgId: string,
850
1007
  source: PeerId,
851
1008
  topicType: TopicType,
852
- ): Promise<ReceivedMessageValidationResult<T>> {
853
- 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
+ };
854
1015
  const timer = new Timer();
855
1016
  try {
856
1017
  resultAndObj = await validationFunc();
857
1018
  } catch (err) {
858
- this.peerManager.penalizePeer(source, PeerErrorSeverity.LowToleranceError);
859
- this.logger.error(`Error deserializing and validating gossipsub message`, err, {
860
- msgId,
861
- source: source.toString(),
862
- topicType,
863
- });
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
+ );
864
1031
  }
865
1032
 
866
1033
  if (resultAndObj.result === TopicValidatorResult.Accept) {
1034
+ this.logger.debug(`Message ${topicType} accepted by validator`, { msgId, source: source.toString(), topicType });
867
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 });
868
1046
  }
869
1047
 
870
1048
  this.node.services.pubsub.reportMessageValidationResult(msgId, source.toString(), resultAndObj.result);
871
1049
  return resultAndObj;
872
1050
  }
873
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
+
874
1065
  protected async handleGossipedTx(payloadData: Buffer, msgId: string, source: PeerId) {
875
1066
  const validationFunc: () => Promise<ReceivedMessageValidationResult<Tx>> = async () => {
876
- const tx = Tx.fromBuffer(payloadData);
877
- const isValid = await this.validatePropagatedTx(tx, source);
878
- 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
+ }
1089
+
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
+ }
879
1097
 
880
- this.logger.trace(`Validate propagated tx`, {
881
- isValid,
882
- exists,
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,
883
1130
  [Attributes.P2P_ID]: source.toString(),
884
1131
  });
885
1132
 
886
- if (!isValid) {
887
- return { result: TopicValidatorResult.Reject };
888
- } else if (exists) {
1133
+ if (wasAccepted) {
1134
+ return { result: TopicValidatorResult.Accept, obj: tx };
1135
+ } else if (wasIgnored) {
889
1136
  return { result: TopicValidatorResult.Ignore, obj: tx };
890
1137
  } else {
891
- 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 };
892
1143
  }
893
1144
  };
894
1145
 
@@ -897,6 +1148,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
897
1148
  return;
898
1149
  }
899
1150
 
1151
+ // Tx was accepted into pool and will be propagated - just log and record metrics
900
1152
  const txHash = tx.getTxHash();
901
1153
  const txHashString = txHash.toString();
902
1154
  this.logger.verbose(`Received tx ${txHashString} from external peer ${source.toString()} via gossip`, {
@@ -904,13 +1156,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
904
1156
  txHash: txHashString,
905
1157
  });
906
1158
 
907
- if (this.config.dropTransactions && randomInt(1000) < this.config.dropTransactionsProbability * 1000) {
908
- this.logger.warn(`Intentionally dropping tx ${txHashString} (probability rule)`);
909
- return;
910
- }
911
-
912
1159
  this.instrumentation.incrementTxReceived(1);
913
- await this.mempools.txPool.addTxs([tx]);
914
1160
  }
915
1161
 
916
1162
  /**
@@ -922,47 +1168,17 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
922
1168
  msgId: string,
923
1169
  source: PeerId,
924
1170
  ): Promise<void> {
925
- const validationFunc: () => Promise<ReceivedMessageValidationResult<CheckpointAttestation>> = async () => {
926
- const attestation = CheckpointAttestation.fromBuffer(payloadData);
927
- const pool = this.mempools.attestationPool;
928
- const validationResult = await this.validateCheckpointAttestation(source, attestation);
929
- const isValid = validationResult.result === 'accept';
930
- const exists = isValid && (await pool.hasCheckpointAttestation(attestation));
931
-
932
- let canAdd = true;
933
- if (isValid && !exists) {
934
- const slot = attestation.payload.header.slotNumber;
935
- const { committee } = await this.epochCache.getCommittee(slot);
936
- const committeeSize = committee?.length ?? 0;
937
- canAdd = await pool.canAddCheckpointAttestation(attestation, committeeSize);
938
- }
939
-
940
- this.logger.trace(`Validate propagated checkpoint attestation`, {
941
- isValid,
942
- exists,
943
- canAdd,
944
- [Attributes.SLOT_NUMBER]: attestation.payload.header.slotNumber.toString(),
945
- [Attributes.P2P_ID]: source.toString(),
946
- });
947
-
948
- if (validationResult.result === 'reject') {
949
- return { result: TopicValidatorResult.Reject };
950
- } else if (validationResult.result === 'ignore' || exists) {
951
- return { result: TopicValidatorResult.Ignore, obj: attestation };
952
- } else if (!canAdd) {
953
- this.logger.warn(`Dropping checkpoint attestation due to per-(slot, proposalId) attestation cap`, {
954
- slot: attestation.payload.header.slotNumber.toString(),
955
- archive: attestation.archive.toString(),
956
- source: source.toString(),
957
- });
958
- return { result: TopicValidatorResult.Ignore, obj: attestation };
959
- } else {
960
- return { result: TopicValidatorResult.Accept, obj: attestation };
961
- }
962
- };
963
-
964
1171
  const { result, obj: attestation } = await this.validateReceivedMessage<CheckpointAttestation>(
965
- validationFunc,
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
+ },
966
1182
  msgId,
967
1183
  source,
968
1184
  TopicType.checkpoint_attestation,
@@ -972,8 +1188,8 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
972
1188
  return;
973
1189
  }
974
1190
 
975
- this.logger.debug(
976
- `Received checkpoint 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()}`,
977
1193
  {
978
1194
  p2pMessageIdentifier: await attestation.p2pMessageLoggingIdentifier(),
979
1195
  slot: attestation.slotNumber,
@@ -981,60 +1197,192 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
981
1197
  source: source.toString(),
982
1198
  },
983
1199
  );
984
-
985
- await this.mempools.attestationPool.addCheckpointAttestations([attestation]);
986
1200
  }
987
1201
 
988
- private async processBlockFromPeer(payloadData: Buffer, msgId: string, source: PeerId): Promise<void> {
989
- const validationFunc: () => Promise<ReceivedMessageValidationResult<BlockProposal>> = async () => {
990
- const block = BlockProposal.fromBuffer(payloadData);
991
- const validationResult = await this.validateBlockProposal(source, block);
992
- const isValid = validationResult.result === 'accept';
993
- const pool = this.mempools.attestationPool;
994
-
995
- const exists = isValid && (await pool.hasBlockProposal(block));
996
- const canAdd = isValid && (await pool.canAddProposal(block));
997
-
998
- this.logger.trace(`Validate propagated block proposal`, {
999
- isValid,
1000
- exists,
1001
- canAdd,
1002
- [Attributes.SLOT_NUMBER]: block.slotNumber.toString(),
1003
- [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,
1004
1248
  });
1249
+ return { result: TopicValidatorResult.Reject, severity: PeerErrorSeverity.HighToleranceError };
1250
+ }
1005
1251
 
1006
- if (validationResult.result === 'reject') {
1007
- return { result: TopicValidatorResult.Reject };
1008
- } else if (validationResult.result === 'ignore' || exists) {
1009
- return { result: TopicValidatorResult.Ignore, obj: block };
1010
- } else if (!canAdd) {
1011
- this.peerManager.penalizePeer(source, PeerErrorSeverity.MidToleranceError);
1012
- this.logger.warn(`Penalizing peer for block proposal exceeding per-slot cap`, {
1013
- slot: block.slotNumber.toString(),
1014
- archive: block.archive.toString(),
1015
- 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(),
1016
1262
  });
1017
- return { result: TopicValidatorResult.Reject };
1018
- } else {
1019
- return { result: TopicValidatorResult.Accept, obj: block };
1263
+ this.duplicateAttestationCallback?.({ slot, attester });
1020
1264
  }
1021
- };
1265
+ }
1022
1266
 
1023
- const { result, obj: block } = await this.validateReceivedMessage<BlockProposal>(
1024
- validationFunc,
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
+ }
1271
+
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)),
1025
1279
  msgId,
1026
1280
  source,
1027
1281
  TopicType.block_proposal,
1028
1282
  );
1029
1283
 
1030
- 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) {
1031
1287
  return;
1032
1288
  }
1033
1289
 
1034
1290
  await this.processValidBlockProposal(block, source);
1035
1291
  }
1036
1292
 
1037
- // 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
+
1038
1386
  // REFACTOR(palla): This method should be moved to the p2p_client or to a separate component,
1039
1387
  // should not be here as it does not deal with p2p networking.
1040
1388
  @trackSpan('Libp2pService.processValidBlockProposal', async block => ({
@@ -1042,7 +1390,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1042
1390
  [Attributes.BLOCK_ARCHIVE]: block.archive.toString(),
1043
1391
  [Attributes.P2P_ID]: await block.p2pMessageLoggingIdentifier().then(i => i.toString()),
1044
1392
  }))
1045
- private async processValidBlockProposal(block: BlockProposal, sender: PeerId) {
1393
+ protected async processValidBlockProposal(block: BlockProposal, sender: PeerId) {
1046
1394
  const slot = block.slotNumber;
1047
1395
  this.logger.verbose(`Received block proposal for slot ${slot} from external peer ${sender.toString()}.`, {
1048
1396
  p2pMessageIdentifier: await block.p2pMessageLoggingIdentifier(),
@@ -1050,30 +1398,17 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1050
1398
  ...block.toBlockInfo(),
1051
1399
  });
1052
1400
 
1053
- // Attempt to add proposal
1054
- try {
1055
- await this.mempools.attestationPool.addBlockProposal(block);
1056
- } catch (err: unknown) {
1057
- // Drop proposals if we hit per-slot cap in the attestation pool; rethrow unknown errors
1058
- if (err instanceof ProposalSlotCapExceededError) {
1059
- this.logger.warn(`Dropping block proposal due to per-slot proposal cap`, {
1060
- slot: String(slot),
1061
- archive: block.archive.toString(),
1062
- error: (err as Error).message,
1063
- });
1064
- return;
1065
- }
1066
- throw err;
1067
- }
1068
-
1069
- // Mark the txs in this proposal as non-evictable
1070
- await this.mempools.txPool.markTxsAsNonEvictable(block.txHashes);
1401
+ // Mark the txs in this proposal as protected
1402
+ await this.mempools.txPool.protectTxs(block.txHashes, block.blockHeader);
1071
1403
 
1072
1404
  // Call the block received callback to validate the proposal.
1073
1405
  // Note: Validators do NOT attest to individual blocks, only to checkpoint proposals.
1074
1406
  const isValid = await this.blockReceivedCallback(block, sender);
1075
1407
  if (!isValid) {
1076
- this.logger.warn(`Block proposal validation failed for block ${block.blockNumber}`, block.toBlockInfo());
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);
1077
1412
  }
1078
1413
  }
1079
1414
 
@@ -1081,67 +1416,182 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1081
1416
  * Handle a gossiped checkpoint proposal.
1082
1417
  * Validates and processes the checkpoint proposal, then triggers the callback for attestation.
1083
1418
  */
1084
- private async handleGossipedCheckpointProposal(payloadData: Buffer, msgId: string, source: PeerId): Promise<void> {
1085
- // TODO(palla/mbps): This pattern is repeated across multiple message handlers, consider abstracting it.
1086
- const validationFunc: () => Promise<ReceivedMessageValidationResult<CheckpointProposal>> = async () => {
1087
- const checkpoint = CheckpointProposal.fromBuffer(payloadData);
1088
- const validationResult = await this.validateCheckpointProposal(source, checkpoint);
1089
- const isValid = validationResult.result === 'accept';
1090
- const pool = this.mempools.attestationPool;
1091
-
1092
- const exists = isValid && (await pool.hasCheckpointProposal(checkpoint));
1093
- const canAdd = isValid && (await pool.canAddCheckpointProposal(checkpoint));
1094
-
1095
- this.logger.trace(`Validate propagated checkpoint proposal`, {
1096
- isValid,
1097
- exists,
1098
- canAdd,
1099
- [Attributes.SLOT_NUMBER]: checkpoint.slotNumber.toString(),
1100
- [Attributes.P2P_ID]: source.toString(),
1101
- });
1102
-
1103
- if (validationResult.result === 'reject') {
1104
- return { result: TopicValidatorResult.Reject };
1105
- } else if (validationResult.result === 'ignore' || exists) {
1106
- return { result: TopicValidatorResult.Ignore, obj: checkpoint };
1107
- } else if (!canAdd) {
1108
- this.peerManager.penalizePeer(source, PeerErrorSeverity.MidToleranceError);
1109
- this.logger.warn(`Penalizing peer for checkpoint proposal exceeding per-slot cap`, {
1110
- slot: checkpoint.slotNumber.toString(),
1111
- archive: checkpoint.archive.toString(),
1112
- source: source.toString(),
1113
- });
1114
- return { result: TopicValidatorResult.Reject };
1115
- } else {
1116
- return { result: TopicValidatorResult.Accept, obj: checkpoint };
1117
- }
1118
- };
1119
-
1120
- const { result, obj: checkpoint } = await this.validateReceivedMessage<CheckpointProposal>(
1121
- validationFunc,
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)),
1122
1429
  msgId,
1123
1430
  source,
1124
1431
  TopicType.checkpoint_proposal,
1125
1432
  );
1126
1433
 
1127
- if (result !== TopicValidatorResult.Accept || !checkpoint) {
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();
1128
1456
  return;
1129
1457
  }
1130
1458
 
1131
- await this.processValidCheckpointProposal(checkpoint, source);
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,
1510
+ });
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;
1519
+ }
1520
+ }
1521
+
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' });
1569
+ }
1570
+ return {
1571
+ result: TopicValidatorResult.Accept,
1572
+ obj: checkpoint,
1573
+ metadata: { isEquivocated, processBlock, isOversized },
1574
+ };
1575
+ }
1576
+
1577
+ // Otherwise, we're good to go!
1578
+ return {
1579
+ result: TopicValidatorResult.Accept,
1580
+ obj: checkpoint,
1581
+ metadata: { processBlock, isEquivocated, isOversized },
1582
+ };
1132
1583
  }
1133
1584
 
1134
1585
  /**
1135
1586
  * Process a validated checkpoint proposal.
1136
- * Extracts and processes the last block proposal (if present) first, then processes the checkpoint.
1137
- * The block callback is invoked before the checkpoint callback.
1587
+ * Note: The proposal was already added to the pool by tryAddCheckpointProposal in handleGossipedCheckpointProposal.
1138
1588
  */
1139
1589
  @trackSpan('Libp2pService.processValidCheckpointProposal', async checkpoint => ({
1140
1590
  [Attributes.SLOT_NUMBER]: checkpoint.slotNumber,
1141
1591
  [Attributes.BLOCK_ARCHIVE]: checkpoint.archive.toString(),
1142
1592
  [Attributes.P2P_ID]: await checkpoint.p2pMessageLoggingIdentifier().then(i => i.toString()),
1143
1593
  }))
1144
- private async processValidCheckpointProposal(checkpoint: CheckpointProposal, sender: PeerId) {
1594
+ protected async processValidCheckpointProposal(checkpoint: CheckpointProposalCore, sender: PeerId) {
1145
1595
  const slot = checkpoint.slotNumber;
1146
1596
  this.logger.verbose(`Received checkpoint proposal for slot ${slot} from external peer ${sender.toString()}.`, {
1147
1597
  p2pMessageIdentifier: await checkpoint.p2pMessageLoggingIdentifier(),
@@ -1150,37 +1600,14 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1150
1600
  source: sender.toString(),
1151
1601
  });
1152
1602
 
1153
- // Extract block proposal before adding to pool (pool stores them separately)
1154
- const blockProposal = checkpoint.getBlockProposal();
1155
-
1156
- // Add proposal to the pool (this extracts and stores block proposal separately)
1157
- await this.mempools.attestationPool.addCheckpointProposal(checkpoint);
1158
-
1159
- // Mark txs as non-evictable if present (from the last block)
1160
- if (checkpoint.txHashes.length > 0) {
1161
- await this.mempools.txPool.markTxsAsNonEvictable(checkpoint.txHashes);
1162
- }
1163
-
1164
- // If there was a last block proposal, invoke the block callback first for validation.
1165
- // Note: The block proposal is already stored in the pool by addCheckpointProposal.
1166
- if (blockProposal) {
1167
- const isValid = await this.blockReceivedCallback(blockProposal, sender);
1168
- if (!isValid) {
1169
- this.logger.warn(`Block proposal from checkpoint failed validation`, {
1170
- slot: slot.toString(),
1171
- archive: checkpoint.archive.toString(),
1172
- blockNumber: blockProposal.blockNumber.toString(),
1173
- });
1174
- return;
1175
- }
1176
- }
1603
+ await this.allNodesCheckpointReceivedCallback(checkpoint, sender);
1177
1604
 
1178
1605
  // Call the checkpoint received callback with the core version (without lastBlock)
1179
1606
  // to validate and potentially generate attestations
1180
- const attestations = await this.checkpointReceivedCallback(checkpoint.toCore(), sender);
1607
+ const attestations = await this.validatorCheckpointReceivedCallback(checkpoint, sender);
1181
1608
  if (attestations && attestations.length > 0) {
1182
1609
  // If the callback returned attestations, add them to the pool and propagate them
1183
- await this.mempools.attestationPool.addCheckpointAttestations(attestations);
1610
+ await this.mempools.attestationPool.addOwnCheckpointAttestations(attestations);
1184
1611
  for (const attestation of attestations) {
1185
1612
  await this.propagate(attestation);
1186
1613
  }
@@ -1200,82 +1627,87 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1200
1627
  }
1201
1628
 
1202
1629
  /**
1203
- * 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.
1204
1632
  * @param request - The block transactions request.
1205
1633
  * @param response - The block transactions response.
1206
1634
  * @param peerId - The ID of the peer that made the request.
1207
- * @returns True if the requested block transactions are valid, false otherwise.
1635
+ * @returns True if the request-response is consistent, false otherwise.
1208
1636
  */
1209
- @trackSpan('Libp2pService.validateRequestedBlockTxs', request => ({
1210
- [Attributes.BLOCK_HASH]: request.blockHash.toString(),
1637
+ @trackSpan('Libp2pService.validateRequestedBlockTxsConsistency', request => ({
1638
+ [Attributes.BLOCK_ARCHIVE]: request.archiveRoot.toString(),
1211
1639
  }))
1212
- private async validateRequestedBlockTxs(
1640
+ protected async validateRequestedBlockTxsConsistency(
1213
1641
  request: BlockTxsRequest,
1214
1642
  response: BlockTxsResponse,
1215
1643
  peerId: PeerId,
1216
1644
  ): Promise<boolean> {
1217
- const requestedTxValidator = this.createRequestedTxValidator();
1218
-
1219
1645
  try {
1220
- 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) {
1221
1650
  this.peerManager.penalizePeer(peerId, PeerErrorSeverity.MidToleranceError);
1222
- throw new ValidationError(
1223
- `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`,
1224
1667
  );
1668
+ // NOTE: We mark the response as invalid, given the limitations of a true/false return value.
1669
+ return false;
1225
1670
  }
1226
1671
 
1227
- if (response.txIndices.getLength() !== request.txIndices.getLength()) {
1228
- 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);
1229
1681
  throw new ValidationError(
1230
- `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)',
1231
1683
  );
1232
1684
  }
1233
1685
 
1234
- // Check no duplicates and not exceeding returnable count
1235
- const requestedIndices = new Set(request.txIndices.getTrueIndices());
1236
- const availableIndices = new Set(response.txIndices.getTrueIndices());
1237
- const maxReturnable = [...requestedIndices].filter(i => availableIndices.has(i)).length;
1238
-
1239
- const returnedHashes = await Promise.all(response.txs.map(tx => tx.getTxHash().toString()));
1240
- const uniqueReturned = new Set(returnedHashes.map(h => h.toString()));
1241
- if (uniqueReturned.size !== returnedHashes.length) {
1242
- this.peerManager.penalizePeer(peerId, PeerErrorSeverity.MidToleranceError);
1243
- 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;
1244
1690
  }
1245
- 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) {
1246
1694
  this.peerManager.penalizePeer(peerId, PeerErrorSeverity.MidToleranceError);
1247
1695
  throw new ValidationError(
1248
- `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()}`,
1249
1697
  );
1250
1698
  }
1251
1699
 
1252
- // Given proposal (should have locally), ensure returned txs are valid subset and match request indices
1253
- const proposal = await this.mempools.attestationPool.getBlockProposal(request.blockHash.toString());
1254
- if (proposal) {
1255
- // Build intersected indices
1256
- const intersectIdx = request.txIndices.getTrueIndices().filter(i => response.txIndices.isSet(i));
1257
-
1258
- // Enforce subset membership and preserve increasing order by index.
1259
- const hashToIndexInProposal = new Map<string, number>(
1260
- proposal.txHashes.map((h, i) => [h.toString(), i] as [string, number]),
1261
- );
1262
- const allowedIndexSet = new Set(intersectIdx);
1263
- const indices = returnedHashes.map(h => hashToIndexInProposal.get(h));
1264
- const allAllowed = indices.every(idx => idx !== undefined && allowedIndexSet.has(idx));
1265
- const strictlyIncreasing = indices.every((idx, i) => (i === 0 ? idx !== undefined : idx! > indices[i - 1]!));
1266
- if (!allAllowed || !strictlyIncreasing) {
1267
- this.peerManager.penalizePeer(peerId, PeerErrorSeverity.LowToleranceError);
1268
- throw new ValidationError('Returned txs do not match expected subset/order for requested indices');
1269
- }
1270
- } else {
1271
- // No local proposal, cannot check the membership/order of the returned txs
1272
- this.logger.warn(
1273
- `Block proposal not found for block hash ${request.blockHash.toString()}; cannot validate membership/order of returned txs`,
1274
- );
1275
- 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');
1276
1709
  }
1277
1710
 
1278
- await Promise.all(response.txs.map(tx => this.validateRequestedTx(tx, peerId, requestedTxValidator)));
1279
1711
  return true;
1280
1712
  } catch (e: any) {
1281
1713
  if (e instanceof ValidationError) {
@@ -1288,219 +1720,85 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1288
1720
  }
1289
1721
  }
1290
1722
 
1291
- /**
1292
- * Validate a collection of txs that has been requested from a peer.
1293
- *
1294
- * The core component of this validator is that each tx hash MUST match the requested tx hash,
1295
- * In order to perform this check, the tx proof must be verified.
1296
- *
1297
- * Note: This function is called from within `ReqResp.sendRequest` as part of the
1298
- * ReqRespSubProtocol.TX subprotocol validation.
1299
- *
1300
- * @param requestedTxHash - The collection of the txs that was requested.
1301
- * @param responseTx - The collection of txs that was received as a response to the request.
1302
- * @param peerId - The peer ID of the peer that sent the tx.
1303
- * @returns True if the whole collection of txs is valid, false otherwise.
1304
- */
1305
- @trackSpan('Libp2pService.validateRequestedTx', (requestedTxHash, _responseTx) => ({
1306
- [Attributes.TX_HASH]: requestedTxHash.toString(),
1307
- }))
1308
- private async validateRequestedTxs(requestedTxHash: TxHash[], responseTx: Tx[], peerId: PeerId): Promise<boolean> {
1309
- const requested = new Set(requestedTxHash.map(h => h.toString()));
1310
- const requestedTxValidator = this.createRequestedTxValidator();
1311
-
1312
- //TODO: (mralj) - this is somewhat naive implementation, if single tx is invlid we consider the whole response invalid.
1313
- // I think we should still extract the valid txs and return them, so that we can still use the response.
1314
- try {
1315
- await Promise.all(responseTx.map(tx => this.validateRequestedTx(tx, peerId, requestedTxValidator, requested)));
1316
- return true;
1317
- } catch (e: any) {
1318
- if (e instanceof ValidationError) {
1319
- this.logger.warn(`Failed to validate requested txs from peer ${peerId.toString()}, reason ${e.message}`);
1320
- } else {
1321
- this.logger.error(`Error during validation of requested txs`, e);
1322
- }
1323
-
1324
- return false;
1325
- }
1723
+ private getGasFees(): Promise<GasFees> {
1724
+ return this.blockMinFeesProvider.getCurrentMinFees();
1326
1725
  }
1327
1726
 
1328
1727
  /**
1329
- * Validates a BLOCK response.
1330
- *
1331
- * If a local copy exists, enforces hash equality. If missing, rejects (no penalty) since the hash cannot be verified.
1332
- * Penalizes on block number mismatch or hash mismatch.
1333
- *
1334
- * @param requestedBlockNumber - The requested block number.
1335
- * @param responseBlock - The block returned by the peer.
1336
- * @param peerId - The peer that returned the block.
1337
- * @returns True if the response is valid, false otherwise.
1728
+ * Get the BatchTxRequesterLibP2PService dependencies for creating BatchTxRequester instances
1338
1729
  */
1339
- @trackSpan('Libp2pService.validateRequestedBlock', (requestedBlockNumber, _responseBlock) => ({
1340
- [Attributes.BLOCK_NUMBER]: requestedBlockNumber.toString(),
1341
- }))
1342
- private async validateRequestedBlock(
1343
- requestedBlockNumber: Fr,
1344
- responseBlock: L2Block,
1345
- peerId: PeerId,
1346
- ): Promise<boolean> {
1347
- try {
1348
- const reqNum = Number(requestedBlockNumber.toString());
1349
- if (responseBlock.number !== reqNum) {
1350
- this.peerManager.penalizePeer(peerId, PeerErrorSeverity.LowToleranceError);
1351
- return false;
1352
- }
1353
-
1354
- const local = await this.archiver.getBlock(BlockNumber(reqNum));
1355
- if (!local) {
1356
- // We are missing the local block; we cannot verify the hash yet. Reject without penalizing.
1357
- // TODO: Consider extending this validator to accept an expected hash or
1358
- // performing quorum-based checks when using P2P syncing prior to L1 sync.
1359
- this.logger.warn(`Local block ${reqNum} not found; rejecting BLOCK response without hash verification`);
1360
- return false;
1361
- }
1362
- const [localHash, respHash] = await Promise.all([local.hash(), responseBlock.hash()]);
1363
- if (!localHash.equals(respHash)) {
1364
- this.peerManager.penalizePeer(peerId, PeerErrorSeverity.MidToleranceError);
1365
- return false;
1366
- }
1367
-
1368
- return true;
1369
- } catch (e) {
1370
- this.logger.warn(`Error validating requested block`, e);
1371
- return false;
1372
- }
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
+ };
1373
1743
  }
1374
1744
 
1375
- private createRequestedTxValidator(): TxValidator {
1376
- return new AggregateTxValidator(
1377
- new DataTxValidator(),
1378
- new SizeTxValidator(),
1379
- new MetadataTxValidator({
1380
- l1ChainId: new Fr(this.config.l1ChainId),
1381
- rollupVersion: new Fr(this.config.rollupVersion),
1382
- protocolContractsHash,
1383
- vkTreeRoot: getVKTreeRoot(),
1384
- }),
1385
- 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,
1386
1751
  );
1387
- }
1388
-
1389
- private async validateRequestedTx(tx: Tx, peerId: PeerId, txValidator: TxValidator, requested?: Set<`0x${string}`>) {
1390
- const penalize = (severity: PeerErrorSeverity) => this.peerManager.penalizePeer(peerId, severity);
1391
-
1392
- if (!(await tx.validateTxHash())) {
1393
- penalize(PeerErrorSeverity.MidToleranceError);
1394
- throw new ValidationError(`Received tx with invalid hash ${tx.getTxHash().toString()}.`);
1395
- }
1396
1752
 
1397
- if (requested && !requested.has(tx.getTxHash().toString())) {
1398
- penalize(PeerErrorSeverity.MidToleranceError);
1399
- throw new ValidationError(`Received tx with hash ${tx.getTxHash().toString()} that was not requested.`);
1400
- }
1401
-
1402
- const { result } = await txValidator.validateTx(tx);
1403
- if (result === 'invalid') {
1404
- penalize(PeerErrorSeverity.LowToleranceError);
1405
- throw new ValidationError(`Received tx with hash ${tx.getTxHash().toString()} that is invalid.`);
1406
- }
1407
- }
1408
-
1409
- @trackSpan('Libp2pService.validatePropagatedTx', tx => ({
1410
- [Attributes.TX_HASH]: tx.getTxHash().toString(),
1411
- }))
1412
- private async validatePropagatedTx(tx: Tx, peerId: PeerId): Promise<boolean> {
1413
- const currentBlockNumber = await this.archiver.getBlockNumber();
1414
-
1415
- // We accept transactions if they are not expired by the next slot (checked based on the IncludeByTimestamp field)
1416
- const { ts: nextSlotTimestamp } = this.epochCache.getEpochAndSlotInNextL1Slot();
1417
- const messageValidators = await this.createMessageValidators(currentBlockNumber, nextSlotTimestamp);
1418
-
1419
- for (const validator of messageValidators) {
1420
- const outcome = await this.runValidations(tx, validator);
1421
-
1422
- if (outcome.allPassed) {
1423
- continue;
1424
- }
1425
- const { name } = outcome.failure;
1426
- let { severity } = outcome.failure;
1427
-
1428
- // Double spend validator has a special case handler
1429
- if (name === 'doubleSpendValidator') {
1430
- const txBlockNumber = BlockNumber(currentBlockNumber + 1); // tx is expected to be in the next block
1431
- severity = await this.handleDoubleSpendFailure(tx, txBlockNumber);
1432
- }
1433
-
1434
- this.peerManager.penalizePeer(peerId, severity);
1435
- return false;
1436
- }
1437
- return true;
1438
- }
1439
-
1440
- private async getGasFees(blockNumber: BlockNumber): Promise<GasFees> {
1441
- if (blockNumber === this.feesCache?.blockNumber) {
1442
- return this.feesCache.gasFees;
1443
- }
1444
-
1445
- const header = await this.archiver.getBlockHeader(blockNumber);
1446
- const gasFees = header?.globalVariables.gasFees ?? GasFees.empty();
1447
- this.feesCache = { blockNumber, gasFees };
1448
- return gasFees;
1449
- }
1450
-
1451
- public async validate(txs: Tx[]): Promise<void> {
1452
- const currentBlockNumber = await this.archiver.getBlockNumber();
1453
-
1454
- // We accept transactions if they are not expired by the next slot (checked based on the IncludeByTimestamp field)
1455
- const { ts: nextSlotTimestamp } = this.epochCache.getEpochAndSlotInNextL1Slot();
1456
- const messageValidators = await this.createMessageValidators(currentBlockNumber, nextSlotTimestamp);
1457
-
1458
- await Promise.all(
1753
+ const results = await Promise.all(
1459
1754
  txs.map(async tx => {
1460
- for (const validator of messageValidators) {
1461
- const outcome = await this.runValidations(tx, validator);
1462
- if (!outcome.allPassed) {
1463
- throw new Error('Invalid tx detected', { cause: { outcome } });
1464
- }
1465
- }
1755
+ const result = await validator.validateTx(tx);
1756
+ return result.result !== 'invalid';
1466
1757
  }),
1467
1758
  );
1759
+ if (results.some(value => value === false)) {
1760
+ throw new Error('Invalid tx detected');
1761
+ }
1468
1762
  }
1469
1763
 
1470
- /**
1471
- * Create message validators for the given block number and timestamp.
1472
- *
1473
- * Each validator is a pair of a validator and a severity.
1474
- * If a validator fails, the peer is penalized with the severity of the validator.
1475
- *
1476
- * @param currentBlockNumber - The current synced block number.
1477
- * @param nextSlotTimestamp - The timestamp of the next slot (used to validate txs are not expired).
1478
- * @returns The message validators.
1479
- */
1480
- private async createMessageValidators(
1764
+ /** Creates the first stage (fast) validators for gossiped transactions. */
1765
+ protected async createFirstStageMessageValidators(
1481
1766
  currentBlockNumber: BlockNumber,
1482
1767
  nextSlotTimestamp: UInt64,
1483
- ): Promise<Record<string, MessageValidator>[]> {
1484
- const gasFees = await this.getGasFees(currentBlockNumber);
1485
- const allowedInSetup = this.config.txPublicSetupAllowList ?? (await getDefaultAllowedSetupFunctions());
1486
-
1487
- const blockNumberInWhichTheTxIsConsideredToBeIncluded = BlockNumber(currentBlockNumber + 1);
1488
-
1489
- 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(
1490
1779
  nextSlotTimestamp,
1491
- blockNumberInWhichTheTxIsConsideredToBeIncluded,
1780
+ blockNumber,
1492
1781
  this.worldStateSynchronizer,
1493
1782
  gasFees,
1494
1783
  this.config.l1ChainId,
1495
1784
  this.config.rollupVersion,
1496
1785
  protocolContractsHash,
1497
1786
  this.archiver,
1498
- this.proofVerifier,
1499
1787
  !this.config.disableTransactions,
1500
1788
  allowedInSetup,
1789
+ this.logger.getBindings(),
1790
+ {
1791
+ maxTxL2Gas: networkTxGasLimits.l2Gas,
1792
+ maxTxDAGas: networkTxGasLimits.daGas,
1793
+ },
1501
1794
  );
1502
1795
  }
1503
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
+
1504
1802
  /**
1505
1803
  * Run validations on a tx.
1506
1804
  * @param tx - The tx to validate.
@@ -1509,7 +1807,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1509
1807
  */
1510
1808
  private async runValidations(
1511
1809
  tx: Tx,
1512
- messageValidators: Record<string, MessageValidator>,
1810
+ messageValidators: Record<string, TransactionValidator>,
1513
1811
  ): Promise<ValidationOutcome> {
1514
1812
  const validationPromises = Object.entries(messageValidators).map(async ([name, { validator, severity }]) => {
1515
1813
  const { result } = await validator.validateTx(tx);
@@ -1518,8 +1816,10 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1518
1816
 
1519
1817
  // A promise that resolves when all validations have been run
1520
1818
  const allValidations = await Promise.all(validationPromises);
1521
- const failed = allValidations.find(x => !x.isValid);
1522
- 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))!;
1523
1823
  return {
1524
1824
  allPassed: false,
1525
1825
  failure: {
@@ -1551,15 +1851,18 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1551
1851
  return PeerErrorSeverity.HighToleranceError;
1552
1852
  }
1553
1853
 
1554
- const snapshotValidator = new DoubleSpendTxValidator({
1555
- nullifiersExist: async (nullifiers: Buffer[]) => {
1556
- const merkleTree = this.worldStateSynchronizer.getSnapshot(
1557
- BlockNumber(blockNumber - this.config.doubleSpendSeverePeerPenaltyWindow),
1558
- );
1559
- const indices = await merkleTree.findLeafIndices(MerkleTreeId.NULLIFIER_TREE, nullifiers);
1560
- 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
+ },
1561
1863
  },
1562
- });
1864
+ this.logger.getBindings(),
1865
+ );
1563
1866
 
1564
1867
  const validSnapshot = await snapshotValidator.validateTx(tx);
1565
1868
  if (validSnapshot.result !== 'valid') {
@@ -1569,74 +1872,6 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1569
1872
  return PeerErrorSeverity.HighToleranceError;
1570
1873
  }
1571
1874
 
1572
- /**
1573
- * Validate a checkpoint attestation.
1574
- *
1575
- * @param attestation - The checkpoint attestation to validate.
1576
- * @returns True if the checkpoint attestation is valid, false otherwise.
1577
- */
1578
- @trackSpan('Libp2pService.validateCheckpointAttestation', async (_, attestation) => ({
1579
- [Attributes.SLOT_NUMBER]: attestation.payload.header.slotNumber,
1580
- [Attributes.BLOCK_ARCHIVE]: attestation.archive.toString(),
1581
- [Attributes.P2P_ID]: await attestation.p2pMessageLoggingIdentifier().then(i => i.toString()),
1582
- }))
1583
- public async validateCheckpointAttestation(
1584
- peerId: PeerId,
1585
- attestation: CheckpointAttestation,
1586
- ): Promise<P2PValidationResult> {
1587
- const result = await this.checkpointAttestationValidator.validate(attestation);
1588
-
1589
- if (result.result === 'reject') {
1590
- this.logger.debug(`Penalizing peer ${peerId} for checkpoint attestation validation failure`);
1591
- this.peerManager.penalizePeer(peerId, result.severity);
1592
- }
1593
-
1594
- return result;
1595
- }
1596
-
1597
- /**
1598
- * Validate a block proposal.
1599
- *
1600
- * @param block - The block proposal to validate.
1601
- * @returns True if the block proposal is valid, false otherwise.
1602
- */
1603
- @trackSpan('Libp2pService.validateBlockProposal', (_peerId, block) => ({
1604
- [Attributes.SLOT_NUMBER]: block.slotNumber.toString(),
1605
- }))
1606
- public async validateBlockProposal(peerId: PeerId, block: BlockProposal): Promise<P2PValidationResult> {
1607
- const result = await this.blockProposalValidator.validate(block);
1608
-
1609
- if (result.result === 'reject') {
1610
- this.logger.debug(`Penalizing peer ${peerId} for block proposal validation failure`);
1611
- this.peerManager.penalizePeer(peerId, result.severity);
1612
- }
1613
-
1614
- return result;
1615
- }
1616
-
1617
- /**
1618
- * Validate a checkpoint proposal.
1619
- *
1620
- * @param checkpoint - The checkpoint proposal to validate.
1621
- * @returns True if the checkpoint proposal is valid, false otherwise.
1622
- */
1623
- @trackSpan('Libp2pService.validateCheckpointProposal', (_peerId, checkpoint) => ({
1624
- [Attributes.SLOT_NUMBER]: checkpoint.slotNumber.toString(),
1625
- }))
1626
- public async validateCheckpointProposal(
1627
- peerId: PeerId,
1628
- checkpoint: CheckpointProposal,
1629
- ): Promise<P2PValidationResult> {
1630
- const result = await this.checkpointProposalValidator.validate(checkpoint);
1631
-
1632
- if (result.result === 'reject') {
1633
- this.logger.debug(`Penalizing peer ${peerId} for checkpoint proposal validation failure`);
1634
- this.peerManager.penalizePeer(peerId, result.severity);
1635
- }
1636
-
1637
- return result;
1638
- }
1639
-
1640
1875
  public getPeerScore(peerId: PeerId): number {
1641
1876
  return this.node.services.pubsub.score.score(peerId.toString());
1642
1877
  }