@aztec/p2p 0.0.1-commit.9593d84 → 0.0.1-commit.967fc6998

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