@aztec/p2p 0.0.0-test.0 → 0.0.1-commit.24de95ac

package/dest/mem_pools/tx_pool/memory_tx_pool.d.ts

@@ -1,10 +1,12 @@
-import { Tx, TxHash } from '@aztec/stdlib/tx';
+import type { TypedEventEmitter } from '@aztec/foundation/types';
+import { BlockHeader, Tx, TxHash } from '@aztec/stdlib/tx';
 import { type TelemetryClient } from '@aztec/telemetry-client';
-import type { TxPool } from './tx_pool.js';
+import type { TxPool, TxPoolEvents, TxPoolOptions } from './tx_pool.js';
+declare const InMemoryTxPool_base: new () => TypedEventEmitter<TxPoolEvents>;
 /**
  * In-memory implementation of the Transaction Pool.
  */
-export declare class InMemoryTxPool implements TxPool {
+export declare class InMemoryTxPool extends InMemoryTxPool_base implements TxPool {
     private log;
     /**
      * Our tx pool, stored as a Map in-memory, with K: tx hash and V: the transaction.
@@ -12,36 +14,49 @@ export declare class InMemoryTxPool implements TxPool {
     private txs;
     private minedTxs;
     private pendingTxs;
+    private deletedMinedTxHashes;
+    private blockToDeletedMinedTxHash;
     private metrics;
     /**
      * Class constructor for in-memory TxPool. Initiates our transaction pool as a JS Map.
      * @param log - A logger.
      */
     constructor(telemetry?: TelemetryClient, log?: import("@aztec/foundation/log").Logger);
-    markAsMined(txHashes: TxHash[], blockNumber: number): Promise<void>;
+    private countTx;
+    isEmpty(): Promise<boolean>;
+    markAsMined(txHashes: TxHash[], blockHeader: BlockHeader): Promise<void>;
     markMinedAsPending(txHashes: TxHash[]): Promise<void>;
     getPendingTxHashes(): Promise<TxHash[]>;
     getMinedTxHashes(): Promise<[TxHash, number][]>;
-    getTxStatus(txHash: TxHash): Promise<'pending' | 'mined' | undefined>;
+    getPendingTxCount(): Promise<number>;
+    getTxStatus(txHash: TxHash): Promise<'pending' | 'mined' | 'deleted' | undefined>;
     /**
      * Checks if a transaction exists in the pool and returns it.
      * @param txHash - The generated tx hash.
      * @returns The transaction, if found, 'undefined' otherwise.
      */
     getTxByHash(txHash: TxHash): Promise<Tx | undefined>;
+    getTxsByHash(txHashes: TxHash[]): Promise<(Tx | undefined)[]>;
+    hasTxs(txHashes: TxHash[]): Promise<boolean[]>;
+    hasTx(txHash: TxHash): Promise<boolean>;
     getArchivedTxByHash(): Promise<Tx | undefined>;
     /**
      * Adds a list of transactions to the pool. Duplicates are ignored.
      * @param txs - An array of txs to be added to the pool.
      * @returns Empty promise.
      */
-    addTxs(txs: Tx[]): Promise<void>;
+    addTxs(txs: Tx[], opts?: {
+        source?: string;
+    }): Promise<number>;
     /**
      * Deletes transactions from the pool. Tx hashes that are not present are ignored.
-     * @param txHashes - An array of tx hashes to be removed from the tx pool.
-     * @returns The number of transactions that was deleted from the pool.
+     * Mined transactions are soft-deleted with a timestamp, pending transactions are permanently deleted.
+     * @param txHashes - An array of tx hashes to be deleted from the tx pool.
+     * @returns Empty promise.
      */
-    deleteTxs(txHashes: TxHash[]): Promise<void>;
+    deleteTxs(txHashes: TxHash[], opts?: {
+        permanently?: boolean;
+    }): Promise<void>;
     /**
      * Gets all the transactions stored in the pool.
      * @returns Array of tx objects in the order they were added to the pool.
@@ -52,5 +67,14 @@ export declare class InMemoryTxPool implements TxPool {
      * @returns An array of transaction hashes found in the tx pool.
      */
     getAllTxHashes(): Promise<TxHash[]>;
+    updateConfig(_config: TxPoolOptions): void;
+    markTxsAsNonEvictable(_: TxHash[]): Promise<void>;
+    /**
+     * Permanently deletes deleted mined transactions from blocks up to and including the specified block number.
+     * @param blockNumber - Block number threshold. Deleted mined txs from this block or earlier will be permanently deleted.
+     * @returns The number of transactions permanently deleted.
+     */
+    cleanupDeletedMinedTxs(blockNumber: number): Promise<number>;
 }
+export {};
 //# sourceMappingURL=memory_tx_pool.d.ts.map

package/dest/mem_pools/tx_pool/memory_tx_pool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory_tx_pool.d.ts","sourceRoot":"","sources":["../../../src/mem_pools/tx_pool/memory_tx_pool.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,KAAK,eAAe,EAAsB,MAAM,yBAAyB,CAAC;AAInF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C;;GAEG;AACH,qBAAa,cAAe,YAAW,MAAM;IAcoB,OAAO,CAAC,GAAG;IAb1E;;OAEG;IACH,OAAO,CAAC,GAAG,CAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,UAAU,CAAc;IAEhC,OAAO,CAAC,OAAO,CAA0B;IAEzC;;;OAGG;gBACS,SAAS,GAAE,eAAsC,EAAU,GAAG,yCAA8B;IAOjG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWnE,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B/C,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAQ7C,gBAAgB,IAAI,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IAM/C,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IAW5E;;;;OAIG;IACI,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,EAAE,GAAG,SAAS,CAAC;IAKpD,mBAAmB,IAAI,OAAO,CAAC,EAAE,GAAG,SAAS,CAAC;IAIrD;;;;OAIG;IACU,MAAM,CAAC,GAAG,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB7C;;;;OAIG;IACI,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBnD;;;OAGG;IACI,SAAS,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC;IAIjC;;;OAGG;IACI,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAG3C"}
+{"version":3,"file":"memory_tx_pool.d.ts","sourceRoot":"","sources":["../../../src/mem_pools/tx_pool/memory_tx_pool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,KAAK,eAAe,EAAsB,MAAM,yBAAyB,CAAC;AAMnF,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;mCAKnB,UAAU,iBAAiB,CAAC,YAAY,CAAC;AAH9F;;GAEG;AACH,qBAAa,cAAe,SAAQ,mBAA4D,YAAW,MAAM;IAkB7G,OAAO,CAAC,GAAG;IAjBb;;OAEG;IACH,OAAO,CAAC,GAAG,CAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,oBAAoB,CAAsB;IAClD,OAAO,CAAC,yBAAyB,CAA2B;IAE5D,OAAO,CAAC,OAAO,CAA0B;IAEzC;;;OAGG;gBAED,SAAS,GAAE,eAAsC,EACzC,GAAG,yCAA8B;IAW3C,OAAO,CAAC,OAAO,CAOb;IAEK,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAI3B,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBxE,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB/C,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAa7C,gBAAgB,IAAI,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IAM/C,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;IAKpC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IAexF;;;;OAIG;IACI,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,EAAE,GAAG,SAAS,CAAC;IAK3D,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,EAAE,CAAC;IAG7D,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAIxC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKtC,mBAAmB,IAAI,OAAO,CAAC,EAAE,GAAG,SAAS,CAAC;IAIrD;;;;OAIG;IACI,MAAM,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IA0BzE;;;;;OAKG;IACI,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BrF;;;OAGG;IACI,SAAS,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC;IAIjC;;;OAGG;IACI,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAI1C,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAE1C,qBAAqB,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD;;;;OAIG;IACI,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CA2BpE"}

package/dest/mem_pools/tx_pool/memory_tx_pool.js

@@ -1,36 +1,63 @@
 import { createLogger } from '@aztec/foundation/log';
 import { Tx, TxHash } from '@aztec/stdlib/tx';
 import { getTelemetryClient } from '@aztec/telemetry-client';
+import EventEmitter from 'node:events';
 import { PoolInstrumentation, PoolName } from '../instrumentation.js';
 import { getPendingTxPriority } from './priority.js';
 /**
  * In-memory implementation of the Transaction Pool.
- */ export class InMemoryTxPool {
+ */ export class InMemoryTxPool extends EventEmitter {
     log;
     /**
    * Our tx pool, stored as a Map in-memory, with K: tx hash and V: the transaction.
    */ txs;
     minedTxs;
     pendingTxs;
+    deletedMinedTxHashes;
+    blockToDeletedMinedTxHash;
     metrics;
     /**
    * Class constructor for in-memory TxPool. Initiates our transaction pool as a JS Map.
    * @param log - A logger.
    */ constructor(telemetry = getTelemetryClient(), log = createLogger('p2p:tx_pool')){
-        this.log = log;
+        super(), this.log = log, this.countTx = ()=>{
+            return Promise.resolve({
+                itemCount: {
+                    mined: this.minedTxs.size,
+                    pending: this.pendingTxs.size
+                }
+            });
+        };
         this.txs = new Map();
         this.minedTxs = new Map();
         this.pendingTxs = new Set();
-        this.metrics = new PoolInstrumentation(telemetry, PoolName.TX_POOL);
+        this.deletedMinedTxHashes = new Map();
+        this.blockToDeletedMinedTxHash = new Map();
+        this.metrics = new PoolInstrumentation(telemetry, PoolName.TX_POOL, this.countTx);
+    }
+    countTx;
+    isEmpty() {
+        return Promise.resolve(this.txs.size === 0);
     }
-    markAsMined(txHashes, blockNumber) {
+    markAsMined(txHashes, blockHeader) {
         const keys = txHashes.map((x)=>x.toBigInt());
         for (const key of keys){
-            this.minedTxs.set(key, blockNumber);
+            // If this tx was previously soft-deleted, remove it from the deleted sets
+            if (this.deletedMinedTxHashes.has(key)) {
+                const originalBlock = this.deletedMinedTxHashes.get(key);
+                this.deletedMinedTxHashes.delete(key);
+                // Remove from block-to-hash mapping
+                const txHashesForBlock = this.blockToDeletedMinedTxHash.get(originalBlock);
+                if (txHashesForBlock) {
+                    txHashesForBlock.delete(key);
+                    if (txHashesForBlock.size === 0) {
+                        this.blockToDeletedMinedTxHash.delete(originalBlock);
+                    }
+                }
+            }
+            this.minedTxs.set(key, blockHeader.globalVariables.blockNumber);
             this.pendingTxs.delete(key);
         }
-        this.metrics.recordRemovedObjects(txHashes.length, 'pending');
-        this.metrics.recordAddedObjects(txHashes.length, 'mined');
         return Promise.resolve();
     }
     markMinedAsPending(txHashes) {
@@ -38,26 +65,23 @@ import { getPendingTxPriority } from './priority.js';
             return Promise.resolve();
         }
         const keys = txHashes.map((x)=>x.toBigInt());
-        let deleted = 0;
-        let added = 0;
         for (const key of keys){
-            if (this.minedTxs.delete(key)) {
-                deleted++;
-            }
+            this.minedTxs.delete(key);
             // only add back to the pending set if we have the tx object
             if (this.txs.has(key)) {
-                added++;
                 this.pendingTxs.add(key);
             }
         }
-        this.metrics.recordRemovedObjects(deleted, 'mined');
-        this.metrics.recordAddedObjects(added, 'pending');
         return Promise.resolve();
     }
     async getPendingTxHashes() {
         const txs = (await this.getAllTxs()).sort((tx1, tx2)=>-getPendingTxPriority(tx1).localeCompare(getPendingTxPriority(tx2)));
         const txHashes = await Promise.all(txs.map((tx)=>tx.getTxHash()));
-        return txHashes.filter((txHash)=>this.pendingTxs.has(txHash.toBigInt()));
+        // No need to check deleted since pending txs are never soft-deleted
+        return txHashes.filter((txHash)=>{
+            const key = txHash.toBigInt();
+            return this.pendingTxs.has(key);
+        });
     }
     getMinedTxHashes() {
         return Promise.resolve(Array.from(this.minedTxs.entries()).map(([txHash, blockNumber])=>[
@@ -65,14 +89,21 @@ import { getPendingTxPriority } from './priority.js';
                 blockNumber
             ]));
     }
+    getPendingTxCount() {
+        // Soft-deleted transactions are always mined, never pending
+        return Promise.resolve(this.pendingTxs.size);
+    }
     getTxStatus(txHash) {
         const key = txHash.toBigInt();
-        if (this.pendingTxs.has(key)) {
-            return Promise.resolve('pending');
+        if (this.deletedMinedTxHashes.has(key)) {
+            return Promise.resolve('deleted');
         }
         if (this.minedTxs.has(key)) {
             return Promise.resolve('mined');
         }
+        if (this.pendingTxs.has(key)) {
+            return Promise.resolve('pending');
+        }
         return Promise.resolve(undefined);
     }
     /**
@@ -83,6 +114,18 @@ import { getPendingTxPriority } from './priority.js';
         const result = this.txs.get(txHash.toBigInt());
         return Promise.resolve(result === undefined ? undefined : Tx.clone(result));
     }
+    getTxsByHash(txHashes) {
+        return Promise.all(txHashes.map((txHash)=>this.getTxByHash(txHash)));
+    }
+    hasTxs(txHashes) {
+        return Promise.resolve(txHashes.map((txHash)=>this.txs.has(txHash.toBigInt())));
+    }
+    async hasTx(txHash) {
+        const result = await this.hasTxs([
+            txHash
+        ]);
+        return result[0];
+    }
     getArchivedTxByHash() {
         return Promise.resolve(undefined);
     }
@@ -90,40 +133,62 @@ import { getPendingTxPriority } from './priority.js';
    * Adds a list of transactions to the pool. Duplicates are ignored.
    * @param txs - An array of txs to be added to the pool.
    * @returns Empty promise.
-   */ async addTxs(txs) {
-        let pending = 0;
+   */ addTxs(txs, opts = {}) {
+        const added = [];
         for (const tx of txs){
-            const txHash = await tx.getTxHash();
+            const txHash = tx.getTxHash();
             this.log.verbose(`Adding tx ${txHash.toString()} to pool`, {
                 eventName: 'tx-added-to-pool',
-                ...await tx.getStats()
+                ...tx.getStats()
             });
             const key = txHash.toBigInt();
-            this.txs.set(key, tx);
+            if (!this.txs.has(key)) {
+                added.push(tx);
+                this.txs.set(key, tx);
+            }
             if (!this.minedTxs.has(key)) {
-                pending++;
                 this.metrics.recordSize(tx);
                 this.pendingTxs.add(key);
             }
         }
-        this.metrics.recordAddedObjects(pending, 'pending');
-        return;
+        if (added.length > 0) {
+            this.emit('txs-added', {
+                ...opts,
+                txs: added
+            });
+        }
+        return Promise.resolve(added.length);
     }
     /**
    * Deletes transactions from the pool. Tx hashes that are not present are ignored.
-   * @param txHashes - An array of tx hashes to be removed from the tx pool.
-   * @returns The number of transactions that was deleted from the pool.
-   */ deleteTxs(txHashes) {
-        let deletedMined = 0;
-        let deletedPending = 0;
+   * Mined transactions are soft-deleted with a timestamp, pending transactions are permanently deleted.
+   * @param txHashes - An array of tx hashes to be deleted from the tx pool.
+   * @returns Empty promise.
+   */ deleteTxs(txHashes, opts) {
         for (const txHash of txHashes){
             const key = txHash.toBigInt();
-            this.txs.delete(key);
-            deletedPending += this.pendingTxs.delete(key) ? 1 : 0;
-            deletedMined += this.minedTxs.delete(key) ? 1 : 0;
+            if (this.txs.has(key)) {
+                if (this.minedTxs.has(key)) {
+                    const blockNumber = this.minedTxs.get(key);
+                    this.minedTxs.delete(key);
+                    // Soft-delete mined transactions: remove from mined set but keep in storage
+                    if (opts?.permanently) {
+                        // Permanently delete mined transactions if specified
+                        this.txs.delete(key);
+                    } else {
+                        this.deletedMinedTxHashes.set(key, blockNumber);
+                        if (!this.blockToDeletedMinedTxHash.has(blockNumber)) {
+                            this.blockToDeletedMinedTxHash.set(blockNumber, new Set());
+                        }
+                        this.blockToDeletedMinedTxHash.get(blockNumber).add(key);
+                    }
+                } else {
+                    // Permanently delete pending transactions
+                    this.txs.delete(key);
+                    this.pendingTxs.delete(key);
+                }
+            }
         }
-        this.metrics.recordRemovedObjects(deletedPending, 'pending');
-        this.metrics.recordRemovedObjects(deletedMined, 'mined');
         return Promise.resolve();
     }
     /**
@@ -138,4 +203,36 @@ import { getPendingTxPriority } from './priority.js';
    */ getAllTxHashes() {
         return Promise.resolve(Array.from(this.txs.keys()).map((x)=>TxHash.fromBigInt(x)));
     }
+    updateConfig(_config) {}
+    markTxsAsNonEvictable(_) {
+        return Promise.resolve();
+    }
+    /**
+   * Permanently deletes deleted mined transactions from blocks up to and including the specified block number.
+   * @param blockNumber - Block number threshold. Deleted mined txs from this block or earlier will be permanently deleted.
+   * @returns The number of transactions permanently deleted.
+   */ cleanupDeletedMinedTxs(blockNumber) {
+        let deletedCount = 0;
+        const blocksToDelete = [];
+        // Find all blocks up to the specified block number
+        for (const [block, txHashes] of this.blockToDeletedMinedTxHash.entries()){
+            if (block <= blockNumber) {
+                // Permanently delete all transactions from this block
+                for (const txHash of txHashes){
+                    this.txs.delete(txHash);
+                    this.deletedMinedTxHashes.delete(txHash);
+                    deletedCount++;
+                }
+                blocksToDelete.push(block);
+            }
+        }
+        // Clean up block-to-hash mapping
+        for (const block of blocksToDelete){
+            this.blockToDeletedMinedTxHash.delete(block);
+        }
+        if (deletedCount > 0) {
+            this.log.debug(`Permanently deleted ${deletedCount} deleted mined txs from blocks up to ${blockNumber}`);
+        }
+        return Promise.resolve(deletedCount);
+    }
 }

package/dest/mem_pools/tx_pool/priority.js

@@ -5,6 +5,6 @@ import { Buffer32 } from '@aztec/foundation/buffer';
  * We currently use the sum of the priority fees for the tx for this value, represented as hex.
  */ export function getPendingTxPriority(tx) {
     const priorityFees = tx.getGasSettings().maxPriorityFeesPerGas;
-    const totalFees = priorityFees.feePerDaGas.toBigInt() + priorityFees.feePerL2Gas.toBigInt();
+    const totalFees = priorityFees.feePerDaGas + priorityFees.feePerL2Gas;
     return Buffer32.fromBigInt(totalFees).toString();
 }

package/dest/mem_pools/tx_pool/tx_pool.d.ts

@@ -1,19 +1,52 @@
-import type { Tx, TxHash } from '@aztec/stdlib/tx';
+import type { TypedEventEmitter } from '@aztec/foundation/types';
+import type { BlockHeader, Tx, TxHash } from '@aztec/stdlib/tx';
+export type TxPoolOptions = {
+    maxTxPoolSize?: number;
+    txPoolOverflowFactor?: number;
+    archivedTxLimit?: number;
+};
+export type TxPoolEvents = {
+    ['txs-added']: (args: {
+        txs: Tx[];
+        source?: string;
+    }) => void | Promise<void>;
+};
 /**
  * Interface of a transaction pool. The pool includes tx requests and is kept up-to-date by a P2P client.
  */
-export interface TxPool {
+export interface TxPool extends TypedEventEmitter<TxPoolEvents> {
     /**
      * Adds a list of transactions to the pool. Duplicates are ignored.
      * @param txs - An array of txs to be added to the pool.
+     * @returns The number of txs added to the pool. Note if the transaction already exists, it will not be added again.
      */
-    addTxs(txs: Tx[]): Promise<void>;
+    addTxs(txs: Tx[], opts?: {
+        source?: string;
+    }): Promise<number>;
     /**
      * Checks if a transaction exists in the pool and returns it.
      * @param txHash - The hash of the transaction, used as an ID.
      * @returns The transaction, if found, 'undefined' otherwise.
      */
     getTxByHash(txHash: TxHash): Promise<Tx | undefined>;
+    /**
+     * Checks if transactions exist in the pool and returns them.
+     * @param txHashes - The hashes of the transactions
+     * @returns The transactions, if found, 'undefined' otherwise.
+     */
+    getTxsByHash(txHashes: TxHash[]): Promise<(Tx | undefined)[]>;
+    /**
+     * Checks if transactions exist in the pool
+     * @param txHashes - The hashes of the transactions to check for
+     * @returns True or False for each tx hash
+     */
+    hasTxs(txHashes: TxHash[]): Promise<boolean[]>;
+    /**
+     * Checks if a transaction exists in the pool
+     * @param txHash - The hash of the transaction to check for
+     * @returns True if the transaction exists, false otherwise
+     */
+    hasTx(txHash: TxHash): Promise<boolean>;
     /**
      * Checks if an archived transaction exists in the pool and returns it.
      * @param txHash - The hash of the transaction, used as an ID.
@@ -23,8 +56,9 @@ export interface TxPool {
     /**
      * Marks the set of txs as mined, as opposed to pending.
      * @param txHashes - Hashes of the txs to flag as mined.
+     * @param blockHeader - The header of the mined block.
      */
-    markAsMined(txHashes: TxHash[], blockNumber: number): Promise<void>;
+    markAsMined(txHashes: TxHash[], blockHeader: BlockHeader): Promise<void>;
     /**
      * Moves mined txs back to the pending set in the case of a reorg.
      * Note: txs not known by this peer will be ignored.
@@ -35,7 +69,9 @@ export interface TxPool {
      * Deletes transactions from the pool. Tx hashes that are not present are ignored.
      * @param txHashes - An array of tx hashes to be removed from the tx pool.
      */
-    deleteTxs(txHashes: TxHash[]): Promise<void>;
+    deleteTxs(txHashes: TxHash[], opts?: {
+        permanently?: boolean;
+    }): Promise<void>;
     /**
      * Gets all transactions currently in the tx pool.
      * @returns An array of transaction objects found in the tx pool.
@@ -51,16 +87,36 @@ export interface TxPool {
      * @returns An array of pending transaction hashes found in the tx pool.
      */
     getPendingTxHashes(): Promise<TxHash[]>;
+    /** Returns the number of pending txs in the pool. */
+    getPendingTxCount(): Promise<number>;
     /**
      * Gets the hashes of mined transactions currently in the tx pool.
      * @returns An array of mined transaction hashes found in the tx pool.
      */
     getMinedTxHashes(): Promise<[tx: TxHash, blockNumber: number][]>;
     /**
-     * Returns whether the given tx hash is flagged as pending or mined.
+     * Returns whether the given tx hash is flagged as pending, mined, or deleted.
      * @param txHash - Hash of the tx to query.
-     * @returns Pending or mined depending on its status, or undefined if not found.
+     * @returns Pending, mined, or deleted depending on its status, or undefined if not found.
+     */
+    getTxStatus(txHash: TxHash): Promise<'pending' | 'mined' | 'deleted' | undefined>;
+    /**
+     * Configure the maximum size of the tx pool
+     * @param maxSizeBytes - The maximum size in bytes of the mempool. Set to undefined to disable it
+     */
+    updateConfig(config: TxPoolOptions): void;
+    /** Returns whether the pool is empty. */
+    isEmpty(): Promise<boolean>;
+    /**
+     * Marks transactions as non-evictible in the pool.
+     * @param txHashes - Hashes of the transactions to mark as non-evictible.
+     */
+    markTxsAsNonEvictable(txHashes: TxHash[]): Promise<void>;
+    /**
+     * Permanently deletes deleted mined transactions from blocks up to and including the specified block number.
+     * @param blockNumber - Block number threshold. Deleted mined txs from this block or earlier will be permanently deleted.
+     * @returns The number of transactions permanently deleted.
      */
-    getTxStatus(txHash: TxHash): Promise<'pending' | 'mined' | undefined>;
+    cleanupDeletedMinedTxs(blockNumber: number): Promise<number>;
 }
 //# sourceMappingURL=tx_pool.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"tx_pool.d.ts","sourceRoot":"","sources":["../../../src/mem_pools/tx_pool/tx_pool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjC;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC;IAErD;;;;OAIG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC;IAE7D;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpE;;;;OAIG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtD;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C;;;OAGG;IACH,SAAS,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;IAE3B;;;OAGG;IACH,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEpC;;;OAGG;IACH,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAExC;;;OAGG;IACH,gBAAgB,IAAI,OAAO,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IAEjE;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;CACvE"}
+{"version":3,"file":"tx_pool.d.ts","sourceRoot":"","sources":["../../../src/mem_pools/tx_pool/tx_pool.ts"],"names":[],"mappings":"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"}

package/dest/mem_pools/tx_pool/tx_pool_test_suite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tx_pool_test_suite.d.ts","sourceRoot":"","sources":["../../../src/mem_pools/tx_pool/tx_pool_test_suite.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,MAAM,QAsHrD"}
+{"version":3,"file":"tx_pool_test_suite.d.ts","sourceRoot":"","sources":["../../../src/mem_pools/tx_pool/tx_pool_test_suite.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,MAAM,QA6SrD"}