@aztec/p2p 0.0.1-commit.9b94fc1 → 0.0.1-commit.9ee6fcc6

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 (573) hide show
  1. package/README.md +129 -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 +4 -4
  5. package/dest/client/factory.d.ts +11 -11
  6. package/dest/client/factory.d.ts.map +1 -1
  7. package/dest/client/factory.js +58 -19
  8. package/dest/client/interface.d.ts +61 -35
  9. package/dest/client/interface.d.ts.map +1 -1
  10. package/dest/client/p2p_client.d.ts +52 -65
  11. package/dest/client/p2p_client.d.ts.map +1 -1
  12. package/dest/client/p2p_client.js +613 -336
  13. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker.d.ts +2 -0
  14. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker.d.ts.map +1 -0
  15. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker.js +304 -0
  16. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.d.ts +73 -0
  17. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.d.ts.map +1 -0
  18. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.js +8 -0
  19. package/dest/config.d.ts +68 -22
  20. package/dest/config.d.ts.map +1 -1
  21. package/dest/config.js +117 -52
  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 -1
  26. package/dest/index.d.ts.map +1 -1
  27. package/dest/index.js +1 -0
  28. package/dest/mem_pools/attestation_pool/attestation_pool.d.ts +111 -76
  29. package/dest/mem_pools/attestation_pool/attestation_pool.d.ts.map +1 -1
  30. package/dest/mem_pools/attestation_pool/attestation_pool.js +445 -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 +529 -289
  34. package/dest/mem_pools/attestation_pool/index.d.ts +2 -3
  35. package/dest/mem_pools/attestation_pool/index.d.ts.map +1 -1
  36. package/dest/mem_pools/attestation_pool/index.js +1 -2
  37. package/dest/mem_pools/attestation_pool/mocks.d.ts +11 -8
  38. package/dest/mem_pools/attestation_pool/mocks.d.ts.map +1 -1
  39. package/dest/mem_pools/attestation_pool/mocks.js +17 -13
  40. package/dest/mem_pools/index.d.ts +3 -2
  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 +9 -1
  44. package/dest/mem_pools/instrumentation.d.ts.map +1 -1
  45. package/dest/mem_pools/instrumentation.js +33 -13
  46. package/dest/mem_pools/interface.d.ts +6 -7
  47. package/dest/mem_pools/interface.d.ts.map +1 -1
  48. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.d.ts +37 -27
  49. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.d.ts.map +1 -1
  50. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.js +314 -335
  51. package/dest/mem_pools/tx_pool/eviction/eviction_manager.d.ts +32 -0
  52. package/dest/mem_pools/tx_pool/eviction/eviction_manager.d.ts.map +1 -0
  53. package/dest/mem_pools/tx_pool/eviction/eviction_manager.js +112 -0
  54. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.d.ts +157 -0
  55. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.d.ts.map +1 -0
  56. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.js +52 -0
  57. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.d.ts +16 -0
  58. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.d.ts.map +1 -0
  59. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.js +123 -0
  60. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.d.ts +17 -0
  61. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.d.ts.map +1 -0
  62. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.js +84 -0
  63. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.d.ts +19 -0
  64. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.d.ts.map +1 -0
  65. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.js +78 -0
  66. package/dest/mem_pools/tx_pool/eviction/low_priority_eviction_rule.d.ts +26 -0
  67. package/dest/mem_pools/tx_pool/eviction/low_priority_eviction_rule.d.ts.map +1 -0
  68. package/dest/mem_pools/tx_pool/eviction/low_priority_eviction_rule.js +84 -0
  69. package/dest/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.d.ts +25 -0
  70. package/dest/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.d.ts.map +1 -0
  71. package/dest/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.js +57 -0
  72. package/dest/mem_pools/tx_pool/index.d.ts +1 -2
  73. package/dest/mem_pools/tx_pool/index.d.ts.map +1 -1
  74. package/dest/mem_pools/tx_pool/index.js +0 -1
  75. package/dest/mem_pools/tx_pool/priority.d.ts +5 -1
  76. package/dest/mem_pools/tx_pool/priority.d.ts.map +1 -1
  77. package/dest/mem_pools/tx_pool/priority.js +8 -3
  78. package/dest/mem_pools/tx_pool/tx_pool.d.ts +11 -6
  79. package/dest/mem_pools/tx_pool/tx_pool.d.ts.map +1 -1
  80. package/dest/mem_pools/tx_pool/tx_pool_test_suite.d.ts +1 -1
  81. package/dest/mem_pools/tx_pool/tx_pool_test_suite.d.ts.map +1 -1
  82. package/dest/mem_pools/tx_pool/tx_pool_test_suite.js +33 -25
  83. package/dest/mem_pools/tx_pool_v2/archive/index.d.ts +2 -0
  84. package/dest/mem_pools/tx_pool_v2/archive/index.d.ts.map +1 -0
  85. package/dest/mem_pools/tx_pool_v2/archive/index.js +1 -0
  86. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.d.ts +43 -0
  87. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.d.ts.map +1 -0
  88. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.js +103 -0
  89. package/dest/mem_pools/tx_pool_v2/deleted_pool.d.ts +104 -0
  90. package/dest/mem_pools/tx_pool_v2/deleted_pool.d.ts.map +1 -0
  91. package/dest/mem_pools/tx_pool_v2/deleted_pool.js +251 -0
  92. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.d.ts +47 -0
  93. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.d.ts.map +1 -0
  94. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.js +128 -0
  95. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.d.ts +17 -0
  96. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.d.ts.map +1 -0
  97. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.js +94 -0
  98. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.d.ts +19 -0
  99. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.d.ts.map +1 -0
  100. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.js +97 -0
  101. package/dest/mem_pools/tx_pool_v2/eviction/index.d.ts +10 -0
  102. package/dest/mem_pools/tx_pool_v2/eviction/index.d.ts.map +1 -0
  103. package/dest/mem_pools/tx_pool_v2/eviction/index.js +11 -0
  104. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.d.ts +180 -0
  105. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.d.ts.map +1 -0
  106. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.js +25 -0
  107. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.d.ts +15 -0
  108. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.d.ts.map +1 -0
  109. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.js +65 -0
  110. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.d.ts +17 -0
  111. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.d.ts.map +1 -0
  112. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.js +93 -0
  113. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.d.ts +16 -0
  114. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.d.ts.map +1 -0
  115. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.js +78 -0
  116. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.d.ts +20 -0
  117. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.d.ts.map +1 -0
  118. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.js +75 -0
  119. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.d.ts +15 -0
  120. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.d.ts.map +1 -0
  121. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.js +19 -0
  122. package/dest/mem_pools/tx_pool_v2/index.d.ts +6 -0
  123. package/dest/mem_pools/tx_pool_v2/index.d.ts.map +1 -0
  124. package/dest/mem_pools/tx_pool_v2/index.js +5 -0
  125. package/dest/mem_pools/tx_pool_v2/instrumentation.d.ts +15 -0
  126. package/dest/mem_pools/tx_pool_v2/instrumentation.d.ts.map +1 -0
  127. package/dest/mem_pools/tx_pool_v2/instrumentation.js +43 -0
  128. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts +215 -0
  129. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts.map +1 -0
  130. package/dest/mem_pools/tx_pool_v2/interfaces.js +10 -0
  131. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts +134 -0
  132. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts.map +1 -0
  133. package/dest/mem_pools/tx_pool_v2/tx_metadata.js +216 -0
  134. package/dest/mem_pools/tx_pool_v2/tx_pool_bench_metrics.d.ts +26 -0
  135. package/dest/mem_pools/tx_pool_v2/tx_pool_bench_metrics.d.ts.map +1 -0
  136. package/dest/mem_pools/tx_pool_v2/tx_pool_bench_metrics.js +70 -0
  137. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.d.ts +108 -0
  138. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.d.ts.map +1 -0
  139. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.js +337 -0
  140. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts +62 -0
  141. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts.map +1 -0
  142. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.js +167 -0
  143. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts +78 -0
  144. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts.map +1 -0
  145. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.js +923 -0
  146. package/dest/msg_validators/attestation_validator/attestation_validator.d.ts +4 -4
  147. package/dest/msg_validators/attestation_validator/attestation_validator.d.ts.map +1 -1
  148. package/dest/msg_validators/attestation_validator/attestation_validator.js +54 -20
  149. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts +7 -7
  150. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts.map +1 -1
  151. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.js +22 -13
  152. package/dest/msg_validators/clock_tolerance.d.ts +21 -0
  153. package/dest/msg_validators/clock_tolerance.d.ts.map +1 -0
  154. package/dest/msg_validators/clock_tolerance.js +38 -0
  155. package/dest/msg_validators/index.d.ts +2 -2
  156. package/dest/msg_validators/index.d.ts.map +1 -1
  157. package/dest/msg_validators/index.js +1 -1
  158. package/dest/msg_validators/proposal_validator/block_proposal_validator.d.ts +11 -0
  159. package/dest/msg_validators/proposal_validator/block_proposal_validator.d.ts.map +1 -0
  160. package/dest/msg_validators/proposal_validator/block_proposal_validator.js +14 -0
  161. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.d.ts +11 -0
  162. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.d.ts.map +1 -0
  163. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.js +20 -0
  164. package/dest/msg_validators/proposal_validator/index.d.ts +4 -0
  165. package/dest/msg_validators/proposal_validator/index.d.ts.map +1 -0
  166. package/dest/msg_validators/proposal_validator/index.js +3 -0
  167. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts +18 -0
  168. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts.map +1 -0
  169. package/dest/msg_validators/proposal_validator/proposal_validator.js +116 -0
  170. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts +4 -4
  171. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts.map +1 -1
  172. package/dest/msg_validators/tx_validator/aggregate_tx_validator.js +3 -3
  173. package/dest/msg_validators/tx_validator/allowed_public_setup.d.ts +2 -1
  174. package/dest/msg_validators/tx_validator/allowed_public_setup.d.ts.map +1 -1
  175. package/dest/msg_validators/tx_validator/allowed_public_setup.js +24 -20
  176. package/dest/msg_validators/tx_validator/allowed_setup_helpers.d.ts +17 -0
  177. package/dest/msg_validators/tx_validator/allowed_setup_helpers.d.ts.map +1 -0
  178. package/dest/msg_validators/tx_validator/allowed_setup_helpers.js +24 -0
  179. package/dest/msg_validators/tx_validator/archive_cache.d.ts +3 -3
  180. package/dest/msg_validators/tx_validator/archive_cache.d.ts.map +1 -1
  181. package/dest/msg_validators/tx_validator/archive_cache.js +1 -1
  182. package/dest/msg_validators/tx_validator/block_header_validator.d.ts +20 -6
  183. package/dest/msg_validators/tx_validator/block_header_validator.d.ts.map +1 -1
  184. package/dest/msg_validators/tx_validator/block_header_validator.js +4 -3
  185. package/dest/msg_validators/tx_validator/contract_instance_validator.d.ts +9 -0
  186. package/dest/msg_validators/tx_validator/contract_instance_validator.d.ts.map +1 -0
  187. package/dest/msg_validators/tx_validator/contract_instance_validator.js +48 -0
  188. package/dest/msg_validators/tx_validator/data_validator.d.ts +3 -1
  189. package/dest/msg_validators/tx_validator/data_validator.d.ts.map +1 -1
  190. package/dest/msg_validators/tx_validator/data_validator.js +39 -3
  191. package/dest/msg_validators/tx_validator/double_spend_validator.d.ts +15 -4
  192. package/dest/msg_validators/tx_validator/double_spend_validator.d.ts.map +1 -1
  193. package/dest/msg_validators/tx_validator/double_spend_validator.js +7 -6
  194. package/dest/msg_validators/tx_validator/factory.d.ts +139 -6
  195. package/dest/msg_validators/tx_validator/factory.d.ts.map +1 -1
  196. package/dest/msg_validators/tx_validator/factory.js +255 -58
  197. package/dest/msg_validators/tx_validator/fee_payer_balance.d.ts +10 -0
  198. package/dest/msg_validators/tx_validator/fee_payer_balance.d.ts.map +1 -0
  199. package/dest/msg_validators/tx_validator/fee_payer_balance.js +24 -0
  200. package/dest/msg_validators/tx_validator/gas_validator.d.ts +68 -3
  201. package/dest/msg_validators/tx_validator/gas_validator.d.ts.map +1 -1
  202. package/dest/msg_validators/tx_validator/gas_validator.js +114 -52
  203. package/dest/msg_validators/tx_validator/index.d.ts +4 -1
  204. package/dest/msg_validators/tx_validator/index.d.ts.map +1 -1
  205. package/dest/msg_validators/tx_validator/index.js +3 -0
  206. package/dest/msg_validators/tx_validator/metadata_validator.d.ts +4 -3
  207. package/dest/msg_validators/tx_validator/metadata_validator.d.ts.map +1 -1
  208. package/dest/msg_validators/tx_validator/metadata_validator.js +6 -6
  209. package/dest/msg_validators/tx_validator/nullifier_cache.d.ts +14 -0
  210. package/dest/msg_validators/tx_validator/nullifier_cache.d.ts.map +1 -0
  211. package/dest/msg_validators/tx_validator/nullifier_cache.js +24 -0
  212. package/dest/msg_validators/tx_validator/phases_validator.d.ts +24 -3
  213. package/dest/msg_validators/tx_validator/phases_validator.d.ts.map +1 -1
  214. package/dest/msg_validators/tx_validator/phases_validator.js +75 -27
  215. package/dest/msg_validators/tx_validator/size_validator.d.ts +8 -0
  216. package/dest/msg_validators/tx_validator/size_validator.d.ts.map +1 -0
  217. package/dest/msg_validators/tx_validator/size_validator.js +23 -0
  218. package/dest/msg_validators/tx_validator/test_utils.d.ts +2 -2
  219. package/dest/msg_validators/tx_validator/test_utils.d.ts.map +1 -1
  220. package/dest/msg_validators/tx_validator/timestamp_validator.d.ts +23 -5
  221. package/dest/msg_validators/tx_validator/timestamp_validator.d.ts.map +1 -1
  222. package/dest/msg_validators/tx_validator/timestamp_validator.js +8 -8
  223. package/dest/msg_validators/tx_validator/tx_permitted_validator.d.ts +3 -2
  224. package/dest/msg_validators/tx_validator/tx_permitted_validator.d.ts.map +1 -1
  225. package/dest/msg_validators/tx_validator/tx_permitted_validator.js +2 -2
  226. package/dest/msg_validators/tx_validator/tx_proof_validator.d.ts +3 -2
  227. package/dest/msg_validators/tx_validator/tx_proof_validator.d.ts.map +1 -1
  228. package/dest/msg_validators/tx_validator/tx_proof_validator.js +2 -2
  229. package/dest/services/data_store.d.ts +1 -1
  230. package/dest/services/data_store.d.ts.map +1 -1
  231. package/dest/services/data_store.js +10 -6
  232. package/dest/services/discv5/discV5_service.js +1 -1
  233. package/dest/services/dummy_service.d.ts +28 -4
  234. package/dest/services/dummy_service.d.ts.map +1 -1
  235. package/dest/services/dummy_service.js +49 -1
  236. package/dest/services/encoding.d.ts +7 -3
  237. package/dest/services/encoding.d.ts.map +1 -1
  238. package/dest/services/encoding.js +23 -15
  239. package/dest/services/gossipsub/index.d.ts +3 -0
  240. package/dest/services/gossipsub/index.d.ts.map +1 -0
  241. package/dest/services/gossipsub/index.js +2 -0
  242. package/dest/services/gossipsub/scoring.d.ts +21 -3
  243. package/dest/services/gossipsub/scoring.d.ts.map +1 -1
  244. package/dest/services/gossipsub/scoring.js +24 -7
  245. package/dest/services/gossipsub/topic_score_params.d.ts +173 -0
  246. package/dest/services/gossipsub/topic_score_params.d.ts.map +1 -0
  247. package/dest/services/gossipsub/topic_score_params.js +346 -0
  248. package/dest/services/index.d.ts +2 -1
  249. package/dest/services/index.d.ts.map +1 -1
  250. package/dest/services/index.js +1 -0
  251. package/dest/services/libp2p/instrumentation.d.ts +1 -1
  252. package/dest/services/libp2p/instrumentation.d.ts.map +1 -1
  253. package/dest/services/libp2p/instrumentation.js +30 -72
  254. package/dest/services/libp2p/libp2p_service.d.ts +111 -43
  255. package/dest/services/libp2p/libp2p_service.d.ts.map +1 -1
  256. package/dest/services/libp2p/libp2p_service.js +1047 -388
  257. package/dest/services/peer-manager/metrics.d.ts +9 -2
  258. package/dest/services/peer-manager/metrics.d.ts.map +1 -1
  259. package/dest/services/peer-manager/metrics.js +39 -21
  260. package/dest/services/peer-manager/peer_manager.d.ts +2 -2
  261. package/dest/services/peer-manager/peer_manager.d.ts.map +1 -1
  262. package/dest/services/peer-manager/peer_manager.js +10 -15
  263. package/dest/services/peer-manager/peer_scoring.d.ts +1 -1
  264. package/dest/services/peer-manager/peer_scoring.d.ts.map +1 -1
  265. package/dest/services/peer-manager/peer_scoring.js +32 -6
  266. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts +51 -0
  267. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts.map +1 -0
  268. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.js +540 -0
  269. package/dest/services/reqresp/batch-tx-requester/config.d.ts +17 -0
  270. package/dest/services/reqresp/batch-tx-requester/config.d.ts.map +1 -0
  271. package/dest/services/reqresp/batch-tx-requester/config.js +27 -0
  272. package/dest/services/reqresp/batch-tx-requester/interface.d.ts +47 -0
  273. package/dest/services/reqresp/batch-tx-requester/interface.d.ts.map +1 -0
  274. package/dest/services/reqresp/batch-tx-requester/interface.js +1 -0
  275. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts +35 -0
  276. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts.map +1 -0
  277. package/dest/services/reqresp/batch-tx-requester/missing_txs.js +136 -0
  278. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts +62 -0
  279. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts.map +1 -0
  280. package/dest/services/reqresp/batch-tx-requester/peer_collection.js +176 -0
  281. package/dest/services/reqresp/batch-tx-requester/tx_validator.d.ts +20 -0
  282. package/dest/services/reqresp/batch-tx-requester/tx_validator.d.ts.map +1 -0
  283. package/dest/services/reqresp/batch-tx-requester/tx_validator.js +21 -0
  284. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.d.ts +22 -3
  285. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.d.ts.map +1 -1
  286. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.js +63 -4
  287. package/dest/services/reqresp/connection-sampler/connection_sampler.d.ts +2 -1
  288. package/dest/services/reqresp/connection-sampler/connection_sampler.d.ts.map +1 -1
  289. package/dest/services/reqresp/connection-sampler/connection_sampler.js +12 -0
  290. package/dest/services/reqresp/constants.d.ts +12 -0
  291. package/dest/services/reqresp/constants.d.ts.map +1 -0
  292. package/dest/services/reqresp/constants.js +7 -0
  293. package/dest/services/reqresp/interface.d.ts +13 -2
  294. package/dest/services/reqresp/interface.d.ts.map +1 -1
  295. package/dest/services/reqresp/interface.js +16 -2
  296. package/dest/services/reqresp/metrics.d.ts +6 -5
  297. package/dest/services/reqresp/metrics.d.ts.map +1 -1
  298. package/dest/services/reqresp/metrics.js +17 -21
  299. package/dest/services/reqresp/protocols/auth.d.ts +2 -2
  300. package/dest/services/reqresp/protocols/auth.d.ts.map +1 -1
  301. package/dest/services/reqresp/protocols/auth.js +2 -2
  302. package/dest/services/reqresp/protocols/block.d.ts +1 -1
  303. package/dest/services/reqresp/protocols/block.d.ts.map +1 -1
  304. package/dest/services/reqresp/protocols/block.js +3 -2
  305. package/dest/services/reqresp/protocols/block_txs/bitvector.d.ts +5 -1
  306. package/dest/services/reqresp/protocols/block_txs/bitvector.d.ts.map +1 -1
  307. package/dest/services/reqresp/protocols/block_txs/bitvector.js +12 -0
  308. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts +7 -5
  309. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts.map +1 -1
  310. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.js +27 -9
  311. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts +30 -7
  312. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts.map +1 -1
  313. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.js +60 -14
  314. package/dest/services/reqresp/protocols/status.d.ts +5 -4
  315. package/dest/services/reqresp/protocols/status.d.ts.map +1 -1
  316. package/dest/services/reqresp/protocols/status.js +7 -3
  317. package/dest/services/reqresp/protocols/tx.d.ts +8 -3
  318. package/dest/services/reqresp/protocols/tx.d.ts.map +1 -1
  319. package/dest/services/reqresp/protocols/tx.js +20 -0
  320. package/dest/services/reqresp/reqresp.d.ts +6 -1
  321. package/dest/services/reqresp/reqresp.d.ts.map +1 -1
  322. package/dest/services/reqresp/reqresp.js +488 -58
  323. package/dest/services/service.d.ts +56 -4
  324. package/dest/services/service.d.ts.map +1 -1
  325. package/dest/services/tx_collection/config.d.ts +22 -1
  326. package/dest/services/tx_collection/config.d.ts.map +1 -1
  327. package/dest/services/tx_collection/config.js +56 -2
  328. package/dest/services/tx_collection/fast_tx_collection.d.ts +10 -9
  329. package/dest/services/tx_collection/fast_tx_collection.d.ts.map +1 -1
  330. package/dest/services/tx_collection/fast_tx_collection.js +95 -84
  331. package/dest/services/tx_collection/file_store_tx_collection.d.ts +53 -0
  332. package/dest/services/tx_collection/file_store_tx_collection.d.ts.map +1 -0
  333. package/dest/services/tx_collection/file_store_tx_collection.js +167 -0
  334. package/dest/services/tx_collection/file_store_tx_source.d.ts +37 -0
  335. package/dest/services/tx_collection/file_store_tx_source.d.ts.map +1 -0
  336. package/dest/services/tx_collection/file_store_tx_source.js +90 -0
  337. package/dest/services/tx_collection/index.d.ts +3 -1
  338. package/dest/services/tx_collection/index.d.ts.map +1 -1
  339. package/dest/services/tx_collection/index.js +2 -0
  340. package/dest/services/tx_collection/instrumentation.d.ts +1 -1
  341. package/dest/services/tx_collection/instrumentation.d.ts.map +1 -1
  342. package/dest/services/tx_collection/instrumentation.js +11 -13
  343. package/dest/services/tx_collection/proposal_tx_collector.d.ts +48 -0
  344. package/dest/services/tx_collection/proposal_tx_collector.d.ts.map +1 -0
  345. package/dest/services/tx_collection/proposal_tx_collector.js +50 -0
  346. package/dest/services/tx_collection/request_tracker.d.ts +53 -0
  347. package/dest/services/tx_collection/request_tracker.d.ts.map +1 -0
  348. package/dest/services/tx_collection/request_tracker.js +84 -0
  349. package/dest/services/tx_collection/slow_tx_collection.d.ts +9 -4
  350. package/dest/services/tx_collection/slow_tx_collection.d.ts.map +1 -1
  351. package/dest/services/tx_collection/slow_tx_collection.js +60 -26
  352. package/dest/services/tx_collection/tx_collection.d.ts +31 -20
  353. package/dest/services/tx_collection/tx_collection.d.ts.map +1 -1
  354. package/dest/services/tx_collection/tx_collection.js +79 -7
  355. package/dest/services/tx_collection/tx_collection_sink.d.ts +18 -8
  356. package/dest/services/tx_collection/tx_collection_sink.d.ts.map +1 -1
  357. package/dest/services/tx_collection/tx_collection_sink.js +26 -29
  358. package/dest/services/tx_collection/tx_source.d.ts +8 -3
  359. package/dest/services/tx_collection/tx_source.d.ts.map +1 -1
  360. package/dest/services/tx_collection/tx_source.js +19 -2
  361. package/dest/services/tx_file_store/config.d.ts +16 -0
  362. package/dest/services/tx_file_store/config.d.ts.map +1 -0
  363. package/dest/services/tx_file_store/config.js +22 -0
  364. package/dest/services/tx_file_store/index.d.ts +4 -0
  365. package/dest/services/tx_file_store/index.d.ts.map +1 -0
  366. package/dest/services/tx_file_store/index.js +3 -0
  367. package/dest/services/tx_file_store/instrumentation.d.ts +15 -0
  368. package/dest/services/tx_file_store/instrumentation.d.ts.map +1 -0
  369. package/dest/services/tx_file_store/instrumentation.js +29 -0
  370. package/dest/services/tx_file_store/tx_file_store.d.ts +48 -0
  371. package/dest/services/tx_file_store/tx_file_store.d.ts.map +1 -0
  372. package/dest/services/tx_file_store/tx_file_store.js +152 -0
  373. package/dest/services/tx_provider.d.ts +7 -5
  374. package/dest/services/tx_provider.d.ts.map +1 -1
  375. package/dest/services/tx_provider.js +20 -10
  376. package/dest/services/tx_provider_instrumentation.d.ts +5 -2
  377. package/dest/services/tx_provider_instrumentation.d.ts.map +1 -1
  378. package/dest/services/tx_provider_instrumentation.js +14 -14
  379. package/dest/test-helpers/index.d.ts +3 -1
  380. package/dest/test-helpers/index.d.ts.map +1 -1
  381. package/dest/test-helpers/index.js +2 -0
  382. package/dest/test-helpers/make-test-p2p-clients.d.ts +7 -8
  383. package/dest/test-helpers/make-test-p2p-clients.d.ts.map +1 -1
  384. package/dest/test-helpers/make-test-p2p-clients.js +1 -2
  385. package/dest/test-helpers/mock-pubsub.d.ts +30 -4
  386. package/dest/test-helpers/mock-pubsub.d.ts.map +1 -1
  387. package/dest/test-helpers/mock-pubsub.js +105 -4
  388. package/dest/test-helpers/mock-tx-helpers.js +1 -1
  389. package/dest/test-helpers/reqresp-nodes.d.ts +2 -3
  390. package/dest/test-helpers/reqresp-nodes.d.ts.map +1 -1
  391. package/dest/test-helpers/reqresp-nodes.js +4 -3
  392. package/dest/test-helpers/test_tx_provider.d.ts +40 -0
  393. package/dest/test-helpers/test_tx_provider.d.ts.map +1 -0
  394. package/dest/test-helpers/test_tx_provider.js +41 -0
  395. package/dest/test-helpers/testbench-utils.d.ts +163 -0
  396. package/dest/test-helpers/testbench-utils.d.ts.map +1 -0
  397. package/dest/test-helpers/testbench-utils.js +385 -0
  398. package/dest/testbench/p2p_client_testbench_worker.d.ts +28 -2
  399. package/dest/testbench/p2p_client_testbench_worker.d.ts.map +1 -1
  400. package/dest/testbench/p2p_client_testbench_worker.js +226 -130
  401. package/dest/testbench/worker_client_manager.d.ts +53 -6
  402. package/dest/testbench/worker_client_manager.d.ts.map +1 -1
  403. package/dest/testbench/worker_client_manager.js +231 -40
  404. package/dest/util.d.ts +3 -3
  405. package/dest/util.d.ts.map +1 -1
  406. package/package.json +18 -18
  407. package/src/bootstrap/bootstrap.ts +7 -4
  408. package/src/client/factory.ts +110 -44
  409. package/src/client/interface.ts +73 -36
  410. package/src/client/p2p_client.ts +277 -397
  411. package/src/client/test/tx_proposal_collector/README.md +227 -0
  412. package/src/client/test/tx_proposal_collector/proposal_tx_collector_worker.ts +343 -0
  413. package/src/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.ts +43 -0
  414. package/src/config.ts +182 -62
  415. package/src/errors/tx-pool.error.ts +12 -0
  416. package/src/index.ts +1 -0
  417. package/src/mem_pools/attestation_pool/attestation_pool.ts +511 -78
  418. package/src/mem_pools/attestation_pool/attestation_pool_test_suite.ts +614 -322
  419. package/src/mem_pools/attestation_pool/index.ts +9 -2
  420. package/src/mem_pools/attestation_pool/mocks.ts +22 -15
  421. package/src/mem_pools/index.ts +4 -1
  422. package/src/mem_pools/instrumentation.ts +43 -14
  423. package/src/mem_pools/interface.ts +5 -7
  424. package/src/mem_pools/tx_pool/README.md +270 -0
  425. package/src/mem_pools/tx_pool/aztec_kv_tx_pool.ts +367 -371
  426. package/src/mem_pools/tx_pool/eviction/eviction_manager.ts +132 -0
  427. package/src/mem_pools/tx_pool/eviction/eviction_strategy.ts +208 -0
  428. package/src/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.ts +163 -0
  429. package/src/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.ts +104 -0
  430. package/src/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.ts +93 -0
  431. package/src/mem_pools/tx_pool/eviction/low_priority_eviction_rule.ts +106 -0
  432. package/src/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.ts +75 -0
  433. package/src/mem_pools/tx_pool/index.ts +0 -1
  434. package/src/mem_pools/tx_pool/priority.ts +10 -3
  435. package/src/mem_pools/tx_pool/tx_pool.ts +11 -5
  436. package/src/mem_pools/tx_pool/tx_pool_test_suite.ts +26 -18
  437. package/src/mem_pools/tx_pool_v2/README.md +283 -0
  438. package/src/mem_pools/tx_pool_v2/archive/index.ts +1 -0
  439. package/src/mem_pools/tx_pool_v2/archive/tx_archive.ts +120 -0
  440. package/src/mem_pools/tx_pool_v2/deleted_pool.ts +321 -0
  441. package/src/mem_pools/tx_pool_v2/eviction/eviction_manager.ts +160 -0
  442. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.ts +122 -0
  443. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.ts +125 -0
  444. package/src/mem_pools/tx_pool_v2/eviction/index.ts +27 -0
  445. package/src/mem_pools/tx_pool_v2/eviction/interfaces.ts +219 -0
  446. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.ts +74 -0
  447. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.ts +101 -0
  448. package/src/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.ts +91 -0
  449. package/src/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.ts +99 -0
  450. package/src/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.ts +32 -0
  451. package/src/mem_pools/tx_pool_v2/index.ts +12 -0
  452. package/src/mem_pools/tx_pool_v2/instrumentation.ts +69 -0
  453. package/src/mem_pools/tx_pool_v2/interfaces.ts +247 -0
  454. package/src/mem_pools/tx_pool_v2/tx_metadata.ts +337 -0
  455. package/src/mem_pools/tx_pool_v2/tx_pool_bench_metrics.ts +77 -0
  456. package/src/mem_pools/tx_pool_v2/tx_pool_indices.ts +430 -0
  457. package/src/mem_pools/tx_pool_v2/tx_pool_v2.ts +238 -0
  458. package/src/mem_pools/tx_pool_v2/tx_pool_v2_impl.ts +1105 -0
  459. package/src/msg_validators/attestation_validator/README.md +49 -0
  460. package/src/msg_validators/attestation_validator/attestation_validator.ts +39 -23
  461. package/src/msg_validators/attestation_validator/fisherman_attestation_validator.ts +21 -18
  462. package/src/msg_validators/clock_tolerance.ts +52 -0
  463. package/src/msg_validators/index.ts +1 -1
  464. package/src/msg_validators/proposal_validator/README.md +123 -0
  465. package/src/msg_validators/proposal_validator/block_proposal_validator.ts +20 -0
  466. package/src/msg_validators/proposal_validator/checkpoint_proposal_validator.ts +26 -0
  467. package/src/msg_validators/proposal_validator/index.ts +3 -0
  468. package/src/msg_validators/proposal_validator/proposal_validator.ts +116 -0
  469. package/src/msg_validators/tx_validator/README.md +119 -0
  470. package/src/msg_validators/tx_validator/aggregate_tx_validator.ts +5 -5
  471. package/src/msg_validators/tx_validator/allowed_public_setup.ts +22 -27
  472. package/src/msg_validators/tx_validator/allowed_setup_helpers.ts +31 -0
  473. package/src/msg_validators/tx_validator/archive_cache.ts +3 -3
  474. package/src/msg_validators/tx_validator/block_header_validator.ts +21 -8
  475. package/src/msg_validators/tx_validator/contract_instance_validator.ts +56 -0
  476. package/src/msg_validators/tx_validator/data_validator.ts +60 -7
  477. package/src/msg_validators/tx_validator/double_spend_validator.ts +15 -9
  478. package/src/msg_validators/tx_validator/factory.ts +416 -58
  479. package/src/msg_validators/tx_validator/fee_payer_balance.ts +44 -0
  480. package/src/msg_validators/tx_validator/gas_validator.ts +140 -55
  481. package/src/msg_validators/tx_validator/index.ts +3 -0
  482. package/src/msg_validators/tx_validator/metadata_validator.ts +31 -12
  483. package/src/msg_validators/tx_validator/nullifier_cache.ts +30 -0
  484. package/src/msg_validators/tx_validator/phases_validator.ts +87 -30
  485. package/src/msg_validators/tx_validator/size_validator.ts +22 -0
  486. package/src/msg_validators/tx_validator/test_utils.ts +1 -1
  487. package/src/msg_validators/tx_validator/timestamp_validator.ts +30 -19
  488. package/src/msg_validators/tx_validator/tx_permitted_validator.ts +8 -3
  489. package/src/msg_validators/tx_validator/tx_proof_validator.ts +8 -3
  490. package/src/services/data_store.ts +10 -7
  491. package/src/services/discv5/discV5_service.ts +1 -1
  492. package/src/services/dummy_service.ts +65 -2
  493. package/src/services/encoding.ts +22 -13
  494. package/src/services/gossipsub/README.md +641 -0
  495. package/src/services/gossipsub/index.ts +2 -0
  496. package/src/services/gossipsub/scoring.ts +29 -5
  497. package/src/services/gossipsub/topic_score_params.ts +487 -0
  498. package/src/services/index.ts +1 -0
  499. package/src/services/libp2p/instrumentation.ts +32 -73
  500. package/src/services/libp2p/libp2p_service.ts +746 -406
  501. package/src/services/peer-manager/metrics.ts +46 -21
  502. package/src/services/peer-manager/peer_manager.ts +12 -7
  503. package/src/services/peer-manager/peer_scoring.ts +28 -4
  504. package/src/services/reqresp/README.md +229 -0
  505. package/src/services/reqresp/batch-tx-requester/README.md +344 -0
  506. package/src/services/reqresp/batch-tx-requester/batch_tx_requester.ts +670 -0
  507. package/src/services/reqresp/batch-tx-requester/config.ts +40 -0
  508. package/src/services/reqresp/batch-tx-requester/interface.ts +54 -0
  509. package/src/services/reqresp/batch-tx-requester/missing_txs.ts +168 -0
  510. package/src/services/reqresp/batch-tx-requester/peer_collection.ts +249 -0
  511. package/src/services/reqresp/batch-tx-requester/tx_validator.ts +37 -0
  512. package/src/services/reqresp/connection-sampler/batch_connection_sampler.ts +65 -4
  513. package/src/services/reqresp/connection-sampler/connection_sampler.ts +19 -1
  514. package/src/services/reqresp/constants.ts +14 -0
  515. package/src/services/reqresp/interface.ts +30 -2
  516. package/src/services/reqresp/metrics.ts +36 -27
  517. package/src/services/reqresp/protocols/auth.ts +2 -2
  518. package/src/services/reqresp/protocols/block.ts +3 -2
  519. package/src/services/reqresp/protocols/block_txs/bitvector.ts +16 -0
  520. package/src/services/reqresp/protocols/block_txs/block_txs_handler.ts +35 -12
  521. package/src/services/reqresp/protocols/block_txs/block_txs_reqresp.ts +75 -10
  522. package/src/services/reqresp/protocols/status.ts +16 -12
  523. package/src/services/reqresp/protocols/tx.ts +23 -2
  524. package/src/services/reqresp/reqresp.ts +99 -32
  525. package/src/services/service.ts +73 -5
  526. package/src/services/tx_collection/config.ts +84 -2
  527. package/src/services/tx_collection/fast_tx_collection.ts +114 -93
  528. package/src/services/tx_collection/file_store_tx_collection.ts +202 -0
  529. package/src/services/tx_collection/file_store_tx_source.ts +117 -0
  530. package/src/services/tx_collection/index.ts +6 -0
  531. package/src/services/tx_collection/instrumentation.ts +11 -13
  532. package/src/services/tx_collection/proposal_tx_collector.ts +108 -0
  533. package/src/services/tx_collection/request_tracker.ts +127 -0
  534. package/src/services/tx_collection/slow_tx_collection.ts +69 -36
  535. package/src/services/tx_collection/tx_collection.ts +123 -27
  536. package/src/services/tx_collection/tx_collection_sink.ts +30 -34
  537. package/src/services/tx_collection/tx_source.ts +22 -3
  538. package/src/services/tx_file_store/config.ts +37 -0
  539. package/src/services/tx_file_store/index.ts +3 -0
  540. package/src/services/tx_file_store/instrumentation.ts +36 -0
  541. package/src/services/tx_file_store/tx_file_store.ts +175 -0
  542. package/src/services/tx_provider.ts +29 -12
  543. package/src/services/tx_provider_instrumentation.ts +24 -14
  544. package/src/test-helpers/index.ts +2 -0
  545. package/src/test-helpers/make-test-p2p-clients.ts +4 -6
  546. package/src/test-helpers/mock-pubsub.ts +147 -10
  547. package/src/test-helpers/mock-tx-helpers.ts +1 -1
  548. package/src/test-helpers/reqresp-nodes.ts +6 -8
  549. package/src/test-helpers/test_tx_provider.ts +64 -0
  550. package/src/test-helpers/testbench-utils.ts +456 -0
  551. package/src/testbench/p2p_client_testbench_worker.ts +350 -129
  552. package/src/testbench/worker_client_manager.ts +312 -42
  553. package/src/util.ts +8 -2
  554. package/dest/mem_pools/attestation_pool/kv_attestation_pool.d.ts +0 -37
  555. package/dest/mem_pools/attestation_pool/kv_attestation_pool.d.ts.map +0 -1
  556. package/dest/mem_pools/attestation_pool/kv_attestation_pool.js +0 -213
  557. package/dest/mem_pools/attestation_pool/memory_attestation_pool.d.ts +0 -30
  558. package/dest/mem_pools/attestation_pool/memory_attestation_pool.d.ts.map +0 -1
  559. package/dest/mem_pools/attestation_pool/memory_attestation_pool.js +0 -219
  560. package/dest/mem_pools/tx_pool/memory_tx_pool.d.ts +0 -80
  561. package/dest/mem_pools/tx_pool/memory_tx_pool.d.ts.map +0 -1
  562. package/dest/mem_pools/tx_pool/memory_tx_pool.js +0 -238
  563. package/dest/msg_validators/block_proposal_validator/block_proposal_validator.d.ts +0 -12
  564. package/dest/msg_validators/block_proposal_validator/block_proposal_validator.d.ts.map +0 -1
  565. package/dest/msg_validators/block_proposal_validator/block_proposal_validator.js +0 -82
  566. package/dest/msg_validators/block_proposal_validator/index.d.ts +0 -2
  567. package/dest/msg_validators/block_proposal_validator/index.d.ts.map +0 -1
  568. package/dest/msg_validators/block_proposal_validator/index.js +0 -1
  569. package/src/mem_pools/attestation_pool/kv_attestation_pool.ts +0 -298
  570. package/src/mem_pools/attestation_pool/memory_attestation_pool.ts +0 -287
  571. package/src/mem_pools/tx_pool/memory_tx_pool.ts +0 -283
  572. package/src/msg_validators/block_proposal_validator/block_proposal_validator.ts +0 -97
  573. package/src/msg_validators/block_proposal_validator/index.ts +0 -1
