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

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 (509) 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 +10 -10
  5. package/dest/client/factory.d.ts.map +1 -1
  6. package/dest/client/factory.js +45 -18
  7. package/dest/client/interface.d.ts +46 -33
  8. package/dest/client/interface.d.ts.map +1 -1
  9. package/dest/client/p2p_client.d.ts +41 -51
  10. package/dest/client/p2p_client.d.ts.map +1 -1
  11. package/dest/client/p2p_client.js +157 -201
  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 +304 -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 +38 -3
  19. package/dest/config.d.ts.map +1 -1
  20. package/dest/config.js +28 -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 +104 -88
  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 +373 -96
  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 +4 -2
  37. package/dest/mem_pools/attestation_pool/mocks.d.ts.map +1 -1
  38. package/dest/mem_pools/attestation_pool/mocks.js +8 -5
  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 +2 -2
  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 +97 -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 +180 -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 +78 -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 +75 -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 +211 -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 +9 -0
  118. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts +128 -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 +210 -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 +354 -0
  127. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts +60 -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 +77 -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 +899 -0
  133. package/dest/msg_validators/attestation_validator/attestation_validator.d.ts +3 -3
  134. package/dest/msg_validators/attestation_validator/attestation_validator.d.ts.map +1 -1
  135. package/dest/msg_validators/attestation_validator/attestation_validator.js +41 -10
  136. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts +5 -5
  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 +18 -6
  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/proposal_validator/block_proposal_validator.d.ts +2 -1
  143. package/dest/msg_validators/proposal_validator/block_proposal_validator.d.ts.map +1 -1
  144. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.d.ts +2 -1
  145. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.d.ts.map +1 -1
  146. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts +5 -3
  147. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts.map +1 -1
  148. package/dest/msg_validators/proposal_validator/proposal_validator.js +65 -31
  149. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.d.ts +4 -3
  150. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.d.ts.map +1 -1
  151. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.js +257 -62
  152. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts +4 -4
  153. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts.map +1 -1
  154. package/dest/msg_validators/tx_validator/aggregate_tx_validator.js +3 -3
  155. package/dest/msg_validators/tx_validator/archive_cache.d.ts +3 -3
  156. package/dest/msg_validators/tx_validator/archive_cache.d.ts.map +1 -1
  157. package/dest/msg_validators/tx_validator/archive_cache.js +1 -1
  158. package/dest/msg_validators/tx_validator/block_header_validator.d.ts +20 -6
  159. package/dest/msg_validators/tx_validator/block_header_validator.d.ts.map +1 -1
  160. package/dest/msg_validators/tx_validator/block_header_validator.js +4 -3
  161. package/dest/msg_validators/tx_validator/data_validator.d.ts +3 -1
  162. package/dest/msg_validators/tx_validator/data_validator.d.ts.map +1 -1
  163. package/dest/msg_validators/tx_validator/data_validator.js +4 -1
  164. package/dest/msg_validators/tx_validator/double_spend_validator.d.ts +15 -4
  165. package/dest/msg_validators/tx_validator/double_spend_validator.d.ts.map +1 -1
  166. package/dest/msg_validators/tx_validator/double_spend_validator.js +7 -6
  167. package/dest/msg_validators/tx_validator/factory.d.ts +118 -5
  168. package/dest/msg_validators/tx_validator/factory.d.ts.map +1 -1
  169. package/dest/msg_validators/tx_validator/factory.js +228 -57
  170. package/dest/msg_validators/tx_validator/fee_payer_balance.d.ts +10 -0
  171. package/dest/msg_validators/tx_validator/fee_payer_balance.d.ts.map +1 -0
  172. package/dest/msg_validators/tx_validator/fee_payer_balance.js +20 -0
  173. package/dest/msg_validators/tx_validator/gas_validator.d.ts +59 -3
  174. package/dest/msg_validators/tx_validator/gas_validator.d.ts.map +1 -1
  175. package/dest/msg_validators/tx_validator/gas_validator.js +84 -52
  176. package/dest/msg_validators/tx_validator/index.d.ts +3 -1
  177. package/dest/msg_validators/tx_validator/index.d.ts.map +1 -1
  178. package/dest/msg_validators/tx_validator/index.js +2 -0
  179. package/dest/msg_validators/tx_validator/metadata_validator.d.ts +3 -2
  180. package/dest/msg_validators/tx_validator/metadata_validator.d.ts.map +1 -1
  181. package/dest/msg_validators/tx_validator/metadata_validator.js +2 -2
  182. package/dest/msg_validators/tx_validator/nullifier_cache.d.ts +14 -0
  183. package/dest/msg_validators/tx_validator/nullifier_cache.d.ts.map +1 -0
  184. package/dest/msg_validators/tx_validator/nullifier_cache.js +24 -0
  185. package/dest/msg_validators/tx_validator/phases_validator.d.ts +3 -2
  186. package/dest/msg_validators/tx_validator/phases_validator.d.ts.map +1 -1
  187. package/dest/msg_validators/tx_validator/phases_validator.js +3 -3
  188. package/dest/msg_validators/tx_validator/size_validator.d.ts +8 -0
  189. package/dest/msg_validators/tx_validator/size_validator.d.ts.map +1 -0
  190. package/dest/msg_validators/tx_validator/size_validator.js +23 -0
  191. package/dest/msg_validators/tx_validator/timestamp_validator.d.ts +22 -5
  192. package/dest/msg_validators/tx_validator/timestamp_validator.d.ts.map +1 -1
  193. package/dest/msg_validators/tx_validator/timestamp_validator.js +8 -8
  194. package/dest/msg_validators/tx_validator/tx_permitted_validator.d.ts +3 -2
  195. package/dest/msg_validators/tx_validator/tx_permitted_validator.d.ts.map +1 -1
  196. package/dest/msg_validators/tx_validator/tx_permitted_validator.js +2 -2
  197. package/dest/msg_validators/tx_validator/tx_proof_validator.d.ts +3 -2
  198. package/dest/msg_validators/tx_validator/tx_proof_validator.d.ts.map +1 -1
  199. package/dest/msg_validators/tx_validator/tx_proof_validator.js +2 -2
  200. package/dest/services/data_store.d.ts +1 -1
  201. package/dest/services/data_store.d.ts.map +1 -1
  202. package/dest/services/data_store.js +10 -6
  203. package/dest/services/discv5/discV5_service.js +1 -1
  204. package/dest/services/dummy_service.d.ts +24 -4
  205. package/dest/services/dummy_service.d.ts.map +1 -1
  206. package/dest/services/dummy_service.js +46 -1
  207. package/dest/services/encoding.d.ts +3 -3
  208. package/dest/services/encoding.d.ts.map +1 -1
  209. package/dest/services/encoding.js +13 -13
  210. package/dest/services/gossipsub/index.d.ts +3 -0
  211. package/dest/services/gossipsub/index.d.ts.map +1 -0
  212. package/dest/services/gossipsub/index.js +2 -0
  213. package/dest/services/gossipsub/scoring.d.ts +21 -3
  214. package/dest/services/gossipsub/scoring.d.ts.map +1 -1
  215. package/dest/services/gossipsub/scoring.js +24 -7
  216. package/dest/services/gossipsub/topic_score_params.d.ts +173 -0
  217. package/dest/services/gossipsub/topic_score_params.d.ts.map +1 -0
  218. package/dest/services/gossipsub/topic_score_params.js +346 -0
  219. package/dest/services/index.d.ts +2 -1
  220. package/dest/services/index.d.ts.map +1 -1
  221. package/dest/services/index.js +1 -0
  222. package/dest/services/libp2p/instrumentation.d.ts +1 -1
  223. package/dest/services/libp2p/instrumentation.d.ts.map +1 -1
  224. package/dest/services/libp2p/instrumentation.js +19 -8
  225. package/dest/services/libp2p/libp2p_service.d.ts +101 -43
  226. package/dest/services/libp2p/libp2p_service.d.ts.map +1 -1
  227. package/dest/services/libp2p/libp2p_service.js +459 -365
  228. package/dest/services/peer-manager/metrics.d.ts +2 -2
  229. package/dest/services/peer-manager/metrics.d.ts.map +1 -1
  230. package/dest/services/peer-manager/metrics.js +20 -5
  231. package/dest/services/peer-manager/peer_scoring.d.ts +1 -1
  232. package/dest/services/peer-manager/peer_scoring.d.ts.map +1 -1
  233. package/dest/services/peer-manager/peer_scoring.js +33 -4
  234. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts +48 -0
  235. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts.map +1 -0
  236. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.js +562 -0
  237. package/dest/services/reqresp/batch-tx-requester/config.d.ts +17 -0
  238. package/dest/services/reqresp/batch-tx-requester/config.d.ts.map +1 -0
  239. package/dest/services/reqresp/batch-tx-requester/config.js +27 -0
  240. package/dest/services/reqresp/batch-tx-requester/interface.d.ts +46 -0
  241. package/dest/services/reqresp/batch-tx-requester/interface.d.ts.map +1 -0
  242. package/dest/services/reqresp/batch-tx-requester/interface.js +1 -0
  243. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts +34 -0
  244. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts.map +1 -0
  245. package/dest/services/reqresp/batch-tx-requester/missing_txs.js +130 -0
  246. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts +54 -0
  247. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts.map +1 -0
  248. package/dest/services/reqresp/batch-tx-requester/peer_collection.js +139 -0
  249. package/dest/services/reqresp/batch-tx-requester/tx_validator.d.ts +20 -0
  250. package/dest/services/reqresp/batch-tx-requester/tx_validator.d.ts.map +1 -0
  251. package/dest/services/reqresp/batch-tx-requester/tx_validator.js +21 -0
  252. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.d.ts +22 -3
  253. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.d.ts.map +1 -1
  254. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.js +63 -4
  255. package/dest/services/reqresp/connection-sampler/connection_sampler.d.ts +2 -1
  256. package/dest/services/reqresp/connection-sampler/connection_sampler.d.ts.map +1 -1
  257. package/dest/services/reqresp/connection-sampler/connection_sampler.js +12 -0
  258. package/dest/services/reqresp/constants.d.ts +12 -0
  259. package/dest/services/reqresp/constants.d.ts.map +1 -0
  260. package/dest/services/reqresp/constants.js +7 -0
  261. package/dest/services/reqresp/interface.d.ts +12 -1
  262. package/dest/services/reqresp/interface.d.ts.map +1 -1
  263. package/dest/services/reqresp/interface.js +15 -1
  264. package/dest/services/reqresp/metrics.d.ts +6 -5
  265. package/dest/services/reqresp/metrics.d.ts.map +1 -1
  266. package/dest/services/reqresp/metrics.js +17 -5
  267. package/dest/services/reqresp/protocols/block_txs/bitvector.d.ts +5 -1
  268. package/dest/services/reqresp/protocols/block_txs/bitvector.d.ts.map +1 -1
  269. package/dest/services/reqresp/protocols/block_txs/bitvector.js +12 -0
  270. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts +7 -5
  271. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts.map +1 -1
  272. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.js +27 -9
  273. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts +29 -6
  274. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts.map +1 -1
  275. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.js +59 -13
  276. package/dest/services/reqresp/protocols/status.d.ts +1 -1
  277. package/dest/services/reqresp/protocols/status.d.ts.map +1 -1
  278. package/dest/services/reqresp/protocols/status.js +2 -1
  279. package/dest/services/reqresp/protocols/tx.d.ts +7 -1
  280. package/dest/services/reqresp/protocols/tx.d.ts.map +1 -1
  281. package/dest/services/reqresp/protocols/tx.js +20 -0
  282. package/dest/services/reqresp/reqresp.d.ts +6 -1
  283. package/dest/services/reqresp/reqresp.d.ts.map +1 -1
  284. package/dest/services/reqresp/reqresp.js +69 -26
  285. package/dest/services/service.d.ts +42 -3
  286. package/dest/services/service.d.ts.map +1 -1
  287. package/dest/services/tx_collection/config.d.ts +22 -1
  288. package/dest/services/tx_collection/config.d.ts.map +1 -1
  289. package/dest/services/tx_collection/config.js +55 -1
  290. package/dest/services/tx_collection/fast_tx_collection.d.ts +7 -4
  291. package/dest/services/tx_collection/fast_tx_collection.d.ts.map +1 -1
  292. package/dest/services/tx_collection/fast_tx_collection.js +71 -44
  293. package/dest/services/tx_collection/file_store_tx_collection.d.ts +53 -0
  294. package/dest/services/tx_collection/file_store_tx_collection.d.ts.map +1 -0
  295. package/dest/services/tx_collection/file_store_tx_collection.js +167 -0
  296. package/dest/services/tx_collection/file_store_tx_source.d.ts +37 -0
  297. package/dest/services/tx_collection/file_store_tx_source.d.ts.map +1 -0
  298. package/dest/services/tx_collection/file_store_tx_source.js +90 -0
  299. package/dest/services/tx_collection/index.d.ts +3 -1
  300. package/dest/services/tx_collection/index.d.ts.map +1 -1
  301. package/dest/services/tx_collection/index.js +2 -0
  302. package/dest/services/tx_collection/instrumentation.d.ts +1 -1
  303. package/dest/services/tx_collection/instrumentation.d.ts.map +1 -1
  304. package/dest/services/tx_collection/instrumentation.js +10 -2
  305. package/dest/services/tx_collection/missing_txs_tracker.d.ts +32 -0
  306. package/dest/services/tx_collection/missing_txs_tracker.d.ts.map +1 -0
  307. package/dest/services/tx_collection/missing_txs_tracker.js +27 -0
  308. package/dest/services/tx_collection/proposal_tx_collector.d.ts +49 -0
  309. package/dest/services/tx_collection/proposal_tx_collector.d.ts.map +1 -0
  310. package/dest/services/tx_collection/proposal_tx_collector.js +50 -0
  311. package/dest/services/tx_collection/slow_tx_collection.d.ts +9 -5
  312. package/dest/services/tx_collection/slow_tx_collection.d.ts.map +1 -1
  313. package/dest/services/tx_collection/slow_tx_collection.js +60 -26
  314. package/dest/services/tx_collection/tx_collection.d.ts +29 -16
  315. package/dest/services/tx_collection/tx_collection.d.ts.map +1 -1
  316. package/dest/services/tx_collection/tx_collection.js +79 -7
  317. package/dest/services/tx_collection/tx_collection_sink.d.ts +18 -8
  318. package/dest/services/tx_collection/tx_collection_sink.d.ts.map +1 -1
  319. package/dest/services/tx_collection/tx_collection_sink.js +26 -29
  320. package/dest/services/tx_collection/tx_source.d.ts +8 -3
  321. package/dest/services/tx_collection/tx_source.d.ts.map +1 -1
  322. package/dest/services/tx_collection/tx_source.js +19 -2
  323. package/dest/services/tx_file_store/config.d.ts +16 -0
  324. package/dest/services/tx_file_store/config.d.ts.map +1 -0
  325. package/dest/services/tx_file_store/config.js +22 -0
  326. package/dest/services/tx_file_store/index.d.ts +4 -0
  327. package/dest/services/tx_file_store/index.d.ts.map +1 -0
  328. package/dest/services/tx_file_store/index.js +3 -0
  329. package/dest/services/tx_file_store/instrumentation.d.ts +15 -0
  330. package/dest/services/tx_file_store/instrumentation.d.ts.map +1 -0
  331. package/dest/services/tx_file_store/instrumentation.js +29 -0
  332. package/dest/services/tx_file_store/tx_file_store.d.ts +48 -0
  333. package/dest/services/tx_file_store/tx_file_store.d.ts.map +1 -0
  334. package/dest/services/tx_file_store/tx_file_store.js +152 -0
  335. package/dest/services/tx_provider.d.ts +6 -6
  336. package/dest/services/tx_provider.d.ts.map +1 -1
  337. package/dest/services/tx_provider.js +9 -8
  338. package/dest/services/tx_provider_instrumentation.d.ts +1 -1
  339. package/dest/services/tx_provider_instrumentation.d.ts.map +1 -1
  340. package/dest/services/tx_provider_instrumentation.js +5 -5
  341. package/dest/test-helpers/index.d.ts +3 -1
  342. package/dest/test-helpers/index.d.ts.map +1 -1
  343. package/dest/test-helpers/index.js +2 -0
  344. package/dest/test-helpers/make-test-p2p-clients.d.ts +7 -8
  345. package/dest/test-helpers/make-test-p2p-clients.d.ts.map +1 -1
  346. package/dest/test-helpers/make-test-p2p-clients.js +1 -2
  347. package/dest/test-helpers/mock-pubsub.d.ts +30 -4
  348. package/dest/test-helpers/mock-pubsub.d.ts.map +1 -1
  349. package/dest/test-helpers/mock-pubsub.js +105 -4
  350. package/dest/test-helpers/reqresp-nodes.d.ts +2 -3
  351. package/dest/test-helpers/reqresp-nodes.d.ts.map +1 -1
  352. package/dest/test-helpers/reqresp-nodes.js +4 -3
  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 +163 -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 -139
  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 -44
  365. package/dest/util.d.ts +2 -2
  366. package/dest/util.d.ts.map +1 -1
  367. package/package.json +16 -16
  368. package/src/bootstrap/bootstrap.ts +7 -4
  369. package/src/client/factory.ts +83 -36
  370. package/src/client/interface.ts +56 -34
  371. package/src/client/p2p_client.ts +197 -252
  372. package/src/client/test/tx_proposal_collector/README.md +227 -0
  373. package/src/client/test/tx_proposal_collector/proposal_tx_collector_worker.ts +345 -0
  374. package/src/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.ts +43 -0
  375. package/src/config.ts +58 -4
  376. package/src/errors/tx-pool.error.ts +12 -0
  377. package/src/index.ts +1 -0
  378. package/src/mem_pools/attestation_pool/attestation_pool.ts +496 -91
  379. package/src/mem_pools/attestation_pool/attestation_pool_test_suite.ts +460 -112
  380. package/src/mem_pools/attestation_pool/index.ts +9 -2
  381. package/src/mem_pools/attestation_pool/mocks.ts +7 -4
  382. package/src/mem_pools/index.ts +4 -1
  383. package/src/mem_pools/instrumentation.ts +2 -1
  384. package/src/mem_pools/interface.ts +4 -4
  385. package/src/mem_pools/tx_pool/README.md +29 -14
  386. package/src/mem_pools/tx_pool/aztec_kv_tx_pool.ts +130 -75
  387. package/src/mem_pools/tx_pool/eviction/eviction_manager.ts +66 -5
  388. package/src/mem_pools/tx_pool/eviction/eviction_strategy.ts +119 -4
  389. package/src/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.ts +162 -0
  390. package/src/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.ts +3 -3
  391. package/src/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.ts +4 -2
  392. package/src/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.ts +75 -0
  393. package/src/mem_pools/tx_pool_v2/README.md +283 -0
  394. package/src/mem_pools/tx_pool_v2/archive/index.ts +1 -0
  395. package/src/mem_pools/tx_pool_v2/archive/tx_archive.ts +120 -0
  396. package/src/mem_pools/tx_pool_v2/deleted_pool.ts +321 -0
  397. package/src/mem_pools/tx_pool_v2/eviction/eviction_manager.ts +160 -0
  398. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.ts +121 -0
  399. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.ts +125 -0
  400. package/src/mem_pools/tx_pool_v2/eviction/index.ts +27 -0
  401. package/src/mem_pools/tx_pool_v2/eviction/interfaces.ts +219 -0
  402. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.ts +74 -0
  403. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.ts +101 -0
  404. package/src/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.ts +91 -0
  405. package/src/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.ts +99 -0
  406. package/src/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.ts +32 -0
  407. package/src/mem_pools/tx_pool_v2/index.ts +12 -0
  408. package/src/mem_pools/tx_pool_v2/instrumentation.ts +69 -0
  409. package/src/mem_pools/tx_pool_v2/interfaces.ts +242 -0
  410. package/src/mem_pools/tx_pool_v2/tx_metadata.ts +327 -0
  411. package/src/mem_pools/tx_pool_v2/tx_pool_bench_metrics.ts +77 -0
  412. package/src/mem_pools/tx_pool_v2/tx_pool_indices.ts +444 -0
  413. package/src/mem_pools/tx_pool_v2/tx_pool_v2.ts +223 -0
  414. package/src/mem_pools/tx_pool_v2/tx_pool_v2_impl.ts +1079 -0
  415. package/src/msg_validators/attestation_validator/attestation_validator.ts +26 -14
  416. package/src/msg_validators/attestation_validator/fisherman_attestation_validator.ts +16 -10
  417. package/src/msg_validators/clock_tolerance.ts +51 -0
  418. package/src/msg_validators/proposal_validator/block_proposal_validator.ts +1 -1
  419. package/src/msg_validators/proposal_validator/checkpoint_proposal_validator.ts +1 -1
  420. package/src/msg_validators/proposal_validator/proposal_validator.ts +46 -32
  421. package/src/msg_validators/proposal_validator/proposal_validator_test_suite.ts +233 -66
  422. package/src/msg_validators/tx_validator/README.md +115 -0
  423. package/src/msg_validators/tx_validator/aggregate_tx_validator.ts +5 -5
  424. package/src/msg_validators/tx_validator/archive_cache.ts +3 -3
  425. package/src/msg_validators/tx_validator/block_header_validator.ts +21 -8
  426. package/src/msg_validators/tx_validator/data_validator.ts +6 -2
  427. package/src/msg_validators/tx_validator/double_spend_validator.ts +15 -9
  428. package/src/msg_validators/tx_validator/factory.ts +372 -55
  429. package/src/msg_validators/tx_validator/fee_payer_balance.ts +40 -0
  430. package/src/msg_validators/tx_validator/gas_validator.ts +106 -54
  431. package/src/msg_validators/tx_validator/index.ts +2 -0
  432. package/src/msg_validators/tx_validator/metadata_validator.ts +6 -3
  433. package/src/msg_validators/tx_validator/nullifier_cache.ts +30 -0
  434. package/src/msg_validators/tx_validator/phases_validator.ts +5 -3
  435. package/src/msg_validators/tx_validator/size_validator.ts +22 -0
  436. package/src/msg_validators/tx_validator/timestamp_validator.ts +29 -21
  437. package/src/msg_validators/tx_validator/tx_permitted_validator.ts +8 -3
  438. package/src/msg_validators/tx_validator/tx_proof_validator.ts +8 -3
  439. package/src/services/data_store.ts +10 -7
  440. package/src/services/discv5/discV5_service.ts +1 -1
  441. package/src/services/dummy_service.ts +59 -2
  442. package/src/services/encoding.ts +11 -12
  443. package/src/services/gossipsub/README.md +641 -0
  444. package/src/services/gossipsub/index.ts +2 -0
  445. package/src/services/gossipsub/scoring.ts +29 -5
  446. package/src/services/gossipsub/topic_score_params.ts +487 -0
  447. package/src/services/index.ts +1 -0
  448. package/src/services/libp2p/instrumentation.ts +20 -7
  449. package/src/services/libp2p/libp2p_service.ts +508 -393
  450. package/src/services/peer-manager/metrics.ts +21 -4
  451. package/src/services/peer-manager/peer_scoring.ts +29 -1
  452. package/src/services/reqresp/batch-tx-requester/README.md +305 -0
  453. package/src/services/reqresp/batch-tx-requester/batch_tx_requester.ts +706 -0
  454. package/src/services/reqresp/batch-tx-requester/config.ts +40 -0
  455. package/src/services/reqresp/batch-tx-requester/interface.ts +53 -0
  456. package/src/services/reqresp/batch-tx-requester/missing_txs.ts +161 -0
  457. package/src/services/reqresp/batch-tx-requester/peer_collection.ts +205 -0
  458. package/src/services/reqresp/batch-tx-requester/tx_validator.ts +37 -0
  459. package/src/services/reqresp/connection-sampler/batch_connection_sampler.ts +65 -4
  460. package/src/services/reqresp/connection-sampler/connection_sampler.ts +16 -0
  461. package/src/services/reqresp/constants.ts +14 -0
  462. package/src/services/reqresp/interface.ts +29 -1
  463. package/src/services/reqresp/metrics.ts +34 -9
  464. package/src/services/reqresp/protocols/block_txs/bitvector.ts +16 -0
  465. package/src/services/reqresp/protocols/block_txs/block_txs_handler.ts +35 -12
  466. package/src/services/reqresp/protocols/block_txs/block_txs_reqresp.ts +74 -9
  467. package/src/services/reqresp/protocols/status.ts +5 -3
  468. package/src/services/reqresp/protocols/tx.ts +22 -0
  469. package/src/services/reqresp/reqresp.ts +79 -22
  470. package/src/services/service.ts +55 -2
  471. package/src/services/tx_collection/config.ts +83 -1
  472. package/src/services/tx_collection/fast_tx_collection.ts +93 -47
  473. package/src/services/tx_collection/file_store_tx_collection.ts +202 -0
  474. package/src/services/tx_collection/file_store_tx_source.ts +117 -0
  475. package/src/services/tx_collection/index.ts +6 -0
  476. package/src/services/tx_collection/instrumentation.ts +17 -2
  477. package/src/services/tx_collection/missing_txs_tracker.ts +52 -0
  478. package/src/services/tx_collection/proposal_tx_collector.ts +113 -0
  479. package/src/services/tx_collection/slow_tx_collection.ts +68 -35
  480. package/src/services/tx_collection/tx_collection.ts +121 -24
  481. package/src/services/tx_collection/tx_collection_sink.ts +30 -34
  482. package/src/services/tx_collection/tx_source.ts +22 -3
  483. package/src/services/tx_file_store/config.ts +37 -0
  484. package/src/services/tx_file_store/index.ts +3 -0
  485. package/src/services/tx_file_store/instrumentation.ts +36 -0
  486. package/src/services/tx_file_store/tx_file_store.ts +175 -0
  487. package/src/services/tx_provider.ts +12 -11
  488. package/src/services/tx_provider_instrumentation.ts +11 -5
  489. package/src/test-helpers/index.ts +2 -0
  490. package/src/test-helpers/make-test-p2p-clients.ts +3 -5
  491. package/src/test-helpers/mock-pubsub.ts +146 -9
  492. package/src/test-helpers/reqresp-nodes.ts +4 -6
  493. package/src/test-helpers/test_tx_provider.ts +64 -0
  494. package/src/test-helpers/testbench-utils.ts +430 -0
  495. package/src/testbench/p2p_client_testbench_worker.ts +333 -135
  496. package/src/testbench/worker_client_manager.ts +304 -47
  497. package/src/util.ts +7 -1
  498. package/dest/mem_pools/attestation_pool/kv_attestation_pool.d.ts +0 -40
  499. package/dest/mem_pools/attestation_pool/kv_attestation_pool.d.ts.map +0 -1
  500. package/dest/mem_pools/attestation_pool/kv_attestation_pool.js +0 -218
  501. package/dest/mem_pools/attestation_pool/memory_attestation_pool.d.ts +0 -31
  502. package/dest/mem_pools/attestation_pool/memory_attestation_pool.d.ts.map +0 -1
  503. package/dest/mem_pools/attestation_pool/memory_attestation_pool.js +0 -180
  504. package/dest/mem_pools/tx_pool/eviction/insufficient_fee_payer_balance_rule.d.ts +0 -15
  505. package/dest/mem_pools/tx_pool/eviction/insufficient_fee_payer_balance_rule.d.ts.map +0 -1
  506. package/dest/mem_pools/tx_pool/eviction/insufficient_fee_payer_balance_rule.js +0 -88
  507. package/src/mem_pools/attestation_pool/kv_attestation_pool.ts +0 -320
  508. package/src/mem_pools/attestation_pool/memory_attestation_pool.ts +0 -264
  509. package/src/mem_pools/tx_pool/eviction/insufficient_fee_payer_balance_rule.ts +0 -108
