@aztec/p2p 5.0.0-private.20260319 → 5.0.0-rc.2

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 (411) hide show
  1. package/README.md +4 -1
  2. package/dest/bootstrap/bootstrap.d.ts +1 -1
  3. package/dest/bootstrap/bootstrap.d.ts.map +1 -1
  4. package/dest/bootstrap/bootstrap.js +22 -6
  5. package/dest/client/factory.d.ts +4 -3
  6. package/dest/client/factory.d.ts.map +1 -1
  7. package/dest/client/factory.js +33 -24
  8. package/dest/client/interface.d.ts +43 -11
  9. package/dest/client/interface.d.ts.map +1 -1
  10. package/dest/client/p2p_client.d.ts +33 -19
  11. package/dest/client/p2p_client.d.ts.map +1 -1
  12. package/dest/client/p2p_client.js +100 -44
  13. package/dest/config.d.ts +137 -107
  14. package/dest/config.d.ts.map +1 -1
  15. package/dest/config.js +64 -23
  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/index.d.ts +1 -2
  23. package/dest/index.d.ts.map +1 -1
  24. package/dest/index.js +0 -1
  25. package/dest/mem_pools/attestation_pool/attestation_pool.d.ts +98 -56
  26. package/dest/mem_pools/attestation_pool/attestation_pool.d.ts.map +1 -1
  27. package/dest/mem_pools/attestation_pool/attestation_pool.js +265 -196
  28. package/dest/mem_pools/attestation_pool/attestation_pool_test_suite.d.ts +1 -1
  29. package/dest/mem_pools/attestation_pool/attestation_pool_test_suite.d.ts.map +1 -1
  30. package/dest/mem_pools/attestation_pool/attestation_pool_test_suite.js +175 -59
  31. package/dest/mem_pools/attestation_pool/mocks.d.ts +1 -1
  32. package/dest/mem_pools/attestation_pool/mocks.d.ts.map +1 -1
  33. package/dest/mem_pools/attestation_pool/mocks.js +6 -4
  34. package/dest/mem_pools/index.d.ts +1 -2
  35. package/dest/mem_pools/index.d.ts.map +1 -1
  36. package/dest/mem_pools/instrumentation.d.ts +1 -1
  37. package/dest/mem_pools/instrumentation.d.ts.map +1 -1
  38. package/dest/mem_pools/instrumentation.js +17 -1
  39. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.d.ts +1 -5
  40. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.d.ts.map +1 -1
  41. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.js +1 -7
  42. package/dest/mem_pools/tx_pool_v2/deleted_pool.d.ts +3 -3
  43. package/dest/mem_pools/tx_pool_v2/deleted_pool.d.ts.map +1 -1
  44. package/dest/mem_pools/tx_pool_v2/deleted_pool.js +6 -6
  45. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.js +1 -1
  46. package/dest/mem_pools/tx_pool_v2/eviction/index.d.ts +2 -1
  47. package/dest/mem_pools/tx_pool_v2/eviction/index.d.ts.map +1 -1
  48. package/dest/mem_pools/tx_pool_v2/eviction/index.js +1 -0
  49. package/dest/mem_pools/tx_pool_v2/eviction/insufficient_fee_per_gas_eviction_rule.d.ts +16 -0
  50. package/dest/mem_pools/tx_pool_v2/eviction/insufficient_fee_per_gas_eviction_rule.d.ts.map +1 -0
  51. package/dest/mem_pools/tx_pool_v2/eviction/insufficient_fee_per_gas_eviction_rule.js +62 -0
  52. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.js +2 -2
  53. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts +22 -5
  54. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts.map +1 -1
  55. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts +5 -2
  56. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts.map +1 -1
  57. package/dest/mem_pools/tx_pool_v2/tx_metadata.js +13 -6
  58. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.d.ts +7 -1
  59. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.d.ts.map +1 -1
  60. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.js +10 -0
  61. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts +8 -3
  62. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts.map +1 -1
  63. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.js +7 -4
  64. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts +8 -3
  65. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts.map +1 -1
  66. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.js +153 -111
  67. package/dest/msg_validators/attestation_validator/attestation_validator.d.ts +10 -3
  68. package/dest/msg_validators/attestation_validator/attestation_validator.d.ts.map +1 -1
  69. package/dest/msg_validators/attestation_validator/attestation_validator.js +38 -16
  70. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts +7 -3
  71. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts.map +1 -1
  72. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.js +4 -5
  73. package/dest/msg_validators/proposal_validator/block_proposal_validator.d.ts +8 -3
  74. package/dest/msg_validators/proposal_validator/block_proposal_validator.d.ts.map +1 -1
  75. package/dest/msg_validators/proposal_validator/block_proposal_validator.js +2 -2
  76. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.d.ts +8 -3
  77. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.d.ts.map +1 -1
  78. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.js +8 -2
  79. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts +25 -3
  80. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts.map +1 -1
  81. package/dest/msg_validators/proposal_validator/proposal_validator.js +77 -14
  82. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts +1 -1
  83. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts.map +1 -1
  84. package/dest/msg_validators/tx_validator/aggregate_tx_validator.js +8 -15
  85. package/dest/msg_validators/tx_validator/allowed_public_setup.js +3 -3
  86. package/dest/msg_validators/tx_validator/archive_cache.js +1 -1
  87. package/dest/msg_validators/tx_validator/cached_tx_validator.d.ts +15 -0
  88. package/dest/msg_validators/tx_validator/cached_tx_validator.d.ts.map +1 -0
  89. package/dest/msg_validators/tx_validator/cached_tx_validator.js +19 -0
  90. package/dest/msg_validators/tx_validator/contract_instance_validator.d.ts +9 -0
  91. package/dest/msg_validators/tx_validator/contract_instance_validator.d.ts.map +1 -0
  92. package/dest/msg_validators/tx_validator/contract_instance_validator.js +48 -0
  93. package/dest/msg_validators/tx_validator/data_validator.d.ts +2 -1
  94. package/dest/msg_validators/tx_validator/data_validator.d.ts.map +1 -1
  95. package/dest/msg_validators/tx_validator/data_validator.js +36 -2
  96. package/dest/msg_validators/tx_validator/factory.d.ts +14 -15
  97. package/dest/msg_validators/tx_validator/factory.d.ts.map +1 -1
  98. package/dest/msg_validators/tx_validator/factory.js +36 -17
  99. package/dest/msg_validators/tx_validator/gas_validator.d.ts +47 -10
  100. package/dest/msg_validators/tx_validator/gas_validator.d.ts.map +1 -1
  101. package/dest/msg_validators/tx_validator/gas_validator.js +65 -48
  102. package/dest/msg_validators/tx_validator/index.d.ts +3 -1
  103. package/dest/msg_validators/tx_validator/index.d.ts.map +1 -1
  104. package/dest/msg_validators/tx_validator/index.js +2 -0
  105. package/dest/msg_validators/tx_validator/phases_validator.js +3 -3
  106. package/dest/msg_validators/tx_validator/tx_proof_validator.d.ts +2 -1
  107. package/dest/msg_validators/tx_validator/tx_proof_validator.d.ts.map +1 -1
  108. package/dest/msg_validators/tx_validator/tx_proof_validator.js +2 -0
  109. package/dest/msg_validators/tx_validator/tx_validation_cache.d.ts +48 -0
  110. package/dest/msg_validators/tx_validator/tx_validation_cache.d.ts.map +1 -0
  111. package/dest/msg_validators/tx_validator/tx_validation_cache.js +68 -0
  112. package/dest/services/data_store.d.ts +1 -1
  113. package/dest/services/data_store.d.ts.map +1 -1
  114. package/dest/services/data_store.js +5 -5
  115. package/dest/services/discv5/discV5_service.d.ts +13 -2
  116. package/dest/services/discv5/discV5_service.d.ts.map +1 -1
  117. package/dest/services/discv5/discV5_service.js +119 -23
  118. package/dest/services/discv5/persisted_enr_store.d.ts +38 -0
  119. package/dest/services/discv5/persisted_enr_store.d.ts.map +1 -0
  120. package/dest/services/discv5/persisted_enr_store.js +145 -0
  121. package/dest/services/dummy_service.d.ts +15 -15
  122. package/dest/services/dummy_service.d.ts.map +1 -1
  123. package/dest/services/dummy_service.js +15 -16
  124. package/dest/services/encoding.d.ts +8 -8
  125. package/dest/services/encoding.d.ts.map +1 -1
  126. package/dest/services/encoding.js +11 -15
  127. package/dest/services/gossipsub/topic_score_params.d.ts +6 -12
  128. package/dest/services/gossipsub/topic_score_params.d.ts.map +1 -1
  129. package/dest/services/gossipsub/topic_score_params.js +4 -14
  130. package/dest/services/libp2p/instrumentation.d.ts +3 -1
  131. package/dest/services/libp2p/instrumentation.d.ts.map +1 -1
  132. package/dest/services/libp2p/instrumentation.js +14 -0
  133. package/dest/services/libp2p/libp2p_service.d.ts +44 -39
  134. package/dest/services/libp2p/libp2p_service.d.ts.map +1 -1
  135. package/dest/services/libp2p/libp2p_service.js +383 -278
  136. package/dest/services/peer-manager/peer_manager.d.ts +20 -3
  137. package/dest/services/peer-manager/peer_manager.d.ts.map +1 -1
  138. package/dest/services/peer-manager/peer_manager.js +79 -23
  139. package/dest/services/peer-manager/peer_scoring.d.ts +34 -2
  140. package/dest/services/peer-manager/peer_scoring.d.ts.map +1 -1
  141. package/dest/services/peer-manager/peer_scoring.js +102 -13
  142. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts +1 -8
  143. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts.map +1 -1
  144. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.js +38 -44
  145. package/dest/services/reqresp/batch-tx-requester/interface.d.ts +8 -5
  146. package/dest/services/reqresp/batch-tx-requester/interface.d.ts.map +1 -1
  147. package/dest/services/reqresp/batch-tx-requester/tx_validator.d.ts +5 -14
  148. package/dest/services/reqresp/batch-tx-requester/tx_validator.d.ts.map +1 -1
  149. package/dest/services/reqresp/batch-tx-requester/tx_validator.js +6 -20
  150. package/dest/services/reqresp/config.d.ts +3 -3
  151. package/dest/services/reqresp/config.d.ts.map +1 -1
  152. package/dest/services/reqresp/interface.d.ts +16 -18
  153. package/dest/services/reqresp/interface.d.ts.map +1 -1
  154. package/dest/services/reqresp/interface.js +10 -20
  155. package/dest/services/reqresp/metrics.d.ts +1 -1
  156. package/dest/services/reqresp/metrics.d.ts.map +1 -1
  157. package/dest/services/reqresp/metrics.js +0 -1
  158. package/dest/services/reqresp/protocols/block_txs/bitvector.d.ts +4 -3
  159. package/dest/services/reqresp/protocols/block_txs/bitvector.d.ts.map +1 -1
  160. package/dest/services/reqresp/protocols/block_txs/bitvector.js +3 -2
  161. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts +1 -1
  162. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts.map +1 -1
  163. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.js +31 -28
  164. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts +12 -7
  165. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts.map +1 -1
  166. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.js +42 -24
  167. package/dest/services/reqresp/protocols/index.d.ts +1 -2
  168. package/dest/services/reqresp/protocols/index.d.ts.map +1 -1
  169. package/dest/services/reqresp/protocols/index.js +0 -1
  170. package/dest/services/reqresp/protocols/tx.d.ts +1 -1
  171. package/dest/services/reqresp/protocols/tx.d.ts.map +1 -1
  172. package/dest/services/reqresp/protocols/tx.js +1 -3
  173. package/dest/services/reqresp/rate-limiter/rate_limiter.d.ts +5 -4
  174. package/dest/services/reqresp/rate-limiter/rate_limiter.d.ts.map +1 -1
  175. package/dest/services/reqresp/rate-limiter/rate_limiter.js +10 -8
  176. package/dest/services/reqresp/rate-limiter/rate_limits.d.ts +1 -1
  177. package/dest/services/reqresp/rate-limiter/rate_limits.d.ts.map +1 -1
  178. package/dest/services/reqresp/rate-limiter/rate_limits.js +0 -10
  179. package/dest/services/reqresp/reqresp.d.ts +7 -29
  180. package/dest/services/reqresp/reqresp.d.ts.map +1 -1
  181. package/dest/services/reqresp/reqresp.js +26 -207
  182. package/dest/services/service.d.ts +25 -12
  183. package/dest/services/service.d.ts.map +1 -1
  184. package/dest/services/tx_collection/config.d.ts +2 -23
  185. package/dest/services/tx_collection/config.d.ts.map +1 -1
  186. package/dest/services/tx_collection/config.js +2 -55
  187. package/dest/services/tx_collection/file_store_tx_collection.d.ts +12 -28
  188. package/dest/services/tx_collection/file_store_tx_collection.d.ts.map +1 -1
  189. package/dest/services/tx_collection/file_store_tx_collection.js +43 -83
  190. package/dest/services/tx_collection/file_store_tx_source.d.ts +5 -4
  191. package/dest/services/tx_collection/file_store_tx_source.d.ts.map +1 -1
  192. package/dest/services/tx_collection/file_store_tx_source.js +39 -29
  193. package/dest/services/tx_collection/index.d.ts +2 -3
  194. package/dest/services/tx_collection/index.d.ts.map +1 -1
  195. package/dest/services/tx_collection/index.js +0 -1
  196. package/dest/services/tx_collection/instrumentation.d.ts +1 -1
  197. package/dest/services/tx_collection/instrumentation.d.ts.map +1 -1
  198. package/dest/services/tx_collection/instrumentation.js +0 -2
  199. package/dest/services/tx_collection/tx_collection.d.ts +35 -51
  200. package/dest/services/tx_collection/tx_collection.d.ts.map +1 -1
  201. package/dest/services/tx_collection/tx_collection.js +275 -119
  202. package/dest/services/tx_collection/tx_collection_sink.d.ts +1 -1
  203. package/dest/services/tx_collection/tx_collection_sink.js +2 -2
  204. package/dest/services/tx_collection/tx_source.d.ts +6 -5
  205. package/dest/services/tx_collection/tx_source.d.ts.map +1 -1
  206. package/dest/services/tx_collection/tx_source.js +13 -8
  207. package/dest/services/tx_file_store/tx_file_store.d.ts +1 -3
  208. package/dest/services/tx_file_store/tx_file_store.d.ts.map +1 -1
  209. package/dest/services/tx_file_store/tx_file_store.js +4 -14
  210. package/dest/services/tx_provider.d.ts +3 -1
  211. package/dest/services/tx_provider.d.ts.map +1 -1
  212. package/dest/services/tx_provider.js +3 -0
  213. package/dest/test-helpers/make-test-p2p-clients.d.ts +1 -1
  214. package/dest/test-helpers/make-test-p2p-clients.d.ts.map +1 -1
  215. package/dest/test-helpers/make-test-p2p-clients.js +5 -2
  216. package/dest/test-helpers/mock-pubsub.d.ts +23 -9
  217. package/dest/test-helpers/mock-pubsub.d.ts.map +1 -1
  218. package/dest/test-helpers/mock-pubsub.js +44 -44
  219. package/dest/test-helpers/reqresp-nodes.d.ts +4 -5
  220. package/dest/test-helpers/reqresp-nodes.d.ts.map +1 -1
  221. package/dest/test-helpers/reqresp-nodes.js +16 -18
  222. package/dest/test-helpers/test_tx_provider.d.ts +3 -1
  223. package/dest/test-helpers/test_tx_provider.d.ts.map +1 -1
  224. package/dest/test-helpers/test_tx_provider.js +3 -0
  225. package/dest/test-helpers/testbench-utils.d.ts +14 -14
  226. package/dest/test-helpers/testbench-utils.d.ts.map +1 -1
  227. package/dest/test-helpers/testbench-utils.js +25 -13
  228. package/dest/testbench/p2p_client_testbench_worker.d.ts +3 -5
  229. package/dest/testbench/p2p_client_testbench_worker.d.ts.map +1 -1
  230. package/dest/testbench/p2p_client_testbench_worker.js +102 -41
  231. package/dest/testbench/worker_client_manager.d.ts +10 -6
  232. package/dest/testbench/worker_client_manager.d.ts.map +1 -1
  233. package/dest/testbench/worker_client_manager.js +51 -9
  234. package/dest/util.d.ts +11 -6
  235. package/dest/util.d.ts.map +1 -1
  236. package/dest/util.js +35 -14
  237. package/dest/versioning.d.ts +3 -6
  238. package/dest/versioning.d.ts.map +1 -1
  239. package/dest/versioning.js +3 -24
  240. package/package.json +16 -16
  241. package/src/bootstrap/bootstrap.ts +17 -3
  242. package/src/client/factory.ts +52 -24
  243. package/src/client/interface.ts +38 -17
  244. package/src/client/p2p_client.ts +118 -76
  245. package/src/client/test/{tx_proposal_collector/README.md → p2p_client.batch_tx_requester.bench.README.md} +23 -53
  246. package/src/config.ts +130 -31
  247. package/src/errors/p2p-service.error.ts +11 -0
  248. package/src/errors/reqresp.error.ts +0 -25
  249. package/src/index.ts +0 -1
  250. package/src/mem_pools/attestation_pool/attestation_pool.ts +319 -238
  251. package/src/mem_pools/attestation_pool/attestation_pool_test_suite.ts +198 -62
  252. package/src/mem_pools/attestation_pool/mocks.ts +13 -8
  253. package/src/mem_pools/index.ts +0 -3
  254. package/src/mem_pools/instrumentation.ts +5 -1
  255. package/src/mem_pools/tx_pool_v2/archive/tx_archive.ts +1 -9
  256. package/src/mem_pools/tx_pool_v2/deleted_pool.ts +7 -7
  257. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.ts +1 -1
  258. package/src/mem_pools/tx_pool_v2/eviction/index.ts +1 -0
  259. package/src/mem_pools/tx_pool_v2/eviction/insufficient_fee_per_gas_eviction_rule.ts +65 -0
  260. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.ts +3 -3
  261. package/src/mem_pools/tx_pool_v2/interfaces.ts +18 -4
  262. package/src/mem_pools/tx_pool_v2/tx_metadata.ts +20 -8
  263. package/src/mem_pools/tx_pool_v2/tx_pool_indices.ts +12 -0
  264. package/src/mem_pools/tx_pool_v2/tx_pool_v2.ts +8 -4
  265. package/src/mem_pools/tx_pool_v2/tx_pool_v2_impl.ts +163 -117
  266. package/src/msg_validators/attestation_validator/attestation_validator.ts +46 -15
  267. package/src/msg_validators/attestation_validator/fisherman_attestation_validator.ts +15 -7
  268. package/src/msg_validators/proposal_validator/README.md +1 -1
  269. package/src/msg_validators/proposal_validator/block_proposal_validator.ts +15 -3
  270. package/src/msg_validators/proposal_validator/checkpoint_proposal_validator.ts +26 -3
  271. package/src/msg_validators/proposal_validator/proposal_validator.ts +89 -11
  272. package/src/msg_validators/tx_validator/README.md +13 -3
  273. package/src/msg_validators/tx_validator/aggregate_tx_validator.ts +3 -12
  274. package/src/msg_validators/tx_validator/allowed_public_setup.ts +3 -3
  275. package/src/msg_validators/tx_validator/archive_cache.ts +1 -1
  276. package/src/msg_validators/tx_validator/cached_tx_validator.ts +31 -0
  277. package/src/msg_validators/tx_validator/contract_instance_validator.ts +56 -0
  278. package/src/msg_validators/tx_validator/data_validator.ts +44 -1
  279. package/src/msg_validators/tx_validator/factory.ts +44 -20
  280. package/src/msg_validators/tx_validator/gas_validator.ts +99 -54
  281. package/src/msg_validators/tx_validator/index.ts +2 -0
  282. package/src/msg_validators/tx_validator/phases_validator.ts +3 -3
  283. package/src/msg_validators/tx_validator/tx_proof_validator.ts +2 -0
  284. package/src/msg_validators/tx_validator/tx_validation_cache.ts +101 -0
  285. package/src/services/data_store.ts +5 -13
  286. package/src/services/discv5/discV5_service.ts +126 -14
  287. package/src/services/discv5/persisted_enr_store.ts +158 -0
  288. package/src/services/dummy_service.ts +20 -39
  289. package/src/services/encoding.ts +11 -21
  290. package/src/services/gossipsub/README.md +33 -11
  291. package/src/services/gossipsub/topic_score_params.ts +9 -18
  292. package/src/services/libp2p/instrumentation.ts +14 -0
  293. package/src/services/libp2p/libp2p_service.ts +436 -311
  294. package/src/services/peer-manager/peer_manager.ts +86 -22
  295. package/src/services/peer-manager/peer_scoring.ts +102 -8
  296. package/src/services/reqresp/README.md +0 -14
  297. package/src/services/reqresp/batch-tx-requester/batch_tx_requester.ts +42 -52
  298. package/src/services/reqresp/batch-tx-requester/interface.ts +11 -4
  299. package/src/services/reqresp/batch-tx-requester/tx_validator.ts +12 -25
  300. package/src/services/reqresp/config.ts +2 -2
  301. package/src/services/reqresp/interface.ts +21 -47
  302. package/src/services/reqresp/metrics.ts +0 -1
  303. package/src/services/reqresp/protocols/block_txs/bitvector.ts +3 -2
  304. package/src/services/reqresp/protocols/block_txs/block_txs_handler.ts +34 -30
  305. package/src/services/reqresp/protocols/block_txs/block_txs_reqresp.ts +47 -20
  306. package/src/services/reqresp/protocols/index.ts +0 -1
  307. package/src/services/reqresp/protocols/tx.ts +1 -3
  308. package/src/services/reqresp/rate-limiter/rate_limiter.ts +13 -9
  309. package/src/services/reqresp/rate-limiter/rate_limits.ts +0 -10
  310. package/src/services/reqresp/reqresp.ts +29 -252
  311. package/src/services/service.ts +31 -28
  312. package/src/services/tx_collection/config.ts +3 -80
  313. package/src/services/tx_collection/file_store_tx_collection.ts +54 -103
  314. package/src/services/tx_collection/file_store_tx_source.ts +43 -31
  315. package/src/services/tx_collection/index.ts +1 -6
  316. package/src/services/tx_collection/instrumentation.ts +1 -7
  317. package/src/services/tx_collection/tx_collection.ts +330 -173
  318. package/src/services/tx_collection/tx_collection_sink.ts +2 -2
  319. package/src/services/tx_collection/tx_source.ts +10 -8
  320. package/src/services/tx_file_store/tx_file_store.ts +5 -17
  321. package/src/services/tx_provider.ts +5 -0
  322. package/src/test-helpers/make-test-p2p-clients.ts +3 -0
  323. package/src/test-helpers/mock-pubsub.ts +46 -60
  324. package/src/test-helpers/reqresp-nodes.ts +12 -22
  325. package/src/test-helpers/test_tx_provider.ts +5 -0
  326. package/src/test-helpers/testbench-utils.ts +31 -26
  327. package/src/testbench/p2p_client_testbench_worker.ts +110 -55
  328. package/src/testbench/worker_client_manager.ts +59 -20
  329. package/src/util.ts +32 -17
  330. package/src/versioning.ts +3 -33
  331. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker.d.ts +0 -2
  332. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker.d.ts.map +0 -1
  333. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker.js +0 -305
  334. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.d.ts +0 -73
  335. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.d.ts.map +0 -1
  336. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.js +0 -8
  337. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.d.ts +0 -125
  338. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.d.ts.map +0 -1
  339. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.js +0 -596
  340. package/dest/mem_pools/tx_pool/eviction/eviction_manager.d.ts +0 -32
  341. package/dest/mem_pools/tx_pool/eviction/eviction_manager.d.ts.map +0 -1
  342. package/dest/mem_pools/tx_pool/eviction/eviction_manager.js +0 -112
  343. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.d.ts +0 -157
  344. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.d.ts.map +0 -1
  345. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.js +0 -52
  346. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.d.ts +0 -16
  347. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.d.ts.map +0 -1
  348. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.js +0 -123
  349. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.d.ts +0 -17
  350. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.d.ts.map +0 -1
  351. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.js +0 -84
  352. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.d.ts +0 -19
  353. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.d.ts.map +0 -1
  354. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.js +0 -78
  355. package/dest/mem_pools/tx_pool/eviction/low_priority_eviction_rule.d.ts +0 -26
  356. package/dest/mem_pools/tx_pool/eviction/low_priority_eviction_rule.d.ts.map +0 -1
  357. package/dest/mem_pools/tx_pool/eviction/low_priority_eviction_rule.js +0 -84
  358. package/dest/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.d.ts +0 -25
  359. package/dest/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.d.ts.map +0 -1
  360. package/dest/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.js +0 -57
  361. package/dest/mem_pools/tx_pool/index.d.ts +0 -3
  362. package/dest/mem_pools/tx_pool/index.d.ts.map +0 -1
  363. package/dest/mem_pools/tx_pool/index.js +0 -2
  364. package/dest/mem_pools/tx_pool/priority.d.ts +0 -12
  365. package/dest/mem_pools/tx_pool/priority.d.ts.map +0 -1
  366. package/dest/mem_pools/tx_pool/priority.js +0 -15
  367. package/dest/mem_pools/tx_pool/tx_pool.d.ts +0 -127
  368. package/dest/mem_pools/tx_pool/tx_pool.d.ts.map +0 -1
  369. package/dest/mem_pools/tx_pool/tx_pool.js +0 -3
  370. package/dest/mem_pools/tx_pool/tx_pool_test_suite.d.ts +0 -7
  371. package/dest/mem_pools/tx_pool/tx_pool_test_suite.d.ts.map +0 -1
  372. package/dest/mem_pools/tx_pool/tx_pool_test_suite.js +0 -402
  373. package/dest/msg_validators/clock_tolerance.d.ts +0 -21
  374. package/dest/msg_validators/clock_tolerance.d.ts.map +0 -1
  375. package/dest/msg_validators/clock_tolerance.js +0 -38
  376. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.d.ts +0 -64
  377. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.d.ts.map +0 -1
  378. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.js +0 -151
  379. package/dest/services/reqresp/protocols/block.d.ts +0 -9
  380. package/dest/services/reqresp/protocols/block.d.ts.map +0 -1
  381. package/dest/services/reqresp/protocols/block.js +0 -32
  382. package/dest/services/tx_collection/fast_tx_collection.d.ts +0 -51
  383. package/dest/services/tx_collection/fast_tx_collection.d.ts.map +0 -1
  384. package/dest/services/tx_collection/fast_tx_collection.js +0 -311
  385. package/dest/services/tx_collection/proposal_tx_collector.d.ts +0 -48
  386. package/dest/services/tx_collection/proposal_tx_collector.d.ts.map +0 -1
  387. package/dest/services/tx_collection/proposal_tx_collector.js +0 -50
  388. package/dest/services/tx_collection/slow_tx_collection.d.ts +0 -57
  389. package/dest/services/tx_collection/slow_tx_collection.d.ts.map +0 -1
  390. package/dest/services/tx_collection/slow_tx_collection.js +0 -211
  391. package/src/client/test/tx_proposal_collector/proposal_tx_collector_worker.ts +0 -344
  392. package/src/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.ts +0 -43
  393. package/src/mem_pools/tx_pool/README.md +0 -270
  394. package/src/mem_pools/tx_pool/aztec_kv_tx_pool.ts +0 -746
  395. package/src/mem_pools/tx_pool/eviction/eviction_manager.ts +0 -132
  396. package/src/mem_pools/tx_pool/eviction/eviction_strategy.ts +0 -208
  397. package/src/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.ts +0 -163
  398. package/src/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.ts +0 -104
  399. package/src/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.ts +0 -93
  400. package/src/mem_pools/tx_pool/eviction/low_priority_eviction_rule.ts +0 -106
  401. package/src/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.ts +0 -75
  402. package/src/mem_pools/tx_pool/index.ts +0 -2
  403. package/src/mem_pools/tx_pool/priority.ts +0 -20
  404. package/src/mem_pools/tx_pool/tx_pool.ts +0 -141
  405. package/src/mem_pools/tx_pool/tx_pool_test_suite.ts +0 -321
  406. package/src/msg_validators/clock_tolerance.ts +0 -52
  407. package/src/services/reqresp/connection-sampler/batch_connection_sampler.ts +0 -161
  408. package/src/services/reqresp/protocols/block.ts +0 -37
  409. package/src/services/tx_collection/fast_tx_collection.ts +0 -361
  410. package/src/services/tx_collection/proposal_tx_collector.ts +0 -108
  411. package/src/services/tx_collection/slow_tx_collection.ts +0 -266
