@aztec/p2p 0.0.1-commit.ee80a48 → 0.0.1-commit.ef17749e1

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 (398) 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 +41 -14
  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 +41 -51
  7. package/dest/client/p2p_client.d.ts.map +1 -1
  8. package/dest/client/p2p_client.js +149 -224
  9. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker.js +7 -8
  10. package/dest/config.d.ts +48 -17
  11. package/dest/config.d.ts.map +1 -1
  12. package/dest/config.js +85 -39
  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_v2/archive/index.d.ts +2 -0
  41. package/dest/mem_pools/tx_pool_v2/archive/index.d.ts.map +1 -0
  42. package/dest/mem_pools/tx_pool_v2/archive/index.js +1 -0
  43. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.d.ts +43 -0
  44. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.d.ts.map +1 -0
  45. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.js +103 -0
  46. package/dest/mem_pools/tx_pool_v2/deleted_pool.d.ts +104 -0
  47. package/dest/mem_pools/tx_pool_v2/deleted_pool.d.ts.map +1 -0
  48. package/dest/mem_pools/tx_pool_v2/deleted_pool.js +251 -0
  49. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.d.ts +47 -0
  50. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.d.ts.map +1 -0
  51. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.js +128 -0
  52. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.d.ts +17 -0
  53. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.d.ts.map +1 -0
  54. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.js +93 -0
  55. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.d.ts +19 -0
  56. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.d.ts.map +1 -0
  57. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.js +97 -0
  58. package/dest/mem_pools/tx_pool_v2/eviction/index.d.ts +10 -0
  59. package/dest/mem_pools/tx_pool_v2/eviction/index.d.ts.map +1 -0
  60. package/dest/mem_pools/tx_pool_v2/eviction/index.js +11 -0
  61. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.d.ts +180 -0
  62. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.d.ts.map +1 -0
  63. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.js +25 -0
  64. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.d.ts +15 -0
  65. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.d.ts.map +1 -0
  66. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.js +65 -0
  67. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.d.ts +17 -0
  68. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.d.ts.map +1 -0
  69. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.js +93 -0
  70. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.d.ts +16 -0
  71. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.d.ts.map +1 -0
  72. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.js +78 -0
  73. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.d.ts +20 -0
  74. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.d.ts.map +1 -0
  75. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.js +75 -0
  76. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.d.ts +15 -0
  77. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.d.ts.map +1 -0
  78. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.js +19 -0
  79. package/dest/mem_pools/tx_pool_v2/index.d.ts +6 -0
  80. package/dest/mem_pools/tx_pool_v2/index.d.ts.map +1 -0
  81. package/dest/mem_pools/tx_pool_v2/index.js +5 -0
  82. package/dest/mem_pools/tx_pool_v2/instrumentation.d.ts +15 -0
  83. package/dest/mem_pools/tx_pool_v2/instrumentation.d.ts.map +1 -0
  84. package/dest/mem_pools/tx_pool_v2/instrumentation.js +43 -0
  85. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts +213 -0
  86. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts.map +1 -0
  87. package/dest/mem_pools/tx_pool_v2/interfaces.js +10 -0
  88. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts +127 -0
  89. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts.map +1 -0
  90. package/dest/mem_pools/tx_pool_v2/tx_metadata.js +210 -0
  91. package/dest/mem_pools/tx_pool_v2/tx_pool_bench_metrics.d.ts +26 -0
  92. package/dest/mem_pools/tx_pool_v2/tx_pool_bench_metrics.d.ts.map +1 -0
  93. package/dest/mem_pools/tx_pool_v2/tx_pool_bench_metrics.js +70 -0
  94. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.d.ts +108 -0
  95. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.d.ts.map +1 -0
  96. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.js +337 -0
  97. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts +60 -0
  98. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts.map +1 -0
  99. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.js +164 -0
  100. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts +78 -0
  101. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts.map +1 -0
  102. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.js +909 -0
  103. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts +3 -3
  104. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts.map +1 -1
  105. package/dest/msg_validators/proposal_validator/block_proposal_validator.d.ts +6 -4
  106. package/dest/msg_validators/proposal_validator/block_proposal_validator.d.ts.map +1 -1
  107. package/dest/msg_validators/proposal_validator/block_proposal_validator.js +10 -2
  108. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.d.ts +6 -4
  109. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.d.ts.map +1 -1
  110. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.js +16 -2
  111. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts +13 -8
  112. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts.map +1 -1
  113. package/dest/msg_validators/proposal_validator/proposal_validator.js +48 -36
  114. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts +4 -4
  115. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts.map +1 -1
  116. package/dest/msg_validators/tx_validator/aggregate_tx_validator.js +3 -3
  117. package/dest/msg_validators/tx_validator/allowed_public_setup.d.ts +2 -1
  118. package/dest/msg_validators/tx_validator/allowed_public_setup.d.ts.map +1 -1
  119. package/dest/msg_validators/tx_validator/allowed_public_setup.js +24 -20
  120. package/dest/msg_validators/tx_validator/allowed_setup_helpers.d.ts +17 -0
  121. package/dest/msg_validators/tx_validator/allowed_setup_helpers.d.ts.map +1 -0
  122. package/dest/msg_validators/tx_validator/allowed_setup_helpers.js +24 -0
  123. package/dest/msg_validators/tx_validator/block_header_validator.d.ts +16 -3
  124. package/dest/msg_validators/tx_validator/block_header_validator.d.ts.map +1 -1
  125. package/dest/msg_validators/tx_validator/block_header_validator.js +1 -1
  126. package/dest/msg_validators/tx_validator/double_spend_validator.d.ts +13 -3
  127. package/dest/msg_validators/tx_validator/double_spend_validator.d.ts.map +1 -1
  128. package/dest/msg_validators/tx_validator/double_spend_validator.js +4 -4
  129. package/dest/msg_validators/tx_validator/factory.d.ts +114 -6
  130. package/dest/msg_validators/tx_validator/factory.d.ts.map +1 -1
  131. package/dest/msg_validators/tx_validator/factory.js +219 -58
  132. package/dest/msg_validators/tx_validator/fee_payer_balance.d.ts +1 -1
  133. package/dest/msg_validators/tx_validator/fee_payer_balance.d.ts.map +1 -1
  134. package/dest/msg_validators/tx_validator/fee_payer_balance.js +6 -2
  135. package/dest/msg_validators/tx_validator/gas_validator.d.ts +58 -3
  136. package/dest/msg_validators/tx_validator/gas_validator.d.ts.map +1 -1
  137. package/dest/msg_validators/tx_validator/gas_validator.js +73 -36
  138. package/dest/msg_validators/tx_validator/index.d.ts +3 -1
  139. package/dest/msg_validators/tx_validator/index.d.ts.map +1 -1
  140. package/dest/msg_validators/tx_validator/index.js +2 -0
  141. package/dest/msg_validators/tx_validator/metadata_validator.d.ts +1 -1
  142. package/dest/msg_validators/tx_validator/metadata_validator.d.ts.map +1 -1
  143. package/dest/msg_validators/tx_validator/metadata_validator.js +4 -4
  144. package/dest/msg_validators/tx_validator/nullifier_cache.d.ts +14 -0
  145. package/dest/msg_validators/tx_validator/nullifier_cache.d.ts.map +1 -0
  146. package/dest/msg_validators/tx_validator/nullifier_cache.js +24 -0
  147. package/dest/msg_validators/tx_validator/phases_validator.d.ts +2 -2
  148. package/dest/msg_validators/tx_validator/phases_validator.d.ts.map +1 -1
  149. package/dest/msg_validators/tx_validator/phases_validator.js +44 -23
  150. package/dest/msg_validators/tx_validator/timestamp_validator.d.ts +20 -4
  151. package/dest/msg_validators/tx_validator/timestamp_validator.d.ts.map +1 -1
  152. package/dest/msg_validators/tx_validator/timestamp_validator.js +6 -6
  153. package/dest/services/dummy_service.d.ts +13 -5
  154. package/dest/services/dummy_service.d.ts.map +1 -1
  155. package/dest/services/dummy_service.js +10 -4
  156. package/dest/services/encoding.d.ts +3 -3
  157. package/dest/services/encoding.d.ts.map +1 -1
  158. package/dest/services/encoding.js +11 -10
  159. package/dest/services/gossipsub/index.d.ts +3 -0
  160. package/dest/services/gossipsub/index.d.ts.map +1 -0
  161. package/dest/services/gossipsub/index.js +2 -0
  162. package/dest/services/gossipsub/scoring.d.ts +21 -3
  163. package/dest/services/gossipsub/scoring.d.ts.map +1 -1
  164. package/dest/services/gossipsub/scoring.js +24 -7
  165. package/dest/services/gossipsub/topic_score_params.d.ts +173 -0
  166. package/dest/services/gossipsub/topic_score_params.d.ts.map +1 -0
  167. package/dest/services/gossipsub/topic_score_params.js +346 -0
  168. package/dest/services/index.d.ts +2 -1
  169. package/dest/services/index.d.ts.map +1 -1
  170. package/dest/services/index.js +1 -0
  171. package/dest/services/libp2p/libp2p_service.d.ts +94 -42
  172. package/dest/services/libp2p/libp2p_service.d.ts.map +1 -1
  173. package/dest/services/libp2p/libp2p_service.js +435 -346
  174. package/dest/services/peer-manager/metrics.d.ts +3 -1
  175. package/dest/services/peer-manager/metrics.d.ts.map +1 -1
  176. package/dest/services/peer-manager/metrics.js +6 -0
  177. package/dest/services/peer-manager/peer_manager.d.ts +1 -1
  178. package/dest/services/peer-manager/peer_manager.d.ts.map +1 -1
  179. package/dest/services/peer-manager/peer_manager.js +2 -1
  180. package/dest/services/peer-manager/peer_scoring.d.ts +1 -1
  181. package/dest/services/peer-manager/peer_scoring.d.ts.map +1 -1
  182. package/dest/services/peer-manager/peer_scoring.js +25 -2
  183. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts +6 -5
  184. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts.map +1 -1
  185. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.js +26 -53
  186. package/dest/services/reqresp/batch-tx-requester/interface.d.ts +2 -6
  187. package/dest/services/reqresp/batch-tx-requester/interface.d.ts.map +1 -1
  188. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts +10 -13
  189. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts.map +1 -1
  190. package/dest/services/reqresp/batch-tx-requester/missing_txs.js +25 -46
  191. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts +17 -11
  192. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts.map +1 -1
  193. package/dest/services/reqresp/batch-tx-requester/peer_collection.js +49 -15
  194. package/dest/services/reqresp/batch-tx-requester/tx_validator.js +2 -2
  195. package/dest/services/reqresp/interface.d.ts +10 -1
  196. package/dest/services/reqresp/interface.d.ts.map +1 -1
  197. package/dest/services/reqresp/interface.js +15 -1
  198. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts +7 -5
  199. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts.map +1 -1
  200. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.js +16 -11
  201. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts +21 -10
  202. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts.map +1 -1
  203. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.js +27 -11
  204. package/dest/services/reqresp/protocols/tx.d.ts +7 -1
  205. package/dest/services/reqresp/protocols/tx.d.ts.map +1 -1
  206. package/dest/services/reqresp/protocols/tx.js +20 -0
  207. package/dest/services/reqresp/reqresp.d.ts +1 -1
  208. package/dest/services/reqresp/reqresp.d.ts.map +1 -1
  209. package/dest/services/reqresp/reqresp.js +13 -5
  210. package/dest/services/service.d.ts +39 -3
  211. package/dest/services/service.d.ts.map +1 -1
  212. package/dest/services/tx_collection/config.d.ts +22 -4
  213. package/dest/services/tx_collection/config.d.ts.map +1 -1
  214. package/dest/services/tx_collection/config.js +49 -3
  215. package/dest/services/tx_collection/fast_tx_collection.d.ts +6 -5
  216. package/dest/services/tx_collection/fast_tx_collection.d.ts.map +1 -1
  217. package/dest/services/tx_collection/fast_tx_collection.js +64 -48
  218. package/dest/services/tx_collection/file_store_tx_collection.d.ts +53 -0
  219. package/dest/services/tx_collection/file_store_tx_collection.d.ts.map +1 -0
  220. package/dest/services/tx_collection/file_store_tx_collection.js +167 -0
  221. package/dest/services/tx_collection/file_store_tx_source.d.ts +37 -0
  222. package/dest/services/tx_collection/file_store_tx_source.d.ts.map +1 -0
  223. package/dest/services/tx_collection/file_store_tx_source.js +90 -0
  224. package/dest/services/tx_collection/index.d.ts +3 -2
  225. package/dest/services/tx_collection/index.d.ts.map +1 -1
  226. package/dest/services/tx_collection/index.js +1 -0
  227. package/dest/services/tx_collection/instrumentation.d.ts +1 -1
  228. package/dest/services/tx_collection/instrumentation.d.ts.map +1 -1
  229. package/dest/services/tx_collection/instrumentation.js +2 -1
  230. package/dest/services/tx_collection/missing_txs_tracker.d.ts +32 -0
  231. package/dest/services/tx_collection/missing_txs_tracker.d.ts.map +1 -0
  232. package/dest/services/tx_collection/missing_txs_tracker.js +27 -0
  233. package/dest/services/tx_collection/proposal_tx_collector.d.ts +15 -14
  234. package/dest/services/tx_collection/proposal_tx_collector.d.ts.map +1 -1
  235. package/dest/services/tx_collection/proposal_tx_collector.js +6 -6
  236. package/dest/services/tx_collection/slow_tx_collection.d.ts +7 -3
  237. package/dest/services/tx_collection/slow_tx_collection.d.ts.map +1 -1
  238. package/dest/services/tx_collection/slow_tx_collection.js +60 -26
  239. package/dest/services/tx_collection/tx_collection.d.ts +23 -10
  240. package/dest/services/tx_collection/tx_collection.d.ts.map +1 -1
  241. package/dest/services/tx_collection/tx_collection.js +75 -3
  242. package/dest/services/tx_collection/tx_collection_sink.d.ts +18 -8
  243. package/dest/services/tx_collection/tx_collection_sink.d.ts.map +1 -1
  244. package/dest/services/tx_collection/tx_collection_sink.js +26 -29
  245. package/dest/services/tx_collection/tx_source.d.ts +8 -3
  246. package/dest/services/tx_collection/tx_source.d.ts.map +1 -1
  247. package/dest/services/tx_collection/tx_source.js +19 -2
  248. package/dest/services/tx_file_store/config.d.ts +16 -0
  249. package/dest/services/tx_file_store/config.d.ts.map +1 -0
  250. package/dest/services/tx_file_store/config.js +22 -0
  251. package/dest/services/tx_file_store/index.d.ts +4 -0
  252. package/dest/services/tx_file_store/index.d.ts.map +1 -0
  253. package/dest/services/tx_file_store/index.js +3 -0
  254. package/dest/services/tx_file_store/instrumentation.d.ts +15 -0
  255. package/dest/services/tx_file_store/instrumentation.d.ts.map +1 -0
  256. package/dest/services/tx_file_store/instrumentation.js +29 -0
  257. package/dest/services/tx_file_store/tx_file_store.d.ts +48 -0
  258. package/dest/services/tx_file_store/tx_file_store.d.ts.map +1 -0
  259. package/dest/services/tx_file_store/tx_file_store.js +152 -0
  260. package/dest/services/tx_provider.d.ts +4 -4
  261. package/dest/services/tx_provider.d.ts.map +1 -1
  262. package/dest/services/tx_provider.js +9 -8
  263. package/dest/test-helpers/make-test-p2p-clients.d.ts +7 -8
  264. package/dest/test-helpers/make-test-p2p-clients.d.ts.map +1 -1
  265. package/dest/test-helpers/make-test-p2p-clients.js +1 -2
  266. package/dest/test-helpers/mock-pubsub.d.ts +30 -4
  267. package/dest/test-helpers/mock-pubsub.d.ts.map +1 -1
  268. package/dest/test-helpers/mock-pubsub.js +105 -4
  269. package/dest/test-helpers/reqresp-nodes.d.ts +2 -3
  270. package/dest/test-helpers/reqresp-nodes.d.ts.map +1 -1
  271. package/dest/test-helpers/reqresp-nodes.js +4 -3
  272. package/dest/test-helpers/testbench-utils.d.ts +43 -38
  273. package/dest/test-helpers/testbench-utils.d.ts.map +1 -1
  274. package/dest/test-helpers/testbench-utils.js +128 -59
  275. package/dest/testbench/p2p_client_testbench_worker.d.ts +2 -2
  276. package/dest/testbench/p2p_client_testbench_worker.d.ts.map +1 -1
  277. package/dest/testbench/p2p_client_testbench_worker.js +17 -16
  278. package/dest/testbench/worker_client_manager.d.ts +3 -1
  279. package/dest/testbench/worker_client_manager.d.ts.map +1 -1
  280. package/dest/testbench/worker_client_manager.js +6 -2
  281. package/dest/util.d.ts +3 -3
  282. package/dest/util.d.ts.map +1 -1
  283. package/package.json +14 -14
  284. package/src/client/factory.ts +79 -27
  285. package/src/client/interface.ts +56 -34
  286. package/src/client/p2p_client.ts +185 -269
  287. package/src/client/test/tx_proposal_collector/proposal_tx_collector_worker.ts +21 -12
  288. package/src/config.ts +132 -44
  289. package/src/errors/tx-pool.error.ts +12 -0
  290. package/src/index.ts +1 -0
  291. package/src/mem_pools/attestation_pool/attestation_pool.ts +497 -91
  292. package/src/mem_pools/attestation_pool/attestation_pool_test_suite.ts +442 -102
  293. package/src/mem_pools/attestation_pool/index.ts +9 -2
  294. package/src/mem_pools/attestation_pool/mocks.ts +2 -1
  295. package/src/mem_pools/index.ts +4 -1
  296. package/src/mem_pools/instrumentation.ts +17 -13
  297. package/src/mem_pools/interface.ts +4 -4
  298. package/src/mem_pools/tx_pool/README.md +1 -1
  299. package/src/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.ts +3 -3
  300. package/src/mem_pools/tx_pool_v2/README.md +283 -0
  301. package/src/mem_pools/tx_pool_v2/archive/index.ts +1 -0
  302. package/src/mem_pools/tx_pool_v2/archive/tx_archive.ts +120 -0
  303. package/src/mem_pools/tx_pool_v2/deleted_pool.ts +321 -0
  304. package/src/mem_pools/tx_pool_v2/eviction/eviction_manager.ts +160 -0
  305. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.ts +121 -0
  306. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.ts +125 -0
  307. package/src/mem_pools/tx_pool_v2/eviction/index.ts +27 -0
  308. package/src/mem_pools/tx_pool_v2/eviction/interfaces.ts +219 -0
  309. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.ts +74 -0
  310. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.ts +101 -0
  311. package/src/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.ts +91 -0
  312. package/src/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.ts +99 -0
  313. package/src/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.ts +32 -0
  314. package/src/mem_pools/tx_pool_v2/index.ts +12 -0
  315. package/src/mem_pools/tx_pool_v2/instrumentation.ts +69 -0
  316. package/src/mem_pools/tx_pool_v2/interfaces.ts +245 -0
  317. package/src/mem_pools/tx_pool_v2/tx_metadata.ts +327 -0
  318. package/src/mem_pools/tx_pool_v2/tx_pool_bench_metrics.ts +77 -0
  319. package/src/mem_pools/tx_pool_v2/tx_pool_indices.ts +430 -0
  320. package/src/mem_pools/tx_pool_v2/tx_pool_v2.ts +226 -0
  321. package/src/mem_pools/tx_pool_v2/tx_pool_v2_impl.ts +1090 -0
  322. package/src/msg_validators/attestation_validator/fisherman_attestation_validator.ts +2 -2
  323. package/src/msg_validators/proposal_validator/block_proposal_validator.ts +14 -4
  324. package/src/msg_validators/proposal_validator/checkpoint_proposal_validator.ts +20 -7
  325. package/src/msg_validators/proposal_validator/proposal_validator.ts +63 -40
  326. package/src/msg_validators/tx_validator/README.md +115 -0
  327. package/src/msg_validators/tx_validator/aggregate_tx_validator.ts +5 -5
  328. package/src/msg_validators/tx_validator/allowed_public_setup.ts +22 -27
  329. package/src/msg_validators/tx_validator/allowed_setup_helpers.ts +31 -0
  330. package/src/msg_validators/tx_validator/block_header_validator.ts +15 -3
  331. package/src/msg_validators/tx_validator/double_spend_validator.ts +11 -6
  332. package/src/msg_validators/tx_validator/factory.ts +353 -77
  333. package/src/msg_validators/tx_validator/fee_payer_balance.ts +6 -2
  334. package/src/msg_validators/tx_validator/gas_validator.ts +90 -27
  335. package/src/msg_validators/tx_validator/index.ts +2 -0
  336. package/src/msg_validators/tx_validator/metadata_validator.ts +12 -4
  337. package/src/msg_validators/tx_validator/nullifier_cache.ts +30 -0
  338. package/src/msg_validators/tx_validator/phases_validator.ts +51 -26
  339. package/src/msg_validators/tx_validator/timestamp_validator.ts +23 -18
  340. package/src/services/dummy_service.ts +18 -6
  341. package/src/services/encoding.ts +9 -9
  342. package/src/services/gossipsub/README.md +641 -0
  343. package/src/services/gossipsub/index.ts +2 -0
  344. package/src/services/gossipsub/scoring.ts +29 -5
  345. package/src/services/gossipsub/topic_score_params.ts +487 -0
  346. package/src/services/index.ts +1 -0
  347. package/src/services/libp2p/libp2p_service.ts +460 -366
  348. package/src/services/peer-manager/metrics.ts +7 -0
  349. package/src/services/peer-manager/peer_manager.ts +2 -1
  350. package/src/services/peer-manager/peer_scoring.ts +25 -0
  351. package/src/services/reqresp/batch-tx-requester/README.md +7 -7
  352. package/src/services/reqresp/batch-tx-requester/batch_tx_requester.ts +31 -59
  353. package/src/services/reqresp/batch-tx-requester/interface.ts +1 -5
  354. package/src/services/reqresp/batch-tx-requester/missing_txs.ts +23 -71
  355. package/src/services/reqresp/batch-tx-requester/peer_collection.ts +63 -24
  356. package/src/services/reqresp/batch-tx-requester/tx_validator.ts +2 -2
  357. package/src/services/reqresp/interface.ts +26 -1
  358. package/src/services/reqresp/protocols/block_txs/block_txs_handler.ts +23 -14
  359. package/src/services/reqresp/protocols/block_txs/block_txs_reqresp.ts +38 -15
  360. package/src/services/reqresp/protocols/tx.ts +22 -0
  361. package/src/services/reqresp/reqresp.ts +16 -4
  362. package/src/services/service.ts +51 -2
  363. package/src/services/tx_collection/config.ts +74 -6
  364. package/src/services/tx_collection/fast_tx_collection.ts +74 -51
  365. package/src/services/tx_collection/file_store_tx_collection.ts +202 -0
  366. package/src/services/tx_collection/file_store_tx_source.ts +117 -0
  367. package/src/services/tx_collection/index.ts +2 -1
  368. package/src/services/tx_collection/instrumentation.ts +7 -1
  369. package/src/services/tx_collection/missing_txs_tracker.ts +52 -0
  370. package/src/services/tx_collection/proposal_tx_collector.ts +20 -21
  371. package/src/services/tx_collection/slow_tx_collection.ts +66 -33
  372. package/src/services/tx_collection/tx_collection.ts +113 -16
  373. package/src/services/tx_collection/tx_collection_sink.ts +30 -34
  374. package/src/services/tx_collection/tx_source.ts +22 -3
  375. package/src/services/tx_file_store/config.ts +37 -0
  376. package/src/services/tx_file_store/index.ts +3 -0
  377. package/src/services/tx_file_store/instrumentation.ts +36 -0
  378. package/src/services/tx_file_store/tx_file_store.ts +175 -0
  379. package/src/services/tx_provider.ts +10 -9
  380. package/src/test-helpers/make-test-p2p-clients.ts +4 -6
  381. package/src/test-helpers/mock-pubsub.ts +146 -9
  382. package/src/test-helpers/reqresp-nodes.ts +5 -7
  383. package/src/test-helpers/testbench-utils.ts +127 -71
  384. package/src/testbench/p2p_client_testbench_worker.ts +26 -22
  385. package/src/testbench/worker_client_manager.ts +13 -5
  386. package/src/util.ts +8 -2
  387. package/dest/mem_pools/attestation_pool/kv_attestation_pool.d.ts +0 -40
  388. package/dest/mem_pools/attestation_pool/kv_attestation_pool.d.ts.map +0 -1
  389. package/dest/mem_pools/attestation_pool/kv_attestation_pool.js +0 -218
  390. package/dest/mem_pools/attestation_pool/memory_attestation_pool.d.ts +0 -31
  391. package/dest/mem_pools/attestation_pool/memory_attestation_pool.d.ts.map +0 -1
  392. package/dest/mem_pools/attestation_pool/memory_attestation_pool.js +0 -180
  393. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.d.ts +0 -23
  394. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.d.ts.map +0 -1
  395. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.js +0 -212
  396. package/src/mem_pools/attestation_pool/kv_attestation_pool.ts +0 -320
  397. package/src/mem_pools/attestation_pool/memory_attestation_pool.ts +0 -264
  398. package/src/msg_validators/proposal_validator/proposal_validator_test_suite.ts +0 -230
