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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (394) hide show
  1. package/dest/client/factory.d.ts +11 -11
  2. package/dest/client/factory.d.ts.map +1 -1
  3. package/dest/client/factory.js +45 -15
  4. package/dest/client/interface.d.ts +46 -33
  5. package/dest/client/interface.d.ts.map +1 -1
  6. package/dest/client/p2p_client.d.ts +39 -51
  7. package/dest/client/p2p_client.d.ts.map +1 -1
  8. package/dest/client/p2p_client.js +151 -224
  9. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker.js +7 -8
  10. package/dest/config.d.ts +49 -18
  11. package/dest/config.d.ts.map +1 -1
  12. package/dest/config.js +92 -38
  13. package/dest/errors/tx-pool.error.d.ts +8 -0
  14. package/dest/errors/tx-pool.error.d.ts.map +1 -0
  15. package/dest/errors/tx-pool.error.js +9 -0
  16. package/dest/index.d.ts +2 -1
  17. package/dest/index.d.ts.map +1 -1
  18. package/dest/index.js +1 -0
  19. package/dest/mem_pools/attestation_pool/attestation_pool.d.ts +104 -88
  20. package/dest/mem_pools/attestation_pool/attestation_pool.d.ts.map +1 -1
  21. package/dest/mem_pools/attestation_pool/attestation_pool.js +445 -3
  22. package/dest/mem_pools/attestation_pool/attestation_pool_test_suite.d.ts +2 -2
  23. package/dest/mem_pools/attestation_pool/attestation_pool_test_suite.d.ts.map +1 -1
  24. package/dest/mem_pools/attestation_pool/attestation_pool_test_suite.js +353 -87
  25. package/dest/mem_pools/attestation_pool/index.d.ts +2 -3
  26. package/dest/mem_pools/attestation_pool/index.d.ts.map +1 -1
  27. package/dest/mem_pools/attestation_pool/index.js +1 -2
  28. package/dest/mem_pools/attestation_pool/mocks.d.ts +2 -2
  29. package/dest/mem_pools/attestation_pool/mocks.d.ts.map +1 -1
  30. package/dest/mem_pools/attestation_pool/mocks.js +2 -2
  31. package/dest/mem_pools/index.d.ts +3 -2
  32. package/dest/mem_pools/index.d.ts.map +1 -1
  33. package/dest/mem_pools/index.js +1 -1
  34. package/dest/mem_pools/instrumentation.d.ts +4 -2
  35. package/dest/mem_pools/instrumentation.d.ts.map +1 -1
  36. package/dest/mem_pools/instrumentation.js +16 -14
  37. package/dest/mem_pools/interface.d.ts +5 -5
  38. package/dest/mem_pools/interface.d.ts.map +1 -1
  39. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.js +3 -3
  40. package/dest/mem_pools/tx_pool/priority.d.ts +2 -2
  41. package/dest/mem_pools/tx_pool/priority.d.ts.map +1 -1
  42. package/dest/mem_pools/tx_pool/priority.js +4 -3
  43. package/dest/mem_pools/tx_pool/tx_pool_test_suite.d.ts +1 -1
  44. package/dest/mem_pools/tx_pool/tx_pool_test_suite.d.ts.map +1 -1
  45. package/dest/mem_pools/tx_pool/tx_pool_test_suite.js +3 -1
  46. package/dest/mem_pools/tx_pool_v2/archive/index.d.ts +2 -0
  47. package/dest/mem_pools/tx_pool_v2/archive/index.d.ts.map +1 -0
  48. package/dest/mem_pools/tx_pool_v2/archive/index.js +1 -0
  49. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.d.ts +43 -0
  50. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.d.ts.map +1 -0
  51. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.js +103 -0
  52. package/dest/mem_pools/tx_pool_v2/deleted_pool.d.ts +104 -0
  53. package/dest/mem_pools/tx_pool_v2/deleted_pool.d.ts.map +1 -0
  54. package/dest/mem_pools/tx_pool_v2/deleted_pool.js +251 -0
  55. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.d.ts +47 -0
  56. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.d.ts.map +1 -0
  57. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.js +128 -0
  58. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.d.ts +17 -0
  59. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.d.ts.map +1 -0
  60. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.js +93 -0
  61. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.d.ts +19 -0
  62. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.d.ts.map +1 -0
  63. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.js +97 -0
  64. package/dest/mem_pools/tx_pool_v2/eviction/index.d.ts +10 -0
  65. package/dest/mem_pools/tx_pool_v2/eviction/index.d.ts.map +1 -0
  66. package/dest/mem_pools/tx_pool_v2/eviction/index.js +11 -0
  67. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.d.ts +180 -0
  68. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.d.ts.map +1 -0
  69. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.js +25 -0
  70. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.d.ts +15 -0
  71. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.d.ts.map +1 -0
  72. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.js +65 -0
  73. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.d.ts +17 -0
  74. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.d.ts.map +1 -0
  75. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.js +93 -0
  76. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.d.ts +16 -0
  77. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.d.ts.map +1 -0
  78. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.js +78 -0
  79. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.d.ts +20 -0
  80. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.d.ts.map +1 -0
  81. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.js +75 -0
  82. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.d.ts +15 -0
  83. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.d.ts.map +1 -0
  84. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.js +19 -0
  85. package/dest/mem_pools/tx_pool_v2/index.d.ts +6 -0
  86. package/dest/mem_pools/tx_pool_v2/index.d.ts.map +1 -0
  87. package/dest/mem_pools/tx_pool_v2/index.js +5 -0
  88. package/dest/mem_pools/tx_pool_v2/instrumentation.d.ts +15 -0
  89. package/dest/mem_pools/tx_pool_v2/instrumentation.d.ts.map +1 -0
  90. package/dest/mem_pools/tx_pool_v2/instrumentation.js +43 -0
  91. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts +213 -0
  92. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts.map +1 -0
  93. package/dest/mem_pools/tx_pool_v2/interfaces.js +10 -0
  94. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts +127 -0
  95. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts.map +1 -0
  96. package/dest/mem_pools/tx_pool_v2/tx_metadata.js +210 -0
  97. package/dest/mem_pools/tx_pool_v2/tx_pool_bench_metrics.d.ts +26 -0
  98. package/dest/mem_pools/tx_pool_v2/tx_pool_bench_metrics.d.ts.map +1 -0
  99. package/dest/mem_pools/tx_pool_v2/tx_pool_bench_metrics.js +70 -0
  100. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.d.ts +108 -0
  101. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.d.ts.map +1 -0
  102. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.js +337 -0
  103. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts +60 -0
  104. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts.map +1 -0
  105. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.js +164 -0
  106. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts +78 -0
  107. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts.map +1 -0
  108. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.js +916 -0
  109. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts +3 -3
  110. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts.map +1 -1
  111. package/dest/msg_validators/proposal_validator/block_proposal_validator.d.ts +6 -4
  112. package/dest/msg_validators/proposal_validator/block_proposal_validator.d.ts.map +1 -1
  113. package/dest/msg_validators/proposal_validator/block_proposal_validator.js +10 -2
  114. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.d.ts +6 -4
  115. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.d.ts.map +1 -1
  116. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.js +16 -2
  117. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts +13 -8
  118. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts.map +1 -1
  119. package/dest/msg_validators/proposal_validator/proposal_validator.js +48 -36
  120. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts +4 -4
  121. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts.map +1 -1
  122. package/dest/msg_validators/tx_validator/aggregate_tx_validator.js +3 -3
  123. package/dest/msg_validators/tx_validator/allowed_public_setup.d.ts +2 -1
  124. package/dest/msg_validators/tx_validator/allowed_public_setup.d.ts.map +1 -1
  125. package/dest/msg_validators/tx_validator/allowed_public_setup.js +24 -20
  126. package/dest/msg_validators/tx_validator/allowed_setup_helpers.d.ts +17 -0
  127. package/dest/msg_validators/tx_validator/allowed_setup_helpers.d.ts.map +1 -0
  128. package/dest/msg_validators/tx_validator/allowed_setup_helpers.js +24 -0
  129. package/dest/msg_validators/tx_validator/block_header_validator.d.ts +16 -3
  130. package/dest/msg_validators/tx_validator/block_header_validator.d.ts.map +1 -1
  131. package/dest/msg_validators/tx_validator/block_header_validator.js +1 -1
  132. package/dest/msg_validators/tx_validator/double_spend_validator.d.ts +13 -3
  133. package/dest/msg_validators/tx_validator/double_spend_validator.d.ts.map +1 -1
  134. package/dest/msg_validators/tx_validator/double_spend_validator.js +4 -4
  135. package/dest/msg_validators/tx_validator/factory.d.ts +125 -6
  136. package/dest/msg_validators/tx_validator/factory.d.ts.map +1 -1
  137. package/dest/msg_validators/tx_validator/factory.js +226 -58
  138. package/dest/msg_validators/tx_validator/fee_payer_balance.d.ts +1 -1
  139. package/dest/msg_validators/tx_validator/fee_payer_balance.d.ts.map +1 -1
  140. package/dest/msg_validators/tx_validator/fee_payer_balance.js +6 -2
  141. package/dest/msg_validators/tx_validator/gas_validator.d.ts +67 -3
  142. package/dest/msg_validators/tx_validator/gas_validator.d.ts.map +1 -1
  143. package/dest/msg_validators/tx_validator/gas_validator.js +104 -37
  144. package/dest/msg_validators/tx_validator/index.d.ts +3 -1
  145. package/dest/msg_validators/tx_validator/index.d.ts.map +1 -1
  146. package/dest/msg_validators/tx_validator/index.js +2 -0
  147. package/dest/msg_validators/tx_validator/metadata_validator.d.ts +1 -1
  148. package/dest/msg_validators/tx_validator/metadata_validator.d.ts.map +1 -1
  149. package/dest/msg_validators/tx_validator/metadata_validator.js +4 -4
  150. package/dest/msg_validators/tx_validator/nullifier_cache.d.ts +14 -0
  151. package/dest/msg_validators/tx_validator/nullifier_cache.d.ts.map +1 -0
  152. package/dest/msg_validators/tx_validator/nullifier_cache.js +24 -0
  153. package/dest/msg_validators/tx_validator/phases_validator.d.ts +2 -2
  154. package/dest/msg_validators/tx_validator/phases_validator.d.ts.map +1 -1
  155. package/dest/msg_validators/tx_validator/phases_validator.js +44 -23
  156. package/dest/msg_validators/tx_validator/timestamp_validator.d.ts +20 -4
  157. package/dest/msg_validators/tx_validator/timestamp_validator.d.ts.map +1 -1
  158. package/dest/msg_validators/tx_validator/timestamp_validator.js +6 -6
  159. package/dest/services/dummy_service.d.ts +13 -5
  160. package/dest/services/dummy_service.d.ts.map +1 -1
  161. package/dest/services/dummy_service.js +10 -4
  162. package/dest/services/encoding.d.ts +3 -3
  163. package/dest/services/encoding.d.ts.map +1 -1
  164. package/dest/services/encoding.js +11 -10
  165. package/dest/services/gossipsub/index.d.ts +3 -0
  166. package/dest/services/gossipsub/index.d.ts.map +1 -0
  167. package/dest/services/gossipsub/index.js +2 -0
  168. package/dest/services/gossipsub/scoring.d.ts +21 -3
  169. package/dest/services/gossipsub/scoring.d.ts.map +1 -1
  170. package/dest/services/gossipsub/scoring.js +24 -7
  171. package/dest/services/gossipsub/topic_score_params.d.ts +173 -0
  172. package/dest/services/gossipsub/topic_score_params.d.ts.map +1 -0
  173. package/dest/services/gossipsub/topic_score_params.js +346 -0
  174. package/dest/services/libp2p/libp2p_service.d.ts +94 -42
  175. package/dest/services/libp2p/libp2p_service.d.ts.map +1 -1
  176. package/dest/services/libp2p/libp2p_service.js +463 -350
  177. package/dest/services/peer-manager/metrics.d.ts +3 -1
  178. package/dest/services/peer-manager/metrics.d.ts.map +1 -1
  179. package/dest/services/peer-manager/metrics.js +6 -0
  180. package/dest/services/peer-manager/peer_manager.d.ts +1 -1
  181. package/dest/services/peer-manager/peer_manager.d.ts.map +1 -1
  182. package/dest/services/peer-manager/peer_manager.js +2 -1
  183. package/dest/services/peer-manager/peer_scoring.d.ts +1 -1
  184. package/dest/services/peer-manager/peer_scoring.d.ts.map +1 -1
  185. package/dest/services/peer-manager/peer_scoring.js +25 -2
  186. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts +6 -5
  187. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts.map +1 -1
  188. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.js +26 -53
  189. package/dest/services/reqresp/batch-tx-requester/interface.d.ts +2 -6
  190. package/dest/services/reqresp/batch-tx-requester/interface.d.ts.map +1 -1
  191. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts +10 -13
  192. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts.map +1 -1
  193. package/dest/services/reqresp/batch-tx-requester/missing_txs.js +25 -46
  194. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts +17 -11
  195. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts.map +1 -1
  196. package/dest/services/reqresp/batch-tx-requester/peer_collection.js +49 -15
  197. package/dest/services/reqresp/batch-tx-requester/tx_validator.js +2 -2
  198. package/dest/services/reqresp/interface.d.ts +10 -1
  199. package/dest/services/reqresp/interface.d.ts.map +1 -1
  200. package/dest/services/reqresp/interface.js +15 -1
  201. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts +7 -5
  202. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts.map +1 -1
  203. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.js +16 -11
  204. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts +21 -10
  205. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts.map +1 -1
  206. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.js +27 -11
  207. package/dest/services/reqresp/protocols/tx.d.ts +7 -1
  208. package/dest/services/reqresp/protocols/tx.d.ts.map +1 -1
  209. package/dest/services/reqresp/protocols/tx.js +20 -0
  210. package/dest/services/reqresp/reqresp.d.ts +1 -1
  211. package/dest/services/reqresp/reqresp.d.ts.map +1 -1
  212. package/dest/services/reqresp/reqresp.js +13 -5
  213. package/dest/services/service.d.ts +39 -3
  214. package/dest/services/service.d.ts.map +1 -1
  215. package/dest/services/tx_collection/config.d.ts +22 -4
  216. package/dest/services/tx_collection/config.d.ts.map +1 -1
  217. package/dest/services/tx_collection/config.js +49 -3
  218. package/dest/services/tx_collection/fast_tx_collection.d.ts +6 -5
  219. package/dest/services/tx_collection/fast_tx_collection.d.ts.map +1 -1
  220. package/dest/services/tx_collection/fast_tx_collection.js +64 -48
  221. package/dest/services/tx_collection/file_store_tx_collection.d.ts +53 -0
  222. package/dest/services/tx_collection/file_store_tx_collection.d.ts.map +1 -0
  223. package/dest/services/tx_collection/file_store_tx_collection.js +167 -0
  224. package/dest/services/tx_collection/file_store_tx_source.d.ts +37 -0
  225. package/dest/services/tx_collection/file_store_tx_source.d.ts.map +1 -0
  226. package/dest/services/tx_collection/file_store_tx_source.js +90 -0
  227. package/dest/services/tx_collection/index.d.ts +3 -2
  228. package/dest/services/tx_collection/index.d.ts.map +1 -1
  229. package/dest/services/tx_collection/index.js +1 -0
  230. package/dest/services/tx_collection/instrumentation.d.ts +1 -1
  231. package/dest/services/tx_collection/instrumentation.d.ts.map +1 -1
  232. package/dest/services/tx_collection/instrumentation.js +2 -1
  233. package/dest/services/tx_collection/missing_txs_tracker.d.ts +32 -0
  234. package/dest/services/tx_collection/missing_txs_tracker.d.ts.map +1 -0
  235. package/dest/services/tx_collection/missing_txs_tracker.js +27 -0
  236. package/dest/services/tx_collection/proposal_tx_collector.d.ts +15 -14
  237. package/dest/services/tx_collection/proposal_tx_collector.d.ts.map +1 -1
  238. package/dest/services/tx_collection/proposal_tx_collector.js +6 -6
  239. package/dest/services/tx_collection/slow_tx_collection.d.ts +7 -3
  240. package/dest/services/tx_collection/slow_tx_collection.d.ts.map +1 -1
  241. package/dest/services/tx_collection/slow_tx_collection.js +60 -26
  242. package/dest/services/tx_collection/tx_collection.d.ts +23 -10
  243. package/dest/services/tx_collection/tx_collection.d.ts.map +1 -1
  244. package/dest/services/tx_collection/tx_collection.js +75 -3
  245. package/dest/services/tx_collection/tx_collection_sink.d.ts +18 -8
  246. package/dest/services/tx_collection/tx_collection_sink.d.ts.map +1 -1
  247. package/dest/services/tx_collection/tx_collection_sink.js +26 -29
  248. package/dest/services/tx_collection/tx_source.d.ts +8 -3
  249. package/dest/services/tx_collection/tx_source.d.ts.map +1 -1
  250. package/dest/services/tx_collection/tx_source.js +19 -2
  251. package/dest/services/tx_file_store/config.d.ts +1 -3
  252. package/dest/services/tx_file_store/config.d.ts.map +1 -1
  253. package/dest/services/tx_file_store/config.js +0 -4
  254. package/dest/services/tx_file_store/tx_file_store.d.ts +4 -3
  255. package/dest/services/tx_file_store/tx_file_store.d.ts.map +1 -1
  256. package/dest/services/tx_file_store/tx_file_store.js +9 -6
  257. package/dest/services/tx_provider.d.ts +4 -4
  258. package/dest/services/tx_provider.d.ts.map +1 -1
  259. package/dest/services/tx_provider.js +9 -8
  260. package/dest/test-helpers/make-test-p2p-clients.d.ts +7 -8
  261. package/dest/test-helpers/make-test-p2p-clients.d.ts.map +1 -1
  262. package/dest/test-helpers/make-test-p2p-clients.js +1 -2
  263. package/dest/test-helpers/mock-pubsub.d.ts +30 -4
  264. package/dest/test-helpers/mock-pubsub.d.ts.map +1 -1
  265. package/dest/test-helpers/mock-pubsub.js +105 -4
  266. package/dest/test-helpers/reqresp-nodes.d.ts +2 -3
  267. package/dest/test-helpers/reqresp-nodes.d.ts.map +1 -1
  268. package/dest/test-helpers/reqresp-nodes.js +4 -3
  269. package/dest/test-helpers/testbench-utils.d.ts +43 -38
  270. package/dest/test-helpers/testbench-utils.d.ts.map +1 -1
  271. package/dest/test-helpers/testbench-utils.js +129 -59
  272. package/dest/testbench/p2p_client_testbench_worker.d.ts +2 -2
  273. package/dest/testbench/p2p_client_testbench_worker.d.ts.map +1 -1
  274. package/dest/testbench/p2p_client_testbench_worker.js +17 -16
  275. package/dest/testbench/worker_client_manager.d.ts +3 -1
  276. package/dest/testbench/worker_client_manager.d.ts.map +1 -1
  277. package/dest/testbench/worker_client_manager.js +6 -2
  278. package/dest/util.d.ts +3 -3
  279. package/dest/util.d.ts.map +1 -1
  280. package/package.json +14 -14
  281. package/src/client/factory.ts +82 -28
  282. package/src/client/interface.ts +56 -34
  283. package/src/client/p2p_client.ts +181 -269
  284. package/src/client/test/tx_proposal_collector/proposal_tx_collector_worker.ts +21 -12
  285. package/src/config.ts +141 -44
  286. package/src/errors/tx-pool.error.ts +12 -0
  287. package/src/index.ts +1 -0
  288. package/src/mem_pools/attestation_pool/attestation_pool.ts +497 -91
  289. package/src/mem_pools/attestation_pool/attestation_pool_test_suite.ts +442 -102
  290. package/src/mem_pools/attestation_pool/index.ts +9 -2
  291. package/src/mem_pools/attestation_pool/mocks.ts +2 -1
  292. package/src/mem_pools/index.ts +4 -1
  293. package/src/mem_pools/instrumentation.ts +17 -13
  294. package/src/mem_pools/interface.ts +4 -4
  295. package/src/mem_pools/tx_pool/README.md +1 -1
  296. package/src/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.ts +3 -3
  297. package/src/mem_pools/tx_pool/priority.ts +6 -3
  298. package/src/mem_pools/tx_pool/tx_pool_test_suite.ts +3 -1
  299. package/src/mem_pools/tx_pool_v2/README.md +283 -0
  300. package/src/mem_pools/tx_pool_v2/archive/index.ts +1 -0
  301. package/src/mem_pools/tx_pool_v2/archive/tx_archive.ts +120 -0
  302. package/src/mem_pools/tx_pool_v2/deleted_pool.ts +321 -0
  303. package/src/mem_pools/tx_pool_v2/eviction/eviction_manager.ts +160 -0
  304. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.ts +121 -0
  305. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.ts +125 -0
  306. package/src/mem_pools/tx_pool_v2/eviction/index.ts +27 -0
  307. package/src/mem_pools/tx_pool_v2/eviction/interfaces.ts +219 -0
  308. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.ts +74 -0
  309. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.ts +101 -0
  310. package/src/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.ts +91 -0
  311. package/src/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.ts +99 -0
  312. package/src/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.ts +32 -0
  313. package/src/mem_pools/tx_pool_v2/index.ts +12 -0
  314. package/src/mem_pools/tx_pool_v2/instrumentation.ts +69 -0
  315. package/src/mem_pools/tx_pool_v2/interfaces.ts +245 -0
  316. package/src/mem_pools/tx_pool_v2/tx_metadata.ts +327 -0
  317. package/src/mem_pools/tx_pool_v2/tx_pool_bench_metrics.ts +77 -0
  318. package/src/mem_pools/tx_pool_v2/tx_pool_indices.ts +430 -0
  319. package/src/mem_pools/tx_pool_v2/tx_pool_v2.ts +226 -0
  320. package/src/mem_pools/tx_pool_v2/tx_pool_v2_impl.ts +1097 -0
  321. package/src/msg_validators/attestation_validator/fisherman_attestation_validator.ts +2 -2
  322. package/src/msg_validators/proposal_validator/block_proposal_validator.ts +14 -4
  323. package/src/msg_validators/proposal_validator/checkpoint_proposal_validator.ts +20 -7
  324. package/src/msg_validators/proposal_validator/proposal_validator.ts +63 -40
  325. package/src/msg_validators/tx_validator/README.md +115 -0
  326. package/src/msg_validators/tx_validator/aggregate_tx_validator.ts +5 -5
  327. package/src/msg_validators/tx_validator/allowed_public_setup.ts +22 -27
  328. package/src/msg_validators/tx_validator/allowed_setup_helpers.ts +31 -0
  329. package/src/msg_validators/tx_validator/block_header_validator.ts +15 -3
  330. package/src/msg_validators/tx_validator/double_spend_validator.ts +11 -6
  331. package/src/msg_validators/tx_validator/factory.ts +366 -77
  332. package/src/msg_validators/tx_validator/fee_payer_balance.ts +6 -2
  333. package/src/msg_validators/tx_validator/gas_validator.ts +123 -27
  334. package/src/msg_validators/tx_validator/index.ts +2 -0
  335. package/src/msg_validators/tx_validator/metadata_validator.ts +12 -4
  336. package/src/msg_validators/tx_validator/nullifier_cache.ts +30 -0
  337. package/src/msg_validators/tx_validator/phases_validator.ts +51 -26
  338. package/src/msg_validators/tx_validator/timestamp_validator.ts +23 -18
  339. package/src/services/dummy_service.ts +18 -6
  340. package/src/services/encoding.ts +9 -9
  341. package/src/services/gossipsub/README.md +641 -0
  342. package/src/services/gossipsub/index.ts +2 -0
  343. package/src/services/gossipsub/scoring.ts +29 -5
  344. package/src/services/gossipsub/topic_score_params.ts +487 -0
  345. package/src/services/libp2p/libp2p_service.ts +488 -372
  346. package/src/services/peer-manager/metrics.ts +7 -0
  347. package/src/services/peer-manager/peer_manager.ts +2 -1
  348. package/src/services/peer-manager/peer_scoring.ts +25 -0
  349. package/src/services/reqresp/batch-tx-requester/README.md +7 -7
  350. package/src/services/reqresp/batch-tx-requester/batch_tx_requester.ts +31 -59
  351. package/src/services/reqresp/batch-tx-requester/interface.ts +1 -5
  352. package/src/services/reqresp/batch-tx-requester/missing_txs.ts +23 -71
  353. package/src/services/reqresp/batch-tx-requester/peer_collection.ts +63 -24
  354. package/src/services/reqresp/batch-tx-requester/tx_validator.ts +2 -2
  355. package/src/services/reqresp/interface.ts +26 -1
  356. package/src/services/reqresp/protocols/block_txs/block_txs_handler.ts +23 -14
  357. package/src/services/reqresp/protocols/block_txs/block_txs_reqresp.ts +38 -15
  358. package/src/services/reqresp/protocols/tx.ts +22 -0
  359. package/src/services/reqresp/reqresp.ts +16 -4
  360. package/src/services/service.ts +51 -2
  361. package/src/services/tx_collection/config.ts +74 -6
  362. package/src/services/tx_collection/fast_tx_collection.ts +74 -51
  363. package/src/services/tx_collection/file_store_tx_collection.ts +202 -0
  364. package/src/services/tx_collection/file_store_tx_source.ts +117 -0
  365. package/src/services/tx_collection/index.ts +2 -1
  366. package/src/services/tx_collection/instrumentation.ts +7 -1
  367. package/src/services/tx_collection/missing_txs_tracker.ts +52 -0
  368. package/src/services/tx_collection/proposal_tx_collector.ts +20 -21
  369. package/src/services/tx_collection/slow_tx_collection.ts +66 -33
  370. package/src/services/tx_collection/tx_collection.ts +113 -16
  371. package/src/services/tx_collection/tx_collection_sink.ts +30 -34
  372. package/src/services/tx_collection/tx_source.ts +22 -3
  373. package/src/services/tx_file_store/config.ts +0 -6
  374. package/src/services/tx_file_store/tx_file_store.ts +10 -8
  375. package/src/services/tx_provider.ts +10 -9
  376. package/src/test-helpers/make-test-p2p-clients.ts +4 -6
  377. package/src/test-helpers/mock-pubsub.ts +146 -9
  378. package/src/test-helpers/reqresp-nodes.ts +5 -7
  379. package/src/test-helpers/testbench-utils.ts +128 -71
  380. package/src/testbench/p2p_client_testbench_worker.ts +26 -22
  381. package/src/testbench/worker_client_manager.ts +13 -5
  382. package/src/util.ts +8 -2
  383. package/dest/mem_pools/attestation_pool/kv_attestation_pool.d.ts +0 -40
  384. package/dest/mem_pools/attestation_pool/kv_attestation_pool.d.ts.map +0 -1
  385. package/dest/mem_pools/attestation_pool/kv_attestation_pool.js +0 -218
  386. package/dest/mem_pools/attestation_pool/memory_attestation_pool.d.ts +0 -31
  387. package/dest/mem_pools/attestation_pool/memory_attestation_pool.d.ts.map +0 -1
  388. package/dest/mem_pools/attestation_pool/memory_attestation_pool.js +0 -180
  389. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.d.ts +0 -23
  390. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.d.ts.map +0 -1
  391. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.js +0 -212
  392. package/src/mem_pools/attestation_pool/kv_attestation_pool.ts +0 -320
  393. package/src/mem_pools/attestation_pool/memory_attestation_pool.ts +0 -264
  394. package/src/msg_validators/proposal_validator/proposal_validator_test_suite.ts +0 -230
