@aztec/p2p 0.0.1-commit.e61ad554 → 0.0.1-commit.ec5f612

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 (445) hide show
  1. package/dest/bootstrap/bootstrap.d.ts +4 -3
  2. package/dest/bootstrap/bootstrap.d.ts.map +1 -1
  3. package/dest/bootstrap/bootstrap.js +4 -4
  4. package/dest/client/factory.d.ts +10 -10
  5. package/dest/client/factory.d.ts.map +1 -1
  6. package/dest/client/factory.js +45 -18
  7. package/dest/client/interface.d.ts +46 -33
  8. package/dest/client/interface.d.ts.map +1 -1
  9. package/dest/client/p2p_client.d.ts +41 -51
  10. package/dest/client/p2p_client.d.ts.map +1 -1
  11. package/dest/client/p2p_client.js +156 -200
  12. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker.d.ts +2 -0
  13. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker.d.ts.map +1 -0
  14. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker.js +304 -0
  15. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.d.ts +73 -0
  16. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.d.ts.map +1 -0
  17. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.js +8 -0
  18. package/dest/config.d.ts +35 -7
  19. package/dest/config.d.ts.map +1 -1
  20. package/dest/config.js +21 -7
  21. package/dest/errors/tx-pool.error.d.ts +8 -0
  22. package/dest/errors/tx-pool.error.d.ts.map +1 -0
  23. package/dest/errors/tx-pool.error.js +9 -0
  24. package/dest/index.d.ts +2 -1
  25. package/dest/index.d.ts.map +1 -1
  26. package/dest/index.js +1 -0
  27. package/dest/mem_pools/attestation_pool/attestation_pool.d.ts +104 -88
  28. package/dest/mem_pools/attestation_pool/attestation_pool.d.ts.map +1 -1
  29. package/dest/mem_pools/attestation_pool/attestation_pool.js +441 -3
  30. package/dest/mem_pools/attestation_pool/attestation_pool_test_suite.d.ts +2 -2
  31. package/dest/mem_pools/attestation_pool/attestation_pool_test_suite.d.ts.map +1 -1
  32. package/dest/mem_pools/attestation_pool/attestation_pool_test_suite.js +353 -87
  33. package/dest/mem_pools/attestation_pool/index.d.ts +2 -3
  34. package/dest/mem_pools/attestation_pool/index.d.ts.map +1 -1
  35. package/dest/mem_pools/attestation_pool/index.js +1 -2
  36. package/dest/mem_pools/attestation_pool/mocks.d.ts +2 -2
  37. package/dest/mem_pools/attestation_pool/mocks.d.ts.map +1 -1
  38. package/dest/mem_pools/attestation_pool/mocks.js +2 -2
  39. package/dest/mem_pools/index.d.ts +3 -2
  40. package/dest/mem_pools/index.d.ts.map +1 -1
  41. package/dest/mem_pools/index.js +1 -1
  42. package/dest/mem_pools/instrumentation.d.ts +1 -1
  43. package/dest/mem_pools/instrumentation.d.ts.map +1 -1
  44. package/dest/mem_pools/instrumentation.js +2 -2
  45. package/dest/mem_pools/interface.d.ts +5 -5
  46. package/dest/mem_pools/interface.d.ts.map +1 -1
  47. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.js +3 -3
  48. package/dest/mem_pools/tx_pool_v2/archive/index.d.ts +2 -0
  49. package/dest/mem_pools/tx_pool_v2/archive/index.d.ts.map +1 -0
  50. package/dest/mem_pools/tx_pool_v2/archive/index.js +1 -0
  51. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.d.ts +43 -0
  52. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.d.ts.map +1 -0
  53. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.js +103 -0
  54. package/dest/mem_pools/tx_pool_v2/deleted_pool.d.ts +104 -0
  55. package/dest/mem_pools/tx_pool_v2/deleted_pool.d.ts.map +1 -0
  56. package/dest/mem_pools/tx_pool_v2/deleted_pool.js +251 -0
  57. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.d.ts +47 -0
  58. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.d.ts.map +1 -0
  59. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.js +128 -0
  60. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.d.ts +17 -0
  61. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.d.ts.map +1 -0
  62. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.js +93 -0
  63. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.d.ts +19 -0
  64. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.d.ts.map +1 -0
  65. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.js +97 -0
  66. package/dest/mem_pools/tx_pool_v2/eviction/index.d.ts +10 -0
  67. package/dest/mem_pools/tx_pool_v2/eviction/index.d.ts.map +1 -0
  68. package/dest/mem_pools/tx_pool_v2/eviction/index.js +11 -0
  69. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.d.ts +174 -0
  70. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.d.ts.map +1 -0
  71. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.js +25 -0
  72. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.d.ts +15 -0
  73. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.d.ts.map +1 -0
  74. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.js +65 -0
  75. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.d.ts +17 -0
  76. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.d.ts.map +1 -0
  77. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.js +93 -0
  78. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.d.ts +16 -0
  79. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.d.ts.map +1 -0
  80. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.js +78 -0
  81. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.d.ts +20 -0
  82. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.d.ts.map +1 -0
  83. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.js +73 -0
  84. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.d.ts +15 -0
  85. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.d.ts.map +1 -0
  86. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.js +19 -0
  87. package/dest/mem_pools/tx_pool_v2/index.d.ts +6 -0
  88. package/dest/mem_pools/tx_pool_v2/index.d.ts.map +1 -0
  89. package/dest/mem_pools/tx_pool_v2/index.js +5 -0
  90. package/dest/mem_pools/tx_pool_v2/instrumentation.d.ts +15 -0
  91. package/dest/mem_pools/tx_pool_v2/instrumentation.d.ts.map +1 -0
  92. package/dest/mem_pools/tx_pool_v2/instrumentation.js +43 -0
  93. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts +211 -0
  94. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts.map +1 -0
  95. package/dest/mem_pools/tx_pool_v2/interfaces.js +9 -0
  96. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts +119 -0
  97. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts.map +1 -0
  98. package/dest/mem_pools/tx_pool_v2/tx_metadata.js +193 -0
  99. package/dest/mem_pools/tx_pool_v2/tx_pool_bench_metrics.d.ts +26 -0
  100. package/dest/mem_pools/tx_pool_v2/tx_pool_bench_metrics.d.ts.map +1 -0
  101. package/dest/mem_pools/tx_pool_v2/tx_pool_bench_metrics.js +70 -0
  102. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.d.ts +108 -0
  103. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.d.ts.map +1 -0
  104. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.js +354 -0
  105. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts +60 -0
  106. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts.map +1 -0
  107. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.js +161 -0
  108. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts +77 -0
  109. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts.map +1 -0
  110. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.js +905 -0
  111. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts +3 -3
  112. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts.map +1 -1
  113. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.js +7 -2
  114. package/dest/msg_validators/proposal_validator/proposal_validator.js +5 -5
  115. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts +4 -4
  116. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts.map +1 -1
  117. package/dest/msg_validators/tx_validator/aggregate_tx_validator.js +3 -3
  118. package/dest/msg_validators/tx_validator/archive_cache.d.ts +3 -3
  119. package/dest/msg_validators/tx_validator/archive_cache.d.ts.map +1 -1
  120. package/dest/msg_validators/tx_validator/archive_cache.js +1 -1
  121. package/dest/msg_validators/tx_validator/block_header_validator.d.ts +20 -6
  122. package/dest/msg_validators/tx_validator/block_header_validator.d.ts.map +1 -1
  123. package/dest/msg_validators/tx_validator/block_header_validator.js +5 -4
  124. package/dest/msg_validators/tx_validator/data_validator.d.ts +3 -1
  125. package/dest/msg_validators/tx_validator/data_validator.d.ts.map +1 -1
  126. package/dest/msg_validators/tx_validator/data_validator.js +4 -1
  127. package/dest/msg_validators/tx_validator/double_spend_validator.d.ts +15 -4
  128. package/dest/msg_validators/tx_validator/double_spend_validator.d.ts.map +1 -1
  129. package/dest/msg_validators/tx_validator/double_spend_validator.js +7 -6
  130. package/dest/msg_validators/tx_validator/factory.d.ts +118 -5
  131. package/dest/msg_validators/tx_validator/factory.d.ts.map +1 -1
  132. package/dest/msg_validators/tx_validator/factory.js +228 -57
  133. package/dest/msg_validators/tx_validator/gas_validator.d.ts +59 -3
  134. package/dest/msg_validators/tx_validator/gas_validator.d.ts.map +1 -1
  135. package/dest/msg_validators/tx_validator/gas_validator.js +76 -38
  136. package/dest/msg_validators/tx_validator/index.d.ts +2 -1
  137. package/dest/msg_validators/tx_validator/index.d.ts.map +1 -1
  138. package/dest/msg_validators/tx_validator/index.js +1 -0
  139. package/dest/msg_validators/tx_validator/metadata_validator.d.ts +3 -2
  140. package/dest/msg_validators/tx_validator/metadata_validator.d.ts.map +1 -1
  141. package/dest/msg_validators/tx_validator/metadata_validator.js +2 -2
  142. package/dest/msg_validators/tx_validator/nullifier_cache.d.ts +14 -0
  143. package/dest/msg_validators/tx_validator/nullifier_cache.d.ts.map +1 -0
  144. package/dest/msg_validators/tx_validator/nullifier_cache.js +24 -0
  145. package/dest/msg_validators/tx_validator/phases_validator.d.ts +3 -2
  146. package/dest/msg_validators/tx_validator/phases_validator.d.ts.map +1 -1
  147. package/dest/msg_validators/tx_validator/phases_validator.js +3 -3
  148. package/dest/msg_validators/tx_validator/size_validator.d.ts +3 -1
  149. package/dest/msg_validators/tx_validator/size_validator.d.ts.map +1 -1
  150. package/dest/msg_validators/tx_validator/size_validator.js +4 -1
  151. package/dest/msg_validators/tx_validator/timestamp_validator.d.ts +22 -5
  152. package/dest/msg_validators/tx_validator/timestamp_validator.d.ts.map +1 -1
  153. package/dest/msg_validators/tx_validator/timestamp_validator.js +8 -8
  154. package/dest/msg_validators/tx_validator/tx_permitted_validator.d.ts +3 -2
  155. package/dest/msg_validators/tx_validator/tx_permitted_validator.d.ts.map +1 -1
  156. package/dest/msg_validators/tx_validator/tx_permitted_validator.js +2 -2
  157. package/dest/msg_validators/tx_validator/tx_proof_validator.d.ts +3 -2
  158. package/dest/msg_validators/tx_validator/tx_proof_validator.d.ts.map +1 -1
  159. package/dest/msg_validators/tx_validator/tx_proof_validator.js +2 -2
  160. package/dest/services/data_store.d.ts +1 -1
  161. package/dest/services/data_store.d.ts.map +1 -1
  162. package/dest/services/data_store.js +10 -6
  163. package/dest/services/discv5/discV5_service.js +1 -1
  164. package/dest/services/dummy_service.d.ts +24 -4
  165. package/dest/services/dummy_service.d.ts.map +1 -1
  166. package/dest/services/dummy_service.js +46 -1
  167. package/dest/services/encoding.d.ts +3 -3
  168. package/dest/services/encoding.d.ts.map +1 -1
  169. package/dest/services/encoding.js +11 -10
  170. package/dest/services/gossipsub/index.d.ts +3 -0
  171. package/dest/services/gossipsub/index.d.ts.map +1 -0
  172. package/dest/services/gossipsub/index.js +2 -0
  173. package/dest/services/gossipsub/scoring.d.ts +21 -3
  174. package/dest/services/gossipsub/scoring.d.ts.map +1 -1
  175. package/dest/services/gossipsub/scoring.js +24 -7
  176. package/dest/services/gossipsub/topic_score_params.d.ts +173 -0
  177. package/dest/services/gossipsub/topic_score_params.d.ts.map +1 -0
  178. package/dest/services/gossipsub/topic_score_params.js +346 -0
  179. package/dest/services/index.d.ts +2 -1
  180. package/dest/services/index.d.ts.map +1 -1
  181. package/dest/services/index.js +1 -0
  182. package/dest/services/libp2p/instrumentation.d.ts +1 -1
  183. package/dest/services/libp2p/instrumentation.d.ts.map +1 -1
  184. package/dest/services/libp2p/instrumentation.js +14 -3
  185. package/dest/services/libp2p/libp2p_service.d.ts +100 -42
  186. package/dest/services/libp2p/libp2p_service.d.ts.map +1 -1
  187. package/dest/services/libp2p/libp2p_service.js +451 -359
  188. package/dest/services/peer-manager/metrics.d.ts +2 -2
  189. package/dest/services/peer-manager/metrics.d.ts.map +1 -1
  190. package/dest/services/peer-manager/metrics.js +20 -5
  191. package/dest/services/peer-manager/peer_scoring.d.ts +1 -1
  192. package/dest/services/peer-manager/peer_scoring.d.ts.map +1 -1
  193. package/dest/services/peer-manager/peer_scoring.js +33 -4
  194. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts +48 -0
  195. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts.map +1 -0
  196. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.js +539 -0
  197. package/dest/services/reqresp/batch-tx-requester/config.d.ts +17 -0
  198. package/dest/services/reqresp/batch-tx-requester/config.d.ts.map +1 -0
  199. package/dest/services/reqresp/batch-tx-requester/config.js +27 -0
  200. package/dest/services/reqresp/batch-tx-requester/interface.d.ts +46 -0
  201. package/dest/services/reqresp/batch-tx-requester/interface.d.ts.map +1 -0
  202. package/dest/services/reqresp/batch-tx-requester/interface.js +1 -0
  203. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts +34 -0
  204. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts.map +1 -0
  205. package/dest/services/reqresp/batch-tx-requester/missing_txs.js +130 -0
  206. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts +60 -0
  207. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts.map +1 -0
  208. package/dest/services/reqresp/batch-tx-requester/peer_collection.js +173 -0
  209. package/dest/services/reqresp/batch-tx-requester/tx_validator.d.ts +20 -0
  210. package/dest/services/reqresp/batch-tx-requester/tx_validator.d.ts.map +1 -0
  211. package/dest/services/reqresp/batch-tx-requester/tx_validator.js +21 -0
  212. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.d.ts +22 -3
  213. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.d.ts.map +1 -1
  214. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.js +63 -4
  215. package/dest/services/reqresp/connection-sampler/connection_sampler.d.ts +2 -1
  216. package/dest/services/reqresp/connection-sampler/connection_sampler.d.ts.map +1 -1
  217. package/dest/services/reqresp/connection-sampler/connection_sampler.js +12 -0
  218. package/dest/services/reqresp/interface.d.ts +12 -1
  219. package/dest/services/reqresp/interface.d.ts.map +1 -1
  220. package/dest/services/reqresp/interface.js +15 -1
  221. package/dest/services/reqresp/metrics.d.ts +6 -5
  222. package/dest/services/reqresp/metrics.d.ts.map +1 -1
  223. package/dest/services/reqresp/metrics.js +17 -5
  224. package/dest/services/reqresp/protocols/block_txs/bitvector.d.ts +5 -1
  225. package/dest/services/reqresp/protocols/block_txs/bitvector.d.ts.map +1 -1
  226. package/dest/services/reqresp/protocols/block_txs/bitvector.js +5 -0
  227. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts +7 -5
  228. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts.map +1 -1
  229. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.js +27 -9
  230. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts +29 -6
  231. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts.map +1 -1
  232. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.js +59 -13
  233. package/dest/services/reqresp/protocols/tx.d.ts +7 -1
  234. package/dest/services/reqresp/protocols/tx.d.ts.map +1 -1
  235. package/dest/services/reqresp/protocols/tx.js +20 -0
  236. package/dest/services/reqresp/reqresp.d.ts +6 -1
  237. package/dest/services/reqresp/reqresp.d.ts.map +1 -1
  238. package/dest/services/reqresp/reqresp.js +71 -27
  239. package/dest/services/service.d.ts +42 -3
  240. package/dest/services/service.d.ts.map +1 -1
  241. package/dest/services/tx_collection/config.d.ts +22 -1
  242. package/dest/services/tx_collection/config.d.ts.map +1 -1
  243. package/dest/services/tx_collection/config.js +55 -1
  244. package/dest/services/tx_collection/fast_tx_collection.d.ts +7 -4
  245. package/dest/services/tx_collection/fast_tx_collection.d.ts.map +1 -1
  246. package/dest/services/tx_collection/fast_tx_collection.js +71 -44
  247. package/dest/services/tx_collection/file_store_tx_collection.d.ts +53 -0
  248. package/dest/services/tx_collection/file_store_tx_collection.d.ts.map +1 -0
  249. package/dest/services/tx_collection/file_store_tx_collection.js +167 -0
  250. package/dest/services/tx_collection/file_store_tx_source.d.ts +37 -0
  251. package/dest/services/tx_collection/file_store_tx_source.d.ts.map +1 -0
  252. package/dest/services/tx_collection/file_store_tx_source.js +90 -0
  253. package/dest/services/tx_collection/index.d.ts +3 -1
  254. package/dest/services/tx_collection/index.d.ts.map +1 -1
  255. package/dest/services/tx_collection/index.js +2 -0
  256. package/dest/services/tx_collection/instrumentation.d.ts +1 -1
  257. package/dest/services/tx_collection/instrumentation.d.ts.map +1 -1
  258. package/dest/services/tx_collection/instrumentation.js +10 -2
  259. package/dest/services/tx_collection/missing_txs_tracker.d.ts +32 -0
  260. package/dest/services/tx_collection/missing_txs_tracker.d.ts.map +1 -0
  261. package/dest/services/tx_collection/missing_txs_tracker.js +27 -0
  262. package/dest/services/tx_collection/proposal_tx_collector.d.ts +49 -0
  263. package/dest/services/tx_collection/proposal_tx_collector.d.ts.map +1 -0
  264. package/dest/services/tx_collection/proposal_tx_collector.js +50 -0
  265. package/dest/services/tx_collection/slow_tx_collection.d.ts +7 -3
  266. package/dest/services/tx_collection/slow_tx_collection.d.ts.map +1 -1
  267. package/dest/services/tx_collection/slow_tx_collection.js +60 -26
  268. package/dest/services/tx_collection/tx_collection.d.ts +25 -12
  269. package/dest/services/tx_collection/tx_collection.d.ts.map +1 -1
  270. package/dest/services/tx_collection/tx_collection.js +79 -7
  271. package/dest/services/tx_collection/tx_collection_sink.d.ts +18 -8
  272. package/dest/services/tx_collection/tx_collection_sink.d.ts.map +1 -1
  273. package/dest/services/tx_collection/tx_collection_sink.js +26 -29
  274. package/dest/services/tx_collection/tx_source.d.ts +8 -3
  275. package/dest/services/tx_collection/tx_source.d.ts.map +1 -1
  276. package/dest/services/tx_collection/tx_source.js +19 -2
  277. package/dest/services/tx_file_store/config.d.ts +16 -0
  278. package/dest/services/tx_file_store/config.d.ts.map +1 -0
  279. package/dest/services/tx_file_store/config.js +22 -0
  280. package/dest/services/tx_file_store/index.d.ts +4 -0
  281. package/dest/services/tx_file_store/index.d.ts.map +1 -0
  282. package/dest/services/tx_file_store/index.js +3 -0
  283. package/dest/services/tx_file_store/instrumentation.d.ts +15 -0
  284. package/dest/services/tx_file_store/instrumentation.d.ts.map +1 -0
  285. package/dest/services/tx_file_store/instrumentation.js +29 -0
  286. package/dest/services/tx_file_store/tx_file_store.d.ts +48 -0
  287. package/dest/services/tx_file_store/tx_file_store.d.ts.map +1 -0
  288. package/dest/services/tx_file_store/tx_file_store.js +152 -0
  289. package/dest/services/tx_provider.d.ts +4 -4
  290. package/dest/services/tx_provider.d.ts.map +1 -1
  291. package/dest/services/tx_provider.js +9 -8
  292. package/dest/services/tx_provider_instrumentation.d.ts +1 -1
  293. package/dest/services/tx_provider_instrumentation.d.ts.map +1 -1
  294. package/dest/services/tx_provider_instrumentation.js +5 -5
  295. package/dest/test-helpers/index.d.ts +3 -1
  296. package/dest/test-helpers/index.d.ts.map +1 -1
  297. package/dest/test-helpers/index.js +2 -0
  298. package/dest/test-helpers/make-test-p2p-clients.d.ts +7 -8
  299. package/dest/test-helpers/make-test-p2p-clients.d.ts.map +1 -1
  300. package/dest/test-helpers/make-test-p2p-clients.js +1 -2
  301. package/dest/test-helpers/mock-pubsub.d.ts +30 -4
  302. package/dest/test-helpers/mock-pubsub.d.ts.map +1 -1
  303. package/dest/test-helpers/mock-pubsub.js +105 -4
  304. package/dest/test-helpers/reqresp-nodes.d.ts +2 -3
  305. package/dest/test-helpers/reqresp-nodes.d.ts.map +1 -1
  306. package/dest/test-helpers/reqresp-nodes.js +4 -3
  307. package/dest/test-helpers/test_tx_provider.d.ts +40 -0
  308. package/dest/test-helpers/test_tx_provider.d.ts.map +1 -0
  309. package/dest/test-helpers/test_tx_provider.js +41 -0
  310. package/dest/test-helpers/testbench-utils.d.ts +163 -0
  311. package/dest/test-helpers/testbench-utils.d.ts.map +1 -0
  312. package/dest/test-helpers/testbench-utils.js +366 -0
  313. package/dest/testbench/p2p_client_testbench_worker.d.ts +28 -2
  314. package/dest/testbench/p2p_client_testbench_worker.d.ts.map +1 -1
  315. package/dest/testbench/p2p_client_testbench_worker.js +219 -138
  316. package/dest/testbench/worker_client_manager.d.ts +51 -6
  317. package/dest/testbench/worker_client_manager.d.ts.map +1 -1
  318. package/dest/testbench/worker_client_manager.js +226 -44
  319. package/dest/util.d.ts +2 -2
  320. package/dest/util.d.ts.map +1 -1
  321. package/package.json +14 -14
  322. package/src/bootstrap/bootstrap.ts +7 -4
  323. package/src/client/factory.ts +83 -36
  324. package/src/client/interface.ts +56 -34
  325. package/src/client/p2p_client.ts +192 -247
  326. package/src/client/test/tx_proposal_collector/README.md +227 -0
  327. package/src/client/test/tx_proposal_collector/proposal_tx_collector_worker.ts +345 -0
  328. package/src/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.ts +43 -0
  329. package/src/config.ts +47 -11
  330. package/src/errors/tx-pool.error.ts +12 -0
  331. package/src/index.ts +1 -0
  332. package/src/mem_pools/attestation_pool/attestation_pool.ts +496 -91
  333. package/src/mem_pools/attestation_pool/attestation_pool_test_suite.ts +442 -102
  334. package/src/mem_pools/attestation_pool/index.ts +9 -2
  335. package/src/mem_pools/attestation_pool/mocks.ts +2 -1
  336. package/src/mem_pools/index.ts +4 -1
  337. package/src/mem_pools/instrumentation.ts +2 -1
  338. package/src/mem_pools/interface.ts +4 -4
  339. package/src/mem_pools/tx_pool/README.md +1 -1
  340. package/src/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.ts +3 -3
  341. package/src/mem_pools/tx_pool_v2/README.md +275 -0
  342. package/src/mem_pools/tx_pool_v2/archive/index.ts +1 -0
  343. package/src/mem_pools/tx_pool_v2/archive/tx_archive.ts +120 -0
  344. package/src/mem_pools/tx_pool_v2/deleted_pool.ts +321 -0
  345. package/src/mem_pools/tx_pool_v2/eviction/eviction_manager.ts +160 -0
  346. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.ts +121 -0
  347. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.ts +125 -0
  348. package/src/mem_pools/tx_pool_v2/eviction/index.ts +27 -0
  349. package/src/mem_pools/tx_pool_v2/eviction/interfaces.ts +209 -0
  350. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.ts +74 -0
  351. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.ts +101 -0
  352. package/src/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.ts +91 -0
  353. package/src/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.ts +90 -0
  354. package/src/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.ts +31 -0
  355. package/src/mem_pools/tx_pool_v2/index.ts +12 -0
  356. package/src/mem_pools/tx_pool_v2/instrumentation.ts +69 -0
  357. package/src/mem_pools/tx_pool_v2/interfaces.ts +242 -0
  358. package/src/mem_pools/tx_pool_v2/tx_metadata.ts +297 -0
  359. package/src/mem_pools/tx_pool_v2/tx_pool_bench_metrics.ts +77 -0
  360. package/src/mem_pools/tx_pool_v2/tx_pool_indices.ts +444 -0
  361. package/src/mem_pools/tx_pool_v2/tx_pool_v2.ts +223 -0
  362. package/src/mem_pools/tx_pool_v2/tx_pool_v2_impl.ts +1083 -0
  363. package/src/msg_validators/attestation_validator/fisherman_attestation_validator.ts +10 -4
  364. package/src/msg_validators/proposal_validator/proposal_validator.ts +5 -5
  365. package/src/msg_validators/tx_validator/README.md +115 -0
  366. package/src/msg_validators/tx_validator/aggregate_tx_validator.ts +5 -5
  367. package/src/msg_validators/tx_validator/archive_cache.ts +3 -3
  368. package/src/msg_validators/tx_validator/block_header_validator.ts +22 -11
  369. package/src/msg_validators/tx_validator/data_validator.ts +6 -2
  370. package/src/msg_validators/tx_validator/double_spend_validator.ts +15 -9
  371. package/src/msg_validators/tx_validator/factory.ts +372 -55
  372. package/src/msg_validators/tx_validator/gas_validator.ts +98 -29
  373. package/src/msg_validators/tx_validator/index.ts +1 -0
  374. package/src/msg_validators/tx_validator/metadata_validator.ts +6 -3
  375. package/src/msg_validators/tx_validator/nullifier_cache.ts +30 -0
  376. package/src/msg_validators/tx_validator/phases_validator.ts +5 -3
  377. package/src/msg_validators/tx_validator/size_validator.ts +6 -2
  378. package/src/msg_validators/tx_validator/timestamp_validator.ts +29 -21
  379. package/src/msg_validators/tx_validator/tx_permitted_validator.ts +8 -3
  380. package/src/msg_validators/tx_validator/tx_proof_validator.ts +8 -3
  381. package/src/services/data_store.ts +10 -7
  382. package/src/services/discv5/discV5_service.ts +1 -1
  383. package/src/services/dummy_service.ts +59 -2
  384. package/src/services/encoding.ts +9 -9
  385. package/src/services/gossipsub/README.md +641 -0
  386. package/src/services/gossipsub/index.ts +2 -0
  387. package/src/services/gossipsub/scoring.ts +29 -5
  388. package/src/services/gossipsub/topic_score_params.ts +487 -0
  389. package/src/services/index.ts +1 -0
  390. package/src/services/libp2p/instrumentation.ts +15 -2
  391. package/src/services/libp2p/libp2p_service.ts +496 -397
  392. package/src/services/peer-manager/metrics.ts +21 -4
  393. package/src/services/peer-manager/peer_scoring.ts +29 -1
  394. package/src/services/reqresp/batch-tx-requester/README.md +305 -0
  395. package/src/services/reqresp/batch-tx-requester/batch_tx_requester.ts +678 -0
  396. package/src/services/reqresp/batch-tx-requester/config.ts +40 -0
  397. package/src/services/reqresp/batch-tx-requester/interface.ts +53 -0
  398. package/src/services/reqresp/batch-tx-requester/missing_txs.ts +161 -0
  399. package/src/services/reqresp/batch-tx-requester/peer_collection.ts +244 -0
  400. package/src/services/reqresp/batch-tx-requester/tx_validator.ts +37 -0
  401. package/src/services/reqresp/connection-sampler/batch_connection_sampler.ts +65 -4
  402. package/src/services/reqresp/connection-sampler/connection_sampler.ts +16 -0
  403. package/src/services/reqresp/interface.ts +29 -1
  404. package/src/services/reqresp/metrics.ts +34 -9
  405. package/src/services/reqresp/protocols/block_txs/bitvector.ts +7 -0
  406. package/src/services/reqresp/protocols/block_txs/block_txs_handler.ts +35 -12
  407. package/src/services/reqresp/protocols/block_txs/block_txs_reqresp.ts +74 -9
  408. package/src/services/reqresp/protocols/tx.ts +22 -0
  409. package/src/services/reqresp/reqresp.ts +82 -23
  410. package/src/services/service.ts +55 -2
  411. package/src/services/tx_collection/config.ts +83 -1
  412. package/src/services/tx_collection/fast_tx_collection.ts +93 -47
  413. package/src/services/tx_collection/file_store_tx_collection.ts +202 -0
  414. package/src/services/tx_collection/file_store_tx_source.ts +117 -0
  415. package/src/services/tx_collection/index.ts +6 -0
  416. package/src/services/tx_collection/instrumentation.ts +17 -2
  417. package/src/services/tx_collection/missing_txs_tracker.ts +52 -0
  418. package/src/services/tx_collection/proposal_tx_collector.ts +113 -0
  419. package/src/services/tx_collection/slow_tx_collection.ts +66 -33
  420. package/src/services/tx_collection/tx_collection.ts +117 -20
  421. package/src/services/tx_collection/tx_collection_sink.ts +30 -34
  422. package/src/services/tx_collection/tx_source.ts +22 -3
  423. package/src/services/tx_file_store/config.ts +37 -0
  424. package/src/services/tx_file_store/index.ts +3 -0
  425. package/src/services/tx_file_store/instrumentation.ts +36 -0
  426. package/src/services/tx_file_store/tx_file_store.ts +175 -0
  427. package/src/services/tx_provider.ts +10 -9
  428. package/src/services/tx_provider_instrumentation.ts +11 -5
  429. package/src/test-helpers/index.ts +2 -0
  430. package/src/test-helpers/make-test-p2p-clients.ts +3 -5
  431. package/src/test-helpers/mock-pubsub.ts +146 -9
  432. package/src/test-helpers/reqresp-nodes.ts +4 -6
  433. package/src/test-helpers/test_tx_provider.ts +64 -0
  434. package/src/test-helpers/testbench-utils.ts +430 -0
  435. package/src/testbench/p2p_client_testbench_worker.ts +333 -131
  436. package/src/testbench/worker_client_manager.ts +304 -47
  437. package/src/util.ts +7 -1
  438. package/dest/mem_pools/attestation_pool/kv_attestation_pool.d.ts +0 -40
  439. package/dest/mem_pools/attestation_pool/kv_attestation_pool.d.ts.map +0 -1
  440. package/dest/mem_pools/attestation_pool/kv_attestation_pool.js +0 -218
  441. package/dest/mem_pools/attestation_pool/memory_attestation_pool.d.ts +0 -31
  442. package/dest/mem_pools/attestation_pool/memory_attestation_pool.d.ts.map +0 -1
  443. package/dest/mem_pools/attestation_pool/memory_attestation_pool.js +0 -180
  444. package/src/mem_pools/attestation_pool/kv_attestation_pool.ts +0 -320
  445. package/src/mem_pools/attestation_pool/memory_attestation_pool.ts +0 -264