@@ -1,34 +1,42 @@
1
1
  import type { EpochCacheInterface } from '@aztec/epoch-cache';
2
- import { SlotNumber } from '@aztec/foundation/branded-types';
3
- import { randomInt } from '@aztec/foundation/crypto';
4
- import { Fr } from '@aztec/foundation/fields';
2
+ import { BlockNumber, type SlotNumber } from '@aztec/foundation/branded-types';
3
+ import { maxBy } from '@aztec/foundation/collection';
4
+ import { Fr } from '@aztec/foundation/curves/bn254';
5
5
  import { type Logger, createLibp2pComponentLogger, createLogger } from '@aztec/foundation/log';
6
6
  import { RunningPromise } from '@aztec/foundation/running-promise';
7
7
  import { Timer } from '@aztec/foundation/timer';
8
8
  import type { AztecAsyncKVStore } from '@aztec/kv-store';
9
- import { getVKTreeRoot } from '@aztec/noir-protocol-circuits-types/vk-tree';
10
9
  import { protocolContractsHash } from '@aztec/protocol-contracts';
11
10
  import type { EthAddress, L2Block, L2BlockSource } from '@aztec/stdlib/block';
12
11
  import type { ContractDataSource } from '@aztec/stdlib/contract';
13
12
  import { GasFees } from '@aztec/stdlib/gas';
