@aztec/p2p 4.0.0-rc.4 → 4.0.0-rc.6

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 (100) hide show
  1. package/dest/client/factory.d.ts +1 -1
  2. package/dest/client/factory.d.ts.map +1 -1
  3. package/dest/client/factory.js +8 -20
  4. package/dest/client/interface.d.ts +6 -11
  5. package/dest/client/interface.d.ts.map +1 -1
  6. package/dest/client/p2p_client.d.ts +4 -11
  7. package/dest/client/p2p_client.d.ts.map +1 -1
  8. package/dest/client/p2p_client.js +5 -57
  9. package/dest/client/test/tx_proposal_collector/proposal_tx_collector_worker.js +1 -2
  10. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.js +1 -1
  11. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.d.ts +1 -1
  12. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.d.ts.map +1 -1
  13. package/dest/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.js +2 -0
  14. package/dest/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.js +2 -2
  15. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.d.ts +2 -2
  16. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.d.ts.map +1 -1
  17. package/dest/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.js +10 -6
  18. package/dest/mem_pools/tx_pool_v2/index.d.ts +2 -2
  19. package/dest/mem_pools/tx_pool_v2/index.d.ts.map +1 -1
  20. package/dest/mem_pools/tx_pool_v2/index.js +1 -1
  21. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts +5 -5
  22. package/dest/mem_pools/tx_pool_v2/interfaces.d.ts.map +1 -1
  23. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts +26 -4
  24. package/dest/mem_pools/tx_pool_v2/tx_metadata.d.ts.map +1 -1
  25. package/dest/mem_pools/tx_pool_v2/tx_metadata.js +48 -7
  26. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.d.ts +1 -1
  27. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.d.ts.map +1 -1
  28. package/dest/mem_pools/tx_pool_v2/tx_pool_indices.js +9 -10
  29. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts +2 -2
  30. package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts.map +1 -1
  31. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts +2 -2
  32. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts.map +1 -1
  33. package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.js +166 -146
  34. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts +2 -2
  35. package/dest/msg_validators/tx_validator/aggregate_tx_validator.d.ts.map +1 -1
  36. package/dest/msg_validators/tx_validator/aggregate_tx_validator.js +3 -3
  37. package/dest/msg_validators/tx_validator/factory.d.ts +114 -6
  38. package/dest/msg_validators/tx_validator/factory.d.ts.map +1 -1
  39. package/dest/msg_validators/tx_validator/factory.js +219 -58
  40. package/dest/msg_validators/tx_validator/gas_validator.d.ts +58 -3
  41. package/dest/msg_validators/tx_validator/gas_validator.d.ts.map +1 -1
  42. package/dest/msg_validators/tx_validator/gas_validator.js +73 -36
  43. package/dest/msg_validators/tx_validator/index.d.ts +2 -1
  44. package/dest/msg_validators/tx_validator/index.d.ts.map +1 -1
  45. package/dest/msg_validators/tx_validator/index.js +1 -0
  46. package/dest/msg_validators/tx_validator/nullifier_cache.d.ts +14 -0
  47. package/dest/msg_validators/tx_validator/nullifier_cache.d.ts.map +1 -0
  48. package/dest/msg_validators/tx_validator/nullifier_cache.js +24 -0
  49. package/dest/services/dummy_service.d.ts +4 -4
  50. package/dest/services/dummy_service.d.ts.map +1 -1
  51. package/dest/services/dummy_service.js +4 -4
  52. package/dest/services/encoding.d.ts +2 -2
  53. package/dest/services/encoding.d.ts.map +1 -1
  54. package/dest/services/encoding.js +7 -7
  55. package/dest/services/libp2p/libp2p_service.d.ts +11 -7
  56. package/dest/services/libp2p/libp2p_service.d.ts.map +1 -1
  57. package/dest/services/libp2p/libp2p_service.js +60 -70
  58. package/dest/services/reqresp/batch-tx-requester/tx_validator.js +2 -2
  59. package/dest/services/service.d.ts +5 -3
  60. package/dest/services/service.d.ts.map +1 -1
  61. package/dest/services/tx_provider.d.ts +3 -3
  62. package/dest/services/tx_provider.d.ts.map +1 -1
  63. package/dest/services/tx_provider.js +4 -4
  64. package/dest/test-helpers/mock-pubsub.d.ts +3 -2
  65. package/dest/test-helpers/mock-pubsub.d.ts.map +1 -1
  66. package/dest/test-helpers/mock-pubsub.js +6 -0
  67. package/dest/test-helpers/testbench-utils.d.ts +2 -2
  68. package/dest/test-helpers/testbench-utils.d.ts.map +1 -1
  69. package/dest/util.d.ts +2 -2
  70. package/dest/util.d.ts.map +1 -1
  71. package/package.json +14 -14
  72. package/src/client/factory.ts +13 -33
  73. package/src/client/interface.ts +12 -11
  74. package/src/client/p2p_client.ts +7 -76
  75. package/src/client/test/tx_proposal_collector/proposal_tx_collector_worker.ts +1 -1
  76. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_eviction_rule.ts +1 -1
  77. package/src/mem_pools/tx_pool_v2/eviction/fee_payer_balance_pre_add_rule.ts +3 -0
  78. package/src/mem_pools/tx_pool_v2/eviction/invalid_txs_after_reorg_rule.ts +2 -2
  79. package/src/mem_pools/tx_pool_v2/eviction/low_priority_eviction_rule.ts +10 -6
  80. package/src/mem_pools/tx_pool_v2/index.ts +1 -1
  81. package/src/mem_pools/tx_pool_v2/interfaces.ts +4 -4
  82. package/src/mem_pools/tx_pool_v2/tx_metadata.ts +65 -10
  83. package/src/mem_pools/tx_pool_v2/tx_pool_indices.ts +11 -11
  84. package/src/mem_pools/tx_pool_v2/tx_pool_v2.ts +1 -1
  85. package/src/mem_pools/tx_pool_v2/tx_pool_v2_impl.ts +173 -148
  86. package/src/msg_validators/tx_validator/README.md +115 -0
  87. package/src/msg_validators/tx_validator/aggregate_tx_validator.ts +3 -3
  88. package/src/msg_validators/tx_validator/factory.ts +353 -77
  89. package/src/msg_validators/tx_validator/gas_validator.ts +90 -27
  90. package/src/msg_validators/tx_validator/index.ts +1 -0
  91. package/src/msg_validators/tx_validator/nullifier_cache.ts +30 -0
  92. package/src/services/dummy_service.ts +6 -6
  93. package/src/services/encoding.ts +5 -6
  94. package/src/services/libp2p/libp2p_service.ts +74 -79
  95. package/src/services/reqresp/batch-tx-requester/tx_validator.ts +2 -2
  96. package/src/services/service.ts +11 -2
  97. package/src/services/tx_provider.ts +2 -2
  98. package/src/test-helpers/mock-pubsub.ts +10 -0
  99. package/src/test-helpers/testbench-utils.ts +1 -1
  100. package/src/util.ts +7 -1
