@aztec/p2p 0.0.1-commit.343b43af6 → 0.0.1-commit.350e0a4d

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 (435) hide show
  1. package/README.md +130 -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 +22 -6
  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 +36 -19
  8. package/dest/client/interface.d.ts +48 -11
  9. package/dest/client/interface.d.ts.map +1 -1
  10. package/dest/client/p2p_client.d.ts +34 -19
  11. package/dest/client/p2p_client.d.ts.map +1 -1
  12. package/dest/client/p2p_client.js +115 -50
  13. package/dest/config.d.ts +147 -105
  14. package/dest/config.d.ts.map +1 -1
  15. package/dest/config.js +80 -24
  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 +9 -16
  20. package/dest/errors/reqresp.error.d.ts.map +1 -1
  21. package/dest/errors/reqresp.error.js +10 -17
  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 +101 -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 +272 -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 +224 -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 +9 -4
  37. package/dest/mem_pools/instrumentation.d.ts.map +1 -1
  38. package/dest/mem_pools/instrumentation.js +28 -9
  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/deleted_pool.d.ts +3 -3
  43. package/dest/mem_pools/tx_pool_v2/deleted_pool.d.ts.map +1 -1
  44. package/dest/mem_pools/tx_pool_v2/deleted_pool.js +6 -6
  45. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.d.ts +1 -1
  46. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.d.ts.map +1 -1
  47. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.js +3 -2
  48. package/dest/mem_pools/tx_pool_v2/eviction/index.d.ts +2 -1
  49. package/dest/mem_pools/tx_pool_v2/eviction/index.d.ts.map +1 -1
  50. package/dest/mem_pools/tx_pool_v2/eviction/index.js +1 -0
  51. package/dest/mem_pools/tx_pool_v2/eviction/insufficient_fee_per_gas_eviction_rule.d.ts +16 -0
  52. package/dest/mem_pools/tx_pool_v2/eviction/insufficient_fee_per_gas_eviction_rule.d.ts.map +1 -0
  53. package/dest/mem_pools/tx_pool_v2/eviction/insufficient_fee_per_gas_eviction_rule.js +62 -0
  54. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.js +2 -2
  55. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts +39 -9
  56. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts.map +1 -1
  57. package/dest/mem_pools/tx_pool_v2/interfaces.js +2 -1
  58. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts +13 -3
  59. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts.map +1 -1
  60. package/dest/mem_pools/tx_pool_v2/tx_metadata.js +20 -7
  61. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.d.ts +15 -1
  62. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.d.ts.map +1 -1
  63. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.js +31 -0
  64. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts +12 -4
  65. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts.map +1 -1
  66. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.js +22 -8
  67. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts +17 -4
  68. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts.map +1 -1
  69. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.js +217 -120
  70. package/dest/msg_validators/attestation_validator/attestation_validator.d.ts +10 -3
  71. package/dest/msg_validators/attestation_validator/attestation_validator.d.ts.map +1 -1
  72. package/dest/msg_validators/attestation_validator/attestation_validator.js +38 -15
  73. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts +7 -3
  74. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts.map +1 -1
  75. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.js +4 -5
  76. package/dest/msg_validators/proposal_validator/block_proposal_validator.d.ts +8 -3
  77. package/dest/msg_validators/proposal_validator/block_proposal_validator.d.ts.map +1 -1
  78. package/dest/msg_validators/proposal_validator/block_proposal_validator.js +2 -2
  79. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.d.ts +8 -3
  80. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.d.ts.map +1 -1
  81. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.js +8 -2
  82. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts +25 -3
  83. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts.map +1 -1
  84. package/dest/msg_validators/proposal_validator/proposal_validator.js +85 -15
  85. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts +1 -1
  86. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts.map +1 -1
  87. package/dest/msg_validators/tx_validator/aggregate_tx_validator.js +8 -15
  88. package/dest/msg_validators/tx_validator/allowed_public_setup.js +3 -3
  89. package/dest/msg_validators/tx_validator/archive_cache.js +1 -1
  90. package/dest/msg_validators/tx_validator/cached_tx_validator.d.ts +15 -0
  91. package/dest/msg_validators/tx_validator/cached_tx_validator.d.ts.map +1 -0
  92. package/dest/msg_validators/tx_validator/cached_tx_validator.js +19 -0
  93. package/dest/msg_validators/tx_validator/contract_instance_validator.d.ts +9 -0
  94. package/dest/msg_validators/tx_validator/contract_instance_validator.d.ts.map +1 -0
  95. package/dest/msg_validators/tx_validator/contract_instance_validator.js +48 -0
  96. package/dest/msg_validators/tx_validator/data_validator.d.ts +2 -1
  97. package/dest/msg_validators/tx_validator/data_validator.d.ts.map +1 -1
  98. package/dest/msg_validators/tx_validator/data_validator.js +36 -2
  99. package/dest/msg_validators/tx_validator/factory.d.ts +22 -15
  100. package/dest/msg_validators/tx_validator/factory.d.ts.map +1 -1
  101. package/dest/msg_validators/tx_validator/factory.js +51 -19
  102. package/dest/msg_validators/tx_validator/gas_validator.d.ts +47 -10
  103. package/dest/msg_validators/tx_validator/gas_validator.d.ts.map +1 -1
  104. package/dest/msg_validators/tx_validator/gas_validator.js +65 -48
  105. package/dest/msg_validators/tx_validator/index.d.ts +3 -1
  106. package/dest/msg_validators/tx_validator/index.d.ts.map +1 -1
  107. package/dest/msg_validators/tx_validator/index.js +2 -0
  108. package/dest/msg_validators/tx_validator/phases_validator.d.ts +21 -1
  109. package/dest/msg_validators/tx_validator/phases_validator.d.ts.map +1 -1
  110. package/dest/msg_validators/tx_validator/phases_validator.js +30 -3
  111. package/dest/msg_validators/tx_validator/tx_proof_validator.d.ts +2 -1
  112. package/dest/msg_validators/tx_validator/tx_proof_validator.d.ts.map +1 -1
  113. package/dest/msg_validators/tx_validator/tx_proof_validator.js +2 -0
  114. package/dest/msg_validators/tx_validator/tx_validation_cache.d.ts +48 -0
  115. package/dest/msg_validators/tx_validator/tx_validation_cache.d.ts.map +1 -0
  116. package/dest/msg_validators/tx_validator/tx_validation_cache.js +68 -0
  117. package/dest/services/data_store.d.ts +1 -1
  118. package/dest/services/data_store.d.ts.map +1 -1
  119. package/dest/services/data_store.js +5 -5
  120. package/dest/services/discv5/discV5_service.d.ts +13 -2
  121. package/dest/services/discv5/discV5_service.d.ts.map +1 -1
  122. package/dest/services/discv5/discV5_service.js +119 -23
  123. package/dest/services/discv5/persisted_enr_store.d.ts +38 -0
  124. package/dest/services/discv5/persisted_enr_store.d.ts.map +1 -0
  125. package/dest/services/discv5/persisted_enr_store.js +145 -0
  126. package/dest/services/dummy_service.d.ts +15 -15
  127. package/dest/services/dummy_service.d.ts.map +1 -1
  128. package/dest/services/dummy_service.js +15 -16
  129. package/dest/services/encoding.d.ts +23 -6
  130. package/dest/services/encoding.d.ts.map +1 -1
  131. package/dest/services/encoding.js +32 -16
  132. package/dest/services/gossipsub/topic_score_params.d.ts +6 -12
  133. package/dest/services/gossipsub/topic_score_params.d.ts.map +1 -1
  134. package/dest/services/gossipsub/topic_score_params.js +4 -14
  135. package/dest/services/libp2p/instrumentation.d.ts +3 -1
  136. package/dest/services/libp2p/instrumentation.d.ts.map +1 -1
  137. package/dest/services/libp2p/instrumentation.js +14 -0
  138. package/dest/services/libp2p/libp2p_service.d.ts +45 -47
  139. package/dest/services/libp2p/libp2p_service.d.ts.map +1 -1
  140. package/dest/services/libp2p/libp2p_service.js +392 -300
  141. package/dest/services/peer-manager/peer_manager.d.ts +20 -3
  142. package/dest/services/peer-manager/peer_manager.d.ts.map +1 -1
  143. package/dest/services/peer-manager/peer_manager.js +81 -25
  144. package/dest/services/peer-manager/peer_scoring.d.ts +34 -2
  145. package/dest/services/peer-manager/peer_scoring.d.ts.map +1 -1
  146. package/dest/services/peer-manager/peer_scoring.js +102 -13
  147. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts +4 -8
  148. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts.map +1 -1
  149. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.js +81 -86
  150. package/dest/services/reqresp/batch-tx-requester/interface.d.ts +10 -6
  151. package/dest/services/reqresp/batch-tx-requester/interface.d.ts.map +1 -1
  152. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts +5 -4
  153. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts.map +1 -1
  154. package/dest/services/reqresp/batch-tx-requester/missing_txs.js +13 -7
  155. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts +3 -1
  156. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts.map +1 -1
  157. package/dest/services/reqresp/batch-tx-requester/peer_collection.js +3 -0
  158. package/dest/services/reqresp/batch-tx-requester/tx_validator.d.ts +5 -14
  159. package/dest/services/reqresp/batch-tx-requester/tx_validator.d.ts.map +1 -1
  160. package/dest/services/reqresp/batch-tx-requester/tx_validator.js +6 -20
  161. package/dest/services/reqresp/config.d.ts +15 -3
  162. package/dest/services/reqresp/config.d.ts.map +1 -1
  163. package/dest/services/reqresp/config.js +11 -0
  164. package/dest/services/reqresp/interface.d.ts +16 -18
  165. package/dest/services/reqresp/interface.d.ts.map +1 -1
  166. package/dest/services/reqresp/interface.js +10 -20
  167. package/dest/services/reqresp/metrics.d.ts +1 -1
  168. package/dest/services/reqresp/metrics.d.ts.map +1 -1
  169. package/dest/services/reqresp/metrics.js +0 -1
  170. package/dest/services/reqresp/protocols/block_txs/bitvector.d.ts +4 -3
  171. package/dest/services/reqresp/protocols/block_txs/bitvector.d.ts.map +1 -1
  172. package/dest/services/reqresp/protocols/block_txs/bitvector.js +3 -2
  173. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts +1 -1
  174. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts.map +1 -1
  175. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.js +31 -28
  176. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts +12 -7
  177. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts.map +1 -1
  178. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.js +42 -24
  179. package/dest/services/reqresp/protocols/index.d.ts +1 -2
  180. package/dest/services/reqresp/protocols/index.d.ts.map +1 -1
  181. package/dest/services/reqresp/protocols/index.js +0 -1
  182. package/dest/services/reqresp/protocols/tx.d.ts +1 -1
  183. package/dest/services/reqresp/protocols/tx.d.ts.map +1 -1
  184. package/dest/services/reqresp/protocols/tx.js +1 -3
  185. package/dest/services/reqresp/rate-limiter/rate_limiter.d.ts +5 -4
  186. package/dest/services/reqresp/rate-limiter/rate_limiter.d.ts.map +1 -1
  187. package/dest/services/reqresp/rate-limiter/rate_limiter.js +10 -8
  188. package/dest/services/reqresp/rate-limiter/rate_limits.d.ts +1 -1
  189. package/dest/services/reqresp/rate-limiter/rate_limits.d.ts.map +1 -1
  190. package/dest/services/reqresp/rate-limiter/rate_limits.js +3 -13
  191. package/dest/services/reqresp/reqresp.d.ts +7 -29
  192. package/dest/services/reqresp/reqresp.d.ts.map +1 -1
  193. package/dest/services/reqresp/reqresp.js +73 -215
  194. package/dest/services/service.d.ts +25 -12
  195. package/dest/services/service.d.ts.map +1 -1
  196. package/dest/services/tx_collection/config.d.ts +2 -23
  197. package/dest/services/tx_collection/config.d.ts.map +1 -1
  198. package/dest/services/tx_collection/config.js +2 -55
  199. package/dest/services/tx_collection/file_store_tx_collection.d.ts +12 -28
  200. package/dest/services/tx_collection/file_store_tx_collection.d.ts.map +1 -1
  201. package/dest/services/tx_collection/file_store_tx_collection.js +43 -83
  202. package/dest/services/tx_collection/file_store_tx_source.d.ts +5 -4
  203. package/dest/services/tx_collection/file_store_tx_source.d.ts.map +1 -1
  204. package/dest/services/tx_collection/file_store_tx_source.js +39 -29
  205. package/dest/services/tx_collection/index.d.ts +2 -3
  206. package/dest/services/tx_collection/index.d.ts.map +1 -1
  207. package/dest/services/tx_collection/index.js +0 -1
  208. package/dest/services/tx_collection/instrumentation.d.ts +1 -1
  209. package/dest/services/tx_collection/instrumentation.d.ts.map +1 -1
  210. package/dest/services/tx_collection/instrumentation.js +0 -2
  211. package/dest/services/tx_collection/request_tracker.d.ts +53 -0
  212. package/dest/services/tx_collection/request_tracker.d.ts.map +1 -0
  213. package/dest/services/tx_collection/request_tracker.js +84 -0
  214. package/dest/services/tx_collection/tx_collection.d.ts +36 -55
  215. package/dest/services/tx_collection/tx_collection.d.ts.map +1 -1
  216. package/dest/services/tx_collection/tx_collection.js +275 -119
  217. package/dest/services/tx_collection/tx_collection_sink.d.ts +1 -1
  218. package/dest/services/tx_collection/tx_collection_sink.js +2 -2
  219. package/dest/services/tx_collection/tx_source.d.ts +6 -5
  220. package/dest/services/tx_collection/tx_source.d.ts.map +1 -1
  221. package/dest/services/tx_collection/tx_source.js +13 -8
  222. package/dest/services/tx_file_store/tx_file_store.d.ts +1 -3
  223. package/dest/services/tx_file_store/tx_file_store.d.ts.map +1 -1
  224. package/dest/services/tx_file_store/tx_file_store.js +4 -14
  225. package/dest/services/tx_provider.d.ts +3 -1
  226. package/dest/services/tx_provider.d.ts.map +1 -1
  227. package/dest/services/tx_provider.js +3 -0
  228. package/dest/test-helpers/make-test-p2p-clients.d.ts +1 -1
  229. package/dest/test-helpers/make-test-p2p-clients.d.ts.map +1 -1
  230. package/dest/test-helpers/make-test-p2p-clients.js +5 -2
  231. package/dest/test-helpers/mock-pubsub.d.ts +23 -9
  232. package/dest/test-helpers/mock-pubsub.d.ts.map +1 -1
  233. package/dest/test-helpers/mock-pubsub.js +44 -44
  234. package/dest/test-helpers/reqresp-nodes.d.ts +4 -5
  235. package/dest/test-helpers/reqresp-nodes.d.ts.map +1 -1
  236. package/dest/test-helpers/reqresp-nodes.js +16 -18
  237. package/dest/test-helpers/test_tx_provider.d.ts +3 -1
  238. package/dest/test-helpers/test_tx_provider.d.ts.map +1 -1
  239. package/dest/test-helpers/test_tx_provider.js +3 -0
  240. package/dest/test-helpers/testbench-utils.d.ts +15 -14
  241. package/dest/test-helpers/testbench-utils.d.ts.map +1 -1
  242. package/dest/test-helpers/testbench-utils.js +47 -14
  243. package/dest/testbench/p2p_client_testbench_worker.d.ts +3 -5
  244. package/dest/testbench/p2p_client_testbench_worker.d.ts.map +1 -1
  245. package/dest/testbench/p2p_client_testbench_worker.js +102 -40
  246. package/dest/testbench/worker_client_manager.d.ts +10 -6
  247. package/dest/testbench/worker_client_manager.d.ts.map +1 -1
  248. package/dest/testbench/worker_client_manager.js +51 -9
  249. package/dest/util.d.ts +11 -6
  250. package/dest/util.d.ts.map +1 -1
  251. package/dest/util.js +35 -14
  252. package/dest/versioning.d.ts +3 -6
  253. package/dest/versioning.d.ts.map +1 -1
  254. package/dest/versioning.js +3 -24
  255. package/package.json +16 -16
  256. package/src/bootstrap/bootstrap.ts +17 -3
  257. package/src/client/factory.ts +57 -11
  258. package/src/client/interface.ts +44 -17
  259. package/src/client/p2p_client.ts +138 -83
  260. package/src/client/test/{tx_proposal_collector/README.md → p2p_client.batch_tx_requester.bench.README.md} +23 -53
  261. package/src/config.ts +160 -31
  262. package/src/errors/p2p-service.error.ts +11 -0
  263. package/src/errors/reqresp.error.ts +13 -19
  264. package/src/index.ts +0 -1
  265. package/src/mem_pools/attestation_pool/attestation_pool.ts +327 -242
  266. package/src/mem_pools/attestation_pool/attestation_pool_test_suite.ts +244 -69
  267. package/src/mem_pools/attestation_pool/mocks.ts +13 -8
  268. package/src/mem_pools/index.ts +0 -3
  269. package/src/mem_pools/instrumentation.ts +18 -12
  270. package/src/mem_pools/tx_pool_v2/archive/tx_archive.ts +1 -9
  271. package/src/mem_pools/tx_pool_v2/deleted_pool.ts +7 -7
  272. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.ts +3 -2
  273. package/src/mem_pools/tx_pool_v2/eviction/index.ts +1 -0
  274. package/src/mem_pools/tx_pool_v2/eviction/insufficient_fee_per_gas_eviction_rule.ts +65 -0
  275. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.ts +3 -3
  276. package/src/mem_pools/tx_pool_v2/interfaces.ts +37 -8
  277. package/src/mem_pools/tx_pool_v2/tx_metadata.ts +31 -9
  278. package/src/mem_pools/tx_pool_v2/tx_pool_indices.ts +35 -0
  279. package/src/mem_pools/tx_pool_v2/tx_pool_v2.ts +35 -9
  280. package/src/mem_pools/tx_pool_v2/tx_pool_v2_impl.ts +243 -125
  281. package/src/msg_validators/attestation_validator/README.md +49 -0
  282. package/src/msg_validators/attestation_validator/attestation_validator.ts +46 -14
  283. package/src/msg_validators/attestation_validator/fisherman_attestation_validator.ts +15 -7
  284. package/src/msg_validators/proposal_validator/README.md +123 -0
  285. package/src/msg_validators/proposal_validator/block_proposal_validator.ts +15 -3
  286. package/src/msg_validators/proposal_validator/checkpoint_proposal_validator.ts +26 -3
  287. package/src/msg_validators/proposal_validator/proposal_validator.ts +95 -12
  288. package/src/msg_validators/tx_validator/README.md +17 -3
  289. package/src/msg_validators/tx_validator/aggregate_tx_validator.ts +3 -12
  290. package/src/msg_validators/tx_validator/allowed_public_setup.ts +3 -3
  291. package/src/msg_validators/tx_validator/archive_cache.ts +1 -1
  292. package/src/msg_validators/tx_validator/cached_tx_validator.ts +31 -0
  293. package/src/msg_validators/tx_validator/contract_instance_validator.ts +56 -0
  294. package/src/msg_validators/tx_validator/data_validator.ts +44 -1
  295. package/src/msg_validators/tx_validator/factory.ts +65 -21
  296. package/src/msg_validators/tx_validator/gas_validator.ts +99 -54
  297. package/src/msg_validators/tx_validator/index.ts +2 -0
  298. package/src/msg_validators/tx_validator/phases_validator.ts +33 -3
  299. package/src/msg_validators/tx_validator/tx_proof_validator.ts +2 -0
  300. package/src/msg_validators/tx_validator/tx_validation_cache.ts +101 -0
  301. package/src/services/data_store.ts +5 -13
  302. package/src/services/discv5/discV5_service.ts +126 -14
  303. package/src/services/discv5/persisted_enr_store.ts +158 -0
  304. package/src/services/dummy_service.ts +20 -39
  305. package/src/services/encoding.ts +35 -19
  306. package/src/services/gossipsub/README.md +33 -11
  307. package/src/services/gossipsub/topic_score_params.ts +9 -18
  308. package/src/services/libp2p/instrumentation.ts +14 -0
  309. package/src/services/libp2p/libp2p_service.ts +444 -339
  310. package/src/services/peer-manager/peer_manager.ts +89 -24
  311. package/src/services/peer-manager/peer_scoring.ts +102 -8
  312. package/src/services/reqresp/README.md +194 -0
  313. package/src/services/reqresp/batch-tx-requester/README.md +46 -7
  314. package/src/services/reqresp/batch-tx-requester/batch_tx_requester.ts +77 -95
  315. package/src/services/reqresp/batch-tx-requester/interface.ts +13 -5
  316. package/src/services/reqresp/batch-tx-requester/missing_txs.ts +13 -6
  317. package/src/services/reqresp/batch-tx-requester/peer_collection.ts +5 -0
  318. package/src/services/reqresp/batch-tx-requester/tx_validator.ts +12 -25
  319. package/src/services/reqresp/config.ts +19 -2
  320. package/src/services/reqresp/interface.ts +21 -47
  321. package/src/services/reqresp/metrics.ts +0 -1
  322. package/src/services/reqresp/protocols/block_txs/bitvector.ts +3 -2
  323. package/src/services/reqresp/protocols/block_txs/block_txs_handler.ts +34 -30
  324. package/src/services/reqresp/protocols/block_txs/block_txs_reqresp.ts +47 -20
  325. package/src/services/reqresp/protocols/index.ts +0 -1
  326. package/src/services/reqresp/protocols/tx.ts +1 -3
  327. package/src/services/reqresp/rate-limiter/rate_limiter.ts +13 -9
  328. package/src/services/reqresp/rate-limiter/rate_limits.ts +3 -13
  329. package/src/services/reqresp/reqresp.ts +84 -259
  330. package/src/services/service.ts +31 -28
  331. package/src/services/tx_collection/config.ts +3 -80
  332. package/src/services/tx_collection/file_store_tx_collection.ts +54 -103
  333. package/src/services/tx_collection/file_store_tx_source.ts +43 -31
  334. package/src/services/tx_collection/index.ts +1 -6
  335. package/src/services/tx_collection/instrumentation.ts +1 -7
  336. package/src/services/tx_collection/request_tracker.ts +127 -0
  337. package/src/services/tx_collection/tx_collection.ts +331 -176
  338. package/src/services/tx_collection/tx_collection_sink.ts +2 -2
  339. package/src/services/tx_collection/tx_source.ts +10 -8
  340. package/src/services/tx_file_store/tx_file_store.ts +5 -17
  341. package/src/services/tx_provider.ts +5 -0
  342. package/src/test-helpers/make-test-p2p-clients.ts +3 -0
  343. package/src/test-helpers/mock-pubsub.ts +46 -60
  344. package/src/test-helpers/reqresp-nodes.ts +12 -22
  345. package/src/test-helpers/test_tx_provider.ts +5 -0
  346. package/src/test-helpers/testbench-utils.ts +62 -28
  347. package/src/testbench/p2p_client_testbench_worker.ts +109 -56
  348. package/src/testbench/worker_client_manager.ts +59 -20
  349. package/src/util.ts +32 -17
  350. package/src/versioning.ts +3 -33
  351. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker.d.ts +0 -2
  352. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker.d.ts.map +0 -1
  353. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker.js +0 -304
  354. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.d.ts +0 -73
  355. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.d.ts.map +0 -1
  356. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.js +0 -8
  357. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.d.ts +0 -125
  358. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.d.ts.map +0 -1
  359. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.js +0 -596
  360. package/dest/mem_pools/tx_pool/eviction/eviction_manager.d.ts +0 -32
  361. package/dest/mem_pools/tx_pool/eviction/eviction_manager.d.ts.map +0 -1
  362. package/dest/mem_pools/tx_pool/eviction/eviction_manager.js +0 -112
  363. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.d.ts +0 -157
  364. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.d.ts.map +0 -1
  365. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.js +0 -52
  366. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.d.ts +0 -16
  367. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.d.ts.map +0 -1
  368. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.js +0 -122
  369. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.d.ts +0 -17
  370. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.d.ts.map +0 -1
  371. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.js +0 -84
  372. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.d.ts +0 -19
  373. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.d.ts.map +0 -1
  374. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.js +0 -78
  375. package/dest/mem_pools/tx_pool/eviction/low_priority_eviction_rule.d.ts +0 -26
  376. package/dest/mem_pools/tx_pool/eviction/low_priority_eviction_rule.d.ts.map +0 -1
  377. package/dest/mem_pools/tx_pool/eviction/low_priority_eviction_rule.js +0 -84
  378. package/dest/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.d.ts +0 -25
  379. package/dest/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.d.ts.map +0 -1
  380. package/dest/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.js +0 -57
  381. package/dest/mem_pools/tx_pool/index.d.ts +0 -3
  382. package/dest/mem_pools/tx_pool/index.d.ts.map +0 -1
  383. package/dest/mem_pools/tx_pool/index.js +0 -2
  384. package/dest/mem_pools/tx_pool/priority.d.ts +0 -12
  385. package/dest/mem_pools/tx_pool/priority.d.ts.map +0 -1
  386. package/dest/mem_pools/tx_pool/priority.js +0 -16
  387. package/dest/mem_pools/tx_pool/tx_pool.d.ts +0 -127
  388. package/dest/mem_pools/tx_pool/tx_pool.d.ts.map +0 -1
  389. package/dest/mem_pools/tx_pool/tx_pool.js +0 -3
  390. package/dest/mem_pools/tx_pool/tx_pool_test_suite.d.ts +0 -7
  391. package/dest/mem_pools/tx_pool/tx_pool_test_suite.d.ts.map +0 -1
  392. package/dest/mem_pools/tx_pool/tx_pool_test_suite.js +0 -402
  393. package/dest/msg_validators/clock_tolerance.d.ts +0 -21
  394. package/dest/msg_validators/clock_tolerance.d.ts.map +0 -1
  395. package/dest/msg_validators/clock_tolerance.js +0 -37
  396. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.d.ts +0 -64
  397. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.d.ts.map +0 -1
  398. package/dest/services/reqresp/connection-sampler/batch_connection_sampler.js +0 -151
  399. package/dest/services/reqresp/protocols/block.d.ts +0 -9
  400. package/dest/services/reqresp/protocols/block.d.ts.map +0 -1
  401. package/dest/services/reqresp/protocols/block.js +0 -32
  402. package/dest/services/tx_collection/fast_tx_collection.d.ts +0 -54
  403. package/dest/services/tx_collection/fast_tx_collection.d.ts.map +0 -1
  404. package/dest/services/tx_collection/fast_tx_collection.js +0 -327
  405. package/dest/services/tx_collection/missing_txs_tracker.d.ts +0 -32
  406. package/dest/services/tx_collection/missing_txs_tracker.d.ts.map +0 -1
  407. package/dest/services/tx_collection/missing_txs_tracker.js +0 -27
  408. package/dest/services/tx_collection/proposal_tx_collector.d.ts +0 -49
  409. package/dest/services/tx_collection/proposal_tx_collector.d.ts.map +0 -1
  410. package/dest/services/tx_collection/proposal_tx_collector.js +0 -50
  411. package/dest/services/tx_collection/slow_tx_collection.d.ts +0 -57
  412. package/dest/services/tx_collection/slow_tx_collection.d.ts.map +0 -1
  413. package/dest/services/tx_collection/slow_tx_collection.js +0 -211
  414. package/src/client/test/tx_proposal_collector/proposal_tx_collector_worker.ts +0 -345
  415. package/src/client/test/tx_proposal_collector/proposal_tx_collector_worker_protocol.ts +0 -43
  416. package/src/mem_pools/tx_pool/README.md +0 -270
  417. package/src/mem_pools/tx_pool/aztec_kv_tx_pool.ts +0 -746
  418. package/src/mem_pools/tx_pool/eviction/eviction_manager.ts +0 -132
  419. package/src/mem_pools/tx_pool/eviction/eviction_strategy.ts +0 -208
  420. package/src/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.ts +0 -162
  421. package/src/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.ts +0 -104
  422. package/src/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.ts +0 -93
  423. package/src/mem_pools/tx_pool/eviction/low_priority_eviction_rule.ts +0 -106
  424. package/src/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.ts +0 -75
  425. package/src/mem_pools/tx_pool/index.ts +0 -2
  426. package/src/mem_pools/tx_pool/priority.ts +0 -23
  427. package/src/mem_pools/tx_pool/tx_pool.ts +0 -141
  428. package/src/mem_pools/tx_pool/tx_pool_test_suite.ts +0 -321
  429. package/src/msg_validators/clock_tolerance.ts +0 -51
  430. package/src/services/reqresp/connection-sampler/batch_connection_sampler.ts +0 -161
  431. package/src/services/reqresp/protocols/block.ts +0 -37
  432. package/src/services/tx_collection/fast_tx_collection.ts +0 -387
  433. package/src/services/tx_collection/missing_txs_tracker.ts +0 -52
  434. package/src/services/tx_collection/proposal_tx_collector.ts +0 -113
  435. package/src/services/tx_collection/slow_tx_collection.ts +0 -266
