@aztec/p2p 0.0.1-commit.96bb3f7 → 0.0.1-commit.993d240

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (573) hide show
  1. package/README.md +129 -3
  2. package/dest/bootstrap/bootstrap.d.ts +4 -3
  3. package/dest/bootstrap/bootstrap.d.ts.map +1 -1
  4. package/dest/bootstrap/bootstrap.js +13 -5
  5. package/dest/client/factory.d.ts +13 -12
  6. package/dest/client/factory.d.ts.map +1 -1
  7. package/dest/client/factory.js +65 -20
  8. package/dest/client/interface.d.ts +58 -36
  9. package/dest/client/interface.d.ts.map +1 -1
  10. package/dest/client/p2p_client.d.ts +52 -58
  11. package/dest/client/p2p_client.d.ts.map +1 -1
  12. package/dest/client/p2p_client.js +236 -236
  13. package/dest/config.d.ts +163 -84
  14. package/dest/config.d.ts.map +1 -1
  15. package/dest/config.js +156 -43
  16. package/dest/errors/p2p-service.error.d.ts +9 -0
  17. package/dest/errors/p2p-service.error.d.ts.map +1 -0
  18. package/dest/errors/p2p-service.error.js +10 -0
  19. package/dest/errors/reqresp.error.d.ts +1 -20
  20. package/dest/errors/reqresp.error.d.ts.map +1 -1
  21. package/dest/errors/reqresp.error.js +0 -21
  22. package/dest/errors/tx-pool.error.d.ts +8 -0
  23. package/dest/errors/tx-pool.error.d.ts.map +1 -0
  24. package/dest/errors/tx-pool.error.js +9 -0
  25. package/dest/index.d.ts +2 -2
  26. package/dest/index.d.ts.map +1 -1
  27. package/dest/index.js +1 -1
  28. package/dest/mem_pools/attestation_pool/attestation_pool.d.ts +162 -106
  29. package/dest/mem_pools/attestation_pool/attestation_pool.d.ts.map +1 -1
  30. package/dest/mem_pools/attestation_pool/attestation_pool.js +511 -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 +525 -132
  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 +4 -2
  38. package/dest/mem_pools/attestation_pool/mocks.d.ts.map +1 -1
  39. package/dest/mem_pools/attestation_pool/mocks.js +13 -8
  40. package/dest/mem_pools/index.d.ts +3 -3
  41. package/dest/mem_pools/index.d.ts.map +1 -1
  42. package/dest/mem_pools/index.js +1 -1
  43. package/dest/mem_pools/instrumentation.d.ts +4 -2
  44. package/dest/mem_pools/instrumentation.d.ts.map +1 -1
  45. package/dest/mem_pools/instrumentation.js +35 -17
  46. package/dest/mem_pools/interface.d.ts +5 -5
  47. package/dest/mem_pools/interface.d.ts.map +1 -1
  48. package/dest/mem_pools/tx_pool_v2/archive/index.d.ts +2 -0
  49. package/dest/mem_pools/tx_pool_v2/archive/index.d.ts.map +1 -0
  50. package/dest/mem_pools/tx_pool_v2/archive/index.js +1 -0
  51. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.d.ts +43 -0
  52. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.d.ts.map +1 -0
  53. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.js +103 -0
  54. package/dest/mem_pools/tx_pool_v2/deleted_pool.d.ts +104 -0
  55. package/dest/mem_pools/tx_pool_v2/deleted_pool.d.ts.map +1 -0
  56. package/dest/mem_pools/tx_pool_v2/deleted_pool.js +251 -0
  57. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.d.ts +47 -0
  58. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.d.ts.map +1 -0
  59. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.js +128 -0
  60. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.d.ts +17 -0
  61. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.d.ts.map +1 -0
  62. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.js +94 -0
  63. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.d.ts +19 -0
  64. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.d.ts.map +1 -0
  65. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.js +97 -0
  66. package/dest/mem_pools/tx_pool_v2/eviction/index.d.ts +11 -0
  67. package/dest/mem_pools/tx_pool_v2/eviction/index.d.ts.map +1 -0
  68. package/dest/mem_pools/tx_pool_v2/eviction/index.js +12 -0
  69. package/dest/mem_pools/tx_pool_v2/eviction/insufficient_fee_per_gas_eviction_rule.d.ts +16 -0
  70. package/dest/mem_pools/tx_pool_v2/eviction/insufficient_fee_per_gas_eviction_rule.d.ts.map +1 -0
  71. package/dest/mem_pools/tx_pool_v2/eviction/insufficient_fee_per_gas_eviction_rule.js +62 -0
  72. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.d.ts +180 -0
  73. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.d.ts.map +1 -0
  74. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.js +25 -0
  75. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.d.ts +15 -0
  76. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.d.ts.map +1 -0
  77. package/dest/mem_pools/{tx_pool → tx_pool_v2}/eviction/invalid_txs_after_mining_rule.js +16 -35
  78. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.d.ts +17 -0
  79. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.d.ts.map +1 -0
  80. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.js +93 -0
  81. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.d.ts +16 -0
  82. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.d.ts.map +1 -0
  83. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.js +78 -0
  84. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.d.ts +20 -0
  85. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.d.ts.map +1 -0
  86. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.js +75 -0
  87. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.d.ts +15 -0
  88. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.d.ts.map +1 -0
  89. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.js +19 -0
  90. package/dest/mem_pools/tx_pool_v2/index.d.ts +6 -0
  91. package/dest/mem_pools/tx_pool_v2/index.d.ts.map +1 -0
  92. package/dest/mem_pools/tx_pool_v2/index.js +5 -0
  93. package/dest/mem_pools/tx_pool_v2/instrumentation.d.ts +15 -0
  94. package/dest/mem_pools/tx_pool_v2/instrumentation.d.ts.map +1 -0
  95. package/dest/mem_pools/tx_pool_v2/instrumentation.js +43 -0
  96. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts +218 -0
  97. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts.map +1 -0
  98. package/dest/mem_pools/tx_pool_v2/interfaces.js +10 -0
  99. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts +137 -0
  100. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts.map +1 -0
  101. package/dest/mem_pools/tx_pool_v2/tx_metadata.js +223 -0
  102. package/dest/mem_pools/tx_pool_v2/tx_pool_bench_metrics.d.ts +26 -0
  103. package/dest/mem_pools/tx_pool_v2/tx_pool_bench_metrics.d.ts.map +1 -0
  104. package/dest/mem_pools/tx_pool_v2/tx_pool_bench_metrics.js +70 -0
  105. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.d.ts +108 -0
  106. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.d.ts.map +1 -0
  107. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.js +337 -0
  108. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts +62 -0
  109. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts.map +1 -0
  110. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.js +167 -0
  111. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts +78 -0
  112. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts.map +1 -0
  113. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.js +914 -0
  114. package/dest/msg_validators/attestation_validator/attestation_validator.d.ts +10 -4
  115. package/dest/msg_validators/attestation_validator/attestation_validator.d.ts.map +1 -1
  116. package/dest/msg_validators/attestation_validator/attestation_validator.js +69 -13
  117. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts +9 -5
  118. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts.map +1 -1
  119. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.js +22 -11
  120. package/dest/msg_validators/clock_tolerance.d.ts +32 -0
  121. package/dest/msg_validators/clock_tolerance.d.ts.map +1 -0
  122. package/dest/msg_validators/clock_tolerance.js +95 -0
  123. package/dest/msg_validators/proposal_validator/block_proposal_validator.d.ts +10 -4
  124. package/dest/msg_validators/proposal_validator/block_proposal_validator.d.ts.map +1 -1
  125. package/dest/msg_validators/proposal_validator/block_proposal_validator.js +10 -2
  126. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.d.ts +10 -4
  127. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.d.ts.map +1 -1
  128. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.js +16 -2
  129. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts +21 -8
  130. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts.map +1 -1
  131. package/dest/msg_validators/proposal_validator/proposal_validator.js +123 -53
  132. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts +4 -4
  133. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts.map +1 -1
  134. package/dest/msg_validators/tx_validator/aggregate_tx_validator.js +11 -18
  135. package/dest/msg_validators/tx_validator/allowed_public_setup.d.ts +2 -1
  136. package/dest/msg_validators/tx_validator/allowed_public_setup.d.ts.map +1 -1
  137. package/dest/msg_validators/tx_validator/allowed_public_setup.js +25 -21
  138. package/dest/msg_validators/tx_validator/allowed_setup_helpers.d.ts +17 -0
  139. package/dest/msg_validators/tx_validator/allowed_setup_helpers.d.ts.map +1 -0
  140. package/dest/msg_validators/tx_validator/allowed_setup_helpers.js +24 -0
  141. package/dest/msg_validators/tx_validator/archive_cache.d.ts +3 -3
  142. package/dest/msg_validators/tx_validator/archive_cache.d.ts.map +1 -1
  143. package/dest/msg_validators/tx_validator/block_header_validator.d.ts +20 -6
  144. package/dest/msg_validators/tx_validator/block_header_validator.d.ts.map +1 -1
  145. package/dest/msg_validators/tx_validator/block_header_validator.js +4 -3
  146. package/dest/msg_validators/tx_validator/cached_tx_validator.d.ts +15 -0
  147. package/dest/msg_validators/tx_validator/cached_tx_validator.d.ts.map +1 -0
  148. package/dest/msg_validators/tx_validator/cached_tx_validator.js +19 -0
  149. package/dest/msg_validators/tx_validator/contract_instance_validator.d.ts +9 -0
  150. package/dest/msg_validators/tx_validator/contract_instance_validator.d.ts.map +1 -0
  151. package/dest/msg_validators/tx_validator/contract_instance_validator.js +48 -0
  152. package/dest/msg_validators/tx_validator/data_validator.d.ts +4 -1
  153. package/dest/msg_validators/tx_validator/data_validator.d.ts.map +1 -1
  154. package/dest/msg_validators/tx_validator/data_validator.js +40 -3
  155. package/dest/msg_validators/tx_validator/double_spend_validator.d.ts +15 -4
  156. package/dest/msg_validators/tx_validator/double_spend_validator.d.ts.map +1 -1
  157. package/dest/msg_validators/tx_validator/double_spend_validator.js +7 -6
  158. package/dest/msg_validators/tx_validator/factory.d.ts +138 -5
  159. package/dest/msg_validators/tx_validator/factory.d.ts.map +1 -1
  160. package/dest/msg_validators/tx_validator/factory.js +259 -58
  161. package/dest/msg_validators/tx_validator/fee_payer_balance.d.ts +10 -0
  162. package/dest/msg_validators/tx_validator/fee_payer_balance.d.ts.map +1 -0
  163. package/dest/msg_validators/tx_validator/fee_payer_balance.js +24 -0
  164. package/dest/msg_validators/tx_validator/gas_validator.d.ts +100 -3
  165. package/dest/msg_validators/tx_validator/gas_validator.d.ts.map +1 -1
  166. package/dest/msg_validators/tx_validator/gas_validator.js +146 -67
  167. package/dest/msg_validators/tx_validator/index.d.ts +6 -1
  168. package/dest/msg_validators/tx_validator/index.d.ts.map +1 -1
  169. package/dest/msg_validators/tx_validator/index.js +5 -0
  170. package/dest/msg_validators/tx_validator/metadata_validator.d.ts +3 -2
  171. package/dest/msg_validators/tx_validator/metadata_validator.d.ts.map +1 -1
  172. package/dest/msg_validators/tx_validator/metadata_validator.js +6 -6
  173. package/dest/msg_validators/tx_validator/nullifier_cache.d.ts +14 -0
  174. package/dest/msg_validators/tx_validator/nullifier_cache.d.ts.map +1 -0
  175. package/dest/msg_validators/tx_validator/nullifier_cache.js +24 -0
  176. package/dest/msg_validators/tx_validator/phases_validator.d.ts +24 -3
  177. package/dest/msg_validators/tx_validator/phases_validator.d.ts.map +1 -1
  178. package/dest/msg_validators/tx_validator/phases_validator.js +75 -27
  179. package/dest/msg_validators/tx_validator/size_validator.d.ts +8 -0
  180. package/dest/msg_validators/tx_validator/size_validator.d.ts.map +1 -0
  181. package/dest/msg_validators/tx_validator/size_validator.js +23 -0
  182. package/dest/msg_validators/tx_validator/timestamp_validator.d.ts +22 -5
  183. package/dest/msg_validators/tx_validator/timestamp_validator.d.ts.map +1 -1
  184. package/dest/msg_validators/tx_validator/timestamp_validator.js +8 -8
  185. package/dest/msg_validators/tx_validator/tx_permitted_validator.d.ts +3 -2
  186. package/dest/msg_validators/tx_validator/tx_permitted_validator.d.ts.map +1 -1
  187. package/dest/msg_validators/tx_validator/tx_permitted_validator.js +2 -2
  188. package/dest/msg_validators/tx_validator/tx_proof_validator.d.ts +4 -2
  189. package/dest/msg_validators/tx_validator/tx_proof_validator.d.ts.map +1 -1
  190. package/dest/msg_validators/tx_validator/tx_proof_validator.js +4 -2
  191. package/dest/msg_validators/tx_validator/tx_validation_cache.d.ts +48 -0
  192. package/dest/msg_validators/tx_validator/tx_validation_cache.d.ts.map +1 -0
  193. package/dest/msg_validators/tx_validator/tx_validation_cache.js +69 -0
  194. package/dest/services/data_store.d.ts +1 -1
  195. package/dest/services/data_store.d.ts.map +1 -1
  196. package/dest/services/data_store.js +14 -10
  197. package/dest/services/discv5/discV5_service.d.ts +2 -1
  198. package/dest/services/discv5/discV5_service.d.ts.map +1 -1
  199. package/dest/services/discv5/discV5_service.js +36 -9
  200. package/dest/services/dummy_service.d.ts +33 -17
  201. package/dest/services/dummy_service.d.ts.map +1 -1
  202. package/dest/services/dummy_service.js +56 -15
  203. package/dest/services/encoding.d.ts +7 -3
  204. package/dest/services/encoding.d.ts.map +1 -1
  205. package/dest/services/encoding.js +20 -14
  206. package/dest/services/gossipsub/index.d.ts +3 -0
  207. package/dest/services/gossipsub/index.d.ts.map +1 -0
  208. package/dest/services/gossipsub/index.js +2 -0
  209. package/dest/services/gossipsub/scoring.d.ts +21 -3
  210. package/dest/services/gossipsub/scoring.d.ts.map +1 -1
  211. package/dest/services/gossipsub/scoring.js +24 -7
  212. package/dest/services/gossipsub/topic_score_params.d.ts +184 -0
  213. package/dest/services/gossipsub/topic_score_params.d.ts.map +1 -0
  214. package/dest/services/gossipsub/topic_score_params.js +363 -0
  215. package/dest/services/index.d.ts +2 -1
  216. package/dest/services/index.d.ts.map +1 -1
  217. package/dest/services/index.js +1 -0
  218. package/dest/services/libp2p/instrumentation.d.ts +3 -1
  219. package/dest/services/libp2p/instrumentation.d.ts.map +1 -1
  220. package/dest/services/libp2p/instrumentation.js +33 -8
  221. package/dest/services/libp2p/libp2p_service.d.ts +107 -59
  222. package/dest/services/libp2p/libp2p_service.d.ts.map +1 -1
  223. package/dest/services/libp2p/libp2p_service.js +683 -539
  224. package/dest/services/peer-manager/metrics.d.ts +4 -2
  225. package/dest/services/peer-manager/metrics.d.ts.map +1 -1
  226. package/dest/services/peer-manager/metrics.js +26 -5
  227. package/dest/services/peer-manager/peer_manager.d.ts +6 -2
  228. package/dest/services/peer-manager/peer_manager.d.ts.map +1 -1
  229. package/dest/services/peer-manager/peer_manager.js +40 -11
  230. package/dest/services/peer-manager/peer_scoring.d.ts +7 -2
  231. package/dest/services/peer-manager/peer_scoring.d.ts.map +1 -1
  232. package/dest/services/peer-manager/peer_scoring.js +65 -14
  233. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts +51 -0
  234. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts.map +1 -0
  235. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.js +552 -0
  236. package/dest/services/reqresp/batch-tx-requester/config.d.ts +17 -0
  237. package/dest/services/reqresp/batch-tx-requester/config.d.ts.map +1 -0
  238. package/dest/services/reqresp/batch-tx-requester/config.js +27 -0
  239. package/dest/services/reqresp/batch-tx-requester/interface.d.ts +50 -0
  240. package/dest/services/reqresp/batch-tx-requester/interface.d.ts.map +1 -0
  241. package/dest/services/reqresp/batch-tx-requester/interface.js +1 -0
  242. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts +35 -0
  243. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts.map +1 -0
  244. package/dest/services/reqresp/batch-tx-requester/missing_txs.js +136 -0
  245. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts +62 -0
  246. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts.map +1 -0
  247. package/dest/services/reqresp/batch-tx-requester/peer_collection.js +176 -0
  248. package/dest/services/reqresp/batch-tx-requester/tx_validator.d.ts +11 -0
  249. package/dest/services/reqresp/batch-tx-requester/tx_validator.d.ts.map +1 -0
  250. package/dest/services/reqresp/batch-tx-requester/tx_validator.js +7 -0
  251. package/dest/services/reqresp/config.d.ts +3 -3
  252. package/dest/services/reqresp/config.d.ts.map +1 -1
  253. package/dest/services/reqresp/connection-sampler/connection_sampler.d.ts +2 -1
  254. package/dest/services/reqresp/connection-sampler/connection_sampler.d.ts.map +1 -1
  255. package/dest/services/reqresp/connection-sampler/connection_sampler.js +12 -0
  256. package/dest/services/reqresp/constants.d.ts +12 -0
  257. package/dest/services/reqresp/constants.d.ts.map +1 -0
  258. package/dest/services/reqresp/constants.js +7 -0
  259. package/dest/services/reqresp/interface.d.ts +27 -18
  260. package/dest/services/reqresp/interface.d.ts.map +1 -1
  261. package/dest/services/reqresp/interface.js +23 -19
  262. package/dest/services/reqresp/metrics.d.ts +6 -5
  263. package/dest/services/reqresp/metrics.d.ts.map +1 -1
  264. package/dest/services/reqresp/metrics.js +16 -5
  265. package/dest/services/reqresp/protocols/block_txs/bitvector.d.ts +5 -1
  266. package/dest/services/reqresp/protocols/block_txs/bitvector.d.ts.map +1 -1
  267. package/dest/services/reqresp/protocols/block_txs/bitvector.js +12 -0
  268. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts +7 -5
  269. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts.map +1 -1
  270. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.js +29 -9
  271. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts +29 -6
  272. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts.map +1 -1
  273. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.js +59 -13
  274. package/dest/services/reqresp/protocols/index.d.ts +1 -2
  275. package/dest/services/reqresp/protocols/index.d.ts.map +1 -1
  276. package/dest/services/reqresp/protocols/index.js +0 -1
  277. package/dest/services/reqresp/protocols/status.d.ts +1 -1
  278. package/dest/services/reqresp/protocols/status.d.ts.map +1 -1
  279. package/dest/services/reqresp/protocols/status.js +2 -1
  280. package/dest/services/reqresp/protocols/tx.d.ts +7 -1
  281. package/dest/services/reqresp/protocols/tx.d.ts.map +1 -1
  282. package/dest/services/reqresp/protocols/tx.js +21 -3
  283. package/dest/services/reqresp/rate-limiter/rate_limiter.d.ts +5 -4
  284. package/dest/services/reqresp/rate-limiter/rate_limiter.d.ts.map +1 -1
  285. package/dest/services/reqresp/rate-limiter/rate_limiter.js +10 -8
  286. package/dest/services/reqresp/rate-limiter/rate_limits.d.ts +1 -1
  287. package/dest/services/reqresp/rate-limiter/rate_limits.d.ts.map +1 -1
  288. package/dest/services/reqresp/rate-limiter/rate_limits.js +0 -10
  289. package/dest/services/reqresp/reqresp.d.ts +12 -29
  290. package/dest/services/reqresp/reqresp.d.ts.map +1 -1
  291. package/dest/services/reqresp/reqresp.js +58 -187
  292. package/dest/services/service.d.ts +49 -13
  293. package/dest/services/service.d.ts.map +1 -1
  294. package/dest/services/tx_collection/config.d.ts +11 -11
  295. package/dest/services/tx_collection/config.d.ts.map +1 -1
  296. package/dest/services/tx_collection/config.js +27 -26
  297. package/dest/services/tx_collection/file_store_tx_collection.d.ts +37 -0
  298. package/dest/services/tx_collection/file_store_tx_collection.d.ts.map +1 -0
  299. package/dest/services/tx_collection/file_store_tx_collection.js +127 -0
  300. package/dest/services/tx_collection/file_store_tx_source.d.ts +38 -0
  301. package/dest/services/tx_collection/file_store_tx_source.d.ts.map +1 -0
  302. package/dest/services/tx_collection/file_store_tx_source.js +100 -0
  303. package/dest/services/tx_collection/index.d.ts +3 -2
  304. package/dest/services/tx_collection/index.d.ts.map +1 -1
  305. package/dest/services/tx_collection/index.js +1 -0
  306. package/dest/services/tx_collection/instrumentation.d.ts +1 -1
  307. package/dest/services/tx_collection/instrumentation.d.ts.map +1 -1
  308. package/dest/services/tx_collection/instrumentation.js +8 -2
  309. package/dest/services/tx_collection/request_tracker.d.ts +53 -0
  310. package/dest/services/tx_collection/request_tracker.d.ts.map +1 -0
  311. package/dest/services/tx_collection/request_tracker.js +84 -0
  312. package/dest/services/tx_collection/tx_collection.d.ts +50 -56
  313. package/dest/services/tx_collection/tx_collection.d.ts.map +1 -1
  314. package/dest/services/tx_collection/tx_collection.js +298 -70
  315. package/dest/services/tx_collection/tx_collection_sink.d.ts +19 -9
  316. package/dest/services/tx_collection/tx_collection_sink.d.ts.map +1 -1
  317. package/dest/services/tx_collection/tx_collection_sink.js +28 -31
  318. package/dest/services/tx_collection/tx_source.d.ts +13 -7
  319. package/dest/services/tx_collection/tx_source.d.ts.map +1 -1
  320. package/dest/services/tx_collection/tx_source.js +26 -7
  321. package/dest/services/tx_file_store/config.d.ts +16 -0
  322. package/dest/services/tx_file_store/config.d.ts.map +1 -0
  323. package/dest/services/tx_file_store/config.js +22 -0
  324. package/dest/services/tx_file_store/index.d.ts +4 -0
  325. package/dest/services/tx_file_store/index.d.ts.map +1 -0
  326. package/dest/services/tx_file_store/index.js +3 -0
  327. package/dest/services/tx_file_store/instrumentation.d.ts +15 -0
  328. package/dest/services/tx_file_store/instrumentation.d.ts.map +1 -0
  329. package/dest/services/tx_file_store/instrumentation.js +29 -0
  330. package/dest/services/tx_file_store/tx_file_store.d.ts +46 -0
  331. package/dest/services/tx_file_store/tx_file_store.d.ts.map +1 -0
  332. package/dest/services/tx_file_store/tx_file_store.js +142 -0
  333. package/dest/services/tx_provider.d.ts +8 -6
  334. package/dest/services/tx_provider.d.ts.map +1 -1
  335. package/dest/services/tx_provider.js +12 -8
  336. package/dest/services/tx_provider_instrumentation.d.ts +1 -1
  337. package/dest/services/tx_provider_instrumentation.d.ts.map +1 -1
  338. package/dest/services/tx_provider_instrumentation.js +5 -5
  339. package/dest/test-helpers/index.d.ts +3 -1
  340. package/dest/test-helpers/index.d.ts.map +1 -1
  341. package/dest/test-helpers/index.js +2 -0
  342. package/dest/test-helpers/make-test-p2p-clients.d.ts +7 -8
  343. package/dest/test-helpers/make-test-p2p-clients.d.ts.map +1 -1
  344. package/dest/test-helpers/make-test-p2p-clients.js +5 -3
  345. package/dest/test-helpers/mock-pubsub.d.ts +46 -6
  346. package/dest/test-helpers/mock-pubsub.d.ts.map +1 -1
  347. package/dest/test-helpers/mock-pubsub.js +115 -14
  348. package/dest/test-helpers/reqresp-nodes.d.ts +5 -7
  349. package/dest/test-helpers/reqresp-nodes.d.ts.map +1 -1
  350. package/dest/test-helpers/reqresp-nodes.js +19 -20
  351. package/dest/test-helpers/test_tx_provider.d.ts +42 -0
  352. package/dest/test-helpers/test_tx_provider.d.ts.map +1 -0
  353. package/dest/test-helpers/test_tx_provider.js +44 -0
  354. package/dest/test-helpers/testbench-utils.d.ts +161 -0
  355. package/dest/test-helpers/testbench-utils.d.ts.map +1 -0
  356. package/dest/test-helpers/testbench-utils.js +393 -0
  357. package/dest/testbench/p2p_client_testbench_worker.d.ts +26 -2
  358. package/dest/testbench/p2p_client_testbench_worker.d.ts.map +1 -1
  359. package/dest/testbench/p2p_client_testbench_worker.js +270 -144
  360. package/dest/testbench/worker_client_manager.d.ts +57 -6
  361. package/dest/testbench/worker_client_manager.d.ts.map +1 -1
  362. package/dest/testbench/worker_client_manager.js +277 -49
  363. package/dest/util.d.ts +13 -8
  364. package/dest/util.d.ts.map +1 -1
  365. package/dest/util.js +35 -14
  366. package/dest/versioning.d.ts +3 -6
  367. package/dest/versioning.d.ts.map +1 -1
  368. package/dest/versioning.js +3 -24
  369. package/package.json +17 -16
  370. package/src/bootstrap/bootstrap.ts +16 -5
  371. package/src/client/factory.ts +135 -39
  372. package/src/client/interface.ts +70 -44
  373. package/src/client/p2p_client.ts +283 -302
  374. package/src/client/test/p2p_client.batch_tx_requester.bench.README.md +197 -0
  375. package/src/config.ts +274 -48
  376. package/src/errors/p2p-service.error.ts +11 -0
  377. package/src/errors/reqresp.error.ts +0 -25
  378. package/src/errors/tx-pool.error.ts +12 -0
  379. package/src/index.ts +1 -1
  380. package/src/mem_pools/attestation_pool/attestation_pool.ts +575 -94
  381. package/src/mem_pools/attestation_pool/attestation_pool_test_suite.ts +633 -149
  382. package/src/mem_pools/attestation_pool/index.ts +9 -2
  383. package/src/mem_pools/attestation_pool/mocks.ts +19 -11
  384. package/src/mem_pools/index.ts +2 -2
  385. package/src/mem_pools/instrumentation.ts +24 -15
  386. package/src/mem_pools/interface.ts +4 -4
  387. package/src/mem_pools/tx_pool_v2/README.md +283 -0
  388. package/src/mem_pools/tx_pool_v2/archive/index.ts +1 -0
  389. package/src/mem_pools/tx_pool_v2/archive/tx_archive.ts +120 -0
  390. package/src/mem_pools/tx_pool_v2/deleted_pool.ts +321 -0
  391. package/src/mem_pools/tx_pool_v2/eviction/eviction_manager.ts +160 -0
  392. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.ts +122 -0
  393. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.ts +125 -0
  394. package/src/mem_pools/tx_pool_v2/eviction/index.ts +28 -0
  395. package/src/mem_pools/tx_pool_v2/eviction/insufficient_fee_per_gas_eviction_rule.ts +65 -0
  396. package/src/mem_pools/tx_pool_v2/eviction/interfaces.ts +219 -0
  397. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.ts +74 -0
  398. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.ts +101 -0
  399. package/src/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.ts +91 -0
  400. package/src/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.ts +99 -0
  401. package/src/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.ts +32 -0
  402. package/src/mem_pools/tx_pool_v2/index.ts +12 -0
  403. package/src/mem_pools/tx_pool_v2/instrumentation.ts +69 -0
  404. package/src/mem_pools/tx_pool_v2/interfaces.ts +250 -0
  405. package/src/mem_pools/tx_pool_v2/tx_metadata.ts +349 -0
  406. package/src/mem_pools/tx_pool_v2/tx_pool_bench_metrics.ts +77 -0
  407. package/src/mem_pools/tx_pool_v2/tx_pool_indices.ts +430 -0
  408. package/src/mem_pools/tx_pool_v2/tx_pool_v2.ts +238 -0
  409. package/src/mem_pools/tx_pool_v2/tx_pool_v2_impl.ts +1090 -0
  410. package/src/msg_validators/attestation_validator/README.md +49 -0
  411. package/src/msg_validators/attestation_validator/attestation_validator.ts +60 -16
  412. package/src/msg_validators/attestation_validator/fisherman_attestation_validator.ts +29 -16
  413. package/src/msg_validators/clock_tolerance.ts +127 -0
  414. package/src/msg_validators/proposal_validator/README.md +123 -0
  415. package/src/msg_validators/proposal_validator/block_proposal_validator.ts +24 -4
  416. package/src/msg_validators/proposal_validator/checkpoint_proposal_validator.ts +35 -7
  417. package/src/msg_validators/proposal_validator/proposal_validator.ts +129 -62
  418. package/src/msg_validators/tx_validator/README.md +127 -0
  419. package/src/msg_validators/tx_validator/aggregate_tx_validator.ts +8 -17
  420. package/src/msg_validators/tx_validator/allowed_public_setup.ts +22 -27
  421. package/src/msg_validators/tx_validator/allowed_setup_helpers.ts +31 -0
  422. package/src/msg_validators/tx_validator/archive_cache.ts +2 -2
  423. package/src/msg_validators/tx_validator/block_header_validator.ts +21 -8
  424. package/src/msg_validators/tx_validator/cached_tx_validator.ts +31 -0
  425. package/src/msg_validators/tx_validator/contract_instance_validator.ts +56 -0
  426. package/src/msg_validators/tx_validator/data_validator.ts +50 -3
  427. package/src/msg_validators/tx_validator/double_spend_validator.ts +15 -9
  428. package/src/msg_validators/tx_validator/factory.ts +424 -56
  429. package/src/msg_validators/tx_validator/fee_payer_balance.ts +44 -0
  430. package/src/msg_validators/tx_validator/gas_validator.ts +211 -77
  431. package/src/msg_validators/tx_validator/index.ts +5 -0
  432. package/src/msg_validators/tx_validator/metadata_validator.ts +18 -7
  433. package/src/msg_validators/tx_validator/nullifier_cache.ts +30 -0
  434. package/src/msg_validators/tx_validator/phases_validator.ts +87 -30
  435. package/src/msg_validators/tx_validator/size_validator.ts +22 -0
  436. package/src/msg_validators/tx_validator/timestamp_validator.ts +29 -21
  437. package/src/msg_validators/tx_validator/tx_permitted_validator.ts +8 -3
  438. package/src/msg_validators/tx_validator/tx_proof_validator.ts +10 -3
  439. package/src/msg_validators/tx_validator/tx_validation_cache.ts +102 -0
  440. package/src/services/data_store.ts +14 -19
  441. package/src/services/discv5/discV5_service.ts +39 -6
  442. package/src/services/dummy_service.ts +71 -39
  443. package/src/services/encoding.ts +20 -13
  444. package/src/services/gossipsub/README.md +641 -0
  445. package/src/services/gossipsub/index.ts +2 -0
  446. package/src/services/gossipsub/scoring.ts +29 -5
  447. package/src/services/gossipsub/topic_score_params.ts +519 -0
  448. package/src/services/index.ts +1 -0
  449. package/src/services/libp2p/instrumentation.ts +34 -7
  450. package/src/services/libp2p/libp2p_service.ts +753 -597
  451. package/src/services/peer-manager/metrics.ts +28 -4
  452. package/src/services/peer-manager/peer_manager.ts +46 -11
  453. package/src/services/peer-manager/peer_scoring.ts +56 -6
  454. package/src/services/reqresp/README.md +215 -0
  455. package/src/services/reqresp/batch-tx-requester/README.md +344 -0
  456. package/src/services/reqresp/batch-tx-requester/batch_tx_requester.ts +684 -0
  457. package/src/services/reqresp/batch-tx-requester/config.ts +40 -0
  458. package/src/services/reqresp/batch-tx-requester/interface.ts +61 -0
  459. package/src/services/reqresp/batch-tx-requester/missing_txs.ts +168 -0
  460. package/src/services/reqresp/batch-tx-requester/peer_collection.ts +249 -0
  461. package/src/services/reqresp/batch-tx-requester/tx_validator.ts +24 -0
  462. package/src/services/reqresp/config.ts +2 -2
  463. package/src/services/reqresp/connection-sampler/connection_sampler.ts +16 -0
  464. package/src/services/reqresp/constants.ts +14 -0
  465. package/src/services/reqresp/interface.ts +48 -46
  466. package/src/services/reqresp/metrics.ts +33 -9
  467. package/src/services/reqresp/protocols/block_txs/bitvector.ts +16 -0
  468. package/src/services/reqresp/protocols/block_txs/block_txs_handler.ts +37 -12
  469. package/src/services/reqresp/protocols/block_txs/block_txs_reqresp.ts +74 -9
  470. package/src/services/reqresp/protocols/index.ts +0 -1
  471. package/src/services/reqresp/protocols/status.ts +5 -3
  472. package/src/services/reqresp/protocols/tx.ts +23 -3
  473. package/src/services/reqresp/rate-limiter/rate_limiter.ts +13 -9
  474. package/src/services/reqresp/rate-limiter/rate_limits.ts +0 -10
  475. package/src/services/reqresp/reqresp.ts +68 -224
  476. package/src/services/service.ts +66 -29
  477. package/src/services/tx_collection/config.ts +41 -36
  478. package/src/services/tx_collection/file_store_tx_collection.ts +153 -0
  479. package/src/services/tx_collection/file_store_tx_source.ts +129 -0
  480. package/src/services/tx_collection/index.ts +2 -1
  481. package/src/services/tx_collection/instrumentation.ts +11 -2
  482. package/src/services/tx_collection/request_tracker.ts +127 -0
  483. package/src/services/tx_collection/tx_collection.ts +367 -115
  484. package/src/services/tx_collection/tx_collection_sink.ts +32 -36
  485. package/src/services/tx_collection/tx_source.ts +28 -8
  486. package/src/services/tx_file_store/config.ts +37 -0
  487. package/src/services/tx_file_store/index.ts +3 -0
  488. package/src/services/tx_file_store/instrumentation.ts +36 -0
  489. package/src/services/tx_file_store/tx_file_store.ts +163 -0
  490. package/src/services/tx_provider.ts +17 -11
  491. package/src/services/tx_provider_instrumentation.ts +11 -5
  492. package/src/test-helpers/index.ts +2 -0
  493. package/src/test-helpers/make-test-p2p-clients.ts +7 -6
  494. package/src/test-helpers/mock-pubsub.ts +137 -14
  495. package/src/test-helpers/reqresp-nodes.ts +17 -29
  496. package/src/test-helpers/test_tx_provider.ts +69 -0
  497. package/src/test-helpers/testbench-utils.ts +455 -0
  498. package/src/testbench/p2p_client_testbench_worker.ts +370 -138
  499. package/src/testbench/worker_client_manager.ts +355 -51
  500. package/src/util.ts +40 -19
  501. package/src/versioning.ts +3 -33
  502. package/dest/mem_pools/attestation_pool/kv_attestation_pool.d.ts +0 -40
  503. package/dest/mem_pools/attestation_pool/kv_attestation_pool.d.ts.map +0 -1
  504. package/dest/mem_pools/attestation_pool/kv_attestation_pool.js +0 -218
  505. package/dest/mem_pools/attestation_pool/memory_attestation_pool.d.ts +0 -31
  506. package/dest/mem_pools/attestation_pool/memory_attestation_pool.d.ts.map +0 -1
  507. package/dest/mem_pools/attestation_pool/memory_attestation_pool.js +0 -180
  508. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.d.ts +0 -120
  509. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.d.ts.map +0 -1
  510. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.js +0 -555
  511. package/dest/mem_pools/tx_pool/eviction/eviction_manager.d.ts +0 -18
  512. package/dest/mem_pools/tx_pool/eviction/eviction_manager.d.ts.map +0 -1
  513. package/dest/mem_pools/tx_pool/eviction/eviction_manager.js +0 -56
  514. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.d.ts +0 -83
  515. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.d.ts.map +0 -1
  516. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.js +0 -5
  517. package/dest/mem_pools/tx_pool/eviction/insufficient_fee_payer_balance_rule.d.ts +0 -15
  518. package/dest/mem_pools/tx_pool/eviction/insufficient_fee_payer_balance_rule.d.ts.map +0 -1
  519. package/dest/mem_pools/tx_pool/eviction/insufficient_fee_payer_balance_rule.js +0 -88
  520. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.d.ts +0 -17
  521. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.d.ts.map +0 -1
  522. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.d.ts +0 -19
  523. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.d.ts.map +0 -1
  524. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.js +0 -76
  525. package/dest/mem_pools/tx_pool/eviction/low_priority_eviction_rule.d.ts +0 -26
  526. package/dest/mem_pools/tx_pool/eviction/low_priority_eviction_rule.d.ts.map +0 -1
  527. package/dest/mem_pools/tx_pool/eviction/low_priority_eviction_rule.js +0 -84
  528. package/dest/mem_pools/tx_pool/index.d.ts +0 -3
  529. package/dest/mem_pools/tx_pool/index.d.ts.map +0 -1
  530. package/dest/mem_pools/tx_pool/index.js +0 -2
  531. package/dest/mem_pools/tx_pool/priority.d.ts +0 -12
  532. package/dest/mem_pools/tx_pool/priority.d.ts.map +0 -1
  533. package/dest/mem_pools/tx_pool/priority.js +0 -15
  534. package/dest/mem_pools/tx_pool/tx_pool.d.ts +0 -127
  535. package/dest/mem_pools/tx_pool/tx_pool.d.ts.map +0 -1
  536. package/dest/mem_pools/tx_pool/tx_pool.js +0 -3
  537. package/dest/mem_pools/tx_pool/tx_pool_test_suite.d.ts +0 -7
  538. package/dest/mem_pools/tx_pool/tx_pool_test_suite.d.ts.map +0 -1
  539. package/dest/mem_pools/tx_pool/tx_pool_test_suite.js +0 -400
  540. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.d.ts +0 -23
  541. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.d.ts.map +0 -1
  542. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.js +0 -183
  543. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.d.ts +0 -45
  544. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.d.ts.map +0 -1
  545. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.js +0 -92
  546. package/dest/services/reqresp/protocols/block.d.ts +0 -9
  547. package/dest/services/reqresp/protocols/block.d.ts.map +0 -1
  548. package/dest/services/reqresp/protocols/block.js +0 -32
  549. package/dest/services/tx_collection/fast_tx_collection.d.ts +0 -51
  550. package/dest/services/tx_collection/fast_tx_collection.d.ts.map +0 -1
  551. package/dest/services/tx_collection/fast_tx_collection.js +0 -300
  552. package/dest/services/tx_collection/slow_tx_collection.d.ts +0 -53
  553. package/dest/services/tx_collection/slow_tx_collection.d.ts.map +0 -1
  554. package/dest/services/tx_collection/slow_tx_collection.js +0 -177
  555. package/src/mem_pools/attestation_pool/kv_attestation_pool.ts +0 -320
  556. package/src/mem_pools/attestation_pool/memory_attestation_pool.ts +0 -264
  557. package/src/mem_pools/tx_pool/README.md +0 -255
  558. package/src/mem_pools/tx_pool/aztec_kv_tx_pool.ts +0 -691
  559. package/src/mem_pools/tx_pool/eviction/eviction_manager.ts +0 -71
  560. package/src/mem_pools/tx_pool/eviction/eviction_strategy.ts +0 -93
  561. package/src/mem_pools/tx_pool/eviction/insufficient_fee_payer_balance_rule.ts +0 -108
  562. package/src/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.ts +0 -104
  563. package/src/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.ts +0 -91
  564. package/src/mem_pools/tx_pool/eviction/low_priority_eviction_rule.ts +0 -106
  565. package/src/mem_pools/tx_pool/index.ts +0 -2
  566. package/src/mem_pools/tx_pool/priority.ts +0 -20
  567. package/src/mem_pools/tx_pool/tx_pool.ts +0 -141
  568. package/src/mem_pools/tx_pool/tx_pool_test_suite.ts +0 -319
  569. package/src/msg_validators/proposal_validator/proposal_validator_test_suite.ts +0 -206
  570. package/src/services/reqresp/connection-sampler/batch_connection_sampler.ts +0 -100
  571. package/src/services/reqresp/protocols/block.ts +0 -37
  572. package/src/services/tx_collection/fast_tx_collection.ts +0 -341
  573. package/src/services/tx_collection/slow_tx_collection.ts +0 -233