@@ -128,6 +128,28 @@ import { TxPoolIndices } from './tx_pool_indices.js';
128
128
  const rejected = [];
129
129
  const errors = new Map();
130
130
  const acceptedPending = new Set();
131
+ // Phase 1: Pre-compute all throwable I/O outside the transaction.
132
+ // If any pre-computation throws, the entire call fails before mutations happen.
133
+ const precomputed = new Map();
134
+ const validator = await this.#createTxValidator();
135
+ for (const tx of txs){
136
+ const txHash = tx.getTxHash();
137
+ const txHashStr = txHash.toString();
138
+ const meta = await buildTxMetaData(tx);
139
+ const minedBlockId = await this.#getMinedBlockId(txHash);
140
+ // Validate non-mined txs (mined and pre-protected txs bypass validation inside the transaction)
141
+ let isValid = true;
142
+ if (!minedBlockId) {
143
+ isValid = await this.#validateMeta(meta, validator);
144
+ }
145
+ precomputed.set(txHashStr, {
146
+ meta,
147
+ minedBlockId,
148
+ isValid
149
+ });
150
+ }
151
+ // Phase 2: Apply mutations inside the transaction using only pre-computed results,
152
+ // in-memory reads, and buffered DB writes. Nothing here can throw an unhandled exception.
131
153
  const poolAccess = this.#createPreAddPoolAccess();
132
154
  const preAddContext = opts.feeComparisonOnly !== undefined ? {
133
155
  feeComparisonOnly: opts.feeComparisonOnly
@@ -141,33 +163,41 @@ import { TxPoolIndices } from './tx_pool_indices.js';
141
163
  ignored.push(txHash);
142
164
  continue;
143
165
  }
144
- // Check mined status first (applies to all paths)
145
- const minedBlockId = await this.#getMinedBlockId(txHash);
166
+ const { meta, minedBlockId, isValid } = precomputed.get(txHashStr);
146
167
  const preProtectedSlot = this.#indices.getProtectionSlot(txHashStr);
147
168
  if (minedBlockId) {
148
169
  // Already mined - add directly (protection already set if pre-protected)
149
170
  await this.#addTx(tx, {
150
171
  mined: minedBlockId
151
- }, opts);
172
+ }, opts, meta);
152
173
  accepted.push(txHash);
153
174
  } else if (preProtectedSlot !== undefined) {
154
175
  // Pre-protected and not mined - add as protected (bypass validation)
155
176
  await this.#addTx(tx, {
156
177
  protected: preProtectedSlot
157
- }, opts);
178
+ }, opts, meta);
158
179
  accepted.push(txHash);
180
+ } else if (!isValid) {
181
+ // Failed pre-computed validation
182
+ rejected.push(txHash);
159
183
  } else {
160
- // Regular pending tx - validate and run pre-add rules
161
- const result = await this.#tryAddRegularPendingTx(tx, opts, poolAccess, acceptedPending, ignored, errors, preAddContext);
184
+ // Regular pending tx - run pre-add rules using pre-computed metadata
185
+ const result = await this.#tryAddRegularPendingTx(tx, meta, opts, poolAccess, acceptedPending, ignored, errors, preAddContext);
162
186
  if (result.status === 'accepted') {
163
187
  acceptedPending.add(txHashStr);
164
- } else if (result.status === 'rejected') {
165
- rejected.push(txHash);
166
188
  } else {
167
189
  ignored.push(txHash);
168
190
  }
169
191
  }
170
192
  }
193
+ // Run post-add eviction rules for pending txs (inside transaction for atomicity)
194
+ if (acceptedPending.size > 0) {
195
+ const feePayers = Array.from(acceptedPending).map((txHash)=>this.#indices.getMetadata(txHash).feePayer);
196
+ const uniqueFeePayers = new Set(feePayers);
197
+ await this.#evictionManager.evictAfterNewTxs(Array.from(acceptedPending), [
198
+ ...uniqueFeePayers
199
+ ]);
200
+ }
171
201
  });
172
202
  // Build final accepted list for pending txs (excludes intra-batch evictions)
173
203
  for (const txHashStr of acceptedPending){
@@ -180,14 +210,6 @@ import { TxPoolIndices } from './tx_pool_indices.js';
180
210
  if (rejected.length > 0) {
181
211
  this.#instrumentation.recordRejected(rejected.length);
182
212
  }
183
- // Run post-add eviction rules for pending txs
184
- if (acceptedPending.size > 0) {
185
- const feePayers = Array.from(acceptedPending).map((txHash)=>this.#indices.getMetadata(txHash).feePayer);
186
- const uniqueFeePayers = new Set(feePayers);
187
- await this.#evictionManager.evictAfterNewTxs(Array.from(acceptedPending), [
188
- ...uniqueFeePayers
189
- ]);
190
- }
191
213
  return {
192
214
  accepted,
193
215
  ignored,
@@ -197,18 +219,10 @@ import { TxPoolIndices } from './tx_pool_indices.js';
197
219
  } : {}
198
220
  };
199
221
  }
200
- /** Validates and adds a regular pending tx. Returns status. */ async #tryAddRegularPendingTx(tx, opts, poolAccess, acceptedPending, ignored, errors, preAddContext) {
201
- const txHash = tx.getTxHash();
202
- const txHashStr = txHash.toString();
203
- // Build metadata and validate using metadata
204
- const meta = await buildTxMetaData(tx);
205
- if (!await this.#validateMeta(meta)) {
206
- return {
207
- status: 'rejected'
208
- };
209
- }
222
+ /** Adds a validated pending tx, running pre-add rules and evicting conflicts. */ async #tryAddRegularPendingTx(tx, precomputedMeta, opts, poolAccess, acceptedPending, ignored, errors, preAddContext) {
223
+ const txHashStr = tx.getTxHash().toString();
210
224
  // Run pre-add rules
