@aztec/p2p 0.0.0-test.0

package/dest/mem_pools/attestation_pool/kv_attestation_pool.js

@@ -0,0 +1,112 @@
+import { Fr } from '@aztec/foundation/fields';
+import { toArray } from '@aztec/foundation/iterable';
+import { createLogger } from '@aztec/foundation/log';
+import { BlockAttestation } from '@aztec/stdlib/p2p';
+import { getTelemetryClient } from '@aztec/telemetry-client';
+import { PoolInstrumentation, PoolName } from '../instrumentation.js';
+export class KvAttestationPool {
+    store;
+    log;
+    metrics;
+    attestations;
+    proposalsForSlot;
+    attestationsForProposal;
+    constructor(store, telemetry = getTelemetryClient(), log = createLogger('aztec:attestation_pool')){
+        this.store = store;
+        this.log = log;
+        this.attestations = store.openMap('attestations');
+        this.proposalsForSlot = store.openMultiMap('proposals_for_slot');
+        this.attestationsForProposal = store.openMultiMap('attestations_for_proposal');
+        this.metrics = new PoolInstrumentation(telemetry, PoolName.ATTESTATION_POOL);
+    }
+    getProposalKey(slot, proposalId) {
+        const slotStr = typeof slot === 'string' ? slot : new Fr(slot).toString();
+        const proposalIdStr = typeof proposalId === 'string' ? proposalId : Buffer.isBuffer(proposalId) ? Fr.fromBuffer(proposalId).toString() : proposalId.toString();
+        return `${slotStr}-${proposalIdStr}`;
+    }
+    getAttestationKey(slot, proposalId, address) {
+        return `${this.getProposalKey(slot, proposalId)}-${address}`;
+    }
+    async addAttestations(attestations) {
+        await this.store.transactionAsync(async ()=>{
+            for (const attestation of attestations){
+                const slotNumber = attestation.payload.header.globalVariables.slotNumber;
+                const proposalId = attestation.archive;
+                const address = (await attestation.getSender()).toString();
+                await this.attestations.set(this.getAttestationKey(slotNumber, proposalId, address), attestation.toBuffer());
+                await this.proposalsForSlot.set(slotNumber.toString(), proposalId.toString());
+                await this.attestationsForProposal.set(this.getProposalKey(slotNumber, proposalId), this.getAttestationKey(slotNumber, proposalId, address));
+                this.log.verbose(`Added attestation for slot ${slotNumber} from ${address}`);
+            }
+        });
+        this.metrics.recordAddedObjects(attestations.length);
+    }
+    async getAttestationsForSlot(slot, proposalId) {
+        const attestationIds = await toArray(this.attestationsForProposal.getValuesAsync(this.getProposalKey(slot, proposalId)));
+        const attestations = [];
+        // alternatively iterate this.attestaions starting from slot-proposal-EthAddress.zero
+        for (const id of attestationIds){
+            const buf = await this.attestations.getAsync(id);
+            if (!buf) {
+                // this should not happen unless we lost writes
+                throw new Error('Attestation not found ' + id);
+            }
+            const attestation = BlockAttestation.fromBuffer(buf);
+            attestations.push(attestation);
+        }
+        return attestations;
+    }
+    async deleteAttestationsOlderThan(oldestSlot) {
+        const olderThan = await toArray(this.proposalsForSlot.keysAsync({
+            end: new Fr(oldestSlot).toString()
+        }));
+        for (const oldSlot of olderThan){
+            await this.deleteAttestationsForSlot(BigInt(oldSlot));
+        }
+    }
+    async deleteAttestationsForSlot(slot) {
+        const slotFr = new Fr(slot);
+        let numberOfAttestations = 0;
+        await this.store.transactionAsync(async ()=>{
+            const proposalIds = await toArray(this.proposalsForSlot.getValuesAsync(slotFr.toString()));
+            for (const proposalId of proposalIds){
+                const attestations = await toArray(this.attestationsForProposal.getValuesAsync(this.getProposalKey(slotFr, proposalId)));
+                numberOfAttestations += attestations.length;
+                for (const attestation of attestations){
+                    await this.attestations.delete(attestation);
+                }
+                await this.attestationsForProposal.delete(this.getProposalKey(slotFr, proposalId));
+            }
+        });
+        this.log.verbose(`Removed ${numberOfAttestations} attestations for slot ${slot}`);
+        this.metrics.recordRemovedObjects(numberOfAttestations);
+    }
+    async deleteAttestationsForSlotAndProposal(slot, proposalId) {
+        let numberOfAttestations = 0;
+        await this.store.transactionAsync(async ()=>{
+            const slotString = new Fr(slot).toString();
+            const attestations = await toArray(this.attestationsForProposal.getValuesAsync(this.getProposalKey(slot, proposalId)));
+            numberOfAttestations += attestations.length;
+            for (const attestation of attestations){
+                await this.attestations.delete(attestation);
+            }
+            await this.proposalsForSlot.deleteValue(slotString, proposalId);
+            await this.attestationsForProposal.delete(this.getProposalKey(slotString, proposalId));
+        });
+        this.log.verbose(`Removed ${numberOfAttestations} attestations for slot ${slot} and proposal ${proposalId}`);
+        this.metrics.recordRemovedObjects(numberOfAttestations);
+    }
+    async deleteAttestations(attestations) {
+        await this.store.transactionAsync(async ()=>{
+            for (const attestation of attestations){
+                const slotNumber = attestation.payload.header.globalVariables.slotNumber;
+                const proposalId = attestation.archive;
+                const address = (await attestation.getSender()).toString();
+                await this.attestations.delete(this.getAttestationKey(slotNumber, proposalId, address));
+                await this.attestationsForProposal.deleteValue(this.getProposalKey(slotNumber, proposalId), this.getAttestationKey(slotNumber, proposalId, address));
+                this.log.debug(`Deleted attestation for slot ${slotNumber} from ${address}`);
+            }
+        });
+        this.metrics.recordRemovedObjects(attestations.length);
+    }
+}

