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

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 (188) hide show
  1. package/dest/client/factory.d.ts +3 -3
  2. package/dest/client/factory.d.ts.map +1 -1
  3. package/dest/client/factory.js +5 -3
  4. package/dest/client/interface.d.ts +9 -2
  5. package/dest/client/interface.d.ts.map +1 -1
  6. package/dest/client/p2p_client.d.ts +7 -4
  7. package/dest/client/p2p_client.d.ts.map +1 -1
  8. package/dest/client/p2p_client.js +22 -7
  9. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker.js +1 -1
  10. package/dest/config.d.ts +9 -3
  11. package/dest/config.d.ts.map +1 -1
  12. package/dest/config.js +3 -1
  13. package/dest/mem_pools/attestation_pool/attestation_pool.d.ts +94 -87
  14. package/dest/mem_pools/attestation_pool/attestation_pool.d.ts.map +1 -1
  15. package/dest/mem_pools/attestation_pool/attestation_pool.js +411 -3
  16. package/dest/mem_pools/attestation_pool/attestation_pool_test_suite.d.ts +2 -2
  17. package/dest/mem_pools/attestation_pool/attestation_pool_test_suite.d.ts.map +1 -1
  18. package/dest/mem_pools/attestation_pool/attestation_pool_test_suite.js +351 -85
  19. package/dest/mem_pools/attestation_pool/index.d.ts +2 -3
  20. package/dest/mem_pools/attestation_pool/index.d.ts.map +1 -1
  21. package/dest/mem_pools/attestation_pool/index.js +1 -2
  22. package/dest/mem_pools/index.d.ts +2 -2
  23. package/dest/mem_pools/index.d.ts.map +1 -1
  24. package/dest/mem_pools/index.js +1 -1
  25. package/dest/mem_pools/interface.d.ts +3 -3
  26. package/dest/mem_pools/interface.d.ts.map +1 -1
  27. package/dest/mem_pools/tx_pool_v2/archive/index.d.ts +2 -0
  28. package/dest/mem_pools/tx_pool_v2/archive/index.d.ts.map +1 -0
  29. package/dest/mem_pools/tx_pool_v2/archive/index.js +1 -0
  30. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.d.ts +43 -0
  31. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.d.ts.map +1 -0
  32. package/dest/mem_pools/tx_pool_v2/archive/tx_archive.js +103 -0
  33. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.d.ts +47 -0
  34. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.d.ts.map +1 -0
  35. package/dest/mem_pools/tx_pool_v2/eviction/eviction_manager.js +119 -0
  36. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.d.ts +17 -0
  37. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.d.ts.map +1 -0
  38. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.js +90 -0
  39. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.d.ts +19 -0
  40. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.d.ts.map +1 -0
  41. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.js +89 -0
  42. package/dest/mem_pools/tx_pool_v2/eviction/index.d.ts +10 -0
  43. package/dest/mem_pools/tx_pool_v2/eviction/index.d.ts.map +1 -0
  44. package/dest/mem_pools/tx_pool_v2/eviction/index.js +11 -0
  45. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.d.ts +131 -0
  46. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.d.ts.map +1 -0
  47. package/dest/mem_pools/tx_pool_v2/eviction/interfaces.js +17 -0
  48. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.d.ts +15 -0
  49. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.d.ts.map +1 -0
  50. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.js +63 -0
  51. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.d.ts +17 -0
  52. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.d.ts.map +1 -0
  53. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.js +91 -0
  54. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.d.ts +16 -0
  55. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.d.ts.map +1 -0
  56. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.js +70 -0
  57. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.d.ts +20 -0
  58. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.d.ts.map +1 -0
  59. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.js +63 -0
  60. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.d.ts +15 -0
  61. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.d.ts.map +1 -0
  62. package/dest/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.js +19 -0
  63. package/dest/mem_pools/tx_pool_v2/index.d.ts +5 -0
  64. package/dest/mem_pools/tx_pool_v2/index.d.ts.map +1 -0
  65. package/dest/mem_pools/tx_pool_v2/index.js +4 -0
  66. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts +197 -0
  67. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts.map +1 -0
  68. package/dest/mem_pools/tx_pool_v2/interfaces.js +6 -0
  69. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts +71 -0
  70. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts.map +1 -0
  71. package/dest/mem_pools/tx_pool_v2/tx_metadata.js +95 -0
  72. package/dest/mem_pools/tx_pool_v2/tx_pool_bench_metrics.d.ts +26 -0
  73. package/dest/mem_pools/tx_pool_v2/tx_pool_bench_metrics.d.ts.map +1 -0
  74. package/dest/mem_pools/tx_pool_v2/tx_pool_bench_metrics.js +70 -0
  75. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.d.ts +99 -0
  76. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.d.ts.map +1 -0
  77. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.js +332 -0
  78. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts +55 -0
  79. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts.map +1 -0
  80. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.js +156 -0
  81. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts +69 -0
  82. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts.map +1 -0
  83. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.js +748 -0
  84. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts +3 -3
  85. package/dest/msg_validators/attestation_validator/fisherman_attestation_validator.d.ts.map +1 -1
  86. package/dest/services/dummy_service.d.ts +6 -2
  87. package/dest/services/dummy_service.d.ts.map +1 -1
  88. package/dest/services/dummy_service.js +3 -0
  89. package/dest/services/index.d.ts +2 -1
  90. package/dest/services/index.d.ts.map +1 -1
  91. package/dest/services/index.js +1 -0
  92. package/dest/services/libp2p/libp2p_service.d.ts +74 -33
  93. package/dest/services/libp2p/libp2p_service.d.ts.map +1 -1
  94. package/dest/services/libp2p/libp2p_service.js +299 -228
  95. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts +4 -4
  96. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.d.ts.map +1 -1
  97. package/dest/services/reqresp/batch-tx-requester/batch_tx_requester.js +8 -8
  98. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts +6 -4
  99. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.d.ts.map +1 -1
  100. package/dest/services/reqresp/protocols/block_txs/block_txs_handler.js +16 -11
  101. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts +15 -10
  102. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.d.ts.map +1 -1
  103. package/dest/services/reqresp/protocols/block_txs/block_txs_reqresp.js +12 -11
  104. package/dest/services/service.d.ts +18 -1
  105. package/dest/services/service.d.ts.map +1 -1
  106. package/dest/services/tx_collection/config.d.ts +3 -3
  107. package/dest/services/tx_collection/config.js +3 -3
  108. package/dest/services/tx_collection/fast_tx_collection.d.ts +4 -5
  109. package/dest/services/tx_collection/fast_tx_collection.d.ts.map +1 -1
  110. package/dest/services/tx_collection/fast_tx_collection.js +10 -14
  111. package/dest/services/tx_collection/index.d.ts +1 -1
  112. package/dest/services/tx_collection/proposal_tx_collector.d.ts +12 -12
  113. package/dest/services/tx_collection/proposal_tx_collector.d.ts.map +1 -1
  114. package/dest/services/tx_collection/proposal_tx_collector.js +4 -5
  115. package/dest/services/tx_file_store/config.d.ts +18 -0
  116. package/dest/services/tx_file_store/config.d.ts.map +1 -0
  117. package/dest/services/tx_file_store/config.js +26 -0
  118. package/dest/services/tx_file_store/index.d.ts +4 -0
  119. package/dest/services/tx_file_store/index.d.ts.map +1 -0
  120. package/dest/services/tx_file_store/index.js +3 -0
  121. package/dest/services/tx_file_store/instrumentation.d.ts +15 -0
  122. package/dest/services/tx_file_store/instrumentation.d.ts.map +1 -0
  123. package/dest/services/tx_file_store/instrumentation.js +29 -0
  124. package/dest/services/tx_file_store/tx_file_store.d.ts +47 -0
  125. package/dest/services/tx_file_store/tx_file_store.d.ts.map +1 -0
  126. package/dest/services/tx_file_store/tx_file_store.js +149 -0
  127. package/dest/test-helpers/testbench-utils.d.ts +10 -16
  128. package/dest/test-helpers/testbench-utils.d.ts.map +1 -1
  129. package/dest/test-helpers/testbench-utils.js +32 -30
  130. package/dest/testbench/p2p_client_testbench_worker.js +1 -1
  131. package/package.json +14 -14
  132. package/src/client/factory.ts +7 -4
  133. package/src/client/interface.ts +13 -1
  134. package/src/client/p2p_client.ts +30 -8
  135. package/src/client/test/tx_proposal_collector/proposal_tx_collector_worker.ts +1 -1
  136. package/src/config.ts +8 -1
  137. package/src/mem_pools/attestation_pool/attestation_pool.ts +444 -90
  138. package/src/mem_pools/attestation_pool/attestation_pool_test_suite.ts +436 -100
  139. package/src/mem_pools/attestation_pool/index.ts +9 -2
  140. package/src/mem_pools/index.ts +1 -1
  141. package/src/mem_pools/interface.ts +2 -2
  142. package/src/mem_pools/tx_pool_v2/README.md +209 -0
  143. package/src/mem_pools/tx_pool_v2/archive/index.ts +1 -0
  144. package/src/mem_pools/tx_pool_v2/archive/tx_archive.ts +120 -0
  145. package/src/mem_pools/tx_pool_v2/eviction/eviction_manager.ts +147 -0
  146. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.ts +118 -0
  147. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.ts +111 -0
  148. package/src/mem_pools/tx_pool_v2/eviction/index.ts +23 -0
  149. package/src/mem_pools/tx_pool_v2/eviction/interfaces.ts +164 -0
  150. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_mining_rule.ts +74 -0
  151. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.ts +101 -0
  152. package/src/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.ts +86 -0
  153. package/src/mem_pools/tx_pool_v2/eviction/low_priority_pre_add_rule.ts +72 -0
  154. package/src/mem_pools/tx_pool_v2/eviction/nullifier_conflict_rule.ts +31 -0
  155. package/src/mem_pools/tx_pool_v2/index.ts +11 -0
  156. package/src/mem_pools/tx_pool_v2/interfaces.ts +227 -0
  157. package/src/mem_pools/tx_pool_v2/tx_metadata.ts +161 -0
  158. package/src/mem_pools/tx_pool_v2/tx_pool_bench_metrics.ts +77 -0
  159. package/src/mem_pools/tx_pool_v2/tx_pool_indices.ts +417 -0
  160. package/src/mem_pools/tx_pool_v2/tx_pool_v2.ts +212 -0
  161. package/src/mem_pools/tx_pool_v2/tx_pool_v2_impl.ts +882 -0
  162. package/src/msg_validators/attestation_validator/fisherman_attestation_validator.ts +2 -2
  163. package/src/services/dummy_service.ts +6 -0
  164. package/src/services/index.ts +1 -0
  165. package/src/services/libp2p/libp2p_service.ts +304 -230
  166. package/src/services/reqresp/batch-tx-requester/README.md +7 -7
  167. package/src/services/reqresp/batch-tx-requester/batch_tx_requester.ts +11 -11
  168. package/src/services/reqresp/protocols/block_txs/block_txs_handler.ts +22 -13
  169. package/src/services/reqresp/protocols/block_txs/block_txs_reqresp.ts +21 -15
  170. package/src/services/service.ts +20 -0
  171. package/src/services/tx_collection/config.ts +6 -6
  172. package/src/services/tx_collection/fast_tx_collection.ts +14 -24
  173. package/src/services/tx_collection/index.ts +1 -1
  174. package/src/services/tx_collection/proposal_tx_collector.ts +12 -14
  175. package/src/services/tx_file_store/config.ts +43 -0
  176. package/src/services/tx_file_store/index.ts +3 -0
  177. package/src/services/tx_file_store/instrumentation.ts +36 -0
  178. package/src/services/tx_file_store/tx_file_store.ts +173 -0
  179. package/src/test-helpers/testbench-utils.ts +18 -39
  180. package/src/testbench/p2p_client_testbench_worker.ts +1 -1
  181. package/dest/mem_pools/attestation_pool/kv_attestation_pool.d.ts +0 -40
  182. package/dest/mem_pools/attestation_pool/kv_attestation_pool.d.ts.map +0 -1
  183. package/dest/mem_pools/attestation_pool/kv_attestation_pool.js +0 -218
  184. package/dest/mem_pools/attestation_pool/memory_attestation_pool.d.ts +0 -31
  185. package/dest/mem_pools/attestation_pool/memory_attestation_pool.d.ts.map +0 -1
  186. package/dest/mem_pools/attestation_pool/memory_attestation_pool.js +0 -180
  187. package/src/mem_pools/attestation_pool/kv_attestation_pool.ts +0 -320
  188. package/src/mem_pools/attestation_pool/memory_attestation_pool.ts +0 -264