@@ -1,38 +1,91 @@
1
+ /**
2
+ * Transaction validator factories for each tx entry point.
3
+ *
4
+ * Unsolicited transactions (gossip and RPC) are fully validated before acceptance.
5
+ * Transactions received via req/resp or block proposals are only checked for
6
+ * well-formedness because we must include them for block re-execution — they may
7
+ * ultimately be invalid, which is caught during block building and reported as
8
+ * part of block validation/attestation. See the README in this directory for the
9
+ * full validation strategy.
10
+ *
11
+ * 1. **Gossip** — full validation in two stages with a pool pre-check in between.
12
+ * Stage 1 (fast): metadata, data, timestamps, double-spend, gas, phases, block header.
13
+ * Pool pre-check: `canAddPendingTx` — skips proof verification if pool would reject.
14
+ * Stage 2 (slow): proof verification.
15
+ * Orchestrated by `handleGossipedTx` in `libp2p_service.ts`.
16
+ *
17
+ * 2. **JSON-RPC** — full validation including all state-dependent checks.
18
+ * Proof verification and fee enforcement are configurable for testing purposes.
19
+ *
20
+ * 3. **Req/resp & block proposals** — well-formedness checks only (metadata, size,
21
+ * data, proof). Stored for re-execution; validity against state is not checked here.
22
+ *
23
+ * 4. **Block building** — re-validates against current state immediately before
24
+ * sequencing. Catches invalid txs that entered via req/resp or block proposals.
25
+ * Proof and data checks are skipped since they were verified on entry.
26
+ *
27
+ * 5. **Pending pool migration** — when unmined txs (e.g. from req/resp or block
28
+ * proposals) are migrated to the pending pool, the pool runs the state-dependent
29
+ * checks they missed: double-spend, block header, gas limits, and timestamps.
30
+ * This runs on every tx potentially entering the pending pool.
31
+ */
1
32
  import { BlockNumber } from '@aztec/foundation/branded-types';