package/dest/mem_pools/attestation_pool/memory_attestation_pool.d.ts

@@ -0,0 +1,17 @@
+import type { BlockAttestation } from '@aztec/stdlib/p2p';
+import { type TelemetryClient } from '@aztec/telemetry-client';
+import type { AttestationPool } from './attestation_pool.js';
+export declare class InMemoryAttestationPool implements AttestationPool {
+    #private;
+    private log;
+    private metrics;
+    private attestations;
+    constructor(telemetry?: TelemetryClient, log?: import("@aztec/foundation/log").Logger);
+    getAttestationsForSlot(slot: bigint, proposalId: string): Promise<BlockAttestation[]>;
+    addAttestations(attestations: BlockAttestation[]): Promise<void>;
+    deleteAttestationsOlderThan(oldestSlot: bigint): Promise<void>;
+    deleteAttestationsForSlot(slot: bigint): Promise<void>;
+    deleteAttestationsForSlotAndProposal(slot: bigint, proposalId: string): Promise<void>;
+    deleteAttestations(attestations: BlockAttestation[]): Promise<void>;
+}
+//# sourceMappingURL=memory_attestation_pool.d.ts.map

package/dest/mem_pools/attestation_pool/memory_attestation_pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory_attestation_pool.d.ts","sourceRoot":"","sources":["../../../src/mem_pools/attestation_pool/memory_attestation_pool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,KAAK,eAAe,EAAsB,MAAM,yBAAyB,CAAC;AAGnF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,qBAAa,uBAAwB,YAAW,eAAe;;IAKE,OAAO,CAAC,GAAG;IAJ1E,OAAO,CAAC,OAAO,CAAwC;IAEvD,OAAO,CAAC,YAAY,CAAgG;gBAExG,SAAS,GAAE,eAAsC,EAAU,GAAG,yCAAuC;IAK1G,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAW/E,eAAe,CAAC,YAAY,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgChE,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBpE,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWtD,oCAAoC,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe/E,kBAAkB,CAAC,YAAY,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAiBjF"}