@@ -1,18 +1,23 @@
1
+ import { findIndexInSortedArray, insertIntoSortedArray } from '@aztec/foundation/array';
2
+ import { Fr } from '@aztec/foundation/curves/bn254';
1
3
  import { createLogger } from '@aztec/foundation/log';
2
4
  import { EvictionEvent } from './eviction_strategy.js';
3
5
  export class EvictionManager {
4
6
  txPool;
5
7
  log;
6
8
  rules;
9
+ /** Pre-add eviction rules (run inside addTxs transaction) */ preAddRules;
7
10
  constructor(txPool, log = createLogger('p2p:mempool:tx_pool:eviction_manager')){
8
11
  this.txPool = txPool;
9
12
  this.log = log;
10
13
  this.rules = [];
14
+ this.preAddRules = [];
11
15
  }
12
- async evictAfterNewTxs(newTxs) {
16
+ async evictAfterNewTxs(newTxs, feePayers) {
13
17
  const ctx = {
14
18
  event: EvictionEvent.TXS_ADDED,
15
- newTxs
19
+ newTxs,
20
+ feePayers
16
21
  };
17
22
  await this.runEvictionRules(ctx);
18
23
  }
@@ -21,7 +26,7 @@ export class EvictionManager {
21
26
  event: EvictionEvent.BLOCK_MINED,
22
27
  block,
23
28
  newNullifiers,
24
- minedFeePayers
29
+ feePayers: minedFeePayers
25
30
  };
26
31
  await this.runEvictionRules(ctx);
27
32
  }
@@ -32,13 +37,64 @@ export class EvictionManager {
32
37
  };
33
38
  await this.runEvictionRules(ctx);
34
39
  }
