@aztec/p2p 0.0.1-commit.b33fc05d0 → 0.0.1-commit.b3d3157a

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 (418) hide show
  1. package/README.md +129 -3
  2. package/dest/bootstrap/bootstrap.d.ts +1 -1
  3. package/dest/bootstrap/bootstrap.d.ts.map +1 -1
  4. package/dest/bootstrap/bootstrap.js +9 -1
  5. package/dest/client/factory.d.ts +4 -3
  6. package/dest/client/factory.d.ts.map +1 -1
  7. package/dest/client/factory.js +26 -14
  8. package/dest/client/interface.d.ts +14 -5
  9. package/dest/client/interface.d.ts.map +1 -1
  10. package/dest/client/p2p_client.d.ts +13 -9
  11. package/dest/client/p2p_client.d.ts.map +1 -1
  12. package/dest/client/p2p_client.js +88 -26
  13. package/dest/config.d.ts +135 -99
  14. package/dest/config.d.ts.map +1 -1
  15. package/dest/config.js +62 -7
  16. package/dest/errors/p2p-service.error.d.ts +9 -0
  17. package/dest/errors/p2p-service.error.d.ts.map +1 -0
  18. package/dest/errors/p2p-service.error.js +10 -0
  19. package/dest/errors/reqresp.error.d.ts +1 -20
  20. package/dest/errors/reqresp.error.d.ts.map +1 -1
  21. package/dest/errors/reqresp.error.js +0 -21
  22. package/dest/index.d.ts +1 -2
  23. package/dest/index.d.ts.map +1 -1
  24. package/dest/index.js +0 -1
  25. package/dest/mem_pools/attestation_pool/attestation_pool.d.ts +99 -59
  26. package/dest/mem_pools/attestation_pool/attestation_pool.d.ts.map +1 -1
  27. package/dest/mem_pools/attestation_pool/attestation_pool.js +265 -199
  28. package/dest/mem_pools/attestation_pool/attestation_pool_test_suite.d.ts +1 -1
  29. package/dest/mem_pools/attestation_pool/attestation_pool_test_suite.d.ts.map +1 -1
  30. package/dest/mem_pools/attestation_pool/attestation_pool_test_suite.js +181 -65
  31. package/dest/mem_pools/attestation_pool/mocks.d.ts +1 -1
  32. package/dest/mem_pools/attestation_pool/mocks.d.ts.map +1 -1
  33. package/dest/mem_pools/attestation_pool/mocks.js +6 -4
  34. package/dest/mem_pools/index.d.ts +1 -2
  35. package/dest/mem_pools/index.d.ts.map +1 -1
  36. package/dest/mem_pools/instrumentation.d.ts +1 -1
  37. package/dest/mem_pools/instrumentation.d.ts.map +1 -1
  38. package/dest/mem_pools/instrumentation.js +17 -1
  39. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.d.ts +1 -5
  40. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.d.ts.map +1 -1
  41. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.js +1 -7
  42. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.d.ts +1 -1
  43. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.d.ts.map +1 -1
  44. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.js +2 -1
  45. package/dest/mem_pools/tx_pool_v2/eviction/index.d.ts +2 -1
  46. package/dest/mem_pools/tx_pool_v2/eviction/index.d.ts.map +1 -1
  47. package/dest/mem_pools/tx_pool_v2/eviction/index.js +1 -0
  48. package/dest/mem_pools/tx_pool_v2/eviction/insufficient_fee_per_gas_eviction_rule.d.ts +16 -0
  49. package/dest/mem_pools/tx_pool_v2/eviction/insufficient_fee_per_gas_eviction_rule.d.ts.map +1 -0
  50. package/dest/mem_pools/tx_pool_v2/eviction/insufficient_fee_per_gas_eviction_rule.js +62 -0
  51. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.js +2 -2
  52. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts +10 -5
  53. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts.map +1 -1
  54. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts +13 -3
  55. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts.map +1 -1
  56. package/dest/mem_pools/tx_pool_v2/tx_metadata.js +20 -7
  57. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts +4 -2
  58. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts.map +1 -1
  59. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.js +3 -0
  60. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts +1 -1
  61. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts.map +1 -1
  62. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.js +84 -86
  63. package/dest/msg_validators/attestation_validator/attestation_validator.d.ts +9 -3
  64. package/dest/msg_validators/attestation_validator/attestation_validator.d.ts.map +1 -1
  65. package/dest/msg_validators/attestation_validator/attestation_validator.js +37 -12
  66. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts +7 -3
  67. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts.map +1 -1
  68. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.js +4 -5
  69. package/dest/msg_validators/clock_tolerance.d.ts +12 -1
  70. package/dest/msg_validators/clock_tolerance.d.ts.map +1 -1
  71. package/dest/msg_validators/clock_tolerance.js +56 -3
  72. package/dest/msg_validators/proposal_validator/block_proposal_validator.d.ts +6 -2
  73. package/dest/msg_validators/proposal_validator/block_proposal_validator.d.ts.map +1 -1
  74. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.d.ts +6 -2
  75. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.d.ts.map +1 -1
  76. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts +10 -2
  77. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts.map +1 -1
  78. package/dest/msg_validators/proposal_validator/proposal_validator.js +46 -12
  79. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts +1 -1
  80. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts.map +1 -1
  81. package/dest/msg_validators/tx_validator/aggregate_tx_validator.js +8 -15
  82. package/dest/msg_validators/tx_validator/allowed_public_setup.js +3 -3
  83. package/dest/msg_validators/tx_validator/archive_cache.js +1 -1
  84. package/dest/msg_validators/tx_validator/cached_tx_validator.d.ts +15 -0
  85. package/dest/msg_validators/tx_validator/cached_tx_validator.d.ts.map +1 -0
  86. package/dest/msg_validators/tx_validator/cached_tx_validator.js +19 -0
  87. package/dest/msg_validators/tx_validator/contract_instance_validator.d.ts +9 -0
  88. package/dest/msg_validators/tx_validator/contract_instance_validator.d.ts.map +1 -0
  89. package/dest/msg_validators/tx_validator/contract_instance_validator.js +48 -0
  90. package/dest/msg_validators/tx_validator/data_validator.d.ts +2 -1
  91. package/dest/msg_validators/tx_validator/data_validator.d.ts.map +1 -1
  92. package/dest/msg_validators/tx_validator/data_validator.js +36 -2
  93. package/dest/msg_validators/tx_validator/factory.d.ts +14 -5
  94. package/dest/msg_validators/tx_validator/factory.d.ts.map +1 -1
  95. package/dest/msg_validators/tx_validator/factory.js +36 -13
  96. package/dest/msg_validators/tx_validator/gas_validator.d.ts +36 -4
  97. package/dest/msg_validators/tx_validator/gas_validator.d.ts.map +1 -1
  98. package/dest/msg_validators/tx_validator/gas_validator.js +50 -33
  99. package/dest/msg_validators/tx_validator/index.d.ts +3 -1
  100. package/dest/msg_validators/tx_validator/index.d.ts.map +1 -1
  101. package/dest/msg_validators/tx_validator/index.js +2 -0
  102. package/dest/msg_validators/tx_validator/phases_validator.d.ts +21 -1
  103. package/dest/msg_validators/tx_validator/phases_validator.d.ts.map +1 -1
  104. package/dest/msg_validators/tx_validator/phases_validator.js +28 -1
  105. package/dest/msg_validators/tx_validator/tx_proof_validator.d.ts +2 -1
  106. package/dest/msg_validators/tx_validator/tx_proof_validator.d.ts.map +1 -1
  107. package/dest/msg_validators/tx_validator/tx_proof_validator.js +2 -0
  108. package/dest/msg_validators/tx_validator/tx_validation_cache.d.ts +48 -0
  109. package/dest/msg_validators/tx_validator/tx_validation_cache.d.ts.map +1 -0
  110. package/dest/msg_validators/tx_validator/tx_validation_cache.js +68 -0
  111. package/dest/services/data_store.d.ts +1 -1
  112. package/dest/services/data_store.d.ts.map +1 -1
  113. package/dest/services/data_store.js +5 -5
  114. package/dest/services/discv5/discV5_service.d.ts +2 -1
  115. package/dest/services/discv5/discV5_service.d.ts.map +1 -1
  116. package/dest/services/discv5/discV5_service.js +35 -8
  117. package/dest/services/dummy_service.d.ts +11 -15
  118. package/dest/services/dummy_service.d.ts.map +1 -1
  119. package/dest/services/dummy_service.js +12 -16
  120. package/dest/services/encoding.d.ts +5 -1
  121. package/dest/services/encoding.d.ts.map +1 -1
  122. package/dest/services/encoding.js +7 -1
  123. package/dest/services/gossipsub/topic_score_params.d.ts +13 -2
  124. package/dest/services/gossipsub/topic_score_params.d.ts.map +1 -1
  125. package/dest/services/gossipsub/topic_score_params.js +21 -4
  126. package/dest/services/libp2p/instrumentation.d.ts +3 -1
  127. package/dest/services/libp2p/instrumentation.d.ts.map +1 -1
  128. package/dest/services/libp2p/instrumentation.js +14 -0
  129. package/dest/services/libp2p/libp2p_service.d.ts +36 -46
  130. package/dest/services/libp2p/libp2p_service.d.ts.map +1 -1
  131. package/dest/services/libp2p/libp2p_service.js +272 -262
  132. package/dest/services/peer-manager/peer_manager.d.ts +6 -2
  133. package/dest/services/peer-manager/peer_manager.d.ts.map +1 -1
  134. package/dest/services/peer-manager/peer_manager.js +38 -10
  135. package/dest/services/peer-manager/peer_scoring.d.ts +7 -2
  136. package/dest/services/peer-manager/peer_scoring.d.ts.map +1 -1
  137. package/dest/services/peer-manager/peer_scoring.js +32 -10
  138. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts +4 -8
  139. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts.map +1 -1
  140. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.js +81 -86
  141. package/dest/services/reqresp/batch-tx-requester/interface.d.ts +10 -6
  142. package/dest/services/reqresp/batch-tx-requester/interface.d.ts.map +1 -1
  143. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts +5 -4
  144. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts.map +1 -1
  145. package/dest/services/reqresp/batch-tx-requester/missing_txs.js +13 -7
  146. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts +3 -1
  147. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts.map +1 -1
  148. package/dest/services/reqresp/batch-tx-requester/peer_collection.js +3 -0
  149. package/dest/services/reqresp/batch-tx-requester/tx_validator.d.ts +5 -14
  150. package/dest/services/reqresp/batch-tx-requester/tx_validator.d.ts.map +1 -1
  151. package/dest/services/reqresp/batch-tx-requester/tx_validator.js +6 -20
  152. package/dest/services/reqresp/config.d.ts +3 -3
  153. package/dest/services/reqresp/config.d.ts.map +1 -1
  154. package/dest/services/reqresp/interface.d.ts +16 -18
  155. package/dest/services/reqresp/interface.d.ts.map +1 -1
  156. package/dest/services/reqresp/interface.js +10 -20
  157. package/dest/services/reqresp/metrics.d.ts +1 -1
  158. package/dest/services/reqresp/metrics.d.ts.map +1 -1
  159. package/dest/services/reqresp/metrics.js +0 -1
  160. package/dest/services/reqresp/protocols/block_txs/bitvector.d.ts +4 -3
  161. package/dest/services/reqresp/protocols/block_txs/bitvector.d.ts.map +1 -1
  162. package/dest/services/reqresp/protocols/block_txs/bitvector.js +3 -2
  163. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts +1 -1
  164. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts.map +1 -1
  165. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.js +31 -28
  166. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts +12 -7
  167. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts.map +1 -1
  168. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.js +42 -24
  169. package/dest/services/reqresp/protocols/index.d.ts +1 -2
  170. package/dest/services/reqresp/protocols/index.d.ts.map +1 -1
  171. package/dest/services/reqresp/protocols/index.js +0 -1
  172. package/dest/services/reqresp/protocols/tx.d.ts +1 -1
  173. package/dest/services/reqresp/protocols/tx.d.ts.map +1 -1
  174. package/dest/services/reqresp/protocols/tx.js +1 -3
  175. package/dest/services/reqresp/rate-limiter/rate_limiter.d.ts +5 -4
  176. package/dest/services/reqresp/rate-limiter/rate_limiter.d.ts.map +1 -1
  177. package/dest/services/reqresp/rate-limiter/rate_limiter.js +10 -8
  178. package/dest/services/reqresp/rate-limiter/rate_limits.d.ts +1 -1
  179. package/dest/services/reqresp/rate-limiter/rate_limits.d.ts.map +1 -1
  180. package/dest/services/reqresp/rate-limiter/rate_limits.js +0 -10
  181. package/dest/services/reqresp/reqresp.d.ts +7 -29
  182. package/dest/services/reqresp/reqresp.d.ts.map +1 -1
  183. package/dest/services/reqresp/reqresp.js +41 -214
  184. package/dest/services/service.d.ts +9 -12
  185. package/dest/services/service.d.ts.map +1 -1
  186. package/dest/services/tx_collection/config.d.ts +2 -23
  187. package/dest/services/tx_collection/config.d.ts.map +1 -1
  188. package/dest/services/tx_collection/config.js +2 -55
  189. package/dest/services/tx_collection/file_store_tx_collection.d.ts +12 -28
  190. package/dest/services/tx_collection/file_store_tx_collection.d.ts.map +1 -1
  191. package/dest/services/tx_collection/file_store_tx_collection.js +43 -83
  192. package/dest/services/tx_collection/file_store_tx_source.d.ts +5 -4
  193. package/dest/services/tx_collection/file_store_tx_source.d.ts.map +1 -1
  194. package/dest/services/tx_collection/file_store_tx_source.js +39 -29
  195. package/dest/services/tx_collection/index.d.ts +2 -3
  196. package/dest/services/tx_collection/index.d.ts.map +1 -1
  197. package/dest/services/tx_collection/index.js +0 -1
  198. package/dest/services/tx_collection/instrumentation.d.ts +1 -1
  199. package/dest/services/tx_collection/instrumentation.d.ts.map +1 -1
  200. package/dest/services/tx_collection/instrumentation.js +0 -2
  201. package/dest/services/tx_collection/request_tracker.d.ts +53 -0
  202. package/dest/services/tx_collection/request_tracker.d.ts.map +1 -0
  203. package/dest/services/tx_collection/request_tracker.js +84 -0
  204. package/dest/services/tx_collection/tx_collection.d.ts +36 -55
  205. package/dest/services/tx_collection/tx_collection.d.ts.map +1 -1
  206. package/dest/services/tx_collection/tx_collection.js +275 -119
  207. package/dest/services/tx_collection/tx_collection_sink.d.ts +1 -1
  208. package/dest/services/tx_collection/tx_collection_sink.js +2 -2
  209. package/dest/services/tx_collection/tx_source.d.ts +6 -5
  210. package/dest/services/tx_collection/tx_source.d.ts.map +1 -1
  211. package/dest/services/tx_collection/tx_source.js +9 -7
  212. package/dest/services/tx_file_store/tx_file_store.d.ts +1 -3
  213. package/dest/services/tx_file_store/tx_file_store.d.ts.map +1 -1
  214. package/dest/services/tx_file_store/tx_file_store.js +4 -14
  215. package/dest/services/tx_provider.d.ts +3 -1
  216. package/dest/services/tx_provider.d.ts.map +1 -1
  217. package/dest/services/tx_provider.js +3 -0
  218. package/dest/test-helpers/make-test-p2p-clients.d.ts +1 -1
  219. package/dest/test-helpers/make-test-p2p-clients.d.ts.map +1 -1
  220. package/dest/test-helpers/make-test-p2p-clients.js +5 -2
  221. package/dest/test-helpers/mock-pubsub.d.ts +23 -9
  222. package/dest/test-helpers/mock-pubsub.d.ts.map +1 -1
  223. package/dest/test-helpers/mock-pubsub.js +44 -44
  224. package/dest/test-helpers/reqresp-nodes.d.ts +4 -5
  225. package/dest/test-helpers/reqresp-nodes.d.ts.map +1 -1
  226. package/dest/test-helpers/reqresp-nodes.js +16 -18
  227. package/dest/test-helpers/test_tx_provider.d.ts +3 -1
  228. package/dest/test-helpers/test_tx_provider.d.ts.map +1 -1
  229. package/dest/test-helpers/test_tx_provider.js +3 -0
  230. package/dest/test-helpers/testbench-utils.d.ts +12 -14
  231. package/dest/test-helpers/testbench-utils.d.ts.map +1 -1
  232. package/dest/test-helpers/testbench-utils.js +38 -14
  233. package/dest/testbench/p2p_client_testbench_worker.d.ts +3 -5
  234. package/dest/testbench/p2p_client_testbench_worker.d.ts.map +1 -1
  235. package/dest/testbench/p2p_client_testbench_worker.js +83 -38
  236. package/dest/testbench/worker_client_manager.d.ts +10 -6
  237. package/dest/testbench/worker_client_manager.d.ts.map +1 -1
  238. package/dest/testbench/worker_client_manager.js +51 -9
  239. package/dest/util.d.ts +11 -6
  240. package/dest/util.d.ts.map +1 -1
  241. package/dest/util.js +35 -14
  242. package/dest/versioning.d.ts +3 -6
  243. package/dest/versioning.d.ts.map +1 -1
  244. package/dest/versioning.js +3 -24
  245. package/package.json +15 -14
  246. package/src/bootstrap/bootstrap.ts +9 -1
  247. package/src/client/factory.ts +49 -7
  248. package/src/client/interface.ts +15 -11
  249. package/src/client/p2p_client.ts +104 -47
  250. package/src/client/test/{tx_proposal_collector/README.md → p2p_client.batch_tx_requester.bench.README.md} +23 -53
  251. package/src/config.ts +123 -6
  252. package/src/errors/p2p-service.error.ts +11 -0
  253. package/src/errors/reqresp.error.ts +0 -25
  254. package/src/index.ts +0 -1
  255. package/src/mem_pools/attestation_pool/attestation_pool.ts +316 -241
  256. package/src/mem_pools/attestation_pool/attestation_pool_test_suite.ts +204 -68
  257. package/src/mem_pools/attestation_pool/mocks.ts +13 -8
  258. package/src/mem_pools/index.ts +0 -3
  259. package/src/mem_pools/instrumentation.ts +5 -1
  260. package/src/mem_pools/tx_pool_v2/archive/tx_archive.ts +1 -9
  261. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.ts +2 -1
  262. package/src/mem_pools/tx_pool_v2/eviction/index.ts +1 -0
  263. package/src/mem_pools/tx_pool_v2/eviction/insufficient_fee_per_gas_eviction_rule.ts +65 -0
  264. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.ts +3 -3
  265. package/src/mem_pools/tx_pool_v2/interfaces.ts +9 -4
  266. package/src/mem_pools/tx_pool_v2/tx_metadata.ts +31 -9
  267. package/src/mem_pools/tx_pool_v2/tx_pool_v2.ts +13 -1
  268. package/src/mem_pools/tx_pool_v2/tx_pool_v2_impl.ts +85 -92
  269. package/src/msg_validators/attestation_validator/README.md +49 -0
  270. package/src/msg_validators/attestation_validator/attestation_validator.ts +41 -9
  271. package/src/msg_validators/attestation_validator/fisherman_attestation_validator.ts +14 -7
  272. package/src/msg_validators/clock_tolerance.ts +73 -3
  273. package/src/msg_validators/proposal_validator/README.md +123 -0
  274. package/src/msg_validators/proposal_validator/block_proposal_validator.ts +12 -2
  275. package/src/msg_validators/proposal_validator/checkpoint_proposal_validator.ts +17 -2
  276. package/src/msg_validators/proposal_validator/proposal_validator.ts +54 -10
  277. package/src/msg_validators/tx_validator/README.md +15 -3
  278. package/src/msg_validators/tx_validator/aggregate_tx_validator.ts +3 -12
  279. package/src/msg_validators/tx_validator/allowed_public_setup.ts +3 -3
  280. package/src/msg_validators/tx_validator/archive_cache.ts +1 -1
  281. package/src/msg_validators/tx_validator/cached_tx_validator.ts +31 -0
  282. package/src/msg_validators/tx_validator/contract_instance_validator.ts +56 -0
  283. package/src/msg_validators/tx_validator/data_validator.ts +44 -1
  284. package/src/msg_validators/tx_validator/factory.ts +46 -8
  285. package/src/msg_validators/tx_validator/gas_validator.ts +82 -33
  286. package/src/msg_validators/tx_validator/index.ts +2 -0
  287. package/src/msg_validators/tx_validator/phases_validator.ts +31 -1
  288. package/src/msg_validators/tx_validator/tx_proof_validator.ts +2 -0
  289. package/src/msg_validators/tx_validator/tx_validation_cache.ts +101 -0
  290. package/src/services/data_store.ts +5 -13
  291. package/src/services/discv5/discV5_service.ts +38 -5
  292. package/src/services/dummy_service.ts +14 -39
  293. package/src/services/encoding.ts +9 -1
  294. package/src/services/gossipsub/topic_score_params.ts +36 -4
  295. package/src/services/libp2p/instrumentation.ts +14 -0
  296. package/src/services/libp2p/libp2p_service.ts +302 -300
  297. package/src/services/peer-manager/peer_manager.ts +44 -10
  298. package/src/services/peer-manager/peer_scoring.ts +27 -5
  299. package/src/services/reqresp/README.md +215 -0
  300. package/src/services/reqresp/batch-tx-requester/README.md +46 -7
  301. package/src/services/reqresp/batch-tx-requester/batch_tx_requester.ts +77 -95
  302. package/src/services/reqresp/batch-tx-requester/interface.ts +13 -5
  303. package/src/services/reqresp/batch-tx-requester/missing_txs.ts +13 -6
  304. package/src/services/reqresp/batch-tx-requester/peer_collection.ts +5 -0
  305. package/src/services/reqresp/batch-tx-requester/tx_validator.ts +12 -25
  306. package/src/services/reqresp/config.ts +2 -2
  307. package/src/services/reqresp/interface.ts +21 -47
  308. package/src/services/reqresp/metrics.ts +0 -1
  309. package/src/services/reqresp/protocols/block_txs/bitvector.ts +3 -2
  310. package/src/services/reqresp/protocols/block_txs/block_txs_handler.ts +34 -30
  311. package/src/services/reqresp/protocols/block_txs/block_txs_reqresp.ts +47 -20
  312. package/src/services/reqresp/protocols/index.ts +0 -1
  313. package/src/services/reqresp/protocols/tx.ts +1 -3
  314. package/src/services/reqresp/rate-limiter/rate_limiter.ts +13 -9
  315. package/src/services/reqresp/rate-limiter/rate_limits.ts +0 -10
  316. package/src/services/reqresp/reqresp.ts +45 -260
  317. package/src/services/service.ts +12 -28
  318. package/src/services/tx_collection/config.ts +3 -80
  319. package/src/services/tx_collection/file_store_tx_collection.ts +54 -103
  320. package/src/services/tx_collection/file_store_tx_source.ts +43 -31
  321. package/src/services/tx_collection/index.ts +1 -6
  322. package/src/services/tx_collection/instrumentation.ts +1 -7
  323. package/src/services/tx_collection/request_tracker.ts +127 -0
  324. package/src/services/tx_collection/tx_collection.ts +331 -176
  325. package/src/services/tx_collection/tx_collection_sink.ts +2 -2
  326. package/src/services/tx_collection/tx_source.ts +8 -7
  327. package/src/services/tx_file_store/tx_file_store.ts +5 -17
  328. package/src/services/tx_provider.ts +5 -0
  329. package/src/test-helpers/make-test-p2p-clients.ts +3 -0
  330. package/src/test-helpers/mock-pubsub.ts +46 -60
  331. package/src/test-helpers/reqresp-nodes.ts +12 -22
  332. package/src/test-helpers/test_tx_provider.ts +5 -0
  333. package/src/test-helpers/testbench-utils.ts +50 -28
  334. package/src/testbench/p2p_client_testbench_worker.ts +87 -54
  335. package/src/testbench/worker_client_manager.ts +59 -20
  336. package/src/util.ts +32 -17
  337. package/src/versioning.ts +3 -33
  338. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker.d.ts +0 -2
  339. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker.d.ts.map +0 -1
  340. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker.js +0 -304
  341. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.d.ts +0 -73
  342. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.d.ts.map +0 -1
  343. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.js +0 -8
  344. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.d.ts +0 -125
  345. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.d.ts.map +0 -1
  346. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.js +0 -596
  347. package/dest/mem_pools/tx_pool/eviction/eviction_manager.d.ts +0 -32
  348. package/dest/mem_pools/tx_pool/eviction/eviction_manager.d.ts.map +0 -1
  349. package/dest/mem_pools/tx_pool/eviction/eviction_manager.js +0 -112
  350. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.d.ts +0 -157
  351. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.d.ts.map +0 -1
  352. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.js +0 -52
  353. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.d.ts +0 -16
  354. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.d.ts.map +0 -1
  355. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.js +0 -122
  356. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.d.ts +0 -17
  357. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.d.ts.map +0 -1
  358. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.js +0 -84
  359. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.d.ts +0 -19
  360. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.d.ts.map +0 -1
  361. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.js +0 -78
  362. package/dest/mem_pools/tx_pool/eviction/low_priority_eviction_rule.d.ts +0 -26
  363. package/dest/mem_pools/tx_pool/eviction/low_priority_eviction_rule.d.ts.map +0 -1
  364. package/dest/mem_pools/tx_pool/eviction/low_priority_eviction_rule.js +0 -84
  365. package/dest/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.d.ts +0 -25
  366. package/dest/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.d.ts.map +0 -1
  367. package/dest/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.js +0 -57
  368. package/dest/mem_pools/tx_pool/index.d.ts +0 -3
  369. package/dest/mem_pools/tx_pool/index.d.ts.map +0 -1
  370. package/dest/mem_pools/tx_pool/index.js +0 -2
  371. package/dest/mem_pools/tx_pool/priority.d.ts +0 -12
  372. package/dest/mem_pools/tx_pool/priority.d.ts.map +0 -1
  373. package/dest/mem_pools/tx_pool/priority.js +0 -16
  374. package/dest/mem_pools/tx_pool/tx_pool.d.ts +0 -127
  375. package/dest/mem_pools/tx_pool/tx_pool.d.ts.map +0 -1
  376. package/dest/mem_pools/tx_pool/tx_pool.js +0 -3
  377. package/dest/mem_pools/tx_pool/tx_pool_test_suite.d.ts +0 -7
  378. package/dest/mem_pools/tx_pool/tx_pool_test_suite.d.ts.map +0 -1
  379. package/dest/mem_pools/tx_pool/tx_pool_test_suite.js +0 -402
  380. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.d.ts +0 -64
  381. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.d.ts.map +0 -1
  382. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.js +0 -151
  383. package/dest/services/reqresp/protocols/block.d.ts +0 -9
  384. package/dest/services/reqresp/protocols/block.d.ts.map +0 -1
  385. package/dest/services/reqresp/protocols/block.js +0 -32
  386. package/dest/services/tx_collection/fast_tx_collection.d.ts +0 -54
  387. package/dest/services/tx_collection/fast_tx_collection.d.ts.map +0 -1
  388. package/dest/services/tx_collection/fast_tx_collection.js +0 -327
  389. package/dest/services/tx_collection/missing_txs_tracker.d.ts +0 -32
  390. package/dest/services/tx_collection/missing_txs_tracker.d.ts.map +0 -1
  391. package/dest/services/tx_collection/missing_txs_tracker.js +0 -27
  392. package/dest/services/tx_collection/proposal_tx_collector.d.ts +0 -49
  393. package/dest/services/tx_collection/proposal_tx_collector.d.ts.map +0 -1
  394. package/dest/services/tx_collection/proposal_tx_collector.js +0 -50
  395. package/dest/services/tx_collection/slow_tx_collection.d.ts +0 -57
  396. package/dest/services/tx_collection/slow_tx_collection.d.ts.map +0 -1
  397. package/dest/services/tx_collection/slow_tx_collection.js +0 -211
  398. package/src/client/test/tx_proposal_collector/proposal_tx_collector_worker.ts +0 -345
  399. package/src/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.ts +0 -43
  400. package/src/mem_pools/tx_pool/README.md +0 -270
  401. package/src/mem_pools/tx_pool/aztec_kv_tx_pool.ts +0 -746
  402. package/src/mem_pools/tx_pool/eviction/eviction_manager.ts +0 -132
  403. package/src/mem_pools/tx_pool/eviction/eviction_strategy.ts +0 -208
  404. package/src/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.ts +0 -162
  405. package/src/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.ts +0 -104
  406. package/src/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.ts +0 -93
  407. package/src/mem_pools/tx_pool/eviction/low_priority_eviction_rule.ts +0 -106
  408. package/src/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.ts +0 -75
  409. package/src/mem_pools/tx_pool/index.ts +0 -2
  410. package/src/mem_pools/tx_pool/priority.ts +0 -23
  411. package/src/mem_pools/tx_pool/tx_pool.ts +0 -141
  412. package/src/mem_pools/tx_pool/tx_pool_test_suite.ts +0 -321
  413. package/src/services/reqresp/connection-sampler/batch_connection_sampler.ts +0 -161
  414. package/src/services/reqresp/protocols/block.ts +0 -37
  415. package/src/services/tx_collection/fast_tx_collection.ts +0 -387
  416. package/src/services/tx_collection/missing_txs_tracker.ts +0 -52
  417. package/src/services/tx_collection/proposal_tx_collector.ts +0 -113
  418. package/src/services/tx_collection/slow_tx_collection.ts +0 -266
