@aztec/p2p 0.0.1-commit.fce3e4f → 0.0.1-commit.ff7989d6c

package/dest/mem_pools/tx_pool_v2/tx_pool_indices.js

@@ -0,0 +1,355 @@
+import { compareFee, compareTxHash } from './tx_metadata.js';
+/**
+ * Manages in-memory indices for the transaction pool.
+ *
+ * Tracks transaction metadata and maintains several indices for efficient querying:
+ * - Metadata by txHash (primary store)
+ * - Nullifier to txHash mapping (pending txs only)
+ * - Fee payer to txHashes mapping (pending txs only)
+ * - Priority-ordered pending txs
+ * - Protected transaction tracking
+ *
+ * Key invariant: Only pending txs appear in nullifier/feePayer/priority indices.
+ */ export class TxPoolIndices {
+    /** Primary metadata store: txHash -> TxMetaData */ #metadata = new Map();
+    /** Nullifier to txHash index (pending txs only) */ #nullifierToTxHash = new Map();
+    /** Fee payer to txHashes index (pending txs only) */ #feePayerToTxHashes = new Map();
+    /** Pending txHashes grouped by priority fee */ #pendingByPriority = new Map();
+    /** Protected transactions: txHash -> slotNumber */ #protectedTransactions = new Map();
+    // ============================================================================
+    // STATE QUERIES
+    // ============================================================================
+    /**
+   * Derives the transaction state from its metadata and protection status.
+   * A transaction is:
+   * - 'mined' if it has a minedL2BlockId
+   * - 'protected' if it's in the protectedTransactions map (but not mined)
+   * - 'pending' otherwise
+   */ getTxState(meta) {
+        if (meta.minedL2BlockId !== undefined) {
+            return 'mined';
+        } else if (this.#protectedTransactions.has(meta.txHash)) {
+            return 'protected';
+        } else {
+            return 'pending';
+        }
+    }
+    getMetadata(txHash) {
+        return this.#metadata.get(txHash);
+    }
+    has(txHash) {
+        return this.#metadata.has(txHash);
+    }
+    isEmpty() {
+        return this.#metadata.size === 0;
+    }
+    getTxCount() {
+        return this.#metadata.size;
+    }
+    // ============================================================================
+    // ITERATION
+    // ============================================================================
+    /**
+   * Iterates pending transaction hashes in priority order.
+   * @param order - 'desc' for highest priority first, 'asc' for lowest priority first
+   */ *iteratePendingByPriority(order, filter) {
+        // Use compareFee from tx_metadata, swap args for descending order
+        const feeCompareFn = order === 'desc' ? (a, b)=>compareFee(b, a) : compareFee;
+        const hashCompareFn = order === 'desc' ? (a, b)=>compareTxHash(b, a) : compareTxHash;
+        const sortedFees = [
+            ...this.#pendingByPriority.keys()
+        ].sort(feeCompareFn);
+        for (const fee of sortedFees){
+            const hashesAtFee = this.#pendingByPriority.get(fee);
+            // Use compareTxHash from tx_metadata, swap args for descending order
+            const sortedHashes = [
+                ...hashesAtFee
+            ].sort(hashCompareFn);
+            for (const hash of sortedHashes){
+                if (filter === undefined || filter(hash)) {
+                    yield hash;
+                }
+            }
+        }
+    }
+    /**
+   * Iterates pending transaction hashes in priority order, skipping txs received after maxReceivedAt.
+   * @param order - 'desc' for highest priority first, 'asc' for lowest priority first
+   * @param maxReceivedAt - Only yield txs with receivedAt <= this value
+   */ *iterateEligiblePendingByPriority(order, maxReceivedAt) {
+        const filter = (hash)=>{
+            const meta = this.#metadata.get(hash);
+            return meta !== undefined && meta.receivedAt <= maxReceivedAt;
+        };
+        yield* this.iteratePendingByPriority(order, filter);
+    }
+    /** Iterates all metadata entries */ *iterateMetadata() {
+        yield* this.#metadata;
+    }
+    // ============================================================================
+    // INDEX MODIFICATIONS
+    // ============================================================================
+    /** Adds a new pending transaction to all indices */ addPending(meta) {
+        this.#metadata.set(meta.txHash, meta);
+        this.#addToPendingIndices(meta);
+    }
+    /** Adds a new protected transaction (not added to pending indices) */ addProtected(meta, slot) {
+        this.#metadata.set(meta.txHash, meta);
+        this.#protectedTransactions.set(meta.txHash, slot);
+    }
+    /** Adds a new mined transaction (not added to pending indices) */ addMined(meta) {
+        this.#metadata.set(meta.txHash, meta);
+    }
+    /** Marks an existing transaction as mined and removes from pending indices */ markAsMined(meta, blockId) {
+        meta.minedL2BlockId = blockId;
+        // Safe to call unconditionally - removeFromPendingIndices is idempotent
+        this.#removeFromPendingIndices(meta);
+    }
+    /** Clears the mined status from a transaction */ markAsUnmined(meta) {
+        meta.minedL2BlockId = undefined;
+    }
+    /**
+   * Updates protection status for an existing transaction.
+   * Removes from pending indices if transitioning from pending to protected.
+   */ updateProtection(txHash, slotNumber) {
+        const currentSlot = this.#protectedTransactions.get(txHash);
+        // Only update if not already protected at an equal or later slot
+        if (currentSlot !== undefined && currentSlot >= slotNumber) {
+            return;
+        }
+        // Remove from pending indices if transitioning from pending to protected
+        if (currentSlot === undefined) {
+            const meta = this.#metadata.get(txHash);
+            if (meta) {
+                this.#removeFromPendingIndices(meta);
+            }
+        }
+        this.#protectedTransactions.set(txHash, slotNumber);
+    }
+    /** Sets protection for a txHash that may not have metadata yet */ setProtection(txHash, slotNumber) {
+        this.#protectedTransactions.set(txHash, slotNumber);
+    }
+    /** Gets the protection slot for a txHash, if protected */ getProtectionSlot(txHash) {
+        return this.#protectedTransactions.get(txHash);
+    }
+    /** Removes protection from tx hashes */ clearProtection(txHashes) {
+        for (const txHash of txHashes){
+            this.#protectedTransactions.delete(txHash);
+        }
+    }
+    /** Removes a transaction from all indices */ remove(txHash) {
+        const meta = this.#metadata.get(txHash);
+        if (!meta) {
+            return;
+        }
+        this.#metadata.delete(txHash);
+        this.#protectedTransactions.delete(txHash);
+        this.#removeFromPendingIndices(meta);
+    }
+    /** Removes a transaction from pending indices only (not metadata) */ removeFromPendingIndices(meta) {
+        this.#removeFromPendingIndices(meta);
+    }
+    /** Adds a transaction to pending indices (used during conflict resolution) */ addToPendingIndices(meta) {
+        this.#addToPendingIndices(meta);
+    }
+    // ============================================================================
+    // QUERIES FOR EVICTION RULES
+    // ============================================================================
+    /** Gets all pending transactions for a given fee payer */ getFeePayerPendingTxs(feePayer) {
+        const txHashes = this.#feePayerToTxHashes.get(feePayer);
+        if (!txHashes) {
+            return [];
+        }
+        const result = [];
+        for (const txHash of txHashes){
+            const meta = this.#metadata.get(txHash);
+            if (meta && this.getTxState(meta) === 'pending') {
+                result.push(meta);
+            }
+        }
+        return result;
+    }
+    /** Gets the count of pending transactions */ getPendingTxCount() {
+        let count = 0;
+        for (const hashes of this.#pendingByPriority.values()){
+            count += hashes.size;
+        }
+        return count;
+    }
+    /** Gets the lowest priority pending transaction hashes (up to limit) */ getLowestPriorityPending(limit) {
+        if (limit <= 0) {
+            return [];
+        }
+        const result = [];
+        for (const hash of this.iteratePendingByPriority('asc')){
+            result.push(hash);
+            if (result.length >= limit) {
+                break;
+            }
+        }
+        return result;
+    }
+    /** Gets the lowest priority pending transaction */ getLowestPriorityPendingTx() {
+        for (const txHash of this.iteratePendingByPriority('asc')){
+            const meta = this.#metadata.get(txHash);
+            if (meta) {
+                return meta;
+            }
+        }
+        return undefined;
+    }
+    /** Gets all pending transactions */ getPendingTxs() {
+        const result = [];
+        for (const hashSet of this.#pendingByPriority.values()){
+            for (const txHash of hashSet){
+                const meta = this.#metadata.get(txHash);
+                if (meta) {
+                    result.push(meta);
+                }
+            }
+        }
+        return result;
+    }
+    /** Gets all fee payers with pending transactions */ getPendingFeePayers() {
+        return Array.from(this.#feePayerToTxHashes.keys());
+    }
+    /** Gets the txHash that uses a given nullifier (pending txs only) */ getTxHashByNullifier(nullifier) {
+        return this.#nullifierToTxHash.get(nullifier);
+    }
+    /** Gets txHashes for a fee payer */ getTxHashesByFeePayer(feePayer) {
+        return this.#feePayerToTxHashes.get(feePayer);
+    }
+    // ============================================================================
+    // FIND/FILTER OPERATIONS
+    // ============================================================================
+    /** Finds all transactions mined in blocks after the given block number */ findTxsMinedAfter(blockNumber) {
+        const result = [];
+        for (const meta of this.#metadata.values()){
+            if (meta.minedL2BlockId !== undefined && meta.minedL2BlockId.number > blockNumber) {
+                result.push(meta);
+            }
+        }
+        return result;
+    }
+    /** Finds tx hashes mined at or before the given block number */ findTxsMinedAtOrBefore(blockNumber) {
+        const result = [];
+        for (const [txHash, meta] of this.#metadata){
+            if (meta.minedL2BlockId !== undefined && meta.minedL2BlockId.number <= blockNumber) {
+                result.push(txHash);
+            }
+        }
+        return result;
+    }
+    /** Finds protected tx hashes from slots earlier than the given slot number */ findExpiredProtectedTxs(slotNumber) {
+        const result = [];
+        for (const [txHash, protectedSlot] of this.#protectedTransactions){
+            if (protectedSlot < slotNumber) {
+                result.push(txHash);
+            }
+        }
+        return result;
+    }
+    /** Filters out transactions that are currently protected */ filterUnprotected(txs) {
+        return txs.filter((meta)=>!this.#protectedTransactions.has(meta.txHash));
+    }
+    /** Filters to transactions that have metadata and are not mined */ filterRestorable(txHashes) {
+        const result = [];
+        for (const txHash of txHashes){
+            const meta = this.#metadata.get(txHash);
+            if (meta && meta.minedL2BlockId === undefined) {
+                result.push(meta);
+            }
+        }
+        return result;
+    }
+    // ============================================================================
+    // METRICS
+    // ============================================================================
+    /** Counts transactions by state and estimates total metadata memory usage */ countTxs() {
+        let pending = 0;
+        let protected_ = 0;
+        let mined = 0;
+        let totalMetadataBytes = 0;
+        for (const meta of this.#metadata.values()){
+            totalMetadataBytes += meta.estimatedSizeBytes;
+            const state = this.getTxState(meta);
+            if (state === 'pending') {
+                pending++;
+            } else if (state === 'protected') {
+                protected_++;
+            } else if (state === 'mined') {
+                mined++;
+            }
+        }
+        return {
+            pending,
+            protected: protected_,
+            mined,
+            totalMetadataBytes
+        };
+    }
+    /** Returns the estimated total memory consumed by all metadata objects */ getTotalMetadataBytes() {
+        let total = 0;
+        for (const meta of this.#metadata.values()){
+            total += meta.estimatedSizeBytes;
+        }
+        return total;
+    }
+    /** Gets all mined transactions with their block IDs */ getMinedTxs() {
+        const result = [];
+        for (const [txHash, meta] of this.#metadata){
+            if (meta.minedL2BlockId !== undefined) {
+                result.push([
+                    txHash,
+                    meta.minedL2BlockId
+                ]);
+            }
+        }
+        return result;
+    }
+    // ============================================================================
+    // PRIVATE HELPERS
+    // ============================================================================
+    #addToPendingIndices(meta) {
+        // Add to nullifier index
+        for (const nullifier of meta.nullifiers){
+            this.#nullifierToTxHash.set(nullifier, meta.txHash);
+        }
+        // Add to fee payer index
+        let feePayerSet = this.#feePayerToTxHashes.get(meta.feePayer);
+        if (!feePayerSet) {
+            feePayerSet = new Set();
+            this.#feePayerToTxHashes.set(meta.feePayer, feePayerSet);
+        }
+        feePayerSet.add(meta.txHash);
+        // Add to priority bucket
+        let prioritySet = this.#pendingByPriority.get(meta.priorityFee);
+        if (!prioritySet) {
+            prioritySet = new Set();
+            this.#pendingByPriority.set(meta.priorityFee, prioritySet);
+        }
+        prioritySet.add(meta.txHash);
+    }
+    #removeFromPendingIndices(meta) {
+        // Remove from nullifier index
+        for (const nullifier of meta.nullifiers){
+            this.#nullifierToTxHash.delete(nullifier);
+        }
+        // Remove from fee payer index
+        const feePayerSet = this.#feePayerToTxHashes.get(meta.feePayer);
+        if (feePayerSet) {
+            feePayerSet.delete(meta.txHash);
+            if (feePayerSet.size === 0) {
+                this.#feePayerToTxHashes.delete(meta.feePayer);
+            }
+        }
+        // Remove from priority map
+        const hashSet = this.#pendingByPriority.get(meta.priorityFee);
+        if (hashSet) {
+            hashSet.delete(meta.txHash);
+            if (hashSet.size === 0) {
+                this.#pendingByPriority.delete(meta.priorityFee);
+            }
+        }
+    }
+}

