@aztec/p2p 0.7.2 → 0.7.4

package/dest/service/dummy_service.d.ts

@@ -0,0 +1,28 @@
+import { Tx, TxHash } from '@aztec/types';
+import { P2PService } from './service.js';
+/**
+ * A dummy implementation of the P2P Service.
+ */
+export declare class DummyP2PService implements P2PService {
+    /**
+     * Starts the dummy implementation.
+     * @returns A resolved promise.
+     */
+    start(): Promise<void>;
+    /**
+     * Stops the dummy imaplementation.
+     * @returns A resolved promise.
+     */
+    stop(): Promise<void>;
+    /**
+     * Called to have the given transaction propagated through the P2P network.
+     * @param _ - The transaction to be propagated.
+     */
+    propagateTx(_: Tx): void;
+    /**
+     * Called upon receipt of settled transactions.
+     * @param _ - The hashes of the settled transactions.
+     */
+    settledTxs(_: TxHash[]): void;
+}
+//# sourceMappingURL=dummy_service.d.ts.map

package/dest/service/dummy_service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dummy_service.d.ts","sourceRoot":"","sources":["../../src/service/dummy_service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;GAEG;AACH,qBAAa,eAAgB,YAAW,UAAU;IAChD;;;OAGG;IACI,KAAK;IAIZ;;;OAGG;IACI,IAAI;IAIX;;;OAGG;IACI,WAAW,CAAC,CAAC,EAAE,EAAE;IAExB;;;OAGG;IACI,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE;CAC9B"}

package/dest/service/dummy_service.js

