@aztec/p2p 0.0.1-commit.96dac018d → 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 (455) hide show
  1. package/README.md +129 -3
  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 +9 -1
  5. package/dest/client/factory.d.ts +7 -7
  6. package/dest/client/factory.d.ts.map +1 -1
  7. package/dest/client/factory.js +34 -16
  8. package/dest/client/interface.d.ts +17 -8
  9. package/dest/client/interface.d.ts.map +1 -1
  10. package/dest/client/p2p_client.d.ts +15 -11
  11. package/dest/client/p2p_client.d.ts.map +1 -1
  12. package/dest/client/p2p_client.js +93 -49
  13. package/dest/config.d.ts +153 -102
  14. package/dest/config.d.ts.map +1 -1
  15. package/dest/config.js +134 -35
  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 +99 -59
  26. package/dest/mem_pools/attestation_pool/attestation_pool.d.ts.map +1 -1
  27. package/dest/mem_pools/attestation_pool/attestation_pool.js +267 -197
  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 +181 -65
  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 +4 -2
  37. package/dest/mem_pools/instrumentation.d.ts.map +1 -1
  38. package/dest/mem_pools/instrumentation.js +33 -15
  39. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.d.ts +1 -1
  40. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.d.ts.map +1 -1
  41. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.js +2 -1
  42. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.d.ts +1 -1
  43. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.d.ts.map +1 -1
  44. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.js +2 -0
  45. package/dest/mem_pools/tx_pool_v2/eviction/index.d.ts +2 -1
  46. package/dest/mem_pools/tx_pool_v2/eviction/index.d.ts.map +1 -1
  47. package/dest/mem_pools/tx_pool_v2/eviction/index.js +1 -0
  48. package/dest/mem_pools/tx_pool_v2/eviction/insufficient_fee_per_gas_eviction_rule.d.ts +16 -0
  49. package/dest/mem_pools/tx_pool_v2/eviction/insufficient_fee_per_gas_eviction_rule.d.ts.map +1 -0
  50. package/dest/mem_pools/tx_pool_v2/eviction/insufficient_fee_per_gas_eviction_rule.js +62 -0
  51. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.d.ts +7 -1
  52. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.d.ts.map +1 -1
  53. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.js +2 -2
  54. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.d.ts +1 -1
  55. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.d.ts.map +1 -1
  56. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.js +8 -6
  57. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.d.ts +2 -2
  58. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.d.ts.map +1 -1
  59. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.js +2 -2
  60. package/dest/mem_pools/tx_pool_v2/index.d.ts +2 -2
  61. package/dest/mem_pools/tx_pool_v2/index.d.ts.map +1 -1
  62. package/dest/mem_pools/tx_pool_v2/index.js +1 -1
  63. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts +12 -5
  64. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts.map +1 -1
  65. package/dest/mem_pools/tx_pool_v2/interfaces.js +2 -1
  66. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts +44 -12
  67. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts.map +1 -1
  68. package/dest/mem_pools/tx_pool_v2/tx_metadata.js +81 -22
  69. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.d.ts +1 -1
  70. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.d.ts.map +1 -1
  71. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.js +26 -44
  72. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts +4 -2
  73. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts.map +1 -1
  74. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.js +6 -0
  75. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts +2 -1
  76. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts.map +1 -1
  77. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.js +133 -110
  78. package/dest/msg_validators/attestation_validator/attestation_validator.d.ts +9 -3
  79. package/dest/msg_validators/attestation_validator/attestation_validator.d.ts.map +1 -1
  80. package/dest/msg_validators/attestation_validator/attestation_validator.js +37 -12
  81. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts +7 -3
  82. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts.map +1 -1
  83. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.js +4 -5
  84. package/dest/msg_validators/clock_tolerance.d.ts +12 -1
  85. package/dest/msg_validators/clock_tolerance.d.ts.map +1 -1
  86. package/dest/msg_validators/clock_tolerance.js +61 -3
  87. package/dest/msg_validators/proposal_validator/block_proposal_validator.d.ts +10 -4
  88. package/dest/msg_validators/proposal_validator/block_proposal_validator.d.ts.map +1 -1
  89. package/dest/msg_validators/proposal_validator/block_proposal_validator.js +10 -2
  90. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.d.ts +10 -4
  91. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.d.ts.map +1 -1
  92. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.js +16 -2
  93. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts +21 -8
  94. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts.map +1 -1
  95. package/dest/msg_validators/proposal_validator/proposal_validator.js +90 -44
  96. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts +1 -1
  97. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts.map +1 -1
  98. package/dest/msg_validators/tx_validator/aggregate_tx_validator.js +8 -15
  99. package/dest/msg_validators/tx_validator/allowed_public_setup.d.ts +2 -1
  100. package/dest/msg_validators/tx_validator/allowed_public_setup.d.ts.map +1 -1
  101. package/dest/msg_validators/tx_validator/allowed_public_setup.js +25 -21
  102. package/dest/msg_validators/tx_validator/allowed_setup_helpers.d.ts +17 -0
  103. package/dest/msg_validators/tx_validator/allowed_setup_helpers.d.ts.map +1 -0
  104. package/dest/msg_validators/tx_validator/allowed_setup_helpers.js +24 -0
  105. package/dest/msg_validators/tx_validator/archive_cache.js +1 -1
  106. package/dest/msg_validators/tx_validator/cached_tx_validator.d.ts +15 -0
  107. package/dest/msg_validators/tx_validator/cached_tx_validator.d.ts.map +1 -0
  108. package/dest/msg_validators/tx_validator/cached_tx_validator.js +19 -0
  109. package/dest/msg_validators/tx_validator/contract_instance_validator.d.ts +9 -0
  110. package/dest/msg_validators/tx_validator/contract_instance_validator.d.ts.map +1 -0
  111. package/dest/msg_validators/tx_validator/contract_instance_validator.js +48 -0
  112. package/dest/msg_validators/tx_validator/data_validator.d.ts +2 -1
  113. package/dest/msg_validators/tx_validator/data_validator.d.ts.map +1 -1
  114. package/dest/msg_validators/tx_validator/data_validator.js +36 -2
  115. package/dest/msg_validators/tx_validator/factory.d.ts +27 -7
  116. package/dest/msg_validators/tx_validator/factory.d.ts.map +1 -1
  117. package/dest/msg_validators/tx_validator/factory.js +47 -17
  118. package/dest/msg_validators/tx_validator/fee_payer_balance.d.ts +1 -1
  119. package/dest/msg_validators/tx_validator/fee_payer_balance.d.ts.map +1 -1
  120. package/dest/msg_validators/tx_validator/fee_payer_balance.js +6 -2
  121. package/dest/msg_validators/tx_validator/gas_validator.d.ts +48 -7
  122. package/dest/msg_validators/tx_validator/gas_validator.d.ts.map +1 -1
  123. package/dest/msg_validators/tx_validator/gas_validator.js +88 -41
  124. package/dest/msg_validators/tx_validator/index.d.ts +4 -1
  125. package/dest/msg_validators/tx_validator/index.d.ts.map +1 -1
  126. package/dest/msg_validators/tx_validator/index.js +3 -0
  127. package/dest/msg_validators/tx_validator/metadata_validator.d.ts +1 -1
  128. package/dest/msg_validators/tx_validator/metadata_validator.d.ts.map +1 -1
  129. package/dest/msg_validators/tx_validator/metadata_validator.js +4 -4
  130. package/dest/msg_validators/tx_validator/phases_validator.d.ts +22 -2
  131. package/dest/msg_validators/tx_validator/phases_validator.d.ts.map +1 -1
  132. package/dest/msg_validators/tx_validator/phases_validator.js +72 -24
  133. package/dest/msg_validators/tx_validator/tx_proof_validator.d.ts +2 -1
  134. package/dest/msg_validators/tx_validator/tx_proof_validator.d.ts.map +1 -1
  135. package/dest/msg_validators/tx_validator/tx_proof_validator.js +2 -0
  136. package/dest/msg_validators/tx_validator/tx_validation_cache.d.ts +48 -0
  137. package/dest/msg_validators/tx_validator/tx_validation_cache.d.ts.map +1 -0
  138. package/dest/msg_validators/tx_validator/tx_validation_cache.js +69 -0
  139. package/dest/services/data_store.d.ts +1 -1
  140. package/dest/services/data_store.d.ts.map +1 -1
  141. package/dest/services/data_store.js +5 -5
  142. package/dest/services/discv5/discV5_service.d.ts +2 -1
  143. package/dest/services/discv5/discV5_service.d.ts.map +1 -1
  144. package/dest/services/discv5/discV5_service.js +35 -8
  145. package/dest/services/dummy_service.d.ts +11 -15
  146. package/dest/services/dummy_service.d.ts.map +1 -1
  147. package/dest/services/dummy_service.js +12 -16
  148. package/dest/services/encoding.d.ts +6 -2
  149. package/dest/services/encoding.d.ts.map +1 -1
  150. package/dest/services/encoding.js +14 -8
  151. package/dest/services/gossipsub/topic_score_params.d.ts +13 -2
  152. package/dest/services/gossipsub/topic_score_params.d.ts.map +1 -1
  153. package/dest/services/gossipsub/topic_score_params.js +21 -4
  154. package/dest/services/libp2p/instrumentation.d.ts +3 -1
  155. package/dest/services/libp2p/instrumentation.d.ts.map +1 -1
  156. package/dest/services/libp2p/instrumentation.js +14 -0
  157. package/dest/services/libp2p/libp2p_service.d.ts +39 -50
  158. package/dest/services/libp2p/libp2p_service.d.ts.map +1 -1
  159. package/dest/services/libp2p/libp2p_service.js +299 -250
  160. package/dest/services/peer-manager/metrics.d.ts +3 -1
  161. package/dest/services/peer-manager/metrics.d.ts.map +1 -1
  162. package/dest/services/peer-manager/metrics.js +6 -0
  163. package/dest/services/peer-manager/peer_manager.d.ts +6 -2
  164. package/dest/services/peer-manager/peer_manager.d.ts.map +1 -1
  165. package/dest/services/peer-manager/peer_manager.js +40 -11
  166. package/dest/services/peer-manager/peer_scoring.d.ts +7 -2
  167. package/dest/services/peer-manager/peer_scoring.d.ts.map +1 -1
  168. package/dest/services/peer-manager/peer_scoring.js +32 -10
  169. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts +11 -8
  170. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts.map +1 -1
  171. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.js +84 -71
  172. package/dest/services/reqresp/batch-tx-requester/interface.d.ts +10 -6
  173. package/dest/services/reqresp/batch-tx-requester/interface.d.ts.map +1 -1
  174. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts +5 -4
  175. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts.map +1 -1
  176. package/dest/services/reqresp/batch-tx-requester/missing_txs.js +13 -7
  177. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts +3 -1
  178. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts.map +1 -1
  179. package/dest/services/reqresp/batch-tx-requester/peer_collection.js +3 -0
  180. package/dest/services/reqresp/batch-tx-requester/tx_validator.d.ts +5 -14
  181. package/dest/services/reqresp/batch-tx-requester/tx_validator.d.ts.map +1 -1
  182. package/dest/services/reqresp/batch-tx-requester/tx_validator.js +6 -20
  183. package/dest/services/reqresp/config.d.ts +3 -3
  184. package/dest/services/reqresp/config.d.ts.map +1 -1
  185. package/dest/services/reqresp/interface.d.ts +16 -18
  186. package/dest/services/reqresp/interface.d.ts.map +1 -1
  187. package/dest/services/reqresp/interface.js +10 -20
  188. package/dest/services/reqresp/metrics.d.ts +1 -1
  189. package/dest/services/reqresp/metrics.d.ts.map +1 -1
  190. package/dest/services/reqresp/metrics.js +0 -1
  191. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts +1 -1
  192. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts.map +1 -1
  193. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.js +4 -2
  194. package/dest/services/reqresp/protocols/index.d.ts +1 -2
  195. package/dest/services/reqresp/protocols/index.d.ts.map +1 -1
  196. package/dest/services/reqresp/protocols/index.js +0 -1
  197. package/dest/services/reqresp/protocols/tx.d.ts +1 -1
  198. package/dest/services/reqresp/protocols/tx.d.ts.map +1 -1
  199. package/dest/services/reqresp/protocols/tx.js +1 -3
  200. package/dest/services/reqresp/rate-limiter/rate_limiter.d.ts +5 -4
  201. package/dest/services/reqresp/rate-limiter/rate_limiter.d.ts.map +1 -1
  202. package/dest/services/reqresp/rate-limiter/rate_limiter.js +10 -8
  203. package/dest/services/reqresp/rate-limiter/rate_limits.d.ts +1 -1
  204. package/dest/services/reqresp/rate-limiter/rate_limits.d.ts.map +1 -1
  205. package/dest/services/reqresp/rate-limiter/rate_limits.js +0 -10
  206. package/dest/services/reqresp/reqresp.d.ts +7 -29
  207. package/dest/services/reqresp/reqresp.d.ts.map +1 -1
  208. package/dest/services/reqresp/reqresp.js +43 -215
  209. package/dest/services/service.d.ts +9 -12
  210. package/dest/services/service.d.ts.map +1 -1
  211. package/dest/services/tx_collection/config.d.ts +2 -23
  212. package/dest/services/tx_collection/config.d.ts.map +1 -1
  213. package/dest/services/tx_collection/config.js +2 -55
  214. package/dest/services/tx_collection/file_store_tx_collection.d.ts +12 -28
  215. package/dest/services/tx_collection/file_store_tx_collection.d.ts.map +1 -1
  216. package/dest/services/tx_collection/file_store_tx_collection.js +43 -83
  217. package/dest/services/tx_collection/file_store_tx_source.d.ts +5 -4
  218. package/dest/services/tx_collection/file_store_tx_source.d.ts.map +1 -1
  219. package/dest/services/tx_collection/file_store_tx_source.js +39 -29
  220. package/dest/services/tx_collection/index.d.ts +2 -3
  221. package/dest/services/tx_collection/index.d.ts.map +1 -1
  222. package/dest/services/tx_collection/index.js +0 -1
  223. package/dest/services/tx_collection/instrumentation.d.ts +1 -1
  224. package/dest/services/tx_collection/instrumentation.d.ts.map +1 -1
  225. package/dest/services/tx_collection/instrumentation.js +0 -2
  226. package/dest/services/tx_collection/request_tracker.d.ts +53 -0
  227. package/dest/services/tx_collection/request_tracker.d.ts.map +1 -0
  228. package/dest/services/tx_collection/request_tracker.js +84 -0
  229. package/dest/services/tx_collection/tx_collection.d.ts +36 -55
  230. package/dest/services/tx_collection/tx_collection.d.ts.map +1 -1
  231. package/dest/services/tx_collection/tx_collection.js +275 -119
  232. package/dest/services/tx_collection/tx_collection_sink.d.ts +1 -1
  233. package/dest/services/tx_collection/tx_collection_sink.js +2 -2
  234. package/dest/services/tx_collection/tx_source.d.ts +6 -5
  235. package/dest/services/tx_collection/tx_source.d.ts.map +1 -1
  236. package/dest/services/tx_collection/tx_source.js +9 -7
  237. package/dest/services/tx_file_store/tx_file_store.d.ts +1 -3
  238. package/dest/services/tx_file_store/tx_file_store.d.ts.map +1 -1
  239. package/dest/services/tx_file_store/tx_file_store.js +4 -14
  240. package/dest/services/tx_provider.d.ts +3 -1
  241. package/dest/services/tx_provider.d.ts.map +1 -1
  242. package/dest/services/tx_provider.js +3 -0
  243. package/dest/test-helpers/make-test-p2p-clients.d.ts +5 -6
  244. package/dest/test-helpers/make-test-p2p-clients.d.ts.map +1 -1
  245. package/dest/test-helpers/make-test-p2p-clients.js +5 -3
  246. package/dest/test-helpers/mock-pubsub.d.ts +24 -11
  247. package/dest/test-helpers/mock-pubsub.d.ts.map +1 -1
  248. package/dest/test-helpers/mock-pubsub.js +45 -45
  249. package/dest/test-helpers/reqresp-nodes.d.ts +5 -7
  250. package/dest/test-helpers/reqresp-nodes.d.ts.map +1 -1
  251. package/dest/test-helpers/reqresp-nodes.js +17 -19
  252. package/dest/test-helpers/test_tx_provider.d.ts +3 -1
  253. package/dest/test-helpers/test_tx_provider.d.ts.map +1 -1
  254. package/dest/test-helpers/test_tx_provider.js +3 -0
  255. package/dest/test-helpers/testbench-utils.d.ts +12 -14
  256. package/dest/test-helpers/testbench-utils.d.ts.map +1 -1
  257. package/dest/test-helpers/testbench-utils.js +42 -15
  258. package/dest/testbench/p2p_client_testbench_worker.d.ts +3 -5
  259. package/dest/testbench/p2p_client_testbench_worker.d.ts.map +1 -1
  260. package/dest/testbench/p2p_client_testbench_worker.js +88 -42
  261. package/dest/testbench/worker_client_manager.d.ts +12 -6
  262. package/dest/testbench/worker_client_manager.d.ts.map +1 -1
  263. package/dest/testbench/worker_client_manager.js +57 -11
  264. package/dest/util.d.ts +12 -7
  265. package/dest/util.d.ts.map +1 -1
  266. package/dest/util.js +35 -14
  267. package/dest/versioning.d.ts +3 -6
  268. package/dest/versioning.d.ts.map +1 -1
  269. package/dest/versioning.js +3 -24
  270. package/package.json +15 -14
  271. package/src/bootstrap/bootstrap.ts +9 -1
  272. package/src/client/factory.ts +65 -21
  273. package/src/client/interface.ts +18 -20
  274. package/src/client/p2p_client.ts +108 -82
  275. package/src/client/test/{tx_proposal_collector/README.md → p2p_client.batch_tx_requester.bench.README.md} +23 -53
  276. package/src/config.ts +226 -36
  277. package/src/errors/p2p-service.error.ts +11 -0
  278. package/src/errors/reqresp.error.ts +0 -25
  279. package/src/index.ts +0 -1
  280. package/src/mem_pools/attestation_pool/attestation_pool.ts +318 -242
  281. package/src/mem_pools/attestation_pool/attestation_pool_test_suite.ts +204 -68
  282. package/src/mem_pools/attestation_pool/mocks.ts +13 -8
  283. package/src/mem_pools/index.ts +0 -3
  284. package/src/mem_pools/instrumentation.ts +22 -14
  285. package/src/mem_pools/tx_pool_v2/README.md +9 -1
  286. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.ts +2 -1
  287. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.ts +3 -0
  288. package/src/mem_pools/tx_pool_v2/eviction/index.ts +1 -0
  289. package/src/mem_pools/tx_pool_v2/eviction/insufficient_fee_per_gas_eviction_rule.ts +65 -0
  290. package/src/mem_pools/tx_pool_v2/eviction/interfaces.ts +11 -1
  291. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.ts +3 -3
  292. package/src/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.ts +15 -6
  293. package/src/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.ts +2 -1
  294. package/src/mem_pools/tx_pool_v2/index.ts +1 -1
  295. package/src/mem_pools/tx_pool_v2/interfaces.ts +12 -4
  296. package/src/mem_pools/tx_pool_v2/tx_metadata.ts +121 -27
  297. package/src/mem_pools/tx_pool_v2/tx_pool_indices.ts +29 -43
  298. package/src/mem_pools/tx_pool_v2/tx_pool_v2.ts +16 -1
  299. package/src/mem_pools/tx_pool_v2/tx_pool_v2_impl.ts +141 -114
  300. package/src/msg_validators/attestation_validator/README.md +49 -0
  301. package/src/msg_validators/attestation_validator/attestation_validator.ts +41 -9
  302. package/src/msg_validators/attestation_validator/fisherman_attestation_validator.ts +14 -7
  303. package/src/msg_validators/clock_tolerance.ts +79 -3
  304. package/src/msg_validators/proposal_validator/README.md +123 -0
  305. package/src/msg_validators/proposal_validator/block_proposal_validator.ts +24 -4
  306. package/src/msg_validators/proposal_validator/checkpoint_proposal_validator.ts +35 -7
  307. package/src/msg_validators/proposal_validator/proposal_validator.ts +114 -47
  308. package/src/msg_validators/tx_validator/README.md +15 -3
  309. package/src/msg_validators/tx_validator/aggregate_tx_validator.ts +3 -12
  310. package/src/msg_validators/tx_validator/allowed_public_setup.ts +22 -27
  311. package/src/msg_validators/tx_validator/allowed_setup_helpers.ts +31 -0
  312. package/src/msg_validators/tx_validator/archive_cache.ts +1 -1
  313. package/src/msg_validators/tx_validator/cached_tx_validator.ts +31 -0
  314. package/src/msg_validators/tx_validator/contract_instance_validator.ts +56 -0
  315. package/src/msg_validators/tx_validator/data_validator.ts +44 -1
  316. package/src/msg_validators/tx_validator/factory.ts +61 -10
  317. package/src/msg_validators/tx_validator/fee_payer_balance.ts +6 -2
  318. package/src/msg_validators/tx_validator/gas_validator.ts +121 -39
  319. package/src/msg_validators/tx_validator/index.ts +3 -0
  320. package/src/msg_validators/tx_validator/metadata_validator.ts +12 -4
  321. package/src/msg_validators/tx_validator/phases_validator.ts +82 -27
  322. package/src/msg_validators/tx_validator/tx_proof_validator.ts +2 -0
  323. package/src/msg_validators/tx_validator/tx_validation_cache.ts +102 -0
  324. package/src/services/data_store.ts +5 -13
  325. package/src/services/discv5/discV5_service.ts +38 -5
  326. package/src/services/dummy_service.ts +14 -39
  327. package/src/services/encoding.ts +14 -7
  328. package/src/services/gossipsub/topic_score_params.ts +36 -4
  329. package/src/services/libp2p/instrumentation.ts +14 -0
  330. package/src/services/libp2p/libp2p_service.ts +326 -287
  331. package/src/services/peer-manager/metrics.ts +7 -0
  332. package/src/services/peer-manager/peer_manager.ts +46 -11
  333. package/src/services/peer-manager/peer_scoring.ts +27 -5
  334. package/src/services/reqresp/README.md +215 -0
  335. package/src/services/reqresp/batch-tx-requester/README.md +46 -7
  336. package/src/services/reqresp/batch-tx-requester/batch_tx_requester.ts +83 -77
  337. package/src/services/reqresp/batch-tx-requester/interface.ts +13 -5
  338. package/src/services/reqresp/batch-tx-requester/missing_txs.ts +13 -6
  339. package/src/services/reqresp/batch-tx-requester/peer_collection.ts +5 -0
  340. package/src/services/reqresp/batch-tx-requester/tx_validator.ts +12 -25
  341. package/src/services/reqresp/config.ts +2 -2
  342. package/src/services/reqresp/interface.ts +21 -47
  343. package/src/services/reqresp/metrics.ts +0 -1
  344. package/src/services/reqresp/protocols/block_txs/block_txs_handler.ts +4 -2
  345. package/src/services/reqresp/protocols/index.ts +0 -1
  346. package/src/services/reqresp/protocols/tx.ts +1 -3
  347. package/src/services/reqresp/rate-limiter/rate_limiter.ts +13 -9
  348. package/src/services/reqresp/rate-limiter/rate_limits.ts +0 -10
  349. package/src/services/reqresp/reqresp.ts +48 -261
  350. package/src/services/service.ts +12 -28
  351. package/src/services/tx_collection/config.ts +3 -80
  352. package/src/services/tx_collection/file_store_tx_collection.ts +54 -103
  353. package/src/services/tx_collection/file_store_tx_source.ts +43 -31
  354. package/src/services/tx_collection/index.ts +1 -6
  355. package/src/services/tx_collection/instrumentation.ts +1 -7
  356. package/src/services/tx_collection/request_tracker.ts +127 -0
  357. package/src/services/tx_collection/tx_collection.ts +331 -176
  358. package/src/services/tx_collection/tx_collection_sink.ts +2 -2
  359. package/src/services/tx_collection/tx_source.ts +8 -7
  360. package/src/services/tx_file_store/tx_file_store.ts +5 -17
  361. package/src/services/tx_provider.ts +5 -0
  362. package/src/test-helpers/make-test-p2p-clients.ts +4 -3
  363. package/src/test-helpers/mock-pubsub.ts +49 -66
  364. package/src/test-helpers/reqresp-nodes.ts +15 -28
  365. package/src/test-helpers/test_tx_provider.ts +5 -0
  366. package/src/test-helpers/testbench-utils.ts +53 -28
  367. package/src/testbench/p2p_client_testbench_worker.ts +91 -61
  368. package/src/testbench/worker_client_manager.ts +72 -25
  369. package/src/util.ts +33 -18
  370. package/src/versioning.ts +3 -33
  371. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker.d.ts +0 -2
  372. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker.d.ts.map +0 -1
  373. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker.js +0 -305
  374. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.d.ts +0 -73
  375. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.d.ts.map +0 -1
  376. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.js +0 -8
  377. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.d.ts +0 -125
  378. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.d.ts.map +0 -1
  379. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.js +0 -596
  380. package/dest/mem_pools/tx_pool/eviction/eviction_manager.d.ts +0 -32
  381. package/dest/mem_pools/tx_pool/eviction/eviction_manager.d.ts.map +0 -1
  382. package/dest/mem_pools/tx_pool/eviction/eviction_manager.js +0 -112
  383. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.d.ts +0 -157
  384. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.d.ts.map +0 -1
  385. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.js +0 -52
  386. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.d.ts +0 -16
  387. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.d.ts.map +0 -1
  388. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.js +0 -122
  389. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.d.ts +0 -17
  390. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.d.ts.map +0 -1
  391. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.js +0 -84
  392. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.d.ts +0 -19
  393. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.d.ts.map +0 -1
  394. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.js +0 -78
  395. package/dest/mem_pools/tx_pool/eviction/low_priority_eviction_rule.d.ts +0 -26
  396. package/dest/mem_pools/tx_pool/eviction/low_priority_eviction_rule.d.ts.map +0 -1
  397. package/dest/mem_pools/tx_pool/eviction/low_priority_eviction_rule.js +0 -84
  398. package/dest/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.d.ts +0 -25
  399. package/dest/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.d.ts.map +0 -1
  400. package/dest/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.js +0 -57
  401. package/dest/mem_pools/tx_pool/index.d.ts +0 -3
  402. package/dest/mem_pools/tx_pool/index.d.ts.map +0 -1
  403. package/dest/mem_pools/tx_pool/index.js +0 -2
  404. package/dest/mem_pools/tx_pool/priority.d.ts +0 -12
  405. package/dest/mem_pools/tx_pool/priority.d.ts.map +0 -1
  406. package/dest/mem_pools/tx_pool/priority.js +0 -15
  407. package/dest/mem_pools/tx_pool/tx_pool.d.ts +0 -127
  408. package/dest/mem_pools/tx_pool/tx_pool.d.ts.map +0 -1
  409. package/dest/mem_pools/tx_pool/tx_pool.js +0 -3
  410. package/dest/mem_pools/tx_pool/tx_pool_test_suite.d.ts +0 -7
  411. package/dest/mem_pools/tx_pool/tx_pool_test_suite.d.ts.map +0 -1
  412. package/dest/mem_pools/tx_pool/tx_pool_test_suite.js +0 -400
  413. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.d.ts +0 -23
  414. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.d.ts.map +0 -1
  415. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.js +0 -212
  416. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.d.ts +0 -64
  417. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.d.ts.map +0 -1
  418. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.js +0 -151
  419. package/dest/services/reqresp/protocols/block.d.ts +0 -9
  420. package/dest/services/reqresp/protocols/block.d.ts.map +0 -1
  421. package/dest/services/reqresp/protocols/block.js +0 -32
  422. package/dest/services/tx_collection/fast_tx_collection.d.ts +0 -54
  423. package/dest/services/tx_collection/fast_tx_collection.d.ts.map +0 -1
  424. package/dest/services/tx_collection/fast_tx_collection.js +0 -327
  425. package/dest/services/tx_collection/missing_txs_tracker.d.ts +0 -32
  426. package/dest/services/tx_collection/missing_txs_tracker.d.ts.map +0 -1
  427. package/dest/services/tx_collection/missing_txs_tracker.js +0 -27
  428. package/dest/services/tx_collection/proposal_tx_collector.d.ts +0 -49
  429. package/dest/services/tx_collection/proposal_tx_collector.d.ts.map +0 -1
  430. package/dest/services/tx_collection/proposal_tx_collector.js +0 -50
  431. package/dest/services/tx_collection/slow_tx_collection.d.ts +0 -57
  432. package/dest/services/tx_collection/slow_tx_collection.d.ts.map +0 -1
  433. package/dest/services/tx_collection/slow_tx_collection.js +0 -211
  434. package/src/client/test/tx_proposal_collector/proposal_tx_collector_worker.ts +0 -346
  435. package/src/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.ts +0 -43
  436. package/src/mem_pools/tx_pool/README.md +0 -270
  437. package/src/mem_pools/tx_pool/aztec_kv_tx_pool.ts +0 -746
  438. package/src/mem_pools/tx_pool/eviction/eviction_manager.ts +0 -132
  439. package/src/mem_pools/tx_pool/eviction/eviction_strategy.ts +0 -208
  440. package/src/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.ts +0 -162
  441. package/src/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.ts +0 -104
  442. package/src/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.ts +0 -93
  443. package/src/mem_pools/tx_pool/eviction/low_priority_eviction_rule.ts +0 -106
  444. package/src/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.ts +0 -75
  445. package/src/mem_pools/tx_pool/index.ts +0 -2
  446. package/src/mem_pools/tx_pool/priority.ts +0 -20
  447. package/src/mem_pools/tx_pool/tx_pool.ts +0 -141
  448. package/src/mem_pools/tx_pool/tx_pool_test_suite.ts +0 -319
  449. package/src/msg_validators/proposal_validator/proposal_validator_test_suite.ts +0 -230
  450. package/src/services/reqresp/connection-sampler/batch_connection_sampler.ts +0 -161
  451. package/src/services/reqresp/protocols/block.ts +0 -37
  452. package/src/services/tx_collection/fast_tx_collection.ts +0 -387
  453. package/src/services/tx_collection/missing_txs_tracker.ts +0 -52
  454. package/src/services/tx_collection/proposal_tx_collector.ts +0 -113
  455. 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 { type PromiseWithResolvers, 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,59 +13,60 @@ 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 { IMissingTxsTracker } from './missing_txs_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 }
33
30
  | { type: 'proposal'; blockProposal: BlockProposal; blockNumber: BlockNumber };
34
31
 
35
32
  export type FastCollectionRequest = FastCollectionRequestInput & {
36
- missingTxTracker: IMissingTxsTracker;
37
- deadline: Date;
33
+ requestTracker: IRequestTracker;
38
34
  blockInfo: L2BlockInfo;
39
- promise: PromiseWithResolvers<void>;
40
35
  };
41
36
 
42
37
  /**
43
- * 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.
44
52
  *
45
- * The slow collection loops are used for periodically collecting missing txs from mined blocks,
46
- * from remote RPC nodes and via reqresp. The fast collection methods are used to quickly gather
47
- * txs, usually for attesting to block proposals or preparing to prove an epoch. The slow and fast
48
- * collection instances both send their txs to the collection sink, which handles metrics and adds
49
- * them to the tx pool. Whenever a tx is added to either the sink or the pool, this service is notified
50
- * via events and notifies the slow and fast collection loops to stop collecting that tx, so that we don't
51
- * 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.
52
58
  */
53
59
  export class TxCollection {
54
- /** Slow collection background loops */
55
- protected readonly slowCollection: SlowTxCollection;
56
-
57
- /** Fast collection methods */
58
- protected readonly fastCollection: FastTxCollection;
60
+ // eslint-disable-next-line aztec-custom/no-non-primitive-in-collections
61
+ protected requests: Set<FastCollectionRequest> = new Set();
59
62
 
60
- /** File store collection for slow (mined block) path */
61
- protected readonly fileStoreSlowCollection: FileStoreTxCollection;
63
+ /** The collector for txs via reqresp */
64
+ protected reqRespTxsCollector?: IReqRespTxsCollector;
62
65
 
63
- /** File store collection for fast (proposal/proving) path */
66
+ /** File store collection for the fast (proposal/proving) path */
64
67
  protected readonly fileStoreFastCollection: FileStoreTxCollection;
65
68
 
66
- /** Loop for periodically reconciling found transactions from the tx pool in case we missed some */
67
- private readonly reconcileFoundTxsLoop: RunningPromise;
68
-
69
- /** Handles txs found by the slow and fast collection loops */
69
+ /** Handles txs found by collection paths before adding to the pool */
70
70
  private readonly txCollectionSink: TxCollectionSink;
71
71
 
72
72
  /** Handler for the txs-added event from the tx pool */
@@ -75,12 +75,6 @@ export class TxCollection {
75
75
  /** Handler for the txs-added event from the tx collection sink */
76
76
  protected readonly handleTxsFound: TxPoolV2Events['txs-added'];
77
77
 
78
- /** Whether the service has been started. */
79
- private started = false;
80
-
81
- /** Whether file store sources are configured. */
82
- private readonly hasFileStoreSources: boolean;
83
-
84
78
  constructor(
85
79
  private readonly p2pService: BatchTxRequesterLibP2PService,
86
80
  private readonly nodes: TxSource[],
@@ -94,38 +88,18 @@ export class TxCollection {
94
88
  ) {
95
89
  this.txCollectionSink = new TxCollectionSink(this.txPool, telemetryClient, this.log);
96
90
 
97
- this.fastCollection = new FastTxCollection(
98
- this.p2pService,
99
- this.nodes,
100
- this.txCollectionSink,
101
- this.config,
102
- this.dateProvider,
103
- this.log,
104
- );
105
-
106
- this.slowCollection = new SlowTxCollection(
107
- this.p2pService.reqResp,
108
- this.nodes,
109
- this.txCollectionSink,
110
- this.fastCollection,
111
- constants,
112
- this.config,
113
- this.dateProvider,
114
- this.log,
115
- );
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
+ );
116
102
 
117
- this.hasFileStoreSources = fileStoreSources.length > 0;
118
- this.fileStoreSlowCollection = new FileStoreTxCollection(
119
- fileStoreSources,
120
- this.txCollectionSink,
121
- {
122
- workerCount: config.txCollectionFileStoreSlowWorkerCount,
123
- backoffBaseMs: config.txCollectionFileStoreSlowBackoffBaseMs,
124
- backoffMaxMs: config.txCollectionFileStoreSlowBackoffMaxMs,
125
- },
126
- this.dateProvider,
127
- this.log,
128
- );
129
103
  this.fileStoreFastCollection = new FileStoreTxCollection(
130
104
  fileStoreSources,
131
105
  this.txCollectionSink,
@@ -138,12 +112,6 @@ export class TxCollection {
138
112
  this.log,
139
113
  );
140
114
 
141
- this.reconcileFoundTxsLoop = new RunningPromise(
142
- () => this.reconcileFoundTxsWithPool(),
143
- this.log,
144
- this.config.txCollectionReconcileIntervalMs,
145
- );
146
-
147
115
  this.handleTxsFound = (args: Parameters<TxPoolV2Events['txs-added']>[0]) => {
148
116
  this.foundTxs(args.txs);
149
117
  };
@@ -158,76 +126,21 @@ export class TxCollection {
158
126
  this.txPool.on('txs-added', this.handleTxsAddedToPool);
159
127
  }
160
128
 
161
- /** Starts all collection loops. */
162
- public start(): Promise<void> {
163
- this.started = true;
164
- this.slowCollection.start();
165
- this.fileStoreSlowCollection.start();
166
- this.fileStoreFastCollection.start();
167
- this.reconcileFoundTxsLoop.start();
168
-
169
- // TODO(palla/txs): Collect mined unproven tx hashes for txs we dont have in the pool and populate missingTxs on startup
170
- return Promise.resolve();
171
- }
172
-
173
- /** Stops all activity. */
174
- public async stop() {
175
- this.started = false;
176
- await Promise.all([
177
- this.slowCollection.stop(),
178
- this.fastCollection.stop(),
179
- this.fileStoreSlowCollection.stop(),
180
- this.fileStoreFastCollection.stop(),
181
- this.reconcileFoundTxsLoop.stop(),
182
- ]);
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
+ });
183
134
 
184
135
  this.txPool.removeListener('txs-added', this.handleTxsAddedToPool);
185
136
  this.txCollectionSink.removeListener('txs-added', this.handleTxsFound);
186
137
  }
187
138
 
188
- /** Force trigger the slow collection and reconciliation loops */
189
- public async trigger() {
190
- await Promise.all([this.reconcileFoundTxsLoop.trigger(), this.slowCollection.trigger()]);
191
- }
192
-
193
139
  /** Returns L1 rollup constants. */
194
140
  public getConstants(): L1RollupConstants {
195
141
  return this.constants;
196
142
  }
197
143
 
198
- /** Starts collecting the given tx hashes for the given L2Block in the slow loop */
199
- public startCollecting(block: L2Block, txHashes: TxHash[]) {
200
- this.slowCollection.startCollecting(block, txHashes);
201
-
202
- // Delay file store collection to give P2P methods time to find txs first
203
- if (this.hasFileStoreSources) {
204
- const context: TxAddContext = { type: 'mined', block };
205
- const deadline = getProofDeadlineForSlot(block.header.getSlot(), this.constants);
206
- sleep(this.config.txCollectionFileStoreSlowDelayMs)
207
- .then(() => {
208
- if (this.started) {
209
- // Only queue txs that are still missing after the delay
210
- const stillMissing = new Set(this.slowCollection.getMissingTxHashes().map(h => h.toString()));
211
- const remaining = txHashes.filter(h => stillMissing.has(h.toString()));
212
- if (remaining.length > 0) {
213
- this.fileStoreSlowCollection.startCollecting(remaining, context, deadline);
214
- }
215
- }
216
- })
217
- .catch(err => this.log.error('Error in file store slow delay', err));
218
- }
219
- }
220
-
221
- /** Collects the set of txs for the given block proposal as fast as possible */
222
- public collectFastForProposal(
223
- blockProposal: BlockProposal,
224
- blockNumber: BlockNumber,
225
- txHashes: TxHash[] | string[],
226
- opts: { deadline: Date; pinnedPeer?: PeerId },
227
- ) {
228
- return this.collectFastFor({ type: 'proposal', blockProposal, blockNumber }, txHashes, opts);
229
- }
230
-
231
144
  /** Collects the set of txs for the given mined block as fast as possible */
232
145
  public collectFastForBlock(
233
146
  block: L2Block,
@@ -238,54 +151,307 @@ export class TxCollection {
238
151
  }
239
152
 
240
153
  /** Collects the set of txs for the given proposal or block as fast as possible */
241
- public collectFastFor(
154
+ public async collectFastFor(
242
155
  input: FastCollectionRequestInput,
243
156
  txHashes: TxHash[] | string[],
244
157
  opts: { deadline: Date; pinnedPeer?: PeerId },
245
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
+
246
168
  const hashes = txHashes.map(h => (typeof h === 'string' ? TxHash.fromString(h) : h));
247
169
 
248
- // Delay file store collection to give P2P methods time to find txs first
249
- if (this.hasFileStoreSources) {
250
- const context = this.getAddContextForInput(input);
251
- sleep(this.config.txCollectionFileStoreFastDelayMs)
252
- .then(() => {
253
- if (this.started) {
254
- 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++;
255
304
  }
256
- })
257
- .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;
258
377
  }
259
378
 
260
- 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
+ }
261
412
  }
262
413
 
263
- /** Returns the TxAddContext for the given fast collection request input */
264
- private getAddContextForInput(input: FastCollectionRequestInput): TxAddContext {
265
- if (input.type === 'proposal') {
266
- 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 };
267
418
  } else {
268
- return { type: 'mined', block: input.block };
419
+ return { type: 'mined', block: request.block };
269
420
  }
270
421
  }
271
422
 
272
- /** Mark the given txs as found. Stops collecting them. */
423
+ /** Mark the given txs as found. Stops collecting them across all in-flight requests. */
273
424
  private foundTxs(txs: Tx[]) {
274
- this.slowCollection.foundTxs(txs);
275
- this.fastCollection.foundTxs(txs);
276
- this.fileStoreSlowCollection.foundTxs(txs);
277
- 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
+ }
278
443
  }
279
444
 
280
445
  /**
281
- * 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.
282
447
  * To be called when we no longer care about gathering txs up to a certain block, eg when they become proven or finalized.
283
448
  */
284
449
  public stopCollectingForBlocksUpTo(blockNumber: BlockNumber): void {
285
- this.slowCollection.stopCollectingForBlocksUpTo(blockNumber);
286
- this.fastCollection.stopCollectingForBlocksUpTo(blockNumber);
287
- this.fileStoreSlowCollection.clearPending();
288
- this.fileStoreFastCollection.clearPending();
450
+ for (const request of this.requests) {
451
+ if (request.blockInfo.blockNumber <= blockNumber) {
452
+ request.requestTracker.cancel();
453
+ }
454
+ }
289
455
  }
290
456
 
291
457
  /**
@@ -293,21 +459,10 @@ export class TxCollection {
293
459
  * To be called when there is a chain prune and previously mined txs are no longer relevant.
294
460
  */
295
461
  public stopCollectingForBlocksAfter(blockNumber: BlockNumber): void {
296
- this.slowCollection.stopCollectingForBlocksAfter(blockNumber);
297
- this.fastCollection.stopCollectingForBlocksAfter(blockNumber);
298
- this.fileStoreSlowCollection.clearPending();
299
- this.fileStoreFastCollection.clearPending();
300
- }
301
-
302
- /** Every now and then, check if the pool has received one of the txs we are looking for, just to catch any race conditions */
303
- private async reconcileFoundTxsWithPool() {
304
- const missingTxHashes = this.slowCollection.getMissingTxHashes();
305
- const foundTxs = compactArray(await this.txPool.getTxsByHash(missingTxHashes));
306
- if (foundTxs.length > 0) {
307
- this.log.verbose(`Found ${foundTxs.length} txs in the pool during reconciliation`, {
308
- foundTxs: foundTxs.map(t => t.getTxHash().toString()),
309
- });
310
- this.foundTxs(foundTxs);
462
+ for (const request of this.requests) {
463
+ if (request.blockInfo.blockNumber > blockNumber) {
464
+ request.requestTracker.cancel();
465
+ }
311
466
  }
312
467
  }
313
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