@@ -3,19 +3,35 @@ import { NoCommitteeError } from '@aztec/ethereum/contracts';
3
3
  import { type Logger, createLogger } from '@aztec/foundation/log';
4
4
  import {
5
5
  type CheckpointAttestation,
6
+ type CoordinationSignatureContext,
6
7
  type P2PValidator,
7
8
  PeerErrorSeverity,
8
9
  type ValidationResult,
10
+ hasValidSignatureContext,
9
11
  } from '@aztec/stdlib/p2p';
10
12
 
11
- import { isWithinClockTolerance } from '../clock_tolerance.js';
13
+ import { PipeliningWindow, isWithinClockTolerance } from '../clock_tolerance.js';
12
14
 
13
15
  export class CheckpointAttestationValidator implements P2PValidator<CheckpointAttestation> {
14
16
  protected epochCache: EpochCacheInterface;
15
17
  protected logger: Logger;
18
+ private readonly pipeliningWindow: PipeliningWindow;
19
+ protected readonly signatureContext: CoordinationSignatureContext;
16
20
 
17
- constructor(epochCache: EpochCacheInterface) {
21
+ constructor(
22
+ epochCache: EpochCacheInterface,
23
+ opts: {
24
+ l1PublishingTime?: number;
25
+ p2pPropagationTime?: number;
26
+ signatureContext: CoordinationSignatureContext;
27
+ },
28
+ ) {
18
29
  this.epochCache = epochCache;
30
+ this.pipeliningWindow = new PipeliningWindow(epochCache, {
31
+ l1PublishingTime: opts.l1PublishingTime,
32
+ p2pPropagationTime: opts.p2pPropagationTime,
33
+ });
34
+ this.signatureContext = opts.signatureContext;
19
35
  this.logger = createLogger('p2p:checkpoint-attestation-validator');
20
36
  }
21
37
 
@@ -23,18 +39,34 @@ export class CheckpointAttestationValidator implements P2PValidator<CheckpointAt
23
39
  const slotNumber = message.payload.header.slotNumber;
24
40
 
25
41
  try {
26
- const { currentSlot, nextSlot } = this.epochCache.getCurrentAndNextSlot();
42
+ // Cross-chain replay check: reject attestations that carry a foreign signing domain.
43
+ if (!hasValidSignatureContext(message.payload, this.signatureContext)) {
44
+ this.logger.warn(`Rejecting checkpoint attestation with foreign signature context for slot ${slotNumber}`, {
45
+ chainId: message.payload.signatureContext.chainId,
46
+ rollupAddress: message.payload.signatureContext.rollupAddress.toString(),
47
+ expectedChainId: this.signatureContext.chainId,
48
+ expectedRollupAddress: this.signatureContext.rollupAddress.toString(),
49
+ });
50
+ return { result: 'reject', severity: PeerErrorSeverity.LowToleranceError };
51
+ }
52
+
53
+ // Use target slots since proposals target pipeline slots (slot + 1 when pipelining).
54
+ const { targetSlot, nextSlot } = this.epochCache.getTargetAndNextSlot();
27
55
 
28
- if (slotNumber !== currentSlot && slotNumber !== nextSlot) {
29
- // Check if message is for previous slot and within clock tolerance
30
- if (!isWithinClockTolerance(slotNumber, currentSlot, this.epochCache)) {
56
+ if (slotNumber !== targetSlot && slotNumber !== nextSlot) {
57
+ // When pipelining, accept attestations for the current slot (built in the previous slot)
58
+ // until the target slot reaches its L1 publish cutoff.
59
+ if (this.pipeliningWindow.acceptsAttestation(slotNumber)) {
60
+ // Fall through to remaining validation (signature, committee, etc.)
61
+ } else if (!isWithinClockTolerance(slotNumber, targetSlot, this.epochCache)) {
31
62
  this.logger.warn(
32
- `Checkpoint attestation slot ${slotNumber} is not current (${currentSlot}) or next (${nextSlot}) slot`,
63
+ `Checkpoint attestation slot ${slotNumber} is not current (${targetSlot}) or next (${nextSlot}) slot`,
33
64
  );
34
65
  return { result: 'reject', severity: PeerErrorSeverity.HighToleranceError };
66
+ } else {
67
+ this.logger.debug(`Ignoring checkpoint attestation for previous slot ${slotNumber} within clock tolerance`);
68
+ return { result: 'ignore' };
35
69
  }
36
- this.logger.debug(`Ignoring checkpoint attestation for previous slot ${slotNumber} within clock tolerance`);
37
- return { result: 'ignore' };
38
70
  }
39
71
 
40
72
  // Verify the signature is valid
@@ -1,5 +1,10 @@
1
1
  import type { EpochCacheInterface } from '@aztec/epoch-cache';
2
- import { type CheckpointAttestation, PeerErrorSeverity, type ValidationResult } from '@aztec/stdlib/p2p';
2
+ import {
3
+ type CheckpointAttestation,
4
+ type CoordinationSignatureContext,
5
+ PeerErrorSeverity,
6
+ type ValidationResult,
7
+ } from '@aztec/stdlib/p2p';
3
8
  import { Attributes, Metrics, type TelemetryClient, createUpDownCounterWithDefault } from '@aztec/telemetry-client';
4
9
 
5
10
  import type { AttestationPoolApi } from '../../mem_pools/attestation_pool/attestation_pool.js';
@@ -20,8 +25,13 @@ export class FishermanAttestationValidator extends CheckpointAttestationValidato
20
25
  epochCache: EpochCacheInterface,
21
26
  private attestationPool: AttestationPoolApi,
22
27
  telemetryClient: TelemetryClient,
28
+ opts: {
29
+ l1PublishingTime?: number;
30
+ p2pPropagationTime?: number;
31
+ signatureContext: CoordinationSignatureContext;
32
+ },
23
33
  ) {
24
- super(epochCache);
34
+ super(epochCache, opts);
25
35
  this.logger = this.logger.createChild('[FISHERMAN]');
26
36
 
27
37
  const meter = telemetryClient.getMeter('FishermanAttestationValidator');
@@ -54,8 +64,7 @@ export class FishermanAttestationValidator extends CheckpointAttestationValidato
54
64
  return { result: 'accept' };
55
65
  }
56
66
 
57
- const proposalId = message.archive.toString();
58
- const proposal = await this.attestationPool.getCheckpointProposal(proposalId);
67
+ const proposal = await this.attestationPool.getCheckpointProposal(message.payload.header.slotNumber);
59
68
 
60
69
  if (proposal) {
61
70
  // Compare the attestation payload with the proposal payload
@@ -84,9 +93,7 @@ export class FishermanAttestationValidator extends CheckpointAttestationValidato
84
93
  }
85
94
  } else {
86
95
  // We might receive attestations before proposals in some cases
87
- this.logger.debug(
88
- `Received attestation for slot ${slotNumberBigInt} but proposal not found yet. ` + `Proposal ID: ${proposalId}`,
89
- );
96
+ this.logger.debug(`Received attestation for slot ${slotNumberBigInt} but proposal not found yet.`);
90
97
  }
91
98
 
92
99
  return { result: 'accept' };
@@ -1,5 +1,6 @@
1
1
  import type { EpochCacheInterface } from '@aztec/epoch-cache';
2
2
  import { SlotNumber } from '@aztec/foundation/branded-types';
3
+ import { DEFAULT_P2P_PROPAGATION_TIME, createPipelinedCheckpointTimingModel } from '@aztec/stdlib/timetable';
3
4
 
4
5
  /**
5
6
  * Maximum clock disparity tolerance for P2P message validation (in milliseconds).
@@ -36,10 +37,11 @@ export function isWithinClockTolerance(
36
37
  }
37
38
 
38
39
  // Check how far we are into the current slot (in milliseconds)
39
- const { ts: slotStartTs, nowMs, slot } = epochCache.getEpochAndSlotNow();
40
+ const { ts: slotStartTs, nowMs } = epochCache.getEpochAndSlotNow();
41
+ const targetSlot = epochCache.getTargetSlot();
40
42
 
41
- // Sanity check: ensure the epoch cache's current slot matches the expected current slot
42
- if (slot !== currentSlot) {
43
+ // Sanity check: ensure the epoch cache's target slot matches the expected current slot
44
+ if (targetSlot !== currentSlot) {
43
45
  return false;
44
46
  }
45
47
 
@@ -49,3 +51,71 @@ export function isWithinClockTolerance(
49
51
 
50
52
  return elapsedMs < MAXIMUM_GOSSIP_CLOCK_DISPARITY_MS;
51
53
  }
54
+
55
+ /**
56
+ * Checks if a straggler message for the previous target slot should be accepted.
57
+ *
58
+ * Proposals and attestations carry the target slot N. Most of the time the receiver is either
59
+ * still in the build slot N-1 (accepted via the main `slotNumber === targetSlot` match) or in the
60
+ * target slot N (accepted again via `targetSlot`). Stragglers that arrive after the receiver has
61
+ * rolled past the target slot fall to this check: accept `messageSlot === slotNow` while we're
62
+ * still within the first `windowSeconds + clock-disparity` of the slot.
63
+ *
64
+ * Under the early-pipelining schedule `windowSeconds` is small (0 for proposals,
65
+ * `2*p2pPropagationTime` for attestations) since the proposer collects everything
66
+ * before the slot boundary.
67
+ *
68
+ * @param messageSlot - The slot number from the received message
69
+ * @param epochCache - EpochCache to get timing state
70
+ * @param windowSeconds - How far into the current slot we still accept previous-target messages
71
+ * @returns true if the message is for the current wallclock slot and we're within the grace period
72
+ */
73
+ function isWithinPipeliningWindow(
74
+ messageSlot: SlotNumber,
75
+ epochCache: EpochCacheInterface,
76
+ windowSeconds: number,
77
+ ): boolean {
78
+ const currentSlot = epochCache.getSlotNow();
79
+ if (messageSlot !== currentSlot) {
80
+ return false;
81
+ }
82
+
83
+ const { ts: slotStartTs, nowMs } = epochCache.getEpochAndSlotNow();
84
+ const slotStartMs = slotStartTs * 1000n;
85
+ const elapsedMs = Number(nowMs - slotStartMs);
86
+ const windowMs = windowSeconds * 1000 + MAXIMUM_GOSSIP_CLOCK_DISPARITY_MS;
87
+
88
+ return elapsedMs < windowMs;
89
+ }
90
+
91
+ export class PipeliningWindow {
92
+ private readonly proposalWindowIntoTargetSlot: number;
93
+ private readonly attestationWindowIntoTargetSlot: number;
94
+
95
+ constructor(
96
+ private readonly epochCache: EpochCacheInterface,
97
+ opts: {
98
+ p2pPropagationTime?: number;
99
+ l1PublishingTime?: number;
100
+ } = {},
101
+ ) {
102
+ const l1Constants = epochCache.getL1Constants();
103
+ const checkpointTiming = createPipelinedCheckpointTimingModel({
104
+ aztecSlotDuration: l1Constants.slotDuration,
105
+ ethereumSlotDuration: l1Constants.ethereumSlotDuration,
106
+ l1PublishingTime: opts.l1PublishingTime ?? l1Constants.ethereumSlotDuration,
107
+ p2pPropagationTime: opts.p2pPropagationTime ?? DEFAULT_P2P_PROPAGATION_TIME,
108
+ });
109
+
110
+ this.proposalWindowIntoTargetSlot = checkpointTiming.proposalWindowIntoTargetSlot;
111
+ this.attestationWindowIntoTargetSlot = checkpointTiming.attestationWindowIntoTargetSlot;
112
+ }
113
+
114
+ public acceptsProposal(messageSlot: SlotNumber): boolean {
115
+ return isWithinPipeliningWindow(messageSlot, this.epochCache, this.proposalWindowIntoTargetSlot);
116
+ }
117
+
118
+ public acceptsAttestation(messageSlot: SlotNumber): boolean {
119
+ return isWithinPipeliningWindow(messageSlot, this.epochCache, this.attestationWindowIntoTargetSlot);
120
+ }
121
+ }
@@ -0,0 +1,123 @@
1
+ # Proposal Validation
2
+
3
+ This module validates `BlockProposal` and `CheckpointProposal` gossipsub messages. Both share the same base `ProposalValidator` (neither subclass overrides `validate()`), with checkpoint-specific logic layered on top in the gossipsub handler.
4
+
5
+ ## BlockProposal
6
+
7
+ **Topic**: `block_proposal` | **Snappy size limit**: 10 MB
8
+
9
+ ### Stage 1: Gossipsub Validation (ProposalValidator)
10
+
11
+ File: `proposal_validator.ts`
12
+
13
+ | # | Rule | Consequence | Severity |
14
+ |---|------|-------------|----------|
15
+ | 1 | **Slot check**: must be `currentSlot` or `nextSlot`. Previous slot within 500ms tolerance: IGNORE. | REJECT | HighToleranceError |
16
+ | 2 | **Signature**: `getSender()` must recover a valid address. If `signedTxs` present, its recovered sender must match. | REJECT | MidToleranceError |
17
+ | 3 | **Txs permitted**: if `disableTransactions`, must have 0 txHashes and 0 embedded txs | REJECT | MidToleranceError |
18
+ | 4 | **Max txs**: `txHashes.length <= maxTxsPerBlock` | REJECT | MidToleranceError |
19
+ | 5 | **Embedded txs in txHashes**: every embedded tx's hash must appear in `txHashes` | REJECT | MidToleranceError |
20
+ | 6 | **Proposer check**: signer must match expected proposer for slot (skipped if committee size = 0) | REJECT | MidToleranceError |
21
+ | 7 | **Tx hash integrity**: each embedded tx's recomputed hash must match declared hash | REJECT | LowToleranceError |
22
+ | 8 | **NoCommitteeError**: epoch cache cannot determine committee | REJECT | LowToleranceError |
23
+
24
+ Deserialization guards: `BlockProposal.fromBuffer` and `SignedTxs.fromBuffer` both enforce `txCount <= MAX_TXS_PER_BLOCK` (65536). Violation -> REJECT + LowToleranceError.
25
+
26
+ ### Stage 2: Mempool (Attestation Pool)
27
+
28
+ | # | Rule | Consequence |
29
+ |---|------|-------------|
30
+ | 9 | **Duplicate**: same archive root already stored | IGNORE (no penalty) |
31
+ | 10 | **Per-position cap**: max 2 proposals per (slot, indexWithinCheckpoint) | REJECT + HighToleranceError |
32
+ | 11 | **Equivocation**: >1 distinct proposal for same (slot, index) | ACCEPT (rebroadcast for detection). At count=2: `duplicateProposalCallback` fires -> slash event (`OffenseType.DUPLICATE_PROPOSAL`, configured via `slashDuplicateProposalPenalty`) |
33
+
34
+ ### Stage 3: Validator-Client Processing (BlockProposalHandler)
35
+
36
+ Only runs on validator nodes. Non-validator nodes use a default handler that triggers tx collection without deep validation.
37
+
38
+ | # | Rule | Failure Reason |
39
+ |---|------|----------------|
40
+ | 12 | Signature re-check | `invalid_proposal` |
41
+ | 13 | ProposalValidator re-run | `invalid_proposal` |
42
+ | 14 | Self-proposal filter | Ignored silently |
43
+ | 15 | Parent block exists (`lastArchive.root` matches known block or genesis) | `parent_block_not_found` |
44
+ | 16 | Parent block slot <= proposal slot | `parent_block_wrong_slot` |
45
+ | 17 | Block number not already in archiver | `block_number_already_exists` |
46
+ | 18 | Checkpoint number consistency (multiple sub-rules for first/non-first blocks) | `invalid_proposal` |
47
+ | 19 | Global variables consistency (non-first block: chainId, version, slot, timestamp, coinbase, feeRecipient, gasFees match parent) | `global_variables_mismatch` |
48
+ | 20 | L1-to-L2 message hash matches `proposal.inHash` | `in_hash_mismatch` |
49
+ | 21 | All txs referenced by `txHashes` obtainable | `txs_not_available` |
50
+ | 22 | **Re-execution**: processed tx count matches `txHashes.length` | `timeout` (ReExTimeoutError) |
51
+ | 23 | **Re-execution**: no failed txs | `failed_txs` (ReExFailedTxsError) -- **SLASHABLE** |
52
+ | 24 | **Re-execution**: archive root and header match proposal | `state_mismatch` (ReExStateMismatchError) -- **SLASHABLE** |
53
+
54
+ **Escape hatch**: during escape hatch periods (`isEscapeHatchOpenAtSlot`), re-execution and slashing are both disabled, and the proposal is rejected locally.
55
+
56
+ **Conditional re-execution**: rules 22-24 only run when at least one condition is true: `fishermanMode` enabled, `slashBroadcastedInvalidBlockPenalty > 0`, committee membership, `alwaysReexecuteBlockProposals`, or `blobClient.canUpload()`.
57
+
58
+ **Slashing**: only `state_mismatch` and `failed_txs` trigger on-chain slashing (`OffenseType.BROADCASTED_INVALID_BLOCK_PROPOSAL`, gated by `slashBroadcastedInvalidBlockPenalty > 0`). Unknown errors during re-execution do NOT slash.
59
+
60
+ **Embedded tx validation**: txs in `signedTxs` are validated via `createTxValidatorForBlockProposalReceivedTxs` (well-formedness only) when stored in the tx pool. Invalid embedded txs are rejected from the pool but do not cause the block proposal itself to be rejected at gossipsub level.
61
+
62
+ ### Gossipsub Topic Scoring
63
+
64
+ | Parameter | Effect |
65
+ |-----------|--------|
66
+ | P4 (invalidMessageDeliveries) | weight = -20, decay over 4 slots |
67
+ | P3 (meshMessageDeliveries) | Enabled only when `expectedBlockProposalsPerSlot > 0` (MBPS mode) |
68
+ | P1/P2 | Only active when P3 is enabled |
69
+
70
+ ---
71
+
72
+ ## CheckpointProposal
73
+
74
+ **Topic**: `checkpoint_proposal` | **Snappy size limit**: 10 MB
75
+
76
+ ### Stage 1: Gossipsub Validation (ProposalValidator)
77
+
78
+ Same `ProposalValidator.validate()` as BlockProposal (shared implementation, neither subclass overrides it). See BlockProposal Stage 1 rules 1-8.
79
+
80
+ ### Stage 2: Embedded Block Proposal Validation (if `lastBlock` present)
81
+
82
+ The checkpoint's embedded `lastBlock` is extracted via `getBlockProposal()` and validated through `BlockProposalValidator.validate()` plus block mempool checks.
83
+
84
+ | Rule | Consequence | File |
85
+ |------|-------------|------|
86
+ | Block proposal must pass `BlockProposalValidator.validate()` | If REJECT: entire checkpoint REJECTED | `libp2p_service.ts` |
87
+ | Block proposal must not exceed per-position cap (2) | Checkpoint REJECTED + HighToleranceError | same |
88
+ | Block equivocation detected (>1 proposals for same slot+index) | Checkpoint REJECTED (block itself is ACCEPT for re-broadcast) | same |
89
+
90
+ ### Stage 3: Mempool (Attestation Pool)
91
+
92
+ | Rule | Consequence | File |
93
+ |------|-------------|------|
94
+ | Duplicate (same archive ID) | IGNORE (no penalty). Embedded block still processed if valid. | `attestation_pool.ts` |
95
+ | Per-slot cap: `MAX_CHECKPOINT_PROPOSALS_PER_SLOT` = 2 | REJECT + HighToleranceError. Embedded block still processed. | same |
96
+
97
+ ### Stage 4: Equivocation Detection
98
+
99
+ When >1 checkpoint proposals exist for same slot (count > 1): ACCEPT (re-broadcast). At count == 2 (exactly): `duplicateProposalCallback` fires. Proposal NOT further processed. Callback fires only once per equivocation pair.
100
+
101
+ ### Stage 5: Validator-Client Consensus Validation
102
+
103
+ Determines whether the validator signs an attestation.
104
+
105
+ | Rule | Consequence | File |
106
+ |------|-------------|------|
107
+ | Escape hatch open | No attestation | `validator-client/src/validator.ts` |
108
+ | Signature invalid (re-check) | No attestation | same |
109
+ | Self-proposal | No attestation (ignored) | same |
110
+ | `feeAssetPriceModifier` outside [-100, +100] bps | No attestation | same |
111
+ | Not in committee (unless fisherman mode) | No attestation | same |
112
+ | Checkpoint header mismatch (computed vs proposal) | No attestation | same |
113
+ | Archive root mismatch | No attestation | same |
114
+ | Epoch out hash mismatch | No attestation | same |
115
+ | Last block not found / not matching | No attestation | same |
116
+ | Already attested to this or earlier slot | No attestation (unless `attestToEquivocatedProposals`) | same |
117
+
118
+ **`skipCheckpointProposalValidation` config**: when true, the re-execution checks (header/archive/epoch hash) are all skipped. Signature, fee modifier, committee, escape hatch, and equivocation checks still apply.
119
+
120
+ ### Gossipsub Topic Scoring
121
+
122
+ P3 enabled with expected rate of 1 message per slot. P4 weight = -20, max P3 penalty = -34 per topic.
123
+
@@ -1,12 +1,22 @@
1
1
  import type { EpochCacheInterface } from '@aztec/epoch-cache';
2
- import type { BlockProposal, P2PValidator, ValidationResult } from '@aztec/stdlib/p2p';
2
+ import type { BlockProposal, CoordinationSignatureContext, P2PValidator, ValidationResult } from '@aztec/stdlib/p2p';
3
3
 
4
4
  import { ProposalValidator } from '../proposal_validator/proposal_validator.js';
5
5
 
6
6
  export class BlockProposalValidator implements P2PValidator<BlockProposal> {
7
7
  private proposalValidator: ProposalValidator;
8
8
 
9
- constructor(epochCache: EpochCacheInterface, opts: { txsPermitted: boolean; maxTxsPerBlock?: number }) {
9
+ constructor(
10
+ epochCache: EpochCacheInterface,
11
+ opts: {
12
+ txsPermitted: boolean;
13
+ maxTxsPerBlock?: number;
14
+ maxBlocksPerCheckpoint?: number;
15
+ p2pPropagationTime?: number;
16
+ skipSlotValidation?: boolean;
17
+ signatureContext: CoordinationSignatureContext;
18
+ },
19
+ ) {
10
20
  this.proposalValidator = new ProposalValidator(epochCache, opts, 'p2p:block_proposal_validator');
11
21
  }
12
22
 
@@ -1,12 +1,27 @@
1
1
  import type { EpochCacheInterface } from '@aztec/epoch-cache';
2
- import type { CheckpointProposal, P2PValidator, ValidationResult } from '@aztec/stdlib/p2p';
2
+ import type {
3
+ CheckpointProposal,
4
+ CoordinationSignatureContext,
5
+ P2PValidator,
6
+ ValidationResult,
7
+ } from '@aztec/stdlib/p2p';
3
8
 
4
9
  import { ProposalValidator } from '../proposal_validator/proposal_validator.js';
5
10
 
6
11
  export class CheckpointProposalValidator implements P2PValidator<CheckpointProposal> {
7
12
  private proposalValidator: ProposalValidator;
8
13
 
9
- constructor(epochCache: EpochCacheInterface, opts: { txsPermitted: boolean; maxTxsPerBlock?: number }) {
14
+ constructor(
15
+ epochCache: EpochCacheInterface,
16
+ opts: {
17
+ txsPermitted: boolean;
18
+ maxTxsPerBlock?: number;
19
+ maxBlocksPerCheckpoint?: number;
20
+ p2pPropagationTime?: number;
21
+ skipSlotValidation?: boolean;
22
+ signatureContext: CoordinationSignatureContext;
23
+ },
24
+ ) {
10
25
  this.proposalValidator = new ProposalValidator(epochCache, opts, 'p2p:checkpoint_proposal_validator');
11
26
  }
12
27
 
@@ -4,11 +4,13 @@ import { type Logger, createLogger } from '@aztec/foundation/log';
4
4
  import {
5
5
  type BlockProposal,
6
6
  type CheckpointProposalCore,
7
+ type CoordinationSignatureContext,
7
8
  PeerErrorSeverity,
8
9
  type ValidationResult,
10
+ hasValidSignatureContext,
9
11
  } from '@aztec/stdlib/p2p';
10
12
 
11
- import { isWithinClockTolerance } from '../clock_tolerance.js';
13
+ import { PipeliningWindow, isWithinClockTolerance } from '../clock_tolerance.js';
12
14
 
13
15
  /** Validates header-level and tx-level fields of block and checkpoint proposals. */
14
16
  export class ProposalValidator {
@@ -16,32 +18,63 @@ export class ProposalValidator {
16
18
  private logger: Logger;
17
19
  private txsPermitted: boolean;
18
20
  private maxTxsPerBlock?: number;
21
+ private maxBlocksPerCheckpoint?: number;
22
+ private pipeliningWindow: PipeliningWindow;
23
+ private skipSlotValidation: boolean;
24
+ private signatureContext: CoordinationSignatureContext;
19
25
 
20
26
  constructor(
21
27
  epochCache: EpochCacheInterface,
22
- opts: { txsPermitted: boolean; maxTxsPerBlock?: number },
28
+ opts: {
29
+ txsPermitted: boolean;
30
+ maxTxsPerBlock?: number;
31
+ maxBlocksPerCheckpoint?: number;
32
+ p2pPropagationTime?: number;
33
+ skipSlotValidation?: boolean;
34
+ signatureContext: CoordinationSignatureContext;
35
+ },
23
36
  loggerName: string,
24
37
  ) {
25
38
  this.epochCache = epochCache;
26
39
  this.txsPermitted = opts.txsPermitted;
27
40
  this.maxTxsPerBlock = opts.maxTxsPerBlock;
41
+ this.maxBlocksPerCheckpoint = opts.maxBlocksPerCheckpoint;
42
+ this.pipeliningWindow = new PipeliningWindow(epochCache, { p2pPropagationTime: opts.p2pPropagationTime });
43
+ this.skipSlotValidation = opts.skipSlotValidation ?? false;
44
+ this.signatureContext = opts.signatureContext;
28
45
  this.logger = createLogger(loggerName);
29
46
  }
30
47
 
31
48
  /** Validates header-level fields: slot, signature, and proposer. */
32
49
  public async validate(proposal: BlockProposal | CheckpointProposalCore): Promise<ValidationResult> {
33
50
  try {
34
- // Slot check
35
- const { currentSlot, nextSlot } = this.epochCache.getCurrentAndNextSlot();
51
+ // Cross-chain replay check: reject proposals that carry a foreign signing domain.
52
+ if (!hasValidSignatureContext(proposal, this.signatureContext)) {
53
+ this.logger.warn(`Penalizing peer for proposal with foreign signature context`, {
54
+ chainId: proposal.signatureContext.chainId,
55
+ rollupAddress: proposal.signatureContext.rollupAddress.toString(),
56
+ expectedChainId: this.signatureContext.chainId,
57
+ expectedRollupAddress: this.signatureContext.rollupAddress.toString(),
58
+ });
59
+ return { result: 'reject', severity: PeerErrorSeverity.LowToleranceError };
60
+ }
61
+
62
+ // Slot check: use target slots since proposals target pipeline slots (slot + 1 when pipelining).
63
+ const { targetSlot, nextSlot } = this.epochCache.getTargetAndNextSlot();
64
+
36
65
  const slotNumber = proposal.slotNumber;
37
- if (slotNumber !== currentSlot && slotNumber !== nextSlot) {
38
- // Check if message is for previous slot and within clock tolerance
39
- if (!isWithinClockTolerance(slotNumber, currentSlot, this.epochCache)) {
40
- this.logger.warn(`Penalizing peer for invalid slot number ${slotNumber}`, { currentSlot, nextSlot });
66
+ if (!this.skipSlotValidation && slotNumber !== targetSlot && slotNumber !== nextSlot) {
67
+ // When pipelining, accept proposals for the current slot (built in the previous slot)
68
+ // if they're still within the shared proposal acceptance window.
69
+ if (this.pipeliningWindow.acceptsProposal(slotNumber)) {
70
+ // Fall through to remaining validation (signature, proposer, etc.)
71
+ } else if (!isWithinClockTolerance(slotNumber, targetSlot, this.epochCache)) {
72
+ this.logger.warn(`Penalizing peer for invalid slot number ${slotNumber}`, { targetSlot, nextSlot });
41
73
  return { result: 'reject', severity: PeerErrorSeverity.HighToleranceError };
74
+ } else {
75
+ this.logger.verbose(`Ignoring proposal for previous slot ${slotNumber} within clock tolerance`);
76
+ return { result: 'ignore' };
42
77
  }
43
- this.logger.verbose(`Ignoring proposal for previous slot ${slotNumber} within clock tolerance`);
44
- return { result: 'ignore' };
45
78
  }
46
79
 
47
80
  // Signature validity
@@ -61,6 +94,17 @@ export class ProposalValidator {
61
94
  return { result: 'reject', severity: PeerErrorSeverity.MidToleranceError };
62
95
  }
63
96
 
97
+ if (
98
+ this.maxBlocksPerCheckpoint !== undefined &&
99
+ 'indexWithinCheckpoint' in proposal &&
100
+ proposal.indexWithinCheckpoint >= this.maxBlocksPerCheckpoint
101
+ ) {
102
+ this.logger.warn(
103
+ `Penalizing peer for proposal with indexWithinCheckpoint ${proposal.indexWithinCheckpoint} >= max ${this.maxBlocksPerCheckpoint}`,
104
+ );
105
+ return { result: 'reject', severity: PeerErrorSeverity.MidToleranceError };
106
+ }
107
+
64
108
  return { result: 'accept' };
65
109
  } catch (e) {
66
110
  if (e instanceof NoCommitteeError) {
@@ -75,10 +75,12 @@ This validator is invoked on **every** transaction potentially entering the pend
75
75
  - Startup hydration — revalidating persisted non-mined txs on node restart
76
76
 
77
77
  Runs:
78
- - DoubleSpend, BlockHeader, GasLimits, Timestamp
78
+ - DoubleSpend, BlockHeader, GasLimits, MaxFeePerGas, Timestamp, AllowedSetupCalls
79
79
 
80
80
  Operates on `TxMetaData` (pre-built by the pool) rather than full `Tx` objects.
81
81
 
82
+ The `AllowedSetupCallsMetaValidator` checks a precomputed boolean flag (`TxMetaData.allowedSetupCalls`) rather than re-running the full `PhasesTxValidator`. This flag is computed by `createCheckAllowedSetupCalls` when the tx first enters the pool (via `addProtectedTxs` or startup hydration), so the pool migration validator can reject txs with disallowed setup calls without needing the full `Tx` object or its dependencies.
83
+
82
84
  ## Individual Validators
83
85
 
84
86
  | Validator | What it checks | Benchmarked verification duration |
@@ -89,9 +91,11 @@ Operates on `TxMetaData` (pre-built by the pool) rather than full `Tx` objects.
89
91
  | `MetadataTxValidator` | Chain ID, rollup version, protocol contracts hash, VK tree root | 4.18 us |
90
92
  | `TimestampTxValidator` | Transaction has not expired (expiration timestamp vs next slot) | 1.56 us |
91
93
  | `DoubleSpendTxValidator` | Nullifiers do not already exist in the nullifier tree | 106.08 us |
92
- | `GasTxValidator` | Gas limits are within bounds (delegates to `GasLimitsValidator`), max fee per gas meets current block fees, and fee payer has sufficient FeeJuice balance | 1.02 ms |
94
+ | `GasTxValidator` | Gas limits are within bounds (delegates to `GasLimitsValidator`), max fee per gas meets current block fees (delegates to `MaxFeePerGasValidator`), and fee payer has sufficient FeeJuice balance | 1.02 ms |
93
95
  | `GasLimitsValidator` | Gas limits are >= fixed minimums and <= AVM max processable L2 gas. Used standalone in pool migration; also called internally by `GasTxValidator` | 3–10 us |
96
+ | `MaxFeePerGasValidator` | Max fee per gas >= current block gas fees on both dimensions (DA and L2). Used standalone in pool migration; also called internally by `GasTxValidator` | 3–10 us |
94
97
  | `PhasesTxValidator` | Public function calls in setup phase are on the allow list | 10.12–13.12 us |
98
+ | `AllowedSetupCallsMetaValidator` | Checks the precomputed `allowedSetupCalls` flag on `TxMetaData`. Used in pool migration instead of the full `PhasesTxValidator` | — |
95
99
  | `BlockHeaderTxValidator` | Transaction's anchor block hash exists in the archive tree | 98.88 us |
96
100
  | `TxProofValidator` | Client proof verifies correctly | ~250ms |
97
101
 
@@ -107,9 +111,17 @@ Operates on `TxMetaData` (pre-built by the pool) rather than full `Tx` objects.
107
111
  | DoubleSpend | Stage 1 | Yes | — | Yes | Yes |
108
112
  | Gas (balance + limits) | Stage 1 | Optional* | — | Yes | — |
109
113
  | GasLimits (standalone) | — | — | — | — | Yes |
114
+ | MaxFeePerGas (standalone) | — | — | — | — | Yes |
110
115
  | Phases | Stage 1 | Yes | — | Yes | — |
116
+ | AllowedSetupCalls | — | — | — | — | Yes |
111
117
  | BlockHeader | Stage 1 | Yes | — | Yes | Yes |
112
118
  | Proof | Stage 2 | Optional** | Yes | — | — |
113
119
 
114
- \* Gas balance check is skipped when `skipFeeEnforcement` is set (testing/dev). `GasTxValidator` internally delegates to `GasLimitsValidator` as its first step, so gas limits are checked wherever `GasTxValidator` runs. Pool migration uses `GasLimitsValidator` standalone because it doesn't need the balance or fee-per-gas checks.
120
+ \* Gas balance check is skipped when `skipFeeEnforcement` is set (testing/dev). `GasTxValidator` internally delegates to `GasLimitsValidator` and `MaxFeePerGasValidator` as its first steps, so gas limits and fee-per-gas are checked wherever `GasTxValidator` runs. Pool migration uses `GasLimitsValidator` and `MaxFeePerGasValidator` standalone because it doesn't need the balance check.
115
121
  \** Proof verification is skipped for simulations (no verifier provided).
122
+
123
+ ## Fee-Per-Gas Rejection Strategy
124
+
125
+ The `MaxFeePerGasValidator` and `InsufficientFeePerGasEvictionRule` reject and evict transactions whose `maxFeesPerGas` falls below the current block's gas fees. This is a simple strategy: if a tx can't pay the current fees, it gets rejected on entry and evicted after each new block.
126
+
127
+ **Caveat**: This may evict transactions that would become valid again if block fees drop. A more nuanced approach would be to define a threshold (e.g., 50%) and only reject/evict when the tx's max fee falls below that fraction of the current fees. The current approach is simpler and ensures the pool doesn't accumulate transactions with low max fees that are unlikely to be mined soon.
@@ -11,22 +11,13 @@ export class AggregateTxValidator<T> implements TxValidator<T> {
11
11
  }
12
12
 
13
13
  async validateTx(tx: T): Promise<TxValidationResult> {
14
- const aggregate: { result: string; reason?: string[] } = { result: 'valid', reason: [] };
14
+ const reasons: string[] = [];
15
15
  for (const validator of this.validators) {
16
16
  const result = await validator.validateTx(tx);
17
17
  if (result.result === 'invalid') {
18
- aggregate.result = 'invalid';
19
- aggregate.reason!.push(...result.reason);
20
- } else if (result.result === 'skipped') {
21
- if (aggregate.result === 'valid') {
22
- aggregate.result = 'skipped';
23
- }
24
- aggregate.reason!.push(...result.reason);
18
+ reasons.push(...result.reason);
25
19
  }
26
20
  }
27
- if (aggregate.result === 'valid') {
28
- delete aggregate.reason;
29
- }
30
- return aggregate as TxValidationResult;
21
+ return reasons.length > 0 ? { result: 'invalid', reason: reasons } : { result: 'valid' };
31
22
  }
32
23
  }
@@ -1,6 +1,6 @@
1
1
  import { ProtocolContractAddress } from '@aztec/protocol-contracts';
2
- import { AuthRegistryArtifact } from '@aztec/protocol-contracts/auth-registry';
3
2
  import { FeeJuiceArtifact } from '@aztec/protocol-contracts/fee-juice';
3
+ import { AuthRegistryArtifact, STANDARD_AUTH_REGISTRY_ADDRESS } from '@aztec/standard-contracts/auth-registry';
4
4
  import type { AllowedElement } from '@aztec/stdlib/interfaces/server';
5
5
 
6
6
  import { buildAllowedElement } from './allowed_setup_helpers.js';
@@ -12,12 +12,12 @@ export async function getDefaultAllowedSetupFunctions(): Promise<AllowedElement[
12
12
  if (defaultAllowedSetupFunctions === undefined) {
13
13
  defaultAllowedSetupFunctions = await Promise.all([
14
14
  // AuthRegistry: needed for authwit support via private path (set_authorized_private enqueues _set_authorized)
15
- buildAllowedElement(AuthRegistryArtifact, { address: ProtocolContractAddress.AuthRegistry }, '_set_authorized', {
15
+ buildAllowedElement(AuthRegistryArtifact, { address: STANDARD_AUTH_REGISTRY_ADDRESS }, '_set_authorized', {
16
16
  onlySelf: true,
17
17
  rejectNullMsgSender: true,
18
18
  }),
19
19
  // AuthRegistry: needed for authwit support via public path (PublicFeePaymentMethod calls set_authorized directly)
20
- buildAllowedElement(AuthRegistryArtifact, { address: ProtocolContractAddress.AuthRegistry }, 'set_authorized', {
20
+ buildAllowedElement(AuthRegistryArtifact, { address: STANDARD_AUTH_REGISTRY_ADDRESS }, 'set_authorized', {
21
21
  rejectNullMsgSender: true,
22
22
  }),
23
23
  // FeeJuice: needed for claiming on the same tx as a spend (claim_and_end_setup enqueues this)
@@ -15,7 +15,7 @@ export class ArchiveCache implements ArchiveSource {
15
15
  }
16
16
 
17
17
  public async getArchiveIndices(archives: BlockHash[]): Promise<(bigint | undefined)[]> {
18
- const toCheckDb = archives.filter(n => !this.archives.has(n.toString())).map(n => n.toFr());
18
+ const toCheckDb = archives.filter(n => !this.archives.has(n.toString()));
19
19
  const dbHits = await this.db.findLeafIndices(MerkleTreeId.ARCHIVE, toCheckDb);
20
20
  dbHits.forEach((x, index) => {
21
21
  if (x !== undefined) {
@@ -0,0 +1,31 @@
1
+ import type { Tx, TxValidationResult, TxValidator } from '@aztec/stdlib/tx';
2
+
3
+ import type { ITxValidationCache } from './tx_validation_cache.js';
4
+
5
+ /** Wraps a {@link TxValidator} to cache its results in a shared {@link ITxValidationCache}. */
6
+ export class CachedTxValidator<T extends Tx> implements TxValidator<T> {
7
+ constructor(
8
+ private readonly inner: TxValidator<T>,
9
+ private readonly validatorSymbol: symbol,
10
+ private readonly cache: ITxValidationCache,
11
+ ) {}
12
+
13
+ public static new<T extends Tx>(
14
+ inner: TxValidator<T> & { identifier: symbol },
15
+ cache?: ITxValidationCache,
16
+ ): TxValidator<T> {
17
+ return CachedTxValidator.newWithIdentifier(inner, inner.identifier, cache);
18
+ }
19
+
20
+ public static newWithIdentifier<T extends Tx>(
21
+ inner: TxValidator<T>,
22
+ identifier: symbol,
23
+ cache?: ITxValidationCache,
24
+ ): TxValidator<T> {
25
+ return cache ? new CachedTxValidator(inner, identifier, cache) : inner;
26
+ }
27
+
28
+ public validateTx(tx: T): Promise<TxValidationResult> {
29
+ return this.cache.getOrValidate(this.validatorSymbol, tx, () => this.inner.validateTx(tx));
30
+ }
31
+ }