@aztec-labs/p2p 6.0.0-nightly.20260829

package/dest/client/p2p_client.js

@@ -0,0 +1,1051 @@
+function applyDecs2203RFactory() {
+    function createAddInitializerMethod(initializers, decoratorFinishedRef) {
+        return function addInitializer(initializer) {
+            assertNotFinished(decoratorFinishedRef, "addInitializer");
+            assertCallable(initializer, "An initializer");
+            initializers.push(initializer);
+        };
+    }
+    function memberDec(dec, name, desc, initializers, kind, isStatic, isPrivate, metadata, value) {
+        var kindStr;
+        switch(kind){
+            case 1:
+                kindStr = "accessor";
+                break;
+            case 2:
+                kindStr = "method";
+                break;
+            case 3:
+                kindStr = "getter";
+                break;
+            case 4:
+                kindStr = "setter";
+                break;
+            default:
+                kindStr = "field";
+        }
+        var ctx = {
+            kind: kindStr,
+            name: isPrivate ? "#" + name : name,
+            static: isStatic,
+            private: isPrivate,
+            metadata: metadata
+        };
+        var decoratorFinishedRef = {
+            v: false
+        };
+        ctx.addInitializer = createAddInitializerMethod(initializers, decoratorFinishedRef);
+        var get, set;
+        if (kind === 0) {
+            if (isPrivate) {
+                get = desc.get;
+                set = desc.set;
+            } else {
+                get = function() {
+                    return this[name];
+                };
+                set = function(v) {
+                    this[name] = v;
+                };
+            }
+        } else if (kind === 2) {
+            get = function() {
+                return desc.value;
+            };
+        } else {
+            if (kind === 1 || kind === 3) {
+                get = function() {
+                    return desc.get.call(this);
+                };
+            }
+            if (kind === 1 || kind === 4) {
+                set = function(v) {
+                    desc.set.call(this, v);
+                };
+            }
+        }
+        ctx.access = get && set ? {
+            get: get,
+            set: set
+        } : get ? {
+            get: get
+        } : {
+            set: set
+        };
+        try {
+            return dec(value, ctx);
+        } finally{
+            decoratorFinishedRef.v = true;
+        }
+    }
+    function assertNotFinished(decoratorFinishedRef, fnName) {
+        if (decoratorFinishedRef.v) {
+            throw new Error("attempted to call " + fnName + " after decoration was finished");
+        }
+    }
+    function assertCallable(fn, hint) {
+        if (typeof fn !== "function") {
+            throw new TypeError(hint + " must be a function");
+        }
+    }
+    function assertValidReturnValue(kind, value) {
+        var type = typeof value;
+        if (kind === 1) {
+            if (type !== "object" || value === null) {
+                throw new TypeError("accessor decorators must return an object with get, set, or init properties or void 0");
+            }
+            if (value.get !== undefined) {
+                assertCallable(value.get, "accessor.get");
+            }
+            if (value.set !== undefined) {
+                assertCallable(value.set, "accessor.set");
+            }
+            if (value.init !== undefined) {
+                assertCallable(value.init, "accessor.init");
+            }
+        } else if (type !== "function") {
+            var hint;
+            if (kind === 0) {
+                hint = "field";
+            } else if (kind === 10) {
+                hint = "class";
+            } else {
+                hint = "method";
+            }
+            throw new TypeError(hint + " decorators must return a function or void 0");
+        }
+    }
+    function applyMemberDec(ret, base, decInfo, name, kind, isStatic, isPrivate, initializers, metadata) {
+        var decs = decInfo[0];
+        var desc, init, value;
+        if (isPrivate) {
+            if (kind === 0 || kind === 1) {
+                desc = {
+                    get: decInfo[3],
+                    set: decInfo[4]
+                };
+            } else if (kind === 3) {
+                desc = {
+                    get: decInfo[3]
+                };
+            } else if (kind === 4) {
+                desc = {
+                    set: decInfo[3]
+                };
+            } else {
+                desc = {
+                    value: decInfo[3]
+                };
+            }
+        } else if (kind !== 0) {
+            desc = Object.getOwnPropertyDescriptor(base, name);
+        }
+        if (kind === 1) {
+            value = {
+                get: desc.get,
+                set: desc.set
+            };
+        } else if (kind === 2) {
+            value = desc.value;
+        } else if (kind === 3) {
+            value = desc.get;
+        } else if (kind === 4) {
+            value = desc.set;
+        }
+        var newValue, get, set;
+        if (typeof decs === "function") {
+            newValue = memberDec(decs, name, desc, initializers, kind, isStatic, isPrivate, metadata, value);
+            if (newValue !== void 0) {
+                assertValidReturnValue(kind, newValue);
+                if (kind === 0) {
+                    init = newValue;
+                } else if (kind === 1) {
+                    init = newValue.init;
+                    get = newValue.get || value.get;
+                    set = newValue.set || value.set;
+                    value = {
+                        get: get,
+                        set: set
+                    };
+                } else {
+                    value = newValue;
+                }
+            }
+        } else {
+            for(var i = decs.length - 1; i >= 0; i--){
+                var dec = decs[i];
+                newValue = memberDec(dec, name, desc, initializers, kind, isStatic, isPrivate, metadata, value);
+                if (newValue !== void 0) {
+                    assertValidReturnValue(kind, newValue);
+                    var newInit;
+                    if (kind === 0) {
+                        newInit = newValue;
+                    } else if (kind === 1) {
+                        newInit = newValue.init;
+                        get = newValue.get || value.get;
+                        set = newValue.set || value.set;
+                        value = {
+                            get: get,
+                            set: set
+                        };
+                    } else {
+                        value = newValue;
+                    }
+                    if (newInit !== void 0) {
+                        if (init === void 0) {
+                            init = newInit;
+                        } else if (typeof init === "function") {
+                            init = [
+                                init,
+                                newInit
+                            ];
+                        } else {
+                            init.push(newInit);
+                        }
+                    }
+                }
+            }
+        }
+        if (kind === 0 || kind === 1) {
+            if (init === void 0) {
+                init = function(instance, init) {
+                    return init;
+                };
+            } else if (typeof init !== "function") {
+                var ownInitializers = init;
+                init = function(instance, init) {
+                    var value = init;
+                    for(var i = 0; i < ownInitializers.length; i++){
+                        value = ownInitializers[i].call(instance, value);
+                    }
+                    return value;
+                };
+            } else {
+                var originalInitializer = init;
+                init = function(instance, init) {
+                    return originalInitializer.call(instance, init);
+                };
+            }
+            ret.push(init);
+        }
+        if (kind !== 0) {
+            if (kind === 1) {
+                desc.get = value.get;
+                desc.set = value.set;
+            } else if (kind === 2) {
+                desc.value = value;
+            } else if (kind === 3) {
+                desc.get = value;
+            } else if (kind === 4) {
+                desc.set = value;
+            }
+            if (isPrivate) {
+                if (kind === 1) {
+                    ret.push(function(instance, args) {
+                        return value.get.call(instance, args);
+                    });
+                    ret.push(function(instance, args) {
+                        return value.set.call(instance, args);
+                    });
+                } else if (kind === 2) {
+                    ret.push(value);
+                } else {
+                    ret.push(function(instance, args) {
+                        return value.call(instance, args);
+                    });
+                }
+            } else {
+                Object.defineProperty(base, name, desc);
+            }
+        }
+    }
+    function applyMemberDecs(Class, decInfos, metadata) {
+        var ret = [];
+        var protoInitializers;
+        var staticInitializers;
+        var existingProtoNonFields = new Map();
+        var existingStaticNonFields = new Map();
+        for(var i = 0; i < decInfos.length; i++){
+            var decInfo = decInfos[i];
+            if (!Array.isArray(decInfo)) continue;
+            var kind = decInfo[1];
+            var name = decInfo[2];
+            var isPrivate = decInfo.length > 3;
+            var isStatic = kind >= 5;
+            var base;
+            var initializers;
+            if (isStatic) {
+                base = Class;
+                kind = kind - 5;
+                staticInitializers = staticInitializers || [];
+                initializers = staticInitializers;
+            } else {
+                base = Class.prototype;
+                protoInitializers = protoInitializers || [];
+                initializers = protoInitializers;
+            }
+            if (kind !== 0 && !isPrivate) {
+                var existingNonFields = isStatic ? existingStaticNonFields : existingProtoNonFields;
+                var existingKind = existingNonFields.get(name) || 0;
+                if (existingKind === true || existingKind === 3 && kind !== 4 || existingKind === 4 && kind !== 3) {
+                    throw new Error("Attempted to decorate a public method/accessor that has the same name as a previously decorated public method/accessor. This is not currently supported by the decorators plugin. Property name was: " + name);
+                } else if (!existingKind && kind > 2) {
+                    existingNonFields.set(name, kind);
+                } else {
+                    existingNonFields.set(name, true);
+                }
+            }
+            applyMemberDec(ret, base, decInfo, name, kind, isStatic, isPrivate, initializers, metadata);
+        }
+        pushInitializers(ret, protoInitializers);
+        pushInitializers(ret, staticInitializers);
+        return ret;
+    }
+    function pushInitializers(ret, initializers) {
+        if (initializers) {
+            ret.push(function(instance) {
+                for(var i = 0; i < initializers.length; i++){
+                    initializers[i].call(instance);
+                }
+                return instance;
+            });
+        }
+    }
+    function applyClassDecs(targetClass, classDecs, metadata) {
+        if (classDecs.length > 0) {
+            var initializers = [];
+            var newClass = targetClass;
+            var name = targetClass.name;
+            for(var i = classDecs.length - 1; i >= 0; i--){
+                var decoratorFinishedRef = {
+                    v: false
+                };
+                try {
+                    var nextNewClass = classDecs[i](newClass, {
+                        kind: "class",
+                        name: name,
+                        addInitializer: createAddInitializerMethod(initializers, decoratorFinishedRef),
+                        metadata
+                    });
+                } finally{
+                    decoratorFinishedRef.v = true;
+                }
+                if (nextNewClass !== undefined) {
+                    assertValidReturnValue(10, nextNewClass);
+                    newClass = nextNewClass;
+                }
+            }
+            return [
+                defineMetadata(newClass, metadata),
+                function() {
+                    for(var i = 0; i < initializers.length; i++){
+                        initializers[i].call(newClass);
+                    }
+                }
+            ];
+        }
+    }
+    function defineMetadata(Class, metadata) {
+        return Object.defineProperty(Class, Symbol.metadata || Symbol.for("Symbol.metadata"), {
+            configurable: true,
+            enumerable: true,
+            value: metadata
+        });
+    }
+    return function applyDecs2203R(targetClass, memberDecs, classDecs, parentClass) {
+        if (parentClass !== void 0) {
+            var parentMetadata = parentClass[Symbol.metadata || Symbol.for("Symbol.metadata")];
+        }
+        var metadata = Object.create(parentMetadata === void 0 ? null : parentMetadata);
+        var e = applyMemberDecs(targetClass, memberDecs, metadata);
+        if (!classDecs.length) defineMetadata(targetClass, metadata);
+        return {
+            e: e,
+            get c () {
+                return applyClassDecs(targetClass, classDecs, metadata);
+            }
+        };
+    };
+}
+function _apply_decs_2203_r(targetClass, memberDecs, classDecs, parentClass) {
+    return (_apply_decs_2203_r = applyDecs2203RFactory())(targetClass, memberDecs, classDecs, parentClass);
+}
+var _dec, _dec1, _initProto;
+import { BlockNumber, CheckpointNumber, SlotNumber } from '@aztec-labs/foundation/branded-types';
+import { createLogger } from '@aztec-labs/foundation/log';
+import { promiseWithResolvers } from '@aztec-labs/foundation/promise';
+import { DateProvider } from '@aztec-labs/foundation/timer';
+import { L2TipsKVStore } from '@aztec-labs/kv-store/stores';
+import { EventDrivenL2BlockStream } from '@aztec-labs/stdlib/block';
+import { getTimestampForSlot } from '@aztec-labs/stdlib/epoch-helpers';
+import { tryStop } from '@aztec-labs/stdlib/interfaces/server';
+import { Attributes, WithTracer, getTelemetryClient, trackSpan } from '@aztec-labs/telemetry-client';
+import { getP2PDefaultConfig } from '../config.js';
+import { TxPoolError } from '../errors/tx-pool.error.js';
+import { TxProvider } from '../services/tx_provider.js';
+import { P2PClientState } from './interface.js';
+_dec = trackSpan('p2pClient.broadcastProposal', async (proposal)=>({
+        [Attributes.SLOT_NUMBER]: proposal.slotNumber,
+        [Attributes.BLOCK_ARCHIVE]: proposal.archive.toString(),
+        [Attributes.P2P_ID]: (await proposal.p2pMessageLoggingIdentifier()).toString()
+    })), _dec1 = trackSpan('p2pClient.broadcastCheckpointProposal', async (proposal)=>({
+        [Attributes.SLOT_NUMBER]: proposal.slotNumber,
+        [Attributes.BLOCK_ARCHIVE]: proposal.archive.toString(),
+        [Attributes.P2P_ID]: (await proposal.p2pMessageLoggingIdentifier()).toString()
+    }));
+/**
+ * The P2P client implementation.
+ */ export class P2PClient extends WithTracer {
+    store;
+    l2BlockSource;
+    p2pService;
+    txCollection;
+    txFileStore;
+    epochCache;
+    _dateProvider;
+    telemetry;
+    log;
+    static{
+        ({ e: [_initProto] } = _apply_decs_2203_r(this, [
+            [
+                _dec,
+                2,
+                "broadcastProposal"
+            ],
+            [
+                _dec1,
+                2,
+                "broadcastCheckpointProposal"
+            ]
+        ], []));
+    }
+    /** The JS promise that will be running to keep the client's data in sync. Can be interrupted if the client is stopped. */ runningPromise;
+    currentState;
+    syncPromise;
+    syncResolvers;
+    latestBlockNumberAtStart;
+    provenBlockNumberAtStart;
+    finalizedBlockNumberAtStart;
+    l2Tips;
+    synchedLatestSlot;
+    txPool;
+    attestationPool;
+    config;
+    blockStream;
+    txProvider;
+    validatorAddresses;
+    /** Tracks the last slot for which we called prepareForSlot */ lastSlotProcessed;
+    constructor(store, l2BlockSource, mempools, p2pService, txCollection, txFileStore, epochCache, config = {}, _dateProvider = new DateProvider(), telemetry = getTelemetryClient(), log = createLogger('p2p'), initialBlockHash){
+        super(telemetry, 'P2PClient'), this.store = store, this.l2BlockSource = l2BlockSource, this.p2pService = p2pService, this.txCollection = txCollection, this.txFileStore = txFileStore, this.epochCache = epochCache, this._dateProvider = _dateProvider, this.telemetry = telemetry, this.log = log, this.currentState = (_initProto(this), P2PClientState.IDLE), this.syncPromise = Promise.resolve(), this.syncResolvers = undefined, this.latestBlockNumberAtStart = -1, this.provenBlockNumberAtStart = -1, this.finalizedBlockNumberAtStart = -1, this.validatorAddresses = [], this.lastSlotProcessed = SlotNumber.ZERO;
+        this.config = {
+            ...getP2PDefaultConfig(),
+            ...config
+        };
+        this.txPool = mempools.txPool;
+        this.attestationPool = mempools.attestationPool;
+        this.txProvider = new TxProvider(this.txCollection, this.txPool, this, this.log.createChild('tx-provider'), this.telemetry);
+        this.l2Tips = new L2TipsKVStore(store, 'p2p_client', initialBlockHash);
+        this.synchedLatestSlot = store.openSingleton('p2p_pool_last_l2_slot');
+    }
+    registerThisValidatorAddresses(addresses) {
+        this.validatorAddresses = [
+            ...addresses
+        ];
+        this.p2pService.registerThisValidatorAddresses(this.validatorAddresses);
+    }
+    clear() {
+        return this.store.clear();
+    }
+    isP2PClient() {
+        return true;
+    }
+    getTxProvider() {
+        return this.txProvider;
+    }
+    getPeers(includePending) {
+        return Promise.resolve(this.p2pService.getPeers(includePending));
+    }
+    getP2PConnectivity() {
+        return Promise.resolve(this.p2pService.getP2PConnectivity());
+    }
+    getGossipMeshPeerCount(topicType) {
+        return Promise.resolve(this.p2pService.getGossipMeshPeerCount(topicType));
+    }
+    getL2BlockHash(number) {
+        return this.l2Tips.getL2BlockHash(number);
+    }
+    async updateP2PConfig(config) {
+        await this.txPool.updateConfig(config);
+        this.p2pService.updateConfig(config);
+    }
+    getL2Tips() {
+        return this.l2Tips.getL2Tips();
+    }
+    async handleBlockStreamEvent(event) {
+        this.log.debug(`Handling block stream event ${event.type}`);
+        switch(event.type){
+            case 'blocks-added':
+                await this.handleLatestL2Blocks(event.blocks);
+                break;
+            case 'chain-finalized':
+                {
+                    const oldFinalizedBlockNum = await this.getSyncedFinalizedBlockNum();
+                    const from = BlockNumber(oldFinalizedBlockNum + 1);
+                    const limit = event.block.number - from + 1;
+                    if (limit > 0) {
+                        const oldBlocks = await this.l2BlockSource.getBlocksData({
+                            from,
+                            limit
+                        });
+                        await this.handleFinalizedL2Blocks(oldBlocks);
+                    }
+                    break;
+                }
+            case 'chain-proven':
+                this.txCollection.stopCollectingForBlocksUpTo(event.block.number);
+                break;
+            case 'chain-pruned':
+                this.txCollection.stopCollectingForBlocksAfter(event.block.number);
+                await this.handlePruneL2Blocks(event.block, event.checkpointed.checkpoint);
+                break;
+            case 'chain-checkpointed':
+                break;
+            case 'chain-proposed':
+                break;
+            default:
+                {
+                    const _ = event;
+                    break;
+                }
+        }
+        // Pass the event through to our l2 tips store
+        await this.l2Tips.handleBlockStreamEvent(event);
+        await this.startServiceIfSynched();
+    }
+    #assertIsReady() {
+        if (!this.isReady()) {
+            throw new Error('P2P client not ready');
+        }
+    }
+    /**
+   * Starts the P2P client.
+   * @returns An empty promise signalling the synching process.
+   */ async start() {
+        if (this.currentState === P2PClientState.STOPPED) {
+            throw new Error('P2P client already stopped');
+        }
+        if (this.currentState !== P2PClientState.IDLE) {
+            return this.syncPromise;
+        }
+        // Start the tx pool first, as it needs to hydrate state from persistence
+        await this.txPool.start();
+        // get the current latest block numbers
+        const latestBlockNumbers = await this.l2BlockSource.getL2Tips();
+        this.latestBlockNumberAtStart = latestBlockNumbers.proposed.number;
+        this.provenBlockNumberAtStart = latestBlockNumbers.proven.block.number;
+        this.finalizedBlockNumberAtStart = latestBlockNumbers.finalized.block.number;
+        const syncedLatestBlock = await this.getSyncedLatestBlockNum() + 1;
+        const syncedProvenBlock = await this.getSyncedProvenBlockNum() + 1;
+        const syncedFinalizedBlock = await this.getSyncedFinalizedBlockNum() + 1;
+        if (await this.txPool.isEmpty() && await this.attestationPool.isEmpty()) {
+            // if mempools are empty, we don't care about syncing prior blocks
+            this.initBlockStream(BlockNumber(this.latestBlockNumberAtStart));
+            this.setCurrentState(P2PClientState.RUNNING);
+            this.syncPromise = Promise.resolve();
+            await this.p2pService.start();
+            this.log.info(`Starting p2p client from block ${this.latestBlockNumberAtStart} with empty mempools`);
+        } else if (syncedLatestBlock <= this.latestBlockNumberAtStart || syncedProvenBlock <= this.provenBlockNumberAtStart || syncedFinalizedBlock <= this.finalizedBlockNumberAtStart) {
+            // if there are blocks to be retrieved, go to a synching state
+            // this gets resolved on `startServiceIfSynched`
+            this.initBlockStream();
+            this.setCurrentState(P2PClientState.SYNCHING);
+            this.syncResolvers = promiseWithResolvers();
+            this.syncPromise = this.syncResolvers.promise;
+            this.log.info(`Initiating p2p sync from ${syncedLatestBlock}`, {
+                syncedLatestBlock,
+                syncedProvenBlock,
+                syncedFinalizedBlock
+            });
+        } else {
+            // if no blocks to be retrieved, go straight to running
+            this.initBlockStream();
+            this.setCurrentState(P2PClientState.RUNNING);
+            this.syncPromise = Promise.resolve();
+            await this.p2pService.start();
+            this.log.info(`Starting P2P client synced to ${syncedLatestBlock}`, {
+                syncedLatestBlock,
+                syncedProvenBlock,
+                syncedFinalizedBlock
+            });
+        }
+        // Should never happen: all branches above call initBlockStream()
+        if (!this.blockStream) {
+            throw new Error('Block stream not initialized');
+        }
+        this.blockStream.start();
+        this.txFileStore?.start();
+        return this.syncPromise;
+    }
+    addReqRespSubProtocol(subProtocol, handler) {
+        return this.p2pService.addReqRespSubProtocol(subProtocol, handler);
+    }
+    initBlockStream(startingBlock) {
+        if (!this.blockStream) {
+            const { blockRequestBatchSize: batchSize, blockCheckIntervalMS: pollIntervalMS } = this.config;
+            this.blockStream = new EventDrivenL2BlockStream(this.l2BlockSource, this, this, createLogger(`${this.log.module}:l2-block-stream`), {
+                batchSize,
+                pollIntervalMS,
+                startingBlock
+            });
+        }
+    }
+    /**
+   * Allows consumers to stop the instance of the P2P client.
+   * 'ready' will now return 'false' and the running promise that keeps the client synced is interrupted.
+   */ async stop() {
+        this.log.debug('Stopping p2p client...');
+        await tryStop(this.txCollection);
+        this.log.debug('Stopped tx collection service');
+        await this.txFileStore?.stop();
+        this.log.debug('Stopped tx file store');
+        await this.p2pService.stop();
+        this.log.debug('Stopped p2p service');
+        await this.blockStream?.stop();
+        this.log.debug('Stopped block downloader');
+        await this.txPool.stop();
+        this.log.debug('Stopped tx pool');
+        await this.runningPromise;
+        this.setCurrentState(P2PClientState.STOPPED);
+        this.log.info('P2P client stopped');
+    }
+    /** Triggers a sync to the archiver. Used for testing. */ async sync() {
+        this.initBlockStream();
+        // Should never happen: initBlockStream() creates blockStream if absent
+        if (!this.blockStream) {
+            throw new Error('Block stream not initialized');
+        }
+        await this.blockStream.sync();
+    }
+    async broadcastProposal(proposal) {
+        this.log.verbose(`Broadcasting proposal for slot ${proposal.slotNumber} to peers`);
+        // Store our own proposal so we can respond to req/resp requests for it
+        const { count } = await this.attestationPool.tryAddBlockProposal(proposal);
+        if (count > 1) {
+            if (this.config.broadcastEquivocatedProposals) {
+                this.log.warn(`Broadcasting equivocated block proposal for slot ${proposal.slotNumber}`, {
+                    slot: proposal.slotNumber,
+                    archive: proposal.archive.toString(),
+                    count
+                });
+            } else {
+                throw new Error(`Attempted to broadcast a duplicate block proposal for slot ${proposal.slotNumber}`);
+            }
+        }
+        return this.p2pService.propagate(proposal);
+    }
+    async broadcastCheckpointProposal(proposal) {
+        this.log.verbose(`Broadcasting checkpoint proposal for slot ${proposal.slotNumber} to peers`);
+        const blockProposal = proposal.getBlockProposal();
+        if (blockProposal) {
+            // Store our own last-block proposal so we can respond to req/resp requests for it.
+            await this.attestationPool.tryAddBlockProposal(blockProposal);
+        }
+        const checkpointCore = proposal.toCore();
+        const { count } = await this.attestationPool.tryAddCheckpointProposal(checkpointCore);
+        if (count > 1) {
+            if (this.config.broadcastEquivocatedProposals) {
+                this.log.warn(`Broadcasting equivocated checkpoint proposal for slot ${proposal.slotNumber}`, {
+                    slot: proposal.slotNumber,
+                    archive: proposal.archive.toString(),
+                    count
+                });
+            } else {
+                throw new Error(`Attempted to broadcast a duplicate checkpoint proposal for slot ${proposal.slotNumber}`);
+            }
+        }
+        return this.p2pService.propagate(proposal);
+    }
+    async broadcastCheckpointAttestations(attestations) {
+        this.log.verbose(`Broadcasting ${attestations.length} checkpoint attestations to peers`);
+        await Promise.all(attestations.map((att)=>this.p2pService.propagate(att)));
+    }
+    async getCheckpointAttestationsForSlot(slot, proposalPayloadHash) {
+        return await (proposalPayloadHash ? this.attestationPool.getCheckpointAttestationsForSlotAndProposal(slot, proposalPayloadHash) : this.attestationPool.getCheckpointAttestationsForSlot(slot));
+    }
+    addOwnCheckpointAttestations(attestations) {
+        return this.attestationPool.addOwnCheckpointAttestations(attestations);
+    }
+    getProposalsForSlot(slot) {
+        return this.attestationPool.getProposalsForSlot(slot);
+    }
+    hasBlockProposalsForSlot(slot) {
+        return this.attestationPool.hasBlockProposalsForSlot(slot);
+    }
+    hasCheckpointProposalForSlot(slot) {
+        return this.attestationPool.hasCheckpointProposalForSlot(slot);
+    }
+    // REVIEW: https://github.com/AztecProtocol/aztec-packages/issues/7963
+    // ^ This pattern is not my favorite (md)
+    registerBlockProposalHandler(handler) {
+        this.p2pService.registerBlockReceivedCallback(handler);
+    }
+    registerValidatorCheckpointProposalHandler(handler) {
+        this.p2pService.registerValidatorCheckpointReceivedCallback(handler);
+    }
+    registerAllNodesCheckpointProposalHandler(handler) {
+        this.p2pService.registerAllNodesCheckpointReceivedCallback(handler);
+    }
+    registerDuplicateProposalCallback(callback) {
+        this.p2pService.registerDuplicateProposalCallback(callback);
+    }
+    registerOversizedProposalCallback(callback) {
+        this.p2pService.registerOversizedProposalCallback(callback);
+    }
+    registerDuplicateAttestationCallback(callback) {
+        this.p2pService.registerDuplicateAttestationCallback(callback);
+    }
+    registerCheckpointAttestationCallback(callback) {
+        this.p2pService.registerCheckpointAttestationCallback(callback);
+    }
+    async getPendingTxs(limit, after, options) {
+        if (limit !== undefined && limit <= 0) {
+            throw new TypeError('limit must be greater than 0');
+        }
+        let txHashes = await this.txPool.getPendingTxHashes();
+        let startIndex = 0;
+        if (after) {
+            startIndex = txHashes.findIndex((txHash)=>after.equals(txHash));
+            if (startIndex === -1) {
+                return [];
+            }
+            startIndex++;
+        }
+        const endIndex = limit !== undefined ? startIndex + limit : undefined;
+        txHashes = txHashes.slice(startIndex, endIndex);
+        // This is a public-facing API (exposed via both the node and the p2p RPC), so proofs are opt-in.
+        const includeProof = !!options?.includeProof;
+        const maybeTxs = await Promise.all(txHashes.map((txHash)=>this.txPool.getTxByHash(txHash, {
+                includeProof
+            })));
+        return maybeTxs.filter((tx)=>!!tx);
+    }
+    getPendingTxCount() {
+        return this.txPool.getPendingTxCount();
+    }
+    hasEligiblePendingTxs(minCount) {
+        return this.txPool.hasEligiblePendingTxs(minCount);
+    }
+    async *iteratePendingTxs(opts) {
+        for (const txHash of (await this.txPool.getPendingTxHashes())){
+            const tx = await this.txPool.getTxByHash(txHash, opts);
+            if (tx) {
+                yield tx;
+            }
+        }
+    }
+    async *iterateEligiblePendingTxs(opts) {
+        for (const txHash of (await this.txPool.getEligiblePendingTxHashes())){
+            const tx = await this.txPool.getTxByHash(txHash, opts);
+            if (tx) {
+                yield tx;
+            }
+        }
+    }
+    /**
+   * Returns a transaction in the transaction pool by its hash.
+   * @param txHash - Hash of the transaction to look for in the pool.
+   * @param opts - Set `includeProof: false` to skip loading the tx proof from the DB.
+   * @returns A single tx or undefined.
+   */ getTxByHashFromPool(txHash, opts) {
+        return this.txPool.getTxByHash(txHash, opts);
+    }
+    /**
+   * Returns transactions in the transaction pool by hash.
+   * @param txHashes - Hashes of the transactions to look for.
+   * @param opts - Set `includeProof: false` to skip loading tx proofs from the DB.
+   * @returns The txs found, in the same order as the requested hashes. If a tx is not found, it will be undefined.
+   */ getTxsByHashFromPool(txHashes, opts) {
+        return this.txPool.getTxsByHash(txHashes, opts);
+    }
+    hasTxsInPool(txHashes) {
+        return this.txPool.hasTxs(txHashes);
+    }
+    /**
+   * Returns an archived transaction in the transaction pool by its hash.
+   * @param txHash - Hash of the archived transaction to look for.
+   * @returns A single tx or undefined.
+   */ getArchivedTxByHash(txHash) {
+        return this.txPool.getArchivedTxByHash(txHash);
+    }
+    /**
+   * Accepts a transaction, adds it to local tx pool and forwards it to other peers.
+   * @param tx - The tx to send.
+   * @returns Empty promise.
+   **/ async sendTx(tx) {
+        this.#assertIsReady();
+        const result = await this.txPool.addPendingTxs([
+            tx
+        ], {
+            feeComparisonOnly: true
+        });
+        if (result.accepted.length === 1) {
+            await this.p2pService.propagate(tx);
+            return;
+        }
+        const txHashStr = tx.getTxHash().toString();
+        const reason = result.errors?.get(txHashStr);
+        if (reason) {
+            this.log.warn(`Tx ${txHashStr} not added to pool: ${reason.message}`);
+            throw new TxPoolError(reason);
+        }
+        this.log.warn(`Tx ${txHashStr} not propagated: accepted=${result.accepted.length} ignored=${result.ignored.length} rejected=${result.rejected.length}`);
+    }
+    /**
+   * Returns whether the given tx hash is flagged as pending or mined.
+   * @param txHash - Hash of the tx to query.
+   * @returns Pending or mined depending on its status, or undefined if not found.
+   */ async getTxStatus(txHash) {
+        const status = await this.txPool.getTxStatus(txHash);
+        return status === 'protected' ? 'pending' : status;
+    }
+    getEnr() {
+        return this.p2pService.getEnr();
+    }
+    getEncodedEnr() {
+        return Promise.resolve(this.p2pService.getEnr()?.encodeTxt());
+    }
+    /**
+   * Handles failed transaction execution by removing txs from the pool.
+   * @param txHashes - Hashes of the transactions that failed execution.
+   **/ async handleFailedExecution(txHashes) {
+        this.#assertIsReady();
+        await this.txPool.handleFailedExecution(txHashes);
+    }
+    /**
+   * Public function to check if the p2p client is fully synced and ready to receive txs.
+   * @returns True if the P2P client is ready to receive txs.
+   */ isReady() {
+        return this.currentState === P2PClientState.RUNNING;
+    }
+    /**
+   * Public function to check the latest block number that the P2P client is synced to.
+   * @returns Block number of latest L2 Block we've synced with.
+   */ async getSyncedLatestBlockNum() {
+        const tips = await this.l2Tips.getL2Tips();
+        return tips.proposed.number;
+    }
+    /**
+   * Public function to check the latest proven block number that the P2P client is synced to.
+   * @returns Block number of latest proven L2 Block we've synced with.
+   */ async getSyncedProvenBlockNum() {
+        const tips = await this.l2Tips.getL2Tips();
+        return tips.proven.block.number;
+    }
+    async getSyncedFinalizedBlockNum() {
+        const tips = await this.l2Tips.getL2Tips();
+        return tips.finalized.block.number;
+    }
+    /** Returns latest L2 slot for which we have seen an L2 block. */ async getSyncedLatestSlot() {
+        return await this.synchedLatestSlot.getAsync() ?? BigInt(0);
+    }
+    /**
+   * Method to check the status the p2p client.
+   * @returns Information about p2p client status: state & syncedToBlockNum.
+   */ async getStatus() {
+        const blockNumber = await this.getSyncedLatestBlockNum();
+        const blockHash = await this.l2BlockSource.getBlockData({
+            number: blockNumber
+        }).then((data)=>data?.header.hash()).then((hash)=>hash?.toString());
+        return {
+            state: this.currentState,
+            syncedToL2Block: {
+                number: blockNumber,
+                hash: blockHash
+            }
+        };
+    }
+    /**
+   * Handles mined blocks by marking the txs in them as mined.
+   * @param blocks - A list of existing blocks with txs that the P2P client needs to ensure the tx pool is reconciled with.
+   * @returns Empty promise.
+   */ async handleMinedBlocks(blocks) {
+        for (const block of blocks){
+            await this.txPool.handleMinedBlock(block);
+        }
+    }
+    /**
+   * Handles new mined blocks by marking the txs in them as mined.
+   * @param blocks - A list of existing blocks with txs that the P2P client needs to ensure the tx pool is reconciled with.
+   * @returns Empty promise.
+   */ async handleLatestL2Blocks(blocks) {
+        if (!blocks.length) {
+            return;
+        }
+        const lastBlock = blocks.at(-1);
+        const lastSlot = lastBlock.header.getSlot();
+        // Mark txs mined before releasing protections: a block landing at this slot supersedes any
+        // protection for txs it includes, so mined-marking must run first to keep just-landed txs from
+        // being unprotected into pending where they could be evicted before they are recorded as mined.
+        await this.handleMinedBlocks(blocks);
+        await this.maybeCallPrepareForSlot(lastSlot);
+        await this.collectingMissingTxs(blocks);
+        await this.synchedLatestSlot.set(BigInt(lastSlot));
+    }
+    /** Request txs for unproven blocks so the prover node can prove. */ async collectingMissingTxs(blocks) {
+        try {
+            // TODO(#15435): If the archiver has lagged behind L1, the reported proven block number may
+            // be much lower than the actual one, and it does not update until the pending chain is
+            // fully synced. This could lead to a ton of tx collection requests for blocks that
+            // are already proven, but the archiver has not yet updated its state. Until this is properly
+            // fixed, it is mitigated by the expiration date of collection requests, which depends on
+            // the slot number of the block.
+            const provenBlockNumber = await this.l2BlockSource.getBlockNumber({
+                tag: 'proven'
+            }) ?? BlockNumber.ZERO;
+            const unprovenBlocks = blocks.filter((block)=>block.number > provenBlockNumber);
+            for (const block of unprovenBlocks){
+                const txHashes = block.body.txEffects.map((txEffect)=>txEffect.txHash);
+                const missingTxHashes = await this.txPool.hasTxs(txHashes).then((availability)=>txHashes.filter((_, index)=>!availability[index]));
+                if (missingTxHashes.length > 0) {
+                    this.log.verbose(`Starting collection of ${missingTxHashes.length} missing txs for unproven mined block ${block.number}`, {
+                        missingTxHashes,
+                        blockNumber: block.number,
+                        blockHash: await block.hash().then((h)=>h.toString())
+                    });
+                    // Both `slashDataWithholdingToleranceSlots` and `p2pMissingTxCollectionDeadlineSlots`
+                    // count *full slots after the block slot* — value N means collection runs until
+                    // `slotStart(block.slot + N + 1)`. Take the larger of the two so collection never
+                    // gives up before the data-withholding slash verdict is rendered.
+                    const blockSlot = block.header.getSlot();
+                    const toleranceSlots = this.config.slashDataWithholdingToleranceSlots;
+                    const configuredSlots = this.config.p2pMissingTxCollectionDeadlineSlots ?? 0;
+                    const deadlineSlot = SlotNumber(blockSlot + Math.max(toleranceSlots, configuredSlots) + 1);
+                    const deadlineSeconds = getTimestampForSlot(deadlineSlot, this.epochCache.getL1Constants());
+                    const deadline = new Date(Number(deadlineSeconds) * 1000);
+                    await this.txCollection.collectFastForBlock(block, missingTxHashes, {
+                        deadline
+                    });
+                }
+            }
+        } catch (err) {
+            this.log.error(`Error while starting collection of missing txs for unproven blocks`, err);
+        }
+    }
+    /**
+   * Handles new finalized blocks by deleting the txs and attestations in them.
+   * @param blocks - A list of finalized L2 blocks.
+   * @returns Empty promise.
+   */ async handleFinalizedL2Blocks(blocks) {
+        if (!blocks.length) {
+            return;
+        }
+        // Finalization is monotonic, so we only need to call with the last block
+        const lastBlock = blocks.at(-1);
+        await this.txPool.handleFinalizedBlock(lastBlock.header);
+        await this.attestationPool.deleteOlderThan(lastBlock.header.getSlot());
+    }
+    /**
+   * Updates the tx pool after a chain prune.
+   * Detects epoch prunes (checkpoint number changed) and deletes all txs in that case.
+   * @param latestBlock - The block ID the chain was pruned to.
+   * @param newCheckpoint - The checkpoint ID after the prune.
+   */ async handlePruneL2Blocks(latestBlock, newCheckpoint) {
+        const deleteAllTxs = this.config.txPoolDeleteTxsAfterReorg && await this.isEpochPrune(newCheckpoint);
+        await this.txPool.handlePrunedBlocks(latestBlock, {
+            deleteAllTxs
+        });
+    }
+    /**
+   * Returns true if the prune is an epoch prune (new checkpoint number is less than old).
+   * If the checkpoint number stays the same or increases, the prune is within a checkpoint.
+   */ async isEpochPrune(newCheckpoint) {
+        const tips = await this.l2Tips.getL2Tips();
+        const oldCheckpointNumber = tips.checkpointed.checkpoint.number;
+        if (oldCheckpointNumber <= CheckpointNumber.INITIAL) {
+            return false;
+        }
+        const newCheckpointNumber = newCheckpoint.number;
+        // We check that the new checkpoint number is less than the old checkpoint number in order to consider it an epoch prune.
+        // To be more certain that it is an epoch prune, we will check that at least 2 checkpoints were removed.
+        // This means we should avoid thinking checkpoints removed by L1 re-orgs are epoch prunes
+        const thresholdForEpochPrune = CheckpointNumber(oldCheckpointNumber - 2);
+        const isEpochPrune = newCheckpointNumber <= thresholdForEpochPrune;
+        if (isEpochPrune) {
+            this.log.info(`Detected epoch prune to ${newCheckpointNumber}`, {
+                oldCheckpointNumber,
+                newCheckpointNumber,
+                thresholdForEpochPrune
+            });
+        }
+        return isEpochPrune;
+    }
+    /** Calls prepareForSlot for the given slot if it advances past the last slot we prepared for. */ async maybeCallPrepareForSlot(slot) {
+        if (slot <= this.lastSlotProcessed) {
+            return;
+        }
+        this.lastSlotProcessed = slot;
+        await this.txPool.prepareForSlot(slot);
+    }
+    async startServiceIfSynched() {
+        if (this.currentState !== P2PClientState.SYNCHING) {
+            return;
+        }
+        const tips = await this.l2Tips.getL2Tips();
+        const syncedFinalizedBlock = tips.finalized.block.number;
+        const syncedProvenBlock = tips.proven.block.number;
+        const syncedLatestBlock = tips.proposed.number;
+        if (syncedLatestBlock >= this.latestBlockNumberAtStart && syncedProvenBlock >= this.provenBlockNumberAtStart && syncedFinalizedBlock >= this.finalizedBlockNumberAtStart) {
+            this.log.info(`Completed P2P client sync to block ${syncedLatestBlock}. Starting service.`, {
+                syncedLatestBlock,
+                syncedProvenBlock,
+                syncedFinalizedBlock
+            });
+            this.setCurrentState(P2PClientState.RUNNING);
+            if (this.syncResolvers !== undefined) {
+                // A throw here would be swallowed by the block stream event handler, so we reject the promise returned by
+                // start instead, which makes node startup fail rather than run on with a dead p2p stack.
+                try {
+                    await this.p2pService.start();
+                } catch (err) {
+                    this.log.fatal(`Failed to start p2p service`, {
+                        err,
+                        syncedLatestBlock
+                    });
+                    this.syncResolvers.reject(err);
+                    return;
+                }
+                this.syncResolvers.resolve();
+            }
+        }
+    }
+    /**
+   * Method to set the value of the current state.
+   * @param newState - New state value.
+   */ setCurrentState(newState) {
+        const oldState = this.currentState;
+        this.currentState = newState;
+        this.log.debug(`Moved from state ${P2PClientState[oldState]} to ${P2PClientState[this.currentState]}`);
+    }
+    validateTxsReceivedInBlockProposal(txs) {
+        return this.p2pService.validateTxsReceivedInBlockProposal(txs);
+    }
+    /**
+   * Protects existing transactions by hash for a given slot.
+   * Returns hashes of transactions that weren't found in the pool.
+   * @param txHashes - Hashes of the transactions to protect.
+   * @param blockHeader - The block header providing slot context.
+   * @returns Hashes of transactions not found in the pool.
+   */ protectTxs(txHashes, blockHeader) {
+        return this.txPool.protectTxs(txHashes, blockHeader);
+    }
+    /**
+   * Prepares the pool for a new slot.
+   * Unprotects transactions from earlier slots and validates them.
+   * @param slotNumber - The slot number to prepare for
+   */ async prepareForSlot(slotNumber) {
+        await this.txPool.prepareForSlot(slotNumber);
+    }
+    handleAuthRequestFromPeer(authRequest, peerId) {
+        return this.p2pService.handleAuthRequestFromPeer(authRequest, peerId);
+    }
+}