211
- const preAddResult = await this.#evictionManager.runPreAddRules(meta, poolAccess, preAddContext);
225
+ const preAddResult = await this.#evictionManager.runPreAddRules(precomputedMeta, poolAccess, preAddContext);
212
226
  if (preAddResult.shouldIgnore) {
213
227
  this.#log.debug(`Ignoring tx ${txHashStr}: ${preAddResult.reason?.message ?? 'unknown reason'}`);
214
228
  if (preAddResult.reason && preAddResult.reason.code !== TxPoolRejectionCode.INTERNAL_ERROR) {
@@ -247,7 +261,7 @@ import { TxPoolIndices } from './tx_pool_indices.js';
247
261
  }
248
262
  }
249
263
  // Add the transaction
250
- await this.#addTx(tx, 'pending', opts);
264
+ await this.#addTx(tx, 'pending', opts, precomputedMeta);
251
265
  return {
252
266
  status: 'accepted'
253
267
  };
@@ -258,13 +272,8 @@ import { TxPoolIndices } from './tx_pool_indices.js';
258
272
  if (this.#indices.has(txHashStr)) {
259
273
  return 'ignored';
260
274
  }
261
- // Build metadata and validate using metadata
275
+ // Build metadata and check pre-add rules
262
276
  const meta = await buildTxMetaData(tx);
263
- const validationResult = await this.#validateMeta(meta, undefined, 'can add pending');
264
- if (validationResult !== true) {
265
- return 'rejected';
266
- }
267
- // Use pre-add rules
268
277
  const poolAccess = this.#createPreAddPoolAccess();
269
278
  const preAddResult = await this.#evictionManager.runPreAddRules(meta, poolAccess);
270
279
  return preAddResult.shouldIgnore ? 'ignored' : 'accepted';
@@ -305,34 +314,36 @@ import { TxPoolIndices } from './tx_pool_indices.js';
305
314
  const missing = [];
306
315
  let softDeletedHits = 0;
307
316
  let missingPreviouslyEvicted = 0;
308
- for (const txHash of txHashes){
309
- const txHashStr = txHash.toString();
310
- if (this.#indices.has(txHashStr)) {
311
- // Update protection for existing tx
312
- this.#indices.updateProtection(txHashStr, slotNumber);
313
- } else if (this.#deletedPool.isSoftDeleted(txHashStr)) {
314
- // Resurrect soft-deleted tx as protected
315
- const buffer = await this.#txsDB.getAsync(txHashStr);
316
- if (buffer) {
317
- const tx = Tx.fromBuffer(buffer);
318
- await this.#addTx(tx, {
319
- protected: slotNumber
320
- });
321
- softDeletedHits++;
317
+ await this.#store.transactionAsync(async ()=>{
318
+ for (const txHash of txHashes){
319
+ const txHashStr = txHash.toString();
320
+ if (this.#indices.has(txHashStr)) {
321
+ // Update protection for existing tx
322
+ this.#indices.updateProtection(txHashStr, slotNumber);
323
+ } else if (this.#deletedPool.isSoftDeleted(txHashStr)) {
324
+ // Resurrect soft-deleted tx as protected
325
+ const buffer = await this.#txsDB.getAsync(txHashStr);
326
+ if (buffer) {
327
+ const tx = Tx.fromBuffer(buffer);
328
+ await this.#addTx(tx, {
329
+ protected: slotNumber
330
+ });
331
+ softDeletedHits++;
332
+ } else {
333
+ // Data missing despite soft-delete flag — treat as truly missing
334
+ this.#indices.setProtection(txHashStr, slotNumber);
335
+ missing.push(txHash);
336
+ }
322
337
  } else {
323
- // Data missing despite soft-delete flag treat as truly missing
338
+ // Truly missing pre-record protection for tx we don't have yet
324
339
  this.#indices.setProtection(txHashStr, slotNumber);
325
340
  missing.push(txHash);
326
- }
327
- } else {
328
- // Truly missing — pre-record protection for tx we don't have yet
329
- this.#indices.setProtection(txHashStr, slotNumber);
330
- missing.push(txHash);
331
- if (this.#evictedTxHashes.has(txHashStr)) {
332
- missingPreviouslyEvicted++;
341
+ if (this.#evictedTxHashes.has(txHashStr)) {
342
+ missingPreviouslyEvicted++;
343
+ }
333
344
  }
334
345
  }
335
- }
346
+ });
336
347
  // Record metrics
337
348
  if (softDeletedHits > 0) {
338
349
  this.#instrumentation.recordSoftDeletedHits(softDeletedHits);
@@ -383,44 +394,48 @@ import { TxPoolIndices } from './tx_pool_indices.js';
383
394
  found.push(meta);
384
395
  }
385
396
  }
386
- // Step 4: Mark txs as mined (only those we have in the pool)
387
- for (const meta of found){
388
- this.#indices.markAsMined(meta, blockId);
389
- await this.#deletedPool.clearIfMinedHigher(meta.txHash, blockId.number);
390
- }
391
- // Step 5: Run eviction rules (remove pending txs with conflicting nullifiers/expired timestamps)
392
- await this.#evictionManager.evictAfterNewBlock(block.header, nullifiers, feePayers);
397
+ await this.#store.transactionAsync(async ()=>{
398
+ // Step 4: Mark txs as mined (only those we have in the pool)
399
+ for (const meta of found){
400
+ this.#indices.markAsMined(meta, blockId);
401
+ await this.#deletedPool.clearIfMinedHigher(meta.txHash, blockId.number);
402
+ }
403
+ // Step 5: Run post-event eviction rules (inside transaction for atomicity)
404
+ await this.#evictionManager.evictAfterNewBlock(block.header, nullifiers, feePayers);
405
+ });
393
406
  this.#log.info(`Marked ${found.length} txs as mined in block ${blockId.number}`);
394
407
  }
