@aztec/p2p 0.0.1-commit.c7c42ec → 0.0.1-commit.cf93bcc56

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 (513) hide show
  1. package/dest/bootstrap/bootstrap.d.ts +4 -3
  2. package/dest/bootstrap/bootstrap.d.ts.map +1 -1
  3. package/dest/bootstrap/bootstrap.js +4 -4
  4. package/dest/client/factory.d.ts +7 -6
  5. package/dest/client/factory.d.ts.map +1 -1
  6. package/dest/client/factory.js +52 -14
  7. package/dest/client/interface.d.ts +56 -25
  8. package/dest/client/interface.d.ts.map +1 -1
  9. package/dest/client/p2p_client.d.ts +44 -51
  10. package/dest/client/p2p_client.d.ts.map +1 -1
  11. package/dest/client/p2p_client.js +579 -259
  12. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker.d.ts +2 -0
  13. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker.d.ts.map +1 -0
  14. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker.js +305 -0
  15. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.d.ts +73 -0
  16. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.d.ts.map +1 -0
  17. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.js +8 -0
  18. package/dest/config.d.ts +33 -3
  19. package/dest/config.d.ts.map +1 -1
  20. package/dest/config.js +23 -4
  21. package/dest/errors/tx-pool.error.d.ts +8 -0
  22. package/dest/errors/tx-pool.error.d.ts.map +1 -0
  23. package/dest/errors/tx-pool.error.js +9 -0
  24. package/dest/index.d.ts +2 -1
  25. package/dest/index.d.ts.map +1 -1
  26. package/dest/index.js +1 -0
  27. package/dest/mem_pools/attestation_pool/attestation_pool.d.ts +111 -76
  28. package/dest/mem_pools/attestation_pool/attestation_pool.d.ts.map +1 -1
  29. package/dest/mem_pools/attestation_pool/attestation_pool.js +441 -3
  30. package/dest/mem_pools/attestation_pool/attestation_pool_test_suite.d.ts +2 -2
  31. package/dest/mem_pools/attestation_pool/attestation_pool_test_suite.d.ts.map +1 -1
  32. package/dest/mem_pools/attestation_pool/attestation_pool_test_suite.js +527 -287
  33. package/dest/mem_pools/attestation_pool/index.d.ts +2 -3
  34. package/dest/mem_pools/attestation_pool/index.d.ts.map +1 -1
  35. package/dest/mem_pools/attestation_pool/index.js +1 -2
  36. package/dest/mem_pools/attestation_pool/mocks.d.ts +9 -6
  37. package/dest/mem_pools/attestation_pool/mocks.d.ts.map +1 -1
  38. package/dest/mem_pools/attestation_pool/mocks.js +16 -12
  39. package/dest/mem_pools/index.d.ts +3 -2
  40. package/dest/mem_pools/index.d.ts.map +1 -1
  41. package/dest/mem_pools/index.js +1 -1
  42. package/dest/mem_pools/instrumentation.d.ts +1 -1
  43. package/dest/mem_pools/instrumentation.d.ts.map +1 -1
  44. package/dest/mem_pools/instrumentation.js +5 -14
  45. package/dest/mem_pools/interface.d.ts +5 -5
  46. package/dest/mem_pools/interface.d.ts.map +1 -1
  47. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.d.ts +15 -10
  48. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.d.ts.map +1 -1
  49. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.js +91 -50
  50. package/dest/mem_pools/tx_pool/eviction/eviction_manager.d.ts +19 -5
  51. package/dest/mem_pools/tx_pool/eviction/eviction_manager.d.ts.map +1 -1
  52. package/dest/mem_pools/tx_pool/eviction/eviction_manager.js +59 -3
  53. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.d.ts +79 -5
  54. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.d.ts.map +1 -1
  55. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.js +47 -0
  56. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.d.ts +16 -0
  57. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.d.ts.map +1 -0
  58. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.js +122 -0
  59. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.d.ts +2 -2
  60. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.d.ts.map +1 -1
  61. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.js +3 -3
  62. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.d.ts +4 -4
  63. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.d.ts.map +1 -1
  64. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.js +2 -0
  65. package/dest/mem_pools/tx_pool/eviction/low_priority_eviction_rule.d.ts +2 -2
  66. package/dest/mem_pools/tx_pool/eviction/low_priority_eviction_rule.d.ts.map +1 -1
  67. package/dest/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.d.ts +25 -0
  68. package/dest/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.d.ts.map +1 -0
  69. package/dest/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.js +57 -0
  70. package/dest/mem_pools/tx_pool_v2/archive/index.d.ts +2 -0
  71. package/dest/mem_pools/tx_pool_v2/archive/index.d.ts.map +1 -0
  72. package/dest/mem_pools/tx_pool_v2/archive/index.js +1 -0
  73. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.d.ts +43 -0
  74. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.d.ts.map +1 -0
  75. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.js +103 -0
  76. package/dest/mem_pools/tx_pool_v2/deleted_pool.d.ts +104 -0
  77. package/dest/mem_pools/tx_pool_v2/deleted_pool.d.ts.map +1 -0
  78. package/dest/mem_pools/tx_pool_v2/deleted_pool.js +251 -0
  79. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.d.ts +47 -0
  80. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.d.ts.map +1 -0
  81. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.js +128 -0
  82. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.d.ts +17 -0
  83. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.d.ts.map +1 -0
  84. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.js +93 -0
  85. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.d.ts +19 -0
  86. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.d.ts.map +1 -0
  87. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.js +95 -0
  88. package/dest/mem_pools/tx_pool_v2/eviction/index.d.ts +10 -0
  89. package/dest/mem_pools/tx_pool_v2/eviction/index.d.ts.map +1 -0
  90. package/dest/mem_pools/tx_pool_v2/eviction/index.js +11 -0
  91. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.d.ts +174 -0
  92. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.d.ts.map +1 -0
  93. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.js +25 -0
  94. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.d.ts +15 -0
  95. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.d.ts.map +1 -0
  96. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.js +65 -0
  97. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.d.ts +17 -0
  98. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.d.ts.map +1 -0
  99. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.js +93 -0
  100. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.d.ts +16 -0
  101. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.d.ts.map +1 -0
  102. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.js +74 -0
  103. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.d.ts +20 -0
  104. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.d.ts.map +1 -0
  105. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.js +73 -0
  106. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.d.ts +15 -0
  107. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.d.ts.map +1 -0
  108. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.js +19 -0
  109. package/dest/mem_pools/tx_pool_v2/index.d.ts +6 -0
  110. package/dest/mem_pools/tx_pool_v2/index.d.ts.map +1 -0
  111. package/dest/mem_pools/tx_pool_v2/index.js +5 -0
  112. package/dest/mem_pools/tx_pool_v2/instrumentation.d.ts +15 -0
  113. package/dest/mem_pools/tx_pool_v2/instrumentation.d.ts.map +1 -0
  114. package/dest/mem_pools/tx_pool_v2/instrumentation.js +43 -0
  115. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts +207 -0
  116. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts.map +1 -0
  117. package/dest/mem_pools/tx_pool_v2/interfaces.js +8 -0
  118. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts +97 -0
  119. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts.map +1 -0
  120. package/dest/mem_pools/tx_pool_v2/tx_metadata.js +152 -0
  121. package/dest/mem_pools/tx_pool_v2/tx_pool_bench_metrics.d.ts +26 -0
  122. package/dest/mem_pools/tx_pool_v2/tx_pool_bench_metrics.d.ts.map +1 -0
  123. package/dest/mem_pools/tx_pool_v2/tx_pool_bench_metrics.js +70 -0
  124. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.d.ts +108 -0
  125. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.d.ts.map +1 -0
  126. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.js +355 -0
  127. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts +58 -0
  128. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts.map +1 -0
  129. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.js +161 -0
  130. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts +75 -0
  131. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts.map +1 -0
  132. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.js +871 -0
  133. package/dest/msg_validators/attestation_validator/attestation_validator.d.ts +4 -4
  134. package/dest/msg_validators/attestation_validator/attestation_validator.d.ts.map +1 -1
  135. package/dest/msg_validators/attestation_validator/attestation_validator.js +51 -18
  136. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts +7 -7
  137. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts.map +1 -1
  138. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.js +22 -13
  139. package/dest/msg_validators/clock_tolerance.d.ts +21 -0
  140. package/dest/msg_validators/clock_tolerance.d.ts.map +1 -0
  141. package/dest/msg_validators/clock_tolerance.js +37 -0
  142. package/dest/msg_validators/index.d.ts +2 -2
  143. package/dest/msg_validators/index.d.ts.map +1 -1
  144. package/dest/msg_validators/index.js +1 -1
  145. package/dest/msg_validators/proposal_validator/block_proposal_validator.d.ts +9 -0
  146. package/dest/msg_validators/proposal_validator/block_proposal_validator.d.ts.map +1 -0
  147. package/dest/msg_validators/proposal_validator/block_proposal_validator.js +6 -0
  148. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.d.ts +9 -0
  149. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.d.ts.map +1 -0
  150. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.js +6 -0
  151. package/dest/msg_validators/proposal_validator/index.d.ts +4 -0
  152. package/dest/msg_validators/proposal_validator/index.d.ts.map +1 -0
  153. package/dest/msg_validators/proposal_validator/index.js +3 -0
  154. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts +13 -0
  155. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts.map +1 -0
  156. package/dest/msg_validators/proposal_validator/proposal_validator.js +104 -0
  157. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.d.ts +23 -0
  158. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.d.ts.map +1 -0
  159. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.js +212 -0
  160. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts +3 -3
  161. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts.map +1 -1
  162. package/dest/msg_validators/tx_validator/archive_cache.d.ts +3 -3
  163. package/dest/msg_validators/tx_validator/archive_cache.d.ts.map +1 -1
  164. package/dest/msg_validators/tx_validator/archive_cache.js +1 -1
  165. package/dest/msg_validators/tx_validator/block_header_validator.d.ts +20 -6
  166. package/dest/msg_validators/tx_validator/block_header_validator.d.ts.map +1 -1
  167. package/dest/msg_validators/tx_validator/block_header_validator.js +4 -3
  168. package/dest/msg_validators/tx_validator/data_validator.d.ts +3 -1
  169. package/dest/msg_validators/tx_validator/data_validator.d.ts.map +1 -1
  170. package/dest/msg_validators/tx_validator/data_validator.js +4 -1
  171. package/dest/msg_validators/tx_validator/double_spend_validator.d.ts +15 -4
  172. package/dest/msg_validators/tx_validator/double_spend_validator.d.ts.map +1 -1
  173. package/dest/msg_validators/tx_validator/double_spend_validator.js +7 -6
  174. package/dest/msg_validators/tx_validator/factory.d.ts +8 -3
  175. package/dest/msg_validators/tx_validator/factory.d.ts.map +1 -1
  176. package/dest/msg_validators/tx_validator/factory.js +21 -11
  177. package/dest/msg_validators/tx_validator/fee_payer_balance.d.ts +10 -0
  178. package/dest/msg_validators/tx_validator/fee_payer_balance.d.ts.map +1 -0
  179. package/dest/msg_validators/tx_validator/fee_payer_balance.js +20 -0
  180. package/dest/msg_validators/tx_validator/gas_validator.d.ts +3 -2
  181. package/dest/msg_validators/tx_validator/gas_validator.d.ts.map +1 -1
  182. package/dest/msg_validators/tx_validator/gas_validator.js +11 -16
  183. package/dest/msg_validators/tx_validator/index.d.ts +2 -1
  184. package/dest/msg_validators/tx_validator/index.d.ts.map +1 -1
  185. package/dest/msg_validators/tx_validator/index.js +1 -0
  186. package/dest/msg_validators/tx_validator/metadata_validator.d.ts +3 -2
  187. package/dest/msg_validators/tx_validator/metadata_validator.d.ts.map +1 -1
  188. package/dest/msg_validators/tx_validator/metadata_validator.js +2 -2
  189. package/dest/msg_validators/tx_validator/phases_validator.d.ts +3 -2
  190. package/dest/msg_validators/tx_validator/phases_validator.d.ts.map +1 -1
  191. package/dest/msg_validators/tx_validator/phases_validator.js +3 -3
  192. package/dest/msg_validators/tx_validator/size_validator.d.ts +8 -0
  193. package/dest/msg_validators/tx_validator/size_validator.d.ts.map +1 -0
  194. package/dest/msg_validators/tx_validator/size_validator.js +23 -0
  195. package/dest/msg_validators/tx_validator/timestamp_validator.d.ts +22 -5
  196. package/dest/msg_validators/tx_validator/timestamp_validator.d.ts.map +1 -1
  197. package/dest/msg_validators/tx_validator/timestamp_validator.js +8 -8
  198. package/dest/msg_validators/tx_validator/tx_permitted_validator.d.ts +3 -2
  199. package/dest/msg_validators/tx_validator/tx_permitted_validator.d.ts.map +1 -1
  200. package/dest/msg_validators/tx_validator/tx_permitted_validator.js +2 -2
  201. package/dest/msg_validators/tx_validator/tx_proof_validator.d.ts +3 -2
  202. package/dest/msg_validators/tx_validator/tx_proof_validator.d.ts.map +1 -1
  203. package/dest/msg_validators/tx_validator/tx_proof_validator.js +2 -2
  204. package/dest/services/data_store.d.ts +1 -1
  205. package/dest/services/data_store.d.ts.map +1 -1
  206. package/dest/services/data_store.js +10 -6
  207. package/dest/services/discv5/discV5_service.js +1 -1
  208. package/dest/services/dummy_service.d.ts +26 -2
  209. package/dest/services/dummy_service.d.ts.map +1 -1
  210. package/dest/services/dummy_service.js +48 -0
  211. package/dest/services/encoding.d.ts +2 -2
  212. package/dest/services/encoding.d.ts.map +1 -1
  213. package/dest/services/encoding.js +9 -7
  214. package/dest/services/gossipsub/index.d.ts +3 -0
  215. package/dest/services/gossipsub/index.d.ts.map +1 -0
  216. package/dest/services/gossipsub/index.js +2 -0
  217. package/dest/services/gossipsub/scoring.d.ts +21 -3
  218. package/dest/services/gossipsub/scoring.d.ts.map +1 -1
  219. package/dest/services/gossipsub/scoring.js +24 -7
  220. package/dest/services/gossipsub/topic_score_params.d.ts +161 -0
  221. package/dest/services/gossipsub/topic_score_params.d.ts.map +1 -0
  222. package/dest/services/gossipsub/topic_score_params.js +324 -0
  223. package/dest/services/index.d.ts +2 -1
  224. package/dest/services/index.d.ts.map +1 -1
  225. package/dest/services/index.js +1 -0
  226. package/dest/services/libp2p/instrumentation.d.ts +1 -1
  227. package/dest/services/libp2p/instrumentation.d.ts.map +1 -1
  228. package/dest/services/libp2p/instrumentation.js +30 -72
  229. package/dest/services/libp2p/libp2p_service.d.ts +105 -33
  230. package/dest/services/libp2p/libp2p_service.d.ts.map +1 -1
  231. package/dest/services/libp2p/libp2p_service.js +980 -317
  232. package/dest/services/peer-manager/metrics.d.ts +2 -2
  233. package/dest/services/peer-manager/metrics.d.ts.map +1 -1
  234. package/dest/services/peer-manager/metrics.js +21 -26
  235. package/dest/services/peer-manager/peer_manager.d.ts +2 -2
  236. package/dest/services/peer-manager/peer_manager.d.ts.map +1 -1
  237. package/dest/services/peer-manager/peer_manager.js +0 -10
  238. package/dest/services/peer-manager/peer_scoring.d.ts +1 -1
  239. package/dest/services/peer-manager/peer_scoring.d.ts.map +1 -1
  240. package/dest/services/peer-manager/peer_scoring.js +32 -6
  241. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts +47 -0
  242. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts.map +1 -0
  243. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.js +566 -0
  244. package/dest/services/reqresp/batch-tx-requester/config.d.ts +17 -0
  245. package/dest/services/reqresp/batch-tx-requester/config.d.ts.map +1 -0
  246. package/dest/services/reqresp/batch-tx-requester/config.js +27 -0
  247. package/dest/services/reqresp/batch-tx-requester/interface.d.ts +50 -0
  248. package/dest/services/reqresp/batch-tx-requester/interface.d.ts.map +1 -0
  249. package/dest/services/reqresp/batch-tx-requester/interface.js +1 -0
  250. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts +37 -0
  251. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts.map +1 -0
  252. package/dest/services/reqresp/batch-tx-requester/missing_txs.js +151 -0
  253. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts +54 -0
  254. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts.map +1 -0
  255. package/dest/services/reqresp/batch-tx-requester/peer_collection.js +139 -0
  256. package/dest/services/reqresp/batch-tx-requester/tx_validator.d.ts +20 -0
  257. package/dest/services/reqresp/batch-tx-requester/tx_validator.d.ts.map +1 -0
  258. package/dest/services/reqresp/batch-tx-requester/tx_validator.js +21 -0
  259. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.d.ts +22 -3
  260. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.d.ts.map +1 -1
  261. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.js +63 -4
  262. package/dest/services/reqresp/connection-sampler/connection_sampler.d.ts +2 -1
  263. package/dest/services/reqresp/connection-sampler/connection_sampler.d.ts.map +1 -1
  264. package/dest/services/reqresp/connection-sampler/connection_sampler.js +12 -0
  265. package/dest/services/reqresp/constants.d.ts +12 -0
  266. package/dest/services/reqresp/constants.d.ts.map +1 -0
  267. package/dest/services/reqresp/constants.js +7 -0
  268. package/dest/services/reqresp/interface.d.ts +12 -1
  269. package/dest/services/reqresp/interface.d.ts.map +1 -1
  270. package/dest/services/reqresp/interface.js +15 -1
  271. package/dest/services/reqresp/metrics.d.ts +6 -5
  272. package/dest/services/reqresp/metrics.d.ts.map +1 -1
  273. package/dest/services/reqresp/metrics.js +17 -21
  274. package/dest/services/reqresp/protocols/block_txs/bitvector.d.ts +5 -1
  275. package/dest/services/reqresp/protocols/block_txs/bitvector.d.ts.map +1 -1
  276. package/dest/services/reqresp/protocols/block_txs/bitvector.js +12 -0
  277. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts +7 -5
  278. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts.map +1 -1
  279. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.js +27 -9
  280. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts +29 -6
  281. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts.map +1 -1
  282. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.js +59 -13
  283. package/dest/services/reqresp/protocols/status.d.ts +1 -1
  284. package/dest/services/reqresp/protocols/status.d.ts.map +1 -1
  285. package/dest/services/reqresp/protocols/status.js +4 -1
  286. package/dest/services/reqresp/protocols/tx.d.ts +7 -1
  287. package/dest/services/reqresp/protocols/tx.d.ts.map +1 -1
  288. package/dest/services/reqresp/protocols/tx.js +20 -0
  289. package/dest/services/reqresp/reqresp.d.ts +6 -1
  290. package/dest/services/reqresp/reqresp.d.ts.map +1 -1
  291. package/dest/services/reqresp/reqresp.js +471 -50
  292. package/dest/services/service.d.ts +53 -3
  293. package/dest/services/service.d.ts.map +1 -1
  294. package/dest/services/tx_collection/config.d.ts +22 -1
  295. package/dest/services/tx_collection/config.d.ts.map +1 -1
  296. package/dest/services/tx_collection/config.js +55 -1
  297. package/dest/services/tx_collection/fast_tx_collection.d.ts +7 -4
  298. package/dest/services/tx_collection/fast_tx_collection.d.ts.map +1 -1
  299. package/dest/services/tx_collection/fast_tx_collection.js +34 -13
  300. package/dest/services/tx_collection/file_store_tx_collection.d.ts +53 -0
  301. package/dest/services/tx_collection/file_store_tx_collection.d.ts.map +1 -0
  302. package/dest/services/tx_collection/file_store_tx_collection.js +165 -0
  303. package/dest/services/tx_collection/file_store_tx_source.d.ts +37 -0
  304. package/dest/services/tx_collection/file_store_tx_source.d.ts.map +1 -0
  305. package/dest/services/tx_collection/file_store_tx_source.js +79 -0
  306. package/dest/services/tx_collection/index.d.ts +3 -1
  307. package/dest/services/tx_collection/index.d.ts.map +1 -1
  308. package/dest/services/tx_collection/index.js +2 -0
  309. package/dest/services/tx_collection/instrumentation.d.ts +1 -1
  310. package/dest/services/tx_collection/instrumentation.d.ts.map +1 -1
  311. package/dest/services/tx_collection/instrumentation.js +11 -13
  312. package/dest/services/tx_collection/proposal_tx_collector.d.ts +48 -0
  313. package/dest/services/tx_collection/proposal_tx_collector.d.ts.map +1 -0
  314. package/dest/services/tx_collection/proposal_tx_collector.js +49 -0
  315. package/dest/services/tx_collection/slow_tx_collection.d.ts +8 -4
  316. package/dest/services/tx_collection/slow_tx_collection.d.ts.map +1 -1
  317. package/dest/services/tx_collection/slow_tx_collection.js +55 -23
  318. package/dest/services/tx_collection/tx_collection.d.ts +25 -13
  319. package/dest/services/tx_collection/tx_collection.d.ts.map +1 -1
  320. package/dest/services/tx_collection/tx_collection.js +79 -7
  321. package/dest/services/tx_collection/tx_collection_sink.d.ts +15 -6
  322. package/dest/services/tx_collection/tx_collection_sink.d.ts.map +1 -1
  323. package/dest/services/tx_collection/tx_collection_sink.js +13 -7
  324. package/dest/services/tx_file_store/config.d.ts +16 -0
  325. package/dest/services/tx_file_store/config.d.ts.map +1 -0
  326. package/dest/services/tx_file_store/config.js +22 -0
  327. package/dest/services/tx_file_store/index.d.ts +4 -0
  328. package/dest/services/tx_file_store/index.d.ts.map +1 -0
  329. package/dest/services/tx_file_store/index.js +3 -0
  330. package/dest/services/tx_file_store/instrumentation.d.ts +15 -0
  331. package/dest/services/tx_file_store/instrumentation.d.ts.map +1 -0
  332. package/dest/services/tx_file_store/instrumentation.js +29 -0
  333. package/dest/services/tx_file_store/tx_file_store.d.ts +48 -0
  334. package/dest/services/tx_file_store/tx_file_store.d.ts.map +1 -0
  335. package/dest/services/tx_file_store/tx_file_store.js +152 -0
  336. package/dest/services/tx_provider.d.ts +5 -5
  337. package/dest/services/tx_provider.d.ts.map +1 -1
  338. package/dest/services/tx_provider.js +5 -4
  339. package/dest/services/tx_provider_instrumentation.d.ts +1 -1
  340. package/dest/services/tx_provider_instrumentation.d.ts.map +1 -1
  341. package/dest/services/tx_provider_instrumentation.js +7 -20
  342. package/dest/test-helpers/index.d.ts +3 -1
  343. package/dest/test-helpers/index.d.ts.map +1 -1
  344. package/dest/test-helpers/index.js +2 -0
  345. package/dest/test-helpers/make-test-p2p-clients.d.ts +3 -3
  346. package/dest/test-helpers/make-test-p2p-clients.d.ts.map +1 -1
  347. package/dest/test-helpers/mock-pubsub.d.ts +27 -1
  348. package/dest/test-helpers/mock-pubsub.d.ts.map +1 -1
  349. package/dest/test-helpers/mock-pubsub.js +97 -2
  350. package/dest/test-helpers/reqresp-nodes.d.ts +1 -1
  351. package/dest/test-helpers/reqresp-nodes.d.ts.map +1 -1
  352. package/dest/test-helpers/reqresp-nodes.js +2 -1
  353. package/dest/test-helpers/test_tx_provider.d.ts +40 -0
  354. package/dest/test-helpers/test_tx_provider.d.ts.map +1 -0
  355. package/dest/test-helpers/test_tx_provider.js +41 -0
  356. package/dest/test-helpers/testbench-utils.d.ts +161 -0
  357. package/dest/test-helpers/testbench-utils.d.ts.map +1 -0
  358. package/dest/test-helpers/testbench-utils.js +366 -0
  359. package/dest/testbench/p2p_client_testbench_worker.d.ts +28 -2
  360. package/dest/testbench/p2p_client_testbench_worker.d.ts.map +1 -1
  361. package/dest/testbench/p2p_client_testbench_worker.js +219 -125
  362. package/dest/testbench/worker_client_manager.d.ts +51 -6
  363. package/dest/testbench/worker_client_manager.d.ts.map +1 -1
  364. package/dest/testbench/worker_client_manager.js +226 -39
  365. package/package.json +16 -16
  366. package/src/bootstrap/bootstrap.ts +7 -4
  367. package/src/client/factory.ts +95 -24
  368. package/src/client/interface.ts +67 -25
  369. package/src/client/p2p_client.ts +243 -291
  370. package/src/client/test/tx_proposal_collector/README.md +227 -0
  371. package/src/client/test/tx_proposal_collector/proposal_tx_collector_worker.ts +336 -0
  372. package/src/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.ts +43 -0
  373. package/src/config.ts +48 -4
  374. package/src/errors/tx-pool.error.ts +12 -0
  375. package/src/index.ts +1 -0
  376. package/src/mem_pools/attestation_pool/attestation_pool.ts +510 -78
  377. package/src/mem_pools/attestation_pool/attestation_pool_test_suite.ts +612 -320
  378. package/src/mem_pools/attestation_pool/index.ts +9 -2
  379. package/src/mem_pools/attestation_pool/mocks.ts +20 -13
  380. package/src/mem_pools/index.ts +4 -1
  381. package/src/mem_pools/instrumentation.ts +10 -18
  382. package/src/mem_pools/interface.ts +4 -4
  383. package/src/mem_pools/tx_pool/README.md +29 -14
  384. package/src/mem_pools/tx_pool/aztec_kv_tx_pool.ts +130 -75
  385. package/src/mem_pools/tx_pool/eviction/eviction_manager.ts +66 -5
  386. package/src/mem_pools/tx_pool/eviction/eviction_strategy.ts +119 -4
  387. package/src/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.ts +162 -0
  388. package/src/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.ts +3 -3
  389. package/src/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.ts +4 -2
  390. package/src/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.ts +75 -0
  391. package/src/mem_pools/tx_pool_v2/README.md +275 -0
  392. package/src/mem_pools/tx_pool_v2/archive/index.ts +1 -0
  393. package/src/mem_pools/tx_pool_v2/archive/tx_archive.ts +120 -0
  394. package/src/mem_pools/tx_pool_v2/deleted_pool.ts +321 -0
  395. package/src/mem_pools/tx_pool_v2/eviction/eviction_manager.ts +160 -0
  396. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.ts +121 -0
  397. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.ts +122 -0
  398. package/src/mem_pools/tx_pool_v2/eviction/index.ts +27 -0
  399. package/src/mem_pools/tx_pool_v2/eviction/interfaces.ts +209 -0
  400. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.ts +74 -0
  401. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.ts +101 -0
  402. package/src/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.ts +87 -0
  403. package/src/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.ts +90 -0
  404. package/src/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.ts +31 -0
  405. package/src/mem_pools/tx_pool_v2/index.ts +12 -0
  406. package/src/mem_pools/tx_pool_v2/instrumentation.ts +69 -0
  407. package/src/mem_pools/tx_pool_v2/interfaces.ts +239 -0
  408. package/src/mem_pools/tx_pool_v2/tx_metadata.ts +242 -0
  409. package/src/mem_pools/tx_pool_v2/tx_pool_bench_metrics.ts +77 -0
  410. package/src/mem_pools/tx_pool_v2/tx_pool_indices.ts +444 -0
  411. package/src/mem_pools/tx_pool_v2/tx_pool_v2.ts +223 -0
  412. package/src/mem_pools/tx_pool_v2/tx_pool_v2_impl.ts +1042 -0
  413. package/src/msg_validators/attestation_validator/attestation_validator.ts +36 -21
  414. package/src/msg_validators/attestation_validator/fisherman_attestation_validator.ts +21 -18
  415. package/src/msg_validators/clock_tolerance.ts +51 -0
  416. package/src/msg_validators/index.ts +1 -1
  417. package/src/msg_validators/proposal_validator/block_proposal_validator.ts +10 -0
  418. package/src/msg_validators/proposal_validator/checkpoint_proposal_validator.ts +13 -0
  419. package/src/msg_validators/proposal_validator/index.ts +3 -0
  420. package/src/msg_validators/proposal_validator/proposal_validator.ts +92 -0
  421. package/src/msg_validators/proposal_validator/proposal_validator_test_suite.ts +230 -0
  422. package/src/msg_validators/tx_validator/aggregate_tx_validator.ts +2 -2
  423. package/src/msg_validators/tx_validator/archive_cache.ts +3 -3
  424. package/src/msg_validators/tx_validator/block_header_validator.ts +21 -8
  425. package/src/msg_validators/tx_validator/data_validator.ts +18 -6
  426. package/src/msg_validators/tx_validator/double_spend_validator.ts +15 -9
  427. package/src/msg_validators/tx_validator/factory.ts +64 -23
  428. package/src/msg_validators/tx_validator/fee_payer_balance.ts +40 -0
  429. package/src/msg_validators/tx_validator/gas_validator.ts +17 -28
  430. package/src/msg_validators/tx_validator/index.ts +1 -0
  431. package/src/msg_validators/tx_validator/metadata_validator.ts +18 -7
  432. package/src/msg_validators/tx_validator/phases_validator.ts +5 -3
  433. package/src/msg_validators/tx_validator/size_validator.ts +22 -0
  434. package/src/msg_validators/tx_validator/timestamp_validator.ts +29 -19
  435. package/src/msg_validators/tx_validator/tx_permitted_validator.ts +8 -3
  436. package/src/msg_validators/tx_validator/tx_proof_validator.ts +8 -3
  437. package/src/services/data_store.ts +10 -7
  438. package/src/services/discv5/discV5_service.ts +1 -1
  439. package/src/services/dummy_service.ts +63 -0
  440. package/src/services/encoding.ts +8 -6
  441. package/src/services/gossipsub/README.md +626 -0
  442. package/src/services/gossipsub/index.ts +2 -0
  443. package/src/services/gossipsub/scoring.ts +29 -5
  444. package/src/services/gossipsub/topic_score_params.ts +451 -0
  445. package/src/services/index.ts +1 -0
  446. package/src/services/libp2p/instrumentation.ts +32 -73
  447. package/src/services/libp2p/libp2p_service.ts +646 -301
  448. package/src/services/peer-manager/metrics.ts +22 -26
  449. package/src/services/peer-manager/peer_manager.ts +1 -2
  450. package/src/services/peer-manager/peer_scoring.ts +28 -4
  451. package/src/services/reqresp/batch-tx-requester/README.md +305 -0
  452. package/src/services/reqresp/batch-tx-requester/batch_tx_requester.ts +706 -0
  453. package/src/services/reqresp/batch-tx-requester/config.ts +40 -0
  454. package/src/services/reqresp/batch-tx-requester/interface.ts +57 -0
  455. package/src/services/reqresp/batch-tx-requester/missing_txs.ts +209 -0
  456. package/src/services/reqresp/batch-tx-requester/peer_collection.ts +205 -0
  457. package/src/services/reqresp/batch-tx-requester/tx_validator.ts +37 -0
  458. package/src/services/reqresp/connection-sampler/batch_connection_sampler.ts +65 -4
  459. package/src/services/reqresp/connection-sampler/connection_sampler.ts +19 -1
  460. package/src/services/reqresp/constants.ts +14 -0
  461. package/src/services/reqresp/interface.ts +29 -1
  462. package/src/services/reqresp/metrics.ts +36 -27
  463. package/src/services/reqresp/protocols/block_txs/bitvector.ts +16 -0
  464. package/src/services/reqresp/protocols/block_txs/block_txs_handler.ts +35 -12
  465. package/src/services/reqresp/protocols/block_txs/block_txs_reqresp.ts +74 -9
  466. package/src/services/reqresp/protocols/status.ts +7 -4
  467. package/src/services/reqresp/protocols/tx.ts +22 -0
  468. package/src/services/reqresp/reqresp.ts +79 -22
  469. package/src/services/service.ts +63 -4
  470. package/src/services/tx_collection/config.ts +83 -1
  471. package/src/services/tx_collection/fast_tx_collection.ts +44 -19
  472. package/src/services/tx_collection/file_store_tx_collection.ts +198 -0
  473. package/src/services/tx_collection/file_store_tx_source.ts +104 -0
  474. package/src/services/tx_collection/index.ts +6 -0
  475. package/src/services/tx_collection/instrumentation.ts +11 -13
  476. package/src/services/tx_collection/proposal_tx_collector.ts +112 -0
  477. package/src/services/tx_collection/slow_tx_collection.ts +66 -32
  478. package/src/services/tx_collection/tx_collection.ts +117 -21
  479. package/src/services/tx_collection/tx_collection_sink.ts +17 -7
  480. package/src/services/tx_file_store/config.ts +37 -0
  481. package/src/services/tx_file_store/index.ts +3 -0
  482. package/src/services/tx_file_store/instrumentation.ts +36 -0
  483. package/src/services/tx_file_store/tx_file_store.ts +175 -0
  484. package/src/services/tx_provider.ts +10 -9
  485. package/src/services/tx_provider_instrumentation.ts +13 -20
  486. package/src/test-helpers/index.ts +2 -0
  487. package/src/test-helpers/make-test-p2p-clients.ts +3 -3
  488. package/src/test-helpers/mock-pubsub.ts +133 -3
  489. package/src/test-helpers/reqresp-nodes.ts +2 -1
  490. package/src/test-helpers/test_tx_provider.ts +64 -0
  491. package/src/test-helpers/testbench-utils.ts +430 -0
  492. package/src/testbench/p2p_client_testbench_worker.ts +338 -120
  493. package/src/testbench/worker_client_manager.ts +304 -42
  494. package/dest/mem_pools/attestation_pool/kv_attestation_pool.d.ts +0 -37
  495. package/dest/mem_pools/attestation_pool/kv_attestation_pool.d.ts.map +0 -1
  496. package/dest/mem_pools/attestation_pool/kv_attestation_pool.js +0 -213
  497. package/dest/mem_pools/attestation_pool/memory_attestation_pool.d.ts +0 -30
  498. package/dest/mem_pools/attestation_pool/memory_attestation_pool.d.ts.map +0 -1
  499. package/dest/mem_pools/attestation_pool/memory_attestation_pool.js +0 -219
  500. package/dest/mem_pools/tx_pool/eviction/insufficient_fee_payer_balance_rule.d.ts +0 -15
  501. package/dest/mem_pools/tx_pool/eviction/insufficient_fee_payer_balance_rule.d.ts.map +0 -1
  502. package/dest/mem_pools/tx_pool/eviction/insufficient_fee_payer_balance_rule.js +0 -88
  503. package/dest/msg_validators/block_proposal_validator/block_proposal_validator.d.ts +0 -12
  504. package/dest/msg_validators/block_proposal_validator/block_proposal_validator.d.ts.map +0 -1
  505. package/dest/msg_validators/block_proposal_validator/block_proposal_validator.js +0 -82
  506. package/dest/msg_validators/block_proposal_validator/index.d.ts +0 -2
  507. package/dest/msg_validators/block_proposal_validator/index.d.ts.map +0 -1
  508. package/dest/msg_validators/block_proposal_validator/index.js +0 -1
  509. package/src/mem_pools/attestation_pool/kv_attestation_pool.ts +0 -298
  510. package/src/mem_pools/attestation_pool/memory_attestation_pool.ts +0 -287
  511. package/src/mem_pools/tx_pool/eviction/insufficient_fee_payer_balance_rule.ts +0 -108
  512. package/src/msg_validators/block_proposal_validator/block_proposal_validator.ts +0 -97
  513. package/src/msg_validators/block_proposal_validator/index.ts +0 -1
