@bsv/sdk 1.2.20 → 1.2.22

package/dist/cjs/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bsv/sdk",
-  "version": "1.2.20",
+  "version": "1.2.22",
   "type": "commonjs",
   "description": "BSV Blockchain Software Development Kit",
   "files": [
@@ -20,7 +20,7 @@
     "build:umd": "webpack --config webpack.config.js",
     "dev": "tsc -b -w",
     "prepublish": "npm run build",
-    "doc": "ts2md --inputFilename=src/script/index.ts --outputFilename=docs/script.md --filenameSubString=script --firstHeadingLevel=1 && ts2md --inputFilename=src/primitives/index.ts --outputFilename=docs/primitives.md --filenameSubString=primitives --firstHeadingLevel=1 && ts2md --inputFilename=src/transaction/index.ts --outputFilename=docs/transaction.md --filenameSubString=transaction --firstHeadingLevel=1 && ts2md --inputFilename=src/messages/index.ts --outputFilename=docs/messages.md --filenameSubString=messages --firstHeadingLevel=1 && ts2md --inputFilename=src/compat/index.ts --outputFilename=docs/compat.md --filenameSubString=compat --firstHeadingLevel=1 && ts2md --inputFilename=src/wallet/index.ts --outputFilename=docs/wallet.md --filenameSubString=wallet --firstHeadingLevel=1 && ts2md --inputFilename=src/wallet/substrates/index.ts --outputFilename=docs/wallet-substrates.md --filenameSubString=wallet/substrates --firstHeadingLevel=1 && ts2md --inputFilename=src/totp/index.ts --outputFilename=docs/totp.md --filenameSubString=totp --firstHeadingLevel=1 && ts2md --inputFilename=src/overlay-tools/index.ts --outputFilename=docs/overlay-tools.md --filenameSubString=overlay-tools --firstHeadingLevel=1"
+    "doc": "ts2md"
   },
   "repository": {
     "type": "git",
@@ -46,7 +46,7 @@
     "ts-jest": "^29.1.1",
     "ts-loader": "^9.5.1",
     "ts-standard": "^12.0.2",
-    "ts2md": "^0.2.4",
+    "ts2md": "^0.2.5",
     "tsconfig-to-dual-package": "^1.2.0",
     "typescript": "^5.2.2",
     "webpack": "^5.95.0",

package/dist/cjs/src/auth/Peer.js

@@ -0,0 +1,536 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Peer = void 0;
+const SessionManager_js_1 = require("./SessionManager.js");
+const index_js_1 = require("./utils/index.js");
+const mod_js_1 = require("../../mod.js");
+const AUTH_VERSION = '0.1';
+/**
+ * Represents a peer capable of performing mutual authentication.
+ * Manages sessions, handles authentication handshakes, certificate requests and responses,
+ * and sending and receiving general messages over a transport layer.
+ */
+class Peer {
+    /**
+     * Creates a new Peer instance
+     *
+     * @param {Wallet} wallet - The wallet instance used for cryptographic operations.
+     * @param {Transport} transport - The transport mechanism used for sending and receiving messages.
+     * @param {RequestedCertificateSet} [certificatesToRequest] - Optional set of certificates to request from a peer during the initial handshake.
+     * @param {SessionManager} [sessionManager] - Optional SessionManager to be used for managing peer sessions.
+     */
+    constructor(wallet, transport, certificatesToRequest, sessionManager) {
+        this.onGeneralMessageReceivedCallbacks = new Map();
+        this.onCertificatesReceivedCallbacks = new Map();
+        this.onCertificateRequestReceivedCallbacks = new Map();
+        this.onInitialResponseReceivedCallbacks = new Map();
+        // Single shared counter for all callback types
+        this.callbackIdCounter = 0;
+        this.wallet = wallet;
+        this.transport = transport;
+        this.certificatesToRequest = certificatesToRequest !== null && certificatesToRequest !== void 0 ? certificatesToRequest : { certifiers: [], types: {} };
+        this.transport.onData(this.handleIncomingMessage.bind(this));
+        this.sessionManager = sessionManager || new SessionManager_js_1.SessionManager();
+    }
+    /**
+     * Sends a general message to a peer, and initiates a handshake if necessary.
+     *
+     * @param {number[]} message - The message payload to send.
+     * @param {string} [identityKey] - The identity public key of the peer. If not provided, a handshake will be initiated.
+     * @returns {Promise<void>}
+     * @throws Will throw an error if the message fails to send.
+     */
+    async toPeer(message, identityKey, maxWaitTime) {
+        const peerSession = await this.getAuthenticatedSession(identityKey, maxWaitTime);
+        // Prepare the general message
+        const requestNonce = mod_js_1.Utils.toBase64((0, mod_js_1.Random)(32));
+        const { signature } = await this.wallet.createSignature({
+            data: message,
+            protocolID: [2, 'auth message signature'],
+            keyID: `${requestNonce} ${peerSession.peerNonce}`,
+            counterparty: peerSession.peerIdentityKey
+        });
+        const generalMessage = {
+            version: AUTH_VERSION,
+            messageType: 'general',
+            identityKey: (await this.wallet.getPublicKey({ identityKey: true })).publicKey,
+            nonce: requestNonce,
+            yourNonce: peerSession.peerNonce,
+            payload: message,
+            signature
+        };
+        try {
+            await this.transport.send(generalMessage);
+        }
+        catch (error) {
+            const e = new Error(`Failed to send message to peer ${peerSession.peerIdentityKey}: ${error.message}`);
+            e.stack = error.stack;
+            throw e;
+        }
+    }
+    /**
+    * Sends a request for certificates to a peer.
+    * This method allows a peer to dynamically request specific certificates after
+    * an initial handshake or message has been exchanged.
+    *
+    * @param {RequestedCertificateSet} certificatesToRequest - Specifies the certifiers and types of certificates required from the peer.
+    * @param {string} [identityKey] - The identity public key of the peer. If not provided, the current session identity is used.
+    * @param {number} [maxWaitTime=10000] - Maximum time in milliseconds to wait for the peer session to be authenticated.
+    * @returns {Promise<void>} Resolves if the certificate request message is successfully sent.
+    * @throws Will throw an error if the peer session is not authenticated or if sending the request fails.
+    */
+    async requestCertificates(certificatesToRequest, identityKey, maxWaitTime = 10000) {
+        const peerSession = await this.getAuthenticatedSession(identityKey, maxWaitTime);
+        // Prepare the general message
+        const requestNonce = mod_js_1.Utils.toBase64((0, mod_js_1.Random)(32));
+        const { signature } = await this.wallet.createSignature({
+            data: mod_js_1.Utils.toArray(JSON.stringify(certificatesToRequest), 'utf8'),
+            protocolID: [2, 'auth message signature'],
+            keyID: `${requestNonce} ${peerSession.peerNonce}`,
+            counterparty: peerSession.peerIdentityKey
+        });
+        const certRequestMessage = {
+            version: AUTH_VERSION,
+            messageType: 'certificateRequest',
+            identityKey: (await this.wallet.getPublicKey({ identityKey: true })).publicKey,
+            nonce: requestNonce,
+            initialNonce: peerSession.sessionNonce,
+            yourNonce: peerSession.peerNonce,
+            requestedCertificates: certificatesToRequest,
+            signature
+        };
+        try {
+            await this.transport.send(certRequestMessage);
+        }
+        catch (error) {
+            throw new Error(`Failed to send certificate request message to peer ${peerSession.peerIdentityKey}: ${error.message}`);
+        }
+    }
+    /**
+     * Retrieves an authenticated session for a given peer identity. If no session exists
+     * or the session is not authenticated, initiates a handshake to create or authenticate the session.
+     *
+     * @param {string} [identityKey] - The identity public key of the peer. If provided, it attempts
+     * to retrieve an existing session associated with this identity.
+     * @param {number} [maxWaitTime] - The maximum time in milliseconds to wait for the handshake
+     * to complete if a new session is required. Defaults to a pre-defined timeout if not specified.
+     * @returns {Promise<PeerSession>} - A promise that resolves with an authenticated `PeerSession`.
+     * @throws {Error} - Throws an error if the transport is not connected or if the handshake fails.
+     */
+    async getAuthenticatedSession(identityKey, maxWaitTime) {
+        if (!this.transport) {
+            throw new Error('Peer transport is not connected!');
+        }
+        let peerSession = identityKey ? this.sessionManager.getSession(identityKey) : undefined;
+        if (!peerSession || !peerSession.isAuthenticated) {
+            const sessionNonce = await this.initiateHandshake(identityKey, maxWaitTime);
+            peerSession = this.sessionManager.getSession(identityKey || sessionNonce);
+            if (!peerSession.isAuthenticated) {
+                throw new Error('Unable to establish mutual authentication with peer!');
+            }
+        }
+        return peerSession;
+    }
+    /**
+     * Registers a callback to listen for general messages from peers.
+     *
+     * @param {(senderPublicKey: string, payload: number[]) => void} callback - The function to call when a general message is received.
+     * @returns {number} The ID of the callback listener.
+     */
+    listenForGeneralMessages(callback) {
+        const callbackID = this.callbackIdCounter++;
+        this.onGeneralMessageReceivedCallbacks.set(callbackID, callback);
+        return callbackID;
+    }
+    /**
+     * Removes a general message listener.
+     *
+     * @param {number} callbackID - The ID of the callback to remove.
+     */
+    stopListeningForGeneralMessages(callbackID) {
+        this.onGeneralMessageReceivedCallbacks.delete(callbackID);
+    }
+    /**
+     * Registers a callback to listen for certificates received from peers.
+     *
+     * @param {(certs: VerifiableCertificate[]) => void} callback - The function to call when certificates are received.
+     * @returns {number} The ID of the callback listener.
+     */
+    listenForCertificatesReceived(callback) {
+        const callbackID = this.callbackIdCounter++;
+        this.onCertificatesReceivedCallbacks.set(callbackID, callback);
+        return callbackID;
+    }
+    /**
+     * Cancels and unsubscribes a certificatesReceived listener.
+     *
+     * @param {number} callbackID - The ID of the certificates received callback to cancel.
+     */
+    stopListeningForCertificatesReceived(callbackID) {
+        this.onCertificatesReceivedCallbacks.delete(callbackID);
+    }
+    /**
+     * Registers a callback to listen for certificates requested from peers.
+     *
+     * @param {(requestedCertificates: RequestedCertificateSet) => void} callback - The function to call when a certificate request is received
+     * @returns {number} The ID of the callback listener.
+     */
+    listenForCertificatesRequested(callback) {
+        const callbackID = this.callbackIdCounter++;
+        this.onCertificateRequestReceivedCallbacks.set(callbackID, callback);
+        return callbackID;
+    }
+    /**
+     * Cancels and unsubscribes a certificatesRequested listener.
+     *
+     * @param {number} callbackID - The ID of the requested certificates callback to cancel.
+     */
+    stopListeningForCertificatesRequested(callbackID) {
+        this.onCertificateRequestReceivedCallbacks.delete(callbackID);
+    }
+    /**
+     * Initiates the mutual authentication handshake with a peer.
+     *
+     * @private
+     * @param {string} [identityKey] - The identity public key of the peer.
+     * @returns {Promise<string>} A promise that resolves to the session nonce.
+     */
+    async initiateHandshake(identityKey, maxWaitTime = 10000) {
+        const sessionNonce = await (0, index_js_1.createNonce)(this.wallet); // Initial request nonce
+        this.sessionManager.addSession({
+            isAuthenticated: false,
+            sessionNonce,
+            peerIdentityKey: identityKey
+        });
+        const initialRequest = {
+            version: AUTH_VERSION,
+            messageType: 'initialRequest',
+            identityKey: (await this.wallet.getPublicKey({ identityKey: true })).publicKey,
+            initialNonce: sessionNonce,
+            requestedCertificates: this.certificatesToRequest
+        };
+        await this.transport.send(initialRequest);
+        return await this.waitForInitialResponse(sessionNonce, maxWaitTime);
+    }
+    /**
+     * Waits for the initial response from the peer after sending an initial handshake request message.
+     *
+     * @param {string} sessionNonce - The session nonce created in the initial request.
+     * @returns {Promise<string>} A promise that resolves with the session nonce when the initial response is received.
+     */
+    async waitForInitialResponse(sessionNonce, maxWaitTime = 10000) {
+        return await new Promise((resolve, reject) => {
+            const callbackID = this.listenForInitialResponse(sessionNonce, (sessionNonce) => {
+                clearTimeout(timeoutHandle);
+                this.stopListeningForInitialResponses(callbackID);
+                resolve(sessionNonce);
+            });
+            const timeoutHandle = setTimeout(() => {
+                this.stopListeningForInitialResponses(callbackID);
+                reject(new Error('Initial response timed out.'));
+            }, maxWaitTime);
+        });
+    }
+    /**
+     * Adds a listener for an initial response message matching a specific initial nonce.
+     *
+     * @private
+     * @param {string} sessionNonce - The session nonce to match.
+     * @param {(sessionNonce: string) => void} callback - The callback to invoke when the initial response is received.
+     * @returns {number} The ID of the callback listener.
+     */
+    listenForInitialResponse(sessionNonce, callback) {
+        const callbackID = this.callbackIdCounter++;
+        this.onInitialResponseReceivedCallbacks.set(callbackID, { callback, sessionNonce });
+        return callbackID;
+    }
+    /**
+     * Removes a listener for initial responses.
+     *
+     * @private
+     * @param {number} callbackID - The ID of the callback to remove.
+     */
+    stopListeningForInitialResponses(callbackID) {
+        this.onInitialResponseReceivedCallbacks.delete(callbackID);
+    }
+    /**
+     * Handles incoming messages from the transport.
+     *
+     * @param {AuthMessage} message - The incoming message to process.
+     * @returns {Promise<void>}
+     */
+    async handleIncomingMessage(message) {
+        if (!message.version || message.version !== AUTH_VERSION) {
+            console.error(`Invalid message auth version! Received: ${message.version}, expected: ${AUTH_VERSION}`);
+            return;
+        }
+        switch (message.messageType) {
+            case 'initialRequest':
+                await this.processInitialRequest(message);
+                break;
+            case 'initialResponse':
+                await this.processInitialResponse(message);
+                break;
+            case 'certificateRequest':
+                await this.processCertificateRequest(message);
+                break;
+            case 'certificateResponse':
+                await this.processCertificateResponse(message);
+                break;
+            case 'general':
+                await this.processGeneralMessage(message);
+                break;
+            default:
+                console.error(`Unknown message type of ${message.messageType} from ${message.identityKey}`);
+        }
+    }
+    /**
+     * Processes an initial request message from a peer.
+     *
+     * @param {AuthMessage} message - The incoming initial request message.
+     * @returns {Promise<void>}
+     */
+    async processInitialRequest(message) {
+        var _a, _b;
+        if (!message.identityKey || !message.initialNonce) {
+            throw new Error('Missing required fields in initialResponse message.');
+        }
+        // Create an initial session nonce
+        const sessionNonce = await (0, index_js_1.createNonce)(this.wallet);
+        this.sessionManager.addSession({
+            isAuthenticated: true,
+            sessionNonce,
+            peerNonce: message.initialNonce,
+            peerIdentityKey: message.identityKey
+        });
+        // Handle initial certificate requests
+        let certificatesToInclude;
+        if (((_b = (_a = message.requestedCertificates) === null || _a === void 0 ? void 0 : _a.certifiers) === null || _b === void 0 ? void 0 : _b.length) > 0) {
+            if (this.onCertificateRequestReceivedCallbacks.size > 0) {
+                // The application wants to handle certificate requests
+                this.onCertificateRequestReceivedCallbacks.forEach(callback => {
+                    callback(message.identityKey, message.requestedCertificates);
+                });
+            }
+            else {
+                // Attempt to find exact matching certificates to return automatically to save round trips
+                certificatesToInclude = await (0, index_js_1.getVerifiableCertificates)(this.wallet, message.requestedCertificates, message.identityKey);
+            }
+        }
+        // Create the signature for the message
+        const { signature } = await this.wallet.createSignature({
+            data: mod_js_1.Utils.toArray(message.initialNonce + sessionNonce, 'base64'),
+            protocolID: [2, 'auth message signature'],
+            keyID: `${message.initialNonce} ${sessionNonce}`,
+            counterparty: message.identityKey
+        });
+        const initialResponseMessage = {
+            version: AUTH_VERSION,
+            messageType: 'initialResponse',
+            identityKey: (await this.wallet.getPublicKey({ identityKey: true })).publicKey,
+            initialNonce: sessionNonce,
+            yourNonce: message.initialNonce,
+            certificates: certificatesToInclude,
+            requestedCertificates: this.certificatesToRequest,
+            signature
+        };
+        await this.transport.send(initialResponseMessage);
+    }
+    /**
+     * Processes an initial response message from a peer.
+     *
+     * @private
+     * @param {AuthMessage} message - The incoming initial response message.
+     * @returns {Promise<void>}
+     * @throws Will throw an error if nonce verification or signature verification fails.
+     */
+    async processInitialResponse(message) {
+        var _a, _b, _c, _d, _e;
+        const validNonce = await (0, index_js_1.verifyNonce)(message.yourNonce, this.wallet);
+        if (!validNonce) {
+            throw new Error(`Initial response nonce verification failed from peer: ${message.identityKey}`);
+        }
+        const peerSession = this.sessionManager.getSession(message.yourNonce);
+        if (!peerSession) {
+            throw new Error(`Peer session not found for peer: ${message.identityKey}`);
+        }
+        // Validate message signature
+        const { valid } = await this.wallet.verifySignature({
+            data: mod_js_1.Utils.toArray(peerSession.sessionNonce + message.initialNonce, 'base64'),
+            signature: message.signature,
+            protocolID: [2, 'auth message signature'],
+            keyID: `${peerSession.sessionNonce} ${message.initialNonce}`,
+            counterparty: message.identityKey
+        });
+        if (!valid) {
+            throw new Error(`Unable to verify initial response signature for peer: ${message.identityKey}`);
+        }
+        // After signature and nonce verification is complete, the peer is considered authenticated
+        // Save the peer's identity key and initial nonce
+        // This allows future requests to be linked to the same session
+        peerSession.peerNonce = message.initialNonce;
+        peerSession.peerIdentityKey = message.identityKey;
+        peerSession.isAuthenticated = true;
+        // Run update to ensure lookup is available by both peerIdentityKey and sessionNonce
+        this.sessionManager.updateSession(peerSession);
+        // Process certificates received
+        if (((_b = (_a = this.certificatesToRequest) === null || _a === void 0 ? void 0 : _a.certifiers) === null || _b === void 0 ? void 0 : _b.length) && ((_c = message.certificates) === null || _c === void 0 ? void 0 : _c.length)) {
+            await (0, index_js_1.validateCertificates)(this.wallet, message, this.certificatesToRequest);
+            this.onCertificatesReceivedCallbacks.forEach(callback => callback(message.identityKey, message.certificates));
+        }
+        this.onInitialResponseReceivedCallbacks.forEach((entry) => {
+            if (entry && entry.sessionNonce === peerSession.sessionNonce) {
+                entry.callback(peerSession.sessionNonce);
+            }
+        });
+        // Check if the peer requested certificates from us
+        if (((_e = (_d = message.requestedCertificates) === null || _d === void 0 ? void 0 : _d.certifiers) === null || _e === void 0 ? void 0 : _e.length) > 0) {
+            if (this.onCertificateRequestReceivedCallbacks.size > 0) {
+                // Application wants to handle certificate requests
+                this.onCertificateRequestReceivedCallbacks.forEach(callback => {
+                    callback(message.identityKey, message.requestedCertificates);
+                });
+            }
+            else {
+                // Attempt to find exact matching certificates to respond automatically and save round trips
+                const verifiableCertificates = await (0, index_js_1.getVerifiableCertificates)(this.wallet, message.requestedCertificates, message.identityKey);
+                await this.sendCertificateResponse(message.identityKey, verifiableCertificates);
+            }
+        }
+    }
+    /**
+     * Processes an incoming certificate request message from a peer.
+     * Verifies the nonce and signature to ensure the authenticity of the request,
+     * then initiates a response with any requested certificates that are available.
+     *
+     * @param {AuthMessage} message - The certificate request message received from the peer.
+     * @throws {Error} Throws an error if nonce verification fails, or the message signature is invalid.
+     */
+    async processCertificateRequest(message) {
+        var _a, _b;
+        const validNonce = await (0, index_js_1.verifyNonce)(message.yourNonce, this.wallet);
+        if (!validNonce) {
+            throw new Error(`Unable to verify nonce for certificate request message from: ${message.identityKey}`);
+        }
+        const peerSession = this.sessionManager.getSession(message.yourNonce);
+        const { valid } = await this.wallet.verifySignature({
+            data: mod_js_1.Utils.toArray(JSON.stringify(message.requestedCertificates), 'utf8'),
+            signature: message.signature,
+            protocolID: [2, 'auth message signature'],
+            keyID: `${message.nonce} ${peerSession.sessionNonce}`,
+            counterparty: peerSession.peerIdentityKey
+        });
+        if (!valid) {
+            throw new Error(`Invalid signature in certificate request message from ${peerSession.peerIdentityKey}`);
+        }
+        if (((_b = (_a = message.requestedCertificates) === null || _a === void 0 ? void 0 : _a.certifiers) === null || _b === void 0 ? void 0 : _b.length) > 0) {
+            if (this.onCertificateRequestReceivedCallbacks.size > 0) {
+                // Application wants to handle certificate requests
+                this.onCertificateRequestReceivedCallbacks.forEach(callback => {
+                    callback(message.identityKey, message.requestedCertificates);
+                });
+            }
+            else {
+                // Attempt to find exact matching certificates to respond automatically and save round trips
+                const verifiableCertificates = await (0, index_js_1.getVerifiableCertificates)(this.wallet, message.requestedCertificates, message.identityKey);
+                await this.sendCertificateResponse(message.identityKey, verifiableCertificates);
+            }
+        }
+    }
+    /**
+     * Sends a certificate response message containing the specified certificates to a peer.
+     *
+     * @param {string} verifierIdentityKey - The identity key of the peer requesting the certificates.
+     * @param {VerifiableCertificate[]} certificates - The list of certificates to be included in the response.
+     * @returns {Promise<void>} - A promise that resolves once the certificate response has been sent successfully.
+     *
+     * @throws {Error} Throws an error if the peer session could not be authenticated or if message signing fails.
+     */
+    async sendCertificateResponse(verifierIdentityKey, certificates) {
+        const peerSession = await this.getAuthenticatedSession(verifierIdentityKey);
+        const requestNonce = mod_js_1.Utils.toBase64((0, mod_js_1.Random)(32));
+        const { signature } = await this.wallet.createSignature({
+            data: mod_js_1.Utils.toArray(JSON.stringify(certificates), 'utf8'),
+            protocolID: [2, 'auth message signature'],
+            keyID: `${requestNonce} ${peerSession.peerNonce}`,
+            counterparty: peerSession.peerIdentityKey
+        });
+        const certificateResponse = {
+            version: AUTH_VERSION,
+            messageType: 'certificateResponse',
+            identityKey: (await this.wallet.getPublicKey({ identityKey: true })).publicKey,
+            nonce: requestNonce,
+            initialNonce: peerSession.sessionNonce,
+            yourNonce: peerSession.peerNonce,
+            certificates,
+            signature
+        };
+        try {
+            await this.transport.send(certificateResponse);
+        }
+        catch (error) {
+            throw new Error(`Failed to send certificate response message to peer ${peerSession.peerIdentityKey}: ${error.message}`);
+        }
+    }
+    /**
+     * Processes a certificate response message from a peer.
+     *
+     * @private
+     * @param {AuthMessage} message - The incoming certificate response message.
+     * @returns {Promise<void>}
+     * @throws Will throw an error if nonce verification or signature verification fails.
+     */
+    async processCertificateResponse(message) {
+        const validNonce = await (0, index_js_1.verifyNonce)(message.yourNonce, this.wallet);
+        if (!validNonce) {
+            throw new Error(`Unable to verify nonce for certificate response from: ${message.identityKey}!`);
+        }
+        const peerSession = this.sessionManager.getSession(message.yourNonce);
+        // Validate message signature
+        const { valid } = await this.wallet.verifySignature({
+            data: mod_js_1.Utils.toArray(JSON.stringify(message.certificates), 'utf8'),
+            signature: message.signature,
+            protocolID: [2, 'auth message signature'],
+            keyID: `${message.nonce} ${peerSession.sessionNonce}`,
+            counterparty: message.identityKey
+        });
+        if (!valid) {
+            throw new Error(`Unable to verify certificate response signature for peer: ${message.identityKey}`);
+        }
+        // Process and verify any certificates received
+        await (0, index_js_1.validateCertificates)(this.wallet, message, message.requestedCertificates);
+        this.onCertificatesReceivedCallbacks.forEach(callback => {
+            callback(message.identityKey, message.certificates);
+        });
+    }
+    /**
+     * Processes a general message from a peer.
+     *
+     * @private
+     * @param {AuthMessage} message - The incoming general message.
+     * @returns {Promise<void>}
+     * @throws Will throw an error if nonce verification or signature verification fails.
+     */
+    async processGeneralMessage(message) {
+        const validNonce = await (0, index_js_1.verifyNonce)(message.yourNonce, this.wallet);
+        if (!validNonce) {
+            throw new Error(`Unable to verify nonce for general message from: ${message.identityKey}`);
+        }
+        const peerSession = this.sessionManager.getSession(message.yourNonce);
+        const { valid } = await this.wallet.verifySignature({
+            data: message.payload,
+            signature: message.signature,
+            protocolID: [2, 'auth message signature'],
+            keyID: `${message.nonce} ${peerSession.sessionNonce}`,
+            counterparty: peerSession.peerIdentityKey
+        });
+        if (!valid) {
+            throw new Error(`Invalid signature in generalMessage from ${peerSession.peerIdentityKey}`);
+        }
+        this.onGeneralMessageReceivedCallbacks.forEach(callback => {
+            callback(message.identityKey, message.payload);
+        });
+    }
+}
+exports.Peer = Peer;
+//# sourceMappingURL=Peer.js.map

package/dist/cjs/src/auth/Peer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Peer.js","sourceRoot":"","sources":["../../../../src/auth/Peer.ts"],"names":[],"mappings":"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"}

package/dist/cjs/src/auth/SessionManager.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionManager = void 0;
+/**
+ * Manages sessions for peers, allowing sessions to be added, retrieved, updated, and removed
+ * by relevant identifiers (sessionNonce and peerIdentityKey).
+ */
+class SessionManager {
+    constructor() {
+        this.identifierToSession = new Map();
+    }
+    /**
+     * Adds a session to the manager, associating it with relevant identifiers for retrieval.
+     *
+     * @param {PeerSession} session - The peer session to add.
+     */
+    addSession(session) {
+        if (!session.sessionNonce && !session.peerIdentityKey) {
+            throw new Error('Invalid session: at least one of sessionNonce or peerIdentityKey is required.');
+        }
+        if (session.sessionNonce) {
+            this.identifierToSession.set(session.sessionNonce, session);
+        }
+        if (session.peerIdentityKey) {
+            this.identifierToSession.set(session.peerIdentityKey, session);
+        }
+    }
+    /**
+    * Updates a session in the manager, ensuring that all identifiers are correctly associated.
+    *
+    * @param {PeerSession} session - The peer session to update.
+    */
+    updateSession(session) {
+        this.removeSession(session);
+        this.addSession(session);
+    }
+    /**
+     * Retrieves a session based on a given identifier.
+     *
+     * @param {string} identifier - The identifier for the session (sessionNonce or peerIdentityKey).
+     * @returns {PeerSession | undefined} - The matching peer session, or undefined if not found.
+     */
+    getSession(identifier) {
+        return this.identifierToSession.get(identifier);
+    }
+    /**
+     * Removes a session from the manager by clearing all associated identifiers.
+     *
+     * @param {PeerSession} session - The peer session to remove.
+     */
+    removeSession(session) {
+        this.identifierToSession.delete(session.sessionNonce);
+        this.identifierToSession.delete(session.peerIdentityKey);
+    }
+    /**
+     * Checks if a session exists based on a given identifier.
+     *
+     * @param {string} identifier - The identifier to check.
+     * @returns {boolean} - True if the session exists, false otherwise.
+     */
+    hasSession(identifier) {
+        return this.identifierToSession.has(identifier);
+    }
+}
+exports.SessionManager = SessionManager;
+//# sourceMappingURL=SessionManager.js.map

package/dist/cjs/src/auth/SessionManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionManager.js","sourceRoot":"","sources":["../../../../src/auth/SessionManager.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACH,MAAa,cAAc;IAGzB;QACE,IAAI,CAAC,mBAAmB,GAAG,IAAI,GAAG,EAAuB,CAAA;IAC3D,CAAC;IAED;;;;OAIG;IACH,UAAU,CAAE,OAAoB;QAC9B,IAAI,CAAC,OAAO,CAAC,YAAY,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAA;QAClG,CAAC;QAED,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YACzB,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;QAC7D,CAAC;QACD,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;YAC5B,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC,eAAe,EAAE,OAAO,CAAC,CAAA;QAChE,CAAC;IACH,CAAC;IAED;;;;MAIE;IACF,aAAa,CAAE,OAAoB;QACjC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAA;QAC3B,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;IAC1B,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAE,UAAkB;QAC5B,OAAO,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACjD,CAAC;IAED;;;;OAIG;IACH,aAAa,CAAE,OAAoB;QACjC,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;QACrD,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAA;IAC1D,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAE,UAAkB;QAC5B,OAAO,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACjD,CAAC;CACF;AAhED,wCAgEC"}