package/dest/mem_pools/attestation_pool/memory_attestation_pool.js

@@ -0,0 +1,129 @@
+import { createLogger } from '@aztec/foundation/log';
+import { getTelemetryClient } from '@aztec/telemetry-client';
+import { PoolInstrumentation, PoolName } from '../instrumentation.js';
+export class InMemoryAttestationPool {
+    log;
+    metrics;
+    attestations;
+    constructor(telemetry = getTelemetryClient(), log = createLogger('p2p:attestation_pool')){
+        this.log = log;
+        this.attestations = new Map();
+        this.metrics = new PoolInstrumentation(telemetry, PoolName.ATTESTATION_POOL);
+    }
+    getAttestationsForSlot(slot, proposalId) {
+        const slotAttestationMap = this.attestations.get(slot);
+        if (slotAttestationMap) {
+            const proposalAttestationMap = slotAttestationMap.get(proposalId);
+            if (proposalAttestationMap) {
+                return Promise.resolve(Array.from(proposalAttestationMap.values()));
+            }
+        }
+        return Promise.resolve([]);
+    }
+    async addAttestations(attestations) {
+        for (const attestation of attestations){
+            // Perf: order and group by slot before insertion
+            const slotNumber = attestation.payload.header.globalVariables.slotNumber;
+            const proposalId = attestation.archive.toString();
+            const address = await attestation.getSender();
+            const slotAttestationMap = getSlotOrDefault(this.attestations, slotNumber.toBigInt());
+            const proposalAttestationMap = getProposalOrDefault(slotAttestationMap, proposalId);
+            proposalAttestationMap.set(address.toString(), attestation);
+            this.log.verbose(`Added attestation for slot ${slotNumber} from ${address}`);
+        }
+        // TODO: set these to pending or something ????
+        this.metrics.recordAddedObjects(attestations.length);
+        return Promise.resolve();
+    }
+    #getNumberOfAttestationsInSlot(slot) {
+        let total = 0;
+        const slotAttestationMap = getSlotOrDefault(this.attestations, slot);
+        if (slotAttestationMap) {
+            for (const proposalAttestationMap of slotAttestationMap.values() ?? []){
+                total += proposalAttestationMap.size;
+            }
+        }
+        return total;
+    }
+    async deleteAttestationsOlderThan(oldestSlot) {
+        const olderThan = [];
+        // Entries are iterated in insertion order, so we can break as soon as we find a slot that is older than the oldestSlot.
+        // Note: this will only prune correctly if attestations are added in order of rising slot, it is important that we do not allow
+        // insertion of attestations that are old. #(https://github.com/AztecProtocol/aztec-packages/issues/10322)
+        const slots = this.attestations.keys();
+        for (const slot of slots){
+            if (slot < oldestSlot) {
+                olderThan.push(slot);
+            } else {
+                break;
+            }
+        }
+        for (const oldSlot of olderThan){
+            await this.deleteAttestationsForSlot(oldSlot);
+        }
+        return Promise.resolve();
+    }
+    deleteAttestationsForSlot(slot) {
+        // We count the number of attestations we are removing
+        const numberOfAttestations = this.#getNumberOfAttestationsInSlot(slot);
+        this.attestations.delete(slot);
+        this.log.verbose(`Removed ${numberOfAttestations} attestations for slot ${slot}`);
+        this.metrics.recordRemovedObjects(numberOfAttestations);
+        return Promise.resolve();
+    }
+    deleteAttestationsForSlotAndProposal(slot, proposalId) {
+        const slotAttestationMap = getSlotOrDefault(this.attestations, slot);
+        if (slotAttestationMap) {
+            if (slotAttestationMap.has(proposalId)) {
+                const numberOfAttestations = slotAttestationMap.get(proposalId)?.size ?? 0;
+                slotAttestationMap.delete(proposalId);
+                this.log.verbose(`Removed ${numberOfAttestations} attestations for slot ${slot} and proposal ${proposalId}`);
+                this.metrics.recordRemovedObjects(numberOfAttestations);
+            }
+        }
+        return Promise.resolve();
+    }
+    async deleteAttestations(attestations) {
+        for (const attestation of attestations){
+            const slotNumber = attestation.payload.header.globalVariables.slotNumber;
+            const slotAttestationMap = this.attestations.get(slotNumber.toBigInt());
+            if (slotAttestationMap) {
+                const proposalId = attestation.archive.toString();
+                const proposalAttestationMap = getProposalOrDefault(slotAttestationMap, proposalId);
+                if (proposalAttestationMap) {
+                    const address = await attestation.getSender();
+                    proposalAttestationMap.delete(address.toString());
+                    this.log.debug(`Deleted attestation for slot ${slotNumber} from ${address}`);
+                }
+            }
+        }
+        this.metrics.recordRemovedObjects(attestations.length);
+        return Promise.resolve();
+    }
+}
+/**
+ * Get Slot or Default
+ *
+ * Fetch the slot mapping, if it does not exist, then create a mapping and return it
+ * @param map - The map to fetch from
+ * @param slot - The slot to fetch
+ * @returns The slot mapping
+ */ function getSlotOrDefault(map, slot) {
+    if (!map.has(slot)) {
+        map.set(slot, new Map());
+    }
+    return map.get(slot);
+}
+/**
+ * Get Proposal or Default
+ *
+ * Fetch the proposal mapping, if it does not exist, then create a mapping and return it
+ * @param map - The map to fetch from
+ * @param proposalId - The proposal id to fetch
+ * @returns The proposal mapping
+ */ function getProposalOrDefault(map, proposalId) {
+    if (!map.has(proposalId)) {
+        map.set(proposalId, new Map());
+    }
+    return map.get(proposalId);
+}