@@ -1,9 +1,8 @@
1
1
  import { BlockNumber } from '@aztec/foundation/branded-types';
2
- import { compactArray } from '@aztec/foundation/collection';
2
+ import { times } from '@aztec/foundation/collection';
3
3
  import { type Logger, createLogger } from '@aztec/foundation/log';
4
- import { RunningPromise } from '@aztec/foundation/promise';
5
4
  import { sleep } from '@aztec/foundation/sleep';
6
- import { DateProvider } from '@aztec/foundation/timer';
5
+ import { DateProvider, elapsed } from '@aztec/foundation/timer';
7
6
  import type { L2Block, L2BlockInfo } from '@aztec/stdlib/block';
8
7
  import type { L1RollupConstants } from '@aztec/stdlib/epoch-helpers';
9
8
  import type { BlockProposal } from '@aztec/stdlib/p2p';
@@ -14,19 +13,17 @@ import { type TelemetryClient, getTelemetryClient } from '@aztec/telemetry-clien
14
13
  import type { PeerId } from '@libp2p/interface';
15
14
 
16
15
  import type { TxPoolV2, TxPoolV2Events } from '../../mem_pools/tx_pool_v2/interfaces.js';
16
+ import { BatchTxRequester } from '../reqresp/batch-tx-requester/batch_tx_requester.js';
17
17
  import type { BatchTxRequesterLibP2PService } from '../reqresp/batch-tx-requester/interface.js';