@@ -3,12 +3,12 @@ import { SecretValue } from '@aztec/foundation/config';
3
3
  import { createLogger } from '@aztec/foundation/log';
4
4
  import { sleep } from '@aztec/foundation/sleep';
5
5
  import { DateProvider, Timer, executeTimeout } from '@aztec/foundation/timer';
6
- import type { DataStoreConfig } from '@aztec/kv-store/config';
7
6
  import { openTmpStore } from '@aztec/kv-store/lmdb-v2';
8
7
  import type { L2BlockSource } from '@aztec/stdlib/block';
9
8
  import type { ContractDataSource } from '@aztec/stdlib/contract';
10
9
  import type { ClientProtocolCircuitVerifier } from '@aztec/stdlib/interfaces/server';
11
- import { P2PClientType, PeerErrorSeverity } from '@aztec/stdlib/p2p';
10
+ import type { DataStoreConfig } from '@aztec/stdlib/kv-store';
11
+ import { PeerErrorSeverity } from '@aztec/stdlib/p2p';
12
12
  import type { Tx, TxValidationResult } from '@aztec/stdlib/tx';
13
13
  import { type TelemetryClient, getTelemetryClient } from '@aztec/telemetry-client';
14
14
 
@@ -16,14 +16,12 @@ import type { PeerId } from '@libp2p/interface';
16
16
  import { peerIdFromString } from '@libp2p/peer-id';