@@ -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,
@@ -31,13 +38,26 @@ export interface P2PConfig
31
38
  BatchTxRequesterConfig,
32
39
  ChainConfig,
33
40
  TxCollectionConfig,
34
- TxFileStoreConfig {
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
+
46
+ /** Maximum L2 gas per block for validation. When set, txs exceeding this limit are rejected. */
47
+ validateMaxL2BlockGas?: number;
48
+
49
+ /** Maximum DA gas per block for validation. When set, txs exceeding this limit are rejected. */
50
+ validateMaxDABlockGas?: number;
51
+
35
52
  /** A flag dictating whether the P2P subsystem should be enabled. */
36
53
  p2pEnabled: boolean;
37
54
 
38
55
  /** The frequency in which to check for new L2 blocks. */
39
56
  blockCheckIntervalMS: number;
40
57
 
58
+ /** The frequency in which to check for new L2 slots. */
59
+ slotCheckIntervalMS: number;
60
+
41
61
  /** The number of blocks to fetch in a single batch. */
42
62
  blockRequestBatchSize: number;
43
63
 
@@ -140,8 +160,8 @@ export interface P2PConfig
140
160
  /** The maximum possible size of the P2P DB in KB. Overwrites the general dataStoreMapSizeKb. */
141
161
  p2pStoreMapSizeKb?: number;
142
162
 
143
- /** Which calls are allowed in the public setup phase of a tx. */
144
- txPublicSetupAllowList: AllowedElement[];
163
+ /** Additional entries to extend the default setup allow list. */
164
+ txPublicSetupAllowListExtend: AllowedElement[];
145
165
 
146
166
  /** The maximum number of pending txs before evicting lower priority txs. */
147
167
  maxPendingTxCount: number;
@@ -163,10 +183,7 @@ export interface P2PConfig
163
183
  /** Whether transactions are disabled for this node. This means transactions will be rejected at the RPC and P2P layers. */
164
184
  disableTransactions: boolean;
165
185
 
166
- /** True to simulate discarding transactions. - For testing purposes only*/
167
- dropTransactions: boolean;
168
-
169
- /** The probability that a transaction is discarded. - For testing purposes only */
186
+ /** The probability that a transaction is discarded (0 = disabled). - For testing purposes only */
170
187
  dropTransactionsProbability: number;
171
188
 
172
189
  /** Whether to delete transactions from the pool after a reorg instead of moving them back to pending. */
@@ -177,11 +194,36 @@ export interface P2PConfig
177
194
 
178
195
  /** Whether to run in fisherman mode: validates all proposals and attestations but does not broadcast attestations or participate in consensus */
179
196
  fishermanMode: boolean;
197
+
198
+ /** Broadcast block proposals even when a conflicting proposal for the same slot already exists in the pool (for testing purposes only). */
199
+ broadcastEquivocatedProposals?: boolean;
200
+
201
+ /** Minimum age (ms) a transaction must have been in the pool before it's eligible for block building. */
202
+ minTxPoolAgeMs: number;
203
+
204
+ /** Minimum percentage fee increase required to replace an existing tx via RPC (0 = no bump). */
205
+ priceBumpPercentage: bigint;
180
206
  }
