@aztec/p2p 0.0.1-commit.f1df4d2 → 0.0.1-commit.f224bb98b

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 (394) hide show
  1. package/dest/client/factory.d.ts +11 -11
  2. package/dest/client/factory.d.ts.map +1 -1
  3. package/dest/client/factory.js +45 -15
  4. package/dest/client/interface.d.ts +46 -33
  5. package/dest/client/interface.d.ts.map +1 -1
  6. package/dest/client/p2p_client.d.ts +39 -51
  7. package/dest/client/p2p_client.d.ts.map +1 -1
  8. package/dest/client/p2p_client.js +151 -224
  9. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker.js +7 -8
  10. package/dest/config.d.ts +49 -18
  11. package/dest/config.d.ts.map +1 -1
  12. package/dest/config.js +92 -38
  13. package/dest/errors/tx-pool.error.d.ts +8 -0
  14. package/dest/errors/tx-pool.error.d.ts.map +1 -0
  15. package/dest/errors/tx-pool.error.js +9 -0
  16. package/dest/index.d.ts +2 -1
  17. package/dest/index.d.ts.map +1 -1
  18. package/dest/index.js +1 -0
  19. package/dest/mem_pools/attestation_pool/attestation_pool.d.ts +104 -88
  20. package/dest/mem_pools/attestation_pool/attestation_pool.d.ts.map +1 -1
  21. package/dest/mem_pools/attestation_pool/attestation_pool.js +445 -3
  22. package/dest/mem_pools/attestation_pool/attestation_pool_test_suite.d.ts +2 -2
  23. package/dest/mem_pools/attestation_pool/attestation_pool_test_suite.d.ts.map +1 -1
  24. package/dest/mem_pools/attestation_pool/attestation_pool_test_suite.js +353 -87
  25. package/dest/mem_pools/attestation_pool/index.d.ts +2 -3
  26. package/dest/mem_pools/attestation_pool/index.d.ts.map +1 -1
  27. package/dest/mem_pools/attestation_pool/index.js +1 -2
  28. package/dest/mem_pools/attestation_pool/mocks.d.ts +2 -2
  29. package/dest/mem_pools/attestation_pool/mocks.d.ts.map +1 -1
  30. package/dest/mem_pools/attestation_pool/mocks.js +2 -2
  31. package/dest/mem_pools/index.d.ts +3 -2
  32. package/dest/mem_pools/index.d.ts.map +1 -1
  33. package/dest/mem_pools/index.js +1 -1
  34. package/dest/mem_pools/instrumentation.d.ts +4 -2
  35. package/dest/mem_pools/instrumentation.d.ts.map +1 -1
  36. package/dest/mem_pools/instrumentation.js +16 -14
  37. package/dest/mem_pools/interface.d.ts +5 -5
  38. package/dest/mem_pools/interface.d.ts.map +1 -1
  39. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.js +3 -3
  40. package/dest/mem_pools/tx_pool/priority.d.ts +2 -2
  41. package/dest/mem_pools/tx_pool/priority.d.ts.map +1 -1
  42. package/dest/mem_pools/tx_pool/priority.js +4 -3
  43. package/dest/mem_pools/tx_pool/tx_pool_test_suite.d.ts +1 -1
  44. package/dest/mem_pools/tx_pool/tx_pool_test_suite.d.ts.map +1 -1
  45. package/dest/mem_pools/tx_pool/tx_pool_test_suite.js +3 -1
  46. package/dest/mem_pools/tx_pool_v2/archive/index.d.ts +2 -0
  47. package/dest/mem_pools/tx_pool_v2/archive/index.d.ts.map +1 -0
  48. package/dest/mem_pools/tx_pool_v2/archive/index.js +1 -0
  49. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.d.ts +43 -0
  50. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.d.ts.map +1 -0
  51. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.js +103 -0
  52. package/dest/mem_pools/tx_pool_v2/deleted_pool.d.ts +104 -0
  53. package/dest/mem_pools/tx_pool_v2/deleted_pool.d.ts.map +1 -0
  54. package/dest/mem_pools/tx_pool_v2/deleted_pool.js +251 -0
  55. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.d.ts +47 -0
  56. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.d.ts.map +1 -0
  57. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.js +128 -0
  58. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.d.ts +17 -0
  59. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.d.ts.map +1 -0
  60. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.js +93 -0
  61. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.d.ts +19 -0
  62. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.d.ts.map +1 -0
  63. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.js +97 -0
  64. package/dest/mem_pools/tx_pool_v2/eviction/index.d.ts +10 -0
  65. package/dest/mem_pools/tx_pool_v2/eviction/index.d.ts.map +1 -0
  66. package/dest/mem_pools/tx_pool_v2/eviction/index.js +11 -0
  67. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.d.ts +180 -0
  68. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.d.ts.map +1 -0
  69. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.js +25 -0
  70. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.d.ts +15 -0
  71. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.d.ts.map +1 -0
  72. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.js +65 -0
  73. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.d.ts +17 -0
  74. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.d.ts.map +1 -0
  75. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.js +93 -0
  76. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.d.ts +16 -0
  77. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.d.ts.map +1 -0
  78. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.js +78 -0
  79. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.d.ts +20 -0
  80. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.d.ts.map +1 -0
  81. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.js +75 -0
  82. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.d.ts +15 -0
  83. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.d.ts.map +1 -0
  84. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.js +19 -0
  85. package/dest/mem_pools/tx_pool_v2/index.d.ts +6 -0
  86. package/dest/mem_pools/tx_pool_v2/index.d.ts.map +1 -0
  87. package/dest/mem_pools/tx_pool_v2/index.js +5 -0
  88. package/dest/mem_pools/tx_pool_v2/instrumentation.d.ts +15 -0
  89. package/dest/mem_pools/tx_pool_v2/instrumentation.d.ts.map +1 -0
  90. package/dest/mem_pools/tx_pool_v2/instrumentation.js +43 -0
  91. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts +213 -0
  92. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts.map +1 -0
  93. package/dest/mem_pools/tx_pool_v2/interfaces.js +10 -0
  94. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts +127 -0
  95. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts.map +1 -0
  96. package/dest/mem_pools/tx_pool_v2/tx_metadata.js +210 -0
  97. package/dest/mem_pools/tx_pool_v2/tx_pool_bench_metrics.d.ts +26 -0
  98. package/dest/mem_pools/tx_pool_v2/tx_pool_bench_metrics.d.ts.map +1 -0
  99. package/dest/mem_pools/tx_pool_v2/tx_pool_bench_metrics.js +70 -0
  100. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.d.ts +108 -0
  101. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.d.ts.map +1 -0
  102. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.js +337 -0
  103. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts +60 -0
  104. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts.map +1 -0
  105. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.js +164 -0
  106. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts +78 -0
  107. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts.map +1 -0
  108. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.js +916 -0
  109. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts +3 -3
  110. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts.map +1 -1
  111. package/dest/msg_validators/proposal_validator/block_proposal_validator.d.ts +6 -4
  112. package/dest/msg_validators/proposal_validator/block_proposal_validator.d.ts.map +1 -1
  113. package/dest/msg_validators/proposal_validator/block_proposal_validator.js +10 -2
  114. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.d.ts +6 -4
  115. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.d.ts.map +1 -1
  116. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.js +16 -2
  117. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts +13 -8
  118. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts.map +1 -1
  119. package/dest/msg_validators/proposal_validator/proposal_validator.js +48 -36
  120. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts +4 -4
  121. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts.map +1 -1
  122. package/dest/msg_validators/tx_validator/aggregate_tx_validator.js +3 -3
  123. package/dest/msg_validators/tx_validator/allowed_public_setup.d.ts +2 -1
  124. package/dest/msg_validators/tx_validator/allowed_public_setup.d.ts.map +1 -1
  125. package/dest/msg_validators/tx_validator/allowed_public_setup.js +24 -20
  126. package/dest/msg_validators/tx_validator/allowed_setup_helpers.d.ts +17 -0
  127. package/dest/msg_validators/tx_validator/allowed_setup_helpers.d.ts.map +1 -0
  128. package/dest/msg_validators/tx_validator/allowed_setup_helpers.js +24 -0
  129. package/dest/msg_validators/tx_validator/block_header_validator.d.ts +16 -3
  130. package/dest/msg_validators/tx_validator/block_header_validator.d.ts.map +1 -1
  131. package/dest/msg_validators/tx_validator/block_header_validator.js +1 -1
  132. package/dest/msg_validators/tx_validator/double_spend_validator.d.ts +13 -3
  133. package/dest/msg_validators/tx_validator/double_spend_validator.d.ts.map +1 -1
  134. package/dest/msg_validators/tx_validator/double_spend_validator.js +4 -4
  135. package/dest/msg_validators/tx_validator/factory.d.ts +125 -6
  136. package/dest/msg_validators/tx_validator/factory.d.ts.map +1 -1
  137. package/dest/msg_validators/tx_validator/factory.js +226 -58
  138. package/dest/msg_validators/tx_validator/fee_payer_balance.d.ts +1 -1
  139. package/dest/msg_validators/tx_validator/fee_payer_balance.d.ts.map +1 -1
  140. package/dest/msg_validators/tx_validator/fee_payer_balance.js +6 -2
  141. package/dest/msg_validators/tx_validator/gas_validator.d.ts +67 -3
  142. package/dest/msg_validators/tx_validator/gas_validator.d.ts.map +1 -1
  143. package/dest/msg_validators/tx_validator/gas_validator.js +104 -37
  144. package/dest/msg_validators/tx_validator/index.d.ts +3 -1
  145. package/dest/msg_validators/tx_validator/index.d.ts.map +1 -1
  146. package/dest/msg_validators/tx_validator/index.js +2 -0
  147. package/dest/msg_validators/tx_validator/metadata_validator.d.ts +1 -1
  148. package/dest/msg_validators/tx_validator/metadata_validator.d.ts.map +1 -1
  149. package/dest/msg_validators/tx_validator/metadata_validator.js +4 -4
  150. package/dest/msg_validators/tx_validator/nullifier_cache.d.ts +14 -0
  151. package/dest/msg_validators/tx_validator/nullifier_cache.d.ts.map +1 -0
  152. package/dest/msg_validators/tx_validator/nullifier_cache.js +24 -0
  153. package/dest/msg_validators/tx_validator/phases_validator.d.ts +2 -2
  154. package/dest/msg_validators/tx_validator/phases_validator.d.ts.map +1 -1
  155. package/dest/msg_validators/tx_validator/phases_validator.js +44 -23
  156. package/dest/msg_validators/tx_validator/timestamp_validator.d.ts +20 -4
  157. package/dest/msg_validators/tx_validator/timestamp_validator.d.ts.map +1 -1
  158. package/dest/msg_validators/tx_validator/timestamp_validator.js +6 -6
  159. package/dest/services/dummy_service.d.ts +13 -5
  160. package/dest/services/dummy_service.d.ts.map +1 -1
  161. package/dest/services/dummy_service.js +10 -4
  162. package/dest/services/encoding.d.ts +3 -3
  163. package/dest/services/encoding.d.ts.map +1 -1
  164. package/dest/services/encoding.js +11 -10
  165. package/dest/services/gossipsub/index.d.ts +3 -0
  166. package/dest/services/gossipsub/index.d.ts.map +1 -0
  167. package/dest/services/gossipsub/index.js +2 -0
  168. package/dest/services/gossipsub/scoring.d.ts +21 -3
  169. package/dest/services/gossipsub/scoring.d.ts.map +1 -1
  170. package/dest/services/gossipsub/scoring.js +24 -7
  171. package/dest/services/gossipsub/topic_score_params.d.ts +173 -0
  172. package/dest/services/gossipsub/topic_score_params.d.ts.map +1 -0
  173. package/dest/services/gossipsub/topic_score_params.js +346 -0
  174. package/dest/services/libp2p/libp2p_service.d.ts +94 -42
  175. package/dest/services/libp2p/libp2p_service.d.ts.map +1 -1
  176. package/dest/services/libp2p/libp2p_service.js +463 -350
  177. package/dest/services/peer-manager/metrics.d.ts +3 -1
  178. package/dest/services/peer-manager/metrics.d.ts.map +1 -1
  179. package/dest/services/peer-manager/metrics.js +6 -0
  180. package/dest/services/peer-manager/peer_manager.d.ts +1 -1
  181. package/dest/services/peer-manager/peer_manager.d.ts.map +1 -1
  182. package/dest/services/peer-manager/peer_manager.js +2 -1
  183. package/dest/services/peer-manager/peer_scoring.d.ts +1 -1
  184. package/dest/services/peer-manager/peer_scoring.d.ts.map +1 -1
  185. package/dest/services/peer-manager/peer_scoring.js +25 -2
  186. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts +6 -5
  187. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts.map +1 -1
  188. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.js +26 -53
  189. package/dest/services/reqresp/batch-tx-requester/interface.d.ts +2 -6
  190. package/dest/services/reqresp/batch-tx-requester/interface.d.ts.map +1 -1
  191. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts +10 -13
  192. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts.map +1 -1
  193. package/dest/services/reqresp/batch-tx-requester/missing_txs.js +25 -46
  194. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts +17 -11
  195. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts.map +1 -1
  196. package/dest/services/reqresp/batch-tx-requester/peer_collection.js +49 -15
  197. package/dest/services/reqresp/batch-tx-requester/tx_validator.js +2 -2
  198. package/dest/services/reqresp/interface.d.ts +10 -1
  199. package/dest/services/reqresp/interface.d.ts.map +1 -1
  200. package/dest/services/reqresp/interface.js +15 -1
  201. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts +7 -5
  202. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts.map +1 -1
  203. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.js +16 -11
  204. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts +21 -10
  205. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts.map +1 -1
  206. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.js +27 -11
  207. package/dest/services/reqresp/protocols/tx.d.ts +7 -1
  208. package/dest/services/reqresp/protocols/tx.d.ts.map +1 -1
  209. package/dest/services/reqresp/protocols/tx.js +20 -0
  210. package/dest/services/reqresp/reqresp.d.ts +1 -1
  211. package/dest/services/reqresp/reqresp.d.ts.map +1 -1
  212. package/dest/services/reqresp/reqresp.js +13 -5
  213. package/dest/services/service.d.ts +39 -3
  214. package/dest/services/service.d.ts.map +1 -1
  215. package/dest/services/tx_collection/config.d.ts +22 -4
  216. package/dest/services/tx_collection/config.d.ts.map +1 -1
  217. package/dest/services/tx_collection/config.js +49 -3
  218. package/dest/services/tx_collection/fast_tx_collection.d.ts +6 -5
  219. package/dest/services/tx_collection/fast_tx_collection.d.ts.map +1 -1
  220. package/dest/services/tx_collection/fast_tx_collection.js +64 -48
  221. package/dest/services/tx_collection/file_store_tx_collection.d.ts +53 -0
  222. package/dest/services/tx_collection/file_store_tx_collection.d.ts.map +1 -0
  223. package/dest/services/tx_collection/file_store_tx_collection.js +167 -0
  224. package/dest/services/tx_collection/file_store_tx_source.d.ts +37 -0
  225. package/dest/services/tx_collection/file_store_tx_source.d.ts.map +1 -0
  226. package/dest/services/tx_collection/file_store_tx_source.js +90 -0
  227. package/dest/services/tx_collection/index.d.ts +3 -2
  228. package/dest/services/tx_collection/index.d.ts.map +1 -1
  229. package/dest/services/tx_collection/index.js +1 -0
  230. package/dest/services/tx_collection/instrumentation.d.ts +1 -1
  231. package/dest/services/tx_collection/instrumentation.d.ts.map +1 -1
  232. package/dest/services/tx_collection/instrumentation.js +2 -1
  233. package/dest/services/tx_collection/missing_txs_tracker.d.ts +32 -0
  234. package/dest/services/tx_collection/missing_txs_tracker.d.ts.map +1 -0
  235. package/dest/services/tx_collection/missing_txs_tracker.js +27 -0
  236. package/dest/services/tx_collection/proposal_tx_collector.d.ts +15 -14
  237. package/dest/services/tx_collection/proposal_tx_collector.d.ts.map +1 -1
  238. package/dest/services/tx_collection/proposal_tx_collector.js +6 -6
  239. package/dest/services/tx_collection/slow_tx_collection.d.ts +7 -3
  240. package/dest/services/tx_collection/slow_tx_collection.d.ts.map +1 -1
  241. package/dest/services/tx_collection/slow_tx_collection.js +60 -26
  242. package/dest/services/tx_collection/tx_collection.d.ts +23 -10
  243. package/dest/services/tx_collection/tx_collection.d.ts.map +1 -1
  244. package/dest/services/tx_collection/tx_collection.js +75 -3
  245. package/dest/services/tx_collection/tx_collection_sink.d.ts +18 -8
  246. package/dest/services/tx_collection/tx_collection_sink.d.ts.map +1 -1
  247. package/dest/services/tx_collection/tx_collection_sink.js +26 -29
  248. package/dest/services/tx_collection/tx_source.d.ts +8 -3
  249. package/dest/services/tx_collection/tx_source.d.ts.map +1 -1
  250. package/dest/services/tx_collection/tx_source.js +19 -2
  251. package/dest/services/tx_file_store/config.d.ts +1 -3
  252. package/dest/services/tx_file_store/config.d.ts.map +1 -1
  253. package/dest/services/tx_file_store/config.js +0 -4
  254. package/dest/services/tx_file_store/tx_file_store.d.ts +4 -3
  255. package/dest/services/tx_file_store/tx_file_store.d.ts.map +1 -1
  256. package/dest/services/tx_file_store/tx_file_store.js +9 -6
  257. package/dest/services/tx_provider.d.ts +4 -4
  258. package/dest/services/tx_provider.d.ts.map +1 -1
  259. package/dest/services/tx_provider.js +9 -8
  260. package/dest/test-helpers/make-test-p2p-clients.d.ts +7 -8
  261. package/dest/test-helpers/make-test-p2p-clients.d.ts.map +1 -1
  262. package/dest/test-helpers/make-test-p2p-clients.js +1 -2
  263. package/dest/test-helpers/mock-pubsub.d.ts +30 -4
  264. package/dest/test-helpers/mock-pubsub.d.ts.map +1 -1
  265. package/dest/test-helpers/mock-pubsub.js +105 -4
  266. package/dest/test-helpers/reqresp-nodes.d.ts +2 -3
  267. package/dest/test-helpers/reqresp-nodes.d.ts.map +1 -1
  268. package/dest/test-helpers/reqresp-nodes.js +4 -3
  269. package/dest/test-helpers/testbench-utils.d.ts +43 -38
  270. package/dest/test-helpers/testbench-utils.d.ts.map +1 -1
  271. package/dest/test-helpers/testbench-utils.js +129 -59
  272. package/dest/testbench/p2p_client_testbench_worker.d.ts +2 -2
  273. package/dest/testbench/p2p_client_testbench_worker.d.ts.map +1 -1
  274. package/dest/testbench/p2p_client_testbench_worker.js +17 -16
  275. package/dest/testbench/worker_client_manager.d.ts +3 -1
  276. package/dest/testbench/worker_client_manager.d.ts.map +1 -1
  277. package/dest/testbench/worker_client_manager.js +6 -2
  278. package/dest/util.d.ts +3 -3
  279. package/dest/util.d.ts.map +1 -1
  280. package/package.json +14 -14
  281. package/src/client/factory.ts +82 -28
  282. package/src/client/interface.ts +56 -34
  283. package/src/client/p2p_client.ts +181 -269
  284. package/src/client/test/tx_proposal_collector/proposal_tx_collector_worker.ts +21 -12
  285. package/src/config.ts +141 -44
  286. package/src/errors/tx-pool.error.ts +12 -0
  287. package/src/index.ts +1 -0
  288. package/src/mem_pools/attestation_pool/attestation_pool.ts +497 -91
  289. package/src/mem_pools/attestation_pool/attestation_pool_test_suite.ts +442 -102
  290. package/src/mem_pools/attestation_pool/index.ts +9 -2
  291. package/src/mem_pools/attestation_pool/mocks.ts +2 -1
  292. package/src/mem_pools/index.ts +4 -1
  293. package/src/mem_pools/instrumentation.ts +17 -13
  294. package/src/mem_pools/interface.ts +4 -4
  295. package/src/mem_pools/tx_pool/README.md +1 -1
  296. package/src/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.ts +3 -3
  297. package/src/mem_pools/tx_pool/priority.ts +6 -3
  298. package/src/mem_pools/tx_pool/tx_pool_test_suite.ts +3 -1
  299. package/src/mem_pools/tx_pool_v2/README.md +283 -0
  300. package/src/mem_pools/tx_pool_v2/archive/index.ts +1 -0
  301. package/src/mem_pools/tx_pool_v2/archive/tx_archive.ts +120 -0
  302. package/src/mem_pools/tx_pool_v2/deleted_pool.ts +321 -0
  303. package/src/mem_pools/tx_pool_v2/eviction/eviction_manager.ts +160 -0
  304. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.ts +121 -0
  305. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.ts +125 -0
  306. package/src/mem_pools/tx_pool_v2/eviction/index.ts +27 -0
  307. package/src/mem_pools/tx_pool_v2/eviction/interfaces.ts +219 -0
  308. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.ts +74 -0
  309. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.ts +101 -0
  310. package/src/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.ts +91 -0
  311. package/src/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.ts +99 -0
  312. package/src/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.ts +32 -0
  313. package/src/mem_pools/tx_pool_v2/index.ts +12 -0
  314. package/src/mem_pools/tx_pool_v2/instrumentation.ts +69 -0
  315. package/src/mem_pools/tx_pool_v2/interfaces.ts +245 -0
  316. package/src/mem_pools/tx_pool_v2/tx_metadata.ts +327 -0
  317. package/src/mem_pools/tx_pool_v2/tx_pool_bench_metrics.ts +77 -0
  318. package/src/mem_pools/tx_pool_v2/tx_pool_indices.ts +430 -0
  319. package/src/mem_pools/tx_pool_v2/tx_pool_v2.ts +226 -0
  320. package/src/mem_pools/tx_pool_v2/tx_pool_v2_impl.ts +1097 -0
  321. package/src/msg_validators/attestation_validator/fisherman_attestation_validator.ts +2 -2
  322. package/src/msg_validators/proposal_validator/block_proposal_validator.ts +14 -4
  323. package/src/msg_validators/proposal_validator/checkpoint_proposal_validator.ts +20 -7
  324. package/src/msg_validators/proposal_validator/proposal_validator.ts +63 -40
  325. package/src/msg_validators/tx_validator/README.md +115 -0
  326. package/src/msg_validators/tx_validator/aggregate_tx_validator.ts +5 -5
  327. package/src/msg_validators/tx_validator/allowed_public_setup.ts +22 -27
  328. package/src/msg_validators/tx_validator/allowed_setup_helpers.ts +31 -0
  329. package/src/msg_validators/tx_validator/block_header_validator.ts +15 -3
  330. package/src/msg_validators/tx_validator/double_spend_validator.ts +11 -6
  331. package/src/msg_validators/tx_validator/factory.ts +366 -77
  332. package/src/msg_validators/tx_validator/fee_payer_balance.ts +6 -2
  333. package/src/msg_validators/tx_validator/gas_validator.ts +123 -27
  334. package/src/msg_validators/tx_validator/index.ts +2 -0
  335. package/src/msg_validators/tx_validator/metadata_validator.ts +12 -4
  336. package/src/msg_validators/tx_validator/nullifier_cache.ts +30 -0
  337. package/src/msg_validators/tx_validator/phases_validator.ts +51 -26
  338. package/src/msg_validators/tx_validator/timestamp_validator.ts +23 -18
  339. package/src/services/dummy_service.ts +18 -6
  340. package/src/services/encoding.ts +9 -9
  341. package/src/services/gossipsub/README.md +641 -0
  342. package/src/services/gossipsub/index.ts +2 -0
  343. package/src/services/gossipsub/scoring.ts +29 -5
  344. package/src/services/gossipsub/topic_score_params.ts +487 -0
  345. package/src/services/libp2p/libp2p_service.ts +488 -372
  346. package/src/services/peer-manager/metrics.ts +7 -0
  347. package/src/services/peer-manager/peer_manager.ts +2 -1
  348. package/src/services/peer-manager/peer_scoring.ts +25 -0
  349. package/src/services/reqresp/batch-tx-requester/README.md +7 -7
  350. package/src/services/reqresp/batch-tx-requester/batch_tx_requester.ts +31 -59
  351. package/src/services/reqresp/batch-tx-requester/interface.ts +1 -5
  352. package/src/services/reqresp/batch-tx-requester/missing_txs.ts +23 -71
  353. package/src/services/reqresp/batch-tx-requester/peer_collection.ts +63 -24
  354. package/src/services/reqresp/batch-tx-requester/tx_validator.ts +2 -2
  355. package/src/services/reqresp/interface.ts +26 -1
  356. package/src/services/reqresp/protocols/block_txs/block_txs_handler.ts +23 -14
  357. package/src/services/reqresp/protocols/block_txs/block_txs_reqresp.ts +38 -15
  358. package/src/services/reqresp/protocols/tx.ts +22 -0
  359. package/src/services/reqresp/reqresp.ts +16 -4
  360. package/src/services/service.ts +51 -2
  361. package/src/services/tx_collection/config.ts +74 -6
  362. package/src/services/tx_collection/fast_tx_collection.ts +74 -51
  363. package/src/services/tx_collection/file_store_tx_collection.ts +202 -0
  364. package/src/services/tx_collection/file_store_tx_source.ts +117 -0
  365. package/src/services/tx_collection/index.ts +2 -1
  366. package/src/services/tx_collection/instrumentation.ts +7 -1
  367. package/src/services/tx_collection/missing_txs_tracker.ts +52 -0
  368. package/src/services/tx_collection/proposal_tx_collector.ts +20 -21
  369. package/src/services/tx_collection/slow_tx_collection.ts +66 -33
  370. package/src/services/tx_collection/tx_collection.ts +113 -16
  371. package/src/services/tx_collection/tx_collection_sink.ts +30 -34
  372. package/src/services/tx_collection/tx_source.ts +22 -3
  373. package/src/services/tx_file_store/config.ts +0 -6
  374. package/src/services/tx_file_store/tx_file_store.ts +10 -8
  375. package/src/services/tx_provider.ts +10 -9
  376. package/src/test-helpers/make-test-p2p-clients.ts +4 -6
  377. package/src/test-helpers/mock-pubsub.ts +146 -9
  378. package/src/test-helpers/reqresp-nodes.ts +5 -7
  379. package/src/test-helpers/testbench-utils.ts +128 -71
  380. package/src/testbench/p2p_client_testbench_worker.ts +26 -22
  381. package/src/testbench/worker_client_manager.ts +13 -5
  382. package/src/util.ts +8 -2
  383. package/dest/mem_pools/attestation_pool/kv_attestation_pool.d.ts +0 -40
  384. package/dest/mem_pools/attestation_pool/kv_attestation_pool.d.ts.map +0 -1
  385. package/dest/mem_pools/attestation_pool/kv_attestation_pool.js +0 -218
  386. package/dest/mem_pools/attestation_pool/memory_attestation_pool.d.ts +0 -31
  387. package/dest/mem_pools/attestation_pool/memory_attestation_pool.d.ts.map +0 -1
  388. package/dest/mem_pools/attestation_pool/memory_attestation_pool.js +0 -180
  389. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.d.ts +0 -23
  390. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.d.ts.map +0 -1
  391. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.js +0 -212
  392. package/src/mem_pools/attestation_pool/kv_attestation_pool.ts +0 -320
  393. package/src/mem_pools/attestation_pool/memory_attestation_pool.ts +0 -264
  394. package/src/msg_validators/proposal_validator/proposal_validator_test_suite.ts +0 -230