18
+ import type { BlockTxsSource } from '../reqresp/index.js';
18
19
  import type { TxCollectionConfig } from './config.js';
19
- import { FastTxCollection } from './fast_tx_collection.js';
20
20
  import { FileStoreTxCollection } from './file_store_tx_collection.js';
21
21
  import type { FileStoreTxSource } from './file_store_tx_source.js';
22
- import type { IRequestTracker } from './request_tracker.js';
23
- import { SlowTxCollection, getProofDeadlineForSlot } from './slow_tx_collection.js';
22
+ import { type IRequestTracker, RequestTracker } from './request_tracker.js';
24
23
  import { type TxAddContext, TxCollectionSink } from './tx_collection_sink.js';
25
24
  import type { TxSource } from './tx_source.js';
26
25
 
27
- export type CollectionMethod = 'fast-req-resp' | 'fast-node-rpc' | 'slow-req-resp' | 'slow-node-rpc' | 'file-store';
28
-
29
- export type MissingTxInfo = { block: L2Block; blockNumber: BlockNumber; deadline: Date; readyForReqResp: boolean };
26
+ export type CollectionMethod = 'fast-req-resp' | 'fast-node-rpc' | 'file-store';
30
27
 
31
28
  export type FastCollectionRequestInput =
32
29
  | { type: 'block'; block: L2Block }