17
17
 
18
18
  import type { P2PConfig } from '../../../config.js';
19
+ import { BatchTxRequesterCollector, SendBatchRequestCollector } from '../../../services/index.js';
19
20
  import type { IBatchRequestTxValidator } from '../../../services/reqresp/batch-tx-requester/tx_validator.js';
20
21
  import { RateLimitStatus } from '../../../services/reqresp/rate-limiter/rate_limiter.js';
22
+ import { MissingTxsTracker } from '../../../services/tx_collection/missing_txs_tracker.js';
21
23
  import {
22
- BatchTxRequesterCollector,
23
- SendBatchRequestCollector,
24
- } from '../../../services/tx_collection/proposal_tx_collector.js';
25
- import { AlwaysTrueCircuitVerifier } from '../../../test-helpers/reqresp-nodes.js';
26
- import {
24
+ AlwaysTrueCircuitVerifier,
27
25
  BENCHMARK_CONSTANTS,
28
26
  InMemoryAttestationPool,
29
27
  InMemoryTxPool,
@@ -31,7 +29,7 @@ import {
31
29
  calculateInternalTimeout,
32
30
  createMockEpochCache,
33
31
  createMockWorldStateSynchronizer,
34
- } from '../../../test-helpers/testbench-utils.js';
32
+ } from '../../../test-helpers/index.js';
35
33
  import { createP2PClient } from '../../index.js';