2
33
  import { Fr } from '@aztec/foundation/curves/bn254';
34
+ import type { LoggerBindings } from '@aztec/foundation/log';
3
35
  import { getVKTreeRoot } from '@aztec/noir-protocol-circuits-types/vk-tree';
4
- import { ProtocolContractAddress } from '@aztec/protocol-contracts';
36
+ import { ProtocolContractAddress, protocolContractsHash } from '@aztec/protocol-contracts';
37
+ import type { BlockHash } from '@aztec/stdlib/block';
5
38
  import type { ContractDataSource } from '@aztec/stdlib/contract';
6
39
  import type { GasFees } from '@aztec/stdlib/gas';
7
40
  import type {
8
41
  AllowedElement,
9
42
  ClientProtocolCircuitVerifier,
43
+ MerkleTreeReadOperations,
44
+ PublicProcessorValidator,
10
45
  WorldStateSynchronizer,
11
46
  } from '@aztec/stdlib/interfaces/server';
12
47
  import { PeerErrorSeverity } from '@aztec/stdlib/p2p';
13
- import { DatabasePublicStateSource, MerkleTreeId } from '@aztec/stdlib/trees';
14
- import type { Tx, TxValidationResult } from '@aztec/stdlib/tx';
48
+ import { DatabasePublicStateSource, MerkleTreeId, type PublicStateSource } from '@aztec/stdlib/trees';
49
+ import type { GlobalVariables, Tx, TxValidationResult, TxValidator } from '@aztec/stdlib/tx';
15
50
  import type { UInt64 } from '@aztec/stdlib/types';