@@ -38,33 +35,38 @@ export type FastCollectionRequest = FastCollectionRequestInput & {
38
35
  };
39
36
 
40
37
  /**
41
- * Coordinates tx collection from remote RPC nodes and reqresp.
38
+ * Collect missing transactions for a block or proposal via reqresp.
39
+ * @param requestTracker - The missing transactions tracker
40
+ * @param blockTxsSource - The block or proposal containing the transactions
41
+ * @param pinnedPeer - Optional peer expected to have the transactions
42
+ * @returns The collected transactions
43
+ */
44
+ export type IReqRespTxsCollector = (
45
+ requestTracker: IRequestTracker,
46
+ blockTxsSource: BlockTxsSource,
47
+ pinnedPeer: PeerId | undefined,
48
+ ) => Promise<Tx[]>;
49
+
50
+ /**
51
+ * Coordinates tx collection from remote RPC nodes, reqresp, and file store.
42
52
  *
43
- * The slow collection loops are used for periodically collecting missing txs from mined blocks,
44
- * from remote RPC nodes and via reqresp. The fast collection methods are used to quickly gather
45
- * txs, usually for attesting to block proposals or preparing to prove an epoch. The slow and fast
46
- * collection instances both send their txs to the collection sink, which handles metrics and adds
47
- * them to the tx pool. Whenever a tx is added to either the sink or the pool, this service is notified
48
- * via events and notifies the slow and fast collection loops to stop collecting that tx, so that we don't
49
- * collect the same tx multiple times.
53
+ * Runs a sequential pipeline: node RPC reqresp file store. Node collection starts immediately,
54
+ * reqresp starts after a configured delay, and file store (if configured) starts after a further
55
+ * delay. All paths send txs to the collection sink, which handles metrics and adds them to the
56
+ * tx pool. Whenever a tx is added to the sink or the pool, this service is notified and stops
57
+ * collecting that tx across all in-flight requests.
50
58
  */