36
34
  import type { P2PClient } from '../../p2p_client.js';
37
35
  import {
@@ -116,7 +114,6 @@ async function startClient(config: P2PConfig, clientIndex: number) {
116
114
  };
117
115
 
118
116
  client = await createP2PClient(
119
- P2PClientType.Full,
120
117
  config as P2PConfig & DataStoreConfig,
121
118
  l2BlockSource as L2BlockSource & ContractDataSource,
122
119
  proofVerifier as ClientProtocolCircuitVerifier,
@@ -214,7 +211,13 @@ async function runCollector(cmd: Extract<WorkerCommand, { type: 'RUN_COLLECTOR'
214
211
  if (collectorType === 'batch-requester') {
215
212
  const collector = new BatchTxRequesterCollector(p2pService, logger, new DateProvider(), noopTxValidator);
216
213
  const fetched = await executeTimeout(
217
- (_signal: AbortSignal) => collector.collectTxs(parsedTxHashes, parsedProposal, pinnedPeer, internalTimeoutMs),
214
+ (_signal: AbortSignal) =>
215
+ collector.collectTxs(
216
+ MissingTxsTracker.fromArray(parsedTxHashes),
217
+ parsedProposal,
218
+ pinnedPeer,
219
+ internalTimeoutMs,
220
+ ),
218
221
  timeoutMs,
219
222
  () => new Error(`Collector timed out after ${timeoutMs}ms`),
220
223
  );
@@ -226,7 +229,13 @@ async function runCollector(cmd: Extract<WorkerCommand, { type: 'RUN_COLLECTOR'
226
229
  BENCHMARK_CONSTANTS.FIXED_MAX_RETRY_ATTEMPTS,
227
230
  );
228
231
  const fetched = await executeTimeout(
229
- (_signal: AbortSignal) => collector.collectTxs(parsedTxHashes, parsedProposal, pinnedPeer, internalTimeoutMs),
232
+ (_signal: AbortSignal) =>
233
+ collector.collectTxs(
234
+ MissingTxsTracker.fromArray(parsedTxHashes),
235
+ parsedProposal,
236
+ pinnedPeer,
237
+ internalTimeoutMs,
238
+ ),
230
239
  timeoutMs,
231
240
  () => new Error(`Collector timed out after ${timeoutMs}ms`),
232
241
  );
@@ -301,7 +310,7 @@ process.on('message', (msg: WorkerCommand) => {
301
310
  throw new Error('Attestation pool not initialized');
302
311
  }
303
312
  const proposal = deserializeBlockProposal(msg.blockProposal);
304
- await attestationPool.addBlockProposal(proposal);
313
+ await attestationPool.tryAddBlockProposal(proposal);
305
314
  await sendMessage({ type: 'BLOCK_PROPOSAL_SET', requestId, archiveRoot: proposal.archive.toString() });
306
315
  break;
307
316
  }
package/src/config.ts CHANGED
@@ -1,6 +1,7 @@
1
1
  import {
2
2
  type ConfigMappingsType,
3
3
  SecretValue,
4
+ bigintConfigHelper,
4
5
  booleanConfigHelper,
5
6
  getConfigFromMappings,
6
7
  getDefaultConfig,
@@ -10,10 +11,16 @@ import {
10
11
  secretStringConfigHelper,
11
12
  } from '@aztec/foundation/config';
12
13
  import { Fr } from '@aztec/foundation/curves/bn254';
13
- import { type DataStoreConfig, dataConfigMappings } from '@aztec/kv-store/config';
14
14
  import { FunctionSelector } from '@aztec/stdlib/abi/function-selector';
15
15
  import { AztecAddress } from '@aztec/stdlib/aztec-address';
16
- import { type AllowedElement, type ChainConfig, chainConfigMappings } from '@aztec/stdlib/config';
16
+ import {
17
+ type AllowedElement,
18
+ type ChainConfig,
19
+ type SequencerConfig,
20
+ chainConfigMappings,
21
+ sharedSequencerConfigMappings,
22
+ } from '@aztec/stdlib/config';
23
+ import { type DataStoreConfig, dataConfigMappings } from '@aztec/stdlib/kv-store';
17
24
 
18
25
  import {
19
26
  type BatchTxRequesterConfig,
@@ -21,17 +28,30 @@ import {
21
28
  } from './services/reqresp/batch-tx-requester/config.js';
22
29
  import { type P2PReqRespConfig, p2pReqRespConfigMappings } from './services/reqresp/config.js';
23
30
  import { type TxCollectionConfig, txCollectionConfigMappings } from './services/tx_collection/config.js';
31
+ import { type TxFileStoreConfig, txFileStoreConfigMappings } from './services/tx_file_store/config.js';
24
32
 
25
33
  /**
26
34
  * P2P client configuration values.
27
35
  */
28
- export interface P2PConfig extends P2PReqRespConfig, BatchTxRequesterConfig, ChainConfig, TxCollectionConfig {
36
+ export interface P2PConfig
37
+ extends P2PReqRespConfig,
38
+ BatchTxRequesterConfig,
39
+ ChainConfig,
40
+ TxCollectionConfig,
41
+ TxFileStoreConfig,
42
+ Pick<SequencerConfig, 'blockDurationMs' | 'expectedBlockProposalsPerSlot' | 'maxTxsPerBlock'> {
43
+ /** Maximum transactions per block for validation. Overrides maxTxsPerBlock for gossip validation when set. */
44
+ validateMaxTxsPerBlock?: number;
45
+
29
46
  /** A flag dictating whether the P2P subsystem should be enabled. */
30
47
  p2pEnabled: boolean;
31
48
 
32
49
  /** The frequency in which to check for new L2 blocks. */
33
50
  blockCheckIntervalMS: number;
34
51
 
52
+ /** The frequency in which to check for new L2 slots. */
53
+ slotCheckIntervalMS: number;
54
+
35
55
  /** The number of blocks to fetch in a single batch. */
36
56
  blockRequestBatchSize: number;
37
57
 
@@ -134,8 +154,8 @@ export interface P2PConfig extends P2PReqRespConfig, BatchTxRequesterConfig, Cha
134
154
  /** The maximum possible size of the P2P DB in KB. Overwrites the general dataStoreMapSizeKb. */
135
155
  p2pStoreMapSizeKb?: number;
136
156
 
137
- /** Which calls are allowed in the public setup phase of a tx. */
138
- txPublicSetupAllowList: AllowedElement[];
157
+ /** Additional entries to extend the default setup allow list. */
158
+ txPublicSetupAllowListExtend: AllowedElement[];
139
159
 
140
160
  /** The maximum number of pending txs before evicting lower priority txs. */
141
161
  maxPendingTxCount: number;
@@ -157,10 +177,7 @@ export interface P2PConfig extends P2PReqRespConfig, BatchTxRequesterConfig, Cha
157
177
  /** Whether transactions are disabled for this node. This means transactions will be rejected at the RPC and P2P layers. */
158
178
  disableTransactions: boolean;
159
179
 
160
- /** True to simulate discarding transactions. - For testing purposes only*/
161
- dropTransactions: boolean;
162
-
163
- /** The probability that a transaction is discarded. - For testing purposes only */
180
+ /** The probability that a transaction is discarded (0 = disabled). - For testing purposes only */
164
181
  dropTransactionsProbability: number;
165
182
 
166
183
  /** Whether to delete transactions from the pool after a reorg instead of moving them back to pending. */
@@ -171,11 +188,26 @@ export interface P2PConfig extends P2PReqRespConfig, BatchTxRequesterConfig, Cha
171
188
 
172
189
  /** Whether to run in fisherman mode: validates all proposals and attestations but does not broadcast attestations or participate in consensus */
173
190
  fishermanMode: boolean;
191
+
192
+ /** Broadcast block proposals even when a conflicting proposal for the same slot already exists in the pool (for testing purposes only). */
193
+ broadcastEquivocatedProposals?: boolean;
194
+
195
+ /** Minimum age (ms) a transaction must have been in the pool before it's eligible for block building. */
196
+ minTxPoolAgeMs: number;
197
+
198
+ /** Minimum percentage fee increase required to replace an existing tx via RPC (0 = no bump). */
199
+ priceBumpPercentage: bigint;
174
200
  }
175
201
 
176
202
  export const DEFAULT_P2P_PORT = 40400;
177
203
 
178
204
  export const p2pConfigMappings: ConfigMappingsType<P2PConfig> = {
205
+ validateMaxTxsPerBlock: {
206
+ env: 'VALIDATOR_MAX_TX_PER_BLOCK',
207
+ description:
208
+ 'Maximum transactions per block for validation. Overrides maxTxsPerBlock for gossip validation when set.',
209
+ parseEnv: (val: string) => (val ? parseInt(val, 10) : undefined),
210
+ },
179
211
  p2pEnabled: {
180
212
  env: 'P2P_ENABLED',
181
213
  description: 'A flag dictating whether the P2P subsystem should be enabled.',
@@ -191,6 +223,11 @@ export const p2pConfigMappings: ConfigMappingsType<P2PConfig> = {
191
223
  description: 'The frequency in which to check for new L2 blocks.',
192
224
  ...numberConfigHelper(100),
193
225
  },
226
+ slotCheckIntervalMS: {
227
+ env: 'P2P_SLOT_CHECK_INTERVAL_MS',
228
+ description: 'The frequency in which to check for new L2 slots.',
229
+ ...numberConfigHelper(1000),
230
+ },
194
231
  debugDisableColocationPenalty: {
195
232
  env: 'DEBUG_P2P_DISABLE_COLOCATION_PENALTY',
196
233
  description: 'DEBUG: Disable colocation penalty - NEVER set to true in production',
@@ -369,12 +406,13 @@ export const p2pConfigMappings: ConfigMappingsType<P2PConfig> = {
369
406
  parseEnv: (val: string | undefined) => (val ? +val : undefined),
370
407
  description: 'The maximum possible size of the P2P DB in KB. Overwrites the general dataStoreMapSizeKb.',
371
408
  },
372
- txPublicSetupAllowList: {
409
+ txPublicSetupAllowListExtend: {
373
410
  env: 'TX_PUBLIC_SETUP_ALLOWLIST',
374
411
  parseEnv: (val: string) => parseAllowList(val),
375
- description: 'The list of functions calls allowed to run in setup',
412
+ description:
413
+ 'Additional entries to extend the default setup allow list. Format: I:address:selector[:flags],C:classId:selector[:flags]. Flags: os (onlySelf), rn (rejectNullMsgSender), cl=N (calldataLength), joined with +.',
376
414
  printDefault: () =>
377
- 'AuthRegistry, FeeJuice.increase_public_balance, Token.increase_public_balance, FPC.prepare_fee',
415
+ 'Default: AuthRegistry._set_authorized, AuthRegistry.set_authorized, FeeJuice._increase_public_balance',
378
416
  },
379
417
  maxPendingTxCount: {
380
418
  env: 'P2P_MAX_PENDING_TX_COUNT',
@@ -403,11 +441,6 @@ export const p2pConfigMappings: ConfigMappingsType<P2PConfig> = {
403
441
  description: 'Number of auth attempts to allow before peer is banned. Number is inclusive',
404
442
  ...numberConfigHelper(3),
405
443
  },
406
- dropTransactions: {
407
- env: 'P2P_DROP_TX',
408
- description: 'True to simulate discarding transactions. - For testing purposes only',
409
- ...booleanConfigHelper(false),
410
- },
411
444
  dropTransactionsProbability: {
412
445
  env: 'P2P_DROP_TX_CHANCE',
413
446
  description: 'The probability that a transaction is discarded (0 - 1). - For testing purposes only',
@@ -435,10 +468,28 @@ export const p2pConfigMappings: ConfigMappingsType<P2PConfig> = {
435
468
  'Whether to run in fisherman mode: validates all proposals and attestations but does not broadcast attestations or participate in consensus.',
436
469
  ...booleanConfigHelper(false),
437
470
  },
471
+ broadcastEquivocatedProposals: {
472
+ description:
473
+ 'Broadcast block proposals even when a conflicting proposal for the same slot already exists in the pool (for testing purposes only).',
474
+ ...booleanConfigHelper(false),
475
+ },
476
+ minTxPoolAgeMs: {
477
+ env: 'P2P_MIN_TX_POOL_AGE_MS',
478
+ description: 'Minimum age (ms) a transaction must have been in the pool before it is eligible for block building.',
479
+ ...numberConfigHelper(2_000),
480
+ },
481
+ priceBumpPercentage: {
482
+ env: 'P2P_RPC_PRICE_BUMP_PERCENTAGE',
483
+ description:
484
+ 'Minimum percentage fee increase required to replace an existing tx via RPC. Even at 0%, replacement still requires paying at least 1 unit more.',
485
+ ...bigintConfigHelper(10n),
486
+ },
487
+ ...sharedSequencerConfigMappings,
438
488
  ...p2pReqRespConfigMappings,
439
489
  ...batchTxRequesterConfigMappings,
440
490
  ...chainConfigMappings,
441
491
  ...txCollectionConfigMappings,
492
+ ...txFileStoreConfigMappings,
442
493
  };
443
494
 
444
495
  /**
@@ -490,13 +541,44 @@ export const bootnodeConfigMappings = pickConfigMappings(
490
541
  bootnodeConfigKeys,
491
542
  );
492
543
 
544
+ /**
545
+ * Parses a `+`-separated flags string into validation properties for an allow list entry.
546
+ * Supported flags: `os` (onlySelf), `rn` (rejectNullMsgSender), `cl=N` (calldataLength).
547
+ */
548
+ function parseFlags(
549
+ flags: string,
550
+ entry: string,
551
+ ): { onlySelf?: boolean; rejectNullMsgSender?: boolean; calldataLength?: number } {
552
+ const result: { onlySelf?: boolean; rejectNullMsgSender?: boolean; calldataLength?: number } = {};
553
+ for (const flag of flags.split('+')) {
554
+ if (flag === 'os') {
555
+ result.onlySelf = true;
556
+ } else if (flag === 'rn') {
557
+ result.rejectNullMsgSender = true;
558
+ } else if (flag.startsWith('cl=')) {
559
+ const n = parseInt(flag.slice(3), 10);
560
+ if (isNaN(n) || n < 0) {
561
+ throw new Error(
562
+ `Invalid allow list entry "${entry}": invalid calldataLength in flag "${flag}". Expected a non-negative integer.`,
563
+ );
564
+ }
565
+ result.calldataLength = n;
566
+ } else {
567
+ throw new Error(`Invalid allow list entry "${entry}": unknown flag "${flag}". Supported flags: os, rn, cl=N.`);
568
+ }
569
+ }
570
+ return result;
571
+ }
572
+
493
573
  /**
494
574
  * Parses a string to a list of allowed elements.
495
- * Each encoded is expected to be of one of the following formats
496
- * `I:${address}`
497
- * `I:${address}:${selector}`
498
- * `C:${classId}`
499
- * `C:${classId}:${selector}`
575
+ * Each entry is expected to be of one of the following formats:
576
+ * `I:${address}:${selector}` — instance (contract address) with function selector
577
+ * `C:${classId}:${selector}` — class with function selector
578
+ *
579
+ * An optional flags segment can be appended after the selector:
580
+ * `I:${address}:${selector}:${flags}` or `C:${classId}:${selector}:${flags}`
581
+ * where flags is a `+`-separated list of: `os` (onlySelf), `rn` (rejectNullMsgSender), `cl=N` (calldataLength).
500
582
  *
501
583
  * @param value The string to parse
502
584
  * @returns A list of allowed elements
@@ -509,31 +591,37 @@ export function parseAllowList(value: string): AllowedElement[] {
509
591
  }
510
592
 
511
593
  for (const val of value.split(',')) {
512
- const [typeString, identifierString, selectorString] = val.split(':');
513
- const selector = selectorString !== undefined ? FunctionSelector.fromString(selectorString) : undefined;
594
+ const trimmed = val.trim();
595
+ if (!trimmed) {
596
+ continue;
597
+ }
598
+ const [typeString, identifierString, selectorString, flagsString] = trimmed.split(':');
599
+
600
+ if (!selectorString) {
601
+ throw new Error(
602
+ `Invalid allow list entry "${trimmed}": selector is required. Expected format: I:address:selector or C:classId:selector`,
603
+ );
604
+ }
605
+
606
+ const selector = FunctionSelector.fromString(selectorString);
607
+ const flags = flagsString ? parseFlags(flagsString, trimmed) : {};
514
608
 
515
609
  if (typeString === 'I') {
516
- if (selector) {
517
- entries.push({
518
- address: AztecAddress.fromString(identifierString),
519
- selector,
520
- });
521
- } else {
522
- entries.push({
523
- address: AztecAddress.fromString(identifierString),
524
- });
525
- }
610
+ entries.push({
611
+ address: AztecAddress.fromString(identifierString),
612
+ selector,
613
+ ...flags,
614
+ });
526
615
  } else if (typeString === 'C') {
527
- if (selector) {
528
- entries.push({
529
- classId: Fr.fromHexString(identifierString),
530
- selector,
531
- });
532
- } else {
533
- entries.push({
534
- classId: Fr.fromHexString(identifierString),
535
- });
536
- }
616
+ entries.push({
617
+ classId: Fr.fromHexString(identifierString),
618
+ selector,
619
+ ...flags,
620
+ });
621
+ } else {
622
+ throw new Error(
623
+ `Invalid allow list entry "${trimmed}": unknown type "${typeString}". Expected "I" (instance) or "C" (class).`,
624
+ );
537
625
  }
538
626
  }
539
627
 
@@ -0,0 +1,12 @@
1
+ import type { TxPoolRejectionError } from '../mem_pools/tx_pool_v2/eviction/interfaces.js';
2
+
3
+ /** Error thrown when a transaction is not added to the mempool. */
4
+ export class TxPoolError extends Error {
5
+ public readonly data: TxPoolRejectionError;
6
+
7
+ constructor(public readonly reason: TxPoolRejectionError) {
8
+ super(reason.message);
9
+ this.name = 'TxPoolError';
10
+ this.data = reason;
11
+ }
12
+ }
package/src/index.ts CHANGED
@@ -7,5 +7,6 @@ export * from './enr/index.js';
7
7
  export * from './config.js';
8
8
  export * from './mem_pools/attestation_pool/index.js';
9
9
  export * from './mem_pools/tx_pool/index.js';
10
+ export * from './mem_pools/tx_pool_v2/index.js';
10
11
  export * from './msg_validators/index.js';
11
12
  export * from './services/index.js';