395
408
  async prepareForSlot(slotNumber) {
396
- // Step 0: Clean up slot-deleted txs from previous slots
397
- await this.#deletedPool.cleanupSlotDeleted(slotNumber);
398
- // Step 1: Find expired protected txs
399
- const expiredProtected = this.#indices.findExpiredProtectedTxs(slotNumber);
400
- // Step 2: Clear protection for all expired entries (including those without metadata)
401
- this.#indices.clearProtection(expiredProtected);
402
- // Step 3: Filter to only txs that have metadata and are not mined
403
- const txsToRestore = this.#indices.filterRestorable(expiredProtected);
404
- if (txsToRestore.length === 0) {
405
- this.#log.debug(`Preparing for slot ${slotNumber}, no txs to unprotect`);
406
- return;
407
- }
408
- this.#log.info(`Preparing for slot ${slotNumber}: unprotecting ${txsToRestore.length} txs`);
409
- // Step 4: Validate for pending pool
410
- const { valid, invalid } = await this.#revalidateMetadata(txsToRestore, 'during prepareForSlot');
411
- // Step 5: Resolve nullifier conflicts and add winners to pending indices
412
- const { added, toEvict } = this.#applyNullifierConflictResolution(valid);
413
- // Step 6: Delete invalid txs and evict conflict losers
414
- await this.#deleteTxsBatch(invalid);
415
- await this.#evictTxs(toEvict, 'NullifierConflict');
416
- // Step 7: Run eviction rules (enforce pool size limit)
417
- if (added.length > 0) {
418
- const feePayers = added.map((meta)=>meta.feePayer);
419
- const uniqueFeePayers = new Set(feePayers);
420
- await this.#evictionManager.evictAfterNewTxs(added.map((m)=>m.txHash), [
421
- ...uniqueFeePayers
422
- ]);
423
- }
409
+ await this.#store.transactionAsync(async ()=>{
410
+ // Step 0: Clean up slot-deleted txs from previous slots
411
+ await this.#deletedPool.cleanupSlotDeleted(slotNumber);
412
+ // Step 1: Find expired protected txs
413
+ const expiredProtected = this.#indices.findExpiredProtectedTxs(slotNumber);
414
+ // Step 2: Clear protection for all expired entries (including those without metadata)
415
+ this.#indices.clearProtection(expiredProtected);
416
+ // Step 3: Filter to only txs that have metadata and are not mined
417
+ const txsToRestore = this.#indices.filterRestorable(expiredProtected);
418
+ if (txsToRestore.length === 0) {
419
+ this.#log.debug(`Preparing for slot ${slotNumber}, no txs to unprotect`);
420
+ return;
421
+ }
422
+ this.#log.info(`Preparing for slot ${slotNumber}: unprotecting ${txsToRestore.length} txs`);
423
+ // Step 4: Validate for pending pool
424
+ const { valid, invalid } = await this.#revalidateMetadata(txsToRestore, 'during prepareForSlot');
425
+ // Step 5: Resolve nullifier conflicts and add winners to pending indices
426
+ const { added, toEvict } = this.#applyNullifierConflictResolution(valid);
427
+ // Step 6: Delete invalid txs and evict conflict losers
428
+ await this.#deleteTxsBatch(invalid);
429
+ await this.#evictTxs(toEvict, 'NullifierConflict');
430
+ // Step 7: Run eviction rules (enforce pool size limit)
431
+ if (added.length > 0) {
432
+ const feePayers = added.map((meta)=>meta.feePayer);
433
+ const uniqueFeePayers = new Set(feePayers);
434
+ await this.#evictionManager.evictAfterNewTxs(added.map((m)=>m.txHash), [
435
+ ...uniqueFeePayers
436
+ ]);
437
+ }
438
+ });
424
439
  }
425
440
  async handlePrunedBlocks(latestBlock, options) {
426
441
  // Step 1: Find transactions mined after the prune point
@@ -430,45 +445,48 @@ import { TxPoolIndices } from './tx_pool_indices.js';
430
445
  return;
431
446
  }
432
447
  this.#log.info(`Handling prune to block ${latestBlock.number}: un-mining ${txsToUnmine.length} txs`);
433
- // Step 2: Mark ALL un-mined txs with their original mined block number
434
- // This ensures they get soft-deleted if removed later, and only hard-deleted
435
- // when their original mined block is finalized
436
- await this.#deletedPool.markFromPrunedBlock(txsToUnmine.map((m)=>({
437
- txHash: m.txHash,
438
- minedAtBlock: BlockNumber(m.minedL2BlockId.number)
439
- })));
440
- // Step 3: Unmine - clear mined status from metadata
441
- for (const meta of txsToUnmine){
442
- this.#indices.markAsUnmined(meta);
443
- }
444
- // If deleteAllTxs is set (epoch prune), delete all un-mined txs and return early
445
- if (options?.deleteAllTxs) {
446
- const allTxHashes = txsToUnmine.map((m)=>m.txHash);
447
- await this.#deleteTxsBatch(allTxHashes);
448
- this.#log.info(`Handled prune to block ${latestBlock.number} with deleteAllTxs: deleted ${allTxHashes.length} txs`);
449
- return;
450
- }
451
- // Step 4: Filter out protected txs (they'll be handled by prepareForSlot)
452
- const unprotectedTxs = this.#indices.filterUnprotected(txsToUnmine);
453
- // Step 5: Validate for pending pool
454
- const { valid, invalid } = await this.#revalidateMetadata(unprotectedTxs, 'during handlePrunedBlocks');
455
- // Step 6: Resolve nullifier conflicts and add winners to pending indices
456
- const { toEvict } = this.#applyNullifierConflictResolution(valid);
457
- // Step 7: Delete invalid txs and evict conflict losers
458
- await this.#deleteTxsBatch(invalid);
459
- await this.#evictTxs(toEvict, 'NullifierConflict');
460
- this.#log.info(`Handled prune to block ${latestBlock.number}: ${valid.length} txs restored to pending, ${invalid.length} invalid, ${toEvict.length} evicted due to nullifier conflicts`, {
461
- txHashesRestored: valid.map((m)=>m.txHash),
462
- txHashesInvalid: invalid,
463
- txHashesEvicted: toEvict
448
+ await this.#store.transactionAsync(async ()=>{
449
+ // Step 2: Mark ALL un-mined txs with their original mined block number
450
+ // This ensures they get soft-deleted if removed later, and only hard-deleted
451
+ // when their original mined block is finalized
452
+ await this.#deletedPool.markFromPrunedBlock(txsToUnmine.map((m)=>({
453
+ txHash: m.txHash,
454
+ minedAtBlock: BlockNumber(m.minedL2BlockId.number)
455
+ })));
456
+ // Step 3: Unmine - clear mined status from metadata
457
+ for (const meta of txsToUnmine){
458
+ this.#indices.markAsUnmined(meta);
459
+ }
460
+ // If deleteAllTxs is set (epoch prune), delete all un-mined txs and return early
461
+ if (options?.deleteAllTxs) {
462
+ const allTxHashes = txsToUnmine.map((m)=>m.txHash);
463
+ await this.#deleteTxsBatch(allTxHashes);
464
+ this.#log.info(`Handled prune to block ${latestBlock.number} with deleteAllTxs: deleted ${allTxHashes.length} txs`);
465
+ return;
466
+ }
467
+ // Step 4: Filter out protected txs (they'll be handled by prepareForSlot)
468
+ const unprotectedTxs = this.#indices.filterUnprotected(txsToUnmine);
469
+ // Step 5: Validate for pending pool
470
+ const { valid, invalid } = await this.#revalidateMetadata(unprotectedTxs, 'during handlePrunedBlocks');
471
+ // Step 6: Resolve nullifier conflicts and add winners to pending indices
472
+ const { toEvict } = this.#applyNullifierConflictResolution(valid);
473
+ // Step 7: Delete invalid txs and evict conflict losers
474
+ await this.#deleteTxsBatch(invalid);
475
+ await this.#evictTxs(toEvict, 'NullifierConflict');
476
+ this.#log.info(`Handled prune to block ${latestBlock.number}: ${valid.length} txs restored to pending, ${invalid.length} invalid, ${toEvict.length} evicted due to nullifier conflicts`, {
477
+ txHashesRestored: valid.map((m)=>m.txHash),
478
+ txHashesInvalid: invalid,
479
+ txHashesEvicted: toEvict
480
+ });
481
+ // Step 8: Run eviction rules for ALL pending txs (not just restored ones)
482
+ // This handles cases like existing pending txs with invalid fee payer balances
483
+ await this.#evictionManager.evictAfterChainPrune(latestBlock.number);
464
484
  });