package/dest/mem_pools/attestation_pool/mocks.d.ts

@@ -0,0 +1,19 @@
+import type { Secp256k1Signer } from '@aztec/foundation/crypto';
+import { Fr } from '@aztec/foundation/fields';
+import { BlockAttestation } from '@aztec/stdlib/p2p';
+import { TxHash } from '@aztec/stdlib/tx';
+import { type LocalAccount } from 'viem/accounts';
+/** Generate Account
+ *
+ * Create a random signer
+ * @returns A random viem signer
+ */
+export declare const generateAccount: () => LocalAccount;
+/** Mock Attestation
+ *
+ * @param signer A viem signer to create a signature
+ * @param slot The slot number the attestation is for
+ * @returns A Block Attestation
+ */
+export declare const mockAttestation: (signer: Secp256k1Signer, slot?: number, archive?: Fr, txs?: TxHash[]) => Promise<BlockAttestation>;
+//# sourceMappingURL=mocks.d.ts.map

package/dest/mem_pools/attestation_pool/mocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mocks.d.ts","sourceRoot":"","sources":["../../../src/mem_pools/attestation_pool/mocks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAC9C,OAAO,EACL,gBAAgB,EAIjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,OAAO,EAAE,KAAK,YAAY,EAA2C,MAAM,eAAe,CAAC;AAE3F;;;;GAIG;AACH,eAAO,MAAM,eAAe,QAAO,YAGlC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,WAClB,eAAe,SACjB,MAAM,YACH,EAAE,QACN,MAAM,EAAE,KACZ,QAAQ,gBAAgB,CAS1B,CAAC"}

package/dest/mem_pools/attestation_pool/mocks.js