@@ -370,23 +370,20 @@ function applyDecs2203RFactory() {
370
370
  function _apply_decs_2203_r(targetClass, memberDecs, classDecs, parentClass) {
371
371
  return (_apply_decs_2203_r = applyDecs2203RFactory())(targetClass, memberDecs, classDecs, parentClass);
372
372
  }
373
- var _dec, _dec1, _dec2, _dec3, _dec4, _dec5, _dec6, _dec7, _dec8, _initProto;
373
+ var _dec, _dec1, _dec2, _dec3, _dec4, _dec5, _initProto;
374
374
  import { BlockNumber } from '@aztec/foundation/branded-types';
375
- import { randomInt } from '@aztec/foundation/crypto/random';
376
- import { Fr } from '@aztec/foundation/curves/bn254';
375
+ import { maxBy, merge } from '@aztec/foundation/collection';
377
376
  import { createLibp2pComponentLogger, createLogger } from '@aztec/foundation/log';
378
377
  import { RunningPromise } from '@aztec/foundation/running-promise';
379
378
  import { Timer } from '@aztec/foundation/timer';
380
- import { getVKTreeRoot } from '@aztec/noir-protocol-circuits-types/vk-tree';
381
379
  import { protocolContractsHash } from '@aztec/protocol-contracts';
382
- import { GasFees } from '@aztec/stdlib/gas';
383
- import { BlockProposal, CheckpointAttestation, CheckpointProposal, P2PClientType, P2PMessage, PeerErrorSeverity, TopicType, createTopicString, getTopicsForClientAndConfig, metricsTopicStrToLabels } from '@aztec/stdlib/p2p';
380
+ import { BlockProposal, CheckpointAttestation, CheckpointProposal, P2PMessage, PeerErrorSeverity, PeerErrorSeverityByHarshness, TopicType, createTopicString, getTopicsForConfig, metricsTopicStrToLabels } from '@aztec/stdlib/p2p';
384
381
  import { MerkleTreeId } from '@aztec/stdlib/trees';
385
382
  import { Tx } from '@aztec/stdlib/tx';
386
383
  import { compressComponentVersions } from '@aztec/stdlib/versioning';
387
384
  import { Attributes, OtelMetricsAdapter, SpanStatusCode, WithTracer, trackSpan } from '@aztec/telemetry-client';
388
385
  import { gossipsub } from '@chainsafe/libp2p-gossipsub';
389
- import { createPeerScoreParams, createTopicScoreParams } from '@chainsafe/libp2p-gossipsub/score';
386
+ import { createPeerScoreParams } from '@chainsafe/libp2p-gossipsub/score';
390
387
  import { SignaturePolicy } from '@chainsafe/libp2p-gossipsub/types';
391
388
  import { noise } from '@chainsafe/libp2p-noise';
392
389
  import { yamux } from '@chainsafe/libp2p-yamux';
@@ -395,58 +392,47 @@ import { identify } from '@libp2p/identify';
395
392
  import { TopicValidatorResult } from '@libp2p/interface';
396
393
  import { mplex } from '@libp2p/mplex';
397
394
  import { tcp } from '@libp2p/tcp';
395
+ import { multiaddr } from '@multiformats/multiaddr';
398
396
  import { ENR } from '@nethermindeth/enr';
399
397
  import { createLibp2p } from 'libp2p';
400
- import { ProposalSlotCapExceededError } from '../../errors/attestation-pool.error.js';
401
- import { BlockProposalValidator, CheckpointAttestationValidator, CheckpointProposalValidator, FishermanAttestationValidator } from '../../msg_validators/index.js';
398
+ import { CheckpointProposalReceivedCallbackNotRegisteredError } from '../../errors/p2p-service.error.js';
399
+ import { BlockProposalValidator, CheckpointAttestationValidator, CheckpointProposalValidator, DoubleSpendTxValidator, FishermanAttestationValidator, getDefaultAllowedSetupFunctions } from '../../msg_validators/index.js';
402
400
  import { MessageSeenValidator } from '../../msg_validators/msg_seen_validator/msg_seen_validator.js';
403
- import { getDefaultAllowedSetupFunctions } from '../../msg_validators/tx_validator/allowed_public_setup.js';
404
- import { createTxMessageValidators } from '../../msg_validators/tx_validator/factory.js';
405
- import { AggregateTxValidator, DataTxValidator, DoubleSpendTxValidator, MetadataTxValidator, TxProofValidator } from '../../msg_validators/tx_validator/index.js';
401
+ import { createFirstStageTxValidationsForGossipedTransactions, createSecondStageTxValidationsForGossipedTransactions, createTxValidatorForBlockProposalReceivedTxs } from '../../msg_validators/tx_validator/factory.js';
406
402
  import { GossipSubEvent } from '../../types/index.js';
407
403
  import { convertToMultiaddr } from '../../util.js';
408
404
  import { getVersions } from '../../versioning.js';
409
405
  import { AztecDatastore } from '../data_store.js';
410
406
  import { DiscV5Service } from '../discv5/discV5_service.js';
411
407
  import { SnappyTransform, fastMsgIdFn, getMsgIdFn, msgIdToStrFn } from '../encoding.js';
412
- import { gossipScoreThresholds } from '../gossipsub/scoring.js';
408
+ import { APP_SPECIFIC_WEIGHT, gossipScoreThresholds } from '../gossipsub/scoring.js';
409
+ import { createAllTopicScoreParams } from '../gossipsub/topic_score_params.js';
413
410
  import { PeerManager } from '../peer-manager/peer_manager.js';
414
411
  import { PeerScoring } from '../peer-manager/peer_scoring.js';
415
- import { DEFAULT_SUB_PROTOCOL_VALIDATORS, ReqRespSubProtocol, ValidationError } from '../reqresp/interface.js';
416
- import { reqRespBlockTxsHandler } from '../reqresp/protocols/block_txs/block_txs_handler.js';
417
- import { reqGoodbyeHandler } from '../reqresp/protocols/goodbye.js';
418
- import { pingHandler, reqRespBlockHandler, reqRespStatusHandler, reqRespTxHandler } from '../reqresp/protocols/index.js';
412
+ import { ReqRespSubProtocol, ValidationError, pingHandler, reqGoodbyeHandler, reqRespBlockTxsHandler, reqRespStatusHandler, reqRespTxHandler } from '../reqresp/index.js';
419
413
  import { ReqResp } from '../reqresp/reqresp.js';
420
414
  import { P2PInstrumentation } from './instrumentation.js';
421
- _dec = trackSpan('Libp2pService.processValidBlockProposal', async (block)=>({
415
+ _dec = trackSpan('Libp2pService.validateAndStoreCheckpointAttestation', (_peerId, attestation)=>({
416
+ [Attributes.SLOT_NUMBER]: attestation.payload.header.slotNumber.toString()
417
+ })), _dec1 = trackSpan('Libp2pService.validateAndStoreBlockProposal', (_peerId, block)=>({
418
+ [Attributes.BLOCK_NUMBER]: block.blockNumber.toString(),
419
+ [Attributes.SLOT_NUMBER]: block.slotNumber.toString()
420
+ })), _dec2 = trackSpan('Libp2pService.processValidBlockProposal', async (block)=>({
422
421
  [Attributes.SLOT_NUMBER]: block.slotNumber,
423
422
  [Attributes.BLOCK_ARCHIVE]: block.archive.toString(),
424
423
  [Attributes.P2P_ID]: await block.p2pMessageLoggingIdentifier().then((i)=>i.toString())
425
- })), _dec1 = trackSpan('Libp2pService.processValidCheckpointProposal', async (checkpoint)=>({
424
+ })), _dec3 = trackSpan('Libp2pService.validateAndStoreCheckpointProposal', (_peerId, checkpoint)=>({
425
+ [Attributes.SLOT_NUMBER]: checkpoint.slotNumber.toString()
426
+ })), _dec4 = trackSpan('Libp2pService.processValidCheckpointProposal', async (checkpoint)=>({
426
427
  [Attributes.SLOT_NUMBER]: checkpoint.slotNumber,
427
428
  [Attributes.BLOCK_ARCHIVE]: checkpoint.archive.toString(),
428
429
  [Attributes.P2P_ID]: await checkpoint.p2pMessageLoggingIdentifier().then((i)=>i.toString())
429
- })), _dec2 = trackSpan('Libp2pService.validateRequestedBlockTxs', (request)=>({
430
- [Attributes.BLOCK_HASH]: request.blockHash.toString()
431
- })), _dec3 = trackSpan('Libp2pService.validateRequestedTx', (requestedTxHash, _responseTx)=>({
432
- [Attributes.TX_HASH]: requestedTxHash.toString()
433
- })), _dec4 = trackSpan('Libp2pService.validateRequestedBlock', (requestedBlockNumber, _responseBlock)=>({
434
- [Attributes.BLOCK_NUMBER]: requestedBlockNumber.toString()
435
- })), _dec5 = trackSpan('Libp2pService.validatePropagatedTx', (tx)=>({
436
- [Attributes.TX_HASH]: tx.getTxHash().toString()
437
- })), _dec6 = trackSpan('Libp2pService.validateCheckpointAttestation', async (_, attestation)=>({
438
- [Attributes.SLOT_NUMBER]: attestation.payload.header.slotNumber,
439
- [Attributes.BLOCK_ARCHIVE]: attestation.archive.toString(),
440
- [Attributes.P2P_ID]: await attestation.p2pMessageLoggingIdentifier().then((i)=>i.toString())
441
- })), _dec7 = trackSpan('Libp2pService.validateBlockProposal', (_peerId, block)=>({
442
- [Attributes.SLOT_NUMBER]: block.slotNumber.toString()
443
- })), _dec8 = trackSpan('Libp2pService.validateCheckpointProposal', (_peerId, checkpoint)=>({
444
- [Attributes.SLOT_NUMBER]: checkpoint.slotNumber.toString()
430
+ })), _dec5 = trackSpan('Libp2pService.validateRequestedBlockTxsConsistency', (request)=>({
431
+ [Attributes.BLOCK_ARCHIVE]: request.archiveRoot.toString()
445
432
  }));
446
433
  /**
447
434
  * Lib P2P implementation of the P2PService interface.
448
435
  */ export class LibP2PService extends WithTracer {
449
- clientType;
450
436
  config;
451
437
  node;
452
438
  peerDiscoveryService;
@@ -457,52 +443,39 @@ _dec = trackSpan('Libp2pService.processValidBlockProposal', async (block)=>({
457
443
  epochCache;
458
444
  proofVerifier;
459
445
  worldStateSynchronizer;
446
+ blockMinFeesProvider;
447
+ txValidationCache;
460
448
  static{
461
449
  ({ e: [_initProto] } = _apply_decs_2203_r(this, [
462
450
  [
463
451
  _dec,
464
452
  2,
465
- "processValidBlockProposal"
453
+ "validateAndStoreCheckpointAttestation"
466
454
  ],
467
455
  [
468
456
  _dec1,
469
457
  2,
470
- "processValidCheckpointProposal"
458
+ "validateAndStoreBlockProposal"
471
459
  ],
472
460
  [
473
461
  _dec2,
474
462
  2,
475
- "validateRequestedBlockTxs"
463
+ "processValidBlockProposal"
476
464
  ],
477
465
  [
478
466
  _dec3,
479
467
  2,
480
- "validateRequestedTxs"
468
+ "validateAndStoreCheckpointProposal"
481
469
  ],
482
470
  [
483
471
  _dec4,
484
472
  2,
485
- "validateRequestedBlock"
473
+ "processValidCheckpointProposal"
486
474
  ],
487
475
  [
488
476
  _dec5,
489
477
  2,
490
- "validatePropagatedTx"
491
- ],
492
- [
493
- _dec6,
494
- 2,
495
- "validateCheckpointAttestation"
496
- ],
497
- [
498
- _dec7,
499
- 2,
500
- "validateBlockProposal"
501
- ],
502
- [
503
- _dec8,
504
- 2,
505
- "validateCheckpointProposal"
478
+ "validateRequestedBlockTxsConsistency"
506
479
  ]
507
480
  ], []));
508
481
  }
@@ -514,7 +487,9 @@ _dec = trackSpan('Libp2pService.processValidBlockProposal', async (block)=>({
514
487
  checkpointAttestationValidator;
515
488
  protocolVersion;
516
489
  topicStrings;
517
- feesCache;
490
+ /** Callback invoked when a duplicate proposal is detected (triggers slashing). */ duplicateProposalCallback;
491
+ /** Callback invoked when a duplicate attestation is detected (triggers slashing). */ duplicateAttestationCallback;
492
+ /** Callback invoked when a valid checkpoint attestation is accepted into the pool. */ checkpointAttestationCallback;
518
493
  /**
519
494
  * Callback for when a block is received from a peer.
520
495
  * @param block - The block received from the peer.
@@ -524,13 +499,20 @@ _dec = trackSpan('Libp2pService.processValidBlockProposal', async (block)=>({
524
499
  * Callback for when a checkpoint proposal is received from a peer.
525
500
  * @param checkpoint - The checkpoint proposal received from the peer.
526
501
  * @returns The attestations for the checkpoint, if any.
527
- */ checkpointReceivedCallback;
502
+ */ allNodesCheckpointReceivedCallback;
503
+ /**
504
+ * Callback for when a checkpoint proposal is received - specifically for validators - from a peer.
505
+ * @param checkpoint - The checkpoint proposal received from the peer.
506
+ * @returns The attestations for the checkpoint, if any.
507
+ */ validatorCheckpointReceivedCallback;
528
508
  gossipSubEventHandler;
509
+ ipChangedHandler;
510
+ discoveredP2pIp;
529
511
  instrumentation;
530
512
  telemetry;
531
513
  logger;
532
- constructor(clientType, config, node, peerDiscoveryService, reqresp, peerManager, mempools, archiver, epochCache, proofVerifier, worldStateSynchronizer, telemetry, logger = createLogger('p2p:libp2p_service')){
533
- super(telemetry, 'LibP2PService'), this.clientType = clientType, this.config = config, this.node = node, this.peerDiscoveryService = peerDiscoveryService, this.reqresp = reqresp, this.peerManager = peerManager, this.mempools = mempools, this.archiver = archiver, this.epochCache = epochCache, this.proofVerifier = proofVerifier, this.worldStateSynchronizer = worldStateSynchronizer, this.msgIdSeenValidators = (_initProto(this), {}), this.protocolVersion = '', this.topicStrings = {};
514
+ constructor(config, node, peerDiscoveryService, reqresp, peerManager, mempools, archiver, epochCache, proofVerifier, worldStateSynchronizer, blockMinFeesProvider, telemetry, logger = createLogger('p2p:libp2p_service'), txValidationCache){
515
+ super(telemetry, 'LibP2PService'), this.config = config, this.node = node, this.peerDiscoveryService = peerDiscoveryService, this.reqresp = reqresp, this.peerManager = peerManager, this.mempools = mempools, this.archiver = archiver, this.epochCache = epochCache, this.proofVerifier = proofVerifier, this.worldStateSynchronizer = worldStateSynchronizer, this.blockMinFeesProvider = blockMinFeesProvider, this.txValidationCache = txValidationCache, this.msgIdSeenValidators = (_initProto(this), {}), this.protocolVersion = '', this.topicStrings = {};
534
516
  this.telemetry = telemetry;
535
517
  // Create child logger with fisherman prefix if in fisherman mode
536
518
  this.logger = config.fishermanMode ? logger.createChild('[FISHERMAN]') : logger;
@@ -546,40 +528,56 @@ _dec = trackSpan('Libp2pService.processValidBlockProposal', async (block)=>({
546
528
  this.topicStrings[TopicType.block_proposal] = createTopicString(TopicType.block_proposal, this.protocolVersion);
547
529
  this.topicStrings[TopicType.checkpoint_proposal] = createTopicString(TopicType.checkpoint_proposal, this.protocolVersion);
548
530
  this.topicStrings[TopicType.checkpoint_attestation] = createTopicString(TopicType.checkpoint_attestation, this.protocolVersion);
549
- this.blockProposalValidator = new BlockProposalValidator(epochCache, {
550
- txsPermitted: !config.disableTransactions
551
- });
552
- this.checkpointProposalValidator = new CheckpointProposalValidator(epochCache, {
553
- txsPermitted: !config.disableTransactions
554
- });
555
- this.checkpointAttestationValidator = config.fishermanMode ? new FishermanAttestationValidator(epochCache, mempools.attestationPool, telemetry) : new CheckpointAttestationValidator(epochCache);
531
+ const p2pPropagationTime = config.attestationPropagationTime;
532
+ const proposalValidatorOpts = {
533
+ txsPermitted: !config.disableTransactions,
534
+ maxTxsPerBlock: config.validateMaxTxsPerBlock ?? config.validateMaxTxsPerCheckpoint,
535
+ maxBlocksPerCheckpoint: config.maxBlocksPerCheckpoint,
536
+ p2pPropagationTime,
537
+ skipSlotValidation: config.skipProposalSlotValidation,
538
+ signatureContext: {
539
+ chainId: config.l1ChainId,
540
+ rollupAddress: config.rollupAddress
541
+ }
542
+ };
543
+ this.blockProposalValidator = new BlockProposalValidator(epochCache, proposalValidatorOpts);
544
+ this.checkpointProposalValidator = new CheckpointProposalValidator(epochCache, proposalValidatorOpts);
545
+ const attestationValidatorOpts = {
546
+ l1PublishingTime: config.l1PublishingTime,
547
+ p2pPropagationTime,
548
+ signatureContext: proposalValidatorOpts.signatureContext
549
+ };
550
+ this.checkpointAttestationValidator = config.fishermanMode ? new FishermanAttestationValidator(epochCache, mempools.attestationPool, telemetry, attestationValidatorOpts) : new CheckpointAttestationValidator(epochCache, attestationValidatorOpts);
556
551
  this.gossipSubEventHandler = this.handleGossipSubEvent.bind(this);
557
552
  this.blockReceivedCallback = async (block)=>{
558
- this.logger.debug(`Handler not yet registered: Block received callback not set. Received block for slot ${block.slotNumber} from peer.`, {
553
+ this.logger.warn(`Handler for block received not yet registered on P2P service. Received block ${block.blockNumber} for slot ${block.slotNumber} from peer.`, {
559
554
  p2pMessageIdentifier: await block.p2pMessageLoggingIdentifier()
560
555
  });
561
- return false;
556
+ return true;
557
+ };
558
+ this.allNodesCheckpointReceivedCallback = (_checkpoint)=>{
559
+ throw new CheckpointProposalReceivedCallbackNotRegisteredError();
562
560
  };
563
- this.checkpointReceivedCallback = (checkpoint)=>{
564
- this.logger.debug(`Handler not yet registered: Checkpoint received callback not set. Received checkpoint for slot ${checkpoint.slotNumber} from peer.`);
561
+ this.validatorCheckpointReceivedCallback = (_checkpoint)=>{
565
562
  return Promise.resolve(undefined);
566
563
  };
567
564
  }
568
565
  updateConfig(config) {
569
566
  this.reqresp.updateConfig(config);
567
+ this.config = merge(this.config, config);
570
568
  }
571
569
  /**
572
570
  * Creates an instance of the LibP2P service.
573
571
  * @param config - The configuration to use when creating the service.
574
572
  * @param txPool - The transaction pool to be accessed by the service.
575
573
  * @returns The new service.
576
- */ static async new(clientType, config, peerId, deps) {
577
- const { worldStateSynchronizer, epochCache, l2BlockSource, mempools, proofVerifier, peerStore, telemetry, logger, packageVersion } = deps;
574
+ */ static async new(config, peerId, deps) {
575
+ const { worldStateSynchronizer, epochCache, l2BlockSource, mempools, proofVerifier, peerStore, blockMinFeesProvider, telemetry, logger, packageVersion, txValidationCache } = deps;
578
576
  const { p2pPort, maxPeerCount, listenAddress } = config;
579
577
  const bindAddrTcp = convertToMultiaddr(listenAddress, p2pPort, 'tcp');
580
578
  const datastore = new AztecDatastore(peerStore);
581
- const otelMetricsAdapter = new OtelMetricsAdapter(telemetry);
582
- const peerDiscoveryService = new DiscV5Service(peerId, config, packageVersion, telemetry, createLogger(`${logger.module}:discv5_service`));
579
+ const otelMetricsAdapter = new OtelMetricsAdapter(telemetry, logger.getBindings());
580
+ const peerDiscoveryService = new DiscV5Service(peerId, config, packageVersion, telemetry, createLogger(`${logger.module}:discv5_service`, logger.getBindings()));
583
581
  // Seed libp2p's bootstrap discovery with private and trusted peers
584
582
  const bootstrapNodes = [
585
583
  ...config.privatePeers,
@@ -593,10 +591,6 @@ _dec = trackSpan('Libp2pService.processValidBlockProposal', async (block)=>({
593
591
  }
594
592
  const versions = getVersions(config);
595
593
  const protocolVersion = compressComponentVersions(versions);
596
- const txTopic = createTopicString(TopicType.tx, protocolVersion);
597
- const blockProposalTopic = createTopicString(TopicType.block_proposal, protocolVersion);
598
- const checkpointProposalTopic = createTopicString(TopicType.checkpoint_proposal, protocolVersion);
599
- const checkpointAttestationTopic = createTopicString(TopicType.checkpoint_attestation, protocolVersion);
600
594
  const preferredPeersEnrs = config.preferredPeers.map((enr)=>ENR.decodeTxt(enr));
601
595
  const directPeers = (await Promise.all(preferredPeersEnrs.map(async (enr)=>{
602
596
  const peerId = await enr.peerId();
@@ -614,6 +608,18 @@ _dec = trackSpan('Libp2pService.processValidBlockProposal', async (block)=>({
614
608
  const announceTcpMultiaddr = config.p2pIp ? [
615
609
  convertToMultiaddr(config.p2pIp, p2pPort, 'tcp')
616
610
  ] : [];
611
+ // Create dynamic topic score params based on network configuration
612
+ const l1Constants = epochCache.getL1Constants();
613
+ const topicScoreParams = createAllTopicScoreParams(protocolVersion, {
614
+ slotDurationMs: l1Constants.slotDuration * 1000,
615
+ ethereumSlotDuration: l1Constants.ethereumSlotDuration,
616
+ heartbeatIntervalMs: config.gossipsubInterval,
617
+ targetCommitteeSize: l1Constants.targetCommitteeSize,
618
+ blockDurationMs: config.blockDurationMs,
619
+ l1PublishingTime: config.l1PublishingTime,
620
+ p2pPropagationTime: config.attestationPropagationTime,
621
+ expectedBlockProposalsPerSlot: config.expectedBlockProposalsPerSlot
622
+ });
617
623
  const node = await createLibp2p({
618
624
  start: false,
619
625
  peerId,
@@ -714,43 +720,29 @@ _dec = trackSpan('Libp2pService.processValidBlockProposal', async (block)=>({
714
720
  scoreParams: createPeerScoreParams({
715
721
  // IPColocation factor can be disabled for local testing - default to -5
716
722
  IPColocationFactorWeight: config.debugDisableColocationPenalty ? 0 : -5.0,
717
- topics: {
718
- [txTopic]: createTopicScoreParams({
719
- topicWeight: 1,
720
- invalidMessageDeliveriesWeight: -20,
721
- invalidMessageDeliveriesDecay: 0.5
722
- }),
723
- [blockProposalTopic]: createTopicScoreParams({
724
- topicWeight: 1,
725
- invalidMessageDeliveriesWeight: -20,
726
- invalidMessageDeliveriesDecay: 0.5
727
- }),
728
- [checkpointProposalTopic]: createTopicScoreParams({
729
- topicWeight: 1,
730
- invalidMessageDeliveriesWeight: -20,
731
- invalidMessageDeliveriesDecay: 0.5
732
- }),
733
- [checkpointAttestationTopic]: createTopicScoreParams({
734
- topicWeight: 1,
735
- invalidMessageDeliveriesWeight: -20,
736
- invalidMessageDeliveriesDecay: 0.5
737
- })
738
- }
723
+ topics: topicScoreParams
739
724
  })
740
725
  }),
741
726
  components: (components)=>({
742
- connectionManager: components.connectionManager
727
+ connectionManager: components.connectionManager,
728
+ addressManager: components.addressManager
743
729
  })
744
730
  },
745
- logger: createLibp2pComponentLogger(logger.module)
731
+ logger: createLibp2pComponentLogger(logger.module, logger.getBindings())
746
732
  });
747
733
  const peerScoring = new PeerScoring(config, telemetry);
748
734
  const reqresp = new ReqResp(config, node, peerScoring, createLogger(`${logger.module}:reqresp`));
749
735
  const peerManager = new PeerManager(node, peerDiscoveryService, config, telemetry, createLogger(`${logger.module}:peer_manager`), peerScoring, reqresp, worldStateSynchronizer, protocolVersion, epochCache);
750
- // Update gossipsub score params
751
- node.services.pubsub.score.params.appSpecificWeight = 10;
736
+ // Gate req/resp data protocols for unauthenticated peers when p2pAllowOnlyValidators is enabled
737
+ reqresp.setShouldRejectPeer((peerId)=>peerManager.shouldDisableP2PGossip(peerId));
738
+ // Configure application-specific scoring for gossipsub.
739
+ // The weight scales app score to align with gossipsub thresholds:
740
+ // - Disconnect (-50) × 10 = -500 = gossipThreshold (stops receiving gossip)
741
+ // - Ban (-100) × 10 = -1000 = publishThreshold (cannot publish)
742
+ // Note: positive topic scores can offset penalties, so alignment is best-effort.
743
+ node.services.pubsub.score.params.appSpecificWeight = APP_SPECIFIC_WEIGHT;
752
744
  node.services.pubsub.score.params.appSpecificScore = (peerId)=>peerManager.shouldDisableP2PGossip(peerId) ? -Infinity : peerManager.getPeerScore(peerId);
753
- return new LibP2PService(clientType, config, node, peerDiscoveryService, reqresp, peerManager, mempools, l2BlockSource, epochCache, proofVerifier, worldStateSynchronizer, telemetry, logger);
745
+ return new LibP2PService(config, node, peerDiscoveryService, reqresp, peerManager, mempools, l2BlockSource, epochCache, proofVerifier, worldStateSynchronizer, blockMinFeesProvider, telemetry, logger, txValidationCache);
754
746
  }
755
747
  /**
756
748
  * Starts the LibP2P service.
@@ -760,42 +752,32 @@ _dec = trackSpan('Libp2pService.processValidBlockProposal', async (block)=>({
760
752
  if (this.node.status === 'started') {
761
753
  throw new Error('P2P service already started');
762
754
  }
763
- // Get listen & announce addresses for logging
764
755
  const { p2pIp, p2pPort } = this.config;
765
- if (!p2pIp) {
766
- throw new Error('Announce address not provided.');
756
+ if (!p2pIp && !this.config.queryForIp) {
757
+ throw new Error('Announce address not provided and queryForIp is not enabled.');
767
758
  }
768
- const announceTcpMultiaddr = convertToMultiaddr(p2pIp, p2pPort, 'tcp');
759
+ const announceTcpMultiaddr = p2pIp ? convertToMultiaddr(p2pIp, p2pPort, 'tcp') : undefined;
769
760
  // Create request response protocol handlers
770
761
  const txHandler = reqRespTxHandler(this.mempools);
771
762
  const goodbyeHandler = reqGoodbyeHandler(this.peerManager);
772
- const blockHandler = reqRespBlockHandler(this.archiver);
773
763
  const statusHandler = reqRespStatusHandler(this.protocolVersion, this.worldStateSynchronizer, this.logger);
774
764
  const requestResponseHandlers = {
775
765
  [ReqRespSubProtocol.PING]: pingHandler,
776
766
  [ReqRespSubProtocol.STATUS]: statusHandler.bind(this),
777
- [ReqRespSubProtocol.GOODBYE]: goodbyeHandler.bind(this),
778
- [ReqRespSubProtocol.BLOCK]: blockHandler.bind(this)
767
+ [ReqRespSubProtocol.GOODBYE]: goodbyeHandler.bind(this)
779
768
  };
780
769
  if (!this.config.disableTransactions) {
781
- const blockTxsHandler = reqRespBlockTxsHandler(this.mempools.attestationPool, this.mempools.txPool);
770
+ const blockTxsHandler = reqRespBlockTxsHandler(this.mempools.attestationPool, this.archiver, this.mempools.txPool);
782
771
  requestResponseHandlers[ReqRespSubProtocol.BLOCK_TXS] = blockTxsHandler.bind(this);
783
772
  }
784
773
  if (!this.config.disableTransactions) {
785
774
  requestResponseHandlers[ReqRespSubProtocol.TX] = txHandler.bind(this);
786
775
  }
787
- // Define the sub protocol validators - This is done within this start() method to gain a callback to the existing validateTx function
788
- const reqrespSubProtocolValidators = {
789
- ...DEFAULT_SUB_PROTOCOL_VALIDATORS,
790
- [ReqRespSubProtocol.TX]: this.validateRequestedTxs.bind(this),
791
- [ReqRespSubProtocol.BLOCK_TXS]: this.validateRequestedBlockTxs.bind(this),
792
- [ReqRespSubProtocol.BLOCK]: this.validateRequestedBlock.bind(this)
793
- };
794
776
  await this.peerManager.initializePeers();
795
- await this.reqresp.start(requestResponseHandlers, reqrespSubProtocolValidators);
777
+ await this.reqresp.start(requestResponseHandlers);
796
778
  await this.node.start();
797
779
  // Subscribe to standard GossipSub topics by default
798
- for (const topic of getTopicsForClientAndConfig(this.clientType, this.config.disableTransactions)){
780
+ for (const topic of getTopicsForConfig(this.config.disableTransactions)){
799
781
  this.subscribeToTopic(this.topicStrings[topic]);
800
782
  }
801
783
  // add GossipSub listener
@@ -804,6 +786,34 @@ _dec = trackSpan('Libp2pService.processValidBlockProposal', async (block)=>({
804
786
  if (!this.config.p2pDiscoveryDisabled) {
805
787
  await this.peerDiscoveryService.start();
806
788
  }
789
+ // Bridge discv5 IP changes to libp2p's AddressManager so peers see the updated address
790
+ if (this.config.queryForIp) {
791
+ this.discoveredP2pIp = this.config.p2pIp;
792
+ this.logger.info('IP change tracking enabled, bridging discv5 IP updates to libp2p AddressManager');
793
+ this.ipChangedHandler = (ip)=>{
794
+ const addressManager = this.node.services.components.addressManager;
795
+ const newAddr = multiaddr(convertToMultiaddr(ip, this.config.p2pPort, 'tcp'));
796
+ const previousIp = this.discoveredP2pIp;
797
+ if (previousIp) {
798
+ const oldAddr = multiaddr(convertToMultiaddr(previousIp, this.config.p2pPort, 'tcp'));
799
+ addressManager.removeObservedAddr(oldAddr);
800
+ this.logger.info('Libp2p announce address updated due to IP change', {
801
+ previousIp,
802
+ newIp: ip,
803
+ newMultiaddr: newAddr.toString()
804
+ });
805
+ } else {
806
+ this.logger.info('Libp2p announce address set from initial discv5 IP discovery', {
807
+ ip,
808
+ multiaddr: newAddr.toString()
809
+ });
810
+ }
811
+ addressManager.addObservedAddr(newAddr);
812
+ addressManager.confirmObservedAddr(newAddr);
813
+ this.discoveredP2pIp = ip;
814
+ };
815
+ this.peerDiscoveryService.on('ip:changed', this.ipChangedHandler);
816
+ }
807
817
  this.discoveryRunningPromise = new RunningPromise(async ()=>{
808
818
  await this.peerManager.heartbeat();
809
819
  }, this.logger, this.config.peerCheckIntervalMS);
@@ -821,6 +831,10 @@ _dec = trackSpan('Libp2pService.processValidBlockProposal', async (block)=>({
821
831
  */ async stop() {
822
832
  // Remove gossip sub listener
823
833
  this.node.services.pubsub.removeEventListener(GossipSubEvent.MESSAGE, this.gossipSubEventHandler);
834
+ if (this.ipChangedHandler) {
835
+ this.peerDiscoveryService.removeListener('ip:changed', this.ipChangedHandler);
836
+ this.ipChangedHandler = undefined;
837
+ }
824
838
  // Stop peer manager
825
839
  this.logger.debug('Stopping peer manager...');
826
840
  await this.peerManager.stop();
@@ -834,8 +848,8 @@ _dec = trackSpan('Libp2pService.processValidBlockProposal', async (block)=>({
834
848
  await this.stopLibP2P();
835
849
  this.logger.info('LibP2P service stopped');
836
850
  }
837
- addReqRespSubProtocol(subProtocol, handler, validator) {
838
- return this.reqresp.addSubProtocol(subProtocol, handler, validator);
851
+ addReqRespSubProtocol(subProtocol, handler) {
852
+ return this.reqresp.addSubProtocol(subProtocol, handler);
839
853
  }
840
854
  registerThisValidatorAddresses(address) {
841
855
  this.peerManager.registerThisValidatorAddresses(address);
@@ -843,6 +857,9 @@ _dec = trackSpan('Libp2pService.processValidBlockProposal', async (block)=>({
843
857
  getPeers(includePending) {
844
858
  return this.peerManager.getPeers(includePending);
845
859
  }
860
+ getGossipMeshPeerCount(topicType) {
861
+ return this.node.services.pubsub.getMeshPeers(this.topicStrings[topicType]).length;
862
+ }
846
863
  handleGossipSubEvent(e) {
847
864
  this.logger.trace(`Received PUBSUB message.`);
848
865
  const safeJob = async ()=>{
@@ -854,13 +871,8 @@ _dec = trackSpan('Libp2pService.processValidBlockProposal', async (block)=>({
854
871
  };
855
872
  setImmediate(()=>void safeJob());
856
873
  }
857
- /**
858
- * Send a batch of requests to peers, and return the responses
859
- * @param protocol - The request response protocol to use
860
- * @param requests - The requests to send to the peers
861
- * @returns The responses to the requests
862
- */ sendBatchRequest(protocol, requests, pinnedPeerId) {
863
- return this.reqresp.sendBatchRequest(protocol, requests, pinnedPeerId);
874
+ sendRequestToPeer(peerId, subProtocol, payload, dialTimeout) {
875
+ return this.reqresp.sendRequestToPeer(peerId, subProtocol, payload, dialTimeout);
864
876
  }
865
877
  /**
866
878
  * Get the ENR of the node
@@ -871,8 +883,27 @@ _dec = trackSpan('Libp2pService.processValidBlockProposal', async (block)=>({
871
883
  registerBlockReceivedCallback(callback) {
872
884
  this.blockReceivedCallback = callback;
873
885
  }
874
- registerCheckpointReceivedCallback(callback) {
875
- this.checkpointReceivedCallback = callback;
886
+ registerValidatorCheckpointReceivedCallback(callback) {
887
+ this.validatorCheckpointReceivedCallback = callback;
888
+ }
889
+ registerAllNodesCheckpointReceivedCallback(callback) {
890
+ this.allNodesCheckpointReceivedCallback = callback;
891
+ }
892
+ /**
893
+ * Registers a callback to be invoked when a duplicate proposal is detected.
894
+ * This callback is triggered on the first duplicate (when count goes from 1 to 2).
895
+ */ registerDuplicateProposalCallback(callback) {
896
+ this.duplicateProposalCallback = callback;
897
+ }
898
+ /**
899
+ * Registers a callback to be invoked when a duplicate attestation is detected.
900
+ * A validator signing attestations for different proposals at the same slot.
901
+ * This callback is triggered on the first duplicate (when count goes from 1 to 2).
902
+ */ registerDuplicateAttestationCallback(callback) {
903
+ this.duplicateAttestationCallback = callback;
904
+ }
905
+ registerCheckpointAttestationCallback(callback) {
906
+ this.checkpointAttestationCallback = callback;
876
907
  }
877
908
  /**
878
909
  * Subscribes to a topic.
@@ -925,6 +956,12 @@ _dec = trackSpan('Libp2pService.processValidBlockProposal', async (block)=>({
925
956
  if (!validator || !validator.addMessage(msgId)) {
926
957
  this.instrumentation.incMessagePrevalidationStatus(false, topicType);
927
958
  this.node.services.pubsub.reportMessageValidationResult(msgId, source.toString(), TopicValidatorResult.Ignore);
959
+ if (topicType === TopicType.tx) {
960
+ this.logger.verbose(`Ignoring already-seen tx gossip message`, {
961
+ msgId,
962
+ source: source.toString()
963
+ });
964
+ }
928
965
  return {
929
966
  result: false,
930
967
  topicType
@@ -982,12 +1019,17 @@ _dec = trackSpan('Libp2pService.processValidBlockProposal', async (block)=>({
982
1019
  }
983
1020
  // Process the message, optionally within a linked span for trace propagation
984
1021
  const processMessage = async ()=>{
1022
+ if (this.config.skipIncomingProposals && (msg.topic === this.topicStrings[TopicType.block_proposal] || msg.topic === this.topicStrings[TopicType.checkpoint_proposal])) {
1023
+ this.logger.warn(`Ignoring incoming proposal (skipIncomingProposals is set)`, {
1024
+ topic: msg.topic
1025
+ });
1026
+ this.node.services.pubsub.reportMessageValidationResult(msgId, source.toString(), TopicValidatorResult.Ignore);
1027
+ return;
1028
+ }
985
1029
  if (msg.topic === this.topicStrings[TopicType.tx]) {
986
1030
  await this.handleGossipedTx(p2pMessage.payload, msgId, source);
987
1031
  } else if (msg.topic === this.topicStrings[TopicType.checkpoint_attestation]) {
988
- if (this.clientType === P2PClientType.Full) {
989
- await this.processCheckpointAttestationFromPeer(p2pMessage.payload, msgId, source);
990
- }
1032
+ await this.processCheckpointAttestationFromPeer(p2pMessage.payload, msgId, source);
991
1033
  } else if (msg.topic === this.topicStrings[TopicType.block_proposal]) {
992
1034
  await this.processBlockFromPeer(p2pMessage.payload, msgId, source);
993
1035
  } else if (msg.topic === this.topicStrings[TopicType.checkpoint_proposal]) {
@@ -1032,49 +1074,162 @@ _dec = trackSpan('Libp2pService.processValidBlockProposal', async (block)=>({
1032
1074
  return;
1033
1075
  }
1034
1076
  async validateReceivedMessage(validationFunc, msgId, source, topicType) {
1077
+ // Default to reject result with a penalty if validation function throws an error
1035
1078
  let resultAndObj = {
1036
- result: TopicValidatorResult.Reject
1079
+ result: TopicValidatorResult.Reject,
1080
+ severity: PeerErrorSeverity.MidToleranceError
1037
1081
  };
1038
1082
  const timer = new Timer();
1039
1083
  try {
1040
1084
  resultAndObj = await validationFunc();
1041
1085
  } catch (err) {
1042
- this.peerManager.penalizePeer(source, PeerErrorSeverity.LowToleranceError);
1043
- this.logger.error(`Error deserializing and validating gossipsub message`, err, {
1086
+ this.logger.error(`Error validating gossipsub message`, err, {
1044
1087
  msgId,
1045
1088
  source: source.toString(),
1046
1089
  topicType
1047
1090
  });
1048
1091
  }
1092
+ const validationTimeMs = timer.ms();
1093
+ const mcacheWindowMs = this.config.gossipsubMcacheLength * this.config.gossipsubInterval;
1094
+ if (validationTimeMs > mcacheWindowMs * 0.75) {
1095
+ this.instrumentation.incSlowValidation(topicType);
1096
+ this.logger.warn(`Gossip validation for ${topicType} took ${validationTimeMs}ms, approaching mcache eviction window of ${mcacheWindowMs}ms. ` + `Message forwarding may be skipped if validation exceeds the window.`, {
1097
+ msgId,
1098
+ source: source.toString(),
1099
+ topicType,
1100
+ validationTimeMs,
1101
+ mcacheWindowMs
1102
+ });
1103
+ }
1049
1104
  if (resultAndObj.result === TopicValidatorResult.Accept) {
1105
+ this.logger.debug(`Message ${topicType} accepted by validator`, {
1106
+ msgId,
1107
+ source: source.toString(),
1108
+ topicType
1109
+ });
1050
1110
  this.instrumentation.recordMessageValidation(topicType, timer);
1111
+ } else if (resultAndObj.result === TopicValidatorResult.Reject) {
1112
+ this.logger.warn(`Message ${topicType} rejected by validator with severity ${resultAndObj.severity}`, {
1113
+ msgId,
1114
+ source: source.toString(),
1115
+ topicType,
1116
+ severity: resultAndObj.severity
1117
+ });
1118
+ this.peerManager.penalizePeer(source, resultAndObj.severity);
1119
+ } else {
1120
+ this.logger.trace(`Message ${topicType} ignored by validator`, {
1121
+ msgId,
1122
+ source: source.toString(),
1123
+ topicType
1124
+ });
1051
1125
  }
1052
1126
  this.node.services.pubsub.reportMessageValidationResult(msgId, source.toString(), resultAndObj.result);
1053
1127
  return resultAndObj;
1054
1128
  }
1129
+ tryDeserialize(deserializeFunc, msgId, source) {
1130
+ try {
1131
+ return deserializeFunc();
1132
+ } catch (err) {
1133
+ this.logger.warn(`Failed to deserialize gossipsub message from buffer`, {
1134
+ err,
1135
+ msgId,
1136
+ source: source.toString()
1137
+ });
1138
+ return undefined;
1139
+ }
1140
+ }
1055
1141
  async handleGossipedTx(payloadData, msgId, source) {
1056
1142
  const validationFunc = async ()=>{
1057
- const tx = Tx.fromBuffer(payloadData);
1058
- const isValid = await this.validatePropagatedTx(tx, source);
1059
- const exists = isValid && await this.mempools.txPool.hasTx(tx.getTxHash());
1060
- this.logger.trace(`Validate propagated tx`, {
1061
- isValid,
1062
- exists,
1143
+ const tx = this.tryDeserialize(()=>Tx.fromBuffer(payloadData), msgId, source);
1144
+ if (!tx) {
1145
+ return {
1146
+ result: TopicValidatorResult.Reject,
1147
+ severity: PeerErrorSeverity.LowToleranceError
1148
+ };
1149
+ }
1150
+ const currentBlockNumber = await this.archiver.getBlockNumber();
1151
+ const { ts: nextSlotTimestamp } = this.epochCache.getEpochAndSlotInNextL1Slot();
1152
+ // Stage 1: fast validators (metadata, data, timestamps, double-spend, gas, phases, block header)
1153
+ const firstStageValidators = await this.createFirstStageMessageValidators(currentBlockNumber, nextSlotTimestamp);
1154
+ const firstStageOutcome = await this.runValidations(tx, firstStageValidators);
1155
+ if (!firstStageOutcome.allPassed) {
1156
+ const { name } = firstStageOutcome.failure;
1157
+ let { severity } = firstStageOutcome.failure;
1158
+ // Double spend validator has a special case handler. We perform more detailed examination
1159
+ // as to how recently the nullifier was entered into the tree and if the transaction should
1160
+ // have 'known' the nullifier existed. This determines the severity of the penalty applied to the peer.
1161
+ if (name === 'doubleSpendValidator') {
1162
+ const txBlockNumber = BlockNumber(currentBlockNumber + 1);
1163
+ severity = await this.handleDoubleSpendFailure(tx, txBlockNumber);
1164
+ }
1165
+ this.logger.verbose(`Rejecting gossiped tx ${tx.getTxHash().toString()}: stage 1 validation failed`, {
1166
+ validator: name,
1167
+ severity,
1168
+ source: source.toString()
1169
+ });
1170
+ return {
1171
+ result: TopicValidatorResult.Reject,
1172
+ severity
1173
+ };
1174
+ }
1175
+ // Pool pre-check: see if the pool would accept this tx before doing expensive proof verification
1176
+ const canAdd = await this.mempools.txPool.canAddPendingTx(tx);
1177
+ if (canAdd === 'ignored') {
1178
+ this.logger.verbose(`Ignoring gossiped tx ${tx.getTxHash().toString()}: pool pre-check returned ignored`, {
1179
+ source: source.toString()
1180
+ });
1181
+ return {
1182
+ result: TopicValidatorResult.Ignore,
1183
+ obj: tx
1184
+ };
1185
+ }
1186
+ // Stage 2: expensive proof verification
1187
+ const secondStageValidators = this.createSecondStageMessageValidators();
1188
+ const secondStageOutcome = await this.runValidations(tx, secondStageValidators);
1189
+ if (!secondStageOutcome.allPassed) {
1190
+ const { severity, name } = secondStageOutcome.failure;
1191
+ this.logger.verbose(`Rejecting gossiped tx ${tx.getTxHash().toString()}: stage 2 validation failed`, {
1192
+ validator: name,
1193
+ severity,
1194
+ source: source.toString()
1195
+ });
1196
+ return {
1197
+ result: TopicValidatorResult.Reject,
1198
+ severity
1199
+ };
1200
+ }
1201
+ // Pool add: persist the tx
1202
+ const txHash = tx.getTxHash();
1203
+ const addResult = await this.mempools.txPool.addPendingTxs([
1204
+ tx
1205
+ ], {
1206
+ source: 'gossip'
1207
+ });
1208
+ const wasAccepted = addResult.accepted.some((h)=>h.equals(txHash));
1209
+ const wasIgnored = addResult.ignored.some((h)=>h.equals(txHash));
1210
+ this.logger.verbose(`Validate propagated tx ${txHash.toString()}`, {
1211
+ wasAccepted,
1212
+ wasIgnored,
1063
1213
  [Attributes.P2P_ID]: source.toString()
1064
1214
  });
1065
- if (!isValid) {
1215
+ if (wasAccepted) {
1066
1216
  return {
1067
- result: TopicValidatorResult.Reject
1217
+ result: TopicValidatorResult.Accept,
1218
+ obj: tx
1068
1219
  };
1069
- } else if (exists) {
1220
+ } else if (wasIgnored) {
1070
1221
  return {
1071
1222
  result: TopicValidatorResult.Ignore,
1072
1223
  obj: tx
1073
1224
  };
1074
1225
  } else {
1226
+ this.logger.warn(`Gossiped tx ${txHash.toString()} unexpectedly rejected by pool`, {
1227
+ source: source.toString(),
1228
+ txHash: txHash.toString()
1229
+ });
1075
1230
  return {
1076
- result: TopicValidatorResult.Accept,
1077
- obj: tx
1231
+ result: TopicValidatorResult.Reject,
1232
+ severity: PeerErrorSeverity.HighToleranceError
1078
1233
  };
1079
1234
  }
1080
1235
  };
@@ -1082,131 +1237,200 @@ _dec = trackSpan('Libp2pService.processValidBlockProposal', async (block)=>({
1082
1237
  if (result !== TopicValidatorResult.Accept || !tx) {
1083
1238
  return;
1084
1239
  }
1240
+ // Tx was accepted into pool and will be propagated - just log and record metrics
1085
1241
  const txHash = tx.getTxHash();
1086
1242
  const txHashString = txHash.toString();
1087
1243
  this.logger.verbose(`Received tx ${txHashString} from external peer ${source.toString()} via gossip`, {
1088
1244
  source: source.toString(),
1089
1245
  txHash: txHashString
1090
1246
  });
1091
- if (this.config.dropTransactions && randomInt(1000) < this.config.dropTransactionsProbability * 1000) {
1092
- this.logger.warn(`Intentionally dropping tx ${txHashString} (probability rule)`);
1093
- return;
1094
- }
1095
1247
  this.instrumentation.incrementTxReceived(1);
1096
- await this.mempools.txPool.addTxs([
1097
- tx
1098
- ]);
1099
1248
  }
1100
1249
  /**
1101
1250
  * Process a checkpoint attestation from a peer.
1102
1251
  * Validates the attestation and adds it to the pool.
1103
1252
  */ async processCheckpointAttestationFromPeer(payloadData, msgId, source) {
1104
- const validationFunc = async ()=>{
1105
- const attestation = CheckpointAttestation.fromBuffer(payloadData);
1106
- const pool = this.mempools.attestationPool;
1107
- const isValid = await this.validateCheckpointAttestation(source, attestation);
1108
- const exists = isValid && await pool.hasCheckpointAttestation(attestation);
1109
- let canAdd = true;
1110
- if (isValid && !exists) {
1111
- const slot = attestation.payload.header.slotNumber;
1112
- const { committee } = await this.epochCache.getCommittee(slot);
1113
- const committeeSize = committee?.length ?? 0;
1114
- canAdd = await pool.canAddCheckpointAttestation(attestation, committeeSize);
1115
- }
1116
- this.logger.trace(`Validate propagated checkpoint attestation`, {
1117
- isValid,
1118
- exists,
1119
- canAdd,
1120
- [Attributes.SLOT_NUMBER]: attestation.payload.header.slotNumber.toString(),
1121
- [Attributes.P2P_ID]: source.toString()
1122
- });
1123
- if (!isValid) {
1124
- return {
1125
- result: TopicValidatorResult.Reject
1126
- };
1127
- } else if (exists) {
1128
- return {
1129
- result: TopicValidatorResult.Ignore,
1130
- obj: attestation
1131
- };
1132
- } else if (!canAdd) {
1133
- this.logger.warn(`Dropping checkpoint attestation due to per-(slot, proposalId) attestation cap`, {
1134
- slot: attestation.payload.header.slotNumber.toString(),
1135
- archive: attestation.archive.toString(),
1136
- source: source.toString()
1253
+ const { result, obj: attestation } = await this.validateReceivedMessage(()=>{
1254
+ const attestation = this.tryDeserialize(()=>CheckpointAttestation.fromBuffer(payloadData), msgId, source);
1255
+ if (!attestation) {
1256
+ return Promise.resolve({
1257
+ result: TopicValidatorResult.Reject,
1258
+ severity: PeerErrorSeverity.LowToleranceError
1137
1259
  });
1138
- return {
1139
- result: TopicValidatorResult.Ignore,
1140
- obj: attestation
1141
- };
1142
- } else {
1143
- return {
1144
- result: TopicValidatorResult.Accept,
1145
- obj: attestation
1146
- };
1147
1260
  }
1148
- };
1149
- const { result, obj: attestation } = await this.validateReceivedMessage(validationFunc, msgId, source, TopicType.checkpoint_attestation);
1261
+ return this.validateAndStoreCheckpointAttestation(source, attestation);
1262
+ }, msgId, source, TopicType.checkpoint_attestation);
1150
1263
  if (result !== TopicValidatorResult.Accept || !attestation) {
1151
1264
  return;
1152
1265
  }
1153
- this.logger.debug(`Received checkpoint attestation for slot ${attestation.slotNumber} from external peer ${source.toString()}`, {
1266
+ this.logger.verbose(`Received valid checkpoint attestation for slot ${attestation.slotNumber} from external peer ${source.toString()}`, {
1154
1267
  p2pMessageIdentifier: await attestation.p2pMessageLoggingIdentifier(),
1155
1268
  slot: attestation.slotNumber,
1156
1269
  archive: attestation.archive.toString(),
1157
1270
  source: source.toString()
1158
1271
  });
1159
- await this.mempools.attestationPool.addCheckpointAttestations([
1160
- attestation
1161
- ]);
1162
1272
  }
1163
- async processBlockFromPeer(payloadData, msgId, source) {
1164
- const validationFunc = async ()=>{
1165
- const block = BlockProposal.fromBuffer(payloadData);
1166
- const isValid = await this.validateBlockProposal(source, block);
1167
- const pool = this.mempools.attestationPool;
1168
- const exists = isValid && await pool.hasBlockProposal(block);
1169
- const canAdd = isValid && await pool.canAddProposal(block);
1170
- this.logger.trace(`Validate propagated block proposal`, {
1171
- isValid,
1172
- exists,
1173
- canAdd,
1174
- [Attributes.SLOT_NUMBER]: block.slotNumber.toString(),
1175
- [Attributes.P2P_ID]: source.toString()
1273
+ /** Validates a checkpoint attestation and adds it to the pool. Penalizes the peer if validation fails. */ async validateAndStoreCheckpointAttestation(peerId, attestation) {
1274
+ const validationResult = await this.checkpointAttestationValidator.validate(attestation);
1275
+ if (validationResult.result === 'reject') {
1276
+ this.logger.warn(`Penalizing peer ${peerId} for checkpoint attestation validation failure`);
1277
+ return {
1278
+ result: TopicValidatorResult.Reject,
1279
+ severity: validationResult.severity
1280
+ };
1281
+ }
1282
+ if (validationResult.result === 'ignore') {
1283
+ return {
1284
+ result: TopicValidatorResult.Ignore,
1285
+ obj: attestation
1286
+ };
1287
+ }
1288
+ // Try to add the attestation: this handles existence check, cap check, and adding in one call
1289
+ // count is the number of attestations by this signer for this slot (for duplicate detection)
1290
+ const slot = attestation.payload.header.slotNumber;
1291
+ const { added, alreadyExists, count } = await this.mempools.attestationPool.tryAddCheckpointAttestation(attestation);
1292
+ this.logger.trace(`Validate propagated checkpoint attestation`, {
1293
+ added,
1294
+ alreadyExists,
1295
+ count,
1296
+ [Attributes.SLOT_NUMBER]: slot.toString(),
1297
+ [Attributes.P2P_ID]: peerId.toString()
1298
+ });
1299
+ // Exact same attestation received, no need to re-broadcast
1300
+ if (alreadyExists) {
1301
+ return {
1302
+ result: TopicValidatorResult.Ignore,
1303
+ obj: attestation
1304
+ };
1305
+ }
1306
+ // Could not add (cap reached for signer), penalize and do not re-broadcast
1307
+ if (!added) {
1308
+ this.logger.warn(`Rejecting checkpoint attestation due to cap`, {
1309
+ slot: slot.toString(),
1310
+ archive: attestation.archive.toString(),
1311
+ source: peerId.toString(),
1312
+ attester: attestation.getSender()?.toString(),
1313
+ count
1176
1314
  });
1177
- if (!isValid) {
1178
- return {
1179
- result: TopicValidatorResult.Reject
1180
- };
1181
- } else if (exists) {
1182
- return {
1183
- result: TopicValidatorResult.Ignore,
1184
- obj: block
1185
- };
1186
- } else if (!canAdd) {
1187
- this.peerManager.penalizePeer(source, PeerErrorSeverity.MidToleranceError);
1188
- this.logger.warn(`Penalizing peer for block proposal exceeding per-slot cap`, {
1189
- slot: block.slotNumber.toString(),
1190
- archive: block.archive.toString(),
1191
- source: source.toString()
1315
+ return {
1316
+ result: TopicValidatorResult.Reject,
1317
+ severity: PeerErrorSeverity.HighToleranceError
1318
+ };
1319
+ }
1320
+ // Check if this is a duplicate attestation (signer attested to a different proposal at the same slot)
1321
+ // count is the number of attestations by this signer for this slot
1322
+ if (count === 2) {
1323
+ const attester = attestation.getSender();
1324
+ if (attester) {
1325
+ this.logger.warn(`Detected duplicate attestation (equivocation) at slot ${slot}`, {
1326
+ slot: slot.toString(),
1327
+ archive: attestation.archive.toString(),
1328
+ source: peerId.toString(),
1329
+ attester: attester.toString()
1330
+ });
1331
+ this.duplicateAttestationCallback?.({
1332
+ slot,
1333
+ attester
1192
1334
  });
1193
- return {
1194
- result: TopicValidatorResult.Reject
1195
- };
1196
- } else {
1197
- return {
1198
- result: TopicValidatorResult.Accept,
1199
- obj: block
1200
- };
1201
1335
  }
1336
+ }
1337
+ // Attestation was added successfully - accept it so other nodes can also detect the equivocation
1338
+ this.checkpointAttestationCallback?.(attestation);
1339
+ return {
1340
+ result: TopicValidatorResult.Accept,
1341
+ obj: attestation
1202
1342
  };
1203
- const { result, obj: block } = await this.validateReceivedMessage(validationFunc, msgId, source, TopicType.block_proposal);
1204
- if (!result || !block) {
1343
+ }
1344
+ async processBlockFromPeer(payloadData, msgId, source) {
1345
+ const { result, obj: block, metadata: { isEquivocated } = {} } = await this.validateReceivedMessage(()=>this.validateAndStoreBlockProposal(source, BlockProposal.fromBuffer(payloadData)), msgId, source, TopicType.block_proposal);
1346
+ // If not accepted or equivocated, return
1347
+ if (result !== TopicValidatorResult.Accept || !block || isEquivocated) {
1205
1348
  return;
1206
1349
  }
1207
1350
  await this.processValidBlockProposal(block, source);
1208
1351
  }
1209
- // REVIEW: callback pattern https://github.com/AztecProtocol/aztec-packages/issues/7963
1352
+ /** Validates a block proposal. Triggers a penalization to the peer that sent it if invalid. Adds to the mempool if valid. */ async validateAndStoreBlockProposal(peerId, block) {
1353
+ const validationResult = await this.blockProposalValidator.validate(block);
1354
+ if (validationResult.result === 'reject') {
1355
+ this.logger.warn(`Penalizing peer ${peerId} for block proposal validation failure`);
1356
+ return {
1357
+ result: TopicValidatorResult.Reject,
1358
+ severity: validationResult.severity
1359
+ };
1360
+ }
1361
+ if (validationResult.result === 'ignore') {
1362
+ return {
1363
+ result: TopicValidatorResult.Ignore,
1364
+ obj: block
1365
+ };
1366
+ }
1367
+ // Try to add the proposal: this handles existence check, cap check, and adding in one call
1368
+ const { added, alreadyExists, count } = await this.mempools.attestationPool.tryAddBlockProposal(block);
1369
+ const isEquivocated = count !== undefined && count > 1;
1370
+ // Duplicate proposal received, no need to re-broadcast
1371
+ if (alreadyExists) {
1372
+ this.logger.debug(`Ignoring duplicate block proposal received`, {
1373
+ ...block.toBlockInfo(),
1374
+ indexWithinCheckpoint: block.indexWithinCheckpoint,
1375
+ proposer: block.getSender()?.toString(),
1376
+ source: peerId.toString()
1377
+ });
1378
+ return {
1379
+ result: TopicValidatorResult.Ignore,
1380
+ obj: block,
1381
+ metadata: {
1382
+ isEquivocated
1383
+ }
1384
+ };
1385
+ }
1386
+ // Too many blocks received for this slot and index, penalize peer and do not re-broadcast
1387
+ if (!added) {
1388
+ this.logger.warn(`Penalizing peer for block proposal exceeding per-position cap`, {
1389
+ ...block.toBlockInfo(),
1390
+ indexWithinCheckpoint: block.indexWithinCheckpoint,
1391
+ count,
1392
+ proposer: block.getSender()?.toString(),
1393
+ source: peerId.toString()
1394
+ });
1395
+ return {
1396
+ result: TopicValidatorResult.Reject,
1397
+ metadata: {
1398
+ isEquivocated
1399
+ },
1400
+ severity: PeerErrorSeverity.HighToleranceError
1401
+ };
1402
+ }
1403
+ // If this was a duplicate proposal, do not process it, but do invoke the duplicate callback,
1404
+ // and do re-broadcast it so other nodes in the network know to slash the proposer
1405
+ if (isEquivocated) {
1406
+ const proposer = block.getSender();
1407
+ this.logger.warn(`Detected duplicate block proposal (equivocation) at slot ${block.slotNumber}`, {
1408
+ ...block.toBlockInfo(),
1409
+ source: peerId.toString(),
1410
+ proposer: proposer?.toString()
1411
+ });
1412
+ // Invoke the duplicate callback on the first duplicate spotted only
1413
+ if (proposer && count === 2) {
1414
+ this.duplicateProposalCallback?.({
1415
+ slot: block.slotNumber,
1416
+ proposer,
1417
+ type: 'block'
1418
+ });
1419
+ }
1420
+ return {
1421
+ result: TopicValidatorResult.Accept,
1422
+ obj: block,
1423
+ metadata: {
1424
+ isEquivocated
1425
+ }
1426
+ };
1427
+ }
1428
+ // Otherwise, we're good to go!
1429
+ return {
1430
+ result: TopicValidatorResult.Accept,
1431
+ obj: block
1432
+ };
1433
+ }
1210
1434
  // REFACTOR(palla): This method should be moved to the p2p_client or to a separate component,
1211
1435
  // should not be here as it does not deal with p2p networking.
1212
1436
  async processValidBlockProposal(block, sender) {
@@ -1216,84 +1440,159 @@ _dec = trackSpan('Libp2pService.processValidBlockProposal', async (block)=>({
1216
1440
  source: sender.toString(),
1217
1441
  ...block.toBlockInfo()
1218
1442
  });
1219
- // Attempt to add proposal
1220
- try {
1221
- await this.mempools.attestationPool.addBlockProposal(block);
1222
- } catch (err) {
1223
- // Drop proposals if we hit per-slot cap in the attestation pool; rethrow unknown errors
1224
- if (err instanceof ProposalSlotCapExceededError) {
1225
- this.logger.warn(`Dropping block proposal due to per-slot proposal cap`, {
1226
- slot: String(slot),
1227
- archive: block.archive.toString(),
1228
- error: err.message
1229
- });
1230
- return;
1231
- }
1232
- throw err;
1233
- }
1234
- // Mark the txs in this proposal as non-evictable
1235
- await this.mempools.txPool.markTxsAsNonEvictable(block.txHashes);
1443
+ // Mark the txs in this proposal as protected
1444
+ await this.mempools.txPool.protectTxs(block.txHashes, block.blockHeader);
1236
1445
  // Call the block received callback to validate the proposal.
1237
1446
  // Note: Validators do NOT attest to individual blocks, only to checkpoint proposals.
1238
1447
  const isValid = await this.blockReceivedCallback(block, sender);
1239
1448
  if (!isValid) {
1240
- this.logger.warn(`Block proposal validation failed for block ${block.blockNumber}`, block.toBlockInfo());
1449
+ this.logger.info(`Block proposal validation failed for block ${block.blockNumber}`, block.toBlockInfo());
1241
1450
  }
1242
1451
  }
1243
1452
  /**
1244
1453
  * Handle a gossiped checkpoint proposal.
1245
1454
  * Validates and processes the checkpoint proposal, then triggers the callback for attestation.
1246
1455
  */ async handleGossipedCheckpointProposal(payloadData, msgId, source) {
1247
- // TODO(palla/mbps): This pattern is repeated across multiple message handlers, consider abstracting it.
1248
- const validationFunc = async ()=>{
1249
- const checkpoint = CheckpointProposal.fromBuffer(payloadData);
1250
- const isValid = await this.validateCheckpointProposal(source, checkpoint);
1251
- const pool = this.mempools.attestationPool;
1252
- const exists = isValid && await pool.hasCheckpointProposal(checkpoint);
1253
- const canAdd = isValid && await pool.canAddCheckpointProposal(checkpoint);
1254
- this.logger.trace(`Validate propagated checkpoint proposal`, {
1255
- isValid,
1256
- exists,
1257
- canAdd,
1456
+ const { result, obj: checkpoint, metadata: { isEquivocated, processBlock } = {} } = await this.validateReceivedMessage(()=>this.validateAndStoreCheckpointProposal(source, CheckpointProposal.fromBuffer(payloadData)), msgId, source, TopicType.checkpoint_proposal);
1457
+ // Process checkpoint proposal if valid and not equivocated.
1458
+ const processCheckpointFn = ()=>result === TopicValidatorResult.Accept && checkpoint && !isEquivocated ? this.processValidCheckpointProposal(checkpoint.toCore(), source) : Promise.resolve();
1459
+ // If the checkpoint contained a valid last block, we process it even if the checkpoint itself is to be rejected
1460
+ // TODO(palla/mbps): Is this ok? Should we be considering a block from a checkpoint that was equivocated?
1461
+ const processBlockFn = ()=>processBlock && checkpoint && checkpoint.getBlockProposal() ? this.processValidBlockProposal(checkpoint.getBlockProposal(), source) : Promise.resolve();
1462
+ // A node that skips checkpoint validation attests without re-executing the embedded last block, so run
1463
+ // the checkpoint callback first: this creates and broadcasts the attestation before the block is
1464
+ // processed. Otherwise the block's re-execution — which can stall until the re-execution deadline
1465
+ // waiting for a parent that may never arrive — would delay the attestation past the slot's attestation
1466
+ // window, after which peers reject it as stale.
1467
+ if (this.config.skipCheckpointProposalValidation) {
1468
+ await processCheckpointFn();
1469
+ await processBlockFn();
1470
+ return;
1471
+ }
1472
+ // Process the block first, since it's required for the checkpoint proposal validation.
1473
+ await processBlockFn();
1474
+ await processCheckpointFn();
1475
+ }
1476
+ /**
1477
+ * Validates a checkpoint proposal. Penalizes peer if validation fails. Adds the checkpoint and
1478
+ * its last block (if present) to the mempool if valid. Triggers equivocation detection on both.
1479
+ */ async validateAndStoreCheckpointProposal(peerId, checkpoint) {
1480
+ const validationResult = await this.checkpointProposalValidator.validate(checkpoint);
1481
+ if (validationResult.result === 'reject') {
1482
+ this.logger.warn(`Penalizing peer ${peerId} for checkpoint proposal validation failure`);
1483
+ return {
1484
+ result: TopicValidatorResult.Reject,
1485
+ severity: validationResult.severity
1486
+ };
1487
+ }
1488
+ if (validationResult.result === 'ignore') {
1489
+ return {
1490
+ result: TopicValidatorResult.Ignore,
1491
+ obj: checkpoint
1492
+ };
1493
+ }
1494
+ // Extract and try to add the block proposal first if present
1495
+ const blockProposal = checkpoint.getBlockProposal();
1496
+ let processBlock = false;
1497
+ if (blockProposal) {
1498
+ this.logger.debug(`Validating block proposal from propagated checkpoint`, {
1258
1499
  [Attributes.SLOT_NUMBER]: checkpoint.slotNumber.toString(),
1259
- [Attributes.P2P_ID]: source.toString()
1500
+ [Attributes.P2P_ID]: peerId.toString()
1260
1501
  });
1261
- if (!isValid) {
1262
- return {
1263
- result: TopicValidatorResult.Reject
1264
- };
1265
- } else if (exists) {
1266
- return {
1267
- result: TopicValidatorResult.Ignore,
1268
- obj: checkpoint
1269
- };
1270
- } else if (!canAdd) {
1271
- this.peerManager.penalizePeer(source, PeerErrorSeverity.MidToleranceError);
1272
- this.logger.warn(`Penalizing peer for checkpoint proposal exceeding per-slot cap`, {
1273
- slot: checkpoint.slotNumber.toString(),
1274
- archive: checkpoint.archive.toString(),
1275
- source: source.toString()
1502
+ const blockProposalResult = await this.validateAndStoreBlockProposal(peerId, blockProposal);
1503
+ const { obj, metadata: { isEquivocated } = {} } = blockProposalResult;
1504
+ if (blockProposalResult.result === TopicValidatorResult.Reject || !obj || isEquivocated) {
1505
+ this.logger.debug(`Rejecting checkpoint due to invalid last block proposal`, {
1506
+ [Attributes.SLOT_NUMBER]: checkpoint.slotNumber.toString(),
1507
+ [Attributes.P2P_ID]: peerId.toString(),
1508
+ isEquivocated,
1509
+ result: blockProposalResult.result
1276
1510
  });
1277
1511
  return {
1278
- result: TopicValidatorResult.Reject
1279
- };
1280
- } else {
1281
- return {
1282
- result: TopicValidatorResult.Accept,
1283
- obj: checkpoint
1512
+ result: TopicValidatorResult.Reject,
1513
+ severity: 'severity' in blockProposalResult ? blockProposalResult.severity : PeerErrorSeverity.MidToleranceError
1284
1514
  };
1515
+ } else if (blockProposalResult.result === TopicValidatorResult.Accept && obj && !isEquivocated) {
1516
+ processBlock = true;
1285
1517
  }
1286
- };
1287
- const { result, obj: checkpoint } = await this.validateReceivedMessage(validationFunc, msgId, source, TopicType.checkpoint_proposal);
1288
- if (result !== TopicValidatorResult.Accept || !checkpoint) {
1289
- return;
1290
1518
  }
1291
- await this.processValidCheckpointProposal(checkpoint, source);
1519
+ // Try to add the checkpoint proposal core: this handles existence check, cap check, and adding in one call
1520
+ const checkpointCore = checkpoint.toCore();
1521
+ const tryAddResult = await this.mempools.attestationPool.tryAddCheckpointProposal(checkpointCore);
1522
+ const { added, alreadyExists, count } = tryAddResult;
1523
+ const isEquivocated = count !== undefined && count > 1;
1524
+ // Duplicate proposal received, do not re-broadcast
1525
+ if (alreadyExists) {
1526
+ this.logger.debug(`Ignoring duplicate checkpoint proposal received`, {
1527
+ ...checkpoint.toCheckpointInfo(),
1528
+ source: peerId.toString()
1529
+ });
1530
+ return {
1531
+ result: TopicValidatorResult.Ignore,
1532
+ obj: checkpoint,
1533
+ metadata: {
1534
+ isEquivocated,
1535
+ processBlock
1536
+ }
1537
+ };
1538
+ }
1539
+ // Too many checkpoint proposals received for this slot, penalize peer and do not re-broadcast
1540
+ // Note: We still return the checkpoint obj so the lastBlock can be processed if valid
1541
+ if (!added) {
1542
+ this.logger.warn(`Penalizing peer for checkpoint proposal exceeding per-slot cap`, {
1543
+ ...checkpoint.toCheckpointInfo(),
1544
+ count,
1545
+ source: peerId.toString()
1546
+ });
1547
+ return {
1548
+ result: TopicValidatorResult.Reject,
1549
+ obj: checkpoint,
1550
+ metadata: {
1551
+ isEquivocated,
1552
+ processBlock
1553
+ },
1554
+ severity: PeerErrorSeverity.HighToleranceError
1555
+ };
1556
+ }
1557
+ // If this was a duplicate proposal, do not process it, but do invoke the duplicate callback,
1558
+ // and do re-broadcast it so other nodes in the network know to slash the proposer
1559
+ if (isEquivocated) {
1560
+ const proposer = checkpoint.getSender();
1561
+ this.logger.warn(`Detected duplicate checkpoint proposal (equivocation) at slot ${checkpoint.slotNumber}`, {
1562
+ ...checkpoint.toCheckpointInfo(),
1563
+ source: peerId.toString(),
1564
+ proposer: proposer?.toString()
1565
+ });
1566
+ // Invoke the duplicate callback on the first duplicate spotted only
1567
+ if (proposer && count === 2) {
1568
+ this.duplicateProposalCallback?.({
1569
+ slot: checkpoint.slotNumber,
1570
+ proposer,
1571
+ type: 'checkpoint'
1572
+ });
1573
+ }
1574
+ return {
1575
+ result: TopicValidatorResult.Accept,
1576
+ obj: checkpoint,
1577
+ metadata: {
1578
+ isEquivocated,
1579
+ processBlock
1580
+ }
1581
+ };
1582
+ }
1583
+ // Otherwise, we're good to go!
1584
+ return {
1585
+ result: TopicValidatorResult.Accept,
1586
+ obj: checkpoint,
1587
+ metadata: {
1588
+ processBlock,
1589
+ isEquivocated
1590
+ }
1591
+ };
1292
1592
  }
1293
1593
  /**
1294
1594
  * Process a validated checkpoint proposal.
1295
- * Extracts and processes the last block proposal (if present) first, then processes the checkpoint.
1296
- * The block callback is invoked before the checkpoint callback.
1595
+ * Note: The proposal was already added to the pool by tryAddCheckpointProposal in handleGossipedCheckpointProposal.
1297
1596
  */ async processValidCheckpointProposal(checkpoint, sender) {
1298
1597
  const slot = checkpoint.slotNumber;
1299
1598
  this.logger.verbose(`Received checkpoint proposal for slot ${slot} from external peer ${sender.toString()}.`, {
@@ -1302,33 +1601,13 @@ _dec = trackSpan('Libp2pService.processValidBlockProposal', async (block)=>({
1302
1601
  archive: checkpoint.archive.toString(),
1303
1602
  source: sender.toString()
1304
1603
  });
1305
- // Extract block proposal before adding to pool (pool stores them separately)
1306
- const blockProposal = checkpoint.getBlockProposal();
1307
- // Add proposal to the pool (this extracts and stores block proposal separately)
1308
- await this.mempools.attestationPool.addCheckpointProposal(checkpoint);
1309
- // Mark txs as non-evictable if present (from the last block)
1310
- if (checkpoint.txHashes.length > 0) {
1311
- await this.mempools.txPool.markTxsAsNonEvictable(checkpoint.txHashes);
1312
- }
1313
- // If there was a last block proposal, invoke the block callback first for validation.
1314
- // Note: The block proposal is already stored in the pool by addCheckpointProposal.
1315
- if (blockProposal) {
1316
- const isValid = await this.blockReceivedCallback(blockProposal, sender);
1317
- if (!isValid) {
1318
- this.logger.warn(`Block proposal from checkpoint failed validation`, {
1319
- slot: slot.toString(),
1320
- archive: checkpoint.archive.toString(),
1321
- blockNumber: blockProposal.blockNumber.toString()
1322
- });
1323
- return;
1324
- }
1325
- }
1604
+ await this.allNodesCheckpointReceivedCallback(checkpoint, sender);
1326
1605
  // Call the checkpoint received callback with the core version (without lastBlock)
1327
1606
  // to validate and potentially generate attestations
1328
- const attestations = await this.checkpointReceivedCallback(checkpoint.toCore(), sender);
1607
+ const attestations = await this.validatorCheckpointReceivedCallback(checkpoint, sender);
1329
1608
  if (attestations && attestations.length > 0) {
1330
1609
  // If the callback returned attestations, add them to the pool and propagate them
1331
- await this.mempools.attestationPool.addCheckpointAttestations(attestations);
1610
+ await this.mempools.attestationPool.addOwnCheckpointAttestations(attestations);
1332
1611
  for (const attestation of attestations){
1333
1612
  await this.propagate(attestation);
1334
1613
  }
@@ -1349,17 +1628,26 @@ _dec = trackSpan('Libp2pService.processValidBlockProposal', async (block)=>({
1349
1628
  });
1350
1629
  }
1351
1630
  /**
1352
- * Validate the requested block transactions. Allow partial returns.
1631
+ * Validate the requested block transactions request-response consistency.
1632
+ * It does NOT validate the transactions themselves.
1353
1633
  * @param request - The block transactions request.
1354
1634
  * @param response - The block transactions response.
1355
1635
  * @param peerId - The ID of the peer that made the request.
1356
- * @returns True if the requested block transactions are valid, false otherwise.
1357
- */ async validateRequestedBlockTxs(request, response, peerId) {
1358
- const requestedTxValidator = this.createRequestedTxValidator();
1636
+ * @returns True if the request-response is consistent, false otherwise.
1637
+ */ async validateRequestedBlockTxsConsistency(request, response, peerId) {
1359
1638
  try {
1360
- if (!response.blockHash.equals(request.blockHash)) {
1639
+ // A response with archiveRoot=Fr.zero is the documented "I don't have the block" signal from
1640
+ // reqRespBlockTxsHandler (block_txs_handler.ts:54-58): the peer lacked the block in its
1641
+ // attestation pool and archiver, but matched the requested hashes against its tx pool and
1642
+ // shipped what it found. This is legitimate behaviour, not misbehaviour — we just can't verify
1643
+ // membership/order without the block, so we drop the response without penalising the peer.
1644
+ if (response.archiveRoot.isZero()) {
1645
+ this.logger.debug(`Peer ${peerId.toString()} signalled missing block with Fr.zero archive root`);
1646
+ return false;
1647
+ }
1648
+ if (!response.archiveRoot.equals(request.archiveRoot)) {
1361
1649
  this.peerManager.penalizePeer(peerId, PeerErrorSeverity.MidToleranceError);
1362
- throw new ValidationError(`Received block txs for unexpected block: expected ${request.blockHash.toString()}, got ${response.blockHash.toString()}`);
1650
+ throw new ValidationError(`Received block txs for unexpected archive root: expected ${request.archiveRoot.toString()}, got ${response.archiveRoot.toString()}`);
1363
1651
  }
1364
1652
  if (response.txIndices.getLength() !== request.txIndices.getLength()) {
1365
1653
  this.peerManager.penalizePeer(peerId, PeerErrorSeverity.MidToleranceError);
@@ -1381,18 +1669,25 @@ _dec = trackSpan('Libp2pService.processValidBlockProposal', async (block)=>({
1381
1669
  this.peerManager.penalizePeer(peerId, PeerErrorSeverity.MidToleranceError);
1382
1670
  throw new ValidationError(`Received more txs (${response.txs.length}) than requested-and-available (${maxReturnable})`);
1383
1671
  }
1384
- // Given proposal (should have locally), ensure returned txs are valid subset and match request indices
1385
- const proposal = await this.mempools.attestationPool.getBlockProposal(request.blockHash.toString());
1386
- if (proposal) {
1672
+ // To verify membership/order of the returned txs we need the canonical tx hash list for the
1673
+ // block. Prefer the block proposal (held while a block is in flight), but fall back to the
1674
+ // archiver for blocks we only know as mined — e.g. a prover collecting txs to prove a block it
1675
+ // never received a proposal for. This mirrors the responder side (reqRespBlockTxsHandler),
1676
+ // which serves from proposal-or-archiver.
1677
+ const proposal = await this.mempools.attestationPool.getBlockProposalByArchive(request.archiveRoot.toString());
1678
+ const blockTxHashes = proposal?.txHashes ?? (await this.archiver.getBlock({
1679
+ archive: request.archiveRoot
1680
+ }))?.body.txEffects.map((e)=>e.txHash);
1681
+ if (blockTxHashes) {
1387
1682
  // Build intersected indices
1388
1683
  const intersectIdx = request.txIndices.getTrueIndices().filter((i)=>response.txIndices.isSet(i));
1389
1684
  // Enforce subset membership and preserve increasing order by index.
1390
- const hashToIndexInProposal = new Map(proposal.txHashes.map((h, i)=>[
1685
+ const hashToIndexInBlock = new Map(blockTxHashes.map((h, i)=>[
1391
1686
  h.toString(),
1392
1687
  i
1393
1688
  ]));
1394
1689
  const allowedIndexSet = new Set(intersectIdx);
1395
- const indices = returnedHashes.map((h)=>hashToIndexInProposal.get(h));
1690
+ const indices = returnedHashes.map((h)=>hashToIndexInBlock.get(h));
1396
1691
  const allAllowed = indices.every((idx)=>idx !== undefined && allowedIndexSet.has(idx));
1397
1692
  const strictlyIncreasing = indices.every((idx, i)=>i === 0 ? idx !== undefined : idx > indices[i - 1]);
1398
1693
  if (!allAllowed || !strictlyIncreasing) {
@@ -1400,11 +1695,11 @@ _dec = trackSpan('Libp2pService.processValidBlockProposal', async (block)=>({
1400
1695
  throw new ValidationError('Returned txs do not match expected subset/order for requested indices');
1401
1696
  }
1402
1697
  } else {
1403
- // No local proposal, cannot check the membership/order of the returned txs
1404
- this.logger.warn(`Block proposal not found for block hash ${request.blockHash.toString()}; cannot validate membership/order of returned txs`);
1698
+ // Neither a local proposal nor an archived block: we cannot verify membership/order of the
1699
+ // returned txs. This is a local-state gap, not a peer fault, so we do not penalize.
1700
+ this.logger.warn(`Block ${request.archiveRoot.toString()} not found in attestation pool or archiver; cannot validate membership/order of returned txs`);
1405
1701
  return false;
1406
1702
  }
1407
- await Promise.all(response.txs.map((tx)=>this.validateRequestedTx(tx, peerId, requestedTxValidator)));
1408
1703
  return true;
1409
1704
  } catch (e) {
1410
1705
  if (e instanceof ValidationError) {
@@ -1415,165 +1710,54 @@ _dec = trackSpan('Libp2pService.processValidBlockProposal', async (block)=>({
1415
1710
  return false;
1416
1711
  }
1417
1712
  }
1418
- /**
1419
- * Validate a collection of txs that has been requested from a peer.
1420
- *
1421
- * The core component of this validator is that each tx hash MUST match the requested tx hash,
1422
- * In order to perform this check, the tx proof must be verified.
1423
- *
1424
- * Note: This function is called from within `ReqResp.sendRequest` as part of the
1425
- * ReqRespSubProtocol.TX subprotocol validation.
1426
- *
1427
- * @param requestedTxHash - The collection of the txs that was requested.
1428
- * @param responseTx - The collection of txs that was received as a response to the request.
1429
- * @param peerId - The peer ID of the peer that sent the tx.
1430
- * @returns True if the whole collection of txs is valid, false otherwise.
1431
- */ async validateRequestedTxs(requestedTxHash, responseTx, peerId) {
1432
- const requested = new Set(requestedTxHash.map((h)=>h.toString()));
1433
- const requestedTxValidator = this.createRequestedTxValidator();
1434
- //TODO: (mralj) - this is somewhat naive implementation, if single tx is invlid we consider the whole response invalid.
1435
- // I think we should still extract the valid txs and return them, so that we can still use the response.
1436
- try {
1437
- await Promise.all(responseTx.map((tx)=>this.validateRequestedTx(tx, peerId, requestedTxValidator, requested)));
1438
- return true;
1439
- } catch (e) {
1440
- if (e instanceof ValidationError) {
1441
- this.logger.warn(`Failed to validate requested txs from peer ${peerId.toString()}, reason ${e.message}`);
1442
- } else {
1443
- this.logger.error(`Error during validation of requested txs`, e);
1444
- }
1445
- return false;
1446
- }
1713
+ getGasFees() {
1714
+ return this.blockMinFeesProvider.getCurrentMinFees();
1447
1715
  }
1448
1716
  /**
1449
- * Validates a BLOCK response.
1450
- *
1451
- * If a local copy exists, enforces hash equality. If missing, rejects (no penalty) since the hash cannot be verified.
1452
- * Penalizes on block number mismatch or hash mismatch.
1453
- *
1454
- * @param requestedBlockNumber - The requested block number.
1455
- * @param responseBlock - The block returned by the peer.
1456
- * @param peerId - The peer that returned the block.
1457
- * @returns True if the response is valid, false otherwise.
1458
- */ async validateRequestedBlock(requestedBlockNumber, responseBlock, peerId) {
1459
- try {
1460
- const reqNum = Number(requestedBlockNumber.toString());
1461
- if (responseBlock.number !== reqNum) {
1462
- this.peerManager.penalizePeer(peerId, PeerErrorSeverity.LowToleranceError);
1463
- return false;
1464
- }
1465
- const local = await this.archiver.getBlock(BlockNumber(reqNum));
1466
- if (!local) {
1467
- // We are missing the local block; we cannot verify the hash yet. Reject without penalizing.
1468
- // TODO: Consider extending this validator to accept an expected hash or
1469
- // performing quorum-based checks when using P2P syncing prior to L1 sync.
1470
- this.logger.warn(`Local block ${reqNum} not found; rejecting BLOCK response without hash verification`);
1471
- return false;
1472
- }
1473
- const [localHash, respHash] = await Promise.all([
1474
- local.hash(),
1475
- responseBlock.hash()
1476
- ]);
1477
- if (!localHash.equals(respHash)) {
1478
- this.peerManager.penalizePeer(peerId, PeerErrorSeverity.MidToleranceError);
1479
- return false;
1480
- }
1481
- return true;
1482
- } catch (e) {
1483
- this.logger.warn(`Error validating requested block`, e);
1484
- return false;
1485
- }
1486
- }
1487
- createRequestedTxValidator() {
1488
- return new AggregateTxValidator(new DataTxValidator(), new MetadataTxValidator({
1489
- l1ChainId: new Fr(this.config.l1ChainId),
1490
- rollupVersion: new Fr(this.config.rollupVersion),
1491
- protocolContractsHash,
1492
- vkTreeRoot: getVKTreeRoot()
1493
- }), new TxProofValidator(this.proofVerifier));
1494
- }
1495
- async validateRequestedTx(tx, peerId, txValidator, requested) {
1496
- const penalize = (severity)=>this.peerManager.penalizePeer(peerId, severity);
1497
- if (!await tx.validateTxHash()) {
1498
- penalize(PeerErrorSeverity.MidToleranceError);
1499
- throw new ValidationError(`Received tx with invalid hash ${tx.getTxHash().toString()}.`);
1500
- }
1501
- if (requested && !requested.has(tx.getTxHash().toString())) {
1502
- penalize(PeerErrorSeverity.MidToleranceError);
1503
- throw new ValidationError(`Received tx with hash ${tx.getTxHash().toString()} that was not requested.`);
1504
- }
1505
- const { result } = await txValidator.validateTx(tx);
1506
- if (result === 'invalid') {
1507
- penalize(PeerErrorSeverity.LowToleranceError);
1508
- throw new ValidationError(`Received tx with hash ${tx.getTxHash().toString()} that is invalid.`);
1509
- }
1510
- }
1511
- async validatePropagatedTx(tx, peerId) {
1512
- const currentBlockNumber = await this.archiver.getBlockNumber();
1513
- // We accept transactions if they are not expired by the next slot (checked based on the IncludeByTimestamp field)
1514
- const { ts: nextSlotTimestamp } = this.epochCache.getEpochAndSlotInNextL1Slot();
1515
- const messageValidators = await this.createMessageValidators(currentBlockNumber, nextSlotTimestamp);
1516
- for (const validator of messageValidators){
1517
- const outcome = await this.runValidations(tx, validator);
1518
- if (outcome.allPassed) {
1519
- continue;
1520
- }
1521
- const { name } = outcome.failure;
1522
- let { severity } = outcome.failure;
1523
- // Double spend validator has a special case handler
1524
- if (name === 'doubleSpendValidator') {
1525
- const txBlockNumber = BlockNumber(currentBlockNumber + 1); // tx is expected to be in the next block
1526
- severity = await this.handleDoubleSpendFailure(tx, txBlockNumber);
1527
- }
1528
- this.peerManager.penalizePeer(peerId, severity);
1529
- return false;
1530
- }
1531
- return true;
1532
- }
1533
- async getGasFees(blockNumber) {
1534
- if (blockNumber === this.feesCache?.blockNumber) {
1535
- return this.feesCache.gasFees;
1536
- }
1537
- const header = await this.archiver.getBlockHeader(blockNumber);
1538
- const gasFees = header?.globalVariables.gasFees ?? GasFees.empty();
1539
- this.feesCache = {
1540
- blockNumber,
1541
- gasFees
1717
+ * Get the BatchTxRequesterLibP2PService dependencies for creating BatchTxRequester instances
1718
+ */ getBatchTxRequesterService() {
1719
+ return {
1720
+ reqResp: this.reqresp,
1721
+ connectionSampler: this.reqresp.getConnectionSampler(),
1722
+ txValidatorConfig: {
1723
+ l1ChainId: this.config.l1ChainId,
1724
+ rollupVersion: this.config.rollupVersion,
1725
+ proofVerifier: this.proofVerifier,
1726
+ txValidationCache: this.txValidationCache
1727
+ },
1728
+ peerScoring: this.peerManager,
1729
+ validateRequestedBlockTxsConsistency: this.validateRequestedBlockTxsConsistency.bind(this)
1542
1730
  };
1543
- return gasFees;
1544
1731
  }
1545
- async validate(txs) {
1546
- const currentBlockNumber = await this.archiver.getBlockNumber();
1547
- // We accept transactions if they are not expired by the next slot (checked based on the IncludeByTimestamp field)
1548
- const { ts: nextSlotTimestamp } = this.epochCache.getEpochAndSlotInNextL1Slot();
1549
- const messageValidators = await this.createMessageValidators(currentBlockNumber, nextSlotTimestamp);
1550
- await Promise.all(txs.map(async (tx)=>{
1551
- for (const validator of messageValidators){
1552
- const outcome = await this.runValidations(tx, validator);
1553
- if (!outcome.allPassed) {
1554
- throw new Error('Invalid tx detected', {
1555
- cause: {
1556
- outcome
1557
- }
1558
- });
1559
- }
1560
- }
1732
+ async validateTxsReceivedInBlockProposal(txs) {
1733
+ const validator = createTxValidatorForBlockProposalReceivedTxs(this.proofVerifier, {
1734
+ l1ChainId: this.config.l1ChainId,
1735
+ rollupVersion: this.config.rollupVersion
1736
+ }, this.logger.getBindings(), this.txValidationCache);
1737
+ const results = await Promise.all(txs.map(async (tx)=>{
1738
+ const result = await validator.validateTx(tx);
1739
+ return result.result !== 'invalid';
1561
1740
  }));
1741
+ if (results.some((value)=>value === false)) {
1742
+ throw new Error('Invalid tx detected');
1743
+ }
1562
1744
  }
1563
- /**
1564
- * Create message validators for the given block number and timestamp.
1565
- *
1566
- * Each validator is a pair of a validator and a severity.
1567
- * If a validator fails, the peer is penalized with the severity of the validator.
1568
- *
1569
- * @param currentBlockNumber - The current synced block number.
1570
- * @param nextSlotTimestamp - The timestamp of the next slot (used to validate txs are not expired).
1571
- * @returns The message validators.
1572
- */ async createMessageValidators(currentBlockNumber, nextSlotTimestamp) {
1573
- const gasFees = await this.getGasFees(currentBlockNumber);
1574
- const allowedInSetup = this.config.txPublicSetupAllowList ?? await getDefaultAllowedSetupFunctions();
1575
- const blockNumberInWhichTheTxIsConsideredToBeIncluded = BlockNumber(currentBlockNumber + 1);
1576
- return createTxMessageValidators(nextSlotTimestamp, blockNumberInWhichTheTxIsConsideredToBeIncluded, this.worldStateSynchronizer, gasFees, this.config.l1ChainId, this.config.rollupVersion, protocolContractsHash, this.archiver, this.proofVerifier, !this.config.disableTransactions, allowedInSetup);
1745
+ /** Creates the first stage (fast) validators for gossiped transactions. */ async createFirstStageMessageValidators(currentBlockNumber, nextSlotTimestamp) {
1746
+ const gasFees = await this.getGasFees();
1747
+ const allowedInSetup = [
1748
+ ...await getDefaultAllowedSetupFunctions(),
1749
+ ...this.config.txPublicSetupAllowListExtend ?? []
1750
+ ];
1751
+ const blockNumber = BlockNumber(currentBlockNumber + 1);
1752
+ const l1Constants = await this.archiver.getL1Constants();
1753
+ return createFirstStageTxValidationsForGossipedTransactions(nextSlotTimestamp, blockNumber, this.worldStateSynchronizer, gasFees, this.config.l1ChainId, this.config.rollupVersion, protocolContractsHash, this.archiver, !this.config.disableTransactions, allowedInSetup, this.logger.getBindings(), {
1754
+ rollupManaLimit: l1Constants.rollupManaLimit,
1755
+ maxBlockL2Gas: this.config.validateMaxL2BlockGas,
1756
+ maxBlockDAGas: this.config.validateMaxDABlockGas
1757
+ });
1758
+ }
1759
+ /** Creates the second stage (expensive proof verification) validators for gossiped transactions. */ createSecondStageMessageValidators() {
1760
+ return createSecondStageTxValidationsForGossipedTransactions(this.proofVerifier, this.logger.getBindings());
1577
1761
  }
1578
1762
  /**
1579
1763
  * Run validations on a tx.
@@ -1591,8 +1775,10 @@ _dec = trackSpan('Libp2pService.processValidBlockProposal', async (block)=>({
1591
1775
  });
1592
1776
  // A promise that resolves when all validations have been run
1593
1777
  const allValidations = await Promise.all(validationPromises);
1594
- const failed = allValidations.find((x)=>!x.isValid);
1595
- if (failed) {
1778
+ const failures = allValidations.filter((x)=>!x.isValid);
1779
+ if (failures.length > 0) {
1780
+ // Pick the most severe failure (lowest tolerance = harshest penalty)
1781
+ const failed = maxBy(failures, (f)=>PeerErrorSeverityByHarshness.indexOf(f.severity));
1596
1782
  return {
1597
1783
  allPassed: false,
1598
1784
  failure: {
@@ -1632,55 +1818,13 @@ _dec = trackSpan('Libp2pService.processValidBlockProposal', async (block)=>({
1632
1818
  const indices = await merkleTree.findLeafIndices(MerkleTreeId.NULLIFIER_TREE, nullifiers);
1633
1819
  return indices.map((index)=>index !== undefined);
1634
1820
  }
1635
- });
1821
+ }, this.logger.getBindings());
1636
1822
  const validSnapshot = await snapshotValidator.validateTx(tx);
1637
1823
  if (validSnapshot.result !== 'valid') {
1638
1824
  return PeerErrorSeverity.LowToleranceError;
1639
1825
  }
1640
1826
  return PeerErrorSeverity.HighToleranceError;
1641
1827
  }
1642
- /**
1643
- * Validate a checkpoint attestation.
1644
- *
1645
- * @param attestation - The checkpoint attestation to validate.
1646
- * @returns True if the checkpoint attestation is valid, false otherwise.
1647
- */ async validateCheckpointAttestation(peerId, attestation) {
1648
- const severity = await this.checkpointAttestationValidator.validate(attestation);
1649
- if (severity) {
1650
- this.logger.debug(`Penalizing peer ${peerId} for checkpoint attestation validation failure`);
1651
- this.peerManager.penalizePeer(peerId, severity);
1652
- return false;
1653
- }
1654
- return true;
1655
- }
1656
- /**
1657
- * Validate a block proposal.
1658
- *
1659
- * @param block - The block proposal to validate.
1660
- * @returns True if the block proposal is valid, false otherwise.
1661
- */ async validateBlockProposal(peerId, block) {
1662
- const severity = await this.blockProposalValidator.validate(block);
1663
- if (severity) {
1664
- this.logger.debug(`Penalizing peer ${peerId} for block proposal validation failure`);
1665
- this.peerManager.penalizePeer(peerId, severity);
1666
- return false;
1667
- }
1668
- return true;
1669
- }
1670
- /**
1671
- * Validate a checkpoint proposal.
1672
- *
1673
- * @param checkpoint - The checkpoint proposal to validate.
1674
- * @returns True if the checkpoint proposal is valid, false otherwise.
1675
- */ async validateCheckpointProposal(peerId, checkpoint) {
1676
- const severity = await this.checkpointProposalValidator.validate(checkpoint);
1677
- if (severity) {
1678
- this.logger.debug(`Penalizing peer ${peerId} for checkpoint proposal validation failure`);
1679
- this.peerManager.penalizePeer(peerId, severity);
1680
- return false;
1681
- }
1682
- return true;
1683
- }
1684
1828
  getPeerScore(peerId) {
1685
1829
  return this.node.services.pubsub.score.score(peerId.toString());
1686
1830
  }