@@ -1,6 +1,6 @@
1
- # ProposalTxCollector Benchmarks
1
+ # BatchTxRequester Benchmarks
2
2
 
3
- This benchmark suite measures **how quickly a proposer node can fetch missing transactions from P2P peers** when building a block proposal. It compares two alternative transaction-collection implementations under several controlled "who-has-which-txs" distributions.
3
+ This benchmark suite measures **how quickly a proposer node can fetch missing transactions from P2P peers** when building a block proposal under several controlled "who-has-which-txs" distributions.
4
4
 
5
5
  ## Purpose
6
6
 
@@ -10,12 +10,6 @@ This benchmark answers:
10
10
 
11
11
  - How long does it take to fetch **N missing txs** (N ∈ **{10, 50, 100, 500}**)?
12
12
  - How do different **peer availability patterns** affect performance?
13
- - Which collector strategy performs better under each pattern?
14
-
15
- The suite compares two collectors:
16
-
17
- - **`BatchTxRequesterCollector`** (collector type: `batch-requester`)
18
- - **`SendBatchRequestCollector`** (collector type: `send-batch-request`)
19
13
 
20
14
  ## Architecture
21
15
 
@@ -24,7 +18,7 @@ The benchmark runs a small simulated network on localhost:
24
18
  ```
25
19
  ┌─────────────────────────────────────────────────────────────────────┐
26
20
  │ Test Process (Driver) │
27
- │ p2p_client.proposal_tx_collector.bench.test.ts │
21
+ │ p2p_client.batch_tx_requester.bench.test.ts │
28
22
  │ ┌─────────────────────────────────────────────────────────────┐ │
29
23
  │ │ WorkerClientManager │ │
30
24
  │ │ (src/testbench/worker_client_manager.ts) │ │
@@ -34,7 +28,7 @@ The benchmark runs a small simulated network on localhost:
34
28
  │ ▼ ▼ ▼ │
35
29
  │ ┌───────────┐ ┌───────────┐ ┌───────────┐ │
36
30
  │ │ Worker 0 │◄──────►│ Worker 1 │◄──────►│ Worker N-1│ │
37
- │ │ (Collector│ P2P │(Responder)│ P2P │(Responder)│ │
31
+ │ │(Aggregator│ P2P │(Responder)│ P2P │(Responder)│ │
38
32
  │ │ Node) │ │ │ │ │ │
39
33
  │ │ TxPool:[] │ │ TxPool: │ │ TxPool: │ │
40
34
  │ │ │ │ [txs...] │ │ [txs...] │ │
@@ -54,12 +48,12 @@ Using separate OS processes makes the setup closer to real networking behavior (
54
48
 
55
49
  The network is intentionally asymmetric:
56
50
 
57
- - **Worker 0 is the collector/proposer node**
51
+ - **Worker 0 is the aggregator/proposer node**
58
52
  - Starts with an **empty tx pool** (`[]`)
59
- - Is the only worker instructed to run the collector for each `BENCH_REQRESP` command
53
+ - Is the only worker instructed to run `BatchTxRequester` for each `BENCH_REQRESP` command
60
54
  - **Workers 1..N-1 are responder peers**
61
55
  - Locally generate and filter txs according to the distribution pattern
62
- - Respond to req/resp queries made by Worker 0's collector
56
+ - Respond to req/resp queries made by Worker 0's `BatchTxRequester`
63
57
 
64
58
  This models a proposer that has only `txHashes` in a proposal and must fetch the full tx bodies from the network.
65
59
 
@@ -72,7 +66,7 @@ Each benchmark case generates `missingTxCount` mock txs and assigns them to peer
72
66
  **Every responder peer has every transaction.**
73
67
 
74
68
  - Simulates the best-case: high replication / high gossip success
75
- - Expectation: collector should quickly succeed; differences mostly reflect collector overhead and batching strategy
69
+ - Expectation: the requester should quickly succeed; differences mostly reflect requester overhead and batching strategy
76
70
 
77
71
  ### `sparse`
78
72
 
@@ -81,7 +75,7 @@ Each benchmark case generates `missingTxCount` mock txs and assigns them to peer
81
75
  Each responder is bucketed and holds txs whose index falls into its bucket or the "next" bucket (striped by tx index).
82
76
 
83
77
  - Simulates partial propagation, churn, or uneven mempool convergence
84
- - Expectation: collector must query multiple peers and cope with "misses"
78
+ - Expectation: the requester must query multiple peers and cope with "misses"
85
79
 
86
80
  ### `pinned-only`
87
81
 
@@ -92,33 +86,13 @@ Each responder is bucketed and holds txs whose index falls into its bucket or th
92
86
 
93
87
  > **Guardrail:** the pinned peer index must be within `(0, numberOfPeers)` (Worker 0 cannot be pinned).
94
88
 
95
- ## Collectors Under Test
96
-
97
- ### `BatchTxRequesterCollector` (`batch-requester`)
98
-
99
- ```typescript
100
- new BatchTxRequesterCollector(p2pService, logger, new DateProvider())
101
- ```
102
-
103
- Uses the P2P service plus internal logic to fetch missing txs, coordinating requests in a batched or staged way.
104
-
105
- ### `SendBatchRequestCollector` (`send-batch-request`)
106
-
107
- ```typescript
108
- const maxPeers = 10;
109
- const maxRetryAttempts = Math.max(peerIds.length, 3);
110
- new SendBatchRequestCollector(p2pService, maxPeers, maxRetryAttempts)
111
- ```
112
-
113
- Explicitly caps the number of peers it will involve (`maxPeers`) and uses a retry budget derived from peer count.
114
-
115
89
  ## Test Parameters
116
90
 
117
91
  | Parameter | Value | Description |
118
92
  |-----------|-------|-------------|
119
93
  | `PEERS_PER_RUN` | 30 | Number of worker processes spawned |
120
94
  | `MISSING_TX_COUNTS` | 10, 50, 100, 500 | Number of missing transactions to fetch |
121
- | `TIMEOUT_MS` | 30,000 ms | Collector timeout per case |
95
+ | `TIMEOUT_MS` | 30,000 ms | Per-case timeout for the requester |
122
96
  | `TEST_TIMEOUT_MS` | 600,000 ms | Overall Jest timeout (10 minutes) |
123
97
 
124
98
  ## Running
@@ -127,13 +101,13 @@ From the p2p package:
127
101
 
128
102
  ```bash