@@ -0,0 +1,33 @@
+import { Fr } from '@aztec/foundation/fields';
+import { BlockAttestation, ConsensusPayload, SignatureDomainSeparator, getHashedSignaturePayloadEthSignedMessage } from '@aztec/stdlib/p2p';
+import { makeHeader } from '@aztec/stdlib/testing';
+import { TxHash } from '@aztec/stdlib/tx';
+import { generatePrivateKey, privateKeyToAccount } from 'viem/accounts';
+/** Generate Account
+ *
+ * Create a random signer
+ * @returns A random viem signer
+ */ export const generateAccount = ()=>{
+    const privateKey = generatePrivateKey();
+    return privateKeyToAccount(privateKey);
+};
+/** Mock Attestation
+ *
+ * @param signer A viem signer to create a signature
+ * @param slot The slot number the attestation is for
+ * @returns A Block Attestation
+ */ export const mockAttestation = async (signer, slot = 0, archive = Fr.random(), txs = [
+    0,
+    1,
+    2,
+    3,
+    4,
+    5
+].map(()=>TxHash.random()))=>{
+    // Use arbitrary numbers for all other than slot
+    const header = makeHeader(1, 2, slot);
+    const payload = new ConsensusPayload(header, archive, txs);
+    const hash = await getHashedSignaturePayloadEthSignedMessage(payload, SignatureDomainSeparator.blockAttestation);
+    const signature = signer.sign(hash);
+    return new BlockAttestation(payload, signature);
+};

package/dest/mem_pools/index.d.ts

@@ -0,0 +1,4 @@
+export { type AttestationPool } from './attestation_pool/attestation_pool.js';
+export { type MemPools } from './interface.js';
+export { type TxPool } from './tx_pool/tx_pool.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mem_pools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAC9E,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,sBAAsB,CAAC"}

package/dest/mem_pools/index.js

@@ -0,0 +1 @@
+export { };

package/dest/mem_pools/instrumentation.d.ts

@@ -0,0 +1,30 @@
+import type { Gossipable } from '@aztec/stdlib/p2p';
+import { type LmdbStatsCallback, type TelemetryClient } from '@aztec/telemetry-client';
+export declare enum PoolName {
+    TX_POOL = "TxPool",
+    ATTESTATION_POOL = "AttestationPool"
+}
+/**
+ * Instrumentation class for the Pools (TxPool, AttestationPool, etc).
+ */
+export declare class PoolInstrumentation<PoolObject extends Gossipable> {
+    /** The number of txs in the mempool */
+    private objectsInMempool;
+    /** Tracks tx size */
+    private objectSize;
+    private dbMetrics;
+    private defaultAttributes;
+    constructor(telemetry: TelemetryClient, name: PoolName, dbStats?: LmdbStatsCallback);
+    recordSize(poolObject: PoolObject): void;
+    /**
+     * Updates the metrics with the new objects.
+     * @param txs - The objects to record
+     */
+    recordAddedObjects(count?: number, status?: string): void;
+    /**
+     * Updates the metrics by removing objects from the mempool.
+     * @param count - The number of objects to remove from the mempool
+     */
+    recordRemovedObjects(count?: number, status?: string): void;
+}
+//# sourceMappingURL=instrumentation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.d.ts","sourceRoot":"","sources":["../../src/mem_pools/instrumentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAIL,KAAK,iBAAiB,EAGtB,KAAK,eAAe,EAErB,MAAM,yBAAyB,CAAC;AAEjC,oBAAY,QAAQ;IAClB,OAAO,WAAW;IAClB,gBAAgB,oBAAoB;CACrC;AA4BD;;GAEG;AACH,qBAAa,mBAAmB,CAAC,UAAU,SAAS,UAAU;IAC5D,uCAAuC;IACvC,OAAO,CAAC,gBAAgB,CAAgB;IACxC,qBAAqB;IACrB,OAAO,CAAC,UAAU,CAAY;IAE9B,OAAO,CAAC,SAAS,CAAc;IAE/B,OAAO,CAAC,iBAAiB,CAAC;gBAEd,SAAS,EAAE,eAAe,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,iBAAiB;IAwB5E,UAAU,CAAC,UAAU,EAAE,UAAU;IAIxC;;;OAGG;IACI,kBAAkB,CAAC,KAAK,SAAI,EAAE,MAAM,CAAC,EAAE,MAAM;IAiBpD;;;OAGG;IACI,oBAAoB,CAAC,KAAK,SAAI,EAAE,MAAM,CAAC,EAAE,MAAM;CAgBvD"}