465
- // Step 8: Run eviction rules for ALL pending txs (not just restored ones)
466
- // This handles cases like existing pending txs with invalid fee payer balances
467
- await this.#evictionManager.evictAfterChainPrune(latestBlock.number);
468
485
  }
469
486
  async handleFailedExecution(txHashes) {
470
- // Delete failed txs
471
- await this.#deleteTxsBatch(txHashes.map((h)=>h.toString()));
487
+ await this.#store.transactionAsync(async ()=>{
488
+ await this.#deleteTxsBatch(txHashes.map((h)=>h.toString()));
489
+ });
472
490
  this.#log.info(`Deleted ${txHashes.length} failed txs`, {
473
491
  txHashes: txHashes.map((h)=>h.toString())
474
492
  });
@@ -477,24 +495,26 @@ import { TxPoolIndices } from './tx_pool_indices.js';
477
495
  const blockNumber = block.globalVariables.blockNumber;
478
496
  // Step 1: Find mined txs at or before finalized block
479
497
  const minedTxsToFinalize = this.#indices.findTxsMinedAtOrBefore(blockNumber);
480
- // Step 2: Collect mined txs for archiving (before deletion)
481
- const txsToArchive = [];
482
- if (this.#archive.isEnabled()) {
483
- for (const txHashStr of minedTxsToFinalize){
484
- const buffer = await this.#txsDB.getAsync(txHashStr);
485
- if (buffer) {
486
- txsToArchive.push(Tx.fromBuffer(buffer));
498
+ await this.#store.transactionAsync(async ()=>{
499
+ // Step 2: Collect mined txs for archiving (before deletion)
500
+ const txsToArchive = [];
501
+ if (this.#archive.isEnabled()) {
502
+ for (const txHashStr of minedTxsToFinalize){
503
+ const buffer = await this.#txsDB.getAsync(txHashStr);
504
+ if (buffer) {
505
+ txsToArchive.push(Tx.fromBuffer(buffer));
506
+ }
487
507
  }
488
508
  }
489
- }
490
- // Step 3: Delete mined txs from active pool
491
- await this.#deleteTxsBatch(minedTxsToFinalize);
492
- // Step 4: Finalize soft-deleted txs
493
- await this.#deletedPool.finalizeBlock(blockNumber);
494
- // Step 5: Archive mined txs
495
- if (txsToArchive.length > 0) {
496
- await this.#archive.archiveTxs(txsToArchive);
497
- }
509
+ // Step 3: Delete mined txs from active pool
510
+ await this.#deleteTxsBatch(minedTxsToFinalize);
511
+ // Step 4: Finalize soft-deleted txs
512
+ await this.#deletedPool.finalizeBlock(blockNumber);
513
+ // Step 5: Archive mined txs
514
+ if (txsToArchive.length > 0) {
515
+ await this.#archive.archiveTxs(txsToArchive);
516
+ }
517
+ });
498
518
  if (minedTxsToFinalize.length > 0) {
499
519
  this.#log.info(`Finalized ${minedTxsToFinalize.length} mined txs from blocks up to ${blockNumber}`, {
500
520
  txHashes: minedTxsToFinalize
@@ -610,9 +630,9 @@ import { TxPoolIndices } from './tx_pool_indices.js';
610
630
  /**
611
631
  * Adds a new transaction to the pool with the specified state.
612
632
  * Emits onTxsAdded callback immediately after DB write.
613
- */ async #addTx(tx, state, opts = {}) {
633
+ */ async #addTx(tx, state, opts = {}, precomputedMeta) {
614
634
  const txHashStr = tx.getTxHash().toString();
615
- const meta = await buildTxMetaData(tx);
635
+ const meta = precomputedMeta ?? await buildTxMetaData(tx);
616
636
  meta.receivedAt = this.#dateProvider.now();
617
637
  await this.#txsDB.set(txHashStr, tx.toBuffer());
618
638
  await this.#deletedPool.clearSoftDeleted(txHashStr);
@@ -1,7 +1,7 @@
1
1
  import type { TxValidationResult, TxValidator } from '@aztec/stdlib/tx';
2
2
  export declare class AggregateTxValidator<T> implements TxValidator<T> {
3
- #private;
3
+ readonly validators: TxValidator<T>[];
4
4
  constructor(...validators: TxValidator<T>[]);
5
5
  validateTx(tx: T): Promise<TxValidationResult>;
6
6
  }
7
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWdncmVnYXRlX3R4X3ZhbGlkYXRvci5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL21zZ192YWxpZGF0b3JzL3R4X3ZhbGlkYXRvci9hZ2dyZWdhdGVfdHhfdmFsaWRhdG9yLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLGtCQUFrQixFQUFFLFdBQVcsRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBRXhFLHFCQUFhLG9CQUFvQixDQUFDLENBQUMsQ0FBRSxZQUFXLFdBQVcsQ0FBQyxDQUFDLENBQUM7O0lBRTVELFlBQVksR0FBRyxVQUFVLEVBQUUsV0FBVyxDQUFDLENBQUMsQ0FBQyxFQUFFLEVBTTFDO0lBRUssVUFBVSxDQUFDLEVBQUUsRUFBRSxDQUFDLEdBQUcsT0FBTyxDQUFDLGtCQUFrQixDQUFDLENBa0JuRDtDQUNGIn0=
7
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWdncmVnYXRlX3R4X3ZhbGlkYXRvci5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL21zZ192YWxpZGF0b3JzL3R4X3ZhbGlkYXRvci9hZ2dyZWdhdGVfdHhfdmFsaWRhdG9yLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLGtCQUFrQixFQUFFLFdBQVcsRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBRXhFLHFCQUFhLG9CQUFvQixDQUFDLENBQUMsQ0FBRSxZQUFXLFdBQVcsQ0FBQyxDQUFDLENBQUM7SUFDNUQsUUFBUSxDQUFDLFVBQVUsRUFBRSxXQUFXLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQztJQUN0QyxZQUFZLEdBQUcsVUFBVSxFQUFFLFdBQVcsQ0FBQyxDQUFDLENBQUMsRUFBRSxFQU0xQztJQUVLLFVBQVUsQ0FBQyxFQUFFLEVBQUUsQ0FBQyxHQUFHLE9BQU8sQ0FBQyxrQkFBa0IsQ0FBQyxDQWtCbkQ7Q0FDRiJ9
@@ -1 +1 @@
1
- {"version":3,"file":"aggregate_tx_validator.d.ts","sourceRoot":"","sources":["../../../src/msg_validators/tx_validator/aggregate_tx_validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAExE,qBAAa,oBAAoB,CAAC,CAAC,CAAE,YAAW,WAAW,CAAC,CAAC,CAAC;;IAE5D,YAAY,GAAG,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,EAM1C;IAEK,UAAU,CAAC,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAkBnD;CACF"}
1
+ {"version":3,"file":"aggregate_tx_validator.d.ts","sourceRoot":"","sources":["../../../src/msg_validators/tx_validator/aggregate_tx_validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAExE,qBAAa,oBAAoB,CAAC,CAAC,CAAE,YAAW,WAAW,CAAC,CAAC,CAAC;IAC5D,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IACtC,YAAY,GAAG,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,EAM1C;IAEK,UAAU,CAAC,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAkBnD;CACF"}
@@ -1,17 +1,17 @@
1
1
  export class AggregateTxValidator {
2
- #validators;
2
+ validators;
3
3
  constructor(...validators){
4
4
  if (validators.length === 0) {
5
5
  throw new Error('At least one validator must be provided');
6
6
  }
7
- this.#validators = validators;
7
+ this.validators = validators;
8
8
  }
9
9
  async validateTx(tx) {
10
10
  const aggregate = {
11
11
  result: 'valid',
12
12
  reason: []
13
13
  };
14
- for (const validator of this.#validators){
14
+ for (const validator of this.validators){
15
15
  const result = await validator.validateTx(tx);
16
16
  if (result.result === 'invalid') {
17
17
  aggregate.result = 'invalid';
@@ -1,21 +1,129 @@
1
+ /**
2
+ * Transaction validator factories for each tx entry point.
3
+ *
4
+ * Unsolicited transactions (gossip and RPC) are fully validated before acceptance.
5
+ * Transactions received via req/resp or block proposals are only checked for
6
+ * well-formedness because we must include them for block re-execution — they may
7
+ * ultimately be invalid, which is caught during block building and reported as
8
+ * part of block validation/attestation. See the README in this directory for the
9
+ * full validation strategy.
10
+ *
11
+ * 1. **Gossip** — full validation in two stages with a pool pre-check in between.
12
+ * Stage 1 (fast): metadata, data, timestamps, double-spend, gas, phases, block header.
13
+ * Pool pre-check: `canAddPendingTx` — skips proof verification if pool would reject.
14
+ * Stage 2 (slow): proof verification.
15
+ * Orchestrated by `handleGossipedTx` in `libp2p_service.ts`.
16
+ *
17
+ * 2. **JSON-RPC** — full validation including all state-dependent checks.
18
+ * Proof verification and fee enforcement are configurable for testing purposes.
19
+ *
20
+ * 3. **Req/resp & block proposals** — well-formedness checks only (metadata, size,
21
+ * data, proof). Stored for re-execution; validity against state is not checked here.
22
+ *
23
+ * 4. **Block building** — re-validates against current state immediately before
24
+ * sequencing. Catches invalid txs that entered via req/resp or block proposals.
25
+ * Proof and data checks are skipped since they were verified on entry.
26
+ *
27
+ * 5. **Pending pool migration** — when unmined txs (e.g. from req/resp or block
28
+ * proposals) are migrated to the pending pool, the pool runs the state-dependent
29
+ * checks they missed: double-spend, block header, gas limits, and timestamps.
30
+ * This runs on every tx potentially entering the pending pool.
31
+ */
1
32
  import { BlockNumber } from '@aztec/foundation/branded-types';
2
33
  import { Fr } from '@aztec/foundation/curves/bn254';
3
34
  import type { LoggerBindings } from '@aztec/foundation/log';
4
35
  import type { ContractDataSource } from '@aztec/stdlib/contract';
5
36
  import type { GasFees } from '@aztec/stdlib/gas';
6
- import type { AllowedElement, ClientProtocolCircuitVerifier, WorldStateSynchronizer } from '@aztec/stdlib/interfaces/server';
37
+ import type { AllowedElement, ClientProtocolCircuitVerifier, MerkleTreeReadOperations, PublicProcessorValidator, WorldStateSynchronizer } from '@aztec/stdlib/interfaces/server';
7
38
  import { PeerErrorSeverity } from '@aztec/stdlib/p2p';
8
- import type { Tx, TxValidationResult, TxValidator } from '@aztec/stdlib/tx';
39
+ import type { GlobalVariables, Tx, TxValidationResult, TxValidator } from '@aztec/stdlib/tx';
9
40
  import type { UInt64 } from '@aztec/stdlib/types';
10
- export interface MessageValidator {
41
+ import type { TxMetaData } from '../../mem_pools/tx_pool_v2/tx_metadata.js';
42
+ /**
43
+ * A validator paired with a peer penalty severity.
44
+ * Used for gossip validation where each validator's failure triggers a peer penalization
45
+ * with the associated severity level.
46
+ */
47
+ export interface TransactionValidator {
11
48
  validator: {
12
49
  validateTx(tx: Tx): Promise<TxValidationResult>;
13
50
  };
14
51
  severity: PeerErrorSeverity;
15
52
  }
16
- export declare function createTxMessageValidators(timestamp: UInt64, blockNumber: BlockNumber, worldStateSynchronizer: WorldStateSynchronizer, gasFees: GasFees, l1ChainId: number, rollupVersion: number, protocolContractsHash: Fr, contractDataSource: ContractDataSource, proofVerifier: ClientProtocolCircuitVerifier, txsPermitted: boolean, allowedInSetup?: AllowedElement[], bindings?: LoggerBindings): Record<string, MessageValidator>[];
17
- export declare function createTxReqRespValidator(verifier: ClientProtocolCircuitVerifier, { l1ChainId, rollupVersion }: {
53
+ /**
54
+ * First stage of gossip validation fast checks run before the pool pre-check.
55
+ *
56
+ * If any validator fails, the peer is penalized and the tx is rejected immediately,
57
+ * without consulting the pool or running proof verification.
58
+ *
59
+ * The `doubleSpendValidator` failure is special-cased by the caller (`handleGossipedTx`)
60
+ * to determine severity based on how recently the nullifier appeared.
61
+ */
62
+ export declare function createFirstStageTxValidationsForGossipedTransactions(timestamp: UInt64, blockNumber: BlockNumber, worldStateSynchronizer: WorldStateSynchronizer, gasFees: GasFees, l1ChainId: number, rollupVersion: number, protocolContractsHash: Fr, contractDataSource: ContractDataSource, txsPermitted: boolean, allowedInSetup?: AllowedElement[], bindings?: LoggerBindings): Record<string, TransactionValidator>;
63
+ /**
64
+ * Second stage of gossip validation — expensive proof verification.
65
+ *
66
+ * Only runs after the first stage passes AND `canAddPendingTx` confirms the pool would
67
+ * accept the tx. This avoids wasting CPU on proof verification for txs the pool would reject
68
+ * (e.g., duplicates, insufficient balance, pool full).
69
+ */
70
+ export declare function createSecondStageTxValidationsForGossipedTransactions(proofVerifier: ClientProtocolCircuitVerifier, bindings?: LoggerBindings): Record<string, TransactionValidator>;
71
+ /**
72
+ * Validators for txs received via req/resp or filestores.
73
+ * Checks well-formedness only — we must accept these for re-execution even if they
74
+ * are invalid against current state. State-dependent checks happen when the tx
75
+ * enters the pending pool or during block building.
76
+ */
77
+ export declare function createTxValidatorForReqResponseReceivedTxs(verifier: ClientProtocolCircuitVerifier, { l1ChainId, rollupVersion }: {
18
78
  l1ChainId: number;
19
79
  rollupVersion: number;
20
80
  }, bindings?: LoggerBindings): TxValidator;
21
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmFjdG9yeS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL21zZ192YWxpZGF0b3JzL3R4X3ZhbGlkYXRvci9mYWN0b3J5LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxXQUFXLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUM5RCxPQUFPLEVBQUUsRUFBRSxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFDcEQsT0FBTyxLQUFLLEVBQUUsY0FBYyxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFHNUQsT0FBTyxLQUFLLEVBQUUsa0JBQWtCLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUNqRSxPQUFPLEtBQUssRUFBRSxPQUFPLEVBQUUsTUFBTSxtQkFBbUIsQ0FBQztBQUNqRCxPQUFPLEtBQUssRUFDVixjQUFjLEVBQ2QsNkJBQTZCLEVBQzdCLHNCQUFzQixFQUN2QixNQUFNLGlDQUFpQyxDQUFDO0FBQ3pDLE9BQU8sRUFBRSxpQkFBaUIsRUFBRSxNQUFNLG1CQUFtQixDQUFDO0FBRXRELE9BQU8sS0FBSyxFQUFFLEVBQUUsRUFBRSxrQkFBa0IsRUFBRSxXQUFXLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUM1RSxPQUFPLEtBQUssRUFBRSxNQUFNLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQWVsRCxNQUFNLFdBQVcsZ0JBQWdCO0lBQy9CLFNBQVMsRUFBRTtRQUNULFVBQVUsQ0FBQyxFQUFFLEVBQUUsRUFBRSxHQUFHLE9BQU8sQ0FBQyxrQkFBa0IsQ0FBQyxDQUFDO0tBQ2pELENBQUM7SUFDRixRQUFRLEVBQUUsaUJBQWlCLENBQUM7Q0FDN0I7QUFFRCx3QkFBZ0IseUJBQXlCLENBQ3ZDLFNBQVMsRUFBRSxNQUFNLEVBQ2pCLFdBQVcsRUFBRSxXQUFXLEVBQ3hCLHNCQUFzQixFQUFFLHNCQUFzQixFQUM5QyxPQUFPLEVBQUUsT0FBTyxFQUNoQixTQUFTLEVBQUUsTUFBTSxFQUNqQixhQUFhLEVBQUUsTUFBTSxFQUNyQixxQkFBcUIsRUFBRSxFQUFFLEVBQ3pCLGtCQUFrQixFQUFFLGtCQUFrQixFQUN0QyxhQUFhLEVBQUUsNkJBQTZCLEVBQzVDLFlBQVksRUFBRSxPQUFPLEVBQ3JCLGNBQWMsR0FBRSxjQUFjLEVBQU8sRUFDckMsUUFBUSxDQUFDLEVBQUUsY0FBYyxHQUN4QixNQUFNLENBQUMsTUFBTSxFQUFFLGdCQUFnQixDQUFDLEVBQUUsQ0F5RXBDO0FBRUQsd0JBQWdCLHdCQUF3QixDQUN0QyxRQUFRLEVBQUUsNkJBQTZCLEVBQ3ZDLEVBQ0UsU0FBUyxFQUNULGFBQWEsRUFDZCxFQUFFO0lBQ0QsU0FBUyxFQUFFLE1BQU0sQ0FBQztJQUNsQixhQUFhLEVBQUUsTUFBTSxDQUFDO0NBQ3ZCLEVBQ0QsUUFBUSxDQUFDLEVBQUUsY0FBYyxHQUN4QixXQUFXLENBZWIifQ==
81
+ /**
82
+ * Validators for txs received in block proposals.
83
+ * Same as req/resp — well-formedness only. We must store these for block
84
+ * re-execution; their validity against state is checked during block building.
85
+ */
86
+ export declare function createTxValidatorForBlockProposalReceivedTxs(verifier: ClientProtocolCircuitVerifier, { l1ChainId, rollupVersion }: {
87
+ l1ChainId: number;
88
+ rollupVersion: number;
89
+ }, bindings?: LoggerBindings): TxValidator;
90
+ /**
91
+ * Validators for unsolicited txs received over JSON-RPC (from a local wallet/PXE).
92
+ * Full validation — all state-dependent checks are run. Proof verification is optional
93
+ * (can be skipped for testing purposes). Fee enforcement is also optional (skipped for testing/dev).
94
+ * Called from `AztecNodeService.isValidTx()`.
95
+ */
96
+ export declare function createTxValidatorForAcceptingTxsOverRPC(db: MerkleTreeReadOperations, contractDataSource: ContractDataSource, verifier: ClientProtocolCircuitVerifier | undefined, { l1ChainId, rollupVersion, setupAllowList, gasFees, skipFeeEnforcement, timestamp, blockNumber, txsPermitted }: {
97
+ l1ChainId: number;
98
+ rollupVersion: number;
99
+ setupAllowList: AllowedElement[];
100
+ gasFees: GasFees;
101
+ skipFeeEnforcement?: boolean;
102
+ timestamp: UInt64;
103
+ blockNumber: BlockNumber;
104
+ txsPermitted: boolean;
105
+ }, bindings?: LoggerBindings): TxValidator<Tx>;
106
+ /**
107
+ * Validators for txs about to be included in a block by the sequencer.
108
+ * Re-validates against current state. This is where invalid txs that entered via
109
+ * req/resp or block proposals are caught — their invalidity is reported as part
110
+ * of block validation/attestation. Proof and data checks are omitted since they
111
+ * were already verified on entry.
112
+ * Called from `CheckpointBuilder.makeBlockBuilderDeps()`.
113
+ */
114
+ export declare function createTxValidatorForBlockBuilding(db: MerkleTreeReadOperations, contractDataSource: ContractDataSource, globalVariables: GlobalVariables, setupAllowList: AllowedElement[], bindings?: LoggerBindings): PublicProcessorValidator;
115
+ /**
116
+ * Validators for txs migrating to the pending pool.
117
+ *
118
+ * Txs that arrived via req/resp or block proposals only had well-formedness checks
119
+ * on receipt. When they fail to be mined and are migrated to the pending pool, we
120
+ * run the state-dependent checks they missed: double-spend, block header, gas limits,
121
+ * and timestamp expiry. This is run on EVERY tx potentially entering the pending pool
122
+ * — called inside `TxPoolV2Impl` during `addPendingTxs`, `prepareForSlot` (unprotect),
123
+ * `handlePrunedBlocks` (unmine), and startup hydration.
124
+ *
125
+ * Operates on `TxMetaData` rather than full `Tx` since metadata is pre-built by the pool.
126
+ * Injected into `TxPoolV2` as the `createTxValidator` factory in `TxPoolV2Dependencies`.
127
+ */
128
+ export declare function createTxValidatorForTransactionsEnteringPendingTxPool(worldStateSynchronizer: WorldStateSynchronizer, timestamp: bigint, blockNumber: BlockNumber, bindings?: LoggerBindings): Promise<TxValidator<TxMetaData>>;
129
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmFjdG9yeS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL21zZ192YWxpZGF0b3JzL3R4X3ZhbGlkYXRvci9mYWN0b3J5LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0E4Qkc7QUFDSCxPQUFPLEVBQUUsV0FBVyxFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFDOUQsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLGdDQUFnQyxDQUFDO0FBQ3BELE9BQU8sS0FBSyxFQUFFLGNBQWMsRUFBRSxNQUFNLHVCQUF1QixDQUFDO0FBSTVELE9BQU8sS0FBSyxFQUFFLGtCQUFrQixFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFDakUsT0FBTyxLQUFLLEVBQUUsT0FBTyxFQUFFLE1BQU0sbUJBQW1CLENBQUM7QUFDakQsT0FBTyxLQUFLLEVBQ1YsY0FBYyxFQUNkLDZCQUE2QixFQUM3Qix3QkFBd0IsRUFDeEIsd0JBQXdCLEVBQ3hCLHNCQUFzQixFQUN2QixNQUFNLGlDQUFpQyxDQUFDO0FBQ3pDLE9BQU8sRUFBRSxpQkFBaUIsRUFBRSxNQUFNLG1CQUFtQixDQUFDO0FBRXRELE9BQU8sS0FBSyxFQUFFLGVBQWUsRUFBRSxFQUFFLEVBQUUsa0JBQWtCLEVBQUUsV0FBVyxFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFDN0YsT0FBTyxLQUFLLEVBQUUsTUFBTSxFQUFFLE1BQU0scUJBQXFCLENBQUM7QUFFbEQsT0FBTyxLQUFLLEVBQUUsVUFBVSxFQUFFLE1BQU0sMkNBQTJDLENBQUM7QUFlNUU7Ozs7R0FJRztBQUNILE1BQU0sV0FBVyxvQkFBb0I7SUFDbkMsU0FBUyxFQUFFO1FBQ1QsVUFBVSxDQUFDLEVBQUUsRUFBRSxFQUFFLEdBQUcsT0FBTyxDQUFDLGtCQUFrQixDQUFDLENBQUM7S0FDakQsQ0FBQztJQUNGLFFBQVEsRUFBRSxpQkFBaUIsQ0FBQztDQUM3QjtBQUVEOzs7Ozs7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
@@ -1 +1 @@
1
- {"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/msg_validators/tx_validator/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EACV,cAAc,EACd,6BAA6B,EAC7B,sBAAsB,EACvB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,KAAK,EAAE,EAAE,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAelD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE;QACT,UAAU,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;KACjD,CAAC;IACF,QAAQ,EAAE,iBAAiB,CAAC;CAC7B;AAED,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,WAAW,EACxB,sBAAsB,EAAE,sBAAsB,EAC9C,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,qBAAqB,EAAE,EAAE,EACzB,kBAAkB,EAAE,kBAAkB,EACtC,aAAa,EAAE,6BAA6B,EAC5C,YAAY,EAAE,OAAO,EACrB,cAAc,GAAE,cAAc,EAAO,EACrC,QAAQ,CAAC,EAAE,cAAc,GACxB,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAAE,CAyEpC;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,6BAA6B,EACvC,EACE,SAAS,EACT,aAAa,EACd,EAAE;IACD,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB,EACD,QAAQ,CAAC,EAAE,cAAc,GACxB,WAAW,CAeb"}
1
+ {"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/msg_validators/tx_validator/factory.ts"],"names":[],"mappings":"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"}