@@ -0,0 +1,198 @@
1
+ import { type Logger, createLogger } from '@aztec/foundation/log';
2
+ import { type PromiseWithResolvers, promiseWithResolvers } from '@aztec/foundation/promise';
3
+ import { sleep } from '@aztec/foundation/sleep';
4
+ import { DateProvider } from '@aztec/foundation/timer';
5
+ import { Tx, TxHash } from '@aztec/stdlib/tx';
6
+
7
+ import type { FileStoreTxSource } from './file_store_tx_source.js';
8
+ import type { TxAddContext, TxCollectionSink } from './tx_collection_sink.js';
9
+
10
+ /** Configuration for a FileStoreTxCollection instance. */
11
+ export type FileStoreCollectionConfig = {
12
+ workerCount: number;
13
+ backoffBaseMs: number;
14
+ backoffMaxMs: number;
15
+ };
16
+
17
+ type FileStoreTxEntry = {
18
+ txHash: string;
19
+ context: TxAddContext;
20
+ deadline: Date;
21
+ attempts: number;
22
+ lastAttemptTime: number;
23
+ nextSourceIndex: number;
24
+ };
25
+
26
+ /**
27
+ * Collects txs from file stores as a fallback after P2P methods have been tried.
28
+ * Uses a shared worker pool that pulls entries with priority (fewest attempts first),
29
+ * retries with round-robin across sources, and applies exponential backoff between
30
+ * full cycles through all sources.
31
+ */
32
+ export class FileStoreTxCollection {
33
+ /** Map from tx hash string to entry for all pending downloads. */
34
+ private entries = new Map<string, FileStoreTxEntry>();
35
+
36
+ /** Worker promises for the shared worker pool. */
37
+ private workers: Promise<void>[] = [];
38
+
39
+ /** Whether the worker pool is running. */
40
+ private running = false;
41
+
42
+ /** Signal used to wake sleeping workers when new entries arrive or stop is called. */
43
+ private wakeSignal: PromiseWithResolvers<void>;
44
+
45
+ constructor(
46
+ private readonly sources: FileStoreTxSource[],
47
+ private readonly txCollectionSink: TxCollectionSink,
48
+ private readonly config: FileStoreCollectionConfig,
49
+ private readonly dateProvider: DateProvider = new DateProvider(),
50
+ private readonly log: Logger = createLogger('p2p:file_store_tx_collection'),
51
+ ) {
52
+ this.wakeSignal = promiseWithResolvers<void>();
53
+ }
54
+
55
+ /** Starts the shared worker pool. */
56
+ public start(): void {
57
+ if (this.sources.length === 0) {
58
+ this.log.debug('No file store sources configured');
59
+ return;
60
+ }
61
+ this.running = true;
62
+ for (let i = 0; i < this.config.workerCount; i++) {
63
+ this.workers.push(this.workerLoop());
64
+ }
65
+ }
66
+
67
+ /** Stops all workers and clears state. */
68
+ public async stop(): Promise<void> {
69
+ this.running = false;
70
+ this.wake();
71
+ await Promise.all(this.workers);
72
+ this.workers = [];
73
+ this.entries.clear();
74
+ }
75
+
76
+ /** Adds entries to the shared map and wakes workers. */
77
+ public startCollecting(txHashes: TxHash[], context: TxAddContext, deadline: Date): void {
78
+ if (this.sources.length === 0 || txHashes.length === 0) {
79
+ return;
80
+ }
81
+ if (+deadline <= this.dateProvider.now()) {
82
+ return;
83
+ }
84
+
85
+ for (const txHash of txHashes) {
86
+ const hashStr = txHash.toString();
87
+ if (!this.entries.has(hashStr)) {
88
+ this.entries.set(hashStr, {
89
+ txHash: hashStr,
90
+ context,
91
+ deadline,
92
+ attempts: 0,
93
+ lastAttemptTime: 0,
94
+ nextSourceIndex: Math.floor(Math.random() * this.sources.length),
95
+ });
96
+ }
97
+ }
98
+ this.wake();
99
+ }
100
+
101
+ /** Removes entries for txs that have been found elsewhere. */
102
+ public foundTxs(txs: Tx[]): void {
103
+ for (const tx of txs) {
104
+ this.entries.delete(tx.getTxHash().toString());
105
+ }
106
+ }
107
+
108
+ /** Clears all pending entries. */
109
+ public clearPending(): void {
110
+ this.entries.clear();
111
+ }
112
+
113
+ private async workerLoop(): Promise<void> {
114
+ while (this.running) {
115
+ const action = this.getNextAction();
116
+ if (action.type === 'sleep') {
117
+ await action.promise;
118
+ continue;
119
+ }
120
+
121
+ const entry = action.entry;
122
+ const source = this.sources[entry.nextSourceIndex % this.sources.length];
123
+ entry.nextSourceIndex++;
124
+ entry.attempts++;
125
+ entry.lastAttemptTime = this.dateProvider.now();
126
+
127
+ try {
128
+ const result = await this.txCollectionSink.collect(
129
+ hashes => source.getTxsByHash(hashes),
130
+ [TxHash.fromString(entry.txHash)],
131
+ { description: `file-store ${source.getInfo()}`, method: 'file-store', fileStore: source.getInfo() },
132
+ entry.context,
133
+ );
134
+ if (result.txs.length > 0) {
135
+ this.entries.delete(entry.txHash);
136
+ }
137
+ } catch (err) {
138
+ this.log.trace(`Error downloading tx ${entry.txHash} from ${source.getInfo()}`, { err });
139
+ }
140
+ }
141
+ }
142
+
143
+ /** Single-pass scan: removes expired entries, finds the best ready entry, or computes sleep time. */
144
+ private getNextAction(): { type: 'process'; entry: FileStoreTxEntry } | { type: 'sleep'; promise: Promise<void> } {
145
+ const now = this.dateProvider.now();
146
+ let best: FileStoreTxEntry | undefined;
147
+ let earliestReadyAt = Infinity;
148
+
149
+ for (const [key, entry] of this.entries) {
150
+ if (+entry.deadline <= now) {
151
+ this.entries.delete(key);
152
+ continue;
153
+ }
154
+ const backoffMs = this.getBackoffMs(entry);
155
+ const readyAt = entry.lastAttemptTime + backoffMs;
156
+ if (readyAt > now) {
157
+ earliestReadyAt = Math.min(earliestReadyAt, readyAt);
158
+ continue;
159
+ }
160
+ if (!best || entry.attempts < best.attempts) {
161
+ best = entry;
162
+ }
163
+ }
164
+
165
+ if (best) {
166
+ return { type: 'process', entry: best };
167
+ }
168
+ if (earliestReadyAt < Infinity) {
169
+ return { type: 'sleep', promise: this.sleepOrWake(earliestReadyAt - now) };
170
+ }
171
+ return { type: 'sleep', promise: this.waitForWake() };
172
+ }
173
+
174
+ /** Computes backoff for an entry. Backoff applies after a full cycle through all sources. */
175
+ private getBackoffMs(entry: FileStoreTxEntry): number {
176
+ const fullCycles = Math.floor(entry.attempts / this.sources.length);
177
+ if (fullCycles === 0) {
178
+ return 0;
179
+ }
180
+ return Math.min(this.config.backoffBaseMs * Math.pow(2, fullCycles - 1), this.config.backoffMaxMs);
181
+ }
182
+
183
+ /** Resolves the current wake signal and creates a new one. */
184
+ private wake(): void {
185
+ this.wakeSignal.resolve();
186
+ this.wakeSignal = promiseWithResolvers<void>();
187
+ }
188
+
189
+ /** Waits until the wake signal is resolved. */
190
+ private async waitForWake(): Promise<void> {
191
+ await this.wakeSignal.promise;
192
+ }
193
+
194
+ /** Sleeps for the given duration or until the wake signal is resolved. */
195
+ private async sleepOrWake(ms: number): Promise<void> {
196
+ await Promise.race([sleep(ms), this.wakeSignal.promise]);
197
+ }
198
+ }
@@ -0,0 +1,104 @@
1
+ import { type Logger, createLogger } from '@aztec/foundation/log';
2
+ import { Timer } from '@aztec/foundation/timer';
3
+ import { type ReadOnlyFileStore, createReadOnlyFileStore } from '@aztec/stdlib/file-store';
4
+ import { Tx, type TxHash } from '@aztec/stdlib/tx';
5
+ import {
6
+ type Histogram,
7
+ Metrics,
8
+ type TelemetryClient,
9
+ type UpDownCounter,
10
+ getTelemetryClient,
11
+ } from '@aztec/telemetry-client';
12
+
13
+ import type { TxSource } from './tx_source.js';
14
+
15
+ /** TxSource implementation that downloads txs from a file store. */
16
+ export class FileStoreTxSource implements TxSource {
17
+ private downloadsSuccess: UpDownCounter;
18
+ private downloadsFailed: UpDownCounter;
19
+ private downloadDuration: Histogram;
20
+ private downloadSize: Histogram;
21
+
22
+ private constructor(
23
+ private readonly fileStore: ReadOnlyFileStore,
24
+ private readonly baseUrl: string,
25
+ private readonly basePath: string,
26
+ private readonly log: Logger,
27
+ telemetry: TelemetryClient,
28
+ ) {
29
+ const meter = telemetry.getMeter('file-store-tx-source');
30
+ this.downloadsSuccess = meter.createUpDownCounter(Metrics.TX_FILE_STORE_DOWNLOADS_SUCCESS);
31
+ this.downloadsFailed = meter.createUpDownCounter(Metrics.TX_FILE_STORE_DOWNLOADS_FAILED);
32
+ this.downloadDuration = meter.createHistogram(Metrics.TX_FILE_STORE_DOWNLOAD_DURATION);
33
+ this.downloadSize = meter.createHistogram(Metrics.TX_FILE_STORE_DOWNLOAD_SIZE);
34
+ }
35
+
36
+ /**
37
+ * Creates a FileStoreTxSource from a URL.
38
+ * @param url - The file store URL (s3://, gs://, file://, http://, https://).
39
+ * @param basePath - Base path for tx files within the store.
40
+ * @param log - Optional logger.
41
+ * @param telemetry - Optional telemetry client.
42
+ * @returns The FileStoreTxSource instance, or undefined if creation fails.
43
+ */
44
+ public static async create(
45
+ url: string,
46
+ basePath: string,
47
+ log: Logger = createLogger('p2p:file_store_tx_source'),
48
+ telemetry: TelemetryClient = getTelemetryClient(),
49
+ ): Promise<FileStoreTxSource | undefined> {
50
+ try {
51
+ const fileStore = await createReadOnlyFileStore(url, log);
52
+ if (!fileStore) {
53
+ log.warn(`Failed to create file store for URL: ${url}`);
54
+ return undefined;
55
+ }
56
+ return new FileStoreTxSource(fileStore, url, basePath, log, telemetry);
57
+ } catch (err) {
58
+ log.warn(`Error creating file store for URL: ${url}`, { error: err });
59
+ return undefined;
60
+ }
61
+ }
62
+
63
+ public getInfo(): string {
64
+ return `file-store:${this.baseUrl}`;
65
+ }
66
+
67
+ public getTxsByHash(txHashes: TxHash[]): Promise<(Tx | undefined)[]> {
68
+ return Promise.all(
69
+ txHashes.map(async txHash => {
70
+ const path = `${this.basePath}/txs/${txHash.toString()}.bin`;
71
+ const timer = new Timer();
72
+ try {
73
+ const buffer = await this.fileStore.read(path);
74
+ this.downloadsSuccess.add(1);
75
+ this.downloadDuration.record(Math.ceil(timer.ms()));
76
+ this.downloadSize.record(buffer.length);
77
+ return Tx.fromBuffer(buffer);
78
+ } catch {
79
+ this.downloadsFailed.add(1);
80
+ // Tx not found or error reading - return undefined
81
+ return undefined;
82
+ }
83
+ }),
84
+ );
85
+ }
86
+ }
87
+
88
+ /**
89
+ * Creates FileStoreTxSource instances from URLs.
90
+ * @param urls - Array of file store URLs.
91
+ * @param basePath - Base path for tx files within each store.
92
+ * @param log - Optional logger.
93
+ * @param telemetry - Optional telemetry client.
94
+ * @returns Array of successfully created FileStoreTxSource instances.
95
+ */
96
+ export async function createFileStoreTxSources(
97
+ urls: string[],
98
+ basePath: string,
99
+ log: Logger = createLogger('p2p:file_store_tx_source'),
100
+ telemetry: TelemetryClient = getTelemetryClient(),
101
+ ): Promise<FileStoreTxSource[]> {
102
+ const sources = await Promise.all(urls.map(url => FileStoreTxSource.create(url, basePath, log, telemetry)));
103
+ return sources.filter((s): s is FileStoreTxSource => s !== undefined);
104
+ }
@@ -1,2 +1,8 @@
1
1
  export { TxCollection, type FastCollectionRequestInput } from './tx_collection.js';