package/dest/mem_pools/instrumentation.js

@@ -0,0 +1,84 @@
+import { Attributes, LmdbMetrics, Metrics } from '@aztec/telemetry-client';
+export var PoolName = /*#__PURE__*/ function(PoolName) {
+    PoolName["TX_POOL"] = "TxPool";
+    PoolName["ATTESTATION_POOL"] = "AttestationPool";
+    return PoolName;
+}({});
+/**
+ * Get the metrics labels for a given pool name.
+ * They must all have different names, as if duplicates appear, it will brick
+ * the metrics instance
+ */ function getMetricsLabels(name) {
+    if (name === "TxPool") {
+        return {
+            objectInMempool: Metrics.MEMPOOL_TX_COUNT,
+            objectSize: Metrics.MEMPOOL_TX_SIZE
+        };
+    } else if (name === "AttestationPool") {
+        return {
+            objectInMempool: Metrics.MEMPOOL_ATTESTATIONS_COUNT,
+            objectSize: Metrics.MEMPOOL_ATTESTATIONS_SIZE
+        };
+    }
+    throw new Error('Invalid pool type');
+}
+/**
+ * Instrumentation class for the Pools (TxPool, AttestationPool, etc).
+ */ export class PoolInstrumentation {
+    /** The number of txs in the mempool */ objectsInMempool;
+    /** Tracks tx size */ objectSize;
+    dbMetrics;
+    defaultAttributes;
+    constructor(telemetry, name, dbStats){
+        const meter = telemetry.getMeter(name);
+        this.defaultAttributes = {
+            [Attributes.POOL_NAME]: name
+        };
+        const metricsLabels = getMetricsLabels(name);
+        this.objectsInMempool = meter.createUpDownCounter(metricsLabels.objectInMempool, {
+            description: 'The current number of transactions in the mempool'
+        });
+        this.objectSize = meter.createHistogram(metricsLabels.objectSize, {
+            unit: 'By',
+            description: 'The size of transactions in the mempool'
+        });
+        this.dbMetrics = new LmdbMetrics(meter, {
+            [Attributes.DB_DATA_TYPE]: 'tx-pool'
+        }, dbStats);
+    }
+    recordSize(poolObject) {
+        this.objectSize.record(poolObject.getSize());
+    }
+    /**
+   * Updates the metrics with the new objects.
+   * @param txs - The objects to record
+   */ recordAddedObjects(count = 1, status) {
+        if (count < 0) {
+            throw new Error('Count must be positive');
+        }
+        if (count === 0) {
+            return;
+        }
+        const attributes = status ? {
+            ...this.defaultAttributes,
+            [Attributes.STATUS]: status
+        } : this.defaultAttributes;
+        this.objectsInMempool.add(count, attributes);
+    }
+    /**
+   * Updates the metrics by removing objects from the mempool.
+   * @param count - The number of objects to remove from the mempool
+   */ recordRemovedObjects(count = 1, status) {
+        if (count < 0) {
+            throw new Error('Count must be positive');
+        }
+        if (count === 0) {
+            return;
+        }
+        const attributes = status ? {
+            ...this.defaultAttributes,
+            [Attributes.STATUS]: status
+        } : this.defaultAttributes;
+        this.objectsInMempool.add(-1 * count, attributes);
+    }
+}

package/dest/mem_pools/interface.d.ts

@@ -0,0 +1,11 @@
+import type { P2PClientType } from '@aztec/stdlib/p2p';
+import type { AttestationPool } from './attestation_pool/attestation_pool.js';
+import type { TxPool } from './tx_pool/tx_pool.js';
+/**
+ * A interface the combines all mempools
+ */
+export type MemPools<T extends P2PClientType = P2PClientType.Full> = {
+    txPool: TxPool;
+    attestationPool?: T extends P2PClientType.Full ? AttestationPool : undefined;
+};
+//# sourceMappingURL=interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/mem_pools/interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAC9E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa,CAAC,IAAI,IAAI;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,CAAC,SAAS,aAAa,CAAC,IAAI,GAAG,eAAe,GAAG,SAAS,CAAC;CAC9E,CAAC"}