@@ -1,180 +0,0 @@
1
- import { createLogger } from '@aztec/foundation/log';
2
- import { getTelemetryClient } from '@aztec/telemetry-client';
3
- import { ProposalSlotCapExceededError } from '../../errors/attestation-pool.error.js';
4
- import { PoolInstrumentation, PoolName } from '../instrumentation.js';
5
- import { ATTESTATION_CAP_BUFFER, MAX_PROPOSALS_PER_SLOT } from './kv_attestation_pool.js';
6
- export class InMemoryAttestationPool {
7
- log;
8
- metrics;
9
- proposals;
10
- // Checkpoint attestations
11
- // eslint-disable-next-line aztec-custom/no-non-primitive-in-collections
12
- checkpointAttestations;
13
- checkpointProposals;
14
- constructor(telemetry = getTelemetryClient(), log = createLogger('p2p:attestation_pool')){
15
- this.log = log;
16
- this.poolStats = ()=>{
17
- return Promise.resolve({
18
- itemCount: this.checkpointAttestations.size
19
- });
20
- };
21
- this.proposals = new Map();
22
- this.checkpointAttestations = new Map();
23
- this.checkpointProposals = new Map();
24
- this.metrics = new PoolInstrumentation(telemetry, PoolName.ATTESTATION_POOL, this.poolStats);
25
- }
26
- poolStats;
27
- isEmpty() {
28
- return Promise.resolve(this.checkpointAttestations.size === 0 && this.proposals.size === 0);
29
- }
30
- addBlockProposal(blockProposal) {
31
- // Strip signedTxs before storing to avoid holding full tx data in memory
32
- this.proposals.set(blockProposal.archive.toString(), blockProposal.withoutSignedTxs());
33
- return Promise.resolve();
34
- }
35
- getBlockProposal(id) {
36
- return Promise.resolve(this.proposals.get(id));
37
- }
38
- hasBlockProposal(idOrProposal) {
39
- const id = typeof idOrProposal === 'string' ? idOrProposal : idOrProposal.archive.toString();
40
- return Promise.resolve(this.proposals.has(id));
41
- }
42
- canAddProposal(_block) {
43
- // TODO(palla/mbps): See when to allow
44
- return Promise.resolve(true);
45
- }
46
- // Checkpoint attestation methods
47
- async addCheckpointProposal(proposal) {
48
- if (!await this.canAddCheckpointProposal(proposal)) {
49
- throw new ProposalSlotCapExceededError(`Maximum checkpoint proposals per slot reached: slot=${proposal.slotNumber} cap=${MAX_PROPOSALS_PER_SLOT} proposal=${proposal.archive.toString()}`);
50
- }
51
- // Extract and validate the block proposal if present
52
- const blockProposal = proposal.getBlockProposal();
53
- if (blockProposal && !await this.canAddProposal(blockProposal)) {
54
- throw new ProposalSlotCapExceededError(`Maximum block proposals per slot reached when extracting from checkpoint: slot=${proposal.slotNumber} proposal=${blockProposal.archive.toString()}`);
55
- }
56
- const slotProposalMapping = getCheckpointSlotOrDefault(this.checkpointAttestations, proposal.slotNumber);
57
- slotProposalMapping.set(proposal.archive.toString(), new Map());
58
- // Store the checkpoint proposal as core (without lastBlock) to avoid duplication
59
- this.checkpointProposals.set(proposal.archive.toString(), proposal.toCore());
60
- // Store the extracted block proposal separately
61
- if (blockProposal) {
62
- this.proposals.set(blockProposal.archive.toString(), blockProposal.withoutSignedTxs());
63
- }
64
- return Promise.resolve();
65
- }
66
- getCheckpointProposal(id) {
67
- return Promise.resolve(this.checkpointProposals.get(id));
68
- }
69
- hasCheckpointProposal(idOrProposal) {
70
- const id = typeof idOrProposal === 'string' ? idOrProposal : idOrProposal.archive.toString();
71
- return Promise.resolve(this.checkpointProposals.has(id));
72
- }
73
- addCheckpointAttestations(attestations) {
74
- for (const attestation of attestations){
75
- const slotNumber = attestation.payload.header.slotNumber;
76
- const proposalId = attestation.archive.toString();
77
- const sender = attestation.getSender();
78
- // Skip attestations with invalid signatures
79
- if (!sender) {
80
- this.log.warn(`Skipping checkpoint attestation with invalid signature for slot ${slotNumber}`, {
81
- signature: attestation.signature.toString(),
82
- slotNumber,
83
- proposalId
84
- });
85
- continue;
86
- }
87
- const slotAttestationMap = getCheckpointSlotOrDefault(this.checkpointAttestations, slotNumber);
88
- const proposalAttestationMap = getCheckpointProposalOrDefault(slotAttestationMap, proposalId);
89
- proposalAttestationMap.set(sender.toString(), attestation);
90
- this.log.verbose(`Added checkpoint attestation for slot ${slotNumber} from ${sender}`, {
91
- signature: attestation.signature.toString(),
92
- slotNumber,
93
- address: sender,
94
- proposalId
95
- });
96
- }
97
- return Promise.resolve();
98
- }
99
- getCheckpointAttestationsForSlot(slot) {
100
- return Promise.resolve(Array.from(this.checkpointAttestations.get(slot)?.values() ?? []).flatMap((proposalAttestationMap)=>Array.from(proposalAttestationMap.values())));
101
- }
102
- getCheckpointAttestationsForSlotAndProposal(slot, proposalId) {
103
- const slotAttestationMap = this.checkpointAttestations.get(slot);
104
- if (slotAttestationMap) {
105
- const proposalAttestationMap = slotAttestationMap.get(proposalId);
106
- if (proposalAttestationMap) {
107
- return Promise.resolve(Array.from(proposalAttestationMap.values()));
108
- }
109
- }
110
- return Promise.resolve([]);
111
- }
112
- deleteCheckpointAttestationsOlderThan(oldestSlot) {
113
- const olderThan = [];
114
- const slots = this.checkpointAttestations.keys();
115
- for (const slot of slots){
116
- if (slot < oldestSlot) {
117
- olderThan.push(slot);
118
- } else {
119
- break;
120
- }
121
- }
122
- for (const oldSlot of olderThan){
123
- const proposalIds = this.checkpointAttestations.get(oldSlot)?.keys();
124
- proposalIds?.forEach((proposalId)=>this.checkpointProposals.delete(proposalId));
125
- this.checkpointAttestations.delete(oldSlot);
126
- }
127
- return Promise.resolve();
128
- }
129
- hasReachedCheckpointProposalCap(slot) {
130
- const slotAttestationMap = this.checkpointAttestations.get(slot);
131
- const proposalCount = slotAttestationMap?.size ?? 0;
132
- return Promise.resolve(proposalCount >= MAX_PROPOSALS_PER_SLOT);
133
- }
134
- hasReachedCheckpointAttestationCap(slot, proposalId, committeeSize) {
135
- const limit = committeeSize + ATTESTATION_CAP_BUFFER;
136
- const count = this.checkpointAttestations.get(slot)?.get(proposalId)?.size ?? 0;
137
- return Promise.resolve(limit <= 0 || count >= limit);
138
- }
139
- async canAddCheckpointProposal(proposal) {
140
- return this.checkpointProposals.has(proposal.archive.toString()) || !await this.hasReachedCheckpointProposalCap(proposal.slotNumber);
141
- }
142
- async canAddCheckpointAttestation(attestation, committeeSize) {
143
- const sender = attestation.getSender();
144
- const slot = attestation.payload.header.slotNumber;
145
- const pid = attestation.archive.toString();
146
- return !!sender && ((this.checkpointAttestations.get(slot)?.get(pid)?.has(sender.toString()) ?? false) || !await this.hasReachedCheckpointAttestationCap(slot, pid, committeeSize));
147
- }
148
- hasCheckpointAttestation(attestation) {
149
- const slotNumber = attestation.payload.header.slotNumber;
150
- const proposalId = attestation.archive.toString();
151
- const sender = attestation.getSender();
152
- // Attestations with invalid signatures are never in the pool
153
- if (!sender) {
154
- return Promise.resolve(false);
155
- }
156
- const slotAttestationMap = this.checkpointAttestations.get(slotNumber);
157
- if (!slotAttestationMap) {
158
- return Promise.resolve(false);
159
- }
160
- const proposalAttestationMap = slotAttestationMap.get(proposalId);
161
- if (!proposalAttestationMap) {
162
- return Promise.resolve(false);
163
- }
164
- return Promise.resolve(proposalAttestationMap.has(sender.toString()));
165
- }
166
- }
167
- // Checkpoint attestation helper functions
168
- function getCheckpointSlotOrDefault(// eslint-disable-next-line aztec-custom/no-non-primitive-in-collections
169
- map, slot) {
170
- if (!map.has(slot)) {
171
- map.set(slot, new Map());
172
- }
173
- return map.get(slot);
174
- }
175
- function getCheckpointProposalOrDefault(map, proposalId) {
176
- if (!map.has(proposalId)) {
177
- map.set(proposalId, new Map());
178
- }
179
- return map.get(proposalId);
180
- }
@@ -1,320 +0,0 @@
1
- import { SlotNumber } from '@aztec/foundation/branded-types';
2
- import { Fr } from '@aztec/foundation/curves/bn254';
3
- import { toArray } from '@aztec/foundation/iterable';
4
- import { createLogger } from '@aztec/foundation/log';
5
- import type { AztecAsyncKVStore, AztecAsyncMap, AztecAsyncMultiMap } from '@aztec/kv-store';
6
- import {
7
- BlockProposal,
8
- CheckpointAttestation,
9
- CheckpointProposal,
10
- type CheckpointProposalCore,
11
- } from '@aztec/stdlib/p2p';
12
- import { type TelemetryClient, getTelemetryClient } from '@aztec/telemetry-client';
13
-
14
- import { ProposalSlotCapExceededError } from '../../errors/attestation-pool.error.js';
15
- import { PoolInstrumentation, PoolName, type PoolStatsCallback } from '../instrumentation.js';
16
- import type { AttestationPool } from './attestation_pool.js';
17
-
18
- export const MAX_PROPOSALS_PER_SLOT = 5;
19
- export const ATTESTATION_CAP_BUFFER = 10;
20
-
21
- export class KvAttestationPool implements AttestationPool {
22
- private metrics: PoolInstrumentation<CheckpointAttestation>;
23
-
24
- private proposals: AztecAsyncMap<
25
- /* proposal.payload.archive */ string,
26
- /* buffer representation of proposal */ Buffer
27
- >;
28
-
29
- // Checkpoint attestation storage
30
- private checkpointAttestations: AztecAsyncMap<string, Buffer>;
31
- private checkpointProposals: AztecAsyncMap<string, Buffer>;
32
- private checkpointProposalsForSlot: AztecAsyncMultiMap<number, string>;
33
- private checkpointAttestationsForProposal: AztecAsyncMultiMap<string, string>;
34
-
35
- constructor(
36
- private store: AztecAsyncKVStore,
37
- telemetry: TelemetryClient = getTelemetryClient(),
38
- private log = createLogger('aztec:attestation_pool'),
39
- ) {
40
- this.proposals = store.openMap('proposals');
41
-
42
- // Initialize checkpoint attestation storage
43
- this.checkpointAttestations = store.openMap('checkpoint_attestations');
44
- this.checkpointProposals = store.openMap('checkpoint_proposals');
45
- this.checkpointProposalsForSlot = store.openMultiMap('checkpoint_proposals_for_slot');
46
- this.checkpointAttestationsForProposal = store.openMultiMap('checkpoint_attestations_for_proposal');
47
-
48
- this.metrics = new PoolInstrumentation(telemetry, PoolName.ATTESTATION_POOL, this.poolStats);
49
- }
50
-
51
- private poolStats: PoolStatsCallback = async () => {
52
- return {
53
- itemCount: await this.checkpointAttestations.sizeAsync(),
54
- };
55
- };
56
-
57
- public async isEmpty(): Promise<boolean> {
58
- for await (const _ of this.checkpointAttestations.entriesAsync()) {
59
- return false;
60
- }
61
- for await (const _ of this.proposals.entriesAsync()) {
62
- return false;
63
- }
64
- return true;
65
- }
66
-
67
- private getProposalKey(slot: number | bigint | Fr | string, proposalId: Fr | string | Buffer): string {
68
- const slotStr = typeof slot === 'string' ? slot : new Fr(slot).toString();
69
- const proposalIdStr =
70
- typeof proposalId === 'string'
71
- ? proposalId
72
- : Buffer.isBuffer(proposalId)
73
- ? Fr.fromBuffer(proposalId).toString()
74
- : proposalId.toString();
75
-
76
- return `${slotStr}-${proposalIdStr}`;
77
- }
78
-
79
- private getAttestationKey(slot: number | bigint | Fr | string, proposalId: Fr | string, address: string): string {
80
- return `${this.getProposalKey(slot, proposalId)}-${address}`;
81
- }
82
-
83
- public async addBlockProposal(blockProposal: BlockProposal): Promise<void> {
84
- await this.store.transactionAsync(async () => {
85
- const proposalId = blockProposal.archive.toString();
86
- // Strip signedTxs before storing to avoid persisting full tx data
87
- await this.proposals.set(proposalId, blockProposal.withoutSignedTxs().toBuffer());
88
- });
89
- }
90
-
91
- public async getBlockProposal(id: string): Promise<BlockProposal | undefined> {
92
- const buffer = await this.proposals.getAsync(id);
93
- try {
94
- if (buffer && buffer.length > 0) {
95
- return BlockProposal.fromBuffer(buffer);
96
- }
97
- } catch {
98
- return Promise.resolve(undefined);
99
- }
100
-
101
- return Promise.resolve(undefined);
102
- }
103
-
104
- public async hasBlockProposal(idOrProposal: string | BlockProposal): Promise<boolean> {
105
- const id = typeof idOrProposal === 'string' ? idOrProposal : idOrProposal.archive.toString();
106
- return await this.proposals.hasAsync(id);
107
- }
108
-
109
- public async addCheckpointProposal(proposal: CheckpointProposal): Promise<void> {
110
- if (!(await this.canAddCheckpointProposal(proposal))) {
111
- throw new ProposalSlotCapExceededError(
112
- `Maximum checkpoint proposals per slot reached: slot=${proposal.slotNumber} cap=${MAX_PROPOSALS_PER_SLOT} proposal=${proposal.archive.toString()}`,
113
- );
114
- }
115
-
116
- // Extract and validate the block proposal if present
117
- const blockProposal = proposal.getBlockProposal();
118
- if (blockProposal && !(await this.canAddProposal(blockProposal))) {
119
- throw new ProposalSlotCapExceededError(
120
- `Maximum block proposals per slot reached when extracting from checkpoint: slot=${proposal.slotNumber} proposal=${blockProposal.archive.toString()}`,
121
- );
122
- }
123
-
124
- await this.store.transactionAsync(async () => {
125
- const slotKey = proposal.slotNumber;
126
- const proposalId = proposal.archive.toString();
127
-
128
- await this.checkpointProposalsForSlot.set(slotKey, proposalId);
129
- // Store the checkpoint proposal as core (without lastBlock) to avoid duplication
130
- await this.checkpointProposals.set(proposalId, proposal.toCore().toBuffer());
131
-
132
- // Store the extracted block proposal separately
133
- if (blockProposal) {
134
- await this.proposals.set(blockProposal.archive.toString(), blockProposal.withoutSignedTxs().toBuffer());
135
- }
136
- });
137
- }
138
-
139
- public async getCheckpointProposal(id: string): Promise<CheckpointProposalCore | undefined> {
140
- const buffer = await this.checkpointProposals.getAsync(id);
141
- try {
142
- if (buffer && buffer.length > 0) {
143
- return CheckpointProposal.fromBuffer(buffer);
144
- }
145
- } catch {
146
- return Promise.resolve(undefined);
147
- }
148
-
149
- return Promise.resolve(undefined);
150
- }
151
-
152
- public async hasCheckpointProposal(idOrProposal: string | CheckpointProposal): Promise<boolean> {
153
- const id = typeof idOrProposal === 'string' ? idOrProposal : idOrProposal.archive.toString();
154
- return await this.checkpointProposals.hasAsync(id);
155
- }
156
-
157
- public async addCheckpointAttestations(attestations: CheckpointAttestation[]): Promise<void> {
158
- await this.store.transactionAsync(async () => {
159
- for (const attestation of attestations) {
160
- const slotNumber = attestation.payload.header.slotNumber;
161
- const proposalId = attestation.archive;
162
- const sender = attestation.getSender();
163
-
164
- // Skip attestations with invalid signatures
165
- if (!sender) {
166
- this.log.warn(`Skipping checkpoint attestation with invalid signature for slot ${slotNumber}`, {
167
- signature: attestation.signature.toString(),
168
- slotNumber,
169
- proposalId,
170
- });
171
- continue;
172
- }
173
-
174
- const address = sender.toString();
175
-
176
- await this.checkpointAttestations.set(
177
- this.getAttestationKey(slotNumber, proposalId, address),
178
- attestation.toBuffer(),
179
- );
180
-
181
- await this.checkpointProposalsForSlot.set(slotNumber, proposalId.toString());
182
- await this.checkpointAttestationsForProposal.set(
183
- this.getProposalKey(slotNumber, proposalId),
184
- this.getAttestationKey(slotNumber, proposalId, address),
185
- );
186
-
187
- this.log.verbose(`Added checkpoint attestation for slot ${slotNumber} from ${address}`, {
188
- signature: attestation.signature.toString(),
189
- slotNumber,
190
- address,
191
- proposalId,
192
- });
193
- }
194
- });
195
- }
196
-
197
- public async getCheckpointAttestationsForSlot(slot: SlotNumber): Promise<CheckpointAttestation[]> {
198
- const proposalIds = await toArray(this.checkpointProposalsForSlot.getValuesAsync(slot));
199
- const attestations: CheckpointAttestation[] = [];
200
-
201
- for (const proposalId of proposalIds) {
202
- attestations.push(...(await this.getCheckpointAttestationsForSlotAndProposal(slot, proposalId)));
203
- }
204
-
205
- return attestations;
206
- }
207
-
208
- public async getCheckpointAttestationsForSlotAndProposal(
209
- slot: SlotNumber,
210
- proposalId: string,
211
- ): Promise<CheckpointAttestation[]> {
212
- const attestationIds = await toArray(
213
- this.checkpointAttestationsForProposal.getValuesAsync(this.getProposalKey(slot, proposalId)),
214
- );
215
- const attestations: CheckpointAttestation[] = [];
216
-
217
- for (const id of attestationIds) {
218
- const buf = await this.checkpointAttestations.getAsync(id);
219
-
220
- if (!buf) {
221
- throw new Error('Checkpoint attestation not found ' + id);
222
- }
223
-
224
- const attestation = CheckpointAttestation.fromBuffer(buf);
225
- attestations.push(attestation);
226
- }
227
-
228
- return attestations;
229
- }
230
-
231
- public async deleteCheckpointAttestationsOlderThan(oldestSlot: SlotNumber): Promise<void> {
232
- const olderThan = await toArray(this.checkpointProposalsForSlot.keysAsync({ end: oldestSlot }));
233
- for (const oldSlot of olderThan) {
234
- await this.deleteCheckpointAttestationsForSlot(SlotNumber(oldSlot));
235
- }
236
- }
237
-
238
- private async deleteCheckpointAttestationsForSlot(slot: SlotNumber): Promise<void> {
239
- let numberOfAttestations = 0;
240
- await this.store.transactionAsync(async () => {
241
- const proposalIds = await toArray(this.checkpointProposalsForSlot.getValuesAsync(slot));
242
- for (const proposalId of proposalIds) {
243
- const attestations = await toArray(
244
- this.checkpointAttestationsForProposal.getValuesAsync(this.getProposalKey(slot, proposalId)),
245
- );
246
-
247
- numberOfAttestations += attestations.length;
248
- for (const attestation of attestations) {
249
- await this.checkpointAttestations.delete(attestation);
250
- }
251
-
252
- await this.checkpointProposals.delete(proposalId);
253
- await this.checkpointAttestationsForProposal.delete(this.getProposalKey(slot, proposalId));
254
- }
255
-
256
- await this.checkpointProposalsForSlot.delete(slot);
257
-
258
- this.log.verbose(`Removed ${numberOfAttestations} checkpoint attestations for slot ${slot}`);
259
- });
260
- }
261
-
262
- public async hasCheckpointAttestation(attestation: CheckpointAttestation): Promise<boolean> {
263
- const slotNumber = attestation.payload.header.slotNumber;
264
- const proposalId = attestation.archive;
265
- const sender = attestation.getSender();
266
-
267
- // Attestations with invalid signatures are never in the pool
268
- if (!sender) {
269
- return false;
270
- }
271
-
272
- const address = sender.toString();
273
- const key = this.getAttestationKey(slotNumber, proposalId, address);
274
-
275
- return await this.checkpointAttestations.hasAsync(key);
276
- }
277
-
278
- public canAddProposal(_block: BlockProposal): Promise<boolean> {
279
- // TODO(palla/mbps): implement proposal cap logic
280
- return Promise.resolve(true);
281
- }
282
-
283
- public async canAddCheckpointProposal(proposal: CheckpointProposal): Promise<boolean> {
284
- // TODO(palla/mbps): Adjust checkpoint proposal limit to 1. Also connect to slashing condition in the caller.
285
- return (
286
- (await this.checkpointProposals.hasAsync(proposal.archive.toString())) ||
287
- !(await this.hasReachedCheckpointProposalCap(proposal.slotNumber))
288
- );
289
- }
290
-
291
- public async canAddCheckpointAttestation(
292
- attestation: CheckpointAttestation,
293
- committeeSize: number,
294
- ): Promise<boolean> {
295
- return (
296
- (await this.hasCheckpointAttestation(attestation)) ||
297
- !(await this.hasReachedCheckpointAttestationCap(
298
- attestation.payload.header.slotNumber,
299
- attestation.archive.toString(),
300
- committeeSize,
301
- ))
302
- );
303
- }
304
-
305
- public async hasReachedCheckpointProposalCap(slot: SlotNumber): Promise<boolean> {
306
- const uniqueProposalCount = await this.checkpointProposalsForSlot.getValueCountAsync(slot);
307
- return uniqueProposalCount >= MAX_PROPOSALS_PER_SLOT;
308
- }
309
-
310
- public async hasReachedCheckpointAttestationCap(
311
- slot: SlotNumber,
312
- proposalId: string,
313
- committeeSize: number,
314
- ): Promise<boolean> {
315
- const limit = committeeSize + ATTESTATION_CAP_BUFFER;
316
- return (
317
- (await this.checkpointAttestationsForProposal.getValueCountAsync(this.getProposalKey(slot, proposalId))) >= limit
318
- );
319
- }
320
- }