@@ -0,0 +1,337 @@
1
+ import { insertIntoSortedArray, removeFromSortedArray } from '@aztec/foundation/array';
2
+ import { comparePriority } from './tx_metadata.js';
3
+ /**
4
+ * Manages in-memory indices for the transaction pool.
5
+ *
6
+ * Tracks transaction metadata and maintains several indices for efficient querying:
7
+ * - Metadata by txHash (primary store)
8
+ * - Nullifier to txHash mapping (pending txs only)
9
+ * - Fee payer to txHashes mapping (pending txs only)
10
+ * - Priority-ordered pending txs
11
+ * - Protected transaction tracking
12
+ *
13
+ * Key invariant: Only pending txs appear in nullifier/feePayer/priority indices.
14
+ */ export class TxPoolIndices {
15
+ /** Primary metadata store: txHash -> TxMetaData */ #metadata = new Map();
16
+ /** Nullifier to txHash index (pending txs only) */ #nullifierToTxHash = new Map();
17
+ /** Fee payer to txHashes index (pending txs only) */ #feePayerToTxHashes = new Map();
18
+ /** Pending transactions sorted ascending by priority fee, ties broken by txHash */ #pendingByPriority = [];
19
+ /** Protected transactions: txHash -> slotNumber */ #protectedTransactions = new Map();
20
+ // ============================================================================
21
+ // STATE QUERIES
22
+ // ============================================================================
23
+ /**
24
+ * Derives the transaction state from its metadata and protection status.
25
+ * A transaction is:
26
+ * - 'mined' if it has a minedL2BlockId
27
+ * - 'protected' if it's in the protectedTransactions map (but not mined)
28
+ * - 'pending' otherwise
29
+ */ getTxState(meta) {
30
+ if (meta.minedL2BlockId !== undefined) {
31
+ return 'mined';
32
+ } else if (this.#protectedTransactions.has(meta.txHash)) {
33
+ return 'protected';
34
+ } else {
35
+ return 'pending';
36
+ }
37
+ }
38
+ getMetadata(txHash) {
39
+ return this.#metadata.get(txHash);
40
+ }
41
+ has(txHash) {
42
+ return this.#metadata.has(txHash);
43
+ }
44
+ isEmpty() {
45
+ return this.#metadata.size === 0;
46
+ }
47
+ getTxCount() {
48
+ return this.#metadata.size;
49
+ }
50
+ // ============================================================================
51
+ // ITERATION
52
+ // ============================================================================
53
+ /**
54
+ * Iterates pending transaction hashes in priority order.
55
+ * @param order - 'desc' for highest priority first, 'asc' for lowest priority first
56
+ */ *iteratePendingByPriority(order, filter) {
57
+ const arr = this.#pendingByPriority;
58
+ const start = order === 'asc' ? 0 : arr.length - 1;
59
+ const step = order === 'asc' ? 1 : -1;
60
+ const inBounds = order === 'asc' ? (i)=>i < arr.length : (i)=>i >= 0;
61
+ for(let i = start; inBounds(i); i += step){
62
+ if (filter === undefined || filter(arr[i].txHash)) {
63
+ yield arr[i].txHash;
64
+ }
65
+ }
66
+ }
67
+ /**
68
+ * Iterates pending transaction hashes in priority order, skipping txs received after maxReceivedAt.
69
+ * @param order - 'desc' for highest priority first, 'asc' for lowest priority first
70
+ * @param maxReceivedAt - Only yield txs with receivedAt <= this value
71
+ */ *iterateEligiblePendingByPriority(order, maxReceivedAt) {
72
+ const filter = (hash)=>{
73
+ const meta = this.#metadata.get(hash);
74
+ return meta !== undefined && meta.receivedAt <= maxReceivedAt;
75
+ };
76
+ yield* this.iteratePendingByPriority(order, filter);
77
+ }
78
+ /** Iterates all metadata entries */ *iterateMetadata() {
79
+ yield* this.#metadata;
80
+ }
81
+ // ============================================================================
82
+ // INDEX MODIFICATIONS
83
+ // ============================================================================
84
+ /** Adds a new pending transaction to all indices */ addPending(meta) {
85
+ this.#metadata.set(meta.txHash, meta);
86
+ this.#addToPendingIndices(meta);
87
+ }
88
+ /** Adds a new protected transaction (not added to pending indices) */ addProtected(meta, slot) {
89
+ this.#metadata.set(meta.txHash, meta);
90
+ this.#protectedTransactions.set(meta.txHash, slot);
91
+ }
92
+ /** Adds a new mined transaction (not added to pending indices) */ addMined(meta) {
93
+ this.#metadata.set(meta.txHash, meta);
94
+ }
95
+ /** Marks an existing transaction as mined and removes from pending indices */ markAsMined(meta, blockId) {
96
+ meta.minedL2BlockId = blockId;
97
+ // Safe to call unconditionally - removeFromPendingIndices is idempotent
98
+ this.#removeFromPendingIndices(meta);
99
+ }
100
+ /** Clears the mined status from a transaction */ markAsUnmined(meta) {
101
+ meta.minedL2BlockId = undefined;
102
+ }
103
+ /**
104
+ * Updates protection status for an existing transaction.
105
+ * Removes from pending indices if transitioning from pending to protected.
106
+ */ updateProtection(txHash, slotNumber) {
107
+ const currentSlot = this.#protectedTransactions.get(txHash);
108
+ // Only update if not already protected at an equal or later slot
109
+ if (currentSlot !== undefined && currentSlot >= slotNumber) {
110
+ return;
111
+ }
112
+ // Remove from pending indices if transitioning from pending to protected
113
+ if (currentSlot === undefined) {
114
+ const meta = this.#metadata.get(txHash);
115
+ if (meta) {
116
+ this.#removeFromPendingIndices(meta);
117
+ }
118
+ }
119
+ this.#protectedTransactions.set(txHash, slotNumber);
120
+ }
121
+ /** Sets protection for a txHash that may not have metadata yet */ setProtection(txHash, slotNumber) {
122
+ this.#protectedTransactions.set(txHash, slotNumber);
123
+ }
124
+ /** Gets the protection slot for a txHash, if protected */ getProtectionSlot(txHash) {
125
+ return this.#protectedTransactions.get(txHash);
126
+ }
127
+ /** Removes protection from tx hashes */ clearProtection(txHashes) {
128
+ for (const txHash of txHashes){
129
+ this.#protectedTransactions.delete(txHash);
130
+ }
131
+ }
132
+ /** Removes a transaction from all indices */ remove(txHash) {
133
+ const meta = this.#metadata.get(txHash);
134
+ if (!meta) {
135
+ return;
136
+ }
137
+ this.#metadata.delete(txHash);
138
+ this.#protectedTransactions.delete(txHash);
139
+ this.#removeFromPendingIndices(meta);
140
+ }
141
+ /** Removes a transaction from pending indices only (not metadata) */ removeFromPendingIndices(meta) {
142
+ this.#removeFromPendingIndices(meta);
143
+ }
144
+ /** Adds a transaction to pending indices (used during conflict resolution) */ addToPendingIndices(meta) {
145
+ this.#addToPendingIndices(meta);
146
+ }
147
+ // ============================================================================
148
+ // QUERIES FOR EVICTION RULES
149
+ // ============================================================================
150
+ /** Gets all pending transactions for a given fee payer */ getFeePayerPendingTxs(feePayer) {
151
+ const txHashes = this.#feePayerToTxHashes.get(feePayer);
152
+ if (!txHashes) {
153
+ return [];
154
+ }
155
+ const result = [];
156
+ for (const txHash of txHashes){
157
+ const meta = this.#metadata.get(txHash);
158
+ if (meta && this.getTxState(meta) === 'pending') {
159
+ result.push(meta);
160
+ }
161
+ }
162
+ return result;
163
+ }
164
+ /** Gets the count of pending transactions */ getPendingTxCount() {
165
+ return this.#pendingByPriority.length;
166
+ }
167
+ /** Gets the lowest priority pending transaction hashes (up to limit) */ getLowestPriorityPending(limit) {
168
+ if (limit <= 0) {
169
+ return [];
170
+ }
171
+ const result = [];
172
+ for (const hash of this.iteratePendingByPriority('asc')){
173
+ result.push(hash);
174
+ if (result.length >= limit) {
175
+ break;
176
+ }
177
+ }
178
+ return result;
179
+ }
180
+ /** Gets the lowest priority pending transaction */ getLowestPriorityPendingTx() {
181
+ for (const txHash of this.iteratePendingByPriority('asc')){
182
+ const meta = this.#metadata.get(txHash);
183
+ if (meta) {
184
+ return meta;
185
+ }
186
+ }
187
+ return undefined;
188
+ }
189
+ /** Gets all pending transactions */ getPendingTxs() {
190
+ const result = [];
191
+ for (const entry of this.#pendingByPriority){
192
+ const meta = this.#metadata.get(entry.txHash);
193
+ if (meta) {
194
+ result.push(meta);
195
+ }
196
+ }
197
+ return result;
198
+ }
199
+ /** Gets all fee payers with pending transactions */ getPendingFeePayers() {
200
+ return Array.from(this.#feePayerToTxHashes.keys());
201
+ }
202
+ /** Gets the txHash that uses a given nullifier (pending txs only) */ getTxHashByNullifier(nullifier) {
203
+ return this.#nullifierToTxHash.get(nullifier);
204
+ }
205
+ /** Gets txHashes for a fee payer */ getTxHashesByFeePayer(feePayer) {
206
+ return this.#feePayerToTxHashes.get(feePayer);
207
+ }
208
+ // ============================================================================
209
+ // FIND/FILTER OPERATIONS
210
+ // ============================================================================
211
+ /** Finds all transactions mined in blocks after the given block number */ findTxsMinedAfter(blockNumber) {
212
+ const result = [];
213
+ for (const meta of this.#metadata.values()){
214
+ if (meta.minedL2BlockId !== undefined && meta.minedL2BlockId.number > blockNumber) {
215
+ result.push(meta);
216
+ }
217
+ }
218
+ return result;
219
+ }
220
+ /** Finds tx hashes mined at or before the given block number */ findTxsMinedAtOrBefore(blockNumber) {
221
+ const result = [];
222
+ for (const [txHash, meta] of this.#metadata){
223
+ if (meta.minedL2BlockId !== undefined && meta.minedL2BlockId.number <= blockNumber) {
224
+ result.push(txHash);
225
+ }
226
+ }
227
+ return result;
228
+ }
229
+ /** Finds protected tx hashes from slots earlier than the given slot number */ findExpiredProtectedTxs(slotNumber) {
230
+ const result = [];
231
+ for (const [txHash, protectedSlot] of this.#protectedTransactions){
232
+ if (protectedSlot < slotNumber) {
233
+ result.push(txHash);
234
+ }
235
+ }
236
+ return result;
237
+ }
238
+ /** Filters out transactions that are currently protected */ filterUnprotected(txs) {
239
+ return txs.filter((meta)=>!this.#protectedTransactions.has(meta.txHash));
240
+ }
241
+ /** Filters to transactions that have metadata and are not mined */ filterRestorable(txHashes) {
242
+ const result = [];
243
+ for (const txHash of txHashes){
244
+ const meta = this.#metadata.get(txHash);
245
+ if (meta && meta.minedL2BlockId === undefined) {
246
+ result.push(meta);
247
+ }
248
+ }
249
+ return result;
250
+ }
251
+ // ============================================================================
252
+ // METRICS
253
+ // ============================================================================
254
+ /** Counts transactions by state and estimates total metadata memory usage */ countTxs() {
255
+ let pending = 0;
256
+ let protected_ = 0;
257
+ let mined = 0;
258
+ let totalMetadataBytes = 0;
259
+ for (const meta of this.#metadata.values()){
260
+ totalMetadataBytes += meta.estimatedSizeBytes;
261
+ const state = this.getTxState(meta);
262
+ if (state === 'pending') {
263
+ pending++;
264
+ } else if (state === 'protected') {
265
+ protected_++;
266
+ } else if (state === 'mined') {
267
+ mined++;
268
+ }
269
+ }
270
+ return {
271
+ pending,
272
+ protected: protected_,
273
+ mined,
274
+ totalMetadataBytes
275
+ };
276
+ }
277
+ /** Returns the estimated total memory consumed by all metadata objects */ getTotalMetadataBytes() {
278
+ let total = 0;
279
+ for (const meta of this.#metadata.values()){
280
+ total += meta.estimatedSizeBytes;
281
+ }
282
+ return total;
283
+ }
284
+ /** Gets all mined transactions with their block IDs */ getMinedTxs() {
285
+ const result = [];
286
+ for (const [txHash, meta] of this.#metadata){
287
+ if (meta.minedL2BlockId !== undefined) {
288
+ result.push([
289
+ txHash,
290
+ meta.minedL2BlockId
291
+ ]);
292
+ }
293
+ }
294
+ return result;
295
+ }
296
+ // ============================================================================
297
+ // PRIVATE HELPERS
298
+ // ============================================================================
299
+ #addToPendingIndices(meta) {
300
+ // Add to nullifier index
301
+ for (const nullifier of meta.nullifiers){
302
+ this.#nullifierToTxHash.set(nullifier, meta.txHash);
303
+ }
304
+ // Add to fee payer index
305
+ let feePayerSet = this.#feePayerToTxHashes.get(meta.feePayer);
306
+ if (!feePayerSet) {
307
+ feePayerSet = new Set();
308
+ this.#feePayerToTxHashes.set(meta.feePayer, feePayerSet);
309
+ }
310
+ feePayerSet.add(meta.txHash);
311
+ insertIntoSortedArray(this.#pendingByPriority, {
312
+ txHash: meta.txHash,
313
+ priorityFee: meta.priorityFee,
314
+ txHashBigInt: meta.txHashBigInt
315
+ }, comparePriority, false);
316
+ }
317
+ #removeFromPendingIndices(meta) {
318
+ // Remove from nullifier index
319
+ for (const nullifier of meta.nullifiers){
320
+ this.#nullifierToTxHash.delete(nullifier);
321
+ }
322
+ // Remove from fee payer index
323
+ const feePayerSet = this.#feePayerToTxHashes.get(meta.feePayer);
324
+ if (feePayerSet) {
325
+ feePayerSet.delete(meta.txHash);
326
+ if (feePayerSet.size === 0) {
327
+ this.#feePayerToTxHashes.delete(meta.feePayer);
328
+ }
329
+ }
330
+ // Remove from priority array
331
+ removeFromSortedArray(this.#pendingByPriority, {
332
+ txHash: meta.txHash,
333
+ priorityFee: meta.priorityFee,
334
+ txHashBigInt: meta.txHashBigInt
335
+ }, comparePriority);
336
+ }
337
+ }
@@ -0,0 +1,60 @@
1
+ import { SlotNumber } from '@aztec/foundation/branded-types';
2
+ import { type Logger } from '@aztec/foundation/log';
3
+ import { DateProvider } from '@aztec/foundation/timer';
4
+ import type { TypedEventEmitter } from '@aztec/foundation/types';
5
+ import type { AztecAsyncKVStore } from '@aztec/kv-store';
6
+ import type { L2Block, L2BlockId } from '@aztec/stdlib/block';
7
+ import { BlockHeader, Tx, TxHash } from '@aztec/stdlib/tx';
8
+ import { type TelemetryClient } from '@aztec/telemetry-client';
9
+ import type { AddTxsResult, TxPoolV2, TxPoolV2Config, TxPoolV2Dependencies, TxPoolV2Events } from './interfaces.js';
10
+ import type { TxState } from './tx_metadata.js';
11
+ declare const AztecKVTxPoolV2_base: new () => TypedEventEmitter<TxPoolV2Events>;
12
+ /**
13
+ * Implementation of TxPoolV2 with explicit state management.
14
+ *
15
+ * This class is a thin wrapper that manages the serial queue and delegates
16
+ * all operations to TxPoolV2Impl.
17
+ */
18
+ export declare class AztecKVTxPoolV2 extends AztecKVTxPoolV2_base implements TxPoolV2 {
19
+ #private;
20
+ constructor(store: AztecAsyncKVStore, archiveStore: AztecAsyncKVStore, deps: TxPoolV2Dependencies, telemetry?: TelemetryClient, config?: Partial<TxPoolV2Config>, dateProvider?: DateProvider, log?: Logger);
21
+ addPendingTxs(txs: Tx[], opts?: {
22
+ source?: string;
23
+ feeComparisonOnly?: boolean;
24
+ }): Promise<AddTxsResult>;
25
+ canAddPendingTx(tx: Tx): Promise<'accepted' | 'ignored'>;
26
+ addProtectedTxs(txs: Tx[], block: BlockHeader, opts?: {
27
+ source?: string;
28
+ }): Promise<void>;
29
+ protectTxs(txHashes: TxHash[], block: BlockHeader): Promise<TxHash[]>;
30
+ addMinedTxs(txs: Tx[], block: BlockHeader, opts?: {
31
+ source?: string;
32
+ }): Promise<void>;
33
+ handleMinedBlock(block: L2Block): Promise<void>;
34
+ prepareForSlot(slotNumber: SlotNumber): Promise<void>;
35
+ handlePrunedBlocks(latestBlock: L2BlockId, options?: {
36
+ deleteAllTxs?: boolean;
37
+ }): Promise<void>;
38
+ handleFailedExecution(txHashes: TxHash[]): Promise<void>;
39
+ handleFinalizedBlock(block: BlockHeader): Promise<void>;
40
+ getTxByHash(txHash: TxHash): Promise<Tx | undefined>;
41
+ getTxsByHash(txHashes: TxHash[]): Promise<(Tx | undefined)[]>;
42
+ hasTxs(txHashes: TxHash[]): Promise<boolean[]>;
43
+ getTxStatus(txHash: TxHash): Promise<TxState | 'deleted' | undefined>;
44
+ getPendingTxHashes(): Promise<TxHash[]>;
45
+ getEligiblePendingTxHashes(): Promise<TxHash[]>;
46
+ getPendingTxCount(): Promise<number>;
47
+ getMinedTxHashes(): Promise<[TxHash, L2BlockId][]>;
48
+ getMinedTxCount(): Promise<number>;
49
+ isEmpty(): Promise<boolean>;
50
+ getArchivedTxByHash(txHash: TxHash): Promise<Tx | undefined>;
51
+ getLowestPriorityPending(limit: number): Promise<TxHash[]>;
52
+ updateConfig(config: Partial<TxPoolV2Config>): Promise<void>;
53
+ /**
54
+ * Starts the pool and initializes state from persistence.
55
+ */
56
+ start(): Promise<void>;
57
+ stop(): Promise<void>;
58
+ }
59
+ export {};
60
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHhfcG9vbF92Mi5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL21lbV9wb29scy90eF9wb29sX3YyL3R4X3Bvb2xfdjIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLFVBQVUsRUFBRSxNQUFNLGlDQUFpQyxDQUFDO0FBQzdELE9BQU8sRUFBRSxLQUFLLE1BQU0sRUFBZ0IsTUFBTSx1QkFBdUIsQ0FBQztBQUVsRSxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0seUJBQXlCLENBQUM7QUFDdkQsT0FBTyxLQUFLLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUNqRSxPQUFPLEtBQUssRUFBRSxpQkFBaUIsRUFBRSxNQUFNLGlCQUFpQixDQUFDO0FBQ3pELE9BQU8sS0FBSyxFQUFFLE9BQU8sRUFBRSxTQUFTLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUM5RCxPQUFPLEVBQUUsV0FBVyxFQUFFLEVBQUUsRUFBRSxNQUFNLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUMzRCxPQUFPLEVBQUUsS0FBSyxlQUFlLEVBQXNCLE1BQU0seUJBQXlCLENBQUM7QUFLbkYsT0FBTyxLQUFLLEVBQUUsWUFBWSxFQUFFLFFBQVEsRUFBRSxjQUFjLEVBQUUsb0JBQW9CLEVBQUUsY0FBYyxFQUFFLE1BQU0saUJBQWlCLENBQUM7QUFDcEgsT0FBTyxLQUFLLEVBQUUsT0FBTyxFQUFFLE1BQU0sa0JBQWtCLENBQUM7O0FBR2hEOzs7OztHQUtHO0FBQ0gscUJBQWEsZUFBZ0IsU0FBUSxvQkFBOEQsWUFBVyxRQUFROztJQVNwSCxZQUNFLEtBQUssRUFBRSxpQkFBaUIsRUFDeEIsWUFBWSxFQUFFLGlCQUFpQixFQUMvQixJQUFJLEVBQUUsb0JBQW9CLEVBQzFCLFNBQVMsR0FBRSxlQUFzQyxFQUNqRCxNQUFNLEdBQUUsT0FBTyxDQUFDLGNBQWMsQ0FBTSxFQUNwQyxZQUFZLEdBQUUsWUFBaUMsRUFDL0MsR0FB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
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tx_pool_v2.d.ts","sourceRoot":"","sources":["../../../src/mem_pools/tx_pool_v2/tx_pool_v2.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,uBAAuB,CAAC;AAElE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,KAAK,eAAe,EAAsB,MAAM,yBAAyB,CAAC;AAKnF,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACpH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;;AAGhD;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,oBAA8D,YAAW,QAAQ;;IASpH,YACE,KAAK,EAAE,iBAAiB,EACxB,YAAY,EAAE,iBAAiB,EAC/B,IAAI,EAAE,oBAAoB,EAC1B,SAAS,GAAE,eAAsC,EACjD,MAAM,GAAE,OAAO,CAAC,cAAc,CAAM,EACpC,YAAY,GAAE,YAAiC,EAC/C,GAAG,SAAiC,EA4BrC;IAQD,aAAa,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,iBAAiB,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAE3G;IAED,eAAe,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAEvD;IAED,eAAe,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5F;IAED,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAEpE;IAED,WAAW,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAExF;IAID,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9C;IAED,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpD;IAED,kBAAkB,CAAC,WAAW,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9F;IAED,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvD;IAED,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtD;IAID,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,EAAE,GAAG,SAAS,CAAC,CAEnD;IAED,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,EAAE,CAAC,CAE5D;IAED,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAE7C;IAED,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC,CAEpE;IAED,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAEtC;IAED,0BAA0B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAE9C;IAED,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAEnC;IAED,gBAAgB,IAAI,OAAO,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC,CAEjD;IAED,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAEjC;IAED,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAE1B;IAED,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,EAAE,GAAG,SAAS,CAAC,CAE3D;IAED,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAEzD;IAID,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAK3D;IAID;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAoC3B;IAEK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAK1B;CACF"}
@@ -0,0 +1,164 @@
1
+ import { createLogger } from '@aztec/foundation/log';
2
+ import { SerialQueue } from '@aztec/foundation/queue';
3
+ import { DateProvider } from '@aztec/foundation/timer';
4
+ import { TxHash } from '@aztec/stdlib/tx';
5
+ import { getTelemetryClient } from '@aztec/telemetry-client';
6
+ import EventEmitter from 'node:events';
7
+ import { PoolInstrumentation, PoolName } from '../instrumentation.js';
8
+ import { TxPoolV2Impl } from './tx_pool_v2_impl.js';
9
+ /**
10
+ * Implementation of TxPoolV2 with explicit state management.
11
+ *
12
+ * This class is a thin wrapper that manages the serial queue and delegates
13
+ * all operations to TxPoolV2Impl.
14
+ */ export class AztecKVTxPoolV2 extends EventEmitter {
15
+ #queue;
16
+ #impl;
17
+ #metrics;
18
+ #store;
19
+ #telemetry;
20
+ #log;
21
+ #started = false;
22
+ constructor(store, archiveStore, deps, telemetry = getTelemetryClient(), config = {}, dateProvider = new DateProvider(), log = createLogger('p2p:tx_pool_v2')){
23
+ super();
24
+ this.#store = store;
25
+ this.#telemetry = telemetry;
26
+ this.#log = log;
27
+ this.#queue = new SerialQueue();
28
+ // Create callbacks that the impl uses to notify us about events and metrics
29
+ const callbacks = {
30
+ onTxsAdded: (txs, opts)=>{
31
+ this.#metrics?.transactionsAdded(txs);
32
+ this.emit('txs-added', {
33
+ txs,
34
+ ...opts
35
+ });
36
+ },
37
+ onTxsRemoved: (txHashes)=>{
38
+ this.#metrics?.transactionsRemoved(txHashes);
39
+ // Convert to TxHash objects for the event
40
+ const hashes = txHashes.map((h)=>typeof h === 'string' ? TxHash.fromString(h) : TxHash.fromBigInt(h));
41
+ this.emit('txs-removed', {
42
+ txHashes: hashes
43
+ });
44
+ },
45
+ onTxsMined: (txHashes)=>{
46
+ this.#metrics?.transactionsRemoved(txHashes);
47
+ }
48
+ };
49
+ // Create the implementation
50
+ this.#impl = new TxPoolV2Impl(store, archiveStore, deps, callbacks, telemetry, config, dateProvider, log);
51
+ }
52
+ // ============================================================================
53
+ // PUBLIC API - All methods queue to the implementation
54
+ // ============================================================================
55
+ // === Core Operations ===
56
+ addPendingTxs(txs, opts = {}) {
57
+ return this.#queue.put(()=>this.#impl.addPendingTxs(txs, opts));
58
+ }
59
+ canAddPendingTx(tx) {
60
+ return this.#queue.put(()=>this.#impl.canAddPendingTx(tx));
61
+ }
62
+ addProtectedTxs(txs, block, opts = {}) {
63
+ return this.#queue.put(()=>this.#impl.addProtectedTxs(txs, block, opts));
64
+ }
65
+ protectTxs(txHashes, block) {
66
+ return this.#queue.put(()=>this.#impl.protectTxs(txHashes, block));
67
+ }
68
+ addMinedTxs(txs, block, opts = {}) {
69
+ return this.#queue.put(()=>this.#impl.addMinedTxs(txs, block, opts));
70
+ }
71
+ // === State Transition Handlers ===
72
+ handleMinedBlock(block) {
73
+ return this.#queue.put(()=>this.#impl.handleMinedBlock(block));
74
+ }
75
+ prepareForSlot(slotNumber) {
76
+ return this.#queue.put(()=>this.#impl.prepareForSlot(slotNumber));
77
+ }
78
+ handlePrunedBlocks(latestBlock, options) {
79
+ return this.#queue.put(()=>this.#impl.handlePrunedBlocks(latestBlock, options));
80
+ }
81
+ handleFailedExecution(txHashes) {
82
+ return this.#queue.put(()=>this.#impl.handleFailedExecution(txHashes));
83
+ }
84
+ handleFinalizedBlock(block) {
85
+ return this.#queue.put(()=>this.#impl.handleFinalizedBlock(block));
86
+ }
87
+ // === Queries ===
88
+ getTxByHash(txHash) {
89
+ return this.#queue.put(()=>this.#impl.getTxByHash(txHash));
90
+ }
91
+ getTxsByHash(txHashes) {
92
+ return this.#queue.put(()=>this.#impl.getTxsByHash(txHashes));
93
+ }
94
+ hasTxs(txHashes) {
95
+ return this.#queue.put(()=>this.#impl.hasTxs(txHashes));
96
+ }
97
+ getTxStatus(txHash) {
98
+ return this.#queue.put(()=>Promise.resolve(this.#impl.getTxStatus(txHash)));
99
+ }
100
+ getPendingTxHashes() {
101
+ return this.#queue.put(()=>Promise.resolve(this.#impl.getPendingTxHashes()));
102
+ }
103
+ getEligiblePendingTxHashes() {
104
+ return this.#queue.put(()=>Promise.resolve(this.#impl.getEligiblePendingTxHashes()));
105
+ }
106
+ getPendingTxCount() {
107
+ return this.#queue.put(()=>Promise.resolve(this.#impl.getPendingTxCount()));
108
+ }
109
+ getMinedTxHashes() {
110
+ return this.#queue.put(()=>Promise.resolve(this.#impl.getMinedTxHashes()));
111
+ }
112
+ getMinedTxCount() {
113
+ return this.#queue.put(()=>Promise.resolve(this.#impl.getMinedTxCount()));
114
+ }
115
+ isEmpty() {
116
+ return this.#queue.put(()=>Promise.resolve(this.#impl.isEmpty()));
117
+ }
118
+ getArchivedTxByHash(txHash) {
119
+ return this.#queue.put(()=>this.#impl.getArchivedTxByHash(txHash));
120
+ }
121
+ getLowestPriorityPending(limit) {
122
+ return this.#queue.put(()=>Promise.resolve(this.#impl.getLowestPriorityPending(limit)));
123
+ }
124
+ // === Configuration ===
125
+ updateConfig(config) {
126
+ return this.#queue.put(()=>{
127
+ this.#impl.updateConfig(config);
128
+ return Promise.resolve();
129
+ });
130
+ }
131
+ // === Lifecycle ===
132
+ /**
133
+ * Starts the pool and initializes state from persistence.
134
+ */ async start() {
135
+ if (this.#started) {
136
+ return;
137
+ }
138
+ this.#log.info('Starting transaction pool...');
139
+ // Start the serial queue
140
+ this.#queue.start();
141
+ this.#started = true;
142
+ // Setup metrics - created after queue is started so callbacks can safely queue
143
+ this.#metrics = new PoolInstrumentation(this.#telemetry, PoolName.TX_POOL, ()=>this.#queue.put(()=>{
144
+ const counts = this.#impl.countTxs();
145
+ return Promise.resolve({
146
+ itemCount: {
147
+ pending: counts.pending,
148
+ protected: counts.protected,
149
+ mined: counts.mined,
150
+ softDeleted: counts.softDeleted
151
+ }
152
+ });
153
+ }), ()=>this.#store.estimateSize());
154
+ // Hydrate state from persistence (runs in queue)
155
+ await this.#queue.put(()=>this.#impl.hydrateFromDatabase());
156
+ this.#log.info(`Transaction pool started with ${this.#impl.getTxCount()} transactions (${this.#impl.getPendingTxCount()} pending, ${this.#impl.getMinedTxCount()} mined)`);
157
+ }
158
+ async stop() {
159
+ if (this.#started) {
160
+ await this.#queue.end();
161
+ this.#started = false;
162
+ }
163
+ }
164
+ }
@@ -0,0 +1,78 @@
1
+ import { SlotNumber } from '@aztec/foundation/branded-types';
2
+ import type { Logger } from '@aztec/foundation/log';
3
+ import type { DateProvider } from '@aztec/foundation/timer';
4
+ import type { AztecAsyncKVStore } from '@aztec/kv-store';
5
+ import type { L2Block, L2BlockId } from '@aztec/stdlib/block';
6
+ import { BlockHeader, Tx, TxHash } from '@aztec/stdlib/tx';
7
+ import type { TelemetryClient } from '@aztec/telemetry-client';
8
+ import { type AddTxsResult, type PoolReadAccess, type TxPoolV2Config, type TxPoolV2Dependencies } from './interfaces.js';
9
+ import { type TxState } from './tx_metadata.js';
10
+ /**
11
+ * Callbacks for the implementation to notify the outer class about events and metrics.
12
+ */
13
+ export interface TxPoolV2Callbacks {
14
+ onTxsAdded: (txs: Tx[], opts: {
15
+ source?: string;
16
+ }) => void;
17
+ onTxsRemoved: (txHashes: string[] | bigint[]) => void;
18
+ onTxsMined: (txHashes: string[]) => void;
19
+ }
20
+ /**
21
+ * Implementation of TxPoolV2 logic.
22
+ *
23
+ * This class contains all the actual transaction pool logic.
24
+ */
25
+ export declare class TxPoolV2Impl {
26
+ #private;
27
+ constructor(store: AztecAsyncKVStore, archiveStore: AztecAsyncKVStore, deps: TxPoolV2Dependencies, callbacks: TxPoolV2Callbacks, telemetry: TelemetryClient, config: Partial<TxPoolV2Config> | undefined, dateProvider: DateProvider, log: Logger);
28
+ /**
29
+ * Hydrates the in-memory state from the database on startup.
30
+ * Pipeline: Load → Check Mined Status → Partition → Validate Non-Mined → Rebuild Pending Pool → Delete Invalid
31
+ *
32
+ * Note: Protected status is lost on restart. All non-mined txs are rebuilt as pending
33
+ * by running pre-add rules to resolve nullifier conflicts, balance checks, and pool size limits.
34
+ */
35
+ hydrateFromDatabase(): Promise<void>;
36
+ addPendingTxs(txs: Tx[], opts: {
37
+ source?: string;
38
+ feeComparisonOnly?: boolean;
39
+ }): Promise<AddTxsResult>;
40
+ canAddPendingTx(tx: Tx): Promise<'accepted' | 'ignored'>;
41
+ addProtectedTxs(txs: Tx[], block: BlockHeader, opts: {
42
+ source?: string;
43
+ }): Promise<void>;
44
+ protectTxs(txHashes: TxHash[], block: BlockHeader): Promise<TxHash[]>;
45
+ addMinedTxs(txs: Tx[], block: BlockHeader, opts: {
46
+ source?: string;
47
+ }): Promise<void>;
48
+ handleMinedBlock(block: L2Block): Promise<void>;
49
+ prepareForSlot(slotNumber: SlotNumber): Promise<void>;
50
+ handlePrunedBlocks(latestBlock: L2BlockId, options?: {
51
+ deleteAllTxs?: boolean;
52
+ }): Promise<void>;
53
+ handleFailedExecution(txHashes: TxHash[]): Promise<void>;
54
+ handleFinalizedBlock(block: BlockHeader): Promise<void>;
55
+ getTxByHash(txHash: TxHash): Promise<Tx | undefined>;
56
+ getTxsByHash(txHashes: TxHash[]): Promise<(Tx | undefined)[]>;
57
+ hasTxs(txHashes: TxHash[]): boolean[];
58
+ getTxStatus(txHash: TxHash): TxState | undefined;
59
+ getPendingTxHashes(): TxHash[];
60
+ getEligiblePendingTxHashes(): TxHash[];
61
+ getPendingTxCount(): number;
62
+ getMinedTxHashes(): [TxHash, L2BlockId][];
63
+ getMinedTxCount(): number;
64
+ isEmpty(): boolean;
65
+ getTxCount(): number;
66
+ getArchivedTxByHash(txHash: TxHash): Promise<Tx | undefined>;
67
+ getLowestPriorityPending(limit: number): TxHash[];
68
+ updateConfig(config: Partial<TxPoolV2Config>): void;
69
+ getPoolReadAccess(): PoolReadAccess;
70
+ countTxs(): {
71
+ pending: number;
72
+ protected: number;
73
+ mined: number;
74
+ softDeleted: number;
75
+ totalMetadataBytes: number;
76
+ };
77
+ }
78
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHhfcG9vbF92Ml9pbXBsLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvbWVtX3Bvb2xzL3R4X3Bvb2xfdjIvdHhfcG9vbF92Ml9pbXBsLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBZSxVQUFVLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUMxRSxPQUFPLEtBQUssRUFBRSxNQUFNLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUNwRCxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUM1RCxPQUFPLEtBQUssRUFBRSxpQkFBaUIsRUFBaUIsTUFBTSxpQkFBaUIsQ0FBQztBQUl4RSxPQUFPLEtBQUssRUFBRSxPQUFPLEVBQUUsU0FBUyxFQUFpQixNQUFNLHFCQUFxQixDQUFDO0FBRzdFLE9BQU8sRUFBRSxXQUFXLEVBQUUsRUFBRSxFQUFFLE1BQU0sRUFBb0IsTUFBTSxrQkFBa0IsQ0FBQztBQUM3RSxPQUFPLEtBQUssRUFBRSxlQUFlLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQW9CL0QsT0FBTyxFQUNMLEtBQUssWUFBWSxFQUVqQixLQUFLLGNBQWMsRUFDbkIsS0FBSyxjQUFjLEVBQ25CLEtBQUssb0JBQW9CLEVBQzFCLE1BQU0saUJBQWlCLENBQUM7QUFDekIsT0FBTyxFQUFtQixLQUFLLE9BQU8sRUFBMkMsTUFBTSxrQkFBa0IsQ0FBQztBQUcxRzs7R0FFRztBQUNILE1BQU0sV0FBVyxpQkFBaUI7SUFDaEMsVUFBVSxFQUFFLENBQUMsR0FBRyxFQUFFLEVBQUUsRUFBRSxFQUFFLElBQUksRUFBRTtRQUFFLE1BQU0sQ0FBQyxFQUFFLE1BQU0sQ0FBQTtLQUFFLEtBQUssSUFBSSxDQUFDO0lBQzNELFlBQVksRUFBRSxDQUFDLFFBQVEsRUFBRSxNQUFNLEVBQUUsR0FBRyxNQUFNLEVBQUUsS0FBSyxJQUFJLENBQUM7SUFDdEQsVUFBVSxFQUFFLENBQUMsUUFBUSxFQUFF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
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tx_pool_v2_impl.d.ts","sourceRoot":"","sources":["../../../src/mem_pools/tx_pool_v2/tx_pool_v2_impl.ts"],"names":[],"mappings":"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"}