@aztec/p2p 0.0.1-commit.e558bd1c → 0.0.1-commit.e5a3663dd

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 (468) hide show
  1. package/README.md +129 -3
  2. package/dest/client/factory.d.ts +10 -9
  3. package/dest/client/factory.d.ts.map +1 -1
  4. package/dest/client/factory.js +54 -15
  5. package/dest/client/interface.d.ts +47 -34
  6. package/dest/client/interface.d.ts.map +1 -1
  7. package/dest/client/p2p_client.d.ts +39 -51
  8. package/dest/client/p2p_client.d.ts.map +1 -1
  9. package/dest/client/p2p_client.js +173 -226
  10. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker.js +23 -10
  11. package/dest/config.d.ts +137 -92
  12. package/dest/config.d.ts.map +1 -1
  13. package/dest/config.js +113 -40
  14. package/dest/errors/p2p-service.error.d.ts +9 -0
  15. package/dest/errors/p2p-service.error.d.ts.map +1 -0
  16. package/dest/errors/p2p-service.error.js +10 -0
  17. package/dest/errors/tx-pool.error.d.ts +8 -0
  18. package/dest/errors/tx-pool.error.d.ts.map +1 -0
  19. package/dest/errors/tx-pool.error.js +9 -0
  20. package/dest/index.d.ts +2 -2
  21. package/dest/index.d.ts.map +1 -1
  22. package/dest/index.js +1 -1
  23. package/dest/mem_pools/attestation_pool/attestation_pool.d.ts +24 -13
  24. package/dest/mem_pools/attestation_pool/attestation_pool.d.ts.map +1 -1
  25. package/dest/mem_pools/attestation_pool/attestation_pool.js +80 -43
  26. package/dest/mem_pools/attestation_pool/attestation_pool_test_suite.d.ts +1 -1
  27. package/dest/mem_pools/attestation_pool/attestation_pool_test_suite.d.ts.map +1 -1
  28. package/dest/mem_pools/attestation_pool/attestation_pool_test_suite.js +57 -57
  29. package/dest/mem_pools/attestation_pool/index.d.ts +2 -2
  30. package/dest/mem_pools/attestation_pool/index.d.ts.map +1 -1
  31. package/dest/mem_pools/attestation_pool/index.js +1 -1
  32. package/dest/mem_pools/attestation_pool/mocks.d.ts +2 -2
  33. package/dest/mem_pools/attestation_pool/mocks.d.ts.map +1 -1
  34. package/dest/mem_pools/attestation_pool/mocks.js +7 -5
  35. package/dest/mem_pools/index.d.ts +2 -2
  36. package/dest/mem_pools/index.d.ts.map +1 -1
  37. package/dest/mem_pools/instrumentation.d.ts +4 -2
  38. package/dest/mem_pools/instrumentation.d.ts.map +1 -1
  39. package/dest/mem_pools/instrumentation.js +33 -15
  40. package/dest/mem_pools/interface.d.ts +3 -3
  41. package/dest/mem_pools/interface.d.ts.map +1 -1
  42. package/dest/mem_pools/tx_pool_v2/deleted_pool.d.ts +104 -0
  43. package/dest/mem_pools/tx_pool_v2/deleted_pool.d.ts.map +1 -0
  44. package/dest/mem_pools/tx_pool_v2/deleted_pool.js +251 -0
  45. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.d.ts +3 -3
  46. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.d.ts.map +1 -1
  47. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.js +18 -9
  48. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.d.ts +1 -1
  49. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.d.ts.map +1 -1
  50. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.js +7 -3
  51. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.d.ts +3 -3
  52. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.d.ts.map +1 -1
  53. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.js +12 -4
  54. package/dest/mem_pools/tx_pool_v2/eviction/index.d.ts +3 -2
  55. package/dest/mem_pools/tx_pool_v2/eviction/index.d.ts.map +1 -1
  56. package/dest/mem_pools/tx_pool_v2/eviction/index.js +2 -1
  57. package/dest/mem_pools/tx_pool_v2/eviction/insufficient_fee_per_gas_eviction_rule.d.ts +16 -0
  58. package/dest/mem_pools/tx_pool_v2/eviction/insufficient_fee_per_gas_eviction_rule.d.ts.map +1 -0
  59. package/dest/mem_pools/tx_pool_v2/eviction/insufficient_fee_per_gas_eviction_rule.js +62 -0
  60. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.d.ts +54 -5
  61. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.d.ts.map +1 -1
  62. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.js +8 -0
  63. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.js +7 -5
  64. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.js +9 -7
  65. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.d.ts +2 -2
  66. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.d.ts.map +1 -1
  67. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.js +14 -6
  68. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.d.ts +4 -4
  69. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.d.ts.map +1 -1
  70. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.js +16 -4
  71. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.d.ts +3 -3
  72. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.d.ts.map +1 -1
  73. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.js +3 -3
  74. package/dest/mem_pools/tx_pool_v2/index.d.ts +3 -2
  75. package/dest/mem_pools/tx_pool_v2/index.d.ts.map +1 -1
  76. package/dest/mem_pools/tx_pool_v2/index.js +2 -1
  77. package/dest/mem_pools/tx_pool_v2/instrumentation.d.ts +15 -0
  78. package/dest/mem_pools/tx_pool_v2/instrumentation.d.ts.map +1 -0
  79. package/dest/mem_pools/tx_pool_v2/instrumentation.js +43 -0
  80. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts +33 -12
  81. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts.map +1 -1
  82. package/dest/mem_pools/tx_pool_v2/interfaces.js +5 -1
  83. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts +81 -15
  84. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts.map +1 -1
  85. package/dest/mem_pools/tx_pool_v2/tx_metadata.js +147 -19
  86. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.d.ts +12 -3
  87. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.d.ts.map +1 -1
  88. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.js +50 -45
  89. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts +12 -5
  90. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts.map +1 -1
  91. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.js +17 -6
  92. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts +14 -5
  93. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts.map +1 -1
  94. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.js +365 -189
  95. package/dest/msg_validators/attestation_validator/attestation_validator.d.ts +9 -3
  96. package/dest/msg_validators/attestation_validator/attestation_validator.d.ts.map +1 -1
  97. package/dest/msg_validators/attestation_validator/attestation_validator.js +37 -12
  98. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts +7 -3
  99. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts.map +1 -1
  100. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.js +2 -2
  101. package/dest/msg_validators/clock_tolerance.d.ts +12 -1
  102. package/dest/msg_validators/clock_tolerance.d.ts.map +1 -1
  103. package/dest/msg_validators/clock_tolerance.js +61 -3
  104. package/dest/msg_validators/proposal_validator/block_proposal_validator.d.ts +9 -4
  105. package/dest/msg_validators/proposal_validator/block_proposal_validator.d.ts.map +1 -1
  106. package/dest/msg_validators/proposal_validator/block_proposal_validator.js +10 -2
  107. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.d.ts +9 -4
  108. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.d.ts.map +1 -1
  109. package/dest/msg_validators/proposal_validator/checkpoint_proposal_validator.js +16 -2
  110. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts +19 -8
  111. package/dest/msg_validators/proposal_validator/proposal_validator.d.ts.map +1 -1
  112. package/dest/msg_validators/proposal_validator/proposal_validator.js +88 -44
  113. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts +4 -4
  114. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts.map +1 -1
  115. package/dest/msg_validators/tx_validator/aggregate_tx_validator.js +3 -3
  116. package/dest/msg_validators/tx_validator/allowed_public_setup.d.ts +2 -1
  117. package/dest/msg_validators/tx_validator/allowed_public_setup.d.ts.map +1 -1
  118. package/dest/msg_validators/tx_validator/allowed_public_setup.js +24 -20
  119. package/dest/msg_validators/tx_validator/allowed_setup_helpers.d.ts +17 -0
  120. package/dest/msg_validators/tx_validator/allowed_setup_helpers.d.ts.map +1 -0
  121. package/dest/msg_validators/tx_validator/allowed_setup_helpers.js +24 -0
  122. package/dest/msg_validators/tx_validator/archive_cache.js +1 -1
  123. package/dest/msg_validators/tx_validator/block_header_validator.d.ts +16 -3
  124. package/dest/msg_validators/tx_validator/block_header_validator.d.ts.map +1 -1
  125. package/dest/msg_validators/tx_validator/block_header_validator.js +1 -1
  126. package/dest/msg_validators/tx_validator/contract_instance_validator.d.ts +9 -0
  127. package/dest/msg_validators/tx_validator/contract_instance_validator.d.ts.map +1 -0
  128. package/dest/msg_validators/tx_validator/contract_instance_validator.js +48 -0
  129. package/dest/msg_validators/tx_validator/data_validator.d.ts +1 -1
  130. package/dest/msg_validators/tx_validator/data_validator.d.ts.map +1 -1
  131. package/dest/msg_validators/tx_validator/data_validator.js +35 -2
  132. package/dest/msg_validators/tx_validator/double_spend_validator.d.ts +13 -3
  133. package/dest/msg_validators/tx_validator/double_spend_validator.d.ts.map +1 -1
  134. package/dest/msg_validators/tx_validator/double_spend_validator.js +4 -4
  135. package/dest/msg_validators/tx_validator/factory.d.ts +133 -6
  136. package/dest/msg_validators/tx_validator/factory.d.ts.map +1 -1
  137. package/dest/msg_validators/tx_validator/factory.js +247 -60
  138. package/dest/msg_validators/tx_validator/fee_payer_balance.d.ts +1 -1
  139. package/dest/msg_validators/tx_validator/fee_payer_balance.d.ts.map +1 -1
  140. package/dest/msg_validators/tx_validator/fee_payer_balance.js +6 -2
  141. package/dest/msg_validators/tx_validator/gas_validator.d.ts +99 -3
  142. package/dest/msg_validators/tx_validator/gas_validator.d.ts.map +1 -1
  143. package/dest/msg_validators/tx_validator/gas_validator.js +137 -53
  144. package/dest/msg_validators/tx_validator/index.d.ts +3 -1
  145. package/dest/msg_validators/tx_validator/index.d.ts.map +1 -1
  146. package/dest/msg_validators/tx_validator/index.js +2 -0
  147. package/dest/msg_validators/tx_validator/metadata_validator.d.ts +1 -1
  148. package/dest/msg_validators/tx_validator/metadata_validator.d.ts.map +1 -1
  149. package/dest/msg_validators/tx_validator/metadata_validator.js +4 -4
  150. package/dest/msg_validators/tx_validator/nullifier_cache.d.ts +14 -0
  151. package/dest/msg_validators/tx_validator/nullifier_cache.d.ts.map +1 -0
  152. package/dest/msg_validators/tx_validator/nullifier_cache.js +24 -0
  153. package/dest/msg_validators/tx_validator/phases_validator.d.ts +22 -2
  154. package/dest/msg_validators/tx_validator/phases_validator.d.ts.map +1 -1
  155. package/dest/msg_validators/tx_validator/phases_validator.js +72 -24
  156. package/dest/msg_validators/tx_validator/timestamp_validator.d.ts +20 -4
  157. package/dest/msg_validators/tx_validator/timestamp_validator.d.ts.map +1 -1
  158. package/dest/msg_validators/tx_validator/timestamp_validator.js +6 -6
  159. package/dest/services/data_store.d.ts +1 -1
  160. package/dest/services/data_store.d.ts.map +1 -1
  161. package/dest/services/data_store.js +5 -5
  162. package/dest/services/dummy_service.d.ts +13 -6
  163. package/dest/services/dummy_service.d.ts.map +1 -1
  164. package/dest/services/dummy_service.js +13 -5
  165. package/dest/services/encoding.d.ts +7 -3
  166. package/dest/services/encoding.d.ts.map +1 -1
  167. package/dest/services/encoding.js +18 -11
  168. package/dest/services/gossipsub/index.d.ts +3 -0
  169. package/dest/services/gossipsub/index.d.ts.map +1 -0
  170. package/dest/services/gossipsub/index.js +2 -0
  171. package/dest/services/gossipsub/scoring.d.ts +21 -3
  172. package/dest/services/gossipsub/scoring.d.ts.map +1 -1
  173. package/dest/services/gossipsub/scoring.js +24 -7
  174. package/dest/services/gossipsub/topic_score_params.d.ts +184 -0
  175. package/dest/services/gossipsub/topic_score_params.d.ts.map +1 -0
  176. package/dest/services/gossipsub/topic_score_params.js +363 -0
  177. package/dest/services/libp2p/instrumentation.d.ts +3 -1
  178. package/dest/services/libp2p/instrumentation.d.ts.map +1 -1
  179. package/dest/services/libp2p/instrumentation.js +14 -0
  180. package/dest/services/libp2p/libp2p_service.d.ts +42 -39
  181. package/dest/services/libp2p/libp2p_service.d.ts.map +1 -1
  182. package/dest/services/libp2p/libp2p_service.js +336 -269
  183. package/dest/services/peer-manager/metrics.d.ts +3 -1
  184. package/dest/services/peer-manager/metrics.d.ts.map +1 -1
  185. package/dest/services/peer-manager/metrics.js +6 -0
  186. package/dest/services/peer-manager/peer_manager.d.ts +6 -2
  187. package/dest/services/peer-manager/peer_manager.d.ts.map +1 -1
  188. package/dest/services/peer-manager/peer_manager.js +39 -11
  189. package/dest/services/peer-manager/peer_scoring.d.ts +7 -2
  190. package/dest/services/peer-manager/peer_scoring.d.ts.map +1 -1
  191. package/dest/services/peer-manager/peer_scoring.js +57 -12
  192. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts +12 -8
  193. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts.map +1 -1
  194. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.js +83 -106
  195. package/dest/services/reqresp/batch-tx-requester/interface.d.ts +4 -7
  196. package/dest/services/reqresp/batch-tx-requester/interface.d.ts.map +1 -1
  197. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts +11 -13
  198. package/dest/services/reqresp/batch-tx-requester/missing_txs.d.ts.map +1 -1
  199. package/dest/services/reqresp/batch-tx-requester/missing_txs.js +31 -46
  200. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts +19 -11
  201. package/dest/services/reqresp/batch-tx-requester/peer_collection.d.ts.map +1 -1
  202. package/dest/services/reqresp/batch-tx-requester/peer_collection.js +52 -15
  203. package/dest/services/reqresp/batch-tx-requester/tx_validator.js +2 -2
  204. package/dest/services/reqresp/config.d.ts +3 -3
  205. package/dest/services/reqresp/config.d.ts.map +1 -1
  206. package/dest/services/reqresp/interface.d.ts +23 -9
  207. package/dest/services/reqresp/interface.d.ts.map +1 -1
  208. package/dest/services/reqresp/interface.js +23 -10
  209. package/dest/services/reqresp/metrics.d.ts +1 -1
  210. package/dest/services/reqresp/metrics.d.ts.map +1 -1
  211. package/dest/services/reqresp/metrics.js +0 -1
  212. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts +3 -3
  213. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts.map +1 -1
  214. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts +7 -1
  215. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts.map +1 -1
  216. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.js +15 -0
  217. package/dest/services/reqresp/protocols/index.d.ts +1 -2
  218. package/dest/services/reqresp/protocols/index.d.ts.map +1 -1
  219. package/dest/services/reqresp/protocols/index.js +0 -1
  220. package/dest/services/reqresp/protocols/tx.d.ts +7 -1
  221. package/dest/services/reqresp/protocols/tx.d.ts.map +1 -1
  222. package/dest/services/reqresp/protocols/tx.js +21 -3
  223. package/dest/services/reqresp/rate-limiter/rate_limiter.d.ts +5 -4
  224. package/dest/services/reqresp/rate-limiter/rate_limiter.d.ts.map +1 -1
  225. package/dest/services/reqresp/rate-limiter/rate_limiter.js +10 -8
  226. package/dest/services/reqresp/rate-limiter/rate_limits.d.ts +1 -1
  227. package/dest/services/reqresp/rate-limiter/rate_limits.d.ts.map +1 -1
  228. package/dest/services/reqresp/rate-limiter/rate_limits.js +0 -10
  229. package/dest/services/reqresp/reqresp.d.ts +4 -2
  230. package/dest/services/reqresp/reqresp.d.ts.map +1 -1
  231. package/dest/services/reqresp/reqresp.js +40 -15
  232. package/dest/services/service.d.ts +26 -4
  233. package/dest/services/service.d.ts.map +1 -1
  234. package/dest/services/tx_collection/config.d.ts +19 -1
  235. package/dest/services/tx_collection/config.d.ts.map +1 -1
  236. package/dest/services/tx_collection/config.js +46 -0
  237. package/dest/services/tx_collection/fast_tx_collection.d.ts +3 -4
  238. package/dest/services/tx_collection/fast_tx_collection.d.ts.map +1 -1
  239. package/dest/services/tx_collection/fast_tx_collection.js +80 -76
  240. package/dest/services/tx_collection/file_store_tx_collection.d.ts +53 -0
  241. package/dest/services/tx_collection/file_store_tx_collection.d.ts.map +1 -0
  242. package/dest/services/tx_collection/file_store_tx_collection.js +167 -0
  243. package/dest/services/tx_collection/file_store_tx_source.d.ts +38 -0
  244. package/dest/services/tx_collection/file_store_tx_source.d.ts.map +1 -0
  245. package/dest/services/tx_collection/file_store_tx_source.js +100 -0
  246. package/dest/services/tx_collection/index.d.ts +2 -1
  247. package/dest/services/tx_collection/index.d.ts.map +1 -1
  248. package/dest/services/tx_collection/index.js +1 -0
  249. package/dest/services/tx_collection/instrumentation.d.ts +1 -1
  250. package/dest/services/tx_collection/instrumentation.d.ts.map +1 -1
  251. package/dest/services/tx_collection/instrumentation.js +2 -1
  252. package/dest/services/tx_collection/proposal_tx_collector.d.ts +7 -7
  253. package/dest/services/tx_collection/proposal_tx_collector.d.ts.map +1 -1
  254. package/dest/services/tx_collection/proposal_tx_collector.js +5 -4
  255. package/dest/services/tx_collection/request_tracker.d.ts +53 -0
  256. package/dest/services/tx_collection/request_tracker.d.ts.map +1 -0
  257. package/dest/services/tx_collection/request_tracker.js +84 -0
  258. package/dest/services/tx_collection/slow_tx_collection.d.ts +7 -3
  259. package/dest/services/tx_collection/slow_tx_collection.d.ts.map +1 -1
  260. package/dest/services/tx_collection/slow_tx_collection.js +60 -26
  261. package/dest/services/tx_collection/tx_collection.d.ts +23 -13
  262. package/dest/services/tx_collection/tx_collection.d.ts.map +1 -1
  263. package/dest/services/tx_collection/tx_collection.js +75 -3
  264. package/dest/services/tx_collection/tx_collection_sink.d.ts +18 -8
  265. package/dest/services/tx_collection/tx_collection_sink.d.ts.map +1 -1
  266. package/dest/services/tx_collection/tx_collection_sink.js +26 -29
  267. package/dest/services/tx_collection/tx_source.d.ts +13 -7
  268. package/dest/services/tx_collection/tx_source.d.ts.map +1 -1
  269. package/dest/services/tx_collection/tx_source.js +26 -7
  270. package/dest/services/tx_file_store/config.d.ts +1 -3
  271. package/dest/services/tx_file_store/config.d.ts.map +1 -1
  272. package/dest/services/tx_file_store/config.js +0 -4
  273. package/dest/services/tx_file_store/tx_file_store.d.ts +4 -3
  274. package/dest/services/tx_file_store/tx_file_store.d.ts.map +1 -1
  275. package/dest/services/tx_file_store/tx_file_store.js +9 -6
  276. package/dest/services/tx_provider.d.ts +4 -4
  277. package/dest/services/tx_provider.d.ts.map +1 -1
  278. package/dest/services/tx_provider.js +9 -8
  279. package/dest/test-helpers/make-test-p2p-clients.d.ts +7 -8
  280. package/dest/test-helpers/make-test-p2p-clients.d.ts.map +1 -1
  281. package/dest/test-helpers/make-test-p2p-clients.js +4 -2
  282. package/dest/test-helpers/mock-pubsub.d.ts +40 -6
  283. package/dest/test-helpers/mock-pubsub.d.ts.map +1 -1
  284. package/dest/test-helpers/mock-pubsub.js +139 -13
  285. package/dest/test-helpers/reqresp-nodes.d.ts +2 -3
  286. package/dest/test-helpers/reqresp-nodes.d.ts.map +1 -1
  287. package/dest/test-helpers/reqresp-nodes.js +8 -5
  288. package/dest/test-helpers/testbench-utils.d.ts +35 -24
  289. package/dest/test-helpers/testbench-utils.d.ts.map +1 -1
  290. package/dest/test-helpers/testbench-utils.js +125 -38
  291. package/dest/testbench/p2p_client_testbench_worker.d.ts +2 -2
  292. package/dest/testbench/p2p_client_testbench_worker.d.ts.map +1 -1
  293. package/dest/testbench/p2p_client_testbench_worker.js +84 -27
  294. package/dest/testbench/worker_client_manager.d.ts +10 -1
  295. package/dest/testbench/worker_client_manager.d.ts.map +1 -1
  296. package/dest/testbench/worker_client_manager.js +55 -3
  297. package/dest/util.d.ts +3 -3
  298. package/dest/util.d.ts.map +1 -1
  299. package/package.json +14 -14
  300. package/src/client/factory.ts +108 -26
  301. package/src/client/interface.ts +52 -34
  302. package/src/client/p2p_client.ts +201 -269
  303. package/src/client/test/tx_proposal_collector/proposal_tx_collector_worker.ts +35 -14
  304. package/src/config.ts +181 -46
  305. package/src/errors/p2p-service.error.ts +11 -0
  306. package/src/errors/tx-pool.error.ts +12 -0
  307. package/src/index.ts +1 -1
  308. package/src/mem_pools/attestation_pool/attestation_pool.ts +109 -53
  309. package/src/mem_pools/attestation_pool/attestation_pool_test_suite.ts +61 -57
  310. package/src/mem_pools/attestation_pool/index.ts +3 -3
  311. package/src/mem_pools/attestation_pool/mocks.ts +14 -8
  312. package/src/mem_pools/index.ts +1 -1
  313. package/src/mem_pools/instrumentation.ts +22 -14
  314. package/src/mem_pools/interface.ts +2 -2
  315. package/src/mem_pools/tx_pool_v2/README.md +85 -11
  316. package/src/mem_pools/tx_pool_v2/deleted_pool.ts +321 -0
  317. package/src/mem_pools/tx_pool_v2/eviction/eviction_manager.ts +21 -8
  318. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.ts +7 -3
  319. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.ts +18 -4
  320. package/src/mem_pools/tx_pool_v2/eviction/index.ts +5 -0
  321. package/src/mem_pools/tx_pool_v2/eviction/insufficient_fee_per_gas_eviction_rule.ts +65 -0
  322. package/src/mem_pools/tx_pool_v2/eviction/interfaces.ts +59 -4
  323. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.ts +5 -5
  324. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.ts +8 -8
  325. package/src/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.ts +14 -9
  326. package/src/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.ts +33 -6
  327. package/src/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.ts +4 -3
  328. package/src/mem_pools/tx_pool_v2/index.ts +2 -1
  329. package/src/mem_pools/tx_pool_v2/instrumentation.ts +69 -0
  330. package/src/mem_pools/tx_pool_v2/interfaces.ts +35 -12
  331. package/src/mem_pools/tx_pool_v2/tx_metadata.ts +215 -27
  332. package/src/mem_pools/tx_pool_v2/tx_pool_indices.ts +58 -45
  333. package/src/mem_pools/tx_pool_v2/tx_pool_v2.ts +34 -8
  334. package/src/mem_pools/tx_pool_v2/tx_pool_v2_impl.ts +412 -187
  335. package/src/msg_validators/attestation_validator/README.md +49 -0
  336. package/src/msg_validators/attestation_validator/attestation_validator.ts +41 -9
  337. package/src/msg_validators/attestation_validator/fisherman_attestation_validator.ts +12 -2
  338. package/src/msg_validators/clock_tolerance.ts +79 -3
  339. package/src/msg_validators/proposal_validator/README.md +123 -0
  340. package/src/msg_validators/proposal_validator/block_proposal_validator.ts +23 -4
  341. package/src/msg_validators/proposal_validator/checkpoint_proposal_validator.ts +34 -7
  342. package/src/msg_validators/proposal_validator/proposal_validator.ts +111 -47
  343. package/src/msg_validators/tx_validator/README.md +127 -0
  344. package/src/msg_validators/tx_validator/aggregate_tx_validator.ts +5 -5
  345. package/src/msg_validators/tx_validator/allowed_public_setup.ts +22 -27
  346. package/src/msg_validators/tx_validator/allowed_setup_helpers.ts +31 -0
  347. package/src/msg_validators/tx_validator/archive_cache.ts +1 -1
  348. package/src/msg_validators/tx_validator/block_header_validator.ts +15 -3
  349. package/src/msg_validators/tx_validator/contract_instance_validator.ts +56 -0
  350. package/src/msg_validators/tx_validator/data_validator.ts +42 -1
  351. package/src/msg_validators/tx_validator/double_spend_validator.ts +11 -6
  352. package/src/msg_validators/tx_validator/factory.ts +396 -78
  353. package/src/msg_validators/tx_validator/fee_payer_balance.ts +6 -2
  354. package/src/msg_validators/tx_validator/gas_validator.ts +199 -54
  355. package/src/msg_validators/tx_validator/index.ts +2 -0
  356. package/src/msg_validators/tx_validator/metadata_validator.ts +12 -4
  357. package/src/msg_validators/tx_validator/nullifier_cache.ts +30 -0
  358. package/src/msg_validators/tx_validator/phases_validator.ts +82 -27
  359. package/src/msg_validators/tx_validator/timestamp_validator.ts +23 -18
  360. package/src/services/data_store.ts +5 -13
  361. package/src/services/dummy_service.ts +19 -7
  362. package/src/services/encoding.ts +18 -10
  363. package/src/services/gossipsub/README.md +641 -0
  364. package/src/services/gossipsub/index.ts +2 -0
  365. package/src/services/gossipsub/scoring.ts +29 -5
  366. package/src/services/gossipsub/topic_score_params.ts +519 -0
  367. package/src/services/libp2p/instrumentation.ts +14 -0
  368. package/src/services/libp2p/libp2p_service.ts +358 -298
  369. package/src/services/peer-manager/metrics.ts +7 -0
  370. package/src/services/peer-manager/peer_manager.ts +45 -11
  371. package/src/services/peer-manager/peer_scoring.ts +52 -5
  372. package/src/services/reqresp/README.md +229 -0
  373. package/src/services/reqresp/batch-tx-requester/README.md +46 -7
  374. package/src/services/reqresp/batch-tx-requester/batch_tx_requester.ts +79 -112
  375. package/src/services/reqresp/batch-tx-requester/interface.ts +3 -6
  376. package/src/services/reqresp/batch-tx-requester/missing_txs.ts +30 -71
  377. package/src/services/reqresp/batch-tx-requester/peer_collection.ts +68 -24
  378. package/src/services/reqresp/batch-tx-requester/tx_validator.ts +2 -2
  379. package/src/services/reqresp/config.ts +2 -2
  380. package/src/services/reqresp/interface.ts +45 -10
  381. package/src/services/reqresp/metrics.ts +0 -1
  382. package/src/services/reqresp/protocols/block_txs/block_txs_handler.ts +2 -2
  383. package/src/services/reqresp/protocols/block_txs/block_txs_reqresp.ts +17 -0
  384. package/src/services/reqresp/protocols/index.ts +0 -1
  385. package/src/services/reqresp/protocols/tx.ts +23 -3
  386. package/src/services/reqresp/rate-limiter/rate_limiter.ts +13 -9
  387. package/src/services/reqresp/rate-limiter/rate_limits.ts +0 -10
  388. package/src/services/reqresp/reqresp.ts +53 -16
  389. package/src/services/service.ts +37 -3
  390. package/src/services/tx_collection/config.ts +68 -0
  391. package/src/services/tx_collection/fast_tx_collection.ts +83 -76
  392. package/src/services/tx_collection/file_store_tx_collection.ts +202 -0
  393. package/src/services/tx_collection/file_store_tx_source.ts +129 -0
  394. package/src/services/tx_collection/index.ts +1 -0
  395. package/src/services/tx_collection/instrumentation.ts +7 -1
  396. package/src/services/tx_collection/proposal_tx_collector.ts +9 -13
  397. package/src/services/tx_collection/request_tracker.ts +127 -0
  398. package/src/services/tx_collection/slow_tx_collection.ts +66 -33
  399. package/src/services/tx_collection/tx_collection.ts +114 -19
  400. package/src/services/tx_collection/tx_collection_sink.ts +30 -34
  401. package/src/services/tx_collection/tx_source.ts +28 -8
  402. package/src/services/tx_file_store/config.ts +0 -6
  403. package/src/services/tx_file_store/tx_file_store.ts +10 -8
  404. package/src/services/tx_provider.ts +10 -9
  405. package/src/test-helpers/make-test-p2p-clients.ts +6 -6
  406. package/src/test-helpers/mock-pubsub.ts +180 -14
  407. package/src/test-helpers/reqresp-nodes.ts +9 -9
  408. package/src/test-helpers/testbench-utils.ts +147 -43
  409. package/src/testbench/p2p_client_testbench_worker.ts +93 -30
  410. package/src/testbench/worker_client_manager.ts +68 -6
  411. package/src/util.ts +8 -2
  412. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.d.ts +0 -125
  413. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.d.ts.map +0 -1
  414. package/dest/mem_pools/tx_pool/aztec_kv_tx_pool.js +0 -596
  415. package/dest/mem_pools/tx_pool/eviction/eviction_manager.d.ts +0 -32
  416. package/dest/mem_pools/tx_pool/eviction/eviction_manager.d.ts.map +0 -1
  417. package/dest/mem_pools/tx_pool/eviction/eviction_manager.js +0 -112
  418. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.d.ts +0 -157
  419. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.d.ts.map +0 -1
  420. package/dest/mem_pools/tx_pool/eviction/eviction_strategy.js +0 -52
  421. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.d.ts +0 -16
  422. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.d.ts.map +0 -1
  423. package/dest/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.js +0 -122
  424. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.d.ts +0 -17
  425. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.d.ts.map +0 -1
  426. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.js +0 -84
  427. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.d.ts +0 -19
  428. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.d.ts.map +0 -1
  429. package/dest/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.js +0 -78
  430. package/dest/mem_pools/tx_pool/eviction/low_priority_eviction_rule.d.ts +0 -26
  431. package/dest/mem_pools/tx_pool/eviction/low_priority_eviction_rule.d.ts.map +0 -1
  432. package/dest/mem_pools/tx_pool/eviction/low_priority_eviction_rule.js +0 -84
  433. package/dest/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.d.ts +0 -25
  434. package/dest/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.d.ts.map +0 -1
  435. package/dest/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.js +0 -57
  436. package/dest/mem_pools/tx_pool/index.d.ts +0 -3
  437. package/dest/mem_pools/tx_pool/index.d.ts.map +0 -1
  438. package/dest/mem_pools/tx_pool/index.js +0 -2
  439. package/dest/mem_pools/tx_pool/priority.d.ts +0 -12
  440. package/dest/mem_pools/tx_pool/priority.d.ts.map +0 -1
  441. package/dest/mem_pools/tx_pool/priority.js +0 -15
  442. package/dest/mem_pools/tx_pool/tx_pool.d.ts +0 -127
  443. package/dest/mem_pools/tx_pool/tx_pool.d.ts.map +0 -1
  444. package/dest/mem_pools/tx_pool/tx_pool.js +0 -3
  445. package/dest/mem_pools/tx_pool/tx_pool_test_suite.d.ts +0 -7
  446. package/dest/mem_pools/tx_pool/tx_pool_test_suite.d.ts.map +0 -1
  447. package/dest/mem_pools/tx_pool/tx_pool_test_suite.js +0 -400
  448. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.d.ts +0 -23
  449. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.d.ts.map +0 -1
  450. package/dest/msg_validators/proposal_validator/proposal_validator_test_suite.js +0 -212
  451. package/dest/services/reqresp/protocols/block.d.ts +0 -9
  452. package/dest/services/reqresp/protocols/block.d.ts.map +0 -1
  453. package/dest/services/reqresp/protocols/block.js +0 -32
  454. package/src/mem_pools/tx_pool/README.md +0 -270
  455. package/src/mem_pools/tx_pool/aztec_kv_tx_pool.ts +0 -746
  456. package/src/mem_pools/tx_pool/eviction/eviction_manager.ts +0 -132
  457. package/src/mem_pools/tx_pool/eviction/eviction_strategy.ts +0 -208
  458. package/src/mem_pools/tx_pool/eviction/fee_payer_balance_eviction_rule.ts +0 -162
  459. package/src/mem_pools/tx_pool/eviction/invalid_txs_after_mining_rule.ts +0 -104
  460. package/src/mem_pools/tx_pool/eviction/invalid_txs_after_reorg_rule.ts +0 -93
  461. package/src/mem_pools/tx_pool/eviction/low_priority_eviction_rule.ts +0 -106
  462. package/src/mem_pools/tx_pool/eviction/nullifier_conflict_pre_add_rule.ts +0 -75
  463. package/src/mem_pools/tx_pool/index.ts +0 -2
  464. package/src/mem_pools/tx_pool/priority.ts +0 -20
  465. package/src/mem_pools/tx_pool/tx_pool.ts +0 -141
  466. package/src/mem_pools/tx_pool/tx_pool_test_suite.ts +0 -319
  467. package/src/msg_validators/proposal_validator/proposal_validator_test_suite.ts +0 -230
  468. package/src/services/reqresp/protocols/block.ts +0 -37