181
207
 
182
208
  export const DEFAULT_P2P_PORT = 40400;
183
209
 
184
210
  export const p2pConfigMappings: ConfigMappingsType<P2PConfig> = {
211
+ validateMaxTxsPerBlock: {
212
+ env: 'VALIDATOR_MAX_TX_PER_BLOCK',
213
+ description:
214
+ 'Maximum transactions per block for validation. Overrides maxTxsPerBlock for gossip validation when set.',
215
+ parseEnv: (val: string) => (val ? parseInt(val, 10) : undefined),
216
+ },
217
+ validateMaxL2BlockGas: {
218
+ env: 'VALIDATOR_MAX_L2_BLOCK_GAS',
219
+ description: 'Maximum L2 gas per block for validation. When set, txs exceeding this limit are rejected.',
220
+ parseEnv: (val: string) => (val ? parseInt(val, 10) : undefined),
221
+ },
222
+ validateMaxDABlockGas: {
223
+ env: 'VALIDATOR_MAX_DA_BLOCK_GAS',
224
+ description: 'Maximum DA gas per block for validation. When set, txs exceeding this limit are rejected.',
225
+ parseEnv: (val: string) => (val ? parseInt(val, 10) : undefined),
226
+ },
185
227
  p2pEnabled: {
186
228
  env: 'P2P_ENABLED',
187
229
  description: 'A flag dictating whether the P2P subsystem should be enabled.',
@@ -197,6 +239,11 @@ export const p2pConfigMappings: ConfigMappingsType<P2PConfig> = {
197
239
  description: 'The frequency in which to check for new L2 blocks.',
198
240
  ...numberConfigHelper(100),
199
241
  },
242
+ slotCheckIntervalMS: {
243
+ env: 'P2P_SLOT_CHECK_INTERVAL_MS',
244
+ description: 'The frequency in which to check for new L2 slots.',
245
+ ...numberConfigHelper(1000),
246
+ },
200
247
  debugDisableColocationPenalty: {
201
248
  env: 'DEBUG_P2P_DISABLE_COLOCATION_PENALTY',
202
249
  description: 'DEBUG: Disable colocation penalty - NEVER set to true in production',
@@ -375,12 +422,13 @@ export const p2pConfigMappings: ConfigMappingsType<P2PConfig> = {
375
422
  parseEnv: (val: string | undefined) => (val ? +val : undefined),
376
423
  description: 'The maximum possible size of the P2P DB in KB. Overwrites the general dataStoreMapSizeKb.',
377
424
  },
378
- txPublicSetupAllowList: {
425
+ txPublicSetupAllowListExtend: {
379
426
  env: 'TX_PUBLIC_SETUP_ALLOWLIST',
380
427
  parseEnv: (val: string) => parseAllowList(val),
381
- description: 'The list of functions calls allowed to run in setup',
428
+ description:
429
+ '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 +.',
382
430
  printDefault: () =>
383
- 'AuthRegistry, FeeJuice.increase_public_balance, Token.increase_public_balance, FPC.prepare_fee',
431
+ 'Default: AuthRegistry._set_authorized, AuthRegistry.set_authorized, FeeJuice._increase_public_balance',
384
432
  },
385
433
  maxPendingTxCount: {
386
434
  env: 'P2P_MAX_PENDING_TX_COUNT',
@@ -409,11 +457,6 @@ export const p2pConfigMappings: ConfigMappingsType<P2PConfig> = {
409
457
  description: 'Number of auth attempts to allow before peer is banned. Number is inclusive',
410
458
  ...numberConfigHelper(3),
411
459
  },
412
- dropTransactions: {
413
- env: 'P2P_DROP_TX',
414
- description: 'True to simulate discarding transactions. - For testing purposes only',
415
- ...booleanConfigHelper(false),
416
- },
417
460
  dropTransactionsProbability: {
418
461
  env: 'P2P_DROP_TX_CHANCE',
419
462
  description: 'The probability that a transaction is discarded (0 - 1). - For testing purposes only',
@@ -441,6 +484,23 @@ export const p2pConfigMappings: ConfigMappingsType<P2PConfig> = {
441
484
  'Whether to run in fisherman mode: validates all proposals and attestations but does not broadcast attestations or participate in consensus.',
442
485
  ...booleanConfigHelper(false),
443
486
  },
487
+ broadcastEquivocatedProposals: {
488
+ description:
489
+ 'Broadcast block proposals even when a conflicting proposal for the same slot already exists in the pool (for testing purposes only).',
490
+ ...booleanConfigHelper(false),
491
+ },
492
+ minTxPoolAgeMs: {
493
+ env: 'P2P_MIN_TX_POOL_AGE_MS',
494
+ description: 'Minimum age (ms) a transaction must have been in the pool before it is eligible for block building.',
495
+ ...numberConfigHelper(2_000),
496
+ },
497
+ priceBumpPercentage: {
498
+ env: 'P2P_RPC_PRICE_BUMP_PERCENTAGE',
499
+ description:
500
+ 'Minimum percentage fee increase required to replace an existing tx via RPC. Even at 0%, replacement still requires paying at least 1 unit more.',
501
+ ...bigintConfigHelper(10n),
502
+ },
503
+ ...sharedSequencerConfigMappings,
444
504
  ...p2pReqRespConfigMappings,
445
505
  ...batchTxRequesterConfigMappings,
446
506
  ...chainConfigMappings,
@@ -497,13 +557,44 @@ export const bootnodeConfigMappings = pickConfigMappings(
497
557
  bootnodeConfigKeys,
498
558
  );
499
559
 
560
+ /**
561
+ * Parses a `+`-separated flags string into validation properties for an allow list entry.
562
+ * Supported flags: `os` (onlySelf), `rn` (rejectNullMsgSender), `cl=N` (calldataLength).
563
+ */
564
+ function parseFlags(
565
+ flags: string,
566
+ entry: string,
567
+ ): { onlySelf?: boolean; rejectNullMsgSender?: boolean; calldataLength?: number } {
568
+ const result: { onlySelf?: boolean; rejectNullMsgSender?: boolean; calldataLength?: number } = {};
569
+ for (const flag of flags.split('+')) {
570
+ if (flag === 'os') {
571
+ result.onlySelf = true;
572
+ } else if (flag === 'rn') {
573
+ result.rejectNullMsgSender = true;
574
+ } else if (flag.startsWith('cl=')) {
575
+ const n = parseInt(flag.slice(3), 10);
576
+ if (isNaN(n) || n < 0) {
577
+ throw new Error(
578
+ `Invalid allow list entry "${entry}": invalid calldataLength in flag "${flag}". Expected a non-negative integer.`,
579
+ );
580
+ }
581
+ result.calldataLength = n;
582
+ } else {
583
+ throw new Error(`Invalid allow list entry "${entry}": unknown flag "${flag}". Supported flags: os, rn, cl=N.`);
584
+ }
585
+ }
586
+ return result;
587
+ }
588
+
500
589
  /**
501
590
  * Parses a string to a list of allowed elements.
502
- * Each encoded is expected to be of one of the following formats
503
- * `I:${address}`
504
- * `I:${address}:${selector}`
505
- * `C:${classId}`
506
- * `C:${classId}:${selector}`
591
+ * Each entry is expected to be of one of the following formats:
592
+ * `I:${address}:${selector}` — instance (contract address) with function selector
593
+ * `C:${classId}:${selector}` — class with function selector
594
+ *
595
+ * An optional flags segment can be appended after the selector:
596
+ * `I:${address}:${selector}:${flags}` or `C:${classId}:${selector}:${flags}`
597
+ * where flags is a `+`-separated list of: `os` (onlySelf), `rn` (rejectNullMsgSender), `cl=N` (calldataLength).
507
598
  *
508
599
  * @param value The string to parse
509
600
  * @returns A list of allowed elements
@@ -516,31 +607,37 @@ export function parseAllowList(value: string): AllowedElement[] {
516
607
  }
517
608
 
518
609
  for (const val of value.split(',')) {
519
- const [typeString, identifierString, selectorString] = val.split(':');
520
- const selector = selectorString !== undefined ? FunctionSelector.fromString(selectorString) : undefined;
610
+ const trimmed = val.trim();
611
+ if (!trimmed) {
612
+ continue;
613
+ }
614
+ const [typeString, identifierString, selectorString, flagsString] = trimmed.split(':');
615
+
616
+ if (!selectorString) {
617
+ throw new Error(
618
+ `Invalid allow list entry "${trimmed}": selector is required. Expected format: I:address:selector or C:classId:selector`,
619
+ );
620
+ }
621
+
622
+ const selector = FunctionSelector.fromString(selectorString);
623
+ const flags = flagsString ? parseFlags(flagsString, trimmed) : {};
521
624
 
522
625
  if (typeString === 'I') {
523
- if (selector) {
524
- entries.push({
525
- address: AztecAddress.fromString(identifierString),
526
- selector,
527
- });
528
- } else {
529
- entries.push({
530
- address: AztecAddress.fromString(identifierString),
531
- });
532
- }
626
+ entries.push({
627
+ address: AztecAddress.fromString(identifierString),
628
+ selector,
629
+ ...flags,
630
+ });
533
631
  } else if (typeString === 'C') {
534
- if (selector) {
535
- entries.push({
536
- classId: Fr.fromHexString(identifierString),
537
- selector,
538
- });
539
- } else {
540
- entries.push({
541
- classId: Fr.fromHexString(identifierString),
542
- });
543
- }
632
+ entries.push({
633
+ classId: Fr.fromHexString(identifierString),
634
+ selector,
635
+ ...flags,
636
+ });
637
+ } else {
638
+ throw new Error(
639
+ `Invalid allow list entry "${trimmed}": unknown type "${typeString}". Expected "I" (instance) or "C" (class).`,
640
+ );
544
641
  }
545
642
  }
546
643
 
@@ -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';