14
13
  import type { ClientProtocolCircuitVerifier, PeerInfo, WorldStateSynchronizer } from '@aztec/stdlib/interfaces/server';
15
14
  import {
16
- BlockAttestation,
17
15
  BlockProposal,
16
+ CheckpointAttestation,
17
+ CheckpointProposal,
18
+ type CheckpointProposalCore,
18
19
  type Gossipable,
19
- P2PClientType,
20
20
  P2PMessage,
21
21
  PeerErrorSeverity,
22
+ PeerErrorSeverityByHarshness,
22
23
  TopicType,
23
24
  createTopicString,
24
- getTopicsForClientAndConfig,
25
+ getTopicsForConfig,
25
26
  metricsTopicStrToLabels,
26
27
  } from '@aztec/stdlib/p2p';
27
28
  import { MerkleTreeId } from '@aztec/stdlib/trees';
28
29
  import { Tx, type TxHash, type TxValidationResult, type TxValidator } from '@aztec/stdlib/tx';
29
30
  import type { UInt64 } from '@aztec/stdlib/types';
30
31
  import { compressComponentVersions } from '@aztec/stdlib/versioning';
31
- import { Attributes, OtelMetricsAdapter, type TelemetryClient, WithTracer, trackSpan } from '@aztec/telemetry-client';
32
+ import {
33
+ Attributes,
34
+ OtelMetricsAdapter,
35
+ SpanStatusCode,
36
+ type TelemetryClient,
37
+ WithTracer,
38
+ trackSpan,
39
+ } from '@aztec/telemetry-client';
32
40
 
33
41
  import {
34
42
  type GossipSub,
@@ -36,7 +44,7 @@ import {
36
44
  type GossipsubMessage,
37
45
  gossipsub,
38
46
  } from '@chainsafe/libp2p-gossipsub';
39
- import { createPeerScoreParams, createTopicScoreParams } from '@chainsafe/libp2p-gossipsub/score';
47
+ import { createPeerScoreParams } from '@chainsafe/libp2p-gossipsub/score';
40
48
  import { SignaturePolicy } from '@chainsafe/libp2p-gossipsub/types';
41
49
  import { noise } from '@chainsafe/libp2p-noise';
42
50
  import { yamux } from '@chainsafe/libp2p-yamux';
@@ -50,58 +58,65 @@ import { ENR } from '@nethermindeth/enr';
50
58
  import { createLibp2p } from 'libp2p';
51
59
 
52
60
  import type { P2PConfig } from '../../config.js';
53
- import { ProposalSlotCapExceededError } from '../../errors/attestation-pool.error.js';
54
61
  import type { MemPools } from '../../mem_pools/interface.js';
55
62
  import {
56
- AttestationValidator,
57
63
  BlockProposalValidator,
64
+ CheckpointAttestationValidator,
65
+ CheckpointProposalValidator,
66
+ DoubleSpendTxValidator,
58
67
  FishermanAttestationValidator,
68
+ getDefaultAllowedSetupFunctions,
59
69
  } from '../../msg_validators/index.js';
60
70
  import { MessageSeenValidator } from '../../msg_validators/msg_seen_validator/msg_seen_validator.js';
61
- import { getDefaultAllowedSetupFunctions } from '../../msg_validators/tx_validator/allowed_public_setup.js';
62
- import { type MessageValidator, createTxMessageValidators } from '../../msg_validators/tx_validator/factory.js';
63
71
  import {
64
- AggregateTxValidator,
65
- DataTxValidator,
66
- DoubleSpendTxValidator,
67
- MetadataTxValidator,
68
- TxProofValidator,
69
- } from '../../msg_validators/tx_validator/index.js';
72
+ type TransactionValidator,
73
+ createFirstStageTxValidationsForGossipedTransactions,
74
+ createSecondStageTxValidationsForGossipedTransactions,
75
+ createTxValidatorForBlockProposalReceivedTxs,
76
+ createTxValidatorForReqResponseReceivedTxs,
77
+ } from '../../msg_validators/tx_validator/factory.js';
70
78
  import { GossipSubEvent } from '../../types/index.js';
71
79
  import { type PubSubLibp2p, convertToMultiaddr } from '../../util.js';
72
80
  import { getVersions } from '../../versioning.js';
73
81
  import { AztecDatastore } from '../data_store.js';
74
82
  import { DiscV5Service } from '../discv5/discV5_service.js';
75
83
  import { SnappyTransform, fastMsgIdFn, getMsgIdFn, msgIdToStrFn } from '../encoding.js';
76
- import { gossipScoreThresholds } from '../gossipsub/scoring.js';
84
+ import { APP_SPECIFIC_WEIGHT, gossipScoreThresholds } from '../gossipsub/scoring.js';
85
+ import { createAllTopicScoreParams } from '../gossipsub/topic_score_params.js';
77
86
  import type { PeerManagerInterface } from '../peer-manager/interface.js';
78
87
  import { PeerManager } from '../peer-manager/peer_manager.js';
79
88
  import { PeerScoring } from '../peer-manager/peer_scoring.js';
89
+ import type { BatchTxRequesterLibP2PService } from '../reqresp/batch-tx-requester/interface.js';
80
90
  import type { P2PReqRespConfig } from '../reqresp/config.js';
81
91
  import {
92
+ AuthRequest,
93
+ BlockTxsRequest,
94
+ BlockTxsResponse,
82
95
  DEFAULT_SUB_PROTOCOL_VALIDATORS,
83
96
  type ReqRespInterface,
97
+ type ReqRespResponse,
84
98
  ReqRespSubProtocol,
85
99
  type ReqRespSubProtocolHandler,
86
100
  type ReqRespSubProtocolHandlers,
87
101
  type ReqRespSubProtocolValidators,
102
+ StatusMessage,
88
103
  type SubProtocolMap,
89
104
  ValidationError,
90
- } from '../reqresp/interface.js';
91
- import { reqRespBlockTxsHandler } from '../reqresp/protocols/block_txs/block_txs_handler.js';
92
- import { reqGoodbyeHandler } from '../reqresp/protocols/goodbye.js';
93
- import {
94
- AuthRequest,
95
- BlockTxsRequest,
96
- BlockTxsResponse,
97
- StatusMessage,
98
105
  pingHandler,
106
+ reqGoodbyeHandler,
99
107
  reqRespBlockHandler,
108
+ reqRespBlockTxsHandler,
100
109
  reqRespStatusHandler,
101
110
  reqRespTxHandler,
102
- } from '../reqresp/protocols/index.js';
111
+ } from '../reqresp/index.js';
103
112
  import { ReqResp } from '../reqresp/reqresp.js';