40
+ /**
41
+ * Runs pre-add eviction rules to determine if an incoming tx should be added
42
+ * and which existing txs should be evicted.
43
+ * Called from inside the addTxs database transaction for atomicity.
44
+ *
45
+ * @param tx - The incoming transaction
46
+ * @param poolAccess - Read-only access to pool state
47
+ * @returns Combined result from all pre-add rules
48
+ */ async runPreAddRules(tx, poolAccess) {
49
+ const allTxHashesToEvict = [];
50
+ const cmpTxHash = (a, b)=>Fr.cmp(a.hash, b.hash);
51
+ for (const rule of this.preAddRules){
52
+ try {
53
+ const result = await rule.check(tx, poolAccess);
54
+ if (result.shouldReject) {
55
+ return {
56
+ shouldReject: true,
57
+ txHashesToEvict: [],
58
+ reason: result.reason
59
+ };
60
+ }
61
+ for (const txHashToEvict of result.txHashesToEvict){
62
+ // Only add if not already present (dedup)
63
+ if (findIndexInSortedArray(allTxHashesToEvict, txHashToEvict, cmpTxHash) === -1) {
64
+ insertIntoSortedArray(allTxHashesToEvict, txHashToEvict, cmpTxHash);
65
+ }
66
+ }
67
+ } catch (err) {
68
+ this.log.warn(`Pre-add eviction rule ${rule.name} unexpected error: ${String(err)}`, {
69
+ err,
70
+ preAddRule: rule.name
71
+ });
72
+ // On error, reject the tx to be safe
73
+ return {
74
+ shouldReject: true,
75
+ txHashesToEvict: [],
76
+ reason: `rule error: ${String(err)}`
77
+ };
78
+ }
79
+ }
80
+ return {
81
+ shouldReject: false,
82
+ txHashesToEvict: allTxHashesToEvict
83
+ };
84
+ }
35
85
  registerRule(rule) {
36
86
  this.rules.push(rule);
37
87
  }
88
+ registerPreAddRule(rule) {
89
+ this.preAddRules.push(rule);
90
+ }
38
91
  updateConfig(config) {
39
92
  for (const rule of this.rules){
40
93
  rule.updateConfig(config);
41
94
  }
95
+ for (const rule of this.preAddRules){
96
+ rule.updateConfig?.(config);
97
+ }
42
98
  }