129
103
  cd yarn-project/p2p
130
- yarn test src/client/test/tx_proposal_collector/p2p_client.proposal_tx_collector.bench.test.ts
104
+ yarn test src/client/test/p2p_client.batch_tx_requester.bench.test.ts
131
105
  ```
132
106
 
133
107
  Or from repo root:
134
108
 
135
109
  ```bash
136
- yarn test p2p_client.proposal_tx_collector.bench.test.ts
110
+ yarn test p2p_client.batch_tx_requester.bench.test.ts
137
111
  ```
138
112
 
139
113
  The benchmark is intentionally long due to spawning many processes and running multiple cases.
@@ -145,14 +119,12 @@ The benchmark is intentionally long due to spawning many processes and running m
145
119
  If no env vars are set, the suite prints a table:
146
120
 
147
121
  ```
148
- | Collector | Distribution | Missing | Duration (ms) | Fetched | Success |
149
- |---------------------|--------------|---------|---------------|---------|---------|
150
- | batch-requester | pinned-only | 10 | 123 | 10 | Yes |
151
- | send-batch-request | pinned-only | 10 | 145 | 10 | Yes |
122
+ | Distribution | Missing | Duration (ms) | Fetched | Success |
123
+ |--------------|---------|---------------|---------|---------|
124
+ | pinned-only | 10 | 123 | 10 | Yes |
125
+ | pinned-only | 50 | 145 | 50 | Yes |
152
126
  ```
153
127
 
154
- Plus a comparison summary stating which collector was faster per `(distribution, missing)` pair.
155
-
156
128
  ### JSON metrics (for CI/dashboards)
157
129
 
158
130
  ```bash