package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts

@@ -0,0 +1,60 @@
+import { SlotNumber } from '@aztec/foundation/branded-types';
+import { type Logger } from '@aztec/foundation/log';
+import { DateProvider } from '@aztec/foundation/timer';
+import type { TypedEventEmitter } from '@aztec/foundation/types';
+import type { AztecAsyncKVStore } from '@aztec/kv-store';
+import type { L2Block, L2BlockId } from '@aztec/stdlib/block';
+import { BlockHeader, Tx, TxHash } from '@aztec/stdlib/tx';
+import { type TelemetryClient } from '@aztec/telemetry-client';
+import type { AddTxsResult, TxPoolV2, TxPoolV2Config, TxPoolV2Dependencies, TxPoolV2Events } from './interfaces.js';
+import type { TxState } from './tx_metadata.js';
+declare const AztecKVTxPoolV2_base: new () => TypedEventEmitter<TxPoolV2Events>;
+/**
+ * Implementation of TxPoolV2 with explicit state management.
+ *
+ * This class is a thin wrapper that manages the serial queue and delegates
+ * all operations to TxPoolV2Impl.
+ */
+export declare class AztecKVTxPoolV2 extends AztecKVTxPoolV2_base implements TxPoolV2 {
+    #private;
+    constructor(store: AztecAsyncKVStore, archiveStore: AztecAsyncKVStore, deps: TxPoolV2Dependencies, telemetry?: TelemetryClient, config?: Partial<TxPoolV2Config>, dateProvider?: DateProvider, log?: Logger);
+    addPendingTxs(txs: Tx[], opts?: {
+        source?: string;
+        feeComparisonOnly?: boolean;
+    }): Promise<AddTxsResult>;
+    canAddPendingTx(tx: Tx): Promise<'accepted' | 'ignored' | 'rejected'>;
+    addProtectedTxs(txs: Tx[], block: BlockHeader, opts?: {
+        source?: string;
+    }): Promise<void>;
+    protectTxs(txHashes: TxHash[], block: BlockHeader): Promise<TxHash[]>;
+    addMinedTxs(txs: Tx[], block: BlockHeader, opts?: {
+        source?: string;
+    }): Promise<void>;
+    handleMinedBlock(block: L2Block): Promise<void>;
+    prepareForSlot(slotNumber: SlotNumber): Promise<void>;
+    handlePrunedBlocks(latestBlock: L2BlockId, options?: {
+        deleteAllTxs?: boolean;
+    }): Promise<void>;
+    handleFailedExecution(txHashes: TxHash[]): Promise<void>;
+    handleFinalizedBlock(block: BlockHeader): Promise<void>;
+    getTxByHash(txHash: TxHash): Promise<Tx | undefined>;
+    getTxsByHash(txHashes: TxHash[]): Promise<(Tx | undefined)[]>;
+    hasTxs(txHashes: TxHash[]): Promise<boolean[]>;
+    getTxStatus(txHash: TxHash): Promise<TxState | 'deleted' | undefined>;
+    getPendingTxHashes(): Promise<TxHash[]>;
+    getEligiblePendingTxHashes(): Promise<TxHash[]>;
+    getPendingTxCount(): Promise<number>;
+    getMinedTxHashes(): Promise<[TxHash, L2BlockId][]>;
+    getMinedTxCount(): Promise<number>;
+    isEmpty(): Promise<boolean>;
+    getArchivedTxByHash(txHash: TxHash): Promise<Tx | undefined>;
+    getLowestPriorityPending(limit: number): Promise<TxHash[]>;
+    updateConfig(config: Partial<TxPoolV2Config>): Promise<void>;
+    /**
+     * Starts the pool and initializes state from persistence.
+     */
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHhfcG9vbF92Mi5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL21lbV9wb29scy90eF9wb29sX3YyL3R4X3Bvb2xfdjIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLFVBQVUsRUFBRSxNQUFNLGlDQUFpQyxDQUFDO0FBQzdELE9BQU8sRUFBRSxLQUFLLE1BQU0sRUFBZ0IsTUFBTSx1QkFBdUIsQ0FBQztBQUVsRSxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0seUJBQXlCLENBQUM7QUFDdkQsT0FBTyxLQUFLLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUNqRSxPQUFPLEtBQUssRUFBRSxpQkFBaUIsRUFBRSxNQUFNLGlCQUFpQixDQUFDO0FBQ3pELE9BQU8sS0FBSyxFQUFFLE9BQU8sRUFBRSxTQUFTLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUM5RCxPQUFPLEVBQUUsV0FBVyxFQUFFLEVBQUUsRUFBRSxNQUFNLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUMzRCxPQUFPLEVBQUUsS0FBSyxlQUFlLEVBQXNCLE1BQU0seUJBQXlCLENBQUM7QUFLbkYsT0FBTyxLQUFLLEVBQUUsWUFBWSxFQUFFLFFBQVEsRUFBRSxjQUFjLEVBQUUsb0JBQW9CLEVBQUUsY0FBYyxFQUFFLE1BQU0saUJBQWlCLENBQUM7QUFDcEgsT0FBTyxLQUFLLEVBQUUsT0FBTyxFQUFFLE1BQU0sa0JBQWtCLENBQUM7O0FBR2hEOzs7OztHQUtHO0FBQ0gscUJBQWEsZUFBZ0IsU0FBUSxvQkFBOEQsWUFBVyxRQUFROztJQVNwSCxZQUNFLEtBQUssRUFBRSxpQkFBaUIsRUFDeEIsWUFBWSxFQUFFLGlCQUFpQixFQUMvQixJQUFJLEVBQUUsb0JBQW9CLEVBQzFCLFNBQVMsR0FBRSxlQUFzQyxFQUNqRCxNQUFNLEdBQUUsT0FBTyxDQUFDLGNBQWMsQ0FBTSxFQUNwQyxZQUFZLEdBQUUsWUFBaUMsRUFDL0MsR0FB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

package/dest/mem_pools/tx_pool_v2/tx_pool_v2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tx_pool_v2.d.ts","sourceRoot":"","sources":["../../../src/mem_pools/tx_pool_v2/tx_pool_v2.ts"],"names":[],"mappings":"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"}

package/dest/mem_pools/tx_pool_v2/tx_pool_v2.js

@@ -0,0 +1,161 @@
+import { createLogger } from '@aztec/foundation/log';
+import { SerialQueue } from '@aztec/foundation/queue';
+import { DateProvider } from '@aztec/foundation/timer';
+import { TxHash } from '@aztec/stdlib/tx';
+import { getTelemetryClient } from '@aztec/telemetry-client';
+import EventEmitter from 'node:events';
+import { PoolInstrumentation, PoolName } from '../instrumentation.js';
+import { TxPoolV2Impl } from './tx_pool_v2_impl.js';
+/**
+ * Implementation of TxPoolV2 with explicit state management.
+ *
+ * This class is a thin wrapper that manages the serial queue and delegates
+ * all operations to TxPoolV2Impl.
+ */ export class AztecKVTxPoolV2 extends EventEmitter {
+    #queue;
+    #impl;
+    #metrics;
+    #store;
+    #telemetry;
+    #log;
+    #started = false;
+    constructor(store, archiveStore, deps, telemetry = getTelemetryClient(), config = {}, dateProvider = new DateProvider(), log = createLogger('p2p:tx_pool_v2')){
+        super();
+        this.#store = store;
+        this.#telemetry = telemetry;
+        this.#log = log;
+        this.#queue = new SerialQueue();
+        // Create callbacks that the impl uses to notify us about events and metrics
+        const callbacks = {
+            onTxsAdded: (txs, opts)=>{
+                this.#metrics?.transactionsAdded(txs);
+                this.emit('txs-added', {
+                    txs,
+                    ...opts
+                });
+            },
+            onTxsRemoved: (txHashes)=>{
+                this.#metrics?.transactionsRemoved(txHashes);
+                // Convert to TxHash objects for the event
+                const hashes = txHashes.map((h)=>typeof h === 'string' ? TxHash.fromString(h) : TxHash.fromBigInt(h));
+                this.emit('txs-removed', {
+                    txHashes: hashes
+                });
+            }
+        };
+        // Create the implementation
+        this.#impl = new TxPoolV2Impl(store, archiveStore, deps, callbacks, telemetry, config, dateProvider, log);
+    }
+    // ============================================================================
+    // PUBLIC API - All methods queue to the implementation
+    // ============================================================================
+    // === Core Operations ===
+    addPendingTxs(txs, opts = {}) {
+        return this.#queue.put(()=>this.#impl.addPendingTxs(txs, opts));
+    }
+    canAddPendingTx(tx) {
+        return this.#queue.put(()=>this.#impl.canAddPendingTx(tx));
+    }
+    addProtectedTxs(txs, block, opts = {}) {
+        return this.#queue.put(()=>this.#impl.addProtectedTxs(txs, block, opts));
+    }
+    protectTxs(txHashes, block) {
+        return this.#queue.put(()=>this.#impl.protectTxs(txHashes, block));
+    }
+    addMinedTxs(txs, block, opts = {}) {
+        return this.#queue.put(()=>this.#impl.addMinedTxs(txs, block, opts));
+    }
+    // === State Transition Handlers ===
+    handleMinedBlock(block) {
+        return this.#queue.put(()=>this.#impl.handleMinedBlock(block));
+    }
+    prepareForSlot(slotNumber) {
+        return this.#queue.put(()=>this.#impl.prepareForSlot(slotNumber));
+    }
+    handlePrunedBlocks(latestBlock, options) {
+        return this.#queue.put(()=>this.#impl.handlePrunedBlocks(latestBlock, options));
+    }
+    handleFailedExecution(txHashes) {
+        return this.#queue.put(()=>this.#impl.handleFailedExecution(txHashes));
+    }
+    handleFinalizedBlock(block) {
+        return this.#queue.put(()=>this.#impl.handleFinalizedBlock(block));
+    }
+    // === Queries ===
+    getTxByHash(txHash) {
+        return this.#queue.put(()=>this.#impl.getTxByHash(txHash));
+    }
+    getTxsByHash(txHashes) {
+        return this.#queue.put(()=>this.#impl.getTxsByHash(txHashes));
+    }
+    hasTxs(txHashes) {
+        return this.#queue.put(()=>this.#impl.hasTxs(txHashes));
+    }
+    getTxStatus(txHash) {
+        return this.#queue.put(()=>Promise.resolve(this.#impl.getTxStatus(txHash)));
+    }
+    getPendingTxHashes() {
+        return this.#queue.put(()=>Promise.resolve(this.#impl.getPendingTxHashes()));
+    }
+    getEligiblePendingTxHashes() {
+        return this.#queue.put(()=>Promise.resolve(this.#impl.getEligiblePendingTxHashes()));
+    }
+    getPendingTxCount() {
+        return this.#queue.put(()=>Promise.resolve(this.#impl.getPendingTxCount()));
+    }
+    getMinedTxHashes() {
+        return this.#queue.put(()=>Promise.resolve(this.#impl.getMinedTxHashes()));
+    }
+    getMinedTxCount() {
+        return this.#queue.put(()=>Promise.resolve(this.#impl.getMinedTxCount()));
+    }
+    isEmpty() {
+        return this.#queue.put(()=>Promise.resolve(this.#impl.isEmpty()));
+    }
+    getArchivedTxByHash(txHash) {
+        return this.#queue.put(()=>this.#impl.getArchivedTxByHash(txHash));
+    }
+    getLowestPriorityPending(limit) {
+        return this.#queue.put(()=>Promise.resolve(this.#impl.getLowestPriorityPending(limit)));
+    }
+    // === Configuration ===
+    updateConfig(config) {
+        return this.#queue.put(()=>{
+            this.#impl.updateConfig(config);
+            return Promise.resolve();
+        });
+    }
+    // === Lifecycle ===
+    /**
+   * Starts the pool and initializes state from persistence.
+   */ async start() {
+        if (this.#started) {
+            return;
+        }
+        this.#log.info('Starting transaction pool...');
+        // Start the serial queue
+        this.#queue.start();
+        this.#started = true;
+        // Setup metrics - created after queue is started so callbacks can safely queue
+        this.#metrics = new PoolInstrumentation(this.#telemetry, PoolName.TX_POOL, ()=>this.#queue.put(()=>{
+                const counts = this.#impl.countTxs();
+                return Promise.resolve({
+                    itemCount: {
+                        pending: counts.pending,
+                        protected: counts.protected,
+                        mined: counts.mined,
+                        softDeleted: counts.softDeleted
+                    }
+                });
+            }), ()=>this.#store.estimateSize());
+        // Hydrate state from persistence (runs in queue)
+        await this.#queue.put(()=>this.#impl.hydrateFromDatabase());
+        this.#log.info(`Transaction pool started with ${this.#impl.getTxCount()} transactions (${this.#impl.getPendingTxCount()} pending, ${this.#impl.getMinedTxCount()} mined)`);
+    }
+    async stop() {
+        if (this.#started) {
+            await this.#queue.end();
+            this.#started = false;
+        }
+    }
+}