@@ -0,0 +1,30 @@
+/**
+ * A dummy implementation of the P2P Service.
+ */
+export class DummyP2PService {
+    /**
+     * Starts the dummy implementation.
+     * @returns A resolved promise.
+     */
+    start() {
+        return Promise.resolve();
+    }
+    /**
+     * Stops the dummy imaplementation.
+     * @returns A resolved promise.
+     */
+    stop() {
+        return Promise.resolve();
+    }
+    /**
+     * Called to have the given transaction propagated through the P2P network.
+     * @param _ - The transaction to be propagated.
+     */
+    propagateTx(_) { }
+    /**
+     * Called upon receipt of settled transactions.
+     * @param _ - The hashes of the settled transactions.
+     */
+    settledTxs(_) { }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZHVtbXlfc2VydmljZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9zZXJ2aWNlL2R1bW15X3NlcnZpY2UudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBSUE7O0dBRUc7QUFDSCxNQUFNLE9BQU8sZUFBZTtJQUMxQjs7O09BR0c7SUFDSSxLQUFLO1FBQ1YsT0FBTyxPQUFPLENBQUMsT0FBTyxFQUFFLENBQUM7SUFDM0IsQ0FBQztJQUVEOzs7T0FHRztJQUNJLElBQUk7UUFDVCxPQUFPLE9BQU8sQ0FBQyxPQUFPLEVBQUUsQ0FBQztJQUMzQixDQUFDO0lBRUQ7OztPQUdHO0lBQ0ksV0FBVyxDQUFDLENBQUssSUFBRyxDQUFDO0lBRTVCOzs7T0FHRztJQUNJLFVBQVUsQ0FBQyxDQUFXLElBQUcsQ0FBQztDQUNsQyJ9

package/dest/service/index.d.ts

@@ -0,0 +1,3 @@
+export * from './service.js';
+export * from './libp2p_service.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/service/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC"}

package/dest/service/index.js

@@ -0,0 +1,3 @@
+export * from './service.js';
+export * from './libp2p_service.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvc2VydmljZS9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLGNBQWMsQ0FBQztBQUM3QixjQUFjLHFCQUFxQixDQUFDIn0=

package/dest/service/known_txs.d.ts

@@ -0,0 +1,31 @@
+import { PeerId } from '@libp2p/interface-peer-id';
+/**
+ * Keeps a record of which Peers have 'seen' which transactions.
+ */
+export declare class KnownTxLookup {
+    private lookup;
+    constructor();
+    /**
+     * Inform this lookup that a peer has 'seen' a transaction.
+     * @param peerId - The peerId of the peer that has 'seen' the transaction.
+     * @param txHash - The thHash of the 'seen' transaction.
+     */
+    addPeerForTx(peerId: PeerId, txHash: string): void;
+    /**
+     * Determine if a peer has 'seen' a transaction.
+     * @param peerId - The peerId of the peer.
+     * @param txHash - The thHash of the transaction.
+     * @returns A boolean indicating if the transaction has been 'seen' by the peer.
+     */
+    hasPeerSeenTx(peerId: PeerId, txHash: string): boolean;
+    /**
+     * Updates the lookup from the result of settled txs
+     * These txs will be cleared out of the lookup.
+     * It is possible that some txs could still be gossiped for a
+     * short period of time meaning they come back into this lookup
+     * but this should be infrequent and cause no undesirable effects
+     * @param txHashes - The hashes of the newly settled transactions
+     */
+    handleSettledTxs(txHashes: string[]): void;
+}
+//# sourceMappingURL=known_txs.d.ts.map

package/dest/service/known_txs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"known_txs.d.ts","sourceRoot":"","sources":["../../src/service/known_txs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAEnD;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAqD;;IAInE;;;;OAIG;IACI,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAYlD;;;;;OAKG;IACI,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IASnD;;;;;;;OAOG;IACI,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE;CAK3C"}

package/dest/service/known_txs.js

@@ -0,0 +1,52 @@
+/**
+ * Keeps a record of which Peers have 'seen' which transactions.
+ */
+export class KnownTxLookup {
+    constructor() {
+        this.lookup = {};
+    }
+    /**
+     * Inform this lookup that a peer has 'seen' a transaction.
+     * @param peerId - The peerId of the peer that has 'seen' the transaction.
+     * @param txHash - The thHash of the 'seen' transaction.
+     */
+    addPeerForTx(peerId, txHash) {
+        const peerIdAsString = peerId.toString();
+        const existingLookup = this.lookup[txHash];
+        if (existingLookup === undefined) {
+            const newLookup = {};
+            newLookup[peerIdAsString] = true;
+            this.lookup[txHash] = newLookup;
+            return;
+        }
+        existingLookup[peerIdAsString] = true;
+    }
+    /**
+     * Determine if a peer has 'seen' a transaction.
+     * @param peerId - The peerId of the peer.
+     * @param txHash - The thHash of the transaction.
+     * @returns A boolean indicating if the transaction has been 'seen' by the peer.
+     */
+    hasPeerSeenTx(peerId, txHash) {
+        const existingLookup = this.lookup[txHash];
+        if (existingLookup === undefined) {
+            return false;
+        }
+        const peerIdAsString = peerId.toString();
+        return !!existingLookup[peerIdAsString];
+    }
+    /**
+     * Updates the lookup from the result of settled txs
+     * These txs will be cleared out of the lookup.
+     * It is possible that some txs could still be gossiped for a
+     * short period of time meaning they come back into this lookup
+     * but this should be infrequent and cause no undesirable effects
+     * @param txHashes - The hashes of the newly settled transactions
+     */
+    handleSettledTxs(txHashes) {
+        for (const txHash of txHashes) {
+            delete this.lookup[txHash];
+        }
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoia25vd25fdHhzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3NlcnZpY2Uva25vd25fdHhzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUVBOztHQUVHO0FBQ0gsTUFBTSxPQUFPLGFBQWE7SUFHeEI7UUFGUSxXQUFNLEdBQWtELEVBQUUsQ0FBQztJQUVwRCxDQUFDO0lBRWhCOzs7O09BSUc7SUFDSSxZQUFZLENBQUMsTUFBYyxFQUFFLE1BQWM7UUFDaEQsTUFBTSxjQUFjLEdBQUcsTUFBTSxDQUFDLFFBQVEsRUFBRSxDQUFDO1FBQ3pDLE1BQU0sY0FBYyxHQUFHLElBQUksQ0FBQyxNQUFNLENBQUMsTUFBTSxDQUFDLENBQUM7UUFDM0MsSUFBSSxjQUFjLEtBQUssU0FBUyxFQUFFO1lBQ2hDLE1BQU0sU0FBUyxHQUErQixFQUFFLENBQUM7WUFDakQsU0FBUyxDQUFDLGNBQWMsQ0FBQyxHQUFHLElBQUksQ0FBQztZQUNqQyxJQUFJLENBQUMsTUFBTSxDQUFDLE1BQU0sQ0FBQyxHQUFHLFNBQVMsQ0FBQztZQUNoQyxPQUFPO1NBQ1I7UUFDRCxjQUFjLENBQUMsY0FBYyxDQUFDLEdBQUcsSUFBSSxDQUFDO0lBQ3hDLENBQUM7SUFFRDs7Ozs7T0FLRztJQUNJLGFBQWEsQ0FBQyxNQUFjLEVBQUUsTUFBYztRQUNqRCxNQUFNLGNBQWMsR0FBRyxJQUFJLENBQUMsTUFBTSxDQUFDLE1BQU0sQ0FBQyxDQUFDO1FBQzNDLElBQUksY0FBYyxLQUFLLFNBQVMsRUFBRTtZQUNoQyxPQUFPLEtBQUssQ0FBQztTQUNkO1FBQ0QsTUFBTSxjQUFjLEdBQUcsTUFBTSxDQUFDLFFBQVEsRUFBRSxDQUFDO1FBQ3pDLE9BQU8sQ0FBQyxDQUFDLGNBQWMsQ0FBQyxjQUFjLENBQUMsQ0FBQztJQUMxQyxDQUFDO0lBRUQ7Ozs7Ozs7T0FPRztJQUNJLGdCQUFnQixDQUFDLFFBQWtCO1FBQ3hDLEtBQUssTUFBTSxNQUFNLElBQUksUUFBUSxFQUFFO1lBQzdCLE9BQU8sSUFBSSxDQUFDLE1BQU0sQ0FBQyxNQUFNLENBQUMsQ0FBQztTQUM1QjtJQUNILENBQUM7Q0FDRiJ9

package/dest/service/known_txs.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=known_txs.test.d.ts.map

package/dest/service/known_txs.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"known_txs.test.d.ts","sourceRoot":"","sources":["../../src/service/known_txs.test.ts"],"names":[],"mappings":""}

package/dest/service/known_txs.test.js

@@ -0,0 +1,34 @@
+import { randomBytes } from '@aztec/foundation/crypto';
+import { TxHash } from '@aztec/types';
+import { expect } from '@jest/globals';
+import { mock } from 'jest-mock-extended';
+import { KnownTxLookup } from './known_txs.js';
+const createMockPeerId = (peerId) => {
+    return mock({
+        toString: () => peerId,
+    });
+};
+const createTxHash = () => {
+    return new TxHash(randomBytes(32));
+};
+describe('Known Txs', () => {
+    it('Returns false when a peer has not seen a tx', () => {
+        const knownTxs = new KnownTxLookup();
+        const peer = createMockPeerId('Peer 1');
+        const txHash = createTxHash();
+        expect(knownTxs.hasPeerSeenTx(peer, txHash.toString())).toEqual(false);
+    });
+    it('Returns true when a peer has seen a tx', () => {
+        const knownTxs = new KnownTxLookup();
+        const peer = createMockPeerId('Peer 1');
+        const peer2 = createMockPeerId('Peer 2');
+        const txHash = createTxHash();
+        knownTxs.addPeerForTx(peer, txHash.toString());
+        expect(knownTxs.hasPeerSeenTx(peer, txHash.toString())).toEqual(true);
+        expect(knownTxs.hasPeerSeenTx(peer2, txHash.toString())).toEqual(false);
+        knownTxs.addPeerForTx(peer2, txHash.toString());
+        expect(knownTxs.hasPeerSeenTx(peer, txHash.toString())).toEqual(true);
+        expect(knownTxs.hasPeerSeenTx(peer2, txHash.toString())).toEqual(true);
+    });
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoia25vd25fdHhzLnRlc3QuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvc2VydmljZS9rbm93bl90eHMudGVzdC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsV0FBVyxFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUFDdkQsT0FBTyxFQUFFLE1BQU0sRUFBRSxNQUFNLGNBQWMsQ0FBQztBQUV0QyxPQUFPLEVBQUUsTUFBTSxFQUFFLE1BQU0sZUFBZSxDQUFDO0FBRXZDLE9BQU8sRUFBRSxJQUFJLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUUxQyxPQUFPLEVBQUUsYUFBYSxFQUFFLE1BQU0sZ0JBQWdCLENBQUM7QUFFL0MsTUFBTSxnQkFBZ0IsR0FBRyxDQUFDLE1BQWMsRUFBVSxFQUFFO0lBQ2xELE9BQU8sSUFBSSxDQUFnQjtRQUN6QixRQUFRLEVBQUUsR0FBRyxFQUFFLENBQUMsTUFBTTtLQUN2QixDQUFDLENBQUM7QUFDTCxDQUFDLENBQUM7QUFFRixNQUFNLFlBQVksR0FBRyxHQUFHLEVBQUU7SUFDeEIsT0FBTyxJQUFJLE1BQU0sQ0FBQyxXQUFXLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FBQztBQUNyQyxDQUFDLENBQUM7QUFFRixRQUFRLENBQUMsV0FBVyxFQUFFLEdBQUcsRUFBRTtJQUN6QixFQUFFLENBQUMsNkNBQTZDLEVBQUUsR0FBRyxFQUFFO1FBQ3JELE1BQU0sUUFBUSxHQUFHLElBQUksYUFBYSxFQUFFLENBQUM7UUFFckMsTUFBTSxJQUFJLEdBQUcsZ0JBQWdCLENBQUMsUUFBUSxDQUFDLENBQUM7UUFDeEMsTUFBTSxNQUFNLEdBQUcsWUFBWSxFQUFFLENBQUM7UUFFOUIsTUFBTSxDQUFDLFFBQVEsQ0FBQyxhQUFhLENBQUMsSUFBSSxFQUFFLE1BQU0sQ0FBQyxRQUFRLEVBQUUsQ0FBQyxDQUFDLENBQUMsT0FBTyxDQUFDLEtBQUssQ0FBQyxDQUFDO0lBQ3pFLENBQUMsQ0FBQyxDQUFDO0lBRUgsRUFBRSxDQUFDLHdDQUF3QyxFQUFFLEdBQUcsRUFBRTtRQUNoRCxNQUFNLFFBQVEsR0FBRyxJQUFJLGFBQWEsRUFBRSxDQUFDO1FBRXJDLE1BQU0sSUFBSSxHQUFHLGdCQUFnQixDQUFDLFFBQVEsQ0FBQyxDQUFDO1FBQ3hDLE1BQU0sS0FBSyxHQUFHLGdCQUFnQixDQUFDLFFBQVEsQ0FBQyxDQUFDO1FBQ3pDLE1BQU0sTUFBTSxHQUFHLFlBQVksRUFBRSxDQUFDO1FBRTlCLFFBQVEsQ0FBQyxZQUFZLENBQUMsSUFBSSxFQUFFLE1BQU0sQ0FBQyxRQUFRLEVBQUUsQ0FBQyxDQUFDO1FBRS9DLE1BQU0sQ0FBQyxRQUFRLENBQUMsYUFBYSxDQUFDLElBQUksRUFBRSxNQUFNLENBQUMsUUFBUSxFQUFFLENBQUMsQ0FBQyxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztRQUN0RSxNQUFNLENBQUMsUUFBUSxDQUFDLGFBQWEsQ0FBQyxLQUFLLEVBQUUsTUFBTSxDQUFDLFFBQVEsRUFBRSxDQUFDLENBQUMsQ0FBQyxPQUFPLENBQUMsS0FBSyxDQUFDLENBQUM7UUFFeEUsUUFBUSxDQUFDLFlBQVksQ0FBQyxLQUFLLEVBQUUsTUFBTSxDQUFDLFFBQVEsRUFBRSxDQUFDLENBQUM7UUFFaEQsTUFBTSxDQUFDLFFBQVEsQ0FBQyxhQUFhLENBQUMsSUFBSSxFQUFFLE1BQU0sQ0FBQyxRQUFRLEVBQUUsQ0FBQyxDQUFDLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDO1FBQ3RFLE1BQU0sQ0FBQyxRQUFRLENBQUMsYUFBYSxDQUFDLEtBQUssRUFBRSxNQUFNLENBQUMsUUFBUSxFQUFFLENBQUMsQ0FBQyxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUN6RSxDQUFDLENBQUMsQ0FBQztBQUNMLENBQUMsQ0FBQyxDQUFDIn0=

package/dest/service/libp2p_service.d.ts

@@ -0,0 +1,74 @@
+import { Tx, TxHash } from '@aztec/types';
+import { PeerId } from '@libp2p/interface-peer-id';
+import { Libp2p } from 'libp2p';
+import { P2PConfig } from '../config.js';
+import { TxPool } from '../index.js';
+import { P2PService } from './service.js';
+/**
+ * Create a libp2p peer ID.
+ * @returns The peer ID.
+ */
+export declare function createLibP2PPeerId(): Promise<import("@libp2p/interface/peer-id").Ed25519PeerId>;
+/**
+ * Exports a given peer id to a string representation.
+ * @param peerId - The peerId instance to be converted.
+ * @returns The peer id as a string.
+ */
+export declare function exportLibP2PPeerIdToString(peerId: PeerId): string;
+/**
+ * Lib P2P implementation of the P2PService interface.
+ */
+export declare class LibP2PService implements P2PService {
+    private config;
+    private node;
+    private protocolId;
+    private txPool;
+    private logger;
+    private jobQueue;
+    private timeout;
+    private knownTxLookup;
+    constructor(config: P2PConfig, node: Libp2p, protocolId: string, txPool: TxPool, logger?: import("@aztec/foundation/log").DebugLogger);
+    /**
+     * Starts the LibP2P service.
+     * @returns An empty promise.
+     */
+    start(): Promise<void>;
+    /**
+     * Stops the LibP2P service.
+     * @returns An empty promise.
+     */
+    stop(): Promise<void>;
+    /**
+     * Creates an instance of the LibP2P service.
+     * @param config - The configuration to use when creating the service.
+     * @param txPool - The transaction pool to be accessed by the service.
+     * @returns The new service.
+     */
+    static new(config: P2PConfig, txPool: TxPool): Promise<LibP2PService>;
+    /**
+     * Propagates the provided transaction to peers.
+     * @param tx - The transaction to propagate.
+     */
+    propagateTx(tx: Tx): void;
+    /**
+     * Handles the settling of a new batch of transactions.
+     * @param txHashes - The hashes of the newly settled transactions.
+     */
+    settledTxs(txHashes: TxHash[]): void;
+    private handleProtocolDial;
+    private consumeInboundStream;
+    private handleNewConnection;
+    private processMessage;
+    private processReceivedTxHashes;
+    private processReceivedGetTransactionsRequest;
+    private processReceivedTxs;
+    private processTxFromPeer;
+    private sendTxToPeers;
+    private sendTxHashesMessageToPeer;
+    private sendGetTransactionsMessageToPeer;
+    private sendTransactionsMessageToPeer;
+    private sendRawMessageToPeer;
+    private getTxPeers;
+    private isBootstrapPeer;
+}
+//# sourceMappingURL=libp2p_service.d.ts.map

package/dest/service/libp2p_service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"libp2p_service.d.ts","sourceRoot":"","sources":["../../src/service/libp2p_service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAM1C,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAOnD,OAAO,EAAE,MAAM,EAAkD,MAAM,QAAQ,CAAC;AAIhF,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAc1C;;;GAGG;AACH,wBAAsB,kBAAkB,+DAEvC;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,UAExD;AAED;;GAEG;AACH,qBAAa,aAAc,YAAW,UAAU;IAK5C,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,MAAM;IARhB,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,aAAa,CAAsC;gBAEjD,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,8CAA4C;IAG5D;;;OAGG;IACU,KAAK;IA2ClB;;;OAGG;IACU,IAAI;IAQjB;;;;;OAKG;WACiB,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM;IA4DzD;;;OAGG;IACI,WAAW,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI;IAIhC;;;OAGG;IACI,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;YAI7B,kBAAkB;YAelB,oBAAoB;IAYlC,OAAO,CAAC,mBAAmB;YAYb,cAAc;YAiBd,uBAAuB;YAevB,qCAAqC;YAgBrC,kBAAkB;YAalB,iBAAiB;YASjB,aAAa;YAsBb,yBAAyB;YAazB,gCAAgC;YAShC,6BAA6B;YAW7B,oBAAoB;IAMlC,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,eAAe;CAGxB"}

package/dest/service/libp2p_service.js

@@ -0,0 +1,335 @@
+import { SerialQueue } from '@aztec/foundation/fifo';
+import { createDebugLogger } from '@aztec/foundation/log';
+import { noise } from '@chainsafe/libp2p-noise';
+import { yamux } from '@chainsafe/libp2p-yamux';
+import { bootstrap } from '@libp2p/bootstrap';
+import { kadDHT } from '@libp2p/kad-dht';
+import { mplex } from '@libp2p/mplex';
+import { createEd25519PeerId, createFromProtobuf, exportToProtobuf } from '@libp2p/peer-id-factory';
+import { tcp } from '@libp2p/tcp';
+import { pipe } from 'it-pipe';
+import { createLibp2p } from 'libp2p';
+import { autoNATService } from 'libp2p/autonat';
+import { identifyService } from 'libp2p/identify';
+import { KnownTxLookup } from './known_txs.js';
+import { Messages, createGetTransactionsRequestMessage, createTransactionHashesMessage, createTransactionsMessage, decodeGetTransactionsRequestMessage, decodeTransactionHashesMessage, decodeTransactionsMessage, getEncodedMessage, } from './tx_messages.js';
+const INITIAL_PEER_REFRESH_INTERVAL = 20000;
+/**
+ * Create a libp2p peer ID.
+ * @returns The peer ID.
+ */
+export async function createLibP2PPeerId() {
+    return await createEd25519PeerId();
+}
+/**
+ * Exports a given peer id to a string representation.
+ * @param peerId - The peerId instance to be converted.
+ * @returns The peer id as a string.
+ */
+export function exportLibP2PPeerIdToString(peerId) {
+    return Buffer.from(exportToProtobuf(peerId)).toString('hex');
+}
+/**
+ * Lib P2P implementation of the P2PService interface.
+ */
+export class LibP2PService {
+    constructor(config, node, protocolId, txPool, logger = createDebugLogger('aztec:libp2p_service')) {
+        this.config = config;
+        this.node = node;
+        this.protocolId = protocolId;
+        this.txPool = txPool;
+        this.logger = logger;
+        this.jobQueue = new SerialQueue();
+        this.timeout = undefined;
+        this.knownTxLookup = new KnownTxLookup();
+    }
+    /**
+     * Starts the LibP2P service.
+     * @returns An empty promise.
+     */
+    async start() {
+        if (this.node.isStarted()) {
+            throw new Error('P2P service already started');
+        }
+        const { enableNat, tcpListenIp, tcpListenPort, announceHostname, announcePort } = this.config;
+        this.logger(`Starting P2P node on ${tcpListenIp}:${tcpListenPort}`);
+        if (announceHostname)
+            this.logger(`Announcing at ${announceHostname}:${announcePort ?? tcpListenPort}`);
+        if (enableNat)
+            this.logger(`Enabling NAT in libp2p module`);
+        this.node.addEventListener('peer:discovery', evt => {
+            const peerId = evt.detail.id;
+            if (this.isBootstrapPeer(peerId)) {
+                this.logger(`Discovered bootstrap peer ${peerId.toString()}`);
+            }
+        });
+        this.node.addEventListener('peer:connect', evt => {
+            const peerId = evt.detail;
+            this.handleNewConnection(peerId);
+        });
+        this.node.addEventListener('peer:disconnect', evt => {
+            const peerId = evt.detail;
+            if (this.isBootstrapPeer(peerId)) {
+                this.logger(`Disconnect from bootstrap peer ${peerId.toString()}`);
+            }
+            else {
+                this.logger(`Disconnected from transaction peer ${peerId.toString()}`);
+            }
+        });
+        this.jobQueue.start();
+        await this.node.start();
+        await this.node.handle(this.protocolId, (incoming) => this.jobQueue.put(() => Promise.resolve(this.handleProtocolDial(incoming))));
+        const dht = this.node.services['kadDHT'];
+        this.logger(`Started P2P client as ${await dht.getMode()} with Peer ID ${this.node.peerId.toString()}`);
+        this.timeout = setTimeout(async () => {
+            this.logger(`Refreshing routing table...`);
+            await dht.refreshRoutingTable();
+        }, INITIAL_PEER_REFRESH_INTERVAL);
+    }
+    /**
+     * Stops the LibP2P service.
+     * @returns An empty promise.
+     */
+    async stop() {
+        if (this.timeout) {
+            clearTimeout(this.timeout);
+        }
+        await this.jobQueue.end();
+        await this.node.stop();
+    }
+    /**
+     * Creates an instance of the LibP2P service.
+     * @param config - The configuration to use when creating the service.
+     * @param txPool - The transaction pool to be accessed by the service.
+     * @returns The new service.
+     */
+    static async new(config, txPool) {
+        const { enableNat, tcpListenIp, tcpListenPort, announceHostname, announcePort, serverMode, minPeerCount, maxPeerCount, } = config;
+        const peerId = config.peerIdPrivateKey
+            ? await createFromProtobuf(Buffer.from(config.peerIdPrivateKey, 'hex'))
+            : await createLibP2PPeerId();
+        const opts = {
+            start: false,
+            peerId,
+            addresses: {
+                listen: [`/ip4/${tcpListenIp}/tcp/${tcpListenPort}`],
+                announce: announceHostname ? [`/ip4/${announceHostname}/tcp/${announcePort ?? tcpListenPort}`] : [],
+            },
+            transports: [tcp()],
+            streamMuxers: [yamux(), mplex()],
+            connectionEncryption: [noise()],
+            connectionManager: {
+                minConnections: minPeerCount,
+                maxConnections: maxPeerCount,
+            },
+            peerDiscovery: [
+                bootstrap({
+                    list: config.bootstrapNodes,
+                }),
+            ],
+        };
+        const services = {
+            identify: identifyService({
+                protocolPrefix: 'aztec',
+            }),
+            kadDHT: kadDHT({
+                protocolPrefix: 'aztec',
+                clientMode: !serverMode,
+            }),
+        };
+        if (enableNat) {
+            services.nat = autoNATService({
+                protocolPrefix: 'aztec',
+            });
+        }
+        const node = await createLibp2p({
+            ...opts,
+            services,
+        });
+        const protocolId = config.transactionProtocol;
+        return new LibP2PService(config, node, protocolId, txPool);
+    }
+    /**
+     * Propagates the provided transaction to peers.
+     * @param tx - The transaction to propagate.
+     */
+    propagateTx(tx) {
+        void this.jobQueue.put(() => Promise.resolve(this.sendTxToPeers(tx)));
+    }
+    /**
+     * Handles the settling of a new batch of transactions.
+     * @param txHashes - The hashes of the newly settled transactions.
+     */
+    settledTxs(txHashes) {
+        this.knownTxLookup.handleSettledTxs(txHashes.map(x => x.toString()));
+    }
+    async handleProtocolDial(incomingStreamData) {
+        try {
+            const { message, peer } = await this.consumeInboundStream(incomingStreamData);
+            if (!message.length) {
+                this.logger(`Ignoring 0 byte message from peer${peer.toString()}`);
+            }
+            await this.processMessage(message, peer);
+        }
+        catch (err) {
+            this.logger.error(`Failed to handle received message from peer ${incomingStreamData.connection.remotePeer.toString()}`, err);
+        }
+    }
+    async consumeInboundStream(incomingStreamData) {
+        let buffer = Buffer.alloc(0);
+        await pipe(incomingStreamData.stream, async (source) => {
+            for await (const msg of source) {
+                const payload = msg.subarray();
+                buffer = Buffer.concat([buffer, Buffer.from(payload)]);
+            }
+        });
+        await incomingStreamData.stream.close();
+        return { message: buffer, peer: incomingStreamData.connection.remotePeer };
+    }
+    handleNewConnection(peerId) {
+        if (this.isBootstrapPeer(peerId)) {
+            this.logger(`Connected to bootstrap peer ${peerId.toString()}`);
+        }
+        else {
+            this.logger(`Connected to transaction peer ${peerId.toString()}`);
+            // send the peer our current pooled transaction hashes
+            void this.jobQueue.put(async () => {
+                await this.sendTxHashesMessageToPeer(peerId);
+            });
+        }
+    }
+    async processMessage(message, peerId) {
+        const type = message.readUInt32BE(0);
+        const encodedMessage = getEncodedMessage(message);
+        switch (type) {
+            case Messages.POOLED_TRANSACTIONS:
+                await this.processReceivedTxs(encodedMessage, peerId);
+                return;
+            case Messages.POOLED_TRANSACTION_HASHES:
+                await this.processReceivedTxHashes(encodedMessage, peerId);
+                return;
+            case Messages.GET_TRANSACTIONS:
+                await this.processReceivedGetTransactionsRequest(encodedMessage, peerId);
+                return;
+        }
+        throw new Error(`Unknown message type ${type}`);
+    }
+    async processReceivedTxHashes(encodedMessage, peerId) {
+        try {
+            const txHashes = decodeTransactionHashesMessage(encodedMessage);
+            this.logger(`Received tx hash messages from ${peerId.toString()}`);
+            // we send a message requesting the transactions that we don't have from the set of received hashes
+            const requiredHashes = txHashes.filter(hash => !this.txPool.hasTx(hash));
+            if (!requiredHashes.length) {
+                return;
+            }
+            await this.sendGetTransactionsMessageToPeer(txHashes, peerId);
+        }
+        catch (err) {
+            this.logger.error(`Failed to process received tx hashes`, err);
+        }
+    }
+    async processReceivedGetTransactionsRequest(encodedMessage, peerId) {
+        try {
+            this.logger(`Received get txs messages from ${peerId.toString()}`);
+            // get the transactions in the list that we have and return them
+            const removeUndefined = (value) => value != undefined;
+            const txHashes = decodeGetTransactionsRequestMessage(encodedMessage);
+            const txs = txHashes.map(x => this.txPool.getTxByHash(x)).filter(removeUndefined);
+            if (!txs.length) {
+                return;
+            }
+            await this.sendTransactionsMessageToPeer(txs, peerId);
+        }
+        catch (err) {
+            this.logger.error(`Failed to process get txs request`, err);
+        }
+    }
+    async processReceivedTxs(encodedMessage, peerId) {
+        try {
+            const txs = decodeTransactionsMessage(encodedMessage);
+            // Could optimise here and process all txs at once
+            // Propagation would need to filter and send custom tx set per peer
+            for (const tx of txs) {
+                await this.processTxFromPeer(tx, peerId);
+            }
+        }
+        catch (err) {
+            this.logger.error(`Failed to process pooled transactions message`, err);
+        }
+    }
+    async processTxFromPeer(tx, peerId) {
+        const txHash = await tx.getTxHash();
+        const txHashString = txHash.toString();
+        this.knownTxLookup.addPeerForTx(peerId, txHashString);
+        this.logger(`Received tx ${txHashString} from peer ${peerId.toString()}`);
+        await this.txPool.addTxs([tx]);
+        this.propagateTx(tx);
+    }
+    async sendTxToPeers(tx) {
+        const txs = createTransactionsMessage([tx]);
+        const payload = new Uint8Array(txs);
+        const peers = this.getTxPeers();
+        const txHash = await tx.getTxHash();
+        const txHashString = txHash.toString();
+        for (const peer of peers) {
+            try {
+                if (this.knownTxLookup.hasPeerSeenTx(peer, txHashString)) {
+                    this.logger(`Not sending tx ${txHashString} to peer ${peer.toString()} as they have already seen it`);
+                    continue;
+                }
+                this.logger(`Sending tx ${txHashString} to peer ${peer.toString()}`);
+                await this.sendRawMessageToPeer(payload, peer);
+                this.knownTxLookup.addPeerForTx(peer, txHashString);
+            }
+            catch (err) {
+                this.logger.error(`Failed to send txs to peer ${peer.toString()}`, err);
+                continue;
+            }
+        }
+    }
+    async sendTxHashesMessageToPeer(peer) {
+        try {
+            const hashes = this.txPool.getAllTxHashes();
+            if (!hashes.length) {
+                return;
+            }
+            const message = createTransactionHashesMessage(hashes);
+            await this.sendRawMessageToPeer(new Uint8Array(message), peer);
+        }
+        catch (err) {
+            this.logger.error(`Failed to send tx hashes to peer ${peer.toString()}`, err);
+        }
+    }
+    async sendGetTransactionsMessageToPeer(hashes, peer) {
+        try {
+            const message = createGetTransactionsRequestMessage(hashes);
+            await this.sendRawMessageToPeer(new Uint8Array(message), peer);
+        }
+        catch (err) {
+            this.logger.error(`Failed to send tx request to peer ${peer.toString()}`, err);
+        }
+    }
+    async sendTransactionsMessageToPeer(txs, peer) {
+        // don't filter out any transactions based on what we think the peer has seen,
+        // we have been explicitly asked for these transactions
+        const message = createTransactionsMessage(txs);
+        await this.sendRawMessageToPeer(message, peer);
+        for (const tx of txs) {
+            const hash = await tx.getTxHash();
+            this.knownTxLookup.addPeerForTx(peer, hash.toString());
+        }
+    }
+    async sendRawMessageToPeer(message, peer) {
+        const stream = await this.node.dialProtocol(peer, this.protocolId);
+        await pipe([message], stream);
+        await stream.close();
+    }
+    getTxPeers() {
+        return this.node.getPeers().filter(peer => !this.isBootstrapPeer(peer));
+    }
+    isBootstrapPeer(peer) {
+        return this.config.bootstrapNodes.findIndex(bootstrap => bootstrap.includes(peer.toString())) != -1;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibGlicDJwX3NlcnZpY2UuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvc2VydmljZS9saWJwMnBfc2VydmljZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsV0FBVyxFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFDckQsT0FBTyxFQUFFLGlCQUFpQixFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFHMUQsT0FBTyxFQUFFLEtBQUssRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBQ2hELE9BQU8sRUFBRSxLQUFLLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUNoRCxPQUFPLEVBQUUsU0FBUyxFQUFFLE1BQU0sbUJBQW1CLENBQUM7QUFJOUMsT0FBTyxFQUFjLE1BQU0sRUFBRSxNQUFNLGlCQUFpQixDQUFDO0FBQ3JELE9BQU8sRUFBRSxLQUFLLEVBQUUsTUFBTSxlQUFlLENBQUM7QUFDdEMsT0FBTyxFQUFFLG1CQUFtQixFQUFFLGtCQUFrQixFQUFFLGdCQUFnQixFQUFFLE1BQU0seUJBQXlCLENBQUM7QUFDcEcsT0FBTyxFQUFFLEdBQUcsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUNsQyxPQUFPLEVBQUUsSUFBSSxFQUFFLE1BQU0sU0FBUyxDQUFDO0FBQy9CLE9BQU8sRUFBNEMsWUFBWSxFQUFFLE1BQU0sUUFBUSxDQUFDO0FBQ2hGLE9BQU8sRUFBRSxjQUFjLEVBQUUsTUFBTSxnQkFBZ0IsQ0FBQztBQUNoRCxPQUFPLEVBQUUsZUFBZSxFQUFFLE1BQU0saUJBQWlCLENBQUM7QUFJbEQsT0FBTyxFQUFFLGFBQWEsRUFBRSxNQUFNLGdCQUFnQixDQUFDO0FBRS9DLE9BQU8sRUFDTCxRQUFRLEVBQ1IsbUNBQW1DLEVBQ25DLDhCQUE4QixFQUM5Qix5QkFBeUIsRUFDekIsbUNBQW1DLEVBQ25DLDhCQUE4QixFQUM5Qix5QkFBeUIsRUFDekIsaUJBQWlCLEdBQ2xCLE1BQU0sa0JBQWtCLENBQUM7QUFFMUIsTUFBTSw2QkFB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