@@ -160,8 +132,8 @@ BENCH_OUTPUT=/path/results.json yarn test ...
160
132
  ```
161
133
 
162
134
  Writes JSON metrics like:
163
- - `ProposalTxCollector/<collector>/<distribution>/missing_<N>/duration` (ms)
164
- - `ProposalTxCollector/<collector>/<distribution>/missing_<N>/fetched` (txs)
135
+ - `BatchTxRequester/<distribution>/missing_<N>/duration` (ms)
136
+ - `BatchTxRequester/<distribution>/missing_<N>/fetched` (txs)
165
137
 
166
138
  ### Markdown file output
167
139
 
@@ -175,14 +147,14 @@ Writes the pretty table + summary to disk.
175
147
 
176
148
  For each case the benchmark records:
177
149
 
178
- - `durationMs`: wall-clock time spent inside the collector call
179
- - `fetchedCount`: how many txs were returned by the collector
150
+ - `durationMs`: wall-clock time spent inside the requester call
151
+ - `fetchedCount`: how many txs were returned by the requester
180
152
  - `success`: `fetchedCount === missingTxCount`
181
153
 
182
154
  **Guidelines:**
183
155
 
184
156
  - **Always check `Success` first.** A faster run that fetched fewer txs is not a win.
185
- - Compare collectors **within the same distribution + missing count** only.
157
+ - Compare runs **within the same distribution + missing count** only.
186
158
  - Expect `pinned-only` to highlight pinned-peer behavior (fast if pinned peer is used effectively; slow if the algorithm wastes time sampling other peers).
187
159
  - Expect `sparse` to be the most "network-like" stress case, since many peers won't have each requested tx.
188
160
 
@@ -193,7 +165,7 @@ Inside each worker, the benchmark intentionally reduces variability:
193
165
  - **Unlimited rate limits** are installed so the req/resp rate limiter doesn't dominate results
194
166
  - **Deterministic tx generation** ensures all workers see the same tx set without large IPC payloads
195
167
 
196
- This makes the benchmark better for *comparing collectors* (A vs B), but it is **not** a perfect model of production networking conditions.
168
+ This makes the benchmark better for tracking regressions, but it is **not** a perfect model of production networking conditions.
197
169
 
198
170
  ## Limitations
199
171
 
@@ -207,9 +179,7 @@ This benchmark does **not** measure:
207
179
 
208
180
  | File | Purpose |
209
181
  |------|---------|
210
- | `p2p_client.proposal_tx_collector.bench.test.ts` | Test suite (cases, distributions, output formatting) |
211
- | `proposal_tx_collector_worker.ts` | Collector-specific worker implementation |
212
- | `proposal_tx_collector_worker_protocol.ts` | IPC message types and serialization |
182
+ | `p2p_client.batch_tx_requester.bench.test.ts` | Test suite (cases, distributions, output formatting) |
213
183
  | `src/testbench/worker_client_manager.ts` | Worker process manager (forking, IPC, orchestration) |
214
184
  | `src/testbench/p2p_client_testbench_worker.ts` | General testbench worker implementation |
215
185
  | `src/test-helpers/testbench-utils.ts` | Shared mocks and utilities (InMemoryTxPool, InMemoryAttestationPool, etc.) |
package/src/config.ts CHANGED
@@ -3,9 +3,11 @@ import {
3
3
  SecretValue,
4
4
  bigintConfigHelper,
5
5
  booleanConfigHelper,
6
+ floatConfigHelper,
6
7
  getConfigFromMappings,
7
8
  getDefaultConfig,
8
9
  numberConfigHelper,
10
+ optionalNumberConfigHelper,
9
11
  percentageConfigHelper,
10
12
  pickConfigMappings,
11
13
  secretStringConfigHelper,
@@ -39,15 +41,21 @@ export interface P2PConfig
39
41
  ChainConfig,
40
42
  TxCollectionConfig,
41
43
  TxFileStoreConfig,
42
- Pick<SequencerConfig, 'blockDurationMs' | 'expectedBlockProposalsPerSlot' | 'maxTxsPerBlock'> {
44
+ Pick<
45
+ SequencerConfig,
46
+ | 'expectedBlockProposalsPerSlot'
47
+ | 'maxTxsPerBlock'
48
+ | 'checkpointProposalSyncGraceSeconds'
49
+ | 'maxBlocksPerCheckpoint'
50
+ >,
51
+ // `blockDurationMs` is optional on the loose `SequencerConfig` but is always populated for p2p via
52
+ // the shared `numberConfigHelper(3000)` mapping, so it is required here.
53
+ Required<Pick<SequencerConfig, 'blockDurationMs'>> {
43
54
  /** Maximum transactions per block for validation. Overrides maxTxsPerBlock for gossip validation when set. */
44
55
  validateMaxTxsPerBlock?: number;
45
56
 
46
- /** Maximum L2 gas per block for validation. When set, txs exceeding this limit are rejected. */
47
- validateMaxL2BlockGas?: number;
48
-
49
- /** Maximum DA gas per block for validation. When set, txs exceeding this limit are rejected. */
50
- validateMaxDABlockGas?: number;
57
+ /** Maximum transactions per checkpoint for validation. Used as fallback for maxTxsPerBlock when that is not set. */
58
+ validateMaxTxsPerCheckpoint?: number;
51
59
 
52
60
  /** A flag dictating whether the P2P subsystem should be enabled. */
53
61
  p2pEnabled: boolean;
@@ -55,9 +63,6 @@ export interface P2PConfig
55
63
  /** The frequency in which to check for new L2 blocks. */
56
64
  blockCheckIntervalMS: number;
57
65
 
58
- /** The frequency in which to check for new L2 slots. */
59
- slotCheckIntervalMS: number;
60
-
61
66
  /** The number of blocks to fetch in a single batch. */
62
67
  blockRequestBatchSize: number;
63
68
 
@@ -67,6 +72,9 @@ export interface P2PConfig
67
72
  /** The frequency in which to check for new peers. */
68
73
  peerCheckIntervalMS: number;
69
74
 
75
+ /** How long to ban a peer after it fails MAX_DIAL_ATTEMPTS dials. */
76
+ peerFailedBanTimeMs: number;
77
+
70
78
  /** Size of queue of L2 blocks to store. */
71
79
  l2QueueSize: number;
72
80
 
@@ -103,6 +111,11 @@ export interface P2PConfig
103
111
  /** If announceUdpAddress or announceTcpAddress are not provided, query for the IP address of the machine. Default is false. */
104
112
  queryForIp: boolean;
105
113
 
114
+ /**
115
+ * HTTPS URLs that return plain-text public IPv4, tried in order when resolving the announce IP (e.g. when `queryForIp` is true and `p2pIp` is unset).
116
+ */
117
+ publicIpServices: string[];
118
+
106
119
  /** The interval of the gossipsub heartbeat to perform maintenance tasks. */
107
120
  gossipsubInterval: number;
108
121
 
@@ -130,6 +143,13 @@ export interface P2PConfig
130
143
  /** How long to keep message IDs in the seen cache (ms). */
131
144
  gossipsubSeenTTL: number;
132
145
 
146
+ /**
147
+ * Maximum clock-disparity tolerance (ms) applied to proposal/attestation gossip receive windows. Both
148
+ * ends of each acceptance window are widened by this much so peers are not penalized for messages valid
149
+ * when sent but arriving slightly early or late due to clock skew (Ethereum's MAXIMUM_GOSSIP_CLOCK_DISPARITY).
150
+ */
151
+ maxGossipClockDisparityMs: number;
152
+
133
153
  /** The 'age' (in # of L2 blocks) of a processed tx after which we heavily penalize a peer for re-sending it. */
134
154
  doubleSpendSeverePeerPenaltyWindow: number;
135
155
 
@@ -145,6 +165,9 @@ export interface P2PConfig
145
165
  /** The values for the peer scoring system. Passed as a comma separated list of values in order: low, mid, high tolerance errors. */
146
166
  peerPenaltyValues: number[];
147
167
 
168
+ /** How long (in seconds) a peer is banned for once its score drops below the ban threshold. */
169
+ peerBanDurationSeconds: number;
170
+
148
171
  /** Limit of transactions to archive in the tx pool. Once the archived tx limit is reached, the oldest archived txs will be purged. */
149
172
  archivedTxLimit: number;
150
173
 
@@ -169,6 +192,9 @@ export interface P2PConfig
169
192
  /** The node's seen message ID cache size */
170
193
  seenMessageCacheSize: number;
171
194
 
195
+ /** Maximum number of (validator, tx) pairs to keep in the tx validation LRU cache. */
196
+ txValidationCacheSize: number;
197
+
172
198
  /** True to disable the status handshake on peer connected. */
173
199
  p2pDisableStatusHandshake?: boolean;
174
200
 
@@ -201,28 +227,65 @@ export interface P2PConfig
201
227
  /** Minimum age (ms) a transaction must have been in the pool before it's eligible for block building. */
202
228
  minTxPoolAgeMs: number;
203
229
 
230
+ /**
231
+ * Number of full L2 slots to wait after a checkpoint's slot before declaring its txs missing
232
+ * for data-withholding slashing.
233
+ */
234
+ slashDataWithholdingToleranceSlots: number;
235
+
236
+ /**
237
+ * Number of L2 slots after a mined block's slot to keep collecting its missing txs. Clamped
238
+ * up so that collection always runs at least until the data-withholding slash verdict is
239
+ * rendered (`block.slot + slashDataWithholdingToleranceSlots + 1`). Defaults to undefined,
240
+ * in which case the tolerance window is used directly.
241
+ */
242
+ p2pMissingTxCollectionDeadlineSlots?: number;
243
+
204
244
  /** Minimum percentage fee increase required to replace an existing tx via RPC (0 = no bump). */
205
245
  priceBumpPercentage: bigint;
246
+
247
+ /**
248
+ * Number of slots behind the finalized tip to keep finalized txs for before deleting them. 0 deletes
249
+ * at the finalized tip (default).
250
+ */
251
+ keepFinalizedTxsForSlots: number;
252
+
253
+ /** Drop incoming block and checkpoint proposals at the libp2p dispatch layer (for testing only) */
254
+ skipIncomingProposals?: boolean;
255
+
256
+ /** Accept proposal gossip regardless of slot timing (for testing only). */
257
+ skipProposalSlotValidation?: boolean;
258
+
259
+ /**
260
+ * Whether this node skips checkpoint proposal validation and always attests. When set, the checkpoint
261
+ * attestation is created and broadcast before the embedded last block is processed, so it is not delayed
262
+ * past the slot's attestation window by that block's re-execution. Mirrors the validator config flag.
263
+ */
264
+ skipCheckpointProposalValidation?: boolean;
206
265
  }
207
266
 
208
267
  export const DEFAULT_P2P_PORT = 40400;
209
268
 
269
+ /** Default endpoints used to discover this machine's public IPv4 when `queryForIp` is enabled. */
270
+ export const DEFAULT_PUBLIC_IP_SERVICES: string[] = [
271
+ 'https://api.ipify.org/',
272
+ 'https://checkip.amazonaws.com/',
273
+ 'https://ifconfig.me/ip',
274
+ 'https://icanhazip.com/',
275
+ ];
276
+
210
277
  export const p2pConfigMappings: ConfigMappingsType<P2PConfig> = {
211
278
  validateMaxTxsPerBlock: {
212
279
  env: 'VALIDATOR_MAX_TX_PER_BLOCK',
213
280
  description:
214
281
  'Maximum transactions per block for validation. Overrides maxTxsPerBlock for gossip validation when set.',
215
- parseEnv: (val: string) => (val ? parseInt(val, 10) : undefined),
216
- },
217
- validateMaxL2BlockGas: {
218
- env: 'VALIDATOR_MAX_L2_BLOCK_GAS',
219
- description: 'Maximum L2 gas per block for validation. When set, txs exceeding this limit are rejected.',
220
- parseEnv: (val: string) => (val ? parseInt(val, 10) : undefined),
282
+ ...optionalNumberConfigHelper(),
221
283
  },
222
- validateMaxDABlockGas: {
223
- env: 'VALIDATOR_MAX_DA_BLOCK_GAS',
224
- description: 'Maximum DA gas per block for validation. When set, txs exceeding this limit are rejected.',
225
- parseEnv: (val: string) => (val ? parseInt(val, 10) : undefined),
284
+ validateMaxTxsPerCheckpoint: {
285
+ env: 'VALIDATOR_MAX_TX_PER_CHECKPOINT',
286
+ description:
287
+ 'Maximum transactions per checkpoint for validation. Used as fallback for maxTxsPerBlock when that is not set.',
288
+ ...optionalNumberConfigHelper(),
226
289
  },
227
290
  p2pEnabled: {
228
291
  env: 'P2P_ENABLED',
@@ -239,11 +302,6 @@ export const p2pConfigMappings: ConfigMappingsType<P2PConfig> = {
239
302
  description: 'The frequency in which to check for new L2 blocks.',
240
303
  ...numberConfigHelper(100),
241
304
  },
242
- slotCheckIntervalMS: {
243
- env: 'P2P_SLOT_CHECK_INTERVAL_MS',
244
- description: 'The frequency in which to check for new L2 slots.',
245
- ...numberConfigHelper(1000),
246
- },
247
305
  debugDisableColocationPenalty: {
248
306
  env: 'DEBUG_P2P_DISABLE_COLOCATION_PENALTY',
249
307
  description: 'DEBUG: Disable colocation penalty - NEVER set to true in production',
@@ -254,6 +312,11 @@ export const p2pConfigMappings: ConfigMappingsType<P2PConfig> = {
254
312
  description: 'The frequency in which to check for new peers.',
255
313
  ...numberConfigHelper(30_000),
256
314
  },
315
+ peerFailedBanTimeMs: {
316
+ env: 'P2P_PEER_FAILED_BAN_TIME_MS',
317
+ description: 'How long to ban a peer after it fails maximum dial attempts.',
318
+ ...numberConfigHelper(5 * 60 * 1000),
319
+ },
257
320
  l2QueueSize: {
258
321
  env: 'P2P_L2_QUEUE_SIZE',
259
322
  description: 'Size of queue of L2 blocks to store.',
@@ -314,6 +377,17 @@ export const p2pConfigMappings: ConfigMappingsType<P2PConfig> = {
314
377
  'If announceUdpAddress or announceTcpAddress are not provided, query for the IP address of the machine. Default is false.',
315
378
  ...booleanConfigHelper(),
316
379
  },
380
+ publicIpServices: {
381
+ env: 'P2P_PUBLIC_IP_SERVICES',
382
+ parseEnv: (val: string) =>
383
+ val
384
+ .split(',')
385
+ .map(s => s.trim())
386
+ .filter(Boolean),
387
+ description:
388
+ 'Comma-separated HTTPS URLs that return plain-text public IPv4. Used when P2P_QUERY_FOR_IP is true and P2P_IP is unset. Tried in order until one succeeds.',
389
+ defaultValue: DEFAULT_PUBLIC_IP_SERVICES,
390
+ },
317
391
  gossipsubInterval: {
318
392
  env: 'P2P_GOSSIPSUB_INTERVAL_MS',
319
393
  description: 'The interval of the gossipsub heartbeat to perform maintenance tasks.',
@@ -347,7 +421,7 @@ export const p2pConfigMappings: ConfigMappingsType<P2PConfig> = {
347
421
  gossipsubMcacheLength: {
348
422
  env: 'P2P_GOSSIPSUB_MCACHE_LENGTH',
349
423
  description: 'The number of gossipsub interval message cache windows to keep.',
350
- ...numberConfigHelper(6),
424
+ ...numberConfigHelper(12),
351
425
  },
352
426
  gossipsubMcacheGossip: {
353
427
  env: 'P2P_GOSSIPSUB_MCACHE_GOSSIP',
@@ -359,20 +433,26 @@ export const p2pConfigMappings: ConfigMappingsType<P2PConfig> = {
359
433
  description: 'How long to keep message IDs in the seen cache.',
360
434
  ...numberConfigHelper(20 * 60 * 1000),
361
435
  },
436
+ maxGossipClockDisparityMs: {
437
+ env: 'P2P_MAX_GOSSIP_CLOCK_DISPARITY_MS',
438
+ description:
439
+ 'Maximum clock-disparity tolerance (ms) applied to both ends of proposal/attestation gossip receive windows.',
440
+ ...numberConfigHelper(500),
441
+ },
362
442
  gossipsubTxTopicWeight: {
363
443
  env: 'P2P_GOSSIPSUB_TX_TOPIC_WEIGHT',
364
444
  description: 'The weight of the tx topic for the gossipsub protocol.',
365
- ...numberConfigHelper(1),
445
+ ...floatConfigHelper(1),
366
446
  },
367
447
  gossipsubTxInvalidMessageDeliveriesWeight: {
368
448
  env: 'P2P_GOSSIPSUB_TX_INVALID_MESSAGE_DELIVERIES_WEIGHT',
369
449
  description: 'The weight of the tx invalid message deliveries for the gossipsub protocol.',
370
- ...numberConfigHelper(-20),
450
+ ...floatConfigHelper(-20),
371
451
  },
372
452
  gossipsubTxInvalidMessageDeliveriesDecay: {
373
453
  env: 'P2P_GOSSIPSUB_TX_INVALID_MESSAGE_DELIVERIES_DECAY',
374
454
  description: 'Determines how quickly the penalty for invalid message deliveries decays over time. Between 0 and 1.',
375
- ...numberConfigHelper(0.5),
455
+ ...floatConfigHelper(0.5),
376
456
  },
377
457
  peerPenaltyValues: {
378
458
  env: 'P2P_PEER_PENALTY_VALUES',
@@ -381,6 +461,11 @@ export const p2pConfigMappings: ConfigMappingsType<P2PConfig> = {
381
461
  'The values for the peer scoring system. Passed as a comma separated list of values in order: low, mid, high tolerance errors.',
382
462
  defaultValue: [2, 10, 50],
383
463
  },
464
+ peerBanDurationSeconds: {
465
+ env: 'P2P_PEER_BAN_DURATION_SECONDS',
466
+ description: 'How long (in seconds) a peer is banned for once its score drops below the ban threshold.',
467
+ ...numberConfigHelper(24 * 60 * 60),
468
+ },
384
469
  doubleSpendSeverePeerPenaltyWindow: {
385
470
  env: 'P2P_DOUBLE_SPEND_SEVERE_PEER_PENALTY_WINDOW',
386
471
  description: 'The "age" (in L2 blocks) of a tx after which we heavily penalize a peer for sending it.',
@@ -419,7 +504,7 @@ export const p2pConfigMappings: ConfigMappingsType<P2PConfig> = {
419
504
  },
420
505
  p2pStoreMapSizeKb: {
421
506
  env: 'P2P_STORE_MAP_SIZE_KB',
422
- parseEnv: (val: string | undefined) => (val ? +val : undefined),
507
+ ...optionalNumberConfigHelper(),
423
508
  description: 'The maximum possible size of the P2P DB in KB. Overwrites the general dataStoreMapSizeKb.',
424
509
  },
425
510
  txPublicSetupAllowListExtend: {
@@ -442,6 +527,11 @@ export const p2pConfigMappings: ConfigMappingsType<P2PConfig> = {
442
527
  description: 'The number of messages to keep in the seen message cache',
443
528
  ...numberConfigHelper(100_000), // 100K
444
529
  },
530
+ txValidationCacheSize: {
531
+ env: 'P2P_TX_VALIDATION_CACHE_SIZE',
532
+ description: 'Maximum number of items to keep in the tx validation LRU cache.',
533
+ ...numberConfigHelper(5_000),
534
+ },
445
535
  p2pDisableStatusHandshake: {
446
536
  env: 'P2P_DISABLE_STATUS_HANDSHAKE',
447
537
  description: 'True to disable the status handshake on peer connected.',
@@ -489,18 +579,55 @@ export const p2pConfigMappings: ConfigMappingsType<P2PConfig> = {
489
579
  'Broadcast block proposals even when a conflicting proposal for the same slot already exists in the pool (for testing purposes only).',
490
580
  ...booleanConfigHelper(false),
491
581
  },
582
+ skipIncomingProposals: {
583
+ description: 'Drop incoming block and checkpoint proposals at the libp2p dispatch layer (for testing only)',
584
+ ...booleanConfigHelper(false),
585
+ },
586
+ skipProposalSlotValidation: {
587
+ description: 'Accept proposal gossip regardless of slot timing (for testing only)',
588
+ ...booleanConfigHelper(false),
589
+ },
590
+ skipCheckpointProposalValidation: {
591
+ description:
592
+ 'Skip checkpoint proposal validation and always attest, broadcasting the attestation before processing the embedded last block',
593
+ ...booleanConfigHelper(false),
594
+ },
492
595
  minTxPoolAgeMs: {
493
596
  env: 'P2P_MIN_TX_POOL_AGE_MS',
494
597
  description: 'Minimum age (ms) a transaction must have been in the pool before it is eligible for block building.',
495
598
  ...numberConfigHelper(2_000),
496
599
  },
600
+ slashDataWithholdingToleranceSlots: {
601
+ env: 'SLASH_DATA_WITHHOLDING_TOLERANCE_SLOTS',
602
+ description:
603
+ 'L2 slots to wait after a checkpoint slot before declaring its txs missing. Drives both the data-withholding slasher check and the missing-tx collection deadline.',
604
+ ...numberConfigHelper(3),
605
+ },
606
+ p2pMissingTxCollectionDeadlineSlots: {
607
+ env: 'P2P_MISSING_TX_COLLECTION_DEADLINE_SLOTS',
608
+ description:
609
+ 'Optional deadline (in L2 slots after the block slot) for collecting missing txs for unproven mined blocks. Clamped up to the data-withholding tolerance window so collection never gives up before the slash verdict.',
610
+ ...optionalNumberConfigHelper(),
611
+ },
497
612
  priceBumpPercentage: {
498
613
  env: 'P2P_RPC_PRICE_BUMP_PERCENTAGE',
499
614
  description:
500
615
  'Minimum percentage fee increase required to replace an existing tx via RPC. Even at 0%, replacement still requires paying at least 1 unit more.',
501
616
  ...bigintConfigHelper(10n),
502
617
  },
503
- ...sharedSequencerConfigMappings,
618
+ keepFinalizedTxsForSlots: {
619
+ env: 'P2P_KEEP_FINALIZED_TXS_FOR_SLOTS',
620
+ description:
621
+ 'Number of slots behind the finalized tip to keep finalized txs for before deleting them. 0 deletes at the finalized tip.',
622
+ ...numberConfigHelper(0),
623
+ },
624
+ ...pickConfigMappings(sharedSequencerConfigMappings, [
625
+ 'expectedBlockProposalsPerSlot',
626
+ 'maxTxsPerBlock',
627
+ 'checkpointProposalSyncGraceSeconds',
628
+ 'maxBlocksPerCheckpoint',
629
+ 'blockDurationMs',
630
+ ]),
504
631
  ...p2pReqRespConfigMappings,
505
632
  ...batchTxRequesterConfigMappings,
506
633
  ...chainConfigMappings,
@@ -533,6 +660,7 @@ export type BootnodeConfig = Pick<
533
660
  | 'bootstrapNodes'
534
661
  | 'listenAddress'
535
662
  | 'queryForIp'
663
+ | 'publicIpServices'
536
664
  > &
537
665
  Required<Pick<P2PConfig, 'p2pIp' | 'p2pPort'>> &
538
666
  Pick<DataStoreConfig, 'dataDirectory' | 'dataStoreMapSizeKb'> &
@@ -550,6 +678,7 @@ const bootnodeConfigKeys: (keyof BootnodeConfig)[] = [
550
678
  'bootstrapNodes',
551
679
  'l1ChainId',
552
680
  'queryForIp',
681
+ 'publicIpServices',
553
682
  ];
554
683
 
555
684
  export const bootnodeConfigMappings = pickConfigMappings(
@@ -624,7 +753,7 @@ export function parseAllowList(value: string): AllowedElement[] {
624
753
 
625
754
  if (typeString === 'I') {
626
755
  entries.push({
627
- address: AztecAddress.fromString(identifierString),
756
+ address: AztecAddress.fromStringUnsafe(identifierString),
628
757
  selector,
629
758
  ...flags,
630
759
  });
@@ -0,0 +1,11 @@
1
+ /** Checkpoint Proposal Received Callback Not Registered Error
2
+ *
3
+ * Error triggered if the allNodesCheckpointReceivedCallback is not registered
4
+ * @category Errors
5
+ */
6
+ export class CheckpointProposalReceivedCallbackNotRegisteredError extends Error {
7
+ constructor() {
8
+ super('FATAL (allNodesCheckpointReceivedCallback): All nodes should register a checkpoint proposal handler');
9
+ this.name = 'CheckpointProposalReceivedCallbackNotRegisteredError';
10
+ }
11
+ }
@@ -9,27 +9,21 @@ export class IndividualReqRespTimeoutError extends Error {
9
9
  }
10
10
  }
11
11
 
12
- /** Collective request timeout error
12
+ /** Oversized reqresp request error
13
13
  *
14
- * This error will be thrown when a req resp request times out regardless of the peer.
14
+ * Thrown locally (before dialing) when a request payload does not fit in a single muxer frame. Such a request would
15
+ * reach the responder split across multiple chunks, which are never reassembled into one request.
15
16
  * @category Errors
16
17
  */
17
- export class CollectiveReqRespTimeoutError extends Error {
18
- constructor() {
19
- super(`Request to all peers timed out`);
20
- }
21
- }
22
-
23
- /** Invalid response error
24
- *
25
- * This error will be thrown when a response is received that is not valid.
26
- *
27
- * This error does not need to be punished as message validators will handle punishing invalid
28
- * requests
29
- * @category Errors
30
- */
31
- export class InvalidResponseError extends Error {
32
- constructor() {
33
- super(`Invalid response received`);
18
+ export class OversizedReqRespRequestError extends Error {
19
+ constructor(
20
+ public readonly subProtocol: string,
21
+ public readonly payloadSizeBytes: number,
22
+ public readonly maxSizeBytes: number,
23
+ ) {
24
+ super(
25
+ `Request payload of ${payloadSizeBytes} bytes for ${subProtocol} exceeds the ${maxSizeBytes} byte limit of a single muxer frame`,
26
+ );
27
+ this.name = 'OversizedReqRespRequestError';
34
28
  }
35
29
  }
package/src/index.ts CHANGED
@@ -6,7 +6,6 @@ export * from './client/index.js';
6
6
  export * from './enr/index.js';
7
7
  export * from './config.js';
8
8
  export * from './mem_pools/attestation_pool/index.js';
9
- export * from './mem_pools/tx_pool/index.js';
10
9
  export * from './mem_pools/tx_pool_v2/index.js';
11
10
  export * from './msg_validators/index.js';
12
11
  export * from './services/index.js';