16
51
 
52
+ import type { TxMetaData } from '../../mem_pools/tx_pool_v2/tx_metadata.js';
53
+ import { AggregateTxValidator } from './aggregate_tx_validator.js';
17
54
  import { ArchiveCache } from './archive_cache.js';
18
- import { BlockHeaderTxValidator } from './block_header_validator.js';
55
+ import { type ArchiveSource, BlockHeaderTxValidator } from './block_header_validator.js';
19
56
  import { DataTxValidator } from './data_validator.js';
20
- import { DoubleSpendTxValidator } from './double_spend_validator.js';
21
- import { GasTxValidator } from './gas_validator.js';
57
+ import { DoubleSpendTxValidator, type NullifierSource } from './double_spend_validator.js';
58
+ import { GasLimitsValidator, GasTxValidator } from './gas_validator.js';
22
59
  import { MetadataTxValidator } from './metadata_validator.js';
60
+ import { NullifierCache } from './nullifier_cache.js';
23
61
  import { PhasesTxValidator } from './phases_validator.js';
62
+ import { SizeTxValidator } from './size_validator.js';
24
63
  import { TimestampTxValidator } from './timestamp_validator.js';
25
64
  import { TxPermittedValidator } from './tx_permitted_validator.js';
26
65
  import { TxProofValidator } from './tx_proof_validator.js';