@@ -0,0 +1,519 @@
1
+ import { TopicType, createTopicString } from '@aztec/stdlib/p2p';
2
+ import { createCheckpointTimingModel } from '@aztec/stdlib/timetable';
3
+
4
+ import { createTopicScoreParams } from '@chainsafe/libp2p-gossipsub/score';
5
+
6
+ /**
7
+ * Network parameters needed to compute topic-specific gossipsub scoring parameters.
8
+ */
9
+ export type TopicScoringNetworkParams = {
10
+ /** L2 slot duration in milliseconds */
11
+ slotDurationMs: number;
12
+ /** L1 slot duration in seconds */
13
+ ethereumSlotDuration: number;
14
+ /** Gossipsub heartbeat interval in milliseconds */
15
+ heartbeatIntervalMs: number;
16
+ /** Target committee size (number of validators expected to attest per slot) */
17
+ targetCommitteeSize: number;
18
+ /** Duration per block in milliseconds when building multiple blocks per slot. If undefined, single block mode. */
19
+ blockDurationMs?: number;
20
+ /** Time budget in seconds reserved for L1 publishing. Defaults to ethereumSlotDuration. */
21
+ l1PublishingTime?: number;
22
+ /** One-way proposal/attestation propagation budget in seconds. */
23
+ p2pPropagationTime?: number;
24
+ /** Expected number of block proposals per slot for scoring override. 0 disables scoring, undefined falls back to blocksPerSlot - 1. */
25
+ expectedBlockProposalsPerSlot?: number;
26
+ };
27
+
28
+ /**
29
+ * Calculates the number of blocks per slot based on timing parameters.
30
+ * Uses the shared calculation from @aztec/stdlib/timetable.
31
+ *
32
+ * @param slotDurationMs - L2 slot duration in milliseconds
33
+ * @param blockDurationMs - Duration per block in milliseconds (undefined = single block mode)
34
+ * @param opts - Shared checkpoint timing inputs used by the sequencer and validators
35
+ * @returns Number of blocks per slot
36
+ */
37
+ export function calculateBlocksPerSlot(
38
+ slotDurationMs: number,
39
+ blockDurationMs: number | undefined,
40
+ opts?: {
41
+ ethereumSlotDuration: number;
42
+ l1PublishingTime?: number;
43
+ p2pPropagationTime?: number;
44
+ },
45
+ ): number {
46
+ if (!opts) {
47
+ return createCheckpointTimingModel({
48
+ aztecSlotDuration: slotDurationMs / 1000,
49
+ blockDuration: blockDurationMs ? blockDurationMs / 1000 : undefined,
50
+ }).calculateMaxBlocksPerSlot();
51
+ }
52
+
53
+ return createCheckpointTimingModel({
54
+ aztecSlotDuration: slotDurationMs / 1000,
55
+ ethereumSlotDuration: opts.ethereumSlotDuration,
56
+ blockDuration: blockDurationMs ? blockDurationMs / 1000 : undefined,
57
+ l1PublishingTime: opts.l1PublishingTime ?? opts.ethereumSlotDuration,
58
+ p2pPropagationTime: opts.p2pPropagationTime,
59
+ }).calculateMaxBlocksPerSlot();
60
+ }
61
+
62
+ /**
63
+ * Determines the decay window in slots based on expected message frequency.
64
+ * Low-frequency topics need longer decay windows to accumulate meaningful counter values.
65
+ *
66
+ * @param expectedMessagesPerSlot - Expected messages per slot for this topic
67
+ * @returns Number of slots over which the counter should decay to ~1%
68
+ */
69
+ export function getDecayWindowSlots(expectedMessagesPerSlot: number): number {
70
+ if (expectedMessagesPerSlot <= 1) {
71
+ return 5; // Low frequency: decay over 5 slots
72
+ } else if (expectedMessagesPerSlot <= 10) {
73
+ return 3; // Medium frequency: decay over 3 slots
74
+ } else {
75
+ return 2; // High frequency: decay over 2 slots
76
+ }
77
+ }
78
+
79
+ /**
80
+ * Computes the decay factor for exponential decay over a given window.
81
+ * After `heartbeatsInWindow` heartbeats, the counter decays to ~1% of its original value.
82
+ *
83
+ * @param heartbeatIntervalMs - Gossipsub heartbeat interval in milliseconds
84
+ * @param slotDurationMs - L2 slot duration in milliseconds
85
+ * @param decayWindowSlots - Number of slots over which to decay
86
+ * @returns Decay factor (0 < decay < 1), applied each heartbeat
87
+ */
88
+ export function computeDecay(heartbeatIntervalMs: number, slotDurationMs: number, decayWindowSlots: number): number {
89
+ const heartbeatsPerSlot = slotDurationMs / heartbeatIntervalMs;
90
+ const heartbeatsInWindow = heartbeatsPerSlot * decayWindowSlots;
91
+
92
+ // Decay to 1% over the window: decay^heartbeatsInWindow = 0.01
93
+ // decay = 0.01^(1/heartbeatsInWindow)
94
+ return Math.pow(0.01, 1 / heartbeatsInWindow);
95
+ }
96
+
97
+ /**
98
+ * Computes the steady-state convergence value for a decaying counter.
99
+ * If messages arrive at a constant rate and decay is applied each heartbeat,
100
+ * the counter converges to: rate / (1 - decay)
101
+ *
102
+ * @param messagesPerHeartbeat - Expected messages per heartbeat
103
+ * @param decay - Decay factor applied each heartbeat
104
+ * @returns Convergence value (steady-state counter value)
105
+ */
106
+ export function computeConvergence(messagesPerHeartbeat: number, decay: number): number {
107
+ return messagesPerHeartbeat / (1 - decay);
108
+ }
109
+
110
+ /**
111
+ * Computes a conservative threshold for mesh message deliveries.
112
+ * The threshold should be low enough to avoid penalizing honest peers with normal variance.
113
+ *
114
+ * @param convergence - Steady-state counter value
115
+ * @param conservativeFactor - Fraction of convergence to use as threshold (e.g., 0.3)
116
+ * @returns Threshold value
117
+ */
118
+ export function computeThreshold(convergence: number, conservativeFactor: number): number {
119
+ return convergence * conservativeFactor;
120
+ }
121
+
122
+ /**
123
+ * Determines the effective expected block proposals per slot for scoring.
124
+ * Returns undefined if scoring should be disabled, or a positive number if enabled.
125
+ *
126
+ * @param blocksPerSlot - Number of blocks per slot from timetable
127
+ * @param expectedBlockProposalsPerSlot - Config override. 0 disables scoring, undefined falls back to blocksPerSlot - 1.
128
+ * @returns Positive number of expected block proposals, or undefined if scoring is disabled
129
+ */
130
+ export function getEffectiveBlockProposalsPerSlot(
131
+ blocksPerSlot: number,
132
+ expectedBlockProposalsPerSlot?: number,
133
+ ): number | undefined {
134
+ if (expectedBlockProposalsPerSlot !== undefined) {
135
+ return expectedBlockProposalsPerSlot > 0 ? expectedBlockProposalsPerSlot : undefined;
136
+ }
137
+ // Fallback: In MBPS mode, N-1 block proposals per slot (last one bundled with checkpoint)
138
+ // In single block mode (blocksPerSlot=1), this is 0 → disabled
139
+ const fallback = Math.max(0, blocksPerSlot - 1);
140
+ return fallback > 0 ? fallback : undefined;
141
+ }
142
+
143
+ /**
144
+ * Gets the expected messages per slot for a given topic type.
145
+ *
146
+ * @param topicType - The topic type
147
+ * @param targetCommitteeSize - Target committee size
148
+ * @param blocksPerSlot - Number of blocks per slot
149
+ * @param expectedBlockProposalsPerSlot - Override for block proposals. 0 disables scoring, undefined falls back to blocksPerSlot - 1.
150
+ * @returns Expected messages per slot, or undefined if unpredictable
151
+ */
152
+ export function getExpectedMessagesPerSlot(
153
+ topicType: TopicType,
154
+ targetCommitteeSize: number,
155
+ blocksPerSlot: number,
156
+ expectedBlockProposalsPerSlot?: number,
157
+ ): number | undefined {
158
+ switch (topicType) {
159
+ case TopicType.tx:
160
+ // Transactions are unpredictable - disable mesh message delivery scoring
161
+ return undefined;
162
+
163
+ case TopicType.block_proposal:
164
+ return getEffectiveBlockProposalsPerSlot(blocksPerSlot, expectedBlockProposalsPerSlot);
165
+
166
+ case TopicType.checkpoint_proposal:
167
+ // Exactly 1 checkpoint proposal per slot
168
+ return 1;
169
+
170
+ case TopicType.checkpoint_attestation:
171
+ // Each committee member sends one attestation per slot
172
+ return targetCommitteeSize;
173
+
174
+ default:
175
+ return undefined;
176
+ }
177
+ }
178
+
179
+ /** Conservative factor for threshold calculation (30% of convergence) */
180
+ const CONSERVATIVE_FACTOR = 0.3;
181
+
182
+ /** Number of slots over which invalid message penalty decays */
183
+ const INVALID_DECAY_WINDOW_SLOTS = 4;
184
+
185
+ /** Weight for invalid message deliveries penalty */
186
+ const INVALID_MESSAGE_WEIGHT = -20;
187
+
188
+ /** Mesh message deliveries window in milliseconds (5 seconds - balanced for TypeScript runtime) */
189
+ const MESH_DELIVERIES_WINDOW_MS = 5000;
190
+
191
+ /**
192
+ * Multiplier for activation time to provide extra grace period during network bootstrap.
193
+ * The activation timer starts from mesh join time, not from first message received.
194
+ * During bootstrap, peers may join before messages start flowing, so we need extra time.
195
+ */
196
+ const ACTIVATION_MULTIPLIER = 5;
197
+
198
+ // ============================================================================
199
+ // P1 (timeInMesh) Configuration
200
+ // ============================================================================
201
+ // P1 rewards peers for time spent in the mesh. Following Lodestar's approach,
202
+ // we normalize the score so that max P1 = MAX_P1_SCORE after P1_CAP_TIME_SECONDS.
203
+ //
204
+ // Formula: P1 = min(timeInMesh / quantum, cap) * weight
205
+ // - quantum = slotDurationMs (one increment per slot worth of time)
206
+ // - cap = P1_CAP_TIME_SECONDS / slotSeconds (number of slots to reach cap)
207
+ // - weight = MAX_P1_SCORE / cap
208
+ //
209
+ // This ensures: max P1 = cap * weight = MAX_P1_SCORE
210
+
211
+ /** Maximum P1 score contribution per topic */
212
+ export const MAX_P1_SCORE = 8;
213
+
214
+ /** Time in seconds to reach P1 cap (1 hour) */
215
+ const P1_CAP_TIME_SECONDS = 3600;
216
+
217
+ // ============================================================================
218
+ // P2 (firstMessageDeliveries) Configuration
219
+ // ============================================================================
220
+ // P2 rewards peers who deliver messages first. We normalize so max P2 = MAX_P2_SCORE.
221
+ // P2 uses a decaying counter, so we set the cap based on convergence and scale the weight.
222
+ //
223
+ // Formula: P2 = min(firstMessageDeliveries, cap) * weight
224
+ // - cap = convergence value for first deliveries
225
+ // - weight = MAX_P2_SCORE / cap
226
+
227
+ /** Maximum P2 score contribution per topic */
228
+ export const MAX_P2_SCORE = 25;
229
+
230
+ /** Decay window for first message deliveries in slots (fast decay) */
231
+ const P2_DECAY_WINDOW_SLOTS = 2;
232
+
233
+ // ============================================================================
234
+ // P3 (meshMessageDeliveries) Configuration
235
+ // ============================================================================
236
+ // P3 penalizes peers who under-deliver messages. For a peer to be pruned from
237
+ // the mesh, their topic score must be negative: P1 + P2 + P3 < 0
238
+ //
239
+ // Therefore, P3 max penalty must exceed (P1 + P2) to cause pruning:
240
+ // |P3| > P1 + P2
241
+ // |P3| > 8 + 25 = 33
242
+ //
243
+ // We set P3 max = -34 per topic (slightly more than P1+P2) to ensure pruning.
244
+ // The number of P3-enabled topics depends on config: by default 2 (checkpoint_proposal +
245
+ // checkpoint_attestation), or 3 if block proposal scoring is enabled via
246
+ // expectedBlockProposalsPerSlot. Total P3b after pruning = -68 (2 topics) or -102 (3 topics).
247
+ //
248
+ // With appSpecificWeight=10, ~20 HighTolerance errors (-40 app score) plus max P3b (-68 or -102)
249
+ // would not cross gossipThreshold (-500). This keeps non-contributors from being disconnected
250
+ // unless they also accrue app-level penalties.
251
+ //
252
+ // The weight formula ensures max penalty equals MAX_P3_PENALTY_PER_TOPIC:
253
+ // weight = MAX_P3_PENALTY_PER_TOPIC / threshold²
254
+ // When deficit = threshold: penalty = threshold² * weight = MAX_P3_PENALTY_PER_TOPIC
255
+
256
+ /** Maximum P3 penalty per topic (must exceed P1 + P2 to cause pruning) */
257
+ export const MAX_P3_PENALTY_PER_TOPIC = -(MAX_P1_SCORE + MAX_P2_SCORE + 1); // -34
258
+
259
+ /**
260
+ * Factory class for creating gossipsub topic scoring parameters.
261
+ * Computes shared values once and reuses them across all topics.
262
+ */
263
+ export class TopicScoreParamsFactory {
264
+ /** Number of blocks per slot based on timetable configuration */
265
+ public readonly blocksPerSlot: number;
266
+
267
+ /** Decay factor for invalid message penalties (P4) */
268
+ public readonly invalidDecay: number;
269
+
270
+ /** Number of heartbeats per slot */
271
+ public readonly heartbeatsPerSlot: number;
272
+
273
+ /** P1: Time in mesh quantum (slot duration in ms - score increases by ~1 per slot) */
274
+ public readonly timeInMeshQuantum: number;
275
+
276
+ /** P1: Time in mesh cap (number of slots to reach max score) */
277
+ public readonly timeInMeshCap: number;
278
+
279
+ /** P1: Time in mesh weight (normalized so max P1 = MAX_P1_SCORE) */
280
+ public readonly timeInMeshWeight: number;
281
+
282
+ /** P2: First message deliveries decay factor */
283
+ public readonly firstMessageDeliveriesDecay: number;
284
+
285
+ /** P2: First message deliveries cap (convergence-based) */
286
+ public readonly firstMessageDeliveriesCap: number;
287
+
288
+ /** P2: First message deliveries weight (normalized so max P2 = MAX_P2_SCORE) */
289
+ public readonly firstMessageDeliveriesWeight: number;
290
+
291
+ /** Base parameters common to all topics */
292
+ private readonly baseParams: {
293
+ topicWeight: number;
294
+ invalidMessageDeliveriesWeight: number;
295
+ invalidMessageDeliveriesDecay: number;
296
+ // P1: timeInMesh
297
+ timeInMeshQuantum: number;
298
+ timeInMeshCap: number;
299
+ timeInMeshWeight: number;
300
+ // P2: firstMessageDeliveries
301
+ firstMessageDeliveriesDecay: number;
302
+ firstMessageDeliveriesCap: number;
303
+ firstMessageDeliveriesWeight: number;
304
+ };
305
+
306
+ constructor(private readonly params: TopicScoringNetworkParams) {
307
+ const { slotDurationMs, heartbeatIntervalMs, blockDurationMs } = params;
308
+
309
+ // Compute values that are the same for all topics
310
+ this.blocksPerSlot = calculateBlocksPerSlot(slotDurationMs, blockDurationMs, {
311
+ ethereumSlotDuration: params.ethereumSlotDuration,
312
+ l1PublishingTime: params.l1PublishingTime,
313
+ p2pPropagationTime: params.p2pPropagationTime,
314
+ });
315
+ this.heartbeatsPerSlot = slotDurationMs / heartbeatIntervalMs;
316
+ this.invalidDecay = computeDecay(heartbeatIntervalMs, slotDurationMs, INVALID_DECAY_WINDOW_SLOTS);
317
+
318
+ // P1: timeInMesh - Lodestar style slot-based normalization
319
+ // quantum = slot duration, so score increases by ~1 per slot of mesh membership
320
+ // cap = number of slots in P1_CAP_TIME_SECONDS (1 hour)
321
+ // weight = MAX_P1_SCORE / cap, so max P1 = cap * weight = MAX_P1_SCORE
322
+ const slotDurationSeconds = slotDurationMs / 1000;
323
+ this.timeInMeshQuantum = slotDurationMs;
324
+ this.timeInMeshCap = P1_CAP_TIME_SECONDS / slotDurationSeconds;
325
+ this.timeInMeshWeight = MAX_P1_SCORE / this.timeInMeshCap;
326
+
327
+ // P2: firstMessageDeliveries - convergence-based cap with normalized weight
328
+ // Uses fast decay (2 slots) so it rewards recent first deliveries
329
+ // cap = convergence at 1 first delivery per heartbeat (theoretical max rate)
330
+ // weight = MAX_P2_SCORE / cap, so max P2 = cap * weight = MAX_P2_SCORE
331
+ this.firstMessageDeliveriesDecay = computeDecay(heartbeatIntervalMs, slotDurationMs, P2_DECAY_WINDOW_SLOTS);
332
+ // Convergence for 1 message per heartbeat (generous estimate for first deliveries)
333
+ this.firstMessageDeliveriesCap = computeConvergence(1, this.firstMessageDeliveriesDecay);
334
+ this.firstMessageDeliveriesWeight = MAX_P2_SCORE / this.firstMessageDeliveriesCap;
335
+
336
+ // Base params are identical for all topics
337
+ this.baseParams = {
338
+ topicWeight: 1,
339
+ invalidMessageDeliveriesWeight: INVALID_MESSAGE_WEIGHT,
340
+ invalidMessageDeliveriesDecay: this.invalidDecay,
341
+ // P1: timeInMesh (same for all topics)
342
+ timeInMeshQuantum: this.timeInMeshQuantum,
343
+ timeInMeshCap: this.timeInMeshCap,
344
+ timeInMeshWeight: this.timeInMeshWeight,
345
+ // P2: firstMessageDeliveries (same for all topics)
346
+ firstMessageDeliveriesDecay: this.firstMessageDeliveriesDecay,
347
+ firstMessageDeliveriesCap: this.firstMessageDeliveriesCap,
348
+ firstMessageDeliveriesWeight: this.firstMessageDeliveriesWeight,
349
+ };
350
+ }
351
+
352
+ /**
353
+ * Creates scoring parameters for topics with unpredictable or zero message rates.
354
+ * Disables P1, P2, P3, and P3b to avoid unbalanced positive score accumulation.
355
+ *
356
+ * Rationale: If P1/P2 were enabled without P3, the topic would contribute free
357
+ * positive scores that could offset penalties from other topics, preventing
358
+ * proper mesh pruning of non-contributing peers.
359
+ */
360
+ private createDisabledP3Params(): ReturnType<typeof createTopicScoreParams> {
361
+ return createTopicScoreParams({
362
+ topicWeight: 1,
363
+ // P1: timeInMesh - disabled (no free positive scores)
364
+ timeInMeshQuantum: 1,
365
+ timeInMeshCap: 0,
366
+ timeInMeshWeight: 0,
367
+ // P2: firstMessageDeliveries - disabled
368
+ firstMessageDeliveriesDecay: 0.5,
369
+ firstMessageDeliveriesCap: 0,
370
+ firstMessageDeliveriesWeight: 0,
371
+ // P3: meshMessageDeliveries - disabled
372
+ meshMessageDeliveriesWeight: 0,
373
+ meshMessageDeliveriesDecay: 0.5,
374
+ meshMessageDeliveriesThreshold: 0,
375
+ meshMessageDeliveriesWindow: 0,
376
+ meshMessageDeliveriesActivation: 0,
377
+ meshMessageDeliveriesCap: 0,
378
+ // P3b: meshFailurePenalty - disabled
379
+ meshFailurePenaltyWeight: 0,
380
+ meshFailurePenaltyDecay: 0.5,
381
+ // P4: invalidMessageDeliveries - still enabled for attack detection
382
+ invalidMessageDeliveriesWeight: INVALID_MESSAGE_WEIGHT,
383
+ invalidMessageDeliveriesDecay: this.invalidDecay,
384
+ });
385
+ }
386
+
387
+ /**
388
+ * Creates scoring parameters for topics with predictable message rates.
389
+ * Enables P1, P2, P3, and P3b for balanced scoring.
390
+ *
391
+ * The scoring is designed so that:
392
+ * - P1 + P2 max = 8 + 25 = 33 (positive rewards for good behavior)
393
+ * - P3 max = -34 (penalty exceeds P1+P2 to ensure pruning of non-contributors)
394
+ * - After pruning: P1 resets, P2 decays, P3b persists with slow decay
395
+ *
396
+ * @param expectedPerSlot - Expected messages per slot
397
+ */
398
+ private createEnabledP3Params(expectedPerSlot: number): ReturnType<typeof createTopicScoreParams> {
399
+ const { slotDurationMs, heartbeatIntervalMs } = this.params;
400
+
401
+ // Calculate decay based on message frequency
402
+ const decayWindowSlots = getDecayWindowSlots(expectedPerSlot);
403
+ const decay = computeDecay(heartbeatIntervalMs, slotDurationMs, decayWindowSlots);
404
+
405
+ // Calculate convergence and threshold
406
+ const messagesPerHeartbeat = expectedPerSlot / this.heartbeatsPerSlot;
407
+ const convergence = computeConvergence(messagesPerHeartbeat, decay);
408
+ const threshold = computeThreshold(convergence, CONSERVATIVE_FACTOR);
409
+
410
+ // Cap factor: higher for high-volume topics
411
+ const capFactor = expectedPerSlot > 10 ? 8 : 4;
412
+
413
+ // P3 Weight: scaled so max penalty = MAX_P3_PENALTY_PER_TOPIC (-34)
414
+ // When deficit = threshold (peer delivers nothing):
415
+ // penalty = deficit² × weight = threshold² × (MAX_P3_PENALTY_PER_TOPIC / threshold²) = MAX_P3_PENALTY_PER_TOPIC
416
+ const meshDeliveriesWeight = threshold > 0 ? MAX_P3_PENALTY_PER_TOPIC / (threshold * threshold) : 0;
417
+
418
+ // Activation time: use the decay window multiplied by ACTIVATION_MULTIPLIER for extra grace
419
+ // during network bootstrap. The timer starts from mesh join time, not from first message,
420
+ // so peers joining before messages flow need extra time to accumulate counter values.
421
+ const activationMs = slotDurationMs * decayWindowSlots * ACTIVATION_MULTIPLIER;
422
+
423
+ return createTopicScoreParams({
424
+ ...this.baseParams,
425
+ // P3: meshMessageDeliveries
426
+ meshMessageDeliveriesWeight: meshDeliveriesWeight,
427
+ meshMessageDeliveriesDecay: decay,
428
+ meshMessageDeliveriesThreshold: threshold,
429
+ meshMessageDeliveriesWindow: MESH_DELIVERIES_WINDOW_MS,
430
+ meshMessageDeliveriesActivation: activationMs,
431
+ meshMessageDeliveriesCap: Math.max(threshold * capFactor, 2),
432
+ // P3b: meshFailurePenalty (same weight and decay as P3)
433
+ meshFailurePenaltyWeight: meshDeliveriesWeight,
434
+ meshFailurePenaltyDecay: decay,
435
+ });
436
+ }
437
+
438
+ /** Number of topics with P3 enabled, computed from config. Always 2 (checkpoint_proposal + checkpoint_attestation) plus optionally block_proposal. */
439
+ get numP3EnabledTopics(): number {
440
+ const blockProposalP3Enabled =
441
+ getEffectiveBlockProposalsPerSlot(this.blocksPerSlot, this.params.expectedBlockProposalsPerSlot) !== undefined;
442
+ return blockProposalP3Enabled ? 3 : 2;
443
+ }
444
+
445
+ /** Total maximum P3b penalty across all topics after pruning, computed from config */
446
+ get totalMaxP3bPenalty(): number {
447
+ return MAX_P3_PENALTY_PER_TOPIC * this.numP3EnabledTopics;
448
+ }
449
+
450
+ /**
451
+ * Creates topic score parameters for a specific topic type.
452
+ *
453
+ * @param topicType - The topic type
454
+ * @returns TopicScoreParams for the topic
455
+ */
456
+ createForTopic(topicType: TopicType): ReturnType<typeof createTopicScoreParams> {
457
+ const expectedPerSlot = getExpectedMessagesPerSlot(
458
+ topicType,
459
+ this.params.targetCommitteeSize,
460
+ this.blocksPerSlot,
461
+ this.params.expectedBlockProposalsPerSlot,
462
+ );
463
+
464
+ // For unpredictable topics (tx) or topics with 0 expected messages, disable P3/P3b
465
+ if (expectedPerSlot === undefined || expectedPerSlot === 0) {
466
+ return this.createDisabledP3Params();
467
+ }
468
+
469
+ return this.createEnabledP3Params(expectedPerSlot);
470
+ }
471
+
472
+ /**
473
+ * Creates all topic score parameters for gossipsub configuration.
474
+ *
475
+ * @param protocolVersion - Protocol version string for topic naming
476
+ * @returns Record mapping topic strings to their score parameters
477
+ */
478
+ createAll(protocolVersion: string): Record<string, ReturnType<typeof createTopicScoreParams>> {
479
+ const topics: Record<string, ReturnType<typeof createTopicScoreParams>> = {};
480
+
481
+ for (const topicType of Object.values(TopicType)) {
482
+ const topicString = createTopicString(topicType, protocolVersion);
483
+ topics[topicString] = this.createForTopic(topicType);
484
+ }
485
+
486
+ return topics;
487
+ }
488
+ }
489
+
490
+ /**
491
+ * Creates topic score parameters for a specific topic type.
492
+ * Convenience function that creates a factory internally.
493
+ *
494
+ * @param topicType - The topic type
495
+ * @param params - Network parameters for scoring calculation
496
+ * @returns TopicScoreParams for the topic
497
+ */
498
+ export function createTopicScoreParamsForTopic(
499
+ topicType: TopicType,
500
+ params: TopicScoringNetworkParams,
501
+ ): ReturnType<typeof createTopicScoreParams> {
502
+ const factory = new TopicScoreParamsFactory(params);
503
+ return factory.createForTopic(topicType);
504
+ }
505
+
506
+ /**
507
+ * Creates all topic score parameters for gossipsub configuration.
508
+ *
509
+ * @param protocolVersion - Protocol version string for topic naming
510
+ * @param params - Network parameters for scoring calculation
511
+ * @returns Record mapping topic strings to their score parameters
512
+ */
513
+ export function createAllTopicScoreParams(
514
+ protocolVersion: string,
515
+ params: TopicScoringNetworkParams,
516
+ ): Record<string, ReturnType<typeof createTopicScoreParams>> {
517
+ const factory = new TopicScoreParamsFactory(params);
518
+ return factory.createAll(protocolVersion);
519
+ }
@@ -18,6 +18,7 @@ export class P2PInstrumentation {
18
18
  private messagePrevalidationCount: UpDownCounter;
19
19
  private messageLatency: Histogram;
20
20
  private txReceivedCount: UpDownCounter;
21
+ private slowValidationCount: UpDownCounter;
21
22
 
22
23
  private aggLatencyHisto = new Map<TopicType, RecordableHistogram>();
23
24
  private aggValidationHisto = new Map<TopicType, RecordableHistogram>();
@@ -48,6 +49,15 @@ export class P2PInstrumentation {
48
49
 
49
50
  this.txReceivedCount = createUpDownCounterWithDefault(meter, Metrics.P2P_GOSSIP_TX_RECEIVED_COUNT);
50
51
 
52
+ this.slowValidationCount = createUpDownCounterWithDefault(meter, Metrics.P2P_GOSSIP_SLOW_VALIDATION_COUNT, {
53
+ [Attributes.TOPIC_NAME]: [
54
+ TopicType.tx,
55
+ TopicType.block_proposal,
56
+ TopicType.checkpoint_proposal,
57
+ TopicType.checkpoint_attestation,
58
+ ],
59
+ });
60
+
51
61
  this.aggLatencyMetrics = {
52
62
  avg: meter.createObservableGauge(Metrics.P2P_GOSSIP_AGG_MESSAGE_LATENCY_AVG),
53
63
  max: meter.createObservableGauge(Metrics.P2P_GOSSIP_AGG_MESSAGE_LATENCY_MAX),
@@ -87,6 +97,10 @@ export class P2PInstrumentation {
87
97
  this.txReceivedCount.add(count);
88
98
  }
89
99
 
100
+ public incSlowValidation(topicName: TopicType) {
101
+ this.slowValidationCount.add(1, { [Attributes.TOPIC_NAME]: topicName });
102
+ }
103
+
90
104
  public incMessagePrevalidationStatus(passed: boolean, topicName: TopicType | undefined) {
91
105
  this.messagePrevalidationCount.add(1, { [Attributes.TOPIC_NAME]: topicName, [Attributes.OK]: passed });
92
106
  }