2
2
  export { type TxSource, createNodeRpcTxSources, NodeRpcTxSource } from './tx_source.js';
3
+ export {
4
+ type MissingTxsCollector,
5
+ BatchTxRequesterCollector,
6
+ SendBatchRequestCollector,
7
+ } from './proposal_tx_collector.js';
8
+ export { FileStoreTxSource, createFileStoreTxSources } from './file_store_tx_source.js';
@@ -4,7 +4,7 @@ import {
4
4
  Metrics,
5
5
  type TelemetryClient,
6
6
  type UpDownCounter,
7
- ValueType,
7
+ createUpDownCounterWithDefault,
8
8
  } from '@aztec/telemetry-client';
9
9
 
10
10
  import type { CollectionMethod } from './tx_collection.js';
@@ -17,21 +17,19 @@ export class TxCollectionInstrumentation {
17
17
  constructor(client: TelemetryClient, name: string) {
18
18
  const meter = client.getMeter(name);
19
19
 
20
- this.txsCollected = meter.createUpDownCounter(Metrics.TX_COLLECTOR_COUNT, {
21
- description: 'The number of txs collected',
20
+ this.txsCollected = createUpDownCounterWithDefault(meter, Metrics.TX_COLLECTOR_COUNT, {
21
+ [Attributes.TX_COLLECTION_METHOD]: [
22
+ 'fast-req-resp',
23
+ 'fast-node-rpc',
24
+ 'slow-req-resp',
25
+ 'slow-node-rpc',
26
+ 'file-store',
27
+ ],
22
28
  });
23
29
 
24
- this.collectionDurationPerTx = meter.createHistogram(Metrics.TX_COLLECTOR_DURATION_PER_TX, {
25
- unit: 'ms',
26
- description: 'Average duration per tx of an individual tx collection request',
27
- valueType: ValueType.INT,
28
- });
30
+ this.collectionDurationPerTx = meter.createHistogram(Metrics.TX_COLLECTOR_DURATION_PER_TX);
29
31
 
30
- this.collectionDurationPerRequest = meter.createHistogram(Metrics.TX_COLLECTOR_DURATION_PER_REQUEST, {
31
- unit: 'ms',
32
- description: 'Total duration of an individual tx collection request',
33
- valueType: ValueType.INT,
34
- });
32
+ this.collectionDurationPerRequest = meter.createHistogram(Metrics.TX_COLLECTOR_DURATION_PER_REQUEST);
35
33
  }
36
34
 
37
35
  increaseTxsFor(what: CollectionMethod, count: number, duration: number) {
@@ -0,0 +1,112 @@
1
+ import type { Logger } from '@aztec/foundation/log';
2
+ import type { DateProvider } from '@aztec/foundation/timer';
3
+ import type { Tx, TxHash } from '@aztec/stdlib/tx';
4
+
5
+ import type { PeerId } from '@libp2p/interface';
6
+
7
+ import { BatchTxRequester } from '../reqresp/batch-tx-requester/batch_tx_requester.js';
8
+ import type { BatchTxRequesterConfig } from '../reqresp/batch-tx-requester/config.js';
9
+ import type { BatchTxRequesterLibP2PService } from '../reqresp/batch-tx-requester/interface.js';
10
+ import type { IBatchRequestTxValidator } from '../reqresp/batch-tx-requester/tx_validator.js';
11
+ import { type BlockTxsSource, ReqRespSubProtocol, chunkTxHashesRequest } from '../reqresp/index.js';
12
+
13
+ /**
14
+ * Strategy interface for collecting missing transactions for a block or proposal.
15
+ * Allows swapping between different tx collection implementations for benchmarking.
16
+ */
17
+ export interface MissingTxsCollector {
18
+ /**
19
+ * Collect missing transactions for a block or proposal.
20
+ * @param txHashes - The transaction hashes to collect
21
+ * @param blockTxsSource - The block or proposal containing the transactions
22
+ * @param pinnedPeer - Optional peer expected to have the transactions
23
+ * @param timeoutMs - Timeout in milliseconds
24
+ * @returns The collected transactions
25
+ */
26
+ collectTxs(
27
+ txHashes: TxHash[],
28
+ blockTxsSource: BlockTxsSource,
29
+ pinnedPeer: PeerId | undefined,
30
+ timeoutMs: number,
31
+ ): Promise<Tx[]>;
32
+ }
33
+
34
+ /**
35
+ * Collects transactions using the BatchTxRequester implementation.
36
+ * This uses a smart/dumb peer strategy with parallel workers.
37
+ */
38
+ export class BatchTxRequesterCollector implements MissingTxsCollector {
39
+ constructor(
40
+ private p2pService: BatchTxRequesterLibP2PService,
41
+ private log: Logger,
42
+ private dateProvider: DateProvider,
43
+ private txValidator?: IBatchRequestTxValidator,
44
+ private batchTxRequesterConfig?: Partial<BatchTxRequesterConfig>,
45
+ ) {}
46
+
47
+ async collectTxs(
48
+ txHashes: TxHash[],
49
+ blockTxsSource: BlockTxsSource,
50
+ pinnedPeer: PeerId | undefined,
51
+ timeoutMs: number,
52
+ ): Promise<Tx[]> {
53
+ const {
54
+ batchTxRequesterSmartParallelWorkerCount: smartParallelWorkerCount,
55
+ batchTxRequesterDumbParallelWorkerCount: dumbParallelWorkerCount,
56
+ batchTxRequesterTxBatchSize: txBatchSize,
57
+ batchTxRequesterBadPeerThreshold: badPeerThreshold,
58
+ } = this.batchTxRequesterConfig ?? {};
59
+
60
+ const batchRequester = new BatchTxRequester(
61
+ txHashes,
62
+ blockTxsSource,
63
+ pinnedPeer,
64
+ timeoutMs,
65
+ this.p2pService,
66
+ this.log,
67
+ this.dateProvider,
68
+ {
69
+ smartParallelWorkerCount,
70
+ dumbParallelWorkerCount,
71
+ txBatchSize,
72
+ badPeerThreshold,
73
+ txValidator: this.txValidator,
74
+ },
75
+ );
76
+
77
+ return await BatchTxRequester.collectAllTxs(batchRequester.run());
78
+ }
79
+ }
80
+
81
+ const DEFAULT_MAX_PEERS = 10;
82
+ const DEFAULT_MAX_RETRY_ATTEMPTS = 3;
83
+
84
+ /**
85
+ * Collects transactions using the sendBatchRequest implementation from ReqResp.
86
+ * This is the original implementation that balances requests across peers.
87
+ */
88
+ export class SendBatchRequestCollector implements MissingTxsCollector {
89
+ constructor(
90
+ private p2pService: BatchTxRequesterLibP2PService,
91
+ private maxPeers: number = DEFAULT_MAX_PEERS,
92
+ private maxRetryAttempts: number = DEFAULT_MAX_RETRY_ATTEMPTS,
93
+ ) {}
94
+
95
+ async collectTxs(
96
+ txHashes: TxHash[],
97
+ _blockTxsSource: BlockTxsSource,
98
+ pinnedPeer: PeerId | undefined,
99
+ timeoutMs: number,
100
+ ): Promise<Tx[]> {
101
+ const txs = await this.p2pService.reqResp.sendBatchRequest<ReqRespSubProtocol.TX>(
102
+ ReqRespSubProtocol.TX,
103
+ chunkTxHashesRequest(txHashes),
104
+ pinnedPeer,
105
+ timeoutMs,
106
+ this.maxPeers,
107
+ this.maxRetryAttempts,
108
+ );
109
+
110
+ return txs.flat();
111
+ }
112
+ }
@@ -4,7 +4,7 @@ import { type Logger, createLogger } from '@aztec/foundation/log';
4
4
  import { boundInclusive } from '@aztec/foundation/number';
5
5
  import { RunningPromise } from '@aztec/foundation/promise';
6
6
  import { DateProvider } from '@aztec/foundation/timer';
7
- import type { L2BlockNew } from '@aztec/stdlib/block';
7
+ import type { L2Block } from '@aztec/stdlib/block';
8
8
  import { type L1RollupConstants, getEpochAtSlot, getTimestampRangeForEpoch } from '@aztec/stdlib/epoch-helpers';
9
9
  import { type Tx, TxHash } from '@aztec/stdlib/tx';
10
10
 
@@ -76,7 +76,7 @@ export class SlowTxCollection {
76
76
  }
77
77
 
78
78
  /** Starts collecting the given tx hashes for the given L2Block in the slow loop */
79
- public startCollecting(block: L2BlockNew, txHashes: TxHash[]) {
79
+ public startCollecting(block: L2Block, txHashes: TxHash[]) {
80
80
  const slot = block.header.getSlot();
81
81
  const deadline = this.getDeadlineForSlot(slot);
82
82
  if (+deadline < this.dateProvider.now()) {
@@ -91,6 +91,7 @@ export class SlowTxCollection {
91
91
 
92
92
  for (const txHash of txHashes) {
93
93
  this.missingTxs.set(txHash.toString(), {
94
+ block,
94
95
  blockNumber: block.number,
95
96
  deadline: this.getDeadlineForSlot(block.header.getSlot()),
96
97
  readyForReqResp: this.nodes.length === 0, // If we have no nodes, we can start reqresp immediately
@@ -109,18 +110,26 @@ export class SlowTxCollection {
109
110
 
110
111
  // Gather all missing txs that are not in fast collection and request them from the node
111
112
  const missingTxs = this.getMissingTxsForSlowCollection();
112
- const missingTxHashes = missingTxs.map(([txHash]) => txHash).map(TxHash.fromString);
113
- if (missingTxHashes.length === 0) {
113
+ if (missingTxs.length === 0) {
114
114
  return;
115
115
  }
116
116
 
117
- // Request in chunks to avoid hitting RPC limits
118
- for (const batch of chunk(missingTxHashes, this.config.txCollectionNodeRpcMaxBatchSize)) {
119
- await this.txCollectionSink.collect(txHashes => node.getTxsByHash(txHashes), batch, {
120
- description: `node ${node.getInfo()}`,
121
- node: node.getInfo(),
122
- method: 'slow-node-rpc',
123
- });
117
+ // Group by block so we pass the correct mined context to the sink
118
+ for (const entries of this.groupByBlock(missingTxs)) {
119
+ const block = entries[0][1].block;
120
+ const txHashes = entries.map(([txHash]) => TxHash.fromString(txHash));
121
+ for (const batch of chunk(txHashes, this.config.txCollectionNodeRpcMaxBatchSize)) {
122
+ await this.txCollectionSink.collect(
123
+ hashes => node.getTxsByHash(hashes),
124
+ batch,
125
+ {
126
+ description: `node ${node.getInfo()}`,
127
+ node: node.getInfo(),
128
+ method: 'slow-node-rpc',
129
+ },
130
+ { type: 'mined', block },
131
+ );
132
+ }
124
133
  }
125
134
 
126
135
  // Mark every tx that is still missing as ready for reqresp.
@@ -149,25 +158,30 @@ export class SlowTxCollection {
149
158
 
150
159
  const pinnedPeer = undefined;
151
160
  const timeoutMs = this.config.txCollectionSlowReqRespTimeoutMs;
152
- const maxPeers = boundInclusive(Math.ceil(missingTxs.length / 3), 4, 16);
153
161
  const maxRetryAttempts = 3;
154
- // Send a batch request via reqresp for the missing txs
155
- await this.txCollectionSink.collect(
156
- async txHashes => {
157
- const txs = await this.reqResp.sendBatchRequest<ReqRespSubProtocol.TX>(
158
- ReqRespSubProtocol.TX,
159
- chunkTxHashesRequest(txHashes),
160
- pinnedPeer,
161
- timeoutMs,
162
- maxPeers,
163
- maxRetryAttempts,
164
- );
165
162
 
166
- return txs.flat();
167
- },
168
- missingTxs.map(([txHash]) => TxHash.fromString(txHash)),
169
- { description: 'slow reqresp', timeoutMs, method: 'slow-req-resp' },
170
- );
163
+ // Group by block so we pass the correct mined context to the sink
164
+ for (const entries of this.groupByBlock(missingTxs)) {
165
+ const block = entries[0][1].block;
166
+ const txHashes = entries.map(([txHash]) => TxHash.fromString(txHash));
167
+ const maxPeers = boundInclusive(Math.ceil(txHashes.length / 3), 4, 16);
168
+ await this.txCollectionSink.collect(
169
+ async hashes => {
170
+ const txs = await this.reqResp.sendBatchRequest<ReqRespSubProtocol.TX>(
171
+ ReqRespSubProtocol.TX,
172
+ chunkTxHashesRequest(hashes),
173
+ pinnedPeer,
174
+ timeoutMs,
175
+ maxPeers,
176
+ maxRetryAttempts,
177
+ );
178
+ return txs.flat();
179
+ },
180
+ txHashes,
181
+ { description: 'slow reqresp', timeoutMs, method: 'slow-req-resp' },
182
+ { type: 'mined', block },
183
+ );
184
+ }
171
185
  }
172
186
 
173
187
  /** Retrieves all missing txs for the slow collection process. This is, all missing txs that are not part of a fast request. */
@@ -223,11 +237,31 @@ export class SlowTxCollection {
223
237
  }
224
238
  }
225
239
 
240
+ /** Groups missing tx entries by block number. */
241
+ private groupByBlock(entries: [string, MissingTxInfo][]): [string, MissingTxInfo][][] {
242
+ const groups = new Map<number, [string, MissingTxInfo][]>();
243
+ for (const entry of entries) {
244
+ const bn = +entry[1].blockNumber;
245
+ let group = groups.get(bn);
246
+ if (!group) {
247
+ group = [];
248
+ groups.set(bn, group);
249
+ }
250
+ group.push(entry);
251
+ }
252
+ return [...groups.values()];
253
+ }
254
+
226
255
  /** Computes the proof submission deadline for a given slot, a tx mined in this slot is no longer interesting after this deadline */
227
256
  private getDeadlineForSlot(slotNumber: SlotNumber): Date {
228
- const epoch = getEpochAtSlot(slotNumber, this.constants);
229
- const submissionEndEpoch = EpochNumber(epoch + this.constants.proofSubmissionEpochs);
230
- const submissionEndTimestamp = getTimestampRangeForEpoch(submissionEndEpoch, this.constants)[1];
231
- return new Date(Number(submissionEndTimestamp) * 1000);
257
+ return getProofDeadlineForSlot(slotNumber, this.constants);
232
258
  }
233
259
  }
260
+
261
+ /** Computes the proof submission deadline for a given slot. A tx mined in this slot is no longer interesting after this deadline. */
262
+ export function getProofDeadlineForSlot(slotNumber: SlotNumber, constants: L1RollupConstants): Date {
263
+ const epoch = getEpochAtSlot(slotNumber, constants);
264
+ const submissionEndEpoch = EpochNumber(epoch + constants.proofSubmissionEpochs);
265
+ const submissionEndTimestamp = getTimestampRangeForEpoch(submissionEndEpoch, constants)[1];
266
+ return new Date(Number(submissionEndTimestamp) * 1000);
267
+ }