27
66
 
28
- export interface MessageValidator {
67
+ /**
68
+ * A validator paired with a peer penalty severity.
69
+ * Used for gossip validation where each validator's failure triggers a peer penalization
70
+ * with the associated severity level.
71
+ */
72
+ export interface TransactionValidator {
29
73
  validator: {
30
74
  validateTx(tx: Tx): Promise<TxValidationResult>;
31
75
  };
32
76
  severity: PeerErrorSeverity;
33
77
  }
34
78
 
35
- export function createTxMessageValidators(
79
+ /**
80
+ * First stage of gossip validation — fast checks run before the pool pre-check.
81
+ *
82
+ * If any validator fails, the peer is penalized and the tx is rejected immediately,
83
+ * without consulting the pool or running proof verification.
84
+ *
85
+ * The `doubleSpendValidator` failure is special-cased by the caller (`handleGossipedTx`)
86
+ * to determine severity based on how recently the nullifier appeared.
87
+ */
88
+ export function createFirstStageTxValidationsForGossipedTransactions(
36
89
  timestamp: UInt64,
37
90
  blockNumber: BlockNumber,
38
91
  worldStateSynchronizer: WorldStateSynchronizer,
@@ -41,70 +94,334 @@ export function createTxMessageValidators(
41
94
  rollupVersion: number,
42
95
  protocolContractsHash: Fr,
43
96
  contractDataSource: ContractDataSource,
44
- proofVerifier: ClientProtocolCircuitVerifier,
45
97
  txsPermitted: boolean,
46
98
  allowedInSetup: AllowedElement[] = [],
47
- ): Record<string, MessageValidator>[] {
99
+ bindings?: LoggerBindings,
100
+ ): Record<string, TransactionValidator> {
48
101
  const merkleTree = worldStateSynchronizer.getCommitted();
49
102
 
50
- return [
51
- {
52
- txsPermittedValidator: {
53
- validator: new TxPermittedValidator(txsPermitted),
54
- severity: PeerErrorSeverity.MidToleranceError,
55
- },
56
- dataValidator: {
57
- validator: new DataTxValidator(),
58
- severity: PeerErrorSeverity.HighToleranceError,
59
- },
60
- metadataValidator: {
61
- validator: new MetadataTxValidator({
103
+ return {
104
+ timestampValidator: {
105
+ validator: new TimestampTxValidator<Tx>(
106
+ {
107
+ timestamp,
108
+ blockNumber,
109
+ },
110
+ bindings,
111
+ ),
112
+ severity: PeerErrorSeverity.HighToleranceError,
113
+ },
114
+ txsPermittedValidator: {
115
+ validator: new TxPermittedValidator(txsPermitted, bindings),
116
+ severity: PeerErrorSeverity.MidToleranceError,
117
+ },
118
+ txSizeValidator: {
119
+ validator: new SizeTxValidator(bindings),
120
+ severity: PeerErrorSeverity.MidToleranceError,
121
+ },
122
+ metadataValidator: {
123
+ validator: new MetadataTxValidator(
124
+ {
62
125
  l1ChainId: new Fr(l1ChainId),
63
126
  rollupVersion: new Fr(rollupVersion),
64
127
  protocolContractsHash,
65
128
  vkTreeRoot: getVKTreeRoot(),
66
- }),
67
- severity: PeerErrorSeverity.HighToleranceError,
68
- },
69
- timestampValidator: {
70
- validator: new TimestampTxValidator<Tx>({
71
- timestamp,
72
- blockNumber,
73
- }),
74
- severity: PeerErrorSeverity.MidToleranceError,
75
- },
76
- doubleSpendValidator: {
77
- validator: new DoubleSpendTxValidator({
129
+ },
130
+ bindings,
131
+ ),
132
+ severity: PeerErrorSeverity.MidToleranceError,
133
+ },
134
+ phasesValidator: {
135
+ validator: new PhasesTxValidator(contractDataSource, allowedInSetup, timestamp, bindings),
136
+ severity: PeerErrorSeverity.MidToleranceError,
137
+ },
138
+ blockHeaderValidator: {
139
+ validator: new BlockHeaderTxValidator(new ArchiveCache(merkleTree), bindings),
140
+ severity: PeerErrorSeverity.HighToleranceError,
141
+ },
142
+ doubleSpendValidator: {
143
+ validator: new DoubleSpendTxValidator(
144
+ {
78
145
  nullifiersExist: async (nullifiers: Buffer[]) => {
79
146
  const merkleTree = worldStateSynchronizer.getCommitted();
80
147
  const indices = await merkleTree.findLeafIndices(MerkleTreeId.NULLIFIER_TREE, nullifiers);
81
148
  return indices.map(index => index !== undefined);
82
149
  },
83
- }),
84
- severity: PeerErrorSeverity.HighToleranceError,
150
+ },
151
+ bindings,
152
+ ),
153
+ severity: PeerErrorSeverity.MidToleranceError, // This is handled specifically at the point of rejection by considering a recent window where it may have been valid
154
+ },
155
+ gasValidator: {
156
+ validator: new GasTxValidator(
157
+ new DatabasePublicStateSource(merkleTree),
158
+ ProtocolContractAddress.FeeJuice,
159
+ gasFees,
160
+ bindings,
161
+ ),
162
+ severity: PeerErrorSeverity.MidToleranceError,
163
+ },
164
+ dataValidator: {
165
+ validator: new DataTxValidator(bindings),
166
+ severity: PeerErrorSeverity.MidToleranceError,
167
+ },
168
+ };
169
+ }
170
+
171
+ /**
172
+ * Second stage of gossip validation — expensive proof verification.
173
+ *
174
+ * Only runs after the first stage passes AND `canAddPendingTx` confirms the pool would
175
+ * accept the tx. This avoids wasting CPU on proof verification for txs the pool would reject
176
+ * (e.g., duplicates, insufficient balance, pool full).
177
+ */
178
+ export function createSecondStageTxValidationsForGossipedTransactions(
179
+ proofVerifier: ClientProtocolCircuitVerifier,
180
+ bindings?: LoggerBindings,
181
+ ): Record<string, TransactionValidator> {
182
+ return {
183
+ proofValidator: {
184
+ validator: new TxProofValidator(proofVerifier, bindings),
185
+ severity: PeerErrorSeverity.LowToleranceError,
186
+ },
187
+ };
188
+ }
189
+
190
+ /**
191
+ * Well-formedness checks only: metadata, size, data, and proof.
192
+ * Used for req/resp and block proposal txs. These txs must be accepted for block
193
+ * re-execution even though they may be invalid against current state — that is
194
+ * caught later by the block building validator.
195
+ */
196
+ function createTxValidatorForMinimumTxIntegrityChecks(
197
+ verifier: ClientProtocolCircuitVerifier,
198
+ {
199
+ l1ChainId,
200
+ rollupVersion,
201
+ }: {
202
+ l1ChainId: number;
203
+ rollupVersion: number;
204
+ },
205
+ bindings?: LoggerBindings,
206
+ ): TxValidator {
207
+ return new AggregateTxValidator(
208
+ new MetadataTxValidator(
209
+ {
210
+ l1ChainId: new Fr(l1ChainId),
211
+ rollupVersion: new Fr(rollupVersion),
212
+ protocolContractsHash,
213
+ vkTreeRoot: getVKTreeRoot(),
85
214
  },
86
- gasValidator: {
87
- validator: new GasTxValidator(
88
- new DatabasePublicStateSource(merkleTree),
89
- ProtocolContractAddress.FeeJuice,
90
- gasFees,
91
- ),
92
- severity: PeerErrorSeverity.HighToleranceError,
215
+ bindings,
216
+ ),
217
+ new SizeTxValidator(bindings),
218
+ new DataTxValidator(bindings),
219
+ new TxProofValidator(verifier, bindings),
220
+ );
221
+ }
222
+
223
+ /**
224
+ * Validators for txs received via req/resp or filestores.
225
+ * Checks well-formedness only — we must accept these for re-execution even if they
226
+ * are invalid against current state. State-dependent checks happen when the tx
227
+ * enters the pending pool or during block building.
228
+ */
229
+ export function createTxValidatorForReqResponseReceivedTxs(
230
+ verifier: ClientProtocolCircuitVerifier,
231
+ {
232
+ l1ChainId,
233
+ rollupVersion,
234
+ }: {
235
+ l1ChainId: number;
236
+ rollupVersion: number;
237
+ },
238
+ bindings?: LoggerBindings,
239
+ ): TxValidator {
240
+ return createTxValidatorForMinimumTxIntegrityChecks(verifier, { l1ChainId, rollupVersion }, bindings);
241
+ }
242
+
243
+ /**
244
+ * Validators for txs received in block proposals.
245
+ * Same as req/resp — well-formedness only. We must store these for block
246
+ * re-execution; their validity against state is checked during block building.
247
+ */
248
+ export function createTxValidatorForBlockProposalReceivedTxs(
249
+ verifier: ClientProtocolCircuitVerifier,
250
+ {
251
+ l1ChainId,
252
+ rollupVersion,
253
+ }: {
254
+ l1ChainId: number;
255
+ rollupVersion: number;
256
+ },
257
+ bindings?: LoggerBindings,
258
+ ): TxValidator {
259
+ return createTxValidatorForMinimumTxIntegrityChecks(verifier, { l1ChainId, rollupVersion }, bindings);
260
+ }
261
+
262
+ /**
263
+ * Validators for unsolicited txs received over JSON-RPC (from a local wallet/PXE).
264
+ * Full validation — all state-dependent checks are run. Proof verification is optional
265
+ * (can be skipped for testing purposes). Fee enforcement is also optional (skipped for testing/dev).
266
+ * Called from `AztecNodeService.isValidTx()`.
267
+ */
268
+ export function createTxValidatorForAcceptingTxsOverRPC(
269
+ db: MerkleTreeReadOperations,
270
+ contractDataSource: ContractDataSource,
271
+ verifier: ClientProtocolCircuitVerifier | undefined,
272
+ {
273
+ l1ChainId,
274
+ rollupVersion,
275
+ setupAllowList,
276
+ gasFees,
277
+ skipFeeEnforcement,
278
+ timestamp,
279
+ blockNumber,
280
+ txsPermitted,
281
+ }: {
282
+ l1ChainId: number;
283
+ rollupVersion: number;
284
+ setupAllowList: AllowedElement[];
285
+ gasFees: GasFees;
286
+ skipFeeEnforcement?: boolean;
287
+ timestamp: UInt64;
288
+ blockNumber: BlockNumber;
289
+ txsPermitted: boolean;
290
+ },
291
+ bindings?: LoggerBindings,
292
+ ): TxValidator<Tx> {
293
+ const validators: TxValidator<Tx>[] = [
294
+ new TxPermittedValidator(txsPermitted, bindings),
295
+ new TimestampTxValidator(
296
+ {
297
+ timestamp,
298
+ blockNumber,
93
299
  },
94
- phasesValidator: {
95
- validator: new PhasesTxValidator(contractDataSource, allowedInSetup, timestamp),
96
- severity: PeerErrorSeverity.MidToleranceError,
300
+ bindings,
301
+ ),
302
+ new SizeTxValidator(bindings),
303
+ new MetadataTxValidator(
304
+ {
305
+ l1ChainId: new Fr(l1ChainId),
306
+ rollupVersion: new Fr(rollupVersion),
307
+ protocolContractsHash,
308
+ vkTreeRoot: getVKTreeRoot(),
97
309
  },
98
- blockHeaderValidator: {
99
- validator: new BlockHeaderTxValidator(new ArchiveCache(merkleTree)),
100
- severity: PeerErrorSeverity.HighToleranceError,
310
+ bindings,
311
+ ),
312
+ new PhasesTxValidator(contractDataSource, setupAllowList, timestamp, bindings),
313
+ new BlockHeaderTxValidator(new ArchiveCache(db), bindings),
314
+ new DoubleSpendTxValidator(new NullifierCache(db), bindings),
315
+ new DataTxValidator(bindings),
316
+ ];
317
+
318
+ if (!skipFeeEnforcement) {
319
+ validators.push(
320
+ new GasTxValidator(new DatabasePublicStateSource(db), ProtocolContractAddress.FeeJuice, gasFees, bindings),
321
+ );
322
+ }
323
+
324
+ if (verifier) {
325
+ validators.push(new TxProofValidator(verifier, bindings));
326
+ }
327
+
328
+ return new AggregateTxValidator(...validators);
329
+ }
330
+
331
+ /**
332
+ * Validators for txs about to be included in a block by the sequencer.
333
+ * Re-validates against current state. This is where invalid txs that entered via
334
+ * req/resp or block proposals are caught — their invalidity is reported as part
335
+ * of block validation/attestation. Proof and data checks are omitted since they
336
+ * were already verified on entry.
337
+ * Called from `CheckpointBuilder.makeBlockBuilderDeps()`.
338
+ */
339
+ export function createTxValidatorForBlockBuilding(
340
+ db: MerkleTreeReadOperations,
341
+ contractDataSource: ContractDataSource,
342
+ globalVariables: GlobalVariables,
343
+ setupAllowList: AllowedElement[],
344
+ bindings?: LoggerBindings,
345
+ ): PublicProcessorValidator {
346
+ const nullifierCache = new NullifierCache(db);
347
+ const archiveCache = new ArchiveCache(db);
348
+ const publicStateSource = new DatabasePublicStateSource(db);
349
+
350
+ return {
351
+ preprocessValidator: createTxValidatorForValidatingAgainstCurrentState(
352
+ nullifierCache,
353
+ archiveCache,
354
+ publicStateSource,
355
+ contractDataSource,
356
+ globalVariables,
357
+ setupAllowList,
358
+ bindings,
359
+ ),
360
+ nullifierCache,
361
+ };
362
+ }
363
+
364
+ function createTxValidatorForValidatingAgainstCurrentState(
365
+ nullifierSource: NullifierSource,
366
+ archiveSource: ArchiveSource,
367
+ publicStateSource: PublicStateSource,
368
+ contractDataSource: ContractDataSource,
369
+ globalVariables: GlobalVariables,
370
+ setupAllowList: AllowedElement[],
371
+ bindings?: LoggerBindings,
372
+ ): TxValidator<Tx> {
373
+ // We don't include the TxProofValidator nor the DataTxValidator here because they are already checked by the time we get to block building.
374
+ return new AggregateTxValidator(
375
+ new TimestampTxValidator(
376
+ {
377
+ timestamp: globalVariables.timestamp,
378
+ blockNumber: globalVariables.blockNumber,
101
379
  },
380
+ bindings,
381
+ ),
382
+ new PhasesTxValidator(contractDataSource, setupAllowList, globalVariables.timestamp, bindings),
383
+ new BlockHeaderTxValidator(archiveSource, bindings),
384
+ new DoubleSpendTxValidator(nullifierSource, bindings),
385
+ new GasTxValidator(publicStateSource, ProtocolContractAddress.FeeJuice, globalVariables.gasFees, bindings),
386
+ );
387
+ }
388
+
389
+ /**
390
+ * Validators for txs migrating to the pending pool.
391
+ *
392
+ * Txs that arrived via req/resp or block proposals only had well-formedness checks
393
+ * on receipt. When they fail to be mined and are migrated to the pending pool, we
394
+ * run the state-dependent checks they missed: double-spend, block header, gas limits,
395
+ * and timestamp expiry. This is run on EVERY tx potentially entering the pending pool
396
+ * — called inside `TxPoolV2Impl` during `addPendingTxs`, `prepareForSlot` (unprotect),
397
+ * `handlePrunedBlocks` (unmine), and startup hydration.
398
+ *
399
+ * Operates on `TxMetaData` rather than full `Tx` since metadata is pre-built by the pool.
400
+ * Injected into `TxPoolV2` as the `createTxValidator` factory in `TxPoolV2Dependencies`.
401
+ */
402
+ export async function createTxValidatorForTransactionsEnteringPendingTxPool(
403
+ worldStateSynchronizer: WorldStateSynchronizer,
404
+ timestamp: bigint,
405
+ blockNumber: BlockNumber,
406
+ bindings?: LoggerBindings,
407
+ ): Promise<TxValidator<TxMetaData>> {
408
+ await worldStateSynchronizer.syncImmediate();
409
+ const merkleTree = worldStateSynchronizer.getCommitted();
410
+ const nullifierSource: NullifierSource = {
411
+ nullifiersExist: async (nullifiers: Buffer[]) => {
412
+ const indices = await merkleTree.findLeafIndices(MerkleTreeId.NULLIFIER_TREE, nullifiers);
413
+ return indices.map(index => index !== undefined);
102
414
  },
103
- {
104
- proofValidator: {
105
- validator: new TxProofValidator(proofVerifier),
106
- severity: PeerErrorSeverity.MidToleranceError,
107
- },
415
+ };
416
+ const archiveSource: ArchiveSource = {
417
+ getArchiveIndices: (archives: BlockHash[]) => {
418
+ return merkleTree.findLeafIndices(MerkleTreeId.ARCHIVE, archives);
108
419
  },
109
- ];
420
+ };
421
+ return new AggregateTxValidator<TxMetaData>(
422
+ new GasLimitsValidator<TxMetaData>(bindings),
423
+ new TimestampTxValidator<TxMetaData>({ timestamp, blockNumber }, bindings),
424
+ new DoubleSpendTxValidator<TxMetaData>(nullifierSource, bindings),
425
+ new BlockHeaderTxValidator<TxMetaData>(archiveSource, bindings),
426
+ );
110
427
  }
@@ -1,5 +1,10 @@
1
- import { AVM_MAX_PROCESSABLE_L2_GAS, FIXED_DA_GAS, FIXED_L2_GAS } from '@aztec/constants';
2
- import { createLogger } from '@aztec/foundation/log';
1
+ import {
2
+ MAX_PROCESSABLE_L2_GAS,
3
+ PRIVATE_TX_L2_GAS_OVERHEAD,
4
+ PUBLIC_TX_L2_GAS_OVERHEAD,
5
+ TX_DA_GAS_OVERHEAD,
6
+ } from '@aztec/constants';
7
+ import { type Logger, type LoggerBindings, createLogger } from '@aztec/foundation/log';
3
8
  import { computeFeePayerBalanceStorageSlot } from '@aztec/protocol-contracts/fee-juice';
4
9
  import type { AztecAddress } from '@aztec/stdlib/aztec-address';
5
10
  import { Gas, GasFees } from '@aztec/stdlib/gas';
@@ -16,20 +21,106 @@ import {
16
21
 
17
22
  import { getFeePayerClaimAmount, getTxFeeLimit } from './fee_payer_balance.js';
18
23
 
24
+ /** Structural interface for types that carry gas limit data, used by {@link GasLimitsValidator}. */
25
+ export interface HasGasLimitData {
26
+ txHash: { toString(): string };
27
+ data: {
28
+ // We just need to know whether there is something here or not
29
+ forPublic?: unknown;
30
+ constants: {
31
+ txContext: {
32
+ gasSettings: { gasLimits: Gas };
33
+ };
34
+ };
35
+ };
36
+ }
37
+
38
+ /**
39
+ * Validates that a transaction's gas limits are within acceptable bounds.
40
+ *
41
+ * Rejects transactions whose gas limits fall below the fixed minimums (FIXED_DA_GAS,
42
+ * FIXED_L2_GAS) or exceed the AVM's maximum processable L2 gas. This is a cheap,
43
+ * stateless check that operates on gas settings alone.
44
+ *
45
+ * Generic over T so it can validate both full {@link Tx} objects and {@link TxMetaData}
46
+ * (used during pending pool migration).
47
+ *
48
+ * Used by: pending pool migration (via factory), and indirectly by {@link GasTxValidator}.
49
+ */
50
+ export class GasLimitsValidator<T extends HasGasLimitData> implements TxValidator<T> {
51
+ #log: Logger;
52
+
53
+ constructor(bindings?: LoggerBindings) {
54
+ this.#log = createLogger('sequencer:tx_validator:tx_gas', bindings);
55
+ }
56
+
57
+ validateTx(tx: T): Promise<TxValidationResult> {
58
+ return Promise.resolve(this.validateGasLimit(tx));
59
+ }
60
+
61
+ /** Checks gas limits are >= fixed minimums and <= AVM max processable L2 gas. */
62
+ validateGasLimit(tx: T): TxValidationResult {
63
+ const gasLimits = tx.data.constants.txContext.gasSettings.gasLimits;
64
+ const minGasLimits = new Gas(
65
+ TX_DA_GAS_OVERHEAD,
66
+ tx.data.forPublic ? PUBLIC_TX_L2_GAS_OVERHEAD : PRIVATE_TX_L2_GAS_OVERHEAD,
67
+ );
68
+
69
+ if (minGasLimits.gtAny(gasLimits)) {
70
+ this.#log.verbose(`Rejecting transaction due to the gas limit(s) not being above the minimum gas limit`, {
71
+ gasLimits,
72
+ minGasLimits,
73
+ });
74
+ return { result: 'invalid', reason: [TX_ERROR_INSUFFICIENT_GAS_LIMIT] };
75
+ }
76
+
77
+ if (gasLimits.l2Gas > MAX_PROCESSABLE_L2_GAS) {
78
+ this.#log.verbose(`Rejecting transaction due to the gas limit(s) being higher than the maximum processable gas`, {
79
+ gasLimits,
80
+ minGasLimits,
81
+ });
82
+ return { result: 'invalid', reason: [TX_ERROR_GAS_LIMIT_TOO_HIGH] };
83
+ }
84
+
85
+ return { result: 'valid' };
86
+ }
87
+ }
88
+
89
+ /**
90
+ * Validates that a transaction can pay its gas fees.
91
+ *
92
+ * Runs three checks in order:
93
+ * 1. **Gas limits** (delegates to {@link GasLimitsValidator}) — rejects if limits are
94
+ * out of bounds.
95
+ * 2. **Max fee per gas** — skips (not rejects) the tx if its maxFeesPerGas is below
96
+ * the current block's gas fees. We skip rather than reject because the tx may
97
+ * become eligible in a later block with lower fees.
98
+ * 3. **Fee payer balance** — reads the fee payer's FeeJuice balance from public state,
99
+ * adds any pending claim from a setup-phase `_increase_public_balance` call, and
100
+ * rejects if the total is less than the tx's fee limit (gasLimits * maxFeePerGas).
101
+ *
102
+ * Used by: gossip (stage 1), RPC, and block building validators.
103
+ */
19
104
  export class GasTxValidator implements TxValidator<Tx> {
20
- #log = createLogger('sequencer:tx_validator:tx_gas');
105
+ #log: Logger;
21
106
  #publicDataSource: PublicStateSource;
22
107
  #feeJuiceAddress: AztecAddress;
23
108
  #gasFees: GasFees;
24
109
 
25
- constructor(publicDataSource: PublicStateSource, feeJuiceAddress: AztecAddress, gasFees: GasFees) {
110
+ constructor(
111
+ publicDataSource: PublicStateSource,
112
+ feeJuiceAddress: AztecAddress,
113
+ gasFees: GasFees,
114
+ private bindings?: LoggerBindings,
115
+ ) {
116
+ this.#log = createLogger('sequencer:tx_validator:tx_gas', bindings);
26
117
  this.#publicDataSource = publicDataSource;
27
118
  this.#feeJuiceAddress = feeJuiceAddress;
28
119
  this.#gasFees = gasFees;
29
120
  }
30
121
 
31
122
  async validateTx(tx: Tx): Promise<TxValidationResult> {
32
- const gasLimitValidation = this.#validateGasLimit(tx);
123
+ const gasLimitValidation = new GasLimitsValidator(this.bindings).validateGasLimit(tx);
33
124
  if (gasLimitValidation.result === 'invalid') {
34
125
  return Promise.resolve(gasLimitValidation);
35
126
  }
@@ -63,31 +154,9 @@ export class GasTxValidator implements TxValidator<Tx> {
63
154
  }
64
155
 
65
156
  /**
66
- * Check whether the tx's gas limit is above the minimum amount.
157
+ * Checks the fee payer has enough FeeJuice balance to cover the tx's fee limit.
158
+ * Accounts for any pending claim from a setup-phase `_increase_public_balance` call.
67
159
  */
68
- #validateGasLimit(tx: Tx): TxValidationResult {
69
- const gasLimits = tx.data.constants.txContext.gasSettings.gasLimits;
70
- const minGasLimits = new Gas(FIXED_DA_GAS, FIXED_L2_GAS);
71
-
72
- if (minGasLimits.gtAny(gasLimits)) {
73
- this.#log.verbose(`Rejecting transaction due to the gas limit(s) not being above the minimum gas limit`, {
74
- gasLimits,
75
- minGasLimits,
76
- });
77
- return { result: 'invalid', reason: [TX_ERROR_INSUFFICIENT_GAS_LIMIT] };
78
- }
79
-
80
- if (gasLimits.l2Gas > AVM_MAX_PROCESSABLE_L2_GAS) {
81
- this.#log.verbose(`Rejecting transaction due to the gas limit(s) being higher than the maximum processable gas`, {
82
- gasLimits,
83
- minGasLimits,
84
- });
85
- return { result: 'invalid', reason: [TX_ERROR_GAS_LIMIT_TOO_HIGH] };
86
- }
87
-
88
- return { result: 'valid' };
89
- }
90
-
91
160
  public async validateTxFee(tx: Tx): Promise<TxValidationResult> {
92
161
  const feePayer = tx.data.feePayer;
93
162
 
@@ -12,3 +12,4 @@ export * from './archive_cache.js';
12
12
  export * from './tx_permitted_validator.js';
13
13
  export * from './timestamp_validator.js';
14
14
  export * from './size_validator.js';
15
+ export * from './factory.js';
@@ -1,5 +1,5 @@
1
1
  import type { Fr } from '@aztec/foundation/curves/bn254';
2
- import { createLogger } from '@aztec/foundation/log';
2
+ import { type Logger, type LoggerBindings, createLogger } from '@aztec/foundation/log';
3
3
  import {
4
4
  type AnyTx,
5
5
  TX_ERROR_INCORRECT_L1_CHAIN_ID,
@@ -11,7 +11,7 @@ import {
11
11
  } from '@aztec/stdlib/tx';
12
12
 
13
13
  export class MetadataTxValidator<T extends AnyTx> implements TxValidator<T> {
14
- #log = createLogger('p2p:tx_validator:tx_metadata');
14
+ #log: Logger;
15
15
 
16
16
  constructor(
17
17
  private values: {
@@ -20,7 +20,10 @@ export class MetadataTxValidator<T extends AnyTx> implements TxValidator<T> {
20
20
  vkTreeRoot: Fr;
21
21
  protocolContractsHash: Fr;
22
22
  },
23
- ) {}
23
+ bindings?: LoggerBindings,
24
+ ) {
25
+ this.#log = createLogger('p2p:tx_validator:tx_metadata', bindings);
26
+ }
24
27
 
25
28
  validateTx(tx: T): Promise<TxValidationResult> {
26
29
  const errors = [];