@aztec/p2p 0.0.1-commit.5476d83 → 0.0.1-commit.5914bae

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