43
99
  async runEvictionRules(ctx) {
44
100
  for (const rule of this.rules){
@@ -1,6 +1,7 @@
1
+ import type { BlockNumber } from '@aztec/foundation/branded-types';
1
2
  import { Fr } from '@aztec/foundation/curves/bn254';
2
3
  import type { AztecAddress } from '@aztec/stdlib/aztec-address';
3
- import type { BlockHeader, Tx, TxHash } from '@aztec/stdlib/tx';
4
+ import { type BlockHeader, type Tx, TxHash } from '@aztec/stdlib/tx';
4
5
  import type { TxPoolOptions } from '../tx_pool.js';
5
6
  export declare const EvictionEvent: {
6
7
  readonly TXS_ADDED: "txs_added";
@@ -11,14 +12,15 @@ type EvictionEvent = (typeof EvictionEvent)[keyof typeof EvictionEvent];
11
12
  export type EvictionContext = {
12
13
  event: typeof EvictionEvent.TXS_ADDED;
13
14
  newTxs: TxHash[];
15
+ feePayers: AztecAddress[];
14
16
  } | {
15
17
  event: typeof EvictionEvent.CHAIN_PRUNED;
16
- blockNumber: number;
18
+ blockNumber: BlockNumber;
17
19
  } | {
18
20
  event: typeof EvictionEvent.BLOCK_MINED;
19
21
  block: BlockHeader;
20
22
  newNullifiers: Fr[];
21
- minedFeePayers: AztecAddress[];
23
+ feePayers: AztecAddress[];
22
24
  };
23
25
  /**
24
26
  * Result of an eviction operation
@@ -52,7 +54,8 @@ export interface TxPoolOperations {
52
54
  getTxByHash(txHash: TxHash): Promise<Tx | undefined>;
53
55
  getPendingTxInfos(): Promise<PendingTxInfo[]>;
54
56
  getPendingTxsReferencingBlocks(blockHashes: Fr[]): Promise<TxBlockReference[]>;
55
- getPendingTxsWithFeePayer(feePayer: AztecAddress[]): Promise<PendingTxInfo[]>;
57
+ getPendingFeePayers(): Promise<AztecAddress[]>;
58
+ getFeePayerTxInfos(feePayer: AztecAddress): AsyncIterable<FeePayerTxInfo>;
56
59
  /** Cheap count of current pending transactions. */
57
60
  getPendingTxCount(): Promise<number>;
58
61
  /**
@@ -79,5 +82,76 @@ export interface EvictionRule {
79
82
  */
80
83
  updateConfig(config: TxPoolOptions): void;
81
84
  }
85
+ /**
86
+ * Balance-related information about a transaction for a fee payer.
87
+ */
88
+ export declare class FeePayerTxInfo {
89
+ txHash: TxHash;
90
+ priority: bigint;
91
+ feeLimit: bigint;
92
+ claimAmount: bigint;
93
+ isEvictable: boolean;
94
+ constructor(fields: {
95
+ txHash: TxHash;
96
+ priority: bigint;
97
+ feeLimit: bigint;
98
+ claimAmount: bigint;
99
+ isEvictable: boolean;
100
+ });
101
+ static encode(tx: Tx, txHash: string | TxHash): Promise<Buffer>;
102
+ static decode(value: Buffer, isEvictable?: boolean): FeePayerTxInfo;
103
+ }
104
+ /**
105
+ * Read-only access to pool state for pre-add eviction checks.
106
+ * Passed to pre-add rules during the addTxs transaction.
107
+ */
108
+ export interface PreAddPoolAccess {
109
+ /**
110
+ * Get the pending tx hash that uses a specific nullifier, if any.
111
+ * Returns undefined if no pending tx uses this nullifier.
112
+ */
113
+ getTxHashByNullifier(nullifier: Fr): Promise<TxHash | undefined>;
114
+ /**
115
+ * Get a pending transaction by its hash.
116
+ */
117
+ getPendingTxByHash(hash: TxHash): Promise<Tx | undefined>;
118
+ /**
119
+ * Get the priority string for a transaction (for fee comparison).
120
+ */
121
+ getTxPriority(tx: Tx): string;
122
+ }
123
+ /**
124
+ * Result of a pre-add eviction check for a single transaction.
125
+ */
126
+ export interface PreAddEvictionResult {
127
+ /** Whether the incoming tx should be rejected */
128
+ readonly shouldReject: boolean;
129
+ /** Sorted array of existing tx hashes that should be evicted if this tx is added */
130
+ readonly txHashesToEvict: TxHash[];
131
+ /** Optional reason for rejection */
132
+ readonly reason?: string;
133
+ }
134
+ /**
135
+ * Strategy interface for pre-add eviction rules.
136
+ * These run inside the addTxs transaction before a tx is added,
137
+ * deciding whether to evict existing txs or reject the incoming tx.
138
+ */
139
+ export interface PreAddEvictionRule {
140
+ readonly name: string;
141
+ /**
142
+ * Check if incoming tx should be added and which existing txs to evict.
143
+ * Called inside the addTxs database transaction for atomicity.
144
+ *
145
+ * @param tx - The incoming transaction to check
146
+ * @param poolAccess - Read-only access to current pool state
147
+ * @returns Result indicating whether to reject and what to evict
148
+ */
149
+ check(tx: Tx, poolAccess: PreAddPoolAccess): Promise<PreAddEvictionResult>;
150
+ /**
151
+ * Updates the configuration for this rule.
152
+ * Rules should ignore config options that don't apply to them.
153
+ */
154
+ updateConfig?(config: TxPoolOptions): void;
155
+ }
82
156
  export {};
83
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXZpY3Rpb25fc3RyYXRlZ3kuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9tZW1fcG9vbHMvdHhfcG9vbC9ldmljdGlvbi9ldmljdGlvbl9zdHJhdGVneS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsRUFBRSxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFDcEQsT0FBTyxLQUFLLEVBQUUsWUFBWSxFQUFFLE1BQU0sNkJBQTZCLENBQUM7QUFDaEUsT0FBTyxLQUFLLEVBQUUsV0FBVyxFQUFFLEVBQUUsRUFBRSxNQUFNLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUVoRSxPQUFPLEtBQUssRUFBRSxhQUFhLEVBQUUsTUFBTSxlQUFlLENBQUM7QUFFbkQsZUFBTyxNQUFNLGFBQWE7Ozs7Q0FJaEIsQ0FBQztBQUVYLEtBQUssYUFBYSxHQUFHLENBQUMsT0FBTyxhQUFhLENBQUMsQ0FBQyxNQUFNLE9BQU8sYUFBYSxDQUFDLENBQUM7QUFFeEUsTUFBTSxNQUFNLGVBQWUsR0FDdkI7SUFDRSxLQUFLLEVBQUUsT0FBTyxhQUFhLENBQUMsU0FBUyxDQUFDO0lBQ3RDLE1BQU0sRUFBRSxNQUFNLEVBQUUsQ0FBQztDQUNsQixHQUNEO0lBQ0UsS0FBSyxFQUFFLE9BQU8sYUFBYSxDQUFDLFlBQVksQ0FBQztJQUN6QyxXQUFXLEVBQUUsTUFBTSxDQUFDO0NBQ3JCLEdBQ0Q7SUFDRSxLQUFLLEVBQUUsT0FBTyxhQUFhLENBQUMsV0FBVyxDQUFDO0lBQ3hDLEtBQUssRUFBRSxXQUFXLENBQUM7SUFDbkIsYUFBYSxFQUFFLEVBQUUsRUFBRSxDQUFDO0lBQ3BCLGNBQWMsRUFBRSxZQUFZLEVBQUUsQ0FBQztDQUNoQyxDQUFDO0FBRU47O0dBRUc7QUFDSCxNQUFNLFdBQVcsY0FBYztJQUM3QixRQUFRLENBQUMsVUFBVSxFQUFFLE1BQU0sRUFBRSxDQUFDO0lBQzlCLFFBQVEsQ0FBQyxNQUFNLEVBQUUsTUFBTSxDQUFDO0lBQ3hCLFFBQVEsQ0FBQyxPQUFPLEVBQUUsT0FBTyxDQUFDO0lBQzFCLFFBQVEsQ0FBQyxLQUFLLENBQUMsRUFBRSxLQUFLLENBQUM7Q0FDeEI7QUFFRDs7R0FFRztBQUNILE1BQU0sV0FBVyxhQUFhO0lBQzVCLE1BQU0sRUFBRSxNQUFNLENBQUM7SUFDZixTQUFTLEVBQUUsRUFBRSxDQUFDO0lBQ2QsV0FBVyxFQUFFLE9BQU8sQ0FBQztDQUN0QjtBQUVEOztHQUVHO0FBQ0gsTUFBTSxXQUFXLGdCQUFnQjtJQUMvQixNQUFNLEVBQUUsTUFBTSxDQUFDO0lBQ2YsU0FBUyxFQUFFLEVBQUUsQ0FBQztJQUNkLFdBQVcsRUFBRSxPQUFPLENBQUM7Q0FDdEI7QUFFRDs7R0FFRztBQUNILE1BQU0sV0FBVyxnQkFBZ0I7SUFDL0IsV0FBVyxDQUFDLE1BQU0sRUFBRSxNQUFNLEdBQUcsT0FBTyxDQUFDLEVBQUUsR0FBRyxTQUFTLENBQUMsQ0FBQztJQUNyRCxpQkFBaUIsSUFBSSxPQUFPLENBQUMsYUFBYSxFQUFFLENBQUMsQ0FBQztJQUM5Qyw4QkFBOEIsQ0FBQyxXQUFXLEVBQUUsRUFBRSxFQUFFLEdBQUcsT0FBTyxDQUFDLGdCQUFnQixFQUFFLENBQUMsQ0FBQztJQUMvRSx5QkFBeUIsQ0FBQyxRQUFRLEVBQUUsWUFBWSxFQUFFLEdBQUcsT0FBTyxDQUFDLGFBQWEsRUFBRSxDQUFDLENBQUM7SUFDOUUsbURBQW1EO0lBQ25ELGlCQUFpQixJQUFJLE9BQU8sQ0FBQyxNQUFNLENBQUMsQ0FBQztJQUNyQzs7O09BR0c7SUFDSCwwQkFBMEIsQ0FBQyxLQUFLLEVBQUUsTUFBTSxHQUFHLE9BQU8sQ0FBQyxNQUFNLEVBQUUsQ0FBQyxDQUFDO0lBQzdELFNBQVMsQ0FBQyxRQUFRLEVBQUUsTUFBTSxFQUFFLEVBQUUsSUFBSSxDQUFDLEVBQUU7UUFBRSxXQUFXLENBQUMsRUFBRSxPQUFPLENBQUE7S0FBRSxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztDQUNoRjtBQUVEOztHQUVHO0FBQ0gsTUFBTSxXQUFXLFlBQVk7SUFDM0IsUUFBUSxDQUFDLElBQUksRUFBRSxNQUFNLENBQUM7SUFFdEI7O09BRUc7SUFDSCxLQUFLLENBQUMsT0FBTyxFQUFFLGVBQWUsRUFBRSxNQUFNLEVBQUUsZ0JBQWdCLEdBQUcsT0FBTyxDQUFDLGNBQWMsQ0FBQyxDQUFDO0lBRW5GOzs7T0FHRztJQUNILFlBQVksQ0FBQyxNQUFNLEVBQUUsYUFBYSxHQUFHLElBQUksQ0FBQztDQUMzQyJ9
157
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXZpY3Rpb25fc3RyYXRlZ3kuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9tZW1fcG9vbHMvdHhfcG9vbC9ldmljdGlvbi9ldmljdGlvbl9zdHJhdGVneS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxXQUFXLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUVuRSxPQUFPLEVBQUUsRUFBRSxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFFcEQsT0FBTyxLQUFLLEVBQUUsWUFBWSxFQUFFLE1BQU0sNkJBQTZCLENBQUM7QUFDaEUsT0FBTyxFQUFFLEtBQUssV0FBVyxFQUFFLEtBQUssRUFBRSxFQUFFLE1BQU0sRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBSXJFLE9BQU8sS0FBSyxFQUFFLGFBQWEsRUFBRSxNQUFNLGVBQWUsQ0FBQztBQUVuRCxlQUFPLE1BQU0sYUFBYTs7OztDQUloQixDQUFDO0FBRVgsS0FBSyxhQUFhLEdBQUcsQ0FBQyxPQUFPLGFBQWEsQ0FBQyxDQUFDLE1BQU0sT0FBTyxhQUFhLENBQUMsQ0FBQztBQUV4RSxNQUFNLE1BQU0sZUFBZSxHQUN2QjtJQUNFLEtBQUssRUFBRSxPQUFPLGFBQWEsQ0FBQyxTQUFTLENBQUM7SUFDdEMsTUFBTSxFQUFFLE1BQU0sRUFBRSxDQUFDO0lBQ2pCLFNBQVMsRUFBRSxZQUFZLEVBQUUsQ0FBQztDQUMzQixHQUNEO0lBQ0UsS0FBSyxFQUFFLE9BQU8sYUFBYSxDQUFDLFlBQVksQ0FBQztJQUN6QyxXQUFXLEVBQUUsV0FBVyxDQUFDO0NBQzFCLEdBQ0Q7SUFDRSxLQUFLLEVBQUUsT0FBTyxhQUFhLENBQUMsV0FBVyxDQUFDO0lBQ3hDLEtBQUssRUFBRSxXQUFXLENBQUM7SUFDbkIsYUFBYSxFQUFFLEVBQUUsRUFBRSxDQUFDO0lBQ3BCLFNBQVMsRUFBRSxZQUFZLEVBQUUsQ0FBQztDQUMzQixDQUFDO0FBRU47O0dBRUc7QUFDSCxNQUFNLFdBQVcsY0FBYztJQUM3QixRQUFRLENBQUMsVUFBVSxFQUFFLE1BQU0sRUFBRSxDQUFDO0lBQzlCLFFBQVEsQ0FBQyxNQUFNLEVBQUUsTUFBTSxDQUFDO0lBQ3hCLFFBQVEsQ0FBQyxPQUFPLEVBQUUsT0FBTyxDQUFDO0lBQzFCLFFBQVEsQ0FBQyxLQUFLLENBQUMsRUFBRSxLQUFLLENBQUM7Q0FDeEI7QUFFRDs7R0FFRztBQUNILE1BQU0sV0FBVyxhQUFhO0lBQzVCLE1BQU0sRUFBRSxNQUFNLENBQUM7SUFDZixTQUFTLEVBQUUsRUFBRSxDQUFDO0lBQ2QsV0FBVyxFQUFFLE9BQU8sQ0FBQztDQUN0QjtBQUVEOztHQUVHO0FBQ0gsTUFBTSxXQUFXLGdCQUFnQjtJQUMvQixNQUFNLEVBQUUsTUFBTSxDQUFDO0lBQ2YsU0FBUyxFQUFFLEVBQUUsQ0FBQztJQUNkLFdBQVcsRUFBRSxPQUFPLENBQUM7Q0FDdEI7QUFFRDs7R0FFRztBQUNILE1BQU0sV0FBVyxnQkFBZ0I7SUFDL0IsV0FBVyxDQUFDLE1BQU0sRUFBRSxNQUFNLEdBQUcsT0FBTyxDQUFDLEVBQUUsR0FBRyxTQUFTLENBQUMsQ0FBQztJQUNyRCxpQkFBaUIsSUFBSSxPQUFPLENBQUMsYUFBYSxFQUFFLENBQUMsQ0FBQztJQUM5Qyw4QkFBOEIsQ0FBQyxXQUFXLEVBQUUsRUFBRSxFQUFFLEdBQUcsT0FBTyxDQUFDLGdCQUFnQixFQUFFLENBQUMsQ0FBQztJQUMvRSxtQkFBbUIsSUFBSSxPQUFPLENBQUMsWUFBWSxFQUFFLENBQUMsQ0FBQztJQUMvQyxrQkFBa0IsQ0FBQyxRQUFRLEVBQUUsWUFBWSxHQUFHLGFBQWEsQ0FBQyxjQUFjLENBQUMsQ0FBQztJQUMxRSxtREFBbUQ7SUFDbkQsaUJBQWlCLElBQUksT0FBTyxDQUFDLE1BQU0sQ0FBQyxDQUFDO0lBQ3JDOzs7T0FHRztJQUNILDBCQUEwQixDQUFDLEtBQUssRUFBRSxNQUFNLEdBQUcsT0FBTyxDQUFDLE1BQU0sRUFBRSxDQUFDLENBQUM7SUFDN0QsU0FBUyxDQUFDLFFBQVEsRUFBRSxNQUFNLEVBQUUsRUFBRSxJQUFJLENBQUMsRUFBRTtRQUFFLFdBQVcsQ0FBQyxFQUFFLE9BQU8sQ0FBQTtLQUFFLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDO0NBQ2hGO0FBRUQ7O0dBRUc7QUFDSCxNQUFNLFdBQVcsWUFBWTtJQUMzQixRQUFRLENBQUMsSUFBSSxFQUFFLE1BQU0sQ0FBQztJQUV0Qjs7T0FFRztJQUNILEtBQUssQ0FBQyxPQUFPLEVBQUUsZUFBZSxFQUFFLE1BQU0sRUFBRSxnQkFBZ0IsR0FBRyxPQUFPLENBQUMsY0FBYyxDQUFDLENBQUM7SUFFbkY7OztPQUdHO0lBQ0gsWUFBWSxDQUFDLE1BQU0sRUFBRSxhQUFhLEdBQUcsSUFBSSxDQUFDO0NBQzNDO0FBRUQ7O0dBRUc7QUFDSCxxQkFBYSxjQUFjO0lBQ3pCLE1BQU0sRUFBRSxNQUFNLENBQUM7SUFDZixRQUFRLEVBQUUsTUFBTSxDQUFDO0lBQ2pCLFFBQVEsRUFBRSxNQUFNLENBQUM7SUFDakIsV0FBVyxFQUFFLE1BQU0sQ0FBQztJQUNwQixXQUFXLEVBQUUsT0FBTyxDQUFDO0lBRXJCLFlBQVksTUFBTSxFQUFFO1FBQ2xCLE1BQU0sRUFBRSxNQUFNLENBQUM7UUFDZixRQUFRLEVBQUUsTUFBTSxDQUFDO1FBQ2pCLFFBQVEsRUFBRSxNQUFNLENBQUM7UUFDakIsV0FBVyxFQUFFLE1BQU0sQ0FBQztRQUNwQixXQUFXLEVBQUUsT0FBTyxDQUFDO0tBQ3RCLEVBTUE7SUFFRCxPQUFhLE1BQU0sQ0FBQyxFQUFFLEVBQUUsRUFBRSxFQUFFLE1BQU0sRUFBRSxNQUFNLEdBQUcsTUFBTSxHQUFHLE9BQU8sQ0FBQyxNQUFNLENBQUMsQ0FPcEU7SUFFRCxNQUFNLENBQUMsTUFBTSxDQUFDLEtBQUssRUFBRSxNQUFNLEVBQUUsV0FBVyxVQUFPLEdBQUcsY0FBYyxDQWEvRDtDQUNGO0FBRUQ7OztHQUdHO0FBQ0gsTUFBTSxXQUFXLGdCQUFnQjtJQUMvQjs7O09BR0c7SUFDSCxvQkFBb0IsQ0FBQyxTQUFTLEVBQUUsRUFBRSxHQUFHLE9BQU8sQ0FBQyxNQUFNLEdBQUcsU0FBUyxDQUFDLENBQUM7SUFFakU7O09BRUc7SUFDSCxrQkFBa0IsQ0FBQyxJQUFJLEVBQUUsTUFBTSxHQUFHLE9BQU8sQ0FBQyxFQUFFLEdBQUcsU0FBUyxDQUFDLENBQUM7SUFFMUQ7O09BRUc7SUFDSCxhQUFhLENBQUMsRUFBRSxFQUFFLEVBQUUsR0FBRyxNQUFNLENBQUM7Q0FDL0I7QUFFRDs7R0FFRztBQUNILE1BQU0sV0FBVyxvQkFBb0I7SUFDbkMsaURBQWlEO0lBQ2pELFFBQVEsQ0FBQyxZQUFZLEVBQUUsT0FBTyxDQUFDO0lBQy9CLG9GQUFvRjtJQUNwRixRQUFRLENBQUMsZUFBZSxFQUFFLE1BQU0sRUFBRSxDQUFDO0lBQ25DLG9DQUFvQztJQUNwQyxRQUFRLENBQUMsTUFBTSxDQUFDLEVBQUUsTUFBTSxDQUFDO0NBQzFCO0FBRUQ7Ozs7R0FJRztBQUNILE1BQU0sV0FBVyxrQkFBa0I7SUFDakMsUUFBUSxDQUFDLElBQUksRUFBRSxNQUFNLENBQUM7SUFFdEI7Ozs7Ozs7T0FPRztJQUNILEtBQUssQ0FBQyxFQUFFLEVBQUUsRUFBRSxFQUFFLFVBQVUsRUFBRSxnQkFBZ0IsR0FBRyxPQUFPLENBQUMsb0JBQW9CLENBQUMsQ0FBQztJQUUzRTs7O09BR0c7SUFDSCxZQUFZLENBQUMsQ0FBQyxNQUFNLEVBQUUsYUFBYSxHQUFHLElBQUksQ0FBQztDQUM1QyJ9
@@ -1 +1 @@
1
- {"version":3,"file":"eviction_strategy.d.ts","sourceRoot":"","sources":["../../../../src/mem_pools/tx_pool/eviction/eviction_strategy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAEhE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,eAAO,MAAM,aAAa;;;;CAIhB,CAAC;AAEX,KAAK,aAAa,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAExE,MAAM,MAAM,eAAe,GACvB;IACE,KAAK,EAAE,OAAO,aAAa,CAAC,SAAS,CAAC;IACtC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,GACD;IACE,KAAK,EAAE,OAAO,aAAa,CAAC,YAAY,CAAC;IACzC,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IACE,KAAK,EAAE,OAAO,aAAa,CAAC,WAAW,CAAC;IACxC,KAAK,EAAE,WAAW,CAAC;IACnB,aAAa,EAAE,EAAE,EAAE,CAAC;IACpB,cAAc,EAAE,YAAY,EAAE,CAAC;CAChC,CAAC;AAEN;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,EAAE,CAAC;IACd,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,EAAE,CAAC;IACd,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC;IACrD,iBAAiB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAC9C,8BAA8B,CAAC,WAAW,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC/E,yBAAyB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAC9E,mDAAmD;IACnD,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC;;;OAGG;IACH,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7D,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChF;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAEnF;;;OAGG;IACH,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;CAC3C"}
1
+ {"version":3,"file":"eviction_strategy.d.ts","sourceRoot":"","sources":["../../../../src/mem_pools/tx_pool/eviction/eviction_strategy.ts"],"names":[],"mappings":"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"}
@@ -1,5 +1,52 @@
1
+ import { Buffer32 } from '@aztec/foundation/buffer';
2
+ import { ProtocolContractAddress } from '@aztec/protocol-contracts';
3
+ import { TxHash } from '@aztec/stdlib/tx';
4
+ import { getFeePayerBalanceDelta } from '../../../msg_validators/tx_validator/fee_payer_balance.js';
5
+ import { getTxPriorityFee } from '../priority.js';
1
6
  export const EvictionEvent = {
2
7
  TXS_ADDED: 'txs_added',
3
8
  BLOCK_MINED: 'block_mined',
4
9
  CHAIN_PRUNED: 'chain_pruned'
5
10
  };
11
+ /**
12
+ * Balance-related information about a transaction for a fee payer.
13
+ */ export class FeePayerTxInfo {
14
+ txHash;
15
+ priority;
16
+ feeLimit;
17
+ claimAmount;
18
+ isEvictable;
19
+ constructor(fields){
20
+ this.txHash = fields.txHash;
21
+ this.priority = fields.priority;
22
+ this.feeLimit = fields.feeLimit;
23
+ this.claimAmount = fields.claimAmount;
24
+ this.isEvictable = fields.isEvictable;
25
+ }
26
+ static async encode(tx, txHash) {
27
+ const { feeLimit, claimAmount } = await getFeePayerBalanceDelta(tx, ProtocolContractAddress.FeeJuice);
28
+ const priority = Buffer32.fromBigInt(getTxPriorityFee(tx)).toBuffer();
29
+ const hashBuffer = (typeof txHash === 'string' ? TxHash.fromString(txHash) : txHash).toBuffer();
30
+ const feeLimitBuffer = Buffer32.fromBigInt(feeLimit).toBuffer();
31
+ const claimAmountBuffer = Buffer32.fromBigInt(claimAmount).toBuffer();
32
+ return Buffer.concat([
33
+ priority,
34
+ hashBuffer,
35
+ feeLimitBuffer,
36
+ claimAmountBuffer
37
+ ]);
38
+ }
39
+ static decode(value, isEvictable = true) {
40
+ const priority = Buffer32.fromBuffer(value.subarray(0, Buffer32.SIZE)).toBigInt();
41
+ const hashOffset = Buffer32.SIZE;
42
+ const feeLimitOffset = hashOffset + TxHash.SIZE;
43
+ const claimOffset = feeLimitOffset + Buffer32.SIZE;
44
+ return new FeePayerTxInfo({
45
+ txHash: TxHash.fromBuffer(value.subarray(hashOffset, feeLimitOffset)),
46
+ priority,
47
+ feeLimit: Buffer32.fromBuffer(value.subarray(feeLimitOffset, claimOffset)).toBigInt(),
48
+ claimAmount: Buffer32.fromBuffer(value.subarray(claimOffset, claimOffset + Buffer32.SIZE)).toBigInt(),
49
+ isEvictable
50
+ });
51
+ }
52
+ }
@@ -0,0 +1,16 @@
1
+ import type { WorldStateSynchronizer } from '@aztec/stdlib/interfaces/server';
2
+ import type { TxPoolOptions } from '../tx_pool.js';
3
+ import { type EvictionContext, type EvictionResult, type EvictionRule, type TxPoolOperations } from './eviction_strategy.js';
4
+ export declare class FeePayerBalanceEvictionRule implements EvictionRule {
5
+ private worldState;
6
+ readonly name = "FeePayerBalanceEviction";
7
+ readonly reason = "fee_payer_balance";
8
+ private log;
9
+ constructor(worldState: WorldStateSynchronizer);
10
+ evict(context: EvictionContext, txPool: TxPoolOperations): Promise<EvictionResult>;
11
+ updateConfig(_config: TxPoolOptions): void;
12
+ private evictForFeePayers;
13
+ private getEvictionsForFeePayer;
14
+ private createPublicStateSource;
15
+ }
16
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmVlX3BheWVyX2JhbGFuY2VfZXZpY3Rpb25fcnVsZS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL21lbV9wb29scy90eF9wb29sL2V2aWN0aW9uL2ZlZV9wYXllcl9iYWxhbmNlX2V2aWN0aW9uX3J1bGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBSUEsT0FBTyxLQUFLLEVBQUUsc0JBQXNCLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUk5RSxPQUFPLEtBQUssRUFBRSxhQUFhLEVBQUUsTUFBTSxlQUFlLENBQUM7QUFDbkQsT0FBTyxFQUNMLEtBQUssZUFBZSxFQUVwQixLQUFLLGNBQWMsRUFDbkIsS0FBSyxZQUFZLEVBRWpCLEtBQUssZ0JBQWdCLEVBQ3RCLE1BQU0sd0JBQXdCLENBQUM7QUFFaEMscUJBQWEsMkJBQTRCLFlBQVcsWUFBWTtJQU1sRCxPQUFPLENBQUMsVUFBVTtJQUw5QixTQUFnQixJQUFJLDZCQUE2QjtJQUNqRCxTQUFnQixNQUFNLHVCQUF1QjtJQUU3QyxPQUFPLENBQUMsR0FBRyxDQUF1RTtJQUVsRixZQUFvQixVQUFVLEVBQUUsc0JBQXNCLEVBQUk7SUFFcEQsS0FBSyxDQUFDLE9BQU8sRUFBRSxlQUFlLEVBQUUsTUFBTSxFQUFFLGdCQUFnQixHQUFHLE9BQU8sQ0FBQyxjQUFjLENBQUMsQ0E4Q3ZGO0lBRUQsWUFBWSxDQUFDLE9BQU8sRUFBRSxhQUFhLEdBQUcsSUFBSSxDQUFHO1lBRS9CLGlCQUFpQjtZQXNCakIsdUJBQXVCO0lBNERyQyxPQUFPLENBQUMsdUJBQXVCO0NBR2hDIn0=
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fee_payer_balance_eviction_rule.d.ts","sourceRoot":"","sources":["../../../../src/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAI9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EACL,KAAK,eAAe,EAEpB,KAAK,cAAc,EACnB,KAAK,YAAY,EAEjB,KAAK,gBAAgB,EACtB,MAAM,wBAAwB,CAAC;AAEhC,qBAAa,2BAA4B,YAAW,YAAY;IAMlD,OAAO,CAAC,UAAU;IAL9B,SAAgB,IAAI,6BAA6B;IACjD,SAAgB,MAAM,uBAAuB;IAE7C,OAAO,CAAC,GAAG,CAAuE;IAElF,YAAoB,UAAU,EAAE,sBAAsB,EAAI;IAEpD,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CA8CvF;IAED,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAG;YAE/B,iBAAiB;YAsBjB,uBAAuB;IA4DrC,OAAO,CAAC,uBAAuB;CAGhC"}
@@ -0,0 +1,122 @@
1
+ import { createLogger } from '@aztec/foundation/log';
2
+ import { ProtocolContractAddress } from '@aztec/protocol-contracts';
3
+ import { computeFeePayerBalanceStorageSlot } from '@aztec/protocol-contracts/fee-juice';
4
+ import { DatabasePublicStateSource } from '@aztec/stdlib/trees';
5
+ import { EvictionEvent } from './eviction_strategy.js';
6
+ export class FeePayerBalanceEvictionRule {
7
+ worldState;
8
+ name;
9
+ reason;
10
+ log;
11
+ constructor(worldState){
12
+ this.worldState = worldState;
13
+ this.name = 'FeePayerBalanceEviction';
14
+ this.reason = 'fee_payer_balance';
15
+ this.log = createLogger('p2p:mempool:tx_pool:fee_payer_balance_eviction_rule');
16
+ }
17
+ async evict(context, txPool) {
18
+ try {
19
+ if (context.event === EvictionEvent.TXS_ADDED) {
20
+ return await this.evictForFeePayers(context.feePayers, this.worldState.getCommitted(), txPool);
21
+ }
22
+ if (context.event === EvictionEvent.BLOCK_MINED) {
23
+ const blockNumber = context.block.getBlockNumber();
24
+ // Ensure world state is synced to this block before accessing the snapshot.
25
+ // This handles the race where a block is added to the archiver
26
+ // but the world state hasn't synced it yet.
27
+ await this.worldState.syncImmediate(blockNumber);
28
+ return await this.evictForFeePayers(context.feePayers, this.worldState.getSnapshot(blockNumber), txPool);
29
+ }
30
+ // TODO: fix this edge-case
31
+ // This can lead to a race condition if we are catching up in the p2p client.
32
+ // Let's say we have 3 txs for the same fee payer, which get mined in blocks 1, 2, 3.
33
+ // Tx1 consumes fee juice, tx2 increases it, tx3 consumes it again. We see block1 with tx1 first, run this rule, and evict tx3.
34
+ // But tx3 was valid (due to tx2) and mined on block3. And we have just removed from the mempool a tx we needed for proving/reexec.
35
+ //
36
+ // NOTE: this will happen only in case of that lower-priority-fee tx entered in e.g. block 2, and we have higher-priority-fee tx in block 3
37
+ // (simply because that was the timing of these txs). But, in case of higher-priority-fee txs being in block 2, the tx3 won't be evicted
38
+ // -----
39
+ // Proposed fix: evict only if node is synched
40
+ if (context.event === EvictionEvent.CHAIN_PRUNED) {
41
+ // Ensure world state is synced to this block before accessing the snapshot.
42
+ await this.worldState.syncImmediate(context.blockNumber);
43
+ const feePayers = await txPool.getPendingFeePayers();
44
+ return await this.evictForFeePayers(feePayers, this.worldState.getSnapshot(context.blockNumber), txPool);
45
+ }
46
+ return {
47
+ reason: this.reason,
48
+ success: true,
49
+ txsEvicted: []
50
+ };
51
+ } catch (err) {
52
+ this.log.error('Failed to evict txs due to fee payer balance', {
53
+ err
54
+ });
55
+ return {
56
+ reason: this.reason,
57
+ success: false,
58
+ txsEvicted: [],
59
+ error: new Error('Failed to evict txs due to fee payer balance', {
60
+ cause: err
61
+ })
62
+ };
63
+ }
64
+ }
65
+ updateConfig(_config) {}
66
+ async evictForFeePayers(feePayers, db, txPool) {
67
+ const publicStateSource = this.createPublicStateSource(db);
68
+ const txsToEvict = (await Promise.all(feePayers.map((feePayer)=>this.getEvictionsForFeePayer(feePayer, publicStateSource, txPool)))).flat();
69
+ if (txsToEvict.length > 0) {
70
+ await txPool.deleteTxs(txsToEvict);
71
+ }
72
+ return {
73
+ reason: this.reason,
74
+ success: true,
75
+ txsEvicted: txsToEvict
76
+ };
77
+ }
78
+ async getEvictionsForFeePayer(feePayer, publicStateSource, txPool) {
79
+ const initialBalance = (await publicStateSource.storageRead(ProtocolContractAddress.FeeJuice, //TODO: cache this LRU-style
80
+ await computeFeePayerBalanceStorageSlot(feePayer))).toBigInt();
81
+ const txs = [];
82
+ for await (const entry of txPool.getFeePayerTxInfos(feePayer)){
83
+ txs.push(entry);
84
+ }
85
+ if (txs.length === 0) {
86
+ return [];
87
+ }
88
+ const txsToEvict = [];
89
+ let balance = initialBalance;
90
+ let hasNonEvictableOverBalance = false;
91
+ // Evaluate balance in priority order so later claims cannot fund earlier spends.
92
+ // This sorts so that higher priority txs come first.
93
+ txs.sort((a, b)=>{
94
+ if (a.priority === b.priority) {
95
+ return a.txHash.toBigInt() >= b.txHash.toBigInt() ? -1 : 1;
96
+ }
97
+ return a.priority > b.priority ? -1 : 1;
98
+ });
99
+ for (const tx of txs){
100
+ const available = balance + tx.claimAmount;
101
+ if (available >= tx.feeLimit) {
102
+ balance = available - tx.feeLimit;
103
+ continue;
104
+ }
105
+ if (tx.isEvictable) {
106
+ txsToEvict.push(tx.txHash);
107
+ } else {
108
+ hasNonEvictableOverBalance = true;
109
+ }
110
+ }
111
+ if (hasNonEvictableOverBalance) {
112
+ this.log.verbose('Fee payer balance cannot be satisfied due to non-evictable txs', {
113
+ feePayer: feePayer.toString(),
114
+ balance: initialBalance
115
+ });
116
+ }
117
+ return txsToEvict;
118
+ }
119
+ createPublicStateSource(db) {
120
+ return new DatabasePublicStateSource(db);
121
+ }
122
+ }
@@ -9,9 +9,9 @@ import { type EvictionContext, type EvictionResult, type EvictionRule, type TxPo
9
9
  * - Transactions with an expiration timestamp less than or equal to the mined block timestamp
10
10
  */
11
11
  export declare class InvalidTxsAfterMiningRule implements EvictionRule {
12
- readonly name: string;
12
+ readonly name = "InvalidTxsAfterMining";
13
13
  private log;
14
14
  evict(context: EvictionContext, txPool: TxPoolOperations): Promise<EvictionResult>;
15
15
  updateConfig(_config: TxPoolOptions): void;
16
16
  }
17
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW52YWxpZF90eHNfYWZ0ZXJfbWluaW5nX3J1bGUuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9tZW1fcG9vbHMvdHhfcG9vbC9ldmljdGlvbi9pbnZhbGlkX3R4c19hZnRlcl9taW5pbmdfcnVsZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFHQSxPQUFPLEtBQUssRUFBRSxhQUFhLEVBQUUsTUFBTSxlQUFlLENBQUM7QUFDbkQsT0FBTyxFQUNMLEtBQUssZUFBZSxFQUVwQixLQUFLLGNBQWMsRUFDbkIsS0FBSyxZQUFZLEVBQ2pCLEtBQUssZ0JBQWdCLEVBQ3RCLE1BQU0sd0JBQXdCLENBQUM7QUFFaEM7Ozs7Ozs7R0FPRztBQUNILHFCQUFhLHlCQUEwQixZQUFXLFlBQVk7SUFDNUQsU0FBZ0IsSUFBSSxTQUEyQjtJQUUvQyxPQUFPLENBQUMsR0FBRyxDQUFxRTtJQUUxRSxLQUFLLENBQUMsT0FBTyxFQUFFLGVBQWUsRUFBRSxNQUFNLEVBQUUsZ0JBQWdCLEdBQUcsT0FBTyxDQUFDLGNBQWMsQ0FBQyxDQTJFdkY7SUFFRCxZQUFZLENBQUMsT0FBTyxFQUFFLGFBQWEsR0FBRyxJQUFJLENBQUc7Q0FDOUMifQ==
17
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW52YWxpZF90eHNfYWZ0ZXJfbWluaW5nX3J1bGUuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9tZW1fcG9vbHMvdHhfcG9vbC9ldmljdGlvbi9pbnZhbGlkX3R4c19hZnRlcl9taW5pbmdfcnVsZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFHQSxPQUFPLEtBQUssRUFBRSxhQUFhLEVBQUUsTUFBTSxlQUFlLENBQUM7QUFDbkQsT0FBTyxFQUNMLEtBQUssZUFBZSxFQUVwQixLQUFLLGNBQWMsRUFDbkIsS0FBSyxZQUFZLEVBQ2pCLEtBQUssZ0JBQWdCLEVBQ3RCLE1BQU0sd0JBQXdCLENBQUM7QUFFaEM7Ozs7Ozs7R0FPRztBQUNILHFCQUFhLHlCQUEwQixZQUFXLFlBQVk7SUFDNUQsU0FBZ0IsSUFBSSwyQkFBMkI7SUFFL0MsT0FBTyxDQUFDLEdBQUcsQ0FBcUU7SUFFMUUsS0FBSyxDQUFDLE9BQU8sRUFBRSxlQUFlLEVBQUUsTUFBTSxFQUFFLGdCQUFnQixHQUFHLE9BQU8sQ0FBQyxjQUFjLENBQUMsQ0EyRXZGO0lBRUQsWUFBWSxDQUFDLE9BQU8sRUFBRSxhQUFhLEdBQUcsSUFBSSxDQUFHO0NBQzlDIn0=
@@ -1 +1 @@
1
- {"version":3,"file":"invalid_txs_after_mining_rule.d.ts","sourceRoot":"","sources":["../../../../src/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EACL,KAAK,eAAe,EAEpB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACtB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;GAOG;AACH,qBAAa,yBAA0B,YAAW,YAAY;IAC5D,SAAgB,IAAI,SAA2B;IAE/C,OAAO,CAAC,GAAG,CAAqE;IAE1E,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CA2EvF;IAED,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAG;CAC9C"}
1
+ {"version":3,"file":"invalid_txs_after_mining_rule.d.ts","sourceRoot":"","sources":["../../../../src/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EACL,KAAK,eAAe,EAEpB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACtB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;GAOG;AACH,qBAAa,yBAA0B,YAAW,YAAY;IAC5D,SAAgB,IAAI,2BAA2B;IAE/C,OAAO,CAAC,GAAG,CAAqE;IAE1E,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CA2EvF;IAED,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAG;CAC9C"}
@@ -50,9 +50,9 @@ import { EvictionEvent } from './eviction_strategy.js';
50
50
  continue;
51
51
  }
52
52
  // Evict pending txs with an expiration timestamp less than or equal to the mined block timestamp
53
- const includeByTimestamp = tx.data.includeByTimestamp;
54
- if (includeByTimestamp <= timestamp) {
55
- this.log.verbose(`Evicting tx ${txHash} from pool due to the tx being expired (includeByTimestamp: ${includeByTimestamp}, mined block timestamp: ${timestamp})`);
53
+ const expirationTimestamp = tx.data.expirationTimestamp;
54
+ if (expirationTimestamp <= timestamp) {
55
+ this.log.verbose(`Evicting tx ${txHash} from pool due to the tx being expired (expirationTimestamp: ${expirationTimestamp}, mined block timestamp: ${timestamp})`);
56
56
  txsToEvict.push(txHash);
57
57
  continue;
58
58
  }
@@ -1,4 +1,4 @@
1
- import type { ReadonlyWorldStateAccess } from '@aztec/stdlib/interfaces/server';
1
+ import type { WorldStateSynchronizer } from '@aztec/stdlib/interfaces/server';
2
2
  import type { TxPoolOptions } from '../tx_pool.js';
3
3
  import { type EvictionContext, type EvictionResult, type EvictionRule, type TxPoolOperations } from './eviction_strategy.js';
4
4
  /**
@@ -10,10 +10,10 @@ import { type EvictionContext, type EvictionResult, type EvictionRule, type TxPo
10
10
  */
11
11
  export declare class InvalidTxsAfterReorgRule implements EvictionRule {
12
12
  private worldState;
13
- readonly name: string;
13
+ readonly name = "InvalidTxsAfterReorg";
14
14
  private log;
15
- constructor(worldState: ReadonlyWorldStateAccess);
15
+ constructor(worldState: WorldStateSynchronizer);
16
16
  evict(context: EvictionContext, txPool: TxPoolOperations): Promise<EvictionResult>;
17
17
  updateConfig(_config: TxPoolOptions): void;
18
18
  }
19
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW52YWxpZF90eHNfYWZ0ZXJfcmVvcmdfcnVsZS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL21lbV9wb29scy90eF9wb29sL2V2aWN0aW9uL2ludmFsaWRfdHhzX2FmdGVyX3Jlb3JnX3J1bGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBR0EsT0FBTyxLQUFLLEVBQUUsd0JBQXdCLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUloRixPQUFPLEtBQUssRUFBRSxhQUFhLEVBQUUsTUFBTSxlQUFlLENBQUM7QUFDbkQsT0FBTyxFQUNMLEtBQUssZUFBZSxFQUVwQixLQUFLLGNBQWMsRUFDbkIsS0FBSyxZQUFZLEVBQ2pCLEtBQUssZ0JBQWdCLEVBQ3RCLE1BQU0sd0JBQXdCLENBQUM7QUFFaEM7Ozs7OztHQU1HO0FBQ0gscUJBQWEsd0JBQXlCLFlBQVcsWUFBWTtJQUt4QyxPQUFPLENBQUMsVUFBVTtJQUpyQyxTQUFnQixJQUFJLFNBQTBCO0lBRTlDLE9BQU8sQ0FBQyxHQUFHLENBQW9FO0lBRS9FLFlBQTJCLFVBQVUsRUFBRSx3QkFBd0IsRUFBSTtJQUU3RCxLQUFLLENBQUMsT0FBTyxFQUFFLGVBQWUsRUFBRSxNQUFNLEVBQUUsZ0JBQWdCLEdBQUcsT0FBTyxDQUFDLGNBQWMsQ0FBQyxDQXlEdkY7SUFFRCxZQUFZLENBQUMsT0FBTyxFQUFFLGFBQWEsR0FBRyxJQUFJLENBQUc7Q0FDOUMifQ==
19
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW52YWxpZF90eHNfYWZ0ZXJfcmVvcmdfcnVsZS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL21lbV9wb29scy90eF9wb29sL2V2aWN0aW9uL2ludmFsaWRfdHhzX2FmdGVyX3Jlb3JnX3J1bGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBR0EsT0FBTyxLQUFLLEVBQUUsc0JBQXNCLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUk5RSxPQUFPLEtBQUssRUFBRSxhQUFhLEVBQUUsTUFBTSxlQUFlLENBQUM7QUFDbkQsT0FBTyxFQUNMLEtBQUssZUFBZSxFQUVwQixLQUFLLGNBQWMsRUFDbkIsS0FBSyxZQUFZLEVBQ2pCLEtBQUssZ0JBQWdCLEVBQ3RCLE1BQU0sd0JBQXdCLENBQUM7QUFFaEM7Ozs7OztHQU1HO0FBQ0gscUJBQWEsd0JBQXlCLFlBQVcsWUFBWTtJQUt4QyxPQUFPLENBQUMsVUFBVTtJQUpyQyxTQUFnQixJQUFJLDBCQUEwQjtJQUU5QyxPQUFPLENBQUMsR0FBRyxDQUFvRTtJQUUvRSxZQUEyQixVQUFVLEVBQUUsc0JBQXNCLEVBQUk7SUFFM0QsS0FBSyxDQUFDLE9BQU8sRUFBRSxlQUFlLEVBQUUsTUFBTSxFQUFFLGdCQUFnQixHQUFHLE9BQU8sQ0FBQyxjQUFjLENBQUMsQ0EyRHZGO0lBRUQsWUFBWSxDQUFDLE9BQU8sRUFBRSxhQUFhLEdBQUcsSUFBSSxDQUFHO0NBQzlDIn0=
@@ -1 +1 @@
1
- {"version":3,"file":"invalid_txs_after_reorg_rule.d.ts","sourceRoot":"","sources":["../../../../src/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAIhF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EACL,KAAK,eAAe,EAEpB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACtB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;GAMG;AACH,qBAAa,wBAAyB,YAAW,YAAY;IAKxC,OAAO,CAAC,UAAU;IAJrC,SAAgB,IAAI,SAA0B;IAE9C,OAAO,CAAC,GAAG,CAAoE;IAE/E,YAA2B,UAAU,EAAE,wBAAwB,EAAI;IAE7D,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CAyDvF;IAED,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAG;CAC9C"}
1
+ {"version":3,"file":"invalid_txs_after_reorg_rule.d.ts","sourceRoot":"","sources":["../../../../src/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAI9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EACL,KAAK,eAAe,EAEpB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACtB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;GAMG;AACH,qBAAa,wBAAyB,YAAW,YAAY;IAKxC,OAAO,CAAC,UAAU;IAJrC,SAAgB,IAAI,0BAA0B;IAE9C,OAAO,CAAC,GAAG,CAAoE;IAE/E,YAA2B,UAAU,EAAE,sBAAsB,EAAI;IAE3D,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CA2DvF;IAED,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAG;CAC9C"}
@@ -33,6 +33,8 @@ import { EvictionEvent } from './eviction_strategy.js';
33
33
  candidateTxs.forEach(({ blockHash })=>{
34
34
  insertIntoSortedArray(uniqueBlockHashes, blockHash, Fr.cmp, false);
35
35
  });
36
+ // Ensure world state is synced to this block before accessing the snapshot.
37
+ await this.worldState.syncImmediate(context.blockNumber);
36
38
  const db = this.worldState.getSnapshot(context.blockNumber);
37
39
  const blocksFromDb = await db.findLeafIndices(MerkleTreeId.ARCHIVE, uniqueBlockHashes);
38
40
  // Identify txs whose blockHash is not found in the archive (pruned)
@@ -10,7 +10,7 @@ export interface LowPriorityEvictionConfig {
10
10
  */
11
11
  export declare class LowPriorityEvictionRule implements EvictionRule {
12
12
  private config;
13
- readonly name: string;
13
+ readonly name = "LowPriorityEviction";
14
14
  private log;
15
15
  constructor(config: LowPriorityEvictionConfig);
16
16
  evict(context: EvictionContext, txPool: TxPoolOperations): Promise<EvictionResult>;
@@ -23,4 +23,4 @@ export declare class LowPriorityEvictionRule implements EvictionRule {
23
23
  */
24
24
  getConfig(): LowPriorityEvictionConfig;
25
25
  }
26
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG93X3ByaW9yaXR5X2V2aWN0aW9uX3J1bGUuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9tZW1fcG9vbHMvdHhfcG9vbC9ldmljdGlvbi9sb3dfcHJpb3JpdHlfZXZpY3Rpb25fcnVsZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFHQSxPQUFPLEtBQUssRUFBRSxhQUFhLEVBQUUsTUFBTSxlQUFlLENBQUM7QUFDbkQsT0FBTyxFQUNMLEtBQUssZUFBZSxFQUVwQixLQUFLLGNBQWMsRUFDbkIsS0FBSyxZQUFZLEVBQ2pCLEtBQUssZ0JBQWdCLEVBQ3RCLE1BQU0sd0JBQXdCLENBQUM7QUFFaEMsTUFBTSxXQUFXLHlCQUF5QjtJQUN4QyxzRUFBc0U7SUFDdEUsV0FBVyxFQUFFLE1BQU0sQ0FBQztDQUNyQjtBQUVEOzs7R0FHRztBQUNILHFCQUFhLHVCQUF3QixZQUFXLFlBQVk7SUFLOUMsT0FBTyxDQUFDLE1BQU07SUFKMUIsU0FBZ0IsSUFBSSxTQUF5QjtJQUU3QyxPQUFPLENBQUMsR0FBRyxDQUFrRTtJQUU3RSxZQUFvQixNQUFNLEVBQUUseUJBQXlCLEVBQUk7SUFFNUMsS0FBSyxDQUFDLE9BQU8sRUFBRSxlQUFlLEVBQUUsTUFBTSxFQUFFLGdCQUFnQixHQUFHLE9BQU8sQ0FBQyxjQUFjLENBQUMsQ0E0RDlGO0lBRUQ7O09BRUc7SUFDSCxZQUFZLENBQUMsTUFBTSxFQUFFLGFBQWEsR0FBRyxJQUFJLENBSXhDO0lBRUQ7O09BRUc7SUFDSCxTQUFTLElBQUkseUJBQXlCLENBRXJDO0NBQ0YifQ==
26
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG93X3ByaW9yaXR5X2V2aWN0aW9uX3J1bGUuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9tZW1fcG9vbHMvdHhfcG9vbC9ldmljdGlvbi9sb3dfcHJpb3JpdHlfZXZpY3Rpb25fcnVsZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFHQSxPQUFPLEtBQUssRUFBRSxhQUFhLEVBQUUsTUFBTSxlQUFlLENBQUM7QUFDbkQsT0FBTyxFQUNMLEtBQUssZUFBZSxFQUVwQixLQUFLLGNBQWMsRUFDbkIsS0FBSyxZQUFZLEVBQ2pCLEtBQUssZ0JBQWdCLEVBQ3RCLE1BQU0sd0JBQXdCLENBQUM7QUFFaEMsTUFBTSxXQUFXLHlCQUF5QjtJQUN4QyxzRUFBc0U7SUFDdEUsV0FBVyxFQUFFLE1BQU0sQ0FBQztDQUNyQjtBQUVEOzs7R0FHRztBQUNILHFCQUFhLHVCQUF3QixZQUFXLFlBQVk7SUFLOUMsT0FBTyxDQUFDLE1BQU07SUFKMUIsU0FBZ0IsSUFBSSx5QkFBeUI7SUFFN0MsT0FBTyxDQUFDLEdBQUcsQ0FBa0U7SUFFN0UsWUFBb0IsTUFBTSxFQUFFLHlCQUF5QixFQUFJO0lBRTVDLEtBQUssQ0FBQyxPQUFPLEVBQUUsZUFBZSxFQUFFLE1BQU0sRUFBRSxnQkFBZ0IsR0FBRyxPQUFPLENBQUMsY0FBYyxDQUFDLENBNEQ5RjtJQUVEOztPQUVHO0lBQ0gsWUFBWSxDQUFDLE1BQU0sRUFBRSxhQUFhLEdBQUcsSUFBSSxDQUl4QztJQUVEOztPQUVHO0lBQ0gsU0FBUyxJQUFJLHlCQUF5QixDQUVyQztDQUNGIn0=
@@ -1 +1 @@
1
- {"version":3,"file":"low_priority_eviction_rule.d.ts","sourceRoot":"","sources":["../../../../src/mem_pools/tx_pool/eviction/low_priority_eviction_rule.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EACL,KAAK,eAAe,EAEpB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACtB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,yBAAyB;IACxC,sEAAsE;IACtE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,YAAY;IAK9C,OAAO,CAAC,MAAM;IAJ1B,SAAgB,IAAI,SAAyB;IAE7C,OAAO,CAAC,GAAG,CAAkE;IAE7E,YAAoB,MAAM,EAAE,yBAAyB,EAAI;IAE5C,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CA4D9F;IAED;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAIxC;IAED;;OAEG;IACH,SAAS,IAAI,yBAAyB,CAErC;CACF"}
1
+ {"version":3,"file":"low_priority_eviction_rule.d.ts","sourceRoot":"","sources":["../../../../src/mem_pools/tx_pool/eviction/low_priority_eviction_rule.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EACL,KAAK,eAAe,EAEpB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACtB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,yBAAyB;IACxC,sEAAsE;IACtE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,YAAY;IAK9C,OAAO,CAAC,MAAM;IAJ1B,SAAgB,IAAI,yBAAyB;IAE7C,OAAO,CAAC,GAAG,CAAkE;IAE7E,YAAoB,MAAM,EAAE,yBAAyB,EAAI;IAE5C,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CA4D9F;IAED;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAIxC;IAED;;OAEG;IACH,SAAS,IAAI,yBAAyB,CAErC;CACF"}
@@ -0,0 +1,25 @@
1
+ import { type Tx } from '@aztec/stdlib/tx';
2
+ import type { PreAddEvictionResult, PreAddEvictionRule, PreAddPoolAccess } from './eviction_strategy.js';
3
+ /**
4
+ * Pre-add eviction rule that checks for nullifier conflicts between incoming and existing transactions.
5
+ *
6
+ * When an incoming tx shares nullifiers with existing pending txs:
7
+ * - If the incoming tx has strictly higher priority fee, evict all conflicting txs
8
+ * - If any conflicting tx has equal or higher priority fee, reject the incoming tx
9
+ *
10
+ * This prevents nullifier spam attacks where an attacker floods the mempool with
11
+ * transactions spending the same nullifiers.
12
+ */
13
+ export declare class NullifierConflictPreAddRule implements PreAddEvictionRule {
14
+ readonly name = "NullifierConflictPreAdd";
15
+ private log;
16
+ /**
17
+ * Check if the incoming transaction conflicts with existing transactions via nullifiers.
18
+ *
19
+ * @param tx - The incoming transaction
20
+ * @param poolAccess - Read-only access to pool state
21
+ * @returns Result with rejection status and txs to evict
22
+ */
23
+ check(tx: Tx, poolAccess: PreAddPoolAccess): Promise<PreAddEvictionResult>;
24
+ }
25
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibnVsbGlmaWVyX2NvbmZsaWN0X3ByZV9hZGRfcnVsZS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL21lbV9wb29scy90eF9wb29sL2V2aWN0aW9uL251bGxpZmllcl9jb25mbGljdF9wcmVfYWRkX3J1bGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBR0EsT0FBTyxFQUFFLEtBQUssRUFBRSxFQUFVLE1BQU0sa0JBQWtCLENBQUM7QUFFbkQsT0FBTyxLQUFLLEVBQUUsb0JBQW9CLEVBQUUsa0JBQWtCLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUl6Rzs7Ozs7Ozs7O0dBU0c7QUFDSCxxQkFBYSwyQkFBNEIsWUFBVyxrQkFBa0I7SUFDcEUsU0FBZ0IsSUFBSSw2QkFBNkI7SUFFakQsT0FBTyxDQUFDLEdBQUcsQ0FBdUU7SUFFbEY7Ozs7OztPQU1HO0lBQ0csS0FBSyxDQUFDLEVBQUUsRUFBRSxFQUFFLEVBQUUsVUFBVSxFQUFFLGdCQUFnQixHQUFHLE9BQU8sQ0FBQyxvQkFBb0IsQ0FBQyxDQTBDL0U7Q0FDRiJ9
@@ -0,0 +1 @@
1
+ {"version":3,"file":"nullifier_conflict_pre_add_rule.d.ts","sourceRoot":"","sources":["../../../../src/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,EAAU,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAIzG;;;;;;;;;GASG;AACH,qBAAa,2BAA4B,YAAW,kBAAkB;IACpE,SAAgB,IAAI,6BAA6B;IAEjD,OAAO,CAAC,GAAG,CAAuE;IAElF;;;;;;OAMG;IACG,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,gBAAgB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA0C/E;CACF"}
@@ -0,0 +1,57 @@
1
+ import { findIndexInSortedArray, insertIntoSortedArray } from '@aztec/foundation/array';
2
+ import { Fr } from '@aztec/foundation/curves/bn254';
3
+ import { createLogger } from '@aztec/foundation/log';
4
+ const cmpTxHash = (a, b)=>Fr.cmp(a.hash, b.hash);
5
+ /**
6
+ * Pre-add eviction rule that checks for nullifier conflicts between incoming and existing transactions.
7
+ *
8
+ * When an incoming tx shares nullifiers with existing pending txs:
9
+ * - If the incoming tx has strictly higher priority fee, evict all conflicting txs
10
+ * - If any conflicting tx has equal or higher priority fee, reject the incoming tx
11
+ *
12
+ * This prevents nullifier spam attacks where an attacker floods the mempool with
13
+ * transactions spending the same nullifiers.
14
+ */ export class NullifierConflictPreAddRule {
15
+ name = 'NullifierConflictPreAdd';
16
+ log = createLogger('p2p:mempool:tx_pool:nullifier_conflict_pre_add_rule');
17
+ /**
18
+ * Check if the incoming transaction conflicts with existing transactions via nullifiers.
19
+ *
20
+ * @param tx - The incoming transaction
21
+ * @param poolAccess - Read-only access to pool state
22
+ * @returns Result with rejection status and txs to evict
23
+ */ async check(tx, poolAccess) {
24
+ const txHash = tx.getTxHash();
25
+ const nullifiers = tx.data.getNonEmptyNullifiers();
26
+ const txHashesToEvict = [];
27
+ const incomingPriority = poolAccess.getTxPriority(tx);
28
+ for (const nullifier of nullifiers){
29
+ const conflictingHash = await poolAccess.getTxHashByNullifier(nullifier);
30
+ if (!conflictingHash || conflictingHash.equals(txHash) || findIndexInSortedArray(txHashesToEvict, conflictingHash, cmpTxHash) !== -1) {
31
+ continue;
32
+ }
33
+ // Get the conflicting tx's priority
34
+ const conflictingTx = await poolAccess.getPendingTxByHash(conflictingHash);
35
+ if (!conflictingTx) {
36
+ continue;
37
+ }
38
+ const conflictingPriority = poolAccess.getTxPriority(conflictingTx);
39
+ // If incoming tx has strictly higher priority, mark for eviction
40
+ // Otherwise, reject incoming tx (ties go to existing tx)
41
+ if (incomingPriority > conflictingPriority) {
42
+ insertIntoSortedArray(txHashesToEvict, conflictingHash, cmpTxHash);
43
+ } else {
44
+ this.log.debug(`Rejecting tx ${txHash.toString()}: nullifier conflict with ${conflictingHash.toString()} which has higher or equal fee`);
45
+ return {
46
+ shouldReject: true,
47
+ txHashesToEvict: [],
48
+ reason: `nullifier conflict with ${conflictingHash.toString()}`
49
+ };
50
+ }
51
+ }
52
+ return {
53
+ shouldReject: false,
54
+ txHashesToEvict
55
+ };
56
+ }
57
+ }
@@ -0,0 +1,2 @@
1
+ export { TxArchive } from './tx_archive.js';
2
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9tZW1fcG9vbHMvdHhfcG9vbF92Mi9hcmNoaXZlL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxTQUFTLEVBQUUsTUFBTSxpQkFBaUIsQ0FBQyJ9
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mem_pools/tx_pool_v2/archive/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}