51
59
  export class TxCollection {
52
- /** Slow collection background loops */
53
- protected readonly slowCollection: SlowTxCollection;
54
-
55
- /** Fast collection methods */
56
- protected readonly fastCollection: FastTxCollection;
60
+ // eslint-disable-next-line aztec-custom/no-non-primitive-in-collections
61
+ protected requests: Set<FastCollectionRequest> = new Set();
57
62
 
58
- /** File store collection for slow (mined block) path */
59
- protected readonly fileStoreSlowCollection: FileStoreTxCollection;
63
+ /** The collector for txs via reqresp */
64
+ protected reqRespTxsCollector?: IReqRespTxsCollector;
60
65
 
61
- /** File store collection for fast (proposal/proving) path */
66
+ /** File store collection for the fast (proposal/proving) path */
62
67
  protected readonly fileStoreFastCollection: FileStoreTxCollection;
63
68
 
64
- /** Loop for periodically reconciling found transactions from the tx pool in case we missed some */
65
- private readonly reconcileFoundTxsLoop: RunningPromise;
66
-
67
- /** Handles txs found by the slow and fast collection loops */
69
+ /** Handles txs found by collection paths before adding to the pool */
68
70
  private readonly txCollectionSink: TxCollectionSink;
69
71
 
70
72
  /** Handler for the txs-added event from the tx pool */
@@ -73,12 +75,6 @@ export class TxCollection {
73
75
  /** Handler for the txs-added event from the tx collection sink */
74
76
  protected readonly handleTxsFound: TxPoolV2Events['txs-added'];
75
77
 
76
- /** Whether the service has been started. */
77
- private started = false;
78
-
79
- /** Whether file store sources are configured. */
80
- private readonly hasFileStoreSources: boolean;
81
-
82
78
  constructor(
83
79
  private readonly p2pService: BatchTxRequesterLibP2PService,
84
80
  private readonly nodes: TxSource[],
@@ -92,38 +88,18 @@ export class TxCollection {
92
88
  ) {
93
89
  this.txCollectionSink = new TxCollectionSink(this.txPool, telemetryClient, this.log);
94
90
 
95
- this.fastCollection = new FastTxCollection(
96
- this.p2pService,
97
- this.nodes,
98
- this.txCollectionSink,
99
- this.config,
100
- this.dateProvider,
101
- this.log,
102
- );
103
-
104
- this.slowCollection = new SlowTxCollection(
105
- this.p2pService.reqResp,
106
- this.nodes,
107
- this.txCollectionSink,
108
- this.fastCollection,
109
- constants,
110
- this.config,
111
- this.dateProvider,
112
- this.log,
113
- );
91
+ this.reqRespTxsCollector = (requestTracker, blockTxsSource, pinnedPeer) =>
92
+ BatchTxRequester.collectAllTxs(
93
+ new BatchTxRequester(
94
+ requestTracker,
95
+ blockTxsSource,
96
+ pinnedPeer,
97
+ this.p2pService,
98
+ this.log,
99
+ this.dateProvider,
100
+ ).run(),
101
+ );
114
102
 
115
- this.hasFileStoreSources = fileStoreSources.length > 0;
116
- this.fileStoreSlowCollection = new FileStoreTxCollection(
117
- fileStoreSources,
118
- this.txCollectionSink,
119
- {
120
- workerCount: config.txCollectionFileStoreSlowWorkerCount,
121
- backoffBaseMs: config.txCollectionFileStoreSlowBackoffBaseMs,
122
- backoffMaxMs: config.txCollectionFileStoreSlowBackoffMaxMs,
123
- },
124
- this.dateProvider,
125
- this.log,
126
- );
127
103
  this.fileStoreFastCollection = new FileStoreTxCollection(
128
104
  fileStoreSources,
129
105
  this.txCollectionSink,
@@ -136,12 +112,6 @@ export class TxCollection {
136
112
  this.log,
137
113
  );
138
114
 
139
- this.reconcileFoundTxsLoop = new RunningPromise(
140
- () => this.reconcileFoundTxsWithPool(),
141
- this.log,
142
- this.config.txCollectionReconcileIntervalMs,
143
- );
144
-
145
115
  this.handleTxsFound = (args: Parameters<TxPoolV2Events['txs-added']>[0]) => {
146
116
  this.foundTxs(args.txs);
147
117
  };
@@ -156,76 +126,21 @@ export class TxCollection {
156
126
  this.txPool.on('txs-added', this.handleTxsAddedToPool);
157
127
  }
158
128
 
159
- /** Starts all collection loops. */
160
- public start(): Promise<void> {
161
- this.started = true;
162
- this.slowCollection.start();
163
- this.fileStoreSlowCollection.start();
164
- this.fileStoreFastCollection.start();
165
- this.reconcileFoundTxsLoop.start();
166
-
167
- // TODO(palla/txs): Collect mined unproven tx hashes for txs we dont have in the pool and populate missingTxs on startup
168
- return Promise.resolve();
169
- }
170
-
171
- /** Stops all activity. */
172
- public async stop() {
173
- this.started = false;
174
- await Promise.all([
175
- this.slowCollection.stop(),
176
- this.fastCollection.stop(),
177
- this.fileStoreSlowCollection.stop(),
178
- this.fileStoreFastCollection.stop(),
179
- this.reconcileFoundTxsLoop.stop(),
180
- ]);
129
+ /** Stops all activity. Cancels in-flight requests; file store workers self-terminate. */
130
+ public stop() {
131
+ this.requests.forEach(request => {
132
+ request.requestTracker.cancel();
133
+ });
181
134
 
182
135
  this.txPool.removeListener('txs-added', this.handleTxsAddedToPool);
183
136
  this.txCollectionSink.removeListener('txs-added', this.handleTxsFound);
184
137
  }
185
138
 
186
- /** Force trigger the slow collection and reconciliation loops */
187
- public async trigger() {
188
- await Promise.all([this.reconcileFoundTxsLoop.trigger(), this.slowCollection.trigger()]);
189
- }
190
-
191
139
  /** Returns L1 rollup constants. */
192
140
  public getConstants(): L1RollupConstants {
193
141
  return this.constants;
194
142
  }
195
143
 
196
- /** Starts collecting the given tx hashes for the given L2Block in the slow loop */
197
- public startCollecting(block: L2Block, txHashes: TxHash[]) {
198
- this.slowCollection.startCollecting(block, txHashes);
199
-
200
- // Delay file store collection to give P2P methods time to find txs first
201
- if (this.hasFileStoreSources) {
202
- const context: TxAddContext = { type: 'mined', block };
203
- const deadline = getProofDeadlineForSlot(block.header.getSlot(), this.constants);
204
- sleep(this.config.txCollectionFileStoreSlowDelayMs)
205
- .then(() => {
206
- if (this.started) {
207
- // Only queue txs that are still missing after the delay
208
- const stillMissing = new Set(this.slowCollection.getMissingTxHashes().map(h => h.toString()));
209
- const remaining = txHashes.filter(h => stillMissing.has(h.toString()));
210
- if (remaining.length > 0) {
211
- this.fileStoreSlowCollection.startCollecting(remaining, context, deadline);
212
- }
213
- }
214
- })
215
- .catch(err => this.log.error('Error in file store slow delay', err));
216
- }
217
- }
218
-
219
- /** Collects the set of txs for the given block proposal as fast as possible */
220
- public collectFastForProposal(
221
- blockProposal: BlockProposal,
222
- blockNumber: BlockNumber,
223
- txHashes: TxHash[] | string[],
224
- opts: { deadline: Date; pinnedPeer?: PeerId },
225
- ) {
226
- return this.collectFastFor({ type: 'proposal', blockProposal, blockNumber }, txHashes, opts);
227
- }
228
-
229
144
  /** Collects the set of txs for the given mined block as fast as possible */
230
145
  public collectFastForBlock(
231
146
  block: L2Block,
@@ -236,54 +151,307 @@ export class TxCollection {
236
151
  }
237
152
 
238
153
  /** Collects the set of txs for the given proposal or block as fast as possible */
239
- public collectFastFor(
154
+ public async collectFastFor(
240
155
  input: FastCollectionRequestInput,
241
156
  txHashes: TxHash[] | string[],
242
157
  opts: { deadline: Date; pinnedPeer?: PeerId },
243
158
  ) {
159
+ const timeout = opts.deadline.getTime() - this.dateProvider.now();
160
+ if (timeout <= 0) {
161
+ this.log.warn(`Deadline for fast tx collection is in the past (${timeout}ms)`, {
162
+ deadline: opts.deadline.getTime(),
163
+ now: this.dateProvider.now(),
164
+ });
165
+ return [];
166
+ }
167
+
244
168
  const hashes = txHashes.map(h => (typeof h === 'string' ? TxHash.fromString(h) : h));
245
169
 
246
- // Delay file store collection to give P2P methods time to find txs first
247
- if (this.hasFileStoreSources) {
248
- const context = this.getAddContextForInput(input);
249
- sleep(this.config.txCollectionFileStoreFastDelayMs)
250
- .then(() => {
251
- if (this.started) {
252
- this.fileStoreFastCollection.startCollecting(hashes, context, opts.deadline);
170
+ const blockInfo: L2BlockInfo =
171
+ input.type === 'proposal'
172
+ ? { ...input.blockProposal.toBlockInfo(), blockNumber: input.blockNumber }
173
+ : { ...input.block.toBlockInfo() };
174
+
175
+ const request: FastCollectionRequest = {
176
+ ...input,
177
+ blockInfo,
178
+ requestTracker: RequestTracker.create(hashes, opts.deadline, this.dateProvider),
179
+ };
180
+
181
+ const [duration] = await elapsed(() => this.collectFast(request, { pinnedPeer: opts.pinnedPeer }));
182
+
183
+ this.log.verbose(
184
+ `Collected ${request.requestTracker.collectedTxs.length} txs out of ${hashes.length} for ${input.type} at slot ${blockInfo.slotNumber}`,
185
+ {
186
+ ...blockInfo,
187
+ duration,
188
+ requestType: input.type,
189
+ missingTxs: [...request.requestTracker.missingTxHashes],
190
+ },
191
+ );
192
+ return request.requestTracker.collectedTxs;
193
+ }
194
+
195
+ protected async collectFast(request: FastCollectionRequest, opts: { pinnedPeer?: PeerId }) {
196
+ this.requests.add(request);
197
+ const { blockInfo } = request;
198
+
199
+ this.log.debug(
200
+ `Starting fast collection of ${request.requestTracker.numberOfMissingTxs} txs for ${request.type} at slot ${blockInfo.slotNumber}`,
201
+ { ...blockInfo, requestType: request.type, deadline: request.requestTracker.deadline },
202
+ );
203
+
204
+ try {
205
+ // 1. Start node collection in the background.
206
+ // Note: this will be a noop if no nodes are configured.
207
+ const nodeCollectionPromise = this.collectFastFromNodes(request);
208
+
209
+ // 2. Wait before starting reqresp, interruptible by cancellation or node exhaustion.
210
+ await Promise.race([
211
+ request.requestTracker.cancellationToken,
212
+ sleep(this.config.txCollectionFastNodesTimeoutBeforeReqRespMs),
213
+ nodeCollectionPromise, // If node collection has finished (or if there are no nodes configured), we can exit early.
214
+ ]);
215
+
216
+ // 3. Start reqresp in the background (runs in parallel with node collection).
217
+ // Note: this will be a noop if all TXs were already found.
218
+ const reqRespPromise = this.collectFastViaReqResp(request, opts);
219
+
220
+ // 4. Wait before starting file store, interruptible by cancellation.
221
+ await Promise.race([
222
+ request.requestTracker.cancellationToken,
223
+ sleep(this.config.txCollectionFileStoreFastDelayMs),
224
+ reqRespPromise, // If reqresp has finished, we can exit early.
225
+ ]);
226
+
227
+ // 5. Start file store collection in the background. Self-terminates on tracker cancel / all-found.
228
+ // Note: this will be a noop if all TXs were already found.
229
+ const fileStorePromise = this.fileStoreFastCollection.startCollecting(
230
+ request.requestTracker,
231
+ this.getAddContext(request),
232
+ );
233
+
234
+ // 6. Wait for all paths to settle.
235
+ // NOTE: The request will automatically be cancelled after `opt.deadline` is reached.
236
+ await Promise.allSettled([reqRespPromise, nodeCollectionPromise, fileStorePromise]);
237
+ } catch (err) {
238
+ this.log.error(`Error collecting txs for ${request.type} for slot ${blockInfo.slotNumber}`, err, {
239
+ ...blockInfo,
240
+ missingTxs: request.requestTracker.missingTxHashes.values().map(txHash => txHash.toString()),
241
+ });
242
+ } finally {
243
+ request.requestTracker.cancel();
244
+ this.requests.delete(request);
245
+ }
246
+ }
247
+
248
+ /**
249
+ * Starts collecting txs from all configured nodes. We send `txCollectionFastMaxParallelRequestsPerNode` requests
250
+ * in parallel to each node. We keep track of the number of attempts made to collect each tx, so we can prioritize
251
+ * the txs that have been requested less often whenever we need to send a new batch of requests. We ensure that no
252
+ * tx is requested more than once at the same time to the same node.
253
+ */
254
+ private async collectFastFromNodes(request: FastCollectionRequest): Promise<void> {
255
+ if (this.nodes.length === 0) {
256
+ return;
257
+ }
258
+
259
+ // Keep a shared priority queue of all txs pending to be requested, sorted by the number of attempts made to collect them.
260
+ const attemptsPerTx = [...request.requestTracker.missingTxHashes].map(txHash => ({
261
+ txHash,
262
+ attempts: 0,
263
+ found: false,
264
+ }));
265
+
266
+ // Returns once we have finished all node loops. Each loop finishes when the deadline is hit, or all txs have been collected.
267
+ await Promise.allSettled(this.nodes.map(node => this.collectFastFromNode(request, node, attemptsPerTx)));
268
+ }
269
+
270
+ private async collectFastFromNode(
271
+ request: FastCollectionRequest,
272
+ node: TxSource,
273
+ attemptsPerTx: { txHash: string; attempts: number; found: boolean }[],
274
+ ) {
275
+ const notFinished = () => !request.requestTracker.checkCancelled();
276
+
277
+ const maxParallelRequests = this.config.txCollectionFastMaxParallelRequestsPerNode;
278
+ const maxBatchSize = this.config.txCollectionNodeRpcMaxBatchSize;
279
+ const activeRequestsToThisNode = new Set<string>(); // Track the txs being actively requested to this node
280
+
281
+ const processBatch = async () => {
282
+ while (notFinished()) {
283
+ // Pull tx hashes from the attemptsPerTx array, which is sorted by attempts,
284
+ // so we prioritize txs that have been requested less often.
285
+ const batch = [];
286
+ let index = 0;
287
+ while (batch.length < maxBatchSize) {
288
+ const txToRequest = attemptsPerTx[index++];
289
+ if (!txToRequest) {
290
+ // No more txs to process
291
+ break;
292
+ } else if (!request.requestTracker.isMissing(txToRequest.txHash)) {
293
+ // Mark as found if it was found somewhere else, we'll then remove it from the array.
294
+ // We don't delete it now since 'array.splice' is pretty expensive, so we do it after sorting.
295
+ txToRequest.found = true;
296
+ } else if (!activeRequestsToThisNode.has(txToRequest.txHash)) {
297
+ // If the tx is not already being requested to this node, add it to the current batch and increase attempts.
298
+ // Note that we increase the attempts *before* making the request, so the next `collectFastFromNode` that
299
+ // needs to grab txs to send, will pick txs that have been requested less often, instead of all requesting
300
+ // the same txs at the same time.
301
+ batch.push(txToRequest);
302
+ activeRequestsToThisNode.add(txToRequest.txHash);
303
+ txToRequest.attempts++;
253
304
  }
254
- })
255
- .catch(err => this.log.error('Error in file store fast delay', err));
305
+ }
306
+
307
+ // After modifying the array by removing txs or updating attempts, re-sort it and trim the found txs from the end.
308
+ attemptsPerTx.sort((a, b) =>
309
+ a.found === b.found ? a.attempts - b.attempts : Number(a.found) - Number(b.found),
310
+ );
311
+ const firstFoundTxIndex = attemptsPerTx.findIndex(tx => tx.found);
312
+ if (firstFoundTxIndex !== -1) {
313
+ attemptsPerTx.length = firstFoundTxIndex;
314
+ }
315
+
316
+ // If we see no more txs to request, we can stop this "process" loop
317
+ if (batch.length === 0) {
318
+ return;
319
+ }
320
+
321
+ const txHashes = batch.map(({ txHash }) => txHash);
322
+ // Collect this batch from the node
323
+ await this.txCollectionSink.collect(
324
+ async () => {
325
+ const result = await node.getTxsByHash(txHashes.map(TxHash.fromString));
326
+ for (const tx of result.validTxs) {
327
+ request.requestTracker.markFetched(tx);
328
+ }
329
+ return result;
330
+ },
331
+ txHashes,
332
+ {
333
+ description: `fast ${node.getInfo()}`,
334
+ node: node.getInfo(),
335
+ method: 'fast-node-rpc',
336
+ ...request.blockInfo,
337
+ },
338
+ this.getAddContext(request),
339
+ );
340
+
341
+ // Clear from the active requests the txs we just requested
342
+ for (const requestedTx of batch) {
343
+ activeRequestsToThisNode.delete(requestedTx.txHash);
344
+ }
345
+
346
+ // Sleep a bit until hitting the node again, but wake up immediately on cancellation
347
+ if (notFinished()) {
348
+ await Promise.race([
349
+ sleep(this.config.txCollectionFastNodeIntervalMs),
350
+ request.requestTracker.cancellationToken,
351
+ ]);
352
+ }
353
+ }
354
+ };
355
+
356
+ // Kick off N parallel requests to the node, up to the maxParallelRequests limit
357
+ await Promise.all(times(maxParallelRequests, processBatch));
358
+ }
359
+
360
+ private async collectFastViaReqResp(request: FastCollectionRequest, opts: { pinnedPeer?: PeerId }) {
361
+ const pinnedPeer = opts.pinnedPeer;
362
+ const blockInfo = request.blockInfo;
363
+ const slotNumber = blockInfo.slotNumber;
364
+ if (request.requestTracker.timeoutMs < 100) {
365
+ this.log.warn(
366
+ `Not initiating fast reqresp for txs for ${request.type} at slot ${blockInfo.slotNumber} due to timeout`,
367
+ { timeoutMs: request.requestTracker.timeoutMs, ...blockInfo },
368
+ );
369
+ return;
370
+ }
371
+
372
+ if (request.requestTracker.checkCancelled()) {
373
+ this.log.debug(`No txs to collect via reqresp for ${request.type} at slot ${blockInfo.slotNumber}`, {
374
+ ...blockInfo,
375
+ });
376
+ return;
256
377
  }
257
378
 
258
- return this.fastCollection.collectFastFor(input, txHashes, opts);
379
+ this.log.debug(
380
+ `Starting fast reqresp for ${request.requestTracker.numberOfMissingTxs} txs for ${request.type} at slot ${blockInfo.slotNumber}`,
381
+ { ...blockInfo, timeoutMs: request.requestTracker.timeoutMs, pinnedPeer },
382
+ );
383
+
384
+ try {
385
+ await this.txCollectionSink.collect(
386
+ async () => {
387
+ let blockTxsSource: BlockTxsSource;
388
+ if (request.type === 'proposal') {
389
+ blockTxsSource = request.blockProposal;
390
+ } else if (request.type === 'block') {
391
+ blockTxsSource = {
392
+ txHashes: request.block.body.txEffects.map(e => e.txHash),
393
+ archive: request.block.archive.root,
394
+ };
395
+ } else {
396
+ throw new Error(`Unknown request type: ${(request as { type: string }).type}`);
397
+ }
398
+
399
+ const result = await this.reqRespTxsCollector!(request.requestTracker, blockTxsSource, pinnedPeer);
400
+ return { validTxs: result, invalidTxHashes: [] };
401
+ },
402
+ Array.from(request.requestTracker.missingTxHashes),
403
+ { description: `reqresp for slot ${slotNumber}`, method: 'fast-req-resp', ...opts, ...request.blockInfo },
404
+ this.getAddContext(request),
405
+ );
406
+ } catch (err) {
407
+ this.log.error(`Error sending fast reqresp request for txs`, err, {
408
+ txs: [...request.requestTracker.missingTxHashes],
409
+ ...blockInfo,
410
+ });
411
+ }
259
412
  }
260
413
 
261
- /** Returns the TxAddContext for the given fast collection request input */
262
- private getAddContextForInput(input: FastCollectionRequestInput): TxAddContext {
263
- if (input.type === 'proposal') {
264
- return { type: 'proposal', blockHeader: input.blockProposal.blockHeader };
414
+ /** Returns the TxAddContext for the given request, used by the sink to add txs to the pool correctly. */
415
+ private getAddContext(request: FastCollectionRequest): TxAddContext {
416
+ if (request.type === 'proposal') {
417
+ return { type: 'proposal', blockHeader: request.blockProposal.blockHeader };
265
418
  } else {
266
- return { type: 'mined', block: input.block };
419
+ return { type: 'mined', block: request.block };
267
420
  }
268
421
  }
269
422
 
270
- /** Mark the given txs as found. Stops collecting them. */
423
+ /** Mark the given txs as found. Stops collecting them across all in-flight requests. */
271
424
  private foundTxs(txs: Tx[]) {
272
- this.slowCollection.foundTxs(txs);
273
- this.fastCollection.foundTxs(txs);
274
- this.fileStoreSlowCollection.foundTxs(txs);
275
- this.fileStoreFastCollection.foundTxs(txs);
425
+ for (const request of this.requests) {
426
+ for (const tx of txs) {
427
+ if (request.requestTracker.markFetched(tx)) {
428
+ this.log.trace(`Found tx ${tx.txHash.toString()} for fast collection request`, {
429
+ ...request.blockInfo,
430
+ txHash: tx.txHash.toString(),
431
+ type: request.type,
432
+ });
433
+ if (request.requestTracker.allFetched()) {
434
+ this.log.trace(`All txs found for fast collection request`, {
435
+ ...request.blockInfo,
436
+ type: request.type,
437
+ });
438
+ break;
439
+ }
440
+ }
441
+ }
442
+ }
276
443
  }
277
444
 
278
445
  /**
279
- * Stop collecting all txs for blocks less than or requal to the block number specified.
446
+ * Stop collecting all txs for blocks less than or equal to the block number specified.
280
447
  * To be called when we no longer care about gathering txs up to a certain block, eg when they become proven or finalized.
281
448
  */
282
449
  public stopCollectingForBlocksUpTo(blockNumber: BlockNumber): void {
283
- this.slowCollection.stopCollectingForBlocksUpTo(blockNumber);
284
- this.fastCollection.stopCollectingForBlocksUpTo(blockNumber);
285
- this.fileStoreSlowCollection.clearPending();
286
- this.fileStoreFastCollection.clearPending();
450
+ for (const request of this.requests) {
451
+ if (request.blockInfo.blockNumber <= blockNumber) {
452
+ request.requestTracker.cancel();
453
+ }
454
+ }
287
455
  }
288
456
 
289
457
  /**
@@ -291,21 +459,10 @@ export class TxCollection {
291
459
  * To be called when there is a chain prune and previously mined txs are no longer relevant.
292
460
  */
293
461
  public stopCollectingForBlocksAfter(blockNumber: BlockNumber): void {
294
- this.slowCollection.stopCollectingForBlocksAfter(blockNumber);
295
- this.fastCollection.stopCollectingForBlocksAfter(blockNumber);
296
- this.fileStoreSlowCollection.clearPending();
297
- this.fileStoreFastCollection.clearPending();
298
- }
299
-
300
- /** Every now and then, check if the pool has received one of the txs we are looking for, just to catch any race conditions */
301
- private async reconcileFoundTxsWithPool() {
302
- const missingTxHashes = this.slowCollection.getMissingTxHashes();
303
- const foundTxs = compactArray(await this.txPool.getTxsByHash(missingTxHashes));
304
- if (foundTxs.length > 0) {
305
- this.log.verbose(`Found ${foundTxs.length} txs in the pool during reconciliation`, {
306
- foundTxs: foundTxs.map(t => t.getTxHash().toString()),
307
- });
308
- this.foundTxs(foundTxs);
462
+ for (const request of this.requests) {
463
+ if (request.blockInfo.blockNumber > blockNumber) {
464
+ request.requestTracker.cancel();
465
+ }
309
466
  }
310
467
  }
311
468
  }
@@ -16,7 +16,7 @@ import type { TxSourceCollectionResult } from './tx_source.js';
16
16
  export type TxAddContext = { type: 'proposal'; blockHeader: BlockHeader } | { type: 'mined'; block: L2Block };
17
17
 
18
18
  /**
19
- * Executes collection requests from the fast and slow collection loops, and handles collected txs
19
+ * Executes collection requests from fast collection paths, and handles collected txs
20
20
  * by adding them to the tx pool and emitting events, as well as handling logging and metrics.
21
21
  */
22
22
  export class TxCollectionSink extends (EventEmitter as new () => TypedEventEmitter<TxPoolV2Events>) {
@@ -101,7 +101,7 @@ export class TxCollectionSink extends (EventEmitter as new () => TypedEventEmitt
101
101
  // Report metrics for the collection
102
102
  this.instrumentation.increaseTxsFor(info.method, txs.length, info.duration);
103
103
 
104
- // Mark txs as found in the slow missing txs set and all fast requests
104
+ // Mark txs as found in all in-flight collection requests
105
105
  this.emit('txs-added', { txs });
106
106
 
107
107
  // Add the txs to the tx pool using the appropriate method based on context