@aztec/p2p 0.0.0-test.1 → 0.0.1-commit.001888fc

package/dest/testbench/worker_client_manager.js

@@ -1,17 +1,22 @@
 import { EthAddress } from '@aztec/foundation/eth-address';
 import { sleep } from '@aztec/foundation/sleep';
 import { fork } from 'child_process';
+import { existsSync } from 'fs';
 import path from 'path';
 import { fileURLToPath } from 'url';
 import { getP2PDefaultConfig } from '../config.js';
 import { generatePeerIdPrivateKeys } from '../test-helpers/generate-peer-id-private-keys.js';
 import { getPorts } from '../test-helpers/get-ports.js';
 import { makeEnr, makeEnrs } from '../test-helpers/make-enrs.js';
+import { BENCHMARK_CONSTANTS } from '../test-helpers/testbench-utils.js';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const workerPath = path.join(__dirname, '../../dest/testbench/p2p_client_testbench_worker.js');
+const p2pRoot = path.resolve(__dirname, '../..');
+const workerTsPath = path.join(__dirname, 'p2p_client_testbench_worker.ts');
+const workerJsPath = path.join(p2pRoot, 'dest/testbench/p2p_client_testbench_worker.js');
+const tsconfigPath = path.join(p2pRoot, 'tsconfig.json');
 const testChainConfig = {
     l1ChainId: 31337,
-    version: 1,
+    rollupVersion: 1,
     l1Contracts: {
         rollupAddress: EthAddress.random()
     }
@@ -21,6 +26,7 @@ class WorkerClientManager {
     peerIdPrivateKeys = [];
     peerEnrs = [];
     ports = [];
+    peerIds = [];
     p2pConfig;
     logger;
     messageReceivedByClient = [];
@@ -35,35 +41,48 @@ class WorkerClientManager {
         });
     }
     /**
-   * Creates address strings from a port
-   */ getAddresses(port) {
-        return {
-            addr: `127.0.0.1:${port}`,
-            listenAddr: `0.0.0.0:${port}`
-        };
-    }
-    /**
-   * Creates a client configuration object
+   * Creates a client configuration object for IPC.
+   * Note: We send the raw peerIdPrivateKey string instead of SecretValue
+   * because SecretValue.toJSON() returns '[Redacted]', losing the value.
+   * The worker must re-wrap it in SecretValue.
+   * We also omit priceBumpPercentage since it's a bigint and can't be
+   * serialized over IPC (which uses JSON under the hood).
    */ createClientConfig(clientIndex, port, otherNodes) {
-        const { addr, listenAddr } = this.getAddresses(port);
-        return {
+        const { priceBumpPercentage: _, ...config } = {
             ...getP2PDefaultConfig(),
             p2pEnabled: true,
             peerIdPrivateKey: this.peerIdPrivateKeys[clientIndex],
-            tcpListenAddress: listenAddr,
-            udpListenAddress: listenAddr,
-            tcpAnnounceAddress: addr,
-            udpAnnounceAddress: addr,
+            listenAddress: '127.0.0.1',
+            p2pIp: '127.0.0.1',
+            p2pPort: port,
             bootstrapNodes: [
                 ...otherNodes
             ],
             ...this.p2pConfig
         };
+        return config;
     }
     /**
-   * Spawns a worker process and returns a promise that resolves when the worker is ready
+   * Spawns a worker process and returns a promise that resolves when the worker is ready.
+   * Config uses raw string for peerIdPrivateKey (not SecretValue) for IPC serialization.
    */ spawnWorkerProcess(config, clientIndex) {
-        const childProcess = fork(workerPath);
+        const useCompiled = existsSync(workerJsPath);
+        const workerPath = useCompiled ? workerJsPath : workerTsPath;
+        const execArgv = [
+            ...process.execArgv
+        ];
+        if (!useCompiled && !execArgv.includes('ts-node/esm')) {
+            execArgv.push('--loader', 'ts-node/esm');
+        }
+        const env = {
+            ...process.env,
+            TS_NODE_PROJECT: tsconfigPath
+        };
+        const childProcess = fork(workerPath, {
+            cwd: p2pRoot,
+            execArgv,
+            env
+        });
         childProcess.send({
             type: 'START',
             config,
@@ -82,29 +101,54 @@ class WorkerClientManager {
         });
         // Create ready signal promise
         const readySignal = new Promise((resolve, reject)=>{
-            // Set a timeout to avoid hanging indefinitely
+            let resolved = false;
             const timeout = setTimeout(()=>{
+                if (resolved) {
+                    return;
+                }
+                resolved = true;
+                childProcess.off('message', messageHandler);
+                childProcess.off('exit', exitHandler);
                 reject(new Error(`Timeout waiting for worker ${clientIndex} to be ready`));
-            }, 30000); // 30 second timeout
-            childProcess.once('message', (msg)=>{
-                clearTimeout(timeout);
+            }, BENCHMARK_CONSTANTS.WORKER_READY_TIMEOUT_MS);
+            const messageHandler = (msg)=>{
+                if (resolved) {
+                    return;
+                }
+                // Only handle READY or ERROR messages; ignore others (e.g., GOSSIP_RECEIVED)
                 if (msg.type === 'READY') {
+                    resolved = true;
+                    clearTimeout(timeout);
+                    childProcess.off('message', messageHandler);
+                    childProcess.off('exit', exitHandler);
+                    if (typeof msg.peerId === 'string') {
+                        this.peerIds[clientIndex] = msg.peerId;
+                    }
                     resolve();
-                }
-                // For future use
-                if (msg.type === 'ERROR') {
+                } else if (msg.type === 'ERROR') {
+                    resolved = true;
+                    clearTimeout(timeout);
+                    childProcess.off('message', messageHandler);
+                    childProcess.off('exit', exitHandler);
                     reject(new Error(msg.error));
                 }
-            });
-            // Also resolve/reject if process exits before sending message
-            childProcess.once('exit', (code)=>{
+            // Ignore other message types and keep waiting for READY/ERROR
+            };
+            const exitHandler = (code)=>{
+                if (resolved) {
+                    return;
+                }
+                resolved = true;
                 clearTimeout(timeout);
+                childProcess.off('message', messageHandler);
                 if (code === 0) {
                     resolve();
                 } else {
                     reject(new Error(`Worker ${clientIndex} exited with code ${code} before becoming ready`));
                 }
-            });
+            };
+            childProcess.on('message', messageHandler);
+            childProcess.once('exit', exitHandler);
         });
         return [
             childProcess,
@@ -112,34 +156,46 @@ class WorkerClientManager {
         ];
     }
     /**
-   * Creates a number of worker clients in separate processes
-   * All are configured to connect to each other and overrided with the test specific config
+   * Creates a number of worker clients in separate processes.
+   * All are configured to connect to each other and overridden with the test-specific config.
    *
    * @param numberOfClients - The number of clients to create
+   * @param options - Optional overrides for seeding/bootstrapping strategy
    * @returns The ENRs of the created clients
-   */ async makeWorkerClients(numberOfClients) {
+   */ async makeWorkerClients(numberOfClients, options = {}) {
         try {
+            const bootstrapMode = options.bootstrapMode ?? (this.p2pConfig.bootstrapNodesAsFullPeers ? 'all' : 'subset');
+            const seedPeerLimit = options.seedPeerLimit ?? 10;
+            const batchSize = options.batchSize ?? (bootstrapMode === 'all' ? Math.min(5, numberOfClients) : numberOfClients);
+            const batchDelayMs = options.batchDelayMs ?? (bootstrapMode === 'all' ? 500 : 0);
             this.messageReceivedByClient = new Array(numberOfClients).fill(0);
             this.peerIdPrivateKeys = generatePeerIdPrivateKeys(numberOfClients);
             this.ports = await getPorts(numberOfClients);
             this.peerEnrs = await makeEnrs(this.peerIdPrivateKeys, this.ports, testChainConfig);
+            this.peerIds = new Array(numberOfClients);
             this.processes = [];
             const readySignals = [];
-            for(let i = 0; i < numberOfClients; i++){
-                this.logger.info(`Creating client ${i}`);
-                // Maximum seed with 10 other peers to allow peer discovery to connect them at a smoother rate
-                const otherNodes = this.peerEnrs.filter((_, ind)=>ind < Math.min(i, 10));
-                const config = this.createClientConfig(i, this.ports[i], otherNodes);
-                const [childProcess, readySignal] = this.spawnWorkerProcess(config, i);
-                readySignals.push(readySignal);
-                this.processes.push(childProcess);
+            for(let batchStart = 0; batchStart < numberOfClients; batchStart += batchSize){
+                const batchEnd = Math.min(batchStart + batchSize, numberOfClients);
+                const batchPromises = [];
+                for(let i = batchStart; i < batchEnd; i++){
+                    this.logger.info(`Creating client ${i}`);
+                    const otherNodes = bootstrapMode === 'all' ? this.peerEnrs.filter((_, ind)=>ind !== i) : this.peerEnrs.filter((_, ind)=>ind < Math.min(i, seedPeerLimit));
+                    const config = this.createClientConfig(i, this.ports[i], otherNodes);
+                    const [childProcess, readySignal] = this.spawnWorkerProcess(config, i);
+                    readySignals.push(readySignal);
+                    batchPromises.push(readySignal);
+                    this.processes.push(childProcess);
+                }
+                await Promise.all(batchPromises);
+                if (batchEnd < numberOfClients && batchDelayMs > 0) {
+                    await sleep(batchDelayMs);
+                }
             }
-            // Wait for peers to all connect with each other
-            await sleep(10000);
-            // Wait for all peers to be booted up with timeout
+            await sleep(BENCHMARK_CONSTANTS.PEER_DISCOVERY_WAIT_MS);
             await Promise.race([
                 Promise.all(readySignals),
-                new Promise((_, reject)=>setTimeout(()=>reject(new Error('Timeout waiting for all workers to be ready')), 30000))
+                new Promise((_, reject)=>setTimeout(()=>reject(new Error('Timeout waiting for all workers to be ready')), BENCHMARK_CONSTANTS.WORKER_READY_TIMEOUT_MS))
             ]);
             return this.peerEnrs;
         } catch (error) {
@@ -177,13 +233,13 @@ class WorkerClientManager {
             this.peerEnrs[clientIndex] = await makeEnr(this.peerIdPrivateKeys[clientIndex], newPort, testChainConfig);
             // Maximum seed with 10 other peers to allow peer discovery to connect them at a smoother rate
             const otherNodes = this.peerEnrs.filter((_, ind)=>ind !== clientIndex && ind < Math.min(this.peerEnrs.length, 10));
+            this.logger.info(`Changing port for client ${clientIndex} to ${newPort} with other nodes `, otherNodes);
             const config = this.createClientConfig(clientIndex, newPort, otherNodes);
             const [childProcess, readySignal] = this.spawnWorkerProcess(config, clientIndex);
             this.processes[clientIndex] = childProcess;
-            // Wait for the process to be ready with a timeout
             await Promise.race([
                 readySignal,
-                new Promise((_, reject)=>setTimeout(()=>reject(new Error(`Timeout waiting for client ${clientIndex} to be ready`)), 30000))
+                new Promise((_, reject)=>setTimeout(()=>reject(new Error(`Timeout waiting for client ${clientIndex} to be ready`)), BENCHMARK_CONSTANTS.WORKER_READY_TIMEOUT_MS))
             ]);
         } catch (error) {
             this.logger.error(`Error during changePort for client ${clientIndex}:`, error);
@@ -199,15 +255,14 @@ class WorkerClientManager {
             return Promise.resolve();
         }
         return new Promise((resolve)=>{
-            // Set a timeout for the graceful exit
             const forceKillTimeout = setTimeout(()=>{
                 this.logger.warn(`Process ${index} didn't exit gracefully, force killing...`);
                 try {
-                    process1.kill('SIGKILL'); // Force kill
+                    process1.kill('SIGKILL');
                 } catch (e) {
                     this.logger.error(`Error force killing process ${index}:`, e);
                 }
-            }, 10000); // 10 second timeout for graceful exit
+            }, BENCHMARK_CONSTANTS.GRACEFUL_SHUTDOWN_TIMEOUT_MS);
             // Listen for process exit
             process1.once('exit', ()=>{
                 clearTimeout(forceKillTimeout);
@@ -218,7 +273,7 @@ class WorkerClientManager {
                 process1.send({
                     type: 'STOP'
                 });
-            } catch (e) {
+            } catch  {
                 // If sending the message fails, force kill immediately
                 clearTimeout(forceKillTimeout);
                 try {
@@ -236,7 +291,6 @@ class WorkerClientManager {
         this.logger.info(`Cleaning up ${this.processes.length} worker processes`);
         // Create array of promises for each process termination
         const terminationPromises = this.processes.map((process1, index)=>this.terminateProcess(process1, index));
-        // Wait for all processes to terminate with a timeout
         try {
             await Promise.race([
                 Promise.all(terminationPromises),
@@ -248,19 +302,148 @@ class WorkerClientManager {
                                 if (!p.killed) {
                                     p.kill('SIGKILL');
                                 }
-                            } catch (e) {
+                            } catch  {
                             // Ignore errors when force killing
                             }
                         });
                         resolve();
-                    }, 30000); // 30 second timeout for all processes
+                    }, BENCHMARK_CONSTANTS.CLEANUP_TIMEOUT_MS);
                 })
             ]);
         } catch (error) {
             this.logger.error('Error during cleanup:', error);
         }
         this.processes = [];
+        this.peerIds = [];
         this.logger.info('All worker processes cleaned up');
     }
+    /**
+   * Run a req/resp benchmark across all worker clients.
+   *
+   * This sends a BENCH_REQRESP command to all workers:
+   * - Aggregator (client 0) runs the collector and returns timing results
+   * - Responders (clients 1..N) populate their tx pools based on distribution
+   *
+   * All workers generate the same txs deterministically from a shared seed,
+   * then filter based on their peerIndex and distribution pattern.
+   */ async runReqRespBenchmark(config) {
+        const peerCount = this.processes.length;
+        if (peerCount < 2) {
+            throw new Error('Need at least 2 peers to run req/resp benchmark');
+        }
+        const seed = config.seed ?? Date.now();
+        const blockNumber = config.blockNumber ?? 1;
+        const pinnedPeerId = config.pinnedPeerIndex !== undefined ? this.peerIds[config.pinnedPeerIndex] : undefined;
+        this.logger.info(`Starting req/resp benchmark: txCount=${config.txCount}, distribution=${config.distribution}, collector=${config.collectorType}`);
+        const readyPromises = [];
+        for(let i = 1; i < peerCount; i++){
+            const cmd = {
+                type: 'BENCH_REQRESP',
+                txCount: config.txCount,
+                peerCount,
+                distribution: config.distribution,
+                collectorType: config.collectorType,
+                timeoutMs: config.timeoutMs,
+                isAggregator: false,
+                peerIndex: i,
+                pinnedPeerIndex: config.pinnedPeerIndex,
+                pinnedPeerId,
+                blockNumber,
+                seed
+            };
+            this.processes[i].send(cmd);
+            readyPromises.push(this.waitForBenchReady(i, 30000));
+        }
+        await Promise.all(readyPromises);
+        this.logger.info('All responder peers ready, starting aggregator benchmark...');
+        const aggregatorCmd = {
+            type: 'BENCH_REQRESP',
+            txCount: config.txCount,
+            peerCount,
+            distribution: config.distribution,
+            collectorType: config.collectorType,
+            timeoutMs: config.timeoutMs,
+            isAggregator: true,
+            peerIndex: 0,
+            pinnedPeerIndex: config.pinnedPeerIndex,
+            pinnedPeerId,
+            blockNumber,
+            seed
+        };
+        this.processes[0].send(aggregatorCmd);
+        const aggregatorBudgetMs = config.timeoutMs + BENCHMARK_CONSTANTS.MAX_PEER_WAIT_MS + 30000;
+        const result = await this.waitForBenchResult(0, aggregatorBudgetMs);
+        this.logger.info(`Benchmark complete: fetched=${result.fetchedCount}/${config.txCount}, duration=${result.durationMs.toFixed(0)}ms, success=${result.success}`);
+        return {
+            txCount: config.txCount,
+            distribution: config.distribution,
+            collector: config.collectorType,
+            durationMs: result.durationMs,
+            fetchedCount: result.fetchedCount,
+            success: result.success,
+            error: result.error
+        };
+    }
+    waitForBenchReady(clientIndex, timeoutMs) {
+        return new Promise((resolve, reject)=>{
+            let resolved = false;
+            const handler = (msg)=>{
+                if (resolved) {
+                    return;
+                }
+                if (msg.type === 'BENCH_READY') {
+                    resolved = true;
+                    clearTimeout(timeout);
+                    this.processes[clientIndex].off('message', handler);
+                    resolve();
+                } else if (msg.type === 'ERROR') {
+                    resolved = true;
+                    clearTimeout(timeout);
+                    this.processes[clientIndex].off('message', handler);
+                    reject(new Error(`Client ${clientIndex} error: ${msg.error}`));
+                }
+            };
+            const timeout = setTimeout(()=>{
+                if (resolved) {
+                    return;
+                }
+                resolved = true;
+                this.processes[clientIndex].off('message', handler);
+                reject(new Error(`Timeout waiting for BENCH_READY from client ${clientIndex}`));
+            }, timeoutMs);
+            this.processes[clientIndex].on('message', handler);
+        });
+    }
+    waitForBenchResult(clientIndex, timeoutMs) {
+        return new Promise((resolve, reject)=>{
+            let resolved = false;
+            const handler = (msg)=>{
+                if (resolved) {
+                    return;
+                }
+                if (msg.type === 'BENCH_RESULT') {
+                    resolved = true;
+                    clearTimeout(timeout);
+                    this.processes[clientIndex].off('message', handler);
+                    resolve(msg);
+                } else if (msg.type === 'ERROR') {
+                    resolved = true;
+                    clearTimeout(timeout);
+                    this.processes[clientIndex].off('message', handler);
+                    reject(new Error(`Client ${clientIndex} error: ${msg.error}`));
+                }
+            };
+            const timeout = setTimeout(()=>{
+                if (resolved) {
+                    return;
+                }
+                resolved = true;
+                this.processes[clientIndex].off('message', handler);
+                reject(new Error(`Timeout waiting for BENCH_RESULT from client ${clientIndex}`));
+            }, timeoutMs);
+            this.processes[clientIndex].on('message', handler);
+        });
+    }
 }
 export { WorkerClientManager, testChainConfig };
+export { COLLECTOR_DISPLAY_NAMES } from './p2p_client_testbench_worker.js';

package/dest/types/index.d.ts

@@ -14,7 +14,8 @@ export declare enum PeerEvent {
  */
 export declare enum Discv5Event {
     DISCOVERED = "discovered",
-    ENR_ADDED = "enrAdded"
+    ENR_ADDED = "enrAdded",
+    MULTIADDR_UPDATED = "multiaddrUpdated"
 }
 /**
  * Events emitted from the GossipSub protocol.
@@ -29,4 +30,5 @@ export declare enum GossipSubEvent {
  * Aztec network specific types
  */
 export declare const AZTEC_ENR_KEY = "aztec";
-//# sourceMappingURL=index.d.ts.map
+export declare const AZTEC_ENR_CLIENT_VERSION_KEY = "ver";
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90eXBlcy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7cURBRXFEO0FBRXJEOztHQUVHO0FBQ0gsb0JBQVksU0FBUztJQUNuQixVQUFVLG9CQUFvQjtJQUM5QixTQUFTLGlCQUFpQjtJQUMxQixZQUFZLG9CQUFvQjtDQUNqQztBQUVEOztHQUVHO0FBQ0gsb0JBQVksV0FBVztJQUNyQixVQUFVLGVBQWU7SUFDekIsU0FBUyxhQUFhO0lBQ3RCLGlCQUFpQixxQkFBcUI7Q0FDdkM7QUFFRDs7R0FFRztBQUNILG9CQUFZLGNBQWM7SUFDeEIsT0FBTyxzQkFBc0I7Q0FDOUI7QUFFRDs7cURBRXFEO0FBRXJEOztHQUVHO0FBQ0gsZUFBTyxNQUFNLGFBQWEsVUFBVSxDQUFDO0FBQ3JDLGVBQU8sTUFBTSw0QkFBNEIsUUFBUSxDQUFDIn0=

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;qDAEqD;AAErD;;GAEG;AACH,oBAAY,SAAS;IACnB,UAAU,oBAAoB;IAC9B,SAAS,iBAAiB;IAC1B,YAAY,oBAAoB;CACjC;AAED;;GAEG;AACH,oBAAY,WAAW;IACrB,UAAU,eAAe;IACzB,SAAS,aAAa;CACvB;AAED;;GAEG;AACH,oBAAY,cAAc;IACxB,OAAO,sBAAsB;CAC9B;AAED;;qDAEqD;AAErD;;GAEG;AACH,eAAO,MAAM,aAAa,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;qDAEqD;AAErD;;GAEG;AACH,oBAAY,SAAS;IACnB,UAAU,oBAAoB;IAC9B,SAAS,iBAAiB;IAC1B,YAAY,oBAAoB;CACjC;AAED;;GAEG;AACH,oBAAY,WAAW;IACrB,UAAU,eAAe;IACzB,SAAS,aAAa;IACtB,iBAAiB,qBAAqB;CACvC;AAED;;GAEG;AACH,oBAAY,cAAc;IACxB,OAAO,sBAAsB;CAC9B;AAED;;qDAEqD;AAErD;;GAEG;AACH,eAAO,MAAM,aAAa,UAAU,CAAC;AACrC,eAAO,MAAM,4BAA4B,QAAQ,CAAC"}

package/dest/types/index.js

@@ -13,6 +13,7 @@
  */ export var Discv5Event = /*#__PURE__*/ function(Discv5Event) {
     Discv5Event["DISCOVERED"] = "discovered";
     Discv5Event["ENR_ADDED"] = "enrAdded";
+    Discv5Event["MULTIADDR_UPDATED"] = "multiaddrUpdated";
     return Discv5Event;
 }({});
 /**
@@ -26,3 +27,4 @@
  ***************************************************/ /**
  * Aztec network specific types
  */ export const AZTEC_ENR_KEY = 'aztec';
+export const AZTEC_ENR_CLIENT_VERSION_KEY = 'ver';

package/dest/util.d.ts

@@ -1,18 +1,27 @@
+import { SecretValue } from '@aztec/foundation/config';
+import type { Logger } from '@aztec/foundation/log';
 import type { AztecAsyncKVStore } from '@aztec/kv-store';
-import type { DataStoreConfig } from '@aztec/kv-store/config';
+import type { DataStoreConfig } from '@aztec/stdlib/kv-store';
 import type { GossipSub } from '@chainsafe/libp2p-gossipsub';
+import type { Identify } from '@libp2p/identify';
 import type { PeerId } from '@libp2p/interface';
 import type { ConnectionManager } from '@libp2p/interface-internal';
 import type { Libp2p } from 'libp2p';
 import type { P2PConfig } from './config.js';
-export interface PubSubLibp2p extends Libp2p {
+export interface PubSubLibp2p extends Pick<Libp2p, 'status' | 'start' | 'stop' | 'peerId'> {
     services: {
-        pubsub: GossipSub;
-        components: {
-            connectionManager: ConnectionManager;
+        pubsub: Pick<GossipSub, 'addEventListener' | 'removeEventListener' | 'publish' | 'subscribe' | 'reportMessageValidationResult' | 'direct' | 'getMeshPeers'> & {
+            score: Pick<GossipSub['score'], 'score'>;
         };
     };
 }
+export type FullLibp2p = Libp2p<{
+    identify: Identify;
+    pubsub: GossipSub;
+    components: {
+        connectionManager: ConnectionManager;
+    };
+}>;
 /**
  * Converts an address string to a multiaddr string.
  * Example usage:
@@ -21,33 +30,32 @@ export interface PubSubLibp2p extends Libp2p {
  * @param address - The address string to convert. Has to be in the format <addr>:<port>.
  * @param protocol - The protocol to use in the multiaddr string.
  * @returns A multiaddr compliant string.  */
-export declare function convertToMultiaddr(address: string, protocol: 'tcp' | 'udp'): string;
-/**
- * Splits an <address>:<port> string into its components.
- * @returns The ip6 or ip4 address & port separately
- */
-export declare function splitAddressPort(address: string, allowEmptyAddress: boolean): [string, string];
+export declare function convertToMultiaddr(address: string, port: number, protocol: 'tcp' | 'udp'): string;
 /**
  * Queries the public IP address of the machine.
  */
 export declare function getPublicIp(): Promise<string>;
-export declare function resolveAddressIfNecessary(address: string): Promise<string>;
+export declare function isValidIpAddress(address: string): boolean;
+export declare function resolveAddressIfNecessary(address: string, port: string): Promise<string>;
 export declare function configureP2PClientAddresses(_config: P2PConfig & DataStoreConfig): Promise<P2PConfig & DataStoreConfig>;
 /**
  * Get the peer id private key
  *
  * 1. Check if we have a peer id private key in the config
- * 2. If not, check we have a peer id private key persisted in the node
- * 3. If not, create a new one, then persist it in the node
+ * 2. If not, check if we have a peer id private key persisted in a file
+ * 3. If no file path or data directory is provided, check if we have a peer id private key in the node's store
+ * 4. If not, create a new one, then persist it in a file if a file path or data directory is provided or in the node's store otherwise
  *
  */
 export declare function getPeerIdPrivateKey(config: {
-    peerIdPrivateKey?: string;
-}, store: AztecAsyncKVStore): Promise<string>;
+    peerIdPrivateKey?: SecretValue<string>;
+    peerIdPrivateKeyPath?: string;
+    dataDirectory?: string;
+}, store: AztecAsyncKVStore, logger: Logger): Promise<SecretValue<string>>;
 /**
  * Create a libp2p peer ID from the private key.
  * @param privateKey - peer ID private key as hex string
  * @returns The peer ID.
  */
 export declare function createLibP2PPeerIdFromPrivateKey(privateKey: string): Promise<PeerId>;
-//# sourceMappingURL=util.d.ts.map
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXRpbC5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL3V0aWwudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLFdBQVcsRUFBRSxNQUFNLDBCQUEwQixDQUFDO0FBQ3ZELE9BQU8sS0FBSyxFQUFFLE1BQU0sRUFBRSxNQUFNLHVCQUF1QixDQUFDO0FBQ3BELE9BQU8sS0FBSyxFQUFFLGlCQUFpQixFQUF1QixNQUFNLGlCQUFpQixDQUFDO0FBQzlFLE9BQU8sS0FBSyxFQUFFLGVBQWUsRUFBRSxNQUFNLHdCQUF3QixDQUFDO0FBRTlELE9BQU8sS0FBSyxFQUFFLFNBQVMsRUFBRSxNQUFNLDZCQUE2QixDQUFDO0FBRTdELE9BQU8sS0FBSyxFQUFFLFFBQVEsRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBQ2pELE9BQU8sS0FBSyxFQUFFLE1BQU0sRUFBYyxNQUFNLG1CQUFtQixDQUFDO0FBQzVELE9BQU8sS0FBSyxFQUFFLGlCQUFpQixFQUFFLE1BQU0sNEJBQTRCLENBQUM7QUFJcEUsT0FBTyxLQUFLLEVBQUUsTUFBTSxFQUFFLE1BQU0sUUFBUSxDQUFDO0FBSXJDLE9BQU8sS0FBSyxFQUFFLFNBQVMsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUk3QyxNQUFNLFdBQVcsWUFBYSxTQUFRLElBQUksQ0FBQyxNQUFNLEVBQUUsUUFBUSxHQUFHLE9BQU8sR0FBRyxNQUFNLEdBQUcsUUFBUSxDQUFDO0lBQ3hGLFFBQVEsRUFBRTtRQUNSLE1BQU0sRUFBRSxJQUFJLENBQ1YsU0FBUyxFQUNQLGtCQUFrQixHQUNsQixxQkFBcUIsR0FDckIsU0FBUyxHQUNULFdBQVcsR0FDWCwrQkFBK0IsR0FDL0IsUUFBUSxHQUNSLGNBQWMsQ0FDakIsR0FBRztZQUFFLEtBQUssRUFBRSxJQUFJLENBQUMsU0FBUyxDQUFDLE9BQU8sQ0FBQyxFQUFFLE9BQU8sQ0FBQyxDQUFBO1NBQUUsQ0FBQztLQUNsRCxDQUFDO0NBQ0g7QUFFRCxNQUFNLE1BQU0sVUFBVSxHQUFHLE1BQU0sQ0FBQztJQUM5QixRQUFRLEVBQUUsUUFBUSxDQUFDO0lBQ25CLE1BQU0sRUFBRSxTQUFTLENBQUM7SUFDbEIsVUFBVSxFQUFFO1FBQ1YsaUJBQWlCLEVBQUUsaUJBQWlCLENBQUM7S0FDdEMsQ0FBQztDQUNILENBQUMsQ0FBQztBQUVIOzs7Ozs7OzZDQU82QztBQUM3Qyx3QkFBZ0Isa0JBQWtCLENBQUMsT0FBTyxFQUFFLE1BQU0sRUFBRSxJQUFJLEVBQUUsTUFBTSxFQUFFLFFBQVEsRUFBRSxLQUFLLEdBQUcsS0FBSyxHQUFHLE1BQU0sQ0FPakc7QUFFRDs7R0FFRztBQUNILHdCQUFzQixXQUFXLElBQUksT0FBTyxDQUFDLE1BQU0sQ0FBQyxDQVFuRDtBQUVELHdCQUFnQixnQkFBZ0IsQ0FBQyxPQUFPLEVBQUUsTUFBTSxHQUFHLE9BQU8sQ0FHekQ7QUFFRCx3QkFBc0IseUJBQXlCLENBQUMsT0FBTyxFQUFFLE1BQU0sRUFBRSxJQUFJLEVBQUUsTUFBTSxHQUFHLE9BQU8sQ0FBQyxNQUFNLENBQUMsQ0FXOUY7QUFjRCx3QkFBc0IsMkJBQTJCLENBQy9DLE9BQU8sRUFBRSxTQUFTLEdBQUcsZUFBZSxHQUNuQyxPQUFPLENBQUMsU0FBUyxHQUFHLGVBQWUsQ0FBQyxDQW1CdEM7QUFFRDs7Ozs7Ozs7R0FRRztBQUNILHdCQUFzQixtQkFBbUIsQ0FDdkMsTUFBTSxFQUFFO0lBQUUsZ0JBQWdCLENBQUMsRUFBRSxXQUFXLENBQUMsTUFBTSxDQUFDLENBQUM7SUFBQyxvQkFBb0IsQ0FBQyxFQUFFLE1BQU0sQ0FBQztJQUFDLGFBQWEsQ0FBQyxFQUFFLE1BQU0sQ0FBQTtDQUFFLEVBQ3pHLEtBQUssRUFBRSxpQkFBaUIsRUFDeEIsTUFBTSxFQUFFLE1BQU0sR0FDYixPQUFPLENBQUMsV0FBVyxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBMkQ5QjtBQUVEOzs7O0dBSUc7QUFDSCx3QkFBc0IsZ0NBQWdDLENBQUMsVUFBVSxFQUFFLE1BQU0sR0FBRyxPQUFPLENBQUMsTUFBTSxDQUFDLENBUzFGIn0=

package/dest/util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAE7D,OAAO,KAAK,EAAE,MAAM,EAAc,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAGpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,YAAa,SAAQ,MAAM;IAC1C,QAAQ,EAAE;QACR,MAAM,EAAE,SAAS,CAAC;QAClB,UAAU,EAAE;YACV,iBAAiB,EAAE,iBAAiB,CAAC;SACtC,CAAC;KACH,CAAC;CACH;AAED;;;;;;;6CAO6C;AAC7C,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CASnF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAoB9F;AAED;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAInD;AAED,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAYhF;AAcD,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,SAAS,GAAG,eAAe,GACnC,OAAO,CAAC,SAAS,GAAG,eAAe,CAAC,CA6CtC;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,EACrC,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,MAAM,CAAC,CAiBjB;AAED;;;;GAIG;AACH,wBAAsB,gCAAgC,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAS1F"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAuB,MAAM,iBAAiB,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAE7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAc,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAIpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIrC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAI7C,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;IACxF,QAAQ,EAAE;QACR,MAAM,EAAE,IAAI,CACV,SAAS,EACP,kBAAkB,GAClB,qBAAqB,GACrB,SAAS,GACT,WAAW,GACX,+BAA+B,GAC/B,QAAQ,GACR,cAAc,CACjB,GAAG;YAAE,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAA;SAAE,CAAC;KAClD,CAAC;CACH;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;IAC9B,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,SAAS,CAAC;IAClB,UAAU,EAAE;QACV,iBAAiB,EAAE,iBAAiB,CAAC;KACtC,CAAC;CACH,CAAC,CAAC;AAEH;;;;;;;6CAO6C;AAC7C,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAOjG;AAED;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAQnD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGzD;AAED,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAW9F;AAcD,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,SAAS,GAAG,eAAe,GACnC,OAAO,CAAC,SAAS,GAAG,eAAe,CAAC,CAmBtC;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE;IAAE,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,EACzG,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CA2D9B;AAED;;;;GAIG;AACH,wBAAsB,gCAAgC,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAS1F"}