package/dest/mem_pools/interface.js

@@ -0,0 +1,3 @@
+/**
+ * A interface the combines all mempools
+ */ export { };

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

@@ -0,0 +1,66 @@
+import { type Logger } from '@aztec/foundation/log';
+import type { AztecAsyncKVStore } from '@aztec/kv-store';
+import { Tx, TxHash } from '@aztec/stdlib/tx';
+import { type TelemetryClient } from '@aztec/telemetry-client';
+import type { TxPool } from './tx_pool.js';
+/**
+ * KV implementation of the Transaction Pool.
+ */
+export declare class AztecKVTxPool implements TxPool {
+    #private;
+    /**
+     * Class constructor for KV TxPool. Initiates our transaction pool as an AztecMap.
+     * @param store - A KV store for live txs in the pool.
+     * @param archive - A KV store for archived txs.
+     * @param telemetry - A telemetry client.
+     * @param archivedTxLimit - The number of txs to archive.
+     * @param log - A logger.
+     */
+    constructor(store: AztecAsyncKVStore, archive: AztecAsyncKVStore, telemetry?: TelemetryClient, archivedTxLimit?: number, log?: Logger);
+    markAsMined(txHashes: TxHash[], blockNumber: number): Promise<void>;
+    markMinedAsPending(txHashes: TxHash[]): Promise<void>;
+    getPendingTxHashes(): Promise<TxHash[]>;
+    getMinedTxHashes(): Promise<[TxHash, number][]>;
+    getTxStatus(txHash: TxHash): Promise<'pending' | 'mined' | 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>;
+    /**
+     * Checks if an archived tx exists and returns it.
+     * @param txHash - The tx hash.
+     * @returns The transaction metadata, if found, 'undefined' otherwise.
+     */
+    getArchivedTxByHash(txHash: TxHash): 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>;
+    /**
+     * 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 Empty promise.
+     */
+    deleteTxs(txHashes: TxHash[]): Promise<void>;
+    /**
+     * Gets all the transactions stored in the pool.
+     * @returns Array of tx objects in the order they were added to the pool.
+     */
+    getAllTxs(): Promise<Tx[]>;
+    /**
+     * Gets the hashes of all transactions currently in the tx pool.
+     * @returns An array of transaction hashes found in the tx pool.
+     */
+    getAllTxHashes(): Promise<TxHash[]>;
+    /**
+     * Archives a list of txs for future reference. The number of archived txs is limited by the specified archivedTxLimit.
+     * @param txs - The list of transactions to archive.
+     * @returns Empty promise.
+     */
+    private archiveTxs;
+}
+//# sourceMappingURL=aztec_kv_tx_pool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"aztec_kv_tx_pool.d.ts","sourceRoot":"","sources":["../../../src/mem_pools/tx_pool/aztec_kv_tx_pool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAqC,MAAM,iBAAiB,CAAC;AAG5F,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,aAAc,YAAW,MAAM;;IA4B1C;;;;;;;OAOG;gBAED,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,iBAAiB,EAC1B,SAAS,GAAE,eAAsC,EACjD,eAAe,GAAE,MAAU,EAC3B,GAAG,SAA8B;IAgB5B,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBnE,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB/C,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKvC,gBAAgB,IAAI,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IAK/C,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IAalF;;;;OAIG;IACU,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,EAAE,GAAG,SAAS,CAAC;IAUjE;;;;OAIG;IACU,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,EAAE,GAAG,SAAS,CAAC;IAUzE;;;;OAIG;IACU,MAAM,CAAC,GAAG,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B7C;;;;OAIG;IACI,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAqCnD;;;OAGG;IACU,SAAS,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC;IASvC;;;OAGG;IACU,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKhD;;;;OAIG;YACW,UAAU;CAiCzB"}