package/dest/mem_pools/tx_pool_v2/tx_pool_v2_impl.d.ts

@@ -0,0 +1,77 @@
+import { SlotNumber } from '@aztec/foundation/branded-types';
+import type { Logger } from '@aztec/foundation/log';
+import type { DateProvider } from '@aztec/foundation/timer';
+import type { AztecAsyncKVStore } from '@aztec/kv-store';
+import type { L2Block, L2BlockId } from '@aztec/stdlib/block';
+import { BlockHeader, Tx, TxHash } from '@aztec/stdlib/tx';
+import type { TelemetryClient } from '@aztec/telemetry-client';
+import { type AddTxsResult, type PoolReadAccess, type TxPoolV2Config, type TxPoolV2Dependencies } from './interfaces.js';
+import { type TxState } from './tx_metadata.js';
+/**
+ * Callbacks for the implementation to notify the outer class about events and metrics.
+ */
+export interface TxPoolV2Callbacks {
+    onTxsAdded: (txs: Tx[], opts: {
+        source?: string;
+    }) => void;
+    onTxsRemoved: (txHashes: string[] | bigint[]) => void;
+}
+/**
+ * Implementation of TxPoolV2 logic.
+ *
+ * This class contains all the actual transaction pool logic.
+ */
+export declare class TxPoolV2Impl {
+    #private;
+    constructor(store: AztecAsyncKVStore, archiveStore: AztecAsyncKVStore, deps: TxPoolV2Dependencies, callbacks: TxPoolV2Callbacks, telemetry: TelemetryClient, config: Partial<TxPoolV2Config> | undefined, dateProvider: DateProvider, log: Logger);
+    /**
+     * Hydrates the in-memory state from the database on startup.
+     * Pipeline: Load → Check Mined Status → Partition → Validate Non-Mined → Rebuild Pending Pool → Delete Invalid
+     *
+     * Note: Protected status is lost on restart. All non-mined txs are rebuilt as pending
+     * by running pre-add rules to resolve nullifier conflicts, balance checks, and pool size limits.
+     */
+    hydrateFromDatabase(): Promise<void>;
+    addPendingTxs(txs: Tx[], opts: {
+        source?: string;
+        feeComparisonOnly?: boolean;
+    }): Promise<AddTxsResult>;
+    canAddPendingTx(tx: Tx): Promise<'accepted' | 'ignored' | 'rejected'>;
+    addProtectedTxs(txs: Tx[], block: BlockHeader, opts: {
+        source?: string;
+    }): Promise<void>;
+    protectTxs(txHashes: TxHash[], block: BlockHeader): Promise<TxHash[]>;
+    addMinedTxs(txs: Tx[], block: BlockHeader, opts: {
+        source?: string;
+    }): Promise<void>;
+    handleMinedBlock(block: L2Block): Promise<void>;
+    prepareForSlot(slotNumber: SlotNumber): Promise<void>;
+    handlePrunedBlocks(latestBlock: L2BlockId, options?: {
+        deleteAllTxs?: boolean;
+    }): Promise<void>;
+    handleFailedExecution(txHashes: TxHash[]): Promise<void>;
+    handleFinalizedBlock(block: BlockHeader): Promise<void>;
+    getTxByHash(txHash: TxHash): Promise<Tx | undefined>;
+    getTxsByHash(txHashes: TxHash[]): Promise<(Tx | undefined)[]>;
+    hasTxs(txHashes: TxHash[]): boolean[];
+    getTxStatus(txHash: TxHash): TxState | undefined;
+    getPendingTxHashes(): TxHash[];
+    getEligiblePendingTxHashes(): TxHash[];
+    getPendingTxCount(): number;
+    getMinedTxHashes(): [TxHash, L2BlockId][];
+    getMinedTxCount(): number;
+    isEmpty(): boolean;
+    getTxCount(): number;
+    getArchivedTxByHash(txHash: TxHash): Promise<Tx | undefined>;
+    getLowestPriorityPending(limit: number): TxHash[];
+    updateConfig(config: Partial<TxPoolV2Config>): void;
+    getPoolReadAccess(): PoolReadAccess;
+    countTxs(): {
+        pending: number;
+        protected: number;
+        mined: number;
+        softDeleted: number;
+        totalMetadataBytes: number;
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHhfcG9vbF92Ml9pbXBsLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvbWVtX3Bvb2xzL3R4X3Bvb2xfdjIvdHhfcG9vbF92Ml9pbXBsLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBZSxVQUFVLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUMxRSxPQUFPLEtBQUssRUFBRSxNQUFNLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUNwRCxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUM1RCxPQUFPLEtBQUssRUFBRSxpQkFBaUIsRUFBaUIsTUFBTSxpQkFBaUIsQ0FBQztBQUl4RSxPQUFPLEtBQUssRUFBRSxPQUFPLEVBQUUsU0FBUyxFQUFpQixNQUFNLHFCQUFxQixDQUFDO0FBRzdFLE9BQU8sRUFBRSxXQUFXLEVBQUUsRUFBRSxFQUFFLE1BQU0sRUFBb0IsTUFBTSxrQkFBa0IsQ0FBQztBQUM3RSxPQUFPLEtBQUssRUFBRSxlQUFlLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQW9CL0QsT0FBTyxFQUNMLEtBQUssWUFBWSxFQUVqQixLQUFLLGNBQWMsRUFDbkIsS0FBSyxjQUFjLEVBQ25CLEtBQUssb0JBQW9CLEVBQzFCLE1BQU0saUJBQWlCLENBQUM7QUFDekIsT0FBTyxFQUFtQixLQUFLLE9BQU8sRUFBMkMsTUFBTSxrQkFBa0IsQ0FBQztBQUcxRzs7R0FFRztBQUNILE1BQU0sV0FBVyxpQkFBaUI7SUFDaEMsVUFBVSxFQUFFLENBQUMsR0FBRyxFQUFFLEVBQUUsRUFBRSxFQUFFLElBQUksRUFBRTtRQUFFLE1BQU0sQ0FBQyxFQUFFLE1BQU0sQ0FBQTtLQUFFLEtBQUssSUFBSSxDQUFDO0lBQzNELFlBQVksRUFBRSxDQUFDLFFBQVEsRUFBRSxNQUFNLEVBQUUsR0FBRyxNQUFNLEVBQUUsS0FBSyxJQUFJLENBQUM7Q0FDdkQ7QUFFRDs7OztHQUlHO0FBQ0gscUJBQWEs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