104
- import type { P2PBlockReceivedCallback, P2PService, PeerDiscoveryService } from '../service.js';
113
+ import type {
114
+ P2PBlockReceivedCallback,
115
+ P2PCheckpointReceivedCallback,
116
+ P2PDuplicateAttestationCallback,
117
+ P2PService,
118
+ PeerDiscoveryService,
119
+ } from '../service.js';
105
120
  import { P2PInstrumentation } from './instrumentation.js';
106
121
 
107
122
  interface ValidationResult {
@@ -113,25 +128,36 @@ interface ValidationResult {
113
128
  type ValidationOutcome = { allPassed: true } | { allPassed: false; failure: ValidationResult };
114
129
 
115
130
  // REFACTOR: Unify with the type above
116
- type ReceivedMessageValidationResult<T> =
117
- | { obj: T; result: Exclude<TopicValidatorResult, TopicValidatorResult.Reject> }
118
- | { obj?: undefined; result: TopicValidatorResult.Reject };
131
+ type ReceivedMessageValidationResult<T, M = undefined> =
132
+ | { obj: T; result: Exclude<TopicValidatorResult, TopicValidatorResult.Reject>; metadata?: M }
133
+ | { obj?: T; result: TopicValidatorResult.Reject; metadata?: M };
119
134
 
120
135
  /**
121
136
  * Lib P2P implementation of the P2PService interface.
122
137
  */
123
- export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends WithTracer implements P2PService {
138
+ export class LibP2PService extends WithTracer implements P2PService {
124
139
  private discoveryRunningPromise?: RunningPromise;
125
140
  private msgIdSeenValidators: Record<TopicType, MessageSeenValidator> = {} as Record<TopicType, MessageSeenValidator>;
126
141
 
127
142
  // Message validators
128
- private attestationValidator: AttestationValidator;
129
143
  private blockProposalValidator: BlockProposalValidator;
144
+ private checkpointProposalValidator: CheckpointProposalValidator;
145
+ private checkpointAttestationValidator: CheckpointAttestationValidator;
130
146
 
131
147
  private protocolVersion = '';
132
148
  private topicStrings: Record<TopicType, string> = {} as Record<TopicType, string>;
133
149
 
134
- private feesCache: { blockNumber: number; gasFees: GasFees } | undefined;
150
+ private feesCache: { blockNumber: BlockNumber; gasFees: GasFees } | undefined;
151
+
152
+ /** Callback invoked when a duplicate proposal is detected (triggers slashing). */
153
+ private duplicateProposalCallback?: (info: {
154
+ slot: SlotNumber;
155
+ proposer: EthAddress;
156
+ type: 'checkpoint' | 'block';
157
+ }) => void;
158
+
159
+ /** Callback invoked when a duplicate attestation is detected (triggers slashing). */
160
+ private duplicateAttestationCallback?: P2PDuplicateAttestationCallback;
135
161
 
136
162
  /**
137
163
  * Callback for when a block is received from a peer.
@@ -140,21 +166,29 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
140
166
  */
141
167
  private blockReceivedCallback: P2PBlockReceivedCallback;
142
168
 
169
+ /**
170
+ * Callback for when a checkpoint proposal is received from a peer.
171
+ * @param checkpoint - The checkpoint proposal received from the peer.
172
+ * @returns The attestations for the checkpoint, if any.
173
+ */
174
+ private checkpointReceivedCallback: P2PCheckpointReceivedCallback;
175
+
143
176
  private gossipSubEventHandler: (e: CustomEvent<GossipsubMessage>) => void;
144
177
 
145
178
  private instrumentation: P2PInstrumentation;
146
179
 
180
+ private telemetry: TelemetryClient;
181
+
147
182
  protected logger: Logger;
148
183
 
149
184
  constructor(
150
- private clientType: T,
151
185
  private config: P2PConfig,
152
186
  protected node: PubSubLibp2p,
153
187
  private peerDiscoveryService: PeerDiscoveryService,
154
188
  private reqresp: ReqRespInterface,
155
- private peerManager: PeerManagerInterface,
156
- protected mempools: MemPools<T>,
157
- private archiver: L2BlockSource & ContractDataSource,
189
+ protected peerManager: PeerManagerInterface,
190
+ protected mempools: MemPools,
191
+ protected archiver: L2BlockSource & ContractDataSource,
158
192
  private epochCache: EpochCacheInterface,
159
193
  private proofVerifier: ClientProtocolCircuitVerifier,
160
194
  private worldStateSynchronizer: WorldStateSynchronizer,
@@ -162,6 +196,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
162
196
  logger: Logger = createLogger('p2p:libp2p_service'),
163
197
  ) {
164
198
  super(telemetry, 'LibP2PService');
199
+ this.telemetry = telemetry;
165
200
 
166
201
  // Create child logger with fisherman prefix if in fisherman mode
167
202
  this.logger = config.fishermanMode ? logger.createChild('[FISHERMAN]') : logger;
@@ -170,7 +205,8 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
170
205
 
171
206
  this.msgIdSeenValidators[TopicType.tx] = new MessageSeenValidator(config.seenMessageCacheSize);
172
207
  this.msgIdSeenValidators[TopicType.block_proposal] = new MessageSeenValidator(config.seenMessageCacheSize);
173
- this.msgIdSeenValidators[TopicType.block_attestation] = new MessageSeenValidator(config.seenMessageCacheSize);
208
+ this.msgIdSeenValidators[TopicType.checkpoint_proposal] = new MessageSeenValidator(config.seenMessageCacheSize);
209
+ this.msgIdSeenValidators[TopicType.checkpoint_attestation] = new MessageSeenValidator(config.seenMessageCacheSize);
174
210
 
175
211
  const versions = getVersions(config);
176
212
  this.protocolVersion = compressComponentVersions(versions);
@@ -178,25 +214,42 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
178
214
 
179
215
  this.topicStrings[TopicType.tx] = createTopicString(TopicType.tx, this.protocolVersion);
180
216
  this.topicStrings[TopicType.block_proposal] = createTopicString(TopicType.block_proposal, this.protocolVersion);
181
- this.topicStrings[TopicType.block_attestation] = createTopicString(
182
- TopicType.block_attestation,
217
+ this.topicStrings[TopicType.checkpoint_proposal] = createTopicString(
218
+ TopicType.checkpoint_proposal,
219
+ this.protocolVersion,
220
+ );
221
+ this.topicStrings[TopicType.checkpoint_attestation] = createTopicString(
222
+ TopicType.checkpoint_attestation,
183
223
  this.protocolVersion,
184
224
  );
185
225
 
186
- // Use FishermanAttestationValidator in fisherman mode to validate attestation payloads against proposals
187
- this.attestationValidator = config.fishermanMode
188
- ? new FishermanAttestationValidator(epochCache, mempools.attestationPool!, telemetry)
189
- : new AttestationValidator(epochCache);
190
- this.blockProposalValidator = new BlockProposalValidator(epochCache, { txsPermitted: !config.disableTransactions });
226
+ const proposalValidatorOpts = {
227
+ txsPermitted: !config.disableTransactions,
228
+ maxTxsPerBlock: config.validateMaxTxsPerBlock ?? config.validateMaxTxsPerCheckpoint,
229
+ };
230
+ this.blockProposalValidator = new BlockProposalValidator(epochCache, proposalValidatorOpts);
231
+ this.checkpointProposalValidator = new CheckpointProposalValidator(epochCache, proposalValidatorOpts);
232
+ this.checkpointAttestationValidator = config.fishermanMode
233
+ ? new FishermanAttestationValidator(epochCache, mempools.attestationPool, telemetry)
234
+ : new CheckpointAttestationValidator(epochCache);
191
235
 
192
236
  this.gossipSubEventHandler = this.handleGossipSubEvent.bind(this);
193
237
 
194
- this.blockReceivedCallback = async (block: BlockProposal): Promise<BlockAttestation[] | undefined> => {
195
- this.logger.debug(
196
- `Handler not yet registered: Block received callback not set. Received block for slot ${block.slotNumber} from peer.`,
238
+ this.blockReceivedCallback = async (block: BlockProposal): Promise<boolean> => {
239
+ this.logger.warn(
240
+ `Handler for block received not yet registered on P2P service. Received block ${block.blockNumber} for slot ${block.slotNumber} from peer.`,
197
241
  { p2pMessageIdentifier: await block.p2pMessageLoggingIdentifier() },
198
242
  );
199
- return undefined;
243
+ return true;
244
+ };
245
+
246
+ this.checkpointReceivedCallback = (
247
+ checkpoint: CheckpointProposalCore,
248
+ ): Promise<CheckpointAttestation[] | undefined> => {
249
+ this.logger.debug(
250
+ `Handler not yet registered: Checkpoint received callback not set. Received checkpoint for slot ${checkpoint.slotNumber} from peer.`,
251
+ );
252
+ return Promise.resolve(undefined);
200
253
  };
201
254
  }
202
255
 
@@ -210,12 +263,11 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
210
263
  * @param txPool - The transaction pool to be accessed by the service.
211
264
  * @returns The new service.
212
265
  */
213
- public static async new<T extends P2PClientType>(
214
- clientType: T,
266
+ public static async new(
215
267
  config: P2PConfig,
216
268
  peerId: PeerId,
217
269
  deps: {
218
- mempools: MemPools<T>;
270
+ mempools: MemPools;
219
271
  l2BlockSource: L2BlockSource & ContractDataSource;
220
272
  epochCache: EpochCacheInterface;
221
273
  proofVerifier: ClientProtocolCircuitVerifier;
@@ -242,14 +294,14 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
242
294
 
243
295
  const datastore = new AztecDatastore(peerStore);
244
296
 
245
- const otelMetricsAdapter = new OtelMetricsAdapter(telemetry);
297
+ const otelMetricsAdapter = new OtelMetricsAdapter(telemetry, logger.getBindings());
246
298
 
247
299
  const peerDiscoveryService = new DiscV5Service(
248
300
  peerId,
249
301
  config,
250
302
  packageVersion,
251
303
  telemetry,
252
- createLogger(`${logger.module}:discv5_service`),
304
+ createLogger(`${logger.module}:discv5_service`, logger.getBindings()),
253
305
  );
254
306
 
255
307
  // Seed libp2p's bootstrap discovery with private and trusted peers
@@ -263,10 +315,6 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
263
315
  const versions = getVersions(config);
264
316
  const protocolVersion = compressComponentVersions(versions);
265
317
 
266
- const txTopic = createTopicString(TopicType.tx, protocolVersion);
267
- const blockProposalTopic = createTopicString(TopicType.block_proposal, protocolVersion);
268
- const blockAttestationTopic = createTopicString(TopicType.block_attestation, protocolVersion);
269
-
270
318
  const preferredPeersEnrs: ENR[] = config.preferredPeers.map(enr => ENR.decodeTxt(enr));
271
319
  const directPeers = (
272
320
  await Promise.all(
@@ -286,6 +334,16 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
286
334
 
287
335
  const announceTcpMultiaddr = config.p2pIp ? [convertToMultiaddr(config.p2pIp, p2pPort, 'tcp')] : [];
288
336
 
337
+ // Create dynamic topic score params based on network configuration
338
+ const l1Constants = epochCache.getL1Constants();
339
+ const topicScoreParams = createAllTopicScoreParams(protocolVersion, {
340
+ slotDurationMs: l1Constants.slotDuration * 1000,
341
+ heartbeatIntervalMs: config.gossipsubInterval,
342
+ targetCommitteeSize: l1Constants.targetCommitteeSize,
343
+ blockDurationMs: config.blockDurationMs,
344
+ expectedBlockProposalsPerSlot: config.expectedBlockProposalsPerSlot,
345
+ });
346
+
289
347
  const node = await createLibp2p({
290
348
  start: false,
291
349
  peerId,
@@ -381,30 +439,14 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
381
439
  scoreParams: createPeerScoreParams({
382
440
  // IPColocation factor can be disabled for local testing - default to -5
383
441
  IPColocationFactorWeight: config.debugDisableColocationPenalty ? 0 : -5.0,
384
- topics: {
385
- [txTopic]: createTopicScoreParams({
386
- topicWeight: 1,
387
- invalidMessageDeliveriesWeight: -20,
388
- invalidMessageDeliveriesDecay: 0.5,
389
- }),
390
- [blockAttestationTopic]: createTopicScoreParams({
391
- topicWeight: 1,
392
- invalidMessageDeliveriesWeight: -20,
393
- invalidMessageDeliveriesDecay: 0.5,
394
- }),
395
- [blockProposalTopic]: createTopicScoreParams({
396
- topicWeight: 1,
397
- invalidMessageDeliveriesWeight: -20,
398
- invalidMessageDeliveriesDecay: 0.5,
399
- }),
400
- },
442
+ topics: topicScoreParams,
401
443
  }),
402
444
  }) as (components: GossipSubComponents) => GossipSub,
403
445
  components: (components: { connectionManager: ConnectionManager }) => ({
404
446
  connectionManager: components.connectionManager,
405
447
  }),
406
448
  },
407
- logger: createLibp2pComponentLogger(logger.module),
449
+ logger: createLibp2pComponentLogger(logger.module, logger.getBindings()),
408
450
  });
409
451
 
410
452
  const peerScoring = new PeerScoring(config, telemetry);
@@ -423,13 +465,16 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
423
465
  epochCache,
424
466
  );
425
467
 
426
- // Update gossipsub score params
427
- node.services.pubsub.score.params.appSpecificWeight = 10;
468
+ // Configure application-specific scoring for gossipsub.
469
+ // The weight scales app score to align with gossipsub thresholds:
470
+ // - Disconnect (-50) × 10 = -500 = gossipThreshold (stops receiving gossip)
471
+ // - Ban (-100) × 10 = -1000 = publishThreshold (cannot publish)
472
+ // Note: positive topic scores can offset penalties, so alignment is best-effort.
473
+ node.services.pubsub.score.params.appSpecificWeight = APP_SPECIFIC_WEIGHT;
428
474
  node.services.pubsub.score.params.appSpecificScore = (peerId: string) =>
429
475
  peerManager.shouldDisableP2PGossip(peerId) ? -Infinity : peerManager.getPeerScore(peerId);
430
476
 
431
477
  return new LibP2PService(
432
- clientType,
433
478
  config,
434
479
  node,
435
480
  peerDiscoveryService,
@@ -462,17 +507,6 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
462
507
  }
463
508
  const announceTcpMultiaddr = convertToMultiaddr(p2pIp, p2pPort, 'tcp');
464
509
 
465
- await this.peerManager.initializePeers();
466
- if (!this.config.p2pDiscoveryDisabled) {
467
- await this.peerDiscoveryService.start();
468
- }
469
- await this.node.start();
470
-
471
- // Subscribe to standard GossipSub topics by default
472
- for (const topic of getTopicsForClientAndConfig(this.clientType, this.config.disableTransactions)) {
473
- this.subscribeToTopic(this.topicStrings[topic]);
474
- }
475
-
476
510
  // Create request response protocol handlers
477
511
  const txHandler = reqRespTxHandler(this.mempools);
478
512
  const goodbyeHandler = reqGoodbyeHandler(this.peerManager);
@@ -486,9 +520,12 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
486
520
  [ReqRespSubProtocol.BLOCK]: blockHandler.bind(this),
487
521
  };
488
522
 
489
- // Only handle block transactions request if attestation pool is available to the client
490
- if (this.mempools.attestationPool && !this.config.disableTransactions) {
491
- const blockTxsHandler = reqRespBlockTxsHandler(this.mempools.attestationPool, this.mempools.txPool);
523
+ if (!this.config.disableTransactions) {
524
+ const blockTxsHandler = reqRespBlockTxsHandler(
525
+ this.mempools.attestationPool,
526
+ this.archiver,
527
+ this.mempools.txPool,
528
+ );
492
529
  requestResponseHandlers[ReqRespSubProtocol.BLOCK_TXS] = blockTxsHandler.bind(this);
493
530
  }
494
531
 
@@ -496,10 +533,32 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
496
533
  requestResponseHandlers[ReqRespSubProtocol.TX] = txHandler.bind(this);
497
534
  }
498
535
 
536
+ // Define the sub protocol validators - This is done within this start() method to gain a callback to the existing validateTx function
537
+ const reqrespSubProtocolValidators = {
538
+ ...DEFAULT_SUB_PROTOCOL_VALIDATORS,
539
+ [ReqRespSubProtocol.TX]: this.validateRequestedTxs.bind(this),
540
+ [ReqRespSubProtocol.BLOCK_TXS]: this.validateRequestedBlockTxs.bind(this),
541
+ [ReqRespSubProtocol.BLOCK]: this.validateRequestedBlock.bind(this),
542
+ };
543
+
544
+ await this.peerManager.initializePeers();
545
+
546
+ await this.reqresp.start(requestResponseHandlers, reqrespSubProtocolValidators);
547
+
548
+ await this.node.start();
549
+
550
+ // Subscribe to standard GossipSub topics by default
551
+ for (const topic of getTopicsForConfig(this.config.disableTransactions)) {
552
+ this.subscribeToTopic(this.topicStrings[topic]);
553
+ }
554
+
499
555
  // add GossipSub listener
500
556
  this.node.services.pubsub.addEventListener(GossipSubEvent.MESSAGE, this.gossipSubEventHandler);
501
557
 
502
558
  // Start running promise for peer discovery and metrics collection
559
+ if (!this.config.p2pDiscoveryDisabled) {
560
+ await this.peerDiscoveryService.start();
561
+ }
503
562
  this.discoveryRunningPromise = new RunningPromise(
504
563
  async () => {
505
564
  await this.peerManager.heartbeat();
@@ -509,14 +568,6 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
509
568
  );
510
569
  this.discoveryRunningPromise.start();
511
570
 
512
- // Define the sub protocol validators - This is done within this start() method to gain a callback to the existing validateTx function
513
- const reqrespSubProtocolValidators = {
514
- ...DEFAULT_SUB_PROTOCOL_VALIDATORS,
515
- [ReqRespSubProtocol.TX]: this.validateRequestedTxs.bind(this),
516
- [ReqRespSubProtocol.BLOCK_TXS]: this.validateRequestedBlockTxs.bind(this),
517
- [ReqRespSubProtocol.BLOCK]: this.validateRequestedBlock.bind(this),
518
- };
519
- await this.reqresp.start(requestResponseHandlers, reqrespSubProtocolValidators);
520
571
  this.logger.info(`Started P2P service`, {
521
572
  listen: this.config.listenAddress,
522
573
  port: this.config.p2pPort,
@@ -563,6 +614,10 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
563
614
  return this.peerManager.getPeers(includePending);
564
615
  }
565
616
 
617
+ public getGossipMeshPeerCount(topicType: TopicType): number {
618
+ return this.node.services.pubsub.getMeshPeers(this.topicStrings[topicType]).length;
619
+ }
620
+
566
621
  private handleGossipSubEvent(e: CustomEvent<GossipsubMessage>) {
567
622
  this.logger.trace(`Received PUBSUB message.`);
568
623
 
@@ -590,6 +645,15 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
590
645
  return this.reqresp.sendBatchRequest(protocol, requests, pinnedPeerId);
591
646
  }
592
647
 
648
+ public sendRequestToPeer(
649
+ peerId: PeerId,
650
+ subProtocol: ReqRespSubProtocol,
651
+ payload: Buffer,
652
+ dialTimeout?: number,
653
+ ): Promise<ReqRespResponse> {
654
+ return this.reqresp.sendRequestToPeer(peerId, subProtocol, payload, dialTimeout);
655
+ }
656
+
593
657
  /**
594
658
  * Get the ENR of the node
595
659
  * @returns The ENR of the node
@@ -602,6 +666,29 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
602
666
  this.blockReceivedCallback = callback;
603
667
  }
604
668
 
669
+ public registerCheckpointReceivedCallback(callback: P2PCheckpointReceivedCallback) {
670
+ this.checkpointReceivedCallback = callback;
671
+ }
672
+
673
+ /**
674
+ * Registers a callback to be invoked when a duplicate proposal is detected.
675
+ * This callback is triggered on the first duplicate (when count goes from 1 to 2).
676
+ */
677
+ public registerDuplicateProposalCallback(
678
+ callback: (info: { slot: SlotNumber; proposer: EthAddress; type: 'checkpoint' | 'block' }) => void,
679
+ ): void {
680
+ this.duplicateProposalCallback = callback;
681
+ }
682
+
683
+ /**
684
+ * Registers a callback to be invoked when a duplicate attestation is detected.
685
+ * A validator signing attestations for different proposals at the same slot.
686
+ * This callback is triggered on the first duplicate (when count goes from 1 to 2).
687
+ */
688
+ public registerDuplicateAttestationCallback(callback: P2PDuplicateAttestationCallback): void {
689
+ this.duplicateAttestationCallback = callback;
690
+ }
691
+
605
692
  /**
606
693
  * Subscribes to a topic.
607
694
  * @param topic - The topic to subscribe to.
@@ -623,7 +710,10 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
623
710
  if (!this.node.services.pubsub) {
624
711
  throw new Error('Pubsub service not available.');
625
712
  }
626
- const p2pMessage = P2PMessage.fromGossipable(message, this.config.debugP2PInstrumentMessages);
713
+ const isBlockProposal = topic === this.topicStrings[TopicType.block_proposal];
714
+ const traceContext =
715
+ this.config.debugP2PInstrumentMessages && isBlockProposal ? this.telemetry.getTraceContext() : undefined;
716
+ const p2pMessage = P2PMessage.fromGossipable(message, this.config.debugP2PInstrumentMessages, traceContext);
627
717
  const result = await this.node.services.pubsub.publish(topic, p2pMessage.toMessageData());
628
718
  return result.recipients.length;
629
719
  }
@@ -644,12 +734,15 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
644
734
  case this.topicStrings[TopicType.tx]:
645
735
  topicType = TopicType.tx;
646
736
  break;
647
- case this.topicStrings[TopicType.block_attestation]:
648
- topicType = TopicType.block_attestation;
649
- break;
650
737
  case this.topicStrings[TopicType.block_proposal]:
651
738
  topicType = TopicType.block_proposal;
652
739
  break;
740
+ case this.topicStrings[TopicType.checkpoint_proposal]:
741
+ topicType = TopicType.checkpoint_proposal;
742
+ break;
743
+ case this.topicStrings[TopicType.checkpoint_attestation]:
744
+ topicType = TopicType.checkpoint_attestation;
745
+ break;
653
746
  default:
654
747
  this.logger.error(`Received message on unknown topic: ${msg.topic}`);
655
748
  break;
@@ -660,6 +753,9 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
660
753
  if (!validator || !validator.addMessage(msgId)) {
661
754
  this.instrumentation.incMessagePrevalidationStatus(false, topicType);
662
755
  this.node.services.pubsub.reportMessageValidationResult(msgId, source.toString(), TopicValidatorResult.Ignore);
756
+ if (topicType === TopicType.tx) {
757
+ this.logger.verbose(`Ignoring already-seen tx gossip message`, { msgId, source: source.toString() });
758
+ }
663
759
  return { result: false, topicType };
664
760
  }
665
761
 
@@ -708,36 +804,85 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
708
804
  return;
709
805
  }
710
806
 
807
+ // Determine topic type for attributes
711
808
  if (msg.topic === this.topicStrings[TopicType.tx]) {
712
809
  topicType = TopicType.tx;
713
- await this.handleGossipedTx(p2pMessage.payload, msgId, source);
810
+ } else if (msg.topic === this.topicStrings[TopicType.checkpoint_attestation]) {
811
+ topicType = TopicType.checkpoint_attestation;
812
+ } else if (msg.topic === this.topicStrings[TopicType.block_proposal]) {
813
+ topicType = TopicType.block_proposal;
814
+ } else if (msg.topic === this.topicStrings[TopicType.checkpoint_proposal]) {
815
+ topicType = TopicType.checkpoint_proposal;
714
816
  }
715
- if (msg.topic === this.topicStrings[TopicType.block_attestation]) {
716
- topicType = TopicType.block_attestation;
717
- if (this.clientType === P2PClientType.Full) {
718
- await this.processAttestationFromPeer(p2pMessage.payload, msgId, source);
817
+
818
+ // Process the message, optionally within a linked span for trace propagation
819
+ const processMessage = async () => {
820
+ if (msg.topic === this.topicStrings[TopicType.tx]) {
821
+ await this.handleGossipedTx(p2pMessage.payload, msgId, source);
822
+ } else if (msg.topic === this.topicStrings[TopicType.checkpoint_attestation]) {
823
+ await this.processCheckpointAttestationFromPeer(p2pMessage.payload, msgId, source);
824
+ } else if (msg.topic === this.topicStrings[TopicType.block_proposal]) {
825
+ await this.processBlockFromPeer(p2pMessage.payload, msgId, source);
826
+ } else if (msg.topic === this.topicStrings[TopicType.checkpoint_proposal]) {
827
+ await this.handleGossipedCheckpointProposal(p2pMessage.payload, msgId, source);
828
+ } else {
829
+ this.logger.error(`Received message on unknown topic: ${msg.topic}`);
719
830
  }
720
- }
721
- if (msg.topic === this.topicStrings[TopicType.block_proposal]) {
722
- topicType = TopicType.block_proposal;
723
- await this.processBlockFromPeer(p2pMessage.payload, msgId, source);
831
+ };
832
+
833
+ const latency = p2pMessage.timestamp !== undefined ? msgReceivedTime - p2pMessage.timestamp.getTime() : undefined;
834
+ const propagatedContext = p2pMessage.traceContext
835
+ ? this.telemetry.extractPropagatedContext(p2pMessage.traceContext)
836
+ : undefined;
837
+
838
+ if (propagatedContext) {
839
+ await this.tracer.startActiveSpan(
840
+ 'LibP2PService.processMessage',
841
+ {
842
+ attributes: {
843
+ [Attributes.TOPIC_NAME]: topicType!,
844
+ [Attributes.PEER_ID]: source.toString(),
845
+ },
846
+ },
847
+ propagatedContext,
848
+ async span => {
849
+ try {
850
+ await processMessage();
851
+ span.setStatus({
852
+ code: SpanStatusCode.OK,
853
+ });
854
+ } catch (err) {
855
+ span.setStatus({
856
+ code: SpanStatusCode.ERROR,
857
+ message: String(err),
858
+ });
859
+ if (typeof err === 'string' || (err && err instanceof Error)) {
860
+ span.recordException(err);
861
+ }
862
+ throw err;
863
+ } finally {
864
+ span.end();
865
+ }
866
+ },
867
+ );
868
+ } else {
869
+ await processMessage();
724
870
  }
725
871
 
726
- if (p2pMessage.timestamp !== undefined && topicType !== undefined) {
727
- const latency = msgReceivedTime - p2pMessage.timestamp.getTime();
872
+ if (latency !== undefined && topicType !== undefined) {
728
873
  this.instrumentation.recordMessageLatency(topicType, latency);
729
874
  }
730
875
 
731
876
  return;
732
877
  }
733
878
 
734
- protected async validateReceivedMessage<T>(
735
- validationFunc: () => Promise<ReceivedMessageValidationResult<T>>,
879
+ protected async validateReceivedMessage<T, M = undefined>(
880
+ validationFunc: () => Promise<ReceivedMessageValidationResult<T, M>>,
736
881
  msgId: string,
737
882
  source: PeerId,
738
883
  topicType: TopicType,
739
- ): Promise<ReceivedMessageValidationResult<T>> {
740
- let resultAndObj: ReceivedMessageValidationResult<T> = { result: TopicValidatorResult.Reject };
884
+ ): Promise<ReceivedMessageValidationResult<T, M>> {
885
+ let resultAndObj: ReceivedMessageValidationResult<T, M> = { result: TopicValidatorResult.Reject };
741
886
  const timer = new Timer();
742
887
  try {
743
888
  resultAndObj = await validationFunc();
@@ -761,21 +906,81 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
761
906
  protected async handleGossipedTx(payloadData: Buffer, msgId: string, source: PeerId) {
762
907
  const validationFunc: () => Promise<ReceivedMessageValidationResult<Tx>> = async () => {
763
908
  const tx = Tx.fromBuffer(payloadData);
764
- const isValid = await this.validatePropagatedTx(tx, source);
765
- const exists = isValid && (await this.mempools.txPool.hasTx(tx.getTxHash()));
766
909
 
767
- this.logger.trace(`Validate propagated tx`, {
768
- isValid,
769
- exists,
910
+ const currentBlockNumber = await this.archiver.getBlockNumber();
911
+ const { ts: nextSlotTimestamp } = this.epochCache.getEpochAndSlotInNextL1Slot();
912
+
913
+ // Stage 1: fast validators (metadata, data, timestamps, double-spend, gas, phases, block header)
914
+ const firstStageValidators = await this.createFirstStageMessageValidators(currentBlockNumber, nextSlotTimestamp);
915
+ const firstStageOutcome = await this.runValidations(tx, firstStageValidators);
916
+ if (!firstStageOutcome.allPassed) {
917
+ const { name } = firstStageOutcome.failure;
918
+ let { severity } = firstStageOutcome.failure;
919
+
920
+ // Double spend validator has a special case handler. We perform more detailed examination
921
+ // as to how recently the nullifier was entered into the tree and if the transaction should
922
+ // have 'known' the nullifier existed. This determines the severity of the penalty applied to the peer.
923
+ if (name === 'doubleSpendValidator') {
924
+ const txBlockNumber = BlockNumber(currentBlockNumber + 1);
925
+ severity = await this.handleDoubleSpendFailure(tx, txBlockNumber);
926
+ }
927
+
928
+ this.logger.verbose(`Rejecting gossiped tx ${tx.getTxHash().toString()}: stage 1 validation failed`, {
929
+ validator: name,
930
+ severity,
931
+ source: source.toString(),
932
+ });
933
+ this.peerManager.penalizePeer(source, severity);
934
+ return { result: TopicValidatorResult.Reject };
935
+ }
936
+
937
+ // Pool pre-check: see if the pool would accept this tx before doing expensive proof verification
938
+ const canAdd = await this.mempools.txPool.canAddPendingTx(tx);
939
+ if (canAdd === 'ignored') {
940
+ this.logger.verbose(`Ignoring gossiped tx ${tx.getTxHash().toString()}: pool pre-check returned ignored`, {
941
+ source: source.toString(),
942
+ });
943
+ return { result: TopicValidatorResult.Ignore, obj: tx };
944
+ }
945
+
946
+ // Stage 2: expensive proof verification
947
+ const secondStageValidators = this.createSecondStageMessageValidators();
948
+ const secondStageOutcome = await this.runValidations(tx, secondStageValidators);
949
+ if (!secondStageOutcome.allPassed) {
950
+ const { severity, name } = secondStageOutcome.failure;
951
+ this.logger.verbose(`Rejecting gossiped tx ${tx.getTxHash().toString()}: stage 2 validation failed`, {
952
+ validator: name,
953
+ severity,
954
+ source: source.toString(),
955
+ });
956
+ this.peerManager.penalizePeer(source, severity);
957
+ return { result: TopicValidatorResult.Reject };
958
+ }
959
+
960
+ // Pool add: persist the tx
961
+ const txHash = tx.getTxHash();
962
+ const addResult = await this.mempools.txPool.addPendingTxs([tx], { source: 'gossip' });
963
+
964
+ const wasAccepted = addResult.accepted.some(h => h.equals(txHash));
965
+ const wasIgnored = addResult.ignored.some(h => h.equals(txHash));
966
+
967
+ this.logger.verbose(`Validate propagated tx ${txHash.toString()}`, {
968
+ wasAccepted,
969
+ wasIgnored,
770
970
  [Attributes.P2P_ID]: source.toString(),
771
971
  });
772
972
 
773
- if (!isValid) {
774
- return { result: TopicValidatorResult.Reject };
775
- } else if (exists) {
973
+ if (wasAccepted) {
974
+ return { result: TopicValidatorResult.Accept, obj: tx };
975
+ } else if (wasIgnored) {
776
976
  return { result: TopicValidatorResult.Ignore, obj: tx };
777
977
  } else {
778
- return { result: TopicValidatorResult.Accept, obj: tx };
978
+ this.logger.warn(`Gossiped tx ${txHash.toString()} unexpectedly rejected by pool`, {
979
+ source: source.toString(),
980
+ txHash: txHash.toString(),
981
+ });
982
+ this.peerManager.penalizePeer(source, PeerErrorSeverity.HighToleranceError);
983
+ return { result: TopicValidatorResult.Reject };
779
984
  }
780
985
  };
781
986
 
@@ -784,6 +989,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
784
989
  return;
785
990
  }
786
991
 
992
+ // Tx was accepted into pool and will be propagated - just log and record metrics
787
993
  const txHash = tx.getTxHash();
788
994
  const txHashString = txHash.toString();
789
995
  this.logger.verbose(`Received tx ${txHashString} from external peer ${source.toString()} via gossip`, {
@@ -791,73 +997,31 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
791
997
  txHash: txHashString,
792
998
  });
793
999
 
794
- if (this.config.dropTransactions && randomInt(1000) < this.config.dropTransactionsProbability * 1000) {
795
- this.logger.warn(`Intentionally dropping tx ${txHashString} (probability rule)`);
796
- return;
797
- }
798
-
799
1000
  this.instrumentation.incrementTxReceived(1);
800
- await this.mempools.txPool.addTxs([tx]);
801
1001
  }
802
1002
 
803
1003
  /**
804
- * Process Attestation From Peer
805
- * When a proposal is received from a peer, we add it to the attestation pool, so it can be accessed by other services.
806
- *
807
- * @param attestation - The attestation to process.
1004
+ * Process a checkpoint attestation from a peer.
1005
+ * Validates the attestation and adds it to the pool.
808
1006
  */
809
- private async processAttestationFromPeer(payloadData: Buffer, msgId: string, source: PeerId): Promise<void> {
810
- const validationFunc: () => Promise<ReceivedMessageValidationResult<BlockAttestation>> = async () => {
811
- const attestation = BlockAttestation.fromBuffer(payloadData);
812
- const pool = this.mempools.attestationPool!;
813
- const isValid = await this.validateAttestation(source, attestation);
814
- const exists = isValid && (await pool.hasAttestation(attestation));
815
-
816
- let canAdd = true;
817
- if (isValid && !exists) {
818
- const slot = attestation.payload.header.slotNumber;
819
- const { committee } = await this.epochCache.getCommittee(slot);
820
- const committeeSize = committee?.length ?? 0;
821
- canAdd = await pool.canAddAttestation(attestation, committeeSize);
822
- }
823
-
824
- this.logger.trace(`Validate propagated block attestation`, {
825
- isValid,
826
- exists,
827
- canAdd,
828
- [Attributes.SLOT_NUMBER]: attestation.payload.header.slotNumber.toString(),
829
- [Attributes.P2P_ID]: source.toString(),
830
- });
831
-
832
- if (!isValid) {
833
- return { result: TopicValidatorResult.Reject };
834
- } else if (exists) {
835
- return { result: TopicValidatorResult.Ignore, obj: attestation };
836
- } else if (!canAdd) {
837
- this.logger.warn(`Dropping block attestation due to per-(slot, proposalId) attestation cap`, {
838
- slot: attestation.payload.header.slotNumber.toString(),
839
- archive: attestation.archive.toString(),
840
- source: source.toString(),
841
- });
842
- return { result: TopicValidatorResult.Ignore, obj: attestation };
843
- } else {
844
- return { result: TopicValidatorResult.Accept, obj: attestation };
845
- }
846
- };
847
-
848
- const { result, obj: attestation } = await this.validateReceivedMessage<BlockAttestation>(
849
- validationFunc,
1007
+ private async processCheckpointAttestationFromPeer(
1008
+ payloadData: Buffer,
1009
+ msgId: string,
1010
+ source: PeerId,
1011
+ ): Promise<void> {
1012
+ const { result, obj: attestation } = await this.validateReceivedMessage<CheckpointAttestation>(
1013
+ () => this.validateAndStoreCheckpointAttestation(source, CheckpointAttestation.fromBuffer(payloadData)),
850
1014
  msgId,
851
1015
  source,
852
- TopicType.block_attestation,
1016
+ TopicType.checkpoint_attestation,
853
1017
  );
854
1018
 
855
1019
  if (result !== TopicValidatorResult.Accept || !attestation) {
856
1020
  return;
857
1021
  }
858
1022
 
859
- this.logger.debug(
860
- `Received attestation for slot ${attestation.slotNumber} from external peer ${source.toString()}`,
1023
+ this.logger.verbose(
1024
+ `Received valid checkpoint attestation for slot ${attestation.slotNumber} from external peer ${source.toString()}`,
861
1025
  {
862
1026
  p2pMessageIdentifier: await attestation.p2pMessageLoggingIdentifier(),
863
1027
  slot: attestation.slotNumber,
@@ -865,123 +1029,354 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
865
1029
  source: source.toString(),
866
1030
  },
867
1031
  );
868
-
869
- await this.mempools.attestationPool!.addAttestations([attestation]);
870
1032
  }
871
1033
 
872
- private async processBlockFromPeer(payloadData: Buffer, msgId: string, source: PeerId): Promise<void> {
873
- const validationFunc: () => Promise<ReceivedMessageValidationResult<BlockProposal>> = async () => {
874
- const block = BlockProposal.fromBuffer(payloadData);
875
- const isValid = await this.validateBlockProposal(source, block);
876
- const pool = this.mempools.attestationPool;
877
-
878
- // Note that we dont have an attestation pool if we're a prover node, but we still
879
- // subscribe to block proposal topics in order to prevent their txs from being cleared.
880
- const exists = isValid && (await pool?.hasBlockProposal(block));
881
- const canAdd = isValid && (await pool?.canAddProposal(block));
882
-
883
- this.logger.trace(`Validate propagated block proposal`, {
884
- isValid,
885
- exists,
886
- canAdd,
887
- [Attributes.SLOT_NUMBER]: block.payload.header.slotNumber.toString(),
888
- [Attributes.P2P_ID]: source.toString(),
1034
+ /** Validates a checkpoint attestation and adds it to the pool. Penalizes the peer if validation fails. */
1035
+ @trackSpan('Libp2pService.validateAndStoreCheckpointAttestation', (_peerId, attestation) => ({
1036
+ [Attributes.SLOT_NUMBER]: attestation.payload.header.slotNumber.toString(),
1037
+ }))
1038
+ protected async validateAndStoreCheckpointAttestation(
1039
+ peerId: PeerId,
1040
+ attestation: CheckpointAttestation,
1041
+ ): Promise<ReceivedMessageValidationResult<CheckpointAttestation>> {
1042
+ const validationResult = await this.checkpointAttestationValidator.validate(attestation);
1043
+
1044
+ if (validationResult.result === 'reject') {
1045
+ this.logger.warn(`Penalizing peer ${peerId} for checkpoint attestation validation failure`);
1046
+ this.peerManager.penalizePeer(peerId, validationResult.severity);
1047
+ return { result: TopicValidatorResult.Reject };
1048
+ }
1049
+
1050
+ if (validationResult.result === 'ignore') {
1051
+ return { result: TopicValidatorResult.Ignore, obj: attestation };
1052
+ }
1053
+
1054
+ // Try to add the attestation: this handles existence check, cap check, and adding in one call
1055
+ // count is the number of attestations by this signer for this slot (for duplicate detection)
1056
+ const slot = attestation.payload.header.slotNumber;
1057
+ const { added, alreadyExists, count } =
1058
+ await this.mempools.attestationPool.tryAddCheckpointAttestation(attestation);
1059
+
1060
+ this.logger.trace(`Validate propagated checkpoint attestation`, {
1061
+ added,
1062
+ alreadyExists,
1063
+ count,
1064
+ [Attributes.SLOT_NUMBER]: slot.toString(),
1065
+ [Attributes.P2P_ID]: peerId.toString(),
1066
+ });
1067
+
1068
+ // Exact same attestation received, no need to re-broadcast
1069
+ if (alreadyExists) {
1070
+ return { result: TopicValidatorResult.Ignore, obj: attestation };
1071
+ }
1072
+
1073
+ // Could not add (cap reached for signer), no need to re-broadcast
1074
+ if (!added) {
1075
+ this.logger.warn(`Dropping checkpoint attestation due to cap`, {
1076
+ slot: slot.toString(),
1077
+ archive: attestation.archive.toString(),
1078
+ source: peerId.toString(),
1079
+ attester: attestation.getSender()?.toString(),
1080
+ count,
889
1081
  });
1082
+ return { result: TopicValidatorResult.Ignore, obj: attestation };
1083
+ }
890
1084
 
891
- if (!isValid) {
892
- return { result: TopicValidatorResult.Reject };
893
- } else if (exists) {
894
- return { result: TopicValidatorResult.Ignore, obj: block };
895
- } else if (!canAdd) {
896
- this.peerManager.penalizePeer(source, PeerErrorSeverity.MidToleranceError);
897
- this.logger.warn(`Penalizing peer for block proposal exceeding per-slot cap`, {
898
- slot: block.slotNumber.toString(),
899
- archive: block.archive.toString(),
900
- source: source.toString(),
1085
+ // Check if this is a duplicate attestation (signer attested to a different proposal at the same slot)
1086
+ // count is the number of attestations by this signer for this slot
1087
+ if (count === 2) {
1088
+ const attester = attestation.getSender();
1089
+ if (attester) {
1090
+ this.logger.warn(`Detected duplicate attestation (equivocation) at slot ${slot}`, {
1091
+ slot: slot.toString(),
1092
+ archive: attestation.archive.toString(),
1093
+ source: peerId.toString(),
1094
+ attester: attester.toString(),
901
1095
  });
902
- return { result: TopicValidatorResult.Reject };
903
- } else {
904
- return { result: TopicValidatorResult.Accept, obj: block };
1096
+ this.duplicateAttestationCallback?.({ slot, attester });
905
1097
  }
906
- };
1098
+ }
1099
+
1100
+ // Attestation was added successfully - accept it so other nodes can also detect the equivocation
1101
+ return { result: TopicValidatorResult.Accept, obj: attestation };
1102
+ }
907
1103
 
908
- const { result, obj: block } = await this.validateReceivedMessage<BlockProposal>(
909
- validationFunc,
1104
+ protected async processBlockFromPeer(payloadData: Buffer, msgId: string, source: PeerId): Promise<void> {
1105
+ const {
1106
+ result,
1107
+ obj: block,
1108
+ metadata: { isEquivocated } = {},
1109
+ } = await this.validateReceivedMessage<BlockProposal, { isEquivocated: boolean }>(
1110
+ () => this.validateAndStoreBlockProposal(source, BlockProposal.fromBuffer(payloadData)),
910
1111
  msgId,
911
1112
  source,
912
1113
  TopicType.block_proposal,
913
1114
  );
914
1115
 
915
- if (!result || !block) {
1116
+ // If not accepted or equivocated, return
1117
+ if (result !== TopicValidatorResult.Accept || !block || isEquivocated) {
916
1118
  return;
917
1119
  }
918
1120
 
919
1121
  await this.processValidBlockProposal(block, source);
920
1122
  }
921
1123
 
922
- // REVIEW: callback pattern https://github.com/AztecProtocol/aztec-packages/issues/7963
1124
+ /** Validates a block proposal. Triggers a penalization to the peer that sent it if invalid. Adds to the mempool if valid. */
1125
+ @trackSpan('Libp2pService.validateAndStoreBlockProposal', (_peerId, block) => ({
1126
+ [Attributes.BLOCK_NUMBER]: block.blockNumber.toString(),
1127
+ [Attributes.SLOT_NUMBER]: block.slotNumber.toString(),
1128
+ }))
1129
+ protected async validateAndStoreBlockProposal(
1130
+ peerId: PeerId,
1131
+ block: BlockProposal,
1132
+ ): Promise<ReceivedMessageValidationResult<BlockProposal, { isEquivocated: boolean }>> {
1133
+ const validationResult = await this.blockProposalValidator.validate(block);
1134
+
1135
+ if (validationResult.result === 'reject') {
1136
+ this.logger.warn(`Penalizing peer ${peerId} for block proposal validation failure`);
1137
+ this.peerManager.penalizePeer(peerId, validationResult.severity);
1138
+ return { result: TopicValidatorResult.Reject };
1139
+ }
1140
+
1141
+ if (validationResult.result === 'ignore') {
1142
+ return { result: TopicValidatorResult.Ignore, obj: block };
1143
+ }
1144
+
1145
+ // Try to add the proposal: this handles existence check, cap check, and adding in one call
1146
+ const { added, alreadyExists, count } = await this.mempools.attestationPool.tryAddBlockProposal(block);
1147
+ const isEquivocated = count !== undefined && count > 1;
1148
+
1149
+ // Duplicate proposal received, no need to re-broadcast
1150
+ if (alreadyExists) {
1151
+ this.logger.debug(`Ignoring duplicate block proposal received`, {
1152
+ ...block.toBlockInfo(),
1153
+ indexWithinCheckpoint: block.indexWithinCheckpoint,
1154
+ proposer: block.getSender()?.toString(),
1155
+ source: peerId.toString(),
1156
+ });
1157
+ return { result: TopicValidatorResult.Ignore, obj: block, metadata: { isEquivocated } };
1158
+ }
1159
+
1160
+ // Too many blocks received for this slot and index, penalize peer and do not re-broadcast
1161
+ if (!added) {
1162
+ this.peerManager.penalizePeer(peerId, PeerErrorSeverity.HighToleranceError);
1163
+ this.logger.warn(`Penalizing peer for block proposal exceeding per-position cap`, {
1164
+ ...block.toBlockInfo(),
1165
+ indexWithinCheckpoint: block.indexWithinCheckpoint,
1166
+ count,
1167
+ proposer: block.getSender()?.toString(),
1168
+ source: peerId.toString(),
1169
+ });
1170
+ return { result: TopicValidatorResult.Reject, metadata: { isEquivocated } };
1171
+ }
1172
+
1173
+ // If this was a duplicate proposal, do not process it, but do invoke the duplicate callback,
1174
+ // and do re-broadcast it so other nodes in the network know to slash the proposer
1175
+ if (isEquivocated) {
1176
+ const proposer = block.getSender();
1177
+ this.logger.warn(`Detected duplicate block proposal (equivocation) at slot ${block.slotNumber}`, {
1178
+ ...block.toBlockInfo(),
1179
+ source: peerId.toString(),
1180
+ proposer: proposer?.toString(),
1181
+ });
1182
+ // Invoke the duplicate callback on the first duplicate spotted only
1183
+ if (proposer && count === 2) {
1184
+ this.duplicateProposalCallback?.({ slot: block.slotNumber, proposer, type: 'block' });
1185
+ }
1186
+ return { result: TopicValidatorResult.Accept, obj: block, metadata: { isEquivocated } };
1187
+ }
1188
+
1189
+ // Otherwise, we're good to go!
1190
+ return { result: TopicValidatorResult.Accept, obj: block };
1191
+ }
1192
+
1193
+ // REFACTOR(palla): This method should be moved to the p2p_client or to a separate component,
1194
+ // should not be here as it does not deal with p2p networking.
923
1195
  @trackSpan('Libp2pService.processValidBlockProposal', async block => ({
924
1196
  [Attributes.SLOT_NUMBER]: block.slotNumber,
925
1197
  [Attributes.BLOCK_ARCHIVE]: block.archive.toString(),
926
1198
  [Attributes.P2P_ID]: await block.p2pMessageLoggingIdentifier().then(i => i.toString()),
927
1199
  }))
928
- private async processValidBlockProposal(block: BlockProposal, sender: PeerId) {
1200
+ protected async processValidBlockProposal(block: BlockProposal, sender: PeerId) {
929
1201
  const slot = block.slotNumber;
930
- const previousSlot = SlotNumber(slot - 1);
931
1202
  this.logger.verbose(`Received block proposal for slot ${slot} from external peer ${sender.toString()}.`, {
932
1203
  p2pMessageIdentifier: await block.p2pMessageLoggingIdentifier(),
933
- slot: block.slotNumber,
934
- archive: block.archive.toString(),
935
1204
  source: sender.toString(),
1205
+ ...block.toBlockInfo(),
936
1206
  });
937
- const attestationsForPreviousSlot = await this.mempools.attestationPool?.getAttestationsForSlot(previousSlot);
938
- if (attestationsForPreviousSlot !== undefined) {
939
- this.logger.verbose(`Received ${attestationsForPreviousSlot.length} attestations for slot ${previousSlot}`);
1207
+
1208
+ // Mark the txs in this proposal as protected
1209
+ await this.mempools.txPool.protectTxs(block.txHashes, block.blockHeader);
1210
+
1211
+ // Call the block received callback to validate the proposal.
1212
+ // Note: Validators do NOT attest to individual blocks, only to checkpoint proposals.
1213
+ const isValid = await this.blockReceivedCallback(block, sender);
1214
+ if (!isValid) {
1215
+ this.logger.info(`Block proposal validation failed for block ${block.blockNumber}`, block.toBlockInfo());
940
1216
  }
1217
+ }
941
1218
 
942
- // Attempt to add proposal, then mark the txs in this proposal as non-evictable
943
- try {
944
- await this.mempools.attestationPool?.addBlockProposal(block);
945
- } catch (err: unknown) {
946
- // Drop proposals if we hit per-slot cap in the attestation pool; rethrow unknown errors
947
- if (err instanceof ProposalSlotCapExceededError) {
948
- this.logger.warn(`Dropping block proposal due to per-slot proposal cap`, {
949
- slot: String(slot),
950
- archive: block.archive.toString(),
951
- error: (err as Error).message,
1219
+ /**
1220
+ * Handle a gossiped checkpoint proposal.
1221
+ * Validates and processes the checkpoint proposal, then triggers the callback for attestation.
1222
+ */
1223
+ protected async handleGossipedCheckpointProposal(payloadData: Buffer, msgId: string, source: PeerId): Promise<void> {
1224
+ const {
1225
+ result,
1226
+ obj: checkpoint,
1227
+ metadata: { isEquivocated, processBlock } = {},
1228
+ } = await this.validateReceivedMessage<CheckpointProposal, { isEquivocated: boolean; processBlock: boolean }>(
1229
+ () => this.validateAndStoreCheckpointProposal(source, CheckpointProposal.fromBuffer(payloadData)),
1230
+ msgId,
1231
+ source,
1232
+ TopicType.checkpoint_proposal,
1233
+ );
1234
+
1235
+ // If the checkpoint contained a valid last block, we process it even if the checkpoint itself is to be rejected
1236
+ // TODO(palla/mbps): Is this ok? Should we be considering a block from a checkpoint that was equivocated?
1237
+ if (processBlock && checkpoint?.getBlockProposal()) {
1238
+ await this.processValidBlockProposal(checkpoint.getBlockProposal()!, source);
1239
+ }
1240
+
1241
+ if (result !== TopicValidatorResult.Accept || !checkpoint || isEquivocated) {
1242
+ return;
1243
+ }
1244
+
1245
+ await this.processValidCheckpointProposal(checkpoint.toCore(), source);
1246
+ }
1247
+
1248
+ /**
1249
+ * Validates a checkpoint proposal. Penalizes peer if validation fails. Adds the checkpoint and
1250
+ * its last block (if present) to the mempool if valid. Triggers equivocation detection on both.
1251
+ */
1252
+ @trackSpan('Libp2pService.validateAndStoreCheckpointProposal', (_peerId, checkpoint) => ({
1253
+ [Attributes.SLOT_NUMBER]: checkpoint.slotNumber.toString(),
1254
+ }))
1255
+ protected async validateAndStoreCheckpointProposal(
1256
+ peerId: PeerId,
1257
+ checkpoint: CheckpointProposal,
1258
+ ): Promise<ReceivedMessageValidationResult<CheckpointProposal, { isEquivocated: boolean; processBlock: boolean }>> {
1259
+ const validationResult = await this.checkpointProposalValidator.validate(checkpoint);
1260
+
1261
+ if (validationResult.result === 'reject') {
1262
+ this.logger.warn(`Penalizing peer ${peerId} for checkpoint proposal validation failure`);
1263
+ this.peerManager.penalizePeer(peerId, validationResult.severity);
1264
+ return { result: TopicValidatorResult.Reject };
1265
+ }
1266
+
1267
+ if (validationResult.result === 'ignore') {
1268
+ return { result: TopicValidatorResult.Ignore, obj: checkpoint };
1269
+ }
1270
+
1271
+ // Extract and try to add the block proposal first if present
1272
+ const blockProposal = checkpoint.getBlockProposal();
1273
+ let processBlock = false;
1274
+ if (blockProposal) {
1275
+ this.logger.debug(`Validating block proposal from propagated checkpoint`, {
1276
+ [Attributes.SLOT_NUMBER]: checkpoint.slotNumber.toString(),
1277
+ [Attributes.P2P_ID]: peerId.toString(),
1278
+ });
1279
+ const {
1280
+ result,
1281
+ obj,
1282
+ metadata: { isEquivocated } = {},
1283
+ } = await this.validateAndStoreBlockProposal(peerId, blockProposal);
1284
+ if (result === TopicValidatorResult.Reject || !obj || isEquivocated) {
1285
+ this.logger.debug(`Rejecting checkpoint due to invalid last block proposal`, {
1286
+ [Attributes.SLOT_NUMBER]: checkpoint.slotNumber.toString(),
1287
+ [Attributes.P2P_ID]: peerId.toString(),
1288
+ isEquivocated,
1289
+ result,
952
1290
  });
953
- return;
1291
+ return { result: TopicValidatorResult.Reject };
1292
+ } else if (result === TopicValidatorResult.Accept && obj && !isEquivocated) {
1293
+ processBlock = true;
954
1294
  }
955
- throw err;
956
1295
  }
957
- await this.mempools.txPool.markTxsAsNonEvictable(block.txHashes);
958
- const attestations = await this.blockReceivedCallback(block, sender);
959
1296
 
960
- // TODO: fix up this pattern - the abstraction is not nice
961
- // The attestation can be undefined if no handler is registered / the validator deems the block invalid / in fisherman mode
962
- if (attestations?.length) {
963
- for (const attestation of attestations) {
964
- this.logger.verbose(`Broadcasting attestation for slot ${attestation.slotNumber}`, {
965
- p2pMessageIdentifier: await attestation.p2pMessageLoggingIdentifier(),
966
- slot: attestation.slotNumber,
967
- archive: attestation.archive.toString(),
968
- });
969
- await this.broadcastAttestation(attestation);
1297
+ // Try to add the checkpoint proposal core: this handles existence check, cap check, and adding in one call
1298
+ const checkpointCore = checkpoint.toCore();
1299
+ const tryAddResult = await this.mempools.attestationPool.tryAddCheckpointProposal(checkpointCore);
1300
+ const { added, alreadyExists, count } = tryAddResult;
1301
+ const isEquivocated = count !== undefined && count > 1;
1302
+
1303
+ // Duplicate proposal received, do not re-broadcast
1304
+ if (alreadyExists) {
1305
+ this.logger.debug(`Ignoring duplicate checkpoint proposal received`, {
1306
+ ...checkpoint.toCheckpointInfo(),
1307
+ source: peerId.toString(),
1308
+ });
1309
+ return {
1310
+ result: TopicValidatorResult.Ignore,
1311
+ obj: checkpoint,
1312
+ metadata: { isEquivocated, processBlock },
1313
+ };
1314
+ }
1315
+
1316
+ // Too many checkpoint proposals received for this slot, penalize peer and do not re-broadcast
1317
+ // Note: We still return the checkpoint obj so the lastBlock can be processed if valid
1318
+ if (!added) {
1319
+ this.peerManager.penalizePeer(peerId, PeerErrorSeverity.HighToleranceError);
1320
+ this.logger.warn(`Penalizing peer for checkpoint proposal exceeding per-slot cap`, {
1321
+ ...checkpoint.toCheckpointInfo(),
1322
+ count,
1323
+ source: peerId.toString(),
1324
+ });
1325
+ return { result: TopicValidatorResult.Reject, obj: checkpoint, metadata: { isEquivocated, processBlock } };
1326
+ }
1327
+
1328
+ // If this was a duplicate proposal, do not process it, but do invoke the duplicate callback,
1329
+ // and do re-broadcast it so other nodes in the network know to slash the proposer
1330
+ if (isEquivocated) {
1331
+ const proposer = checkpoint.getSender();
1332
+ this.logger.warn(`Detected duplicate checkpoint proposal (equivocation) at slot ${checkpoint.slotNumber}`, {
1333
+ ...checkpoint.toCheckpointInfo(),
1334
+ source: peerId.toString(),
1335
+ proposer: proposer?.toString(),
1336
+ });
1337
+ // Invoke the duplicate callback on the first duplicate spotted only
1338
+ if (proposer && count === 2) {
1339
+ this.duplicateProposalCallback?.({ slot: checkpoint.slotNumber, proposer, type: 'checkpoint' });
970
1340
  }
1341
+ return {
1342
+ result: TopicValidatorResult.Accept,
1343
+ obj: checkpoint,
1344
+ metadata: { isEquivocated, processBlock },
1345
+ };
971
1346
  }
1347
+
1348
+ // Otherwise, we're good to go!
1349
+ return { result: TopicValidatorResult.Accept, obj: checkpoint, metadata: { processBlock, isEquivocated } };
972
1350
  }
973
1351
 
974
1352
  /**
975
- * Broadcast an attestation to all peers.
976
- * @param attestation - The attestation to broadcast.
1353
+ * Process a validated checkpoint proposal.
1354
+ * Note: The proposal was already added to the pool by tryAddCheckpointProposal in handleGossipedCheckpointProposal.
977
1355
  */
978
- @trackSpan('Libp2pService.broadcastAttestation', async attestation => ({
979
- [Attributes.SLOT_NUMBER]: attestation.payload.header.slotNumber,
980
- [Attributes.BLOCK_ARCHIVE]: attestation.archive.toString(),
981
- [Attributes.P2P_ID]: await attestation.p2pMessageLoggingIdentifier().then(i => i.toString()),
1356
+ @trackSpan('Libp2pService.processValidCheckpointProposal', async checkpoint => ({
1357
+ [Attributes.SLOT_NUMBER]: checkpoint.slotNumber,
1358
+ [Attributes.BLOCK_ARCHIVE]: checkpoint.archive.toString(),
1359
+ [Attributes.P2P_ID]: await checkpoint.p2pMessageLoggingIdentifier().then(i => i.toString()),
982
1360
  }))
983
- private async broadcastAttestation(attestation: BlockAttestation) {
984
- await this.propagate(attestation);
1361
+ protected async processValidCheckpointProposal(checkpoint: CheckpointProposalCore, sender: PeerId) {
1362
+ const slot = checkpoint.slotNumber;
1363
+ this.logger.verbose(`Received checkpoint proposal for slot ${slot} from external peer ${sender.toString()}.`, {
1364
+ p2pMessageIdentifier: await checkpoint.p2pMessageLoggingIdentifier(),
1365
+ slot: checkpoint.slotNumber,
1366
+ archive: checkpoint.archive.toString(),
1367
+ source: sender.toString(),
1368
+ });
1369
+
1370
+ // Call the checkpoint received callback with the core version (without lastBlock)
1371
+ // to validate and potentially generate attestations
1372
+ const attestations = await this.checkpointReceivedCallback(checkpoint, sender);
1373
+ if (attestations && attestations.length > 0) {
1374
+ // If the callback returned attestations, add them to the pool and propagate them
1375
+ await this.mempools.attestationPool.addOwnCheckpointAttestations(attestations);
1376
+ for (const attestation of attestations) {
1377
+ await this.propagate(attestation);
1378
+ }
1379
+ }
985
1380
  }
986
1381
 
987
1382
  /**
@@ -1004,9 +1399,9 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1004
1399
  * @returns True if the requested block transactions are valid, false otherwise.
1005
1400
  */
1006
1401
  @trackSpan('Libp2pService.validateRequestedBlockTxs', request => ({
1007
- [Attributes.BLOCK_HASH]: request.blockHash.toString(),
1402
+ [Attributes.BLOCK_ARCHIVE]: request.archiveRoot.toString(),
1008
1403
  }))
1009
- private async validateRequestedBlockTxs(
1404
+ protected async validateRequestedBlockTxs(
1010
1405
  request: BlockTxsRequest,
1011
1406
  response: BlockTxsResponse,
1012
1407
  peerId: PeerId,
@@ -1014,10 +1409,10 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1014
1409
  const requestedTxValidator = this.createRequestedTxValidator();
1015
1410
 
1016
1411
  try {
1017
- if (!response.blockHash.equals(request.blockHash)) {
1412
+ if (!response.archiveRoot.equals(request.archiveRoot)) {
1018
1413
  this.peerManager.penalizePeer(peerId, PeerErrorSeverity.MidToleranceError);
1019
1414
  throw new ValidationError(
1020
- `Received block txs for unexpected block: expected ${request.blockHash.toString()}, got ${response.blockHash.toString()}`,
1415
+ `Received block txs for unexpected archive root: expected ${request.archiveRoot.toString()}, got ${response.archiveRoot.toString()}`,
1021
1416
  );
1022
1417
  }
1023
1418
 
@@ -1047,7 +1442,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1047
1442
  }
1048
1443
 
1049
1444
  // Given proposal (should have locally), ensure returned txs are valid subset and match request indices
1050
- const proposal = await this.mempools.attestationPool?.getBlockProposal(request.blockHash.toString());
1445
+ const proposal = await this.mempools.attestationPool.getBlockProposal(request.archiveRoot.toString());
1051
1446
  if (proposal) {
1052
1447
  // Build intersected indices
1053
1448
  const intersectIdx = request.txIndices.getTrueIndices().filter(i => response.txIndices.isSet(i));
@@ -1067,7 +1462,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1067
1462
  } else {
1068
1463
  // No local proposal, cannot check the membership/order of the returned txs
1069
1464
  this.logger.warn(
1070
- `Block proposal not found for block hash ${request.blockHash.toString()}; cannot validate membership/order of returned txs`,
1465
+ `Block proposal not found for archive root ${request.archiveRoot.toString()}; cannot validate membership/order of returned txs`,
1071
1466
  );
1072
1467
  return false;
1073
1468
  }
@@ -1106,7 +1501,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1106
1501
  const requested = new Set(requestedTxHash.map(h => h.toString()));
1107
1502
  const requestedTxValidator = this.createRequestedTxValidator();
1108
1503
 
1109
- //TODO: (mralj) - this is somewhat naive implementation, if single tx is invlid we consider the whole response invalid.
1504
+ //TODO: (mralj) - this is somewhat naive implementation, if single tx is invalid we consider the whole response invalid.
1110
1505
  // I think we should still extract the valid txs and return them, so that we can still use the response.
1111
1506
  try {
1112
1507
  await Promise.all(responseTx.map(tx => this.validateRequestedTx(tx, peerId, requestedTxValidator, requested)));
@@ -1136,7 +1531,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1136
1531
  @trackSpan('Libp2pService.validateRequestedBlock', (requestedBlockNumber, _responseBlock) => ({
1137
1532
  [Attributes.BLOCK_NUMBER]: requestedBlockNumber.toString(),
1138
1533
  }))
1139
- private async validateRequestedBlock(
1534
+ protected async validateRequestedBlock(
1140
1535
  requestedBlockNumber: Fr,
1141
1536
  responseBlock: L2Block,
1142
1537
  peerId: PeerId,
@@ -1148,7 +1543,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1148
1543
  return false;
1149
1544
  }
1150
1545
 
1151
- const local = await this.archiver.getBlock(reqNum);
1546
+ const local = await this.archiver.getBlock(BlockNumber(reqNum));
1152
1547
  if (!local) {
1153
1548
  // We are missing the local block; we cannot verify the hash yet. Reject without penalizing.
1154
1549
  // TODO: Consider extending this validator to accept an expected hash or
@@ -1169,27 +1564,13 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1169
1564
  }
1170
1565
  }
1171
1566
 
1172
- private createRequestedTxValidator(): TxValidator {
1173
- return new AggregateTxValidator(
1174
- new DataTxValidator(),
1175
- new MetadataTxValidator({
1176
- l1ChainId: new Fr(this.config.l1ChainId),
1177
- rollupVersion: new Fr(this.config.rollupVersion),
1178
- protocolContractsHash,
1179
- vkTreeRoot: getVKTreeRoot(),
1180
- }),
1181
- new TxProofValidator(this.proofVerifier),
1182
- );
1183
- }
1184
-
1185
- private async validateRequestedTx(tx: Tx, peerId: PeerId, txValidator: TxValidator, requested?: Set<`0x${string}`>) {
1567
+ protected async validateRequestedTx(
1568
+ tx: Tx,
1569
+ peerId: PeerId,
1570
+ txValidator: TxValidator,
1571
+ requested?: Set<`0x${string}`>,
1572
+ ) {
1186
1573
  const penalize = (severity: PeerErrorSeverity) => this.peerManager.penalizePeer(peerId, severity);
1187
-
1188
- if (!(await tx.validateTxHash())) {
1189
- penalize(PeerErrorSeverity.MidToleranceError);
1190
- throw new ValidationError(`Received tx with invalid hash ${tx.getTxHash().toString()}.`);
1191
- }
1192
-
1193
1574
  if (requested && !requested.has(tx.getTxHash().toString())) {
1194
1575
  penalize(PeerErrorSeverity.MidToleranceError);
1195
1576
  throw new ValidationError(`Received tx with hash ${tx.getTxHash().toString()} that was not requested.`);
@@ -1202,38 +1583,14 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1202
1583
  }
1203
1584
  }
1204
1585
 
1205
- @trackSpan('Libp2pService.validatePropagatedTx', tx => ({
1206
- [Attributes.TX_HASH]: tx.getTxHash().toString(),
1207
- }))
1208
- private async validatePropagatedTx(tx: Tx, peerId: PeerId): Promise<boolean> {
1209
- const currentBlockNumber = await this.archiver.getBlockNumber();
1210
-
1211
- // We accept transactions if they are not expired by the next slot (checked based on the IncludeByTimestamp field)
1212
- const { ts: nextSlotTimestamp } = this.epochCache.getEpochAndSlotInNextL1Slot();
1213
- const messageValidators = await this.createMessageValidators(currentBlockNumber, nextSlotTimestamp);
1214
-
1215
- for (const validator of messageValidators) {
1216
- const outcome = await this.runValidations(tx, validator);
1217
-
1218
- if (outcome.allPassed) {
1219
- continue;
1220
- }
1221
- const { name } = outcome.failure;
1222
- let { severity } = outcome.failure;
1223
-
1224
- // Double spend validator has a special case handler
1225
- if (name === 'doubleSpendValidator') {
1226
- const txBlockNumber = currentBlockNumber + 1; // tx is expected to be in the next block
1227
- severity = await this.handleDoubleSpendFailure(tx, txBlockNumber);
1228
- }
1229
-
1230
- this.peerManager.penalizePeer(peerId, severity);
1231
- return false;
1232
- }
1233
- return true;
1586
+ protected createRequestedTxValidator(): TxValidator {
1587
+ return createTxValidatorForReqResponseReceivedTxs(this.proofVerifier, {
1588
+ l1ChainId: this.config.l1ChainId,
1589
+ rollupVersion: this.config.rollupVersion,
1590
+ });
1234
1591
  }
1235
1592
 
1236
- private async getGasFees(blockNumber: number): Promise<GasFees> {
1593
+ private async getGasFees(blockNumber: BlockNumber): Promise<GasFees> {
1237
1594
  if (blockNumber === this.feesCache?.blockNumber) {
1238
1595
  return this.feesCache.gasFees;
1239
1596
  }
@@ -1244,59 +1601,78 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1244
1601
  return gasFees;
1245
1602
  }
1246
1603
 
1247
- public async validate(txs: Tx[]): Promise<void> {
1248
- const currentBlockNumber = await this.archiver.getBlockNumber();
1604
+ /**
1605
+ * Get the BatchTxRequesterLibP2PService dependencies for creating BatchTxRequester instances
1606
+ */
1607
+ public getBatchTxRequesterService(): BatchTxRequesterLibP2PService {
1608
+ return {
1609
+ reqResp: this.reqresp,
1610
+ connectionSampler: this.reqresp.getConnectionSampler(),
1611
+ txValidatorConfig: {
1612
+ l1ChainId: this.config.l1ChainId,
1613
+ rollupVersion: this.config.rollupVersion,
1614
+ proofVerifier: this.proofVerifier,
1615
+ },
1616
+ peerScoring: this.peerManager,
1617
+ };
1618
+ }
1249
1619
 
1250
- // We accept transactions if they are not expired by the next slot (checked based on the IncludeByTimestamp field)
1251
- const { ts: nextSlotTimestamp } = this.epochCache.getEpochAndSlotInNextL1Slot();
1252
- const messageValidators = await this.createMessageValidators(currentBlockNumber, nextSlotTimestamp);
1620
+ public async validateTxsReceivedInBlockProposal(txs: Tx[]): Promise<void> {
1621
+ const validator = createTxValidatorForBlockProposalReceivedTxs(
1622
+ this.proofVerifier,
1623
+ { l1ChainId: this.config.l1ChainId, rollupVersion: this.config.rollupVersion },
1624
+ this.logger.getBindings(),
1625
+ );
1253
1626
 
1254
- await Promise.all(
1627
+ const results = await Promise.all(
1255
1628
  txs.map(async tx => {
1256
- for (const validator of messageValidators) {
1257
- const outcome = await this.runValidations(tx, validator);
1258
- if (!outcome.allPassed) {
1259
- throw new Error('Invalid tx detected', { cause: { outcome } });
1260
- }
1261
- }
1629
+ const result = await validator.validateTx(tx);
1630
+ return result.result !== 'invalid';
1262
1631
  }),
1263
1632
  );
1633
+ if (results.some(value => value === false)) {
1634
+ throw new Error('Invalid tx detected');
1635
+ }
1264
1636
  }
1265
1637
 
1266
- /**
1267
- * Create message validators for the given block number and timestamp.
1268
- *
1269
- * Each validator is a pair of a validator and a severity.
1270
- * If a validator fails, the peer is penalized with the severity of the validator.
1271
- *
1272
- * @param currentBlockNumber - The current synced block number.
1273
- * @param nextSlotTimestamp - The timestamp of the next slot (used to validate txs are not expired).
1274
- * @returns The message validators.
1275
- */
1276
- private async createMessageValidators(
1277
- currentBlockNumber: number,
1638
+ /** Creates the first stage (fast) validators for gossiped transactions. */
1639
+ protected async createFirstStageMessageValidators(
1640
+ currentBlockNumber: BlockNumber,
1278
1641
  nextSlotTimestamp: UInt64,
1279
- ): Promise<Record<string, MessageValidator>[]> {
1642
+ ): Promise<Record<string, TransactionValidator>> {
1280
1643
  const gasFees = await this.getGasFees(currentBlockNumber);
1281
- const allowedInSetup = this.config.txPublicSetupAllowList ?? (await getDefaultAllowedSetupFunctions());
1282
-
1283
- const blockNumberInWhichTheTxIsConsideredToBeIncluded = currentBlockNumber + 1;
1284
-
1285
- return createTxMessageValidators(
1644
+ const allowedInSetup = [
1645
+ ...(await getDefaultAllowedSetupFunctions()),
1646
+ ...(this.config.txPublicSetupAllowListExtend ?? []),
1647
+ ];
1648
+ const blockNumber = BlockNumber(currentBlockNumber + 1);
1649
+ const l1Constants = await this.archiver.getL1Constants();
1650
+
1651
+ return createFirstStageTxValidationsForGossipedTransactions(
1286
1652
  nextSlotTimestamp,
1287
- blockNumberInWhichTheTxIsConsideredToBeIncluded,
1653
+ blockNumber,
1288
1654
  this.worldStateSynchronizer,
1289
1655
  gasFees,
1290
1656
  this.config.l1ChainId,
1291
1657
  this.config.rollupVersion,
1292
1658
  protocolContractsHash,
1293
1659
  this.archiver,
1294
- this.proofVerifier,
1295
1660
  !this.config.disableTransactions,
1296
1661
  allowedInSetup,
1662
+ this.logger.getBindings(),
1663
+ {
1664
+ rollupManaLimit: l1Constants.rollupManaLimit,
1665
+ maxBlockL2Gas: this.config.validateMaxL2BlockGas,
1666
+ maxBlockDAGas: this.config.validateMaxDABlockGas,
1667
+ },
1297
1668
  );
1298
1669
  }
1299
1670
 
1671
+ /** Creates the second stage (expensive proof verification) validators for gossiped transactions. */
1672
+ protected createSecondStageMessageValidators(): Record<string, TransactionValidator> {
1673
+ return createSecondStageTxValidationsForGossipedTransactions(this.proofVerifier, this.logger.getBindings());
1674
+ }
1675
+
1300
1676
  /**
1301
1677
  * Run validations on a tx.
1302
1678
  * @param tx - The tx to validate.
@@ -1305,7 +1681,7 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1305
1681
  */
1306
1682
  private async runValidations(
1307
1683
  tx: Tx,
1308
- messageValidators: Record<string, MessageValidator>,
1684
+ messageValidators: Record<string, TransactionValidator>,
1309
1685
  ): Promise<ValidationOutcome> {
1310
1686
  const validationPromises = Object.entries(messageValidators).map(async ([name, { validator, severity }]) => {
1311
1687
  const { result } = await validator.validateTx(tx);
@@ -1314,8 +1690,10 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1314
1690
 
1315
1691
  // A promise that resolves when all validations have been run
1316
1692
  const allValidations = await Promise.all(validationPromises);
1317
- const failed = allValidations.find(x => !x.isValid);
1318
- if (failed) {
1693
+ const failures = allValidations.filter(x => !x.isValid);
1694
+ if (failures.length > 0) {
1695
+ // Pick the most severe failure (lowest tolerance = harshest penalty)
1696
+ const failed = maxBy(failures, f => PeerErrorSeverityByHarshness.indexOf(f.severity))!;
1319
1697
  return {
1320
1698
  allPassed: false,
1321
1699
  failure: {
@@ -1342,20 +1720,23 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1342
1720
  * @param peerId - The peer ID of the peer that sent the tx.
1343
1721
  * @returns Severity
1344
1722
  */
1345
- private async handleDoubleSpendFailure(tx: Tx, blockNumber: number): Promise<PeerErrorSeverity> {
1723
+ private async handleDoubleSpendFailure(tx: Tx, blockNumber: BlockNumber): Promise<PeerErrorSeverity> {
1346
1724
  if (blockNumber <= this.config.doubleSpendSeverePeerPenaltyWindow) {
1347
1725
  return PeerErrorSeverity.HighToleranceError;
1348
1726
  }
1349
1727
 
1350
- const snapshotValidator = new DoubleSpendTxValidator({
1351
- nullifiersExist: async (nullifiers: Buffer[]) => {
1352
- const merkleTree = this.worldStateSynchronizer.getSnapshot(
1353
- blockNumber - this.config.doubleSpendSeverePeerPenaltyWindow,
1354
- );
1355
- const indices = await merkleTree.findLeafIndices(MerkleTreeId.NULLIFIER_TREE, nullifiers);
1356
- return indices.map(index => index !== undefined);
1728
+ const snapshotValidator = new DoubleSpendTxValidator(
1729
+ {
1730
+ nullifiersExist: async (nullifiers: Buffer[]) => {
1731
+ const merkleTree = this.worldStateSynchronizer.getSnapshot(
1732
+ BlockNumber(blockNumber - this.config.doubleSpendSeverePeerPenaltyWindow),
1733
+ );
1734
+ const indices = await merkleTree.findLeafIndices(MerkleTreeId.NULLIFIER_TREE, nullifiers);
1735
+ return indices.map(index => index !== undefined);
1736
+ },
1357
1737
  },
1358
- });
1738
+ this.logger.getBindings(),
1739
+ );
1359
1740
 
1360
1741
  const validSnapshot = await snapshotValidator.validateTx(tx);
1361
1742
  if (validSnapshot.result !== 'valid') {
@@ -1365,47 +1746,6 @@ export class LibP2PService<T extends P2PClientType = P2PClientType.Full> extends
1365
1746
  return PeerErrorSeverity.HighToleranceError;
1366
1747
  }
1367
1748
 
1368
- /**
1369
- * Validate an attestation.
1370
- *
1371
- * @param attestation - The attestation to validate.
1372
- * @returns True if the attestation is valid, false otherwise.
1373
- */
1374
- @trackSpan('Libp2pService.validateAttestation', async (_, attestation) => ({
1375
- [Attributes.SLOT_NUMBER]: attestation.payload.header.slotNumber,
1376
- [Attributes.BLOCK_ARCHIVE]: attestation.archive.toString(),
1377
- [Attributes.P2P_ID]: await attestation.p2pMessageLoggingIdentifier().then(i => i.toString()),
1378
- }))
1379
- public async validateAttestation(peerId: PeerId, attestation: BlockAttestation): Promise<boolean> {
1380
- const severity = await this.attestationValidator.validate(attestation);
1381
- if (severity) {
1382
- this.peerManager.penalizePeer(peerId, severity);
1383
- return false;
1384
- }
1385
-
1386
- return true;
1387
- }
1388
-
1389
- /**
1390
- * Validate a block proposal.
1391
- *
1392
- * @param block - The block proposal to validate.
1393
- * @returns True if the block proposal is valid, false otherwise.
1394
- */
1395
- @trackSpan('Libp2pService.validateBlockProposal', (_peerId, block) => ({
1396
- [Attributes.SLOT_NUMBER]: block.payload.header.slotNumber.toString(),
1397
- }))
1398
- public async validateBlockProposal(peerId: PeerId, block: BlockProposal): Promise<boolean> {
1399
- const severity = await this.blockProposalValidator.validate(block);
1400
- if (severity) {
1401
- this.logger.debug(`Penalizing peer ${peerId} for block proposal validation failure`);
1402
- this.peerManager.penalizePeer(peerId, severity);
1403
- return false;
1404
- }
1405
-
1406
- return true;
1407
- }
1408
-
1409
1749
  public getPeerScore(peerId: PeerId): number {
1410
1750
  return this.node.services.pubsub.score.score(peerId.toString());
1411
1751
  }